Repository: BowlerHatLLC/feathers
Branch: master
Commit: 44fc2bff265c
Files: 785
Total size: 9.6 MB

Directory structure:
gitextract_keik636y/

├── .github/
│   ├── SUPPORT.md
│   └── workflows/
│       └── package-feathersui.yml
├── .gitignore
├── CHANGELOG.md
├── LICENSE.md
├── README.md
├── build.properties
├── build.xml
├── documentation/
│   ├── README.md
│   └── api-reference/
│       ├── package-descriptions.xml
│       └── templates/
│           ├── AC_OETags.js
│           ├── ASDoc_Config_Base.xml
│           ├── ASDoc_terms.xml
│           ├── ClassHeader.xslt
│           ├── Classes.xslt
│           ├── Overviews_Base.xml
│           ├── PostProcessing.xslt
│           ├── all-classes.xslt
│           ├── all-index.xslt
│           ├── asdoc-util.xslt
│           ├── asdoc.js
│           ├── class-files.xslt
│           ├── class-list.xslt
│           ├── class-parts.xslt
│           ├── class-summary.xslt
│           ├── cookies.js
│           ├── effectsSummary.xslt
│           ├── eventsGeneratedSummary.xslt
│           ├── fieldSummary.xslt
│           ├── help.js
│           ├── index-list.html
│           ├── index.html
│           ├── merge_dita_xml.xslt
│           ├── methodSummary.xslt
│           ├── mxml-tags.html
│           ├── override.css
│           ├── package-detail.xslt
│           ├── package-frame.html
│           ├── package-list.xslt
│           ├── package-summary.xslt
│           ├── package.xslt
│           ├── print.css
│           ├── processHTML.xslt
│           ├── style.css
│           ├── stylesSummary.xslt
│           └── title-bar.html
├── examples/
│   ├── ComponentsExplorer/
│   │   ├── README.md
│   │   ├── assets/
│   │   │   └── images/
│   │   │       └── icons-readme.txt
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── ComponentsExplorer-app.xml
│   │       ├── ComponentsExplorer.as
│   │       ├── ComponentsExplorerWeb.as
│   │       └── feathers/
│   │           └── examples/
│   │               └── componentsExplorer/
│   │                   ├── Main.as
│   │                   ├── ScreenID.as
│   │                   ├── data/
│   │                   │   ├── DataGridSettings.as
│   │                   │   ├── DateTimeSpinnerSettings.as
│   │                   │   ├── EmbeddedAssets.as
│   │                   │   ├── GroupedListSettings.as
│   │                   │   ├── ItemRendererSettings.as
│   │                   │   ├── ListSettings.as
│   │                   │   ├── NumericStepperSettings.as
│   │                   │   └── SliderSettings.as
│   │                   └── screens/
│   │                       ├── AlertScreen.as
│   │                       ├── AutoCompleteScreen.as
│   │                       ├── ButtonGroupScreen.as
│   │                       ├── ButtonScreen.as
│   │                       ├── CalloutScreen.as
│   │                       ├── CheckScreen.as
│   │                       ├── DataGridScreen.as
│   │                       ├── DataGridSettingsScreen.as
│   │                       ├── DateTimeSpinnerScreen.as
│   │                       ├── DateTimeSpinnerSettingsScreen.as
│   │                       ├── GroupedListScreen.as
│   │                       ├── GroupedListSettingsScreen.as
│   │                       ├── ItemRendererScreen.as
│   │                       ├── ItemRendererSettingsScreen.as
│   │                       ├── LabelScreen.as
│   │                       ├── ListScreen.as
│   │                       ├── ListSettingsScreen.as
│   │                       ├── MainMenuScreen.as
│   │                       ├── NumericStepperScreen.as
│   │                       ├── NumericStepperSettingsScreen.as
│   │                       ├── PageIndicatorScreen.as
│   │                       ├── PanelComponentScreen.as
│   │                       ├── PickerListScreen.as
│   │                       ├── ProgressBarScreen.as
│   │                       ├── RadioScreen.as
│   │                       ├── ScrollTextScreen.as
│   │                       ├── SliderScreen.as
│   │                       ├── SliderSettingsScreen.as
│   │                       ├── SpinnerListScreen.as
│   │                       ├── TabBarScreen.as
│   │                       ├── TextCalloutScreen.as
│   │                       ├── TextInputScreen.as
│   │                       ├── ToastScreen.as
│   │                       ├── ToggleSwitchScreen.as
│   │                       ├── TreeScreen.as
│   │                       └── WebViewScreen.as
│   ├── DragAndDrop/
│   │   ├── README.md
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── DragAndDrop.as
│   │       └── feathers/
│   │           └── examples/
│   │               └── dragDrop/
│   │                   ├── DragSource.as
│   │                   ├── DropTarget.as
│   │                   └── Main.as
│   ├── DrawersExplorer/
│   │   ├── README.md
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── DrawersExplorer-app.xml
│   │       ├── DrawersExplorer.as
│   │       ├── DrawersExplorerWeb.as
│   │       └── feathers/
│   │           └── examples/
│   │               └── drawersExplorer/
│   │                   ├── Main.as
│   │                   ├── skins/
│   │                   │   └── DrawersExplorerTheme.as
│   │                   └── views/
│   │                       ├── ContentView.as
│   │                       └── DrawerView.as
│   ├── Gallery/
│   │   ├── README.md
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── Gallery-app.xml
│   │       ├── Gallery.as
│   │       └── feathers/
│   │           ├── examples/
│   │           │   └── gallery/
│   │           │       ├── Main.as
│   │           │       ├── controls/
│   │           │       │   ├── GalleryItemRenderer.as
│   │           │       │   └── ThumbItemRenderer.as
│   │           │       ├── data/
│   │           │       │   └── GalleryItem.as
│   │           │       └── layout/
│   │           │           └── GalleryItemRendererLayout.as
│   │           └── utils/
│   │               └── touch/
│   │                   └── TouchSheet.as
│   ├── HelloWorld/
│   │   ├── README.md
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── HelloWorld-app.xml
│   │       ├── HelloWorld.as
│   │       ├── HelloWorldWeb.as
│   │       └── feathers/
│   │           └── examples/
│   │               └── helloWorld/
│   │                   └── Main.as
│   ├── LayoutExplorer/
│   │   ├── README.md
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── LayoutExplorer-app.xml
│   │       ├── LayoutExplorer.as
│   │       ├── LayoutExplorerWeb.as
│   │       └── feathers/
│   │           └── examples/
│   │               └── layoutExplorer/
│   │                   ├── Main.as
│   │                   ├── data/
│   │                   │   ├── FlowLayoutSettings.as
│   │                   │   ├── HorizontalLayoutSettings.as
│   │                   │   ├── SlideShowLayoutSettings.as
│   │                   │   ├── TiledColumnsLayoutSettings.as
│   │                   │   ├── TiledRowsLayoutSettings.as
│   │                   │   ├── VerticalLayoutSettings.as
│   │                   │   └── WaterfallLayoutSettings.as
│   │                   └── screens/
│   │                       ├── AnchorLayoutScreen.as
│   │                       ├── FlowLayoutScreen.as
│   │                       ├── FlowLayoutSettingsScreen.as
│   │                       ├── HorizontalLayoutScreen.as
│   │                       ├── HorizontalLayoutSettingsScreen.as
│   │                       ├── MainMenuScreen.as
│   │                       ├── SlideShowLayoutScreen.as
│   │                       ├── SlideShowLayoutSettingsScreen.as
│   │                       ├── TiledColumnsLayoutScreen.as
│   │                       ├── TiledColumnsLayoutSettingsScreen.as
│   │                       ├── TiledRowsLayoutScreen.as
│   │                       ├── TiledRowsLayoutSettingsScreen.as
│   │                       ├── VerticalLayoutScreen.as
│   │                       ├── VerticalLayoutSettingsScreen.as
│   │                       ├── WaterfallLayoutScreen.as
│   │                       └── WaterfallLayoutSettingsScreen.as
│   ├── Magic8Chat/
│   │   ├── README.md
│   │   ├── assets/
│   │   │   └── images/
│   │   │       └── icons-readme.txt
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── Magic8Chat-app.xml
│   │       ├── Magic8Chat.as
│   │       ├── Magic8ChatWeb.as
│   │       └── feathers/
│   │           └── examples/
│   │               └── magic8/
│   │                   ├── Main.as
│   │                   ├── data/
│   │                   │   └── ChatMessage.as
│   │                   └── themes/
│   │                       ├── Magic8ChatTheme.as
│   │                       └── StyleNames.as
│   ├── PullToRefresh/
│   │   ├── README.md
│   │   ├── assets/
│   │   │   └── images/
│   │   │       └── spinner.xml
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── PullToRefresh-app.xml
│   │       ├── PullToRefresh.as
│   │       ├── PullToRefreshWeb.as
│   │       └── feathers/
│   │           └── examples/
│   │               └── pullToRefresh/
│   │                   └── Main.as
│   ├── StackScreenNavigatorExplorer/
│   │   ├── README.md
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── StackScreenNavigatorExplorer-app.xml
│   │       ├── StackScreenNavigatorExplorer.as
│   │       ├── StackScreenNavigatorExplorerWeb.as
│   │       └── feathers/
│   │           └── examples/
│   │               └── navigator/
│   │                   ├── Main.as
│   │                   └── screens/
│   │                       ├── ScreenA.as
│   │                       ├── ScreenB1.as
│   │                       ├── ScreenB2.as
│   │                       └── ScreenC.as
│   ├── Tabs/
│   │   ├── README.md
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── Tabs-app.xml
│   │       ├── Tabs.as
│   │       ├── TabsWeb.as
│   │       └── feathers/
│   │           └── examples/
│   │               └── tabs/
│   │                   ├── Main.as
│   │                   ├── screens/
│   │                   │   ├── ContactsScreen.as
│   │                   │   ├── MessagesScreen.as
│   │                   │   └── ProfileScreen.as
│   │                   └── themes/
│   │                       ├── StyleNames.as
│   │                       └── TabsTheme.as
│   ├── TileList/
│   │   ├── README.md
│   │   ├── assets/
│   │   │   └── images/
│   │   │       ├── atlas@2x.tps
│   │   │       └── atlas@2x.xml
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── TileList-app.xml
│   │       ├── TileList.as
│   │       ├── TileListWeb.as
│   │       └── feathers/
│   │           └── examples/
│   │               └── tileList/
│   │                   └── Main.as
│   ├── Todos/
│   │   ├── README.md
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── Todos-app.xml
│   │       ├── Todos.as
│   │       ├── TodosWeb.as
│   │       └── feathers/
│   │           └── examples/
│   │               └── todos/
│   │                   ├── Main.as
│   │                   ├── TodoItem.as
│   │                   ├── TodosTheme.as
│   │                   └── controls/
│   │                       └── TodoItemRenderer.as
│   ├── TrainTimes/
│   │   ├── README.md
│   │   ├── assets/
│   │   │   └── images/
│   │   │       ├── traintimes.tps
│   │   │       └── traintimes.xml
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── TrainTimes-app.xml
│   │       ├── TrainTimes.as
│   │       ├── TrainTimesWeb.as
│   │       └── feathers/
│   │           └── examples/
│   │               └── trainTimes/
│   │                   ├── Main.as
│   │                   ├── controls/
│   │                   │   └── StationListItemRenderer.as
│   │                   ├── model/
│   │                   │   ├── StationData.as
│   │                   │   └── TimeData.as
│   │                   ├── screens/
│   │                   │   ├── StationScreen.as
│   │                   │   └── TimesScreen.as
│   │                   └── themes/
│   │                       └── TrainTimesTheme.as
│   ├── TransitionsExplorer/
│   │   ├── README.md
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── TransitionsExplorer-app.xml
│   │       ├── TransitionsExplorer.as
│   │       ├── TransitionsExplorerWeb.as
│   │       └── feathers/
│   │           └── examples/
│   │               └── transitionsExplorer/
│   │                   ├── Main.as
│   │                   └── screens/
│   │                       ├── AllTransitionsScreen.as
│   │                       ├── ColorFadeTransitionScreen.as
│   │                       ├── FadeTransitionScreen.as
│   │                       ├── FourWayTransitionScreen.as
│   │                       └── IrisTransitionScreen.as
│   ├── Video/
│   │   ├── README.md
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── Video-app.xml
│   │       ├── Video.as
│   │       └── feathers/
│   │           └── examples/
│   │               └── video/
│   │                   └── Main.as
│   ├── YouTubeFeeds/
│   │   ├── README.md
│   │   ├── build.properties
│   │   ├── build.xml
│   │   └── source/
│   │       ├── YouTubeFeeds-app.xml
│   │       ├── YouTubeFeeds.as
│   │       ├── YouTubeFeedsWeb.as
│   │       └── feathers/
│   │           └── examples/
│   │               └── youtube/
│   │                   ├── Main.as
│   │                   ├── models/
│   │                   │   ├── VideoDetails.as
│   │                   │   ├── VideoFeed.as
│   │                   │   └── YouTubeModel.as
│   │                   └── screens/
│   │                       ├── ListVideosScreen.as
│   │                       ├── MainMenuScreen.as
│   │                       └── VideoDetailsScreen.as
│   └── build.xml
├── package-src.json
├── package-swc.json
├── sdk.properties
├── source/
│   └── feathers/
│       ├── FEATHERS_VERSION.as
│       ├── controls/
│       │   ├── Alert.as
│       │   ├── AutoComplete.as
│       │   ├── AutoSizeMode.as
│       │   ├── BasicButton.as
│       │   ├── Button.as
│       │   ├── ButtonGroup.as
│       │   ├── ButtonState.as
│       │   ├── Callout.as
│       │   ├── Check.as
│       │   ├── DataGrid.as
│       │   ├── DataGridColumn.as
│       │   ├── DateTimeMode.as
│       │   ├── DateTimeSpinner.as
│       │   ├── DecelerationRate.as
│       │   ├── DragGesture.as
│       │   ├── Drawers.as
│       │   ├── GroupedList.as
│       │   ├── Header.as
│       │   ├── IDirectionalScrollBar.as
│       │   ├── IRange.as
│       │   ├── IScreen.as
│       │   ├── IScrollBar.as
│       │   ├── IScrollContainer.as
│       │   ├── ImageLoader.as
│       │   ├── ItemRendererLayoutOrder.as
│       │   ├── Label.as
│       │   ├── LayoutGroup.as
│       │   ├── List.as
│       │   ├── NumericStepper.as
│       │   ├── PageIndicator.as
│       │   ├── PageIndicatorInteractionMode.as
│       │   ├── Panel.as
│       │   ├── PanelScreen.as
│       │   ├── PickerList.as
│       │   ├── ProgressBar.as
│       │   ├── PullViewDisplayMode.as
│       │   ├── Radio.as
│       │   ├── Screen.as
│       │   ├── ScreenNavigator.as
│       │   ├── ScreenNavigatorItem.as
│       │   ├── ScrollBar.as
│       │   ├── ScrollBarDisplayMode.as
│       │   ├── ScrollContainer.as
│       │   ├── ScrollInteractionMode.as
│       │   ├── ScrollPolicy.as
│       │   ├── ScrollScreen.as
│       │   ├── ScrollText.as
│       │   ├── Scroller.as
│       │   ├── SimpleScrollBar.as
│       │   ├── Slider.as
│       │   ├── SpinnerList.as
│       │   ├── StackScreenNavigator.as
│       │   ├── StackScreenNavigatorItem.as
│       │   ├── StepperButtonLayoutMode.as
│       │   ├── TabBar.as
│       │   ├── TabNavigator.as
│       │   ├── TabNavigatorItem.as
│       │   ├── TextArea.as
│       │   ├── TextCallout.as
│       │   ├── TextInput.as
│       │   ├── TextInputState.as
│       │   ├── Toast.as
│       │   ├── ToastQueueMode.as
│       │   ├── ToggleButton.as
│       │   ├── ToggleState.as
│       │   ├── ToggleSwitch.as
│       │   ├── TrackInteractionMode.as
│       │   ├── TrackLayoutMode.as
│       │   ├── TrackScaleMode.as
│       │   ├── Tree.as
│       │   ├── WebView.as
│       │   ├── popups/
│       │   │   ├── BottomDrawerPopUpContentManager.as
│       │   │   ├── CalloutPopUpContentManager.as
│       │   │   ├── DropDownPopUpContentManager.as
│       │   │   ├── IPersistentPopUpContentManager.as
│       │   │   ├── IPopUpContentManager.as
│       │   │   ├── IPopUpContentManagerWithPrompt.as
│       │   │   └── VerticalCenteredPopUpContentManager.as
│       │   ├── renderers/
│       │   │   ├── BaseDefaultItemRenderer.as
│       │   │   ├── DefaultDataGridCellRenderer.as
│       │   │   ├── DefaultDataGridHeaderRenderer.as
│       │   │   ├── DefaultGroupedListHeaderOrFooterRenderer.as
│       │   │   ├── DefaultGroupedListItemRenderer.as
│       │   │   ├── DefaultListItemRenderer.as
│       │   │   ├── DefaultTreeItemRenderer.as
│       │   │   ├── IDataGridCellRenderer.as
│       │   │   ├── IDataGridHeaderRenderer.as
│       │   │   ├── IDragAndDropItemRenderer.as
│       │   │   ├── IGroupedListFooterRenderer.as
│       │   │   ├── IGroupedListHeaderRenderer.as
│       │   │   ├── IGroupedListItemRenderer.as
│       │   │   ├── IListItemRenderer.as
│       │   │   ├── ITreeItemRenderer.as
│       │   │   ├── LayoutGroupDataGridCellRenderer.as
│       │   │   ├── LayoutGroupGroupedListHeaderOrFooterRenderer.as
│       │   │   ├── LayoutGroupGroupedListItemRenderer.as
│       │   │   ├── LayoutGroupListItemRenderer.as
│       │   │   └── LayoutGroupTreeItemRenderer.as
│       │   ├── supportClasses/
│       │   │   ├── BaseScreenNavigator.as
│       │   │   ├── DataGridDataViewPort.as
│       │   │   ├── DataGridRowRenderer.as
│       │   │   ├── GroupedListDataViewPort.as
│       │   │   ├── IScreenNavigatorItem.as
│       │   │   ├── IViewPort.as
│       │   │   ├── LayoutViewPort.as
│       │   │   ├── ListDataViewPort.as
│       │   │   ├── TextFieldViewPort.as
│       │   │   └── TreeDataViewPort.as
│       │   └── text/
│       │       ├── BaseTextRenderer.as
│       │       ├── BitmapFontTextEditor.as
│       │       ├── BitmapFontTextRenderer.as
│       │       ├── ITextEditorViewPort.as
│       │       ├── MeasureTextResult.as
│       │       ├── StageTextTextEditor.as
│       │       ├── StageTextTextEditorViewPort.as
│       │       ├── TextBlockTextEditor.as
│       │       ├── TextBlockTextRenderer.as
│       │       ├── TextFieldTextEditor.as
│       │       ├── TextFieldTextEditorViewPort.as
│       │       └── TextFieldTextRenderer.as
│       ├── core/
│       │   ├── BaseTextEditor.as
│       │   ├── DefaultFocusManager.as
│       │   ├── DefaultPopUpManager.as
│       │   ├── DefaultToolTipManager.as
│       │   ├── FeathersControl.as
│       │   ├── FocusManager.as
│       │   ├── IAdvancedNativeFocusOwner.as
│       │   ├── IFeathersControl.as
│       │   ├── IFeathersDisplayObject.as
│       │   ├── IFeathersEventDispatcher.as
│       │   ├── IFocusContainer.as
│       │   ├── IFocusDisplayObject.as
│       │   ├── IFocusExtras.as
│       │   ├── IFocusManager.as
│       │   ├── IGroupedToggle.as
│       │   ├── IIMETextEditor.as
│       │   ├── IMeasureDisplayObject.as
│       │   ├── IMultilineTextEditor.as
│       │   ├── INativeFocusOwner.as
│       │   ├── IPopUpManager.as
│       │   ├── IStateContext.as
│       │   ├── IStateObserver.as
│       │   ├── ITextBaselineControl.as
│       │   ├── ITextEditor.as
│       │   ├── ITextRenderer.as
│       │   ├── IToggle.as
│       │   ├── IToolTip.as
│       │   ├── IToolTipManager.as
│       │   ├── IValidating.as
│       │   ├── PopUpManager.as
│       │   ├── PropertyProxy.as
│       │   ├── ToggleGroup.as
│       │   ├── TokenList.as
│       │   ├── ToolTipManager.as
│       │   └── ValidationQueue.as
│       ├── data/
│       │   ├── ArrayChildrenHierarchicalCollectionDataDescriptor.as
│       │   ├── ArrayCollection.as
│       │   ├── ArrayHierarchicalCollection.as
│       │   ├── ArrayListCollectionDataDescriptor.as
│       │   ├── HierarchicalCollection.as
│       │   ├── IAutoCompleteSource.as
│       │   ├── IHierarchicalCollection.as
│       │   ├── IHierarchicalCollectionDataDescriptor.as
│       │   ├── IListCollection.as
│       │   ├── IListCollectionDataDescriptor.as
│       │   ├── ListCollection.as
│       │   ├── LocalAutoCompleteSource.as
│       │   ├── SortOrder.as
│       │   ├── URLAutoCompleteSource.as
│       │   ├── VectorCollection.as
│       │   ├── VectorHierarchicalCollection.as
│       │   ├── VectorIntListCollectionDataDescriptor.as
│       │   ├── VectorListCollectionDataDescriptor.as
│       │   ├── VectorNumberListCollectionDataDescriptor.as
│       │   ├── VectorUintListCollectionDataDescriptor.as
│       │   ├── XMLListCollection.as
│       │   ├── XMLListHierarchicalCollection.as
│       │   └── XMLListListCollectionDataDescriptor.as
│       ├── display/
│       │   └── RenderDelegate.as
│       ├── dragDrop/
│       │   ├── DragData.as
│       │   ├── DragDropManager.as
│       │   ├── IDragSource.as
│       │   └── IDropTarget.as
│       ├── events/
│       │   ├── CollectionEventType.as
│       │   ├── DragDropEvent.as
│       │   ├── ExclusiveTouch.as
│       │   ├── FeathersEventType.as
│       │   └── MediaPlayerEventType.as
│       ├── layout/
│       │   ├── AnchorLayout.as
│       │   ├── AnchorLayoutData.as
│       │   ├── BaseLinearLayout.as
│       │   ├── BaseTiledLayout.as
│       │   ├── BaseVariableVirtualLayout.as
│       │   ├── Direction.as
│       │   ├── FlowLayout.as
│       │   ├── HorizontalAlign.as
│       │   ├── HorizontalLayout.as
│       │   ├── HorizontalLayoutData.as
│       │   ├── HorizontalSpinnerLayout.as
│       │   ├── IDragDropLayout.as
│       │   ├── IGroupedLayout.as
│       │   ├── ILayout.as
│       │   ├── ILayoutData.as
│       │   ├── ILayoutDisplayObject.as
│       │   ├── ISpinnerLayout.as
│       │   ├── ITrimmedVirtualLayout.as
│       │   ├── IVariableVirtualLayout.as
│       │   ├── IVirtualLayout.as
│       │   ├── LayoutBoundsResult.as
│       │   ├── Orientation.as
│       │   ├── RelativeDepth.as
│       │   ├── RelativePosition.as
│       │   ├── SlideShowLayout.as
│       │   ├── TiledColumnsLayout.as
│       │   ├── TiledRowsLayout.as
│       │   ├── VerticalAlign.as
│       │   ├── VerticalLayout.as
│       │   ├── VerticalLayoutData.as
│       │   ├── VerticalSpinnerLayout.as
│       │   ├── ViewPortBounds.as
│       │   └── WaterfallLayout.as
│       ├── media/
│       │   ├── BaseMediaPlayer.as
│       │   ├── BaseTimedMediaPlayer.as
│       │   ├── FullScreenToggleButton.as
│       │   ├── IAudioPlayer.as
│       │   ├── IMediaPlayer.as
│       │   ├── IMediaPlayerControl.as
│       │   ├── IProgressiveMediaPlayer.as
│       │   ├── ITimedMediaPlayer.as
│       │   ├── IVideoPlayer.as
│       │   ├── MediaTimeMode.as
│       │   ├── MuteToggleButton.as
│       │   ├── PlayPauseToggleButton.as
│       │   ├── SeekSlider.as
│       │   ├── SoundChannelPeakVisualizer.as
│       │   ├── SoundPlayer.as
│       │   ├── SpectrumBarGraphVisualizer.as
│       │   ├── TimeLabel.as
│       │   ├── VideoPlayer.as
│       │   └── VolumeSlider.as
│       ├── motion/
│       │   ├── ColorFade.as
│       │   ├── Cover.as
│       │   ├── Cube.as
│       │   ├── EffectInterruptBehavior.as
│       │   ├── Fade.as
│       │   ├── Flip.as
│       │   ├── Iris.as
│       │   ├── Move.as
│       │   ├── Parallel.as
│       │   ├── Resize.as
│       │   ├── Reveal.as
│       │   ├── Sequence.as
│       │   ├── Slide.as
│       │   ├── Wipe.as
│       │   └── effectClasses/
│       │       ├── BaseEffectContext.as
│       │       ├── IEffectContext.as
│       │       ├── IMoveEffectContext.as
│       │       ├── IResizeEffectContext.as
│       │       ├── ParallelEffectContext.as
│       │       ├── SequenceEffectContext.as
│       │       ├── TweenEffectContext.as
│       │       ├── TweenMoveEffectContext.as
│       │       └── TweenResizeEffectContext.as
│       ├── skins/
│       │   ├── AddOnFunctionStyleProvider.as
│       │   ├── ConditionalStyleProvider.as
│       │   ├── FunctionStyleProvider.as
│       │   ├── IStyleProvider.as
│       │   ├── ImageSkin.as
│       │   ├── StyleNameFunctionStyleProvider.as
│       │   └── StyleProviderRegistry.as
│       ├── system/
│       │   └── DeviceCapabilities.as
│       ├── text/
│       │   ├── BitmapFontTextFormat.as
│       │   ├── FontStylesSet.as
│       │   └── StageTextField.as
│       ├── themes/
│       │   ├── IAsyncTheme.as
│       │   └── StyleNameFunctionTheme.as
│       └── utils/
│           ├── ScreenDensityScaleFactorManager.as
│           ├── display/
│           │   ├── ScreenDensityScaleCalculator.as
│           │   ├── calculateScaleRatioToFill.as
│           │   ├── calculateScaleRatioToFit.as
│           │   ├── getDisplayObjectDepthFromStage.as
│           │   ├── nativeToGlobal.as
│           │   └── stageToStarling.as
│           ├── focus/
│           │   ├── isBetterFocusForRelativePosition.as
│           │   └── isBetterFocusForRelativePosition_LICENSE
│           ├── geom/
│           │   ├── matrixToRotation.as
│           │   ├── matrixToScaleX.as
│           │   └── matrixToScaleY.as
│           ├── keyboard/
│           │   ├── KeyToEvent.as
│           │   ├── KeyToSelect.as
│           │   ├── KeyToState.as
│           │   └── KeyToTrigger.as
│           ├── math/
│           │   ├── clamp.as
│           │   ├── roundDownToNearest.as
│           │   ├── roundToNearest.as
│           │   ├── roundToPrecision.as
│           │   └── roundUpToNearest.as
│           ├── skins/
│           │   └── resetFluidChildDimensionsForMeasurement.as
│           ├── text/
│           │   ├── TextEditorIMEClient.as
│           │   ├── TextInputNavigation.as
│           │   └── TextInputRestrict.as
│           ├── textures/
│           │   ├── TextureCache.as
│           │   └── calculateSnapshotTextureDimensions.as
│           ├── touch/
│           │   ├── DelayedDownTouchToState.as
│           │   ├── LongPress.as
│           │   ├── TapToEvent.as
│           │   ├── TapToSelect.as
│           │   ├── TapToTrigger.as
│           │   └── TouchToState.as
│           └── xml/
│               └── xmlListInsertAt.as
├── test/
│   └── source/
│       ├── TestFeathers-app.xml
│       ├── TestFeathers.as
│       └── feathers/
│           └── tests/
│               ├── AddOnFunctionStyleProviderTests.as
│               ├── AlertMeasurementTests.as
│               ├── AnchorLayoutTests.as
│               ├── ArrayCollectionTests.as
│               ├── ArrayHierarchicalCollectionTests.as
│               ├── BasicButtonInternalStateTests.as
│               ├── BasicButtonMeasurementTests.as
│               ├── BasicButtonTests.as
│               ├── BitmapFontTextEditorFocusTests.as
│               ├── BitmapFontTextRendererTests.as
│               ├── BottomDrawerPopUpContentManagerTests.as
│               ├── ButtonFocusTests.as
│               ├── ButtonGroupDataProviderEventsTests.as
│               ├── ButtonGroupMeasurementTests.as
│               ├── ButtonGroupTests.as
│               ├── ButtonInternalStateTests.as
│               ├── ButtonMeasurementTests.as
│               ├── ButtonTests.as
│               ├── CalloutMeasurementTests.as
│               ├── CalloutPopUpContentManagerTests.as
│               ├── CalloutTests.as
│               ├── ComponentLifecycleTests.as
│               ├── ConditionalStyleProviderTests.as
│               ├── DateTimeSpinnerTests.as
│               ├── DefaultGroupedListHeaderOrFooterRendererMeasurementTests.as
│               ├── DefaultListItemRendererInternalStateTests.as
│               ├── DefaultListItemRendererMeasurementTests.as
│               ├── DrawersMeasurementTests.as
│               ├── DrawersTests.as
│               ├── DropDownPopUpContentManagerTests.as
│               ├── FlowLayoutTests.as
│               ├── FocusIndicatorTests.as
│               ├── FocusManagerEnabledTests.as
│               ├── FocusManagerTests.as
│               ├── FontStylesSetTests.as
│               ├── FunctionStyleProviderTests.as
│               ├── GroupedListDataProviderTests.as
│               ├── GroupedListFactoryIDFunctionTests.as
│               ├── GroupedListFocusTests.as
│               ├── GroupedListRendererAddRemoveTests.as
│               ├── GroupedListTests.as
│               ├── HeaderInternalStateTests.as
│               ├── HeaderMeasurementTests.as
│               ├── HeaderTests.as
│               ├── HierarchicalCollectionTests.as
│               ├── HorizontalLayoutTests.as
│               ├── HorizontalSpinnerLayoutTests.as
│               ├── ImageLoaderInternalStateTests.as
│               ├── ImageLoaderTests.as
│               ├── ImageSkinTests.as
│               ├── InvalidateTests.as
│               ├── KeyToSelectTests.as
│               ├── KeyToTriggerTests.as
│               ├── LabelMeasurementTests.as
│               ├── LabelTests.as
│               ├── LayoutGroupHorizontalLayoutTests.as
│               ├── LayoutGroupInternalStateTests.as
│               ├── LayoutGroupMeasurementTests.as
│               ├── LayoutGroupTests.as
│               ├── LayoutGroupValidationTests.as
│               ├── LayoutGroupVerticalLayoutTests.as
│               ├── ListCollectionFilterTests.as
│               ├── ListCollectionWithArrayTests.as
│               ├── ListFactoryIDFunctionTests.as
│               ├── ListFocusTests.as
│               ├── ListRendererAddRemoveTests.as
│               ├── ListTests.as
│               ├── LongPressTests.as
│               ├── MinAndMaxDimensionsTests.as
│               ├── NumericStepperMeasurementTests.as
│               ├── PageIndicatorMeasurementTests.as
│               ├── PanelMeasurementTests.as
│               ├── PickerListMeasurementTests.as
│               ├── PickerListTests.as
│               ├── PopUpManagerFocusManagerTests.as
│               ├── PopUpManagerTests.as
│               ├── ProgressBarMeasurementTests.as
│               ├── ProgressBarTests.as
│               ├── RadioTests.as
│               ├── RestrictedStyleTests.as
│               ├── ScaleTests.as
│               ├── ScreenNavigatorMeasurementTests.as
│               ├── ScreenNavigatorTests.as
│               ├── ScrollBarHorizontalMeasurementTests.as
│               ├── ScrollBarHorizontalTests.as
│               ├── ScrollBarVerticalMeasurementTests.as
│               ├── ScrollContainerMeasurementTests.as
│               ├── ScrollContainerTests.as
│               ├── ScrollContainerValidationTests.as
│               ├── ScrollerMeasurementTests.as
│               ├── ScrollerTests.as
│               ├── SimpleScrollBarHorizontalTests.as
│               ├── SimpleScrollBarMeasurementTests.as
│               ├── SlideShowLayoutTests.as
│               ├── SliderHorizontalMeasurementTests.as
│               ├── SliderHorizontalTests.as
│               ├── SliderVerticalMeasurementTests.as
│               ├── SpinnerListTests.as
│               ├── StackScreenNavigatorMeasurementTests.as
│               ├── StackScreenNavigatorTests.as
│               ├── StageTextTextEditorFocusTests.as
│               ├── StyleNameFunctionStyleProviderTests.as
│               ├── StyleProviderRegistryTests.as
│               ├── StyleTests.as
│               ├── TabBarEmptyDataProviderTests.as
│               ├── TabBarMeasurementTests.as
│               ├── TabBarTests.as
│               ├── TabNavigatorTests.as
│               ├── TapToSelectTests.as
│               ├── TapToTriggerTests.as
│               ├── TextAreaFocusTests.as
│               ├── TextAreaInternalStateTests.as
│               ├── TextAreaTests.as
│               ├── TextBlockTextEditorFocusTests.as
│               ├── TextBlockTextRendererTests.as
│               ├── TextFieldTextEditorFocusTests.as
│               ├── TextFieldTextEditorTests.as
│               ├── TextFieldTextRendererTests.as
│               ├── TextInputFocusTests.as
│               ├── TextInputInternalStateTests.as
│               ├── TextInputMeasurementTests.as
│               ├── TextInputRestrictTests.as
│               ├── TextInputTests.as
│               ├── TextureCacheTests.as
│               ├── TiledColumnsLayoutTests.as
│               ├── TiledRowsLayoutTests.as
│               ├── TimeLabelTests.as
│               ├── ToggleButtonFocusTests.as
│               ├── ToggleButtonInternalStateTests.as
│               ├── ToggleButtonTests.as
│               ├── ToggleGroupTests.as
│               ├── ToggleSwitchMeasurementTests.as
│               ├── ToggleSwitchTests.as
│               ├── TokenListTests.as
│               ├── TouchToStateTests.as
│               ├── TreeFocusTests.as
│               ├── TreeTests.as
│               ├── VectorCollectionTests.as
│               ├── VectorHierarchicalCollectionTests.as
│               ├── VerticalCenteredPopUpContentManagerTests.as
│               ├── VerticalLayoutTests.as
│               ├── VerticalSpinnerLayoutTests.as
│               ├── XMLListCollectionTests.as
│               ├── XMLListHierarchicalCollectionTests.as
│               ├── XMLListInsertAtTests.as
│               └── supportClasses/
│                   ├── AssertViewPortBoundsLayout.as
│                   ├── CustomMediaPlayer.as
│                   ├── CustomStateContext.as
│                   ├── CustomStyleProvider.as
│                   ├── CustomToggle.as
│                   ├── DisposeFlagQuad.as
│                   └── ScrollerViewPort.as
└── themes/
    ├── AeonDesktopTheme/
    │   ├── README.md
    │   ├── assets/
    │   │   └── images/
    │   │       └── aeon_desktop.xml
    │   ├── package-src.json
    │   ├── package-swc.json
    │   └── source/
    │       └── feathers/
    │           └── themes/
    │               ├── AeonDesktopTheme.as
    │               ├── AeonDesktopThemeWithAssetManager.as
    │               └── BaseAeonDesktopTheme.as
    ├── Export Theme PNGs.jsfl
    ├── MetalWorksDesktopTheme/
    │   ├── README.md
    │   ├── assets/
    │   │   └── images/
    │   │       └── metalworks_desktop.xml
    │   ├── package-src.json
    │   ├── package-swc.json
    │   └── source/
    │       └── feathers/
    │           └── themes/
    │               ├── BaseMetalWorksDesktopTheme.as
    │               ├── MetalWorksDesktopTheme.as
    │               └── MetalWorksDesktopThemeWithAssetManager.as
    ├── MetalWorksMobileTheme/
    │   ├── README.md
    │   ├── assets/
    │   │   └── images/
    │   │       └── metalworks_mobile.xml
    │   ├── package-src.json
    │   ├── package-swc.json
    │   └── source/
    │       └── feathers/
    │           └── themes/
    │               ├── BaseMetalWorksMobileTheme.as
    │               ├── MetalWorksMobileTheme.as
    │               └── MetalWorksMobileThemeWithAssetManager.as
    ├── MinimalDesktopTheme/
    │   ├── README.md
    │   ├── assets/
    │   │   ├── fonts/
    │   │   │   └── pf_ronda_seven_desktop.fnt
    │   │   └── images/
    │   │       └── minimal_desktop.xml
    │   ├── package-src.json
    │   ├── package-swc.json
    │   └── source/
    │       └── feathers/
    │           └── themes/
    │               ├── BaseMinimalDesktopTheme.as
    │               ├── MinimalDesktopTheme.as
    │               └── MinimalDesktopThemeWithAssetManager.as
    ├── MinimalMobileTheme/
    │   ├── README.md
    │   ├── assets/
    │   │   ├── fonts/
    │   │   │   └── pf_ronda_seven.fnt
    │   │   └── images/
    │   │       └── minimal_mobile.xml
    │   ├── package-src.json
    │   ├── package-swc.json
    │   └── source/
    │       └── feathers/
    │           └── themes/
    │               ├── BaseMinimalMobileTheme.as
    │               ├── MinimalMobileTheme.as
    │               └── MinimalMobileThemeWithAssetManager.as
    └── TopcoatLightMobileTheme/
        ├── README.md
        ├── assets/
        │   └── images/
        │       └── topcoat_light_mobile.xml
        ├── package-src.json
        ├── package-swc.json
        └── source/
            └── feathers/
                └── themes/
                    ├── BaseTopcoatLightMobileTheme.as
                    ├── TopcoatLightMobileTheme.as
                    └── TopcoatLightMobileThemeWithAssetManager.as

================================================
FILE CONTENTS
================================================

================================================
FILE: .github/SUPPORT.md
================================================
# Feathers Help & Support

Looking for some help with [Feathers](https://feathersui.com/learn/as3-starling/)? Start by visiting the [the official Starling Framework forum](http://forum.starling-framework.org/) and create a thread in the [Feathers section](http://forum.starling-framework.org/forum/feathers). You'll get help from a community of experts, including [Josh Tynjala](https://joshblog.net/), the creator of Feathers!

## Additional Resources

* [Feathers (Starling) Documentation](https://feathersui.com/learn/as3-starling/)
* [Feathers (Starling) API Reference](https://feathersui.com/api-reference/)

================================================
FILE: .github/workflows/package-feathersui.yml
================================================
name: Package Feathers UI for Starling

on:
  push:
    branches:
      - master
  pull_request:
    branches:
      - master

jobs:
  build:
    runs-on: macos-latest

    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-java@v4
        with:
          java-version: 11
          distribution: "temurin"
      - uses: joshtynjala/setup-adobe-air-action@v2
        with:
          air-version: "33.1"
          accept-license: true
      - uses: joshtynjala/setup-adobe-flash-player-action@v1
      - name: Install dependencies
        run: |
          wget -O playerglobal.swc https://fpdownload.macromedia.com/get/flashplayer/updaters/32/playerglobal32_0.swc
          mkdir ${{ env.AIR_HOME }}/frameworks/libs/player/11.1/
          cp -f playerglobal.swc ${{ env.AIR_HOME }}/frameworks/libs/player/11.1/
          wget -O flexunit.zip http://mirrors.ibiblio.org/apache/flex/flexunit/4.2.0/binaries/apache-flex-flexunit-4.2.0-4.12.0-bin.zip
          unzip -q flexunit.zip
          rm flexunit/flexunit-4.2.0-20140410-flex_4.12.0.swc
      - name: Checkout Starling
        run: |
          git clone https://github.com/Gamua/Starling-Framework $GITHUB_WORKSPACE/starling --depth 1
      - name: Ant Build
        run: |
          ant full -Dflashsdk.root="${{ env.AIR_HOME }}" -Dstarling.root="$GITHUB_WORKSPACE/starling/starling/src" -Dflexunit.root="$GITHUB_WORKSPACE/flexunit" -Dflashplayer="/usr/local/bin/flashplayer"
      - name: Example Ant Build - ComponentsExplorer
        working-directory: examples/ComponentsExplorer
        run: |
          ant build-web -Dflashsdk.root="${{ env.AIR_HOME }}" -Dstarling.root="$GITHUB_WORKSPACE/starling/starling/src"
      - name: Example Ant Build - DragAndDrop
        working-directory: examples/DragAndDrop
        run: |
          ant build -Dflashsdk.root="${{ env.AIR_HOME }}" -Dstarling.root="$GITHUB_WORKSPACE/starling/starling/src"
      - name: Example Ant Build - DrawersExplorer
        working-directory: examples/DrawersExplorer
        run: |
          ant build-web -Dflashsdk.root="${{ env.AIR_HOME }}" -Dstarling.root="$GITHUB_WORKSPACE/starling/starling/src"
      - name: Example Ant Build - HelloWorld
        working-directory: examples/HelloWorld
        run: |
          ant build-web -Dflashsdk.root="${{ env.AIR_HOME }}" -Dstarling.root="$GITHUB_WORKSPACE/starling/starling/src"
      - name: Example Ant Build - LayoutExplorer
        working-directory: examples/LayoutExplorer
        run: |
          ant build-web -Dflashsdk.root="${{ env.AIR_HOME }}" -Dstarling.root="$GITHUB_WORKSPACE/starling/starling/src"
      - name: Example Ant Build - Magic8Chat
        working-directory: examples/Magic8Chat
        run: |
          ant build-web -Dflashsdk.root="${{ env.AIR_HOME }}" -Dstarling.root="$GITHUB_WORKSPACE/starling/starling/src"
      - name: Example Ant Build - PullToRefresh
        working-directory: examples/PullToRefresh
        run: |
          ant build-web -Dflashsdk.root="${{ env.AIR_HOME }}" -Dstarling.root="$GITHUB_WORKSPACE/starling/starling/src"
      - name: Example Ant Build - StackScreenNavigatorExplorer
        working-directory: examples/StackScreenNavigatorExplorer
        run: |
          ant build-web -Dflashsdk.root="${{ env.AIR_HOME }}" -Dstarling.root="$GITHUB_WORKSPACE/starling/starling/src"
      - name: Example Ant Build - Tabs
        working-directory: examples/Tabs
        run: |
          ant build-web -Dflashsdk.root="${{ env.AIR_HOME }}" -Dstarling.root="$GITHUB_WORKSPACE/starling/starling/src"
      - name: Example Ant Build - TileList
        working-directory: examples/TileList
        run: |
          ant build-web -Dflashsdk.root="${{ env.AIR_HOME }}" -Dstarling.root="$GITHUB_WORKSPACE/starling/starling/src"
      - name: Example Ant Build - Todos
        working-directory: examples/Todos
        run: |
          ant build-web -Dflashsdk.root="${{ env.AIR_HOME }}" -Dstarling.root="$GITHUB_WORKSPACE/starling/starling/src"
      - name: Example Ant Build - TrainTimes
        working-directory: examples/TrainTimes
        run: |
          ant build-web -Dflashsdk.root="${{ env.AIR_HOME }}" -Dstarling.root="$GITHUB_WORKSPACE/starling/starling/src"
      - name: Example Ant Build - TransitionsExplorer
        working-directory: examples/TransitionsExplorer
        run: |
          ant build-web -Dflashsdk.root="${{ env.AIR_HOME }}" -Dstarling.root="$GITHUB_WORKSPACE/starling/starling/src"
      - name: Example Ant Build - YouTubeFeeds
        working-directory: examples/YouTubeFeeds
        run: |
          ant build-web -Dyoutube.api.key=abc123 -Dflashsdk.root="${{ env.AIR_HOME }}" -Dstarling.root="$GITHUB_WORKSPACE/starling/starling/src"
      - uses: actions/upload-artifact@v4
        with:
          name: feathersui-starling
          path: output
          if-no-files-found: error

================================================
FILE: .gitignore
================================================
.DS_Store
Thumbs.db
*.swc
*.stackdump
._*
*.local.properties
*.p12
out/
output/
third-party/
signing/
.actionScriptProperties
.flexLibProperties
.project
asconfig.json
.settings/
bin-debug/
bin-release/
html-template/
.metadata/
*.iml
.idea/
archive/
*.lnk
.vscode/
*.code-workspace
package-lock.json

================================================
FILE: CHANGELOG.md
================================================
# Feathers UI Release Notes

Noteworthy changes in official, stable releases of [Feathers UI](https://feathersui.com/).

## 4.2.0 - 2021

## 4.1.1 - May 2020

* FeathersControl: Fixed issue where super.visible was never set to false at the completion of a hideEffect.
* Scroller: Fixed issue where scroller actualWidth was incorrectly passed to view port minVisibleWidth instead of actualMinWidth.

## 4.1.0 - February 2020

* Targets Starling 2.6.
* DefaultTreeItemRenderer: Fixed issue where icons and other styles were not properly restricted, when set outside of a theme.
* Effects: Fixed issue where tween delay was not included in total time.
* FeathersControl: Fixed issue where a null reference error could be thrown when removing a component in the parent's Event.ADDED_TO_STAGE listener.
* FeathersControl: Fixed issue where setting visible to the same value before showEffect or hideEffect completed would incorrectly interrupt the effect.
* List: Fixed issue where accessories/icons would disappear when displaying the drag-and-drop avatar.
* Scroller: Fixed issue where a null reference error could be thrown in the mouse wheel handler.
* Toast: added openEffect, which is triggered after the parent container has run its layout code. Event.OPEN is dispatched when this effect is complete.
* WebView: Fixed issue where the height incorrectly defaulted to the same value as the width.

## 4.0.0 - January 2019

See the [Feathers 4.0 Migration Guide](https://feathersui.com/help/migration-guide-4.0.html) for details about how to upgrade to Feathers 4.0 from previous versions.

* Drag and drop: Added support for drag-and-drop in List and TabBar components.
* Toast: New component for displaying in-app notifications.
* Removed APIs that were deprecated in Feathers 3.x.
* Button: Fixed issue where scaleWhenDown or scaleWhenHovering could get stuck when returning back to a scale of 1, if no other changes to the button state resulted in a call to setRequiresRedraw().
* DataGrid: Fixed issue where multiple cells could be incorrectly deselected when allowMultipleSelection is true.
* DataGrid: Fixed issue where measurement did not account for total combined width of headers.
* DefaultDataGridCellRenderer: If dataField is null, uses the data for the entire row instead.
* FeathersEventType: Fixed typo in "stateChange" string.
* HorizontalLayout: Fixed issue where distributeWidths did not properly use the largest item width when the container's explicit width was not set.
* Header: Added detection for iPhone XS, XS Max, and XR to increase status bar height for notch.
* ImageLoader: Added new style property to support a custom MeshStyle.
* KeyToEvent, KeyToSelect, KeyToState: Fixed null reference error in KeyboardEvent.KEY_DOWN listener if target lost focus before listener was called.
* Navigators: Fixed issue where transitionDElayEvent was ignored if it was dispatched before CREATION_COMPLETE.
* SimpleScrollBar, ScrollBar: Added fixedThumbSize style to allow the thumb size to remain fixed, even when the scrolling range changes.
* Scroller: Fixed issue where pressing left key on keyboard incorrectly jumped to maximum horizontal scroll position.
* Scroller: Fixed issue where scrolling was possible with keyboard when using ScrollPolicy.OFF.
* Scroller: Fixed null reference error caused by removing mask from leftPullView instead of topPullView when changing the topPullView.
* Scroller: Fixed issue where touching a container with snapToPages set to true while it was animating might not continue the animation if needed after TouchPhase.ENDED.
* Slider: Fixed issue where touching track with TrackInteractionMode.TO_VALUE would incorrectly limit the range if minimumPadding or maximumPadding is negative.
* SpinnerList: Fixed issue where removing from stage before animation completed could change the selectedIndex unexpectedly.
* StageTextTextEditor: Fixed issue where a very large width or height would cause the text editor to be positioned below the minimum allowed position.
* TextArea: Added prompt property, similar to TextInput.
* TextArea: Added innerPadding styles to add padding around both prompt and the text in the view port. Breaking change: You must inner padding on the TextArea instead of setting the padding property on TextFieldTextEditorViewPort.
* TextBlockTextRenderer: Fixed issue where the measurement might be wrong if width of height set to negative values.
* TextBlockTextRenderer: Fixed issue where height measurement might be wrong when using starling.text.TextFormat.
* TextBlockTextRenderer, TextFieldTextRenderer: fixed issue where texture was offset and cut off on context resture when using vertical align in starling.text.TextFormat.
* TextBlockTextRenderer: fixed issue where measurement was wrong when using nativeFilters property.
* Themes: Use new starling.assets.AssetManager.
* Todos Example: Can reorder items with drag and drop.
* Todos Example: Persists todos with SharedObject.
* ToggleButton: Fixed issue where the scale for the current state was incorrect when selected.
* ToolTipManager: Fixed cast that incorrectly required all custom tooltips to extend Label instead of implement the IToolTip interface.
* VideoPlayer: Automatically calls setRequiresRedraw() during playback so that skipUnchangedFrames may remain enabled.

## 3.5.0 - June 2018

* AnchorLayout: fixed issue where measurement could be incorrect when using horizontalCenter or verticalCenter.
* BitmapFontTextEditor, TextBlockTextEditor: added Shift+Home, Shift+End, Shift+Up, and Shift+Down keyboard shortcuts.
* BitmapFontTextEditor, TextBlockTextEditor: when pasting text, new lines are removed because TextInput displays only a single line.
* BitmapFontTextEditor, TextBlockTextEditor: fixed issue where soft keyboard incorrectly opened on mobile when not editable.
* BitmapFontTextEditor, TextBlockTextEditor, TextFieldTextEditor: fixed issue where touching outside the text editor incorrectly cleared focus when the FocusManager was enabled (it should only do that without a FocusManager).
* BottomDrawerPopUpContentManager: added panelFactory and closeButtonFactory to allow these components to be more easily customized.
* DataGrid, List, TabBar: fixed issue where sorting the collection did not update the selected indices.
* DateTimeSpinner: fixed issue where the 31st of a month that actually has fewer days could be selected when switching to that month from a different month that has 31 days.
* DateTimeSpinner: fixed issue where Event.CHANGE could be dispatched when the selected date had not changed.
* DeviceCapabilities: added isLargePhone() method to check for plus-sized phones (sometimes called "phablets").
* DeviceCapabilities: isPhone(), isTablet(), and isLargePhone() methods now use both portrait and landscape sizes to determine the correct classification for a device because it is more accurate.
* Effects: Added new built-in animations that can be used by components. Includes Move, Resize, Fade, Iris, Wipe, Sequence, and Parallel.
* FeathersControl: Listens for Event.CHANGE on IStyleProvider to allow themes to modify their style providers and have changes reflected automatically.
* FeathersControl: added showEffect, hideEffect, moveEffect, resizeEffect, focusInEffect, focusOutEffect, addedEffect, and removeFromParentWithEffect().
* fontStyles: In addition to restricting this style when the property is set, also listens for Event.CHANGE.
* GroupedList, Tree: fixed issue where using a data provider that returned XML could cause runtime errors because the item renderer could not be found.
* Header: improved "extra" top padding for iPhone X when app is not full screen.
* HorizontalLayout, VerticalLayout: fixed issue where scaleX and scaleY were not accounted for when an item uses pivotX or pivotY.
* ImageLoader: added loaderContext property to support a custom flash.system.LoaderContext.
* List: added addItemWithEffect() and removeItemWithEffect().
* LongPress: fixed issue where the Event.ENTER_FRAME listener was not removed if the target were set to null before the touch ended.
* nativeToGlobal: utility function similar to localToGlobal(), except converting between native stage coordinates and global Starling coordinates.
* ProgressBar: if the fill skin has a minimum size, and the progress bar's value is equal to its minimum value, the fill skin is hidden.
* Scroller: fixed issue where a null reference error could be thrown in the TouchEvent.TOUCH listener under certain conditions.
* Scroller: if thrown, a new touch automatically stops scrolling and once again requires dragging a minimum distance to start scrolling. This more closely matches native behavior to allow other containers to take over scrolling if dragged in a new direction.
* Scroller: fixed issue where items in the view port might not be positioned correctly when snapScrollPositionsToPixels is true, causing jittery scrolling as items jump between pixels.
* ScrollText: added outerPadding, outerPaddingTop, outerPaddingRight, outerPaddingBottom, and outerPaddingLeft properties.
* Slider: fixed issue where thumb did not go into down state when using TrackInteractionMode.TO_VALUE.
* SpinnerList: Fixed issue where performance could drop temporarily when transitioning from the end back to the beginning (or vice versa) when items repeat.
* SpinnerList: fixed missing calls to processStyleRestriction() for showSelectionOverlay and hideSelectionOverlayUnlessFocused.
* StackScreenNavigator: added isSwipeToPopEnabled property to activate a swipe gesture to navigate back in history.
* StackScreenNavigator: fixed issue where Event.CHANGE was not dispatched again after a transition was cancelled.
* StageTextTextEditor: fixed issue where focus was lost after touching an object with a focus owner, and the focus owner contains the TextInput.
* TextFieldTextEditor: added softKeyboard property to allow the soft keyboard to be customized on mobile.
* TextFieldTextEditor: added resetScrollOnFocusOut property, which is true by default.
* TextFieldTextRenderer, TextFieldTextEditor: useGutter property is automatically forced to true if the border property is set to true so that the border is not clipped.
* TextInput: fixed issue where a text editor might not receive focus if the TextInput moves between TouchPhase.BEGAN and TouchPhase.ENDED.
* Themes: fixed issue where pivots in texture atlas caused some skins to appear at incorrect locations with Starling 2.3.
* TiledColumnsLayout: fixed issue where the columns could be incorrectly aligned horizontally when alignment should not be possible.
* TiledColumnsLayout: fixed issue where an incorrect number of visible columns was calculated when distributeHeights is true.
* TiledColumnsLayout: if distributeWidths is set to true, useSquareTiles is changed to false automatically (or distributeWidths would have no effect).
* TiledRowsLayout: if distributeHeights is set to true, useSquareTiles is changed to false automatically (or distributeHeights would have no effect).
* Tree: added scrollToDisplayLocation() method.
* ValidationQueue: reduced memory allocations to avoid unnecessary garbage collection.
* VectorHierarchicalCollection: Fixed issue that caused compilation to fail with classic Adobe Flex SDK.
* VerticalLayout: fixed issue where a sticky header might disappear too early if paddingTop is greater than zero.
* VideoPlayer: added missing API documentation for FeathersEventType.ERROR.

## 3.4.1 - February 2018

* AnchorLayout: Fixed issue where x and y properties might not be accounted for in measurement if item had AnchorLayoutData, but didn't set left and top.
* BitmapFontTextEditor: Fixed issue where the cursor and selection might be positioned incorrectly when alignment is center or right.
* BitmapFontTextRenderer: Fixed issue where a new MeshStyle could be created too frequently when getDefaultMeshStyle() returns null.
* DataGrid: Fixed issue where reordering the columns might not reorder the column headers if the columns were generated automatically.
* DateTimeSpinner: Fixed issue where the default maximum date near the end of a year when using DateTimeMode.DATE_AND_TIME was not far enough into the future.
* FDT: Fixed some valid, but unconventional, code that caused this IDE to display false-positive compiler errors.
* Hierarchical Collections: Fixed some issues related to using null or empty locations that should have been considered invalid.
* ImageLoader: Fixed issue where an IOError or SecurityError might be thrown for an old source that was replaced.
* PopUpManager: Fixed issue where an error could be thrown by calling removeAllPopUps() when removing one pop-up might remove others automatically.
* TextBlockTextEditor: Fixed issue where the cursor might be positioned incorrectly when alignment is center or right.
* TextFieldTextEditor: Fixed issue where text editor would measure itself incorrectly when using embedded fonts because the measurement was based on device fonts instead.
* ToggleGroup: Fixed issue where a flag to ignore changes might be disabled too early, causing the selection to change to the wrong value.
* Tree: Fixed issue where changing the selected item programatically might not immediately update the appearance of the rendered component.

## 3.4.0 - December 2017

* New Component: DataGrid displays a list of data as a table. Each item is rendered as a row, divided into columns for each of the item's fields. Supports sorting columns, resizing columns, and drag-and-drop reordering of columns.
* Support for Android TV. Refactored focus management API and keyboard interaction to support TV remotes. Support scaling to TV resolutions.
* Collections: support for sorting.
* Alert: fixed null reference error when buttonsDataProvider is null and the accept or cancel key is pressed.
* ArrayHierarchicalCollection, VectorHierarchicalCollection: fixed issue where a runtime error could be thrown when checking if an item is a branch if the item is null.
* AutoComplete: fixed issue where the list did not close if an item is triggered by a keyboard event.
* BitmapFontTextRenderer: added breakLongWords property which can optionally break in the middle of long words if they extend beyond the width of the text renderer's bounds.
* BitmapFontTextRenderer: fixed issue where distance field fonts would render blurry and fonts that shouldn't use smoothing would be blurry.
* Button: added getScaleForState() and setScaleForState() to support different rendering scales in all states, in addition to the existing scaleWhenDown and scaleWhenHovering.
* Button, ToggleButton, ToggleSwitch, List, GroupedList, Tree: Event.TRIGGERED and Event.CHANGE may also be dispatched for Keyboard.ENTER if the key location is KeyLocation.D_PAD.
* Callout: added originGap property to optionally add extra spacing between the callout and its origin.
* DateTimeSpinner: fixed issue where internal SpinnerLists were not disabled when isEnabled is set to false.
* DeviceCapabilities: added simulateDPad property that allows regular keyboard arrow keys to interact with components similarly to a TV remote or another device that dispatches keyboard events with KeyLocation.D_PAD.
* DeviceCapabilities: methods that accept a flash.display.Stage parameter now default to null and fall back to Starling.current.nativeStage.
* DragDropManager: fixed issue where a null reference error could be thrown if the drag source's stage property was null during cleanup.
* FocusManager: can change focus up, down, left, or right if the keyLocation property of the KeyboardEvent is KeyLocation.D_PAD.
* FocusManager: supports TransformGestureEvent.GESTURE_DIRECTIONAL_TAP for focus navigation on Apple tvOS.
* HorizontalSpinnerLayout: added horizontalAlign property to allow the selected item to be aligned to the left or right instead of the default center.
* HorizontalSpinnerLayout: added paddingLeft and paddingRight to affect the position of the selected item, in addition to the horizontalAlign property.
* IFocusDisplayObject, added nextUpFocus, nextDownFocus, nextLeftFocus, and nextRightFocus properties, similar to previousTabFocus and nextTabFocus.
* IFocusDisplayObject: added isShowingFocus property to check if the focused object is showing its focus indicator.
* IListCollection: added sortCompareFunction property to allow sorting of items in the collection.
* ImageLoader: fixed issue where a texture that is too large for the current profile would result in a runtime error instead of being caught and turned into Event.IO_ERROR.
* ImageSkin: the defaultColor property defaults to 0xffffff so that it behaves more like the defaultTexture.
* ImageSkin: throws a runtime error if the color property from the Image superclass is set. Use defaultColor instead.
* IScreenNavigatorItem: added transitionDelayEvent to optionally delay the start of the transition until the screen dispatches an event. This allows the screen extra time to initialize and do things like load assets from the web.
* ISpinnerLayout: added selectionBounds getter to allow the layout to customize where the selectionOverlaySkin should be positioned.
* KeyToEvent: new superclass for KeyToTrigger to allow other events to easily get dispatched on key press.
* KeyToSelect, KeyToState, KeyToTrigger: added keyLocation property to optionally require a specific key location (like KeyLocation.D_PAD).
* LayoutGroup: fixed issue where AutoSizeMode.STAGE could be ignored if children are positioned beyond stageWidth and stageHeight, which could have made the container larger than expected.
* List, GroupedList, Scroller, SpinnerList, TextArea: uses native flash.events.KeyboardEvent.KEY_DOWN for keyboard interaction so that they can cancel focus changes, if necessary.
* List, GroupedList, Tree: fixed issue where a layout could be broken if the typicalItem were null.
* Mobile Themes: Now enable the FocusManager by default, just like desktop.
* NumericStepper: added useLeftAndRightKeys property to optionally allow stepper to be changed with Keyboard.LEFT and Keyboard.RIGHT instead of Keyboard.UP and Keyboard.DOWN.
* PickerList: fixed issue where the pop-up list may be given focus in the wrong focus manager when it uses a different focus manager than the PickerList.
* ScreenDensityScaleFactorManager: added support for Android TV and Apple tvOS.
* ScrollBar, SimpleScrollBar, Slider: fixed issue where the scroll bar could not reach the maximum scroll position with certain page or step values.
* Scroller: fixed issue where a null reference error could be thrown if scrolling animation were manually removed just as it completed.
* SpinnerList: added hideSelectionOverlayUnlessFocused to allow the selectionOverlaySkin to be hidden when the list is not focused if showSelectionOverlay is true.
* SpinnerList: added showSelectionOverlay property to completely hide the selectionOverlaySkin skin when set to false.
* SpinnerList: The selectedIndex and selectedItem is changed immediately when an item renderer is triggered or keyboard events change selection, instead of waiting for the animation to complete.
* StageTextTextEditor: keyboard arrow keys and Keyboard.ENTER are re-dispatched if KeyLocation.D_PAD so that this text editor will support focus changes, similar to how Keyboard.TAB is already re-dispatched.
* TapToEvent: new superclass for TapToTrigger to allow other events to easily get dispatched when tapping a display object.
* TapToEvent, TapToTrigger: added new tapCount property to wait for a specific number of taps before dispatching the event.
* TextBlockTextEditor: improved support for bidiLevel 1 and right-to-left languages.
* TextBlockTextRenderer, TextFieldTextRenderer: fixed issue where updateSnapshotOnScaleChange would result in incorrect texture dimensions if the scale was set after the component validated the first time but before it rendered.
* TextInput: added iconPosition property and support for RelativePosition.RIGHT.
* Todos Example: added a TabBar to filter items based on if they are completed or not.
* ToggleButton: added scaleWhenSelected property.
* TouchToState: if TouchPhase.HOVER is dispatched before TouchPhase.BEGAN, returns to hover state on TouchPhase.ENDED if hitTest() is successful.
* Tree: fixed issue where hasVariableItemDimensions was incorrectly forced to true, if possible. Should now be set manually on the layout.
* VerticalSpinnerLayout: added verticalAlign property to allow the selected item to be aligned to the top or bottom instead of the default middle.
* VerticalSpinnerLayout: added paddingTop and paddingBottom to affect the position of the selected item, in addition to the verticalAlign property.
* VideoPlayer: added netStreamFactory to customize how the flash.net.NetStream is created.

## 3.3.1 - October 2017

* BitmapFontTextRenderer: fixed issue where multiple text renderers with multiple custom mesh styles would incorrectly share a single style.
* FeathersControl: fixed issue where focusIndicatorSkin was not always disposed.
* FontStylesSet: fixed issue where properties from a new starling.text.TextFormat were incorrectly copied to the old TextFormat, which could cause other components to change font styles too.
* ImageLoader: fixed issue where texture would not be reused when starling.textures.Texture.asyncBitmapUploadEnabled is false.
* ImageLoader: fixed issue where error was thrown if using texture cache and the texture could not be reused in its current state on restoration.
* ImageLoader: fixed issue where a runtime error could be thrown if the texture is disposed while the application is deactivated on mobile.
* Scroller: fixed issue where top and bottom offsets were used instead of left and right when determining if the horizontal scroll bar should be displayed.
* Scroller: fixed issue where pull views would not work sometimes if hasElasticEdges is false.
* ScrollText: fixed issue where Event.TRIGGERED would not work if FocusManager is enabled because it didn't implement INativeFocusOwner to return its TextField.
* StageTextTextEditor: fixed issue where setting the parent TextInput's visible property to false inside a FeathersEventType.FOCUS_OUT listener would hide the background, but not the StageText.
* StageTextTextEditor: fixed issue where calling clearFocus() after setting the parent TextInput's visible property to false would hide the background, but not the StageText.
* TabNavigator: fixed issue where the previous screen was incorrectly recreated if isSwipeEnabled is true and a swipe transition is cancelled.
* TextInputRestrict: fixed issue where -, ^, and \ characters could not be escaped. Used by BitmapFontTextEditor and TextBlockTextEditor.

## 3.3.0 - July 2017

See the [Feathers 3.3 Migration Guide](https://feathersui.com/help/migration-guide-3.3.html) for details about how to upgrade to Feathers 3.3.

* New Component: Tree is a List-like component designed for displaying nested hierarchical data, with branches that may be opened and closed.
* New Layout: SlideShowLayout is designed for displaying one image at a time in a gallery.
* BaseDefaultItemRenderer: fixed issue in skinSourceField where the wrong variable was checked to determine if the property has changed.
* BaseDefaultItemRenderer: fixed issue where icon or accessory dimensions were not accounted for in measurement if item renderer does not have a label.
* BaseLinearLayout: new abstract base class for HorizontalLayout and VerticalLayout that shares common code.
* BaseTiledLayout: new abstract base class for TiledRowsLayout and TiledColumnsLayout that shares common code.
* BottomDrawerPopUpContentManager: added customCloseButtonStyleName to customize the style name of the close button in the theme.
* BottomDrawerPopUpContentManager, CalloutPopUpContentManager, DropDownPopUpContentManager, VerticalCenteredPopUpContentManager: fixed issue where the content was not scaled the same as the origin.
* Callout: fixed issue where stage dimensions were not accounted for when calculating maximum dimensions of content.
* Callout: fixed issue where moving origin when content is smaller than background skin could cause content to be rendered at incorrect size.
* Cover, Reveal, Wipe: fixed issue where runtime error could be thrown if mask was unexpectedly removed from display objects.
* DateTimeSpinner: fixed issue where you could not set the itemRendererFactory directly on the inner SpinnerLists when the DateTimeSpinner itemRendererFactory was null.
* DefaultFocusManager: fixed issue where addEventListener() was called where removeEventListener() should have been called, potentially causing a memory leak.
* DefaultFocusManager: fixed issue where maintainTouchFocus was incorrectly ignored.
* Direction: added NONE constant that may be used in some situations.
* DropDownPopUpContentManager: fixed issue where the delegate used for animation was not scaled by the same amount as the content it mirrored.
* DropDownPopUpContentManager, VerticalCenteredPopUpContentManager: fixed issue where content was not positioned or resized correctly if PopUpManager.root is scaled.
* FeathersControl: throws an error if validate() is called during initialize() because it was not clear that this previously returned without doing anything.
* FeathersControl: fixed issue where setting minWidth or minHeight that is larger than the actualWidth and actualHeight might fail to invalidate the component.
* FeathersControl: fixed issue where setting the validation queue before initialization could cause a navigator to trigger validation when showing a screen during initialization and validate something too early.
* FocusManager: fixed issue where getFocusManagerForStage() threw a RangeError if stack size is 0 instead of returning null.
* FontStylesSet: added dispose() method to make sure event listeners are removed (to be called by the parent of the text renderer/editor).
* FontStylesSet: no longer calls clone() on starling.text.TextFormat because this prevents detection of changes to original TextFormat object. This reverts a change in Feathers 3.1.2 and goes back to previous behavior (while still fixing the memory leak that prompted the change).
* GroupedList: fixed issue where first/last/single item renderer factories were not used as fallbacks when factoryIDFunction returns null.
* GroupedList, List: fixed issue where mouse wheel did not work when useVirtualLayout is false in layout.
* GroupedList: fixed issue where keyboard navigation failed after multiple groups.
* HorizontalSpinnerLayout, VerticalSpinnerLayout: fixed issue where keyboard navigation did not loop when items are repeated.
* ILayout: added calculateNavigationDestination() to allow custom behavior for keyboard navigation.
* IListCollection: new interface to support custom collection implementations, and added ArrayCollection, VectorCollection, and XMLListCollection.
* IHierarchicalCollection: new interface to support custom hierarchical collection implementations, and added ArrayHierarchicalCollection, VectorHierarchicalCollection, and XMLListHierarchicalCollection.
* ImageLoader: fixed issue where originalSourceWidth and originalSourceHeight properties returned the wrong value in an Event.COMPLETE listener.
* ImageLoader: fixed issue where scaleFactor getter returned incorrect value.
* LayoutGroup, ScrollContainer: in a subclass that overrides draw(), if a child is resized or has changes to its layoutData before super.draw() is called, the container will not be invalidated to avoid the "returned to validation queue too many times during validation" error.
* SoundPlayer: added soundLoaderContext property to allow a flash.media.SoundLoaderContext to be passed in for the internal load() call.
* Scroller: added horizontalPageIndex and verticalPageIndex setters so that you can change pages without calling scrollToPageIndex() (which is meant for animation).
* Scroller: fixed issue where scroll bar would fade out immediately when beyond the minimum or maximum scroll position instead of waiting until after the scroller snaps back into range.
* Scroller: if hasElasticEdges is false, does not consider itself dragged if already at the minimum or maximum and can't be scrolled further.
* Scroller: fixed issue with snapScrollPositionToPixels where the animation would appear to complete because it had already snapped to the final pixel, but there could still be more time left on the animation.
* Scroller: fixed issue where measured view port dimensions (such as those from a layout) that are smaller than content dimensions would cause the full dimensions to exclude the scroll bars. This would sometimes cause both horizontal and vertical scroll bars to appear when only one should be required.
* Scroller: fixed incorrect maximum page index calculation caused by floating point math error and Math.ceil.
* Scroller: fixed issue where pull views with pivots were not masked correctly.
* ScrollContainer: fixed issue where children positioned at negative coordinates did not affect the minimum scroll position.
* ScrollContainer: fixed issue where pivotX and pivotY were not scaled when calculating item position.
* SpinnerList: fixed issue where an item renderer that is disabled could be incorrectly selected. Returns to the previously selected index if the scroll position lands on a disabled item renderer.
* SpinnerList: fixed issue where pageThrowDuration property was ignored when scrolling horizontally.
* TabNavigator: fixed issue where isSwipeEnabled getter returned incorrect value.
* TextArea: fixed issue where runtime error would be thrown in measureViewPort is true.
* TextFieldTextEditor: fixed issue where state changes in the parent component would not always update the font styles when using starling.text.TextFormat.
* Text Renderers/Editors: if they have a texture snapshot, optimized to avoid updating the snapshot until render() is called, in case it needs to validate() multiple times per frame (which is common in lists).
* TiledColumnsLayout, TiledRowsLayout: deprecated PAGING_NONE, PAGING_HORIZONTAL, and PAGING_VERTICAL in favor of Direction.NONE, Direction.HORIZONTAL, and Direction.VERTICAL.
* ToggleSwitch: now uses ExclusiveTouch so that parent containers cannot scroll while dragging thumb.
* Gallery Example: replaced full size image with a List that uses SlideShowLayout, and the full size image may be resized with a gesture.

## 3.2.0 - April 2017

* PullToRefresh: new example that demonstrates how to support the popular "pull to refresh" gesture with Feathers lists and other scrolling containers.
* TabNavigator: support for swiping between tabs.
* ListCollection: added filterFunction property to support filtering items in data providers.
* API Reference: All classes now specify the version of Feathers when they were first added.
* Added [Deprecated] metadata to deprecated APIs.
* Alert: added acceptButtonIndex and cancelButtonIndex to allow keyboard (or hardware back button) control over alert.
* AnchorLayout: fixed issue where maxWidth and maxHeight were ignored when using top/right/bottom/left on AnchorLayoutData.
* AutoComplete, PickerList: fixed issue where event listeners were not added to default popUpContentManager created in initialize().
* BitmapFontTextEditor, TextBlockTextEditor: added support for blinking cursor when focused.
* BitmapFontTextEditor, TextBlockTextEditor: fixed issue where FeathersEventType.FOCUS_OUT would not be dispatched afte calling setFocus() when the FocusManager is not enabled.
* BitmapFontTextRenderer: fixed an issue where extra whitespace would appear at the end of every line.
* BitmapFontTextRenderer: added support for kerning and letterSpacing properties of starling.text.TextFormat.
* Button, DefaultGroupedListHeaderOrFooterRenderer, Header: added wordWrap property. No longer needs to be set in text renderer factory, but existing code that sets it there will continue to work.
* Button, DefaultGroupedListHeaderOrFooterRenderer, Header: added numLines getter to get the number of lines displayed in the text renderer.
* Button: fixed issue where label text renderer measurement was incorrect if minWidth or minHeight is set explicitly.
* CalloutPopUpContentManager: similar to Callout, the direction property is now deprecated and added supportedPositions as its replacement.
* DateTimeSpinner: added backgroundSkin, backgroundDisabledSkin, and padding properties.
* DateTimeSpinner: fixed issue where pending value of scrollToDate() was not cleared.
* Drawers: content property may now be null when validating. However, it should not be null when opening a drawer.
* FeathersControl; layoutData is set to null when disposed to avoid potential memory leaks.
* FeathersControl: Removes event listeners on styleNameList when disposed so that they cannot be called for no reason.
* FeathersControl; added ignoreNextStyleRestriction() to allow components to set defaults during initialization while still allowing a theme to replace styles later.
* FeathersControl: fixed an issue where measured minimum dimensions were not affected by explicit maximum dimensions.
* GroupedList: similar to items, an error is thrown if duplicate header or footer data appears in the data provider.
* HorizontalLayout, VerticalLayout: fixed issue where includeInLayout was ignored when distributing item sizes.
* HorizontalLayout, VerticalLayout: fixed issue where includeInLayout was ignored when using percent dimensions.
* HorizontalLayout, VerticalLayout: fixed issue where the typicalItem could not resize after layout.
* ImageLoader: supports asynchronous texture uploads to improve performance when uploading textures to the GPU.
* ImageLoader: exposed sourceToTextureCacheKey() to allow subclasses to override the key used in the TextureCache for non-URL sources.
* ImageLoader: createTextureOnRestore accepts sources that are non-URLs to allow subclasses to override this behavior.
* IPopUpContentManager: now includes EventDispatcher APIs so that casting is not required.
* Item Renderers: callbacks like labelFunction and iconFunction now support a second, optional parameter for the item's index. For example, labelFunction may now use either of the following signatures: function(item:Object):String or function(item:Object, index:int):String.
* Item Renderers: will now display data when owner is null.
* KeyToState: new utility class to change a component's state based on keyboard events.
* KeyToTrigger, KeyToSelect: fixed issue where event listeners added to the stage would not be removed if the target was set to null before it was removed from stage.
* List, GroupedList; when updateAll() is called on the data provider, items that were added or removed from source are now rendered.
* List, GroupedList: fixed issue where event listeners were not added to default layout created in initialize().
* List, GroupedList: fixed issue where an item could not receive a new factoryID after its index changes.
* ListCollection, HierarchicalCollection: removeAll() no longer results in CollectionEventType.RESET. This should not have been considered a drastic reset. CollectionEventType.REMOVE_ALL is dispatched instead.
* PickerList: added itemRendererFactory and customItemRendererStyleName. They no longer need to be set in the listFactory. However, existing code that sets them in the listFactory will continue to work correctly.
* Navigators: validates active screen when navigator validates to avoid flickering on next frame with delayed automatic validation.
* ScrollContainer: renamed internal stage_resizeHandler to scrollContainer_stage_resizeHandler because ASC 1.0 might consider it a conflict.
* Scroller: fixed issue where a state change would not cause the scroller to measure its new background skin.
* Scroller: fixed issue where a layout change would not cause the scroller to measure its content again.
* Scroller: added horizontalScrollBarPosition to allow the horizontal scroll bar to appear on top.
* Scroller: added support for pull views on top, right, bottom, and left to support "pull to refresh" gesture.
* Scroller: fixed issue where scrollToPageIndex() would not result in dispatch of FeathersEventType.SCROLL_START and FeathersEventType.SCROLL_COMPLETE.
* SpinnerList: fixed issue where scroll position was not updated if layout snapInterval changed.
* StageTextTextEditor: position of StageText can no longer be larger than 8191 or smaller than -8192 to avoid a runtime error.
* StageTextTextEditor: added clearButtonMode property to support new StageText API.
* StageTextTextEditor: does not call assignFocus() on StageText if StageText already has focus because this can cause soft keyboard to close and re-open on iOS.
* TabBar: fixed issue where setSelectedIndexWithAnimation() and setSelectedItemWithAnimation() did not change the value of the selectedItem property.
* TabBarSlideTransitionManager: moved to feathers-compat project.
* TextBlockTextRenderer: fixed issue where a new line width would not be properly detected when using content property, and optimized for the standard text case.
* TextBlockTextRenderer: added support for leading, kerning, and letterSpacing properties of starling.text.TextFormat.
* TextBlockTextRenderer, TextFieldTextRenderer: fixed incorrect position of snapshots when using updateSnapshotOnScaleChange.
* TextFieldTextRenderer: ensures that _text property is not null because flash.text.TextField does not support null values.
* TextInput: no longer shows IBEAM cursor on TouchPhase.HOVER if isEditable and isSelectable are both false.
* TouchToState: new utility class to change a component's state based on TouchPhase values.
* VerticalCenteredPopUpContentManager: fixed margin setter that passed 0 to marginTop/marginRight/marginBottom/marginLeft instead of new value.
* VerticalLayout: alignment of headers with getScrollPositionForIndex() defaults to VerticalAlign.TOP because that makes more sense for headers instead of VerticalAlign.MIDDLE.
* VideoPlayer: fixed issue where display state was not properly updated when exiting full screen with the Escape key.

## 3.1.2 - January 2017

* FontStylesSet: Clones or copies properties from starling.text.TextFormat to avoid memory leak.

## 3.1.1 - November 2016

* AnchorLayout: fixed issue where using percentWidth would result in an error about maxWidth being NaN.
* DefaultListItemRenderer: fixed issue where defaultSkin and defaultIcon properties were not treated correctly as styles.
* FlowLayout: fixed issue where alignment to the center or right was not correct when container has explicit width.
* Header: accounts for new Capabilities.os value on some recent iOS devices when calculating extra padding for status bar when not full screen.
* HorizontalLayout, VerticalLayout fixed issue where using requestedColumnCount/requestedRowCount would result in incorrect view port dimensions if layout contained zero items.
* TextBlockTextRenderer, TextBlockTextEditor: fixed issue where text would not be clipped sometimes if truncation is disabled.
* TextBlockTextRenderer: fixed issue where center or bottom alignment was offset incorrectly.
* ToggleButton: fixed issue where defaultLabelProperties, selectedUpLabelProperties, and other selected label properties were ignored.

## 3.1.0 - October 2016

See the [Feathers 3.1 Migration Guide](https://feathersui.com/help/migration-guide-3.1.html) for details about how to upgrade to Feathers 3.1.

* New Component: TabNavigator to display a TabBar that switches between screens, similar to a ScreenNavigator.
* Font Styles: all components support starling.text.TextFormat for font styling. For advanced needs, text renderers can still use low-level ElementFormat/TextFormat objects which take precedence.
* Style Properties: some properties are now considered styles, and a theme cannot replace their values if they are set outside of the theme first. No more AddOnFunctionStyleProvider, validation, or extending the theme required.
* Architecture: Attempts to use stage.starling instead of Starling.current, if possible. Brings better compatibility with multiple Starling instances.
* Architecture: switched many places to use starling.utils.Pool instead of static helper objects.
* AnchorLayout: fixed issue where maxWidth wasn't used when explicitWidth was not set.
* AnchorLayout, HorizontalLayout, VerticalLayout: with percentWidth and percentHeight, explicitMinWidth and explicitMinHeight will be used as the final minimum bounds instead of calculated minimums sent to saveMeasurements().
* BitmapFontTextRenderer: fixed infinite loop when wordWrap is true and maxWidth is 0.
* BitmapFontTextRenderer: added style property to support a custom MeshStyle.
* BitmapFontTextRenderer: fixed issue where resizing larger would not change position of aligned text.
* Button: fixed issue where header would invalidate too often if icon dimensions change.
* Button: fixed alignment when using scaleWhenDown or scaleWhenHovering.
* ButtonBar: implements ITextBaselineControl to expose button baseline.
* Callout: is positioned in parent's coordinate space, instead of stage coordinate space.
* ColorFade: fixed issue where Quad could be given a width or height of 0 in its constructor, which causes a runtime error.
* Cube: fixed issue with culling that caused screen to overlap incorrectly during transition.
* DateTimeSpinner: added customItemRendererStyleName.
* Default Item Renderers: added customIconLoaderStyleName and customAccessoryLoaderStyleName for icon and accessory ImageLoaders.
* Default Item Renderers: uses customHitTest on TapToTrigger, TapToSelect, and LongPress to exclude accessory from touches (instead of old custom implementation).
* DropDownPopUpContentManager: fixed issue where Quad could be given a width or height of 0 in its constructor, which causes a runtime error.
* FeathersControl: runtime error is thrown if a component is repeatedly added to validation queue in the same frame.
* FeathersControl: instead of adding listeners for FeathersEventType.FOCUS_IN and FeathersEventType.FOCUS_OUT when focusManager is set, adds listeners automatically if component implements IFocusDisplayObject.
* FlowLayout: fixed issue where horizontal alignment did not account for items larger than the width of the view port.
* GroupedList, List: fixed issue where calling scrollToDisplayIndex() would result in a runtime error if dataProvider is null.
* Header: uses ScreenDensityScaleCalculator to calculate extra padding on iOS when app is not full screen.
* Header: fixed issue where header would invalidate too often if item dimensions change.
* Header: fixed issue where extra status bar padding for iOS might not be calculated correctly if background skin height is large enough.
* HorizontalLayout, VerticalLayout: fixed issue where distributeWidths and distributeHeights did not work correctly when useVirtualLayout is true.
* HorizontalLayout, VerticalLayout: fixed issue where percentHeight or percentWidth might not be used during measurement.
* HorizontalLayout, VerticalLayout: fixed issue where maxWidth or maxHeight would be incorrectly limited.
* HorizontalLayout, VerticalLayout: fixed issue where requestedRowCount and requestedColumnCount did not work correctly when useVirtualLayout is false.
* HorizontalLayout, VerticalLayout: added maxColumnCount and maxRowCount properties.
* HorizontalSpinnerLayout, VerticalSpinnerLayout: fixed runtime error in snapInterval property when typicalItem is null.
* ImageLoader: fixed issue where scale9Grid incorrectly allowed maintainAspectRatio to remain in effect.
* ImageLoader: fixed issue where a layout with percentWidth and percentHeight might not work because minimum dimensions were not calculated correctly.
* ImageLoader: does not call close() on flash.display.Loader because this can cause a memory leak when using ImageDecodingPolicy.ON_LOAD. Instead, switches to different Event.COMPLETE listener to dispose BitmapData and unload image.
* ImageSkin: fixed issue where skin would not resize correctly after setting explicit dimensions and then clearing them.
* ITextRenderer: added numLines getter that returns the number of lines of text that are wrapped.
* ITextRenderer, ITextEditor: added fontStyles property that accepts a FontStylesSet. This is not meant to be used by application developers, but custom component authors. Application developers should set font styles on the parent component instead of text renderer/editor.
* LayoutGroup Item Renderers: added backgroundSelectedSkin to optionally customize background when selected.
* LayoutGroup, ScreenNavigator, ScrollContainer: StackScreenNavigator: fixed issue where AutoSizeMode.STAGE would be ignored if the navigator validated before being added to the stage.
* LayoutGroup, ScrollContainer: the default layout (when the layout property is null) now accounts for pivotX and pivotY during measurement.
* MultiStarlingStyleNameFunctionTheme: moved to feathers-compat.
* Panel: fixed issue where header would invalidate too often if header dimensions changes.
* PickerList: calls revealScrollBars() on pop-up list when opened to show whether scrolling is possible.
* PickerList: implements ITextBaselineControl to expose button baseline.
* PopUpManager: now accounts for pivotX and pivotY when centering a pop-up.
* PopUpManager: added popUpCount property to indicate how many pop-ups are currently open.
* PopUpManager: added removeAllPoUps() function to remove all open pop-ups.
* ScreenDensityScaleCalculator: pulled out calculation of scale factor using DPI from ScreenDensityScaleFactorManager into separate class that can be used elsewhere.
* ScreenNavigator, StackScreenNavigator: the default transition (which has no effect) now happens immediately instead of waiting for next frame the way that animated transitions are treated.
* Scroller: fixed issue where final touch movement would not be included in drag on TouchPhase.ENDED.
* Scroller: runtime error is thrown if measurement of view port gets into an infinite loop. Previously, it broke out of the loop, but performance would suffer.
* Scroller: checks for drag start on TouchPhase.MOVED so that the Quad touch blocker appears faster and the view port does not receive invalid touches. Continues to update velocity on Event.ENTER_FRAME.
* Scroller: fixed issue where a runtime error was thrown when a bubbling TouchEvent continued after removing the listener.
* SpinnerList: fixed issue where pageThrowDuration property was ignored when scrolling horizontally.
* SpinnerList: fixed issue where scroll position was not updated after removing or adding item before the selected item.
* StackScreenNavigator: fixed issue where navigator could transition infinitely because state was not cleared correctly.
* StageTextTextEditor, TextFieldTextEditor: fixed issue where the texture would be updated too frequently because the wrong texture dimensions were used for comparison.
* StageTextTextEditor, TextFieldTextEditor: added maintainTouchFocus property that will keep the text editor in focus if something else is touched. On mobile, this will keep the soft keyboard open. Requires AIR 22.
* StageTextTextEditor: fixed issue where StageText could not always be hidden when isEditable is false.
* StyleNameFunctionTheme: has a property for the Starling instance it is associated with.
* StyleNameFunctionTheme: automatically supports multiple Starling instances. Create a new instance of the theme when a new instance of Starling is current.
* TabBar: dispatches Event.TRIGGERED when a tab is triggered. The event's data property references the item from the data provider.
* TabBar: added selectedSkin property to display an animated overlay over the tabs to indicate selection.
* TabBar: added setSelectedIndexWithAnimation() to animate the selectedSkin on programatic selection changes (always animated on user changes).
* TabBar: added labelField, labelFunction, iconField, iconFunction, enabledField and enabledFunction. These are no longer controlled by tabInitializer property.
* TabBar: icon from ListCollection is not disposed, and dispose() function on ListCollection should be used.
* TabBar: implements ITextBaselineControl to expose tab baseline.
* TapToTrigger, TapToSelect, LongPress: added customHitTest property to allow items to be excluded or other custom behavior.
* TextArea: no longer changes selection range when given focus because Flex and HTML textarea element don't do that.
* TextArea: exposed selectionBeginIndex and selectionEndIndex properties, similar to TextInput.
* TextArea: fixed issue where calling selectRange() immediately after setFocus() would incorrectly change selection.
* TextArea, TextInput: fixed issue where changing errorString while input has focus would not change visibility of TextCallout (such as when setting to null).
* TextBlockTextRenderer, TextBlockTextEditor, TextFieldTextRenderer, TextFieldTextEditor: uses SystemUtil.isEmbeddedFont() to determine if font styles are embedded when using starling.text.TextFormat.
* TextBlockTextRenderer, TextFieldTextRenderer: optimize render() function to avoid calling getTransformationMatrix() unless required.
* TextBlockTextRenderer, TextFieldTextRenderer: uses smallest texture possible, even when dimensions are explicit to save memory and optimize performance (so that resizing larger doesn't cause a new texture to be required).
* TextInput: calling setFocus() programatically will select all text, for consistency with Flex.
* TextInput: fixed issue where incorrect selection range would be reported in FeathersEventType.FOCUS_IN listener.
* TextInput: fixed issue where selection range would not be set if text editor did not exist yet.
* Text Renderers, Text Editors: when using starling.text.TextFormat, supports vertical alignment.
* TiledColumnsLayout, TiledRowsLayout: added distributeWidths and distributeHeights properties.
* ToggleGroup: added numItems property and getItemAt() method.
* ToggleSwitch: implemented IStateContext with states defined in feathers.controls.ToggleState class.
* ValidationQueue: no longer keeps a delayed queue that will be validated a frame later because FeathersControl throws an error in the cases where it was used.
* VerticalLayout: fixed issue where scroll position calculation did not account for sticky header on GroupedList.
* VideoPlayer: added events for MediaPlayerEventType.CUE_POINT and MediaPlayerEventType.XMP_DATA for NetStream's onCuePoint and onXMPData.
* VideoPlayer: invalidates layout after Event.READY so that it might resize, if needed.
* WebView: added FeathersEventType.LOCATION_CHANGING.
* New Example: Tabs, a demonstration of the new TabNavigator component.
* New Example: Magic8Chat, a mobile chat application.

## 3.0.4 - September 2016

* Header: fixed issue where extra padding for status bar did not work on iOS 10.

## 3.0.3 - July 2016

* ImageLoader: Fixed issue where reusing the existing texture did not cause the rendered view to update when skipUnchangedFrames is true.
* Text Renderers: Fixed issue where reusing the existing texture(s) did not cause the rendered view to update when skipUnchangedFrames is true.

## 3.0.2 - June 2016

* Scroller: Fixed issue where view port mask would not always be resized, such as when items are added to a List.

## 3.0.1 - June 2016

* List, GroupedList: fixed issue where ViewPortBounds minWidth and minHeight could be NaN (this broke percentWidth and percentHeight on some layouts).
*  HorizontalLayout, VerticalLayout: fixed issue where layout could invalidate every frame when using percentages.
*  FeathersControl: fixed issue where setting width or height, then scaleX or scaleY, then trying to set original width or height would fail.

## 3.0.0 - June 2016

See the [Feathers 3.0 Migration Guide](https://feathersui.com/help/migration-guide-3.0.html) for details about how to upgrade to Feathers 3.0.

* Support for Starling Framework 2.0
* Minimum runtime version is now Flash Player 19 and AIR 19.
* All Components: now automatically calculate minimum dimensions when they are not set explicitly. These values may be used by some layouts, such as when specifying percentWidth and percentHeight.
* New Example: StackScreenNavigatorExplorer demonstrates various options for StackScreenNavigator.
* Examples: updated to use ScreenDensityScaleFactorManager.
* Examples: updated to use Starling's new skipUnchangedFrames property.
* Example Themes: updated to scale based on contentScaleFactor instead of Capabilities.screenDPI.
* Example Themes: Redesigned using Animate CC, and exported as sprite sheet. Find links to original FLA files in Feathers Help.
* Migrated shared constants to a single class. Example: HORIZONTAL_ALIGN_LEFT, HORIZONTAL_ALIGN_CENTER, and HORIZONTAL_ALIGN_RIGHT are now available on the feathers.layout.HorizontalAlign class. See migration guide for details and regular expressions for Find/Replace.
* AnchorLayout: optimized measurement of children by restricting dimensions before validation.
* BasicButton: new superclass of Button that has only a background skin. Useful as for skinning components like a Slider's thumb or tracks that don't need an icon or label.
* BitmapFontTextEditor: fixed issue where selectionAnchorIndex was not updated in certain situations.
* BitmapFontTextRenderer: fixed issue where explicit dimensions were ignored in measurement.
* BitmapFontTextRenderer: replaced snapToPixels property with pixelSnapping property to match Starling 2.0 naming convention.
* BitmapFontTextRenderer: added support for offsetX and offsetY properties from starling.text.BitmapFont.
* BitmapFontTextRenderer: optimized measurement of width by skipping calculations if maximum is larger than last width.
* BottomDrawerPopUpContentManager: added overlayFactory property to customize the modal overlay.
* Button: deprecated stateToSkinFunction. Replaced by feathers.skins.ImageSkin.
* Button: deprecated upLabelProperties, hoverLabelProperties, downLabelProperties, disabledLabelProperties. Replaced by setting font styles on text renderer in labelFactory. Text renderers now support multiple font styles for different states.
* Button: states are defined in feathers.controls.ButtonState.
* Button: fixes issue where some icons or skins would not be disposed when button is disposed.
* ButtonGroup: fixed issue where changing isEnabled in data provider to false and then true would not re-enable a button.
* ButtonGroup: added buttonReleaser property that works similarly to buttonInitializer, but for cleaning up a tab.
* Callout: deprecated supportedDirections property, and replaced it with supportedPositions property that accepts a Vector.<String> of constants defined by the RelativePosition class. Allows more flexibility in the preferred order of callout positions.
* Callout: added horizontalAlign and verticalAlign properties to customize alignment of callout relative to its origin.
* CalloutPopUpContentManager: added overlayFactory property to customize the modal overlay.
* ConditionalStyleProvider: new style provider where the result of a function selects between two style providers.
* DateTimeSpinner: added itemRendererFactory property to allow the item renderer to be customized. Must return a DefaultListItemRenderer or a subclass.
* DateTimeSpinner: improved measurement with DateTimeMode.DATE by using longest month name as typical item.
* DateTimeSpinner: fixed issue where runtime error could be thrown if changing range or locale.
* DateTimeSpinner: fixed issue where changing locale would not update displayed month names.
* DateTimeSpinner: fixed issue where year range would be wrong after changing minimum.
* DateTimeSpinner: now uses a typicalItem for the DateTimeMode.DATE_AND_TIME dates list so that it won't resize during scrolling.
* DefaultListItemRenderer, DefaultGroupedListItemRenderer: itemToLabel() now strictly checks for null instead of a "truthy" value, and an empty string will have different behavior.
* DisplayListWatcher: removed class. Please migrate to new themes, or find this class in feathers-compat library.
* Drawers: fixed issue where drawer would jump open instead of opening smoothly when minimumDragDistance was too large.
* Drawers: optimized measurement of drawers by setting explicit/max dimensions before validation.
* Drawers: drawers must implement IFeathersControl, and Sprite is not allowed anymore.
* Drawers: now enforces the assumption that multiple drawers cannot be opened at the same time (multiple drawers can still be docked).
* FeathersControl: setSizeInternal() is deprecated and replaced by saveMeasurements(), which includes the ability to set the minimum width and minimum height.
* FeathersControl: added toolTip property to display a tool-tip if the ToolTipManager is enabled.
* FeathersControl: added explicitWidth, explicitHeight, explicitMinWidth, and explicitMinHeight. Will return a Number when set, or NaN if the component has auto-sized.
* FeathersControl: if component implements IStateContext and focusIndicatorSkin is IStateObserver, passes self to stateContext property.
* FeathersControl: added resetStyleProvider() function to allow a component's style provider to be set back to the default. Useful when changing to a different theme.
* FeathersControl: fixed issue where setting width after scaleX (or height after scaleY) would result in incorrect final dimensions. Same for minWidth and minHeight.
* FeathersControl: maxWidth and maxHeight can never be less than 0.
* FeathersControl: optimization where the component will not invalidate if changing minWidth, minHeight, maxWidth, or maxHeight obviously won't affect the actual dimensions of the component.
* FocusManager: fixed issue where focus would stop going forward when encountering an IFocusContainer.
* FlowLayout: fixed issue where alignment could be wrong if maximum row width were smaller than max width.
* GroupedList: added itemToItemRenderer(), headerDataToHeaderRenderer(), and footerDataToFooterRenderer() functions, to get a renderer for specific data (if one is available).
* GroupedList: fixed issue where a runtime error could be thrown when the dataProvider property is null.
* GroupedList: fixed issue where a runtime error could be thrown when adding or removing an item and using first, last, or single item renderer.
* Header: improved calculation of status bar height when using useExtraPaddingForOSStatusBar.
* Header: When horizontalAlign is HorizontalAlign.LEFT, and the header has leftItems, the title will appear to the right of the items instead of being hidden. Same for HorizontalAlign.RIGHT and rightItems. In these cases, the title will still be hidden if the header has centerItems.
* HorizontalLayout: fixed issue where percentWidth/percentHeight values greater than 100 were not clamped.
* HorizontalSpinnerLayout: added repeatItems property that may be set to false to disable repeating items with infinite scrolling.
* HorizontalSpinnerLayout: fixed issue where items could disappear when using gap property.
* ImageLoader: fixed issue where setting source to null when using a TextureCache would not release the texture from the cache.
* ImageLoader: replaced snapToPixels property with pixelSnapping property to match Starling 2.0 naming convention.
* ImageLoader: added scale9Grid and tileGrid properties.
* ImageLoader: fixed issue where ScaleMode.NONE was not respected during auto-sizing.
* ImageLoader: masks internal Image instead of itself when clipping a scaled texture so that the mask property can be used too.
* ImageSkin: new display object that supports multiple textures and colors for different states.
* IMeasureDisplayObject: new interface with explicit, minimum, and maximum dimensions for use when the full IFeathersControl is not necessary.
* INativeFocusOwner: nativeFocus property is now typed as Object instead of InteractiveObject so that objects like StageText may be used, and added IAdvancedNativeFocusOwner to provide custom API for setting focus.
* KeyToSelect: new utility class that allows selection with keyboard, similar to TapToSelect.
* KeyToTrigger: new utility class that allows trigger event with keyboard, similar to TapToTrigger.
* Label: added customTextRendererStyleName property.
* LayoutGroup: if component is root when initialized, defaults to AutoSizeMode.STAGE.
* List: added itemToItemRenderer() function, to get an item renderer for a specific item (if one is available).
* List: fixed issue where a runtime error could be thrown when the dataProvider property is null.
* NumericStepper: fixed issue where pressing increment or decrement button after editing TextInput would result in wrong value.
* OldFadeNewSlideTransitionManager: removed class. Use StackScreenNavigator with push and pop transitions instead, or find this class in feathers-compat.
* PickerList: itemToLabel() now strictly checks for null instead of a "truthy" value, and an empty string will have different behavior.
* PickerList: fixed issue where button label would not be updated when calling updateItemAt() on data provider with selected index.
* Scale3Image: removed class. Use starling.display.Image with scale9Grid.
* Scale3Textures: removed class. Use starling.display.Image with scale9Grid, or find this class in feathers-compat library.
* Scale9Image: removed class. Use starling.display.Image with scale9Grid.
* Scale9Textures: removed class. Use starling.display.Image with scale9Grid, or find this class in feathers-compat library.
* ScreenDensityScaleFactorManager: on desktop, screen density isn't used because native stage contentsScaleFactor has the proper behavior. However, it will DeviceCapabilities.dpi on desktop if the value has been customized.
* ScreenFadeTransitionManager: removed class. Use StackScreenNavigator with push and pop transitions instead, or find this class in feathers-compat.
* ScreenNavigator: fixed issue where an event with the same name as a member of the screen could result in a runtime error if as3-signals weren't available.
* ScreenSlidingStackTransitionManager: removed class. Use StackScreenNavigator with push and pop transitions instead, or find this class in feathers-compat.
* ScrollContainer: if component is root when initialized, defaults to AutoSizeMode.STAGE.
* ScrollContainer: fixed issue where includeInLayout could be ignored when not using a layout.
* Scroller: fixed issue where scrolling would still be active after removing from stage and adding again.
* Scroller: fixed issue where the page index calculation would fail if the width or height of the component were not an integer.
* Scroller: snapScrollPositionToPixels now accounts for contentScaleFactor so that pixel snapping is to view port dimensions instead of stage dimensions to make scrolling smoother.
* ScrollText: switched back default value for cacheAsBitmap to false because it seems to have started hurting performance again.
* Slider: TrackInteractionMode.TO_VALUE now allows dragging during TouchPhase.MOVED.
* SpinnerList: fixed issue where the selectionOverlaySkin could be resized incorrectly if the page size is larger than the list's dimensions.
* SpinnerList: can no longer be completely deselected if data provider is not empty.
* StackScreenNavigator: fixed issue where an event with the same name as a member of the screen could result in a runtime error if as3-signals weren't available.
* StackScreenNavigator: fixed runtime error in popAll() when root screen is visible.
* StackScreenNavigator: fixed issue where a new screen with the same ID as the active screen could not be shown.
* StackScreenNavigator: fixed issue where a new screen that has the same display object instance as the active screen would break navigation. The transition is now skipped.
* StageTextTextEditor: better measurement on desktop and when testing a mobile app in ADL to account for the internal TextField gutter. More consistent across all platforms.
* StageTextTextEditor: simplified font size calculation.
* StandardIcons: removed class that was deprecated. Use DefaultListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN to display a drill down accessory in an item renderer.
* StateValueSelector: removed class. Use ImageSkin, or find this class in feathers-compat library.
* StateToggleValueSelector: removed class. Use ImageSkin, or find this class in feathers-compat library.
* StyleProviderRegistry: added hasStyleProvider() and getRegistredClasses().
* TabBar: fixed issue where changing isEnabled in data provider to false and then true would not re-enable a tab.
* TabBar: added tabReleaser property that works similarly to tabInitializer, but for cleaning up a tab.
* TapToSelect: fixed issue where runtime error could be thrown if removed from stage between TouchPhase.BEGAN and TouchPhase.ENDED.
* TapToTrigger: fixed issue where runtime error could be thrown if removed from stage between TouchPhase.BEGAN and TouchPhase.ENDED.
* TextArea: added errorString property to display an error in a TextCallout when the component is focused.
* TextArea: added TextInputState.ERROR to allow skins to change appearance when the errorString is set.
* TextArea: states are defined in feathers.controls.TextInputState.
* TextArea: fixed issue where set focus on touch did not account for vertical scroll position.
* TextBlockTextRenderer: better calculation of ascent and descent to avoid the issue where accents and other diacritical marks were being cut off at the top. Also, results in better vertical centering of the text.
* TextBlockTextRenderer: optimized measurement of width by skipping calculations if maximum is larger than last width.
* TextBlockTextRenderer: added support for input method editors (IMEs) to improve compatibility with more languages.
* TextBlockTextRenderer: replaced snapToPixels property with pixelSnapping property to match Starling 2.0 naming convention.
* TextBlockTextRenderer: fixed issue where runtime error could be thrown when attempting to create BitmapData with negative dimensions.
* TextBlockTextRenderer: optimized performance of measurement calculation by avoiding unecessary alignment.
* TextCallout: new component that conveniently displays a message in a callout.
* TextFieldTextRenderer: replaced snapToPixels property with pixelSnapping property to match Starling 2.0 naming convention.
* TextFieldTextRenderer: fixed issue where last line could sometimes be cut off due to floating point rounding errors.
* TextInput: fixed issue where the position of the text editor when using VerticalAlign.MIDDLE was not rounded to the nearest pixel.
* TextInput: added errorString property to display an error in a TextCallout when the component is focused.
* TextInput: added TextInputState.ERROR to allow skins to change appearance when the errorString is set.
* TextInput: states are defined in feathers.controls.TextInputState.
* TextInput: fixed issue where some icons or skins would not be disposed when input is disposed.
* TextInput: fixed issue where focus in and out events sometimes weren't dispatched.
* TextInput: fixed issue where IBEAM mouse cursor would not always be cleared.
* TextInput: will show focused state when focused, but text editor cannot have focus.
* TiledImage: removed class. Use starling.display.Image with tileGrid.
* TimeLabel: fixed issue where displayed text was incorrectly when time is greater than one hour.
* ToggleButton: deprecated defaultSelectedLabelProperties, selectedUpLabelProperties, selectedHoverLabelProperties, selectedDownLabelProperties, selectedDisabledLabelProperties. Replaced by setting font styles on text renderer in labelFactory. Text renderers now support multiple font styles for different states.
* ToggleSwitch: labelAlign is deprecated and behaves as LABEL_ALIGN_MIDDLE now that baseline issue in TextBlockTextRenderer is fixed.
* TokenList: optimized value getter to avoid repeated calls to Vector join().
* ToolTipManager: added support for displaying tool tips on mouse hover. Must use desktop theme or opt-in using setEnabledForStage().
* ValidationQueue: optimized to avoid sorting queue of length is 1 because sorting allocates and object and will result in more frequent garbage collection.
* VerticalCenteredPopUpContentManager: added overlayFactory property to customize the modal overlay.
* VerticalLayout: fixed issue where percentWidth/percentHeight values greater than 100 were not clamped.
* VerticalSpinnerLayout: added repeatItems property that may be set to false to disable repeating items with infinite scrolling.
* VerticalSpinnerLayout: fixed issue where items could disappear when using gap property.
* VideoPlayer: fixed issue where runtime error was thrown when setting netConnectionFactory.
* VideoPlayer: improved support for streaming video from server.
* VideoPlayer: dispatches FeathersEventType.ERROR when NetStream.Play.NoSupportedTrackFound is dispatched by NetStream.

### 3.0.0 API Changes

Please see the [Feathers 3.0 Migration Guide](https://feathersui.com/help/migration-guide-3.0.html) for details about what has been deprecated or removed in Feathers 3.0.

## 2.3.0 - December 2015

* New Component: DateTimeSpinner combines a set of SpinnerList components to select the date, the time, or both.
* New Theme: TopcoatLightMobileTheme. Thank you to Marcel Piestansky for your contributions.
* List, GroupedList: added support for displaying more than one type of item renderer (plus multiple header and footer renderers on GroupedList).
* TapToTrigger, TapToSelect, and LongPress: new utility classes that make it easy to implement Event.TRIGGERED, Event.CHANGE, and FeathersEventType.LONG_PRESS on custom item renderers.
* TextureCache: utility class used to store textures loaded from URL by ImageLoader for quick reloading from memory instead of requesting URL again.
* Text: Support changing between multiple font styles when parent component changes state. Makes it easier to set font styles for button and item renderer states with strict compile-time type checking (instead of using downLabelProperties, hoverLabelProperties, etc).
* Alert: fixed issue where icon would not be positioned correctly when message needed to scroll.
* Alert: fixed issue where layout would not be updated after icon resized.
* BitmapFontTextRenderer: fixed issue where a line break could happen too early due to floating point inaccuracy.
* BitmapFontTextRenderer: added support for leading property on BitmapFontTextFormat to add extra space between lines. Thanks, matyasatfp!
* BottomDrawerPopUpContentManager: New IPopUpContentManager for PickerList that opens a drawer at the bottom of the stage.
* Button: added setSkinForState() and setIconForState() methods. Recommended instead of separate properties like downSkin and hoverSkin.
* Button: fixed issue where skin was positioned incorrectly when using scaleWhenDown. Thanks, zongjingyao!
* Button: added customLabelStyleName property.
* ToggleButton: fixed issue where the button could get stuck in a disabled state if selected and re-enabled.
* Button, ToggleButton, LayoutGroup, Scroller, TextInput, TextArea: ensures that all skins are disposed when disposing the parent component (some may not be on the display list at the time, so they need to be disposed manually).
* Button, Item Renderers: when skin, icon, or accessory is IStateObserver, sets the stateContext property.
* ButtonGroup: when distributeButtonSizes is false, and the direction is horizontal, will display buttons in multiple rows if they will not fit into one row.
* ButtonGroup: added support for passing the item from the data provider as an optional third parameter to event listeners added in the data provider.
* ButtonGroup: added support for listening to FeathersEventType.LONG_PRESS on buttons.
* ButtonGroup: added support for calling updateItemAt() and updateAll() on data provider.
* Callout: adjusts minimum and maximum dimensions of content instead of setting width and height directly, if possible, to allow resizing.
* DefaultFocusManager: fixed issue where focus could be restored to an object that was no longer on stage, causing a runtime error.
* DefaultFocusManager: fixed issue where a component added under a modal pop-up doesn't have a focus manager.
* DefaultListItemRenderer, DefaultGroupedListItemRenderer: added defaultAccessory property and setAccessoryForState() method. As long as itemHasAccessory property is false, accessory does not need to be set with data provider.
* DefaultGroupedListHeaderOrFooterRenderer: added customContentLabelStyleName.
* Drawers: added openMode property to control whether drawers are opened above or below the content. For backwards compatibility, defaults to below.
* Drawers: fixed issue where setting drawer to null while open would leave overlay skin visible, making it impossible to interact with the content.
* Drawers: fixed issue where opening or closing a drawer without animation wouldn't always work.
* Drawers: added support for dividers between docked drawers and content.
* FlowLayout: added firstHorizontalGap and lastHorizontalGap properties to allow a different gap after the first item and before the last item.
* FlowLayout: fixed contentWidth result from layout() when content is larger than view port.
* FlowLayout: fixed result from measureViewPort() when using multiple rows.
* FlowLayout, TiledRowsLayout, TiledColumnsLayout: fixed issue where the calculated view port dimensions were too large when using maxWidth/maxHeight and the rows or columns were smaller than the maximum dimensions.
* GroupedList, List: dispatches FeathersEventType.RENDERER_REMOVE for all item renderers on dispose.
* GroupedList: default layout now uses stickyHeader property of VerticalLayout.
* Header: extra padding for iOS status bar now supports 3x devices.
* Header: added customTitleStyleName property.
* HierarchicalCollection, ListCollection: added updateAll() method, similar to updateItemItem(), that tells the List that all items have been updated.
* HorizontalLayout, VerticalLayout: fixed issue where percentWidth and percentHeight values were ignored when measuring the typical item in a virtual layout.
* HorizontalSpinnerLayout, VerticalSpinnerLayout: fixed issue where a "renderer map contains bad data" runtime error could be thrown after duplicate indices were requested by getVisibleIndicesAtScrollPosition().
* IAsyncTheme: new interface available to themes that need to load assets asynchronously. Used by Feathers SDK to delay app initialization until the theme is ready.
* IGroupedLayout: new interface for layouts that support special modifiers for GroupedList, like headers that stick to the top.
* IGroupedListHeaderOrFooterRenderer: interface is deprecated, and it replaced by two separate interfaces, IGroupedListHeaderRenderer and IGroupedListFooterRenderer.
* IListItemRenderer, IGroupedListItemRenderer: added factoryID property that allows List to determine which item renderer factory was used to create the renderer.
* IStateContext, IStateObserver: new relationship between components that have state and sub-components that want to know their parent's state.
* ImageLoader: immediately stops loading when changing source property, instead of waiting for validation.
* Layouts: fixed issue where the wrong dimensions would be calculated when the layout contained zero items.
* LayoutGroup: fixed issue where background skin dimensions did not affect min dimensions of layout.
* LayoutGroup: fixed issue where removing a child in an Event.REMOVED_FROM_STAGE listener could cause the internal state to get out of sync with the display list.
* List: fixed issue where FeathersEventType.RENDERER_REMOVE would be dispatched for item renderers that were kept in memory to improve performance, but they didn't have an item, so the event would make no sense.
* PickerList: defaults to using BottomDrawerPopUpContentManager and SpinnerList on devices detected as phones.
* PickerList: defaults to DropDownPopUpContentManager on devices detected as desktop computers.
* PickerList: fixed issue where pop-up List may incorrectly create an item renderer for every item in the data provider before the list is opened.
* Scale3Image: removed duplicate code that had no effect.
* SeekSlider: added progressSkin property to display loading progress from media player.
* SoundPlayer: fixed issue where passing Sound instance to soundSource property would not update totalTime property and the sound would not play.
* SoundPlayer: added MediaPlayerEventType.METADATA_RECEIVED event for Sound Event.ID3.
* SoundPlayer, VideoPlayer: implement new IProgressiveMediaPlayer interface with bytesLoaded and bytesTotal properties.
* SoundPlayer: fixed issue where sound might not stop playing or might not be cleaned up properly on dispose.
* SpinnerList: fixed issue where setting data provider to same object would reset selection.
* SpinnerList: default layouts requested four rows instead of five because it will be more visually obvious that it can scroll because some items will be only partially visible
* StandardIcons: this class is considered deprecated because List now supports multiple item renderer factories. Drill down icon should be passed to item renderer during skinning.
* StackScreenNavigator: added stackCount property.
* StackScreenNavigator: added replaceScreen(), popAll(), and popToRootAndReplace() functions.
* StackScreenNavigatorItem: added setScreenIDForReplaceEvent() and clearReplaceEvent() methods and replaceEvents property.
* StackScreenNavigator, ScreenNavigator: fixed issue where loading new screen in a FeathersEventType.TRANSITION_COMPLETE listener could cause old screen to remain on display list.
* StageTextTextEditor: added support for FocusManager.
* TabBar: implements IFocusDisplayObject, and the selected tab may be changed with keyboard.
* TextArea: added customTextEditorStyleName property.
* Text Editors: added global style providers.
* Text Editors: fixed issue where calling clearFocus() on Android would remove focus, but keep the soft keyboard open.
* TextBlockTextEditor: fixed issue where selection skin could incorrectly appear outside bounds of TextInput.
* Text Renderers: added text styles for selected state.
* TextBlockTextRenderer, TextFieldTextRenderer: fixed issue where textures were uploaded too frequently with certain Starling scale factors.
* TextFieldTextRenderer: fixed issue where snapshot was not updated when Starling scale factor changes at runtime.
* TextInput: added isSelectable property, to go with isEditable property, to allow selection and editing to be controlled separately.
* TextInput: added customTextEditorStyleName and customPromptStyleName properties.
* TiledRowsLayout, TiledColumnsLayout: fixed issue where wrong number of rows or columns were calculated when using maxWidth or maxHeight.
* TiledRowsLayout, TiledColumnsLayout: fixed issues with measurement and item positioning when using requested row or column counts.
* ToggleButton: added toggleGroup property, similar to Radio, and implemented IGroupedToggle interface.
* ToggleButton: added some missing constants inherited from Button.
* ToggleSwitch: added customOnLabelStyleName and customOffLabelStyleName.
* Todos: Example updated with modernized coding practices and changed design a bit.
* ValidationQueue: uses Vector insertAt() when available in runtime to improve performance by avoiding extra garbage collection.
* VideoPlayer: added netConnectionFactory to allow creation of NetConnection and the call to connect() to be customized.
* VideoPlayer: added MediaPlayerEventType.METADATA_RECEIVED event for NetStream onMetaData callback.
* VideoPlayer: fixed issue where Event.COMPLETE was not dispatched on iOS because NetStream.Play.Complete event was not dispatched on this platform only.
* VideoPlayer: fixed issue where restoring context would cause video to start playing if paused before context was lost.
* VideoPlayer: fixed issue where only audio would play on iOS if played a second time.
* VideoPlayer: fixed issue where video might not stop playing or might not be cleaned up properly on dispose.
* VideoPlayer: dispatches FeathersEventType.CLEAR when texture is disposed, similar to Event.READY when texture is ready to be rendered. ImageLoader should clear its source when this is dispatched.
* More than doubled the number of unit tests!

### 2.3.0 Deprecated APIs

All deprecated APIs are subject to the [Feathers deprecation policy](https://feathersui.com/help/deprecation-policy.html). Please migrate to the new APIs as soon as possible because the deprecated APIs **will** be removed in a future version of Feathers.

The `StandardIcons` class is deprecated. It was used to provide a drill-down icon for item renderers, but since lists now support multiple item renderer types, it is no longer needed. Additionally, the `StandardIcons` didn't work properly with multiple Starling instances, so it was ultimately a poor design choice.

The `IGroupedListHeaderOrFooterRenderer` interface is deprecated. The `GroupedList` component used this interface, but it now supports separate `IGroupedListHeaderRenderer` and `IGroupedListFooterRenderer` interfaces.

The `FeathersEventType.ERROR` constant was originally deprecated in Feathers 2.2.0 and remains deprecated in Feathers 2.3. The `ImageLoader` component used this constant, and it now dispatches separate `Event.IO_ERROR` and `Event.SECURITY_ERROR` events.

All properties and constants where "name" was replaced by "style name" were originally deprecated in Feathers 2.1.0, and they have now been removed. 

* `custom*Name` => `custom*StyleName`
* `DEFAULT_CHILD_NAME_*` => `DEFAULT_CHILD_STYLE_NAME_*`
* `ALTERNATE_NAME_*` => `ALTERNATE_STYLE_NAME_*`
* `itemRendererName` => `customItemRendererStyleName`
* `firstItemRendererName` => `customFirstItemRendererStyleName`
* `lastItemRendererName` => `customFirstItemRendererStyleName`
* `singleItemRendererName` => `customSingleItemRendererStyleName`
* `headerRendererName` => `customHeaderRendererStyleName`
* `footerRendererName` => `customFooterRendererStyleName`

## 2.2.0 - August 2015

* New Component: SoundPlayer. Plays audio using a Sound object.
* New Component: VideoPlayer. Plays video using a NetStream object.
* New Layout: Flow. Displays items of differing dimensions in multiple rows.
* New Layout: WaterfallLayout. Displays items optimally in columns of equal width.
* New Layout: HorizontalSpinnerLayout. Similar to VerticalSpinnerLayout, but displays items in a horizontal row.
* New Transition: Iris. Scales a circular mask to animate between two screens.
* New Transition: Wipe. Resizes a clipRect to animate between two screens.
* New Example: Video. A desktop AIR app that can play videos from the file system.
* AddOnFunctionStyleProvider: added callBeforeOriginalStyleProvider property to allow the add-on function to be called first.
* Alert: added customMessageStyleName property.
* BitmapFontTextEditor, TextBlockTextEditor: fixed an issue where they didn't accept non-Latin characters and ignored characters when Alt key was pressed.
* BitmapFontTextEditor, TextBlockTextEditor: uses needsSoftKeyboard and requestSoftKeyboard() to show soft keyboard on Android. Vote on [Adobe Bug #3962712](https://bugbase.adobe.com/index.cfm?event=bug&id=3962712) to add iOS support.
* BitmapFontTextEditor, TextBlockTextEditor: fixed issue where the selection anchor index wasn't properly updated, making the keyboard selection change on the wrong side.
* BitmapFontTextEditor, TextBlockTextEditor: fixed issue where setting TextInput's parent visible property to false wouldn't clear focus.
* BitmapFontTextEditor, TextBlockTextEditor: fixed an issue where pasting something other than text would cause a runtime error.
* BitmapFontTextEditor, TextBlockTextEditor: fixed an issue where changing the text property in an Event.CHANGE listener could cause the cursorSkin to be positioned incorrectly.
* Button: fixed issue where the label text renderer wasn't given an maxHeight that accounted for the button's height and padding.
* ColorFade: fixed name of createBlackFadeTransition().
* Default Item Renderers: fixed issue where children above or below label text renderer couldn't sometimes affect the label's width.
* DropDownPopUpContentManager: fixed issue where pop-up wasn't repositioned if the source moved to a new location.
* DropDownPopUpContentManager: added primaryDirection property to support trying to display the pop-up above the source first, instead of below.
* DropDownPopUpContentManager: added fitContentMinWidthToOrigin property to allow the content to be smaller than the origin.
* DropDownPopUpContentManager: fixed horizontal position of pop-up above origin.
* DropDownPopUpContentManager: fixed issues caused by multiple Starling instances.
* DropDownPopUpContentManager: added isModal and overlayFactory properties to affect how pop-up is displayed.
* FeathersControl: fixed issue where initialize() could be called during initialization.
* FocusManager: added support for new INativeFocusOwner interface, which allows components to be associated with a specific focusable native display object (like text editors!).
* GroupedList: the itemIndex parameter on scrollToDisplayIndex() is now optional so that you can scroll to a group header.
* Header: fixed issue where useExtraPaddingForOSStatusBar property didn't account for contentScaleFactor.
* HorizontalLayout, VerticalLayout: fixed issue where a scrollToDisplayIndex() on a List wouldn't work.
* HorizontalLayout, VerticalLayout: fixed issue where center/middle alignment wasn't properly ignored if total content size was larger than the container bounds (thanks kavolorn!)
* HorizontalLayout, VerticalLayout: fixed issue with alignment when scrolling is required in perpendicular direction.
* HorizontalLayout: fixed issue where items weren't measured correctly sometimes when using percentage dimensions.
* ImageLoader: now accounts for minimum and maximum dimensions when maintaining aspect ratio.
* ImageLoader: now dispatches separate Event.IO_ERROR and Event.SECURITY_ERROR constants instead of FeathersEventType.ERROR.
* ImageLoader: fixed issue where appending variable to ATF URL would break the check for the file extension.
* ImageLoader: added scaleContent, horizontalAlign, and verticalAlign properties.
* ImageLoader: added scaleMode property that uses values from starling.utils.ScaleMode.
* LayoutGroup: fixed issue where the background skin wasn't clipped by the clipRect.
* MultiStarlingStyleNameFunctionTheme: a variation of StyleNameFunctionTheme that supports multiple Starling instances.
* LayoutGroup, Scroller (and subclasses), ScreenNavigator, StackScreenNavigator: setting clipContent to false will clear the clipRect only once so that clipRect may be used externally.
* LayoutGroupListItemRenderer, LayoutGroupGroupedListItemRenderer: fixed issue where changing the data would hurt performance because the item renderer would need to validate more than once.
* List: sometimes keeps around an extra item renderer to avoid garbage collection and improve performance. When the typical item is from the data provider, the number of renderered items would fluctuate when scrolling.
* NumericStepper: fixed issue where selection might be changed in TextInput when using arrow keys to step.
* Panel: fixed issue where autoSizeMode property was ignored.
* PopUpManager: fixed issue where adding a pop-up that already had a parent would cause the Event.REMOVED_FROM_STAGE listener to be called early.
* ProgressBar, Slider: fixed issue where the layout would be broken if the minimum equals the maximum.
* RenderDelegate: a display object that passes rendering to another display object that has its own transformations. Useful for custom transitions.
* Scroller: fixed issue where scrollToPageIndex() would not accept negative page indicies.
* Scroller: fixed issue where the container didn't detect major changes to the maximum scroll position, causing it to scroll far beyond the end of the content.
* Scroller: added SCROLL_BAR_DISPLAY_MODE_FIXED_FLOAT to allow the scroll bar floats above the content, but it won't fade out.
* Scroller: fixed issue where INTERACTION_MODE_TOUCH_AND_SCROLL_BARS didn't work in nested scrollers because scroll bars could overlap and stop touches even when scrolling was not possible.
* Scroller: fixed issue where touching the scroll bar thumb wouldn't stop a throw.
* Scroller: fixed issue where a floating scroll bar would be hidden after hover out instead of waiting for the throw animation to finish.
* Scroller: fixed issue where clipping was no properly updated when using INTERACTION_MODE_MOUSE and the view port was resized small enough that scrolling was no longer needed.
* Scroller: fixed issue where Scroller couldn't properly calculate its dimensions when it has a background skin but no view port content, causing an infinite loop.
* Scroller: fixed issue where floating point errors sometimes caused it to snap to the wrong page.
* Scroller: fixed issue where maximum page indices might be one larger than they should be if a floating point error occurs.
* Scroller: snapScrollPositionToPixels now defaults to true.
* Scroller: switched to a different throwEase that is more natural.
* ScrollBar, SimpleScrollBar, Slider: on initialize, clamps value to minimum and maximum because value may not have been set, and it may be outside the range.
* ScrollContainer: fixed issue where getRawChildIndex() didn't reset the displayListBypassEnabled flag before returning the result.
* ScrollContainer: fixed issue where view port resizing wasn't ignored when using AUTO_SIZE_MODE_STAGE, potentially hurting performance.
* ScrollText: uses cacheAsBitmap to improve scrolling performance. A property has been exposed to disable this, if desired.
* ScreenDensityScaleFactorManager: manages the Starling view port and stage dimensions to automatically generate an appropriate contentScaleFactor value based on the screen DPI.
* ScrollContainer: fixed issue where addChild() stopped working with Starling 1.7.
* Slider: thumb position is now rounded to the nearest pixel.
* Slider: added thumbOffset property to allow the thumb to be repositioned in the direction perpendicular to the track.
* SpinnerList: by default, the scroll bar is hidden.
* StackScreenNavigator: fixed issue where setting rootScreenID before screens were added could throw a runtime error.
* StageTextTextEditor: fixed issue where text color wouldn't change when disabled while StageText didn't have focus.
* StageTextTextEditor: fixed an issue where where the text editor would try to change the font size property every frame, but it wasn't rounding to an integer, causing the check to fail.
* StageTextTextEditor, TextFieldTextEditor: improved positioning of StageText or TextField overlay when added to Sprite3D.
* StyleNameFunctionTheme: added a createRegistry() function that can be overridden in a subclass to customize the style provider registry.
* TabBar: now supports isEnabled in data provider, similar to ButtonGroup.
* TextArea, TextInput: fixed issue where the backgroundFocusedSkin wasn't displayed when the FocusManager was disabled (thanks tcfraser!)
* TextArea: fixed issue where setting the height of the TextArea larger than the text may result in the TextArea not receiving focus.
* TextBlockTextRenderer, TextFieldTextRenderer: fixed issue where the texture would sometimes restore with the wrong font size and clipping.
* TextBlockTextRenderer, TextFieldTextRenderer: fixed issue where snapshot dimensions were rounded down to the nearest pixel, which could cut off a small part of the text.
* TextBlockTextRenderer, TextFieldTextRenderer: uses Texture.empty() and uploads BitmapData manually instead of Texture.fromBitmapData() to avoid the creation of an onRestore function that will be immediately replaced.
* TextBlockTextRenderer, TextFieldTextRenderer: fixed issue where the texture snapshot could be blurry when scaled up from 0.
* Text Renderers: added updateSnapshotOnScaleChange property to allow the snapshot to always be crisp, even when scaled up or down. Use with caution as it needs to check the scale every frame.
* TextBlockTextRenderer: fixed issue where texture snapshot remained visible when the text renderer's width or height was supposed to be 0.
* TextBlockTextRenderer: fixed issue where the cursorSkin wasn't properly positioned and sized when calling setFocus() manually.
* TextBlockTextEditor: fixed an issue where scrolling wasn't working properly on HiDPI displays.
* TextFieldTextEditor: fixed issue where the font displayed at the wrong scale the first time that the text editor received focus on some mobile devices.
* TextFieldTextEditor: fixed issue where accessing the baseline property might throw a runtime error because textSnapshot was null.
* TextFieldTextEditor: exposed some more TextField property that control rendering.
* TextFieldTextRenderer: added useSnapshotDelayWorkaround property and disabled this workaround by default.
* Text Editors: detects changes in contentScaleFactor (such as when switching between HiDPI and normal screens) and recreates snapshots.
* TextInput: can now receive focus when isEditable is false.
* TiledRowsLayout, TiledColumnsCount: The requestedColumnCount property may now be used to calculate an ideal width for that number of columns, if the container doesn't have an explicitWidth. (TiledColumnsLayout uses the requestedRowCount property).
* ValidationQueue: skips components in queue that are no longer on the display list.
* ValidationQueue: will not proceed if Starling's context is invalid. This may happen if a TouchEvent.TOUCH listener causes a lost context.
* VerticalSpinnerLayout: fixed issue where item heights weren't forced to the same size, which could cause large gaps or overlapping items.
* WebView: added missing FeathersEventType.LOCATION_CHANGE constant for event.
* YouTubeFeeds: example updated to use newer YouTube API since the old one was shut down.
* Transitions: changed some to use RenderDelegate to avoid removing screens from display list.
* Examples: use Context3DProfile.BASELINE for mobile examples, since it is widely supported on mobile.
* Examples: enabled supportHighResolution flag for mobile apps so that they look better on HiDPI screens. This has no effect on a real mobile device. It just improves the development experience.
* Themes: when disposing, unregisters bitmap fonts, clears texture onRestore function, and clears StandardIcons class.
* Themes: desktop themes now use HiDPI textures.

### 2.2.0 Deprecated APIs

All deprecated APIs are subject to the [Feathers deprecation policy](https://feathersui.com/help/deprecation-policy.html). Please migrate to the new APIs as soon as possible because the deprecated APIs **will** be removed in a future version of Feathers.

The `FeathersEventType.ERROR` constant is deprecated. The `ImageLoader` component used this constant, and it now dispatches separate `Event.IO_ERROR` and `Event.SECURITY_ERROR` events. Error events should always be specific.

The `nameList` property on the `IFeathersControl` interface was originally deprecated in Feathers 2.0.0, and it has now been removed. It is replaced by the `styleNameList` property.

The `manageVisibility` property on layouts was originally deprecated in Feathers 2.0.0, and it has now been removed. This property no longer provided the performance improvements that it was originally intended for.

Properties such as `customThumbName` on the `Slider` component have have been renamed. In this case, `customThumbName` is deprecated and replaced by `customThumbStyleName`. Similarly, the static constant `Slider.DEFAULT_CHILD_NAME_THUMB` has been deprecated and renamed `Slider.DEFAULT_CHILD_STYLE_NAME_THUMB`. Similarly, the static constant `Button.ALTERNATE_NAME_BACK_BUTTON` has been deprecated and renamed `Button.ALTERNATE_STYLE_NAME_BACK_BUTTON`. On all components, APIs that refer to the *name* of sub-components have been deprecated and they have been replaced by a similar API that refers to the *style name* instead. For brevity, the list below shows the mapping between the old naming conventions and the new naming conventions instead of listing each renamed property individually.

* `custom*Name` => `custom*StyleName`
* `DEFAULT_CHILD_NAME_*` => `DEFAULT_CHILD_STYLE_NAME_*`
* `ALTERNATE_NAME_*` => `ALTERNATE_STYLE_NAME_*`

The `List` and `GroupedList` components had some properties that didn't follow the original `custom*Name` naming convention. In both classes, the `itemRendererName` property has been deprecated and replaced by `customItemRendererStyleName`. In `GroupedList`, `firstItemRendererName`, `lastItemRendererName` and `singleItemRendererName` have been deprecated and replaced by `customFirstItemRendererStyleName`, `customLastItemRendererStyleName`, and `customSingleItemRendererStyleName` respectively. Similarly, `headerRendererName` and `footerRendererName` have been deprecated and replaced by `customHeaderRendererStyleName` and `customFooterRendererStyleName` respectively. With this change, these properties no longer diverge from the naming convention used for similar properties on other components.

All of the above renamed APIs were deprecated in Feathers 2.1.0, and they remain deprecated in Feathers 2.2.0.

### 2.2.0 API Changes

The `scrollToPageIndex()` function in the `Scroller` class, and its subclasses, no longer accepts `-1` as a valid way of specifying that the horizontal or vertical page index should not change. You must pass in the current value of the `horizontalPageIndex` or `verticalPageIndex` property instead. With the ability to have negative page indices, `-1` must now be available as a valid page index.

In the following code, the vertical page index is not meant to be changed:

```
list.scrollToPageIndex( 2, -1 );
```

The code would need to be modified, like this:

```
list.scrollToPageIndex( 2, list.verticalPageIndex );
```

## 2.1.2 - July 2015

* ScrollContainer: overrides addChild() to fix "RangeError: Invalid child index" issue when using Starling 1.7.

## 2.1.1 - March 2015

* BitmapFontTextRenderer, ScrollContainer: added workarounds for compiler bugs in Adobe Flex SDK 4.6.
* ButtonGroup, TabBar: fixed issue where buttons or tabs would flicker and resize for a frame when the container resizes.
* HorizontalLayout, VerticalLayout: fixed an issue that resulted in no scrolling when the scrollToDisplayIndex() function is called on a List.
* ScrollContainer: fixed issue where setting autoSizeMode to AUTO_SIZE_MODE_STAGE resulted in being unable to scroll.
* SpinnerList: fixed issue where setting the selected index programmatically didn't always update the scroll position.
* TextBlockTextRenderer, TextFieldTextRenderer: fixed issue where text would appear blurry because snapToPixels incorrectly snapped on the y-axis.

## 2.1.0 - February 2015

* New Component: AutoComplete, a TextInput that provides a pop-up list of suggestions.
* New Component: SpinnerList, a list that changes selection when scrolling to an item.
* New Component: StackScreenNavigator, a variation of ScreenNavigator with a history stack that you can push and pop.
* New Component: WebView, displays a native web browser using StageWebView, but may be positioned in local coordinates. Available in AIR only.
* New Layout: VerticalSpinnerLayout, the default layout for the new SpinnerList component.
* New Transitions: ColorFade, Cover, Cube, Fade, Flip, Reveal, Slide.
* New Example: TransitionsExplorer demonstrates each transition.
* Unit tests: created unit tests for a number of Feathers components.
* Help: help files are now distributed with Feathers for offline use.
* AnchorLayout: fixed issue where items positioned relative to horizontalCenterAnchorDisplayObject or verticalCenterAnchorDisplayObject were not positioned correctly whent he anchor was at a higher depth.
* Button: added scaleWhenDown and scaleWhenHovering properties to scale the button in these states.
* BaseDefaultItemRenderer: fixed issue where data that is == null would be ignored in some cases by changing to stricter === null check.
* BitmapFontTextRenderer: fixed issue where a runtime error could be thrown if a character in the bitmap font had a width or height of 0.
* BitmapFontTextEditor, TextBlockTextEditor: fixed issue where clearing the text on focus would cause the selection range to be invalid.
* BitmapFontTextEditor, TextBlockTextEditor: listens for flash.events.Event.SELECT_ALL instead of Ctrl/Command+A with a keyboard event because it didn't work properly on Mac.
* BitmapFontTextRenderer: fixed issue where the last word of a line would sometimes appear on the next line.
* CalloutPopUpContentManager, DropDownPopUpContentManager, VerticalCenteredPopUpContentManager: detects if pop-up is removed from stage externally so that Event.CLOSE is properly dispatched.
* DropDownPopUpContentManager: fixed issue where the source would close the pop-up while validating, but the pop-up was being positioned, causing a runtime error, so now checks if open after source is validated.
* FeathersControl: added move() convenience function to set x and y properties, similar to how setSize() sets width and height.
* FeathersControl: the styleProvider property may be changed after initialization.
* FeathersControl: changes to styleNameList after initialization now causes the styleProvider to be re-applied.
* FeathersControl: may now flatten even when not initialized or on stage.
* FEATHERS_VERSION: new constant that can be used to see the version of Feathers being used.
* FocusManager: both containers and their children may receive focus separately (to allow the container to scroll with the keyboard), thanks to the new IFocusContainer interface.
* HierarchicalCollection: added removeAll() function, similar to ListCollection.
* HorizontalLayout, VerticalLayout: when alignment is justified, the size of the item renderer is reset so that an accurate measurement can be taken instead of using the old justified size.
* HorizontalLayout: added requestColumnCount property for more control over width auto-measurement.
* HorizontalLayout, VerticalLayout: fixed issue where the number of item renderers didn't remain constant when using hasVariableItemDimensions when all item renderers were the same size.
* ILayout: added getNearestScrollPositionForIndex() function to support scrolling when changing selected index in components like List.
* Label: added backgroundSkin, backgroundDisabledSkin, and padding properties.
* LayoutGroup: added LayoutGroup.ALTERNATE_STYLE_NAME_TOOLBAR.
* LayoutGroup: added autoSizeMode property to specify that it should fill the stage.
* List, GroupedList: fixed issue where scrolling backwards would sometimes cause item renderers to jump around instead of scrolling smoothly with a virtual layout with variable item dimensions where an item resized. Layout may adjust scroll position, if needed.
* List, GroupedList: updates scroll position, if needed, when using arrow keys to change selection.
* List, GroupedList: dispatches Event.TRIGGERED when an item renderer is triggered. The event data is the item from the data provider.
* List, GroupedList: added stricter === null check when checking if a typicalItem has been set because values like 0 could match == null.
* List, GroupedList: fixed issue where layout didn't update after an item renderer resized while the list wasn't validating.
* List, GroupedList: fixed issue where the typical item renderer resized, but the layout wasn't updated.
* List, GroupedList: fixed issue where changing the index of a typical item chosen from the data provider would not update the index of its item renderer.
* ListCollection: setting data property to null keeps null instead of removing all items from existing data.
* NumericStepper: added valueFormatFunction and valueParseFunction properties to support custom formatting.
* Panel: added new title and headerTitleField properties to use instead of going through headerProperties.
* Panel: fixed issue where outerPaddingBottom was ignored if the panel didn't have a footer.
* PanelScreen: added missing DEFAULT_CHILD_STYLE_NAME_FOOTER constant for use in themes.
* PickerList: dispatches Event.OPEN and Event.CLOSE when the pop-up list opens and closes.
* PickerList, TabBar: fixes issue where Event.CHANGE was incorrectly dispatched on disposal because dataProvider was set to null.
* Scale3Textures, Scale9Textures: fixed validation of region sizes when using a scaled texture that doesn't match Starling.contentScaleFactor.
* ScreenNavigator: fixes issue where new screen wasn't resized properly by validating self if validation queue is currently busy.
* ScreenNavigator: adds a delay of two frames before starting a transition animation because it significantly improves the performance of the transition.
* ScreenNavigator: added isTransition active property to indicate if a transition is currently in progress.
* ScreenNavigator: fixed issue where clearing a screen didn't dispatch FeathersEventType.TRANSITION_START.
* ScreenNavigator: added support for transitions that may cancel themselves.
* ScreenNavigator: added optional transition function argument to showScreen() and clearScreen().
* ScreenNavigator: fixes issue where active screen wasn't properly cleared if removed with removeScreen() or removeAllScreens().
* ScreenNavigator: dispatches FeathersEventType.TRANSITION_IN_START, FeathersEventType.TRANSITION_IN_COMPLETE, FeathersEventType.TRANSITION_OUT_START, and FeathersEventType.TRANSITION_OUT_COMPLETE on screens (not on self). Screens may listen for these events instead of the events dispatched by ScreenNavigator.
* ScreenNavigatorItem: added setFunctionForEvent() and setScreenIDForEvent().
* ScreenNavigatorItem: The properties getter will always be a valid object. It won't return null.
* ScrollBar: hides thumb when ranging is infinite.
* ScrollBar: sets touchable to false on tracks when range is 0 or infinite.
* Scroller: performance improvements from less garbage collection.
* Scroller: added support for scrolling horizontally with vertical scroll wheel.
* Scroller: can receive focus to control scroll position with keyboard.
* Scroller: fixed issue where snapToPages was ignored when using mouse wheel or throwing.
* Scroller: fixed issue where animation for elastic snapping would restart on every touch when the distance was less than 1 pixel, causing it to appear that the item renderers could not be touched.
* ScrollContainer: added autoSizeMode property to specify that it should fill the stage.
* ScrollContainer: fixed issue where outer container didn't invalidate when adding or removing children, or when children are resized, causing validate() to have no effect.
* StageTextTextEditor, TextFieldTextEditor: fixes issue where focus remained when parent was set invisible.
* StyleNameFunctionTheme: the getStyleProviderForClass() function is now public.
* TabBar, ToggleGroup, List, GroupedList, PickerList: fixed issue where Event.CHANGE was not dispatched when removing an item and the selectedIndex remains the same, but the selectedItem is different.
* TabBar: default selectedIndex is -1 until the data provider is set.
* TabBar: Event.CHANGE is dispatched immediately when selectedIndex property changes instead of waiting for validation. Makes it more consistent with other components, like List.
* TextFieldTextEditor: fixed issue where HTML formatting is lost if edited when isHTML is true.
* TextFieldTextEditor: fixed issue where snapshot wasn't updated when size changed, but data or styles did not.
* TextFieldTextEditorViewPort: added padding properties.
* TextFieldTextEditorViewPort: fixed issue where the selection index was wrong from touch.
* TextFieldTextRenderer, TextBlockTextRenderer: fixed issue where native filters could cause the text renderer to create a texture that is larger than the maximum dimensions allowed.
* TextFieldTextRenderer, TextBlockTextRenderer: fixed issue where only the first texture (if multiple textures were required) was positioned properly when using native filters.
* TextFieldTextRenderer, TextBlockTextRenderer: fixed issue where texture snapshots could be clipped too small when using native filters.
* VerticalLayout: added requestRowCount property for more control over height auto-measurement.

### 2.1.0 Deprecated APIs

All deprecated APIs are subject to the [Feathers deprecation policy](https://feathersui.com/help/deprecation-policy.html). Please migrate to the new APIs as soon as possible because the deprecated APIs **will** be removed in a future version of Feathers.

The `nameList` property on the `IFeathersControl` interface has been deprecated, and it is replaced by the `styleNameList` property. The `name` property is no longer connected to style names, and situations where it failed to work with `getChildByName()` have been resolved. The `styleName` property has been added to replace the former usage of the `name` property as a concatenated version of `nameList` (now, `styleNameList`). The `nameList` property was deprecated in Feathers 2.0.0, and it remains deprecated in Feathers 2.1.0.

The `manageVisibility` property on layouts has been deprecated. In previous versions, this property could be used to improve performance of non-virtual layouts by hiding items that were outside the view port. However, other performance improvements have made it so that setting `manageVisibility` can now sometimes hurt performance instead of improving it. The `manageVisibility` property was deprecated in Feathers 2.0.0, and it remains deprecated in Feathers 2.1.0.

Similar to how the `nameList` property was renamed `styleNameList` in Feathers 2.0.0, properties such as `customThumbName` on the `Slider` component have have been renamed too. In this case, `customThumbName` is deprecated and replaced by `customThumbStyleName`. Similarly, the static constant `Slider.DEFAULT_CHILD_NAME_THUMB` has been deprecated and renamed `Slider.DEFAULT_CHILD_STYLE_NAME_THUMB`. Similarly, the static constant `Button.ALTERNATE_NAME_BACK_BUTTON` has been deprecated and renamed `Button.ALTERNATE_STYLE_NAME_BACK_BUTTON`. On all components, APIs that refer to the *name* of sub-components have been deprecated and they have been replaced by a similar API that refers to the *style name* instead. For brevity, the list below shows the mapping between the old naming conventions and the new naming conventions instead of listing each renamed property individually.

* `custom*Name` => `custom*StyleName`
* `DEFAULT_CHILD_NAME_*` => `DEFAULT_CHILD_STYLE_NAME_*`
* `ALTERNATE_NAME_*` => `ALTERNATE_STYLE_NAME_*`

The `List` and `GroupedList` components had some properties that didn't follow the original `custom*Name` naming convention. In both classes, the `itemRendererName` property has been deprecated and replaced by `customItemRendererStyleName`. In `GroupedList`, `firstItemRendererName`, `lastItemRendererName` and `singleItemRendererName` have been deprecated and replaced by `customFirstItemRendererStyleName`, `customLastItemRendererStyleName`, and `customSingleItemRendererStyleName` respectively. Similarly, `headerRendererName` and `footerRendererName` have been deprecated and replaced by `customHeaderRendererStyleName` and `customFooterRendererStyleName` respectively. With this change, these properties no longer diverge from the naming convention used for similar properties on other components.

### 2.1.0 API Changes

#### ILayout

The `getNearestScrollPositionForIndex()` method has been added to the `ILayout` interface. Custom implementations of `ILayout` created before Feathers 2.1.0 will have compiler errors until the required changes are made.

This method is meant to calculate an updated scroll position for a specific index that requires the minimum amount of scrolling to fully display the specified index within the container's view port. It was added so that components like `List` could update the scroll position when changing the selected index with the keyboard when the component has focus.

To maintain the existing behavior (where the container doesn't scroll at all) to simply bypass the compiler error, the following implementation will return the existing scroll position:

	public function getNearestScrollPositionForIndex(index:int, scrollX:Number, scrollY:Number, items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
	{
		if(!result)
		{
			return new Point(scrollX, scrollY);
		}
		result.setTo(scrollX, scrollY);
		return result;
	}

#### Scroller now implements IFocusDisplayObject

With the addition of the new `IFocusContainer` interface, it is now possible for a container and its children to both appear in the tab focus chain when the `FocusManager` is enabled. Previously, subclasses of `Scroller`, like `List` or `ScrollContainer`, could not receive focus to allow the user to control the scroll position with the keyboard because the children wouldn't be able to receive focus too. Now, with the new interface and an updated focus manager, that restriction is lifted, and `Scroller` implements `IFocusDisplayObject` to support keyboard scrolling.

Subclasses of `Scroller` that need to support passing focus to children must now implement `IFocusContainer`. `List`, `ScrollContainer`, `GroupedList` have been updated, obviously, but custom subclasses of `Scroller` may need to be updated to support focus. `IFocusContainer` requires one property, `isChildFocusEnabled`. For convenience, you may copy following implementation of `isChildFocusEnabled` into a subclass of `Scroller`:

	protected var _isChildFocusEnabled:Boolean = true;

	public function get isChildFocusEnabled():Boolean
	{
		return this._isEnabled && this._isChildFocusEnabled;
	}

	public function set isChildFocusEnabled(value:Boolean):void
	{
		this._isChildFocusEnabled = value;
	}

## 2.0.1 - November 2014

* AddOnFunctionStyleProvider: fixed issue where function passed into constructor would be ignored.
* LayoutGroup: fixed issue where background skin would not validate after setting its dimensions.
* Scale3Image, Scale9Image, TiledImage: updated to listen for Event.FLATTEN to validate instead of overriding flatten() to remain compatible with the new flatten() function signature in Starling 1.6.
* StageTextTextEditor: fixed issue where StageText.stage was null, and calling drawViewPortToBitmapData() resulted in a runtime error.
* StageTextTextEditor: fixed issue where setFocus() didn't work if StageText.stage was null.
* TextInput: fixed issue where runtime error would be thrown after changing prompt from null to a valid string after input had validated.
* Themes: fixed issue in desktop themes where assets displayed at 4x instead of 2x on HiDPI Macs.
* Themes: fixed issue in desktop themes where PanelScreen and ScrollScreen would incorrectly use mobile scroll bars and behaviors.
* Themes: fixed issue where a subclass would add a style function for the ToggleSwitch class, and that would cause some ToggleSwitch instances to be missing skins.
* Themes: fixed issue where wrong arguments were passed to Texture.fromBitmap().
* Added workarounds for stack overflow runtime errors when compiling with legacy Flex 4.6 compiler.

## 2.0.0 - October 2014

* New style provider architecture for skinning and themes.
* Components may always be validated, even if they are not on the display list yet.
* New Text Editor: TextBlockTextEditor is a desktop-only text editor built on FTE, similar to TextBlockTextRenderer.
* New Text Editor: BitmapFontTextEditor is a desktop-only text editor built on bitmap fonts, similar to BitmapFontTextRenderer.
* All Components: subComponentProperties pattern is now stricter. If properties that don't exist are set, a runtime error will be thrown.
* BitmapFontTextRenderer: properly redraws when isEnabled is changed.
* BitmapFontTextRenderer: if textFormat is null, generates a default value so that something will be displayed (using Starling's embedded BitmapFont.MINI).
* Button: added minGap property that is used when gap is set to Number.POSITIVE_INFINITY.
* Button: pulled out toggle functionality into a subclass: ToggleButton.
* Button: removed now-useless autoFlatten property.
* Button: added new hasLabelTextRenderer that may be set to false to avoid creating the text renderer (for things like scroll bar or slider button sub-components).
* Button: fixed issue where button didn't return to up state when focus is changed with keyboard while in another state.
* Callout: added stagePadding property to set stagePaddingTop, stagePaddingRight, stagePaddingBottom, and stagePaddingLeft properties all at once.
* Callout: fixed issue where touch listener was removed when callout was removed, but it wasn't re-added when the same callout instance was shown again.
* DefaultGroupedListHeaderOrFooterRenderer: fixed issue where content wasn't disabled when isEnabled changed.
* Drawers: added optional overlaySkin property to fade in a display object over the content when a drawer is opened.
* Drawers: checks if event types are null before adding listeners.
* Drawers: open and close events now pass the display object in the event data.
* Drawers: fix for issue where wrong toggle duration may used sometimes.
* DropDownPopUpContentManager: added new gap property.
* FeathersControl: enforced as an abstract class. If you need a generic Feathers component wrapper for layoutData and things, use LayoutGroup.
* FeathersControl: added styleName and styleNameList property to replace nameList. The name property is no longer used for styling, and it will work for getChildByName() in the rare situations where it was broken. The nameList property is deprecated.
* FeathersControl: fixed issue where changing minTouchWidth or minTouchHeight did not update the hit area if the width or height wasn't changed at the same time.
* FeathersControl: fixed issue where component would validate when disposed.
* FeathersControl: fixed issue in setSize() where scaled dimensions weren't updated.
* FocusManager: support for custom IFocusManager instances and support for multiple Starling stages.
* FocusManager: fixed issue where disabled components could receive focus.
* Header: added useExtraPaddingForOSStatusBar property to support iOS 7 status bar behavior.
* Header: getters for leftItems, rightItems, and centerItems no longer duplicate the array.
* Header: now disposed leftItems, rightItems, and centerItems by default. Can be controlled with new disposeItems property.
* Header: fixed issue where title text renderer's isEnabled property wasn't properly updated.
* Header: fixed issue where the touchable property was incorrectly set to false on some children.
* IFocusDisplayObject: added new focusOwner property to allow pop-ups to be owned by another component. Allows the focus manager to manage focus order better with components like PickerList.
* ImageLoader: checks for lost context before creating a texture from a loaded URL.
* ImageLoader: fixed issue where isLoaded getter didn't always return true if the source is a texture.
* ImageLoader: fixed issue where loaded textures could be uploaded to wrong Starling instance if multiple Starling instances were active.
* Item Renderers: added skinField, skinFunction, and itemHasSkin for background skins from the data provider.
* Item Renderers: added isSelectableOnAccessoryTouch property to control whether the selection will change or not when the accessory is touched.
* Item Renderers: added minGap and minAccessoryGap properties that are used when gap or accessoryGap are set to Number.POSITIVE_INFINITY.
* ITextEditor, ITextRenderer: extend a new IBaselineTextControl interface that defines a common baseline property.
* Layouts: fixed issue where they didn't account for pivotX and pivotY.
* Layouts: when centering items, rounds the x and y positions to the nearest integer.
* LayoutGroup: added new backgroundSkin and backgroundDisabledSkin properties.
* List, GroupedList: if dataProvider property is changed, or the collection dispatches CollectionEventType.RESET, automatically behaves as if updateItemAt() were called on all item renderers.
* ListCollection, HierarchicalCollection: added dispose() function to support a way to dispose things like display objects or textures in items.
* NumericStepper: claims exclusive touch so that it won't repeat while scrolling with touch.
* NumericStepper: fixes for obscure situations where text input changes are not reflected in the value.
* NumericStepper: improved auto-measurement for values that are not integers.
* NumericStepper: added textInputGap and buttonGap properties.
* PageIndicator: added new interactionMode property to allow alternate precise selection of symbols on tap, instead of previous back/next behavior.
* Panel: added new outerPadding properties to support padding that is around the everything, including the header and footer. The existing (inner) padding properties only apply to the content between the header and footer.
* PanelScreen: turns on clipping by default.
* PickerList: added toggleButtonOnOpenAndClose property.
* PickerList: implements IFocusDisplayObject and manages focus of children better.
* PickerList: closes on enter key to match native behavior.
* PopUpManager: when centering a pop-up, rounds the x and y positions to the nearest integer.
* ProgressBar: fixed vertical fill so that it starts from the bottom and fills up.
* PropertyProxy: added toString() function to allow a PropertyProxy to be output to console.
* Scale3Image, Scale9Image, fixed issue where scaling smaller than the minimum size would cause overlapping instead of distortion when end regions weren't the same size.
* Scale3Textures, Scale9Textures: fixed rendering of textures with a scale property that isn't equal to 1.
* Screens: removed dpiScale, pixelScale, originalWidth, and originalHeight properties. The kinds of calculations these values were used for should be handled in the theme (or somewhere else outside of the screen if not using a theme).
* ScrollBar: increment and decrement buttons are hidden, like the thumb, if the minimum is equal to the maximum. The track fills the full dimensions.
* ScrollBar: fix for wrongly positioned track when direction is horizontal.
* ScrollContainer: fixed wrong measurement when using no layout with children at negative coordinates.
* Scroller: fixed issue where a floating scroll bar wouldn't disappear.
* Scroller: refactored scrolling behavior to more closely match iOS native scrolling.
* Scroller: touch overlay and background skins are added and removed instead of changing visible property. Works better with Monster Debugger.
* Scroller: fixes issue where events were dispatched for a completed scroll when the scroll position didn't actually change from calling throwTo().
* Scroller: added support for a view port that doesn't necessarily auto-size to show its full content. In other words, a view port can choose to measure so that it needs to scroll.
* Scroller: fixed issue where background wasn't sized property when isEnabled was changed.
* Scroller: skips some unnecessary code when dimensions are explicit to improve performance.
* Scroller: added new measureViewPort property that can be set to false to exclude the view port from auto-measurement and only use the background skin.
* Scroller: automatically sets direction property on scroll bars, so that you don't need to, thanks to the new IDirectionalScrollBar interface.
* ScrollText: added disabledTextFormat property.
* ScrollText: may receive focus and use keyboard arrow keys to scroll.
* Slider: added new trackInteractionMode property to control whether touching the track updates the value by page or jumps directly to the nearest value.
* SmartDisplayObjectValueSelector: fixed issue where getValueTypeHandler() function had an extra parameter.
* SmartDisplayObjectValueSelector: added support for null value other than the default.
* SmartDisplayObjectValueSelector: stricter reuse of display objects. Type must match exactly. Fixes issue where Image is incorrectly reused because it is a subclass of Quad.
* StageTextTextEditor: fixed issue where measurement was wrong when text was an empty string.
* StageTextTextEditor: fixed issue on iOS where characters were masked immediately instead of showing in the clear for a moment.
* StageTextTextEditor: fixed issue where the clipboard menu appeared unexpectedly when multiline is true.
* StageTextTextEditor: draws StageText to BitmapData with double dimensions on Mac HiDPI, thanks to Adobe's bug fix.
* TabBarSlideTransitionManager: fixes bug where switching between tabs quickly would break the transition.
* Text: will use non-power-of-two textures for snapshots, if the Stage 3D profile supports it.
* Text: if a renderer or editor supports native filters, does some extra cleanup in dispose() that is actually unnecessary, but will ease some pressure if there's a memory leak.
* Text: fixed issue where snapshot wasn't updated when isEnabled changed.
* TextBlockTextRenderer: if elementFormat is null, generates a default value so that something will be displayed.
* TextBlockTextRenderer: fixed issue where width was calculated wrong when text ended in whitespace.
* TextFieldTextEditor, TextFieldTextRenderer: added useGutter property to allow removal of the 2-pixel "gutter" that Flash adds to a TextField.
* TextInput, TextArea: added hasFocus getter to allow checking focus, even if there is no focus manager.
* TextInput, Text Editors: added new selectionBeginIndex and selectionEndIndex properties.
* TextInput: fixes issue where prompt text renderer's isEnabled property wasn't updated.
* TextInput: added new verticalAlign property to support top, middle, bottom, or justify.
* TextInput: won't throw an error if there's no background skin, but auto-measurement will result in a width and height of 0, unless typicalText is set.
* TextInput: improved support for text editors that are completely on the Starling display list without a native overlay.
* TextInput: doesn't create prompt text renderer if prompt is null.
* TextArea: added stateToSkinFunction, similar to Button background skin.
* TextArea: fixed issue where background skin was sometimes missing.
* TextArea: added clearFocus() function match API of TextInput.
* TextArea: further improvements to positioning and scaling of texture snapshot.
* Text Editors: improved support for Mac HiDPI.
* Text Editors: added disabled font styles.
* Text Renderers: uses generateFilterRect() when using nativeFilters for improved texture dimensions.
* Text Renderers: ITextRenderer now has a first-class wordWrap property that is required by all renderers.
* TiledColumnsLayout, TiledRowsLayouts: fixed result of getScrollPositionForIndex() when paging is disable to allow the item to be properly centered.
* TiledColumnsLayout, TiledRowsLayouts: fixed calculation of tile count when padding is used.
* TiledColumnsLayout, TiledRowsLayout: added requestedRowCount and requestedColumnCount properties.
* ToggleSwitch: fixed issue where the isEnabled property of text renderers wasn't properly updated.
* ToggleSwitch: added toggleThumbSelection property to update the isSelected property of the thumb (if it's a ToggleButton) to match the isSelected property of the switch.
* ToggleSwitch: fixed issue where selection change wasn't animated when triggered with the keyboard instead of a touch.
* ToggleSwitch: added new setSelectionWithAnimation() method so that programmatic selection changes can be optionally animated.
* Examples: override initialize() instead of listening for FeathersEventType.INITIALIZE.
* Example Themes: rewritten using the new style provider system.
* Example Themes: tweaked padding, gap, dimensions, and other values to be based on a simple grid system for more consistency.

### 2.0.0 Deprecated APIs

All deprecated APIs are subject to the [Feathers deprecation policy](https://feathersui.com/help/deprecation-policy.html). Please migrate to the new APIs as soon as possible because the deprecated APIs **will** be removed in a future version of Feathers.

The `nameList` property has been deprecated, and it is replaced by the `styleNameList` property. The `name` property is no longer connected to style names, and situations where it failed to work with `getChildByName()` have been resolved. The `styleName` property has been added to replace the former usage of the `name` property as a concatenated version of `nameList` (now, `styleNameList`).

The `manageVisibility` property on layouts has been deprecated. In previous versions, this property could be used to improve performance of non-virtual layouts by hiding items that were outside the view port. However, other performance improvements have made it so that setting `manageVisibility` can now sometimes hurt performance instead of improving it.

### 2.0.0 Default Behavior and API Changes

This is a major update to Feathers, so it includes more breaking changes than usual. Be sure to read this section thoroughly to see if any of these changes will affect your apps.

`TextFieldTextRenderer` and `TextFieldTextEditor` now have a `useGutter` property that controls whether the 2-pixel gutter around the edges of the `flash.text.TextField` will be used in measurement and layout. In previous versions of Feathers, the gutter was always enabled. The gutter is now disabled by default to allow text controls based on `TextField` to more easily align with other text controls.

The `ITextRenderer` and `ITextEditor` interfaces now extend the `ITextBaselineControl` interface. In the case of `ITextEditor`, a new `baseline` getter is required.

The `ITextRenderer` interface now requires a `wordWrap` property.

The `IFocusDisplayObject` interface now requires a `focusOwner` property.

Properties including `dpiScale`, `pixelScale`, `originalWidth`, `originalHeight`, and `originalDPI` have been removed from `Screen`, `ScrollScreen` and `PanelScreen`. The calculations previously offered by these properties should be handled in skinning code, such as the theme.

The `Button` class no longer supports selection. This functionality has been moved into a subclass, `ToggleButton`.

The `autoFlatten` property has been removed from the `Button` class.

Setting the properties of a sub-component, such as using `thumbProperties` on a `Slider` to set properties on the slider's thumb sub-component, is now stricter. Previously, when a property did not exist, it was silently ignored. Now, an error will be thrown.

If no text format is defined, `BitmapFontTextRenderer` defaults to using `BitmapFont.MINI` so that the text will always be rendered. Previously, it would render nothing.

If no element format is defined, `TextBlockTextRenderer` defaults to using a new `ElementFormat` with default arguments so that the text will always be rendered. Previously, an error was thrown.

A `trackInteractionMode` property has been added to `Slider`. In previous versions, `Slider` behaved as if `trackInteractionMode` were set to `Slider.TRACK_INTERACTION_MODE_BY_PAGE`. Now, the default value is `Slider.TRACK_INTERACTION_MODE_TO_VALUE`.

A `verticalAlign` property has been added to `TextInput`. In previous versions, `TextInput` behaved as if `verticalAlign` were set to `TextInput.VERTICAL_ALIGN_JUSTIFY`. Now, the default value is `TextInput.VERTICAL_ALIGN_MIDDLE`.

The `FeathersControl` class is now considered abstract. It will throw a runtime error if instantiated directly instead of being subclassed. If you need a generic Feathers component as a wrapper for another display object, use `LayoutGroup` instead.

The `leftItems`, `rightItems`, and `centerItems` getters on the `Header` class no longer make a copy of their storage variables. Take care when modifying these values directly.

Focus management now supports multiple Starling stages (for AIR desktop apps). The static `isEnabled` property has been removed. Instead, you should use the static `setEnabledForStage()` function:

```as3
FocusManager.setEnabledForStage( Starling.current.stage, true );
```

All layouts now account for the `pivotX` and `pivotY` properties when positioning display objects. In previous versions, these properties were ignored.

When the `direction` property of a `ProgressBar` is equal to `ProgressBar.DIRECTION_VERTICAL`, the fill now starts at the bottom and fills up.

The increment button and decrement button sub-components of a `ScrollBar` are now hidden when the scroll bar's maximum scroll position is equal to its minimum scroll position, just like how the thumb is hidden. The track will be resized to fill the extra space where the buttons were previously rendered.

When replacing the `dataProvider` of a `List` or `GroupedList` (or replacing the `data` property of a `ListCollection` or `HierarchicalCollection`), it is no longer necessary to call `updateItemAt()` on the new collection if it contains some of the same items as the previous collection. This behavior will happen automatically.

## 1.3.1 - July 2014

* NumericStepper: fixed issue where using step to calculate a new value didn't account for the minimum value.
* NumericStepper: fixed issue where only some text was selected after changing value.
* TextInput: fixed issue where FOCUS_OUT event wasn't dispatched when used with a NumericStepper and FocusManager.isEnabled is true, causing NumericStepper to fail to update its value properly.
* Slider: fixed issue where using step to calculate a new value didn't account for the minimum value.
* Button: validates skin if the skin implements IValidating so that the skin resizes properly if button dimensions are tweened.
* Callout: fixed issue where callout incorrectly stopped content from resizing.
* Callout: fixed issue where content resizing wouldn't reposition callout to point to origin.
* TextInput: fixed issue where sometimes focus was not cleared on removal.
* TextBlockTextRenderer: fixed issue where sometimes an infinite loop was triggering when attempting to truncate.
* TextFieldTextEditor: fixed issue where existing text did not render with new text format.
* StageTextTextEditor, TextFieldTextEditor: fixed issue where multiple FOCUS_OUT events could be dispatched.
* TextArea: fixed positioning of texture snapshot when scrolling.
* TiledRowsLayout, TiledColumnsLayout: fixed issue where some tiles would be incorrectly invisible with top or left padding and manageVisibility.
* LayoutGroup: respects includeInLayout when no layout is specified.
* TextInput: fixed selection position on touch when displaying an icon.
* Gallery Example: updated to use HTTPS URLs since Flickr will soon require it.
* YouTubeFeeds Example: switched to category feeds since the older feeds were deprecated and displayed the wrong data.

## 1.3.0 - April 2014

* New Component: ScrollScreen is new base class for ScreenNavigator screens that supports scrolling similar to ScrollContainer.
* New Component: TextBlockTextRenderer is a new text renderer that renders text with flash.text.engine.TextBlock, with a texture snapshot similar to TextFieldTextRenderer.
* More performance improvements with the help of Adobe Scout.
* Improved support for multiple windows in desktop AIR apps.
* Improved support for using scaleX and scaleY with Feathers components.
* Added support for Mac HiDPI resolutions.
* HorizontalLayout: added support for percentWidth and percentHeight with HorizontalLayoutData.
* VerticalLayout: added support for percentWidth and percentHeight with VerticalLayoutData.
* AnchorLayout: added support for percentWidth and percentHeight with AnchorLayoutData.
* HorizontalLayout: added optional firstGap and lastGap properties.
* VerticalLayout: added optional firstGap and lastGap properties.
* HorizontalLayout: added distributeWidths property to available divide available width equally to all items.
* HorizontalLayout: added distributeHeights property to available divide available height equally to all items.
* AnchorLayout: performance improvements.
* PickerList: added openList() and closeList() functions to open and close pop-up list programmatically.
* Screen: now extends LayoutGroup to support layouts.
* Scroller: final removal of scrollerProperties, which was deprecated in version 1.1.0.
* Scroller: support for placing the vertical scroll bar on the right for right-to-left locales.
* Scroller: added mouseWheelScrollStep property to support different steps on scroll bar and mouse wheel.
* ScrollText: now chooses exclusively between styleSheet or textFormat to avoid runtime error.
* ScrollText: added support for hyperlinks, including a new Event.TRIGGERED event when a link is clicked/tapped.
* TextFieldTextRenderer: now chooses exclusively between styleSheet or textFormat to avoid runtime error.
* TextFieldTextRenderer: added nativeFilters property to support rendering text with filters.
* BitmapFontTextRenderer: fixed issue where truncation happened when it wasn't necessary.
* BitmapFontTextRenderer: fixed kerning when font size is scaled.
* ImageLoader: added textureFormat property to specify a Context3DTextureFormat value.
* List: reuses its typical item renderer instead of creating a new one when measurement is required.
* ScrollContainer: added IScrollContainer interface including functions for "raw" children.
* Themes: "quiet" buttons now have a transparent up skin to blend into toolbars.
* Themes: broke apart initialize() function into multiple functions for better organization.
* Themes: support for optionally loading assets at runtime instead of embedding.
* Themes: now available as SWCs for easier project setup.
* MetalWorksMobileTheme: uses the new TextBlockTextRenderer.
* LayoutGroup: fix for empty spaces when an item is added more than once.
* ILayout: added new requiresLayoutOnScroll property to improve performance for static layouts.
* IValidating: new interface for objects that support validation.
* Scale9Image: implements IValidating to support forced validation and to put it in the ValidationQueue.
* Scale3Image: implements IValidating to support forced validation and to put it in the ValidationQueue.
* TiledImage: implements IValidating to support forced validation and to put it in the ValidationQueue.
* TabBar: support for more layout properties similar to ButtonGroup.
* Header: added optional centerItems property to support items in the center to replace the title.
* Item Renderers: added selectableField and selectableFunction to allow some item renderers to be selectable and some that are not selectable.
* Item Renderers: added enabledField and enabledFunction to allow some item renderers to be enabled and some that are not enabled.
* Item Renderers: added iconLabelField and iconLabelFunction similar to accessoryLabelField and accessoryLabelFunction.
* Item Renderers: support truncation of accessory label.
* DisplayListWatcher: extends EventDispatcher so that subclasses (themes) can dispatch events.
* DisplayListWatcher: now processes all matching named initializers instead of only the first match.
* PopUpManager: added IPopUpManager to support custom pop-up managers.
* PopUpManager: better support for multiple Starling instances.
* Alert: fixed issue where button group was disposed on close and caused runtime error.
* AnchorLayout: fixes for broken layouts with certain ordering of children.
* AnchorLayout: fixes to avoid runtime error when using children that don't implement ILayoutDisplayObject.
* Button: fix to long press duration being treated as an integer instead of floating point.
* Button: small fixes to layout edge cases.
* ButtonGroup: fix to allow buttons to be disabled and re-enabled.
* ButtonGroup: fix to properly remove event listners from data provider when data provider changes.
* BitmapFontTextRenderer: fix for centered text being blurred because its position wasn't rounded to an integer.
* Item Renderers: minor fixes to layout edge cases.
* StageTextTextEditor: fix for StageText not being properly hidden when text is empty.
* TextInput: fix for icon positioning using wrong padding value.
* ImageLoader: added optional textureQueueDuration property to upload textures after a short delay while delayTextureCreation is true. Previously, textures would not upload at all until delayTextureCreation was set to false again.
* ProgressBar: no longer sets touchable to false on skins.
* Panel: fix for failing to detect header and footer resizing.
* Drawers: fix for failing to detect drawer resizing.
* Scroller: fix for issue where an animated scroller with the scroll policy set to SCROLL_POLICY_OFF would incorrectly stop scrolling when touched. 
* Scroller: fix for incorrect calculation of maximum scroll positions when pageWidth or pageHeight is set.
* TextFieldTextRenderer: fix for wrapping bug.
* HorizontalLayout: fix for getScrollPositionForIndex() to properly calculate scroll position for indices less than beforeVirtualizedItemCount.
* VerticalLayout: fix for getScrollPositionForIndex() to properly calculate scroll position for indices less than beforeVirtualizedItemCount.
* ScreenNavigator: fix for edge case where the screen was not resized properly with AUTO_SIZE_MODE_CONTENT.

### 1.3.0 Deprecated APIs

All deprecated APIs are subject to the [Feathers deprecation policy](https://feathersui.com/help/deprecation-policy.html). Please migrate to the new APIs as soon as possible because the deprecated APIs **will** be removed in a future version of Feathers.

The `scrollerProperties` property on scrolling components, including List, GroupedList, ScrollText and ScrollContainer was originally deprecated in Feathers 1.1.0, and it has now been removed. Because these components now extend `Scroller` instead of adding a `Scroller` as a child, all of the properties that could be set through `scrollerProperties` can now be set directly on the components.

### 1.3.0 API Changes

Some changes have been made to Feathers that have the potential to break code in existing projects. Changes of this type may be considered [exceptions to the Feathers deprecation policy](https://feathersui.com/help/deprecation-policy.html#exceptions), and careful consideration is made to limit the impact of these changes on existing projects. Most developers using Feathers will not be affected by these changes, except perhaps, to observe improved stability and consistency.

#### ILayout

One change has been made to the `ILayout` interface. Custom implementations of `ILayout` created before Feathers 1.3.0 will have compiler errors until the required changes are made.

The property `requiresLayoutOnScroll` has been added to `ILayout` to provide improved performance for static layouts that don't change when a container scrolls.

 This property can easily simulate the old behavior from Feathers 1.2.0, if required. The following implementation of `requiresLayoutOnScroll` can easily be copied into a custom implementations of `ILayout` to quickly migrate existing Feathers 1.2.0 implementations to behave exactly the same in Feathers 1.3.0:

	public function get requiresLayoutOnScroll():Boolean
	{
		return true;
	}

## 1.2.0 - November 2013

* New Component: Alert
* New Component: Drawers
* New Component: LayoutGroup
* New Component(s): LayoutGroupListItemRenderer, LayoutGroupGroupedListItemRenderer, LayoutGroupedListHeaderOrFooterRenderer
* FeathersControl: better support for scaleX and scaleY. Width and height are scaled.
* FeathersControl: dispatches FeathersEventType.CREATION_COMPLETE after the first validation.
* FeathersControl: added isCreated flag to indicate if FeathersEventType.CREATION_COMPLETE has been dispatched.
* FeathersControl: ensures that keyboard focus is ignored if disabled.
* FeathersControl: new protected functions setInvalidationFlag() and getInvalidationFlag() for better re-invalidation during draw().
* FeathersControl: getChildByName() uses nameList.contains(). Doesn't work when an IFeathersControl is in a non-Feathers display object.
* Button: added FeathersEventType.LONG_PRESS event.
* Button: updates isEnabled on label text renderer and icon, if applicable.
* Button: label is always on top of the icon.
* List, GroupedList: Setting a new data provider will clear selection. Now, selection cannot be set before data provider is passed in. If the same selection is desired after a data provider change, it should be done manually.
* List, GroupedList: improved invalidation when various properties are changed.
* List, GroupedList: better handling of typical item to improve performance an accuracy of layout calculations.
* List, GroupedList: support for item renderers that can be deselected if multiple selection isn't enabled.
* ListCollection: removeAll() checks if length is 0 to avoid dispatching an event.
* GroupedList: improved handling of updateItemAt() to properly update whole groups.
* ImageLoader: added loadingTexture and errorTexture properties.
* ImageLoader: support for loading ATF files from URL.
* ToggleSwitch: on and off labels can be created with separate factories.
* Panel: header and footer contents can receive keyboard focus.
* ButtonGroup: properly resizes when data provider changes.
* ButtonGroup: support for padding around buttons.
* ButtonGroup: dispatches its own Event.TRIGGERED when any button is triggered.
* ButtonGroup: support for horizontal and vertical alignment.
* ButtonGroup, TabBar: better handling of custom names for first and last items.
* Callout: backgroundSkin is no longer required.
* Callout: show() function adds an argument for a custom overlay factory.
* Scale9Image, Scale3Image: support for scaling edge regions down to zero. Causes distortion, but removes overlapping.
* Scale9Image, Scale3Image, TiledImage, BitmapFontTextRenderer: uses batchable property from QuadBatch for improved performance.
* BitmapFontTextRenderer: fix for center and right alignment when using maxWidth.
* BitmapFontTextRenderer: fix for center and right alignment when no width or maxWidth is set.
* Scroller: support for minimum scroll positions less than zero.
* Scroller: improved draw() function to avoid extra invalidation.
* Scroller: new interactionMode value INTERACTION_MODE_TOUCH_AND_SCROLL_BARS.
* Scroller: added minimumDragDistance and minimumPageThrowVelocity.
* Scroller: fixed vertical page snapping.
* Scroller: supports custom page dimensions for snapping.
* Scroller: won't scroll with mouse wheel when scroll policy is off.
* Text editors: visibility fixes when text is empty.
* TextFieldTextEditor: support for rotation.
* StageTextTextEditor: doesn't clear text when displayAsPassword is changed.
* StageTextTextEditor: better scaling and support for rotation.
* TextFieldTextRenderer: supports using multiple textures if text width or height is greater than 2048 pixels.
* TextFieldTextRenderer: added disabledTextFormat property.
* TextInput, text renderers: dispatches soft keyboard events.
* TextInput: supports icon.
* TextInput: alternate name for search input.
* Screen, PanelScreen: better handling of back button that accounts for depth.
* ScreenNavigator: properly resizes if content is resized.
* ScreenNavigator: clears screen if removeScreen() is called for the active screen.
* ToggleGroup: added getItemIndex() and setItemIndex().
* VerticalCenteredPopUpContentManager: touch must begin and end outside of content to close the content.
* DisplayListWatcher: added initializeObject() function to initialize display objects that are already added when a theme is created.
* PropertyProxy: support for QName values.
* SmartDisplayObjectValueSelector: fix to support uint values for Quads.
* SmartDisplayObjectValueSelector: support for ConcreteTexture.
* State value selectors: strict equality checks for null to support 0 values.
* VerticalLayout, HorizontalLayout: improved item validation to account for justify alignment.
* AnchorLayout: better measurement when using horizontalCenter or verticalCenter values.
* ValidationQueue: items are added to the queue faster with better sorting.
* ExclusiveTouch: allows a component to claim a touch so that nested scrolling components won't be in conflict.
* Label: added ALTERNATE_NAME_HEADING for larger text and ALTERNATE_NAME_DETAIL for smaller text.
* Default item renderers: better handling of data and fields.
* Default item renderers: support for delaying texture creation on scroll in ImageLoaders.
* Default item renderers: updates isEnabled on accessory, if applicable.
* Default item renderers: accessory is cleared if itemHasAccessory is set to false.
* Default item renderers: fix for measurement when label is missing and gap isn't needed.
* DefaultGroupedListHeaderOrFooterRenderer: contentLabel maxWidth is used for proper wrapping, if needed.
* DefaultGroupedListHeaderOrFooterRenderer: added support for justify alignments.
* Many performance improvements with the help of Adobe Scout.
* All built-in components ensure that sub-components are validated.
* Examples: use drawers component where applicable.
* Examples: new DrawersExplorer example.
* Examples: new DragAndDrop example for DragDropManager.
* Themes: updated to support new properties and alternate names.
* Documentation: many properties now list default values.
* Documentation: createSubComponent() and autoSizeIfNeeded() patterns are now documented parts of the architecture.
* Fixes to better support iOS 7.
* New minimum runtime versions. Target SWF version rolled back to 18 (Flash Player 11.5 and AIR 3.5) to offer easier BlackBerry 10 support.

### 1.2.0 Deprecated APIs

All deprecated APIs are subject to the [Feathers deprecation policy](https://feathersui.com/help/deprecation-policy.html). Please migrate to the new APIs as soon as possible because the deprecated APIs **will** be removed in a future version of Feathers.

The `scrollerProperties` property on scrolling components, including List, GroupedList, ScrollText and ScrollContainer is deprecated. Because these components now extend `Scroller` instead of adding a `Scroller` as a child, all of the properties that could be set through `scrollerProperties` can now be set directly on the components. The `scrollerProperties` property was deprecated in Feathers 1.1.0, and it remains deprecated in Feathers 1.2.0. 

### 1.2.0 API Changes

Some changes have been made to Feathers that have the potential to break code in existing projects. Changes of this type are considered [exceptions to the Feathers deprecation policy](https://feathersui.com/help/deprecation-policy.html#exceptions), and careful consideration is made to limit the impact of these changes on existing projects. Most developers using Feathers will not be affected by these changes, except perhaps, to observe improved stability and consistency.

#### PopUpManager

Two changes have been made to the `PopUpManager`.

The function `isTopLevelPopUp()` has been modified to indicate if a pop-up is above the top-most modal overlay. Previously, this function indicated if a pop-up is the single top-most pop-up.

When a pop-up is centered when calling `PopUpManager.addPopUp()`, the `PopUpManager` will automatically realign the pop-up if the stage or the pop-up is resized. If you prefer that the pop-up isn't realigned, change the argument to `false` and call `PopUpManager.centerPopUp()` instead. It will align the pop-up only once. If you previously manually repositioned the pop-up to keep it centered when it or the stage resized, you may remove that code. However, if the code remains, it should not cause conflicts with the new behavior.

#### IVirtualLayout

Three changes have been made to the `IVirtualLayout` interface. Custom implementations of `IVirtualLayout` created before Feathers 1.2.0 will have compiler errors until the required changes are made. It is expected that a small number of Feathers developers have created custom implementations of `IVirtualLayout`, so this change will have no impact on the majority of projects that are upgraded from older versions of Feathers.

The `typicalItemWidth` and `typicalItemHeight` properties may be removed completely from custom `IVirtualLayout` implementations. In their place, the `typicalItem` property must be added. Components like `List` previously passed pre-calculated width and height values for a typical item display object. However, a layout may need to manipulate the typical item before calculating its dimensions. By giving more control to the layouts, their estimation of virtualized items will be more accurate.

The new `typicalItem` property might be declared as follows:

	/**
	 * @private
	 */
	protected var _typicalItem:DisplayObject;

	/**
	 * @inheritDoc
	 */
	public function get typicalItem():DisplayObject
	{
		return this._typicalItem;
	}

	/**
	 * @private
	 */
	public function set typicalItem(value:DisplayObject):void
	{
		if(this._typicalItem == value)
		{
			return;
		}
		this._typicalItem = value;
		this.dispatchEventWith(Event.CHANGE);
	}

Usage of the new `typicalItem` property may depend on factors that are specific to each implementation. In general, an implementation will measure the typical item at the beginning of most of its public functions, including `layout()`, `getScrollPositionForIndex()`, `getVisibleIndicesAtScrollPosition()`, and `measureViewPort()`. If the typical item is a Feathers control, it should be validated. The following snippet shows the most basic case for how to request the typical item's dimensions:

	var measuredTypicalItemWidth:Number = 0;
	var measuredTypicalItemHeight:Number = 0;
	if( this._useVirtualLayout && this._typicalItem )
	{
		if( this._typicalItem is IFeathersControl )
		{
			//validate the typical item so that it reports the correct width and height
			this._typicalItem.validate();
		}

		measuredTypicalItemWidth = this._typicalItem.width;
		measuredTypicalItemHeight = this._typicalItem.height;
	}

If the typical item is a Feathers control, validate() should be called before requesting its dimensions. Optionally, the dimensions of a Feathers control may be reset to `NaN` in order to ask the control for its ideal dimensions. This will match the behavior introduced Feathers 1.1.x. However, in Feathers 1.2.0, the built-in layouts have chosen to reset the typical item's dimensions only when a flag is enabled. For many layouts, resetting the dimensions of the typical item is rarely required, and it may be undesireable. This change reverts the behavior to match Feathers 1.0.x, while still allowing advanced developers to re-enable the behavior introduced in Feathers 1.1.x.

For more advanced code, take a look at one of the built-in layout classes, such as `VerticalLayout`.

Note: The built-in layout classes repurpose the `typicalItemWidth` and `typicalItemHeight` properties that were removed from `IVirtualLayout` to work with a new `resetTypicalItemDimensionsOnMeasure` property. By default, setting these properties outside of a component like `List` will have no effect, which exactly matches the behavior from all older versions of Feathers. Custom layouts may elect to provide this same capability, but it is not required by the `IVirtualLayout` interface.

#### GroupedList

The `typicalHeader` and `typicalFooter` properties have been removed from `GroupedList` to support the better handling of typical items in virtual layouts, as discussed above. From now on, the `typicalItem` on a `GroupedList` is the only way to provide hints to the layout used by a `GroupedList`.

## 1.1.1 - September 2013

This release includes minor updates to support Starling Framework 1.4 and a number of minor bug fixes.

* Switches to Starling's implementation of the clipRect property.
* Uses Texture onRestore for internally managed textures, like in text controls.
* StageTextTextEditor: fix for displayAsPassword clearing the text.
* Panel: won't scroll if mouse wheel or touch occurs in header or footer.
* Panel: header and footer can be touched when content is scrolling.
* AeonDesktopTheme: uses a better disabled text color.
* SmartDisplayObjectStateValueSelector: properly supports uint color value of 0.
* Item Renderers: smarter handling of accessory resizing.
* Item Renderers: better measurement to account for NaN.
* Item Renderers: properly checks for _data, in addition to _owner, in commitData().
* Label: sets proper text renderer dimensions if height is explicitly set.
* Radio: better handling of setting toggleGroup to avoid accidentally adding to defaultRadioGroup.
* Scroller: properly updates isEnabled on scroll bars when they are first created.
* Scroller: child touches are blocked until throw animation finishes to match native behavior.
* Scroll bars: better isEnabled handling.
* TextInput: better handling of focus when not visible.
* TextInput: better prompt handling.
* TextInput: fix to allow TextFieldTextEditor to be selected on focus in.
* TextInput: added clearFocus() to allow programmatic removal of focus in NumericStepper.
* TextFieldTextEditor: snapshot is properly hidden when text is cleared.
* ButtonGroup: properly resizes when data provider changes.
* GroupedList: requests proper typical item from data provider.
* ScrollText: better padding getter.
* PickerList: closes pop-up list on Event.TRIGGERED.
* PickerList: properly disposes pop-up list and IPopUpContentManager.
* NumericStepper: if TextInput sub-component is editable, it will be selected on focus in.
* TiledRowsLayout, TiledColumnsLayout: fixed manageVisibility implementation.
* TiledRowsLayout, TiledColumnsLayout: fixed bad positioning when useSquareTiles is true.

## 1.1.0 - June 2013

* New Beta Component: NumericStepper. Add and subtract from a numeric value with buttons. Optional text editing.
* New Beta Component: TextArea. A multiline text input. Recommended for desktop only. Not recommended for mobile.
* New Beta Component: Panel. A new container subclassing ScrollContainer that adds a header and an optional footer.
* New Beta Component: PanelScreen. An IScreen implementation (similar to Screen) based on Panel.
* New Beta Layout: AnchorLayout. Added to support fluid layouts and relative positioning. Can position relative to parent container and also to other children of the parent container.
* Added FocusManager for keyboard navigation and interaction. Not intended for mobile. Use a desktop theme or set `FocusManager.isEnabled = true`. TextInput *cannot* use StageTextTextEditor when focus management is enabled. TextFieldTextEditor is recommended.
* All Components: sub-components are created from factories and can receive custom names for theming.
* Added ILayoutObject interface to support extra data for layouts to use, like includeInLayout property.
* List: support for optional multiple selection.
* TextInput: supports prompt/hint
* TextInput/StageTextTextEditor: supports multiline on mobile.
* PickerList: supports prompt when no item is selected.
* Slider: measurement now includes thumb dimensions and a new property called trackScaleMode has been added.
* Callout: disposal is more consistent. Set combination of disposeOnSelfClose and disposeContent.
* Callout: doesn't close when origin is touched. origin should now separately determine correct behavior.
* Callout: added origin and supportedDirections properties to make Callout capable of switching origins after creation.
* Item Renderers: properly handle accessory resizing if accessory is a FeathersControl.
* Item Renderers: fixes for a number of layout order, gap, and alignment combinations.
* PickerList: doesn't close when touching scroll bar. only item renderer touch will trigger a close.
* PopUpManager: Supports custom root to place pop-ups somewhere other than the stage.
* PopUpManager: modal pop-ups receive a different focus manager.
* ScreenNavigator: added hasScreen(), getScreen(), and getScreenIDs().
* ScreenNavigator: added autoSizeMode property to select between sizing to fit stage or to fit content.
* ScreenNavigator: fix for broken transition if showScreen() is calleed before transition begins but after new screen is added to stage.
* Transitions: fix for quickStack constructor argument.
* ScrollContainer, List, GroupedList: better auto-sizing with a background skin.
* ScrollContainer: new alternate name for toolbar style.
* TextInput: exposed isEditable, maxChars, restrict, and displayAsPassword properties.
* BitmapFontTextRenderer, Scale3Image, Scale9Image: option to turn off the use of a separate QuadBatch.
* TextFieldTextEditor: better selection on mobile.
* TextFieldTextEditor: properly dispatches FeathersEventType.ENTER.
* Text Renderers and Editors: better snapshot disposal.
* TextFieldTextRenderer: better measurement to workaround runtime dimensions being wrong.
* TiledRowsLayout, TiledColumnsLayout: supports separate horizontal and vertical gaps.
* TiledRowsLayout, TiledColumnsLayout: more stable virtualized item renderer count to improve performance.
* TiledRowsLayout, TiledColumnsLayout: fixes for certain issues with paging.
* ButtonGroup: supports isEnabled as a property in the data provider.
* ImageLoader: added delayTextureCreation flag to avoid creating textures while scrolling (or during any action that requires best performance).
* Scroller: adds an invisible overlay during scrolling to block touch events on children.
* Scroller: exposes horizontal and vertical page count properties.
* Scroller: added FeathersEventType.SCROLL_START event.
* Scroller: scroll bars are hidden when stopScrolling() is called.
* Scroller: fix for velocity calculation.
* Button: better detection of click to avoid other display objects moving on top of button before TouchPhase.ENDED.
* Button: new styles for themes, including back, forward, call-to-action, quiet, and danger.
* List: if items are added or removed, selected indices are adjusted.
* List, GroupedList, ScrollContainer, and ScrollText all extend Scroller, instead of using it as a sub-component. The scrollerProperties property on each of these is now deprecated because all public properties of Scroller are now direct public properties of these components. Theme initializers that target Scroller will break because Scroller is no longer a sub-component, but a super class of classes like List. Move this stuff into initializers for List, GroupedList, ScrollContainer, and ScrollText.
* FeathersControl: setSizeInternal() is now stricter. It can never receive a NaN value for width or height. This is a common source of bugs, and throwing an error here will help make it easier to find those bugs.
* IVariableVirtualLayout: added function addToVariableVirtualCacheAtIndex() for more specific control over the cache of item dimensions.
* IVariableVirtualLayout: added function removeFromVariableVirtualCacheAtIndex() for more specific control over the cache of item dimensions.
* ScrollText: now properly handles visible and alpha properties.
* ListCollection: added removeAll(), addAll(), addAllAt() and contains().
* Scroller: scrolling animates for mouse wheel.
* List, VerticalLayout, HorizontalLayout: optimized case where useVirtualLayout is true and hasVariableItemDimensions is false.
* HorizontalLayout, VerticalLayout, TiledRowsLayout, TiledColumnsLayout: added manageVisibility property to set items to false when not in view. Set to true to improve performance.
* Item Renderers: added stopScrollingOnAccessoryTouch property to make accessory touch behavior configurable.
* Screen: default value of originalDPI is DeviceCapabilities.dpi. It used to be 168. Can still be changed.
* MetalWorksMobileTheme and MinimalMobileTheme: major overhaul with improved skins and new alternate skins.
* AeonDesktopTheme: added some missing skins, like TabBar.
* AeonDesktopTheme: uses FocusManager.
* AzureMobileTheme: removed this example theme. Please feel free to continue using the old version, if desired.
* ComponentsExplorer: better button screen to show off various styles of buttons.
* Todos: new example.
* All Examples: Use PanelScreen instead of Screen and Header where appropriate.
* All Examples: Use AnchorLayout where appropriate.
* All Examples: Uses NumericStepper instead of Slider where appropriate.
* Added 96x96 icons to examples for Android xhdpi. Requires AIR 3.7.
* Extended API documentation with inline examples and improved descriptions.
* Added many new articles to the Feathers Manual.
* Now built with ASC 2.0.

### 1.1.0 Deprecated APIs

All deprecated APIs are subject to the [Feathers deprecation policy](https://feathersui.com/help/deprecation-policy.html). Please migrate to the new APIs as soon as possible because the deprecated APIs **will** be removed in a future version of Feathers.

The `scrollerProperties` property on scrolling components, including List, GroupedList, ScrollText and ScrollContainer is deprecated. Because these components now extend `Scroller` instead of adding a `Scroller` as a child, all of the properties that could be set through `scrollerProperties` can now be set directly on the components.

### 1.1.0 API Changes

Some changes have been made to Feathers that have the potential to break code in existing projects. Changes of this type are considered [exceptions to the Feathers deprecation policy](https://feathersui.com/help/deprecation-policy.html#exceptions), and careful consideration is made to limit the impact of these changes on existing projects. Most developers using Feathers will not be affected by these changes, except perhaps, to observe improved stability and consistency.

#### IVariableVirtualLayout

Two changes have been made to the `IVariableVirtualLayout` interface. Custom implementations of `IVariableVirtualLayout` created before Feathers 1.1.0 will have compiler errors until the required changes are made. It is expected that a very small number of Feathers developers have created custom implementations of `IVariableVirtualLayout`, so this change will have no impact on the vast majority of projects that are upgraded from older versions of Feathers.

The functions `addToVariableVirtualCacheAtIndex()` and `removeFromVariableVirtualCacheAtIndex()` have been added to `IVariableVirtualLayout` to provide lower-level control over the cache of item dimensions. Instead of clearing the entire cache, a component may insert or remove a specific index from the cache. For instance, the `List` component uses these functions when its data provider is manipulated. These functions allow the layout to provide more accuracy to its virtualization and to improve performance.

 These two functions can easily simulate the old behavior from Feathers 1.0.x, if required. The following implementations of `addToVariableVirtualCacheAtIndex()` and `removeFromVariableVirtualCacheAtIndex()` can easily be copied into a custom implementations of `IVariableVirtualLayout` to quickly migrate existing Feathers 1.0.x implementations to behave exactly the same in Feathers 1.1.0:

	public function addToVariableVirtualCacheAtIndex(index:int, item:DisplayObject = null):void
	{
		this.resetVariableVirtualCache();
	}

	public function removeFromVariableVirtualCacheAtIndex(index:int, item:DisplayObject = null):void
	{
		this.resetVariableVirtualCache();
	}

## 1.0.1 - February 2013

This release includes a number of bug fixes.

* Scroller: FeathersEventType.SCROLL_COMPLETE always dispatched after last Event.SCROLL.
* ScrollBar, SimpleScrollBar: thumb position properly accounts for padding.
* Scroller: mouse wheel detection properly accounts for contentScaleFactor.
* ScreenNavigator: calling clearScreen() during a transition no longer causes a stack overflow.
* ScrollBar, SimpleScrollBar: can drag to minimum and maximum if they aren't a multiple of the step.
* Header: Fix for runtime error when rightItems aren't IFeathersDisplayObjects
* TextInput: better selection/cursor recovery when changing text programmatically.
* TextInput: Moved fontSize contentScaleFactor multiplication into StageTextTextEditor.
* FeathersControl: requires isInitialized to be true before it can validate.
* FeathersControl: clipRect properly accounts for scale.
* GroupedList: added missing documentation for setSelectedLocation().
* ImageLoader: does a better job keeping aspect ratio when only one dimension is explicit.
* ImageLoader: properly scales content when dimensions are explicit.
* ImageLoader: no runtime errors if content loads after dispose.
* ScrollContainer, List, GroupedList, ScrollText: fix for detecting changes in scrollToPageIndex().

## 1.0.0 - January 2013

No major API changes since 1.0.0 BETA. Mostly bug fixes and minor improvements.

* Fix for memory leaks in List, GroupedList, and ImageLoader
* PageIndicator properly handles ImageLoader or other IFeathersControl as symbol
* IGroupedListHeaderOrFooterRenderer extends IFeathersControl
* Header: fix for "middle" vertical alignment
* Updated for Starling Framework 1.3

## 1.0.0 BETA - December 2012

Initial release. The following major changes happened in the last month or two leading to the beta.

* GTween library removed as a dependency. All animations switched to the Starling `Tween` class.
* as3-signals library removed as a dependency. Switched to Starling events.
* `TextInput`: supports swappable text editors, similar to the text renderers used for uneditable text. The default `StageTextTextEditor` uses `StageText` to allow text input, which is ideal for mobile. The `TextFieldTextEditor` uses a `TextField` of `TextFieldType.INPUT` instead, and it may be a better choice for desktop. A static function, `defaultTextEditorFactory`, has been added to `FeathersControl`.
* `TextInput`: now has events for focus in and out.
* Item renderers: Switched to `ImageLoader` for icon and accessory textures, which has a `source` property that supports `Texture` instances or `String` URLs to load textures from the web. Properties like `iconTextureField` and `accessoryTextureFunction` now have new names like `iconSourceField` and `accessorySourceFunction` because values other than textures are now allowed. Similarly, `iconImageFactory` and `accessoryImageFactory` have been renamed to `iconLoaderFactory` and `accessoryLoaderFactory`.
* Item renderers: accessory may be positioned. See `layoutOrder` and `accessoryPosition` properties.
* Added `dispose()` method to `AddedWatcher` so that theme resources like textures be disposed.
* Added `ScrollText` component to display text in an overlay on the native display list. Useful for long passages of text that may be too large to convert to a texture.
* `ScreenNavigator`: added events for transition start and complete.
* `ToggleSwitch`: `TRACK_LAYOUT_MODE_STRETCH` is now `TRACK_LAYOUT_MODE_ON_OFF`.
* `Slider`: `TRACK_LAYOUT_MODE_STRETCH` is now `TRACK_LAYOUT_MODE_MIN_MAX`.
* `ScrollBar`: `TRACK_LAYOUT_MODE_STRETCH` is now `TRACK_LAYOUT_MODE_MIN_MAX`.


================================================
FILE: LICENSE.md
================================================
Simplified BSD License
======================

Copyright 2012-2021 Bowler Hat LLC. All rights reserved.

Redistribution and use in source and binary forms, with or without modification,
are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this
   list of conditions and the following disclaimer. 

2. Redistributions in binary form must reproduce the above copyright notice,
   this list of conditions and the following disclaimer in the documentation
   and/or other materials provided with the distribution. 

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

The views and conclusions contained in the software and documentation are those
of the authors and should not be interpreted as representing official policies, 
either expressed or implied, of the copyright holders.

================================================
FILE: README.md
================================================
# Feathers (AS3/Starling) 4.2.0

Say hello to [Feathers UI (AS3/Starling)](https://feathersui.com/learn/as3-starling), a library of light-weight, skinnable, and extensible UI controls for mobile and desktop. The components run on [Starling Framework](https://gamua.com/starling/) and [Adobe AIR](http://airsdk.dev) — offering blazing fast GPU powered graphics to create a smooth and responsive experience. Build completely standalone, native applications on iOS, Android, Windows, and macOS, or target Adobe Flash Player in desktop browsers. Created by [Josh Tynjala](https://joshblog.net) from Bowler Hat LLC, Feathers UI is free and open source.

## Quick Links

* [Website](https://feathersui.com/learn/as3-starling/)
* [Help](https://feathersui.com/learn/as3-starling/getting-started)
* [API Reference](https://feathersui.com/api-reference/)
* [Discussion Forum](https://forum.starling-framework.org/t/feathers)
* [Github Project](https://github.com/feathersui/feathersui-starling)

## Minimum Requirements

* Adobe AIR 50
* Starling Framework 2.7

## Downloads

Visit [Feathers Installation (AS3/Starling version)](https://feathersui.com/learn/as3-starling/installation/) to download the latest stable version of Feathers for ActionScript 3.0 and Starling Framework.

================================================
FILE: build.properties
================================================
#this folder should contain the contents of starling.zip/starling/src
starling.root = ${basedir}/third-party/starling

#this folder should contain the SWC files for flexunit, as described here:
#https://github.com/Gamua/Starling-Framework/blob/v1.7/tests/README.md
#additionally, it should contain the JAR files for the flexunit ant tasks
flexunit.root = ${basedir}/third-party/flexunit

# The location of the flexunit jar
flexunit.tasks = ${flexunit.root}/flexUnitTasks-4.2.0-20140410.jar

source.root = ${basedir}/source
examples.root = ${basedir}/examples
themes.root = ${basedir}/themes
api.root = ${basedir}/documentation/api-reference
help.root = ${basedir}/documentation/help
test.root = ${basedir}/test

output.path = ${basedir}/output
dependency.output = ${output.path}/dependencies
swc.output = ${output.path}/swc
help.output = ${output.path}/help
api.output = ${output.path}/api-reference
source.output = ${output.path}/source
examples.output = ${output.path}/examples
themes.output = ${output.path}/themes

swc.file = feathers.swc

swf.version = 30

feathers.version = 4.2.0

apm.lib.file = feathersui_${feathers.version}.airpackage
apm.src.file = feathersui-source_${feathers.version}.airpackage

footer.text = <a href='https://feathersui.com/' target='_top'>Feathers</a> | <a href='https://github.com/BowlerHatLLC/feathersui-starling' target='_top'>Github Project</a> | <a href='https://forum.starling-framework.org/forum/feathers' target='_top'>Support Forum</a>

================================================
FILE: build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="feathers" default="swc" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./sdk.local.properties"/>
	<property file="./sdk.properties"/>
	<property file="./build.local.properties"/>
	<property file="./build.properties"/>
	<taskdef resource="flexUnitTasks.tasks" classpath="${flexunit.tasks}"/>

	<target name="swc" depends="-feathers,-cleanup" description="builds .swc file only"/>

	<target name="api" depends="-api,-cleanup" description="builds API reference only"/>

	<target name="test" depends="-test,-cleanup" description="runs automated tests"/>

	<target name="full" depends="-feathers,-test,-api,-themes,-includes,-cleanup" description="builds distribution, but doesn't package as .zip file">

		<!-- move feathers.swc to its final location for distribution.
			basically, we didn't want the extra swc directory for a quick build. -->

		<copy overwrite="true" todir="${swc.output}">
			<fileset dir="${output.path}">
				<include name="${swc.file}"/>
			</fileset>
		</copy>
		<delete file="${output.path}/${swc.file}"/>
	</target>

	<target name="apm" depends="-apm,-cleanup" description="builds apm package">
		<delete file="${output.path}/${swc.file}"/>
		<delete dir="${themes.output}" includeemptydirs="true"/>
	</target>

	<target name="package" depends="full" description="builds and packages a .zip file for distribution">
		<zip destfile="${output.path}/feathers-ui-${feathers.version}.zip">
			<zipfileset dir="${output.path}"/>
		</zip>

		<delete includeemptydirs="true">
			<fileset dir="${output.path}" excludes="feathers-ui-${feathers.version}.zip"/>
		</delete>
	</target>

	<target name="-prepare">
		<delete dir="${output.path}"/>

		<loadfile srcFile="${source.root}/feathers/FEATHERS_VERSION.as" property="version.test">
			<filterchain>
				<linecontains>
					<contains value="public const FEATHERS_VERSION:String"/>
				</linecontains>
				<tokenfilter>
					<containsstring contains="${feathers.version}"/>
				</tokenfilter>
			</filterchain>
		</loadfile>
		<fail unless="version.test" message="feathers.FEATHERS_VERSION contains incorrect version string."/>
	</target>

	<target name="-cleanup">
		<delete dir="${dependency.output}" includeemptydirs="true"/>
		<delete dir="${output.path}/apm" includeemptydirs="true"/>
		<delete dir="${output.path}/apm-src" includeemptydirs="true"/>
	</target>

	<target name="-starling" depends="-prepare">
		<echo message="Building starling.swc"/>
		<java jar="${compc}" dir="${starling.root}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=."/>
			<arg value="-include-sources+=."/>
			<arg value="-output=${dependency.output}/starling.swc"/>
		</java>
	</target>

	<target name="-feathers" depends="-starling,-api-xml">
		<echo message="Building ${swc.file}"/>
		<java jar="${compc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=${source.root}"/>
			<arg value="-include-sources+=${source.root}"/>
			<arg value="-external-library-path+=${dependency.output}"/>
			<arg value="-output=${output.path}/${swc.file}"/>
		</java>
		<echo message="Inserting asdoc XML into .swc"/>
		<zip destfile="${output.path}/${swc.file}" update="true">
			<zipfileset dir="${dependency.output}/tempdita" prefix="docs">
				<include name="*.*"/>
				<exclude name="ASDoc_Config.xml" />
				<exclude name="overviews.xml" />
			</zipfileset>
		</zip>
	</target>

	<target name="-api" depends="-starling">
		<echo message="Generating API Reference"/>
		<java jar="${asdoc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="+flexlib=${flashsdk.framework}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=${source.root}"/>
			<arg value="-library-path+=${dependency.output}"/>
			<arg value="-doc-sources+=${source.root}"/>

			<!-- these two arguments are needed after switching to the AIR SDK
				with ASC 2.0 to stop weird errors -->
			<arg value="-theme="/>
			<arg value="-compiler.fonts.local-fonts-snapshot="/>

			<arg value="-templates-path"/>
			<arg value="${api.root}/templates"/>
			<arg value="-main-title=Feathers (Starling) ${feathers.version} API Reference"/>
			<arg value="-window-title=Feathers (Starling) API Reference"/>
			<arg value="-footer=${footer.text}"/>
			<arg value="-package-description-file=${api.root}/package-descriptions.xml"/>
			<arg value="-output=${api.output}"/>
		</java>
	</target>

	<target name="-api-xml" depends="-starling">
		<echo message="Generating asdoc XML"/>
		<java jar="${asdoc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="+flexlib=${flashsdk.framework}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=${source.root}"/>
			<arg value="-library-path+=${dependency.output}"/>
			<arg value="-doc-sources+=${source.root}"/>

			<!-- these two arguments are needed after switching to the AIR SDK
				with ASC 2.0 to stop weird errors -->
			<arg value="-theme="/>
			<arg value="-compiler.fonts.local-fonts-snapshot="/>

			<arg value="-keep-xml=true"/>
			<arg value="-skip-xsl=true"/>
			<arg value="-package-description-file=${api.root}/package-descriptions.xml"/>
			<arg value="-output=${dependency.output}"/>
		</java>
	</target>

	<target name="-themes" depends="-feathers">
		<echo message="Building AeonDesktopTheme.swc"/>
		<java jar="${compc}" dir="${themes.root}/AeonDesktopTheme" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=${themes.root}/AeonDesktopTheme/source"/>
			<arg value="-include-sources+=${themes.root}/AeonDesktopTheme/source"/>
			<arg value="-external-library-path+=${dependency.output}"/>
			<arg value="-external-library-path+=${output.path}/${swc.file}"/>
			<arg value="-output=${themes.output}/AeonDesktopTheme/swc/AeonDesktopTheme.swc"/>
		</java>

		<echo message="Building MetalWorksDesktopTheme.swc"/>
		<java jar="${compc}" dir="${themes.root}/MetalWorksDesktopTheme" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=${themes.root}/MetalWorksDesktopTheme/source"/>
			<arg value="-include-sources+=${themes.root}/MetalWorksDesktopTheme/source"/>
			<arg value="-external-library-path+=${dependency.output}"/>
			<arg value="-external-library-path+=${output.path}/${swc.file}"/>
			<arg value="-output=${themes.output}/MetalWorksDesktopTheme/swc/MetalWorksDesktopTheme.swc"/>
		</java>

		<echo message="Building MetalWorksMobileTheme.swc"/>
		<java jar="${compc}" dir="${themes.root}/MetalWorksMobileTheme" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=${themes.root}/MetalWorksMobileTheme/source"/>
			<arg value="-include-sources+=${themes.root}/MetalWorksMobileTheme/source"/>
			<arg value="-external-library-path+=${dependency.output}"/>
			<arg value="-external-library-path+=${output.path}/${swc.file}"/>
			<arg value="-output=${themes.output}/MetalWorksMobileTheme/swc/MetalWorksMobileTheme.swc"/>
		</java>

		<echo message="Building MinimalDesktopTheme.swc"/>
		<java jar="${compc}" dir="${themes.root}/MinimalDesktopTheme" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=${themes.root}/MinimalDesktopTheme/source"/>
			<arg value="-include-sources+=${themes.root}/MinimalDesktopTheme/source"/>
			<arg value="-external-library-path+=${dependency.output}"/>
			<arg value="-external-library-path+=${output.path}/${swc.file}"/>
			<arg value="-output=${themes.output}/MinimalDesktopTheme/swc/MinimalDesktopTheme.swc"/>
		</java>

		<echo message="Building MinimalMobileTheme.swc"/>
		<java jar="${compc}" dir="${themes.root}/MinimalMobileTheme" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=${themes.root}/MinimalMobileTheme/source"/>
			<arg value="-include-sources+=${themes.root}/MinimalMobileTheme/source"/>
			<arg value="-external-library-path+=${dependency.output}"/>
			<arg value="-external-library-path+=${output.path}/${swc.file}"/>
			<arg value="-output=${themes.output}/MinimalMobileTheme/swc/MinimalMobileTheme.swc"/>
		</java>

		<echo message="Building TopcoatLightMobileTheme.swc"/>
		<java jar="${compc}" dir="${themes.root}/TopcoatLightMobileTheme" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=${themes.root}/TopcoatLightMobileTheme/source"/>
			<arg value="-include-sources+=${themes.root}/TopcoatLightMobileTheme/source"/>
			<arg value="-external-library-path+=${dependency.output}"/>
			<arg value="-external-library-path+=${output.path}/${swc.file}"/>
			<arg value="-output=${themes.output}/TopcoatLightMobileTheme/swc/TopcoatLightMobileTheme.swc"/>
		</java>
	</target>

	<target name="-includes">
		<echo message="Copying Feathers source code"/>
		<copy overwrite="true" todir="${source.output}">
			<fileset dir="${source.root}"/>
		</copy>
				
		<echo message="Copying informational documents"/>
		<copy overwrite="true" todir="${output.path}">
			<fileset dir="${basedir}">
				<include name="README.md"/>
				<include name="LICENSE.md"/>
				<include name="CHANGELOG.md"/>
			</fileset>
		</copy>

		<echo message="Copying theme source code and assets"/>

		<copy overwrite="true" todir="${themes.output}/AeonDesktopTheme">
			<fileset dir="${themes.root}/AeonDesktopTheme">
				<include name="README.md"/>
				<include name="source/**"/>
				<include name="assets/**"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${themes.output}/MetalWorksDesktopTheme">
			<fileset dir="${themes.root}/MetalWorksDesktopTheme">
				<include name="README.md"/>
				<include name="source/**"/>
				<include name="assets/**"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${themes.output}/MetalWorksMobileTheme">
			<fileset dir="${themes.root}/MetalWorksMobileTheme">
				<include name="README.md"/>
				<include name="source/**"/>
				<include name="assets/**"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${themes.output}/MinimalDesktopTheme">
			<fileset dir="${themes.root}/MinimalDesktopTheme">
				<include name="README.md"/>
				<include name="source/**"/>
				<include name="assets/**"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${themes.output}/MinimalMobileTheme">
			<fileset dir="${themes.root}/MinimalMobileTheme">
				<include name="README.md"/>
				<include name="source/**"/>
				<include name="assets/**"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${themes.output}/TopcoatLightMobileTheme">
			<fileset dir="${themes.root}/TopcoatLightMobileTheme">
				<include name="README.md"/>
				<include name="source/**"/>
				<include name="assets/**"/>
			</fileset>
		</copy>

		<echo message="Copying examples"/>

		<copy overwrite="true" todir="${examples.output}/ComponentsExplorer">
			<fileset dir="${examples.root}/ComponentsExplorer">
				<include name="README.md"/>
				<include name="source/**"/>
				<include name="assets/**"/>
				<exclude name="source/ComponentsExplorerWeb.as"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${examples.output}/DrawersExplorer">
			<fileset dir="${examples.root}/DrawersExplorer">
				<include name="README.md"/>
				<include name="source/**"/>
				<exclude name="source/DrawersExplorerWeb.as"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${examples.output}/DragAndDrop">
			<fileset dir="${examples.root}/DragAndDrop">
				<include name="README.md"/>
				<include name="source/**"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${examples.output}/Gallery">
			<fileset dir="${examples.root}/Gallery">
				<include name="README.md"/>
				<include name="source/**"/>
				<exclude name="source/GalleryWeb.as"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${examples.output}/HelloWorld">
			<fileset dir="${examples.root}/HelloWorld">
				<include name="README.md"/>
				<include name="source/**"/>
				<include name="assets/**"/>
				<exclude name="source/HelloWorldWeb.as"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${examples.output}/LayoutExplorer">
			<fileset dir="${examples.root}/LayoutExplorer">
				<include name="README.md"/>
				<include name="source/**"/>
				<exclude name="source/LayoutExplorerWeb.as"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${examples.output}/Magic8Chat">
			<fileset dir="${examples.root}/Magic8Chat">
				<include name="README.md"/>
				<include name="source/**"/>
				<include name="assets/**"/>
				<exclude name="source/Magic8ChatWeb.as"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${examples.output}/PullToRefresh">
			<fileset dir="${examples.root}/PullToRefresh">
				<include name="README.md"/>
				<include name="assets/**"/>
				<include name="source/**"/>
				<exclude name="source/PullToRefreshWeb.as"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${examples.output}/StackScreenNavigatorExplorer">
			<fileset dir="${examples.root}/StackScreenNavigatorExplorer">
				<include name="README.md"/>
				<include name="source/**"/>
				<exclude name="source/StackScreenNavigatorExplorerWeb.as"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${examples.output}/Tabs">
			<fileset dir="${examples.root}/Tabs">
				<include name="README.md"/>
				<include name="source/**"/>
				<include name="assets/**"/>
				<exclude name="source/TabsWeb.as"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${examples.output}/TileList">
			<fileset dir="${examples.root}/TileList">
				<include name="README.md"/>
				<include name="source/**"/>
				<include name="assets/**"/>
				<exclude name="source/TileListWeb.as"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${examples.output}/Todos">
			<fileset dir="${examples.root}/Todos">
				<include name="README.md"/>
				<include name="source/**"/>
				<exclude name="source/TodosWeb.as"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${examples.output}/TrainTimes">
			<fileset dir="${examples.root}/TrainTimes">
				<include name="README.md"/>
				<include name="source/**"/>
				<include name="assets/**"/>
				<exclude name="source/TrainTimesWeb.as"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${examples.output}/TransitionsExplorer">
			<fileset dir="${examples.root}/TransitionsExplorer">
				<include name="README.md"/>
				<include name="source/**"/>
				<include name="assets/**"/>
				<exclude name="source/TransitionsExplorerWeb.as"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${examples.output}/Video">
			<fileset dir="${examples.root}/Video">
				<include name="README.md"/>
				<include name="source/**"/>
			</fileset>
		</copy>

		<copy overwrite="true" todir="${examples.output}/YouTubeFeeds">
			<fileset dir="${examples.root}/YouTubeFeeds">
				<include name="README.md"/>
				<include name="source/**"/>
				<exclude name="source/YouTubeFeedsWeb.as"/>
			</fileset>
		</copy>
	</target>

	<target name="-test" depends="-feathers" unless="skip-tests">
		<java jar="${mxmlc}" dir="${test.root}/source" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-library-path+=${dependency.output}"/>
			<arg value="-library-path+=${flexunit.root}"/>
			<arg value="-library-path+=${output.path}"/>
			<arg value="-output=${dependency.output}/TestFeathers.swf"/>
			<arg value="TestFeathers.as"/>
		</java>
		<copy todir="${dependency.output}">
			<fileset file="${test.root}/source/TestFeathers-app.xml"/>
		</copy>
		<copy todir="${dependency.output}/fixtures">
			<fileset dir="${test.root}/fixtures"/>
		</copy>
    	<condition property="adl.file" value="adl.exe">
        	<os family="windows"/>
		</condition>
		<property name="adl.file" value="adl"/>
		<condition property="flexunit.command" value="${flashplayer}">
			<isset property="flashplayer"/>
		</condition>
		<condition property="flexunit.swf" value="${dependency.output}/TestFeathers.swf">
			<isset property="flashplayer"/>
		</condition>
		<property name="flexunit.command" value="${flashsdk.bin}/${adl.file}"/>
		<property name="flexunit.swf" value="${dependency.output}/TestFeathers-app.xml"/>
		<flexunit
			command="${flexunit.command}"
			player="flash"
			swf="${flexunit.swf}"
			haltonfailure="true"
			verbose="true"
			toDir="${dependency.output}"/>
	</target>
    
    <macrodef name="apm">
        <attribute name="src"/>
        <attribute name="swc"/>
        <attribute name="readme"/>
        <attribute name="changelog" default=""/>
        <attribute name="package-swc"/>
        <attribute name="package-src"/>
            <sequential>
				<fail unless="apm" message="Path to apm executable is missing."/>
				<copy overwrite="true" file="@{swc}" todir="${output.path}/apm/swc"/>
				<copy overwrite="true" file="@{package-swc}" tofile="${output.path}/apm/package.json"/>
				<copy overwrite="true" todir="${output.path}/apm">
					<fileset file="@{readme}"/>
					<fileset file="@{changelog}"/>
					<fileset file="${basedir}/LICENSE.md"/>
				</copy>

				<copy overwrite="true" todir="${output.path}/apm-src/src">
					<fileset dir="@{src}"/>
				</copy>
				<copy overwrite="true" file="@{package-src}" tofile="${output.path}/apm-src/package.json"/>
				<copy overwrite="true" todir="${output.path}/apm-src">
					<fileset file="@{readme}"/>
					<fileset file="@{changelog}"/>
					<fileset file="${basedir}/LICENSE.md"/>
				</copy>

				<exec executable="${apm}" dir="${output.path}" failonerror="true">
					<arg value="build"/>
					<arg value="apm"/>
				</exec>
				<exec executable="${apm}" dir="${output.path}" failonerror="true">
					<arg value="build"/>
					<arg value="apm-src"/>
				</exec>

				<delete includeemptydirs="true">
					<fileset dir="${output.path}/apm"/>
					<fileset dir="${output.path}/apm-src"/>
				</delete>
        </sequential>
    </macrodef>

	<target name="-apm" depends="-feathers,-themes">
		<apm src="${source.root}"
			swc="${output.path}/${swc.file}"
			readme="README.md"
			changelog="CHANGELOG.md"
			package-swc="package-swc.json"
			package-src="package-src.json"/>
		<apm src="${themes.root}/AeonDesktopTheme/source"
			swc="${themes.output}/AeonDesktopTheme/swc/AeonDesktopTheme.swc"
			readme="${themes.root}/AeonDesktopTheme/README.md"
			package-swc="${themes.root}/AeonDesktopTheme/package-swc.json"
			package-src="${themes.root}/AeonDesktopTheme/package-src.json"/>
		<apm src="${themes.root}/MetalWorksDesktopTheme/source"
			swc="${themes.output}/MetalWorksDesktopTheme/swc/MetalWorksDesktopTheme.swc"
			readme="${themes.root}/MetalWorksDesktopTheme/README.md"
			package-swc="${themes.root}/MetalWorksDesktopTheme/package-swc.json"
			package-src="${themes.root}/MetalWorksDesktopTheme/package-src.json"/>
		<apm src="${themes.root}/MetalWorksMobileTheme/source"
			swc="${themes.output}/MetalWorksMobileTheme/swc/MetalWorksMobileTheme.swc"
			readme="${themes.root}/MetalWorksMobileTheme/README.md"
			package-swc="${themes.root}/MetalWorksMobileTheme/package-swc.json"
			package-src="${themes.root}/MetalWorksMobileTheme/package-src.json"/>
		<apm src="${themes.root}/MinimalDesktopTheme/source"
			swc="${themes.output}/MinimalDesktopTheme/swc/MinimalDesktopTheme.swc"
			readme="${themes.root}/MinimalDesktopTheme/README.md"
			package-swc="${themes.root}/MinimalDesktopTheme/package-swc.json"
			package-src="${themes.root}/MinimalDesktopTheme/package-src.json"/>
		<apm src="${themes.root}/MinimalMobileTheme/source"
			swc="${themes.output}/MinimalMobileTheme/swc/MinimalMobileTheme.swc"
			readme="${themes.root}/MinimalMobileTheme/README.md"
			package-swc="${themes.root}/MinimalMobileTheme/package-swc.json"
			package-src="${themes.root}/MinimalMobileTheme/package-src.json"/>
		<apm src="${themes.root}/TopcoatLightMobileTheme/source"
			swc="${themes.output}/TopcoatLightMobileTheme/swc/TopcoatLightMobileTheme.swc"
			readme="${themes.root}/TopcoatLightMobileTheme/README.md"
			package-swc="${themes.root}/TopcoatLightMobileTheme/package-swc.json"
			package-src="${themes.root}/TopcoatLightMobileTheme/package-src.json"/>
	</target>
</project>

================================================
FILE: documentation/README.md
================================================
# Documentation

The *api-reference* folder contains a custom template for the [API reference](https://feathersui.com/api-reference/).

The Markdown help files that were previously in the *help* folder have been moved to the [feathersui-website](https://github.com/BowlerHatLLC/feathersui-website/tree/master/docs/as3-starling) repository.

================================================
FILE: documentation/api-reference/package-descriptions.xml
================================================
<overviews>
	<packages>
		<package name="feathers.display"> 
			<shortDescription><![CDATA[A variety of custom Starling display objects.]]></shortDescription>
		</package>
		<package name="feathers.textures"> 
			<shortDescription><![CDATA[Textures for custom Starling display objects.]]></shortDescription>
		</package>
		<package name="feathers.controls"> 
			<shortDescription><![CDATA[User interface controls and containers.]]></shortDescription>
		</package>
		<package name="feathers.controls.color"> 
			<shortDescription><![CDATA[User interface controls for working with colors.]]></shortDescription>
		</package>
		<package name="feathers.controls.supportClasses"> 
			<shortDescription><![CDATA[Supporting classes and interfaces used by Feathers user interface components.]]></shortDescription>
		</package>
		<package name="feathers.controls.popups"> 
			<shortDescription><![CDATA[Managers for the display of pop-up sub-components.]]></shortDescription>
		</package>
		<package name="feathers.controls.text"> 
			<shortDescription><![CDATA[Text rendering sub-components.]]></shortDescription>
		</package>
		<package name="feathers.controls.renderers"> 
			<shortDescription><![CDATA[Data renderers for list controls.]]></shortDescription>
		</package>
		<package name="feathers.core"> 
			<shortDescription><![CDATA[Base classes and interfaces used by Feathers.]]></shortDescription>
		</package>
		<package name="feathers.data"> 
			<shortDescription><![CDATA[Collections used by Feathers to display data.]]></shortDescription>
		</package>
		<package name="feathers.dragDrop"> 
			<shortDescription><![CDATA[Classes related to drag and drop operations.]]></shortDescription>
		</package>
		<package name="feathers.events"> 
			<shortDescription><![CDATA[Contains classes to related to Feathers events.]]></shortDescription>
		</package>
		<package name="feathers.layout"> 
			<shortDescription><![CDATA[A variety of layout algorithms used to customize Feathers controls and containers.]]></shortDescription>
		</package>
		<package name="feathers.media"> 
			<shortDescription><![CDATA[User interface controls for media playback.]]></shortDescription>
		</package>
		<package name="feathers.skins"> 
			<shortDescription><![CDATA[Classes related to skinning and themes in Feathers.]]></shortDescription>
		</package>
		<package name="feathers.text"> 
			<shortDescription><![CDATA[Contains classes for working with text.]]></shortDescription>
		</package>
		<package name="feathers.motion"> 
			<shortDescription><![CDATA[Classes related to motion, tweens, and animation.]]></shortDescription>
		</package>
		<package name="feathers.motion.effectClasses"> 
			<shortDescription><![CDATA[Supporting classes and interfaces used by effects.]]></shortDescription>
		</package>
		<package name="feathers.system"> 
			<shortDescription><![CDATA[Higher level queries for system-level capabilities.]]></shortDescription>
		</package>
		<package name="feathers.themes"> 
			<shortDescription><![CDATA[Classes related to theming and styling components.]]></shortDescription>
		</package>
		<package name="feathers.utils"> 
			<shortDescription><![CDATA[Utility classes and function.]]></shortDescription>
		</package>
		<package name="feathers.utils.display"> 
			<shortDescription><![CDATA[Utilities for working with display objects.]]></shortDescription>
		</package>
		<package name="feathers.utils.focus"> 
			<shortDescription><![CDATA[Utilities for focus management.]]></shortDescription>
		</package>
		<package name="feathers.utils.geom"> 
			<shortDescription><![CDATA[Utilities for working with geometrical calculations.]]></shortDescription>
		</package>
		<package name="feathers.utils.keyboard"> 
			<shortDescription><![CDATA[Utilities for working with the keyboard.]]></shortDescription>
		</package>
		<package name="feathers.utils.math"> 
			<shortDescription><![CDATA[Utilities for common mathematical calculations.]]></shortDescription>
		</package>
		<package name="feathers.utils.skins"> 
			<shortDescription><![CDATA[Utilities for skinning.]]></shortDescription>
		</package>
		<package name="feathers.utils.text"> 
			<shortDescription><![CDATA[Utilities for text components.]]></shortDescription>
		</package>
		<package name="feathers.utils.textures"> 
			<shortDescription><![CDATA[Utilities for working with textures.]]></shortDescription>
		</package>
		<package name="feathers.utils.touch"> 
			<shortDescription><![CDATA[Utilities for working with touches.]]></shortDescription>
		</package>
		<package name="feathers.utils.xml"> 
			<shortDescription><![CDATA[Utilities for working with XML and E4X.]]></shortDescription>
		</package>
	</packages>
</overviews>

================================================
FILE: documentation/api-reference/templates/AC_OETags.js
================================================
////////////////////////////////////////////////////////////////////////////////
//
//  ADOBE SYSTEMS INCORPORATED
//  Copyright 2008 Adobe Systems Incorporated
//  All Rights Reserved.
//
//  NOTICE: Adobe permits you to use, modify, and distribute this file
//  in accordance with the terms of the license agreement accompanying it.
//
////////////////////////////////////////////////////////////////////////////////


//v1.0
function AC_AddExtension(src, ext)
{
  if (src.indexOf('?') != -1)
    return src.replace(/\?/, ext+'?'); 
  else
    return src + ext;
}

function AC_Generateobj(objAttrs, params, embedAttrs) 
{ 
  var str = '<object ';
  for (var i in objAttrs)
    str += i + '="' + objAttrs[i] + '" ';
  str += '>';
  for (var i in params)
    str += '<param name="' + i + '" value="' + params[i] + '" /> ';
  str += '<embed ';
  for (var i in embedAttrs)
    str += i + '="' + embedAttrs[i] + '" ';
  str += ' ></embed></object>';

  document.write(str);
}

function AC_FL_RunContent(){
  var ret = 
    AC_GetArgs
    (  arguments, ".swf", "movie", "clsid:d27cdb6e-ae6d-11cf-96b8-444553540000"
     , "application/x-shockwave-flash"
    );
  AC_Generateobj(ret.objAttrs, ret.params, ret.embedAttrs);
}

function AC_GetArgs(args, ext, srcParamName, classid, mimeType){
  var ret = new Object();
  ret.embedAttrs = new Object();
  ret.params = new Object();
  ret.objAttrs = new Object();
  for (var i=0; i < args.length; i=i+2){
    var currArg = args[i].toLowerCase();    

    switch (currArg){	
      case "classid":
        break;
      case "pluginspage":
        ret.embedAttrs[args[i]] = args[i+1];
        break;
      case "src":
      case "movie":	
        args[i+1] = AC_AddExtension(args[i+1], ext);
        ret.embedAttrs["src"] = args[i+1];
        ret.params[srcParamName] = args[i+1];
        break;
      case "onafterupdate":
      case "onbeforeupdate":
      case "onblur":
      case "oncellchange":
      case "onclick":
      case "ondblClick":
      case "ondrag":
      case "ondragend":
      case "ondragenter":
      case "ondragleave":
      case "ondragover":
      case "ondrop":
      case "onfinish":
      case "onfocus":
      case "onhelp":
      case "onmousedown":
      case "onmouseup":
      case "onmouseover":
      case "onmousemove":
      case "onmouseout":
      case "onkeypress":
      case "onkeydown":
      case "onkeyup":
      case "onload":
      case "onlosecapture":
      case "onpropertychange":
      case "onreadystatechange":
      case "onrowsdelete":
      case "onrowenter":
      case "onrowexit":
      case "onrowsinserted":
      case "onstart":
      case "onscroll":
      case "onbeforeeditfocus":
      case "onactivate":
      case "onbeforedeactivate":
      case "ondeactivate":
      case "type":
      case "codebase":
        ret.objAttrs[args[i]] = args[i+1];
        break;
      case "width":
      case "height":
      case "align":
      case "vspace": 
      case "hspace":
      case "class":
      case "title":
      case "accesskey":
      case "name":
      case "id":
      case "tabindex":
        ret.embedAttrs[args[i]] = ret.objAttrs[args[i]] = args[i+1];
        break;
      default:
        ret.embedAttrs[args[i]] = ret.params[args[i]] = args[i+1];
    }
  }
  ret.objAttrs["classid"] = classid;
  if (mimeType) ret.embedAttrs["type"] = mimeType;
  return ret;
}



================================================
FILE: documentation/api-reference/templates/ASDoc_Config_Base.xml
================================================
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2006-2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<!-- this file normally should not be edited.  Use the command-line
     parameters for ASDoc instead -->
<asDocConfig>
  <options buildNum="asd3_0_final_1" verbose="false" livedocs="false" standalone="true" eclipse="false" docversion="3" includePrivate="false" splitIndex="true" showVersions="true" showConventions="false" showReview="true" />

  <keywords show="false" num="500" />
<!--
  <feedback show="false" type="livedocs">
    <feedbackEmail>
        <label>Submit Feedback</label>
        <address>foo@foo.com</address>
    </feedbackEmail>
  </feedback>
-->
  <warnings langversion="false" playerversion="false" xref="true" />
	<!-- <includeExamplesDirectory></includeExamplesDirectory> -->

  <xmlInputFile>toplevel.xml</xmlInputFile>
  <title>API Documentation</title>
  <windowTitle>API Documentation</windowTitle>

  <languageElements show="false" constants="true" functions="true" operators="false" statements="false" specialTypes="false" />
	<footer></footer>
  <namespaces hideAll="false">
    <namespace hide="false" summaryDisplay="public">AS3</namespace>
    <namespace hide="true">mx_internal</namespace>
    <namespace hide="false" summaryDisplay="protected">flash_proxy</namespace>
    <namespace hide="false" summaryDisplay="protected">object_proxy</namespace>
    <namespace hide="false">mx_inner</namespace>
    <namespace hide="false" summaryDisplay="public">flash10</namespace>
  </namespaces>
<!--
  <packages hideAll="false">
    <asPackage hide="false">adobe.utils</asPackage>
    <asPackage hide="true">flash.debugger</asPackage>
    <asPackage hide="true">macromedia.util</asPackage>
  </packages>
-->
<!--
  <annotate>
    <item type="package" name="mx.charts">
        <annotation type="text">(Flex Data Visualization components only)</annotation>
    </item>
  </annotate>
-->
</asDocConfig>

================================================
FILE: documentation/api-reference/templates/ASDoc_terms.xml
================================================
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<dita>
  <topic DTDVersion="V1.1.3"
          domains="(topic hi-d) (topic pr-d) (topic sw-d) (topic adobe-d)"
          class="- topic/topic "
          id="WS58b67d046ae8e03c15f1d0a110e67a7921-8000">
      <title class="- topic/title ">Localizable Terms</title>
      <body class="- topic/body "/>
      <reference DTDVersion="V1.1.3"
                 domains="(topic hi-d) (topic pr-d) (topic sw-d) (topic adobe-d)"
                 class="- topic/topic       reference/reference "
                 id="WS58b67d046ae8e03c15f1d0a110e67a7921-7fff">
         <title class="- topic/title ">Localizable Terms</title>
         <refbody class="- topic/body        reference/refbody ">
            <adobetable frame="all" colsep="0" rowsep="1" class="+ topic/table adobe-d/adobetable ">
               <tgroup cols="2" colsep="0" rowsep="1" outputclass="2col.small.table"
                       class="- topic/tgroup ">
                  <colspec colnum="1" colname="1" colwidth="1.167in" colsep="0" class="- topic/colspec "/>
                  <colspec colnum="2" colname="2" colwidth="2.041in" colsep="0" class="- topic/colspec "/>
                  <thead class="- topic/thead ">
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Key (or Paragraph tag)</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Value</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Comment</p>
                        </entry>
                     </row>
                  </thead>
                  <tbody>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">AS1tooltip</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Tooltip for AS1 compatible examples</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Tooltip for AS1 compatible examples</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">AS2tooltip</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">This example requires ActionScript 2.0</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Tooltip for AS2 compatible examples</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">AS3tooltip</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">This example requires ActionScript 3.0</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Tooltip for AS3 compatible examples</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Type</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Type</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Type</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Format</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Format</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Format</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">CSSInheritance</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">CSS Inheritance</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">CSS Inheritance</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Properties</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Properties</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for properties</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Property</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">property</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for property</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PropertyProperty</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Property</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for property</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PropertyDetail</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Property Detail</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for property</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Constructor</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Constructor</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for constructor</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ConstructorDetail</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Constructor Detail</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for constructor</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">MethodDetail</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Method Detail</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">MethodDetail</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Methods</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Methods</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for methods</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">MethodMethod</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Method</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">text for method</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Method</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">method</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">text for method</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Functions</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Functions</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for functions</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FunctionFunction</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Function</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">text for function</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Function</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">function</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">text for function</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Events</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Events</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for events</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Event</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Event</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">text for event</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Styles</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Styles</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for styles</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Style</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">style</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">text for style</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">StyleStyle</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Style</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">text for style</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">StyleDetail</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Style Detail</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for style</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Effects</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Effects</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for effects</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Effect</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Effect</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">text for effect</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Constants</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Constants</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for constants</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Constant</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Constant</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">text for constant</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ConstantDetail</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Constant Detail</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">text for constant detail</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Interfaces</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Interfaces</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for interfaces</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Interface</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Interface</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">text for interface</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Classes</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Classes</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for classes</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ClassClass</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Class</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">*NAME* class </p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Use</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Use</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for use</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Usage</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Usage</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for usage</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Example</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Example</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for examples</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Examples</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Examples</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for examples</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ViewExamples</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">View the examples</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">View the examples</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">searchLivedocs</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Search</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Search LiveDocs links</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">allPackages</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">All Packages</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for All Packages links</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">allMXPackages</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">All MX Packages</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for All MX Packages links</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">allFlashPlayerPackages</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">All Flash Packages</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for All Flash Packages links</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">allClasses</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">All Classes</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for All Classes links</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">allMXClasses</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">All MX Classes</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for All MX Classes links</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">allFlashClasses</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">All Flash Classes</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for All Flash Classes links</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">LanguageElements</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Language Elements</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Language Elements links</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">LanguageElement</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Language Element</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Language Element table header</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Index</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Index</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Index links</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">deprecated_index</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">deprecated_index</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for deprecated_index</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Appendix</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Appendixes</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Appendixes links</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Description</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Description</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Appendixes links</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Conventions</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Conventions</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Conventions links</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Frames</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Frames</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for link to frames version of help</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">NoFrames</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">No Frames</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for link to no frames version of help</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">MXMLOnly</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">MXML Only Components</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for link to MXML Only Components</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">MXML Only Components</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">MXML Only Components</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for link to MXML Only Components</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">SQLSupportInLocalDatabases</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">SQL support in local databases</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for SQL support in local databases</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">SQL support in local databases</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">SQL support in local databases</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for SQL support in local databases</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">MXMLSyntax</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">MXML Syntax</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for MXML Syntax</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ShowMXMLSyntax</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Show MXML Syntax</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Show MXML Syntax</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">HideMXMLSyntax</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Hide MXML Syntax</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Hide MXML Syntax</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PlayerVersion</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Player Version</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for player version label</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">oldPlayerVersion</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Runtime Versions</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for player version label</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">LanguageVersion</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Language Version</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for language version label</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">andLater</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">??</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Suffix for "ActionScript N and later"</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">seeAlso</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">See also</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">See also header</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">All</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">All</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for all index</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Unsupported</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Unsupported</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Unsupported</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">TopLevel</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Top Level</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Top Level link</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">fscommand2</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">&lt;a href="global_functions.html#fscommand2()"&gt;fscommand2&lt;/a&gt;fscommand2</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for fscommand2 link</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Operator</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Operator</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Operator link</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Operators</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Operators</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Operator link</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Statement</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Statement</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Statement link</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">statement</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Statement</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for statement type in statements.xsl</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Statements</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Statements</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Statement link</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">SpecialType</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Special Type</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Special Type link</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">SpecialTypes</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Special Types</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Special Types</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">SpecialTypeDetail</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Special Type Detail</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Special Type Detail</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DeprecatedText</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Deprecated Text</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Deprecated classes</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DeprecatedClassesHeader</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Deprecated Classes</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for Deprecated classes</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DeprecatedFunctionHeader</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Deprecated Function</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for Deprecated Functions</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DeprecatedMethodHeader</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Deprecated Methods</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for Deprecated Methods</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DeprecatedPropertiesHeader</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Deprecated Properties</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for Deprecated Properties</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DeprecatedStylesHeader</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Deprecated Styles</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for Deprecated Styles</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DeprecatedOperatorsHeader</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Deprecated Operators</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Header for Deprecated Operators</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DeprecatedAsOf</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Deprecated</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Deprecated classes with a version</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DeprecatedIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Deprecated</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Deprecated classes with a version</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">StaticMethodIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Static Method                  </p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Static method</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">MethodIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Method                  </p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for method</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PackageStaticFunctionIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Package Static Function</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for static function in package</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PackageFunctionIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Package Function</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for function in package</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">CompilerDirective</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Compiler Directive</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Compiler Directive</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">CompilerDirectives</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Compiler Directives</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Compiler Directives</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Protected</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Protected</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Protected</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Public</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Public</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Public</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Global</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Global</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Global</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">GlobalFunction</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Global Function</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for GlobalFunction</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">GlobalFunctions</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Global Functions</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for GlobalFunction</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">GlobalProperties</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Global Properties</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Global Properties</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ConstructorInClass</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Constructor</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for constructor in class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ConstantStaticPropertyIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Constant Static Property</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for constant static property in class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">StaticPropertyIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Static Property</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for static property in class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PropertyIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Property</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Property in class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ConstantPropertyIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Constant Property</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Constant property in class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PackageConstantStaticPropertyIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Package Constant Static Property</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Package constant static property in class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PackageConstantPropertyIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Package Constant Property</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Package static property in class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ConstantProperty</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Constant Property</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">constant property</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">GlobalProperty</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Global property</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Global property</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">EventHandlerIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Event handler                  </p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Event handler in </p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">EventListenerIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Event Listener                  </p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Event Listener in</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">EventIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Event</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Event in</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">GlobalEventHandler</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Global event handler</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Global event handler</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">GlobalEventListener</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Global event listener</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Global event listener</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FinalDynamicClass</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">final dynamic class</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Final dynamic class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FinalClass</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">final class</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Final class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DynamicClass</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">dynamic class</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">dynamic class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">InterfaceIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">interface</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">interface</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ClassIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">class</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FinalDynamicClassIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">final dynamic class</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">final dynamic class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FinalDynamicClassIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">final dynamic class</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">final dynamic class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FinalClassIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Final Class</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">final class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DynamicClassIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Dynamic Class</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">dynamic class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Package</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">package</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">package</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PackagePackage</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Package</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">*NAME* package</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Packages</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Packages</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">package</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">InnerClassSummary</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Inner Class summary</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Inner Class summary</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">HideInheritedPublicConstants</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Hide Inherited Public Constants</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Hide Inherited Public Constants</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ShowInheritedPublicConstants</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Show Inherited Public Constants</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Show Inherited Public Constants</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">HideInheritedProtectedConstants</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Hide Inherited Protected Constants</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Hide Inherited Protected Constants</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ShowInheritedProtectedConstants</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Show Inherited Protected Constants</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Show Inherited Protected Constants</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">HideInheritedPublicProperties</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Hide Inherited Public Properties</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Hide Inherited Public Properties</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ShowInheritedPublicProperties</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Show Inherited Public Properties</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Show Inherited Public Properties</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">HideInheritedPublicMethods</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Hide Inherited Public Methods</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Hide Inherited Public Methods</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ShowInheritedPublicMethods</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Show Inherited Public Methods</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Show Inherited Public Methods</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">HideInheritedProtectedMethods</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Hide Inherited Protected Methods</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Hide Inherited Protected Methods</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ShowInheritedProtectedMethods</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Show Inherited Protected Methods</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Show Inherited Protected Methods</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">HideInheritedProtectedProperties</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Hide Inherited Protected Properties</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Hide Inherited Protected Properties</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ShowInheritedProtectedProperties</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Show Inherited Protected Properties</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Show Inherited Protected Properties</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">HideInheritedEffects</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Hide Inherited Effects</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Hide Inherited Effects</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ShowInheritedEffects</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Show Inherited Effects</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Show Inherited Effects</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">HideInheritedEvents</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Hide Inherited Events</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Hide Inherited Events</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ShowInheritedEvents</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Show Inherited Events</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Show Inherited Events</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">TriggeringEvent</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Triggering Event</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for TriggeringEvent</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DefaultValueIs</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> The default value is</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for The default value is </p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Style_States_2</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">You can use the skin style to assign the skin for the following skin states:</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for The default value is </p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DataBinding</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">This property can be used as the source for data binding.</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for This property can be used as the source for data binding.</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Implementation</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Implementation</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Implementation</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">HideInheritedStyles</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Hide Inherited Styles</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Hide Inherited Styles</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ShowInheritedStyles</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Show Inherited Styles</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Show Inherited Styles</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">InheritedFrom</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Inherited From</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p "> Text for inherited from class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DefaultMXMLProperty</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Default MXML Property</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Default MXML Property</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Inheritance</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Inheritance</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Inheritance</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Implementors</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Implementors</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Implementors</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">CompilerErrors</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Compiler Errors</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Compiler Errors</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">CompilerWarnings</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Compiler Warnings</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Compiler Warnings</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">RunTimeErrors</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Runtime Errors</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Runtime Errors</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">CharacterSetCodes</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Character Set Codes</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Character Set Codes</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">MotionXMLElements</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Motion XML Elements</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Motion XML Elements</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Timed Text XML Formats</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Timed Text XML Formats</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Timed Text XML Formats</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ExampleInstruct</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Using examples in the ActionScript 3.0 Language Reference</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Example Instruct</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Using examples in the ActionScript 3.0 Language and Components Reference</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Using examples in the ActionScript 3.0 Language and Components Reference</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Using examples in the ActionScript 3.0 Language and Components Reference</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ActionScript2Migration</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">ActionScript 2.0 Migration</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for ActionScript 2.0 Migration</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">StatementsKeywordsDirectives</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Statements, Keywords &amp; Directives</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Statements, Keywords &amp; Directives</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">StatementsKeywordsDirectiveDetail</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Statements, Keywords &amp; Directive detail</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Statements, Keywords &amp; Directives</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">StatementsKeywords</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Statements and Keywords</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Statements and Keywords</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FunctionsMethods</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Functions and Methods</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Functions and Methods</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Symbols</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Symbols</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for symbols (index letter list)</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Code</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Code</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Code</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Message</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Message</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Message</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">InvalidActionScriptNote</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">* Note: This error indicates that the ActionScript in the SWF is invalid. If you believe that the file has not been corrupted, please report the problem to Adobe.</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">* Note: This error indicates that the ActionScript in the SWF is invalid. If you believe that the file has not been corrupted, please report the problem to Adobe.</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Comments</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Comments</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Comments</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">OperatorDetail</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Operator Detail</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">OperatorDetail</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">EventDetail</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Event Detail</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Event Detail</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">EventObjectType</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Event Object Type</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Event Object Type</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Result</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Result</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Result</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Operands</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Operands</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Operands</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Parameters</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Parameters</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Parameters</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">TopLevelConstantsFunctions</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Top Level Constants and Functions</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Top Level Constants and Functions</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Details</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Details</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Details</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Summary</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Summary</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Summary</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PackageList</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Package List</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">PackageList</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DefinedBy</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Defined By</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">PackageList</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Throws</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Throws</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Throws</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Returns</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Returns</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Returns</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">StaticTypeDefinedInClass</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Static Type Defined In Class</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Returns</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">definition keyword</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Definition keyword</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">definition keyword</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">primary expression keyword</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Primary expression keyword</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">primary expression keyword</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">directive</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Directive</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">directive</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">attribute keyword</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Attribute Keyword</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Attribute Keyword</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">namespace</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Namespace</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">namespace</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">comment</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Comment</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">comment</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">arithmetic</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Arithmetic</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">arithmetic</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">string</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">String</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">string</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">assignment</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Assignment</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">assignment</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">arithmetic compound assignment</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Arithmetic compound assignment</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">arithmetic compound assignment</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">bitwise compound assignment</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Bitwise compound assignment</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">bitwise compound assignment</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">bitwise</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Bitwise</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">bitwise</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">comparison</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Comparison</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">comparison</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">logical</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Logical</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">logical</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">XML</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">XML</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">XML</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">other</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Other</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">other</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Supported Character Sets</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Supported Character Sets</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Supported Character Sets</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Binding</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Binding</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Binding</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Component</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Component</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Component</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Metadata</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Metadata</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Metadata</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Model</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Model</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Model</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Script</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Script</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Script</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">XMLList</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">XMLList</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">XMLList</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">UseExamples</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">How to use examples</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Link for example blocks to example use instructions.</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Book_Title</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">ActionScript 3.0 Language and Components Reference</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">ActionScript 3.0 Language and Components Reference</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Book_Directory</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">ActionScriptLangRefV3</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">ActionScriptLangRefV3</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Book_Categories</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">languagereferences,as3,components3</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">languagereferences,as3,components3</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Book_Language</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">en</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">en</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Book_Version</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">3.0</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">3.0</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Book_Sort</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">mm_3</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">mm_3</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Lang_Elements_Name</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Language Elements</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Language Elements</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_All_Classes</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">All Classes</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">All Classes</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_All_Packages</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">All Packages</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">All Packages</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Top_Level_Classes</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Top Level classes</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Top Level classes</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Appendixes_Name</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Appendixes</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Appendixes</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Appendixes_Tip_Text</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Link to list of Appendixes</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Link to list of Appendixes</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Conventions_Name</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Conventions</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Conventions</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Conventions_Tip_Text</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Link to list of Conventions</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Link to list of Conventions</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Index_Name</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Index</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Index</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Index_Tip_Text</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Index of all classes, methods, properties and language elements</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Index of all classes, methods, properties and language elements</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Interface</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">interface</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">interface</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Class</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">class</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Constructor</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Constructor</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Constructor</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Methods</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Methods</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Methods</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Properties</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Properties</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Properties</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Events</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Events</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Events</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Operators</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Operators</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Operators</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_StatementsKeywordsDirectives</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Statements, Keywords and Directives</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Statements, Keywords and Directives</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Special_Types</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Special Types</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Special Types</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Styles</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Styles</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Styles</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Global</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Global</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Global</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Functions</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Functions</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Functions</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FPH_Constants</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Constants</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Constants</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FunctionDetail</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Function detail</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">function detail</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DefinedIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Defined In </p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">defined in class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">AdobeLogo</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Feathers Logo</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">defined in class</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Implements</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Implements</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Implements</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Subclasses</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Subclasses</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Subclasses</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PleaseUse</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Please Use</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Please Use</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">GlobalConstants</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Global Constants</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Global Constants</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">GlobalProperties</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Global Properties</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Global Properties</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PublicConstants</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Public Constants</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Public Constants</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PublicProperties</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Public Properties</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Public Properties</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ProtectedConstants</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Protected Constants</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Protected Constants</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ProtectedProperties</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Protected Properties</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Protected Properties</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ProtectedMethods</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Protected Methods</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Protected Methods</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PublicMethods</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Public Methods</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Public Methods</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">GlobalMethods</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Global Methods</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Global Methods</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Pleaseuse</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Please use </p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Please use</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DeprecatedSince</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Deprecated Since</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Deprecated Since</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Deprecated</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Deprecated</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Deprecated</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">SymbolsIndex</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Symbols Index</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Symbols Index</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Compiler Errors</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Compiler Errors</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Compiler Errors</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Compiler Warnings</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Compiler Warnings</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Compiler Warnings</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Run-Time Errors</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Run-Time Errors</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Run-Time Errors</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ActionScript 2.0 Migration</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">ActionScript 2.0 Migration</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for ActionScript 2.0 Migration</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Character Set Codes</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Character Set Codes</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Character Set Codes</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Motion XML Elements</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Motion XML Elements</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Motion XML Elements</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Timed Text Tags</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Timed Text Tags</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Timed Text Tags</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Legal notices</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Legal notices</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Legal notices</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Legal Notices</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Legal Notices</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Legal Notices</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Using examples in the ActionScript 3.0 Language Reference</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Using examples in the ActionScript 3.0 Language Reference</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Using examples in the ActionScript 3.0 Language Reference</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">List of deprecated elements</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">List of deprecated elements</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for List of deprecated elements</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DefinedByProperties</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Defined By</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for "Defined By" column next to "Properties"</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DefinedByMethods</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Defined By</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for "Defined By" column next to "Methods"</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DefinedByEvents</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Defined By</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for "Defined By" column next to "Events"</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DefinedByStyles</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Defined By</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for "Defined By" column next to "Styles"</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">DefinedByEffects</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Defined By</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for "Defined By" column next to "Effects"</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">read</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">read</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for read</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">write</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">write</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for write</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">only</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">only</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for only</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">static</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">static</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for static</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FinalStaticPropertyIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Final static property</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Final static property</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">FinalPropertyIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Final property</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Final property</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PackageStaticPropertyIn</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Package static property</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Package static property</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ProductVersion</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Product Version</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for product version label</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ProductVersions</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Product Versions</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for product versions label</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Since</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Since</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for since label</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">windowruntimeproperty</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">window.runtime property</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">*JSLR*</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ShowInheritedProperties</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Show Inherited Properties</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">JSLR: Text for Show Inherited Properties</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ShowInheritedMethods</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Show Inherited Methods</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">JSLR: Text for Show Inherited Methods</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ShowInheritedConstants</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Show Inherited Constants</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">JSLR: Text for Show Inherited Constants</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">JSLR_Book_Title</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Adobe AIR Language Reference for HTML Developers</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">JSLR: Text for Title</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">JSLR_Index_Title</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">JavaScript Language Reference for The Adobe® Integrated Runtime (AIR™)</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">JSLR: Text for Title</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">SQLError_detail_messages</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">SQL error detail messages, ids, and arguments</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for SQLError detail messages</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">RuntimeVersions</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Runtime Versions</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Runtime Version label</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Acrobat</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Acrobat ActionScript API</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">long name for Acrobat.</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">SearchResults</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Search Results</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Search Results</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Search</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Search</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Search</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">terms_AHV_SHORT_WORDS</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Short and common words are excluded from the search database.</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for terms_AHV_SHORT_WORDS</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">terms_AHV_NO_SEARCH_TERM</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">No search term entered.</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for terms_AHV_NO_SEARCH_TERM</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">terms_AHV_MATCHES</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Pages containing:</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for terms_AHV_MATCHES</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">terms_AHV_NO_MATCHES</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">No pages contain:</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for terms_AHV_NO_MATCHES</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Override</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">override</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Override</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">SkinStates</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Skin States</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Skin States</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">SkinState</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Skin State</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Skin State</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">SkinParts</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Skin Parts</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Skin Parts</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">SkinPart</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Skin Part</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Skin Part</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">HideInheritedSkinStates</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Hide Inherited Skin States</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Hide Inherited Skin States</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ShowInheritedSkinStates</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Show Inherited Skin States</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Show Inherited Skin States</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">HideInheritedSkinParts</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Hide Inherited Skin Parts</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Hide Inherited Skin Parts</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">ShowInheritedSkinParts</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p "> Show Inherited Skin Parts</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Show Inherited Skin Parts</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">PartType</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Part Type</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Part Type</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Required</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Required</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Required</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Static</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Static</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Static</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Dynamic</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Dynamic</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Dynamic</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">skinpartprefixed</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">This component uses skins made up of skin parts. Do not set the skin parts directly. The component's skin sets the skin parts.</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for This component uses skins made up of skin parts. Do not set the skin parts directly. The component's skin sets the skin parts.</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">skinstateprefixed</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">To skin the component, implement a skin that defines the following states. Although you must implement all skin states, a skin state can be empty. An empty skin state specifies no changes to the default skin state.</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for To skin the component, implement a skin that defines the following states. Although you must implement all skin states, a skin state can be empty. An empty skin state specifies no changes to the default skin state.</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">dynpropdesc</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">The %type% must return an object of type</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for The %type% must return an object of type</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">unknown</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">unknown</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for unknown</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">howtouseevents</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Click for more information on events</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Click for more information on events</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">howtouseeffects</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Click for more information on effects</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Click for more information on effects</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">howtousestyles</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Click for more information on styles</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Click for more information on styles</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">howtouseskins</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Click for more information on skins</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Click for more information on skins</p>
                           </draft-comment>
                        </entry>
                     </row>

                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">Theme</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Theme</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Theme</p>
                           </draft-comment>
                        </entry>
                     </row>
                     <row rowsep="1" class="- topic/row ">
                        <entry colname="1" colsep="1" class="- topic/entry ">
                           <p translate="no" class="- topic/p ">altr.desc.1st</p>
                        </entry>
                        <entry colname="2" colsep="1" class="- topic/entry ">
                           <p class="- topic/p ">Starting with Flex %ver%, Adobe recommends that you use the %class% class as an alternative to this class.</p>
                        </entry>
                        <entry colname="3" class="- topic/entry ">
                           <draft-comment class="- topic/draft-comment ">
                              <p class="- topic/p ">Text for Starting with Flex %ver%, Adobe recommends that you use the %class% class as an alternative to this class.</p>
                           </draft-comment>
                        </entry>
                     </row>
                  </tbody>
               </tgroup>
            </adobetable>
         </refbody>
      </reference>
  </topic>
</dita>

================================================
FILE: documentation/api-reference/templates/ClassHeader.xslt
================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://sf.net/saxon" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ifn="urn:internal:functions" exclude-result-prefixes="saxon xs ifn">
	<xsl:output method="xml" version="1.0" encoding="UTF-8" indent="yes"/>
	<xsl:key name="baseclass" match="apiClassifier" use=".//apiBaseClassifier/text()"/>
	<xsl:key name="id" match="//apiClassifier" use="@id"/>
	<xsl:key name="idg" match="//apiClassifier" use="substring-after(@id,':')"/>
	<xsl:key name="baseInter" match="//apiBaseInterface" use="text()"/>
	<xsl:template match="/">
		<xsl:apply-templates/>
	</xsl:template>
	<xsl:template match="apiPackage">
		<apiPackage id="{@id}">
			<apiName>
				<xsl:value-of select="@id"/>
			</apiName>
			<xsl:copy-of select="./apiDetail"/>
			<xsl:apply-templates select="apiClassifier"/>
		</apiPackage>
	</xsl:template>
	<xsl:template match="apiClassifier">
		<apiClassifier id="{@id}">
			<apiName>
				<xsl:value-of select="./apiName"/>
			</apiName>
			<xsl:apply-templates select="shortdesc"/>
			<xsl:apply-templates select="prolog"/>
			<xsl:apply-templates select="Keywords" mode="keys"/>
			<xsl:apply-templates select="apiClassifierDetail"/>
			<xsl:apply-templates select="related-links"/>
		</apiClassifier>
	</xsl:template>
	<xsl:template match="apiClassifierDetail">
		<apiClassifierDetail>
			<xsl:apply-templates select="node()"/>
			<Inheritancelist>
				<BaseInterface>
					<xsl:if test="./apiClassifierDef/apiInterface and ./apiClassifierDef/apiBaseInterface">
						<xsl:for-each select="./apiClassifierDef/apiBaseInterface">
							<xsl:sort select="substring-after(./apiClassifierDef/apiBaseInterface/.,':')" order="ascending" data-type="text"/>
							<Interface id="{.}"/>
						</xsl:for-each>
						<xsl:call-template name="nested"/>
					</xsl:if>
				</BaseInterface>
				<Inheritance>
					<xsl:variable name="baseClass" select=".//apiBaseClassifier/text()"/>
					<xsl:for-each select=".//apiBaseClassifier">
						<Inherit id="{$baseClass}"/>
					</xsl:for-each>
					<xsl:call-template name="inheritList">
						<xsl:with-param name="base" select="$baseClass"/>
					</xsl:call-template>
				</Inheritance>
				<Implements>
					<xsl:for-each select=".//apiBaseInterface">
						<Implement id="{@*|node()}"/>
					</xsl:for-each>
				</Implements>
				<Subclasses>
					<xsl:variable name="apiClass" select="ancestor::apiClassifier/@id"/>
					<xsl:variable name="apiClassGlb" select="substring-after($apiClass,'globalClassifier:')"/>
					<xsl:for-each select="key('baseclass',  $apiClass)">
						<class id="{@id}"/>
					</xsl:for-each>
					<xsl:for-each select="key('baseclass',  $apiClassGlb)">
						<class id="{@id}"/>
					</xsl:for-each>
				</Subclasses>
				<Implementors>
					<xsl:if test=".//apiInterface">
						<xsl:variable name="apiClass" select="ancestor::apiClassifier/@id"/>
						<xsl:for-each select="key('baseInter',$apiClass)">
							<xsl:sort select="substring-after(ancestor::apiClassifier/@id,':')" order="ascending"/>
							<xsl:if test="not(parent::apiClassifierDef/apiInterface)">
								<Implementor id="{ancestor::apiClassifier/@id}"/>
							</xsl:if>
						</xsl:for-each>
					</xsl:if>
				</Implementors>
				<Excludes>
					<xsl:copy-of select="ancestor::apiClassifier/Excludes/Exclude"/>
					<xsl:for-each select=".//apiBaseClassifier">
						<xsl:call-template name="getexcludes"/>
					</xsl:for-each>
				</Excludes>
			</Inheritancelist>
		</apiClassifierDetail>
	</xsl:template>
	<xsl:template match="Keywords" mode="keys">
		<xsl:apply-templates select="node()"/>
	</xsl:template>
	<xsl:template match="apiClassifierDef">
		<apiClassifierDef>
			<xsl:apply-templates select="node()"/>
		</apiClassifierDef>
	</xsl:template>
	<xsl:template name="nested">
		<xsl:variable name="apiBaseInter" select=".//apiBaseInterface/."/>
		<xsl:for-each select="key('id', $apiBaseInter)/apiClassifierDetail/apiClassifierDef/apiBaseInterface">
			<xsl:variable name="nested.apiBaseInter" select="."/>
			<xsl:choose>
				<xsl:when test="$apiBaseInter=$nested.apiBaseInter"/>
				<xsl:otherwise>
					<Interface id="{.}"/>
				</xsl:otherwise>
			</xsl:choose>
		</xsl:for-each>
		<xsl:call-template name="sub-nested"/>
	</xsl:template>
	<xsl:template name="sub-nested">
		<xsl:variable name="apiBaseInter" select=".//apiBaseInterface/."/>
		<xsl:variable name="subnested.apiBaseInter" select="key('id', $apiBaseInter)/apiClassifierDetail/apiClassifierDef/apiBaseInterface"/>
		<xsl:for-each select="key('id', $subnested.apiBaseInter)/apiClassifierDetail/apiClassifierDef/apiBaseInterface">
			<xsl:variable name="nested.apiBaseInter" select="."/>
			<xsl:choose>
				<xsl:when test="$subnested.apiBaseInter=$nested.apiBaseInter"/>
				<xsl:otherwise>
					<Interface id="{.}"/>
				</xsl:otherwise>
			</xsl:choose>
		</xsl:for-each>
	</xsl:template>
	<xsl:template name="inheritList">
		<xsl:param name="base"/>
		<xsl:variable name="match">
			<xsl:if test="contains($base,':')">
				<xsl:value-of select="$base"/>
			</xsl:if>
			<xsl:if test="not(contains($base,':'))">
				<xsl:text>globalClassifier:</xsl:text>
				<xsl:value-of select="$base"/>
			</xsl:if>
		</xsl:variable>
		<xsl:for-each select="key('id',$match)">
			<xsl:variable name="find" select=".//apiBaseClassifier/."/>
			<xsl:if test=".//apiBaseClassifier/.">
				<Inherit id="{$find}"/>
			</xsl:if>
			<xsl:if test="not($find='Object')">
				<xsl:call-template name="inheritList">
					<xsl:with-param name="base" select="$find"/>
				</xsl:call-template>
			</xsl:if>
		</xsl:for-each>
	</xsl:template>
	<xsl:template name="getexcludes">
		<xsl:for-each select="key('id', ./text())">
			<xsl:copy-of select=".//Excludes/Exclude"/>
			<xsl:for-each select=".//apiBaseClassifier">
				<xsl:call-template name="getexcludes"/>
			</xsl:for-each>
		</xsl:for-each>
	</xsl:template>
	<xsl:template match="shortdesc">
		<shortdesc>
			<xsl:apply-templates select="node()"/>
		</shortdesc>
	</xsl:template>
	<xsl:template match="prolog">
		<prolog>
			<xsl:apply-templates select="node()"/>
		</prolog>
	</xsl:template>
	<xsl:template match="related-links">
		<related-links>
			<xsl:apply-templates select="node()"/>
		</related-links>
	</xsl:template>
	<xsl:template match="node()">
		<xsl:copy copy-namespaces="no">
			<xsl:copy-of select="@*"/>
			<xsl:apply-templates select="node()"/>
		</xsl:copy>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/Classes.xslt
================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://sf.net/saxon" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ifn="urn:internal:functions"
	exclude-result-prefixes="saxon xs ifn">
	<xsl:output method="xml" version="1.0" encoding="UTF-8" indent="yes"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:template match="/">
		<allClasses>
			<xsl:apply-templates select="//apiItemRef">
				<xsl:sort select="@href" order="ascending"/>
			</xsl:apply-templates>
		</allClasses>
	</xsl:template>
	<xsl:template match="apiItemRef">
		<xsl:variable name="ditaFileName">
			<xsl:value-of select="concat($ditaFileDir,@href)"/>
		</xsl:variable>
		<xsl:for-each select="document($ditaFileName)/apiPackage">
			<apiPackage id="{@id}">
				<apiName>
					<xsl:value-of select="./apiName"/>
				</apiName>
				<xsl:copy-of select="./apiDetail"/>
				<xsl:for-each select="//apiClassifier">
					<xsl:variable name="id" select="@id"/>
					<apiClassifier id="{@id}">
						<apiName>
							<xsl:value-of select="apiName/."/>
						</apiName>
						<xsl:apply-templates select="shortdesc"/>
						<xsl:apply-templates select="prolog"/>
						<xsl:apply-templates select="apiClassifierDetail"/>
						<xsl:apply-templates select="related-links"/>
						<Keywords>
							<xsl:variable name="keywords">
								<xsl:if test=".//Xkeyword">
									<xsl:for-each select=".//keyword">
										<xsl:sort order="ascending"/>
										<xsl:value-of select="normalize-space()"/>
										<xsl:text>, </xsl:text>
									</xsl:for-each>
								</xsl:if>
								<xsl:value-of select="./apiName"/>
								<xsl:if test="string-length(../apiName)">
									<xsl:text>,</xsl:text>
									<xsl:call-template name="convertFullName">
										<xsl:with-param name="fullname" select="@id"/>
									</xsl:call-template>
								</xsl:if>
								<xsl:if test="apiValue">
									<xsl:text>,</xsl:text>
									<xsl:for-each select="//apiValue">
										<xsl:sort order="ascending"/>
										<xsl:value-of select="./apiName"/>
										<xsl:if test="position() != last()">
											<xsl:text>,</xsl:text>
										</xsl:if>
									</xsl:for-each>
								</xsl:if>
								<xsl:if test="apiOperation">
									<xsl:text>,</xsl:text>
									<xsl:for-each select="//apiOperation">
										<xsl:sort order="ascending"/>
										<xsl:value-of select="./apiName"/>
										<xsl:if test="position() != last()">
											<xsl:text>,</xsl:text>
										</xsl:if>
									</xsl:for-each>
								</xsl:if>
							</xsl:variable>
							<meta name="keywords" content="{$keywords}"/>
						</Keywords>
						<xsl:if test="./prolog/asMetadata/Exclude">
							<Excludes>
								<xsl:for-each select="./prolog/asMetadata/Exclude">
									<Exclude name="{@name}" kind="{@kind}" class="+ topic/ph adobe-api-d/Exclude "/>
								</xsl:for-each>
							</Excludes>
						</xsl:if>
					</apiClassifier>
				</xsl:for-each>
			</apiPackage>
		</xsl:for-each>
	</xsl:template>
	<xsl:template name="convertFullName">
		<xsl:param name="fullname"/>
		<xsl:param name="separator">.</xsl:param>
		<xsl:param name="justClass">false</xsl:param>
		<xsl:variable name="trimmed">
			<xsl:call-template name="search-and-replace">
				<xsl:with-param name="input" select="$fullname"/>
				<xsl:with-param name="search-string">:public</xsl:with-param>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="trimmed2">
			<xsl:call-template name="search-and-replace">
				<xsl:with-param name="input" select="$trimmed"/>
				<xsl:with-param name="search-string">:internal</xsl:with-param>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="trimmed3" select="translate($trimmed2,':','.')"/>
		<xsl:choose>
			<xsl:when test="$justClass = 'true'">
				<xsl:call-template name="substring-after-last">
					<xsl:with-param name="input" select="translate($trimmed3,'/','.')"/>
					<xsl:with-param name="substr">.</xsl:with-param>
				</xsl:call-template>
			</xsl:when>
			<xsl:when test="contains($trimmed3,'/')">
				<!-- inner class -->
				<xsl:value-of select="translate(substring-before($trimmed3,'/'),'.',$separator)"/>
				<xsl:text>.</xsl:text>
				<xsl:variable name="trimmed4" select="substring-after($trimmed3,'/')"/>
				<xsl:if test="contains($trimmed4,'.')">
					<xsl:variable name="trimmed5">
						<xsl:call-template name="substring-after-last">
							<xsl:with-param name="input" select="$trimmed4"/>
							<xsl:with-param name="substr" select="'.'"/>
						</xsl:call-template>
					</xsl:variable>
					<xsl:value-of select="translate($trimmed5,'.',$separator)"/>
				</xsl:if>
				<xsl:if test="not(contains($trimmed4,'.'))">
					<xsl:value-of select="translate($trimmed4,'.',$separator)"/>
				</xsl:if>
			</xsl:when>
			<xsl:otherwise>
				<xsl:value-of select="translate($trimmed3,'.',$separator)"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="search-and-replace">
		<xsl:param name="input"/>
		<xsl:param name="search-string"/>
		<xsl:param name="replace-string"/>
		<xsl:choose>
			<xsl:when test="$search-string and contains($input,$search-string)">
				<xsl:value-of select="substring-before($input,$search-string)"/>
				<xsl:value-of select="$replace-string"/>
				<xsl:call-template name="search-and-replace">
					<xsl:with-param name="input" select="substring-after($input,$search-string)"/>
					<xsl:with-param name="search-string" select="$search-string"/>
					<xsl:with-param name="replace-string" select="$replace-string"/>
				</xsl:call-template>
			</xsl:when>
			<xsl:otherwise>
				<xsl:value-of select="$input"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="substring-after-last">
		<xsl:param name="input"/>
		<xsl:param name="substr"/>
		<xsl:variable name="tmp" select="substring-after($input,$substr)"/>
		<xsl:choose>
			<xsl:when test="$substr and contains($tmp,$substr)">
				<xsl:call-template name="substring-after-last">
					<xsl:with-param name="input" select="$tmp"/>
					<xsl:with-param name="substr" select="$substr"/>
				</xsl:call-template>
			</xsl:when>
			<xsl:otherwise>
				<xsl:value-of select="$tmp"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="isTopLevel">
		<xsl:param name="packageName"/>
		<xsl:value-of select="string-length($packageName)=0 or contains($packageName,'__Global__')"/>
	</xsl:template>
	<xsl:template match="related-links">
		<related-links>
			<xsl:apply-templates select="node()"/>
		</related-links>
	</xsl:template>
	<xsl:template match="apiClassifierDetail">
		<apiClassifierDetail>
			<xsl:apply-templates select="node()"/>
		</apiClassifierDetail>
	</xsl:template>
	<xsl:template match="shortdesc">
		<shortdesc>
			<xsl:apply-templates select="node()"/>
		</shortdesc>
	</xsl:template>
	<xsl:template match="prolog">
		<prolog>
			<xsl:apply-templates select="node()"/>
		</prolog>
	</xsl:template>
	<xsl:template match="node()">
		<xsl:copy copy-namespaces="no">
			<xsl:copy-of select="@*"/>
			<xsl:apply-templates select="node()"/>
		</xsl:copy>
	</xsl:template>
	<xsl:template match="styles"/>
	<xsl:template match="prolog/asMetadata/Exclude"/>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/Overviews_Base.xml
================================================
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2006 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->

<!-- this file normally should not be edited.  Use the command-line
     parameters for ASDoc instead -->
<overviews>
    <!-- 
	<all-packages>
		<description></description>
	</all-packages>
	-->
	<all-classes>
		<description><![CDATA[Documentation for classes includes syntax, usage information, and code samples for methods, properties, and event handlers and listeners for those APIs that belong to a specific class in ActionScript. The classes are listed alphabetically. If you are not sure to which class a certain method or property belongs, you can look it up in the Index.]]></description>
	</all-classes>
	<deprecated>
		<shortDescription><![CDATA[A list of deprecated items and suggested alternatives when available.]]></shortDescription>
		<description></description>
	</deprecated>
	<!--
	<packages>
		<package name="">
			<shortDescription></shortDescription>
			<description></description>
			<propertiesDescription></propertiesDescription>
			<functionsDescription></functionsDescription>
		</package>
	</packages>
	-->
</overviews>


================================================
FILE: documentation/api-reference/templates/PostProcessing.xslt
================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
	<xsl:output method="xml" version="1.0" encoding="UTF-8" indent="no"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:variable name="classheader" select="document('ClassHeader.xml')"/>
	<xsl:variable name="fieldSummary" select="document('PP_fieldSummary.xml')"/>
	<xsl:variable name="methodSummary" select="document('pp_methodSummary.xml')"/>
	<xsl:template match="node()">
		<xsl:copy copy-namespaces="no">
			<xsl:copy-of select="@*"/>
			<xsl:apply-templates select="node()"/>
		</xsl:copy>
	</xsl:template>
	<!-- For FieldSummary -->
	<xsl:template match="apiName[parent::apiValue[not(shortdesc)] and parent::apiValue/apiValueDetail/apiValueDef/apiInheritDoc]">
		<xsl:copy-of select="."/>
		<xsl:variable name="name" select="."/>
		<xsl:variable name="apiID" select="ancestor::apiClassifier/@id"/>
		<xsl:choose>
			<xsl:when test="$classheader//apiPackage/apiClassifier[@id=$apiID]">
				<xsl:for-each select="$classheader//apiPackage/apiClassifier[@id=$apiID]/apiClassifierDetail/Inheritancelist/Inheritance/Inherit/@id">
					<xsl:variable name="baseID" select="."/>
					<xsl:choose>
						<xsl:when test="$fieldSummary//apiPackage/apiClassifier[@id=$baseID]/apiOperation[apiName = $name]/shortdesc">
							<xsl:copy-of select="$fieldSummary//apiPackage/apiClassifier[@id=$baseID]/apiOperation[apiName = $name]/shortdesc"/>
						</xsl:when>
					</xsl:choose>
				</xsl:for-each>
			</xsl:when>
			<xsl:otherwise>
				<xsl:message terminate="no">
					<xsl:text>WARNING : Short Description not present for </xsl:text>
					<xsl:value-of select="parent::apiValue/@id"/>
				</xsl:message>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template match="apiValueDef[parent::apiValueDetail[not(apiDesc)] and parent::apiValueDetail/apiValueDef/apiInheritDoc]">
		<xsl:copy-of select="."/>
		<xsl:variable name="name" select="parent::apiValueDetail/parent::apiValue/apiName"/>
		<xsl:variable name="apiID" select="ancestor::apiClassifier/@id"/>
		<xsl:choose>
			<xsl:when test="$classheader//apiPackage/apiClassifier[@id=$apiID]">
				<xsl:for-each select="$classheader//apiPackage/apiClassifier[@id=$apiID]/apiClassifierDetail/Inheritancelist/Inheritance/Inherit/@id">
					<xsl:variable name="baseID" select="."/>
					<xsl:choose>
						<xsl:when test="$fieldSummary//apiPackage/apiClassifier[@id=$baseID]/apiOperation[apiName = $name]/apiValueDetail/apiDesc">
							<xsl:copy-of select="$fieldSummary//apiPackage/apiClassifier[@id=$baseID]/apiOperation[apiName = $name]/apiValueDetail/apiDesc"/>
						</xsl:when>
					</xsl:choose>
				</xsl:for-each>
			</xsl:when>
			<xsl:otherwise>
				<xsl:message terminate="no">
					<xsl:text>WARNING : api Description not present for </xsl:text>
					<xsl:value-of select="parent::apiValueDetail/parent::apiValue/@id"/>
				</xsl:message>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<!-- For MethodSummary -->
	<xsl:template match="apiName[parent::apiOperation[not(shortdesc)] and parent::apiOperation/apiOperationDetail/apiOperationDef/apiInheritDoc]">
		<xsl:copy-of select="."/>
		<xsl:variable name="name" select="."/>
		<xsl:variable name="apiID" select="ancestor::apiClassifier/@id"/>
		<xsl:choose>
			<xsl:when test="$classheader//apiPackage/apiClassifier[@id=$apiID]">
				<xsl:for-each select="$classheader//apiPackage/apiClassifier[@id=$apiID]/apiClassifierDetail/Inheritancelist/Inheritance/Inherit/@id">
					<xsl:variable name="baseID" select="."/>
					<xsl:choose>
						<xsl:when test="$methodSummary//apiPackage/apiClassifier[@id=$baseID]/apiOperation[apiName = $name]/shortdesc">
							<xsl:copy-of select="$methodSummary//apiPackage/apiClassifier[@id=$baseID]/apiOperation[apiName = $name]/shortdesc"/>
						</xsl:when>
					</xsl:choose>
				</xsl:for-each>
			</xsl:when>
			<xsl:otherwise>
				<xsl:message terminate="no">
					<xsl:text>WARNING : Short Description not present for </xsl:text>
					<xsl:value-of select="parent::apiOperation/@id"/>
				</xsl:message>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template match="apiOperationDef[parent::apiOperationDetail[not(apiDesc) or apiDesc[normalize-space(.)=' ']] and parent::apiOperationDetail/apiOperationDef/apiInheritDoc]">
		<xsl:copy-of select="."/>
		<xsl:variable name="name" select="parent::apiOperationDetail/parent::apiOperation/apiName"/>
		<xsl:variable name="apiID" select="ancestor::apiClassifier/@id"/>
		<xsl:choose>
			<xsl:when test="$classheader//apiPackage/apiClassifier[@id=$apiID]">
				<xsl:for-each select="$classheader//apiPackage/apiClassifier[@id=$apiID]/apiClassifierDetail/Inheritancelist/Inheritance/Inherit/@id">
					<xsl:variable name="baseID" select="."/>
					<xsl:choose>
						<xsl:when test="$methodSummary//apiPackage/apiClassifier[@id=$baseID]/apiOperation[apiName = $name]/apiOperationDetail/apiDesc">
							<xsl:copy-of select="$methodSummary//apiPackage/apiClassifier[@id=$baseID]/apiOperation[apiName = $name]/apiOperationDetail/apiDesc"/>
						</xsl:when>
					</xsl:choose>
				</xsl:for-each>
			</xsl:when>
			<xsl:otherwise>
				<xsl:message terminate="no">
					<xsl:text>WARNING : api Description not present for </xsl:text>
					<xsl:value-of select="parent::apiOperationDetail/parent::apiOperation/@id"/>
				</xsl:message>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template match="shortdesc[normalize-space(.)= ' ']"/>
	<xsl:template match="shortdesc[2]"/>
	<xsl:template match="apiDesc[normalize-space(.) =' ']"/>
	<xsl:template match="apiDesc[2]"/>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/all-classes.xslt
================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://sf.net/saxon" xmlns:str="http://exslt.org/strings" xmlns:ifn="urn:internal:functions"
	exclude-result-prefixes="saxon str ifn">
	<xsl:import href="asdoc-util.xslt"/>
	<xsl:output encoding="UTF-8" method="html" omit-xml-declaration="yes" saxon:indent="3" use-character-maps="disable" indent="yes"/>
	<xsl:variable name="title" select="concat($asdoc_terms/row[entry[1][p/text() = 'allClasses']]/entry[2]/p, ' - ',$title-base)"/>
	<xsl:param name="packages_map_name" select="'packagemap.xml'"/>
	<xsl:param name="jslr" select="'flashclasses.xml'"/>
	<xsl:param name="prog_language_name" select="''"/>
	<xsl:template match="/">
		<xsl:copy-of select="$noLiveDocs"/>
		<xsl:copy-of select="$docType"/>
		<xsl:element name="html">
			<head>
				<title>
					<xsl:choose>
						<xsl:when test="$prog_language_name='javascript'" />
						<xsl:otherwise>
							<xsl:value-of select="$title"/>
						</xsl:otherwise>
					</xsl:choose>
				</title>
				<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
				<base target="classFrame"/>
				<xsl:call-template name="getStyleLink">
					<xsl:with-param name="link" select="asdoc/link"/>
				</xsl:call-template>
			</head>
			<body class="classFrameContent">
				<xsl:choose>
					<xsl:when test="$prog_language_name='javascript'"/>
					<xsl:otherwise>
						<h3>
							<a href="class-summary.html" target="classFrame" style="color:black">
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'allClasses']]/entry[2]/p"/>
							</a>
						</h3>
					</xsl:otherwise>
				</xsl:choose>
				<xsl:choose>
					<xsl:when test="$prog_language_name='javascript'"/>
					<xsl:otherwise>
						<table cellpadding="0" cellspacing="0">
							<xsl:apply-templates select="//apiClassifier">
								<xsl:sort select="apiName" order="ascending" lang="en-US"/>
							</xsl:apply-templates>
						</table>
					</xsl:otherwise>
				</xsl:choose>
			</body>
		</xsl:element>
		<xsl:copy-of select="$copyrightComment"/>
	</xsl:template>
	<xsl:template match="apiClassifier">
		<xsl:variable name="name" select="./apiName"/>
		<xsl:variable name="packageName" select="../apiName"/>
		<xsl:variable name="isTopLevel">
			<xsl:call-template name="isTopLevel">
				<xsl:with-param name="packageName" select="$packageName"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="classPath" select="translate($packageName,'.','/')"/>
		<tr>
			<td>
				<xsl:choose>
					<xsl:when test="$isTopLevel='false'">
						<a href="{$classPath}/{$name}.html"  title="{$packageName}.{$name}">
							<xsl:choose>
								<xsl:when test="./apiClassifierDetail/apiClassifierDef/apiInterface">
									<i>
										<xsl:value-of select="$name"/>
									</i>
								</xsl:when>
								<xsl:otherwise>
									<xsl:value-of select="$name"/>
								</xsl:otherwise>
							</xsl:choose>
						</a>
					</xsl:when>
					<xsl:otherwise>
						<xsl:variable name="targetValue" select="concat('./',$name,'.html')"/>
						<a href="{$targetValue}">
							<xsl:choose>
								<xsl:when test="./apiClassifierDetail/apiClassifierDef/apiInterface!=null">
									<i>
										<xsl:value-of select="$name"/>
									</i>
								</xsl:when>
								<xsl:otherwise>
									<xsl:value-of select="$name"/>
								</xsl:otherwise>
							</xsl:choose>
						</a>
					</xsl:otherwise>
				</xsl:choose>
				<xsl:choose>
					<xsl:when test="$prog_language_name='javascript'"/>
					<xsl:otherwise>
						<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
							<xsl:value-of select="$nbsp"/>
							<img src="images/AirIcon12x12.gif" width="12" height="12" hspace="0" vspace="0"/>
						</xsl:if>
					</xsl:otherwise>
				</xsl:choose>
			</td>
		</tr>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/all-index.xslt
================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://sf.net/saxon" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ifn="urn:internal:functions"
	exclude-result-prefixes="saxon xs ifn">
	<xsl:import href="asdoc-util.xslt"/>
	<xsl:output encoding="UTF-8" method="html" omit-xml-declaration="yes" use-character-maps="disable"/>
	<xsl:param name="basedir" select="''"/>
	<xsl:param name="directivesFile" select="'directives.xml'"/>
	<xsl:param name="globalFuncFile" select="'global_functions.xml'"/>
	<xsl:param name="globalPropsFile" select="'global_props.xml'"/>
	<xsl:param name="constantsFile" select="'constants.xml'"/>
	<xsl:param name="operatorsFile" select="'operators.xml'"/>
	<xsl:param name="statementsFile" select="'statements.xml'"/>
	<xsl:param name="specialTypesFile" select="'specialTypes.xml'"/>
	<xsl:param name="unsupportedFile" select="'unsupported.xml'"/>
	<xsl:param name="fscommandFile" select="'fscommand.xml'"/>
	<xsl:param name="splitIndex" select="$config/options[@splitIndex='true']"/>
	<xsl:param name="outputPath" select="''"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:param name="ditaFile" select="'packages.dita'"/>
	<xsl:param name="packages_map_name" select="'packagemap.xml'"/>
	<xsl:param name="symbolsName" select="'Symbols'"/>
	<xsl:param name="packageOverviewFile" select="'overviews.xml'"/>
	<xsl:param name="prog_language_name" select="'ActionScript'"/>
	<xsl:variable name="directives">
		<xsl:if test="$config/languageElements[@show='true' and @directives='true']">
			<xsl:copy-of select="document(concat($basedir,$directivesFile))/asdoc"/>
		</xsl:if>
	</xsl:variable>
	<xsl:variable name="globalFuncs">
		<xsl:if test="$config/languageElements[@show='true' and @functions='true'] and $config/options[@docversion!='3']">
			<xsl:copy-of select="document(concat($basedir,$globalFuncFile))/asdoc"/>
		</xsl:if>
	</xsl:variable>
	<xsl:variable name="globalProps">
		<xsl:if test="$config/languageElements[@show='true' and @properties='true']">
			<xsl:copy-of select="document(concat($basedir,$globalPropsFile))/asdoc"/>
		</xsl:if>
	</xsl:variable>
	<xsl:variable name="constants">
		<xsl:if test="$config/languageElements[@show='true' and @constants='true'] and $config/options[@docversion!='3']">
			<xsl:copy-of select="document(concat($basedir,$constantsFile))/asdoc"/>
		</xsl:if>
	</xsl:variable>
	<xsl:variable name="operators">
		<xsl:if test="$config/languageElements[@show='true' and @operators='true']">
			<xsl:copy-of select="document(concat($basedir,$operatorsFile))/asdoc"/>
		</xsl:if>
	</xsl:variable>
	<xsl:variable name="statements">
		<xsl:if test="$config/languageElements[@show='true' and @statements='true']">
			<xsl:copy-of select="document(concat($basedir,$statementsFile))/asdoc"/>
		</xsl:if>
	</xsl:variable>
	<xsl:variable name="specialTypes">
		<xsl:if test="$config/languageElements[@show='true' and @specialTypes='true']">
			<xsl:copy-of select="document(concat($basedir,$specialTypesFile))/asdoc"/>
		</xsl:if>
	</xsl:variable>
	<xsl:variable name="unsupported">
		<xsl:if test="$config/index[@showUnsupported='true']">
			<xsl:copy-of select="document(concat($basedir,$unsupportedFile))/asdoc"/>
		</xsl:if>
	</xsl:variable>
	<xsl:variable name="fscommand">
		<xsl:if test="$config/index[@showFscommand='true']">
			<xsl:copy-of select="document(concat($basedir,$fscommandFile))/asdoc"/>
		</xsl:if>
	</xsl:variable>
	<xsl:variable name="matches"
		select="//*[((self::apiOperation or self::apiValue or self::apiConstructor or self::style or self::SkinPart or self::SkinState or self::effect) and not(ancestor::asAncestor)) or self::apiPackage or self::apiClassifier or (self::adobeApiEvent[not(adobeApiEventDetail/adobeApiEventDef/apiDefinedEvent)] and (not(parent::apiOperation) and not(parent::apiConstructor) and not(parent::eventsDefined) and not(ancestor::asAncestor)))] | $directives/asdoc/object/methods/method | $globalFuncs/asdoc/object/methods/method | $globalProps/asdoc/object/fields/field | $constants/asdoc/object/fields/field | $operators/asdoc/operators/operator | $statements/asdoc/statements/statement | $specialTypes/asdoc/specialTypes/specialType | $unsupported/asdoc/unsupported//*[@name] | $fscommand/asdoc/fscommand | $config/index/entry"/>
	<xsl:variable name="symbols">
		<xsl:text disable-output-escaping="yes">+,:!?/.^~*=%|&amp;&lt;>()[]{}"</xsl:text>
	</xsl:variable>
	<xsl:variable name="letters">
		<xsl:if test="$config/languageElements[@show='true' and (@operators='true' or @specialTypes='true')]">
			<xsl:value-of select="$symbolsName"/>
			<xsl:text> </xsl:text>
		</xsl:if>
		<xsl:text>A B C D E F G H I J K L M N O P Q R S T U V W X Y Z</xsl:text>
	</xsl:variable>
	<xsl:variable name="letterSet" select="tokenize($letters,' ')"/>
	<xsl:template match="/">
		<xsl:if test="$splitIndex='false'">
			<xsl:apply-templates select="allClasses"/>
		</xsl:if>
		<xsl:if test="$splitIndex!='false'">
			<xsl:variable name="context" select="/"/>
			<xsl:for-each select="$letterSet">
				<xsl:variable name="fileName" select="concat('all-index-',.)"/>
				<xsl:result-document href="{concat($outputPath,$fileName,'.html')}">
					<xsl:apply-templates select="$context/allClasses">
						<xsl:with-param name="displayLetters" select="tokenize(.,' ')"/>
						<xsl:with-param name="fileName" select="$fileName"/>
						<xsl:with-param name="letter" select="."/>
					</xsl:apply-templates>
				</xsl:result-document>
			</xsl:for-each>
		</xsl:if>
	</xsl:template>
	<xsl:template match="allClasses">
		<xsl:param name="displayLetters" select="$letterSet"/>
		<xsl:param name="fileName" select="'all-index'"/>
		<xsl:param name="letter"/>
		<xsl:variable name="localizedLetter">
			<xsl:choose>
				<xsl:when test="$letter = 'Symbols'">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Symbols']]/entry[2]/p"/>
				</xsl:when>
				<xsl:otherwise>
					<xsl:value-of select="$letter"/>
				</xsl:otherwise>
			</xsl:choose>
		</xsl:variable>
		<xsl:variable name="localizedIndex">
			<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Index']]/entry[2]/p"/>
		</xsl:variable>
		<xsl:copy-of select="$noLiveDocs"/>
		<xsl:copy-of select="$docType"/>
		<xsl:if test="$config/options[@livedocs='true']">
			<xsl:comment>#config errmsg=""</xsl:comment>
		</xsl:if>
		<xsl:element name="html">
			<head>
				<title>
					<xsl:if test="$splitIndex and $letter">
						<xsl:value-of select="$localizedLetter"/>
					</xsl:if>
					<xsl:if test="not($splitIndex)">
						<xsl:value-of select="$config/title"/>
					</xsl:if>
					<xsl:text> </xsl:text>
					<xsl:value-of select="localizedIndex"/>
					<xsl:call-template name="getPageTitlePostFix"/>
				</title>
				<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
				<xsl:call-template name="getStyleLink">
					<xsl:with-param name="link" select="asdoc/link"/>
				</xsl:call-template>
			</head>
			<xsl:element name="body">
				<xsl:if test="$isEclipse">
					<xsl:attribute name="class">
						<xsl:text>eclipseBody</xsl:text>
					</xsl:attribute>
				</xsl:if>
				<xsl:call-template name="getTitleScript">
					<xsl:with-param name="title">
						<xsl:if test="$splitIndex">
							<xsl:value-of select="concat($letter,' ',$localizedIndex,' - ',$title-base)"/>
						</xsl:if>
						<xsl:if test="not($splitIndex)">
							<xsl:value-of select="concat('All Index - ',$title-base)"/>
						</xsl:if>
					</xsl:with-param>
				</xsl:call-template>
				<xsl:call-template name="getLinks2">
					<xsl:with-param name="subTitle">
						<xsl:if test="$splitIndex">
							<xsl:if test="$letter!='Symbols'">
								<xsl:value-of select="concat($localizedLetter,$nbsp,$localizedIndex)"/>
							</xsl:if>
							<xsl:if test="$letter='Symbols'">
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'SymbolsIndex']]/entry[2]/p"/>
							</xsl:if>
						</xsl:if>
						<xsl:if test="not($splitIndex)">
							<xsl:value-of select="concat('All',$nbsp,'Index')"/>
						</xsl:if>
					</xsl:with-param>
					<xsl:with-param name="fileName" select="$fileName"/>
					<xsl:with-param name="fileName2" select="'index-list.html'"/>
					<xsl:with-param name="showProperties" select="false()"/>
					<xsl:with-param name="showMethods" select="false()"/>
					<xsl:with-param name="showIndex" select="false()"/>
				</xsl:call-template>
				<div class="MainContent">
					<br/>
					<table class="allIndexTable" border="0" cellspacing="0" cellpadding="0">
						<xsl:for-each select="$displayLetters">
							<tr>
								<td colspan="2">
									<a name="{.}"/>
									<xsl:variable name="currLetter" select="."/>
									<xsl:for-each select="$letterSet">
										<xsl:if test="$currLetter=.">
											<xsl:if test="$currLetter=$symbolsName">
												<font color="black" size="6px" style="bold">
													<xsl:call-template name="getLocalizedString">
														<xsl:with-param name="key" select="."/>
													</xsl:call-template>
												</font>
											</xsl:if>
											<xsl:if test="$currLetter!=$symbolsName">
												<font color="black" size="10px" style="bold">
													<xsl:call-template name="getLocalizedString">
														<xsl:with-param name="key" select="."/>
													</xsl:call-template>
												</font>
											</xsl:if>
										</xsl:if>
										<xsl:if test="$currLetter!=.">
											<xsl:if test="$splitIndex='false'">
												<xsl:choose>
													<xsl:when test="$prog_language_name='javascript'"/>
													<xsl:otherwise>
														<a href="#{.}" onclick="javascript:loadClassListFrame('index-list.html');">
															<xsl:call-template name="getLocalizedString">
																<xsl:with-param name="key" select="."/>
															</xsl:call-template>
														</a>
													</xsl:otherwise>
												</xsl:choose>
											</xsl:if>
											<xsl:if test="$splitIndex!='false'">
												<xsl:choose>
													<xsl:when test="$prog_language_name='javascript'"/>
													<xsl:otherwise>
														<a href="all-index-{.}.html" onclick="javascript:loadClassListFrame('index-list.html');">
															<xsl:call-template name="getLocalizedString">
																<xsl:with-param name="key" select="."/>
															</xsl:call-template>
														</a>
													</xsl:otherwise>
												</xsl:choose>
											</xsl:if>
										</xsl:if>
										<xsl:text disable-output-escaping="yes"><![CDATA[&nbsp; ]]></xsl:text>
									</xsl:for-each>
								</td>
							</tr>
							<xsl:variable name="firstUpper" select="."/>
							<xsl:variable name="checkingSymbol" select=".=$symbolsName and $config/languageElements[@show='true' and (@operators='true' or @specialTypes='true')]"/>
							<xsl:variable name="firstLower" select="translate($firstUpper,$upperCase,$lowerCase)"/>
							<xsl:for-each select="$matches">
								<xsl:sort select="concat(translate(self::apiPackage[apiName='__Global__']/apiName,'Global__','Top Le'),translate(@symbol,$symbols,''),translate(./apiName | @name,'#_.( ',''))"
									data-type="text" lang="en-US"/>
								<xsl:sort select="../../apiName | @name"/>
								<xsl:sort select="../apiName | @name"/>
								<xsl:variable name="isSymbol" select="string-length(./@symbol) > 0 and not(contains($letters,translate(substring(./@symbol,1,1),$lowerCase,$upperCase)))"/>
								<xsl:variable name="isSpecialSymbol" select="self::specialType and not(contains($letters,translate(substring(@name,1,1),$lowerCase,$upperCase)))"/>
								<xsl:variable name="isRestParam" select="starts-with(@name,'...')"/>
								<xsl:variable name="sortableName">
									<xsl:choose>
										<!-- special case for -Infinity -->
										<xsl:when test="./apiName='-Infinity'">
											<xsl:value-of select="substring(./apiName,2)"/>
										</xsl:when>
										<xsl:when test="./apiName='__Global__'">
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
										</xsl:when>
										<xsl:otherwise>
											<xsl:if test="$isSymbol">
												<xsl:value-of select="@symbol"/>
											</xsl:if>
											<xsl:if test="not($isSymbol)">
												<xsl:if test="string-length(@symbol) > 0">
													<xsl:value-of select="@symbol"/>
												</xsl:if>
												<xsl:if test="not(string-length(@symbol) > 0)">
													<xsl:value-of select="translate(./apiName,'#_.( ','')"/>
												</xsl:if>
												<xsl:if test="local-name(.) ='style' or local-name(.) ='SkinPart' or local-name(.) ='SkinState' or local-name(.) ='effect' or local-name(.) ='statement' or local-name(.) ='specialType' or local-name(.) ='operator'">
													<xsl:value-of select="./@name"/>
												</xsl:if>
											</xsl:if>
										</xsl:otherwise>
									</xsl:choose>
								</xsl:variable>
								<xsl:variable name="symbolMatch" select="$checkingSymbol and ($isSymbol or $isSpecialSymbol or $isRestParam)"/>
								<xsl:if test="$symbolMatch or starts-with($sortableName,$firstLower) or starts-with($sortableName,$firstUpper)">
									<tr>
										<td class="idxrow" colspan="2">
											<xsl:choose>
												<!-- unsupported must come first, otherwise they show up in their original sections -->
												<xsl:when test="ancestor::unsupported">
													<a href="unsupported.html">
														<xsl:value-of select="@name"/>
														<xsl:if test="self::method">
															<xsl:text>()</xsl:text>
														</xsl:if>
													</a>
													<xsl:value-of select="$emdash"/>
													<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Unsupported']]/entry[2]/p"/>
													<xsl:text> </xsl:text>
													<xsl:choose>
														<xsl:when test="self::globalFunction">
															<a href="global_functions.html">
																<xsl:value-of select="../@label"/>
															</a>
														</xsl:when>
														<xsl:when test="self::fscommand">
															<a href="global_functions.html#fscommand()">
																<xsl:value-of select="../@label"/>
															</a>
														</xsl:when>
														<xsl:otherwise>
															<xsl:if test="self::eventHandler and not(string-length(@class))">
																<xsl:text> global </xsl:text>
															</xsl:if>
															<xsl:value-of select="parent::node()/@label"/>
														</xsl:otherwise>
													</xsl:choose>
													<xsl:if test="string-length(@package)">
														<xsl:text>, </xsl:text>
														<xsl:if test="string-length(@class)">
															<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ClassIn']]/entry[2]/p"/>
															<xsl:text> </xsl:text>
															<a href="">
																<xsl:value-of select="@package"/>
															</a>
														</xsl:if>
														<xsl:if test="not(string-length(@class))">
															<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Package']]/entry[2]/p"/>
															<xsl:text> </xsl:text>
															<a href="{concat(translate(@package,'.','/'),'/package-detail.html')}">
																<xsl:value-of select="@package"/>
															</a>
														</xsl:if>
													</xsl:if>
													<xsl:if test="not(string-length(@package))">
														<xsl:choose>
															<xsl:when test="self::class">
																<xsl:text>, </xsl:text>
																<a href="package-detail.html" onclick="javascript:loadClassListFrame('class-list.html');">
																	<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
																</a>
															</xsl:when>
															<xsl:otherwise>
																<xsl:if test="string-length(@class)">
																	<xsl:text>, </xsl:text>
																	<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ClassIn']]/entry[2]/p"/>
																	<xsl:text> </xsl:text>
																	<a href="{@class}.html" onclick="javascript:loadClassListFrame('class-list.html');">
																		<xsl:value-of select="@class"/>
																	</a>
																</xsl:if>
															</xsl:otherwise>
														</xsl:choose>
													</xsl:if>
												</xsl:when>
												<xsl:when test="self::fscommand">
													<a href="{concat('fscommand/',@name,'.html')}" onclick="javascript:loadClassListFrame('fscommand-list.html');">
														<xsl:value-of select="@name"/>
													</a>
													<xsl:value-of select="$emdash"/>
													<xsl:text>Command for </xsl:text>
													<a href="global_functions.html#fscommand2()">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'fscommand2']]/entry[2]/p"/>
													</a>
													<xsl:text> </xsl:text>
													<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalFunction']]/entry[2]/p"/>
												</xsl:when>
												<xsl:when test="(self::apiOperation and (not(@type) or (@type!='handler'))) or self::apiConstructor">
													<xsl:variable name="packageName" select="ancestor-or-self::apiPackage/apiName"/>
													<xsl:variable name="isTopLevel">
														<xsl:call-template name="isTopLevel">
															<xsl:with-param name="packageName" select="$packageName"/>
														</xsl:call-template>
													</xsl:variable>
													<xsl:variable name="classPath">
														<!-- AS2 lang elements -->
														<xsl:if test="$isTopLevel='true' or ../../@type='list'">
															<xsl:text>.</xsl:text>
														</xsl:if>
														<xsl:if test="$isTopLevel='false'">
															<xsl:value-of select="translate($packageName,'.','/')"/>
														</xsl:if>
													</xsl:variable>
													<xsl:choose>
														<!-- AS2 lang elements -->
														<xsl:when test="../../@type='list'">
															<a href="{../../@href}#{@name}()">
																<xsl:value-of select="@name"/>
															</a>
														</xsl:when>
														<xsl:when test="ancestor::apiClassifier">
															<a href="{$classPath}/{../apiName}.html#{apiName}()" onclick="javascript:loadClassListFrame('{$classPath}/class-list.html');">
																<xsl:value-of select="apiName"/>
															</a>
														</xsl:when>
														<xsl:otherwise>
															<a href="{$classPath}/package.html#{apiName}()" onclick="javascript:loadClassListFrame('{$classPath}/class-list.html');">
																<xsl:value-of select="apiName"/>
															</a>
														</xsl:otherwise>
													</xsl:choose>
													<xsl:if test="not(@type) or @type!='directive'">
														<xsl:variable name="params">
															<xsl:call-template name="getParamList">
																<xsl:with-param name="params" select=".//apiParam"/>
															</xsl:call-template>
														</xsl:variable>
														<xsl:text>(</xsl:text>
														<xsl:copy-of select="$params"/>
														<xsl:text>)</xsl:text>
													</xsl:if>
													<xsl:value-of select="$emdash"/>
													<xsl:if test="self::apiOperation">
														<xsl:call-template name="getMethodDesc">
															<xsl:with-param name="classPath" select="$classPath"/>
														</xsl:call-template>
													</xsl:if>
													<xsl:if test="self::apiConstructor">
														<xsl:call-template name="getConstructorDesc">
															<xsl:with-param name="classPath" select="$classPath"/>
														</xsl:call-template>
													</xsl:if>
												</xsl:when>
												<xsl:when test="self::apiValue">
													<xsl:variable name="isTopLevel">
														<xsl:call-template name="isTopLevel">
															<xsl:with-param name="packageName" select="ancestor-or-self::apiPackage/apiName"/>
														</xsl:call-template>
													</xsl:variable>
													<xsl:variable name="classPath">
														<!-- AS2 lang elements -->
														<xsl:if test="$isTopLevel='true' or ../../@type='list'">
															<xsl:text>.</xsl:text>
														</xsl:if>
														<xsl:if test="$isTopLevel='false'">
															<xsl:if test="ancestor::apiClassifier">
																<xsl:value-of select="translate(ancestor-or-self::apiPackage/apiName,'.','/')"/>
															</xsl:if>
															<xsl:if test="not(ancestor::apiClassifier)">
																<xsl:value-of select="translate(ancestor-or-self::apiPackage/apiName,'.','/')"/>
															</xsl:if>
														</xsl:if>
													</xsl:variable>
													<xsl:choose>
														<!-- AS2 lang elements -->
														<xsl:when test="../../@type='list'">
															<a href="{../../@href}#{apiName}">
																<xsl:value-of select="apiName"/>
															</a>
														</xsl:when>
														<xsl:when test="ancestor::apiClassifier">
															<a href="{$classPath}/{ancestor::apiClassifier/apiName}.html#{apiName}" onclick="javascript:loadClassListFrame('{$classPath}/class-list.html');">
																<xsl:value-of select="apiName"/>
															</a>
														</xsl:when>
														<xsl:otherwise>
															<a href="{$classPath}/package.html#{apiName}" onclick="javascript:loadClassListFrame('{$classPath}/class-list.html');">
																<xsl:value-of select="apiName"/>
															</a>
														</xsl:otherwise>
													</xsl:choose>
													<xsl:value-of select="$emdash"/>
													<xsl:call-template name="getPropertyDesc">
														<xsl:with-param name="classPath" select="$classPath"/>
													</xsl:call-template>
												</xsl:when>
												<xsl:when test="self::style or self::SkinPart or self::SkinState or self::effect">
													<xsl:variable name="isTopLevel">
														<xsl:call-template name="isTopLevel">
															<xsl:with-param name="packageName" select="ancestor::apiPackage/apiName"/>
														</xsl:call-template>
													</xsl:variable>
													<xsl:variable name="classPath">
														<!-- AS2 lang elements -->
														<xsl:if test="$isTopLevel='true' or ../../@type='list'">
															<xsl:text>.</xsl:text>
														</xsl:if>
														<xsl:if test="$isTopLevel='false'">
															<xsl:value-of select="translate(ancestor-or-self::apiPackage/apiName,'.','/')"/>
														</xsl:if>
													</xsl:variable>
													<xsl:if test="self::style">
														<a href="{$classPath}/{ancestor::apiClassifier/apiName}.html#style:{@name}" onclick="javascript:loadClassListFrame('{$classPath}/class-list.html');">
															<xsl:value-of select="@name"/>
														</a>
														<xsl:value-of select="$emdash"/>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Style']]/entry[2]/p"/>
														<xsl:text>, </xsl:text>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ClassIn']]/entry[2]/p"/>
														<xsl:text> </xsl:text>
														<xsl:call-template name="getClassRef">
															<xsl:with-param name="classPath" select="$classPath"/>
														</xsl:call-template>
														<tr>
															<td width="20"/>
															<td>
																<xsl:variable name="styleText">
																	<xsl:if test="./description/@conref">
																		<xsl:call-template name="getConRefText">
																			<xsl:with-param name="conref" select="./description/@conref"/>
																			<xsl:with-param name="descriptionType" select="local-name(./description)"/>
																			<xsl:with-param name="entryType" select="'style'"/>
																		</xsl:call-template>
																	</xsl:if>
																	<xsl:if test="not(./description/@conref)">
																		<xsl:value-of select="normalize-space(./description)"/>
																	</xsl:if>
																</xsl:variable>
																<xsl:if test="string-length($styleText) &gt; 0">
																	<xsl:variable name="styleTextShortDesc">
																		<xsl:call-template name="getFirstSentence">
																			<xsl:with-param name="inText" select="$styleText"/>
																		</xsl:call-template>
																	</xsl:variable>
																	<xsl:value-of disable-output-escaping="yes" select="$styleTextShortDesc"/>
																</xsl:if>
															</td>
														</tr>
													</xsl:if>
													
				
													<xsl:if test="self::SkinPart">
														<xsl:variable name="pkg" select="translate($classPath,'/','.')"/>
														<xsl:variable name="class" select="ancestor::apiClassifier/apiName"/>
														<a href="{$classPath}/{ancestor::apiClassifier/apiName}.html#skinpart:{@name}" onclick="javascript:loadClassListFrame('{$classPath}/class-list.html');">
															<xsl:value-of select="@name"/>
														</a>
														<xsl:value-of select="$emdash"/>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'SkinPart']]/entry[2]/p"/>
														<xsl:text>, </xsl:text>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ClassIn']]/entry[2]/p"/>
														<xsl:text> </xsl:text>
														<xsl:call-template name="getClassRef">
															<xsl:with-param name="classPath" select="$classPath"/>
														</xsl:call-template>
														<tr>
															<td width="20"/>
															<td>
																<xsl:value-of select="normalize-space(./description)"/>
															</td>
														</tr>
													</xsl:if>
													
													<xsl:if test="self::SkinState">
														<xsl:variable name="pkg" select="translate($classPath,'/','.')"/>
														<xsl:variable name="class" select="ancestor::apiClassifier/apiName"/>
														<a href="{$classPath}/{ancestor::apiClassifier/apiName}.html#skinstate:{@name}" onclick="javascript:loadClassListFrame('{$classPath}/class-list.html');">
															<xsl:value-of select="@name"/>Skin
														</a>
														<xsl:value-of select="$emdash"/>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'SkinState']]/entry[2]/p"/>
														<xsl:text>, </xsl:text>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ClassIn']]/entry[2]/p"/>
														<xsl:text> </xsl:text>
														<xsl:call-template name="getClassRef">
															<xsl:with-param name="classPath" select="$classPath"/>
														</xsl:call-template>
														<tr>
															<td width="20"/>
															<td>
																<xsl:value-of select="normalize-space(./description)"/>
															</td>
														</tr>
													</xsl:if>
																										
													<xsl:if test="self::effect">
														<a href="{$classPath}/{ancestor::apiClassifier/apiName}.html#effect:{@name}" onclick="javascript:loadClassListFrame('{$classPath}/class-list.html');">
															<xsl:value-of select="@name"/>
														</a>
														<xsl:value-of select="$emdash"/>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Effect']]/entry[2]/p"/>
														<xsl:text>, </xsl:text>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ClassIn']]/entry[2]/p"/>
														<xsl:text> </xsl:text>
														<xsl:call-template name="getClassRef">
															<xsl:with-param name="classPath" select="$classPath"/>
														</xsl:call-template>
													</xsl:if>
												</xsl:when>
												<xsl:when test="self::apiPackage">
													<xsl:variable name="isTopLevel">
														<xsl:call-template name="isTopLevel">
															<xsl:with-param name="packageName" select="./apiName"/>
														</xsl:call-template>
													</xsl:variable>
													<xsl:variable name="packagePath">
														<xsl:if test="$isTopLevel='true'">
															<xsl:text>.</xsl:text>
														</xsl:if>
														<xsl:if test="$isTopLevel='false'">
															<xsl:value-of select="translate(./apiName,'.','/')"/>
														</xsl:if>
													</xsl:variable>
													<a href="{$packagePath}/package-detail.html" onclick="javascript:loadClassListFrame('{$packagePath}/class-list.html');">
														<xsl:if test="$isTopLevel='true'">
															<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
														</xsl:if>
														<xsl:if test="$isTopLevel='false'">
															<xsl:value-of select="./apiName"/>
														</xsl:if>
													</a>
													<xsl:value-of select="$emdash"/>
													<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Package']]/entry[2]/p"/>
												</xsl:when>
												<xsl:when test="self::apiClassifier">
													<xsl:variable name="name" select="./apiName"/>
													<xsl:variable name="packageName">
														<xsl:if test="../apiName != '__Global__'">
															<xsl:value-of select="../apiName"/>
														</xsl:if>
													</xsl:variable>
													<xsl:variable name="isTopLevel">
														<xsl:call-template name="isTopLevel">
															<xsl:with-param name="packageName" select="$packageName"/>
														</xsl:call-template>
													</xsl:variable>
													<xsl:variable name="classPath">
														<xsl:if test="$isTopLevel='true'">
															<xsl:text>.</xsl:text>
														</xsl:if>
														<xsl:if test="$isTopLevel='false'">
															<xsl:value-of select="translate($packageName,'.','/')"/>
														</xsl:if>
													</xsl:variable>
													<a href="{$classPath}/{$name}.html" onclick="javascript:loadClassListFrame('{$classPath}/class-list.html');">
														<xsl:if test="./apiClassifierDetail/apiClassifierDef[apiInterface]">
															<i>
																<xsl:value-of select="$name"/>
															</i>
														</xsl:if>
														<xsl:if test="./apiClassifierDetail/apiClassifierDef[not(apiInterface)]">
															<xsl:value-of select="$name"/>
														</xsl:if>
													</a>
													<xsl:value-of select="$emdash"/>
													<xsl:call-template name="getClassDesc">
														<xsl:with-param name="packageName" select="$packageName"/>
													</xsl:call-template>
												</xsl:when>
												<xsl:when test="self::adobeApiEvent or (self::apiOperation and @type='handler')">
													<xsl:variable name="isTopLevel">
														<xsl:call-template name="isTopLevel">
															<xsl:with-param name="packageName" select="ancestor::apiPackage/apiName"/>
														</xsl:call-template>
													</xsl:variable>
													<xsl:variable name="classPath">
														<!-- AS2 lang elements -->
														<xsl:if test="$isTopLevel='true' or ../../@type='list'">
															<xsl:text>.</xsl:text>
														</xsl:if>
														<xsl:if test="$isTopLevel='false'">
															<xsl:if test="ancestor::apiClassifier">
																<xsl:value-of select="translate(../../apiName,'.','/')"/>
															</xsl:if>
															<xsl:if test="not(ancestor::apiClassifier)">
																<xsl:value-of select="translate(../apiName,'.','/')"/>
															</xsl:if>
														</xsl:if>
													</xsl:variable>
													<xsl:choose>
														<!-- AS2 lang elements -->
														<xsl:when test="../../@type='list'">
															<a href="{../../@href}#event:{./apiName}">
																<xsl:value-of select="./apiName"/>
															</a>
														</xsl:when>
														<xsl:when test="ancestor::apiClassifier">
															<a href="{$classPath}/{../apiName}.html#event:{./apiName}" onclick="javascript:loadClassListFrame('{$classPath}/class-list.html');">
																<xsl:value-of select="./apiName"/>
															</a>
														</xsl:when>
														<xsl:otherwise>
															<a href="{$classPath}/package-detail.html#event:{./apiName}" onclick="javascript:loadClassListFrame('{$classPath}/class-list.html');">
																<xsl:value-of select="./apiName"/>
															</a>
														</xsl:otherwise>
													</xsl:choose>
													<xsl:if test="@type='handler'">
														<xsl:variable name="params">
															<xsl:call-template name="getParamList">
																<xsl:with-param name="params" select="params"/>
															</xsl:call-template>
														</xsl:variable>
														<xsl:text>(</xsl:text>
														<xsl:copy-of select="$params"/>
														<xsl:text>)</xsl:text>
													</xsl:if>
													<xsl:value-of select="$emdash"/>
													<xsl:call-template name="getEventDesc">
														<xsl:with-param name="classPath" select="$classPath"/>
													</xsl:call-template>
												</xsl:when>
												<xsl:when test="self::operator or self::statement">
													<xsl:variable name="suffix">
														<xsl:if test="self::operator and deprecated">
															<xsl:value-of select="'_deprecated'"/>
														</xsl:if>
														<xsl:if test="self::statment or not(deprecated)">
															<xsl:value-of select="''"/>
														</xsl:if>
													</xsl:variable>
													<xsl:variable name="href">
														<xsl:if test="$config/options/@docversion='2'">
															<xsl:value-of select="../@href"/>
														</xsl:if>
														<xsl:if test="not($config/options/@docversion='2')">
															<xsl:value-of select="local-name()"/>
															<xsl:text>s.html</xsl:text>
														</xsl:if>
													</xsl:variable>
													<a href="{$href}#{concat(translate(@name,' ','_'),$suffix)}">
														<xsl:if test="string-length(@symbol)">
															<xsl:value-of select="@symbol"/>
															<xsl:text> (</xsl:text>
														</xsl:if>
														<xsl:value-of select="@name"/>
														<xsl:if test="string-length(@symbol)">
															<xsl:text>)</xsl:text>
														</xsl:if>
													</a>
													<xsl:value-of select="$emdash"/>
													<xsl:if test="self::operator">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Operator']]/entry[2]/p"/>
													</xsl:if>
													<xsl:if test="self::statement">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Statement']]/entry[2]/p"/>
													</xsl:if>
												</xsl:when>
												<xsl:when test="self::specialType">
													<a href="specialTypes.html#{@name}">
														<xsl:value-of select="@name"/>
													</a>
													<xsl:value-of select="$emdash"/>
													<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'SpecialType']]/entry[2]/p"/>
												</xsl:when>
												<xsl:when test="self::entry">
													<a href="{@href}" onclick="loadClassListFrame('mxml-tags.html');">
														<xsl:value-of select="@name"/>
													</a>
													<xsl:value-of select="$emdash"/>
													<a href="mxml-tag-detail.html" onclick="loadClassListFrame('mxml-tags.html');">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'MXMLOnly']]/entry[2]/p"/>
													</a>
													<xsl:choose>
														<xsl:when test="(self::statement or self::specialType)">
															<xsl:variable name="desc">
																<xsl:value-of disable-output-escaping="yes" select="./shortDescription"/>
															</xsl:variable>
															<xsl:call-template name="deTilda">
																<xsl:with-param name="inText" select="$desc"/>
															</xsl:call-template>
														</xsl:when>
														<xsl:otherwise>
															<xsl:variable name="desc">
																<xsl:if test="string-length(./shortdesc) &gt; 0 and not(string-length(./shortdesc/@conref) &gt; 0)">
																	<xsl:value-of disable-output-escaping="yes" select="./shortdesc"/>
																</xsl:if>
																<xsl:if test="not(string-length(./shortdesc) &gt; 0) and (string-length(./shortdesc/@conref) &gt; 0)">
																	<xsl:choose>
																		<xsl:when test="ancestor-or-self::apiOperation">
																			<xsl:call-template name="getConRefText">
																				<xsl:with-param name="conref" select="./shortdesc/@conref"/>
																				<xsl:with-param name="descriptionType" select="'shortdesc'"/>
																				<xsl:with-param name="entryType" select="'method'"/>
																				<xsl:with-param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
																			</xsl:call-template>
																		</xsl:when>
																		<xsl:when test="ancestor-or-self::apiValue">
																			<xsl:call-template name="getConRefText">
																				<xsl:with-param name="conref" select="./shortdesc/@conref"/>
																				<xsl:with-param name="descriptionType" select="'shortdesc'"/>
																				<xsl:with-param name="entryType" select="'property'"/>
																				<xsl:with-param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
																			</xsl:call-template>
																		</xsl:when>
																		<xsl:when test="ancestor-or-self::adobeApiEvent">
																			<xsl:call-template name="getConRefText">
																				<xsl:with-param name="conref" select="./shortdesc/@conref"/>
																				<xsl:with-param name="descriptionType" select="'shortdesc'"/>
																				<xsl:with-param name="entryType" select="'event'"/>
																				<xsl:with-param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
																			</xsl:call-template>
																		</xsl:when>
																	</xsl:choose>
																</xsl:if>
															</xsl:variable>
															<xsl:call-template name="deTilda">
																<xsl:with-param name="inText" select="$desc"/>
															</xsl:call-template>
														</xsl:otherwise>
													</xsl:choose>
												</xsl:when>
											</xsl:choose>
										</td>
									</tr>
									<tr>
										<td width="20"/>
										<td>
											<xsl:choose>
												<xsl:when test="deprecated">
													<xsl:apply-templates select="deprecated"/>
												</xsl:when>
												<xsl:when test="(self::apiValue or self::apiOperation or self::apiConstructor or self::adobeApiEvent) and ../../deprecated">
													<xsl:copy-of select="$deprecatedLabel"/>
													<em>
														<xsl:variable name="deprecated" select="$asdoc_terms/row[entry[1][p/text() = 'DeprecatedAsOf']]/entry[2]/p"/>
														<xsl:apply-templates select="$deprecated" mode="terms">
															<xsl:with-param name="class" select="../../@name"/>
															<xsl:with-param name="as-of" select="../../deprecated/@as-of"/>
														</xsl:apply-templates>
													</em>
												</xsl:when>
												<xsl:when test="self::entry">
													<xsl:call-template name="deTilda">
														<xsl:with-param name="inText" select="node()"/>
													</xsl:call-template>
												</xsl:when>
												<xsl:when test="self::effect">
													<xsl:call-template name="deTilda">
														<xsl:with-param name="inText" select="./description"/>
													</xsl:call-template>
												</xsl:when>
												<xsl:when test="self::apiPackage">
													<xsl:call-template name="getPackageComment">
														<xsl:with-param name="packageName" select="./apiName"/>
													</xsl:call-template>
												</xsl:when>
												<xsl:otherwise>
													<!-- AS2 lang elements -->
													<xsl:choose>
														<xsl:when test="(self::operator or self::statement or self::specialType)">
															<xsl:if test="string-length(shortDescription/.) or string-length(short-description)">
																<xsl:call-template name="deTilda">
																	<xsl:with-param name="inText" select="shortDescription/. | short-description/."/>
																</xsl:call-template>
															</xsl:if>
														</xsl:when>
														<xsl:otherwise>
															<xsl:variable name="desc">
																<xsl:if test="string-length(normalize-space(./shortdesc)) &gt; 0 and not(string-length(normalize-space(./shortdesc/@conref)) &gt; 0)">
																	<xsl:call-template name="deTilda">
																		<xsl:with-param name="inText" select="./shortdesc"/>
																	</xsl:call-template>
																</xsl:if>
																<xsl:if test="not(string-length(normalize-space(./shortdesc)) &gt; 0) and (string-length(normalize-space(./shortdesc/@conref)) &gt; 0)">
																	<xsl:choose>
																		<xsl:when test="ancestor-or-self::apiOperation">
																			<xsl:call-template name="getConRefText">
																				<xsl:with-param name="conref" select="./shortdesc/@conref"/>
																				<xsl:with-param name="descriptionType" select="'shortdesc'"/>
																				<xsl:with-param name="entryType" select="'method'"/>
																				<xsl:with-param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
																			</xsl:call-template>
																		</xsl:when>
																		<xsl:when test="ancestor-or-self::apiValue">
																			<xsl:call-template name="getConRefText">
																				<xsl:with-param name="conref" select="./shortdesc/@conref"/>
																				<xsl:with-param name="descriptionType" select="'shortdesc'"/>
																				<xsl:with-param name="entryType" select="'property'"/>
																				<xsl:with-param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
																			</xsl:call-template>
																		</xsl:when>
																		<xsl:when test="ancestor-or-self::adobeApiEvent">
																			<xsl:call-template name="getConRefText">
																				<xsl:with-param name="conref" select="./shortdesc/@conref"/>
																				<xsl:with-param name="descriptionType" select="'shortdesc'"/>
																				<xsl:with-param name="entryType" select="'event'"/>
																				<xsl:with-param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
																			</xsl:call-template>
																		</xsl:when>
																	</xsl:choose>
																</xsl:if>
																<xsl:if test="not(string-length(normalize-space(./shortdesc)) &gt; 0) and (string-length(normalize-space(./shortdesc/@conref)) = 0)">
																	<xsl:choose>
																		<xsl:when test="ancestor-or-self::apiOperation">
																			<xsl:if test="ancestor-or-self::apiOperation/apiOperationDetail/apiOperationDef/apiInheritDoc">
																				<xsl:if
																					test="ancestor-or-self::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseClassifier or ancestor-or-self::apiClassifier/apiClassifierDetail/apiBaseInterface ">
																					<xsl:call-template name="getInheritDocText">
																						<xsl:with-param name="baseClass" select="ancestor-or-self::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
																						<xsl:with-param name="descriptionType" select="'shortdesc'"/>
																						<xsl:with-param name="entryType" select="'apiOperation'"/>
																						<xsl:with-param name="nameToMatch" select="ancestor-or-self::apiOperation/apiName"/>
																					</xsl:call-template>
																				</xsl:if>
																			</xsl:if>
																		</xsl:when>
																		<xsl:when test="ancestor-or-self::apiValue">
																			<xsl:if test="ancestor-or-self::apiValue/apiValueDetail/apiValueDef/apiInheritDoc">
																				<xsl:if
																					test="ancestor-or-self::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseClassifier or ancestor-or-self::apiClassifier/apiClassifierDetail/apiBaseInterface ">
																					<xsl:call-template name="getInheritDocText">
																						<xsl:with-param name="baseClass" select="ancestor-or-self::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
																						<xsl:with-param name="descriptionType" select="'shortdesc'"/>
																						<xsl:with-param name="entryType" select="'apiValue'"/>
																						<xsl:with-param name="nameToMatch" select="ancestor-or-self::apiValue/apiName"/>
																					</xsl:call-template>
																				</xsl:if>
																			</xsl:if>
																		</xsl:when>
																	</xsl:choose>
																</xsl:if>
															</xsl:variable>
															<xsl:variable name="text">
																<xsl:call-template name="search-and-replace">
																	<xsl:with-param name="search-string" select="'~~'"/>
																	<xsl:with-param name="replace-string" select="'*'"/>
																	<xsl:with-param name="input" select="$desc"/>
																</xsl:call-template>
															</xsl:variable>
															<xsl:value-of select="$text"/>
														</xsl:otherwise>
													</xsl:choose>
												</xsl:otherwise>
											</xsl:choose>
										</td>
									</tr>
								</xsl:if>
							</xsl:for-each>
							<tr>
								<td colspan="2" style="padding-bottom:20px"/>
							</tr>
							<xsl:if test="$splitIndex!='false'">
								<tr>
									<td colspan="2">
										<xsl:variable name="currLetter" select="."/>
										<xsl:for-each select="$letterSet">
											<xsl:if test="$currLetter=.">
												<xsl:if test="$currLetter=$symbolsName">
													<font color="black" size="6px" style="bold">
														<xsl:call-template name="getLocalizedString">
															<xsl:with-param name="key" select="."/>
														</xsl:call-template>
													</font>
												</xsl:if>
												<xsl:if test="$currLetter!=$symbolsName">
													<font color="black" size="10px" style="bold">
														<xsl:call-template name="getLocalizedString">
															<xsl:with-param name="key" select="."/>
														</xsl:call-template>
													</font>
												</xsl:if>
											</xsl:if>
											<xsl:if test="$currLetter!=.">
												<xsl:if test="$splitIndex='false'">
													<xsl:choose>
														<xsl:when test="$prog_language_name='javascript'"/>
														<xsl:otherwise>
															<a href="#{.}" onclick="javascript:loadClassListFrame('index-list.html');">
																<xsl:call-template name="getLocalizedString">
																	<xsl:with-param name="key" select="."/>
																</xsl:call-template>
															</a>
														</xsl:otherwise>
													</xsl:choose>
												</xsl:if>
												<xsl:if test="$splitIndex!='false'">
													<xsl:choose>
														<xsl:when test="$prog_language_name='javascript'"/>
														<xsl:otherwise>
															<a href="all-index-{.}.html" onclick="javascript:loadClassListFrame('index-list.html');">
																<xsl:call-template name="getLocalizedString">
																	<xsl:with-param name="key" select="."/>
																</xsl:call-template>
															</a>
														</xsl:otherwise>
													</xsl:choose>
												</xsl:if>
											</xsl:if>
											<xsl:text disable-output-escaping="yes"><![CDATA[&nbsp; ]]></xsl:text>
										</xsl:for-each>
									</td>
								</tr>
							</xsl:if>
						</xsl:for-each>
					</table>
					<p/>
					<xsl:call-template name="getFeedbackLink">
						<xsl:with-param name="topic">
							<xsl:if test="$splitIndex">
								<xsl:value-of select="concat($letter,' Index')"/>
							</xsl:if>
							<xsl:if test="not($splitIndex)">
								<xsl:value-of select="'Index'"/>
							</xsl:if>
						</xsl:with-param>
						<xsl:with-param name="filename" select="$fileName"/>
						<xsl:with-param name="filename2" select="'index-list.html'"/>
					</xsl:call-template>
					<center class="copyright">
						<xsl:copy-of select="$copyright"/>
					</center>
				</div>
				<xsl:if test="$config/options[@livedocs='true']">
					<div class="separator">&#160;</div>
					<xsl:comment>BEGIN IONCOMMENTS</xsl:comment>
					<div id="ionComHere"> </div>
					<xsl:comment>END IONCOMMENTS</xsl:comment>
					<xsl:comment>#include virtual="ionComments.ssi"</xsl:comment>
					<p id="creativecommons" class="creativecommons">
						<a href="http://creativecommons.org/licenses/by-nc-sa/3.0/">
							<img id="creativecommons_img" src="images/CC.png"/>
						</a>
					</p>
					<xsl:comment>#include virtual="/livedocs/googleAnalytics.ssi"</xsl:comment>
					<xsl:comment>#include virtual="/ubi/analytics/analytics_ssi.html"</xsl:comment>
				</xsl:if>
			</xsl:element>
		</xsl:element>
		<xsl:copy-of select="$copyrightComment"/>
	</xsl:template>
	<xsl:template name="getClassRef">
		<xsl:param name="classPath"/>
		<xsl:choose>
			<xsl:when test="string-length($classPath) > 1">
				<xsl:choose>
					<xsl:when test="$prog_language_name='javascript'"/>
					<xsl:otherwise>
						<xsl:value-of select="ancestor::apiPackage/apiName"/>
						<xsl:text>.</xsl:text>
					</xsl:otherwise>
				</xsl:choose>
				<a href="{$classPath}/{ancestor::apiClassifier/apiName}.html" onclick="javascript:loadClassListFrame('{$classPath}/class-list.html');">
					<xsl:value-of select="ancestor::apiClassifier/apiName"/>
				</a>
			</xsl:when>
			<xsl:otherwise>
				<a href="{ancestor::apiClassifier/apiName}.html" onclick="javascript:loadClassListFrame('class-list.html');">
					<xsl:value-of select="ancestor::apiClassifier/apiName"/>
				</a>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="getMethodDesc">
		<xsl:param name="classPath"/>
		<!-- AS2 lang elements -->
		<xsl:if test="parent::apiClassifier">
			<!-- TODO handle more variations (override,final?) -->
			<xsl:if test="apiOperationDetail/apiOperationDef/apiStatic">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'StaticMethodIn']]/entry[2]/p"/>
				<xsl:text>, </xsl:text>
			</xsl:if>
			<xsl:if test="not(apiOperationDetail/apiOperationDef/apiStatic)">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Method']]/entry[2]/p"/>
				<xsl:text>, </xsl:text>
			</xsl:if>
			<xsl:text> </xsl:text>
			<xsl:if test="../apiClassifierDetail/apiClassifierDef/apiInterface">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'InterfaceIn']]/entry[2]/p"/>
			</xsl:if>
			<xsl:if test="not(../apiClassifierDetail/apiClassifierDef/apiInterface)">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ClassIn']]/entry[2]/p"/>
			</xsl:if>
			<xsl:text> </xsl:text>
			<xsl:call-template name="getClassRef">
				<xsl:with-param name="classPath" select="$classPath"/>
			</xsl:call-template>
		</xsl:if>
		<xsl:if test="parent::apiPackage">
			<xsl:if test="apiOperationDetail/apiOperationDef/apiStatic">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PackageStaticFunctionIn']]/entry[2]/p"/>
				<xsl:text>, </xsl:text>
			</xsl:if>
			<xsl:if test="not(apiOperationDetail/apiOperationDef/apiStatic)">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PackageFunctionIn']]/entry[2]/p"/>
				<xsl:text>, </xsl:text>
			</xsl:if>
			<xsl:variable name="isTopLevel">
				<xsl:call-template name="isTopLevel">
					<xsl:with-param name="packageName" select="ancestor::apiPackage/apiName"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:if test="$isTopLevel='false'">
				<a href="{$classPath}/package.html" onclick="loadClassListFrame('{$classPath}/class-list.html')">
					<xsl:value-of select="ancestor::apiPackage/apiName"/>
				</a>
			</xsl:if>
			<xsl:if test="$isTopLevel!='false'">
				<a href="package.html" onclick="loadClassListFrame('class-list.html')">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
				</a>
			</xsl:if>
		</xsl:if>
		<!-- AS2 lang elements -->
		<xsl:if test="../../@type='list'">
			<xsl:if test="@type='directive'">
				<xsl:text>Compiler Directive</xsl:text>
			</xsl:if>
			<xsl:if test="@type!='directive'">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalFunction']]/entry[2]/p"/>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getConstructorDesc">
		<xsl:param name="classPath"/>
		<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Constructor']]/entry[2]/p"/>
		<xsl:text>, </xsl:text>
		<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ClassIn']]/entry[2]/p"/>
		<xsl:text> </xsl:text>
		<xsl:call-template name="getClassRef">
			<xsl:with-param name="classPath" select="$classPath"/>
		</xsl:call-template>
	</xsl:template>
	<xsl:template name="getPropertyDesc">
		<xsl:param name="classPath"/>
		<!-- AS2 lang elements -->
		<xsl:if test="parent::apiClassifier">
			<xsl:if test="$prog_language_name='ActionScript'">
				<xsl:if test="apiValueDetail/apiValueDef/apiStatic">
					<xsl:if test="not(apiValueDetail/apiValueDef/apiProperty)">
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ConstantStaticPropertyIn']]/entry[2]/p"/>
						<xsl:text>,</xsl:text>
					</xsl:if>
					<xsl:if test="apiValueDetail/apiValueDef/apiProperty">
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'StaticPropertyIn']]/entry[2]/p"/>
						<xsl:text>,</xsl:text>
					</xsl:if>
				</xsl:if>
				<xsl:if test="not(apiValueDetail/apiValueDef/apiStatic)">
					<xsl:if test="not(apiValueDetail/apiValueDef/apiProperty)">
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ConstantPropertyIn']]/entry[2]/p"/>
						<xsl:text>,</xsl:text>
					</xsl:if>
					<xsl:if test="apiValueDetail/apiValueDef/apiProperty">
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PropertyIn']]/entry[2]/p"/>
						<xsl:text>,</xsl:text>
					</xsl:if>
				</xsl:if>
			</xsl:if>
			<xsl:text> </xsl:text>
			<xsl:if test="../apiClassifierDetail/apiClassifierDef/apiInterface">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'InterfaceIn']]/entry[2]/p"/>
			</xsl:if>
			<xsl:if test="not(../apiClassifierDetail/apiClassifierDef/apiInterface)">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ClassIn']]/entry[2]/p"/>
			</xsl:if>
			<xsl:text> </xsl:text>
			<xsl:call-template name="getClassRef">
				<xsl:with-param name="classPath" select="$classPath"/>
			</xsl:call-template>
		</xsl:if>
		<xsl:if test="parent::apiPackage">
			<xsl:if test="apiValueDetail/apiValueDef/apiStatic">
				<xsl:if test="not(apiValueDetail/apiValueDef/apiProperty)">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PackageConstantStaticPropertyIn']]/entry[2]/p"/>
					<xsl:text>, </xsl:text>
				</xsl:if>
				<xsl:if test="apiValueDetail/apiValueDef/apiProperty">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PackageStaticPropertyIn']]/entry[2]/p"/>
					<xsl:text>, </xsl:text>
				</xsl:if>
			</xsl:if>
			<xsl:if test="not(apiValueDetail/apiValueDef/apiStatic)">
				<xsl:if test="not(apiValueDetail/apiValueDef/apiProperty)">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PackageConstantPropertyIn']]/entry[2]/p"/>
					<xsl:text>, </xsl:text>
				</xsl:if>
				<xsl:if test="apiValueDetail/apiValueDef/apiProperty">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Package']]/entry[2]/p"/>
					<xsl:text> </xsl:text>
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Property']]/entry[2]/p"/>
					<xsl:text>, </xsl:text>
				</xsl:if>
			</xsl:if>
			<xsl:variable name="isTopLevel">
				<xsl:call-template name="isTopLevel">
					<xsl:with-param name="packageName" select="ancestor::apiPackage/apiName"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:if test="$isTopLevel='false'">
				<a href="{$classPath}/package.html" onclick="loadClassListFrame('{$classPath}/class-list.html')">
					<xsl:value-of select="ancestor::apiPackage/apiName"/>
				</a>
			</xsl:if>
			<xsl:if test="$isTopLevel!='false'">
				<a href="package.html" onclick="loadClassListFrame('class-list.html')">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
				</a>
			</xsl:if>
		</xsl:if>
		<!-- AS2 lang elements -->
		<xsl:if test="../../@type='list'">
			<xsl:if test="../../@name='Constants'">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ConstantProperty']]/entry[2]/p"/>
			</xsl:if>
			<xsl:if test="../../@name!='Constants'">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalProperty']]/entry[2]/p"/>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getEventDesc">
		<xsl:param name="classPath"/>
		<!-- AS2 lang elements -->
		<xsl:if test="parent::apiClassifier">
			<xsl:variable name="typeName">
				<xsl:if test="../apiClassifierDetail/apiClassifierDef/apiInterface">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'InterfaceIn']]/entry[2]/p"/>
				</xsl:if>
				<xsl:if test="not(../apiClassifierDetail/apiClassifierDef/apiInterface)">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ClassIn']]/entry[2]/p"/>
				</xsl:if>
			</xsl:variable>
			<xsl:choose>
				<xsl:when test="@type = 'handler'">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'EventHandlerIn']]/entry[2]/p"/>
					<xsl:text>,</xsl:text>
				</xsl:when>
				<xsl:when test="@type != 'handler'">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'EventListenerIn']]/entry[2]/p"/>
					<xsl:text>,</xsl:text>
				</xsl:when>
				<xsl:otherwise>
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'EventIn']]/entry[2]/p"/>
					<xsl:text>,</xsl:text>
				</xsl:otherwise>
			</xsl:choose>
			<xsl:text> </xsl:text>
			<xsl:value-of select="$typeName"/>
			<xsl:text> </xsl:text>
			<xsl:call-template name="getClassRef">
				<xsl:with-param name="classPath" select="$classPath"/>
			</xsl:call-template>
		</xsl:if>
		<xsl:if test="not(../../@type) or ../../@type='list'">
			<xsl:if test="@type = 'handler'">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalEventHandler']]/entry[2]/p"/>
			</xsl:if>
			<xsl:if test="@type != 'handler'">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalEventListener']]/entry[2]/p"/>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getPackageComment">
		<xsl:param name="packageName"/>
		<xsl:if test="not($config/overviews/package)">
			<xsl:variable name="packageComments" select="document($packageOverviewFile)/overviews/packages/package[@name=$packageName]"/>
			<xsl:for-each select="$packageComments/shortDescription">
				<xsl:call-template name="deTilda">
					<xsl:with-param name="inText" select="."/>
				</xsl:call-template>
			</xsl:for-each>
		</xsl:if>
		<xsl:if test="$config/overviews/package">
			<xsl:for-each select="$config/overviews/package">
				<xsl:variable name="packageOverview" select="document(.)/overviews/packages/package[@name=$packageName]"/>
				<xsl:for-each select="$packageOverview/shortDescription">
					<xsl:call-template name="deTilda">
						<xsl:with-param name="inText" select="."/>
					</xsl:call-template>
				</xsl:for-each>
			</xsl:for-each>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getClassDesc">
		<xsl:param name="packageName"/>
		<xsl:if test="string-length($packageName)=0">
			<xsl:if test="apiClassifierDetail/apiClassifierDef/apiFinal">
				<xsl:if test="apiClassifierDetail/apiClassifierDef/apiDynamic">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'FinalDynamicClass']]/entry[2]/p"/>
				</xsl:if>
				<xsl:if test="not(apiClassifierDetail/apiClassifierDef/apiDynamic)">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'FinalClass']]/entry[2]/p"/>
				</xsl:if>
			</xsl:if>
			<xsl:if test="not(apiClassifierDetail/apiClassifierDef/apiFinal)">
				<xsl:if test="apiClassifierDetail/apiClassifierDef/apiDynamic">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DynamicClassIn']]/entry[2]/p"/>
				</xsl:if>
				<xsl:if test="not(apiClassifierDetail/apiClassifierDef/apiDynamic)">
					<xsl:if test="apiClassifierDetail/apiClassifierDef/apiInterface">
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Interface']]/entry[2]/p"/>
					</xsl:if>
					<xsl:if test="not(apiClassifierDetail/apiClassifierDef/apiInterface)">
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ClassIn']]/entry[2]/p"/>
					</xsl:if>
				</xsl:if>
			</xsl:if>
			<xsl:text>, </xsl:text>
			<a href="package-detail.html" onclick="javascript:loadClassListFrame('class-list.html');">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
			</a>
		</xsl:if>
		<xsl:if test="string-length($packageName)">
			<xsl:if test="apiClassifierDetail/apiClassifierDef/apiFinal">
				<xsl:if test="apiClassifierDetail/apiClassifierDef/apiDynamic">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'FinalDynamicClass']]/entry[2]/p"/>
				</xsl:if>
				<xsl:if test="not(apiClassifierDetail/apiClassifierDef/apiDynamic)">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'FinalClass']]/entry[2]/p"/>
				</xsl:if>
			</xsl:if>
			<xsl:if test="not(apiClassifierDetail/apiClassifierDef/apiFinal)">
				<xsl:if test="apiClassifierDetail/apiClassifierDef/apiDynamic">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DynamicClassIn']]/entry[2]/p"/>
				</xsl:if>
				<xsl:if test="not(apiClassifierDetail/apiClassifierDef/apiDynamic)">
					<xsl:if test="apiClassifierDetail/apiClassifierDef/apiInterface">
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Interface']]/entry[2]/p"/>
					</xsl:if>
					<xsl:if test="not(apiClassifierDetail/apiClassifierDef/apiInterface)">
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ClassIn']]/entry[2]/p"/>
					</xsl:if>
				</xsl:if>
			</xsl:if>
			<xsl:text>, </xsl:text>
			<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Package']]/entry[2]/p"/>
			<xsl:text> </xsl:text>
			<xsl:variable name="isTopLevel">
				<xsl:call-template name="isTopLevel">
					<xsl:with-param name="packageName" select="$packageName"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:if test="$isTopLevel='false'">
				<a href="{translate($packageName,'.','/')}/package-detail.html" onclick="javascript:loadClassListFrame('{translate($packageName,'.','/')}/class-list.html');">
					<xsl:value-of select="$packageName"/>
				</a>
			</xsl:if>
			<xsl:if test="$isTopLevel!='false'">
				<a href="package.html" onclick="loadClassListFrame('class-list.html')">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
				</a>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getParamList">
		<xsl:param name="params"/>
		<xsl:for-each select="$params">
			<xsl:if test="position()>1">
				<xsl:text>, </xsl:text>
			</xsl:if>
			<xsl:variable name="typeName">
				<xsl:if test="./apiType and not(./apiOperationClassifier)">
					<xsl:value-of select="./apiType/@value"/>
				</xsl:if>
				<xsl:if test="./apiOperationClassifier and not(./apiType)">
					<xsl:value-of select="./apiOperationClassifier"/>
				</xsl:if>
			</xsl:variable>
			<xsl:if test="$prog_language_name = 'ActionScript'">
				<xsl:if test="$config/options/@docversion='2' and @optional='true'">
					<xsl:text>[</xsl:text>
				</xsl:if>
				<xsl:if test="($typeName!= 'restParam')">
					<xsl:value-of select="./apiItemName"/>
					<xsl:if test="($typeName!= '')">
						<xsl:text>:</xsl:text>
						<xsl:call-template name="processParamType">
							<xsl:with-param name="typeName" select="$typeName"/>
						</xsl:call-template>
					</xsl:if>
				</xsl:if>
				<xsl:if test="($typeName = 'restParam')">
					<xsl:text>... rest</xsl:text>
				</xsl:if>
				<xsl:if test="$config/options/@docversion='2' and @optional='true'">
					<xsl:text>]</xsl:text>
				</xsl:if>
			</xsl:if>
		</xsl:for-each>
	</xsl:template>
	<xsl:template name="processParamType">
		<xsl:param name="typeName"/>
		<xsl:if test="($typeName='list')">
			<a href="{$typeName}.html">
				<xsl:value-of select="$typeName"/>
			</a>
		</xsl:if>
		<xsl:if test="$typeName !='list'">
			<xsl:variable name="doesTypeExist">
				<xsl:call-template name="doesClassExist">
					<xsl:with-param name="class_name" select="translate($typeName, '[]', '')"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:choose>
				<xsl:when test="$doesTypeExist = '1'">
					<xsl:variable name="href">
						<xsl:call-template name="convertFullName">
							<xsl:with-param name="fullname" select="$typeName"/>
							<xsl:with-param name="separator">/</xsl:with-param>
						</xsl:call-template>
					</xsl:variable>
					<xsl:if test="string-length($href)">
						<a href="{$href}.html">
							<xsl:attribute name="onclick">
								<xsl:text>javascript:loadClassListFrame('</xsl:text>
								<xsl:call-template name="substring-before-last">
									<xsl:with-param name="input" select="$href"/>
									<xsl:with-param name="substr" select="'/'"/>
								</xsl:call-template>
								<xsl:text>./class-list.html');</xsl:text>
							</xsl:attribute>
							<xsl:value-of select="$typeName"/>
						</a>
					</xsl:if>
				</xsl:when>
				<xsl:otherwise>
					<xsl:value-of select="$typeName"/>
				</xsl:otherwise>
			</xsl:choose>
		</xsl:if>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/asdoc-util.xslt
================================================
<?xml version="1.0" encoding="utf-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://sf.net/saxon" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ifn="urn:internal:functions"
	exclude-result-prefixes="saxon xs ifn">
	<xsl:character-map name="disable">
		<xsl:output-character character="&amp;" string="&amp;"/>
		<xsl:output-character character="&lt;" string="&lt;"/>
		<xsl:output-character character="&gt;" string="&gt;"/>
		<xsl:output-character character="&#145;" string="&amp;lsquo;"/>
		<xsl:output-character character="&#146;" string="&amp;apos;"/>
		<xsl:output-character character="&#151;" string="&amp;mdash;"/>
		<xsl:output-character character="&#x2014;" string="&amp;mdash;"/>
		<xsl:output-character character="&#x2009;" string="&amp;thinsp;"/>
		<xsl:output-character character="&#xAE;" string="&amp;reg;"/>
		<xsl:output-character character="&#xB0;" string="&amp;deg;"/>
		<xsl:output-character character="&#x2122;" string="&amp;trade;"/>
	</xsl:character-map>
	<xsl:output method="html" encoding="UTF-8" indent="no" omit-xml-declaration="yes" use-character-maps="disable"/>
	<xsl:key name="match" match="//apiPackage" use="@id"/>
	<xsl:variable name="newline">
		<xsl:text/>
	</xsl:variable>
	<xsl:variable name="productName" select="$config//product"/>
	<xsl:variable name="markOfTheWeb" select="'&lt;!-- saved from url=(0014)about:internet -->'"/>
	<xsl:variable name="docType">
		<!-- insert byte order mark needed for Flash Panel Help -->
		<xsl:if test="$config/options[@livedocs!='true']">
			<xsl:text disable-output-escaping="yes"></xsl:text>
		</xsl:if>
		<xsl:text disable-output-escaping="yes">&lt;!DOCTYPE HTML PUBLIC &quot;-//W3C//DTD HTML 4.01 Transitional//EN&quot; &quot;http://www.w3.org/TR/html4/loose.dtd&quot;&gt;</xsl:text>
		<xsl:value-of select="$newline"/>
		<xsl:if test="$config/options[@standalone='true']">
			<xsl:value-of disable-output-escaping="yes" select="$markOfTheWeb"/>
			<xsl:value-of select="$newline"/>
		</xsl:if>
	</xsl:variable>
	<xsl:variable name="frameDocType">
		<xsl:text disable-output-escaping="yes">&lt;!DOCTYPE HTML PUBLIC &quot;-//W3C//DTD HTML 4.01 Frameset//EN&quot; &quot;http://www.w3.org/TR/html4/frameset.dtd&quot;&gt;</xsl:text>
		<xsl:value-of select="$newline"/>
	</xsl:variable>
	<xsl:function name="ifn:myFormatDate">
		<xsl:variable name="lookup" as="node()+">
			<term value="Jan">January</term>
			<term value="Feb">February</term>
			<term value="Mar">March</term>
			<term value="Apr">April</term>
			<term value="May">May</term>
			<term value="Jun">June</term>
			<term value="Jul">July</term>
			<term value="Aug">August</term>
			<term value="Sep">September</term>
			<term value="Oct">October</term>
			<term value="Nov">November</term>
			<term value="Dec">December</term>
			<term value="Mon">Monday</term>
			<term value="Tue">Tuesday</term>
			<term value="Wed">Wednesday</term>
			<term value="Thu">Thursday</term>
			<term value="Fri">Friday</term>
			<term value="Sat">Saturday</term>
			<term value="Sun">Sunday</term>
			<term value="AM">A.M.</term>
			<term value="PM">P.M.</term>
		</xsl:variable>
		<xsl:variable name="date" select="format-dateTime(current-dateTime(),  '[F] [MNn] [D] [Y], [h01]:[m01] [PN] [ZN] ' )"/>
		<xsl:value-of select="for $i in tokenize($date, ' ') return ($lookup[. = $i]/@value, $i)[1]"/>
	</xsl:function>
	<xsl:param name="locale" select="'en-us'"/>
	<xsl:param name="asdocTermsFilename" select="'ASDoc_terms.xml'"/>
	<xsl:variable name="asdoc_terms" select="document($asdocTermsFilename)//tbody"/>
	<xsl:param name="configFilename" select="'ASDoc_Config.xml'"/>
	<xsl:variable name="config" select="document($configFilename)/asDocConfig"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:param name="packageCommentsFilename" select="'packages.xml'"/>
	<xsl:param name="AS1tooltip" select="'This example can be used with ActionScript 1.0'"/>
	<xsl:param name="AS2tooltip" select="$asdoc_terms/row[entry[1][p/text() = 'AS2tooltip']]/entry[2]/p"/>
	<xsl:param name="AS3tooltip" select="$asdoc_terms/row[entry[1][p/text() = 'AS3tooltip']]/entry[2]/p"/>
	<xsl:param name="showASIcons" select="'false'"/>
	<xsl:param name="showInheritanceIcon" select="'true'"/>
	<xsl:param name="inheritanceIcon" select="'inherit-arrow.jpg'"/>
	<xsl:param name="isEclipse" select="$config/options[@eclipse='true']"/>
	<xsl:param name="isLiveDocs" select="$config/options[@livedocs='true']"/>
	<xsl:param name="liveDocsSearchSite" select="$config/livedocs/searchsite/."/>
	<xsl:param name="liveDocsSearchString" select="$config/livedocs/searchstring/."/>
	<xsl:param name="liveDocsSearchLocale" select="$config/livedocs/locale/."/>
	<xsl:param name="liveDocsSearch" select="$asdoc_terms/row[entry[1][p/text() = 'searchLivedocs']]/entry[2]/p"/>
	<xsl:param name="liveDocsSearchServlet" select="$config/livedocs/searchservlet/."/>
	<xsl:param name="isStandalone" select="$config/options[@standalone='true']"/>
	<xsl:param name="isSkin" select="$config/skinLink/."/>	
	<xsl:param name="prog_language_name" select="'ActionScript'"/>
	<xsl:variable name="id.match" select="document('flashclasses.xml')//package//class"/>
	<xsl:variable name="id.match.name" select="document('flashclasses.xml')//package"/>
	<xsl:variable name="id.match.class" select="document('flashclasses.xml')//category//class"/>
	<xsl:variable name="class.File.Name" select="document('ClassHeader.xml')//apiClassifier"/>
	<xsl:param name="process_xref_href_attribute" select="'0'"/>
	<xsl:param name="showLangVersionWarnings">
		<xsl:if test="$config/warnings/@langversion='true'">
			<xsl:value-of select="'true'"/>
		</xsl:if>
	</xsl:param>
	<xsl:param name="showPlayerVersionWarnings">
		<xsl:if test="$config/warnings/@playerversion='true'">
			<xsl:value-of select="'true'"/>
		</xsl:if>
	</xsl:param>
	<xsl:param name="noLiveDocs">
		<xsl:if test="$config/options[@livedocs='true']">
			<xsl:comment>livedocs:no</xsl:comment>
			<xsl:value-of select="$newline"/>
		</xsl:if>
	</xsl:param>
	<xsl:param name="showXrefs" select="$config/xrefs[@show='true']"/>
	<xsl:variable name="xrefs">
		<xsl:if test="$showXrefs">
			<xsl:copy-of select="document($config/xrefs/@mapfile)/helpreferences"/>
		</xsl:if>
	</xsl:variable>
	<xsl:param name="title-base" select="$config/windowTitle/."/>
	<xsl:param name="title-jslr" select="$asdoc_terms/row[entry[1][p/text() = 'JSLR_Book_Title']]/entry[2]/p"/>
	<xsl:param name="page-title-base" select="$config/title/."/>
	<xsl:param name="timestamp">
		<xsl:value-of select="ifn:myFormatDate()"/>
	</xsl:param>
	<xsl:param name="copyright">
		<xsl:copy-of select="$config/footer"/>
		<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
		<xsl:if test="$config/dateInFooter='true'">
			<xsl:value-of select="$timestamp"/>
		</xsl:if>
		<xsl:text> </xsl:text>
	</xsl:param>
	<xsl:variable name="copyrightComment">
		<xsl:comment>
			<xsl:copy-of select="$copyright"/>
		</xsl:comment>
	</xsl:variable>
	<xsl:variable name="upperCase">ABCDEFGHIJKLMNOPQRSTUVWXYZ</xsl:variable>
	<xsl:variable name="lowerCase">abcdefghijklmnopqrstuvwxyz</xsl:variable>
	<xsl:variable name="thinsp">
		<xsl:text>&#x2009;</xsl:text>
	</xsl:variable>
	<xsl:variable name="emdash">
		<xsl:text> &#x2014; </xsl:text>
	</xsl:variable>
	<xsl:variable name="asterisk">
		<xsl:text>&#x2A;</xsl:text>
	</xsl:variable>
	<xsl:variable name="nbsp">
		<xsl:text>&#xA0;</xsl:text>
	</xsl:variable>
	<xsl:variable name="degree">
		<xsl:text>&#xB0;</xsl:text>
	</xsl:variable>
	<xsl:variable name="trademark">
		<xsl:text>&#x2122;</xsl:text>
	</xsl:variable>
	<xsl:variable name="registered">
		<xsl:text>&#xAE;</xsl:text>
	</xsl:variable>
	<xsl:template name="getRelativePath">
		<xsl:param name="currentPath"/>
		<xsl:choose>
			<xsl:when test="not($currentPath) or $currentPath='__Global__'">
				<xsl:value-of select="''"/>
			</xsl:when>
			<xsl:otherwise>
				<xsl:if test="contains($currentPath,'.')">
					<xsl:call-template name="getRelativePath">
						<xsl:with-param name="currentPath" select="substring-after($currentPath,'.')"/>
					</xsl:call-template>
				</xsl:if>
				<xsl:value-of select="'../'"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="getBaseRef">
		<xsl:param name="packageName"/>
		<xsl:variable name="isTopLevel">
			<xsl:call-template name="isTopLevel">
				<xsl:with-param name="packageName" select="$packageName"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:if test="$isTopLevel='false'">
			<xsl:variable name="newName" select="substring-after($packageName,'.')"/>
			<xsl:if test="$packageName">
				<xsl:text>../</xsl:text>
				<xsl:call-template name="getBaseRef">
					<xsl:with-param name="packageName" select="$newName"/>
				</xsl:call-template>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="convertNumberListIntoBoolean">
		<xsl:param name="numberList"/>
		<xsl:choose>
			<xsl:when
				test="contains($numberList,'1') or contains($numberList,'2') or contains($numberList,'3') or contains($numberList,'4') or contains($numberList,'5') or contains($numberList,'6') or contains($numberList,'7') or contains($numberList,'8') or contains($numberList,'9')">
				<xsl:value-of select="'true'"/>
			</xsl:when>
			<xsl:otherwise>
				<xsl:value-of select="'false'"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="getStyleLink">
		<xsl:param name="link"/>
		<xsl:param name="packageName"/>
		<xsl:choose>
			<!-- TODO support this? -->
			<xsl:when test="false()">
				<xsl:for-each select="$link">
					<xsl:copy-of select="."/>
				</xsl:for-each>
			</xsl:when>
			<xsl:otherwise>
				<xsl:variable name="baseRef">
					<xsl:call-template name="getBaseRef">
						<xsl:with-param name="packageName" select="$packageName"/>
					</xsl:call-template>
				</xsl:variable>
				<xsl:element name="link">
					<xsl:attribute name="rel">stylesheet</xsl:attribute>
					<xsl:attribute name="href"><xsl:value-of select="$baseRef"/>style.css</xsl:attribute>
					<xsl:attribute name="type">text/css</xsl:attribute>
					<xsl:attribute name="media">screen</xsl:attribute>
				</xsl:element>
				<xsl:element name="link">
					<xsl:attribute name="rel">stylesheet</xsl:attribute>
					<xsl:attribute name="href"><xsl:value-of select="$baseRef"/>print.css</xsl:attribute>
					<xsl:attribute name="type">text/css</xsl:attribute>
					<xsl:attribute name="media">print</xsl:attribute>
				</xsl:element>
				<xsl:element name="link">
					<xsl:attribute name="rel">stylesheet</xsl:attribute>
					<xsl:attribute name="href"><xsl:value-of select="$baseRef"/>override.css</xsl:attribute>
					<xsl:attribute name="type">text/css</xsl:attribute>
				</xsl:element>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="getTitleScript">
		<xsl:param name="packageName"/>
		<xsl:param name="title" select="$title-base"/>
		<xsl:variable name="baseRef">
			<xsl:call-template name="getBaseRef">
				<xsl:with-param name="packageName" select="$packageName"/>
			</xsl:call-template>
		</xsl:variable>
		<script language="javascript" type="text/javascript">
			<xsl:attribute name="src">
				<xsl:value-of select="$baseRef"/>
				<xsl:text>asdoc.js</xsl:text>
			</xsl:attribute>
		</script>
		<xsl:if test="$isEclipse">
			<script language="javascript" type="text/javascript">
				<xsl:comment> eclipseBuild = true;</xsl:comment>
			</script>
		</xsl:if>
		<script language="javascript" type="text/javascript">
			<xsl:attribute name="src">
				<xsl:value-of select="$baseRef"/>
				<xsl:text>help.js</xsl:text>
			</xsl:attribute>
		</script>
		<script language="javascript" type="text/javascript">
			<xsl:attribute name="src">
				<xsl:value-of select="$baseRef"/>
				<xsl:text>cookies.js</xsl:text>
			</xsl:attribute>
		</script>
		<script language="javascript" type="text/javascript">
			<xsl:comment>
				asdocTitle = '<xsl:value-of select="$title"/>';
				var baseRef = '<xsl:value-of select="$baseRef"/>';
				window.onload = configPage;
			</xsl:comment>
		</script>
		<xsl:text>&#xa;</xsl:text>
		<xsl:if test="$config/options[@standalonesearch='true']">
			<xsl:call-template name="search.function.submit">
				<xsl:with-param name="baseRef" select="$baseRef"/>
			</xsl:call-template>
		</xsl:if>
		<script type="text/javascript">
			scrollToNameAnchor();
		</script>
	</xsl:template>
	<xsl:template name="search.function.submit">
		<xsl:param name="baseRef"/>
		<script language="javascript" type="text/javascript">
			<xsl:comment>
				<xsl:text>&#xa;</xsl:text>
				<xsl:text>function submitValue(){</xsl:text>
				<xsl:text>&#xa;</xsl:text>
				<xsl:text>var searchStr=document.getElementById('search-livedocs').value;</xsl:text>
				<xsl:text>&#xa;</xsl:text>
				<xsl:text>window.location="</xsl:text><xsl:value-of select="$baseRef"/><xsl:text>search.html"+"###"+searchStr;</xsl:text>
				<xsl:text>&#xa;</xsl:text>
				<xsl:text>}</xsl:text>
				<xsl:text>&#xa;</xsl:text>
			</xsl:comment>
		</script>
	</xsl:template>
	<xsl:template name="getLinks">
		<xsl:param name="packageName" select="''"/>
		<xsl:param name="fileName"/>
		<xsl:param name="fileName2" select="'all-classes.html'"/>
		<xsl:param name="showInnerClasses" select="false()"/>
		<xsl:param name="showConstants" select="false()"/>
		<xsl:param name="showProperties" select="true()"/>
		<xsl:param name="showConstructors" select="false()"/>
		<xsl:param name="showMethods" select="true()"/>
		<xsl:param name="showStyles" select="false()"/>
		<xsl:param name="showSkinState" select="false()"/>
		<xsl:param name="showSkinPart" select="false()"/>		
		<xsl:param name="showEffects" select="false()"/>
		<xsl:param name="showEvents" select="false()"/>
		<xsl:param name="showIncludeExamples" select="false()"/>
		<xsl:param name="showPackages" select="true()"/>
		<xsl:param name="showAllClasses" select="true()"/>
		<xsl:param name="showLanguageElements" select="boolean($config/languageElements[@show='true'])"/>
		<xsl:param name="showIndex" select="true()"/>
		<xsl:param name="showAppendixes" select="true()"/>
		<xsl:param name="showPackageConstants" select="false()"/>
		<xsl:param name="showPackageProperties" select="false()"/>
		<xsl:param name="showPackageFunctions" select="false()"/>
		<xsl:param name="showInterfaces" select="false()"/>
		<xsl:param name="showClasses" select="false()"/>
		<xsl:param name="showPackageUse" select="false()"/>
		<xsl:param name="copyNum" select="'1'"/>
		<xsl:param name="additionalLinks"/>
		<xsl:param name="splitIndex" select="$config/options[@splitIndex='true']"/>
		<xsl:param name="showMXMLOnly" select="boolean($config/options[@showMXMLOnly='true'])"/>
		<xsl:param name="showConventions" select="boolean($config/options[@showConventions!='false'])"/>
		<xsl:variable name="baseRef">
			<xsl:call-template name="getBaseRef">
				<xsl:with-param name="packageName" select="$packageName"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="href">
			<xsl:variable name="isTopLevel">
				<xsl:call-template name="isTopLevel">
					<xsl:with-param name="packageName" select="$packageName"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:if test="$isTopLevel='false'">
				<xsl:value-of select="translate($packageName,'.','/')"/>
				<xsl:text>/</xsl:text>
			</xsl:if>
		</xsl:variable>
		<xsl:if test="$copyNum='1'">
			<div class="pageTop"/>
			<table width="100%" cellpadding="0" cellspacing="0" id="titleTable" style="display:none">
				<tr>
					<td valign="left" width="64" style="padding-left:5px">
						<img src="{$baseRef}images/mm-icon.jpg" border="0">
							<xsl:attribute name="alt">
								<xsl:call-template name="getLocalizedString">
									<xsl:with-param name="key">AdobeLogo</xsl:with-param>
								</xsl:call-template>
							</xsl:attribute>
							<xsl:attribute name="title">
								<xsl:call-template name="getLocalizedString">
									<xsl:with-param name="key">AdobeLogo</xsl:with-param>
								</xsl:call-template>
							</xsl:attribute>
						</img>
					</td>
					<td align="center" valign="middle">
						<xsl:variable name="fontSize">
							<xsl:if test="string-length($config/title/@size)">
								<xsl:value-of select="$config/title/@size"/>
							</xsl:if>
							<xsl:if test="not(string-length($config/title/@size))">
								<xsl:value-of select="24"/>
							</xsl:if>
						</xsl:variable>
						<h1 style="font-size:{$fontSize}px">
							<xsl:value-of select="$title-base"/>
						</h1>
					</td>
				</tr>
				<tr>
					<td colspan="2" height="5px"/>
				</tr>
			</table>
		</xsl:if>
		<xsl:if test="not($copyNum='1')">
			<xsl:call-template name="getNavLinks">
				<xsl:with-param name="copyNum" select="$copyNum"/>
				<xsl:with-param name="baseRef" select="$baseRef"/>
				<xsl:with-param name="showPackages" select="$showPackages"/>
				<xsl:with-param name="showAllClasses" select="$showAllClasses"/>
				<xsl:with-param name="showLanguageElements" select="$showLanguageElements"/>
				<xsl:with-param name="showMXMLOnly" select="$showMXMLOnly"/>
				<xsl:with-param name="showIndex" select="$showIndex"/>
				<xsl:with-param name="splitIndex" select="$splitIndex"/>
				<xsl:with-param name="showAppendixes" select="$showAppendixes"/>
				<xsl:with-param name="showConventions" select="$showConventions"/>
				<xsl:with-param name="href" select="$href"/>
				<xsl:with-param name="fileName" select="$fileName"/>
				<xsl:with-param name="fileName2" select="$fileName2"/>
			</xsl:call-template>
		</xsl:if>
		<div width="100%" class="topLinks" align="right">
			<span>

				<xsl:if test="$showProperties">
					<a href="#propertySummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Properties']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showPackageProperties">
					<a href="package.html#propertySummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Properties']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showConstructors">
					<a href="#constructorSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Constructor']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="not($showMethods=false)">
					<a href="#methodSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Method']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showPackageFunctions">
					<a href="package.html#methodSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Functions']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showEvents">
					<a href="#eventSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Events']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showStyles">
					<a href="#styleSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Styles']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showSkinPart">
					<a href="#SkinPartSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'SkinParts']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showSkinState">
					<a href="#SkinStateSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'SkinStates']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showEffects">
					<a href="#effectSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Effects']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showConstants">
					<a href="#constantSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Constants']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showPackageConstants">
					<a href="package.html#constantSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Constants']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showInterfaces">
					<a href="package-detail.html#interfaceSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Interfaces']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showClasses">
					<a href="package-detail.html#classSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Classes']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showPackageUse">
					<a href="package-use.html"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Use']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showIncludeExamples">
					<a href="#includeExamplesSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Examples']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$additionalLinks">
					<xsl:copy-of select="$additionalLinks"/>
				</xsl:if>
			</span>
		</div>
		<xsl:if test="not($copyNum='2')">
			<xsl:call-template name="getNavLinks">
				<xsl:with-param name="copyNum" select="$copyNum"/>
				<xsl:with-param name="baseRef" select="$baseRef"/>
				<xsl:with-param name="showPackages" select="$showPackages"/>
				<xsl:with-param name="showAllClasses" select="$showAllClasses"/>
				<xsl:with-param name="showLanguageElements" select="$showLanguageElements"/>
				<xsl:with-param name="showMXMLOnly" select="$showMXMLOnly"/>
				<xsl:with-param name="showIndex" select="$showIndex"/>
				<xsl:with-param name="splitIndex" select="$splitIndex"/>
				<xsl:with-param name="showAppendixes" select="$showAppendixes"/>
				<xsl:with-param name="showConventions" select="$showConventions"/>
				<xsl:with-param name="href" select="$href"/>
				<xsl:with-param name="fileName" select="$fileName"/>
				<xsl:with-param name="fileName2" select="$fileName2"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getLinks2">
		<xsl:param name="subTitle" select="$nbsp"/>
		<xsl:param name="packageName" select="''"/>
		<xsl:param name="fileName"/>
		<xsl:param name="fileName2" select="'all-classes.html'"/>
		<xsl:param name="showInnerClasses"/>
		<xsl:param name="showConstants" select="false()"/>
		<xsl:param name="showProperties" select="true()"/>
		<xsl:param name="showConstructors" select="false()"/>
		<xsl:param name="showMethods" select="true()"/>
		<xsl:param name="showStyles" select="false()"/>
		<xsl:param name="showSkinState" select="false()"/>
		<xsl:param name="showSkinPart" select="false()"/>		
		<xsl:param name="showEffects" select="false()"/>
		<xsl:param name="showEvents" select="false()"/>
		<xsl:param name="showIncludeExamples" select="false()"/>
		<xsl:param name="showPackages" select="true()"/>
		<xsl:param name="showAllClasses" select="true()"/>
		<xsl:param name="showLanguageElements" select="boolean($config/languageElements[@show='true'])"/>
		<xsl:param name="showIndex" select="true()"/>
		<xsl:param name="showAppendixes" select="boolean($config/appendixes[@show='true'])"/>
		<xsl:param name="showPackageConstants" select="false()"/>
		<xsl:param name="showPackageProperties" select="false()"/>
		<xsl:param name="showPackageFunctions" select="false()"/>
		<xsl:param name="showInterfaces" select="false()"/>
		<xsl:param name="showClasses" select="false()"/>
		<xsl:param name="showPackageUse" select="false()"/>
		<xsl:param name="copyNum" select="'1'"/>
		<xsl:param name="additionalLinks"/>
		<xsl:param name="splitIndex" select="$config/options[@splitIndex='true']"/>
		<xsl:param name="showConventions" select="boolean($config/options[@showConventions!='false'])"/>
		<xsl:variable name="baseRef">
			<xsl:call-template name="getBaseRef">
				<xsl:with-param name="packageName" select="$packageName"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="href">
			<xsl:variable name="isTopLevel">
				<xsl:call-template name="isTopLevel">
					<xsl:with-param name="packageName" select="$packageName"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:if test="$isTopLevel='false'">
				<xsl:value-of select="translate($packageName,'.','/')"/>
				<xsl:text>/</xsl:text>
			</xsl:if>
		</xsl:variable>
		<xsl:if test="$copyNum='1'">
			<xsl:if test="not($config/options[@eclipse='true'])">
				<table class="titleTable" cellpadding="0" cellspacing="0" id="titleTable" style="display:none">
					<tr>
						<td class="titleTableTitle" align="left">
							<xsl:choose>
								<xsl:when test="$prog_language_name='javascript'"/>
								<xsl:otherwise>
									<xsl:value-of disable-output-escaping="yes" select="$page-title-base"/>
								</xsl:otherwise>
							</xsl:choose>
						</td>
						<xsl:if test="$config/options[@ion='true']">
							<td class="titleTableSearch" align="center">
								<xsl:comment>#include virtual="/livedocs/flex/3/langref/ionsearchform.ssi"</xsl:comment>
							</td>
						</xsl:if>
						<xsl:if test="$config/options[@livedocs='true']">
							<td class="titleTableSearch" align="center">
								<form class="searchForm" target="adbe_window" method="get" action="{$liveDocsSearchServlet}"
									onsubmit="this.term.value = this.termPrefix.value + &quot;\&quot;&quot; + this.search_text.value + &quot;\&quot;&quot;;">
									<input class="hidden" name="loc" value="{$liveDocsSearchLocale}" type="hidden"/>
									<input class="hidden" name="termPrefix" value="{$liveDocsSearchSite}" type="hidden"/>
									<input class="hidden" name="term" value="" type="hidden"/>
									<input class="hidden" name="area" value="" type="hidden"/>
									<input id="search-livedocs" name="search_text" value="" title="{$liveDocsSearchString}" type="text"/>
									<xsl:text> </xsl:text>
									<input type="submit" name="action" value="{$liveDocsSearch}"/>
								</form>
							</td>
						</xsl:if>
						<xsl:variable name="ref.path">
							<xsl:value-of select="$baseRef"/>
							<xsl:text>search.html</xsl:text>
						</xsl:variable>
						<xsl:if test="$config/options[@standalonesearch='true']">
							<td class="titleTableSearch" align="center">
								<form class="searchForm" method="get" action="{$ref.path}" onsubmit="submitValue();">
									<input class="hidden" name="loc" value="{$liveDocsSearchLocale}" type="hidden"/>
									<input class="hidden" name="termPrefix" value="" type="hidden"/>
									<input class="hidden" name="term" value="" type="hidden"/>
									<input class="hidden" name="area" value="" type="hidden"/>
									<input id="search-livedocs" name="search_text" value="" title="{$liveDocsSearchString}" type="text"/>
									<xsl:text> </xsl:text>
									<input type="button" name="action" value="{$liveDocsSearch}" onclick="submitValue()"/>
								</form>
							</td>
						</xsl:if>
						<td class="titleTableTopNav" align="right">
							<xsl:choose>
								<xsl:when test="$prog_language_name='javascript'"/>
								<xsl:otherwise>
									<xsl:call-template name="getNavLinks2">
										<xsl:with-param name="copyNum" select="$copyNum"/>
										<xsl:with-param name="baseRef" select="$baseRef"/>
										<xsl:with-param name="showPackages" select="$showPackages"/>
										<xsl:with-param name="showAllClasses" select="$showAllClasses"/>
										<xsl:with-param name="showLanguageElements" select="$showLanguageElements"/>
										<xsl:with-param name="showIndex" select="$showIndex"/>
										<xsl:with-param name="splitIndex" select="$splitIndex"/>
										<xsl:with-param name="showAppendixes" select="$showAppendixes"/>
										<xsl:with-param name="showConventions" select="$showConventions"/>
										<xsl:with-param name="href" select="$href"/>
										<xsl:with-param name="fileName" select="$fileName"/>
										<xsl:with-param name="fileName2" select="$fileName2"/>
									</xsl:call-template>
								</xsl:otherwise>
							</xsl:choose>
						</td>
						<td class="titleTableLogo" align="right" rowspan="3">
							<picture>
								<img src="{$baseRef}images/logo.jpg" srcset="{$baseRef}images/logo@2x.jpg 2x" class="logoImage">
									<xsl:attribute name="alt">
										<xsl:call-template name="getLocalizedString">
											<xsl:with-param name="key">AdobeLogo</xsl:with-param>
										</xsl:call-template>
									</xsl:attribute>
									<xsl:attribute name="title">
										<xsl:call-template name="getLocalizedString">
											<xsl:with-param name="key">AdobeLogo</xsl:with-param>
										</xsl:call-template>
									</xsl:attribute>
								</img>
							</picture>
						</td>
					</tr>
					<tr class="titleTableRow2">
						<td class="titleTableSubTitle" id="subTitle" align="left">
							<xsl:if test="string-length($subTitle)">
								<xsl:value-of select="$subTitle"/>
							</xsl:if>
							<xsl:if test="not(string-length($subTitle))">
								<xsl:value-of select="$nbsp"/>
							</xsl:if>
						</td>
						<td class="titleTableSubNav" id="subNav" align="right">
							<xsl:if test="$config/options[@livedocs='true']">
								<xsl:attribute name="colspan">
									<xsl:text>2</xsl:text>
								</xsl:attribute>
							</xsl:if>
							<xsl:if test="$config/options[@ion='true']">
								<xsl:attribute name="colspan">
									<xsl:text>2</xsl:text>
								</xsl:attribute>
							</xsl:if>
							<xsl:if test="$config/options[@standalonesearch='true']">
								<xsl:attribute name="colspan">
									<xsl:text>2</xsl:text>
								</xsl:attribute>
							</xsl:if>
							<xsl:choose>
								<xsl:when test="$prog_language_name='javascript'"/>
								<xsl:otherwise>
									<xsl:if test="$showProperties=true()">
										<a href="#propertySummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Properties']]/entry[2]/p"/></a>
									</xsl:if>
									<xsl:if test="$showPackageProperties">
										<a href="package.html#propertySummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Properties']]/entry[2]/p"/></a>
									</xsl:if>
									<xsl:if test="$showConstructors=true()">
										<a href="#constructorSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Constructor']]/entry[2]/p"/></a>
									</xsl:if>
									<xsl:if test="not($showMethods=false())">
										<a href="#methodSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Methods']]/entry[2]/p"/></a>
									</xsl:if>
									<xsl:if test="$showPackageFunctions">
										<a href="package.html#methodSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Functions']]/entry[2]/p"/></a>
									</xsl:if>
									<xsl:if test="$showEvents=true()">
										<a href="#eventSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Events']]/entry[2]/p"/></a>
									</xsl:if>
									<xsl:if test="$showStyles=true()">
										<a href="#styleSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Styles']]/entry[2]/p"/></a>
									</xsl:if>

									<xsl:if test="$showSkinPart=true()">
										<a href="#SkinPartSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'SkinParts']]/entry[2]/p"/></a>
									</xsl:if>
									<xsl:if test="$showSkinState=true()">
										<a href="#SkinStateSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'SkinStates']]/entry[2]/p"/></a>
									</xsl:if>
									<xsl:if test="$showEffects=true()">
										<a href="#effectSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Effects']]/entry[2]/p"/></a>
									</xsl:if>
									<xsl:if test="$showConstants=true()">
										<a href="#constantSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Constants']]/entry[2]/p"/></a>
									</xsl:if>
									<xsl:if test="$showPackageConstants">
										<a href="package.html#constantSummary"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Constants']]/entry[2]/p"/></a>
									</xsl:if>
									<xsl:if test="$showInterfaces">
										<a href="package-detail.html#interfaceSummary">
											<xsl:call-template name="getLocalizedString">
												<xsl:with-param name="key">Interfaces</xsl:with-param>
											</xsl:call-template>
										</a>
									</xsl:if>
									<xsl:if test="$showClasses">
										<xsl:variable name="href">
											<xsl:if test="$fileName != 'deprecated'">
												<xsl:text>package-detail.html</xsl:text>
											</xsl:if>
											<xsl:text>#classSummary</xsl:text>
										</xsl:variable>
										<a href="{$href}">
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Classes']]/entry[2]/p"/>
										</a>
									</xsl:if>
									<xsl:if test="$showPackageUse">
										<a href="package-use.html">
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Use']]/entry[2]/p"/>
										</a>
									</xsl:if>
									<xsl:if test="$showIncludeExamples=true()">
										<a href="#includeExamplesSummary">
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Examples']]/entry[2]/p"/>
										</a>
									</xsl:if>
									<xsl:if test="$additionalLinks">
										<xsl:copy-of select="$additionalLinks"/>
									</xsl:if>
								</xsl:otherwise>
							</xsl:choose>
						</td>
					</tr>
					<tr class="titleTableRow3">
						<td>
							<xsl:attribute name="colspan">
								<xsl:if test="$config/options[@livedocs='true']">
									<xsl:text>3</xsl:text>
								</xsl:if>
								<xsl:choose>
									<xsl:when test="not($config/options[@livedocs='true']) and $config/options[@standalonesearch='false']">
										<xsl:text>3</xsl:text>
									</xsl:when>
									<xsl:otherwise>
										<xsl:text>3</xsl:text>
									</xsl:otherwise>
								</xsl:choose>
							</xsl:attribute>
							<xsl:value-of select="$nbsp"/>
						</td>
					</tr>
				</table>
			</xsl:if>
			<script language="javascript" type="text/javascript" xml:space="preserve">
				<xsl:comment>
				<xsl:text/>
					<xsl:text>if (!isEclipse() || window.name != ECLIPSE_FRAME_NAME) {</xsl:text><xsl:text>titleBar_setSubTitle("</xsl:text><xsl:value-of select="$subTitle"/><xsl:text>"); </xsl:text><xsl:text>titleBar_setSubNav(</xsl:text><xsl:value-of select="$showConstants"/><xsl:text>,</xsl:text><xsl:value-of select="$showProperties"/><xsl:text>,</xsl:text><xsl:value-of select="$showStyles"/><xsl:text>,</xsl:text><xsl:value-of select="$showSkinPart"/><xsl:text>,</xsl:text><xsl:value-of select="$showSkinState"/><xsl:text>,</xsl:text><xsl:value-of select="$showEffects"/><xsl:text>,</xsl:text><xsl:value-of select="$showEvents"/><xsl:text>,</xsl:text><xsl:value-of select="$showConstructors"/><xsl:text>,</xsl:text><xsl:value-of select="$showMethods"/><xsl:text>,</xsl:text><xsl:value-of select="$showIncludeExamples"/><xsl:text>,</xsl:text><xsl:value-of select="$showPackageConstants"/>	<xsl:text>,</xsl:text><xsl:value-of select="$showPackageProperties"/><xsl:text>,</xsl:text><xsl:value-of select="$showPackageFunctions"/><xsl:text>,</xsl:text><xsl:value-of select="$showInterfaces"/><xsl:text>,</xsl:text><xsl:value-of select="$showClasses"/><xsl:text>,</xsl:text><xsl:value-of select="$showPackageUse"/><xsl:text>);</xsl:text><xsl:text>}</xsl:text>	<xsl:text/>
				</xsl:comment>
			</script>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getNavLinks2">
		<xsl:param name="copyNum"/>
		<xsl:param name="baseRef"/>
		<xsl:param name="showPackages"/>
		<xsl:param name="showAllClasses"/>
		<xsl:param name="showLanguageElements"/>
		<xsl:param name="showIndex"/>
		<xsl:param name="splitIndex"/>
		<xsl:param name="showAppendixes"/>
		<xsl:param name="showConventions"/>
		<xsl:param name="href"/>
		<xsl:param name="fileName"/>
		<xsl:param name="fileName2"/>
		<xsl:if test="$showPackages">
			<a href="{$baseRef}package-summary.html" onclick="loadClassListFrame('{$baseRef}all-classes.html')"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'allPackages']]/entry[2]/p"/></a>
		</xsl:if>
		<xsl:if test="$showAllClasses">
			<xsl:choose>
				<xsl:when test="$prog_language_name='javascript'"/>
				<xsl:otherwise>
					<a href="{$baseRef}class-summary.html" onclick="loadClassListFrame('{$baseRef}all-classes.html')"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'allClasses']]/entry[2]/p"/></a>
				</xsl:otherwise>
			</xsl:choose>
		</xsl:if>
		<xsl:if test="$showLanguageElements">
			<xsl:choose>
				<xsl:when test="$prog_language_name='javascript'"/>
				<xsl:otherwise>
					<a href="{$baseRef}language-elements.html"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'LanguageElements']]/entry[2]/p"/></a>
				</xsl:otherwise>
			</xsl:choose>
		</xsl:if>
		<xsl:if test="$showIndex">
			<xsl:if test="$splitIndex='false'">
				<a href="{$baseRef}all-index.html" onclick="loadClassListFrame('{$baseRef}index-list.html')"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Index']]/entry[2]/p"/></a>
			</xsl:if>
			<xsl:if test="$splitIndex!='false' and $config/languageElements/@show='true' and $config/languageElements/@operators='true'">
				<a href="{$baseRef}all-index-Symbols.html" onclick="loadClassListFrame('{$baseRef}index-list.html')"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Index']]/entry[2]/p"/></a>
			</xsl:if>
			<xsl:if test="$isLiveDocs">
				<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
			</xsl:if>
			<xsl:if test="$splitIndex!='false' and ($config/languageElements/@show!='true' or $config/languageElements/@operators!='true')">
				<a href="{$baseRef}all-index-A.html" onclick="loadClassListFrame('{$baseRef}index-list.html')"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Index']]/entry[2]/p"/></a>
			</xsl:if>
		</xsl:if>
		<xsl:if test="$showAppendixes and $config/appendixes/@show='true'">
			<a href="{$baseRef}appendixes.html"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Appendix']]/entry[2]/p"/></a>
		</xsl:if>
		<xsl:if test="$showConventions">
			<xsl:choose>
				<xsl:when test="$prog_language_name='javascript'"/>
				<xsl:otherwise>
					<a href="{$baseRef}conventions.html"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Conventions']]/entry[2]/p"/></a>
				</xsl:otherwise>
			</xsl:choose>
		</xsl:if>
		<xsl:choose>
			<xsl:when test="$prog_language_name='javascript'"/>
			<xsl:otherwise>
				<a id="framesLink{$copyNum}" href="{$baseRef}index.html?{$href}{$fileName}.html&amp;{$fileName2}">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Frames']]/entry[2]/p"/>
				</a>
			</xsl:otherwise>
		</xsl:choose>
		<a id="noFramesLink{$copyNum}" style="display:none" href="" onclick="parent.location=document.location">
			<xsl:call-template name="getLocalizedString">
				<xsl:with-param name="key">NoFrames</xsl:with-param>
			</xsl:call-template>
		</a>
	</xsl:template>
	<xsl:template name="getNavLinks">
		<xsl:param name="copyNum"/>
		<xsl:param name="baseRef"/>
		<xsl:param name="showPackages"/>
		<xsl:param name="showAllClasses"/>
		<xsl:param name="showLanguageElements"/>
		<xsl:param name="showMXMLOnly"/>
		<xsl:param name="showIndex"/>
		<xsl:param name="splitIndex"/>
		<xsl:param name="showAppendixes"/>
		<xsl:param name="showConventions"/>
		<xsl:param name="href"/>
		<xsl:param name="fileName"/>
		<xsl:param name="fileName2"/>
		<div width="100%" class="topLinks" align="right" style="padding-bottom:5px">
			<span id="navigationCell{$copyNum}" style="display:none;font-size:14px;font-weight:bold">
				<xsl:if test="$showPackages">
					<a href="{$baseRef}package-summary.html" onclick="loadClassListFrame('{$baseRef}all-classes.html')"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'allPackages']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showAllClasses">
					<a href="{$baseRef}class-summary.html" onclick="loadClassListFrame('{$baseRef}all-classes.html')"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'allClasses']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showLanguageElements">
					<a href="{$baseRef}language-elements.html"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'LanguageElements']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showMXMLOnly">
					<a href="{$baseRef}mxml-tag-detail.html" onclick="loadClassListFrame('{$baseRef}mxml-tags.html')"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'MXMLOnly']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showIndex">
					<xsl:if test="$splitIndex='false'">
						<a href="{$baseRef}all-index.html" onclick="loadClassListFrame('{$baseRef}index-list.html')">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Index']]/entry[2]/p"/>
						</a>
					</xsl:if>
					<xsl:if test="$splitIndex!='false' and $config/languageElements/@show='true' and $config/languageElements/@operators='true'">
						<a href="{$baseRef}all-index-Symbols.html" onclick="loadClassListFrame('{$baseRef}index-list.html')">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Index']]/entry[2]/p"/>
						</a>
					</xsl:if>
					<xsl:if test="$splitIndex!='false' and ($config/languageElements/@show!='true' or $config/languageElements/@operators!='true')">
						<a href="{$baseRef}all-index-A.html" onclick="loadClassListFrame('{$baseRef}index-list.html')">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Index']]/entry[2]/p"/>
						</a>
					</xsl:if>
				</xsl:if>
				<xsl:if test="$showAppendixes and $config/appendixes/@show='true'">
					<a href="{$baseRef}appendixes.html"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Appendix']]/entry[2]/p"/></a>
				</xsl:if>
				<xsl:if test="$showConventions">
					<a href="{$baseRef}conventions.html"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Conventions']]/entry[2]/p"/></a>
				</xsl:if>
				<a id="framesLink{$copyNum}" href="{$baseRef}index.html?{$href}{$fileName}.html&amp;{$fileName2}"><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Frames']]/entry[2]/p"/></a>
				<a id="noFramesLink{$copyNum}" style="display:none" href="" onclick="parent.location=document.location"><xsl:call-template name="getLocalizedString">
						<xsl:with-param name="key">NoFrames</xsl:with-param>
					</xsl:call-template></a>
			</span>
		</div>
	</xsl:template>
	<xsl:template name="getFeedbackLink">
		<xsl:param name="topic"/>
		<xsl:param name="filename"/>
		<xsl:param name="filename2" select="''"/>
		<xsl:param name="baseRef"/>
		<xsl:if test="not ($isLiveDocs)">
			<xsl:if test="$config/feedback[@show='true']">
				<xsl:choose>
					<xsl:when test="$prog_language_name='javascript'"/>
					<xsl:otherwise>
						<div class="feedbackLink">
							<center>
								<xsl:if test="$config/feedback[@type='email']">
									<a href="mailto:{$config/feedback/feedbackEmail/address/.}?subject=ASLR Feedback({$timestamp}) : {$topic}">
										<xsl:value-of select="$config/feedback/feedbackEmail/label/."/>
									</a>
								</xsl:if>
								<xsl:if test="$config/feedback[@type='livedocs']">
									<a href="javascript:gotoLiveDocs('{$filename}','{$filename2}','{$locale}');">
										<xsl:value-of select="$config/feedback/feedbackLiveDocs/label/."/>
									</a>
								</xsl:if>
							</center>
						</div>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:if>
		</xsl:if>
		<xsl:if test="$config/options[@ion='true']">
			<xsl:if test="$config/feedback[@show='true']">
				<script src="{$baseRef}currentpage.js" type="text/javascript" language="Javascript" charset="UTF-8"/>
			</xsl:if>
		</xsl:if>
		<xsl:if test="$config/options[@livedocs='true']">
			<div class="feedbackLink">
				<center>
					<xsl:if test="$config/feedback[@type='livedocs']">
						<a href="javascript:gotoLiveDocs('{$filename}','{$filename2}','{$locale}');">
							<xsl:value-of select="$config/feedback/feedbackLiveDocs/label/."/>
						</a>
					</xsl:if>
				</center>
			</div>
		</xsl:if>
	</xsl:template>
	<xsl:template name="showHelpLink">
		<xsl:if test="$config/exampleHelp and $config/exampleHelp/@show='true'">
			<xsl:variable name="linkurl" select="concat('&lt;a href=&quot;',$config/exampleHelp/linkUrl,'&quot; target=&quot;external&quot;&gt;')"/>
			<xsl:value-of disable-output-escaping="yes" select="$linkurl"/>
			<xsl:value-of disable-output-escaping="yes" select="$config/exampleHelp/linkText"/>
			<xsl:value-of disable-output-escaping="yes" select="'&lt;/a&gt;'"/>
		</xsl:if>
	</xsl:template>
	<xsl:template name="oldversion">
		<xsl:if test="$showLangVersionWarnings='true' and not(count(versions/langversion))">
			<xsl:message>WARNING: no langversion for <xsl:if test="../../@name">
					<xsl:value-of select="../../@name"/>
					<xsl:text>.</xsl:text>
				</xsl:if>
				<xsl:value-of select="@name"/>
			</xsl:message>
		</xsl:if>
		<xsl:if test="$showPlayerVersionWarnings='true' and not(count(versions/playerversion))">
			<xsl:message>WARNING: no playerversion for <xsl:if test="../../@name">
					<xsl:value-of select="../../@name"/>
					<xsl:text>.</xsl:text>
				</xsl:if>
				<xsl:value-of select="@name"/>
			</xsl:message>
		</xsl:if>
		<xsl:if test="not($config/options/@showVersions) or $config/options[@showVersions!='false']">
			<xsl:if test="count(versions/langversion[not(starts-with(@version,'1'))]) or count(versions/playerversion)">
				<p/>
				<xsl:if test="count(versions/langversion[not(starts-with(@version,'1'))])">
					<table cellpadding="0" cellspacing="0" border="0">
						<tr>
							<td style="white-space:nowrap" valign="top">
								<b>
									<xsl:call-template name="getLocalizedString">
										<xsl:with-param name="key">LanguageVersion</xsl:with-param>
									</xsl:call-template>
									<xsl:text disable-output-escaping="yes">:&amp;nbsp;</xsl:text>
								</b>
							</td>
							<td>
								<xsl:text>ActionScript </xsl:text>
								<xsl:value-of select="translate(versions/langversion/@version,'+','')"/>
								<xsl:if test="substring-before(versions/langversion/@version, '+')">
									<xsl:text> and later</xsl:text>
								</xsl:if>
								<xsl:if test="string-length(normalize-space(versions/langversion))">
									<xsl:value-of select="$emdash"/>
									<xsl:call-template name="deTilda">
										<xsl:with-param name="inText" select="normalize-space(versions/langversion)"/>
									</xsl:call-template>
								</xsl:if>
							</td>
						</tr>
					</table>
				</xsl:if>
			</xsl:if>
			<xsl:if test="not($config/options/@showVersions) or $config/options[@showVersions!='false'] or $config/options[@showRuntimeVersions='true']">
				<xsl:if test="count(versions/playerversion)">
					<table cellpadding="0" cellspacing="0" border="0">
						<tr>
							<td style="white-space:nowrap" valign="top">
								<b>
									<xsl:call-template name="getLocalizedString">
										<xsl:with-param name="key">RuntimeVersions</xsl:with-param>
									</xsl:call-template>
									<xsl:text disable-output-escaping="yes">:&amp;nbsp;</xsl:text>
								</b>
							</td>
							<td>
								<xsl:choose>
									<xsl:when test="versions/playerversion/@name='Flash'">
										<xsl:text>Flash Player </xsl:text>
									</xsl:when>
									<xsl:when test="versions/playerversion/@name='Lite'">
										<xsl:text>Flash Lite </xsl:text>
									</xsl:when>
								</xsl:choose>
								<xsl:value-of select="translate(translate(versions/playerversion/@version,'+',''),',','.')"/>
								<xsl:if test="substring-before(versions/playerversion/@version, '+')">
									<xsl:text> and later</xsl:text>
								</xsl:if>
								<xsl:if test="string-length(normalize-space(versions/playerversion))">
									<xsl:value-of select="$emdash"/>
									<xsl:call-template name="deTilda">
										<xsl:with-param name="inText" select="normalize-space(versions/playerversion)"/>
									</xsl:call-template>
								</xsl:if>
							</td>
						</tr>
					</table>
				</xsl:if>
				<p/>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<!-- TODO support multiple? -->
	<xsl:template name="version">
		<xsl:if test="$showLangVersionWarnings='true' and not(count(prolog/asMetadata/apiVersion/apiLanguage))">
			<xsl:message>WARNING: no langversion for <xsl:if test="../../apiName">
					<xsl:value-of select="../../apiName"/>
					<xsl:text>.</xsl:text>
				</xsl:if>
				<xsl:value-of select="apiName"/>
			</xsl:message>
		</xsl:if>
		<xsl:if test="$showPlayerVersionWarnings='true' and not(count(prolog/asMetadata/apiVersion/apiPlatform))">
			<xsl:message>WARNING: no playerversion for <xsl:if test="../../apiName">
					<xsl:value-of select="../../apiName"/>
					<xsl:text>.</xsl:text>
				</xsl:if>
				<xsl:value-of select="apiName"/>
			</xsl:message>
		</xsl:if>
		<xsl:if test="not($config/options/@showVersions) or $config/options[@showVersions!='false']">
			<xsl:if test="count(prolog/asMetadata/apiVersion[not(starts-with(./apiLanguage/@version,'1'))]) or count(./prolog/asMetadata/apiVersion/apiPlatform/@version)">
				<p/>
				<xsl:if test="prolog/asMetadata/apiVersion/apiLanguage/@version and count(prolog/asMetadata/apiVersion[not(starts-with(./apiLanguage/@version,'1'))])">
					<table cellpadding="0" cellspacing="0" border="0">
						<tr>
							<td style="white-space:nowrap" valign="top">
								<b>
									<xsl:call-template name="getLocalizedString">
										<xsl:with-param name="key">LanguageVersion</xsl:with-param>
									</xsl:call-template>
									<xsl:text disable-output-escaping="yes">:&amp;nbsp;</xsl:text>
								</b>
							</td>
							<td>
								<xsl:text>ActionScript </xsl:text>
								<xsl:value-of select="translate(prolog/asMetadata/apiVersion/apiLanguage/@version,'+','')"/>
								<xsl:if test="substring-before(prolog/asMetadata/apiVersion/apiLanguage/@version, '+')">
									<xsl:text> and later</xsl:text>
								</xsl:if>
								<xsl:if test="string-length(normalize-space(prolog/asMetadata/apiVersion/apiLanguage))">
									<xsl:value-of select="$emdash"/>
									<xsl:call-template name="deTilda">
										<xsl:with-param name="inText" select="normalize-space(prolog/asMetadata/apiVersion/apiLanguage)"/>
									</xsl:call-template>
								</xsl:if>
							</td>
						</tr>
					</table>
				</xsl:if>
				<!--apiLanguage-->
				<!-- Product Version -->
				<xsl:if test="count(prolog/asMetadata/apiVersion/apiTool)">
					<table cellpadding="0" cellspacing="0" border="0">
						<tr>
							<td style="white-space:nowrap" valign="top">
								<b>
									<xsl:if test="count(prolog/asMetadata/apiVersion/apiTool) = 1">
										<xsl:call-template name="getLocalizedString">
											<xsl:with-param name="key">ProductVersion</xsl:with-param>
										</xsl:call-template>
										<xsl:text disable-output-escaping="yes">:&amp;nbsp;</xsl:text>
									</xsl:if>
									<xsl:if test="count(prolog/asMetadata/apiVersion/apiTool) &gt; 1">
										<xsl:call-template name="getLocalizedString">
											<xsl:with-param name="key">ProductVersions</xsl:with-param>
										</xsl:call-template>
										<xsl:text disable-output-escaping="yes">:&amp;nbsp;</xsl:text>
									</xsl:if>
								</b>
							</td>
							<td>
								<xsl:for-each select="prolog/asMetadata/apiVersion/apiTool">
									<xsl:variable name="ToolExpanded">
										<xsl:call-template name="getLocalizedString">
											<xsl:with-param name="key">
												<xsl:value-of select="@name"/>
											</xsl:with-param>
										</xsl:call-template>
									</xsl:variable>
									<xsl:choose>
										<xsl:when test="$ToolExpanded">
											<xsl:value-of select="$ToolExpanded"/>
										</xsl:when>
										<xsl:otherwise>
											<xsl:value-of select="@name"/>
										</xsl:otherwise>
									</xsl:choose>
									<xsl:text> </xsl:text>
									<xsl:value-of select="translate(translate(@version,'+',''),',','.')"/>
									<xsl:if test="position() != last()">
										<xsl:text>,</xsl:text>
										<xsl:text> </xsl:text>
									</xsl:if>
								</xsl:for-each>
							</td>
						</tr>
					</table>
				</xsl:if>
				<!--apiTool-->

				<!-- Since -->
				<xsl:if test="count(prolog/asMetadata/apiVersion/apiSince)">
					<table cellpadding="0" cellspacing="0" border="0">
						<tr>
							<td style="white-space:nowrap" valign="top">
								<b>
									<xsl:call-template name="getLocalizedString">
										<xsl:with-param name="key">Since</xsl:with-param>
									</xsl:call-template>
									<xsl:text disable-output-escaping="yes">:&amp;nbsp;</xsl:text>
								</b>
							</td>
							<td>
								<xsl:for-each select="prolog/asMetadata/apiVersion/apiSince">
									<xsl:value-of select="translate(translate(@version,'+',''),',','.')"/>
									<xsl:if test="position() != last()">
										<xsl:text>,</xsl:text>
										<xsl:text> </xsl:text>
									</xsl:if>
								</xsl:for-each>
							</td>
						</tr>
					</table>
				</xsl:if>
				<!--apiSince-->

			</xsl:if>
			<!--apiVersion-->
		</xsl:if>
		<!--showVersion-->
		<xsl:if test="not($config/options/@showVersions) or $config/options[@showVersions!='false'] or $config/options[@showRuntimeVersions='true']">
			<!-- Multiple Versions -->
			<xsl:if test="prolog/asMetadata/apiVersion[apiPlatform]">
				<table cellpadding="0" cellspacing="0" border="0">
					<tr>
						<td style="white-space:nowrap" valign="top">
							<b>
								<xsl:call-template name="getLocalizedString">
									<xsl:with-param name="key">RuntimeVersions</xsl:with-param>
								</xsl:call-template>
								<xsl:text disable-output-escaping="yes">:&amp;nbsp;</xsl:text>
							</b>
						</td>
						<td>
							<!-- Add default air 1.0 runtime -->
							<xsl:if test="count(prolog/asMetadata/apiVersion/apiPlatform) = 1 and (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
								<xsl:text>AIR 1.0, </xsl:text>
							</xsl:if>
							<xsl:for-each select="prolog/asMetadata/apiVersion/apiPlatform">
								<xsl:choose>
									<xsl:when test="@name='Flash'">
										<xsl:text>Flash Player </xsl:text>
									</xsl:when>
									<xsl:when test="@name='AIR'">
										<xsl:text>AIR</xsl:text>
									</xsl:when>
									<xsl:when test="@name='Lite'">
										<xsl:text>Flash Lite </xsl:text>
									</xsl:when>
								</xsl:choose>
								<xsl:text> </xsl:text>
								<xsl:value-of select="translate(translate(@version,'+',''),',','.')"/>
								<xsl:if test="@description!=''">
									<xsl:text> </xsl:text>
									<xsl:text>-</xsl:text>
									<xsl:text> </xsl:text>
									<xsl:value-of select="normalize-space(@description)"/>
                                </xsl:if>
								<xsl:if test="substring-before(string-join(@version, ''), '+')">
									<xsl:text> and later</xsl:text>
								</xsl:if>
								<xsl:if test="position() != last()">
									<xsl:text>,</xsl:text>
									<xsl:text> </xsl:text>
								</xsl:if>
							</xsl:for-each>
						</td>
					</tr>
				</table>
			</xsl:if>
			<!--apiPlatform-->
			<p/>
		</xsl:if>
		<!--showVersions / showRuntimeVersions-->
	</xsl:template>
	<xsl:template name="isTopLevel">
		<xsl:param name="packageName"/>
		<xsl:value-of select="string-length($packageName)=0 or contains($packageName,'__Global__')"/>
	</xsl:template>
	<xsl:template name="getPackageComments">
		<xsl:param name="name"/>
		<xsl:element name="package">
			<xsl:copy-of select="document($packageCommentsFilename)/packages/package[@name=$name]"/>
		</xsl:element>
	</xsl:template>
	<xsl:template name="getLinkFromId">
		<xsl:param name="id" select="''"/>
		<xsl:param name="currentPackage" select="''"/>
		<xsl:param name="memberName" select="''"/>
		<xsl:if test="string-length($id) &gt; 0">
			<xsl:variable name="classNameText" select="substring-after($id,':')"/>
			<xsl:variable name="packageNameText" select="substring-before($id,':')"/>
			<xsl:variable name="packageName">
				<xsl:choose>
					<xsl:when test="not(contains($packageNameText,'.'))">
						<xsl:value-of select="''"/>
					</xsl:when>
					<xsl:otherwise>
						<xsl:value-of select="$packageNameText"/>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:variable>
			<xsl:variable name="className">
				<xsl:choose>
					<xsl:when test="contains($packageName,'.')">
						<xsl:if test="contains($classNameText,':')">
							<xsl:value-of select="substring-before($classNameText,':')"/>
						</xsl:if>
					</xsl:when>
					<xsl:otherwise>
						<xsl:value-of select="substring-before($id,':')"/>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:variable>
			<xsl:variable name="methodName">
				<xsl:choose>
					<xsl:when test="$memberName != ''">
						<xsl:value-of select="$memberName"/>
					</xsl:when>
					<xsl:when test="contains($packageName,'.')">
						<xsl:if test="contains($classNameText,':')">
							<xsl:value-of select="substring-after($classNameText,':')"/>
						</xsl:if>
					</xsl:when>
					<xsl:otherwise>
						<xsl:value-of select="substring-after($id,':')"/>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:variable>
			<xsl:variable name="hPath">
				<xsl:call-template name="getHyperlinkPath">
					<xsl:with-param name="destination" select="concat($packageName,':',$className)"/>
					<xsl:with-param name="currentPackage" select="$currentPackage"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:variable name="completeHLink">
				<xsl:if test="string-length($methodName) &gt; 0">
					<xsl:choose>
						<xsl:when test="contains($methodName,':')">
							<xsl:value-of select="concat($hPath,'#',substring-before($methodName,':'))"/>
						</xsl:when>
						<xsl:otherwise>
							<xsl:value-of select="concat($hPath,'#',$methodName)"/>
						</xsl:otherwise>
					</xsl:choose>
				</xsl:if>
			</xsl:variable>
			<xsl:value-of select="$completeHLink"/>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getClassLinkFromId">
		<xsl:param name="id" select="''"/>
		<xsl:param name="currentPackage" select="''"/>
		<xsl:if test="string-length($id) &gt; 0">
			<xsl:variable name="classNameText" select="substring-after($id,':')"/>
			<xsl:variable name="packageNameText" select="substring-before($id,':')"/>
			<xsl:variable name="packageName">
				<xsl:choose>
					<xsl:when test="not(contains($packageNameText,'.'))">
						<xsl:value-of select="''"/>
					</xsl:when>
					<xsl:otherwise>
						<xsl:value-of select="$packageNameText"/>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:variable>
			<xsl:variable name="className">
				<xsl:choose>
					<xsl:when test="contains($packageName,'.')">
						<xsl:if test="contains($classNameText,':')">
							<xsl:value-of select="substring-before($classNameText,':')"/>
						</xsl:if>
					</xsl:when>
					<xsl:otherwise>
						<xsl:value-of select="substring-before($id,':')"/>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:variable>
			<xsl:variable name="hPath">
				<xsl:call-template name="getHyperlinkPath">
					<xsl:with-param name="destination" select="concat($packageName,':',$className)"/>
					<xsl:with-param name="currentPackage" select="$currentPackage"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:value-of select="$hPath"/>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getClassNameFromId">
		<xsl:param name="id" select="''"/>
		<xsl:if test="string-length($id) &gt; 0">
			<xsl:variable name="classNameText" select="substring-after($id,':')"/>
			<xsl:variable name="packageNameText" select="substring-before($id,':')"/>
			<xsl:variable name="packageName">
				<xsl:choose>
					<xsl:when test="not(contains($packageNameText,'.')) and string-length($packageNameText) = 0">
						<xsl:value-of select="''"/>
					</xsl:when>
					<xsl:otherwise>
						<xsl:value-of select="$packageNameText"/>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:variable>
			<xsl:variable name="className">
				<xsl:choose>
					<xsl:when test="contains($packageName,'.')">
						<xsl:if test="contains($classNameText,':')">
							<xsl:value-of select="substring-before($classNameText,':')"/>
						</xsl:if>
						<xsl:if test="not(contains($classNameText,':'))">
							<xsl:value-of select="$classNameText"/>
						</xsl:if>
					</xsl:when>
					<xsl:otherwise>
						<xsl:if test="contains($classNameText,':')">
							<xsl:value-of select="substring-before($classNameText,':')"/>
						</xsl:if>
						<xsl:if test="not(contains($classNameText,':'))">
							<xsl:value-of select="$classNameText"/>
						</xsl:if>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:variable>
			<xsl:value-of select="$className"/>
		</xsl:if>
	</xsl:template>
	<xsl:template name="styleTypeHyperlink">
		<xsl:param name="type" select="''"/>
		<xsl:param name="currentPackage" select="''"/>
		<xsl:if test="$type">
			<xsl:variable name="relativePath">
				<xsl:call-template name="getRelativePath">
					<xsl:with-param name="currentPath" select="$currentPackage"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:variable name="hyperLink">
				<xsl:choose>
					<xsl:when test="not(contains($type,'.'))">
						<xsl:value-of select="concat($relativePath,$type,'.html')"/>
					</xsl:when>
					<xsl:otherwise>
						<xsl:variable name="package">
							<xsl:call-template name="substring-before-last">
								<xsl:with-param name="input" select="$type"/>
								<xsl:with-param name="substr" select="'.'"/>
							</xsl:call-template>
						</xsl:variable>
						<xsl:variable name="class">
							<xsl:call-template name="substring-after-last">
								<xsl:with-param name="input" select="$type"/>
								<xsl:with-param name="substr" select="'.'"/>
							</xsl:call-template>
						</xsl:variable>
						<xsl:value-of select="concat($relativePath,translate($package,'.','/'),'/',$class,'.html')"/>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:variable>
			<xsl:value-of select="$hyperLink"/>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getEventClassLinkFromId">
		<xsl:param name="id" select="''"/>
		<xsl:param name="currentPackage" select="''"/>
		<xsl:if test="string-length($id) &gt; 0">
			<xsl:variable name="text" select="substring-before($id,'_')"/>
			<xsl:variable name="className" select="substring-after($text,':')"/>
			<xsl:variable name="packageName" select="substring-before($text,':')"/>
			<xsl:variable name="hPath">
				<xsl:call-template name="getHyperlinkPath">
					<xsl:with-param name="destination" select="concat($packageName,':',$className)"/>
					<xsl:with-param name="currentPackage" select="$currentPackage"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:value-of select="$hPath"/>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getEventClassNameFromId">
		<xsl:param name="currentPackage"/>
		<xsl:param name="id" select="''"/>
		<xsl:if test="string-length($id) &gt; 0">
			<xsl:variable name="text" select="substring-before($id,'_')"/>
			<xsl:variable name="className" select="substring-after($text,':')"/>
			<xsl:value-of select="$className"/>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getConRefText">
		<xsl:param name="conref"/>
		<xsl:param name="descriptionType"/>
		<xsl:param name="entryType"/>
		<xsl:param name="doNotProcessTags" select="false()"/>
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:if test="string-length($conref) &gt; 0">
			<xsl:variable name="relativePath">
				<xsl:call-template name="getRelativePath">
					<xsl:with-param name="currentPath" select="$currentPackage"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:variable name="packageClassText">
				<xsl:if test="contains($conref,'#') and contains(substring-before($conref,'#'),'.')">
					<xsl:value-of select="substring-before($conref,'#')"/>
				</xsl:if>
				<xsl:if test="contains($conref,'#') and not(contains(substring-before($conref,'#'),'.'))">
					<xsl:value-of select="concat($currentPackage,'.',substring-before($conref,'#'))"/>
				</xsl:if>
				<xsl:if test="not(contains($conref,'#'))">
					<xsl:value-of select="$conref"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="className">
				<xsl:if test="contains($conref,'#') and contains(substring-before($conref,'#'),'.')">
					<xsl:call-template name="lastIndexOf">
						<xsl:with-param name="string" select="$packageClassText"/>
						<xsl:with-param name="char" select="'.'"/>
					</xsl:call-template>
				</xsl:if>
				<xsl:if test="contains($conref,'#') and not(contains(substring-before($conref,'#'),'.'))">
					<xsl:if test="string-length(substring-before($conref,'#')) = 0">
						<xsl:value-of select="ancestor-or-self::apiPackage/apiClassifier/apiName"/>
					</xsl:if>
					<xsl:if test="string-length(substring-before($conref,'#')) &gt; 0">
						<xsl:value-of select="substring-before($conref,'#')"/>
					</xsl:if>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="destPackageName1">
				<xsl:value-of select="substring-before($packageClassText,concat('.',$className))"/>
			</xsl:variable>
			<xsl:variable name="destPackageName">
				<xsl:if test="$destPackageName1 = '' or $destPackageName1='__Global__'">
					<xsl:value-of select="'__Global__.xml'"/>
				</xsl:if>
				<xsl:if test="not($destPackageName1='') and not($destPackageName1='__Global__')">
					<xsl:value-of select="concat($destPackageName1, '.xml')"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="entryTypeNameText" select="substring-after($conref,'#')"/>
			<xsl:variable name="nameToMatch">
				<xsl:if test="string-length($entryTypeNameText) = 0">
					<xsl:value-of select="$className"/>
				</xsl:if>
				<xsl:if test="contains($entryTypeNameText,':')">
					<xsl:value-of select="substring-after($entryTypeNameText,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($entryTypeNameText,':')) and string-length($entryTypeNameText) &gt; 0">
					<xsl:if test="contains($entryTypeNameText,')')">
						<xsl:value-of select="substring-before($entryTypeNameText,'(')"/>
					</xsl:if>
					<xsl:if test="not(contains($entryTypeNameText,')'))">
						<xsl:value-of select="$entryTypeNameText"/>
					</xsl:if>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="entryType">
				<xsl:if test="string-length($entryTypeNameText) = 0">
					<xsl:value-of select="'class'"/>
				</xsl:if>
				<xsl:if test="contains($entryTypeNameText,':')">
					<xsl:value-of select="substring-before($entryTypeNameText,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($entryTypeNameText,':')) and string-length($entryTypeNameText) &gt; 0">
					<xsl:if test="contains($entryTypeNameText,')')">
						<xsl:value-of select="'method'"/>
					</xsl:if>
					<xsl:if test="not(contains($entryTypeNameText,')'))">
						<xsl:value-of select="'property'"/>
					</xsl:if>
				</xsl:if>
			</xsl:variable>
			<xsl:if test="string-length(normalize-space($destPackageName)) = 4">
				<xsl:message> CAlling class : <xsl:value-of select="ancestor-or-self::apiClassifier/apiName"/> currentpackage : <xsl:value-of select="ancestor-or-self::apiPackage/apiName"/> Entry Type : <xsl:value-of
						select="$entryType"/> Entry Type Text:		<xsl:value-of select="$entryTypeNameText"/> descriptionType : <xsl:value-of select="$descriptionType"/> Conref : <xsl:value-of select="$conref"
						/> nameToMatch : <xsl:value-of select="$nameToMatch"/> Class Name : <xsl:value-of select="$className"/>	packageClassText Name : <xsl:value-of select="$packageClassText"
						/> destPackageName Name : <xsl:value-of select="$destPackageName"/>
				</xsl:message>
			</xsl:if>
			<xsl:for-each select="document(concat($ditaFileDir,$destPackageName))/apiPackage//apiClassifier[apiName=$className]">
				<xsl:if test="string-length($entryType) &gt; 0">
					<xsl:choose>
						<xsl:when test="contains($entryType,'class')">
							<xsl:choose>
								<xsl:when test="$descriptionType='shortdesc'">
									<xsl:if test="./shortdesc[@conref]">
										<xsl:call-template name="getConRefText">
											<xsl:with-param name="conref" select="./shortdesc/@conref"/>
											<xsl:with-param name="descriptionType" select="local-name(./shortdesc)"/>
										</xsl:call-template>
									</xsl:if>
									<xsl:if test="not(./shortdesc[@conref])">
										<xsl:for-each select="./shortdesc/.">
											<xsl:if test="$doNotProcessTags">
												<xsl:value-of select="."/>
											</xsl:if>
											<xsl:if test="not ($doNotProcessTags)">
												<xsl:call-template name="processTags"/>
											</xsl:if>
										</xsl:for-each>
									</xsl:if>
								</xsl:when>
								<xsl:when test="$descriptionType='apiDesc'">
									<xsl:if test="./apiClassifierDetail/apiDesc[@conref]">
										<xsl:call-template name="getConRefText">
											<xsl:with-param name="conref" select="./apiClassifierDetail/apiDesc/@conref"/>
											<xsl:with-param name="descriptionType" select="local-name(./apiClassifierDetail/apiDesc)"/>
										</xsl:call-template>
									</xsl:if>
									<xsl:if test="not(./apiClassifierDetail/apiDesc[@conref])">
										<xsl:for-each select="./apiClassifierDetail/apiDesc">
											<xsl:if test="$doNotProcessTags">
												<xsl:value-of select="."/>
											</xsl:if>
											<xsl:if test="not ($doNotProcessTags)">
												<xsl:call-template name="processTags"/>
											</xsl:if>
										</xsl:for-each>
									</xsl:if>
								</xsl:when>
								<xsl:otherwise>
									<xsl:if test="./description[@conref]">
										<xsl:call-template name="getConRefText">
											<xsl:with-param name="conref" select="./description/@conref"/>
											<xsl:with-param name="descriptionType" select="local-name(./description)"/>
										</xsl:call-template>
									</xsl:if>
									<xsl:if test="not(./description[@conref])">
										<xsl:for-each select="./description">
											<xsl:if test="$doNotProcessTags">
												<xsl:value-of select="."/>
											</xsl:if>
											<xsl:if test="not ($doNotProcessTags)">
												<xsl:call-template name="processTags"/>
											</xsl:if>
										</xsl:for-each>
									</xsl:if>
								</xsl:otherwise>
							</xsl:choose>
						</xsl:when>
						<xsl:when test="contains($entryType,'style')">
							<xsl:for-each select="./prolog/asMetadata/styles/style[@name=$nameToMatch]">
								<xsl:choose>
									<xsl:when test="$descriptionType='shortdesc'">
										<xsl:if test="./shortdesc[@conref]">
											<xsl:call-template name="getConRefText">
												<xsl:with-param name="conref" select="./shortdesc/@conref"/>
												<xsl:with-param name="descriptionType" select="local-name(./shortdesc)"/>
											</xsl:call-template>
										</xsl:if>
										<xsl:if test="not(./shortdesc[@conref])">
											<xsl:for-each select="./shortdesc/.">
												<xsl:if test="$doNotProcessTags">
													<xsl:value-of select="."/>
												</xsl:if>
												<xsl:if test="not ($doNotProcessTags)">
													<xsl:call-template name="processTags"/>
												</xsl:if>
											</xsl:for-each>
										</xsl:if>
									</xsl:when>
									<xsl:otherwise>
										<xsl:if test="./description[@conref]">
											<xsl:call-template name="getConRefText">
												<xsl:with-param name="conref" select="./description/@conref"/>
												<xsl:with-param name="descriptionType" select="local-name(./description)"/>
											</xsl:call-template>
										</xsl:if>
										<xsl:if test="not(./description[@conref])">
											<xsl:for-each select="./description">
												<xsl:if test="$doNotProcessTags">
													<xsl:value-of select="."/>
												</xsl:if>
												<xsl:if test="not ($doNotProcessTags)">
													<xsl:call-template name="processTags"/>
												</xsl:if>
											</xsl:for-each>
										</xsl:if>
									</xsl:otherwise>
								</xsl:choose>
							</xsl:for-each>
						</xsl:when>
						<xsl:when test="contains($entryType,'event')">
							<xsl:for-each select=".//adobeApiEvent[apiName=$nameToMatch]">
								<xsl:choose>
									<xsl:when test="$descriptionType='shortdesc'">
										<xsl:if test="./shortdesc[@conref]">
											<xsl:call-template name="getConRefText">
												<xsl:with-param name="conref" select="./shortdesc/@conref"/>
												<xsl:with-param name="descriptionType" select="local-name(./shortdesc)"/>
											</xsl:call-template>
										</xsl:if>
										<xsl:if test="not(./shortdesc[@conref])">
											<xsl:for-each select="./shortdesc/.">
												<xsl:if test="$doNotProcessTags">
													<xsl:value-of select="."/>
												</xsl:if>
												<xsl:if test="not ($doNotProcessTags)">
													<xsl:call-template name="processTags"/>
												</xsl:if>
											</xsl:for-each>
										</xsl:if>
									</xsl:when>
									<xsl:otherwise>
										<xsl:if test="./adobeApiEventDetail/apiDesc[@conref]">
											<xsl:call-template name="getConRefText">
												<xsl:with-param name="conref" select="./adobeApiEventDetail/apiDesc/@conref"/>
												<xsl:with-param name="descriptionType" select="local-name(./adobeApiEventDetail/apiDesc)"/>
											</xsl:call-template>
										</xsl:if>
										<xsl:if test="not(./adobeApiEventDetail/apiDesc[@conref])">
											<xsl:for-each select="./adobeApiEventDetail/apiDesc">
												<xsl:if test="$doNotProcessTags">
													<xsl:value-of select="."/>
												</xsl:if>
												<xsl:if test="not ($doNotProcessTags)">
													<xsl:call-template name="processTags"/>
												</xsl:if>
											</xsl:for-each>
										</xsl:if>
									</xsl:otherwise>
								</xsl:choose>
							</xsl:for-each>
						</xsl:when>
						<xsl:when test="contains($entryType,'method')">
							<xsl:for-each select="./apiOperation[apiName=$nameToMatch]">
								<xsl:choose>
									<xsl:when test="$descriptionType='shortdesc'">
										<xsl:if test="./shortdesc[@conref]">
											<xsl:call-template name="getConRefText">
												<xsl:with-param name="conref" select="./shortdesc/@conref"/>
												<xsl:with-param name="descriptionType" select="local-name(./shortdesc)"/>
											</xsl:call-template>
										</xsl:if>
										<xsl:if test="not(./shortdesc[@conref])">
											<xsl:for-each select="./shortdesc/.">
												<xsl:if test="$doNotProcessTags">
													<xsl:value-of select="."/>
												</xsl:if>
												<xsl:if test="not ($doNotProcessTags)">
													<xsl:call-template name="processTags"/>
												</xsl:if>
											</xsl:for-each>
										</xsl:if>
									</xsl:when>
									<xsl:otherwise>
										<xsl:if test="./apiOperationDetail/apiDesc[@conref]">
											<xsl:call-template name="getConRefText">
												<xsl:with-param name="conref" select="./apiOperationDetail/apiDesc/@conref"/>
												<xsl:with-param name="descriptionType" select="local-name(./apiOperationDetail/apiDesc)"/>
											</xsl:call-template>
										</xsl:if>
										<xsl:if test="not(./apiOperationDetail/apiDesc[@conref])">
											<xsl:for-each select="./apiOperationDetail/apiDesc">
												<xsl:if test="$doNotProcessTags">
													<xsl:value-of select="."/>
												</xsl:if>
												<xsl:if test="not ($doNotProcessTags)">
													<xsl:call-template name="processTags"/>
												</xsl:if>
											</xsl:for-each>
										</xsl:if>
									</xsl:otherwise>
								</xsl:choose>
							</xsl:for-each>
						</xsl:when>
						<xsl:when test="contains($entryType,'property')">
							<xsl:choose>
				                <xsl:when test="count(./apiValue[apiName=$nameToMatch]) &gt; 0">
				                  <xsl:for-each select="./apiValue[apiName=$nameToMatch]">
				                    <xsl:choose>
				                      <xsl:when test="$descriptionType='shortdesc'">
				                        <xsl:if test="./shortdesc[@conref]">
				                          <xsl:call-template name="getConRefText">
				                            <xsl:with-param name="conref" select="./shortdesc/@conref"/>
				                            <xsl:with-param name="descriptionType" select="local-name(./shortdesc)"/>
				                          </xsl:call-template>
				                        </xsl:if>
				                        <xsl:if test="not(./shortdesc[@conref])">
				                          <xsl:for-each select="./shortdesc/.">
				                            <xsl:if test="$doNotProcessTags">
				                              <xsl:value-of select="."/>
				                            </xsl:if>
				                            <xsl:if test="not($doNotProcessTags)">
				                              <xsl:call-template name="processTags"/>
				                            </xsl:if>
				                          </xsl:for-each>
				                        </xsl:if>
				                      </xsl:when>
				                      <xsl:otherwise>
				                        <xsl:if test="./apiValueDetail/apiDesc[@conref]">
				                          <xsl:call-template name="getConRefText">
				                            <xsl:with-param name="conref" select="./apiValueDetail/apiDesc/@conref"/>
				                            <xsl:with-param name="descriptionType" select="local-name(./apiValueDetail/apiDesc)"/>
				                          </xsl:call-template>
				                        </xsl:if>
				                        <xsl:if test="not(./apiValueDetail/apiDesc[@conref])">
				                          <xsl:for-each select="./apiValueDetail/apiDesc">
				                            <xsl:if test="$doNotProcessTags">
				                              <xsl:value-of select="."/>
				                            </xsl:if>
				                            <xsl:if test="not($doNotProcessTags)">
				                              <xsl:call-template name="processTags"/>
				                            </xsl:if>
				                          </xsl:for-each>
				                        </xsl:if>
				                      </xsl:otherwise>
				                    </xsl:choose>
				                  </xsl:for-each>                  
				                </xsl:when>
				                <xsl:when test="count(./prolog/asMetadata/skinParts/SkinPart[@name=$nameToMatch]) &gt; 0">
				                  <xsl:for-each select="./prolog/asMetadata/skinParts/SkinPart[@name=$nameToMatch]">
				                    <xsl:choose>
				                      <xsl:when test="$descriptionType='shortdesc'">
				                        <xsl:if test="./shortdesc[@conref]">
				                          <xsl:call-template name="getConRefText">
				                            <xsl:with-param name="conref" select="./shortdesc/@conref"/>
				                            <xsl:with-param name="descriptionType" select="local-name(./shortdesc)"/>
				                          </xsl:call-template>
				                        </xsl:if>
				                        <xsl:if test="not(./shortdesc[@conref])">
				                          <xsl:for-each select="./shortdesc/.">
				                            <xsl:if test="$doNotProcessTags">
				                              <xsl:value-of select="."/>
				                            </xsl:if>
				                            <xsl:if test="not($doNotProcessTags)">
				                              <xsl:call-template name="processTags"/>
				                            </xsl:if>
				                          </xsl:for-each>
				                        </xsl:if>
				                      </xsl:when>
				                      <xsl:otherwise>
				                        <xsl:if test="./description[@conref]">
				                          <xsl:call-template name="getConRefText">
				                            <xsl:with-param name="conref" select="./description/@conref"/>
				                            <xsl:with-param name="descriptionType" select="local-name(./description)"/>
				                          </xsl:call-template>
				                        </xsl:if>
				                        <xsl:if test="not(./description[@conref])">
				                          <xsl:for-each select="./description">
				                            <xsl:if test="$doNotProcessTags">
				                              <xsl:value-of select="."/>
				                            </xsl:if>
				                            <xsl:if test="not($doNotProcessTags)">
				                              <xsl:call-template name="processTags"/>
				                            </xsl:if>
				                          </xsl:for-each>
				                        </xsl:if>
				                      </xsl:otherwise>
				                    </xsl:choose>
				                  </xsl:for-each>
				                </xsl:when>
				              </xsl:choose>						
						</xsl:when>
						<xsl:otherwise>
							<xsl:choose>
								<xsl:when test="$descriptionType='shortdesc'">
									<xsl:if test="./shortdesc[@conref]">
										<xsl:call-template name="getConRefText">
											<xsl:with-param name="conref" select="./shortdesc/@conref"/>
											<xsl:with-param name="descriptionType" select="local-name(./shortdesc)"/>
										</xsl:call-template>
									</xsl:if>
									<xsl:if test="not(./shortdesc[@conref])">
										<xsl:for-each select="./shortdesc/.">
											<xsl:if test="$doNotProcessTags">
												<xsl:value-of select="."/>
											</xsl:if>
											<xsl:if test="not ($doNotProcessTags)">
												<xsl:call-template name="processTags"/>
											</xsl:if>
										</xsl:for-each>
									</xsl:if>
								</xsl:when>
								<xsl:otherwise>
									<xsl:if test="./apiClassifierDetail/apiDesc[@conref]">
										<xsl:call-template name="getConRefText">
											<xsl:with-param name="conref" select="./apiClassifierDetail/apiDesc/@conref"/>
											<xsl:with-param name="descriptionType" select="local-name(./apiClassifierDetail/apiDesc)"/>
										</xsl:call-template>
									</xsl:if>
									<xsl:if test="not(./apiClassifierDetail/apiDesc[@conref])">
										<xsl:for-each select="./apiClassifierDetail/apiDesc">
											<xsl:if test="$doNotProcessTags">
												<xsl:value-of select="."/>
											</xsl:if>
											<xsl:if test="not ($doNotProcessTags)">
												<xsl:call-template name="processTags"/>
											</xsl:if>
										</xsl:for-each>
									</xsl:if>
								</xsl:otherwise>
							</xsl:choose>
						</xsl:otherwise>
					</xsl:choose>
				</xsl:if>
			</xsl:for-each>
		</xsl:if>
	</xsl:template>
	<xsl:template name="doesClassExist">
		<xsl:param name="class_name"/>
		<xsl:variable name="xslDocPath">
			<xsl:choose>
				<xsl:when test="contains($class_name,':') and  substring-before($class_name,':') != '' ">
					<xsl:value-of select="substring-before($class_name,':')"/>
				</xsl:when>
				<xsl:otherwise>
					<xsl:value-of select="'__Global__'"/>
				</xsl:otherwise>
			</xsl:choose>
		</xsl:variable>
		<xsl:variable name="className">
			<xsl:if test="contains($class_name,':')">
				<xsl:value-of select="substring-after($class_name,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($class_name,':'))">
				<xsl:value-of select="$class_name"/>
			</xsl:if>
		</xsl:variable>
		<xsl:choose>
			<xsl:when test="ancestor::allClasses/apiPackage[@id=$xslDocPath]/apiClassifier[@id=$class_name or apiName=$class_name or apiName=$className]">
				<xsl:text>1</xsl:text>
			</xsl:when>
			<xsl:otherwise>
				<xsl:text>0</xsl:text>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="getHyperlinkPath">
		<xsl:param name="destination"/>
		<xsl:param name="currentPackage"/>
		<xsl:if test="string-length($destination) &gt; 0">
			<xsl:variable name="doesClassExist">
				<xsl:call-template name="doesClassExist">
					<xsl:with-param name="class_name" select="$destination"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:if test="$doesClassExist = '1'">
				<xsl:variable name="relativePath">
					<xsl:call-template name="getRelativePath">
						<xsl:with-param name="currentPath" select="$currentPackage"/>
					</xsl:call-template>
				</xsl:variable>
				<xsl:variable name="className">
					<xsl:if test="contains($destination,':')">
						<xsl:value-of select="substring-after($destination,':')"/>
					</xsl:if>
					<xsl:if test="not(contains($destination,':'))">
						<xsl:if test="not(contains($destination,'.'))">
							<xsl:value-of select="$destination"/>
						</xsl:if>
					</xsl:if>
				</xsl:variable>
				<xsl:variable name="packageName">
					<xsl:if test="contains($destination,':')">
						<xsl:value-of select="substring-before($destination,':')"/>
					</xsl:if>
					<xsl:if test="not(contains($destination,':'))">
						<xsl:if test="contains($destination,'.')">
							<xsl:value-of select="$destination"/>
						</xsl:if>
					</xsl:if>
				</xsl:variable>
				<xsl:if test="string-length($packageName) &gt; 0">
					<xsl:if test="string-length($className) &gt; 0">
						<xsl:value-of select="concat($relativePath,translate($packageName,'.','/'),'/',$className,'.html')"/>
					</xsl:if>
				</xsl:if>
				<xsl:if test="string-length($packageName) = 0">
					<xsl:if test="string-length($className) &gt; 0">
						<xsl:value-of select="concat($relativePath,$className,'.html')"/>
					</xsl:if>
				</xsl:if>
			</xsl:if>
			<xsl:if test="$doesClassExist != '1'"> </xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getHyperlinkRef">
		<xsl:param name="destination"/>
		<xsl:param name="baseRef"/>
		<xsl:if test="string-length($destination) &gt; 0">
			<xsl:variable name="className">
				<xsl:if test="contains($destination,':')">
					<xsl:value-of select="substring-after($destination,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($destination,':'))">
					<xsl:value-of select="$destination"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="packageName">
				<xsl:if test="contains($destination,':')">
					<xsl:value-of select="substring-before($destination,':')"/>
				</xsl:if>
			</xsl:variable>
			<xsl:if test="string-length($packageName) &gt; 0">
				<xsl:if test="string-length($className) &gt; 0">
					<xsl:value-of select="concat($baseRef,translate($packageName,'.','/'),'/',$className,'.html')"/>
				</xsl:if>
			</xsl:if>
			<xsl:if test="string-length($packageName) = 0">
				<xsl:if test="string-length($className) &gt; 0">
					<xsl:value-of select="concat($baseRef,$className,'.html')"/>
				</xsl:if>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getEventHyperlink">
		<xsl:param name="destination"/>
		<xsl:param name="currentPackage"/>
		<xsl:if test="string-length($destination) &gt; 0">

			<xsl:variable name="className">
				<xsl:call-template name="lastIndexOf">
					<xsl:with-param name="string" select="$destination"/>
					<xsl:with-param name="char" select="'.'"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:variable name="packageName">
				<xsl:if test="contains($destination,'.')">
					<xsl:value-of select="substring-before($destination,concat('.',$className))"/>
				</xsl:if>
			</xsl:variable>

			<xsl:variable name="classHeader_map" select="document('ClassHeader.xml')//apiPackage"/>
			<xsl:if test="contains($destination,'.')">
				<xsl:if test="count($classHeader_map//apiClassifier[@id=concat($packageName,':',$className)] ) &gt; 0">

					<xsl:variable name="relativePath">
						<xsl:call-template name="getRelativePath">
							<xsl:with-param name="currentPath" select="$currentPackage"/>
						</xsl:call-template>
					</xsl:variable>
					<xsl:if test="string-length($packageName) &gt; 0">
						<xsl:if test="string-length($className) &gt; 0">
							<xsl:choose>
								<xsl:when test="$prog_language_name!='javascript'">
									<xsl:value-of select="concat($relativePath,translate($packageName,'.','/'),'/',$className,'.html')"/>
								</xsl:when>
								<xsl:otherwise/>
							</xsl:choose>
						</xsl:if>
					</xsl:if>
					<xsl:if test="string-length($packageName) = 0">
						<xsl:if test="string-length($className) &gt; 0">
							<xsl:value-of select="concat($relativePath,$className,'.html')"/>
						</xsl:if>
					</xsl:if>
				</xsl:if>
			</xsl:if>
			<xsl:if test="not(contains($destination,'.'))">
				<xsl:if test="count($classHeader_map//apiClassifier[@id=concat('globalClassifier:',$className)] ) &gt; 0">

					<xsl:variable name="relativePath">
						<xsl:call-template name="getRelativePath">
							<xsl:with-param name="currentPath" select="$currentPackage"/>
						</xsl:call-template>
					</xsl:variable>
					<xsl:if test="string-length($packageName) &gt; 0">
						<xsl:if test="string-length($className) &gt; 0">
							<xsl:choose>
								<xsl:when test="$prog_language_name!='javascript'">
									<xsl:value-of select="concat($relativePath,translate($packageName,'.','/'),'/',$className,'.html')"/>
								</xsl:when>
								<xsl:otherwise/>
							</xsl:choose>
						</xsl:if>
					</xsl:if>
					<xsl:if test="string-length($packageName) = 0">
						<xsl:if test="string-length($className) &gt; 0">
							<xsl:value-of select="concat($relativePath,$className,'.html')"/>
						</xsl:if>
					</xsl:if>
				</xsl:if>
			</xsl:if>

		</xsl:if>
	</xsl:template>
	<xsl:template name="getEventTypeHyperlink">
		<xsl:param name="destination"/>
		<xsl:param name="currentPackage"/>
		<xsl:if test="string-length($destination) &gt; 0">
			<xsl:variable name="relativePath">
				<xsl:call-template name="getRelativePath">
					<xsl:with-param name="currentPath" select="$currentPackage"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:variable name="lastToken">
				<xsl:call-template name="lastIndexOf">
					<xsl:with-param name="string" select="$destination"/>
					<xsl:with-param name="char" select="'.'"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:variable name="firstPassToken" select="substring-before($destination,concat('.',$lastToken))"/>
			<xsl:variable name="eventTypeLink">
				<xsl:if test="document(concat($ditaFileDir,'packages.dita'))/apiMap//apiItemRef[substring-before(@href,'xml')=$firstPassToken]">
					<xsl:value-of select="concat($relativePath,translate($firstPassToken,'.','/'),'.html')"/>
				</xsl:if>
				<xsl:if test="not(document(concat($ditaFileDir,'packages.dita'))/apiMap//apiItemRef[substring-before(@href,'.xml')=$firstPassToken])">
					<xsl:choose>
						<xsl:when test="$prog_language_name!='javascript'">
							<xsl:value-of select="concat($relativePath,translate($firstPassToken,'.','/'),'.html#',$lastToken)"/>
						</xsl:when>
						<xsl:otherwise/>
					</xsl:choose>
				</xsl:if>
			</xsl:variable>
			<xsl:value-of select="$eventTypeLink"/>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getEventDescription">
		<xsl:param name="destination"/>
		<xsl:param name="descriptionType" select="'apiDesc'"/>
		<xsl:if test="string-length($destination) &gt; 0">
			<xsl:variable name="lastToken">
				<xsl:call-template name="lastIndexOf">
					<xsl:with-param name="string" select="$destination"/>
					<xsl:with-param name="char" select="'.'"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:variable name="firstPassToken" select="substring-before($destination,concat('.',$lastToken))"/>
			<xsl:variable name="firstPassCount" select="count(document(concat($ditaFileDir,'packages.dita'))/apiMap//apiItemRef[@href=concat($firstPassToken,'.xml')])"/>
			<xsl:if test="$firstPassCount &gt; 0">
				<xsl:variable name="packageName" select="$firstPassToken"/>
				<xsl:variable name="className" select="$lastToken"/>
				<xsl:for-each select="document(concat($ditaFileDir,$packageName,'.xml'))/apiPackage//apiClassifier[apiName=$className]">
					<xsl:choose>
						<xsl:when test="$descriptionType='apiDesc'">
							<xsl:for-each select="./apiValueDetail/apiDesc">
								<xsl:call-template name="processTags"/>
							</xsl:for-each>
						</xsl:when>
						<xsl:otherwise>
							<xsl:for-each select="./apiValueDetail/shortdesc">
								<xsl:call-template name="processTags"/>
							</xsl:for-each>
						</xsl:otherwise>
					</xsl:choose>
				</xsl:for-each>
			</xsl:if>
			<xsl:if test="not($firstPassCount &gt; 0)">
				<xsl:variable name="eventName" select="$lastToken"/>
				<xsl:variable name="className">
					<xsl:call-template name="lastIndexOf">
						<xsl:with-param name="string" select="$firstPassToken"/>
						<xsl:with-param name="char" select="'.'"/>
					</xsl:call-template>
				</xsl:variable>
				<xsl:variable name="packageName" select="substring-before($firstPassToken,concat('.',$className))"/>
				<xsl:for-each select="document(concat($ditaFileDir,$packageName,'.xml'))/apiPackage//apiClassifier[apiName=$className]">
					<xsl:for-each select=".//apiValue[apiName=$eventName and not(apiValueDetail/apiValueDef/apiProperty)]">
						<xsl:choose>
							<xsl:when test="$descriptionType='apiDesc'">
								<xsl:for-each select="./apiValueDetail/apiDesc">
									<xsl:call-template name="processTags"/>
								</xsl:for-each>
							</xsl:when>
							<xsl:otherwise>
								<xsl:for-each select="./shortdesc">
									<xsl:call-template name="processTags"/>
								</xsl:for-each>
							</xsl:otherwise>
						</xsl:choose>
					</xsl:for-each>
				</xsl:for-each>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="lastIndexOf">
		<xsl:param name="string"/>
		<xsl:param name="char"/>
		<xsl:choose>
			<xsl:when test="contains($string, $char)">
				<xsl:call-template name="lastIndexOf">
					<xsl:with-param name="string" select="substring-after($string, $char)"/>
					<xsl:with-param name="char" select="$char"/>
				</xsl:call-template>
			</xsl:when>
			<xsl:otherwise>
				<xsl:value-of select="$string"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="getFirstSentence">
		<xsl:param name="inText"/>
		<xsl:variable name="text" select="normalize-space($inText)"/>
		<xsl:variable name="periodWithTag">
			<xsl:text disable-output-escaping="yes">.&lt;</xsl:text>
		</xsl:variable>
		<xsl:choose>
			<xsl:when test="string-length($text) = 0"/>
			<xsl:when test="substring-before($text,'. ')">
				<xsl:value-of select="substring-before($text,'. ')" disable-output-escaping="yes"/>.</xsl:when>
			<xsl:when test="substring-before($text,$periodWithTag)">
				<xsl:value-of select="substring-before($inText,$periodWithTag)" disable-output-escaping="yes"/>.</xsl:when>
			<xsl:when test="substring-before($text,'.')">
				<xsl:value-of select="substring-before($text,'.')" disable-output-escaping="yes"/>.</xsl:when>
			<xsl:otherwise>
				<xsl:value-of select="$text" disable-output-escaping="yes"/>.</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="deTilda">
		<xsl:param name="inText"/>
		<xsl:variable name="text">
			<xsl:call-template name="search-and-replace">
				<xsl:with-param name="search-string" select="'~~'"/>
				<xsl:with-param name="replace-string" select="'*'"/>
				<xsl:with-param name="input">
					<xsl:call-template name="convertListing">
						<xsl:with-param name="inText" select="$inText"/>
					</xsl:call-template>
				</xsl:with-param>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="text2">
			<xsl:call-template name="search-and-replace">
				<xsl:with-param name="search-string" select="'TAAB'"/>
				<xsl:with-param name="replace-string" select="'    '"/>
				<xsl:with-param name="input" select="$text"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:value-of select="$text2" disable-output-escaping="yes"/>
	</xsl:template>
	<xsl:template name="listingIcon">
		<xsl:param name="version"/>
		<xsl:variable name="conditionalText">
			<xsl:choose>
				<xsl:when test="number($version)=3">
					<xsl:text>3.gif' alt='</xsl:text>
					<xsl:value-of select="$AS3tooltip"/>
					<xsl:text>' title='</xsl:text>
					<xsl:value-of select="$AS3tooltip"/>
				</xsl:when>
				<xsl:when test="number($version)=2">
					<xsl:text>2.gif' alt='</xsl:text>
					<xsl:value-of select="$AS2tooltip"/>
					<xsl:text>' title='</xsl:text>
					<xsl:value-of select="$AS2tooltip"/>
				</xsl:when>
				<xsl:otherwise>
					<xsl:text>1.gif' alt='</xsl:text>
					<xsl:value-of select="$AS1tooltip"/>
					<xsl:text>' title='</xsl:text>
					<xsl:value-of select="$AS1tooltip"/>
				</xsl:otherwise>
			</xsl:choose>
		</xsl:variable>
		<xsl:text disable-output-escaping="yes">&lt;img src='</xsl:text>
		<xsl:call-template name="getBaseRef">
			<xsl:with-param name="packageName" select="ancestor-or-self::apiPackage/apiName"/>
		</xsl:call-template>
		<xsl:text>images/AS</xsl:text>
		<xsl:value-of select="$conditionalText"/>
		<xsl:text>' width='96' height='15' style='margin-right:5px' /&gt;</xsl:text>
	</xsl:template>
	<xsl:template name="convertListing">
		<xsl:param name="inText" select="''"/>
		<xsl:if test="not(contains($inText,'&lt;listing'))">
			<xsl:value-of select="$inText"/>
		</xsl:if>
		<xsl:if test="contains($inText,'&lt;listing')">
			<xsl:value-of select="substring-before($inText,'&lt;listing')"/>
			<xsl:if test="$showASIcons='true'">
				<xsl:text disable-output-escaping="yes">&lt;div class='listingIcons'&gt;</xsl:text>
				<xsl:choose>
					<xsl:when test="contains(substring-before($inText,'&lt;/listing&gt;'),'version=&quot;3')">
						<xsl:call-template name="listingIcon">
							<xsl:with-param name="version" select="3"/>
						</xsl:call-template>
					</xsl:when>
					<xsl:when test="contains(substring-before($inText,'&lt;/listing&gt;'),'version=&quot;2')">
						<xsl:call-template name="listingIcon">
							<xsl:with-param name="version" select="2"/>
						</xsl:call-template>
					</xsl:when>
					<xsl:otherwise>
						<xsl:call-template name="listingIcon">
							<xsl:with-param name="version" select="1"/>
						</xsl:call-template>
					</xsl:otherwise>
				</xsl:choose>
				<xsl:text disable-output-escaping="yes">&lt;/div&gt;</xsl:text>
			</xsl:if>
			<xsl:variable name="remainder" select="substring-after(substring-after($inText,'&lt;listing'),'&gt;')"/>
			<xsl:text disable-output-escaping="yes">&lt;div class='listing'&gt;&lt;pre&gt;</xsl:text>
			<xsl:value-of select="substring-before($remainder,'&lt;/listing&gt;')"/>
			<xsl:text disable-output-escaping="yes">&lt;/pre&gt;&lt;/div&gt;</xsl:text>
			<xsl:call-template name="convertListing">
				<xsl:with-param name="inText" select="substring-after($remainder,'&lt;/listing&gt;')"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getKeywords">
		<xsl:variable name="keywords">
			<!-- TODO use defined keywords after scrub? -->
			<xsl:if test=".//Xkeyword">
				<xsl:for-each select=".//keyword">
					<xsl:value-of select="normalize-space()"/>
					<xsl:text>, </xsl:text>
				</xsl:for-each>
			</xsl:if>
			<xsl:value-of select="./apiName"/>
			<xsl:if test="string-length(../apiName)">
				<xsl:text>,</xsl:text>
				<xsl:call-template name="convertFullName">
					<xsl:with-param name="fullname" select="@id"/>
				</xsl:call-template>
			</xsl:if>
			<xsl:if test="apiValue">
				<xsl:text>,</xsl:text>
				<xsl:for-each select="//apiValue">
					<xsl:value-of select="./apiName"/>
					<xsl:if test="position() != last()">
						<xsl:text>,</xsl:text>
					</xsl:if>
				</xsl:for-each>
			</xsl:if>
			<xsl:if test="apiOperation">
				<xsl:text>,</xsl:text>
				<xsl:for-each select="//apiOperation">
					<xsl:value-of select="./apiName"/>
					<xsl:if test="position() != last()">
						<xsl:text>,</xsl:text>
					</xsl:if>
				</xsl:for-each>
			</xsl:if>
		</xsl:variable>
		<meta name="keywords" content="{$keywords}"/>
	</xsl:template>
	<xsl:template name="convertClassifierLink">
		<xsl:param name="fullname"/>
		<xsl:variable name="className">
			<xsl:if test="contains($fullname,':')">
				<xsl:value-of select="substring-after($fullname,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($fullname,':'))">
				<xsl:value-of select="$fullname"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="packageName">
			<xsl:if test="contains($fullname,':')">
				<xsl:value-of select="substring-before($fullname,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($fullname,':'))">
				<xsl:value-of select="''"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="hyperLink">
			<xsl:if test="string-length($packageName) &gt; 0 and string-length($className) &gt; 0">
				<xsl:value-of select="concat('./',translate($packageName,'.','/'),'/',$className,'.html')"/>
			</xsl:if>
			<xsl:if test="string-length($packageName) = 0 and string-length($className) &gt; 0">
				<xsl:value-of select="concat('./',$className,'.html')"/>
			</xsl:if>
		</xsl:variable>
		<xsl:value-of select="$hyperLink"/>
	</xsl:template>
	<xsl:template name="convertFullName">
		<xsl:param name="fullname"/>
		<xsl:param name="separator">.</xsl:param>
		<xsl:param name="justClass">false</xsl:param>
		<xsl:variable name="trimmed">
			<xsl:call-template name="search-and-replace">
				<xsl:with-param name="input" select="$fullname"/>
				<xsl:with-param name="search-string">:public</xsl:with-param>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="trimmed2">
			<xsl:call-template name="search-and-replace">
				<xsl:with-param name="input" select="$trimmed"/>
				<xsl:with-param name="search-string">:internal</xsl:with-param>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="trimmed3" select="translate($trimmed2,':','.')"/>
		<xsl:choose>
			<xsl:when test="$justClass = 'true'">
				<xsl:call-template name="substring-after-last">
					<xsl:with-param name="input" select="translate($trimmed3,'/','.')"/>
					<xsl:with-param name="substr">.</xsl:with-param>
				</xsl:call-template>
			</xsl:when>
			<xsl:when test="contains($trimmed3,'/')">
				<!-- inner class -->
				<xsl:value-of select="translate(substring-before($trimmed3,'/'),'.',$separator)"/>
				<xsl:text>.</xsl:text>
				<xsl:variable name="trimmed4" select="substring-after($trimmed3,'/')"/>
				<xsl:if test="contains($trimmed4,'.')">
					<xsl:variable name="trimmed5">
						<xsl:call-template name="substring-after-last">
							<xsl:with-param name="input" select="$trimmed4"/>
							<xsl:with-param name="substr" select="'.'"/>
						</xsl:call-template>
					</xsl:variable>
					<xsl:value-of select="translate($trimmed5,'.',$separator)"/>
				</xsl:if>
				<xsl:if test="not(contains($trimmed4,'.'))">
					<xsl:value-of select="translate($trimmed4,'.',$separator)"/>
				</xsl:if>
			</xsl:when>
			<xsl:otherwise>
				<xsl:value-of select="translate($trimmed3,'.',$separator)"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="buildInheritanceTree">
		<xsl:param name="package"/>
		<xsl:variable name="iconRef">
			<xsl:call-template name="getBaseRef">
				<xsl:with-param name="packageName" select="$package"/>
			</xsl:call-template>
			<xsl:text>images/</xsl:text>
			<xsl:value-of select="$inheritanceIcon"/>
		</xsl:variable>
		<pre>
			<script type="text/javascript">var tabCount=3;</script>
			<xsl:variable name="objType" select="@type"/>
			<xsl:variable name="className" select="@name"/>
			<xsl:for-each select="asAncestors/asAncestor">
				<xsl:sort select="position()" order="descending" data-type="number"/>
				<!-- TODO remove hack when interfaces no longer inherit from Object and Object no longer inherits from itself -->
				<xsl:if test="(position()=1) and ($className!='Object')">
					<a href="{classRef/@relativePath}">
						<xsl:call-template name="convertFullName">
							<xsl:with-param name="fullname" select="classRef/@fullName"/>
						</xsl:call-template>
					</a>
					<script type="text/javascript">
						<xsl:text>document.writeln();</xsl:text>
					</script>
				</xsl:if>
				<xsl:if test="position()!=1">
					<xsl:if test="$showInheritanceIcon='false'">
						<script type="text/javascript">for (var cnt=0; cnt &lt; tabCount; cnt++)document.write(" ");document.writeln("|");</script>
						<script type="text/javascript">for (var cnt=0; cnt &lt; tabCount; cnt++)document.write(" ");document.write("+--");</script>
					</xsl:if>
					<xsl:if test="$showInheritanceIcon='true'">
						<script type="text/javascript">for (var cnt=0; cnt &lt; tabCount; cnt++)document.write(" ");document.write("&lt;img src='<xsl:value-of select="$iconRef"/>' style='margin-top:1px' /&gt;");document.write(" ");
						</script>
					</xsl:if>
					<script type="text/javascript">document.writeln("&lt;a href=\"<xsl:value-of select="translate(classRef/@relativePath,':','/')"/>\"&gt;<xsl:call-template name="convertFullName">
						<xsl:with-param name="fullname" select="classRef/@fullName"/>
					</xsl:call-template>&lt;/a&gt;");</script>
					<script type="text/javascript">tabCount+=5;</script>
				</xsl:if>
			</xsl:for-each>
			<xsl:choose>
				<xsl:when test="not(asAncestors/asAncestor)">
					<script type="text/javascript">var showInheritance = false;</script></xsl:when>
				<xsl:when test="@type = 'interface'">
					<script type="text/javascript">var showInheritance = true;</script>
				</xsl:when>
				<!-- TODO remove hack when Object no longer inherits from itself -->
				<xsl:otherwise>
					<xsl:if test="@name != 'Object'">
						<script type="text/javascript">var showInheritance = true;</script>
					</xsl:if>
					<xsl:if test="@name='Object'">
						<script type="text/javascript">var showInheritance = false;</script>
					</xsl:if>
				</xsl:otherwise>
			</xsl:choose>
			<xsl:if test="$showInheritanceIcon='false'">
				<script type="text/javascript">if (showInheritance) { for (var cnt=0; cnt &lt; tabCount; cnt++)document.write(" ");document.writeln("|");}</script>
				<script type="text/javascript">if (showInheritance) { for (var cnt=0; cnt &lt; tabCount; cnt++)document.write(" ");document.write("+--");};</script>
			</xsl:if>
			<xsl:if test="$showInheritanceIcon='true'">
				<script type="text/javascript">if (showInheritance) { for (var cnt=0; cnt &lt; tabCount; cnt++)document.write(" ");document.write("&lt;img src='<xsl:value-of select="$iconRef"/>' style='margin-top:1px' /&gt;");document.write(" ");};</script>
			</xsl:if>
			<script type="text/javascript">document.writeln("<xsl:call-template name="convertFullName"><xsl:with-param name="fullname" select="@fullname"/></xsl:call-template>");</script>
		</pre>
	</xsl:template>
	<xsl:template name="sees">
		<xsl:param name="currentPackage" />
		<xsl:param name="labelClass" select="'label'"/>
		<xsl:param name="xrefId">
			<xsl:choose>
				<xsl:when test="self::operator">
					<xsl:text>operator#</xsl:text>
				</xsl:when>
				<xsl:when test="self::statement">
					<xsl:text>statement#</xsl:text>
				</xsl:when>
				<xsl:when test="self::specialType">
					<xsl:text>specialType#</xsl:text>
				</xsl:when>
				<xsl:when test="self::statements">
					<xsl:text>statements</xsl:text>
				</xsl:when>
				<xsl:when test="self::operators">
					<xsl:text>operators</xsl:text>
				</xsl:when>
				<xsl:when test="self::specialTypes">
					<xsl:text>special-types</xsl:text>
				</xsl:when>
				<xsl:otherwise>
					<xsl:if test="ancestor::apiPackage/apiName='__Global__' and not(ancestor-or-self::apiClassifier)">
						<xsl:text>global</xsl:text>
						<xsl:if test="ancestor::apiClassifier">
							<xsl:text>.</xsl:text>
						</xsl:if>
					</xsl:if>
					<xsl:if test="not(ancestor::apiPackage/apiName='__Global__')">
						<xsl:value-of select="ancestor::apiPackage/apiName"/>
						<xsl:if test="ancestor-or-self::apiClassifier">
							<xsl:text>.</xsl:text>
						</xsl:if>
					</xsl:if>
					<xsl:if test="ancestor-or-self::apiClassifier">
						<xsl:value-of select="ancestor::apiClassifier/apiName"/>
					</xsl:if>
					<xsl:choose>
						<xsl:when test="self::apiConstructor">
							<xsl:text>#method:</xsl:text>
						</xsl:when>
						<xsl:when test="self::apiOperation">
							<xsl:text>#method:</xsl:text>
						</xsl:when>
						<xsl:when test="self::apiValue">
							<xsl:text>#property:</xsl:text>
						</xsl:when>
						<xsl:when test="self::adobeApiEvent">
							<xsl:text>#event:</xsl:text>
						</xsl:when>
						<xsl:when test="self::style">
							<xsl:text>#style:</xsl:text>
						</xsl:when>
						<xsl:when test="self::effect">
							<xsl:text>#effect:</xsl:text>
						</xsl:when>
					</xsl:choose>
				</xsl:otherwise>
			</xsl:choose>
			<xsl:value-of select="apiName"/>
		</xsl:param>
		<xsl:param name="packageName">
			<xsl:if test="ancestor-or-self::apiPackage/apiName!='__Global__'">
				<xsl:value-of select="ancestor-or-self::apiPackage/apiName"/>
			</xsl:if>
		</xsl:param>
		<xsl:variable name="numSees" select="count(./related-links/link[normalize-space(./linktext) or @href])"/>
		<xsl:if test="$numSees or $xrefs/helpreferences/helpreference[normalize-space(id/.)=$xrefId]">
			<p>
				<span class="{$labelClass}">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'seeAlso']]/entry[2]/p"/>
				</span>
			</p>
			<div class="seeAlso">
				<xsl:for-each select="./related-links/link[string-length(@href) or string-length(./linktext)]">
					<xsl:if test="string-length(@href) &gt; 0">
						<!-- Get the method name -->
						<xsl:variable name="methodNameText" select="substring-after(@href,'/')"/>
						<!-- Get the Classname name -->
						<xsl:variable name="classNameText">
							<xsl:if test="contains(@href,'/')">
								<xsl:value-of select="substring-before(substring-after(@href,'#'),'/')"/>
							</xsl:if>
							<xsl:if test="not(contains(@href,'/'))">
								<xsl:value-of select="substring-after(@href,'#')"/>
							</xsl:if>
						</xsl:variable>
						<xsl:variable name="className">
							<xsl:if test="string-length($classNameText) &gt; 0">
								<xsl:value-of select="$classNameText"/>
							</xsl:if>
							<xsl:if test="string-length($classNameText) = 0">
								<xsl:value-of select="ancestor-or-self::apiClassifier/apiName"/>
							</xsl:if>
						</xsl:variable>
						<!-- Get the package name -->
						<xsl:variable name="packName">
							<xsl:choose>
								<xsl:when test="contains(@href,'.xml.xml')">
									<xsl:if test="contains(@href,'#')">
										<xsl:value-of select="substring(substring-before(@href,'#'),0,string-length(substring-before(@href,'#'))-string-length('.xml')+1)"/>
									</xsl:if>
									<xsl:if test="not(contains(@href,'#')) and not(contains(@href,'/')) and not(contains(@href,'.htm'))">
										<xsl:value-of select="substring(@href,0,string-length(@href)-string-length('.xml')+1)"/>
									</xsl:if>
								</xsl:when>
								<xsl:otherwise>
									<xsl:if test="contains(@href,'#')">
										<xsl:value-of select="substring-before(substring-before(@href,'#'),'.xml')"/>
									</xsl:if>
									<xsl:if test="not(contains(@href,'#')) and not(contains(@href,'/')) and not(contains(@href,'.htm'))">
										<xsl:value-of select="substring-before(@href,'.xml')"/>
									</xsl:if>
								</xsl:otherwise>
							</xsl:choose>
						</xsl:variable>
						<xsl:variable name="hyperlinkLocation">
							<xsl:choose>
								<xsl:when test="contains(@href,'.htm') or starts-with(@href,'http://')">
									<xsl:value-of select="@href"/>
								</xsl:when>
								<xsl:otherwise>
									<xsl:if test="string-length($packName) &gt; 0 and not($packName=ancestor-or-self::apiPackage/apiName) and  not(contains(@href,'.htm'))">
										<xsl:variable name="relPathParam">
											<xsl:if test="ancestor-or-self::apiPackage/apiName">
												<xsl:value-of select="ancestor-or-self::apiPackage/apiName"/>
											</xsl:if>
											<xsl:if test="not(ancestor-or-self::apiPackage/apiName)">
												<xsl:value-of select="$currentPackage"/>
											</xsl:if>												
										</xsl:variable>
										<xsl:variable name="relPath">
											<xsl:call-template name="getRelativePath">
												<xsl:with-param name="currentPath" select="$relPathParam"/>
											</xsl:call-template>
										</xsl:variable>
										<xsl:if test="string-length($classNameText) &gt; 0">
											<xsl:if test="string-length($methodNameText) &gt; 0 ">
												<xsl:value-of select="concat($relPath,translate($packName,'.','/'),'/',$classNameText,'.html#',$methodNameText)"/>
											</xsl:if>
											<xsl:if test="string-length($methodNameText) = 0">
												<xsl:value-of select="concat($relPath,translate($packName,'.','/'),'/',$classNameText,'.html')"/>
											</xsl:if>
										</xsl:if>
										<xsl:if test="string-length($classNameText) = 0">
											<xsl:if test="string-length($methodNameText) &gt; 0 ">
												<xsl:value-of select="concat($relPath,translate($packName,'.','/'),'/','package.html#',$methodNameText)"/>
											</xsl:if>
											<xsl:if test="string-length($methodNameText) = 0">
												<xsl:value-of select="concat($relPath,translate($packName,'.','/'),'/','package-detail.html')"/>
											</xsl:if>
										</xsl:if>
									</xsl:if>
									<xsl:if test="(string-length($packName) = 0 or  ($packName=ancestor-or-self::apiPackage/apiName)) and not(contains(@href,'.htm'))">
										<xsl:if test="string-length($classNameText) &gt; 0 and not($classNameText='global') and string-length($packName) != 0 ">
											<xsl:if test="string-length($methodNameText) &gt; 0">
												<xsl:value-of select="concat($classNameText,'.html#',$methodNameText)"/>
											</xsl:if>
											<xsl:if test="string-length($methodNameText) = 0">
												<xsl:value-of select="concat($classNameText,'.html')"/>
											</xsl:if>
										</xsl:if>
										<!-- To handle the <#Array/sort() kind of stuff in a package>-->
										<xsl:if
											test="string-length($classNameText) &gt; 0 and not($classNameText='global') and (string-length(ancestor-or-self::apiPackage/apiName) &gt; 0 or string-length($currentPackage) &gt; 0)and string-length($packName) = 0 ">
											<xsl:variable name="relPathParam">
												<xsl:if test="ancestor-or-self::apiPackage/apiName">
													<xsl:value-of select="ancestor-or-self::apiPackage/apiName"/>
												</xsl:if>
												<xsl:if test="not(ancestor-or-self::apiPackage/apiName)">
													<xsl:value-of select="$currentPackage"/>
												</xsl:if>												
											</xsl:variable>
											<xsl:variable name="relPath">
												<xsl:if test="contains($relPathParam,'.')">
													<xsl:call-template name="getRelativePath">
														<xsl:with-param name="currentPath" select="$relPathParam"/>
													</xsl:call-template>
												</xsl:if>
											</xsl:variable>
											
											<xsl:if test="string-length($methodNameText) &gt; 0">
												<xsl:value-of select="concat($relPath,$classNameText,'.html#',$methodNameText)"/>
											</xsl:if>
											<xsl:if test="string-length($methodNameText) = 0">
												<xsl:value-of select="concat($relPath,$classNameText,'.html')"/>
											</xsl:if>
										</xsl:if>
										<xsl:if test="string-length($classNameText) &gt; 0 and $classNameText='global'">
											<xsl:variable name="relPathParam">
												<xsl:if test="ancestor-or-self::apiPackage/apiName">
													<xsl:value-of select="ancestor-or-self::apiPackage/apiName"/>
												</xsl:if>
												<xsl:if test="not(ancestor-or-self::apiPackage/apiName)">
													<xsl:value-of select="$currentPackage"/>
												</xsl:if>												
											</xsl:variable>
											<xsl:variable name="relPath">
												<xsl:if test="contains($relPathParam,'.')">
													<xsl:call-template name="getRelativePath">
														<xsl:with-param name="currentPath" select="$relPathParam"/>
													</xsl:call-template>
												</xsl:if>
											</xsl:variable>
											<xsl:if test="string-length($methodNameText) &gt; 0">
												<xsl:value-of select="concat($relPath,'package.html#',$methodNameText)"/>
											</xsl:if>
										</xsl:if>
										<xsl:if test="string-length($classNameText) = 0">
											<xsl:if test="string-length($packName) &gt; 0">
												<xsl:value-of select="concat('package.html#',$methodNameText)"/>
											</xsl:if>
											<xsl:if test="string-length($packName) = 0">
												<xsl:value-of select="concat('#',$methodNameText)"/>
											</xsl:if>
										</xsl:if>
									</xsl:if>
								</xsl:otherwise>
							</xsl:choose>
						</xsl:variable>
						<xsl:variable name="linktxt" select="./linktext"/>
						<xsl:if test="$prog_language_name!='javascript'">
							<a href="{$hyperlinkLocation}">
								<xsl:attribute name="target">
									<xsl:if test="starts-with(@href,'http:')">
										<xsl:text>_top</xsl:text>
									</xsl:if>
									<xsl:if test="contains(@href,'../help/')">
										<xsl:text>_top</xsl:text>
									</xsl:if>
								</xsl:attribute>
								<xsl:if test="normalize-space(./linktext)">
									<xsl:value-of select="normalize-space(./linktext)"/>
								</xsl:if>
								<xsl:if test="not(normalize-space(./linktext))">
									<xsl:value-of select="@href"/>
								</xsl:if>
							</a>
						</xsl:if>
					</xsl:if>
					<xsl:if test="$prog_language_name!='javascript'">
						<xsl:if test="not(string-length(@href)) and string-length(./linktext) &gt; 0">
							<xsl:value-of select="normalize-space(./linktext)"/>
						</xsl:if>
						<xsl:if test="position() != last()">
							<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
						</xsl:if>
					</xsl:if>
				</xsl:for-each>
				<xsl:variable name="baseRef">
					<xsl:call-template name="getBaseRef">
						<xsl:with-param name="packageName" select="$packageName"/>
					</xsl:call-template>
				</xsl:variable>
				<xsl:for-each select="$xrefs/helpreferences/helpreference[normalize-space(id/.)=$xrefId]">
					<xsl:if test="position()=1 and $numSees">
						<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
					</xsl:if>
					<xsl:element name="a">
						<xsl:attribute name="href">
							<xsl:choose>
								<xsl:when test="not(bookfolder) or bookfolder=''">
									<xsl:value-of select="concat($baseRef,$config/xrefs/@baseRef,href/.)"/>
								</xsl:when>
								<xsl:otherwise>
									<xsl:value-of select="concat($baseRef,$config/xrefs/@baseRef,bookfolder/text(),'/',href/.)"/>
								</xsl:otherwise>
							</xsl:choose>
						</xsl:attribute>
						<xsl:if test="string-length($config/xrefs/@target)">
							<xsl:attribute name="target">
								<xsl:value-of select="$config/xrefs/@target"/>
							</xsl:attribute>
						</xsl:if>
						<xsl:variable name="titletext" select="replace(title/.,'&lt;/','&amp;lt;/')"/>
						<xsl:value-of select="$titletext"/>
					</xsl:element>
					<xsl:if test="position() != last()">
						<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
					</xsl:if>
				</xsl:for-each>
			</div>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getInheritDocText">
		<xsl:param name="baseClass"/>
		<xsl:param name="implementedInterface"/>
		<xsl:param name="descriptionType"/>
		<xsl:param name="entryType"/>
		<xsl:param name="nameToMatch"/>
		<xsl:param name="itemNameToMatch"/>
		<xsl:param name="doNotProcessTags" select="false()"/>
		<xsl:for-each select="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseInterface">
			<xsl:call-template name="inheritDocFromInterfaces">
				<xsl:with-param name="implementedInterface" select="."/>
				<xsl:with-param name="descriptionType" select="$descriptionType"/>
				<xsl:with-param name="entryType" select="$entryType"/>
				<xsl:with-param name="nameToMatch" select="$nameToMatch"/>
				<xsl:with-param name="doNotProcessTags" select="$doNotProcessTags"/>
			</xsl:call-template>
		</xsl:for-each>
		<xsl:call-template name="inheritDocFromBaseClass">
			<xsl:with-param name="baseClass" select="$baseClass"/>
			<xsl:with-param name="descriptionType" select="$descriptionType"/>
			<xsl:with-param name="entryType" select="$entryType"/>
			<xsl:with-param name="nameToMatch" select="$nameToMatch"/>
			<xsl:with-param name="itemNameToMatch" select="$itemNameToMatch"/>
			<xsl:with-param name="doNotProcessTags" select="$doNotProcessTags"/>
		</xsl:call-template>
	</xsl:template>
	<xsl:template name="inheritDocFromInterfaces">
		<xsl:param name="implementedInterface"/>
		<xsl:param name="descriptionType"/>
		<xsl:param name="entryType"/>
		<xsl:param name="nameToMatch"/>
		<xsl:param name="doNotProcessTags" select="false()"/>
		<xsl:for-each select="$implementedInterface">
			<xsl:variable name="baseClass" select="."/>
			<xsl:variable name="className">
				<xsl:if test="contains($baseClass,':')">
					<xsl:value-of select="substring-after($baseClass,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($baseClass,':'))">
					<xsl:value-of select="$baseClass"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="packageName">
				<xsl:if test="contains($baseClass,':')">
					<xsl:value-of select="substring-before($baseClass,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($baseClass,':'))">
					<xsl:value-of select="__Global__"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="xslDocPath">
				<xsl:if test="contains($baseClass,':')">
					<xsl:value-of select="concat($ditaFileDir,substring-before($baseClass,':'),'.xml')"/>
				</xsl:if>
				<xsl:if test="not(contains($baseClass,':'))">
					<xsl:value-of select="concat($ditaFileDir,'__Global__.xml')"/>
				</xsl:if>
			</xsl:variable>
			<xsl:choose>
				<xsl:when test="$entryType='apiClassifier'">
					<xsl:for-each select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$nameToMatch and apiClassifierDetail/apiClassifierDef/apiInterface]">
						<xsl:choose>
							<xsl:when test="$descriptionType='shortdesc'">
								<xsl:for-each select="./shortdesc">
									<xsl:if test="$doNotProcessTags">
										<xsl:value-of select="."/>
									</xsl:if>
									<xsl:if test="not ($doNotProcessTags)">
										<xsl:call-template name="processTags">
											<xsl:with-param name="addParagraphTags" select="false()"/>
										</xsl:call-template>
									</xsl:if>
								</xsl:for-each>
							</xsl:when>
							<xsl:when test="$descriptionType='apiDesc'">
								<xsl:for-each select="./apiClassifierDetail/apiDesc">
									<xsl:if test="$doNotProcessTags">
										<xsl:value-of select="."/>
									</xsl:if>
									<xsl:if test="not ($doNotProcessTags)">
										<xsl:call-template name="processTags">
											<xsl:with-param name="addParagraphTags" select="true()"/>
										</xsl:call-template>
									</xsl:if>
								</xsl:for-each>
							</xsl:when>
						</xsl:choose>
					</xsl:for-each>
				</xsl:when>
				<xsl:when test="$entryType='apiOperation'">
					<xsl:for-each select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className and  apiClassifierDetail/apiClassifierDef/apiInterface]/apiOperation[apiName=$nameToMatch]">
						<xsl:choose>
							<xsl:when test="$descriptionType='shortdesc'">
								<xsl:for-each select="./shortdesc">
									<xsl:if test="$doNotProcessTags">
										<xsl:value-of select="."/>
									</xsl:if>
									<xsl:if test="not ($doNotProcessTags)">
										<xsl:call-template name="processTags">
											<xsl:with-param name="addParagraphTags" select="false()"/>
										</xsl:call-template>
									</xsl:if>
								</xsl:for-each>
							</xsl:when>
							<xsl:when test="$descriptionType='apiDesc'">
								<xsl:for-each select="./apiOperationDetail/apiDesc">
									<xsl:if test="$doNotProcessTags">
										<xsl:value-of select="."/>
									</xsl:if>
									<xsl:if test="not ($doNotProcessTags)">
										<xsl:call-template name="processTags">
											<xsl:with-param name="addParagraphTags" select="true()"/>
										</xsl:call-template>
									</xsl:if>
								</xsl:for-each>
							</xsl:when>
						</xsl:choose>
					</xsl:for-each>
				</xsl:when>
				<xsl:when test="$entryType='apiValue'">
					<xsl:for-each select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className and apiClassifierDetail/apiClassifierDef/apiInterface]/apiValue[apiName=$nameToMatch]">
						<xsl:choose>
							<xsl:when test="$descriptionType='shortdesc'">
								<xsl:for-each select="./shortdesc">
									<xsl:if test="$doNotProcessTags">
										<xsl:value-of select="."/>
									</xsl:if>
									<xsl:if test="not ($doNotProcessTags)">
										<xsl:call-template name="processTags">
											<xsl:with-param name="addParagraphTags" select="false()"/>
										</xsl:call-template>
									</xsl:if>
								</xsl:for-each>
							</xsl:when>
							<xsl:when test="$descriptionType='apiDesc'">
								<xsl:for-each select="./apiValueDetail/apiDesc">
									<xsl:if test="$doNotProcessTags">
										<xsl:value-of select="."/>
									</xsl:if>
									<xsl:if test="not ($doNotProcessTags)">
										<xsl:call-template name="processTags">
											<xsl:with-param name="addParagraphTags" select="true()"/>
										</xsl:call-template>
									</xsl:if>
								</xsl:for-each>
							</xsl:when>
						</xsl:choose>
					</xsl:for-each>
				</xsl:when>
			</xsl:choose>
			<!-- Now process the base interface of the current interface-->
			<xsl:for-each select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className]/apiClassifierDetail/apiClassifierDef/apiBaseInterface">
				<xsl:call-template name="inheritDocFromInterfaces">
					<xsl:with-param name="implementedInterface" select="."/>
					<xsl:with-param name="descriptionType" select="$descriptionType"/>
					<xsl:with-param name="entryType" select="$entryType"/>
					<xsl:with-param name="nameToMatch" select="$nameToMatch"/>
					<xsl:with-param name="doNotProcessTags" select="$doNotProcessTags"/>
				</xsl:call-template>
			</xsl:for-each>
		</xsl:for-each>
	</xsl:template>
	<xsl:template name="inheritDocFromBaseClass">
		<xsl:param name="baseClass"/>
		<xsl:param name="descriptionType"/>
		<xsl:param name="entryType"/>
		<xsl:param name="nameToMatch"/>
		<xsl:param name="itemNameToMatch"/>
		<xsl:param name="doNotProcessTags" select="false()"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="packageName">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="__Global__"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="concat($ditaFileDir,substring-before($baseClass,':'),'.xml')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="concat($ditaFileDir,'__Global__.xml')"/>
			</xsl:if>
		</xsl:variable>
		<xsl:choose>
			<xsl:when test="$entryType='apiClassifier'">
				<xsl:for-each select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$nameToMatch and not(apiClassifierDetail/apiClassifierDef/apiInterface)]">
					<xsl:choose>
						<xsl:when test="$descriptionType='shortdesc'">
							<xsl:for-each select="./shortdesc">
								<xsl:if test="$doNotProcessTags">
									<xsl:value-of select="."/>
								</xsl:if>
								<xsl:if test="not ($doNotProcessTags)">
									<xsl:call-template name="processTags">
										<xsl:with-param name="addParagraphTags" select="false()"/>
									</xsl:call-template>
								</xsl:if>
							</xsl:for-each>
						</xsl:when>
						<xsl:when test="$descriptionType='apiDesc'">
							<xsl:for-each select="./apiClassifierDetail/apiDesc">
								<xsl:if test="$doNotProcessTags">
									<xsl:value-of select="."/>
								</xsl:if>
								<xsl:if test="not ($doNotProcessTags)">
									<xsl:call-template name="processTags">
										<xsl:with-param name="addParagraphTags" select="true()"/>
									</xsl:call-template>
								</xsl:if>
							</xsl:for-each>
						</xsl:when>
					</xsl:choose>
				</xsl:for-each>
			</xsl:when>
			<xsl:when test="$entryType='apiOperation'">
				<xsl:for-each select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className and not(apiClassifierDetail/apiClassifierDef/apiInterface)]/apiOperation[apiName=$nameToMatch]">
					<xsl:choose>
						<xsl:when test="$descriptionType='shortdesc'">
							<xsl:for-each select="./shortdesc">
								<xsl:if test="$doNotProcessTags">
									<xsl:value-of select="."/>
								</xsl:if>
								<xsl:if test="not ($doNotProcessTags)">
									<xsl:call-template name="processTags">
										<xsl:with-param name="addParagraphTags" select="false()"/>
									</xsl:call-template>
								</xsl:if>
							</xsl:for-each>
						</xsl:when>
						<xsl:when test="$descriptionType='apiDesc'">
							<xsl:for-each select="./apiOperationDetail/apiDesc">
								<xsl:if test="$doNotProcessTags">
									<xsl:value-of select="."/>
								</xsl:if>
								<xsl:if test="not ($doNotProcessTags)">
									<xsl:call-template name="processTags">
										<xsl:with-param name="addParagraphTags" select="false()"/>
									</xsl:call-template>
								</xsl:if>
							</xsl:for-each>
						</xsl:when>
					</xsl:choose>
				</xsl:for-each>
			</xsl:when>
			<xsl:when test="$entryType='apiValue'">
				<xsl:for-each select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className and not(apiClassifierDetail/apiClassifierDef/apiInterface)]/apiValue[apiName=$nameToMatch]">
					<xsl:choose>
						<xsl:when test="$descriptionType='shortdesc'">
							<xsl:for-each select="./shortdesc">
								<xsl:if test="$doNotProcessTags">
									<xsl:value-of select="."/>
								</xsl:if>
								<xsl:if test="not ($doNotProcessTags)">
									<xsl:call-template name="processTags">
										<xsl:with-param name="addParagraphTags" select="false()"/>
									</xsl:call-template>
								</xsl:if>
							</xsl:for-each>
						</xsl:when>
						<xsl:when test="$descriptionType='apiDesc'">
							<xsl:for-each select="./apiValueDetail/apiDesc">
								<xsl:if test="$doNotProcessTags">
									<xsl:value-of select="."/>
								</xsl:if>
								<xsl:if test="not ($doNotProcessTags)">
									<xsl:call-template name="processTags">
										<xsl:with-param name="addParagraphTags" select="true()"/>
									</xsl:call-template>
								</xsl:if>
							</xsl:for-each>
						</xsl:when>
					</xsl:choose>
				</xsl:for-each>
			</xsl:when>
			<xsl:when test="$entryType='apiParam'">
				<xsl:for-each
					select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className and not(apiClassifierDetail/apiClassifierDef/apiInterface)]/apiOperation[apiName=$nameToMatch]/apiOperationDetail/apiOperationDef/apiParam[apiItemName=$itemNameToMatch]">
					<xsl:choose>
						<xsl:when test="$descriptionType='shortdesc'">
							<xsl:for-each select="./shortdesc">
								<xsl:if test="$doNotProcessTags">
									<xsl:value-of select="."/>
								</xsl:if>
								<xsl:if test="not ($doNotProcessTags)">
									<xsl:call-template name="processTags">
										<xsl:with-param name="addParagraphTags" select="false()"/>
									</xsl:call-template>
								</xsl:if>
							</xsl:for-each>
						</xsl:when>
						<xsl:when test="$descriptionType='apiDesc'">
							<xsl:for-each select="./apiDesc">
								<xsl:if test="$doNotProcessTags">
									<xsl:value-of select="."/>
								</xsl:if>
								<xsl:if test="not ($doNotProcessTags)">
									<xsl:call-template name="processTags">
										<xsl:with-param name="addParagraphTags" select="false()"/>
									</xsl:call-template>
								</xsl:if>
							</xsl:for-each>
						</xsl:when>
					</xsl:choose>
				</xsl:for-each>
			</xsl:when>
			<xsl:when test="$entryType='apiReturn'">
				<xsl:for-each
					select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className and not(apiClassifierDetail/apiClassifierDef/apiInterface)]/apiOperation[apiName=$nameToMatch]/apiOperationDetail/apiOperationDef/apiReturn">
					<xsl:choose>
						<xsl:when test="$descriptionType='shortdesc'">
							<xsl:for-each select="./shortdesc">
								<xsl:if test="$doNotProcessTags">
									<xsl:value-of select="."/>
								</xsl:if>
								<xsl:if test="not ($doNotProcessTags)">
									<xsl:call-template name="processTags">
										<xsl:with-param name="addParagraphTags" select="false()"/>
									</xsl:call-template>
								</xsl:if>
							</xsl:for-each>
						</xsl:when>
						<xsl:when test="$descriptionType='apiDesc'">
							<xsl:for-each select="./apiDesc">
								<xsl:if test="$doNotProcessTags">
									<xsl:value-of select="."/>
								</xsl:if>
								<xsl:if test="not ($doNotProcessTags)">
									<xsl:call-template name="processTags">
										<xsl:with-param name="addParagraphTags" select="false()"/>
									</xsl:call-template>
								</xsl:if>
							</xsl:for-each>
						</xsl:when>
					</xsl:choose>
				</xsl:for-each>
			</xsl:when>
		</xsl:choose>
		<xsl:if test="not($className='Object')">
			<xsl:variable name="newBaseClass"
				select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className and not(apiClassifierDetail/apiClassifierDef/apiInterface)]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
			<xsl:if test="string-length($newBaseClass) &gt; 0">
				<xsl:call-template name="inheritDocFromBaseClass">
					<xsl:with-param name="baseClass" select="$newBaseClass"/>
					<xsl:with-param name="descriptionType" select="$descriptionType"/>
					<xsl:with-param name="entryType" select="$entryType"/>
					<xsl:with-param name="nameToMatch" select="$nameToMatch"/>
					<xsl:with-param name="itemNameToMatch" select="$itemNameToMatch"/>
					<xsl:with-param name="doNotProcessTags" select="$doNotProcessTags"/>
				</xsl:call-template>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getSimpleClassName">
		<xsl:param name="fullClassName"/>
		<xsl:param name="baseRef"/>
		<xsl:choose>
			<xsl:when test="contains($fullClassName,':') and not(contains($fullClassName,'Vector$'))">
				<xsl:call-template name="substring-after-last">
					<xsl:with-param name="input" select="$fullClassName"/>
					<xsl:with-param name="substr" select="':'"/>
				</xsl:call-template>
			</xsl:when>
			<xsl:when test="contains($fullClassName,'.') and not(contains($fullClassName,'Vector$'))">
				<xsl:call-template name="substring-after-last">
					<xsl:with-param name="input" select="$fullClassName"/>
					<xsl:with-param name="substr" select="'.'"/>
				</xsl:call-template>
			</xsl:when>
			<xsl:otherwise>
				<!-- Vector  -->
				<xsl:choose>
					<xsl:when test="contains($fullClassName,'Vector$')">
						<xsl:variable name="vector.link" select="$fullClassName"/>
						<xsl:if test="not(contains($fullClassName,'*'))">
							<xsl:variable name="bef.vec" select="substring-before($fullClassName,'$')"/>
							<xsl:variable name="aft.vec" select="substring-after($fullClassName,'$')"/>
							<xsl:variable name="bef.vec.file" select="concat($baseRef,$bef.vec,'.html')"/>
							<xsl:variable name="aft.vec.aft" select="substring-after($aft.vec,':')"/>
							<xsl:variable name="aft.vec.bef" select="substring-before($aft.vec,':')"/>
							<xsl:variable name="aft.vec.file">
								<xsl:if test="contains($aft.vec,':')">
									<xsl:variable name="aft.vec.bef" select="substring-before($aft.vec,':')"/>
									<xsl:variable name="aft.vec.aft" select="substring-after($aft.vec,':')"/>
									<xsl:value-of select="concat($baseRef,translate($aft.vec.bef,'.','/'),'/',$aft.vec.aft,'.html')"/>
								</xsl:if>
								<xsl:if test="not(contains($aft.vec,':'))">
									<xsl:variable name="aft.vec.file" select="concat($baseRef,$aft.vec,'.html')"/>
									<xsl:value-of select="$aft.vec.file"/>
								</xsl:if>
							</xsl:variable>
							<xsl:if test="count($class.File.Name[apiName[.=$bef.vec]] ) &gt; 0">
								<a href="{$bef.vec.file}">
									<xsl:value-of select="$bef.vec"/>
								</a>
							</xsl:if>
							<xsl:if test="count($class.File.Name[apiName[.=$bef.vec]]) = 0">
								<xsl:value-of select="$bef.vec"/>

							</xsl:if>
							<xsl:text>.</xsl:text>
							<xsl:text>&amp;lt;</xsl:text>
							<xsl:choose>
								<!-- Matched ID's -->
								<xsl:when test="$class.File.Name[apiName[.=$aft.vec]]">
									<a href="{$aft.vec.file}">
										<xsl:value-of select="$aft.vec"/>
									</a>
								</xsl:when>
								<xsl:when test="$class.File.Name[@id=$aft.vec and apiName[.=$aft.vec.aft]]">
									<a href="{$aft.vec.file}">
										<xsl:value-of select="$aft.vec.aft"/>
									</a>
								</xsl:when>
								<!-- Non-Matched ID's -->
								<xsl:otherwise>
									<xsl:if test="contains($aft.vec,':')">
										<xsl:value-of select="$aft.vec.aft"/>
									</xsl:if>
									<xsl:if test="not(contains($aft.vec,':'))">
										<xsl:if test="contains($aft.vec,'$')">
											<xsl:call-template name="getSimpleClassName">
												<xsl:with-param name="fullClassName" select="$aft.vec"/>
												<xsl:with-param name="baseRef" select="$baseRef"/>
											</xsl:call-template>
										</xsl:if>
										<xsl:if test="not(contains($aft.vec,'$'))">
											<xsl:value-of select="$aft.vec"/>
										</xsl:if>
									</xsl:if>
								</xsl:otherwise>
							</xsl:choose>
							<xsl:text>&amp;gt;</xsl:text>
						</xsl:if>
						<!-- Vector: Special Types -->
						<xsl:if test="contains($fullClassName,'Vector$*')">
							<xsl:variable name="bef.vec" select="substring-before($fullClassName,'$')"/>
							<xsl:variable name="aft.vec" select="substring-after($fullClassName,'$')"/>
							<xsl:variable name="bef.vec.file" select="concat($baseRef,$bef.vec,'.html')"/>
							<xsl:variable name="aft.vec.file" select="concat($baseRef,$aft.vec,'.html')"/>
							<a href="{$bef.vec.file}">
								<xsl:value-of select="$bef.vec"/>
							</a>
							<xsl:text>.</xsl:text>
							<xsl:text>&amp;lt;</xsl:text>
							<xsl:call-template name="getSpecialTypeLink">
								<xsl:with-param name="type" select="'*'"/>
								<xsl:with-param name="baseRef" select="$baseRef"/>
							</xsl:call-template>
							<xsl:text>&amp;gt;</xsl:text>
						</xsl:if>
					</xsl:when>
					<xsl:otherwise>
						<xsl:value-of select="$fullClassName"/>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="getSpecialTypeLink">
		<xsl:param name="type"/>
		<xsl:param name="baseRef">
			<xsl:call-template name="getBaseRef">
				<xsl:with-param name="packageName">
					<xsl:if test="ancestor::apiClassifier">
						<xsl:value-of select="ancestor-or-self::apiPackage/apiName"/>
					</xsl:if>
					<xsl:if test="not(ancestor::apiClassifier)">
						<xsl:value-of select="ancestor-or-self::apiPackage/apiName"/>
					</xsl:if>
				</xsl:with-param>
			</xsl:call-template>
		</xsl:param>
		<xsl:choose>
			<xsl:when test="$config/languageElements[@show='true' and @specialTypes='true']">
				<a href="{$baseRef}specialTypes.html#{$type}">
					<xsl:value-of select="$type"/>
				</a>
			</xsl:when>
			<xsl:otherwise>
				<xsl:value-of select="$type"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:variable name="deprecatedLabel">
		<b>
			<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Deprecated']]/entry[2]/p"/>
		</b>
	</xsl:variable>
	<xsl:template match="deprecated">
		<xsl:param name="showDescription" select="'true'"/>
		<xsl:copy-of select="$deprecatedLabel"/>
		<xsl:if test="string-length(@as-of)">
			<xsl:text> since </xsl:text>
			<xsl:value-of select="normalize-space(@as-of)"/>
		</xsl:if>
		<xsl:if test="$showDescription='true' and string-length(normalize-space())">
			<xsl:value-of select="$emdash"/>
			<xsl:call-template name="deTilda">
				<xsl:with-param name="inText" select="normalize-space()"/>
			</xsl:call-template>
		</xsl:if>
		<xsl:if test="$showDescription!='true' or not(string-length(normalize-space()))">
			<xsl:text>.</xsl:text>
		</xsl:if>
		<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
	</xsl:template>
	<xsl:template match="item" mode="annotate">
		<xsl:for-each select="annotation">
			<xsl:choose>
				<xsl:when test="@type='text'">
					<div class="annotation">
						<xsl:value-of disable-output-escaping="yes" select="."/>
					</div>
				</xsl:when>
			</xsl:choose>
		</xsl:for-each>
	</xsl:template>
	<xsl:template name="shortDescriptionReview">
		<xsl:variable name="asCustomsText">
			<xsl:value-of select="./prolog/asCustoms/review"/>
		</xsl:variable>
		<xsl:if test="string-length($asCustomsText) &gt; 0">
			<xsl:if test="$asCustomsText and $config/options/@showReview='true'">
				<xsl:value-of select="$nbsp"/>
				<font color="red">Review Needed.<xsl:value-of select="$nbsp"/>
				</font>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getPageTitlePostFix">
		<xsl:if test="string-length($config/pageTitlePostFix/.)">
			<xsl:text> </xsl:text>
			<xsl:value-of select="$config/pageTitlePostFix/."/>
		</xsl:if>
	</xsl:template>
	<xsl:template name="addKeywords">
		<xsl:param name="keyword"/>
		<xsl:param name="num" select="$config/keywords/@num"/>
		<xsl:if test="$config/keywords[@show='true'] and $keyword">
			<div style="display:none">
				<xsl:call-template name="duplicateString">
					<xsl:with-param name="input" select="concat($keyword,' ')"/>
					<xsl:with-param name="count" select="$num"/>
				</xsl:call-template>
			</div>
		</xsl:if>
	</xsl:template>
	<xsl:template name="duplicateString">
		<xsl:param name="input"/>
		<xsl:param name="count" select="1"/>
		<xsl:choose>
			<xsl:when test="not($count) or not($input)"/>
			<xsl:when test="$count=1">
				<xsl:value-of select="$input"/>
			</xsl:when>
			<xsl:otherwise>
				<xsl:if test="$count mod 2">
					<xsl:value-of select="$input"/>
				</xsl:if>
				<xsl:call-template name="duplicateString">
					<xsl:with-param name="input" select="concat($input,$input)"/>
					<xsl:with-param name="count" select="floor($count div 2)"/>
				</xsl:call-template>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="substring-before-last">
		<xsl:param name="input"/>
		<xsl:param name="substr"/>
		<xsl:if test="$substr and contains($input,$substr)">
			<xsl:variable name="tmp" select="substring-after($input,$substr)"/>
			<xsl:value-of select="substring-before($input,$substr)"/>
			<xsl:if test="contains($tmp,$substr)">
				<xsl:value-of select="$substr"/>
				<xsl:call-template name="substring-before-last">
					<xsl:with-param name="input" select="$tmp"/>
					<xsl:with-param name="substr" select="$substr"/>
				</xsl:call-template>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="substring-after-last">
		<xsl:param name="input"/>
		<xsl:param name="substr"/>
		<xsl:variable name="tmp" select="substring-after($input,$substr)"/>
		<xsl:choose>
			<xsl:when test="$substr and contains($tmp,$substr)">
				<xsl:call-template name="substring-after-last">
					<xsl:with-param name="input" select="$tmp"/>
					<xsl:with-param name="substr" select="$substr"/>
				</xsl:call-template>
			</xsl:when>
			<xsl:otherwise>
				<xsl:value-of select="$tmp"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="search-and-replace">
		<xsl:param name="input"/>
		<xsl:param name="search-string"/>
		<xsl:param name="replace-string"/>
		<xsl:choose>
			<xsl:when test="$search-string and contains($input,$search-string)">
				<xsl:value-of select="substring-before($input,$search-string)"/>
				<xsl:value-of select="$replace-string"/>
				<xsl:call-template name="search-and-replace">
					<xsl:with-param name="input" select="substring-after($input,$search-string)"/>
					<xsl:with-param name="search-string" select="$search-string"/>
					<xsl:with-param name="replace-string" select="$replace-string"/>
				</xsl:call-template>
			</xsl:when>
			<xsl:otherwise>
				<xsl:value-of select="$input" disable-output-escaping="no"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template match="p" mode="terms">
		<xsl:param name="class"/>
		<xsl:param name="package"/>
		<xsl:param name="as-of"/>
		<xsl:param name="type"/>
		<xsl:param name="value"/>
		<xsl:apply-templates mode="terms">
			<xsl:with-param name="class" select="$class"/>
			<xsl:with-param name="package" select="$package"/>
			<xsl:with-param name="as-of" select="$as-of"/>
			<xsl:with-param name="type" select="$type"/>
			<xsl:with-param name="value" select="$value"/>
		</xsl:apply-templates>
	</xsl:template>
	<xsl:template match="class" mode="terms">
		<xsl:param name="class"/>
		<xsl:value-of select="$class"/>
	</xsl:template>
	<xsl:template match="package" mode="terms">
		<xsl:param name="package"/>
		<xsl:value-of select="$package"/>
	</xsl:template>
	<xsl:template match="as-of" mode="terms">
		<xsl:param name="as-of"/>
		<xsl:value-of select="$as-of"/>
	</xsl:template>
	<xsl:template match="type" mode="terms">
		<xsl:param name="type"/>
		<xsl:value-of select="$type"/>
	</xsl:template>
	<xsl:template match="value" mode="terms">
		<xsl:param name="value"/>
		<xsl:value-of select="$value"/>
	</xsl:template>
	<xsl:template match="* | @*" mode="terms" priority="-1">
		<xsl:copy>
			<xsl:apply-templates mode="terms"/>
		</xsl:copy>
	</xsl:template>
	<xsl:template name="getLocalizedString">
		<xsl:param name="key"/>
		<xsl:choose>
			<xsl:when test="$asdoc_terms/row[entry[1][p/text() = $key]]/entry[2]/p">
				<xsl:text> </xsl:text>
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = $key]]/entry[2]/p"/>
				<xsl:text> </xsl:text>
			</xsl:when>
			<xsl:otherwise>
				<xsl:value-of select="$key"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="getAppendixLocalizedString">
		<xsl:param name="key"/>
		<xsl:choose>
			<xsl:when test="$asdoc_terms/row[entry[1][p/text() = $key]]/entry[2]/p">
				<xsl:text> </xsl:text>
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = $key]]/entry[2]/p"/>
				<xsl:text> </xsl:text>
			</xsl:when>
			<xsl:otherwise>
				<xsl:text> </xsl:text>
				<xsl:value-of select="$config/appendixes/appendix[@overview=$key]/@label"/>
				<xsl:text> </xsl:text>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<!-- For HTML Processing-->
	<xsl:template name="processTags">
		<xsl:param name="addParagraphTags" select="false()"/>
		<xsl:param name="createLinkFromRootContext" select="false()"/>
		<xsl:param name="event"/>
		<xsl:variable name="matchHTML" select="./adobetable |  ./ol |  ./p | ./codeblock |  ./ul |  ./b |  ./adobeimage | ./ph |  ./codeph | ./bold | ./strong |  ./em |  ./i |  ./xref | ./pre | ./text() | ./li| ./sup"/>
		<xsl:for-each select="$matchHTML">
			<xsl:if test="self::text()">
				<xsl:if test="$addParagraphTags">
					<xsl:if test="position()=1">
						<xsl:value-of disable-output-escaping="yes" select="'&lt;p&gt;'"/>
					</xsl:if>
				</xsl:if>
				<xsl:variable name="text">
					<xsl:if test="contains(.,'~~')">
						<xsl:call-template name="search-and-replace">
							<xsl:with-param name="search-string" select="'~~'"/>
							<xsl:with-param name="replace-string" select="'*'"/>
							<xsl:with-param name="input" select="."/>
						</xsl:call-template>
					</xsl:if>
					<xsl:if test="not(contains(.,'~~'))">
						<xsl:value-of select="."/>
					</xsl:if>
				</xsl:variable>
				<xsl:variable name="retext" select="replace($text,'&lt;mx','&amp;lt;mx')"/>
				<xsl:variable name="re.text" select="replace($retext,'&lt;','&amp;lt;')"/>
				<xsl:if test="$event!='eventdesc'">
					<xsl:value-of select="replace($re.text,'&lt;/mx','&amp;lt;/mx')"/>
				</xsl:if>
				<xsl:if test="$event='eventdesc'">
					<xsl:value-of select="."/>
				</xsl:if>
				<xsl:if test="$addParagraphTags">
					<xsl:if test="position()=last()">
						<xsl:value-of disable-output-escaping="yes" select="'&lt;/p&gt;'"/>
					</xsl:if>
				</xsl:if>
			</xsl:if>
			<xsl:if test="self::codeblock">
				<xsl:apply-templates select="."/>
			</xsl:if>
			<xsl:if test="self::ol | self::ul">
				<xsl:apply-templates select="."/>
			</xsl:if>
			<xsl:if test="self::li">
				<xsl:apply-templates select="."/>
			</xsl:if>
			<xsl:if test="self::p">
				<xsl:apply-templates select="."/>
			</xsl:if>
			<xsl:if test="self::b | self::bold | self::strong">
				<xsl:apply-templates select="."/>
			</xsl:if>
			<xsl:if test="self::adobetable">
				<xsl:apply-templates select="."/>
			</xsl:if>
			<xsl:if test="self::adobeimage">
				<xsl:apply-templates select="."/>
			</xsl:if>
			<xsl:if test="self::ph">
				<xsl:apply-templates select="."/>
			</xsl:if>
			<xsl:if test="self::sup">
				<xsl:apply-templates select="."/>
			</xsl:if>
			<xsl:if test="self::em | self::i">
				<xsl:apply-templates select="."/>
			</xsl:if>
			<xsl:if test="self::codeph">
				<xsl:apply-templates select="."/>
			</xsl:if>
			<xsl:if test="self::xref">
				<xsl:apply-templates select=".">
					<xsl:with-param name="createLinkFromRootContext" select="$createLinkFromRootContext"/>
				</xsl:apply-templates>
			</xsl:if>
			<xsl:if test="self::pre">
				<xsl:apply-templates select="."/>
			</xsl:if>
		</xsl:for-each>
	</xsl:template>
	<xsl:template match="codeblock">
		<xsl:variable name="product" select="./@product|./@class[contains(.,'only')] | ./@outputclass"/>
		<xsl:if test="string-length($product)=0 or $product=concat($productName,'only')">
			<!-- for some reason, asdoc includes all whitespace before
				the * in documentation comments -->
			<!-- the Feathers codebase uses tabs for indentation, and one
				space before *, so we can remove the space -->
			<xsl:variable name="deTabbed">
				<xsl:call-template name="search-and-replace">
					<xsl:with-param name="input" select="."/>
					<xsl:with-param name="search-string" select="'&#09; '"/>
					<xsl:with-param name="replace-string" select="'&#09;'"/>
				</xsl:call-template>
			</xsl:variable>
			<!-- Feathers examples only use spaces so we can safely remove
				all tabs in code blocks -->
			<xsl:variable name="deTabbed" select="replace($deTabbed,'&#09;','')"/>
			<xsl:variable name="listingversion" select="./@rev"/>
			<xsl:variable name="openTag">
				<xsl:if test="string-length($listingversion) &gt; 0">
					<xsl:value-of select="concat('&lt;div class=&quot;','listing','&quot; version=&quot;',$listingversion,'&quot;&gt;')"/>
				</xsl:if>
				<xsl:if test="string-length($listingversion) = 0">
					<xsl:value-of select="concat('&lt;div class=&quot;','listing','&quot;&gt;')"/>
				</xsl:if>
			</xsl:variable>
			<xsl:value-of disable-output-escaping="yes" select="$openTag"/>
			<xsl:value-of disable-output-escaping="yes" select="'&lt;pre&gt;'"/>
			<xsl:if test="contains($deTabbed,'~~')">
				<xsl:call-template name="search-and-replace">
					<xsl:with-param name="input" select="$deTabbed"/>
					<xsl:with-param name="search-string" select="'~~'"/>
					<xsl:with-param name="replace-string" select="'*'"/>		
				</xsl:call-template>
			</xsl:if>
			<xsl:variable name="text" select="replace($deTabbed,'&lt;','&amp;lt;')"/>
			<xsl:variable name="finaltext" select="replace($text,'&gt;','&amp;gt;')"/>
			<xsl:if test="not(contains($deTabbed,'~~'))">
				<xsl:value-of select="$finaltext"/>
			</xsl:if>
			<xsl:value-of disable-output-escaping="yes" select="'&lt;/pre&gt;'"/>
			<xsl:value-of disable-output-escaping="yes" select="'&lt;/div&gt;'"/>
		</xsl:if>
	</xsl:template>
	<xsl:template match="ol | ul">
		<xsl:variable name="product" select="./@product|./@class[contains(.,'only')] | ./@outputclass"/>
		<xsl:if test="string-length($product)=0 or $product=concat($productName,'only')">
			<xsl:variable name="openTag">
				<xsl:variable name="className" select="./@outputclass"/>
				<xsl:if test="self::ol">
					<xsl:if test="string-length($className) &gt; 0">
						<xsl:value-of disable-output-escaping="yes" select="concat('&lt;ol type=&quot;',$className,'&quot; &gt;')"/>
					</xsl:if>
					<xsl:if test="string-length($className) = 0">
						<xsl:value-of disable-output-escaping="yes" select="'&lt;ol&gt;'"/>
					</xsl:if>
				</xsl:if>
				<xsl:if test="self::ul">
					<xsl:if test="string-length($className) &gt; 0">
						<xsl:value-of disable-output-escaping="yes" select="concat('&lt;ul type=&quot;',$className,'&quot; &gt;')"/>
					</xsl:if>
					<xsl:if test="string-length($className) = 0">
						<xsl:value-of disable-output-escaping="yes" select="'&lt;ul&gt;'"/>
					</xsl:if>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="closeTag">
				<xsl:if test="self::ol">
					<xsl:value-of disable-output-escaping="yes" select="'&lt;/ol&gt;'"/>
				</xsl:if>
				<xsl:if test="self::ul">
					<xsl:value-of disable-output-escaping="yes" select="'&lt;/ul&gt;'"/>
				</xsl:if>
			</xsl:variable>
			<xsl:value-of disable-output-escaping="yes" select="$openTag"/>
			<xsl:call-template name="processTags"/>
			<xsl:value-of disable-output-escaping="yes" select="$closeTag"/>
		</xsl:if>
	</xsl:template>
	<xsl:template match="li">
		<xsl:variable name="product" select="./@product|./@class[contains(.,'only')] | ./@outputclass"/>
		<xsl:if test="string-length($product)=0 or $product=concat($productName,'only')">
			<xsl:value-of disable-output-escaping="yes" select="'&lt;li&gt;'"/>
			<xsl:call-template name="processTags"/>
			<xsl:value-of disable-output-escaping="yes" select="'&lt;/li&gt;'"/>
		</xsl:if>
	</xsl:template>
	<xsl:template match="p">
		<xsl:variable name="product" select="./@product|./@class[contains(.,'only')] | ./@outputclass"/>
		<xsl:if test="string-length($product)=0 or $product=concat($productName,'only')">
			<xsl:value-of disable-output-escaping="yes" select="'&lt;p&gt;'"/>
			<xsl:call-template name="processTags"/>
			<xsl:value-of disable-output-escaping="yes" select="'&lt;/p&gt;'"/>
		</xsl:if>
	</xsl:template>
	<xsl:template match="b | bold | strong">
		<xsl:variable name="product" select="./@product|./@class[contains(.,'only')] | ./@outputclass"/>
		<xsl:if test="string-length($product)=0 or $product=concat($productName,'only')">
			<xsl:value-of disable-output-escaping="yes" select="'&lt;b&gt;'"/>
			<xsl:call-template name="processTags"/>
			<xsl:value-of disable-output-escaping="yes" select="'&lt;/b&gt;'"/>
		</xsl:if>
	</xsl:template>
	<xsl:template match="sup">
		<xsl:variable name="product" select="./@product|./@class[contains(.,'only')] | ./@outputclass"/>
		<xsl:if test="string-length($product)=0 or $product=concat($productName,'only')">
			<xsl:value-of disable-output-escaping="yes" select="'&lt;sup&gt;'"/>
			<xsl:call-template name="processTags"/>
			<xsl:value-of disable-output-escaping="yes" select="'&lt;/sup&gt;'"/>
		</xsl:if>
	</xsl:template>
	<xsl:template match="pre">
		<xsl:variable name="product" select="./@product | ./@class[contains(.,'only')] | ./@outputclass"/>
		<xsl:if test="string-length($product)=0 or $product=concat($productName,'only')">
			<xsl:value-of disable-output-escaping="yes" select="'&lt;pre&gt;'"/>
			<xsl:call-template name="processTags"/>
			<xsl:value-of disable-output-escaping="yes" select="'&lt;/pre&gt;'"/>
		</xsl:if>
	</xsl:template>
	<xsl:template match="em | i">
		<xsl:variable name="product" select="./@product|./@class[contains(.,'only')] | ./@outputclass"/>
		<xsl:if test="string-length($product)=0 or $product=concat($productName,'only')">
			<xsl:value-of disable-output-escaping="yes" select="'&lt;i&gt;'"/>
			<xsl:call-template name="processTags"/>
			<xsl:value-of disable-output-escaping="yes" select="'&lt;/i&gt;'"/>
		</xsl:if>
	</xsl:template>
	<xsl:template match="codeph">
		<xsl:variable name="product" select="./@product|./@class[contains(.,'only')] | ./@outputclass"/>
		<xsl:if test="string-length($product)=0 or $product=concat($productName,'only')">
			<xsl:value-of disable-output-escaping="yes" select="'&lt;code&gt;'"/>
			<xsl:choose>
				<xsl:when test="contains(.,'&lt;') and contains(.,'&gt;')">
					<xsl:variable name="rep" select="replace(.,'&lt;','&amp;lt;')"/>
					<xsl:value-of select="replace($rep,'&gt;','&amp;gt;')"/>
				</xsl:when>
				<xsl:otherwise>
					<xsl:call-template name="processTags"/>
				</xsl:otherwise>
			</xsl:choose>
			<xsl:value-of disable-output-escaping="yes" select="'&lt;/code&gt;'"/>
		</xsl:if>
	</xsl:template>
	<xsl:template match="adobetable">
		<xsl:variable name="product" select="./@product|./@class[contains(.,'only')] | ./@outputclass"/>
		<xsl:if test="string-length($product)=0 or $product=concat($productName,'only')">
			<xsl:variable name="colCount" select="./tgroup/@cols"/>
			<xsl:if test="string-length(./@class) &gt; 0">
				<xsl:value-of disable-output-escaping="yes" select="concat('&lt;table class=&quot;',./@class,'&quot; &gt;')"/>
			</xsl:if>
			<xsl:if test="string-length(./@class) = 0">
				<xsl:value-of disable-output-escaping="yes" select="'&lt;table &gt;'"/>
			</xsl:if>
			<xsl:for-each select="./tgroup/thead//row">
				<tr>
					<xsl:for-each select="entry">
						<xsl:choose>
							<xsl:when test="string-length(./@align) &gt; 0">
								<xsl:value-of disable-output-escaping="yes" select="concat('&lt;th align=&quot;',./@align,'&quot;&gt;')"/>
								<xsl:call-template name="processTags"/>
								<xsl:value-of disable-output-escaping="yes" select="'&lt;/th&gt;'"/>
							</xsl:when>
							<xsl:otherwise>
								<th>
									<xsl:call-template name="processTags"/>
								</th>
							</xsl:otherwise>
						</xsl:choose>
					</xsl:for-each>
				</tr>
			</xsl:for-each>
			<xsl:for-each select="./tgroup/tbody//row">
				<tr>
					<xsl:for-each select="entry">
						<xsl:choose>
							<xsl:when test="string-length(./@align) &gt; 0">
								<xsl:value-of disable-output-escaping="yes" select="concat('&lt;td align=&quot;',./@align,'&quot;&gt;')"/>
								<xsl:call-template name="processTags"/>
								<xsl:value-of disable-output-escaping="yes" select="'&lt;/td&gt;'"/>
							</xsl:when>
							<xsl:otherwise>
								<td>
									<xsl:call-template name="processTags"/>
								</td>
							</xsl:otherwise>
						</xsl:choose>
					</xsl:for-each>
				</tr>
			</xsl:for-each>
			<xsl:value-of disable-output-escaping="yes" select="'&lt;/table&gt;'"/>
		</xsl:if>
	</xsl:template>
	<xsl:template match="adobeimage">
		<xsl:variable name="product" select="./@product|./@class[contains(.,'only')] | ./@outputclass"/>
		<xsl:if test="string-length($product)=0 or $product=concat($productName,'only')">
			<xsl:variable name="hrefUrl" select="./@href"/>
			<xsl:variable name="alt.text" select="./@alt"/>
			<xsl:variable name="openTag">
				<xsl:if test="string-length($hrefUrl) &gt; 0">
					<xsl:if test="string-length($alt.text) &gt; 0">
						<xsl:value-of disable-output-escaping="yes" select="concat('&lt;img src=&quot;',$hrefUrl,'&quot; alt=&quot;',$alt.text,'&quot;&gt;')"/>
					</xsl:if>								
					<xsl:if test="not(string-length($alt.text) &gt; 0)">
						<xsl:value-of disable-output-escaping="yes" select="concat('&lt;img src=&quot;',$hrefUrl,'&quot; &gt;')"/>
					</xsl:if>								
				</xsl:if>			
				<xsl:if test="not(string-length($hrefUrl) &gt; 0) and not(string-length($alt.text) &gt; 0)">
					<xsl:value-of disable-output-escaping="yes" select="'&lt;img&gt;'"/>
				</xsl:if>					
			</xsl:variable>
			<xsl:variable name="closeTag">
				<xsl:value-of disable-output-escaping="yes" select="'&lt;/img&gt;'"/>
			</xsl:variable>
			<xsl:value-of disable-output-escaping="yes" select="$openTag"/>
			<xsl:call-template name="processTags"/>
			<xsl:value-of disable-output-escaping="yes" select="$closeTag"/>
		</xsl:if>
	</xsl:template>
	<xsl:template match="ph">
		<xsl:variable name="product" select="./@product|./@class[contains(.,'only')] | ./@outputclass"/>
		<xsl:if test="string-length($product)=0 or $product=concat($productName,'only')">
			<xsl:variable name="class" select="./@outputclass"/>
			<xsl:choose>
				<xsl:when test="$class='br'">
					<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
				</xsl:when>
				<xsl:otherwise>
					<xsl:variable name="openTag">
						<xsl:if test="string-length($class) &gt; 0">
							<xsl:value-of disable-output-escaping="yes" select="concat('&lt;span src=&quot;',$class,'&quot;&gt;')"/>
						</xsl:if>
						<xsl:if test="not(string-length($class) &gt; 0)">
							<xsl:value-of disable-output-escaping="yes" select="'&lt;span&gt;'"/>
						</xsl:if>
					</xsl:variable>
					<xsl:variable name="closeTag">
						<xsl:value-of disable-output-escaping="yes" select="'&lt;/span&gt;'"/>
					</xsl:variable>
					<xsl:value-of disable-output-escaping="yes" select="$openTag"/>
					<xsl:call-template name="processTags"/>
					<xsl:value-of disable-output-escaping="yes" select="$closeTag"/>
				</xsl:otherwise>
			</xsl:choose>
		</xsl:if>
	</xsl:template>
	<xsl:template match="xref">
		<xsl:param name="createLinkFromRootContext" select="false()"/>
		<xsl:variable name="product" select="./@product|./@class[contains(.,'only')] | ./@outputclass"/>
		<xsl:if test="string-length($product)=0 or $product=concat($productName,'only')">
			<xsl:variable name="source">
				<xsl:choose>
					<xsl:when test="$process_xref_href_attribute ='0' or contains(@href,'http://') or contains(@href,'.htm')">
						<xsl:value-of select="@href"/>
					</xsl:when>
					<xsl:otherwise>
						<xsl:call-template name="getLinkURL">
							<xsl:with-param name="href" select="@href"/>
							<xsl:with-param name="createLinkFromRootContext" select="$createLinkFromRootContext"/>
						</xsl:call-template>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:variable>
			<xsl:variable name="target" select="@scope"/>
			<xsl:variable name="openTag">
				<xsl:if test="string-length($source) &gt; 0">
					<xsl:value-of disable-output-escaping="yes" select="concat('&lt;a href=&quot;',$source,'&quot; target=&quot;',$target,'&quot;&gt;')"/>
				</xsl:if>
				<xsl:if test="not(string-length($source) &gt; 0)">
					<xsl:value-of disable-output-escaping="yes" select="'&lt;a&gt;'"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="closeTag">
				<xsl:value-of disable-output-escaping="yes" select="'&lt;/a&gt;'"/>
			</xsl:variable>
			<xsl:value-of disable-output-escaping="yes" select="$openTag"/>
			<xsl:call-template name="processTags"/>
			<xsl:value-of disable-output-escaping="yes" select="$closeTag"/>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getLinkURL">
		<xsl:param name="href"/>
		<xsl:param name="createLinkFromRootContext" select="false()"/>
		<xsl:if test="string-length(@href) &gt; 0">
			<xsl:variable name="methodNameText" select="substring-after(@href,'/')"/>
			<xsl:variable name="classNameText">
				<xsl:if test="contains(@href,'/')">
					<xsl:value-of select="substring-before(substring-after(@href,'#'),'/')"/>
				</xsl:if>
				<xsl:if test="not(contains(@href,'/'))">
					<xsl:value-of select="substring-after(@href,'#')"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="className">
				<xsl:if test="string-length($classNameText) &gt; 0">
					<xsl:value-of select="$classNameText"/>
				</xsl:if>
				<xsl:if test="string-length($classNameText) = 0">
					<xsl:value-of select="ancestor-or-self::apiClassifier/apiName"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="packName">
				<xsl:choose>
					<xsl:when test="contains(@href,'.xml.xml')">
						<xsl:if test="contains(@href,'#')">
							<xsl:value-of select="substring(substring-before(@href,'#'),0,string-length(substring-before(@href,'#'))-string-length('.xml')+1)"/>
						</xsl:if>
						<xsl:if test="not(contains(@href,'#')) and not(contains(@href,'/')) and not(contains(@href,'.htm'))">
							<xsl:value-of select="substring(@href,0,string-length(@href)-string-length('.xml')+1)"/>
						</xsl:if>
					</xsl:when>
					<xsl:otherwise>
						<xsl:if test="contains(@href,'#')">
							<xsl:value-of select="substring-before(substring-before(@href,'#'),'.xml')"/>
						</xsl:if>
						<xsl:if test="not(contains(@href,'#')) and not(contains(@href,'/')) and not(contains(@href,'.htm'))">
							<xsl:value-of select="substring-before(@href,'.xml')"/>
						</xsl:if>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:variable>
			<xsl:if test="contains(@href,'.htm') ">
				<xsl:value-of select="@href"/>
			</xsl:if>
			<xsl:choose>
				<xsl:when test="string-length($packName) &gt; 0 and ( not($packName=ancestor-or-self::apiPackage/apiName) or $createLinkFromRootContext = true() )and  not(contains(@href,'.htm'))">
					<xsl:variable name="relPath">
						<xsl:if test="$createLinkFromRootContext = false() and contains(ancestor-or-self::apiPackage/apiName,'.')">
							<xsl:call-template name="getRelativePath">
								<xsl:with-param name="currentPath" select="ancestor-or-self::apiPackage/apiName"/>
							</xsl:call-template>
						</xsl:if>
					</xsl:variable>
					<xsl:if test="string-length($classNameText) &gt; 0">
						<xsl:if test="string-length($methodNameText) &gt; 0 ">
							<xsl:value-of select="concat($relPath,translate($packName,'.','/'),'/',$classNameText,'.html#',$methodNameText)"/>
						</xsl:if>
						<xsl:if test="string-length($methodNameText) = 0">
							<xsl:value-of select="concat($relPath,translate($packName,'.','/'),'/',$classNameText,'.html')"/>
						</xsl:if>
					</xsl:if>
					<xsl:if test="string-length($classNameText) = 0">
						<xsl:if test="string-length($methodNameText) &gt; 0 ">
							<xsl:value-of select="concat($relPath,translate($packName,'.','/'),'/','package.html#',$methodNameText)"/>
						</xsl:if>
						<xsl:if test="string-length($methodNameText) = 0">
							<xsl:value-of select="concat($relPath,translate($packName,'.','/'),'/','package-detail.html')"/>
						</xsl:if>
					</xsl:if>
				</xsl:when>
				<xsl:otherwise>
					<xsl:if test="(string-length($packName) = 0 or  ($packName=ancestor-or-self::apiPackage/apiName)) and not(contains(@href,'.htm'))">
						<xsl:if test="string-length($classNameText) &gt; 0 and not($classNameText='global') and string-length($packName) != 0 ">
							<xsl:if test="string-length($methodNameText) &gt; 0">
								<xsl:value-of select="concat($classNameText,'.html#',$methodNameText)"/>
							</xsl:if>
							<xsl:if test="string-length($methodNameText) = 0">
								<xsl:value-of select="concat($classNameText,'.html')"/>
							</xsl:if>
						</xsl:if>
						<!-- To handle the <#Array/sort() kind of stuff in a package>-->
						<xsl:if test="string-length($classNameText) &gt; 0 and not($classNameText='global') and string-length(ancestor-or-self::apiPackage/apiName) &gt; 0 and string-length($packName) = 0 ">
							<xsl:variable name="relPath">
								<xsl:if test="$prog_language_name = 'ActionScript' and contains(ancestor-or-self::apiPackage/apiName,'.')">
									<xsl:call-template name="getRelativePath">
										<xsl:with-param name="currentPath" select="ancestor-or-self::apiPackage/apiName"/>
									</xsl:call-template>
								</xsl:if>
							</xsl:variable>
							<xsl:if test="string-length($methodNameText) &gt; 0">
								<xsl:value-of select="concat($relPath,$classNameText,'.html#',$methodNameText)"/>
							</xsl:if>
							<xsl:if test="string-length($methodNameText) = 0">
								<xsl:value-of select="concat($relPath,$classNameText,'.html')"/>
							</xsl:if>
						</xsl:if>
						<xsl:if test="string-length($classNameText) &gt; 0 and $classNameText='global'">
							<xsl:variable name="relPath">
								<xsl:if test="contains(ancestor-or-self::apiPackage/apiName,'.')">
									<xsl:call-template name="getRelativePath">
										<xsl:with-param name="currentPath" select="ancestor-or-self::apiPackage/apiName"/>
									</xsl:call-template>
								</xsl:if>
							</xsl:variable>
							<xsl:if test="string-length($methodNameText) &gt; 0">
								<xsl:value-of select="concat($relPath,'package.html#',$methodNameText)"/>
							</xsl:if>
						</xsl:if>
						<xsl:if test="string-length($classNameText) = 0">
							<xsl:value-of select="concat('#',$methodNameText)"/>
						</xsl:if>
					</xsl:if>
				</xsl:otherwise>
			</xsl:choose>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getDeprecatedReplacementLink">
		<xsl:param name="replacement"/>
		<xsl:param name="currentPackage"/>
		<xsl:param name="linkFromRootContext" select="false()"/>
		<xsl:param name="ancestorPath"/>
		<xsl:param name="anchorPrefix" select="''"/>
		<xsl:param name="mode" select="''"/>

		<xsl:variable name="relativePath">
			<xsl:call-template name="getRelativePath">
				<xsl:with-param name="currentPath" select="$currentPackage"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:choose>
			<xsl:when test="$ancestorPath">
				<xsl:variable name="lastToken">
					<xsl:call-template name="lastIndexOf">
						<xsl:with-param name="string" select="$replacement"/>
						<xsl:with-param name="char" select="'.'"/>
					</xsl:call-template>
				</xsl:variable>
				<xsl:variable name="firstPassToken" select="substring-before($replacement,concat('.',$lastToken))"/>
				<xsl:choose>
					<xsl:when test="string-length($firstPassToken) &gt; 0">
						<xsl:if test="$linkFromRootContext = false()">
							<xsl:value-of select="$relativePath"/>
						</xsl:if>
					</xsl:when>
					<xsl:otherwise>
						<xsl:if test="$linkFromRootContext = true()">
							<xsl:value-of select="translate($currentPackage,'.','/')"/>
							<xsl:text>/</xsl:text>
						</xsl:if>
					</xsl:otherwise>
				</xsl:choose>
				<xsl:value-of select="concat(translate($replacement,'.','/'),'.html')"/>
			</xsl:when>
			<xsl:otherwise>
				<xsl:variable name="lastToken">
					<xsl:call-template name="lastIndexOf">
						<xsl:with-param name="string" select="$replacement"/>
						<xsl:with-param name="char" select="'.'"/>
					</xsl:call-template>
				</xsl:variable>
				<xsl:variable name="firstPassToken" select="substring-before($replacement,concat('.',$lastToken))"/>
				<xsl:variable name="className">
					<xsl:call-template name="lastIndexOf">
						<xsl:with-param name="string" select="$firstPassToken"/>
						<xsl:with-param name="char" select="'.'"/>
					</xsl:call-template>
				</xsl:variable>
				<xsl:variable name="packageName" select="substring-before($firstPassToken,concat('.',$className))"/>
				<xsl:choose>
					<xsl:when test="string-length($packageName) &gt; 0">
						<xsl:if test="$linkFromRootContext = false()">
							<xsl:value-of select="$relativePath"/>
						</xsl:if>
					</xsl:when>
					<xsl:otherwise>
						<xsl:if test="$linkFromRootContext = true()">
							<xsl:value-of select="translate($currentPackage,'.','/')"/>
							<xsl:text>/</xsl:text>
						</xsl:if>
					</xsl:otherwise>
				</xsl:choose>
				<xsl:choose>
					<xsl:when test="string-length($firstPassToken) &gt; 0">
						<xsl:value-of select="concat(translate($firstPassToken,'.','/'),'.html')"/>
					</xsl:when>
					<xsl:otherwise>
						<xsl:if test="$linkFromRootContext = true()">
							<xsl:value-of select="concat(ancestor::apiClassifier/apiName,'.html')"/>
						</xsl:if>
					</xsl:otherwise>
				</xsl:choose>
				<xsl:choose>
					<xsl:when test="string-length($mode) = 0">
						<xsl:value-of select="concat('#', $anchorPrefix, $lastToken)"/>
					</xsl:when>
					<xsl:otherwise>
							<xsl:value-of select="concat('#', $mode, $anchorPrefix, $lastToken)"/>
					</xsl:otherwise>
				</xsl:choose>


			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template match="text()">
		<xsl:call-template name="deTilda">
			<xsl:with-param name="inText" select="."/>
		</xsl:call-template>
	</xsl:template>
	<xsl:template name="getParentInterfaces">
		<xsl:param name="currentInterface"/>
		<xsl:param name="interfaceList"/>
		<xsl:variable name="className">
			<xsl:if test="contains($currentInterface,':')">
				<xsl:value-of select="substring-after($currentInterface,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($currentInterface,':'))">
				<xsl:value-of select="$currentInterface"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($currentInterface,':')">
				<xsl:value-of select="concat($ditaFileDir,substring-before($currentInterface,':'),'.xml')"/>
			</xsl:if>
			<xsl:if test="not(contains($currentInterface,':'))">
				<xsl:value-of select="concat($ditaFileDir,'__Global__.xml')"/>
			</xsl:if>
		</xsl:variable>
		<xsl:for-each select="document($xslDocPath)/apiPackage//apiClassifier[apiName=$className]/apiClassifierDetail/apiClassifierDef/apiBaseInterface">
			<xsl:if test="not(contains($interfaceList,.))">
				<interface>
					<xsl:value-of select="."/>
				</interface>
			</xsl:if>
		</xsl:for-each>
		<xsl:variable name="newInterfaceList">
			<xsl:for-each select="document($xslDocPath)/apiPackage//apiClassifier[apiName=$className]/apiClassifierDetail/apiClassifierDef/apiBaseInterface">
				<xsl:if test="not(contains($interfaceList,.))">
					<xsl:value-of select="."/>
					<xsl:text> </xsl:text>
				</xsl:if>
			</xsl:for-each>
		</xsl:variable>
		<xsl:for-each select="document($xslDocPath)/apiPackage//apiClassifier[apiName=$className]/apiClassifierDetail/apiClassifierDef/apiBaseInterface">
			<xsl:if test="not(contains($interfaceList,.))">
				<xsl:call-template name="getParentInterfaces">
					<xsl:with-param name="currentInterface" select="."/>
					<xsl:with-param name="interfaceList" select="concat($interfaceList, ' ', $newInterfaceList)"/>
				</xsl:call-template>
			</xsl:if>
		</xsl:for-each>
	</xsl:template>
	<xsl:template name="createBaseInterfaceList">
		<xsl:variable name="interfaceList">
			<xsl:for-each select="./apiClassifierDetail/apiClassifierDef/apiBaseInterface">
				<xsl:value-of select="."/>
				<xsl:text> </xsl:text>
			</xsl:for-each>
		</xsl:variable>
		<xsl:variable name="baseinterfaces">
			<xsl:for-each select="./apiClassifierDetail/apiClassifierDef/apiBaseInterface">
				<interface>
					<xsl:value-of select="."/>
				</interface>
			</xsl:for-each>
			<xsl:for-each select="./apiClassifierDetail/apiClassifierDef/apiBaseInterface">
				<xsl:call-template name="getParentInterfaces">
					<xsl:with-param name="currentInterface" select="."/>
					<xsl:with-param name="interfaceList" select="$interfaceList"/>
				</xsl:call-template>
			</xsl:for-each>
		</xsl:variable>
		<xsl:for-each select="$baseinterfaces/interface">
			<xsl:if test="not(node()) or not(preceding-sibling::node()[.=string(current()) and name()=name(current())])">
				<xsl:copy>
					<interface>
						<xsl:value-of select="."/>
					</interface>
				</xsl:copy>
			</xsl:if>
		</xsl:for-each>
	</xsl:template>
	<xsl:template name="insertAIRIcon">
		<xsl:param name="baseRef"/>
		<img src="{$baseRef}images/AirIcon12x12.gif" width="12" height="12" hspace="0" vspace="0" alt="AIR-only" title="Only available in the AIR runtime"/>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/asdoc.js
================================================
////////////////////////////////////////////////////////////////////////////////
//
//  ADOBE SYSTEMS INCORPORATED
//  Copyright 2006-2008 Adobe Systems Incorporated
//  All Rights Reserved.
//
//  NOTICE: Adobe permits you to use, modify, and distribute this file
//  in accordance with the terms of the license agreement accompanying it.
//
////////////////////////////////////////////////////////////////////////////////
var ECLIPSE_FRAME_NAME = "ContentViewFrame";
var eclipseBuild = false;
var liveDocsBaseUrl = "http://livedocs.adobe.com/flex/3";
var liveDocsBookName = "langref";
function findObject(objId) {
    if (document.getElementById)
        return document.getElementById(objId);
    if (document.all)
        return document.all[objId];
}
function isEclipse() {
    return eclipseBuild;
//  return (window.name == ECLIPSE_FRAME_NAME) || (parent.name == ECLIPSE_FRAME_NAME) || (parent.parent.name == ECLIPSE_FRAME_NAME);
}
function configPage() {
    setRowColorsInitial(true, "Property");
    setRowColorsInitial(true, "Method");
    setRowColorsInitial(true, "ProtectedMethod");   
    setRowColorsInitial(true, "Event");
    setRowColorsInitial(true, "Style");
    
    setRowColorsInitial(true, "SkinPart");
    setRowColorsInitial(true, "SkinState");
    
    setRowColorsInitial(true, "Constant");
    if (isEclipse()) {
        if (window.name != "classFrame")
        {
            var localRef = window.location.href.indexOf('?') != -1 ? window.location.href.substring(0, window.location.href.indexOf('?')) : window.location.href;
            localRef = localRef.substring(localRef.indexOf("langref/") + 8);
            if (window.location.search != "")
                localRef += ("#" + window.location.search.substring(1));
            window.location.replace(baseRef + "index.html?" + localRef);
            return;
        }
        else
        {
            setStyle(".eclipseBody", "display", "block");
//          var isIE  = (navigator.appVersion.indexOf("MSIE") != -1) ? true : false;
//          if (isIE == false && window.location.hash != "")
            if (window.location.hash != "")
                window.location.hash=window.location.hash.substring(1);
        }
    }
    else if (window == top) { // no frames
        findObject("titleTable").style.display = "";
    }
    else { // frames
        findObject("titleTable").style.display = "none";
    }
    showTitle(asdocTitle);
}
function loadFrames(classFrameURL, classListFrameURL) {
    var classListFrame = findObject("classListFrame");
    if(classListFrame != null && classListFrameContent!='')
        classListFrame.document.location.href=classListFrameContent;
    if (isEclipse()) {
        var contentViewFrame = findObject(ECLIPSE_FRAME_NAME);
        if (contentViewFrame != null && classFrameURL != '')
            contentViewFrame.document.location.href=classFrameURL;
    }
    else {
        var classFrame = findObject("classFrame");
        if(classFrame != null && classFrameContent!='')
            classFrame.document.location.href=classFrameContent;
    }
}
function showTitle(title) {
    if (!isEclipse())
        top.document.title = title;
}
function loadClassListFrame(classListFrameURL) {
    if (parent.frames["classListFrame"] != null) {
        parent.frames["classListFrame"].location = classListFrameURL;
    }
    else if (parent.frames["packageFrame"] != null) {
        if (parent.frames["packageFrame"].frames["classListFrame"] != null) {
            parent.frames["packageFrame"].frames["classListFrame"].location = classListFrameURL;
        }
    }
}
function gotoLiveDocs(primaryURL, secondaryURL, locale) {
        if (locale == "en-us") {
             locale = "";
        } 
        else {
              locale = "_" + locale.substring(3);
        }
    var url = liveDocsBaseUrl + locale + "/" + liveDocsBookName + "/index.html?" + primaryURL;
    if (secondaryURL != null && secondaryURL != "")
        url += ("&" + secondaryURL);
    window.open(url, "mm_livedocs", "menubar=1,toolbar=1,status=1,scrollbars=1,resizable=yes");
}
function findTitleTableObject(id)
{
    if (isEclipse())
        return parent.titlebar.document.getElementById(id);
    else if (top.titlebar)
        return top.titlebar.document.getElementById(id);
    else
        return document.getElementById(id);
}
function titleBar_setSubTitle(title)
{
    if (isEclipse() || top.titlebar)
        findTitleTableObject("subTitle").childNodes.item(0).data = title;
}
function titleBar_setSubNav(showConstants,showProperties,showStyles,showSkinPart,showSkinState,showEffects,showEvents,showConstructor,showMethods,showExamples,
                showPackageConstants,showPackageProperties,showPackageFunctions,showInterfaces,showClasses,showPackageUse)
{
    if (isEclipse() || top.titlebar)
    {
        var borderStyle = "solid 1px #333";
        findTitleTableObject("propertiesLink").style.display = showProperties ? "inline" : "none";
        findTitleTableObject("propertiesLink").style.borderRight = (showProperties && (showPackageProperties || showConstructor || showMethods || showPackageFunctions || showEvents || showStyles || showSkinPart || showSkinState || showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? borderStyle : "none";
        // findTitleTableObject("propertiesBar").style.display = (showProperties && (showPackageProperties || showConstructor || showMethods || showPackageFunctions || showEvents || showStyles || showSkinPart || showSkinState || showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? "inline" : "none";
        findTitleTableObject("packagePropertiesLink").style.display = showPackageProperties ? "inline" : "none";
        findTitleTableObject("packagePropertiesLink").style.borderRight = (showPackageProperties && (showConstructor || showMethods || showPackageFunctions || showEvents || showStyles || showSkinPart || showSkinState || showConstants || showEffects || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? borderStyle : "none";
        // findTitleTableObject("packagePropertiesBar").style.display = (showPackageProperties && (showConstructor || showMethods || showPackageFunctions || showEvents || showStyles || showSkinPart || showSkinState || showConstants || showEffects || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? "inline" : "none";
        findTitleTableObject("constructorLink").style.display = showConstructor ? "inline" : "none";
        findTitleTableObject("constructorLink").style.borderRight = (showConstructor && (showMethods || showPackageFunctions || showEvents || showStyles || showSkinPart || showSkinState || showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? borderStyle : "none";
        // findTitleTableObject("constructorBar").style.display = (showConstructor && (showMethods || showPackageFunctions || showEvents || showStyles || showSkinPart || showSkinState || showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? "inline" : "none";
        findTitleTableObject("methodsLink").style.display = showMethods ? "inline" : "none";
        findTitleTableObject("methodsLink").style.borderRight = (showMethods && (showPackageFunctions || showEvents || showStyles || showSkinPart || showSkinState || showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? borderStyle : "none";
        // findTitleTableObject("methodsBar").style.display = (showMethods && (showPackageFunctions || showEvents || showStyles || showSkinPart || showSkinState || showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? "inline" : "none";
        findTitleTableObject("packageFunctionsLink").style.display = showPackageFunctions ? "inline" : "none";
        findTitleTableObject("packageFunctionsLink").style.borderRight = (showPackageFunctions && (showEvents || showStyles || showSkinPart || showSkinState || showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? borderStyle : "none";
        // findTitleTableObject("packageFunctionsBar").style.display = (showPackageFunctions && (showEvents || showStyles || showSkinPart || showSkinState || showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? "inline" : "none";
        findTitleTableObject("eventsLink").style.display = showEvents ? "inline" : "none";
        findTitleTableObject("eventsLink").style.borderRight = (showEvents && (showStyles || showSkinPart || showSkinState || showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? borderStyle : "none";
        // findTitleTableObject("eventsBar").style.display = (showEvents && (showStyles || showSkinPart || showSkinState || showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? "inline" : "none";
        findTitleTableObject("stylesLink").style.display = showStyles ? "inline" : "none";
        findTitleTableObject("stylesLink").style.borderRight = (showStyles && (showSkinPart || showSkinState || showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? borderStyle : "none";
        // findTitleTableObject("stylesBar").style.display = (showStyles && (showSkinPart || showSkinState || showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? "inline" : "none";
        
        findTitleTableObject("SkinPartLink").style.display = showSkinPart ? "inline" : "none";
        findTitleTableObject("SkinPartLink").style.borderRight = (showSkinPart && (showSkinState || showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? borderStyle : "none";
        // findTitleTableObject("SkinPartBar").style.display = (showSkinPart && (showSkinState || showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? "inline" : "none";
        
        findTitleTableObject("SkinStateLink").style.display = showSkinState ? "inline" : "none";
	    findTitleTableObject("SkinStateLink").style.borderRight = (showSkinState && (showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? borderStyle : "none";
        // findTitleTableObject("SkinStateBar").style.display = (showSkinState && (showEffects || showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? "inline" : "none";
                
        findTitleTableObject("effectsLink").style.display = showEffects ? "inline" : "none";
        findTitleTableObject("effectsLink").style.borderRight = (showEffects && (showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? borderStyle : "none";
        // findTitleTableObject("effectsBar").style.display = (showEffects && (showConstants || showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? "inline" : "none";
        findTitleTableObject("constantsLink").style.display = showConstants ? "inline" : "none";
        findTitleTableObject("constantsLink").style.borderRight = (showConstants && (showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? borderStyle : "none";
        // findTitleTableObject("constantsBar").style.display = (showConstants && (showPackageConstants || showInterfaces || showClasses || showPackageUse || showExamples)) ? "inline" : "none";
        findTitleTableObject("packageConstantsLink").style.display = showPackageConstants ? "inline" : "none";
        findTitleTableObject("packageConstantsLink").style.borderRight = (showPackageConstants && (showInterfaces || showClasses || showPackageUse || showExamples)) ? borderStyle : "none";
        // findTitleTableObject("packageConstantsBar").style.display = (showPackageConstants && (showInterfaces || showClasses || showPackageUse || showExamples)) ? "inline" : "none";
        findTitleTableObject("interfacesLink").style.display = showInterfaces ? "inline" : "none";
        findTitleTableObject("interfacesLink").style.borderRight = (showInterfaces && (showClasses || showPackageUse || showExamples)) ? borderStyle : "none";
        // findTitleTableObject("interfacesBar").style.display = (showInterfaces && (showClasses || showPackageUse || showExamples)) ? "inline" : "none";
        findTitleTableObject("classesLink").style.display = showClasses ? "inline" : "none";
        findTitleTableObject("classesLink").style.borderRight = (showClasses && (showPackageUse || showExamples)) ? borderStyle : "none";
        // findTitleTableObject("classesBar").style.display = (showClasses && (showPackageUse || showExamples)) ? "inline" : "none";
        findTitleTableObject("packageUseLink").style.display = showPackageUse ? "inline" : "none";
        findTitleTableObject("packageUseLink").style.borderRight = (showPackageUse && showExamples) ? borderStyle : "none";
        // findTitleTableObject("packageUseBar").style.display = (showPackageUse && showExamples) ? "inline" : "none";
        findTitleTableObject("examplesLink").style.display = showExamples ? "inline" : "none";
    }
}
function titleBar_gotoClassFrameAnchor(anchor)
{
    if (isEclipse())
        parent.classFrame.location = parent.classFrame.location.toString().split('#')[0] + "#" + anchor;
    else
        top.classFrame.location = top.classFrame.location.toString().split('#')[0] + "#" + anchor;
}
function setMXMLOnly() 
{
    if (getCookie("showMXML") == "false")
    {
        toggleMXMLOnly();
    }
}
function toggleMXMLOnly() 
{
    var mxmlDiv = findObject("mxmlSyntax");
    var mxmlShowLink = findObject("showMxmlLink");
    var mxmlHideLink = findObject("hideMxmlLink");
    if (mxmlDiv && mxmlShowLink && mxmlHideLink)
    {
        if (mxmlDiv.style.display == "none")
        {
            mxmlDiv.style.display = "block";
            mxmlShowLink.style.display = "none";
            mxmlHideLink.style.display = "inline";
            setCookie("showMXML","true", new Date(3000,1,1,1,1), "/", document.location.domain);
        }
        else
        {
            mxmlDiv.style.display = "none";
            mxmlShowLink.style.display = "inline";
            mxmlHideLink.style.display = "none";
            setCookie("showMXML","false", new Date(3000,1,1,1,1), "/", document.location.domain);
        }
    }
}
function showHideInherited()
{   
    setInheritedVisible(getCookie("showInheritedConstant") == "true", "Constant");
    setInheritedVisible(getCookie("showInheritedProtectedConstant") == "true", "ProtectedConstant");
    setInheritedVisible(getCookie("showInheritedProperty") == "true", "Property");
    setInheritedVisible(getCookie("showInheritedProtectedProperty") == "true", "ProtectedProperty");
    setInheritedVisible(getCookie("showInheritedMethod") == "true", "Method");
    setInheritedVisible(getCookie("showInheritedProtectedMethod") == "true", "ProtectedMethod");
    setInheritedVisible(getCookie("showInheritedEvent") == "true", "Event");
    setInheritedVisible(getCookie("showInheritedStyle") == "true", "Style");
    
    setInheritedVisible(getCookie("showInheritedSkinPart") == "true", "SkinPart");
    setInheritedVisible(getCookie("showInheritedSkinState") == "true", "SkinState");
    
    setInheritedVisible(getCookie("showInheritedEffect") == "true", "Effect");
}
function setInheritedVisible(show, selectorText)
{
    if (document.styleSheets[0].cssRules != undefined)
    {
        var rules = document.styleSheets[0].cssRules;
        for (var i = 0; i < rules.length; i++)
        {
            if (rules[i].selectorText == ".hideInherited" + selectorText)
                rules[i].style.display = show ? "" : "none";
                
            if (rules[i].selectorText == ".showInherited" + selectorText)
                rules[i].style.display = show ? "none" : "";

            if (rules[i].selectorText == "table.hideInherited" + selectorText)
                rules[i].style.display = show ? "block" : "none";
            
            if (rules[i].selectorText == "table.showInherited" + selectorText)
                rules[i].style.display = show ? "none" : "block";
        }
    }
    else
    {
        document.styleSheets[0].addRule(".hideInherited" + selectorText, show ? "display:inline" : "display:none");
        document.styleSheets[0].addRule(".showInherited" + selectorText, show ? "display:none" : "display:inline");
        document.styleSheets[0].addRule("table.hideInherited" + selectorText, show ? "display:block" : "display:none");
        document.styleSheets[0].addRule("table.showInherited" + selectorText, show ? "display:none" : "display:block");
    }
    setCookie("showInherited" + selectorText, show ? "true" : "false", new Date(3000,1,1,1,1), "/", document.location.domain);
    setRowColors(show, selectorText);
}
function setRowColors(show, selectorText)
{
    var rowColor = "#F2F2F2";
    var table = findObject("summaryTable" + selectorText);
    if (table != null)
    {
        var rowNum = 0;
        for (var i = 1; i < table.rows.length; i++)
        {
            if (table.rows[i].className.indexOf("hideInherited") == -1 || show)
            {
                rowNum++;
                table.rows[i].bgColor = (rowNum % 2 == 0) ? rowColor : "#FFFFFF";
            }           
        }
    }
}
function setRowColorsInitial(show, selectorText)
{
    var rowColor = "#F2F2F2";
    var table = findObject("summaryTable" + selectorText);
    if (table != null)
    {
        var rowNum = 0;
        for (var i = 1; i < table.rows.length; i++)
        {
            if (table.rows[i].className.indexOf("hideInherited") == -1 && show)
            {
                rowNum++;
                table.rows[i].bgColor = (rowNum % 2 == 0) ? rowColor : "#FFFFFF";
            }           
        }
    }
}
function setStyle(selectorText, styleName, newValue)
{
    if (document.styleSheets[0].cssRules != undefined)
    {
        var rules = document.styleSheets[0].cssRules;
        for (var i = 0; i < rules.length; i++)
        {
            if (rules[i].selectorText == selectorText)
            {
                rules[i].style[styleName] = newValue;
                break;
            }
        }
    }
    else
    {
        document.styleSheets[0].addRule(selectorText, styleName + ":" + newValue);
    }
}


================================================
FILE: documentation/api-reference/templates/class-files.xslt
================================================
<?xml version="1.0" encoding="utf-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://sf.net/saxon" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ifn="urn:internal:functions"
	exclude-result-prefixes="saxon xs ifn">
	<xsl:import href="asdoc-util.xslt"/>
	<xsl:import href="class-parts.xslt"/>
	<xsl:character-map name="disable">
		<xsl:output-character character="&amp;" string="&amp;"/>
		<xsl:output-character character="&lt;" string="&lt;"/>
		<xsl:output-character character="&gt;" string="&gt;"/>
		<xsl:output-character character="&#145;" string="&amp;lsquo;"/>
		<xsl:output-character character="&#146;" string="&amp;apos;"/>
		<xsl:output-character character="&#151;" string="&amp;mdash;"/>
		<xsl:output-character character="&#x2014;" string="&amp;mdash;"/>
		<xsl:output-character character="&#x2009;" string="&amp;thinsp;"/>
		<xsl:output-character character="&#xAE;" string="&amp;reg;"/>
		<xsl:output-character character="&#xB0;" string="&amp;deg;"/>
		<xsl:output-character character="&#x2122;" string="&amp;trade;"/>
	</xsl:character-map>
	<xsl:output method="html" encoding="UTF-8" indent="no" omit-xml-declaration="yes" use-character-maps="disable" saxon:character-representation="native;decimal"/>
	<xsl:param name="outputPath" select="''"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:param name="showExamples">true</xsl:param>
	<xsl:param name="showIncludeExamples">true</xsl:param>
	<xsl:param name="showSWFs">
		<xsl:if test="$config/options/@showSWFs='false'">
			<xsl:text>false</xsl:text>
		</xsl:if>
		<xsl:if test="not($config/options/@showSWFs='false')">
			<xsl:text>true</xsl:text>
		</xsl:if>
	</xsl:param>
	<xsl:param name="tabSpaces" select="'    '"/>
	<xsl:param name="classFileName" select="'ClassHeader.xml'"/>
	<xsl:variable name="classHeader_map" select="document($classFileName)//apiPackage"/>
	<xsl:variable name="field_map" select="document('fieldSummary.xml')/allClasses/apiPackage"/>
	<xsl:variable name="method_map" select="document('methodSummary.xml')/allClasses/apiPackage"/>
	<xsl:variable name="event_map" select="document('eventsGeneratedSummary.xml')/allClasses/apiPackage"/>
	<xsl:variable name="style_map" select="document('stylesSummary.xml')/allClasses/apiPackage"/>
	<xsl:variable name="effect_map" select="document('effectsSummary.xml')/allClasses/apiPackage"/>
	<xsl:variable name="thinsp">
		<xsl:text>&#x2009;</xsl:text>
	</xsl:variable>
	<xsl:variable name="tab">
		<xsl:text>	</xsl:text>
	</xsl:variable>
	<xsl:param name="prog_language_name" select="''"/>
	<xsl:param name="jslr" select="'flashclasses.xml'"/>
	<xsl:key name="class_id" match="//apiClassifier" use="@id"/>
	<xsl:template match="/">
		<xsl:choose>
			<xsl:when test="$prog_language_name='javascript'"/>
			<!-- ActionScript -->
			<xsl:otherwise>
				<xsl:for-each select="apiMap//apiItemRef">
					<xsl:sort select="@href" order="ascending" lang="en-US"/>
					<xsl:variable name="ditaFileName">
						<xsl:value-of select="concat($ditaFileDir,@href)"/>
					</xsl:variable>
					<xsl:for-each select="document($ditaFileName)/apiPackage//apiClassifier">
						<xsl:sort select="apiName" order="ascending" lang="en-US"/>
						<xsl:variable name="packageName" select="ancestor-or-self::apiPackage/apiName"/>
						<xsl:variable name="name" select="apiName"/>
						<xsl:variable name="ID" select="@id"/>
						<xsl:variable name="classNode" select="."/>
						<xsl:variable name="isTopLevel">
							<xsl:call-template name="isTopLevel">
								<xsl:with-param name="packageName" select="$packageName"/>
							</xsl:call-template>
						</xsl:variable>
						<xsl:variable name="isInnerClass" select="ancestor::apiClassifier"/>
						<xsl:variable name="packagePath" select="translate($packageName, '.', '/')"/>
						<xsl:variable name="classFile">
							<xsl:value-of select="$outputPath"/>
							<xsl:if test="$isTopLevel='false'">
								<xsl:value-of select="$packagePath"/>
								<xsl:text>/</xsl:text>
							</xsl:if>
							<xsl:value-of select="$name"/>
							<xsl:text>.html</xsl:text>
						</xsl:variable>
						<xsl:variable name="title">
							<xsl:value-of select="concat(concat($name,' - '),$title-base)"/>
						</xsl:variable>
						<xsl:variable name="classDeprecated">
							<xsl:if test="deprecated">
								<xsl:value-of select="'true'"/>
							</xsl:if>
							<xsl:if test="not(deprecated)">
								<xsl:value-of select="'false'"/>
							</xsl:if>
						</xsl:variable>
						<xsl:variable name="baseRef">
							<xsl:call-template name="getBaseRef">
								<xsl:with-param name="packageName" select="$packageName"/>
							</xsl:call-template>
						</xsl:variable>
						<xsl:result-document href="{$classFile}" method="html">
							<!--xsl:message select="$classFile"/-->
							<xsl:copy-of select="$docType"/>
							<xsl:if test="$config/options[@ion='true']">
								<xsl:comment>#config errmsg=""</xsl:comment>
							</xsl:if>
							<xsl:element name="html">
								<head>
									<xsl:call-template name="getStyleLink">
										<xsl:with-param name="link" select="/asdoc/link"/>
										<xsl:with-param name="packageName" select="$packageName"/>
									</xsl:call-template>
									<xsl:for-each select="$classHeader_map/apiClassifier[@id=$ID]">
										<xsl:copy-of select="./meta"/>
									</xsl:for-each>
									<title>
										<xsl:if test="$isTopLevel='false'">
											<xsl:value-of select="$packageName"/>
											<xsl:text>.</xsl:text>
										</xsl:if>
										<xsl:value-of select="$name"/>
										<xsl:call-template name="getPageTitlePostFix"/>
									</title>
									<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
									<xsl:if test="$showIncludeExamples='true' and apiClassifierDetail/example/codeblock">
										<script src="{$baseRef}AC_OETags.js" type="text/javascript"/>
									</xsl:if>
								</head>
								<xsl:element name="body">
									<xsl:if test="$isEclipse">
										<xsl:attribute name="class">
											<xsl:text>eclipseBody</xsl:text>
										</xsl:attribute>
									</xsl:if>
									<xsl:call-template name="getTitleScript">
										<xsl:with-param name="title" select="$title"/>
										<xsl:with-param name="packageName" select="$packageName"/>
									</xsl:call-template>
									<xsl:for-each select="$classHeader_map/apiClassifier[@id=$ID]">
										<xsl:call-template name="classHeader">
											<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
											<xsl:with-param name="classNode" select="$classNode"/>
										</xsl:call-template>
									</xsl:for-each>
									<xsl:for-each select="$field_map//apiClassifier[@id=$ID]">
										<!-- list of interfaces that this interface extends-->
										<xsl:variable name="interfaces">
											<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface and ./apiClassifierDetail/apiClassifierDef/apiBaseInterface">
												<xsl:call-template name="createBaseInterfaceList"/>
											</xsl:if>
										</xsl:variable>
										<!--  PUBLIC PROPERTY SUMMARY-->
										<xsl:call-template name="fieldSummary">
											<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
											<xsl:with-param name="interfaces" select="$interfaces" tunnel="yes"/>
											<xsl:with-param name="isConst" select="'false'"/>
										</xsl:call-template>
										<!--  PROTECTED PROPERTY SUMMARY-->
										<xsl:call-template name="fieldSummary">
											<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
											<xsl:with-param name="accessLevel" select="'protected'" as="xs:string"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
											<xsl:with-param name="interfaces" select="$interfaces" tunnel="yes"/>
											<xsl:with-param name="isConst" select="'false'"/>
										</xsl:call-template>
									</xsl:for-each>
									<xsl:for-each select="$method_map//apiClassifier[@id=$ID]">
										<!-- list of interfaces that this interface extends-->
										<xsl:variable name="interfaces">
											<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface and ./apiClassifierDetail/apiClassifierDef/apiBaseInterface">
												<xsl:call-template name="createBaseInterfaceList"/>
											</xsl:if>
										</xsl:variable>
										<!--  METHOD SUMMARY-->
										<xsl:call-template name="methodSummary">
											<xsl:with-param name="className" select="$name"/>
											<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
											<xsl:with-param name="interfaces" select="$interfaces" tunnel="yes"/>
										</xsl:call-template>
										<!--  PROTECTED METHOD SUMMARY-->
										<xsl:call-template name="methodSummary">
											<xsl:with-param name="className" select="$name"/>
											<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
											<xsl:with-param name="accessLevel" select="'protected'"/>
											<xsl:with-param name="interfaces" select="$interfaces" tunnel="yes"/>
										</xsl:call-template>
									</xsl:for-each>
									<xsl:for-each select="$event_map//apiClassifier[@id=$ID]">
										<!-- list of interfaces that this interface extends-->
										<xsl:variable name="interfaces">
											<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface and ./apiClassifierDetail/apiClassifierDef/apiBaseInterface">
												<xsl:call-template name="createBaseInterfaceList"/>
											</xsl:if>
										</xsl:variable>
										<!--  EVENT SUMMARY-->
										<xsl:call-template name="eventsGeneratedSummary">
											<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
											<xsl:with-param name="interfaces" select="$interfaces" tunnel="yes"/>
										</xsl:call-template>
									</xsl:for-each>
									<xsl:for-each select="$style_map//apiClassifier[@id=$ID]">
										<!-- list of interfaces that this interface extends-->
										<xsl:variable name="interfaces">
											<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface and ./apiClassifierDetail/apiClassifierDef/apiBaseInterface">
												<xsl:call-template name="createBaseInterfaceList"/>
											</xsl:if>
										</xsl:variable>
										<!-- STYLE SUMMARY-->
										<xsl:call-template name="stylesSummary">
											<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
											<xsl:with-param name="interfaces" select="$interfaces" tunnel="yes"/>
										</xsl:call-template>
									</xsl:for-each>

									  <!-- SKIN PART SUMMARY -->
									  <xsl:for-each select="$classHeader_map//apiClassifier[@id=$ID]">
									    <xsl:variable name="interfaces">
									      <xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface and ./apiClassifierDetail/apiClassifierDef/apiBaseInterface">
										<xsl:call-template name="createBaseInterfaceList"/>
									      </xsl:if>
									    </xsl:variable>
									    <xsl:call-template name="SkinPartSummary">
									      <xsl:with-param name="classDeprecated" select="$classDeprecated"/>
									      <xsl:with-param name="baseRef" select="$baseRef"/>
									      <xsl:with-param name="interfaces" select="$interfaces" tunnel="yes"/>
									    </xsl:call-template>
									  </xsl:for-each> 
									  <!-- SKIN STATE SUMMARY -->
									  <xsl:for-each select="$classHeader_map//apiClassifier[@id=$ID]">
									    <xsl:variable name="interfaces">
									      <xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface and ./apiClassifierDetail/apiClassifierDef/apiBaseInterface">
										<xsl:call-template name="createBaseInterfaceList"/>
									      </xsl:if>
									    </xsl:variable>
									    <xsl:call-template name="SkinStateSummary">
									      <xsl:with-param name="classDeprecated" select="$classDeprecated"/>
									      <xsl:with-param name="baseRef" select="$baseRef"/>
									      <xsl:with-param name="interfaces" select="$interfaces" tunnel="yes"/>
									    </xsl:call-template>
									  </xsl:for-each> 

                  									
									<xsl:for-each select="$effect_map//apiClassifier[@id=$ID]">
										<!-- list of interfaces that this interface extends-->
										<xsl:variable name="interfaces">
											<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface and ./apiClassifierDetail/apiClassifierDef/apiBaseInterface">
												<xsl:call-template name="createBaseInterfaceList"/>
											</xsl:if>
										</xsl:variable>
										<!-- EFFECT SUMMARY-->
										<xsl:call-template name="effectsSummary">
											<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
											<xsl:with-param name="interfaces" select="$interfaces" tunnel="yes"/>
										</xsl:call-template>
									</xsl:for-each>
									<xsl:for-each select="$field_map//apiClassifier[@id=$ID]">
										<!-- list of interfaces that this interface extends-->
										<xsl:variable name="interfaces">
											<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface and ./apiClassifierDetail/apiClassifierDef/apiBaseInterface">
												<xsl:call-template name="createBaseInterfaceList"/>
											</xsl:if>
										</xsl:variable>
										<!--  PUBLIC CONSTANT SUMMARY-->
										<xsl:call-template name="fieldSummary">
											<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
											<xsl:with-param name="isConst" select="'true'" as="xs:string"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
											<xsl:with-param name="interfaces" select="$interfaces" tunnel="yes"/>
										</xsl:call-template>
										<!--  PROTECTED CONSTANT SUMMARY-->
										<xsl:call-template name="fieldSummary">
											<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
											<xsl:with-param name="isConst" select="'true'" as="xs:string"/>
											<xsl:with-param name="accessLevel" select="'protected'" as="xs:string"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
											<xsl:with-param name="interfaces" select="$interfaces" tunnel="yes"/>
										</xsl:call-template>
									</xsl:for-each>
									<script language="javascript" type="text/javascript">
										<xsl:comment>
											<xsl:text>
										</xsl:text>
											<xsl:text>showHideInherited();</xsl:text>
											<xsl:text>
										</xsl:text>
										</xsl:comment>
									</script>
									<div class="MainContent">
										<!--  PROPERTY DETAIL -->
										<xsl:for-each select="$field_map//apiClassifier[@id=$ID]">
											<xsl:call-template name="propertyDetails">
												<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
												<xsl:with-param name="baseRef" select="$baseRef"/>
											</xsl:call-template>
										</xsl:for-each>
										<!-- CONSTRUCTOR DETAIL-->
										<xsl:if test="not(./apiClassifierDetail/apiClassifierDef/apiInterface) and count(apiConstructor) &gt; 0">
											<a name="constructorDetail"/>
											<div class="detailSectionHeader">
												<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ConstructorDetail']]/entry[2]/p"/>
											</div>
											<xsl:variable name="className" select="$name"/>
											<xsl:apply-templates select="apiConstructor[./apiName = $className]" mode="detail">
												<xsl:with-param name="isConstructor">true</xsl:with-param>
												<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
												<xsl:with-param name="baseRef" select="$baseRef"/>
												<xsl:with-param name="constructCall" select="'false'"/>
											</xsl:apply-templates>
										</xsl:if>
										<!-- METHOD DETAIL -->
										<xsl:for-each select="$method_map//apiClassifier[@id=$ID]">
											<xsl:call-template name="methodsDetails">
												<xsl:with-param name="className" select="$name"/>
												<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
												<xsl:with-param name="baseRef" select="$baseRef"/>
												<xsl:with-param name="constructCall" select="'false'"/>
											</xsl:call-template>
										</xsl:for-each>
										<!--  EVENT DETAIL-->
										<xsl:call-template name="eventDetails">
											<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
										</xsl:call-template>
										<!-- STYLE DETAIL -->
										<xsl:call-template name="styleDetails">
											<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
										</xsl:call-template>
										<!--  CONSTANT DETAIL -->
										<xsl:call-template name="constantDetails">
											<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
											<xsl:with-param name="isConst" select="'true'"/>
										</xsl:call-template>
										<!-- INCLUDE EXAMPLES-->
										<xsl:if test="./*/example/codeblock">
											<xsl:variable name="createExampleInstructionLink">
												<xsl:choose>
													<xsl:when test="$config/exampleFile">true</xsl:when>
													<xsl:otherwise>false</xsl:otherwise>
												</xsl:choose>
											</xsl:variable>
											<xsl:call-template name="includeExamples">
												<xsl:with-param name="createExampleLink" select="'true'"/>
												<xsl:with-param name="createExampleInstructionLink" select="$createExampleInstructionLink"/>
											</xsl:call-template>
										</xsl:if>
										<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
										<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
										<hr/>
										<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
										<xsl:call-template name="getPageLinks">
											<xsl:with-param name="copyNum" select="'2'"/>
										</xsl:call-template>
										<p/>
										<xsl:if test="$config/options[@ion!='true']">
											<xsl:call-template name="getFeedbackLink">
												<xsl:with-param name="topic">
													<xsl:if test="$isTopLevel='false'">
														<xsl:value-of select="$packageName"/>
														<xsl:text>.</xsl:text>
													</xsl:if>
													<xsl:value-of select="$name"/>
												</xsl:with-param>
												<xsl:with-param name="filename">
													<xsl:if test="$isTopLevel='false'">
														<xsl:value-of select="$packagePath"/>
														<xsl:text>/</xsl:text>
													</xsl:if>
													<xsl:value-of select="$name"/>
													<xsl:text>.html</xsl:text>
												</xsl:with-param>
												<xsl:with-param name="filename2">
													<xsl:if test="$isTopLevel='true'">class-list.html</xsl:if>
													<xsl:if test="$isTopLevel!='true'">
														<xsl:value-of select="$packagePath"/>
														<xsl:text>/class-list.html</xsl:text>
													</xsl:if>
												</xsl:with-param>
											</xsl:call-template>
										</xsl:if>
										<xsl:if test="$config/options[@ion='true']">
											<script src="{$baseRef}currentpage.js" type="text/javascript" language="Javascript" charset="UTF-8"/>
										</xsl:if>
										<center class="copyright">
											<xsl:copy-of select="$copyright"/>
										</center>
										<xsl:call-template name="addKeywords">
											<xsl:with-param name="keyword" select="$name"/>
										</xsl:call-template>
										<xsl:if test="$isTopLevel='false'">
											<xsl:call-template name="addKeywords">
												<xsl:with-param name="keyword">
													<xsl:value-of select="$packageName"/>
													<xsl:text>.</xsl:text>
													<xsl:value-of select="$name"/>
												</xsl:with-param>
											</xsl:call-template>
										</xsl:if>
									</div>
									<xsl:if test="$config/options[@ion='true']">
										<div class="separator">&#160;</div>
										<xsl:comment>BEGIN IONCOMMENTS</xsl:comment>
										<div id="ionComHere"> </div>
										<xsl:comment>END IONCOMMENTS</xsl:comment>
										<xsl:comment>#include virtual="ionComments.ssi"</xsl:comment>
										<p id="creativecommons" class="creativecommons">
											<a href="http://creativecommons.org/licenses/by-nc-sa/3.0/">
												<img id="creativecommons_img" src="{$baseRef}images/CC.png"/>
											</a>
										</p>
										<xsl:comment>#include virtual="/livedocs/googleAnalytics.ssi"</xsl:comment>
										<xsl:comment>#include virtual="/ubi/analytics/analytics_ssi.html"</xsl:comment>
									</xsl:if>
								</xsl:element>
							</xsl:element>
							<xsl:copy-of select="$copyrightComment"/>
						</xsl:result-document>
					</xsl:for-each>
				</xsl:for-each>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<!-- INNER CLASSES -->
	<xsl:template name="innerClassSummary">
		<xsl:param name="hasInherited" select="false"/>
		<xsl:param name="classDeprecated" select="false"/>
		<xsl:if test="count(.//apiClassifier) &gt; 0 or boolean($hasInherited)">
			<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
			<a name="innerClassSummary"/>
			<table cellspacing="0" cellpadding="3" width="100%" class="withBorder">
				<tr>
					<td colspan="2" bgcolor="#CCCCCC" class="SummaryTableHeader">
						<font size="+1">
							<b>
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'InnerClassSummary']]/entry[2]/p"/>
							</b>
						</font>
					</td>
				</tr>
				<xsl:for-each select="//apiClassifier">
					<xsl:sort select="./apiName" order="ascending" lang="en-US"/>
					<tr class="row{position() mod 2}">
						<td width="50px" valign="top">
							<code>
								<font size="1" style="font-weight:bold">
									<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiFinal">
										<xsl:text>final </xsl:text>
									</xsl:if>
									<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiDynamic">
										<xsl:text>dynamic </xsl:text>
									</xsl:if>
								</font>
							</code>
						</td>
						<td valign="top">
							<code>
								<a href="{./apiName}.html">
									<b>
										<xsl:value-of select="./apiName"/>
									</b>
								</a>
							</code>
							<xsl:if test="deprecated">
								<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
							</xsl:if>
							<xsl:apply-templates select="deprecated"/>
							<xsl:if test="not(deprecated)">
								<xsl:call-template name="shortDescription">
									<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
								</xsl:call-template>
							</xsl:if>
						</td>
					</tr>
				</xsl:for-each>
			</table>
		</xsl:if>
	</xsl:template>
	<!-- FIELDS -->
	<xsl:template name="fieldSummary">
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="isConst" select="'false'"/>
		<xsl:param name="accessLevel" select="'public'"/>
		<xsl:param name="baseRef" select="''"/>
		<xsl:param name="isGlobal" select="false()"/>
		<xsl:param name="showAnchor" select="true()"/>
		<xsl:param name="getProp"/>
		<xsl:param name="interfaces" tunnel="yes"/>
		<xsl:variable name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:variable name="ID" select="@id"/>
		<xsl:variable name="hasFields">
			<xsl:if test="$isConst='true'">
				<xsl:value-of
					select="count(apiValue/apiValueDetail/apiValueDef[not(apiProperty) and (apiAccess/@value=$accessLevel or apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.)]) &gt; 0"/>
			</xsl:if>
			<xsl:if test="$isConst='false'">
				<xsl:value-of
					select="count(apiValue/apiValueDetail/apiValueDef[apiProperty and (apiAccess/@value=$accessLevel or apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.)]) &gt; 0"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="ancestorexcludes">
			<excludes>
				<xsl:for-each select="$classHeader_map//apiClassifier[@id = $ID]//Excludes/Exclude[@kind='property']">
					<xsl:copy-of select="."/>
				</xsl:for-each>
			</excludes>
		</xsl:variable>
		<xsl:variable name="propertyList">
			<xsl:if test="$isConst='true'">
				<xsl:for-each
					select="apiValue[not(./apiValueDetail/apiValueDef/apiProperty) and (./apiValueDetail/apiValueDef/apiAccess/@value=$accessLevel or ./apiValueDetail/apiValueDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.)]">
					<xsl:text> </xsl:text>
					<xsl:value-of select="./apiName"/>
					<xsl:text> </xsl:text>
				</xsl:for-each>
				<xsl:for-each select="$ancestorexcludes/excludes/Exclude">
					<xsl:text> </xsl:text>
					<xsl:value-of select="@name"/>
					<xsl:text> </xsl:text>
				</xsl:for-each>
			</xsl:if>
			<xsl:if test="$isConst='false'">
				<xsl:for-each
					select="apiValue[./apiValueDetail/apiValueDef/apiProperty and (./apiValueDetail/apiValueDef/apiAccess/@value=$accessLevel or ./apiValueDetail/apiValueDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.)]">
					<xsl:text> </xsl:text>
					<xsl:value-of select="./apiName"/>
					<xsl:text> </xsl:text>
				</xsl:for-each>
				<xsl:for-each select="$ancestorexcludes/excludes/Exclude">
					<xsl:text> </xsl:text>
					<xsl:value-of select="@name"/>
					<xsl:text> </xsl:text>
				</xsl:for-each>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="ancestorNode">
			<ancestors>
				<xsl:call-template name="getAncestorProperty">
					<xsl:with-param name="baseClass" select="./apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
					<xsl:with-param name="accessLevel" select="$accessLevel"/>
					<xsl:with-param name="isConst" select="$isConst"/>
					<xsl:with-param name="propertyList" select="$propertyList"/>
				</xsl:call-template>
				<xsl:for-each select="$interfaces/interface">
					<xsl:call-template name="getAncestorProperty">
						<xsl:with-param name="baseClass" select="."/>
						<xsl:with-param name="accessLevel" select="$accessLevel"/>
						<xsl:with-param name="isConst" select="$isConst"/>
						<xsl:with-param name="propertyList" select="$propertyList"/>
						<xsl:with-param name="processParentClass" select="false()"/>
					</xsl:call-template>
				</xsl:for-each>
			</ancestors>
		</xsl:variable>
		<xsl:variable name="hasInherited" select="count($ancestorNode/ancestors/apiValue) &gt; 0"/>
		<xsl:if test="$hasFields='true' or $hasInherited">
			<xsl:if test="$showAnchor">
				<xsl:variable name="hasPublic">
					<xsl:if test="$accessLevel='protected'">
						<xsl:value-of
							select="count(apiValue[not(apiValueDetail/apiValueDef/apiProperty)!=($isConst) and (apiValueDetail/apiValueDef/apiAccess/@value='public' or apiValueDetail/apiValueDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay='public']/.)]) &gt; 0 or $hasInherited"
						/>
					</xsl:if>
					<xsl:if test="not($accessLevel='protected')">
						<xsl:value-of select="false()"/>
					</xsl:if>
				</xsl:variable>
				<xsl:if test="$isConst='true'">
					<xsl:if test="$accessLevel='public'">
						<a name="constantSummary"/>
					</xsl:if>
					<xsl:if test="$accessLevel='protected'">
						<xsl:if test="$hasPublic='false'">
							<a name="constantSummary"/>
						</xsl:if>
						<a name="protectedConstantSummary"/>
					</xsl:if>
				</xsl:if>
				<xsl:if test="$isConst='false'">
					<xsl:if test="$accessLevel='public'">
						<a name="propertySummary"/>
					</xsl:if>
					<xsl:if test="$accessLevel='protected'">
						<xsl:if test="$hasPublic='false'">
							<a name="propertySummary"/>
						</xsl:if>
						<a name="protectedPropertySummary"/>
					</xsl:if>
				</xsl:if>
			</xsl:if>
			<div class="summarySection">
				<div class="summaryTableTitle">
					<xsl:choose>
						<xsl:when test="$isGlobal and $isConst='true'">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalConstants']]/entry[2]/p"/>
						</xsl:when>
						<xsl:when test="$isGlobal and $isConst='false'">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalProperties']]/entry[2]/p"/>
						</xsl:when>
						<xsl:when test="$accessLevel='public' and $isConst='true'">
							<xsl:choose>
								<xsl:when test="$prog_language_name='javascript'"/>
								<xsl:otherwise>
									<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PublicConstants']]/entry[2]/p"/>
								</xsl:otherwise>
							</xsl:choose>

						</xsl:when>
						<xsl:when test="$accessLevel='public' and $isConst='false'">
							<xsl:choose>
								<xsl:when test="$prog_language_name='javascript'"/>
								<xsl:otherwise>
									<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PublicProperties']]/entry[2]/p"/>
								</xsl:otherwise>
							</xsl:choose>

						</xsl:when>
						<xsl:when test="$accessLevel='protected' and $isConst='true'">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ProtectedConstants']]/entry[2]/p"/>
						</xsl:when>
						<xsl:when test="$accessLevel='protected' and $isConst='false'">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ProtectedProperties']]/entry[2]/p"/>
						</xsl:when>
					</xsl:choose>
				</div>
				<xsl:if test="$hasInherited">
					<div class="showHideLinks">
						<xsl:if test="$isConst='true' and $accessLevel!='protected'">
							<div id="hideInheritedConstant" class="hideInheritedConstant">
								<a class="showHideLink" href="#constantSummary" onclick="javascript:setInheritedVisible(false,'Constant');">
									<xsl:choose>
										<xsl:when test="$prog_language_name='javascript'"/>
										<xsl:otherwise>
											<img class="showHideLinkImage" src="{$baseRef}images/expanded.gif"/>
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'HideInheritedPublicConstants']]/entry[2]/p"/>
										</xsl:otherwise>
									</xsl:choose>
								</a>
							</div>
							<div id="showInheritedConstant" class="showInheritedConstant">
								<a class="showHideLink" href="#constantSummary" onclick="javascript:setInheritedVisible(true,'Constant');">
									<xsl:choose>
										<xsl:when test="$prog_language_name='javascript'"/>
										<xsl:otherwise>
											<img class="showHideLinkImage" src="{$baseRef}images/collapsed.gif"/>
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ShowInheritedPublicConstants']]/entry[2]/p"/>
										</xsl:otherwise>
									</xsl:choose>
								</a>
							</div>
						</xsl:if>
						<xsl:if test="$isConst='true' and $accessLevel='protected'">
							<div id="hideInheritedProtectedConstant" class="hideInheritedProtectedConstant">
								<a class="showHideLink" href="#protectedConstantSummary" onclick="javascript:setInheritedVisible(false,'ProtectedConstant');">
									<img class="showHideLinkImage" src="{$baseRef}images/expanded.gif"/>
									<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'HideInheritedProtectedConstants']]/entry[2]/p"/>
								</a>
							</div>
							<div id="showInheritedProtectedConstant" class="showInheritedProtectedConstant">
								<a class="showHideLink" href="#protectedConstantSummary" onclick="javascript:setInheritedVisible(true,'ProtectedConstant');">
									<img class="showHideLinkImage" src="{$baseRef}images/collapsed.gif"/>
									<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ShowInheritedProtectedConstants']]/entry[2]/p"/>
								</a>
							</div>
						</xsl:if>
						<xsl:if test="$isConst='false' and $accessLevel!='protected'">
							<div id="hideInheritedProperty" class="hideInheritedProperty">
								<a class="showHideLink" href="#propertySummary" onclick="javascript:setInheritedVisible(false,'Property');">
									<img class="showHideLinkImage" src="{$baseRef}images/expanded.gif"/>
									<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'HideInheritedPublicProperties']]/entry[2]/p"/>
								</a>
							</div>
							<div id="showInheritedProperty" class="showInheritedProperty">
								<a class="showHideLink" href="#propertySummary" onclick="javascript:setInheritedVisible(true,'Property');">
									<img class="showHideLinkImage" src="{$baseRef}images/collapsed.gif"/>
									<xsl:choose>
										<xsl:when test="$prog_language_name='javascript'"/>
										<xsl:otherwise>
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ShowInheritedPublicProperties']]/entry[2]/p"/>
										</xsl:otherwise>
									</xsl:choose>
								</a>
							</div>
						</xsl:if>
						<xsl:if test="$isConst='false' and $accessLevel='protected'">
							<div id="hideInheritedProtectedProperty" class="hideInheritedProtectedProperty">
								<a class="showHideLink" href="#protectedPropertySummary" onclick="javascript:setInheritedVisible(false,'ProtectedProperty');">
									<img class="showHideLinkImage" src="{$baseRef}images/expanded.gif"/>
									<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'HideInheritedProtectedProperties']]/entry[2]/p"/>
								</a>
							</div>
							<div id="showInheritedProtectedProperty" class="showInheritedProtectedProperty">
								<a class="showHideLink" href="#protectedPropertySummary" onclick="javascript:setInheritedVisible(true,'ProtectedProperty');">
									<img class="showHideLinkImage" src="{$baseRef}images/collapsed.gif"/>
									<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ShowInheritedProtectedProperties']]/entry[2]/p"/>
								</a>
							</div>
						</xsl:if>
					</div>
				</xsl:if>
				<xsl:variable name="tableStyle">
					<xsl:if test="$hasInherited and $hasFields='false'">
						<xsl:text>hideInherited</xsl:text>
						<xsl:if test="$accessLevel='protected'">
							<xsl:text>Protected</xsl:text>
						</xsl:if>
						<xsl:if test="$isConst='true'">
							<xsl:text>Constant</xsl:text>
						</xsl:if>
						<xsl:if test="$isConst='false'">
							<xsl:text>Property</xsl:text>
						</xsl:if>
					</xsl:if>
				</xsl:variable>
				<xsl:variable name="tableId">
					<xsl:text>summaryTable</xsl:text>
					<xsl:if test="$accessLevel='protected'">
						<xsl:text>Protected</xsl:text>
					</xsl:if>
					<xsl:if test="$isConst='true'">
						<xsl:text>Constant</xsl:text>
					</xsl:if>
					<xsl:if test="$isConst='false'">
						<xsl:text>Property</xsl:text>
					</xsl:if>
				</xsl:variable>
				<table cellspacing="0" cellpadding="3" class="summaryTable {$tableStyle}" id="{$tableId}">
					<tr>
						<th>
							<xsl:value-of select="$nbsp"/>
						</th>
						<th colspan="2">
							<xsl:if test="$isConst='false'">
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PropertyProperty']]/entry[2]/p"/>
							</xsl:if>
							<xsl:if test="$isConst='true'">
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Constant']]/entry[2]/p"/>
							</xsl:if>
						</th>
						<xsl:if test="not($config/options/@docversion='2')">
							<th class="summaryTableOwnerCol">
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DefinedBy']]/entry[2]/p"/>
							</th>
						</xsl:if>
					</tr>
					<xsl:for-each
						select="apiValue[(not(apiValueDetail/apiValueDef/apiProperty)=($isConst='true') or apiValueDetail/apiValueDef/apiProperty='false') and (apiValueDetail/apiValueDef/apiAccess/@value = $accessLevel or apiValueDetail/apiValueDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.)] | $ancestorNode/ancestors/apiValue[( not(apiValueDetail/apiValueDef/apiProperty)=($isConst='true') or apiValueDetail/apiValueDef/apiProperty='false') and (apiValueDetail/apiValueDef/apiAccess/@value = $accessLevel or apiValueDetail/apiValueDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.)]">
						<xsl:sort select="translate(apiName,'_','')" order="ascending" data-type="text" lang="en-US"/>
						<xsl:variable name="name" select="./apiName"/>
						<xsl:variable name="rowStyle">
							<xsl:if test="ancestor::ancestors">
								<xsl:text>hideInherited</xsl:text>
								<xsl:if test="$accessLevel='protected'">
									<xsl:text>Protected</xsl:text>
								</xsl:if>
								<xsl:if test="$isConst='true'">
									<xsl:text>Constant</xsl:text>
								</xsl:if>
								<xsl:if test="$isConst='false'">
									<xsl:text>Property</xsl:text>
								</xsl:if>
							</xsl:if>
						</xsl:variable>
						<tr class="{$rowStyle}">
							<td class="summaryTablePaddingCol">
								<xsl:value-of select="$nbsp"/>
							</td>
							<td class="summaryTableInheritanceCol">
								<xsl:if test="ancestor::ancestors">
									<img src="{$baseRef}images/inheritedSummary.gif" alt="Inherited" title="Inherited" class="inheritedSummaryImage"/>
								</xsl:if>
								<xsl:if test="not(ancestor::ancestors)">
									<xsl:value-of select="$nbsp"/>
								</xsl:if>
							</td>
							<td class="summaryTableSignatureCol">
								<xsl:choose>
									<xsl:when test="ancestor::ancestors">
										<xsl:variable name="hLink">
											<xsl:variable name="memberName" select="./apiName"/>
											<xsl:variable name="id" select="./@id"/>
											<xsl:variable name="classNameText" select="substring-after($id,':')"/>
											<xsl:variable name="packageNameText" select="substring-before($id,':')"/>
											<xsl:variable name="packageName">
												<xsl:choose>
													<xsl:when test="not(contains($packageNameText,'.')) and string-length($packageNameText) = 0">
														<xsl:value-of select="''"/>
													</xsl:when>
													<xsl:otherwise>
														<xsl:value-of select="$packageNameText"/>
													</xsl:otherwise>
												</xsl:choose>
											</xsl:variable>
											<xsl:variable name="className">
												<xsl:choose>
													<xsl:when test="contains($packageName,'.')">
														<xsl:if test="contains($classNameText,':')">
															<xsl:value-of select="substring-before($classNameText,':')"/>
														</xsl:if>
														<xsl:if test="not(contains($classNameText,':'))">
															<xsl:value-of select="$classNameText"/>
														</xsl:if>
													</xsl:when>
													<xsl:otherwise>
														<xsl:if test="contains($classNameText,':')">
															<xsl:value-of select="substring-before($classNameText,':')"/>
														</xsl:if>
														<xsl:if test="not(contains($classNameText,':'))">
															<xsl:value-of select="$classNameText"/>
														</xsl:if>
													</xsl:otherwise>
												</xsl:choose>
											</xsl:variable>
											<xsl:variable name="methodName">
												<xsl:choose>
													<xsl:when test="$memberName != ''">
														<xsl:value-of select="$memberName"/>
													</xsl:when>
													<xsl:when test="contains($packageName,'.')">
														<xsl:if test="contains($classNameText,':')">
															<xsl:value-of select="substring-after($classNameText,':')"/>
														</xsl:if>
													</xsl:when>
													<xsl:otherwise>
														<xsl:value-of select="substring-after($id,':')"/>
													</xsl:otherwise>
												</xsl:choose>
											</xsl:variable>
											<xsl:variable name="destination" select="concat($packageName,':',$className)"/>
											<xsl:variable name="h1" select="substring-before($destination,':')"/>
											<xsl:variable name="h2" select="substring-after($destination,':')"/>
											<xsl:variable name="file" select="concat($baseRef,translate($h1,'.','/'),'/',$h2,'.html')"/>
											<xsl:variable name="gfile" select="concat($baseRef,$h2,'.html')"/>
											<xsl:variable name="completeHLink">
												<xsl:if test="string-length($methodName) &gt; 0">
													<xsl:choose>
														<xsl:when test="contains($methodName,':')">
															<xsl:value-of select="concat('#',substring-before($methodName,':'))"/>
														</xsl:when>
														<xsl:otherwise>
															<xsl:value-of select="concat('#',$methodName)"/>
														</xsl:otherwise>
													</xsl:choose>
												</xsl:if>
											</xsl:variable>
											<xsl:if test="contains($destination,'.') or string-length($packageNameText) &gt; 0">
												<xsl:choose>
													<xsl:when test="$prog_language_name='javascript'"/>
													<xsl:otherwise>
														<xsl:value-of select="$file"/>
														<xsl:value-of select="$completeHLink"/>
													</xsl:otherwise>
												</xsl:choose>
											</xsl:if>
											<xsl:if test="not(contains($destination,'.')) and string-length($packageNameText) = 0">
												<xsl:choose>
													<xsl:when test="$prog_language_name='javascript'"/>
													<xsl:otherwise>
														<xsl:value-of select="$gfile"/>
														<xsl:value-of select="$completeHLink"/>
													</xsl:otherwise>
												</xsl:choose>
											</xsl:if>
										</xsl:variable>
										<xsl:choose>
											<xsl:when test="$prog_language_name='javascript'"/>
											<xsl:otherwise>
												<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
													<xsl:call-template name="insertAIRIcon">
														<xsl:with-param name="baseRef" select="$baseRef"/>
													</xsl:call-template>
													<xsl:value-of select="$nbsp"/>
												</xsl:if>
											</xsl:otherwise>
										</xsl:choose>
										<xsl:if test="$hLink!=''">
											<a href="{$hLink}" class="signatureLink">
												<xsl:value-of select="./apiName"/>
											</a>
										</xsl:if>
										<xsl:if test="$hLink=''">
											<xsl:value-of select="./apiName"/>
										</xsl:if>
									</xsl:when>
									<xsl:when test="ancestor::apiClassifier or ancestor-or-self::apiPackage">
										<xsl:choose>
											<xsl:when test="$prog_language_name='javascript'"/>
											<xsl:otherwise>
												<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
													<xsl:call-template name="insertAIRIcon">
														<xsl:with-param name="baseRef" select="$baseRef"/>
													</xsl:call-template>
													<xsl:value-of select="$nbsp"/>
												</xsl:if>
											</xsl:otherwise>
										</xsl:choose>
										<a href="#{$name}" class="signatureLink">
											<xsl:value-of select="$name"/>
										</a>
									</xsl:when>
								</xsl:choose>
								<xsl:if test="./apiValueDetail/apiValueDef/apiValueClassifier | ./apiValueDetail/apiValueDef/apiType ">
									<xsl:text> : </xsl:text>
									<xsl:choose>
										<xsl:when test="./apiValueDetail/apiValueDef/apiValueClassifier">
											<xsl:variable name="destination" select="./apiValueDetail/apiValueDef/apiValueClassifier"/>
											<xsl:variable name="h1" select="substring-after($destination,':')"/>
											<xsl:variable name="h2" select="substring-before($destination,':')"/>
											<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
											<xsl:variable name="gfile" select="concat($baseRef,$destination,'.html')"/>
											<xsl:variable name="hyperLink">
												<xsl:if test="contains($destination,':')">
													<xsl:if test="$prog_language_name!='javascript'">
														<xsl:value-of select="$file"/>
													</xsl:if>
												</xsl:if>
												<xsl:if test="not(contains($destination,':'))">
													<xsl:choose>
														<xsl:when test="$prog_language_name='javascript'"/>
														<xsl:otherwise>
															<xsl:value-of select="$gfile"/>
														</xsl:otherwise>
													</xsl:choose>
												</xsl:if>
											</xsl:variable>
											<xsl:if test="$hyperLink = ''">
												<xsl:call-template name="getSimpleClassName">
													<xsl:with-param name="fullClassName" select="./apiValueDetail/apiValueDef/apiValueClassifier"/>
												</xsl:call-template>
											</xsl:if>
											<xsl:if test="$hyperLink != ''">
												<a href="{$hyperLink}">
													<xsl:call-template name="getSimpleClassName">
														<xsl:with-param name="fullClassName" select="./apiValueDetail/apiValueDef/apiValueClassifier"/>
													</xsl:call-template>
												</a>
											</xsl:if>
										</xsl:when>
										<xsl:when test="./apiValueDetail/apiValueDef/apiValueClassifier='' or apiValueDetail/apiValueDef/apiValueClassifier='*'">
											<xsl:call-template name="getSpecialTypeLink">
												<xsl:with-param name="type" select="'*'"/>
												<xsl:with-param name="baseRef" select="$baseRef"/>
											</xsl:call-template>
										</xsl:when>
										<xsl:when test="./apiValueDetail/apiValueDef/apiType/@value='' or apiValueDetail/apiValueDef/apiType/@value='*' or apiValueDetail/apiValueDef/apiType/@value='any'">
											<xsl:call-template name="getSpecialTypeLink">
												<xsl:with-param name="type" select="'*'"/>
												<xsl:with-param name="baseRef" select="$baseRef"/>
											</xsl:call-template>
										</xsl:when>
										<xsl:when test="./apiValueDetail/apiValueDef/apiType">
											<xsl:call-template name="getSimpleClassName">
												<xsl:with-param name="fullClassName" select="./apiValueDetail/apiValueDef/apiType/@value"/>
												<xsl:with-param name="baseRef" select="$baseRef"/>
											</xsl:call-template>
										</xsl:when>
										<xsl:otherwise>
											<xsl:call-template name="getSimpleClassName">
												<xsl:with-param name="fullClassName" select="./apiValueDetail/apiValueDef/apiValueClassifier"/>
											</xsl:call-template>
										</xsl:otherwise>
									</xsl:choose>
								</xsl:if>
								<xsl:if test="(string-length(./apiValueDetail/apiValueDef/apiData) or ./apiValueDetail/apiValueDef/apiValueClassifier='String') and ./apiValueDetail/apiValueDef/apiData!='unknown'">
									<xsl:text> = </xsl:text>
									<xsl:if test="./apiValueDetail/apiValueDef/apiType/@value='String'">
										<xsl:text>"</xsl:text>
									</xsl:if>
									<xsl:value-of select="./apiValueDetail/apiValueDef/apiData"/>
									<xsl:if test="apiValueDetail/apiValueDef/apiType/@value='String'">
										<xsl:text>"</xsl:text>
									</xsl:if>
								</xsl:if>
								<xsl:if test="./apiValueDetail/apiValueDef/apiValueClassifier='Number' and ./apiValueDetail/apiValueDef/apiData='unknown'">
									<xsl:text> = NaN</xsl:text>
								</xsl:if>
								<xsl:if test="./apiValueDetail/apiValueDef/apiValueClassifier='String' and ./apiValueDetail/apiValueDef/apiData='unknown'">
									<xsl:text> = "</xsl:text>
									<xsl:value-of select="./apiValueDetail/apiValueDef/apiData"/>
									<xsl:text>"</xsl:text>
								</xsl:if>
								<div class="summaryTableDescription">
									<xsl:apply-templates select="apiValueDetail/apiValueDef/apiDeprecated"/>
									<xsl:apply-templates select="deprecated"/>

									  <xsl:if test="./apiValueDetail/apiValueDef/apiIsOverride">
										<xsl:text>[</xsl:text>
										<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Override']]/entry[2]/p"/>
										<xsl:text>] </xsl:text>
									  </xsl:if>
									<xsl:if test="not(deprecated)">
										<xsl:if test="./apiValueDetail/apiValueDef/apiStatic">
											<xsl:text>[</xsl:text>
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'static']]/entry[2]/p"/>
											<xsl:text>] </xsl:text>
										</xsl:if>
										<xsl:if test="./apiValueDetail/apiValueDef/apiValueAccess/@value and not(./apiValueDetail/apiValueDef/apiValueAccess/@value='readwrite')">
											<xsl:text>[</xsl:text>
											<xsl:variable name="value" select="./apiValueDetail/apiValueDef/apiValueAccess/@value"/>
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = $value]]/entry[2]/p"/>
											<xsl:text>-</xsl:text>
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'only']]/entry[2]/p"/>
											<xsl:text>] </xsl:text>
										</xsl:if>
										<xsl:if test="./shortdesc or $classDeprecated='true'">
											<xsl:call-template name="shortDescriptionReview"/>
											<xsl:if test="$classDeprecated='true'">
												<xsl:copy-of select="$deprecatedLabel"/>
												<xsl:text>. </xsl:text>
											</xsl:if>
										</xsl:if>
										<xsl:if test="not(string-length(./shortdesc/@conref) &gt; 0)">
											<xsl:for-each select="./shortdesc">
												<xsl:call-template name="processTags"/>
											</xsl:for-each>
										</xsl:if>
									</xsl:if>
								</div>
							</td>
							<xsl:if test="not($config/options/@docversion='2')">
								<td class="summaryTableOwnerCol">
									<xsl:choose>
										<xsl:when test="ancestor::ancestors">
											<xsl:variable name="classLink">
												<xsl:variable name="id" select="./@id"/>
												<xsl:variable name="classNameText" select="substring-after($id,':')"/>
												<xsl:variable name="packageNameText" select="substring-before($id,':')"/>
												<xsl:variable name="packageName">
													<xsl:choose>
														<xsl:when test="not(contains($packageNameText,'.')) and string-length($packageNameText) = 0">
															<xsl:value-of select="''"/>
														</xsl:when>
														<xsl:otherwise>
															<xsl:value-of select="$packageNameText"/>
														</xsl:otherwise>
													</xsl:choose>
												</xsl:variable>
												<xsl:variable name="className">
													<xsl:choose>
														<xsl:when test="contains($packageName,'.')">
															<xsl:if test="contains($classNameText,':')">
																<xsl:value-of select="substring-before($classNameText,':')"/>
															</xsl:if>
															<xsl:if test="not(contains($classNameText,':'))">
																<xsl:value-of select="$classNameText"/>
															</xsl:if>
														</xsl:when>
														<xsl:otherwise>
															<xsl:if test="contains($classNameText,':')">
																<xsl:value-of select="substring-before($classNameText,':')"/>
															</xsl:if>
															<xsl:if test="not(contains($classNameText,':'))">
																<xsl:value-of select="$classNameText"/>
															</xsl:if>
														</xsl:otherwise>
													</xsl:choose>
												</xsl:variable>
												<xsl:variable name="destination" select="concat($packageName,':',$className)"/>
												<xsl:variable name="h1" select="substring-before($destination,':')"/>
												<xsl:variable name="h2" select="substring-after($destination,':')"/>
												<xsl:variable name="file" select="concat($baseRef,translate($h1,'.','/'),'/',$h2,'.html')"/>
												<xsl:variable name="gfile" select="concat($baseRef,$h2,'.html')"/>
												<xsl:if test="contains($id,'.') or string-length($packageNameText) &gt; 0">
													<xsl:choose>
														<xsl:when test="$prog_language_name='javascript'"/>
														<xsl:otherwise>
															<xsl:value-of select="$file"/>
														</xsl:otherwise>
													</xsl:choose>
												</xsl:if>
												<xsl:if test="not(contains($id,'.')) and string-length($packageNameText) = 0">
													<xsl:choose>
														<xsl:when test="$prog_language_name='javascript'"/>
														<xsl:otherwise>
															<xsl:value-of select="$gfile"/>
														</xsl:otherwise>
													</xsl:choose>
												</xsl:if>
											</xsl:variable>
											<xsl:variable name="className">
												<xsl:call-template name="getClassNameFromId">
													<xsl:with-param name="id" select="./@id"/>
												</xsl:call-template>
											</xsl:variable>
											<xsl:choose>
												<xsl:when test="$classLink!=''">
													<a href="{$classLink}">
														<xsl:value-of select="$className"/>
													</a>
												</xsl:when>
												<xsl:otherwise>
													<xsl:value-of select="$className"/>
												</xsl:otherwise>
											</xsl:choose>
										</xsl:when>
										<xsl:when test="ancestor::apiClassifier">
											<xsl:value-of select="ancestor::apiClassifier/apiName"/>
										</xsl:when>
										<xsl:when test="ancestor-or-self::apiPackage">
											<xsl:if test="ancestor-or-self::apiPackage/apiName='__Global__'">
												<xsl:value-of select="concat('Top',$nbsp,'Level')"/>
											</xsl:if>
											<xsl:if test="ancestor-or-self::apiPackage/apiName!='__Global__'">
												<xsl:value-of select="ancestor-or-self::apiPackage/apiName"/>
											</xsl:if>
										</xsl:when>
									</xsl:choose>
								</td>
							</xsl:if>
						</tr>
					</xsl:for-each>
				</table>
				<!-- AS2 INHERITED PROPERTIES -->
				<xsl:if test="$config/options/@docversion='2'">
					<xsl:for-each select="asAncestors/asAncestor">
						<xsl:call-template name="inherited">
							<xsl:with-param name="lowerType">properties</xsl:with-param>
							<xsl:with-param name="upperType">Properties</xsl:with-param>
							<xsl:with-param name="inheritedItems" select="@properties"/>
							<xsl:with-param name="staticItems" select="@staticProperties"/>
						</xsl:call-template>
					</xsl:for-each>
				</xsl:if>
			</div>
		</xsl:if>
	</xsl:template>
	<xsl:template match="apiValue" mode="detail">
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="isConst" select="'false'"/>
		<xsl:param name="baseRef"/>
		<xsl:variable name="cntPropOrConst">
			<xsl:if test="$isConst='true'">
				<xsl:value-of select="count(../apiValue/apiValueDetail/apiValueDef[not(apiProperty)])"/>
			</xsl:if>
			<xsl:if test="$isConst='false'">
				<xsl:value-of select="count(apiValueDetail/apiValueDef/apiProperty)"/>
			</xsl:if>
		</xsl:variable>
		<xsl:if test="$cntPropOrConst &gt; 0">
			<xsl:if test="$isConst='true'">
				<a name="constantDetail"/>
			</xsl:if>
			<xsl:if test="not($isConst='true')">
				<a name="propertyDetail"/>
			</xsl:if>
			<xsl:if test="$cntPropOrConst &gt; 0">
				<xsl:for-each select="./apiName">
					<xsl:sort select="translate(./apiName,'_','')" order="ascending" lang="en-US"/>
				</xsl:for-each>
				<xsl:variable name="name" select="./apiName"/>
				<a name="{$name}"/>
				<table class="detailHeader" cellpadding="0" cellspacing="0">
					<tr>
						<td class="detailHeaderName">
							<xsl:choose>
								<xsl:when test="$prog_language_name='javascript'"/>
								<xsl:otherwise>
									<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
										<xsl:call-template name="insertAIRIcon">
											<xsl:with-param name="baseRef" select="$baseRef"/>
										</xsl:call-template>
										<xsl:value-of select="$nbsp"/>
									</xsl:if>
								</xsl:otherwise>
							</xsl:choose>
							<xsl:value-of select="$name"/>
						</td>
						<td class="detailHeaderType">
							<xsl:if test="not(apiValueDetail/apiValueDef/apiProperty)">
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Constant']]/entry[2]/p"/>
							</xsl:if>
							<xsl:if test="apiValueDetail/apiValueDef/apiProperty">
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Property']]/entry[2]/p"/>
							</xsl:if>
						</td>
						<xsl:if test="position()!=1">
							<td class="detailHeaderRule">
								<xsl:value-of select="$nbsp"/>
							</td>
						</xsl:if>
					</tr>
				</table>
				<div class="detailBody">
					<code>
						<xsl:if test="string-length(apiValueDetail/apiValueDef/apiValueAccess/@value)">
							<xsl:value-of select="$name"/>
						</xsl:if>
						<xsl:if test="not(string-length(apiValueDetail/apiValueDef/apiValueAccess/@value))">
							<xsl:call-template name="getNamespaceLink">
								<xsl:with-param name="accessLevel" select="apiValueDetail/apiValueDef/apiAccess/@value"/>
								<xsl:with-param name="baseRef" select="$baseRef"/>
							</xsl:call-template>
							<xsl:text> </xsl:text>
							<xsl:if test="apiValueDetail/apiValueDef/apiStatic">
								<xsl:text>static </xsl:text>
							</xsl:if>
							<xsl:if test="$prog_language_name='ActionScript'">
								<xsl:choose>
									<xsl:when test="not(apiValueDetail/apiValueDef/apiProperty) and $config/options/@docversion='3'">
										<xsl:text>const </xsl:text>
									</xsl:when>
									<xsl:otherwise>
										<xsl:text>var </xsl:text>
									</xsl:otherwise>
								</xsl:choose>
							</xsl:if>
							<xsl:value-of select="$name"/>
						</xsl:if>
						<xsl:if test="apiValueDetail/apiValueDef/apiValueClassifier | apiValueDetail/apiValueDef/apiType">
							<xsl:text>:</xsl:text>
							<xsl:choose>
								<xsl:when test="apiValueDetail/apiValueDef/apiValueClassifier">
									<xsl:variable name="destination" select="./apiValueDetail/apiValueDef/apiValueClassifier"/>
									<xsl:variable name="h1" select="substring-after($destination,':')"/>
									<xsl:variable name="h2" select="substring-before($destination,':')"/>
									<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
									<xsl:variable name="gfile" select="concat($baseRef,$destination,'.html')"/>
									<xsl:variable name="hyperLink">
										<xsl:if test="contains($destination,':')">
											<xsl:if test="$prog_language_name!='javascript'">
												<xsl:value-of select="$file"/>
											</xsl:if>
										</xsl:if>
										<xsl:if test="not(contains($destination,':'))">
											<xsl:choose>
												<xsl:when test="$prog_language_name='javascript'"/>
												<xsl:otherwise>
													<xsl:value-of select="$gfile"/>
												</xsl:otherwise>
											</xsl:choose>
										</xsl:if>
									</xsl:variable>
									<xsl:if test="$hyperLink = ''">
										<xsl:call-template name="getSimpleClassName">
											<xsl:with-param name="fullClassName" select="apiValueDetail/apiValueDef/apiValueClassifier"/>
										</xsl:call-template>
									</xsl:if>
									<xsl:if test="$hyperLink != ''">
										<a href="{$hyperLink}">
											<xsl:call-template name="getSimpleClassName">
												<xsl:with-param name="fullClassName" select="apiValueDetail/apiValueDef/apiValueClassifier"/>
											</xsl:call-template>
										</a>
									</xsl:if>
								</xsl:when>
								<xsl:when
									test="apiValueDetail/apiValueDef/apiValueClassifier='' or apiValueDetail/apiValueDef/apiValueClassifier='*' or apiValueDetail/apiValueDef/apiType/@value='' or apiValueDetail/apiValueDef/apiType/@value='*' or apiValueDetail/apiValueDef/apiType/@value='any'">
									<xsl:call-template name="getSpecialTypeLink">
										<xsl:with-param name="type" select="'*'"/>
										<xsl:with-param name="baseRef" select="$baseRef"/>
									</xsl:call-template>
								</xsl:when>
								<xsl:when test="apiValueDetail/apiValueDef/apiType">
									<xsl:call-template name="getSimpleClassName">
										<xsl:with-param name="fullClassName" select="apiValueDetail/apiValueDef/apiType/@value"/>
										<xsl:with-param name="baseRef" select="$baseRef"/>
									</xsl:call-template>
								</xsl:when>
								<xsl:otherwise>
									<xsl:call-template name="getSimpleClassName">
										<xsl:with-param name="fullClassName" select="apiValueDetail/apiValueDef/apiValueClassifier"/>
									</xsl:call-template>
								</xsl:otherwise>
							</xsl:choose>
						</xsl:if>
						<xsl:if test="(string-length(apiValueDetail/apiValueDef/apiData) or apiValueDetail/apiValueDef/apiValueClassifier='String') and apiValueDetail/apiValueDef/apiData!='unknown'">
							<xsl:text> = </xsl:text>
							<xsl:if test="apiValueDetail/apiValueDef/apiType/@value='String'">
								<xsl:text>"</xsl:text>
							</xsl:if>
							<xsl:value-of select="apiValueDetail/apiValueDef/apiData"/>
							<xsl:if test="apiValueDetail/apiValueDef/apiType/@value='String'">
								<xsl:text>"</xsl:text>
							</xsl:if>
						</xsl:if>

						<xsl:if test="apiValueDetail/apiValueDef/apiValueClassifier='Number' and apiValueDetail/apiValueDef/apiData='unknown'">
							<xsl:text> = NaN</xsl:text>
						</xsl:if>
						<xsl:if test="apiValueDetail/apiValueDef/apiValueClassifier='String' and apiValueDetail/apiValueDef/apiData='unknown'">
							<xsl:text> = "</xsl:text>
							<xsl:value-of select="apiValueDetail/apiValueDef/apiData"/>
							<xsl:text>"</xsl:text>
						</xsl:if>
					</code>
					<xsl:if test="string-length(apiValueDetail/apiValueDef/apiValueAccess/@value)">
						<xsl:if test="not(apiValueDetail/apiValueDef/apiValueAccess/@value='readwrite')">
							<xsl:text disable-output-escaping="yes"><![CDATA[&nbsp;&nbsp;]]>[</xsl:text>
							<xsl:variable name="value" select="apiValueDetail/apiValueDef/apiValueAccess/@value"/>
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = $value]]/entry[2]/p"/>
							<xsl:text>-</xsl:text>
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'only']]/entry[2]/p"/>
							<xsl:text>] </xsl:text>
						</xsl:if>
					</xsl:if>
					  <xsl:if test="apiValueDetail/apiValueDef/apiIsOverride">
						<xsl:text>[</xsl:text>
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Override']]/entry[2]/p"/>
						<xsl:text>] </xsl:text>
					  </xsl:if>
					<xsl:apply-templates select="apiValueDetail/apiValueDef/apiDeprecated"/>
					<xsl:apply-templates select="deprecated"/>
					<xsl:if test="$classDeprecated='true'">
						<xsl:call-template name="description">
							<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
							<xsl:with-param name="addParagraphTags" select="true()"/>
						</xsl:call-template>
					</xsl:if>
					<xsl:call-template name="version"/>
					<xsl:if test="$classDeprecated!='true'">
						<xsl:call-template name="description">
							<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
							<xsl:with-param name="addParagraphTags" select="true()"/>
						</xsl:call-template>
						<xsl:for-each select="apiDesc">
							<xsl:call-template name="processTags"/>
						</xsl:for-each>
					</xsl:if>
					<xsl:if test="apiValueDetail/apiValueDef/apiDefaultValue">
						<p>
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DefaultValueIs']]/entry[2]/p"/>
							<xsl:text> </xsl:text>
							<code>
								<xsl:value-of select="normalize-space(apiValueDetail/apiValueDef/apiDefaultValue/.)"/>
							</code>
							<xsl:text>.</xsl:text>
						</p>
					</xsl:if>
					<xsl:if test="apiValueDetail/apiValueDef/apiProperty/@isBindable='true'">
						<p>
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DataBinding']]/entry[2]/p"/>
						</p>
					</xsl:if>
					<xsl:choose>
						<xsl:when test="$prog_language_name='javascript'"/>
						<xsl:otherwise>
							<xsl:if test="string-length(apiValueDetail/apiValueDef/apiValueAccess/@value)">
								<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
								<span class="label">
									<xsl:call-template name="getLocalizedString">
										<xsl:with-param name="key">Implementation</xsl:with-param>
									</xsl:call-template>
								</span>
								<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
								<xsl:if test="contains(apiValueDetail/apiValueDef/apiValueAccess/@value,'read')">
									<code>
										<xsl:text disable-output-escaping="yes"><![CDATA[&nbsp;&nbsp;&nbsp;&nbsp;]]></xsl:text>
										<xsl:call-template name="getNamespaceLink">
											<xsl:with-param name="accessLevel" select="apiValueDetail/apiValueDef/apiAccess/@value"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
										</xsl:call-template>
										<xsl:text> </xsl:text>
										<xsl:if test="apiValueDetail/apiValueDef/apiStatic">
											<xsl:text>static </xsl:text>
										</xsl:if>
										<xsl:text>function get </xsl:text>
										<xsl:value-of select="$name"/>
										<xsl:text>():</xsl:text>
										<xsl:choose>
											<xsl:when test="./apiValueDetail/apiValueDef/apiValueClassifier">
												<xsl:variable name="destination" select="./apiValueDetail/apiValueDef/apiValueClassifier"/>
												<xsl:variable name="h1" select="substring-after($destination,':')"/>
												<xsl:variable name="h2" select="substring-before($destination,':')"/>
												<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
												<xsl:variable name="gfile" select="concat($baseRef,$destination,'.html')"/>
												<xsl:variable name="hyperLink">
													<xsl:if test="contains($destination,'.')">
														<xsl:value-of select="$file"/>
													</xsl:if>
													<xsl:if test="not(contains($destination,'.'))">
														<xsl:value-of select="$gfile"/>
													</xsl:if>
												</xsl:variable>
												<xsl:if test="$hyperLink = ''">
													<xsl:call-template name="getSimpleClassName">
														<xsl:with-param name="fullClassName" select="apiValueDetail/apiValueDef/apiValueClassifier"/>
													</xsl:call-template>
												</xsl:if>
												<xsl:if test="$hyperLink != ''">
													<a href="{$hyperLink}">
														<xsl:call-template name="getSimpleClassName">
															<xsl:with-param name="fullClassName" select="apiValueDetail/apiValueDef/apiValueClassifier"/>
														</xsl:call-template>
													</a>
												</xsl:if>
											</xsl:when>
											<xsl:when
												test="apiValueDetail/apiValueDef/apiValueClassifier='' or apiValueDetail/apiValueDef/apiValueClassifier='*' or apiValueDetail/apiValueDef/apiType/@value='any' or apiValueDetail/apiValueDef/apiType/@value='' or apiValueDetail/apiValueDef/apiType/@value='*'">
												<xsl:call-template name="getSpecialTypeLink">
													<xsl:with-param name="type" select="'*'"/>
													<xsl:with-param name="baseRef" select="$baseRef"/>
												</xsl:call-template>
											</xsl:when>
											<xsl:when test="apiValueDetail/apiValueDef/apiType">
												<xsl:call-template name="getSimpleClassName">
													<xsl:with-param name="fullClassName" select="apiValueDetail/apiValueDef/apiType/@value"/>
													<xsl:with-param name="baseRef" select="$baseRef"/>
												</xsl:call-template>
											</xsl:when>
											<xsl:otherwise>
												<xsl:call-template name="getSimpleClassName">
													<xsl:with-param name="fullClassName" select="apiValueDetail/apiValueDef/apiValueClassifier"/>
												</xsl:call-template>
											</xsl:otherwise>
										</xsl:choose>
									</code>
									<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
								</xsl:if>
								<xsl:if test="contains(apiValueDetail/apiValueDef/apiValueAccess/@value,'write')">
									<code>
										<xsl:text disable-output-escaping="yes"><![CDATA[&nbsp;&nbsp;&nbsp;&nbsp;]]></xsl:text>
										<xsl:call-template name="getNamespaceLink">
											<xsl:with-param name="accessLevel" select="apiValueDetail/apiValueDef/apiAccess/@value"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
										</xsl:call-template>
										<xsl:text> </xsl:text>
										<xsl:if test="apiValueDetail/apiValueDef/apiStatic">
											<xsl:text>static </xsl:text>
										</xsl:if>
										<xsl:text>function set </xsl:text>
										<xsl:value-of select="$name"/>
										<xsl:text>(value:</xsl:text>
										<xsl:choose>
											<xsl:when test="./apiValueDetail/apiValueDef/apiValueClassifier">
												<xsl:variable name="destination" select="./apiValueDetail/apiValueDef/apiValueClassifier"/>
												<xsl:variable name="h1" select="substring-after($destination,':')"/>
												<xsl:variable name="h2" select="substring-before($destination,':')"/>
												<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
												<xsl:variable name="gfile" select="concat($baseRef,$destination,'.html')"/>
												<xsl:variable name="hyperLink">
													<xsl:if test="contains($destination,'.')">
														<xsl:value-of select="$file"/>
													</xsl:if>
													<xsl:if test="not(contains($destination,'.'))">
														<xsl:value-of select="$gfile"/>
													</xsl:if>
												</xsl:variable>
												<xsl:if test="$hyperLink = ''">
													<xsl:call-template name="getSimpleClassName">
														<xsl:with-param name="fullClassName" select="apiValueDetail/apiValueDef/apiValueClassifier"/>
													</xsl:call-template>
												</xsl:if>
												<xsl:if test="$hyperLink != ''">
													<a href="{$hyperLink}">
														<xsl:call-template name="getSimpleClassName">
															<xsl:with-param name="fullClassName" select="apiValueDetail/apiValueDef/apiValueClassifier"/>
														</xsl:call-template>
													</a>
												</xsl:if>
											</xsl:when>
											<xsl:when test="apiValueDetail/apiValueDef/apiValueClassifier='' or apiValueDetail/apiValueDef/apiValueClassifier='*'">
												<xsl:call-template name="getSpecialTypeLink">
													<xsl:with-param name="type" select="'*'"/>
													<xsl:with-param name="baseRef" select="$baseRef"/>
												</xsl:call-template>
											</xsl:when>
											<xsl:when test="apiValueDetail/apiValueDef/apiType">
												<xsl:call-template name="getSimpleClassName">
													<xsl:with-param name="fullClassName" select="apiValueDetail/apiValueDef/apiType/@value"/>
													<xsl:with-param name="baseRef" select="$baseRef"/>
												</xsl:call-template>
											</xsl:when>
											<xsl:otherwise>
												<xsl:call-template name="getSimpleClassName">
													<xsl:with-param name="fullClassName" select="apiValueDetail/apiValueDef/apiValueClassifier"/>
												</xsl:call-template>
											</xsl:otherwise>
										</xsl:choose>
										<xsl:text>):</xsl:text>
										<xsl:call-template name="getSpecialTypeLink">
											<xsl:with-param name="type" select="'void'"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
										</xsl:call-template>
									</code>
									<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
								</xsl:if>
							</xsl:if>
						</xsl:otherwise>
					</xsl:choose>
					<xsl:if test="apiValueDetail/apiValueDef/apiException">
						<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
						<span class="label">
							<xsl:call-template name="getLocalizedString">
								<xsl:with-param name="key">Throws</xsl:with-param>
							</xsl:call-template>
						</span>
						<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
						<table cellpadding="0" cellspacing="0" border="0">
							<xsl:apply-templates select="apiValueDetail/apiValueDef/apiException"/>
						</table>
					</xsl:if>
					<xsl:call-template name="sees"/>
					<xsl:if test="./*/example[codeblock] | includeExamples/includeExample[codepart]">
						<xsl:call-template name="includeExamples">
							<xsl:with-param name="createExampleLink" select="'false'"/>
						</xsl:call-template>
					</xsl:if>
					<xsl:if test="./*/example[not(codeblock)] | includeExamples/includeExample[not(codepart)] ">
						<xsl:for-each select="./*/example | includeExamples/includeExample[not(codepart)]">
							<xsl:if test="count(descendant::*) &gt; 0">
								<xsl:if test="position() = 1">
									<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
									<span class="label">
										<xsl:call-template name="getLocalizedString">
											<xsl:with-param name="key">Example</xsl:with-param>
										</xsl:call-template>
									</span>
									<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
								</xsl:if>
								<xsl:call-template name="processTags"/>
							</xsl:if>
						</xsl:for-each>
					</xsl:if>
				</div>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<!-- STYLES -->
	<xsl:template name="stylesSummary">
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="baseRef" select="''"/>
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:param name="interfaces" tunnel="yes"/>
		<xsl:variable name="ancestorexcludes">
			<excludes>
				<xsl:variable name="self" select="@id"/>
				<xsl:for-each select="$classHeader_map//apiClassifier[@id = $self]//Excludes/Exclude[@kind='style']">
					<xsl:copy-of select="."/>
				</xsl:for-each>
			</excludes>
		</xsl:variable>
		<!--List of styles to suppress when creating inheritance list.  Includes both the existing styles and any exclusions-->
		<xsl:variable name="stylesList">
			<xsl:for-each select="prolog/asMetadata/styles/style">
				<xsl:value-of select="concat(' ',@name,' ')"/>
			</xsl:for-each>
			<xsl:for-each select="$ancestorexcludes/excludes/Exclude">
				<xsl:text> </xsl:text>
				<xsl:value-of select="@name"/>
				<xsl:text> </xsl:text>
			</xsl:for-each>
		</xsl:variable>
		<xsl:variable name="hasStyles" select="count(prolog/asMetadata[styles/style]) &gt; 0"/>
		<xsl:variable name="ancestorNodes">
			<ancestors>
				<xsl:call-template name="getInheritedStyle">
					<xsl:with-param name="baseClass" select="./apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
					<xsl:with-param name="currentPackage" select="$currentPackage"/>
					<xsl:with-param name="stylesList" select="$stylesList"/>
				</xsl:call-template>
			</ancestors>
			<xsl:for-each select="$interfaces/interface">
				<xsl:call-template name="getInheritedStyle">
					<xsl:with-param name="baseClass" select="."/>
					<xsl:with-param name="currentPackage" select="$currentPackage"/>
					<xsl:with-param name="stylesList" select="$stylesList"/>
					<xsl:with-param name="processParentClass" select="false()"/>
				</xsl:call-template>
			</xsl:for-each>
		</xsl:variable>
		<xsl:variable name="hasInherited" select="count($ancestorNodes/ancestors/style) &gt; 0"/>
		<xsl:if test="$hasStyles or $hasInherited">
			<a name="styleSummary"/>
			<div class="summarySection">
				<div class="summaryTableTitle">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Styles']]/entry[2]/p"/>
				</div>
				<xsl:if test="$hasInherited">
					<div class="showHideLinks">
						<div id="hideInheritedStyle" class="hideInheritedStyle">
							<a class="showHideLink" href="#styleSummary" onclick="javascript:setInheritedVisible(false,'Style');">
								<img class="showHideLinkImage" src="{$baseRef}images/expanded.gif"/>
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'HideInheritedStyles']]/entry[2]/p"/>
							</a>
						</div>
						<div id="showInheritedStyle" class="showInheritedStyle">
							<a class="showHideLink" href="#styleSummary" onclick="javascript:setInheritedVisible(true,'Style');">
								<img class="showHideLinkImage" src="{$baseRef}images/collapsed.gif"/>
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ShowInheritedStyles']]/entry[2]/p"/>
							</a>
						</div>
					</div>
				</xsl:if>
				<xsl:variable name="tableStyle">
					<xsl:if test="$hasInherited and not($hasStyles)">
						<xsl:text>hideInheritedStyle</xsl:text>
					</xsl:if>
				</xsl:variable>
				<table cellspacing="0" cellpadding="3" class="summaryTable {$tableStyle}" id="summaryTableStyle">
					<tr>
						<th>
							<xsl:value-of select="$nbsp"/>
						</th>
						<th colspan="2">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'StyleStyle']]/entry[2]/p"/>
						</th>
						<th class="summaryTableOwnerCol">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DefinedBy']]/entry[2]/p"/>
						</th>
					</tr>
					<xsl:for-each select="./prolog/asMetadata/styles/style | $ancestorNodes/ancestors/style">
						<xsl:sort select="@name" order="ascending" data-type="text" lang="en-US"/>
						<xsl:variable name="sequence" select="ancestor::apiClassifierDetail/apiClassifierDef"/>
						<xsl:variable name="apihtml" select="concat(ancestor::apiClassifier/apiName,'.html')"/>
						<xsl:variable name="destination" select="./@owner"/>
						<xsl:variable name="rowStyle">
							<xsl:if test="ancestor::ancestors">
								<xsl:text>hideInheritedStyle</xsl:text>
							</xsl:if>
						</xsl:variable>
						<tr class="{$rowStyle}">
							<td class="summaryTablePaddingCol">
								<xsl:value-of select="$nbsp"/>
							</td>
							<td class="summaryTableInheritanceCol">
								<xsl:if test="ancestor::ancestors">
									<img src="{$baseRef}images/inheritedSummary.gif" alt="Inherited" title="Inherited" class="inheritedSummaryImage"/>
								</xsl:if>
								<xsl:if test="not(ancestor::ancestors)">
									<xsl:value-of select="$nbsp"/>
								</xsl:if>
							</td>
							<td class="summaryTableSignatureCol">
								<div class="summarySignature">
									<xsl:choose>
										<xsl:when test="ancestor::ancestors">
											<xsl:variable name="destination" select="./@owner"/>
											<xsl:variable name="h1" select="substring-after($destination,':')"/>
											<xsl:variable name="h2" select="substring-before($destination,':')"/>
											<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
											<xsl:variable name="gfile" select="concat($baseRef,translate($destination,':','/'),'.html')"/>
											<xsl:variable name="hyperLink">
												<xsl:if test="contains($destination,'.')">
													<xsl:value-of select="$file"/>
												</xsl:if>
												<xsl:if test="not(contains($destination,'.'))">
													<xsl:value-of select="$gfile"/>
												</xsl:if>
											</xsl:variable>
											<xsl:if test="$hyperLink = ''">
												<xsl:value-of select="@name"/>
											</xsl:if>
											<xsl:if test="$hyperLink != ''">
												<a href="{$hyperLink}#style:{@name}" class="signatureLink">
													<xsl:value-of select="@name"/>
												</a>
											</xsl:if>
										</xsl:when>
										<xsl:when test="ancestor::apiClassifier">
											<a href="#style:{@name}" class="signatureLink">
												<xsl:value-of select="@name"/>
											</a>
										</xsl:when>
									</xsl:choose>
									<xsl:if test="@type">
										<xsl:text> : </xsl:text>
										<xsl:call-template name="getSimpleClassName">
											<xsl:with-param name="fullClassName" select="@type"/>
										</xsl:call-template>
									</xsl:if>
								</div>

								<div class="summaryTableDescription">
									<xsl:apply-templates select="apiValueDetail/apiValueDef/apiDeprecated"/>
									<xsl:apply-templates select="deprecated"/>

									  <xsl:if test="./apiValueDetail/apiValueDef/apiIsOverride">
										<xsl:text>[</xsl:text>
										<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Override']]/entry[2]/p"/>
										<xsl:text>] </xsl:text>
									  </xsl:if>
									<xsl:if test="not(deprecated)">
										<xsl:if test="./apiValueDetail/apiValueDef/apiStatic">
											<xsl:text>[</xsl:text>
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'static']]/entry[2]/p"/>
											<xsl:text>] </xsl:text>
										</xsl:if>
										<xsl:if test="./apiValueDetail/apiValueDef/apiValueAccess/@value and not(./apiValueDetail/apiValueDef/apiValueAccess/@value='readwrite')">
											<xsl:text>[</xsl:text>
											<xsl:variable name="value" select="./apiValueDetail/apiValueDef/apiValueAccess/@value"/>
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = $value]]/entry[2]/p"/>
											<xsl:text>-</xsl:text>
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'only']]/entry[2]/p"/>
											<xsl:text>] </xsl:text>
										</xsl:if>
										<xsl:variable name="description">
											<xsl:call-template name="getFirstSentence">
												<xsl:with-param name="inText" select="./description"/>
											</xsl:call-template>
										</xsl:variable>
										<xsl:for-each select="$description">
											<xsl:call-template name="processTags"/>
										</xsl:for-each>
									</xsl:if>
								</div>
							</td>
							<td class="summaryTableOwnerCol">
								<xsl:choose>
									<xsl:when test="ancestor::ancestors">
										<xsl:variable name="destination" select="./@owner"/>
										<xsl:variable name="h1" select="substring-after($destination,':')"/>
										<xsl:variable name="h2" select="substring-before($destination,':')"/>
										<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
										<xsl:variable name="gfile" select="concat($baseRef,translate($destination,':','/'),'.html')"/>
										<xsl:variable name="classLink">
											<xsl:if test="contains($destination,'.')">
												<xsl:value-of select="$file"/>
											</xsl:if>
											<xsl:if test="not(contains($destination,'.'))">
												<xsl:value-of select="$gfile"/>
											</xsl:if>
										</xsl:variable>
										<xsl:if test="$classLink = ''">
											<xsl:value-of select="substring-after(./@owner,':')"/>
										</xsl:if>
										<xsl:if test="$classLink != ''">
											<a href="{$classLink}">
												<xsl:value-of select="substring-after(./@owner,':')"/>
											</a>
										</xsl:if>
									</xsl:when>
									<xsl:when test="ancestor::apiClassifier">
										<xsl:value-of select="ancestor::apiClassifier/apiName"/>
									</xsl:when>
								</xsl:choose>
							</td>
						</tr>
					</xsl:for-each>
				</table>
			</div>
		</xsl:if>
	</xsl:template>
	<!-- SKINSTATE -->
	<xsl:template name="SkinStateSummary">
	<xsl:param name="classDeprecated" select="'false'"/>
	<xsl:param name="baseRef" select="''"/>
	<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
	<xsl:param name="interfaces" tunnel="yes"/>
	<xsl:variable name="SkinStateList">
	<xsl:for-each select="./prolog/asMetadata/skinStates/SkinState">
	<xsl:value-of select="concat(' ',@name,' ')"/>
	</xsl:for-each>
	</xsl:variable>
	<xsl:variable name="hasSkinState" select="count(./prolog/asMetadata[skinStates/SkinState]) &gt; 0"/>
	<xsl:variable name="ancestorNodes">
	<ancestors>
	<xsl:call-template name="getInheritedSkinState">
	  <xsl:with-param name="baseClass" select="./apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
	  <xsl:with-param name="currentPackage" select="$currentPackage"/>
	  <xsl:with-param name="SkinStateList" select="$SkinStateList"/>
	</xsl:call-template>
	</ancestors>
	<xsl:for-each select="$interfaces/interface">
	<xsl:call-template name="getInheritedSkinState">
	  <xsl:with-param name="baseClass" select="."/>
	  <xsl:with-param name="currentPackage" select="$currentPackage"/>
	  <xsl:with-param name="SkinStateList" select="$SkinStateList"/>
	  <xsl:with-param name="processParentClass" select="false()"/>
	</xsl:call-template>
	</xsl:for-each>
	</xsl:variable>
	<xsl:variable name="hasInherited" select="count($ancestorNodes/ancestors/SkinState) &gt; 0"/>
	<xsl:if test="$hasSkinState or $hasInherited">
	<a name="SkinStateSummary"/>
	<div class="summarySection">
	<div class="summaryTableTitle">
	  <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'SkinStates']]/entry[2]/p"/>
	</div>
	<p><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'skinstateprefixed']]/entry[2]/p"/></p>
	<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
	<!-- Start: Bug#2259590 Shinde Date: 13.03.09 Adding a link to the doc -->
	<xsl:if test="$isSkin!=''">
	  <div class="showHideLinks">
	    <a href="{$isSkin}" target="_blank">
	      <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'howtouseskins']]/entry[2]/p"/>
	    </a>
	  </div>
	</xsl:if>
	<!-- End: Bug#2259590 Shinde Date: 13.03.09 Adding a link to the doc -->
	<xsl:if test="$hasInherited">
	  <div class="showHideLinks">
	    <div id="hideInheritedSkinState" class="hideInheritedSkinState">
	      <a class="showHideLink" href="#SkinStateSummary" onclick="javascript:setInheritedVisible(false,'SkinState');">
		<img class="showHideLinkImage" src="{$baseRef}images/expanded.gif"/>
		<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'HideInheritedSkinStates']]/entry[2]/p"/>
	      </a>
	    </div>
	    <div id="showInheritedSkinState" class="showInheritedSkinState">
	      <a class="showHideLink" href="#SkinStateSummary" onclick="javascript:setInheritedVisible(true,'SkinState');">
		<img class="showHideLinkImage" src="{$baseRef}images/collapsed.gif"/>
		<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ShowInheritedSkinStates']]/entry[2]/p"/>
	      </a>
	    </div>
	  </div>
	</xsl:if>
	<xsl:variable name="tableSkinState">
	  <xsl:if test="$hasInherited and not($hasSkinState)">
	    <xsl:text>hideInheritedSkinState</xsl:text>
	  </xsl:if>
	</xsl:variable>
	<table cellspacing="0" cellpadding="3" class="summaryTable {$tableSkinState}" id="summaryTableSkinState">
	  <tr>
	    <th>
	      <xsl:value-of select="$nbsp"/>
	    </th>
	    <th colspan="2">
	      <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'SkinState']]/entry[2]/p"/>
	    </th>
	    <th>
	      <xsl:call-template name="getLocalizedString">
		<xsl:with-param name="key">Description</xsl:with-param>
	      </xsl:call-template>
	    </th>
	    <th>
	      <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DefinedBy']]/entry[2]/p"/>
	    </th>
	  </tr>
	  <xsl:for-each select="./prolog/asMetadata/skinStates/SkinState | $ancestorNodes/ancestors/SkinState">
	    <xsl:sort select="@name" order="ascending" data-type="text" lang="en-US"/>
	    <xsl:variable name="sequence" select="ancestor::apiClassifierDetail/apiClassifierDef"/>
	    <xsl:variable name="apihtml" select="concat(ancestor::apiClassifier/apiName,'.html')"/>
	    <xsl:variable name="destination" select="./@owner"/>
	    <xsl:variable name="rowStyle">
	      <xsl:if test="ancestor::ancestors">
		<xsl:text>hideInheritedskinState</xsl:text>
	      </xsl:if>
	    </xsl:variable>
	    <tr class="{$rowStyle}">
	      <td class="summaryTablePaddingCol">
		<xsl:if test="not(ancestor::ancestors)">
		  <a name="skinstate:{@name}"/>
		</xsl:if>
		<xsl:value-of select="$nbsp"/>
	      </td>
	      <td class="summaryTableInheritanceCol">
		<xsl:if test="ancestor::ancestors">
		  <img src="{$baseRef}images/inheritedSummary.gif" alt="Inherited" title="Inherited" class="inheritedSummaryImage"/>
		</xsl:if>
		<xsl:if test="not(ancestor::ancestors)">
		  <xsl:value-of select="$nbsp"/>
		</xsl:if>
	      </td>
	      <td class="summaryTableSignatureCol">
		<div class="summarySignature">
		  <xsl:choose>
		    <xsl:when test="ancestor::ancestors">
		      <xsl:variable name="destination" select="./@owner"/>
		      <xsl:variable name="h1" select="substring-after($destination,':')"/>
		      <xsl:variable name="h2" select="substring-before($destination,':')"/>
		      <xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
		      <xsl:variable name="gfile" select="concat($baseRef,replace($destination, ':', '/'),'.html')"/>
		      <xsl:variable name="hyperLink">
			<xsl:if test="contains($destination,'.')">
			  <xsl:value-of select="$file"/>
			</xsl:if>
			<xsl:if test="not(contains($destination,'.'))">
			  <xsl:value-of select="$gfile"/>
			</xsl:if>
		      </xsl:variable>
		      <xsl:if test="$hyperLink = ''">
			<xsl:value-of select="@name"/>
		      </xsl:if>
		      <xsl:if test="$hyperLink != ''">
			<a href="{$hyperLink}#skinstate:{@name}" class="signatureLink">
			  <xsl:value-of select="@name"/>
			</a>
		      </xsl:if>
		    </xsl:when>
		    <xsl:when test="ancestor::apiClassifier">
		      <span class="signatureLink">
			<xsl:value-of select="@name"/>
		      </span>
		    </xsl:when>
		  </xsl:choose>
		</div>
	      </td>
	      <td class="summaryTableDescription">
		<xsl:if test="not(ancestor::ancestors)">
		  <xsl:call-template name="deTilda">
		    <xsl:with-param name="inText" select="description/."/>
		  </xsl:call-template>
		</xsl:if>
		<xsl:if test="ancestor::ancestors">
		  <xsl:call-template name="deTilda">
		    <xsl:with-param name="inText" select="description/."/>
		  </xsl:call-template>
		</xsl:if>
		<xsl:call-template name="sees">
			<xsl:with-param name="currentPackage" select="$currentPackage"/>
		</xsl:call-template>
	      </td>
	      <td class="summaryTableOwnerCol">
		<xsl:choose>
		  <xsl:when test="ancestor::ancestors">
		    <xsl:variable name="destination" select="./@owner"/>
		    <xsl:variable name="h1" select="substring-after($destination,':')"/>
		    <xsl:variable name="h2" select="substring-before($destination,':')"/>
		    <xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
		    <xsl:variable name="gfile" select="concat($baseRef,replace($destination, ':', '/'),'.html')"/>
		    <xsl:variable name="classLink">
		      <xsl:if test="contains($destination,'.')">
			<xsl:value-of select="$file"/>
		      </xsl:if>
		      <xsl:if test="not(contains($destination,'.'))">
			<xsl:value-of select="$gfile"/>
		      </xsl:if>
		    </xsl:variable>
		    <xsl:if test="$classLink = ''">
		      <xsl:value-of select="substring-after(./@owner,':')"/>
		    </xsl:if>
		    <xsl:if test="$classLink != ''">
		      <a href="{$classLink}">
			<xsl:value-of select="substring-after(./@owner,':')"/>
		      </a>
		    </xsl:if>
		  </xsl:when>
		  <xsl:when test="ancestor::apiClassifier">
		    <xsl:value-of select="ancestor::apiClassifier/apiName"/>
		  </xsl:when>
		</xsl:choose>
	      </td>
	    </tr>
	  </xsl:for-each>
	</table>
	</div>
	</xsl:if>
	</xsl:template>
	<!-- SKIN PART -->
	<xsl:template name="SkinPartSummary">
	<xsl:param name="classDeprecated" select="'false'"/>
	<xsl:param name="baseRef" select="''"/>
	<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
	<xsl:param name="interfaces" tunnel="yes"/>
	<xsl:variable name="SkinPartList">
	<xsl:for-each select="prolog/asMetadata/styles/style">
	<xsl:value-of select="concat(' ',@name,' ')"/>
	</xsl:for-each>
	</xsl:variable>
	<xsl:variable name="hasSkinPart" select="count(./prolog/asMetadata[skinParts/SkinPart]) &gt; 0"/>
	<xsl:variable name="ancestorNodes">
	<ancestors>
	<xsl:call-template name="getInheritedSkinPart">
	  <xsl:with-param name="baseClass" select="./apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
	  <xsl:with-param name="currentPackage" select="$currentPackage"/>
	  <xsl:with-param name="SkinPartList" select="$SkinPartList"/>
	</xsl:call-template>
	</ancestors>
	<xsl:for-each select="$interfaces/interface">
	<xsl:call-template name="getInheritedSkinPart">
	  <xsl:with-param name="baseClass" select="."/>
	  <xsl:with-param name="currentPackage" select="$currentPackage"/>
	  <xsl:with-param name="SkinPartList" select="$SkinPartList"/>
	  <xsl:with-param name="processParentClass" select="false()"/>
	</xsl:call-template>
	</xsl:for-each>
	</xsl:variable>
	<xsl:variable name="hasInherited" select="count($ancestorNodes/ancestors/SkinPart) &gt; 0"/>
	<xsl:if test="$hasSkinPart or $hasInherited">
	<a name="SkinPartSummary"/>
	<div class="summarySection">
	<div class="summaryTableTitle">
	  <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'SkinParts']]/entry[2]/p"/>
	</div>
	<p><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'skinpartprefixed']]/entry[2]/p"/></p>
	<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
	<!-- Start: Bug#2259590 Shinde Date: 13.03.09 Adding a link to the doc -->
	<xsl:if test="$isSkin!=''">
	  <div class="showHideLinks">
	    <a href="{$isSkin}" target="_blank">
	      <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'howtouseskins']]/entry[2]/p"/>
	    </a>
	  </div>
	</xsl:if>
	<!-- End: Bug#2259590 Shinde Date: 13.03.09 Adding a link to the doc -->
	<xsl:if test="$hasInherited">
	  <div class="showHideLinks">
	    <div id="hideInheritedSkinPart" class="hideInheritedSkinPart">
	      <a class="showHideLink" href="#SkinPartSummary" onclick="javascript:setInheritedVisible(false,'SkinPart');">
		<img class="showHideLinkImage" src="{$baseRef}images/expanded.gif"/>
		<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'HideInheritedSkinParts']]/entry[2]/p"/>
	      </a>
	    </div>
	    <div id="showInheritedSkinPart" class="showInheritedSkinPart">
	      <a class="showHideLink" href="#SkinPartSummary" onclick="javascript:setInheritedVisible(true,'SkinPart');">
		<img class="showHideLinkImage" src="{$baseRef}images/collapsed.gif"/>
		<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ShowInheritedSkinParts']]/entry[2]/p"/>
	      </a>
	    </div>
	  </div>
	</xsl:if>
	<xsl:variable name="tableStyle">
	  <xsl:if test="$hasInherited and not($hasSkinPart)">
	    <xsl:text>hideInheritedSkinPart</xsl:text>
	  </xsl:if>
	</xsl:variable>
	<table cellspacing="0" cellpadding="3" class="summaryTable {$tableStyle}" id="summaryTableSkinPart">
	  <tr>
	    <th>
	      <xsl:value-of select="$nbsp"/>
	    </th>
	    <th colspan="2">
	      <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'SkinPart']]/entry[2]/p"/>
	    </th>
	    <th>
	      <xsl:call-template name="getLocalizedString">
		<xsl:with-param name="key">Description</xsl:with-param>
	      </xsl:call-template>
	    </th>
	    <th>
	      <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DefinedBy']]/entry[2]/p"/>
	    </th>
	  </tr>
	  <xsl:for-each select="./prolog/asMetadata/skinParts/SkinPart | $ancestorNodes/ancestors/SkinPart">
	    <xsl:sort select="@name" order="ascending" data-type="text" lang="en-US"/>
	    <xsl:variable name="sequence" select="ancestor::apiClassifierDetail/apiClassifierDef"/>
	    <xsl:variable name="apihtml" select="concat(ancestor::apiClassifier/apiName,'.html')"/>
	    <xsl:variable name="destination" select="./@owner"/>
	    <xsl:variable name="rowStyle">
	      <xsl:if test="ancestor::ancestors">
		<xsl:text>hideInheritedSkinPart</xsl:text>
	      </xsl:if>
	    </xsl:variable>
	    <tr class="{$rowStyle}">
	      <td class="summaryTablePaddingCol">
		<xsl:if test="not(ancestor::ancestors)">
		  <a name="skinpart:{@name}"/>
		</xsl:if>
		<xsl:value-of select="$nbsp"/>
	      </td>
	      <td class="summaryTableInheritanceCol">
		<xsl:if test="ancestor::ancestors">
		  <img src="{$baseRef}images/inheritedSummary.gif" alt="Inherited" title="Inherited" class="inheritedSummaryImage"/>
		</xsl:if>
		<xsl:if test="not(ancestor::ancestors)">
		  <xsl:value-of select="$nbsp"/>
		</xsl:if>
	      </td>
	      <td class="summaryTableSignatureCol">
		<div class="summarySignature">
			
		  <xsl:choose>
		    <xsl:when test="ancestor::ancestors">
		      <xsl:variable name="destination" select="./@owner"/>
		      <xsl:variable name="h1" select="substring-after($destination,':')"/>
		      <xsl:variable name="h2" select="substring-before($destination,':')"/>
		      <xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
		      <xsl:variable name="gfile" select="concat($baseRef,replace($destination, ':', '/'),'.html')"/>
		      <xsl:variable name="hyperLink">
			<xsl:if test="contains($destination,'.')">
			  <xsl:value-of select="$file"/>
			</xsl:if>
			<xsl:if test="not(contains($destination,'.'))">
			  <xsl:value-of select="$gfile"/>
			</xsl:if>
		      </xsl:variable>
		      <xsl:if test="$hyperLink = ''">
			<xsl:value-of select="@name"/>
		      </xsl:if>
		      <xsl:if test="$hyperLink != ''">
			<a href="{$hyperLink}#skinpart:{@name}" class="signatureLink">
			  <xsl:value-of select="@name"/>
			</a>
		      </xsl:if>
		    </xsl:when>
		    <xsl:when test="ancestor::apiClassifier">
		      <span class="signatureLink">
			<xsl:value-of select="@name"/>
		      </span>
		    </xsl:when>
		  </xsl:choose>
		  <xsl:if test="@var_type">
		    <xsl:text>:</xsl:text>
		    <xsl:variable name="destination" select="./@var_type"/>
		    <xsl:variable name="h1" select="substring-after($destination,':')"/>
		    <xsl:variable name="h2" select="substring-before($destination,':')"/>
		    <xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
		    <xsl:variable name="gfile" select="replace(concat($baseRef, $destination, '.html'), ':', '/')"/>
		    <xsl:variable name="hyperLink">
		      <xsl:if test="contains($destination,'.')">
			<xsl:value-of select="$file"/>
		      </xsl:if>
		      <xsl:if test="not(contains($destination,'.'))">
			<xsl:value-of select="$gfile"/>
		      </xsl:if>
		    </xsl:variable>

		    <xsl:if test="count($classHeader_map//apiClassifier[@id=$destination] ) &gt; 0">
				<xsl:if test="$hyperLink = ''">
					<xsl:if test="not(contains($destination,':'))">
						<xsl:value-of select="$destination"/>
					</xsl:if>
					<xsl:if test="contains($destination,':')">
						<xsl:value-of select="concat($h2,concat('.',$h1))"/>
					</xsl:if>
				</xsl:if>
				<xsl:if test="$hyperLink != ''">
					<a href="{$hyperLink}" class="signatureLink">
						<xsl:value-of select="$h1"/>
		      		</a>
				</xsl:if>
		      </xsl:if>
		      <xsl:if test="not(count($classHeader_map//apiClassifier[@id=$destination] ) &gt; 0)">
					<xsl:if test="not(contains($destination,':'))">
						<xsl:value-of select="$destination"/>
					</xsl:if>
					<xsl:if test="contains($destination,':')">
						<xsl:value-of select="concat($h2,concat('.',$h1))"/>
					</xsl:if>
		      </xsl:if>
		  </xsl:if>
		</div>
	      </td>
	      <td class="summaryTableDescription">
		<xsl:if test="string-length(normalize-space(@required)) &gt; 0">
		  <span class="label">
		    <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Required']]/entry[2]/p"/>: </span>
		  <xsl:value-of select="normalize-space(@required)"/>
		</xsl:if>
		<xsl:text disable-output-escaping="yes"><![CDATA[&nbsp;]]></xsl:text>
		<xsl:if test="not(@type)">
		  <span class="label">
		    <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PartType']]/entry[2]/p"/>: </span>
		  <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Static']]/entry[2]/p"/>
		</xsl:if>
		<xsl:if test="@type!=''">
		  <span class="label">
		    <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PartType']]/entry[2]/p"/>: </span>
		  <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Dynamic']]/entry[2]/p"/>
		</xsl:if>
		<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
		<xsl:if test="not(ancestor::ancestors)">
		  <xsl:call-template name="deTilda">
		    <xsl:with-param name="inText" select="description/."/>
		  </xsl:call-template>
		</xsl:if>
		<xsl:if test="ancestor::ancestors">
		  <xsl:call-template name="deTilda">
		    <xsl:with-param name="inText" select="description/."/>
		  </xsl:call-template>
		</xsl:if>
		<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
		<xsl:if test="@type!=''">
		    <xsl:variable name="hyperlink">
		      <xsl:call-template name="styleTypeHyperlink">
			<xsl:with-param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
			<xsl:with-param name="type" select="@type"/>
		      </xsl:call-template>
		    </xsl:variable>
		  <xsl:variable name="propdesc">
		    <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'dynpropdesc']]/entry[2]/p"/>
		  </xsl:variable>
		  <xsl:variable name="destination" select="./@var_type"/>
		  <xsl:variable name="var_type" select="substring-after($destination,':')"/>
		  <xsl:variable name="type.value" select="replace($propdesc,'%type%',$var_type)"/>
		  
		  <xsl:variable name="full.type" select="replace(@type, ':', '.')"/>
		  <xsl:if test="replace(@var_type, ':', '.')!=$full.type">
			  <xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
			  <xsl:value-of select="$type.value"/><xsl:text disable-output-escaping="yes"><![CDATA[&nbsp;]]></xsl:text>
			  
			   <xsl:variable name="display.type" >
					<xsl:call-template name="substring-after-last">
						<xsl:with-param name="input" select="$full.type"/>
						<xsl:with-param name="substr" select="'.'"/>
					</xsl:call-template>
				</xsl:variable >
							
				<xsl:if test="count($classHeader_map//apiClassifier[@id=@type] ) &gt; 0">
					<a href="{$hyperlink}">
						<xsl:value-of select="$display.type"/>
					</a>
				</xsl:if>
				<xsl:if test="not(count($classHeader_map//apiClassifier[@id=@type] ) &gt; 0)">
					<xsl:value-of select="$display.type"/>
				</xsl:if>
		  </xsl:if>
		</xsl:if>
			<xsl:call-template name="sees">
				<xsl:with-param name="currentPackage" select="$currentPackage"/>
			</xsl:call-template>
	      </td>
	      <td class="summaryTableOwnerCol">
		<xsl:choose>
		  <xsl:when test="ancestor::ancestors">
		    <xsl:variable name="destination" select="./@owner"/>
		    <xsl:variable name="h1" select="substring-after($destination,':')"/>
		    <xsl:variable name="h2" select="substring-before($destination,':')"/>
		    <xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
		    <xsl:variable name="gfile" select="concat($baseRef,$destination,'.html')"/>
		    <xsl:variable name="classLink">
		      <xsl:if test="contains($destination,'.')">
			<xsl:value-of select="$file"/>
		      </xsl:if>
		      <xsl:if test="not(contains($destination,'.'))">
			<xsl:value-of select="$gfile"/>
		      </xsl:if>
		    </xsl:variable>
		    <xsl:if test="$classLink = ''">
		      <xsl:value-of select="substring-after(./@owner,':')"/>
		    </xsl:if>
		    <xsl:if test="$classLink != ''">
		      <a href="{$classLink}">
			<xsl:value-of select="substring-after(./@owner,':')"/>
		      </a>
		    </xsl:if>
		  </xsl:when>
		  <xsl:when test="ancestor::apiClassifier">
		    <xsl:value-of select="ancestor::apiClassifier/apiName"/>
		  </xsl:when>
		</xsl:choose>
	      </td>
	    </tr>
	  </xsl:for-each>
	</table>
	</div>
	</xsl:if>
	</xsl:template>	
	<!-- EFFECTS -->
	<xsl:template name="effectsSummary">
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="baseRef" select="''"/>
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:param name="interfaces" tunnel="yes"/>
		<xsl:variable name="ancestorexcludes">
			<excludes>
				<xsl:variable name="self" select="@id"/>
				<xsl:for-each select="$classHeader_map//apiClassifier[@id = $self]//Excludes/Exclude[@kind='effect']">
					<xsl:copy-of select="."/>
				</xsl:for-each>
			</excludes>
		</xsl:variable>
		<!--List of effects to suppress when creating inheritance list.  Includes both the existing effects and any exclusions-->
		<xsl:variable name="effectsList">
			<xsl:for-each select="prolog/asMetadata/effects/effect">
				<xsl:text> </xsl:text>
				<xsl:value-of select="@name"/>
				<xsl:text> </xsl:text>
			</xsl:for-each>
			<xsl:for-each select="$ancestorexcludes/excludes/Exclude">
				<xsl:text> </xsl:text>
				<xsl:value-of select="@name"/>
				<xsl:text> </xsl:text>
			</xsl:for-each>
		</xsl:variable>
		<xsl:variable name="hasEffects" select="count(prolog/asMetadata/effects/effect) &gt; 0"/>
		<xsl:variable name="ancestorNodes">
			<ancestors>
				<xsl:call-template name="getInheritedEffect">
					<xsl:with-param name="baseClass" select="./apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
					<xsl:with-param name="currentPackage" select="$currentPackage"/>
					<xsl:with-param name="effectsList" select="$effectsList"/>
				</xsl:call-template>
				<xsl:for-each select="$interfaces/interface">
					<xsl:call-template name="getInheritedEffect">
						<xsl:with-param name="baseClass" select="."/>
						<xsl:with-param name="currentPackage" select="$currentPackage"/>
						<xsl:with-param name="effectsList" select="$effectsList"/>
						<xsl:with-param name="processParentClass" select="false()"/>
					</xsl:call-template>
				</xsl:for-each>
			</ancestors>
		</xsl:variable>
		<xsl:variable name="hasInherited" select="count($ancestorNodes/ancestors/effect ) &gt; 0"/>
		<xsl:if test="$hasEffects or $hasInherited">
			<a name="effectSummary"/>
			<div class="summarySection">
				<div class="summaryTableTitle">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Effects']]/entry[2]/p"/>
				</div>
				<xsl:if test="$hasInherited">
					<div class="showHideLinks">
						<div id="hideInheritedEffect" class="hideInheritedEffect">
							<a class="showHideLink" href="#effectSummary" onclick="javascript:setInheritedVisible(false,'Effect');">
								<img class="showHideLinkImage" src="{$baseRef}images/expanded.gif"/>
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'HideInheritedEffects']]/entry[2]/p"/>
							</a>
						</div>
						<div id="showInheritedEffect" class="showInheritedEffect">
							<a class="showHideLink" href="#effectSummary" onclick="javascript:setInheritedVisible(true,'Effect');">
								<img class="showHideLinkImage" src="{$baseRef}images/collapsed.gif"/>
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ShowInheritedEffects']]/entry[2]/p"/>
							</a>
						</div>
					</div>
				</xsl:if>
				<xsl:variable name="tableStyle">
					<xsl:if test="$hasInherited and not($hasEffects)">
						<xsl:text>hideInheritedEffect</xsl:text>
					</xsl:if>
				</xsl:variable>
				<table cellspacing="0" cellpadding="3" class="summaryTable {$tableStyle}" id="summaryTableEffect">
					<tr>
						<th>
							<xsl:value-of select="$nbsp"/>
						</th>
						<th colspan="2">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Effect']]/entry[2]/p"/>
						</th>
						<th>
							<xsl:call-template name="getLocalizedString">
								<xsl:with-param name="key">Description</xsl:with-param>
							</xsl:call-template>
						</th>
						<th class="summaryTableOwnerCol">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DefinedBy']]/entry[2]/p"/>
						</th>
					</tr>
					<xsl:for-each select="prolog/asMetadata/effects/effect | $ancestorNodes/ancestors/effect">
						<xsl:sort select="@name" order="ascending" data-type="text" lang="en-US"/>
						<xsl:variable name="owner" select="@owner"/>
						<xsl:variable name="ancestorPath" select="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef"/>
						<xsl:variable name="rowStyle">
							<xsl:if test="ancestor::ancestors">
								<xsl:text>hideInheritedEffect</xsl:text>
							</xsl:if>
						</xsl:variable>
						<tr class="{$rowStyle}">
							<td class="summaryTablePaddingCol">
								<xsl:if test="not(ancestor::ancestors)">
									<a name="effect:{@name}"/>
								</xsl:if>
								<xsl:value-of select="$nbsp"/>
							</td>
							<td class="summaryTableInheritanceCol">
								<xsl:if test="ancestor::ancestors">
									<img src="{$baseRef}images/inheritedSummary.gif" alt="Inherited" title="Inherited" class="inheritedSummaryImage"/>
								</xsl:if>
								<xsl:if test="not(ancestor::ancestors)">
									<xsl:value-of select="$nbsp"/>
								</xsl:if>
							</td>
							<xsl:variable name="classLink">
								<xsl:variable name="id" select="$owner"/>
								<xsl:variable name="destination" select="$owner"/>
								<xsl:variable name="h1">
									<xsl:if test="contains($destination,'.')">
										<xsl:value-of select="substring-before($destination,':')"/>
									</xsl:if>
									<xsl:if test="not(contains($destination,'.'))">
										<xsl:value-of select="$destination"/>
									</xsl:if>
								</xsl:variable>
								<xsl:variable name="h2">
									<xsl:if test="contains($destination,'.')">
										<xsl:value-of select="substring-after($destination,':')"/>
									</xsl:if>
									<xsl:if test="not(contains($destination,'.'))">
										<xsl:value-of select="$destination"/>
									</xsl:if>
								</xsl:variable>
								<xsl:variable name="file" select="concat($baseRef,translate($h1,'.','/'),'/',$h2,'.html')"/>
								<xsl:variable name="gfile" select="concat($baseRef,$h2,'.html')"/>
								<xsl:if test="contains($id,'.')">
									<xsl:value-of select="$file"/>
								</xsl:if>
								<xsl:if test="not(contains($id,'.'))">
									<xsl:value-of select="$gfile"/>
								</xsl:if>
							</xsl:variable>
							<td class="summaryTableSignatureCol">
								<div class="summarySignature">
									<xsl:choose>
										<xsl:when test="ancestor::ancestors">
											<a href="{$classLink}#effect:{@name}" class="signatureLink">
												<xsl:value-of select="@name"/>
											</a>
										</xsl:when>
										<xsl:when test="ancestor::apiClassifier">
											<span class="signatureLink">
												<xsl:value-of select="@name"/>
											</span>
										</xsl:when>
									</xsl:choose>
								</div>
							</td>
							<td class="summaryTableDescription">
								<xsl:if test="string-length(@event)">
									<span class="label">
										<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TriggeringEvent']]/entry[2]/p"/>: </span>
									<xsl:variable name="event" select="@event"/>
									<xsl:choose>
										<xsl:when test="ancestor::apiClassifier/prolog/asMetadata/apiAdobeEvent/event[@name=$event]">
											<a href="#event:{@event}">
												<xsl:value-of select="@event"/>
											</a>
										</xsl:when>
										<xsl:when test="ancestor::asClass/asAncestors/asAncestor/eventsGenerated/event[@name=$event]">
											<a href="{ancestor::asClass/asAncestors/asAncestor[eventsGenerated/event/@name=$event]/classRef/@relativePath}#event:{@event}">
												<xsl:value-of select="@event"/>
											</a>
										</xsl:when>
										<xsl:otherwise>
											<xsl:value-of select="@event"/>
										</xsl:otherwise>
									</xsl:choose>
									<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
								</xsl:if>
								<xsl:variable name="owner" select="$owner"/>
								<xsl:variable name="baseRef" select="$baseRef"/>
								<xsl:variable name="packageName" select="$currentPackage"/>
								<xsl:if test="@deprecatedReplacement or @deprecatedMessage">
									<span class="label">
										<xsl:choose>
											<xsl:when test="@deprecatedSince!=''">
												<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DeprecatedSince']]/entry[2]/p"/>
												<xsl:text> </xsl:text>
												<xsl:value-of select="@deprecatedSince"/>
												<xsl:if test="@deprecatedReplacement!=''">
													<xsl:text>: </xsl:text>
												</xsl:if>
											</xsl:when>
											<xsl:otherwise>
												<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Deprecated']]/entry[2]/p"/>
												<xsl:if test="@deprecatedReplacement!=''">
													<xsl:text>:</xsl:text>
													<xsl:text> </xsl:text>
												</xsl:if>
											</xsl:otherwise>
										</xsl:choose>
									</span>
									<xsl:choose>
										<xsl:when test="@deprecatedReplacement!=''">
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PleaseUse']]/entry[2]/p"/>
											<xsl:text> </xsl:text>
											<xsl:variable name="hyperlink">
												<xsl:variable name="destination" select="$owner"/>
												<xsl:variable name="h1" select="substring-after($destination,':')"/>
												<xsl:variable name="h2" select="substring-before($destination,':')"/>
												<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
												<xsl:variable name="gfile" select="concat($baseRef,translate($destination,':','/'),'.html')"/>
												<xsl:if test="contains($destination,'.')">
													<xsl:value-of select="$file"/>
												</xsl:if>
												<xsl:if test="not(contains($destination,'.'))">
													<xsl:value-of select="$gfile"/>
												</xsl:if>
											</xsl:variable>
											<xsl:if test="contains(@deprecatedReplacement,',')">
												<xsl:for-each select="tokenize(@deprecatedReplacement,',')">
													<xsl:variable name="spec" select="normalize-space(.)"/>
													<xsl:variable name="tospec">
														<xsl:if test="contains($spec, ':')">
															<xsl:value-of select="substring-after($spec,':')"/>
														</xsl:if>
														<xsl:if test="not(contains($spec, ':'))">
															<xsl:value-of select="$spec"/>
														</xsl:if>
													</xsl:variable>
													<xsl:variable name="linkpath1">
														<xsl:call-template name="getDeprecatedReplacementLink">
															<xsl:with-param name="replacement" select="$tospec"/>
															<xsl:with-param name="currentPackage" select="$packageName"/>
															<!--<xsl:with-param name="ancestorPath" select="$ancestorPath"/>-->
														</xsl:call-template>
													</xsl:variable>
													<A href="{$hyperlink}{$linkpath1}">
														<xsl:value-of select="$spec"/>
													</A>
													<xsl:if test="position() != last()">
														<xsl:text>, </xsl:text>
													</xsl:if>
												</xsl:for-each>
											</xsl:if>
											<xsl:variable name="linkpath">
												<xsl:call-template name="getDeprecatedReplacementLink">
													<xsl:with-param name="replacement" select="@deprecatedReplacement/."/>
													<xsl:with-param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
													<xsl:with-param name="anchorPrefix" select="concat(local-name(),':')"/>
												</xsl:call-template>
											</xsl:variable>
											<xsl:if test="not(contains(@deprecatedReplacement,','))">
												<xsl:choose>
													<xsl:when test="ancestor::ancestors">
														<A href="{$hyperlink}{$linkpath}">
															<xsl:value-of select="@deprecatedReplacement/."/>
														</A>
													</xsl:when>
													<xsl:otherwise>
														<A href="{$linkpath}">
															<xsl:value-of select="@deprecatedReplacement/."/>
														</A>
													</xsl:otherwise>
												</xsl:choose>
											</xsl:if>
										</xsl:when>
										<xsl:when test="@deprecatedMessage!=''">
											<xsl:variable name="description">
												<apiDesc>
													<xsl:value-of select="@deprecatedMessage/."/>
												</apiDesc>
											</xsl:variable>
											<xsl:for-each select="$description/apiDesc">
												<xsl:call-template name="processTags"/>
											</xsl:for-each>
										</xsl:when>
									</xsl:choose>
									<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
								</xsl:if>
								<xsl:if test="not(ancestor::ancestors)">
									<xsl:call-template name="deTilda">
										<xsl:with-param name="inText" select="description/."/>
									</xsl:call-template>
								</xsl:if>
								<xsl:if test="ancestor::ancestors">
									<xsl:call-template name="deTilda">
										<xsl:with-param name="inText" select="description/."/>
									</xsl:call-template>
								</xsl:if>
							</td>
							<td class="summaryTableOwnerCol">
								<xsl:choose>
									<xsl:when test="ancestor::ancestors">
										<xsl:variable name="classLink">
											<xsl:variable name="id" select="$owner"/>
											<xsl:variable name="destination" select="$owner"/>
											<xsl:variable name="h1">
												<xsl:if test="contains($destination,'.')">
													<xsl:value-of select="substring-before($destination,':')"/>
												</xsl:if>
												<xsl:if test="not(contains($destination,'.'))">
													<xsl:value-of select="$destination"/>
												</xsl:if>
											</xsl:variable>
											<xsl:variable name="h2">
												<xsl:if test="contains($destination,'.')">
													<xsl:value-of select="substring-after($destination,':')"/>
												</xsl:if>
												<xsl:if test="not(contains($destination,'.'))">
													<xsl:value-of select="$destination"/>
												</xsl:if>
											</xsl:variable>
											<xsl:variable name="file" select="concat($baseRef,translate($h1,'.','/'),'/',$h2,'.html')"/>
											<xsl:variable name="gfile" select="concat($baseRef,$h2,'.html')"/>
											<xsl:if test="contains($id,'.')">
												<xsl:value-of select="$file"/>
											</xsl:if>
											<xsl:if test="not(contains($id,'.'))">
												<xsl:value-of select="$gfile"/>
											</xsl:if>
										</xsl:variable>
										<xsl:variable name="className">
											<xsl:variable name="cn" select="$owner"/>
											<xsl:value-of select="substring-after($cn,':')"/>
										</xsl:variable>
										<a href="{$classLink}">
											<xsl:value-of select="$className"/>
										</a>
									</xsl:when>
									<xsl:when test="ancestor::apiClassifier">
										<xsl:value-of select="ancestor::apiClassifier/apiName"/>
									</xsl:when>
								</xsl:choose>
							</td>
						</tr>
					</xsl:for-each>
				</table>
			</div>
		</xsl:if>
	</xsl:template>
	<!-- EVENTS -->
	<xsl:template name="eventsGeneratedSummary">
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="baseRef" select="''"/>
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:param name="interfaces" tunnel="yes"/>
		<xsl:variable name="ancestorexcludes">
			<excludes>
				<xsl:variable name="self" select="@id"/>
				<xsl:for-each select="$classHeader_map//apiClassifier[@id = $self]//Excludes/Exclude[@kind='event']">
					<xsl:copy-of select="."/>
				</xsl:for-each>
			</excludes>
		</xsl:variable>
		<!--List of events to suppress when creating inheritance list.  Includes both the existing events and any exclusions-->
		<xsl:variable name="eventsList">
			<xsl:for-each select="adobeApiEvent[not(adobeApiEventDetail/adobeApiEventDef/apiDefinedEvent)]">
				<xsl:text> </xsl:text>
				<xsl:value-of select="./apiName"/>
				<xsl:text> </xsl:text>
			</xsl:for-each>
			<xsl:for-each select="$ancestorexcludes/excludes/Exclude">
				<xsl:text> </xsl:text>
				<xsl:value-of select="@name"/>
				<xsl:text> </xsl:text>
			</xsl:for-each>
		</xsl:variable>
		<xsl:variable name="hasEvents" select="count(adobeApiEvent[not(adobeApiEventDetail/adobeApiEventDef/apiDefinedEvent)]) &gt; 0"/>
		<xsl:variable name="ancestorNodes">
			<ancestors>
				<xsl:call-template name="getInheritedEvent">
					<xsl:with-param name="baseClass" select="./apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
					<xsl:with-param name="currentPackage" select="$currentPackage"/>
					<xsl:with-param name="eventsList" select="$eventsList"/>
				</xsl:call-template>
			</ancestors>
			<xsl:for-each select="$interfaces/interface">
				<xsl:call-template name="getInheritedEvent">
					<xsl:with-param name="baseClass" select="."/>
					<xsl:with-param name="currentPackage" select="$currentPackage"/>
					<xsl:with-param name="eventsList" select="$eventsList"/>
					<xsl:with-param name="processParentClass" select="false()"/>
				</xsl:call-template>
			</xsl:for-each>
		</xsl:variable>
		<xsl:variable name="hasInherited" select="count($ancestorNodes/ancestors/adobeApiEvent[not(adobeApiEventDetail/adobeApiEventDef/apiDefinedEvent)]) &gt; 0"/>
		<xsl:if test="$hasEvents or $hasInherited">
			<a name="eventSummary"/>
			<div class="summarySection">
				<div class="summaryTableTitle">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Events']]/entry[2]/p"/>
				</div>
				<xsl:if test="$hasInherited">
					<div class="showHideLinks">
						<div id="hideInheritedEvent" class="hideInheritedEvent">
							<a class="showHideLink" href="#eventSummary" onclick="javascript:setInheritedVisible(false,'Event');">
								<img class="showHideLinkImage" src="{$baseRef}images/expanded.gif"/>
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'HideInheritedEvents']]/entry[2]/p"/>
							</a>
						</div>
						<div id="showInheritedEvent" class="showInheritedEvent">
							<a class="showHideLink" href="#eventSummary" onclick="javascript:setInheritedVisible(true,'Event');">
								<img class="showHideLinkImage" src="{$baseRef}images/collapsed.gif"/>
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ShowInheritedEvents']]/entry[2]/p"/>
							</a>
						</div>
					</div>
				</xsl:if>
				<xsl:variable name="tableStyle">
					<xsl:if test="$hasInherited and not($hasEvents)">
						<xsl:text>hideInheritedEvent</xsl:text>
					</xsl:if>
				</xsl:variable>
				<table cellspacing="0" cellpadding="3" class="summaryTable {$tableStyle}" id="summaryTableEvent">
					<tr>
						<th>
							<xsl:value-of select="$nbsp"/>
						</th>
						<th colspan="2">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Event']]/entry[2]/p"/>
						</th>
						<th>
							<xsl:call-template name="getLocalizedString">
								<xsl:with-param name="key">Summary</xsl:with-param>
							</xsl:call-template>
						</th>
						<th class="summaryTableOwnerCol">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DefinedBy']]/entry[2]/p"/>
						</th>
					</tr>
					<xsl:for-each select="adobeApiEvent[not(adobeApiEventDetail/adobeApiEventDef/apiDefinedEvent)] | $ancestorNodes/ancestors/adobeApiEvent[not(adobeApiEventDetail/adobeApiEventDef/apiDefinedEvent)] ">
						<xsl:sort select="apiName" order="ascending" data-type="text" lang="en-US"/>
						<xsl:variable name="name" select="./apiName"/>
						<xsl:if test="./adobeApiEventDetail/adobeApiEventDef/apiEventType or ./shortdesc">
							<xsl:variable name="rowStyle">
								<xsl:if test="ancestor::ancestors">
									<xsl:text>hideInheritedEvent</xsl:text>
								</xsl:if>
							</xsl:variable>
							<tr class="{$rowStyle}">
								<td class="summaryTablePaddingCol">
									<xsl:value-of select="$nbsp"/>
								</td>
								<td class="summaryTableInheritanceCol">
									<xsl:if test="ancestor::ancestors">
										<img src="{$baseRef}images/inheritedSummary.gif" alt="Inherited" title="Inherited" class="inheritedSummaryImage"/>
									</xsl:if>
									<xsl:if test="not(ancestor::ancestors)">
										<xsl:value-of select="$nbsp"/>
									</xsl:if>
								</td>
								<td class="summaryTableSignatureCol">
									<div class="summarySignature">
										<xsl:choose>
											<xsl:when test="ancestor::ancestors">
												<xsl:variable name="hyperLink">
													<xsl:variable name="id" select="./@id"/>
													<xsl:variable name="text" select="substring-before($id,'_')"/>
													<xsl:variable name="cName" select="substring-after($text,':')"/>
													<xsl:variable name="pName" select="substring-before($text,':')"/>
													<xsl:variable name="destination" select="concat($pName,':',$cName)"/>
													<xsl:variable name="className">
														<xsl:if test="contains($destination,':')">
															<xsl:choose>
																<xsl:when test="$prog_language_name='javascript'"/>
																<xsl:otherwise>
																	<xsl:value-of select="substring-after($destination,':')"/>
																</xsl:otherwise>
															</xsl:choose>
														</xsl:if>
														<xsl:if test="not(contains($destination,':'))">
															<xsl:if test="not(contains($destination,'.'))">
																<xsl:choose>
																	<xsl:when test="$prog_language_name='javascript'"/>
																	<xsl:otherwise>
																		<xsl:value-of select="$destination"/>
																	</xsl:otherwise>
																</xsl:choose>
															</xsl:if>
														</xsl:if>
													</xsl:variable>
													<xsl:variable name="packageName">
														<xsl:if test="contains($destination,':')">
															<xsl:value-of select="substring-before($destination,':')"/>
														</xsl:if>
														<xsl:if test="not(contains($destination,':'))">
															<xsl:value-of select="$destination"/>
														</xsl:if>
													</xsl:variable>
													<xsl:variable name="file" select="concat($baseRef,translate($packageName,'.','/'),'/',$className,'.html')"/>
													<xsl:variable name="gfile" select="concat($baseRef,$className,'.html')"/>
													<xsl:if test="string-length($packageName) &gt; 0">
														<xsl:choose>
															<xsl:when test="$prog_language_name='javascript'"/>
															<xsl:otherwise>
																<xsl:value-of select="$file"/>
															</xsl:otherwise>
														</xsl:choose>
													</xsl:if>
													<xsl:if test="not(string-length($packageName) &gt; 0 )">
														<xsl:choose>
															<xsl:when test="$prog_language_name='javascript'"/>
															<xsl:otherwise>
																<xsl:value-of select="$gfile"/>
															</xsl:otherwise>
														</xsl:choose>
													</xsl:if>
												</xsl:variable>
												<xsl:choose>
													<xsl:when test="$prog_language_name='javascript'"/>
													<xsl:otherwise>
														<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
															<xsl:call-template name="insertAIRIcon">
																<xsl:with-param name="baseRef" select="$baseRef"/>
															</xsl:call-template>
															<xsl:value-of select="$nbsp"/>
														</xsl:if>
													</xsl:otherwise>
												</xsl:choose>
												<xsl:if test="$hyperLink!=''">
													<a href="{$hyperLink}#event:{apiName}" class="signatureLink">
														<xsl:value-of select="apiName"/>
													</a>
												</xsl:if>
												<xsl:if test="$hyperLink=''">
													<xsl:value-of select="apiName"/>
												</xsl:if>
											</xsl:when>
											<xsl:when test="ancestor::apiClassifier">
												<xsl:choose>
													<xsl:when test="$prog_language_name='javascript'"/>
													<xsl:otherwise>
														<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
															<xsl:call-template name="insertAIRIcon">
																<xsl:with-param name="baseRef" select="$baseRef"/>
															</xsl:call-template>
															<xsl:value-of select="$nbsp"/>
														</xsl:if>
													</xsl:otherwise>
												</xsl:choose>
												<a href="#event:{$name}" class="signatureLink">
													<xsl:value-of select="$name"/>
												</a>
											</xsl:when>
										</xsl:choose>
										<!-- TODO add param classRefs for AS2 -->
										<xsl:if test="$config/options/@docversion='2'">
											<xsl:text> = function(</xsl:text>
											<xsl:call-template name="params"/>
											<xsl:text>) {}</xsl:text>
										</xsl:if>
									</div>
								</td>
								<td class="summaryTableDescription summaryTableCol">
									<xsl:if test="$classDeprecated='true'">
										<xsl:copy-of select="$deprecatedLabel"/>
										<xsl:text>. </xsl:text>
									</xsl:if>
									<xsl:variable name="eventText">
										<xsl:value-of select="normalize-space(./shortdesc)"/>
										<xsl:if test="./shortdesc/@conref">
											<xsl:call-template name="getConRefText">
												<xsl:with-param name="conref" select="./shortdesc/@conref"/>
												<xsl:with-param name="descriptionType" select="local-name(./shortdesc)"/>
												<xsl:with-param name="entryType" select="'event'"/>
												<xsl:with-param name="currentPackage" select="$currentPackage"/>
											</xsl:call-template>
										</xsl:if>
									</xsl:variable>
									<xsl:if test="string-length($eventText) &gt;0 ">
										<xsl:call-template name="deTilda">
											<xsl:with-param name="inText" select="$eventText"/>
										</xsl:call-template>
									</xsl:if>
									<xsl:if test="not(string-length($eventText) &gt; 0)">

										<xsl:if test="./adobeApiEventDetail/adobeApiEventDef/adobeApiEventClassifier">
											<xsl:call-template name="getEventDescription">
												<xsl:with-param name="destination" select="adobeApiEventDetail/adobeApiEventDef/apiEventType"/>
												<xsl:with-param name="descriptionType" select="local-name(./shortdesc)"/>
											</xsl:call-template>
										</xsl:if>
									</xsl:if>
								</td>
								<td class="summaryTableOwnerCol">
									<xsl:choose>
										<xsl:when test="ancestor::ancestors">
											<xsl:variable name="hyperLink">
												<xsl:variable name="id" select="./@id"/>
												<xsl:variable name="text" select="substring-before($id,'_')"/>
												<xsl:variable name="className" select="substring-after($text,':')"/>
												<xsl:variable name="packageName" select="substring-before($text,':')"/>
												<xsl:variable name="destination" select="concat($packageName,':',$className)"/>
												<xsl:variable name="h1" select="substring-before($destination,':')"/>
												<xsl:variable name="h2" select="substring-after($destination,':')"/>
												<xsl:variable name="file" select="concat($baseRef,translate($h1,'.','/'),'/',$h2,'.html')"/>
												<xsl:variable name="gfile" select="concat($baseRef,$h2,'.html')"/>
												<xsl:if test="contains($destination,'.')">
													<xsl:choose>
														<xsl:when test="$prog_language_name='javascript'"/>
														<xsl:otherwise>
															<xsl:value-of select="$file"/>
														</xsl:otherwise>
													</xsl:choose>
												</xsl:if>
												<xsl:if test="not(contains($destination,'.'))">
													<xsl:choose>
														<xsl:when test="$prog_language_name='javascript'"/>
														<xsl:otherwise>
															<xsl:value-of select="$gfile"/>
														</xsl:otherwise>
													</xsl:choose>
												</xsl:if>
											</xsl:variable>
											<xsl:variable name="className">
												<xsl:call-template name="getEventClassNameFromId">
													<xsl:with-param name="id" select="./@id"/>
													<xsl:with-param name="currentPackage" select="$currentPackage"/>
												</xsl:call-template>
											</xsl:variable>
											<xsl:if test="$hyperLink!=''">
												<a href="{$hyperLink}">
													<xsl:value-of select="$className"/>
												</a>
											</xsl:if>
											<xsl:if test="$hyperLink=''">
												<xsl:value-of select="$className"/>
											</xsl:if>
										</xsl:when>
										<xsl:when test="ancestor::apiClassifier">
											<xsl:value-of select="ancestor::apiClassifier/apiName"/>
										</xsl:when>
									</xsl:choose>
								</td>
							</tr>
						</xsl:if>
					</xsl:for-each>
				</table>
			</div>
		</xsl:if>
	</xsl:template>
	<xsl:template name="eventDetails">
		<xsl:param name="baseRef"/>
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:if test="count(adobeApiEvent[not(adobeApiEventDetail/adobeApiEventDef/apiDefinedEvent)]) &gt; 0">
			<div class="detailSectionHeader">
				<xsl:call-template name="getLocalizedString">
					<xsl:with-param name="key" select="'EventDetail'"/>
				</xsl:call-template>
			</div>
			<xsl:for-each select="./adobeApiEvent[not(adobeApiEventDetail/adobeApiEventDef/apiDefinedEvent)]">
				<xsl:sort select="apiName" order="ascending" lang="en-US"/>
				<xsl:variable name="name" select="./apiName"/>
				<a name="event:{$name}"/>
				<table class="detailHeader" cellpadding="0" cellspacing="0">
					<tr>
						<td class="detailHeaderName">
							<xsl:choose>
								<xsl:when test="$prog_language_name='javascript'"/>
								<xsl:otherwise>
									<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
										<xsl:call-template name="insertAIRIcon">
											<xsl:with-param name="baseRef" select="$baseRef"/>
										</xsl:call-template>
										<xsl:value-of select="$nbsp"/>
									</xsl:if>
								</xsl:otherwise>
							</xsl:choose>
							<xsl:value-of select="$name"/>
						</td>
						<td class="detailHeaderType">
							<xsl:call-template name="getLocalizedString">
								<xsl:with-param name="key">EventIn</xsl:with-param>
							</xsl:call-template>
						</td>
						<xsl:if test="position()!=1">
							<td class="detailHeaderRule">
								<xsl:value-of select="$nbsp"/>
							</td>
						</xsl:if>
					</tr>
				</table>
				<div class="detailBody">
					<xsl:if test="string-length(normalize-space(adobeApiEventDetail/adobeApiEventDef/adobeApiEventClassifier)) &gt; 0">
						<xsl:if test="$name='onCuePoint' or $name='onMetaData'"> </xsl:if>
						<span class="label">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'EventObjectType']]/entry[2]/p"/>
							<xsl:text>: </xsl:text>
						</span>
						<xsl:variable name="eventHyperLink">
							<xsl:call-template name="getEventHyperlink">
								<xsl:with-param name="destination" select="adobeApiEventDetail/adobeApiEventDef/adobeApiEventClassifier"/>
								<xsl:with-param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
							</xsl:call-template>
						</xsl:variable>
						<xsl:variable name="eventTypeClassifierTmp" select="adobeApiEventDetail/adobeApiEventDef/adobeApiEventClassifier"/>

						<xsl:variable name="eventTypeClassifierPkg" >
							<xsl:call-template name="substring-before-last">
								<xsl:with-param name="input" select="$eventTypeClassifierTmp"/>
								<xsl:with-param name="substr" select="'.'"/>
							</xsl:call-template>
						</xsl:variable >

						<xsl:variable name="eventTypeClassifierCls" >
							<xsl:call-template name="substring-after-last">
								<xsl:with-param name="input" select="$eventTypeClassifierTmp"/>
								<xsl:with-param name="substr" select="'.'"/>
							</xsl:call-template>
						</xsl:variable >

						<xsl:variable name="eventTypeClassifier" select="concat($eventTypeClassifierPkg, ':', $eventTypeClassifierCls)"/>

						<xsl:choose>
							<xsl:when test="$eventHyperLink=''">
								<code>
									<xsl:value-of select="adobeApiEventDetail/adobeApiEventDef/adobeApiEventClassifier"/>
								</code>
							</xsl:when>
							<xsl:otherwise>
								<a href="{$eventHyperLink}">
									<code>
										<xsl:value-of select="$eventTypeClassifierTmp"/>
									</code>
								</a>
							</xsl:otherwise>
						</xsl:choose>
						<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
						<xsl:variable name="eventTypeDITA" select="adobeApiEventDetail/adobeApiEventDef/apiEventType"/>
						<xsl:if test="string-length($eventTypeDITA) &gt; 0">
							<xsl:variable name="eventTypeHref">
								<xsl:call-template name="getEventTypeHyperlink">
									<xsl:with-param name="destination" select="$eventTypeDITA"/>
									<xsl:with-param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
								</xsl:call-template>
							</xsl:variable>
							<span class="label">

								<xsl:if test="contains($eventTypeClassifierTmp,'.')">
									<xsl:call-template name="substring-after-last">
										<xsl:with-param name="input" select="$eventTypeClassifierTmp"/>
										<xsl:with-param name="substr" select="'.'"/>
									</xsl:call-template>
								</xsl:if>
								<xsl:if test="not(contains($eventTypeClassifierTmp,'.'))">
									<xsl:value-of select="$eventTypeClassifierTmp"/>
								</xsl:if>
								<xsl:text>.type</xsl:text>
								<xsl:text> </xsl:text>
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Property']]/entry[2]/p"/>
								<xsl:text> = </xsl:text>
							</span>
							<xsl:choose>
								<xsl:when test="$eventTypeHref=''">
									<code>
										<xsl:value-of select="$eventTypeDITA"/>
									</code>
								</xsl:when>
								<xsl:otherwise>

									<xsl:if test="contains($eventTypeClassifierTmp,'.')">
										<xsl:if test="count($classHeader_map//apiClassifier[@id=$eventTypeClassifier] ) &gt; 0">
											<a href="{$eventTypeHref}">
												<code>
													<xsl:value-of select="$eventTypeDITA"/>
												</code>
											</a>
										</xsl:if>
										<xsl:if test="not(count($classHeader_map//apiClassifier[@id=$eventTypeClassifier] ) &gt; 0)">
											<code>
												<xsl:value-of select="$eventTypeDITA"/>
											</code>
										</xsl:if>
									</xsl:if>

									<xsl:if test="not(contains($eventTypeClassifierTmp,'.'))">
										<xsl:if test="count($classHeader_map//apiClassifier[@id=concat('globalClassifier:',$eventTypeClassifierTmp)] ) &gt; 0">
											<a href="{$eventTypeHref}">
												<code>
													<xsl:value-of select="$eventTypeDITA"/>
												</code>
											</a>
										</xsl:if>
										<xsl:if test="not(count($classHeader_map//apiClassifier[@id=concat('globalClassifier:',$eventTypeClassifierTmp)] ) &gt; 0)">
											<code>
												<xsl:value-of select="$eventTypeDITA"/>
											</code>
										</xsl:if>
									</xsl:if>
								</xsl:otherwise>
							</xsl:choose>
							<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
						</xsl:if>
						<xsl:if test="not(string-length($eventTypeDITA) &gt; 0)">
							<p/>
						</xsl:if>
					</xsl:if>
					<xsl:if test="$config/options/@docversion='2'">
						<p>
							<code>
								<xsl:text>public </xsl:text>
								<xsl:value-of select="$name"/>
								<xsl:text> = function(</xsl:text>
								<xsl:call-template name="params"/>
								<xsl:text>) {}</xsl:text>
							</code>
						</p>
					</xsl:if>
					<xsl:apply-templates select="adobeApiEventDetail/adobeApiEventDef/apiDeprecated" mode="event" />
					<xsl:if test="$classDeprecated='true'">
						<xsl:call-template name="description">
							<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
							<xsl:with-param name="addParagraphTags" select="true()"/>
						</xsl:call-template>
					</xsl:if>
					<xsl:call-template name="version"/>
					<xsl:if test="$classDeprecated!='true'">
						<xsl:call-template name="description">
							<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
							<xsl:with-param name="addParagraphTags" select="true()"/>
						</xsl:call-template>
					</xsl:if>
					<xsl:if test="string-length(normalize-space(adobeApiEventDetail/adobeApiEventDef/adobeApiEventClassifier)) &gt; 0">
						<xsl:call-template name="getEventDescription">
							<xsl:with-param name="destination" select="adobeApiEventDetail/adobeApiEventDef/apiEventType"/>
							<xsl:with-param name="descriptionType" select="'apiDesc'"/>
						</xsl:call-template>
					</xsl:if>
					<xsl:apply-templates select="params"/>
					<xsl:if test="./*/example[codeblock]">
						<xsl:call-template name="includeExamples">
							<xsl:with-param name="createExampleLink" select="'false'"/>
						</xsl:call-template>
					</xsl:if>
					<xsl:call-template name="sees"/>
				</div>
			</xsl:for-each>
		</xsl:if>
	</xsl:template>
	<xsl:template name="event">
		<xsl:variable name="packageName" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:variable name="baseRef">
			<xsl:call-template name="getBaseRef">
				<xsl:with-param name="packageName" select="$packageName"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:if test="count(adobeApiEvent)">
			<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
			<span class="label">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Events']]/entry[2]/p"/>
			</span>
			<table cellpadding="0" cellspacing="0" border="0">
				<xsl:for-each select="adobeApiEvent">
					<tr>
						<td width="20px"/>
						<td>
							<code>
								<b>
									<xsl:if test="$config/options/@docversion='2'">
										<a href="#event:{apiName}">
											<xsl:value-of select="apiName"/>
										</a>
									</xsl:if>
									<xsl:if test="$config/options/@docversion!='2'">
										<xsl:value-of select="apiName"/>
									</xsl:if>
								</b>
								<xsl:if test="adobeApiEventDetail/adobeApiEventDef/adobeApiEventClassifier">
									<xsl:variable name="destination" select="adobeApiEventDetail/adobeApiEventDef/adobeApiEventClassifier"/>
									<xsl:variable name="h1" select="substring-after($destination,':')"/>
									<xsl:variable name="h2" select="substring-before($destination,':')"/>
									<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
									<xsl:variable name="gfile" select="concat($baseRef,$destination,'.html')"/>
									<xsl:variable name="eventHyperLink">
										<xsl:if test="contains($destination,'.')">
											<xsl:value-of select="$file"/>
										</xsl:if>
										<xsl:if test="not(contains($destination,'.'))">
											<xsl:value-of select="$gfile"/>
										</xsl:if>
									</xsl:variable>
									<xsl:variable name="classname">
										<xsl:if test="contains(adobeApiEventDetail/adobeApiEventDef/adobeApiEventClassifier,':')">
											<xsl:value-of select="substring-after(adobeApiEventDetail/adobeApiEventDef/adobeApiEventClassifier,':')"/>
										</xsl:if>
										<xsl:if test="not(contains(adobeApiEventDetail/adobeApiEventDef/adobeApiEventClassifier,':'))">
											<xsl:value-of select="adobeApiEventDetail/adobeApiEventDef/adobeApiEventClassifier"/>
										</xsl:if>
									</xsl:variable>
									<xsl:text>:</xsl:text>
									<xsl:if test="$eventHyperLink = ''">
										<code>
											<xsl:value-of select="$classname"/>
										</code>
									</xsl:if>
									<xsl:if test="$eventHyperLink != ''">
										<a href="{$eventHyperLink}">
											<code>
												<xsl:value-of select="$classname"/>
											</code>
										</a>
									</xsl:if>
								</xsl:if>
							</code>
							<xsl:if test="string-length(adobeApiEventDetail/apiDesc)">
								<xsl:value-of select="$emdash"/>
								<xsl:variable name="desctext">
									<xsl:for-each select="./adobeApiEventDetail/apiDesc">
										<xsl:call-template name="processTags">
											<xsl:with-param name="event" select="'eventdesc'"/>
										</xsl:call-template>
									</xsl:for-each>
								</xsl:variable>
								<xsl:value-of disable-output-escaping="yes" select="$desctext"/>
							</xsl:if>
						</td>
					</tr>
					<xsl:if test="position()!=last()">
						<tr>
							<td class="paramSpacer">
								<xsl:value-of select="$nbsp"/>
							</td>
						</tr>
					</xsl:if>
				</xsl:for-each>
			</table>
		</xsl:if>
	</xsl:template>
	<!-- METHODS -->
	<xsl:template name="methodSummary">
		<xsl:param name="className"/>
		<xsl:param name="title" select="'Methods'"/>
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="accessLevel" select="'public'"/>
		<xsl:param name="baseRef" select="''"/>
		<xsl:param name="isGlobal" select="false()"/>
		<xsl:param name="showAnchor" select="true()"/>
		<xsl:param name="interfaces" tunnel="yes"/>
		<xsl:variable name="localizedTitle">
			<xsl:call-template name="getLocalizedString">
				<xsl:with-param name="key">
					<xsl:value-of select="$title"/>
				</xsl:with-param>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:variable name="hasMethods"
			select="count(apiOperation[apiOperationDetail/apiOperationDef/apiAccess/@value=$accessLevel or apiOperationDetail/apiOperationDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.]) &gt; 0 or count(apiConstructor[apiConstructorDetail/apiConstructorDef/apiAccess/@value=$accessLevel or apiConstructorDetail/apiConstructorDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.]) &gt; 0"/>
		<xsl:variable name="ancestorexcludes">
			<excludes>
				<xsl:variable name="self" select="@id"/>
				<xsl:for-each select="$classHeader_map//apiClassifier[@id = $self]//Excludes/Exclude[@kind='method']">
					<xsl:copy-of select="."/>
				</xsl:for-each>
			</excludes>
		</xsl:variable>
		<!--List of methods to suppress when creating inheritance list.  Includes both the existing methods and any exclusions-->
		<xsl:variable name="newMethodList">
			<xsl:for-each
				select="./apiOperation[apiOperationDetail/apiOperationDef/apiAccess/@value=$accessLevel or apiOperationDetail/apiOperationDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.] | ./apiConstructor[apiConstructorDetail/apiConstructorDef/apiAccess/@value=$accessLevel or apiConstructorDetail/apiConstructorDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.]">
				<xsl:text> </xsl:text>
				<xsl:value-of select="./apiName"/>
				<xsl:text> </xsl:text>
			</xsl:for-each>
			<xsl:for-each select="$ancestorexcludes/excludes/Exclude">
				<xsl:text> </xsl:text>
				<xsl:value-of select="@name"/>
				<xsl:text> </xsl:text>
			</xsl:for-each>
		</xsl:variable>
		<xsl:variable name="ancestorNode">
			<ancestors>
				<xsl:call-template name="getMethodAncestors">
					<xsl:with-param name="baseRef" select="$baseRef"/>
					<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
					<xsl:with-param name="methodList" select="$newMethodList"/>
					<xsl:with-param name="baseClass" select="./apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
					<xsl:with-param name="accessLevel" select="$accessLevel"/>
				</xsl:call-template>
				<xsl:for-each select="$interfaces/interface">
					<xsl:call-template name="getMethodAncestors">
						<xsl:with-param name="baseRef" select="$baseRef"/>
						<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
						<xsl:with-param name="methodList" select="$newMethodList"/>
						<xsl:with-param name="baseClass" select="."/>
						<xsl:with-param name="accessLevel" select="$accessLevel"/>
						<xsl:with-param name="processParentClass" select="false()"/>
					</xsl:call-template>
				</xsl:for-each>
			</ancestors>
		</xsl:variable>
		<xsl:variable name="hasInherited" select="count ($ancestorNode/ancestors/apiOperation | $ancestorNode/ancestors/apiConstructor) &gt; 0"/>
		<xsl:if test="$hasMethods or $hasInherited">
			<xsl:if test="$showAnchor">
				<xsl:if test="$accessLevel='public'">
					<a name="methodSummary"/>
				</xsl:if>
				<xsl:if test="$accessLevel='protected'">
					<xsl:if
						test="not(count(apiOperation[./apiOperationDetail/apiOperationDef/apiAccess/@value='public' or ./apiOperationDetail/apiOperationDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay='public']/.]) &gt; 0 or count($ancestorNode/ancestors/apiOperation[./apiOperationDetail/apiOperationDef/apiAccess/@value='public' or ./apiOperationDetail/apiOperationDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay='public']/.]) &gt; 0)">
						<a name="methodSummary"/>
					</xsl:if>
					<a name="protectedMethodSummary"/>
				</xsl:if>
			</xsl:if>
			<div class="summarySection">
				<div class="summaryTableTitle">
					<xsl:choose>
						<xsl:when test="$isGlobal">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalMethods']]/entry[2]/p"/>
							<xsl:text> </xsl:text>
						</xsl:when>
						<xsl:when test="$accessLevel='public'">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PublicMethods']]/entry[2]/p"/>
							<xsl:text> </xsl:text>
						</xsl:when>
						<xsl:when test="$accessLevel='protected'">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ProtectedMethods']]/entry[2]/p"/>
							<xsl:text> </xsl:text>
						</xsl:when>
					</xsl:choose>

				</div>
				<xsl:if test="$hasInherited">
					<div class="showHideLinks">
						<xsl:if test="$accessLevel!='protected'">
							<div id="hideInheritedMethod" class="hideInheritedMethod">
								<a class="showHideLink" href="#methodSummary" onclick="javascript:setInheritedVisible(false,'Method');">
									<img class="showHideLinkImage" src="{$baseRef}images/expanded.gif"/>
									<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'HideInheritedPublicMethods']]/entry[2]/p"/>
								</a>
							</div>
							<div id="showInheritedMethod" class="showInheritedMethod">
								<a class="showHideLink" href="#methodSummary" onclick="javascript:setInheritedVisible(true,'Method');">
									<img class="showHideLinkImage" src="{$baseRef}images/collapsed.gif"/>
									<xsl:choose>
										<xsl:when test="$prog_language_name='javascript'"/>
										<xsl:otherwise>
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ShowInheritedPublicMethods']]/entry[2]/p"/>
										</xsl:otherwise>
									</xsl:choose>

								</a>
							</div>
						</xsl:if>
						<xsl:if test="$accessLevel='protected'">
							<div id="hideInheritedProtectedMethod" class="hideInheritedProtectedMethod">
								<a class="showHideLink" href="#protectedMethodSummary" onclick="javascript:setInheritedVisible(false,'ProtectedMethod');">
									<img class="showHideLinkImage" src="{$baseRef}images/expanded.gif"/>
									<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ShowInheritedProtectedMethods']]/entry[2]/p"/>
								</a>
							</div>
							<div id="showInheritedProtectedMethod" class="showInheritedProtectedMethod">
								<a class="showHideLink" href="#protectedMethodSummary" onclick="javascript:setInheritedVisible(true,'ProtectedMethod');">
									<img class="showHideLinkImage" src="{$baseRef}images/collapsed.gif"/>
									<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ShowInheritedProtectedMethods']]/entry[2]/p"/>
								</a>
							</div>
						</xsl:if>
					</div>
				</xsl:if>
				<xsl:variable name="tableStyle">
					<xsl:if test="$hasInherited and not($hasMethods)">
						<xsl:text>hideInherited</xsl:text>
						<xsl:if test="$accessLevel='protected'">
							<xsl:text>Protected</xsl:text>
						</xsl:if>
						<xsl:text>Method</xsl:text>
					</xsl:if>
				</xsl:variable>
				<xsl:variable name="tableId">
					<xsl:text>summaryTable</xsl:text>
					<xsl:if test="$accessLevel='protected'">
						<xsl:text>Protected</xsl:text>
					</xsl:if>
					<xsl:text>Method</xsl:text>
				</xsl:variable>
				<table cellspacing="0" cellpadding="3" class="summaryTable {$tableStyle}" id="{$tableId}">
					<tr>
						<th>
							<xsl:value-of select="$nbsp"/>
						</th>
						<th colspan="2">
							<xsl:if test="self::apiClassifier">
								<xsl:text/>
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'MethodMethod']]/entry[2]/p"/>
							</xsl:if>
							<xsl:if test="not(self::apiClassifier)">
								<xsl:text/>
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'FunctionFunction']]/entry[2]/p"/>
							</xsl:if>
						</th>
						<xsl:if test="not($config/options/@docversion='2')">
							<th class="summaryTableOwnerCol">
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DefinedBy']]/entry[2]/p"/>
							</th>
						</xsl:if>
					</tr>
					<xsl:apply-templates
						select="apiOperation[apiOperationDetail/apiOperationDef/apiAccess/@value=$accessLevel or apiOperationDetail/apiOperationDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.] | apiConstructor[apiConstructorDetail/apiConstructorDef/apiAccess/@value=$accessLevel or apiConstructorDetail/apiConstructorDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.] | $ancestorNode/ancestors/apiOperation[apiOperationDetail/apiOperationDef/apiAccess/@value=$accessLevel or apiOperationDetail/apiOperationDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.] | $ancestorNode/ancestors/apiConstructor[apiConstructorDetail/apiConstructorDef/apiAccess/@value=$accessLevel or apiConstructorDetail/apiConstructorDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.]"
						mode="summary">
						<xsl:sort select="local-name()" lang="en-US"/>
						<xsl:sort select="apiName" order="ascending" lang="en-US"/>
						<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
						<xsl:with-param name="baseRef" select="$baseRef"/>
						<xsl:with-param name="accessLevel" select="$accessLevel"/>
						<xsl:with-param name="currentPackage" select="$currentPackage"/>
					</xsl:apply-templates>
				</table>
				<!-- AS2 INHERITED METHODS -->
				<xsl:if test="$config/options/@docversion='2'">
					<xsl:for-each select="asAncestors/asAncestor">
						<xsl:call-template name="inherited">
							<xsl:with-param name="lowerType" select="'methods'"/>
							<xsl:with-param name="upperType" select="'Methods'"/>
							<xsl:with-param name="inheritedItems" select="@methods"/>
							<xsl:with-param name="staticItems" select="@staticMethods"/>
							<xsl:with-param name="postfix" select="'()'"/>
						</xsl:call-template>
					</xsl:for-each>
				</xsl:if>
			</div>
		</xsl:if>
	</xsl:template>
	<xsl:template name="methodsDetails">
		<xsl:param name="className"/>
		<xsl:param name="title" select="$asdoc_terms/row[entry[1][p/text() = 'MethodDetail']]/entry[2]/p"/>
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="baseRef"/>
		<xsl:param name="constructCall" select="'true'"/>
		<xsl:if test="count(.//apiOperation) &gt; 0">
			<a name="methodDetail"/>
			<div class="detailSectionHeader">
				<xsl:value-of select="$title"/>
			</div>
			<xsl:apply-templates select="apiOperation" mode="detail">
				<xsl:sort select="./apiName" order="ascending" lang="en-US"/>
				<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
				<xsl:with-param name="isMethod" select="$className!='package'"/>
				<xsl:with-param name="className" select="$className"/>
				<xsl:with-param name="baseRef" select="$baseRef"/>
			</xsl:apply-templates>
			<xsl:if test="$constructCall='true'">
				<xsl:apply-templates select="apiConstructor" mode="detail">
					<xsl:sort select="./apiName" order="ascending" lang="en-US"/>
					<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
					<xsl:with-param name="isMethod" select="$className!='package'"/>
					<xsl:with-param name="className" select="$className"/>
					<xsl:with-param name="baseRef" select="$baseRef"/>
				</xsl:apply-templates>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="constantDetails">
		<xsl:param name="title" select="$asdoc_terms/row[entry[1][p/text() = 'ConstantDetail']]/entry[2]/p"/>
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="baseRef"/>
		<xsl:param name="isConst" select="'true'"/>
		<xsl:if test="count(./apiValue[not(apiValueDetail/apiValueDef/apiProperty)]) &gt; 0">
			<div class="detailSectionHeader">
				<xsl:value-of select="$title"/>
			</div>
			<xsl:apply-templates select="apiValue[not(apiValueDetail/apiValueDef/apiProperty)]" mode="detail">
				<xsl:sort select="./apiName" order="ascending" lang="en-US"/>
				<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
				<xsl:with-param name="baseRef" select="$baseRef"/>
				<xsl:with-param name="isConst" select="$isConst"/>
			</xsl:apply-templates>
		</xsl:if>
	</xsl:template>
	<xsl:template name="propertyDetails">
		<xsl:param name="title" select="$asdoc_terms/row[entry[1][p/text() = 'PropertyDetail']]/entry[2]/p"/>
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="baseRef"/>
		<xsl:if test="count(./apiValue[apiValueDetail/apiValueDef/apiProperty]) &gt; 0">
			<div class="detailSectionHeader">
				<xsl:value-of select="$title"/>
			</div>
			<xsl:apply-templates select="apiValue[apiValueDetail/apiValueDef/apiProperty]" mode="detail">
				<xsl:sort select="./apiName" order="ascending" lang="en-US"/>
				<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
				<xsl:with-param name="baseRef" select="$baseRef"/>
			</xsl:apply-templates>
		</xsl:if>
	</xsl:template>
	<xsl:template name="styleDetails">
		<xsl:param name="title" select="$asdoc_terms/row[entry[1][p/text() = 'StyleDetail']]/entry[2]/p"/>
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="baseRef"/>
		<xsl:if test="count(prolog/asMetadata[styles/style]) &gt; 0">
			<div class="detailSectionHeader">
				<xsl:value-of select="$title"/>
			</div>
			<xsl:apply-templates select="prolog/asMetadata[styles/style]" mode="detail">
				<xsl:sort select="@name" order="ascending" lang="en-US"/>
				<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
				<xsl:with-param name="baseRef" select="$baseRef"/>
			</xsl:apply-templates>
		</xsl:if>
	</xsl:template>
	<xsl:template match="style" mode="detail">
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="isMethod" select="true()"/>
		<xsl:param name="className" select="''"/>
		<xsl:param name="baseRef"/>
		<xsl:variable name="name" select="@name"/>
		<xsl:variable name="type" select="@type"/>
		<a name="{$name}"/>
		<a name="style:{$name}"/>
		<table class="detailHeader" cellpadding="0" cellspacing="0">
			<tr>
				<td class="detailHeaderName">
					<xsl:choose>
						<xsl:when test="$prog_language_name='javascript'"/>
						<xsl:otherwise>
							<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
								<xsl:call-template name="insertAIRIcon">
									<xsl:with-param name="baseRef" select="$baseRef"/>
								</xsl:call-template>
								<xsl:value-of select="$nbsp"/>
							</xsl:if>
						</xsl:otherwise>
					</xsl:choose>
					<xsl:value-of select="$name"/>
				</td>
				<td class="detailHeaderType">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Style']]/entry[2]/p"/>
				</td>
				<xsl:if test="position()!=1">
					<td class="detailHeaderRule">
						<xsl:value-of select="$nbsp"/>
					</td>
				</xsl:if>
			</tr>
		</table>
		<div class="detailBody">
			<code>
				<xsl:value-of select="$name"/>
				<xsl:if test="@type">
					<xsl:text>:</xsl:text>
					<xsl:call-template name="getSimpleClassName">
						<xsl:with-param name="fullClassName" select="@type"/>
					</xsl:call-template>
				</xsl:if>
			</code>
			<xsl:if test="$classDeprecated!='true'">
				<xsl:call-template name="description">
					<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
					<xsl:with-param name="addParagraphTags" select="true()"/>
				</xsl:call-template>
			</xsl:if>
			<xsl:if test="./default">
				<p>
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DefaultValueIs']]/entry[2]/p"/>
					<xsl:text> </xsl:text>
					<code>
						<xsl:value-of select="normalize-space(./default/.)"/>
					</code>
					<xsl:text>.</xsl:text>
				</p>
			</xsl:if>
			<xsl:call-template name="sees"/>
		</div>
	</xsl:template>
	<xsl:template match="apiOperation | apiConstructor" mode="summary">
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="baseRef" select="''"/>
		<xsl:param name="accessLevel" select="'public'"/>
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:variable name="rowStyle">
			<xsl:if test="ancestor::ancestors">
				<xsl:text>hideInherited</xsl:text>
				<xsl:if test="$accessLevel='protected'">
					<xsl:text>Protected</xsl:text>
				</xsl:if>
				<xsl:text>Method</xsl:text>
			</xsl:if>
		</xsl:variable>
		<tr class="{$rowStyle}">
			<td class="summaryTablePaddingCol">
				<xsl:value-of select="$nbsp"/>
			</td>
			<td class="summaryTableInheritanceCol">
				<xsl:if test="ancestor::ancestors">
					<img src="{$baseRef}images/inheritedSummary.gif" alt="Inherited" title="Inherited" class="inheritedSummaryImage"/>
				</xsl:if>
				<xsl:if test="not(ancestor::ancestors)">
					<xsl:value-of select="$nbsp"/>
				</xsl:if>
			</td>
			<td class="summaryTableSignatureCol">
				<div class="summarySignature">
					<xsl:choose>
						<xsl:when test="ancestor::ancestors">
							<xsl:variable name="hLink">
								<xsl:variable name="memberName" select="./apiName"/>
								<xsl:variable name="id" select="./@id"/>
								<xsl:variable name="classNameText" select="substring-after($id,':')"/>
								<xsl:variable name="packageNameText" select="substring-before($id,':')"/>
								<xsl:variable name="h1" select="substring-before($classNameText,':')"/>
								<xsl:variable name="h2" select="$packageNameText"/>
								<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
								<xsl:variable name="gfile" select="concat($baseRef,$packageNameText,'.html')"/>
								<xsl:variable name="packageName">
									<xsl:choose>
										<xsl:when test="not(contains($packageNameText,'.')) and string-length($packageNameText) = 0">
											<xsl:value-of select="''"/>
										</xsl:when>
										<xsl:otherwise>
											<xsl:value-of select="$packageNameText"/>
										</xsl:otherwise>
									</xsl:choose>
								</xsl:variable>
								<xsl:variable name="methodName">
									<xsl:choose>
										<xsl:when test="$memberName != ''">
											<xsl:value-of select="$memberName"/>
										</xsl:when>
										<xsl:when test="contains($packageName,'.')">
											<xsl:if test="contains($classNameText,':')">
												<xsl:value-of select="substring-after($classNameText,':')"/>
											</xsl:if>
										</xsl:when>
										<xsl:otherwise>
											<xsl:value-of select="substring-after($id,':')"/>
										</xsl:otherwise>
									</xsl:choose>
								</xsl:variable>
								<xsl:if test="contains($id,'.') or string-length($packageNameText) &gt; 0">
									<xsl:choose>
										<xsl:when test="$prog_language_name='javascript'"/>
										<xsl:otherwise>
											<xsl:value-of select="$file"/>
											<xsl:text>#</xsl:text>
											<xsl:value-of select="$methodName"/>
										</xsl:otherwise>
									</xsl:choose>

								</xsl:if>
								<xsl:if test="not(contains($id,'.')) and string-length($packageNameText) = 0">
									<xsl:choose>
										<xsl:when test="$prog_language_name='javascript'"/>
										<xsl:otherwise>
											<xsl:value-of select="$gfile"/>
											<xsl:text>#</xsl:text>
											<xsl:value-of select="$methodName"/>
										</xsl:otherwise>
									</xsl:choose>
								</xsl:if>
							</xsl:variable>
							<xsl:choose>
								<xsl:when test="$prog_language_name='javascript'"/>
								<xsl:otherwise>
									<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
										<xsl:call-template name="insertAIRIcon">
											<xsl:with-param name="baseRef" select="$baseRef"/>
										</xsl:call-template>
										<xsl:value-of select="$nbsp"/>
									</xsl:if>
								</xsl:otherwise>
							</xsl:choose>
							<xsl:if test="$hLink!=''">
								<a href="{$hLink}()" class="signatureLink">
									<xsl:value-of select="./apiName"/>
								</a>
							</xsl:if>
							<xsl:if test="$hLink=''">
								<xsl:value-of select="./apiName"/>
							</xsl:if>
						</xsl:when>
						<xsl:when test="self::apiConstructor">
							<xsl:if test="position()>1">
								<a href="#{./apiName}{position()}()" class="signatureLink">
									<xsl:value-of select="./apiName"/>
								</a>
							</xsl:if>
							<xsl:if test="position()=1">
								<xsl:choose>
									<xsl:when test="$prog_language_name='javascript'"/>
									<xsl:otherwise>
										<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
											<xsl:call-template name="insertAIRIcon">
												<xsl:with-param name="baseRef" select="$baseRef"/>
											</xsl:call-template>
											<xsl:value-of select="$nbsp"/>
										</xsl:if>
									</xsl:otherwise>
								</xsl:choose>
								<a href="#{./apiName}()" class="signatureLink">
									<xsl:value-of select="./apiName"/>
								</a>
							</xsl:if>
						</xsl:when>
						<xsl:when test="ancestor::apiClassifier or ancestor-or-self::apiPackage">
							<xsl:choose>
								<xsl:when test="$prog_language_name='javascript'"/>
								<xsl:otherwise>
									<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
										<xsl:call-template name="insertAIRIcon">
											<xsl:with-param name="baseRef" select="$baseRef"/>
										</xsl:call-template>
										<xsl:value-of select="$nbsp"/>
									</xsl:if>
								</xsl:otherwise>
							</xsl:choose>
							<a href="#{./apiName}()" class="signatureLink">
								<xsl:value-of select="./apiName"/>
							</a>
						</xsl:when>
					</xsl:choose>
					<xsl:if test="self::apiOperation | self::apiConstructor">
						<xsl:text>(</xsl:text>
						<xsl:call-template name="params">
							<xsl:with-param name="currentPackage" select="$currentPackage"/>
						</xsl:call-template>
						<xsl:text>)</xsl:text>
						<xsl:if test="self::apiOperation and $prog_language_name='ActionScript'">
							<xsl:text>:</xsl:text>
							<xsl:call-template name="processReturnType">
								<xsl:with-param name="currentPackage" select="$currentPackage"/>
								<xsl:with-param name="baseRef" select="$baseRef"/>
							</xsl:call-template>
						</xsl:if>
					</xsl:if>
				</div>
				<div class="summaryTableDescription">
					<xsl:apply-templates select="apiOperationDetail/apiOperationDef/apiDeprecated"/>
					<xsl:apply-templates select="deprecated"/>
					  <xsl:if test="apiOperationDetail/apiOperationDef/apiIsOverride">
						<xsl:text>[</xsl:text>
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Override']]/entry[2]/p"/>
						<xsl:text>] </xsl:text>
					  </xsl:if>
					<xsl:if test="not(deprecated)">
						<xsl:if test="apiOperationDetail/apiOperationDef/apiStatic">
							<xsl:text>[</xsl:text>
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'static']]/entry[2]/p"/>
							<xsl:text>] </xsl:text>
						</xsl:if>
						<xsl:if test="./shortdesc or $classDeprecated='true'">
							<xsl:call-template name="shortDescriptionReview"/>
							<xsl:if test="$classDeprecated='true'">
								<xsl:copy-of select="$deprecatedLabel"/>
								<xsl:text>. </xsl:text>
							</xsl:if>
						</xsl:if>
						<xsl:if test="not(string-length(./shortdesc/@conref) &gt; 0)">
							<xsl:for-each select="./shortdesc">
								<xsl:call-template name="processTags"/>
							</xsl:for-each>
						</xsl:if>
					</xsl:if>
				</div>
			</td>
			<xsl:if test="not($config/options/@docversion='2')">
				<td class="summaryTableOwnerCol">
					<xsl:choose>
						<xsl:when test="ancestor::ancestors">
							<xsl:variable name="classLink">
								<xsl:variable name="id" select="./@id"/>
								<xsl:variable name="classNameText" select="substring-after($id,':')"/>
								<xsl:variable name="packageNameText" select="substring-before($id,':')"/>
								<xsl:variable name="h1" select="$packageNameText"/>
								<xsl:variable name="h2" select="substring-before($classNameText,':')"/>
								<xsl:variable name="file" select="concat($baseRef,translate($h1,'.','/'),'/',$h2,'.html')"/>
								<xsl:variable name="gfile" select="concat($baseRef,$packageNameText,'.html')"/>
								<xsl:if test="contains($id,'.') or string-length($packageNameText) &gt; 0">
									<xsl:choose>
										<xsl:when test="$prog_language_name='javascript'"/>
										<xsl:otherwise>
											<xsl:value-of select="$file"/>
										</xsl:otherwise>
									</xsl:choose>
								</xsl:if>
								<xsl:if test="not(contains($id,'.')) and string-length($packageNameText) = 0">
									<xsl:choose>
										<xsl:when test="$prog_language_name='javascript'"/>
										<xsl:otherwise>
											<xsl:value-of select="$gfile"/>
										</xsl:otherwise>
									</xsl:choose>
								</xsl:if>
							</xsl:variable>
							<xsl:variable name="className">
								<xsl:call-template name="getClassNameFromId">
									<xsl:with-param name="id" select="./@id"/>
								</xsl:call-template>
							</xsl:variable>
							<xsl:if test="$classLink!=''">
								<a href="{$classLink}">
									<xsl:value-of select="$className"/>
								</a>
							</xsl:if>
							<xsl:if test="$classLink=''">
								<xsl:value-of select="$className"/>
							</xsl:if>
						</xsl:when>
						<xsl:when test="ancestor::apiClassifier">
							<xsl:value-of select="ancestor::apiClassifier/apiName"/>
						</xsl:when>
						<xsl:when test="ancestor-or-self::apiPackage">
							<xsl:if test="ancestor-or-self::apiPackage/apiName='__Global__'">
								<xsl:value-of select="concat('Top',$nbsp,'Level')"/>
							</xsl:if>
							<xsl:if test="ancestor-or-self::apiPackage/apiName!='__Global__'">
								<xsl:value-of select="ancestor-or-self::apiPackage/apiName"/>
							</xsl:if>
						</xsl:when>
					</xsl:choose>
				</td>
			</xsl:if>
		</tr>
	</xsl:template>
	<xsl:template name="getNamespaceLink">
		<xsl:param name="accessLevel"/>
		<xsl:param name="baseRef"/>
		<xsl:choose>
			<xsl:when test="$config/languageElements[@show='true' and @statements='true']">
				<xsl:if test="$accessLevel='public' or $accessLevel='protected'">
					<xsl:choose>
						<xsl:when test="$prog_language_name='javascript'"/>
						<xsl:otherwise>
							<xsl:value-of select="$accessLevel"/>
						</xsl:otherwise>
					</xsl:choose>
				</xsl:if>
				<xsl:if test="not($accessLevel='public' or $accessLevel='protected')">
					<a href="{$baseRef}statements.html#{$accessLevel}">
						<xsl:value-of select="$accessLevel"/>
					</a>
				</xsl:if>
			</xsl:when>
			<xsl:otherwise>
				<xsl:value-of select="$accessLevel"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="getSpecialTypeLink">
		<xsl:param name="type"/>
		<xsl:param name="baseRef">
			<xsl:call-template name="getBaseRef">
				<xsl:with-param name="packageName">
					<xsl:if test="ancestor::apiClassifier">
						<xsl:value-of select="ancestor-or-self::apiPackage/apiName"/>
					</xsl:if>
					<xsl:if test="not(ancestor::apiClassifier)">
						<xsl:value-of select="ancestor-or-self::apiPackage/apiName"/>
					</xsl:if>
				</xsl:with-param>
			</xsl:call-template>
		</xsl:param>
		<xsl:choose>
			<xsl:when test="$config/languageElements[@show='true' and @specialTypes='true']">
				<a href="{$baseRef}specialTypes.html#{$type}">
					<xsl:value-of select="$type"/>
				</a>
			</xsl:when>
			<xsl:otherwise>
				<xsl:value-of select="$type"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="includeExamples">
		<xsl:param name="showIncludeExamples" select="$showIncludeExamples"/>
		<xsl:param name="createExampleLink"/>
		<xsl:param name="createExampleInstructionLink" select="'false'"/>
		<xsl:if test="$showIncludeExamples = 'true'">
			<xsl:if test="./*/example/codeblock">
				<xsl:if test="$createExampleLink = 'true'">
					<a name="includeExamplesSummary"/>
					<div class="detailSectionHeader">
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Examples']]/entry[2]/p"/>
					</div>
				</xsl:if>
				<xsl:for-each select="./*/example">
					<xsl:if test="$createExampleLink = 'false' and position() = 1">
						<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
						<span class="label">
							<xsl:call-template name="getLocalizedString">
								<xsl:with-param name="key">Example</xsl:with-param>
							</xsl:call-template>
						</span>
						<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
					</xsl:if>
					<xsl:if test="$createExampleLink = 'true' and string-length(@conref) &gt; 0 ">
						<div class="exampleHeader">
							<xsl:call-template name="lastIndexOf">
								<xsl:with-param name="string" select="@conref"/>
								<xsl:with-param name="char" select="'\'"/>
							</xsl:call-template>
						</div>
					</xsl:if>
					<xsl:if test="contains(@conref,'.as')">
						<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
					</xsl:if>
					<div class="detailBody">
						<xsl:call-template name="processTags"/>
						<xsl:if test="swfblock/@conref and $showSWFs='true'">
							<xsl:call-template name="getPlugin">
								<xsl:with-param name="pluginId" select="concat('example',position())"/>
								<xsl:with-param name="filename" select="swfblock/@conref"/>
							</xsl:call-template>
						</xsl:if>
					</div>
				</xsl:for-each>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getPlugin">
		<xsl:param name="pluginId"/>
		<xsl:param name="filename"/>
		<xsl:if test="not($isEclipse)">
			<script language="javascript" type="text/javascript">
				<xsl:comment> AC_FL_RunContent( "src", "<xsl:value-of select="substring-before($filename,'.swf')"/>", "width", "100%",
					"height","400px", "salign", "TL", "id", "<xsl:value-of select="$pluginId"/>", "quality", "high", "bgcolor", "", "name",
						"<xsl:value-of select="$pluginId"/>", "flashvars","", "allowScriptAccess","sameDomain", "type",
					"application/x-shockwave-flash","pluginspage", "http://www.macromedia.com/go/getflashplayer" ); </xsl:comment>
			</script>
		</xsl:if>
	</xsl:template>
	<xsl:template match="apiOperation" mode="detail">
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="isMethod" select="true()"/>
		<xsl:param name="className" select="''"/>
		<xsl:param name="baseRef"/>
		<xsl:variable name="name" select="./apiName"/>
		<a name="{$name}()"/>
		<xsl:if test="count(./apiOperationDetail/apiOperationDef/apiParam) &gt; 0 ">
			<xsl:variable name="anchorWithArgs">
				<xsl:value-of select="./apiName"/>
				<xsl:text>(</xsl:text>
				<xsl:for-each select="./apiOperationDetail/apiOperationDef/apiParam">
					<xsl:if test="./apiOperationClassifier">
						<xsl:value-of select="translate(./apiOperationClassifier, ':', '.')"/>
					</xsl:if>
					<xsl:if test="./apiType">
						<xsl:value-of select="translate(./apiType/@value, ':', '.')"/>
					</xsl:if>
					<xsl:if test="position() != last()">
						<xsl:text>,</xsl:text>
					</xsl:if>
				</xsl:for-each>
				<xsl:text>)</xsl:text>
			</xsl:variable>
			<a name="{$anchorWithArgs}"/>
		</xsl:if>
		<table class="detailHeader" cellpadding="0" cellspacing="0">
			<tr>
				<td class="detailHeaderName">
					<xsl:choose>
						<xsl:when test="$prog_language_name='javascript'"/>
						<xsl:otherwise>
							<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
								<xsl:call-template name="insertAIRIcon">
									<xsl:with-param name="baseRef" select="$baseRef"/>
								</xsl:call-template>
								<xsl:value-of select="$nbsp"/>
							</xsl:if>
						</xsl:otherwise>
					</xsl:choose>
					<xsl:value-of select="$name"/>
				</td>
				<td class="detailHeaderParens">
					<xsl:text>()</xsl:text>
				</td>
				<td class="detailHeaderType">
					<xsl:if test="$prog_language_name='ActionScript'">
						<xsl:if test="$isMethod">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Method']]/entry[2]/p"/>
						</xsl:if>
						<xsl:if test="not($isMethod)">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Function']]/entry[2]/p"/>
						</xsl:if>
					</xsl:if>
				</td>
				<xsl:if test="position()!=1">
					<td class="detailHeaderRule">
						<xsl:value-of select="$nbsp"/>
					</td>
				</xsl:if>
			</tr>
		</table>
		<div class="detailBody">
			<xsl:if test="(not(@type) or @type='method')">
				<code>
					<xsl:choose>
						<xsl:when test="$prog_language_name='javascript'"/>
						<xsl:otherwise>
							<xsl:if test="./apiOperationDetail/apiOperationDef/apiIsOverride">
								<xsl:text>override</xsl:text>
							</xsl:if>
						</xsl:otherwise>
					</xsl:choose>
					<xsl:text> </xsl:text>
					<xsl:call-template name="getNamespaceLink">
						<xsl:with-param name="accessLevel" select="./apiOperationDetail/apiOperationDef/apiAccess/@value"/>
						<xsl:with-param name="baseRef" select="$baseRef"/>
					</xsl:call-template>
					<xsl:text> </xsl:text>
					<xsl:if test="./apiOperationDetail/apiOperationDef/apiFinal">
						<xsl:text>final </xsl:text>
					</xsl:if>
					<xsl:choose>
						<xsl:when test="$prog_language_name='javascript'"/>
						<xsl:otherwise>
							<xsl:if test="./apiOperationDetail/apiOperationDef/apiStatic">
								<xsl:text>static </xsl:text>
							</xsl:if>
						</xsl:otherwise>
					</xsl:choose>
					<xsl:if test="$prog_language_name='ActionScript'">
						<xsl:text>function</xsl:text>
					</xsl:if>
					<xsl:text> </xsl:text>
					<xsl:value-of select="./apiName"/>
					<xsl:text>(</xsl:text>
					<xsl:call-template name="params"/>
					<xsl:text>)</xsl:text>
					<xsl:if test="self::apiOperation and $prog_language_name='ActionScript'">
						<xsl:text>:</xsl:text>
						<xsl:call-template name="processReturnType">
							<xsl:with-param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
							<xsl:with-param name="baseRef" select="$baseRef"/>
						</xsl:call-template>
					</xsl:if>
				</code>
			</xsl:if>
			<xsl:apply-templates select="apiOperationDetail/apiOperationDef/apiDeprecated"/>
			<xsl:apply-templates select="deprecated"/>
			<xsl:if test="$classDeprecated='true'">
				<xsl:call-template name="description">
					<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
					<xsl:with-param name="addParagraphTags" select="true()"/>
				</xsl:call-template>
			</xsl:if>
			<xsl:call-template name="version"/>
			<xsl:if test="$classDeprecated!='true'">
				<xsl:call-template name="description">
					<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
					<xsl:with-param name="addParagraphTags" select="true()"/>
				</xsl:call-template>
			</xsl:if>
			<xsl:if test="count(./apiOperationDetail/apiOperationDef/apiParam) &gt; 0 ">
				<p>
					<xsl:call-template name="parameters"/>
				</p>
			</xsl:if>
			<xsl:call-template name="result"/>
			<xsl:call-template name="event"/>
			<xsl:if test="apiOperationDetail/apiOperationDef/apiException">
				<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
				<span class="label">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Throws']]/entry[2]/p"/>
				</span>
				<table cellpadding="0" cellspacing="0" border="0">
					<xsl:apply-templates select="apiOperationDetail/apiOperationDef/apiException"/>
				</table>
			</xsl:if>
			<xsl:call-template name="sees"/>
			<xsl:if test="./*/example[codeblock]">
				<xsl:call-template name="includeExamples">
					<xsl:with-param name="createExampleLink" select="'false'"/>
				</xsl:call-template>
			</xsl:if>
			<xsl:if test="./*/example[not(codeblock)] | includeExamples/includeExample[not(codepart)] ">
				<xsl:for-each select="./*/example[not(codeblock)] | includeExamples/includeExample[not(codepart)]">
					<xsl:if test="count(descendant::*) &gt; 0">
						<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
						<span class="label">
							<xsl:call-template name="getLocalizedString">
								<xsl:with-param name="key">Example</xsl:with-param>
							</xsl:call-template>
						</span>
						<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
						<xsl:call-template name="processTags"/>
					</xsl:if>
				</xsl:for-each>
			</xsl:if>
		</div>
	</xsl:template>
	<!-- CONSTRUCTORS -->
	<xsl:template match="apiConstructor" mode="detail">
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="baseRef"/>
		<xsl:variable name="name" select="./apiName"/>
		<xsl:if test="position()>1">
			<a name="{$name}{position()}()"/>
		</xsl:if>
		<xsl:if test="position()=1">
			<a name="{$name}()"/>
		</xsl:if>
		<xsl:if test="count(./apiConstructorDetail/apiConstructorDef/apiParam) &gt; 0 ">
			<xsl:variable name="anchorWithArgs">
				<xsl:value-of select="./apiName"/>
				<xsl:text>(</xsl:text>
				<xsl:for-each select="./apiConstructorDetail/apiConstructorDef/apiParam">
					<xsl:if test="./apiOperationClassifier">
						<xsl:value-of select="translate(./apiOperationClassifier, ':', '.')"/>
					</xsl:if>
					<xsl:if test="./apiType">
						<xsl:value-of select="translate(./apiType/@value, ':', '.')"/>
					</xsl:if>
					<xsl:if test="position() != last()">
						<xsl:text>,</xsl:text>
					</xsl:if>
				</xsl:for-each>
				<xsl:text>)</xsl:text>
			</xsl:variable>

			<a name="{$anchorWithArgs}"/>
		</xsl:if>
		<table class="detailHeader" cellpadding="0" cellspacing="0">
			<tr>
				<td class="detailHeaderName">
					<xsl:choose>
						<xsl:when test="$prog_language_name='javascript'"/>
						<xsl:otherwise>
							<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
								<xsl:call-template name="insertAIRIcon">
									<xsl:with-param name="baseRef" select="$baseRef"/>
								</xsl:call-template>
								<xsl:value-of select="$nbsp"/>
							</xsl:if>
						</xsl:otherwise>
					</xsl:choose>
					<xsl:value-of select="$name"/>
				</td>
				<td class="detailHeaderParens">
					<xsl:text>()</xsl:text>
				</td>
				<xsl:if test="$prog_language_name='ActionScript'">
					<td class="detailHeaderType">
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Constructor']]/entry[2]/p"/>
					</td>
				</xsl:if>
				<xsl:if test="position()!=1">
					<td class="detailHeaderRule">
						<xsl:value-of select="$nbsp"/>
					</td>
				</xsl:if>
			</tr>
		</table>
		<div class="detailBody">
			<xsl:if test="(not(@type) or @type='method')">
				<code>
					<xsl:call-template name="getNamespaceLink">
						<xsl:with-param name="accessLevel" select="apiConstructorDetail/apiConstructorDef/apiAccess/@value"/>
						<xsl:with-param name="baseRef" select="$baseRef"/>
					</xsl:call-template>
					<xsl:if test="$prog_language_name='ActionScript'">
						<xsl:text> function</xsl:text>
					</xsl:if>
					<xsl:text> </xsl:text>
					<xsl:value-of select="$name"/>
					<xsl:text>(</xsl:text>
					<xsl:call-template name="params"/>
					<xsl:text>)</xsl:text>
				</code>
			</xsl:if>
			<xsl:apply-templates select="apiConstructorDetail/apiConstructorDef/apiDeprecated"/>
			<xsl:call-template name="version"/>
			<xsl:variable name="description">
				<xsl:call-template name="description">
					<xsl:with-param name="classDeprecated" select="$classDeprecated"/>
					<xsl:with-param name="addParagraphTags" select="true()"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:value-of select="$description"/>
			<xsl:if test="$description=''">
				<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
				<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
			</xsl:if>
			<xsl:if test="count(./apiConstructorDetail/apiConstructorDef/apiParam) &gt; 0">
				<xsl:call-template name="parameters"/>
			</xsl:if>
			<xsl:call-template name="event"/>
			<xsl:if test="apiConstructorDetail/apiConstructorDef/apiException">
				<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
				<span class="label">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Throws']]/entry[2]/p"/>
				</span>
				<table cellpadding="0" cellspacing="0" border="0">
					<xsl:apply-templates select="apiConstructorDetail/apiConstructorDef/apiException"/>
				</table>
			</xsl:if>
			<xsl:call-template name="sees"/>
			<xsl:if test="./*/example[codeblock]">
				<xsl:call-template name="includeExamples">
					<xsl:with-param name="createExampleLink" select="'false'"/>
				</xsl:call-template>
			</xsl:if>
			<xsl:if test="./*/example[not(codeblock)] | includeExamples/includeExample[not(codepart)] ">
				<xsl:for-each select="./*/example | includeExamples/includeExample[not(codepart)]">
					<xsl:if test="count(descendant::*) &gt; 0">
						<xsl:if test="position() = 1">
							<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
							<span class="label">
								<xsl:call-template name="getLocalizedString">
									<xsl:with-param name="key">Example</xsl:with-param>
								</xsl:call-template>
							</span>
							<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>

						</xsl:if>
						<xsl:call-template name="processTags"/>
					</xsl:if>
				</xsl:for-each>
			</xsl:if>
		</div>
	</xsl:template>
	<!-- PARAMS -->
	<xsl:template name="params">
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:variable name="baseRef">
			<xsl:call-template name="getBaseRef">
				<xsl:with-param name="packageName" select="$currentPackage"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:for-each select=".//apiParam">
			<xsl:if test="position()>1">
				<xsl:text>, </xsl:text>
			</xsl:if>
			<xsl:if test="$config/options/@docversion='2' and @optional='true'">
				<xsl:text>[</xsl:text>
			</xsl:if>
			<xsl:if test="./apiType or ./apiOperationClassifier">
				<xsl:if test="./apiType/@value= 'restParam' or ./apiOperationClassifier = 'restParam'">
					<xsl:if test="$config/languageElements[@show='true' and @statements='true']">
						<a href="{$baseRef}statements.html#..._(rest)_parameter">...</a>
					</xsl:if>
					<xsl:if test="not($config/languageElements[@show='true' and @statements='true'])">
						<xsl:text>...</xsl:text>
					</xsl:if>
					<xsl:text> </xsl:text>
					<xsl:value-of select="./apiItemName"/>
				</xsl:if>
				<xsl:if test="((./apiType and ./apiType/@value!='restParam'))  or (./apiOperationClassifier and ./apiOperationClassifier != 'restParam')">
					<xsl:if test="$prog_language_name='ActionScript'">
						<xsl:value-of select="./apiItemName"/>
						<xsl:text>:</xsl:text>
						<xsl:call-template name="processParamType">
							<xsl:with-param name="currentPackage" select="$currentPackage"/>
							<xsl:with-param name="baseRef" select="$baseRef"/>
						</xsl:call-template>
					</xsl:if>
				</xsl:if>
			</xsl:if>
			<xsl:if test="(string-length(apiData) or ./apiOperationClassifier='String') and apiData!='unknown'">
				<xsl:text> = </xsl:text>
				<xsl:if test="./apiOperationClassifier='String' and apiData!='null'">
					<xsl:text>"</xsl:text>
				</xsl:if>
				<xsl:value-of select="apiData"/>
				<xsl:if test="./apiOperationClassifier='String' and apiData!='null'">
					<xsl:text>"</xsl:text>
				</xsl:if>
			</xsl:if>
			<xsl:if test="./apiOperationClassifier='Number' and apiData='unknown'">
				<xsl:text> = NaN</xsl:text>
			</xsl:if>
			<xsl:if test="$config/options/@docversion='2' and @optional='true'">
				<xsl:text>]</xsl:text>
			</xsl:if>
		</xsl:for-each>
	</xsl:template>
	<xsl:template name="processParamType">
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:param name="baseRef" select="''"/>
		<xsl:choose>
			<xsl:when test="./apiOperationClassifier">
				<xsl:variable name="destination" select="./apiOperationClassifier"/>
				<xsl:variable name="h1" select="substring-after($destination,':')"/>
				<xsl:variable name="h2" select="substring-before($destination,':')"/>
				<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
				<xsl:variable name="gfile" select="concat($baseRef,$destination,'.html')"/>
				<xsl:variable name="hyperLink">
					<xsl:if test="contains($destination,'.')">
						<xsl:if test="$prog_language_name!='javascript'">
							<xsl:value-of select="$file"/>
						</xsl:if>
					</xsl:if>
					<xsl:if test="not(contains($destination,'.'))">
						<xsl:choose>
							<xsl:when test="$prog_language_name='javascript'"/>
							<xsl:otherwise>
								<xsl:value-of select="$gfile"/>
							</xsl:otherwise>
						</xsl:choose>
					</xsl:if>
				</xsl:variable>
				<xsl:if test="$hyperLink = ''">
					<xsl:call-template name="getSimpleClassName">
						<xsl:with-param name="fullClassName" select="./apiOperationClassifier"/>
					</xsl:call-template>
				</xsl:if>
				<xsl:if test="$hyperLink != ''">
					<a href="{$hyperLink}">
						<xsl:call-template name="getSimpleClassName">
							<xsl:with-param name="fullClassName" select="./apiOperationClassifier"/>
						</xsl:call-template>
					</a>
				</xsl:if>
			</xsl:when>
			<xsl:when test="./apiType/@value='' or ./apiType/@value='*' or ./apiType/@value='any'or ./apiOperationClassifier='' or ./apiOperationClassifier='*'">
				<xsl:call-template name="getSpecialTypeLink">
					<xsl:with-param name="type" select="'*'"/>
					<xsl:with-param name="baseRef" select="$baseRef"/>
				</xsl:call-template>
			</xsl:when>
			<xsl:when test="not(./apiOperationClassifier)">
				<xsl:call-template name="getSimpleClassName">
					<xsl:with-param name="fullClassName" select="./apiType/@value"/>
					<xsl:with-param name="baseRef" select="$baseRef"/>
				</xsl:call-template>
			</xsl:when>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="parameters">
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<span class="label">
			<xsl:call-template name="getLocalizedString">
				<xsl:with-param name="key">Parameters</xsl:with-param>
			</xsl:call-template>
		</span>
		<table cellpadding="0" cellspacing="0" border="0">
			<xsl:for-each select=".//apiParam">
				<tr>
					<td width="20px"/>
					<td>
						<code>
							<xsl:if test="./apiType/@value='restParam' or ./apiOperationClassifier='restParam'">
								<xsl:variable name="baseRef">
									<xsl:if test="$currentPackage">
										<xsl:call-template name="getBaseRef">
											<xsl:with-param name="packageName" select="$currentPackage"/>
										</xsl:call-template>
									</xsl:if>
								</xsl:variable>
								<xsl:if test="$config/languageElements[@show='true' and @statements='true']">
									<a href="{$baseRef}statements.html#..._(rest)_parameter">...</a>
								</xsl:if>
								<xsl:if test="not($config/languageElements[@show='true' and @statements='true'])">
									<xsl:text>...</xsl:text>
								</xsl:if>
								<xsl:text> </xsl:text>
								<span class="label">
									<xsl:value-of select="./apiItemName"/>
								</span>
							</xsl:if>
							<xsl:if test="((./apiType) and ./apiType/@value!='restParam')  or (./apiOperationClassifier and ./apiOperationClassifier!='restParam')">
								<span class="label">
									<xsl:value-of select="./apiItemName"/>
								</span>
								<xsl:if test="$prog_language_name='ActionScript'">
									<xsl:choose>
										<xsl:when test="./apiOperationClassifier">
											<xsl:variable name="packageName" select="ancestor-or-self::apiPackage/apiName"/>
											<xsl:variable name="baseRef">
												<xsl:call-template name="getBaseRef">
													<xsl:with-param name="packageName" select="$packageName"/>
												</xsl:call-template>
											</xsl:variable>
											<xsl:variable name="destination" select="./apiOperationClassifier"/>
											<xsl:variable name="h1" select="substring-after($destination,':')"/>
											<xsl:variable name="h2" select="substring-before($destination,':')"/>
											<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
											<xsl:variable name="gfile" select="concat($baseRef,$destination,'.html')"/>
											<xsl:variable name="hyperLink">
												<xsl:if test="contains($destination,'.')">
													<xsl:value-of select="$file"/>
												</xsl:if>
												<xsl:if test="not(contains($destination,'.'))">
													<xsl:value-of select="$gfile"/>
												</xsl:if>
											</xsl:variable>
											<xsl:text>:</xsl:text>
											<xsl:if test="$hyperLink = ''">
												<xsl:call-template name="getSimpleClassName">
													<xsl:with-param name="fullClassName" select="./apiOperationClassifier"/>
												</xsl:call-template>
											</xsl:if>
											<xsl:if test="$hyperLink != ''">
												<a href="{$hyperLink}">
													<xsl:call-template name="getSimpleClassName">
														<xsl:with-param name="fullClassName" select="./apiOperationClassifier"/>
													</xsl:call-template>
												</a>
											</xsl:if>
										</xsl:when>
										<xsl:when test="./apiType/@value='' or ./apiType/@value='*' or ./apiType/@value='any' or ./apiOperationClassifier='' or ./apiOperationClassifier='*'">
											<xsl:text>:</xsl:text>
											<xsl:variable name="baseRef">
												<xsl:call-template name="getBaseRef">
													<xsl:with-param name="packageName" select="$currentPackage"/>
												</xsl:call-template>
											</xsl:variable>
											<xsl:call-template name="getSpecialTypeLink">
												<xsl:with-param name="type" select="'*'"/>
												<xsl:with-param name="baseRef" select="$baseRef"/>
											</xsl:call-template>
										</xsl:when>
										<xsl:when test="not(./apiOperationClassifier)">
											<xsl:variable name="baseRef">
												<xsl:call-template name="getBaseRef">
													<xsl:with-param name="packageName" select="$currentPackage"/>
												</xsl:call-template>
											</xsl:variable>
											<xsl:text>:</xsl:text>
											<xsl:call-template name="getSimpleClassName">
												<xsl:with-param name="fullClassName" select="./apiType/@value"/>
												<xsl:with-param name="baseRef" select="$baseRef"/>
											</xsl:call-template>
										</xsl:when>
									</xsl:choose>
								</xsl:if>


							</xsl:if>
							<xsl:if test="(string-length(./apiData) or ./apiOperationClassifier='String') and ./apiData!='unknown'">
								<xsl:text disable-output-escaping="yes">&lt;/code&gt; (default = </xsl:text>
								<xsl:if test="./apiOperationClassifier='String' and ./apiData!='null'">
									<xsl:text>"</xsl:text>
								</xsl:if>
								<xsl:text disable-output-escaping="yes">&lt;code&gt;</xsl:text>
								<xsl:value-of select="apiData"/>
								<xsl:text disable-output-escaping="yes">&lt;/code&gt;</xsl:text>
								<xsl:if test="./apiOperationClassifier='String' and ./apiData!='null'">
									<xsl:text>"</xsl:text>
								</xsl:if>
								<xsl:text>)</xsl:text>
								<xsl:text disable-output-escaping="yes">&lt;code&gt;</xsl:text>
							</xsl:if>
							<xsl:if test="(string-length(./apiData) or ./apiOperationClassifier='Number') and ./apiData='unknown'">
								<xsl:text disable-output-escaping="yes">&lt;/code&gt; (default = </xsl:text>
								<xsl:text disable-output-escaping="yes">&lt;code&gt;</xsl:text>
								<xsl:value-of select="'NaN'"/>
								<xsl:text disable-output-escaping="yes">&lt;/code&gt;</xsl:text>
								<xsl:text>)</xsl:text>
								<xsl:text disable-output-escaping="yes">&lt;code&gt;</xsl:text>
							</xsl:if>
						</code>
						<xsl:if test="@optional='true'">
							<xsl:text disable-output-escaping="yes"><![CDATA[&nbsp;]]>[optional]</xsl:text>
						</xsl:if>
						<xsl:if test="normalize-space(./apiDesc/.)">
							<xsl:value-of select="$emdash"/>
							<xsl:for-each select="./apiDesc">
								<xsl:call-template name="processTags"/>
							</xsl:for-each>
						</xsl:if>
					</td>
				</tr>
				<xsl:if test="position()!=last()">
					<tr>
						<td class="paramSpacer">
							<xsl:value-of select="$nbsp"/>
						</td>
					</tr>
				</xsl:if>
			</xsl:for-each>
		</table>
	</xsl:template>
	<!-- RESULT -->
	<xsl:template name="result">
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:variable name="baseRef">
			<xsl:call-template name="getBaseRef">
				<xsl:with-param name="packageName" select="$currentPackage"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:if
			test="(not(apiOperationDetail/apiOperationDef/apiReturn/apiType) or apiOperationDetail/apiOperationDef/apiReturn/apiType[@value != 'void']) and not($config/options/@docversion='2' and apiOperationDetail/apiOperationDef/apiReturn/apiOperationClassifer='Void')">
			<p/>
			<span class="label">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Returns']]/entry[2]/p"/>
			</span>
			<table cellpadding="0" cellspacing="0" border="0">
				<tr>
					<td width="20"/>
					<td>
						<xsl:if test="$prog_language_name='ActionScript'">
							<code>
								<xsl:choose>
									<xsl:when
										test="apiOperationDetail/apiOperationDef/apiReturn/apiType/@value='' or apiOperationDetail/apiOperationDef/apiReturn/apiType/@value='*' or apiOperationDetail/apiOperationDef/apiReturn/apiType/@value='any' ">
										<xsl:call-template name="getSpecialTypeLink">
											<xsl:with-param name="type" select="'*'"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
										</xsl:call-template>
									</xsl:when>
									<xsl:when test="apiOperationDetail/apiOperationDef/apiReturn/apiType/@value='Void' and $config/options/@docversion='2'">
										<xsl:value-of select="apiOperationDetail/apiOperationDef/apiReturn/apiType/@value"/>
									</xsl:when>
									<xsl:when test="apiOperationDetail/apiOperationDef/apiReturn/apiOperationClassifier">
										<xsl:variable name="destination" select="apiOperationDetail/apiOperationDef/apiReturn/apiOperationClassifier"/>
										<xsl:variable name="h1" select="substring-after($destination,':')"/>
										<xsl:variable name="h2" select="substring-before($destination,':')"/>
										<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
										<xsl:variable name="gfile" select="concat($baseRef,$destination,'.html')"/>
										<xsl:variable name="hyperLink">
											<xsl:if test="contains($destination,'.')">
												<xsl:value-of select="$file"/>
											</xsl:if>
											<xsl:if test="not(contains($destination,'.'))">
												<xsl:value-of select="$gfile"/>
											</xsl:if>
										</xsl:variable>
										<xsl:if test="$hyperLink = ''">
											<xsl:call-template name="getSimpleClassName">
												<xsl:with-param name="fullClassName" select="apiOperationDetail/apiOperationDef/apiReturn/apiOperationClassifier"/>
											</xsl:call-template>
										</xsl:if>
										<xsl:if test="$hyperLink != ''">
											<a href="{$hyperLink}">
												<xsl:call-template name="getSimpleClassName">
													<xsl:with-param name="fullClassName" select="apiOperationDetail/apiOperationDef/apiReturn/apiOperationClassifier"/>
												</xsl:call-template>
											</a>
										</xsl:if>
									</xsl:when>
									<xsl:when test="not(apiOperationDetail/apiOperationDef/apiReturn/apiOperationClassifier)">
										<xsl:call-template name="getSimpleClassName">
											<xsl:with-param name="fullClassName" select="apiOperationDetail/apiOperationDef/apiReturn/apiType/@value"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
										</xsl:call-template>
									</xsl:when>
								</xsl:choose>
							</code>
						</xsl:if>
						<xsl:if test="./apiOperationDetail/apiOperationDef/apiReturn/apiDesc/@conref">
							<xsl:if test="$prog_language_name='ActionScript'">
								<xsl:value-of select="$emdash"/>
							</xsl:if>
							<xsl:call-template name="getConRefText">
								<xsl:with-param name="conref" select="./apiOperationDetail/apiOperationDef/apiReturn/apiDesc/@conref"/>
								<xsl:with-param name="descriptionType" select="local-name(./apiOperationDetail/apiOperationDef/apiReturn/apiDesc)"/>
								<xsl:with-param name="entryType" select="'method'"/>
								<xsl:with-param name="currentPackage" select="$currentPackage"/>
							</xsl:call-template>
						</xsl:if>
						<xsl:if test="not(./apiOperationDetail/apiOperationDef/apiReturn/apiDesc/@conref)">
							<xsl:for-each select="./apiOperationDetail/apiOperationDef/apiReturn/apiDesc">
								<xsl:if test="$prog_language_name='ActionScript'">
									<xsl:value-of select="$emdash"/>
								</xsl:if>
								<xsl:call-template name="processTags"/>
							</xsl:for-each>
						</xsl:if>
					</td>
				</tr>
			</table>
		</xsl:if>
	</xsl:template>
	<!-- THROWS -->
	<xsl:template match="apiException">
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<tr>
			<td width="20"/>
			<td>
				<code>
					<xsl:if test="apiOperationClassifier">
						<xsl:variable name="packageName" select="ancestor-or-self::apiPackage/apiName"/>
						<xsl:variable name="baseRef">
							<xsl:call-template name="getBaseRef">
								<xsl:with-param name="packageName" select="$packageName"/>
							</xsl:call-template>
						</xsl:variable>
						<xsl:variable name="destination" select="apiOperationClassifier"/>
						<xsl:if test="count($classHeader_map//apiClassifier[@id=$destination] ) &gt; 0">
							<xsl:variable name="h1" select="substring-after($destination,':')"/>
							<xsl:variable name="h2" select="substring-before($destination,':')"/>
							<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
							<xsl:variable name="gfile" select="concat($baseRef,$destination,'.html')"/>
							<xsl:variable name="hyperLink">
								<xsl:if test="contains($destination,'.')">
									<xsl:if test="$prog_language_name!='javascript'">
										<xsl:value-of select="$file"/>
									</xsl:if>

								</xsl:if>
								<xsl:if test="not(contains($destination,'.'))">
									<xsl:choose>
										<xsl:when test="$prog_language_name='javascript'"/>
										<xsl:otherwise>
											<xsl:value-of select="$gfile"/>
										</xsl:otherwise>
									</xsl:choose>
								</xsl:if>
							</xsl:variable>

							<xsl:if test="$hyperLink = ''">
								<xsl:value-of select="apiItemName"/>
							</xsl:if>
							<xsl:if test="$hyperLink != ''">
								<a href="{$hyperLink}">
									<xsl:value-of select="apiItemName"/>
								</a>
							</xsl:if>
						</xsl:if>
						<xsl:if test="not(count($classHeader_map//apiClassifier[@id=$destination] ) &gt; 0)">
								<xsl:value-of select="apiItemName"/>
						</xsl:if>
						<xsl:text> </xsl:text>
					</xsl:if>

				</code>
				<xsl:if test="string-length(apiDesc/.)">
					<xsl:value-of select="$emdash"/>
				</xsl:if>
				<xsl:for-each select="./apiDesc">
					<xsl:call-template name="processTags"/>
				</xsl:for-each>
			</td>
		</tr>
		<xsl:if test="position()!=last()">
			<tr>
				<td class="paramSpacer">
					<xsl:value-of select="$nbsp"/>
				</td>
			</tr>
		</xsl:if>
	</xsl:template>
	<!-- EXAMPLES -->
	<xsl:template match="example | includeExample">
		<xsl:param name="show" select="$showExamples"/>
		<xsl:if test="$show = 'true'">
			<xsl:if test="position()=1">
				<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
				<span class="label">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Example']]/entry[2]/p"/>
				</span>
				<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>

			</xsl:if>
			<xsl:if test="self::example">
				<xsl:call-template name="deTilda">
					<xsl:with-param name="inText">
						<xsl:apply-templates mode="deTab"/>
					</xsl:with-param>
				</xsl:call-template>
			</xsl:if>
			<xsl:if test="self::includeExample">
				<xsl:variable name="deTabbed">
					<xsl:call-template name="search-and-replace">
						<xsl:with-param name="input" select="codeblock/."/>
						<xsl:with-param name="search-string" select="$tab"/>
						<xsl:with-param name="replace-string" select="$tabSpaces"/>
					</xsl:call-template>
				</xsl:variable>
				<xsl:variable name="initialComment" select="starts-with($deTabbed,'/*')"/>
				<xsl:if test="$initialComment">
					<xsl:variable name="comment" select="substring-before($deTabbed,'*/')"/>
					<xsl:if test="contains($comment,'@exampleText ')">
						<xsl:call-template name="deTilda">
							<xsl:with-param name="inText" select="substring-after(translate($comment,'*',''),'@exampleText ')"/>
						</xsl:call-template>
					</xsl:if>
				</xsl:if>
				<xsl:if test="$initialComment">
					<xsl:variable name="rest" select="substring-after($deTabbed,'*/')"/>
					<xsl:variable name="finalComment" select="contains($rest,'/*')"/>
					<xsl:if test="$finalComment">
						<div class="listing">
							<pre>
								<xsl:value-of select="substring-before($rest,'/*')"/>
							</pre>
						</div>
						<xsl:if test="contains($rest,'@exampleText ')">
							<xsl:call-template name="deTilda">
								<xsl:with-param name="inText" select="substring-after(translate(substring-before($rest,'*/'),'*',''),'@exampleText ')"/>
							</xsl:call-template>
							<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
						</xsl:if>
					</xsl:if>
					<xsl:if test="not($finalComment)">
						<div class="listing">
							<pre>
								<xsl:value-of select="substring-after($deTabbed,'*/')"/>
							</pre>
						</div>
					</xsl:if>
				</xsl:if>
				<xsl:if test="not($initialComment)">
					<xsl:variable name="finalComment" select="contains($deTabbed,'/*')"/>
					<xsl:if test="$finalComment">
						<div class="listing">
							<pre>
								<xsl:value-of select="substring-before($deTabbed,'/*')"/>
							</pre>
						</div>
						<xsl:if test="contains($deTabbed,'@exampleText ')">
							<xsl:call-template name="deTilda">
								<xsl:with-param name="inText" select="substring-after(translate(substring-before($deTabbed,'*/'),'*',''),'@exampleText ')"/>
							</xsl:call-template>
							<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
						</xsl:if>
					</xsl:if>
					<xsl:if test="not($finalComment)">
						<div class="listing">
							<pre>
								<xsl:value-of select="$deTabbed"/>
							</pre>
						</div>
					</xsl:if>
				</xsl:if>
				<xsl:if test="swfblock/@conref and $showSWFs='true'">
					<xsl:variable name="filename" select="swfblock/@conref"/>
					<xsl:call-template name="getPlugin">
						<xsl:with-param name="filename" select="$filename"/>
					</xsl:call-template>
				</xsl:if>
			</xsl:if>
			<p/>
		</xsl:if>
	</xsl:template>
	<xsl:template match="text()" mode="deTab">
		<xsl:call-template name="search-and-replace">
			<xsl:with-param name="input" select="."/>
			<xsl:with-param name="search-string" select="'&#09;'"/>
			<xsl:with-param name="replace-string" select="'    '"/>
		</xsl:call-template>
	</xsl:template>
	<xsl:template name="includeExampleLink">
		<xsl:param name="showIncludeExamples" select="$showIncludeExamples"/>
		<xsl:if test="$showIncludeExamples = 'true'">
			<xsl:if test="./*/example/codeblock">
				<p>
					<a href="#includeExamplesSummary">
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ViewExamples']]/entry[2]/p"/>
					</a>
				</p>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="inherited">
		<xsl:param name="lowerType"/>
		<xsl:param name="upperType"/>
		<xsl:param name="prefix"/>
		<xsl:param name="postfix"/>
		<xsl:param name="inheritedItems"/>
		<xsl:param name="staticItems"/>
		<xsl:if test="string-length($inheritedItems) &gt; 0">
			<xsl:call-template name="doInherited">
				<xsl:with-param name="lowerType" select="$lowerType"/>
				<xsl:with-param name="upperType" select="$upperType"/>
				<xsl:with-param name="prefix" select="$prefix"/>
				<xsl:with-param name="postfix" select="$postfix"/>
				<xsl:with-param name="items" select="$inheritedItems"/>
			</xsl:call-template>
		</xsl:if>
		<xsl:if test="string-length($staticItems) &gt; 0">
			<xsl:call-template name="doInherited">
				<xsl:with-param name="lowerType" select="$lowerType"/>
				<xsl:with-param name="upperType" select="$upperType"/>
				<xsl:with-param name="prefix" select="$prefix"/>
				<xsl:with-param name="postfix" select="$postfix"/>
				<xsl:with-param name="items" select="$staticItems"/>
				<xsl:with-param name="isStatic" select="true()"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>
	<xsl:template name="doInherited">
		<xsl:param name="lowerType"/>
		<xsl:param name="upperType"/>
		<xsl:param name="prefix"/>
		<xsl:param name="postfix"/>
		<xsl:param name="items"/>
		<xsl:param name="innerClass" select="false()"/>
		<xsl:param name="isStatic" select="false()"/>
		<xsl:variable name="classRef" select="classRef"/>
		<xsl:variable name="bgColor">
			<xsl:if test="not($isStatic)">
				<xsl:text>#EEEEEE</xsl:text>
			</xsl:if>
			<xsl:if test="$isStatic">
				<xsl:text>#EEDDDD</xsl:text>
			</xsl:if>
		</xsl:variable>
		<a name="{$lowerType}InheritedFrom{$classRef/@name}"/>
		<table cellspacing="0" cellpadding="3" class="summaryTable">
			<tr>
				<th>
					<xsl:value-of select="$nbsp"/>
				</th>
				<th>
					<xsl:if test="$isStatic">
						<!--defined in class-->
						<xsl:text>Static </xsl:text>
						<xsl:value-of select="$lowerType"/>
						<xsl:call-template name="getLocalizedString">
							<xsl:with-param name="key">DefinedIn</xsl:with-param>
						</xsl:call-template>
					</xsl:if>
					<xsl:if test="not($isStatic)">
						<!-- inherited from class -->
						<xsl:value-of select="$upperType"/>
						<xsl:call-template name="getLocalizedString">
							<xsl:with-param name="key">InheritedFrom</xsl:with-param>
						</xsl:call-template>
					</xsl:if>
					<a href="{$classRef/@relativePath}">
						<xsl:value-of select="$classRef/@name"/>
					</a>
				</th>
			</tr>
			<tr>
				<td class="summaryTablePaddingCol">
					<xsl:value-of select="$nbsp"/>
				</td>
				<td class="inheritanceList">
					<code>
						<xsl:for-each select="tokenize($items,';')">
							<xsl:sort select="." order="ascending" data-type="text" lang="en-US"/>
							<xsl:if test="$innerClass">
								<xsl:variable name="href">
									<xsl:if test="contains($classRef/@relativePath,':')">
										<xsl:call-template name="substring-before-last">
											<xsl:with-param name="input" select="$classRef/@relativePath"/>
											<xsl:with-param name="substr" select="':'"/>
										</xsl:call-template>
										<xsl:text>/</xsl:text>
									</xsl:if>
									<xsl:value-of select="."/>
								</xsl:variable>
								<a href="{$href}.html">
									<xsl:value-of select="."/>
								</a>
							</xsl:if>
							<xsl:if test="not($innerClass)">
								<xsl:if test="$prefix">
									<a href="{$classRef/@relativePath}#{$prefix}:{.}{$postfix}">
										<xsl:value-of select="."/>
									</a>
								</xsl:if>
								<xsl:if test="not($prefix)">
									<a href="{$classRef/@relativePath}#{.}{$postfix}">
										<xsl:value-of select="."/>
									</a>
								</xsl:if>
							</xsl:if>
							<xsl:if test="position() != last()">
								<xsl:text>, </xsl:text>
							</xsl:if>
						</xsl:for-each>
					</code>
				</td>
			</tr>
		</table>
	</xsl:template>
	<xsl:template name="description">
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="addParagraphTags" select="false()"/>
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:variable name="sourceName">
			<xsl:value-of select="local-name(.)"/>
			<xsl:value-of select="./apiName"/>
		</xsl:variable>
		<xsl:if test="$classDeprecated='true'">
			<xsl:copy-of select="$deprecatedLabel"/>
			<xsl:message>THIS CODE SHOULD NOT BE CALLED. If you see this message, please notify your local ASDocs contact or the tech team. </xsl:message>
			<xsl:text>.</xsl:text>
			<xsl:text> The </xsl:text>
			<xsl:value-of select="../../apiName"/>
			<xsl:text> class is </xsl:text>
			<a href="#deprecated">deprecated</a>
			<xsl:if test="string-length(../../deprecated/@as-of)">
				<xsl:text> since </xsl:text>
				<xsl:value-of select="../../deprecated/@as-of"/>
			</xsl:if>
			<xsl:text>.</xsl:text>
			<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
			<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
		</xsl:if>
		<xsl:variable name="asCustomsText">
			<xsl:value-of select="prolog/asCustoms/review"/>
		</xsl:variable>
		<xsl:if test="string-length($asCustomsText) &gt; 0">
			<xsl:if test="$config/options/@showReview='true'">
				<h2>
					<font color="red">Review Needed</font>
				</h2>
			</xsl:if>
			<xsl:value-of select="$asCustomsText"/>
		</xsl:if>
		<xsl:for-each select="./apiDesc | ./*/apiDesc | ./description">
			<xsl:variable name="entryType">
				<xsl:choose>
					<xsl:when test="self::apiClassifier">
						<xsl:value-of select="'class'"/>
					</xsl:when>
					<xsl:when test="self::apiOperation">
						<xsl:value-of select="'method'"/>
					</xsl:when>
					<xsl:when test="self::apiValue">
						<xsl:value-of select="'property'"/>
					</xsl:when>
					<xsl:when test="self::adobeApiEvent">
						<xsl:value-of select="'event'"/>
					</xsl:when>
					<xsl:when test="self::style">
						<xsl:value-of select="'style'"/>
					</xsl:when>
				</xsl:choose>
			</xsl:variable>

			<p>
				<xsl:if test="string-length(./@conref) &gt; 0">
					<xsl:call-template name="getConRefText">
						<xsl:with-param name="conref" select="./@conref"/>
						<xsl:with-param name="descriptionType" select="local-name(.)"/>
						<xsl:with-param name="entryType" select="$entryType"/>
						<xsl:with-param name="currentPackage" select="$currentPackage"/>
					</xsl:call-template>
				</xsl:if>
			</p>

			<!-- Call for any child NODE PROCESS-->
			<xsl:call-template name="processTags">
				<xsl:with-param name="addParagraphTags" select="$addParagraphTags"/>
			</xsl:call-template>
			<!-- END Call for any child NODE PROCESS-->
		</xsl:for-each>
	</xsl:template>
	<xsl:template name="shortDescription">
		<xsl:param name="classDeprecated" select="'false'"/>
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:if test="./shortdesc or $classDeprecated='true'">
			<xsl:call-template name="shortDescriptionReview"/>
			<xsl:if test="$classDeprecated='true'">
				<xsl:copy-of select="$deprecatedLabel"/>
				<xsl:text>. </xsl:text>
			</xsl:if>
			<xsl:variable name="entryType">
				<xsl:choose>
					<xsl:when test="self::apiClassifier">
						<xsl:value-of select="'class'"/>
					</xsl:when>
					<xsl:when test="self::apiOperation">
						<xsl:value-of select="'method'"/>
					</xsl:when>
					<xsl:when test="self::apiValue">
						<xsl:value-of select="'property'"/>
					</xsl:when>
					<xsl:when test="self::adobeApiEvent">
						<xsl:value-of select="'event'"/>
					</xsl:when>
					<xsl:when test="self::style">
						<xsl:value-of select="'style'"/>
					</xsl:when>
				</xsl:choose>
			</xsl:variable>
			<xsl:variable name="conRefText">
				<xsl:if test="string-length(./shortdesc/@conref) &gt; 0">
					<xsl:for-each select="./shortdesc">
						<xsl:call-template name="processTags"/>
					</xsl:for-each>

					<xsl:call-template name="getConRefText">
						<xsl:with-param name="conref" select="./shortdesc/@conref"/>
						<xsl:with-param name="descriptionType" select="local-name(./shortdesc)"/>
						<xsl:with-param name="entryType" select="$entryType"/>
						<xsl:with-param name="currentPackage" select="$currentPackage"/>
					</xsl:call-template>
				</xsl:if>
				<xsl:if test="not(string-length(./shortdesc/@conref) &gt; 0)">
					<xsl:for-each select="./shortdesc">
						<xsl:call-template name="processTags"/>
					</xsl:for-each>
				</xsl:if>
			</xsl:variable>
			<xsl:if test="string-length($conRefText) &gt; 0">
				<xsl:value-of select="$conRefText"/>
			</xsl:if>
		</xsl:if>
	</xsl:template>

	<xsl:template name="hasInnerClasses">
		<xsl:if test="self::apiClassifier">
			<xsl:value-of select="count(./apiClassifier)"/>
		</xsl:if>
		<xsl:if test="self::apiPackage"> </xsl:if>
	</xsl:template>
	<xsl:template name="hasConstants">
		<xsl:if test="self::apiClassifier">
			<xsl:value-of select="count(./apiValue[not(apiValueDetail/apiValueDef/apiProperty)])"/>
		</xsl:if>
		<xsl:if test="self::apiPackage">
			<xsl:value-of select="count(.//*[apiValue[not(apiValueDetail/apiValueDef/apiProperty)]])"/>
		</xsl:if>
	</xsl:template>
	<xsl:template name="hasFields">
		<xsl:if test="self::apiClassifier">
			<xsl:value-of select="count(./apiValue[apiValueDetail/apiValueDef/apiProperty])"/>
		</xsl:if>
		<xsl:if test="self::apiPackage">
			<xsl:value-of select="count(.//*[apiValue[apiValueDetail/apiValueDef/apiProperty]])"/>
		</xsl:if>
	</xsl:template>
	<xsl:template name="hasConstructor">
		<xsl:if test="self::apiClassifier">
			<xsl:value-of select="count(./apiConstructor)"/>
		</xsl:if>
		<xsl:if test="self::apiPackage">
			<xsl:value-of select="count(./*[apiConstructor])"/>
		</xsl:if>
	</xsl:template>
	<xsl:template name="hasMethods">
		<xsl:if test="self::apiClassifier">
			<xsl:value-of select="count(./apiOperation)"/>
		</xsl:if>
		<xsl:if test="self::apiPackage">
			<xsl:value-of select="count(.//*[apiOperation])"/>
		</xsl:if>
	</xsl:template>
	<!-- TODO currently the mxmlc compiler does not recognize events defined in interfaces that are
	     not redeclared by the implementor, so we can not consider them when determining the event count -->
	<xsl:template name="hasEvents">
		<xsl:if test="self::apiClassifier">
			<xsl:value-of select="count(./adobeApiEvent[not(adobeApiEventDetail/adobeApiEventDef/apiDefinedEvent)])"/>
		</xsl:if>
	</xsl:template>
	<xsl:template name="hasStyles">
		<xsl:value-of select="count(.//*[style])"/>
	</xsl:template>

	  <xsl:template name="hasSkinPart">
	    <xsl:value-of select="count(.//*[SkinPart])"/>
	  </xsl:template>
	  <xsl:template name="hasSkinState">
	    <xsl:value-of select="count(.//*[SkinState])"/>
	  </xsl:template>	
	<xsl:template name="hasEffects">
		<xsl:value-of select="count(.//*[effect])"/>
	</xsl:template>
	<xsl:template name="hasInheritedConstants">
		<xsl:variable name="countList">
			<xsl:call-template name="inheritPropertyCount">
				<xsl:with-param name="baseClass" select="./apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
				<xsl:with-param name="accessLevel" select="'public'"/>
				<xsl:with-param name="isConst" select="'true'"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="hasInherited">
			<xsl:call-template name="convertNumberListIntoBoolean">
				<xsl:with-param name="numberList" select="$countList"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:value-of select="$hasInherited"/>
	</xsl:template>
	<xsl:template name="hasInheritedFields">
		<xsl:variable name="countList">
			<xsl:call-template name="inheritPropertyCount">
				<xsl:with-param name="baseClass" select="./apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
				<xsl:with-param name="accessLevel" select="'public'"/>
				<xsl:with-param name="isConst" select="'false'"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="hasInherited">
			<xsl:call-template name="convertNumberListIntoBoolean">
				<xsl:with-param name="numberList" select="$countList"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:value-of select="$hasInherited"/>
	</xsl:template>
	<xsl:template name="hasInheritedMethods">
		<xsl:variable name="countList">
			<xsl:call-template name="inheritMethodCount">
				<xsl:with-param name="baseClass" select="./apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
				<xsl:with-param name="accessLevel" select="'public'"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="hasInherited">
			<xsl:call-template name="convertNumberListIntoBoolean">
				<xsl:with-param name="numberList" select="$countList"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:value-of select="$hasInherited"/>
	</xsl:template>
	<xsl:template name="hasInheritedEvents">
		<xsl:variable name="countList">
			<xsl:call-template name="inheritEventCount">
				<xsl:with-param name="baseClass" select="./apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="hasInherited">
			<xsl:call-template name="convertNumberListIntoBoolean">
				<xsl:with-param name="numberList" select="$countList"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:value-of select="$hasInherited"/>
	</xsl:template>
	<xsl:template name="hasInheritedStyles">
		<xsl:variable name="countList">
			<xsl:call-template name="inheritStyleCount">
				<xsl:with-param name="baseClass" select="./apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="hasInherited">
			<xsl:call-template name="convertNumberListIntoBoolean">
				<xsl:with-param name="numberList" select="$countList"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:value-of select="$hasInherited"/>
	</xsl:template>
	<xsl:template name="hasInheritedSkinPart">
		<xsl:variable name="countList">
			<xsl:call-template name="inheritSkinPartCount">
				<xsl:with-param name="baseClass" select="./apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="hasInherited">
			<xsl:call-template name="convertNumberListIntoBoolean">
				<xsl:with-param name="numberList" select="$countList"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:value-of select="$hasInherited"/>
	</xsl:template>
	<xsl:template name="hasInheritedSkinState">
		<xsl:variable name="countList">
			<xsl:call-template name="inheritSkinStateCount">
				<xsl:with-param name="baseClass" select="./apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="hasInherited">
			<xsl:call-template name="convertNumberListIntoBoolean">
				<xsl:with-param name="numberList" select="$countList"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:value-of select="$hasInherited"/>
	</xsl:template>
	<xsl:template name="hasInheritedEffects">
		<xsl:variable name="countList">
			<xsl:call-template name="inheritEffectCount">
				<xsl:with-param name="baseClass" select="./apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="hasInherited">
			<xsl:call-template name="convertNumberListIntoBoolean">
				<xsl:with-param name="numberList" select="$countList"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:value-of select="$hasInherited"/>
	</xsl:template>
	<xsl:template name="hasIncludeExamples">
		<xsl:param name="showIncludeExamples" select="$showIncludeExamples"/>
		<xsl:if test="$showIncludeExamples = 'true'">
			<xsl:value-of select="count(./*[example/codeblock])"/>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getPageLinks">
		<xsl:param name="copyNum" select="'1'"/>
		<xsl:param name="title" select="''"/>
		<xsl:variable name="hasInnerClasses">
			<xsl:call-template name="hasInnerClasses"/>
		</xsl:variable>
		<xsl:variable name="hasConstants">
			<xsl:call-template name="hasConstants"/>
		</xsl:variable>
		<xsl:variable name="hasFields">
			<xsl:call-template name="hasFields"/>
		</xsl:variable>
		<xsl:variable name="hasConstructor">
			<xsl:call-template name="hasConstructor"/>
		</xsl:variable>
		<xsl:variable name="hasMethods">
			<xsl:call-template name="hasMethods"/>
		</xsl:variable>
		<xsl:variable name="hasStyles">
			<xsl:call-template name="hasStyles"/>
		</xsl:variable>
		    <xsl:variable name="hasSkinPart">
		      <xsl:call-template name="hasSkinPart"/>
		    </xsl:variable>
		    <xsl:variable name="hasSkinState">
		      <xsl:call-template name="hasSkinState"/>
		    </xsl:variable>		
		<xsl:variable name="hasEffects">
			<xsl:call-template name="hasEffects"/>
		</xsl:variable>
		<xsl:variable name="hasEvents">
			<xsl:call-template name="hasEvents"/>
		</xsl:variable>
		<xsl:variable name="hasInheritedConstants">
			<xsl:call-template name="hasInheritedConstants"/>
		</xsl:variable>
		<xsl:variable name="hasInheritedFields">
			<xsl:call-template name="hasInheritedFields"/>
		</xsl:variable>
		<xsl:variable name="hasInheritedMethods">
			<xsl:call-template name="hasInheritedMethods"/>
		</xsl:variable>
		<xsl:variable name="hasInheritedStyles">
			<xsl:call-template name="hasInheritedStyles"/>
		</xsl:variable>
		    <xsl:variable name="hasInheritedSkinPart">
		      <xsl:call-template name="hasInheritedSkinPart"/>
		    </xsl:variable>
		    <xsl:variable name="hasInheritedSkinState">
		      <xsl:call-template name="hasInheritedSkinState"/>
		    </xsl:variable>		
		<xsl:variable name="hasInheritedEffects">
			<xsl:call-template name="hasInheritedEffects"/>
		</xsl:variable>
		<xsl:variable name="hasInheritedEvents">
			<xsl:call-template name="hasInheritedEvents"/>
		</xsl:variable>
		<xsl:variable name="hasIncludeExamples">
			<xsl:call-template name="hasIncludeExamples"/>
		</xsl:variable>
		<xsl:variable name="isTopLevel">
			<xsl:call-template name="isTopLevel">
				<xsl:with-param name="packageName" select="../apiName"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:call-template name="getLinks2">
			<xsl:with-param name="subTitle" select="$title"/>
			<xsl:with-param name="packageName" select="../apiName"/>
			<xsl:with-param name="fileName" select="./apiName"/>
			<xsl:with-param name="fileName2">
				<xsl:if test="string-length(../apiName) and $isTopLevel='false'">
					<xsl:value-of select="concat(translate(../apiName,'.','/'),'/class-list.html')"/>
				</xsl:if>
				<xsl:if test="not(string-length(../apiName))">
					<xsl:value-of select="'class-list.html'"/>
				</xsl:if>
			</xsl:with-param>
			<xsl:with-param name="showInnerClasses" select="boolean(number($hasInnerClasses))"/>
			<xsl:with-param name="showConstants">
				<xsl:choose>
					<xsl:when test="$prog_language_name='javascript'"/>
					<xsl:otherwise>
						<xsl:value-of select="boolean(number($hasConstants)) or ($hasInheritedConstants='true')"/>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:with-param>
			<xsl:with-param name="showProperties">
				<xsl:choose>
					<xsl:when test="$prog_language_name='javascript'"/>
					<xsl:otherwise>
						<xsl:value-of select="boolean(number($hasFields)) or ($hasInheritedFields='true')"/>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:with-param>
			<xsl:with-param name="showConstructors" select="false()" />
			<xsl:with-param name="showMethods">
				<xsl:choose>
					<xsl:when test="$prog_language_name='javascript'"/>
					<xsl:otherwise>
						<xsl:value-of select="boolean(number($hasMethods)) or boolean(number($hasConstructor)) or ($hasInheritedMethods='true')"/>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:with-param>
			<xsl:with-param name="showStyles">
				<xsl:choose>
					<xsl:when test="$prog_language_name='javascript'"/>
					<xsl:otherwise>
						<xsl:value-of select="boolean(number($hasStyles)) or ($hasInheritedStyles='true')"/>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:with-param>
		      <xsl:with-param name="showSkinPart">
			<xsl:choose>
			  <xsl:when test="$prog_language_name='javascript'">
			    <xsl:value-of select="false()"/>
			  </xsl:when>
			  <xsl:otherwise>
			    <xsl:value-of select="boolean(number($hasSkinPart)) or ($hasInheritedSkinPart='true')"/>
			  </xsl:otherwise>
			</xsl:choose>
		      </xsl:with-param>
		      <xsl:with-param name="showSkinState">
			<xsl:choose>
			  <xsl:when test="$prog_language_name='javascript'">
			    <xsl:value-of select="false()"/>
			  </xsl:when>
			  <xsl:otherwise>
			    <xsl:value-of select="boolean(number($hasSkinState)) or ($hasInheritedSkinState='true')"/>
			  </xsl:otherwise>
			</xsl:choose>
		      </xsl:with-param>			
			<xsl:with-param name="showEffects">
				<xsl:choose>
					<xsl:when test="$prog_language_name='javascript'"/>
					<xsl:otherwise>
						<xsl:value-of select="boolean(number($hasEffects)) or ($hasInheritedEffects='true')"/>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:with-param>
			<xsl:with-param name="showEvents">
				<xsl:choose>
					<xsl:when test="$prog_language_name='javascript'"/>
					<xsl:otherwise>
						<xsl:value-of select="boolean(number($hasEvents)) or ($hasInheritedEvents='true')"/>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:with-param>
			<xsl:with-param name="showIncludeExamples">
				<xsl:choose>
					<xsl:when test="$prog_language_name='javascript'"/>
					<xsl:otherwise>
						<xsl:value-of select="boolean(number($hasIncludeExamples))"/>
					</xsl:otherwise>
				</xsl:choose>
			</xsl:with-param>
			<xsl:with-param name="copyNum" select="$copyNum"/>
		</xsl:call-template>
	</xsl:template>
	<xsl:template name="processReturnType">
		<xsl:param name="baseRef" select="''"/>
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:choose>
			<xsl:when
				test="./apiOperationDetail/apiOperationDef/apiReturn/apiType/@value='' or ./apiOperationDetail/apiOperationDef/apiReturn/apiType/@value='*' or ./apiOperationDetail/apiOperationDef/apiReturn/apiType/@value='any'">
				<xsl:call-template name="getSpecialTypeLink">
					<xsl:with-param name="type" select="'*'"/>
					<xsl:with-param name="baseRef" select="$baseRef"/>
				</xsl:call-template>
			</xsl:when>
			<xsl:when test="./apiOperationDetail/apiOperationDef/apiReturn/apiType/@value='void'">
				<xsl:call-template name="getSpecialTypeLink">
					<xsl:with-param name="type" select="'void'"/>
					<xsl:with-param name="baseRef" select="$baseRef"/>
				</xsl:call-template>
			</xsl:when>
			<xsl:when test="./apiOperationDetail/apiOperationDef/apiReturn/apiOperationClassifier='Void' and $config/options/@docversion='2'">
				<xsl:value-of select="./apiOperationDetail/apiOperationDef/apiReturn/apiOperationClassifier"/>
			</xsl:when>
			<xsl:when test="./apiOperationDetail/apiOperationDef/apiReturn/apiOperationClassifier">
				<xsl:variable name="destination" select="./apiOperationDetail/apiOperationDef/apiReturn/apiOperationClassifier"/>
				<xsl:variable name="h1" select="substring-after($destination,':')"/>
				<xsl:variable name="h2" select="substring-before($destination,':')"/>
				<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
				<xsl:variable name="gfile" select="concat($baseRef,$destination,'.html')"/>
				<xsl:variable name="hyperLink">
					<xsl:if test="contains($destination,'.')">
						<xsl:if test="$prog_language_name!='javascript'">
							<xsl:value-of select="$file"/>
						</xsl:if>
					</xsl:if>
					<xsl:if test="not(contains($destination,'.'))">
						<xsl:choose>
							<xsl:when test="$prog_language_name='javascript'"/>
							<xsl:otherwise>
								<xsl:value-of select="$gfile"/>
							</xsl:otherwise>
						</xsl:choose>
					</xsl:if>
				</xsl:variable>
				<xsl:if test="$hyperLink = ''">
					<xsl:call-template name="getSimpleClassName">
						<xsl:with-param name="fullClassName" select="./apiOperationDetail/apiOperationDef/apiReturn/apiOperationClassifier"/>
					</xsl:call-template>
				</xsl:if>
				<xsl:if test="$hyperLink != ''">
					<a href="{$hyperLink}">
						<xsl:call-template name="getSimpleClassName">
							<xsl:with-param name="fullClassName" select="./apiOperationDetail/apiOperationDef/apiReturn/apiOperationClassifier"/>
						</xsl:call-template>
					</a>
				</xsl:if>
			</xsl:when>
			<xsl:when test="not(./apiOperationDetail/apiOperationDef/apiReturn/apiOperationClassifier) and ./apiOperationDetail/apiOperationDef/apiReturn/apiType">
				<xsl:call-template name="getSimpleClassName">
					<xsl:with-param name="fullClassName" select="./apiOperationDetail/apiOperationDef/apiReturn/apiType/@value"/>
					<xsl:with-param name="baseRef" select="$baseRef"/>
				</xsl:call-template>
			</xsl:when>
			<xsl:otherwise>
				<xsl:call-template name="getSimpleClassName">
					<xsl:with-param name="fullClassName" select="./apiOperationDetail/apiOperationDef/apiReturn/apiOperationClassifier"/>
				</xsl:call-template>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/class-list.xslt
================================================
<?xml version="1.0" encoding="utf-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://sf.net/saxon" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ifn="urn:internal:functions"
	exclude-result-prefixes="saxon xs ifn">
	<xsl:import href="asdoc-util.xslt"/>
	<xsl:output encoding="UTF-8" method="html" omit-xml-declaration="yes" use-character-maps="disable"/>
	<xsl:param name="outputPath" select="''"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:param name="packages_map_name" select="'packagemap.xml'"/>
	<xsl:variable name="thinsp">
		<xsl:text>&#x2009;</xsl:text>
	</xsl:variable>
	<xsl:template match="/">
		<xsl:for-each select="apiMap//apiItemRef">
			<xsl:sort select="@href" order="ascending"/>
			<xsl:variable name="ditaFileName">
				<xsl:value-of select="concat($ditaFileDir,@href)"/>
			</xsl:variable>
			<xsl:for-each select="document($ditaFileName)/apiPackage">
				<xsl:variable name="name" select="./apiName"/>
				<xsl:variable name="title" select="concat($name,concat(' - ',$title-base))"/>
				<xsl:variable name="isTopLevel">
					<xsl:call-template name="isTopLevel">
						<xsl:with-param name="packageName" select="$name"/>
					</xsl:call-template>
				</xsl:variable>
				<xsl:variable name="classListFile">
					<xsl:value-of select="$outputPath"/>
					<xsl:choose>
						<xsl:when test="$isTopLevel='true'">class-list.html</xsl:when>
						<xsl:otherwise>
							<xsl:value-of select="translate($name,'.','/')"/>/class-list.html</xsl:otherwise>
					</xsl:choose>
				</xsl:variable>
				<xsl:result-document href="{$classListFile}">
					<xsl:copy-of select="$noLiveDocs"/>
					<xsl:copy-of select="$docType"/>
					<xsl:element name="html">
						<head>
							<title>
								<xsl:value-of select="$title"/>
							</title>
							<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
							<base target="classFrame"/>
							<xsl:call-template name="getStyleLink">
								<xsl:with-param name="link" select="/asdoc/link"/>
								<xsl:with-param name="packageName" select="$name"/>
							</xsl:call-template>
						</head>
						<body class="classFrameContent">
							<h3>
								<xsl:choose>
									<xsl:when test="$isTopLevel='true'">
										<a href="package-detail.html" target="classFrame" style="color:black">
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
										</a>
									</xsl:when>
									<xsl:otherwise>
										<a href="package-detail.html" target="classFrame" style="color:black">
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PackagePackage']]/entry[2]/p"/>
											<xsl:value-of select="concat(' ',$name)"/>
										</a>
									</xsl:otherwise>
								</xsl:choose>
							</h3>
							<table cellpadding="0" cellspacing="0">
								<xsl:for-each select="apiValue[not(./apiValueDetail/apiValueDef/apiProperty)]">
									<xsl:sort select="apiName" order="ascending" lang="en-US"/>
									<xsl:variable name="name" select="apiName"/>
									<xsl:if test="position()=1">
										<tr>
											<td>
												<a href="package.html#constantSummary" style="color:black">
													<b>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Constants']]/entry[2]/p"/>
													</b>
												</a>
											</td>
										</tr>
									</xsl:if>
									<tr>
										<td>
											<a href="package.html#{$name}">
												<xsl:value-of select="$name"/>
											</a>
										</td>
									</tr>
									<xsl:if test="position()=last()">
										<tr>
											<td width="10px">
												<xsl:text disable-output-escaping="yes">&amp;nbsp;</xsl:text>
											</td>
										</tr>
									</xsl:if>
								</xsl:for-each>
								<xsl:for-each select="apiValue[./apiValueDetail/apiValueDef/apiProperty]">
									<xsl:sort select="apiName" order="ascending" lang="en-US"/>
									<xsl:variable name="name" select="apiName"/>
									<xsl:if test="position()=1">
										<tr>
											<td>
												<a href="package.html#propertySummary" style="color:black">
													<b>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Properties']]/entry[2]/p"/>
													</b>
												</a>
											</td>
										</tr>
									</xsl:if>
									<tr>
										<td>
											<a href="package.html#{$name}">
												<xsl:value-of select="$name"/>
											</a>
										</td>
									</tr>
									<xsl:if test="position()=last()">
										<tr>
											<td width="10px">
												<xsl:text disable-output-escaping="yes">&amp;nbsp;</xsl:text>
											</td>
										</tr>
									</xsl:if>
								</xsl:for-each>
								<xsl:for-each select="apiOperation">
									<xsl:sort select="apiName" order="ascending" lang="en-US"/>
									<xsl:variable name="name" select="apiName"/>
									<xsl:if test="position()=1">
										<tr>
											<td>
												<a href="package.html#methodSummary" style="color:black">
													<b>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Functions']]/entry[2]/p"/>
													</b>
												</a>
											</td>
										</tr>
									</xsl:if>
									<tr>
										<td>
											<a href="package.html#{$name}()">
												<xsl:value-of select="$name"/>
												<xsl:text>()</xsl:text>
											</a>
										</td>
									</tr>
									<xsl:if test="position()=last()">
										<tr>
											<td width="10px">
												<xsl:text disable-output-escaping="yes">&amp;nbsp;</xsl:text>
											</td>
										</tr>
									</xsl:if>
								</xsl:for-each>
								<xsl:for-each select=".//apiClassifier[apiClassifierDetail/apiClassifierDef/apiInterface]">
									<xsl:sort select="apiName" order="ascending" lang="en-US"/>
									<xsl:variable name="name" select="./apiName"/>
									<xsl:variable name="packageName" select="ancestor::apiPackage/apiName"/>
									<xsl:variable name="baseRef">
										<xsl:call-template name="getBaseRef">
											<xsl:with-param name="packageName" select="$packageName"/>
										</xsl:call-template>
									</xsl:variable>
									<xsl:if test="position()=1">
										<tr>
											<td>
												<a href="package-detail.html#interfaceSummary" style="color:black">
													<b>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Interfaces']]/entry[2]/p"/>
													</b>
												</a>
											</td>
										</tr>
									</xsl:if>
									<tr>
										<td>
											<a href="{$name}.html">
												<i>
													<xsl:value-of select="$name"/>
												</i>
											</a>
											<xsl:choose>
												<xsl:when test="$prog_language_name='javascript'"/>
												<xsl:otherwise>
													<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
														<xsl:call-template name="insertAIRIcon">
															<xsl:with-param name="baseRef" select="$baseRef"/>
														</xsl:call-template>
														<xsl:value-of select="$nbsp"/>
													</xsl:if>
												</xsl:otherwise>
											</xsl:choose>
										</td>
									</tr>
									<xsl:if test="position()=last()">
										<tr>
											<td width="10px">
												<xsl:text disable-output-escaping="yes">&amp;nbsp;</xsl:text>
											</td>
										</tr>
									</xsl:if>
								</xsl:for-each>
								<xsl:for-each select="./apiClassifier[not(./apiClassifierDetail/apiClassifierDef/apiInterface)]">
									<xsl:sort select="apiName" order="ascending" lang="en-US"/>
									<xsl:variable name="name" select="apiName"/>
									<xsl:variable name="packageName" select="ancestor::apiPackage/apiName"/>
									<xsl:variable name="baseRef">
										<xsl:call-template name="getBaseRef">
											<xsl:with-param name="packageName" select="$packageName"/>
										</xsl:call-template>
									</xsl:variable>
									<xsl:if test="position()=1">
										<tr>
											<td>
												<a href="package-detail.html#classSummary" style="color:black">
													<b>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Classes']]/entry[2]/p"/>
													</b>
												</a>
											</td>
										</tr>
									</xsl:if>
									<tr>
										<td>
											<a href="{$name}.html">
												<xsl:value-of select="$name"/>
											</a>
											<xsl:choose>
												<xsl:when test="$prog_language_name='javascript'"/>
												<xsl:otherwise>
													<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
														<xsl:call-template name="insertAIRIcon">
															<xsl:with-param name="baseRef" select="$baseRef"/>
														</xsl:call-template>
														<xsl:value-of select="$nbsp"/>
													</xsl:if>
												</xsl:otherwise>
											</xsl:choose>
										</td>
									</tr>
								</xsl:for-each>
							</table>
						</body>
					</xsl:element>
					<xsl:copy-of select="$copyrightComment"/>
				</xsl:result-document>
			</xsl:for-each>
		</xsl:for-each>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/class-parts.xslt
================================================
<?xml version="1.0" encoding="utf-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://sf.net/saxon" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ifn="urn:internal:functions" xmlns:fn="http://www.w3.org/2005/xpath-functions"
	exclude-result-prefixes="saxon xs ifn">
	<xsl:import href="asdoc-util.xslt"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:param name="outPath" select="''"/>
	<xsl:param name="dita.package" select="'packages.dita'"/>
	<xsl:param name="prog_language_name" select="''"/>
	<xsl:template name="getAncestorProperty">
		<xsl:param name="isConst" select="'false'"/>
		<xsl:param name="accessLevel" select="'public'"/>
		<xsl:param name="baseClass"/>
		<xsl:param name="propertyList"/>
		<xsl:param name="processParentClass" select="true()"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="'__Global__'"/>
			</xsl:if>
		</xsl:variable>
		<xsl:if test="$isConst='true'">
			<xsl:for-each select="$field_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/apiValue[not(apiValueDetail/apiValueDef/apiProperty) and apiValueDetail/apiValueDef/apiAccess/@value =$accessLevel]">
				<xsl:if test="not(contains($propertyList,concat(' ',apiName,' ')))">
					<xsl:copy-of select="."/>
				</xsl:if>
			</xsl:for-each>
		</xsl:if>
		<xsl:if test="$isConst='false'">
			<xsl:for-each select="$field_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/apiValue[apiValueDetail/apiValueDef/apiProperty and apiValueDetail/apiValueDef/apiAccess/@value =$accessLevel or apiValueDetail/apiValueDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.]">
				<xsl:if test="not(contains($propertyList,concat(' ',apiName,' ')))">
					<xsl:copy-of select="."/>
				</xsl:if>
			</xsl:for-each>
		</xsl:if>
		<xsl:if test="$baseClass !='Object' and $processParentClass = true()">
			<!-- do not make a recursive call when processing interfaces -->
			<xsl:variable name="newPropertyList">
				<xsl:if test="$isConst='true'">
					<xsl:for-each
						select="$field_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/apiValue[not(./apiValueDetail/apiValueDef/apiProperty) and (./apiValueDetail/apiValueDef/apiAccess/@value=$accessLevel or ./apiValueDetail/apiValueDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.)]">
						<xsl:text> </xsl:text>
						<xsl:value-of select="./apiName"/>
						<xsl:text> </xsl:text>
					</xsl:for-each>
				</xsl:if>
				<xsl:if test="$isConst='false'">
					<xsl:for-each
						select="$field_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/apiValue[./apiValueDetail/apiValueDef/apiProperty and (./apiValueDetail/apiValueDef/apiAccess/@value=$accessLevel or ./apiValueDetail/apiValueDef/apiAccess/@value=$config/namespaces/namespace[@summaryDisplay=$accessLevel]/.)]">
						<xsl:text> </xsl:text>
						<xsl:value-of select="./apiName"/>
						<xsl:text> </xsl:text>
					</xsl:for-each>
				</xsl:if>
			</xsl:variable>
			<xsl:call-template name="getAncestorProperty">
				<xsl:with-param name="isConst" select="$isConst"/>
				<xsl:with-param name="accessLevel" select="$accessLevel"/>
				<xsl:with-param name="baseClass" select="$field_map[@id=$xslDocPath]/apiClassifier[@id=$baseClass or apiName=$baseClass]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
				<xsl:with-param name="propertyList" select="concat($propertyList,$newPropertyList)"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>
	<xsl:template name="inheritPropertyCount">
		<xsl:param name="isConst" select="'false'"/>
		<xsl:param name="accessLevel" select="'public'"/>
		<xsl:param name="baseClass"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="'__Global__'"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="countAttribute">
			<xsl:if test="$isConst='true'">
				<xsl:text> </xsl:text>
				<xsl:value-of
					select="count($field_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/apiValue[not(apiValueDetail/apiValueDef/apiProperty) and apiValueDetail/apiValueDef/apiAccess/@value =$accessLevel])"/>
				<xsl:text> </xsl:text>
			</xsl:if>
			<xsl:if test="$isConst='false'">
				<xsl:text> </xsl:text>
				<xsl:value-of select="count($field_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/apiValue[apiValueDetail/apiValueDef/apiProperty and apiValueDetail/apiValueDef/apiAccess/@value =$accessLevel])"/>
				<xsl:text> </xsl:text>
			</xsl:if>
		</xsl:variable>
		<xsl:value-of select="$countAttribute"/>
		<xsl:if test="$baseClass !='Object'">
			<xsl:variable name="xslDocPath">
				<xsl:if test="contains($baseClass,':')">
					<xsl:value-of select="substring-before($baseClass,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($baseClass,':'))">
					<xsl:value-of select="'__Global__'"/>
				</xsl:if>
			</xsl:variable>
			<xsl:call-template name="inheritPropertyCount">
				<xsl:with-param name="isConst" select="$isConst"/>
				<xsl:with-param name="accessLevel" select="$accessLevel"/>
				<xsl:with-param name="baseClass" select="$field_map[@id=$xslDocPath]/apiClassifier[@id=$baseClass or apiName=$baseClass]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getMethodAncestors">
		<xsl:param name="baseRef"/>
		<xsl:param name="accessLevel" select="'public'"/>
		<xsl:param name="baseClass"/>
		<xsl:param name="methodList" select="''"/>
		<xsl:param name="processParentClass" select="true()"/>
		<xsl:param name="classDeprecated"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="'__Global__'"/>
			</xsl:if>
		</xsl:variable>
		<xsl:for-each
			select="$method_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/apiOperation[apiOperationDetail/apiOperationDef/apiAccess/@value =$accessLevel or ($accessLevel='public' and apiOperationDetail/apiOperationDef/apiAccess/@value='AS3')]">
			<xsl:if test="not(contains($methodList,concat(' ',apiName,' ')))">
				<xsl:copy-of select="."/>
			</xsl:if>
		</xsl:for-each>
		<xsl:if test="$baseClass !='Object' and $processParentClass = true()">
			<xsl:variable name="newMethodList">
				<xsl:for-each
					select="$method_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/apiOperation[apiOperationDetail/apiOperationDef/apiAccess/@value =$accessLevel or ($accessLevel='public' and apiOperationDetail/apiOperationDef/apiAccess/@value='AS3')]">
					<xsl:text> </xsl:text>
					<xsl:value-of select="./apiName"/>
					<xsl:text> </xsl:text>
				</xsl:for-each>
			</xsl:variable>
			<xsl:variable name="xslDocPath">
				<xsl:if test="contains($baseClass,':')">
					<xsl:value-of select="substring-before($baseClass,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($baseClass,':'))">
					<xsl:value-of select="'__Global__'"/>
				</xsl:if>
			</xsl:variable>
			<xsl:call-template name="getMethodAncestors">
				<xsl:with-param name="accessLevel" select="$accessLevel"/>
				<xsl:with-param name="baseClass" select="$method_map[@id=$xslDocPath]/apiClassifier[@id=$baseClass or apiName=$baseClass]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
				<xsl:with-param name="methodList" select="concat($methodList,' ', $newMethodList)"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>
	<xsl:template name="inheritMethodCount">
		<xsl:param name="accessLevel" select="'public'"/>
		<xsl:param name="baseClass"/>
		<xsl:param name="methodList" select="''"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="'__Global__'"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="countAttribute">
			<xsl:text> </xsl:text>
			<xsl:value-of
				select="count($method_map[@id=$xslDocPath]//apiClassifier[apiName=$className and apiOperation/apiOperationDetail/apiOperationDef/apiAccess[@value=$accessLevel or apiConstructor/apiConstructorDetail/apiConstructorDef/apiAccess/@value =$accessLevel]])"/>
			<xsl:text> </xsl:text>
		</xsl:variable>
		<xsl:value-of select="$countAttribute"/>
		<xsl:if test="$baseClass !='Object'">
			<xsl:variable name="newMethodList">
				<xsl:for-each
					select="$method_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/apiOperation[apiOperationDetail/apiOperationDef/apiAccess/@value =$accessLevel or ($accessLevel='public' and apiOperationDetail/apiOperationDef/apiAccess/@value='AS3')]">
					<xsl:text> </xsl:text>
					<xsl:value-of select="./apiName"/>
					<xsl:text> </xsl:text>
				</xsl:for-each>
			</xsl:variable>
			<xsl:variable name="xslDocPath">
				<xsl:if test="contains($baseClass,':')">
					<xsl:value-of select="substring-before($baseClass,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($baseClass,':'))">
					<xsl:value-of select="'__Global__'"/>
				</xsl:if>
			</xsl:variable>
			<xsl:call-template name="inheritMethodCount">
				<xsl:with-param name="accessLevel" select="$accessLevel"/>
				<xsl:with-param name="baseClass" select="$method_map[@id=$xslDocPath]/apiClassifier[@id=$baseClass or apiName=$baseClass]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
				<xsl:with-param name="methodList" select="concat($methodList,' ', $newMethodList)"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>
	<xsl:template name="doesValueExistsInList">
		<xsl:param name="valueToFind" select="''"/>
		<xsl:param name="givenList" select="''"/>
		<!--If the method or processMethod List is blank return false indicating the method has not been processed-->
		<xsl:if test="string-length($valueToFind) = 0 or string-length(normalize-space($givenList)) = 0 ">
			<xsl:value-of select="'false'"/>
		</xsl:if>
		<xsl:variable name="valueSet" select="tokenize($givenList,' ')"/>
		<xsl:for-each select="$valueSet">
			<xsl:if test=". = $valueToFind">
				<xsl:value-of select="'true'"/>
			</xsl:if>
		</xsl:for-each>
	</xsl:template>
	<xsl:template name="inheritEventCount">
		<xsl:param name="baseClass"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="'__Global__'"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="countAttribute">
			<xsl:text> </xsl:text>
			<xsl:value-of select="count($event_map[@id=$xslDocPath]/apiClassifier[apiName=$className]/adobeApiEvent[not(adobeApiEventDetail/adobeApiEventDef/apiDefinedEvent)])"/>
			<xsl:text> </xsl:text>
		</xsl:variable>
		<xsl:value-of select="$countAttribute"/>
		<xsl:if test="$baseClass !='Object'">
			<xsl:variable name="xslDocPath">
				<xsl:if test="contains($baseClass,':')">
					<xsl:value-of select="substring-before($baseClass,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($baseClass,':'))">
					<xsl:value-of select="'__Global__'"/>
				</xsl:if>
			</xsl:variable>
			<xsl:call-template name="inheritEventCount">
				<xsl:with-param name="baseClass" select="$event_map[@id=$xslDocPath]/apiClassifier[@id=$baseClass or apiName=$className]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getInheritedEvent">
		<xsl:param name="baseClass"/>
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:param name="eventsList"/>
		<xsl:param name="processParentClass" select="true()"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="'__Global__'"/>
			</xsl:if>
		</xsl:variable>
		<xsl:for-each select="$event_map[@id=$xslDocPath]/apiClassifier[apiName=$className]/adobeApiEvent[not(adobeApiEventDetail/adobeApiEventDef/apiDefinedEvent)]">
			<xsl:if test="not(contains($eventsList,concat(' ',apiName,' ')))">
				<xsl:copy-of select="."/>
			</xsl:if>
		</xsl:for-each>
		<xsl:if test="$baseClass !='Object' and $processParentClass = true()">
			<xsl:variable name="newEventsList">
				<xsl:for-each select="$event_map[@id=$xslDocPath]/apiClassifier[apiName=$className]/adobeApiEvent[not(adobeApiEventDetail/adobeApiEventDef/apiDefinedEvent)]">
					<xsl:text> </xsl:text>
					<xsl:value-of select="./apiName"/>
					<xsl:text> </xsl:text>
				</xsl:for-each>
			</xsl:variable>
			<xsl:call-template name="getInheritedEvent">
				<xsl:with-param name="baseClass" select="$event_map[@id=$xslDocPath]/apiClassifier[@id=$baseClass or apiName=$className]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
				<xsl:with-param name="currentPackage" select="$currentPackage"/>
				<xsl:with-param name="eventsList" select="concat($eventsList,' ', $newEventsList)"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>
	<xsl:template name="inheritStyleCount">
		<xsl:param name="baseClass"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="'__Global__'"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="countAttribute">
			<xsl:text> </xsl:text>
			<xsl:value-of select="count($style_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/prolog/asMetadata[styles/style])"/>
			<xsl:text> </xsl:text>
		</xsl:variable>
		<xsl:value-of select="$countAttribute"/>
		<xsl:if test="$baseClass !='Object'">
			<xsl:call-template name="inheritStyleCount">
				<xsl:with-param name="baseClass" select="$style_map[@id=$xslDocPath]/apiClassifier[@id=$baseClass or apiName=$baseClass]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>
	
	<xsl:template name="inheritSkinStateCount">
		<xsl:param name="baseClass"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="'__Global__'"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="countAttribute">
			<xsl:text> </xsl:text>
			<xsl:value-of select="count($classHeader_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/prolog/asMetadata[skinStates/SkinState])"/>
			<xsl:text> </xsl:text>
		</xsl:variable>
		<xsl:value-of select="$countAttribute"/>
		<xsl:if test="$baseClass !='Object'">
			<xsl:call-template name="inheritSkinStateCount">
				<xsl:with-param name="baseClass" select="$classHeader_map[@id=$xslDocPath]/apiClassifier[@id=$baseClass or apiName=$baseClass]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>
	<xsl:template name="inheritSkinPartCount">
		<xsl:param name="baseClass"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="'__Global__'"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="countAttribute">
			<xsl:text> </xsl:text>
			<xsl:value-of select="count($classHeader_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/prolog/asMetadata[skinParts/SkinPart])"/>
			<xsl:text> </xsl:text>
		</xsl:variable>
		<xsl:value-of select="$countAttribute"/>
		<xsl:if test="$baseClass !='Object'">
			<xsl:call-template name="inheritSkinPartCount">
				<xsl:with-param name="baseClass" select="$classHeader_map[@id=$xslDocPath]/apiClassifier[@id=$baseClass or apiName=$baseClass]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>	
	<xsl:template name="getInheritedStyle">
		<xsl:param name="baseClass"/>
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:param name="stylesList"/>
		<xsl:param name="processParentClass" select="true()"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="'__Global__'"/>
			</xsl:if>
		</xsl:variable>
		<xsl:for-each select="$style_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/prolog/asMetadata/styles/style">
			<xsl:if test="not(contains($stylesList,concat(' ',@name,' ')))">
				<xsl:copy-of select="."/>
			</xsl:if>
		</xsl:for-each>
		<xsl:if test="$baseClass !='Object' and $processParentClass=true()">
			<xsl:variable name="newStylesList">
				<xsl:for-each select="$style_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/prolog/asMetadata/styles/style">
					<xsl:value-of select="concat(' ',@name,' ')"/>
				</xsl:for-each>
			</xsl:variable>
			<xsl:call-template name="getInheritedStyle">
				<xsl:with-param name="baseClass" select="$style_map[@id=$xslDocPath]/apiClassifier[@id=$baseClass or apiName=$baseClass]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
				<xsl:with-param name="currentPackage" select="$currentPackage"/>
				<xsl:with-param name="stylesList" select="concat($stylesList,' ',$newStylesList)"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getInheritedSkinState">
		<xsl:param name="baseClass"/>
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:param name="SkinStateList"/>
		<xsl:param name="processParentClass" select="true()"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="'__Global__'"/>
			</xsl:if>
		</xsl:variable>
		<xsl:for-each select="$classHeader_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/prolog/asMetadata/skinStates/SkinState">
			<xsl:if test="not(contains($SkinStateList,concat(' ',@name,' ')))">
				<xsl:copy-of select="."/>
			</xsl:if>
		</xsl:for-each>
		<xsl:if test="$baseClass !='Object' and $processParentClass=true()">
			<xsl:variable name="newSkinStateList">
				<xsl:for-each select="$classHeader_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/prolog/asMetadata/skinStates/SkinState">
					<xsl:value-of select="concat(' ',@name,' ')"/>
				</xsl:for-each>
			</xsl:variable>
			<xsl:call-template name="getInheritedSkinState">
				<xsl:with-param name="baseClass" select="$classHeader_map[@id=$xslDocPath]/apiClassifier[@id=$baseClass or apiName=$baseClass]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
				<xsl:with-param name="currentPackage" select="$currentPackage"/>
				<xsl:with-param name="SkinStateList" select="concat($SkinStateList,' ',$newSkinStateList)"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getInheritedSkinPart">
		<xsl:param name="baseClass"/>
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:param name="SkinPartList"/>
		<xsl:param name="processParentClass" select="true()"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="'__Global__'"/>
			</xsl:if>
		</xsl:variable>
		<xsl:for-each select="$classHeader_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/prolog/asMetadata/skinParts/SkinPart">
			<xsl:if test="not(contains($SkinPartList,concat(' ',@name,' ')))">
				<xsl:copy-of select="."/>
			</xsl:if>
		</xsl:for-each>
		<xsl:if test="$baseClass !='Object' and $processParentClass=true()">
			<xsl:variable name="newSkinPartList">
				<xsl:for-each select="$classHeader_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/prolog/asMetadata/skinParts/SkinPart">
					<xsl:value-of select="concat(' ',@name,' ')"/>
				</xsl:for-each>
			</xsl:variable>
			<xsl:call-template name="getInheritedSkinPart">
				<xsl:with-param name="baseClass" select="$classHeader_map[@id=$xslDocPath]/apiClassifier[@id=$baseClass or apiName=$baseClass]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
				<xsl:with-param name="currentPackage" select="$currentPackage"/>
				<xsl:with-param name="SkinPartList" select="concat($SkinPartList,' ',$newSkinPartList)"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>	
	<xsl:template name="inheritEffectCount">
		<xsl:param name="baseClass"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="'__Global__'"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="countAttribute">
			<xsl:text> </xsl:text>
			<xsl:value-of select="count($effect_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/prolog/asMetadata[effects/effect])"/>
			<xsl:text> </xsl:text>
		</xsl:variable>
		<xsl:value-of select="$countAttribute"/>
		<xsl:if test="$baseClass !='Object'">
			<xsl:variable name="xslDocPath">
				<xsl:if test="contains($baseClass,':')">
					<xsl:value-of select="substring-before($baseClass,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($baseClass,':'))">
					<xsl:value-of select="'__Global__'"/>
				</xsl:if>
			</xsl:variable>
			<xsl:call-template name="inheritEffectCount">
				<xsl:with-param name="baseClass" select="$effect_map[@id=$xslDocPath]/apiClassifier[@id=$baseClass or apiName=$baseClass]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getInheritedEffect">
		<xsl:param name="baseClass"/>
		<xsl:param name="currentPackage"/>
		<xsl:param name="effectsList"/>
		<xsl:param name="processParentClass" select="true()"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="'__Global__'"/>
			</xsl:if>
		</xsl:variable>
		<xsl:for-each select="$effect_map[@id=$xslDocPath]//apiClassifier[apiName=$className]/prolog/asMetadata/effects/effect">
			<xsl:if test="not(contains($effectsList,concat(' ',@name,' ')))">
				<xsl:copy-of select="."/>
			</xsl:if>
		</xsl:for-each>
		<xsl:if test="$baseClass !='Object' and $processParentClass = true()">
			<xsl:variable name="newEffectsList">
				<xsl:for-each select="$effect_map[@id=$xslDocPath]/apiClassifier[apiName=$className]/asMetadata/effects/effect">
					<xsl:text> </xsl:text>
					<xsl:value-of select="@name"/>
					<xsl:text> </xsl:text>
				</xsl:for-each>
			</xsl:variable>
			<xsl:call-template name="getInheritedEffect">
				<xsl:with-param name="baseClass" select="$effect_map[@id=$xslDocPath]/apiClassifier[@id=$baseClass or apiName=$baseClass]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
				<xsl:with-param name="currentPackage" select="$currentPackage"/>
				<xsl:with-param name="effectsList" select="concat($effectsList,' ',$newEffectsList )"/>
			</xsl:call-template>
		</xsl:if>
	</xsl:template>
	<xsl:template match="DefaultProperty">
		<p>
			<span class="classHeaderTableLabel">
				<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DefaultMXMLProperty']]/entry[2]/p"/>
			</span>
			<code>
				<xsl:value-of select="@name"/>
			</code>
		</p>
	</xsl:template>
	<xsl:template name="classHeader">
		<xsl:param name="classNode"/>
		<xsl:param name="classDeprecated"/>
		<xsl:variable name="packageName" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:variable name="baseRef">
			<xsl:call-template name="getBaseRef">
				<xsl:with-param name="packageName" select="$packageName"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:variable name="ID" select="@id"/>
		<xsl:variable name="isTopLevel">
			<xsl:call-template name="isTopLevel">
				<xsl:with-param name="packageName" select="$packageName"/>
			</xsl:call-template>
		</xsl:variable>
		<xsl:for-each select="$classNode">
			<xsl:call-template name="getPageLinks">
				<xsl:with-param name="title">
					<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface">
						<xsl:value-of select="./apiName"/>
					</xsl:if>
					<xsl:if test="not(./apiClassifierDetail/apiClassifierDef/apiInterface)">
						<xsl:value-of select="./apiName"/>
					</xsl:if>
				</xsl:with-param>
			</xsl:call-template>
		</xsl:for-each>
		<div class="MainContent">
			<xsl:variable name="id" select="@id"/>
			<xsl:apply-templates mode="annotate"
				select="$config/annotate/item[@type='class' and ((@name=translate($id,':','.') and (not(string-length(@packageName)) or @packageName=$packageName)) or (not(string-length(@name)) and string-length(@packageName) and tokenize(@packageName,',')[starts-with($packageName,.)]))]"/>
			<table class="classHeaderTable" cellpadding="0" cellspacing="0">
				<tr>
					<td class="classHeaderTableLabel">
						<xsl:choose>
							<xsl:when test="$prog_language_name='javascript'"/>
							<xsl:otherwise>
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PackagePackage']]/entry[2]/p"/>
							</xsl:otherwise>
						</xsl:choose>
					</td>
					<td>
						<xsl:choose>
							<xsl:when test="$prog_language_name='javascript'"/>
							<xsl:otherwise>
								<a href="package-detail.html" onclick="javascript:loadClassListFrame('class-list.html')">
									<xsl:if test="string-length(../apiName) &gt; 0 and not($isTopLevel='true')">
										<xsl:value-of select="../apiName"/>
									</xsl:if>
									<xsl:if test="$isTopLevel='true'">
										<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
									</xsl:if>
								</a>
							</xsl:otherwise>
						</xsl:choose>
					</td>
				</tr>
				<tr>
					<xsl:if test="not(.//apiClassifierDef/apiInterface)">
						<xsl:choose>
							<xsl:when test="$prog_language_name='javascript'"/>
							<xsl:otherwise>
								<td class="classHeaderTableLabel">Class</td>
							</xsl:otherwise>
						</xsl:choose>
					</xsl:if>
					<xsl:if test=".//apiClassifierDef/apiInterface">
						<xsl:choose>
							<xsl:when test="$prog_language_name='javascript'"/>
							<xsl:otherwise>
								<td class="classHeaderTableLabel">Interface</td>
							</xsl:otherwise>
						</xsl:choose>
					</xsl:if>
					<td class="classSignature">
						<xsl:choose>
							<xsl:when test="$prog_language_name='javascript'"/>
							<xsl:otherwise>
								<xsl:value-of select="./apiClassifierDetail/apiClassifierDef/apiAccess/@value"/>
								<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiFinal">
									<xsl:text> final </xsl:text>
								</xsl:if>
								<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiDynamic">
									<xsl:text> dynamic </xsl:text>
								</xsl:if>
								<xsl:text> </xsl:text>
								<xsl:if test="not(./apiClassifierDetail/apiClassifierDef/apiInterface)">
									<xsl:text> class </xsl:text>
								</xsl:if>
								<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface">
									<xsl:text> interface </xsl:text>
								</xsl:if>
								<xsl:text> </xsl:text>
								<xsl:value-of select="./apiName"/>
								<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface and ./apiClassifierDetail/Inheritancelist/BaseInterface/Interface">
									<xsl:text> extends </xsl:text>
								</xsl:if>
								<xsl:for-each select="./apiClassifierDetail/Inheritancelist/BaseInterface/Interface/@id">
									<xsl:variable name="text" select="."/>
									<xsl:for-each select="$text">
										<xsl:sort select="substring-after(text(),':')" order="ascending" data-type="text" lang="en-US"/>
									</xsl:for-each>
									<xsl:variable name="h2" select="substring-before($text,':')"/>
									<xsl:variable name="h1" select="substring-after($text,':')"/>
									<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
									<xsl:text> </xsl:text>
									
									<xsl:if test="count($classHeader_map//apiClassifier[@id=$text] ) &gt; 0">
										<a>
											<xsl:attribute name="href">
												<xsl:value-of select="$file"/>
											</xsl:attribute>
											<xsl:value-of select="$h1"/>
										</a>
									</xsl:if>
									<xsl:if test="not(count($classHeader_map//apiClassifier[@id=$text] ) &gt; 0)">
										<xsl:if test="not(contains($text,':'))">
											<xsl:value-of select="$text"/>
										</xsl:if>
										<xsl:if test="contains($text,':')">
											<xsl:value-of select="concat($h2,concat('.',$h1))"/>
										</xsl:if>
									</xsl:if>
									
									<xsl:text></xsl:text>
									<xsl:if test="position() != last()">
										<xsl:text>, </xsl:text>
									</xsl:if>
								</xsl:for-each>
							</xsl:otherwise>
						</xsl:choose>
					</td>
				</tr>
				<xsl:if test="not(./apiClassifierDetail/apiClassifierDef/apiInterface) and ./apiClassifierDetail/Inheritancelist/Inheritance/Inherit/@id">
					<tr>
						<td class="classHeaderTableLabel">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Inheritance']]/entry[2]/p"/>
						</td>
						<td class="inheritanceList">
							<xsl:value-of select="./apiName"/>
							<xsl:text> </xsl:text>
							<xsl:for-each select="./apiClassifierDetail/Inheritancelist/Inheritance/Inherit">
								<xsl:variable name="val" select="@id"/>
								<xsl:choose>
									<xsl:when test="not(@id)"/>
									<xsl:otherwise>
										<xsl:if test="$prog_language_name='javascript'" />
										<xsl:if test="$prog_language_name!='javascript'">
											<xsl:variable name="h2" select="substring-before($val,':')"/>
											<xsl:variable name="h1" select="substring-after($val,':')"/>
											<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
											<xsl:if test="not(contains($val,':'))">
												<xsl:variable name="global" select="$val"/>
												<xsl:if test="contains(ancestor::apiClassifier/@id,'globalClassifier:')">
													<xsl:variable name="gfile" select="concat($val,'.html')"/>
													<xsl:variable name="iconRef">
														<xsl:text>images/inherit-arrow.gif</xsl:text>
													</xsl:variable>
													<xsl:text> </xsl:text>
													<img src="{$iconRef}" title="Inheritance" alt="Inheritance" class="inheritArrow"/>
													<xsl:text> </xsl:text>
													<xsl:if test="count($classHeader_map//apiClassifier[@id=$val] ) &gt; 0">
														<a>
															<xsl:attribute name="href">
																<xsl:value-of select="$gfile"/>
															</xsl:attribute>
															<xsl:value-of select="$val"/>
														</a>
													</xsl:if>
													<xsl:if test="not(count($classHeader_map//apiClassifier[@id=$val] ) &gt; 0)">
														<xsl:value-of select="$val"/>
													</xsl:if>
												</xsl:if>
												<xsl:if test="not(contains(ancestor::apiClassifier/@id,'globalClassifier:'))">
													<xsl:variable name="file1" select="concat($baseRef,$val,'.html')"/>
													<xsl:variable name="iconRef">
														<xsl:text>images/inherit-arrow.gif</xsl:text>
													</xsl:variable>
													<xsl:text> </xsl:text>
													<img src="{$baseRef}{$iconRef}" title="Inheritance" alt="Inheritance" class="inheritArrow"/>
													<xsl:text> </xsl:text>
													<xsl:if test="count($classHeader_map//apiClassifier[@id=$val] ) &gt; 0">
														<a>
															<xsl:attribute name="href">
																<xsl:value-of select="$file1"/>
															</xsl:attribute>
															<xsl:value-of select="$val"/>
														</a>
													</xsl:if>
													<xsl:if test="not(count($classHeader_map//apiClassifier[@id=$val] ) &gt; 0)">
														<xsl:value-of select="$val"/>
													</xsl:if>
												</xsl:if>
											</xsl:if>
											<xsl:if test="contains($val,':')">
												<xsl:variable name="iconRef">
													<xsl:text>images/inherit-arrow.gif</xsl:text>
												</xsl:variable>
												<xsl:text> </xsl:text>
												<img src="{$baseRef}{$iconRef}" title="Inheritance" alt="Inheritance" class="inheritArrow"/>
												<xsl:text> </xsl:text>
												<xsl:if test="count($classHeader_map//apiClassifier[@id=$val] ) &gt; 0">
													<a>
														<xsl:attribute name="href">
															<xsl:value-of select="$file"/>
														</xsl:attribute>
														<xsl:value-of select="$h1"/>
													</a>
												</xsl:if>
												<xsl:if test="not(count($classHeader_map//apiClassifier[@id=$val] ) &gt; 0)">
													<xsl:value-of select="concat($h2,concat('.',$h1))"/>
												</xsl:if>
											</xsl:if>
										</xsl:if>
									</xsl:otherwise>
								</xsl:choose>
							</xsl:for-each>
						</td>
					</tr>
				</xsl:if>
				<xsl:if test="not(./apiClassifierDetail/apiClassifierDef/apiInterface) and count(./apiClassifierDetail/Inheritancelist/Implements/Implement) &gt; 0">
					<xsl:choose>
						<xsl:when test="$prog_language_name='javascript'"/>
						<xsl:otherwise>
							<tr>
								<td class="classHeaderTableLabel">Implements</td>
								<td>
									<xsl:for-each select="./apiClassifierDetail/Inheritancelist/Implements/Implement">
										<xsl:variable name="val" select="@id"/>
										<xsl:variable name="h2" select="substring-before($val,':')"/>
										<xsl:variable name="h1" select="substring-after($val,':')"/>
										<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
										<xsl:if test="not(contains($val,':'))">
											<xsl:variable name="file1" select="concat($baseRef,$val,'.html')"/>
											<xsl:text> </xsl:text>
											<xsl:if test="count($classHeader_map//apiClassifier[@id=$val] ) &gt; 0">
												<a>
													<xsl:attribute name="href">
														<xsl:value-of select="$file1"/>
													</xsl:attribute>
													<xsl:value-of select="$val"/>
												</a>
											</xsl:if>
											<xsl:if test="not(count($classHeader_map//apiClassifier[@id=$val] ) &gt; 0)">
												<xsl:value-of select="$val"/>
											</xsl:if>
										</xsl:if>
										<xsl:if test="contains($val,':')">
											<xsl:text> </xsl:text>
											<xsl:if test="count($classHeader_map//apiClassifier[@id=$val] ) &gt; 0">
												<a>
													<xsl:attribute name="href">
														<xsl:value-of select="$file"/>
													</xsl:attribute>
													<xsl:value-of select="$h1"/>
												</a>
											</xsl:if>
											<xsl:if test="not(count($classHeader_map//apiClassifier[@id=$val] ) &gt; 0)">
												<xsl:value-of select="concat($h2,concat('.',$h1))"/>
											</xsl:if>
										</xsl:if>
										<xsl:if test="position() != last()">
											<xsl:text>, </xsl:text>
										</xsl:if>
									</xsl:for-each>
								</td>
							</tr>
						</xsl:otherwise>
					</xsl:choose>
				</xsl:if>
				<xsl:if test="not(./apiClassifierDetail/apiClassifierDef/apiInterface)">
					<xsl:if test="./apiClassifierDetail/Inheritancelist/Subclasses/class">
						<xsl:choose>
							<xsl:when test="$prog_language_name='javascript'"/>
							<xsl:otherwise>
								<tr>
									<td class="classHeaderTableLabel">
										<xsl:text>Subclasses</xsl:text>
									</td>
									<td>
										<xsl:for-each select="./apiClassifierDetail/Inheritancelist/Subclasses/class">
											<xsl:sort select="substring-after(@id,':')" order="ascending" data-type="text" lang="en-US"/>
											<xsl:if test="not(contains(@id,'globalClassifier:'))">
												<xsl:variable name="val" select="@id"/>
												<xsl:variable name="h2" select="substring-before($val,':')"/>
												<xsl:variable name="h1" select="substring-after($val,':')"/>
												<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
												<xsl:if test="not(contains($val,':'))">
													<xsl:variable name="file1" select="concat($baseRef,$val,'.html')"/>
													<xsl:text> </xsl:text>
													<a>
														<xsl:attribute name="href">
															<xsl:value-of select="$file1"/>
														</xsl:attribute>
														<xsl:value-of select="$val"/>
													</a>
												</xsl:if>
												<xsl:if test="contains($val,':')">
													<xsl:text> </xsl:text>
													<a>
														<xsl:attribute name="href">
															<xsl:value-of select="$file"/>
														</xsl:attribute>
														<xsl:value-of select="$h1"/>
													</a>
												</xsl:if>
												<xsl:if test="position() != last()">
													<xsl:text>, </xsl:text>
												</xsl:if>
											</xsl:if>
											<xsl:if test="contains(@id,'globalClassifier:')">
												<xsl:variable name="val" select="substring-after(@id, 'globalClassifier:')"/>
												<xsl:variable name="h2" select="substring-before($val,':')"/>
												<xsl:variable name="h1" select="substring-after($val,':')"/>
												<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
												<xsl:if test="not(contains($val,':'))">
													<xsl:variable name="file1" select="concat($baseRef,$val,'.html')"/>
													<xsl:text> </xsl:text>
													<a>
														<xsl:attribute name="href">
															<xsl:value-of select="$file1"/>
														</xsl:attribute>
														<xsl:value-of select="$val"/>
													</a>
												</xsl:if>
												<xsl:if test="contains($val,':')">
													<xsl:text> </xsl:text>
													<a>
														<xsl:attribute name="href">
															<xsl:value-of select="$file"/>
														</xsl:attribute>
														<xsl:value-of select="$h1"/>
													</a>
												</xsl:if>
												<xsl:if test="position() != last()">
													<xsl:text>, </xsl:text>
												</xsl:if>
											</xsl:if>
										</xsl:for-each>
									</td>
								</tr>
							</xsl:otherwise>
						</xsl:choose>
					</xsl:if>
				</xsl:if>
				<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface and ./apiClassifierDetail/Inheritancelist/Implementors/Implementor">
					<tr>
						<td class="classHeaderTableLabel">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Implementors']]/entry[2]/p"/>
						</td>
						<td>
							<xsl:for-each select="./apiClassifierDetail/Inheritancelist/Implementors/Implementor">
								<xsl:if test="not(contains(@id,'globalClassifier:'))">
									<xsl:variable name="val" select="@id"/>
									<xsl:variable name="h2" select="substring-before($val,':')"/>
									<xsl:variable name="h1" select="substring-after($val,':')"/>
									<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
									<xsl:if test="not(contains($val,':'))">
										<xsl:variable name="file1" select="concat($baseRef,$val,'.html')"/>
										<xsl:text> </xsl:text>
										<xsl:choose>
											<xsl:when test="$prog_language_name='javascript'"/>
											<xsl:otherwise>
												<a>
													<xsl:attribute name="href">
														<xsl:value-of select="$file1"/>
													</xsl:attribute>
													<xsl:value-of select="$val"/>
												</a>
											</xsl:otherwise>
										</xsl:choose>
									</xsl:if>
									<xsl:if test="contains($val,':')">
										<xsl:text> </xsl:text>
										<a>
											<xsl:attribute name="href">
												<xsl:value-of select="$file"/>
											</xsl:attribute>
											<xsl:value-of select="$h1"/>
										</a>
									</xsl:if>
									<xsl:if test="position() != last()">
										<xsl:text>, </xsl:text>
									</xsl:if>
								</xsl:if>
								<xsl:if test="contains(@id,'globalClassifier:')">
									<xsl:variable name="val" select="substring-after(@id, 'globalClassifier:')"/>
									<xsl:variable name="h2" select="substring-before($val,':')"/>
									<xsl:variable name="h1" select="substring-after($val,':')"/>
									<xsl:variable name="file" select="concat($baseRef,translate($h2,'.','/'),'/',$h1,'.html')"/>
									<xsl:if test="not(contains($val,':'))">
										<xsl:variable name="file1" select="concat($baseRef,$val,'.html')"/>
										<xsl:text> </xsl:text>
										<xsl:choose>
											<xsl:when test="$prog_language_name='javascript'"/>
											<xsl:otherwise>
												<a>
													<xsl:attribute name="href">
														<xsl:value-of select="$file1"/>
													</xsl:attribute>
													<xsl:value-of select="$val"/>
												</a>
											</xsl:otherwise>
										</xsl:choose>
									</xsl:if>
									<xsl:if test="contains($val,':')">
										<xsl:text> </xsl:text>
										<a>
											<xsl:attribute name="href">
												<xsl:value-of select="$file"/>
											</xsl:attribute>
											<xsl:value-of select="$h1"/>
										</a>
									</xsl:if>
									<xsl:if test="position() != last()">
										<xsl:text>, </xsl:text>
									</xsl:if>
								</xsl:if>
							</xsl:for-each>
						</td>
					</tr>
				</xsl:if>
			</table>
			<xsl:if test="$classDeprecated='true'">
				<xsl:apply-templates select="deprecated"/>
				<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
			</xsl:if>
			<xsl:apply-templates select="apiClassifierDetail/apiClassifierDef/apiDeprecated"/>
			<xsl:call-template name="version"/>
			<p/>
			  <xsl:if test="prolog/asMetadata/Alternative">
			    <xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
			    <table width="100%" class="innertable">
			      <xsl:for-each select="prolog/asMetadata/Alternative">
				<xsl:variable name="replacement" select="@replacement"/>
				<xsl:variable name="version" select="@since"/>
				<xsl:variable name="baseref" select="$baseRef"/>
				<xsl:choose>
				  <xsl:when test="$replacement='none'">
				    <tr>
				      <td bgcolor="#FFFFCC">
				      	<xsl:value-of select="$nbsp"/>
				      </td>
				      <td bgcolor="#FFFFCC">
					<xsl:apply-templates select="./description/node()"/>
				      </td>
				    </tr>
				  </xsl:when>
				  <xsl:when test="$replacement!='none'">
				    <xsl:variable name="desc.terms" select="$asdoc_terms/row[entry[1][p/text() = 'altr.desc.1st']]/entry[2]/p"/>
				    <xsl:variable name="class.link">
				      <xsl:variable name="class" select="substring-after(substring-after($replacement,'.'),'.')"/>
				      <xsl:variable name="alt.pkg" select="substring-before($replacement,concat('.',$class))"/>
				      <xsl:variable name="pkg.path" select="translate($alt.pkg,'.','/')"/>
				      <xsl:value-of select="concat($baseref,$pkg.path,'/',$class,'.html')"/>
				    </xsl:variable>
				    <xsl:variable name="replace.version" select="replace($desc.terms,'%ver%',$version)"/>
				    <tr>
				      <td bgcolor="#FFFFCC">
					
					<img src="{$baseRef}images/P_AlternativeMetadataIndicator_30x28_N.png" />
				      </td>
				      <td bgcolor="#FFFFCC">
					<xsl:value-of select="substring-before($replace.version,'%class%')"/>
					<a href="{$class.link}">
					  <xsl:value-of select="$replacement"/>
					</a>
					<xsl:value-of select="substring-after($replace.version,'%class%')"/>
					<xsl:if test="./description">
					  <xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
					  <p>
					    <xsl:apply-templates select="./description/node()"/>
					  </p>
					</xsl:if>
				      </td>
				    </tr>
				  </xsl:when>
				</xsl:choose>
			      </xsl:for-each>
			    </table>
			    <xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
			  </xsl:if>			
			<xsl:call-template name="description"/>
			<p/>
			<xsl:if test="apiClassifierDetail/apiClassifierDef/apiInheritDoc">
				<xsl:call-template name="getInheritDocText">
					<xsl:with-param name="baseClass" select="ancestor-or-self::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
					<xsl:with-param name="descriptionType" select="'apiDesc'"/>
					<xsl:with-param name="entryType" select="'apiClassifier'"/>
					<xsl:with-param name="nameToMatch" select="./apiName"/>
				</xsl:call-template>
			</xsl:if>
			<xsl:if test="prolog/asCustoms/mxml">
				<a name="mxmlSyntaxSummary"/>
				<span class="classHeaderTableLabel">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'MXMLSyntax']]/entry[2]/p"/>
				</span>
				<span id="showMxmlLink" style="display:none">
					<a href="#mxmlSyntaxSummary" onclick="toggleMXMLOnly();">
						<img src="{$baseRef}images/collapsed.gif" title="collapsed" alt="collapsed" class="collapsedImage"/>
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ShowMXMLSyntax']]/entry[2]/p"/>
					</a>
					<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
				</span>
				<span id="hideMxmlLink">
					<a href="#mxmlSyntaxSummary" onclick="toggleMXMLOnly();">
						<img src="{$baseRef}images/expanded.gif" title="expanded" alt="expanded" class="expandedImage"/>
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'HideMXMLSyntax']]/entry[2]/p"/>
					</a>
				</span>
				<div id="mxmlSyntax" class="mxmlSyntax">
					<xsl:value-of disable-output-escaping="yes" select="prolog/asCustoms/mxml/."/>
				</div>
				<script language="javascript" type="text/javascript">
					<xsl:comment>
						<xsl:text>
								</xsl:text>
						<xsl:text>setMXMLOnly();</xsl:text>
						<xsl:text>
								</xsl:text>
					</xsl:comment>
				</script>
			</xsl:if>
			<xsl:if test="prolog/asMetadata/SkinStates/@states">
				<xsl:variable name="state" select="normalize-space(prolog/asMetadata/SkinStates/@states)"/>
				<h3>Skinning the component</h3>
				<p>To skin the component, implement a skin that defines the following skin states: &lt;br/&gt;&lt;br/&gt;<xsl:value-of select="$state"/>  &lt;br/&gt;&lt;br/&gt;While you must implement all skin states, a skin state can be empty. An empty skin state defines no changes to the default skin state.</p>
			</xsl:if>
			<xsl:apply-templates select="prolog/asMetadata/DefaultProperty"/>
			<xsl:apply-templates select="example"/>
			<xsl:call-template name="includeExampleLink"/>
			<xsl:call-template name="sees">
				<xsl:with-param name="labelClass" select="'classHeaderTableLabel'"/>
			</xsl:call-template>
			<xsl:text disable-output-escaping="yes">&lt;br/&gt;</xsl:text>
			<hr/>
		</div>
	</xsl:template>
	<xsl:template match="apiDeprecated" >
		<xsl:variable name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:variable name="ancestorPath" select="ancestor::apiClassifierDetail/apiClassifierDef"/>
		<div style="white-space:nowrap" valign="top">
			<xsl:choose>
				<xsl:when test="@sinceVersion">
					<b>
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DeprecatedSince']]/entry[2]/p"/>
					</b>
					<xsl:text> </xsl:text>
					<xsl:value-of select="@sinceVersion"/>
					<xsl:if test="@replacement!=''">
						<xsl:text>: </xsl:text>
					</xsl:if>
				</xsl:when>
				<xsl:otherwise>
					<b>
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Deprecated']]/entry[2]/p"/>
						<xsl:text>:</xsl:text>
						<xsl:text> </xsl:text>
					</b>
				</xsl:otherwise>
			</xsl:choose>
			<xsl:choose>
				<xsl:when test="@replacement!=''">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PleaseUse']]/entry[2]/p"/>
					<xsl:text> </xsl:text>
					<xsl:if test="contains(@replacement,',')">
						<xsl:for-each select="tokenize(@replacement, ',')">
							<xsl:variable name="spec" select="."/>
							<xsl:variable name="tospec">
								<xsl:if test="contains($spec, ':')">
									<xsl:value-of select="substring-after($spec,':')"/>
								</xsl:if>
								<xsl:if test="not(contains($spec, ':'))">
									<xsl:value-of select="$spec"/>
								</xsl:if>
							</xsl:variable>
							<xsl:variable name="linkpath1">
								<xsl:call-template name="getDeprecatedReplacementLink">
									<xsl:with-param name="replacement" select="$tospec"/>
									<xsl:with-param name="currentPackage" select="$currentPackage"/>
								</xsl:call-template>
							</xsl:variable>
							<xsl:choose>
								<xsl:when test="contains($linkpath1,'.') and contains($linkpath1,'/')">
									<A href="{$linkpath1}">
										<xsl:value-of select="$spec"/>
									</A>
								</xsl:when>
								<xsl:otherwise>
									<xsl:value-of select="$spec"/>
								</xsl:otherwise>
							</xsl:choose>
							<xsl:if test="position() != last()">
								<xsl:text>, </xsl:text>
							</xsl:if>
						</xsl:for-each>
					</xsl:if>
					<xsl:variable name="linkpath">
						<xsl:call-template name="getDeprecatedReplacementLink">
							<xsl:with-param name="replacement" select="@replacement"/>
							<xsl:with-param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
							<xsl:with-param name="ancestorPath" select="$ancestorPath"/>
						</xsl:call-template>
					</xsl:variable>
					<xsl:if test="not(contains(@replacement,','))">
						<xsl:if test="$ancestorPath">
							<xsl:variable name="lastToken">
								<xsl:call-template name="lastIndexOf">
									<xsl:with-param name="string" select="@replacement"/>
									<xsl:with-param name="char" select="'.'"/>
								</xsl:call-template>
							</xsl:variable>
							<xsl:variable name="firstPassToken" select="substring-before(@replacement,concat('.',$lastToken))"/>
							<xsl:variable name="testToken">
								<xsl:if test="string-length($firstPassToken) &gt; 0">
									<xsl:value-of select="concat($firstPassToken,':',@replacement)"/>
								</xsl:if>
								<xsl:if test="string-length($firstPassToken) = 0">
									<xsl:if test="$currentPackage = '__Global__'">
										<xsl:value-of select="concat('globalClassifier:',@replacement)"/>
									</xsl:if>
									<xsl:if test="not($currentPackage = '__Global__')">
										<xsl:value-of select="concat($currentPackage,':',@replacement)"/>
									</xsl:if>
								</xsl:if>
							</xsl:variable>
							<xsl:if test="count($classHeader_map//apiClassifier[@id=$testToken] ) &gt; 0">
								<A href="{$linkpath}">
									<xsl:value-of select="@replacement"/>
								</A>
							</xsl:if>
							<xsl:if test="count($classHeader_map//apiClassifier[@id=$testToken] ) = 0">
									<xsl:value-of select="@replacement"/>
							</xsl:if>
						</xsl:if>
						<xsl:if test="not($ancestorPath)">
							<xsl:if test="contains(@replacement, '.')">
								<xsl:variable name="lastToken">
									<xsl:call-template name="lastIndexOf">
										<xsl:with-param name="string" select="@replacement"/>
										<xsl:with-param name="char" select="'.'"/>
									</xsl:call-template>
								</xsl:variable>
								<xsl:variable name="firstPassToken" select="substring-before(@replacement,concat('.',$lastToken))"/>
								<xsl:variable name="className">
									<xsl:call-template name="lastIndexOf">
										<xsl:with-param name="string" select="$firstPassToken"/>
										<xsl:with-param name="char" select="'.'"/>
									</xsl:call-template>
								</xsl:variable>
								<xsl:variable name="packageName" select="substring-before($firstPassToken,concat('.',$className))"/>
								<xsl:variable name="testToken">
									<xsl:if test="string-length($packageName) &gt; 0">
										<xsl:value-of select="$packageName"/>
									</xsl:if>
									<xsl:if test="string-length($packageName) = 0">
											<xsl:value-of select="$currentPackage"/>
									</xsl:if>
								</xsl:variable>
								<xsl:variable name="testToken2">
									<xsl:if test="string-length($firstPassToken) &gt; 0">
										<xsl:value-of select="$firstPassToken"/>
									</xsl:if>
									<xsl:if test="string-length($firstPassToken) = 0">
											<xsl:value-of select="$classHeader_map//apiClassifier/apiName"/>
									</xsl:if>
								</xsl:variable>
								<xsl:if test="count($classHeader_map//apiClassifier[@id=concat($testToken, ':', $testToken2)] ) &gt; 0">
									<A href="{$linkpath}">
										<xsl:value-of select="@replacement"/>
									</A>
								</xsl:if>
								<xsl:if test="count($classHeader_map//apiClassifier[@id=concat($testToken, ':', $testToken2)] ) = 0">
										<xsl:value-of select="@replacement"/>
								</xsl:if>
							</xsl:if>
							<xsl:if test="not(contains(@replacement, '.'))">
								<A href="{$linkpath}">
									<xsl:value-of select="@replacement"/>
								</A>
							</xsl:if>
						</xsl:if>
					</xsl:if>
				</xsl:when>
				<xsl:when test="apiDesc">
					<xsl:for-each select="./apiDesc">
						<xsl:call-template name="processTags"/>
					</xsl:for-each>
				</xsl:when>
			</xsl:choose>
		</div>
	</xsl:template>
	<xsl:template match="apiDeprecated" mode="event" >
		<xsl:variable name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:variable name="ancestorPath" select="ancestor::apiClassifierDetail/apiClassifierDef"/>
		<div style="white-space:nowrap" valign="top">
			<xsl:choose>
				<xsl:when test="@sinceVersion">
					<b>
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'DeprecatedSince']]/entry[2]/p"/>
					</b>
					<xsl:text> </xsl:text>
					<xsl:value-of select="@sinceVersion"/>
					<xsl:if test="@replacement!=''">
						<xsl:text>: </xsl:text>
					</xsl:if>
				</xsl:when>
				<xsl:otherwise>
					<b>
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Deprecated']]/entry[2]/p"/>
						<xsl:text>:</xsl:text>
						<xsl:text> </xsl:text>
					</b>
				</xsl:otherwise>
			</xsl:choose>
			<xsl:choose>
				<xsl:when test="@replacement!=''">
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PleaseUse']]/entry[2]/p"/>
					<xsl:text> </xsl:text>
					<xsl:if test="contains(@replacement,',')">
						<xsl:for-each select="tokenize(@replacement, ',')">
							<xsl:variable name="spec" select="."/>
							<xsl:variable name="tospec">
								<xsl:if test="contains($spec, ':')">
									<xsl:value-of select="substring-after($spec,':')"/>
								</xsl:if>
								<xsl:if test="not(contains($spec, ':'))">
									<xsl:value-of select="$spec"/>
								</xsl:if>
							</xsl:variable>
							<xsl:variable name="linkpath1">
								<xsl:call-template name="getDeprecatedReplacementLink">
									<xsl:with-param name="replacement" select="$tospec"/>
									<xsl:with-param name="currentPackage" select="$currentPackage"/>
									<xsl:with-param name="mode" select="'event:'"/>
								</xsl:call-template>
							</xsl:variable>
							<xsl:choose>
								<xsl:when test="contains($linkpath1,'.') and contains($linkpath1,'/')">
									<A href="{$linkpath1}">
										<xsl:value-of select="$spec"/>
									</A>
								</xsl:when>
								<xsl:otherwise>
									<xsl:value-of select="$spec"/>
								</xsl:otherwise>
							</xsl:choose>
							<xsl:if test="position() != last()">
								<xsl:text>, </xsl:text>
							</xsl:if>
						</xsl:for-each>
					</xsl:if>
					<xsl:variable name="linkpath">
						<xsl:call-template name="getDeprecatedReplacementLink">
							<xsl:with-param name="replacement" select="@replacement"/>
							<xsl:with-param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
							<xsl:with-param name="ancestorPath" select="$ancestorPath"/>
							<xsl:with-param name="mode" select="'event:'"/>
						</xsl:call-template>
					</xsl:variable>
					<xsl:if test="not(contains(@replacement,','))">
						<xsl:if test="$ancestorPath">
							<xsl:variable name="lastToken">
								<xsl:call-template name="lastIndexOf">
									<xsl:with-param name="string" select="@replacement"/>
									<xsl:with-param name="char" select="'.'"/>
								</xsl:call-template>
							</xsl:variable>
							<xsl:variable name="firstPassToken" select="substring-before(@replacement,concat('.',$lastToken))"/>
							<xsl:variable name="testToken">
								<xsl:if test="string-length($firstPassToken) &gt; 0">
									<xsl:value-of select="concat($firstPassToken,':',@replacement)"/>
								</xsl:if>
								<xsl:if test="string-length($firstPassToken) = 0">
									<xsl:if test="$currentPackage = '__Global__'">
										<xsl:value-of select="concat('globalClassifier:',@replacement)"/>
									</xsl:if>
									<xsl:if test="not($currentPackage = '__Global__')">
										<xsl:value-of select="concat($currentPackage,':',@replacement)"/>
									</xsl:if>
								</xsl:if>
							</xsl:variable>
							<xsl:if test="count($classHeader_map//apiClassifier[@id=$testToken] ) &gt; 0">
								<A href="{$linkpath}">
									<xsl:value-of select="@replacement"/>
								</A>
							</xsl:if>
							<xsl:if test="count($classHeader_map//apiClassifier[@id=$testToken] ) = 0">
									<xsl:value-of select="@replacement"/>
							</xsl:if>
						</xsl:if>
						<xsl:if test="not($ancestorPath)">
							<xsl:if test="contains(@replacement, '.')">
								<xsl:variable name="lastToken">
									<xsl:call-template name="lastIndexOf">
										<xsl:with-param name="string" select="@replacement"/>
										<xsl:with-param name="char" select="'.'"/>
									</xsl:call-template>
								</xsl:variable>
								<xsl:variable name="firstPassToken" select="substring-before(@replacement,concat('.',$lastToken))"/>
								<xsl:variable name="className">
									<xsl:call-template name="lastIndexOf">
										<xsl:with-param name="string" select="$firstPassToken"/>
										<xsl:with-param name="char" select="'.'"/>
									</xsl:call-template>
								</xsl:variable>
								<xsl:variable name="packageName" select="substring-before($firstPassToken,concat('.',$className))"/>
								<xsl:variable name="testToken">
									<xsl:if test="string-length($packageName) &gt; 0">
										<xsl:value-of select="$packageName"/>
									</xsl:if>
									<xsl:if test="string-length($packageName) = 0">
											<xsl:value-of select="$currentPackage"/>
									</xsl:if>
								</xsl:variable>
								<xsl:variable name="testToken2">
									<xsl:if test="string-length($firstPassToken) &gt; 0">
										<xsl:value-of select="$firstPassToken"/>
									</xsl:if>
									<xsl:if test="string-length($firstPassToken) = 0">
											<xsl:value-of select="$classHeader_map//apiClassifier/apiName"/>
									</xsl:if>
								</xsl:variable>
								<xsl:if test="count($classHeader_map//apiClassifier[@id=concat($testToken, ':', $testToken2)] ) &gt; 0">
									<A href="{$linkpath}">
										<xsl:value-of select="@replacement"/>
									</A>
								</xsl:if>
								<xsl:if test="count($classHeader_map//apiClassifier[@id=concat($testToken, ':', $testToken2)] ) = 0">
										<xsl:value-of select="@replacement"/>
								</xsl:if>
							</xsl:if>
							<xsl:if test="not(contains(@replacement, '.'))">
								<A href="{$linkpath}">
									<xsl:value-of select="@replacement"/>
								</A>
							</xsl:if>
						</xsl:if>
					</xsl:if>
				</xsl:when>
				<xsl:when test="apiDesc">
					<xsl:for-each select="./apiDesc">
						<xsl:call-template name="processTags"/>
					</xsl:for-each>
				</xsl:when>
			</xsl:choose>
		</div>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/class-summary.xslt
================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://sf.net/saxon" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ifn="urn:internal:functions"
	exclude-result-prefixes="saxon xs ifn">
	<xsl:import href="asdoc-util.xslt"/>
	<xsl:output encoding="UTF-8" method="html" use-character-maps="disable"/>
	<xsl:param name="localTitle" select="$localTitle"/>
	<xsl:variable name="title" select="concat($asdoc_terms/row[entry[1][p/text() = $localTitle]]/entry[2]/p,' - ',$title-base)"/>
	<xsl:param name="overviewsFile" select="'overviews.xml'"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:param name="packages_map_name" select="packagemap.xml"/>
	<xsl:param name="filter" select="$filter"/>
	<xsl:param name="outfile" select="'class-summary'"/>
	<xsl:variable name="useFilter">
		<xsl:if test="contains($filter,'*')">
			<xsl:value-of select="substring-before($filter,'*')"/>
		</xsl:if>
		<xsl:if test="not(contains($filter,'*'))">
			<xsl:value-of select="$filter"/>
		</xsl:if>
	</xsl:variable>
	<xsl:template match="/">
		<xsl:copy-of select="$noLiveDocs"/>
		<xsl:copy-of select="$docType"/>
		<xsl:element name="html">
			<head>
				<title>
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = $localTitle]]/entry[2]/p"/>
					<xsl:call-template name="getPageTitlePostFix"/>
				</title>
				<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
				<xsl:call-template name="getStyleLink">
					<xsl:with-param name="link" select="asdoc/link"/>
				</xsl:call-template>
			</head>
			<xsl:element name="body">
				<xsl:if test="$isEclipse">
					<xsl:attribute name="class">
						<xsl:text>eclipseBody</xsl:text>
					</xsl:attribute>
				</xsl:if>
				<xsl:call-template name="getTitleScript">
					<xsl:with-param name="title" select="$title"/>
				</xsl:call-template>
				<xsl:call-template name="getLinks2">
					<xsl:with-param name="subTitle">
						<xsl:call-template name="search-and-replace">
							<xsl:with-param name="input" select="$asdoc_terms/row[entry[1][p/text() = $localTitle]]/entry[2]/p"/>
							<xsl:with-param name="search-string" select="' '"/>
							<xsl:with-param name="replace-string" select="$nbsp"/>
						</xsl:call-template>
					</xsl:with-param>
					<xsl:with-param name="fileName" select="$outfile"/>
					<xsl:with-param name="showProperties" select="false()"/>
					<xsl:with-param name="showMethods" select="false()"/>
					<xsl:with-param name="showAllClasses" select="false()"/>
				</xsl:call-template>
				<div class="MainContent">
					<br/>
					<xsl:variable name="overviews" select="document($overviewsFile)/overviews"/>
					<p>
						<xsl:choose>
							<xsl:when test="starts-with($useFilter,'mx.')">
								<xsl:value-of disable-output-escaping="yes" select="$overviews/mx-classes/description/."/>
							</xsl:when>
							<xsl:when test="starts-with($useFilter,'flash.')">
								<xsl:value-of disable-output-escaping="yes" select="$overviews/flash-classes/description/."/>
							</xsl:when>
							<xsl:otherwise>
								<xsl:value-of disable-output-escaping="yes" select="$overviews/all-classes/description/."/>
							</xsl:otherwise>
						</xsl:choose>
					</p>
					<xsl:for-each select="$overviews/all-classes">
						<xsl:call-template name="sees">
							<xsl:with-param name="xrefId" select="'all-classes'"/>
						</xsl:call-template>
					</xsl:for-each>
					<br/>
					<table cellpadding="3" cellspacing="0" class="summaryTable">
						<tr>
							<th>
								<xsl:value-of select="$nbsp"/>
							</th>
							<th width="20%">
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ClassClass']]/entry[2]/p"/>
							</th>
							<th width="20%">
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PackagePackage']]/entry[2]/p"/>
							</th>
							<th width="60%">
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Description']]/entry[2]/p"/>
							</th>
						</tr>
						<xsl:for-each select="allClasses/apiPackage//apiClassifier[starts-with(../apiName,$useFilter) or ($useFilter='flash.' and ../apiName='__Global__')]">
							<xsl:sort select="./apiName" order="ascending" data-type="text" lang="en-US"/>
							<xsl:variable name="name" select="./apiName"/>
							<xsl:variable name="packageName" select="../apiName"/>
							<xsl:variable name="classPath">
								<xsl:choose>
									<xsl:when test="$packageName='__Global__'">
										<xsl:value-of select="'.'"/>
									</xsl:when>
									<xsl:otherwise>
										<xsl:value-of select="translate($packageName,'.','/') "/>
									</xsl:otherwise>
								</xsl:choose>
							</xsl:variable>
							<tr class="prow{position() mod 2}">
								<td class="summaryTablePaddingCol">
									<xsl:value-of select="$nbsp"/>
								</td>
								<td class="summaryTableSecondCol">
									<xsl:choose>
										<xsl:when test="$classPath">
											<a href="{$classPath}/{$name}.html">
												<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface">
													<i>
														<xsl:value-of select="$name"/>
														<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
															<xsl:value-of select="$nbsp"/>
															<img src="images/AirIcon12x12.gif" width="12" height="12" hspace="0" vspace="0"/>
														</xsl:if>
													</i>
												</xsl:if>
												<xsl:if test="not(./apiClassifierDetail/apiClassifierDef/apiInterface)">
													<xsl:value-of select="$name"/>
													<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
														<xsl:value-of select="$nbsp"/>
														<img src="images/AirIcon12x12.gif" width="12" height="12" hspace="0" vspace="0"/>
													</xsl:if>
												</xsl:if>
											</a>
											<br/>
										</xsl:when>
										<xsl:otherwise>
											<a href="{$classPath}/{$name}.html">
												<xsl:if test="apiClassifier[./apiClassifierDetail/apiClassifierDef/apiInterface]">
													<i>
														<xsl:value-of select="$name"/>
														<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
															<xsl:value-of select="$nbsp"/>
															<img src="images/AirIcon12x12.gif" width="12" height="12" hspace="0" vspace="0"/>
														</xsl:if>
													</i>
												</xsl:if>
												<xsl:if test="apiClassifier[not(./apiClassifierDetail/apiClassifierDef/apiInterface)]">
													<xsl:value-of select="$name"/>
													<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
														<xsl:value-of select="$nbsp"/>
														<img src="images/AirIcon12x12.gif" width="12" height="12" hspace="0" vspace="0"/>
													</xsl:if>
												</xsl:if>
											</a>
											<br/>
										</xsl:otherwise>
									</xsl:choose>
								</td>
								<td class="summaryTableCol">
									<xsl:if test="$classPath and string-length(normalize-space($classPath)) &gt; 0 and not($classPath='.')">
										<a href="{$classPath}/package-detail.html" onclick="javascript:loadClassListFrame('{$classPath}/class-list.html');">
											<xsl:value-of select="$packageName"/>
										</a>
									</xsl:if>
									<xsl:if test="not($classPath) or string-length(normalize-space($classPath)) = 0 or $classPath='.'">
										<a href="package-detail.html" onclick="javascript:loadClassListFrame('class-list.html');">
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
										</a>
									</xsl:if>
								</td>
								<td class="summaryTableLastCol">
									<xsl:if test="deprecated">
										<xsl:apply-templates select="deprecated"/>
									</xsl:if>
									<xsl:if test="not(deprecated)">
										<xsl:if test="string-length(normalize-space(./shortdesc)) &gt; 0">
											<xsl:value-of select="./shortdesc" disable-output-escaping="yes"/>
										</xsl:if>
										<xsl:if test="not(string-length(normalize-space(./shortdesc)) &gt; 0)">
											<xsl:value-of select="$nbsp"/>
										</xsl:if>
									</xsl:if>
								</td>
							</tr>
						</xsl:for-each>
					</table>
					<p/>
					<center class="copyright">
						<xsl:copy-of select="$copyright"/>
					</center>
				</div>
			</xsl:element>
		</xsl:element>
		<xsl:copy-of select="$copyrightComment"/>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/cookies.js
================================================
////////////////////////////////////////////////////////////////////////////////
//
//  ADOBE SYSTEMS INCORPORATED
//  Copyright 2006-2008 Adobe Systems Incorporated
//  All Rights Reserved.
//
//  NOTICE: Adobe permits you to use, modify, and distribute this file
//  in accordance with the terms of the license agreement accompanying it.
//
////////////////////////////////////////////////////////////////////////////////

/**
 * Read the JavaScript cookies tutorial at:
 *   http://www.netspade.com/articles/javascript/cookies.xml
 */

/**
 * Sets a Cookie with the given name and value.
 *
 * name       Name of the cookie
 * value      Value of the cookie
 * [expires]  Expiration date of the cookie (default: end of current session)
 * [path]     Path where the cookie is valid (default: path of calling document)
 * [domain]   Domain where the cookie is valid
 *              (default: domain of calling document)
 * [secure]   Boolean value indicating if the cookie transmission requires a
 *              secure transmission
 */
function setCookie(name, value, expires, path, domain, secure)
{
    document.cookie= name + "=" + escape(value) +
        ((expires) ? "; expires=" + expires.toGMTString() : "") +
        ((path) ? "; path=" + path : "") +
        ((domain) ? "; domain=" + domain : "") +
        ((secure) ? "; secure" : "");
}

/**
 * Gets the value of the specified cookie.
 *
 * name  Name of the desired cookie.
 *
 * Returns a string containing value of specified cookie,
 *   or null if cookie does not exist.
 */
function getCookie(name)
{
    var dc = document.cookie;
    var prefix = name + "=";
    var begin = dc.indexOf("; " + prefix);
    if (begin == -1)
    {
        begin = dc.indexOf(prefix);
        if (begin != 0) return null;
    }
    else
    {
        begin += 2;
    }
    var end = document.cookie.indexOf(";", begin);
    if (end == -1)
    {
        end = dc.length;
    }
    return unescape(dc.substring(begin + prefix.length, end));
}

/**
 * Deletes the specified cookie.
 *
 * name      name of the cookie
 * [path]    path of the cookie (must be same as path used to create cookie)
 * [domain]  domain of the cookie (must be same as domain used to create cookie)
 */
function deleteCookie(name, path, domain)
{
    if (getCookie(name))
    {
        document.cookie = name + "=" + 
            ((path) ? "; path=" + path : "") +
            ((domain) ? "; domain=" + domain : "") +
            "; expires=Thu, 01-Jan-70 00:00:01 GMT";
    }
}


================================================
FILE: documentation/api-reference/templates/effectsSummary.xslt
================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
	<xsl:output method="xml" version="1.0" encoding="UTF-8" indent="no"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:template match="/">
		<allClasses>
			<xsl:apply-templates select="//apiItemRef">
				<xsl:sort select="@href" order="ascending"/>
			</xsl:apply-templates>
		</allClasses>
	</xsl:template>
	<xsl:template match="apiItemRef">
		<xsl:variable name="ditaFileName">
			<xsl:value-of select="concat($ditaFileDir,@href)"/>
		</xsl:variable>
		<xsl:for-each select="document($ditaFileName)/apiPackage">
			<apiPackage id="{@id}">
				<apiName>
					<xsl:value-of select="./apiName"/>
				</apiName>
				<xsl:apply-templates select="apiClassifier"/>
			</apiPackage>
		</xsl:for-each>
	</xsl:template>
	<xsl:template match="apiClassifier">
		<apiClassifier id="{@id}">
			<apiName>
				<xsl:value-of select="./apiName"/>
			</apiName>
			<xsl:apply-templates select="apiClassifierDetail"/>
			<xsl:apply-templates select="prolog/asMetadata"/>
		</apiClassifier>
	</xsl:template>
	<xsl:template match="prolog/asMetadata">
		<prolog>
			<asMetadata>
				<xsl:apply-templates select="effects"/>
			</asMetadata>
		</prolog>
	</xsl:template>
	<xsl:template match="effects">
		<effects>
			<xsl:apply-templates select="node()"/>
		</effects>
	</xsl:template>
	<xsl:template match="apiClassifierDetail">
		<apiClassifierDetail>
			<xsl:apply-templates select="apiClassifierDef"/>
		</apiClassifierDetail>
	</xsl:template>
	<xsl:template match="apiClassifierDef">
		<apiClassifierDef>
			<xsl:apply-templates select="node()"/>
		</apiClassifierDef>
	</xsl:template>
	<xsl:template match="node()">
		<xsl:copy copy-namespaces="no">
			<xsl:copy-of select="@*"/>
			<xsl:apply-templates select="node()"/>
		</xsl:copy>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/eventsGeneratedSummary.xslt
================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
	<xsl:output method="xml" version="1.0" encoding="UTF-8" indent="yes"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:template match="/">
		<allClasses>
			<xsl:apply-templates select="//apiItemRef">
				<xsl:sort select="@href" order="ascending"/>
			</xsl:apply-templates>
		</allClasses>
	</xsl:template>
	<xsl:template match="apiItemRef">
		<xsl:variable name="ditaFileName">
			<xsl:value-of select="concat($ditaFileDir,@href)"/>
		</xsl:variable>
		<xsl:for-each select="document($ditaFileName)/apiPackage">
			<apiPackage id="{@id}">
				<apiName>
					<xsl:value-of select="./apiName"/>
				</apiName>
				<xsl:apply-templates select="apiClassifier"/>
			</apiPackage>
		</xsl:for-each>
	</xsl:template>
	<xsl:template match="apiClassifier">
		<apiClassifier id="{@id}">
			<apiName>
				<xsl:value-of select="./apiName"/>
			</apiName>
			<xsl:apply-templates select="shortdesc"/>
			<xsl:apply-templates select="apiClassifierDetail"/>
			<xsl:apply-templates select="adobeApiEvent"/>
		</apiClassifier>
	</xsl:template>
	<xsl:template match="apiClassifierDetail">
		<apiClassifierDetail>
			<xsl:apply-templates select="apiClassifierDef"/>
		</apiClassifierDetail>
		<xsl:apply-templates select="apiDesc"/>
	</xsl:template>
	<xsl:template match="apiDesc">
		<apiDesc>
			<xsl:apply-templates select="node()"/>
		</apiDesc>
	</xsl:template>
	<xsl:template match="adobeApiEvent">
		<adobeApiEvent id="{@id}">
			<xsl:apply-templates select="node()"/>
		</adobeApiEvent>
	</xsl:template>
	<xsl:template match="apiClassifierDef">
		<apiClassifierDef>
			<xsl:apply-templates select="node()"/>
		</apiClassifierDef>
	</xsl:template>
	<xsl:template match="shortdesc">
		<shortdesc>
			<xsl:apply-templates select="node()"/>
		</shortdesc>
	</xsl:template>
	<xsl:template match="node()">
		<xsl:copy copy-namespaces="no">
			<xsl:copy-of select="@*"/>
			<xsl:apply-templates select="node()"/>
		</xsl:copy>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/fieldSummary.xslt
================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://sf.net/saxon" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ifn="urn:internal:functions"
	xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/" exclude-result-prefixes="saxon xs ifn ditaarch">
	<xsl:output method="xml" version="1.0" encoding="UTF-8" indent="no"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:variable name="isConst" select="'false'"/>
	<xsl:variable name="accessLevel" select="'public'"/>
	<xsl:variable name="accessLevelpr" select="'protected'"/>
	<xsl:param name="configFilename" select="'../../bin/ASDoc_Config.xml'"/>
	<xsl:variable name="config" select="document($configFilename)/asDocConfig"/>
	<xsl:template match="/">
		<allClasses>
			<xsl:apply-templates select="//apiItemRef">
				<xsl:sort select="@href" order="ascending"/>
			</xsl:apply-templates>
		</allClasses>
	</xsl:template>
	<xsl:template match="apiItemRef">
		<xsl:variable name="ditaFileName">
			<xsl:value-of select="concat($ditaFileDir,@href)"/>
		</xsl:variable>
		<xsl:for-each select="document($ditaFileName)/apiPackage">
			<apiPackage id="{@id}">
				<apiName>
					<xsl:value-of select="./apiName"/>
				</apiName>
				<xsl:apply-templates select="apiClassifier"/>
			</apiPackage>
		</xsl:for-each>
	</xsl:template>
	<xsl:template match="apiClassifier">
		<apiClassifier id="{@id}">
			<apiName>
				<xsl:value-of select="./apiName"/>
			</apiName>
			<xsl:apply-templates select="shortdesc"/>
			<xsl:apply-templates select="prolog"/>
			<xsl:apply-templates select="apiClassifierDetail"/>
			<xsl:apply-templates select="apiValue"/>
		</apiClassifier>
	</xsl:template>
	<xsl:template match="apiValue">
		<apiValue id="{@id}">
			<xsl:apply-templates select="node()"/>
		</apiValue>
	</xsl:template>
	<xsl:template name="getInheritDocText">
		<xsl:param name="baseClass"/>
		<xsl:param name="implementedInterface"/>
		<xsl:param name="descriptionType"/>
		<xsl:param name="entryType"/>
		<xsl:param name="nameToMatch"/>
		<xsl:param name="itemNameToMatch"/>
		<xsl:param name="doNotProcessTags" select="false()"/>
		<xsl:for-each select="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseInterface">
			<xsl:call-template name="inheritDocFromInterfaces">
				<xsl:with-param name="implementedInterface" select="."/>
				<xsl:with-param name="descriptionType" select="$descriptionType"/>
				<xsl:with-param name="entryType" select="$entryType"/>
				<xsl:with-param name="nameToMatch" select="$nameToMatch"/>
				<xsl:with-param name="doNotProcessTags" select="$doNotProcessTags"/>
			</xsl:call-template>
		</xsl:for-each>
		<xsl:call-template name="inheritDocFromBaseClass">
			<xsl:with-param name="baseClass" select="$baseClass"/>
			<xsl:with-param name="descriptionType" select="$descriptionType"/>
			<xsl:with-param name="entryType" select="$entryType"/>
			<xsl:with-param name="nameToMatch" select="$nameToMatch"/>
			<xsl:with-param name="itemNameToMatch" select="$itemNameToMatch"/>
			<xsl:with-param name="doNotProcessTags" select="$doNotProcessTags"/>
		</xsl:call-template>
	</xsl:template>
	<xsl:template name="inheritDocFromInterfaces">
		<xsl:param name="implementedInterface"/>
		<xsl:param name="descriptionType"/>
		<xsl:param name="entryType"/>
		<xsl:param name="nameToMatch"/>
		<xsl:param name="doNotProcessTags" select="false()"/>
		<xsl:for-each select="$implementedInterface">
			<xsl:variable name="baseClass" select="."/>
			<xsl:variable name="className">
				<xsl:if test="contains($baseClass,':')">
					<xsl:value-of select="substring-after($baseClass,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($baseClass,':'))">
					<xsl:value-of select="$baseClass"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="packageName">
				<xsl:if test="contains($baseClass,':')">
					<xsl:value-of select="substring-before($baseClass,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($baseClass,':'))">
					<xsl:value-of select="__Global__"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="xslDocPath">
				<xsl:if test="contains($baseClass,':')">
					<xsl:value-of select="concat($ditaFileDir,substring-before($baseClass,':'),'.xml')"/>
				</xsl:if>
				<xsl:if test="not(contains($baseClass,':'))">
					<xsl:value-of select="concat($ditaFileDir,'__Global__.xml')"/>
				</xsl:if>
			</xsl:variable>
			<xsl:choose>
				<xsl:when test="$entryType='apiValue'">
					<xsl:for-each select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className and apiClassifierDetail/apiClassifierDef/apiInterface]/apiValue[apiName=$nameToMatch]">
						<xsl:choose>
							<xsl:when test="$descriptionType='shortdesc'">
								<xsl:for-each select="./shortdesc[normalize-space(.)!='']">
									<shortdesc>
										<xsl:apply-templates select="node()"/>
									</shortdesc>
								</xsl:for-each>
							</xsl:when>
							<xsl:when test="$descriptionType='apiDesc'">
								<xsl:for-each select="./apiValueDetail/apiDesc[normalize-space(.)!='']">
									<apiDesc>
										<xsl:apply-templates select="node()"/>
									</apiDesc>
								</xsl:for-each>
							</xsl:when>
						</xsl:choose>
					</xsl:for-each>
				</xsl:when>
			</xsl:choose>
			<!-- Now process the base interface of the current interface-->
			<xsl:for-each select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className]/apiClassifierDetail/apiClassifierDef/apiBaseInterface">
				<xsl:call-template name="inheritDocFromInterfaces">
					<xsl:with-param name="implementedInterface" select="."/>
					<xsl:with-param name="descriptionType" select="$descriptionType"/>
					<xsl:with-param name="entryType" select="$entryType"/>
					<xsl:with-param name="nameToMatch" select="$nameToMatch"/>
					<xsl:with-param name="doNotProcessTags" select="$doNotProcessTags"/>
				</xsl:call-template>
			</xsl:for-each>
		</xsl:for-each>
	</xsl:template>
	<xsl:template name="inheritDocFromBaseClass">
		<xsl:param name="baseClass"/>
		<xsl:param name="descriptionType"/>
		<xsl:param name="entryType"/>
		<xsl:param name="nameToMatch"/>
		<xsl:param name="itemNameToMatch"/>
		<xsl:param name="doNotProcessTags" select="false()"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="packageName">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="__Global__"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="concat($ditaFileDir,substring-before($baseClass,':'),'.xml')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="concat($ditaFileDir,'__Global__.xml')"/>
			</xsl:if>
		</xsl:variable>
		<xsl:choose>
			<xsl:when test="$entryType='apiValue'">
				<xsl:for-each select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className and not(apiClassifierDetail/apiClassifierDef/apiInterface)]/apiValue[apiName=$nameToMatch]">
					<xsl:choose>
						<xsl:when test="$descriptionType='shortdesc'">
							<xsl:for-each select="./shortdesc[normalize-space(.)!='']">
								<shortdesc>
									<xsl:apply-templates select="node()"/>
								</shortdesc>
							</xsl:for-each>
						</xsl:when>
						<xsl:when test="$descriptionType='apiDesc'">
							<xsl:for-each select="./apiValueDetail/apiDesc[normalize-space(.)!='']">
								<apiDesc>
									<xsl:apply-templates select="node()"/>
								</apiDesc>
							</xsl:for-each>
						</xsl:when>
					</xsl:choose>
				</xsl:for-each>
			</xsl:when>
		</xsl:choose>
		<!-- Now process the base class till object reached-->
		<xsl:if test="not($className='Object')">
			<xsl:variable name="newBaseClass"
				select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className and not(apiClassifierDetail/apiClassifierDef/apiInterface)]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
			<xsl:if test="string-length($newBaseClass) &gt; 0">
				<xsl:call-template name="inheritDocFromBaseClass">
					<xsl:with-param name="baseClass" select="$newBaseClass"/>
					<xsl:with-param name="descriptionType" select="$descriptionType"/>
					<xsl:with-param name="entryType" select="$entryType"/>
					<xsl:with-param name="nameToMatch" select="$nameToMatch"/>
					<xsl:with-param name="itemNameToMatch" select="$itemNameToMatch"/>
					<xsl:with-param name="doNotProcessTags" select="$doNotProcessTags"/>
				</xsl:call-template>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getConRefText">
		<xsl:param name="conref"/>
		<xsl:param name="descriptionType"/>
		<xsl:param name="entryType"/>
		<xsl:param name="doNotProcessTags" select="false()"/>
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:if test="string-length($conref) &gt; 0">
			<xsl:variable name="relativePath">
				<xsl:call-template name="getRelativePath">
					<xsl:with-param name="currentPath" select="$currentPackage"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:variable name="packageClassText">
				<xsl:if test="contains($conref,'#') and contains(substring-before($conref,'#'),'.')">
					<xsl:value-of select="substring-before($conref,'#')"/>
				</xsl:if>
				<xsl:if test="contains($conref,'#') and not(contains(substring-before($conref,'#'),'.'))">
					<xsl:value-of select="concat($currentPackage,'.',substring-before($conref,'#'))"/>
				</xsl:if>
				<xsl:if test="not(contains($conref,'#'))">
					<xsl:value-of select="$conref"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="className">
				<xsl:if test="contains($conref,'#') and contains(substring-before($conref,'#'),'.')">
					<xsl:call-template name="lastIndexOf">
						<xsl:with-param name="string" select="$packageClassText"/>
						<xsl:with-param name="char" select="'.'"/>
					</xsl:call-template>
				</xsl:if>
				<xsl:if test="contains($conref,'#') and not(contains(substring-before($conref,'#'),'.'))">
					<xsl:if test="string-length(substring-before($conref,'#')) = 0">
						<xsl:value-of select="ancestor-or-self::apiPackage/apiClassifier/apiName"/>
					</xsl:if>
					<xsl:if test="string-length(substring-before($conref,'#')) &gt; 0">
						<xsl:value-of select="substring-before($conref,'#')"/>
					</xsl:if>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="destPackageName1">
				<xsl:value-of select="substring-before($packageClassText,concat('.',$className))"/>
			</xsl:variable>
			<xsl:variable name="destPackageName">
				<xsl:if test="$destPackageName1 = '' or $destPackageName1='__Global__'">
					<xsl:value-of select="'__Global__.xml'"/>
				</xsl:if>
				<xsl:if test="not($destPackageName1='') and not($destPackageName1='__Global__')">
					<xsl:value-of select="concat($destPackageName1, '.xml')"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="entryTypeNameText" select="substring-after($conref,'#')"/>
			<xsl:variable name="nameToMatch">
				<xsl:if test="string-length($entryTypeNameText) = 0">
					<xsl:value-of select="$className"/>
				</xsl:if>
				<xsl:if test="contains($entryTypeNameText,':')">
					<xsl:value-of select="substring-after($entryTypeNameText,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($entryTypeNameText,':')) and string-length($entryTypeNameText) &gt; 0">
					<xsl:if test="contains($entryTypeNameText,')')">
						<xsl:value-of select="substring-before($entryTypeNameText,'(')"/>
					</xsl:if>
					<xsl:if test="not(contains($entryTypeNameText,')'))">
						<xsl:value-of select="$entryTypeNameText"/>
					</xsl:if>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="entryType">
				<xsl:if test="string-length($entryTypeNameText) = 0">
					<xsl:value-of select="'class'"/>
				</xsl:if>
				<xsl:if test="contains($entryTypeNameText,':')">
					<xsl:value-of select="substring-before($entryTypeNameText,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($entryTypeNameText,':')) and string-length($entryTypeNameText) &gt; 0">
					<xsl:if test="contains($entryTypeNameText,')')">
						<xsl:value-of select="'method'"/>
					</xsl:if>
					<xsl:if test="not(contains($entryTypeNameText,')'))">
						<xsl:value-of select="'property'"/>
					</xsl:if>
				</xsl:if>
			</xsl:variable>
			<xsl:for-each select="document(concat($ditaFileDir,$destPackageName))/apiPackage//apiClassifier[apiName=$className]">
				<xsl:if test="string-length($entryType) &gt; 0">
					<xsl:choose>
						<xsl:when test="contains($entryType,'property')">
							<xsl:variable name="property.desc">
								<xsl:for-each select="./apiValue[apiName=$nameToMatch]">
									<xsl:choose>
										<xsl:when test="$descriptionType='shortdesc'">
											<xsl:if test="./shortdesc[@conref]">
												<xsl:call-template name="getConRefText">
													<xsl:with-param name="conref" select="./shortdesc/@conref"/>
													<xsl:with-param name="descriptionType" select="local-name(./shortdesc)"/>
												</xsl:call-template>
											</xsl:if>
											<xsl:if test="not(./shortdesc[@conref])">
												<xsl:for-each select="./shortdesc/.">
													<xsl:apply-templates select="node()"/>
												</xsl:for-each>
											</xsl:if>
										</xsl:when>
										<xsl:otherwise>
											<xsl:if test="./apiValueDetail/apiDesc[@conref]">
												<xsl:call-template name="getConRefText">
													<xsl:with-param name="conref" select="./apiValueDetail/apiDesc/@conref"/>
													<xsl:with-param name="descriptionType" select="local-name(./apiValueDetail/apiDesc)"/>
												</xsl:call-template>
											</xsl:if>
											<xsl:if test="not(./apiValueDetail/apiDesc[@conref])">
												<xsl:for-each select="./apiValueDetail/apiDesc">
													<xsl:apply-templates select="node()"/>
												</xsl:for-each>
											</xsl:if>
										</xsl:otherwise>
									</xsl:choose>
								</xsl:for-each>
							</xsl:variable>
							<xsl:variable name="skin.desc">
								<xsl:for-each select="./prolog/asMetadata/skinParts/SkinPart[@name=$nameToMatch]">
							      <xsl:choose>
							        <xsl:when test="$descriptionType='shortdesc'">
							          <xsl:if test="./shortdesc[@conref]">
							            <xsl:call-template name="getConRefText">
							              <xsl:with-param name="conref" select="./shortdesc/@conref"/>
							              <xsl:with-param name="descriptionType" select="local-name(./shortdesc)"/>
							            </xsl:call-template>
							          </xsl:if>
							          <xsl:if test="not(./shortdesc[@conref])">
							            <xsl:for-each select="./shortdesc/.">
							              <xsl:apply-templates select="node()"/>
							            </xsl:for-each>
							          </xsl:if>
							        </xsl:when>
							        <xsl:otherwise>
							          <xsl:if test="./description[@conref]">
							            <xsl:call-template name="getConRefText">
							              <xsl:with-param name="conref" select="./description/@conref"/>
							              <xsl:with-param name="descriptionType" select="local-name(./description)"/>
							            </xsl:call-template>
							          </xsl:if>
							          <xsl:if test="not(./description[@conref])">
							            <xsl:for-each select="./description">
							              <xsl:apply-templates select="node()"/>
							            </xsl:for-each>
							          </xsl:if>
							        </xsl:otherwise>
							      </xsl:choose>
							    </xsl:for-each>						
							</xsl:variable>
							<xsl:if test="$property.desc=''">
								<xsl:copy-of select="$skin.desc" copy-namespaces="no"/>
							</xsl:if>
							<xsl:if test="$property.desc!=''">
								<xsl:copy-of select="$property.desc" copy-namespaces="no"/>
							</xsl:if>
						</xsl:when>
					</xsl:choose>
				</xsl:if>
			</xsl:for-each>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getRelativePath">
		<xsl:param name="currentPath"/>
		<xsl:choose>
			<xsl:when test="not($currentPath) or $currentPath='__Global__'">
				<xsl:value-of select="''"/>
			</xsl:when>
			<xsl:otherwise>
				<xsl:if test="contains($currentPath,'.')">
					<xsl:call-template name="getRelativePath">
						<xsl:with-param name="currentPath" select="substring-after($currentPath,'.')"/>
					</xsl:call-template>
				</xsl:if>
				<xsl:value-of select="'../'"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="lastIndexOf">
		<xsl:param name="string"/>
		<xsl:param name="char"/>
		<xsl:choose>
			<xsl:when test="contains($string, $char)">
				<xsl:call-template name="lastIndexOf">
					<xsl:with-param name="string" select="substring-after($string, $char)"/>
					<xsl:with-param name="char" select="$char"/>
				</xsl:call-template>
			</xsl:when>
			<xsl:otherwise>
				<xsl:value-of select="$string"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template match="apiClassifierDetail">
		<apiClassifierDetail>
			<xsl:apply-templates select="node()"/>
		</apiClassifierDetail>
	</xsl:template>
	<xsl:template match="apiClassifierDef">
		<apiClassifierDef>
			<xsl:apply-templates select="node()"/>
		</apiClassifierDef>
	</xsl:template>
	<xsl:template match="shortdesc">
		<xsl:choose>
			<xsl:when test="parent::apiValue/apiValueDetail/apiValueDef/apiInheritDoc">
				<xsl:if test="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseClassifier or ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseInterface ">
					<xsl:call-template name="getInheritDocText">
						<xsl:with-param name="baseClass" select="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
						<xsl:with-param name="implementedInterface" select="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseInterface"/>
						<xsl:with-param name="descriptionType" select="'shortdesc'"/>
						<xsl:with-param name="entryType" select="'apiValue'"/>
						<xsl:with-param name="nameToMatch" select="parent::apiValue/apiName"/>
					</xsl:call-template>
				</xsl:if>
			</xsl:when>
			<xsl:when test="@conref">
				<xsl:variable name="entryType" select="'property'"/>
				<xsl:variable name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
				<shortdesc>
					<xsl:if test="normalize-space(.)">
						<xsl:apply-templates select="node()"/>
					</xsl:if>
					<xsl:call-template name="getConRefText">
						<xsl:with-param name="conref" select="@conref"/>
						<xsl:with-param name="descriptionType" select="'shortdesc'"/>
						<xsl:with-param name="entryType" select="$entryType"/>
						<xsl:with-param name="currentPackage" select="$currentPackage"/>
					</xsl:call-template>

				</shortdesc>
			</xsl:when>
			<xsl:otherwise>
				<shortdesc>
					<xsl:apply-templates select="node()"/>
				</shortdesc>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template match="apiDesc">
		<xsl:choose>
			<xsl:when test="@conref">
				<xsl:variable name="entryType" select="'property'"/>
				<xsl:variable name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
				<apiDesc>
					<xsl:if test="normalize-space(.)">
						<p class="- topic/p ">
							<xsl:apply-templates select="node()"/>
						</p>
					</xsl:if>
					<xsl:call-template name="getConRefText">
						<xsl:with-param name="conref" select="@conref"/>
						<xsl:with-param name="descriptionType" select="'apiDesc'"/>
						<xsl:with-param name="entryType" select="$entryType"/>
						<xsl:with-param name="currentPackage" select="$currentPackage"/>
					</xsl:call-template>
				</apiDesc>
			</xsl:when>
		</xsl:choose>
		<xsl:choose>
			<xsl:when test="not(parent::apiValueDetail/apiValueDef/apiInheritDoc)">
				<apiDesc>
					<xsl:apply-templates select="node()"/>
				</apiDesc>
			</xsl:when>
			<xsl:when test="parent::apiValueDetail/apiValueDef/apiInheritDoc">
				<xsl:if test="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseClassifier or ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseInterface ">
					<xsl:call-template name="getInheritDocText">
						<xsl:with-param name="baseClass" select="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
						<xsl:with-param name="implementedInterface" select="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseInterface"/>
						<xsl:with-param name="descriptionType" select="'apiDesc'"/>
						<xsl:with-param name="entryType" select="'apiValue'"/>
						<xsl:with-param name="nameToMatch" select="ancestor::apiValue/apiName"/>
					</xsl:call-template>
				</xsl:if>
			</xsl:when>
		</xsl:choose>
	</xsl:template>
	<xsl:template match="related-links">
		<related-links>
			<xsl:apply-templates select="node()"/>
		</related-links>
	</xsl:template>
	<xsl:template match="example">
		<example>
			<xsl:apply-templates select="node()"/>
		</example>
	</xsl:template>
	<xsl:template match="prolog">
		<prolog>
			<xsl:apply-templates select="node()"/>
		</prolog>
	</xsl:template>
	<xsl:template match="styles"/>
	<xsl:template match="node()">
		<xsl:copy copy-namespaces="no">
			<xsl:copy-of select="@*"/>
			<xsl:apply-templates select="node()"/>
		</xsl:copy>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/help.js
================================================
////////////////////////////////////////////////////////////////////////////////
//
//  ADOBE SYSTEMS INCORPORATED
//  Copyright 2008 Adobe Systems Incorporated
//  All Rights Reserved.
//
//  NOTICE: Adobe permits you to use, modify, and distribute this file
//  in accordance with the terms of the license agreement accompanying it.
//
////////////////////////////////////////////////////////////////////////////////


function closePopup()
{
  window.close();
}
function scrollToNameAnchor() 
{
	var nameAnchor = window.location.href;
	var value = nameAnchor.split("nameAnchor=");
	
	if (value[1] != null) { 
		document.location =value[0]+"#"+ value[1];
	}
}
// HIDES AND SHOWS LARGE GRAPHICS IN THE CONTENT PAGES
function showHideImage(thisID, obj) 
{
	
	var imgElement = document.getElementById(thisID);
	var imgText = obj;

	if( imgElement.className == "largeImage" )
	{
			imgElement.src = "images/" + thisID + ".png";
			imgElement.className="smallImage";
			obj.className="showImageLink";
			obj.href="#";
			obj.firstChild.nodeValue = terms_AHV_LARGE_GRAPHIC;
			window.focus();
	}
	else
	{
			imgElement.src = "images/" + thisID + "_popup.png";
			imgElement.className="largeImage";
			obj.className="hideImageLink";
			obj.href="#";
			obj.firstChild.nodeValue = terms_AHV_SMALL_GRAPHIC;
			window.focus();
	}
}
// js function for expand collapse menu functionality
function KeyCheck(e, tree, idx)
{
  var KeyID = (window.event) ? event.keyCode : e.keyCode;
  var node =  YAHOO.widget.TreeView.getNode(tree, idx);
   switch(KeyID)
   {
      case 37:
     // alert("Arrow Left");
      node.collapse();
      break;
      case 39:
     // alert("Arrow Right");
      node.expand();
      break;
   }
}
// js function for hide/display mini-elements functionality
function toggleLayer(whichLayer) {
	if (document.getElementById) {
		// this is the way the standards work
		var obj=document.getElementById(whichLayer);
		var img = obj.previousSibling.firstChild.firstChild;
		img.setAttribute("src","images/on.gif");
		var styleatt = obj.style;
		styleatt.display = styleatt.display? "":"block";
		
		//change the class of the h3 per design
		if (obj.previousSibling.className === "topictitle3")	{
			obj.previousSibling.className ="topictitle3off";
		    img.setAttribute("src","images/on.gif");
		} else if (obj.previousSibling.className === "topictitle3off")	{
			obj.previousSibling.className ="topictitle3";
			img.setAttribute("src","images/off.gif");
		} 
	}
	else if (document.all) {
		// this is the way old msie versions work
		var style2 = document.all[whichLayer].style;
		style2.display = style2.display? "":"block";
	}
}
 function addBookmark( bm_url_str, bm_str_label ) {
  parent.navigation.flashProxy.call('addBookmark', bm_url_str, bm_str_label );
}

var upperAsciiXlatTbl = new Array(
223,"ss",
230,"ae",
198,"ae",
156,"oe",
140,"oe",
240,"eth",
208,"eth",
141,"y",
159,"y"
);

var maxNumberOfShownSearchHits = 30;
var showInputStringAlerts = 0;
var navigationCookie = "";

////////////// COOKIE-RELATED FUNCTIONS /////////////////////////////////////////
//  test the navigator object for cookie enabling
//  additional code would need to be added for
//  to support browsers pre navigator 4 or IE5 or 
//  other browsers that dont support
//  the navigator object if any .. 
 function cookiesNotEnabled() 
{
	return true;     // We're not going to use cookies
}
/*
 * This function parses comma-separated name=value 
 * argument pairs from the query string of the URL. 
 * It stores the name=value pairs in 
 * properties of an object and returns that object.
 */
function getArgs() 
{
	var args = new Object();
	var query = window.location.search.substring(1); 
	// Get query string
	if (query.length > 0)	{
		var pairs = query.split(",");
		// Break at comma
		for(var i = 0; i < pairs.length; i++) 
		{
			var pos = pairs[i].indexOf('=');
			  // Look for "name=value"
			if (pos == -1) continue;
			  // If not found, skip
			var argname = pairs[i].substring(0,pos);
			  // Extract the name
			var value = pairs[i].substring(pos+1);
			  // Extract the value
			args[argname] = unescape(value);
		  	  // Store as a property
			  // In JavaScript 1.5, use decodeURIComponent(  ) 
			  // instead of escape(  )
		}
	} else {
		args[name] = false;		
	}
	return args;     // Return the object
}

/////////////////////////////// COOKIE-RELATED FUNCTIONS ////////////////////////
// Bill Dortch getCookieVal and GetCookie routines
function getCookieVal(offset) {
  var endstr=document.cookie.indexOf(";",offset);
  if (endstr==-1)endstr=document.cookie.length;
  return unescape(document.cookie.substring(offset, endstr));
}
function GetCookie(name) {
  var arg=name+"=";
  var alen=arg.length;
  var clen=document.cookie.length;
  var i=0;

  if (cookiesNotEnabled())
  {
	var args = getArgs();
	if (args[name] !== false) { 
		return args[name];
	}	
  } else {
	  while(i<clen){
	    var j=i+alen;
	    if(document.cookie.substring(i,j)==arg)return getCookieVal(j);
	    i=document.cookie.indexOf(" ",i)+1;
	    if(i==0)break; 
	  }
	  return null;
	}
}
function getTopCookieVal(offset) {
  var endstr=document.cookie.indexOf(";",offset);
  if (endstr==-1)endstr=document.cookie.length;
  return unescape(document.cookie.substring(offset, endstr));
}
function GetTopCookie(name) {
  var arg=name+"=";
  var alen=arg.length;
  var clen=document.cookie.length;
  var i=0;
  while(i<clen){
    var j=i+alen;
    if(document.cookie.substring(i,j)==arg)return getTopCookieVal(j);
    i=document.cookie.indexOf(" ",i)+1;
    if(i==0)break; 
  }
  return null;
}
// SetCookie
// -----------
// This function is called to set a cookie in the current document.
//  params:
//		n - name of the cookie
//		v - value of the cookie
//		minutes - the duration of the cookie in minutes (that is, how many minutes before it expires)
function SetCookie(n,v,minutes) {
 var Then = new Date();
 Then.setTime(Then.getTime() + minutes * 60 * 1000);
 document.cookie = n + "=" + v + ";expires=" + Then.toGMTString();
}
// getContentCookie
// ----------------
// This function reads the content cookie set by the handleContext funtion.
//
function getContentCookie()
{
	var contentCookie = GetCookie("content");
	document.cookie = "content=";

	// What does this expression mean?
	// (contentCookie.indexOf("htm") != -1)
	if ( (contentCookie != null) && (contentCookie.indexOf("htm") != -1) ) 
	{
		document.cookie = "content="; // Wipe out the cookie
		document.cookie = "histR=" + contentCookie;
		location.replace(contentCookie);
	}			
}
// getNavigationCookie
// -------------------
// This function reads the content cookie set by the handleContext funtion.
//
function getNavigationCookie()
{
	navigationCookie = GetCookie("navigation");
	document.cookie = "navigation=";

	// What does this expression mean?
	// (navigationCookie.indexOf("htm") != -1)
	if ( (navigationCookie != null) && (navigationCookie.indexOf("htm") != -1) ) 
	{
		document.cookie = "navigation="; // Wipe out the cookie
		document.cookie = "histL=" + navigationCookie;
		location.replace(navigationCookie);
	}
				
}

// handleContext
// -------------
// This function is called from content pages. It sets a cookie as soon
// as the page is loaded. If the content page is not in it's proper place
// in the frameset, the frameset will be loaded and the page will be 
// restored using the value in this cookie.
//
function handleContext(which)
{
}
// lastNodeOf
// ----------
// This function gets passed a URL and returns the last node of same.
function lastNodeOf(e)
{
	var expr = "" + e;
	var to = expr.indexOf("?");
	if( to !== -1) {
		var path = expr.substring(0,to);		
		var pieces = path.split("/");
		return pieces[pieces.length -1];
	}  else	{	
		var pos = expr.lastIndexOf("/");	
		if( (pos != -1) && (pos+1 != expr.length) ) {
			return expr.substr(pos+1);
		} else {
			return expr;
		}
	}
}
// frameBuster
// -----------
// This function is called by the frameset to ensure it's always loaded
// at the top level of the current window.
//
function frameBuster()
{
}


// SEARCH RELATED.......................................SEARCH RELATED
// SEARCH RELATED.......................................SEARCH RELATED
// SEARCH RELATED.......................................SEARCH RELATED
// SEARCH RELATED.......................................SEARCH RELATED
// SEARCH RELATED.......................................SEARCH RELATED
// SEARCH RELATED.......................................SEARCH RELATED
// SEARCH RELATED.......................................SEARCH RELATED
// SEARCH RELATED.......................................SEARCH RELATED
// SEARCH RELATED.......................................SEARCH RELATED
// SEARCH RELATED.......................................SEARCH RELATED
function bubbleSortWithShadow(a,b)
{
	var temp;
	for(var j=1; j<a.length; j++) {
		for(var i=0; i<j; i++) {
			if( a[i] < a[j] ) {	
				temp = a[j];a[j] = a[i];a[i] = temp;
				temp = b[j];b[j] = b[i];b[i] = temp;
			}
		}
	}
}
//---------------------------------------------------
function buildHtmlResultsStr()
{
	var innerHTMLstring,ndxEnd;

	// Gather all of the results display lines into the 'resultsArr'
	ndxEnd = (matchesArrIndices.length > maxNumberOfShownSearchHits ) ? maxNumberOfShownSearchHits : matchesArrIndices.length;

	for(var ndx=0, resultsArr = new Array(); ndx < ndxEnd; ndx++) {
		resultsArr[resultsArr.length] = buildResultsStrOneLine(matchesArrIndices[ndx],matchesArrHits[ndx]);
	}

	// Convert this 'resultsArr' into a single string that will be injected into this search page.
	innerHTMLstring = "<ol>";
	for( var ndx=0; ndx < resultsArr.length; ndx++ ) {
		innerHTMLstring = innerHTMLstring + resultsArr[ndx];
	}
	innerHTMLstring = innerHTMLstring + "</ol>";
	return innerHTMLstring;
}
//---------------------------------------------------
function buildResultsStrOneLine(a,b)
{
	var retStr;
	retStr = "<li class=\"searchresults\"><a href=\"" + fileArr[a] + ".html\">";

	// for debug...
	//retStr += "target=\"content\" ";
	//retStr += "title=\"" + top.fileArr[a] + ".html-";
	//retStr += a + "-" + b + "\">";

	// for production...
	//retStr += "target=\"AdobeHelp\" >";

	retStr += titleArr[a] + "</a></li>";
	return retStr;
}
//---------------------------------------------------
// checkForHits
//  Break up the search term into words.
//  Check each of those words against...
//		(a) cached titles and 
//		(b) cached content lines 
//  Perform the hit detection for each one, 
//  storing the results into (hits-ordered) 
//		'matchesArrIndices' and 
//		'matchesArrHits'.
//---------------------------------------------------
function checkForHits()
{
	var inputWords = new Array();
	var tempArr = new Array();

	// Split the search term into individual search words
		tempArr = searchTerm.split(" ");
		for(var ndx=0; ndx < tempArr.length; ndx++) {
			if( tempArr[ndx].length ) {
				inputWords[inputWords.length] = tempArr[ndx];
			}
		}

	// Initialization
		matchesArrHits = new Array();
		matchesArrIndices = new Array();

	// Initialize the 'maskArr' and the 'hitsArr'
		maskArr = new Array();
		hitsArr = new Array();
		for( var ndx = 0; ndx < fileArr.length; ndx++ ) {
			maskArr[maskArr.length] = 1;
			hitsArr[hitsArr.length] = 0;
		}

	// Do checking for matches on EACH OF THE INPUT WORDS
		for( var ndx = 0; ndx < inputWords.length; ndx++ ) {

			// !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
			if( ! checkForHitsWordAgainstPages( inputWords[ndx] ) ) {
				return; 	// No sense in continuing, match has failed.
			}
			// !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

			for( var ndx2 = 0; ndx2 < hitsArr.length; ndx2++ ) {
				if( hitsArr[ndx2] == 0 ) {
					maskArr[ndx2] = 0;
				}
				else {
					if( maskArr[ndx2] != 0 ) {
						maskArr[ndx2] += hitsArr[ndx2];
					}
				}
			}
		}

	// From the final 'maskArr', generate 'matchesArrHits' and 'matchesArrIndices'	
		for( var ndx = 0; ndx < maskArr.length; ndx++ ) {
			if( maskArr[ndx] ) {
				matchesArrHits[matchesArrHits.length] = maskArr[ndx];
				matchesArrIndices[matchesArrIndices.length] = ndx;
			}
		}

	// If there were any hits, then sort them by highest hits first
		if( matchesArrIndices.length ) {
			bubbleSortWithShadow(matchesArrHits, matchesArrIndices);
		}
}
//---------------------------------------------------
function checkForHitsWordAgainstPages(w)		
{
	var hitAnywhere = 0;
	
	if(showInputStringAlerts){alert( "Length of sc2: " + sc2.length );}

	// Process each of the content lines (one per file/page)
		for(var ndx=0; ndx < sc2.length; ndx++) {

			// Put the cached title into glob_title
				glob_title = sc1[ndx];

			// Put the cached content line into glob_phrase
				glob_phrase = sc2[ndx];
				
			if( maskArr[ndx] ) {
			// !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
				if( document.isDblByte ) {
					hitsArr[ndx] = checkForHitsWordAgainstTitleAndLine2(w,ndx);
				}
				else {
					hitsArr[ndx] = checkForHitsWordAgainstTitleAndLine(w,ndx);
				}
				if( hitsArr[ndx] ) {
					hitAnywhere = 1;
				}
			// !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
			}
		}
	return hitAnywhere;
}
//---------------------------------------------------
function checkForHitsWordAgainstTitleAndLine(w, lineNdx)
{
	var words;
	var titleHitCnt = 0;
	var contentHitCnt = 0;
	var regex = new RegExp(w, "i");

	// TITLE .........................................
		words = new Array();
		if(glob_title!=null){
			words = glob_title.split(" ");
		}
		// EXECUTE TITLE MATCH TEST
		for( var ndx = 0; ndx < words.length; ndx++ ) {
			if( w == words[ndx] ) {
				titleHitCnt += 100;
				break;
			}
		}

	// CONTENT .........................................
		words = new Array();
		if(glob_phrase!=null){
			words = glob_phrase.split(" ");
		}
		// EXECUTE CONTENT MATCH TEST
		if( regex.test(glob_phrase) ) {	// See if word is anywhere within the phrase first.
			for( var ndx = 0; ndx < words.length; ndx++ ) {
				if( w == words[ndx] ) {
					contentHitCnt += getInstanceCount(lineNdx,ndx);
					break;
				}
				//else if( w < words[ndx] ) { // If word is greater than the remaining words, leave
				//	break;
				//}
			}
		}

	return titleHitCnt + contentHitCnt;
}
//---------------------------------------------------
function checkForHitsWordAgainstTitleAndLine2(w, lineNdx)
{
	var titleHitCnt = 0;
	var contentHitCnt = 0;

	// TITLE .........................................
		if( glob_title.indexOf(w) != -1 ) {
			titleHitCnt = 100;
		}

	// CONTENT .........................................
		contentHitCnt = indexesOf(glob_phrase,w);

	return titleHitCnt + contentHitCnt;
}
//---------------------------------------------------
// checkTheInputString
// 
//  returns...
//		empty string - if there is valid input to search
//		message string - if there is NO VALID INPUT to search
//---------------------------------------------------
function checkTheInputString()
{
	var myArr = new Array();
	var tempArr = new Array();
	var foundStopOrShortWord = 0;
	var ptn1 = /\d\D/;
	var ptn2 = /\D\d/;

	handleWhitespaceRemoval();
	searchTerm = searchTerm.replace (/(%20)+/g," ") ;
	searchTerm = searchTerm.toLowerCase();

	searchTerm = filterTheChars(searchTerm);
		
	handleWhitespaceRemoval();

	if( searchTerm.length ) {
		
		// Split the searchTerm
			tempArr = searchTerm.split(" ",100);
			if(showInputStringAlerts){alert( "size of tempArr: " + tempArr.length );}

		// Handle periods
			for( var ndx = 0; ndx < tempArr.length; ndx++ ) {
				if( tempArr[ndx].charCodeAt(0) == 46 ) {	// periods at the start of word
					//tempArr[ndx] = tempArr[ndx].substr(1); // NOTE: We don't want to do this. (e.g. ".txt")
				}
				if( tempArr[ndx].charCodeAt(tempArr[ndx].length-1) == 46 ) { // end of word
					tempArr[ndx] = tempArr[ndx].substr(0,tempArr[ndx].length-1);
				}
			}
			
		// Do stopwords and shortwords removal
			for( var ndx = 0; ndx < tempArr.length; ndx++ ) {
				var word = tempArr[ndx];
				if(showInputStringAlerts){alert( "Checking word: " + word );}
				
				if( ! sw[word] ) {
					if( word.length < 2 ) {
						foundStopOrShortWord = 1;
					}
					else if( (word.length > 2) || (ptn1.test(word) || ptn2.test(word)) ) {
						myArr[myArr.length] = tempArr[ndx];
					}
					else {
						foundStopOrShortWord = 1;
					}
				}
				else {
					foundStopOrShortWord = 1;
				}
			}

		// Now reconstruct the searchTerm, based upon the 'myArr'
			searchTerm = "";
			for( var ndx = 0; ndx < myArr.length; ndx++ ) {
				searchTerm = searchTerm + myArr[ndx] + " ";
			}

		handleWhitespaceRemoval();

		if(showInputStringAlerts){alert( "FINAL SEARCH TERM: *" + searchTerm + "*" );}
			
		if( foundStopOrShortWord && ! searchTerm.length ) {
			return MSG_stopAndShortWords;
		}
		srch_input_massaged = searchTerm;
		return "";
	} 
	else {
		return MSG_noSearchTermEntered;
	}
}
//---------------------------------------------------
function checkTheInputString2()		// double-byte version
{
	var tempArr = new Array();

	handleWhitespaceRemoval();
	searchTerm = searchTerm.toLowerCase();

	if( searchTerm.length ) {

		// Split the searchTerm
			tempArr = searchTerm.split(" ",100);
			if(showInputStringAlerts){alert( "number of search terms: " + tempArr.length );}

		// Now reconstruct the searchTerm, based upon the 'tempArr'
			searchTerm = "";
			for( var ndx = 0; ndx < tempArr.length; ndx++ ) {
				searchTerm = searchTerm + tempArr[ndx] + " ";
			}
			handleWhitespaceRemoval();

if(showInputStringAlerts){alert( "Massaged search term: " + searchTerm );}

		srch_input_massaged = searchTerm;
		return "";
	}
	else {
		return MSG_noSearchTermEntered;
	}
}
//---------------------------------------------------
function doIEsearch()
{
	var stStr = "";
			
	document.forms[0].sh_term.value = srch_input_verbatim;
	
	if( srch_message.length ) {
		document.getElementById("results").innerHTML = srch_message;
		srch_message = "";
	}
	else if( srch_1_shot ) {
		srch_1_shot = 0;
		
		searchTerm = srch_input_massaged;
		checkForHits();	// Sets: 'matchesArrIndices' and 'matchesArrHits'

		if( matchesArrIndices.length ) {	// If there were matches/hits...  /* Changed for CS4 */

			stStr = "<div class=\"form\">" + MSG_pagesContaining + "<strong>" + srch_input_massaged + "</strong></div><br /><br />\n";

			document.getElementById("results").innerHTML = stStr + buildHtmlResultsStr();
		}
		else {                                                  /* Changed for CS4 */
			document.getElementById("results").innerHTML = MSG_noPagesContain + "<strong>" + srch_input_massaged + "</strong><br /><br />";

		}
		//searching_message.style.visibility="visible";
	}
	srch_input_verbatim = "";
}
//---------------------------------------------------
function getInstanceCount( lineIndex, wordIndex )
{
	var instancesStr = instances[lineIndex];	// e.g. "1432931"
	var ch = instancesStr.substr(wordIndex,1);
	
	return parseInt(ch);
}
//---------------------------------------------------
function handleWhitespaceRemoval()
{
	var re_1 = /^\s/;
	var re_2 = /\s$/;
	var re_3 = /\s\s/;
	var temp;

	// Remove leading whitespace
		while( true ) {
			temp = searchTerm.replace(re_1,"");
			if( temp == searchTerm ) {
				break;
			}
			searchTerm = temp;
		}
	// Remove trailing whitespace
		while( true ) {
			temp = searchTerm.replace(re_2,"");
			if( temp == searchTerm ) {
				break;
			}
			searchTerm = temp;
		}
	// Replace multiple contiguous spaces with a single space
		while( searchTerm.search(re_3) != -1 ) {
			temp = searchTerm.replace(re_3," ");
			searchTerm = temp;
		}
}
//--------------------------------------------------
function isAcceptableChar(chrNdx)
{
	var acceptableChars = new Array( 32, 46, 95 );	// space, period, underscore
	
	for( var ndx = 0; ndx < acceptableChars.length; ndx++ ) {
		if( chrNdx == acceptableChars[ndx] ) {
			return true;
		}
	}
	return false;
}
//--------------------------------------------------
function indexesOf(str,ptn)
{
	var position = 0;
	var hits = -1;
	var start = -1;

	while( position != -1 ) {
		position = str.indexOf(ptn, start+1);
		hits += 1;
		start = position;
	}
	return hits;
}
//--------------------------------------------------
function filterTheChars(line)
{
	var retStr = "",tempStr;
	var ch, chCode, retChr;
	var ndx;
	
	for( ndx = 0; ndx < line.length; ndx++ ) {
		ch = line.substr(ndx,1);
		chCode = ch.charCodeAt(0);
		
		
			if( (chCode >= 192) && (chCode <= 221) ) {	// Handle capital upper-ASCII characters
				chCode = chCode + 32;
				retChr = ASCII_to_char(chCode);
			}
			else if( withinAcceptableRanges(chCode) || isAcceptableChar(chCode) ) { // Acceptable characters
				retChr = ch;
			}
			else {
				tempStr = isLigatureChar(chCode);

				if( tempStr.length ) {	//Don't replace ligatures.
					retChr = ch;
				}
				else {		// Turn all else into space	
					retChr = " ";
				}
			}

		// Grow the return string
			retStr += retChr;
	}
	
	return retStr;
}
//--------------------------------------------------
function isLigatureChar(codeToCheck) {
	var xlatTblNdx, code, replStr = "";

	for( xlatTblNdx = 0; xlatTblNdx < upperAsciiXlatTbl.length; xlatTblNdx+=2 ) {

		code = upperAsciiXlatTbl[xlatTblNdx];
		if( code == codeToCheck ) {
			replStr = upperAsciiXlatTbl[xlatTblNdx+1];
			break;
		}
	}
	
	return replStr;
}
//--------------------------------------------------
function respondToSearchButton() 
{
	var myStr;
	document.getElementById("results").innerHTML = ""; //We don't expect this to be slow enough to need a message.	
	srch_input_verbatim = document.forms[0].sh_term.value;
	searchTerm = document.forms[0].sh_term.value;
	
	if( document.isDblByte ) {
		myStr = checkTheInputString2();
	}
	else {
		myStr = checkTheInputString();	
	}
	
	srch_message = myStr;
	srch_1_shot = srch_message.length ? 0 : 1;
	
	doIEsearch();
}
//--------------------------------------------------
function respondToSearchLoad() 
{
	var externalQuery = GetCookie("externalQuery");
	if (externalQuery == null) { 
			externalQuery = GetCookie("sh_term");
	}

	if (externalQuery != null) { 
		var myStr;
		srch_input_verbatim = externalQuery;
		searchTerm = externalQuery;
	
		if(document.isDblByte ) {
		  myStr = checkTheInputString2();
		}
		else {
		  myStr = checkTheInputString();	
		}
		
		srch_message = myStr;
		srch_1_shot = srch_message.length ? 0 : 1;
		
		doIEsearch();
	}
}
//---------------------------------------------------
function strReplace(orig,src,dest)
{
	var startPos=0;
	var matchPos = orig.indexOf(src,startPos);
	var retLine="";
	
	while(matchPos != -1) {
		retLine = retLine + orig.substring(startPos,matchPos) + dest;
		startPos = matchPos+1;
		matchPos = orig.indexOf(src,startPos);
	}
	if(! retLine.length) {return orig;}
	else {return retLine+orig.substring(startPos,orig.length);}
}
//--------------------------------------------------
function withinAcceptableRanges(chrNdx)
{	
	var acceptableRanges = new Array( "48-57","65-90","97-122","224-229","231-239","241-246","248-253","255-255");
	
	for( var ndx = 0; ndx < acceptableRanges.length; ndx++ ) {
		var start_finish = new Array();

		start_finish = acceptableRanges[ndx].split("-");
		
		if( (chrNdx >= start_finish[0]) && (chrNdx <= start_finish[1]) ) {
			return true;
		}
	}
	return false;
}
//--------------------------------------------------
function ASCII_to_char(num_in)
{
	var str_out = "";
	var num_out = parseInt(num_in);
	
	num_out = unescape('%' + num_out.toString(16));
	str_out += num_out;
	
	return unescape(str_out);
}
//--------------------------------------------------
var agt=navigator.userAgent.toLowerCase();
var use_ie_behavior = false;
var use_ie_6_behavior = false;
if (agt.indexOf("msie") != -1) {
  use_ie_behavior = true;
}
if ((agt.indexOf("msie 5") != -1) || (agt.indexOf("msie 6") != -1)) {
  use_ie_6_behavior = true;
}

//--------------------------------------------------

var Url = {

	// public method for url encoding
	encode : function (string) {
		return escape(this._utf8_encode(string));
	},

	// public method for url decoding
	decode : function (string) {
		return this._utf8_decode(unescape(string));
	},

	// private method for UTF-8 encoding
	_utf8_encode : function (string) {
		string = string.replace(/\r\n/g,"\n");
		var utftext = "";

		for (var n = 0; n < string.length; n++) {

			var c = string.charCodeAt(n);

			if (c < 128) {
				utftext += String.fromCharCode(c);
			}
			else if((c > 127) && (c < 2048)) {
				utftext += String.fromCharCode((c >> 6) | 192);
				utftext += String.fromCharCode((c & 63) | 128);
			}
			else {
				utftext += String.fromCharCode((c >> 12) | 224);
				utftext += String.fromCharCode(((c >> 6) & 63) | 128);
				utftext += String.fromCharCode((c & 63) | 128);
			}

		}

		return utftext;
	},

	// private method for UTF-8 decoding
	_utf8_decode : function (utftext) {
		var string = "";
		var i = 0;
		var c = c1 = c2 = 0;

		while ( i < utftext.length ) {

			c = utftext.charCodeAt(i);

			if (c < 128) {
				string += String.fromCharCode(c);
				i++;
			}
			else if((c > 191) && (c < 224)) {
				c2 = utftext.charCodeAt(i+1);
				string += String.fromCharCode(((c & 31) << 6) | (c2 & 63));
				i += 2;
			}
			else {
				c2 = utftext.charCodeAt(i+1);
				c3 = utftext.charCodeAt(i+2);
				string += String.fromCharCode(((c & 15) << 12) | ((c2 & 63) << 6) | (c3 & 63));
				i += 3;
			}

		}

		return string;
	}

}


================================================
FILE: documentation/api-reference/templates/index-list.html
================================================
<html>
<head>
	<title>ActionScript 3.0 Language and Components Reference</title>
	<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
	<link rel="stylesheet" href="style.css" type="text/css" />
	<base target="classFrame" />
</head>

<body class="classFrameContent">
<h3> Index
</h3>
<table cellpadding="0" cellspacing="5" width="100%">
<tbody>
<!--
<tr>
	<td colspan="2"><a href="all-index-Symbols.html">Symbols</a></td>
</tr>
-->
<tr>
<td><a href="all-index-A.html">A</a></td>
<td><a href="all-index-N.html">N</a></td>
</tr>
<tr>
<td><a href="all-index-B.html">B</a></td>
<td><a href="all-index-O.html">O</a></td>
</tr>
<tr>
<td><a href="all-index-C.html">C</a></td>
<td><a href="all-index-P.html">P</a></td>
</tr>
<tr>
<td><a href="all-index-D.html">D</a></td>
<td><a href="all-index-Q.html">Q</a></td>
</tr>
<tr>
<td><a href="all-index-E.html">E</a></td>
<td><a href="all-index-R.html">R</a></td>
</tr>
<tr>
<td><a href="all-index-F.html">F</a></td>
<td><a href="all-index-S.html">S</a></td>
</tr>
<tr>
<td><a href="all-index-G.html">G</a></td>
<td><a href="all-index-T.html">T</a></td>
</tr>
<tr>
<td><a href="all-index-H.html">H</a></td>
<td><a href="all-index-U.html">U</a></td>
</tr>
<tr>
<td><a href="all-index-I.html">I</a></td>
<td><a href="all-index-V.html">V</a></td>
</tr>
<tr>
<td><a href="all-index-J.html">J</a></td>
<td><a href="all-index-W.html">W</a></td>
</tr>
<tr>
<td><a href="all-index-K.html">K</a></td>
<td><a href="all-index-X.html">X</a></td>
</tr>
<tr>
<td><a href="all-index-L.html">L</a></td>
<td><a href="all-index-Y.html">Y</a></td>
</tr>
<tr>
<td><a href="all-index-M.html">M</a></td>
<td><a href="all-index-Z.html">Z</a></td>
</tr>
</tbody></table>
</body></html>


================================================
FILE: documentation/api-reference/templates/index.html
================================================
<html>
<head>
    <title>ActionScript 3.0 Language and Components Reference</title>
    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
    <script language="javascript" type="text/javascript">
    	<!--
        window.onload=function(){
            var d=document.location.search;
			var args=d.substring(d.lastIndexOf('?')+1,d.length);
			var classFrameContent=args;
			var classListFrameContent='';
			if (args.indexOf('&') != -1) {
				classFrameContent = args.substring(0,args.indexOf('&'));
				classListFrameContent = args.substring(args.indexOf('&')+1,args.length);
			}
            if(classFrameContent!='')
            	top.frames['classFrame'].document.location.href=classFrameContent;
			if(classListFrameContent!='')
				top.frames['packageFrame'].frames['classListFrame'].document.location.href=classListFrameContent;
        }
        -->
    </script>
</head>
<frameset cols="175,*" border="2" bordercolor="#AAAAAA" framespacing="1">
       <frame src="package-frame.html" name="packageFrame" scrolling="no" />
       <frameset rows="80,*" border="0" bordercolor="#AAAAAA">
       		<frame src="title-bar.html" name="titlebar" scrolling="no" frameborder="0" />
       		<frame src="package-summary.html" name="classFrame" frameborder="0" />
    	</frameset>
    <noframes>
	<body>
        <h2>Frame Alert</h2>
        <p>
        This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client.
        <br />
        Link to <a href="package-summary.html">Non-frame version.</a>
        </p>
        </body>
    </noframes>
</frameset>
</html>


================================================
FILE: documentation/api-reference/templates/merge_dita_xml.xslt
================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
    <xsl:param name="ditaFileDir" select="''"/>
    <xsl:template match="/">
                <allClasses>
                    <xsl:apply-templates select="//apiItemRef">
                        <xsl:sort select="@href" order="ascending"/>
                    </xsl:apply-templates>
                </allClasses>
    </xsl:template>
    <xsl:template match="apiItemRef">
        <xsl:variable name="ditaFileName">
            <xsl:value-of select="concat($ditaFileDir,@href)"/>
        </xsl:variable>
        <xsl:for-each select="document($ditaFileName)/apiPackage">
            <xsl:copy-of select="."/>
        </xsl:for-each>
    </xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/methodSummary.xslt
================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://sf.net/saxon" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ifn="urn:internal:functions"
	xmlns:ditaarch="http://dita.oasis-open.org/architecture/2005/" exclude-result-prefixes="saxon xs ifn ditaarch">
	<xsl:character-map name="disable">
		<xsl:output-character character="&#146;" string="&apos;"/>
	</xsl:character-map>
	<xsl:output method="xml" version="1.0" encoding="UTF-8" indent="no" use-character-maps="disable"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:template match="/">
		<allClasses>
			<xsl:apply-templates select="//apiItemRef">
				<xsl:sort select="@href" order="ascending"/>
			</xsl:apply-templates>
		</allClasses>
	</xsl:template>
	<xsl:template match="apiItemRef">
		<xsl:variable name="ditaFileName">
			<xsl:value-of select="concat($ditaFileDir,@href)"/>
		</xsl:variable>
		<xsl:for-each select="document($ditaFileName)/apiPackage">
			<apiPackage id="{@id}">
				<apiName>
					<xsl:value-of select="./apiName"/>
				</apiName>
				<xsl:apply-templates select="apiClassifier"/>
			</apiPackage>
		</xsl:for-each>
	</xsl:template>

	<xsl:template match="apiClassifier">
		<apiClassifier id="{@id}">
			<apiName>
				<xsl:value-of select="./apiName"/>
			</apiName>
			<xsl:apply-templates select="apiClassifierDetail"/>
			<xsl:apply-templates select="apiOperation"/>
			<xsl:apply-templates select="apiConstructor" mode="apiCon"/>
		</apiClassifier>
	</xsl:template>
	<xsl:template match="apiClassifierDetail">
		<apiClassifierDetail>
			<xsl:apply-templates select="apiClassifierDef"/>
			<xsl:copy-of select="./example" copy-namespaces="no"/>
		</apiClassifierDetail>
	</xsl:template>
	<xsl:template match="apiClassifierDef">
		<apiClassifierDef>
			<xsl:apply-templates select="node()"/>
		</apiClassifierDef>
	</xsl:template>
	<xsl:template match="apiOperation">
		<apiOperation id="{@id}">
			<xsl:apply-templates select="node()"/>
		</apiOperation>
	</xsl:template>
	<xsl:template match="adobeApiEvent">
		<adobeApiEvent id="{@id}">
			<xsl:apply-templates select="node()"/>
		</adobeApiEvent>
	</xsl:template>
	<xsl:template match="apiParam">
		<xsl:variable name="itemName" select="./apiItemName"/>
		<xsl:variable name="itemType" select="./apiType"/>
		<apiParam>
			<xsl:apply-templates select="apiItemName"/>
			<xsl:if test="$itemType">
				<xsl:copy-of select="./apiType" copy-namespaces="no"/>
			</xsl:if>
			<xsl:apply-templates select="apiData"/>
			<xsl:apply-templates select="apiOperationClassifier"/>
			<xsl:choose>
				<xsl:when test="parent::apiOperationDef[apiInheritDoc and apiParam[not(apiDesc) or apiDesc[normalize-space(.) = '']]]">
					<xsl:call-template name="getInheritDocText">
						<xsl:with-param name="baseClass" select="ancestor-or-self::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
						<xsl:with-param name="implementedInterface" select="ancestor-or-self::apiClassifier/apiClassifierDetail/apiBaseInterface"/>
						<xsl:with-param name="descriptionType" select="'paramapiDesc'"/>
						<xsl:with-param name="entryType" select="'apiOperation'"/>
						<xsl:with-param name="nameToMatch" select="ancestor::apiOperation/apiName"/>
						<xsl:with-param name="paramText" select="'apiParam'"/>
						<xsl:with-param name="itemName" select="$itemName"/>
					</xsl:call-template>
				</xsl:when>
				<xsl:otherwise>
					<xsl:apply-templates select="apiDesc"/>
				</xsl:otherwise>
			</xsl:choose>
		</apiParam>
	</xsl:template>
	<xsl:template match="apiReturn">
		<apiReturn>
			<xsl:variable name="itemType" select="./apiType"/>
			<xsl:if test="$itemType">
				<xsl:copy-of select="./apiType" copy-namespaces="no"/>
			</xsl:if>
			<xsl:apply-templates select="apiOperationClassifier"/>
			<xsl:choose>
				<xsl:when test="parent::apiOperationDef[apiInheritDoc and apiReturn[not(apiDesc) or apiDesc[normalize-space(.) = '']]]">
					<xsl:call-template name="getInheritDocText">
						<xsl:with-param name="baseClass" select="ancestor-or-self::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
						<xsl:with-param name="implementedInterface" select="ancestor-or-self::apiClassifier/apiClassifierDetail/apiBaseInterface"/>
						<xsl:with-param name="descriptionType" select="'returnapiDesc'"/>
						<xsl:with-param name="entryType" select="'apiOperation'"/>
						<xsl:with-param name="nameToMatch" select="ancestor::apiOperation/apiName"/>
						<xsl:with-param name="paramText" select="'apiParam'"/>
					</xsl:call-template>
				</xsl:when>
				<xsl:otherwise>
					<xsl:apply-templates select="apiDesc"/>
				</xsl:otherwise>
			</xsl:choose>
		</apiReturn>
	</xsl:template>
	<xsl:template match="apiItemName">
		<apiItemName>
			<xsl:apply-templates select="node()"/>
		</apiItemName>
	</xsl:template>
	<xsl:template match="apiData">
		<apiData>
			<xsl:apply-templates select="node()"/>
		</apiData>
	</xsl:template>
	<xsl:template match="apiOperationClassifier">
		<apiOperationClassifier>
			<xsl:apply-templates select="node()"/>
		</apiOperationClassifier>
	</xsl:template>
	<xsl:template match="shortdesc">
		<xsl:choose>
			<xsl:when test="parent::apiOperation/apiOperationDetail/apiOperationDef/apiInheritDoc">
				<xsl:if test="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseClassifier or ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseInterface ">
					<xsl:call-template name="getInheritDocText">
						<xsl:with-param name="baseClass" select="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
						<xsl:with-param name="implementedInterface" select="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseInterface"/>
						<xsl:with-param name="descriptionType" select="'shortdesc'"/>
						<xsl:with-param name="entryType" select="'apiOperation'"/>
						<xsl:with-param name="nameToMatch" select="parent::apiOperation/apiName"/>
					</xsl:call-template>
				</xsl:if>
			</xsl:when>
			<xsl:when test="@conref">
				<xsl:if test="normalize-space(.)">
					<shortdesc>
						<xsl:apply-templates select="node()"/>
					</shortdesc>
				</xsl:if>
				<xsl:variable name="entryType" select="'method'"/>
				<xsl:variable name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
				<xsl:call-template name="getConRefText">
					<xsl:with-param name="conref" select="@conref"/>
					<xsl:with-param name="descriptionType" select="'shortdesc'"/>
					<xsl:with-param name="entryType" select="$entryType"/>
					<xsl:with-param name="currentPackage" select="$currentPackage"/>
				</xsl:call-template>
			</xsl:when>
			<xsl:otherwise>
				<shortdesc>
					<xsl:apply-templates select="node()"/>
				</shortdesc>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template match="apiDesc">
		<xsl:choose>
			<xsl:when test="@conref">
				<xsl:variable name="entryType" select="'method'"/>
				<xsl:variable name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
				<apiDesc>
					<xsl:if test="normalize-space(.)">
						<p class="- topic/p ">
							<xsl:apply-templates select="node()"/>
						</p>
					</xsl:if>
					<xsl:call-template name="getConRefText">
						<xsl:with-param name="conref" select="@conref"/>
						<xsl:with-param name="descriptionType" select="'apiDesc'"/>
						<xsl:with-param name="entryType" select="$entryType"/>
						<xsl:with-param name="currentPackage" select="$currentPackage"/>
					</xsl:call-template>
				</apiDesc>
			</xsl:when>
			<xsl:when test="parent::apiOperationDetail/apiOperationDef/apiInheritDoc">
				<xsl:if test="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseClassifier or ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseInterface ">
					<xsl:call-template name="getInheritDocText">
						<xsl:with-param name="baseClass" select="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
						<xsl:with-param name="implementedInterface" select="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseInterface"/>
						<xsl:with-param name="descriptionType" select="'apiDesc'"/>
						<xsl:with-param name="entryType" select="'apiOperation'"/>
						<xsl:with-param name="nameToMatch" select="ancestor::apiOperation/apiName"/>
					</xsl:call-template>
				</xsl:if>
			</xsl:when>
			<xsl:otherwise>
				<apiDesc>
					<xsl:apply-templates select="node()"/>
				</apiDesc>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template match="apiConstructor" mode="apiCon">
		<apiConstructor id="{@id}">
			<xsl:apply-templates select="node()"/>
		</apiConstructor>
	</xsl:template>
	<xsl:template name="getInheritDocText">
		<xsl:param name="itemName"/>
		<xsl:param name="paramText"/>
		<xsl:param name="baseClass"/>
		<xsl:param name="implementedInterface"/>
		<xsl:param name="descriptionType"/>
		<xsl:param name="entryType"/>
		<xsl:param name="nameToMatch"/>
		<xsl:param name="itemNameToMatch"/>
		<xsl:param name="doNotProcessTags" select="false()"/>
		<xsl:for-each select="ancestor::apiClassifier/apiClassifierDetail/apiClassifierDef/apiBaseInterface">
			<xsl:call-template name="inheritDocFromInterfaces">
				<xsl:with-param name="implementedInterface" select="."/>
				<xsl:with-param name="descriptionType" select="$descriptionType"/>
				<xsl:with-param name="entryType" select="$entryType"/>
				<xsl:with-param name="nameToMatch" select="$nameToMatch"/>
				<xsl:with-param name="doNotProcessTags" select="$doNotProcessTags"/>
				<xsl:with-param name="paramText" select="$paramText"/>
				<xsl:with-param name="itemName" select="$itemName"/>
			</xsl:call-template>
		</xsl:for-each>
		<xsl:call-template name="inheritDocFromBaseClass">
			<xsl:with-param name="baseClass" select="$baseClass"/>
			<xsl:with-param name="descriptionType" select="$descriptionType"/>
			<xsl:with-param name="entryType" select="$entryType"/>
			<xsl:with-param name="nameToMatch" select="$nameToMatch"/>
			<xsl:with-param name="itemNameToMatch" select="$itemNameToMatch"/>
			<xsl:with-param name="doNotProcessTags" select="$doNotProcessTags"/>
			<xsl:with-param name="paramText" select="$paramText"/>
			<xsl:with-param name="itemName" select="$itemName"/>
		</xsl:call-template>
	</xsl:template>
	<xsl:template name="inheritDocFromInterfaces">
		<xsl:param name="itemName"/>
		<xsl:param name="paramText"/>
		<xsl:param name="implementedInterface"/>
		<xsl:param name="descriptionType"/>
		<xsl:param name="entryType"/>
		<xsl:param name="nameToMatch"/>
		<xsl:param name="doNotProcessTags" select="false()"/>
		<xsl:for-each select="$implementedInterface">
			<xsl:variable name="baseClass" select="."/>
			<xsl:variable name="className">
				<xsl:if test="contains($baseClass,':')">
					<xsl:value-of select="substring-after($baseClass,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($baseClass,':'))">
					<xsl:value-of select="$baseClass"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="packageName">
				<xsl:if test="contains($baseClass,':')">
					<xsl:value-of select="substring-before($baseClass,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($baseClass,':'))">
					<xsl:value-of select="__Global__"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="xslDocPath">
				<xsl:if test="contains($baseClass,':')">
					<xsl:value-of select="concat($ditaFileDir,substring-before($baseClass,':'),'.xml')"/>
				</xsl:if>
				<xsl:if test="not(contains($baseClass,':'))">
					<xsl:value-of select="concat($ditaFileDir,'__Global__.xml')"/>
				</xsl:if>
			</xsl:variable>
			<xsl:choose>
				<xsl:when test="$entryType='apiOperation'">
					<xsl:for-each select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className and  apiClassifierDetail/apiClassifierDef/apiInterface]/apiOperation[apiName=$nameToMatch]">
						<xsl:choose>
							<xsl:when test="$descriptionType='shortdesc'">
								<xsl:for-each select="./shortdesc[text() != '']">
									<shortdesc>
										<xsl:apply-templates select="node()"/>
									</shortdesc>
								</xsl:for-each>
							</xsl:when>
							<xsl:when test="$descriptionType='apiDesc'">
								<xsl:for-each select="./apiOperationDetail/apiDesc[normalize-space(.) != '']">
									<apiDesc>
										<xsl:apply-templates select="node()"/>
									</apiDesc>
								</xsl:for-each>
							</xsl:when>
							<xsl:when test="$descriptionType='paramapiDesc'">
								<xsl:for-each select="./apiOperationDetail/apiOperationDef/apiParam[apiItemName=$itemName]">
									<xsl:copy-of select="./apiDesc" copy-namespaces="no"/>
								</xsl:for-each>
							</xsl:when>
							<xsl:when test="$descriptionType='returnapiDesc'">
								<xsl:copy-of select="./apiOperationDetail/apiOperationDef/apiReturn/apiDesc" copy-namespaces="no"/>
							</xsl:when>
						</xsl:choose>
					</xsl:for-each>
				</xsl:when>
			</xsl:choose>
			<!-- Now process the base interface of the current interface-->
			<xsl:for-each select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className]/apiClassifierDetail/apiClassifierDef/apiBaseInterface">
				<xsl:call-template name="inheritDocFromInterfaces">
					<xsl:with-param name="implementedInterface" select="."/>
					<xsl:with-param name="descriptionType" select="$descriptionType"/>
					<xsl:with-param name="entryType" select="$entryType"/>
					<xsl:with-param name="nameToMatch" select="$nameToMatch"/>
					<xsl:with-param name="doNotProcessTags" select="$doNotProcessTags"/>
					<xsl:with-param name="paramText" select="$paramText"/>
					<xsl:with-param name="itemName" select="$itemName"/>
				</xsl:call-template>
			</xsl:for-each>
		</xsl:for-each>
	</xsl:template>
	<xsl:template name="inheritDocFromBaseClass">
		<xsl:param name="itemName"/>
		<xsl:param name="paramText"/>
		<xsl:param name="baseClass"/>
		<xsl:param name="descriptionType"/>
		<xsl:param name="entryType"/>
		<xsl:param name="nameToMatch"/>
		<xsl:param name="itemNameToMatch"/>
		<xsl:param name="doNotProcessTags" select="false()"/>
		<xsl:variable name="className">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-after($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="$baseClass"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="packageName">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="substring-before($baseClass,':')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="__Global__"/>
			</xsl:if>
		</xsl:variable>
		<xsl:variable name="xslDocPath">
			<xsl:if test="contains($baseClass,':')">
				<xsl:value-of select="concat($ditaFileDir,substring-before($baseClass,':'),'.xml')"/>
			</xsl:if>
			<xsl:if test="not(contains($baseClass,':'))">
				<xsl:value-of select="concat($ditaFileDir,'__Global__.xml')"/>
			</xsl:if>
		</xsl:variable>
		<xsl:choose>
			<xsl:when test="$entryType='apiOperation'">
				<xsl:for-each select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className and not(apiClassifierDetail/apiClassifierDef/apiInterface)]/apiOperation[apiName=$nameToMatch]">
					<xsl:choose>
						<xsl:when test="$descriptionType='shortdesc'">
							<xsl:for-each select="./shortdesc[normalize-space(text()) != '']">
								<shortdesc>
									<xsl:apply-templates select="node()"/>
								</shortdesc>
							</xsl:for-each>
						</xsl:when>
						<xsl:when test="$descriptionType='apiDesc'">
							<xsl:for-each select="./apiOperationDetail/apiDesc[normalize-space(.) != '']">
								<apiDesc>
									<xsl:apply-templates select="node()"/>
								</apiDesc>
							</xsl:for-each>
						</xsl:when>
						<xsl:when test="$descriptionType='paramapiDesc'">
							<xsl:for-each select="./apiOperationDetail/apiOperationDef/apiParam[apiItemName=$itemName]">
								<xsl:copy-of select="./apiDesc" copy-namespaces="no"/>
							</xsl:for-each>
						</xsl:when>
						<xsl:when test="$descriptionType='returnapiDesc'">
							<xsl:copy-of select="./apiOperationDetail/apiOperationDef/apiReturn/apiDesc" copy-namespaces="no"/>
						</xsl:when>
					</xsl:choose>
				</xsl:for-each>
			</xsl:when>
		</xsl:choose>
		<!-- Now process the base class till object reached-->
		<xsl:if test="not($className='Object')">
			<xsl:variable name="newBaseClass"
				select="document($xslDocPath)/apiPackage/apiClassifier[apiName=$className and not(apiClassifierDetail/apiClassifierDef/apiInterface)]/apiClassifierDetail/apiClassifierDef/apiBaseClassifier"/>
			<xsl:if test="string-length($newBaseClass) &gt; 0">
				<xsl:call-template name="inheritDocFromBaseClass">
					<xsl:with-param name="baseClass" select="$newBaseClass"/>
					<xsl:with-param name="descriptionType" select="$descriptionType"/>
					<xsl:with-param name="entryType" select="$entryType"/>
					<xsl:with-param name="nameToMatch" select="$nameToMatch"/>
					<xsl:with-param name="itemNameToMatch" select="$itemNameToMatch"/>
					<xsl:with-param name="doNotProcessTags" select="$doNotProcessTags"/>
					<xsl:with-param name="paramText" select="$paramText"/>
					<xsl:with-param name="itemName" select="$itemName"/>
				</xsl:call-template>
			</xsl:if>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getConRefText">
		<xsl:param name="text"/>
		<xsl:param name="conref"/>
		<xsl:param name="descriptionType"/>
		<xsl:param name="entryType"/>
		<xsl:param name="doNotProcessTags" select="false()"/>
		<xsl:param name="currentPackage" select="ancestor-or-self::apiPackage/apiName"/>
		<xsl:if test="string-length($conref) &gt; 0">
			<xsl:variable name="relativePath">
				<xsl:call-template name="getRelativePath">
					<xsl:with-param name="currentPath" select="$currentPackage"/>
				</xsl:call-template>
			</xsl:variable>
			<xsl:variable name="packageClassText">
				<xsl:if test="contains($conref,'#') and contains(substring-before($conref,'#'),'.')">
					<xsl:value-of select="substring-before($conref,'#')"/>
				</xsl:if>
				<xsl:if test="contains($conref,'#') and not(contains(substring-before($conref,'#'),'.'))">
					<xsl:value-of select="concat($currentPackage,'.',substring-before($conref,'#'))"/>
				</xsl:if>
				<xsl:if test="not(contains($conref,'#'))">
					<xsl:value-of select="$conref"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="className">
				<xsl:if test="contains($conref,'#') and contains(substring-before($conref,'#'),'.')">
					<xsl:call-template name="lastIndexOf">
						<xsl:with-param name="string" select="$packageClassText"/>
						<xsl:with-param name="char" select="'.'"/>
					</xsl:call-template>
				</xsl:if>
				<xsl:if test="contains($conref,'#') and not(contains(substring-before($conref,'#'),'.'))">
					<xsl:if test="string-length(substring-before($conref,'#')) = 0">
						<xsl:value-of select="ancestor-or-self::apiPackage/apiClassifier/apiName"/>
					</xsl:if>
					<xsl:if test="string-length(substring-before($conref,'#')) &gt; 0">
						<xsl:value-of select="substring-before($conref,'#')"/>
					</xsl:if>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="destPackageName1">
				<xsl:value-of select="substring-before($packageClassText,concat('.',$className))"/>
			</xsl:variable>
			<xsl:variable name="destPackageName">
				<xsl:if test="$destPackageName1 = '' or $destPackageName1='__Global__'">
					<xsl:value-of select="'__Global__.xml'"/>
				</xsl:if>
				<xsl:if test="not($destPackageName1='') and not($destPackageName1='__Global__')">
					<xsl:value-of select="concat($destPackageName1, '.xml')"/>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="entryTypeNameText" select="substring-after($conref,'#')"/>
			<xsl:variable name="nameToMatch">
				<xsl:if test="string-length($entryTypeNameText) = 0">
					<xsl:value-of select="$className"/>
				</xsl:if>
				<xsl:if test="contains($entryTypeNameText,':')">
					<xsl:value-of select="substring-after($entryTypeNameText,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($entryTypeNameText,':')) and string-length($entryTypeNameText) &gt; 0">
					<xsl:if test="contains($entryTypeNameText,')')">
						<xsl:value-of select="substring-before($entryTypeNameText,'(')"/>
					</xsl:if>
					<xsl:if test="not(contains($entryTypeNameText,')'))">
						<xsl:value-of select="$entryTypeNameText"/>
					</xsl:if>
				</xsl:if>
			</xsl:variable>
			<xsl:variable name="entryType">
				<xsl:if test="string-length($entryTypeNameText) = 0">
					<xsl:value-of select="'class'"/>
				</xsl:if>
				<xsl:if test="contains($entryTypeNameText,':')">
					<xsl:value-of select="substring-before($entryTypeNameText,':')"/>
				</xsl:if>
				<xsl:if test="not(contains($entryTypeNameText,':')) and string-length($entryTypeNameText) &gt; 0">
					<xsl:if test="contains($entryTypeNameText,')')">
						<xsl:value-of select="'method'"/>
					</xsl:if>
					<xsl:if test="not(contains($entryTypeNameText,')'))">
						<xsl:value-of select="'property'"/>
					</xsl:if>
				</xsl:if>
			</xsl:variable>
			<xsl:for-each select="document(concat($ditaFileDir,$destPackageName))/apiPackage//apiClassifier[apiName=$className]">
				<xsl:if test="string-length($entryType) &gt; 0">
					<xsl:choose>
						<xsl:when test="contains($entryType,'method')">
							<xsl:for-each select="./apiOperation[apiName=$nameToMatch]">
								<xsl:choose>
									<xsl:when test="$descriptionType='shortdesc'">
										<xsl:if test="./shortdesc[@conref]">
											<xsl:call-template name="getConRefText">
												<xsl:with-param name="conref" select="./shortdesc/@conref"/>
												<xsl:with-param name="descriptionType" select="local-name(./shortdesc)"/>
											</xsl:call-template>
										</xsl:if>
										<xsl:if test="not(./shortdesc[@conref])">
											<xsl:for-each select="./shortdesc[text() != '']">
												<shortdesc>
													<xsl:apply-templates select="node()"/>
												</shortdesc>
											</xsl:for-each>
										</xsl:if>
									</xsl:when>
									<xsl:otherwise>
										<xsl:if test="./apiOperationDetail/apiDesc[@conref]">
											<xsl:call-template name="getConRefText">
												<xsl:with-param name="conref" select="./apiOperationDetail/apiDesc/@conref"/>
												<xsl:with-param name="descriptionType" select="local-name(./apiOperationDetail/apiDesc)"/>
											</xsl:call-template>
										</xsl:if>
										<xsl:if test="not(./apiOperationDetail/apiDesc[@conref])">
											<xsl:for-each select="./apiOperationDetail/apiDesc">
												<xsl:apply-templates select="node()"/>
											</xsl:for-each>
										</xsl:if>
									</xsl:otherwise>
								</xsl:choose>
							</xsl:for-each>
						</xsl:when>
					</xsl:choose>
				</xsl:if>
			</xsl:for-each>
		</xsl:if>
	</xsl:template>
	<xsl:template name="getRelativePath">
		<xsl:param name="currentPath"/>
		<xsl:choose>
			<xsl:when test="not($currentPath) or $currentPath='__Global__'">
				<xsl:value-of select="''"/>
			</xsl:when>
			<xsl:otherwise>
				<xsl:if test="contains($currentPath,'.')">
					<xsl:call-template name="getRelativePath">
						<xsl:with-param name="currentPath" select="substring-after($currentPath,'.')"/>
					</xsl:call-template>
				</xsl:if>
				<xsl:value-of select="'../'"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template name="lastIndexOf">
		<xsl:param name="string"/>
		<xsl:param name="char"/>
		<xsl:choose>
			<xsl:when test="contains($string, $char)">
				<xsl:call-template name="lastIndexOf">
					<xsl:with-param name="string" select="substring-after($string, $char)"/>
					<xsl:with-param name="char" select="$char"/>
				</xsl:call-template>
			</xsl:when>
			<xsl:otherwise>
				<xsl:value-of select="$string"/>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
	<xsl:template match="keywords"/>
	<xsl:template match="node()">
		<xsl:copy copy-namespaces="no">
			<xsl:copy-of select="@*" copy-namespaces="no"/>
			<xsl:apply-templates select="node()"/>
		</xsl:copy>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/mxml-tags.html
================================================
<html>
<head>
	<link rel="stylesheet" href="style.css" type="text/css" />
	<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
	<title>MXML Only Components - Adobe Flex 3 Language Reference</title>
</head>

<body class="classFrameContent">
	<h3>MXML Only Components</h3>
	<a href="mxml/binding.html" target="classFrame">&lt;mx:Binding&gt;</a><br />
	<a href="mxml/component.html" target="classFrame">&lt;mx:Component&gt;</a><br />
	<a href="mxml/metadata.html" target="classFrame">&lt;mx:Metadata&gt;</a><br />
	<a href="mxml/model.html" target="classFrame">&lt;mx:Model&gt;</a><br />
	<a href="mxml/script.html" target="classFrame">&lt;mx:Script&gt;</a><br />
	<a href="mxml/style.html" target="classFrame">&lt;mx:Style&gt;</a><br />
	<a href="mxml/xml.html" target="classFrame">&lt;mx:XML&gt;</a><br />
	<a href="mxml/xmlList.html" target="classFrame">&lt;mx:XMLList&gt;</a><br />
</body>
</html>



================================================
FILE: documentation/api-reference/templates/override.css
================================================
/*
////////////////////////////////////////////////////////////////////////////////
//
//  ADOBE SYSTEMS INCORPORATED
//  Copyright 2008 Adobe Systems Incorporated
//  All Rights Reserved.
//
//  NOTICE: Adobe permits you to use, modify, and distribute this file
//  in accordance with the terms of the license agreement accompanying it.
//
////////////////////////////////////////////////////////////////////////////////
*/

================================================
FILE: documentation/api-reference/templates/package-detail.xslt
================================================
<?xml version="1.0" encoding="utf-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://sf.net/saxon" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ifn="urn:internal:functions"
	exclude-result-prefixes="saxon xs ifn">
	<xsl:import href="asdoc-util.xslt"/>
	<xsl:import href="class-files.xslt"/>
	<xsl:output encoding="UTF-8" method="html" omit-xml-declaration="yes" use-character-maps="disable"/>
	<xsl:param name="outputPath" select="''"/>
	<xsl:param name="packageOverviewFile" select="'overviews.xml'"/>
	<xsl:param name="packages_map_name" select="'packagemap.xml'"/>
	<xsl:variable name="thinsp">
		<xsl:text>&#x2009;</xsl:text>
	</xsl:variable>
	<xsl:template match="/">
		<xsl:choose>
			<xsl:when test="$prog_language_name='javascript'"/>
			<xsl:otherwise>
				<xsl:for-each select="apiMap//apiItemRef">
					<xsl:sort select="@href" order="ascending" lang="en-US"/>
					<xsl:variable name="ditaFileName">
						<xsl:value-of select="concat($ditaFileDir,@href)"/>
					</xsl:variable>
					<xsl:for-each select="document($ditaFileName)/apiPackage">
						<xsl:variable name="name" select="./apiName"/>
						<xsl:variable name="isTopLevel">
							<xsl:call-template name="isTopLevel">
								<xsl:with-param name="packageName" select="$name"/>
							</xsl:call-template>
						</xsl:variable>
						<xsl:variable name="shortPackageName" select="$name"/>
						<xsl:variable name="packageFile">
							<xsl:value-of select="$outputPath"/>
							<xsl:choose>
								<xsl:when test="$isTopLevel='true'">package-detail.html</xsl:when>
								<xsl:otherwise>
									<xsl:value-of select="translate($name,'.','/')"/>/package-detail.html</xsl:otherwise>
							</xsl:choose>
						</xsl:variable>
						<xsl:variable name="classListFile">
							<xsl:choose>
								<xsl:when test="$isTopLevel='true'">class-list.html</xsl:when>
								<xsl:otherwise>
									<xsl:value-of select="translate($name,'.','/')"/>/class-list.html</xsl:otherwise>
							</xsl:choose>
						</xsl:variable>
						<xsl:variable name="packageName">
							<xsl:choose>
								<xsl:when test="$isTopLevel='true'">
									<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
								</xsl:when>
								<xsl:otherwise>
									<xsl:apply-templates select="$asdoc_terms/row[entry[1][p/text() = 'PackagePackage']]/entry[2]/p" mode="terms">
										<xsl:with-param name="package" select="$name"/>
									</xsl:apply-templates>
								</xsl:otherwise>
							</xsl:choose>
						</xsl:variable>
						<xsl:variable name="title">
							<xsl:if test="$isTopLevel='true'">
								<xsl:value-of select="concat($asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p,' - ',$title-base)"/>
							</xsl:if>
							<xsl:if test="$isTopLevel != 'true'">
								<xsl:value-of select="concat($name,' ',$asdoc_terms/row[entry[1][p/text() = 'Package']]/entry[2]/p,' - ',$title-base)"/>
							</xsl:if>
						</xsl:variable>
						<xsl:result-document href="{$packageFile}" method="html">
							<xsl:copy-of select="$noLiveDocs"/>
							<xsl:copy-of select="$docType"/>
							<xsl:value-of select="$markOfTheWeb"/>
							<xsl:if test="$config/options[@ion='true']">
								<xsl:comment>#config errmsg=""</xsl:comment>
							</xsl:if>
							<xsl:element name="html">
								<head>
									<xsl:call-template name="getStyleLink">
										<xsl:with-param name="link" select="/asdoc/link"/>
										<xsl:with-param name="packageName" select="$name"/>
									</xsl:call-template>
									<title>
										<xsl:if test="$isTopLevel='true'">
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevelConstantsFunctions']]/entry[2]/p"/>
										</xsl:if>
										<xsl:if test="$isTopLevel='false'">
											<xsl:value-of select="$name"/>
										</xsl:if>
										<xsl:text> </xsl:text>
										<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Summary']]/entry[2]/p"/>
										<xsl:call-template name="getPageTitlePostFix"/>
									</title>
									<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
								</head>
								<xsl:element name="body">
									<xsl:if test="$isEclipse">
										<xsl:attribute name="class">
											<xsl:text>eclipseBody</xsl:text>
										</xsl:attribute>
									</xsl:if>
									<xsl:call-template name="getTitleScript">
										<xsl:with-param name="title" select="$title"/>
										<xsl:with-param name="packageName" select="$name"/>
									</xsl:call-template>
									<xsl:call-template name="getLinks2">
										<xsl:with-param name="subTitle">
											<xsl:choose>
												<xsl:when test="$isTopLevel='true'">
													<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
												</xsl:when>
												<xsl:otherwise>
													<xsl:apply-templates select="$shortPackageName"/>
												</xsl:otherwise>
											</xsl:choose>
										</xsl:with-param>
										<xsl:with-param name="fileName" select="'package-detail'"/>
										<xsl:with-param name="fileName2" select="$classListFile"/>
										<xsl:with-param name="packageName" select="$name"/>
										<xsl:with-param name="showProperties" select="false()"/>
										<xsl:with-param name="showMethods" select="false()"/>
										<xsl:with-param name="showPackageConstants" select="boolean(count(apiValue[not(apiValueDetail/apiValueDef/apiProperty)]))"/>
										<xsl:with-param name="showPackageProperties" select="boolean(count(apiValue[apiValueDetail/apiValueDef/apiProperty]))"/>
										<xsl:with-param name="showPackageFunctions" select="boolean(count(apiOperation))"/>
										<xsl:with-param name="showInterfaces" select="boolean(count(apiClassifier[apiClassifierDetail/apiClassifierDef/apiInterface]))"/>
										<xsl:with-param name="showClasses" select="boolean(count(apiClassifier[not(apiClassifierDetail/apiClassifierDef/apiInterface)]))"/>
										<xsl:with-param name="showPackageUse" select="false()"/>
									</xsl:call-template>
									<xsl:variable name="id" select="@id"/>
									<div class="MainContent">
										<xsl:variable name="annot" select="$id"/>
										<xsl:variable name="pack" select="translate($annot,':','.')"/>
										<xsl:apply-templates mode="annotate" select="$config/annotate/item[@type='package' and @name[starts-with($pack,.)]]"/>
										<br/>
										<xsl:if test="not($config/overviews/package)">
											<xsl:variable name="packageComments" select="document($packageOverviewFile)/overviews/packages/package[@name=current()/apiName]"/>
											<xsl:for-each select="$packageComments/description">
												<p>
													<xsl:call-template name="deTilda">
														<xsl:with-param name="inText" select="."/>
													</xsl:call-template>
												</p>
												<xsl:for-each select="$packageComments">
													<xsl:call-template name="sees"/>
												</xsl:for-each>
											</xsl:for-each>
										</xsl:if>
										<xsl:if test="$config/overviews/package">
											<xsl:variable name="pname" select="@name"/>
											<xsl:for-each select="$config/overviews/package">
												<xsl:variable name="packageOverview" select="document(.)/overviews/packages/package[@name=$pname]"/>
												<xsl:if test="$packageOverview/longDescription">
													<p>
														<xsl:call-template name="deTilda">
															<xsl:with-param name="inText" select="$packageOverview/description"/>
														</xsl:call-template>
													</p>
													<xsl:for-each select="$packageOverview">
														<xsl:call-template name="sees">
															<xsl:with-param name="xrefId">
																<xsl:if test="$isTopLevel='true'">
																	<xsl:text>global</xsl:text>
																</xsl:if>
																<xsl:if test="not($isTopLevel='true')">
																	<xsl:value-of select="$pname"/>
																</xsl:if>
															</xsl:with-param>
														</xsl:call-template>
													</xsl:for-each>
												</xsl:if>
											</xsl:for-each>
										</xsl:if>
										<br/>
										<hr/>
										<xsl:if test="apiValue/apiValueDetail/apiValueDef[apiProperty]">
											<a name="fieldSummary"/>
											<div class="summaryTableTitle">
												<xsl:choose>
													<xsl:when test="$isTopLevel='true'">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalProperties']]/entry[2]/p"/>
													</xsl:when>
													<xsl:otherwise>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Property']]/entry[2]/p"/>
													</xsl:otherwise>
												</xsl:choose>
											</div>
											<table cellpadding="3" cellspacing="0" class="summaryTable">
												<tr>
													<th>
														<xsl:value-of select="$nbsp"/>
													</th>
													<th width="30%">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Property']]/entry[2]/p"/>
													</th>
													<th width="70%">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Description']]/entry[2]/p"/>
													</th>
												</tr>
												<xsl:for-each select="apiValue/apiValueDetail/apiValueDef[apiProperty]">
													<xsl:sort select="apiName" order="ascending" lang="en-US"/>
													<xsl:variable name="name" select="apiName"/>
													<tr class="prow{position() mod 2}">
														<td class="summaryTablePaddingCol">
															<xsl:value-of select="$nbsp"/>
														</td>
														<td class="summaryTableSecondCol">
															<a href="package.html#{$name}">
																<xsl:value-of select="$name"/>
															</a>
														</td>
														<td class="summaryTableLastCol">
															<xsl:call-template name="shortDescription"/>
															<xsl:if test="not(string-length(normalize-space(shortDescription/.)))">
																<xsl:value-of select="$nbsp"/>
															</xsl:if>
														</td>
													</tr>
												</xsl:for-each>
											</table>
										</xsl:if>
										<xsl:if test="apiOperation">
											<a name="methodSummary"/>
											<div class="summaryTableTitle">
												<xsl:choose>
													<xsl:when test="$isTopLevel='true'">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalFunctions']]/entry[2]/p"/>
													</xsl:when>
													<xsl:otherwise>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Functions']]/entry[2]/p"/>
													</xsl:otherwise>
												</xsl:choose>
											</div>
											<table cellpadding="3" cellspacing="0" class="summaryTable">
												<tr>
													<th>
														<xsl:value-of select="$nbsp"/>
													</th>
													<th width="30%">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'FunctionFunction']]/entry[2]/p"/>
													</th>
													<th width="70%">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Description']]/entry[2]/p"/>
													</th>
												</tr>
												<xsl:for-each select="apiOperation">
													<xsl:sort select="apiName" order="ascending" lang="en-US"/>
													<xsl:variable name="name" select="apiName"/>
													<tr class="prow{position() mod 2}">
														<td class="summaryTablePaddingCol">
															<xsl:value-of select="$nbsp"/>
														</td>
														<td class="summaryTableSecondCol">
															<a href="package.html#{$name}()">
																<xsl:value-of select="$name"/>
															</a>
														</td>
														<td class="summaryTableLastCol">
															<xsl:call-template name="shortDescriptionReview"/>
															<xsl:call-template name="shortDescription"/>
															<xsl:if test="not(string-length(normalize-space(./shortdesc/.)))">
																<xsl:value-of select="$nbsp"/>
															</xsl:if>
														</td>
													</tr>
												</xsl:for-each>
											</table>
										</xsl:if>
										<xsl:if test="apiValue[not(apiValueDetail/apiValueDef/apiProperty)]">
											<a name="constantSummary"/>
											<div class="summaryTableTitle">
												<xsl:choose>
													<xsl:when test="$isTopLevel='true'">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalConstants']]/entry[2]/p"/>
													</xsl:when>
													<xsl:otherwise>
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Constants']]/entry[2]/p"/>
													</xsl:otherwise>
												</xsl:choose>
											</div>
											<table cellpadding="3" cellspacing="0" class="summaryTable">
												<tr>
													<th>
														<xsl:value-of select="$nbsp"/>
													</th>
													<th width="30%">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Constant']]/entry[2]/p"/>
													</th>
													<th width="70%">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Description']]/entry[2]/p"/>
													</th>
												</tr>
												<xsl:for-each select="apiValue[not(apiValueDetail/apiValueDef/apiProperty)]">
													<xsl:sort select="apiName" order="ascending" lang="en-US"/>
													<xsl:variable name="name" select="apiName"/>
													<tr class="prow{position() mod 2}">
														<td class="summaryTablePaddingCol">
															<xsl:value-of select="$nbsp"/>
														</td>
														<td class="summaryTableSecondCol">
															<a href="package.html#{$name}">
																<xsl:value-of select="$name"/>
															</a>
														</td>
														<td class="summaryTableLastCol">
															<xsl:call-template name="shortDescription"/>
															<xsl:if test="not(string-length(normalize-space(./shortdesc/.)))">
																<xsl:value-of select="$nbsp"/>
															</xsl:if>
														</td>
													</tr>
												</xsl:for-each>
											</table>
										</xsl:if>
										<xsl:if test="apiClassifier[apiClassifierDetail/apiClassifierDef/apiInterface]">
											<a name="interfaceSummary"/>
											<div class="summaryTableTitle">
												<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Interfaces']]/entry[2]/p"/>
											</div>
											<table cellpadding="3" cellspacing="0" class="summaryTable">
												<tr>
													<th>
														<xsl:value-of select="$nbsp"/>
													</th>
													<th width="30%">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Interface']]/entry[2]/p"/>
													</th>
													<th width="70%">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Description']]/entry[2]/p"/>
													</th>
												</tr>
												<xsl:for-each select="apiClassifier[apiClassifierDetail/apiClassifierDef/apiInterface]">
													<xsl:sort select="apiName" order="ascending" lang="en-US"/>
													<xsl:variable name="name" select="apiName"/>
													<xsl:variable name="packageName" select="ancestor::apiPackage/apiName"/>
													<xsl:variable name="baseRef">
														<xsl:call-template name="getBaseRef">
															<xsl:with-param name="packageName" select="$packageName"/>
														</xsl:call-template>
													</xsl:variable>
													<tr class="prow{position() mod 2}">
														<td class="summaryTablePaddingCol">
															<xsl:value-of select="$nbsp"/>
														</td>
														<td class="summaryTableSecondCol">
															<i>
																<a href="{$name}.html">
																	<xsl:value-of select="$name"/>
																</a>
															</i>
															<xsl:choose>
																<xsl:when test="$prog_language_name='javascript'"/>
																<xsl:otherwise>
																	<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
																		<xsl:value-of select="$nbsp"/>
																		<xsl:call-template name="insertAIRIcon">
																			<xsl:with-param name="baseRef" select="$baseRef"/>
																		</xsl:call-template>
																	</xsl:if>
																</xsl:otherwise>
															</xsl:choose>
														</td>
														<td class="summaryTableLastCol">
															<xsl:if test="deprecated">
																<xsl:apply-templates select="deprecated"/>
															</xsl:if>
															<xsl:if test="not(deprecated)">
																<xsl:call-template name="shortDescription"/>
																<xsl:if test="not(string-length(normalize-space(./shortdesc/.)))">
																	<xsl:value-of select="$nbsp"/>
																</xsl:if>
															</xsl:if>
														</td>
													</tr>
												</xsl:for-each>
											</table>
										</xsl:if>
										<xsl:if test="apiClassifier[not(apiClassifierDetail/apiClassifierDef/apiInterface)]">
											<a name="classSummary"/>
											<div class="summaryTableTitle">
												<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Classes']]/entry[2]/p"/>
											</div>
											<table cellpadding="3" cellspacing="0" class="summaryTable">
												<tr>
													<th>
														<xsl:value-of select="$nbsp"/>
													</th>
													<th width="30%">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'ClassClass']]/entry[2]/p"/>
													</th>
													<th width="70%">
														<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Description']]/entry[2]/p"/>
													</th>
												</tr>
												<xsl:for-each select="apiClassifier[not(apiClassifierDetail/apiClassifierDef/apiInterface)]">
													<xsl:sort select="apiName" order="ascending" lang="en-US"/>
													<xsl:variable name="name" select="apiName"/>
													<xsl:variable name="packageName" select="ancestor::apiPackage/apiName"/>
													<xsl:variable name="baseRef">
														<xsl:call-template name="getBaseRef">
															<xsl:with-param name="packageName" select="$packageName"/>
														</xsl:call-template>
													</xsl:variable>
													<tr class="prow{position() mod 2}">
														<td class="summaryTablePaddingCol">
															<xsl:value-of select="$nbsp"/>
														</td>
														<td class="summaryTableSecondCol">
															<a href="{$name}.html">
																<xsl:value-of select="$name"/>
															</a>
															<xsl:choose>
																<xsl:when test="$prog_language_name='javascript'"/>
																<xsl:otherwise>
																	<xsl:if test="prolog/asMetadata/apiVersion/apiPlatform[@name='AIR'] and not (prolog/asMetadata/apiVersion/apiPlatform[@name='Flash'])">
																		<xsl:value-of select="$nbsp"/>
																		<xsl:call-template name="insertAIRIcon">
																			<xsl:with-param name="baseRef" select="$baseRef"/>
																		</xsl:call-template>
																	</xsl:if>
																</xsl:otherwise>
															</xsl:choose>
														</td>
														<td class="summaryTableLastCol">
															<xsl:if test="deprecated">
																<xsl:apply-templates select="deprecated"/>
															</xsl:if>
															<xsl:if test="not(deprecated)">
																<xsl:call-template name="shortDescription"/>
																<xsl:if test="not(string-length(normalize-space(./shortdesc)))">
																	<xsl:value-of select="$nbsp"/>
																</xsl:if>
															</xsl:if>
														</td>
													</tr>
												</xsl:for-each>
											</table>
										</xsl:if>
										<p/>
										<xsl:variable name="packageName" select="$name"/>
										<xsl:variable name="baseRef">
											<xsl:call-template name="getBaseRef">
												<xsl:with-param name="packageName" select="$packageName"/>
											</xsl:call-template>
										</xsl:variable>
										<div>
											<p/>
											<xsl:if test="$isTopLevel='true'">
												<xsl:call-template name="getFeedbackLink">
													<xsl:with-param name="topic" select="'Top Level'"/>
													<xsl:with-param name="baseRef" select="$baseRef"/>
												</xsl:call-template>
											</xsl:if>
											<xsl:if test="$isTopLevel!='true'">
												<xsl:call-template name="getFeedbackLink">
													<xsl:with-param name="topic" select="$name"/>
													<xsl:with-param name="baseRef" select="$baseRef"/>
												</xsl:call-template>
											</xsl:if>
											<center class="copyright">
												<xsl:copy-of select="$copyright"/>
											</center>
										</div>
									</div>
									<xsl:variable name="packageName" select="ancestor::apiPackage/apiName"/>
									<xsl:variable name="baseRef">
										<xsl:call-template name="getBaseRef">
											<xsl:with-param name="packageName" select="$name"/>
										</xsl:call-template>
									</xsl:variable>
									<xsl:if test="$config/options[@ion='true']">
										<div class="separator">&#160;</div>
										<xsl:comment>BEGIN IONCOMMENTS</xsl:comment>
										<div id="ionComHere"> </div>
										<xsl:comment>END IONCOMMENTS</xsl:comment>
										<xsl:comment>#include virtual="ionComments.ssi"</xsl:comment>
										<p id="creativecommons" class="creativecommons">
											<a href="http://creativecommons.org/licenses/by-nc-sa/3.0/">
												<img id="creativecommons_img" src="{$baseRef}images/CC.png"/>
											</a>
										</p>
										<xsl:comment>#include virtual="/livedocs/googleAnalytics.ssi"</xsl:comment>
										<xsl:comment>#include virtual="/ubi/analytics/analytics_ssi.html"</xsl:comment>
									</xsl:if>
								</xsl:element>
							</xsl:element>
							<xsl:copy-of select="$copyrightComment"/>
						</xsl:result-document>
					</xsl:for-each>
				</xsl:for-each>
			</xsl:otherwise>
		</xsl:choose>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/package-frame.html
================================================
<html>
<head>
    <title>ActionScript 3.0 Language and Components Reference</title>
    <meta name="viewport" content="width=device-width, initial-scale=1.0"/>
</head>
<frameset rows="40%,60%" border="2" framespacing="1" bordercolor="#AAAAAA">
    <frame src="package-list.html" name="packageListFrame" scrolling="yes" />
    <frame src="all-classes.html" name="classListFrame" scrolling="yes" />
    <noframes>
        <body>
            <h2>Frame Alert</h2>
            <p>This document is designed to be viewed using the frames feature. If you see this message, you are using a non-frame-capable web client.
                <br />
                Link to<a href="package-summary.html">Non-frame version.</a>
            </p>
        </body>
    </noframes>
</frameset>
</html>

================================================
FILE: documentation/api-reference/templates/package-list.xslt
================================================
<?xml version="1.0" encoding="utf-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
	<xsl:import href="asdoc-util.xslt"/>
	<xsl:output encoding="UTF-8" method="html" omit-xml-declaration="yes" use-character-maps="disable"/>
	<xsl:param name="packages_map_name" select="'packagemap.xml'"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:template match="/">
		<xsl:copy-of select="$noLiveDocs"/>
		<xsl:copy-of select="$docType"/>
		<xsl:element name="html">
			<head>
				<title><xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PackageList']]/entry[2]/p"/> - <xsl:value-of select="$title-base"/></title>
				<base target="classFrame"/>
				<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
				<xsl:call-template name="getStyleLink">
					<xsl:with-param name="link" select="asdoc/link"/>
				</xsl:call-template>
				<script language="javascript" src="asdoc.js" type="text/javascript"/>
			</head>
			<body class="classFrameContent">
				<h3>
					<a href="package-summary.html" onclick="javascript:loadClassListFrame('all-classes.html');" style="color:black">
						<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Packages']]/entry[2]/p"/>
					</a>
				</h3>
				<table cellpadding="0" cellspacing="0">
					<xsl:for-each select="apiMap//apiItemRef">
						<xsl:sort select="substring(@href, 0, string-length(@href)-4)" order="ascending" lang="en-US"/>
						<xsl:variable name="ditaFileName">
							<xsl:value-of select="concat($ditaFileDir,@href)"/>
						</xsl:variable>
						<xsl:if test="document($ditaFileName)/apiPackage[contains(apiName,'__Global__')]/apiClassifier">
							<tr>
								<td>
									<a href="package-detail.html" onclick="javascript:loadClassListFrame('class-list.html');">
										<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
									</a>
								</td>
							</tr>
						</xsl:if>
						<xsl:for-each select="document($ditaFileName)/apiPackage[apiClassifier or apiOperation or apiValue]">
							<xsl:sort select="apiName" order="ascending" lang="en-US"/>
							<xsl:variable name="name" select="apiName"/>
							<xsl:variable name="isTopLevel">
								<xsl:call-template name="isTopLevel">
									<xsl:with-param name="packageName" select="$name"/>
								</xsl:call-template>
							</xsl:variable>
							<tr>
								<td>
									<xsl:if test="$isTopLevel='false'">
										<xsl:variable name="packagePath" select="translate($name,'.','/')"/>
										<a href="{$packagePath}/package-detail.html" onclick="javascript:loadClassListFrame('{$packagePath}/class-list.html');">
											<xsl:value-of select="$name"/>
										</a>
										<xsl:if test="position() != last()">
											<br/>
										</xsl:if>
									</xsl:if>
								</td>
							</tr>
						</xsl:for-each>
					</xsl:for-each>
				</table>
				<xsl:if test="$config/languageElements[@show='true']">
					<h3>
						<a href="language-elements.html" style="color:black">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'LanguageElements']]/entry[2]/p"/>
						</a>
					</h3>
					<table cellpadding="0" cellspacing="0">
						<xsl:if test="$config/languageElements[@directives='true']">
							<tr>
								<td>
									<a href="directives.html">
										<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'CompilerDirectives']]/entry[2]/p"/>
									</a>
								</td>
							</tr>
						</xsl:if>
						<xsl:if test="$config/languageElements[@constants='true']">
							<tr>
								<td>
									<xsl:if test="$config/options[@docversion='3']">
										<a href="package.html#constantSummary">
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalConstants']]/entry[2]/p"/>
										</a>
									</xsl:if>
									<xsl:if test="not($config/options[@docversion='3'])">
										<a href="constants.html">
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalConstants']]/entry[2]/p"/>
										</a>
									</xsl:if>
								</td>
							</tr>
						</xsl:if>
						<xsl:if test="$config/languageElements[@functions='true']">
							<tr>
								<td>
									<xsl:if test="$config/options[@docversion='3']">
										<a href="package.html#methodSummary">
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalFunctions']]/entry[2]/p"/>
										</a>
									</xsl:if>
									<xsl:if test="not($config/options[@docversion='3'])">
										<a href="global_functions.html">
											<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalFunctions']]/entry[2]/p"/>
										</a>
									</xsl:if>
								</td>
							</tr>
						</xsl:if>
						<xsl:if test="$config/languageElements[@properties='true']">
							<tr>
								<td>
									<a href="global_props.html">
										<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'GlobalProperties']]/entry[2]/p"/>
									</a>
								</td>
							</tr>
						</xsl:if>
						<xsl:if test="$config/languageElements[@operators='true']">
							<tr>
								<td>
									<a href="operators.html">
										<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Operators']]/entry[2]/p"/>
									</a>
								</td>
							</tr>
						</xsl:if>
						<xsl:if test="$config/languageElements[@statements='true']">
							<tr>
								<td>
									<a href="statements.html">
										<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'StatementsKeywordsDirectives']]/entry[2]/p"/>
									</a>
								</td>
							</tr>
						</xsl:if>
						<xsl:if test="$config/languageElements[@specialTypes='true']">
							<tr>
								<td>
									<a href="specialTypes.html">
										<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'SpecialTypes']]/entry[2]/p"/>
									</a>
								</td>
							</tr>
						</xsl:if>
						<xsl:for-each select="$config/languageElements/element">
							<tr>
								<td>
									<a href="{@href}" onclick="{@onclick}">
										<xsl:value-of select="@label"/>
									</a>
								</td>
							</tr>
						</xsl:for-each>
					</table>
				</xsl:if>
				<xsl:if test="$config/appendixes[@show='true']">
					<h3>
						<a href="appendixes.html" style="color:black">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Appendix']]/entry[2]/p"/>
						</a>
					</h3>
					<table cellpadding="0" cellspacing="0">
						<xsl:if test="$config/appendixes[@deprecated='true']">
							<tr>
								<td>
									<a href="deprecated.html">
										<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Deprecated']]/entry[2]/p"/>
									</a>
								</td>
							</tr>
						</xsl:if>
						<xsl:for-each select="$config/appendixes/appendix">
							<tr>
								<td>
									<a href="{@href}" onclick="{@onclick}">
										<xsl:value-of select="$asdoc_terms/row[entry[1]/p = current()/@label]/entry[2]//p"/>
									</a>
								</td>
							</tr>
						</xsl:for-each>
					</table>
				</xsl:if>
			</body>
		</xsl:element>
		<xsl:copy-of select="$copyrightComment"/>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/package-summary.xslt
================================================
<?xml version="1.0" encoding="utf-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://sf.net/saxon" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ifn="urn:internal:functions"
	exclude-result-prefixes="saxon xs ifn">
	<xsl:import href="asdoc-util.xslt"/>
	<xsl:output encoding="UTF-8" method="html" use-character-maps="disable"/>
	<xsl:param name="localTitle" select="$localTitle"/>
	<xsl:variable name="title" select="concat($asdoc_terms/row[entry[1][p/text() = $localTitle]]/entry[2]/p,' - ',$title-base)"/>
	<xsl:param name="overviewsFile" select="'overviews.xml'"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:param name="filter" select="'*'"/>
	<xsl:param name="outfile" select="'package-summary'"/>
	<xsl:param name="packages_map_name" select="'packagemap.xml'"/>
	<xsl:param name="jslr" select="'flashclasses.xml'"/>
	<xsl:param name="prog_language_name" select="''"/>
	<xsl:variable name="useFilter">
		<xsl:if test="contains($filter,'*')">
			<xsl:value-of select="substring-before($filter,'*')"/>
		</xsl:if>
		<xsl:if test="not(contains($filter,'*'))">
			<xsl:value-of select="$filter"/>
		</xsl:if>
	</xsl:variable>
	<xsl:template match="/">
		<xsl:copy-of select="$noLiveDocs"/>
		<xsl:copy-of select="$docType"/>
		<xsl:value-of select="$markOfTheWeb"/>
		<xsl:if test="$config/options[@livedocs='true']">
			<xsl:comment>#config errmsg=""</xsl:comment>
		</xsl:if>
		<xsl:element name="html">
			<head>
				<title>
					<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = $localTitle]]/entry[2]/p"/>
					<xsl:call-template name="getPageTitlePostFix"/>
				</title>
				<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
				<xsl:call-template name="getStyleLink">
					<xsl:with-param name="link" select="asdoc/link"/>
				</xsl:call-template>
			</head>
			<xsl:element name="body">
				<xsl:if test="$isEclipse">
					<xsl:attribute name="class">
						<xsl:text>eclipseBody</xsl:text>
					</xsl:attribute>
				</xsl:if>
				<xsl:call-template name="getTitleScript">
					<xsl:with-param name="title" select="$title"/>
				</xsl:call-template>
				<xsl:call-template name="getLinks2">
					<xsl:with-param name="subTitle">
						<xsl:call-template name="search-and-replace">
							<xsl:with-param name="input" select="$asdoc_terms/row[entry[1][p/text() = $localTitle]]/entry[2]/p"/>
							<xsl:with-param name="search-string" select="' '"/>
							<xsl:with-param name="replace-string" select="$nbsp"/>
						</xsl:call-template>
					</xsl:with-param>
					<xsl:with-param name="fileName" select="$outfile"/>
					<xsl:with-param name="showProperties" select="false()"/>
					<xsl:with-param name="showMethods" select="false()"/>
					<xsl:with-param name="showPackages" select="false()"/>
				</xsl:call-template>
				<div class="MainContent">
					<br/>
					<xsl:variable name="overviews" select="document($overviewsFile)/overviews"/>
					<p>
						<xsl:choose>
							<xsl:when test="starts-with($useFilter,'mx.')">
								<xsl:value-of disable-output-escaping="yes" select="$overviews/mx-packages/description/."/>
							</xsl:when>
							<xsl:when test="starts-with($useFilter,'flash.')">
								<xsl:value-of disable-output-escaping="yes" select="$overviews/flash-packages/description/."/>
							</xsl:when>
							<xsl:otherwise>
								<xsl:value-of disable-output-escaping="yes" select="$overviews/all-packages/description/."/>
							</xsl:otherwise>
						</xsl:choose>
					</p>
					<xsl:for-each select="$overviews/all-packages">
						<xsl:call-template name="sees">
							<xsl:with-param name="xrefId" select="'all-packages'"/>
						</xsl:call-template>
					</xsl:for-each>
					<br/>
					<table cellpadding="3" cellspacing="0" class="summaryTable">
						<tr>
							<th>
								<xsl:value-of select="$nbsp"/>
							</th>
							<th width="30%">
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Package']]/entry[2]/p"/>
							</th>
							<th width="70%">
								<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Description']]/entry[2]/p"/>
							</th>
						</tr>
						<xsl:choose>
							<xsl:when test="$prog_language_name='javascript'"/>

							<xsl:otherwise>
								<xsl:for-each select="apiMap//apiItemRef">
									<xsl:sort select="substring(@href, 0, string-length(@href)-4)" order="ascending"/>
									<xsl:variable name="ditaFileName">
										<xsl:value-of select="concat($ditaFileDir,@href)"/>
									</xsl:variable>
									<xsl:variable name="rowNumber" select="concat('prow',position() mod 2)"/>
									<xsl:for-each select="document($ditaFileName)/apiPackage[starts-with(apiName,$useFilter) or ($useFilter='flash.' and apiName='__Global__')]">
										<xsl:sort select="apiName" order="ascending"/>
										<xsl:variable name="name" select="apiName"/>
										<xsl:variable name="isTopLevel">
											<xsl:call-template name="isTopLevel">
												<xsl:with-param name="packageName" select="$name"/>
											</xsl:call-template>
										</xsl:variable>
										<xsl:variable name="packageFile">
											<xsl:if test="$isTopLevel='false'">
												<xsl:value-of select="translate($name,'.','/')"/>
												<xsl:text>/</xsl:text>
											</xsl:if>
											<xsl:text>package-detail.html</xsl:text>
										</xsl:variable>
										<xsl:variable name="classListFile">
											<xsl:if test="$isTopLevel='false'">
												<xsl:value-of select="translate($name,'.','/')"/>
												<xsl:text>/</xsl:text>
											</xsl:if>
											<xsl:text>class-list.html</xsl:text>
										</xsl:variable>
										<xsl:if test="./apiClassifier or ./apiOperation or ./apiValue/apiProperty">
											<xsl:variable name="name" select="apiName"/>
											<tr class="{$rowNumber}">
												<td class="summaryTablePaddingCol">
													<xsl:value-of select="$nbsp"/>
												</td>
												<td class="summaryTableSecondCol">
													<a href="{$packageFile}" onclick="javascript:loadClassListFrame('{$classListFile}');">
														<xsl:if test="$isTopLevel='true'">
															<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
														</xsl:if>
														<xsl:if test="$isTopLevel='false'">
															<xsl:value-of select="$name"/>
														</xsl:if>
													</a>
												</td>
												<td class="summaryTableLastCol">
													<xsl:if test="not($config/overviews/package)">
														<xsl:variable name="overview" select="document($overviewsFile)/overviews/packages/package[@name=current()/apiName]"/>
														<xsl:for-each select="$overview/shortDescription">
															<xsl:call-template name="deTilda">
																<xsl:with-param name="inText" select="."/>
															</xsl:call-template>
														</xsl:for-each>
														<xsl:if test="string-length(string-join($overview/shortDescription/., ' '))">
															<xsl:value-of select="$nbsp"/>
														</xsl:if>
													</xsl:if>
													<xsl:if test="$config/overviews/package">
														<xsl:variable name="pname" select="ancestor-or-self::apiPackage/apiName"/>
														<xsl:for-each select="$config/overviews/package">
															<xsl:variable name="packageOverview" select="normalize-space(document(.)/overviews/packages/package[@name=$pname]/shortDescription/.)"/>
															<xsl:if test="string-length($packageOverview)">
																<xsl:call-template name="deTilda">
																	<xsl:with-param name="inText" select="$packageOverview"/>
																</xsl:call-template>
															</xsl:if>
														</xsl:for-each>
														<xsl:value-of select="$nbsp"/>
													</xsl:if>
												</td>
											</tr>
										</xsl:if>
									</xsl:for-each>
								</xsl:for-each>
							</xsl:otherwise>
						</xsl:choose>
					</table>
					<p/>
					<center class="copyright">
						<xsl:copy-of select="$copyright"/>
					</center>
				</div>
				<xsl:if test="$config/options[@livedocs='true']">
					<div class="separator">&#160;</div>
					<xsl:comment>BEGIN IONCOMMENTS</xsl:comment>
					<div id="ionComHere"> </div>
					<xsl:comment>END IONCOMMENTS</xsl:comment>
					<xsl:comment>#include virtual="ionComments.ssi"</xsl:comment>
					<p id="creativecommons" class="creativecommons">
						<a href="http://creativecommons.org/licenses/by-nc-sa/3.0/">
							<img id="creativecommons_img" src="images/CC.png"/>
						</a>
					</p>
					<xsl:comment>#include virtual="/livedocs/googleAnalytics.ssi"</xsl:comment>
					<xsl:comment>#include virtual="/ubi/analytics/analytics_ssi.html"</xsl:comment>
				</xsl:if>
			</xsl:element>
		</xsl:element>
		<xsl:copy-of select="$copyrightComment"/>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/package.xslt
================================================
<?xml version="1.0" encoding="utf-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://sf.net/saxon" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ifn="urn:internal:functions"
	exclude-result-prefixes="saxon xs ifn">
	<xsl:import href="asdoc-util.xslt"/>
	<xsl:import href="class-files.xslt"/>
	<xsl:output encoding="UTF-8" method="html" omit-xml-declaration="yes" use-character-maps="disable"/>
	<xsl:param name="outputPath" select="''"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:param name="packageOverviewFile" select="'overviews.xml'"/>
	<xsl:param name="packages_map_name" select="'packagemap.xml'"/>
	<xsl:template match="/">
		<xsl:for-each select="apiMap//apiItemRef">
			<xsl:sort select="@href" order="ascending"/>
			<xsl:variable name="ditaFileName">
				<xsl:value-of select="concat($ditaFileDir,@href)"/>
			</xsl:variable>
			<xsl:for-each select="document($ditaFileName)/apiPackage">
				<xsl:sort select="./apiName" order="ascending" lang="en-US"/>
				<xsl:variable name="name" select="./apiName"/>
				<xsl:variable name="interfaces">
					<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface and ./apiClassifierDetail/apiClassifierDef/apiBaseInterface">
						<xsl:call-template name="createBaseInterfaceList"/>
					</xsl:if>
				</xsl:variable>
				<xsl:variable name="isTopLevel">
					<xsl:call-template name="isTopLevel">
						<xsl:with-param name="packageName" select="$name"/>
					</xsl:call-template>
				</xsl:variable>
				<xsl:variable name="packageFile">
					<xsl:value-of select="$outputPath"/>
					<xsl:choose>
						<xsl:when test="$isTopLevel='true'">package.html</xsl:when>
						<xsl:otherwise>
							<xsl:value-of select="translate($name,'.','/')"/>/package.html</xsl:otherwise>
					</xsl:choose>
				</xsl:variable>
				<xsl:variable name="classListFile">
					<xsl:choose>
						<xsl:when test="$isTopLevel='true'">class-list.html</xsl:when>
						<xsl:otherwise>
							<xsl:value-of select="translate($name,'.','/')"/>/class-list.html</xsl:otherwise>
					</xsl:choose>
				</xsl:variable>
				<xsl:variable name="packageName">
					<xsl:choose>
						<xsl:when test="$isTopLevel='true'">
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
						</xsl:when>
						<xsl:otherwise>
							<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'PackagePackage']]/entry[2]/p"/>
							<xsl:text> </xsl:text>
							<xsl:value-of select="$name"/>
						</xsl:otherwise>
					</xsl:choose>
				</xsl:variable>
				<xsl:variable name="xrefPackageName">
					<xsl:choose>
						<xsl:when test="$isTopLevel='true'">__Global__</xsl:when>
						<xsl:otherwise>
							<xsl:value-of select="$name"/>
						</xsl:otherwise>
					</xsl:choose>
				</xsl:variable>
				<xsl:variable name="title">
					<xsl:if test="$isTopLevel='true'">
						<xsl:value-of select="concat($asdoc_terms/row[entry[1][p/text() = 'TopLevelConstantsFunctions']]/entry[2]/p,' - ',$title-base)"/>
					</xsl:if>
					<xsl:if test="not($isTopLevel='true')">
						<xsl:value-of select="concat($name,' ', $asdoc_terms/row[entry[1][p/text() = 'Package']]/entry[2]/p, ' - ',$title-base)"/>
					</xsl:if>
				</xsl:variable>
				<xsl:variable name="baseRef">
					<xsl:call-template name="getBaseRef">
						<xsl:with-param name="packageName" select="ancestor-or-self::apiPackage/apiName"/>
					</xsl:call-template>
				</xsl:variable>
				<xsl:variable name="hasConstants" select="count(apiValue[not(./apiValueDetail/apiValueDef/apiProperty)]) &gt; 0"/>
				<xsl:variable name="hasFields" select="count(apiValue/apiValueDetail/apiValueDef/apiProperty) &gt; 0"/>
				<xsl:variable name="hasFunctions" select="count(./apiOperation) &gt; 0"/>
				<xsl:if test="$hasConstants or $hasFields or $hasFunctions">
					<!-- TODO move this to asdoc-util -->
					<xsl:variable name="pname" select="$name"/>
					<xsl:result-document href="{$packageFile}">
						<xsl:copy-of select="$docType"/>
						<xsl:if test="$config/options[@livedocs='true']">
							<xsl:comment>#config errmsg=""</xsl:comment>
						</xsl:if>
						<xsl:element name="html">
							<head>
								<xsl:call-template name="getStyleLink">
									<xsl:with-param name="link" select="/asdoc/link"/>
									<xsl:with-param name="packageName" select="$name"/>
								</xsl:call-template>
								<title>
									<xsl:if test="$isTopLevel='true'">
										<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevelConstantsFunctions']]/entry[2]/p"/>
									</xsl:if>
									<xsl:if test="$isTopLevel='false'">
										<xsl:value-of select="$name"/>
									</xsl:if>
									<xsl:text> </xsl:text>
									<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'Details']]/entry[2]/p"/>
									<xsl:call-template name="getPageTitlePostFix"/>
								</title>
								<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
							</head>
							<xsl:element name="body">
								<xsl:if test="$isEclipse">
									<xsl:attribute name="class">
										<xsl:text>eclipseBody</xsl:text>
									</xsl:attribute>
								</xsl:if>
								<xsl:call-template name="getTitleScript">
									<xsl:with-param name="title" select="$title"/>
									<xsl:with-param name="packageName" select="$name"/>
								</xsl:call-template>
								<xsl:call-template name="getLinks2">
									<xsl:with-param name="subTitle">
										<xsl:choose>
											<xsl:when test="$isTopLevel='true'">
												<xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'TopLevel']]/entry[2]/p"/>
											</xsl:when>
											<xsl:otherwise>
												<xsl:apply-templates select="$asdoc_terms/row[entry[1][p/text() = 'PackagePackage']]/entry[2]/p" mode="terms">
													<xsl:with-param name="package" select="$name"/>
												</xsl:apply-templates>
											</xsl:otherwise>
										</xsl:choose>
									</xsl:with-param>
									<xsl:with-param name="fileName" select="'package'"/>
									<xsl:with-param name="fileName2" select="$classListFile"/>
									<xsl:with-param name="packageName" select="$name"/>
									<xsl:with-param name="showProperties" select="false()"/>
									<xsl:with-param name="showMethods" select="false()"/>
									<xsl:with-param name="showPackageConstants" select="boolean(number($hasConstants))"/>
									<xsl:with-param name="showPackageProperties" select="boolean(number($hasFields))"/>
									<xsl:with-param name="showPackageFunctions" select="boolean(number($hasFunctions))"/>
								</xsl:call-template>
								<div class="MainContent">
									<xsl:apply-templates mode="annotate" select="$config/annotate/item[@type='package' and @name=$name and string-length($name) and tokenize($name,',')[starts-with($pname,.)]]"/>
									<br/>
									<xsl:if test="$hasFields">
										<a name="propertySummary"/>
										<xsl:if test="not($config/overviews/package)">
											<xsl:variable name="packageComments" select="document($packageOverviewFile)/overviews/packages/package[@name=$pname]"/>
											<xsl:call-template name="deTilda">
												<xsl:with-param name="inText" select="$packageComments/propertiesDescription"/>
											</xsl:call-template>
											<xsl:for-each select="$packageComments/propertiesDescription">
												<xsl:call-template name="sees">
													<xsl:with-param name="xrefId" select="concat($xrefPackageName,'#propertySummary')"/>
												</xsl:call-template>
											</xsl:for-each>
										</xsl:if>
										<xsl:if test="$config/overviews/package">
											<xsl:for-each select="$config/overviews/package">
												<xsl:variable name="packageOverview" select="document(.)/overviews/packages/package[@name=$pname]"/>
												<xsl:if test="$packageOverview/propertiesDescription">
													<xsl:call-template name="deTilda">
														<xsl:with-param name="inText" select="$packageOverview/propertiesDescription"/>
													</xsl:call-template>
													<xsl:for-each select="$packageOverview/propertiesDescription">
														<xsl:call-template name="sees">
															<xsl:with-param name="xrefId" select="concat($xrefPackageName,'#propertySummary')"/>
														</xsl:call-template>
													</xsl:for-each>
												</xsl:if>
											</xsl:for-each>
										</xsl:if>
										<xsl:variable name="interfaces">
											<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface and ./apiClassifierDetail/apiClassifierDef/apiBaseInterface">
												<xsl:call-template name="createBaseInterfaceList"/>
											</xsl:if>
										</xsl:variable>
										<xsl:call-template name="fieldSummary">
											<xsl:with-param name="isGlobal" select="$isTopLevel='true'"/>
											<xsl:with-param name="showAnchor" select="false()"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
											<xsl:with-param name="interfaces" select="$interfaces" tunnel="yes"/>
										</xsl:call-template>
										<xsl:if test="boolean(number($hasFunctions)) or boolean(number($hasConstants))">
											<br/>
											<br/>
										</xsl:if>
									</xsl:if>
									<xsl:if test="$hasFunctions">
										<a name="methodSummary"/>
										<xsl:variable name="packageComments" select="document($packageOverviewFile)/overviews/packages/package[@name=$pname]"/>
										<xsl:if test="not($config/overviews/package)">
											<xsl:call-template name="deTilda">
												<xsl:with-param name="inText" select="$packageComments/functionsDescription"/>
											</xsl:call-template>
											<xsl:for-each select="$packageComments/functionsDescription">
												<xsl:call-template name="sees">
													<xsl:with-param name="xrefId" select="concat($xrefPackageName,'#methodSummary')"/>
												</xsl:call-template>
											</xsl:for-each>
										</xsl:if>
										<xsl:if test="$config/overviews/package">
											<xsl:for-each select="$config/overviews/package">
												<xsl:variable name="packageOverview" select="document(.)/overviews/packages/package[@name=$pname]"/>
												<xsl:if test="$packageOverview/functionsDescription">
													<xsl:call-template name="deTilda">
														<xsl:with-param name="inText" select="$packageOverview/functionsDescription"/>
													</xsl:call-template>
													<xsl:for-each select="$packageOverview/functionsDescription">
														<xsl:call-template name="sees">
															<xsl:with-param name="xrefId" select="concat($xrefPackageName,'#methodSummary')"/>
														</xsl:call-template>
													</xsl:for-each>
												</xsl:if>
											</xsl:for-each>
										</xsl:if>
										<xsl:variable name="interfaces">
											<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface and ./apiClassifierDetail/apiClassifierDef/apiBaseInterface">
												<xsl:call-template name="createBaseInterfaceList"/>
											</xsl:if>
										</xsl:variable>
										<xsl:call-template name="methodSummary">
											<xsl:with-param name="className" select="'package'"/>
											<xsl:with-param name="title" select="$asdoc_terms/row[entry[1][p/text() = 'Functions']]/entry[2]/p"/>
											<xsl:with-param name="isGlobal" select="$isTopLevel='true'"/>
											<xsl:with-param name="showAnchor" select="false()"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
											<xsl:with-param name="interfaces" select="$interfaces" tunnel="yes"/>
										</xsl:call-template>
										<xsl:if test="boolean(number($hasConstants))">
											<br/>
											<br/>
										</xsl:if>
									</xsl:if>
									<xsl:if test="$hasConstants">
										<a name="constantSummary"/>
										<xsl:if test="not($config/overviews/package)">
											<xsl:variable name="packageComments" select="document($packageOverviewFile)/overviews/packages/package[@name=$pname]"/>
											<xsl:call-template name="deTilda">
												<xsl:with-param name="inText" select="$packageComments/constantsDescription"/>
											</xsl:call-template>
											<xsl:for-each select="$packageComments/constantsDescription">
												<xsl:call-template name="sees">
													<xsl:with-param name="xrefId" select="concat($xrefPackageName,'#constantSummary')"/>
												</xsl:call-template>
											</xsl:for-each>
										</xsl:if>
										<xsl:if test="$config/overviews/package">
											<xsl:for-each select="$config/overviews/package">
												<xsl:variable name="packageOverview" select="document(.)/overviews/packages/package[@name=$pname]"/>
												<xsl:if test="$packageOverview/constantsDescription">
													<xsl:call-template name="deTilda">
														<xsl:with-param name="inText" select="$packageOverview/constantsDescription"/>
													</xsl:call-template>
													<xsl:for-each select="$packageOverview/constantsDescription">
														<xsl:call-template name="sees">
															<xsl:with-param name="xrefId" select="concat($xrefPackageName,'#constantSummary')"/>
														</xsl:call-template>
													</xsl:for-each>
												</xsl:if>
											</xsl:for-each>
										</xsl:if>
										<xsl:variable name="interfaces">
											<xsl:if test="./apiClassifierDetail/apiClassifierDef/apiInterface and ./apiClassifierDetail/apiClassifierDef/apiBaseInterface">
												<xsl:call-template name="createBaseInterfaceList"/>
											</xsl:if>
										</xsl:variable>
										<xsl:call-template name="fieldSummary">
											<xsl:with-param name="isConst" select="'true'"/>
											<xsl:with-param name="isGlobal" select="$isTopLevel='true'"/>
											<xsl:with-param name="showAnchor" select="false()"/>
											<xsl:with-param name="baseRef" select="$baseRef"/>
											<xsl:with-param name="interfaces" select="$interfaces" tunnel="yes"/>
										</xsl:call-template>
									</xsl:if>
									<!--<xsl:apply-templates select="apiValue" mode="detail"/>-->
									<!-- CONSTANT DETAILS FOR PACKAGES-->
									<xsl:if test="boolean(number($hasConstants))">
										<div class="detailSectionHeader">
											<xsl:call-template name="getLocalizedString">
												<xsl:with-param name="key">ConstantDetail</xsl:with-param>
											</xsl:call-template>
										</div>
									</xsl:if>
									<xsl:apply-templates select="apiValue[not(apiValueDetail/apiValueDef/apiProperty)]" mode="detail">
										<xsl:with-param name="isConst" select="'true'"/>
									</xsl:apply-templates>
									<!--END OF CONSTANT DETAILS-->
									<!--FUNCTION DETAILS -->
									<xsl:call-template name="methodsDetails">
										<xsl:with-param name="className" select="'package'"/>
										<xsl:with-param name="title">
											<xsl:call-template name="getLocalizedString">
												<xsl:with-param name="key">FunctionDetail</xsl:with-param>
											</xsl:call-template>
										</xsl:with-param>
										<xsl:with-param name="baseRef" select="$baseRef"/>
									</xsl:call-template>
									<!--END OF FUNCTION DETAILS -->
									<!--PROPERTIES DETAILS -->
									<xsl:if test="boolean(number($hasFields))">
										<div class="detailSectionHeader">
											<xsl:call-template name="getLocalizedString">
												<xsl:with-param name="key">PropertyDetail</xsl:with-param>
											</xsl:call-template>
										</div>
									</xsl:if>
									<xsl:apply-templates select="apiValue[apiValueDetail/apiValueDef/apiProperty]" mode="detail">
										<xsl:with-param name="className" select="'package'"/>
										<xsl:with-param name="title">
											<xsl:call-template name="getLocalizedString">
												<xsl:with-param name="key">PropertyDetail</xsl:with-param>
											</xsl:call-template>
										</xsl:with-param>
									</xsl:apply-templates>
									<!--END OF PROPERTIES DETAILS -->
									<p/>
									<xsl:call-template name="getFeedbackLink">
										<xsl:with-param name="topic" select="$packageName"/>
										<xsl:with-param name="filename">
											<xsl:if test="$isTopLevel='true'">package.html</xsl:if>
											<xsl:if test="$isTopLevel!='true'">
												<xsl:value-of select="translate($name,'.','/')"/>
												<xsl:text>/package.html</xsl:text>
											</xsl:if>
										</xsl:with-param>
										<xsl:with-param name="filename2">
											<xsl:if test="$isTopLevel='true'">class-list.html</xsl:if>
											<xsl:if test="$isTopLevel!='true'">
												<xsl:value-of select="translate($name,'.','/')"/>
												<xsl:text>/class-list.html</xsl:text>
											</xsl:if>
										</xsl:with-param>
									</xsl:call-template>
									<center class="copyright">
										<xsl:copy-of select="$copyright"/>
									</center>
									<xsl:call-template name="addKeywords">
										<xsl:with-param name="keyword">
											<xsl:if test="$isTopLevel='true'">
												<xsl:value-of select="'Top Level'"/>
											</xsl:if>
											<xsl:if test="$isTopLevel!='true'">
												<xsl:value-of select="$name"/>
											</xsl:if>
										</xsl:with-param>
									</xsl:call-template>
								</div>
								<xsl:if test="$config/options[@livedocs='true']">
									<div class="separator">&#160;</div>
									<xsl:comment>BEGIN IONCOMMENTS</xsl:comment>
									<div id="ionComHere"> </div>
									<xsl:comment>END IONCOMMENTS</xsl:comment>
									<xsl:comment>#include virtual="ionComments.ssi"</xsl:comment>
									<p id="creativecommons" class="creativecommons">
										<a href="http://creativecommons.org/licenses/by-nc-sa/3.0/">
											<img id="creativecommons_img" src="{$baseRef}images/CC.png"/>
										</a>
									</p>
									<xsl:comment>#include virtual="/livedocs/googleAnalytics.ssi"</xsl:comment>
									<xsl:comment>#include virtual="/ubi/analytics/analytics_ssi.html"</xsl:comment>
								</xsl:if>
							</xsl:element>
						</xsl:element>
					</xsl:result-document>
				</xsl:if>
			</xsl:for-each>
		</xsl:for-each>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/print.css
================================================
/*
////////////////////////////////////////////////////////////////////////////////
//
//  ADOBE SYSTEMS INCORPORATED
//  Copyright 2005-2008 Adobe Systems Incorporated
//  All Rights Reserved.
//
//  NOTICE: Adobe permits you to use, modify, and distribute this file
//  in accordance with the terms of the license agreement accompanying it.
//
////////////////////////////////////////////////////////////////////////////////
*/

body {
  color: #000000;
  background: #ffffff;
  font-family: "Times New Roman", Times, serif;
  font-size: 12pt;
}
a {
  text-decoration: none;
  color: #000000;
}
pre {
  white-space: -moz-pre-wrap; /* Mozilla */
  white-space: -pre-wrap;     /* Opera 4-6 */
  white-space: -o-pre-wrap;   /* Opera 7 */
  word-wrap: break-word;      /* IE */
}
.titleTableTopNav, .titleTableSubNav, .logoImage {
  display: none;
}
.packageFrame {
  display: none;
}
.titleTableSubTitle {
  font-weight: bold;
}
.classHeaderTableLabel {
	padding-right: 10px;
	vertical-align: top;
}
.showHideLinks {
  display: none;
}
html>body code {
  font-size: 10pt;
}
.summaryTableTitle, .detailSectionHeader {
  font-size: 14pt;
  font-weight: bold;
  padding-top: 15px;
  padding-bottom: 5px;
}
.summaryTable {
  border: 1px solid #000000;
  border-collapse: collapse;
  width: 100%;
}
.summaryTableDescription {
  padding-bottom: 20px;
}
.summaryTableSignatureCol, .summaryTableOwnerCol, .summaryTableLastCol, .summaryTableCol {
  border: 1px solid #000000;
}
.summaryTablePaddingCol {
  border: 1px solid #000000;
  border-right: 0px;
}
.summaryTableInheritanceCol, .summaryTableOperatorCol, .summaryTableStatementCol, .summaryTableSecondCol {
  border: 1px solid #000000;
  border-left: 0px;
}
.summaryTableLastCol {
  vertical-align: top;
}
.detailHeader {
  font-size: 13pt;
  padding-top: 100px;
}
.detailHeaderName {
  font-weight: bold;
}
.detailHeaderType {
  padding-left: 5px;
}
.detailHeaderRule {
  background: #FF0000;
}
.seeAlso {
  padding-bottom: 20px;
  margin-top: -20px;
}
.innertable {
  border-collapse: collapse;
}
.innertable td,.innertable th {
  border: 1px solid #000000;
  padding-left: 5px;
  padding-right: 5px;
}
.listing {
  font-size: 10pt;
}
.feedbackLink {
  display: none;
}
.copyright {
  font-size: 10pt;
}

================================================
FILE: documentation/api-reference/templates/processHTML.xslt
================================================
<?xml version="1.0" encoding="utf-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns:saxon="http://saxon.sf.net/" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ifn="urn:internal:functions"
  exclude-result-prefixes="saxon xs ifn">
  <xsl:import href="asdoc-util.xslt"/>
  <xsl:output method="html" encoding="UTF-8" omit-xml-declaration="yes" use-character-maps="disable" indent="no"/>
  <xsl:param name="titleBarFile" select="''"/>
  <xsl:param name="index-file" select="''"/>
  <xsl:param name="package-frame" select="''"/>
  <xsl:param name="liveDocsTitleBarFile" select="''"/>
  <xsl:param name="packages_map_name" select="'packagemap.xml'"/>
  <xsl:param name="prog_language_name" select="''"/>
  <xsl:template match="/">
    <xsl:choose>
      <xsl:when test="$liveDocsTitleBarFile = '' and  $titleBarFile = ''">
        <xsl:apply-templates select="./html"/>
      </xsl:when>
      <xsl:when test="$isLiveDocs">
        <xsl:apply-templates select="document($liveDocsTitleBarFile)/html"/>
      </xsl:when>
      <xsl:when test="$isStandalone">
        <xsl:apply-templates select="document($titleBarFile)/html"/>
      </xsl:when>
      <xsl:when test="$prog_language_name='javascript'"/>
      <xsl:otherwise>
        <xsl:apply-templates select="document($titleBarFile)/html"/>
      </xsl:otherwise>
    </xsl:choose>
  </xsl:template>
  <xsl:template match="node() | @*" priority="-1">
    <xsl:copy>
      <xsl:apply-templates select="@* | node()"/>
    </xsl:copy>
  </xsl:template>
  <xsl:template match="html">
    <xsl:copy-of select="$noLiveDocs"/>
    <xsl:choose>
      <xsl:when test=".//frameset">
        <xsl:copy-of select="$frameDocType"/>
      </xsl:when>
      <xsl:otherwise>
        <xsl:copy-of select="$docType"/>
      </xsl:otherwise>
    </xsl:choose>
    <xsl:choose>
      <xsl:when test="$isLiveDocs"/>
      <xsl:otherwise>
        <xsl:value-of select="$markOfTheWeb"/>
      </xsl:otherwise>
    </xsl:choose>
    <xsl:element name="html">
      <xsl:apply-templates/>
      <xsl:copy-of select="$copyrightComment"/>
      <xsl:value-of select="$newline"/>
    </xsl:element>
  </xsl:template>
  <xsl:template match="title">
    <xsl:choose>
        <xsl:when test="$index-file">
		<xsl:copy>
		  <xsl:value-of select="$config/windowTitle"/>
		</xsl:copy>
        </xsl:when>
        <xsl:when test="$package-frame">
          <title>
            <xsl:value-of select="$config/title"/>
          </title>
        </xsl:when>
        <xsl:when test="$titleBarFile">
          <title>
            <xsl:value-of select="$config/title"/>
          </title>
        </xsl:when>
      <xsl:otherwise>
        <xsl:copy>
          <xsl:value-of select="$config/title"/>
        </xsl:copy>
      </xsl:otherwise>
    </xsl:choose>
    <link rel="stylesheet" href="style.css" type="text/css" media="screen"/>
    <link rel="stylesheet" href="print.css" type="text/css" media="print"/>
    <link rel="stylesheet" href="override.css" type="text/css"/>
  </xsl:template>
  <xsl:template match="head/link"/>
  <xsl:template name="script">
    <xsl:variable name="loc.search">
      <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'SearchResults']]/entry[2]/p"/>
    </xsl:variable>
    <script language="javascript" type="text/javascript">
      <xsl:text>&#xa;</xsl:text>function submitValue(){
      <xsl:text>&#xa;</xsl:text>
      var searchStr=document.getElementById('search-livedocs').value; var windowLocation=window.top.location.href.split("###");      window.top.location=windowLocation[0]+"###"+searchStr; parent.frames["classFrame"].location = "search.html";      document.getElementById('subTitle').childNodes.item(0).data = "<xsl:value-of select="$loc.search"/>"; document.getElementById('search-livedocs').value=searchStr;      return false; <xsl:text>&#xa;</xsl:text><xsl:text>}</xsl:text>      <xsl:value-of select="$newline"/>      <xsl:text>&#xa;</xsl:text> function noFrms(){ var doc =      parent.frames["classFrame"].location.href.substring(window.location.href.lastIndexOf("/")+1); if(doc=="search.html"){ var      curLoc=window.top.location.href.split("?"); var openFile; if(curLoc[1]!=null){ curLoc = curLoc[1].split("###"); curLoc =      curLoc[0].split("&amp;"); openFile = window.top.location.href.substring(0,window.top.location.href.lastIndexOf("?")+1); openFile =      openFile.substring(0,openFile.lastIndexOf("/")+1)+curLoc[0]; }else{ curLoc[0]="overview.html"; openFile =      window.top.location.href.substring(0,window.top.location.href.lastIndexOf("/")+1)+curLoc[0]; } top.location=openFile; }else{      top.location=top.classFrame.location;
      <xsl:text>&#xa;</xsl:text>
      <xsl:text>}</xsl:text>
      <xsl:text>&#xa;</xsl:text>}
    </script>
  </xsl:template>
  <xsl:template match="td[@class='titleTableTitle']">
    <xsl:copy>
      <xsl:copy-of select="@*"/>
      <xsl:choose>
        <xsl:when test="$prog_language_name='javascript'"/>
        <xsl:otherwise>
          <xsl:value-of select="$config/title"/>
        </xsl:otherwise>
      </xsl:choose>
    </xsl:copy>
    <xsl:choose>
      <xsl:when test="$config/options[@standalonesearch='true']">
        <td class="titleTableSearch" align="center">
          <form class="searchForm" method="get" onsubmit="return submitValue();">
            <input class="hidden" name="loc" value="{$liveDocsSearchLocale}" type="hidden"/>
            <input class="hidden" name="termPrefix" value="" type="hidden"/>
            <input class="hidden" name="term" value="" type="hidden"/>
            <input class="hidden" name="area" value="" type="hidden"/>
            <input id="search-livedocs" name="search_text" value="" title="{$liveDocsSearchString}" type="text"/>
            <xsl:text> </xsl:text>
            <input type="button" name="action" value="{$liveDocsSearch}" onclick="submitValue()"/>
          </form>
        </td>
      </xsl:when>
      <xsl:when test="$config/options[@ion='true']">
        <td class="titleTableSearch" align="center">
          <xsl:comment>#include virtual="/livedocs/flex/3/langref/ionsearchform.ssi"</xsl:comment>
        </td>
      </xsl:when>
      <xsl:when test="$config/options[@livedocs='true']">
        <td class="titleTableSearch" align="center">
          <form class="searchForm" method="get" action="http://www.adobe.com/cfusion/search/index.cfm" target="adbe_window"
            onsubmit="this.term.value= this.termPrefix.value + &quot;\&quot;&quot; + this.search_text.value + &quot;\&quot;&quot;;">
            <input class="hidden" name="loc" value="en" type="hidden"/>
            <input class="hidden" name="termPrefix" value="site:livedocs.adobe.com/labs/flex3   " type="hidden"/>
            <input class="hidden" name="term" value="" type="hidden"/>
            <input class="hidden" name="area" value="" type="hidden"/>
            <input id="search-livedocs" name="search_text" value="" title="Search" type="text"/>
            <input type="submit" name="action" value="Search"/>
          </form>
        </td>
      </xsl:when>
      <xsl:otherwise>
        <td class="titleTableSearch" align="center">&#xA0;</td>
      </xsl:otherwise>
    </xsl:choose>
  </xsl:template>
  <xsl:template match="td[@class='titleTableSearch']"/>
  <xsl:template match="tr[@class='titleTableRow3']/td[@colspan='2']">
    <xsl:choose>
      <xsl:when test="$config/options[@standalonesearch='true']">
        <td colspan="3">&#xA0;</td>
      </xsl:when>
      <xsl:otherwise>
        <td colspan="3">&#xA0;</td>
      </xsl:otherwise>
    </xsl:choose>
  </xsl:template>
  <xsl:template match="tr[@class='titleTableRow2']/td[@class='titleTableSubTitle']">
    <xsl:choose>
      <xsl:when test="$config/options[@standalonesearch='true']">
        <td class="titleTableSubTitle" id="subTitle" align="left" colspan="2">&#xA0;</td>
      </xsl:when>
      <xsl:otherwise>
        <td class="titleTableSubTitle" id="subTitle" align="left" colspan="2">&#xA0;</td>
      </xsl:otherwise>
    </xsl:choose>
  </xsl:template>
  <xsl:template match="h3">
    <xsl:variable name="localized_value">
      <xsl:choose>
        <xsl:when test="normalize-space(.) = 'Index'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Index</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:otherwise>
          <xsl:value-of select="."/>
        </xsl:otherwise>
      </xsl:choose>
    </xsl:variable>
    <xsl:copy>
      <xsl:copy-of select="@*"/>
      <xsl:value-of select="$localized_value"/>
    </xsl:copy>
  </xsl:template>
  <xsl:template match="a">
    <xsl:variable name="re-value" select="normalize-space(.)"/>
    <xsl:variable name="value" select="replace($re-value,'&lt;','&amp;lt;')"/>
    <xsl:variable name="localized_value">
      <xsl:choose>
        <xsl:when test="$value = 'All Classes'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">allClasses</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'All Packages'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">allPackages</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Language Elements'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">LanguageElements</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Appendixes'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Appendix</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Index'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Index</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Conventions'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Conventions</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'No Frames'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">NoFrames</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Properties'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Properties</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Constructor'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Constructor</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Methods'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Methods</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Functions'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Functions</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Events'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Events</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Effects'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Effects</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Constants'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Constants</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Interfaces'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Interfaces</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Classes'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Classes</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Examples'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Examples</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Styles'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Styles</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        
        <xsl:when test="$value = 'Skin States'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">SkinStates</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:when test="$value = 'Skin Parts'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">SkinParts</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        
        <xsl:when test="$value = 'Symbols'">
          <xsl:call-template name="getLocalizedString">
            <xsl:with-param name="key">Symbols</xsl:with-param>
          </xsl:call-template>
        </xsl:when>
        <xsl:otherwise>
          <xsl:value-of select="$value"/>
        </xsl:otherwise>
      </xsl:choose>
    </xsl:variable>
    <xsl:copy>
      <xsl:copy-of select="@*"/>
      <xsl:value-of select="$localized_value"/>
    </xsl:copy>
  </xsl:template>
  <!-- PSEN: 06/02/2008 We should always show the "No Frames" link  <xsl:template match="a[@onclick='top.location=top.classFrame.location']">    <xsl:if test="$config/options[@standalonesearch='true']">	  <a href="" onclick="noFrms();">          <xsl:call-template name="getLocalizedString">            <xsl:with-param name="key">NoFrames</xsl:with-param>          </xsl:call-template>      </a>    </xsl:if>  </xsl:template>-->
  <xsl:template match="script">
    <xsl:element name="script">
      <xsl:apply-templates select="@* | node()"/>
      <xsl:value-of select="$newline"/>
    </xsl:element>
    <xsl:if test="$config/options[@standalonesearch='true']">
      <xsl:call-template name="script"/>
    </xsl:if>
  </xsl:template>
  <xsl:template match="text()">
    <xsl:value-of disable-output-escaping="no" select="."/>
  </xsl:template>
  <xsl:template match="comment()">
    <xsl:comment>
      <xsl:value-of disable-output-escaping="yes" select="."/>
    </xsl:comment>
  </xsl:template>
  <xsl:template match="input[@name='termPrefix']/@value">
    <xsl:attribute name="value">
      <xsl:value-of select="$config/livedocs/searchsite/."/>
    </xsl:attribute>
  </xsl:template>
  <xsl:template match="input/@value[.='Search']">
    <xsl:attribute name="value">
      <xsl:value-of select="$asdoc_terms/row[entry[1][p/text() = 'searchLivedocs']]/entry[2]/p"/>
    </xsl:attribute>
  </xsl:template>
  <xsl:template match="input[@name='loc']/@value">
    <xsl:attribute name="value">
      <xsl:value-of select="$config/livedocs/locale/."/>
    </xsl:attribute>
  </xsl:template>
  <xsl:template match="input[@name='search_text']/@title">
    <xsl:attribute name="title">
      <xsl:value-of select="$config/livedocs/searchstring/."/>
    </xsl:attribute>
  </xsl:template>
  <xsl:template match="input[@name='action']">
    <xsl:if test="$config/options[@standalonesearch='true']">
      <input>
        <xsl:attribute name="type">
          <xsl:if test="contains(@type,'submit')">
            <xsl:value-of select="replace(@type,'submit','button')"/>
          </xsl:if>
        </xsl:attribute>
        <xsl:attribute name="name">
          <xsl:value-of select="'action'"/>
        </xsl:attribute>
        <xsl:attribute name="value">
          <xsl:value-of select="'Search'"/>
        </xsl:attribute>
        <xsl:attribute name="onclick">
          <xsl:value-of select="'submitValue()'"/>
        </xsl:attribute>
      </input>
    </xsl:if>
  </xsl:template>
  <xsl:template match="form/@action">
    <xsl:attribute name="action">
      <xsl:value-of select="$config/livedocs/searchservlet/."/>
    </xsl:attribute>
  </xsl:template>
  <xsl:template match="frameset/@rows">
    <xsl:choose>
      <xsl:when test="$prog_language_name='javascript'"/>
      <xsl:otherwise>
        <xsl:if test="$index-file">
          <xsl:attribute name="rows">
            <xsl:text>80,*</xsl:text>
          </xsl:attribute>
        </xsl:if>
        <xsl:if test="$package-frame">
          <xsl:attribute name="rows">
            <xsl:text>40%,60%</xsl:text>
          </xsl:attribute>
        </xsl:if>
      </xsl:otherwise>
    </xsl:choose>
  </xsl:template>
  <xsl:template match="td[@class='titleTableTopNav']">
    <xsl:choose>
      <xsl:when test="$prog_language_name='javascript'"/>
      <xsl:otherwise>
        <td class="titleTableTopNav" align="right">
          <xsl:apply-templates/>
        </td>
      </xsl:otherwise>
    </xsl:choose>
  </xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/style.css
================================================
/*
////////////////////////////////////////////////////////////////////////////////
//
//  ADOBE SYSTEMS INCORPORATED
//  Copyright 2005-2008 Adobe Systems Incorporated
//  All Rights Reserved.
//
//  NOTICE: Adobe permits you to use, modify, and distribute this file
//  in accordance with the terms of the license agreement accompanying it.
//
////////////////////////////////////////////////////////////////////////////////
*/

.titleTable {
	width: 100%;
}
.titleTableTitle {
	white-space: nowrap;
	padding-left: 15px;
	padding-right: 5px;
	font-size: 13px;
	height: 44px;
	background-image: url(images/titleTableTop.jpg);
	background-repeat: repeat-x;
}
.titleTableSearch {
	white-space: nowrap;
	background-image: url(images/titleTableTop.jpg);
	background-repeat: repeat-x;
	padding-right: 10px;
	width: 220;
}
.searchForm {
	margin-top: 0px;
	margin-bottom: 0px;
}
.titleTableTopNav {
	font-size: 12px;
	background-image: url(images/titleTableTop.jpg);
	background-repeat: repeat-x;
}
.titleTableLogo {
	width: 76px;
	height: 80px;
	vertical-align: top;
}
.titleTableRow2 {
	color: #000000;
	height: 31px;
	background-image: url(images/titleTableMiddle.jpg);
	background-repeat: repeat-x;
}
.titleTableSubTitle {
	font-size: 20px;
	padding-left: 15px;
	padding-right: 5px;
}
.titleTableSubNav {
	//white-space: nowrap;
	font-size: 12px;
}
.titleTableRow3 {
	height: 5px;
	background-image: url(images/titleTableBottom.jpg);
	background-repeat: repeat-x;
}
.logoImage {
	width: 76px;
	height: 80px;
}

.classHeaderTable {
	margin-top: 20px;
}
.classHeaderTable td {
	vertical-align: top;
	padding-bottom: 4px;
}
.classHeaderTableLabel {
	font-weight: bold;
	padding-right: 15px;
}
.classSignature {
	text-indent: -20px;
	padding-left: 20px;
}
.inheritanceList {
	text-indent: -20px;
	padding-left: 20px;
}
.inheritArrow {
	width: 15px;
	height: 9px;
}
.mxmlSyntax {
	margin-bottom: -13px;
}
.collapsedImage {
	width: 9px;
	height: 9px;
	border: 0;
}
.expandedImage {
	width: 9px;
	height: 9px;
	border: 0;
}
.classFrameContent {
	margin-right: 5px;
	margin-left: 10px;
	margin-top: 10px;
	margin-bottom: 10px;
}
.classFrameContent td {
	white-space: nowrap;
	padding-right: 5px;
}

.eclipseBody {
	display: none;
}
	
/** html {
	overflow-y:scroll;
}*/

img {
	border:0;
}

.annotation {
	font-size: 20px;
	margin-top: 20px;
}

.label {
	color: #444444;
	font-weight: bold;
}

strong {
	color: #444444;
}

.summarySection {
	margin-left: 20px;
	margin-right: 10px;
}
.summaryTableTitle {
	font-weight: bold;
	font-size: 18px;
	padding-top: 20px;
	padding-bottom: 5px;
}
* .summaryTable {
	margin-top: 10px;
	border: #999999 1px solid;
	width: 100%;
	margin-bottom: 20px;
}
html>body .summaryTable {
	margin-top: 10px;
	border: #999999 1px solid;
	width: 100%;
	margin-bottom: 20px;
	margin-right: 10px;
}
.summaryTable th {
	color: #FFFFFF;
	background-color: #627C9D;
	white-space: nowrap;
}
.summaryTable td {
	border-top: #999999 1px solid;
	vertical-align: top;
}
.summaryTablePaddingCol {
	width: 5px;
}
.summaryTableInheritanceCol {
	width: 14px;
}
.summaryTableSignatureCol {
	padding-right: 10px;
}
.summaryTableOperatorCol {
	padding-left: 10px;
	padding-right: 10px;
	font-weight: bold;
}
.summaryTableStatementCol {
	padding-left: 10px;
	padding-right: 10px;
	font-weight: bold;
	white-space: nowrap;
}
.summarySignature {
	text-indent: -20px;
	padding-left: 20px;
}
.summaryTableOwnerCol {
	padding-right: 10px;
	width: 10px;
}
.summaryTableCol, .summaryTableSecondCol {
}
.signatureLink {
	font-weight: bold;
}
.summaryTableDescription {
	color: #333333;
}
.summaryTableLastCol {
	padding-right: 10px;
}
.inheritedSummaryImage {
	width: 14px;
	height: 14px;
}

.showHideLink {
}
.showHideLinkImage {
	width: 9px;
	height: 9px;
}
.hideInheritedConstant {
	display: none;
}
.showInheritedConstant {
	display: inline;
}
.hideInheritedProtectedConstant {
	display: none;
}
.showInheritedProtectedConstant {
	display: inline;
}
.hideInheritedProperty {
	display: none;
}
.showInheritedProperty {
	display: inline;
}
.hideInheritedProtectedProperty {
	display: none;
}
.showInheritedProtectedProperty {
	display: inline;
}
.hideInheritedMethod {
	display: none;
}
.showInheritedMethod {
	display: inline;
}
.hideInheritedProtectedMethod {
	display: none;
}
.showInheritedProtectedMethod {
	display: inline;
}
.hideInheritedEvent {
	display: none;
}
.showInheritedEvent {
	display: inline;
}
.hideInheritedStyle {
	display: none;
}
.showInheritedStyle {
	display: inline;
}
.hideInheritedEffect {
	display: none;
}
.showInheritedEffect {
	display: inline;
}


.detailSectionHeader {
	color: #434343;
	font-size: 18px;
	padding-left: 10px;
	padding-top: 4px;
	padding-bottom: 4px;
	margin-top: 40px;
	margin-bottom: 3px;
	background-image: url(images/detailSectionHeader.jpg);
	background-repeat: repeat-x;
}
.detailHeader {
	margin-left: 20px;
	margin-top: 10px;
	margin-bottom: 3px;
}
.detailHeaderName {
	font-weight: bold;
	font-size: 16px;
	vertical-align: baseline;
	white-space: nowrap;
}
.detailHeaderType {
	font-size: 12px;
	vertical-align: baseline;
	padding-right: 10px;
	padding-left: 7px;
	white-space: nowrap;
}
.detailHeaderParens {
	font-size: 14px;
	font-weight: bold;
	padding-left: 1px;
	padding-bottom: 2px;
}
.detailHeaderRule {
	background-image: url(images/detailHeaderRule.jpg);
	background-repeat: repeat-x;
	width: 100%;
	background-position: 50%;
}
.detailBody {
	margin-left: 20px;
	margin-right: 15px;
	margin-bottom: 20px;
}
.exampleHeader {
	background-color: #C8D1DF;
	padding-left: 10px;
	padding-top: 3px;
	padding-bottom: 3px;
}

.seeAlso {
	margin-top: -13px;
	padding-left: 20px;
}

/*
#header {
	padding: 0;
	margin: 0;
	border: 2px solid
}
*/

body {
	font-family: Tahoma, Verdana, Arial, Helvetica, sans-serif;
	color: #000000;
	background-color:#FFFFFF;
	margin: 0px;
	padding: 0px;
}

body, td, th {
	font-size: 13px;
}

.MainContent {
	margin-left: 20px;
	margin-right: 10px;
	margin-bottom: 10px;
}

code {
	font-family: "Lucida Console", "Courier New", Courier, monospace; 
	font-size: 12px;
}
pre {
	font-family: "Lucida Console", "Courier New", Courier, monospace; 
	font-size: 12px;
}

th	{
	text-align: left;
	font-weight: bold;
	vertical-align: bottom;
}

table {
	background-color: white;
}

table.withBorder {
	border-color: #BBBBBB;
	border-width: 1px;
	border-style: solid;
}

.innertable {
	border-collapse: collapse; /* to eliminate the default table cellspacing=2 */
}

.innertable th {
	border: 1px solid #000000;
	background:#DDDDDD;
	padding: 2px 3px 2px 3px;
}

.innertable td {
	border: 1px solid #000000;
	padding: 2px 3px 2px 3px;
}

.paramSpacer {
	font-size: 5px;
}

/* Custom Classes */
.row0 {
	background-color: #F2F2F2;
}

.row1 {
	background-color: #FFFFFF;
}

.prow0 {
	background-color: #F2F2F2;
}

.prow1 {
	background-color: #FFFFFF;
}

.idxrow {
	padding-top: 5px;
}

.SummaryTableHeader {
    background-color: #CCCCCC;
}

.InheritedTableHeader {
    background-color: #EEEEEE;
}

.PackageTableHeader {
    background-color: #EEEEEE;
}


/* Links */
a:link {
	color: #0000CC;
	text-decoration: none;
}

a:visited {
    color: #0000CC;
	text-decoration: none;
}

a:hover {
	text-decoration: underline;
	color: #0000CC;
}

a:active {
	text-decoration: none;
	color: #CC0000;
}

/* Headings */
h1, h2, h3, h4, h5, h6	{
	font-family: "Trebuchet MS", "Bitstream Vera Sans", verdana, lucida, arial, helvetica, sans-serif;
	font-weight: bold;
	margin-top: 3px;
	margin-bottom: 3px;
	letter-spacing: 1px;
	width: 90%;
}

h1 {
	font-size: 18px;
}

h2 {
	font-size: 16px;
}

h3 {
	font-size: 14px;
}

h4 {
	font-size: 12px;
	color: #666666;
}

h5 {
	font-size: 11px;
}
.copyright {
   margin-top: 30px;
   color: #777777;
   font-size: 10px;
   padding-bottom: 5px;
}
.inheritanceList {
	line-height: 19px;
}
.private {
    color: #999999;
}
.flashonly {
    color: #000000;
}
.flexonly {
    display:none;
    color: #000000;
}
.hide {
	display:none;
}
.feedbackLink {
/*	display:none;  */
}

/* IE */
* html .listing {
   width: 93%;
   padding-left: 6%;
   padding-right: 5px;
   padding-top: 5px;
   padding-bottom: 5px;
   overflow-x: auto;	
   background-color: #F2F2F2;
   margin-bottom: 10px;
   margin-top: 10px;
   font-family: "Lucida Console", "Courier New", Courier, monospace;
   font-size: 12px;
}

/* Firefox, Netscape */
html>body .listing pre
{
   overflow: auto;
   padding-left: 40px;
   padding-right: 5px;
   padding-top: 5px;
   padding-bottom: 5px;
   background-color: #F2F2F2;
   margin-top: 10px;
   margin-bottom: 10px;
   font-family: "Lucida Console", "Courier New", Courier, monospace;
   font-size: 12px;
}   

.listingIcons
{
	padding: 0px;
	margin-top: 10px;
	height: 15px;
}  

.pageTop
{
	height:10px;
}

.hideInheritedSkinState {
	display: none;
}

.showInheritedSkinState {
	display: inline;
}

.hideInheritedSkinPart {
	display: none;
}

.showInheritedSkinPart {
	display: inline;
}

/****** start mobile tweaks ******/
.titleTable tr td.titleTableTopNav a,
	.titleTable tr td.titleTableSubNav a {
	padding-right: 6px;
	padding-left: 6px;
	border-right: solid 1px #333;
}
.titleTable tr td.titleTableTopNav a:last-of-type,
	.titleTable tr td.titleTableSubNav a:last-of-type,
	.titleTable tr td.titleTableTopNav a#framesLink1,
	.titleTable tr td.titleTableTopNav a#noFramesLink11 {
	border-right: none;
}
@media only screen and (max-width: 600px) {
	.titleTable tr {
		display: flex;
		align-items: center;
		flex-wrap: wrap;
	}
	.titleTable tr.titleTableRow2 {
		height: auto;
		background-size: contain;
	}
	.titleTable tr td {
		display: flex;
		align-items: center;
		background-size: contain;
		align-self: stretch;
		min-height: 32px;
		flex-grow: 1;
		padding-left: 10px;
		padding-right: 10px;
	}
	.titleTable tr td.titleTableTitle {
		white-space: normal;
		flex-grow: 2;
	}
	.titleTable tr td.titleTableLogo {
		display: none;
	}
	.titleTable tr td.titleTableSubTitle {
		flex-grow: 2;
	}
	.titleTable tr td.titleTableTopNav {
		justify-content: end;
	}
	.titleTable tr td.titleTableSubNav {
		justify-content: end;
	}
	.MainContent, .summarySection, .detailHeader, .detailBody {
		margin-left: 8px;
		margin-right: 8px;
	}
	.summaryTable {
		overflow-x: auto;
		display: block;
	}
	.detailHeader tr {
		display: flex;
		align-items: baseline;
		flex-wrap: wrap;
	}
	.detailHeaderName {
		word-break: break-word;
		white-space: normal;
	}
	.allIndexTable {
		overflow-x: auto;
		display: block;
	}
	.idxrow,
	.seeAlso a,
	.detailBody code {
		/* word-break: normal; */
		overflow-wrap: anywhere;
		word-break: break-word;
	}
	.titleTable tr td.titleTableSearch {
		display: none;
	}

	/* title bar in a frame */
	.titleTable.titleTableFrame tr {
		flex-wrap: unset;
	}
	.titleTable.titleTableFrame tr td.titleTableTopNav {
		flex-grow: 3;
	}
	.titleTable.titleTableFrame tr td.titleTableTitle {
		flex-grow: 1;
	}
}
@media only screen and (max-width: 450px) {
	.titleTable.titleTableFrame tr td.titleTableTopNav a:not(#noFramesLink1),
		.titleTable.titleTableFrame tr td.titleTableSubNav a {
		display: none !important;
	}
}


table.hideInheritedConstant {
	display: none;
}
table.showInheritedConstant {
	display: block;
}
table.hideInheritedProtectedConstant {
	display: none;
}
table.showInheritedProtectedConstant {
	display: block;
}
table.hideInheritedProperty {
	display: none;
}
table.showInheritedProperty {
	display: block;
}
table.hideInheritedProtectedProperty {
	display: none;
}
table.showInheritedProtectedProperty {
	display: block;
}
table.hideInheritedMethod {
	display: none;
}
table.showInheritedMethod {
	display: block;
}
table.hideInheritedProtectedMethod {
	display: none;
}
table.showInheritedProtectedMethod {
	display: block;
}
table.hideInheritedEvent {
	display: none;
}
table.showInheritedEvent {
	display: block;
}
table.hideInheritedStyle {
	display: none;
}
table.showInheritedStyle {
	display: block;
}
table.hideInheritedEffect {
	display: none;
}
table.showInheritedEffect {
	display: block;
}

================================================
FILE: documentation/api-reference/templates/stylesSummary.xslt
================================================
<?xml version="1.0" encoding="UTF-8"?>
<!--

	ADOBE SYSTEMS INCORPORATED
	Copyright 2008 Adobe Systems Incorporated
	All Rights Reserved.

	NOTICE: Adobe permits you to use, modify, and distribute this file
	in accordance with the terms of the license agreement accompanying it.

-->
<xsl:stylesheet version="2.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
	<xsl:output method="xml" version="1.0" encoding="UTF-8" indent="yes"/>
	<xsl:param name="ditaFileDir" select="''"/>
	<xsl:template match="/">
		<allClasses>
			<xsl:apply-templates select="//apiItemRef">
				<xsl:sort select="@href" order="ascending"/>
			</xsl:apply-templates>
		</allClasses>
	</xsl:template>
	<xsl:template match="apiItemRef">
		<xsl:variable name="ditaFileName">
			<xsl:value-of select="concat($ditaFileDir,@href)"/>
		</xsl:variable>
		<xsl:for-each select="document($ditaFileName)/apiPackage">
			<apiPackage id="{@id}">
				<apiName>
					<xsl:value-of select="./apiName"/>
				</apiName>
				<xsl:apply-templates select="apiClassifier"/>
			</apiPackage>
		</xsl:for-each>
	</xsl:template>
	<xsl:template match="apiClassifier">
		<apiClassifier id="{@id}">
			<apiName>
				<xsl:value-of select="apiName/."/>
			</apiName>
			<xsl:apply-templates select="apiClassifierDetail"/>
			<xsl:apply-templates select="prolog/asMetadata"/>
		</apiClassifier>
	</xsl:template>
	<xsl:template match="apiClassifierDetail">
		<apiClassifierDetail>
			<xsl:apply-templates select="apiClassifierDef"/>
		</apiClassifierDetail>
	</xsl:template>
	<xsl:template match="prolog/asMetadata">
		<prolog>
			<asMetadata>
				<xsl:apply-templates select="styles"/>
			</asMetadata>
		</prolog>
	</xsl:template>
	<xsl:template match="styles">
		<styles>
			<xsl:apply-templates select="node()"/>
		</styles>
	</xsl:template>
	<xsl:template match="apiClassifierDef">
		<apiClassifierDef>
			<xsl:apply-templates select="node()"/>
		</apiClassifierDef>
	</xsl:template>
	<xsl:template match="node()">
		<xsl:copy copy-namespaces="no">
			<xsl:copy-of select="@*"/>
			<xsl:apply-templates select="node()"/>
		</xsl:copy>
	</xsl:template>
</xsl:stylesheet>


================================================
FILE: documentation/api-reference/templates/title-bar.html
================================================
<html>
	<head>
		<title>ActionScript 3.0 Language Reference</title>
		<meta name="viewport" content="width=device-width, initial-scale=1.0"/>
		<link rel="stylesheet" href="style.css" type="text/css" media="screen" />
		<link rel="stylesheet" href="print.css" type="text/css" media="print" />
		<script language="javascript" type="text/javascript" src="asdoc.js"></script>
	</head>
	<body>
		<a name="top"></a>
		<table class="titleTable titleTableFrame" cellpadding="0" cellspacing="0">
			<tbody>
				<tr>
					<td class="titleTableTitle" align="left">ActionScript&#xA0;3.0&#xA0;Language&#xA0;and&#xA0;Components&#xA0;Reference</td>
					<td class="titleTableTopNav" align="right">
						<a target="classFrame" href="package-summary.html" onclick="loadClassListFrame('all-classes.html')">All Packages</a>
						<a target="classFrame" href="class-summary.html" onclick="loadClassListFrame('all-classes.html')">All Classes</a>
						<a target="classFrame" href="all-index-A.html" onclick="loadClassListFrame('index-list.html')">Index</a>
						<a id="noFramesLink1" href="" onclick="top.location=top.classFrame.location">No Frames</a>
					</td>
					<td class="titleTableLogo" align="right" rowspan="3">
						<picture>
							<img src="images/logo.jpg" srcset="images/logo@2x.jpg 2x" class="logoImage" title="Feathers Logo" alt="Feathers Logo" />
						</picture>
					</td>
				</tr>
				<tr class="titleTableRow2">
					<td class="titleTableSubTitle" id="subTitle" align="left">&#xA0;</td>
					<td class="titleTableSubNav" id="subNav" align="right">
					<a id="propertiesLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('propertySummary');" style="display:none">Properties</a>
					<span id="propertiesBar" style="display:none"> | </span>
					<a id="packagePropertiesLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('propertySummary');" style="display:none">Properties</a>
					<span id="packagePropertiesBar" style="display:none"> | </span>
					<a id="constructorLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('constructorSummary');" style="display:none">Constructor</a>
					<span id="constructorBar" style="display:none"> | </span>
					<a id="methodsLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('methodSummary');" style="display:none">Methods</a>
					<span id="methodsBar" style="display:none"> | </span>
					<a id="packageFunctionsLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('methodSummary');" style="display:none">Functions</a>
					<span id="packageFunctionsBar" style="display:none"> | </span>
					<a id="eventsLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('eventSummary');" style="display:none">Events</a>
					<span id="eventsBar" style="display:none"> | </span>
					<a id="stylesLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('styleSummary');" style="display:none">Styles</a>
					<span id="stylesBar" style="display:none"> | </span>
					<a id="SkinPartLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('SkinPartSummary');" style="display:none">Skin Parts</a>
					<span id="SkinPartBar" style="display:none"> | </span>
					<a id="SkinStateLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('SkinStateSummary');" style="display:none">Skin States</a>
					<span id="SkinStateBar" style="display:none"> | </span>
					<a id="effectsLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('effectSummary');" style="display:none">Effects</a>
					<span id="effectsBar" style="display:none"> | </span>
					<a id="constantsLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('constantSummary');" style="display:none">Constants</a>
					<span id="constantsBar" style="display:none"> | </span>
					<a id="packageConstantsLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('constantSummary');" style="display:none">Constants</a>
					<span id="packageConstantsBar" style="display:none"> | </span>
					<a id="interfacesLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('interfaceSummary');" style="display:none">Interfaces</a>
					<span id="interfacesBar" style="display:none"> | </span>
					<a id="classesLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('classSummary');" style="display:none">Classes</a>
					<span id="classesBar" style="display:none"> | </span>
					<a id="packageUseLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('package-use.html');" style="display:none">Use</a>
					<span id="packageUseBar" style="display:none"> | </span>
					<a id="examplesLink" href="#top" onclick="javascript:titleBar_gotoClassFrameAnchor('includeExamplesSummary');" style="display:none">Examples</a>
					</td>
				</tr>
				<tr class="titleTableRow3">
					<td colspan="3">&#xA0;</td>
				</tr>
			</tbody>
		</table>
	</body>
</html>



================================================
FILE: examples/ComponentsExplorer/README.md
================================================
# Feathers Components Explorer

A little bit of everything in [Feathers](http://feathersui.com/), presented as a mobile app. Includes screens for each component, with configurable options.

## Requirements

In addition to Starling Framework and Feathers, this example project requires the `MetalWorksMobileTheme` example theme. You can find the SWC file for this theme at the following location in the Feathers release build:

	themes/MetalWorksMobileTheme/swc/MetalWorksMobileTheme.swc

## Web Demo

View the [Components Explorer](http://feathersui.com/examples/components-explorer/) in your browser.

================================================
FILE: examples/ComponentsExplorer/assets/images/icons-readme.txt
================================================
Icons by Glyphish - glyphish.com

================================================
FILE: examples/ComponentsExplorer/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
theme.root = ${basedir}/../../themes/MetalWorksMobileTheme/source
output.path = ${basedir}/output
icon.path = ${basedir}/../shared-assets/icons
launch.image.path = ${basedir}/../shared-assets/launch-images-windowed
advanced.telemetry=false

swf.version = 30

================================================
FILE: examples/ComponentsExplorer/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="components-explorer" default="build" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<target name="build" depends="build-web,build-android,build-ios"/>

	<target name="prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="build-web" depends="prepare">
		<echo message="Building ComponentsExplorerWeb.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-advanced-telemetry=true"/>
			<arg value="-frame=two,feathers.examples.componentsExplorer.Main"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/ComponentsExplorerWeb.as"/>
			<arg value="-output=${output.path}/ComponentsExplorerWeb.swf"/>
		</java>
	</target>
	<target name="build-air-swf" depends="prepare">
		<echo message="Building ComponentsExplorer.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-advanced-telemetry=${advanced.telemetry}"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/ComponentsExplorer.as"/>
			<arg value="-output=${output.path}/ComponentsExplorer.swf"/>
		</java>
	</target>
	<target name="-check-ios-properties">
		<fail unless="ios.provision.path"/>
		<fail unless="ios.certificate.path"/>
		<fail unless="ios.certificate.password"/>
	</target>
	<target name="build-ios" depends="-check-ios-properties,build-air-swf">
		<echo message="Packaging ComponentsExplorer.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="ipa-app-store"/>
			<!-- uncomment for actionscript sampling with scout on ios -->
			<!--<arg value="-sampler"/>-->
			<arg value="-provisioning-profile"/>
			<arg value="${ios.provision.path}"/>
			<arg value="-keystore"/>
			<arg value="${ios.certificate.path}"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-storepass"/>
			<arg value="${ios.certificate.password}"/>
			<arg value="${output.path}/ComponentsExplorer.ipa"/>
			<arg value="source/ComponentsExplorer-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${launch.image.path}"/>
			<arg value="Default~iphone.png"/>							<!-- iphone 3gs -->
			<arg value="Default@2x~iphone.png"/>						<!-- iphone 4/4s -->
			<arg value="Default-568h@2x~iphone.png"/>					<!-- iphone 5/5c/5s -->
			<arg value="Default-375w-667h@2x~iphone.png"/>				<!-- iphone 6/7/8 -->
			<arg value="Default-812h@3x~iphone.png"/>					<!-- iphone x (portrait) -->
			<arg value="Default-Landscape-812h@3x~iphone.png"/>			<!-- iphone x (landscape) -->
			<arg value="Default-414w-736h@3x~iphone.png"/>				<!-- iphone 6/7/8 plus (portrait) -->
			<arg value="Default-Landscape-414w-736h@3x~iphone.png"/>	<!-- iphone 6/7/8 plus (landscape) -->
			<arg value="Default-Portrait~ipad.png"/>					<!-- ipad 1/2 (portrait) -->
			<arg value="Default-PortraitUpsideDown~ipad.png"/>			<!-- ipad 1/2 (portrait upside down) -->
			<arg value="Default-Landscape~ipad.png"/>					<!-- ipad 1/2 (landscape left) -->
			<arg value="Default-LandscapeRight~ipad.png"/>				<!-- ipad 1/2 (landscape right) -->
			<arg value="Default-Portrait@2x~ipad.png"/>					<!-- ipad 3/air (portrait) -->
			<arg value="Default-LandscapeLeft@2x~ipad.png"/>			<!-- ipad 3/air (landscape left) -->
			<arg value="Default-LandscapeRight@2x~ipad.png"/>			<!-- ipad 3/air (landscape right) -->
			<arg value="Default-Portrait@2x.png"/>						<!-- ipad pro (portrait) -->
			<arg value="Default-Landscape@2x.png"/>						<!-- ipad pro (landscape) -->
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="ComponentsExplorer.swf"/>
		</java>
	</target>
	<target name="-check-android-properties">
		<fail unless="android.certificate.path"/>
		<fail unless="android.certificate.password"/>
	</target>
	<target name="build-android" depends="-check-android-properties,build-air-swf">
		<echo message="Packaging ComponentsExplorer.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="apk-captive-runtime"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-keystore"/>
			<arg value="${android.certificate.path}"/>
			<arg value="-storepass"/>
			<arg value="${android.certificate.password}"/>
			<arg value="${output.path}/ComponentsExplorer.apk"/>
			<arg value="source/ComponentsExplorer-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="ComponentsExplorer.swf"/>
		</java>
	</target>
	<target name="install-android">
		<echo message="Installing ComponentsExplorer.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.ComponentsExplorer"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-package"/>
			<arg value="${output.path}/ComponentsExplorer.apk"/>
		</java>
	</target>
	<target name="install-ios">
		<echo message="Installing ComponentsExplorer.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.ComponentsExplorer"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-package"/>
			<arg value="${output.path}/ComponentsExplorer.ipa"/>
		</java>
	</target>
</project>

================================================
FILE: examples/ComponentsExplorer/source/ComponentsExplorer-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.examples.ComponentsExplorer</id>
	<filename>Components</filename>
	<name>Components</name>
	<versionNumber>4.2.0</versionNumber>
	<description>Components Explorer example application built with Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>ComponentsExplorer.swf</content>
		<autoOrients>true</autoOrients>
		<fullScreen>false</fullScreen>
		<visible>true</visible>
		<renderMode>direct</renderMode>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>

	<icon>
		<image29x29>icon29.png</image29x29>
		<image48x48>icon48.png</image48x48>
		<image50x50>icon50.png</image50x50>
		<image57x57>icon57.png</image57x57>
		<image58x58>icon58.png</image58x58>
		<image72x72>icon72.png</image72x72>
		<image87x87>icon87.png</image87x87>
		<image96x96>icon96.png</image96x96>
		<image100x100>icon100.png</image100x100>
		<image114x114>icon114.png</image114x114>
		<image128x128>icon128.png</image128x128>
		<image144x144>icon144.png</image144x144>
		<image180x180>icon180.png</image180x180>
	</icon>
	<android>
		<colorDepth>16bit</colorDepth>
		<manifestAdditions><![CDATA[
			<manifest android:installLocation="auto">
			    <uses-permission android:name="android.permission.INTERNET"/>
			</manifest>
		]]></manifestAdditions>
	</android>
	<iPhone>
		<InfoAdditions>
		<![CDATA[
			<key>UIDeviceFamily</key> 
			<array> 
				<string>1</string>
				<string>2</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<true/>
			<key>UIStatusBarStyle</key>
			<string>UIStatusBarStyleLightContent</string>
			<key>NSAppTransportSecurity</key>
			<dict>
				<key>NSAllowsArbitraryLoads</key>
				<true/>
			</dict>
		]]> 
		</InfoAdditions>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</iPhone>
</application>

================================================
FILE: examples/ComponentsExplorer/source/ComponentsExplorer.as
================================================
package
{
	import feathers.examples.componentsExplorer.Main;
	import feathers.utils.ScreenDensityScaleFactorManager;

	import flash.display.Loader;
	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageOrientation;
	import flash.display.StageScaleMode;
	import flash.display3D.Context3DProfile;
	import flash.display3D.Context3DRenderMode;
	import flash.events.Event;
	import flash.filesystem.File;
	import flash.filesystem.FileMode;
	import flash.filesystem.FileStream;
	import flash.system.Capabilities;
	import flash.utils.ByteArray;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class ComponentsExplorer extends Sprite
	{
		public function ComponentsExplorer()
		{
			if(this.stage)
			{
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
				this.stage.align = StageAlign.TOP_LEFT;
			}
			this.mouseEnabled = this.mouseChildren = false;
			this.showLaunchImage();
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;
		private var _scaler:ScreenDensityScaleFactorManager;
		private var _launchImage:Loader;
		private var _savedAutoOrients:Boolean;

		/**
		 * On iOS, add the native launch image to the classic display list to
		 * avoid displaying only the stage background color between when the
		 * AIR app finishes launching and Starling starts rendering.
		 * 
		 * Launch image names: https://forums.adobe.com/message/9986239#9986239
		 */
		private function showLaunchImage():void
		{
			var filePath:String = null;
			var isPortraitOnly:Boolean = false;
			if(Capabilities.manufacturer.indexOf("iOS") >= 0)
			{
				var isPortraitUpsideDown:Boolean = this.stage.orientation == StageOrientation.UPSIDE_DOWN;
				var isPortrait:Boolean = this.stage.orientation == StageOrientation.DEFAULT || isPortraitUpsideDown;
				var isLandscapeRight:Boolean = this.stage.orientation == StageOrientation.ROTATED_RIGHT;
				if(Capabilities.screenResolutionX == 1242 && Capabilities.screenResolutionY == 2208)
				{
					//iphone 6/7/8 plus
					filePath = isPortrait ? "Default-414w-736h@3x~iphone.png" : "Default-Landscape-414w-736h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 1125 && Capabilities.screenResolutionY == 2436)
				{
					//iphone x
					filePath = isPortrait ? "Default-812h@3x~iphone.png" : "Default-Landscape-812h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 2048 && Capabilities.screenResolutionY == 2732)
				{
					//ipad pro
					filePath = isPortrait ? "Default-Portrait@2x.png" : "Default-Landscape@2x.png";
				}
				else if(Capabilities.screenResolutionX == 1536 && Capabilities.screenResolutionY == 2048)
				{
					//ipad 3/air
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait@2x~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown@2x~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight@2x~ipad.png";
					}
					else
					{
						filePath = "Default-LandscapeLeft@2x~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 768 && Capabilities.screenResolutionY == 1024)
				{
					//ipad 1/2
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight~ipad.png";
					}
					else
					{
						filePath = "Default-Landscape~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 750)
				{
					//iphone 6/7/8
					isPortraitOnly = true;
					filePath = "Default-375w-667h@2x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 640)
				{
					isPortraitOnly = true;
					if(Capabilities.screenResolutionY == 1136)
					{
						//iphone 5/5c/5s
						filePath = "Default-568h@2x~iphone.png";
					}
					else
					{
						//iphone 4/4s
						filePath = "Default@2x~iphone.png";
					}
				}
				else if(Capabilities.screenResolutionX == 320)
				{
					//iphone 3gs
					isPortraitOnly = true;
					filePath = "Default~iphone.png";
				}
			}

			if(filePath)
			{
				var file:File = File.applicationDirectory.resolvePath(filePath);
				if(file.exists)
				{
					var bytes:ByteArray = new ByteArray();
					var stream:FileStream = new FileStream();
					stream.open(file, FileMode.READ);
					stream.readBytes(bytes, 0, stream.bytesAvailable);
					stream.close();
					this._launchImage = new Loader();
					this._launchImage.loadBytes(bytes);
					this.addChild(this._launchImage);
					this._savedAutoOrients = this.stage.autoOrients;
					this.stage.autoOrients = false;
					if(isPortraitOnly)
					{
						this.stage.setOrientation(StageOrientation.DEFAULT);
					}
				}
			}
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(Main, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE);
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.start();
			if(this._launchImage)
			{
				this._starling.addEventListener("rootCreated", starling_rootCreatedHandler);
			}
			this._scaler = new ScreenDensityScaleFactorManager(this._starling);
			this.stage.addEventListener(Event.DEACTIVATE, stage_deactivateHandler, false, 0, true);
		}

		private function starling_rootCreatedHandler(event:Object):void
		{
			if(this._launchImage)
			{
				this.removeChild(this._launchImage);
				this._launchImage.unloadAndStop(true);
				this._launchImage = null;
				this.stage.autoOrients = this._savedAutoOrients;
			}
		}

		private function stage_deactivateHandler(event:Event):void
		{
			this._starling.stop(true);
			this.stage.addEventListener(Event.ACTIVATE, stage_activateHandler, false, 0, true);
		}

		private function stage_activateHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.ACTIVATE, stage_activateHandler);
			this._starling.start();
		}

	}
}

================================================
FILE: examples/ComponentsExplorer/source/ComponentsExplorerWeb.as
================================================
package
{
	import feathers.system.DeviceCapabilities;

	import flash.display.MovieClip;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.events.Event;
	import flash.geom.Rectangle;
	import flash.ui.ContextMenu;
	import flash.utils.getDefinitionByName;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class ComponentsExplorerWeb extends MovieClip
	{
		public function ComponentsExplorerWeb()
		{
			var menu:ContextMenu = new ContextMenu();
			menu.hideBuiltInItems();
			this.contextMenu = menu;
			
			if(this.stage)
			{
				this.stage.align = StageAlign.TOP_LEFT;
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
			}
			
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}
		
		private var _starling:Starling;
		
		private function start():void
		{
			this.gotoAndStop(2);
			this.graphics.clear();
			
			//simulating iPhone Retina
			DeviceCapabilities.dpi = 326;
			
			Starling.multitouchEnabled = true;
			var MainType:Class = getDefinitionByName("feathers.examples.componentsExplorer.Main") as Class;
			this._starling = new Starling(MainType, this.stage, new Rectangle(0, 0, 960, 640));
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.stage.stageWidth = 480;
			this._starling.stage.stageHeight = 320;
			this._starling.start();
		}
		
		private function loaderInfo_completeHandler(event:Event):void
		{
			this.start();
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/Main.as
================================================
package feathers.examples.componentsExplorer
{
	import feathers.controls.Drawers;
	import feathers.controls.StackScreenNavigator;
	import feathers.controls.StackScreenNavigatorItem;
	import feathers.examples.componentsExplorer.data.DataGridSettings;
	import feathers.examples.componentsExplorer.data.DateTimeSpinnerSettings;
	import feathers.examples.componentsExplorer.data.EmbeddedAssets;
	import feathers.examples.componentsExplorer.data.GroupedListSettings;
	import feathers.examples.componentsExplorer.data.ItemRendererSettings;
	import feathers.examples.componentsExplorer.data.ListSettings;
	import feathers.examples.componentsExplorer.data.NumericStepperSettings;
	import feathers.examples.componentsExplorer.data.SliderSettings;
	import feathers.examples.componentsExplorer.screens.AlertScreen;
	import feathers.examples.componentsExplorer.screens.AutoCompleteScreen;
	import feathers.examples.componentsExplorer.screens.ButtonGroupScreen;
	import feathers.examples.componentsExplorer.screens.ButtonScreen;
	import feathers.examples.componentsExplorer.screens.CalloutScreen;
	import feathers.examples.componentsExplorer.screens.CheckScreen;
	import feathers.examples.componentsExplorer.screens.DataGridScreen;
	import feathers.examples.componentsExplorer.screens.DataGridSettingsScreen;
	import feathers.examples.componentsExplorer.screens.DateTimeSpinnerScreen;
	import feathers.examples.componentsExplorer.screens.DateTimeSpinnerSettingsScreen;
	import feathers.examples.componentsExplorer.screens.GroupedListScreen;
	import feathers.examples.componentsExplorer.screens.GroupedListSettingsScreen;
	import feathers.examples.componentsExplorer.screens.ItemRendererScreen;
	import feathers.examples.componentsExplorer.screens.ItemRendererSettingsScreen;
	import feathers.examples.componentsExplorer.screens.LabelScreen;
	import feathers.examples.componentsExplorer.screens.ListScreen;
	import feathers.examples.componentsExplorer.screens.ListSettingsScreen;
	import feathers.examples.componentsExplorer.screens.MainMenuScreen;
	import feathers.examples.componentsExplorer.screens.NumericStepperScreen;
	import feathers.examples.componentsExplorer.screens.NumericStepperSettingsScreen;
	import feathers.examples.componentsExplorer.screens.PageIndicatorScreen;
	import feathers.examples.componentsExplorer.screens.PanelComponentScreen;
	import feathers.examples.componentsExplorer.screens.PickerListScreen;
	import feathers.examples.componentsExplorer.screens.ProgressBarScreen;
	import feathers.examples.componentsExplorer.screens.RadioScreen;
	import feathers.examples.componentsExplorer.screens.ScrollTextScreen;
	import feathers.examples.componentsExplorer.screens.SliderScreen;
	import feathers.examples.componentsExplorer.screens.SliderSettingsScreen;
	import feathers.examples.componentsExplorer.screens.SpinnerListScreen;
	import feathers.examples.componentsExplorer.screens.TabBarScreen;
	import feathers.examples.componentsExplorer.screens.TextCalloutScreen;
	import feathers.examples.componentsExplorer.screens.TextInputScreen;
	import feathers.examples.componentsExplorer.screens.ToggleSwitchScreen;
	import feathers.examples.componentsExplorer.screens.TreeScreen;
	import feathers.examples.componentsExplorer.screens.WebViewScreen;
	import feathers.layout.Orientation;
	import feathers.motion.Cover;
	import feathers.motion.Reveal;
	import feathers.motion.Slide;
	import feathers.system.DeviceCapabilities;
	import feathers.themes.MetalWorksMobileTheme;

	import flash.system.Capabilities;

	import starling.core.Starling;
	import starling.events.Event;
	import feathers.examples.componentsExplorer.screens.ToastScreen;

	public class Main extends Drawers
	{
		public function Main()
		{
			//set up the theme right away!
			new MetalWorksMobileTheme();
			super();
		}

		private var _navigator:StackScreenNavigator;
		private var _menu:MainMenuScreen;
		
		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			EmbeddedAssets.initialize();

			this._navigator = new StackScreenNavigator();
			this.content = this._navigator;

			var alertItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(AlertScreen);
			alertItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.ALERT, alertItem);

			var autoCompleteItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(AutoCompleteScreen);
			autoCompleteItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.AUTO_COMPLETE, autoCompleteItem);

			var buttonItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(ButtonScreen);
			buttonItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.BUTTON, buttonItem);

			var buttonGroupItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(ButtonGroupScreen);
			buttonGroupItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.BUTTON_GROUP, buttonGroupItem);

			var calloutItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(CalloutScreen);
			calloutItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.CALLOUT, calloutItem);

			var checkItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(CheckScreen);
			checkItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.CHECK, checkItem);

			var dataGridSettings:DataGridSettings = new DataGridSettings();
			var dataGridItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(DataGridScreen);
			dataGridItem.setScreenIDForPushEvent(DataGridScreen.SHOW_SETTINGS, ScreenID.DATA_GRID_SETTINGS);
			dataGridItem.addPopEvent(Event.COMPLETE);
			dataGridItem.properties.settings = dataGridSettings;
			this._navigator.addScreen(ScreenID.DATA_GRID, dataGridItem);

			var dataGridSettingsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(DataGridSettingsScreen);
			dataGridSettingsItem.addPopEvent(Event.COMPLETE);
			dataGridSettingsItem.properties.settings = dataGridSettings;
			//custom push and pop transitions for this settings screen
			dataGridSettingsItem.pushTransition = Cover.createCoverUpTransition();
			dataGridSettingsItem.popTransition = Reveal.createRevealDownTransition();
			this._navigator.addScreen(ScreenID.DATA_GRID_SETTINGS, dataGridSettingsItem);

			var dateTimeSpinnerSettings:DateTimeSpinnerSettings = new DateTimeSpinnerSettings();
			var dateTimeSpinnerItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(DateTimeSpinnerScreen);
			dateTimeSpinnerItem.setScreenIDForPushEvent(DateTimeSpinnerScreen.SHOW_SETTINGS, ScreenID.DATE_TIME_SPINNER_SETTINGS);
			dateTimeSpinnerItem.addPopEvent(Event.COMPLETE);
			dateTimeSpinnerItem.properties.settings = dateTimeSpinnerSettings;
			this._navigator.addScreen(ScreenID.DATE_TIME_SPINNER, dateTimeSpinnerItem);

			var dateTimeSpinnerSettingsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(DateTimeSpinnerSettingsScreen);
			dateTimeSpinnerSettingsItem.addPopEvent(Event.COMPLETE);
			dateTimeSpinnerSettingsItem.properties.settings = dateTimeSpinnerSettings;
			//custom push and pop transitions for this settings screen
			dateTimeSpinnerSettingsItem.pushTransition = Cover.createCoverUpTransition();
			dateTimeSpinnerSettingsItem.popTransition = Reveal.createRevealDownTransition();
			this._navigator.addScreen(ScreenID.DATE_TIME_SPINNER_SETTINGS, dateTimeSpinnerSettingsItem);

			var groupedListSettings:GroupedListSettings = new GroupedListSettings();
			var groupedListItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(GroupedListScreen);
			groupedListItem.setScreenIDForPushEvent(GroupedListScreen.SHOW_SETTINGS, ScreenID.GROUPED_LIST_SETTINGS);
			groupedListItem.addPopEvent(Event.COMPLETE);
			groupedListItem.properties.settings = groupedListSettings;
			this._navigator.addScreen(ScreenID.GROUPED_LIST, groupedListItem);

			var groupedListSettingsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(GroupedListSettingsScreen);
			groupedListSettingsItem.addPopEvent(Event.COMPLETE);
			groupedListSettingsItem.properties.settings = groupedListSettings;
			//custom push and pop transitions for this settings screen
			groupedListSettingsItem.pushTransition = Cover.createCoverUpTransition();
			groupedListSettingsItem.popTransition = Reveal.createRevealDownTransition();
			this._navigator.addScreen(ScreenID.GROUPED_LIST_SETTINGS, groupedListSettingsItem);

			var itemRendererSettings:ItemRendererSettings = new ItemRendererSettings();
			var itemRendererItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(ItemRendererScreen);
			itemRendererItem.setScreenIDForPushEvent(ItemRendererScreen.SHOW_SETTINGS, ScreenID.ITEM_RENDERER_SETTINGS);
			itemRendererItem.addPopEvent(Event.COMPLETE);
			itemRendererItem.properties.settings = itemRendererSettings;
			this._navigator.addScreen(ScreenID.ITEM_RENDERER, itemRendererItem);

			var itemRendererSettingsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(ItemRendererSettingsScreen);
			itemRendererSettingsItem.addPopEvent(Event.COMPLETE);
			itemRendererSettingsItem.properties.settings = itemRendererSettings;
			//custom push and pop transitions for this settings screen
			itemRendererSettingsItem.pushTransition = Cover.createCoverUpTransition();
			itemRendererSettingsItem.popTransition = Reveal.createRevealDownTransition();
			this._navigator.addScreen(ScreenID.ITEM_RENDERER_SETTINGS, itemRendererSettingsItem);

			var labelItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(LabelScreen);
			labelItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.LABEL, labelItem);

			var listSettings:ListSettings = new ListSettings();
			var listItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(ListScreen);
			listItem.setScreenIDForPushEvent(ListScreen.SHOW_SETTINGS, ScreenID.LIST_SETTINGS);
			listItem.addPopEvent(Event.COMPLETE);
			listItem.properties.settings = listSettings;
			this._navigator.addScreen(ScreenID.LIST, listItem);

			var listSettingsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(ListSettingsScreen);
			listSettingsItem.addPopEvent(Event.COMPLETE);
			listSettingsItem.properties.settings = listSettings;
			//custom push and pop transitions for this settings screen
			listSettingsItem.pushTransition = Cover.createCoverUpTransition();
			listSettingsItem.popTransition = Reveal.createRevealDownTransition();
			this._navigator.addScreen(ScreenID.LIST_SETTINGS, listSettingsItem);

			var numericStepperSettings:NumericStepperSettings = new NumericStepperSettings();
			var numericStepperItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(NumericStepperScreen);
			numericStepperItem.setScreenIDForPushEvent(NumericStepperScreen.SHOW_SETTINGS, ScreenID.NUMERIC_STEPPER_SETTINGS);
			numericStepperItem.addPopEvent(Event.COMPLETE);
			numericStepperItem.properties.settings = numericStepperSettings;
			this._navigator.addScreen(ScreenID.NUMERIC_STEPPER, numericStepperItem);

			var panelItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(PanelComponentScreen);
			panelItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.PANEL, panelItem);

			var numericStepperSettingsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(NumericStepperSettingsScreen);
			numericStepperSettingsItem.addPopEvent(Event.COMPLETE);
			numericStepperSettingsItem.properties.settings = numericStepperSettings;
			//custom push and pop transitions for this settings screen
			numericStepperSettingsItem.pushTransition = Cover.createCoverUpTransition();
			numericStepperSettingsItem.popTransition = Reveal.createRevealDownTransition();
			this._navigator.addScreen(ScreenID.NUMERIC_STEPPER_SETTINGS, numericStepperSettingsItem);

			var pageIndicatorItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(PageIndicatorScreen);
			pageIndicatorItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.PAGE_INDICATOR, pageIndicatorItem);

			var pickerListItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(PickerListScreen);
			pickerListItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.PICKER_LIST, pickerListItem);

			var progressBarItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(ProgressBarScreen);
			progressBarItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.PROGRESS_BAR, progressBarItem);

			var radioItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(RadioScreen);
			radioItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.RADIO, radioItem);

			var scrollTextItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(ScrollTextScreen);
			scrollTextItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.SCROLL_TEXT, scrollTextItem);

			var sliderSettings:SliderSettings = new SliderSettings();
			var sliderItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(SliderScreen);
			sliderItem.setScreenIDForPushEvent(SliderScreen.SHOW_SETTINGS, ScreenID.SLIDER_SETTINGS);
			sliderItem.addPopEvent(Event.COMPLETE);
			sliderItem.properties.settings = sliderSettings;
			this._navigator.addScreen(ScreenID.SLIDER, sliderItem);

			var sliderSettingsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(SliderSettingsScreen);
			sliderSettingsItem.addPopEvent(Event.COMPLETE);
			sliderSettingsItem.properties.settings = sliderSettings;
			//custom push and pop transitions for this settings screen
			sliderSettingsItem.pushTransition = Cover.createCoverUpTransition();
			sliderSettingsItem.popTransition = Reveal.createRevealDownTransition();
			this._navigator.addScreen(ScreenID.SLIDER_SETTINGS, sliderSettingsItem);

			var spinnerListItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(SpinnerListScreen);
			spinnerListItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.SPINNER_LIST, spinnerListItem);

			var tabBarItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(TabBarScreen);
			tabBarItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.TAB_BAR, tabBarItem);

			var textCalloutItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(TextCalloutScreen);
			textCalloutItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.TEXT_CALLOUT, textCalloutItem);

			var textInputItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(TextInputScreen);
			textInputItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.TEXT_INPUT, textInputItem);

			var toastItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(ToastScreen);
			toastItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.TOAST, toastItem);

			var togglesItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(ToggleSwitchScreen);
			togglesItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.TOGGLES, togglesItem);

			var treeItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(TreeScreen);
			treeItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ScreenID.TREE, treeItem);

			if(Capabilities.playerType == "Desktop") //this means AIR, even for mobile
			{
				var webViewItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(WebViewScreen);
				webViewItem.addPopEvent(Event.COMPLETE);
				this._navigator.addScreen(ScreenID.WEB_VIEW, webViewItem);
			}

			if(DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				//we don't want the screens bleeding outside the navigator's
				//bounds on top of a drawer when a transition is active, so
				//enable clipping.
				this._navigator.clipContent = true;
				this._menu = new MainMenuScreen();
				this._menu.addEventListener(Event.CHANGE, mainMenu_tabletChangeHandler);
				this._menu.height = 200;
				this.leftDrawer = this._menu;
				this.leftDrawerDockMode = Orientation.BOTH;
			}
			else
			{
				var mainMenuItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(MainMenuScreen);
				mainMenuItem.setFunctionForPushEvent(Event.CHANGE, mainMenu_phoneChangeHandler);
				this._navigator.addScreen(ScreenID.MAIN_MENU, mainMenuItem);
				this._navigator.rootScreenID = ScreenID.MAIN_MENU;
			}

			this._navigator.pushTransition = Slide.createSlideLeftTransition();
			this._navigator.popTransition = Slide.createSlideRightTransition();
		}

		private function mainMenu_phoneChangeHandler(event:Event):void
		{
			//when MainMenuScreen dispatches Event.CHANGE, its selectedScreenID
			//property has been updated. use that to show the correct screen.
			var screen:MainMenuScreen = MainMenuScreen(event.currentTarget);
			this._navigator.pushScreen(screen.selectedScreenID, event.data);
			//pass the data from the event to save it for when we pop back.
		}

		private function mainMenu_tabletChangeHandler(event:Event):void
		{
			//since this navigation is triggered by an external menu, we don't
			//want to push a new screen onto the stack. we want to start fresh.
			var screen:MainMenuScreen = MainMenuScreen(event.currentTarget);
			this._navigator.rootScreenID = screen.selectedScreenID;
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/ScreenID.as
================================================
package feathers.examples.componentsExplorer
{
	public class ScreenID
	{
		public static const MAIN_MENU:String = "mainMenu";
		public static const ALERT:String = "alert";
		public static const AUTO_COMPLETE:String = "autoComplete";
		public static const BUTTON:String = "button";
		public static const BUTTON_GROUP:String = "buttonGroup";
		public static const CALLOUT:String = "callout";
		public static const CHECK:String = "check";
		public static const DATA_GRID:String = "dataGrid";
		public static const DATA_GRID_SETTINGS:String = "dataGridSettings";
		public static const DATE_TIME_SPINNER:String = "dateTimeSpinner";
		public static const DATE_TIME_SPINNER_SETTINGS:String = "dateTimeSpinnerSettings";
		public static const GROUPED_LIST:String = "groupedList";
		public static const GROUPED_LIST_SETTINGS:String = "groupedListSettings";
		public static const ITEM_RENDERER:String = "itemRenderer";
		public static const ITEM_RENDERER_SETTINGS:String = "itemRendererSettings";
		public static const LABEL:String = "label";
		public static const LIST:String = "list";
		public static const LIST_SETTINGS:String = "listSettings";
		public static const NUMERIC_STEPPER:String = "numericStepper";
		public static const NUMERIC_STEPPER_SETTINGS:String = "numericStepperSettings";
		public static const PAGE_INDICATOR:String = "pageIndicator";
		public static const PANEL:String = "panel";
		public static const PICKER_LIST:String = "pickerList";
		public static const PROGRESS_BAR:String = "progressBar";
		public static const RADIO:String = "radio";
		public static const SCROLL_TEXT:String = "scrollText";
		public static const SLIDER:String = "slider";
		public static const SPINNER_LIST:String = "spinnerList";
		public static const SLIDER_SETTINGS:String = "sliderSettings";
		public static const TAB_BAR:String = "tabBar";
		public static const TEXT_CALLOUT:String = "textCallout";
		public static const TEXT_INPUT:String = "textInput";
		public static const TOAST:String = "toast";
		public static const TOGGLES:String = "toggles";
		public static const TREE:String = "tree";
		public static const WEB_VIEW:String = "webView";
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/data/DataGridSettings.as
================================================
package feathers.examples.componentsExplorer.data
{
	import feathers.controls.ItemRendererLayoutOrder;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.RelativePosition;
	import feathers.layout.VerticalAlign;

	public class DataGridSettings
	{
		public function DataGridSettings()
		{
		}

		public var reorderColumns:Boolean = false;
		public var sortableColumns:Boolean = false;
		public var resizableColumns:Boolean = false;
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/data/DateTimeSpinnerSettings.as
================================================
package feathers.examples.componentsExplorer.data
{
	import feathers.controls.DateTimeMode;

	public class DateTimeSpinnerSettings
	{
		public function DateTimeSpinnerSettings()
		{
		}
		
		public var editingMode:String = DateTimeMode.DATE_AND_TIME;
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/data/EmbeddedAssets.as
================================================
package feathers.examples.componentsExplorer.data
{
	import starling.textures.Texture;

	public class EmbeddedAssets
	{
		[Embed(source="/../assets/images/skull.png")]
		private static const SKULL_ICON_DARK_EMBEDDED:Class;

		[Embed(source="/../assets/images/skull-white.png")]
		private static const SKULL_ICON_LIGHT_EMBEDDED:Class;

		public static var SKULL_ICON_DARK:Texture;

		public static var SKULL_ICON_LIGHT:Texture;
		
		public static function initialize():void
		{
			//we can't create these textures until Starling is ready
			SKULL_ICON_DARK = Texture.fromEmbeddedAsset(SKULL_ICON_DARK_EMBEDDED, false, false, 2);
			SKULL_ICON_LIGHT = Texture.fromEmbeddedAsset(SKULL_ICON_LIGHT_EMBEDDED, false, false, 2);
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/data/GroupedListSettings.as
================================================
package feathers.examples.componentsExplorer.data
{
	public class GroupedListSettings
	{
		public static const STYLE_NORMAL:String = "normal";
		public static const STYLE_INSET:String = "inset";

		public function GroupedListSettings()
		{
		}

		public var isSelectable:Boolean = true;
		public var hasElasticEdges:Boolean = true;
		public var style:String = STYLE_NORMAL;
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/data/ItemRendererSettings.as
================================================
package feathers.examples.componentsExplorer.data
{
	import feathers.controls.ItemRendererLayoutOrder;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.RelativePosition;
	import feathers.layout.VerticalAlign;

	public class ItemRendererSettings
	{
		public static const ICON_ACCESSORY_TYPE_DISPLAY_OBJECT:String = "Display Object";
		public static const ICON_ACCESSORY_TYPE_TEXTURE:String = "Texture";
		public static const ICON_ACCESSORY_TYPE_LABEL:String = "Label";

		public function ItemRendererSettings()
		{
		}

		public var hasIcon:Boolean = true;
		public var hasAccessory:Boolean = true;
		public var layoutOrder:String = ItemRendererLayoutOrder.LABEL_ICON_ACCESSORY;
		public var iconType:String = ICON_ACCESSORY_TYPE_TEXTURE;
		public var iconPosition:String = RelativePosition.LEFT;
		public var useInfiniteGap:Boolean = false;
		public var accessoryPosition:String = RelativePosition.RIGHT;
		public var accessoryType:String = ICON_ACCESSORY_TYPE_DISPLAY_OBJECT;
		public var useInfiniteAccessoryGap:Boolean = true;
		public var horizontalAlign:String = HorizontalAlign.LEFT;
		public var verticalAlign:String = VerticalAlign.MIDDLE;
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/data/ListSettings.as
================================================
package feathers.examples.componentsExplorer.data
{
	public class ListSettings
	{
		public function ListSettings()
		{
		}

		public var isSelectable:Boolean = true;
		public var hasElasticEdges:Boolean = true;
		public var allowMultipleSelection:Boolean = false;
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/data/NumericStepperSettings.as
================================================
package feathers.examples.componentsExplorer.data
{
	public class NumericStepperSettings
	{
		public function NumericStepperSettings()
		{
		}

		public var step:Number = 1;
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/data/SliderSettings.as
================================================
package feathers.examples.componentsExplorer.data
{
	import feathers.controls.TrackInteractionMode;

	public class SliderSettings
	{
		public function SliderSettings()
		{
		}

		public var step:Number = 1;
		public var page:Number = 10;
		public var liveDragging:Boolean = true;
		public var trackInteractionMode:String = TrackInteractionMode.TO_VALUE;
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/AlertScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Alert;
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.data.ArrayCollection;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;

	import starling.events.Event;
	import feathers.system.DeviceCapabilities;
	import starling.core.Starling;
	import starling.display.DisplayObject;

	public class AlertScreen extends PanelScreen
	{
		public function AlertScreen()
		{
			super();
		}

		private var _showAlertButton:Button;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Alert";

			this.layout = new AnchorLayout();

			this._showAlertButton = new Button();
			this._showAlertButton.label = "Show Alert";
			this._showAlertButton.addEventListener(Event.TRIGGERED, showAlertButton_triggeredHandler);
			var buttonLayoutData:AnchorLayoutData = new AnchorLayoutData();
			buttonLayoutData.horizontalCenter = 0;
			buttonLayoutData.verticalCenter = 0;
			this._showAlertButton.layoutData = buttonLayoutData;
			this.addChild(this._showAlertButton);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function showAlertButton_triggeredHandler(event:Event):void
		{
			var alert:Alert = Alert.show("I just wanted you to know that I have a very important message to share with you.", "Alert", new ArrayCollection(
			[
				{ label: "OK" },
				{ label: "Cancel" }
			]));
			//when the enter key is pressed, treat it as OK
			alert.acceptButtonIndex = 0;
			//when the back or escape key is pressed, treat it as cancel
			alert.cancelButtonIndex = 1;
			alert.addEventListener(Event.CLOSE, alert_closeHandler);
		}

		private function alert_closeHandler(event:Event, data:Object):void
		{
			if(data)
			{
				trace("alert closed with item:", data.label);
			}
			else
			{
				trace("alert closed without item");
			}
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/AutoCompleteScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.AutoComplete;
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.controls.ScrollPolicy;
	import feathers.data.LocalAutoCompleteSource;
	import feathers.data.VectorCollection;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class AutoCompleteScreen extends PanelScreen
	{
		public function AutoCompleteScreen()
		{
		}

		private var _input:AutoComplete;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Auto-complete";
			
			var verticalLayout:VerticalLayout = new VerticalLayout();
			verticalLayout.horizontalAlign = HorizontalAlign.CENTER;
			verticalLayout.verticalAlign = VerticalAlign.TOP;
			verticalLayout.padding = 12;
			verticalLayout.gap = 8;
			this.layout = verticalLayout;

			this.verticalScrollPolicy = ScrollPolicy.ON;

			this._input = new AutoComplete();
			this._input.prompt = "Fruits. Type 'ap' to see suggestions";
			this._input.source = new LocalAutoCompleteSource(new VectorCollection(new <String>
			[
				"Apple",
				"Apricot",
				"Banana",
				"Cantaloupe",
				"Cherry",
				"Grape",
				"Lemon",
				"Lime",
				"Mango",
				"Orange",
				"Peach",
				"Pineapple",
				"Plum",
				"Pomegranate",
				"Raspberry",
				"Strawberry",
				"Watermelon"
			]));
			this.addChild(this._input);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/ButtonGroupScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.ButtonGroup;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.data.ArrayCollection;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class ButtonGroupScreen extends PanelScreen
	{
		public function ButtonGroupScreen()
		{
			super();
		}

		private var _buttonGroup:ButtonGroup;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Button Group";

			this.layout = new AnchorLayout();

			this._buttonGroup = new ButtonGroup();
			this._buttonGroup.dataProvider = new ArrayCollection(
			[
				{ label: "One", triggered: button_triggeredHandler },
				{ label: "Two", triggered: button_triggeredHandler },
				{ label: "Three", triggered: button_triggeredHandler },
				{ label: "Four", triggered: button_triggeredHandler },
			]);
			var buttonGroupLayoutData:AnchorLayoutData = new AnchorLayoutData();
			buttonGroupLayoutData.horizontalCenter = 0;
			buttonGroupLayoutData.verticalCenter = 0;
			this._buttonGroup.layoutData = buttonGroupLayoutData;
			this.addChild(this._buttonGroup);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function button_triggeredHandler(event:Event):void
		{
			var button:Button = Button(event.currentTarget);
			trace(button.label + " triggered.");
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/ButtonScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.ImageLoader;
	import feathers.controls.PanelScreen;
	import feathers.controls.ScrollPolicy;
	import feathers.controls.ToggleButton;
	import feathers.examples.componentsExplorer.data.EmbeddedAssets;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class ButtonScreen extends PanelScreen
	{
		public function ButtonScreen()
		{
			super();
		}

		private var _normalButton:Button;
		private var _disabledButton:Button;
		private var _iconButton:Button;
		private var _toggleButton:ToggleButton;
		private var _callToActionButton:Button;
		private var _quietButton:Button;
		private var _dangerButton:Button;
		private var _sampleBackButton:Button;
		private var _forwardButton:Button;
		
		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Button";
			
			var verticalLayout:VerticalLayout = new VerticalLayout();
			verticalLayout.horizontalAlign = HorizontalAlign.CENTER;
			verticalLayout.verticalAlign = VerticalAlign.TOP;
			verticalLayout.padding = 12;
			verticalLayout.gap = 8;
			this.layout = verticalLayout;

			this.verticalScrollPolicy = ScrollPolicy.ON;
			
			this._normalButton = new Button();
			this._normalButton.label = "Normal Button";
			this._normalButton.addEventListener(Event.TRIGGERED, normalButton_triggeredHandler);
			this.addChild(this._normalButton);

			this._disabledButton = new Button();
			this._disabledButton.label = "Disabled Button";
			this._disabledButton.isEnabled = false;
			this.addChild(this._disabledButton);
			
			this._iconButton = new Button();
			this._iconButton.label = "Icon Button";
			var icon:ImageLoader = new ImageLoader();
			//the source can be either a texture or a URL
			icon.source = EmbeddedAssets.SKULL_ICON_DARK;
			this._iconButton.defaultIcon = icon;
			this.addChild(this._iconButton);

			this._toggleButton = new ToggleButton();
			this._toggleButton.label = "Toggle Button";
			this._toggleButton.isSelected = true;
			this._toggleButton.addEventListener(Event.CHANGE, toggleButton_changeHandler);
			this.addChild(this._toggleButton);

			this._callToActionButton = new Button();
			this._callToActionButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_CALL_TO_ACTION_BUTTON);
			this._callToActionButton.label = "Call to Action Button";
			this.addChild(this._callToActionButton);

			this._dangerButton = new Button();
			this._dangerButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_DANGER_BUTTON);
			this._dangerButton.label = "Danger Button";
			this.addChild(this._dangerButton);

			this._sampleBackButton = new Button();
			this._sampleBackButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
			this._sampleBackButton.label = "Back Button";
			this.addChild(this._sampleBackButton);

			this._forwardButton = new Button();
			this._forwardButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_FORWARD_BUTTON);
			this._forwardButton.label = "Forward Button";
			this.addChild(this._forwardButton);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			this._quietButton = new Button();
			this._quietButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_QUIET_BUTTON);
			this._quietButton.label = "Quiet Button";
			header.rightItems = new <DisplayObject>
			[
				this._quietButton
			];
			return header;
		}
		
		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function normalButton_triggeredHandler(event:Event):void
		{
			trace("normal button triggered.")
		}

		private function toggleButton_changeHandler(event:Event):void
		{
			trace("toggle button changed:", this._toggleButton.isSelected);
		}
		
		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/CalloutScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Callout;
	import feathers.controls.Header;
	import feathers.controls.Label;
	import feathers.controls.PanelScreen;
	import feathers.controls.ScrollPolicy;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class CalloutScreen extends PanelScreen
	{
		public function CalloutScreen()
		{
			super();
		}

		private var _showCalloutButton:Button;
		private var _content:PanelScreen;

		override public function dispose():void
		{
			//the content won't be on the display list when the screen is
			//disposed, so dispose it manually
			if(this._content)
			{
				this._content.dispose();
				this._content = null;
			}
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Callout";

			var verticalLayout:VerticalLayout = new VerticalLayout();
			verticalLayout.horizontalAlign = HorizontalAlign.CENTER;
			verticalLayout.verticalAlign = VerticalAlign.TOP;
			verticalLayout.padding = 12;
			verticalLayout.gap = 8;
			this.layout = verticalLayout;

			this.verticalScrollPolicy = ScrollPolicy.ON;

			//this is what we're going to display in the callout
			this._content = new PanelScreen();
			this._content.headerFactory = function():Header
			{
				var header:Header = new Header();
				//don't add extra padding on iOS
				header.useExtraPaddingForOSStatusBar = false;
				header.paddingTop = 2;
				header.paddingBottom = 8;
				header.gap = 8;
				header.titleGap = 8;
				header.backgroundSkin = null;
				//we want to use the theme's font styles, with a slightly smaller font size
				header.initializeNow();
				header.fontStyles.size = 14;
				return header;
			};
			this._content.title = "Callout Content";
			this._content.width = 200;
			this._content.layout = new AnchorLayout();
			var description:Label = new Label();
			description.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			description.wordWrap = true;
			description.text = "A callout displays content in a pop-up container, with an arrow that points to its origin.\n\nTap anywhere outside of the callout to close it.";
			this._content.addChild(description);
			//the content will be shown in the callout, so we don't add it to a
			//parent yet.

			this._showCalloutButton = new Button();
			this._showCalloutButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_CALL_TO_ACTION_BUTTON);
			this._showCalloutButton.label = "Show Callout";
			this._showCalloutButton.addEventListener(Event.TRIGGERED, showCalloutButton_triggeredHandler);
			this.addChild(this._showCalloutButton);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function showCalloutButton_triggeredHandler(event:Event):void
		{
			var callout:Callout = Callout.show(this._content, this._showCalloutButton);
			//we're reusing the content every time that it is shown, so we don't
			//want the content to be disposed. we'll dispose of it manually
			//later when the screen is disposed.
			callout.disposeContent = false;
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/CheckScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Check;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.controls.ScrollPolicy;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class CheckScreen extends PanelScreen
	{
		public function CheckScreen()
		{
			super();
		}

		private var _check:Check;
		private var _checked:Check;
		private var _disabled:Check;
		private var _selectedDisabled:Check;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Check";

			var verticalLayout:VerticalLayout = new VerticalLayout();
			verticalLayout.horizontalAlign = HorizontalAlign.LEFT;
			verticalLayout.verticalAlign = VerticalAlign.TOP;
			verticalLayout.padding = 12;
			verticalLayout.gap = 8;
			this.layout = verticalLayout;

			this.verticalScrollPolicy = ScrollPolicy.ON;

			this._check = new Check();
			this._check.label = "Default";
			this._check.addEventListener(Event.CHANGE, check_changeHandler);
			this.addChild(this._check);

			this._checked = new Check();
			this._checked.label = "Selected";
			this._checked.isSelected = true;
			this.addChild(this._checked);

			this._disabled = new Check();
			this._disabled.label = "Disabled";
			this._disabled.isEnabled = false;
			this.addChild(this._disabled);

			this._selectedDisabled = new Check();
			this._selectedDisabled.label = "Selected and Disabled";
			this._selectedDisabled.isSelected = true;
			this._selectedDisabled.isEnabled = false;
			this.addChild(this._selectedDisabled);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function check_changeHandler(event:Event):void
		{
			trace("check changed:", this._check.isSelected);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/DataGridScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.DataGrid;
	import feathers.controls.DataGridColumn;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.data.ArrayCollection;
	import feathers.events.FeathersEventType;
	import feathers.examples.componentsExplorer.data.DataGridSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]
	[Event(name="showSettings",type="starling.events.Event")]

	public class DataGridScreen extends PanelScreen
	{
		public static const SHOW_SETTINGS:String = "showSettings";

		public function DataGridScreen()
		{
			super();
		}

		public var settings:DataGridSettings;

		private var _grid:DataGrid;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Data Grid";

			this.layout = new AnchorLayout();

			var items:Array =
			[
				{ item: "Chicken breast", dept: "Meat", price: "5.90" },
				{ item: "Bacon", dept: "Meat", price: "4.49" },
				{ item: "2% Milk", dept: "Dairy", price: "2.49" },
				{ item: "Butter", dept: "Dairy", price: "4.69" },
				{ item: "Lettuce", dept: "Produce", price: "1.29" },
				{ item: "Broccoli", dept: "Produce", price: "2.99" },
				{ item: "Whole Wheat Bread", dept: "Bakery", price: "2.49" },
				{ item: "English Muffins", dept: "Bakery", price: "2.99" },
			];
			var columns:Array =
			[
				new DataGridColumn("item", "Item"),
				new DataGridColumn("dept", "Department"),
				new DataGridColumn("price", "Unit Price"),
			];

			this._grid = new DataGrid();
			this._grid.dataProvider = new ArrayCollection(items);
			this._grid.columns = new ArrayCollection(columns);

			this._grid.sortableColumns = this.settings.sortableColumns;
			this._grid.resizableColumns = this.settings.resizableColumns;
			this._grid.reorderColumns = this.settings.reorderColumns;

			//optimization: since this grid fills the entire screen, there's no
			//need for clipping. clipping should not be disabled if there's a
			//chance that item renderers could be visible if they appear outside
			//the list's bounds
			this._grid.clipContent = false;
			//optimization: when the background is covered by all item
			//renderers, don't render it
			this._grid.autoHideBackground = true;
			this._grid.addEventListener(Event.CHANGE, list_changeHandler);
			this._grid.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this.addChild(this._grid);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}

			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			var settingsButton:Button = new Button();
			settingsButton.label = "Settings";
			settingsButton.addEventListener(Event.TRIGGERED, settingsButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				settingsButton
			];
			return header;
		}
		
		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function transitionInCompleteHandler(event:Event):void
		{
			this._grid.revealScrollBars();
		}
		
		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function settingsButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(SHOW_SETTINGS);
		}

		private function list_changeHandler(event:Event):void
		{
			var selectedIndices:Vector.<int> = this._grid.selectedIndices;
			trace("List change:", selectedIndices.length > 0 ? selectedIndices : this._grid.selectedIndex);
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/DataGridSettingsScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.ToggleSwitch;
	import feathers.data.ArrayCollection;
	import feathers.examples.componentsExplorer.data.DataGridSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;

	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class DataGridSettingsScreen extends PanelScreen
	{
		public function DataGridSettingsScreen()
		{
			super();
		}

		public var settings:DataGridSettings;

		private var _list:List;
		private var _sortableColumnsToggle:ToggleSwitch;
		private var _resizableColumnsToggle:ToggleSwitch;
		private var _reorderColumnsToggle:ToggleSwitch;

		override public function dispose():void
		{
			//icon and accessory display objects in the list's data provider
			//won't be automatically disposed because feathers cannot know if
			//they need to be used again elsewhere or not. we need to dispose
			//them manually.
			this._list.dataProvider.dispose(disposeItemAccessory);

			//never forget to call super.dispose() because you don't want to
			//create a memory leak!
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Data Grid Settings";

			this.layout = new AnchorLayout();

			this._sortableColumnsToggle = new ToggleSwitch();
			this._sortableColumnsToggle.isSelected = this.settings.sortableColumns;
			this._sortableColumnsToggle.addEventListener(Event.CHANGE, sortableColumnsToggle_changeHandler);

			this._resizableColumnsToggle = new ToggleSwitch();
			this._resizableColumnsToggle.isSelected = this.settings.resizableColumns;
			this._resizableColumnsToggle.addEventListener(Event.CHANGE, resizableColumnsToggle_changeHandler);

			this._reorderColumnsToggle = new ToggleSwitch();
			this._reorderColumnsToggle.isSelected = this.settings.reorderColumns;
			this._reorderColumnsToggle.addEventListener(Event.CHANGE, reorderColumnsToggle_changeHandler);

			this._list = new List();
			this._list.isSelectable = false;
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Sortable Columns", accessory: this._sortableColumnsToggle },
				{ label: "Resizable Columns", accessory: this._resizableColumnsToggle },
				{ label: "Reorder Columns", accessory: this._reorderColumnsToggle },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.clipContent = false;
			this._list.autoHideBackground = true;
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = this.onBackButton;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			var doneButton:Button = new Button();
			doneButton.label = "Done";
			doneButton.addEventListener(Event.TRIGGERED, doneButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				doneButton
			];
			return header;
		}

		private function disposeItemAccessory(item:Object):void
		{
			DisplayObject(item.accessory).dispose();
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function reorderColumnsToggle_changeHandler(event:Event):void
		{
			this.settings.reorderColumns = this._reorderColumnsToggle.isSelected;
		}

		private function resizableColumnsToggle_changeHandler(event:Event):void
		{
			this.settings.resizableColumns = this._resizableColumnsToggle.isSelected;
		}

		private function sortableColumnsToggle_changeHandler(event:Event):void
		{
			this.settings.sortableColumns = this._sortableColumnsToggle.isSelected;
		}

		private function doneButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/DateTimeSpinnerScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.DateTimeSpinner;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.examples.componentsExplorer.data.DateTimeSpinnerSettings;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]
	
	public class DateTimeSpinnerScreen extends PanelScreen
	{
		public static const SHOW_SETTINGS:String = "showSettings";
		
		public function DateTimeSpinnerScreen()
		{
		}

		public var settings:DateTimeSpinnerSettings;

		private var _dateTimeSpinner:DateTimeSpinner;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Date Time Spinner";

			var verticalLayout:VerticalLayout = new VerticalLayout();
			verticalLayout.horizontalAlign = HorizontalAlign.CENTER;
			verticalLayout.verticalAlign = VerticalAlign.MIDDLE;
			verticalLayout.padding = 12;
			verticalLayout.gap = 8;
			this.layout = verticalLayout;

			this._dateTimeSpinner = new DateTimeSpinner();
			this._dateTimeSpinner.editingMode = this.settings.editingMode;
			this._dateTimeSpinner.addEventListener(Event.CHANGE, dateTimeSpinner_changeHandler);
			this.addChild(this._dateTimeSpinner);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			var settingsButton:Button = new Button();
			settingsButton.label = "Settings";
			settingsButton.addEventListener(Event.TRIGGERED, settingsButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				settingsButton
			];
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function settingsButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(SHOW_SETTINGS);
		}

		private function dateTimeSpinner_changeHandler(event:Event):void
		{
			trace("DateTimeSpinner change:", this._dateTimeSpinner.value);
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/DateTimeSpinnerSettingsScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.DateTimeMode;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.data.ArrayCollection;
	import feathers.data.VectorCollection;
	import feathers.examples.componentsExplorer.data.DateTimeSpinnerSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;

	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class DateTimeSpinnerSettingsScreen extends PanelScreen
	{
		public function DateTimeSpinnerSettingsScreen()
		{
			super();
		}

		public var settings:DateTimeSpinnerSettings;

		private var _list:List;
		private var _editingModePicker:PickerList;

		override public function dispose():void
		{
			//icon and accessory display objects in the list's data provider
			//won't be automatically disposed because feathers cannot know if
			//they need to be used again elsewhere or not. we need to dispose
			//them manually.
			this._list.dataProvider.dispose(disposeItemAccessory);

			//never forget to call super.dispose() because you don't want to
			//create a memory leak!
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Date Time Spinner Settings";

			this.layout = new AnchorLayout();

			this._editingModePicker = new PickerList();
			this._editingModePicker.dataProvider = new VectorCollection(new <String>
			[
				DateTimeMode.DATE_AND_TIME,
				DateTimeMode.DATE,
				DateTimeMode.TIME,
			]);
			this._editingModePicker.selectedItem = this.settings.editingMode;
			this._editingModePicker.addEventListener(Event.CHANGE, editingModePicker_changeHandler);

			this._list = new List();
			this._list.isSelectable = false;
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "editingMode", accessory: this._editingModePicker },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.clipContent = false;
			this._list.autoHideBackground = true;
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = this.onBackButton;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			var doneButton:Button = new Button();
			doneButton.label = "Done";
			doneButton.addEventListener(Event.TRIGGERED, doneButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				doneButton
			];
			return header;
		}

		private function disposeItemAccessory(item:Object):void
		{
			DisplayObject(item.accessory).dispose();
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function editingModePicker_changeHandler(event:Event):void
		{
			this.settings.editingMode = this._editingModePicker.selectedItem as String;
		}

		private function doneButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/GroupedListScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.GroupedList;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.controls.renderers.DefaultGroupedListItemRenderer;
	import feathers.controls.renderers.IGroupedListItemRenderer;
	import feathers.data.ArrayHierarchicalCollection;
	import feathers.events.FeathersEventType;
	import feathers.examples.componentsExplorer.data.GroupedListSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]
	[Event(name="showSettings",type="starling.events.Event")]

	public class GroupedListScreen extends PanelScreen
	{
		public static const SHOW_SETTINGS:String = "showSettings";

		public function GroupedListScreen()
		{
			super();
		}

		public var settings:GroupedListSettings;

		private var _list:GroupedList;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Grouped List";

			this.layout = new AnchorLayout();

			var groups:Array =
			[
				{
					header: "A",
					children:
					[
						{ text: "Aardvark" },
						{ text: "Alligator" },
						{ text: "Alpaca" },
						{ text: "Anteater" },
					]
				},
				{
					header: "B",
					children:
					[
						{ text: "Baboon" },
						{ text: "Bear" },
						{ text: "Beaver" },
					]
				},
				{
					header: "C",
					children:
					[
						{ text: "Canary" },
						{ text: "Cat" },
					]
				},
				{
					header: "D",
					children:
					[
						{ text: "Deer" },
						{ text: "Dingo" },
						{ text: "Dog" },
						{ text: "Dolphin" },
						{ text: "Donkey" },
						{ text: "Dragonfly" },
						{ text: "Duck" },
						{ text: "Dung Beetle" },
					]
				},
				{
					header: "E",
					children:
					[
						{ text: "Eagle" },
						{ text: "Earthworm" },
						{ text: "Eel" },
						{ text: "Elk" },
					]
				},
				{
					header: "F",
					children:
					[
						{ text: "Fox" },
					]
				}
			];
			
			this._list = new GroupedList();
			if(this.settings.style == GroupedListSettings.STYLE_INSET)
			{
				this._list.styleNameList.add(GroupedList.ALTERNATE_STYLE_NAME_INSET_GROUPED_LIST);
			}
			this._list.dataProvider = new ArrayHierarchicalCollection(groups);
			this._list.typicalItem = { text: "Item 1000" };
			this._list.isSelectable = this.settings.isSelectable;
			this._list.hasElasticEdges = this.settings.hasElasticEdges;
			//optimization: since this list fills the entire screen, there's no
			//need for clipping. clipping should not be disabled if there's a
			//chance that item renderers could be visible if they appear outside
			//the list's bounds
			this._list.clipContent = false;
			//optimization: when the background is covered by all item
			//renderers, don't render it
			this._list.autoHideBackground = true;
			this._list.itemRendererFactory = function():IGroupedListItemRenderer
			{
				var renderer:DefaultGroupedListItemRenderer = new DefaultGroupedListItemRenderer();

				//enable the quick hit area to optimize hit tests when an item
				//is only selectable and doesn't have interactive children.
				renderer.isQuickHitAreaEnabled = true;

				renderer.labelField = "text";
				return renderer;
			};
			this._list.addEventListener(Event.CHANGE, list_changeHandler);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this.addChildAt(this._list, 0);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}

			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			var settingsButton:Button = new Button();
			settingsButton.label = "Settings";
			settingsButton.addEventListener(Event.TRIGGERED, settingsButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				settingsButton
			];
			return header;
		}
		
		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function transitionInCompleteHandler(event:Event):void
		{
			this._list.revealScrollBars();
		}
		
		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function settingsButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(SHOW_SETTINGS);
		}

		private function list_changeHandler(event:Event):void
		{
			trace("GroupedList change:", this._list.selectedGroupIndex, this._list.selectedItemIndex);
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/GroupedListSettingsScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.controls.ToggleSwitch;
	import feathers.data.ArrayCollection;
	import feathers.data.VectorCollection;
	import feathers.examples.componentsExplorer.data.GroupedListSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;

	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class GroupedListSettingsScreen extends PanelScreen
	{
		public function GroupedListSettingsScreen()
		{
			super();
		}

		public var settings:GroupedListSettings;

		private var _list:List;

		private var _stylePicker:PickerList;
		private var _isSelectableToggle:ToggleSwitch;
		private var _hasElasticEdgesToggle:ToggleSwitch;

		override public function dispose():void
		{
			//icon and accessory display objects in the list's data provider
			//won't be automatically disposed because feathers cannot know if
			//they need to be used again elsewhere or not. we need to dispose
			//them manually.
			this._list.dataProvider.dispose(disposeItemAccessory);

			//never forget to call super.dispose() because you don't want to
			//create a memory leak!
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Grouped List Settings";

			this.layout = new AnchorLayout();

			this._stylePicker = new PickerList();
			this._stylePicker.dataProvider = new VectorCollection(new <String>
			[
				GroupedListSettings.STYLE_NORMAL,
				GroupedListSettings.STYLE_INSET
			]);
			this._stylePicker.typicalItem = GroupedListSettings.STYLE_NORMAL;
			this._stylePicker.listProperties.typicalItem = GroupedListSettings.STYLE_NORMAL;
			this._stylePicker.selectedItem = this.settings.style;
			this._stylePicker.addEventListener(Event.CHANGE, stylePicker_changeHandler);

			this._isSelectableToggle = new ToggleSwitch();
			this._isSelectableToggle.isSelected = this.settings.isSelectable;
			this._isSelectableToggle.addEventListener(Event.CHANGE, isSelectableToggle_changeHandler);

			this._hasElasticEdgesToggle = new ToggleSwitch();
			this._hasElasticEdgesToggle.isSelected = this.settings.hasElasticEdges;
			this._hasElasticEdgesToggle.addEventListener(Event.CHANGE, hasElasticEdgesToggle_changeHandler);

			this._list = new List();
			this._list.isSelectable = false;
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Group Style", accessory: this._stylePicker },
				{ label: "isSelectable", accessory: this._isSelectableToggle },
				{ label: "hasElasticEdges", accessory: this._hasElasticEdgesToggle },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.clipContent = false;
			this._list.autoHideBackground = true;
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = this.onBackButton;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			var doneButton:Button = new Button();
			doneButton.label = "Done";
			doneButton.addEventListener(Event.TRIGGERED, doneButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				doneButton
			];
			return header;
		}

		private function disposeItemAccessory(item:Object):void
		{
			DisplayObject(item.accessory).dispose();
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function doneButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function stylePicker_changeHandler(event:Event):void
		{
			this.settings.style = this._stylePicker.selectedItem as String;
		}

		private function isSelectableToggle_changeHandler(event:Event):void
		{
			this.settings.isSelectable = this._isSelectableToggle.isSelected;
		}

		private function hasElasticEdgesToggle_changeHandler(event:Event):void
		{
			this.settings.hasElasticEdges = this._hasElasticEdgesToggle.isSelected;
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/ItemRendererScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.ToggleSwitch;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ArrayCollection;
	import feathers.examples.componentsExplorer.data.EmbeddedAssets;
	import feathers.examples.componentsExplorer.data.ItemRendererSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]
	[Event(name="showSettings",type="starling.events.Event")]

	public class ItemRendererScreen extends PanelScreen
	{
		public static const SHOW_SETTINGS:String = "showSettings";

		public function ItemRendererScreen()
		{
			super();
		}

		private var _list:List;
		private var _listItem:Object;

		private var _settings:ItemRendererSettings;

		public function get settings():ItemRendererSettings
		{
			return this._settings;
		}

		public function set settings(value:ItemRendererSettings):void
		{
			if(this._settings == value)
			{
				return;
			}
			this._settings = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		override public function dispose():void
		{
			//icon and accessory display objects in the list's data provider
			//won't be automatically disposed because feathers cannot know if
			//they need to be used again elsewhere or not. we need to dispose
			//them manually.
			this._list.dataProvider.dispose(disposeItemIconOrAccessory);

			//never forget to call super.dispose() because you don't want to
			//create a memory leak!
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()!
			super.initialize();

			this.title = "Item Renderer";

			this.layout = new AnchorLayout();

			this._list = new List();

			this._listItem = { text: "Primary Text" };
			this._list.itemRendererFactory = this.customItemRendererFactory;
			this._list.dataProvider = new ArrayCollection([this._listItem]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.isSelectable = false;
			this._list.clipContent = false;
			this._list.autoHideBackground = true;
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customItemRendererFactory():IListItemRenderer
		{
			var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
			itemRenderer.labelField = "text";
			if(this.settings.hasIcon)
			{
				switch(this.settings.iconType)
				{
					case ItemRendererSettings.ICON_ACCESSORY_TYPE_LABEL:
					{
						this._listItem.iconText = "Icon Text";
						itemRenderer.iconLabelField = "iconText";

						//clear these in case this setting has changed
						delete this._listItem.iconTexture;
						delete this._listItem.icon;
						break;
					}
					case ItemRendererSettings.ICON_ACCESSORY_TYPE_TEXTURE:
					{
						this._listItem.iconTexture = EmbeddedAssets.SKULL_ICON_LIGHT;
						itemRenderer.iconSourceField = "iconTexture";

						//clear these in case this setting has changed
						delete this._listItem.iconText;
						delete this._listItem.icon;
						break;
					}
					default:
					{
						this._listItem.icon = new ToggleSwitch();
						itemRenderer.iconField = "icon";

						//clear these in case this setting has changed
						delete this._listItem.iconText;
						delete this._listItem.iconTexture;

					}
				}
				itemRenderer.iconPosition = this.settings.iconPosition;
			}
			if(this.settings.hasAccessory)
			{
				switch(this.settings.accessoryType)
				{
					case ItemRendererSettings.ICON_ACCESSORY_TYPE_LABEL:
					{
						this._listItem.accessoryText = "Accessory Text";
						itemRenderer.accessoryLabelField = "accessoryText";

						//clear these in case this setting has changed
						delete this._listItem.accessoryTexture;
						delete this._listItem.accessory;
						break;
					}
					case ItemRendererSettings.ICON_ACCESSORY_TYPE_TEXTURE:
					{
						this._listItem.accessoryTexture = EmbeddedAssets.SKULL_ICON_LIGHT;
						itemRenderer.accessorySourceField = "accessoryTexture";
						break;
					}
					default:
					{
						this._listItem.accessory = new ToggleSwitch();
						itemRenderer.accessoryField = "accessory";

						//clear these in case this setting has changed
						delete this._listItem.accessoryText;
						delete this._listItem.accessoryTexture;
					}
				}
				itemRenderer.accessoryPosition = this.settings.accessoryPosition;
			}
			if(this.settings.useInfiniteGap)
			{
				itemRenderer.gap = Number.POSITIVE_INFINITY;
			}
			else
			{
				itemRenderer.gap = 12;
			}
			if(this.settings.useInfiniteAccessoryGap)
			{
				itemRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			}
			else
			{
				itemRenderer.accessoryGap = 12;
			}
			itemRenderer.horizontalAlign = this.settings.horizontalAlign;
			itemRenderer.verticalAlign = this.settings.verticalAlign;
			itemRenderer.layoutOrder = this.settings.layoutOrder;
			return itemRenderer;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			var settingsButton:Button = new Button();
			settingsButton.label = "Settings";
			settingsButton.addEventListener(Event.TRIGGERED, settingsButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				settingsButton
			];
			return header;
		}

		private function disposeItemIconOrAccessory(item:Object):void
		{
			if(item.hasOwnProperty("icon"))
			{
				DisplayObject(item.icon).dispose();
			}
			if(item.hasOwnProperty("accessory"))
			{
				DisplayObject(item.accessory).dispose();
			}
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function settingsButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(SHOW_SETTINGS);
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/ItemRendererSettingsScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.GroupedList;
	import feathers.controls.Header;
	import feathers.controls.ItemRendererLayoutOrder;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.controls.ToggleSwitch;
	import feathers.data.ArrayCollection;
	import feathers.data.ArrayHierarchicalCollection;
	import feathers.data.VectorCollection;
	import feathers.examples.componentsExplorer.data.ItemRendererSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.RelativePosition;
	import feathers.layout.VerticalAlign;

	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class ItemRendererSettingsScreen extends PanelScreen
	{
		private static const GAP_LABEL_INFINITE:String = "Fill Available Space";
		private static const GAP_LABEL_DEFAULT:String = "No Fill";

		public function ItemRendererSettingsScreen()
		{
			super();
		}

		public var settings:ItemRendererSettings;

		private var _list:GroupedList;
		private var _gapPicker:PickerList;
		private var _hasIconToggle:ToggleSwitch;
		private var _hasAccessoryToggle:ToggleSwitch;
		private var _layoutOrderPicker:PickerList;
		private var _iconPositionPicker:PickerList;
		private var _iconTypePicker:PickerList;
		private var _accessoryPositionPicker:PickerList;
		private var _accessoryTypePicker:PickerList;
		private var _accessoryGapPicker:PickerList;
		private var _horizontalAlignPicker:PickerList;
		private var _verticalAlignPicker:PickerList;

		override public function dispose():void
		{
			//icon and accessory display objects in the list's data provider
			//won't be automatically disposed because feathers cannot know if
			//they need to be used again elsewhere or not. we need to dispose
			//them manually.
			this._list.dataProvider.dispose(null, disposeItemAccessory);

			//never forget to call super.dispose() because you don't want to
			//create a memory leak!
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Item Renderer Settings";

			this.layout = new AnchorLayout();

			this._hasIconToggle = new ToggleSwitch();
			this._hasIconToggle.isSelected = this.settings.hasIcon;
			this._hasIconToggle.addEventListener(Event.CHANGE, hasIconToggle_changeHandler);

			this._iconTypePicker = new PickerList();
			this._iconTypePicker.typicalItem = ItemRendererSettings.ICON_ACCESSORY_TYPE_DISPLAY_OBJECT;
			this._iconTypePicker.dataProvider = new VectorCollection(new <String>
			[
				ItemRendererSettings.ICON_ACCESSORY_TYPE_DISPLAY_OBJECT,
				ItemRendererSettings.ICON_ACCESSORY_TYPE_TEXTURE,
				ItemRendererSettings.ICON_ACCESSORY_TYPE_LABEL,
			]);
			this._iconTypePicker.listProperties.typicalItem = ItemRendererSettings.ICON_ACCESSORY_TYPE_DISPLAY_OBJECT;
			this._iconTypePicker.selectedItem = this.settings.iconType;
			this._iconTypePicker.addEventListener(Event.CHANGE, iconTypePicker_changeHandler);

			this._iconPositionPicker = new PickerList();
			this._iconPositionPicker.typicalItem = RelativePosition.RIGHT_BASELINE;
			this._iconPositionPicker.dataProvider = new VectorCollection(new <String>
			[
				RelativePosition.TOP,
				RelativePosition.RIGHT,
				RelativePosition.BOTTOM,
				RelativePosition.LEFT,
				RelativePosition.LEFT_BASELINE,
				RelativePosition.RIGHT_BASELINE,
				//RelativePosition.MANUAL,
			]);
			this._iconPositionPicker.listProperties.typicalItem = RelativePosition.RIGHT_BASELINE;
			this._iconPositionPicker.selectedItem = this.settings.iconPosition;
			this._iconPositionPicker.addEventListener(Event.CHANGE, iconPositionPicker_changeHandler);

			this._gapPicker = new PickerList();
			this._gapPicker.dataProvider = new ArrayCollection(
			[
				{ label: GAP_LABEL_INFINITE, value: true },
				{ label: GAP_LABEL_DEFAULT, value: false },
			]);
			this._gapPicker.typicalItem = this._gapPicker.dataProvider.getItemAt(0);
			this._gapPicker.listProperties.typicalItem = this._gapPicker.dataProvider.getItemAt(0);
			this._gapPicker.selectedItem = this._gapPicker.dataProvider.getItemAt(this.settings.useInfiniteGap ? 0 : 1);
			this._gapPicker.addEventListener(Event.CHANGE, gapPicker_changeHandler);

			this._hasAccessoryToggle = new ToggleSwitch();
			this._hasAccessoryToggle.isSelected = this.settings.hasAccessory;
			this._hasAccessoryToggle.addEventListener(Event.CHANGE, hasAccessoryToggle_changeHandler);

			this._accessoryTypePicker = new PickerList();
			this._accessoryTypePicker.typicalItem = ItemRendererSettings.ICON_ACCESSORY_TYPE_DISPLAY_OBJECT;
			this._accessoryTypePicker.dataProvider = new VectorCollection(new <String>
			[
				ItemRendererSettings.ICON_ACCESSORY_TYPE_DISPLAY_OBJECT,
				ItemRendererSettings.ICON_ACCESSORY_TYPE_TEXTURE,
				ItemRendererSettings.ICON_ACCESSORY_TYPE_LABEL,
			]);
			this._accessoryTypePicker.listProperties.typicalItem = ItemRendererSettings.ICON_ACCESSORY_TYPE_DISPLAY_OBJECT;
			this._accessoryTypePicker.selectedItem = this.settings.accessoryType;
			this._accessoryTypePicker.addEventListener(Event.CHANGE, accessoryTypePicker_changeHandler);

			this._accessoryPositionPicker = new PickerList();
			this._accessoryPositionPicker.typicalItem = RelativePosition.BOTTOM;
			this._accessoryPositionPicker.dataProvider = new VectorCollection(new <String>
			[
				RelativePosition.TOP,
				RelativePosition.RIGHT,
				RelativePosition.BOTTOM,
				RelativePosition.LEFT,
				//RelativePosition.MANUAL,
			]);
			this._accessoryPositionPicker.listProperties.typicalItem = RelativePosition.BOTTOM;
			this._accessoryPositionPicker.selectedItem = this.settings.accessoryPosition;
			this._accessoryPositionPicker.addEventListener(Event.CHANGE, accessoryPositionPicker_changeHandler);

			this._accessoryGapPicker = new PickerList();
			this._accessoryGapPicker.dataProvider = new ArrayCollection(
			[
				{ label: GAP_LABEL_INFINITE, value: true },
				{ label: GAP_LABEL_DEFAULT, value: false },
			]);
			this._accessoryGapPicker.typicalItem = this._accessoryGapPicker.dataProvider.getItemAt(0);
			this._accessoryGapPicker.listProperties.typicalItem = this._accessoryGapPicker.dataProvider.getItemAt(0);
			this._accessoryGapPicker.selectedItem = this._accessoryGapPicker.dataProvider.getItemAt(this.settings.useInfiniteAccessoryGap ? 0 : 1);
			this._accessoryGapPicker.addEventListener(Event.CHANGE, accessoryGapPicker_changeHandler);

			this._layoutOrderPicker = new PickerList();
			this._layoutOrderPicker.typicalItem = ItemRendererLayoutOrder.LABEL_ACCESSORY_ICON;
			this._layoutOrderPicker.dataProvider = new VectorCollection(new <String>
			[
				ItemRendererLayoutOrder.LABEL_ICON_ACCESSORY,
				ItemRendererLayoutOrder.LABEL_ACCESSORY_ICON,
			]);
			this._layoutOrderPicker.listProperties.typicalItem = ItemRendererLayoutOrder.LABEL_ACCESSORY_ICON;
			this._layoutOrderPicker.selectedItem = this.settings.layoutOrder;
			this._layoutOrderPicker.addEventListener(Event.CHANGE, layoutOrderPicker_changeHandler);

			this._horizontalAlignPicker = new PickerList();
			this._horizontalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				HorizontalAlign.LEFT,
				HorizontalAlign.CENTER,
				HorizontalAlign.RIGHT,
			]);
			this._horizontalAlignPicker.typicalItem = HorizontalAlign.CENTER;
			this._horizontalAlignPicker.listProperties.typicalItem = HorizontalAlign.CENTER;
			this._horizontalAlignPicker.selectedItem = this.settings.horizontalAlign;
			this._horizontalAlignPicker.addEventListener(Event.CHANGE, horizontalAlignPicker_changeHandler);

			this._verticalAlignPicker = new PickerList();
			this._verticalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				VerticalAlign.TOP,
				VerticalAlign.MIDDLE,
				VerticalAlign.BOTTOM,
			]);
			this._verticalAlignPicker.typicalItem = VerticalAlign.MIDDLE;
			this._verticalAlignPicker.listProperties.typicalItem = VerticalAlign.MIDDLE;
			this._verticalAlignPicker.selectedItem = this.settings.verticalAlign;
			this._verticalAlignPicker.addEventListener(Event.CHANGE, verticalAlignPicker_changeHandler);

			this._list = new GroupedList();
			this._list.styleNameList.add(GroupedList.ALTERNATE_STYLE_NAME_INSET_GROUPED_LIST);
			this._list.isSelectable = false;
			this._list.dataProvider = new ArrayHierarchicalCollection(
			[
				{
					header: "Layout",
					children:
					[
						{ label: "layoutOrder", accessory: this._layoutOrderPicker },
						{ label: "horizontalAlign", accessory: this._horizontalAlignPicker },
						{ label: "verticalAlign", accessory: this._verticalAlignPicker },
					]
				},
				{
					header: "Icon",
					children:
					[
						{ label: "Has Icon", accessory: this._hasIconToggle },
						{ label: "Icon Type", accessory: this._iconTypePicker },
						{ label: "iconPosition", accessory: this._iconPositionPicker },
						{ label: "gap", accessory: this._gapPicker },
					]
				},
				{
					header: "Accessory",
					children:
					[
						{ label: "Has Accessory", accessory: this._hasAccessoryToggle },
						{ label: "Accessory Type", accessory: this._accessoryTypePicker },
						{ label: "accessoryPosition", accessory: this._accessoryPositionPicker },
						{ label: "accessoryGap", accessory: this._accessoryGapPicker },
					]
				},
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.clipContent = false;
			this._list.autoHideBackground = true;
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = this.onBackButton;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			var doneButton:Button = new Button();
			doneButton.label = "Done";
			doneButton.addEventListener(Event.TRIGGERED, doneButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				doneButton
			];
			return header;
		}

		private function disposeItemAccessory(item:Object):void
		{
			DisplayObject(item.accessory).dispose();
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function hasIconToggle_changeHandler(event:Event):void
		{
			this.settings.hasIcon = this._hasIconToggle.isSelected
		}

		private function iconTypePicker_changeHandler(event:Event):void
		{
			this.settings.iconType = this._iconTypePicker.selectedItem as String;
		}

		private function iconPositionPicker_changeHandler(event:Event):void
		{
			this.settings.iconPosition = this._iconPositionPicker.selectedItem as String;
		}

		private function gapPicker_changeHandler(event:Event):void
		{
			this.settings.useInfiniteGap = this._gapPicker.selectedIndex == 0;
		}

		private function hasAccessoryToggle_changeHandler(event:Event):void
		{
			this.settings.hasAccessory = this._hasAccessoryToggle.isSelected
		}

		private function accessoryTypePicker_changeHandler(event:Event):void
		{
			this.settings.accessoryType = this._accessoryTypePicker.selectedItem as String;
		}

		private function accessoryPositionPicker_changeHandler(event:Event):void
		{
			this.settings.accessoryPosition = this._accessoryPositionPicker.selectedItem as String;
		}

		private function accessoryGapPicker_changeHandler(event:Event):void
		{
			this.settings.useInfiniteAccessoryGap = this._accessoryGapPicker.selectedIndex == 0;
		}

		private function layoutOrderPicker_changeHandler(event:Event):void
		{
			this.settings.layoutOrder = this._layoutOrderPicker.selectedItem as String;
		}

		private function horizontalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.horizontalAlign = this._horizontalAlignPicker.selectedItem as String;
		}

		private function verticalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.verticalAlign = this._verticalAlignPicker.selectedItem as String;
		}

		private function doneButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/LabelScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.Label;
	import feathers.controls.PanelScreen;
	import feathers.controls.ScrollPolicy;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class LabelScreen extends PanelScreen
	{
		public function LabelScreen()
		{
			super();
		}

		private var _normalLabel:Label;
		private var _disabledLabel:Label;
		private var _headingLabel:Label;
		private var _detailLabel:Label;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Label";
			
			var verticalLayout:VerticalLayout = new VerticalLayout();
			verticalLayout.horizontalAlign = HorizontalAlign.JUSTIFY;
			verticalLayout.verticalAlign = VerticalAlign.TOP;
			verticalLayout.padding = 12;
			verticalLayout.gap = 8;
			this.layout = verticalLayout;

			this.verticalScrollPolicy = ScrollPolicy.ON;

			this._normalLabel = new Label();
			this._normalLabel.text = "This is a normal label.";
			this.addChild(this._normalLabel);

			this._disabledLabel = new Label();
			this._disabledLabel.text = "A label may be disabled.";
			this._disabledLabel.isEnabled = false;
			this.addChild(this._disabledLabel);

			this._headingLabel = new Label();
			this._headingLabel.styleNameList.add(Label.ALTERNATE_STYLE_NAME_HEADING);
			this._headingLabel.text = "A heading label is for larger, more important text.";
			this._headingLabel.wordWrap = true;
			this.addChild(this._headingLabel);

			this._detailLabel = new Label();
			this._detailLabel.styleNameList.add(Label.ALTERNATE_STYLE_NAME_DETAIL);
			this._detailLabel.text = "While a detail label is for smaller, less important text.";
			this._detailLabel.wordWrap = true;
			this.addChild(this._detailLabel);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/ListScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ArrayCollection;
	import feathers.events.FeathersEventType;
	import feathers.examples.componentsExplorer.data.ListSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]
	[Event(name="showSettings",type="starling.events.Event")]

	public class ListScreen extends PanelScreen
	{
		public static const SHOW_SETTINGS:String = "showSettings";

		public function ListScreen()
		{
			super();
		}

		public var settings:ListSettings;

		private var _list:List;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "List";

			this.layout = new AnchorLayout();

			var items:Array = [];
			for(var i:int = 0; i < 150; i++)
			{
				var item:Object = {text: "Item " + (i + 1).toString()};
				items[i] = item;
			}
			items.fixed = true;

			this._list = new List();
			this._list.dataProvider = new ArrayCollection(items);
			this._list.typicalItem = {text: "Item 1000"};
			this._list.isSelectable = this.settings.isSelectable;
			this._list.allowMultipleSelection = this.settings.allowMultipleSelection;
			this._list.hasElasticEdges = this.settings.hasElasticEdges;
			//optimization: since this list fills the entire screen, there's no
			//need for clipping. clipping should not be disabled if there's a
			//chance that item renderers could be visible if they appear outside
			//the list's bounds
			this._list.clipContent = false;
			//optimization: when the background is covered by all item
			//renderers, don't render it
			this._list.autoHideBackground = true;
			this._list.itemRendererFactory = function():IListItemRenderer
			{
				var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();

				//enable the quick hit area to optimize hit tests when an item
				//is only selectable and doesn't have interactive children.
				renderer.isQuickHitAreaEnabled = true;

				renderer.labelField = "text";
				return renderer;
			};
			this._list.addEventListener(Event.CHANGE, list_changeHandler);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}

			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			var settingsButton:Button = new Button();
			settingsButton.label = "Settings";
			settingsButton.addEventListener(Event.TRIGGERED, settingsButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				settingsButton
			];
			return header;
		}
		
		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function transitionInCompleteHandler(event:Event):void
		{
			this._list.revealScrollBars();
		}
		
		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function settingsButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(SHOW_SETTINGS);
		}

		private function list_changeHandler(event:Event):void
		{
			var selectedIndices:Vector.<int> = this._list.selectedIndices;
			trace("List change:", selectedIndices.length > 0 ? selectedIndices : this._list.selectedIndex);
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/ListSettingsScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.ToggleSwitch;
	import feathers.data.ArrayCollection;
	import feathers.examples.componentsExplorer.data.ListSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;

	import starling.events.Event;
	import feathers.controls.Button;
	import starling.display.DisplayObject;

	[Event(name="complete",type="starling.events.Event")]

	public class ListSettingsScreen extends PanelScreen
	{
		public function ListSettingsScreen()
		{
			super();
		}

		public var settings:ListSettings;

		private var _list:List;

		private var _isSelectableToggle:ToggleSwitch;
		private var _allowMultipleSelectionToggle:ToggleSwitch;
		private var _hasElasticEdgesToggle:ToggleSwitch;

		override public function dispose():void
		{
			//icon and accessory display objects in the list's data provider
			//won't be automatically disposed because feathers cannot know if
			//they need to be used again elsewhere or not. we need to dispose
			//them manually.
			this._list.dataProvider.dispose(disposeItemAccessory);

			//never forget to call super.dispose() because you don't want to
			//create a memory leak!
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "List Settings";

			this.layout = new AnchorLayout();

			this._isSelectableToggle = new ToggleSwitch();
			this._isSelectableToggle.isSelected = this.settings.isSelectable;
			this._isSelectableToggle.addEventListener(Event.CHANGE, isSelectableToggle_changeHandler);

			this._allowMultipleSelectionToggle = new ToggleSwitch();
			this._allowMultipleSelectionToggle.isSelected = this.settings.allowMultipleSelection;
			this._allowMultipleSelectionToggle.addEventListener(Event.CHANGE, allowMultipleSelectionToggle_changeHandler);

			this._hasElasticEdgesToggle = new ToggleSwitch();
			this._hasElasticEdgesToggle.isSelected = this.settings.hasElasticEdges;
			this._hasElasticEdgesToggle.addEventListener(Event.CHANGE, hasElasticEdgesToggle_changeHandler);

			this._list = new List();
			this._list.isSelectable = false;
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "isSelectable", accessory: this._isSelectableToggle },
				{ label: "allowMultipleSelection", accessory: this._allowMultipleSelectionToggle },
				{ label: "hasElasticEdges", accessory: this._hasElasticEdgesToggle },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.clipContent = false;
			this._list.autoHideBackground = true;
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = this.onBackButton;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			var doneButton:Button = new Button();
			doneButton.label = "Done";
			doneButton.addEventListener(Event.TRIGGERED, doneButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				doneButton
			];
			return header;
		}

		private function disposeItemAccessory(item:Object):void
		{
			DisplayObject(item.accessory).dispose();
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function doneButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function isSelectableToggle_changeHandler(event:Event):void
		{
			this.settings.isSelectable = this._isSelectableToggle.isSelected;
		}

		private function allowMultipleSelectionToggle_changeHandler(event:Event):void
		{
			this.settings.allowMultipleSelection = this._allowMultipleSelectionToggle.isSelected;
		}

		private function hasElasticEdgesToggle_changeHandler(event:Event):void
		{
			this.settings.hasElasticEdges = this._hasElasticEdgesToggle.isSelected;
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/MainMenuScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ArrayCollection;
	import feathers.events.FeathersEventType;
	import feathers.examples.componentsExplorer.ScreenID;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.system.DeviceCapabilities;

	import flash.system.Capabilities;

	import starling.core.Starling;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]
	[Event(name="change",type="starling.events.Event")]

	public class MainMenuScreen extends PanelScreen
	{
		public function MainMenuScreen()
		{
			super();
		}

		private var _list:List;

		public var savedVerticalScrollPosition:Number = 0;
		public var savedSelectedIndex:int = -1;

		private var _selectedScreenID:String = null;

		public function get selectedScreenID():String
		{
			return this._selectedScreenID;
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Feathers";

			this.layout = new AnchorLayout();

			this._list = new List();
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Alert", screen: ScreenID.ALERT },
				{ label: "Auto-complete", screen: ScreenID.AUTO_COMPLETE },
				{ label: "Button", screen: ScreenID.BUTTON },
				{ label: "Button Group", screen: ScreenID.BUTTON_GROUP },
				{ label: "Callout", screen: ScreenID.CALLOUT },
				{ label: "Check", screen: ScreenID.CHECK },
				{ label: "Data Grid", screen: ScreenID.DATA_GRID },
				{ label: "Date Time Spinner", screen: ScreenID.DATE_TIME_SPINNER },
				{ label: "Grouped List", screen: ScreenID.GROUPED_LIST },
				{ label: "Item Renderer", screen: ScreenID.ITEM_RENDERER },
				{ label: "Label", screen: ScreenID.LABEL },
				{ label: "List", screen: ScreenID.LIST },
				{ label: "Numeric Stepper", screen: ScreenID.NUMERIC_STEPPER },
				{ label: "Page Indicator", screen: ScreenID.PAGE_INDICATOR },
				{ label: "Panel", screen: ScreenID.PANEL },
				{ label: "Picker List", screen: ScreenID.PICKER_LIST },
				{ label: "Progress Bar", screen: ScreenID.PROGRESS_BAR },
				{ label: "Radio", screen: ScreenID.RADIO },
				{ label: "Scroll Text", screen: ScreenID.SCROLL_TEXT },
				{ label: "Slider", screen: ScreenID.SLIDER},
				{ label: "Spinner List", screen: ScreenID.SPINNER_LIST },
				{ label: "Tab Bar", screen: ScreenID.TAB_BAR },
				{ label: "Text Callout", screen: ScreenID.TEXT_CALLOUT },
				{ label: "Text Input and Text Area", screen: ScreenID.TEXT_INPUT },
				{ label: "Toast", screen: ScreenID.TOAST },
				{ label: "Toggle Switch", screen: ScreenID.TOGGLES },
				{ label: "Tree", screen: ScreenID.TREE },
			]);
			if(Capabilities.playerType == "Desktop") //this means AIR, even for mobile
			{
				this._list.dataProvider.addItem( { label: "Web View", screen: ScreenID.WEB_VIEW } );
			}
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.clipContent = false;
			this._list.autoHideBackground = true;
			this._list.verticalScrollPosition = this.savedVerticalScrollPosition;

			this._list.itemRendererFactory = this.createItemRenderer;

			var isTablet:Boolean = DeviceCapabilities.isTablet(Starling.current.nativeStage);
			if(isTablet)
			{
				this._list.addEventListener(Event.CHANGE, list_changeHandler);
				this._list.selectedIndex = 0;
				this._list.revealScrollBars();
			}
			else
			{
				this._list.selectedIndex = this.savedSelectedIndex;
				this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
			}
			this.addChild(this._list);
		}
		
		private function createItemRenderer():IListItemRenderer
		{
			var isTablet:Boolean = DeviceCapabilities.isTablet(Starling.current.nativeStage);
			
			var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();
			if(!isTablet)
			{
				renderer.styleNameList.add(DefaultListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN);
			}

			//enable the quick hit area to optimize hit tests when an item
			//is only selectable and doesn't have interactive children.
			renderer.isQuickHitAreaEnabled = true;

			renderer.labelField = "label";
			return renderer;
		}
		
		private function transitionInCompleteHandler(event:Event):void
		{
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this._list.selectedIndex = -1;
				this._list.addEventListener(Event.CHANGE, list_changeHandler);
			}
			this._list.revealScrollBars();
		}
		
		private function list_changeHandler(event:Event):void
		{
			this._selectedScreenID = this._list.selectedItem.screen as String;
			if(DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.dispatchEventWith(Event.CHANGE);
				return;
			}

			//save the list's scroll position and selected index so that we
			//can restore some context when this screen when we return to it
			//again later.
			this.dispatchEventWith(Event.CHANGE, false,
			{
				savedVerticalScrollPosition: this._list.verticalScrollPosition,
				savedSelectedIndex: this._list.selectedIndex
			});
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/NumericStepperScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.NumericStepper;
	import feathers.controls.PanelScreen;
	import feathers.examples.componentsExplorer.data.NumericStepperSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]
	[Event(name="showSettings",type="starling.events.Event")]

	public class NumericStepperScreen extends PanelScreen
	{
		public static const SHOW_SETTINGS:String = "showSettings";

		public function NumericStepperScreen()
		{
			super();
		}

		public var settings:NumericStepperSettings;

		private var _stepper:NumericStepper;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Numeric Stepper";

			this.layout = new AnchorLayout();

			this._stepper = new NumericStepper();
			this._stepper.minimum = 0;
			this._stepper.maximum = 100;
			this._stepper.value = 50;
			this._stepper.step = this.settings.step;
			this._stepper.addEventListener(Event.CHANGE, slider_changeHandler);
			var stepperLayoutData:AnchorLayoutData = new AnchorLayoutData();
			stepperLayoutData.horizontalCenter = 0;
			stepperLayoutData.verticalCenter = 0;
			this._stepper.layoutData = stepperLayoutData;
			this.addChild(this._stepper);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			var settingsButton:Button = new Button();
			settingsButton.label = "Settings";
			settingsButton.addEventListener(Event.TRIGGERED, settingsButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				settingsButton
			];
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function slider_changeHandler(event:Event):void
		{
			trace("numeric stepper change:", this._stepper.value);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function settingsButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(SHOW_SETTINGS);
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/NumericStepperSettingsScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.NumericStepper;
	import feathers.controls.PanelScreen;
	import feathers.data.ArrayCollection;
	import feathers.examples.componentsExplorer.data.NumericStepperSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;

	import starling.events.Event;
	import feathers.controls.Button;
	import starling.display.DisplayObject;

	[Event(name="complete",type="starling.events.Event")]

	public class NumericStepperSettingsScreen extends PanelScreen
	{
		public function NumericStepperSettingsScreen()
		{
			super();
		}

		public var settings:NumericStepperSettings;

		private var _list:List;
		private var _stepStepper:NumericStepper;

		override public function dispose():void
		{
			//icon and accessory display objects in the list's data provider
			//won't be automatically disposed because feathers cannot know if
			//they need to be used again elsewhere or not. we need to dispose
			//them manually.
			this._list.dataProvider.dispose(disposeItemAccessory);

			//never forget to call super.dispose() because you don't want to
			//create a memory leak!
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Numeric Stepper Settings";

			this.layout = new AnchorLayout();

			this._stepStepper = new NumericStepper();
			this._stepStepper.minimum = 1;
			this._stepStepper.maximum = 20;
			this._stepStepper.step = 1;
			this._stepStepper.value = this.settings.step;
			this._stepStepper.addEventListener(Event.CHANGE, stepStepper_changeHandler);

			this._list = new List();
			this._list.isSelectable = false;
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "step", accessory: this._stepStepper },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.clipContent = false;
			this._list.autoHideBackground = true;
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = this.onBackButton;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			var doneButton:Button = new Button();
			doneButton.label = "Done";
			doneButton.addEventListener(Event.TRIGGERED, doneButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				doneButton
			];
			return header;
		}

		private function disposeItemAccessory(item:Object):void
		{
			DisplayObject(item.accessory).dispose();
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function stepStepper_changeHandler(event:Event):void
		{
			this.settings.step = this._stepStepper.value;
		}

		private function doneButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/PageIndicatorScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PageIndicator;
	import feathers.controls.PanelScreen;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class PageIndicatorScreen extends PanelScreen
	{
		public function PageIndicatorScreen()
		{
			super();
		}

		private var _pageIndicator:PageIndicator;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Page Indicator";

			this.layout = new AnchorLayout();

			this._pageIndicator = new PageIndicator();
			this._pageIndicator.pageCount = 5;
			this._pageIndicator.addEventListener(Event.CHANGE, pageIndicator_changeHandler);
			var pageIndicatorLayoutData:AnchorLayoutData = new AnchorLayoutData();
			pageIndicatorLayoutData.left = 0;
			pageIndicatorLayoutData.right = 0;
			pageIndicatorLayoutData.verticalCenter = 0;
			this._pageIndicator.layoutData = pageIndicatorLayoutData;
			this.addChild(this._pageIndicator);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function pageIndicator_changeHandler(event:Event):void
		{
			trace("page indicator change:", this._pageIndicator.selectedIndex);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/PanelComponentScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.Label;
	import feathers.controls.Panel;
	import feathers.controls.PanelScreen;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class PanelComponentScreen extends PanelScreen
	{
		public function PanelComponentScreen()
		{
			super();
		}

		private var _panel:Panel;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Panel";

			this.layout = new AnchorLayout();

			this._panel = new Panel();
			this._panel.title = "Title";
			this._panel.width = 200;
			this._panel.height = 150;

			//how the component is positioned in its parent's layout
			var panelLayoutData:AnchorLayoutData = new AnchorLayoutData();
			panelLayoutData.horizontalCenter = 0;
			panelLayoutData.verticalCenter = 0;
			this._panel.layoutData = panelLayoutData;

			//the panel's own internal layout
			var panelLayout:VerticalLayout = new VerticalLayout();
			panelLayout.horizontalAlign = HorizontalAlign.CENTER;
			panelLayout.verticalAlign = VerticalAlign.MIDDLE;
			this._panel.layout = panelLayout;

			this.addChild(this._panel);

			var content:Label = new Label();
			content.text = "This is the Panel's content.";
			content.wordWrap = true;
			this._panel.addChild(content);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/PickerListScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.controls.SpinnerList;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ArrayCollection;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class PickerListScreen extends PanelScreen
	{
		public function PickerListScreen()
		{
			super();
		}

		private var _list:PickerList;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Picker List";

			this.layout = new AnchorLayout();

			var items:Array = [];
			for(var i:int = 0; i < 150; i++)
			{
				var item:Object = {text: "Item " + (i + 1).toString()};
				items[i] = item;
			}
			items.fixed = true;

			this._list = new PickerList();
			this._list.prompt = "Select an Item";
			this._list.dataProvider = new ArrayCollection(items);
			//normally, the first item is selected, but let's show the prompt
			this._list.selectedIndex = -1;
			var listLayoutData:AnchorLayoutData = new AnchorLayoutData();
			listLayoutData.horizontalCenter = 0;
			listLayoutData.verticalCenter = 0;
			this._list.layoutData = listLayoutData;
			this._list.addEventListener(Event.CHANGE, pickerList_changeHandler);
			this.addChildAt(this._list, 0);

			//the typical item helps us set an ideal width for the button
			//if we don't use a typical item, the button will resize to fit
			//the currently selected item.
			this._list.typicalItem = { text: "Select an Item" };
			this._list.labelField = "text";

			this._list.listFactory = function():List
			{
				var list:List;
				if(DeviceCapabilities.isPhone(Starling.current.nativeStage))
				{
					list = new SpinnerList();
				}
				else
				{
					list = new List();
				}
				//notice that we're setting typicalItem on the list separately. we
				//may want to have the list measure at a different width, so it
				//might need a different typical item than the picker list's button.
				list.typicalItem = { text: "Item 1000" };
				list.itemRendererFactory = function():IListItemRenderer
				{
					var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();
					//notice that we're setting labelField on the item renderers
					//separately. the default item renderer has a labelField property,
					//but a custom item renderer may not even have a label, so
					//PickerList cannot simply pass its labelField down to item
					//renderers automatically
					renderer.labelField = "text";
					return renderer;
				};
				return list;
			};

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}
		
		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}
		
		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
		
		private function pickerList_changeHandler(event:Event):void
		{
			trace("PickerList change:", this._list.selectedIndex);
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/ProgressBarScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.controls.ProgressBar;
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.VerticalAlign;
	import feathers.system.DeviceCapabilities;

	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class ProgressBarScreen extends PanelScreen
	{
		public function ProgressBarScreen()
		{
			super();
		}

		private var _horizontalProgress:ProgressBar;
		private var _verticalProgress:ProgressBar;

		private var _horizontalProgressTween:Tween;
		private var _verticalProgressTween:Tween;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Progress Bar";
			
			var layout:HorizontalLayout = new HorizontalLayout();
			layout.horizontalAlign = HorizontalAlign.CENTER;
			layout.verticalAlign = VerticalAlign.MIDDLE;
			layout.padding = 12;
			layout.gap = 12;
			this.layout = layout;

			this._horizontalProgress = new ProgressBar();
			this._horizontalProgress.direction = Direction.HORIZONTAL;
			this._horizontalProgress.minimum = 0;
			this._horizontalProgress.maximum = 1;
			this._horizontalProgress.value = 0;
			this.addChild(this._horizontalProgress);

			this._verticalProgress = new ProgressBar();
			this._verticalProgress.direction = Direction.VERTICAL;
			this._verticalProgress.minimum = 0;
			this._verticalProgress.maximum = 100;
			this._verticalProgress.value = 0;
			this.addChild(this._verticalProgress);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}

			this._horizontalProgressTween = new Tween(this._horizontalProgress, 5);
			this._horizontalProgressTween.animate("value", 1);
			this._horizontalProgressTween.repeatCount = int.MAX_VALUE;
			Starling.juggler.add(this._horizontalProgressTween);

			this._verticalProgressTween = new Tween(this._verticalProgress, 8);
			this._verticalProgressTween.animate("value", 100);
			this._verticalProgressTween.repeatCount = int.MAX_VALUE;
			Starling.juggler.add(this._verticalProgressTween);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			if(this._horizontalProgressTween)
			{
				Starling.juggler.remove(this._horizontalProgressTween);
				this._horizontalProgressTween = null;
			}
			if(this._verticalProgressTween)
			{
				Starling.juggler.remove(this._verticalProgressTween);
				this._verticalProgressTween = null;
			}
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/RadioScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.Label;
	import feathers.controls.PanelScreen;
	import feathers.controls.Radio;
	import feathers.controls.ScrollPolicy;
	import feathers.core.ToggleGroup;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class RadioScreen extends PanelScreen
	{
		public function RadioScreen()
		{
			super();
		}

		private var _group1:ToggleGroup;
		private var _title1:Label;
		private var _radio1:Radio;
		private var _radio2:Radio;
		private var _radio3:Radio;
		private var _radio4:Radio;
		
		private var _group2:ToggleGroup;
		private var _title2:Label;
		private var _radioA:Radio;
		private var _radioB:Radio;
		private var _radioC:Radio;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Radio";

			var verticalLayout:VerticalLayout = new VerticalLayout();
			verticalLayout.horizontalAlign = HorizontalAlign.LEFT;
			verticalLayout.verticalAlign = VerticalAlign.TOP;
			verticalLayout.padding = 12;
			verticalLayout.gap = 8;
			this.layout = verticalLayout;

			this.verticalScrollPolicy = ScrollPolicy.ON;

			this._group1 = new ToggleGroup();

			this._title1 = new Label();
			this._title1.styleNameList.add(Label.ALTERNATE_STYLE_NAME_HEADING);
			this._title1.text = "Group 1";
			this.addChild(this._title1);

			this._radio1 = new Radio();
			this._radio1.label = "Option 1";
			this._radio1.toggleGroup = this._group1;
			this.addChild(this._radio1);

			this._radio2 = new Radio();
			this._radio2.label = "Option 2";
			this._radio2.isSelected = true;
			this._radio2.toggleGroup = this._group1;
			this.addChild(this._radio2);

			this._radio3 = new Radio();
			this._radio3.label = "Option 3";
			this._radio3.toggleGroup = this._group1;
			this.addChild(this._radio3);

			this._radio4 = new Radio();
			this._radio4.label = "Option 4 (Disabled)";
			this._radio4.isEnabled = false;
			this._radio4.toggleGroup = this._group1;
			this.addChild(this._radio4);

			this._group1.addEventListener(Event.CHANGE, group1_changeHandler);

			//radios may be added to different groups
			this._group2 = new ToggleGroup();

			this._title2 = new Label();
			this._title2.styleNameList.add(Label.ALTERNATE_STYLE_NAME_HEADING);
			this._title2.text = "Group 2";
			this.addChild(this._title2);

			this._radioA = new Radio();
			this._radioA.label = "Option A";
			this.addChild(this._radioA);

			this._radioB = new Radio();
			this._radioB.label = "Option B";
			this.addChild(this._radioB);

			this._radioC = new Radio();
			this._radioC.label = "Option C";
			this.addChild(this._radioC);

			this._group2.selectedItem = this._radioA;

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function group1_changeHandler(event:Event):void
		{
			trace("radio group changed:", this._group1.selectedIndex);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/ScrollTextScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.controls.ScrollText;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class ScrollTextScreen extends PanelScreen
	{
		public function ScrollTextScreen()
		{
			super();
		}

		private var _scrollText:ScrollText;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Scroll Text";

			this.layout = new AnchorLayout();

			this._scrollText = new ScrollText();
			this._scrollText.text = "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.\n\nSed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium, totam rem aperiam, eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo. Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt.\n\nNeque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit, sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam, quis nostrum exercitationem ullam corporis suscipit laboriosam, nisi ut aliquid ex ea commodi consequatur? Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur, vel illum qui dolorem eum fugiat quo voluptas nulla pariatur?\n\nAt vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati cupiditate non provident, similique sunt in culpa qui officia deserunt mollitia animi, id est laborum et dolorum fuga. Et harum quidem rerum facilis est et expedita distinctio. Nam libero tempore, cum soluta nobis est eligendi optio cumque nihil impedit quo minus id quod maxime placeat facere possimus, omnis voluptas assumenda est, omnis dolor repellendus. Temporibus autem quibusdam et aut officiis debitis aut rerum necessitatibus saepe eveniet ut et voluptates repudiandae sint et molestiae non recusandae. Itaque earum rerum hic tenetur a sapiente delectus, ut aut reiciendis voluptatibus maiores alias consequatur aut perferendis doloribus asperiores repellat.\n\nDonec ultricies nibh non metus volutpat, ac gravida tellus accumsan. Sed in urna quis ante ultrices tristique non non felis. Etiam accumsan molestie felis id auctor. Aliquam suscipit finibus mollis. Etiam euismod odio massa, eu tempus neque consequat ullamcorper. Donec non dignissim metus, ut dictum erat. Sed vestibulum ut sapien vitae laoreet. Integer sollicitudin tellus vitae scelerisque aliquam. Praesent gravida, leo imperdiet vestibulum congue, felis arcu eleifend sem, nec cursus enim massa sit amet risus. Sed cursus pulvinar bibendum.\n\nVivamus nec posuere nunc. Quisque consequat nisi sem, a mattis nisi sagittis ac. Donec efficitur, dui in tincidunt mollis, sapien eros pharetra nibh, quis malesuada mauris velit quis mauris. Nunc eget fermentum tellus. Integer a mi neque. Suspendisse ut cursus mi. Nam tempus interdum felis vel rutrum. Sed quis pharetra mauris, id faucibus quam. Nunc vehicula ullamcorper nisl, non interdum massa scelerisque nec. Proin suscipit rhoncus enim sed tristique.\n\nProin id erat nunc. Sed rutrum tortor in tempor vehicula. Integer et imperdiet odio, sed viverra diam. Pellentesque et commodo lectus, vitae tempus tortor. Quisque purus justo, pharetra ac est molestie, finibus aliquam dui. Vestibulum sodales hendrerit nibh, quis venenatis lorem dictum in. Sed volutpat bibendum eros id vulputate. Curabitur lobortis, tellus a aliquet aliquet, nunc risus aliquet arcu, at ullamcorper ligula tortor vel nulla. Duis sit amet odio pharetra, sodales magna ac, eleifend magna. Curabitur fringilla nec urna vel ultricies.\n\nNunc vel consequat dolor. Quisque nec pretium arcu, faucibus efficitur tortor. Etiam sapien dui, vulputate et libero sollicitudin, consectetur iaculis quam. Nulla eget odio vehicula, vehicula libero sed, tristique lectus. Aliquam in mollis ante, ac molestie risus. Nam faucibus urna at dui varius, sed elementum diam convallis. Nullam ut suscipit diam.\n\nCras tempus faucibus dolor id accumsan. Integer lobortis rutrum vulputate. Nullam porttitor nisi dapibus, tincidunt ante eu, gravida mi. Cras efficitur, magna vitae pulvinar dictum, mauris libero laoreet est, quis volutpat nibh libero a felis. Nunc fringilla dignissim mauris, et aliquam elit molestie ac. Nunc sit amet dignissim nunc. Cras accumsan mauris augue, eget laoreet erat tincidunt in. Phasellus rutrum turpis eget ligula tristique consequat. Maecenas volutpat consectetur purus a ultricies. Sed auctor pulvinar sem, eget fringilla purus consequat sit amet. In hac habitasse platea dictumst. Fusce lobortis vehicula aliquam. Phasellus ornare, est at condimentum consequat, elit ipsum hendrerit est, in rhoncus mauris dui nec quam.";
			this._scrollText.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this.addChild(this._scrollText);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/SliderScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.controls.Slider;
	import feathers.examples.componentsExplorer.data.SliderSettings;
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.VerticalAlign;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]
	[Event(name="showSettings",type="starling.events.Event")]

	public class SliderScreen extends PanelScreen
	{
		public static const SHOW_SETTINGS:String = "showSettings";

		public function SliderScreen()
		{
			super();
		}

		public var settings:SliderSettings;

		private var _horizontalSlider:Slider;
		private var _verticalSlider:Slider;
		
		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Slider";
			
			var layout:HorizontalLayout = new HorizontalLayout();
			layout.horizontalAlign = HorizontalAlign.CENTER;
			layout.verticalAlign = VerticalAlign.MIDDLE;
			layout.padding = 12;
			layout.gap = 12;
			this.layout = layout;

			this._horizontalSlider = new Slider();
			this._horizontalSlider.direction = Direction.HORIZONTAL;
			this._horizontalSlider.minimum = 0;
			this._horizontalSlider.maximum = 100;
			this._horizontalSlider.value = 50;
			this._horizontalSlider.step = this.settings.step;
			this._horizontalSlider.page = this.settings.page;
			this._horizontalSlider.liveDragging = this.settings.liveDragging;
			this._horizontalSlider.trackInteractionMode = this.settings.trackInteractionMode;
			this._horizontalSlider.addEventListener(Event.CHANGE, horizontalSlider_changeHandler);
			this.addChild(this._horizontalSlider);

			this._verticalSlider = new Slider();
			this._verticalSlider.direction = Direction.VERTICAL;
			this._verticalSlider.minimum = 0;
			this._verticalSlider.maximum = 100;
			this._verticalSlider.value = 50;
			this._verticalSlider.step = this.settings.step;
			this._verticalSlider.page = this.settings.page;
			this._verticalSlider.liveDragging = this.settings.liveDragging;
			this._verticalSlider.trackInteractionMode = this.settings.trackInteractionMode;
			this.addChild(this._verticalSlider);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}

			var settingsButton:Button = new Button();
			settingsButton.label = "Settings";
			settingsButton.addEventListener(Event.TRIGGERED, settingsButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				settingsButton
			];
			return header;
		}
		
		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}
		
		private function horizontalSlider_changeHandler(event:Event):void
		{
			trace("horizontal slider change:", this._horizontalSlider.value.toString());
		}
		
		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function settingsButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(SHOW_SETTINGS);
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/SliderSettingsScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.NumericStepper;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.controls.ToggleSwitch;
	import feathers.controls.TrackInteractionMode;
	import feathers.data.ArrayCollection;
	import feathers.examples.componentsExplorer.data.SliderSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;

	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class SliderSettingsScreen extends PanelScreen
	{
		public function SliderSettingsScreen()
		{
			super();
		}

		public var settings:SliderSettings;

		private var _list:List;
		private var _liveDraggingToggle:ToggleSwitch;
		private var _stepStepper:NumericStepper;
		private var _pageStepper:NumericStepper;
		private var _trackInteractionModePicker:PickerList;

		override public function dispose():void
		{
			//icon and accessory display objects in the list's data provider
			//won't be automatically disposed because feathers cannot know if
			//they need to be used again elsewhere or not. we need to dispose
			//them manually.
			this._list.dataProvider.dispose(disposeItemAccessory);

			//never forget to call super.dispose() because you don't want to
			//create a memory leak!
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Slider Settings";

			this.layout = new AnchorLayout();

			this._liveDraggingToggle = new ToggleSwitch();
			this._liveDraggingToggle.isSelected = this.settings.liveDragging;
			this._liveDraggingToggle.addEventListener(Event.CHANGE, liveDraggingToggle_changeHandler);

			this._stepStepper = new NumericStepper();
			this._stepStepper.minimum = 1;
			this._stepStepper.maximum = 20;
			this._stepStepper.step = 1;
			this._stepStepper.value = this.settings.step;
			this._stepStepper.addEventListener(Event.CHANGE, stepStepper_changeHandler);

			this._trackInteractionModePicker = new PickerList();
			this._trackInteractionModePicker.typicalItem = TrackInteractionMode.TO_VALUE;
			this._trackInteractionModePicker.dataProvider = new ArrayCollection(
			[
				TrackInteractionMode.TO_VALUE,
				TrackInteractionMode.BY_PAGE,
			]);
			this._trackInteractionModePicker.selectedItem = this.settings.trackInteractionMode;
			this._trackInteractionModePicker.addEventListener(Event.CHANGE, trackInteractionModePicker_changeHandler);

			this._pageStepper = new NumericStepper();
			this._pageStepper.minimum = 1;
			this._pageStepper.maximum = 20;
			this._pageStepper.step = 1;
			this._pageStepper.value = this.settings.page;
			this._pageStepper.addEventListener(Event.CHANGE, pageStepper_changeHandler);

			this._list = new List();
			this._list.isSelectable = false;
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "liveDragging", accessory: this._liveDraggingToggle },
				{ label: "step", accessory: this._stepStepper },
				{ label: "trackInteractionMode", accessory: this._trackInteractionModePicker },
				{ label: "page", accessory: this._pageStepper },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.clipContent = false;
			this._list.autoHideBackground = true;
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = this.onBackButton;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			var doneButton:Button = new Button();
			doneButton.label = "Done";
			doneButton.addEventListener(Event.TRIGGERED, doneButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				doneButton
			];
			return header;
		}

		private function disposeItemAccessory(item:Object):void
		{
			DisplayObject(item.accessory).dispose();
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function liveDraggingToggle_changeHandler(event:Event):void
		{
			this.settings.liveDragging = this._liveDraggingToggle.isSelected;
		}

		private function stepStepper_changeHandler(event:Event):void
		{
			this.settings.step = this._stepStepper.value;
		}

		private function pageStepper_changeHandler(event:Event):void
		{
			this.settings.page = this._pageStepper.value;
		}

		private function trackInteractionModePicker_changeHandler(event:Event):void
		{
			this.settings.trackInteractionMode = this._trackInteractionModePicker.selectedItem as String;
		}

		private function doneButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/SpinnerListScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.controls.SpinnerList;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ArrayCollection;
	import feathers.events.FeathersEventType;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class SpinnerListScreen extends PanelScreen
	{
		public function SpinnerListScreen()
		{
			super();
		}

		private var _list:SpinnerList;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Spinner List";

			this.layout = new AnchorLayout();

			this._list = new SpinnerList();
			this._list.dataProvider = new ArrayCollection(
			[
				{ text: "Aardvark" },
				{ text: "Alligator" },
				{ text: "Alpaca" },
				{ text: "Anteater" },
				{ text: "Baboon" },
				{ text: "Bear" },
				{ text: "Beaver" },
				{ text: "Canary" },
				{ text: "Cat" },
				{ text: "Deer" },
				{ text: "Dingo" },
				{ text: "Dog" },
				{ text: "Dolphin" },
				{ text: "Donkey" },
				{ text: "Dragonfly" },
				{ text: "Duck" },
				{ text: "Dung Beetle" },
				{ text: "Eagle" },
				{ text: "Earthworm" },
				{ text: "Eel" },
				{ text: "Elk" },
				{ text: "Fox" },
			]);
			this._list.typicalItem = {text: "Item 1000"};
			this._list.itemRendererFactory = function():IListItemRenderer
			{
				var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();

				//enable the quick hit area to optimize hit tests when an item
				//is only selectable and doesn't have interactive children.
				renderer.isQuickHitAreaEnabled = true;

				renderer.labelField = "text";
				return renderer;
			};
			this._list.addEventListener(Event.CHANGE, list_changeHandler);

			var listLayoutData:AnchorLayoutData = new AnchorLayoutData();
			listLayoutData.left = 0;
			listLayoutData.right = 0;
			listLayoutData.verticalCenter = 0;
			this._list.layoutData = listLayoutData;

			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}

			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function transitionInCompleteHandler(event:Event):void
		{
			this._list.revealScrollBars();
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function list_changeHandler(event:Event):void
		{
			trace("SpinnerList change:", this._list.selectedIndex);
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/TabBarScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.Label;
	import feathers.controls.PanelScreen;
	import feathers.controls.TabBar;
	import feathers.data.ArrayCollection;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class TabBarScreen extends PanelScreen
	{
		public function TabBarScreen()
		{
			super();
		}

		private var _tabBar:TabBar;
		private var _label:Label;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Tab Bar";

			this.layout = new AnchorLayout();

			this._tabBar = new TabBar();
			this._tabBar.dataProvider = new ArrayCollection(
			[
				{ label: "One" },
				{ label: "Two" },
				{ label: "Three" },
				{ label: "Disabled", isEnabled: false },
			]);
			this._tabBar.addEventListener(Event.CHANGE, tabBar_changeHandler);
			this._tabBar.layoutData = new AnchorLayoutData(NaN, 0, 0, 0);
			this.addChild(this._tabBar);

			this._label = new Label();
			this._label.text = "selectedIndex: " + this._tabBar.selectedIndex.toString();
			var labelLayoutData:AnchorLayoutData = new AnchorLayoutData();
			labelLayoutData.horizontalCenter = 0;
			labelLayoutData.verticalCenter = 0;
			this._label.layoutData = labelLayoutData;
			this.addChild(DisplayObject(this._label));

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function tabBar_changeHandler(event:Event):void
		{
			this._label.text = "selectedIndex: " + this._tabBar.selectedIndex.toString();
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/TextCalloutScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.controls.TextCallout;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.RelativePosition;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class TextCalloutScreen extends PanelScreen
	{
		private static const MESSAGE:String = "Thank you for trying Feathers.\nHappy coding.";

		public function TextCalloutScreen()
		{
			super();
		}

		private var _rightButton:Button;
		private var _bottomButton:Button;
		private var _topButton:Button;
		private var _leftButton:Button;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = " Text Callout";

			this.layout = new AnchorLayout();
			
			this._rightButton = new Button();
			this._rightButton.label = "Right";
			this._rightButton.addEventListener(Event.TRIGGERED, rightButton_triggeredHandler);
			var rightButtonLayoutData:AnchorLayoutData = new AnchorLayoutData();
			rightButtonLayoutData.top = 12;
			rightButtonLayoutData.left = 12;
			this._rightButton.layoutData = rightButtonLayoutData;
			this.addChild(this._rightButton);

			this._bottomButton = new Button();
			this._bottomButton.label = "Bottom";
			this._bottomButton.addEventListener(Event.TRIGGERED, bottomButton_triggeredHandler);
			var bottomButtonLayoutData:AnchorLayoutData = new AnchorLayoutData();
			bottomButtonLayoutData.top = 12;
			bottomButtonLayoutData.right = 12;
			this._bottomButton.layoutData = bottomButtonLayoutData;
			this.addChild(this._bottomButton);

			this._topButton = new Button();
			this._topButton.label = "Top";
			this._topButton.addEventListener(Event.TRIGGERED, topButton_triggeredHandler);
			var topButtonLayoutData:AnchorLayoutData = new AnchorLayoutData();
			topButtonLayoutData.bottom = 12;
			topButtonLayoutData.left = 12;
			this._topButton.layoutData = topButtonLayoutData;
			this.addChild(this._topButton);

			this._leftButton = new Button();
			this._leftButton.label = "Left";
			this._leftButton.addEventListener(Event.TRIGGERED, leftButton_triggeredHandler);
			var leftButtonLayoutData:AnchorLayoutData = new AnchorLayoutData();
			leftButtonLayoutData.bottom = 12;
			leftButtonLayoutData.right = 12;
			this._leftButton.layoutData = leftButtonLayoutData;
			this.addChild(this._leftButton);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function rightButton_triggeredHandler(event:Event):void
		{
			TextCallout.show(MESSAGE, this._rightButton, new <String>[RelativePosition.RIGHT]);
		}

		private function bottomButton_triggeredHandler(event:Event):void
		{
			TextCallout.show(MESSAGE, this._bottomButton, new <String>[RelativePosition.BOTTOM]);
		}

		private function topButton_triggeredHandler(event:Event):void
		{
			TextCallout.show(MESSAGE, this._topButton, new <String>[RelativePosition.TOP]);
		}

		private function leftButton_triggeredHandler(event:Event):void
		{
			TextCallout.show(MESSAGE, this._leftButton, new <String>[RelativePosition.LEFT]);
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/TextInputScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.controls.ScrollPolicy;
	import feathers.controls.TextArea;
	import feathers.controls.TextInput;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class TextInputScreen extends PanelScreen
	{
		public function TextInputScreen()
		{
		}

		private var _input:TextInput;
		private var _disabledInput:TextInput;
		private var _passwordInput:TextInput;
		private var _errorInput:TextInput;
		private var _notEditableInput:TextInput;
		private var _searchInput:TextInput;
		private var _textArea:TextArea;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Text Input";

			var verticalLayout:VerticalLayout = new VerticalLayout();
			verticalLayout.horizontalAlign = HorizontalAlign.CENTER;
			verticalLayout.verticalAlign = VerticalAlign.TOP;
			verticalLayout.padding = 12;
			verticalLayout.gap = 8;
			this.layout = verticalLayout;

			this.verticalScrollPolicy = ScrollPolicy.ON;

			this._input = new TextInput();
			this._input.prompt = "Normal Text Input";
			this.addChild(this._input);

			this._disabledInput = new TextInput();
			this._disabledInput.prompt = "Disabled Input";
			this._disabledInput.isEnabled = false;
			this.addChild(this._disabledInput);

			this._searchInput = new TextInput();
			this._searchInput.styleNameList.add(TextInput.ALTERNATE_STYLE_NAME_SEARCH_TEXT_INPUT);
			this._searchInput.prompt = "Search Input";
			this.addChild(this._searchInput);

			this._passwordInput = new TextInput();
			this._passwordInput.prompt = "Password Input";
			this._passwordInput.displayAsPassword = true;
			this.addChild(this._passwordInput);

			this._errorInput = new TextInput();
			this._errorInput.prompt = "Error Input";
			this._errorInput.errorString = "Oh, no! It's an error!";
			this.addChild(this._errorInput);

			this._notEditableInput = new TextInput();
			this._notEditableInput.text = "Not Editable";
			this._notEditableInput.isEditable = false;
			this.addChild(this._notEditableInput);

			//note: using TextArea on mobile generally isn't recommended.
			//consider TextInput with a multiline StageTextTextEditor instead.
			this._textArea = new TextArea();
			this.addChild(this._textArea);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/ToastScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Alert;
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.data.ArrayCollection;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;

	import starling.events.Event;
	import feathers.system.DeviceCapabilities;
	import starling.core.Starling;
	import starling.display.DisplayObject;
	import feathers.controls.Toast;
	import feathers.controls.ButtonGroup;

	public class ToastScreen extends PanelScreen
	{
		public function ToastScreen()
		{
			super();
		}

		private var _showToastButtons:ButtonGroup;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Toast";

			this.layout = new AnchorLayout();

			this._showToastButtons = new ButtonGroup();
			this._showToastButtons.dataProvider = new ArrayCollection(
			[
				{ label: "Show Toast with Message", triggered: showMessageButton_triggeredHandler },
				{ label: "Show Toast with Actions", triggered: showActionsButton_triggeredHandler },
			])
			var buttonGroupLayoutData:AnchorLayoutData = new AnchorLayoutData();
			buttonGroupLayoutData.horizontalCenter = 0;
			buttonGroupLayoutData.verticalCenter = 0;
			this._showToastButtons.layoutData = buttonGroupLayoutData;
			this.addChild(this._showToastButtons);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function showMessageButton_triggeredHandler(event:Event):void
		{
			Toast.showMessage("Hi, there!");
		}

		private function showActionsButton_triggeredHandler(event:Event):void
		{
			Toast.showMessageWithActions("I have an action", new ArrayCollection(
			[
				{ label: "Neat!" }
			]));
		}

		private function alert_closeHandler(event:Event, data:Object):void
		{
			if(data)
			{
				trace("alert closed with item:", data.label);
			}
			else
			{
				trace("alert closed without item");
			}
		}
	}
}


================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/ToggleSwitchScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.controls.ToggleSwitch;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.TiledRowsLayout;
	import feathers.layout.VerticalAlign;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class ToggleSwitchScreen extends PanelScreen
	{
		public function ToggleSwitchScreen()
		{
			super();
		}

		private var _toggle:ToggleSwitch;
		private var _selected:ToggleSwitch;
		private var _disabled:ToggleSwitch;
		private var _selectedDisabled:ToggleSwitch;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Toggle Switch";
			
			var layout:TiledRowsLayout = new TiledRowsLayout();
			layout.requestedColumnCount = 2;
			layout.useSquareTiles = false;
			layout.horizontalAlign = HorizontalAlign.CENTER;
			layout.verticalAlign = VerticalAlign.TOP;
			layout.tileHorizontalAlign = HorizontalAlign.CENTER;
			layout.tileVerticalAlign = VerticalAlign.TOP;
			layout.padding = 12;
			layout.horizontalGap = 12;
			layout.verticalGap = 44;
			this.layout = layout;

			this._toggle = new ToggleSwitch();
			this._toggle.addEventListener(Event.CHANGE, toggleSwitch_changeHandler);
			this.addChild(this._toggle);

			this._selected = new ToggleSwitch();
			this._selected.isSelected = true;
			this.addChild(this._selected);

			this._disabled = new ToggleSwitch();
			this._disabled.isEnabled = false;
			this.addChild(this._disabled);

			this._selectedDisabled = new ToggleSwitch();
			this._selectedDisabled.isSelected = true;
			this._selectedDisabled.isEnabled = false;
			this.addChild(this._selectedDisabled);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function toggleSwitch_changeHandler(event:Event):void
		{
			trace("toggle switch changed:", this._toggle.isSelected);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/TreeScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.controls.Tree;
	import feathers.controls.renderers.DefaultTreeItemRenderer;
	import feathers.controls.renderers.ITreeItemRenderer;
	import feathers.data.ArrayHierarchicalCollection;
	import feathers.events.FeathersEventType;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class TreeScreen extends PanelScreen
	{
		public function TreeScreen()
		{
			super();
		}

		private var _tree:Tree;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Tree";

			this.layout = new AnchorLayout();

			var data:Array =
			[
				{
					text: "Node 1",
					children:
					[
						{
							text: "Node 1A",
							children:
							[
								{ text: "Node 1A-I" },
								{ text: "Node 1A-II" },
								{ text: "Node 1A-III" },
								{ text: "Node 1A-IV" },
							]
						},
						{ text: "Node 1B" },
						{ text: "Node 1C" },
					]
				},
				{
					text: "Node 2",
					children:
					[
						{ text: "Node 2A" },
						{ text: "Node 2B" },
						{ text: "Node 2C" },
					]
				},
				{
					text: "Node 3"
				},
				{
					text: "Node 4",
					children:
					[
						{ text: "Node 4A" },
						{ text: "Node 4B" },
						{ text: "Node 4C" },
						{ text: "Node 4D" },
						{ text: "Node 4E" },
					]
				}
			];
			
			this._tree = new Tree();
			this._tree.dataProvider = new ArrayHierarchicalCollection(data);
			this._tree.typicalItem = { text: "Item 1000" };
			//optimization: since this tree fills the entire screen, there's no
			//need for clipping. clipping should not be disabled if there's a
			//chance that item renderers could be visible if they appear outside
			//the tree's bounds
			this._tree.clipContent = false;
			//optimization: when the background is covered by all item
			//renderers, don't render it
			this._tree.autoHideBackground = true;
			this._tree.itemRendererFactory = function():ITreeItemRenderer
			{
				var renderer:DefaultTreeItemRenderer = new DefaultTreeItemRenderer();
				renderer.labelField = "text";
				return renderer;
			};
			this._tree.addEventListener(Event.CHANGE, tree_changeHandler);
			this._tree.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this.addChildAt(this._tree, 0);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}

			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}
		
		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function transitionInCompleteHandler(event:Event):void
		{
			this._tree.revealScrollBars();
		}
		
		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function tree_changeHandler(event:Event):void
		{
			trace("Tree change:", this._tree.dataProvider.getItemLocation(this._tree.selectedItem));
		}
	}
}

================================================
FILE: examples/ComponentsExplorer/source/feathers/examples/componentsExplorer/screens/WebViewScreen.as
================================================
package feathers.examples.componentsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.LayoutGroup;
	import feathers.controls.PanelScreen;
	import feathers.controls.TextInput;
	import feathers.controls.WebView;
	import feathers.events.FeathersEventType;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.HorizontalLayoutData;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class WebViewScreen extends PanelScreen
	{
		public function WebViewScreen()
		{
			super();
		}

		private var _browser:WebView;
		private var _locationInput:TextInput;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Web View";

			this.layout = new AnchorLayout();

			var items:Array = [];
			for(var i:int = 0; i < 150; i++)
			{
				var item:Object = {text: "Item " + (i + 1).toString()};
				items[i] = item;
			}
			items.fixed = true;

			this._browser = new WebView();
			this._browser.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._browser.addEventListener(FeathersEventType.LOCATION_CHANGE, webView_locationChangeHandler);
			this.addChild(this._browser);

			this.headerFactory = this.customHeaderFactory;
			this.footerFactory = this.customFooterFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}

			//with skipUnchangedFrames, we need to call setRequiresRedraw()
			//every frame
			this.addEventListener(Event.ENTER_FRAME, enterFrameHandler);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function customFooterFactory():LayoutGroup
		{
			var footer:LayoutGroup = new LayoutGroup();
			footer.styleNameList.add(LayoutGroup.ALTERNATE_STYLE_NAME_TOOLBAR);
			
			this._locationInput = new TextInput();
			this._locationInput.prompt = "Enter a website address";
			this._locationInput.layoutData = new HorizontalLayoutData(100);
			this._locationInput.addEventListener(FeathersEventType.ENTER, locationInput_enterHandler);
			footer.addChild(this._locationInput);
			
			var goButton:Button = new Button();
			goButton.label = "Go";
			goButton.addEventListener(Event.TRIGGERED, goButton_triggeredHandler);
			footer.addChild(goButton);
			
			return footer;
		}
		
		private function loadLocation():void
		{
			if(this._locationInput.text.length == 0)
			{
				return;
			}
			this._locationInput.clearFocus();
			var url:String = this._locationInput.text;
			//make sure that there's a protocol. otherwise, AIR will add app:/,
			//which probably isn't what you want.
			if(!url.match(/^\w+:\//))
			{
				url = "http://" + url;
			}
			url = encodeURI(url);
			this._browser.loadURL(url);
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function enterFrameHandler(event:Event):void
		{
			this._browser.setRequiresRedraw();
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
		
		private function webView_locationChangeHandler(event:Event):void
		{
			this._locationInput.text = this._browser.location;
		}
		
		private function locationInput_enterHandler(event:Event):void
		{
			this.loadLocation();
		}
		
		private function goButton_triggeredHandler(event:Event):void
		{
			this.loadLocation();
		}
		
		
	}
}

================================================
FILE: examples/DragAndDrop/README.md
================================================
# Feathers Drag and Drop

A very simple of drag and drop in [Feathers](http://feathersui.com/). Includes examples of implementing the `IDragSource` and `IDropTarget` interfaces.

## Requirements

In addition to Starling Framework and Feathers, this example project requires the `MetalWorksDesktopTheme` example theme. You can find the SWC file for this theme at the following location in the Feathers release build:

	themes/MetalWorksDesktopTheme/swc/MetalWorksDesktopTheme.swc

## Web Demo

View the [Drag and Drop Example](http://feathersui.com/examples/drag-and-drop/) in your web browser.

================================================
FILE: examples/DragAndDrop/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
theme.root = ${basedir}/../../themes/MetalWorksDesktopTheme/source
output.path = ${basedir}/output

swf.version = 30

================================================
FILE: examples/DragAndDrop/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="drag-and-drop" default="build" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<target name="build" depends="-build-swf"/>

	<target name="-prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="-build-swf" depends="-prepare">
		<echo message="Building DragAndDrop.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/DragAndDrop.as"/>
			<arg value="-output=${output.path}/DragAndDrop.swf"/>
		</java>
	</target>
</project>

================================================
FILE: examples/DragAndDrop/source/DragAndDrop.as
================================================
package
{
	import feathers.examples.dragDrop.Main;

	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.events.Event;
	import flash.geom.Rectangle;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class DragAndDrop extends Sprite
	{
		public function DragAndDrop()
		{
			if(this.stage)
			{
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
				this.stage.align = StageAlign.TOP_LEFT;
			}
			this.mouseEnabled = this.mouseChildren = false;
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;

		private function loaderInfo_completeHandler(event:Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(Main, this.stage);
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.start();

			this.stage.addEventListener(Event.RESIZE, stage_resizeHandler, false, int.MAX_VALUE, true);
			this.stage.addEventListener(Event.DEACTIVATE, stage_deactivateHandler, false, 0, true);
		}

		private function stage_resizeHandler(event:Event):void
		{
			this._starling.stage.stageWidth = this.stage.stageWidth;
			this._starling.stage.stageHeight = this.stage.stageHeight;

			var viewPort:Rectangle = this._starling.viewPort;
			viewPort.width = this.stage.stageWidth;
			viewPort.height = this.stage.stageHeight;
			try
			{
				this._starling.viewPort = viewPort;
			}
			catch(error:Error) {}
		}

		private function stage_deactivateHandler(event:Event):void
		{
			this._starling.stop(true);
			this.stage.addEventListener(Event.ACTIVATE, stage_activateHandler, false, 0, true);
		}

		private function stage_activateHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.ACTIVATE, stage_activateHandler);
			this._starling.start();
		}

	}
}

================================================
FILE: examples/DragAndDrop/source/feathers/examples/dragDrop/DragSource.as
================================================
package feathers.examples.dragDrop
{
	import feathers.controls.LayoutGroup;
	import feathers.dragDrop.DragData;
	import feathers.dragDrop.DragDropManager;
	import feathers.dragDrop.IDragSource;
	import feathers.events.DragDropEvent;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class DragSource extends LayoutGroup implements IDragSource
	{
		public function DragSource(dragFormat:String)
		{
			this._dragFormat = dragFormat;
			this.addEventListener(TouchEvent.TOUCH, touchHandler);
			this.addEventListener(DragDropEvent.DRAG_START, dragStartHandler);
			this.addEventListener(DragDropEvent.DRAG_COMPLETE, dragCompleteHandler);
		}

		private var _touchID:int = -1;
		private var _draggedObject:DisplayObject;
		private var _dragFormat:String;

		override protected function initialize():void
		{
			this.backgroundSkin = new Quad(1, 1, 0x36322e);
		}

		private function touchHandler(event:TouchEvent):void
		{
			if(DragDropManager.isDragging)
			{
				//one drag at a time, please
				return;
			}
			if(this._touchID >= 0)
			{
				var touch:Touch = event.getTouch(this._draggedObject, null, this._touchID);
				if(touch.phase == TouchPhase.MOVED)
				{
					this._touchID = -1;

					var avatar:Quad = new Quad(100, 100, 0xff8800);
					avatar.alpha = 0.5;

					var dragData:DragData = new DragData();
					dragData.setDataForFormat(this._dragFormat, this._draggedObject);
					DragDropManager.startDrag(this, touch, dragData, avatar, -avatar.width / 2, -avatar.height / 2);
				}
				else if(touch.phase == TouchPhase.ENDED)
				{
					this._touchID = -1;
				}
			}
			else
			{
				touch = event.getTouch(this, TouchPhase.BEGAN);
				if(!touch || touch.target == this || touch.target == this.backgroundSkin)
				{
					return;
				}
				this._touchID = touch.id;
				this._draggedObject = touch.target;
			}
		}

		private function dragStartHandler(event:DragDropEvent, dragData:DragData):void
		{
			//the drag was started with the call to DragDropManager.startDrag()
		}

		private function dragCompleteHandler(event:DragDropEvent, dragData:DragData):void
		{
			if(event.isDropped)
			{
				//the object was dropped somewhere
			}
			else
			{
				//the drag cancelled and the object was not dropped
			}
		}
	}
}


================================================
FILE: examples/DragAndDrop/source/feathers/examples/dragDrop/DropTarget.as
================================================
package feathers.examples.dragDrop
{
	import feathers.controls.LayoutGroup;
	import feathers.dragDrop.DragData;
	import feathers.dragDrop.DragDropManager;
	import feathers.dragDrop.IDropTarget;
	import feathers.events.DragDropEvent;

	import starling.display.DisplayObject;
	import starling.display.Quad;

	public class DropTarget extends LayoutGroup implements IDropTarget
	{
		private static const DEFAULT_COLOR:uint = 0x36322e;
		private static const HOVER_COLOR:uint = 0x26221e;

		public function DropTarget(dragFormat:String)
		{
			this._dragFormat = dragFormat;
			this.addEventListener(DragDropEvent.DRAG_ENTER, dragEnterHandler);
			this.addEventListener(DragDropEvent.DRAG_EXIT, dragExitHandler);
			this.addEventListener(DragDropEvent.DRAG_DROP, dragDropHandler);
		}

		private var _dragFormat:String;
		private var _backgroundQuad:Quad;

		override protected function initialize():void
		{
			this._backgroundQuad = new Quad(1, 1, DEFAULT_COLOR);
			this.backgroundSkin = this._backgroundQuad;
		}

		private function dragEnterHandler(event:DragDropEvent, dragData:DragData):void
		{
			if(!dragData.hasDataForFormat(this._dragFormat))
			{
				return;
			}
			DragDropManager.acceptDrag(this);
			this._backgroundQuad.color = HOVER_COLOR;
		}

		private function dragExitHandler(event:DragDropEvent, dragData:DragData):void
		{
			this._backgroundQuad.color = DEFAULT_COLOR;
		}

		private function dragDropHandler(event:DragDropEvent, dragData:DragData):void
		{
			var droppedObject:DisplayObject = DisplayObject(dragData.getDataForFormat(this._dragFormat))
			droppedObject.x = Math.min(Math.max(event.localX - droppedObject.width / 2,
				0), this.actualWidth - droppedObject.width); //keep within the bounds of the target
			droppedObject.y = Math.min(Math.max(event.localY - droppedObject.height / 2,
				0), this.actualHeight - droppedObject.height); //keep within the bounds of the target
			this.addChild(droppedObject);

			this._backgroundQuad.color = DEFAULT_COLOR;
		}
	}
}


================================================
FILE: examples/DragAndDrop/source/feathers/examples/dragDrop/Main.as
================================================
package feathers.examples.dragDrop
{
	import feathers.controls.Button;
	import feathers.controls.Label;
	import feathers.dragDrop.IDragSource;
	import feathers.dragDrop.IDropTarget;
	import feathers.themes.MetalWorksDesktopTheme;

	import starling.display.Quad;
	import starling.display.Sprite;
	import starling.events.Event;

	public class Main extends Sprite implements IDragSource, IDropTarget
	{
		private static const DRAG_FORMAT:String = "draggableQuad";

		public function Main()
		{
			//set up the theme right away!
			new MetalWorksDesktopTheme();
			this.addEventListener(Event.ADDED_TO_STAGE, addedToStageHandler);
		}

		private var _draggableQuad:Quad;
		private var _dragSource:DragSource;
		private var _dropTarget:DropTarget;
		private var _resetButton:Button;

		private function reset():void
		{
			this._draggableQuad.x = 40;
			this._draggableQuad.y = 40;
			this._dragSource.addChild(this._draggableQuad);
		}

		private function addedToStageHandler(event:Event):void
		{
			this._draggableQuad = new Quad(100, 100, 0xff8800);

			this._dragSource = new DragSource(DRAG_FORMAT);
			this._dragSource.width = 320;
			this._dragSource.height = 420;
			this._dragSource.x = 80;
			this._dragSource.y = 80;
			this.addChild(this._dragSource);

			this._dropTarget = new DropTarget(DRAG_FORMAT);
			this._dropTarget.width = 320;
			this._dropTarget.height = 420;
			this._dropTarget.x = 560;
			this._dropTarget.y = 80;
			this.addChild(this._dropTarget);

			this._resetButton = new Button();
			this._resetButton.label = "Reset";
			this._resetButton.addEventListener(Event.TRIGGERED, resetButton_triggeredHandler);
			this.addChild(this._resetButton);

			this._resetButton.validate();
			this._resetButton.x = (this.stage.stageWidth - this._resetButton.width) / 2;
			this._resetButton.y = this.stage.stageHeight - this._resetButton.height - 80;

			var instructions:Label = new Label();
			instructions.text = "Drag the square from the left container to the right container.";
			this.addChild(instructions);

			instructions.validate();
			instructions.x = (this.stage.stageWidth - instructions.width) / 2;
			instructions.y = (this._dragSource.y - instructions.height) / 2;

			this.reset();
		}

		private function resetButton_triggeredHandler(event:Event):void
		{
			this.reset();
		}
	}
}


================================================
FILE: examples/DrawersExplorer/README.md
================================================
# Feathers Drawers Explorer

A look at some of the options available to the `Drawers` component in [Feathers](http://feathersui.com/), presented as a mobile app.

## Requirements

In addition to Starling Framework and Feathers, this example project requires the `MetalWorksMobileTheme` example theme. You can find the SWC file for this theme at the following location in the Feathers release build:

	themes/MetalWorksMobileTheme/swc/MetalWorksMobileTheme.swc

## Web Demo

View the [Drawers Explorer](http://feathersui.com/examples/drawers-explorer/) in your browser.

================================================
FILE: examples/DrawersExplorer/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
theme.root = ${basedir}/../../themes/MetalWorksMobileTheme/source
output.path = ${basedir}/output
icon.path = ${basedir}/../shared-assets/icons
launch.image.path = ${basedir}/../shared-assets/launch-images-full-screen

swf.version = 30

================================================
FILE: examples/DrawersExplorer/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="drawers-explorer" default="build" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<target name="build" depends="build-web,build-android,build-ios"/>

	<target name="prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="build-web" depends="prepare">
		<echo message="Building DrawersExplorerWeb.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-advanced-telemetry=true"/>
			<arg value="-frame=two,feathers.examples.drawersExplorer.Main"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/DrawersExplorerWeb.as"/>
			<arg value="-output=${output.path}/DrawersExplorerWeb.swf"/>
		</java>
	</target>
	<target name="build-air-swf" depends="prepare">
		<echo message="Building DrawersExplorer.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-advanced-telemetry=true"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/DrawersExplorer.as"/>
			<arg value="-output=${output.path}/DrawersExplorer.swf"/>
		</java>
	</target>
	<target name="-check-ios-properties">
		<fail unless="ios.provision.path"/>
		<fail unless="ios.certificate.path"/>
		<fail unless="ios.certificate.password"/>
	</target>
	<target name="build-ios" depends="-check-ios-properties,build-air-swf">
		<echo message="Packaging DrawersExplorer.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="ipa-app-store"/>
			<!-- uncomment for actionscript sampling with scout on ios -->
			<!--<arg value="-sampler"/>-->
			<arg value="-provisioning-profile"/>
			<arg value="${ios.provision.path}"/>
			<arg value="-keystore"/>
			<arg value="${ios.certificate.path}"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-storepass"/>
			<arg value="${ios.certificate.password}"/>
			<arg value="${output.path}/DrawersExplorer.ipa"/>
			<arg value="source/DrawersExplorer-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${launch.image.path}"/>
			<arg value="Default~iphone.png"/>							<!-- iphone 3gs -->
			<arg value="Default@2x~iphone.png"/>						<!-- iphone 4/4s -->
			<arg value="Default-568h@2x~iphone.png"/>					<!-- iphone 5/5c/5s -->
			<arg value="Default-375w-667h@2x~iphone.png"/>				<!-- iphone 6/7/8 -->
			<arg value="Default-812h@3x~iphone.png"/>					<!-- iphone x (portrait) -->
			<arg value="Default-Landscape-812h@3x~iphone.png"/>			<!-- iphone x (landscape) -->
			<arg value="Default-414w-736h@3x~iphone.png"/>				<!-- iphone 6/7/8 plus (portrait) -->
			<arg value="Default-Landscape-414w-736h@3x~iphone.png"/>	<!-- iphone 6/7/8 plus (landscape) -->
			<arg value="Default-Portrait~ipad.png"/>					<!-- ipad 1/2 (portrait) -->
			<arg value="Default-PortraitUpsideDown~ipad.png"/>			<!-- ipad 1/2 (portrait upside down) -->
			<arg value="Default-Landscape~ipad.png"/>					<!-- ipad 1/2 (landscape left) -->
			<arg value="Default-LandscapeRight~ipad.png"/>				<!-- ipad 1/2 (landscape right) -->
			<arg value="Default-Portrait@2x~ipad.png"/>					<!-- ipad 3/air (portrait) -->
			<arg value="Default-LandscapeLeft@2x~ipad.png"/>			<!-- ipad 3/air (landscape left) -->
			<arg value="Default-LandscapeRight@2x~ipad.png"/>			<!-- ipad 3/air (landscape right) -->
			<arg value="Default-Portrait@2x.png"/>						<!-- ipad pro (portrait) -->
			<arg value="Default-Landscape@2x.png"/>						<!-- ipad pro (landscape) -->
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="DrawersExplorer.swf"/>
		</java>
	</target>
	<target name="-check-android-properties">
		<fail unless="android.certificate.path"/>
		<fail unless="android.certificate.password"/>
	</target>
	<target name="build-android" depends="-check-android-properties,build-air-swf">
		<echo message="Packaging DrawersExplorer.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="apk-captive-runtime"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-keystore"/>
			<arg value="${android.certificate.path}"/>
			<arg value="-storepass"/>
			<arg value="${android.certificate.password}"/>
			<arg value="${output.path}/DrawersExplorer.apk"/>
			<arg value="source/DrawersExplorer-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="DrawersExplorer.swf"/>
		</java>
	</target>
	<target name="install-android">
		<echo message="Installing DrawersExplorer.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.DrawersExplorer"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-package"/>
			<arg value="${output.path}/DrawersExplorer.apk"/>
		</java>
	</target>
	<target name="install-ios">
		<echo message="Installing DrawersExplorer.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.DrawersExplorer"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-package"/>
			<arg value="${output.path}/DrawersExplorer.ipa"/>
		</java>
	</target>
</project>

================================================
FILE: examples/DrawersExplorer/source/DrawersExplorer-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.examples.DrawersExplorer</id>
	<filename>Drawers</filename>
	<name>Drawers</name>
	<versionNumber>4.2.0</versionNumber>
	<description>Drawers Explorer example application built with Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>DrawersExplorer.swf</content>
		<autoOrients>true</autoOrients>
		<fullScreen>true</fullScreen>
		<visible>true</visible>
		<renderMode>direct</renderMode>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>

	<icon>
		<image29x29>icon29.png</image29x29>
		<image48x48>icon48.png</image48x48>
		<image50x50>icon50.png</image50x50>
		<image57x57>icon57.png</image57x57>
		<image58x58>icon58.png</image58x58>
		<image72x72>icon72.png</image72x72>
		<image87x87>icon87.png</image87x87>
		<image96x96>icon96.png</image96x96>
		<image100x100>icon100.png</image100x100>
		<image114x114>icon114.png</image114x114>
		<image128x128>icon128.png</image128x128>
		<image144x144>icon144.png</image144x144>
		<image180x180>icon180.png</image180x180>
	</icon>
	<android>
		<colorDepth>16bit</colorDepth>
		<manifestAdditions><![CDATA[
			<manifest android:installLocation="auto">
			    <uses-permission android:name="android.permission.INTERNET"/>
			</manifest>
		]]></manifestAdditions>
	</android>
	<iPhone>
		<InfoAdditions>
		<![CDATA[
			<key>UIDeviceFamily</key> 
			<array> 
				<string>1</string>
				<string>2</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<true/>
		]]> 
		</InfoAdditions>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</iPhone>
</application>

================================================
FILE: examples/DrawersExplorer/source/DrawersExplorer.as
================================================
package
{
	import feathers.examples.drawersExplorer.Main;
	import feathers.utils.ScreenDensityScaleFactorManager;

	import flash.display.Loader;
	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageOrientation;
	import flash.display.StageScaleMode;
	import flash.display3D.Context3DProfile;
	import flash.display3D.Context3DRenderMode;
	import flash.events.Event;
	import flash.filesystem.File;
	import flash.filesystem.FileMode;
	import flash.filesystem.FileStream;
	import flash.system.Capabilities;
	import flash.utils.ByteArray;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class DrawersExplorer extends Sprite
	{
		public function DrawersExplorer()
		{
			if(this.stage)
			{
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
				this.stage.align = StageAlign.TOP_LEFT;
			}
			this.mouseEnabled = this.mouseChildren = false;
			this.showLaunchImage();
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;
		private var _scaler:ScreenDensityScaleFactorManager;
		private var _launchImage:Loader;
		private var _savedAutoOrients:Boolean;

		/**
		 * On iOS, add the native launch image to the classic display list to
		 * avoid displaying only the stage background color between when the
		 * AIR app finishes launching and Starling starts rendering.
		 * 
		 * Launch image names: https://forums.adobe.com/message/9986239#9986239
		 */
		private function showLaunchImage():void
		{
			var filePath:String = null;
			var isPortraitOnly:Boolean = false;
			if(Capabilities.manufacturer.indexOf("iOS") >= 0)
			{
				var isPortraitUpsideDown:Boolean = this.stage.orientation == StageOrientation.UPSIDE_DOWN;
				var isPortrait:Boolean = this.stage.orientation == StageOrientation.DEFAULT || isPortraitUpsideDown;
				var isLandscapeRight:Boolean = this.stage.orientation == StageOrientation.ROTATED_RIGHT;
				if(Capabilities.screenResolutionX == 1242 && Capabilities.screenResolutionY == 2208)
				{
					//iphone 6/7/8 plus
					filePath = isPortrait ? "Default-414w-736h@3x~iphone.png" : "Default-Landscape-414w-736h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 1125 && Capabilities.screenResolutionY == 2436)
				{
					//iphone x
					filePath = isPortrait ? "Default-812h@3x~iphone.png" : "Default-Landscape-812h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 2048 && Capabilities.screenResolutionY == 2732)
				{
					//ipad pro
					filePath = isPortrait ? "Default-Portrait@2x.png" : "Default-Landscape@2x.png";
				}
				else if(Capabilities.screenResolutionX == 1536 && Capabilities.screenResolutionY == 2048)
				{
					//ipad 3/air
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait@2x~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown@2x~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight@2x~ipad.png";
					}
					else
					{
						filePath = "Default-LandscapeLeft@2x~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 768 && Capabilities.screenResolutionY == 1024)
				{
					//ipad 1/2
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight~ipad.png";
					}
					else
					{
						filePath = "Default-Landscape~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 750)
				{
					//iphone 6/7/8
					isPortraitOnly = true;
					filePath = "Default-375w-667h@2x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 640)
				{
					isPortraitOnly = true;
					if(Capabilities.screenResolutionY == 1136)
					{
						//iphone 5/5c/5s
						filePath = "Default-568h@2x~iphone.png";
					}
					else
					{
						//iphone 4/4s
						filePath = "Default@2x~iphone.png";
					}
				}
				else if(Capabilities.screenResolutionX == 320)
				{
					//iphone 3gs
					isPortraitOnly = true;
					filePath = "Default~iphone.png";
				}
			}

			if(filePath)
			{
				var file:File = File.applicationDirectory.resolvePath(filePath);
				if(file.exists)
				{
					var bytes:ByteArray = new ByteArray();
					var stream:FileStream = new FileStream();
					stream.open(file, FileMode.READ);
					stream.readBytes(bytes, 0, stream.bytesAvailable);
					stream.close();
					this._launchImage = new Loader();
					this._launchImage.loadBytes(bytes);
					this.addChild(this._launchImage);
					this._savedAutoOrients = this.stage.autoOrients;
					this.stage.autoOrients = false;
					if(isPortraitOnly)
					{
						this.stage.setOrientation(StageOrientation.DEFAULT);
					}
				}
			}
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(Main, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE);
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.start();
			if(this._launchImage)
			{
				this._starling.addEventListener("rootCreated", starling_rootCreatedHandler);
			}
			this._scaler = new ScreenDensityScaleFactorManager(this._starling);

			this.stage.addEventListener(Event.DEACTIVATE, stage_deactivateHandler, false, 0, true);
		}

		private function starling_rootCreatedHandler(event:Object):void
		{
			if(this._launchImage)
			{
				this.removeChild(this._launchImage);
				this._launchImage.unloadAndStop(true);
				this._launchImage = null;
				this.stage.autoOrients = this._savedAutoOrients;
			}
		}

		private function stage_deactivateHandler(event:Event):void
		{
			this._starling.stop(true);
			this.stage.addEventListener(Event.ACTIVATE, stage_activateHandler, false, 0, true);
		}

		private function stage_activateHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.ACTIVATE, stage_activateHandler);
			this._starling.start();
		}

	}
}

================================================
FILE: examples/DrawersExplorer/source/DrawersExplorerWeb.as
================================================
package
{
	import feathers.system.DeviceCapabilities;

	import flash.display.MovieClip;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.events.Event;
	import flash.geom.Rectangle;
	import flash.ui.ContextMenu;
	import flash.utils.getDefinitionByName;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class DrawersExplorerWeb extends MovieClip
	{
		public function DrawersExplorerWeb()
		{
			var menu:ContextMenu = new ContextMenu();
			menu.hideBuiltInItems();
			this.contextMenu = menu;
			
			if(this.stage)
			{
				this.stage.align = StageAlign.TOP_LEFT;
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
			}
			
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}
		
		private var _starling:Starling;
		
		private function start():void
		{
			this.gotoAndStop(2);
			this.graphics.clear();

			//simulating iPhone Retina
			DeviceCapabilities.dpi = 326;
			
			Starling.multitouchEnabled = true;
			var MainType:Class = getDefinitionByName("feathers.examples.drawersExplorer.Main") as Class;
			this._starling = new Starling(MainType, this.stage, new Rectangle(0, 0, 960, 640));
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.stage.stageWidth = 480;
			this._starling.stage.stageHeight = 320;
			this._starling.start();
		}
		
		private function loaderInfo_completeHandler(event:Event):void
		{
			this.start();
		}
	}
}

================================================
FILE: examples/DrawersExplorer/source/feathers/examples/drawersExplorer/Main.as
================================================
package feathers.examples.drawersExplorer
{
	import feathers.controls.DragGesture;
	import feathers.controls.Drawers;
	import feathers.examples.drawersExplorer.skins.DrawersExplorerTheme;
	import feathers.examples.drawersExplorer.views.ContentView;
	import feathers.examples.drawersExplorer.views.DrawerView;
	import feathers.layout.Orientation;

	import starling.display.Sprite;
	import starling.events.Event;

	public class Main extends Sprite
	{
		public function Main()
		{
			//set up the theme right away!
			new DrawersExplorerTheme();
			super();
			this.addEventListener(Event.ADDED_TO_STAGE, addedToStageHandler);
		}

		private var _drawers:Drawers;

		private function changeDockMode(drawer:DrawerView, dockMode:String):void
		{
			switch(drawer)
			{
				case this._drawers.topDrawer:
				{
					this._drawers.topDrawerDockMode = dockMode;
					break;
				}
				case this._drawers.rightDrawer:
				{
					this._drawers.rightDrawerDockMode = dockMode;
					break;
				}
				case this._drawers.bottomDrawer:
				{
					this._drawers.bottomDrawerDockMode = dockMode;
					break;
				}
				case this._drawers.leftDrawer:
				{
					this._drawers.leftDrawerDockMode = dockMode;
					break;
				}
			}
		}
		
		private function addedToStageHandler(event:Event):void
		{
			this._drawers = new Drawers();

			//a drawer may be opened by dragging from the edge of the content
			//you can also set it to drag from anywhere inside the content
			//or you can disable gestures entirely and only open a drawer when
			//an event is dispatched by the content or by calling a function
			//on the drawer component to open a drawer programmatically.
			this._drawers.openGesture = DragGesture.EDGE;

			this._drawers.content = new ContentView();
			//these events are dispatched by the content
			//Drawers listens for each of these events and opens the drawer
			//associated with an event when it is dispatched
			this._drawers.topDrawerToggleEventType = ContentView.TOGGLE_TOP_DRAWER;
			this._drawers.rightDrawerToggleEventType = ContentView.TOGGLE_RIGHT_DRAWER;
			this._drawers.bottomDrawerToggleEventType = ContentView.TOGGLE_BOTTOM_DRAWER;
			this._drawers.leftDrawerToggleEventType = ContentView.TOGGLE_LEFT_DRAWER;
			this._drawers.content.addEventListener(ContentView.OPEN_MODE_CHANGE, contentView_openDrawerChangeHandler);

			var topDrawer:DrawerView = new DrawerView("Top");
			topDrawer.styleNameList.add(DrawersExplorerTheme.THEME_NAME_TOP_AND_BOTTOM_DRAWER);
			topDrawer.addEventListener(DrawerView.CHANGE_DOCK_MODE_TO_NONE, drawer_dockNoneHandler);
			topDrawer.addEventListener(DrawerView.CHANGE_DOCK_MODE_TO_BOTH, drawer_dockBothHandler);
			//a drawer may be any display object
			this._drawers.topDrawer = topDrawer;
			//by default, a drawer is not docked. it may be opened and closed
			//based on user interaction or events dispatched by the content.
			this._drawers.topDrawerDockMode = Orientation.NONE;

			var rightDrawer:DrawerView = new DrawerView("Right");
			rightDrawer.styleNameList.add(DrawersExplorerTheme.THEME_NAME_LEFT_AND_RIGHT_DRAWER);
			rightDrawer.addEventListener(DrawerView.CHANGE_DOCK_MODE_TO_NONE, drawer_dockNoneHandler);
			rightDrawer.addEventListener(DrawerView.CHANGE_DOCK_MODE_TO_BOTH, drawer_dockBothHandler);
			this._drawers.rightDrawer = rightDrawer;
			this._drawers.rightDrawerDockMode = Orientation.NONE;

			var bottomDrawer:DrawerView = new DrawerView("Bottom");
			bottomDrawer.styleNameList.add(DrawersExplorerTheme.THEME_NAME_TOP_AND_BOTTOM_DRAWER);
			bottomDrawer.addEventListener(DrawerView.CHANGE_DOCK_MODE_TO_NONE, drawer_dockNoneHandler);
			bottomDrawer.addEventListener(DrawerView.CHANGE_DOCK_MODE_TO_BOTH, drawer_dockBothHandler);
			this._drawers.bottomDrawer = bottomDrawer;
			this._drawers.bottomDrawerDockMode = Orientation.NONE;

			var leftDrawer:DrawerView = new DrawerView("Left");
			leftDrawer.styleNameList.add(DrawersExplorerTheme.THEME_NAME_LEFT_AND_RIGHT_DRAWER);
			leftDrawer.addEventListener(DrawerView.CHANGE_DOCK_MODE_TO_NONE, drawer_dockNoneHandler);
			leftDrawer.addEventListener(DrawerView.CHANGE_DOCK_MODE_TO_BOTH, drawer_dockBothHandler);
			this._drawers.leftDrawer = leftDrawer;
			this._drawers.leftDrawerDockMode = Orientation.NONE;

			this.addChild(this._drawers);
		}

		private function drawer_dockNoneHandler(event:Event):void
		{
			var drawer:DrawerView = DrawerView(event.currentTarget);
			this.changeDockMode(drawer, Orientation.NONE);
		}

		private function drawer_dockBothHandler(event:Event):void
		{
			var drawer:DrawerView = DrawerView(event.currentTarget);
			this.changeDockMode(drawer, Orientation.BOTH);
		}
		
		private function contentView_openDrawerChangeHandler(event:Event):void
		{
			var content:ContentView = ContentView(event.currentTarget);
			this._drawers.openMode = content.openMode;
		}
	}
}

================================================
FILE: examples/DrawersExplorer/source/feathers/examples/drawersExplorer/skins/DrawersExplorerTheme.as
================================================
package feathers.examples.drawersExplorer.skins
{
	import feathers.examples.drawersExplorer.views.ContentView;
	import feathers.examples.drawersExplorer.views.DrawerView;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.themes.MetalWorksMobileTheme;

	import starling.display.Quad;

	public class DrawersExplorerTheme extends MetalWorksMobileTheme
	{
		public static const THEME_NAME_TOP_AND_BOTTOM_DRAWER:String = "drawers-explorer-top-and-bottom-drawer";
		public static const THEME_NAME_LEFT_AND_RIGHT_DRAWER:String = "drawers-explorer-left-and-right-drawer";

		public function DrawersExplorerTheme()
		{
			super();
		}

		override protected function initializeStyleProviders():void
		{
			super.initializeStyleProviders();
			this.getStyleProviderForClass(ContentView).defaultStyleFunction = setContentViewStyles;
			this.getStyleProviderForClass(DrawerView).setFunctionForStyleName(THEME_NAME_TOP_AND_BOTTOM_DRAWER, setTopAndBottomDrawerViewStyles);
			this.getStyleProviderForClass(DrawerView).setFunctionForStyleName(THEME_NAME_LEFT_AND_RIGHT_DRAWER, setLeftAndRightDrawerViewStyles);
		}

		protected function setContentViewStyles(view:ContentView):void
		{
			//don't forget to set styles from the super class, if required
			this.setScrollerStyles(view);
			
			var layout:VerticalLayout = new VerticalLayout();
			layout.horizontalAlign = HorizontalAlign.CENTER;
			layout.padding = this.gutterSize;
			layout.gap = this.gutterSize;
			view.layout = layout;
		}

		protected function setLeftAndRightDrawerViewStyles(view:DrawerView):void
		{
			//don't forget to set styles from the super class, if required
			this.setScrollerStyles(view);
			
			view.backgroundSkin = new Quad(10, 10, LIST_BACKGROUND_COLOR);

			var layout:VerticalLayout = new VerticalLayout();
			layout.horizontalAlign = HorizontalAlign.CENTER;
			layout.verticalAlign = VerticalAlign.MIDDLE;
			layout.padding = this.smallGutterSize;
			layout.gap = this.smallGutterSize;
			view.layout = layout;
		}

		protected function setTopAndBottomDrawerViewStyles(view:DrawerView):void
		{
			//don't forget to set styles from the super class, if required
			this.setScrollerStyles(view);
			
			view.backgroundSkin = new Quad(10, 10, GROUPED_LIST_HEADER_BACKGROUND_COLOR);

			var layout:HorizontalLayout = new HorizontalLayout();
			layout.horizontalAlign = HorizontalAlign.CENTER;
			layout.verticalAlign = VerticalAlign.MIDDLE;
			layout.padding = this.smallGutterSize;
			layout.gap = this.smallGutterSize;
			view.layout = layout;
		}
	}
}


================================================
FILE: examples/DrawersExplorer/source/feathers/examples/drawersExplorer/views/ContentView.as
================================================
package feathers.examples.drawersExplorer.views
{
	import feathers.controls.Button;
	import feathers.controls.List;
	import feathers.controls.Panel;
	import feathers.controls.PickerList;
	import feathers.controls.ScrollContainer;
	import feathers.data.ArrayCollection;
	import feathers.data.ListCollection;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.RelativeDepth;
	import feathers.layout.VerticalLayout;
	import feathers.skins.IStyleProvider;

	import starling.events.Event;

	public class ContentView extends ScrollContainer
	{
		public static var globalStyleProvider:IStyleProvider;

		public static const TOGGLE_TOP_DRAWER:String = "toggleTopDrawer";
		public static const TOGGLE_RIGHT_DRAWER:String = "toggleRightDrawer";
		public static const TOGGLE_BOTTOM_DRAWER:String = "toggleBottomDrawer";
		public static const TOGGLE_LEFT_DRAWER:String = "toggleLeftDrawer";
		public static const OPEN_MODE_CHANGE:String = "openModeChange";

		public function ContentView()
		{

		}

		private var _topButton:Button;
		private var _rightButton:Button;
		private var _bottomButton:Button;
		private var _leftButton:Button;
		
		private var _openModePicker:PickerList;

		override protected function get defaultStyleProvider():IStyleProvider
		{
			return ContentView.globalStyleProvider;
		}
		
		private var _openMode:String = RelativeDepth.BELOW;
		
		public function get openMode():String
		{
			return this._openMode;
		}

		override protected function initialize():void
		{
			var openControlsPanel:Panel = new Panel();
			openControlsPanel.title = "Open Drawers";
			openControlsPanel.layout = new AnchorLayout();
			this.addChild(openControlsPanel);

			this._topButton = new Button();
			this._topButton.label = "Top";
			this._topButton.addEventListener(Event.TRIGGERED, topButton_triggeredHandler);
			var topLayoutData:AnchorLayoutData = new AnchorLayoutData();
			topLayoutData.horizontalCenter = 0;
			this._topButton.layoutData = topLayoutData;
			openControlsPanel.addChild(this._topButton);

			this._rightButton = new Button();
			this._rightButton.label = "Right";
			this._rightButton.addEventListener(Event.TRIGGERED, rightButton_triggeredHandler);
			var rightLayoutData:AnchorLayoutData = new AnchorLayoutData();
			rightLayoutData.verticalCenter = 0;
			this._rightButton.layoutData = rightLayoutData;
			openControlsPanel.addChild(this._rightButton);

			this._bottomButton = new Button();
			this._bottomButton.label = "Bottom";
			this._bottomButton.addEventListener(Event.TRIGGERED, bottomButton_triggeredHandler);
			var bottomLayoutData:AnchorLayoutData = new AnchorLayoutData();
			bottomLayoutData.horizontalCenter = 0;
			this._bottomButton.layoutData = bottomLayoutData;
			openControlsPanel.addChild(this._bottomButton);

			this._leftButton = new Button();
			this._leftButton.label = "Left";
			this._leftButton.addEventListener(Event.TRIGGERED, leftButton_triggeredHandler);
			var leftLayoutData:AnchorLayoutData = new AnchorLayoutData();
			leftLayoutData.verticalCenter = 0;
			this._leftButton.layoutData = leftLayoutData;
			openControlsPanel.addChild(this._leftButton);

			this._topButton.validate();
			var verticalOffset:Number = this._topButton.height * 1.5;
			topLayoutData.verticalCenter = -verticalOffset;
			bottomLayoutData.verticalCenter = verticalOffset;

			this._rightButton.validate();
			var horizontalOffset:Number = this._rightButton.width;
			rightLayoutData.horizontalCenter = horizontalOffset;
			leftLayoutData.horizontalCenter = -horizontalOffset;
			
			var optionsPanel:Panel = new Panel();
			optionsPanel.title = "Options";
			optionsPanel.layout = new VerticalLayout();
			this.addChild(optionsPanel);
			
			this._openModePicker = new PickerList();
			this._openModePicker.dataProvider = new ArrayCollection(
			[
				{ label: "Below", data: RelativeDepth.BELOW },
				{ label: "Above", data: RelativeDepth.ABOVE },
			]);
			this._openModePicker.addEventListener(Event.CHANGE, openModePicker_changeHandler);

			var optionsList:List = new List();
			optionsList.dataProvider = new ArrayCollection(
			[
				{ label: "Open Mode", accessory: this._openModePicker },
			]);
			optionsPanel.addChild(optionsList);
		}

		private function topButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(TOGGLE_TOP_DRAWER);
		}

		private function rightButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(TOGGLE_RIGHT_DRAWER);
		}

		private function bottomButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(TOGGLE_BOTTOM_DRAWER);
		}

		private function leftButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(TOGGLE_LEFT_DRAWER);
		}
		
		private function openModePicker_changeHandler(event:Event):void
		{
			this._openMode = this._openModePicker.selectedItem.data as String;
			this.dispatchEventWith(OPEN_MODE_CHANGE);
		}
	}
}


================================================
FILE: examples/DrawersExplorer/source/feathers/examples/drawersExplorer/views/DrawerView.as
================================================
package feathers.examples.drawersExplorer.views
{
	import feathers.controls.Check;
	import feathers.controls.Label;
	import feathers.controls.ScrollContainer;
	import feathers.skins.IStyleProvider;

	import starling.events.Event;

	public class DrawerView extends ScrollContainer
	{
		public static var globalStyleProvider:IStyleProvider;

		public static const CHANGE_DOCK_MODE_TO_NONE:String = "changeDockModeToNone";
		public static const CHANGE_DOCK_MODE_TO_BOTH:String = "changeDockModeToBoth";

		public function DrawerView(title:String)
		{
			super();
			this._title = title;
		}

		private var _title:String;
		private var _titleLabel:Label;
		private var _dockCheck:Check;

		override protected function get defaultStyleProvider():IStyleProvider
		{
			return DrawerView.globalStyleProvider;
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this._titleLabel = new Label();
			this._titleLabel.styleNameList.add(Label.ALTERNATE_STYLE_NAME_HEADING);
			this._titleLabel.text = this._title;
			this.addChild(this._titleLabel);

			this._dockCheck = new Check();
			this._dockCheck.isSelected = false;
			this._dockCheck.label = "Dock";
			this._dockCheck.addEventListener(Event.CHANGE, dockCheck_changeHandler);
			this.addChild(this._dockCheck);
		}

		private function dockCheck_changeHandler(event:Event):void
		{
			if(this._dockCheck.isSelected)
			{
				this.dispatchEventWith(CHANGE_DOCK_MODE_TO_BOTH);
			}
			else
			{
				this.dispatchEventWith(CHANGE_DOCK_MODE_TO_NONE);
			}
		}

	}
}


================================================
FILE: examples/Gallery/README.md
================================================
# Gallery Example for Feathers

Displays a simple gallery of images from the [Flickr API](http://www.flickr.com/services/api/) using [Feathers](http://feathersui.com/). This example shows how to create lists with `SlideShowLayout` and `HorizontalLayout` with custom item renderers.

## Requirements

In addition to Starling Framework and Feathers, this example project requires the `MetalWorksMobileTheme` example theme. You can find the SWC file for this theme at the following location in the Feathers release build:

	themes/MetalWorksMobileTheme/swc/MetalWorksMobileTheme.swc

Additionally, you will need a [Flickr API key](https://www.flickr.com/services/apps/create/apply/). Pass in this API key by defining a conditional constant named `CONFIG::FLICKR_API_KEY`. If you are compiling with an IDE, conditional constants are usually defined somewhere in your project's settings. On the command line, you may use the `-define` compiler argument:

	-define+=CONFIG::FLICKR_API_KEY,'your flickr api key'

================================================
FILE: examples/Gallery/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
theme.root = ${basedir}/../../themes/MetalWorksMobileTheme/source
output.path = ${basedir}/output
icon.path = ${basedir}/../shared-assets/icons
launch.image.path = ${basedir}/../shared-assets/launch-images-windowed

swf.version = 30

================================================
FILE: examples/Gallery/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="gallery" default="build" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<fail unless="flickr.api.key"/>

	<target name="build" depends="build-android,build-ios"/>

	<target name="prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="build-air-swf" depends="prepare">
		<echo message="Building Gallery.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="--define+=CONFIG::FLICKR_API_KEY,'${flickr.api.key}'"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/Gallery.as"/>
			<arg value="-output=${output.path}/Gallery.swf"/>
		</java>
	</target>
	<target name="-check-ios-properties">
		<fail unless="ios.provision.path"/>
		<fail unless="ios.certificate.path"/>
		<fail unless="ios.certificate.password"/>
	</target>
	<target name="build-ios" depends="-check-ios-properties,build-air-swf">
		<echo message="Packaging Gallery.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="ipa-app-store"/>
			<arg value="-provisioning-profile"/>
			<arg value="${ios.provision.path}"/>
			<arg value="-keystore"/>
			<arg value="${ios.certificate.path}"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-storepass"/>
			<arg value="${ios.certificate.password}"/>
			<arg value="${output.path}/Gallery.ipa"/>
			<arg value="source/Gallery-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${launch.image.path}"/>
			<arg value="Default~iphone.png"/>							<!-- iphone 3gs -->
			<arg value="Default@2x~iphone.png"/>						<!-- iphone 4/4s -->
			<arg value="Default-568h@2x~iphone.png"/>					<!-- iphone 5/5c/5s -->
			<arg value="Default-375w-667h@2x~iphone.png"/>				<!-- iphone 6/7/8 -->
			<arg value="Default-812h@3x~iphone.png"/>					<!-- iphone x (portrait) -->
			<arg value="Default-Landscape-812h@3x~iphone.png"/>			<!-- iphone x (landscape) -->
			<arg value="Default-414w-736h@3x~iphone.png"/>				<!-- iphone 6/7/8 plus (portrait) -->
			<arg value="Default-Landscape-414w-736h@3x~iphone.png"/>	<!-- iphone 6/7/8 plus (landscape) -->
			<arg value="Default-Portrait~ipad.png"/>					<!-- ipad 1/2 (portrait) -->
			<arg value="Default-PortraitUpsideDown~ipad.png"/>			<!-- ipad 1/2 (portrait upside down) -->
			<arg value="Default-Landscape~ipad.png"/>					<!-- ipad 1/2 (landscape left) -->
			<arg value="Default-LandscapeRight~ipad.png"/>				<!-- ipad 1/2 (landscape right) -->
			<arg value="Default-Portrait@2x~ipad.png"/>					<!-- ipad 3/air (portrait) -->
			<arg value="Default-LandscapeLeft@2x~ipad.png"/>			<!-- ipad 3/air (landscape left) -->
			<arg value="Default-LandscapeRight@2x~ipad.png"/>			<!-- ipad 3/air (landscape right) -->
			<arg value="Default-Portrait@2x.png"/>						<!-- ipad pro (portrait) -->
			<arg value="Default-Landscape@2x.png"/>						<!-- ipad pro (landscape) -->
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="Gallery.swf"/>
		</java>
	</target>
	<target name="-check-android-properties">
		<fail unless="android.certificate.path"/>
		<fail unless="android.certificate.password"/>
	</target>
	<target name="build-android" depends="-check-android-properties,build-air-swf">
		<echo message="Packaging Gallery.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="apk-captive-runtime"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-keystore"/>
			<arg value="${android.certificate.path}"/>
			<arg value="-storepass"/>
			<arg value="${android.certificate.password}"/>
			<arg value="${output.path}/Gallery.apk"/>
			<arg value="source/Gallery-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="Gallery.swf"/>
		</java>
	</target>
	<target name="install-android">
		<echo message="Installing Gallery.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.Gallery"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-package"/>
			<arg value="${output.path}/Gallery.apk"/>
		</java>
	</target>
	<target name="install-ios">
		<echo message="Installing Gallery.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.Gallery"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-package"/>
			<arg value="${output.path}/Gallery.ipa"/>
		</java>
	</target>
</project>

================================================
FILE: examples/Gallery/source/Gallery-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.examples.Gallery</id>
	<filename>Gallery</filename>
	<name>Gallery</name>
	<versionNumber>4.2.0</versionNumber>
	<description>Gallery example application built with Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>Gallery.swf</content>
		<autoOrients>true</autoOrients>
		<fullScreen>false</fullScreen>
		<visible>true</visible>
		<renderMode>direct</renderMode>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>

	<icon>
		<image29x29>icon29.png</image29x29>
		<image48x48>icon48.png</image48x48>
		<image50x50>icon50.png</image50x50>
		<image57x57>icon57.png</image57x57>
		<image58x58>icon58.png</image58x58>
		<image72x72>icon72.png</image72x72>
		<image87x87>icon87.png</image87x87>
		<image96x96>icon96.png</image96x96>
		<image100x100>icon100.png</image100x100>
		<image114x114>icon114.png</image114x114>
		<image128x128>icon128.png</image128x128>
		<image144x144>icon144.png</image144x144>
		<image180x180>icon180.png</image180x180>
	</icon>
	<android>
		<colorDepth>16bit</colorDepth>
		<manifestAdditions><![CDATA[
			<manifest android:installLocation="auto">
			    <uses-permission android:name="android.permission.INTERNET"/>
			</manifest>
		]]></manifestAdditions>
	</android>
	<iPhone>
		<InfoAdditions>
		<![CDATA[
			<key>UIDeviceFamily</key> 
			<array> 
				<string>1</string>
				<string>2</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<true/>
			<key>UIStatusBarStyle</key>
			<string>UIStatusBarStyleLightContent</string>
		]]> 
		</InfoAdditions>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</iPhone>
</application>

================================================
FILE: examples/Gallery/source/Gallery.as
================================================
package
{
	import feathers.examples.gallery.Main;
	import feathers.utils.ScreenDensityScaleFactorManager;

	import flash.display.Loader;
	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageOrientation;
	import flash.display.StageScaleMode;
	import flash.display3D.Context3DProfile;
	import flash.display3D.Context3DRenderMode;
	import flash.events.Event;
	import flash.filesystem.File;
	import flash.filesystem.FileMode;
	import flash.filesystem.FileStream;
	import flash.system.Capabilities;
	import flash.utils.ByteArray;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class Gallery extends Sprite
	{
		public function Gallery()
		{
			if(this.stage)
			{
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
				this.stage.align = StageAlign.TOP_LEFT;
			}
			this.mouseEnabled = this.mouseChildren = false;
			this.showLaunchImage();
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;
		private var _scaler:ScreenDensityScaleFactorManager;
		private var _launchImage:Loader;
		private var _savedAutoOrients:Boolean;

		/**
		 * On iOS, add the native launch image to the classic display list to
		 * avoid displaying only the stage background color between when the
		 * AIR app finishes launching and Starling starts rendering.
		 * 
		 * Launch image names: https://forums.adobe.com/message/9986239#9986239
		 */
		private function showLaunchImage():void
		{
			var filePath:String = null;
			var isPortraitOnly:Boolean = false;
			if(Capabilities.manufacturer.indexOf("iOS") >= 0)
			{
				var isPortraitUpsideDown:Boolean = this.stage.orientation == StageOrientation.UPSIDE_DOWN;
				var isPortrait:Boolean = this.stage.orientation == StageOrientation.DEFAULT || isPortraitUpsideDown;
				var isLandscapeRight:Boolean = this.stage.orientation == StageOrientation.ROTATED_RIGHT;
				if(Capabilities.screenResolutionX == 1242 && Capabilities.screenResolutionY == 2208)
				{
					//iphone 6/7/8 plus
					filePath = isPortrait ? "Default-414w-736h@3x~iphone.png" : "Default-Landscape-414w-736h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 1125 && Capabilities.screenResolutionY == 2436)
				{
					//iphone x
					filePath = isPortrait ? "Default-812h@3x~iphone.png" : "Default-Landscape-812h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 2048 && Capabilities.screenResolutionY == 2732)
				{
					//ipad pro
					filePath = isPortrait ? "Default-Portrait@2x.png" : "Default-Landscape@2x.png";
				}
				else if(Capabilities.screenResolutionX == 1536 && Capabilities.screenResolutionY == 2048)
				{
					//ipad 3/air
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait@2x~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown@2x~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight@2x~ipad.png";
					}
					else
					{
						filePath = "Default-LandscapeLeft@2x~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 768 && Capabilities.screenResolutionY == 1024)
				{
					//ipad 1/2
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight~ipad.png";
					}
					else
					{
						filePath = "Default-Landscape~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 750)
				{
					//iphone 6/7/8
					isPortraitOnly = true;
					filePath = "Default-375w-667h@2x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 640)
				{
					isPortraitOnly = true;
					if(Capabilities.screenResolutionY == 1136)
					{
						//iphone 5/5c/5s
						filePath = "Default-568h@2x~iphone.png";
					}
					else
					{
						//iphone 4/4s
						filePath = "Default@2x~iphone.png";
					}
				}
				else if(Capabilities.screenResolutionX == 320)
				{
					//iphone 3gs
					isPortraitOnly = true;
					filePath = "Default~iphone.png";
				}
			}

			if(filePath)
			{
				var file:File = File.applicationDirectory.resolvePath(filePath);
				if(file.exists)
				{
					var bytes:ByteArray = new ByteArray();
					var stream:FileStream = new FileStream();
					stream.open(file, FileMode.READ);
					stream.readBytes(bytes, 0, stream.bytesAvailable);
					stream.close();
					this._launchImage = new Loader();
					this._launchImage.loadBytes(bytes);
					this.addChild(this._launchImage);
					this._savedAutoOrients = this.stage.autoOrients;
					this.stage.autoOrients = false;
					if(isPortraitOnly)
					{
						this.stage.setOrientation(StageOrientation.DEFAULT);
					}
				}
			}
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(Main, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE);
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.simulateMultitouch = true;
			this._starling.start();
			if(this._launchImage)
			{
				this._starling.addEventListener("rootCreated", starling_rootCreatedHandler);
			}
			this._scaler = new ScreenDensityScaleFactorManager(this._starling);

			this.stage.addEventListener(Event.DEACTIVATE, stage_deactivateHandler, false, 0, true);
		}

		private function starling_rootCreatedHandler(event:Object):void
		{
			if(this._launchImage)
			{
				this.removeChild(this._launchImage);
				this._launchImage.unloadAndStop(true);
				this._launchImage = null;
				this.stage.autoOrients = this._savedAutoOrients;
			}
		}

		private function stage_deactivateHandler(event:Event):void
		{
			this._starling.stop(true);
			this.stage.addEventListener(Event.ACTIVATE, stage_activateHandler, false, 0, true);
		}

		private function stage_activateHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.ACTIVATE, stage_activateHandler);
			this._starling.start();
		}

	}
}

================================================
FILE: examples/Gallery/source/feathers/examples/gallery/Main.as
================================================
package feathers.examples.gallery
{
	import feathers.controls.DecelerationRate;
	import feathers.controls.Label;
	import feathers.controls.LayoutGroup;
	import feathers.controls.List;
	import feathers.controls.ScrollBarDisplayMode;
	import feathers.controls.ScrollPolicy;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.VectorCollection;
	import feathers.events.FeathersEventType;
	import feathers.examples.gallery.controls.GalleryItemRenderer;
	import feathers.examples.gallery.controls.ThumbItemRenderer;
	import feathers.examples.gallery.data.GalleryItem;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.SlideShowLayout;
	import feathers.layout.VerticalAlign;
	import feathers.themes.MetalWorksMobileTheme;
	import feathers.utils.textures.TextureCache;

	import flash.events.Event;
	import flash.events.IOErrorEvent;
	import flash.events.SecurityErrorEvent;
	import flash.net.URLLoader;
	import flash.net.URLRequest;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.events.Event;

	public class Main extends LayoutGroup
	{
		private static const FLICKR_URL:String = "https://api.flickr.com/services/rest/?method=flickr.interestingness.getList&api_key=" + CONFIG::FLICKR_API_KEY + "&format=rest";
		private static const FLICKR_PHOTO_URL:String = "https://farm{farm-id}.staticflickr.com/{server-id}/{id}_{secret}_{size}.jpg";

		public function Main()
		{
			//set up the theme right away!
			//this is an *extended* version of MetalWorksMobileTheme
			new MetalWorksMobileTheme();
			super();
		}

		protected var fullSizeList:List;
		protected var thumbnailList:List;
		protected var message:Label;
		protected var apiLoader:URLLoader;
		protected var thumbnailTextureCache:TextureCache;

		override public function dispose():void
		{
			if(this.thumbnailTextureCache)
			{
				this.thumbnailTextureCache.dispose();
				this.thumbnailTextureCache = null;
			}
			super.dispose();
		}

		override protected function initialize():void
		{
			//don't forget to call super.initialize() when you override it!
			super.initialize();

			this.layout = new AnchorLayout();

			//keep some thumbnails in memory so that they don't need to be
			//reloaded from the web
			this.thumbnailTextureCache = new TextureCache(30);

			this.apiLoader = new URLLoader();
			this.apiLoader.addEventListener(flash.events.Event.COMPLETE, apiLoader_completeListener);
			this.apiLoader.addEventListener(IOErrorEvent.IO_ERROR, apiLoader_errorListener);
			this.apiLoader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, apiLoader_errorListener);
			this.apiLoader.load(new URLRequest(FLICKR_URL));

			//the thumbnail list is positioned on the bottom edge of the app
			//and fills the entire width
			var thumbnailListLayoutData:AnchorLayoutData = new AnchorLayoutData();
			thumbnailListLayoutData.left = 0;
			thumbnailListLayoutData.right = 0;
			thumbnailListLayoutData.bottom = 0;

			var thumbnailListLayout:HorizontalLayout = new HorizontalLayout();
			thumbnailListLayout.verticalAlign = VerticalAlign.JUSTIFY;
			thumbnailListLayout.hasVariableItemDimensions = true;

			this.thumbnailList = new List();
			this.thumbnailList.layout = thumbnailListLayout;
			//make sure that we have elastic edges horizontally
			this.thumbnailList.horizontalScrollPolicy = ScrollPolicy.ON;
			//we're not displaying scroll bars
			this.thumbnailList.scrollBarDisplayMode = ScrollBarDisplayMode.NONE;
			//make a swipe scroll a shorter distance
			this.thumbnailList.decelerationRate = DecelerationRate.FAST;
			this.thumbnailList.itemRendererFactory = thumbnailItemRendererFactory;
			this.thumbnailList.addEventListener(starling.events.Event.CHANGE, thumbnailList_changeHandler);
			this.thumbnailList.height = 100;
			this.thumbnailList.layoutData = thumbnailListLayoutData;
			this.addChild(this.thumbnailList);

			//the full size list fills the remaining space above the thumbnails
			var fullSizeListLayoutData:AnchorLayoutData = new AnchorLayoutData(0, 0, 0, 0);
			fullSizeListLayoutData.bottomAnchorDisplayObject = this.thumbnailList;

			//show a single item per page
			var fullSizeListLayout:SlideShowLayout = new SlideShowLayout();
			fullSizeListLayout.horizontalAlign = HorizontalAlign.JUSTIFY;
			fullSizeListLayout.verticalAlign = VerticalAlign.JUSTIFY;
			//load the previous and next items so that they are already visible
			//if images use a lot of memory, this might not be possible for
			//some galleries!
			fullSizeListLayout.minimumItemCount = 3;

			this.fullSizeList = new List();
			//snap to the nearest page when scrolling
			this.fullSizeList.snapToPages = true;
			//there is nothing to select in this list
			this.fullSizeList.isSelectable = false;
			//no need to display scroll bars in this list
			this.fullSizeList.scrollBarDisplayMode = ScrollBarDisplayMode.NONE;
			//make sure that we have elastic edges horizontally
			this.fullSizeList.horizontalScrollPolicy = ScrollPolicy.ON;
			this.fullSizeList.layout = fullSizeListLayout;
			this.fullSizeList.layoutData = fullSizeListLayoutData;
			this.fullSizeList.itemRendererFactory = fullSizeItemRendererFactory;
			this.addChild(this.fullSizeList);

			//display at the center of the list of full size images
			var messageLayoutData:AnchorLayoutData = new AnchorLayoutData();
			messageLayoutData.horizontalCenter = 0;
			messageLayoutData.verticalCenter = 0;
			messageLayoutData.verticalCenterAnchorDisplayObject = this.fullSizeList;

			this.message = new Label();
			this.message.text = "Loading...";
			this.message.layoutData = messageLayoutData;
			this.addChild(this.message);
		}

		protected function fullSizeItemRendererFactory():IListItemRenderer
		{
			return new GalleryItemRenderer();
		}

		protected function thumbnailItemRendererFactory():IListItemRenderer
		{
			var itemRenderer:ThumbItemRenderer = new ThumbItemRenderer();
			//cache the textures so that they don't need to be reloaded from URLs
			itemRenderer.textureCache = this.thumbnailTextureCache;
			//limit how large these item renderers can be
			itemRenderer.maxWidth = 100;
			itemRenderer.maxHeight = 100;
			return itemRenderer;
		}

		protected function thumbnailList_changeHandler(event:starling.events.Event):void
		{
			var item:GalleryItem = GalleryItem(this.thumbnailList.selectedItem);
			if(!item)
			{
				return;
			}
			this.fullSizeList.scrollToDisplayIndex(this.thumbnailList.selectedIndex, 0.5);
		}

		protected function apiLoader_completeListener(event:flash.events.Event):void
		{
			var result:XML = XML(this.apiLoader.data);
			if(result.attribute("stat") == "fail")
			{
				message.text = "Unable to load the list of images from Flickr at this time.";
				return;
			}
			var items:Vector.<GalleryItem> = new <GalleryItem>[];
			var photosList:XMLList = result.photos.photo;
			var photoCount:int = photosList.length();
			for(var i:int = 0; i < photoCount; i++)
			{
				var photoXML:XML = photosList[i];
				var url:String = FLICKR_PHOTO_URL.replace("{farm-id}", photoXML.@farm.toString());
				url = url.replace("{server-id}", photoXML.@server.toString());
				url = url.replace("{id}", photoXML.@id.toString());
				url = url.replace("{secret}", photoXML.@secret.toString());
				var thumbURL:String = url.replace("{size}", "t");
				url = url.replace("{size}", "b");
				var title:String = photoXML.@title.toString();
				items.push(new GalleryItem(title, url, thumbURL));
			}

			this.message.text = "";

			var collection:VectorCollection = new VectorCollection(items);
			this.thumbnailList.dataProvider = collection;
			this.fullSizeList.dataProvider = collection;
		}

		protected function apiLoader_errorListener(event:flash.events.Event):void
		{
			this.message.text = "Error loading images.";
		}
	}
}


================================================
FILE: examples/Gallery/source/feathers/examples/gallery/controls/GalleryItemRenderer.as
================================================
package feathers.examples.gallery.controls
{
	import feathers.controls.ImageLoader;
	import feathers.controls.List;
	import feathers.controls.ScrollBarDisplayMode;
	import feathers.controls.ScrollContainer;
	import feathers.controls.ScrollPolicy;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.core.FeathersControl;
	import feathers.events.FeathersEventType;
	import feathers.examples.gallery.data.GalleryItem;
	import feathers.examples.gallery.layout.GalleryItemRendererLayout;
	import feathers.layout.ILayout;
	import feathers.utils.display.calculateScaleRatioToFit;
	import feathers.utils.touch.TapToSelect;
	import feathers.utils.touch.TouchSheet;

	import flash.geom.Point;
	import flash.utils.Dictionary;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	/**
	 * A list item renderer that displays an image that may be zoomed.
	 */
	public class GalleryItemRenderer extends ScrollContainer implements IListItemRenderer
	{
		/**
		 * Constructor.
		 */
		public function GalleryItemRenderer()
		{
			super();
			//the default layout for a scroll container doesn't work well when
			//TouchSheet gestures move it into negative coordinates.
			this.layout = new GalleryItemRendererLayout();
			//when we reach the edge, we want to stop without elasticity
			this.hasElasticEdges = false;
		}

		/**
		 * @private
		 */
		protected var touchSheet:TouchSheet = null;

		/**
		 * @private
		 */
		protected var image:ImageLoader = null;

		/**
		 * @private
		 */
		private var _index:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get index():int
		{
			return this._index;
		}

		/**
		 * @private
		 */
		public function set index(value:int):void
		{
			if(this._index == value)
			{
				return;
			}
			this._index = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		private var _factoryID:String = null;

		/**
		 * @inheritDoc
		 */
		public function get factoryID():String
		{
			return this._factoryID;
		}

		/**
		 * @private
		 */
		public function set factoryID(value:String):void
		{
			this._factoryID = value;
		}

		/**
		 * @private
		 */
		protected var _owner:List = null;

		/**
		 * @inheritDoc
		 */
		public function get owner():List
		{
			return List(this._owner);
		}

		/**
		 * @private
		 */
		public function set owner(value:List):void
		{
			if(this._owner == value)
			{
				return;
			}
			if(this._owner !== null)
			{
				this._owner.removeEventListener(FeathersEventType.SCROLL_COMPLETE, owner_scrollCompleteHandler);
			}
			this._owner = value;
			if(this._owner !== null)
			{
				this._owner.addEventListener(FeathersEventType.SCROLL_COMPLETE, owner_scrollCompleteHandler);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		private var _data:GalleryItem = null;

		/**
		 * @inheritDoc
		 */
		public function get data():Object
		{
			return this._data;
		}

		/**
		 * @private
		 */
		public function set data(value:Object):void
		{
			if(this._data == value)
			{
				return;
			}
			this._data = GalleryItem(value);
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		private var _isSelected:Boolean;

		/**
		 * @inheritDoc
		 */
		public function get isSelected():Boolean
		{
			return this._isSelected;
		}

		/**
		 * @private
		 */
		public function set isSelected(value:Boolean):void
		{
			if(this._isSelected == value)
			{
				return;
			}
			this._isSelected = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 * If the scale value is less than this after a zoom gesture ends, the
		 * scale will be animated back to this value. The default scale may be
		 * updated when a new texture is loaded.
		 */
		protected var _defaultScale:Number = 1;

		/**
		 * @private
		 */
        protected var _gestureCompleteTween:Tween = null;

		/**
		 * @private
		 */
		override public function hitTest(localPoint:Point):DisplayObject
		{
			var target:DisplayObject = super.hitTest(localPoint);
			if(target === this)
			{
				//the TouchSheet may not fill the entire width and height of
				//the item renderer, but we want the gestures to work from
				//anywhere within the item renderer's bounds.
				return this.touchSheet;
			}
			return target;
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			super.initialize();

			this.image = new ImageLoader();
			this.image.addEventListener(Event.COMPLETE, image_completeHandler);
			this.image.addEventListener(FeathersEventType.ERROR, image_errorHandler);

			//this is a custom version of TouchSheet designed to work better
			//with Feathers scrolling containers
			this.touchSheet = new TouchSheet(this.image);
			//you can disable certain features of this TouchSheet
			this.touchSheet.zoomEnabled = true;
			this.touchSheet.rotateEnabled = false;
			this.touchSheet.moveEnabled = false;
			//and events are dispatched when any of the gestures are performed
			this.touchSheet.addEventListener(TouchSheet.MOVE, touchSheet_gestureHandler);
			this.touchSheet.addEventListener(TouchSheet.ROTATE, touchSheet_gestureHandler);
			this.touchSheet.addEventListener(TouchSheet.ZOOM, touchSheet_gestureHandler);
			//on TouchPhase.ENDED, any gestures performed are complete
			this.touchSheet.addEventListener(TouchEvent.TOUCH, touchSheet_touchHandler);
			this.addChild(this.touchSheet);
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			if(dataInvalid)
			{
				if(this._data !== null)
				{
					if(this.image.source !== this._data.url)
					{
						//hide until the image finishes loading
						this.touchSheet.visible = false;
					}
					this.image.source = this._data.url;
				}
				else
				{
					this.image.source = null;
				}
				//stop any active animations because it's a new image
				if(this._gestureCompleteTween !== null)
				{
					this.stage.starling.juggler.remove(this._gestureCompleteTween);
					this._gestureCompleteTween = null;
				}
				//reset all of the transformations because it's a new image
				this._defaultScale = 1;
				this.resetTransformation();
			}

			super.draw();
		}

		/**
		 * @private
		 */
		protected function resetTransformation():void
		{
			this.touchSheet.rotation = 0;
			this.touchSheet.scale = this._defaultScale;
			this.touchSheet.pivotX = 0;
			this.touchSheet.pivotY = 0;
			this.touchSheet.x = 0;
			this.touchSheet.y = 0;
		}

		/**
		 * @private
		 */
		protected function image_completeHandler(event:Event):void
		{
			//when an image first loads, we want it to fill the width and height
			//of the item renderer, without being larger than the item renderer
			this._defaultScale = calculateScaleRatioToFit(
				this.image.originalSourceWidth, this.image.originalSourceHeight,
				this.viewPort.visibleWidth, this.viewPort.visibleHeight);
			if(this._defaultScale > 1)
			{
				//however, we only want to make large images smaller. small
				//images should not be made larger because they'll get blurry.
				//the user can zoom in, if desired.
				this._defaultScale = 1;
			}
			this.touchSheet.scale = this._defaultScale;
			this.touchSheet.visible = true;
		}

		/**
		 * @private
		 */
		protected function image_errorHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected function touchSheet_touchHandler(event:TouchEvent):void
		{
			//the current gesture is complete on TouchPhase.ENDED
			var touch:Touch = event.getTouch(this.touchSheet, TouchPhase.ENDED);
			if(touch === null)
			{
				return;
			}

			//if the scale is smaller than the default, animate it back
			var targetScale:Number = this.touchSheet.scale;
			if(targetScale < this._defaultScale)
			{
				targetScale = this._defaultScale;
			}
			if(this.touchSheet.scale !== targetScale)
			{
				this._gestureCompleteTween = new Tween(this.touchSheet, 0.15, Transitions.EASE_OUT);
				this._gestureCompleteTween.scaleTo(targetScale);
				this._gestureCompleteTween.onComplete = this.gestureCompleteTween_onComplete;
				this.stage.starling.juggler.add(this._gestureCompleteTween);
			}
		}

		/**
		 * @private
		 */
		protected function touchSheet_gestureHandler(event:Event):void
		{
			//if the animation from the previous gesture is still active, stop
			//it immediately when a new gesture starts
			if(this._gestureCompleteTween !== null)
			{
				this.stage.starling.juggler.remove(this._gestureCompleteTween);
				this._gestureCompleteTween = null;
			}
		}

		/**
		 * @private
		 */
		protected function gestureCompleteTween_onComplete():void
		{
			this._gestureCompleteTween = null;
		}

		/**
		 * @private
		 */
		protected function owner_scrollCompleteHandler(event:Event):void
		{
			if(this._owner.horizontalPageIndex === this._index)
			{
				return;
			}
			this.resetTransformation();
		}
	}
}

================================================
FILE: examples/Gallery/source/feathers/examples/gallery/controls/ThumbItemRenderer.as
================================================
package feathers.examples.gallery.controls
{
	import feathers.controls.ImageLoader;
	import feathers.controls.List;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.core.FeathersControl;
	import feathers.events.FeathersEventType;
	import feathers.examples.gallery.data.GalleryItem;
	import feathers.utils.textures.TextureCache;
	import feathers.utils.touch.TapToSelect;

	import flash.geom.Point;
	import flash.utils.Dictionary;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.events.Event;

	/**
	 * Renders a simple thumbnail image with animation to fade in when it
	 * completes loading.
	 */
	public class ThumbItemRenderer extends FeathersControl implements IListItemRenderer
	{
		/**
		 * @private
		 * This will only work in a single list. If this item renderer needs to
		 * be used by multiple lists, this data should be stored differently.
		 */
		private static const CACHED_BOUNDS:Dictionary = new Dictionary(false);

		/**
		 * Constructor.
		 */
		public function ThumbItemRenderer()
		{
			//optimization: this item renderer doesn't have interactive children
			this.isQuickHitAreaEnabled = true;
		}

		/**
		 * @private
		 */
		protected var image:ImageLoader;

		/**
		 * @private
		 */
		protected var fadeTween:Tween;

		/**
		 * @private
		 */
		private var _index:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get index():int
		{
			return this._index;
		}

		/**
		 * @private
		 */
		public function set index(value:int):void
		{
			if(this._index == value)
			{
				return;
			}
			this._index = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		private var _factoryID:String;

		/**
		 * @inheritDoc
		 */
		public function get factoryID():String
		{
			return this._factoryID;
		}

		/**
		 * @private
		 */
		public function set factoryID(value:String):void
		{
			this._factoryID = value;
		}

		/**
		 * @private
		 */
		protected var _owner:List;

		/**
		 * @inheritDoc
		 */
		public function get owner():List
		{
			return List(this._owner);
		}

		/**
		 * @private
		 */
		public function set owner(value:List):void
		{
			if(this._owner == value)
			{
				return;
			}
			if(this._owner)
			{
				this._owner.removeEventListener(FeathersEventType.SCROLL_START, owner_scrollStartHandler);
				this._owner.removeEventListener(FeathersEventType.SCROLL_COMPLETE, owner_scrollCompleteHandler);
			}
			this._owner = value;
			if(this._owner)
			{
				if(this.image)
				{
					this.image.delayTextureCreation = this._owner.isScrolling;
				}
				this._owner.addEventListener(FeathersEventType.SCROLL_START, owner_scrollStartHandler);
				this._owner.addEventListener(FeathersEventType.SCROLL_COMPLETE, owner_scrollCompleteHandler);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		private var _tapToSelect:TapToSelect;

		/**
		 * @private
		 */
		private var _data:GalleryItem;

		/**
		 * @inheritDoc
		 */
		public function get data():Object
		{
			return this._data;
		}

		/**
		 * @private
		 */
		public function set data(value:Object):void
		{
			if(this._data == value)
			{
				return;
			}
			this._data = GalleryItem(value);
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		private var _isSelected:Boolean;

		/**
		 * @inheritDoc
		 */
		public function get isSelected():Boolean
		{
			return this._isSelected;
		}

		/**
		 * @private
		 */
		public function set isSelected(value:Boolean):void
		{
			if(this._isSelected == value)
			{
				return;
			}
			this._isSelected = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		private var _textureCache:TextureCache;

		/**
		 * @inheritDoc
		 */
		public function get textureCache():TextureCache
		{
			return this._textureCache;
		}

		/**
		 * @private
		 */
		public function set textureCache(value:TextureCache):void
		{
			if(this._textureCache == value)
			{
				return;
			}
			this._textureCache = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			super.initialize();

			this.image = new ImageLoader();
			this.image.textureQueueDuration = 0.25;
			this.image.addEventListener(Event.COMPLETE, image_completeHandler);
			this.image.addEventListener(FeathersEventType.ERROR, image_errorHandler);
			this.addChild(this.image);

			this._tapToSelect = new TapToSelect(this);
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);

			this.image.textureCache = this._textureCache;

			if(dataInvalid)
			{
				if(this.fadeTween)
				{
					this.fadeTween.advanceTime(Number.MAX_VALUE);
				}
				if(this._data)
				{
					this.image.visible = false;
					this.image.source = this._data.thumbURL;
				}
				else
				{
					this.image.source = null;
				}
			}

			this.autoSizeIfNeeded();
			this.layoutChildren();
		}

		/**
		 * @private
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = isNaN(this._explicitWidth);
			var needsHeight:Boolean = isNaN(this._explicitHeight);
			var needsMinWidth:Boolean = isNaN(this._explicitMinWidth);
			var needsMinHeight:Boolean = isNaN(this._explicitMinHeight);
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			//pass all of these values down to the ImageLoader
			//because they can affect its measured dimensions
			this.image.width = this._explicitWidth;
			this.image.height = this._explicitHeight;
			this.image.minWidth = this._explicitMinWidth;
			this.image.minHeight = this._explicitMinHeight;
			this.image.maxWidth = this._explicitMaxWidth;
			this.image.maxHeight = this._explicitMaxHeight;
			this.image.validate();
			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				if(this.image.isLoaded)
				{
					if(!CACHED_BOUNDS.hasOwnProperty(this._index))
					{
						CACHED_BOUNDS[this._index] = new Point();
					}
					var boundsFromCache:Point = Point(CACHED_BOUNDS[this._index]);
					//also save it to a cache so that we can reuse the width and
					//height values later if the same image needs to be loaded
					//again.
					newWidth = boundsFromCache.x = this.image.width;
				}
				else
				{
					if(CACHED_BOUNDS.hasOwnProperty(this._index))
					{
						//if the image isn't loaded yet, but we've loaded it at
						//least once before, we can use a cached value to avoid
						//jittering when the image resizes
						boundsFromCache = Point(CACHED_BOUNDS[this._index]);
						newWidth = boundsFromCache.x;
					}
					else
					{
						//default to 100 if we've never displayed an image for
						//this index yet.
						newWidth = 100;
					}

				}
			}
			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				if(this.image.isLoaded)
				{
					if(!CACHED_BOUNDS.hasOwnProperty(this._index))
					{
						CACHED_BOUNDS[this._index] = new Point();
					}
					boundsFromCache = Point(CACHED_BOUNDS[this._index]);
					newHeight = boundsFromCache.y = this.image.height;
				}
				else
				{
					if(CACHED_BOUNDS.hasOwnProperty(this._index))
					{
						boundsFromCache = Point(CACHED_BOUNDS[this._index]);
						newHeight = boundsFromCache.y;
					}
					else
					{
						newHeight = 100;
					}
				}
			}
			return this.saveMeasurements(newWidth, newHeight, newWidth, newHeight);
		}

		/**
		 * @private
		 */
		protected function layoutChildren():void
		{
			this.image.width = this.actualWidth;
			this.image.height = this.actualHeight;
			this.image.validate();
		}

		/**
		 * @private
		 */
		protected function fadeTween_onComplete():void
		{
			this.fadeTween = null;
		}

		/**
		 * @private
		 */
		protected function owner_scrollStartHandler(event:Event):void
		{
			this.image.delayTextureCreation = true;
		}

		/**
		 * @private
		 */
		protected function owner_scrollCompleteHandler(event:Event):void
		{
			this.image.delayTextureCreation = false;
		}

		/**
		 * @private
		 */
		protected function image_completeHandler(event:Event):void
		{
			this.image.alpha = 0;
			this.image.visible = true;
			this.fadeTween = new Tween(this.image, 1, Transitions.EASE_OUT);
			this.fadeTween.fadeTo(1);
			this.fadeTween.onComplete = fadeTween_onComplete;
			Starling.juggler.add(this.fadeTween);
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		protected function image_errorHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

	}
}


================================================
FILE: examples/Gallery/source/feathers/examples/gallery/data/GalleryItem.as
================================================
package feathers.examples.gallery.data
{
	public class GalleryItem
	{
		public function GalleryItem(title:String, url:String, thumbURL:String)
		{
			this.title = title;
			this.url = url;
			this.thumbURL = thumbURL;
		}

		public var title:String;
		public var url:String;
		public var thumbURL:String;
	}
}


================================================
FILE: examples/Gallery/source/feathers/examples/gallery/layout/GalleryItemRendererLayout.as
================================================
package feathers.examples.gallery.layout
{
	import feathers.layout.ILayout;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.ViewPortBounds;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;
	import flash.geom.Rectangle;

	import starling.display.DisplayObject;
	import starling.events.EventDispatcher;
	import starling.utils.Pool;

	public class GalleryItemRendererLayout extends EventDispatcher implements ILayout
	{
		public function GalleryItemRendererLayout()
		{
			super();
		}

		public function get requiresLayoutOnScroll():Boolean
		{
			return false;
		}

		public function layout(items:Vector.<DisplayObject>, viewPortBounds:ViewPortBounds = null, result:LayoutBoundsResult = null):LayoutBoundsResult
		{
			var itemCount:int = items.length;
			if(itemCount > 1)
			{
				throw new IllegalOperationError("GalleryItemLayout may not have more than one item.");
			}
			if(!result)
			{
				result = new LayoutBoundsResult();
			}
			var minX:Number = Number.POSITIVE_INFINITY;
			var minY:Number = Number.POSITIVE_INFINITY;
			var maxX:Number = Number.NEGATIVE_INFINITY;
			var maxY:Number = Number.NEGATIVE_INFINITY;
			if(itemCount > 0)
			{
				var item:DisplayObject = items[0];
				var itemBounds:Rectangle = item.getBounds(item.parent, Pool.getRectangle());
				if(itemBounds.x < minX)
				{
					minX = itemBounds.x;
				}
				if(itemBounds.y < minY)
				{
					minY = itemBounds.y;
				}
				var itemMaxX:Number = itemBounds.x + itemBounds.width;
				if(itemMaxX > maxX)
				{
					maxX = itemMaxX;
				}
				var itemMaxY:Number = itemBounds.y + itemBounds.height;
				if(itemMaxY > maxY)
				{
					maxY = itemMaxY;
				}
				Pool.putRectangle(itemBounds);
			}
			if(minX == Number.POSITIVE_INFINITY)
			{
				minX = 0;
			}
			if(minY == Number.POSITIVE_INFINITY)
			{
				minY = 0;
			}
			if(maxX == Number.NEGATIVE_INFINITY)
			{
				maxX = 0;
			}
			if(maxY == Number.NEGATIVE_INFINITY)
			{
				maxY = 0;
			}
			var contentX:Number = minX;
			var contentY:Number = minY;
			var contentWidth:Number = maxX - minX;
			var contentHeight:Number = maxY - minY;
			var viewPortWidth:Number = contentWidth;
			var viewPortHeight:Number = contentHeight;
			if(viewPortBounds && viewPortBounds.explicitWidth === viewPortBounds.explicitWidth)
			{
				viewPortWidth = viewPortBounds.explicitWidth;
			}
			if(viewPortBounds && viewPortBounds.explicitHeight === viewPortBounds.explicitHeight)
			{
				viewPortHeight = viewPortBounds.explicitHeight;
			}
			if(contentWidth <= viewPortWidth)
			{
				contentX -= (viewPortWidth - contentWidth) / 2;
				contentWidth = viewPortWidth;
			}
			if(contentHeight <= viewPortHeight)
			{
				contentY -= (viewPortHeight - contentHeight) / 2;
				contentHeight = viewPortHeight;
			}
			result.contentX = contentX;
			result.contentY = contentY;
			result.contentWidth = contentWidth;
			result.contentHeight = contentHeight;
			result.viewPortWidth = viewPortWidth;
			result.viewPortHeight = viewPortHeight;
			return result;
		}

		public function calculateNavigationDestination(items:Vector.<DisplayObject>, index:int, keyCode:uint, bounds:LayoutBoundsResult):int
		{
			return 0;
		}

		public function getScrollPositionForIndex(index:int, items:Vector.<DisplayObject>,
			x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			if(!result)
			{
				return new Point(0, 0);
			}
			result.setTo(0, 0);
			return result;
		}

		public function getNearestScrollPositionForIndex(index:int, scrollX:Number, scrollY:Number,
			items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			return getScrollPositionForIndex(index, items, x, y, width, height, result);
		}
	}
}

================================================
FILE: examples/Gallery/source/feathers/utils/touch/TouchSheet.as
================================================
package feathers.utils.touch
{
    import feathers.controls.LayoutGroup;
    import feathers.events.ExclusiveTouch;

    import flash.geom.Point;

    import starling.display.DisplayObject;
    import starling.display.Sprite;
    import starling.events.Touch;
    import starling.events.TouchEvent;
    import starling.events.TouchPhase;
    import starling.utils.Pool;

    /**
     * A modified version of TouchSheet for Feathers.
     */
    public class TouchSheet extends LayoutGroup
    {
        public static const MOVE:String = "move";
        public static const ZOOM:String = "zoom";
        public static const ROTATE:String = "rotate";

        public function TouchSheet(contents:DisplayObject=null)
        {
            addEventListener(TouchEvent.TOUCH, onTouch);
            useHandCursor = true;
            
            if (contents)
            {
                contents.x = int(contents.width / -2);
                contents.y = int(contents.height / -2);
                addChild(contents);
            }
        }

        public var moveEnabled:Boolean = true;
        public var rotateEnabled:Boolean = true;
        public var zoomEnabled:Boolean = true;
        public var bringToFrontEnabled:Boolean = true;
        protected var touchAID:int = -1;
        protected var touchBID:int = -1;
        
        private function onTouch(event:TouchEvent):void
        {
            var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);

            //first check if the existing touches ended
            if(touchBID != -1)
            {
                var touchB:Touch = event.getTouch(this, null, touchBID);
                if(touchB !== null)
                {
                    if(touchB.phase === TouchPhase.ENDED)
                    {
                        touchBID = -1;
                    }
                    else
                    {
                        //if the touch has been claimed since we first started
                        //watching it, we can no longer use it
                        var claim:DisplayObject = exclusiveTouch.getClaim(touchBID);
                        if(claim !== null && claim !== this)
                        {
                            touchBID = -1;
                        }
                    }
                }
            }
            //we checeked touch b first because a might be replaced by b
            if(touchAID != -1)
            {
                var touchA:Touch = event.getTouch(this, null, touchAID);
                if(touchA !== null)
                {
                    if(touchA.phase === TouchPhase.ENDED)
                    {
                        touchAID = touchBID;
                        touchBID = -1;
                    }
                    else
                    {
                        claim = exclusiveTouch.getClaim(touchAID);
                        if(claim !== null && claim !== this)
                        {
                            touchAID = touchBID;
                            touchBID = -1;
                        }
                    }
                }
            }
            //then, check for new touches, if necessary
            if(touchAID == -1 || touchBID == -1)
            {
                var touches:Vector.<Touch> = event.getTouches(this, TouchPhase.BEGAN);
                var touchCount:int = touches.length;
                for(var i:int = 0; i < touchCount; i++)
                {
                    var touch:Touch = touches[i];
                    claim = exclusiveTouch.getClaim(touch.id);
                    if(claim !== null)
                    {
                        //this touch is claimed, so we can't use it
                        continue;
                    }
                    if(touchAID == -1)
                    {
                        touchAID = touch.id;
                        if(this.moveEnabled)
                        {
                            exclusiveTouch.claimTouch(touchAID, this);
                        }
                    }
                    else if(touchBID == -1)
                    {
                        touchBID = touch.id;
                        //if we've found both touches, claim them to stop containers
                        //from scrolling
                        exclusiveTouch.claimTouch(touchAID, this);
                        exclusiveTouch.claimTouch(touchBID, this);
                    }
                }
            }
            //do a multi-touch gesture if we have enough touches
            if(touchAID != -1 && touchBID != -1)
            {
                // two fingers touching -> rotate and scale
                touchA = event.getTouch(this, null, touchAID);
                touchB = event.getTouch(this, null, touchBID);
                if(touchA.phase !== TouchPhase.MOVED && touchB.phase !== TouchPhase.MOVED)
                {
                    //neither touch moved, so nothing has changed
                    return;
                }
                
                // updated to use stage instead of parent because the
                // parent might move, but the stage never will. -JT
                var currentPosA:Point  = touchA.getLocation(stage, Pool.getPoint());
                var previousPosA:Point = touchA.getPreviousLocation(stage, Pool.getPoint());
                var currentPosB:Point  = touchB.getLocation(stage, Pool.getPoint());
                var previousPosB:Point = touchB.getPreviousLocation(stage, Pool.getPoint());
                
                var currentVector:Point  = currentPosA.subtract(currentPosB);
                var previousVector:Point = previousPosA.subtract(previousPosB);
                
                var currentAngle:Number  = Math.atan2(currentVector.y, currentVector.x);
                var previousAngle:Number = Math.atan2(previousVector.y, previousVector.x);
                var deltaAngle:Number = currentAngle - previousAngle;

                // update pivot point based on previous center
                var point:Point = Pool.getPoint(
                    (previousPosA.x + previousPosB.x) * 0.5,
                    (previousPosA.y + previousPosB.y) * 0.5);
                globalToLocal(point, point);
                pivotX = point.x;
                pivotY = point.y;

                // update location based on the current center
                point.setTo(
                    (currentPosA.x + currentPosB.x) * 0.5,
                    (currentPosA.y + currentPosB.y) * 0.5);
                parent.globalToLocal(point, point);
                x = point.x;
                y = point.y;

                Pool.putPoint(point);
                Pool.putPoint(currentPosA);
                Pool.putPoint(previousPosA);
                Pool.putPoint(currentPosB);
                Pool.putPoint(previousPosB);

                if (rotateEnabled && deltaAngle != 0)
                {
                    rotation += deltaAngle;
                    dispatchEventWith(ROTATE);
                }

                var sizeDiff:Number = currentVector.length / previousVector.length;
                if (zoomEnabled && sizeDiff !== 1)
                {
                    var zoomed:Boolean = false;
                    var newScaleX:Number = scaleX * sizeDiff;
                    if(scaleX !== newScaleX)
                    {
                        scaleX = newScaleX;
                        zoomed = true;
                    }
                    var newScaleY:Number = scaleY * sizeDiff;
                    if(scaleY !== newScaleY)
                    {
                        scaleY = newScaleY;
                        zoomed = true;
                    }
                    if(zoomed)
                    {
                        dispatchEventWith(ZOOM);
                    }
                }
            }
            else if(touchAID != -1) //single touch gesture
            {
                touchA = event.getTouch(this, null, touchAID);
                if (moveEnabled)
                {
                    // one finger touching -> move

                    // updated to use stage instead of parent because the
                    // parent might move, but the stage won't -JT
                    var delta:Point = touchA.getMovement(stage, Pool.getPoint());
                    if(delta.length != 0)
                    {
                        x += delta.x;
                        y += delta.y;

                        dispatchEventWith(MOVE);
                    }
                    Pool.putPoint(delta);
                }
            }
            
            var touchEnded:Touch = event.getTouch(this, TouchPhase.ENDED);
            if (touchEnded)
            {
                if (bringToFrontEnabled && touchEnded.tapCount == 2)
                {
                    parent.addChild(this); // bring self to front
                }
            }
        }
    }
}

================================================
FILE: examples/HelloWorld/README.md
================================================
# Hello World Example for Feathers

A very simple example that creates a Button control from the [Feathers](http://feathersui.com/) library, presented as a mobile app.

## Requirements

In addition to Starling Framework and Feathers, this example project requires the `MetalWorksMobileTheme` example theme. You can find the SWC file for this theme at the following location in the Feathers release build:

	themes/MetalWorksMobileTheme/swc/MetalWorksMobileTheme.swc

## Web Demo

View the [Hello World Example](http://feathersui.com/examples/hello-world/) in your browser.

================================================
FILE: examples/HelloWorld/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
theme.root = ${basedir}/../../themes/MetalWorksMobileTheme/source
output.path = ${basedir}/output
icon.path = ${basedir}/../shared-assets/icons
launch.image.path = ${basedir}/../shared-assets/launch-images-windowed

swf.version = 30

================================================
FILE: examples/HelloWorld/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="hello-world" default="build" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<target name="build" depends="build-web,build-android,build-ios"/>

	<target name="prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="build-web" depends="prepare">
		<echo message="Building HelloWorldWeb.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-frame=two,feathers.examples.helloWorld.Main"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/HelloWorldWeb.as"/>
			<arg value="-output=${output.path}/HelloWorldWeb.swf"/>
		</java>
	</target>

	<target name="build-air-swf" depends="prepare">
		<echo message="Building HelloWorld.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/HelloWorld.as"/>
			<arg value="-output=${output.path}/HelloWorld.swf"/>
		</java>
	</target>
	<target name="-check-ios-properties">
		<fail unless="ios.provision.path"/>
		<fail unless="ios.certificate.path"/>
		<fail unless="ios.certificate.password"/>
	</target>
	<target name="build-ios" depends="-check-ios-properties,build-air-swf">
		<echo message="Packaging HelloWorld.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="ipa-app-store"/>
			<arg value="-provisioning-profile"/>
			<arg value="${ios.provision.path}"/>
			<arg value="-keystore"/>
			<arg value="${ios.certificate.path}"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-storepass"/>
			<arg value="${ios.certificate.password}"/>
			<arg value="${output.path}/HelloWorld.ipa"/>
			<arg value="source/HelloWorld-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${launch.image.path}"/>
			<arg value="Default~iphone.png"/>							<!-- iphone 3gs -->
			<arg value="Default@2x~iphone.png"/>						<!-- iphone 4/4s -->
			<arg value="Default-568h@2x~iphone.png"/>					<!-- iphone 5/5c/5s -->
			<arg value="Default-375w-667h@2x~iphone.png"/>				<!-- iphone 6/7/8 -->
			<arg value="Default-812h@3x~iphone.png"/>					<!-- iphone x (portrait) -->
			<arg value="Default-Landscape-812h@3x~iphone.png"/>			<!-- iphone x (landscape) -->
			<arg value="Default-414w-736h@3x~iphone.png"/>				<!-- iphone 6/7/8 plus (portrait) -->
			<arg value="Default-Landscape-414w-736h@3x~iphone.png"/>	<!-- iphone 6/7/8 plus (landscape) -->
			<arg value="Default-Portrait~ipad.png"/>					<!-- ipad 1/2 (portrait) -->
			<arg value="Default-PortraitUpsideDown~ipad.png"/>			<!-- ipad 1/2 (portrait upside down) -->
			<arg value="Default-Landscape~ipad.png"/>					<!-- ipad 1/2 (landscape left) -->
			<arg value="Default-LandscapeRight~ipad.png"/>				<!-- ipad 1/2 (landscape right) -->
			<arg value="Default-Portrait@2x~ipad.png"/>					<!-- ipad 3/air (portrait) -->
			<arg value="Default-LandscapeLeft@2x~ipad.png"/>			<!-- ipad 3/air (landscape left) -->
			<arg value="Default-LandscapeRight@2x~ipad.png"/>			<!-- ipad 3/air (landscape right) -->
			<arg value="Default-Portrait@2x.png"/>						<!-- ipad pro (portrait) -->
			<arg value="Default-Landscape@2x.png"/>						<!-- ipad pro (landscape) -->
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="HelloWorld.swf"/>
		</java>
	</target>
	<target name="-check-android-properties">
		<fail unless="android.certificate.path"/>
		<fail unless="android.certificate.password"/>
	</target>
	<target name="build-android" depends="-check-android-properties,build-air-swf">
		<echo message="Packaging HelloWorld.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="apk-captive-runtime"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-keystore"/>
			<arg value="${android.certificate.path}"/>
			<arg value="-storepass"/>
			<arg value="${android.certificate.password}"/>
			<arg value="${output.path}/HelloWorld.apk"/>
			<arg value="source/HelloWorld-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="HelloWorld.swf"/>
		</java>
	</target>
	<target name="install-android">
		<echo message="Installing HelloWorld.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.HelloWorld"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-package"/>
			<arg value="${output.path}/HelloWorld.apk"/>
		</java>
	</target>
	<target name="install-ios">
		<echo message="Installing HelloWorld.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.HelloWorld"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-package"/>
			<arg value="${output.path}/HelloWorld.ipa"/>
		</java>
	</target>
</project>

================================================
FILE: examples/HelloWorld/source/HelloWorld-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.examples.HelloWorld</id>
	<filename>Hello World</filename>
	<name>Hello World</name>
	<versionNumber>4.2.0</versionNumber>
	<description>Hello World example application built with Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>HelloWorld.swf</content>
		<autoOrients>true</autoOrients>
		<fullScreen>false</fullScreen>
		<visible>true</visible>
		<renderMode>direct</renderMode>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>

	<icon>
		<image29x29>icon29.png</image29x29>
		<image48x48>icon48.png</image48x48>
		<image50x50>icon50.png</image50x50>
		<image57x57>icon57.png</image57x57>
		<image58x58>icon58.png</image58x58>
		<image72x72>icon72.png</image72x72>
		<image87x87>icon87.png</image87x87>
		<image96x96>icon96.png</image96x96>
		<image100x100>icon100.png</image100x100>
		<image114x114>icon114.png</image114x114>
		<image128x128>icon128.png</image128x128>
		<image144x144>icon144.png</image144x144>
		<image180x180>icon180.png</image180x180>
	</icon>
	<android>
		<colorDepth>16bit</colorDepth>
		<manifestAdditions><![CDATA[
			<manifest android:installLocation="auto">
			    <uses-permission android:name="android.permission.INTERNET"/>
			</manifest>
		]]></manifestAdditions>
	</android>
	<iPhone>
		<InfoAdditions>
		<![CDATA[
			<key>UIDeviceFamily</key> 
			<array> 
				<string>1</string>
				<string>2</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<true/>
			<key>UIStatusBarStyle</key>
			<string>UIStatusBarStyleLightContent</string>
		]]> 
		</InfoAdditions>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</iPhone>
</application>

================================================
FILE: examples/HelloWorld/source/HelloWorld.as
================================================
package
{
	import feathers.examples.helloWorld.Main;
	import feathers.utils.ScreenDensityScaleFactorManager;

	import flash.display.Loader;
	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageOrientation;
	import flash.display.StageScaleMode;
	import flash.display3D.Context3DProfile;
	import flash.display3D.Context3DRenderMode;
	import flash.events.Event;
	import flash.filesystem.File;
	import flash.filesystem.FileMode;
	import flash.filesystem.FileStream;
	import flash.system.Capabilities;
	import flash.utils.ByteArray;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class HelloWorld extends Sprite
	{
		public function HelloWorld()
		{
			if(this.stage)
			{
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
				this.stage.align = StageAlign.TOP_LEFT;
			}
			this.mouseEnabled = this.mouseChildren = false;
			this.showLaunchImage();
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;
		private var _scaler:ScreenDensityScaleFactorManager;
		private var _launchImage:Loader;
		private var _savedAutoOrients:Boolean;

		/**
		 * On iOS, add the native launch image to the classic display list to
		 * avoid displaying only the stage background color between when the
		 * AIR app finishes launching and Starling starts rendering.
		 * 
		 * Launch image names: https://forums.adobe.com/message/9986239#9986239
		 */
		private function showLaunchImage():void
		{
			var filePath:String = null;
			var isPortraitOnly:Boolean = false;
			if(Capabilities.manufacturer.indexOf("iOS") >= 0)
			{
				var isPortraitUpsideDown:Boolean = this.stage.orientation == StageOrientation.UPSIDE_DOWN;
				var isPortrait:Boolean = this.stage.orientation == StageOrientation.DEFAULT || isPortraitUpsideDown;
				var isLandscapeRight:Boolean = this.stage.orientation == StageOrientation.ROTATED_RIGHT;
				if(Capabilities.screenResolutionX == 1242 && Capabilities.screenResolutionY == 2208)
				{
					//iphone 6/7/8 plus
					filePath = isPortrait ? "Default-414w-736h@3x~iphone.png" : "Default-Landscape-414w-736h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 1125 && Capabilities.screenResolutionY == 2436)
				{
					//iphone x
					filePath = isPortrait ? "Default-812h@3x~iphone.png" : "Default-Landscape-812h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 2048 && Capabilities.screenResolutionY == 2732)
				{
					//ipad pro
					filePath = isPortrait ? "Default-Portrait@2x.png" : "Default-Landscape@2x.png";
				}
				else if(Capabilities.screenResolutionX == 1536 && Capabilities.screenResolutionY == 2048)
				{
					//ipad 3/air
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait@2x~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown@2x~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight@2x~ipad.png";
					}
					else
					{
						filePath = "Default-LandscapeLeft@2x~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 768 && Capabilities.screenResolutionY == 1024)
				{
					//ipad 1/2
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight~ipad.png";
					}
					else
					{
						filePath = "Default-Landscape~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 750)
				{
					//iphone 6/7/8
					isPortraitOnly = true;
					filePath = "Default-375w-667h@2x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 640)
				{
					isPortraitOnly = true;
					if(Capabilities.screenResolutionY == 1136)
					{
						//iphone 5/5c/5s
						filePath = "Default-568h@2x~iphone.png";
					}
					else
					{
						//iphone 4/4s
						filePath = "Default@2x~iphone.png";
					}
				}
				else if(Capabilities.screenResolutionX == 320)
				{
					//iphone 3gs
					isPortraitOnly = true;
					filePath = "Default~iphone.png";
				}
			}

			if(filePath)
			{
				var file:File = File.applicationDirectory.resolvePath(filePath);
				if(file.exists)
				{
					var bytes:ByteArray = new ByteArray();
					var stream:FileStream = new FileStream();
					stream.open(file, FileMode.READ);
					stream.readBytes(bytes, 0, stream.bytesAvailable);
					stream.close();
					this._launchImage = new Loader();
					this._launchImage.loadBytes(bytes);
					this.addChild(this._launchImage);
					this._savedAutoOrients = this.stage.autoOrients;
					this.stage.autoOrients = false;
					if(isPortraitOnly)
					{
						this.stage.setOrientation(StageOrientation.DEFAULT);
					}
				}
			}
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(Main, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE);
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.start();
			if(this._launchImage)
			{
				this._starling.addEventListener("rootCreated", starling_rootCreatedHandler);
			}

			this._scaler = new ScreenDensityScaleFactorManager(this._starling);
			this.stage.addEventListener(Event.DEACTIVATE, stage_deactivateHandler, false, 0, true);
		}

		private function starling_rootCreatedHandler(event:Object):void
		{
			if(this._launchImage)
			{
				this.removeChild(this._launchImage);
				this._launchImage.unloadAndStop(true);
				this._launchImage = null;
				this.stage.autoOrients = this._savedAutoOrients;
			}
		}

		private function stage_deactivateHandler(event:Event):void
		{
			this._starling.stop(true);
			this.stage.addEventListener(Event.ACTIVATE, stage_activateHandler, false, 0, true);
		}

		private function stage_activateHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.ACTIVATE, stage_activateHandler);
			this._starling.start();
		}

	}
}

================================================
FILE: examples/HelloWorld/source/HelloWorldWeb.as
================================================
package
{
	import feathers.system.DeviceCapabilities;

	import flash.display.MovieClip;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.events.Event;
	import flash.geom.Rectangle;
	import flash.ui.ContextMenu;
	import flash.utils.getDefinitionByName;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class HelloWorldWeb extends MovieClip
	{
		public function HelloWorldWeb()
		{
			var menu:ContextMenu = new ContextMenu();
			menu.hideBuiltInItems();
			this.contextMenu = menu;
			
			if(this.stage)
			{
				this.stage.align = StageAlign.TOP_LEFT;
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
			}
			
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}
		
		private var _starling:Starling;
		
		private function start():void
		{
			this.gotoAndStop(2);
			this.graphics.clear();

			//simulating iPhone Retina
			DeviceCapabilities.dpi = 326;
			
			Starling.multitouchEnabled = true;
			var MainType:Class = getDefinitionByName("feathers.examples.helloWorld.Main") as Class;
			this._starling = new Starling(MainType, this.stage, new Rectangle(0, 0, 960, 640));
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.stage.stageWidth = 480;
			this._starling.stage.stageHeight = 320;
			this._starling.start();
		}
		
		private function loaderInfo_completeHandler(event:Event):void
		{
			this.start();
		}
	}
}

================================================
FILE: examples/HelloWorld/source/feathers/examples/helloWorld/Main.as
================================================
package feathers.examples.helloWorld
{
	import feathers.controls.Button;
	import feathers.controls.TextCallout;
	import feathers.themes.MetalWorksMobileTheme;

	import starling.display.Sprite;
	import starling.events.Event;

	/**
	 * An example to help you get started with Feathers. Creates a "theme" and
	 * displays a Button component that you can trigger.
	 *
	 * <p>Note: This example requires the MetalWorksMobileTheme, which is one of
	 * the themes included with Feathers.</p>
	 *
	 * @see http://feathersui.com/help/getting-started.html
	 */
	public class Main extends Sprite
	{
		/**
		 * Constructor.
		 */
		public function Main()
		{
			//we'll initialize things after we've been added to the stage
			this.addEventListener(Event.ADDED_TO_STAGE, addedToStageHandler);
		}

		/**
		 * The Feathers Button control that we'll be creating.
		 */
		protected var button:Button;

		/**
		 * Where the magic happens. Start after the main class has been added
		 * to the stage so that we can access the stage property.
		 */
		protected function addedToStageHandler(event:Event):void
		{
			this.removeEventListener(Event.ADDED_TO_STAGE, addedToStageHandler);

			//create the theme. this class will automatically pass skins to any
			//Feathers component that is added to the stage. components do not
			//have default skins, so you must always use a theme or skin the
			//components manually. you should always create a theme immediately
			//when your app starts up to ensure that all components are
			//properly skinned.
			//see http://feathersui.com/help/themes.html
			new MetalWorksMobileTheme();

			//create a button and give it some text to display.
			this.button = new Button();
			this.button.label = "Click Me";

			//an event that tells us when the user has tapped the button.
			this.button.addEventListener(Event.TRIGGERED, button_triggeredHandler);

			//add the button to the display list, just like you would with any
			//other Starling display object. this is where the theme give some
			//skins to the button.
			this.addChild(this.button);

			//the button won't have a width and height until it "validates". it
			//will validate on its own before the next frame is rendered by
			//Starling, but we want to access the dimension immediately, so tell
			//it to validate right now.
			this.button.validate();

			//center the button
			this.button.x = Math.round((this.stage.stageWidth - this.button.width) / 2);
			this.button.y = Math.round((this.stage.stageHeight - this.button.height) / 2);
		}

		/**
		 * Listener for the Button's Event.TRIGGERED event.
		 */
		protected function button_triggeredHandler(event:Event):void
		{
			TextCallout.show("Hi, I'm Feathers!\nHave a nice day.", this.button);
		}
	}
}


================================================
FILE: examples/LayoutExplorer/README.md
================================================
# Layout Explorer for Feathers

Demonstrations of each layout available in [Feathers](http://feathersui.com/) for the List and LayoutContainer components, presented as a mobile app. Includes screens for each layout, with configurable options.

## Requirements

In addition to Starling Framework and Feathers, this example project requires the `MetalWorksMobileTheme` example theme. You can find the SWC file for this theme at the following location in the Feathers release build:

	themes/MetalWorksMobileTheme/swc/MetalWorksMobileTheme.swc

## Web Demo

View the [Layout Explorer Example](http://feathersui.com/examples/layout-explorer/) in your browser.

================================================
FILE: examples/LayoutExplorer/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
theme.root = ${basedir}/../../themes/MetalWorksMobileTheme/source
output.path = ${basedir}/output
icon.path = ${basedir}/../shared-assets/icons
launch.image.path = ${basedir}/../shared-assets/launch-images-windowed

swf.version = 30

================================================
FILE: examples/LayoutExplorer/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="layout-explorer" default="build" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<target name="build" depends="build-web,build-android,build-ios"/>

	<target name="prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="build-web" depends="prepare">
		<echo message="Building LayoutExplorerWeb.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-frame=two,feathers.examples.layoutExplorer.Main"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/LayoutExplorerWeb.as"/>
			<arg value="-output=${output.path}/LayoutExplorerWeb.swf"/>
		</java>
	</target>

	<target name="build-air-swf" depends="prepare">
		<echo message="Building LayoutExplorer.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/LayoutExplorer.as"/>
			<arg value="-output=${output.path}/LayoutExplorer.swf"/>
		</java>
	</target>
	<target name="-check-ios-properties">
		<fail unless="ios.provision.path"/>
		<fail unless="ios.certificate.path"/>
		<fail unless="ios.certificate.password"/>
	</target>
	<target name="build-ios" depends="-check-ios-properties,build-air-swf">
		<echo message="Packaging LayoutExplorer.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="ipa-app-store"/>
			<arg value="-provisioning-profile"/>
			<arg value="${ios.provision.path}"/>
			<arg value="-keystore"/>
			<arg value="${ios.certificate.path}"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-storepass"/>
			<arg value="${ios.certificate.password}"/>
			<arg value="${output.path}/LayoutExplorer.ipa"/>
			<arg value="source/LayoutExplorer-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${launch.image.path}"/>
			<arg value="Default~iphone.png"/>							<!-- iphone 3gs -->
			<arg value="Default@2x~iphone.png"/>						<!-- iphone 4/4s -->
			<arg value="Default-568h@2x~iphone.png"/>					<!-- iphone 5/5c/5s -->
			<arg value="Default-375w-667h@2x~iphone.png"/>				<!-- iphone 6/7/8 -->
			<arg value="Default-812h@3x~iphone.png"/>					<!-- iphone x (portrait) -->
			<arg value="Default-Landscape-812h@3x~iphone.png"/>			<!-- iphone x (landscape) -->
			<arg value="Default-414w-736h@3x~iphone.png"/>				<!-- iphone 6/7/8 plus (portrait) -->
			<arg value="Default-Landscape-414w-736h@3x~iphone.png"/>	<!-- iphone 6/7/8 plus (landscape) -->
			<arg value="Default-Portrait~ipad.png"/>					<!-- ipad 1/2 (portrait) -->
			<arg value="Default-PortraitUpsideDown~ipad.png"/>			<!-- ipad 1/2 (portrait upside down) -->
			<arg value="Default-Landscape~ipad.png"/>					<!-- ipad 1/2 (landscape left) -->
			<arg value="Default-LandscapeRight~ipad.png"/>				<!-- ipad 1/2 (landscape right) -->
			<arg value="Default-Portrait@2x~ipad.png"/>					<!-- ipad 3/air (portrait) -->
			<arg value="Default-LandscapeLeft@2x~ipad.png"/>			<!-- ipad 3/air (landscape left) -->
			<arg value="Default-LandscapeRight@2x~ipad.png"/>			<!-- ipad 3/air (landscape right) -->
			<arg value="Default-Portrait@2x.png"/>						<!-- ipad pro (portrait) -->
			<arg value="Default-Landscape@2x.png"/>						<!-- ipad pro (landscape) -->
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="LayoutExplorer.swf"/>
		</java>
	</target>
	<target name="-check-android-properties">
		<fail unless="android.certificate.path"/>
		<fail unless="android.certificate.password"/>
	</target>
	<target name="build-android" depends="-check-android-properties,build-air-swf">
		<echo message="Packaging LayoutExplorer.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="apk-captive-runtime"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-keystore"/>
			<arg value="${android.certificate.path}"/>
			<arg value="-storepass"/>
			<arg value="${android.certificate.password}"/>
			<arg value="${output.path}/LayoutExplorer.apk"/>
			<arg value="source/LayoutExplorer-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="LayoutExplorer.swf"/>
		</java>
	</target>
	<target name="install-android">
		<echo message="Installing LayoutExplorer.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.LayoutExplorer"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-package"/>
			<arg value="${output.path}/LayoutExplorer.apk"/>
		</java>
	</target>
	<target name="install-ios">
		<echo message="Installing LayoutExplorer.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.LayoutExplorer"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-package"/>
			<arg value="${output.path}/LayoutExplorer.ipa"/>
		</java>
	</target>
</project>

================================================
FILE: examples/LayoutExplorer/source/LayoutExplorer-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.examples.LayoutExplorer</id>
	<filename>Layouts</filename>
	<name>Layouts</name>
	<versionNumber>4.2.0</versionNumber>
	<description>Layout Explorer example application built with Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>LayoutExplorer.swf</content>
		<autoOrients>true</autoOrients>
		<fullScreen>false</fullScreen>
		<visible>true</visible>
		<renderMode>direct</renderMode>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>

	<icon>
		<image29x29>icon29.png</image29x29>
		<image48x48>icon48.png</image48x48>
		<image50x50>icon50.png</image50x50>
		<image57x57>icon57.png</image57x57>
		<image58x58>icon58.png</image58x58>
		<image72x72>icon72.png</image72x72>
		<image87x87>icon87.png</image87x87>
		<image96x96>icon96.png</image96x96>
		<image100x100>icon100.png</image100x100>
		<image114x114>icon114.png</image114x114>
		<image128x128>icon128.png</image128x128>
		<image144x144>icon144.png</image144x144>
		<image180x180>icon180.png</image180x180>
	</icon>
	<android>
		<colorDepth>16bit</colorDepth>
		<manifestAdditions><![CDATA[
			<manifest android:installLocation="auto">
			    <uses-permission android:name="android.permission.INTERNET"/>
			</manifest>
		]]></manifestAdditions>
	</android>
	<iPhone>
		<InfoAdditions>
		<![CDATA[
			<key>UIDeviceFamily</key> 
			<array> 
				<string>1</string>
				<string>2</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<true/>
			<key>UIStatusBarStyle</key>
			<string>UIStatusBarStyleLightContent</string>
		]]> 
		</InfoAdditions>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</iPhone>
</application>

================================================
FILE: examples/LayoutExplorer/source/LayoutExplorer.as
================================================
package
{
	import feathers.examples.layoutExplorer.Main;
	import feathers.utils.ScreenDensityScaleFactorManager;

	import flash.display.Loader;
	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageOrientation;
	import flash.display.StageScaleMode;
	import flash.display3D.Context3DProfile;
	import flash.display3D.Context3DRenderMode;
	import flash.events.Event;
	import flash.filesystem.File;
	import flash.filesystem.FileMode;
	import flash.filesystem.FileStream;
	import flash.system.Capabilities;
	import flash.utils.ByteArray;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class LayoutExplorer extends Sprite
	{
		public function LayoutExplorer()
		{
			if(this.stage)
			{
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
				this.stage.align = StageAlign.TOP_LEFT;
			}
			this.mouseEnabled = this.mouseChildren = false;
			this.showLaunchImage();
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;
		private var _scaler:ScreenDensityScaleFactorManager;
		private var _launchImage:Loader;
		private var _savedAutoOrients:Boolean;

		/**
		 * On iOS, add the native launch image to the classic display list to
		 * avoid displaying only the stage background color between when the
		 * AIR app finishes launching and Starling starts rendering.
		 * 
		 * Launch image names: https://forums.adobe.com/message/9986239#9986239
		 */
		private function showLaunchImage():void
		{
			var filePath:String = null;
			var isPortraitOnly:Boolean = false;
			if(Capabilities.manufacturer.indexOf("iOS") >= 0)
			{
				var isPortraitUpsideDown:Boolean = this.stage.orientation == StageOrientation.UPSIDE_DOWN;
				var isPortrait:Boolean = this.stage.orientation == StageOrientation.DEFAULT || isPortraitUpsideDown;
				var isLandscapeRight:Boolean = this.stage.orientation == StageOrientation.ROTATED_RIGHT;
				if(Capabilities.screenResolutionX == 1242 && Capabilities.screenResolutionY == 2208)
				{
					//iphone 6/7/8 plus
					filePath = isPortrait ? "Default-414w-736h@3x~iphone.png" : "Default-Landscape-414w-736h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 1125 && Capabilities.screenResolutionY == 2436)
				{
					//iphone x
					filePath = isPortrait ? "Default-812h@3x~iphone.png" : "Default-Landscape-812h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 2048 && Capabilities.screenResolutionY == 2732)
				{
					//ipad pro
					filePath = isPortrait ? "Default-Portrait@2x.png" : "Default-Landscape@2x.png";
				}
				else if(Capabilities.screenResolutionX == 1536 && Capabilities.screenResolutionY == 2048)
				{
					//ipad 3/air
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait@2x~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown@2x~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight@2x~ipad.png";
					}
					else
					{
						filePath = "Default-LandscapeLeft@2x~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 768 && Capabilities.screenResolutionY == 1024)
				{
					//ipad 1/2
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight~ipad.png";
					}
					else
					{
						filePath = "Default-Landscape~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 750)
				{
					//iphone 6/7/8
					isPortraitOnly = true;
					filePath = "Default-375w-667h@2x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 640)
				{
					isPortraitOnly = true;
					if(Capabilities.screenResolutionY == 1136)
					{
						//iphone 5/5c/5s
						filePath = "Default-568h@2x~iphone.png";
					}
					else
					{
						//iphone 4/4s
						filePath = "Default@2x~iphone.png";
					}
				}
				else if(Capabilities.screenResolutionX == 320)
				{
					//iphone 3gs
					isPortraitOnly = true;
					filePath = "Default~iphone.png";
				}
			}

			if(filePath)
			{
				var file:File = File.applicationDirectory.resolvePath(filePath);
				if(file.exists)
				{
					var bytes:ByteArray = new ByteArray();
					var stream:FileStream = new FileStream();
					stream.open(file, FileMode.READ);
					stream.readBytes(bytes, 0, stream.bytesAvailable);
					stream.close();
					this._launchImage = new Loader();
					this._launchImage.loadBytes(bytes);
					this.addChild(this._launchImage);
					this._savedAutoOrients = this.stage.autoOrients;
					this.stage.autoOrients = false;
					if(isPortraitOnly)
					{
						this.stage.setOrientation(StageOrientation.DEFAULT);
					}
				}
			}
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(Main, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE);
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.start();
			if(this._launchImage)
			{
				this._starling.addEventListener("rootCreated", starling_rootCreatedHandler);
			}
			this._scaler = new ScreenDensityScaleFactorManager(this._starling);

			this.stage.addEventListener(Event.DEACTIVATE, stage_deactivateHandler, false, 0, true);
		}

		private function starling_rootCreatedHandler(event:Object):void
		{
			if(this._launchImage)
			{
				this.removeChild(this._launchImage);
				this._launchImage.unloadAndStop(true);
				this._launchImage = null;
				this.stage.autoOrients = this._savedAutoOrients;
			}
		}

		private function stage_deactivateHandler(event:Event):void
		{
			this._starling.stop(true);
			this.stage.addEventListener(Event.ACTIVATE, stage_activateHandler, false, 0, true);
		}

		private function stage_activateHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.ACTIVATE, stage_activateHandler);
			this._starling.start();
		}

	}
}

================================================
FILE: examples/LayoutExplorer/source/LayoutExplorerWeb.as
================================================
package
{
	import feathers.system.DeviceCapabilities;

	import flash.display.MovieClip;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.events.Event;
	import flash.geom.Rectangle;
	import flash.ui.ContextMenu;
	import flash.utils.getDefinitionByName;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class LayoutExplorerWeb extends MovieClip
	{
		public function LayoutExplorerWeb()
		{
			var menu:ContextMenu = new ContextMenu();
			menu.hideBuiltInItems();
			this.contextMenu = menu;
			
			if(this.stage)
			{
				this.stage.align = StageAlign.TOP_LEFT;
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
			}
			
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}
		
		private var _starling:Starling;
		
		private function start():void
		{
			this.gotoAndStop(2);
			this.graphics.clear();

			//simulating iPhone Retina
			DeviceCapabilities.dpi = 326;
			
			Starling.multitouchEnabled = true;
			var MainType:Class = getDefinitionByName("feathers.examples.layoutExplorer.Main") as Class;
			this._starling = new Starling(MainType, this.stage, new Rectangle(0, 0, 960, 640));
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.stage.stageWidth = 480;
			this._starling.stage.stageHeight = 320;
			this._starling.start();
		}
		
		private function loaderInfo_completeHandler(event:Event):void
		{
			this.start();
		}
	}
}

================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/Main.as
================================================
package feathers.examples.layoutExplorer
{
	import feathers.controls.Drawers;
	import feathers.controls.StackScreenNavigator;
	import feathers.controls.StackScreenNavigatorItem;
	import feathers.examples.layoutExplorer.data.FlowLayoutSettings;
	import feathers.examples.layoutExplorer.data.HorizontalLayoutSettings;
	import feathers.examples.layoutExplorer.data.SlideShowLayoutSettings;
	import feathers.examples.layoutExplorer.data.TiledColumnsLayoutSettings;
	import feathers.examples.layoutExplorer.data.TiledRowsLayoutSettings;
	import feathers.examples.layoutExplorer.data.VerticalLayoutSettings;
	import feathers.examples.layoutExplorer.data.WaterfallLayoutSettings;
	import feathers.examples.layoutExplorer.screens.AnchorLayoutScreen;
	import feathers.examples.layoutExplorer.screens.FlowLayoutScreen;
	import feathers.examples.layoutExplorer.screens.FlowLayoutSettingsScreen;
	import feathers.examples.layoutExplorer.screens.HorizontalLayoutScreen;
	import feathers.examples.layoutExplorer.screens.HorizontalLayoutSettingsScreen;
	import feathers.examples.layoutExplorer.screens.MainMenuScreen;
	import feathers.examples.layoutExplorer.screens.SlideShowLayoutScreen;
	import feathers.examples.layoutExplorer.screens.SlideShowLayoutSettingsScreen;
	import feathers.examples.layoutExplorer.screens.TiledColumnsLayoutScreen;
	import feathers.examples.layoutExplorer.screens.TiledColumnsLayoutSettingsScreen;
	import feathers.examples.layoutExplorer.screens.TiledRowsLayoutScreen;
	import feathers.examples.layoutExplorer.screens.TiledRowsLayoutSettingsScreen;
	import feathers.examples.layoutExplorer.screens.VerticalLayoutScreen;
	import feathers.examples.layoutExplorer.screens.VerticalLayoutSettingsScreen;
	import feathers.examples.layoutExplorer.screens.WaterfallLayoutScreen;
	import feathers.examples.layoutExplorer.screens.WaterfallLayoutSettingsScreen;
	import feathers.layout.Orientation;
	import feathers.motion.Cover;
	import feathers.motion.Reveal;
	import feathers.motion.Slide;
	import feathers.system.DeviceCapabilities;
	import feathers.themes.MetalWorksMobileTheme;

	import starling.core.Starling;
	import starling.events.Event;

	public class Main extends Drawers
	{
		private static const MAIN_MENU:String = "mainMenu";
		private static const ANCHOR:String = "anchor";
		private static const FLOW:String = "flow";
		private static const HORIZONTAL:String = "horizontal";
		private static const VERTICAL:String = "vertical";
		private static const TILED_ROWS:String = "tiledRows";
		private static const TILED_COLUMNS:String = "tiledColumns";
		private static const WATERFALL:String = "waterfall";
		private static const SLIDE_SHOW:String = "slideShow";
		private static const FLOW_SETTINGS:String = "flowSettings";
		private static const HORIZONTAL_SETTINGS:String = "horizontalSettings";
		private static const VERTICAL_SETTINGS:String = "verticalSettings";
		private static const TILED_ROWS_SETTINGS:String = "tiledRowsSettings";
		private static const TILED_COLUMNS_SETTINGS:String = "tiledColumnsSettings";
		private static const WATERFALL_SETTINGS:String = "waterfallSettings";
		private static const SLIDE_SHOW_SETTINGS:String = "slideShowSettings";

		private static const MAIN_MENU_EVENTS:Object =
		{
			showAnchor: ANCHOR,
			showFlow: FLOW,
			showHorizontal: HORIZONTAL,
			showVertical: VERTICAL,
			showTiledRows: TILED_ROWS,
			showTiledColumns: TILED_COLUMNS,
			showWaterfall: WATERFALL,
			showSlideShow: SLIDE_SHOW
		};

		public function Main()
		{
			//set up the theme right away!
			new MetalWorksMobileTheme();
			super();
		}

		private var _navigator:StackScreenNavigator;
		private var _menu:MainMenuScreen;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this._navigator = new StackScreenNavigator();
			//we're using Drawers because we want to display the menu on the
			//side when running on tablets.
			this.content = this._navigator;

			var anchorItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(AnchorLayoutScreen);
			anchorItem.addPopEvent(Event.COMPLETE);
			this._navigator.addScreen(ANCHOR, anchorItem);

			var flowLayoutSettings:FlowLayoutSettings = new FlowLayoutSettings();
			var flowItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(FlowLayoutScreen);
			flowItem.setScreenIDForPushEvent(FlowLayoutScreen.SHOW_SETTINGS, FLOW_SETTINGS);
			flowItem.addPopEvent(Event.COMPLETE);
			flowItem.properties.settings = flowLayoutSettings;
			this._navigator.addScreen(FLOW, flowItem);

			var flowSettingsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(FlowLayoutSettingsScreen);
			flowSettingsItem.addPopEvent(Event.COMPLETE);
			flowSettingsItem.properties.settings = flowLayoutSettings;
			flowSettingsItem.pushTransition = Cover.createCoverUpTransition();
			flowSettingsItem.popTransition = Reveal.createRevealDownTransition();
			this._navigator.addScreen(FLOW_SETTINGS, flowSettingsItem);

			var horizontalLayoutSettings:HorizontalLayoutSettings = new HorizontalLayoutSettings();
			var horizontalItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(HorizontalLayoutScreen);
			horizontalItem.setScreenIDForPushEvent(HorizontalLayoutScreen.SHOW_SETTINGS, HORIZONTAL_SETTINGS);
			horizontalItem.addPopEvent(Event.COMPLETE);
			horizontalItem.properties.settings = horizontalLayoutSettings;
			this._navigator.addScreen(HORIZONTAL, horizontalItem);

			var horizontalSettingsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(HorizontalLayoutSettingsScreen);
			horizontalSettingsItem.addPopEvent(Event.COMPLETE);
			horizontalSettingsItem.properties.settings = horizontalLayoutSettings;
			horizontalSettingsItem.pushTransition = Cover.createCoverUpTransition();
			horizontalSettingsItem.popTransition = Reveal.createRevealDownTransition();
			this._navigator.addScreen(HORIZONTAL_SETTINGS, horizontalSettingsItem);

			var verticalLayoutSettings:VerticalLayoutSettings = new VerticalLayoutSettings();
			var verticalItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(VerticalLayoutScreen);
			verticalItem.setScreenIDForPushEvent(VerticalLayoutScreen.SHOW_SETTINGS, VERTICAL_SETTINGS);
			verticalItem.addPopEvent(Event.COMPLETE);
			verticalItem.properties.settings = verticalLayoutSettings;
			this._navigator.addScreen(VERTICAL, verticalItem);

			var verticalSettingsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(VerticalLayoutSettingsScreen);
			verticalSettingsItem.addPopEvent(Event.COMPLETE);
			verticalSettingsItem.properties.settings = verticalLayoutSettings;
			verticalSettingsItem.pushTransition = Cover.createCoverUpTransition();
			verticalSettingsItem.popTransition = Reveal.createRevealDownTransition();
			this._navigator.addScreen(VERTICAL_SETTINGS, verticalSettingsItem);

			var tiledRowsLayoutSettings:TiledRowsLayoutSettings = new TiledRowsLayoutSettings();
			var tiledRowsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(TiledRowsLayoutScreen);
			tiledRowsItem.setScreenIDForPushEvent(TiledRowsLayoutScreen.SHOW_SETTINGS, TILED_ROWS_SETTINGS);
			tiledRowsItem.addPopEvent(Event.COMPLETE);
			tiledRowsItem.properties.settings = tiledRowsLayoutSettings;
			this._navigator.addScreen(TILED_ROWS, tiledRowsItem);

			var tiledRowsSettingsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(TiledRowsLayoutSettingsScreen);
			tiledRowsSettingsItem.addPopEvent(Event.COMPLETE);
			tiledRowsSettingsItem.properties.settings = tiledRowsLayoutSettings;
			tiledRowsSettingsItem.pushTransition = Cover.createCoverUpTransition();
			tiledRowsSettingsItem.popTransition = Reveal.createRevealDownTransition();
			this._navigator.addScreen(TILED_ROWS_SETTINGS, tiledRowsSettingsItem);

			var tiledColumnsLayoutSettings:TiledColumnsLayoutSettings = new TiledColumnsLayoutSettings();
			var tiledColumnsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(TiledColumnsLayoutScreen);
			tiledColumnsItem.setScreenIDForPushEvent(TiledColumnsLayoutScreen.SHOW_SETTINGS, TILED_COLUMNS_SETTINGS);
			tiledColumnsItem.addPopEvent(Event.COMPLETE);
			tiledColumnsItem.properties.settings = tiledColumnsLayoutSettings;
			this._navigator.addScreen(TILED_COLUMNS, tiledColumnsItem);

			var tiledColumnsSettingsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(TiledColumnsLayoutSettingsScreen);
			tiledColumnsSettingsItem.addPopEvent(Event.COMPLETE);
			tiledColumnsSettingsItem.properties.settings = tiledColumnsLayoutSettings;
			tiledColumnsSettingsItem.pushTransition = Cover.createCoverUpTransition();
			tiledColumnsSettingsItem.popTransition = Reveal.createRevealDownTransition();
			this._navigator.addScreen(TILED_COLUMNS_SETTINGS, tiledColumnsSettingsItem);

			var waterfallLayoutSettings:WaterfallLayoutSettings = new WaterfallLayoutSettings();
			var waterfallItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(WaterfallLayoutScreen);
			waterfallItem.setScreenIDForPushEvent(TiledColumnsLayoutScreen.SHOW_SETTINGS, WATERFALL_SETTINGS);
			waterfallItem.addPopEvent(Event.COMPLETE);
			waterfallItem.properties.settings = waterfallLayoutSettings;
			this._navigator.addScreen(WATERFALL, waterfallItem);

			var waterfallSettingsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(WaterfallLayoutSettingsScreen);
			waterfallSettingsItem.addPopEvent(Event.COMPLETE);
			waterfallSettingsItem.properties.settings = waterfallLayoutSettings;
			waterfallSettingsItem.pushTransition = Cover.createCoverUpTransition();
			waterfallSettingsItem.popTransition = Reveal.createRevealDownTransition();
			this._navigator.addScreen(WATERFALL_SETTINGS, waterfallSettingsItem);

			var slideShowSettings:SlideShowLayoutSettings = new SlideShowLayoutSettings();
			var slideShowItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(SlideShowLayoutScreen);
			slideShowItem.setScreenIDForPushEvent(SlideShowLayoutScreen.SHOW_SETTINGS, SLIDE_SHOW_SETTINGS);
			slideShowItem.addPopEvent(Event.COMPLETE);
			slideShowItem.properties.settings = slideShowSettings;
			this._navigator.addScreen(SLIDE_SHOW, slideShowItem);

			var slideShowSettingsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(SlideShowLayoutSettingsScreen);
			slideShowSettingsItem.addPopEvent(Event.COMPLETE);
			slideShowSettingsItem.properties.settings = slideShowSettings;
			slideShowSettingsItem.pushTransition = Cover.createCoverUpTransition();
			slideShowSettingsItem.popTransition = Reveal.createRevealDownTransition();
			this._navigator.addScreen(SLIDE_SHOW_SETTINGS, slideShowSettingsItem);

			if(DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				//we don't want the screens bleeding outside the navigator's
				//bounds on top of a drawer when a transition is active, so
				//enable clipping.
				this._navigator.clipContent = true;
				this._menu = new MainMenuScreen();
				for(var eventType:String in MAIN_MENU_EVENTS)
				{
					this._menu.addEventListener(eventType, mainMenuEventHandler);
				}
				this.leftDrawer = this._menu;
				this.leftDrawerDockMode = Orientation.BOTH;
			}
			else
			{
				var mainMenuItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(MainMenuScreen);
				for(eventType in MAIN_MENU_EVENTS)
				{
					mainMenuItem.setScreenIDForPushEvent(eventType, MAIN_MENU_EVENTS[eventType] as String);
				}
				this._navigator.addScreen(MAIN_MENU, mainMenuItem);
				this._navigator.rootScreenID = MAIN_MENU;
			}

			this._navigator.pushTransition = Slide.createSlideLeftTransition();
			this._navigator.popTransition = Slide.createSlideRightTransition();
		}

		private function mainMenuEventHandler(event:Event):void
		{
			var screenName:String = MAIN_MENU_EVENTS[event.type] as String;
			//since this navigation is triggered by an external menu, we don't
			//want to push a new screen onto the stack. we want to start fresh.
			this._navigator.rootScreenID = screenName;
		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/data/FlowLayoutSettings.as
================================================
package feathers.examples.layoutExplorer.data
{
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;

	public class FlowLayoutSettings
	{
		public function FlowLayoutSettings()
		{
		}

		public var itemCount:int = 75;
		public var horizontalAlign:String = HorizontalAlign.LEFT;
		public var verticalAlign:String = VerticalAlign.TOP;
		public var rowVerticalAlign:String = VerticalAlign.TOP;
		public var horizontalGap:Number = 2;
		public var verticalGap:Number = 2;
		public var paddingTop:Number = 0;
		public var paddingRight:Number = 0;
		public var paddingBottom:Number = 0;
		public var paddingLeft:Number = 0;
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/data/HorizontalLayoutSettings.as
================================================
package feathers.examples.layoutExplorer.data
{
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;

	public class HorizontalLayoutSettings
	{
		public function HorizontalLayoutSettings()
		{
		}

		public var itemCount:int = 75;
		public var horizontalAlign:String = HorizontalAlign.LEFT;
		public var verticalAlign:String = VerticalAlign.TOP;
		public var gap:Number = 2;
		public var paddingTop:Number = 0;
		public var paddingRight:Number = 0;
		public var paddingBottom:Number = 0;
		public var paddingLeft:Number = 0;
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/data/SlideShowLayoutSettings.as
================================================
package feathers.examples.layoutExplorer.data
{
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;

	public class SlideShowLayoutSettings
	{
		public function SlideShowLayoutSettings()
		{
		}

		public var itemCount:int = 5;
		public var horizontalAlign:String = HorizontalAlign.CENTER;
		public var verticalAlign:String = VerticalAlign.MIDDLE;
		public var paddingTop:Number = 0;
		public var paddingRight:Number = 0;
		public var paddingBottom:Number = 0;
		public var paddingLeft:Number = 0;
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/data/TiledColumnsLayoutSettings.as
================================================
package feathers.examples.layoutExplorer.data
{
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.TiledColumnsLayout;
	import feathers.layout.VerticalAlign;

	public class TiledColumnsLayoutSettings
	{
		public function TiledColumnsLayoutSettings()
		{
		}

		public var itemCount:int = 75;
		public var requestedRowCount:int = 0;
		public var paging:String = Direction.NONE;
		public var horizontalAlign:String = HorizontalAlign.LEFT;
		public var verticalAlign:String = VerticalAlign.TOP;
		public var tileHorizontalAlign:String = HorizontalAlign.LEFT;
		public var tileVerticalAlign:String = VerticalAlign.TOP;
		public var horizontalGap:Number = 2;
		public var verticalGap:Number = 2;
		public var paddingTop:Number = 0;
		public var paddingRight:Number = 0;
		public var paddingBottom:Number = 0;
		public var paddingLeft:Number = 0;
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/data/TiledRowsLayoutSettings.as
================================================
package feathers.examples.layoutExplorer.data
{
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.TiledRowsLayout;
	import feathers.layout.VerticalAlign;

	public class TiledRowsLayoutSettings
	{
		public function TiledRowsLayoutSettings()
		{
		}

		public var paging:String = Direction.NONE;
		public var itemCount:int = 75;
		public var requestedColumnCount:int = 0;
		public var horizontalAlign:String = HorizontalAlign.LEFT;
		public var verticalAlign:String = VerticalAlign.TOP;
		public var tileHorizontalAlign:String = HorizontalAlign.LEFT;
		public var tileVerticalAlign:String = VerticalAlign.TOP;
		public var horizontalGap:Number = 2;
		public var verticalGap:Number = 2;
		public var paddingTop:Number = 0;
		public var paddingRight:Number = 0;
		public var paddingBottom:Number = 0;
		public var paddingLeft:Number = 0;
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/data/VerticalLayoutSettings.as
================================================
package feathers.examples.layoutExplorer.data
{
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;

	public class VerticalLayoutSettings
	{
		public function VerticalLayoutSettings()
		{
		}

		public var itemCount:int = 75;
		public var horizontalAlign:String = HorizontalAlign.LEFT;
		public var verticalAlign:String = VerticalAlign.TOP;
		public var gap:Number = 2;
		public var paddingTop:Number = 0;
		public var paddingRight:Number = 0;
		public var paddingBottom:Number = 0;
		public var paddingLeft:Number = 0;
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/data/WaterfallLayoutSettings.as
================================================
package feathers.examples.layoutExplorer.data
{
	import feathers.layout.HorizontalAlign;

	public class WaterfallLayoutSettings
	{
		public function WaterfallLayoutSettings()
		{
		}

		public var itemCount:int = 75;
		public var requestedColumnCount:int = 0;
		public var horizontalAlign:String = HorizontalAlign.CENTER;
		public var horizontalGap:Number = 2;
		public var verticalGap:Number = 2;
		public var paddingTop:Number = 0;
		public var paddingRight:Number = 0;
		public var paddingBottom:Number = 0;
		public var paddingLeft:Number = 0;
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/AnchorLayoutScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.Label;
	import feathers.controls.PanelScreen;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class AnchorLayoutScreen extends PanelScreen
	{
		public function AnchorLayoutScreen()
		{
			super();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Anchor Layout";

			this.layout = new AnchorLayout();

			var centeredLayoutData:AnchorLayoutData = new AnchorLayoutData();
			centeredLayoutData.horizontalCenter = 0;
			centeredLayoutData.verticalCenter = 0;
			var label1:Label = new Label();
			label1.text = "(Rotate device to see the layout update!)";
			label1.layoutData = centeredLayoutData;
			this.addChild(label1);

			var topRightLayoutData:AnchorLayoutData = new AnchorLayoutData();
			topRightLayoutData.top = 20;
			topRightLayoutData.right = 20;
			var button1:Button = new Button();
			button1.label = "This button is positioned\nat the top right corner.";
			button1.layoutData = topRightLayoutData;
			this.addChild(button1);

			var fillBottomLayoutData:AnchorLayoutData = new AnchorLayoutData();
			fillBottomLayoutData.left = 20;
			fillBottomLayoutData.right = 20;
			fillBottomLayoutData.bottom = 20;
			var button2:Button = new Button();
			button2.label = "This button stretches across the bottom.";
			button2.layoutData = fillBottomLayoutData;
			this.addChild(button2);

			var relativeLayoutData:AnchorLayoutData = new AnchorLayoutData();
			relativeLayoutData.bottom = 20;
			relativeLayoutData.bottomAnchorDisplayObject = button2;
			relativeLayoutData.horizontalCenter = 0;
			var label2:Label = new Label();
			label2.text = "The label is positioned relative to the button.";
			label2.layoutData = relativeLayoutData;
			this.addChild(label2);

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/FlowLayoutScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.events.FeathersEventType;
	import feathers.examples.layoutExplorer.data.FlowLayoutSettings;
	import feathers.layout.FlowLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	[Event(name="showSettings",type="starling.events.Event")]

	public class FlowLayoutScreen extends PanelScreen
	{
		public static const SHOW_SETTINGS:String = "showSettings";

		public function FlowLayoutScreen()
		{
			super();
		}

		public var settings:FlowLayoutSettings;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Flow Layout";

			var layout:FlowLayout = new FlowLayout();
			layout.horizontalGap = this.settings.horizontalGap;
			layout.verticalGap = this.settings.verticalGap;
			layout.paddingTop = this.settings.paddingTop;
			layout.paddingRight = this.settings.paddingRight;
			layout.paddingBottom = this.settings.paddingBottom;
			layout.paddingLeft = this.settings.paddingLeft;
			layout.horizontalAlign = this.settings.horizontalAlign;
			layout.verticalAlign = this.settings.verticalAlign;
			layout.rowVerticalAlign = this.settings.rowVerticalAlign;

			this.layout = layout;
			this.snapScrollPositionsToPixels = true;

			var minQuadSize:Number = Math.min(Starling.current.stage.stageWidth, Starling.current.stage.stageHeight) / 15;
			for(var i:int = 0; i < this.settings.itemCount; i++)
			{
				var size:Number = (minQuadSize + minQuadSize * 2 * Math.random());
				var quad:Quad = new Quad(size, size, 0xff8800);
				this.addChild(quad);
			}

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}

			this.headerFactory = this.customHeaderFactory;

			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			var settingsButton:Button = new Button();
			settingsButton.label = "Settings";
			settingsButton.addEventListener(Event.TRIGGERED, settingsButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				settingsButton
			];
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function transitionInCompleteHandler(event:Event):void
		{
			this.revealScrollBars();
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function settingsButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(SHOW_SETTINGS);
		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/FlowLayoutSettingsScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.NumericStepper;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.data.ArrayCollection;
	import feathers.data.ListCollection;
	import feathers.data.VectorCollection;
	import feathers.examples.layoutExplorer.data.FlowLayoutSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;

	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class FlowLayoutSettingsScreen extends PanelScreen
	{
		public function FlowLayoutSettingsScreen()
		{
			super();
		}

		public var settings:FlowLayoutSettings;

		private var _list:List;

		private var _itemCountStepper:NumericStepper;
		private var _horizontalGapStepper:NumericStepper;
		private var _verticalGapStepper:NumericStepper;
		private var _paddingTopStepper:NumericStepper;
		private var _paddingRightStepper:NumericStepper;
		private var _paddingBottomStepper:NumericStepper;
		private var _paddingLeftStepper:NumericStepper;
		private var _horizontalAlignPicker:PickerList;
		private var _verticalAlignPicker:PickerList;
		private var _rowVerticalAlignPicker:PickerList;

		override public function dispose():void
		{
			//icon and accessory display objects in the list's data provider
			//won't be automatically disposed because feathers cannot know if
			//they need to be used again elsewhere or not. we need to dispose
			//them manually.
			this._list.dataProvider.dispose(disposeItemAccessory);

			//never forget to call super.dispose() because you don't want to
			//create a memory leak!
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Flow Layout Settings";

			this.layout = new AnchorLayout();

			this._itemCountStepper = new NumericStepper();
			this._itemCountStepper.minimum = 1;
			//the layout can certainly handle more. this value is arbitrary.
			this._itemCountStepper.maximum = 100;
			this._itemCountStepper.step = 1;
			this._itemCountStepper.value = this.settings.itemCount;
			this._itemCountStepper.addEventListener(Event.CHANGE, itemCountStepper_changeHandler);

			this._horizontalAlignPicker = new PickerList();
			this._horizontalAlignPicker.typicalItem = HorizontalAlign.CENTER;
			this._horizontalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				HorizontalAlign.LEFT,
				HorizontalAlign.CENTER,
				HorizontalAlign.RIGHT
			]);
			this._horizontalAlignPicker.selectedItem = this.settings.horizontalAlign;
			this._horizontalAlignPicker.addEventListener(Event.CHANGE, horizontalAlignPicker_changeHandler);

			this._verticalAlignPicker = new PickerList();
			this._verticalAlignPicker.typicalItem = VerticalAlign.BOTTOM;
			this._verticalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				VerticalAlign.TOP,
				VerticalAlign.MIDDLE,
				VerticalAlign.BOTTOM,
			]);
			this._verticalAlignPicker.selectedItem = this.settings.verticalAlign;
			this._verticalAlignPicker.addEventListener(Event.CHANGE, verticalAlignPicker_changeHandler);

			this._rowVerticalAlignPicker = new PickerList();
			this._rowVerticalAlignPicker.typicalItem = VerticalAlign.BOTTOM;
			this._rowVerticalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				VerticalAlign.TOP,
				VerticalAlign.MIDDLE,
				VerticalAlign.BOTTOM,
			]);
			this._rowVerticalAlignPicker.selectedItem = this.settings.rowVerticalAlign;
			this._rowVerticalAlignPicker.addEventListener(Event.CHANGE, rowVerticalAlignPicker_changeHandler);

			this._horizontalGapStepper = new NumericStepper();
			this._horizontalGapStepper.minimum = 0;
			//these maximum values are completely arbitrary
			this._horizontalGapStepper.maximum = 100;
			this._horizontalGapStepper.step = 1;
			this._horizontalGapStepper.value = this.settings.horizontalGap;
			this._horizontalGapStepper.addEventListener(Event.CHANGE, horizontalGapStepper_changeHandler);

			this._verticalGapStepper = new NumericStepper();
			this._verticalGapStepper.minimum = 0;
			this._verticalGapStepper.maximum = 100;
			this._verticalGapStepper.step = 1;
			this._verticalGapStepper.value = this.settings.verticalGap;
			this._verticalGapStepper.addEventListener(Event.CHANGE, verticalGapStepper_changeHandler);

			this._paddingTopStepper = new NumericStepper();
			this._paddingTopStepper.minimum = 0;
			this._paddingTopStepper.maximum = 100;
			this._paddingTopStepper.step = 1;
			this._paddingTopStepper.value = this.settings.paddingTop;
			this._paddingTopStepper.addEventListener(Event.CHANGE, paddingTopStepper_changeHandler);

			this._paddingRightStepper = new NumericStepper();
			this._paddingRightStepper.minimum = 0;
			this._paddingRightStepper.maximum = 100;
			this._paddingRightStepper.step = 1;
			this._paddingRightStepper.value = this.settings.paddingRight;
			this._paddingRightStepper.addEventListener(Event.CHANGE, paddingRightStepper_changeHandler);

			this._paddingBottomStepper = new NumericStepper();
			this._paddingBottomStepper.minimum = 0;
			this._paddingBottomStepper.maximum = 100;
			this._paddingBottomStepper.step = 1;
			this._paddingBottomStepper.value = this.settings.paddingBottom;
			this._paddingBottomStepper.addEventListener(Event.CHANGE, paddingBottomStepper_changeHandler);

			this._paddingLeftStepper = new NumericStepper();
			this._paddingLeftStepper.minimum = 0;
			this._paddingLeftStepper.maximum = 100;
			this._paddingLeftStepper.step = 1;
			this._paddingLeftStepper.value = this.settings.paddingLeft;
			this._paddingLeftStepper.addEventListener(Event.CHANGE, paddingLeftStepper_changeHandler);

			this._list = new List();
			this._list.isSelectable = false;
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Item Count", accessory: this._itemCountStepper },
				{ label: "horizontalAlign", accessory: this._horizontalAlignPicker },
				{ label: "verticalAlign", accessory: this._verticalAlignPicker },
				{ label: "rowVerticalAlign", accessory: this._rowVerticalAlignPicker },
				{ label: "horizontalGap", accessory: this._horizontalGapStepper },
				{ label: "verticalGap", accessory: this._verticalGapStepper },
				{ label: "paddingTop", accessory: this._paddingTopStepper },
				{ label: "paddingRight", accessory: this._paddingRightStepper },
				{ label: "paddingBottom", accessory: this._paddingBottomStepper },
				{ label: "paddingLeft", accessory: this._paddingLeftStepper },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = this.onBackButton;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			var doneButton:Button = new Button();
			doneButton.label = "Done";
			doneButton.addEventListener(Event.TRIGGERED, doneButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				doneButton
			];
			return header;
		}

		private function disposeItemAccessory(item:Object):void
		{
			DisplayObject(item.accessory).dispose();
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function doneButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function itemCountStepper_changeHandler(event:Event):void
		{
			this.settings.itemCount = this._itemCountStepper.value;
		}

		private function horizontalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.horizontalAlign = this._horizontalAlignPicker.selectedItem as String;
		}

		private function verticalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.verticalAlign = this._verticalAlignPicker.selectedItem as String;
		}

		private function rowVerticalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.rowVerticalAlign = this._rowVerticalAlignPicker.selectedItem as String;
		}

		private function horizontalGapStepper_changeHandler(event:Event):void
		{
			this.settings.horizontalGap = this._horizontalGapStepper.value;
		}

		private function verticalGapStepper_changeHandler(event:Event):void
		{
			this.settings.verticalGap = this._verticalGapStepper.value;
		}

		private function paddingTopStepper_changeHandler(event:Event):void
		{
			this.settings.paddingTop = this._paddingTopStepper.value;
		}

		private function paddingRightStepper_changeHandler(event:Event):void
		{
			this.settings.paddingRight = this._paddingRightStepper.value;
		}

		private function paddingBottomStepper_changeHandler(event:Event):void
		{
			this.settings.paddingBottom = this._paddingBottomStepper.value;
		}

		private function paddingLeftStepper_changeHandler(event:Event):void
		{
			this.settings.paddingLeft = this._paddingLeftStepper.value;
		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/HorizontalLayoutScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.controls.ScrollPolicy;
	import feathers.events.FeathersEventType;
	import feathers.examples.layoutExplorer.data.HorizontalLayoutSettings;
	import feathers.layout.HorizontalLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	[Event(name="showSettings",type="starling.events.Event")]

	public class HorizontalLayoutScreen extends PanelScreen
	{
		public static const SHOW_SETTINGS:String = "showSettings";

		public function HorizontalLayoutScreen()
		{
			super();
		}

		public var settings:HorizontalLayoutSettings;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Horizontal Layout";

			var layout:HorizontalLayout = new HorizontalLayout();
			layout.gap = this.settings.gap;
			layout.paddingTop = this.settings.paddingTop;
			layout.paddingRight = this.settings.paddingRight;
			layout.paddingBottom = this.settings.paddingBottom;
			layout.paddingLeft = this.settings.paddingLeft;
			layout.horizontalAlign = this.settings.horizontalAlign;
			layout.verticalAlign = this.settings.verticalAlign;

			this.layout = layout;
			//when the scroll policy is set to on, the "elastic" edges will be
			//active even when the max scroll position is zero
			this.horizontalScrollPolicy = ScrollPolicy.ON;
			this.snapScrollPositionsToPixels = true;

			var minQuadSize:Number = Math.min(Starling.current.stage.stageWidth, Starling.current.stage.stageHeight) / 15;
			for(var i:int = 0; i < this.settings.itemCount; i++)
			{
				var size:Number = (minQuadSize + minQuadSize * 2 * Math.random());
				var quad:Quad = new Quad(size, size, 0xff8800);
				this.addChild(quad);
			}

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}

			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			var settingsButton:Button = new Button();
			settingsButton.label = "Settings";
			settingsButton.addEventListener(Event.TRIGGERED, settingsButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				settingsButton
			];
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function transitionInCompleteHandler(event:Event):void
		{
			this.revealScrollBars();
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function settingsButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(SHOW_SETTINGS);
		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/HorizontalLayoutSettingsScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.NumericStepper;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.data.ArrayCollection;
	import feathers.data.ListCollection;
	import feathers.data.VectorCollection;
	import feathers.examples.layoutExplorer.data.HorizontalLayoutSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;

	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class HorizontalLayoutSettingsScreen extends PanelScreen
	{
		public function HorizontalLayoutSettingsScreen()
		{
			super();
		}

		public var settings:HorizontalLayoutSettings;

		private var _list:List;

		private var _itemCountStepper:NumericStepper;
		private var _gapStepper:NumericStepper;
		private var _paddingTopStepper:NumericStepper;
		private var _paddingRightStepper:NumericStepper;
		private var _paddingBottomStepper:NumericStepper;
		private var _paddingLeftStepper:NumericStepper;
		private var _horizontalAlignPicker:PickerList;
		private var _verticalAlignPicker:PickerList;

		override public function dispose():void
		{
			//icon and accessory display objects in the list's data provider
			//won't be automatically disposed because feathers cannot know if
			//they need to be used again elsewhere or not. we need to dispose
			//them manually.
			this._list.dataProvider.dispose(disposeItemAccessory);

			//never forget to call super.dispose() because you don't want to
			//create a memory leak!
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Horizontal Layout Settings";

			this.layout = new AnchorLayout();

			this._itemCountStepper = new NumericStepper();
			this._itemCountStepper.minimum = 1;
			//the layout can certainly handle more. this value is arbitrary.
			this._itemCountStepper.maximum = 100;
			this._itemCountStepper.step = 1;
			this._itemCountStepper.value = this.settings.itemCount;
			this._itemCountStepper.addEventListener(Event.CHANGE, itemCountStepper_changeHandler);

			this._horizontalAlignPicker = new PickerList();
			this._horizontalAlignPicker.typicalItem = HorizontalAlign.CENTER;
			this._horizontalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				HorizontalAlign.LEFT,
				HorizontalAlign.CENTER,
				HorizontalAlign.RIGHT
			]);
			this._horizontalAlignPicker.selectedItem = this.settings.horizontalAlign;
			this._horizontalAlignPicker.addEventListener(Event.CHANGE, horizontalAlignPicker_changeHandler);

			this._verticalAlignPicker = new PickerList();
			this._verticalAlignPicker.typicalItem = VerticalAlign.BOTTOM;
			this._verticalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				VerticalAlign.TOP,
				VerticalAlign.MIDDLE,
				VerticalAlign.BOTTOM,
				VerticalAlign.JUSTIFY
			]);
			this._verticalAlignPicker.selectedItem = this.settings.verticalAlign;
			this._verticalAlignPicker.addEventListener(Event.CHANGE, verticalAlignPicker_changeHandler);

			this._gapStepper = new NumericStepper();
			this._gapStepper.minimum = 0;
			//these maximum values are completely arbitrary
			this._gapStepper.maximum = 100;
			this._gapStepper.step = 1;
			this._gapStepper.value = this.settings.gap;
			this._gapStepper.addEventListener(Event.CHANGE, gapStepper_changeHandler);

			this._paddingTopStepper = new NumericStepper();
			this._paddingTopStepper.minimum = 0;
			this._paddingTopStepper.maximum = 100;
			this._paddingTopStepper.step = 1;
			this._paddingTopStepper.value = this.settings.paddingTop;
			this._paddingTopStepper.addEventListener(Event.CHANGE, paddingTopStepper_changeHandler);

			this._paddingRightStepper = new NumericStepper();
			this._paddingRightStepper.minimum = 0;
			this._paddingRightStepper.maximum = 100;
			this._paddingRightStepper.step = 1;
			this._paddingRightStepper.value = this.settings.paddingRight;
			this._paddingRightStepper.addEventListener(Event.CHANGE, paddingRightStepper_changeHandler);

			this._paddingBottomStepper = new NumericStepper();
			this._paddingBottomStepper.minimum = 0;
			this._paddingBottomStepper.maximum = 100;
			this._paddingBottomStepper.step = 1;
			this._paddingBottomStepper.value = this.settings.paddingBottom;
			this._paddingBottomStepper.addEventListener(Event.CHANGE, paddingBottomStepper_changeHandler);

			this._paddingLeftStepper = new NumericStepper();
			this._paddingLeftStepper.minimum = 0;
			this._paddingLeftStepper.maximum = 100;
			this._paddingLeftStepper.step = 1;
			this._paddingLeftStepper.value = this.settings.paddingLeft;
			this._paddingLeftStepper.addEventListener(Event.CHANGE, paddingLeftStepper_changeHandler);

			this._list = new List();
			this._list.isSelectable = false;
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Item Count", accessory: this._itemCountStepper },
				{ label: "horizontalAlign", accessory: this._horizontalAlignPicker },
				{ label: "verticalAlign", accessory: this._verticalAlignPicker },
				{ label: "gap", accessory: this._gapStepper },
				{ label: "paddingTop", accessory: this._paddingTopStepper },
				{ label: "paddingRight", accessory: this._paddingRightStepper },
				{ label: "paddingBottom", accessory: this._paddingBottomStepper },
				{ label: "paddingLeft", accessory: this._paddingLeftStepper },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = this.onBackButton;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			var doneButton:Button = new Button();
			doneButton.label = "Done";
			doneButton.addEventListener(Event.TRIGGERED, doneButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				doneButton
			];
			return header;
		}

		private function disposeItemAccessory(item:Object):void
		{
			DisplayObject(item.accessory).dispose();
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function doneButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function itemCountStepper_changeHandler(event:Event):void
		{
			this.settings.itemCount = this._itemCountStepper.value;
		}

		private function horizontalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.horizontalAlign = this._horizontalAlignPicker.selectedItem as String;
		}

		private function verticalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.verticalAlign = this._verticalAlignPicker.selectedItem as String;
		}

		private function gapStepper_changeHandler(event:Event):void
		{
			this.settings.gap = this._gapStepper.value;
		}

		private function paddingTopStepper_changeHandler(event:Event):void
		{
			this.settings.paddingTop = this._paddingTopStepper.value;
		}

		private function paddingRightStepper_changeHandler(event:Event):void
		{
			this.settings.paddingRight = this._paddingRightStepper.value;
		}

		private function paddingBottomStepper_changeHandler(event:Event):void
		{
			this.settings.paddingBottom = this._paddingBottomStepper.value;
		}

		private function paddingLeftStepper_changeHandler(event:Event):void
		{
			this.settings.paddingLeft = this._paddingLeftStepper.value;
		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/MainMenuScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ArrayCollection;
	import feathers.data.ListCollection;
	import feathers.events.FeathersEventType;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.events.Event;

	[Event(name="showAnchor",type="starling.events.Event")]

	[Event(name="showFlow",type="starling.events.Event")]

	[Event(name="showHorizontal",type="starling.events.Event")]

	[Event(name="showVertical",type="starling.events.Event")]

	[Event(name="showTiledRows",type="starling.events.Event")]

	[Event(name="showTiledColumns",type="starling.events.Event")]

	[Event(name="showWaterfall",type="starling.events.Event")]

	public class MainMenuScreen extends PanelScreen
	{
		public static const SHOW_ANCHOR:String = "showAnchor";
		public static const SHOW_FLOW:String = "showFlow";
		public static const SHOW_HORIZONTAL:String = "showHorizontal";
		public static const SHOW_VERTICAL:String = "showVertical";
		public static const SHOW_TILED_ROWS:String = "showTiledRows";
		public static const SHOW_TILED_COLUMNS:String = "showTiledColumns";
		public static const SHOW_WATERFALL:String = "showWaterfall";
		public static const SHOW_SLIDE_SHOW:String = "showSlideShow";

		public function MainMenuScreen()
		{
			super();
		}

		private var _list:List;

		public var savedVerticalScrollPosition:Number = 0;
		public var savedSelectedIndex:int = -1;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Layouts in Feathers";

			var isTablet:Boolean = DeviceCapabilities.isTablet(Starling.current.nativeStage);

			this.layout = new AnchorLayout();

			this._list = new List();
			this._list.dataProvider = new ArrayCollection(
			[
				{ text: "Anchor", event: SHOW_ANCHOR },
				{ text: "Flow", event: SHOW_FLOW },
				{ text: "Horizontal", event: SHOW_HORIZONTAL },
				{ text: "Vertical", event: SHOW_VERTICAL },
				{ text: "Tiled Rows", event: SHOW_TILED_ROWS },
				{ text: "Tiled Columns", event: SHOW_TILED_COLUMNS },
				{ text: "Waterfall", event: SHOW_WATERFALL },
				{ text: "Slide Show", event: SHOW_SLIDE_SHOW },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.verticalScrollPosition = this.savedVerticalScrollPosition;

			this._list.itemRendererFactory = this.createItemRenderer;

			if(isTablet)
			{
				this._list.addEventListener(Event.CHANGE, list_changeHandler);
				this._list.selectedIndex = 0;
				this._list.revealScrollBars();
			}
			else
			{
				this._list.selectedIndex = this.savedSelectedIndex;
				this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
			}
			this.addChild(this._list);
		}

		private function createItemRenderer():IListItemRenderer
		{
			var isTablet:Boolean = DeviceCapabilities.isTablet(Starling.current.nativeStage);
			
			var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();
			if(!isTablet)
			{
				renderer.styleNameList.add(DefaultListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN);
			}

			//enable the quick hit area to optimize hit tests when an item
			//is only selectable and doesn't have interactive children.
			renderer.isQuickHitAreaEnabled = true;

			renderer.labelField = "text";
			return renderer;
		}

		private function transitionInCompleteHandler(event:Event):void
		{
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this._list.selectedIndex = -1;
				this._list.addEventListener(Event.CHANGE, list_changeHandler);
			}
			this._list.revealScrollBars();
		}

		private function list_changeHandler(event:Event):void
		{
			var eventType:String = this._list.selectedItem.event as String;
			if(DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.dispatchEventWith(eventType);
				return;
			}

			//save the list's scroll position and selected index so that we
			//can restore some context when this screen when we return to it
			//again later.
			this.dispatchEventWith(eventType, false,
			{
				savedVerticalScrollPosition: this._list.verticalScrollPosition,
				savedSelectedIndex: this._list.selectedIndex
			});

		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/SlideShowLayoutScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.Label;
	import feathers.controls.PanelScreen;
	import feathers.events.FeathersEventType;
	import feathers.examples.layoutExplorer.data.SlideShowLayoutSettings;
	import feathers.layout.SlideShowLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	[Event(name="showSettings",type="starling.events.Event")]

	public class SlideShowLayoutScreen extends PanelScreen
	{
		public static const SHOW_SETTINGS:String = "showSettings";

		public function SlideShowLayoutScreen()
		{
			super();
		}

		public var settings:SlideShowLayoutSettings;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Slide Show Layout";

			this.layout = new SlideShowLayout();
			//with this layout, you should always snap to pages
			this.snapToPages = true;

			var layout:SlideShowLayout = new SlideShowLayout();
			layout.paddingTop = this.settings.paddingTop;
			layout.paddingRight = this.settings.paddingRight;
			layout.paddingBottom = this.settings.paddingBottom;
			layout.paddingLeft = this.settings.paddingLeft;
			layout.horizontalAlign = this.settings.horizontalAlign;
			layout.verticalAlign = this.settings.verticalAlign;

			var minQuadSize:Number = Math.min(Starling.current.stage.stageWidth, Starling.current.stage.stageHeight) / 2;
			for(var i:int = 0; i < this.settings.itemCount; i++)
			{
				var size:Number = (minQuadSize + minQuadSize * 0.5 * Math.random());
				var quad:Quad = new Quad(size, size, 0xff8800);
				this.addChild(quad);
			}

			this.layout = layout;

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}

			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			var settingsButton:Button = new Button();
			settingsButton.label = "Settings";
			settingsButton.addEventListener(Event.TRIGGERED, settingsButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				settingsButton
			];
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function transitionInCompleteHandler(event:Event):void
		{
			this.revealScrollBars();
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function settingsButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(SHOW_SETTINGS);
		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/SlideShowLayoutSettingsScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.NumericStepper;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.data.ArrayCollection;
	import feathers.data.ListCollection;
	import feathers.data.VectorCollection;
	import feathers.examples.layoutExplorer.data.SlideShowLayoutSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;

	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class SlideShowLayoutSettingsScreen extends PanelScreen
	{
		public function SlideShowLayoutSettingsScreen()
		{
			super();
		}

		public var settings:SlideShowLayoutSettings;

		private var _list:List;

		private var _itemCountStepper:NumericStepper;
		private var _paddingTopStepper:NumericStepper;
		private var _paddingRightStepper:NumericStepper;
		private var _paddingBottomStepper:NumericStepper;
		private var _paddingLeftStepper:NumericStepper;
		private var _horizontalAlignPicker:PickerList;
		private var _verticalAlignPicker:PickerList;

		override public function dispose():void
		{
			//icon and accessory display objects in the list's data provider
			//won't be automatically disposed because feathers cannot know if
			//they need to be used again elsewhere or not. we need to dispose
			//them manually.
			this._list.dataProvider.dispose(disposeItemAccessory);

			//never forget to call super.dispose() because you don't want to
			//create a memory leak!
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Slide Show Layout Settings";

			this.layout = new AnchorLayout();

			this._itemCountStepper = new NumericStepper();
			this._itemCountStepper.minimum = 1;
			//the layout can certainly handle more. this value is arbitrary.
			this._itemCountStepper.maximum = 100;
			this._itemCountStepper.step = 1;
			this._itemCountStepper.value = this.settings.itemCount;
			this._itemCountStepper.addEventListener(Event.CHANGE, itemCountStepper_changeHandler);

			this._horizontalAlignPicker = new PickerList();
			this._horizontalAlignPicker.typicalItem = HorizontalAlign.CENTER;
			this._horizontalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				HorizontalAlign.LEFT,
				HorizontalAlign.CENTER,
				HorizontalAlign.RIGHT,
				HorizontalAlign.JUSTIFY
			]);
			this._horizontalAlignPicker.selectedItem = this.settings.horizontalAlign;
			this._horizontalAlignPicker.addEventListener(Event.CHANGE, horizontalAlignPicker_changeHandler);

			this._verticalAlignPicker = new PickerList();
			this._verticalAlignPicker.typicalItem = VerticalAlign.BOTTOM;
			this._verticalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				VerticalAlign.TOP,
				VerticalAlign.MIDDLE,
				VerticalAlign.BOTTOM,
				VerticalAlign.JUSTIFY
			]);
			this._verticalAlignPicker.selectedItem = this.settings.verticalAlign;
			this._verticalAlignPicker.addEventListener(Event.CHANGE, verticalAlignPicker_changeHandler);

			this._paddingTopStepper = new NumericStepper();
			this._paddingTopStepper.minimum = 0;
			this._paddingTopStepper.maximum = 100;
			this._paddingTopStepper.step = 1;
			this._paddingTopStepper.value = this.settings.paddingTop;
			this._paddingTopStepper.addEventListener(Event.CHANGE, paddingTopStepper_changeHandler);

			this._paddingRightStepper = new NumericStepper();
			this._paddingRightStepper.minimum = 0;
			this._paddingRightStepper.maximum = 100;
			this._paddingRightStepper.step = 1;
			this._paddingRightStepper.value = this.settings.paddingRight;
			this._paddingRightStepper.addEventListener(Event.CHANGE, paddingRightStepper_changeHandler);

			this._paddingBottomStepper = new NumericStepper();
			this._paddingBottomStepper.minimum = 0;
			this._paddingBottomStepper.maximum = 100;
			this._paddingBottomStepper.step = 1;
			this._paddingBottomStepper.value = this.settings.paddingBottom;
			this._paddingBottomStepper.addEventListener(Event.CHANGE, paddingBottomStepper_changeHandler);

			this._paddingLeftStepper = new NumericStepper();
			this._paddingLeftStepper.minimum = 0;
			this._paddingLeftStepper.maximum = 100;
			this._paddingLeftStepper.step = 1;
			this._paddingLeftStepper.value = this.settings.paddingLeft;
			this._paddingLeftStepper.addEventListener(Event.CHANGE, paddingLeftStepper_changeHandler);

			this._list = new List();
			this._list.isSelectable = false;
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Item Count", accessory: this._itemCountStepper },
				{ label: "horizontalAlign", accessory: this._horizontalAlignPicker },
				{ label: "verticalAlign", accessory: this._verticalAlignPicker },
				{ label: "paddingTop", accessory: this._paddingTopStepper },
				{ label: "paddingRight", accessory: this._paddingRightStepper },
				{ label: "paddingBottom", accessory: this._paddingBottomStepper },
				{ label: "paddingLeft", accessory: this._paddingLeftStepper },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = this.onBackButton;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			var doneButton:Button = new Button();
			doneButton.label = "Done";
			doneButton.addEventListener(Event.TRIGGERED, doneButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				doneButton
			];
			return header;
		}

		private function disposeItemAccessory(item:Object):void
		{
			DisplayObject(item.accessory).dispose();
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function doneButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function itemCountStepper_changeHandler(event:Event):void
		{
			this.settings.itemCount = this._itemCountStepper.value;
		}

		private function horizontalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.horizontalAlign = this._horizontalAlignPicker.selectedItem as String;
		}

		private function verticalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.verticalAlign = this._verticalAlignPicker.selectedItem as String;
		}

		private function paddingTopStepper_changeHandler(event:Event):void
		{
			this.settings.paddingTop = this._paddingTopStepper.value;
		}

		private function paddingRightStepper_changeHandler(event:Event):void
		{
			this.settings.paddingRight = this._paddingRightStepper.value;
		}

		private function paddingBottomStepper_changeHandler(event:Event):void
		{
			this.settings.paddingBottom = this._paddingBottomStepper.value;
		}

		private function paddingLeftStepper_changeHandler(event:Event):void
		{
			this.settings.paddingLeft = this._paddingLeftStepper.value;
		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/TiledColumnsLayoutScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.events.FeathersEventType;
	import feathers.examples.layoutExplorer.data.TiledColumnsLayoutSettings;
	import feathers.layout.Direction;
	import feathers.layout.TiledColumnsLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	[Event(name="showSettings",type="starling.events.Event")]

	public class TiledColumnsLayoutScreen extends PanelScreen
	{
		public static const SHOW_SETTINGS:String = "showSettings";

		public function TiledColumnsLayoutScreen()
		{
			super();
		}

		public var settings:TiledColumnsLayoutSettings;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Tiled Columns Layout";

			var layout:TiledColumnsLayout = new TiledColumnsLayout();
			layout.paging = this.settings.paging;
			layout.requestedRowCount = this.settings.requestedRowCount;
			layout.horizontalGap = this.settings.horizontalGap;
			layout.verticalGap = this.settings.verticalGap;
			layout.paddingTop = this.settings.paddingTop;
			layout.paddingRight = this.settings.paddingRight;
			layout.paddingBottom = this.settings.paddingBottom;
			layout.paddingLeft = this.settings.paddingLeft;
			layout.horizontalAlign = this.settings.horizontalAlign;
			layout.verticalAlign = this.settings.verticalAlign;
			layout.tileHorizontalAlign = this.settings.tileHorizontalAlign;
			layout.tileVerticalAlign = this.settings.tileVerticalAlign;

			this.layout = layout;
			this.snapToPages = this.settings.paging != Direction.NONE;
			this.snapScrollPositionsToPixels = true;

			var minQuadSize:Number = Math.min(Starling.current.stage.stageWidth, Starling.current.stage.stageHeight) / 15;
			for(var i:int = 0; i < this.settings.itemCount; i++)
			{
				var size:Number = minQuadSize + minQuadSize * 2 * Math.random();
				var quad:Quad = new Quad(size, size, 0xff8800);
				this.addChild(quad);
			}

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}

			this.headerFactory = this.customHeaderFactory;

			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			var settingsButton:Button = new Button();
			settingsButton.label = "Settings";
			settingsButton.addEventListener(Event.TRIGGERED, settingsButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				settingsButton
			];
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function transitionInCompleteHandler(event:Event):void
		{
			this.revealScrollBars();
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function settingsButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(SHOW_SETTINGS);
		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/TiledColumnsLayoutSettingsScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.NumericStepper;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.data.ArrayCollection;
	import feathers.data.VectorCollection;
	import feathers.examples.layoutExplorer.data.TiledColumnsLayoutSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;

	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class TiledColumnsLayoutSettingsScreen extends PanelScreen
	{
		public function TiledColumnsLayoutSettingsScreen()
		{
			super();
		}

		public var settings:TiledColumnsLayoutSettings;

		private var _list:List;

		private var _itemCountStepper:NumericStepper;
		private var _requestedRowCountStepper:NumericStepper;
		private var _pagingPicker:PickerList;
		private var _horizontalGapStepper:NumericStepper;
		private var _verticalGapStepper:NumericStepper;
		private var _paddingTopStepper:NumericStepper;
		private var _paddingRightStepper:NumericStepper;
		private var _paddingBottomStepper:NumericStepper;
		private var _paddingLeftStepper:NumericStepper;
		private var _horizontalAlignPicker:PickerList;
		private var _verticalAlignPicker:PickerList;
		private var _tileHorizontalAlignPicker:PickerList;
		private var _tileVerticalAlignPicker:PickerList;

		override public function dispose():void
		{
			//icon and accessory display objects in the list's data provider
			//won't be automatically disposed because feathers cannot know if
			//they need to be used again elsewhere or not. we need to dispose
			//them manually.
			this._list.dataProvider.dispose(disposeItemAccessory);

			//never forget to call super.dispose() because you don't want to
			//create a memory leak!
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Tiled Columns Layout Settings";

			this.layout = new AnchorLayout();

			this._itemCountStepper = new NumericStepper();
			this._itemCountStepper.minimum = 1;
			//the layout can certainly handle more. this value is arbitrary.
			this._itemCountStepper.maximum = 100;
			this._itemCountStepper.step = 1;
			this._itemCountStepper.value = this.settings.itemCount;
			this._itemCountStepper.addEventListener(Event.CHANGE, itemCountStepper_changeHandler);

			this._requestedRowCountStepper = new NumericStepper();
			this._requestedRowCountStepper.minimum = 0;
			//the layout can certainly handle more. this value is arbitrary.
			this._requestedRowCountStepper.maximum = 10;
			this._requestedRowCountStepper.step = 1;
			this._requestedRowCountStepper.value = this.settings.requestedRowCount;
			this._requestedRowCountStepper.addEventListener(Event.CHANGE, requestedRowCountStepper_changeHandler);

			this._pagingPicker = new PickerList();
			this._pagingPicker.typicalItem = Direction.HORIZONTAL;
			this._pagingPicker.dataProvider = new VectorCollection(new <String>
			[
				Direction.NONE,
				Direction.HORIZONTAL,
				Direction.VERTICAL
			]);
			this._pagingPicker.selectedItem = this.settings.paging;
			this._pagingPicker.addEventListener(Event.CHANGE, pagingPicker_changeHandler);

			this._horizontalAlignPicker = new PickerList();
			this._horizontalAlignPicker.typicalItem = HorizontalAlign.CENTER;
			this._horizontalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				HorizontalAlign.LEFT,
				HorizontalAlign.CENTER,
				HorizontalAlign.RIGHT
			]);
			this._horizontalAlignPicker.selectedItem = this.settings.horizontalAlign;
			this._horizontalAlignPicker.addEventListener(Event.CHANGE, horizontalAlignPicker_changeHandler);

			this._verticalAlignPicker = new PickerList();
			this._verticalAlignPicker.typicalItem = VerticalAlign.BOTTOM;
			this._verticalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				VerticalAlign.TOP,
				VerticalAlign.MIDDLE,
				VerticalAlign.BOTTOM
			]);
			this._verticalAlignPicker.selectedItem = this.settings.verticalAlign;
			this._verticalAlignPicker.addEventListener(Event.CHANGE, verticalAlignPicker_changeHandler);

			this._tileHorizontalAlignPicker = new PickerList();
			this._tileHorizontalAlignPicker.typicalItem = HorizontalAlign.CENTER;
			this._tileHorizontalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				HorizontalAlign.LEFT,
				HorizontalAlign.CENTER,
				HorizontalAlign.RIGHT,
				HorizontalAlign.JUSTIFY
			]);
			this._tileHorizontalAlignPicker.selectedItem = this.settings.tileHorizontalAlign;
			this._tileHorizontalAlignPicker.addEventListener(Event.CHANGE, tileHorizontalAlignPicker_changeHandler);

			this._tileVerticalAlignPicker = new PickerList();
			this._tileVerticalAlignPicker.typicalItem = VerticalAlign.BOTTOM;
			this._tileVerticalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				VerticalAlign.TOP,
				VerticalAlign.MIDDLE,
				VerticalAlign.BOTTOM,
				VerticalAlign.JUSTIFY
			]);
			this._tileVerticalAlignPicker.selectedItem = this.settings.tileVerticalAlign;
			this._tileVerticalAlignPicker.addEventListener(Event.CHANGE, tileVerticalAlignPicker_changeHandler);

			this._horizontalGapStepper = new NumericStepper();
			this._horizontalGapStepper.minimum = 0;
			//these maximum values are completely arbitrary
			this._horizontalGapStepper.maximum = 100;
			this._horizontalGapStepper.step = 1;
			this._horizontalGapStepper.value = this.settings.horizontalGap;
			this._horizontalGapStepper.addEventListener(Event.CHANGE, horizontalGapStepper_changeHandler);

			this._verticalGapStepper = new NumericStepper();
			this._verticalGapStepper.minimum = 0;
			this._verticalGapStepper.maximum = 100;
			this._verticalGapStepper.step = 1;
			this._verticalGapStepper.value = this.settings.verticalGap;
			this._verticalGapStepper.addEventListener(Event.CHANGE, verticalGapStepper_changeHandler);

			this._paddingTopStepper = new NumericStepper();
			this._paddingTopStepper.minimum = 0;
			this._paddingTopStepper.maximum = 100;
			this._paddingTopStepper.step = 1;
			this._paddingTopStepper.value = this.settings.paddingTop;
			this._paddingTopStepper.addEventListener(Event.CHANGE, paddingTopStepper_changeHandler);

			this._paddingRightStepper = new NumericStepper();
			this._paddingRightStepper.minimum = 0;
			this._paddingRightStepper.maximum = 100;
			this._paddingRightStepper.step = 1;
			this._paddingRightStepper.value = this.settings.paddingRight;
			this._paddingRightStepper.addEventListener(Event.CHANGE, paddingRightStepper_changeHandler);

			this._paddingBottomStepper = new NumericStepper();
			this._paddingBottomStepper.minimum = 0;
			this._paddingBottomStepper.maximum = 100;
			this._paddingBottomStepper.step = 1;
			this._paddingBottomStepper.value = this.settings.paddingBottom;
			this._paddingBottomStepper.addEventListener(Event.CHANGE, paddingBottomStepper_changeHandler);

			this._paddingLeftStepper = new NumericStepper();
			this._paddingLeftStepper.minimum = 0;
			this._paddingLeftStepper.maximum = 100;
			this._paddingLeftStepper.step = 1;
			this._paddingLeftStepper.value = this.settings.paddingLeft;
			this._paddingLeftStepper.addEventListener(Event.CHANGE, paddingLeftStepper_changeHandler);

			this._list = new List();
			this._list.isSelectable = false;
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Item Count", accessory: this._itemCountStepper },
				{ label: "Requested Row Count", accessory: this._requestedRowCountStepper },
				{ label: "Paging", accessory: this._pagingPicker },
				{ label: "horizontalAlign", accessory: this._horizontalAlignPicker },
				{ label: "verticalAlign", accessory: this._verticalAlignPicker },
				{ label: "tileHorizontalAlign", accessory: this._tileHorizontalAlignPicker },
				{ label: "tileVerticalAlign", accessory: this._tileVerticalAlignPicker },
				{ label: "horizontalGap", accessory: this._horizontalGapStepper },
				{ label: "verticalGap", accessory: this._verticalGapStepper },
				{ label: "paddingTop", accessory: this._paddingTopStepper },
				{ label: "paddingRight", accessory: this._paddingRightStepper },
				{ label: "paddingBottom", accessory: this._paddingBottomStepper },
				{ label: "paddingLeft", accessory: this._paddingLeftStepper },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = this.onBackButton;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			var doneButton:Button = new Button();
			doneButton.label = "Done";
			doneButton.addEventListener(Event.TRIGGERED, doneButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				doneButton
			];
			return header;
		}

		private function disposeItemAccessory(item:Object):void
		{
			DisplayObject(item.accessory).dispose();
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function doneButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function itemCountStepper_changeHandler(event:Event):void
		{
			this.settings.itemCount = this._itemCountStepper.value;
		}

		private function requestedRowCountStepper_changeHandler(event:Event):void
		{
			this.settings.requestedRowCount = this._requestedRowCountStepper.value;
		}

		private function pagingPicker_changeHandler(event:Event):void
		{
			this.settings.paging = this._pagingPicker.selectedItem as String;
		}

		private function horizontalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.horizontalAlign = this._horizontalAlignPicker.selectedItem as String;
		}

		private function verticalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.verticalAlign = this._verticalAlignPicker.selectedItem as String;
		}

		private function tileHorizontalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.tileHorizontalAlign = this._tileHorizontalAlignPicker.selectedItem as String;
		}

		private function tileVerticalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.tileVerticalAlign = this._tileVerticalAlignPicker.selectedItem as String;
		}

		private function horizontalGapStepper_changeHandler(event:Event):void
		{
			this.settings.horizontalGap = this._horizontalGapStepper.value;
		}

		private function verticalGapStepper_changeHandler(event:Event):void
		{
			this.settings.verticalGap = this._verticalGapStepper.value;
		}

		private function paddingTopStepper_changeHandler(event:Event):void
		{
			this.settings.paddingTop = this._paddingTopStepper.value;
		}

		private function paddingRightStepper_changeHandler(event:Event):void
		{
			this.settings.paddingRight = this._paddingRightStepper.value;
		}

		private function paddingBottomStepper_changeHandler(event:Event):void
		{
			this.settings.paddingBottom = this._paddingBottomStepper.value;
		}

		private function paddingLeftStepper_changeHandler(event:Event):void
		{
			this.settings.paddingLeft = this._paddingLeftStepper.value;
		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/TiledRowsLayoutScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.events.FeathersEventType;
	import feathers.examples.layoutExplorer.data.TiledRowsLayoutSettings;
	import feathers.layout.Direction;
	import feathers.layout.TiledRowsLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	[Event(name="showSettings",type="starling.events.Event")]

	public class TiledRowsLayoutScreen extends PanelScreen
	{
		public static const SHOW_SETTINGS:String = "showSettings";

		public function TiledRowsLayoutScreen()
		{
			super();
		}

		public var settings:TiledRowsLayoutSettings;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Tiled Rows Layout";

			var layout:TiledRowsLayout = new TiledRowsLayout();
			layout.paging = this.settings.paging;
			layout.requestedColumnCount = this.settings.requestedColumnCount;
			layout.horizontalGap = this.settings.horizontalGap;
			layout.verticalGap = this.settings.verticalGap;
			layout.paddingTop = this.settings.paddingTop;
			layout.paddingRight = this.settings.paddingRight;
			layout.paddingBottom = this.settings.paddingBottom;
			layout.paddingLeft = this.settings.paddingLeft;
			layout.horizontalAlign = this.settings.horizontalAlign;
			layout.verticalAlign = this.settings.verticalAlign;
			layout.tileHorizontalAlign = this.settings.tileHorizontalAlign;
			layout.tileVerticalAlign = this.settings.tileVerticalAlign;

			this.layout = layout;
			this.snapToPages = this.settings.paging != Direction.NONE;
			this.snapScrollPositionsToPixels = true;

			var minQuadSize:Number = Math.min(Starling.current.stage.stageWidth, Starling.current.stage.stageHeight) / 15;
			for(var i:int = 0; i < this.settings.itemCount; i++)
			{
				var size:Number = (minQuadSize + minQuadSize * 2 * Math.random());
				var quad:Quad = new Quad(size, size, 0xff8800);
				this.addChild(quad);
			}

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}

			this.headerFactory = this.customHeaderFactory;

			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			var settingsButton:Button = new Button();
			settingsButton.label = "Settings";
			settingsButton.addEventListener(Event.TRIGGERED, settingsButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				settingsButton
			];
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function transitionInCompleteHandler(event:Event):void
		{
			this.revealScrollBars();
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function settingsButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(SHOW_SETTINGS);
		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/TiledRowsLayoutSettingsScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.NumericStepper;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.data.ArrayCollection;
	import feathers.data.VectorCollection;
	import feathers.examples.layoutExplorer.data.TiledRowsLayoutSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;

	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class TiledRowsLayoutSettingsScreen extends PanelScreen
	{
		public function TiledRowsLayoutSettingsScreen()
		{
			super();
		}

		public var settings:TiledRowsLayoutSettings;

		private var _list:List;

		private var _itemCountStepper:NumericStepper;
		private var _requestedColumnCountStepper:NumericStepper;
		private var _pagingPicker:PickerList;
		private var _horizontalGapStepper:NumericStepper;
		private var _verticalGapStepper:NumericStepper;
		private var _paddingTopStepper:NumericStepper;
		private var _paddingRightStepper:NumericStepper;
		private var _paddingBottomStepper:NumericStepper;
		private var _paddingLeftStepper:NumericStepper;
		private var _horizontalAlignPicker:PickerList;
		private var _verticalAlignPicker:PickerList;
		private var _tileHorizontalAlignPicker:PickerList;
		private var _tileVerticalAlignPicker:PickerList;

		override public function dispose():void
		{
			//icon and accessory display objects in the list's data provider
			//won't be automatically disposed because feathers cannot know if
			//they need to be used again elsewhere or not. we need to dispose
			//them manually.
			this._list.dataProvider.dispose(disposeItemAccessory);

			//never forget to call super.dispose() because you don't want to
			//create a memory leak!
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Tiled Rows Layout Settings";

			this.layout = new AnchorLayout();

			this._itemCountStepper = new NumericStepper();
			this._itemCountStepper.minimum = 1;
			//the layout can certainly handle more. this value is arbitrary.
			this._itemCountStepper.maximum = 100;
			this._itemCountStepper.step = 1;
			this._itemCountStepper.value = this.settings.itemCount;
			this._itemCountStepper.addEventListener(Event.CHANGE, itemCountStepper_changeHandler);

			this._requestedColumnCountStepper = new NumericStepper();
			this._requestedColumnCountStepper.minimum = 0;
			//the layout can certainly handle more. this value is arbitrary.
			this._requestedColumnCountStepper.maximum = 10;
			this._requestedColumnCountStepper.step = 1;
			this._requestedColumnCountStepper.value = this.settings.requestedColumnCount;
			this._requestedColumnCountStepper.addEventListener(Event.CHANGE, requestedColumnCountStepper_changeHandler);

			this._pagingPicker = new PickerList();
			this._pagingPicker.typicalItem = Direction.HORIZONTAL;
			this._pagingPicker.dataProvider = new VectorCollection(new <String>
			[
				Direction.NONE,
				Direction.HORIZONTAL,
				Direction.VERTICAL
			]);
			this._pagingPicker.selectedItem = this.settings.paging;
			this._pagingPicker.addEventListener(Event.CHANGE, pagingPicker_changeHandler);

			this._horizontalAlignPicker = new PickerList();
			this._horizontalAlignPicker.typicalItem = HorizontalAlign.CENTER;
			this._horizontalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				HorizontalAlign.LEFT,
				HorizontalAlign.CENTER,
				HorizontalAlign.RIGHT
			]);
			this._horizontalAlignPicker.selectedItem = this.settings.horizontalAlign;
			this._horizontalAlignPicker.addEventListener(Event.CHANGE, horizontalAlignPicker_changeHandler);

			this._verticalAlignPicker = new PickerList();
			this._verticalAlignPicker.typicalItem = VerticalAlign.BOTTOM;
			this._verticalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				VerticalAlign.TOP,
				VerticalAlign.MIDDLE,
				VerticalAlign.BOTTOM
			]);
			this._verticalAlignPicker.selectedItem = this.settings.verticalAlign;
			this._verticalAlignPicker.addEventListener(Event.CHANGE, verticalAlignPicker_changeHandler);

			this._tileHorizontalAlignPicker = new PickerList();
			this._tileHorizontalAlignPicker.typicalItem = HorizontalAlign.CENTER;
			this._tileHorizontalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				HorizontalAlign.LEFT,
				HorizontalAlign.CENTER,
				HorizontalAlign.RIGHT,
				HorizontalAlign.JUSTIFY
			]);
			this._tileHorizontalAlignPicker.selectedItem = this.settings.tileHorizontalAlign;
			this._tileHorizontalAlignPicker.addEventListener(Event.CHANGE, tileHorizontalAlignPicker_changeHandler);

			this._tileVerticalAlignPicker = new PickerList();
			this._tileVerticalAlignPicker.typicalItem = VerticalAlign.BOTTOM;
			this._tileVerticalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				VerticalAlign.TOP,
				VerticalAlign.MIDDLE,
				VerticalAlign.BOTTOM,
				VerticalAlign.JUSTIFY
			]);
			this._tileVerticalAlignPicker.selectedItem = this.settings.tileVerticalAlign;
			this._tileVerticalAlignPicker.addEventListener(Event.CHANGE, tileVerticalAlignPicker_changeHandler);

			this._horizontalGapStepper = new NumericStepper();
			this._horizontalGapStepper.minimum = 0;
			//these maximum values are completely arbitrary
			this._horizontalGapStepper.maximum = 100;
			this._horizontalGapStepper.step = 1;
			this._horizontalGapStepper.value = this.settings.horizontalGap;
			this._horizontalGapStepper.addEventListener(Event.CHANGE, horizontalGapStepper_changeHandler);

			this._verticalGapStepper = new NumericStepper();
			this._verticalGapStepper.minimum = 0;
			this._verticalGapStepper.maximum = 100;
			this._verticalGapStepper.step = 1;
			this._verticalGapStepper.value = this.settings.verticalGap;
			this._verticalGapStepper.addEventListener(Event.CHANGE, verticalGapStepper_changeHandler);

			this._paddingTopStepper = new NumericStepper();
			this._paddingTopStepper.minimum = 0;
			this._paddingTopStepper.maximum = 100;
			this._paddingTopStepper.step = 1;
			this._paddingTopStepper.value = this.settings.paddingTop;
			this._paddingTopStepper.addEventListener(Event.CHANGE, paddingTopStepper_changeHandler);

			this._paddingRightStepper = new NumericStepper();
			this._paddingRightStepper.minimum = 0;
			this._paddingRightStepper.maximum = 100;
			this._paddingRightStepper.step = 1;
			this._paddingRightStepper.value = this.settings.paddingRight;
			this._paddingRightStepper.addEventListener(Event.CHANGE, paddingRightStepper_changeHandler);

			this._paddingBottomStepper = new NumericStepper();
			this._paddingBottomStepper.minimum = 0;
			this._paddingBottomStepper.maximum = 100;
			this._paddingBottomStepper.step = 1;
			this._paddingBottomStepper.value = this.settings.paddingBottom;
			this._paddingBottomStepper.addEventListener(Event.CHANGE, paddingBottomStepper_changeHandler);

			this._paddingLeftStepper = new NumericStepper();
			this._paddingLeftStepper.minimum = 0;
			this._paddingLeftStepper.maximum = 100;
			this._paddingLeftStepper.step = 1;
			this._paddingLeftStepper.value = this.settings.paddingLeft;
			this._paddingLeftStepper.addEventListener(Event.CHANGE, paddingLeftStepper_changeHandler);

			this._list = new List();
			this._list.isSelectable = false;
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Item Count", accessory: this._itemCountStepper },
				{ label: "Requested Column Count", accessory: this._requestedColumnCountStepper },
				{ label: "Paging", accessory: this._pagingPicker },
				{ label: "horizontalAlign", accessory: this._horizontalAlignPicker },
				{ label: "verticalAlign", accessory: this._verticalAlignPicker },
				{ label: "tileHorizontalAlign", accessory: this._tileHorizontalAlignPicker },
				{ label: "tileVerticalAlign", accessory: this._tileVerticalAlignPicker },
				{ label: "horizontalGap", accessory: this._horizontalGapStepper },
				{ label: "verticalGap", accessory: this._verticalGapStepper },
				{ label: "paddingTop", accessory: this._paddingTopStepper },
				{ label: "paddingRight", accessory: this._paddingRightStepper },
				{ label: "paddingBottom", accessory: this._paddingBottomStepper },
				{ label: "paddingLeft", accessory: this._paddingLeftStepper },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = this.onBackButton;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			var doneButton:Button = new Button();
			doneButton.label = "Done";
			doneButton.addEventListener(Event.TRIGGERED, doneButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				doneButton
			];
			return header;
		}

		private function disposeItemAccessory(item:Object):void
		{
			DisplayObject(item.accessory).dispose();
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function doneButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function itemCountStepper_changeHandler(event:Event):void
		{
			this.settings.itemCount = this._itemCountStepper.value;
		}

		private function requestedColumnCountStepper_changeHandler(event:Event):void
		{
			this.settings.requestedColumnCount = this._requestedColumnCountStepper.value;
		}

		private function pagingPicker_changeHandler(event:Event):void
		{
			this.settings.paging = this._pagingPicker.selectedItem as String;
		}

		private function horizontalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.horizontalAlign = this._horizontalAlignPicker.selectedItem as String;
		}

		private function verticalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.verticalAlign = this._verticalAlignPicker.selectedItem as String;
		}

		private function tileHorizontalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.tileHorizontalAlign = this._tileHorizontalAlignPicker.selectedItem as String;
		}

		private function tileVerticalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.tileVerticalAlign = this._tileVerticalAlignPicker.selectedItem as String;
		}

		private function horizontalGapStepper_changeHandler(event:Event):void
		{
			this.settings.horizontalGap = this._horizontalGapStepper.value;
		}

		private function verticalGapStepper_changeHandler(event:Event):void
		{
			this.settings.verticalGap = this._verticalGapStepper.value;
		}

		private function paddingTopStepper_changeHandler(event:Event):void
		{
			this.settings.paddingTop = this._paddingTopStepper.value;
		}

		private function paddingRightStepper_changeHandler(event:Event):void
		{
			this.settings.paddingRight = this._paddingRightStepper.value;
		}

		private function paddingBottomStepper_changeHandler(event:Event):void
		{
			this.settings.paddingBottom = this._paddingBottomStepper.value;
		}

		private function paddingLeftStepper_changeHandler(event:Event):void
		{
			this.settings.paddingLeft = this._paddingLeftStepper.value;
		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/VerticalLayoutScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.controls.ScrollPolicy;
	import feathers.events.FeathersEventType;
	import feathers.examples.layoutExplorer.data.VerticalLayoutSettings;
	import feathers.layout.VerticalLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	[Event(name="showSettings",type="starling.events.Event")]

	public class VerticalLayoutScreen extends PanelScreen
	{
		public static const SHOW_SETTINGS:String = "showSettings";

		public function VerticalLayoutScreen()
		{
			super();
		}

		public var settings:VerticalLayoutSettings;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Vertical Layout";

			var layout:VerticalLayout = new VerticalLayout();
			layout.gap = this.settings.gap;
			layout.paddingTop = this.settings.paddingTop;
			layout.paddingRight = this.settings.paddingRight;
			layout.paddingBottom = this.settings.paddingBottom;
			layout.paddingLeft = this.settings.paddingLeft;
			layout.horizontalAlign = this.settings.horizontalAlign;
			layout.verticalAlign = this.settings.verticalAlign;

			this.layout = layout;
			//when the scroll policy is set to on, the "elastic" edges will be
			//active even when the max scroll position is zero
			this.verticalScrollPolicy = ScrollPolicy.ON;
			this.snapScrollPositionsToPixels = true;

			var minQuadSize:Number = Math.min(Starling.current.stage.stageWidth, Starling.current.stage.stageHeight) / 15;
			for(var i:int = 0; i < this.settings.itemCount; i++)
			{
				var size:Number = (minQuadSize + minQuadSize * 2 * Math.random());
				var quad:Quad = new Quad(size, size, 0xff8800);
				this.addChild(quad);
			}

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}

			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			var settingsButton:Button = new Button();
			settingsButton.label = "Settings";
			settingsButton.addEventListener(Event.TRIGGERED, settingsButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				settingsButton
			];
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function transitionInCompleteHandler(event:Event):void
		{
			this.revealScrollBars();
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function settingsButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(SHOW_SETTINGS);
		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/VerticalLayoutSettingsScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.NumericStepper;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.data.ArrayCollection;
	import feathers.data.ListCollection;
	import feathers.data.VectorCollection;
	import feathers.examples.layoutExplorer.data.VerticalLayoutSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;

	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class VerticalLayoutSettingsScreen extends PanelScreen
	{
		public function VerticalLayoutSettingsScreen()
		{
			super();
		}

		public var settings:VerticalLayoutSettings;

		private var _list:List;

		private var _itemCountStepper:NumericStepper;
		private var _gapStepper:NumericStepper;
		private var _paddingTopStepper:NumericStepper;
		private var _paddingRightStepper:NumericStepper;
		private var _paddingBottomStepper:NumericStepper;
		private var _paddingLeftStepper:NumericStepper;
		private var _horizontalAlignPicker:PickerList;
		private var _verticalAlignPicker:PickerList;

		override public function dispose():void
		{
			//icon and accessory display objects in the list's data provider
			//won't be automatically disposed because feathers cannot know if
			//they need to be used again elsewhere or not. we need to dispose
			//them manually.
			this._list.dataProvider.dispose(disposeItemAccessory);

			//never forget to call super.dispose() because you don't want to
			//create a memory leak!
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Vertical Layout Settings";

			this.layout = new AnchorLayout();

			this._itemCountStepper = new NumericStepper();
			this._itemCountStepper.minimum = 1;
			//the layout can certainly handle more. this value is arbitrary.
			this._itemCountStepper.maximum = 100;
			this._itemCountStepper.step = 1;
			this._itemCountStepper.value = this.settings.itemCount;
			this._itemCountStepper.addEventListener(Event.CHANGE, itemCountStepper_changeHandler);

			this._horizontalAlignPicker = new PickerList();
			this._horizontalAlignPicker.typicalItem = HorizontalAlign.CENTER;
			this._horizontalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				HorizontalAlign.LEFT,
				HorizontalAlign.CENTER,
				HorizontalAlign.RIGHT,
				HorizontalAlign.JUSTIFY
			]);
			this._horizontalAlignPicker.selectedItem = this.settings.horizontalAlign;
			this._horizontalAlignPicker.addEventListener(Event.CHANGE, horizontalAlignPicker_changeHandler);

			this._verticalAlignPicker = new PickerList();
			this._verticalAlignPicker.typicalItem = VerticalAlign.BOTTOM;
			this._verticalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				VerticalAlign.TOP,
				VerticalAlign.MIDDLE,
				VerticalAlign.BOTTOM
			]);
			this._verticalAlignPicker.selectedItem = this.settings.verticalAlign;
			this._verticalAlignPicker.addEventListener(Event.CHANGE, verticalAlignPicker_changeHandler);

			this._gapStepper = new NumericStepper();
			this._gapStepper.minimum = 0;
			//these maximum values are completely arbitrary
			this._gapStepper.maximum = 100;
			this._gapStepper.step = 1;
			this._gapStepper.value = this.settings.gap;
			this._gapStepper.addEventListener(Event.CHANGE, gapStepper_changeHandler);

			this._paddingTopStepper = new NumericStepper();
			this._paddingTopStepper.minimum = 0;
			this._paddingTopStepper.maximum = 100;
			this._paddingTopStepper.step = 1;
			this._paddingTopStepper.value = this.settings.paddingTop;
			this._paddingTopStepper.addEventListener(Event.CHANGE, paddingTopStepper_changeHandler);

			this._paddingRightStepper = new NumericStepper();
			this._paddingRightStepper.minimum = 0;
			this._paddingRightStepper.maximum = 100;
			this._paddingRightStepper.step = 1;
			this._paddingRightStepper.value = this.settings.paddingRight;
			this._paddingRightStepper.addEventListener(Event.CHANGE, paddingRightStepper_changeHandler);

			this._paddingBottomStepper = new NumericStepper();
			this._paddingBottomStepper.minimum = 0;
			this._paddingBottomStepper.maximum = 100;
			this._paddingBottomStepper.step = 1;
			this._paddingBottomStepper.value = this.settings.paddingBottom;
			this._paddingBottomStepper.addEventListener(Event.CHANGE, paddingBottomStepper_changeHandler);

			this._paddingLeftStepper = new NumericStepper();
			this._paddingLeftStepper.minimum = 0;
			this._paddingLeftStepper.maximum = 100;
			this._paddingLeftStepper.step = 1;
			this._paddingLeftStepper.value = this.settings.paddingLeft;
			this._paddingLeftStepper.addEventListener(Event.CHANGE, paddingLeftStepper_changeHandler);

			this._list = new List();
			this._list.isSelectable = false;
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Item Count", accessory: this._itemCountStepper },
				{ label: "horizontalAlign", accessory: this._horizontalAlignPicker },
				{ label: "verticalAlign", accessory: this._verticalAlignPicker },
				{ label: "gap", accessory: this._gapStepper },
				{ label: "paddingTop", accessory: this._paddingTopStepper },
				{ label: "paddingRight", accessory: this._paddingRightStepper },
				{ label: "paddingBottom", accessory: this._paddingBottomStepper },
				{ label: "paddingLeft", accessory: this._paddingLeftStepper },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = this.onBackButton;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			var doneButton:Button = new Button();
			doneButton.label = "Done";
			doneButton.addEventListener(Event.TRIGGERED, doneButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				doneButton
			];
			return header;
		}

		private function disposeItemAccessory(item:Object):void
		{
			DisplayObject(item.accessory).dispose();
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function doneButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function itemCountStepper_changeHandler(event:Event):void
		{
			this.settings.itemCount = this._itemCountStepper.value;
		}

		private function horizontalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.horizontalAlign = this._horizontalAlignPicker.selectedItem as String;
		}

		private function verticalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.verticalAlign = this._verticalAlignPicker.selectedItem as String;
		}

		private function gapStepper_changeHandler(event:Event):void
		{
			this.settings.gap = this._gapStepper.value;
		}

		private function paddingTopStepper_changeHandler(event:Event):void
		{
			this.settings.paddingTop = this._paddingTopStepper.value;
		}

		private function paddingRightStepper_changeHandler(event:Event):void
		{
			this.settings.paddingRight = this._paddingRightStepper.value;
		}

		private function paddingBottomStepper_changeHandler(event:Event):void
		{
			this.settings.paddingBottom = this._paddingBottomStepper.value;
		}

		private function paddingLeftStepper_changeHandler(event:Event):void
		{
			this.settings.paddingLeft = this._paddingLeftStepper.value;
		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/WaterfallLayoutScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.PanelScreen;
	import feathers.events.FeathersEventType;
	import feathers.examples.layoutExplorer.data.WaterfallLayoutSettings;
	import feathers.layout.WaterfallLayout;
	import feathers.system.DeviceCapabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	[Event(name="showSettings",type="starling.events.Event")]

	public class WaterfallLayoutScreen extends PanelScreen
	{
		public static const SHOW_SETTINGS:String = "showSettings";

		public function WaterfallLayoutScreen()
		{
			super();
		}

		public var settings:WaterfallLayoutSettings;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Waterfall Layout";

			var layout:WaterfallLayout = new WaterfallLayout();
			layout.requestedColumnCount = this.settings.requestedColumnCount;
			layout.horizontalGap = this.settings.horizontalGap;
			layout.verticalGap = this.settings.verticalGap;
			layout.paddingTop = this.settings.paddingTop;
			layout.paddingRight = this.settings.paddingRight;
			layout.paddingBottom = this.settings.paddingBottom;
			layout.paddingLeft = this.settings.paddingLeft;
			layout.horizontalAlign = this.settings.horizontalAlign;

			this.layout = layout;
			this.snapScrollPositionsToPixels = true;

			var minQuadSize:Number = Math.round(Math.min(Starling.current.stage.stageWidth, Starling.current.stage.stageHeight) / 5);
			for(var i:int = 0; i < this.settings.itemCount; i++)
			{
				var height:Number = Math.round((minQuadSize + minQuadSize * Math.random()));
				var quad:Quad = new Quad(minQuadSize, height, 0xff8800);
				this.addChild(quad);
			}

			this.headerFactory = this.customHeaderFactory;

			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				this.backButtonHandler = this.onBackButton;
			}

			this.headerFactory = this.customHeaderFactory;

			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			//this screen doesn't use a back button on tablets because the main
			//app's uses a split layout
			if(!DeviceCapabilities.isTablet(Starling.current.nativeStage))
			{
				var backButton:Button = new Button();
				backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
				backButton.label = "Back";
				backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
				header.leftItems = new <DisplayObject>
				[
					backButton
				];
			}
			var settingsButton:Button = new Button();
			settingsButton.label = "Settings";
			settingsButton.addEventListener(Event.TRIGGERED, settingsButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				settingsButton
			];
			return header;
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function transitionInCompleteHandler(event:Event):void
		{
			this.revealScrollBars();
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function settingsButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(SHOW_SETTINGS);
		}
	}
}


================================================
FILE: examples/LayoutExplorer/source/feathers/examples/layoutExplorer/screens/WaterfallLayoutSettingsScreen.as
================================================
package feathers.examples.layoutExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.NumericStepper;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.data.ArrayCollection;
	import feathers.data.VectorCollection;
	import feathers.examples.layoutExplorer.data.WaterfallLayoutSettings;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.HorizontalAlign;

	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class WaterfallLayoutSettingsScreen extends PanelScreen
	{
		public function WaterfallLayoutSettingsScreen()
		{
			super();
		}

		public var settings:WaterfallLayoutSettings;

		private var _list:List;

		private var _itemCountStepper:NumericStepper;
		private var _requestedColumnCountStepper:NumericStepper;
		private var _horizontalGapStepper:NumericStepper;
		private var _verticalGapStepper:NumericStepper;
		private var _paddingTopStepper:NumericStepper;
		private var _paddingRightStepper:NumericStepper;
		private var _paddingBottomStepper:NumericStepper;
		private var _paddingLeftStepper:NumericStepper;
		private var _horizontalAlignPicker:PickerList;

		override public function dispose():void
		{
			//icon and accessory display objects in the list's data provider
			//won't be automatically disposed because feathers cannot know if
			//they need to be used again elsewhere or not. we need to dispose
			//them manually.
			this._list.dataProvider.dispose(disposeItemAccessory);

			//never forget to call super.dispose() because you don't want to
			//create a memory leak!
			super.dispose();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Waterfall Layout Settings";

			this.layout = new AnchorLayout();

			this._itemCountStepper = new NumericStepper();
			this._itemCountStepper.minimum = 1;
			//the layout can certainly handle more. this value is arbitrary.
			this._itemCountStepper.maximum = 100;
			this._itemCountStepper.step = 1;
			this._itemCountStepper.value = this.settings.itemCount;
			this._itemCountStepper.addEventListener(Event.CHANGE, itemCountStepper_changeHandler);

			this._requestedColumnCountStepper = new NumericStepper();
			this._requestedColumnCountStepper.minimum = 0;
			//the layout can certainly handle more. this value is arbitrary.
			this._requestedColumnCountStepper.maximum = 10;
			this._requestedColumnCountStepper.step = 1;
			this._requestedColumnCountStepper.value = this.settings.requestedColumnCount;
			this._requestedColumnCountStepper.addEventListener(Event.CHANGE, requestedColumnCountStepper_changeHandler);

			this._horizontalAlignPicker = new PickerList();
			this._horizontalAlignPicker.typicalItem = HorizontalAlign.CENTER;
			this._horizontalAlignPicker.dataProvider = new VectorCollection(new <String>
			[
				HorizontalAlign.LEFT,
				HorizontalAlign.CENTER,
				HorizontalAlign.RIGHT
			]);
			this._horizontalAlignPicker.selectedItem = this.settings.horizontalAlign;
			this._horizontalAlignPicker.addEventListener(Event.CHANGE, horizontalAlignPicker_changeHandler);

			this._horizontalGapStepper = new NumericStepper();
			this._horizontalGapStepper.minimum = 0;
			//these maximum values are completely arbitrary
			this._horizontalGapStepper.maximum = 100;
			this._horizontalGapStepper.step = 1;
			this._horizontalGapStepper.value = this.settings.horizontalGap;
			this._horizontalGapStepper.addEventListener(Event.CHANGE, horizontalGapStepper_changeHandler);

			this._verticalGapStepper = new NumericStepper();
			this._verticalGapStepper.minimum = 0;
			this._verticalGapStepper.maximum = 100;
			this._verticalGapStepper.step = 1;
			this._verticalGapStepper.value = this.settings.verticalGap;
			this._verticalGapStepper.addEventListener(Event.CHANGE, verticalGapStepper_changeHandler);

			this._paddingTopStepper = new NumericStepper();
			this._paddingTopStepper.minimum = 0;
			this._paddingTopStepper.maximum = 100;
			this._paddingTopStepper.step = 1;
			this._paddingTopStepper.value = this.settings.paddingTop;
			this._paddingTopStepper.addEventListener(Event.CHANGE, paddingTopStepper_changeHandler);

			this._paddingRightStepper = new NumericStepper();
			this._paddingRightStepper.minimum = 0;
			this._paddingRightStepper.maximum = 100;
			this._paddingRightStepper.step = 1;
			this._paddingRightStepper.value = this.settings.paddingRight;
			this._paddingRightStepper.addEventListener(Event.CHANGE, paddingRightStepper_changeHandler);

			this._paddingBottomStepper = new NumericStepper();
			this._paddingBottomStepper.minimum = 0;
			this._paddingBottomStepper.maximum = 100;
			this._paddingBottomStepper.step = 1;
			this._paddingBottomStepper.value = this.settings.paddingBottom;
			this._paddingBottomStepper.addEventListener(Event.CHANGE, paddingBottomStepper_changeHandler);

			this._paddingLeftStepper = new NumericStepper();
			this._paddingLeftStepper.minimum = 0;
			this._paddingLeftStepper.maximum = 100;
			this._paddingLeftStepper.step = 1;
			this._paddingLeftStepper.value = this.settings.paddingLeft;
			this._paddingLeftStepper.addEventListener(Event.CHANGE, paddingLeftStepper_changeHandler);

			this._list = new List();
			this._list.isSelectable = false;
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Item Count", accessory: this._itemCountStepper },
				{ label: "Requested Column Count", accessory: this._requestedColumnCountStepper },
				{ label: "horizontalAlign", accessory: this._horizontalAlignPicker },
				{ label: "horizontalGap", accessory: this._horizontalGapStepper },
				{ label: "verticalGap", accessory: this._verticalGapStepper },
				{ label: "paddingTop", accessory: this._paddingTopStepper },
				{ label: "paddingRight", accessory: this._paddingRightStepper },
				{ label: "paddingBottom", accessory: this._paddingBottomStepper },
				{ label: "paddingLeft", accessory: this._paddingLeftStepper },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = this.onBackButton;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			var doneButton:Button = new Button();
			doneButton.label = "Done";
			doneButton.addEventListener(Event.TRIGGERED, doneButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				doneButton
			];
			return header;
		}

		private function disposeItemAccessory(item:Object):void
		{
			DisplayObject(item.accessory).dispose();
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function doneButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function itemCountStepper_changeHandler(event:Event):void
		{
			this.settings.itemCount = this._itemCountStepper.value;
		}

		private function requestedColumnCountStepper_changeHandler(event:Event):void
		{
			this.settings.requestedColumnCount = this._requestedColumnCountStepper.value;
		}

		private function horizontalAlignPicker_changeHandler(event:Event):void
		{
			this.settings.horizontalAlign = this._horizontalAlignPicker.selectedItem as String;
		}

		private function horizontalGapStepper_changeHandler(event:Event):void
		{
			this.settings.horizontalGap = this._horizontalGapStepper.value;
		}

		private function verticalGapStepper_changeHandler(event:Event):void
		{
			this.settings.verticalGap = this._verticalGapStepper.value;
		}

		private function paddingTopStepper_changeHandler(event:Event):void
		{
			this.settings.paddingTop = this._paddingTopStepper.value;
		}

		private function paddingRightStepper_changeHandler(event:Event):void
		{
			this.settings.paddingRight = this._paddingRightStepper.value;
		}

		private function paddingBottomStepper_changeHandler(event:Event):void
		{
			this.settings.paddingBottom = this._paddingBottomStepper.value;
		}

		private function paddingLeftStepper_changeHandler(event:Event):void
		{
			this.settings.paddingLeft = this._paddingLeftStepper.value;
		}
	}
}


================================================
FILE: examples/Magic8Chat/README.md
================================================
# Feathers Magic 8 Chat

Demonstrates how to create a mobile chat app using [Feathers](http://feathersui.com/).

## Requirements

In addition to Starling Framework and Feathers, this example project requires the `MetalWorksMobileTheme` example theme. You can find the SWC file for this theme at the following location in the Feathers release build:

	themes/MetalWorksMobileTheme/swc/MetalWorksMobileTheme.swc

## Web Demo

View the [Magic8Chat example](http://feathersui.com/examples/magic-8-chat/) in your browser.

================================================
FILE: examples/Magic8Chat/assets/images/icons-readme.txt
================================================
Icons by Glyphish - glyphish.com

================================================
FILE: examples/Magic8Chat/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
theme.root = ${basedir}/../../themes/MetalWorksMobileTheme/source
output.path = ${basedir}/output
icon.path = ${basedir}/../shared-assets/icons
launch.image.path = ${basedir}/../shared-assets/launch-images-windowed

swf.version = 34

================================================
FILE: examples/Magic8Chat/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="magic8" default="build" basedir=".">

	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<target name="build" depends="build-web,build-android,build-ios"/>

	<target name="prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="build-web" depends="prepare">
		<echo message="Building Magic8ChatWeb.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-advanced-telemetry=true"/>
			<arg value="-frame=two,feathers.examples.magic8.Main"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/Magic8ChatWeb.as"/>
			<arg value="-output=${output.path}/Magic8ChatWeb.swf"/>
		</java>
	</target>
	<target name="build-air-swf" depends="prepare">
		<echo message="Building Magic8Chat.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<!-- uncomment for profiling with scout -->
			<!--<arg value="-advanced-telemetry=true"/>-->
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/Magic8Chat.as"/>
			<arg value="-output=${output.path}/Magic8Chat.swf"/>
		</java>
	</target>
	<target name="-check-ios-properties">
		<fail unless="ios.provision.path"/>
		<fail unless="ios.certificate.path"/>
		<fail unless="ios.certificate.password"/>
	</target>
	<target name="build-ios" depends="-check-ios-properties,build-air-swf">
		<echo message="Packaging Magic8Chat.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="ipa-app-store"/>
			<!-- uncomment for actionscript sampling with scout on ios -->
			<!--<arg value="-sampler"/>-->
			<arg value="-provisioning-profile"/>
			<arg value="${ios.provision.path}"/>
			<arg value="-keystore"/>
			<arg value="${ios.certificate.path}"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-storepass"/>
			<arg value="${ios.certificate.password}"/>
			<arg value="${output.path}/Magic8Chat.ipa"/>
			<arg value="source/Magic8Chat-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${launch.image.path}"/>
			<arg value="Default~iphone.png"/>							<!-- iphone 3gs -->
			<arg value="Default@2x~iphone.png"/>						<!-- iphone 4/4s -->
			<arg value="Default-568h@2x~iphone.png"/>					<!-- iphone 5/5c/5s -->
			<arg value="Default-375w-667h@2x~iphone.png"/>				<!-- iphone 6/7/8 -->
			<arg value="Default-812h@3x~iphone.png"/>					<!-- iphone x (portrait) -->
			<arg value="Default-Landscape-812h@3x~iphone.png"/>			<!-- iphone x (landscape) -->
			<arg value="Default-414w-736h@3x~iphone.png"/>				<!-- iphone 6/7/8 plus (portrait) -->
			<arg value="Default-Landscape-414w-736h@3x~iphone.png"/>	<!-- iphone 6/7/8 plus (landscape) -->
			<arg value="Default-Portrait~ipad.png"/>					<!-- ipad 1/2 (portrait) -->
			<arg value="Default-PortraitUpsideDown~ipad.png"/>			<!-- ipad 1/2 (portrait upside down) -->
			<arg value="Default-Landscape~ipad.png"/>					<!-- ipad 1/2 (landscape left) -->
			<arg value="Default-LandscapeRight~ipad.png"/>				<!-- ipad 1/2 (landscape right) -->
			<arg value="Default-Portrait@2x~ipad.png"/>					<!-- ipad 3/air (portrait) -->
			<arg value="Default-LandscapeLeft@2x~ipad.png"/>			<!-- ipad 3/air (landscape left) -->
			<arg value="Default-LandscapeRight@2x~ipad.png"/>			<!-- ipad 3/air (landscape right) -->
			<arg value="Default-Portrait@2x.png"/>						<!-- ipad pro (portrait) -->
			<arg value="Default-Landscape@2x.png"/>						<!-- ipad pro (landscape) -->
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="Magic8Chat.swf"/>
		</java>
	</target>
	<target name="-check-android-properties">
		<fail unless="android.certificate.path"/>
		<fail unless="android.certificate.password"/>
	</target>
	<target name="build-android" depends="-check-android-properties,build-air-swf">
		<echo message="Packaging Magic8Chat.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="apk-captive-runtime"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-keystore"/>
			<arg value="${android.certificate.path}"/>
			<arg value="-storepass"/>
			<arg value="${android.certificate.password}"/>
			<arg value="${output.path}/Magic8Chat.apk"/>
			<arg value="source/Magic8Chat-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="Magic8Chat.swf"/>
		</java>
	</target>
	<target name="install-android">
		<echo message="Installing Magic8Chat.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.Magic8Chat"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-package"/>
			<arg value="${output.path}/Magic8Chat.apk"/>
		</java>
	</target>
	<target name="install-ios">
		<echo message="Installing Magic8Chat.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.Magic8Chat"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-package"/>
			<arg value="${output.path}/Magic8Chat.ipa"/>
		</java>
	</target>
</project>

================================================
FILE: examples/Magic8Chat/source/Magic8Chat-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.examples.Magic8Chat</id>
	<filename>Magic8Chat</filename>
	<name>Magic8Chat</name>
	<versionNumber>4.2.0</versionNumber>
	<description>Magic8Chat example application built with Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>Magic8Chat.swf</content>
		<autoOrients>true</autoOrients>
		<fullScreen>false</fullScreen>
		<visible>true</visible>
		<renderMode>direct</renderMode>
		<depthAndStencil>true</depthAndStencil>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>

	<icon>
		<image29x29>icon29.png</image29x29>
		<image48x48>icon48.png</image48x48>
		<image50x50>icon50.png</image50x50>
		<image57x57>icon57.png</image57x57>
		<image58x58>icon58.png</image58x58>
		<image72x72>icon72.png</image72x72>
		<image87x87>icon87.png</image87x87>
		<image96x96>icon96.png</image96x96>
		<image100x100>icon100.png</image100x100>
		<image114x114>icon114.png</image114x114>
		<image128x128>icon128.png</image128x128>
		<image144x144>icon144.png</image144x144>
		<image180x180>icon180.png</image180x180>
	</icon>
	<android>
		<colorDepth>16bit</colorDepth>
		<manifestAdditions><![CDATA[
			<manifest android:installLocation="auto">
			    <uses-permission android:name="android.permission.INTERNET"/>
			</manifest>
		]]></manifestAdditions>
	</android>
	<iPhone>
		<InfoAdditions>
		<![CDATA[
			<key>UIDeviceFamily</key> 
			<array> 
				<string>1</string>
				<string>2</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<true/>
			<key>UIStatusBarStyle</key>
			<string>UIStatusBarStyleLightContent</string>
		]]> 
		</InfoAdditions>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</iPhone>
</application>

================================================
FILE: examples/Magic8Chat/source/Magic8Chat.as
================================================
package
{
	import feathers.examples.magic8.Main;
	import feathers.utils.ScreenDensityScaleFactorManager;

	import flash.display.Loader;
	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageOrientation;
	import flash.display.StageScaleMode;
	import flash.display3D.Context3DProfile;
	import flash.display3D.Context3DRenderMode;
	import flash.events.Event;
	import flash.filesystem.File;
	import flash.filesystem.FileMode;
	import flash.filesystem.FileStream;
	import flash.system.Capabilities;
	import flash.utils.ByteArray;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class Magic8Chat extends Sprite
	{
		public function Magic8Chat()
		{
			if(this.stage)
			{
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
				this.stage.align = StageAlign.TOP_LEFT;
			}
			this.mouseEnabled = this.mouseChildren = false;
			this.showLaunchImage();
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;
		private var _scaler:ScreenDensityScaleFactorManager;
		private var _launchImage:Loader;
		private var _savedAutoOrients:Boolean;

		/**
		 * On iOS, add the native launch image to the classic display list to
		 * avoid displaying only the stage background color between when the
		 * AIR app finishes launching and Starling starts rendering.
		 * 
		 * Launch image names: https://forums.adobe.com/message/9986239#9986239
		 */
		private function showLaunchImage():void
		{
			var filePath:String = null;
			var isPortraitOnly:Boolean = false;
			if(Capabilities.manufacturer.indexOf("iOS") >= 0)
			{
				var isPortraitUpsideDown:Boolean = this.stage.orientation == StageOrientation.UPSIDE_DOWN;
				var isPortrait:Boolean = this.stage.orientation == StageOrientation.DEFAULT || isPortraitUpsideDown;
				var isLandscapeRight:Boolean = this.stage.orientation == StageOrientation.ROTATED_RIGHT;
				if(Capabilities.screenResolutionX == 1242 && Capabilities.screenResolutionY == 2208)
				{
					//iphone 6/7/8 plus
					filePath = isPortrait ? "Default-414w-736h@3x~iphone.png" : "Default-Landscape-414w-736h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 1125 && Capabilities.screenResolutionY == 2436)
				{
					//iphone x
					filePath = isPortrait ? "Default-812h@3x~iphone.png" : "Default-Landscape-812h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 2048 && Capabilities.screenResolutionY == 2732)
				{
					//ipad pro
					filePath = isPortrait ? "Default-Portrait@2x.png" : "Default-Landscape@2x.png";
				}
				else if(Capabilities.screenResolutionX == 1536 && Capabilities.screenResolutionY == 2048)
				{
					//ipad 3/air
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait@2x~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown@2x~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight@2x~ipad.png";
					}
					else
					{
						filePath = "Default-LandscapeLeft@2x~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 768 && Capabilities.screenResolutionY == 1024)
				{
					//ipad 1/2
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight~ipad.png";
					}
					else
					{
						filePath = "Default-Landscape~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 750)
				{
					//iphone 6/7/8
					isPortraitOnly = true;
					filePath = "Default-375w-667h@2x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 640)
				{
					isPortraitOnly = true;
					if(Capabilities.screenResolutionY == 1136)
					{
						//iphone 5/5c/5s
						filePath = "Default-568h@2x~iphone.png";
					}
					else
					{
						//iphone 4/4s
						filePath = "Default@2x~iphone.png";
					}
				}
				else if(Capabilities.screenResolutionX == 320)
				{
					//iphone 3gs
					isPortraitOnly = true;
					filePath = "Default~iphone.png";
				}
			}

			if(filePath)
			{
				var file:File = File.applicationDirectory.resolvePath(filePath);
				if(file.exists)
				{
					var bytes:ByteArray = new ByteArray();
					var stream:FileStream = new FileStream();
					stream.open(file, FileMode.READ);
					stream.readBytes(bytes, 0, stream.bytesAvailable);
					stream.close();
					this._launchImage = new Loader();
					this._launchImage.loadBytes(bytes);
					this.addChild(this._launchImage);
					this._savedAutoOrients = this.stage.autoOrients;
					this.stage.autoOrients = false;
					if(isPortraitOnly)
					{
						this.stage.setOrientation(StageOrientation.DEFAULT);
					}
				}
			}
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(Main, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE);
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.start();
			if(this._launchImage)
			{
				this._starling.addEventListener("rootCreated", starling_rootCreatedHandler);
			}
			this._scaler = new ScreenDensityScaleFactorManager(this._starling);
			this.stage.addEventListener(Event.DEACTIVATE, stage_deactivateHandler, false, 0, true);
		}

		private function starling_rootCreatedHandler(event:Object):void
		{
			if(this._launchImage)
			{
				this.removeChild(this._launchImage);
				this._launchImage.unloadAndStop(true);
				this._launchImage = null;
				this.stage.autoOrients = this._savedAutoOrients;
			}
		}

		private function stage_deactivateHandler(event:Event):void
		{
			this._starling.stop(true);
			this.stage.addEventListener(Event.ACTIVATE, stage_activateHandler, false, 0, true);
		}

		private function stage_activateHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.ACTIVATE, stage_activateHandler);
			this._starling.start();
		}

	}
}

================================================
FILE: examples/Magic8Chat/source/Magic8ChatWeb.as
================================================
package
{
	import feathers.system.DeviceCapabilities;

	import flash.display.MovieClip;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.events.Event;
	import flash.geom.Rectangle;
	import flash.ui.ContextMenu;
	import flash.utils.getDefinitionByName;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class Magic8ChatWeb extends MovieClip
	{
		public function Magic8ChatWeb()
		{
			var menu:ContextMenu = new ContextMenu();
			menu.hideBuiltInItems();
			this.contextMenu = menu;
			
			if(this.stage)
			{
				this.stage.align = StageAlign.TOP_LEFT;
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
			}
			
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}
		
		private var _starling:Starling;
		
		private function start():void
		{
			this.gotoAndStop(2);
			this.graphics.clear();
			
			//simulating iPhone Retina
			DeviceCapabilities.dpi = 326;
			
			Starling.multitouchEnabled = true;
			var MainType:Class = getDefinitionByName("feathers.examples.magic8.Main") as Class;
			this._starling = new Starling(MainType, this.stage, new Rectangle(0, 0, 960, 640));
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.stage.stageWidth = 480;
			this._starling.stage.stageHeight = 320;
			this._starling.start();
		}
		
		private function loaderInfo_completeHandler(event:Event):void
		{
			this.start();
		}
	}
}

================================================
FILE: examples/Magic8Chat/source/feathers/examples/magic8/Main.as
================================================
package feathers.examples.magic8
{
	import feathers.controls.Button;
	import feathers.controls.LayoutGroup;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.TextInput;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.controls.text.StageTextTextEditor;
	import feathers.core.ITextEditor;
	import feathers.data.ArrayCollection;
	import feathers.data.ListCollection;
	import feathers.events.FeathersEventType;
	import feathers.examples.magic8.data.ChatMessage;
	import feathers.examples.magic8.themes.Magic8ChatTheme;
	import feathers.examples.magic8.themes.StyleNames;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayoutData;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;

	import starling.events.Event;

	public class Main extends PanelScreen
	{
		private static const MESSAGES:Vector.<String> = new <String>
		[
			"It is certain",
			"It is decidedly so",
			"Without a doubt",
			"Yes, definitely",
			"You may rely on it",
			"As I see it, yes",
			"Most likely",
			"Outlook good",
			"Yes",
			"Signs point to yes",
			"Reply hazy try again",
			"Ask again later",
			"Better not tell you now",
			"Cannot predict now",
			"Concentrate and ask again",
			"Don't count on it",
			"My reply is no",
			"My sources say no",
			"Outlook not so good",
			"Very doubtful",
		];

		private static const USER_ITEM:String = "user";
		private static const EIGHT_BALL_ITEM:String = "8ball";

		public function Main()
		{
			new Magic8ChatTheme();
			super();
			this.title = "Magic 8-Ball";
		}

		private var _list:List;
		private var _input:TextInput;
		private var _sendButton:Button;

		override protected function initialize():void
		{
			super.initialize();

			this.layout = new AnchorLayout();

			this._list = new List();
			this._list.dataProvider = new ArrayCollection();
			this._list.isSelectable = false;
			this._list.setItemRendererFactoryWithID(USER_ITEM, function():IListItemRenderer
			{
				var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
				itemRenderer.styleNameList.add(StyleNames.USER_MESSAGE_ITEM_RENDERER);
				itemRenderer.labelField = "message";
				itemRenderer.wordWrap = true;
				return itemRenderer;
			});
			this._list.setItemRendererFactoryWithID(EIGHT_BALL_ITEM, function():IListItemRenderer
			{
				var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
				itemRenderer.styleNameList.add(StyleNames.EIGHT_BALL_MESSAGE_ITEM_RENDERER);
				itemRenderer.labelField = "message";
				itemRenderer.wordWrap = true;
				return itemRenderer;
			});
			this._list.factoryIDFunction = function(item:ChatMessage):String
			{
				if(item.type === ChatMessage.TYPE_MAGIC_8BALL)
				{
					return EIGHT_BALL_ITEM;
				}
				return USER_ITEM;
			};
			var listLayout:VerticalLayout = new VerticalLayout();
			listLayout.hasVariableItemDimensions = true;
			listLayout.horizontalAlign = HorizontalAlign.JUSTIFY;
			listLayout.verticalAlign = VerticalAlign.BOTTOM;
			this._list.layout = listLayout;
			this.addChild(this._list);

			var controls:LayoutGroup = new LayoutGroup();
			controls.styleNameList.add(LayoutGroup.ALTERNATE_STYLE_NAME_TOOLBAR);
			this.addChild(controls);

			this._input = new TextInput();
			this._input.prompt = "Ask a yes or no question...";
			this._input.layoutData = new HorizontalLayoutData(100);
			this._input.textEditorFactory = function():ITextEditor
			{
				var textEditor:StageTextTextEditor = new StageTextTextEditor();
				textEditor.maintainTouchFocus = true;
				//flash.text.ReturnKeyLabel doesn't exist in Flash Player, so
				//we can't use the constant here.
				//we use ReturnKeyLabel.GO because the default label doesn't
				//dispatch an event for Keyboard.ENTER on all platforms.
				textEditor.returnKeyLabel = "go";
				return textEditor;
			};
			this._input.addEventListener(FeathersEventType.ENTER, input_enterHandler);
			this._input.addEventListener(Event.CHANGE, input_changeHandler);
			controls.addChild(this._input);

			this._sendButton = new Button();
			this._sendButton.label = "Send";
			this._sendButton.addEventListener(Event.TRIGGERED, sendButton_triggeredHandler);
			controls.addChild(this._sendButton);

			controls.layoutData = new AnchorLayoutData(NaN, 0, 0, 0);
			var listLayoutData:AnchorLayoutData = new AnchorLayoutData(0, 0, 0, 0);
			listLayoutData.bottomAnchorDisplayObject = controls;
			this._list.layoutData = listLayoutData;
		}

		private function sendMessage():void
		{
			var message:String = this._input.text;
			if(message.length == 0)
			{
				this._input.errorString = "Please ask a question!";
				return;
			}
			this._input.text = "";
			this._list.dataProvider.addItem(new ChatMessage(ChatMessage.TYPE_USER, message));

			var index:int = Math.floor(Math.random() * MESSAGES.length);
			var response:String = MESSAGES[index];
			this._list.dataProvider.addItem(new ChatMessage(ChatMessage.TYPE_MAGIC_8BALL, response));

			this._list.validate();
			this._list.scrollToPosition(0, this._list.maxVerticalScrollPosition, 0.5);
		}

		private function input_changeHandler(event:Event):void
		{
			if(this._input.text.length > 0)
			{
				this._input.errorString = null;
			}
		}

		private function input_enterHandler(event:Event):void
		{
			this.sendMessage();
		}

		private function sendButton_triggeredHandler(event:Event):void
		{
			this.sendMessage();
		}
	}
}


================================================
FILE: examples/Magic8Chat/source/feathers/examples/magic8/data/ChatMessage.as
================================================
package feathers.examples.magic8.data
{
	public class ChatMessage
	{
		public static const TYPE_USER:String = "user";
		public static const TYPE_MAGIC_8BALL:String = "magic8Ball";

		public function ChatMessage(type:String, message:String)
		{
			this.type = type;
			this.message = message;
		}

		public var type:String;
		public var message:String;
	}
}


================================================
FILE: examples/Magic8Chat/source/feathers/examples/magic8/themes/Magic8ChatTheme.as
================================================
package feathers.examples.magic8.themes
{
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.text.TextBlockTextRenderer;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.RelativePosition;
	import feathers.themes.MetalWorksMobileTheme;

	import starling.display.Image;
	import starling.textures.Texture;

	public class Magic8ChatTheme extends MetalWorksMobileTheme
	{
		[Embed(source="/../assets/images/8ball@2x.png")]
		private static const EIGHT_BALL_ICON:Class;

		[Embed(source="/../assets/images/question@2x.png")]
		private static const QUESTION_ICON:Class;

		private static const THEME_STYLE_NAME_MESSAGE_ITEM_RENDERER_LABEL:String = "magic8Ball-message-item-renderer-label";

		public function Magic8ChatTheme()
		{
			super();
		}

		private var eightBallTexture:Texture;
		private var questionTexture:Texture;

		override protected function initializeTextures():void
		{
			super.initializeTextures();
			this.eightBallTexture = Texture.fromEmbeddedAsset(EIGHT_BALL_ICON, false, false, 2);
			this.questionTexture = Texture.fromEmbeddedAsset(QUESTION_ICON, false, false, 2);
		}

		override protected function initializeStyleProviders():void
		{
			super.initializeStyleProviders();
			this.getStyleProviderForClass(DefaultListItemRenderer)
				.setFunctionForStyleName(StyleNames.USER_MESSAGE_ITEM_RENDERER, this.setUserMessageItemRendererStyles);
			this.getStyleProviderForClass(DefaultListItemRenderer)
				.setFunctionForStyleName(StyleNames.EIGHT_BALL_MESSAGE_ITEM_RENDERER, this.setEightBallMessageItemRendererStyles);
			this.getStyleProviderForClass(TextBlockTextRenderer)
				.setFunctionForStyleName(THEME_STYLE_NAME_MESSAGE_ITEM_RENDERER_LABEL, this.setMessageItemRendererLabelStyles);
		}

		private function setUserMessageItemRendererStyles(itemRenderer:DefaultListItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			itemRenderer.customLabelStyleName = THEME_STYLE_NAME_MESSAGE_ITEM_RENDERER_LABEL;

			itemRenderer.horizontalAlign = HorizontalAlign.RIGHT;
			itemRenderer.iconPosition = RelativePosition.RIGHT;

			itemRenderer.itemHasIcon = false;
			itemRenderer.defaultIcon = new Image(this.questionTexture);
		}

		private function setEightBallMessageItemRendererStyles(itemRenderer:DefaultListItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			itemRenderer.customLabelStyleName = THEME_STYLE_NAME_MESSAGE_ITEM_RENDERER_LABEL;

			itemRenderer.itemHasIcon = false;
			itemRenderer.defaultIcon = new Image(this.eightBallTexture);
		}

		private function setMessageItemRendererLabelStyles(text:TextBlockTextRenderer):void
		{
			text.wordWrap = true;
		}
	}
}


================================================
FILE: examples/Magic8Chat/source/feathers/examples/magic8/themes/StyleNames.as
================================================
package feathers.examples.magic8.themes
{
	public class StyleNames
	{
		public static const USER_MESSAGE_ITEM_RENDERER:String = "magic8Ball-user-message-item-renderer";
		public static const EIGHT_BALL_MESSAGE_ITEM_RENDERER:String = "magic8Ball-eight-ball-message-item-renderer";
	}
}


================================================
FILE: examples/PullToRefresh/README.md
================================================
# Feathers Pull to Refresh

A demonstration of a [Feathers](http://feathersui.com/) list component containing a pull view that refreshes the data provider.

## Requirements

In addition to Starling Framework and Feathers, this example project requires the `MetalWorksMobileTheme` example theme. You can find the SWC file for this theme at the following location in the Feathers release build:

	themes/MetalWorksMobileTheme/swc/MetalWorksMobileTheme.swc

## Web Demo

View the [Pull to Refresh](http://feathersui.com/examples/pull-to-refresh/) example in your browser.

================================================
FILE: examples/PullToRefresh/assets/images/spinner.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<TextureAtlas imagePath="spinner.png">
	<!-- Created with Adobe Animate version 16.1.0.86 -->
	<!-- http://www.adobe.com/products/animate.html -->
	<SubTexture name="Spinner0000" x="0" y="0" width="36" height="36" pivotX="0" pivotY="0"/>
	<SubTexture name="Spinner0001" x="0" y="36" width="36" height="36"/>
	<SubTexture name="Spinner0002" x="0" y="72" width="36" height="36"/>
	<SubTexture name="Spinner0003" x="36" y="0" width="36" height="36"/>
	<SubTexture name="Spinner0004" x="72" y="0" width="36" height="36"/>
	<SubTexture name="Spinner0005" x="36" y="36" width="36" height="36"/>
	<SubTexture name="Spinner0006" x="36" y="72" width="36" height="36"/>
	<SubTexture name="Spinner0007" x="72" y="36" width="36" height="36"/>
</TextureAtlas>


================================================
FILE: examples/PullToRefresh/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
theme.root = ${basedir}/../../themes/MetalWorksMobileTheme/source
output.path = ${basedir}/output
icon.path = ${basedir}/../shared-assets/icons
launch.image.path = ${basedir}/../shared-assets/launch-images-windowed
advanced.telemetry=false

swf.version = 30

================================================
FILE: examples/PullToRefresh/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="pull-to-refresh" default="build" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<target name="build" depends="build-web,build-android,build-ios"/>

	<target name="prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="build-web" depends="prepare">
		<echo message="Building PullToRefreshWeb.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-advanced-telemetry=true"/>
			<arg value="-frame=two,feathers.examples.pullToRefresh.Main"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/PullToRefreshWeb.as"/>
			<arg value="-output=${output.path}/PullToRefreshWeb.swf"/>
		</java>
	</target>
	<target name="build-air-swf" depends="prepare">
		<echo message="Building PullToRefresh.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-advanced-telemetry=${advanced.telemetry}"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/PullToRefresh.as"/>
			<arg value="-output=${output.path}/PullToRefresh.swf"/>
		</java>
	</target>
	<target name="-check-ios-properties">
		<fail unless="ios.provision.path"/>
		<fail unless="ios.certificate.path"/>
		<fail unless="ios.certificate.password"/>
	</target>
	<target name="build-ios" depends="-check-ios-properties,build-air-swf">
		<echo message="Packaging PullToRefresh.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="ipa-app-store"/>
			<!-- uncomment for actionscript sampling with scout on ios -->
			<!--<arg value="-sampler"/>-->
			<arg value="-provisioning-profile"/>
			<arg value="${ios.provision.path}"/>
			<arg value="-keystore"/>
			<arg value="${ios.certificate.path}"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-storepass"/>
			<arg value="${ios.certificate.password}"/>
			<arg value="${output.path}/PullToRefresh.ipa"/>
			<arg value="source/PullToRefresh-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${launch.image.path}"/>
			<arg value="Default~iphone.png"/>							<!-- iphone 3gs -->
			<arg value="Default@2x~iphone.png"/>						<!-- iphone 4/4s -->
			<arg value="Default-568h@2x~iphone.png"/>					<!-- iphone 5/5c/5s -->
			<arg value="Default-375w-667h@2x~iphone.png"/>				<!-- iphone 6/7/8 -->
			<arg value="Default-812h@3x~iphone.png"/>					<!-- iphone x (portrait) -->
			<arg value="Default-Landscape-812h@3x~iphone.png"/>			<!-- iphone x (landscape) -->
			<arg value="Default-414w-736h@3x~iphone.png"/>				<!-- iphone 6/7/8 plus (portrait) -->
			<arg value="Default-Landscape-414w-736h@3x~iphone.png"/>	<!-- iphone 6/7/8 plus (landscape) -->
			<arg value="Default-Portrait~ipad.png"/>					<!-- ipad 1/2 (portrait) -->
			<arg value="Default-PortraitUpsideDown~ipad.png"/>			<!-- ipad 1/2 (portrait upside down) -->
			<arg value="Default-Landscape~ipad.png"/>					<!-- ipad 1/2 (landscape left) -->
			<arg value="Default-LandscapeRight~ipad.png"/>				<!-- ipad 1/2 (landscape right) -->
			<arg value="Default-Portrait@2x~ipad.png"/>					<!-- ipad 3/air (portrait) -->
			<arg value="Default-LandscapeLeft@2x~ipad.png"/>			<!-- ipad 3/air (landscape left) -->
			<arg value="Default-LandscapeRight@2x~ipad.png"/>			<!-- ipad 3/air (landscape right) -->
			<arg value="Default-Portrait@2x.png"/>						<!-- ipad pro (portrait) -->
			<arg value="Default-Landscape@2x.png"/>						<!-- ipad pro (landscape) -->
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="PullToRefresh.swf"/>
		</java>
	</target>
	<target name="-check-android-properties">
		<fail unless="android.certificate.path"/>
		<fail unless="android.certificate.password"/>
	</target>
	<target name="build-android" depends="-check-android-properties,build-air-swf">
		<echo message="Packaging PullToRefresh.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="apk-captive-runtime"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-keystore"/>
			<arg value="${android.certificate.path}"/>
			<arg value="-storepass"/>
			<arg value="${android.certificate.password}"/>
			<arg value="${output.path}/PullToRefresh.apk"/>
			<arg value="source/PullToRefresh-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="PullToRefresh.swf"/>
		</java>
	</target>
	<target name="install-android">
		<echo message="Installing PullToRefresh.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.PullToRefresh"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-package"/>
			<arg value="${output.path}/PullToRefresh.apk"/>
		</java>
	</target>
	<target name="install-ios">
		<echo message="Installing PullToRefresh.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.PullToRefresh"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-package"/>
			<arg value="${output.path}/PullToRefresh.ipa"/>
		</java>
	</target>
</project>

================================================
FILE: examples/PullToRefresh/source/PullToRefresh-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.examples.PullToRefresh</id>
	<filename>PullToRefresh</filename>
	<name>Pull to Refresh</name>
	<versionNumber>4.2.0</versionNumber>
	<description>Pull to Refresh example application built with Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>PullToRefresh.swf</content>
		<autoOrients>true</autoOrients>
		<fullScreen>false</fullScreen>
		<visible>true</visible>
		<renderMode>direct</renderMode>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>

	<icon>
		<image29x29>icon29.png</image29x29>
		<image48x48>icon48.png</image48x48>
		<image50x50>icon50.png</image50x50>
		<image57x57>icon57.png</image57x57>
		<image58x58>icon58.png</image58x58>
		<image72x72>icon72.png</image72x72>
		<image87x87>icon87.png</image87x87>
		<image96x96>icon96.png</image96x96>
		<image100x100>icon100.png</image100x100>
		<image114x114>icon114.png</image114x114>
		<image128x128>icon128.png</image128x128>
		<image144x144>icon144.png</image144x144>
		<image180x180>icon180.png</image180x180>
	</icon>
	<android>
		<colorDepth>16bit</colorDepth>
		<manifestAdditions><![CDATA[
			<manifest android:installLocation="auto">
			    <uses-permission android:name="android.permission.INTERNET"/>
			</manifest>
		]]></manifestAdditions>
	</android>
	<iPhone>
		<InfoAdditions>
		<![CDATA[
			<key>UIDeviceFamily</key> 
			<array> 
				<string>1</string>
				<string>2</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<true/>
			<key>UIStatusBarStyle</key>
			<string>UIStatusBarStyleLightContent</string>
			<key>NSAppTransportSecurity</key>
			<dict>
				<key>NSAllowsArbitraryLoads</key>
				<true/>
			</dict>
		]]> 
		</InfoAdditions>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</iPhone>
</application>

================================================
FILE: examples/PullToRefresh/source/PullToRefresh.as
================================================
package
{
	import feathers.examples.pullToRefresh.Main;
	import feathers.utils.ScreenDensityScaleFactorManager;

	import flash.display.Loader;
	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageOrientation;
	import flash.display.StageScaleMode;
	import flash.display3D.Context3DProfile;
	import flash.display3D.Context3DRenderMode;
	import flash.events.Event;
	import flash.filesystem.File;
	import flash.filesystem.FileMode;
	import flash.filesystem.FileStream;
	import flash.system.Capabilities;
	import flash.utils.ByteArray;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class PullToRefresh extends Sprite
	{
		public function PullToRefresh()
		{
			if(this.stage)
			{
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
				this.stage.align = StageAlign.TOP_LEFT;
			}
			this.mouseEnabled = this.mouseChildren = false;
			this.showLaunchImage();
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;
		private var _scaler:ScreenDensityScaleFactorManager;
		private var _launchImage:Loader;
		private var _savedAutoOrients:Boolean;

		/**
		 * On iOS, add the native launch image to the classic display list to
		 * avoid displaying only the stage background color between when the
		 * AIR app finishes launching and Starling starts rendering.
		 * 
		 * Launch image names: https://forums.adobe.com/message/9986239#9986239
		 */
		private function showLaunchImage():void
		{
			var filePath:String = null;
			var isPortraitOnly:Boolean = false;
			if(Capabilities.manufacturer.indexOf("iOS") >= 0)
			{
				var isPortraitUpsideDown:Boolean = this.stage.orientation == StageOrientation.UPSIDE_DOWN;
				var isPortrait:Boolean = this.stage.orientation == StageOrientation.DEFAULT || isPortraitUpsideDown;
				var isLandscapeRight:Boolean = this.stage.orientation == StageOrientation.ROTATED_RIGHT;
				if(Capabilities.screenResolutionX == 1242 && Capabilities.screenResolutionY == 2208)
				{
					//iphone 6/7/8 plus
					filePath = isPortrait ? "Default-414w-736h@3x~iphone.png" : "Default-Landscape-414w-736h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 1125 && Capabilities.screenResolutionY == 2436)
				{
					//iphone x
					filePath = isPortrait ? "Default-812h@3x~iphone.png" : "Default-Landscape-812h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 2048 && Capabilities.screenResolutionY == 2732)
				{
					//ipad pro
					filePath = isPortrait ? "Default-Portrait@2x.png" : "Default-Landscape@2x.png";
				}
				else if(Capabilities.screenResolutionX == 1536 && Capabilities.screenResolutionY == 2048)
				{
					//ipad 3/air
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait@2x~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown@2x~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight@2x~ipad.png";
					}
					else
					{
						filePath = "Default-LandscapeLeft@2x~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 768 && Capabilities.screenResolutionY == 1024)
				{
					//ipad 1/2
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight~ipad.png";
					}
					else
					{
						filePath = "Default-Landscape~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 750)
				{
					//iphone 6/7/8
					isPortraitOnly = true;
					filePath = "Default-375w-667h@2x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 640)
				{
					isPortraitOnly = true;
					if(Capabilities.screenResolutionY == 1136)
					{
						//iphone 5/5c/5s
						filePath = "Default-568h@2x~iphone.png";
					}
					else
					{
						//iphone 4/4s
						filePath = "Default@2x~iphone.png";
					}
				}
				else if(Capabilities.screenResolutionX == 320)
				{
					//iphone 3gs
					isPortraitOnly = true;
					filePath = "Default~iphone.png";
				}
			}

			if(filePath)
			{
				var file:File = File.applicationDirectory.resolvePath(filePath);
				if(file.exists)
				{
					var bytes:ByteArray = new ByteArray();
					var stream:FileStream = new FileStream();
					stream.open(file, FileMode.READ);
					stream.readBytes(bytes, 0, stream.bytesAvailable);
					stream.close();
					this._launchImage = new Loader();
					this._launchImage.loadBytes(bytes);
					this.addChild(this._launchImage);
					this._savedAutoOrients = this.stage.autoOrients;
					this.stage.autoOrients = false;
					if(isPortraitOnly)
					{
						this.stage.setOrientation(StageOrientation.DEFAULT);
					}
				}
			}
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(Main, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE);
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.start();
			if(this._launchImage)
			{
				this._starling.addEventListener("rootCreated", starling_rootCreatedHandler);
			}
			this._scaler = new ScreenDensityScaleFactorManager(this._starling);
			this.stage.addEventListener(Event.DEACTIVATE, stage_deactivateHandler, false, 0, true);
		}

		private function starling_rootCreatedHandler(event:Object):void
		{
			if(this._launchImage)
			{
				this.removeChild(this._launchImage);
				this._launchImage.unloadAndStop(true);
				this._launchImage = null;
				this.stage.autoOrients = this._savedAutoOrients;
			}
		}

		private function stage_deactivateHandler(event:Event):void
		{
			this._starling.stop(true);
			this.stage.addEventListener(Event.ACTIVATE, stage_activateHandler, false, 0, true);
		}

		private function stage_activateHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.ACTIVATE, stage_activateHandler);
			this._starling.start();
		}

	}
}

================================================
FILE: examples/PullToRefresh/source/PullToRefreshWeb.as
================================================
package
{
	import feathers.system.DeviceCapabilities;

	import flash.display.MovieClip;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.events.Event;
	import flash.geom.Rectangle;
	import flash.ui.ContextMenu;
	import flash.utils.getDefinitionByName;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class PullToRefreshWeb extends MovieClip
	{
		public function PullToRefreshWeb()
		{
			var menu:ContextMenu = new ContextMenu();
			menu.hideBuiltInItems();
			this.contextMenu = menu;
			
			if(this.stage)
			{
				this.stage.align = StageAlign.TOP_LEFT;
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
			}
			
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}
		
		private var _starling:Starling;
		
		private function start():void
		{
			this.gotoAndStop(2);
			this.graphics.clear();
			
			//simulating iPhone Retina
			DeviceCapabilities.dpi = 326;
			
			Starling.multitouchEnabled = true;
			var MainType:Class = getDefinitionByName("feathers.examples.pullToRefresh.Main") as Class;
			this._starling = new Starling(MainType, this.stage, new Rectangle(0, 0, 960, 640));
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.stage.stageWidth = 480;
			this._starling.stage.stageHeight = 320;
			this._starling.start();
		}
		
		private function loaderInfo_completeHandler(event:Event):void
		{
			this.start();
		}
	}
}

================================================
FILE: examples/PullToRefresh/source/feathers/examples/pullToRefresh/Main.as
================================================
package feathers.examples.pullToRefresh
{
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.data.ArrayCollection;
	import feathers.data.IListCollection;
	import feathers.events.FeathersEventType;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.themes.MetalWorksMobileTheme;

	import flash.events.TimerEvent;
	import flash.utils.Timer;

	import starling.core.Starling;
	import starling.display.MovieClip;
	import starling.events.Event;
	import starling.textures.Texture;
	import starling.textures.TextureAtlas;

	public class Main extends PanelScreen
	{
		[Embed(source="/../assets/images/spinner.png")]
		private static const SPINNER_ATLAS_IMAGE_EMBEDDED:Class;

		[Embed(source="/../assets/images/spinner.xml",mimeType="application/octet-stream")]
		private static const SPINNER_ATLAS_XML_EMBEDDED:Class;

		public function Main()
		{
			new MetalWorksMobileTheme();
		}

		private var _list:List;
		private var _pullView:MovieClip;
		private var _timer:Timer;
		private var _nextItemIndex:int = 1;

		override protected function initialize():void
		{
			super.initialize(); //don't forget this!

			this.title = "Pull to Refresh";

			this.layout = new AnchorLayout();

			//any Starling display object may be used as a pull view.
			//we'll use an animated MovieClip in this example.
			var texture:Texture = Texture.fromEmbeddedAsset(SPINNER_ATLAS_IMAGE_EMBEDDED, false, false, 2);
			var atlas:TextureAtlas = new TextureAtlas(texture, XML(new SPINNER_ATLAS_XML_EMBEDDED()));
			this._pullView = new MovieClip(atlas.getTextures());

			//FeathersEventType.PULLING will be dispatched on the pull view as
			//it is pulled down so that we can change its appearance. 
			this._pullView.addEventListener(FeathersEventType.PULLING, pullView_pullingHandler);

			this._list = new List();

			//pull views may appear on any of the four sides.
			//we'll put one on the top.
			this._list.topPullView = this._pullView;

			//when the user pulls the topPullView down by its full height then
			//releases, the list will dispatch Event.UPDATE
			this._list.addEventListener(Event.UPDATE, list_updateHandler);

			this._list.dataProvider = new ArrayCollection();
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this.addChild(this._list);

			this.loadData();
		}

		private function loadData():void
		{
			if(this._timer)
			{
				//if we're already loading data, cancel it
				this._timer.stop();
				this._timer.removeEventListener(TimerEvent.TIMER_COMPLETE, timerCompleteHandler);
				this._timer = null;
			}

			//if we aren't showing the pull view (such as the first time we load
			//the data), we can force it to display
			this._list.isTopPullViewActive = true;

			//start the pull view animation
			Starling.juggler.add(this._pullView);

			//we're not going to load real data for this example. we'll just
			//wait a couple of seconds and generate some new items dynamically.
			//using an AssetManager or URLLoader would look pretty similar.
			this._timer = new Timer(2000, 1);
			this._timer.addEventListener(TimerEvent.TIMER_COMPLETE, timerCompleteHandler);
			this._timer.start();
		}

		private function timerCompleteHandler(event:TimerEvent):void
		{
			this._timer.removeEventListener(TimerEvent.TIMER_COMPLETE, timerCompleteHandler);
			this._timer = null;

			var collection:IListCollection = this._list.dataProvider;
			//we don't need to remove all of the old items. we could simply add
			//the new ones to the beginning instead.
			//if not removing all items, be aware that the new data might
			//contain duplicate items, depending on how it was loaded, so it's
			//a good idea to check if an item already exists in the collection
			//before adding it. 
			collection.removeAll();
			for(var i:int = 0; i < 25; i++)
			{
				var newItem:Object = { label: "Item " + this._nextItemIndex };
				collection.unshift(newItem);
				this._nextItemIndex++;
			}

			//when the data has finished loading, tell the list to deactivate
			//its pull view:
			this._list.isTopPullViewActive = false;

			//and stop the pull view animation
			Starling.juggler.remove(this._pullView);
		}

		private function pullView_pullingHandler(event:Event, ratio:Number):void
		{
			var totalFrames:int = this._pullView.numFrames;

			//to provide some extra feedback to the user while they're pulling,
			//change the currentFrame of the MovieClip based on how far they've
			//pulled
			var frameIndex:int = Math.round(ratio * totalFrames);

			//the ratio could be greater than 1, which could result in a frame
			//index greater than the number of frames in the MovieClip
			while(frameIndex >= totalFrames)
			{
				frameIndex -= totalFrames;
			}
			this._pullView.currentFrame = frameIndex;
		}

		private function list_updateHandler(event:Event):void
		{
			//load the new data when the List dispatches Event.UPDATE
			this.loadData();
		}
	}
}


================================================
FILE: examples/StackScreenNavigatorExplorer/README.md
================================================
# Feathers StackScreenNavigator Explorer

Demonstrates how to navigate between screens using the [Feathers](http://feathersui.com/) `StackScreenNavigator` component, presented as a mobile app.

## Requirements

In addition to Starling Framework and Feathers, this example project requires the `MetalWorksMobileTheme` example theme. You can find the SWC file for this theme at the following location in the Feathers release build:

	themes/MetalWorksMobileTheme/swc/MetalWorksMobileTheme.swc

## Web Demo

View the [StackScreenNavigator Explorer](http://feathersui.com/examples/stack-screen-navigator-explorer/) in your browser.

================================================
FILE: examples/StackScreenNavigatorExplorer/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
theme.root = ${basedir}/../../themes/MetalWorksMobileTheme/source
output.path = ${basedir}/output
icon.path = ${basedir}/../shared-assets/icons
launch.image.path = ${basedir}/../shared-assets/launch-images-windowed

swf.version = 30

================================================
FILE: examples/StackScreenNavigatorExplorer/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="stack-screen-navigator-explorer" default="build" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<target name="build" depends="build-web,build-android,build-ios"/>

	<target name="prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="build-web" depends="prepare">
		<echo message="Building StackScreenNavigatorExplorerWeb.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-advanced-telemetry=true"/>
			<arg value="-frame=two,feathers.examples.navigator.Main"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/StackScreenNavigatorExplorerWeb.as"/>
			<arg value="-output=${output.path}/StackScreenNavigatorExplorerWeb.swf"/>
		</java>
	</target>
	<target name="build-air-swf" depends="prepare">
		<echo message="Building StackScreenNavigatorExplorer.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<!-- uncomment for profiling with scout -->
			<!--<arg value="-advanced-telemetry=true"/>-->
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/StackScreenNavigatorExplorer.as"/>
			<arg value="-output=${output.path}/StackScreenNavigatorExplorer.swf"/>
		</java>
	</target>
	<target name="-check-ios-properties">
		<fail unless="ios.provision.path"/>
		<fail unless="ios.certificate.path"/>
		<fail unless="ios.certificate.password"/>
	</target>
	<target name="build-ios" depends="-check-ios-properties,build-air-swf">
		<echo message="Packaging StackScreenNavigatorExplorer.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="ipa-app-store"/>
			<!-- uncomment for actionscript sampling with scout on ios -->
			<!--<arg value="-sampler"/>-->
			<arg value="-provisioning-profile"/>
			<arg value="${ios.provision.path}"/>
			<arg value="-keystore"/>
			<arg value="${ios.certificate.path}"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-storepass"/>
			<arg value="${ios.certificate.password}"/>
			<arg value="${output.path}/StackScreenNavigatorExplorer.ipa"/>
			<arg value="source/StackScreenNavigatorExplorer-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${launch.image.path}"/>
			<arg value="Default~iphone.png"/>							<!-- iphone 3gs -->
			<arg value="Default@2x~iphone.png"/>						<!-- iphone 4/4s -->
			<arg value="Default-568h@2x~iphone.png"/>					<!-- iphone 5/5c/5s -->
			<arg value="Default-375w-667h@2x~iphone.png"/>				<!-- iphone 6/7/8 -->
			<arg value="Default-812h@3x~iphone.png"/>					<!-- iphone x (portrait) -->
			<arg value="Default-Landscape-812h@3x~iphone.png"/>			<!-- iphone x (landscape) -->
			<arg value="Default-414w-736h@3x~iphone.png"/>				<!-- iphone 6/7/8 plus (portrait) -->
			<arg value="Default-Landscape-414w-736h@3x~iphone.png"/>	<!-- iphone 6/7/8 plus (landscape) -->
			<arg value="Default-Portrait~ipad.png"/>					<!-- ipad 1/2 (portrait) -->
			<arg value="Default-PortraitUpsideDown~ipad.png"/>			<!-- ipad 1/2 (portrait upside down) -->
			<arg value="Default-Landscape~ipad.png"/>					<!-- ipad 1/2 (landscape left) -->
			<arg value="Default-LandscapeRight~ipad.png"/>				<!-- ipad 1/2 (landscape right) -->
			<arg value="Default-Portrait@2x~ipad.png"/>					<!-- ipad 3/air (portrait) -->
			<arg value="Default-LandscapeLeft@2x~ipad.png"/>			<!-- ipad 3/air (landscape left) -->
			<arg value="Default-LandscapeRight@2x~ipad.png"/>			<!-- ipad 3/air (landscape right) -->
			<arg value="Default-Portrait@2x.png"/>						<!-- ipad pro (portrait) -->
			<arg value="Default-Landscape@2x.png"/>						<!-- ipad pro (landscape) -->
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="StackScreenNavigatorExplorer.swf"/>
		</java>
	</target>
	<target name="-check-android-properties">
		<fail unless="android.certificate.path"/>
		<fail unless="android.certificate.password"/>
	</target>
	<target name="build-android" depends="-check-android-properties,build-air-swf">
		<echo message="Packaging StackScreenNavigatorExplorer.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="apk-captive-runtime"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-keystore"/>
			<arg value="${android.certificate.path}"/>
			<arg value="-storepass"/>
			<arg value="${android.certificate.password}"/>
			<arg value="${output.path}/StackScreenNavigatorExplorer.apk"/>
			<arg value="source/StackScreenNavigatorExplorer-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="StackScreenNavigatorExplorer.swf"/>
		</java>
	</target>
	<target name="install-android">
		<echo message="Installing StackScreenNavigatorExplorer.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.StackScreenNavigatorExplorer"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-package"/>
			<arg value="${output.path}/StackScreenNavigatorExplorer.apk"/>
		</java>
	</target>
	<target name="install-ios">
		<echo message="Installing StackScreenNavigatorExplorer.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.StackScreenNavigatorExplorer"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-package"/>
			<arg value="${output.path}/StackScreenNavigatorExplorer.ipa"/>
		</java>
	</target>
</project>

================================================
FILE: examples/StackScreenNavigatorExplorer/source/StackScreenNavigatorExplorer-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.examples.StackScreenNavigatorExplorer</id>
	<filename>StackScreenNavigator</filename>
	<name>StackScreenNavigator</name>
	<versionNumber>4.2.0</versionNumber>
	<description>StackScreenNavigator Explorer example application built with Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>StackScreenNavigatorExplorer.swf</content>
		<autoOrients>true</autoOrients>
		<fullScreen>false</fullScreen>
		<visible>true</visible>
		<renderMode>direct</renderMode>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>

	<icon>
		<image29x29>icon29.png</image29x29>
		<image48x48>icon48.png</image48x48>
		<image50x50>icon50.png</image50x50>
		<image57x57>icon57.png</image57x57>
		<image58x58>icon58.png</image58x58>
		<image72x72>icon72.png</image72x72>
		<image87x87>icon87.png</image87x87>
		<image96x96>icon96.png</image96x96>
		<image100x100>icon100.png</image100x100>
		<image114x114>icon114.png</image114x114>
		<image128x128>icon128.png</image128x128>
		<image144x144>icon144.png</image144x144>
		<image180x180>icon180.png</image180x180>
	</icon>
	<android>
		<colorDepth>16bit</colorDepth>
		<manifestAdditions><![CDATA[
			<manifest android:installLocation="auto">
			    <uses-permission android:name="android.permission.INTERNET"/>
			</manifest>
		]]></manifestAdditions>
	</android>
	<iPhone>
		<InfoAdditions>
		<![CDATA[
			<key>UIDeviceFamily</key> 
			<array> 
				<string>1</string>
				<string>2</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<true/>
			<key>UIStatusBarStyle</key>
			<string>UIStatusBarStyleLightContent</string>
		]]> 
		</InfoAdditions>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</iPhone>
</application>

================================================
FILE: examples/StackScreenNavigatorExplorer/source/StackScreenNavigatorExplorer.as
================================================
package
{
	import feathers.examples.navigator.Main;
	import feathers.utils.ScreenDensityScaleFactorManager;

	import flash.display.Loader;
	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageOrientation;
	import flash.display.StageScaleMode;
	import flash.display3D.Context3DProfile;
	import flash.display3D.Context3DRenderMode;
	import flash.events.Event;
	import flash.filesystem.File;
	import flash.filesystem.FileMode;
	import flash.filesystem.FileStream;
	import flash.system.Capabilities;
	import flash.utils.ByteArray;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class StackScreenNavigatorExplorer extends Sprite
	{
		public function StackScreenNavigatorExplorer()
		{
			if(this.stage)
			{
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
				this.stage.align = StageAlign.TOP_LEFT;
			}
			this.mouseEnabled = this.mouseChildren = false;
			this.showLaunchImage();
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;
		private var _scaler:ScreenDensityScaleFactorManager;
		private var _launchImage:Loader;
		private var _savedAutoOrients:Boolean;

		/**
		 * On iOS, add the native launch image to the classic display list to
		 * avoid displaying only the stage background color between when the
		 * AIR app finishes launching and Starling starts rendering.
		 * 
		 * Launch image names: https://forums.adobe.com/message/9986239#9986239
		 */
		private function showLaunchImage():void
		{
			var filePath:String = null;
			var isPortraitOnly:Boolean = false;
			if(Capabilities.manufacturer.indexOf("iOS") >= 0)
			{
				var isPortraitUpsideDown:Boolean = this.stage.orientation == StageOrientation.UPSIDE_DOWN;
				var isPortrait:Boolean = this.stage.orientation == StageOrientation.DEFAULT || isPortraitUpsideDown;
				var isLandscapeRight:Boolean = this.stage.orientation == StageOrientation.ROTATED_RIGHT;
				if(Capabilities.screenResolutionX == 1242 && Capabilities.screenResolutionY == 2208)
				{
					//iphone 6/7/8 plus
					filePath = isPortrait ? "Default-414w-736h@3x~iphone.png" : "Default-Landscape-414w-736h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 1125 && Capabilities.screenResolutionY == 2436)
				{
					//iphone x
					filePath = isPortrait ? "Default-812h@3x~iphone.png" : "Default-Landscape-812h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 2048 && Capabilities.screenResolutionY == 2732)
				{
					//ipad pro
					filePath = isPortrait ? "Default-Portrait@2x.png" : "Default-Landscape@2x.png";
				}
				else if(Capabilities.screenResolutionX == 1536 && Capabilities.screenResolutionY == 2048)
				{
					//ipad 3/air
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait@2x~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown@2x~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight@2x~ipad.png";
					}
					else
					{
						filePath = "Default-LandscapeLeft@2x~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 768 && Capabilities.screenResolutionY == 1024)
				{
					//ipad 1/2
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight~ipad.png";
					}
					else
					{
						filePath = "Default-Landscape~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 750)
				{
					//iphone 6/7/8
					isPortraitOnly = true;
					filePath = "Default-375w-667h@2x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 640)
				{
					isPortraitOnly = true;
					if(Capabilities.screenResolutionY == 1136)
					{
						//iphone 5/5c/5s
						filePath = "Default-568h@2x~iphone.png";
					}
					else
					{
						//iphone 4/4s
						filePath = "Default@2x~iphone.png";
					}
				}
				else if(Capabilities.screenResolutionX == 320)
				{
					//iphone 3gs
					isPortraitOnly = true;
					filePath = "Default~iphone.png";
				}
			}

			if(filePath)
			{
				var file:File = File.applicationDirectory.resolvePath(filePath);
				if(file.exists)
				{
					var bytes:ByteArray = new ByteArray();
					var stream:FileStream = new FileStream();
					stream.open(file, FileMode.READ);
					stream.readBytes(bytes, 0, stream.bytesAvailable);
					stream.close();
					this._launchImage = new Loader();
					this._launchImage.loadBytes(bytes);
					this.addChild(this._launchImage);
					this._savedAutoOrients = this.stage.autoOrients;
					this.stage.autoOrients = false;
					if(isPortraitOnly)
					{
						this.stage.setOrientation(StageOrientation.DEFAULT);
					}
				}
			}
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(Main, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE);
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.start();
			if(this._launchImage)
			{
				this._starling.addEventListener("rootCreated", starling_rootCreatedHandler);
			}
			this._scaler = new ScreenDensityScaleFactorManager(this._starling);
			this.stage.addEventListener(Event.DEACTIVATE, stage_deactivateHandler, false, 0, true);
		}

		private function starling_rootCreatedHandler(event:Object):void
		{
			if(this._launchImage)
			{
				this.removeChild(this._launchImage);
				this._launchImage.unloadAndStop(true);
				this._launchImage = null;
				this.stage.autoOrients = this._savedAutoOrients;
			}
		}

		private function stage_deactivateHandler(event:Event):void
		{
			this._starling.stop(true);
			this.stage.addEventListener(Event.ACTIVATE, stage_activateHandler, false, 0, true);
		}

		private function stage_activateHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.ACTIVATE, stage_activateHandler);
			this._starling.start();
		}

	}
}

================================================
FILE: examples/StackScreenNavigatorExplorer/source/StackScreenNavigatorExplorerWeb.as
================================================
package
{
	import feathers.system.DeviceCapabilities;

	import flash.display.MovieClip;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.events.Event;
	import flash.geom.Rectangle;
	import flash.ui.ContextMenu;
	import flash.utils.getDefinitionByName;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class StackScreenNavigatorExplorerWeb extends MovieClip
	{
		public function StackScreenNavigatorExplorerWeb()
		{
			var menu:ContextMenu = new ContextMenu();
			menu.hideBuiltInItems();
			this.contextMenu = menu;
			
			if(this.stage)
			{
				this.stage.align = StageAlign.TOP_LEFT;
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
			}
			
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}
		
		private var _starling:Starling;
		
		private function start():void
		{
			this.gotoAndStop(2);
			this.graphics.clear();
			
			//simulating iPhone Retina
			DeviceCapabilities.dpi = 326;
			
			Starling.multitouchEnabled = true;
			var MainType:Class = getDefinitionByName("feathers.examples.navigator.Main") as Class;
			this._starling = new Starling(MainType, this.stage, new Rectangle(0, 0, 960, 640));
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.stage.stageWidth = 480;
			this._starling.stage.stageHeight = 320;
			this._starling.start();
		}
		
		private function loaderInfo_completeHandler(event:Event):void
		{
			this.start();
		}
	}
}

================================================
FILE: examples/StackScreenNavigatorExplorer/source/feathers/examples/navigator/Main.as
================================================
package feathers.examples.navigator
{
	import feathers.controls.LayoutGroup;
	import feathers.controls.StackScreenNavigator;
	import feathers.controls.StackScreenNavigatorItem;
	import feathers.examples.navigator.screens.ScreenA;
	import feathers.examples.navigator.screens.ScreenB1;
	import feathers.examples.navigator.screens.ScreenB2;
	import feathers.examples.navigator.screens.ScreenC;
	import feathers.motion.Fade;
	import feathers.motion.Slide;
	import feathers.themes.MetalWorksMobileTheme;

	import starling.events.Event;

	public class Main extends LayoutGroup
	{
		private static const SCREEN_A:String = "a";
		private static const SCREEN_B1:String = "b1";
		private static const SCREEN_B2:String = "b2";
		private static const SCREEN_C:String = "c";

		public function Main()
		{
			new MetalWorksMobileTheme();
			super();
		}

		private var _navigator:StackScreenNavigator;

		override protected function initialize():void
		{
			this._navigator = new StackScreenNavigator();
			this._navigator.pushTransition = Slide.createSlideLeftTransition();
			this._navigator.popTransition = Slide.createSlideRightTransition();

			var itemA:StackScreenNavigatorItem = new StackScreenNavigatorItem(ScreenA);
			itemA.setScreenIDForPushEvent(Event.COMPLETE, SCREEN_B1);
			this._navigator.addScreen(SCREEN_A, itemA);

			var itemB1:StackScreenNavigatorItem = new StackScreenNavigatorItem(ScreenB1);
			itemB1.setScreenIDForPushEvent(Event.COMPLETE, SCREEN_C);
			itemB1.setScreenIDForReplaceEvent(Event.CHANGE, SCREEN_B2);
			itemB1.addPopEvent(Event.CANCEL);
			this._navigator.addScreen(SCREEN_B1, itemB1);

			var itemB2:StackScreenNavigatorItem = new StackScreenNavigatorItem(ScreenB2);
			itemB2.pushTransition = Fade.createFadeInTransition();
			itemB2.addPopEvent(Event.CANCEL);
			this._navigator.addScreen(SCREEN_B2, itemB2);

			var itemC:StackScreenNavigatorItem = new StackScreenNavigatorItem(ScreenC);
			itemC.addPopToRootEvent(Event.CLOSE);
			itemC.addPopEvent(Event.CANCEL);
			this._navigator.addScreen(SCREEN_C, itemC);

			this._navigator.rootScreenID = SCREEN_A;
			this.addChild(this._navigator);
		}
	}
}


================================================
FILE: examples/StackScreenNavigatorExplorer/source/feathers/examples/navigator/screens/ScreenA.as
================================================
package feathers.examples.navigator.screens
{
	import feathers.controls.Button;
	import feathers.controls.PanelScreen;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.layout.VerticalLayoutData;

	import starling.events.Event;

	/**
	 * Pushes another screen onto the stack. An event is mapped to the push
	 * action by calling setScreenIDForPushEvent() on the
	 * StackScreenNavigatorItem.
	 *
	 * item.setScreenIDForPushEvent(Event.COMPLETE, otherScreenID);
	 */
	[Event(name="complete",type="starling.events.Event")]

	public class ScreenA extends PanelScreen
	{
		public function ScreenA()
		{
			super();
			this.title = "Screen A";
		}

		override protected function initialize():void
		{
			super.initialize();

			var layout:VerticalLayout = new VerticalLayout();
			layout.horizontalAlign = HorizontalAlign.CENTER;
			layout.verticalAlign = VerticalAlign.MIDDLE;
			layout.gap = 10;
			this.layout = layout;

			var pushB1Button:Button = new Button();
			pushB1Button.label = "Push Screen B1";
			pushB1Button.layoutData = new VerticalLayoutData(50);
			pushB1Button.addEventListener(Event.TRIGGERED, pushB1Button_triggeredHandler);
			this.addChild(pushB1Button);
		}

		protected function pushB1Button_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}
	}
}


================================================
FILE: examples/StackScreenNavigatorExplorer/source/feathers/examples/navigator/screens/ScreenB1.as
================================================
package feathers.examples.navigator.screens
{
	import feathers.controls.Button;
	import feathers.controls.PanelScreen;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.layout.VerticalLayoutData;

	import starling.events.Event;

	/**
	 * Pops this screen from the stack to return to the previous screen. An
	 * event is mapped to the pop action by calling addPopEvent() on the
	 * StackScreenNavigatorItem.
	 *
	 * item.addPopEvent(Event.CANCEL);
	 */
	[Event(name="cancel",type="starling.events.Event")]

	/**
	 * Replaces this screen with another screen at the same position in the
	 * stack. An event is mapped to the replace action by calling
	 * setScreenIDForReplaceEvent() on the StackScreenNavigatorItem.
	 *
	 * item.setScreenIDForReplaceEvent(Event.CHANGE, otherScreenID);
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Pushes another screen onto the stack. An event is mapped to the push
	 * action by calling setScreenIDForPushEvent() on the
	 * StackScreenNavigatorItem.
	 *
	 * item.setScreenIDForPushEvent(Event.COMPLETE, otherScreenID);
	 */
	[Event(name="complete",type="starling.events.Event")]

	public class ScreenB1 extends PanelScreen
	{
		public function ScreenB1()
		{
			super();
			this.title = "Screen B1";
		}

		override protected function initialize():void
		{
			super.initialize();

			var layout:VerticalLayout = new VerticalLayout();
			layout.horizontalAlign = HorizontalAlign.CENTER;
			layout.verticalAlign = VerticalAlign.MIDDLE;
			layout.gap = 10;
			this.layout = layout;

			var popToAButton:Button = new Button();
			popToAButton.label = "Pop to Screen A";
			popToAButton.layoutData = new VerticalLayoutData(50);
			popToAButton.addEventListener(Event.TRIGGERED, popToAButton_triggeredHandler);
			this.addChild(popToAButton);

			var pushCButton:Button = new Button();
			pushCButton.label = "Push Screen C";
			pushCButton.layoutData = new VerticalLayoutData(50);
			pushCButton.addEventListener(Event.TRIGGERED, pushCButton_triggeredHandler);
			this.addChild(pushCButton);

			var replaceWithB2Button:Button = new Button();
			replaceWithB2Button.label = "Replace With Screen B2";
			replaceWithB2Button.layoutData = new VerticalLayoutData(50);
			replaceWithB2Button.addEventListener(Event.TRIGGERED, replaceWithB2Button_triggeredHandler);
			this.addChild(replaceWithB2Button);
		}

		protected function popToAButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(Event.CANCEL);
		}

		protected function pushCButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		protected function replaceWithB2Button_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(Event.CHANGE);
		}
	}
}


================================================
FILE: examples/StackScreenNavigatorExplorer/source/feathers/examples/navigator/screens/ScreenB2.as
================================================
package feathers.examples.navigator.screens
{
	import feathers.controls.Button;
	import feathers.controls.PanelScreen;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.layout.VerticalLayoutData;

	import starling.events.Event;

	/**
	 * Pops this screen from the stack to return to the previous screen. An
	 * event is mapped to the pop action by calling addPopEvent() on the
	 * StackScreenNavigatorItem.
	 *
	 * item.addPopEvent(Event.CANCEL);
	 */
	[Event(name="cancel",type="starling.events.Event")]

	public class ScreenB2 extends PanelScreen
	{
		public function ScreenB2()
		{
			super();
			this.title = "Screen B2";
		}

		override protected function initialize():void
		{
			super.initialize();

			var layout:VerticalLayout = new VerticalLayout();
			layout.horizontalAlign = HorizontalAlign.CENTER;
			layout.verticalAlign = VerticalAlign.MIDDLE;
			layout.gap = 10;
			this.layout = layout;

			var popToAButton:Button = new Button();
			popToAButton.label = "Pop to Screen A";
			popToAButton.layoutData = new VerticalLayoutData(50);
			popToAButton.addEventListener(Event.TRIGGERED, popToAButton_triggeredHandler);
			this.addChild(popToAButton);
		}

		protected function popToAButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(Event.CANCEL);
		}
	}
}


================================================
FILE: examples/StackScreenNavigatorExplorer/source/feathers/examples/navigator/screens/ScreenC.as
================================================
package feathers.examples.navigator.screens
{
	import feathers.controls.Button;
	import feathers.controls.PanelScreen;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.layout.VerticalLayoutData;

	import starling.events.Event;

	/**
	 * Pops all screens from the stack to return to the root screen. An event
	 * is mapped to the pop to root action by calling addPopToRootEvent() on the
	 * StackScreenNavigatorItem.
	 *
	 * item.addPopToRootEvent(Event.CLOSE);
	 */
	[Event(name="close",type="starling.events.Event")]

	/**
	 * Pops this screen from the stack to return to the previous screen. An
	 * event is mapped to the pop action by calling addPopEvent() on the
	 * StackScreenNavigatorItem.
	 *
	 * item.addPopEvent(Event.CANCEL);
	 */
	[Event(name="cancel",type="starling.events.Event")]

	public class ScreenC extends PanelScreen
	{
		public function ScreenC()
		{
			super();
			this.title = "Screen C";
		}

		override protected function initialize():void
		{
			super.initialize();

			var layout:VerticalLayout = new VerticalLayout();
			layout.horizontalAlign = HorizontalAlign.CENTER;
			layout.verticalAlign = VerticalAlign.MIDDLE;
			layout.gap = 10;
			this.layout = layout;

			var popToB1Button:Button = new Button();
			popToB1Button.label = "Pop to Screen B";
			popToB1Button.layoutData = new VerticalLayoutData(50);
			popToB1Button.addEventListener(Event.TRIGGERED, popToB1Button_triggeredHandler);
			this.addChild(popToB1Button);

			var popToRootButton:Button = new Button();
			popToRootButton.label = "Pop to Root";
			popToRootButton.layoutData = new VerticalLayoutData(50);
			popToRootButton.addEventListener(Event.TRIGGERED, popToRootButton_triggeredHandler);
			this.addChild(popToRootButton);
		}

		protected function popToB1Button_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(Event.CANCEL);
		}

		protected function popToRootButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(Event.CLOSE);
		}
	}
}


================================================
FILE: examples/Tabs/README.md
================================================
# Feathers Tabs

Demonstrates how to navigate between tabs using the [Feathers](http://feathersui.com/) `TabNavigator` component, presented as a mobile app.

## Requirements

In addition to Starling Framework and Feathers, this example project requires the `MetalWorksMobileTheme` example theme. You can find the SWC file for this theme at the following location in the Feathers release build:

	themes/MetalWorksMobileTheme/swc/MetalWorksMobileTheme.swc

## Web Demo

View the [Tabs example](http://feathersui.com/examples/tabs/) in your browser.

## Credits

User data randomly generated with [randomuser.me](https://randomuser.me/).

================================================
FILE: examples/Tabs/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
theme.root = ${basedir}/../../themes/MetalWorksMobileTheme/source
output.path = ${basedir}/output
icon.path = ${basedir}/../shared-assets/icons
launch.image.path = ${basedir}/../shared-assets/launch-images-windowed

swf.version = 30

================================================
FILE: examples/Tabs/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="tabs" default="build" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<target name="build" depends="build-web,build-android,build-ios"/>

	<target name="prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="build-web" depends="prepare">
		<echo message="Building TabsWeb.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-advanced-telemetry=true"/>
			<arg value="-frame=two,feathers.examples.tabs.Main"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/TabsWeb.as"/>
			<arg value="-output=${output.path}/TabsWeb.swf"/>
		</java>
	</target>
	<target name="build-air-swf" depends="prepare">
		<echo message="Building Tabs.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<!-- uncomment for profiling with scout -->
			<!--<arg value="-advanced-telemetry=true"/>-->
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/Tabs.as"/>
			<arg value="-output=${output.path}/Tabs.swf"/>
		</java>
	</target>
	<target name="-check-ios-properties">
		<fail unless="ios.provision.path"/>
		<fail unless="ios.certificate.path"/>
		<fail unless="ios.certificate.password"/>
	</target>
	<target name="build-ios" depends="-check-ios-properties,build-air-swf">
		<echo message="Packaging Tabs.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="ipa-app-store"/>
			<!-- uncomment for actionscript sampling with scout on ios -->
			<!--<arg value="-sampler"/>-->
			<arg value="-provisioning-profile"/>
			<arg value="${ios.provision.path}"/>
			<arg value="-keystore"/>
			<arg value="${ios.certificate.path}"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-storepass"/>
			<arg value="${ios.certificate.password}"/>
			<arg value="${output.path}/Tabs.ipa"/>
			<arg value="source/Tabs-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${launch.image.path}"/>
			<arg value="Default~iphone.png"/>							<!-- iphone 3gs -->
			<arg value="Default@2x~iphone.png"/>						<!-- iphone 4/4s -->
			<arg value="Default-568h@2x~iphone.png"/>					<!-- iphone 5/5c/5s -->
			<arg value="Default-375w-667h@2x~iphone.png"/>				<!-- iphone 6/7/8 -->
			<arg value="Default-812h@3x~iphone.png"/>					<!-- iphone x (portrait) -->
			<arg value="Default-Landscape-812h@3x~iphone.png"/>			<!-- iphone x (landscape) -->
			<arg value="Default-414w-736h@3x~iphone.png"/>				<!-- iphone 6/7/8 plus (portrait) -->
			<arg value="Default-Landscape-414w-736h@3x~iphone.png"/>	<!-- iphone 6/7/8 plus (landscape) -->
			<arg value="Default-Portrait~ipad.png"/>					<!-- ipad 1/2 (portrait) -->
			<arg value="Default-PortraitUpsideDown~ipad.png"/>			<!-- ipad 1/2 (portrait upside down) -->
			<arg value="Default-Landscape~ipad.png"/>					<!-- ipad 1/2 (landscape left) -->
			<arg value="Default-LandscapeRight~ipad.png"/>				<!-- ipad 1/2 (landscape right) -->
			<arg value="Default-Portrait@2x~ipad.png"/>					<!-- ipad 3/air (portrait) -->
			<arg value="Default-LandscapeLeft@2x~ipad.png"/>			<!-- ipad 3/air (landscape left) -->
			<arg value="Default-LandscapeRight@2x~ipad.png"/>			<!-- ipad 3/air (landscape right) -->
			<arg value="Default-Portrait@2x.png"/>						<!-- ipad pro (portrait) -->
			<arg value="Default-Landscape@2x.png"/>						<!-- ipad pro (landscape) -->
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="Tabs.swf"/>
		</java>
	</target>
	<target name="-check-android-properties">
		<fail unless="android.certificate.path"/>
		<fail unless="android.certificate.password"/>
	</target>
	<target name="build-android" depends="-check-android-properties,build-air-swf">
		<echo message="Packaging Tabs.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="apk-captive-runtime"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-keystore"/>
			<arg value="${android.certificate.path}"/>
			<arg value="-storepass"/>
			<arg value="${android.certificate.password}"/>
			<arg value="${output.path}/Tabs.apk"/>
			<arg value="source/Tabs-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="Tabs.swf"/>
		</java>
	</target>
	<target name="install-android">
		<echo message="Installing Tabs.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.Tabs"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-package"/>
			<arg value="${output.path}/Tabs.apk"/>
		</java>
	</target>
	<target name="install-ios">
		<echo message="Installing Tabs.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.Tabs"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-package"/>
			<arg value="${output.path}/Tabs.ipa"/>
		</java>
	</target>
</project>

================================================
FILE: examples/Tabs/source/Tabs-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.examples.Tabs</id>
	<filename>Tabs</filename>
	<name>Tabs</name>
	<versionNumber>4.2.0</versionNumber>
	<description>Tabs example application built with Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>Tabs.swf</content>
		<autoOrients>true</autoOrients>
		<fullScreen>false</fullScreen>
		<visible>true</visible>
		<renderMode>direct</renderMode>
		<depthAndStencil>true</depthAndStencil>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>

	<icon>
		<image29x29>icon29.png</image29x29>
		<image48x48>icon48.png</image48x48>
		<image50x50>icon50.png</image50x50>
		<image57x57>icon57.png</image57x57>
		<image58x58>icon58.png</image58x58>
		<image72x72>icon72.png</image72x72>
		<image87x87>icon87.png</image87x87>
		<image96x96>icon96.png</image96x96>
		<image100x100>icon100.png</image100x100>
		<image114x114>icon114.png</image114x114>
		<image128x128>icon128.png</image128x128>
		<image144x144>icon144.png</image144x144>
		<image180x180>icon180.png</image180x180>
	</icon>
	<android>
		<colorDepth>16bit</colorDepth>
		<manifestAdditions><![CDATA[
			<manifest android:installLocation="auto">
			    <uses-permission android:name="android.permission.INTERNET"/>
			</manifest>
		]]></manifestAdditions>
	</android>
	<iPhone>
		<InfoAdditions>
		<![CDATA[
			<key>UIDeviceFamily</key> 
			<array> 
				<string>1</string>
				<string>2</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<true/>
			<key>UIStatusBarStyle</key>
			<string>UIStatusBarStyleLightContent</string>
			<key>NSAppTransportSecurity</key>
			<dict>
				<key>NSExceptionDomains</key>
				<dict>
					<key>feathersui.com</key>
					<dict>
						<key>NSTemporaryExceptionAllowsInsecureHTTPLoads</key>
						<true/>
					</dict>
				</dict>
			</dict>
		]]> 
		</InfoAdditions>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</iPhone>
</application>

================================================
FILE: examples/Tabs/source/Tabs.as
================================================
package
{
	import feathers.examples.tabs.Main;
	import feathers.utils.ScreenDensityScaleFactorManager;

	import flash.display.Loader;
	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageOrientation;
	import flash.display.StageScaleMode;
	import flash.display3D.Context3DProfile;
	import flash.display3D.Context3DRenderMode;
	import flash.events.Event;
	import flash.filesystem.File;
	import flash.filesystem.FileMode;
	import flash.filesystem.FileStream;
	import flash.system.Capabilities;
	import flash.utils.ByteArray;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class Tabs extends Sprite
	{
		public function Tabs()
		{
			if(this.stage)
			{
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
				this.stage.align = StageAlign.TOP_LEFT;
			}
			this.mouseEnabled = this.mouseChildren = false;
			this.showLaunchImage();
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;
		private var _scaler:ScreenDensityScaleFactorManager;
		private var _launchImage:Loader;
		private var _savedAutoOrients:Boolean;

		/**
		 * On iOS, add the native launch image to the classic display list to
		 * avoid displaying only the stage background color between when the
		 * AIR app finishes launching and Starling starts rendering.
		 * 
		 * Launch image names: https://forums.adobe.com/message/9986239#9986239
		 */
		private function showLaunchImage():void
		{
			var filePath:String = null;
			var isPortraitOnly:Boolean = false;
			if(Capabilities.manufacturer.indexOf("iOS") >= 0)
			{
				var isPortraitUpsideDown:Boolean = this.stage.orientation == StageOrientation.UPSIDE_DOWN;
				var isPortrait:Boolean = this.stage.orientation == StageOrientation.DEFAULT || isPortraitUpsideDown;
				var isLandscapeRight:Boolean = this.stage.orientation == StageOrientation.ROTATED_RIGHT;
				if(Capabilities.screenResolutionX == 1242 && Capabilities.screenResolutionY == 2208)
				{
					//iphone 6/7/8 plus
					filePath = isPortrait ? "Default-414w-736h@3x~iphone.png" : "Default-Landscape-414w-736h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 1125 && Capabilities.screenResolutionY == 2436)
				{
					//iphone x
					filePath = isPortrait ? "Default-812h@3x~iphone.png" : "Default-Landscape-812h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 2048 && Capabilities.screenResolutionY == 2732)
				{
					//ipad pro
					filePath = isPortrait ? "Default-Portrait@2x.png" : "Default-Landscape@2x.png";
				}
				else if(Capabilities.screenResolutionX == 1536 && Capabilities.screenResolutionY == 2048)
				{
					//ipad 3/air
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait@2x~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown@2x~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight@2x~ipad.png";
					}
					else
					{
						filePath = "Default-LandscapeLeft@2x~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 768 && Capabilities.screenResolutionY == 1024)
				{
					//ipad 1/2
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight~ipad.png";
					}
					else
					{
						filePath = "Default-Landscape~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 750)
				{
					//iphone 6/7/8
					isPortraitOnly = true;
					filePath = "Default-375w-667h@2x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 640)
				{
					isPortraitOnly = true;
					if(Capabilities.screenResolutionY == 1136)
					{
						//iphone 5/5c/5s
						filePath = "Default-568h@2x~iphone.png";
					}
					else
					{
						//iphone 4/4s
						filePath = "Default@2x~iphone.png";
					}
				}
				else if(Capabilities.screenResolutionX == 320)
				{
					//iphone 3gs
					isPortraitOnly = true;
					filePath = "Default~iphone.png";
				}
			}

			if(filePath)
			{
				var file:File = File.applicationDirectory.resolvePath(filePath);
				if(file.exists)
				{
					var bytes:ByteArray = new ByteArray();
					var stream:FileStream = new FileStream();
					stream.open(file, FileMode.READ);
					stream.readBytes(bytes, 0, stream.bytesAvailable);
					stream.close();
					this._launchImage = new Loader();
					this._launchImage.loadBytes(bytes);
					this.addChild(this._launchImage);
					this._savedAutoOrients = this.stage.autoOrients;
					this.stage.autoOrients = false;
					if(isPortraitOnly)
					{
						this.stage.setOrientation(StageOrientation.DEFAULT);
					}
				}
			}
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(Main, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE);
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.start();
			if(this._launchImage)
			{
				this._starling.addEventListener("rootCreated", starling_rootCreatedHandler);
			}
			this._scaler = new ScreenDensityScaleFactorManager(this._starling);
			this.stage.addEventListener(Event.DEACTIVATE, stage_deactivateHandler, false, 0, true);
		}

		private function starling_rootCreatedHandler(event:Object):void
		{
			if(this._launchImage)
			{
				this.removeChild(this._launchImage);
				this._launchImage.unloadAndStop(true);
				this._launchImage = null;
				this.stage.autoOrients = this._savedAutoOrients;
			}
		}

		private function stage_deactivateHandler(event:Event):void
		{
			this._starling.stop(true);
			this.stage.addEventListener(Event.ACTIVATE, stage_activateHandler, false, 0, true);
		}

		private function stage_activateHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.ACTIVATE, stage_activateHandler);
			this._starling.start();
		}

	}
}

================================================
FILE: examples/Tabs/source/TabsWeb.as
================================================
package
{
	import feathers.system.DeviceCapabilities;

	import flash.display.MovieClip;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.events.Event;
	import flash.geom.Rectangle;
	import flash.ui.ContextMenu;
	import flash.utils.getDefinitionByName;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class TabsWeb extends MovieClip
	{
		public function TabsWeb()
		{
			var menu:ContextMenu = new ContextMenu();
			menu.hideBuiltInItems();
			this.contextMenu = menu;
			
			if(this.stage)
			{
				this.stage.align = StageAlign.TOP_LEFT;
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
			}
			
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}
		
		private var _starling:Starling;
		
		private function start():void
		{
			this.gotoAndStop(2);
			this.graphics.clear();
			
			//simulating iPhone Retina
			DeviceCapabilities.dpi = 326;
			
			Starling.multitouchEnabled = true;
			var MainType:Class = getDefinitionByName("feathers.examples.tabs.Main") as Class;
			this._starling = new Starling(MainType, this.stage, new Rectangle(0, 0, 960, 640));
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.stage.stageWidth = 480;
			this._starling.stage.stageHeight = 320;
			this._starling.start();
		}
		
		private function loaderInfo_completeHandler(event:Event):void
		{
			this.start();
		}
	}
}

================================================
FILE: examples/Tabs/source/feathers/examples/tabs/Main.as
================================================
package feathers.examples.tabs
{
	import feathers.controls.TabNavigator;
	import feathers.controls.TabNavigatorItem;
	import feathers.examples.tabs.screens.ContactsScreen;
	import feathers.examples.tabs.screens.MessagesScreen;
	import feathers.examples.tabs.screens.ProfileScreen;
	import feathers.examples.tabs.themes.TabsTheme;

	import starling.display.Sprite;
	import starling.events.Event;

	public class Main extends Sprite
	{
		private static const MESSAGES:String = "messages";
		private static const CONTACTS:String = "contacts";
		private static const PROFILE:String = "profile";

		public function Main()
		{
			new TabsTheme();

			super();

			this.addEventListener(Event.ADDED_TO_STAGE, addedToStageHandler);
		}

		protected var navigator:TabNavigator;

		protected function addedToStageHandler(event:Event):void
		{
			this.navigator = new TabNavigator();
			this.addMessagesTab();
			this.addContactsTab();
			this.addProfileTab();
			this.addChild(this.navigator);
		}

		private function addMessagesTab():void
		{
			var screen:MessagesScreen = new MessagesScreen();
			var item:TabNavigatorItem = new TabNavigatorItem(screen, "Messages");
			this.navigator.addScreen(MESSAGES, item);
		}

		private function addContactsTab():void
		{
			var screen:ContactsScreen = new ContactsScreen();
			var item:TabNavigatorItem = new TabNavigatorItem(screen, "Contacts");
			this.navigator.addScreen(CONTACTS, item);
		}

		private function addProfileTab():void
		{
			var screen:ProfileScreen = new ProfileScreen();
			var item:TabNavigatorItem = new TabNavigatorItem(screen, "Profile");
			this.navigator.addScreen(PROFILE, item);
		}
	}
}


================================================
FILE: examples/Tabs/source/feathers/examples/tabs/screens/ContactsScreen.as
================================================
package feathers.examples.tabs.screens
{
	import feathers.controls.GroupedList;
	import feathers.controls.ImageLoader;
	import feathers.controls.PanelScreen;
	import feathers.controls.renderers.DefaultGroupedListItemRenderer;
	import feathers.controls.renderers.IGroupedListItemRenderer;
	import feathers.data.ArrayHierarchicalCollection;
	import feathers.examples.tabs.themes.StyleNames;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.utils.textures.TextureCache;

	public class ContactsScreen extends PanelScreen
	{
		public function ContactsScreen()
		{
			this.title = "Contacts";
		}

		private var _list:GroupedList;
		private var _cache:TextureCache;

		override public function dispose():void
		{
			if(this._cache !== null)
			{
				this._cache.dispose();
				this._cache = null;
			}
			super.dispose();
		}

		override protected function initialize():void
		{
			super.initialize();

			this._cache = new TextureCache(10);

			this.layout = new AnchorLayout();

			this._list = new GroupedList();
			this._list.isSelectable = false;
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.customItemRendererStyleName = StyleNames.MESSAGE_LIST_ITEM_RENDERER;
			this._list.itemRendererFactory = this.createContactItemRenderer;
			this.addChild(this._list);

			this._list.dataProvider = new ArrayHierarchicalCollection(
			[
				{
					header: "A",
					children:
					[
						{
							name: "Andy Johnston",
							email: "itsandy1981@example.com",
							photo: "http://feathersui.com/examples/tabs/images/men92.jpg"
						},
					]
				},
				{
					header: "D",
					children:
					[
						{
							name: "Denise Kim",
							email: "kim.denise@example.com",
							photo: "http://feathersui.com/examples/tabs/images/women83.jpg"
						},
						{
							name: "Dylan Curtis",
							email: "curtis1987@example.com",
							photo: "http://feathersui.com/examples/tabs/images/men87.jpg"
						},
					]
				},
				{
					header: "P",
					children: 
					[
						{
							name: "Pat Brewer",
							email: "pbrewer19@example.com",
							photo: "http://feathersui.com/examples/tabs/images/women79.jpg"
						},
						{
							name: "Pearl Boyd",
							email: "pearl.boyd@example.com",
							photo: "http://feathersui.com/examples/tabs/images/women69.jpg"
						},
					]
				},
				{
					header: "R",
					children:
					[
						{
							name: "Robin Taylor",
							email: "robintaylor@example.com",
							photo: "http://feathersui.com/examples/tabs/images/women89.jpg"
						},
					]
				},
				{
					header: "S",
					children:
					[
						{
							name: "Savannah Flores",
							email: "saflo79@example.com",
							photo: "http://feathersui.com/examples/tabs/images/women53.jpg"
						},
					]
				},
				{
					header: "W",
					children:
					[
						{
							name: "Wayne Adams",
							email: "superwayne@example.com",
							photo: "http://feathersui.com/examples/tabs/images/men36.jpg"
						},
					]
				},
			]);
		}

		private function createContactItemRenderer():IGroupedListItemRenderer
		{
			var itemRenderer:DefaultGroupedListItemRenderer = new DefaultGroupedListItemRenderer();
			itemRenderer.labelField = "name";
			itemRenderer.accessoryLabelField = "email";
			itemRenderer.iconSourceField = "photo";
			itemRenderer.iconLoaderFactory = this.createPhotoLoader;
			return itemRenderer;
		}

		private function createPhotoLoader():ImageLoader
		{
			var loader:ImageLoader = new ImageLoader();
			loader.textureCache = this._cache;
			return loader;
		}
	}
}


================================================
FILE: examples/Tabs/source/feathers/examples/tabs/screens/MessagesScreen.as
================================================
package feathers.examples.tabs.screens
{
	import feathers.controls.ImageLoader;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ArrayCollection;
	import feathers.data.ListCollection;
	import feathers.examples.tabs.themes.StyleNames;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.utils.textures.TextureCache;

	public class MessagesScreen extends PanelScreen
	{
		public function MessagesScreen()
		{
			this.title = "Messages";
		}

		private var _list:List;
		private var _cache:TextureCache;

		override public function dispose():void
		{
			if(this._cache !== null)
			{
				this._cache.dispose();
				this._cache = null;
			}
			super.dispose();
		}

		override protected function initialize():void
		{
			super.initialize();

			this._cache = new TextureCache(10);

			this.layout = new AnchorLayout();

			this._list = new List();
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.customItemRendererStyleName = StyleNames.MESSAGE_LIST_ITEM_RENDERER;
			this._list.itemRendererFactory = this.createMessageItemRenderer;
			this.addChild(this._list);

			this._list.dataProvider = new ArrayCollection(
			[
				{
					name: "Patsy Brewer",
					message: "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
					photo: "http://feathersui.com/examples/tabs/images/women79.jpg"
				},
				{
					name: "Wayne Adams",
					message: "Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.",
					photo: "http://feathersui.com/examples/tabs/images/men36.jpg"
				},
				{
					name: "Andy Johnston",
					message: "Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.",
					photo: "http://feathersui.com/examples/tabs/images/men92.jpg"
				},
				{
					name: "Pearl Boyd",
					message: "Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.",
					photo: "http://feathersui.com/examples/tabs/images/women69.jpg"
				},
			]);
		}

		private function createMessageItemRenderer():IListItemRenderer
		{
			var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
			itemRenderer.labelField = "name";
			itemRenderer.accessoryLabelField = "message";
			itemRenderer.iconSourceField = "photo";
			itemRenderer.iconLoaderFactory = this.createPhotoLoader;
			return itemRenderer;
		}

		private function createPhotoLoader():ImageLoader
		{
			var loader:ImageLoader = new ImageLoader();
			loader.textureCache = this._cache;
			return loader;
		}
	}
}


================================================
FILE: examples/Tabs/source/feathers/examples/tabs/screens/ProfileScreen.as
================================================
package feathers.examples.tabs.screens
{
	import feathers.controls.ImageLoader;
	import feathers.controls.Label;
	import feathers.controls.LayoutGroup;
	import feathers.controls.Screen;
	import feathers.examples.tabs.themes.StyleNames;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;

	public class ProfileScreen extends Screen
	{
		public function ProfileScreen()
		{
			super();
		}

		private var _image:ImageLoader;
		private var _nameLabel:Label;
		private var _emailLabel:Label;

		override protected function initialize():void
		{
			super.initialize();

			var mainLayout:VerticalLayout = new VerticalLayout();
			mainLayout.horizontalAlign = HorizontalAlign.CENTER;
			mainLayout.verticalAlign = VerticalAlign.MIDDLE;
			mainLayout.padding = 10;
			this.layout = mainLayout;

			var header:LayoutGroup = new LayoutGroup();
			var headerLayout:VerticalLayout = new VerticalLayout();
			headerLayout.gap = 4;
			headerLayout.horizontalAlign = HorizontalAlign.CENTER;
			header.layout = headerLayout;
			this.addChild(header);

			this._image = new ImageLoader();
			this._image.styleNameList.add(StyleNames.LARGE_PROFILE_IMAGE);
			this._image.source = "http://feathersui.com/examples/tabs/images/men67.jpg";
			header.addChild(this._image);

			this._nameLabel = new Label();
			this._nameLabel.styleNameList.add(Label.ALTERNATE_STYLE_NAME_HEADING);
			this._nameLabel.text = "Flynn Reynolds";
			header.addChild(this._nameLabel);

			this._emailLabel = new Label();
			this._emailLabel.text = "flynn.reynolds84@example.com";
			this.addChild(this._emailLabel);
		}
	}
}


================================================
FILE: examples/Tabs/source/feathers/examples/tabs/themes/StyleNames.as
================================================
package feathers.examples.tabs.themes
{
	public class StyleNames
	{
		public static const MESSAGE_LIST_ITEM_RENDERER:String = "message-list-item-renderer";
		public static const SMALL_PROFILE_IMAGE:String = "small-profile-image";
		public static const LARGE_PROFILE_IMAGE:String = "large-profile-image";
	}
}


================================================
FILE: examples/Tabs/source/feathers/examples/tabs/themes/TabsTheme.as
================================================
package feathers.examples.tabs.themes
{
	import feathers.controls.ImageLoader;
	import feathers.controls.ItemRendererLayoutOrder;
	import feathers.controls.renderers.BaseDefaultItemRenderer;
	import feathers.controls.renderers.DefaultGroupedListItemRenderer;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.layout.RelativePosition;
	import feathers.themes.MetalWorksMobileTheme;

	import starling.display.Canvas;

	public class TabsTheme extends MetalWorksMobileTheme
	{
		public function TabsTheme()
		{
			super();
		}

		override protected function initializeStyleProviders():void
		{
			super.initializeStyleProviders();

			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(
					StyleNames.MESSAGE_LIST_ITEM_RENDERER, this.setMessageListItemRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(
				StyleNames.MESSAGE_LIST_ITEM_RENDERER, this.setMessageListItemRendererStyles);
			this.getStyleProviderForClass(ImageLoader).setFunctionForStyleName(
				StyleNames.SMALL_PROFILE_IMAGE, this.setSmallProfileImageStyles);
			this.getStyleProviderForClass(ImageLoader).setFunctionForStyleName(
				StyleNames.LARGE_PROFILE_IMAGE, this.setLargeProfileImageStyles);
		}

		private function setMessageListItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);
			itemRenderer.accessoryPosition = RelativePosition.BOTTOM;
			itemRenderer.accessoryGap = 4;
			itemRenderer.layoutOrder = ItemRendererLayoutOrder.LABEL_ACCESSORY_ICON;
			itemRenderer.customIconLoaderStyleName = StyleNames.SMALL_PROFILE_IMAGE;
		}

		private function setProfileImageStyles(image:ImageLoader, size:Number):void
		{
			var halfSize:Number = size / 2;
			image.setSize(size, size);
			var mask:Canvas = new Canvas();
			mask.beginFill(0xff00ff, 1);
			mask.drawCircle(halfSize, halfSize, halfSize);
			mask.endFill();
			image.mask = mask;
			image.addChild(mask);
		}

		private function setSmallProfileImageStyles(image:ImageLoader):void
		{
			this.setProfileImageStyles(image, 48);
		}

		private function setLargeProfileImageStyles(image:ImageLoader):void
		{
			this.setProfileImageStyles(image, 100);
		}
	}
}


================================================
FILE: examples/TileList/README.md
================================================
# Tile List Example for Feathers

An example of customizing the List component in [Feathers](http://feathersui.com/) using a tile layout with paging. Includes some customization of the DefaultListItemRenderer layout to display an icon above text.

## Web Demo

View the [Tile List Example](http://feathersui.com/examples/tile-list/) in your browser.

## Credits

This example uses the free [Picons social media icon set](https://picons.me/download-social.php).

================================================
FILE: examples/TileList/assets/images/atlas@2x.tps
================================================
<?xml version="1.0" encoding="UTF-8"?>
<data version="1.0">
    <struct type="Settings">
        <key>fileFormatVersion</key>
        <int>3</int>
        <key>texturePackerVersion</key>
        <string>4.0.1</string>
        <key>fileName</key>
        <string>/Users/joshtynjala/Development/feathers/feathers/examples/TileList/assets/images/atlas@2x.tps</string>
        <key>autoSDSettings</key>
        <array>
            <struct type="AutoSDSettings">
                <key>scale</key>
                <double>1</double>
                <key>extension</key>
                <string></string>
                <key>spriteFilter</key>
                <string></string>
                <key>acceptFractionalValues</key>
                <false/>
                <key>maxTextureSize</key>
                <QSize>
                    <key>width</key>
                    <int>-1</int>
                    <key>height</key>
                    <int>-1</int>
                </QSize>
            </struct>
        </array>
        <key>allowRotation</key>
        <false/>
        <key>premultiplyAlpha</key>
        <false/>
        <key>shapeDebug</key>
        <false/>
        <key>dpi</key>
        <uint>72</uint>
        <key>dataFormat</key>
        <string>sparrow</string>
        <key>textureFileName</key>
        <filename>atlas@2x.png</filename>
        <key>flipPVR</key>
        <false/>
        <key>pvrCompressionQuality</key>
        <enum type="SettingsBase::PvrCompressionQuality">PVR_QUALITY_BEST</enum>
        <key>atfCompressData</key>
        <false/>
        <key>mipMapMinSize</key>
        <uint>32768</uint>
        <key>etc1CompressionQuality</key>
        <enum type="SettingsBase::Etc1CompressionQuality">ETC1_QUALITY_LOW_PERCEPTUAL</enum>
        <key>dxtCompressionMode</key>
        <enum type="SettingsBase::DxtCompressionMode">DXT_PERCEPTUAL</enum>
        <key>jxrColorFormat</key>
        <enum type="SettingsBase::JpegXrColorMode">JXR_YUV444</enum>
        <key>jxrTrimFlexBits</key>
        <uint>0</uint>
        <key>jxrCompressionLevel</key>
        <uint>0</uint>
        <key>ditherType</key>
        <enum type="SettingsBase::DitherType">NearestNeighbour</enum>
        <key>backgroundColor</key>
        <uint>0</uint>
        <key>libGdx</key>
        <struct type="LibGDX">
            <key>filtering</key>
            <struct type="LibGDXFiltering">
                <key>x</key>
                <enum type="LibGDXFiltering::Filtering">Linear</enum>
                <key>y</key>
                <enum type="LibGDXFiltering::Filtering">Linear</enum>
            </struct>
        </struct>
        <key>shapePadding</key>
        <uint>2</uint>
        <key>jpgQuality</key>
        <uint>80</uint>
        <key>pngOptimizationLevel</key>
        <uint>1</uint>
        <key>webpQualityLevel</key>
        <uint>101</uint>
        <key>textureSubPath</key>
        <string></string>
        <key>textureFormat</key>
        <enum type="SettingsBase::TextureFormat">png</enum>
        <key>borderPadding</key>
        <uint>2</uint>
        <key>maxTextureSize</key>
        <QSize>
            <key>width</key>
            <int>2048</int>
            <key>height</key>
            <int>2048</int>
        </QSize>
        <key>fixedTextureSize</key>
        <QSize>
            <key>width</key>
            <int>-1</int>
            <key>height</key>
            <int>-1</int>
        </QSize>
        <key>reduceBorderArtifacts</key>
        <false/>
        <key>algorithmSettings</key>
        <struct type="AlgorithmSettings">
            <key>algorithm</key>
            <enum type="AlgorithmSettings::AlgorithmId">MaxRects</enum>
            <key>freeSizeMode</key>
            <enum type="AlgorithmSettings::AlgorithmFreeSizeMode">Best</enum>
            <key>sizeConstraints</key>
            <enum type="AlgorithmSettings::SizeConstraints">AnySize</enum>
            <key>forceSquared</key>
            <false/>
            <key>forceWordAligned</key>
            <false/>
            <key>maxRects</key>
            <struct type="AlgorithmMaxRectsSettings">
                <key>heuristic</key>
                <enum type="AlgorithmMaxRectsSettings::Heuristic">Best</enum>
            </struct>
            <key>basic</key>
            <struct type="AlgorithmBasicSettings">
                <key>sortBy</key>
                <enum type="AlgorithmBasicSettings::SortBy">Best</enum>
                <key>order</key>
                <enum type="AlgorithmBasicSettings::Order">Ascending</enum>
            </struct>
        </struct>
        <key>andEngine</key>
        <struct type="AndEngine">
            <key>minFilter</key>
            <enum type="AndEngine::MinFilter">Linear</enum>
            <key>packageName</key>
            <string>Texture</string>
            <key>wrap</key>
            <struct type="AndEngineWrap">
                <key>s</key>
                <enum type="AndEngineWrap::Wrap">Clamp</enum>
                <key>t</key>
                <enum type="AndEngineWrap::Wrap">Clamp</enum>
            </struct>
            <key>magFilter</key>
            <enum type="AndEngine::MagFilter">MagLinear</enum>
        </struct>
        <key>dataFileNames</key>
        <map type="GFileNameMap">
            <key>data</key>
            <struct type="DataFile">
                <key>name</key>
                <filename>atlas@2x.xml</filename>
            </struct>
            <key>java</key>
            <struct type="DataFile">
                <key>name</key>
                <filename>icons.java</filename>
            </struct>
        </map>
        <key>multiPack</key>
        <false/>
        <key>forceIdenticalLayout</key>
        <false/>
        <key>outputFormat</key>
        <enum type="SettingsBase::OutputFormat">RGBA8888</enum>
        <key>contentProtection</key>
        <struct type="ContentProtection">
            <key>key</key>
            <string></string>
        </struct>
        <key>autoAliasEnabled</key>
        <true/>
        <key>trimSpriteNames</key>
        <false/>
        <key>prependSmartFolderName</key>
        <false/>
        <key>cleanTransparentPixels</key>
        <true/>
        <key>globalSpriteSettings</key>
        <struct type="SpriteSettings">
            <key>scale</key>
            <double>1</double>
            <key>scaleMode</key>
            <enum type="ScaleMode">Smooth</enum>
            <key>extrude</key>
            <uint>1</uint>
            <key>trimThreshold</key>
            <uint>1</uint>
            <key>trimMargin</key>
            <uint>1</uint>
            <key>trimMode</key>
            <enum type="SpriteSettings::TrimMode">Trim</enum>
            <key>tracerTolerance</key>
            <int>200</int>
            <key>heuristicMask</key>
            <false/>
            <key>pivotPoint</key>
            <enum type="SpriteSettings::PivotPoint">Center</enum>
        </struct>
        <key>fileList</key>
        <array>
            <filename>atlas@2x</filename>
        </array>
        <key>ignoreFileList</key>
        <array/>
        <key>replaceList</key>
        <array/>
        <key>ignoredWarnings</key>
        <array/>
        <key>commonDivisorX</key>
        <uint>1</uint>
        <key>commonDivisorY</key>
        <uint>1</uint>
        <key>packNormalMaps</key>
        <false/>
        <key>autodetectNormalMaps</key>
        <true/>
        <key>normalMapFilter</key>
        <string></string>
        <key>normalMapSuffix</key>
        <string></string>
        <key>normalMapSheetFileName</key>
        <filename></filename>
    </struct>
</data>


================================================
FILE: examples/TileList/assets/images/atlas@2x.xml
================================================
<?xml version="1.0" encoding="UTF-8"?>
<!-- Created with TexturePacker http://www.codeandweb.com/texturepacker-->
<!-- $TexturePacker:SmartUpdate:e03d873b4d80c26aee33406ce98c2c27:56e65690a0ede4bbfc70f7d857016895:eab29082ace0a83bd389fcb3e4575d43$ -->
<TextureAtlas imagePath="atlas@2x.png" width="1717" height="266">
    <SubTexture name="behance" x="3" y="3" width="128" height="128"/>
    <SubTexture name="blogger" x="3" y="135" width="128" height="128"/>
    <SubTexture name="delicious" x="135" y="3" width="128" height="128"/>
    <SubTexture name="deviantart" x="135" y="135" width="128" height="128"/>
    <SubTexture name="digg" x="267" y="3" width="128" height="128"/>
    <SubTexture name="dribbble" x="267" y="135" width="128" height="128"/>
    <SubTexture name="facebook" x="399" y="3" width="128" height="128"/>
    <SubTexture name="flickr" x="399" y="135" width="128" height="128"/>
    <SubTexture name="github" x="1455" y="135" width="128" height="125" frameX="0" frameY="0" frameWidth="128" frameHeight="128"/>
    <SubTexture name="google" x="531" y="3" width="128" height="128"/>
    <SubTexture name="instagram" x="531" y="135" width="128" height="128"/>
    <SubTexture name="linkedin" x="663" y="3" width="128" height="128"/>
    <SubTexture name="pinterest" x="663" y="135" width="128" height="128"/>
    <SubTexture name="snapchat" x="1587" y="3" width="127" height="127" frameX="0" frameY="0" frameWidth="128" frameHeight="128"/>
    <SubTexture name="soundcloud" x="795" y="3" width="128" height="128"/>
    <SubTexture name="stackoverflow" x="795" y="135" width="128" height="128"/>
    <SubTexture name="stumbleupon" x="927" y="3" width="128" height="128"/>
    <SubTexture name="tumblr" x="927" y="135" width="128" height="128"/>
    <SubTexture name="twitter" x="1059" y="3" width="128" height="128"/>
    <SubTexture name="vimeo" x="1059" y="135" width="128" height="128"/>
    <SubTexture name="vine" x="1191" y="3" width="128" height="128"/>
    <SubTexture name="wordpress" x="1191" y="135" width="128" height="128"/>
    <SubTexture name="yahoo" x="1323" y="3" width="128" height="128"/>
    <SubTexture name="yelp" x="1323" y="135" width="128" height="128"/>
    <SubTexture name="youtube" x="1455" y="3" width="128" height="128"/>
</TextureAtlas>


================================================
FILE: examples/TileList/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
theme.root = ${basedir}/../../themes/MinimalMobileTheme/source
output.path = ${basedir}/output
icon.path = ${basedir}/../shared-assets/icons
assets.path = ${basedir}/assets
launch.image.path = ${assets.path}/launch-images

swf.version = 30

================================================
FILE: examples/TileList/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="tile-list" default="build" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<target name="build" depends="build-web,build-android,build-ios"/>

	<target name="prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="build-web" depends="prepare">
		<echo message="Building TileListWeb.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-frame=two,feathers.examples.tileList.Main"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/TileListWeb.as"/>
			<arg value="-output=${output.path}/TileListWeb.swf"/>
		</java>
		<copy overwrite="true" todir="${output.path}">
			<fileset dir="${assets.path}">
				<include name="images/atlas@2x.png"/>
				<include name="images/atlas@2x.xml"/>
			</fileset>
		</copy>
	</target>

	<target name="build-air-swf" depends="prepare">
		<echo message="Building TileList.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/TileList.as"/>
			<arg value="-output=${output.path}/TileList.swf"/>
		</java>
	</target>
	<target name="-check-ios-properties">
		<fail unless="ios.provision.path"/>
		<fail unless="ios.certificate.path"/>
		<fail unless="ios.certificate.password"/>
	</target>
	<target name="build-ios" depends="-check-ios-properties,build-air-swf">
		<echo message="Packaging TileList.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="ipa-app-store"/>
			<arg value="-provisioning-profile"/>
			<arg value="${ios.provision.path}"/>
			<arg value="-keystore"/>
			<arg value="${ios.certificate.path}"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-storepass"/>
			<arg value="${ios.certificate.password}"/>
			<arg value="${output.path}/TileList.ipa"/>
			<arg value="source/TileList-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${launch.image.path}"/>
			<arg value="Default~iphone.png"/>							<!-- iphone 3gs -->
			<arg value="Default@2x~iphone.png"/>						<!-- iphone 4/4s -->
			<arg value="Default-568h@2x~iphone.png"/>					<!-- iphone 5/5c/5s -->
			<arg value="Default-375w-667h@2x~iphone.png"/>				<!-- iphone 6/7/8 -->
			<arg value="Default-812h@3x~iphone.png"/>					<!-- iphone x (portrait) -->
			<arg value="Default-Landscape-812h@3x~iphone.png"/>			<!-- iphone x (landscape) -->
			<arg value="Default-414w-736h@3x~iphone.png"/>				<!-- iphone 6/7/8 plus (portrait) -->
			<arg value="Default-Landscape-414w-736h@3x~iphone.png"/>	<!-- iphone 6/7/8 plus (landscape) -->
			<arg value="Default-Portrait~ipad.png"/>					<!-- ipad 1/2 (portrait) -->
			<arg value="Default-PortraitUpsideDown~ipad.png"/>			<!-- ipad 1/2 (portrait upside down) -->
			<arg value="Default-Landscape~ipad.png"/>					<!-- ipad 1/2 (landscape left) -->
			<arg value="Default-LandscapeRight~ipad.png"/>				<!-- ipad 1/2 (landscape right) -->
			<arg value="Default-Portrait@2x~ipad.png"/>					<!-- ipad 3/air (portrait) -->
			<arg value="Default-LandscapeLeft@2x~ipad.png"/>			<!-- ipad 3/air (landscape left) -->
			<arg value="Default-LandscapeRight@2x~ipad.png"/>			<!-- ipad 3/air (landscape right) -->
			<arg value="Default-Portrait@2x.png"/>						<!-- ipad pro (portrait) -->
			<arg value="Default-Landscape@2x.png"/>						<!-- ipad pro (landscape) -->
			<arg value="-C"/>
			<arg value="${assets.path}"/>
			<arg line="images/atlas@2x.png images/atlas@2x.xml"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="TileList.swf"/>
		</java>
	</target>
	<target name="-check-android-properties">
		<fail unless="android.certificate.path"/>
		<fail unless="android.certificate.password"/>
	</target>
	<target name="build-android" depends="-check-android-properties,build-air-swf">
		<echo message="Packaging TileList.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="apk-captive-runtime"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-keystore"/>
			<arg value="${android.certificate.path}"/>
			<arg value="-storepass"/>
			<arg value="${android.certificate.password}"/>
			<arg value="${output.path}/TileList.apk"/>
			<arg value="source/TileList-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${assets.path}"/>
			<arg line="images/atlas@2x.png images/atlas@2x.xml"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="TileList.swf"/>
		</java>
	</target>
	<target name="install-android">
		<echo message="Installing TileList.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.TileList"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-package"/>
			<arg value="${output.path}/TileList.apk"/>
		</java>
	</target>
	<target name="install-ios">
		<echo message="Installing TileList.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.TileList"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-package"/>
			<arg value="${output.path}/TileList.ipa"/>
		</java>
	</target>
</project>

================================================
FILE: examples/TileList/source/TileList-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.examples.TileList</id>
	<filename>Tile List</filename>
	<name>Tile List</name>
	<versionNumber>4.2.0</versionNumber>
	<description>TileList example application built with Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>TileList.swf</content>
		<autoOrients>true</autoOrients>
		<fullScreen>true</fullScreen>
		<visible>true</visible>
		<renderMode>direct</renderMode>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>

	<icon>
		<image29x29>icon29.png</image29x29>
		<image48x48>icon48.png</image48x48>
		<image50x50>icon50.png</image50x50>
		<image57x57>icon57.png</image57x57>
		<image58x58>icon58.png</image58x58>
		<image72x72>icon72.png</image72x72>
		<image87x87>icon87.png</image87x87>
		<image96x96>icon96.png</image96x96>
		<image100x100>icon100.png</image100x100>
		<image114x114>icon114.png</image114x114>
		<image128x128>icon128.png</image128x128>
		<image144x144>icon144.png</image144x144>
		<image180x180>icon180.png</image180x180>
	</icon>
	<android>
		<colorDepth>16bit</colorDepth>
		<manifestAdditions><![CDATA[
			<manifest android:installLocation="auto">
			    <uses-permission android:name="android.permission.INTERNET"/>
			</manifest>
		]]></manifestAdditions>
	</android>
	<iPhone>
		<InfoAdditions>
		<![CDATA[
			<key>UIDeviceFamily</key> 
			<array> 
				<string>1</string>
				<string>2</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<true/>
		]]> 
		</InfoAdditions>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</iPhone>
</application>

================================================
FILE: examples/TileList/source/TileList.as
================================================
package
{
	import feathers.examples.tileList.Main;
	import feathers.utils.ScreenDensityScaleFactorManager;

	import flash.display.Loader;
	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageOrientation;
	import flash.display.StageScaleMode;
	import flash.display3D.Context3DProfile;
	import flash.display3D.Context3DRenderMode;
	import flash.events.Event;
	import flash.filesystem.File;
	import flash.filesystem.FileMode;
	import flash.filesystem.FileStream;
	import flash.system.Capabilities;
	import flash.utils.ByteArray;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#ffffff")]
	public class TileList extends Sprite
	{
		public function TileList()
		{
			if(this.stage)
			{
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
				this.stage.align = StageAlign.TOP_LEFT;
			}
			this.mouseEnabled = this.mouseChildren = false;
			this.showLaunchImage();
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;
		private var _scaler:ScreenDensityScaleFactorManager;
		private var _launchImage:Loader;
		private var _savedAutoOrients:Boolean;

		/**
		 * On iOS, add the native launch image to the classic display list to
		 * avoid displaying only the stage background color between when the
		 * AIR app finishes launching and Starling starts rendering.
		 * 
		 * Launch image names: https://forums.adobe.com/message/9986239#9986239
		 */
		private function showLaunchImage():void
		{
			var filePath:String = null;
			var isPortraitOnly:Boolean = false;
			if(Capabilities.manufacturer.indexOf("iOS") >= 0)
			{
				var isPortraitUpsideDown:Boolean = this.stage.orientation == StageOrientation.UPSIDE_DOWN;
				var isPortrait:Boolean = this.stage.orientation == StageOrientation.DEFAULT || isPortraitUpsideDown;
				var isLandscapeRight:Boolean = this.stage.orientation == StageOrientation.ROTATED_RIGHT;
				if(Capabilities.screenResolutionX == 1242 && Capabilities.screenResolutionY == 2208)
				{
					//iphone 6/7/8 plus
					filePath = isPortrait ? "Default-414w-736h@3x~iphone.png" : "Default-Landscape-414w-736h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 1125 && Capabilities.screenResolutionY == 2436)
				{
					//iphone x
					filePath = isPortrait ? "Default-812h@3x~iphone.png" : "Default-Landscape-812h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 2048 && Capabilities.screenResolutionY == 2732)
				{
					//ipad pro
					filePath = isPortrait ? "Default-Portrait@2x.png" : "Default-Landscape@2x.png";
				}
				else if(Capabilities.screenResolutionX == 1536 && Capabilities.screenResolutionY == 2048)
				{
					//ipad 3/air
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait@2x~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown@2x~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight@2x~ipad.png";
					}
					else
					{
						filePath = "Default-LandscapeLeft@2x~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 768 && Capabilities.screenResolutionY == 1024)
				{
					//ipad 1/2
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight~ipad.png";
					}
					else
					{
						filePath = "Default-Landscape~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 750)
				{
					//iphone 6/7/8
					isPortraitOnly = true;
					filePath = "Default-375w-667h@2x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 640)
				{
					isPortraitOnly = true;
					if(Capabilities.screenResolutionY == 1136)
					{
						//iphone 5/5c/5s
						filePath = "Default-568h@2x~iphone.png";
					}
					else
					{
						//iphone 4/4s
						filePath = "Default@2x~iphone.png";
					}
				}
				else if(Capabilities.screenResolutionX == 320)
				{
					//iphone 3gs
					isPortraitOnly = true;
					filePath = "Default~iphone.png";
				}
			}

			if(filePath)
			{
				var file:File = File.applicationDirectory.resolvePath(filePath);
				if(file.exists)
				{
					var bytes:ByteArray = new ByteArray();
					var stream:FileStream = new FileStream();
					stream.open(file, FileMode.READ);
					stream.readBytes(bytes, 0, stream.bytesAvailable);
					stream.close();
					this._launchImage = new Loader();
					this._launchImage.loadBytes(bytes);
					this.addChild(this._launchImage);
					this._savedAutoOrients = this.stage.autoOrients;
					this.stage.autoOrients = false;
					if(isPortraitOnly)
					{
						this.stage.setOrientation(StageOrientation.DEFAULT);
					}
				}
			}
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(Main, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE);
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.start();
			if(this._launchImage)
			{
				this._starling.addEventListener("rootCreated", starling_rootCreatedHandler);
			}
			this._scaler = new ScreenDensityScaleFactorManager(this._starling);

			this.stage.addEventListener(Event.DEACTIVATE, stage_deactivateHandler, false, 0, true);
		}

		private function starling_rootCreatedHandler(event:Object):void
		{
			if(this._launchImage)
			{
				this.removeChild(this._launchImage);
				this._launchImage.unloadAndStop(true);
				this._launchImage = null;
				this.stage.autoOrients = this._savedAutoOrients;
			}
		}

		private function stage_deactivateHandler(event:Event):void
		{
			this._starling.stop(true);
			this.stage.addEventListener(Event.ACTIVATE, stage_activateHandler, false, 0, true);
		}

		private function stage_activateHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.ACTIVATE, stage_activateHandler);
			this._starling.start();
		}

	}
}

================================================
FILE: examples/TileList/source/TileListWeb.as
================================================
package
{
	import feathers.system.DeviceCapabilities;

	import flash.display.MovieClip;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.events.Event;
	import flash.geom.Rectangle;
	import flash.ui.ContextMenu;
	import flash.utils.getDefinitionByName;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#ffffff")]
	public class TileListWeb extends MovieClip
	{
		public function TileListWeb()
		{
			var menu:ContextMenu = new ContextMenu();
			menu.hideBuiltInItems();
			this.contextMenu = menu;

			if(this.stage)
			{
				this.stage.align = StageAlign.TOP_LEFT;
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
			}

			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;

		private function start():void
		{
			this.gotoAndStop(2);

			//simulating iPhone Retina
			DeviceCapabilities.dpi = 326;

			var MainType:Class = getDefinitionByName("feathers.examples.tileList.Main") as Class;
			this._starling = new Starling(MainType, this.stage, new Rectangle(0, 0, 960, 640));
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.stage.stageWidth = 480;
			this._starling.stage.stageHeight = 320;
			this._starling.start();
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			this.start();
		}
	}
}

================================================
FILE: examples/TileList/source/feathers/examples/tileList/Main.as
================================================
package feathers.examples.tileList
{
	import feathers.controls.LayoutGroup;
	import feathers.controls.List;
	import feathers.controls.PageIndicator;
	import feathers.controls.ScrollBarDisplayMode;
	import feathers.controls.ScrollPolicy;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ArrayCollection;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.RelativePosition;
	import feathers.layout.TiledRowsLayout;
	import feathers.layout.VerticalAlign;
	import feathers.themes.MinimalMobileTheme;

	import starling.events.Event;
	import starling.textures.TextureAtlas;
	import starling.utils.AssetManager;

	public class Main extends LayoutGroup
	{
		public function Main()
		{
			new MinimalMobileTheme();
			super();
		}

		private var _assetManager:AssetManager;
		private var _list:List;
		private var _pageIndicator:PageIndicator;

		override public function dispose():void
		{
			//don't forget to clean up textures and things!
			if(this._assetManager)
			{
				this._assetManager.dispose();
				this._assetManager = null;
			}
			super.dispose();
		}

		override protected function initialize():void
		{
			//don't forget to call super.initialize()
			super.initialize();
			
			//a nice, fluid layout
			this.layout = new AnchorLayout();

			//the page indicator can be used to scroll the list
			this._pageIndicator = new PageIndicator();
			this._pageIndicator.direction = Direction.HORIZONTAL;
			this._pageIndicator.pageCount = 1;

			//we listen to the change event to update the list's scroll position
			this._pageIndicator.addEventListener(Event.CHANGE, pageIndicator_changeHandler);

			//we'll position the page indicator on the bottom and stretch its
			//width to fill the container's width
			var pageIndicatorLayoutData:AnchorLayoutData = new AnchorLayoutData();
			pageIndicatorLayoutData.bottom = 0;
			pageIndicatorLayoutData.left = 0;
			pageIndicatorLayoutData.right = 0;
			this._pageIndicator.layoutData = pageIndicatorLayoutData;

			this.addChild(this._pageIndicator);

			this._list = new List();
			this._list.itemRendererFactory = tileListItemRendererFactory;
			this._list.snapToPages = true;
			this._list.scrollBarDisplayMode = ScrollBarDisplayMode.NONE;
			this._list.horizontalScrollPolicy = ScrollPolicy.ON;
			this._list.verticalScrollPolicy = ScrollPolicy.OFF;

			var listLayout:TiledRowsLayout = new TiledRowsLayout();
			listLayout.paging = Direction.HORIZONTAL;
			listLayout.useSquareTiles = false;
			listLayout.tileHorizontalAlign = HorizontalAlign.JUSTIFY;
			listLayout.tileVerticalAlign = HorizontalAlign.JUSTIFY;
			listLayout.horizontalAlign = HorizontalAlign.JUSTIFY;
			listLayout.verticalAlign = VerticalAlign.TOP;
			listLayout.requestedColumnCount = 4;
			listLayout.distributeWidths = true;
			this._list.layout = listLayout;

			//we listen to the scroll event to update the page indicator
			this._list.addEventListener(Event.SCROLL, list_scrollHandler);

			//the list fills the container's width and the remaining height
			//above the page indicator
			var listLayoutData:AnchorLayoutData = new AnchorLayoutData();
			listLayoutData.top = 0;
			listLayoutData.right = 0;
			listLayoutData.bottom = 0;
			listLayoutData.bottomAnchorDisplayObject = this._pageIndicator;
			listLayoutData.left = 0;
			this._list.layoutData = listLayoutData;

			this.addChild(this._list);
			
			this.loadIcons();
		}
		
		protected function loadIcons():void
		{
			this._assetManager = new AssetManager(2);
			this._assetManager.enqueue("images/atlas@2x.png");
			this._assetManager.enqueue("images/atlas@2x.xml");
			this._assetManager.loadQueue(assetManager_onProgress);
		}
		
		protected function tileListItemRendererFactory():IListItemRenderer
		{
			var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
			itemRenderer.labelField = "label";
			itemRenderer.iconSourceField = "texture";
			itemRenderer.iconPosition = RelativePosition.TOP;
			itemRenderer.horizontalAlign = HorizontalAlign.CENTER;
			itemRenderer.verticalAlign = VerticalAlign.BOTTOM;
			itemRenderer.maxWidth = 80;
			itemRenderer.gap = 2;
			return itemRenderer;
		}

		protected function list_scrollHandler(event:Event):void
		{
			this._pageIndicator.pageCount = this._list.horizontalPageCount;
			this._pageIndicator.selectedIndex = this._list.horizontalPageIndex;
		}

		protected function pageIndicator_changeHandler(event:Event):void
		{
			this._list.scrollToPageIndex(this._pageIndicator.selectedIndex, 0, this._list.pageThrowDuration);
		}
		
		protected function assetManager_onProgress(ratio:Number):void
		{
			if(ratio < 1)
			{
				return;
			}

			//get the texture atlas from the asset manager
			var atlas:TextureAtlas = this._assetManager.getTextureAtlas("atlas@2x");
			
			//populate the list using the textures
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Behance", texture: atlas.getTexture("behance") },
				{ label: "Blogger", texture: atlas.getTexture("blogger") },
				{ label: "Delicious", texture: atlas.getTexture("delicious") },
				{ label: "DeviantArt", texture: atlas.getTexture("deviantart") },
				{ label: "Digg", texture: atlas.getTexture("digg") },
				{ label: "Dribbble", texture: atlas.getTexture("dribbble") },
				{ label: "Facebook", texture: atlas.getTexture("facebook") },
				{ label: "Flickr", texture: atlas.getTexture("flickr") },
				{ label: "Github", texture: atlas.getTexture("github") },
				{ label: "Google", texture: atlas.getTexture("google") },
				{ label: "Instagram", texture: atlas.getTexture("instagram") },
				{ label: "LinkedIn", texture: atlas.getTexture("linkedin") },
				{ label: "Pinterest", texture: atlas.getTexture("pinterest") },
				{ label: "Snapchat", texture: atlas.getTexture("snapchat") },
				{ label: "SoundCloud", texture: atlas.getTexture("soundcloud") },
				{ label: "StackOverflow", texture: atlas.getTexture("stackoverflow") },
				{ label: "StumbleUpon", texture: atlas.getTexture("stumbleupon") },
				{ label: "Tumblr", texture: atlas.getTexture("tumblr") },
				{ label: "Twitter", texture: atlas.getTexture("twitter") },
				{ label: "Vimeo", texture: atlas.getTexture("vimeo") },
				{ label: "Vine", texture: atlas.getTexture("vine") },
				{ label: "WordPress", texture: atlas.getTexture("wordpress") },
				{ label: "Yahoo!", texture: atlas.getTexture("yahoo") },
				{ label: "Yelp", texture: atlas.getTexture("yelp") },
				{ label: "YouTube", texture: atlas.getTexture("youtube") },
			]);
		}
	}
}


================================================
FILE: examples/Todos/README.md
================================================
# Todos Example for Feathers

This [Feathers UI](http://feathersui.com/) example mocks up a simple application to track things that need to get done. The app can add and remove todo items, mark them as completed, and it even supports drag and drop to change the order of items. A custom list item renderer based on the `LayoutGroup` component is used, and it can switch between a normal checkbox and label and an editable mode that adds a drag handle and a delete button.

## Requirements

In addition to Starling Framework and Feathers, this example project requires the `MetalWorksMobileTheme` example theme. You can find the SWC file for this theme at the following location in the Feathers release build:

	themes/MetalWorksMobileTheme/swc/MetalWorksMobileTheme.swc

## Web Demo

View the [Todos example](http://feathersui.com/examples/todos/) in your browser.

================================================
FILE: examples/Todos/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
theme.root = ${basedir}/../../themes/MetalWorksMobileTheme/source
output.path = ${basedir}/output
icon.path = ${basedir}/../shared-assets/icons
launch.image.path = ${basedir}/../shared-assets/launch-images-windowed

swf.version = 30

================================================
FILE: examples/Todos/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="todos" default="build" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<target name="build" depends="build-web,build-android,build-ios"/>

	<target name="prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="build-web" depends="prepare">
		<echo message="Building TodosWeb.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-advanced-telemetry=true"/>
			<arg value="-frame=two,feathers.examples.todos.Main"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/TodosWeb.as"/>
			<arg value="-output=${output.path}/TodosWeb.swf"/>
		</java>
	</target>
	<target name="build-air-swf" depends="prepare">
		<echo message="Building Todos.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-advanced-telemetry=true"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/Todos.as"/>
			<arg value="-output=${output.path}/Todos.swf"/>
		</java>
	</target>
	<target name="-check-ios-properties">
		<fail unless="ios.provision.path"/>
		<fail unless="ios.certificate.path"/>
		<fail unless="ios.certificate.password"/>
	</target>
	<target name="build-ios" depends="-check-ios-properties,build-air-swf">
		<echo message="Packaging Todos.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="ipa-app-store"/>
			<!-- uncomment for actionscript sampling with scout on ios -->
			<!--<arg value="-sampler"/>-->
			<arg value="-provisioning-profile"/>
			<arg value="${ios.provision.path}"/>
			<arg value="-keystore"/>
			<arg value="${ios.certificate.path}"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-storepass"/>
			<arg value="${ios.certificate.password}"/>
			<arg value="${output.path}/Todos.ipa"/>
			<arg value="source/Todos-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${launch.image.path}"/>
			<arg value="Default~iphone.png"/>							<!-- iphone 3gs -->
			<arg value="Default@2x~iphone.png"/>						<!-- iphone 4/4s -->
			<arg value="Default-568h@2x~iphone.png"/>					<!-- iphone 5/5c/5s -->
			<arg value="Default-375w-667h@2x~iphone.png"/>				<!-- iphone 6/7/8 -->
			<arg value="Default-812h@3x~iphone.png"/>					<!-- iphone x (portrait) -->
			<arg value="Default-Landscape-812h@3x~iphone.png"/>			<!-- iphone x (landscape) -->
			<arg value="Default-414w-736h@3x~iphone.png"/>				<!-- iphone 6/7/8 plus (portrait) -->
			<arg value="Default-Landscape-414w-736h@3x~iphone.png"/>	<!-- iphone 6/7/8 plus (landscape) -->
			<arg value="Default-Portrait~ipad.png"/>					<!-- ipad 1/2 (portrait) -->
			<arg value="Default-PortraitUpsideDown~ipad.png"/>			<!-- ipad 1/2 (portrait upside down) -->
			<arg value="Default-Landscape~ipad.png"/>					<!-- ipad 1/2 (landscape left) -->
			<arg value="Default-LandscapeRight~ipad.png"/>				<!-- ipad 1/2 (landscape right) -->
			<arg value="Default-Portrait@2x~ipad.png"/>					<!-- ipad 3/air (portrait) -->
			<arg value="Default-LandscapeLeft@2x~ipad.png"/>			<!-- ipad 3/air (landscape left) -->
			<arg value="Default-LandscapeRight@2x~ipad.png"/>			<!-- ipad 3/air (landscape right) -->
			<arg value="Default-Portrait@2x.png"/>						<!-- ipad pro (portrait) -->
			<arg value="Default-Landscape@2x.png"/>						<!-- ipad pro (landscape) -->
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="Todos.swf"/>
		</java>
	</target>
	<target name="-check-android-properties">
		<fail unless="android.certificate.path"/>
		<fail unless="android.certificate.password"/>
	</target>
	<target name="build-android" depends="-check-android-properties,build-air-swf">
		<echo message="Packaging Todos.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="apk-captive-runtime"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-keystore"/>
			<arg value="${android.certificate.path}"/>
			<arg value="-storepass"/>
			<arg value="${android.certificate.password}"/>
			<arg value="${output.path}/Todos.apk"/>
			<arg value="source/Todos-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="Todos.swf"/>
		</java>
	</target>
	<target name="install-android">
		<echo message="Installing Todos.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.Todos"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-package"/>
			<arg value="${output.path}/Todos.apk"/>
		</java>
	</target>
	<target name="install-ios">
		<echo message="Installing Todos.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.Todos"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-package"/>
			<arg value="${output.path}/Todos.ipa"/>
		</java>
	</target>
</project>

================================================
FILE: examples/Todos/source/Todos-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.examples.Todos</id>
	<filename>Todos</filename>
	<name>Todos</name>
	<versionNumber>4.2.0</versionNumber>
	<description>Todos example application built with Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>Todos.swf</content>
		<autoOrients>true</autoOrients>
		<fullScreen>false</fullScreen>
		<visible>true</visible>
		<renderMode>direct</renderMode>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>

	<icon>
		<image29x29>icon29.png</image29x29>
		<image48x48>icon48.png</image48x48>
		<image50x50>icon50.png</image50x50>
		<image57x57>icon57.png</image57x57>
		<image58x58>icon58.png</image58x58>
		<image72x72>icon72.png</image72x72>
		<image87x87>icon87.png</image87x87>
		<image96x96>icon96.png</image96x96>
		<image100x100>icon100.png</image100x100>
		<image114x114>icon114.png</image114x114>
		<image128x128>icon128.png</image128x128>
		<image144x144>icon144.png</image144x144>
		<image180x180>icon180.png</image180x180>
	</icon>
	<android>
		<colorDepth>16bit</colorDepth>
		<manifestAdditions><![CDATA[
			<manifest android:installLocation="auto">
			    <uses-permission android:name="android.permission.INTERNET"/>
			</manifest>
		]]></manifestAdditions>
	</android>
	<iPhone>
		<InfoAdditions>
		<![CDATA[
			<key>UIDeviceFamily</key> 
			<array> 
				<string>1</string>
				<string>2</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<true/>
			<key>UIStatusBarStyle</key>
			<string>UIStatusBarStyleLightContent</string>
		]]> 
		</InfoAdditions>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</iPhone>
</application>

================================================
FILE: examples/Todos/source/Todos.as
================================================
package
{
	import feathers.examples.todos.Main;
	import feathers.utils.ScreenDensityScaleFactorManager;

	import flash.display.Loader;
	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageOrientation;
	import flash.display.StageScaleMode;
	import flash.display3D.Context3DProfile;
	import flash.display3D.Context3DRenderMode;
	import flash.events.Event;
	import flash.filesystem.File;
	import flash.filesystem.FileMode;
	import flash.filesystem.FileStream;
	import flash.system.Capabilities;
	import flash.utils.ByteArray;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class Todos extends Sprite
	{
		public function Todos()
		{
			if(this.stage)
			{
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
				this.stage.align = StageAlign.TOP_LEFT;
			}
			this.mouseEnabled = this.mouseChildren = false;
			this.showLaunchImage();
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;
		private var _scaler:ScreenDensityScaleFactorManager;
		private var _launchImage:Loader;
		private var _savedAutoOrients:Boolean;

		/**
		 * On iOS, add the native launch image to the classic display list to
		 * avoid displaying only the stage background color between when the
		 * AIR app finishes launching and Starling starts rendering.
		 * 
		 * Launch image names: https://forums.adobe.com/message/9986239#9986239
		 */
		private function showLaunchImage():void
		{
			var filePath:String = null;
			var isPortraitOnly:Boolean = false;
			if(Capabilities.manufacturer.indexOf("iOS") >= 0)
			{
				var isPortraitUpsideDown:Boolean = this.stage.orientation == StageOrientation.UPSIDE_DOWN;
				var isPortrait:Boolean = this.stage.orientation == StageOrientation.DEFAULT || isPortraitUpsideDown;
				var isLandscapeRight:Boolean = this.stage.orientation == StageOrientation.ROTATED_RIGHT;
				if(Capabilities.screenResolutionX == 1242 && Capabilities.screenResolutionY == 2208)
				{
					//iphone 6/7/8 plus
					filePath = isPortrait ? "Default-414w-736h@3x~iphone.png" : "Default-Landscape-414w-736h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 1125 && Capabilities.screenResolutionY == 2436)
				{
					//iphone x
					filePath = isPortrait ? "Default-812h@3x~iphone.png" : "Default-Landscape-812h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 2048 && Capabilities.screenResolutionY == 2732)
				{
					//ipad pro
					filePath = isPortrait ? "Default-Portrait@2x.png" : "Default-Landscape@2x.png";
				}
				else if(Capabilities.screenResolutionX == 1536 && Capabilities.screenResolutionY == 2048)
				{
					//ipad 3/air
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait@2x~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown@2x~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight@2x~ipad.png";
					}
					else
					{
						filePath = "Default-LandscapeLeft@2x~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 768 && Capabilities.screenResolutionY == 1024)
				{
					//ipad 1/2
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight~ipad.png";
					}
					else
					{
						filePath = "Default-Landscape~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 750)
				{
					//iphone 6/7/8
					isPortraitOnly = true;
					filePath = "Default-375w-667h@2x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 640)
				{
					isPortraitOnly = true;
					if(Capabilities.screenResolutionY == 1136)
					{
						//iphone 5/5c/5s
						filePath = "Default-568h@2x~iphone.png";
					}
					else
					{
						//iphone 4/4s
						filePath = "Default@2x~iphone.png";
					}
				}
				else if(Capabilities.screenResolutionX == 320)
				{
					//iphone 3gs
					isPortraitOnly = true;
					filePath = "Default~iphone.png";
				}
			}

			if(filePath)
			{
				var file:File = File.applicationDirectory.resolvePath(filePath);
				if(file.exists)
				{
					var bytes:ByteArray = new ByteArray();
					var stream:FileStream = new FileStream();
					stream.open(file, FileMode.READ);
					stream.readBytes(bytes, 0, stream.bytesAvailable);
					stream.close();
					this._launchImage = new Loader();
					this._launchImage.loadBytes(bytes);
					this.addChild(this._launchImage);
					this._savedAutoOrients = this.stage.autoOrients;
					this.stage.autoOrients = false;
					if(isPortraitOnly)
					{
						this.stage.setOrientation(StageOrientation.DEFAULT);
					}
				}
			}
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(Main, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE);
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.start();
			if(this._launchImage)
			{
				this._starling.addEventListener("rootCreated", starling_rootCreatedHandler);
			}
			this._scaler = new ScreenDensityScaleFactorManager(this._starling);

			this.stage.addEventListener(Event.DEACTIVATE, stage_deactivateHandler, false, 0, true);
		}

		private function starling_rootCreatedHandler(event:Object):void
		{
			if(this._launchImage)
			{
				this.removeChild(this._launchImage);
				this._launchImage.unloadAndStop(true);
				this._launchImage = null;
				this.stage.autoOrients = this._savedAutoOrients;
			}
		}

		private function stage_deactivateHandler(event:Event):void
		{
			this._starling.stop(true);
			this.stage.addEventListener(Event.ACTIVATE, stage_activateHandler, false, 0, true);
		}

		private function stage_activateHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.ACTIVATE, stage_activateHandler);
			this._starling.start();
		}

	}
}

================================================
FILE: examples/Todos/source/TodosWeb.as
================================================
package
{
	import feathers.system.DeviceCapabilities;

	import flash.display.MovieClip;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.events.Event;
	import flash.geom.Rectangle;
	import flash.ui.ContextMenu;
	import flash.utils.getDefinitionByName;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class TodosWeb extends MovieClip
	{
		public function TodosWeb()
		{
			var menu:ContextMenu = new ContextMenu();
			menu.hideBuiltInItems();
			this.contextMenu = menu;
			
			if(this.stage)
			{
				this.stage.align = StageAlign.TOP_LEFT;
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
			}
			
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}
		
		private var _starling:Starling;
		
		private function start():void
		{
			this.gotoAndStop(2);
			this.graphics.clear();

			//simulating iPhone Retina
			DeviceCapabilities.dpi = 326;
			
			Starling.multitouchEnabled = true;
			var MainType:Class = getDefinitionByName("feathers.examples.todos.Main") as Class;
			this._starling = new Starling(MainType, this.stage, new Rectangle(0, 0, 960, 640));
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.stage.stageWidth = 480;
			this._starling.stage.stageHeight = 320;
			this._starling.start();
		}
		
		private function loaderInfo_completeHandler(event:Event):void
		{
			this.start();
		}
	}
}

================================================
FILE: examples/Todos/source/feathers/examples/todos/Main.as
================================================
package feathers.examples.todos
{
	import feathers.controls.Alert;
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.LayoutGroup;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.TabBar;
	import feathers.controls.TextInput;
	import feathers.controls.ToggleButton;
	import feathers.controls.text.StageTextTextEditor;
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.ITextEditor;
	import feathers.data.ArrayCollection;
	import feathers.data.VectorCollection;
	import feathers.events.FeathersEventType;
	import feathers.examples.todos.TodoItem;
	import feathers.examples.todos.controls.TodoItemRenderer;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.HorizontalLayoutData;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import flash.net.SharedObject;
	import feathers.controls.renderers.IListItemRenderer;
	import flash.net.registerClassAlias;

	public class Main extends PanelScreen
	{
		public function Main()
		{
			//set up the theme right away!
			new TodosTheme();
			super();
			
			registerClassAlias("feathers.examples.todos.TodoItem", TodoItem);
			this._sharedObject = SharedObject.getLocal("todos");

			this.addEventListener(Event.ADDED_TO_STAGE, addedToStageHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, removedFromStageHandler);
		}

		private var _list:List;
		private var _tabs:TabBar;
		private var _toolbar:LayoutGroup;
		private var _input:TextInput;
		private var _clearButton:Button;
		private var _editButton:ToggleButton;
		private var _items:VectorCollection;
		private var _sharedObject:SharedObject;

		private function customHeaderFactory():IFeathersControl
		{
			var header:Header = new Header();

			if(!this._editButton)
			{
				this._editButton = new ToggleButton();
				this._editButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_QUIET_BUTTON);
				this._editButton.label = "Edit";
				this._editButton.addEventListener(Event.CHANGE, editButton_changeHandler);
			}

			header.rightItems = new <DisplayObject>
			[
				this._editButton
			];

			return header;
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "TODOS";

			this.width = this.stage.stageWidth;
			this.height = this.stage.stageHeight;

			this.layout = new AnchorLayout();

			this.headerFactory = this.customHeaderFactory;

			this._tabs = new TabBar();
			this._tabs.dataProvider = new ArrayCollection(
			[
				{label: "All"},
				{label: "Active"},
				{label: "Completed"},
			]);
			this._tabs.addEventListener(Event.CHANGE, tabs_changeHandler);
			this.addChild(this._tabs);

			var itemsToRestore:Vector.<TodoItem> = this._sharedObject.data.items;
			if(!itemsToRestore)
			{
				//if the shared object is empty, create a new vector
				itemsToRestore = new <TodoItem>[];
			}
			this._items = new VectorCollection(itemsToRestore);

			this._list = new List();
			this._list.isSelectable = false;
			this._list.dataProvider = this._items;
			this._list.itemRendererFactory = function():IListItemRenderer
			{
				var itemRenderer:TodoItemRenderer = new TodoItemRenderer();
				itemRenderer.addEventListener(Event.CHANGE, itemRenderer_changeHandler);
				itemRenderer.addEventListener(TodoItemRenderer.EVENT_DELETE_ITEM, itemRenderer_deleteItemHandler);
				return itemRenderer;
			};
			this.addChild(this._list);

			this._toolbar = new LayoutGroup();
			this._toolbar.styleNameList.add(LayoutGroup.ALTERNATE_STYLE_NAME_TOOLBAR);
			this.addChild(this._toolbar);

			this._clearButton = new Button();
			this._clearButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_DANGER_BUTTON);
			this._clearButton.label = "Clear All Completed Items";
			this._clearButton.includeInLayout = false;
			this._clearButton.visible = false;
			this._clearButton.addEventListener(Event.TRIGGERED, clearButton_triggeredHandler);
			this._toolbar.addChild(this._clearButton);

			this._input = new TextInput();
			this._input.prompt = "What needs to be done?";
			this._input.textEditorFactory = function():ITextEditor
			{
				var textEditor:StageTextTextEditor = FeathersControl.defaultTextEditorFactory() as StageTextTextEditor;
				if(textEditor)
				{
					//we can't get an enter key event without changing the value
					//of returnKeyLabel.
					//we didn't use using ReturnKeyLabel.GO here so that it will
					//build the demo for Flash Player. That class is AIR only.
					textEditor.returnKeyLabel = "go";
				}
				return textEditor;
			};
			this._input.layoutData = new HorizontalLayoutData(100);
			this._input.addEventListener(FeathersEventType.ENTER, input_enterHandler);
			this._toolbar.addChild(this._input);

			var toolbarLayoutData:AnchorLayoutData = new AnchorLayoutData();
			toolbarLayoutData.top = 0;
			toolbarLayoutData.right = 0;
			toolbarLayoutData.left = 0;
			this._toolbar.layoutData = toolbarLayoutData;

			var tabsLayoutData:AnchorLayoutData = new AnchorLayoutData();
			tabsLayoutData.bottom = 0;
			tabsLayoutData.right = 0;
			tabsLayoutData.left = 0;
			this._tabs.layoutData = tabsLayoutData;

			var listLayoutData:AnchorLayoutData = new AnchorLayoutData();
			listLayoutData.top = 0;
			listLayoutData.topAnchorDisplayObject = this._toolbar;
			listLayoutData.right = 0;
			listLayoutData.bottom = 0;
			listLayoutData.bottomAnchorDisplayObject = this._tabs;
			listLayoutData.left = 0;
			this._list.layoutData = listLayoutData;
		}

		private function includeActiveItems(item:TodoItem):Boolean
		{
			return !item.isCompleted;
		}

		private function includeCompletedItems(item:TodoItem):Boolean
		{
			return item.isCompleted;
		}

		private function refreshFilterFunction():void
		{
			if(this._tabs.selectedIndex === 1)
			{
				this._items.filterFunction = this.includeActiveItems;
			}
			else if(this._tabs.selectedIndex === 2)
			{
				this._items.filterFunction = this.includeCompletedItems;
			}
			else
			{
				this._items.filterFunction = null;
			}
		}

		private function saveItems():void
		{
			this._sharedObject.data.items = this._items.vectorData;
			this._sharedObject.flush();
		}

		private function addedToStageHandler():void
		{
			this.stage.addEventListener(Event.RESIZE, stage_resizeHandler);
		}

		private function removedFromStageHandler():void
		{
			this.stage.removeEventListener(Event.RESIZE, stage_resizeHandler);
		}

		private function input_enterHandler():void
		{
			if(!this._input.text)
			{
				return;
			}

			this._items.addItem(new TodoItem(this._input.text));
			this._input.text = "";

			this.saveItems();
		}

		private function editButton_changeHandler(event:Event):void
		{
			var isEditing:Boolean = this._editButton.isSelected;

			this._list.dragEnabled = isEditing;
			this._list.dropEnabled = isEditing;

			this._clearButton.visible = isEditing;
			this._clearButton.includeInLayout = isEditing;

			this._input.visible = !isEditing;
			this._input.includeInLayout = !isEditing;
		}

		private function clearButton_triggeredHandler(event:Event):void
		{
			//the completed items may currently be filtered, so temporarily
			//disable the filter.
			this._items.filterFunction = null;
			var hasCompletedItem:Boolean = false;
			var itemCount:int = this._items.length;
			for(var i:int = itemCount - 1; i >= 0; i--)
			{
				var item:TodoItem = TodoItem(this._items.getItemAt(i));
				if(item.isCompleted)
				{
					hasCompletedItem = true;
					break;
				}
			}
			//be sure to restore the filter
			this.refreshFilterFunction();
			if(!hasCompletedItem)
			{
				return;
			}

			Alert.show("Are you sure that you want to delete all completed items? This action cannot be undone.", "Confirm delete",
				new ArrayCollection(
				[
					{ label: "Cancel" },
					{ label: "Delete", triggered: confirmButton_triggeredHandler },
				]));
		}

		private function confirmButton_triggeredHandler(event:Event):void
		{
			//the completed items may currently be filtered, so temporarily
			//disable the filter.
			this._items.filterFunction = null;
			var itemCount:int = this._items.length;
			for(var i:int = itemCount - 1; i >= 0; i--)
			{
				var item:TodoItem = TodoItem(this._items.getItemAt(i));
				if(item.isCompleted)
				{
					this._items.removeItemAt(i);
				}
			}
			//be sure to restore the filter
			this.refreshFilterFunction();

			this.saveItems();
		}

		private function itemRenderer_changeHandler(event:Event):void
		{
			this.saveItems();
		}

		private function itemRenderer_deleteItemHandler(event:Event, item:Object):void
		{
			this._items.removeItem(item);
			this.saveItems();
		}

		private function stage_resizeHandler():void
		{
			this.width = this.stage.stageWidth;
			this.height = this.stage.stageHeight;
		}

		private function tabs_changeHandler(event:Event):void
		{
			this.refreshFilterFunction();
		}
	}
}


================================================
FILE: examples/Todos/source/feathers/examples/todos/TodoItem.as
================================================
package feathers.examples.todos
{
	import flash.utils.IExternalizable;
	import flash.utils.IDataInput;
	import flash.utils.IDataOutput;

	public class TodoItem implements IExternalizable
	{
		public function TodoItem(description:String = null, isCompleted:Boolean = false)
		{
			this.description = description;
			this.isCompleted = isCompleted;
		}

		public var description:String;
		public var isCompleted:Boolean;

		public function writeExternal(output:IDataOutput):void
		{
			output.writeBoolean(this.isCompleted);
			output.writeUTF(this.description);
		}

		public function readExternal(input:IDataInput):void
		{
			this.isCompleted = input.readBoolean();
			this.description = input.readUTF();
		}
	}
}


================================================
FILE: examples/Todos/source/feathers/examples/todos/TodosTheme.as
================================================
package feathers.examples.todos
{
	import feathers.controls.Check;
	import feathers.controls.LayoutGroup;
	import feathers.examples.todos.controls.TodoItemRenderer;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.VerticalAlign;
	import feathers.skins.ImageSkin;
	import feathers.themes.MetalWorksMobileTheme;

	public class TodosTheme extends MetalWorksMobileTheme
	{
		public function TodosTheme()
		{
			super();
		}
		
		override protected function initializeStyleProviders():void
		{
			super.initializeStyleProviders();
			
			this.getStyleProviderForClass(TodoItemRenderer).defaultStyleFunction = this.setTodoItemRendererStyles;
		}

		override protected function setCheckStyles(check:Check):void
		{
			super.setCheckStyles(check);
			check.hasLabelTextRenderer = false;
			check.horizontalAlign = HorizontalAlign.CENTER;
		}
		
		override protected function setToolbarLayoutGroupStyles(group:LayoutGroup):void
		{
			super.setToolbarLayoutGroupStyles(group);
			
			var layout:HorizontalLayout = new HorizontalLayout();
			layout.gap = this.smallGutterSize;
			layout.padding = this.gutterSize;
			layout.horizontalAlign = HorizontalAlign.CENTER;
			layout.verticalAlign = VerticalAlign.MIDDLE;
			group.layout = layout;
		}
		
		protected function setTodoItemRendererStyles(itemRenderer:TodoItemRenderer):void
		{
			var backgroundSkin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			backgroundSkin.scale9Grid = ITEM_RENDERER_SCALE9_GRID;
			itemRenderer.backgroundSkin = backgroundSkin;

			var layout:HorizontalLayout = new HorizontalLayout();
			layout.gap = this.smallGutterSize;
			layout.padding = this.smallGutterSize;
			layout.verticalAlign = VerticalAlign.MIDDLE;
			itemRenderer.layout = layout;

			var dragIcon:ImageSkin = new ImageSkin(this.dragHandleIcon);
			itemRenderer.dragIcon = dragIcon;
		}
	}
}


================================================
FILE: examples/Todos/source/feathers/examples/todos/controls/TodoItemRenderer.as
================================================
package feathers.examples.todos.controls
{
	import feathers.controls.Alert;
	import feathers.controls.Button;
	import feathers.controls.Check;
	import feathers.controls.Label;
	import feathers.controls.List;
	import feathers.controls.renderers.LayoutGroupListItemRenderer;
	import feathers.data.ArrayCollection;
	import feathers.examples.todos.TodoItem;
	import feathers.layout.HorizontalLayoutData;
	import feathers.skins.IStyleProvider;

	import starling.events.Event;
	import starling.display.DisplayObject;
	import feathers.controls.renderers.IDragAndDropItemRenderer;
	import feathers.controls.LayoutGroup;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;

	public class TodoItemRenderer extends LayoutGroupListItemRenderer implements IDragAndDropItemRenderer
	{
		public static const EVENT_DELETE_ITEM:String = "deleteItem";

		public static var globalStyleProvider:IStyleProvider;
		
		public function TodoItemRenderer()
		{
			super();
		}

		protected var check:Check;
		protected var deleteButton:Button;
		protected var label:Label;
		
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return globalStyleProvider;
		}

		private var _dragEnabled:Boolean = false;

		public function get dragEnabled():Boolean
		{
			return this._dragEnabled;
		}

		public function set dragEnabled(value:Boolean):void
		{
			if(this._dragEnabled == value)
			{
				return;
			}
			this._dragEnabled = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		public function get dragProxy():DisplayObject
		{
			return this._dragIcon;
		}

		private var _dragIconContainer:LayoutGroup;

		private var _dragIcon:DisplayObject;

		public function get dragIcon():DisplayObject
		{
			return this._dragIcon;
		}

		public function set dragIcon(value:DisplayObject):void
		{
			if(this._dragIcon == value)
			{
				return;
			}
			if(this._dragIcon && this._dragIcon.parent == this._dragIconContainer)
			{
				this._dragIcon.removeFromParent(false);
			}
			this._dragIcon = value;
			if(this._dragIcon)
			{
				if(!this._dragIconContainer)
				{
					this._dragIconContainer = new LayoutGroup();
					var layout:HorizontalLayout = new HorizontalLayout();
					layout.horizontalAlign = HorizontalAlign.CENTER;
					layout.verticalAlign = VerticalAlign.MIDDLE;
					this._dragIconContainer.layout = layout;
					this.addChildAt(this._dragIconContainer, 0);
				}
				this._dragIconContainer.addChild(this._dragIcon)
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		override public function dispose():void
		{
			if(this.check)
			{
				this.check.removeFromParent(true);
				this.check = null;
			}
			if(this.deleteButton)
			{
				this.deleteButton.removeFromParent(true);
				this.deleteButton = null;
			}
			super.dispose();
		}
		
		override protected function initialize():void
		{
			if(!this.check)
			{
				this.check = new Check();
				this.check.addEventListener(Event.CHANGE, check_changeHandler);
				this.addChild(this.check);
			}

			if(!this.label)
			{
				this.label = new Label();
				this.label.layoutData = new HorizontalLayoutData(100);
				this.addChild(this.label);
			}

			if(!this.deleteButton)
			{
				this.deleteButton = new Button();
				this.deleteButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_DANGER_BUTTON);
				this.deleteButton.label = "Delete";
				this.deleteButton.addEventListener(Event.TRIGGERED, deleteButton_triggeredHandler);
				this.addChild(this.deleteButton);
			}
		}

		override protected function preLayout():void
		{
			if(this._dragIconContainer)
			{
				this.check.validate();
				this._dragIconContainer.width = this.check.width;
				this._dragIconContainer.height = this.check.height;
				this.setChildIndex(this._dragIconContainer, 0);
			}
		}

		override protected function commitData():void
		{
			super.commitData();
			var item:TodoItem = this._data as TodoItem;
			if(!item)
			{
				return;
			}
			this.label.text = item.description;
			
			this.check.isSelected = item.isCompleted;
			this.check.isEnabled = this._isEnabled;
			this.check.includeInLayout = !this._dragEnabled;
			this.check.visible = !this._dragEnabled;
			
			this.deleteButton.includeInLayout = this._dragEnabled;
			this.deleteButton.visible = this._dragEnabled;
			
			if(this._dragIconContainer)
			{
				this._dragIconContainer.includeInLayout = this._dragEnabled;
				this._dragIconContainer.visible = this._dragEnabled;
			}
		}

		protected function check_changeHandler(event:Event):void
		{
			var item:TodoItem = this._data as TodoItem;
			if(!item)
			{
				return;
			}
			var isCompleted:Boolean = this.check.isSelected;
			if(item.isCompleted == isCompleted)
			{
				return;
			}
			item.isCompleted = isCompleted;
			this.dispatchEventWith(Event.CHANGE);
		}

		protected function deleteButton_triggeredHandler(event:Event):void
		{
			Alert.show("Are you sure that you want to delete this item? This action cannot be undone.", "Confirm delete",
				new ArrayCollection(
				[
					{ label: "Cancel" },
					{ label: "Delete", triggered: confirmButton_triggeredHandler },
				]));
		}

		private function confirmButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(EVENT_DELETE_ITEM, false, this._data);
		}
	}
}


================================================
FILE: examples/TrainTimes/README.md
================================================
# Train Times Example for Feathers

This [Feathers](http://feathersui.com/) example mocks up a simple application to view train schedules. It uses custom item renderers and a custom theme.

## Web Demo

View the [Train Times example](http://feathersui.com/examples/train-times/) in your browser.

================================================
FILE: examples/TrainTimes/assets/images/traintimes.tps
================================================
<?xml version="1.0" encoding="UTF-8"?>
<data version="1.0">
    <struct type="Settings">
        <key>fileFormatVersion</key>
        <int>1</int>
        <key>variation</key>
        <string>main</string>
        <key>verbose</key>
        <false/>
        <key>autoSDSettings</key>
        <array/>
        <key>allowRotation</key>
        <false/>
        <key>quiet</key>
        <false/>
        <key>premultiplyAlpha</key>
        <false/>
        <key>shapeDebug</key>
        <false/>
        <key>dpi</key>
        <uint>72</uint>
        <key>dataFormat</key>
        <string>sparrow</string>
        <key>textureFileName</key>
        <filename>traintimes.png</filename>
        <key>flipPVR</key>
        <false/>
        <key>ditherType</key>
        <enum type="SettingsBase::DitherType">NearestNeighbour</enum>
        <key>backgroundColor</key>
        <uint>0</uint>
        <key>libGdx</key>
        <struct type="LibGDX">
            <key>filtering</key>
            <struct type="LibGDXFiltering">
                <key>x</key>
                <enum type="LibGDXFiltering::Filtering">Linear</enum>
                <key>y</key>
                <enum type="LibGDXFiltering::Filtering">Linear</enum>
            </struct>
        </struct>
        <key>shapePadding</key>
        <uint>1</uint>
        <key>jpgQuality</key>
        <uint>80</uint>
        <key>pngOptimizationLevel</key>
        <uint>0</uint>
        <key>textureSubPath</key>
        <string></string>
        <key>textureFormat</key>
        <enum type="SettingsBase::TextureFormat">png</enum>
        <key>borderPadding</key>
        <uint>1</uint>
        <key>maxTextureSize</key>
        <QSize>
            <key>width</key>
            <int>2048</int>
            <key>height</key>
            <int>2048</int>
        </QSize>
        <key>fixedTextureSize</key>
        <QSize>
            <key>width</key>
            <int>-1</int>
            <key>height</key>
            <int>-1</int>
        </QSize>
        <key>reduceBorderArtifacts</key>
        <false/>
        <key>algorithmSettings</key>
        <struct type="AlgorithmSettings">
            <key>algorithm</key>
            <enum type="AlgorithmSettings::AlgorithmId">MaxRects</enum>
            <key>freeSizeMode</key>
            <enum type="AlgorithmSettings::AlgorithmFreeSizeMode">Best</enum>
            <key>sizeConstraints</key>
            <enum type="AlgorithmSettings::SizeConstraints">POT</enum>
            <key>forceSquared</key>
            <false/>
            <key>forceWordAligned</key>
            <false/>
            <key>maxRects</key>
            <struct type="AlgorithmMaxRectsSettings">
                <key>heuristic</key>
                <enum type="AlgorithmMaxRectsSettings::Heuristic">Best</enum>
            </struct>
            <key>basic</key>
            <struct type="AlgorithmBasicSettings">
                <key>sortBy</key>
                <enum type="AlgorithmBasicSettings::SortBy">Best</enum>
                <key>order</key>
                <enum type="AlgorithmBasicSettings::Order">Ascending</enum>
            </struct>
        </struct>
        <key>andEngine</key>
        <struct type="AndEngine">
            <key>minFilter</key>
            <enum type="AndEngine::MinFilter">Linear</enum>
            <key>packageName</key>
            <string>Texture</string>
            <key>javaFileName</key>
            <filename>traintimes.java</filename>
            <key>wrap</key>
            <struct type="AndEngineWrap">
                <key>s</key>
                <enum type="AndEngineWrap::Wrap">Clamp</enum>
                <key>t</key>
                <enum type="AndEngineWrap::Wrap">Clamp</enum>
            </struct>
            <key>magFilter</key>
            <enum type="AndEngine::MagFilter">MagLinear</enum>
        </struct>
        <key>dataFileName</key>
        <filename>traintimes.xml</filename>
        <key>mainExtension</key>
        <string></string>
        <key>forceIdenticalLayout</key>
        <false/>
        <key>outputFormat</key>
        <enum type="SettingsBase::OutputFormat">RGBA8888</enum>
        <key>autoAliasEnabled</key>
        <true/>
        <key>trimSpriteNames</key>
        <false/>
        <key>globalSpriteSettings</key>
        <struct type="SpriteSettings">
            <key>scale</key>
            <double>1</double>
            <key>scaleMode</key>
            <enum type="ScaleMode">Smooth</enum>
            <key>innerPadding</key>
            <uint>0</uint>
            <key>extrude</key>
            <uint>1</uint>
            <key>trimThreshold</key>
            <uint>1</uint>
            <key>trimMode</key>
            <enum type="SpriteSettings::TrimMode">Trim</enum>
            <key>heuristicMask</key>
            <false/>
        </struct>
        <key>fileList</key>
        <array>
            <filename>traintimes</filename>
        </array>
        <key>ignoreFileList</key>
        <array/>
        <key>replaceList</key>
        <array/>
        <key>commonDivisorX</key>
        <uint>1</uint>
        <key>commonDivisorY</key>
        <uint>1</uint>
    </struct>
</data>


================================================
FILE: examples/TrainTimes/assets/images/traintimes.xml
================================================
<?xml version="1.0" encoding="UTF-8"?>
<!-- Created with TexturePacker http://texturepacker.com-->
<!-- $TexturePacker:SmartUpdate:ac9dff798214f47f3dfc1767f7453ea9$ -->
<TextureAtlas imagePath="traintimes.png">
    <SubTexture name="back-icon" x="216" y="35" width="25" height="27"/>
    <SubTexture name="cancel-icon" x="216" y="2" width="30" height="30"/>
    <SubTexture name="confirm-icon" x="2" y="477" width="41" height="30"/>
    <SubTexture name="header-background" x="249" y="2" width="4" height="12"/>
    <SubTexture name="horizontal-scroll-bar-thumb-skin" x="216" y="65" width="24" height="8"/>
    <SubTexture name="main-background" x="2" y="2" width="125" height="125"/>
    <SubTexture name="station-list-first-normal-icon" x="2" y="370" width="53" height="104" frameX="-15" frameY="-56" frameWidth="83" frameHeight="160"/>
    <SubTexture name="station-list-first-selected-icon" x="88" y="165" width="83" height="120" frameX="0" frameY="-40" frameWidth="83" frameHeight="160"/>
    <SubTexture name="station-list-last-normal-icon" x="2" y="257" width="53" height="110" frameX="-15" frameY="0" frameWidth="83" frameHeight="160"/>
    <SubTexture name="station-list-last-selected-icon" x="2" y="130" width="83" height="124" frameX="0" frameY="0" frameWidth="83" frameHeight="160"/>
    <SubTexture name="station-list-normal-icon" x="174" y="165" width="53" height="160" frameX="-15" frameY="0" frameWidth="83" frameHeight="160"/>
    <SubTexture name="station-list-selected-icon" x="130" y="2" width="83" height="160"/>
    <SubTexture name="vertical-scroll-bar-thumb-skin" x="244" y="35" width="8" height="24"/>
</TextureAtlas>


================================================
FILE: examples/TrainTimes/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
output.path = ${basedir}/output
icon.path = ${basedir}/../shared-assets/icons
launch.image.path = ${basedir}/assets/launch-images

swf.version = 30

================================================
FILE: examples/TrainTimes/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="train-times" default="build" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<target name="build" depends="build-web,build-android,build-ios"/>

	<target name="prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="build-web" depends="prepare">
		<echo message="Building TrainTimesWeb.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-frame=two,feathers.examples.trainTimes.Main"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="source/TrainTimesWeb.as"/>
			<arg value="-output=${output.path}/TrainTimesWeb.swf"/>
		</java>
	</target>

	<target name="build-air-swf" depends="prepare">
		<echo message="Building TrainTimes.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="source/TrainTimes.as"/>
			<arg value="-output=${output.path}/TrainTimes.swf"/>
		</java>
	</target>
	<target name="-check-ios-properties">
		<fail unless="ios.provision.path"/>
		<fail unless="ios.certificate.path"/>
		<fail unless="ios.certificate.password"/>
	</target>
	<target name="build-ios" depends="-check-ios-properties,build-air-swf">
		<echo message="Packaging TrainTimes.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="ipa-app-store"/>
			<arg value="-provisioning-profile"/>
			<arg value="${ios.provision.path}"/>
			<arg value="-keystore"/>
			<arg value="${ios.certificate.path}"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-storepass"/>
			<arg value="${ios.certificate.password}"/>
			<arg value="${output.path}/TrainTimes.ipa"/>
			<arg value="source/TrainTimes-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${launch.image.path}"/>
			<arg value="Default~iphone.png"/>							<!-- iphone 3gs -->
			<arg value="Default@2x~iphone.png"/>						<!-- iphone 4/4s -->
			<arg value="Default-568h@2x~iphone.png"/>					<!-- iphone 5/5c/5s -->
			<arg value="Default-375w-667h@2x~iphone.png"/>				<!-- iphone 6/7/8 -->
			<arg value="Default-812h@3x~iphone.png"/>					<!-- iphone x (portrait) -->
			<arg value="Default-Landscape-812h@3x~iphone.png"/>			<!-- iphone x (landscape) -->
			<arg value="Default-414w-736h@3x~iphone.png"/>				<!-- iphone 6/7/8 plus (portrait) -->
			<arg value="Default-Landscape-414w-736h@3x~iphone.png"/>	<!-- iphone 6/7/8 plus (landscape) -->
			<arg value="Default-Portrait~ipad.png"/>					<!-- ipad 1/2 (portrait) -->
			<arg value="Default-PortraitUpsideDown~ipad.png"/>			<!-- ipad 1/2 (portrait upside down) -->
			<arg value="Default-Landscape~ipad.png"/>					<!-- ipad 1/2 (landscape left) -->
			<arg value="Default-LandscapeRight~ipad.png"/>				<!-- ipad 1/2 (landscape right) -->
			<arg value="Default-Portrait@2x~ipad.png"/>					<!-- ipad 3/air (portrait) -->
			<arg value="Default-LandscapeLeft@2x~ipad.png"/>			<!-- ipad 3/air (landscape left) -->
			<arg value="Default-LandscapeRight@2x~ipad.png"/>			<!-- ipad 3/air (landscape right) -->
			<arg value="Default-Portrait@2x.png"/>						<!-- ipad pro (portrait) -->
			<arg value="Default-Landscape@2x.png"/>						<!-- ipad pro (landscape) -->
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="TrainTimes.swf"/>
		</java>
	</target>
	<target name="-check-android-properties">
		<fail unless="android.certificate.path"/>
		<fail unless="android.certificate.password"/>
	</target>
	<target name="build-android" depends="-check-android-properties,build-air-swf">
		<echo message="Packaging TrainTimes.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="apk-captive-runtime"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-keystore"/>
			<arg value="${android.certificate.path}"/>
			<arg value="-storepass"/>
			<arg value="${android.certificate.password}"/>
			<arg value="${output.path}/TrainTimes.apk"/>
			<arg value="source/TrainTimes-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="TrainTimes.swf"/>
		</java>
	</target>
	<target name="install-android">
		<echo message="Installing TrainTimes.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.TrainTimes"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-package"/>
			<arg value="${output.path}/TrainTimes.apk"/>
		</java>
	</target>
	<target name="install-ios">
		<echo message="Installing TrainTimes.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.TrainTimes"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-package"/>
			<arg value="${output.path}/TrainTimes.ipa"/>
		</java>
	</target>
</project>

================================================
FILE: examples/TrainTimes/source/TrainTimes-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.examples.TrainTimes</id>
	<filename>Train Times</filename>
	<name>Train Times</name>
	<versionNumber>4.2.0</versionNumber>
	<description>Train Times example application built with Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>TrainTimes.swf</content>
		<autoOrients>true</autoOrients>
		<fullScreen>false</fullScreen>
		<visible>true</visible>
		<renderMode>direct</renderMode>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>

	<icon>
		<image29x29>icon29.png</image29x29>
		<image48x48>icon48.png</image48x48>
		<image50x50>icon50.png</image50x50>
		<image57x57>icon57.png</image57x57>
		<image58x58>icon58.png</image58x58>
		<image72x72>icon72.png</image72x72>
		<image87x87>icon87.png</image87x87>
		<image96x96>icon96.png</image96x96>
		<image100x100>icon100.png</image100x100>
		<image114x114>icon114.png</image114x114>
		<image128x128>icon128.png</image128x128>
		<image144x144>icon144.png</image144x144>
		<image180x180>icon180.png</image180x180>
	</icon>
	<android>
		<manifestAdditions><![CDATA[
			<manifest android:installLocation="auto">
			    <uses-permission android:name="android.permission.INTERNET"/>
			</manifest>
		]]></manifestAdditions>
	</android>
	<iPhone>
		<InfoAdditions>
			<![CDATA[
			<key>UIDeviceFamily</key>
			<array>
				<string>1</string>
				<string>2</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<true/>
			<key>UIStatusBarStyle</key>
			<string>UIStatusBarStyleLightContent</string>
		]]>
		</InfoAdditions>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</iPhone>
</application>

================================================
FILE: examples/TrainTimes/source/TrainTimes.as
================================================
package
{
	import feathers.examples.trainTimes.Main;
	import feathers.utils.ScreenDensityScaleFactorManager;

	import flash.display.Loader;
	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageOrientation;
	import flash.display.StageScaleMode;
	import flash.display3D.Context3DProfile;
	import flash.display3D.Context3DRenderMode;
	import flash.events.Event;
	import flash.filesystem.File;
	import flash.filesystem.FileMode;
	import flash.filesystem.FileStream;
	import flash.system.Capabilities;
	import flash.utils.ByteArray;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#424254")]
	public class TrainTimes extends Sprite
	{
		public function TrainTimes()
		{
			if(this.stage)
			{
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
				this.stage.align = StageAlign.TOP_LEFT;
			}
			this.mouseEnabled = this.mouseChildren = false;
			this.showLaunchImage();
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;
		private var _scaler:ScreenDensityScaleFactorManager;
		private var _launchImage:Loader;
		private var _savedAutoOrients:Boolean;

		/**
		 * On iOS, add the native launch image to the classic display list to
		 * avoid displaying only the stage background color between when the
		 * AIR app finishes launching and Starling starts rendering.
		 * 
		 * Launch image names: https://forums.adobe.com/message/9986239#9986239
		 */
		private function showLaunchImage():void
		{
			var filePath:String = null;
			var isPortraitOnly:Boolean = false;
			if(Capabilities.manufacturer.indexOf("iOS") >= 0)
			{
				var isPortraitUpsideDown:Boolean = this.stage.orientation == StageOrientation.UPSIDE_DOWN;
				var isPortrait:Boolean = this.stage.orientation == StageOrientation.DEFAULT || isPortraitUpsideDown;
				var isLandscapeRight:Boolean = this.stage.orientation == StageOrientation.ROTATED_RIGHT;
				if(Capabilities.screenResolutionX == 1242 && Capabilities.screenResolutionY == 2208)
				{
					//iphone 6/7/8 plus
					filePath = isPortrait ? "Default-414w-736h@3x~iphone.png" : "Default-Landscape-414w-736h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 1125 && Capabilities.screenResolutionY == 2436)
				{
					//iphone x
					filePath = isPortrait ? "Default-812h@3x~iphone.png" : "Default-Landscape-812h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 2048 && Capabilities.screenResolutionY == 2732)
				{
					//ipad pro
					filePath = isPortrait ? "Default-Portrait@2x.png" : "Default-Landscape@2x.png";
				}
				else if(Capabilities.screenResolutionX == 1536 && Capabilities.screenResolutionY == 2048)
				{
					//ipad 3/air
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait@2x~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown@2x~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight@2x~ipad.png";
					}
					else
					{
						filePath = "Default-LandscapeLeft@2x~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 768 && Capabilities.screenResolutionY == 1024)
				{
					//ipad 1/2
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight~ipad.png";
					}
					else
					{
						filePath = "Default-Landscape~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 750)
				{
					//iphone 6/7/8
					isPortraitOnly = true;
					filePath = "Default-375w-667h@2x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 640)
				{
					isPortraitOnly = true;
					if(Capabilities.screenResolutionY == 1136)
					{
						//iphone 5/5c/5s
						filePath = "Default-568h@2x~iphone.png";
					}
					else
					{
						//iphone 4/4s
						filePath = "Default@2x~iphone.png";
					}
				}
				else if(Capabilities.screenResolutionX == 320)
				{
					//iphone 3gs
					isPortraitOnly = true;
					filePath = "Default~iphone.png";
				}
			}

			if(filePath)
			{
				var file:File = File.applicationDirectory.resolvePath(filePath);
				if(file.exists)
				{
					var bytes:ByteArray = new ByteArray();
					var stream:FileStream = new FileStream();
					stream.open(file, FileMode.READ);
					stream.readBytes(bytes, 0, stream.bytesAvailable);
					stream.close();
					this._launchImage = new Loader();
					this._launchImage.loadBytes(bytes);
					this.addChild(this._launchImage);
					this._savedAutoOrients = this.stage.autoOrients;
					this.stage.autoOrients = false;
					if(isPortraitOnly)
					{
						this.stage.setOrientation(StageOrientation.DEFAULT);
					}
				}
			}
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(Main, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE);
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.start();
			if(this._launchImage)
			{
				this._starling.addEventListener("rootCreated", starling_rootCreatedHandler);
			}
			this._scaler = new ScreenDensityScaleFactorManager(this._starling);
			this.stage.addEventListener(Event.DEACTIVATE, stage_deactivateHandler, false, 0, true);
		}

		private function starling_rootCreatedHandler(event:Object):void
		{
			if(this._launchImage)
			{
				this.removeChild(this._launchImage);
				this._launchImage.unloadAndStop(true);
				this._launchImage = null;
				this.stage.autoOrients = this._savedAutoOrients;
			}
		}

		private function stage_deactivateHandler(event:Event):void
		{
			this._starling.stop(true);
			this.stage.addEventListener(Event.ACTIVATE, stage_activateHandler, false, 0, true);
		}

		private function stage_activateHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.ACTIVATE, stage_activateHandler);
			this._starling.start();
		}

	}
}

================================================
FILE: examples/TrainTimes/source/TrainTimesWeb.as
================================================
package
{
	import feathers.system.DeviceCapabilities;

	import flash.display.MovieClip;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.events.Event;
	import flash.geom.Rectangle;
	import flash.ui.ContextMenu;
	import flash.utils.getDefinitionByName;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#424254")]
	public class TrainTimesWeb extends MovieClip
	{
		public function TrainTimesWeb()
		{
			var menu:ContextMenu = new ContextMenu();
			menu.hideBuiltInItems();
			this.contextMenu = menu;
			
			if(this.stage)
			{
				this.stage.align = StageAlign.TOP_LEFT;
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
			}
			
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}
		
		private var _starling:Starling;
		
		private function start():void
		{
			this.gotoAndStop(2);
			this.graphics.clear();

			//simulating iPhone Retina
			DeviceCapabilities.dpi = 326;
			
			Starling.multitouchEnabled = true;
			var MainType:Class = getDefinitionByName("feathers.examples.trainTimes.Main") as Class;
			this._starling = new Starling(MainType, this.stage, new Rectangle(0, 0, 960, 640));
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.stage.stageWidth = 480;
			this._starling.stage.stageHeight = 320;
			this._starling.start();
		}
		
		private function loaderInfo_completeHandler(event:Event):void
		{
			this.start();
		}
	}
}

================================================
FILE: examples/TrainTimes/source/feathers/examples/trainTimes/Main.as
================================================
package feathers.examples.trainTimes
{

	import feathers.controls.StackScreenNavigator;
	import feathers.controls.StackScreenNavigatorItem;
	import feathers.examples.trainTimes.screens.StationScreen;
	import feathers.examples.trainTimes.screens.TimesScreen;
	import feathers.examples.trainTimes.themes.TrainTimesTheme;
	import feathers.motion.Slide;

	import starling.events.Event;

	public class Main extends StackScreenNavigator
	{
		private static const STATION_SCREEN:String = "stationScreen";
		private static const TIMES_SCREEN:String = "timesScreen";

		public function Main()
		{
			super();
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			new TrainTimesTheme();

			var stationScreenItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(StationScreen);
			stationScreenItem.setScreenIDForPushEvent(Event.COMPLETE, TIMES_SCREEN);
			this.addScreen(STATION_SCREEN, stationScreenItem);

			var timesScreenItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(TimesScreen);
			timesScreenItem.addPopEvent(Event.COMPLETE);
			this.addScreen(TIMES_SCREEN, timesScreenItem);

			this.rootScreenID = STATION_SCREEN;

			this.pushTransition = Slide.createSlideLeftTransition();
			this.popTransition = Slide.createSlideRightTransition();
		}
	}
}


================================================
FILE: examples/TrainTimes/source/feathers/examples/trainTimes/controls/StationListItemRenderer.as
================================================
package feathers.examples.trainTimes.controls
{
	import feathers.controls.Button;
	import feathers.controls.ImageLoader;
	import feathers.controls.Label;
	import feathers.controls.LayoutGroup;
	import feathers.controls.List;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.core.FeathersControl;
	import feathers.examples.trainTimes.model.StationData;
	import feathers.skins.IStyleProvider;

	import flash.geom.Point;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.textures.Texture;

	public class StationListItemRenderer extends FeathersControl implements IListItemRenderer
	{
		public static const CHILD_STYLE_NAME_STATION_LIST_NAME_LABEL:String = "stationListNameLabel";
		public static const CHILD_STYLE_NAME_STATION_LIST_DETAILS_LABEL:String = "stationListDetailsLabel";
		public static const CHILD_STYLE_NAME_STATION_LIST_ACTION_CONTAINER:String = "stationListActionContainer";
		public static const CHILD_STYLE_NAME_STATION_LIST_CONFIRM_BUTTON:String = "stationListConfirmButton";
		public static const CHILD_STYLE_NAME_STATION_LIST_CANCEL_BUTTON:String = "stationListCancelButton";

		private static const HELPER_POINT:Point = new Point();
		private static const HELPER_TOUCHES_VECTOR:Vector.<Touch> = new <Touch>[];

		private static const DEPART_FROM_TEXT:String = "DEPART FROM";
		private static const DEPARTING_FROM_TEXT:String = "DEPARTING FROM";
		private static const TRAVEL_TO_TEXT:String = "TRAVEL TO";
		private static const QUESTION_MARK:String = "?";

		public static var globalStyleProvider:IStyleProvider;

		protected static function defaultLoaderFactory():ImageLoader
		{
			return new ImageLoader();
		}

		public function StationListItemRenderer()
		{
			this.addEventListener(TouchEvent.TOUCH, touchHandler);
		}

		override protected function get defaultStyleProvider():IStyleProvider
		{
			return StationListItemRenderer.globalStyleProvider;
		}

		protected var background:Quad;
		protected var actionContainer:LayoutGroup;
		protected var confirmButton:Button;
		protected var cancelButton:Button;
		protected var nameLabel:Label;
		protected var detailsLabel:Label;
		protected var icon:ImageLoader;

		protected var _touchPointID:int = -1;

		protected var _data:StationData;

		public function get data():Object
		{
			return this._data;
		}

		public function set data(value:Object):void
		{
			if(this._data == value)
			{
				return;
			}
			this._data = StationData(value);
			this.isSelectionWaitingToBeAnimated = false;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		protected var _index:int = -1;

		public function get index():int
		{
			return this._index;
		}

		public function set index(value:int):void
		{
			this._index = value;
		}

		/**
		 * @private
		 */
		private var _factoryID:String;

		/**
		 * @inheritDoc
		 */
		public function get factoryID():String
		{
			return this._factoryID;
		}

		/**
		 * @private
		 */
		public function set factoryID(value:String):void
		{
			this._factoryID = value;
		}

		protected var _isInDestinationPhase:Boolean = false;

		public function get isInDestinationPhase():Boolean
		{
			return this._isInDestinationPhase;
		}

		public function set isInDestinationPhase(value:Boolean):void
		{
			if(this._isInDestinationPhase == value)
			{
				return;
			}
			this._isInDestinationPhase = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		protected var _owner:List;

		public function get owner():List
		{
			return this._owner;
		}

		public function set owner(value:List):void
		{
			if(this._owner == value)
			{
				return;
			}
			if(this._owner)
			{
				this._owner.removeEventListener(Event.SCROLL, owner_scrollHandler);
			}
			this._owner = value;
			if(this._owner)
			{
				this._owner.addEventListener(Event.SCROLL, owner_scrollHandler);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		protected var isSelectionWaitingToBeAnimated:Boolean = false;

		protected var _isSelected:Boolean = false;

		public function get isSelected():Boolean
		{
			return this._isSelected;
		}

		public function set isSelected(value:Boolean):void
		{
			if(this._isSelected == value)
			{
				return;
			}
			this._isSelected = value;
			if(this.selectionTween)
			{
				Starling.juggler.remove(this.selectionTween);
				this.selectionTween = null;
			}
			this.isSelectionWaitingToBeAnimated = !this.isInvalid(INVALIDATION_FLAG_DATA) && !this._data.isDepartingFromHere;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
			this.dispatchEventWith(Event.CHANGE);
		}

		protected var _normalIconTexture:Texture;

		public function get normalIconTexture():Texture
		{
			return this._normalIconTexture;
		}

		public function set normalIconTexture(value:Texture):void
		{
			if(this._normalIconTexture == value)
			{
				return;
			}
			this._normalIconTexture = value;
			this.invalidate(INVALIDATION_FLAG_SKIN);
		}

		protected var _selectedIconTexture:Texture;

		public function get selectedIconTexture():Texture
		{
			return this._selectedIconTexture;
		}

		public function set selectedIconTexture(value:Texture):void
		{
			if(this._selectedIconTexture == value)
			{
				return;
			}
			this._selectedIconTexture = value;
			this.invalidate(INVALIDATION_FLAG_SKIN);
		}

		protected var _iconLoaderFactory:Function = defaultLoaderFactory;

		public function get iconLoaderFactory():Function
		{
			return this._iconLoaderFactory;
		}

		public function set iconLoaderFactory(value:Function):void
		{
			if(this._iconLoaderFactory == value)
			{
				return;
			}
			this._iconLoaderFactory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		protected var _paddingTop:Number = 0;

		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		public function set paddingTop(value:Number):void
		{
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		protected var _paddingRight:Number = 0;

		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		public function set paddingRight(value:Number):void
		{
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		protected var _paddingBottom:Number = 0;

		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		public function set paddingBottom(value:Number):void
		{
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		protected var _paddingLeft:Number = 0;

		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		public function set paddingLeft(value:Number):void
		{
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		protected var _gap:Number = 0;

		public function get gap():Number
		{
			return this._gap;
		}

		public function set gap(value:Number):void
		{
			if(this._gap == value)
			{
				return;
			}
			this._gap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		public var confirmCallback:Function;

		protected var selectionTween:Tween;

		override protected function initialize():void
		{
			this.background = new Quad(10, 10, 0x3b2a41);
			this.background.alpha = 0;
			this.addChild(this.background);

			this.detailsLabel = new Label();
			this.detailsLabel.styleNameList.add(CHILD_STYLE_NAME_STATION_LIST_DETAILS_LABEL);
			this.addChild(this.detailsLabel);

			this.nameLabel = new Label();
			this.nameLabel.styleNameList.add(CHILD_STYLE_NAME_STATION_LIST_NAME_LABEL);
			this.addChild(this.nameLabel);

			this.actionContainer = new LayoutGroup();
			this.actionContainer.styleNameList.add(CHILD_STYLE_NAME_STATION_LIST_ACTION_CONTAINER);
			this.actionContainer.visible = false;
			this.addChild(this.actionContainer);

			this.confirmButton = new Button();
			this.confirmButton.styleNameList.add(CHILD_STYLE_NAME_STATION_LIST_CONFIRM_BUTTON);
			this.confirmButton.addEventListener(Event.TRIGGERED, confirmButton_triggeredHandler);
			this.actionContainer.addChild(this.confirmButton);

			this.cancelButton = new Button();
			this.cancelButton.styleNameList.add(CHILD_STYLE_NAME_STATION_LIST_CANCEL_BUTTON);
			this.cancelButton.addEventListener(Event.TRIGGERED, cancelButton_triggeredHandler);
			this.actionContainer.addChild(this.cancelButton);
		}

		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var selectionInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SELECTED);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);

			if(stylesInvalid)
			{
				this.refreshIcon();
			}

			if(dataInvalid || selectionInvalid || stylesInvalid)
			{
				this.commitData();
			}

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;
			this.layout();
		}

		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = isNaN(this._explicitWidth);
			var needsHeight:Boolean = isNaN(this._explicitHeight);
			var needsMinWidth:Boolean = isNaN(this._explicitMinWidth);
			var needsMinHeight:Boolean = isNaN(this._explicitMinHeight);
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}
			this.icon.validate();
			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				newWidth = this.icon.width;
				newWidth += this._paddingLeft + this._paddingRight;
			}
			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				newHeight = this.icon.height;
			}
			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				newMinWidth = this.icon.width;
				newMinWidth += this._paddingLeft + this._paddingRight;
			}
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				newMinHeight = this.icon.height;
			}
			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		protected function refreshIcon():void
		{
			if(this.icon)
			{
				this.icon.removeFromParent(true);
			}

			this.icon = ImageLoader(this._iconLoaderFactory());
			this.addChild(this.icon);
		}

		protected function commitData():void
		{
			if(this._owner && this._data)
			{
				var nameLabelText:String = this._data.name;
				if(this._isSelected)
				{
					nameLabelText += QUESTION_MARK;
				}
				this.nameLabel.text = nameLabelText;

				var displayAsSelected:Boolean = this._isSelected || this._data.isDepartingFromHere;
				this.icon.source = displayAsSelected ? this._selectedIconTexture : this._normalIconTexture;

				if(this._data.isDepartingFromHere)
				{
					this.detailsLabel.text = DEPARTING_FROM_TEXT;
				}
				else if(this._isInDestinationPhase)
				{
					this.detailsLabel.text = TRAVEL_TO_TEXT;
				}
				else
				{
					this.detailsLabel.text = DEPART_FROM_TEXT;
				}

				if(!this.isSelectionWaitingToBeAnimated)
				{
					this.background.alpha = displayAsSelected ? 1 : 0;
				}
				if(!this.isSelectionWaitingToBeAnimated || displayAsSelected)
				{
					this.detailsLabel.visible = displayAsSelected;
				}
				//the action container will disappear after the departure
				//station has been selected, so it has different rules
				if(!this._data.isDepartingFromHere && (!this.isSelectionWaitingToBeAnimated || this._isSelected))
				{
					this.actionContainer.visible = this._isSelected;
					this.actionContainer.alpha = this._isSelected ? 1 : 0;
				}
			}
			else
			{
				this.nameLabel.text = null;
				this.detailsLabel.text = null;
				this.actionContainer.visible = false;
				this.background.alpha = 0;
				this.icon.source = null;
			}
		}

		protected function layout():void
		{
			this.background.width = this.actualWidth;
			this.background.height = this.actualHeight;

			this.icon.validate();
			this.icon.x = this._paddingLeft;
			var leftMarginWidth:Number = this._paddingLeft + this.icon.width + this._gap;
			var availableLabelWidth:Number = this.actualWidth - this._paddingRight - leftMarginWidth;
			var availableLabelHeight:Number = this.actualHeight - this._paddingTop - this._paddingBottom;

			this.actionContainer.width = availableLabelWidth;

			this.nameLabel.validate();
			this.detailsLabel.validate();
			this.actionContainer.validate();

			var displayAsSelected:Boolean = this._isSelected || (this._data && this._data.isDepartingFromHere);
			if((displayAsSelected && this.isSelectionWaitingToBeAnimated) ||
				(!displayAsSelected && !this.isSelectionWaitingToBeAnimated))
			{
				this.actionContainer.x = this.actualWidth;
				this.detailsLabel.alpha = 0;
				this.nameLabel.x = leftMarginWidth;
			}
			else
			{
				this.actionContainer.x = this.actualWidth - this.actionContainer.width;
				this.detailsLabel.alpha = 1;
				this.nameLabel.x = leftMarginWidth + (availableLabelWidth - this.nameLabel.width) / 2;
			}
			if(this.isSelectionWaitingToBeAnimated)
			{
				this.isSelectionWaitingToBeAnimated = false;
				this.selectionTween = new Tween(this.nameLabel, 0.35, Transitions.EASE_OUT);
				if(displayAsSelected)
				{
					this.selectionTween.animate("x", leftMarginWidth + (availableLabelWidth - this.nameLabel.width) / 2);
					this.selectionTween.onComplete = selectionTween_onSelectComplete;
				}
				else
				{
					this.selectionTween.animate("x", leftMarginWidth);
					this.selectionTween.onComplete = selectionTween_onDeselectComplete;
				}
				this.selectionTween.onUpdate = selectionTween_onUpdate;
				Starling.juggler.add(this.selectionTween);
			}
			else if(this._data && this._data.isDepartingFromHere && this.actionContainer.visible)
			{
				this.selectionTween = new Tween(this.actionContainer, 0.35, Transitions.EASE_OUT);
				this.selectionTween.fadeTo(0);
				this.selectionTween.onComplete = selectionTween_onConfirmComplete;
				Starling.juggler.add(this.selectionTween);
			}

			this.nameLabel.y = (availableLabelHeight - this.nameLabel.height) / 2;
			this.detailsLabel.x = leftMarginWidth + (availableLabelWidth - this.detailsLabel.width) / 2;
			this.detailsLabel.y = this.nameLabel.y - this.detailsLabel.height + this.detailsLabel.height - this.detailsLabel.baseline;
			this.actionContainer.y = this.actualHeight - this.actionContainer.height;
		}

		protected function selectionTween_onUpdate():void
		{
			var ratio:Number = this.selectionTween.transitionFunc(this.selectionTween.currentTime / this.selectionTween.totalTime);
			if(!this._isSelected)
			{
				ratio = 1 - ratio;
			}
			this.detailsLabel.alpha = this.background.alpha = ratio;
			this.actionContainer.x = this.actualWidth - this.actionContainer.width * ratio;
		}

		protected function selectionTween_onSelectComplete():void
		{
			this.selectionTween = null;
		}

		protected function selectionTween_onDeselectComplete():void
		{
			this.detailsLabel.visible = false;
			this.actionContainer.visible = false;
			this.selectionTween = null;
		}

		protected function selectionTween_onConfirmComplete():void
		{
			this.actionContainer.visible = false;
			this.selectionTween = null;
		}

		protected function touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				return;
			}

			var touches:Vector.<Touch> = event.getTouches(this, null, HELPER_TOUCHES_VECTOR);
			if(touches.length == 0)
			{
				//end of hover
				return;
			}
			if(this._touchPointID >= 0)
			{
				var touch:Touch;
				for each(var currentTouch:Touch in touches)
				{
					if(currentTouch.id == this._touchPointID)
					{
						touch = currentTouch;
						break;
					}
				}

				if(!touch)
				{
					//end of hover
					HELPER_TOUCHES_VECTOR.length = 0;
					return;
				}

				if(touch.phase == TouchPhase.ENDED)
				{
					this._touchPointID = -1;
					touch.getLocation(this, HELPER_POINT);
					var isInBounds:Boolean = this.hitTest(HELPER_POINT) !== null;
					if(isInBounds)
					{
						if(!this._isSelected && !this._data.isDepartingFromHere)
						{
							this.isSelected = true;
						}
					}
				}
			}
			else //if we get here, we don't have a saved touch ID yet
			{
				for each(touch in touches)
				{
					if(touch.phase == TouchPhase.BEGAN)
					{
						this._touchPointID = touch.id;
						break;
					}
				}
			}
			HELPER_TOUCHES_VECTOR.length = 0;
		}

		protected function owner_scrollHandler(event:Event):void
		{
			this._touchPointID = -1;
		}

		protected function confirmButton_triggeredHandler(event:Event):void
		{
			if(this.confirmCallback == null)
			{
				return;
			}
			this.confirmCallback();
		}

		protected function cancelButton_triggeredHandler(event:Event):void
		{
			this._owner.selectedIndex = -1;
		}
	}
}


================================================
FILE: examples/TrainTimes/source/feathers/examples/trainTimes/model/StationData.as
================================================
package feathers.examples.trainTimes.model
{
	public class StationData
	{
		public function StationData(name:String)
		{
			this.name = name;
		}

		public var name:String;
		public var isDepartingFromHere:Boolean = false;
	}
}


================================================
FILE: examples/TrainTimes/source/feathers/examples/trainTimes/model/TimeData.as
================================================
package feathers.examples.trainTimes.model
{
	public class TimeData
	{
		public function TimeData(trainNumber:int, departureTime:Date, arrivalTime:Date)
		{
			this.trainNumber = trainNumber;
			this.departureTime = departureTime;
			this.arrivalTime = arrivalTime;
		}

		public var trainNumber:int;
		public var departureTime:Date;
		public var arrivalTime:Date;
	}
}


================================================
FILE: examples/TrainTimes/source/feathers/examples/trainTimes/screens/StationScreen.as
================================================
package feathers.examples.trainTimes.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.Screen;
	import feathers.data.ListCollection;
	import feathers.data.VectorCollection;
	import feathers.examples.trainTimes.controls.StationListItemRenderer;
	import feathers.examples.trainTimes.model.StationData;

	import flash.events.KeyboardEvent;
	import flash.ui.Keyboard;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class StationScreen extends Screen
	{
		public static const CHILD_STYLE_NAME_STATION_LIST:String = "stationList";
		public static const CHILD_STYLE_NAME_STATION_LIST_ITEM_RENDERER:String = "stationListItemRenderer";
		public static const CHILD_STYLE_NAME_STATION_LIST_FIRST_ITEM_RENDERER:String = "stationListFirstItemRenderer";
		public static const CHILD_STYLE_NAME_STATION_LIST_LAST_ITEM_RENDERER:String = "stationListLastItemRenderer";
		
		private static const FIRST_ITEM_RENDERER_ID:String = "station-list-first-item-renderer";
		private static const LAST_ITEM_RENDERER_ID:String = "station-list-last-item-renderer";

		public function StationScreen()
		{
			this.addEventListener(Event.ADDED_TO_STAGE, addedToStageHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, removedFromStageHandler);
		}

		public var selectedDepartureStation:StationData;
		public var selectedDestinationStation:StationData;

		private var _departureHeader:Header;
		private var _destinationHeader:Header;
		private var _backButton:Button;
		private var _stationList:List;

		private var _headerTween:Tween;

		override protected function initialize():void
		{
			this._stationList = new List();
			this._stationList.styleNameList.add(CHILD_STYLE_NAME_STATION_LIST);
			this._stationList.dataProvider = new VectorCollection(new <StationData>
			[
				new StationData("Ten Stone Road"),
				new StationData("Birch Grove"),
				new StationData("East Elm Court"),
				new StationData("Oakheart Hills"),
				new StationData("Timber Ridge"),
				new StationData("Old Mine Heights"),
				new StationData("Granite Estates"),
			])
			this._stationList.itemRendererFactory = this.createItemRenderer;
			this._stationList.setItemRendererFactoryWithID(FIRST_ITEM_RENDERER_ID, this.createFirstItemRenderer);
			this._stationList.setItemRendererFactoryWithID(LAST_ITEM_RENDERER_ID, this.createLastItemRenderer);
			this._stationList.factoryIDFunction = this.factoryIDFunction;
			this.addChild(this._stationList);

			this._backButton = new Button();
			this._backButton.visible = false;
			this._backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);

			this._departureHeader = new Header();
			this._departureHeader.title = "Choose Departure Station";
			this.addChild(this._departureHeader);

			this._destinationHeader = new Header();
			this._destinationHeader.title = "Choose Destination Station";
			this._destinationHeader.leftItems = new <DisplayObject>
			[
				this._backButton
			];
			this.addChild(this._destinationHeader);
		}

		override protected function draw():void
		{
			this._departureHeader.width = this.actualWidth;
			this._destinationHeader.width = this.actualWidth;

			var currentHeader:Header;
			if(this.selectedDepartureStation)
			{
				currentHeader = this._destinationHeader;
				this._destinationHeader.x = 0;
				this._destinationHeader.visible = true;
				this._departureHeader.x = this.actualWidth;
				this._departureHeader.visible = false;
			}
			else
			{
				currentHeader = this._departureHeader;
				this._destinationHeader.x = -this.actualWidth;
				this._destinationHeader.visible = false;
				this._departureHeader.x = 0;
				this._departureHeader.visible = true;
			}

			currentHeader.validate();
			this._stationList.y = currentHeader.height;
			this._stationList.width = this.actualWidth;
			this._stationList.height = this.actualHeight - this._stationList.y;
		}

		private function factoryIDFunction(item:Object, index:int):String
		{
			if(index == 0)
			{
				return FIRST_ITEM_RENDERER_ID;
			}
			else if(index == this._stationList.dataProvider.length - 1)
			{
				return LAST_ITEM_RENDERER_ID;
			}
			return null;
		}
		
		private function createItemRenderer():StationListItemRenderer
		{
			var itemRenderer:StationListItemRenderer = new StationListItemRenderer();
			itemRenderer.styleNameList.add(CHILD_STYLE_NAME_STATION_LIST_ITEM_RENDERER);
			itemRenderer.confirmCallback = this.stationList_onConfirm;
			itemRenderer.isInDestinationPhase = false;
			return itemRenderer;
		}

		private function createFirstItemRenderer():StationListItemRenderer
		{
			var itemRenderer:StationListItemRenderer = new StationListItemRenderer();
			itemRenderer.styleNameList.add(CHILD_STYLE_NAME_STATION_LIST_FIRST_ITEM_RENDERER);
			itemRenderer.confirmCallback = this.stationList_onConfirm;
			itemRenderer.isInDestinationPhase = false;
			return itemRenderer;
		}

		private function createLastItemRenderer():StationListItemRenderer
		{
			var itemRenderer:StationListItemRenderer = new StationListItemRenderer();
			itemRenderer.styleNameList.add(CHILD_STYLE_NAME_STATION_LIST_LAST_ITEM_RENDERER);
			itemRenderer.confirmCallback = this.stationList_onConfirm;
			itemRenderer.isInDestinationPhase = false;
			return itemRenderer;
		}

		private function onBackButton():void
		{
			this.selectedDepartureStation.isDepartingFromHere = false;
			var index:int = this._stationList.dataProvider.getItemIndex(this.selectedDepartureStation);
			this._stationList.dataProvider.updateItemAt(index);
			this._stationList.selectedItem = this.selectedDepartureStation;
			this.selectedDepartureStation = null;
			this._backButton.visible = false;
			this._departureHeader.title = "Choose Departure Station";
			this._stationList.itemRendererProperties.isInDestinationPhase = false;

			this._departureHeader.visible = true;
			if(this._headerTween)
			{
				Starling.juggler.remove(this._headerTween);
				this._headerTween = null;
			}
			this._headerTween = new Tween(this._departureHeader, 0.4, Transitions.EASE_OUT);
			this._headerTween.animate("x", 0);
			this._headerTween.onUpdate = headerTween_onUpdate;
			this._headerTween.onComplete = headerTween_onDestinationHideComplete;
			Starling.juggler.add(this._headerTween);
		}

		private function stationList_onConfirm():void
		{
			if(this.selectedDepartureStation)
			{
				this.selectedDestinationStation = StationData(this._stationList.selectedItem);
				this.dispatchEventWith(Event.COMPLETE);
				return;
			}
			this.selectedDepartureStation = StationData(this._stationList.selectedItem);
			this.selectedDepartureStation.isDepartingFromHere = true;

			this._departureHeader.title = "Choose Destination Station";
			this._backButton.visible = true;

			this._stationList.selectedIndex = -1;
			this._stationList.itemRendererProperties.isInDestinationPhase = true;

			this._destinationHeader.visible = true;
			if(this._headerTween)
			{
				Starling.juggler.remove(this._headerTween);
				this._headerTween = null;
			}
			this._headerTween = new Tween(this._departureHeader, 0.4, Transitions.EASE_OUT);
			this._headerTween.animate("x", this.actualWidth);
			this._headerTween.onUpdate = headerTween_onUpdate;
			this._headerTween.onComplete = headerTween_onDestinationShowComplete;
			Starling.juggler.add(this._headerTween);
		}

		private function headerTween_onUpdate():void
		{
			this._destinationHeader.x = this._departureHeader.x - this.actualWidth;
		}

		private function headerTween_onDestinationShowComplete():void
		{
			this._departureHeader.visible = false;
			this._headerTween = null;
		}

		private function headerTween_onDestinationHideComplete():void
		{
			this._destinationHeader.visible = false;
			this._headerTween = null;
		}

		private function addedToStageHandler(event:Event):void
		{
			Starling.current.nativeStage.addEventListener(KeyboardEvent.KEY_DOWN, nativeStage_keyDownHandler, false, 0, true);
		}

		private function removedFromStageHandler(event:Event):void
		{
			Starling.current.nativeStage.removeEventListener(KeyboardEvent.KEY_DOWN, nativeStage_keyDownHandler);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}

		private function nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.keyCode == Keyboard.BACK && this.selectedDepartureStation)
			{
				event.preventDefault();
				this.onBackButton();
			}
		}
	}
}


================================================
FILE: examples/TrainTimes/source/feathers/examples/trainTimes/screens/TimesScreen.as
================================================
package feathers.examples.trainTimes.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ListCollection;
	import feathers.data.VectorCollection;
	import feathers.examples.trainTimes.model.TimeData;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;

	import starling.display.DisplayObject;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	public class TimesScreen extends PanelScreen
	{
		public static const CHILD_STYLE_NAME_TIMES_LIST:String = "timesList";

		private static const NORTH_TIMES:Vector.<TimeData> = new <TimeData>
		[
			new TimeData(281, new Date(2013, 2, 6, 13, 5), new Date(2013, 2, 6, 13, 19)),
			new TimeData(281, new Date(2013, 2, 6, 14, 5), new Date(2013, 2, 6, 14, 19)),
			new TimeData(281, new Date(2013, 2, 6, 15, 5), new Date(2013, 2, 6, 15, 19)),
			new TimeData(281, new Date(2013, 2, 6, 16, 5), new Date(2013, 2, 6, 16, 19)),
			new TimeData(281, new Date(2013, 2, 6, 17, 5), new Date(2013, 2, 6, 17, 21)),
			new TimeData(281, new Date(2013, 2, 6, 17, 35), new Date(2013, 2, 6, 17, 51)),
			new TimeData(281, new Date(2013, 2, 6, 18, 5), new Date(2013, 2, 6, 18, 21)),
			new TimeData(281, new Date(2013, 2, 6, 18, 35), new Date(2013, 2, 6, 18, 51)),
			new TimeData(281, new Date(2013, 2, 6, 19, 5), new Date(2013, 2, 6, 19, 21)),
			new TimeData(281, new Date(2013, 2, 6, 20, 1), new Date(2013, 2, 6, 20, 12)),
			new TimeData(281, new Date(2013, 2, 6, 20, 41), new Date(2013, 2, 6, 20, 52)),
			new TimeData(281, new Date(2013, 2, 6, 21, 41), new Date(2013, 2, 6, 21, 52)),
			new TimeData(281, new Date(2013, 2, 6, 22, 41), new Date(2013, 2, 6, 22, 52)),
			new TimeData(281, new Date(2013, 2, 6, 23, 41), new Date(2013, 2, 6, 23, 52)),
		];

		public function TimesScreen()
		{
			super();
		}

		private var _backButton:Button;
		private var _list:List;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Schedule";

			this.layout = new AnchorLayout();

			this._list = new List();
			this._list.styleNameList.add(CHILD_STYLE_NAME_TIMES_LIST);
			this._list.dataProvider = new VectorCollection(NORTH_TIMES);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.itemRendererFactory = this.customItemRendererFactory;
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = this.onBackButton;
		}

		private function customItemRendererFactory():IListItemRenderer
		{
			var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
			itemRenderer.labelFunction = list_labelFunction;
			return itemRenderer;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			this._backButton = new Button();
			this._backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
			header.leftItems = new <DisplayObject>
			[
				this._backButton
			];
			return header;
		}

		private function list_labelFunction(item:TimeData):String
		{
			var departureTime:Date = item.departureTime;
			var arrivalTime:Date = item.arrivalTime;
			var duration:int = (arrivalTime.getTime() - departureTime.getTime()) / 1000 / 60;
			return this.formatTimeAsString(departureTime) + "\t" + this.formatTimeAsString(arrivalTime) + "\t" +
				item.trainNumber + "\t" + duration + "mins";
		}

		private function formatTimeAsString(time:Date):String
		{
			var hours:Number = time.hours;
			var isAM:Boolean = hours < 12;
			var hoursAsString:String = ((isAM ? hours : (hours - 12)) + 1).toString();
			var minutes:Number = time.minutes;
			var minutesAsString:String = minutes < 10 ? "0" + minutes : minutes.toString();
			return hoursAsString + ":" + minutesAsString + (isAM ? "am" : "pm");
		}

		private function onBackButton():void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.onBackButton();
		}
	}
}


================================================
FILE: examples/TrainTimes/source/feathers/examples/trainTimes/themes/TrainTimesTheme.as
================================================
package feathers.examples.trainTimes.themes
{
	import feathers.controls.Button;
	import feathers.controls.Callout;
	import feathers.controls.Header;
	import feathers.controls.Label;
	import feathers.controls.LayoutGroup;
	import feathers.controls.List;
	import feathers.controls.SimpleScrollBar;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.text.StageTextTextEditor;
	import feathers.controls.text.TextFieldTextRenderer;
	import feathers.core.FeathersControl;
	import feathers.core.ITextEditor;
	import feathers.core.ITextRenderer;
	import feathers.core.PopUpManager;
	import feathers.examples.trainTimes.controls.StationListItemRenderer;
	import feathers.examples.trainTimes.screens.StationScreen;
	import feathers.examples.trainTimes.screens.TimesScreen;
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.VerticalAlign;
	import feathers.themes.StyleNameFunctionTheme;

	import flash.geom.Rectangle;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Image;
	import starling.display.Quad;
	import starling.events.ResizeEvent;
	import starling.text.TextFormat;
	import starling.textures.Texture;
	import starling.textures.TextureAtlas;
	import starling.utils.Align;

	public class TrainTimesTheme extends StyleNameFunctionTheme
	{
		[Embed(source="/../assets/images/traintimes.png")]
		protected static const ATLAS_IMAGE:Class;

		[Embed(source="/../assets/images/traintimes.xml",mimeType="application/octet-stream")]
		protected static const ATLAS_XML:Class;

		[Embed(source="/../assets/fonts/SourceSansPro-Regular.ttf",fontName="SourceSansPro",mimeType="application/x-font",embedAsCFF="false")]
		protected static const SOURCE_SANS_PRO_REGULAR:Class;

		[Embed(source="/../assets/fonts/SourceSansPro-Bold.ttf",fontName="SourceSansProBold",fontWeight="bold",mimeType="application/x-font",embedAsCFF="false")]
		protected static const SOURCE_SANS_PRO_BOLD:Class;

		[Embed(source="/../assets/fonts/SourceSansPro-BoldIt.ttf",fontName="SourceSansProBoldItalic",fontWeight="bold",fontStyle="italic",mimeType="application/x-font",embedAsCFF="false")]
		protected static const SOURCE_SANS_PRO_BOLD_ITALIC:Class;

		protected static const TIMES_LIST_ITEM_RENDERER_NAME:String = "traintimes-times-list-item-renderer";

		protected static const HEADER_SCALE9_GRID:Rectangle = new Rectangle(1, 1, 1, 1);
		protected static const HORIZONTAL_SCROLL_BAR_THUMB_SCALE9_GRID:Rectangle = new Rectangle(3, 0, 7, 4);
		protected static const VERTICAL_SCROLL_BAR_THUMB_SCALE9_GRID:Rectangle = new Rectangle(0, 3, 4, 7);

		protected static const PRIMARY_TEXT_COLOR:uint = 0xe8caa4;
		protected static const DETAIL_TEXT_COLOR:uint = 0x64908a;

		protected static function textRendererFactory():ITextRenderer
		{
			var renderer:TextFieldTextRenderer = new TextFieldTextRenderer();
			renderer.embedFonts = true;
			return renderer;
		}

		protected static function textEditorFactory():ITextEditor
		{
			return new StageTextTextEditor();
		}

		protected static function popUpOverlayFactory():DisplayObject
		{
			var quad:Quad = new Quad(100, 100, 0x1a1a1a);
			quad.alpha = 0.85;
			return quad;
		}

		public function TrainTimesTheme()
		{
			super();
			this.initialize();
		}

		protected var primaryBackground:Image;

		protected var defaultTextFormat:TextFormat;
		protected var selectedTextFormat:TextFormat;
		protected var headerTitleTextFormat:TextFormat;
		protected var stationListNameTextFormat:TextFormat;
		protected var stationListDetailTextFormat:TextFormat;

		protected var atlas:TextureAtlas;
		protected var mainBackgroundTexture:Texture;
		protected var headerBackgroundTexture:Texture;
		protected var stationListNormalIconTexture:Texture;
		protected var stationListFirstNormalIconTexture:Texture;
		protected var stationListLastNormalIconTexture:Texture;
		protected var stationListSelectedIconTexture:Texture;
		protected var stationListFirstSelectedIconTexture:Texture;
		protected var stationListLastSelectedIconTexture:Texture;
		protected var confirmIconTexture:Texture;
		protected var cancelIconTexture:Texture;
		protected var backIconTexture:Texture;
		protected var horizontalScrollBarThumbSkinTexture:Texture;
		protected var verticalScrollBarThumbSkinTexture:Texture;

		override public function dispose():void
		{
			if(this.primaryBackground)
			{
				Starling.current.stage.removeEventListener(ResizeEvent.RESIZE, stage_resizeHandler);
				Starling.current.stage.removeChild(this.primaryBackground, true);
				this.primaryBackground = null;
			}
			if(this.atlas)
			{
				this.atlas.dispose();
				this.atlas = null;
			}
			super.dispose();
		}

		protected function initialize():void
		{
			this.initializeGlobals();
			this.initializeTextures();
			this.initializeStage();
			this.initializeStyleProviders();
		}

		protected function initializeStage():void
		{
			this.primaryBackground = new Image(this.mainBackgroundTexture);
			this.primaryBackground.tileGrid = new Rectangle();
			this.primaryBackground.width = Starling.current.stage.stageWidth;
			this.primaryBackground.height = Starling.current.stage.stageHeight;
			Starling.current.stage.addChildAt(this.primaryBackground, 0);
			Starling.current.stage.addEventListener(ResizeEvent.RESIZE, stage_resizeHandler);
		}

		protected function initializeGlobals():void
		{
			FeathersControl.defaultTextRendererFactory = textRendererFactory;
			FeathersControl.defaultTextEditorFactory = textEditorFactory;

			PopUpManager.overlayFactory = popUpOverlayFactory;
			Callout.stagePaddingTop = Callout.stagePaddingRight = Callout.stagePaddingBottom =
				Callout.stagePaddingLeft = 8;
		}

		protected function initializeTextures():void
		{
			var atlasTexture:Texture = Texture.fromEmbeddedAsset(ATLAS_IMAGE, false, false, 2);
			this.atlas = new TextureAtlas(atlasTexture, XML(new ATLAS_XML()));

			this.mainBackgroundTexture = this.atlas.getTexture("main-background");
			this.headerBackgroundTexture = this.atlas.getTexture("header-background");
			this.stationListNormalIconTexture = this.atlas.getTexture("station-list-normal-icon");
			this.stationListFirstNormalIconTexture = this.atlas.getTexture("station-list-first-normal-icon");
			this.stationListLastNormalIconTexture = this.atlas.getTexture("station-list-last-normal-icon");
			this.stationListSelectedIconTexture = this.atlas.getTexture("station-list-selected-icon");
			this.stationListFirstSelectedIconTexture = this.atlas.getTexture("station-list-first-selected-icon");
			this.stationListLastSelectedIconTexture = this.atlas.getTexture("station-list-last-selected-icon");
			this.confirmIconTexture = this.atlas.getTexture("confirm-icon");
			this.cancelIconTexture = this.atlas.getTexture("cancel-icon");
			this.backIconTexture = this.atlas.getTexture("back-icon");
			this.horizontalScrollBarThumbSkinTexture = this.atlas.getTexture("horizontal-scroll-bar-thumb-skin");
			this.verticalScrollBarThumbSkinTexture = this.atlas.getTexture("vertical-scroll-bar-thumb-skin");

			//we need to use different font names because Flash runtimes seem to
			//have a bug where setting defaultTextFormat on a TextField with a
			//different TextFormat that has the same font name as the existing
			//defaultTextFormat value causes the new TextFormat to be ignored,
			//even if the new TextFormat has different bold or italic values.
			//wtf, right?
			var regularFontName:String = "SourceSansPro";
			var boldFontName:String = "SourceSansProBold";
			var boldItalicFontName:String = "SourceSansProBoldItalic";
			this.defaultTextFormat = new TextFormat(regularFontName, 18, PRIMARY_TEXT_COLOR, Align.LEFT, Align.TOP);
			this.selectedTextFormat = new TextFormat(boldFontName, 18, PRIMARY_TEXT_COLOR, Align.LEFT, Align.TOP);
			this.selectedTextFormat.bold = true;
			this.headerTitleTextFormat = new TextFormat(regularFontName, 18, PRIMARY_TEXT_COLOR, Align.LEFT, Align.TOP);
			this.stationListNameTextFormat = new TextFormat(boldItalicFontName, 24, PRIMARY_TEXT_COLOR, Align.LEFT, Align.TOP);
			this.stationListNameTextFormat.bold = true;
			this.stationListNameTextFormat.italic = true;
			this.stationListDetailTextFormat = new TextFormat(boldFontName, 12, DETAIL_TEXT_COLOR, Align.LEFT, Align.TOP);
			this.stationListDetailTextFormat.bold = true;
			this.stationListDetailTextFormat.letterSpacing = 3;
		}

		protected function initializeStyleProviders():void
		{
			this.getStyleProviderForClass(Button).defaultStyleFunction = setButtonStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(StationListItemRenderer.CHILD_STYLE_NAME_STATION_LIST_CONFIRM_BUTTON, setConfirmButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(StationListItemRenderer.CHILD_STYLE_NAME_STATION_LIST_CANCEL_BUTTON, setCancelButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SimpleScrollBar.DEFAULT_CHILD_STYLE_NAME_THUMB, setNoStyles);
			this.getStyleProviderForClass(Label).defaultStyleFunction = setLabelStyles;
			this.getStyleProviderForClass(Label).setFunctionForStyleName(StationListItemRenderer.CHILD_STYLE_NAME_STATION_LIST_NAME_LABEL, setStationListNameLabelStyles);
			this.getStyleProviderForClass(Label).setFunctionForStyleName(StationListItemRenderer.CHILD_STYLE_NAME_STATION_LIST_DETAILS_LABEL, setStationListDetailLabelStyles);
			this.getStyleProviderForClass(Header).defaultStyleFunction = setHeaderStyles;
			this.getStyleProviderForClass(List).setFunctionForStyleName(StationScreen.CHILD_STYLE_NAME_STATION_LIST, setStationListStyles);
			this.getStyleProviderForClass(List).setFunctionForStyleName(TimesScreen.CHILD_STYLE_NAME_TIMES_LIST, setTimesListStyles);
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(TIMES_LIST_ITEM_RENDERER_NAME, setTimesListItemRendererStyles);
			this.getStyleProviderForClass(StationListItemRenderer).setFunctionForStyleName(StationScreen.CHILD_STYLE_NAME_STATION_LIST_ITEM_RENDERER, setStationListItemRendererStyles);
			this.getStyleProviderForClass(StationListItemRenderer).setFunctionForStyleName(StationScreen.CHILD_STYLE_NAME_STATION_LIST_FIRST_ITEM_RENDERER, setStationListFirstItemRendererStyles);
			this.getStyleProviderForClass(StationListItemRenderer).setFunctionForStyleName(StationScreen.CHILD_STYLE_NAME_STATION_LIST_LAST_ITEM_RENDERER, setStationListLastItemRendererStyles);
			this.getStyleProviderForClass(LayoutGroup).setFunctionForStyleName(StationListItemRenderer.CHILD_STYLE_NAME_STATION_LIST_ACTION_CONTAINER, setActionContainerStyles);
		}

		protected function horizontalScrollBarFactory():SimpleScrollBar
		{
			var scrollBar:SimpleScrollBar = new SimpleScrollBar();
			scrollBar.direction = Direction.HORIZONTAL;
			var defaultSkin:Image = new Image(this.horizontalScrollBarThumbSkinTexture);
			defaultSkin.scale9Grid = HORIZONTAL_SCROLL_BAR_THUMB_SCALE9_GRID;
			defaultSkin.width = 5;
			scrollBar.thumbProperties.defaultSkin = defaultSkin;
			scrollBar.paddingRight = scrollBar.paddingBottom = scrollBar.paddingLeft = 2;
			return scrollBar;
		}

		protected function verticalScrollBarFactory():SimpleScrollBar
		{
			var scrollBar:SimpleScrollBar = new SimpleScrollBar();
			scrollBar.direction = Direction.VERTICAL;
			var defaultSkin:Image = new Image(this.verticalScrollBarThumbSkinTexture);
			defaultSkin.scale9Grid = VERTICAL_SCROLL_BAR_THUMB_SCALE9_GRID;
			defaultSkin.height = 5;
			scrollBar.thumbProperties.defaultSkin = defaultSkin;
			scrollBar.paddingTop = scrollBar.paddingRight = scrollBar.paddingBottom = 2;
			return scrollBar;
		}

		protected function setNoStyles(target:DisplayObject):void {}

		protected function setLabelStyles(label:Label):void
		{
			label.fontStyles = this.defaultTextFormat;
		}

		protected function setStationListNameLabelStyles(label:Label):void
		{
			label.fontStyles = this.stationListNameTextFormat;
		}

		protected function setStationListDetailLabelStyles(label:Label):void
		{
			label.fontStyles = this.stationListDetailTextFormat;
		}

		protected function setButtonStyles(button:Button):void
		{
			var defaultIcon:Image = new Image(this.backIconTexture);
			button.defaultIcon = defaultIcon;
			button.minWidth = button.minHeight = 22;
			button.minTouchWidth = button.minTouchHeight = 44;
		}

		protected function setConfirmButtonStyles(button:Button):void
		{
			var defaultIcon:Image = new Image(this.confirmIconTexture);
			button.defaultIcon = defaultIcon;
			button.minWidth = button.minHeight = 22;
			button.minTouchWidth = button.minTouchHeight = 44;
		}

		protected function setCancelButtonStyles(button:Button):void
		{
			var defaultIcon:Image = new Image(this.cancelIconTexture);
			button.defaultIcon = defaultIcon;
			button.minWidth = button.minHeight = 22;
			button.minTouchWidth = button.minTouchHeight = 44;
		}

		protected function setHeaderStyles(header:Header):void
		{
			header.useExtraPaddingForOSStatusBar = true;
			
			header.minWidth = 44;
			header.minHeight = 44;
			header.padding = 7;
			header.titleAlign = HorizontalAlign.RIGHT;

			var backgroundSkin:Image = new Image(this.headerBackgroundTexture);
			backgroundSkin.scale9Grid = HEADER_SCALE9_GRID;
			header.backgroundSkin = backgroundSkin;
			
			header.fontStyles = this.headerTitleTextFormat;
		}

		protected function setStationListStyles(list:List):void
		{
			list.horizontalScrollBarFactory = this.horizontalScrollBarFactory;
			list.verticalScrollBarFactory = this.verticalScrollBarFactory;
		}

		protected function setTimesListStyles(list:List):void
		{
			list.horizontalScrollBarFactory = this.horizontalScrollBarFactory;
			list.verticalScrollBarFactory = this.verticalScrollBarFactory;
			list.customItemRendererStyleName = TIMES_LIST_ITEM_RENDERER_NAME;
		}

		protected function setTimesListItemRendererStyles(renderer:DefaultListItemRenderer):void
		{
			var defaultSkin:Quad = new Quad(44, 44, 0xff00ff);
			defaultSkin.alpha = 0;
			renderer.defaultSkin = defaultSkin;
			var defaultSelectedSkin:Quad = new Quad(44, 44, 0xcc2a41);
			renderer.defaultSelectedSkin = defaultSelectedSkin;
			renderer.fontStyles = this.defaultTextFormat;
			renderer.selectedFontStyles = this.selectedTextFormat;
			renderer.paddingLeft = 4;
			renderer.paddingRight = 8;
		}

		protected function setStationListItemRendererStyles(renderer:StationListItemRenderer):void
		{
			renderer.paddingLeft = 22;
			renderer.paddingRight = 16;
			renderer.normalIconTexture = this.stationListNormalIconTexture;
			renderer.selectedIconTexture = this.stationListSelectedIconTexture;
		}

		protected function setStationListFirstItemRendererStyles(renderer:StationListItemRenderer):void
		{
			renderer.paddingLeft = 22;
			renderer.paddingRight = 16;
			renderer.normalIconTexture = this.stationListFirstNormalIconTexture;
			renderer.selectedIconTexture = this.stationListFirstSelectedIconTexture;
		}

		protected function setStationListLastItemRendererStyles(renderer:StationListItemRenderer):void
		{
			renderer.paddingLeft = 22;
			renderer.paddingRight = 16;
			renderer.normalIconTexture = this.stationListLastNormalIconTexture;
			renderer.selectedIconTexture = this.stationListLastSelectedIconTexture;
		}

		protected function setActionContainerStyles(container:LayoutGroup):void
		{
			var backgroundSkin:Quad = new Quad(24, 24, 0xcc2a41);
			container.backgroundSkin = backgroundSkin;

			var layout:HorizontalLayout = new HorizontalLayout();
			layout.paddingRight = 16;
			layout.gap = 24;
			layout.horizontalAlign = HorizontalAlign.CENTER;
			layout.verticalAlign = VerticalAlign.MIDDLE;
			container.layout = layout;
		}

		protected function stage_resizeHandler(event:ResizeEvent):void
		{
			this.primaryBackground.width = event.width;
			this.primaryBackground.height = event.height;
		}
	}
}


================================================
FILE: examples/TransitionsExplorer/README.md
================================================
# Feathers Transitions Explorer

Each of the animated transitions available for the [Feathers](http://feathersui.com/) [`StackScreenNavigator`](http://feathersui.com/help/stack-screen-navigator.html) and [`ScreenNavigator`](http://feathersui.com/help/screen-navigator.html)components, presented as a mobile app.

## Requirements

In addition to Starling Framework and Feathers, this example project requires the `MetalWorksMobileTheme` example theme. You can find the SWC file for this theme at the following location in the Feathers release build:

	themes/MetalWorksMobileTheme/swc/MetalWorksMobileTheme.swc

## Web Demo

View the [Transitions Explorer](http://feathersui.com/examples/transitions-explorer/) in your browser.

================================================
FILE: examples/TransitionsExplorer/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
theme.root = ${basedir}/../../themes/MetalWorksMobileTheme/source
output.path = ${basedir}/output
icon.path = ${basedir}/../shared-assets/icons
launch.image.path = ${basedir}/assets/launch-images

swf.version = 30

================================================
FILE: examples/TransitionsExplorer/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="transitions-explorer" default="build" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<target name="build" depends="build-web,build-android,build-ios"/>

	<target name="prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="build-web" depends="prepare">
		<echo message="Building TransitionsExplorerWeb.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-advanced-telemetry=true"/>
			<arg value="-frame=two,feathers.examples.transitionsExplorer.Main"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/TransitionsExplorerWeb.as"/>
			<arg value="-output=${output.path}/TransitionsExplorerWeb.swf"/>
		</java>
	</target>
	<target name="build-air-swf" depends="prepare">
		<echo message="Building TransitionsExplorer.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-advanced-telemetry=true"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/TransitionsExplorer.as"/>
			<arg value="-output=${output.path}/TransitionsExplorer.swf"/>
		</java>
	</target>
	<target name="-check-ios-properties">
		<fail unless="ios.provision.path"/>
		<fail unless="ios.certificate.path"/>
		<fail unless="ios.certificate.password"/>
	</target>
	<target name="build-ios" depends="-check-ios-properties,build-air-swf">
		<echo message="Packaging TransitionsExplorer.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="ipa-app-store"/>
			<!-- uncomment to use the new, faster compiling for ios -->
			<!--<arg value="-useLegacyAOT"/>
			<arg value="no"/>-->
			<!-- uncomment for actionscript sampling with scout on ios -->
			<!--<arg value="-sampler"/>-->
			<arg value="-provisioning-profile"/>
			<arg value="${ios.provision.path}"/>
			<arg value="-keystore"/>
			<arg value="${ios.certificate.path}"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-storepass"/>
			<arg value="${ios.certificate.password}"/>
			<arg value="${output.path}/TransitionsExplorer.ipa"/>
			<arg value="source/TransitionsExplorer-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${launch.image.path}"/>
			<arg value="Default~iphone.png"/>							<!-- iphone 3gs -->
			<arg value="Default@2x~iphone.png"/>						<!-- iphone 4/4s -->
			<arg value="Default-568h@2x~iphone.png"/>					<!-- iphone 5/5c/5s -->
			<arg value="Default-375w-667h@2x~iphone.png"/>				<!-- iphone 6/7/8 -->
			<arg value="Default-812h@3x~iphone.png"/>					<!-- iphone x (portrait) -->
			<arg value="Default-Landscape-812h@3x~iphone.png"/>			<!-- iphone x (landscape) -->
			<arg value="Default-414w-736h@3x~iphone.png"/>				<!-- iphone 6/7/8 plus (portrait) -->
			<arg value="Default-Landscape-414w-736h@3x~iphone.png"/>	<!-- iphone 6/7/8 plus (landscape) -->
			<arg value="Default-Portrait~ipad.png"/>					<!-- ipad 1/2 (portrait) -->
			<arg value="Default-PortraitUpsideDown~ipad.png"/>			<!-- ipad 1/2 (portrait upside down) -->
			<arg value="Default-Landscape~ipad.png"/>					<!-- ipad 1/2 (landscape left) -->
			<arg value="Default-LandscapeRight~ipad.png"/>				<!-- ipad 1/2 (landscape right) -->
			<arg value="Default-Portrait@2x~ipad.png"/>					<!-- ipad 3/air (portrait) -->
			<arg value="Default-LandscapeLeft@2x~ipad.png"/>			<!-- ipad 3/air (landscape left) -->
			<arg value="Default-LandscapeRight@2x~ipad.png"/>			<!-- ipad 3/air (landscape right) -->
			<arg value="Default-Portrait@2x.png"/>						<!-- ipad pro (portrait) -->
			<arg value="Default-Landscape@2x.png"/>						<!-- ipad pro (landscape) -->
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="TransitionsExplorer.swf"/>
		</java>
	</target>
	<target name="-check-android-properties">
		<fail unless="android.certificate.path"/>
		<fail unless="android.certificate.password"/>
	</target>
	<target name="build-android" depends="-check-android-properties,build-air-swf">
		<echo message="Packaging TransitionsExplorer.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="apk-captive-runtime"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-keystore"/>
			<arg value="${android.certificate.path}"/>
			<arg value="-storepass"/>
			<arg value="${android.certificate.password}"/>
			<arg value="${output.path}/TransitionsExplorer.apk"/>
			<arg value="source/TransitionsExplorer-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="TransitionsExplorer.swf"/>
		</java>
	</target>
	<target name="install-android">
		<echo message="Installing TransitionsExplorer.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.TransitionsExplorer"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-package"/>
			<arg value="${output.path}/TransitionsExplorer.apk"/>
		</java>
	</target>
	<target name="install-ios">
		<echo message="Installing TransitionsExplorer.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.TransitionsExplorer"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-package"/>
			<arg value="${output.path}/TransitionsExplorer.ipa"/>
		</java>
	</target>
</project>

================================================
FILE: examples/TransitionsExplorer/source/TransitionsExplorer-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.examples.TransitionsExplorer</id>
	<filename>Transitions</filename>
	<name>Transitions</name>
	<versionNumber>4.2.0</versionNumber>
	<description>Transitions Explorer example application built with Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>TransitionsExplorer.swf</content>
		<aspectRatio>landscape</aspectRatio>
		<fullScreen>true</fullScreen>
		<visible>true</visible>
		<renderMode>direct</renderMode>
		<depthAndStencil>true</depthAndStencil>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>

	<icon>
		<image29x29>icon29.png</image29x29>
		<image48x48>icon48.png</image48x48>
		<image50x50>icon50.png</image50x50>
		<image57x57>icon57.png</image57x57>
		<image58x58>icon58.png</image58x58>
		<image72x72>icon72.png</image72x72>
		<image87x87>icon87.png</image87x87>
		<image96x96>icon96.png</image96x96>
		<image100x100>icon100.png</image100x100>
		<image114x114>icon114.png</image114x114>
		<image128x128>icon128.png</image128x128>
		<image144x144>icon144.png</image144x144>
		<image180x180>icon180.png</image180x180>
	</icon>
	<android>
		<colorDepth>16bit</colorDepth>
		<manifestAdditions><![CDATA[
			<manifest android:installLocation="auto">
			    <uses-permission android:name="android.permission.INTERNET"/>
			</manifest>
		]]></manifestAdditions>
	</android>
	<iPhone>
		<InfoAdditions>
		<![CDATA[
			<key>UIDeviceFamily</key> 
			<array> 
				<string>1</string>
				<string>2</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<true/>
			<key>UIStatusBarStyle</key>
			<string>UIStatusBarStyleLightContent</string>
		]]> 
		</InfoAdditions>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</iPhone>
</application>

================================================
FILE: examples/TransitionsExplorer/source/TransitionsExplorer.as
================================================
package
{
	import feathers.examples.transitionsExplorer.Main;
	import feathers.utils.ScreenDensityScaleFactorManager;

	import flash.display.Loader;
	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.display3D.Context3DProfile;
	import flash.display3D.Context3DRenderMode;
	import flash.events.Event;
	import flash.filesystem.File;
	import flash.filesystem.FileMode;
	import flash.filesystem.FileStream;
	import flash.system.Capabilities;
	import flash.utils.ByteArray;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class TransitionsExplorer extends Sprite
	{
		public function TransitionsExplorer()
		{
			if(this.stage)
			{
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
				this.stage.align = StageAlign.TOP_LEFT;
			}
			this.mouseEnabled = this.mouseChildren = false;
			this.showLaunchImage();
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;
		private var _scaler:ScreenDensityScaleFactorManager;
		private var _launchImage:Loader;

		private function showLaunchImage():void
		{
			var filePath:String;
			var isPortraitOnly:Boolean = false;
			if(Capabilities.manufacturer.indexOf("iOS") >= 0)
			{
				if(Capabilities.screenResolutionX == 1242 && Capabilities.screenResolutionY == 2208)
				{
					//iphone 6 plus
					filePath = "Default-414w-736h-Landscape@3x.png";
				}
				else if(Capabilities.screenResolutionX == 1536 && Capabilities.screenResolutionY == 2048)
				{
					//ipad retina
					filePath = "Default-Landscape@2x.png";
				}
				else if(Capabilities.screenResolutionX == 768 && Capabilities.screenResolutionY == 1024)
				{
					//ipad classic
					filePath = "Default-Landscape.png";
				}
				else if(Capabilities.screenResolutionX == 750)
				{
					//iphone 6
					isPortraitOnly = true;
					filePath = "Default-375w-667h@2x.png";
				}
				else if(Capabilities.screenResolutionX == 640)
				{
					//iphone retina
					isPortraitOnly = true;
					if(Capabilities.screenResolutionY == 1136)
					{
						filePath = "Default-568h@2x.png";
					}
					else
					{
						filePath = "Default@2x.png";
					}
				}
				else if(Capabilities.screenResolutionX == 320)
				{
					//iphone classic
					isPortraitOnly = true;
					filePath = "Default.png";
				}
			}

			if(filePath)
			{
				var file:File = File.applicationDirectory.resolvePath(filePath);
				if(file.exists)
				{
					var bytes:ByteArray = new ByteArray();
					var stream:FileStream = new FileStream();
					stream.open(file, FileMode.READ);
					stream.readBytes(bytes, 0, stream.bytesAvailable);
					stream.close();
					this._launchImage = new Loader();
					this._launchImage.loadBytes(bytes);
					if(isPortraitOnly)
					{
						this._launchImage.rotation = -90;
						this._launchImage.y = Capabilities.screenResolutionX;
					}
					this.addChild(this._launchImage);
				}
			}
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(Main, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE);
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.start();
			if(this._launchImage)
			{
				this._starling.addEventListener("rootCreated", starling_rootCreatedHandler);
			}
			this._scaler = new ScreenDensityScaleFactorManager(this._starling);

			this.stage.addEventListener(Event.DEACTIVATE, stage_deactivateHandler, false, 0, true);
		}

		private function starling_rootCreatedHandler(event:Object):void
		{
			if(this._launchImage)
			{
				this.removeChild(this._launchImage);
				this._launchImage.unloadAndStop(true);
				this._launchImage = null;
			}
		}

		private function stage_deactivateHandler(event:Event):void
		{
			this._starling.stop(true);
			this.stage.addEventListener(Event.ACTIVATE, stage_activateHandler, false, 0, true);
		}

		private function stage_activateHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.ACTIVATE, stage_activateHandler);
			this._starling.start();
		}

	}
}

================================================
FILE: examples/TransitionsExplorer/source/TransitionsExplorerWeb.as
================================================
package
{
	import feathers.system.DeviceCapabilities;

	import flash.display.MovieClip;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.events.Event;
	import flash.geom.Rectangle;
	import flash.ui.ContextMenu;
	import flash.utils.getDefinitionByName;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class TransitionsExplorerWeb extends MovieClip
	{
		public function TransitionsExplorerWeb()
		{
			var menu:ContextMenu = new ContextMenu();
			menu.hideBuiltInItems();
			this.contextMenu = menu;

			if(this.stage)
			{
				this.stage.align = StageAlign.TOP_LEFT;
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
			}

			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;

		private function start():void
		{
			this.gotoAndStop(2);
			this.graphics.clear();

			//simulating iPhone Retina
			DeviceCapabilities.dpi = 326;

			Starling.multitouchEnabled = true;
			var MainType:Class = getDefinitionByName("feathers.examples.transitionsExplorer.Main") as Class;
			this._starling = new Starling(MainType, this.stage, new Rectangle(0, 0, 960, 640));
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.stage.stageWidth = 480;
			this._starling.stage.stageHeight = 320;
			this._starling.start();
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			this.start();
		}
	}
}

================================================
FILE: examples/TransitionsExplorer/source/feathers/examples/transitionsExplorer/Main.as
================================================
package feathers.examples.transitionsExplorer
{
	import feathers.controls.AutoSizeMode;
	import feathers.controls.ImageLoader;
	import feathers.controls.LayoutGroup;
	import feathers.controls.ScreenNavigator;
	import feathers.controls.ScreenNavigatorItem;
	import feathers.controls.StackScreenNavigator;
	import feathers.controls.StackScreenNavigatorItem;
	import feathers.examples.transitionsExplorer.screens.AllTransitionsScreen;
	import feathers.examples.transitionsExplorer.screens.ColorFadeTransitionScreen;
	import feathers.examples.transitionsExplorer.screens.FadeTransitionScreen;
	import feathers.examples.transitionsExplorer.screens.FourWayTransitionScreen;
	import feathers.examples.transitionsExplorer.screens.IrisTransitionScreen;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.motion.Cover;
	import feathers.motion.Cube;
	import feathers.motion.Flip;
	import feathers.motion.Reveal;
	import feathers.motion.Slide;
	import feathers.motion.Wipe;
	import feathers.themes.MetalWorksMobileTheme;

	import starling.display.Quad;
	import starling.events.Event;
	import starling.textures.Texture;

	public class Main extends LayoutGroup
	{
		[Embed(source="/../assets/images/test-pattern1.png")]
		private static const TEST_PATTERN1:Class;

		[Embed(source="/../assets/images/test-pattern2.png")]
		private static const TEST_PATTERN2:Class;

		private static const MENU_SCREEN_ID_ALL_TRANSITIONS:String = "allTransitions";
		private static const MENU_SCREEN_ID_COLOR_FADE:String = "colorFade";
		private static const MENU_SCREEN_ID_COVER:String = "cover";
		private static const MENU_SCREEN_ID_CUBE:String = "cube";
		private static const MENU_SCREEN_ID_FADE:String = "fade";
		private static const MENU_SCREEN_ID_FLIP:String = "flip";
		private static const MENU_SCREEN_ID_IRIS:String = "iris";
		private static const MENU_SCREEN_ID_REVEAL:String = "reveal";
		private static const MENU_SCREEN_ID_SLIDE:String = "slide";
		private static const MENU_SCREEN_ID_WIPE:String = "wipe";

		private static const CONTENT_SCREEN_ID_ONE:String = "one";
		private static const CONTENT_SCREEN_ID_TWO:String = "two";

		public function Main()
		{
			//set up the theme right away!
			new MetalWorksMobileTheme();
			super();
			this.autoSizeMode = AutoSizeMode.STAGE;
		}

		private var _menu:StackScreenNavigator;
		private var _content:ScreenNavigator;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.layout = new AnchorLayout();

			this._menu = new StackScreenNavigator();
			this._menu.autoSizeMode = AutoSizeMode.CONTENT;
			var menuLayoutData:AnchorLayoutData = new AnchorLayoutData();
			menuLayoutData.top = 0;
			menuLayoutData.bottom = 0;
			menuLayoutData.left = 0;
			this._menu.width = this.stage.stageWidth / 3;
			this._menu.layoutData = new AnchorLayoutData(0, NaN, 0, 0);
			this._menu.clipContent = true;
			this.addChild(this._menu);

			var allTransitionsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(AllTransitionsScreen);
			allTransitionsItem.setScreenIDForPushEvent(AllTransitionsScreen.COVER, MENU_SCREEN_ID_COVER);
			allTransitionsItem.setScreenIDForPushEvent(AllTransitionsScreen.CUBE, MENU_SCREEN_ID_CUBE);
			allTransitionsItem.setScreenIDForPushEvent(AllTransitionsScreen.FADE, MENU_SCREEN_ID_FADE);
			allTransitionsItem.setScreenIDForPushEvent(AllTransitionsScreen.COLOR_FADE, MENU_SCREEN_ID_COLOR_FADE);
			allTransitionsItem.setScreenIDForPushEvent(AllTransitionsScreen.FLIP, MENU_SCREEN_ID_FLIP);
			allTransitionsItem.setScreenIDForPushEvent(AllTransitionsScreen.IRIS, MENU_SCREEN_ID_IRIS);
			allTransitionsItem.setScreenIDForPushEvent(AllTransitionsScreen.REVEAL, MENU_SCREEN_ID_REVEAL);
			allTransitionsItem.setScreenIDForPushEvent(AllTransitionsScreen.SLIDE, MENU_SCREEN_ID_SLIDE);
			allTransitionsItem.setScreenIDForPushEvent(AllTransitionsScreen.WIPE, MENU_SCREEN_ID_WIPE);
			this._menu.addScreen(MENU_SCREEN_ID_ALL_TRANSITIONS, allTransitionsItem);

			var colorFadeItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(ColorFadeTransitionScreen);
			colorFadeItem.setFunctionForPushEvent(ColorFadeTransitionScreen.TRANSITION, transitionHandler);
			colorFadeItem.addPopEvent(Event.COMPLETE);
			this._menu.addScreen(MENU_SCREEN_ID_COLOR_FADE, colorFadeItem);

			var coverItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(FourWayTransitionScreen);
			coverItem.properties.transitionName = "Cover";
			coverItem.properties.leftTransition = Cover.createCoverLeftTransition();
			coverItem.properties.rightTransition = Cover.createCoverRightTransition();
			coverItem.properties.upTransition = Cover.createCoverUpTransition();
			coverItem.properties.downTransition = Cover.createCoverDownTransition();
			coverItem.setFunctionForPushEvent(FourWayTransitionScreen.TRANSITION, transitionHandler);
			coverItem.addPopEvent(Event.COMPLETE);
			this._menu.addScreen(MENU_SCREEN_ID_COVER, coverItem);

			var cubeItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(FourWayTransitionScreen);
			cubeItem.properties.transitionName = "Cube";
			cubeItem.properties.leftTransition = Cube.createCubeLeftTransition();
			cubeItem.properties.rightTransition = Cube.createCubeRightTransition();
			cubeItem.properties.upTransition = Cube.createCubeUpTransition();
			cubeItem.properties.downTransition = Cube.createCubeDownTransition();
			cubeItem.setFunctionForPushEvent(FourWayTransitionScreen.TRANSITION, transitionHandler);
			cubeItem.addPopEvent(Event.COMPLETE);
			this._menu.addScreen(MENU_SCREEN_ID_CUBE, cubeItem);

			var fadeItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(FadeTransitionScreen);
			fadeItem.setFunctionForPushEvent(FourWayTransitionScreen.TRANSITION, transitionHandler);
			fadeItem.addPopEvent(Event.COMPLETE);
			this._menu.addScreen(MENU_SCREEN_ID_FADE, fadeItem);

			var flipItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(FourWayTransitionScreen);
			flipItem.properties.transitionName = "Flip";
			flipItem.properties.leftTransition = Flip.createFlipLeftTransition();
			flipItem.properties.rightTransition = Flip.createFlipRightTransition();
			flipItem.properties.upTransition = Flip.createFlipUpTransition();
			flipItem.properties.downTransition = Flip.createFlipDownTransition();
			flipItem.setFunctionForPushEvent(FourWayTransitionScreen.TRANSITION, transitionHandler);
			flipItem.addPopEvent(Event.COMPLETE);
			this._menu.addScreen(MENU_SCREEN_ID_FLIP, flipItem);

			var irisItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(IrisTransitionScreen);
			irisItem.setFunctionForPushEvent(IrisTransitionScreen.TRANSITION, transitionHandler);
			irisItem.addPopEvent(Event.COMPLETE);
			this._menu.addScreen(MENU_SCREEN_ID_IRIS, irisItem);

			var revealItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(FourWayTransitionScreen);
			revealItem.properties.transitionName = "Reveal";
			revealItem.properties.leftTransition = Reveal.createRevealLeftTransition();
			revealItem.properties.rightTransition = Reveal.createRevealRightTransition();
			revealItem.properties.upTransition = Reveal.createRevealUpTransition();
			revealItem.properties.downTransition = Reveal.createRevealDownTransition();
			revealItem.setFunctionForPushEvent(FourWayTransitionScreen.TRANSITION, transitionHandler);
			revealItem.addPopEvent(Event.COMPLETE);
			this._menu.addScreen(MENU_SCREEN_ID_REVEAL, revealItem);

			var slideItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(FourWayTransitionScreen);
			slideItem.properties.transitionName = "Slide";
			slideItem.properties.leftTransition = Slide.createSlideLeftTransition();
			slideItem.properties.rightTransition = Slide.createSlideRightTransition();
			slideItem.properties.upTransition = Slide.createSlideUpTransition();
			slideItem.properties.downTransition = Slide.createSlideDownTransition();
			slideItem.setFunctionForPushEvent(FourWayTransitionScreen.TRANSITION, transitionHandler);
			slideItem.addPopEvent(Event.COMPLETE);
			this._menu.addScreen(MENU_SCREEN_ID_SLIDE, slideItem);

			var wipeItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(FourWayTransitionScreen);
			wipeItem.properties.transitionName = "Wipe";
			wipeItem.properties.leftTransition = Wipe.createWipeLeftTransition();
			wipeItem.properties.rightTransition = Wipe.createWipeRightTransition();
			wipeItem.properties.upTransition = Wipe.createWipeUpTransition();
			wipeItem.properties.downTransition = Wipe.createWipeDownTransition();
			wipeItem.setFunctionForPushEvent(FourWayTransitionScreen.TRANSITION, transitionHandler);
			wipeItem.addPopEvent(Event.COMPLETE);
			this._menu.addScreen(MENU_SCREEN_ID_WIPE, wipeItem);

			this._menu.pushScreen(MENU_SCREEN_ID_ALL_TRANSITIONS);

			this._menu.pushTransition = Slide.createSlideLeftTransition();
			this._menu.popTransition = Slide.createSlideRightTransition();

			this._content = new ScreenNavigator();
			var contentLayoutData:AnchorLayoutData = new AnchorLayoutData(0, 0, 0, 0);
			contentLayoutData.leftAnchorDisplayObject = this._menu;
			this._content.layoutData = contentLayoutData;
			this.addChildAt(this._content, 0);

			var content1:LayoutGroup = new LayoutGroup();
			content1.layout = new AnchorLayout();
			var image:ImageLoader = new ImageLoader();
			image.source = Texture.fromEmbeddedAsset(TEST_PATTERN1, false);
			image.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			content1.addChild(image);
			content1.backgroundSkin = new Quad(1, 1, 0x000000);
			this._content.addScreen(CONTENT_SCREEN_ID_ONE, new ScreenNavigatorItem(content1));
			var content2:LayoutGroup = new LayoutGroup();
			content2.layout = new AnchorLayout();
			image = new ImageLoader();
			image.source = Texture.fromEmbeddedAsset(TEST_PATTERN2, false);
			image.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			content2.addChild(image);
			content2.backgroundSkin = new Quad(1, 1, 0xffffff);
			this._content.addScreen(CONTENT_SCREEN_ID_TWO, new ScreenNavigatorItem(content2));

			this._content.showScreen(CONTENT_SCREEN_ID_ONE);

			//we're not setting the transition on the content screen navigator
			//because the screens will select their own transitions.
		}

		private function getNextScreenID():String
		{
			if(this._content.activeScreenID == CONTENT_SCREEN_ID_ONE)
			{
				return CONTENT_SCREEN_ID_TWO;
			}
			return CONTENT_SCREEN_ID_ONE;
		}

		private function transitionHandler(event:Event, transition:Function):void
		{
			this._content.showScreen(this.getNextScreenID(), transition);
		}
	}
}


================================================
FILE: examples/TransitionsExplorer/source/feathers/examples/transitionsExplorer/screens/AllTransitionsScreen.as
================================================
package feathers.examples.transitionsExplorer.screens
{
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ArrayCollection;
	import feathers.data.ListCollection;
	import feathers.events.FeathersEventType;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;

	import starling.events.Event;

	public class AllTransitionsScreen extends PanelScreen
	{
		public static const COLOR_FADE:String = "colorFade";
		public static const COVER:String = "cover";
		public static const CUBE:String = "cube";
		public static const FADE:String = "fade";
		public static const FLIP:String = "flip";
		public static const IRIS:String = "iris";
		public static const REVEAL:String = "reveal";
		public static const SLIDE:String = "slide";
		public static const WIPE:String = "wipe";

		public function AllTransitionsScreen()
		{
		}

		private var _list:List;

		public var savedVerticalScrollPosition:Number = 0;
		public var savedSelectedIndex:int = -1;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Transitions";

			this.layout = new AnchorLayout();

			this._list = new List();
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Color Fade", event: COLOR_FADE },
				{ label: "Cover", event: COVER },
				{ label: "Fade", event: FADE },
				{ label: "Cube", event: CUBE },
				{ label: "Flip", event: FLIP },
				{ label: "Iris", event: IRIS },
				{ label: "Reveal", event: REVEAL },
				{ label: "Slide", event: SLIDE },
				{ label: "Wipe", event: WIPE },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.clipContent = false;
			this._list.autoHideBackground = true;
			this._list.verticalScrollPosition = this.savedVerticalScrollPosition;
			this._list.selectedIndex = this.savedSelectedIndex;

			this._list.itemRendererFactory = this.createItemRenderer;

			this._list.addEventListener(Event.TRIGGERED, list_triggeredHandler);
			this.addChild(this._list);

			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}
		
		private function createItemRenderer():IListItemRenderer
		{
			var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();
			renderer.styleNameList.add(DefaultListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN);

			//enable the quick hit area to optimize hit tests when an item
			//is only selectable and doesn't have interactive children.
			renderer.isQuickHitAreaEnabled = true;

			renderer.labelField = "label";
			return renderer;
		};

		private function transitionInCompleteHandler(event:Event):void
		{
			this._list.selectedIndex = -1;
			this._list.revealScrollBars();
		}

		private function list_triggeredHandler(event:Event, item:Object):void
		{
			var eventType:String = item.event as String;
			this.dispatchEventWith(eventType, false,
			{
				//we're going to save the position of the list so that when the user
				//navigates back to this screen, they won't need to scroll back to
				//the same position manually
				savedVerticalScrollPosition: this._list.verticalScrollPosition,
				//we'll also save the selected index to temporarily highlight
				//the previously selected item when transitioning back
				savedSelectedIndex: this._list.selectedIndex
			});
		}
	}
}


================================================
FILE: examples/TransitionsExplorer/source/feathers/examples/transitionsExplorer/screens/ColorFadeTransitionScreen.as
================================================
package feathers.examples.transitionsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ArrayCollection;
	import feathers.data.ListCollection;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.motion.ColorFade;

	import starling.display.DisplayObject;
	import starling.events.Event;

	public class ColorFadeTransitionScreen extends PanelScreen
	{
		public static const TRANSITION:String = "transition";

		private static function fadeToRandomColor(oldScreen:DisplayObject, newScreen:DisplayObject, completeCallback:Function):void
		{
			var randomColor:uint = Math.random() * 0xffffff;
			ColorFade.createColorFadeTransition(randomColor)(oldScreen, newScreen, completeCallback);
		}

		public function ColorFadeTransitionScreen()
		{
			super();
		}

		private var _list:List;
		private var _backButton:Button;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Color Fade";

			this.layout = new AnchorLayout();

			this._list = new List();
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Black", transition: ColorFade.createBlackFadeTransition() },
				{ label: "White", transition: ColorFade.createWhiteFadeTransition() },
				{ label: "Custom", transition: fadeToRandomColor, accessory: "(random for demo)" },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.clipContent = false;
			this._list.autoHideBackground = true;

			this._list.itemRendererFactory = function():IListItemRenderer
			{
				var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();

				//enable the quick hit area to optimize hit tests when an item
				//is only selectable and doesn't have interactive children.
				renderer.isQuickHitAreaEnabled = true;

				renderer.labelField = "label";

				renderer.accessoryLabelField = "accessory";
				return renderer;
			};

			this._list.addEventListener(Event.TRIGGERED, list_triggeredHandler);
			this._list.revealScrollBars();
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();

			this._backButton = new Button();
			this._backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
			this._backButton.label = "Transitions";
			this._backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
			header.leftItems = new <DisplayObject>[this._backButton];

			return header;
		}

		private function list_triggeredHandler(event:Event, item:Object):void
		{
			var transition:Function = item.transition as Function;
			this.dispatchEventWith(TRANSITION, false, transition);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}
	}
}


================================================
FILE: examples/TransitionsExplorer/source/feathers/examples/transitionsExplorer/screens/FadeTransitionScreen.as
================================================
package feathers.examples.transitionsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ArrayCollection;
	import feathers.data.ListCollection;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.motion.Fade;

	import starling.display.DisplayObject;
	import starling.events.Event;

	public class FadeTransitionScreen extends PanelScreen
	{
		public static const TRANSITION:String = "transition";

		public function FadeTransitionScreen()
		{
			super();
		}

		private var _list:List;
		private var _backButton:Button;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Fade";

			this.layout = new AnchorLayout();

			this._list = new List();
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Fade In", transition: Fade.createFadeInTransition() },
				{ label: "Fade Out", transition: Fade.createFadeOutTransition() },
				{ label: "Crossfade", transition: Fade.createCrossfadeTransition() },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.clipContent = false;
			this._list.autoHideBackground = true;

			this._list.itemRendererFactory = function():IListItemRenderer
			{
				var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();

				//enable the quick hit area to optimize hit tests when an item
				//is only selectable and doesn't have interactive children.
				renderer.isQuickHitAreaEnabled = true;

				renderer.labelField = "label";
				return renderer;
			};

			this._list.addEventListener(Event.TRIGGERED, list_triggeredHandler);
			this._list.revealScrollBars();
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();

			this._backButton = new Button();
			this._backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
			this._backButton.label = "Transitions";
			this._backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
			header.leftItems = new <DisplayObject>[this._backButton];

			return header;
		}

		private function list_triggeredHandler(event:Event, item:Object):void
		{
			var transition:Function = item.transition as Function;
			this.dispatchEventWith(TRANSITION, false, transition);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}
	}
}


================================================
FILE: examples/TransitionsExplorer/source/feathers/examples/transitionsExplorer/screens/FourWayTransitionScreen.as
================================================
package feathers.examples.transitionsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ArrayCollection;
	import feathers.data.ListCollection;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;

	import starling.display.DisplayObject;
	import starling.events.Event;

	public class FourWayTransitionScreen extends PanelScreen
	{
		public static const TRANSITION:String = "transition";

		public function FourWayTransitionScreen()
		{
		}

		private var _list:List;
		private var _backButton:Button;

		public var transitionName:String;
		public var upTransition:Function;
		public var downTransition:Function;
		public var leftTransition:Function;
		public var rightTransition:Function;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = this.transitionName;

			this.layout = new AnchorLayout();

			this._list = new List();
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Left", transition: this.leftTransition },
				{ label: "Right", transition: this.rightTransition },
				{ label: "Up", transition: this.upTransition },
				{ label: "Down", transition: this.downTransition },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.clipContent = false;
			this._list.autoHideBackground = true;

			this._list.itemRendererFactory = function():IListItemRenderer
			{
				var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();

				//enable the quick hit area to optimize hit tests when an item
				//is only selectable and doesn't have interactive children.
				renderer.isQuickHitAreaEnabled = true;

				renderer.labelField = "label";
				return renderer;
			};

			this._list.addEventListener(Event.TRIGGERED, list_triggeredHandler);
			this._list.revealScrollBars();
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();

			this._backButton = new Button();
			this._backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
			this._backButton.label = "Transitions";
			this._backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
			header.leftItems = new <DisplayObject>[this._backButton];

			return header;
		}

		private function list_triggeredHandler(event:Event, item:Object):void
		{
			var transition:Function = item.transition as Function;
			this.dispatchEventWith(TRANSITION, false, transition);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}
	}
}


================================================
FILE: examples/TransitionsExplorer/source/feathers/examples/transitionsExplorer/screens/IrisTransitionScreen.as
================================================
package feathers.examples.transitionsExplorer.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ArrayCollection;
	import feathers.data.ListCollection;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.motion.Iris;

	import starling.display.DisplayObject;
	import starling.events.Event;

	public class IrisTransitionScreen extends PanelScreen
	{
		private static function irisCloseAtRandomPosition(oldScreen:DisplayObject, newScreen:DisplayObject, completeCallback:Function):void
		{
			var randomX:Number = Math.random() * (oldScreen ? oldScreen.width : newScreen.width);
			var randomY:Number = Math.random() * (oldScreen ? oldScreen.height : newScreen.height);
			Iris.createIrisCloseTransitionAt(randomX, randomY)(oldScreen, newScreen, completeCallback);
		}
		
		private static function irisOpenAtRandomPosition(oldScreen:DisplayObject, newScreen:DisplayObject, completeCallback:Function):void
		{
			var randomX:Number = Math.random() * (oldScreen ? oldScreen.width : newScreen.width);
			var randomY:Number = Math.random() * (oldScreen ? oldScreen.height : newScreen.height);
			Iris.createIrisOpenTransitionAt(randomX, randomY)(oldScreen, newScreen, completeCallback);
		}
		
		public static const TRANSITION:String = "transition";
		
		public function IrisTransitionScreen()
		{
			super();
		}

		private var _list:List;
		private var _backButton:Button;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = "Iris";

			this.layout = new AnchorLayout();

			this._list = new List();
			this._list.dataProvider = new ArrayCollection(
			[
				{ label: "Iris Open", transition: Iris.createIrisOpenTransition() },
				{ label: "Iris Close", transition: Iris.createIrisCloseTransition() },
				{ label: "Iris Open At", transition: irisOpenAtRandomPosition },
				{ label: "Iris Close At", transition: irisCloseAtRandomPosition },
			]);
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.clipContent = false;
			this._list.autoHideBackground = true;

			this._list.itemRendererFactory = function():IListItemRenderer
			{
				var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();

				//enable the quick hit area to optimize hit tests when an item
				//is only selectable and doesn't have interactive children.
				renderer.isQuickHitAreaEnabled = true;

				renderer.labelField = "label";

				renderer.accessoryLabelField = "accessory";
				return renderer;
			};

			this._list.addEventListener(Event.TRIGGERED, list_triggeredHandler);
			this._list.revealScrollBars();
			this.addChild(this._list);

			this.headerFactory = this.customHeaderFactory;
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();

			this._backButton = new Button();
			this._backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
			this._backButton.label = "Transitions";
			this._backButton.addEventListener(Event.TRIGGERED, backButton_triggeredHandler);
			header.leftItems = new <DisplayObject>[this._backButton];

			return header;
		}

		private function list_triggeredHandler(event:Event, item:Object):void
		{
			var transition:Function = item.transition as Function;
			this.dispatchEventWith(TRANSITION, false, transition);
		}

		private function backButton_triggeredHandler(event:Event):void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}
	}
}


================================================
FILE: examples/Video/README.md
================================================
# Feathers Video Example

A simple example of the [`VideoPlayer`](http://feathersui.com/help/video-player.html) component from [Feathers](http://feathersui.com/), presented as a desktop application.

## Requirements

In addition to Starling Framework and Feathers, this example project requires the `MetalWorksDesktopTheme` example theme. You can find the SWC file for this theme at the following location in the Feathers release build:

	themes/MetalWorksDesktopTheme/swc/MetalWorksDesktopTheme.swc

================================================
FILE: examples/Video/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
theme.root = ${basedir}/../../themes/MetalWorksDesktopTheme/source
output.path = ${basedir}/output
icon.path = ${basedir}/../shared-assets/icons

swf.version = 30

================================================
FILE: examples/Video/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="video" default="build" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<target name="build" depends="build-desktop"/>

	<target name="prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="build-air-swf" depends="prepare">
		<echo message="Building Video.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${airdesktop.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/Video.as"/>
			<arg value="-output=${output.path}/Video.swf"/>
		</java>
	</target>
	<target name="-check-desktop-properties">
		<fail unless="certificate.path" message="Must define certificate.path in build.local.properties to sign AIR application"/>
		<fail unless="certificate.password" message="Must define certificate.password in build.local.properties to sign AIR application"/>
	</target>
	<target name="build-desktop" depends="-check-desktop-properties,build-air-swf">
		<echo message="Packaging Video"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-keystore"/>
			<arg value="${certificate.path}"/>
			<arg value="-storepass"/>
			<arg value="${certificate.password}"/>
			<arg value="-target"/>
			<arg value="bundle"/>
			<arg value="${output.path}/Video"/>
			<arg value="source/Video-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon48.png"/>
			<arg line="icon128.png"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="Video.swf"/>
		</java>
		<delete file="${output.path}/Video.swf"/>
	</target>
</project>

================================================
FILE: examples/Video/source/Video-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.examples.Video</id>
	<filename>Feathers Video</filename>
	<name>Feathers Video</name>
	<versionNumber>4.2.0</versionNumber>
	<description>Video example application built with Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>Video.swf</content>
		<minimizable>true</minimizable>
		<maximizable>true</maximizable>
		<resizable>true</resizable>
		<visible>true</visible>
		<renderMode>direct</renderMode>
		<minSize>480 320</minSize>
		<width>480</width>
		<height>320</height>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>

	<icon>
		<image48x48>icon48.png</image48x48>
		<image128x128>icon128.png</image128x128>
	</icon>
</application>

================================================
FILE: examples/Video/source/Video.as
================================================
package
{
	import feathers.examples.video.Main;

	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.display3D.Context3DProfile;
	import flash.display3D.Context3DRenderMode;
	import flash.events.Event;
	import flash.geom.Rectangle;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
    public class Video extends Sprite
    {
        public function Video()
        {
            if(this.stage)
            {
                this.stage.scaleMode = StageScaleMode.NO_SCALE;
                this.stage.align = StageAlign.TOP_LEFT;
            }
            this.mouseEnabled = this.mouseChildren = false;
            this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
        }

        private var _starling:Starling;

        private function loaderInfo_completeHandler(event:Event):void
        {
            Starling.multitouchEnabled = true;
            this._starling = new Starling(Main, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE);
            this._starling.supportHighResolutions = true;
            this._starling.start();

            this.stage.addEventListener(Event.RESIZE, stage_resizeHandler, false, int.MAX_VALUE, true);
        }

        private function stage_resizeHandler(event:Event):void
        {
            this._starling.stage.stageWidth = this.stage.stageWidth;
            this._starling.stage.stageHeight = this.stage.stageHeight;

            var viewPort:Rectangle = this._starling.viewPort;
            viewPort.width = this.stage.stageWidth;
            viewPort.height = this.stage.stageHeight;
            try
            {
                this._starling.viewPort = viewPort;
            }
            catch(error:Error) {}
        }

    }
}

================================================
FILE: examples/Video/source/feathers/examples/video/Main.as
================================================
package feathers.examples.video
{
	import feathers.controls.Alert;
	import feathers.controls.AutoSizeMode;
	import feathers.controls.ImageLoader;
	import feathers.controls.LayoutGroup;
	import feathers.data.ArrayCollection;
	import feathers.data.ListCollection;
	import feathers.events.FeathersEventType;
	import feathers.events.MediaPlayerEventType;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.HorizontalLayoutData;
	import feathers.media.FullScreenToggleButton;
	import feathers.media.MuteToggleButton;
	import feathers.media.PlayPauseToggleButton;
	import feathers.media.SeekSlider;
	import feathers.media.VideoPlayer;
	import feathers.themes.MetalWorksDesktopTheme;

	import flash.desktop.NativeApplication;
	import flash.display.NativeMenu;
	import flash.display.NativeMenuItem;
	import flash.events.ContextMenuEvent;
	import flash.filesystem.File;
	import flash.net.FileFilter;

	import starling.core.Starling;
	import starling.display.Sprite;
	import starling.events.Event;

	public class Main extends Sprite
	{
		public function Main()
		{
			new MetalWorksDesktopTheme();
			super();
			this.addEventListener(Event.ADDED_TO_STAGE, addedToStageHandler);
		}
		
		protected var _videoPlayer:VideoPlayer
		protected var _controls:LayoutGroup;
		protected var _playPauseButton:PlayPauseToggleButton;
		protected var _seekSlider:SeekSlider;
		protected var _muteButton:MuteToggleButton;
		protected var _fullScreenButton:FullScreenToggleButton;
		protected var _view:ImageLoader;
		
		protected var _fullScreenItem:NativeMenuItem;
		protected var _fileToOpen:File;
		
		private function addedToStageHandler(event:Event):void
		{
			this.createMenu();
			
			this._videoPlayer = new VideoPlayer();
			this._videoPlayer.autoSizeMode = AutoSizeMode.STAGE;
			this._videoPlayer.layout = new AnchorLayout();
			this._videoPlayer.addEventListener(Event.READY, videoPlayer_readyHandler);
			this._videoPlayer.addEventListener(FeathersEventType.CLEAR, videoPlayer_clearHandler);
			this._videoPlayer.addEventListener(MediaPlayerEventType.DISPLAY_STATE_CHANGE, videoPlayer_displayStateChangeHandler);
			this._videoPlayer.addEventListener(Event.IO_ERROR, videoPlayer_errorHandler);
			this._videoPlayer.addEventListener(FeathersEventType.ERROR, videoPlayer_errorHandler);
			this.addChild(this._videoPlayer);
			
			this._view = new ImageLoader();
			this._videoPlayer.addChild(this._view);
			
			this._controls = new LayoutGroup();
			this._controls.touchable = false;
			this._controls.styleNameList.add(LayoutGroup.ALTERNATE_STYLE_NAME_TOOLBAR);
			this._videoPlayer.addChild(this._controls);
			
			this._playPauseButton = new PlayPauseToggleButton();
			this._controls.addChild(this._playPauseButton);
			
			this._seekSlider = new SeekSlider();
			this._seekSlider.layoutData = new HorizontalLayoutData(100);
			this._controls.addChild(this._seekSlider);
			
			this._muteButton = new MuteToggleButton();
			this._controls.addChild(this._muteButton);

			this._fullScreenButton = new FullScreenToggleButton();
			this._controls.addChild(this._fullScreenButton);
			
			var controlsLayoutData:AnchorLayoutData = new AnchorLayoutData();
			controlsLayoutData.left = 0;
			controlsLayoutData.right = 0;
			controlsLayoutData.bottom = 0;
			this._controls.layoutData = controlsLayoutData;

			var viewLayoutData:AnchorLayoutData = new AnchorLayoutData(0, 0, 0, 0);
			viewLayoutData.bottomAnchorDisplayObject = this._controls;
			this._view.layoutData = viewLayoutData;
		}
		
		protected function createMenu():void
		{
			var menu:NativeMenu;
			if(NativeApplication.supportsMenu)
			{
				menu = NativeApplication.nativeApplication.menu;
				var applicationMenuItem:NativeMenuItem = menu.getItemAt(0);
				menu.removeAllItems();
				menu.addItem(applicationMenuItem);
			}
			else
			{
				menu = new NativeMenu();
				Starling.current.nativeStage.nativeWindow.menu = menu;
			}

			var fileMenuItem:NativeMenuItem = new NativeMenuItem("File");
			var fileMenu:NativeMenu = new NativeMenu();
			fileMenuItem.submenu = fileMenu;
			menu.addItem(fileMenuItem);
			var openItem:NativeMenuItem = new NativeMenuItem("Open");
			openItem.keyEquivalent = "o";
			openItem.addEventListener(flash.events.Event.SELECT, openItem_selectHandler);
			fileMenu.addItem(openItem);
			var closeItem:NativeMenuItem = new NativeMenuItem("Close");
			closeItem.keyEquivalent = "w";
			closeItem.addEventListener(flash.events.Event.SELECT, closeItem_selectHandler);
			fileMenu.addItem(closeItem);

			var viewMenuItem:NativeMenuItem = new NativeMenuItem("View");
			var viewMenu:NativeMenu = new NativeMenu();
			viewMenuItem.submenu = viewMenu;
			menu.addItem(viewMenuItem);
			this._fullScreenItem = new NativeMenuItem("Enter Full Screen");
			this._fullScreenItem.keyEquivalent = "f";
			this._fullScreenItem.addEventListener(flash.events.Event.SELECT, fullScreenItem_selectHandler);
			viewMenu.addItem(this._fullScreenItem);
			
			if(NativeApplication.supportsMenu)
			{
				var windowMenuItem:NativeMenuItem = new NativeMenuItem("Window");
				var windowMenu:NativeMenu = new NativeMenu();
				windowMenuItem.submenu = windowMenu;
				menu.addItem(windowMenuItem);
				var minimizeItem:NativeMenuItem = new NativeMenuItem("Minimize");
				minimizeItem.keyEquivalent = "m";
				minimizeItem.addEventListener(flash.events.Event.SELECT, minimizeItem_selectHandler);
				windowMenu.addItem(minimizeItem);
				var zoomItem:NativeMenuItem = new NativeMenuItem("Zoom");
				zoomItem.addEventListener(flash.events.Event.SELECT, zoomItem_selectHandler);
				windowMenu.addItem(zoomItem);
			}
		}
		
		protected function videoPlayer_readyHandler(event:Event):void
		{
			this._view.source = this._videoPlayer.texture;
			this._controls.touchable = true;
		}
		
		protected function videoPlayer_clearHandler(event:Event):void
		{
			this._view.source = null;
			this._controls.touchable = false;
		}

		protected function videoPlayer_displayStateChangeHandler(event:Event):void
		{
			this._fullScreenItem.label = this._videoPlayer.isFullScreen ? "Exit Full Screen" : "Enter Full Screen";
		}
		
		protected function videoPlayer_errorHandler(event:Event):void
		{
			Alert.show("Cannot play selected video.",
				"Video Error", new ArrayCollection([{ label: "OK" }]));
			trace("VideoPlayer Error: " + event.data);
		}
		
		protected function openItem_selectHandler(event:flash.events.Event):void
		{
			this._fileToOpen = new File();
			this._fileToOpen.addEventListener(flash.events.Event.SELECT, fileToOpen_selectHandler);
			this._fileToOpen.addEventListener(flash.events.Event.CANCEL, fileToOpen_cancelHandler);
			this._fileToOpen.browseForOpen("Select video file",
			[
				new FileFilter("Video files", "*.m4v;*.mp4;*.f4v;*.flv;*.mov")
			]);
		}
		
		protected function closeItem_selectHandler(event:flash.events.Event):void
		{
			//we don't need to dispose the texture here. the VideoPlayer will
			//do it automatically when videoSource is changed.
			this._view.source = null;
			this._videoPlayer.videoSource = null;
			this._controls.touchable = false;
		}
		
		protected function fileToOpen_cancelHandler(event:flash.events.Event):void
		{
			this._fileToOpen.removeEventListener(flash.events.Event.SELECT, fileToOpen_selectHandler);
			this._fileToOpen.removeEventListener(flash.events.Event.CANCEL, fileToOpen_cancelHandler);
			this._fileToOpen = null;
		}

		protected function fileToOpen_selectHandler(event:flash.events.Event):void
		{
			if(this._videoPlayer.videoSource === this._fileToOpen.url)
			{
				//it's the same file, so just start it over instead of trying
				//to load it again!
				this._videoPlayer.stop();
				this._videoPlayer.play();
				return;
			}
			this._controls.touchable = false;
			this._videoPlayer.videoSource = this._fileToOpen.url;
			this._fileToOpen.removeEventListener(flash.events.Event.SELECT, fileToOpen_selectHandler);
			this._fileToOpen.removeEventListener(flash.events.Event.CANCEL, fileToOpen_cancelHandler);
			this._fileToOpen = null;
		}
		
		protected function fullScreenItem_selectHandler(event:flash.events.Event):void
		{
			this._videoPlayer.toggleFullScreen();
		}
		
		protected function minimizeItem_selectHandler(event:flash.events.Event):void
		{
			Starling.current.nativeStage.nativeWindow.minimize();
		}

		protected function zoomItem_selectHandler(event:flash.events.Event):void
		{
			Starling.current.nativeStage.nativeWindow.maximize();
		}
	}
}


================================================
FILE: examples/YouTubeFeeds/README.md
================================================
# YouTube Feeds Example for Feathers

A simple application that uses the [YouTube Data API](https://developers.google.com/youtube/2.0/reference) to display feeds using [Feathers](http://feathersui.com/) components.

## Requirements

In addition to Starling Framework and Feathers, this example project requires the `MetalWorksMobileTheme` example theme. You can find the SWC file for this theme at the following location in the Feathers release build:

	themes/MetalWorksMobileTheme/swc/MetalWorksMobileTheme.swc

## Web Demo

View the [YouTube Feeds example](http://feathersui.com/examples/youtube-feeds/) in your browser.

================================================
FILE: examples/YouTubeFeeds/build.properties
================================================
feathers.root = ${basedir}/../../source
starling.root = ${basedir}/../../third-party/starling
theme.root = ${basedir}/../../themes/MetalWorksMobileTheme/source
output.path = ${basedir}/output
icon.path = ${basedir}/../shared-assets/icons
launch.image.path = ${basedir}/../shared-assets/launch-images-windowed

swf.version = 30

================================================
FILE: examples/YouTubeFeeds/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="youtube" default="build" basedir=".">
	
	<!-- build.local.properties and sdk.local.proprties are optional files that
		can be used to override the default properties. -->
	<property file="./build.local.properties"/>
	<property file="./sdk.local.properties"/>
	<property file="./build.properties"/>
	<!-- inherit SDK properties from the root of the repository -->
	<property file="../../sdk.local.properties"/>
	<property file="../../sdk.properties"/>

	<fail unless="youtube.api.key"/>

	<target name="build" depends="build-android,build-ios"/>

	<target name="prepare">
		<delete dir="${output.path}"/>
	</target>

	<target name="build-web" depends="prepare">
		<echo message="Building YouTubeFeedsWeb.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${flashplayer.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="--define+=CONFIG::YOUTUBE_API_KEY,'${youtube.api.key}'"/>
			<arg value="-frame=two,feathers.examples.youtube.Main"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/YouTubeFeedsWeb.as"/>
			<arg value="-output=${output.path}/YouTubeFeedsWeb.swf"/>
		</java>
	</target>

	<target name="build-air-swf" depends="prepare">
		<echo message="Building YouTubeFeeds.swf"/>
		<java jar="${mxmlc}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-load-config=${airmobile.config}"/>
			<arg value="-swf-version=${swf.version}"/>
			<arg value="--define+=CONFIG::YOUTUBE_API_KEY,'${youtube.api.key}'"/>
			<arg value="-source-path+=source"/>
			<arg value="-source-path+=${starling.root}"/>
			<arg value="-source-path+=${feathers.root}"/>
			<arg value="-source-path+=${theme.root}"/>
			<arg value="source/YouTubeFeeds.as"/>
			<arg value="-output=${output.path}/YouTubeFeeds.swf"/>
		</java>
	</target>
	<target name="-check-ios-properties">
		<fail unless="ios.provision.path"/>
		<fail unless="ios.certificate.path"/>
		<fail unless="ios.certificate.password"/>
	</target>
	<target name="build-ios" depends="-check-ios-properties,build-air-swf">
		<echo message="Packaging YouTubeFeeds.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="ipa-app-store"/>
			<arg value="-provisioning-profile"/>
			<arg value="${ios.provision.path}"/>
			<arg value="-keystore"/>
			<arg value="${ios.certificate.path}"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-storepass"/>
			<arg value="${ios.certificate.password}"/>
			<arg value="${output.path}/YouTubeFeeds.ipa"/>
			<arg value="source/YouTubeFeeds-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${launch.image.path}"/>
			<arg value="Default~iphone.png"/>							<!-- iphone 3gs -->
			<arg value="Default@2x~iphone.png"/>						<!-- iphone 4/4s -->
			<arg value="Default-568h@2x~iphone.png"/>					<!-- iphone 5/5c/5s -->
			<arg value="Default-375w-667h@2x~iphone.png"/>				<!-- iphone 6/7/8 -->
			<arg value="Default-812h@3x~iphone.png"/>					<!-- iphone x (portrait) -->
			<arg value="Default-Landscape-812h@3x~iphone.png"/>			<!-- iphone x (landscape) -->
			<arg value="Default-414w-736h@3x~iphone.png"/>				<!-- iphone 6/7/8 plus (portrait) -->
			<arg value="Default-Landscape-414w-736h@3x~iphone.png"/>	<!-- iphone 6/7/8 plus (landscape) -->
			<arg value="Default-Portrait~ipad.png"/>					<!-- ipad 1/2 (portrait) -->
			<arg value="Default-PortraitUpsideDown~ipad.png"/>			<!-- ipad 1/2 (portrait upside down) -->
			<arg value="Default-Landscape~ipad.png"/>					<!-- ipad 1/2 (landscape left) -->
			<arg value="Default-LandscapeRight~ipad.png"/>				<!-- ipad 1/2 (landscape right) -->
			<arg value="Default-Portrait@2x~ipad.png"/>					<!-- ipad 3/air (portrait) -->
			<arg value="Default-LandscapeLeft@2x~ipad.png"/>			<!-- ipad 3/air (landscape left) -->
			<arg value="Default-LandscapeRight@2x~ipad.png"/>			<!-- ipad 3/air (landscape right) -->
			<arg value="Default-Portrait@2x.png"/>						<!-- ipad pro (portrait) -->
			<arg value="Default-Landscape@2x.png"/>						<!-- ipad pro (landscape) -->
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="YouTubeFeeds.swf"/>
		</java>
	</target>
	<target name="-check-android-properties">
		<fail unless="android.certificate.path"/>
		<fail unless="android.certificate.password"/>
	</target>
	<target name="build-android" depends="-check-android-properties,build-air-swf">
		<echo message="Packaging YouTubeFeeds.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-package"/>
			<arg value="-target"/>
			<arg value="apk-captive-runtime"/>
			<arg value="-storetype"/>
			<arg value="pkcs12"/>
			<arg value="-keystore"/>
			<arg value="${android.certificate.path}"/>
			<arg value="-storepass"/>
			<arg value="${android.certificate.password}"/>
			<arg value="${output.path}/YouTubeFeeds.apk"/>
			<arg value="source/YouTubeFeeds-app.xml"/>
			<arg value="-C"/>
			<arg value="${icon.path}"/>
			<arg line="icon29.png icon48.png icon50.png icon57.png icon58.png icon72.png icon87.png icon96.png icon100.png icon114.png icon128.png icon144.png icon180.png"/>
			<arg value="-C"/>
			<arg value="${output.path}"/>
			<arg value="YouTubeFeeds.swf"/>
		</java>
	</target>
	<target name="install-android">
		<echo message="Installing YouTubeFeeds.apk"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.YouTubeFeeds"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="android"/>
			<arg value="-package"/>
			<arg value="${output.path}/YouTubeFeeds.apk"/>
		</java>
	</target>
	<target name="install-ios">
		<echo message="Installing YouTubeFeeds.ipa"/>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="false">
			<arg value="-uninstallApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-appid"/>
			<arg value="com.feathersui.examples.YouTubeFeeds"/>
		</java>
		<java jar="${adt}" dir="${basedir}" fork="true" failonerror="true">
			<arg value="-installApp"/>
			<arg value="-platform"/>
			<arg value="iOS"/>
			<arg value="-package"/>
			<arg value="${output.path}/YouTubeFeeds.ipa"/>
		</java>
	</target>
</project>

================================================
FILE: examples/YouTubeFeeds/source/YouTubeFeeds-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.examples.YouTubeFeeds</id>
	<filename>YouTube Feeds</filename>
	<name>YouTube Feeds</name>
	<versionNumber>4.2.0</versionNumber>
	<description>YouTube Feeds example application built with Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>YouTubeFeeds.swf</content>
		<autoOrients>true</autoOrients>
		<fullScreen>false</fullScreen>
		<visible>true</visible>
		<renderMode>direct</renderMode>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>

	<icon>
		<image29x29>icon29.png</image29x29>
		<image48x48>icon48.png</image48x48>
		<image50x50>icon50.png</image50x50>
		<image57x57>icon57.png</image57x57>
		<image58x58>icon58.png</image58x58>
		<image72x72>icon72.png</image72x72>
		<image87x87>icon87.png</image87x87>
		<image96x96>icon96.png</image96x96>
		<image100x100>icon100.png</image100x100>
		<image114x114>icon114.png</image114x114>
		<image128x128>icon128.png</image128x128>
		<image144x144>icon144.png</image144x144>
		<image180x180>icon180.png</image180x180>
	</icon>
	<android>
		<colorDepth>16bit</colorDepth>
		<manifestAdditions><![CDATA[
			<manifest android:installLocation="auto">
			    <uses-permission android:name="android.permission.INTERNET"/>
			</manifest>
		]]></manifestAdditions>
	</android>
	<iPhone>
		<InfoAdditions>
		<![CDATA[
			<key>UIDeviceFamily</key> 
			<array> 
				<string>1</string>
				<string>2</string>
			</array>
			<key>UIPrerenderedIcon</key>
			<true/>
			<key>UIStatusBarStyle</key>
			<string>UIStatusBarStyleLightContent</string>
		]]> 
		</InfoAdditions>
		<requestedDisplayResolution>high</requestedDisplayResolution>
	</iPhone>
</application>

================================================
FILE: examples/YouTubeFeeds/source/YouTubeFeeds.as
================================================
package
{
	import feathers.examples.youtube.Main;
	import feathers.utils.ScreenDensityScaleFactorManager;

	import flash.display.Loader;
	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageOrientation;
	import flash.display.StageScaleMode;
	import flash.display3D.Context3DProfile;
	import flash.display3D.Context3DRenderMode;
	import flash.events.Event;
	import flash.filesystem.File;
	import flash.filesystem.FileMode;
	import flash.filesystem.FileStream;
	import flash.system.Capabilities;
	import flash.utils.ByteArray;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class YouTubeFeeds extends Sprite
	{
		public function YouTubeFeeds()
		{
			if(this.stage)
			{
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
				this.stage.align = StageAlign.TOP_LEFT;
			}
			this.mouseEnabled = this.mouseChildren = false;
			this.showLaunchImage();
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;
		private var _scaler:ScreenDensityScaleFactorManager;
		private var _launchImage:Loader;
		private var _savedAutoOrients:Boolean;

		/**
		 * On iOS, add the native launch image to the classic display list to
		 * avoid displaying only the stage background color between when the
		 * AIR app finishes launching and Starling starts rendering.
		 * 
		 * Launch image names: https://forums.adobe.com/message/9986239#9986239
		 */
		private function showLaunchImage():void
		{
			var filePath:String = null;
			var isPortraitOnly:Boolean = false;
			if(Capabilities.manufacturer.indexOf("iOS") >= 0)
			{
				var isPortraitUpsideDown:Boolean = this.stage.orientation == StageOrientation.UPSIDE_DOWN;
				var isPortrait:Boolean = this.stage.orientation == StageOrientation.DEFAULT || isPortraitUpsideDown;
				var isLandscapeRight:Boolean = this.stage.orientation == StageOrientation.ROTATED_RIGHT;
				if(Capabilities.screenResolutionX == 1242 && Capabilities.screenResolutionY == 2208)
				{
					//iphone 6/7/8 plus
					filePath = isPortrait ? "Default-414w-736h@3x~iphone.png" : "Default-Landscape-414w-736h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 1125 && Capabilities.screenResolutionY == 2436)
				{
					//iphone x
					filePath = isPortrait ? "Default-812h@3x~iphone.png" : "Default-Landscape-812h@3x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 2048 && Capabilities.screenResolutionY == 2732)
				{
					//ipad pro
					filePath = isPortrait ? "Default-Portrait@2x.png" : "Default-Landscape@2x.png";
				}
				else if(Capabilities.screenResolutionX == 1536 && Capabilities.screenResolutionY == 2048)
				{
					//ipad 3/air
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait@2x~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown@2x~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight@2x~ipad.png";
					}
					else
					{
						filePath = "Default-LandscapeLeft@2x~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 768 && Capabilities.screenResolutionY == 1024)
				{
					//ipad 1/2
					if(isPortraitUpsideDown)
					{
						filePath = "Default-Portrait~ipad.png";
					}
					else if(isPortrait)
					{
						filePath = "Default-PortraitUpsideDown~ipad.png";
					}
					else if(isLandscapeRight)
					{
						filePath = "Default-LandscapeRight~ipad.png";
					}
					else
					{
						filePath = "Default-Landscape~ipad.png";
					}
				}
				else if(Capabilities.screenResolutionX == 750)
				{
					//iphone 6/7/8
					isPortraitOnly = true;
					filePath = "Default-375w-667h@2x~iphone.png";
				}
				else if(Capabilities.screenResolutionX == 640)
				{
					isPortraitOnly = true;
					if(Capabilities.screenResolutionY == 1136)
					{
						//iphone 5/5c/5s
						filePath = "Default-568h@2x~iphone.png";
					}
					else
					{
						//iphone 4/4s
						filePath = "Default@2x~iphone.png";
					}
				}
				else if(Capabilities.screenResolutionX == 320)
				{
					//iphone 3gs
					isPortraitOnly = true;
					filePath = "Default~iphone.png";
				}
			}

			if(filePath)
			{
				var file:File = File.applicationDirectory.resolvePath(filePath);
				if(file.exists)
				{
					var bytes:ByteArray = new ByteArray();
					var stream:FileStream = new FileStream();
					stream.open(file, FileMode.READ);
					stream.readBytes(bytes, 0, stream.bytesAvailable);
					stream.close();
					this._launchImage = new Loader();
					this._launchImage.loadBytes(bytes);
					this.addChild(this._launchImage);
					this._savedAutoOrients = this.stage.autoOrients;
					this.stage.autoOrients = false;
					if(isPortraitOnly)
					{
						this.stage.setOrientation(StageOrientation.DEFAULT);
					}
				}
			}
		}

		private function loaderInfo_completeHandler(event:Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(Main, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE);
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.start();
			if(this._launchImage)
			{
				this._starling.addEventListener("rootCreated", starling_rootCreatedHandler);
			}
			this._scaler = new ScreenDensityScaleFactorManager(this._starling);

			this.stage.addEventListener(Event.DEACTIVATE, stage_deactivateHandler, false, 0, true);
		}

		private function starling_rootCreatedHandler(event:Object):void
		{
			if(this._launchImage)
			{
				this.removeChild(this._launchImage);
				this._launchImage.unloadAndStop(true);
				this._launchImage = null;
				this.stage.autoOrients = this._savedAutoOrients;
			}
		}

		private function stage_deactivateHandler(event:Event):void
		{
			this._starling.stop(true);
			this.stage.addEventListener(Event.ACTIVATE, stage_activateHandler, false, 0, true);
		}

		private function stage_activateHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.ACTIVATE, stage_activateHandler);
			this._starling.start();
		}

	}
}

================================================
FILE: examples/YouTubeFeeds/source/YouTubeFeedsWeb.as
================================================
package
{
	import feathers.system.DeviceCapabilities;

	import flash.display.MovieClip;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.events.Event;
	import flash.geom.Rectangle;
	import flash.ui.ContextMenu;
	import flash.utils.getDefinitionByName;

	import starling.core.Starling;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class YouTubeFeedsWeb extends MovieClip
	{
		public function YouTubeFeedsWeb()
		{
			var menu:ContextMenu = new ContextMenu();
			menu.hideBuiltInItems();
			this.contextMenu = menu;
			
			if(this.stage)
			{
				this.stage.align = StageAlign.TOP_LEFT;
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
			}
			
			this.loaderInfo.addEventListener(Event.COMPLETE, loaderInfo_completeHandler);
		}
		
		private var _starling:Starling;
		
		private function start():void
		{
			this.gotoAndStop(2);
			this.graphics.clear();

			//simulating iPhone Retina
			DeviceCapabilities.dpi = 326;
			
			Starling.multitouchEnabled = true;
			var MainType:Class = getDefinitionByName("feathers.examples.youtube.Main") as Class;
			this._starling = new Starling(MainType, this.stage, new Rectangle(0, 0, 960, 640));
			this._starling.supportHighResolutions = true;
			this._starling.skipUnchangedFrames = true;
			this._starling.stage.stageWidth = 480;
			this._starling.stage.stageHeight = 320;
			this._starling.start();
		}
		
		private function loaderInfo_completeHandler(event:Event):void
		{
			this.start();
		}
	}
}

================================================
FILE: examples/YouTubeFeeds/source/feathers/examples/youtube/Main.as
================================================
package feathers.examples.youtube
{
	import feathers.controls.StackScreenNavigator;
	import feathers.controls.StackScreenNavigatorItem;
	import feathers.examples.youtube.models.YouTubeModel;
	import feathers.examples.youtube.screens.ListVideosScreen;
	import feathers.examples.youtube.screens.MainMenuScreen;
	import feathers.examples.youtube.screens.VideoDetailsScreen;
	import feathers.motion.Slide;
	import feathers.themes.MetalWorksMobileTheme;

	import starling.events.Event;

	public class Main extends StackScreenNavigator
	{
		private static const MAIN_MENU:String = "mainMenu";
		private static const LIST_VIDEOS:String = "listVideos";
		private static const VIDEO_DETAILS:String = "videoDetails";

		public function Main()
		{
			//set up the theme right away!
			new MetalWorksMobileTheme();
			super();
		}

		private var _model:YouTubeModel;

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this._model = new YouTubeModel();

			var mainMenuItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(MainMenuScreen);
			mainMenuItem.setFunctionForPushEvent(MainMenuScreen.LIST_VIDEOS, this.mainMenuScreen_listVideosHandler);
			this.addScreen(MAIN_MENU, mainMenuItem);

			var listVideosItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(ListVideosScreen);
			listVideosItem.setFunctionForPushEvent(ListVideosScreen.SHOW_VIDEO_DETAILS, this.listVideos_showVideoDetails);
			listVideosItem.addPopEvent(Event.COMPLETE);
			listVideosItem.properties.model = this._model;
			this.addScreen(LIST_VIDEOS, listVideosItem);

			var videoDetailsItem:StackScreenNavigatorItem = new StackScreenNavigatorItem(VideoDetailsScreen);
			videoDetailsItem.addPopEvent(Event.COMPLETE);
			videoDetailsItem.properties.model = this._model;
			this.addScreen(VIDEO_DETAILS, videoDetailsItem);

			this.rootScreenID = MAIN_MENU;

			this.pushTransition = Slide.createSlideLeftTransition();
			this.popTransition = Slide.createSlideRightTransition();
		}

		private function mainMenuScreen_listVideosHandler(event:Event, mainMenuProperties:Object):void
		{
			var screen:MainMenuScreen = MainMenuScreen(this.activeScreen);
			this._model.selectedList = screen.selectedCategory;
			this.pushScreen(LIST_VIDEOS, mainMenuProperties);
		}

		private function listVideos_showVideoDetails(event:Event, listVideosProperties:Object):void
		{
			var screen:ListVideosScreen = ListVideosScreen(this.activeScreen);
			this._model.selectedVideo = screen.selectedVideo;
			this.pushScreen(VIDEO_DETAILS, listVideosProperties);
		}
	}
}


================================================
FILE: examples/YouTubeFeeds/source/feathers/examples/youtube/models/VideoDetails.as
================================================
package feathers.examples.youtube.models
{
	public class VideoDetails
	{
		public function VideoDetails(title:String = null, author:String = null,
			url:String = null, description:String = null, thumbnailURL:String = null)
		{
			this.title = title;
			this.author = author;
			this.url = url;
			this.description = description;
			this.thumbnailURL = thumbnailURL;
		}

		public var title:String;
		public var author:String;
		public var url:String;
		public var description:String;
		public var thumbnailURL:String;
	}
}


================================================
FILE: examples/YouTubeFeeds/source/feathers/examples/youtube/models/VideoFeed.as
================================================
package feathers.examples.youtube.models
{
	public class VideoFeed
	{
		public function VideoFeed(name:String = null, url:String = null)
		{
			this.name = name;
			this.url = url;
		}

		public var name:String;
		public var url:String;
	}
}


================================================
FILE: examples/YouTubeFeeds/source/feathers/examples/youtube/models/YouTubeModel.as
================================================
package feathers.examples.youtube.models
{
	public class YouTubeModel
	{
		public var selectedList:VideoFeed;
		public var selectedVideo:VideoDetails;
		public var cachedLists:Object = {};
	}
}


================================================
FILE: examples/YouTubeFeeds/source/feathers/examples/youtube/screens/ListVideosScreen.as
================================================
package feathers.examples.youtube.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.Label;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.VectorCollection;
	import feathers.events.FeathersEventType;
	import feathers.examples.youtube.models.VideoDetails;
	import feathers.examples.youtube.models.YouTubeModel;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;

	import flash.events.ErrorEvent;
	import flash.events.Event;
	import flash.events.IOErrorEvent;
	import flash.events.SecurityErrorEvent;
	import flash.net.URLLoader;
	import flash.net.URLLoaderDataFormat;
	import flash.net.URLRequest;
	import flash.system.Capabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Stage;
	import starling.events.Event;

	[Event(name="complete",type="starling.events.Event")]

	[Event(name="showVideoDetails",type="starling.events.Event")]

	public class ListVideosScreen extends PanelScreen
	{
		public static const SHOW_VIDEO_DETAILS:String = "showVideoDetails";
		
		private static const YOUTUBE_VIDEO_URL:String = "https://www.youtube.com/watch?v=";

		public function ListVideosScreen()
		{
			super();
			this.addEventListener(starling.events.Event.REMOVED_FROM_STAGE, removedFromStageHandler);
		}

		private var _backButton:Button;
		private var _list:List;
		private var _message:Label;

		private var _isTransitioning:Boolean = false;

		private var _model:YouTubeModel;

		public function get model():YouTubeModel
		{
			return this._model;
		}

		public function set model(value:YouTubeModel):void
		{
			if(this._model == value)
			{
				return;
			}
			this._model = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		public var savedVerticalScrollPosition:Number = 0;
		public var savedSelectedIndex:int = -1;
		public var savedDataProvider:VectorCollection;

		private var _loader:URLLoader;
		private var _savedResult:Object;

		public function get selectedVideo():VideoDetails
		{
			if(!this._list)
			{
				return null;
			}
			return this._list.selectedItem as VideoDetails;
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.title = this._model.selectedList.name;

			this.layout = new AnchorLayout();

			this._list = new List();
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.itemRendererFactory = function():IListItemRenderer
			{
				var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();
				renderer.labelField = "title";
				renderer.accessoryLabelField = "author";
				//no accessory and anything interactive, so we can use the quick
				//hit area to improve performance.
				renderer.isQuickHitAreaEnabled = true;
				return renderer;
			}
			//when navigating to video details, we save this information to
			//restore the list when later navigating back to this screen.
			if(this.savedDataProvider)
			{
				this._list.dataProvider = this.savedDataProvider;
				this._list.selectedIndex = this.savedSelectedIndex;
				this._list.verticalScrollPosition = this.savedVerticalScrollPosition;
			}
			this.addChild(this._list);

			this._message = new Label();
			this._message.text = "Loading...";
			this._message.layoutData = new AnchorLayoutData(NaN, NaN, NaN, NaN, 0, 0);
			//hide the loading message if we're using restored results
			this._message.visible = this.savedDataProvider === null;
			this.addChild(this._message);

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = onBackButton;

			this._isTransitioning = true;
			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();
			this._backButton = new Button();
			this._backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
			this._backButton.label = "Back";
			this._backButton.addEventListener(starling.events.Event.TRIGGERED, onBackButton);
			header.leftItems = new <DisplayObject>
			[
				this._backButton
			];
			return header;
		}

		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);

			//only load the list of videos if don't have restored results
			if(!this.savedDataProvider && dataInvalid)
			{
				this._list.dataProvider = null;
				if(this._model && this._model.selectedList)
				{
					if(this._loader)
					{
						this.cleanUpLoader();
					}
					if(this._model.cachedLists.hasOwnProperty(this._model.selectedList.url))
					{
						this._message.visible = false;
						this._list.dataProvider = VectorCollection(this._model.cachedLists[this._model.selectedList.url]);

						//show the scroll bars so that the user knows they can scroll
						this._list.revealScrollBars();
					}
					else
					{
						this._loader = new URLLoader();
						this._loader.dataFormat = URLLoaderDataFormat.TEXT;
						this._loader.addEventListener(flash.events.Event.COMPLETE, loader_completeHandler);
						this._loader.addEventListener(IOErrorEvent.IO_ERROR, loader_errorHandler);
						this._loader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, loader_errorHandler);
						this._loader.load(new URLRequest(this._model.selectedList.url));
					}
				}
			}

			//never forget to call super.draw()!
			super.draw();
		}

		private function cleanUpLoader():void
		{
			if(!this._loader)
			{
				return;
			}
			this._loader.removeEventListener(flash.events.Event.COMPLETE, loader_completeHandler);
			this._loader.removeEventListener(IOErrorEvent.IO_ERROR, loader_errorHandler);
			this._loader.removeEventListener(SecurityErrorEvent.SECURITY_ERROR, loader_errorHandler);
			this._loader = null;
		}

		private function parseListVideosResult(result:Object):void
		{
			this._message.visible = false;
			
			var stage:Stage = Starling.current.stage;
			var useHighQualityThumbnail:Boolean = Math.min(stage.stageWidth, stage.stageHeight) > 350;
			var useHTTP:Boolean = Capabilities.playerType !== "Desktop";
			
			var items:Vector.<VideoDetails> = new <VideoDetails>[];
			var videos:Array = result.items as Array;
			var videoCount:int = videos.length;
			for(var i:int = 0; i < videoCount; i++)
			{
				var video:Object = videos[i];
				var item:VideoDetails = new VideoDetails();
				item.title = video.snippet.title as String;
				item.author = video.snippet.channelTitle as String;
				item.url = YOUTUBE_VIDEO_URL + video.id as String;
				item.description = video.snippet.description as String;
				if("thumbnails" in video.snippet)
				{
					if(useHighQualityThumbnail)
					{
						item.thumbnailURL = video.snippet.thumbnails.high.url as String;
					}
					else
					{
						item.thumbnailURL = video.snippet.thumbnails.medium.url as String;
					}
					//switch from https to http if we're not running in AIR
					if(useHTTP && item.thumbnailURL.indexOf("https") == 0)
					{
						item.thumbnailURL = "http" + item.thumbnailURL.substr(5);
					}
				}
				items.push(item);
			}
			var collection:VectorCollection = new VectorCollection(items);
			this._model.cachedLists[this._model.selectedList.url] = collection;
			this._list.dataProvider = collection;

			//show the scroll bars so that the user knows they can scroll
			this._list.revealScrollBars();
		}

		private function onBackButton(event:starling.events.Event = null):void
		{
			this.dispatchEventWith(starling.events.Event.COMPLETE);
		}

		private function removedFromStageHandler(event:starling.events.Event):void
		{
			this.cleanUpLoader();
		}

		private function transitionInCompleteHandler(event:starling.events.Event):void
		{
			this._isTransitioning = false;

			if(this._savedResult)
			{
				this.parseListVideosResult(this._savedResult);
				this._savedResult = null;
			}

			this._list.selectedIndex = -1;
			this._list.addEventListener(starling.events.Event.CHANGE, list_changeHandler);
			this._list.revealScrollBars();
		}

		private function list_changeHandler(event:starling.events.Event):void
		{
			if(this._list.selectedIndex < 0)
			{
				return;
			}

			this.dispatchEventWith(SHOW_VIDEO_DETAILS, false,
			{
				//we're going to save the position of the list so that when the user
				//navigates back to this screen, they won't need to scroll back to
				//the same position manually
				savedVerticalScrollPosition: this._list.verticalScrollPosition,
				//we'll also save the selected index to temporarily highlight
				//the previously selected item when transitioning back
				savedSelectedIndex: this._list.selectedIndex,
				//and we'll save the data provider so that we don't need to reload
				//data when we return to this screen. we can restore it.
				savedDataProvider: this._list.dataProvider
			});
		}

		private function loader_completeHandler(event:flash.events.Event):void
		{
			var loaderData:String = this._loader.data as String;
			this.cleanUpLoader();
			try
			{
				var result:Object = JSON.parse(loaderData);
				if(this._isTransitioning)
				{
					//if this screen is still transitioning in, the we'll save
					//the result until later to ensure that the animation isn't
					//affected.
					this._savedResult = result;
					return;
				}
				this.parseListVideosResult(result);
			}
			catch(error:Error)
			{
				this._message.text = "Unable to read video list. Please try again later.";
				this._message.visible = true;
				this.invalidate(INVALIDATION_FLAG_STYLES);
				trace(error.toString());
				return;
			}
		}

		private function loader_errorHandler(event:ErrorEvent):void
		{
			this.cleanUpLoader();
			this._message.text = "Unable to load video list. Please try again later.";
			this._message.visible = true;
			this.invalidate(INVALIDATION_FLAG_STYLES);
			trace(event.toString());
		}
	}
}


================================================
FILE: examples/YouTubeFeeds/source/feathers/examples/youtube/screens/MainMenuScreen.as
================================================
package feathers.examples.youtube.screens
{
	import feathers.controls.Label;
	import feathers.controls.List;
	import feathers.controls.PanelScreen;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.VectorCollection;
	import feathers.events.FeathersEventType;
	import feathers.examples.youtube.models.VideoFeed;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;

	import flash.events.ErrorEvent;
	import flash.events.Event;
	import flash.events.IOErrorEvent;
	import flash.events.SecurityErrorEvent;
	import flash.net.URLLoader;
	import flash.net.URLLoaderDataFormat;
	import flash.net.URLRequest;

	import starling.events.Event;

	[Event(name="listVideos",type="starling.events.Event")]

	public class MainMenuScreen extends PanelScreen
	{
		public static const LIST_VIDEOS:String = "listVideos";

		private static const PART_PARAMETER:String = "?part=snippet"; //must be first
		private static const CHART_PARAMETER:String = "&chart=mostPopular";
		private static const REGION_CODE_PARAMETER:String = "&regionCode=US";
		private static const MAX_RESULTS_PARAMETER:String = "&maxResults=25";
		private static const VIDEO_CATEGORY_ID_PARAMETER:String = "&videoCategoryId=";
		private static const KEY_PARAMETER:String = "&key=" + CONFIG::YOUTUBE_API_KEY;
		private static const FIELDS_PARAMETER:String = "&fields=items%2Fid%2Citems%2Fsnippet%2Ftitle%2Citems%2Fsnippet%2FchannelTitle%2Citems%2Fsnippet%2Fdescription%2Citems%2Fsnippet%2Fthumbnails";
		private static const LIST_CATEGORIES_URL:String = "https://www.googleapis.com/youtube/v3/videoCategories" + PART_PARAMETER + REGION_CODE_PARAMETER + KEY_PARAMETER;
		private static const LIST_VIDEOS_IN_CATEGORY_URL:String = "https://www.googleapis.com/youtube/v3/videos" + PART_PARAMETER + CHART_PARAMETER + REGION_CODE_PARAMETER + MAX_RESULTS_PARAMETER + FIELDS_PARAMETER + KEY_PARAMETER + VIDEO_CATEGORY_ID_PARAMETER;

		public function MainMenuScreen()
		{
			this.addEventListener(starling.events.Event.REMOVED_FROM_STAGE, removedFromStageHandler);
		}

		private var _list:List;

		private var _loader:URLLoader;
		private var _message:Label;

		public var savedVerticalScrollPosition:Number = 0;
		public var savedSelectedIndex:int = -1;
		public var savedDataProvider:VectorCollection;

		public function get selectedCategory():VideoFeed
		{
			if(!this._list)
			{
				return null;
			}
			return this._list.selectedItem as VideoFeed;
		}

		override protected function initialize():void
		{
			super.initialize();

			this.title = "YouTube Feeds";

			this.layout = new AnchorLayout();

			this._list = new List();
			this._list.layoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._list.itemRendererFactory = this.createItemRenderer;
			//when navigating to video results, we save this information to
			//restore the list when later navigating back to this screen.
			if(this.savedDataProvider)
			{
				this._list.dataProvider = this.savedDataProvider;
				this._list.selectedIndex = this.savedSelectedIndex;
				this._list.verticalScrollPosition = this.savedVerticalScrollPosition;
			}
			this.addChild(this._list);

			this._message = new Label();
			this._message.text = "Loading...";
			this._message.layoutData = new AnchorLayoutData(NaN, NaN, NaN, NaN, 0, 0);
			//hide the loading message if we're using restored results
			this._message.visible = this.savedDataProvider === null;
			this.addChild(this._message);

			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}

		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);

			//only load the list of videos if don't have restored results
			if(!this.savedDataProvider && dataInvalid)
			{
				this._list.dataProvider = null;
				this._message.visible = true;
				if(this._loader)
				{
					this.cleanUpLoader();
				}
				this._loader = new URLLoader();
				this._loader.dataFormat = URLLoaderDataFormat.TEXT;
				this._loader.addEventListener(flash.events.Event.COMPLETE, loader_completeHandler);
				this._loader.addEventListener(IOErrorEvent.IO_ERROR, loader_errorHandler);
				this._loader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, loader_errorHandler);
				this._loader.load(new URLRequest(LIST_CATEGORIES_URL));
			}

			//never forget to call super.draw()!
			super.draw();
		}

		private function cleanUpLoader():void
		{
			if(!this._loader)
			{
				return;
			}
			this._loader.removeEventListener(flash.events.Event.COMPLETE, loader_completeHandler);
			this._loader.removeEventListener(IOErrorEvent.IO_ERROR, loader_errorHandler);
			this._loader.removeEventListener(SecurityErrorEvent.SECURITY_ERROR, loader_errorHandler);
			this._loader = null;
		}

		private function parseListVideoCategoriesResult(result:Object):void
		{
			this._message.visible = false;

			var items:Vector.<VideoFeed> = new <VideoFeed>[];
			var categories:Array = result.items as Array;
			var categoryCount:int = categories.length;
			for(var i:int = 0; i < categoryCount; i++)
			{
				var category:Object = categories[i];
				var assignable:Boolean = category.snippet.assignable as Boolean; 
				if(!assignable)
				{
					continue;
				}
				var item:VideoFeed = new VideoFeed();
				item.name = category.snippet.title as String;
				var categoryID:String = category.id as String;
				item.url = LIST_VIDEOS_IN_CATEGORY_URL + categoryID;
				items.push(item);
			}
			var collection:VectorCollection = new VectorCollection(items);
			this._list.dataProvider = collection;

			//show the scroll bars so that the user knows they can scroll
			this._list.revealScrollBars();
		}

		private function createItemRenderer():IListItemRenderer
		{
			var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();
			renderer.styleNameList.add(DefaultListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN);

			//enable the quick hit area to optimize hit tests when an item
			//is only selectable and doesn't have interactive children.
			renderer.isQuickHitAreaEnabled = true;

			renderer.labelField = "name";
			return renderer;
		}

		private function removedFromStageHandler(event:starling.events.Event):void
		{
			this.cleanUpLoader();
		}

		private function transitionInCompleteHandler(event:starling.events.Event):void
		{
			this._list.selectedIndex = -1;
			this._list.addEventListener(starling.events.Event.CHANGE, list_changeHandler);

			this._list.revealScrollBars();
		}

		private function list_changeHandler(event:starling.events.Event):void
		{
			this.dispatchEventWith(LIST_VIDEOS, false,
			{
				//we're going to save the position of the list so that when the user
				//navigates back to this screen, they won't need to scroll back to
				//the same position manually
				savedVerticalScrollPosition: this._list.verticalScrollPosition,
				//we'll also save the selected index to temporarily highlight
				//the previously selected item when transitioning back
				savedSelectedIndex: this._list.selectedIndex,
				//and we'll save the data provider so that we don't need to reload
				//data when we return to this screen. we can restore it.
				savedDataProvider: this._list.dataProvider
			});
		}

		private function loader_completeHandler(event:flash.events.Event):void
		{
			try
			{
				var loaderData:String = this._loader.data as String;
				this.parseListVideoCategoriesResult(JSON.parse(loaderData));
			}
			catch(error:Error)
			{
				this._message.text = "Unable to load data. Please try again later.";
				this._message.visible = true;
				this.invalidate(INVALIDATION_FLAG_STYLES);
				trace(error.toString());
			}
			this.cleanUpLoader();
		}

		private function loader_errorHandler(event:ErrorEvent):void
		{
			this.cleanUpLoader();
			this._message.text = "Unable to load data. Please try again later.";
			this._message.visible = true;
			this.invalidate(INVALIDATION_FLAG_STYLES);
			trace(event.toString());
		}
	}
}


================================================
FILE: examples/YouTubeFeeds/source/feathers/examples/youtube/screens/VideoDetailsScreen.as
================================================
package feathers.examples.youtube.screens
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.ImageLoader;
	import feathers.controls.PanelScreen;
	import feathers.controls.ScrollPolicy;
	import feathers.controls.ScrollText;
	import feathers.events.FeathersEventType;
	import feathers.examples.youtube.models.YouTubeModel;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;

	import flash.net.URLRequest;
	import flash.net.navigateToURL;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.utils.ScaleMode;

	[Event(name="complete",type="starling.events.Event")]

	public class VideoDetailsScreen extends PanelScreen
	{
		public function VideoDetailsScreen()
		{
			super();
		}

		private var _backButton:Button;
		private var _watchButton:Button;
		private var _thumbnail:ImageLoader;
		private var _portraitThumbnailLayoutData:AnchorLayoutData;
		private var _landscapeThumbnailLayoutData:AnchorLayoutData;
		private var _scrollText:ScrollText;
		private var _portraitTextLayoutData:AnchorLayoutData;
		private var _landscapeTextLayoutData:AnchorLayoutData;

		private var _model:YouTubeModel;

		public function get model():YouTubeModel
		{
			return this._model;
		}

		public function set model(value:YouTubeModel):void
		{
			if(this._model == value)
			{
				return;
			}
			this._model = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		override protected function initialize():void
		{
			//never forget to call super.initialize()
			super.initialize();

			this.layout = new AnchorLayout();
			
			this._thumbnail = new ImageLoader();
			this._thumbnail.scaleMode = ScaleMode.NO_BORDER;
			this._thumbnail.layoutData = new AnchorLayoutData(0, 0, NaN, 0);
			this.addChild(this._thumbnail);

			this._scrollText = new ScrollText();
			this._scrollText.isHTML = true;
			this._scrollText.verticalScrollPolicy = ScrollPolicy.ON;
			this.addChild(this._scrollText);
			
			//we're going to use these AnchorLayoutData objects later, when we
			//know if this screen is displayed in portrait or landscape.
			//we'll change it dynamically if the device is rotated while this
			//screen is visible.
			this._portraitThumbnailLayoutData = new AnchorLayoutData(0, 0, NaN, 0);
			this._landscapeThumbnailLayoutData = new AnchorLayoutData(0, NaN, 0, 0);
			this._landscapeThumbnailLayoutData.percentWidth = 50;
			this._portraitTextLayoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._portraitTextLayoutData.topAnchorDisplayObject = this._thumbnail;
			this._landscapeTextLayoutData = new AnchorLayoutData(0, 0, 0, 0);
			this._landscapeTextLayoutData.leftAnchorDisplayObject = this._thumbnail;

			this.headerFactory = this.customHeaderFactory;

			this.backButtonHandler = onBackButton;

			this.addEventListener(FeathersEventType.TRANSITION_IN_COMPLETE, transitionInCompleteHandler);
		}

		private function customHeaderFactory():Header
		{
			var header:Header = new Header();

			this._backButton = new Button();
			this._backButton.styleNameList.add(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON);
			this._backButton.label = "Back";
			this._backButton.addEventListener(Event.TRIGGERED, onBackButton);
			header.leftItems = new <DisplayObject>
			[
				this._backButton
			];

			this._watchButton = new Button();
			this._watchButton.label = "Watch";
			this._watchButton.addEventListener(Event.TRIGGERED, watchButton_triggeredHandler);
			header.rightItems = new <DisplayObject>
			[
				this._watchButton
			];

			return header;
		}

		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			
			if(dataInvalid)
			{
				if(this._model && this._model.selectedVideo)
				{
					this.title = this._model.selectedVideo.title;
					this._thumbnail.source = this._model.selectedVideo.thumbnailURL;
					
					var content:String = '<p><b><font size="+2">' + this._model.selectedVideo.title + '</font></b></p>';
					content += '<p><font size="-2" color="#999999">' + this._model.selectedVideo.author + '</font></p><br>';
					content += this._model.selectedVideo.description.replace(/\r\n/g, "<br>");
					this._scrollText.text = content;
				}
				else
				{
					this.title = null;
					this._thumbnail.source = null;
					this._scrollText.text = "";
				}
			}
			
			if(sizeInvalid)
			{
				this.refreshLayout();
			}

			//never forget to call super.draw()!
			super.draw();
		}
		
		protected function refreshLayout():void
		{
			if(this.actualHeight > this.actualWidth &&
				this._thumbnail.layoutData != this._portraitThumbnailLayoutData) //portrait
			{
				//in landscape, the height of the thumbnail may have been set
				//explicitly. we need to reset it so that the thumbnail can
				//resize itself automatically.
				this._thumbnail.height = NaN;
				this._thumbnail.layoutData = this._portraitThumbnailLayoutData;
				
				this._scrollText.layoutData = this._portraitTextLayoutData;
			}
			else if(this.actualWidth > this.actualHeight) //landscape
			{
				this._thumbnail.layoutData = this._landscapeThumbnailLayoutData;
				this._scrollText.layoutData = this._landscapeTextLayoutData;
			}
		}

		private function onBackButton(event:Event = null):void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}

		private function transitionInCompleteHandler(event:Event):void
		{
			this._scrollText.revealScrollBars();
		}

		private function watchButton_triggeredHandler(event:Event):void
		{
			navigateToURL(new URLRequest(this._model.selectedVideo.url), "_blank");
		}
	}
}


================================================
FILE: examples/build.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<project name="feathers-examples" default="web" basedir=".">

	<target name="desktop" description="Builds desktop SWFs from all examples.">
		<ant dir="${basedir}/Video" target="build-desktop" inheritAll="false" useNativeBasedir="true"/>
	</target>
	<target name="web" description="Builds web SWFs from all examples.">
		<ant dir="${basedir}/ComponentsExplorer" target="build-web" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/DrawersExplorer" target="build-web" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/DragAndDrop" target="build" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/HelloWorld" target="build-web" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/LayoutExplorer" target="build-web" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Magic8Chat" target="build-web" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/PullToRefresh" target="build-web" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/StackScreenNavigatorExplorer" target="build-web" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Tabs" target="build-web" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/TileList" target="build-web" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Todos" target="build-web" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/TrainTimes" target="build-web" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/TransitionsExplorer" target="build-web" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/YouTubeFeeds" target="build-web" inheritAll="false" useNativeBasedir="true"/>
	</target>
	<target name="android" description="Builds Android APKs from all examples.">
		<ant dir="${basedir}/ComponentsExplorer" target="build-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/DrawersExplorer" target="build-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Gallery" target="build-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/HelloWorld" target="build-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/LayoutExplorer" target="build-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Magic8Chat" target="build-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/PullToRefresh" target="build-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/StackScreenNavigatorExplorer" target="build-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Tabs" target="build-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/TileList" target="build-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Todos" target="build-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/TrainTimes" target="build-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/TransitionsExplorer" target="build-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/YouTubeFeeds" target="build-android" inheritAll="false" useNativeBasedir="true"/>
	</target>
	<target name="ios" description="Builds iOS IPAs from all examples.">
		<ant dir="${basedir}/ComponentsExplorer" target="build-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/DrawersExplorer" target="build-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Gallery" target="build-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/HelloWorld" target="build-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/LayoutExplorer" target="build-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Magic8Chat" target="build-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/PullToRefresh" target="build-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/StackScreenNavigatorExplorer" target="build-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Tabs" target="build-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/TileList" target="build-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Todos" target="build-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/TrainTimes" target="build-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/TransitionsExplorer" target="build-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/YouTubeFeeds" target="build-ios" inheritAll="false" useNativeBasedir="true"/>
	</target>
	<target name="install-android" description="Installs Android APKs to a device.">
		<ant dir="${basedir}/ComponentsExplorer" target="install-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/DrawersExplorer" target="install-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Gallery" target="install-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/HelloWorld" target="install-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/LayoutExplorer" target="install-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Magic8Chat" target="install-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/PullToRefresh" target="install-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/StackScreenNavigatorExplorer" target="install-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Tabs" target="install-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/TileList" target="install-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Todos" target="install-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/TrainTimes" target="install-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/TransitionsExplorer" target="install-android" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/YouTubeFeeds" target="install-android" inheritAll="false" useNativeBasedir="true"/>
	</target>
	<target name="install-ios" description="Installs iOS IPAs to a device.">
		<ant dir="${basedir}/ComponentsExplorer" target="install-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/DrawersExplorer" target="install-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Gallery" target="install-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/HelloWorld" target="install-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/LayoutExplorer" target="install-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Magic8Chat" target="install-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/PullToRefresh" target="install-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/StackScreenNavigatorExplorer" target="install-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Tabs" target="install-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/TileList" target="install-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/Todos" target="install-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/TrainTimes" target="install-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/TransitionsExplorer" target="install-ios" inheritAll="false" useNativeBasedir="true"/>
		<ant dir="${basedir}/YouTubeFeeds" target="install-ios" inheritAll="false" useNativeBasedir="true"/>
	</target>
</project>

================================================
FILE: package-src.json
================================================
{
  "id": "feathersui-source",
  "name": "feathersui-source",
  "url": "https://feathersui.com/as3-starling/",
  "docUrl": "https://feathersui/api-reference/",
  "description": "Cross-platform user interface components for creative frontend projects built with Starling",
  "type": "src",
  "version": "4.2.0",
  "sourceUrl": "https://github.com/feathersui/feathersui-starling/releases/download/v4.2.0/feathersui-source_4.2.0.airpackage",
	"publishedAt": "2021-11-19T00:00:00.000Z",
  "dependencies": ["starling-source:2.x.x"],
  "parameters": [],
  "tags": ["components", "gui", "starling", "ui", "widgets"],
  "status": "release",
  "license": {
    "type": "Simplified BSD",
    "url": "https://github.com/feathersui/feathersui-starling/blob/v4.2.0/LICENSE.md",
    "public": true
  }
}


================================================
FILE: package-swc.json
================================================
{
  "id": "feathersui",
  "name": "feathersui",
  "url": "https://feathersui.com/as3-starling/",
  "docUrl": "https://feathersui/api-reference/",
  "description": "Cross-platform user interface components for creative frontend projects built with Starling",
  "type": "swc",
  "version": "4.2.0",
  "sourceUrl": "https://github.com/feathersui/feathersui-starling/releases/download/v4.2.0/feathersui_4.2.0.airpackage",
	"publishedAt": "2021-11-19T00:00:00.000Z",
  "dependencies": ["starling:2.x.x"],
  "parameters": [],
  "tags": ["components", "gui", "starling", "ui", "widgets"],
  "status": "release",
  "license": {
    "type": "Simplified BSD",
    "url": "https://github.com/feathersui/feathersui-starling/blob/v4.2.0/LICENSE.md",
    "public": true
  }
}


================================================
FILE: sdk.properties
================================================
# The location of the AIR SDK with ASC 2.0
flashsdk.root = c:/Users/josht/Development/Flash/sdks/AIR32.0.0.89
flashsdk.bin = ${flashsdk.root}/bin
flashsdk.lib = ${flashsdk.root}/lib
flashsdk.config = ${flashsdk.root}/frameworks/flex-config.xml
flashsdk.framework = ${flashsdk.root}/frameworks

# config files
flashplayer.config = ${flashsdk.root}/frameworks/flex-config.xml
airdesktop.config = ${flashsdk.root}/frameworks/air-config.xml
airmobile.config = ${flashsdk.root}/frameworks/airmobile-config.xml

# path to compiler jars
asdoc = ${flashsdk.lib}/legacy/asdoc.jar
compc = ${flashsdk.lib}/compc-cli.jar
mxmlc = ${flashsdk.lib}/mxmlc-cli.jar
adt = ${flashsdk.lib}/adt.jar

apm = /opt/apm/apm

================================================
FILE: source/feathers/FEATHERS_VERSION.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers
{
	/**
	 * The current version of Feathers. Stable versions will use the format
	 * <code>major.minor.patch</code>. Prerelease versions may append additional
	 * information after a hyphen. For example, the beta release of Feathers 2.2
	 * would use the following value: <code>2.2.0-beta</code>. Special builds
	 * may append additional information after a plus sign. For example, the
	 * stable release of Feathers SDK 2.2 would use the following value:
	 * <code>2.2.0+sdk</code>. The beta version of Feathers SDK 2.2 would use
	 * the following value: <code>2.2.0-beta+sdk</code>.
	 *
	 * @productversion Feathers 2.1.0
	 */
	public const FEATHERS_VERSION:String = "4.2.0";
}


================================================
FILE: source/feathers/controls/Alert.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.ITextRenderer;
	import feathers.core.IValidating;
	import feathers.core.PopUpManager;
	import feathers.core.PropertyProxy;
	import feathers.data.IListCollection;
	import feathers.events.FeathersEventType;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.skins.IStyleProvider;
	import feathers.text.FontStylesSet;
	import feathers.utils.display.getDisplayObjectDepthFromStage;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;

	import flash.events.KeyboardEvent;
	import flash.ui.Keyboard;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.text.TextFormat;

	[Exclude(name="layout",kind="property")]
	[Exclude(name="footer",kind="property")]
	[Exclude(name="footerFactory",kind="property")]
	[Exclude(name="footerProperties",kind="property")]
	[Exclude(name="customFooterStyleName",kind="style")]
	[Exclude(name="createFooter",kind="method")]

	/**
	 * A style name to add to the alert's button group sub-component.
	 * Typically used by a theme to provide different styles to different alerts.
	 *
	 * <p>In the following example, a custom button group style name is
	 * passed to the alert:</p>
	 *
	 * <listing version="3.0">
	 * alert.customButtonGroupStyleName = "my-custom-button-group";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( ButtonGroup ).setFunctionForStyleName( "my-custom-button-group", setCustomButtonGroupStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_BUTTON_GROUP
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #buttonGroupFactory
	 */
	[Style(name="customButtonGroupStyleName",type="String")]

	/**
	 * A style name to add to the alert's message text renderer
	 * sub-component. Typically used by a theme to provide different styles
	 * to different alerts.
	 *
	 * <p>In the following example, a custom message style name is passed
	 * to the alert:</p>
	 *
	 * <listing version="3.0">
	 * alert.customMessageStyleName = "my-custom-button-group";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( BitmapFontTextRenderer ).setFunctionForStyleName( "my-custom-message", setCustomMessageStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_MESSAGE
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #messageFactory
	 */
	[Style(name="customMessageStyleName",type="String")]

	/**
	 * The font styles used to display the alert's message text when the
	 * alert is disabled.
	 *
	 * <p>These styles will only apply to the alert's message. The header's
	 * title font styles should be set directly on the header. The button
	 * font styles should be set directly on the buttons.</p>
	 *
	 * <p>In the following example, the disabled font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * alert.disabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>messageFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:fontStyles
	 */
	[Style(name="disabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the alert's message text.
	 *
	 * <p>These styles will only apply to the alert's message. The header's
	 * title font styles should be set directly on the header. The button
	 * font styles should be set directly on the buttons.</p>
	 *
	 * <p>In the following example, the font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * alert.fontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>messageFactory</code> to set more advanced styles.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:disabledFontStyles
	 */
	[Style(name="fontStyles",type="starling.text.TextFormat")]

	/**
	 * The space, in pixels, between the alert's icon and its message text
	 * renderer.
	 *
	 * <p>In the following example, the gap is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * alert.gap = 20;</listing>
	 *
	 * @default 0
	 */
	[Style(name="gap",type="Number")]

	/**
	 * The alert's optional icon content to display next to the text.
	 *
	 * <p>In the following example, the icon is privated:</p>
	 *
	 * <listing version="3.0">
	 * alert.icon = new Image( texture );</listing>
	 *
	 * @default null
	 */
	[Style(name="icon",type="starling.display.DisplayObject")]

	/**
	 * Dispatched when the alert is closed. The <code>data</code> property of
	 * the event object will contain the item from the <code>ButtonGroup</code>
	 * data provider for the button that is triggered. If no button is
	 * triggered, then the <code>data</code> property will be <code>null</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CLOSE
	 */
	[Event(name="close",type="starling.events.Event")]

	/**
	 * Displays a message in a modal pop-up with a title and a set of buttons.
	 *
	 * <p>In general, an <code>Alert</code> isn't instantiated directly.
	 * Instead, you will typically call the static function
	 * <code>Alert.show()</code>. This is not required, but it result in less
	 * code and no need to manually manage calls to the <code>PopUpManager</code>.</p>
	 *
	 * <p>In the following example, an alert is shown when a <code>Button</code>
	 * is triggered:</p>
	 *
	 * <listing version="3.0">
	 * button.addEventListener( Event.TRIGGERED, button_triggeredHandler );
	 * 
	 * function button_triggeredHandler( event:Event ):void
	 * {
	 *     var alert:Alert = Alert.show( "This is an alert!", "Hello World", new ArrayCollection(
	 *     [
	 *         { label: "OK" }
	 *     ]));
	 * }</listing>
	 *
	 * @see ../../../help/alert.html How to use the Feathers Alert component
	 *
	 * @productversion Feathers 1.2.0
	 */
	public class Alert extends Panel
	{
		/**
		 * The default value added to the <code>styleNameList</code> of the header.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_HEADER:String = "feathers-alert-header";

		/**
		 * The default value added to the <code>styleNameList</code> of the button group.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_BUTTON_GROUP:String = "feathers-alert-button-group";

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * message text renderer.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 * @see ../../../help/text-renderers.html Introduction to Feathers text renderers
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_MESSAGE:String = "feathers-alert-message";

		/**
		 * Returns a new <code>Alert</code> instance when <code>Alert.show()</code>
		 * is called. If one wishes to skin the alert manually, a custom factory
		 * may be provided.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 *
		 * <pre>function():Alert</pre>
		 *
		 * <p>The following example shows how to create a custom alert factory:</p>
		 *
		 * <listing version="3.0">
		 * Alert.alertFactory = function():Alert
		 * {
		 *     var alert:Alert = new Alert();
		 *     //set properties here!
		 *     return alert;
		 * };</listing>
		 *
		 * @see #show()
		 */
		public static var alertFactory:Function = defaultAlertFactory;

		/**
		 * Creates overlays for modal alerts. When this property is
		 * <code>null</code>, uses the <code>overlayFactory</code> defined by
		 * <code>PopUpManager</code> instead.
		 *
		 * <p>Note: Specific, individual alerts may have custom overlays that
		 * are different than the default by passing a different overlay factory
		 * to <code>Alert.show()</code>.</p>
		 *
		 * <p>This function is expected to have the following signature:</p>
		 * <pre>function():DisplayObject</pre>
		 *
		 * <p>The following example uses a semi-transparent <code>Quad</code> as
		 * a custom overlay:</p>
		 *
		 * <listing version="3.0">
		 * Alert.overlayFactory = function():Quad
		 * {
		 *     var quad:Quad = new Quad(10, 10, 0x000000);
		 *     quad.alpha = 0.75;
		 *     return quad;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.PopUpManager#overlayFactory
		 * @see #show()
		 */
		public static var overlayFactory:Function;

		/**
		 * The default <code>IStyleProvider</code> for all <code>Alert</code>
		 * components.
		 *
		 * @default null
		 *
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * The default factory that creates alerts when <code>Alert.show()</code>
		 * is called. To use a different factory, you need to set
		 * <code>Alert.alertFactory</code> to a <code>Function</code>
		 * instance.
		 *
		 * @see #show()
		 * @see #alertFactory
		 */
		public static function defaultAlertFactory():Alert
		{
			return new Alert();
		}

		/**
		 * Creates an alert, sets common properties, and adds it to the
		 * <code>PopUpManager</code> with the specified modal and centering
		 * options.
		 *
		 * <p>In the following example, an alert is shown when a
		 * <code>Button</code> is triggered:</p>
		 *
		 * <listing version="3.0">
		 * button.addEventListener( Event.TRIGGERED, button_triggeredHandler );
		 * 
		 * function button_triggeredHandler( event:Event ):void
		 * {
		 *     var alert:Alert = Alert.show( "This is an alert!", "Hello World", new ArrayCollection(
		 *     [
		 *         { label: "OK" }
		 *     ]);
		 * }</listing>
		 */
		public static function show(message:String, title:String = null, buttons:IListCollection = null,
			icon:DisplayObject = null, isModal:Boolean = true, isCentered:Boolean = true,
			customAlertFactory:Function = null, customOverlayFactory:Function = null):Alert
		{
			var factory:Function = customAlertFactory;
			if(factory == null)
			{
				factory = alertFactory != null ? alertFactory : defaultAlertFactory;
			}
			var alert:Alert = Alert(factory());
			alert.title = title;
			alert.message = message;
			alert.buttonsDataProvider = buttons;
			alert.icon = icon;
			factory = customOverlayFactory;
			if(factory == null)
			{
				factory = overlayFactory;
			}
			PopUpManager.addPopUp(alert, isModal, isCentered, factory);
			return alert;
		}

		/**
		 * @private
		 */
		protected static function defaultButtonGroupFactory():ButtonGroup
		{
			return new ButtonGroup();
		}

		/**
		 * Constructor.
		 */
		public function Alert()
		{
			super();
			this.headerStyleName = DEFAULT_CHILD_STYLE_NAME_HEADER;
			this.footerStyleName = DEFAULT_CHILD_STYLE_NAME_BUTTON_GROUP;
			if(this._fontStylesSet === null)
			{
				this._fontStylesSet = new FontStylesSet();
				this._fontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
			this.buttonGroupFactory = defaultButtonGroupFactory;
			this.addEventListener(Event.ADDED_TO_STAGE, alert_addedToStageHandler);
		}

		/**
		 * The value added to the <code>styleNameList</code> of the alert's
		 * message text renderer. This variable is <code>protected</code> so
		 * that sub-classes can customize the message style name in their
		 * constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_MESSAGE</code>.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var messageStyleName:String = DEFAULT_CHILD_STYLE_NAME_MESSAGE;

		/**
		 * The header sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected var headerHeader:Header;

		/**
		 * The button group sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected var buttonGroupFooter:ButtonGroup;

		/**
		 * The message text renderer sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected var messageTextRenderer:ITextRenderer;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return Alert.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _message:String = null;

		/**
		 * The alert's main text content.
		 */
		public function get message():String
		{
			return this._message;
		}

		/**
		 * @private
		 */
		public function set message(value:String):void
		{
			if(this._message == value)
			{
				return;
			}
			this._message = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _icon:DisplayObject;

		/**
		 * @private
		 */
		public function get icon():DisplayObject
		{
			return this._icon;
		}

		/**
		 * @private
		 */
		public function set icon(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._icon === value)
			{
				return;
			}
			var oldDisplayListBypassEnabled:Boolean = this.displayListBypassEnabled;
			this.displayListBypassEnabled = false;
			if(this._icon)
			{
				this._icon.removeEventListener(FeathersEventType.RESIZE, icon_resizeHandler);
				this.removeChild(this._icon);
			}
			this._icon = value;
			if(this._icon)
			{
				this._icon.addEventListener(FeathersEventType.RESIZE, icon_resizeHandler);
				this.addChild(this._icon);
			}
			this.displayListBypassEnabled = oldDisplayListBypassEnabled;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _gap:Number = 0;

		/**
		 * @private
		 */
		public function get gap():Number
		{
			return this._gap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._gap == value)
			{
				return;
			}
			this._gap = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _buttonsDataProvider:IListCollection = null;

		/**
		 * The data provider of the alert's <code>ButtonGroup</code>.
		 */
		public function get buttonsDataProvider():IListCollection
		{
			return this._buttonsDataProvider;
		}

		/**
		 * @private
		 */
		public function set buttonsDataProvider(value:IListCollection):void
		{
			if(this._buttonsDataProvider == value)
			{
				return;
			}
			this._buttonsDataProvider = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _acceptButtonIndex:int;

		/**
		 * The index of the button in the <code>buttonsDataProvider</code> to
		 * trigger when <code>Keyboard.ENTER</code> is pressed.
		 *
		 * <p>In the following example, the <code>acceptButtonIndex</code> is
		 * set to the first button in the data provider.</p>
		 *
		 * <listing version="3.0">
		 * var alert:Alert = Alert.show( "This is an alert!", "Hello World", new ArrayCollection(
		 * [
		 *     { label: "OK" }
		 * ]));
		 * alert.acceptButtonIndex = 0;</listing>
		 *
		 * @default -1
		 */
		public function get acceptButtonIndex():int
		{
			return this._acceptButtonIndex;
		}

		/**
		 * @private
		 */
		public function set acceptButtonIndex(value:int):void
		{
			this._acceptButtonIndex = value;
		}

		/**
		 * @private
		 */
		protected var _cancelButtonIndex:int;

		/**
		 * The index of the button in the <code>buttonsDataProvider</code> to
		 * trigger when <code>Keyboard.ESCAPE</code> or
		 * <code>Keyboard.BACK</code> is pressed.
		 *
		 * <p>In the following example, the <code>cancelButtonIndex</code> is
		 * set to the second button in the data provider.</p>
		 *
		 * <listing version="3.0">
		 * var alert:Alert = Alert.show( "This is an alert!", "Hello World", new ArrayCollection(
		 * [
		 *     { label: "OK" },
		 *     { label: "Cancel" },
		 * ]));
		 * alert.cancelButtonIndex = 1;</listing>
		 *
		 * @default -1
		 */
		public function get cancelButtonIndex():int
		{
			return this._cancelButtonIndex;
		}

		/**
		 * @private
		 */
		public function set cancelButtonIndex(value:int):void
		{
			this._cancelButtonIndex = value;
		}

		/**
		 * @private
		 */
		protected var _fontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get fontStyles():TextFormat
		{
			return this._fontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set fontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get disabledFontStyles():TextFormat
		{
			return this._fontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set disabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _messageFactory:Function;

		/**
		 * A function used to instantiate the alert's message text renderer
		 * sub-component. By default, the alert will use the global text
		 * renderer factory, <code>FeathersControl.defaultTextRendererFactory()</code>,
		 * to create the message text renderer. The message text renderer must
		 * be an instance of <code>ITextRenderer</code>. This factory can be
		 * used to change properties on the message text renderer when it is
		 * first created. For instance, if you are skinning Feathers components
		 * without a theme, you might use this factory to style the message text
		 * renderer.
		 *
		 * <p>If you are not using a theme, the message factory can be used to
		 * provide skin the message text renderer with appropriate text styles.</p>
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():ITextRenderer</pre>
		 *
		 * <p>In the following example, a custom message factory is passed to
		 * the alert:</p>
		 *
		 * <listing version="3.0">
		 * alert.messageFactory = function():ITextRenderer
		 * {
		 *     var messageRenderer:TextFieldTextRenderer = new TextFieldTextRenderer();
		 *     messageRenderer.textFormat = new TextFormat( "_sans", 12, 0xff0000 );
		 *     return messageRenderer;
		 * }</listing>
		 *
		 * @default null
		 *
		 * @see #message
		 * @see feathers.core.ITextRenderer
		 * @see feathers.core.FeathersControl#defaultTextRendererFactory
		 */
		public function get messageFactory():Function
		{
			return this._messageFactory;
		}

		/**
		 * @private
		 */
		public function set messageFactory(value:Function):void
		{
			if(this._messageFactory == value)
			{
				return;
			}
			this._messageFactory = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _messageProperties:PropertyProxy;

		/**
		 * An object that stores properties for the alert's message text
		 * renderer sub-component, and the properties will be passed down to the
		 * text renderer when the alert validates. The available properties
		 * depend on which <code>ITextRenderer</code> implementation is returned
		 * by <code>messageFactory</code>. Refer to
		 * <a href="../core/ITextRenderer.html"><code>feathers.core.ITextRenderer</code></a>
		 * for a list of available text renderer implementations.
		 *
		 * <p>In the following example, some properties are set for the alert's
		 * message text renderer (this example assumes that the message text
		 * renderer is a <code>BitmapFontTextRenderer</code>):</p>
		 *
		 * <listing version="3.0">
		 * alert.messageProperties.textFormat = new BitmapFontTextFormat( bitmapFont );
		 * alert.messageProperties.wordWrap = true;</listing>
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>messageFactory</code> function instead
		 * of using <code>messageProperties</code> will result in better
		 * performance.</p>
		 *
		 * @default null
		 *
		 * @see #messageFactory
		 * @see feathers.core.ITextRenderer
		 */
		public function get messageProperties():Object
		{
			if(!this._messageProperties)
			{
				this._messageProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._messageProperties;
		}

		/**
		 * @private
		 */
		public function set messageProperties(value:Object):void
		{
			if(this._messageProperties == value)
			{
				return;
			}
			if(value && !(value is PropertyProxy))
			{
				value = PropertyProxy.fromObject(value);
			}
			if(this._messageProperties)
			{
				this._messageProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._messageProperties = PropertyProxy(value);
			if(this._messageProperties)
			{
				this._messageProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _customMessageStyleName:String;

		/**
		 * @private
		 */
		public function get customMessageStyleName():String
		{
			return this._customMessageStyleName;
		}

		/**
		 * @private
		 */
		public function set customMessageStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customMessageStyleName === value)
			{
				return;
			}
			this._customMessageStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * A function used to generate the alerts's button group sub-component.
		 * The button group must be an instance of <code>ButtonGroup</code>.
		 * This factory can be used to change properties on the button group
		 * when it is first created. For instance, if you are skinning Feathers
		 * components without a theme, you might use this factory to set skins
		 * and other styles on the button group.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():ButtonGroup</pre>
		 *
		 * <p>In the following example, a custom button group factory is
		 * provided to the alert:</p>
		 *
		 * <listing version="3.0">
		 * alert.buttonGroupFactory = function():ButtonGroup
		 * {
		 *     return new ButtonGroup();
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.ButtonGroup
		 */
		public function get buttonGroupFactory():Function
		{
			return super.footerFactory;
		}

		/**
		 * @private
		 */
		public function set buttonGroupFactory(value:Function):void
		{
			super.footerFactory = value;
		}

		/**
		 * @private
		 */
		public function get customButtonGroupStyleName():String
		{
			return super.customFooterStyleName;
		}

		/**
		 * @private
		 */
		public function set customButtonGroupStyleName(value:String):void
		{
			super.customFooterStyleName = value;
		}

		/**
		 * An object that stores properties for the alert's button group
		 * sub-component, and the properties will be passed down to the button
		 * group when the alert validates. For a list of available properties,
		 * refer to <a href="ButtonGroup.html"><code>feathers.controls.ButtonGroup</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>buttonGroupFactory</code> function
		 * instead of using <code>buttonGroupProperties</code> will result in better
		 * performance.</p>
		 *
		 * <p>In the following example, the button group properties are customized:</p>
		 *
		 * <listing version="3.0">
		 * alert.buttonGroupProperties.gap = 20;</listing>
		 *
		 * @default null
		 *
		 * @see #buttonGroupFactory
		 * @see feathers.controls.ButtonGroup
		 */
		public function get buttonGroupProperties():Object
		{
			return super.footerProperties;
		}

		/**
		 * @private
		 */
		public function set buttonGroupProperties(value:Object):void
		{
			super.footerProperties = value;
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this._fontStylesSet !== null)
			{
				this._fontStylesSet.dispose();
				this._fontStylesSet = null;
			}
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(this._layout === null)
			{
				var layout:VerticalLayout = new VerticalLayout();
				layout.horizontalAlign = HorizontalAlign.JUSTIFY;
				this.ignoreNextStyleRestriction();
				this.layout = layout;
			}
			super.initialize();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var textRendererInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_TEXT_RENDERER);

			if(textRendererInvalid)
			{
				this.createMessage();
			}

			if(textRendererInvalid || dataInvalid)
			{
				this.messageTextRenderer.text = this._message;
			}

			if(textRendererInvalid || stylesInvalid)
			{
				this.refreshMessageStyles();
			}

			super.draw();

			if(this._icon !== null)
			{
				if(this._icon is IValidating)
				{
					IValidating(this._icon).validate();
				}
				this._icon.x = this._paddingLeft;
				this._icon.y = this._topViewPortOffset + (this._viewPort.visibleHeight - this._icon.height) / 2;
			}
		}

		/**
		 * @private
		 */
		override protected function autoSizeIfNeeded():Boolean
		{
			if(this._autoSizeMode === AutoSizeMode.STAGE)
			{
				//the implementation in a super class can handle this
				return super.autoSizeIfNeeded();
			}

			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			resetFluidChildDimensionsForMeasurement(this.currentBackgroundSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitBackgroundWidth, this._explicitBackgroundHeight,
				this._explicitBackgroundMinWidth, this._explicitBackgroundMinHeight,
				this._explicitBackgroundMaxWidth, this._explicitBackgroundMaxHeight);
			var measureBackground:IMeasureDisplayObject = this.currentBackgroundSkin as IMeasureDisplayObject;
			if(this.currentBackgroundSkin is IValidating)
			{
				IValidating(this.currentBackgroundSkin).validate();
			}

			if(this._icon is IValidating)
			{
				IValidating(this._icon).validate();
			}

			//we don't measure the header and footer here because they are
			//handled in calculateViewPortOffsets(), which is automatically
			//called by Scroller before autoSizeIfNeeded().

			var newWidth:Number = this._explicitWidth;
			var newHeight:Number = this._explicitHeight;
			var newMinWidth:Number = this._explicitMinWidth;
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsWidth)
			{
				if(this._measureViewPort)
				{
					newWidth = this._viewPort.visibleWidth;
				}
				else
				{
					newWidth = 0;
				}
				//we don't need to account for the icon and gap because it is
				//already included in the left offset
				newWidth += this._rightViewPortOffset + this._leftViewPortOffset;
				var headerWidth:Number = this.header.width + this._outerPaddingLeft + this._outerPaddingRight;
				if(headerWidth > newWidth)
				{
					newWidth = headerWidth;
				}
				if(this.footer !== null)
				{
					var footerWidth:Number = this.footer.width + this._outerPaddingLeft + this._outerPaddingRight;
					if(footerWidth > newWidth)
					{
						newWidth = footerWidth;
					}
				}
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.width > newWidth)
				{
					newWidth = this.currentBackgroundSkin.width;
				}
			}
			if(needsHeight)
			{
				if(this._measureViewPort)
				{
					newHeight = this._viewPort.visibleHeight;
				}
				else
				{
					newHeight = 0;
				}
				if(this._icon !== null)
				{
					var iconHeight:Number = this._icon.height;
					if(iconHeight === iconHeight && //!isNaN
						iconHeight > newHeight)
					{
						newHeight = iconHeight;
					}
				}
				newHeight += this._bottomViewPortOffset + this._topViewPortOffset;
				//we don't need to account for the header and footer because
				//they're already included in the top and bottom offsets
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.height > newHeight)
				{
					newHeight = this.currentBackgroundSkin.height;
				}
			}
			if(needsMinWidth)
			{
				if(this._measureViewPort)
				{
					newMinWidth = this._viewPort.minVisibleWidth;
				}
				else
				{
					newMinWidth = 0;
				}
				//we don't need to account for the icon and gap because it is
				//already included in the left offset
				newMinWidth += this._rightViewPortOffset + this._leftViewPortOffset;
				var headerMinWidth:Number = this.header.minWidth + this._outerPaddingLeft + this._outerPaddingRight;
				if(headerMinWidth > newMinWidth)
				{
					newMinWidth = headerMinWidth;
				}
				if(this.footer !== null)
				{
					var footerMinWidth:Number = this.footer.minWidth + this._outerPaddingLeft + this._outerPaddingRight;
					if(footerMinWidth > newMinWidth)
					{
						newMinWidth = footerMinWidth;
					}
				}
				if(this.currentBackgroundSkin !== null)
				{
					if(measureBackground !== null)
					{
						if(measureBackground.minWidth > newMinWidth)
						{
							newMinWidth = measureBackground.minWidth;
						}
					}
					else if(this._explicitBackgroundMinWidth > newMinWidth)
					{
						newMinWidth = this._explicitBackgroundMinWidth;
					}
				}
			}
			if(needsMinHeight)
			{
				if(this._measureViewPort)
				{
					newMinHeight = this._viewPort.minVisibleHeight;
				}
				else
				{
					newMinHeight = 0;
				}
				if(this._icon !== null)
				{
					iconHeight = this._icon.height;
					if(iconHeight === iconHeight && //!isNaN
						iconHeight > newMinHeight)
					{
						newMinHeight = iconHeight;
					}
				}
				newMinHeight += this._bottomViewPortOffset + this._topViewPortOffset;
				//we don't need to account for the header and footer because
				//they're already included in the top and bottom offsets
				if(this.currentBackgroundSkin !== null)
				{
					if(measureBackground !== null)
					{
						if(measureBackground.minHeight > newMinHeight)
						{
							newMinHeight = measureBackground.minHeight;
						}
					}
					else if(this._explicitBackgroundMinHeight > newMinHeight)
					{
						newMinHeight = this._explicitBackgroundMinHeight;
					}
				}
			}

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * Creates and adds the <code>header</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #header
		 * @see #headerFactory
		 * @see #style:customHeaderStyleName
		 */
		override protected function createHeader():void
		{
			super.createHeader();
			this.headerHeader = Header(this.header);
		}

		/**
		 * Creates and adds the <code>buttonGroupFooter</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #buttonGroupFooter
		 * @see #buttonGroupFactory
		 * @see #style:customButtonGroupStyleName
		 */
		protected function createButtonGroup():void
		{
			if(this.buttonGroupFooter)
			{
				this.buttonGroupFooter.removeEventListener(Event.TRIGGERED, buttonsFooter_triggeredHandler);
			}
			super.createFooter();
			this.buttonGroupFooter = ButtonGroup(this.footer);
			this.buttonGroupFooter.addEventListener(Event.TRIGGERED, buttonsFooter_triggeredHandler);
		}

		/**
		 * @private
		 */
		override protected function createFooter():void
		{
			this.createButtonGroup();
		}

		/**
		 * Creates and adds the <code>messageTextRenderer</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #message
		 * @see #messageTextRenderer
		 * @see #messageFactory
		 */
		protected function createMessage():void
		{
			if(this.messageTextRenderer)
			{
				this.removeChild(DisplayObject(this.messageTextRenderer), true);
				this.messageTextRenderer = null;
			}

			var factory:Function = this._messageFactory != null ? this._messageFactory : FeathersControl.defaultTextRendererFactory;
			this.messageTextRenderer = ITextRenderer(factory());
			this.messageTextRenderer.wordWrap = true;
			var messageStyleName:String = this._customMessageStyleName != null ? this._customMessageStyleName : this.messageStyleName;
			var uiTextRenderer:IFeathersControl = IFeathersControl(this.messageTextRenderer);
			uiTextRenderer.styleNameList.add(messageStyleName);
			uiTextRenderer.touchable = false;
			this.addChild(DisplayObject(this.messageTextRenderer));
		}

		/**
		 * @private
		 */
		override protected function refreshFooterStyles():void
		{
			super.refreshFooterStyles();
			this.buttonGroupFooter.dataProvider = this._buttonsDataProvider;
		}

		/**
		 * @private
		 */
		protected function refreshMessageStyles():void
		{
			this.messageTextRenderer.fontStyles = this._fontStylesSet;
			for(var propertyName:String in this._messageProperties)
			{
				var propertyValue:Object = this._messageProperties[propertyName];
				this.messageTextRenderer[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		override protected function calculateViewPortOffsets(forceScrollBars:Boolean = false, useActualBounds:Boolean = false):void
		{
			super.calculateViewPortOffsets(forceScrollBars, useActualBounds);
			if(this._icon !== null)
			{
				if(this._icon is IValidating)
				{
					IValidating(this._icon).validate();
				}
				var iconWidth:Number = this._icon.width;
				if(iconWidth === iconWidth) //!isNaN
				{
					this._leftViewPortOffset += iconWidth + this._gap;
				}
			}
		}

		/**
		 * @private
		 */
		protected function closeAlert(item:Object):void
		{
			this.removeFromParent();
			this.dispatchEventWith(Event.CLOSE, false, item);
			this.dispose();
		}

		/**
		 * @private
		 */
		protected function buttonsFooter_triggeredHandler(event:Event, data:Object):void
		{
			this.closeAlert(data);
		}

		/**
		 * @private
		 */
		protected function icon_resizeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected function fontStyles_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function alert_addedToStageHandler(event:Event):void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			//using priority here is a hack so that objects higher up in the
			//display list have a chance to cancel the event first.
			var priority:int = -getDisplayObjectDepthFromStage(this);
			starling.nativeStage.addEventListener(KeyboardEvent.KEY_DOWN, alert_nativeStage_keyDownHandler, false, priority, true);
			this.addEventListener(Event.REMOVED_FROM_STAGE, alert_removedFromStageHandler);
		}

		/**
		 * @private
		 */
		protected function alert_removedFromStageHandler(event:Event):void
		{
			this.removeEventListener(Event.REMOVED_FROM_STAGE, alert_removedFromStageHandler);
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			starling.nativeStage.removeEventListener(KeyboardEvent.KEY_DOWN, alert_nativeStage_keyDownHandler);
		}

		/**
		 * @private
		 */
		protected function alert_nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.isDefaultPrevented())
			{
				//someone else already handled this one
				return;
			}
			if(this._buttonsDataProvider === null)
			{
				//no buttons to trigger
				return;
			}
			var keyCode:uint = event.keyCode;
			if(this._acceptButtonIndex != -1 && keyCode == Keyboard.ENTER)
			{
				//don't let the OS handle the event
				event.preventDefault();
				var item:Object = this._buttonsDataProvider.getItemAt(this._acceptButtonIndex);
				this.closeAlert(item);
				return;
			}
			if(this._cancelButtonIndex != -1 &&
				(keyCode == Keyboard.BACK || keyCode == Keyboard.ESCAPE))
			{
				//don't let the OS handle the event
				event.preventDefault();
				item = this._buttonsDataProvider.getItemAt(this._cancelButtonIndex);
				this.closeAlert(item);
				return;
			}
		}

	}
}


================================================
FILE: source/feathers/controls/AutoComplete.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.popups.DropDownPopUpContentManager;
	import feathers.controls.popups.IPopUpContentManager;
	import feathers.core.PropertyProxy;
	import feathers.data.ArrayCollection;
	import feathers.data.IAutoCompleteSource;
	import feathers.data.IListCollection;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;
	import feathers.utils.display.getDisplayObjectDepthFromStage;

	import flash.events.KeyboardEvent;
	import flash.ui.Keyboard;
	import flash.utils.getTimer;

	import starling.events.Event;
	import starling.events.EventDispatcher;
	import starling.events.KeyboardEvent;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	/**
	 * A style name to add to the list sub-component of the
	 * <code>AutoComplete</code>. Typically used by a theme to provide
	 * different styles to different <code>AutoComplete</code> instances.
	 *
	 * <p>In the following example, a custom list style name is passed to the
	 * <code>AutoComplete</code>:</p>
	 *
	 * <listing version="3.0">
	 * input.customListStyleName = "my-custom-list";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to provide
	 * different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( List ).setFunctionForStyleName( "my-custom-list", setCustomListStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_LIST
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #listFactory
	 */
	[Style(name="customListStyleName",type="String")]

	/**
	 * A manager that handles the details of how to display the pop-up list.
	 *
	 * <p>In the following example, a pop-up content manager is provided:</p>
	 *
	 * <listing version="3.0">
	 * input.popUpContentManager = new CalloutPopUpContentManager();</listing>
	 *
	 * @default null
	 */
	[Style(name="popUpContentManager",type="feathers.controls.popups.IPopUpContentManager")]

	/**
	 * Dispatched when the pop-up list is opened.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.OPEN
	 */
	[Event(name="open",type="starling.events.Event")]

	/**
	 * Dispatched when the pop-up list is closed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CLOSE
	 */
	[Event(name="close",type="starling.events.Event")]

	/**
	 * A text input that provides a pop-up list with suggestions as you type.
	 *
	 * <p>The following example creates an <code>AutoComplete</code> with a
	 * local collection of suggestions:</p>
	 *
	 * <listing version="3.0">
	 * var input:AutoComplete = new AutoComplete();
	 * input.source = new LocalAutoCompleteSource( new VectorCollection(new &lt;String&gt;
	 * [
	 *     "Apple",
	 *     "Banana",
	 *     "Cherry",
	 *     "Grape",
	 *     "Lemon",
	 *     "Orange",
	 *     "Watermelon"
	 * ]));
	 * this.addChild( input );</listing>
	 *
	 * @see ../../../help/auto-complete.html How to use the Feathers AutoComplete component
	 * @see feathers.controls.TextInput
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class AutoComplete extends TextInput
	{
		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_LIST_FACTORY:String = "listFactory";

		/**
		 * The default value added to the <code>styleNameList</code> of the pop-up
		 * list.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_LIST:String = "feathers-auto-complete-list";

		/**
		 * The default <code>IStyleProvider</code> for all
		 * <code>AutoComplete</code> components. If <code>null</code>, falls
		 * back to using <code>TextInput.globalStyleProvider</code> instead.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static function defaultListFactory():List
		{
			return new List();
		}

		/**
		 * Constructor.
		 */
		public function AutoComplete()
		{
			this.addEventListener(Event.CHANGE, autoComplete_changeHandler);
		}

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * pop-up list. This variable is <code>protected</code> so that
		 * sub-classes can customize the list style name in their constructors
		 * instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_LIST</code>.
		 *
		 * <p>To customize the pop-up list name without subclassing, see
		 * <code>customListStyleName</code>.</p>
		 *
		 * @see #style:customListStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var listStyleName:String = DEFAULT_CHILD_STYLE_NAME_LIST;

		/**
		 * The list sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #listFactory
		 * @see #createList()
		 */
		protected var list:List;

		/**
		 * @private
		 */
		protected var _listCollection:IListCollection;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			if(AutoComplete.globalStyleProvider)
			{
				return AutoComplete.globalStyleProvider;
			}
			return TextInput.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _originalText:String;

		/**
		 * @private
		 */
		protected var _source:IAutoCompleteSource;

		/**
		 * The source of the suggestions that appear in the pop-up list.
		 *
		 * <p>In the following example, a source of suggestions is provided:</p>
		 *
		 * <listing version="3.0">
		 * input.source = new LocalAutoCompleteSource( new VectorCollection(new &lt;String&gt;
		 * [
		 *     "Apple",
		 *     "Banana",
		 *     "Cherry",
		 *     "Grape",
		 *     "Lemon",
		 *     "Orange",
		 *     "Watermelon"
		 * ]));</listing>
		 *
		 * @default null
		 */
		public function get source():IAutoCompleteSource
		{
			return this._source;
		}

		/**
		 * @private
		 */
		public function set source(value:IAutoCompleteSource):void
		{
			if(this._source == value)
			{
				return;
			}
			if(this._source)
			{
				this._source.removeEventListener(Event.COMPLETE, dataProvider_completeHandler);
			}
			this._source = value;
			if(this._source)
			{
				this._source.addEventListener(Event.COMPLETE, dataProvider_completeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _autoCompleteDelay:Number = 0.5;

		/**
		 * The time, in seconds, after the text has changed before requesting
		 * suggestions from the <code>IAutoCompleteSource</code>.
		 *
		 * <p>In the following example, the delay is changed to 1.5 seconds:</p>
		 *
		 * <listing version="3.0">
		 * input.autoCompleteDelay = 1.5;</listing>
		 *
		 * @default 0.5
		 *
		 * @see #source
		 */
		public function get autoCompleteDelay():Number
		{
			return this._autoCompleteDelay;
		}

		/**
		 * @private
		 */
		public function set autoCompleteDelay(value:Number):void
		{
			this._autoCompleteDelay = value;
		}

		/**
		 * @private
		 */
		protected var _minimumAutoCompleteLength:int = 2;

		/**
		 * The minimum number of entered characters required to request
		 * suggestions from the <code>IAutoCompleteSource</code>.
		 *
		 * <p>In the following example, the minimum number of characters is
		 * changed to <code>3</code>:</p>
		 *
		 * <listing version="3.0">
		 * input.minimumAutoCompleteLength = 3;</listing>
		 *
		 * @default 2
		 *
		 * @see #source
		 */
		public function get minimumAutoCompleteLength():int
		{
			return this._minimumAutoCompleteLength;
		}

		/**
		 * @private
		 */
		public function set minimumAutoCompleteLength(value:int):void
		{
			this._minimumAutoCompleteLength = value;
		}

		/**
		 * @private
		 */
		protected var _popUpContentManager:IPopUpContentManager;

		/**
		 * @private
		 */
		public function get popUpContentManager():IPopUpContentManager
		{
			return this._popUpContentManager;
		}

		/**
		 * @private
		 */
		public function set popUpContentManager(value:IPopUpContentManager):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._popUpContentManager === value)
			{
				return;
			}
			if(this._popUpContentManager is EventDispatcher)
			{
				var dispatcher:EventDispatcher = EventDispatcher(this._popUpContentManager);
				dispatcher.removeEventListener(Event.OPEN, popUpContentManager_openHandler);
				dispatcher.removeEventListener(Event.CLOSE, popUpContentManager_closeHandler);
			}
			this._popUpContentManager = value;
			if(this._popUpContentManager is EventDispatcher)
			{
				dispatcher = EventDispatcher(this._popUpContentManager);
				dispatcher.addEventListener(Event.OPEN, popUpContentManager_openHandler);
				dispatcher.addEventListener(Event.CLOSE, popUpContentManager_closeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _listFactory:Function;

		/**
		 * A function used to generate the pop-up list sub-component. The list
		 * must be an instance of <code>List</code>. This factory can be used to
		 * change properties on the list when it is first created. For instance,
		 * if you are skinning Feathers components without a theme, you might
		 * use this factory to set skins and other styles on the list.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():List</pre>
		 *
		 * <p>In the following example, a custom list factory is passed to the
		 * <code>AutoComplete</code>:</p>
		 *
		 * <listing version="3.0">
		 * input.listFactory = function():List
		 * {
		 *     var popUpList:List = new List();
		 *     popUpList.backgroundSkin = new Image( texture );
		 *     return popUpList;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.List
		 */
		public function get listFactory():Function
		{
			return this._listFactory;
		}

		/**
		 * @private
		 */
		public function set listFactory(value:Function):void
		{
			if(this._listFactory == value)
			{
				return;
			}
			this._listFactory = value;
			this.invalidate(INVALIDATION_FLAG_LIST_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customListStyleName:String;

		/**
		 * @private
		 */
		public function get customListStyleName():String
		{
			return this._customListStyleName;
		}

		/**
		 * @private
		 */
		public function set customListStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customListStyleName === value)
			{
				return;
			}
			this._customListStyleName = value;
			this.invalidate(INVALIDATION_FLAG_LIST_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _listProperties:PropertyProxy;

		/**
		 * An object that stores properties for the auto-complete's pop-up list
		 * sub-component, and the properties will be passed down to the pop-up
		 * list when the auto-complete validates. For a list of available
		 * properties, refer to
		 * <a href="List.html"><code>feathers.controls.List</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>listFactory</code> function
		 * instead of using <code>listProperties</code> will result in better
		 * performance.</p>
		 *
		 * <p>In the following example, the list properties are passed to the
		 * auto complete:</p>
		 *
		 * <listing version="3.0">
		 * input.listProperties.backgroundSkin = new Image( texture );</listing>
		 *
		 * @default null
		 *
		 * @see #listFactory
		 * @see feathers.controls.List
		 */
		public function get listProperties():Object
		{
			if(!this._listProperties)
			{
				this._listProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._listProperties;
		}

		/**
		 * @private
		 */
		public function set listProperties(value:Object):void
		{
			if(this._listProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._listProperties)
			{
				this._listProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._listProperties = PropertyProxy(value);
			if(this._listProperties)
			{
				this._listProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _ignoreAutoCompleteChanges:Boolean = false;

		/**
		 * @private
		 */
		protected var _lastChangeTime:int = 0;

		/**
		 * @private
		 */
		protected var _listHasFocus:Boolean = false;

		/**
		 * @private
		 */
		protected var _listTouchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _triggered:Boolean = false;

		/**
		 * @private
		 */
		protected var _isOpenListPending:Boolean = false;

		/**
		 * @private
		 */
		protected var _isCloseListPending:Boolean = false;

		/**
		 * Opens the pop-up list, if it isn't already open.
		 */
		public function openList():void
		{
			this._isCloseListPending = false;
			if(this._popUpContentManager.isOpen)
			{
				return;
			}
			if(!this._isValidating && this.isInvalid())
			{
				this._isOpenListPending = true;
				return;
			}
			this._isOpenListPending = false;
			this._popUpContentManager.open(this.list, this);
			this.list.validate();
			if(this._focusManager)
			{
				this.stage.addEventListener(starling.events.KeyboardEvent.KEY_UP, stage_keyUpHandler);
			}
		}

		/**
		 * Closes the pop-up list, if it is open.
		 */
		public function closeList():void
		{
			this._isOpenListPending = false;
			if(!this._popUpContentManager.isOpen)
			{
				return;
			}
			if(!this._isValidating && this.isInvalid())
			{
				this._isCloseListPending = true;
				return;
			}
			if(this._listHasFocus)
			{
				this.list.dispatchEventWith(FeathersEventType.FOCUS_OUT);
			}
			this._isCloseListPending = false;
			this.list.validate();
			//don't clean up anything from openList() in closeList(). The list
			//may be closed by removing it from the PopUpManager, which would
			//result in closeList() never being called.
			//instead, clean up in the Event.REMOVED_FROM_STAGE listener.
			this._popUpContentManager.close();
		}

		/**
		 * @inheritDoc
		 */
		override public function dispose():void
		{
			this.source = null;
			if(this.list)
			{
				this.closeList();
				this.list.dispose();
				this.list = null;
			}
			if(this._popUpContentManager)
			{
				this._popUpContentManager.dispose();
				this._popUpContentManager = null;
			}
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			super.initialize();

			this._listCollection = new ArrayCollection();
			if(this._popUpContentManager === null)
			{
				this.ignoreNextStyleRestriction();
				this.popUpContentManager = new DropDownPopUpContentManager();
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var listFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LIST_FACTORY);

			super.draw();

			if(listFactoryInvalid)
			{
				this.createList();
			}

			if(listFactoryInvalid || stylesInvalid)
			{
				this.refreshListProperties();
			}

			this.handlePendingActions();
		}

		/**
		 * Creates and adds the <code>list</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #list
		 * @see #listFactory
		 * @see #style:customListStyleName
		 */
		protected function createList():void
		{
			if(this.list)
			{
				this.list.removeFromParent(false);
				//disposing separately because the list may not have a parent
				this.list.dispose();
				this.list = null;
			}

			var factory:Function = this._listFactory != null ? this._listFactory : defaultListFactory;
			var listStyleName:String = this._customListStyleName != null ? this._customListStyleName : this.listStyleName;
			this.list = List(factory());
			this.list.focusOwner = this;
			this.list.isFocusEnabled = false;
			this.list.isChildFocusEnabled = false;
			this.list.styleNameList.add(listStyleName);
			this.list.addEventListener(Event.CHANGE, list_changeHandler);
			this.list.addEventListener(Event.TRIGGERED, list_triggeredHandler);
			this.list.addEventListener(TouchEvent.TOUCH, list_touchHandler);
			this.list.addEventListener(Event.REMOVED_FROM_STAGE, list_removedFromStageHandler);
		}

		/**
		 * @private
		 */
		protected function refreshListProperties():void
		{
			for(var propertyName:String in this._listProperties)
			{
				var propertyValue:Object = this._listProperties[propertyName];
				this.list[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function handlePendingActions():void
		{
			if(this._isOpenListPending)
			{
				this.openList();
			}
			if(this._isCloseListPending)
			{
				this.closeList();
			}
		}

		/**
		 * @private
		 */
		override protected function focusInHandler(event:Event):void
		{
			//using priority here is a hack so that objects deeper in the
			//display list have a chance to cancel the event first.
			var priority:int = -getDisplayObjectDepthFromStage(this);
			this.stage.starling.nativeStage.addEventListener(flash.events.KeyboardEvent.KEY_DOWN, nativeStage_keyDownHandler, false, priority, true);
			super.focusInHandler(event);
		}

		/**
		 * @private
		 */
		override protected function focusOutHandler(event:Event):void
		{
			this.stage.starling.nativeStage.removeEventListener(flash.events.KeyboardEvent.KEY_DOWN, nativeStage_keyDownHandler);
			super.focusOutHandler(event);
		}

		/**
		 * @private
		 */
		protected function nativeStage_keyDownHandler(event:flash.events.KeyboardEvent):void
		{
			if(!this._popUpContentManager.isOpen)
			{
				return;
			}
			if(event.isDefaultPrevented())
			{
				return;
			}
			var isDown:Boolean = event.keyCode == Keyboard.DOWN;
			var isUp:Boolean = event.keyCode == Keyboard.UP;
			if(!isDown && !isUp)
			{
				return;
			}
			var oldSelectedIndex:int = this.list.selectedIndex;
			var lastIndex:int = this.list.dataProvider.length - 1;
			if(oldSelectedIndex < 0)
			{
				event.preventDefault();
				this._originalText = this._text;
				if(isDown)
				{
					this.list.selectedIndex = 0;
				}
				else
				{
					this.list.selectedIndex = lastIndex;
				}
				this.list.scrollToDisplayIndex(this.list.selectedIndex, this.list.keyScrollDuration);
				this._listHasFocus = true;
				this.list.dispatchEventWith(FeathersEventType.FOCUS_IN);
			}
			else if((isDown && oldSelectedIndex == lastIndex) ||
				(isUp && oldSelectedIndex == 0))
			{
				event.preventDefault();
				var oldIgnoreAutoCompleteChanges:Boolean = this._ignoreAutoCompleteChanges;
				this._ignoreAutoCompleteChanges = true;
				this.text = this._originalText;
				this._ignoreAutoCompleteChanges = oldIgnoreAutoCompleteChanges;
				this.list.selectedIndex = -1;
				this.selectRange(this.text.length, this.text.length);
				this._listHasFocus = false;
				this.list.dispatchEventWith(FeathersEventType.FOCUS_OUT);
			}
		}

		/**
		 * @private
		 */
		protected function autoComplete_changeHandler(event:Event):void
		{
			if(this._ignoreAutoCompleteChanges || !this._source || !this.hasFocus)
			{
				return;
			}
			if(this.text.length < this._minimumAutoCompleteLength)
			{
				this.removeEventListener(Event.ENTER_FRAME, autoComplete_enterFrameHandler);
				this.closeList();
				return;
			}

			if(this._autoCompleteDelay == 0)
			{
				//just in case the enter frame listener was added before
				//sourceUpdateDelay was set to 0.
				this.removeEventListener(Event.ENTER_FRAME, autoComplete_enterFrameHandler);

				this._source.load(this.text, this._listCollection);
			}
			else
			{
				this._lastChangeTime = getTimer();
				this.addEventListener(Event.ENTER_FRAME, autoComplete_enterFrameHandler);
			}
		}

		/**
		 * @private
		 */
		protected function autoComplete_enterFrameHandler():void
		{
			var currentTime:int = getTimer();
			var secondsSinceLastUpdate:Number = (currentTime - this._lastChangeTime) / 1000;
			if(secondsSinceLastUpdate < this._autoCompleteDelay)
			{
				return;
			}
			this.removeEventListener(Event.ENTER_FRAME, autoComplete_enterFrameHandler);
			this._source.load(this.text, this._listCollection);
		}

		/**
		 * @private
		 */
		protected function dataProvider_completeHandler(event:Event, data:IListCollection):void
		{
			this.list.dataProvider = data;
			if(data.length == 0)
			{
				if(this._popUpContentManager.isOpen)
				{
					this.closeList();
				}
				return;
			}
			this.openList();
		}

		/**
		 * @private
		 */
		protected function list_changeHandler(event:Event):void
		{
			if(!this.list.selectedItem)
			{
				return;
			}
			var oldIgnoreAutoCompleteChanges:Boolean = this._ignoreAutoCompleteChanges;
			this._ignoreAutoCompleteChanges = true;
			this.text = this.list.selectedItem.toString();
			this.selectRange(this.text.length, this.text.length);
			this._ignoreAutoCompleteChanges = oldIgnoreAutoCompleteChanges;
		}

		/**
		 * @private
		 */
		protected function popUpContentManager_openHandler(event:Event):void
		{
			this.dispatchEventWith(Event.OPEN);
		}

		/**
		 * @private
		 */
		protected function popUpContentManager_closeHandler(event:Event):void
		{
			this.dispatchEventWith(Event.CLOSE);
		}

		/**
		 * @private
		 */
		protected function list_removedFromStageHandler(event:Event):void
		{
			if(this._focusManager)
			{
				this.list.stage.removeEventListener(starling.events.KeyboardEvent.KEY_UP, stage_keyUpHandler);
			}
		}

		/**
		 * @private
		 */
		protected function list_triggeredHandler(event:Event):void
		{
			if(!this._isEnabled)
			{
				return;
			}
			if(this._listTouchPointID == -1)
			{
				//triggered by keyboard
				this.closeList();
				this.selectRange(this.text.length, this.text.length);
				return;
			}
			this._triggered = true;
		}

		/**
		 * @private
		 */
		protected function list_touchHandler(event:TouchEvent):void
		{
			var touch:Touch = event.getTouch(this.list);
			if(touch === null)
			{
				return;
			}
			if(touch.phase === TouchPhase.BEGAN)
			{
				this._listTouchPointID = touch.id;
				this._triggered = false;
			}
			if(touch.phase === TouchPhase.ENDED && this._triggered)
			{
				this._listTouchPointID = -1;
				this.closeList();
				this.selectRange(this.text.length, this.text.length);
			}
		}

		/**
		 * @private
		 */
		protected function stage_keyUpHandler(event:starling.events.KeyboardEvent):void
		{
			if(!this._popUpContentManager.isOpen)
			{
				return;
			}
			if(event.keyCode == Keyboard.ENTER)
			{
				this.closeList();
				this.selectRange(this.text.length, this.text.length);
			}
		}
	}
}


================================================
FILE: source/feathers/controls/AutoSizeMode.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * Constants that determine how a component should automatically calculate
	 * its own dimensions when no explicit dimensions are provided.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class AutoSizeMode
	{
		/**
		 * The component will automatically calculate its dimensions to fill the
		 * entire stage.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const STAGE:String = "stage";

		/**
		 * The component will automatically calculate its dimensions to fit its
		 * content's ideal dimensions.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const CONTENT:String = "content";
	}
}


================================================
FILE: source/feathers/controls/BasicButton.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IStateContext;
	import feathers.core.IStateObserver;
	import feathers.core.IValidating;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;
	import feathers.utils.touch.TapToTrigger;
	import feathers.utils.touch.TouchToState;

	import flash.geom.Point;

	import starling.display.DisplayObject;

	/**
	 * The skin used when no other skin is defined for the current state.
	 * Intended to be used when multiple states should share the same skin.
	 *
	 * <p>The following example gives the button a default skin to use for
	 * all states when no specific skin is available:</p>
	 *
	 * <listing version="3.0">
	 * button.defaultSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #setSkinForState()
	 */
	[Style(name="defaultSkin",type="starling.display.DisplayObject")]

	/**
	 * The skin used for the button's disabled state. If <code>null</code>,
	 * then <code>defaultSkin</code> is used instead.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToSkinFunction</code> property.</p>
	 *
	 * <p>The following example gives the button a skin for the disabled state:</p>
	 *
	 * <listing version="3.0">
	 * button.disabledSkin = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setSkinForState()</code> with
	 * <code>ButtonState.DISABLED</code> to set the same skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * button.setSkinForState( ButtonState.DISABLED, skin );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultSkin
	 * @see #setSkinForState()
	 * @see feathers.controls.ButtonState#DISABLED
	 */
	[Style(name="disabledSkin",type="starling.display.DisplayObject")]

	/**
	 * The skin used for the button's down state. If <code>null</code>, then
	 * <code>defaultSkin</code> is used instead.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToSkinFunction</code> property.</p>
	 *
	 * <p>The following example gives the button a skin for the down state:</p>
	 *
	 * <listing version="3.0">
	 * button.downSkin = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setSkinForState()</code> with
	 * <code>ButtonState.DOWN</code> to set the same skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * button.setSkinForState( ButtonState.DOWN, skin );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultSkin
	 * @see #setSkinForState()
	 * @see feathers.controls.ButtonState#DOWN
	 */
	[Style(name="downSkin",type="starling.display.DisplayObject")]

	/**
	 * The skin used for the button's hover state. If <code>null</code>, then
	 * <code>defaultSkin</code> is used instead.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToSkinFunction</code> property.</p>
	 *
	 * <p>The following example gives the button a skin for the hover state:</p>
	 *
	 * <listing version="3.0">
	 * button.hoverSkin = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setSkinForState()</code> with
	 * <code>ButtonState.HOVER</code> to set the same skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * button.setSkinForState( ButtonState.HOVER, skin );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultSkin
	 * @see #setSkinForState()
	 * @see feathers.controls.ButtonState#HOVER
	 */
	[Style(name="hoverSkin",type="starling.display.DisplayObject")]

	/**
	 * Determines if a pressed button should remain in the down state if a
	 * touch moves outside of the button's bounds. Useful for controls like
	 * <code>Slider</code> and <code>ToggleSwitch</code> to keep a thumb in
	 * the down state while it is dragged around.
	 *
	 * <p>The following example ensures that the button's down state remains
	 * active when the button is pressed but the touch moves outside the
	 * button's bounds:</p>
	 *
	 * <listing version="3.0">
	 * button.keepDownStateOnRollOut = true;</listing>
	 *
	 * @default false
	 */
	[Style(name="keepDownStateOnRollOut",type="Boolean")]

	/**
	 * The skin used for the button's up state. If <code>null</code>, then
	 * <code>defaultSkin</code> is used instead.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToSkinFunction</code> property.</p>
	 *
	 * <p>The following example gives the button a skin for the up state:</p>
	 *
	 * <listing version="3.0">
	 * button.upSkin = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setSkinForState()</code> with
	 * <code>ButtonState.UP</code> to set the same skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * button.setSkinForState( ButtonState.UP, skin );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultSkin
	 * @see #setSkinForState()
	 * @see feathers.controls.ButtonState#UP
	 */
	[Style(name="upSkin",type="starling.display.DisplayObject")]

	/**
	 * Dispatched when the the user taps or clicks the button. The touch must
	 * remain within the bounds of the button on release to register as a tap
	 * or a click. If focus management is enabled, the button may also be
	 * triggered by pressing the spacebar while the button has focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.TRIGGERED
	 */
	[Event(name="triggered",type="starling.events.Event")]

	/**
	 * Dispatched when the display object's state changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.STATE_CHANGE
	 *
	 * @see #currentState
	 */
	[Event(name="stateChange",type="starling.events.Event")]

	/**
	 * A simple button control with states, but no content, that is useful for
	 * purposes like skinning. For a more full-featured button, with a label and
	 * icon, see <code>feathers.controls.Button</code> instead.
	 *
	 * @see feathers.controls.Button
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class BasicButton extends FeathersControl implements IStateContext
	{
		/**
		 * @private
		 */
		private static const HELPER_POINT:Point = new Point();

		/**
		 * The default <code>IStyleProvider</code> for all <code>BasicButton</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function BasicButton()
		{
			super();
			this.isQuickHitAreaEnabled = true;
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return BasicButton.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var touchToState:TouchToState;

		/**
		 * @private
		 */
		protected var tapToTrigger:TapToTrigger;

		/**
		 * @private
		 */
		protected var _currentState:String = ButtonState.UP;

		/**
		 * The current state of the button.
		 *
		 * @see feathers.controls.ButtonState
		 * @see #event:stateChange feathers.events.FeathersEventType.STATE_CHANGE
		 */
		public function get currentState():String
		{
			return this._currentState;
		}

		/**
		 * The currently visible skin. The value will be <code>null</code> if
		 * there is no currently visible skin.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected var currentSkin:DisplayObject;

		/**
		 * @private
		 */
		override public function set isEnabled(value:Boolean):void
		{
			if(this._isEnabled === value)
			{
				return;
			}
			super.isEnabled = value;
			if(this._isEnabled)
			{
				//might be in another state for some reason
				//let's only change to up if needed
				if(this._currentState === ButtonState.DISABLED)
				{
					this.changeState(ButtonState.UP);
				}
			}
			else
			{
				this.changeState(ButtonState.DISABLED);
			}
		}

		/**
		 * @private
		 */
		protected var _keepDownStateOnRollOut:Boolean = false;

		/**
		 * @private
		 */
		public function get keepDownStateOnRollOut():Boolean
		{
			return this._keepDownStateOnRollOut;
		}

		/**
		 * @private
		 */
		public function set keepDownStateOnRollOut(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._keepDownStateOnRollOut = value;
			if(this.touchToState !== null)
			{
				this.touchToState.keepDownStateOnRollOut = value;
			}
		}

		/**
		 * @private
		 */
		protected var _defaultSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get defaultSkin():DisplayObject
		{
			return this._defaultSkin;
		}

		/**
		 * @private
		 */
		public function set defaultSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._defaultSkin === value)
			{
				return;
			}
			if(this._defaultSkin !== null &&
				this.currentSkin === this._defaultSkin)
			{
				//if this skin needs to be reused somewhere else, we need to
				//properly clean it up
				this.removeCurrentSkin(this._defaultSkin);
				this.currentSkin = null;
			}
			this._defaultSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		public function get upSkin():DisplayObject
		{
			return this.getSkinForState(ButtonState.UP);
		}

		/**
		 * @private
		 */
		public function set upSkin(value:DisplayObject):void
		{
			this.setSkinForState(ButtonState.UP, value);
		}

		/**
		 * @private
		 */
		public function get downSkin():DisplayObject
		{
			return this.getSkinForState(ButtonState.DOWN);
		}

		/**
		 * @private
		 */
		public function set downSkin(value:DisplayObject):void
		{
			this.setSkinForState(ButtonState.DOWN, value);
		}

		/**
		 * @private
		 */
		public function get hoverSkin():DisplayObject
		{
			return this.getSkinForState(ButtonState.HOVER);
		}

		/**
		 * @private
		 */
		public function set hoverSkin(value:DisplayObject):void
		{
			this.setSkinForState(ButtonState.HOVER, value);
		}

		/**
		 * @private
		 */
		public function get disabledSkin():DisplayObject
		{
			return this.getSkinForState(ButtonState.DISABLED);
		}

		/**
		 * @private
		 */
		public function set disabledSkin(value:DisplayObject):void
		{
			this.setSkinForState(ButtonState.DISABLED, value);
		}

		/**
		 * @private
		 * Chooses an appropriate skin based on the state and the selection.
		 */
		protected var _stateToSkin:Object = {};

		/**
		 * @private
		 */
		protected var _explicitSkinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitSkinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitSkinMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitSkinMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitSkinMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitSkinMaxHeight:Number;

		/**
		 * Gets the skin to be used by the button when its
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If a skin is not defined for a specific state, returns
		 * <code>null</code>.</p>
		 *
		 * @see #setSkinForState()
		 */
		public function getSkinForState(state:String):DisplayObject
		{
			return this._stateToSkin[state] as DisplayObject;
		}

		/**
		 * Sets the skin to be used by the button when its
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If a skin is not defined for a specific state, the value of the
		 * <code>defaultSkin</code> property will be used instead.</p>
		 *
		 * @see #style:defaultSkin
		 * @see #getSkinForState()
		 * @see feathers.controls.ButtonState
		 */
		public function setSkinForState(state:String, skin:DisplayObject):void
		{
			var key:String = "setSkinForState--" + state;
			if(this.processStyleRestriction(key))
			{
				if(skin !== null)
				{
					skin.dispose();
				}
				return;
			}
			var oldSkin:DisplayObject = this._stateToSkin[state] as DisplayObject;
			if(oldSkin !== null &&
				this.currentSkin === oldSkin)
			{
				//if this skin needs to be reused somewhere else, we need to
				//properly clean it up
				this.removeCurrentSkin(oldSkin);
				this.currentSkin = null;
			}
			if(skin !== null)
			{
				this._stateToSkin[state] = skin;
			}
			else
			{
				delete this._stateToSkin[state];
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			//we don't dispose it if the button is the parent because it'll
			//already get disposed in super.dispose()
			if(this._defaultSkin !== null && this._defaultSkin.parent !== this)
			{
				this._defaultSkin.dispose();
			}
			for(var state:String in this._stateToSkin)
			{
				var skin:DisplayObject = this._stateToSkin[state] as DisplayObject;
				if(skin !== null && skin.parent !== this)
				{
					skin.dispose();
				}
			}
			if(this.touchToState !== null)
			{
				//setting the target to null will remove listeners and do any
				//other clean up that is needed
				this.touchToState.target = null;
			}
			if(this.tapToTrigger !== null)
			{
				this.tapToTrigger.target = null;
			}
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			super.initialize();
			if(!this.touchToState)
			{
				this.touchToState = new TouchToState(this, this.changeState);
			}
			this.touchToState.keepDownStateOnRollOut = this._keepDownStateOnRollOut;
			if(!this.tapToTrigger)
			{
				this.tapToTrigger = new TapToTrigger(this);
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);

			if(stylesInvalid || stateInvalid)
			{
				this.refreshTriggeredEvents();
				this.refreshSkin();
			}

			this.autoSizeIfNeeded();
			this.scaleSkin();
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			resetFluidChildDimensionsForMeasurement(this.currentSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitSkinWidth, this._explicitSkinHeight,
				this._explicitSkinMinWidth, this._explicitSkinMinHeight,
				this._explicitSkinMaxWidth, this._explicitSkinMaxHeight);
			var measureSkin:IMeasureDisplayObject = this.currentSkin as IMeasureDisplayObject;

			if(this.currentSkin is IValidating)
			{
				IValidating(this.currentSkin).validate();
			}

			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				if(measureSkin !== null)
				{
					newMinWidth = measureSkin.minWidth;
				}
				else if(this.currentSkin !== null)
				{
					newMinWidth = this._explicitSkinMinWidth;
				}
				else
				{
					newMinWidth = 0;
				}
			}

			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				if(measureSkin !== null)
				{
					newMinHeight = measureSkin.minHeight;
				}
				else if(this.currentSkin !== null)
				{
					newMinHeight = this._explicitSkinMinHeight;
				}
				else
				{
					newMinHeight = 0;
				}
			}

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				if(this.currentSkin !== null)
				{
					newWidth = this.currentSkin.width;
				}
				else
				{
					newWidth = 0;
				}
			}

			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				if(this.currentSkin !== null)
				{
					newHeight = this.currentSkin.height;
				}
				else
				{
					newHeight = 0;
				}
			}

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * Sets the <code>currentSkin</code> property.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected function refreshSkin():void
		{
			var oldSkin:DisplayObject = this.currentSkin;
			this.currentSkin = this.getCurrentSkin();
			if(this.currentSkin !== oldSkin)
			{
				this.removeCurrentSkin(oldSkin);
				if(this.currentSkin !== null)
				{
					if(this.currentSkin is IFeathersControl)
					{
						IFeathersControl(this.currentSkin).initializeNow();
					}
					if(this.currentSkin is IMeasureDisplayObject)
					{
						var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this.currentSkin);
						this._explicitSkinWidth = measureSkin.explicitWidth;
						this._explicitSkinHeight = measureSkin.explicitHeight;
						this._explicitSkinMinWidth = measureSkin.explicitMinWidth;
						this._explicitSkinMinHeight = measureSkin.explicitMinHeight;
						this._explicitSkinMaxWidth = measureSkin.explicitMaxWidth;
						this._explicitSkinMaxHeight = measureSkin.explicitMaxHeight;
					}
					else
					{
						this._explicitSkinWidth = this.currentSkin.width;
						this._explicitSkinHeight = this.currentSkin.height;
						this._explicitSkinMinWidth = this._explicitSkinWidth;
						this._explicitSkinMinHeight = this._explicitSkinHeight;
						this._explicitSkinMaxWidth = this._explicitSkinWidth;
						this._explicitSkinMaxHeight = this._explicitSkinHeight;
					}
					if(this.currentSkin is IStateObserver)
					{
						IStateObserver(this.currentSkin).stateContext = this;
					}
					this.addChildAt(this.currentSkin, 0);
				}
			}
		}

		/**
		 * @private
		 */
		protected function getCurrentSkin():DisplayObject
		{
			var result:DisplayObject = this._stateToSkin[this._currentState] as DisplayObject;
			if(result !== null)
			{
				return result;
			}
			return this._defaultSkin;
		}

		/**
		 * @private
		 */
		protected function scaleSkin():void
		{
			if(!this.currentSkin)
			{
				return;
			}
			this.currentSkin.x = 0;
			this.currentSkin.y = 0;
			if(this.currentSkin.width != this.actualWidth)
			{
				this.currentSkin.width = this.actualWidth;
			}
			if(this.currentSkin.height != this.actualHeight)
			{
				this.currentSkin.height = this.actualHeight;
			}
			if(this.currentSkin is IValidating)
			{
				IValidating(this.currentSkin).validate();
			}
		}

		/**
		 * @private
		 */
		protected function removeCurrentSkin(skin:DisplayObject):void
		{
			if(skin === null)
			{
				return;
			}
			if(skin is IStateObserver)
			{
				IStateObserver(skin).stateContext = null;
			}
			if(skin.parent === this)
			{
				//we need to restore these values so that they won't be lost the
				//next time that this skin is used for measurement
				skin.width = this._explicitSkinWidth;
				skin.height = this._explicitSkinHeight;
				if(skin is IMeasureDisplayObject)
				{
					var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(skin);
					measureSkin.minWidth = this._explicitSkinMinWidth;
					measureSkin.minHeight = this._explicitSkinMinHeight;
					measureSkin.maxWidth = this._explicitSkinMaxWidth;
					measureSkin.maxHeight = this._explicitSkinMaxHeight;
				}
				this.removeChild(skin, false);
			}
		}

		/**
		 * @private
		 */
		protected function refreshTriggeredEvents():void
		{
			this.tapToTrigger.isEnabled = this._isEnabled;
		}

		/**
		 * @private
		 */
		protected function changeState(state:String):void
		{
			if(!this._isEnabled)
			{
				state = ButtonState.DISABLED;
			}
			if(this._currentState === state)
			{
				return;
			}
			this._currentState = state;
			this.invalidate(INVALIDATION_FLAG_STATE);
			this.dispatchEventWith(FeathersEventType.STATE_CHANGE);
		}
	}
}


================================================
FILE: source/feathers/controls/Button.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IFocusDisplayObject;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IStateObserver;
	import feathers.core.ITextBaselineControl;
	import feathers.core.ITextRenderer;
	import feathers.core.IValidating;
	import feathers.core.PropertyProxy;
	import feathers.events.FeathersEventType;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.RelativePosition;
	import feathers.layout.VerticalAlign;
	import feathers.skins.IStyleProvider;
	import feathers.text.FontStylesSet;
	import feathers.utils.keyboard.KeyToState;
	import feathers.utils.keyboard.KeyToTrigger;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;
	import feathers.utils.touch.LongPress;

	import flash.geom.Matrix;
	import flash.geom.Point;
	import flash.ui.Keyboard;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.rendering.Painter;
	import starling.text.TextFormat;
	import starling.utils.Pool;

	[Exclude(name="stateToIconFunction",kind="property")]
	[Exclude(name="stateToLabelPropertiesFunction",kind="property")]
	[Exclude(name="stateToSkinFunction",kind="property")]
	[Exclude(name="upLabelProperties",kind="property")]
	[Exclude(name="downLabelProperties",kind="property")]
	[Exclude(name="hoverLabelProperties",kind="property")]
	[Exclude(name="disabledLabelProperties",kind="property")]

	/**
	 * A style name to add to the button's label text renderer
	 * sub-component. Typically used by a theme to provide different styles
	 * to different buttons.
	 *
	 * <p>In the following example, a custom label style name is passed to
	 * the button:</p>
	 *
	 * <listing version="3.0">
	 * button.customLabelStyleName = "my-custom-button-label";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( BitmapFontTextRenderer ).setFunctionForStyleName( "my-custom-button-label", setCustomButtonLabelStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_LABEL
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #labelFactory
	 */
	[Style(name="customLabelStyleName",type="String")]

	/**
	 * The icon used when no other icon is defined for the current state.
	 * Intended to be used when multiple states should share the same icon.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToIconFunction</code> property.</p>
	 *
	 * <p>The following example gives the button a default icon to use for
	 * all states when no specific icon is available:</p>
	 *
	 * <listing version="3.0">
	 * button.defaultIcon = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #setIconForState()
	 */
	[Style(name="defaultIcon",type="starling.display.DisplayObject")]

	/**
	 * The font styles used to display the button's text when the button is
	 * disabled.
	 *
	 * <p>In the following example, the disabled font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * button.disabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Alternatively, you may use <code>setFontStylesForState()</code> with
	 * <code>ButtonState.DISABLED</code> to set the same font styles:</p>
	 *
	 * <listing version="3.0">
	 * var fontStyles:TextFormat = new TextFormat( "Helvetica", 20, 0x999999 );
	 * button.setFontStylesForState( ButtonState.DISABLED, fontStyles );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>labelFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:fontStyles
	 * @see #setFontStylesForState()
	 */
	[Style(name="disabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The icon used for the button's disabled state. If <code>null</code>, then
	 * <code>defaultIcon</code> is used instead.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToIconFunction</code> property.</p>
	 *
	 * <p>The following example gives the button an icon for the disabled state:</p>
	 *
	 * <listing version="3.0">
	 * button.disabledIcon = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setIconForState()</code> with
	 * <code>ButtonState.DISABLED</code> to set the same icon:</p>
	 *
	 * <listing version="3.0">
	 * var icon:Image = new Image( texture );
	 * button.setIconForState( ButtonState.DISABLED, icon );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultIcon
	 * @see #setIconForState()
	 * @see feathers.controls.ButtonState#DISABLED
	 */
	[Style(name="disabledIcon",type="starling.display.DisplayObject")]

	/**
	 * The icon used for the button's down state. If <code>null</code>, then
	 * <code>defaultIcon</code> is used instead.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToIconFunction</code> property.</p>
	 *
	 * <p>The following example gives the button an icon for the down state:</p>
	 *
	 * <listing version="3.0">
	 * button.downIcon = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setIconForState()</code> with
	 * <code>ButtonState.DOWN</code> to set the same icon:</p>
	 *
	 * <listing version="3.0">
	 * var icon:Image = new Image( texture );
	 * button.setIconForState( ButtonState.DOWN, icon );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultIcon
	 * @see #setIconForState()
	 * @see feathers.controls.ButtonState#DOWN
	 */
	[Style(name="downIcon",type="starling.display.DisplayObject")]

	/**
	 * The font styles used to display the button's text.
	 *
	 * <p>In the following example, the font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * button.fontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>labelFactory</code> to set more advanced styles.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:disabledFontStyles
	 * @see #setFontStylesForState()
	 */
	[Style(name="fontStyles",type="starling.text.TextFormat")]

	/**
	 * The space, in pixels, between the icon and the label. Applies to
	 * either horizontal or vertical spacing, depending on the value of
	 * <code>iconPosition</code>.
	 *
	 * <p>If <code>gap</code> is set to <code>Number.POSITIVE_INFINITY</code>,
	 * the label and icon will be positioned as far apart as possible. In
	 * other words, they will be positioned at the edges of the button,
	 * adjusted for padding.</p>
	 *
	 * <p>The following example creates a gap of 50 pixels between the label
	 * and the icon:</p>
	 *
	 * <listing version="3.0">
	 * button.label = "Click Me";
	 * button.defaultIcon = new Image( texture );
	 * button.gap = 50;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:iconPosition
	 * @see #style:minGap
	 */
	[Style(name="gap",type="Number")]

	/**
	 * Determines if the button's label text renderer is created or not.
	 * Useful for button sub-components that may not display text, like
	 * slider thumbs and tracks, or similar sub-components on scroll bars.
	 *
	 * <p>The following example removed the label text renderer:</p>
	 *
	 * <listing version="3.0">
	 * button.hasLabelTextRenderer = false;</listing>
	 *
	 * @default true
	 */
	[Style(name="hasLabelTextRenderer",type="Boolean")]

	/**
	 * The location where the button's content is aligned horizontally (on
	 * the x-axis).
	 *
	 * <p>The following example aligns the button's content to the left:</p>
	 *
	 * <listing version="3.0">
	 * button.horizontalAlign = HorizontalAlign.LEFT;</listing>
	 *
	 * <p><strong>Note:</strong> The <code>HorizontalAlign.JUSTIFY</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.HorizontalAlign.CENTER
	 *
	 * @see feathers.layout.HorizontalAlign#LEFT
	 * @see feathers.layout.HorizontalAlign#CENTER
	 * @see feathers.layout.HorizontalAlign#RIGHT
	 */
	[Style(name="horizontalAlign",type="String")]

	/**
	 * The icon used for the button's hover state. If <code>null</code>, then
	 * <code>defaultIcon</code> is used instead.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToIconFunction</code> property.</p>
	 *
	 * <p>The following example gives the button an icon for the hover state:</p>
	 *
	 * <listing version="3.0">
	 * button.hoverIcon = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setIconForState()</code> with
	 * <code>ButtonState.HOVER</code> to set the same icon:</p>
	 *
	 * <listing version="3.0">
	 * var icon:Image = new Image( texture );
	 * button.setIconForState( ButtonState.HOVER, icon );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultIcon
	 * @see #setIconForState()
	 * @see feathers.controls.ButtonState#HOVER
	 */
	[Style(name="hoverIcon",type="starling.display.DisplayObject")]

	/**
	 * Offsets the x position of the icon by a certain number of pixels.
	 * This does not affect the measurement of the button. The button will
	 * measure itself as if the icon were not offset from its original
	 * position.
	 *
	 * <p>The following example offsets the x position of the button's icon
	 * by 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * button.iconOffsetX = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:iconOffsetY
	 */
	[Style(name="iconOffsetX",type="Number")]

	/**
	 * Offsets the y position of the icon by a certain number of pixels.
	 * This does not affect the measurement of the button. The button will
	 * measure itself as if the icon were not offset from its original
	 * position.
	 *
	 * <p>The following example offsets the y position of the button's icon
	 * by 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * button.iconOffsetY = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:iconOffsetX
	 */
	[Style(name="iconOffsetY",type="Number")]

	/**
	 * The location of the icon, relative to the label.
	 *
	 * <p>The following example positions the icon to the right of the
	 * label:</p>
	 *
	 * <listing version="3.0">
	 * button.label = "Click Me";
	 * button.defaultIcon = new Image( texture );
	 * button.iconPosition = RelativePosition.RIGHT;</listing>
	 *
	 * @default feathers.layout.RelativePosition.LEFT
	 *
	 * @see feathers.layout.RelativePosition#TOP
	 * @see feathers.layout.RelativePosition#RIGHT
	 * @see feathers.layout.RelativePosition#BOTTOM
	 * @see feathers.layout.RelativePosition#LEFT
	 * @see feathers.layout.RelativePosition#RIGHT_BASELINE
	 * @see feathers.layout.RelativePosition#LEFT_BASELINE
	 * @see feathers.layout.RelativePosition#MANUAL
	 */
	[Style(name="iconPosition",type="String")]

	/**
	 * Offsets the x position of the label by a certain number of pixels.
	 * This does not affect the measurement of the button. The button will
	 * measure itself as if the label were not offset from its original
	 * position.
	 *
	 * <p>The following example offsets the x position of the button's label
	 * by 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * button.labelOffsetX = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:labelOffsetY
	 */
	[Style(name="labelOffsetX",type="Number")]

	/**
	 * Offsets the y position of the label by a certain number of pixels.
	 * This does not affect the measurement of the button. The button will
	 * measure itself as if the label were not offset from its original
	 * position.
	 *
	 * <p>The following example offsets the y position of the button's label
	 * by 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * button.labelOffsetY = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:labelOffsetX
	 */
	[Style(name="labelOffsetY",type="Number")]

	/**
	 * If the value of the <code>gap</code> property is
	 * <code>Number.POSITIVE_INFINITY</code>, meaning that the gap will
	 * fill as much space as possible, the final calculated value will not be
	 * smaller than the value of the <code>minGap</code> property.
	 *
	 * <p>The following example ensures that the gap is never smaller than
	 * 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * button.gap = Number.POSITIVE_INFINITY;
	 * button.minGap = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:gap
	 */
	[Style(name="minGap",type="Number")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>The following example gives the button 20 pixels of padding on all
	 * sides:</p>
	 *
	 * <listing version="3.0">
	 * button.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, between the button's top edge and the
	 * button's content.
	 *
	 * <p>The following example gives the button 20 pixels of padding on the
	 * top edge only:</p>
	 *
	 * <listing version="3.0">
	 * button.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the button's right edge and the
	 * button's content.
	 *
	 * <p>The following example gives the button 20 pixels of padding on the
	 * right edge only:</p>
	 *
	 * <listing version="3.0">
	 * button.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the button's bottom edge and
	 * the button's content.
	 *
	 * <p>The following example gives the button 20 pixels of padding on the
	 * bottom edge only:</p>
	 *
	 * <listing version="3.0">
	 * button.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the button's left edge and the
	 * button's content.
	 *
	 * <p>The following example gives the button 20 pixels of padding on the
	 * left edge only:</p>
	 *
	 * <listing version="3.0">
	 * button.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * The button renders at this scale in the down state.
	 *
	 * <p>The following example scales the button in the down state:</p>
	 *
	 * <listing version="3.0">
	 * button.scaleWhenDown = 0.9;</listing>
	 *
	 * @default 1
	 *
	 * @see #getScaleForState()
	 * @see #setScaleForState()
	 */
	[Style(name="scaleWhenDown",type="Number")]

	/**
	 * The button renders at this scale in the hover state.
	 *
	 * <p>The following example scales the button in the hover state:</p>
	 *
	 * <listing version="3.0">
	 * button.scaleWhenHovering = 0.9;</listing>
	 *
	 * @default 1
	 *
	 * @see #getScaleForState()
	 * @see #setScaleForState()
	 */
	[Style(name="scaleWhenHovering",type="Number")]

	/**
	 * The icon used for the button's up state. If <code>null</code>, then
	 * <code>defaultIcon</code> is used instead.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToIconFunction</code> property.</p>
	 *
	 * <p>The following example gives the button an icon for the up state:</p>
	 *
	 * <listing version="3.0">
	 * button.upIcon = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setIconForState()</code> with
	 * <code>ButtonState.UP</code> to set the same icon:</p>
	 *
	 * <listing version="3.0">
	 * var icon:Image = new Image( texture );
	 * button.setIconForState( ButtonState.UP, icon );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultIcon
	 * @see #setIconForState()
	 * @see feathers.controls.ButtonState#UP
	 */
	[Style(name="upIcon",type="starling.display.DisplayObject")]

	/**
	 * The location where the button's content is aligned vertically (on
	 * the y-axis).
	 *
	 * <p>The following example aligns the button's content to the top:</p>
	 *
	 * <listing version="3.0">
	 * button.verticalAlign = VerticalAlign.TOP;</listing>
	 *
	 * <p><strong>Note:</strong> The <code>VerticalAlign.JUSTIFY</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.VerticalAlign.MIDDLE
	 *
	 * @see feathers.layout.VerticalAlign#TOP
	 * @see feathers.layout.VerticalAlign#MIDDLE
	 * @see feathers.layout.VerticalAlign#BOTTOM
	 */
	[Style(name="verticalAlign",type="String")]

	/**
	 * Determines if the text wraps to the next line when it reaches the
	 * width (or max width) of the component.
	 *
	 * <p>In the following example, the button's text is wrapped:</p>
	 *
	 * <listing version="3.0">
	 * button.wordWrap = true;</listing>
	 *
	 * @default false
	 */
	[Style(name="wordWrap",type="Boolean")]

	/**
	 * Dispatched when the button is pressed for a long time. The property
	 * <code>isLongPressEnabled</code> must be set to <code>true</code> before
	 * this event will be dispatched.
	 *
	 * <p>The following example enables long presses:</p>
	 *
	 * <listing version="3.0">
	 * button.isLongPressEnabled = true;
	 * button.addEventListener( FeathersEventType.LONG_PRESS, function( event:Event ):void
	 * {
	 *     // long press
	 * });</listing>
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.LONG_PRESS
	 * @see #isLongPressEnabled
	 * @see #longPressDuration
	 */
	[Event(name="longPress",type="starling.events.Event")]

	/**
	 * A push button control that may be triggered when pressed and released.
	 *
	 * <p>The following example creates a button, gives it a label and listens
	 * for when the button is triggered:</p>
	 *
	 * <listing version="3.0">
	 * var button:Button = new Button();
	 * button.label = "Click Me";
	 * button.addEventListener( Event.TRIGGERED, button_triggeredHandler );
	 * this.addChild( button );</listing>
	 *
	 * @see ../../../help/button.html How to use the Feathers Button component
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class Button extends BasicButton implements IFocusDisplayObject, ITextBaselineControl
	{
		/**
		 * @private
		 */
		private static const HELPER_POINT:Point = new Point();

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * label text renderer.
		 *
		 * <p>Note: the label text renderer is not a
		 * <code>feathers.controls.Label</code>. It is an instance of one of the
		 * <code>ITextRenderer</code> implementations.</p>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 * @see ../../../help/text-renderers.html Introduction to Feathers text renderers
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_LABEL:String = "feathers-button-label";

		/**
		 * An alternate style name to use with <code>Button</code> to allow a
		 * theme to give it a more prominent, "call-to-action" style. If a theme
		 * does not provide a style for a call-to-action button, the theme will
		 * automatically fall back to using the default button style.
		 *
		 * <p>An alternate style name should always be added to a component's
		 * <code>styleNameList</code> before the component is initialized. If
		 * the style name is added later, it will be ignored.</p>
		 *
		 * <p>In the following example, the call-to-action style is applied to
		 * a button:</p>
		 *
		 * <listing version="3.0">
		 * var button:Button = new Button();
		 * button.styleNameList.add( Button.ALTERNATE_STYLE_NAME_CALL_TO_ACTION_BUTTON );
		 * this.addChild( button );</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_CALL_TO_ACTION_BUTTON:String = "feathers-call-to-action-button";

		/**
		 * An alternate style name to use with <code>Button</code> to allow a
		 * theme to give it a less prominent, "quiet" style. If a theme does not
		 * provide a style for a quiet button, the theme will automatically fall
		 * back to using the default button style.
		 *
		 * <p>An alternate style name should always be added to a component's
		 * <code>styleNameList</code> before the component is initialized. If
		 * the style name is added later, it will be ignored.</p>
		 *
		 * <p>In the following example, the quiet button style is applied to
		 * a button:</p>
		 *
		 * <listing version="3.0">
		 * var button:Button = new Button();
		 * button.styleNameList.add( Button.ALTERNATE_STYLE_NAME_QUIET_BUTTON );
		 * this.addChild( button );</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_QUIET_BUTTON:String = "feathers-quiet-button";

		/**
		 * An alternate style name to use with <code>Button</code> to allow a
		 * theme to give it a highly prominent, "danger" style. An example would
		 * be a delete button or some other button that has a destructive action
		 * that cannot be undone if the button is triggered. If a theme does not
		 * provide a style for the danger button, the theme will automatically
		 * fall back to using the default button style.
		 *
		 * <p>An alternate style name should always be added to a component's
		 * <code>styleNameList</code> before the component is initialized. If
		 * the style name is added later, it will be ignored.</p>
		 *
		 * <p>In the following example, the danger button style is applied to
		 * a button:</p>
		 *
		 * <listing version="3.0">
		 * var button:Button = new Button();
		 * button.styleNameList.add( Button.ALTERNATE_STYLE_NAME_DANGER_BUTTON );
		 * this.addChild( button );</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_DANGER_BUTTON:String = "feathers-danger-button";

		/**
		 * An alternate style name to use with <code>Button</code> to allow a
		 * theme to give it a "back button" style, perhaps with an arrow
		 * pointing backward. If a theme does not provide a style for a back
		 * button, the theme will automatically fall back to using the default
		 * button skin.
		 *
		 * <p>An alternate style name should always be added to a component's
		 * <code>styleNameList</code> before the component is initialized. If
		 * the style name is added later, it will be ignored.</p>
		 *
		 * <p>In the following example, the back button style is applied to
		 * a button:</p>
		 *
		 * <listing version="3.0">
		 * var button:Button = new Button();
		 * button.styleNameList.add( Button.ALTERNATE_STYLE_NAME_BACK_BUTTON );
		 * this.addChild( button );</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_BACK_BUTTON:String = "feathers-back-button";

		/**
		 * An alternate style name to use with <code>Button</code> to allow a
		 * theme to give it a "forward" button style, perhaps with an arrow
		 * pointing forward. If a theme does not provide a style for a forward
		 * button, the theme will automatically fall back to using the default
		 * button style.
		 *
		 * <p>An alternate style name should always be added to a component's
		 * <code>styleNameList</code> before the component is initialized. If
		 * the style name is added later, it will be ignored.</p>
		 *
		 * <p>In the following example, the forward button style is applied to
		 * a button:</p>
		 *
		 * <listing version="3.0">
		 * var button:Button = new Button();
		 * button.styleNameList.add( Button.ALTERNATE_STYLE_NAME_FORWARD_BUTTON );
		 * this.addChild( button );</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_FORWARD_BUTTON:String = "feathers-forward-button";

		/**
		 * The default <code>IStyleProvider</code> for all <code>Button</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function Button()
		{
			super();
			if(this._fontStylesSet === null)
			{
				this._fontStylesSet = new FontStylesSet();
				this._fontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
		}

		/**
		 * The value added to the <code>styleNameList</code> of the label text
		 * renderer. This variable is <code>protected</code> so that sub-classes
		 * can customize the label text renderer style name in their
		 * constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_LABEL</code>.
		 *
		 * <p>To customize the label text renderer style name without
		 * subclassing, see <code>customLabelStyleName</code>.</p>
		 *
		 * @see #style:customLabelStyleName
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var labelStyleName:String = DEFAULT_CHILD_STYLE_NAME_LABEL;

		/**
		 * The text renderer for the button's label.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #label
		 * @see #labelFactory
		 * @see #createLabel()
		 */
		protected var labelTextRenderer:ITextRenderer;

		/**
		 * @private
		 */
		protected var _explicitLabelWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitLabelHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitLabelMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitLabelMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitLabelMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitLabelMaxHeight:Number;

		/**
		 * The currently visible icon. The value will be <code>null</code> if
		 * there is no currently visible icon.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected var currentIcon:DisplayObject;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return Button.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var keyToTrigger:KeyToTrigger;

		/**
		 * @private
		 */
		protected var keyToState:KeyToState;

		/**
		 * @private
		 */
		protected var longPress:LongPress;

		/**
		 * @private
		 */
		protected var dpadEnterKeyToTrigger:KeyToTrigger;

		/**
		 * @private
		 */
		protected var dpadEnterKeyToState:KeyToState;

		/**
		 * @private
		 */
		protected var _label:String = null;

		/**
		 * The text displayed on the button.
		 *
		 * <p>The following example gives the button some label text:</p>
		 *
		 * <listing version="3.0">
		 * button.label = "Click Me";</listing>
		 *
		 * @default null
		 */
		public function get label():String
		{
			return this._label;
		}

		/**
		 * @private
		 */
		public function set label(value:String):void
		{
			if(this._label == value)
			{
				return;
			}
			this._label = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _hasLabelTextRenderer:Boolean = true;

		/**
		 * @private
		 */
		public function get hasLabelTextRenderer():Boolean
		{
			return this._hasLabelTextRenderer;
		}

		/**
		 * @private
		 */
		public function set hasLabelTextRenderer(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._hasLabelTextRenderer === value)
			{
				return;
			}
			this._hasLabelTextRenderer = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _iconPosition:String = RelativePosition.LEFT;

		[Inspectable(type="String",enumeration="top,right,bottom,left,rightBaseline,leftBaseline,manual")]
		/**
		 * @private
		 */
		public function get iconPosition():String
		{
			return this._iconPosition;
		}

		/**
		 * @private
		 */
		public function set iconPosition(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._iconPosition === value)
			{
				return;
			}
			this._iconPosition = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _gap:Number = 0;

		/**
		 * @private
		 */
		public function get gap():Number
		{
			return this._gap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._gap == value)
			{
				return;
			}
			this._gap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _minGap:Number = 0;

		/**
		 * @private
		 */
		public function get minGap():Number
		{
			return this._minGap;
		}

		/**
		 * @private
		 */
		public function set minGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._minGap == value)
			{
				return;
			}
			this._minGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.CENTER;

		[Inspectable(type="String",enumeration="left,center,right")]
		/**
		 * @private
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._horizontalAlign === value)
			{
				return;
			}
			this._horizontalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.MIDDLE;

		[Inspectable(type="String",enumeration="top,middle,bottom")]
		/**
		 * @private
		 */
		public function get verticalAlign():String
		{
			return _verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._verticalAlign === value)
			{
				return;
			}
			this._verticalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _labelOffsetX:Number = 0;

		/**
		 * @private
		 */
		public function get labelOffsetX():Number
		{
			return this._labelOffsetX;
		}

		/**
		 * @private
		 */
		public function set labelOffsetX(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._labelOffsetX == value)
			{
				return;
			}
			this._labelOffsetX = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _labelOffsetY:Number = 0;

		/**
		 * @private
		 */
		public function get labelOffsetY():Number
		{
			return this._labelOffsetY;
		}

		/**
		 * @private
		 */
		public function set labelOffsetY(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._labelOffsetY == value)
			{
				return;
			}
			this._labelOffsetY = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _iconOffsetX:Number = 0;

		/**
		 * @private
		 */
		public function get iconOffsetX():Number
		{
			return this._iconOffsetX;
		}

		/**
		 * @private
		 */
		public function set iconOffsetX(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._iconOffsetX == value)
			{
				return;
			}
			this._iconOffsetX = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _iconOffsetY:Number = 0;

		/**
		 * @private
		 */
		public function get iconOffsetY():Number
		{
			return this._iconOffsetY;
		}

		/**
		 * @private
		 */
		public function set iconOffsetY(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._iconOffsetY == value)
			{
				return;
			}
			this._iconOffsetY = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _fontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get fontStyles():TextFormat
		{
			return this._fontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set fontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get disabledFontStyles():TextFormat
		{
			return this._fontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set disabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		private var _wordWrap:Boolean = false;

		/**
		 * @private
		 */
		public function get wordWrap():Boolean
		{
			return this._wordWrap;
		}

		/**
		 * @private
		 */
		public function set wordWrap(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._wordWrap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _labelFactory:Function;

		/**
		 * A function used to instantiate the button's label text renderer
		 * sub-component. By default, the button will use the global text
		 * renderer factory, <code>FeathersControl.defaultTextRendererFactory()</code>,
		 * to create the label text renderer. The label text renderer must be an
		 * instance of <code>ITextRenderer</code>. To change properties on the
		 * label text renderer, see <code>defaultLabelProperties</code> and the
		 * other "<code>LabelProperties</code>" properties for each button
		 * state.
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():ITextRenderer</pre>
		 *
		 * <p>The following example gives the button a custom factory for the
		 * label text renderer:</p>
		 *
		 * <listing version="3.0">
		 * button.labelFactory = function():ITextRenderer
		 * {
		 *     return new TextFieldTextRenderer();
		 * }</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.ITextRenderer
		 * @see feathers.core.FeathersControl#defaultTextRendererFactory
		 */
		public function get labelFactory():Function
		{
			return this._labelFactory;
		}

		/**
		 * @private
		 */
		public function set labelFactory(value:Function):void
		{
			if(this._labelFactory == value)
			{
				return;
			}
			this._labelFactory = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _customLabelStyleName:String;

		/**
		 * @private
		 */
		public function get customLabelStyleName():String
		{
			return this._customLabelStyleName;
		}

		/**
		 * @private
		 */
		public function set customLabelStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customLabelStyleName === value)
			{
				return;
			}
			this._customLabelStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _defaultLabelProperties:PropertyProxy;

		/**
		 * An object that stores properties for the button's label text renderer
		 * when no specific properties are defined for the button's current
		 * state, and the properties will be passed down to the label text
		 * renderer when the button validates. The available properties depend
		 * on which <code>ITextRenderer</code> implementation is returned by
		 * <code>labelFactory</code>. Refer to
		 * <a href="../core/ITextRenderer.html"><code>feathers.core.ITextRenderer</code></a>
		 * for a list of available text renderer implementations.
		 *
		 * <p>The following example gives the button default label properties to
		 * use for all states when no specific label properties are available
		 * (this example assumes that the label text renderer is a
		 * <code>BitmapFontTextRenderer</code>):</p>
		 *
		 * <listing version="3.0">
		 * button.defaultLabelProperties.textFormat = new BitmapFontTextFormat( bitmapFont );
		 * button.defaultLabelProperties.wordWrap = true;</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.ITextRenderer
		 * @see #fontStyles
		 */
		public function get defaultLabelProperties():Object
		{
			if(this._defaultLabelProperties === null)
			{
				this._defaultLabelProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._defaultLabelProperties;
		}

		/**
		 * @private
		 */
		public function set defaultLabelProperties(value:Object):void
		{
			if(!(value is PropertyProxy))
			{
				value = PropertyProxy.fromObject(value);
			}
			if(this._defaultLabelProperties !== null)
			{
				this._defaultLabelProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._defaultLabelProperties = PropertyProxy(value);
			if(this._defaultLabelProperties !== null)
			{
				this._defaultLabelProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _defaultIcon:DisplayObject;

		/**
		 * @private
		 */
		public function get defaultIcon():DisplayObject
		{
			return this._defaultIcon;
		}

		/**
		 * @private
		 */
		public function set defaultIcon(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._defaultIcon === value)
			{
				return;
			}
			if(this._defaultIcon !== null &&
				this.currentIcon === this._defaultIcon)
			{
				//if this icon needs to be reused somewhere else, we need to
				//properly clean it up
				this.removeCurrentIcon(this._defaultIcon);
				this.currentIcon = null;
			}
			this._defaultIcon = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _stateToIcon:Object = {};

		/**
		 * @private
		 */
		public function get upIcon():DisplayObject
		{
			return this.getIconForState(ButtonState.UP);
		}

		/**
		 * @private
		 */
		public function set upIcon(value:DisplayObject):void
		{
			this.setIconForState(ButtonState.UP, value);
		}

		/**
		 * @private
		 */
		public function get downIcon():DisplayObject
		{
			return this.getIconForState(ButtonState.DOWN);
		}

		/**
		 * @private
		 */
		public function set downIcon(value:DisplayObject):void
		{
			this.setIconForState(ButtonState.DOWN, value);
		}

		/**
		 * @private
		 */
		public function get hoverIcon():DisplayObject
		{
			return this.getIconForState(ButtonState.HOVER);
		}

		/**
		 * @private
		 */
		public function set hoverIcon(value:DisplayObject):void
		{
			this.setIconForState(ButtonState.HOVER, value);
		}

		/**
		 * @private
		 */
		public function get disabledIcon():DisplayObject
		{
			return this.getIconForState(ButtonState.DISABLED);
		}

		/**
		 * @private
		 */
		public function set disabledIcon(value:DisplayObject):void
		{
			this.setIconForState(ButtonState.DISABLED, value);
		}

		/**
		 * @private
		 */
		protected var _longPressDuration:Number = 0.5;

		/**
		 * The duration, in seconds, of a long press.
		 *
		 * <p>The following example changes the long press duration to one full second:</p>
		 *
		 * <listing version="3.0">
		 * button.longPressDuration = 1.0;</listing>
		 *
		 * @default 0.5
		 *
		 * @see #event:longPress
		 * @see #isLongPressEnabled
		 */
		public function get longPressDuration():Number
		{
			return this._longPressDuration;
		}

		/**
		 * @private
		 */
		public function set longPressDuration(value:Number):void
		{
			if(this._longPressDuration == value)
			{
				return;
			}
			this._longPressDuration = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isLongPressEnabled:Boolean = false;

		/**
		 * Determines if <code>FeathersEventType.LONG_PRESS</code> will be
		 * dispatched.
		 *
		 * <p>The following example enables long presses:</p>
		 *
		 * <listing version="3.0">
		 * button.isLongPressEnabled = true;
		 * button.addEventListener( FeathersEventType.LONG_PRESS, function( event:Event ):void
		 * {
		 *     // long press
		 * });</listing>
		 *
		 * @default false
		 *
		 * @see #event:longPress
		 * @see #longPressDuration
		 */
		public function get isLongPressEnabled():Boolean
		{
			return this._isLongPressEnabled;
		}

		/**
		 * @private
		 */
		public function set isLongPressEnabled(value:Boolean):void
		{
			if(this._isLongPressEnabled === value)
			{
				return;
			}
			this._isLongPressEnabled = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _stateToScale:Object = {};

		/**
		 * @private
		 */
		public function get scaleWhenDown():Number
		{
			return this.getScaleForState(ButtonState.DOWN);
		}

		/**
		 * @private
		 */
		public function set scaleWhenDown(value:Number):void
		{
			this.setScaleForState(ButtonState.DOWN, value);
		}

		/**
		 * @private
		 */
		public function get scaleWhenHovering():Number
		{
			return this.getScaleForState(ButtonState.HOVER);
		}

		/**
		 * @private
		 */
		public function set scaleWhenHovering(value:Number):void
		{
			this.setScaleForState(ButtonState.HOVER, value);
		}

		/**
		 * @inheritDoc
		 */
		public function get baseline():Number
		{
			if(!this.labelTextRenderer)
			{
				return this.scaledActualHeight;
			}
			return this.scaleY * (this.labelTextRenderer.y + this.labelTextRenderer.baseline);
		}

		/**
		 * The number of text lines displayed by the button. The component may
		 * contain multiple text lines if the text contains line breaks or if
		 * the <code>wordWrap</code> property is enabled.
		 *
		 * @see #wordWrap
		 */
		public function get numLines():int
		{
			if(this.labelTextRenderer === null)
			{
				return 0;
			}
			return this.labelTextRenderer.numLines;
		}

		/**
		 * @private
		 */
		protected var _ignoreIconResizes:Boolean = false;

		/**
		 * @private
		 */
		override public function render(painter:Painter):void
		{
			var scale:Number = this.getScaleForCurrentState();
			if(scale != 1)
			{
				var matrix:Matrix = Pool.getMatrix();
				//scale first, then translate... issue #1455
				matrix.scale(scale, scale);
				matrix.translate(Math.round((1 - scale) / 2 * this.actualWidth),
					Math.round((1 - scale) / 2 * this.actualHeight));
				painter.state.transformModelviewMatrix(matrix);
				Pool.putMatrix(matrix);
			}
			super.render(painter);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			//we don't dispose it if the button is the parent because it'll
			//already get disposed in super.dispose()
			if(this._defaultIcon !== null && this._defaultIcon.parent !== this)
			{
				this._defaultIcon.dispose();
			}
			for(var state:String in this._stateToIcon)
			{
				var icon:DisplayObject = this._stateToIcon[state] as DisplayObject;
				if(icon !== null && icon.parent !== this)
				{
					icon.dispose();
				}
			}
			if(this.keyToState !== null)
			{
				//setting the target to null will remove listeners and do any
				//other clean up that is needed
				this.keyToState.target = null;
			}
			if(this.keyToTrigger !== null)
			{
				this.keyToTrigger.target = null;
			}
			if(this.dpadEnterKeyToState !== null)
			{
				this.dpadEnterKeyToState.target = null;
			}
			if(this.dpadEnterKeyToTrigger !== null)
			{
				this.dpadEnterKeyToTrigger.target = null;
			}
			if(this._fontStylesSet !== null)
			{
				this._fontStylesSet.dispose();
				this._fontStylesSet = null;
			}
			super.dispose();
		}

		/**
		 * Gets the font styles to be used to display the button's text when the
		 * button's <code>currentState</code> property matches the specified
		 * state value.
		 *
		 * <p>If font styles are not defined for a specific state, returns
		 * <code>null</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #setFontStylesForState()
		 * @see #style:fontStyles
		 */
		public function getFontStylesForState(state:String):TextFormat
		{
			if(this._fontStylesSet === null)
			{
				return null;
			}
			return this._fontStylesSet.getFormatForState(state);
		}

		/**
		 * Sets the font styles to be used to display the button's text when the
		 * button's <code>currentState</code> property matches the specified
		 * state value.
		 *
		 * <p>If font styles are not defined for a specific state, the value of
		 * the <code>fontStyles</code> property will be used instead.</p>
		 *
		 * <p>Note: if the text renderer has been customized with advanced font
		 * formatting, it may override the values specified with
		 * <code>setFontStylesForState()</code> and properties like
		 * <code>fontStyles</code> and <code>disabledFontStyles</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #style:fontStyles
		 */
		public function setFontStylesForState(state:String, format:TextFormat):void
		{
			var key:String = "setFontStylesForState--" + state;
			if(this.processStyleRestriction(key))
			{
				return;
			}
			function changeHandler(event:Event):void
			{
				processStyleRestriction(key);
			}
			var oldFormat:TextFormat = this._fontStylesSet.getFormatForState(state);
			if(oldFormat !== null)
			{
				oldFormat.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.setFormatForState(state, format);
			if(format !== null)
			{
				format.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * Gets the icon to be used by the button when the button's
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If a icon is not defined for a specific state, returns
		 * <code>null</code>.</p>
		 *
		 * @see #setIconForState()
		 */
		public function getIconForState(state:String):DisplayObject
		{
			return this._stateToIcon[state] as DisplayObject;
		}

		/**
		 * Sets the icon to be used by the button when the button's
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If an icon is not defined for a specific state, the value of the
		 * <code>defaultIcon</code> property will be used instead.</p>
		 *
		 * @see #style:defaultIcon
		 * @see #getIconForState()
		 * @see feathers.controls.ButtonState
		 */
		public function setIconForState(state:String, icon:DisplayObject):void
		{
			var key:String = "setIconForState--" + state;
			if(this.processStyleRestriction(key))
			{
				if(icon !== null)
				{
					icon.dispose();
				}
				return;
			}
			var oldIcon:DisplayObject = this._stateToIcon[state] as DisplayObject;
			if(oldIcon !== null &&
				this.currentIcon === oldIcon)
			{
				//if this icon needs to be reused somewhere else, we need to
				//properly clean it up
				this.removeCurrentIcon(oldIcon);
				this.currentIcon = null;
			}
			if(icon !== null)
			{
				this._stateToIcon[state] = icon;
			}
			else
			{
				delete this._stateToIcon[state];
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * Gets the scale to be used by the button when the button's
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If a scale is not defined for a specific state, returns
		 * <code>NaN</code>.</p>
		 *
		 * @see #setScaleForState()
		 */
		public function getScaleForState(state:String):Number
		{
			if(state in this._stateToScale)
			{
				return this._stateToScale[state] as Number;
			}
			return NaN;
		}

		/**
		 * Sets the scale to be used by the button when the button's
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If an icon is not defined for a specific state, the value of the
		 * <code>defaultIcon</code> property will be used instead.</p>
		 *
		 * @see #getScaleForState()
		 * @see feathers.controls.ButtonState
		 */
		public function setScaleForState(state:String, scale:Number):void
		{
			var key:String = "setScaleForState--" + state;
			if(this.processStyleRestriction(key))
			{
				return;
			}
			if(scale === scale) //!isNaN
			{
				this._stateToScale[state] = scale;
			}
			else
			{
				delete this._stateToScale[state];
			}
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			super.initialize();
			if(this.keyToState === null)
			{
				this.keyToState = new KeyToState(this, this.changeState);
			}
			if(this.keyToTrigger === null)
			{
				this.keyToTrigger = new KeyToTrigger(this);
			}
			if(this.longPress === null)
			{
				this.longPress = new LongPress(this);
			}
			if(this.dpadEnterKeyToState === null)
			{
				this.dpadEnterKeyToState = new KeyToState(this, this.changeState);
				this.dpadEnterKeyToState.keyCode = Keyboard.ENTER;
				this.dpadEnterKeyToState.keyLocation = 4; //KeyLocation.D_PAD is only in AIR
			}
			if(this.dpadEnterKeyToTrigger === null)
			{
				this.dpadEnterKeyToTrigger = new KeyToTrigger(this, Keyboard.ENTER);
				this.dpadEnterKeyToTrigger.keyLocation = 4; //KeyLocation.D_PAD is only in AIR
			}
			this.longPress.tapToTrigger = this.tapToTrigger;
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var textRendererInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_TEXT_RENDERER);
			var focusInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_FOCUS);

			if(textRendererInvalid)
			{
				this.createLabel();
			}

			if(textRendererInvalid || stateInvalid || dataInvalid)
			{
				this.refreshLabel();
			}

			if(stylesInvalid || stateInvalid)
			{
				this.refreshLongPressEvents();
				this.refreshIcon();
			}

			//most components don't need to check the state before passing
			//properties to a child component, but button is an exception
			if(textRendererInvalid || stylesInvalid || stateInvalid)
			{
				this.refreshLabelStyles();
			}

			super.draw();

			if(textRendererInvalid || stylesInvalid || stateInvalid || dataInvalid || sizeInvalid)
			{
				this.layoutContent();
			}

			if(sizeInvalid || focusInvalid)
			{
				this.refreshFocusIndicator();
			}
		}

		/**
		 * @private
		 */
		override protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			var labelRenderer:ITextRenderer = null;
			if(this._label !== null && this.labelTextRenderer)
			{
				labelRenderer = this.labelTextRenderer;
				this.refreshLabelTextRendererDimensions(true);
				this.labelTextRenderer.measureText(HELPER_POINT);
			}

			var adjustedGap:Number = this._gap;
			if(adjustedGap == Number.POSITIVE_INFINITY)
			{
				adjustedGap = this._minGap;
			}

			resetFluidChildDimensionsForMeasurement(this.currentSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitSkinWidth, this._explicitSkinHeight,
				this._explicitSkinMinWidth, this._explicitSkinMinHeight,
				this._explicitSkinMaxWidth, this._explicitSkinMaxHeight);
			var measureSkin:IMeasureDisplayObject = this.currentSkin as IMeasureDisplayObject;

			if(this.currentIcon is IValidating)
			{
				IValidating(this.currentIcon).validate();
			}
			if(this.currentSkin is IValidating)
			{
				IValidating(this.currentSkin).validate();
			}

			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				if(labelRenderer !== null)
				{
					newMinWidth = HELPER_POINT.x;
				}
				else
				{
					newMinWidth = 0;
				}
				if(this.currentIcon !== null)
				{
					if(labelRenderer !== null) //both label and icon
					{
						if(this._iconPosition !== RelativePosition.TOP &&
							this._iconPosition !== RelativePosition.BOTTOM &&
							this._iconPosition !== RelativePosition.MANUAL)
						{
							newMinWidth += adjustedGap;
							if(this.currentIcon is IFeathersControl)
							{
								newMinWidth += IFeathersControl(this.currentIcon).minWidth;
							}
							else
							{
								newMinWidth += this.currentIcon.width;
							}
						}
						else //top, bottom, or manual
						{
							if(this.currentIcon is IFeathersControl)
							{
								var iconMinWidth:Number = IFeathersControl(this.currentIcon).minWidth;
								if(iconMinWidth > newMinWidth)
								{
									newMinWidth = iconMinWidth;
								}
							}
							else if(this.currentIcon.width > newMinWidth)
							{
								newMinWidth = this.currentIcon.width;
							}
						}
					}
					else //no label
					{
						if(this.currentIcon is IFeathersControl)
						{
							newMinWidth = IFeathersControl(this.currentIcon).minWidth;
						}
						else
						{
							newMinWidth = this.currentIcon.width;
						}
					}
				}
				newMinWidth += this._paddingLeft + this._paddingRight;
				if(this.currentSkin !== null)
				{
					if(measureSkin !== null)
					{
						if(measureSkin.minWidth > newMinWidth)
						{
							newMinWidth = measureSkin.minWidth;
						}
					}
					else if(this._explicitSkinMinWidth > newMinWidth)
					{
						newMinWidth = this._explicitSkinMinWidth;
					}
				}
			}

			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				if(labelRenderer !== null)
				{
					newMinHeight = HELPER_POINT.y;
				}
				else
				{
					newMinHeight = 0;
				}
				if(this.currentIcon !== null)
				{
					if(labelRenderer !== null) //both label and icon
					{
						if(this._iconPosition === RelativePosition.TOP || this._iconPosition === RelativePosition.BOTTOM)
						{
							newMinHeight += adjustedGap;
							if(this.currentIcon is IFeathersControl)
							{
								newMinHeight += IFeathersControl(this.currentIcon).minHeight;
							}
							else
							{
								newMinHeight += this.currentIcon.height;
							}
						}
						else //left, right, manual
						{
							if(this.currentIcon is IFeathersControl)
							{
								var iconMinHeight:Number = IFeathersControl(this.currentIcon).minHeight;
								if(iconMinHeight > newMinHeight)
								{
									newMinHeight = iconMinHeight;
								}
							}
							else if(this.currentIcon.height > newMinHeight)
							{
								newMinHeight = this.currentIcon.height;
							}
						}
					}
					else //no label
					{
						if(this.currentIcon is IFeathersControl)
						{
							newMinHeight = IFeathersControl(this.currentIcon).minHeight;
						}
						else
						{
							newMinHeight = this.currentIcon.height;
						}
					}
				}
				newMinHeight += this._paddingTop + this._paddingBottom;
				if(this.currentSkin !== null)
				{
					if(measureSkin !== null)
					{
						if(measureSkin.minHeight > newMinHeight)
						{
							newMinHeight = measureSkin.minHeight;
						}
					}
					else if(this._explicitSkinMinHeight > newMinHeight)
					{
						newMinHeight = this._explicitSkinMinHeight;
					}
				}
			}

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				if(labelRenderer !== null)
				{
					newWidth = HELPER_POINT.x;
				}
				else
				{
					newWidth = 0;
				}
				if(this.currentIcon !== null)
				{
					if(labelRenderer !== null) //both label and icon
					{
						if(this._iconPosition !== RelativePosition.TOP &&
							this._iconPosition !== RelativePosition.BOTTOM &&
							this._iconPosition !== RelativePosition.MANUAL)
						{
							newWidth += adjustedGap + this.currentIcon.width;
						}
						else if(this.currentIcon.width > newWidth) //top, bottom, or manual
						{
							newWidth = this.currentIcon.width;
						}
					}
					else //no label
					{
						newWidth = this.currentIcon.width;
					}
				}
				newWidth += this._paddingLeft + this._paddingRight;
				if(this.currentSkin !== null &&
					this.currentSkin.width > newWidth)
				{
					newWidth = this.currentSkin.width;
				}
			}

			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				if(labelRenderer !== null)
				{
					newHeight = HELPER_POINT.y;
				}
				else
				{
					newHeight = 0;
				}
				if(this.currentIcon !== null)
				{
					if(labelRenderer !== null) //both label and icon
					{
						if(this._iconPosition === RelativePosition.TOP || this._iconPosition === RelativePosition.BOTTOM)
						{
							newHeight += adjustedGap + this.currentIcon.height;
						}
						else if(this.currentIcon.height > newHeight) //left, right, manual
						{
							newHeight = this.currentIcon.height;
						}
					}
					else //no label
					{
						newHeight = this.currentIcon.height;
					}
				}
				newHeight += this._paddingTop + this._paddingBottom;
				if(this.currentSkin !== null &&
					this.currentSkin.height > newHeight)
				{
					newHeight = this.currentSkin.height;
				}
			}

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * @private
		 */
		override protected function changeState(state:String):void
		{
			var oldState:String = this._currentState;
			if(oldState === state)
			{
				return;
			}
			super.changeState(state);
			if(this.getScaleForCurrentState() != this.getScaleForCurrentState(oldState))
			{
				this.setRequiresRedraw();
			}
		}

		/**
		 * Creates the label text renderer sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #labelTextRenderer
		 * @see #labelFactory
		 */
		protected function createLabel():void
		{
			if(this.labelTextRenderer)
			{
				this.removeChild(DisplayObject(this.labelTextRenderer), true);
				this.labelTextRenderer = null;
			}

			if(this._hasLabelTextRenderer)
			{
				var factory:Function = this._labelFactory != null ? this._labelFactory : FeathersControl.defaultTextRendererFactory;
				this.labelTextRenderer = ITextRenderer(factory());
				var labelStyleName:String = this._customLabelStyleName != null ? this._customLabelStyleName : this.labelStyleName;
				this.labelTextRenderer.styleNameList.add(labelStyleName);
				if(this.labelTextRenderer is IStateObserver)
				{
					IStateObserver(this.labelTextRenderer).stateContext = this;
				}
				this.addChild(DisplayObject(this.labelTextRenderer));
				this._explicitLabelWidth = this.labelTextRenderer.explicitWidth;
				this._explicitLabelHeight = this.labelTextRenderer.explicitHeight;
				this._explicitLabelMinWidth = this.labelTextRenderer.explicitMinWidth;
				this._explicitLabelMinHeight = this.labelTextRenderer.explicitMinHeight;
				this._explicitLabelMaxWidth = this.labelTextRenderer.explicitMaxWidth;
				this._explicitLabelMaxHeight = this.labelTextRenderer.explicitMaxHeight;
			}
		}

		/**
		 * @private
		 */
		protected function refreshLabel():void
		{
			if(!this.labelTextRenderer)
			{
				return;
			}
			this.labelTextRenderer.text = this._label;
			this.labelTextRenderer.visible = this._label !== null && this._label.length > 0;
			this.labelTextRenderer.isEnabled = this._isEnabled;
		}

		/**
		 * Sets the <code>currentIcon</code> property.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected function refreshIcon():void
		{
			var oldIcon:DisplayObject = this.currentIcon;
			this.currentIcon = this.getCurrentIcon();
			if(this.currentIcon is IFeathersControl)
			{
				IFeathersControl(this.currentIcon).isEnabled = this._isEnabled;
			}
			if(this.currentIcon !== oldIcon)
			{
				if(oldIcon !== null)
				{
					this.removeCurrentIcon(oldIcon);
				}
				if(this.currentIcon !== null)
				{
					if(this.currentIcon is IStateObserver)
					{
						IStateObserver(this.currentIcon).stateContext = this;
					}
					//we want the icon to appear below the label text renderer
					var index:int = this.numChildren;
					if(this.labelTextRenderer)
					{
						index = this.getChildIndex(DisplayObject(this.labelTextRenderer));
					}
					this.addChildAt(this.currentIcon, index);
					if(this.currentIcon is IFeathersControl)
					{
						IFeathersControl(this.currentIcon).addEventListener(FeathersEventType.RESIZE, currentIcon_resizeHandler);
					}
				}
			}
		}

		/**
		 * @private
		 */
		protected function removeCurrentIcon(icon:DisplayObject):void
		{
			if(icon === null)
			{
				return;
			}
			if(icon is IFeathersControl)
			{
				IFeathersControl(icon).removeEventListener(FeathersEventType.RESIZE, currentIcon_resizeHandler);
			}
			if(icon is IStateObserver)
			{
				IStateObserver(icon).stateContext = null;
			}
			if(icon.parent === this)
			{
				this.removeChild(icon, false);
			}
		}

		/**
		 * @private
		 */
		protected function getCurrentIcon():DisplayObject
		{
			var result:DisplayObject = this._stateToIcon[this._currentState] as DisplayObject;
			if(result !== null)
			{
				return result;
			}
			return this._defaultIcon;
		}

		/**
		 * @private
		 */
		protected function getScaleForCurrentState(state:String = null):Number
		{
			if(state === null)
			{
				state = this._currentState;
			}
			if(state in this._stateToScale)
			{
				return this._stateToScale[state];
			}
			return 1;
		}

		/**
		 * @private
		 */
		protected function refreshLabelStyles():void
		{
			if(this.labelTextRenderer === null)
			{
				return;
			}
			this.labelTextRenderer.fontStyles = this._fontStylesSet;
			this.labelTextRenderer.wordWrap = this._wordWrap;
			for(var propertyName:String in this._defaultLabelProperties)
			{
				var propertyValue:Object = this._defaultLabelProperties[propertyName];
				this.labelTextRenderer[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		override protected function refreshTriggeredEvents():void
		{
			super.refreshTriggeredEvents();
			this.keyToTrigger.isEnabled = this._isEnabled;
			this.dpadEnterKeyToTrigger.isEnabled = this._isEnabled;
		}

		/**
		 * @private
		 */
		protected function refreshLongPressEvents():void
		{
			this.longPress.isEnabled = this._isEnabled && this._isLongPressEnabled;
			this.longPress.longPressDuration = this._longPressDuration;
		}

		/**
		 * Positions and sizes the button's content.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected function layoutContent():void
		{
			this.refreshLabelTextRendererDimensions(false);
			var labelRenderer:DisplayObject = null;
			if(this._label !== null && this.labelTextRenderer !== null)
			{
				labelRenderer = DisplayObject(this.labelTextRenderer);
			}
			var iconIsInLayout:Boolean = this.currentIcon && this._iconPosition != RelativePosition.MANUAL;
			if(labelRenderer && iconIsInLayout)
			{
				this.positionSingleChild(labelRenderer);
				this.positionLabelAndIcon();
			}
			else if(labelRenderer)
			{
				this.positionSingleChild(labelRenderer);
			}
			else if(iconIsInLayout)
			{
				this.positionSingleChild(this.currentIcon);
			}

			if(this.currentIcon)
			{
				if(this._iconPosition == RelativePosition.MANUAL)
				{
					this.currentIcon.x = this._paddingLeft;
					this.currentIcon.y = this._paddingTop;
				}
				this.currentIcon.x += this._iconOffsetX;
				this.currentIcon.y += this._iconOffsetY;
			}
			if(labelRenderer)
			{
				this.labelTextRenderer.x += this._labelOffsetX;
				this.labelTextRenderer.y += this._labelOffsetY;
			}
		}

		/**
		 * @private
		 */
		protected function refreshLabelTextRendererDimensions(forMeasurement:Boolean):void
		{
			var oldIgnoreIconResizes:Boolean = this._ignoreIconResizes;
			this._ignoreIconResizes = true;
			if(this.currentIcon is IValidating)
			{
				IValidating(this.currentIcon).validate();
			}
			this._ignoreIconResizes = oldIgnoreIconResizes;
			if(this._label === null || this.labelTextRenderer === null)
			{
				return;
			}
			var calculatedWidth:Number = this.actualWidth;
			var calculatedHeight:Number = this.actualHeight;
			if(forMeasurement)
			{
				calculatedWidth = this._explicitWidth;
				if(calculatedWidth !== calculatedWidth) //isNaN
				{
					calculatedWidth = this._explicitMaxWidth;
				}
				calculatedHeight = this._explicitHeight;
				if(calculatedHeight !== calculatedHeight) //isNaN
				{
					calculatedHeight = this._explicitMaxHeight;
				}
			}
			calculatedWidth -= (this._paddingLeft + this._paddingRight);
			calculatedHeight -= (this._paddingTop + this._paddingBottom);
			if(this.currentIcon !== null)
			{
				var adjustedGap:Number = this._gap;
				if(adjustedGap == Number.POSITIVE_INFINITY)
				{
					adjustedGap = this._minGap;
				}
				if(this._iconPosition === RelativePosition.LEFT || this._iconPosition === RelativePosition.LEFT_BASELINE ||
					this._iconPosition === RelativePosition.RIGHT || this._iconPosition === RelativePosition.RIGHT_BASELINE)
				{
					calculatedWidth -= (this.currentIcon.width + adjustedGap);
				}
				if(this._iconPosition === RelativePosition.TOP || this._iconPosition === RelativePosition.BOTTOM)
				{
					calculatedHeight -= (this.currentIcon.height + adjustedGap);
				}
			}
			if(calculatedWidth < 0)
			{
				calculatedWidth = 0;
			}
			if(calculatedHeight < 0)
			{
				calculatedHeight = 0;
			}
			if(calculatedWidth > this._explicitLabelMaxWidth)
			{
				calculatedWidth = this._explicitLabelMaxWidth;
			}
			if(calculatedHeight > this._explicitLabelMaxHeight)
			{
				calculatedHeight = this._explicitLabelMaxHeight;
			}
			this.labelTextRenderer.width = this._explicitLabelWidth;
			this.labelTextRenderer.height = this._explicitLabelHeight;
			this.labelTextRenderer.minWidth = this._explicitLabelMinWidth;
			this.labelTextRenderer.minHeight = this._explicitLabelMinHeight;
			this.labelTextRenderer.maxWidth = calculatedWidth;
			this.labelTextRenderer.maxHeight = calculatedHeight;
			this.labelTextRenderer.validate();
			if(!forMeasurement)
			{
				calculatedWidth = this.labelTextRenderer.width;
				calculatedHeight = this.labelTextRenderer.height;
				//setting all of these dimensions explicitly means that the text
				//renderer won't measure itself again when it validates, which
				//helps performance. we'll reset them when the button needs to
				//measure itself.
				this.labelTextRenderer.width = calculatedWidth;
				this.labelTextRenderer.height = calculatedHeight;
				this.labelTextRenderer.minWidth = calculatedWidth;
				this.labelTextRenderer.minHeight = calculatedHeight;
			}
		}

		/**
		 * @private
		 */
		protected function positionSingleChild(displayObject:DisplayObject):void
		{
			if(this._horizontalAlign == HorizontalAlign.LEFT)
			{
				displayObject.x = this._paddingLeft;
			}
			else if(this._horizontalAlign == HorizontalAlign.RIGHT)
			{
				displayObject.x = this.actualWidth - this._paddingRight - displayObject.width;
			}
			else //center
			{
				displayObject.x = this._paddingLeft + Math.round((this.actualWidth - this._paddingLeft - this._paddingRight - displayObject.width) / 2);
			}
			if(this._verticalAlign == VerticalAlign.TOP)
			{
				displayObject.y = this._paddingTop;
			}
			else if(this._verticalAlign == VerticalAlign.BOTTOM)
			{
				displayObject.y = this.actualHeight - this._paddingBottom - displayObject.height;
			}
			else //middle
			{
				displayObject.y = this._paddingTop + Math.round((this.actualHeight - this._paddingTop - this._paddingBottom - displayObject.height) / 2);
			}
		}

		/**
		 * @private
		 */
		protected function positionLabelAndIcon():void
		{
			if(this._iconPosition == RelativePosition.TOP)
			{
				if(this._gap == Number.POSITIVE_INFINITY)
				{
					this.currentIcon.y = this._paddingTop;
					this.labelTextRenderer.y = this.actualHeight - this._paddingBottom - this.labelTextRenderer.height;
				}
				else
				{
					if(this._verticalAlign == VerticalAlign.TOP)
					{
						this.labelTextRenderer.y += this.currentIcon.height + this._gap;
					}
					else if(this._verticalAlign == VerticalAlign.MIDDLE)
					{
						this.labelTextRenderer.y += Math.round((this.currentIcon.height + this._gap) / 2);
					}
					this.currentIcon.y = this.labelTextRenderer.y - this.currentIcon.height - this._gap;
				}
			}
			else if(this._iconPosition == RelativePosition.RIGHT || this._iconPosition == RelativePosition.RIGHT_BASELINE)
			{
				if(this._gap == Number.POSITIVE_INFINITY)
				{
					this.labelTextRenderer.x = this._paddingLeft;
					this.currentIcon.x = this.actualWidth - this._paddingRight - this.currentIcon.width;
				}
				else
				{
					if(this._horizontalAlign == HorizontalAlign.RIGHT)
					{
						this.labelTextRenderer.x -= this.currentIcon.width + this._gap;
					}
					else if(this._horizontalAlign == HorizontalAlign.CENTER)
					{
						this.labelTextRenderer.x -= Math.round((this.currentIcon.width + this._gap) / 2);
					}
					this.currentIcon.x = this.labelTextRenderer.x + this.labelTextRenderer.width + this._gap;
				}
			}
			else if(this._iconPosition == RelativePosition.BOTTOM)
			{
				if(this._gap == Number.POSITIVE_INFINITY)
				{
					this.labelTextRenderer.y = this._paddingTop;
					this.currentIcon.y = this.actualHeight - this._paddingBottom - this.currentIcon.height;
				}
				else
				{
					if(this._verticalAlign == VerticalAlign.BOTTOM)
					{
						this.labelTextRenderer.y -= this.currentIcon.height + this._gap;
					}
					else if(this._verticalAlign == VerticalAlign.MIDDLE)
					{
						this.labelTextRenderer.y -= Math.round((this.currentIcon.height + this._gap) / 2);
					}
					this.currentIcon.y = this.labelTextRenderer.y + this.labelTextRenderer.height + this._gap;
				}
			}
			else if(this._iconPosition == RelativePosition.LEFT || this._iconPosition == RelativePosition.LEFT_BASELINE)
			{
				if(this._gap == Number.POSITIVE_INFINITY)
				{
					this.currentIcon.x = this._paddingLeft;
					this.labelTextRenderer.x = this.actualWidth - this._paddingRight - this.labelTextRenderer.width;
				}
				else
				{
					if(this._horizontalAlign == HorizontalAlign.LEFT)
					{
						this.labelTextRenderer.x += this._gap + this.currentIcon.width;
					}
					else if(this._horizontalAlign == HorizontalAlign.CENTER)
					{
						this.labelTextRenderer.x += Math.round((this._gap + this.currentIcon.width) / 2);
					}
					this.currentIcon.x = this.labelTextRenderer.x - this._gap - this.currentIcon.width;
				}
			}

			if(this._iconPosition == RelativePosition.LEFT || this._iconPosition == RelativePosition.RIGHT)
			{
				if(this._verticalAlign == VerticalAlign.TOP)
				{
					this.currentIcon.y = this._paddingTop;
				}
				else if(this._verticalAlign == VerticalAlign.BOTTOM)
				{
					this.currentIcon.y = this.actualHeight - this._paddingBottom - this.currentIcon.height;
				}
				else
				{
					this.currentIcon.y = this._paddingTop + Math.round((this.actualHeight - this._paddingTop - this._paddingBottom - this.currentIcon.height) / 2);
				}
			}
			else if(this._iconPosition == RelativePosition.LEFT_BASELINE || this._iconPosition == RelativePosition.RIGHT_BASELINE)
			{
				this.currentIcon.y = this.labelTextRenderer.y + (this.labelTextRenderer.baseline) - this.currentIcon.height;
			}
			else //top or bottom
			{
				if(this._horizontalAlign == HorizontalAlign.LEFT)
				{
					this.currentIcon.x = this._paddingLeft;
				}
				else if(this._horizontalAlign == HorizontalAlign.RIGHT)
				{
					this.currentIcon.x = this.actualWidth - this._paddingRight - this.currentIcon.width;
				}
				else
				{
					this.currentIcon.x = this._paddingLeft + Math.round((this.actualWidth - this._paddingLeft - this._paddingRight - this.currentIcon.width) / 2);
				}
			}
		}

		/**
		 * @private
		 */
		protected function childProperties_onChange(proxy:PropertyProxy, name:Object):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function currentIcon_resizeHandler():void
		{
			if(this._ignoreIconResizes)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected function fontStyles_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}
	}
}

================================================
FILE: source/feathers/controls/ButtonGroup.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.ITextBaselineControl;
	import feathers.core.PropertyProxy;
	import feathers.data.IListCollection;
	import feathers.events.CollectionEventType;
	import feathers.events.FeathersEventType;
	import feathers.layout.Direction;
	import feathers.layout.FlowLayout;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.ILayout;
	import feathers.layout.IVirtualLayout;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.layout.ViewPortBounds;
	import feathers.skins.IStyleProvider;

	import flash.utils.Dictionary;

	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * A style name to add to all buttons in this button group. Typically
	 * used by a theme to provide different styles to different button groups.
	 *
	 * <p>The following example provides a custom button style name:</p>
	 *
	 * <listing version="3.0">
	 * group.customButtonStyleName = "my-custom-button";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-button", setCustomButtonStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_BUTTON
	 * @see feathers.core.FeathersControl#styleNameList
	 */
	[Style(name="customButtonStyleName",type="String")]

	/**
	 * A style name to add to the first button in this button group.
	 * Typically used by a theme to provide different styles to the first
	 * button.
	 *
	 * <p>The following example provides a custom first button style name:</p>
	 *
	 * <listing version="3.0">
	 * group.customFirstButtonStyleName = "my-custom-first-button";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-first-button", setCustomFirstButtonStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 */
	[Style(name="customFirstButtonStyleName",type="String")]

	/**
	 * A style name to add to the last button in this button group.
	 * Typically used by a theme to provide different styles to the last
	 * button.
	 *
	 * <p>The following example provides a custom last button style name:</p>
	 *
	 * <listing version="3.0">
	 * group.customLastButtonStyleName = "my-custom-last-button";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-last-button", setCustomLastButtonStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 */
	[Style(name="customLastButtonStyleName",type="String")]

	/**
	 * The button group layout is either vertical or horizontal.
	 *
	 * <p>If the <code>direction</code> is
	 * <code>Direction.HORIZONTAL</code> and
	 * <code>distributeButtonSizes</code> is <code>false</code>, the buttons
	 * may be displayed in multiple rows, if they won't fit in one row
	 * horizontally.</p>
	 *
	 * <p>The following example sets the layout direction of the buttons
	 * to line them up horizontally:</p>
	 *
	 * <listing version="3.0">
	 * group.direction = Direction.HORIZONTAL;</listing>
	 *
	 * <p><strong>Note:</strong> The <code>Direction.NONE</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.Direction.VERTICAL
	 *
	 * @see feathers.layout.Direction#HORIZONTAL
	 * @see feathers.layout.Direction#VERTICAL
	 */
	[Style(name="direction",type="String")]

	/**
	 * If <code>true</code>, the buttons will be equally sized in the
	 * direction of the layout. In other words, if the button group is
	 * horizontal, each button will have the same width, and if the button
	 * group is vertical, each button will have the same height. If
	 * <code>false</code>, the buttons will be sized to their ideal
	 * dimensions.
	 *
	 * <p>The following example doesn't distribute the button sizes:</p>
	 *
	 * <listing version="3.0">
	 * group.distributeButtonSizes = false;</listing>
	 *
	 * @default true
	 */
	[Style(name="distributeButtonSizes",type="Boolean")]

	/**
	 * Space, in pixels, between the first two buttons. If <code>NaN</code>,
	 * the default <code>gap</code> property will be used.
	 *
	 * <p>The following example sets the gap between the first and second
	 * button to a different value than the standard gap:</p>
	 *
	 * <listing version="3.0">
	 * group.firstGap = 30;
	 * group.gap = 20;</listing>
	 *
	 * @default NaN
	 *
	 * @see #style:gap
	 * @see #style:lastGap
	 */
	[Style(name="firstGap",type="Number")]

	/**
	 * Space, in pixels, between buttons.
	 *
	 * <p>The following example sets the gap used for the button layout to
	 * 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * group.gap = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:firstGap
	 * @see #style:lastGap
	 */
	[Style(name="gap",type="Number")]

	/**
	 * Determines how the buttons are horizontally aligned within the bounds
	 * of the button group (on the x-axis).
	 *
	 * <p>The following example aligns the group's content to the left:</p>
	 *
	 * <listing version="3.0">
	 * group.horizontalAlign = HorizontalAlign.LEFT;</listing>
	 *
	 * @default feathers.layout.HorizontalAlign.JUSTIFY
	 *
	 * @see feathers.layout.HorizontalAlign#LEFT
	 * @see feathers.layout.HorizontalAlign#CENTER
	 * @see feathers.layout.HorizontalAlign#RIGHT
	 * @see feathers.layout.HorizontalAlign#JUSTIFY
	 */
	[Style(name="horizontalAlign",type="String")]

	/**
	 * Space, in pixels, between the last two buttons. If <code>NaN</code>,
	 * the default <code>gap</code> property will be used.
	 *
	 * <p>The following example sets the gap between the last and next to last
	 * button to a different value than the standard gap:</p>
	 *
	 * <listing version="3.0">
	 * group.lastGap = 30;
	 * group.gap = 20;</listing>
	 *
	 * @default NaN
	 *
	 * @see #style:gap
	 * @see #style:firstGap
	 */
	[Style(name="lastGap",type="Number")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the padding of all sides of the group
	 * is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * group.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, between the group's top edge and the
	 * group's buttons.
	 *
	 * <p>In the following example, the padding on the top edge of the
	 * group is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * group.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the group's right edge and the
	 * group's buttons.
	 *
	 * <p>In the following example, the padding on the right edge of the
	 * group is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * group.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the group's bottom edge and the
	 * group's buttons.
	 *
	 * <p>In the following example, the padding on the bottom edge of the
	 * group is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * group.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the group's left edge and the
	 * group's buttons.
	 *
	 * <p>In the following example, the padding on the left edge of the
	 * group is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * group.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * Determines how the buttons are vertically aligned within the bounds
	 * of the button group (on the y-axis).
	 *
	 * <p>The following example aligns the group's content to the top:</p>
	 *
	 * <listing version="3.0">
	 * group.verticalAlign = VerticalAlign.TOP;</listing>
	 *
	 * @default feathers.layout.VerticalAlign.JUSTIFY
	 *
	 * @see feathers.layout.VerticalAlign#TOP
	 * @see feathers.layout.VerticalAlign#MIDDLE
	 * @see feathers.layout.VerticalAlign#BOTTOM
	 * @see feathers.layout.VerticalAlign#JUSTIFY
	 */
	[Style(name="verticalAlign",type="String")]

	/**
	 * Dispatched when one of the buttons is triggered. The <code>data</code>
	 * property of the event contains the item from the data provider that is
	 * associated with the button that was triggered.
	 *
	 * <p>The following example listens to <code>Event.TRIGGERED</code> on the
	 * button group instead of on individual buttons:</p>
	 *
	 * <listing version="3.0">
	 * group.dataProvider = new ArrayCollection(
	 * [
	 *     { label: "Yes" },
	 *     { label: "No" },
	 *     { label: "Cancel" },
	 * ]);
	 * group.addEventListener( Event.TRIGGERED, function( event:Event, data:Object ):void
	 * {
	 *    trace( "The button with label \"" + data.label + "\" was triggered." );
	 * }</listing>
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The item associated with the button
	 *   that was triggered.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.TRIGGERED
	 */
	[Event(name="triggered",type="starling.events.Event")]

	/**
	 * A set of related buttons with layout, customized using a data provider.
	 *
	 * <p>The following example creates a button group with a few buttons:</p>
	 *
	 * <listing version="3.0">
	 * var group:ButtonGroup = new ButtonGroup();
	 * group.dataProvider = new ArrayCollection(
	 * [
	 *     { label: "Yes", triggered: yesButton_triggeredHandler },
	 *     { label: "No", triggered: noButton_triggeredHandler },
	 *     { label: "Cancel", triggered: cancelButton_triggeredHandler },
	 * ]);
	 * this.addChild( group );</listing>
	 *
	 * @see ../../../help/button-group.html How to use the Feathers ButtonGroup component
	 * @see feathers.controls.TabBar
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class ButtonGroup extends FeathersControl implements ITextBaselineControl
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>ButtonGroup</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_BUTTON_FACTORY:String = "buttonFactory";

		/**
		 * @private
		 */
		protected static const LABEL_FIELD:String = "label";

		/**
		 * @private
		 */
		protected static const ENABLED_FIELD:String = "isEnabled";

		/**
		 * @private
		 */
		private static const DEFAULT_BUTTON_FIELDS:Vector.<String> = new <String>
			[
				"defaultIcon",
				"upIcon",
				"downIcon",
				"hoverIcon",
				"disabledIcon",
				"defaultSelectedIcon",
				"selectedUpIcon",
				"selectedDownIcon",
				"selectedHoverIcon",
				"selectedDisabledIcon",
				"isSelected",
				"isToggle",
				"isLongPressEnabled",
				"name",
			];

		/**
		 * @private
		 */
		private static const DEFAULT_BUTTON_EVENTS:Vector.<String> = new <String>
			[
				Event.TRIGGERED,
				Event.CHANGE,
				FeathersEventType.LONG_PRESS,
			];

		/**
		 * The default value added to the <code>styleNameList</code> of the buttons.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_BUTTON:String = "feathers-button-group-button";

		/**
		 * @private
		 */
		protected static function defaultButtonFactory():Button
		{
			return new Button();
		}

		/**
		 * Constructor.
		 */
		public function ButtonGroup()
		{
			super();
		}

		/**
		 * The value added to the <code>styleNameList</code> of the buttons.
		 * This variable is <code>protected</code> so that sub-classes can
		 * customize the button style name in their constructors instead of
		 * using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_BUTTON</code>.
		 *
		 * <p>To customize the button style name without subclassing, see
		 * <code>customButtonStyleName</code>.</p>
		 *
		 * @see #style:customButtonStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var buttonStyleName:String = DEFAULT_CHILD_STYLE_NAME_BUTTON;

		/**
		 * The value added to the <code>styleNameList</code> of the first button.
		 *
		 * <p>To customize the first button name without subclassing, see
		 * <code>customFirstButtonStyleName</code>.</p>
		 *
		 * @see #style:customFirstButtonStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var firstButtonStyleName:String = DEFAULT_CHILD_STYLE_NAME_BUTTON;

		/**
		 * The value added to the <code>styleNameList</code> of the last button.
		 *
		 * <p>To customize the last button style name without subclassing, see
		 * <code>customLastButtonStyleName</code>.</p>
		 *
		 * @see #style:customLastButtonStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var lastButtonStyleName:String = DEFAULT_CHILD_STYLE_NAME_BUTTON;

		/**
		 * @private
		 */
		protected var activeFirstButton:Button;

		/**
		 * @private
		 */
		protected var inactiveFirstButton:Button;

		/**
		 * @private
		 */
		protected var activeLastButton:Button;

		/**
		 * @private
		 */
		protected var inactiveLastButton:Button;

		/**
		 * @private
		 */
		protected var _layoutItems:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * @private
		 */
		protected var activeButtons:Vector.<Button> = new <Button>[];

		/**
		 * @private
		 */
		protected var inactiveButtons:Vector.<Button> = new <Button>[];

		/**
		 * @private
		 */
		protected var _buttonToItem:Dictionary = new Dictionary(true);

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return ButtonGroup.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _dataProvider:IListCollection;

		/**
		 * The collection of data to be displayed with buttons.
		 *
		 * <p>The following example sets the button group's data provider:</p>
		 *
		 * <listing version="3.0">
		 * group.dataProvider = new ArrayCollection(
		 * [
		 *     { label: "Yes", triggered: yesButton_triggeredHandler },
		 *     { label: "No", triggered: noButton_triggeredHandler },
		 *     { label: "Cancel", triggered: cancelButton_triggeredHandler },
		 * ]);</listing>
		 *
		 * <p>By default, items in the data provider support the following
		 * properties from <code>Button</code></p>
		 *
		 * <ul>
		 *     <li>label</li>
		 *     <li>defaultIcon</li>
		 *     <li>upIcon</li>
		 *     <li>downIcon</li>
		 *     <li>hoverIcon</li>
		 *     <li>disabledIcon</li>
		 *     <li>defaultSelectedIcon</li>
		 *     <li>selectedUpIcon</li>
		 *     <li>selectedDownIcon</li>
		 *     <li>selectedHoverIcon</li>
		 *     <li>selectedDisabledIcon</li>
		 *     <li>isSelected (only supported by <code>ToggleButton</code>)</li>
		 *     <li>isToggle (only supported by <code>ToggleButton</code>)</li>
		 *     <li>isEnabled</li>
		 *     <li>name</li>
		 * </ul>
		 *
		 * <p>Additionally, you can add the following event listeners:</p>
		 *
		 * <ul>
		 *     <li>Event.TRIGGERED</li>
		 *     <li>Event.CHANGE (only supported by <code>ToggleButton</code>)</li>
		 * </ul>
		 *
		 * <p>Event listeners may have one of the following signatures:</p>
		 * <pre>function(event:Event):void</pre>
		 * <pre>function(event:Event, eventData:Object):void</pre>
		 * <pre>function(event:Event, eventData:Object, dataProviderItem:Object):void</pre>
		 *
		 * <p>To use properties and events that are only supported by
		 * <code>ToggleButton</code>, you must provide a <code>buttonFactory</code>
		 * that returns a <code>ToggleButton</code> instead of a <code>Button</code>.</p>
		 *
		 * <p>You can pass a function to the <code>buttonInitializer</code>
		 * property that can provide custom logic to interpret each item in the
		 * data provider differently. For example, you could use it to support
		 * additional properties or events.</p>
		 *
		 * @default null
		 *
		 * @see feathers.controls.Button
		 * @see #buttonInitializer
		 * @see feathers.data.ArrayCollection
		 * @see feathers.data.VectorCollection
		 * @see feathers.data.XMLListCollection
		 */
		public function get dataProvider():IListCollection
		{
			return this._dataProvider;
		}

		/**
		 * @private
		 */
		public function set dataProvider(value:IListCollection):void
		{
			if(this._dataProvider == value)
			{
				return;
			}
			if(this._dataProvider)
			{
				this._dataProvider.removeEventListener(CollectionEventType.UPDATE_ALL, dataProvider_updateAllHandler);
				this._dataProvider.removeEventListener(CollectionEventType.UPDATE_ITEM, dataProvider_updateItemHandler);
				this._dataProvider.removeEventListener(Event.CHANGE, dataProvider_changeHandler);
			}
			this._dataProvider = value;
			if(this._dataProvider)
			{
				this._dataProvider.addEventListener(CollectionEventType.UPDATE_ALL, dataProvider_updateAllHandler);
				this._dataProvider.addEventListener(CollectionEventType.UPDATE_ITEM, dataProvider_updateItemHandler);
				this._dataProvider.addEventListener(Event.CHANGE, dataProvider_changeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var layout:ILayout;

		/**
		 * @private
		 */
		protected var _viewPortBounds:ViewPortBounds = new ViewPortBounds();

		/**
		 * @private
		 */
		protected var _layoutResult:LayoutBoundsResult = new LayoutBoundsResult();

		/**
		 * @private
		 */
		protected var _direction:String = Direction.VERTICAL;

		[Inspectable(type="String",enumeration="horizontal,vertical")]
		/**
		 * @private
		 */
		public function get direction():String
		{
			return _direction;
		}

		/**
		 * @private
		 */
		public function set direction(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._direction === value)
			{
				return;
			}
			this._direction = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.JUSTIFY;

		[Inspectable(type="String",enumeration="left,center,right,justify")]
		/**
		 * @private
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._horizontalAlign === value)
			{
				return;
			}
			this._horizontalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.JUSTIFY;

		[Inspectable(type="String",enumeration="top,middle,bottom,justify")]
		/**
		 * @private
		 */
		public function get verticalAlign():String
		{
			return _verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._verticalAlign === value)
			{
				return;
			}
			this._verticalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _distributeButtonSizes:Boolean = true;

		/**
		 * @private
		 */
		public function get distributeButtonSizes():Boolean
		{
			return this._distributeButtonSizes;
		}

		/**
		 * @private
		 */
		public function set distributeButtonSizes(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._distributeButtonSizes === value)
			{
				return;
			}
			this._distributeButtonSizes = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _gap:Number = 0;

		/**
		 * @private
		 */
		public function get gap():Number
		{
			return this._gap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._gap == value)
			{
				return;
			}
			this._gap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _firstGap:Number = NaN;

		/**
		 * @private
		 */
		public function get firstGap():Number
		{
			return this._firstGap;
		}

		/**
		 * @private
		 */
		public function set firstGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._firstGap == value)
			{
				return;
			}
			this._firstGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _lastGap:Number = NaN;

		/**
		 * @private
		 */
		public function get lastGap():Number
		{
			return this._lastGap;
		}

		/**
		 * @private
		 */
		public function set lastGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._lastGap == value)
			{
				return;
			}
			this._lastGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _buttonFactory:Function = defaultButtonFactory;

		/**
		 * Creates each button in the group. A button must be an instance of
		 * <code>Button</code>. This factory can be used to change properties on
		 * the buttons when they are first created. For instance, if you are
		 * skinning Feathers components without a theme, you might use this
		 * factory to set skins and other styles on a button.
		 *
		 * <p>Optionally, the first button and the last button may be different
		 * than the other buttons that are in the middle. Use the
		 * <code>firstButtonFactory</code> and/or the
		 * <code>lastButtonFactory</code> to customize one or both of these
		 * buttons.</p>
		 *
		 * <p>This function is expected to have the following signature:</p>
		 *
		 * <pre>function():Button</pre>
		 *
		 * <p>The following example skins the buttons using a custom button
		 * factory:</p>
		 *
		 * <listing version="3.0">
		 * group.buttonFactory = function():Button
		 * {
		 *     var button:Button = new Button();
		 *     button.defaultSkin = new Image( texture );
		 *     return button;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.Button
		 * @see #firstButtonFactory
		 * @see #lastButtonFactory
		 */
		public function get buttonFactory():Function
		{
			return this._buttonFactory;
		}

		/**
		 * @private
		 */
		public function set buttonFactory(value:Function):void
		{
			if(this._buttonFactory == value)
			{
				return;
			}
			this._buttonFactory = value;
			this.invalidate(INVALIDATION_FLAG_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _firstButtonFactory:Function;

		/**
		 * If not <code>null</code>, creates the first button. If the
		 * <code>firstButtonFactory</code> is <code>null</code>, then the button
		 * group will use the <code>buttonFactory</code>. The first button must
		 * be an instance of <code>Button</code>. This factory can be used to
		 * change properties on the first button when it is initially created.
		 * For instance, if you are skinning Feathers components without a
		 * theme, you might use this factory to set skins and other styles on
		 * the first button.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 *
		 * <pre>function():Button</pre>
		 *
		 * <p>The following example skins the first button using a custom
		 * factory:</p>
		 *
		 * <listing version="3.0">
		 * group.firstButtonFactory = function():Button
		 * {
		 *     var button:Button = new Button();
		 *     button.defaultSkin = new Image( texture );
		 *     return button;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.Button
		 * @see #buttonFactory
		 * @see #lastButtonFactory
		 */
		public function get firstButtonFactory():Function
		{
			return this._firstButtonFactory;
		}

		/**
		 * @private
		 */
		public function set firstButtonFactory(value:Function):void
		{
			if(this._firstButtonFactory == value)
			{
				return;
			}
			this._firstButtonFactory = value;
			this.invalidate(INVALIDATION_FLAG_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _lastButtonFactory:Function;

		/**
		 * If not <code>null</code>, creates the last button. If the
		 * <code>lastButtonFactory</code> is <code>null</code>, then the button
		 * group will use the <code>buttonFactory</code>. The last button must
		 * be an instance of <code>Button</code>. This factory can be used to
		 * change properties on the last button when it is initially created.
		 * For instance, if you are skinning Feathers components without a
		 * theme, you might use this factory to set skins and other styles on
		 * the last button.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 *
		 * <pre>function():Button</pre>
		 *
		 * <p>The following example skins the last button using a custom
		 * factory:</p>
		 *
		 * <listing version="3.0">
		 * group.lastButtonFactory = function():Button
		 * {
		 *     var button:Button = new Button();
		 *     button.defaultSkin = new Image( texture );
		 *     return button;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.Button
		 * @see #buttonFactory
		 * @see #firstButtonFactory
		 */
		public function get lastButtonFactory():Function
		{
			return this._lastButtonFactory;
		}

		/**
		 * @private
		 */
		public function set lastButtonFactory(value:Function):void
		{
			if(this._lastButtonFactory == value)
			{
				return;
			}
			this._lastButtonFactory = value;
			this.invalidate(INVALIDATION_FLAG_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _buttonInitializer:Function = defaultButtonInitializer;

		/**
		 * Modifies a button, perhaps by changing its label and icons, based on the
		 * item from the data provider that the button is meant to represent. The
		 * default buttonInitializer function can set the button's label and icons if
		 * <code>label</code> and/or any of the <code>Button</code> icon fields
		 * (<code>defaultIcon</code>, <code>upIcon</code>, etc.) are present in
		 * the item. You can listen to <code>Event.TRIGGERED</code> and
		 * <code>Event.CHANGE</code> by passing in functions for each.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 *
		 * <pre>function( button:Button, item:Object ):void</pre>
		 *
		 * <p>The following example provides a custom button initializer:</p>
		 *
		 * <listing version="3.0">
		 * group.buttonInitializer = function( button:Button, item:Object ):void
		 * {
		 *     button.label = item.label;
		 * };</listing>
		 *
		 * @see #dataProvider
		 */
		public function get buttonInitializer():Function
		{
			return this._buttonInitializer;
		}

		/**
		 * @private
		 */
		public function set buttonInitializer(value:Function):void
		{
			if(this._buttonInitializer == value)
			{
				return;
			}
			this._buttonInitializer = value;
			this.invalidate(INVALIDATION_FLAG_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _buttonReleaser:Function = defaultButtonReleaser;

		/**
		 * Resets the properties of an individual button, using the item from the
		 * data provider that was associated with the button.
		 *
		 * <p>This function is expected to have one of the following signatures:</p>
		 * <pre>function( tab:Button ):void</pre>
		 * <pre>function( tab:Button, oldItem:Object ):void</pre>
		 *
		 * <p>In the following example, a custom button releaser is passed to the
		 * button group:</p>
		 *
		 * <listing version="3.0">
		 * group.buttonReleaser = function( button:Button, oldItem:Object ):void
		 * {
		 *     button.label = null;
		 * };</listing>
		 *
		 * @see #buttonInitializer
		 */
		public function get buttonReleaser():Function
		{
			return this._buttonReleaser;
		}

		/**
		 * @private
		 */
		public function set buttonReleaser(value:Function):void
		{
			if(this._buttonReleaser == value)
			{
				return;
			}
			this._buttonReleaser = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _customButtonStyleName:String;

		/**
		 * @private
		 */
		public function get customButtonStyleName():String
		{
			return this._customButtonStyleName;
		}

		/**
		 * @private
		 */
		public function set customButtonStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customButtonStyleName === value)
			{
				return;
			}
			this._customButtonStyleName = value;
			this.invalidate(INVALIDATION_FLAG_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customFirstButtonStyleName:String;

		/**
		 * @private
		 */
		public function get customFirstButtonStyleName():String
		{
			return this._customFirstButtonStyleName;
		}

		/**
		 * @private
		 */
		public function set customFirstButtonStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customFirstButtonStyleName === value)
			{
				return;
			}
			this._customFirstButtonStyleName = value;
			this.invalidate(INVALIDATION_FLAG_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customLastButtonStyleName:String;

		/**
		 * @private
		 */
		public function get customLastButtonStyleName():String
		{
			return this._customLastButtonStyleName;
		}

		/**
		 * @private
		 */
		public function set customLastButtonStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customLastButtonStyleName === value)
			{
				return;
			}
			this._customLastButtonStyleName = value;
			this.invalidate(INVALIDATION_FLAG_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _buttonProperties:PropertyProxy;

		/**
		 * An object that stores properties for all of the button group's
		 * buttons, and the properties will be passed down to every button when
		 * the button group validates. For a list of available properties,
		 * refer to <a href="Button.html"><code>feathers.controls.Button</code></a>.
		 *
		 * <p>These properties are shared by every button, so anything that cannot
		 * be shared (such as display objects, which cannot be added to multiple
		 * parents) should be passed to buttons using the
		 * <code>buttonFactory</code> or in the theme.</p>
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>The following example sets some properties on all of the buttons:</p>
		 *
		 * <listing version="3.0">
		 * group.buttonProperties.horizontalAlign = HorizontalAlign.LEFT;
		 * group.buttonProperties.verticalAlign = VerticalAlign.TOP;</listing>
		 *
		 * <p>Setting properties in a <code>buttonFactory</code> function instead
		 * of using <code>buttonProperties</code> will result in better
		 * performance.</p>
		 *
		 * @default null
		 *
		 * @see #buttonFactory
		 * @see #firstButtonFactory
		 * @see #lastButtonFactory
		 * @see feathers.controls.Button
		 */
		public function get buttonProperties():Object
		{
			if(!this._buttonProperties)
			{
				this._buttonProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._buttonProperties;
		}

		/**
		 * @private
		 */
		public function set buttonProperties(value:Object):void
		{
			if(this._buttonProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._buttonProperties)
			{
				this._buttonProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._buttonProperties = PropertyProxy(value);
			if(this._buttonProperties)
			{
				this._buttonProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @inheritDoc
		 */
		public function get baseline():Number
		{
			if(!this.activeButtons || this.activeButtons.length == 0)
			{
				return this.scaledActualHeight;
			}
			var firstButton:Button = this.activeButtons[0];
			return this.scaleY * (firstButton.y + firstButton.baseline);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.dataProvider = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var buttonFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_BUTTON_FACTORY);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);

			if(dataInvalid || stateInvalid || buttonFactoryInvalid)
			{
				this.refreshButtons(buttonFactoryInvalid);
			}

			if(dataInvalid || buttonFactoryInvalid || stylesInvalid)
			{
				this.refreshButtonStyles();
			}

			if(dataInvalid || stateInvalid || buttonFactoryInvalid)
			{
				this.commitEnabled();
			}

			if(stylesInvalid)
			{
				this.refreshLayoutStyles();
			}

			this.layoutButtons();
		}

		/**
		 * @private
		 */
		protected function commitEnabled():void
		{
			var buttonCount:int = this.activeButtons.length;
			for(var i:int = 0; i < buttonCount; i++)
			{
				var button:Button = this.activeButtons[i];
				button.isEnabled &&= this._isEnabled;
			}
		}

		/**
		 * @private
		 */
		protected function refreshButtonStyles():void
		{
			for(var propertyName:String in this._buttonProperties)
			{
				var propertyValue:Object = this._buttonProperties[propertyName];
				for each(var button:Button in this.activeButtons)
				{
					button[propertyName] = propertyValue;
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshLayoutStyles():void
		{
			if(this._direction == Direction.VERTICAL)
			{
				var verticalLayout:VerticalLayout = this.layout as VerticalLayout;
				if(!verticalLayout)
				{
					this.layout = verticalLayout = new VerticalLayout();
				}
				verticalLayout.distributeHeights = this._distributeButtonSizes;
				verticalLayout.horizontalAlign = this._horizontalAlign;
				verticalLayout.verticalAlign = (this._verticalAlign == VerticalAlign.JUSTIFY) ? VerticalAlign.TOP : this._verticalAlign;
				verticalLayout.gap = this._gap;
				verticalLayout.firstGap = this._firstGap;
				verticalLayout.lastGap = this._lastGap;
				verticalLayout.paddingTop = this._paddingTop;
				verticalLayout.paddingRight = this._paddingRight;
				verticalLayout.paddingBottom = this._paddingBottom;
				verticalLayout.paddingLeft = this._paddingLeft;
			}
			else //horizontal
			{
				if(this._distributeButtonSizes)
				{
					var horizontalLayout:HorizontalLayout = this.layout as HorizontalLayout;
					if(!horizontalLayout)
					{
						this.layout = horizontalLayout = new HorizontalLayout();
					}
					horizontalLayout.distributeWidths = true;
					horizontalLayout.horizontalAlign = (this._horizontalAlign == HorizontalAlign.JUSTIFY) ? HorizontalAlign.LEFT : this._horizontalAlign;
					horizontalLayout.verticalAlign = this._verticalAlign;
					horizontalLayout.gap = this._gap;
					horizontalLayout.firstGap = this._firstGap;
					horizontalLayout.lastGap = this._lastGap;
					horizontalLayout.paddingTop = this._paddingTop;
					horizontalLayout.paddingRight = this._paddingRight;
					horizontalLayout.paddingBottom = this._paddingBottom;
					horizontalLayout.paddingLeft = this._paddingLeft;
				}
				else
				{
					var flowLayout:FlowLayout = this.layout as FlowLayout;
					if(!flowLayout)
					{
						this.layout = flowLayout = new FlowLayout();
					}
					flowLayout.horizontalAlign = (this._horizontalAlign == HorizontalAlign.JUSTIFY) ? HorizontalAlign.LEFT : this._horizontalAlign;
					flowLayout.verticalAlign = this._verticalAlign;
					flowLayout.gap = this._gap;
					flowLayout.firstHorizontalGap = this._firstGap;
					flowLayout.lastHorizontalGap = this._lastGap;
					flowLayout.paddingTop = this._paddingTop;
					flowLayout.paddingRight = this._paddingRight;
					flowLayout.paddingBottom = this._paddingBottom;
					flowLayout.paddingLeft = this._paddingLeft;
				}
			}
			if(layout is IVirtualLayout)
			{
				IVirtualLayout(layout).useVirtualLayout = false;
			}
		}

		/**
		 * @private
		 */
		protected function defaultButtonInitializer(button:Button, item:Object):void
		{
			if(item is Object)
			{
				if(item.hasOwnProperty(LABEL_FIELD))
				{
					button.label = item.label as String;
				}
				else
				{
					button.label = item.toString();
				}
				if(item.hasOwnProperty(ENABLED_FIELD))
				{
					button.isEnabled = item.isEnabled as Boolean;
				}
				else
				{
					button.isEnabled = this._isEnabled;
				}
				for each(var field:String in DEFAULT_BUTTON_FIELDS)
				{
					if(item.hasOwnProperty(field))
					{
						button[field] = item[field];
					}
				}
				for each(field in DEFAULT_BUTTON_EVENTS)
				{
					var removeListener:Boolean = true;
					if(item.hasOwnProperty(field))
					{
						var listener:Function = item[field] as Function;
						if(listener === null)
						{
							continue;
						}
						removeListener = false;
						//we can't add the listener directly because we don't
						//know how to remove it later if the data provider
						//changes and we lose the old item. we'll use another
						//event listener that we control as a delegate, and
						//we'll be able to remove it later.
						button.addEventListener(field, defaultButtonEventsListener);
					}
					if(removeListener)
					{
						button.removeEventListener(field, defaultButtonEventsListener);
					}
				}
			}
			else
			{
				button.label = "";
				button.isEnabled = this._isEnabled;
			}
		}

		/**
		 * @private
		 */
		protected function defaultButtonReleaser(button:Button, oldItem:Object):void
		{
			button.label = null;
			for each(var field:String in DEFAULT_BUTTON_FIELDS)
			{
				if(oldItem.hasOwnProperty(field))
				{
					button[field] = null;
				}
			}
			for each(field in DEFAULT_BUTTON_EVENTS)
			{
				var removeListener:Boolean = true;
				if(oldItem.hasOwnProperty(field))
				{
					var listener:Function = oldItem[field] as Function;
					if(listener === null)
					{
						continue;
					}
					button.removeEventListener(field, defaultButtonEventsListener);
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshButtons(isFactoryInvalid:Boolean):void
		{
			var temp:Vector.<Button> = this.inactiveButtons;
			this.inactiveButtons = this.activeButtons;
			this.activeButtons = temp;
			this.activeButtons.length = 0;
			this._layoutItems.length = 0;
			temp = null;
			if(isFactoryInvalid)
			{
				this.clearInactiveButtons();
			}
			else
			{
				if(this.activeFirstButton)
				{
					this.inactiveButtons.shift();
				}
				this.inactiveFirstButton = this.activeFirstButton;

				if(this.activeLastButton)
				{
					this.inactiveButtons.pop();
				}
				this.inactiveLastButton = this.activeLastButton;
			}
			this.activeFirstButton = null;
			this.activeLastButton = null;

			var pushIndex:int = 0;
			var itemCount:int = this._dataProvider ? this._dataProvider.length : 0;
			var lastItemIndex:int = itemCount - 1;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = this._dataProvider.getItemAt(i);
				if(i == 0)
				{
					var button:Button = this.activeFirstButton = this.createFirstButton(item);
				}
				else if(i == lastItemIndex)
				{
					button = this.activeLastButton = this.createLastButton(item);
				}
				else
				{
					button = this.createButton(item);
				}
				this.activeButtons[pushIndex] = button;
				this._layoutItems[pushIndex] = button;
				pushIndex++;
			}
			this.clearInactiveButtons();
		}

		/**
		 * @private
		 */
		protected function clearInactiveButtons():void
		{
			var itemCount:int = this.inactiveButtons.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var button:Button = this.inactiveButtons.shift();
				this.destroyButton(button);
			}

			if(this.inactiveFirstButton)
			{
				this.destroyButton(this.inactiveFirstButton);
				this.inactiveFirstButton = null;
			}

			if(this.inactiveLastButton)
			{
				this.destroyButton(this.inactiveLastButton);
				this.inactiveLastButton = null;
			}
		}

		/**
		 * @private
		 */
		protected function createFirstButton(item:Object):Button
		{
			var isNewInstance:Boolean = false;
			if(this.inactiveFirstButton !== null)
			{
				var button:Button = this.inactiveFirstButton;
				this.releaseButton(button);
				this.inactiveFirstButton = null;
			}
			else
			{
				isNewInstance = true;
				var factory:Function = this._firstButtonFactory != null ? this._firstButtonFactory : this._buttonFactory;
				button = Button(factory());
				if(this._customFirstButtonStyleName)
				{
					button.styleNameList.add(this._customFirstButtonStyleName);
				}
				else if(this._customButtonStyleName)
				{
					button.styleNameList.add(this._customButtonStyleName);
				}
				else
				{
					button.styleNameList.add(this.firstButtonStyleName);
				}
				this.addChild(button);
			}
			this._buttonInitializer(button, item);
			this._buttonToItem[button] = item;
			if(isNewInstance)
			{
				//we need to listen for Event.TRIGGERED after the initializer
				//is called to avoid runtime errors because the button may be
				//disposed by the time listeners in the initializer are called.
				button.addEventListener(Event.TRIGGERED, button_triggeredHandler);
			}
			return button;
		}

		/**
		 * @private
		 */
		protected function createLastButton(item:Object):Button
		{
			var isNewInstance:Boolean = false;
			if(this.inactiveLastButton !== null)
			{
				var button:Button = this.inactiveLastButton;
				this.releaseButton(button);
				this.inactiveLastButton = null;
			}
			else
			{
				isNewInstance = true;
				var factory:Function = this._lastButtonFactory != null ? this._lastButtonFactory : this._buttonFactory;
				button = Button(factory());
				if(this._customLastButtonStyleName)
				{
					button.styleNameList.add(this._customLastButtonStyleName);
				}
				else if(this._customButtonStyleName)
				{
					button.styleNameList.add(this._customButtonStyleName);
				}
				else
				{
					button.styleNameList.add(this.lastButtonStyleName);
				}
				this.addChild(button);
			}
			this._buttonInitializer(button, item);
			this._buttonToItem[button] = item;
			if(isNewInstance)
			{
				//we need to listen for Event.TRIGGERED after the initializer
				//is called to avoid runtime errors because the button may be
				//disposed by the time listeners in the initializer are called.
				button.addEventListener(Event.TRIGGERED, button_triggeredHandler);
			}
			return button;
		}

		/**
		 * @private
		 */
		protected function createButton(item:Object):Button
		{
			var isNewInstance:Boolean = false;
			if(this.inactiveButtons.length == 0)
			{
				isNewInstance = true;
				var button:Button = this._buttonFactory();
				if(this._customButtonStyleName)
				{
					button.styleNameList.add(this._customButtonStyleName);
				}
				else
				{
					button.styleNameList.add(this.buttonStyleName);
				}
				this.addChild(button);
			}
			else
			{
				button = this.inactiveButtons.shift();
				this.releaseButton(button);
			}
			this._buttonInitializer(button, item);
			this._buttonToItem[button] = item;
			if(isNewInstance)
			{
				//we need to listen for Event.TRIGGERED after the initializer
				//is called to avoid runtime errors because the button may be
				//disposed by the time listeners in the initializer are called.
				button.addEventListener(Event.TRIGGERED, button_triggeredHandler);
			}
			return button;
		}

		/**
		 * @private
		 */
		protected function releaseButton(button:Button):void
		{
			var item:Object = this._buttonToItem[button];
			delete this._buttonToItem[button];
			if(this._buttonReleaser.length == 1)
			{
				this._buttonReleaser(button);
			}
			else
			{
				this._buttonReleaser(button, item);
			}
		}

		/**
		 * @private
		 */
		protected function destroyButton(button:Button):void
		{
			button.removeEventListener(Event.TRIGGERED, button_triggeredHandler);
			this.releaseButton(button);
			this.removeChild(button, true);
		}

		/**
		 * @private
		 */
		protected function layoutButtons():void
		{
			this._viewPortBounds.x = 0;
			this._viewPortBounds.y = 0;
			this._viewPortBounds.scrollX = 0;
			this._viewPortBounds.scrollY = 0;
			this._viewPortBounds.explicitWidth = this._explicitWidth;
			this._viewPortBounds.explicitHeight = this._explicitHeight;
			this._viewPortBounds.minWidth = this._explicitMinWidth;
			this._viewPortBounds.minHeight = this._explicitMinHeight;
			this._viewPortBounds.maxWidth = this._explicitMaxWidth;
			this._viewPortBounds.maxHeight = this._explicitMaxHeight;
			this.layout.layout(this._layoutItems, this._viewPortBounds, this._layoutResult);

			var contentWidth:Number = this._layoutResult.contentWidth;
			var contentHeight:Number = this._layoutResult.contentHeight;
			//minimum dimensions are the same as the measured dimensions
			this.saveMeasurements(contentWidth, contentHeight, contentWidth, contentHeight);

			//final validation to avoid juggler next frame issues
			for each(var button:Button in this.activeButtons)
			{
				button.validate();
			}
		}

		/**
		 * @private
		 */
		protected function childProperties_onChange(proxy:PropertyProxy, name:String):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function dataProvider_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function dataProvider_updateAllHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function dataProvider_updateItemHandler(event:Event, index:int):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function button_triggeredHandler(event:Event):void
		{
			//if this was called after dispose, ignore it
			if(!this._dataProvider || !this.activeButtons)
			{
				return;
			}
			var button:Button = Button(event.currentTarget);
			var index:int = this.activeButtons.indexOf(button);
			var item:Object = this._dataProvider.getItemAt(index);
			this.dispatchEventWith(Event.TRIGGERED, false, item);
		}

		/**
		 * @private
		 */
		protected function defaultButtonEventsListener(event:Event):void
		{
			var button:Button = Button(event.currentTarget);
			var index:int = this.activeButtons.indexOf(button);
			var item:Object = this._dataProvider.getItemAt(index);
			var field:String = event.type;
			if(item.hasOwnProperty(field))
			{
				var listener:Function = item[field] as Function;
				if(listener == null)
				{
					return;
				}
				var argCount:int = listener.length;
				switch(argCount)
				{
					case 3:
					{
						listener(event, event.data, item);
						break;
					}
					case 2:
					{
						listener(event, event.data);
						break;
					}
					case 1:
					{
						listener(event);
						break;
					}
					default:
					{
						listener();
					}
				}
			}
		}
	}
}


================================================
FILE: source/feathers/controls/ButtonState.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * States for button components.
	 *
	 * @see feathers.controls.BasicButton
	 * @see feathers.controls.Button
	 * @see feathers.controls.ToggleButton
	 * @see feathers.controls.Check
	 * @see feathers.controls.Radio
	 * @see feathers.controls.renderers.DefaultListItemRenderer
	 * @see feathers.controls.renderers.DefaultGroupedListItemRenderer
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class ButtonState
	{
		/**
		 * The default, up state.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const UP:String = "up";

		/**
		 * The down state, when a touch begins on the component.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const DOWN:String = "down";

		/**
		 * The hover state, when the mouse is over the component. This state is
		 * not used on a touchscreen.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const HOVER:String = "hover";

		/**
		 * The disabled state, when the component's <code>isEnabled</code>
		 * property is <code>false</code>.
		 *
		 * @see feathers.core.FeathersControl#isEnabled
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const DISABLED:String = "disabled";

		/**
		 * Same as the up state, but the component is also selected.
		 *
		 * @see feathers.controls.ToggleButton#isSelected
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const UP_AND_SELECTED:String = "upAndSelected";

		/**
		 * Same as the down state, but the component is also selected.
		 *
		 * @see feathers.controls.ToggleButton#isSelected
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const DOWN_AND_SELECTED:String = "downAndSelected";

		/**
		 * Same as the hover state, but the component is also selected.
		 *
		 * @see feathers.controls.ToggleButton#isSelected
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const HOVER_AND_SELECTED:String = "hoverAndSelected";

		/**
		 * Same as the disabled state, but the component is also selected.
		 *
		 * @see feathers.controls.ToggleButton#isSelected
		 * @see feathers.core.FeathersControl#isEnabled
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const DISABLED_AND_SELECTED:String = "disabledAndSelected";

		/**
		 * Same as the focused state, but the component is also selected.
		 *
		 * @see feathers.controls.ToggleButton#isSelected
		 * @see feathers.core.FocusManager
		 *
		 * @productversion Feathers 3.4.0
		 */
		public static const FOCUSED_AND_SELECTED:String = "focusedAndSelected";
	}
}


================================================
FILE: source/feathers/controls/Callout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IValidating;
	import feathers.core.PopUpManager;
	import feathers.events.FeathersEventType;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.RelativePosition;
	import feathers.layout.VerticalAlign;
	import feathers.skins.IStyleProvider;
	import feathers.utils.display.getDisplayObjectDepthFromStage;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;

	import flash.events.KeyboardEvent;
	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.ui.Keyboard;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Stage;
	import starling.events.EnterFrameEvent;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * The position of the callout's arrow relative to the callout's
	 * background. If the callout's <code>origin</code> is set, this value
	 * will be managed by the callout and may change automatically if the
	 * origin moves to a new position or if the stage resizes.
	 *
	 * <p>The <code>supportedPositions</code> property is related to this
	 * one, but they have different meanings and are usually opposites. For
	 * example, a callout on the right side of its origin will generally
	 * display its left arrow.</p>
	 *
	 * <p>If you use <code>Callout.show()</code> or set the <code>origin</code>
	 * property manually, you should avoid manually modifying the
	 * <code>arrowPosition</code> and <code>arrowOffset</code> properties.</p>
	 *
	 * <p>In the following example, the callout's arrow is positioned on the
	 * left side:</p>
	 *
	 * <listing version="3.0">
	 * callout.arrowPosition = RelativePosition.LEFT;</listing>
	 *
	 * @default feathers.layout.RelativePosition.TOP
	 *
	 * @see feathers.layout.RelativePosition#TOP
	 * @see feathers.layout.RelativePosition#RIGHT
	 * @see feathers.layout.RelativePosition#BOTTOM
	 * @see feathers.layout.RelativePosition#LEFT
	 *
	 * @see #origin
	 * @see #supportedPositions
	 * @see #style:arrowOffset
	 */
	[Style(name="arrowPosition",type="String")]

	/**
	 * The primary background to display behind the callout's content.
	 *
	 * <p>In the following example, the callout's background is set to an image:</p>
	 *
	 * <listing version="3.0">
	 * callout.backgroundSkin = new Image( texture );</listing>
	 *
	 * @default null
	 */
	[Style(name="backgroundSkin",type="starling.display.DisplayObject")]

	/**
	 * The space, in pixels, between the bottom arrow skin and the
	 * background skin. To have the arrow overlap the background, you may
	 * use a negative gap value.
	 *
	 * <p>In the following example, the gap between the callout and its
	 * bottom arrow is set to -4 pixels (perhaps to hide a border on the
	 * callout's background):</p>
	 *
	 * <listing version="3.0">
	 * callout.bottomArrowGap = -4;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:bottomArrowSkin
	 */
	[Style(name="bottomArrowGap",type="Number")]

	/**
	 * The arrow skin to display on the bottom edge of the callout. This
	 * arrow is displayed when the callout is displayed above the region it
	 * points at.
	 *
	 * <p>In the following example, the callout's bottom arrow skin is set
	 * to an image:</p>
	 *
	 * <listing version="3.0">
	 * callout.bottomArrowSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:bottomArrowGap
	 */
	[Style(name="bottomArrowSkin",type="starling.display.DisplayObject")]

	/**
	 * The horizontal alignment of the callout, relative to the origin.
	 *
	 * <p><strong>Note:</strong> The <code>HorizontalAlign.JUSTIFY</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.HorizontalAlign.CENTER
	 *
	 * @see feathers.layout.HorizontalAlign#LEFT
	 * @see feathers.layout.HorizontalAlign#CENTER
	 * @see feathers.layout.HorizontalAlign#RIGHT
	 */
	[Style(name="horizontalAlign",type="String")]

	/**
	 * The space, in pixels, between the right arrow skin and the background
	 * skin. To have the arrow overlap the background, you may use a
	 * negative gap value.
	 *
	 * <p>In the following example, the gap between the callout and its
	 * left arrow is set to -4 pixels (perhaps to hide a border on the
	 * callout's background):</p>
	 *
	 * <listing version="3.0">
	 * callout.leftArrowGap = -4;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:leftArrowSkin
	 */
	[Style(name="leftArrowGap",type="Number")]

	/**
	 * The arrow skin to display on the left edge of the callout. This arrow
	 * is displayed when the callout is displayed to the right of the region
	 * it points at.
	 *
	 * <p>In the following example, the callout's left arrow skin is set
	 * to an image:</p>
	 *
	 * <listing version="3.0">
	 * callout.leftArrowSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:leftArrowGap
	 */
	[Style(name="leftArrowSkin",type="starling.display.DisplayObject")]

	/**
	 * The space, in pixels, between the callout and the origin.
	 *
	 * <p>In the following example, the gap between the callout and its
	 * origin is set to 10 pixels:</p>
	 *
	 * <listing version="3.0">
	 * callout.originGap = 10;</listing>
	 *
	 * @default 0
	 *
	 * @see #origin
	 */
	[Style(name="originGap",type="Number")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the padding of all sides of the callout
	 * is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * callout.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, between the callout's top edge and the
	 * callout's content.
	 *
	 * <p>In the following example, the padding on the top edge of the
	 * callout is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * callout.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the callout's right edge and
	 * the callout's content.
	 *
	 * <p>In the following example, the padding on the right edge of the
	 * callout is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * callout.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the callout's bottom edge and
	 * the callout's content.
	 *
	 * <p>In the following example, the padding on the bottom edge of the
	 * callout is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * callout.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the callout's left edge and the
	 * callout's content.
	 *
	 * <p>In the following example, the padding on the left edge of the
	 * callout is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * callout.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * The space, in pixels, between the right arrow skin and the background
	 * skin. To have the arrow overlap the background, you may use a
	 * negative gap value.
	 *
	 * <p>In the following example, the gap between the callout and its
	 * right arrow is set to -4 pixels (perhaps to hide a border on the
	 * callout's background):</p>
	 *
	 * <listing version="3.0">
	 * callout.rightArrowGap = -4;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:rightArrowSkin
	 */
	[Style(name="rightArrowGap",type="Number")]

	/**
	 * The arrow skin to display on the right edge of the callout. This
	 * arrow is displayed when the callout is displayed to the left of the
	 * region it points at.
	 *
	 * <p>In the following example, the callout's right arrow skin is set
	 * to an image:</p>
	 *
	 * <listing version="3.0">
	 * callout.rightArrowSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:rightArrowGap
	 */
	[Style(name="rightArrowSkin",type="starling.display.DisplayObject")]

	/**
	 * The space, in pixels, between the top arrow skin and the background
	 * skin. To have the arrow overlap the background, you may use a
	 * negative gap value.
	 *
	 * <p>In the following example, the gap between the callout and its
	 * top arrow is set to -4 pixels (perhaps to hide a border on the
	 * callout's background):</p>
	 *
	 * <listing version="3.0">
	 * callout.topArrowGap = -4;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:topArrowSkin
	 */
	[Style(name="topArrowGap",type="Number")]

	/**
	 * The arrow skin to display on the top edge of the callout. This arrow
	 * is displayed when the callout is displayed below the region it points
	 * at.
	 *
	 * <p>In the following example, the callout's top arrow skin is set
	 * to an image:</p>
	 *
	 * <listing version="3.0">
	 * callout.topArrowSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:topArrowGap
	 */
	[Style(name="topArrowSkin",type="starling.display.DisplayObject")]

	/**
	 * The vertical alignment of the callout, relative to the origin.
	 *
	 * <p><strong>Note:</strong> The <code>VerticalAlign.JUSTIFY</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.VerticalAlign.MIDDLE
	 *
	 * @see feathers.layout.VerticalAlign#TOP
	 * @see feathers.layout.VerticalAlign#MIDDLE
	 * @see feathers.layout.VerticalAlign#BOTTOM
	 */
	[Style(name="verticalAlign",type="String")]

	/**
	 * The offset, in pixels, of the arrow skin from the horizontal center
	 * or vertical middle of the background skin, depending on the position
	 * of the arrow (which side it is on). This value is used to point at
	 * the callout's origin when the callout is not perfectly centered
	 * relative to the origin.
	 *
	 * <p>On the top and bottom edges, the arrow will move left for negative
	 * values of <code>arrowOffset</code> and right for positive values. On
	 * the left and right edges, the arrow will move up for negative values
	 * and down for positive values.</p>
	 *
	 * <p>If you use <code>Callout.show()</code> or set the <code>origin</code>
	 * property manually, you should avoid manually modifying the
	 * <code>arrowPosition</code> and <code>arrowOffset</code> properties.</p>
	 *
	 * <p>In the following example, the arrow offset is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * callout.arrowOffset = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:arrowPosition
	 * @see #origin
	 */
	[Style(name="arrowOffset",type="Number")]

	/**
	 * Dispatched when the callout is closed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CLOSE
	 */
	[Event(name="close",type="starling.events.Event")]

	/**
	 * A pop-up container that points at (or calls out) a specific region of
	 * the application (typically a specific control that triggered it).
	 *
	 * <p>In general, a <code>Callout</code> isn't instantiated directly.
	 * Instead, you will typically call the static function
	 * <code>Callout.show()</code>. This is not required, but it result in less
	 * code and no need to manually manage calls to the <code>PopUpManager</code>.</p>
	 *
	 * <p>In the following example, a callout displaying a <code>Label</code> is
	 * shown when a <code>Button</code> is triggered:</p>
	 *
	 * <listing version="3.0">
	 * button.addEventListener( Event.TRIGGERED, button_triggeredHandler );
	 * 
	 * function button_triggeredHandler( event:Event ):void
	 * {
	 *     var label:Label = new Label();
	 *     label.text = "Hello World!";
	 *     var button:Button = Button( event.currentTarget );
	 *     Callout.show( label, button );
	 * }</listing>
	 *
	 * @see ../../../help/callout.html How to use the Feathers Callout component
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class Callout extends FeathersControl
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>Callout</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * The default positions used by a callout.
		 */
		public static const DEFAULT_POSITIONS:Vector.<String> = new <String>
		[
			RelativePosition.BOTTOM,
			RelativePosition.TOP,
			RelativePosition.RIGHT,
			RelativePosition.LEFT,
		];

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_ORIGIN:String = "origin";

		/**
		 * @private
		 */
		protected static const FUZZY_CONTENT_DIMENSIONS_PADDING:Number = 0.000001;

		/**
		 * Quickly sets all stage padding properties to the same value. The
		 * <code>stagePadding</code> getter always returns the value of
		 * <code>stagePaddingTop</code>, but the other padding values may be
		 * different.
		 *
		 * <p>The following example gives the stage 20 pixels of padding on all
		 * sides:</p>
		 *
		 * <listing version="3.0">
		 * Callout.stagePadding = 20;</listing>
		 *
		 * @default 0
		 *
		 * @see #stagePaddingTop
		 * @see #stagePaddingRight
		 * @see #stagePaddingBottom
		 * @see #stagePaddingLeft
		 */
		public static function get stagePadding():Number
		{
			return Callout.stagePaddingTop;
		}

		/**
		 * @private
		 */
		public static function set stagePadding(value:Number):void
		{
			Callout.stagePaddingTop = value;
			Callout.stagePaddingRight = value;
			Callout.stagePaddingBottom = value;
			Callout.stagePaddingLeft = value;
		}

		/**
		 * The padding between a callout and the top edge of the stage when the
		 * callout is positioned automatically. May be ignored if the callout
		 * is too big for the stage.
		 *
		 * <p>In the following example, the top stage padding will be set to
		 * 20 pixels:</p>
		 *
		 * <listing version="3.0">
		 * Callout.stagePaddingTop = 20;</listing>
		 */
		public static var stagePaddingTop:Number = 0;

		/**
		 * The padding between a callout and the right edge of the stage when the
		 * callout is positioned automatically. May be ignored if the callout
		 * is too big for the stage.
		 *
		 * <p>In the following example, the right stage padding will be set to
		 * 20 pixels:</p>
		 *
		 * <listing version="3.0">
		 * Callout.stagePaddingRight = 20;</listing>
		 */
		public static var stagePaddingRight:Number = 0;

		/**
		 * The padding between a callout and the bottom edge of the stage when the
		 * callout is positioned automatically. May be ignored if the callout
		 * is too big for the stage.
		 *
		 * <p>In the following example, the bottom stage padding will be set to
		 * 20 pixels:</p>
		 *
		 * <listing version="3.0">
		 * Callout.stagePaddingBottom = 20;</listing>
		 */
		public static var stagePaddingBottom:Number = 0;

		/**
		 * The margin between a callout and the top edge of the stage when the
		 * callout is positioned automatically. May be ignored if the callout
		 * is too big for the stage.
		 *
		 * <p>In the following example, the left stage padding will be set to
		 * 20 pixels:</p>
		 *
		 * <listing version="3.0">
		 * Callout.stagePaddingLeft = 20;</listing>
		 */
		public static var stagePaddingLeft:Number = 0;

		/**
		 * Returns a new <code>Callout</code> instance when
		 * <code>Callout.show()</code> is called. If one wishes to skin the
		 * callout manually or change its behavior, a custom factory may be
		 * provided.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 *
		 * <pre>function():Callout</pre>
		 *
		 * <p>The following example shows how to create a custom callout factory:</p>
		 *
		 * <listing version="3.0">
		 * Callout.calloutFactory = function():Callout
		 * {
		 *     var callout:Callout = new Callout();
		 *     //set properties here!
		 *     return callout;
		 * };</listing>
		 *
		 * <p>Note: the default callout factory sets the following properties:</p>
		 *
		 * <listing version="3.0">
		 * callout.closeOnTouchBeganOutside = true;
		 * callout.closeOnTouchEndedOutside = true;
		 * callout.closeOnKeys = new &lt;uint&gt;[Keyboard.BACK, Keyboard.ESCAPE];</listing>
		 *
		 * @see #show()
		 */
		public static var calloutFactory:Function = defaultCalloutFactory;

		/**
		 * Returns an overlay to display with a callout that is modal. Uses the
		 * standard <code>overlayFactory</code> of the <code>PopUpManager</code>
		 * by default, but you can use this property to provide your own custom
		 * overlay, if you prefer.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 * <pre>function():DisplayObject</pre>
		 *
		 * <p>The following example uses a semi-transparent <code>Quad</code> as
		 * a custom overlay:</p>
		 *
		 * <listing version="3.0">
		 * Callout.calloutOverlayFactory = function():Quad
		 * {
		 *     var quad:Quad = new Quad(10, 10, 0x000000);
		 *     quad.alpha = 0.75;
		 *     return quad;
		 * };</listing>
		 *
		 * @see feathers.core.PopUpManager#overlayFactory
		 *
		 * @see #show()
		 */
		public static var calloutOverlayFactory:Function = PopUpManager.defaultOverlayFactory;

		/**
		 * Creates a callout, and then positions and sizes it automatically
		 * based on an origin rectangle and the specified direction relative to
		 * the original. The provided width and height values are optional, and
		 * these values may be ignored if the callout cannot be drawn at the
		 * specified dimensions.
		 *
		 * <p>The <code>supportedPositions</code> parameter should be a
		 * <code>Vector.&lt;String&gt;</code> of values from the
		 * <code>feathers.layout.RelativePosition</code> class. The positions
		 * should be ordered by preference. This parameter is typed as
		 * <code>Object</code> to allow some deprecated <code>String</code>
		 * values. In a future version of Feathers, the type will change to
		 * <code>Vector.&lt;String&gt;</code> instead.</p>
		 *
		 * <p>In the following example, a callout displaying a <code>Label</code> is
		 * shown when a <code>Button</code> is triggered:</p>
		 *
		 * <listing version="3.0">
		 * button.addEventListener( Event.TRIGGERED, button_triggeredHandler );
		 * 
		 * function button_triggeredHandler( event:Event ):void
		 * {
		 *     var label:Label = new Label();
		 *     label.text = "Hello World!";
		 *     var button:Button = Button( event.currentTarget );
		 *     Callout.show( label, button );
		 * }</listing>
		 */
		public static function show(content:DisplayObject, origin:DisplayObject,
			supportedPositions:Vector.<String> = null, isModal:Boolean = true, customCalloutFactory:Function = null,
			customOverlayFactory:Function = null):Callout
		{
			if(origin.stage === null)
			{
				throw new ArgumentError("Callout origin must be added to the stage.");
			}
			var factory:Function = customCalloutFactory;
			if(factory === null)
			{
				factory = calloutFactory;
				if(factory === null)
				{
					factory = defaultCalloutFactory;
				}
			}
			var callout:Callout = Callout(factory());
			callout.content = content;
			callout.supportedPositions = supportedPositions;
			callout.origin = origin;
			factory = customOverlayFactory;
			if(factory === null)
			{
				factory = calloutOverlayFactory;
				if(factory === null)
				{
					factory = PopUpManager.defaultOverlayFactory;
				}
			}
			PopUpManager.addPopUp(callout, isModal, false, factory);
			return callout;
		}

		/**
		 * The default factory that creates callouts when <code>Callout.show()</code>
		 * is called. To use a different factory, you need to set
		 * <code>Callout.calloutFactory</code> to a <code>Function</code>
		 * instance.
		 */
		public static function defaultCalloutFactory():Callout
		{
			var callout:Callout = new Callout();
			callout.closeOnTouchBeganOutside = true;
			callout.closeOnTouchEndedOutside = true;
			callout.closeOnKeys = new <uint>[Keyboard.BACK, Keyboard.ESCAPE];
			return callout;
		}

		/**
		 * @private
		 */
		protected static function positionBelowOrigin(callout:Callout, globalOrigin:Rectangle):void
		{
			callout.measureWithArrowPosition(RelativePosition.TOP);
			var idealXPosition:Number = globalOrigin.x;
			if(callout._horizontalAlign === HorizontalAlign.CENTER)
			{
				idealXPosition += Math.round((globalOrigin.width - callout.width) / 2);
			}
			else if(callout._horizontalAlign === HorizontalAlign.RIGHT)
			{
				idealXPosition += (globalOrigin.width - callout.width);
			}
			var xPosition:Number = idealXPosition;
			if(stagePaddingLeft > xPosition)
			{
				xPosition = stagePaddingLeft;
			}
			else
			{
				var stage:Stage = callout.stage !== null ? callout.stage : Starling.current.stage;
				var maxXPosition:Number = stage.stageWidth - callout.width - stagePaddingRight;
				if(maxXPosition < xPosition)
				{
					xPosition = maxXPosition;
				}
			}
			var point:Point = Pool.getPoint(xPosition, globalOrigin.y + globalOrigin.height);
			//we calculate the position in global coordinates, but the callout
			//may be in a container that is offset from the global origin, so
			//adjust for that difference.
			callout.parent.globalToLocal(point, point);
			callout.x = point.x;
			callout.y = point.y + callout._originGap;
			Pool.putPoint(point);
			if(callout._isValidating)
			{
				//no need to invalidate and need to validate again next frame
				callout._arrowOffset = idealXPosition - xPosition;
				callout._arrowPosition = RelativePosition.TOP;
			}
			else
			{
				callout.arrowOffset = idealXPosition - xPosition;
				callout.arrowPosition = RelativePosition.TOP;
			}
		}

		/**
		 * @private
		 */
		protected static function positionAboveOrigin(callout:Callout, globalOrigin:Rectangle):void
		{
			callout.measureWithArrowPosition(RelativePosition.BOTTOM);
			var idealXPosition:Number = globalOrigin.x;
			if(callout._horizontalAlign === HorizontalAlign.CENTER)
			{
				idealXPosition += Math.round((globalOrigin.width - callout.width) / 2);
			}
			else if(callout._horizontalAlign === HorizontalAlign.RIGHT)
			{
				idealXPosition += (globalOrigin.width - callout.width);
			}
			var xPosition:Number = idealXPosition;
			if(stagePaddingLeft > xPosition)
			{
				xPosition = stagePaddingLeft;
			}
			else
			{
				var stage:Stage = callout.stage !== null ? callout.stage : Starling.current.stage;
				var maxXPosition:Number = stage.stageWidth - callout.width - stagePaddingRight;
				if(maxXPosition < xPosition)
				{
					xPosition = maxXPosition;
				}
			}
			var point:Point = Pool.getPoint(xPosition, globalOrigin.y - callout.height);
			//we calculate the position in global coordinates, but the callout
			//may be in a container that is offset from the global origin, so
			//adjust for that difference.
			callout.parent.globalToLocal(point, point);
			callout.x = point.x;
			callout.y = point.y - callout._originGap;
			Pool.putPoint(point);
			if(callout._isValidating)
			{
				//no need to invalidate and need to validate again next frame
				callout._arrowOffset = idealXPosition - xPosition;
				callout._arrowPosition = RelativePosition.BOTTOM;
			}
			else
			{
				callout.arrowOffset = idealXPosition - xPosition;
				callout.arrowPosition = RelativePosition.BOTTOM;
			}
		}

		/**
		 * @private
		 */
		protected static function positionToRightOfOrigin(callout:Callout, globalOrigin:Rectangle):void
		{
			callout.measureWithArrowPosition(RelativePosition.LEFT);
			var idealYPosition:Number = globalOrigin.y;
			if(callout._verticalAlign === VerticalAlign.MIDDLE)
			{
				idealYPosition += Math.round((globalOrigin.height - callout.height) / 2);
			}
			else if(callout._verticalAlign === VerticalAlign.BOTTOM)
			{
				idealYPosition += (globalOrigin.height - callout.height);
			}
			var yPosition:Number = idealYPosition;
			if(stagePaddingTop > yPosition)
			{
				yPosition = stagePaddingTop;
			}
			else
			{
				var stage:Stage = callout.stage !== null ? callout.stage : Starling.current.stage;
				var maxYPosition:Number = stage.stageHeight - callout.height - stagePaddingBottom;
				if(maxYPosition < yPosition)
				{
					yPosition = maxYPosition;
				}
			}
			var point:Point = Pool.getPoint(globalOrigin.x + globalOrigin.width, yPosition);
			//we calculate the position in global coordinates, but the callout
			//may be in a container that is offset from the global origin, so
			//adjust for that difference.
			callout.parent.globalToLocal(point, point);
			callout.x = point.x + callout._originGap;
			callout.y = point.y;
			Pool.putPoint(point);
			if(callout._isValidating)
			{
				//no need to invalidate and need to validate again next frame
				callout._arrowOffset = idealYPosition - yPosition;
				callout._arrowPosition = RelativePosition.LEFT;
			}
			else
			{
				callout.arrowOffset = idealYPosition - yPosition;
				callout.arrowPosition = RelativePosition.LEFT;
			}
		}

		/**
		 * @private
		 */
		protected static function positionToLeftOfOrigin(callout:Callout, globalOrigin:Rectangle):void
		{
			callout.measureWithArrowPosition(RelativePosition.RIGHT);
			var idealYPosition:Number = globalOrigin.y;
			if(callout._verticalAlign === VerticalAlign.MIDDLE)
			{
				idealYPosition += Math.round((globalOrigin.height - callout.height) / 2);
			}
			else if(callout._verticalAlign === VerticalAlign.BOTTOM)
			{
				idealYPosition += (globalOrigin.height - callout.height);
			}
			var yPosition:Number = idealYPosition;
			if(stagePaddingTop > yPosition)
			{
				yPosition = stagePaddingTop;
			}
			else
			{
				var stage:Stage = callout.stage !== null ? callout.stage : Starling.current.stage;
				var maxYPosition:Number = stage.stageHeight - callout.height - stagePaddingBottom;
				if(maxYPosition < yPosition)
				{
					yPosition = maxYPosition;
				}
			}
			var point:Point = Pool.getPoint(globalOrigin.x - callout.width, yPosition);
			//we calculate the position in global coordinates, but the callout
			//may be in a container that is offset from the global origin, so
			//adjust for that difference.
			callout.parent.globalToLocal(point, point);
			callout.x = point.x - callout._originGap;
			callout.y = point.y;
			Pool.putPoint(point);
			if(callout._isValidating)
			{
				//no need to invalidate and need to validate again next frame
				callout._arrowOffset = idealYPosition - yPosition;
				callout._arrowPosition = RelativePosition.RIGHT;
			}
			else
			{
				callout.arrowOffset = idealYPosition - yPosition;
				callout.arrowPosition = RelativePosition.RIGHT;
			}
		}

		/**
		 * Constructor.
		 */
		public function Callout()
		{
			super();
			this.addEventListener(Event.ADDED_TO_STAGE, callout_addedToStageHandler);
		}

		/**
		 * Determines if the callout is automatically closed if a touch in the
		 * <code>TouchPhase.BEGAN</code> phase happens outside of the callout's
		 * or the origin's bounds.
		 *
		 * <p>In the following example, the callout will not close when a touch
		 * event with <code>TouchPhase.BEGAN</code> is detected outside the
		 * callout's (or its origin's) bounds:</p>
		 *
		 * <listing version="3.0">
		 * callout.closeOnTouchBeganOutside = false;</listing>
		 *
		 * @see #closeOnTouchEndedOutside
		 * @see #closeOnKeys
		 */
		public var closeOnTouchBeganOutside:Boolean = false;

		/**
		 * Determines if the callout is automatically closed if a touch in the
		 * <code>TouchPhase.ENDED</code> phase happens outside of the callout's
		 * or the origin's bounds.
		 *
		 * <p>In the following example, the callout will not close when a touch
		 * event with <code>TouchPhase.ENDED</code> is detected outside the
		 * callout's (or its origin's) bounds:</p>
		 *
		 * <listing version="3.0">
		 * callout.closeOnTouchEndedOutside = false;</listing>
		 *
		 * @see #closeOnTouchBeganOutside
		 * @see #closeOnKeys
		 */
		public var closeOnTouchEndedOutside:Boolean = false;

		/**
		 * The callout will be closed if any of these keys are pressed.
		 *
		 * <p>In the following example, the callout close when the Escape key
		 * is pressed:</p>
		 *
		 * <listing version="3.0">
		 * callout.closeOnKeys = new &lt;uint&gt;[Keyboard.ESCAPE];</listing>
		 *
		 * @see #closeOnTouchBeganOutside
		 * @see #closeOnTouchEndedOutside
		 */
		public var closeOnKeys:Vector.<uint>;

		/**
		 * Determines if the callout will be disposed when <code>close()</code>
		 * is called internally. Close may be called internally in a variety of
		 * cases, depending on values such as <code>closeOnTouchBeganOutside</code>,
		 * <code>closeOnTouchEndedOutside</code>, and <code>closeOnKeys</code>.
		 * If set to <code>false</code>, you may reuse the callout later by
		 * giving it a new <code>origin</code> and adding it to the
		 * <code>PopUpManager</code> again.
		 *
		 * <p>In the following example, the callout will not be disposed when it
		 * closes itself:</p>
		 *
		 * <listing version="3.0">
		 * callout.disposeOnSelfClose = false;</listing>
		 *
		 * @see #closeOnTouchBeganOutside
		 * @see #closeOnTouchEndedOutside
		 * @see #closeOnKeys
		 * @see #close()
		 */
		public var disposeOnSelfClose:Boolean = true;

		/**
		 * Determines if the callout's content will be disposed when the callout
		 * is disposed. If set to <code>false</code>, the callout's content may
		 * be added to the display list again later.
		 *
		 * <p>In the following example, the callout's content will not be
		 * disposed when the callout is disposed:</p>
		 *
		 * <listing version="3.0">
		 * callout.disposeContent = false;</listing>
		 */
		public var disposeContent:Boolean = true;

		/**
		 * @private
		 */
		protected var _isReadyToClose:Boolean = false;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return Callout.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _explicitContentWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitContentHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitContentMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitContentMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitContentMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitContentMaxHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundSkinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundSkinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundSkinMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundSkinMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundSkinMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundSkinMaxHeight:Number;

		/**
		 * @private
		 */
		protected var _content:DisplayObject;

		/**
		 * The display object that will be presented by the callout. This object
		 * may be resized to fit the callout's bounds. If the content needs to
		 * be scrolled if placed into a smaller region than its ideal size, it
		 * must provide its own scrolling capabilities because the callout does
		 * not offer scrolling.
		 *
		 * <p>In the following example, the callout's content is an image:</p>
		 *
		 * <listing version="3.0">
		 * callout.content = new Image( texture );</listing>
		 *
		 * @default null
		 */
		public function get content():DisplayObject
		{
			return this._content;
		}

		/**
		 * @private
		 */
		public function set content(value:DisplayObject):void
		{
			if(this._content == value)
			{
				return;
			}
			if(this._content !== null)
			{
				if(this._content is IFeathersControl)
				{
					IFeathersControl(this._content).removeEventListener(FeathersEventType.RESIZE, content_resizeHandler);
				}
				if(this._content.parent === this)
				{
					this._content.width = this._explicitContentWidth;
					this._content.height = this._explicitContentHeight;
					if(this._content is IMeasureDisplayObject)
					{
						var measureContent:IMeasureDisplayObject = IMeasureDisplayObject(this._content);
						measureContent.minWidth = this._explicitContentMinWidth;
						measureContent.minHeight = this._explicitContentMinHeight;
						measureContent.maxWidth = this._explicitContentMaxWidth;
						measureContent.maxHeight = this._explicitContentMaxHeight;
					}
					this._content.removeFromParent(false);
				}
			}
			this._content = value;
			if(this._content !== null)
			{
				if(this._content is IFeathersControl)
				{
					IFeathersControl(this._content).addEventListener(FeathersEventType.RESIZE, content_resizeHandler);
				}
				this.addChild(this._content);
				if(this._content is IFeathersControl)
				{
					IFeathersControl(this._content).initializeNow();
				}
				if(this._content is IMeasureDisplayObject)
				{
					measureContent = IMeasureDisplayObject(this._content);
					this._explicitContentWidth = measureContent.explicitWidth;
					this._explicitContentHeight = measureContent.explicitHeight;
					this._explicitContentMinWidth = measureContent.explicitMinWidth;
					this._explicitContentMinHeight = measureContent.explicitMinHeight;
					this._explicitContentMaxWidth = measureContent.explicitMaxWidth;
					this._explicitContentMaxHeight = measureContent.explicitMaxHeight;
				}
				else
				{
					this._explicitContentWidth = this._content.width;
					this._explicitContentHeight = this._content.height;
					this._explicitContentMinWidth = this._explicitContentWidth;
					this._explicitContentMinHeight = this._explicitContentHeight;
					this._explicitContentMaxWidth = this._explicitContentWidth;
					this._explicitContentMaxHeight = this._explicitContentHeight;
				}
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _origin:DisplayObject;

		/**
		 * A callout may be positioned relative to another display object, known
		 * as the callout's origin. Even if the position of the origin changes,
		 * the callout will reposition itself to always point at the origin.
		 *
		 * <p>When an origin is set, the <code>arrowPosition</code> and
		 * <code>arrowOffset</code> properties will be managed automatically by
		 * the callout. Setting either of these values manually will either have
		 * no effect or unexpected behavior, so it is recommended that you
		 * avoid modifying those properties.</p>
		 *
		 * <p>Note: The <code>origin</code> is excluded when using
		 * <code>closeOnTouchBeganOutside</code> and <code>closeOnTouchEndedOutside</code>.
		 * In other words, when the origin is touched, and either of these
		 * properties is <code>true</code>, the callout will not be closed. If
		 * the callout is not displayed modally, and touching the origin opens
		 * the callout, you should check if a callout is already visible. If a
		 * callout is visible, close it. If no callouts are visible, show one.
		 * However, if the callout is modal, the touch will be stopped by the
		 * overlay before it reaches the origin, so this behavior will not apply.</p>
		 *
		 * <p>In general, if you use <code>Callout.show()</code>, you will
		 * rarely need to manually manage the <code>origin</code> property.</p>
		 *
		 * <p>In the following example, the callout's origin is set to a button:</p>
		 *
		 * <listing version="3.0">
		 * callout.origin = button;</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.Callout#show()
		 * @see #supportedPositions
		 */
		public function get origin():DisplayObject
		{
			return this._origin;
		}

		/**
		 * @private
		 */
		public function set origin(value:DisplayObject):void
		{
			if(this._origin == value)
			{
				return;
			}
			if(value && !value.stage)
			{
				throw new ArgumentError("Callout origin must have access to the stage.");
			}
			if(this._origin)
			{
				this.removeEventListener(EnterFrameEvent.ENTER_FRAME, callout_enterFrameHandler);
				this._origin.removeEventListener(Event.REMOVED_FROM_STAGE, origin_removedFromStageHandler);
			}
			this._origin = value;
			this._lastGlobalBoundsOfOrigin = null;
			if(this._origin)
			{
				this._origin.addEventListener(Event.REMOVED_FROM_STAGE, origin_removedFromStageHandler);
				this.addEventListener(EnterFrameEvent.ENTER_FRAME, callout_enterFrameHandler);
			}
			this.invalidate(INVALIDATION_FLAG_ORIGIN);
		}

		/**
		 * @private
		 */
		protected var _supportedPositions:Vector.<String> = null;

		/**
		 * The position of the callout, relative to its origin. Accepts a
		 * <code>Vector.&lt;String&gt;</code> containing one or more of the
		 * constants from <code>feathers.layout.RelativePosition</code> or
		 * <code>null</code>. If <code>null</code>, the callout will attempt to
		 * position itself using values in the following order:
		 *
		 * <ul>
		 *     <li><code>RelativePosition.BOTTOM</code></li>
		 *     <li><code>RelativePosition.TOP</code></li>
		 *     <li><code>RelativePosition.RIGHT</code></li>
		 *     <li><code>RelativePosition.LEFT</code></li>
		 * </ul>
		 *
		 * <p>Note: If the callout's origin is not set, the
		 * <code>supportedPositions</code> property will be ignored.</p>
		 *
		 * <p>In the following example, the callout's supported positions are
		 * restricted to the top and bottom of the origin:</p>
		 *
		 * <listing version="3.0">
		 * callout.supportedPositions = new &lt;String&gt;[RelativePosition.TOP, RelativePosition.BOTTOM];</listing>
		 *
		 * <p>In the following example, the callout's position is restricted to
		 * the right of the origin:</p>
		 *
		 * <listing version="3.0">
		 * callout.supportedPositions = new &lt;String&gt;[RelativePosition.RIGHT];</listing>
		 *
		 * <p>Note: The <code>arrowPosition</code> property is related to this
		 * one, but they have different meanings and are usually opposites. For
		 * example, a callout on the right side of its origin will generally
		 * display its left arrow.</p>
		 *
		 * @default null
		 *
		 * @see feathers.layout.RelativePosition#TOP
		 * @see feathers.layout.RelativePosition#RIGHT
		 * @see feathers.layout.RelativePosition#BOTTOM
		 * @see feathers.layout.RelativePosition#LEFT
		 */
		public function get supportedPositions():Vector.<String>
		{
			return this._supportedPositions;
		}

		/**
		 * @private
		 */
		public function set supportedPositions(value:Vector.<String>):void
		{
			this._supportedPositions = value;
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.CENTER;

		/**
		 * @private
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._horizontalAlign === value)
			{
				return;
			}
			this._horizontalAlign = value;
			this._lastGlobalBoundsOfOrigin = null;
			this.invalidate(INVALIDATION_FLAG_ORIGIN);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.MIDDLE;

		/**
		 * @private
		 */
		public function get verticalAlign():String
		{
			return this._verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._verticalAlign === value)
			{
				return;
			}
			this._verticalAlign = value;
			this._lastGlobalBoundsOfOrigin = null;
			this.invalidate(INVALIDATION_FLAG_ORIGIN);
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _arrowPosition:String = RelativePosition.TOP;

		[Inspectable(type="String",enumeration="top,right,bottom,left")]
		/**
		 * @private
		 */
		public function get arrowPosition():String
		{
			return this._arrowPosition;
		}

		/**
		 * @private
		 */
		public function set arrowPosition(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._arrowPosition === value)
			{
				return;
			}
			this._arrowPosition = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _backgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundSkin():DisplayObject
		{
			return this._backgroundSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundSkin === value)
			{
				return;
			}
			if(this._backgroundSkin !== null && this._backgroundSkin.parent === this)
			{
				//we need to restore these values so that they won't be lost the
				//next time that this skin is used for measurement
				this._backgroundSkin.width = this._explicitBackgroundSkinWidth;
				this._backgroundSkin.height = this._explicitBackgroundSkinHeight;
				if(this._backgroundSkin is IMeasureDisplayObject)
				{
					var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this._backgroundSkin);
					measureSkin.minWidth = this._explicitBackgroundSkinMinWidth;
					measureSkin.minHeight = this._explicitBackgroundSkinMinHeight;
					measureSkin.maxWidth = this._explicitBackgroundSkinMaxWidth;
					measureSkin.maxHeight = this._explicitBackgroundSkinMaxHeight;
				}
				this._backgroundSkin.removeFromParent(false);
			}
			this._backgroundSkin = value;
			if(this._backgroundSkin !== null)
			{
				if(this._backgroundSkin is IFeathersControl)
				{
					IFeathersControl(this._backgroundSkin).initializeNow();
				}
				if(this._backgroundSkin is IMeasureDisplayObject)
				{
					measureSkin = IMeasureDisplayObject(this._backgroundSkin);
					this._explicitBackgroundSkinWidth = measureSkin.explicitWidth;
					this._explicitBackgroundSkinHeight = measureSkin.explicitHeight;
					this._explicitBackgroundSkinMinWidth = measureSkin.explicitMinWidth;
					this._explicitBackgroundSkinMinHeight = measureSkin.explicitMinHeight;
					this._explicitBackgroundSkinMaxWidth = measureSkin.explicitMaxWidth;
					this._explicitBackgroundSkinMaxHeight = measureSkin.explicitMaxHeight;
				}
				else
				{
					this._explicitBackgroundSkinWidth = this._backgroundSkin.width;
					this._explicitBackgroundSkinHeight = this._backgroundSkin.height;
					this._explicitBackgroundSkinMinWidth = this._explicitBackgroundSkinWidth;
					this._explicitBackgroundSkinMinHeight = this._explicitBackgroundSkinHeight;
					this._explicitBackgroundSkinMaxWidth = this._explicitBackgroundSkinWidth;
					this._explicitBackgroundSkinMaxHeight = this._explicitBackgroundSkinHeight;
				}
				this.addChildAt(this._backgroundSkin, 0);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var currentArrowSkin:DisplayObject;

		/**
		 * @private
		 */
		protected var _topArrowSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get topArrowSkin():DisplayObject
		{
			return this._topArrowSkin;
		}

		/**
		 * @private
		 */
		public function set topArrowSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._topArrowSkin === value)
			{
				return;
			}
			if(this._topArrowSkin !== null && this._topArrowSkin.parent === this)
			{
				this._topArrowSkin.removeFromParent(false);
			}
			this._topArrowSkin = value;
			if(this._topArrowSkin !== null)
			{
				this._topArrowSkin.visible = false;
				var index:int = this.getChildIndex(this._content);
				if(index < 0)
				{
					this.addChild(this._topArrowSkin);
				}
				else
				{
					this.addChildAt(this._topArrowSkin, index);
				}
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _rightArrowSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get rightArrowSkin():DisplayObject
		{
			return this._rightArrowSkin;
		}

		/**
		 * @private
		 */
		public function set rightArrowSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._rightArrowSkin === value)
			{
				return;
			}
			if(this._rightArrowSkin !== null && this._rightArrowSkin.parent === this)
			{
				this._rightArrowSkin.removeFromParent(false);
			}
			this._rightArrowSkin = value;
			if(this._rightArrowSkin !== null)
			{
				this._rightArrowSkin.visible = false;
				var index:int = this.getChildIndex(this._content);
				if(index < 0)
				{
					this.addChild(this._rightArrowSkin);
				}
				else
				{
					this.addChildAt(this._rightArrowSkin, index);
				}
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _bottomArrowSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get bottomArrowSkin():DisplayObject
		{
			return this._bottomArrowSkin;
		}

		/**
		 * @private
		 */
		public function set bottomArrowSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._bottomArrowSkin === value)
			{
				return;
			}
			if(this._bottomArrowSkin !== null && this._bottomArrowSkin.parent === this)
			{
				this._bottomArrowSkin.removeFromParent(false);
			}
			this._bottomArrowSkin = value;
			if(this._bottomArrowSkin !== null)
			{
				this._bottomArrowSkin.visible = false;
				var index:int = this.getChildIndex(this._content);
				if(index < 0)
				{
					this.addChild(this._bottomArrowSkin);
				}
				else
				{
					this.addChildAt(this._bottomArrowSkin, index);
				}
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _leftArrowSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get leftArrowSkin():DisplayObject
		{
			return this._leftArrowSkin;
		}

		/**
		 * @private
		 */
		public function set leftArrowSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._leftArrowSkin === value)
			{
				return;
			}
			if(this._leftArrowSkin !== null && this._leftArrowSkin.parent === this)
			{
				this._leftArrowSkin.removeFromParent(false);
			}
			this._leftArrowSkin = value;
			if(this._leftArrowSkin !== null)
			{
				this._leftArrowSkin.visible = false;
				var index:int = this.getChildIndex(this._content);
				if(index < 0)
				{
					this.addChild(this._leftArrowSkin);
				}
				else
				{
					this.addChildAt(this._leftArrowSkin, index);
				}
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _originGap:Number = 0;

		/**
		 * @private
		 */
		public function get originGap():Number
		{
			return this._originGap;
		}

		/**
		 * @private
		 */
		public function set originGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._originGap == value)
			{
				return;
			}
			this._originGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _topArrowGap:Number = 0;

		/**
		 * @private
		 */
		public function get topArrowGap():Number
		{
			return this._topArrowGap;
		}

		/**
		 * @private
		 */
		public function set topArrowGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._topArrowGap == value)
			{
				return;
			}
			this._topArrowGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _bottomArrowGap:Number = 0;

		/**
		 * @private
		 */
		public function get bottomArrowGap():Number
		{
			return this._bottomArrowGap;
		}

		/**
		 * @private
		 */
		public function set bottomArrowGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._bottomArrowGap == value)
			{
				return;
			}
			this._bottomArrowGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _rightArrowGap:Number = 0;

		/**
		 * @private
		 */
		public function get rightArrowGap():Number
		{
			return this._rightArrowGap;
		}

		/**
		 * @private
		 */
		public function set rightArrowGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._rightArrowGap == value)
			{
				return;
			}
			this._rightArrowGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _leftArrowGap:Number = 0;

		/**
		 * @private
		 */
		public function get leftArrowGap():Number
		{
			return this._leftArrowGap;
		}

		/**
		 * @private
		 */
		public function set leftArrowGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._leftArrowGap == value)
			{
				return;
			}
			this._leftArrowGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _arrowOffset:Number = 0;

		/**
		 * @private
		 */
		public function get arrowOffset():Number
		{
			return this._arrowOffset;
		}

		/**
		 * @private
		 */
		public function set arrowOffset(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._arrowOffset == value)
			{
				return;
			}
			this._arrowOffset = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _lastGlobalBoundsOfOrigin:Rectangle;

		/**
		 * @private
		 */
		protected var _ignoreContentResize:Boolean = false;

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.origin = null;
			var savedContent:DisplayObject = this._content;
			this.content = null;
			//remove the content safely if it should not be disposed
			if(savedContent !== null && this.disposeContent)
			{
				savedContent.dispose();
			}
			super.dispose();
		}

		/**
		 * Closes the callout.
		 */
		public function close(dispose:Boolean = false):void
		{
			if(this.parent)
			{
				//don't dispose here because we need to keep the event listeners
				//when dispatching Event.CLOSE. we'll dispose after that.
				this.removeFromParent(false);
				this.dispatchEventWith(Event.CLOSE);
			}
			if(dispose)
			{
				this.dispose();
			}
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this.addEventListener(Event.REMOVED_FROM_STAGE, callout_removedFromStageHandler);
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var originInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_ORIGIN);

			if(sizeInvalid)
			{
				this._lastGlobalBoundsOfOrigin = null;
				originInvalid = true;
			}

			if(originInvalid)
			{
				this.positionRelativeToOrigin();
			}

			if(stylesInvalid || stateInvalid)
			{
				this.refreshArrowSkin();
			}

			if(stateInvalid || dataInvalid)
			{
				this.refreshEnabled();
			}

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			this.layoutChildren();
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			return this.measureWithArrowPosition(this._arrowPosition);
		}

		/**
		 * @private
		 */
		protected function measureWithArrowPosition(arrowPosition:String):Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			//the dimensions of the stage (plus stage padding) affect the
			//maximum width and height
			var maxWidth:Number = this._explicitMaxWidth;
			var maxHeight:Number = this._explicitMaxHeight;
			if(this.stage !== null)
			{
				var stageMaxWidth:Number = this.stage.stageWidth - stagePaddingLeft - stagePaddingRight;
				if(maxWidth > stageMaxWidth)
				{
					maxWidth = stageMaxWidth;
				}
				var stageMaxHeight:Number = this.stage.stageHeight - stagePaddingTop - stagePaddingBottom;
				if(maxHeight > stageMaxHeight)
				{
					maxHeight = stageMaxHeight;
				}
			}

			if(this._backgroundSkin !== null)
			{
				var oldBackgroundWidth:Number = this._backgroundSkin.width;
				var oldBackgroundHeight:Number = this._backgroundSkin.height;
			}
			var measureBackground:IMeasureDisplayObject = this._backgroundSkin as IMeasureDisplayObject;
			resetFluidChildDimensionsForMeasurement(this._backgroundSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				maxWidth, maxHeight,
				this._explicitBackgroundSkinWidth, this._explicitBackgroundSkinHeight,
				this._explicitBackgroundSkinMinWidth, this._explicitBackgroundSkinMinHeight,
				this._explicitBackgroundSkinMaxWidth, this._explicitBackgroundSkinMaxHeight);
			if(this._backgroundSkin is IValidating)
			{
				IValidating(this._backgroundSkin).validate();
			}

			var leftOrRightArrowWidth:Number = 0;
			var leftOrRightArrowHeight:Number = 0;
			if(arrowPosition === RelativePosition.LEFT && this._leftArrowSkin !== null)
			{
				leftOrRightArrowWidth = this._leftArrowSkin.width + this._leftArrowGap + this._originGap;
				leftOrRightArrowHeight = this._leftArrowSkin.height;
			}
			else if(arrowPosition === RelativePosition.RIGHT && this._rightArrowSkin !== null)
			{
				leftOrRightArrowWidth = this._rightArrowSkin.width + this._rightArrowGap + this._originGap;
				leftOrRightArrowHeight = this._rightArrowSkin.height;
			}
			var topOrBottomArrowWidth:Number = 0;
			var topOrBottomArrowHeight:Number = 0;
			if(arrowPosition === RelativePosition.TOP && this._topArrowSkin !== null)
			{
				topOrBottomArrowWidth = this._topArrowSkin.width;
				topOrBottomArrowHeight = this._topArrowSkin.height + this._topArrowGap + this._originGap;
			}
			else if(arrowPosition === RelativePosition.BOTTOM && this._bottomArrowSkin !== null)
			{
				topOrBottomArrowWidth = this._bottomArrowSkin.width;
				topOrBottomArrowHeight = this._bottomArrowSkin.height + this._bottomArrowGap + this._originGap;
			}
			//the content resizes when the callout resizes, so we can treat it
			//similarly to a background skin
			var oldIgnoreContentResize:Boolean = this._ignoreContentResize;
			this._ignoreContentResize = true;
			if(this._content !== null)
			{
				//we need to restore these after measurement
				var oldContentWidth:Number = this._content.width;
				var oldContentHeight:Number = this._content.height;
			}
			var measureContent:IMeasureDisplayObject = this._content as IMeasureDisplayObject;
			resetFluidChildDimensionsForMeasurement(this._content,
				this._explicitWidth - leftOrRightArrowWidth - this._paddingLeft - this._paddingRight,
				this._explicitHeight - topOrBottomArrowHeight - this._paddingTop - this._paddingBottom,
				this._explicitMinWidth - leftOrRightArrowWidth - this._paddingLeft - this._paddingRight,
				this._explicitMinHeight - topOrBottomArrowHeight - this._paddingTop - this._paddingBottom,
				maxWidth - leftOrRightArrowHeight - this._paddingLeft - this._paddingRight,
				maxHeight - topOrBottomArrowHeight - this._paddingTop - this._paddingBottom,
				this._explicitContentWidth, this._explicitContentHeight,
				this._explicitContentMinWidth, this._explicitContentMinHeight,
				this._explicitContentMaxWidth, this._explicitContentMaxHeight);
			if(this._content is IValidating)
			{
				IValidating(this._content).validate();
			}
			this._ignoreContentResize = oldIgnoreContentResize;

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				var contentWidth:Number = 0;
				if(this._content !== null)
				{
					contentWidth = this._content.width;
				}
				if(topOrBottomArrowWidth > contentWidth)
				{
					contentWidth = topOrBottomArrowWidth;
				}
				newWidth = contentWidth + this._paddingLeft + this._paddingRight;
				var backgroundWidth:Number = 0;
				if(this._backgroundSkin !== null)
				{
					backgroundWidth = this._backgroundSkin.width;
				}
				if(backgroundWidth > newWidth)
				{
					newWidth = backgroundWidth;
				}
				newWidth += leftOrRightArrowWidth;
				if(newWidth > maxWidth)
				{
					newWidth = maxWidth;
				}
			}
			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				var contentHeight:Number = 0;
				if(this._content !== null)
				{
					contentHeight = this._content.height;
				}
				if(leftOrRightArrowHeight > contentWidth)
				{
					contentHeight = leftOrRightArrowHeight;
				}
				newHeight = contentHeight + this._paddingTop + this._paddingBottom;
				var backgroundHeight:Number = 0;
				if(this._backgroundSkin !== null)
				{
					backgroundHeight = this._backgroundSkin.height;
				}
				if(backgroundHeight > newHeight)
				{
					newHeight = backgroundHeight;
				}
				newHeight += topOrBottomArrowHeight;
				if(newHeight > maxHeight)
				{
					newHeight = maxHeight;
				}
			}
			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				var contentMinWidth:Number = 0;
				if(measureContent !== null)
				{
					contentMinWidth = measureContent.minWidth;
				}
				else if(this._content !== null)
				{
					contentMinWidth = this._content.width;
				}
				if(topOrBottomArrowWidth > contentMinWidth)
				{
					contentMinWidth = topOrBottomArrowWidth;
				}
				newMinWidth = contentMinWidth + this._paddingLeft + this._paddingRight;
				var backgroundMinWidth:Number = 0;
				if(measureBackground !== null)
				{
					backgroundMinWidth = measureBackground.minWidth;
				}
				else if(this._backgroundSkin !== null)
				{
					backgroundMinWidth = this._explicitBackgroundSkinMinWidth;
				}
				if(backgroundMinWidth > newMinWidth)
				{
					newMinWidth = backgroundMinWidth;
				}
				newMinWidth += leftOrRightArrowWidth;
				if(newMinWidth > maxWidth)
				{
					newMinWidth = maxWidth;
				}
			}
			var newMinHeight:Number = this._explicitHeight;
			if(needsMinHeight)
			{
				var contentMinHeight:Number = 0;
				if(measureContent !== null)
				{
					contentMinHeight = measureContent.minHeight;
				}
				else if(this._content !== null)
				{
					contentMinHeight = this._content.height;
				}
				if(leftOrRightArrowHeight > contentMinHeight)
				{
					contentMinHeight = leftOrRightArrowHeight;
				}
				newMinHeight = contentMinHeight + this._paddingTop + this._paddingBottom;
				var backgroundMinHeight:Number = 0;
				if(measureBackground !== null)
				{
					backgroundMinHeight = measureBackground.minHeight;
				}
				else if(this._backgroundSkin !== null)
				{
					backgroundMinHeight = this._explicitBackgroundSkinMinHeight;
				}
				if(backgroundMinHeight > newMinHeight)
				{
					newMinHeight = backgroundMinHeight;
				}
				newMinHeight += topOrBottomArrowHeight;
				if(newMinHeight > maxHeight)
				{
					newMinHeight = maxHeight;
				}
			}
			if(this._backgroundSkin !== null)
			{
				this._backgroundSkin.width = oldBackgroundWidth;
				this._backgroundSkin.height = oldBackgroundHeight;
			}
			if(this._content !== null)
			{
				oldIgnoreContentResize = this._ignoreContentResize;
				this._ignoreContentResize = true;
				this._content.width = oldContentWidth;
				this._content.height = oldContentHeight;
				this._ignoreContentResize = oldIgnoreContentResize;
			}
			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * @private
		 */
		protected function refreshArrowSkin():void
		{
			this.currentArrowSkin = null;
			if(this._arrowPosition == RelativePosition.BOTTOM)
			{
				this.currentArrowSkin = this._bottomArrowSkin;
			}
			else if(this._bottomArrowSkin)
			{
				this._bottomArrowSkin.visible = false;
			}
			if(this._arrowPosition == RelativePosition.TOP)
			{
				this.currentArrowSkin = this._topArrowSkin;
			}
			else if(this._topArrowSkin)
			{
				this._topArrowSkin.visible = false;
			}
			if(this._arrowPosition == RelativePosition.LEFT)
			{
				this.currentArrowSkin = this._leftArrowSkin;
			}
			else if(this._leftArrowSkin)
			{
				this._leftArrowSkin.visible = false;
			}
			if(this._arrowPosition == RelativePosition.RIGHT)
			{
				this.currentArrowSkin = this._rightArrowSkin;
			}
			else if(this._rightArrowSkin)
			{
				this._rightArrowSkin.visible = false;
			}
			if(this.currentArrowSkin)
			{
				this.currentArrowSkin.visible = true;
			}
		}

		/**
		 * @private
		 */
		protected function refreshEnabled():void
		{
			if(this._content is IFeathersControl)
			{
				IFeathersControl(this._content).isEnabled = this._isEnabled;
			}
		}

		/**
		 * @private
		 */
		protected function layoutChildren():void
		{
			var xPosition:Number = 0;
			if(this._leftArrowSkin !== null && this._arrowPosition === RelativePosition.LEFT)
			{
				xPosition = this._leftArrowSkin.width + this._leftArrowGap;
			}
			var yPosition:Number = 0;
			if(this._topArrowSkin !== null && this._arrowPosition === RelativePosition.TOP)
			{
				yPosition = this._topArrowSkin.height + this._topArrowGap;
			}
			var widthOffset:Number = 0;
			if(this._rightArrowSkin !== null && this._arrowPosition === RelativePosition.RIGHT)
			{
				widthOffset = this._rightArrowSkin.width + this._rightArrowGap;
			}
			var heightOffset:Number = 0;
			if(this._bottomArrowSkin !== null && this._arrowPosition === RelativePosition.BOTTOM)
			{
				heightOffset = this._bottomArrowSkin.height + this._bottomArrowGap;
			}
			var backgroundWidth:Number = this.actualWidth - xPosition - widthOffset;
			var backgroundHeight:Number = this.actualHeight - yPosition - heightOffset;
			if(this._backgroundSkin !== null)
			{
				this._backgroundSkin.x = xPosition;
				this._backgroundSkin.y = yPosition;
				this._backgroundSkin.width = backgroundWidth;
				this._backgroundSkin.height = backgroundHeight;
			}

			if(this.currentArrowSkin !== null)
			{
				var contentWidth:Number = backgroundWidth - this._paddingLeft - this._paddingRight;
				var contentHeight:Number = backgroundHeight - this._paddingTop - this._paddingBottom;
				if(this._arrowPosition === RelativePosition.LEFT)
				{
					this._leftArrowSkin.x = xPosition - this._leftArrowSkin.width - this._leftArrowGap;
					var leftArrowSkinY:Number = this._arrowOffset + yPosition + this._paddingTop;
					if(this._verticalAlign === VerticalAlign.MIDDLE)
					{
						leftArrowSkinY += Math.round((contentHeight - this._leftArrowSkin.height) / 2);
					}
					else if(this._verticalAlign === VerticalAlign.BOTTOM)
					{
						leftArrowSkinY += (contentHeight - this._leftArrowSkin.height);
					}
					var minLeftArrowSkinY:Number = yPosition + this._paddingTop;
					if(minLeftArrowSkinY > leftArrowSkinY)
					{
						leftArrowSkinY = minLeftArrowSkinY;
					}
					else
					{
						var maxLeftArrowSkinY:Number = yPosition + this._paddingTop + contentHeight - this._leftArrowSkin.height;
						if(maxLeftArrowSkinY < leftArrowSkinY)
						{
							leftArrowSkinY = maxLeftArrowSkinY;
						}
					}
					this._leftArrowSkin.y = leftArrowSkinY;
				}
				else if(this._arrowPosition === RelativePosition.RIGHT)
				{
					this._rightArrowSkin.x = xPosition + backgroundWidth + this._rightArrowGap;
					var rightArrowSkinY:Number = this._arrowOffset + yPosition + this._paddingTop;
					if(this._verticalAlign === VerticalAlign.MIDDLE)
					{
						rightArrowSkinY += Math.round((contentHeight - this._rightArrowSkin.height) / 2);
					}
					else if(this._verticalAlign === VerticalAlign.BOTTOM)
					{
						rightArrowSkinY += (contentHeight - this._rightArrowSkin.height);
					}
					var minRightArrowSkinY:Number = yPosition + this._paddingTop;
					if(minRightArrowSkinY > rightArrowSkinY)
					{
						rightArrowSkinY = minRightArrowSkinY;
					}
					else
					{
						var maxRightArrowSkinY:Number = yPosition + this._paddingTop + contentHeight - this._rightArrowSkin.height;
						if(maxRightArrowSkinY < rightArrowSkinY)
						{
							rightArrowSkinY = maxRightArrowSkinY;
						}
					}
					this._rightArrowSkin.y = rightArrowSkinY;
				}
				else if(this._arrowPosition === RelativePosition.BOTTOM)
				{
					var bottomArrowSkinX:Number = this._arrowOffset + xPosition + this._paddingLeft;
					if(this._horizontalAlign === HorizontalAlign.CENTER)
					{
						bottomArrowSkinX += Math.round((contentWidth - this._bottomArrowSkin.width) / 2);
					}
					else if(this._horizontalAlign === HorizontalAlign.RIGHT)
					{
						bottomArrowSkinX += (contentWidth - this._bottomArrowSkin.width);
					}
					var minBottomArrowSkinX:Number = xPosition + this._paddingLeft;
					if(minBottomArrowSkinX > bottomArrowSkinX)
					{
						bottomArrowSkinX = minBottomArrowSkinX;
					}
					else
					{
						var maxBottomArrowSkinX:Number = xPosition + this._paddingLeft + contentWidth - this._bottomArrowSkin.width;
						if(maxBottomArrowSkinX < bottomArrowSkinX)
						{
							bottomArrowSkinX = maxBottomArrowSkinX;
						}
					}
					this._bottomArrowSkin.x = bottomArrowSkinX;
					this._bottomArrowSkin.y = yPosition + backgroundHeight + this._bottomArrowGap;
				}
				else //top
				{
					var topArrowSkinX:Number = this._arrowOffset + xPosition + this._paddingLeft;
					if(this._horizontalAlign === HorizontalAlign.CENTER)
					{
						topArrowSkinX += Math.round((contentWidth - this._topArrowSkin.width) / 2);
					}
					else if(this._horizontalAlign === HorizontalAlign.RIGHT)
					{
						topArrowSkinX += (contentWidth - this._topArrowSkin.width);
					}
					var minTopArrowSkinX:Number = xPosition + this._paddingLeft;
					if(minTopArrowSkinX > topArrowSkinX)
					{
						topArrowSkinX = minTopArrowSkinX;
					}
					else
					{
						var maxTopArrowSkinX:Number = xPosition + this._paddingLeft + contentWidth - this._topArrowSkin.width;
						if(maxTopArrowSkinX < topArrowSkinX)
						{
							topArrowSkinX = maxTopArrowSkinX;
						}
					}
					this._topArrowSkin.x = topArrowSkinX;
					this._topArrowSkin.y = yPosition - this._topArrowSkin.height - this._topArrowGap;
				}
			}

			if(this._content !== null)
			{
				this._content.x = xPosition + this._paddingLeft;
				this._content.y = yPosition + this._paddingTop;
				var oldIgnoreContentResize:Boolean = this._ignoreContentResize;
				this._ignoreContentResize = true;
				this._content.width = backgroundWidth - this._paddingLeft - this._paddingRight;
				this._content.height = backgroundHeight - this._paddingTop - this._paddingBottom;
				if(this._content is IValidating)
				{
					IValidating(this._content).validate();
				}
				this._ignoreContentResize = oldIgnoreContentResize;
			}
		}

		/**
		 * @private
		 */
		protected function positionRelativeToOrigin():void
		{
			if(this._origin === null)
			{
				return;
			}
			var stage:Stage = this.stage !== null ? this.stage : Starling.current.stage;
			var rect:Rectangle = Pool.getRectangle();
			this._origin.getBounds(stage, rect);
			var hasGlobalBounds:Boolean = this._lastGlobalBoundsOfOrigin != null;
			if(hasGlobalBounds && this._lastGlobalBoundsOfOrigin.equals(rect))
			{
				Pool.putRectangle(rect);
				return;
			}
			if(!hasGlobalBounds)
			{
				this._lastGlobalBoundsOfOrigin = new Rectangle();
			}
			this._lastGlobalBoundsOfOrigin.x = rect.x;
			this._lastGlobalBoundsOfOrigin.y = rect.y;
			this._lastGlobalBoundsOfOrigin.width = rect.width;
			this._lastGlobalBoundsOfOrigin.height = rect.height;
			Pool.putRectangle(rect);

			var supportedPositions:Vector.<String> = this._supportedPositions;
			if(supportedPositions === null)
			{
				supportedPositions = DEFAULT_POSITIONS;
			}
			var upSpace:Number = -1;
			var rightSpace:Number = -1;
			var downSpace:Number = -1;
			var leftSpace:Number = -1;
			var positionsCount:int = supportedPositions.length;
			for(var i:int = 0; i < positionsCount; i++)
			{
				var position:String = supportedPositions[i];
				switch(position)
				{
					case RelativePosition.TOP:
					{
						//arrow is opposite, on bottom side
						this.measureWithArrowPosition(RelativePosition.BOTTOM);
						upSpace = this._lastGlobalBoundsOfOrigin.y - this.actualHeight;
						if(upSpace >= stagePaddingTop)
						{
							positionAboveOrigin(this, this._lastGlobalBoundsOfOrigin);
							return;
						}
						if(upSpace < 0)
						{
							upSpace = 0;
						}
						break;
					}
					case RelativePosition.RIGHT:
					{
						//arrow is opposite, on left side
						this.measureWithArrowPosition(RelativePosition.LEFT);
						rightSpace = (stage.stageWidth - actualWidth) - (this._lastGlobalBoundsOfOrigin.x + this._lastGlobalBoundsOfOrigin.width);
						if(rightSpace >= stagePaddingRight)
						{
							positionToRightOfOrigin(this, this._lastGlobalBoundsOfOrigin);
							return;
						}
						if(rightSpace < 0)
						{
							rightSpace = 0;
						}
						break;
					}
					case RelativePosition.LEFT:
					{
						this.measureWithArrowPosition(RelativePosition.RIGHT);
						leftSpace = this._lastGlobalBoundsOfOrigin.x - this.actualWidth;
						if(leftSpace >= stagePaddingLeft)
						{
							positionToLeftOfOrigin(this, this._lastGlobalBoundsOfOrigin);
							return;
						}
						if(leftSpace < 0)
						{
							leftSpace = 0;
						}
						break;
					}
					default: //bottom
					{
						//arrow is opposite, on top side
						this.measureWithArrowPosition(RelativePosition.TOP);
						downSpace = (stage.stageHeight - this.actualHeight) - (this._lastGlobalBoundsOfOrigin.y + this._lastGlobalBoundsOfOrigin.height);
						if(downSpace >= stagePaddingBottom)
						{
							positionBelowOrigin(this, this._lastGlobalBoundsOfOrigin);
							return;
						}
						if(downSpace < 0)
						{
							downSpace = 0;
						}
					}
				}
			}
			//worst case: pick the side that has the most available space
			if(downSpace != -1 && downSpace >= upSpace &&
				downSpace >= rightSpace && downSpace >= leftSpace)
			{
				positionBelowOrigin(this, this._lastGlobalBoundsOfOrigin);
			}
			else if(upSpace != -1 && upSpace >= rightSpace && upSpace >= leftSpace)
			{
				positionAboveOrigin(this, this._lastGlobalBoundsOfOrigin);
			}
			else if(rightSpace != -1 && rightSpace >= leftSpace)
			{
				positionToRightOfOrigin(this, this._lastGlobalBoundsOfOrigin);
			}
			else
			{
				positionToLeftOfOrigin(this, this._lastGlobalBoundsOfOrigin);
			}
		}

		/**
		 * @private
		 */
		protected function callout_addedToStageHandler(event:Event):void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			//using priority here is a hack so that objects higher up in the
			//display list have a chance to cancel the event first.
			var priority:int = -getDisplayObjectDepthFromStage(this);
			starling.nativeStage.addEventListener(KeyboardEvent.KEY_DOWN, callout_nativeStage_keyDownHandler, false, priority, true);

			this.stage.addEventListener(TouchEvent.TOUCH, stage_touchHandler);
			//to avoid touch events bubbling up to the callout and causing it to
			//close immediately, we wait one frame before allowing it to close
			//based on touches.
			this._isReadyToClose = false;
			this.addEventListener(EnterFrameEvent.ENTER_FRAME, callout_oneEnterFrameHandler);
		}

		/**
		 * @private
		 */
		protected function callout_removedFromStageHandler(event:Event):void
		{
			this.stage.removeEventListener(TouchEvent.TOUCH, stage_touchHandler);
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			starling.nativeStage.removeEventListener(KeyboardEvent.KEY_DOWN, callout_nativeStage_keyDownHandler);
		}

		/**
		 * @private
		 */
		protected function callout_oneEnterFrameHandler(event:Event):void
		{
			this.removeEventListener(EnterFrameEvent.ENTER_FRAME, callout_oneEnterFrameHandler);
			this._isReadyToClose = true;
		}

		/**
		 * @private
		 */
		protected function callout_enterFrameHandler(event:EnterFrameEvent):void
		{
			this.positionRelativeToOrigin();
		}

		/**
		 * @private
		 */
		protected function stage_touchHandler(event:TouchEvent):void
		{
			var target:DisplayObject = DisplayObject(event.target);
			if(!this._isReadyToClose ||
				(!this.closeOnTouchEndedOutside && !this.closeOnTouchBeganOutside) || this.contains(target) ||
				(PopUpManager.isPopUp(this) && !PopUpManager.isTopLevelPopUp(this)))
			{
				return;
			}

			if(this._origin == target || (this._origin is DisplayObjectContainer && DisplayObjectContainer(this._origin).contains(target)))
			{
				return;
			}

			if(this.closeOnTouchBeganOutside)
			{
				var touch:Touch = event.getTouch(this.stage, TouchPhase.BEGAN);
				if(touch)
				{
					this.close(this.disposeOnSelfClose);
					return;
				}
			}
			if(this.closeOnTouchEndedOutside)
			{
				touch = event.getTouch(this.stage, TouchPhase.ENDED);
				if(touch)
				{
					this.close(this.disposeOnSelfClose);
					return;
				}
			}
		}

		/**
		 * @private
		 */
		protected function callout_nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.isDefaultPrevented())
			{
				//someone else already handled this one
				return;
			}
			if(!this.closeOnKeys || this.closeOnKeys.indexOf(event.keyCode) < 0)
			{
				return;
			}
			//don't let the OS handle the event
			event.preventDefault();
			this.close(this.disposeOnSelfClose);
		}

		/**
		 * @private
		 */
		protected function origin_removedFromStageHandler(event:Event):void
		{
			this.close(this.disposeOnSelfClose);
		}

		/**
		 * @private
		 */
		protected function content_resizeHandler(event:Event):void
		{
			if(this._ignoreContentResize)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}
	}
}


================================================
FILE: source/feathers/controls/Check.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.skins.IStyleProvider;

	import flash.errors.IllegalOperationError;

	[Exclude(name="isToggle",kind="property")]

	/**
	 * A toggle control that contains a label and a box that may be checked
	 * or not to indicate selection.
	 *
	 * <p>In the following example, a check is created and selected, and a
	 * listener for <code>Event.CHANGE</code> is added:</p>
	 *
	 * <listing version="3.0">
	 * var check:Check = new Check();
	 * check.label = "Pick Me!";
	 * check.isSelected = true;
	 * check.addEventListener( Event.CHANGE, check_changeHandler );
	 * this.addChild( check );</listing>
	 *
	 * @see ../../../help/check.html How to use the Feathers Check component
	 * @see feathers.controls.ToggleSwitch
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class Check extends ToggleButton
	{
		/**
		 * The default value added to the <code>styleNameList</code> of the label.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_LABEL:String = "feathers-check-label";

		/**
		 * The default <code>IStyleProvider</code> for all <code>Check</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function Check()
		{
			super();
			this.labelStyleName = DEFAULT_CHILD_STYLE_NAME_LABEL;
			super.isToggle = true;
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return Check.globalStyleProvider;
		}

		/**
		 * @private
		 */
		override public function set isToggle(value:Boolean):void
		{
			throw IllegalOperationError("CheckBox isToggle must always be true.");
		}
	}
}


================================================
FILE: source/feathers/controls/DataGrid.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.DataGridColumn;
	import feathers.controls.Scroller;
	import feathers.controls.renderers.DefaultDataGridHeaderRenderer;
	import feathers.controls.renderers.IDataGridHeaderRenderer;
	import feathers.controls.supportClasses.DataGridDataViewPort;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IValidating;
	import feathers.data.ArrayCollection;
	import feathers.data.IListCollection;
	import feathers.data.ListCollection;
	import feathers.data.SortOrder;
	import feathers.display.RenderDelegate;
	import feathers.dragDrop.DragData;
	import feathers.dragDrop.DragDropManager;
	import feathers.dragDrop.IDragSource;
	import feathers.dragDrop.IDropTarget;
	import feathers.events.CollectionEventType;
	import feathers.events.DragDropEvent;
	import feathers.events.FeathersEventType;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.HorizontalLayoutData;
	import feathers.layout.ILayout;
	import feathers.layout.IVariableVirtualLayout;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.skins.IStyleProvider;
	import feathers.system.DeviceCapabilities;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;

	import flash.errors.IllegalOperationError;
	import flash.events.KeyboardEvent;
	import flash.events.TransformGestureEvent;
	import flash.geom.Point;
	import flash.ui.Keyboard;
	import flash.utils.Dictionary;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;
	import starling.utils.SystemUtil;

	/**
	 * A skin to display when dragging one of the data grid's headers to
	 * highlight the column where it was orignally located.
	 *
	 * <p>In the following example, the data grid's column overlay skin is provided:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Quad = new Quad(1, 1, 0x999999);
	 * skin.alpha = 0.5;
	 * grid.columnDragOverlaySkin = skin;</listing>
	 *
	 * @default null
	 *
	 * @see #reorderColumns
	 */
	[Style(name="columnDragOverlaySkin",type="starling.display.DisplayObject")]

	/**
	 * A skin to display when resizing one of the data grid's headers to
	 * indicate how it will be resized.
	 *
	 * <p>In the following example, the data grid's column resize skin is provided:</p>
	 *
	 * <listing version="3.0">
	 * grid.columnResizeSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #resizableColumns
	 * @see feathers.controls.DataGridColumn#resizable
	 */
	[Style(name="columnResizeSkin",type="starling.display.DisplayObject")]

	/**
	 * Specifies a custom style name for cell renderers that will be used if
	 * the <code>customCellRendererStyleName</code> property from a
	 * <code>DataGridColumn</code> is <code>null</code>.
	 *
	 * <p>The following example sets the cell renderer style name:</p>
	 *
	 * <listing version="3.0">
	 * column.customCellRendererStyleName = "my-custom-cell-renderer";</listing>
	 *
	 * <p>In your theme, you can target this sub-component name to provide
	 * different skins than the default style:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( DefaultDataGridCellRenderer ).setFunctionForStyleName( "my-custom-cell-renderer", setCustomCellRendererStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 */
	[Style(name="customCellRendererStyleName",type="String")]

	/**
	 * Specifies a custom style name for header renderers that will be used if
	 * the <code>customHeaderRendererStyleName</code> property from a
	 * <code>DataGridColumn</code> is <code>null</code>.
	 *
	 * <p>The following example sets the header renderer style name:</p>
	 *
	 * <listing version="3.0">
	 * column.customHeaderRendererStyleName = "my-custom-header-renderer";</listing>
	 *
	 * <p>In your theme, you can target this sub-component name to provide
	 * different skins than the default style:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( DefaultDataGridHeaderRenderer ).setFunctionForStyleName( "my-custom-header-renderer", setCustomHeaderRendererStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 */
	[Style(name="customHeaderRendererStyleName",type="String")]

	/**
	 * Determines if the height of the column drop indicator is equal to the
	 * height of the headers, or if it extends to the full height of the data
	 * grid's view port.
	 *
	 * <p>In the following example, the data grid's column drop skin is extended:</p>
	 *
	 * <listing version="3.0">
	 * grid.extendedColumnDropIndicator = true;</listing>
	 *
	 * @default false
	 *
	 * @see #reorderColumns
	 * @see #style:columnDropIndicatorSkin
	 */
	[Style(name="extendedColumnDropIndicator",type="Boolean")]

	/**
	 * The default background to display in the data grid's header.
	 *
	 * <p>In the following example, the data grid's header is given a background skin:</p>
	 *
	 * <listing version="3.0">
	 * scroller.headerBackgroundSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:headerBackgroundDisabledSkin
	 */
	[Style(name="headerBackgroundSkin",type="starling.display.DisplayObject")]

	/**
	 * A function that returns new dividers that separate each of the data
	 * grid's header renderers. If <code>null</code>, no dividers will appear
	 * between the header renderers.
	 *
	 * <p>The function is expected to have the following signature:</p>
	 *
	 * <pre>function():DisplayObject</pre>
	 *
	 * <p>The following example provides a factory for the header dividers:</p>
	 *
	 * <listing version="3.0">
	 * grid.headerDividerFactory = function():DisplayObject
	 * {
	 *     return = new ImageSkin( texture );
	 * };</listing>
	 *
	 * @default null
	 */
	[Style(name="headerDividerFactory",type="Function")]

	/**
	 * A background to display in the data grid's header when the container is
	 * disabled.
	 *
	 * <p>In the following example, the data grid's header is given a disabled background skin:</p>
	 *
	 * <listing version="3.0">
	 * grid.headerBackgroundDisabledSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:headerBackgroundSkin
	 */
	[Style(name="headerBackgroundDisabledSkin",type="starling.display.DisplayObject")]

	/**
	 * The alpha value used for the column's drag avatar.
	 *
	 * <p>In the following example, the data grid's column drag avatar alpha value is customized:</p>
	 *
	 * <listing version="3.0">
	 * grid.columnDragAvatarAlpha = 0.5;</listing>
	 *
	 * @default 0.8
	 *
	 * @see #reorderColumns
	 */
	[Style(name="columnDragAvatarAlpha",type="Number")]

	/**
	 * A skin to display when dragging one of the data grid's headers to indicate where
	 * it can be dropped.
	 *
	 * <p>In the following example, the data grid's header drag indicator is provided:</p>
	 *
	 * <listing version="3.0">
	 * grid.columnDropIndicatorSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #reorderColumns
	 * @see #style:extendedColumnDropIndicator
	 */
	[Style(name="columnDropIndicatorSkin",type="starling.display.DisplayObject")]

	/**
	 * The duration, in seconds, of the animation when the selected item is
	 * changed by keyboard navigation and the item scrolls into view.
	 *
	 * <p>In the following example, the duration of the animation that
	 * scrolls the list to a new selected item is set to 500 milliseconds:</p>
	 *
	 * <listing version="3.0">
	 * list.keyScrollDuration = 0.5;</listing>
	 *
	 * @default 0.25
	 */
	[Style(name="keyScrollDuration",type="Number")]

	/**
	 * A function that returns new dividers that separate each of the data
	 * grid's columns. If <code>null</code>, no dividers will appear between
	 * columns.
	 *
	 * <p>The function is expected to have the following signature:</p>
	 *
	 * <pre>function():DisplayObject</pre>
	 *
	 * <p>The following example provides a factory for the vertical dividers:</p>
	 *
	 * <listing version="3.0">
	 * grid.verticalDividerFactory = function():DisplayObject
	 * {
	 *     return = new ImageSkin( texture );
	 * };</listing>
	 *
	 * @default null
	 */
	[Style(name="verticalDividerFactory",type="Function")]

	/**
	 * Dispatched when the selected item changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #selectedItem
	 * @see #selectedIndex
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Displays a collection of items as a table. Each item is rendered as a
	 * row, divided into columns for each of the item's fields. Supports
	 * scrolling, custom cell renderers, sorting columns, resizing columns, and
	 * drag and drop reordering of columns.
	 *
	 * <p>The following example creates a data grid, gives it a data provider,
	 * defines its columns, and listens for when the selection changes:</p>
	 *
	 * <listing version="3.0">
	 * var grid:DataGrid = new DataGrid();
	 * 
	 * grid.dataProvider = new ArrayCollection(
	 * [
	 *     { item: "Chicken breast", dept: "Meat", price: "5.90" },
	 *     { item: "Butter", dept: "Dairy", price: "4.69" },
	 *     { item: "Broccoli", dept: "Produce", price: "2.99" },
	 *     { item: "Whole Wheat Bread", dept: "Bakery", price: "2.49" },
	 * ]);
	 * 
	 * grid.columns = new ArrayCollection(
	 * [
	 *     new DataGridColumn("item", "Item"),
	 *     new DataGridColumn("dept", "Department"),
	 *     new DataGridColumn("price", "Unit Price"),
	 * ]);
	 * 
	 * grid.addEventListener( Event.CHANGE, grid_changeHandler );
	 * 
	 * this.addChild( grid );</listing>
	 *
	 * @see ../../../help/data-grid.html How to use the Feathers DataGrid component
	 *
	 * @productversion Feathers 3.4.0
	 */
	public class DataGrid extends Scroller implements IDragSource, IDropTarget
	{
		/**
		 * @private
		 */
		protected static function defaultSortCompareFunction(a:Object, b:Object):int
		{
			var aString:String = a.toString().toLowerCase();
			var bString:String = b.toString().toLowerCase();
			if(aString < bString)
			{
				return -1;
			}
			if(aString > bString)
			{
				return 1;
			}
			return 0;
		}

		/**
		 * @private
		 */
		protected static function defaultHeaderRendererFactory():IDataGridHeaderRenderer
		{
			return new DefaultDataGridHeaderRenderer();
		}

		/**
		 * @private
		 */
		protected static const DATA_GRID_HEADER_DRAG_FORMAT:String = "feathers-data-grid-header";

		/**
		 * The default <code>IStyleProvider</code> for all <code>List</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function DataGrid()
		{
			super();
			this.addEventListener(DragDropEvent.DRAG_ENTER, dataGrid_dragEnterHandler);
			this.addEventListener(DragDropEvent.DRAG_MOVE, dataGrid_dragMoveHandler);
			this.addEventListener(DragDropEvent.DRAG_DROP, dataGrid_dragDropHandler);
			this._selectedIndices.addEventListener(Event.CHANGE, selectedIndices_changeHandler);
		}

		/**
		 * @private
		 * The guts of the DataGrid's functionality. Handles layout and selection.
		 */
		protected var dataViewPort:DataGridDataViewPort;

		/**
		 * @private
		 */
		protected var _headerGroup:LayoutGroup = null;

		/**
		 * @private
		 */
		protected var _headerDividerGroup:LayoutGroup = null;

		/**
		 * @private
		 */
		protected var _verticalDividerGroup:LayoutGroup = null;

		/**
		 * @private
		 */
		protected var _headerLayout:HorizontalLayout = null;

		/**
		 * @private
		 */
		protected var _headerRendererMap:Dictionary = new Dictionary(true);

		/**
		 * @private
		 */
		protected var _unrenderedHeaders:Vector.<int> = new <int>[];

		/**
		 * @private
		 */
		protected var _headerStorage:HeaderRendererFactoryStorage = new HeaderRendererFactoryStorage();

		/**
		 * @private
		 */
		protected var _headerDividerStorage:DividerFactoryStorage = new DividerFactoryStorage();

		/**
		 * @private
		 */
		protected var _verticalDividerStorage:DividerFactoryStorage = new DividerFactoryStorage();

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return DataGrid.globalStyleProvider;
		}

		/**
		 * @private
		 */
		override public function get isFocusEnabled():Boolean
		{
			return (this._isSelectable || this._minHorizontalScrollPosition != this._maxHorizontalScrollPosition ||
				this._minVerticalScrollPosition != this._maxVerticalScrollPosition) &&
				this._isEnabled && this._isFocusEnabled;
		}

		/**
		 * @private
		 */
		protected var _isChildFocusEnabled:Boolean = true;

		/**
		 * @copy feathers.core.IFocusContainer#isChildFocusEnabled
		 *
		 * @default true
		 *
		 * @see #isFocusEnabled
		 */
		public function get isChildFocusEnabled():Boolean
		{
			return this._isEnabled && this._isChildFocusEnabled;
		}

		/**
		 * @private
		 */
		public function set isChildFocusEnabled(value:Boolean):void
		{
			this._isChildFocusEnabled = value;
		}

		/**
		 * @private
		 */
		protected var _reorderColumns:Boolean = false;

		/**
		 * Determines if the data grid's columns may be reordered using drag
		 * and drop.
		 *
		 * <p>The following example enables column reordering:</p>
		 *
		 * <listing version="3.0">
		 * grid.reorderColumns = true;</listing>
		 *
		 * @default false
		 */
		public function get reorderColumns():Boolean
		{
			return this._reorderColumns;
		}

		/**
		 * @private
		 */
		public function set reorderColumns(value:Boolean):void
		{
			this._reorderColumns = value;
		}

		/**
		 * @private
		 */
		protected var _sortableColumns:Boolean = false;

		/**
		 * Determines if the data grid's columns may be sorted.
		 *
		 * <p>The following example enables column sorting:</p>
		 *
		 * <listing version="3.0">
		 * grid.sortableColumns = true;</listing>
		 *
		 * @default false
		 *
		 * @see feathers.controls.DataGridColumn#sortOrder
		 */
		public function get sortableColumns():Boolean
		{
			return this._sortableColumns;
		}

		/**
		 * @private
		 */
		public function set sortableColumns(value:Boolean):void
		{
			this._sortableColumns = value;
		}

		/**
		 * @private
		 */
		protected var _resizableColumns:Boolean = false;

		/**
		 * Determines if the data grid's columns may be resized.
		 *
		 * <p>The following example enables column resizing:</p>
		 *
		 * <listing version="3.0">
		 * grid.resizableColumns = true;</listing>
		 *
		 * @default false
		 *
		 * @see #style:columnResizeSkin
		 */
		public function get resizableColumns():Boolean
		{
			return this._resizableColumns;
		}

		/**
		 * @private
		 */
		public function set resizableColumns(value:Boolean):void
		{
			this._resizableColumns = value;
		}

		/**
		 * @private
		 */
		protected var _currentColumnDropIndicatorSkin:DisplayObject = null;

		/**
		 * @private
		 */
		protected var _columnDropIndicatorSkin:DisplayObject = null;

		/**
		 * @private
		 */
		public function get columnDropIndicatorSkin():DisplayObject
		{
			return this._columnDropIndicatorSkin;
		}

		/**
		 * @private
		 */
		public function set columnDropIndicatorSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			this._columnDropIndicatorSkin = value;
		}

		/**
		 * @private
		 */
		protected var _currentColumnResizeSkin:DisplayObject = null;

		/**
		 * @private
		 */
		protected var _columnResizeSkin:DisplayObject = null;

		/**
		 * @private
		 */
		public function get columnResizeSkin():DisplayObject
		{
			return this._columnResizeSkin;
		}

		/**
		 * @private
		 */
		public function set columnResizeSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			this._columnResizeSkin = value;
		}

		/**
		 * @private
		 */
		protected var _currentColumnDragOverlaySkin:DisplayObject = null;

		/**
		 * @private
		 */
		protected var _columnDragOverlaySkin:DisplayObject = null;

		/**
		 * @private
		 */
		public function get columnDragOverlaySkin():DisplayObject
		{
			return this._columnDragOverlaySkin;
		}

		/**
		 * @private
		 */
		public function set columnDragOverlaySkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			this._columnDragOverlaySkin = value;
		}

		/**
		 * @private
		 */
		protected var _columnDragAvatarAlpha:Number = 0.8;

		/**
		 * @private
		 */
		public function get columnDragAvatarAlpha():Number
		{
			return this._columnDragAvatarAlpha;
		}

		/**
		 * @private
		 */
		public function set columnDragAvatarAlpha(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._columnDragAvatarAlpha = value;
		}

		/**
		 * @private
		 */
		protected var _extendedColumnDropIndicator:Boolean = false;

		/**
		 * @private
		 */
		public function get extendedColumnDropIndicator():Boolean
		{
			return this._extendedColumnDropIndicator;
		}

		/**
		 * @private
		 */
		public function set extendedColumnDropIndicator(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._extendedColumnDropIndicator = value;
		}

		/**
		 * @private
		 */
		protected var _layout:ILayout = null;

		/**
		 * @private
		 */
		protected function get layout():ILayout
		{
			return this._layout;
		}

		/**
		 * @private
		 */
		protected function set layout(value:ILayout):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._layout === value)
			{
				return;
			}
			if(this._layout)
			{
				this._layout.removeEventListener(Event.SCROLL, layout_scrollHandler);
			}
			this._layout = value;
			if(this._layout is IVariableVirtualLayout)
			{
				this._layout.addEventListener(Event.SCROLL, layout_scrollHandler);
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _updateForDataReset:Boolean = false;

		/**
		 * @private
		 */
		protected var _dataProvider:IListCollection;

		/**
		 * The collection of data displayed by the data grid. Changing this
		 * property to a new value is considered a drastic change to the data
		 * grid's data, so the horizontal and vertical scroll positions will be
		 * reset, and the data grid's selection will be cleared.
		 *
		 * <p>The following example passes in a data provider and columns:</p>
		 *
		 * <listing version="3.0">
		 * grid.dataProvider = new ArrayCollection(
		 * [
		 *     { item: "Chicken breast", dept: "Meat", price: "5.90" },
		 *     { item: "Butter", dept: "Dairy", price: "4.69" },
		 *     { item: "Broccoli", dept: "Produce", price: "2.99" },
		 *     { item: "Whole Wheat Bread", dept: "Bakery", price: "2.49" },
		 * ]);
		 * 
		 * grid.columns = new ArrayCollection(
		 * [
		 *     new DataGridColumn("item", "Item"),
		 *     new DataGridColumn("dept", "Department"),
		 *     new DataGridColumn("price", "Unit Price"),
		 * ]);</listing>
		 *
		 * <p><em>Warning:</em> A data grid's data provider cannot contain
		 * duplicate items. To display the same item in multiple item
		 * renderers, you must create separate objects with the same
		 * properties. This restriction exists because it significantly improves
		 * performance.</p>
		 *
		 * <p><em>Warning:</em> If the data provider contains display objects,
		 * concrete textures, or anything that needs to be disposed, those
		 * objects will not be automatically disposed when the data grid is
		 * disposed. Similar to how <code>starling.display.Image</code> cannot
		 * automatically dispose its texture because the texture may be used
		 * by other display objects, a data grid cannot dispose its data
		 * provider because the data provider may be used by other data grids.
		 * See the <code>dispose()</code> function on
		 * <code>IListCollection</code> to see how the data provider can be
		 * disposed properly.</p>
		 *
		 * @default null
		 *
		 * @see #columns
		 * @see feathers.data.IListCollection#dispose()
		 * @see feathers.data.ArrayCollection
		 * @see feathers.data.VectorCollection
		 * @see feathers.data.XMLListCollection
		 */
		public function get dataProvider():IListCollection
		{
			return this._dataProvider;
		}

		/**
		 * @private
		 */
		public function set dataProvider(value:IListCollection):void
		{
			if(this._dataProvider == value)
			{
				return;
			}
			if(this._dataProvider)
			{
				this._dataProvider.removeEventListener(CollectionEventType.FILTER_CHANGE, dataProvider_filterChangeHandler);
				this._dataProvider.removeEventListener(CollectionEventType.SORT_CHANGE, dataProvider_sortChangeHandler);
				this._dataProvider.removeEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ALL, dataProvider_removeAllHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.removeEventListener(Event.CHANGE, dataProvider_changeHandler);
			}
			this._dataProvider = value;
			if(this._dataProvider)
			{
				this._dataProvider.addEventListener(CollectionEventType.FILTER_CHANGE, dataProvider_filterChangeHandler);
				this._dataProvider.addEventListener(CollectionEventType.SORT_CHANGE, dataProvider_sortChangeHandler);
				this._dataProvider.addEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ALL, dataProvider_removeAllHandler);
				this._dataProvider.addEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.addEventListener(Event.CHANGE, dataProvider_changeHandler);
			}

			//reset the scroll position because this is a drastic change and
			//the data is probably completely different
			this.horizontalScrollPosition = 0;
			this.verticalScrollPosition = 0;

			//clear the selection for the same reason
			this.selectedIndex = -1;

			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _columns:IListCollection = null;

		/**
		 * Defines the columns to display for each item in the data provider.
		 * If <code>null</code>, the data grid will attempt to populate the
		 * columns automatically.
		 *
		 * <p>The following example passes in a data provider and columns:</p>
		 *
		 * <listing version="3.0">
		 * grid.dataProvider = new ArrayCollection(
		 * [
		 *     { item: "Chicken breast", dept: "Meat", price: "5.90" },
		 *     { item: "Butter", dept: "Dairy", price: "4.69" },
		 *     { item: "Broccoli", dept: "Produce", price: "2.99" },
		 *     { item: "Whole Wheat Bread", dept: "Bakery", price: "2.49" },
		 * ]);
		 * 
		 * grid.columns = new ArrayCollection(
		 * [
		 *     new DataGridColumn("item", "Item"),
		 *     new DataGridColumn("dept", "Department"),
		 *     new DataGridColumn("price", "Unit Price"),
		 * ]);</listing>
		 *
		 * @default null
		 *
		 * @see #dataProvider
		 * @see feathers.controls.DataGridColumn
		 */
		public function get columns():IListCollection
		{
			return this._columns;
		}

		/**
		 * @private
		 */
		public function set columns(value:IListCollection):void
		{
			if(this._columns === value)
			{
				return;
			}
			this.setColumns(value);
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function setColumns(value:IListCollection):void
		{
			if(this._columns !== null)
			{
				this._columns.removeEventListener(Event.CHANGE, columns_changeHandler);
				this._columns.removeEventListener(CollectionEventType.RESET, columns_resetHandler);
				this._columns.removeEventListener(CollectionEventType.UPDATE_ALL, columns_updateAllHandler);
			}
			this._columns = value;
			if(this._columns !== null)
			{
				this._columns.addEventListener(Event.CHANGE, columns_changeHandler);
				this._columns.addEventListener(CollectionEventType.RESET, columns_resetHandler);
				this._columns.addEventListener(CollectionEventType.UPDATE_ALL, columns_updateAllHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _isSelectable:Boolean = true;

		/**
		 * Determines if items in the data grid may be selected. By default
		 * only a single item may be selected at any given time. In other
		 * words, if item A is selected, and the user selects item B, item A
		 * will be deselected automatically. Set
		 * <code>allowMultipleSelection</code> to <code>true</code> to select
		 * more than one item without automatically deselecting other items.
		 *
		 * <p>The following example disables selection:</p>
		 *
		 * <listing version="3.0">
		 * grid.isSelectable = false;</listing>
		 *
		 * @default true
		 *
		 * @see #selectedItem
		 * @see #selectedIndex
		 * @see #allowMultipleSelection
		 */
		public function get isSelectable():Boolean
		{
			return this._isSelectable;
		}

		/**
		 * @private
		 */
		public function set isSelectable(value:Boolean):void
		{
			if(this._isSelectable == value)
			{
				return;
			}
			this._isSelectable = value;
			if(!this._isSelectable)
			{
				this.selectedIndex = -1;
			}
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * @private
		 */
		protected var _selectedIndex:int = -1;

		/**
		 * The index of the currently selected item. Returns <code>-1</code> if
		 * no item is selected.
		 *
		 * <p>The following example selects an item by its index:</p>
		 *
		 * <listing version="3.0">
		 * grid.selectedIndex = 2;</listing>
		 *
		 * <p>The following example clears the selected index:</p>
		 *
		 * <listing version="3.0">
		 * grid.selectedIndex = -1;</listing>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected index:</p>
		 *
		 * <listing version="3.0">
		 * function grid_changeHandler( event:Event ):void
		 * {
		 *     var grid:DataGrid = DataGrid( event.currentTarget );
		 *     var index:int = grid.selectedIndex;
		 * 
		 * }
		 * grid.addEventListener( Event.CHANGE, grid_changeHandler );</listing>
		 *
		 * @default -1
		 *
		 * @see #selectedItem
		 * @see #allowMultipleSelection
		 * @see #selectedItems
		 * @see #selectedIndices
		 */
		public function get selectedIndex():int
		{
			return this._selectedIndex;
		}

		/**
		 * @private
		 */
		public function set selectedIndex(value:int):void
		{
			if(this._selectedIndex == value)
			{
				return;
			}
			if(value >= 0)
			{
				this._selectedIndices.data = new <int>[value];
			}
			else
			{
				this._selectedIndices.removeAll();
			}
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * The currently selected item. Returns <code>null</code> if no item is
		 * selected.
		 *
		 * <p>The following example changes the selected item:</p>
		 *
		 * <listing version="3.0">
		 * grid.selectedItem = grid.dataProvider.getItemAt(0);</listing>
		 *
		 * <p>The following example clears the selected item:</p>
		 *
		 * <listing version="3.0">
		 * grid.selectedItem = null;</listing>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected item:</p>
		 *
		 * <listing version="3.0">
		 * function grid_changeHandler( event:Event ):void
		 * {
		 *     var grid:DataGrid = DataGrid( event.currentTarget );
		 *     var item:Object = grid.selectedItem;
		 * 
		 * }
		 * grid.addEventListener( Event.CHANGE, grid_changeHandler );</listing>
		 *
		 * @default null
		 *
		 * @see #selectedIndex
		 * @see #allowMultipleSelection
		 * @see #selectedItems
		 * @see #selectedIndices
		 */
		public function get selectedItem():Object
		{
			if(!this._dataProvider || this._selectedIndex < 0 || this._selectedIndex >= this._dataProvider.length)
			{
				return null;
			}

			return this._dataProvider.getItemAt(this._selectedIndex);
		}

		/**
		 * @private
		 */
		public function set selectedItem(value:Object):void
		{
			if(!this._dataProvider)
			{
				this.selectedIndex = -1;
				return;
			}
			this.selectedIndex = this._dataProvider.getItemIndex(value);
		}

		/**
		 * @private
		 */
		protected var _allowMultipleSelection:Boolean = false;

		/**
		 * If <code>true</code> multiple items may be selected at a time. If
		 * <code>false</code>, then only a single item may be selected at a
		 * time, and if the selection changes, other items are deselected. Has
		 * no effect if <code>isSelectable</code> is <code>false</code>.
		 *
		 * <p>In the following example, multiple selection is enabled:</p>
		 *
		 * <listing version="3.0">
		 * grid.allowMultipleSelection = true;</listing>
		 *
		 * @default false
		 *
		 * @see #isSelectable
		 * @see #selectedIndices
		 * @see #selectedItems
		 */
		public function get allowMultipleSelection():Boolean
		{
			return this._allowMultipleSelection;
		}

		/**
		 * @private
		 */
		public function set allowMultipleSelection(value:Boolean):void
		{
			if(this._allowMultipleSelection == value)
			{
				return;
			}
			this._allowMultipleSelection = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * @private
		 */
		protected var _selectedIndices:ListCollection = new ListCollection(new <int>[]);

		/**
		 * The indices of the currently selected items. Returns an empty <code>Vector.&lt;int&gt;</code>
		 * if no items are selected. If <code>allowMultipleSelection</code> is
		 * <code>false</code>, only one item may be selected at a time.
		 *
		 * <p>The following example selects two items by their indices:</p>
		 *
		 * <listing version="3.0">
		 * grid.selectedIndices = new &lt;int&gt;[ 2, 3 ];</listing>
		 *
		 * <p>The following example clears the selected indices:</p>
		 *
		 * <listing version="3.0">
		 * grid.selectedIndices = null;</listing>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected indices:</p>
		 *
		 * <listing version="3.0">
		 * function grid_changeHandler( event:Event ):void
		 * {
		 *     var grid:DataGrid = DataGrid( event.currentTarget );
		 *     var indices:Vector.&lt;int&gt; = grid.selectedIndices;
		 * 
		 * }
		 * grid.addEventListener( Event.CHANGE, grid_changeHandler );</listing>
		 *
		 * @see #allowMultipleSelection
		 * @see #selectedItems
		 * @see #selectedIndex
		 * @see #selectedItem
		 */
		public function get selectedIndices():Vector.<int>
		{
			return this._selectedIndices.data as Vector.<int>;
		}

		/**
		 * @private
		 */
		public function set selectedIndices(value:Vector.<int>):void
		{
			var oldValue:Vector.<int> = this._selectedIndices.data as Vector.<int>;
			if(oldValue == value)
			{
				return;
			}
			if(!value)
			{
				if(this._selectedIndices.length == 0)
				{
					return;
				}
				this._selectedIndices.removeAll();
			}
			else
			{
				if(!this._allowMultipleSelection && value.length > 0)
				{
					value.length = 1;
				}
				this._selectedIndices.data = value;
			}
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * @private
		 */
		protected var _selectedItems:Vector.<Object> = new <Object>[];

		/**
		 * The currently selected item. The getter returns an empty
		 * <code>Vector.&lt;Object&gt;</code> if no item is selected. If any
		 * items are selected, the getter creates a new
		 * <code>Vector.&lt;Object&gt;</code> to return a list of selected
		 * items.
		 *
		 * <p>The following example selects two items:</p>
		 *
		 * <listing version="3.0">
		 * grid.selectedItems = new &lt;Object&gt;[ grid.dataProvider.getItemAt(2) , grid.dataProvider.getItemAt(3) ];</listing>
		 *
		 * <p>The following example clears the selected items:</p>
		 *
		 * <listing version="3.0">
		 * grid.selectedItems = null;</listing>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected items:</p>
		 *
		 * <listing version="3.0">
		 * function grid_changeHandler( event:Event ):void
		 * {
		 *     var grid:DataGrid = DataGrid( event.currentTarget );
		 *     var items:Vector.&lt;Object&gt; = grid.selectedItems;
		 * 
		 * }
		 * grid.addEventListener( Event.CHANGE, grid_changeHandler );</listing>
		 *
		 * @see #allowMultipleSelection
		 * @see #selectedIndices
		 * @see #selectedIndex
		 * @see #selectedItem
		 */
		public function get selectedItems():Vector.<Object>
		{
			return this._selectedItems;
		}

		/**
		 * @private
		 */
		public function set selectedItems(value:Vector.<Object>):void
		{
			if(!value || !this._dataProvider)
			{
				this.selectedIndex = -1;
				return;
			}
			var indices:Vector.<int> = new <int>[];
			var itemCount:int = value.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = value[i];
				var index:int = this._dataProvider.getItemIndex(item);
				if(index >= 0)
				{
					indices.push(index);
				}
			}
			this.selectedIndices = indices;
		}

		/**
		 * Returns the selected items, with the ability to pass in an optional
		 * result vector. Better for performance than the <code>selectedItems</code>
		 * getter because it can avoid the allocation, and possibly garbage
		 * collection, of the result object.
		 *
		 * @see #selectedItems
		 */
		public function getSelectedItems(result:Vector.<Object> = null):Vector.<Object>
		{
			if(result !== null)
			{
				result.length = 0;
			}
			else
			{
				result = new <Object>[];
			}
			if(!this._dataProvider)
			{
				return result;
			}
			var indexCount:int = this._selectedIndices.length;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = this._selectedIndices.getItemAt(i) as int;
				var item:Object = this._dataProvider.getItemAt(index);
				result[i] = item;
			}
			return result;
		}

		/**
		 * @private
		 */
		protected var _typicalItem:Object = null;

		/**
		 * Used to auto-size the data grid when a virtualized layout is used.
		 * If the data grid's width or height is unknown, the data grid will
		 * try to automatically pick an ideal size. This item is used to create
		 * a sample item renderer to measure item renderers that are virtual
		 * and not visible in the viewport.
		 *
		 * <p>The following example provides a typical item:</p>
		 *
		 * <listing version="3.0">
		 * grid.typicalItem = { text: "A typical item", thumbnail: texture };</listing>
		 *
		 * @default null
		 */
		public function get typicalItem():Object
		{
			return this._typicalItem;
		}

		/**
		 * @private
		 */
		public function set typicalItem(value:Object):void
		{
			if(this._typicalItem == value)
			{
				return;
			}
			this._typicalItem = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _keyScrollDuration:Number = 0.25;

		/**
		 * @private
		 */
		public function get keyScrollDuration():Number
		{
			return this._keyScrollDuration;
		}

		/**
		 * @private
		 */
		public function set keyScrollDuration(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._keyScrollDuration = value;
		}

		/**
		 * @private
		 */
		protected var _headerBackgroundSkin:DisplayObject = null;

		/**
		 * @private
		 */
		public function get headerBackgroundSkin():DisplayObject
		{
			return this._headerBackgroundSkin;
		}

		/**
		 * @private
		 */
		public function set headerBackgroundSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._headerBackgroundSkin === value)
			{
				return;
			}
			this._headerBackgroundSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _headerBackgroundDisabledSkin:DisplayObject = null;

		/**
		 * @private
		 */
		public function get headerBackgroundDisabledSkin():DisplayObject
		{
			return this._headerBackgroundDisabledSkin;
		}

		/**
		 * @private
		 */
		public function set headerBackgroundDisabledSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._headerBackgroundDisabledSkin === value)
			{
				return;
			}
			this._headerBackgroundDisabledSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _verticalDividerFactory:Function = null;

		/**
		 * @private
		 *
		 * @see #style:verticalDividerFactory
		 */
		public function get verticalDividerFactory():Function
		{
			return this._verticalDividerFactory;
		}

		/**
		 * @private
		 */
		public function set verticalDividerFactory(value:Function):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._verticalDividerFactory === value)
			{
				return;
			}
			this._verticalDividerFactory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _headerDividerFactory:Function = null;

		/**
		 * @private
		 *
		 * @see #style:headerDividerFactory
		 */
		public function get headerDividerFactory():Function
		{
			return this._headerDividerFactory;
		}

		/**
		 * @private
		 */
		public function set headerDividerFactory(value:Function):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._headerDividerFactory === value)
			{
				return;
			}
			this._headerDividerFactory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _cellRendererFactory:Function = null;

		/**
		 * Specifies a default factory for cell renderers that will be used if
		 * the <code>cellRendererFactory</code> from a
		 * <code>DataGridColumn</code> is <code>null</code>.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 *
		 * <pre>function():IDataGridCellRenderer</pre>
		 *
		 * <p>The following example provides a factory for the data grid:</p>
		 *
		 * <listing version="3.0">
		 * grid.cellRendererFactory = function():IDataGridCellRenderer
		 * {
		 *     var cellRenderer:CustomCellRendererClass = new CustomCellRendererClass();
		 *     cellRenderer.backgroundSkin = new Quad( 10, 10, 0xff0000 );
		 *     return cellRenderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderers.IDataGridCellRenderer
		 */
		public function get cellRendererFactory():Function
		{
			return this._cellRendererFactory;
		}

		/**
		 * @private
		 */
		public function set cellRendererFactory(value:Function):void
		{
			if(this._cellRendererFactory === value)
			{
				return;
			}
			this._cellRendererFactory = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _customCellRendererStyleName:String = null;

		/**
		 * @private
		 *
		 * @see #style:customCellRendererStyleName
		 */
		public function get customCellRendererStyleName():String
		{
			return this._customCellRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customCellRendererStyleName(value:String):void
		{
			if(this._customCellRendererStyleName === value)
			{
				return;
			}
			this._customCellRendererStyleName = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _headerRendererFactory:Function = null;

		/**
		 * Specifies a default factory for header renderers that will be used if
		 * the <code>headerRendererFactory</code> from a
		 * <code>DataGridColumn</code> is <code>null</code>.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 *
		 * <pre>function():IDataGridHeaderRenderer</pre>
		 *
		 * <p>The following example provides a factory for the data grid:</p>
		 *
		 * <listing version="3.0">
		 * grid.headerRendererFactory = function():IDataGridHeaderRenderer
		 * {
		 *     var headerRenderer:CustomHeaderRendererClass = new CustomHeaderRendererClass();
		 *     headerRenderer.backgroundSkin = new Quad( 10, 10, 0xff0000 );
		 *     return headerRenderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderers.IDataGridHeaderRenderer
		 */
		public function get headerRendererFactory():Function
		{
			return this._headerRendererFactory;
		}

		/**
		 * @private
		 */
		public function set headerRendererFactory(value:Function):void
		{
			if(this._headerRendererFactory === value)
			{
				return;
			}
			this._headerRendererFactory = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _customHeaderRendererStyleName:String = null;

		/**
		 * @private
		 *
		 * @see #style:customHeaderRendererStyleName
		 */
		public function get customHeaderRendererStyleName():String
		{
			return this._customHeaderRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customHeaderRendererStyleName(value:String):void
		{
			if(this._customHeaderRendererStyleName === value)
			{
				return;
			}
			this._customHeaderRendererStyleName = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _draggedHeaderIndex:int = -1;

		/**
		 * @private
		 */
		protected var _headerTouchID:int = -1;

		/**
		 * @private
		 */
		protected var _headerTouchX:Number;

		/**
		 * @private
		 */
		protected var _headerTouchY:Number;

		/**
		 * @private
		 */
		protected var _headerDividerTouchID:int = -1;

		/**
		 * @private
		 */
		protected var _headerDividerTouchX:Number;

		/**
		 * @private
		 */
		protected var _resizingColumnIndex:int = -1;

		/**
		 * @private
		 */
		protected var _customColumnSizes:Vector.<Number> = null;

		/**
		 * The pending item index to scroll to after validating. A value of
		 * <code>-1</code> means that the scroller won't scroll to an item after
		 * validating.
		 */
		protected var pendingItemIndex:int = -1;

		/**
		 * @private
		 */
		override public function scrollToPosition(horizontalScrollPosition:Number, verticalScrollPosition:Number, animationDuration:Number = NaN):void
		{
			this.pendingItemIndex = -1;
			super.scrollToPosition(horizontalScrollPosition, verticalScrollPosition, animationDuration);
		}

		/**
		 * @private
		 */
		override public function scrollToPageIndex(horizontalPageIndex:int, verticalPageIndex:int, animationDuration:Number = NaN):void
		{
			this.pendingItemIndex = -1;
			super.scrollToPageIndex(horizontalPageIndex, verticalPageIndex, animationDuration);
		}

		/**
		 * Scrolls the data grid so that the specified item is visible. If
		 * <code>animationDuration</code> is greater than zero, the scroll will
		 * animate. The duration is in seconds.
		 *
		 * <p>If the layout is virtual with variable item dimensions, this
		 * function may not accurately scroll to the exact correct position. A
		 * virtual layout with variable item dimensions is often forced to
		 * estimate positions, so the results aren't guaranteed to be accurate.</p>
		 *
		 * <p>If you want to scroll to the end of the data grid, it is better
		 * to use <code>scrollToPosition()</code> with
		 * <code>maxHorizontalScrollPosition</code> or
		 * <code>maxVerticalScrollPosition</code>.</p>
		 *
		 * <p>In the following example, the data grid is scrolled to display index 10:</p>
		 *
		 * <listing version="3.0">
		 * grid.scrollToDisplayIndex( 10 );</listing>
		 *
		 * @param index The integer index of an item from the data provider.
		 * @param animationDuration The length of time, in seconds, of the animation. May be zero to scroll instantly.
		 *
		 * @see #scrollToPosition()
		 */
		public function scrollToDisplayIndex(index:int, animationDuration:Number = 0):void
		{
			//cancel any pending scroll to a different page or scroll position.
			//we can have only one type of pending scroll at a time.
			this.hasPendingHorizontalPageIndex = false;
			this.hasPendingVerticalPageIndex = false;
			this.pendingHorizontalScrollPosition = NaN;
			this.pendingVerticalScrollPosition = NaN;
			if(this.pendingItemIndex == index &&
				this.pendingScrollDuration == animationDuration)
			{
				return;
			}
			this.pendingItemIndex = index;
			this.pendingScrollDuration = animationDuration;
			this.invalidate(INVALIDATION_FLAG_PENDING_SCROLL);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this._columnDropIndicatorSkin !== null &&
				this._columnDropIndicatorSkin.parent === null)
			{
				this._columnDropIndicatorSkin.dispose();
				this._columnDropIndicatorSkin = null;
			}
			if(this._columnDragOverlaySkin !== null &&
				this._columnDragOverlaySkin.parent === null)
			{
				this._columnDragOverlaySkin.dispose();
				this._columnDragOverlaySkin = null;
			}
			this.refreshInactiveHeaderDividers(true);
			this.refreshInactiveVerticalDividers(true);
			//clearing selection now so that the data provider setter won't
			//cause a selection change that triggers events.
			this._selectedIndices.removeEventListeners();
			this._selectedIndex = -1;
			this.dataProvider = null;
			this.columns = null;
			this.layout = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			var hasLayout:Boolean = this._layout !== null;

			super.initialize();

			if(!this.dataViewPort)
			{
				this.viewPort = this.dataViewPort = new DataGridDataViewPort();
				this.dataViewPort.owner = this;
				this.viewPort = this.dataViewPort;
			}

			if(this._verticalDividerGroup === null)
			{
				this._verticalDividerGroup = new LayoutGroup();
				this._verticalDividerGroup.touchable = false;
				this.addChild(this._verticalDividerGroup);
			}

			if(this._headerLayout === null)
			{
				this._headerLayout = new HorizontalLayout();
				this._headerLayout.useVirtualLayout = false;
				this._headerLayout.verticalAlign = VerticalAlign.JUSTIFY;
			}

			if(this._headerGroup === null)
			{
				this._headerGroup = new LayoutGroup();
				this.addChild(this._headerGroup);
			}

			this._headerGroup.layout = this._headerLayout;

			if(this._headerDividerGroup === null)
			{
				this._headerDividerGroup = new LayoutGroup();
				this.addChild(this._headerDividerGroup);
			}

			if(!hasLayout)
			{
				if(this._hasElasticEdges &&
					this._verticalScrollPolicy === ScrollPolicy.AUTO &&
					this._scrollBarDisplayMode !== ScrollBarDisplayMode.FIXED)
				{
					//so that the elastic edges work even when the max scroll
					//position is 0, similar to iOS.
					this._verticalScrollPolicy = ScrollPolicy.ON;
				}

				var layout:VerticalLayout = new VerticalLayout();
				layout.useVirtualLayout = true;
				layout.horizontalAlign = HorizontalAlign.JUSTIFY;
				this.ignoreNextStyleRestriction();
				this.layout = layout;
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);

			if(stylesInvalid)
			{
				this.refreshHeaderStyles();
			}

			this.refreshColumns();

			this.refreshHeaderRenderers();
			this.refreshDataViewPortProperties();
			super.draw();
		}

		/**
		 * @inheritDoc
		 */
		override protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			resetFluidChildDimensionsForMeasurement(this.currentBackgroundSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitBackgroundWidth, this._explicitBackgroundHeight,
				this._explicitBackgroundMinWidth, this._explicitBackgroundMinHeight,
				this._explicitBackgroundMaxWidth, this._explicitBackgroundMaxHeight);
			var measureBackground:IMeasureDisplayObject = this.currentBackgroundSkin as IMeasureDisplayObject;
			if(this.currentBackgroundSkin is IValidating)
			{
				IValidating(this.currentBackgroundSkin).validate();
			}

			//we don't measure the header and footer here because they are
			//handled in calculateViewPortOffsets(), which is automatically
			//called by Scroller before autoSizeIfNeeded().

			var newWidth:Number = this._explicitWidth;
			var newHeight:Number = this._explicitHeight;
			var newMinWidth:Number = this._explicitMinWidth;
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsWidth)
			{
				if(this._measureViewPort)
				{
					newWidth = this._viewPort.visibleWidth;
				}
				else
				{
					newWidth = 0;
				}
				newWidth += this._rightViewPortOffset + this._leftViewPortOffset;
				var headerWidth:Number = this._headerGroup.width;
				if(headerWidth > newWidth)
				{
					newWidth = headerWidth;
				}
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.width > newWidth)
				{
					newWidth = this.currentBackgroundSkin.width;
				}
			}
			if(needsHeight)
			{
				if(this._measureViewPort)
				{
					newHeight = this._viewPort.visibleHeight;
				}
				else
				{
					newHeight = 0;
				}
				newHeight += this._bottomViewPortOffset + this._topViewPortOffset;
				//we don't need to account for the header and footer because
				//they're already included in the top and bottom offsets
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.height > newHeight)
				{
					newHeight = this.currentBackgroundSkin.height;
				}
			}
			if(needsMinWidth)
			{
				if(this._measureViewPort)
				{
					newMinWidth = this._viewPort.minVisibleWidth;
				}
				else
				{
					newMinWidth = 0;
				}
				newMinWidth += this._rightViewPortOffset + this._leftViewPortOffset;
				var headerMinWidth:Number = this._headerGroup.minWidth;
				if(headerMinWidth > newMinWidth)
				{
					newMinWidth = headerMinWidth;
				}
				if(this.currentBackgroundSkin !== null)
				{
					if(measureBackground !== null)
					{
						if(measureBackground.minWidth > newMinWidth)
						{
							newMinWidth = measureBackground.minWidth;
						}
					}
					else if(this._explicitBackgroundMinWidth > newMinWidth)
					{
						newMinWidth = this._explicitBackgroundMinWidth;
					}
				}
			}
			if(needsMinHeight)
			{
				if(this._measureViewPort)
				{
					newMinHeight = this._viewPort.minVisibleHeight;
				}
				else
				{
					newMinHeight = 0;
				}
				newMinHeight += this._bottomViewPortOffset + this._topViewPortOffset;
				//we don't need to account for the header and footer because
				//they're already included in the top and bottom offsets
				if(this.currentBackgroundSkin !== null)
				{
					if(measureBackground !== null)
					{
						if(measureBackground.minHeight > newMinHeight)
						{
							newMinHeight = measureBackground.minHeight;
						}
					}
					else if(this._explicitBackgroundMinHeight > newMinHeight)
					{
						newMinHeight = this._explicitBackgroundMinHeight;
					}
				}
			}

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * @private
		 * If the columns are not defined, we can try to create them automatically.
		 */
		protected function refreshColumns():void
		{
			if(this._columns !== null || this._dataProvider === null || this._dataProvider.length == 0)
			{
				return;
			}
			var columns:Array = [];
			var firstItem:Object = this._dataProvider.getItemAt(0);
			var pushIndex:int = 0;
			for(var key:String in firstItem)
			{
				columns[pushIndex] = new DataGridColumn(key);
				pushIndex++;
			}
			this.setColumns(new ArrayCollection(columns));
		}

		/**
		 * @private
		 */
		protected function refreshHeaderStyles():void
		{
			this._headerGroup.backgroundSkin = this._headerBackgroundSkin;
			this._headerGroup.backgroundDisabledSkin = this._headerBackgroundDisabledSkin;
		}

		/**
		 * @private
		 */
		override protected function calculateViewPortOffsets(forceScrollBars:Boolean = false, useActualBounds:Boolean = false):void
		{
			super.calculateViewPortOffsets(forceScrollBars, useActualBounds);

			this._headerLayout.paddingLeft = this._leftViewPortOffset;
			this._headerLayout.paddingRight = this._rightViewPortOffset;
			if(useActualBounds)
			{
				this._headerGroup.width = this.actualWidth;
				this._headerGroup.minWidth = this.actualMinWidth;
			}
			else
			{
				this._headerGroup.width = this._explicitWidth;
				this._headerGroup.minWidth = this._explicitMinWidth;
			}
			this._headerGroup.maxWidth = this._explicitMaxWidth;
			this._headerGroup.validate();
			this._topViewPortOffset += this._headerGroup.height;
		}

		/**
		 * @private
		 */
		override protected function layoutChildren():void
		{
			this.validateCustomColumnSizes();
			this.layoutHeaderRenderers();

			this._headerLayout.paddingLeft = this._leftViewPortOffset;
			this._headerLayout.paddingRight = this._rightViewPortOffset;
			this._headerGroup.width = this.actualWidth;
			this._headerGroup.validate();
			this._headerGroup.x = 0;
			this._headerGroup.y = this._topViewPortOffset - this._headerGroup.height;
			this._headerDividerGroup.x = this._headerGroup.x;
			this._headerDividerGroup.y = this._headerGroup.y;
			this._headerDividerGroup.width = this._headerGroup.width;

			super.layoutChildren();

			this._verticalDividerGroup.x = this._headerGroup.x;
			this._verticalDividerGroup.y = this._headerGroup.y + this._headerGroup.height;
			this._verticalDividerGroup.width = this._headerGroup.width;
			this._verticalDividerGroup.height = this.viewPort.visibleHeight;

			this.refreshHeaderDividers();
			this.refreshVerticalDividers();
		}

		/**
		 * @private
		 */
		protected function validateCustomColumnSizes():void
		{
			if(this._customColumnSizes === null || this._customColumnSizes.length < this._columns.length)
			{
				return;
			}

			var availableWidth:Number = this.actualWidth - this._leftViewPortOffset - this._rightViewPortOffset;
			var count:int = this._customColumnSizes.length;
			var totalWidth:Number = 0;
			var indices:Vector.<int> = new <int>[];
			var currentIndex:int = 0;
			for(var i:int = 0; i < count; i++)
			{
				var column:DataGridColumn = DataGridColumn(this._columns.getItemAt(i));
				if(column.width === column.width) //!isNaN
				{
					//if the width is set explicitly, skip it!
					availableWidth -= column.width;
					continue;
				}
				var size:Number = this._customColumnSizes[i];
				totalWidth += size;
				indices[currentIndex] = i;
				currentIndex++;
			}
			if(totalWidth == availableWidth)
			{
				return;
			}

			//make a copy so that this is detected as a change
			this._customColumnSizes = this._customColumnSizes.slice();

			var widthToDistribute:Number = availableWidth - totalWidth;
			this.distributeWidthToIndices(widthToDistribute, indices, totalWidth);
			this.dataViewPort.customColumnSizes = this._customColumnSizes;
		}

		/**
		 * @private
		 */
		protected function distributeWidthToIndices(widthToDistribute:Number, indices:Vector.<int>, totalWidthOfIndices:Number):void
		{
			while(Math.abs(widthToDistribute) > 1)
			{
				//this will be the store value if we need to loop again
				var nextWidthToDistribute:Number = widthToDistribute;
				var count:int = indices.length;
				for(var i:int = count - 1; i >= 0; i--)
				{
					var index:int = indices[i];
					var headerRenderer:IDataGridHeaderRenderer = IDataGridHeaderRenderer(this._headerGroup.getChildAt(index));
					var columnWidth:Number = headerRenderer.width;
					var column:DataGridColumn = DataGridColumn(this._columns.getItemAt(index));
					var percent:Number = columnWidth / totalWidthOfIndices;
					var offset:Number = widthToDistribute * percent;
					var newWidth:Number = this._customColumnSizes[index] + offset;
					if(newWidth < column.minWidth)
					{
						offset += (column.minWidth - newWidth);
						newWidth = column.minWidth;
						//we've hit the minimum, so skip it if we loop again
						indices.removeAt(i);
						//also readjust the total to exclude this column
						//so that the percentages still add up to 100%
						totalWidthOfIndices -= columnWidth;
					}
					this._customColumnSizes[index] = newWidth;
					nextWidthToDistribute -= offset;
				}
				widthToDistribute = nextWidthToDistribute;
			}

			if(widthToDistribute != 0)
			{
				//if we have less than a pixel left, just add it to the
				//final column and exit the loop
				this._customColumnSizes[this._customColumnSizes.length - 1] += widthToDistribute;
			}
		}

		/**
		 * @private
		 */
		protected function layoutHeaderRenderers():void
		{
			var columnCount:int = 0;
			if(this._columns !== null)
			{
				columnCount = this._columns.length;
			}
			for(var i:int = 0; i < columnCount; i++)
			{
				var headerRenderer:IDataGridHeaderRenderer = IDataGridHeaderRenderer(this._headerGroup.getChildAt(i));
				var column:DataGridColumn = DataGridColumn(this._columns.getItemAt(i));
				if(column.width === column.width) //!isNaN
				{
					headerRenderer.width = column.width;
					headerRenderer.layoutData = null;
				}
				else if(this._customColumnSizes !== null && i < this._customColumnSizes.length)
				{
					headerRenderer.width = this._customColumnSizes[i];
					headerRenderer.layoutData = null;
				}
				else if(headerRenderer.layoutData === null)
				{
					headerRenderer.layoutData = new HorizontalLayoutData(100);
				}
				headerRenderer.minWidth = column.minWidth;
			}
		}

		/**
		 * @private
		 */
		protected function refreshVerticalDividers():void
		{
			this.refreshInactiveVerticalDividers(this._verticalDividerStorage.factory !== this._verticalDividerFactory);
			this._verticalDividerStorage.factory = this._verticalDividerFactory;

			var columnCount:int = 0;
			if(this._columns !== null)
			{
				columnCount = this._columns.length;
			}
			var dividerCount:int = 0;
			if(this._verticalDividerFactory !== null)
			{
				dividerCount = columnCount - 1;
			}

			this._headerGroup.validate();
			var activeDividers:Vector.<DisplayObject> = this._verticalDividerStorage.activeDividers;
			var inactiveDividers:Vector.<DisplayObject> = this._verticalDividerStorage.inactiveDividers;
			for(var i:int = 0; i < dividerCount; i++)
			{
				var verticalDivider:DisplayObject = null;
				if(inactiveDividers.length > 0)
				{
					verticalDivider = inactiveDividers.shift();
					this._verticalDividerGroup.setChildIndex(verticalDivider, i);
				}
				else
				{
					verticalDivider = DisplayObject(this._verticalDividerFactory());
					this._verticalDividerGroup.addChildAt(verticalDivider, i);
				}
				activeDividers[i] = verticalDivider;
				verticalDivider.height = this._viewPort.visibleHeight;
				if(verticalDivider is IValidating)
				{
					IValidating(verticalDivider).validate();
				}
				var headerRenderer:IDataGridHeaderRenderer = IDataGridHeaderRenderer(this._headerGroup.getChildAt(i));
				verticalDivider.x = headerRenderer.x + headerRenderer.width - (verticalDivider.width / 2);
				verticalDivider.y = 0;
			}
			this.freeInactiveVerticalDividers();
		}

		/**
		 * @private
		 */
		protected function refreshInactiveVerticalDividers(forceCleanup:Boolean):void
		{
			var temp:Vector.<DisplayObject> = this._verticalDividerStorage.inactiveDividers;
			this._verticalDividerStorage.inactiveDividers = this._verticalDividerStorage.activeDividers;
			this._verticalDividerStorage.activeDividers = temp;
			if(forceCleanup)
			{
				this.freeInactiveVerticalDividers();
			}
		}

		/**
		 * @private
		 */
		protected function freeInactiveVerticalDividers():void
		{
			var inactiveDividers:Vector.<DisplayObject> = this._verticalDividerStorage.inactiveDividers;
			var dividerCount:int = inactiveDividers.length;
			for(var i:int = 0; i < dividerCount; i++)
			{
				var verticalDivider:DisplayObject = inactiveDividers.shift();
				verticalDivider.removeFromParent(true);
			}
		}

		/**
		 * @private
		 */
		protected function refreshHeaderDividers():void
		{
			this.refreshInactiveHeaderDividers(this._headerDividerStorage.factory !== this._headerDividerFactory);
			this._headerDividerStorage.factory = this._headerDividerFactory;

			var dividerCount:int = 0;
			if(this._columns !== null)
			{
				dividerCount = this._columns.length;
				if(this._scrollBarDisplayMode !== ScrollBarDisplayMode.FIXED ||
					this._minVerticalScrollPosition == this._maxVerticalScrollPosition)
				{
					dividerCount--;
				}
			}

			this._headerGroup.validate();
			var activeDividers:Vector.<DisplayObject> = this._headerDividerStorage.activeDividers;
			var inactiveDividers:Vector.<DisplayObject> = this._headerDividerStorage.inactiveDividers;
			for(var i:int = 0; i < dividerCount; i++)
			{
				var headerDivider:DisplayObject = null;
				if(inactiveDividers.length > 0)
				{
					headerDivider = inactiveDividers.shift();
					this._headerDividerGroup.setChildIndex(headerDivider, i);
				}
				else if(this._headerDividerFactory !== null)
				{
					headerDivider = DisplayObject(this._headerDividerFactory());
					headerDivider.addEventListener(TouchEvent.TOUCH, headerDivider_touchHandler);
					this._headerDividerGroup.addChildAt(headerDivider, i);
				}
				else
				{
					headerDivider = new Quad(3, 1, 0xff00ff);
					headerDivider.alpha = 0;
					if(!SystemUtil.isDesktop)
					{
						headerDivider.width = 22;
					}
					headerDivider.addEventListener(TouchEvent.TOUCH, headerDivider_touchHandler);
					this._headerDividerGroup.addChildAt(headerDivider, i);
				}
				activeDividers[i] = headerDivider;
				var headerRenderer:IDataGridHeaderRenderer = IDataGridHeaderRenderer(this._headerGroup.getChildAt(i));
				headerDivider.height = headerRenderer.height;
				if(headerDivider is IValidating)
				{
					IValidating(headerDivider).validate();
				}
				headerDivider.x = headerRenderer.x + headerRenderer.width - (headerDivider.width / 2);
				headerDivider.y = headerRenderer.y;
			}
			this.freeInactiveHeaderDividers();
		}

		/**
		 * @private
		 */
		protected function refreshInactiveHeaderDividers(forceCleanup:Boolean):void
		{
			var temp:Vector.<DisplayObject> = this._headerDividerStorage.inactiveDividers;
			this._headerDividerStorage.inactiveDividers = this._headerDividerStorage.activeDividers;
			this._headerDividerStorage.activeDividers = temp;
			if(forceCleanup)
			{
				this.freeInactiveHeaderDividers();
			}
		}

		/**
		 * @private
		 */
		protected function freeInactiveHeaderDividers():void
		{
			var inactiveDividers:Vector.<DisplayObject> = this._headerDividerStorage.inactiveDividers;
			var dividerCount:int = inactiveDividers.length;
			for(var i:int = 0; i < dividerCount; i++)
			{
				var headerDivider:DisplayObject = inactiveDividers.shift();
				headerDivider.removeEventListener(TouchEvent.TOUCH, headerDivider_touchHandler);
				headerDivider.removeFromParent(true);
			}
		}

		/**
		 * @private
		 */
		protected function refreshHeaderRenderers():void
		{
			this.findUnrenderedData();
			this.recoverInactiveHeaderRenderers();
			this.renderUnrenderedData();
			this.freeInactiveHeaderRenderers();
			this._updateForDataReset = false;
		}

		/**
		 * @private
		 */
		protected function findUnrenderedData():void
		{
			var temp:Vector.<IDataGridHeaderRenderer> = this._headerStorage.inactiveHeaderRenderers;
			this._headerStorage.inactiveHeaderRenderers = this._headerStorage.activeHeaderRenderers;
			this._headerStorage.activeHeaderRenderers = temp;

			var activeHeaderRenderers:Vector.<IDataGridHeaderRenderer> = this._headerStorage.activeHeaderRenderers;
			var inactiveHeaderRenderers:Vector.<IDataGridHeaderRenderer> = this._headerStorage.inactiveHeaderRenderers;

			var columnCount:int = 0;
			if(this._columns !== null)
			{
				columnCount = this._columns.length;
			}

			var activePushIndex:int = activeHeaderRenderers.length;
			var unrenderedDataLastIndex:int = this._unrenderedHeaders.length;
			for(var i:int = 0; i < columnCount; i++)
			{
				var column:DataGridColumn = DataGridColumn(this._columns.getItemAt(i));
				var headerRenderer:IDataGridHeaderRenderer = this._headerRendererMap[column] as IDataGridHeaderRenderer;
				if(headerRenderer !== null)
				{
					headerRenderer.columnIndex = i;
					headerRenderer.visible = true;
					if(column === this._sortedColumn)
					{
						if(this._reverseSort)
						{
							headerRenderer.sortOrder = SortOrder.DESCENDING;
						}
						else
						{
							headerRenderer.sortOrder = SortOrder.ASCENDING;
						}
					}
					else
					{
						headerRenderer.sortOrder = SortOrder.NONE;
					}
					this._headerGroup.setChildIndex(DisplayObject(headerRenderer), i);
					if(this._updateForDataReset)
					{
						//similar to calling updateItemAt(), replacing the data
						//provider or resetting its source means that we should
						//trick the item renderer into thinking it has new data.
						//many developers seem to expect this behavior, so while
						//it's not the most optimal for performance, it saves on
						//support time in the forums. thankfully, it's still
						//somewhat optimized since the same item renderer will
						//receive the same data, and the children generally
						//won't have changed much, if at all.
						headerRenderer.data = null;
						headerRenderer.data = column;
					}
					activeHeaderRenderers[activePushIndex] = headerRenderer;
					activePushIndex++;

					var inactiveIndex:int = inactiveHeaderRenderers.indexOf(headerRenderer);
					if(inactiveIndex >= 0)
					{
						inactiveHeaderRenderers[inactiveIndex] = null;
					}
					else
					{
						throw new IllegalOperationError("DataGrid: header renderer map contains bad data. This may be caused by duplicate items in the columns collection, which is not allowed.");
					}
				}
				else
				{
					this._unrenderedHeaders[unrenderedDataLastIndex] = i;
					unrenderedDataLastIndex++;
				}
			}
		}

		/**
		 * @private
		 */
		protected function recoverInactiveHeaderRenderers():void
		{
			var inactiveHeaderRenderers:Vector.<IDataGridHeaderRenderer> = this._headerStorage.inactiveHeaderRenderers;
			var count:int = inactiveHeaderRenderers.length;
			for(var i:int = 0; i < count; i++)
			{
				var headerRenderer:IDataGridHeaderRenderer = inactiveHeaderRenderers[i];
				if(headerRenderer === null || headerRenderer.data === null)
				{
					continue;
				}
				this.dispatchEventWith(FeathersEventType.RENDERER_REMOVE, false, headerRenderer);
				delete this._headerRendererMap[headerRenderer.data];
			}
		}

		/**
		 * @private
		 */
		protected function renderUnrenderedData():void
		{
			var headerRendererCount:int = this._unrenderedHeaders.length;
			for(var i:int = 0; i < headerRendererCount; i++)
			{
				var columnIndex:int = this._unrenderedHeaders.shift();
				var column:DataGridColumn = DataGridColumn(this._columns.getItemAt(columnIndex));
				this.createHeaderRenderer(column, columnIndex);
			}
		}

		/**
		 * @private
		 */
		protected function freeInactiveHeaderRenderers():void
		{
			var inactiveHeaderRenderers:Vector.<IDataGridHeaderRenderer> = this._headerStorage.inactiveHeaderRenderers;
			var count:int = inactiveHeaderRenderers.length;
			for(var i:int = 0; i < count; i++)
			{
				var headerRenderer:IDataGridHeaderRenderer = inactiveHeaderRenderers.shift();
				if(headerRenderer === null)
				{
					continue;
				}
				this.destroyHeaderRenderer(headerRenderer);
			}
		}

		/**
		 * @private
		 */
		protected function createHeaderRenderer(column:DataGridColumn, columnIndex:int):IDataGridHeaderRenderer
		{
			var headerRendererFactory:Function = column.headerRendererFactory;
			if(headerRendererFactory === null)
			{
				headerRendererFactory = this._headerRendererFactory;
			}
			if(headerRendererFactory === null)
			{
				headerRendererFactory = defaultHeaderRendererFactory;
			}
			var customHeaderRendererStyleName:String = column.customHeaderRendererStyleName;
			if(customHeaderRendererStyleName === null)
			{
				customHeaderRendererStyleName = this._customHeaderRendererStyleName;
			}
			var inactiveHeaderRenderers:Vector.<IDataGridHeaderRenderer> = this._headerStorage.inactiveHeaderRenderers;
			var activeHeaderRenderers:Vector.<IDataGridHeaderRenderer> = this._headerStorage.activeHeaderRenderers;
			var headerRenderer:IDataGridHeaderRenderer = null;
			do
			{
				if(inactiveHeaderRenderers.length == 0)
				{
					headerRenderer = IDataGridHeaderRenderer(headerRendererFactory());
					headerRenderer.addEventListener(TouchEvent.TOUCH, headerRenderer_touchHandler);
					headerRenderer.addEventListener(Event.TRIGGERED, headerRenderer_triggeredHandler);
					if(customHeaderRendererStyleName !== null && customHeaderRendererStyleName.length > 0)
					{
						headerRenderer.styleNameList.add(customHeaderRendererStyleName);
					}
					this._headerGroup.addChild(DisplayObject(headerRenderer));
				}
				else
				{
					headerRenderer = inactiveHeaderRenderers.shift();
				}
			}
			while(headerRenderer === null);
			headerRenderer.data = column;
			headerRenderer.columnIndex = columnIndex;
			headerRenderer.owner = this;

			this._headerRendererMap[column] = headerRenderer;
			activeHeaderRenderers[activeHeaderRenderers.length] = headerRenderer;
			this.dispatchEventWith(FeathersEventType.RENDERER_ADD, false, headerRenderer);

			column.addEventListener(Event.CHANGE, column_changeHandler);

			return headerRenderer;
		}

		/**
		 * @private
		 */
		protected function destroyHeaderRenderer(headerRenderer:IDataGridHeaderRenderer):void
		{
			if(headerRenderer.data !== null)
			{
				headerRenderer.data.removeEventListener(Event.CHANGE, column_changeHandler);
			}
			headerRenderer.removeEventListener(Event.TRIGGERED, headerRenderer_triggeredHandler);
			headerRenderer.removeEventListener(TouchEvent.TOUCH, headerRenderer_touchHandler);
			headerRenderer.owner = null;
			headerRenderer.data = null;
			headerRenderer.columnIndex = -1;
			this._headerGroup.removeChild(DisplayObject(headerRenderer), true);
		}

		/**
		 * @private
		 */
		protected function refreshDataViewPortProperties():void
		{
			this.dataViewPort.isSelectable = this._isSelectable;
			this.dataViewPort.allowMultipleSelection = this._allowMultipleSelection;
			this.dataViewPort.selectedIndices = this._selectedIndices;
			this.dataViewPort.dataProvider = this._dataProvider;
			this.dataViewPort.columns = this._columns;
			this.dataViewPort.typicalItem = this._typicalItem;
			this.dataViewPort.layout = this._layout;
			this.dataViewPort.customColumnSizes = this._customColumnSizes;
		}

		/**
		 * @private
		 */
		override protected function handlePendingScroll():void
		{
			if(this.pendingItemIndex >= 0)
			{
				var item:Object = null;
				if(this._dataProvider !== null)
				{
					item = this._dataProvider.getItemAt(this.pendingItemIndex);
				}
				if(item is Object)
				{
					var point:Point = Pool.getPoint();
					this.dataViewPort.getScrollPositionForIndex(this.pendingItemIndex, point);
					this.pendingItemIndex = -1;

					var targetHorizontalScrollPosition:Number = point.x;
					var targetVerticalScrollPosition:Number = point.y;
					Pool.putPoint(point);
					if(targetHorizontalScrollPosition < this._minHorizontalScrollPosition)
					{
						targetHorizontalScrollPosition = this._minHorizontalScrollPosition;
					}
					else if(targetHorizontalScrollPosition > this._maxHorizontalScrollPosition)
					{
						targetHorizontalScrollPosition = this._maxHorizontalScrollPosition;
					}
					if(targetVerticalScrollPosition < this._minVerticalScrollPosition)
					{
						targetVerticalScrollPosition = this._minVerticalScrollPosition;
					}
					else if(targetVerticalScrollPosition > this._maxVerticalScrollPosition)
					{
						targetVerticalScrollPosition = this._maxVerticalScrollPosition;
					}
					this.throwTo(targetHorizontalScrollPosition, targetVerticalScrollPosition, this.pendingScrollDuration);
				}
			}
			super.handlePendingScroll();
		}

		/**
		 * @private
		 */
		protected function column_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		override protected function nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(!this._isSelectable)
			{
				//not selectable, but should scroll
				super.nativeStage_keyDownHandler(event);
				return;
			}
			if(event.isDefaultPrevented())
			{
				return;
			}
			if(!this._dataProvider)
			{
				return;
			}
			if(this._selectedIndex != -1 && (event.keyCode == Keyboard.SPACE ||
				((event.keyLocation == 4 || DeviceCapabilities.simulateDPad) && event.keyCode == Keyboard.ENTER)))
			{
				this.dispatchEventWith(Event.TRIGGERED, false, this.selectedItem);
			}
			if(event.keyCode == Keyboard.HOME || event.keyCode == Keyboard.END ||
				event.keyCode == Keyboard.PAGE_UP || event.keyCode == Keyboard.PAGE_DOWN ||
				event.keyCode == Keyboard.UP || event.keyCode == Keyboard.DOWN ||
				event.keyCode == Keyboard.LEFT || event.keyCode == Keyboard.RIGHT)
			{
				var newIndex:int = this.dataViewPort.calculateNavigationDestination(this.selectedIndex, event.keyCode);
				if(this.selectedIndex != newIndex)
				{
					event.preventDefault();
					this.selectedIndex = newIndex;
					var point:Point = Pool.getPoint();
					this.dataViewPort.getNearestScrollPositionForIndex(this.selectedIndex, point);
					this.scrollToPosition(point.x, point.y, this._keyScrollDuration);
					Pool.putPoint(point);
				}
			}
		}

		/**
		 * @private
		 */
		override protected function stage_gestureDirectionalTapHandler(event:TransformGestureEvent):void
		{
			if(event.isDefaultPrevented())
			{
				//something else has already handled this event
				return;
			}
			var keyCode:uint = int.MAX_VALUE;
			if(event.offsetY < 0)
			{
				keyCode = Keyboard.UP;
			}
			else if(event.offsetY > 0)
			{
				keyCode = Keyboard.DOWN;
			}
			else if(event.offsetX > 0)
			{
				keyCode = Keyboard.RIGHT;
			}
			else if(event.offsetX < 0)
			{
				keyCode = Keyboard.LEFT;
			}
			if(keyCode == int.MAX_VALUE)
			{
				return;
			}
			var newIndex:int = this.dataViewPort.calculateNavigationDestination(this.selectedIndex, keyCode);
			if(this.selectedIndex != newIndex)
			{
				event.stopImmediatePropagation();
				//event.preventDefault();
				this.selectedIndex = newIndex;
				var point:Point = Pool.getPoint();
				this.dataViewPort.getNearestScrollPositionForIndex(this.selectedIndex, point);
				this.scrollToPosition(point.x, point.y, this._keyScrollDuration);
				Pool.putPoint(point);
			}
		}

		/**
		 * @private
		 */
		protected function columns_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function columns_resetHandler(event:Event):void
		{
			this._updateForDataReset = true;
		}

		/**
		 * @private
		 */
		protected function columns_updateAllHandler(event:Event):void
		{
			//we're treating this similar to the RESET event because enough
			//users are treating UPDATE_ALL similarly. technically, UPDATE_ALL
			//is supposed to affect only existing items, but it's confusing when
			//new items are added and not displayed.
			this._updateForDataReset = true;
		}

		/**
		 * @private
		 */
		protected function dataProvider_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function dataProvider_resetHandler(event:Event):void
		{
			this.horizontalScrollPosition = 0;
			this.verticalScrollPosition = 0;

			//the entire data provider was replaced. select no item.
			this._selectedIndices.removeAll();
		}

		/**
		 * @private
		 */
		protected function dataProvider_addItemHandler(event:Event, index:int):void
		{
			if(this._selectedIndex == -1)
			{
				return;
			}
			var selectionChanged:Boolean = false;
			var newIndices:Vector.<int> = new <int>[];
			var indexCount:int = this._selectedIndices.length;
			for(var i:int = 0; i < indexCount; i++)
			{
				var currentIndex:int = this._selectedIndices.getItemAt(i) as int;
				if(currentIndex >= index)
				{
					currentIndex++;
					selectionChanged = true;
				}
				newIndices.push(currentIndex);
			}
			if(selectionChanged)
			{
				this._selectedIndices.data = newIndices;
			}
		}

		/**
		 * @private
		 */
		protected function dataProvider_removeAllHandler(event:Event):void
		{
			this.selectedIndex = -1;
		}

		/**
		 * @private
		 */
		protected function dataProvider_removeItemHandler(event:Event, index:int):void
		{
			if(this._selectedIndex == -1)
			{
				return;
			}
			var selectionChanged:Boolean = false;
			var newIndices:Vector.<int> = new <int>[];
			var indexCount:int = this._selectedIndices.length;
			for(var i:int = 0; i < indexCount; i++)
			{
				var currentIndex:int = this._selectedIndices.getItemAt(i) as int;
				if(currentIndex == index)
				{
					selectionChanged = true;
				}
				else
				{
					if(currentIndex > index)
					{
						currentIndex--;
						selectionChanged = true;
					}
					newIndices.push(currentIndex);
				}
			}
			if(selectionChanged)
			{
				this._selectedIndices.data = newIndices;
			}
		}

		/**
		 * @private
		 */
		protected function refreshSelectedIndicesAfterFilterOrSort():void
		{
			if(this._selectedIndex == -1)
			{
				return;
			}
			var selectionChanged:Boolean = false;
			var newIndices:Vector.<int> = new <int>[];
			var pushIndex:int = 0;
			var count:int = this._selectedItems.length;
			for(var i:int = 0; i < count; i++)
			{
				var selectedItem:Object = this._selectedItems[i];
				var oldIndex:int = this._selectedIndices.getItemAt(i) as int;
				var newIndex:int = this._dataProvider.getItemIndex(selectedItem);
				if(newIndex >= 0)
				{
					if(newIndex != oldIndex)
					{
						//the item was not filtered, but it moved to a new index
						selectionChanged = true;
					}
					newIndices[pushIndex] = newIndex;
					pushIndex++;
				}
				else
				{
					//the item is filtered, so it should not be selected
					selectionChanged = true;
				}
			}
			if(selectionChanged)
			{
				this._selectedIndices.data = newIndices;
			}
		}

		/**
		 * @private
		 */
		protected function dataProvider_sortChangeHandler(event:Event):void
		{
			this.refreshSelectedIndicesAfterFilterOrSort();
		}

		/**
		 * @private
		 */
		protected function dataProvider_filterChangeHandler(event:Event):void
		{
			this.refreshSelectedIndicesAfterFilterOrSort();
		}

		/**
		 * @private
		 */
		protected function dataProvider_replaceItemHandler(event:Event, index:int):void
		{
			if(this._selectedIndex == -1)
			{
				return;
			}
			var indexOfIndex:int = this._selectedIndices.getItemIndex(index);
			if(indexOfIndex >= 0)
			{
				this._selectedIndices.removeItemAt(indexOfIndex);
			}
		}

		/**
		 * @private
		 */
		protected function selectedIndices_changeHandler(event:Event):void
		{
			this.getSelectedItems(this._selectedItems);
			if(this._selectedIndices.length > 0)
			{
				this._selectedIndex = this._selectedIndices.getItemAt(0) as int;
			}
			else
			{
				if(this._selectedIndex < 0)
				{
					//no change
					return;
				}
				this._selectedIndex = -1;
			}
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected function layout_scrollHandler(event:Event, scrollOffset:Point):void
		{
			var layout:IVariableVirtualLayout = IVariableVirtualLayout(this._layout);
			if(!this.isScrolling || !layout.useVirtualLayout || !layout.hasVariableItemDimensions)
			{
				return;
			}

			var scrollOffsetX:Number = scrollOffset.x;
			this._startHorizontalScrollPosition += scrollOffsetX;
			this._horizontalScrollPosition += scrollOffsetX;
			if(this._horizontalAutoScrollTween)
			{
				this._targetHorizontalScrollPosition += scrollOffsetX;
				this.throwTo(this._targetHorizontalScrollPosition, NaN, this._horizontalAutoScrollTween.totalTime - this._horizontalAutoScrollTween.currentTime);
			}

			var scrollOffsetY:Number = scrollOffset.y;
			this._startVerticalScrollPosition += scrollOffsetY;
			this._verticalScrollPosition += scrollOffsetY;
			if(this._verticalAutoScrollTween)
			{
				this._targetVerticalScrollPosition += scrollOffsetY;
				this.throwTo(NaN, this._targetVerticalScrollPosition, this._verticalAutoScrollTween.totalTime - this._verticalAutoScrollTween.currentTime);
			}
		}

		/**
		 * @private
		 */
		protected function headerRenderer_triggeredHandler(event:Event):void
		{
			var headerRenderer:IDataGridHeaderRenderer = IDataGridHeaderRenderer(event.currentTarget);
			var column:DataGridColumn = headerRenderer.data;
			if(!this._sortableColumns || column.sortOrder === SortOrder.NONE)
			{
				return;
			}
			if(this._sortedColumn != column)
			{
				this._sortedColumn = column;
				this._reverseSort = column.sortOrder === SortOrder.DESCENDING;
			}
			else
			{
				this._reverseSort = !this._reverseSort;
			}
			if(this._reverseSort)
			{
				this._dataProvider.sortCompareFunction = this.reverseSortCompareFunction;
			}
			else
			{
				this._dataProvider.sortCompareFunction = this.sortCompareFunction;
			}
			//the sortCompareFunction might not have changed if we're sorting a
			//different column, so force a refresh.
			this._dataProvider.refresh();
		}

		/**
		 * @private
		 */
		protected var _reverseSort:Boolean = false;

		/**
		 * @private
		 */
		protected var _sortedColumn:DataGridColumn = null;

		/**
		 * @private
		 */
		protected function reverseSortCompareFunction(a:Object, b:Object):int
		{
			return -this.sortCompareFunction(a, b);
		}

		/**
		 * @private
		 */
		protected function sortCompareFunction(a:Object, b:Object):int
		{
			var aField:Object = a[this._sortedColumn.dataField];
			var bField:Object = b[this._sortedColumn.dataField];
			var sortCompareFunction:Function = this._sortedColumn.sortCompareFunction;
			if(sortCompareFunction === null)
			{
				sortCompareFunction = defaultSortCompareFunction;
			}
			return sortCompareFunction(aField, bField);
		}

		/**
		 * @private
		 */
		protected function dataGrid_touchHandler(event:TouchEvent):void
		{
			if(this._headerTouchID != -1)
			{
				//a touch has begun, so we'll ignore all other touches.
				var touch:Touch = event.getTouch(this, null, this._headerTouchID);
				if(touch === null)
				{
					//this should not happen.
					return;
				}

				if(touch.phase === TouchPhase.ENDED)
				{
					this.removeEventListener(TouchEvent.TOUCH, dataGrid_touchHandler);
					//these might be null if there was no TouchPhase.MOVED
					if(this._currentColumnDropIndicatorSkin !== null)
					{
						this._currentColumnDropIndicatorSkin.removeFromParent(this._currentColumnDropIndicatorSkin !== this._columnDropIndicatorSkin);
						this._currentColumnDropIndicatorSkin = null;
					}
					if(this._currentColumnDragOverlaySkin !== null)
					{
						this._currentColumnDragOverlaySkin.removeFromParent(this._currentColumnDragOverlaySkin !== this._columnDragOverlaySkin);
						this._currentColumnDragOverlaySkin = null;
					}
					this._headerTouchID = -1;
				}
			}
		}

		/**
		 * @private
		 */
		protected function headerRenderer_touchHandler(event:TouchEvent):void
		{
			var headerRenderer:IDataGridHeaderRenderer = IDataGridHeaderRenderer(event.currentTarget);
			if(!this._isEnabled)
			{
				this._headerTouchID = -1;
				return;
			}
			if(this._headerTouchID != -1)
			{
				//a touch has begun, so we'll ignore all other touches.
				var touch:Touch = event.getTouch(DisplayObject(headerRenderer), null, this._headerTouchID);
				if(touch === null)
				{
					//this should not happen.
					return;
				}

				if(touch.phase === TouchPhase.MOVED)
				{
					if(!DragDropManager.isDragging && this._reorderColumns)
					{
						var column:DataGridColumn = DataGridColumn(this._columns.getItemAt(headerRenderer.columnIndex));
						var dragData:DragData = new DragData();
						dragData.setDataForFormat(DATA_GRID_HEADER_DRAG_FORMAT, column);
						var self:DataGrid = this;
						var avatar:RenderDelegate = new RenderDelegate(DisplayObject(headerRenderer));
						avatar.alpha = this._columnDragAvatarAlpha;
						DragDropManager.startDrag(this, touch, dragData, avatar);
						if(this._columnDropIndicatorSkin === null)
						{
							this._currentColumnDropIndicatorSkin = new Quad(1, 1, 0x000000);
						}
						if(this._columnDropIndicatorSkin !== null)
						{
							this._currentColumnDropIndicatorSkin = this._columnDropIndicatorSkin;
						}
						//start out invisible and TouchPhase.MOVED will reveal it, if necessary
						this._currentColumnDropIndicatorSkin.visible = false;
						this.addChild(this._currentColumnDropIndicatorSkin);

						if(this._columnDragOverlaySkin === null)
						{
							this._currentColumnDragOverlaySkin = new Quad(1, 1, 0xff00ff);
							this._currentColumnDragOverlaySkin.alpha = 0;
						}
						else
						{
							this._currentColumnDragOverlaySkin = this._columnDragOverlaySkin;
						}
						this._currentColumnDragOverlaySkin.x = this._headerGroup.x + headerRenderer.x;
						this._currentColumnDragOverlaySkin.y = this._headerGroup.y + headerRenderer.y;
						this._currentColumnDragOverlaySkin.width = headerRenderer.width;
						this._currentColumnDragOverlaySkin.height = this._viewPort.y + this._viewPort.visibleHeight - this._headerGroup.y;
						this.addChild(this._currentColumnDragOverlaySkin);
					}
				}
			}
			else if(!DragDropManager.isDragging && this._reorderColumns)
			{
				//we aren't tracking another touch, so let's look for a new one.
				touch = event.getTouch(DisplayObject(headerRenderer), TouchPhase.BEGAN);
				if(touch === null)
				{
					//we only care about the began phase. ignore all other
					//phases when we don't have a saved touch ID.
					return;
				}
				this._headerTouchID = touch.id;
				this._headerTouchX = touch.globalX;
				this._headerTouchY = touch.globalX;
				this._draggedHeaderIndex = headerRenderer.columnIndex;
				//we want to check for TouchPhase.ENDED after it's bubbled
				//beyond the header renderer
				this.addEventListener(TouchEvent.TOUCH, dataGrid_touchHandler);
			}
		}

		/**
		 * @private
		 */
		protected function getHeaderDropIndex(globalX:Number):int
		{
			var headerCount:int = this._headerGroup.numChildren;
			for(var i:int = 0; i < headerCount; i++)
			{
				var header:IDataGridHeaderRenderer = IDataGridHeaderRenderer(this._headerGroup.getChildAt(i));
				var point:Point = Pool.getPoint(header.width / 2, 0);
				header.localToGlobal(point, point);
				var headerGlobalMiddleX:Number = point.x;
				Pool.putPoint(point);
				if(globalX < headerGlobalMiddleX)
				{
					return i;
				}
			}
			return headerCount;
		}

		/**
		 * @private
		 */
		protected function dataGrid_dragEnterHandler(event:DragDropEvent):void
		{
			if(DragDropManager.dragSource !== this || !event.dragData.hasDataForFormat(DATA_GRID_HEADER_DRAG_FORMAT))
			{
				return;
			}
			DragDropManager.acceptDrag(this);
		}

		/**
		 * @private
		 */
		protected function dataGrid_dragMoveHandler(event:DragDropEvent):void
		{
			if(DragDropManager.dragSource !== this || !event.dragData.hasDataForFormat(DATA_GRID_HEADER_DRAG_FORMAT))
			{
				return;
			}
			var point:Point = Pool.getPoint(event.localX, event.localY);
			this.localToGlobal(point, point);
			var globalDropX:Number = point.x;
			Pool.putPoint(point);
			var dropIndex:int = this.getHeaderDropIndex(globalDropX);
			var showDropIndicator:Boolean = dropIndex != this._draggedHeaderIndex &&
				dropIndex != (this._draggedHeaderIndex + 1);
			this._currentColumnDropIndicatorSkin.visible = showDropIndicator;
			if(!showDropIndicator)
			{
				return;
			}
			if(this._extendedColumnDropIndicator)
			{
				this._currentColumnDropIndicatorSkin.height = this._headerGroup.height + this._viewPort.visibleHeight;
			}
			else
			{
				this._currentColumnDropIndicatorSkin.height = this._headerGroup.height;
			}
			if(this._currentColumnDropIndicatorSkin is IValidating)
			{
				IValidating(this._currentColumnDropIndicatorSkin).validate();
			}
			var dropIndicatorX:Number = 0;
			if(dropIndex == this._columns.length)
			{
				var header:DisplayObject = this._headerGroup.getChildAt(dropIndex - 1);
				dropIndicatorX = header.x + header.width;
			}
			else
			{
				header = this._headerGroup.getChildAt(dropIndex);
				dropIndicatorX = header.x;
			}
			this._currentColumnDropIndicatorSkin.x = this._headerGroup.x + dropIndicatorX - (this._currentColumnDropIndicatorSkin.width / 2);
			this._currentColumnDropIndicatorSkin.y = this._headerGroup.y;
		}

		/**
		 * @private
		 */
		protected function dataGrid_dragDropHandler(event:DragDropEvent):void
		{
			if(DragDropManager.dragSource !== this || !event.dragData.hasDataForFormat(DATA_GRID_HEADER_DRAG_FORMAT))
			{
				return;
			}
			var point:Point = Pool.getPoint(event.localX, event.localY);
			this.localToGlobal(point, point);
			var globalDropX:Number = point.x;
			Pool.putPoint(point);
			var dropIndex:int = this.getHeaderDropIndex(globalDropX);
			if(dropIndex == this._draggedHeaderIndex ||
				(dropIndex == (this._draggedHeaderIndex + 1)))
			{
				//it's the same position, so do nothing
				return;
			}
			if(dropIndex > this._draggedHeaderIndex)
			{
				dropIndex--;
			}
			var column:DataGridColumn = DataGridColumn(this._columns.removeItemAt(this._draggedHeaderIndex));
			this._columns.addItemAt(column, dropIndex);
		}

		/**
		 * @private
		 */
		protected function headerDivider_touchHandler(event:TouchEvent):void
		{
			var divider:DisplayObject = DisplayObject(event.currentTarget);
			if(!this._isEnabled)
			{
				this._headerDividerTouchID = -1;
				return;
			}
			var dividerIndex:int = this._headerDividerStorage.activeDividers.indexOf(divider);
			if(dividerIndex == (this._headerDividerStorage.activeDividers.length - 1) &&
				this._scrollBarDisplayMode === ScrollBarDisplayMode.FIXED &&
				this._minVerticalScrollPosition != this._maxVerticalScrollPosition)
			{
				//no resizing!
				return;
			}
			if(this._headerDividerTouchID != -1)
			{
				//a touch has begun, so we'll ignore all other touches.
				var touch:Touch = event.getTouch(divider, null, this._headerDividerTouchID);
				if(touch === null)
				{
					//this should not happen.
					return;
				}

				if(touch.phase === TouchPhase.ENDED)
				{
					this.calculateResizedColumnWidth();
					this._resizingColumnIndex = -1;

					this._currentColumnResizeSkin.removeFromParent(this._currentColumnResizeSkin !== this._columnResizeSkin);
					this._currentColumnResizeSkin = null;
					this._headerDividerTouchID = -1;
				}
				else if(touch.phase === TouchPhase.MOVED)
				{
					var column:DataGridColumn = DataGridColumn(this._columns.getItemAt(this._resizingColumnIndex));
					var headerRenderer:IDataGridHeaderRenderer = IDataGridHeaderRenderer(this._headerGroup.getChildAt(this._resizingColumnIndex));
					var minX:Number = headerRenderer.x + column.minWidth;
					var maxX:Number = this.actualWidth - this._currentColumnResizeSkin.width - this._rightViewPortOffset;
					var difference:Number = touch.globalX - this._headerDividerTouchX;
					var newX:Number = divider.x + (divider.width / 2) - (this._currentColumnResizeSkin.width / 2) + difference;
					if(newX < minX)
					{
						newX = minX;
					}
					else if(newX > maxX)
					{
						newX = maxX;
					}
					this._currentColumnResizeSkin.x = newX;
					this._currentColumnResizeSkin.y = this._headerGroup.y;
					this._currentColumnResizeSkin.height = this.actualHeight - this._bottomViewPortOffset - this._currentColumnResizeSkin.y;
				}
			}
			else if(this._resizableColumns)
			{
				//we aren't tracking another touch, so let's look for a new one.
				touch = event.getTouch(divider, TouchPhase.BEGAN);
				if(touch === null)
				{
					return;
				}
				column = DataGridColumn(this._columns.getItemAt(dividerIndex));
				if(!column.resizable)
				{
					return;
				}
				this._resizingColumnIndex = dividerIndex;
				this._headerDividerTouchID = touch.id;
				this._headerDividerTouchX = touch.globalX;
				headerRenderer = IDataGridHeaderRenderer(this._headerGroup.getChildAt(dividerIndex));
				if(this._columnResizeSkin === null)
				{
					this._currentColumnResizeSkin = new Quad(1, 1, 0x000000);
				}
				else
				{
					this._currentColumnResizeSkin = this._columnResizeSkin;
				}
				this._currentColumnResizeSkin.height = this.actualHeight;
				this.addChild(this._currentColumnResizeSkin);
				if(this._currentColumnResizeSkin is IValidating)
				{
					IValidating(this._currentColumnResizeSkin).validate();
				}
				this._currentColumnResizeSkin.x = divider.x + (divider.width / 2) - (this._currentColumnResizeSkin.width / 2);
			}
		}

		/**
		 * @private
		 */
		protected function calculateResizedColumnWidth():void
		{
			var columnCount:int = this._columns.length;
			if(this._customColumnSizes === null)
			{
				this._customColumnSizes = new Vector.<Number>(columnCount);
			}
			else
			{
				//make a copy so that it will be detected as a change
				this._customColumnSizes = this._customColumnSizes.slice();
				//try to keep any column widths we already saved
				this._customColumnSizes.length = columnCount;
			}
			var column:DataGridColumn = DataGridColumn(this._columns.getItemAt(this._resizingColumnIndex));
			//clear the explicit width because the user resized it
			column.width = NaN;
			var headerRenderer:IDataGridHeaderRenderer = IDataGridHeaderRenderer(this._headerGroup.getChildAt(this._resizingColumnIndex));
			var preferredWidth:Number = this._currentColumnResizeSkin.x + (this._currentColumnResizeSkin.width / 2) - headerRenderer.x;
			var totalMinWidth:Number = 0;
			var originalWidth:Number = headerRenderer.width;
			var totalWidthAfter:Number = 0;
			var indicesAfter:Vector.<int> = new <int>[];
			for(var i:int = 0; i < columnCount; i++)
			{
				var currentColumn:DataGridColumn = DataGridColumn(this._columns.getItemAt(i));
				if(i == this._resizingColumnIndex)
				{
					continue;
				}
				else if(i < this._resizingColumnIndex)
				{
					//we want these columns to maintain their width so that the
					//resized one will start at the same x position
					//however, we're not setting the width property on the
					//DataGridColumn because we want them to be able to resize
					//later if the whole DataGrid resizes.
					headerRenderer = IDataGridHeaderRenderer(this._headerGroup.getChildAt(i));
					this._customColumnSizes[i] = headerRenderer.width;
					totalMinWidth += headerRenderer.width;
				}
				else
				{
					if(currentColumn.width === currentColumn.width) //!isNaN
					{
						totalMinWidth += currentColumn.width;
						continue;
					}
					else
					{
						totalMinWidth += currentColumn.minWidth;
					}
					headerRenderer = IDataGridHeaderRenderer(this._headerGroup.getChildAt(i));
					var columnWidth:Number = headerRenderer.width;
					totalWidthAfter += columnWidth;
					this._customColumnSizes[i] = columnWidth;
					indicesAfter[indicesAfter.length] = i;
				}
			}
			if(indicesAfter.length == 0)
			{
				//if all of the columns after the resizing one have explicit
				//widths, we need to force one to be resized
				var index:int = this._resizingColumnIndex + 1;
				indicesAfter[0] = index;
				column = DataGridColumn(this._columns.getItemAt(index));
				totalWidthAfter = column.width;
				totalMinWidth -= totalWidthAfter;
				totalMinWidth += column.minWidth;
				this._customColumnSizes[index] = totalWidthAfter;
				column.width = NaN;
			}
			var newWidth:Number = preferredWidth;
			var maxWidth:Number = this._headerGroup.width - totalMinWidth - this._leftViewPortOffset - this._rightViewPortOffset;
			if(newWidth > maxWidth)
			{
				newWidth = maxWidth;
			}
			if(newWidth < column.minWidth)
			{
				newWidth = column.minWidth;
			}
			this._customColumnSizes[this._resizingColumnIndex] = newWidth;

			//the width to distribute may be positive or negative, depending on
			//whether the resized column was made smaller or larger
			var widthToDistribute:Number = originalWidth - newWidth;
			this.distributeWidthToIndices(widthToDistribute, indicesAfter, totalWidthAfter);
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}
	}
}

import feathers.controls.renderers.IDataGridHeaderRenderer;

import starling.display.DisplayObject;

class HeaderRendererFactoryStorage
{
	public var activeHeaderRenderers:Vector.<IDataGridHeaderRenderer> = new <IDataGridHeaderRenderer>[];
	public var inactiveHeaderRenderers:Vector.<IDataGridHeaderRenderer> = new <IDataGridHeaderRenderer>[];
	public var factory:Function = null;
	public var customHeaderRendererStyleName:String = null;
	public var columnIndex:int = -1;
}

class DividerFactoryStorage
{
	public var activeDividers:Vector.<DisplayObject> = new <DisplayObject>[];
	public var inactiveDividers:Vector.<DisplayObject> = new <DisplayObject>[];
	public var factory:Function = null;
}


================================================
FILE: source/feathers/controls/DataGridColumn.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.data.SortOrder;

	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when a property of the column changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Configures a column in a <code>DataGrid</code> component.
	 *
	 * @see feathers.controls.DataGrid
	 *
	 * @productversion Feathers 3.4.0
	 */
	public class DataGridColumn extends EventDispatcher
	{
		/**
		 * Constructor.
		 */
		public function DataGridColumn(dataField:String = null, headerText:String = null)
		{
			super();
			this.dataField = dataField;
			this.headerText = headerText;
		}

		/**
		 * @private
		 */
		protected var _headerText:String = null;

		/**
		 * The text to display in the column's header.
		 *
		 * <p>In the following example, the header text is customized:</p>
		 *
		 * <listing version="3.0">
		 * column.headerText = "Customer Name";</listing>
		 *
		 * @default null
		 */
		public function get headerText():String
		{
			return this._headerText;
		}

		/**
		 * @private
		 */
		public function set headerText(value:String):void
		{
			if(this._headerText === value)
			{
				return;
			}
			this._headerText = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _dataField:String = null;

		/**
		 * The field in the item that contains the data to be displayed by
		 * the cell renderers in this column. If the item does not have this
		 * field, then the renderer may default to calling <code>toString()</code>
		 * on the item.
		 *
		 * <p>In the following example, the data field is customized:</p>
		 *
		 * <listing version="3.0">
		 * column.dataField = "name";</listing>
		 *
		 * @default null
		 */
		public function get dataField():String
		{
			return this._dataField;
		}

		/**
		 * @private
		 */
		public function set dataField(value:String):void
		{
			if(this._dataField === value)
			{
				return;
			}
			this._dataField = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _cellRendererFactory:Function = null;

		/**
		 * A function called that is expected to return a new cell renderer.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 *
		 * <pre>function():IDataGridCellRenderer</pre>
		 *
		 * <p>The following example provides a factory for the cell renderer:</p>
		 *
		 * <listing version="3.0">
		 * column.cellRendererFactory = function():IDataGridCellRenderer
		 * {
		 *     var cellRenderer:CustomCellRendererClass = new CustomCellRendererClass();
		 *     cellRenderer.backgroundSkin = new Quad( 10, 10, 0xff0000 );
		 *     return cellRenderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderers.IDataGridCellRenderer
		 */
		public function get cellRendererFactory():Function
		{
			return this._cellRendererFactory;
		}

		/**
		 * @private
		 */
		public function set cellRendererFactory(value:Function):void
		{
			if(this._cellRendererFactory === value)
			{
				return;
			}
			this._cellRendererFactory = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _customCellRendererStyleName:String = null;

		/**
		 * A style name to add to all cell renderers in this column. Typically
		 * used by a theme to provide different skins to different columns.
		 *
		 * <p>The following example sets the cell renderer style name:</p>
		 *
		 * <listing version="3.0">
		 * column.customCellRendererStyleName = "my-custom-cell-renderer";</listing>
		 *
		 * <p>In your theme, you can target this sub-component name to provide
		 * different skins than the default style:</p>
		 *
		 * <listing version="3.0">
		 * getStyleProviderForClass( DefaultDataGridCellRenderer ).setFunctionForStyleName( "my-custom-cell-renderer", setCustomCellRendererStyles );</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public function get customCellRendererStyleName():String
		{
			return this._customCellRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customCellRendererStyleName(value:String):void
		{
			if(this._customCellRendererStyleName === value)
			{
				return;
			}
			this._customCellRendererStyleName = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _headerRendererFactory:Function = null;

		/**
		 * A function called that is expected to return a new header renderer.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 *
		 * <pre>function():IDataGridHeaderRenderer</pre>
		 *
		 * <p>The following example provides a factory for the header renderer:</p>
		 *
		 * <listing version="3.0">
		 * column.headerRendererFactory = function():IDataGridHeaderRenderer
		 * {
		 *     var headerRenderer:CustomHeaderRendererClass = new CustomHeaderRendererClass();
		 *     headerRenderer.backgroundSkin = new Quad( 10, 10, 0xff0000 );
		 *     return headerRenderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderers.IDataGridHeaderRenderer
		 */
		public function get headerRendererFactory():Function
		{
			return this._headerRendererFactory;
		}

		/**
		 * @private
		 */
		public function set headerRendererFactory(value:Function):void
		{
			if(this._headerRendererFactory === value)
			{
				return;
			}
			this._headerRendererFactory = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _customHeaderRendererStyleName:String = null;

		/**
		 * A style name to add to all header renderers in this column. Typically
		 * used by a theme to provide different skins to different columns.
		 *
		 * <p>The following example sets the header renderer name:</p>
		 *
		 * <listing version="3.0">
		 * column.customHeaderRendererStyleName = "my-custom-header-renderer";</listing>
		 *
		 * <p>In your theme, you can target this sub-component name to provide
		 * different skins than the default style:</p>
		 *
		 * <listing version="3.0">
		 * getStyleProviderForClass( DefaultDataGridHeaderRenderer ).setFunctionForStyleName( "my-custom-header-renderer", setCustomHeaderRendererStyles );</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public function get customHeaderRendererStyleName():String
		{
			return this._customHeaderRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customHeaderRendererStyleName(value:String):void
		{
			if(this._customHeaderRendererStyleName === value)
			{
				return;
			}
			this._customHeaderRendererStyleName = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _minWidth:Number = 10;

		/**
		 * The minimum width of the column, in pixels.
		 *
		 * <p>The following example sets the column minimum width:</p>
		 *
		 * <listing version="3.0">
		 * column.minWidth = 200;</listing>
		 *
		 * @default 10
		 */
		public function get minWidth():Number
		{
			return this._minWidth;
		}

		/**
		 * @private
		 */
		public function set minWidth(value:Number):void
		{
			if(this._minWidth == value)
			{
				return;
			}
			this._minWidth = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _width:Number = NaN;

		/**
		 * The width of the column, in pixels. If the width is set to
		 * <code>NaN</code>, the column will be sized automatically by the
		 * data grid's layout.
		 *
		 * <p>The following example sets the column width:</p>
		 *
		 * <listing version="3.0">
		 * column.width = 200;</listing>
		 *
		 * @default NaN
		 */
		public function get width():Number
		{
			return this._width;
		}

		/**
		 * @private
		 */
		public function set width(value:Number):void
		{
			if(this._width == value)
			{
				return;
			}
			this._width = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _sortCompareFunction:Function = null;

		/**
		 * A function to compare each item in the collection to determine the
		 * order when sorted.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( a:Object, b:Object ):int</pre>
		 *
		 * <p>The return value should be <code>-1</code> if the first item
		 * should appear before the second item when the collection is sorted.
		 * The return value should be <code>1</code> if the first item should
		 * appear after the second item when the collection in sorted. Finally,
		 * the return value should be <code>0</code> if both items have the
		 * same sort order.</p>
		 *
		 * @default null
		 *
		 * @see #sortOrder
		 */
		public function get sortCompareFunction():Function
		{
			return this._sortCompareFunction;
		}

		/**
		 * @private
		 */
		public function set sortCompareFunction(value:Function):void
		{
			if(this._sortCompareFunction === value)
			{
				return;
			}
			this._sortCompareFunction = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _sortOrder:String = SortOrder.ASCENDING;

		/**
		 * Indicates if the column may be sorted by triggering the
		 * header renderer, and which direction it should be sorted
		 * by default (ascending or descending).
		 *
		 * <p>Setting this property will not start a sort. It only provides the
		 * initial order of the sort when triggered by the user.</p>
		 *
		 * <p>If the <code>sortableColumns</code> property of the
		 * <code>DataGrid</code> is <code>false</code>, it takes precendence
		 * over this property, and the column will not be sortable.</p>
		 *
		 * <p>The following example disables sorting:</p>
		 *
		 * <listing version="3.0">
		 * column.sortOrder = SortOrder.NONE;</listing>
		 *
		 * @default feathers.data.SortOrder.ASCENDING
		 *
		 * @see feathers.controls.DataGrid#sortableColumns
		 * @see #sortCompareFunction
		 * @see feathers.data.SortOrder#ASCENDING
		 * @see feathers.data.SortOrder#DESCENDING
		 * @see feathers.data.SortOrder#NONE
		 */
		public function get sortOrder():String
		{
			return this._sortOrder;
		}

		/**
		 * @private
		 */
		public function set sortOrder(value:String):void
		{
			if(this._sortOrder === value)
			{
				return;
			}
			this._sortOrder = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _resizable:Boolean = true;

		/**
		 * Indicates if the column may be resized by dragging from its right edge.
		 *
		 * <p>If the <code>resizableColumns</code> property of the
		 * <code>DataGrid</code> is <code>false</code>, it takes precendence
		 * over this property, and the column will not be resizable.</p>
		 *
		 * <p>The following example disables resizing:</p>
		 *
		 * <listing version="3.0">
		 * column.resizable = false;</listing>
		 *
		 * @default true
		 *
		 * @see feathers.controls.DataGrid#resizableColumns
		 */
		public function get resizable():Boolean
		{
			return this._resizable;
		}

		/**
		 * @private
		 */
		public function set resizable(value:Boolean):void
		{
			if(this._resizable === value)
			{
				return;
			}
			this._resizable = value;
			this.dispatchEventWith(Event.CHANGE);
		}
	}
}

================================================
FILE: source/feathers/controls/DateTimeMode.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * Formats for date and time components.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class DateTimeMode
	{
		/**
		 * Both date and time will be displayed.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const DATE_AND_TIME:String = "dateAndTime";

		/**
		 * Only the time will be displayed. The date will not be displayed.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const TIME:String = "time";

		/**
		 * Only the date will be displayed. The time will not be displayed.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const DATE:String = "date";
	}
}


================================================
FILE: source/feathers/controls/DateTimeSpinner.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IValidating;
	import feathers.data.IListCollection;
	import feathers.data.VectorCollection;
	import feathers.events.FeathersEventType;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.VerticalAlign;
	import feathers.skins.IStyleProvider;
	import feathers.utils.math.roundDownToNearest;
	import feathers.utils.math.roundUpToNearest;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;

	import flash.globalization.DateTimeFormatter;
	import flash.globalization.DateTimeNameStyle;
	import flash.globalization.DateTimeStyle;
	import flash.globalization.LocaleID;

	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * The background to display behind all content when the date time spinner
	 * is disabled. The background skin is resized to fill the full width and
	 * height of the date time spinner, and the lists are centered.
	 *
	 * <p>In the following example, the spinner is given a background skin:</p>
	 *
	 * <listing version="3.0">
	 * spinner.backgroundDisabledSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundSkin
	 */
	[Style(name="backgroundDisabledSkin",type="starling.display.DisplayObject")]

	/**
	 * The default background to display behind all content. The background
	 * skin is resized to fill the full width and height of the date time
	 * spinner, and the lists are centered.
	 *
	 * <p>In the following example, the spinner is given a background skin:</p>
	 *
	 * <listing version="3.0">
	 * spinner.backgroundSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundDisabledSkin
	 */
	[Style(name="backgroundSkin",type="starling.display.DisplayObject")]

	/**
	 * A style name to add to the date time spinner's item renderer
	 * sub-components. Typically used by a theme to provide different styles to
	 * different date time spinners.
	 *
	 * <p>In the following example, a custom item renderer style name is passed
	 * to the date time spinner:</p>
	 *
	 * <listing version="3.0">
	 * spinner.customItemRendererStyleName = "my-custom-date-time-spinner-item-renderer";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( DefaultListItemRenderer ).setFunctionForStyleName( "my-custom-date-time-spinner-item-renderer", setCustomDateTimeSpinnerItemRendererStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #itemRendererFactory
	 */
	[Style(name="customItemRendererStyleName",type="String")]

	/**
	 * A style name to add to the date time spinner's list sub-components.
	 * Typically used by a theme to provide different styles to different
	 * date time spinners.
	 *
	 * <p>In the following example, a custom list style name is passed to
	 * the date time spinner:</p>
	 *
	 * <listing version="3.0">
	 * spinner.customListStyleName = "my-custom-spinner-list";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( SpinnerList ).setFunctionForStyleName( "my-custom-spinner-list", setCustomSpinnerListStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_LIST
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #listFactory
	 */
	[Style(name="customListStyleName",type="String")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * spinner.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, between the date time spinner's top edge and
	 * the its content.
	 *
	 * <p>In the following example, the top padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * spinner.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the date time spinner's right edge
	 * and the its content.
	 *
	 * <p>In the following example, the right padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * spinner.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the date time spinner's bottom edge
	 * and the its content.
	 *
	 * <p>In the following example, the bottom padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * spinner.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the date time spinner's left edge
	 * and the its content.
	 *
	 * <p>In the following example, the left padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * spinner.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * The duration, in seconds, of the animation when the
	 * <code>scrollToDate()</code> function is called, or when an invalid
	 * date is selected.
	 *
	 * <p>In the following example, the duration of the animation that
	 * changes the page when thrown is set to 250 milliseconds:</p>
	 *
	 * <listing version="3.0">
	 * spinner.scrollDuration = 0.25;</listing>
	 *
	 * @default 0.5
	 *
	 * @see #scrollToDate()
	 */
	[Style(name="scrollDuration",type="Number")]

	/**
	 * Dispatched when the spinner's value changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #value
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * A set of <code>SpinnerList</code> components that allow you to select the
	 * date, the time, or the date and time.
	 *
	 * <p>The following example sets the date spinner's range and listens for
	 * when the value changes:</p>
	 *
	 * <listing version="3.0">
	 * var spinner:DateTimeSpinner = new DateTimeSpinner();
	 * spinner.editingMode = DateTimeMode.DATE;
	 * spinner.minimum = new Date(1970, 0, 1);
	 * spinner.maximum = new Date(2050, 11, 31);
	 * spinner.value = new Date();
	 * spinner.addEventListener( Event.CHANGE, spinner_changeHandler );
	 * this.addChild( spinner );</listing>
	 *
	 * @see ../../../help/date-time-spinner.html How to use the Feathers DateTimeSpinner component
	 *
	 * @productversion Feathers 2.3.0
	 */
	public class DateTimeSpinner extends FeathersControl
	{
		/**
		 * The default name to use with lists.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_LIST:String = "feathers-date-time-spinner-list";

		/**
		 * @private
		 */
		private static const MS_PER_DAY:int = 86400000;

		/**
		 * @private
		 */
		private static const MIN_MONTH_VALUE:int = 0;

		/**
		 * @private
		 */
		private static const MAX_MONTH_VALUE:int = 11;

		/**
		 * @private
		 */
		private static const MIN_DATE_VALUE:int = 1;

		/**
		 * @private
		 */
		private static const MAX_DATE_VALUE:int = 31;

		/**
		 * @private
		 */
		private static const MIN_HOURS_VALUE:int = 0;

		/**
		 * @private
		 */
		private static const MAX_HOURS_VALUE_12HOURS:int = 11;

		/**
		 * @private
		 */
		private static const MAX_HOURS_VALUE_24HOURS:int = 23;

		/**
		 * @private
		 */
		private static const MIN_MINUTES_VALUE:int = 0;

		/**
		 * @private
		 */
		private static const MAX_MINUTES_VALUE:int = 59;

		/**
		 * @private
		 */
		private static const HELPER_DATE:Date = new Date();

		/**
		 * @private
		 */
		private static const DAYS_IN_MONTH:Vector.<int> = new <int>[];

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_LOCALE:String = "locale";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_EDITING_MODE:String = "editingMode";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_PENDING_SCROLL:String = "pendingScroll";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_SPINNER_LIST_FACTORY:String = "spinnerListFactory";

		/**
		 * The default <code>IStyleProvider</code> for all <code>DateTimeSpinner</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static function defaultListFactory():SpinnerList
		{
			return new SpinnerList();
		}

		/**
		 * Constructor.
		 */
		public function DateTimeSpinner()
		{
			super();
			if(DAYS_IN_MONTH.length == 0)
			{
				HELPER_DATE.setFullYear(2015); //this is pretty arbitrary
				for(var i:int = MIN_MONTH_VALUE; i <= MAX_MONTH_VALUE; i++)
				{
					//subtract one date from the 1st of next month to figure out
					//the last date of the current month
					HELPER_DATE.setMonth(i + 1, -1);
					DAYS_IN_MONTH[i] = HELPER_DATE.date + 1;
				}
				DAYS_IN_MONTH.fixed = true;
			}
		}

		/**
		 * The value added to the <code>styleNameList</code> of the lists. This
		 * variable is <code>protected</code> so that sub-classes can customize
		 * the list style name in their constructors instead of using the
		 * default style name defined by <code>DEFAULT_CHILD_STYLE_NAME_LIST</code>.
		 *
		 * <p>To customize the list style name without subclassing, see
		 * <code>customListStyleName</code>.</p>
		 *
		 * @see #style:customListStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var listStyleName:String = DEFAULT_CHILD_STYLE_NAME_LIST;

		/**
		 * @private
		 */
		protected var monthsList:SpinnerList;

		/**
		 * @private
		 */
		protected var datesList:SpinnerList;

		/**
		 * @private
		 */
		protected var yearsList:SpinnerList;

		/**
		 * @private
		 */
		protected var dateAndTimeDatesList:SpinnerList;

		/**
		 * @private
		 */
		protected var hoursList:SpinnerList;

		/**
		 * @private
		 */
		protected var minutesList:SpinnerList;

		/**
		 * @private
		 */
		protected var meridiemList:SpinnerList;

		/**
		 * @private
		 */
		protected var listGroup:LayoutGroup;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return DateTimeSpinner.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _locale:String = LocaleID.DEFAULT;

		/**
		 * The locale used to display the date. Supports values defined by
		 * Unicode Technical Standard #35, such as <code>"en_US"</code>,
		 * <code>"fr_FR"</code> or <code>"ru_RU"</code>.
		 *
		 * @default flash.globalization.LocaleID.DEFAULT
		 *
		 * @see http://unicode.org/reports/tr35/ Unicode Technical Standard #35
		 */
		public function get locale():String
		{
			return this._locale;
		}

		/**
		 * @private
		 */
		public function set locale(value:String):void
		{
			if(this._locale == value)
			{
				return;
			}
			this._locale = value;
			this._formatter = null;
			this.invalidate(INVALIDATION_FLAG_LOCALE);
		}

		/**
		 * @private
		 */
		protected var _value:Date;

		/**
		 * The value of the date time spinner, between the minimum and maximum.
		 *
		 * <p>In the following example, the value is changed to a date:</p>
		 *
		 * <listing version="3.0">
		 * stepper.minimum = new Date(1970, 0, 1);
		 * stepper.maximum = new Date(2050, 11, 31);
		 * stepper.value = new Date(1995, 2, 7);</listing>
		 *
		 * @default 0
		 *
		 * @see #minimum
		 * @see #maximum
		 * @see #event:change
		 */
		public function get value():Date
		{
			return this._value;
		}

		/**
		 * @private
		 */
		public function set value(value:Date):void
		{
			var time:Number = value.time;
			if(this._minimum && this._minimum.time > time)
			{
				time = this._minimum.time;
			}
			if(this._maximum && this._maximum.time < time)
			{
				time = this._maximum.time;
			}
			if(this._value && this._value.time == time)
			{
				return;
			}
			this._value = new Date(time);
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _minimum:Date;

		/**
		 * The date time spinner's value will not go lower than the minimum.
		 *
		 * <p>In the following example, the minimum is changed:</p>
		 *
		 * <listing version="3.0">
		 * spinner.minimum = new Date(1970, 0, 1);</listing>
		 *
		 * @see #value
		 * @see #maximum
		 */
		public function get minimum():Date
		{
			return this._minimum;
		}

		/**
		 * @private
		 */
		public function set minimum(value:Date):void
		{
			if(this._minimum == value)
			{
				return;
			}
			this._minimum = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _maximum:Date;

		/**
		 * The date time spinner's value will not go higher than the maximum.
		 *
		 * <p>In the following example, the maximum is changed:</p>
		 *
		 * <listing version="3.0">
		 * spinner.maximum = new Date(2050, 11, 31);</listing>
		 *
		 * @see #value
		 * @see #minimum
		 */
		public function get maximum():Date
		{
			return this._maximum;
		}

		/**
		 * @private
		 */
		public function set maximum(value:Date):void
		{
			if(this._maximum == value)
			{
				return;
			}
			this._maximum = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _minuteStep:int = 1;

		/**
		 * In the list that allows selection of minutes, customizes the number
		 * of minutes between each item. For instance, one might choose 15 or
		 * 30 minute increments.
		 *
		 * <p>In the following example, the spinner uses 15 minute increments:</p>
		 *
		 * <listing version="3.0">
		 * spinner.minuteStep = 15;</listing>
		 *
		 * @default 1
		 */
		public function get minuteStep():int
		{
			return this._minuteStep;
		}

		/**
		 * @private
		 */
		public function set minuteStep(value:int):void
		{
			if(60 % value != 0)
			{
				throw new ArgumentError("minuteStep must evenly divide into 60.");
			}
			if(this._minuteStep == value)
			{
				return;
			}
			this._minuteStep = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _editingMode:String = DateTimeMode.DATE_AND_TIME;

		/**
		 * Determines which parts of the <code>Date</code> value may be edited.
		 *
		 * @default feathers.controls.DateTimeMode.DATE_AND_TIME
		 *
		 * @see feathers.controls.DateTimeMode#DATE_AND_TIME
		 * @see feathers.controls.DateTimeMode#DATE
		 * @see feathers.controls.DateTimeMode#TIME
		 */
		public function get editingMode():String
		{
			return this._editingMode;
		}

		/**
		 * @private
		 */
		public function set editingMode(value:String):void
		{
			if(this._editingMode == value)
			{
				return;
			}
			this._editingMode = value;
			this.invalidate(INVALIDATION_FLAG_EDITING_MODE);
		}

		/**
		 * @private
		 */
		protected var _formatter:DateTimeFormatter;

		/**
		 * @private
		 */
		protected var _longestMonthNameIndex:int;

		/**
		 * @private
		 */
		protected var _localeMonthNames:Vector.<String>;

		/**
		 * @private
		 */
		protected var _localeWeekdayNames:Vector.<String>;

		/**
		 * @private
		 */
		protected var _ignoreListChanges:Boolean = false;

		/**
		 * @private
		 */
		protected var _monthFirst:Boolean = true;

		/**
		 * @private
		 */
		protected var _showMeridiem:Boolean = true;

		/**
		 * @private
		 */
		protected var _lastMeridiemValue:int = 0;

		/**
		 * @private
		 */
		protected var _listMinYear:int;

		/**
		 * @private
		 */
		protected var _listMaxYear:int;

		/**
		 * @private
		 */
		protected var _minYear:int;

		/**
		 * @private
		 */
		protected var _maxYear:int;

		/**
		 * @private
		 */
		protected var _minMonth:int;

		/**
		 * @private
		 */
		protected var _maxMonth:int;

		/**
		 * @private
		 */
		protected var _minDate:int;

		/**
		 * @private
		 */
		protected var _maxDate:int;

		/**
		 * @private
		 */
		protected var _minHours:int;

		/**
		 * @private
		 */
		protected var _maxHours:int;

		/**
		 * @private
		 */
		protected var _minMinute:int;

		/**
		 * @private
		 */
		protected var _maxMinute:int;

		/**
		 * @private
		 */
		protected var _scrollDuration:Number = 0.5;

		/**
		 * @private
		 */
		public function get scrollDuration():Number
		{
			return this._scrollDuration;
		}

		/**
		 * @private
		 */
		public function set scrollDuration(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._scrollDuration == value)
			{
				return;
			}
			this._scrollDuration = value;
		}

		/**
		 * @private
		 */
		protected var _itemRendererFactory:Function = null;

		/**
		 * A function used to instantiate the date time spinner's item renderer
		 * sub-components. A single factory will be shared by all
		 * <code>SpinnerList</code> sub-components displayed by the
		 * <code>DateTimeSpinner</code>. The item renderers must be instances of
		 * <code>DefaultListItemRenderer</code>. This factory can be used to
		 * change properties of the item renderer sub-components when they are
		 * first created. For instance, if you are skinning Feathers components
		 * without a theme, you might use this factory to style the item
		 * renderer sub-components.
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():DefaultListItemRenderer</pre>
		 *
		 * <p>In the following example, the date time spinner uses a custom item
		 * renderer factory:</p>
		 *
		 * <listing version="3.0">
		 * spinner.itemRendererFactory = function():DefaultListItemRenderer
		 * {
		 *     var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
		 *     // set properties
		 *     return itemRenderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderers.DefaultListItemRenderer
		 * @see #itemRendererFactory
		 */
		public function get itemRendererFactory():Function
		{
			return this._itemRendererFactory;
		}

		/**
		 * @private
		 */
		public function set itemRendererFactory(value:Function):void
		{
			if(this._itemRendererFactory === value)
			{
				return;
			}
			this._itemRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_SPINNER_LIST_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _listFactory:Function;

		/**
		 * A function used to instantiate the date time spinner's list
		 * sub-components. The lists must be instances of
		 * <code>SpinnerList</code>. This factory can be used to change
		 * properties of the list sub-components when they are first created.
		 * For instance, if you are skinning Feathers components without a
		 * theme, you might use this factory to style the list sub-components.
		 *
		 * <p><strong>Warning:</strong> The <code>itemRendererFactory</code>
		 * and <code>customItemRendererStyleName</code> properties of the
		 * <code>SpinnerList</code> should not be set in the
		 * <code>listFactory</code>. Instead, set the
		 * <code>itemRendererFactory</code> and
		 * <code>customItemRendererStyleName</code> properties of the
		 * <code>DateTimeSpinner</code>.</p>
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():SpinnerList</pre>
		 *
		 * <p>In the following example, the date time spinner uses a custom list
		 * factory:</p>
		 *
		 * <listing version="3.0">
		 * spinner.listFactory = function():SpinnerList
		 * {
		 *     var list:SpinnerList = new SpinnerList();
		 *     // set properties
		 *     return list;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.SpinnerList
		 * @see #itemRendererFactory
		 */
		public function get listFactory():Function
		{
			return this._listFactory;
		}

		/**
		 * @private
		 */
		public function set listFactory(value:Function):void
		{
			if(this._listFactory == value)
			{
				return;
			}
			this._listFactory = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _customListStyleName:String;

		/**
		 * @private
		 */
		public function get customListStyleName():String
		{
			return this._customListStyleName;
		}

		/**
		 * @private
		 */
		public function set customListStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customListStyleName === value)
			{
				return;
			}
			this._customListStyleName = value;
			this.invalidate(INVALIDATION_FLAG_SPINNER_LIST_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customItemRendererStyleName:String;

		/**
		 * @private
		 */
		public function get customItemRendererStyleName():String
		{
			return this._customItemRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customItemRendererStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customItemRendererStyleName === value)
			{
				return;
			}
			this._customItemRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_SPINNER_LIST_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _lastValidate:Date;

		/**
		 * @private
		 */
		protected var _todayLabel:String = null;

		/**
		 * If not <code>null</code>, and the <code>editingMode</code> property
		 * is set to <code>DateTimeMode.DATE_AND_TIME</code> the date matching
		 * today's current date will display this label instead of the date.
		 *
		 * <p>In the following example, the label for today is set:</p>
		 *
		 * <listing version="3.0">
		 * spinner.todayLabel = "Today";</listing>
		 *
		 * @default null
		 */
		public function get todayLabel():String
		{
			return this._todayLabel;
		}

		/**
		 * @private
		 */
		public function set todayLabel(value:String):void
		{
			if(this._todayLabel == value)
			{
				return;
			}
			this._todayLabel = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _explicitBackgroundWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxHeight:Number;

		/**
		 * @private
		 */
		protected var currentBackgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		protected var _backgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundSkin():DisplayObject
		{
			return this._backgroundSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundSkin === value)
			{
				return;
			}
			if(this._backgroundSkin !== null &&
				this.currentBackgroundSkin === this._backgroundSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundSkin = value;
			this.invalidate(INVALIDATION_FLAG_SKIN);
		}

		/**
		 * @private
		 */
		protected var _backgroundDisabledSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundDisabledSkin():DisplayObject
		{
			return this._backgroundDisabledSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundDisabledSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundDisabledSkin === value)
			{
				return;
			}
			if(this._backgroundDisabledSkin !== null &&
				this.currentBackgroundSkin === this._backgroundDisabledSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundDisabledSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundDisabledSkin = value;
			this.invalidate(INVALIDATION_FLAG_SKIN);
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _amString:String;

		/**
		 * @private
		 */
		protected var _pmString:String;

		/**
		 * @private
		 */
		protected var pendingScrollToDate:Date;

		/**
		 * @private
		 */
		protected var pendingScrollDuration:Number;

		/**
		 * After the next validation, animates the scroll positions of the lists
		 * to a specific date. If the <code>animationDuration</code> argument is
		 * <code>NaN</code> (the default value), the value of the
		 * <code>scrollDuration</code> property is used instead. The duration is
		 * measured in seconds.
		 *
		 * <p>Note: The <code>value</code> property will not be updated
		 * immediately when calling <code>scrollToDate()</code>. Similar to how
		 * the animation won't start until the next validation, the
		 * <code>value</code> property will be updated at the same time.</p>
		 *
		 * <p>In the following example, we scroll to a specific date with
		 * animation of 1.5 seconds:</p>
		 *
		 * <listing version="3.0">
		 * spinner.scrollToDate( new Date(2016, 0, 1), 1.5 );</listing>
		 *
		 * @see #style:scrollDuration
		 */
		public function scrollToDate(date:Date, animationDuration:Number = NaN):void
		{
			if(this.pendingScrollToDate && this.pendingScrollToDate.time == date.time &&
				this.pendingScrollDuration == animationDuration)
			{
				return;
			}
			this.pendingScrollToDate = date;
			this.pendingScrollDuration = animationDuration;
			this.invalidate(INVALIDATION_FLAG_PENDING_SCROLL);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			//we don't dispose it if the group is the parent because it'll
			//already get disposed in super.dispose()
			if(this._backgroundSkin !== null && this._backgroundSkin.parent !== this)
			{
				this._backgroundSkin.dispose();
			}
			if(this._backgroundDisabledSkin !== null && this._backgroundDisabledSkin.parent !== this)
			{
				this._backgroundDisabledSkin.dispose();
			}
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(this.listGroup === null)
			{
				var groupLayout:HorizontalLayout = new HorizontalLayout();
				groupLayout.horizontalAlign = HorizontalAlign.CENTER;
				groupLayout.verticalAlign = VerticalAlign.JUSTIFY;
				this.listGroup = new LayoutGroup();
				this.listGroup.layout = groupLayout;
				this.addChild(this.listGroup);
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var skinInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SKIN);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var editingModeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_EDITING_MODE);
			var localeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LOCALE);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var pendingScrollInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_PENDING_SCROLL);
			var spinnerListFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SPINNER_LIST_FACTORY);

			if(this._todayLabel)
			{
				this._lastValidate = new Date();
			}

			if(skinInvalid || stateInvalid)
			{
				this.refreshBackgroundSkin();
			}

			if(localeInvalid || editingModeInvalid)
			{
				this.refreshLocale();
			}

			if(localeInvalid || editingModeInvalid || spinnerListFactoryInvalid)
			{
				this.refreshLists(editingModeInvalid || spinnerListFactoryInvalid, localeInvalid);
			}

			if(localeInvalid || editingModeInvalid || dataInvalid || spinnerListFactoryInvalid)
			{
				this.useDefaultsIfNeeded();
				this.refreshValidRanges();
				this.refreshSelection();
			}

			if(localeInvalid || editingModeInvalid || stateInvalid || spinnerListFactoryInvalid)
			{
				this.refreshEnabled();
			}

			this.autoSizeIfNeeded();

			this.layoutChildren();

			if(pendingScrollInvalid)
			{
				this.handlePendingScroll();
			}
		}

		/**
		 * @private
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			var measureBackground:IMeasureDisplayObject = this.currentBackgroundSkin as IMeasureDisplayObject;
			resetFluidChildDimensionsForMeasurement(this.currentBackgroundSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitBackgroundWidth, this._explicitBackgroundHeight,
				this._explicitBackgroundMinWidth, this._explicitBackgroundMinHeight,
				this._explicitBackgroundMaxWidth, this._explicitBackgroundMaxHeight);
			if(this.currentBackgroundSkin is IValidating)
			{
				IValidating(this.currentBackgroundSkin).validate();
			}

			this.listGroup.width = this._explicitWidth;
			this.listGroup.height = this._explicitHeight;
			this.listGroup.minWidth = this._explicitMinWidth;
			this.listGroup.minHeight = this._explicitMinHeight;
			this.listGroup.validate(); //minimum dimensions

			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				if(measureBackground !== null)
				{
					newMinWidth = measureBackground.minWidth;
				}
				else if(this.currentBackgroundSkin !== null)
				{
					newMinWidth = this._explicitBackgroundMinWidth;
				}
				else
				{
					newMinWidth = 0;
				}
				var listsMinWidth:Number = this.listGroup.minWidth;
				listsMinWidth += this._paddingLeft + this._paddingRight;
				if(listsMinWidth > newMinWidth)
				{
					newMinWidth = listsMinWidth;
				}
			}
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				if(measureBackground !== null)
				{
					newMinHeight = measureBackground.minHeight;
				}
				else if(this.currentBackgroundSkin !== null)
				{
					newMinHeight = this._explicitBackgroundMinHeight;
				}
				else
				{
					newMinHeight = 0;
				}
				var listsMinHeight:Number = this.listGroup.minHeight;
				listsMinHeight += this._paddingTop + this._paddingBottom;
				if(listsMinHeight > newMinHeight)
				{
					newMinHeight = listsMinHeight;
				}
			}

			//current dimensions
			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				if(this.currentBackgroundSkin !== null)
				{
					newWidth = this.currentBackgroundSkin.width;
				}
				else
				{
					newWidth = 0;
				}
				var listsWidth:Number = this.listGroup.width + this._paddingLeft + this._paddingRight;
				if(listsWidth > newWidth)
				{
					newWidth = listsWidth;
				}
			}
			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				if(this.currentBackgroundSkin !== null)
				{
					newHeight = this.currentBackgroundSkin.height;
				}
				else
				{
					newHeight = 0;
				}
				var listsHeight:Number = this.listGroup.height + this._paddingTop + this._paddingBottom;
				if(listsHeight > newHeight)
				{
					newHeight = listsHeight;
				}
			}

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * Choose the appropriate background skin based on the control's current
		 * state.
		 */
		protected function refreshBackgroundSkin():void
		{
			var oldBackgroundSkin:DisplayObject = this.currentBackgroundSkin;
			this.currentBackgroundSkin = this.getCurrentBackgroundSkin();
			if(this.currentBackgroundSkin !== oldBackgroundSkin)
			{
				this.removeCurrentBackgroundSkin(oldBackgroundSkin);
				if(this.currentBackgroundSkin !== null)
				{
					if(this.currentBackgroundSkin is IFeathersControl)
					{
						IFeathersControl(this.currentBackgroundSkin).initializeNow();
					}
					if(this.currentBackgroundSkin is IMeasureDisplayObject)
					{
						var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this.currentBackgroundSkin);
						this._explicitBackgroundWidth = measureSkin.explicitWidth;
						this._explicitBackgroundHeight = measureSkin.explicitHeight;
						this._explicitBackgroundMinWidth = measureSkin.explicitMinWidth;
						this._explicitBackgroundMinHeight = measureSkin.explicitMinHeight;
						this._explicitBackgroundMaxWidth = measureSkin.explicitMaxWidth;
						this._explicitBackgroundMaxHeight = measureSkin.explicitMaxHeight;
					}
					else
					{
						this._explicitBackgroundWidth = this.currentBackgroundSkin.width;
						this._explicitBackgroundHeight = this.currentBackgroundSkin.height;
						this._explicitBackgroundMinWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMinHeight = this._explicitBackgroundHeight;
						this._explicitBackgroundMaxWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMaxHeight = this._explicitBackgroundHeight;
					}
					this.addChildAt(this.currentBackgroundSkin, 0);
				}
			}
		}

		/**
		 * @private
		 */
		protected function removeCurrentBackgroundSkin(skin:DisplayObject):void
		{
			if(skin === null)
			{
				return;
			}
			if(skin.parent === this)
			{
				//we need to restore these values so that they won't be lost the
				//next time that this skin is used for measurement
				skin.width = this._explicitBackgroundWidth;
				skin.height = this._explicitBackgroundHeight;
				if(skin is IMeasureDisplayObject)
				{
					var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(skin);
					measureSkin.minWidth = this._explicitBackgroundMinWidth;
					measureSkin.minHeight = this._explicitBackgroundMinHeight;
					measureSkin.maxWidth = this._explicitBackgroundMaxWidth;
					measureSkin.maxHeight = this._explicitBackgroundMaxHeight;
				}
				this.setRequiresRedraw();
				skin.removeFromParent(false);
			}
		}

		/**
		 * @private
		 */
		protected function getCurrentBackgroundSkin():DisplayObject
		{
			if(!this._isEnabled && this._backgroundDisabledSkin !== null)
			{
				return this._backgroundDisabledSkin;
			}
			return this._backgroundSkin;
		}

		/**
		 * @private
		 */
		protected function refreshLists(createNewLists:Boolean, localeChanged:Boolean):void
		{
			if(createNewLists)
			{
				this.createYearList();
				this.createMonthList();
				this.createDateList();

				this.createHourList();
				this.createMinuteList();
				this.createMeridiemList();

				this.createDateAndTimeDateList();
			}
			else if((this._showMeridiem && !this.meridiemList) ||
				(!this._showMeridiem && this.meridiemList))
			{
				//if the locale changes, we may need to create or destroy this
				//list, but the other lists can stay
				this.createMeridiemList();
			}

			if(this._editingMode == DateTimeMode.DATE)
			{
				//does this locale show the month or the date first?
				if(this._monthFirst)
				{
					this.listGroup.setChildIndex(this.monthsList, 0);
				}
				else
				{
					this.listGroup.setChildIndex(this.datesList, 0);
				}
			}

			if(localeChanged)
			{
				if(this.monthsList)
				{
					var monthsCollection:IListCollection = this.monthsList.dataProvider;
					if(monthsCollection)
					{
						monthsCollection.updateAll();
					}
				}
				if(this.dateAndTimeDatesList)
				{
					var dateAndTimeDatesCollection:IListCollection = this.dateAndTimeDatesList.dataProvider;
					if(dateAndTimeDatesCollection)
					{
						dateAndTimeDatesCollection.updateAll();
					}
				}
			}
		}

		/**
		 * @private
		 */
		protected function createYearList():void
		{
			if(this.yearsList)
			{
				this.listGroup.removeChild(this.yearsList, true);
				this.yearsList = null;
			}

			if(this._editingMode !== DateTimeMode.DATE)
			{
				return;
			}

			var listFactory:Function = (this._listFactory !== null) ? this._listFactory : defaultListFactory;
			this.yearsList = SpinnerList(listFactory());
			var listStyleName:String = (this._customListStyleName !== null) ? this._customListStyleName : this.listStyleName;
			this.yearsList.styleNameList.add(listStyleName);
			//we'll set the data provider later, when we know what range
			//of years we need

			//for backwards compatibility, allow the listFactory to take
			//precedence if it also sets itemRendererFactory or
			//customItemRendererStyleName
			if(this._itemRendererFactory !== null)
			{
				this.yearsList.itemRendererFactory = this._itemRendererFactory;
			}
			if(this._customItemRendererStyleName !== null)
			{
				this.yearsList.customItemRendererStyleName = this._customItemRendererStyleName;
			}
			this.yearsList.addEventListener(FeathersEventType.RENDERER_ADD, yearsList_rendererAddHandler);
			this.yearsList.addEventListener(Event.CHANGE, yearsList_changeHandler);
			this.listGroup.addChild(this.yearsList);
		}

		/**
		 * @private
		 */
		protected function createMonthList():void
		{
			if(this.monthsList)
			{
				this.listGroup.removeChild(this.monthsList, true);
				this.monthsList = null;
			}

			if(this._editingMode !== DateTimeMode.DATE)
			{
				return;
			}

			var listFactory:Function = (this._listFactory !== null) ? this._listFactory : defaultListFactory;
			this.monthsList = SpinnerList(listFactory());
			var listStyleName:String = (this._customListStyleName !== null) ? this._customListStyleName : this.listStyleName;
			this.monthsList.styleNameList.add(listStyleName);
			this.monthsList.dataProvider = new IntegerRangeCollection(MIN_MONTH_VALUE, MAX_MONTH_VALUE, 1);
			this.monthsList.typicalItem = this._longestMonthNameIndex;
			//for backwards compatibility, allow the listFactory to take
			//precedence if it also sets itemRendererFactory or
			//customItemRendererStyleName
			if(this._itemRendererFactory !== null)
			{
				this.monthsList.itemRendererFactory = this._itemRendererFactory;
			}
			if(this._customItemRendererStyleName !== null)
			{
				this.monthsList.customItemRendererStyleName = this._customItemRendererStyleName;
			}
			this.monthsList.addEventListener(FeathersEventType.RENDERER_ADD, monthsList_rendererAddHandler);
			this.monthsList.addEventListener(Event.CHANGE, monthsList_changeHandler);
			this.listGroup.addChildAt(this.monthsList, 0);
		}

		/**
		 * @private
		 */
		protected function createDateList():void
		{
			if(this.datesList)
			{
				this.listGroup.removeChild(this.datesList, true);
				this.datesList = null;
			}

			if(this._editingMode !== DateTimeMode.DATE)
			{
				return;
			}

			var listFactory:Function = (this._listFactory !== null) ? this._listFactory : defaultListFactory;
			this.datesList = SpinnerList(listFactory());
			var listStyleName:String = (this._customListStyleName !== null) ? this._customListStyleName : this.listStyleName;
			this.datesList.styleNameList.add(listStyleName);
			this.datesList.dataProvider = new IntegerRangeCollection(MIN_DATE_VALUE, MAX_DATE_VALUE, 1);
			//for backwards compatibility, allow the listFactory to take
			//precedence if it also sets itemRendererFactory or
			//customItemRendererStyleName
			if(this._itemRendererFactory !== null)
			{
				this.datesList.itemRendererFactory = this._itemRendererFactory;
			}
			if(this._customItemRendererStyleName !== null)
			{
				this.datesList.customItemRendererStyleName = this._customItemRendererStyleName;
			}
			this.datesList.addEventListener(FeathersEventType.RENDERER_ADD, datesList_rendererAddHandler);
			this.datesList.addEventListener(Event.CHANGE, datesList_changeHandler);
			this.listGroup.addChildAt(this.datesList, 0);
		}

		/**
		 * @private
		 */
		protected function createHourList():void
		{
			if(this.hoursList)
			{
				this.listGroup.removeChild(this.hoursList, true);
				this.hoursList = null;
			}

			if(this._editingMode === DateTimeMode.DATE)
			{
				return;
			}

			var listFactory:Function = (this._listFactory !== null) ? this._listFactory : defaultListFactory;
			this.hoursList = SpinnerList(listFactory());
			var listStyleName:String = (this._customListStyleName !== null) ? this._customListStyleName : this.listStyleName;
			this.hoursList.styleNameList.add(listStyleName);
			//for backwards compatibility, allow the listFactory to take
			//precedence if it also sets itemRendererFactory or
			//customItemRendererStyleName
			if(this._itemRendererFactory !== null)
			{
				this.hoursList.itemRendererFactory = this._itemRendererFactory;
			}
			if(this._customItemRendererStyleName !== null)
			{
				this.hoursList.customItemRendererStyleName = this._customItemRendererStyleName;
			}
			this.hoursList.addEventListener(FeathersEventType.RENDERER_ADD, hoursList_rendererAddHandler);
			this.hoursList.addEventListener(Event.CHANGE, hoursList_changeHandler);
			this.listGroup.addChild(this.hoursList);
		}

		/**
		 * @private
		 */
		protected function createMinuteList():void
		{
			if(this.minutesList)
			{
				this.listGroup.removeChild(this.minutesList, true);
				this.minutesList = null;
			}

			if(this._editingMode === DateTimeMode.DATE)
			{
				return;
			}

			var listFactory:Function = (this._listFactory !== null) ? this._listFactory : defaultListFactory;
			this.minutesList = SpinnerList(listFactory());
			var listStyleName:String = (this._customListStyleName !== null) ? this._customListStyleName : this.listStyleName;
			this.minutesList.styleNameList.add(listStyleName);
			this.minutesList.dataProvider = new IntegerRangeCollection(MIN_MINUTES_VALUE, MAX_MINUTES_VALUE, this._minuteStep);
			//for backwards compatibility, allow the listFactory to take
			//precedence if it also sets itemRendererFactory or
			//customItemRendererStyleName
			if(this._itemRendererFactory !== null)
			{
				this.minutesList.itemRendererFactory = this._itemRendererFactory;
			}
			if(this._customItemRendererStyleName !== null)
			{
				this.minutesList.customItemRendererStyleName = this._customItemRendererStyleName;
			}
			this.minutesList.addEventListener(FeathersEventType.RENDERER_ADD, minutesList_rendererAddHandler);
			this.minutesList.addEventListener(Event.CHANGE, minutesList_changeHandler);
			this.listGroup.addChild(this.minutesList);
		}

		/**
		 * @private
		 */
		protected function createMeridiemList():void
		{
			if(this.meridiemList)
			{
				this.listGroup.removeChild(this.meridiemList, true);
				this.meridiemList = null;
			}

			if(!this._showMeridiem)
			{
				return;
			}

			var listFactory:Function = (this._listFactory !== null) ? this._listFactory : defaultListFactory;
			this.meridiemList = SpinnerList(listFactory());
			var listStyleName:String = (this._customListStyleName !== null) ? this._customListStyleName : this.listStyleName;
			this.meridiemList.styleNameList.add(listStyleName);
			//for backwards compatibility, allow the listFactory to take
			//precedence if it also sets itemRendererFactory or
			//customItemRendererStyleName
			if(this._itemRendererFactory !== null)
			{
				this.meridiemList.itemRendererFactory = this._itemRendererFactory;
			}
			if(this._customItemRendererStyleName !== null)
			{
				this.meridiemList.customItemRendererStyleName = this._customItemRendererStyleName;
			}
			this.meridiemList.addEventListener(Event.CHANGE, meridiemList_changeHandler);
			this.listGroup.addChild(this.meridiemList);
		}

		/**
		 * @private
		 */
		protected function createDateAndTimeDateList():void
		{
			if(this.dateAndTimeDatesList)
			{
				this.listGroup.removeChild(this.dateAndTimeDatesList, true);
				this.dateAndTimeDatesList = null;
			}

			if(this._editingMode !== DateTimeMode.DATE_AND_TIME)
			{
				return;
			}

			var listFactory:Function = (this._listFactory !== null) ? this._listFactory : defaultListFactory;
			this.dateAndTimeDatesList = SpinnerList(listFactory());
			var listStyleName:String = (this._customListStyleName !== null) ? this._customListStyleName : this.listStyleName;
			this.dateAndTimeDatesList.styleNameList.add(listStyleName);
			//for backwards compatibility, allow the listFactory to take
			//precedence if it also sets itemRendererFactory or
			//customItemRendererStyleName
			if(this._itemRendererFactory !== null)
			{
				this.dateAndTimeDatesList.itemRendererFactory = this._itemRendererFactory;
			}
			if(this._customItemRendererStyleName !== null)
			{
				this.dateAndTimeDatesList.customItemRendererStyleName = this._customItemRendererStyleName;
			}
			this.dateAndTimeDatesList.addEventListener(FeathersEventType.RENDERER_ADD, dateAndTimeDatesList_rendererAddHandler);
			this.dateAndTimeDatesList.addEventListener(Event.CHANGE, dateAndTimeDatesList_changeHandler);
			this.dateAndTimeDatesList.typicalItem = {};
			this.listGroup.addChildAt(this.dateAndTimeDatesList, 0);
		}

		/**
		 * @private
		 */
		protected function refreshLocale():void
		{
			if(!this._formatter || this._formatter.requestedLocaleIDName != this._locale)
			{
				this._formatter = new DateTimeFormatter(this._locale, DateTimeStyle.SHORT, DateTimeStyle.SHORT);
				var dateTimePattern:String = this._formatter.getDateTimePattern();
				//figure out if month or date should be displayed first
				var monthIndex:int = dateTimePattern.indexOf("M");
				var dateIndex:int = dateTimePattern.indexOf("d");
				this._monthFirst = monthIndex < dateIndex;
				//figure out if this locale uses am/pm or 24-hour format
				this._showMeridiem = this._editingMode !== DateTimeMode.DATE && dateTimePattern.indexOf("a") >= 0;
				if(this._showMeridiem)
				{
					this._formatter.setDateTimePattern("a");
					HELPER_DATE.setHours(1);
					//different locales have different names for am and pm
					//as an example, see zh_CN
					this._amString = this._formatter.format(HELPER_DATE);
					HELPER_DATE.setHours(13);
					this._pmString = this._formatter.format(HELPER_DATE);
					this._formatter.setDateTimePattern(dateTimePattern);
				}
			}
			if(this._editingMode === DateTimeMode.DATE)
			{
				this._localeMonthNames = this._formatter.getMonthNames(DateTimeNameStyle.FULL);
				this._localeWeekdayNames = null;
			}
			else if(this._editingMode === DateTimeMode.DATE_AND_TIME)
			{
				this._localeMonthNames = this._formatter.getMonthNames(DateTimeNameStyle.SHORT_ABBREVIATION);
				this._localeWeekdayNames = this._formatter.getWeekdayNames(DateTimeNameStyle.LONG_ABBREVIATION);
			}
			else //time only
			{
				this._localeMonthNames = null;
				this._localeWeekdayNames = null;
			}
			if(this._localeMonthNames !== null)
			{
				this._longestMonthNameIndex = 0;
				var longestMonth:String = this._localeMonthNames[0];
				var monthCount:int = this._localeMonthNames.length;
				for(var i:int = 1; i < monthCount; i++)
				{
					var otherMonthName:String = this._localeMonthNames[i];
					if(otherMonthName.length > longestMonth.length)
					{
						longestMonth = otherMonthName;
						this._longestMonthNameIndex = i;
					}
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshSelection():void
		{
			var oldIgnoreListChanges:Boolean = this._ignoreListChanges;
			this._ignoreListChanges = true;

			if(this._editingMode === DateTimeMode.DATE)
			{
				var yearsCollection:IntegerRangeCollection = IntegerRangeCollection(this.yearsList.dataProvider);
				if(yearsCollection !== null)
				{
					yearsCollection.minimum = this._listMinYear;
					yearsCollection.maximum = this._listMaxYear;
				}
				else
				{
					this.yearsList.dataProvider = new IntegerRangeCollection(this._listMinYear, this._listMaxYear, 1);
				}
			}
			else //time only or both date and time
			{
				var totalMS:Number = this._maximum.time - this._minimum.time;
				var totalDays:int = totalMS / MS_PER_DAY;

				if(this._editingMode === DateTimeMode.DATE_AND_TIME)
				{
					var dateAndTimeDatesCollection:IntegerRangeCollection = IntegerRangeCollection(this.dateAndTimeDatesList.dataProvider);
					if(dateAndTimeDatesCollection !== null)
					{
						dateAndTimeDatesCollection.maximum = totalDays;
					}
					else
					{
						this.dateAndTimeDatesList.dataProvider = new IntegerRangeCollection(0, totalDays, 1);
					}
				}

				var hoursMinimum:Number = MIN_HOURS_VALUE;
				var hoursMaximum:Number = this._showMeridiem ? MAX_HOURS_VALUE_12HOURS : MAX_HOURS_VALUE_24HOURS;
				var hoursCollection:IntegerRangeCollection = IntegerRangeCollection(this.hoursList.dataProvider);
				if(hoursCollection !== null)
				{
					hoursCollection.minimum = hoursMinimum;
					hoursCollection.maximum = hoursMaximum;
				}
				else
				{
					this.hoursList.dataProvider = new IntegerRangeCollection(hoursMinimum, hoursMaximum, 1);
				}

				if(this._showMeridiem && !this.meridiemList.dataProvider)
				{
					this.meridiemList.dataProvider = new VectorCollection(new <String>[this._amString, this._pmString]);
				}
			}

			if(this.monthsList && !this.monthsList.isScrolling)
			{
				this.monthsList.selectedItem = this._value.month;
			}
			if(this.datesList && !this.datesList.isScrolling)
			{
				this.datesList.selectedItem = this._value.date;
			}
			if(this.yearsList && !this.yearsList.isScrolling)
			{
				this.yearsList.selectedItem = this._value.fullYear;
			}

			if(this.dateAndTimeDatesList)
			{
				this.dateAndTimeDatesList.selectedIndex = (this._value.time - this._minimum.time) / MS_PER_DAY;
			}
			if(this.hoursList)
			{
				if(this._showMeridiem)
				{
					this.hoursList.selectedIndex = this._value.hours % 12;
				}
				else
				{
					this.hoursList.selectedIndex = this._value.hours;
				}
			}
			if(this.minutesList)
			{
				this.minutesList.selectedItem = this._value.minutes;
			}
			if(this.meridiemList)
			{
				this.meridiemList.selectedIndex = (this._value.hours <= MAX_HOURS_VALUE_12HOURS) ? 0 : 1;
			}
			this._ignoreListChanges = oldIgnoreListChanges;
		}

		/**
		 * @private
		 */
		protected function refreshEnabled():void
		{
			var listCount:int = this.listGroup.numChildren;
			for(var i:int = 0; i < listCount; i++)
			{
				var list:SpinnerList = SpinnerList(this.listGroup.getChildAt(i));
				list.isEnabled = this._isEnabled;
			}
		}

		/**
		 * @private
		 */
		protected function getMinMonth(year:int):int
		{
			if(year == this._minYear)
			{
				return this._minimum.month;
			}
			return MIN_MONTH_VALUE;
		}

		/**
		 * @private
		 */
		protected function getMaxMonth(year:int):int
		{
			if(year == this._maxYear)
			{
				return this._maximum.month;
			}
			return MAX_MONTH_VALUE;
		}

		/**
		 * @private
		 */
		protected function getMinDate(year:int, month:int):int
		{
			if(year == this._minYear && month == this._minimum.month)
			{
				return this._minimum.date;
			}
			return MIN_DATE_VALUE;
		}

		/**
		 * @private
		 */
		protected function getMaxDate(year:int, month:int):int
		{
			if(year == this._maxYear && month == this._maximum.month)
			{
				return this._maximum.date;
			}
			if(month == 1) //february has a variable number of days
			{
				//subtract one date from march 1st to figure out the last
				//date of february for the specified year
				HELPER_DATE.setFullYear(year, month + 1, -1);
				return HELPER_DATE.date + 1;
			}
			//all other months have been pre-calculated
			return DAYS_IN_MONTH[month];
		}

		/**
		 * @private
		 */
		protected function getMinHours(year:int, month:int, date:int):int
		{
			if(this._editingMode === DateTimeMode.DATE_AND_TIME)
			{
				if(year == this._minYear && month == this._minimum.month &&
					date == this._minimum.date)
				{
					return this._minimum.hours;
				}
				return MIN_HOURS_VALUE;
			}
			return this._minimum.hours;
		}

		/**
		 * @private
		 */
		protected function getMaxHours(year:int, month:int, date:int):int
		{
			if(this._editingMode === DateTimeMode.DATE_AND_TIME)
			{
				if(year == this._maxYear && month == this._maximum.month &&
					date == this._maximum.date)
				{
					return this._maximum.hours;
				}
				return MAX_HOURS_VALUE_24HOURS;
			}
			return this._maximum.hours;
		}

		/**
		 * @private
		 */
		protected function getMinMinutes(year:int, month:int, date:int, hours:int):int
		{
			if(this._editingMode === DateTimeMode.DATE_AND_TIME)
			{
				if(year == this._minYear && month == this._minimum.month &&
					date == this._minimum.date && hours == this._minimum.hours)
				{
					return this._minimum.minutes;
				}
				return MIN_MINUTES_VALUE;
			}
			if(hours == this._minHours)
			{
				return this._minimum.minutes;
			}
			return MIN_MINUTES_VALUE;
		}

		/**
		 * @private
		 */
		protected function getMaxMinutes(year:int, month:int, date:int, hours:int):int
		{
			if(this._editingMode === DateTimeMode.DATE_AND_TIME)
			{
				if(year == this._maxYear && month == this._maximum.month &&
					date == this._maximum.date && hours == this._maximum.hours)
				{
					return this._maximum.minutes;
				}
				return MAX_MINUTES_VALUE;
			}
			if(hours == this._maxHours)
			{
				return this._maximum.minutes;
			}
			return MAX_MINUTES_VALUE;
		}

		/**
		 * @private
		 */
		protected function getValidDateForYearAndMonth(year:int, month:int):int
		{
			var date:int = this._value.date;
			var minDate:int = this.getMinDate(year, month);
			var maxDate:int = this.getMaxDate(year, month);
			if(date < minDate)
			{
				date = minDate;
			}
			else if(date > maxDate)
			{
				date = maxDate;
			}
			return date;
		}

		/**
		 * @private
		 */
		protected function refreshValidRanges():void
		{
			var oldMinYear:int = this._minYear;
			var oldMaxYear:int = this._maxYear;
			var oldMinMonth:int = this._minMonth;
			var oldMaxMonth:int = this._maxMonth;
			var oldMinDate:int = this._minDate;
			var oldMaxDate:int = this._maxDate;
			var oldMinHours:int = this._minHours;
			var oldMaxHours:int = this._maxHours;
			var oldMinMinutes:int = this._minMinute;
			var oldMaxMinutes:int = this._maxMinute;
			var currentYear:int = this._value.fullYear;
			var currentMonth:int = this._value.month;
			var currentDate:int = this._value.date;
			var currentHours:int = this._value.hours;

			this._minYear = this._minimum.fullYear;
			this._maxYear = this._maximum.fullYear;
			this._minMonth = this.getMinMonth(currentYear);
			this._maxMonth = this.getMaxMonth(currentYear);
			this._minDate = this.getMinDate(currentYear, currentMonth);
			this._maxDate = this.getMaxDate(currentYear, currentMonth);
			this._minHours = this.getMinHours(currentYear, currentMonth, currentDate);
			this._maxHours = this.getMaxHours(currentYear, currentMonth, currentDate);
			this._minMinute = this.getMinMinutes(currentYear, currentMonth, currentDate, currentHours);
			this._maxMinute = this.getMaxMinutes(currentYear, currentMonth, currentDate, currentHours);

			//the item renderers in the lists may need to be enabled or disabled
			//after the ranges change, so we need to call updateAll() on the
			//collections

			var yearsCollection:IListCollection = this.yearsList ? this.yearsList.dataProvider : null;
			if(yearsCollection && (oldMinYear != this._minYear || oldMaxYear != this._maxYear))
			{
				//we need to ensure that the item renderers are enabled
				yearsCollection.updateAll();
			}
			var monthsCollection:IListCollection = this.monthsList ? this.monthsList.dataProvider : null;
			if(monthsCollection && (oldMinMonth != this._minMonth || oldMaxMonth != this._maxMonth))
			{
				monthsCollection.updateAll();
			}
			var datesCollection:IListCollection = this.datesList ? this.datesList.dataProvider : null;
			if(datesCollection && (oldMinDate != this._minDate || oldMaxDate != this._maxDate))
			{
				datesCollection.updateAll();
			}
			var dateAndTimeDatesCollection:IListCollection = this.dateAndTimeDatesList ? this.dateAndTimeDatesList.dataProvider : null;
			if(dateAndTimeDatesCollection &&
				(oldMinYear != this._minYear || oldMaxYear != this._maxYear ||
				oldMinMonth != this._minMonth || oldMaxMonth != this._maxMonth ||
				oldMinDate != this._minDate || oldMaxDate != this._maxDate))
			{
				dateAndTimeDatesCollection.updateAll();
			}
			var hoursCollection:IListCollection = this.hoursList ? this.hoursList.dataProvider : null;
			if(hoursCollection && (oldMinHours != this._minHours || oldMaxHours != this._maxHours ||
				(this._showMeridiem && this._lastMeridiemValue != this.meridiemList.selectedIndex)))
			{
				hoursCollection.updateAll();
			}
			var minutesCollection:IListCollection = this.minutesList ? this.minutesList.dataProvider : null;
			if(minutesCollection && (oldMinMinutes != this._minMinute || oldMaxMinutes != this._maxMinute))
			{
				minutesCollection.updateAll();
			}
			if(this._showMeridiem)
			{
				this._lastMeridiemValue = (this._value.hours <= MAX_HOURS_VALUE_12HOURS) ? 0 : 1;
			}
		}

		/**
		 * @private
		 */
		protected function useDefaultsIfNeeded():void
		{
			if(!this._value)
			{
				//if we don't have a value, try to use today's date
				this._value = new Date();
				//but if there's an existing range, keep the value in there
				if(this._minimum && this._value.time < this._minimum.time)
				{
					this._value.time = this._minimum.time;
				}
				else if(this._maximum && this._value.time > this._maximum.time)
				{
					this._value.time = this._maximum.time;
				}
			}
			if(this._minimum)
			{
				//we want to be able to see years outside the range between
				//minimum and maximum, even if we cannot select them. otherwise,
				//it'll look weird to loop back to the beginning or end.
				if(this._editingMode === DateTimeMode.DATE_AND_TIME)
				{
					//in this editing mode, the date is only controlled by one
					//spinner list, that increments by day. we shouldn't need to
					//go back more than a year.
					this._listMinYear = this._minimum.fullYear - 1;
				}
				else
				{
					//in this editing mode, the year, month, and date are
					//selected separately, so we should have a bigger range
					this._listMinYear = this._minimum.fullYear - 10;
				}
			}
			//if there's no minimum, we need to generate something that is
			//arbitrary, but acceptable for most needs
			else if(this._editingMode === DateTimeMode.DATE_AND_TIME)
			{
				//in this editing mode, the date is only controlled by one
				//spinner list, that increments by day. we shouldn't need to
				//go back more than a year.
				HELPER_DATE.time = this._value.time;
				this._listMinYear = HELPER_DATE.fullYear - 1;
				this._minimum = new Date(this._listMinYear, MIN_MONTH_VALUE, MIN_DATE_VALUE,
					MIN_HOURS_VALUE, MIN_MINUTES_VALUE);
			}
			else
			{
				//in this editing mode, the year, month, and date are
				//selected separately, so we should have a bigger range
				HELPER_DATE.time = this._value.time;
				//goes back 100 years, rounded down to the nearest half century
				//for 2015, this would give us 1900
				//for 2065, this would give us 1950
				this._listMinYear = roundDownToNearest(HELPER_DATE.fullYear - 100, 50);
				this._minimum = new Date(this._listMinYear, MIN_MONTH_VALUE, MIN_DATE_VALUE,
					MIN_HOURS_VALUE, MIN_MINUTES_VALUE);
			}
			if(this._maximum)
			{
				if(this._editingMode === DateTimeMode.DATE_AND_TIME)
				{
					this._listMaxYear = this._maximum.fullYear + 1;
				}
				else
				{
					this._listMaxYear = this._maximum.fullYear + 10;
				}
			}
			else if(this._editingMode === DateTimeMode.DATE_AND_TIME)
			{
				//in this editing mode, the date is only controlled by one
				//spinner list, that increments by day. we shouldn't need to
				//go forward more than a year.
				HELPER_DATE.time = this._value.time;
				this._listMaxYear = HELPER_DATE.fullYear + 1;
				this._maximum = new Date(this._listMaxYear, MAX_MONTH_VALUE,
					DAYS_IN_MONTH[MAX_MONTH_VALUE], MAX_HOURS_VALUE_24HOURS,
					MAX_MINUTES_VALUE);
			}
			else //date
			{
				//for 2015, this would give us 2150
				//for 2065, this would give us 2200
				HELPER_DATE.time = this._value.time;
				this._listMaxYear = roundUpToNearest(HELPER_DATE.fullYear + 100, 50);
				this._maximum = new Date(this._listMaxYear, MAX_MONTH_VALUE,
					DAYS_IN_MONTH[MAX_MONTH_VALUE], MAX_HOURS_VALUE_24HOURS,
					MAX_MINUTES_VALUE);
			}
		}

		/**
		 * @private
		 */
		protected function layoutChildren():void
		{
			if(this.currentBackgroundSkin !== null &&
				(this.currentBackgroundSkin.width != this.actualWidth ||
				this.currentBackgroundSkin.height != this.actualHeight))
			{
				this.currentBackgroundSkin.width = this.actualWidth;
				this.currentBackgroundSkin.height = this.actualHeight;
			}
			this.listGroup.x = this._paddingLeft;
			this.listGroup.y = this._paddingTop;
			this.listGroup.width = this.actualWidth - this._paddingLeft - this._paddingRight;
			this.listGroup.height = this.actualHeight - this._paddingTop - this._paddingBottom;
			this.listGroup.validate();
		}

		/**
		 * @private
		 */
		protected function handlePendingScroll():void
		{
			if(!this.pendingScrollToDate)
			{
				return;
			}
			var pendingDate:Date = this.pendingScrollToDate;
			this.pendingScrollToDate = null;
			var duration:Number = this.pendingScrollDuration;
			if(duration !== duration) //isNaN
			{
				duration = this._scrollDuration;
			}
			if(this.yearsList)
			{
				var year:int = pendingDate.fullYear;
				if(this.yearsList.selectedItem != year)
				{
					var yearRange:IntegerRangeCollection = IntegerRangeCollection(this.yearsList.dataProvider);
					this.yearsList.scrollToDisplayIndex(year - yearRange.minimum, duration);
				}
			}
			if(this.monthsList)
			{
				var month:int = pendingDate.month;
				if(this.monthsList.selectedItem != month)
				{
					this.monthsList.scrollToDisplayIndex(month, duration);
				}
			}
			if(this.datesList)
			{
				var date:int = pendingDate.date;
				if(this.datesList.selectedItem != date)
				{
					this.datesList.scrollToDisplayIndex(date - 1, duration);
				}
			}
			if(this.dateAndTimeDatesList)
			{
				var dateIndex:int = (pendingDate.time - this._minimum.time) / MS_PER_DAY;
				if(this.dateAndTimeDatesList.selectedIndex != dateIndex)
				{
					this.dateAndTimeDatesList.scrollToDisplayIndex(dateIndex, duration);
				}
			}
			if(this.hoursList)
			{
				var hours:int = pendingDate.hours;
				if(this._showMeridiem)
				{
					hours %= 12;
				}
				if(this.hoursList.selectedItem != hours)
				{
					this.hoursList.scrollToDisplayIndex(hours, duration);
				}
			}
			if(this.minutesList)
			{
				var minutes:int = pendingDate.minutes;
				if(this.minutesList.selectedItem != minutes)
				{
					this.minutesList.scrollToDisplayIndex(minutes, duration);
				}
			}
			if(this.meridiemList)
			{
				var index:int = (pendingDate.hours < MAX_HOURS_VALUE_12HOURS) ? 0 : 1;
				if(this.meridiemList.selectedIndex != index)
				{
					this.meridiemList.scrollToDisplayIndex(index, duration);
				}
			}
		}

		/**
		 * @private
		 */
		protected function isMonthEnabled(month:int):Boolean
		{
			return month >= this._minMonth && month <= this._maxMonth;
		}

		/**
		 * @private
		 */
		protected function isYearEnabled(year:int):Boolean
		{
			return year >= this._minYear && year <= this._maxYear;
		}

		/**
		 * @private
		 */
		protected function isDateEnabled(date:int):Boolean
		{
			return date >= this._minDate && date <= this._maxDate;
		}

		/**
		 * @private
		 */
		protected function isHourEnabled(hour:int):Boolean
		{
			if(this._showMeridiem && this.meridiemList.selectedIndex != 0)
			{
				hour += 12;
			}
			return hour >= this._minHours && hour <= this._maxHours;
		}

		/**
		 * @private
		 */
		protected function isMinuteEnabled(minute:int):Boolean
		{
			return minute >= this._minMinute && minute <= this._maxMinute;
		}

		/**
		 * @private
		 */
		protected function formatHours(item:int):String
		{
			if(this._showMeridiem)
			{
				if(item == 0)
				{
					item = 12;
				}
				return item.toString();
			}
			var hours:String = item.toString();
			if(hours.length < 2)
			{
				hours = "0" + hours;
			}
			return hours;
		}

		/**
		 * @private
		 */
		protected function formatMinutes(item:int):String
		{
			var minutes:String = item.toString();
			if(minutes.length < 2)
			{
				minutes = "0" + minutes;
			}
			return minutes;
		}

		/**
		 * @private
		 */
		protected function formatDateAndTimeWeekday(item:Object):String
		{
			if(item is int)
			{
				HELPER_DATE.setTime(this._minimum.time);
				HELPER_DATE.setDate(HELPER_DATE.date + item);
				if(this._todayLabel)
				{
					//_lastValidate will be updated once per validation when
					//scrolling, which is better than creating many duplicate Date
					//objects in this function
					if(HELPER_DATE.fullYear == this._lastValidate.fullYear &&
						HELPER_DATE.month == this._lastValidate.month &&
						HELPER_DATE.date == this._lastValidate.date)
					{
						return "";
					}
				}
				return this._localeWeekdayNames[HELPER_DATE.day] as String;
			}
			//this value is used for measurement to try to avoid truncated text.
			//it will not be displayed!
			return "Wom";
		}

		/**
		 * @private
		 */
		protected function formatDateAndTimeDate(item:Object):String
		{
			if(item is int)
			{
				HELPER_DATE.setTime(this._minimum.time);
				HELPER_DATE.setDate(HELPER_DATE.date + item);
				if(this._todayLabel)
				{
					//_lastValidate will be updated once per validation when
					//scrolling, which is better than creating many duplicate Date
					//objects in this function
					if(HELPER_DATE.fullYear == this._lastValidate.fullYear &&
						HELPER_DATE.month == this._lastValidate.month &&
						HELPER_DATE.date == this._lastValidate.date)
					{
						return this._todayLabel;
					}
				}
				var monthName:String = this._localeMonthNames[HELPER_DATE.month] as String;
				if(this._monthFirst)
				{
					return monthName + " " + HELPER_DATE.date;
				}
				return HELPER_DATE.date + " " + monthName;
			}
			//this value is used for measurement to try to avoid truncated text.
			//it will not be displayed!
			return "Wom 30";
		}

		/**
		 * @private
		 */
		protected function formatMonthName(item:int):String
		{
			return this._localeMonthNames[item] as String;
		}

		/**
		 * @private
		 */
		protected function validateNewValue():void
		{
			var currentTime:Number = this._value.time;
			var minimumTime:Number = this._minimum.time;
			var maximumTime:Number = this._maximum.time;
			var needsToScroll:Boolean = false;
			if(currentTime < minimumTime)
			{
				needsToScroll = true;
				this._value.setTime(minimumTime);
			}
			else if(currentTime > maximumTime)
			{
				needsToScroll = true;
				this._value.setTime(maximumTime);
			}
			if(needsToScroll)
			{
				this.scrollToDate(this._value);
			}
		}

		/**
		 * @private
		 */
		protected function updateHoursFromLists():Boolean
		{
			var hours:int = this.hoursList.selectedItem as int;
			if(this.meridiemList && this.meridiemList.selectedIndex == 1)
			{
				hours += 12;
			}
			if(this._value.hours == hours)
			{
				return false;
			}
			this._value.setHours(hours);
			return true;
		}

		/**
		 * @private
		 */
		protected function minutesList_rendererAddHandler(event:Event, itemRenderer:DefaultListItemRenderer):void
		{
			itemRenderer.labelFunction = formatMinutes;
			itemRenderer.enabledFunction = isMinuteEnabled;
			itemRenderer.itemHasEnabled = true;
		}

		/**
		 * @private
		 */
		protected function hoursList_rendererAddHandler(event:Event, itemRenderer:DefaultListItemRenderer):void
		{
			itemRenderer.labelFunction = formatHours;
			itemRenderer.enabledFunction = isHourEnabled;
			itemRenderer.itemHasEnabled = true;
		}

		/**
		 * @private
		 */
		protected function dateAndTimeDatesList_rendererAddHandler(event:Event, itemRenderer:DefaultListItemRenderer):void
		{
			itemRenderer.labelFunction = formatDateAndTimeDate;
			itemRenderer.accessoryLabelFunction = formatDateAndTimeWeekday;
		}

		/**
		 * @private
		 */
		protected function monthsList_rendererAddHandler(event:Event, itemRenderer:DefaultListItemRenderer):void
		{
			itemRenderer.labelFunction = formatMonthName;
			itemRenderer.enabledFunction = isMonthEnabled;
			itemRenderer.itemHasEnabled = true;
		}

		/**
		 * @private
		 */
		protected function datesList_rendererAddHandler(event:Event, itemRenderer:DefaultListItemRenderer):void
		{
			itemRenderer.enabledFunction = isDateEnabled;
			itemRenderer.itemHasEnabled = true;
		}

		/**
		 * @private
		 */
		protected function yearsList_rendererAddHandler(event:Event, itemRenderer:DefaultListItemRenderer):void
		{
			itemRenderer.enabledFunction = isYearEnabled;
			itemRenderer.itemHasEnabled = true;
		}

		/**
		 * @private
		 */
		protected function monthsList_changeHandler(event:Event):void
		{
			if(this._ignoreListChanges)
			{
				return;
			}
			var month:int = this.monthsList.selectedItem as int;
			var date:int = this.getValidDateForYearAndMonth(this._value.fullYear, month);
			var needsToScroll:Boolean = this._value.date != date;
			if(!needsToScroll && this._value.month == month)
			{
				return;
			}
			this._value.setMonth(month, date);
			this.validateNewValue();
			this.refreshValidRanges();
			this.dispatchEventWith(Event.CHANGE);
			if(needsToScroll)
			{
				this.scrollToDate(this._value);
			}
		}

		/**
		 * @private
		 */
		protected function datesList_changeHandler(event:Event):void
		{
			if(this._ignoreListChanges)
			{
				return;
			}
			var date:int = this.datesList.selectedItem as int;
			if(this._value.date == date)
			{
				return;
			}
			this._value.setDate(date);
			this.validateNewValue();
			this.refreshValidRanges();
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected function yearsList_changeHandler(event:Event):void
		{
			if(this._ignoreListChanges)
			{
				return;
			}
			var year:int = this.yearsList.selectedItem as int;
			if(this._value.fullYear == year)
			{
				return;
			}
			this._value.setFullYear(year);
			this.validateNewValue();
			this.refreshValidRanges();
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected function dateAndTimeDatesList_changeHandler(event:Event):void
		{
			if(this._ignoreListChanges)
			{
				return;
			}
			this._value.setFullYear(this._minimum.fullYear, this._minimum.month, this._minimum.date + this.dateAndTimeDatesList.selectedIndex);
			this.validateNewValue();
			this.refreshValidRanges();
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected function hoursList_changeHandler(event:Event):void
		{
			if(this._ignoreListChanges)
			{
				return;
			}
			if(!this.updateHoursFromLists())
			{
				return;
			}
			this.validateNewValue();
			this.refreshValidRanges();
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected function minutesList_changeHandler(event:Event):void
		{
			if(this._ignoreListChanges)
			{
				return;
			}
			var minutes:int = this.minutesList.selectedItem as int;
			if(this._value.minutes == minutes)
			{
				return;
			}
			this._value.setMinutes(minutes);
			this.validateNewValue();
			this.refreshValidRanges();
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected function meridiemList_changeHandler(event:Event):void
		{
			if(this._ignoreListChanges)
			{
				return;
			}
			if(!this.updateHoursFromLists())
			{
				return;
			}
			this.validateNewValue();
			this.refreshValidRanges();
			this.dispatchEventWith(Event.CHANGE);
		}
	}
}

import feathers.data.IListCollection;
import feathers.events.CollectionEventType;

import starling.events.Event;
import starling.events.EventDispatcher;

class IntegerRangeCollection extends EventDispatcher implements IListCollection
{
	public function IntegerRangeCollection(minimum:int = 0, maximum:int = 1, step:int = 1)
	{
		this._minimum = minimum;
		this._maximum = maximum;
		this._step = step;
	}

	protected var _minimum:int;

	public function get minimum():int
	{
		return this._minimum;
	}

	public function set minimum(value:int):void
	{
		if(this._minimum == value)
		{
			return;
		}
		this._minimum = value;
		this.dispatchEventWith(CollectionEventType.RESET);
		this.dispatchEventWith(Event.CHANGE);
	}

	protected var _maximum:int;

	public function get maximum():int
	{
		return this._maximum;
	}

	public function set maximum(value:int):void
	{
		if(this._maximum == value)
		{
			return;
		}
		this._maximum = value;
		this.dispatchEventWith(CollectionEventType.RESET);
		this.dispatchEventWith(Event.CHANGE);
	}

	protected var _step:int;

	public function get step():int
	{
		return this._step;
	}

	public function set step(value:int):void
	{
		if(this._step == value)
		{
			return;
		}
		this._step = value;
		this.dispatchEventWith(CollectionEventType.RESET);
		this.dispatchEventWith(Event.CHANGE);
	}

	public function get filterFunction():Function
	{
		return null;
	}

	public function set filterFunction(value:Function):void
	{
		throw new Error("Not implemented");
	}

	public function get sortCompareFunction():Function
	{
		return null;
	}

	public function set sortCompareFunction(value:Function):void
	{
		throw new Error("Not implemented");
	}

	public function get data():Object
	{
		return null;
	}

	public function set data(value:Object):void
	{
		throw new Error("Not implemented");
	}

	public function get length():int
	{
		return 1 + int((this._maximum - this._minimum) / this._step);
	}

	public function getItemAt(index:int):Object
	{
		var maximum:int = this._maximum;
		var result:int = this._minimum + index * this._step;
		if(result > maximum)
		{
			result = maximum;
		}
		return result;
	}

	public function contains(item:Object):Boolean
	{
		if(!(item is int))
		{
			return false;
		}
		var value:int = item as int;
		return Math.ceil((value - this._minimum) / this._step) != -1;
	}

	public function getItemIndex(item:Object):int
	{
		if(!(item is int))
		{
			return -1;
		}
		var value:int = item as int;
		return Math.ceil((value - this._minimum) / this._step);
	}

	public function refreshFilter():void
	{
		throw new Error("Not implemented");
	}

	public function refresh():void
	{
		throw new Error("Not implemented");
	}

	public function setItemAt(item:Object, index:int):void
	{
		throw new Error("Not implemented");
	}

	public function addItem(item:Object):void
	{
		throw new Error("Not implemented");
	}

	public function addItemAt(item:Object, index:int):void
	{
		throw new Error("Not implemented");
	}

	public function push(item:Object):void
	{
		throw new Error("Not implemented");
	}

	public function shift():Object
	{
		throw new Error("Not implemented");
	}

	public function removeItem(item:Object):void
	{
		throw new Error("Not implemented");
	}

	public function removeItemAt(index:int):Object
	{
		throw new Error("Not implemented");
	}

	public function unshift(item:Object):void
	{
		throw new Error("Not implemented");
	}

	public function removeAll():void
	{
		throw new Error("Not implemented");
	}

	public function pop():Object
	{
		throw new Error("Not implemented");
	}

	public function addAll(collection:IListCollection):void
	{
		throw new Error("Not implemented");
	}

	public function addAllAt(collection:IListCollection, index:int):void
	{
		throw new Error("Not implemented");
	}

	public function reset(collection:IListCollection):void
	{
		throw new Error("Not implemented");
	}

	public function updateItemAt(index:int):void
	{
		this.dispatchEventWith(CollectionEventType.UPDATE_ITEM, false, index);
	}

	public function updateAll():void
	{
		this.dispatchEventWith(CollectionEventType.UPDATE_ALL);
	}

	public function dispose(callback:Function):void
	{
		throw new Error("Not implemented");
	}
}


================================================
FILE: source/feathers/controls/DecelerationRate.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * Deceleration rate, per millisecond.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class DecelerationRate
	{
		/**
		 * The default deceleration rate per millisecond.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const NORMAL:Number = 0.998;

		/**
		 * Decelerates a bit faster than the normal amount.
		 *
		 * @see #NORMAL
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const FAST:Number = 0.99;
	}
}


================================================
FILE: source/feathers/controls/DragGesture.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * Gestures used to drag content.
	 */
	public class DragGesture
	{
		/**
		 * The target may be dragged in the appropriate direction from any
		 * location within its bounds.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const CONTENT:String = "content";

		/**
		 * The target may be dragged in the appropriate direction starting from
		 * near the target's edge.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const EDGE:String = "edge";

		/**
		 * No gesture can be used to drag the target.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const NONE:String = "none";
	}
}


================================================
FILE: source/feathers/controls/Drawers.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.supportClasses.BaseScreenNavigator;
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IValidating;
	import feathers.events.ExclusiveTouch;
	import feathers.events.FeathersEventType;
	import feathers.layout.Orientation;
	import feathers.layout.RelativeDepth;
	import feathers.skins.IStyleProvider;
	import feathers.system.DeviceCapabilities;
	import feathers.utils.display.getDisplayObjectDepthFromStage;
	import feathers.utils.math.roundToNearest;

	import flash.events.KeyboardEvent;
	import flash.geom.Point;
	import flash.ui.Keyboard;
	import flash.utils.getTimer;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Quad;
	import starling.display.Stage;
	import starling.events.Event;
	import starling.events.EventDispatcher;
	import starling.events.ResizeEvent;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	/**
	 * The divider between the bottom drawer and the content when the bottom
	 * drawer is docked.
	 *
	 * <p>In the following example, a <code>Quad</code> is added as the
	 * bottom drawer divider:</p>
	 *
	 * <listing version="3.0">
	 * var divider:Quad = new Quad( 2, 2, 0x999999 );
	 * drawers.bottomDrawerDivider = quad;
	 * drawers.bottomDrawerDockMode = Orientation.BOTH</listing>
	 *
	 * @default null
	 *
	 * @see #bottomDrawer
	 */
	[Style(name="bottomDrawerDivider",type="starling.display.DisplayObject")]

	/**
	 * The divider between the left drawer and the content when the left
	 * drawer is docked.
	 *
	 * <p>In the following example, a <code>Quad</code> is added as the
	 * left drawer divider:</p>
	 *
	 * <listing version="3.0">
	 * var divider:Quad = new Quad( 2, 2, 0x999999 );
	 * drawers.leftDrawerDivider = quad;
	 * drawers.leftDrawerDockMode = Orientation.BOTH</listing>
	 *
	 * @default null
	 *
	 * @see #leftDrawer
	 */
	[Style(name="leftDrawerDivider",type="starling.display.DisplayObject")]

	/**
	 * Determines whether the drawer opens above the content or below it.
	 *
	 * <p>In the following example, the drawers are opened above the
	 * content:</p>
	 *
	 * <listing version="3.0">
	 * drawers.openMode = RelativeDepth.ABOVE;</listing>
	 *
	 * @default feathers.layout.RelativeDepth#BELOW
	 *
	 * @see feathers.layout.RelativeDepth#BELOW
	 * @see feathers.layout.RelativeDepth#ABOVE
	 */
	[Style(name="openMode",type="String")]

	/**
	 * The duration, in seconds, of the animation when a drawer opens or
	 * closes.
	 *
	 * <p>In the following example, the duration of the animation that opens
	 * or closes a drawer is set to 500 milliseconds:</p>
	 *
	 * <listing version="3.0">
	 * drawers.openOrCloseDuration = 0.5;</listing>
	 *
	 * @default 0.25
	 *
	 * @see #style:openOrCloseEase
	 */
	[Style(name="openOrCloseDuration",type="Number")]

	/**
	 * The easing function used for opening or closing the drawers.
	 *
	 * <p>In the following example, the ease of the animation that opens and
	 * closes a drawer is customized:</p>
	 *
	 * <listing version="3.0">
	 * drawers.openOrCloseEase = Transitions.EASE_IN_OUT;</listing>
	 *
	 * @default starling.animation.Transitions.EASE_OUT
	 *
	 * @see http://doc.starling-framework.org/core/starling/animation/Transitions.html starling.animation.Transitions
	 * @see #style:openOrCloseDuration
	 */
	[Style(name="openOrCloseEase",type="Object")]

	/**
	 * An optional display object that appears above the content when a
	 * drawer is open.
	 *
	 * <p>In the following example, a <code>Quad</code> is added as the
	 * overlay skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Quad = new Quad( 10, 10, 0x000000 );
	 * skin.alpha = 0.75;
	 * drawers.overlaySkin = skin;</listing>
	 *
	 * @default null
	 */
	[Style(name="overlaySkin",type="starling.display.DisplayObject")]

	/**
	 * The divider between the right drawer and the content when the right
	 * drawer is docked.
	 *
	 * <p>In the following example, a <code>Quad</code> is added as the
	 * right drawer divider:</p>
	 *
	 * <listing version="3.0">
	 * var divider:Quad = new Quad( 2, 2, 0x999999 );
	 * drawers.rightDrawerDivider = quad;
	 * drawers.rightDrawerDockMode = Orientation.BOTH</listing>
	 *
	 * @default null
	 *
	 * @see #rightDrawer
	 */
	[Style(name="rightDrawerDivider",type="starling.display.DisplayObject")]

	/**
	 * The divider between the top drawer and the content when the top
	 * drawer is docked.
	 *
	 * <p>In the following example, a <code>Quad</code> is added as the
	 * top drawer divider:</p>
	 *
	 * <listing version="3.0">
	 * var divider:Quad = new Quad( 2, 2, 0x999999 );
	 * drawers.topDrawerDivider = quad;
	 * drawers.topDrawerDockMode = Orientation.BOTH</listing>
	 *
	 * @default null
	 *
	 * @see #topDrawer
	 */
	[Style(name="topDrawerDivider",type="starling.display.DisplayObject")]

	/**
	 * Dispatched when the user starts dragging the content to open or close a
	 * drawer.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.BEGIN_INTERACTION
	 * @see #event:endInteraction feathers.events.FeathersEventType.END_INTERACTION
	 */
	[Event(name="beginInteraction",type="starling.events.Event")]

	/**
	 * Dispatched when the user stops dragging the content to open or close a
	 * drawer. The drawer may continue opening or closing after this event is
	 * dispatched if the user interaction has also triggered an animation.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.END_INTERACTION
	 * @see #event:beginInteraction feathers.events.FeathersEventType.BEGIN_INTERACTION
	 */
	[Event(name="endInteraction",type="starling.events.Event")]

	/**
	 * Dispatched when a drawer has completed opening. The <code>data</code>
	 * property of the event indicates which drawer is open.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The drawer that was opened.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.OPEN
	 * @see #event:close starling.events.Event.CLOSE
	 */
	[Event(name="open",type="starling.events.Event")]

	/**
	 * Dispatched when a drawer has completed closing. The <code>data</code>
	 * property of the event indicates which drawer was closed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The drawer that was closed.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CLOSE
	 * @see #event:open starling.events.Event.OPEN
	 */
	[Event(name="close",type="starling.events.Event")]

	/**
	 * A container that displays primary content in the center surrounded by
	 * optional "drawers" that can open and close on the edges. Useful for
	 * mobile-style app menus that slide open from the side of the screen.
	 *
	 * <p>Additionally, each drawer may be individually "docked" in an
	 * always-open state, making this a useful application-level layout
	 * container even if the drawers never need to be hidden. Docking behavior
	 * may be limited to either portrait or landscape, or a drawer may be docked
	 * in both orientations. By default, a drawer is not docked.</p>
	 *
	 * <p>The following example creates an app with a slide out menu to the
	 * left of the main content:</p>
	 *
	 * <listing version="3.0">
	 * var navigator:StackScreenNavigator = new StackScreenNavigator();
	 * var list:List = new List();
	 * // the navigator's screens, the list's data provider, and additional
	 * // properties should be set here.
	 * 
	 * var drawers:Drawers = new Drawers();
	 * drawers.content = navigator;
	 * drawers.leftDrawer = menu;
	 * drawers.leftDrawerToggleEventType = Event.OPEN;
	 * this.addChild( drawers );</listing>
	 *
	 * <p>In the example above, a screen in the <code>StackScreenNavigator</code>
	 * component dispatches an event of type <code>Event.OPEN</code> when it
	 * wants to display the slide out the <code>List</code> that is used as
	 * the left drawer.</p>
	 *
	 * @see ../../../help/drawers.html How to use the Feathers Drawers component
	 *
	 * @productversion Feathers 1.2.0
	 */
	public class Drawers extends FeathersControl
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>Drawers</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * The field used to access the "content event dispatcher" of a
		 * <code>ScreenNavigator</code> component, which happens to be the
		 * currently active screen.
		 *
		 * @see #contentEventDispatcherField
		 * @see feathers.controls.ScreenNavigator
		 */
		protected static const SCREEN_NAVIGATOR_CONTENT_EVENT_DISPATCHER_FIELD:String = "activeScreen";

		/**
		 * @private
		 * The current velocity is given high importance.
		 */
		private static const CURRENT_VELOCITY_WEIGHT:Number = 2.33;

		/**
		 * @private
		 * Older saved velocities are given less importance.
		 */
		private static const VELOCITY_WEIGHTS:Vector.<Number> = new <Number>[1, 1.33, 1.66, 2];

		/**
		 * @private
		 */
		private static const MAXIMUM_SAVED_VELOCITY_COUNT:int = 4;

		/**
		 * @private
		 */
		private static const HELPER_POINT:Point = new Point();

		/**
		 * Constructor.
		 */
		public function Drawers(content:IFeathersControl = null)
		{
			super();
			this.content = content;
			this.addEventListener(Event.ADDED_TO_STAGE, drawers_addedToStageHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, drawers_removedFromStageHandler);
			this.addEventListener(TouchEvent.TOUCH, drawers_touchHandler);
		}

		/**
		 * The event dispatcher that controls opening and closing drawers with
		 * events. Often, the event dispatcher is the content itself, but you
		 * may specify a <code>contentEventDispatcherField</code> to access a
		 * property of the content instead, or you may specify a
		 * <code>contentEventDispatcherFunction</code> to run some more complex
		 * code to access the event dispatcher.
		 *
		 * @see #contentEventDispatcherField
		 * @see #contentEventDispatcherFunction
		 */
		protected var contentEventDispatcher:EventDispatcher;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return Drawers.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _originalContentWidth:Number = NaN;

		/**
		 * @private
		 */
		protected var _originalContentHeight:Number = NaN;

		/**
		 * @private
		 */
		protected var _content:IFeathersControl;

		/**
		 * The primary content displayed in the center of the container.
		 *
		 * <p>If the primary content is a container where you'd prefer to listen
		 * to events from its children, you may need to use properties like
		 * <code>contentEventDispatcherField</code>, <code>contentEventDispatcherFunction</code>,
		 * and <code>contentEventDispatcherChangeEventType</code> to ensure that
		 * open and close events for drawers are correctly mapped to the correct
		 * event dispatcher. If the content is dispatching the events, then those
		 * properties should be set to <code>null</code>.</p>
		 *
		 * <p>In the following example, a <code>StackScreenNavigator</code> is added
		 * as the content:</p>
		 *
		 * <listing version="3.0">
		 * var navigator:StackScreenNavigator = new StackScreenNavigator();
		 * // additional code to add the screens can go here
		 * drawers.content = navigator;</listing>
		 *
		 * @default null
		 *
		 * @see #contentEventDispatcherField
		 * @see #contentEventDispatcherFunction
		 * @see #contentEventDispatcherChangeEventType
		 */
		public function get content():IFeathersControl
		{
			return this._content;
		}

		/**
		 * @private
		 */
		public function set content(value:IFeathersControl):void
		{
			if(this._content === value)
			{
				return;
			}
			if(this._content)
			{
				if(this._contentEventDispatcherChangeEventType)
				{
					this._content.removeEventListener(this._contentEventDispatcherChangeEventType, content_eventDispatcherChangeHandler);
				}
				this._content.removeEventListener(FeathersEventType.RESIZE, content_resizeHandler);
				if(this._content.parent === this)
				{
					this.removeChild(DisplayObject(this._content), false);
				}
			}
			this._content = value;
			this._originalContentWidth = NaN;
			this._originalContentHeight = NaN;
			if(this._content)
			{
				if(this._content is BaseScreenNavigator)
				{
					this.contentEventDispatcherField = SCREEN_NAVIGATOR_CONTENT_EVENT_DISPATCHER_FIELD;
					this.contentEventDispatcherChangeEventType = Event.CHANGE;
				}
				if(this._contentEventDispatcherChangeEventType)
				{
					this._content.addEventListener(this._contentEventDispatcherChangeEventType, content_eventDispatcherChangeHandler);
				}
				if(this._autoSizeMode === AutoSizeMode.CONTENT || !this.stage)
				{
					this._content.addEventListener(FeathersEventType.RESIZE, content_resizeHandler);
				}
				if(this._openMode === RelativeDepth.ABOVE)
				{
					this.addChildAt(DisplayObject(this._content), 0);
				}
				else //below
				{
					//the content should appear under the overlay skin, if it exists
					if(this._overlaySkin)
					{
						this.addChildAt(DisplayObject(this._content), this.getChildIndex(this._overlaySkin));
					}
					else
					{
						this.addChild(DisplayObject(this._content));
					}
				}
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _overlaySkinOriginalAlpha:Number = 1;

		/**
		 * @private
		 */
		protected var _overlaySkin:DisplayObject;

		/**
		 * @private
		 */
		public function get overlaySkin():DisplayObject
		{
			return this._overlaySkin;
		}

		/**
		 * @private
		 */
		public function set overlaySkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._overlaySkin === value)
			{
				return;
			}
			if(this._overlaySkin && this._overlaySkin.parent == this)
			{
				this.removeChild(this._overlaySkin, false);
			}
			this._overlaySkin = value;
			if(this._overlaySkin)
			{
				this._overlaySkinOriginalAlpha = this._overlaySkin.alpha;
				this._overlaySkin.visible = this.isTopDrawerOpen || this.isRightDrawerOpen || this.isBottomDrawerOpen || this.isLeftDrawerOpen;
				this.addChild(this._overlaySkin);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _originalTopDrawerWidth:Number = NaN;

		/**
		 * @private
		 */
		protected var _originalTopDrawerHeight:Number = NaN;

		/**
		 * @private
		 */
		protected var _topDrawer:IFeathersControl;

		/**
		 * The drawer that appears above the primary content.
		 *
		 * <p>In the following example, a <code>List</code> is added as the
		 * top drawer:</p>
		 *
		 * <listing version="3.0">
		 * var list:List = new List();
		 * // set data provider and other properties here
		 * drawers.topDrawer = list;</listing>
		 *
		 * @default null
		 *
		 * @see #topDrawerDockMode
		 * @see #topDrawerToggleEventType
		 */
		public function get topDrawer():IFeathersControl
		{
			return this._topDrawer;
		}

		/**
		 * @private
		 */
		public function set topDrawer(value:IFeathersControl):void
		{
			if(this._topDrawer === value)
			{
				return;
			}
			if(this.isTopDrawerOpen && value === null)
			{
				this.isTopDrawerOpen = false;
			}
			if(this._topDrawer && this._topDrawer.parent === this)
			{
				this.removeChild(DisplayObject(this._topDrawer), false);
			}
			this._topDrawer = value;
			this._originalTopDrawerWidth = NaN;
			this._originalTopDrawerHeight = NaN;
			if(this._topDrawer)
			{
				this._topDrawer.visible = false;
				this._topDrawer.addEventListener(FeathersEventType.RESIZE, drawer_resizeHandler);
				if(this._openMode === RelativeDepth.ABOVE)
				{
					this.addChild(DisplayObject(this._topDrawer));
				}
				else //below
				{
					this.addChildAt(DisplayObject(this._topDrawer), 0);
				}
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _topDrawerDivider:DisplayObject;

		/**
		 * @private
		 */
		public function get topDrawerDivider():DisplayObject
		{
			return this._topDrawerDivider;
		}

		/**
		 * @private
		 */
		public function set topDrawerDivider(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._topDrawerDivider === value)
			{
				return;
			}
			if(this._topDrawerDivider && this._topDrawerDivider.parent == this)
			{
				this.removeChild(this._topDrawerDivider, false);
			}
			this._topDrawerDivider = value;
			if(this._topDrawerDivider)
			{
				this._topDrawerDivider.visible = false;
				this.addChild(this._topDrawerDivider);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _topDrawerDockMode:String = Orientation.NONE;

		[Inspectable(type="String",enumeration="portrait,landscape,both,none")]
		/**
		 * Determines if the top drawer is docked in all, some, or no stage
		 * orientations. The current stage orientation is determined by
		 * calculating the aspect ratio of the stage.
		 *
		 * <p>In the following example, the top drawer is docked in the
		 * landscape stage orientation:</p>
		 *
		 * <listing version="3.0">
		 * drawers.topDrawerDockMode = Orientation.LANDSCAPE;</listing>
		 *
		 * @default feathers.layout.Orientation.NONE
		 *
		 * @see feathers.layout.Orientation#PORTRAIT
		 * @see feathers.layout.Orientation#LANDSCAPE
		 * @see feathers.layout.Orientation#NONE
		 * @see feathers.layout.Orientation#BOTH
		 * @see #topDrawer
		 */
		public function get topDrawerDockMode():String
		{
			return this._topDrawerDockMode;
		}

		/**
		 * @private
		 */
		public function set topDrawerDockMode(value:String):void
		{
			if(this._topDrawerDockMode == value)
			{
				return;
			}
			this._topDrawerDockMode = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _topDrawerToggleEventType:String;

		/**
		 * When this event is dispatched by the content event dispatcher, the
		 * top drawer will toggle open and closed.
		 *
		 * <p>In the following example, the top drawer is toggled when the
		 * content dispatches an event of type <code>Event.OPEN</code>:</p>
		 *
		 * <listing version="3.0">
		 * drawers.topDrawerToggleEventType = Event.OPEN;</listing>
		 *
		 * @default null
		 *
		 * @see #content
		 * @see #topDrawer
		 */
		public function get topDrawerToggleEventType():String
		{
			return this._topDrawerToggleEventType;
		}

		/**
		 * @private
		 */
		public function set topDrawerToggleEventType(value:String):void
		{
			if(this._topDrawerToggleEventType == value)
			{
				return;
			}
			if(this.contentEventDispatcher && this._topDrawerToggleEventType)
			{
				this.contentEventDispatcher.removeEventListener(this._topDrawerToggleEventType, content_topDrawerToggleEventTypeHandler);
			}
			this._topDrawerToggleEventType = value;
			if(this.contentEventDispatcher && this._topDrawerToggleEventType)
			{
				this.contentEventDispatcher.addEventListener(this._topDrawerToggleEventType, content_topDrawerToggleEventTypeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _isTopDrawerOpen:Boolean = false;

		/**
		 * Indicates if the top drawer is currently open. If you want to check
		 * if the top drawer is docked, check <code>isTopDrawerDocked</code>
		 * instead.
		 *
		 * <p>To animate the top drawer open or closed, call
		 * <code>toggleTopDrawer()</code>. Setting <code>isTopDrawerOpen</code>
		 * will open or close the top drawer without animation.</p>
		 *
		 * <p>In the following example, we check if the top drawer is open:</p>
		 *
		 * <listing version="3.0">
		 * if( drawers.isTopDrawerOpen )
		 * {
		 *     // do something
		 * }</listing>
		 *
		 * @default false
		 *
		 * @see #isTopDrawerDocked
		 * @see #topDrawer
		 * @see #toggleTopDrawer()
		 */
		public function get isTopDrawerOpen():Boolean
		{
			return this._topDrawer && this._isTopDrawerOpen;
		}

		/**
		 * @private
		 */
		public function set isTopDrawerOpen(value:Boolean):void
		{
			if(this.isTopDrawerDocked || this._isTopDrawerOpen == value)
			{
				return;
			}
			if(value)
			{
				this.isRightDrawerOpen = false;
				this.isBottomDrawerOpen = false;
				this.isLeftDrawerOpen = false;
			}
			this._isTopDrawerOpen = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * Indicates if the top drawer is currently docked. Docking behavior of
		 * the top drawer is controlled with the <code>topDrawerDockMode</code>
		 * property. To check if the top drawer is open, but not docked, use
		 * the <code>isTopDrawerOpen</code> property.
		 *
		 * @see #topDrawer
		 * @see #topDrawerDockMode
		 * @see #isTopDrawerOpen
		 */
		public function get isTopDrawerDocked():Boolean
		{
			if(!this._topDrawer)
			{
				return false;
			}
			if(this._topDrawerDockMode === Orientation.BOTH)
			{
				return true;
			}
			if(this._topDrawerDockMode === Orientation.NONE)
			{
				return false;
			}
			var stage:Stage = this.stage;
			if(stage === null)
			{
				//fall back to the current stage, but it may be wrong...
				stage = Starling.current.stage;
			}
			if(stage.stageWidth > stage.stageHeight)
			{
				return this._topDrawerDockMode === Orientation.LANDSCAPE;
			}
			return this._topDrawerDockMode === Orientation.PORTRAIT;
		}

		/**
		 * @private
		 */
		protected var _originalRightDrawerWidth:Number = NaN;

		/**
		 * @private
		 */
		protected var _originalRightDrawerHeight:Number = NaN;

		/**
		 * @private
		 */
		protected var _rightDrawer:IFeathersControl;

		/**
		 * The drawer that appears to the right of the primary content.
		 *
		 * <p>In the following example, a <code>List</code> is added as the
		 * right drawer:</p>
		 *
		 * <listing version="3.0">
		 * var list:List = new List();
		 * // set data provider and other properties here
		 * drawers.rightDrawer = list;</listing>
		 *
		 * @default null
		 *
		 * @see #rightDrawerDockMode
		 * @see #rightDrawerToggleEventType
		 */
		public function get rightDrawer():IFeathersControl
		{
			return this._rightDrawer;
		}

		/**
		 * @private
		 */
		public function set rightDrawer(value:IFeathersControl):void
		{
			if(this._rightDrawer == value)
			{
				return;
			}
			if(this.isRightDrawerOpen && value === null)
			{
				this.isRightDrawerOpen = false;
			}
			if(this._rightDrawer && this._rightDrawer.parent == this)
			{
				this.removeChild(DisplayObject(this._rightDrawer), false);
			}
			this._rightDrawer = value;
			this._originalRightDrawerWidth = NaN;
			this._originalRightDrawerHeight = NaN;
			if(this._rightDrawer)
			{
				this._rightDrawer.visible = false;
				this._rightDrawer.addEventListener(FeathersEventType.RESIZE, drawer_resizeHandler);
				if(this._openMode === RelativeDepth.ABOVE)
				{
					this.addChild(DisplayObject(this._rightDrawer));
				}
				else //below
				{
					this.addChildAt(DisplayObject(this._rightDrawer), 0);
				}
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _rightDrawerDivider:DisplayObject;

		/**
		 * @private
		 */
		public function get rightDrawerDivider():DisplayObject
		{
			return this._rightDrawerDivider;
		}

		/**
		 * @private
		 */
		public function set rightDrawerDivider(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._rightDrawerDivider === value)
			{
				return;
			}
			if(this._rightDrawerDivider && this._rightDrawerDivider.parent == this)
			{
				this.removeChild(this._rightDrawerDivider, false);
			}
			this._rightDrawerDivider = value;
			if(this._rightDrawerDivider)
			{
				this._rightDrawerDivider.visible = false;
				this.addChild(this._rightDrawerDivider);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _rightDrawerDockMode:String = Orientation.NONE;

		[Inspectable(type="String",enumeration="portrait,landscape,both,none")]
		/**
		 * Determines if the right drawer is docked in all, some, or no stage
		 * orientations. The current stage orientation is determined by
		 * calculating the aspect ratio of the stage.
		 *
		 * <p>In the following example, the right drawer is docked in the
		 * landscape stage orientation:</p>
		 *
		 * <listing version="3.0">
		 * drawers.rightDrawerDockMode = Orientation.LANDSCAPE;</listing>
		 *
		 * @default feathers.layout.Orientation.NONE
		 *
		 * @see feathers.layout.Orientation#PORTRAIT
		 * @see feathers.layout.Orientation#LANDSCAPE
		 * @see feathers.layout.Orientation#NONE
		 * @see feathers.layout.Orientation#BOTH
		 * @see #rightDrawer
		 */
		public function get rightDrawerDockMode():String
		{
			return this._rightDrawerDockMode;
		}

		/**
		 * @private
		 */
		public function set rightDrawerDockMode(value:String):void
		{
			if(this._rightDrawerDockMode == value)
			{
				return;
			}
			this._rightDrawerDockMode = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _rightDrawerToggleEventType:String;

		/**
		 * When this event is dispatched by the content event dispatcher, the
		 * right drawer will toggle open and closed.
		 *
		 * <p>In the following example, the right drawer is toggled when the
		 * content dispatches an event of type <code>Event.OPEN</code>:</p>
		 *
		 * <listing version="3.0">
		 * drawers.rightDrawerToggleEventType = Event.OPEN;</listing>
		 *
		 * @default null
		 *
		 * @see #content
		 * @see #rightDrawer
		 */
		public function get rightDrawerToggleEventType():String
		{
			return this._rightDrawerToggleEventType;
		}

		/**
		 * @private
		 */
		public function set rightDrawerToggleEventType(value:String):void
		{
			if(this._rightDrawerToggleEventType == value)
			{
				return;
			}
			if(this.contentEventDispatcher && this._rightDrawerToggleEventType)
			{
				this.contentEventDispatcher.removeEventListener(this._rightDrawerToggleEventType, content_rightDrawerToggleEventTypeHandler);
			}
			this._rightDrawerToggleEventType = value;
			if(this.contentEventDispatcher && this._rightDrawerToggleEventType)
			{
				this.contentEventDispatcher.addEventListener(this._rightDrawerToggleEventType, content_rightDrawerToggleEventTypeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _isRightDrawerOpen:Boolean = false;

		/**
		 * Indicates if the right drawer is currently open. If you want to check
		 * if the right drawer is docked, check <code>isRightDrawerDocked</code>
		 * instead.
		 *
		 * <p>To animate the right drawer open or closed, call
		 * <code>toggleRightDrawer()</code>. Setting <code>isRightDrawerOpen</code>
		 * will open or close the right drawer without animation.</p>
		 *
		 * <p>In the following example, we check if the right drawer is open:</p>
		 *
		 * <listing version="3.0">
		 * if( drawers.isRightDrawerOpen )
		 * {
		 *     // do something
		 * }</listing>
		 *
		 * @default false
		 *
		 * @see #rightDrawer
		 * @see #rightDrawerDockMode
		 * @see #toggleRightDrawer()
		 */
		public function get isRightDrawerOpen():Boolean
		{
			return this._rightDrawer && this._isRightDrawerOpen;
		}

		/**
		 * @private
		 */
		public function set isRightDrawerOpen(value:Boolean):void
		{
			if(this.isRightDrawerDocked || this._isRightDrawerOpen == value)
			{
				return;
			}
			if(value)
			{
				this.isTopDrawerOpen = false;
				this.isBottomDrawerOpen = false;
				this.isLeftDrawerOpen = false;
			}
			this._isRightDrawerOpen = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * Indicates if the right drawer is currently docked. Docking behavior of
		 * the right drawer is controlled with the <code>rightDrawerDockMode</code>
		 * property. To check if the right drawer is open, but not docked, use
		 * the <code>isRightDrawerOpen</code> property.
		 *
		 * @see #rightDrawer
		 * @see #rightDrawerDockMode
		 * @see #isRightDrawerOpen
		 */
		public function get isRightDrawerDocked():Boolean
		{
			if(!this._rightDrawer)
			{
				return false;
			}
			if(this._rightDrawerDockMode === Orientation.BOTH)
			{
				return true;
			}
			if(this._rightDrawerDockMode === Orientation.NONE)
			{
				return false;
			}
			var stage:Stage = this.stage;
			if(stage === null)
			{
				//fall back to the current stage, but it may be wrong...
				stage = Starling.current.stage;
			}
			if(stage.stageWidth > stage.stageHeight)
			{
				return this._rightDrawerDockMode === Orientation.LANDSCAPE;
			}
			return this._rightDrawerDockMode === Orientation.PORTRAIT;
		}

		/**
		 * @private
		 */
		protected var _originalBottomDrawerWidth:Number = NaN;

		/**
		 * @private
		 */
		protected var _originalBottomDrawerHeight:Number = NaN;

		/**
		 * @private
		 */
		protected var _bottomDrawer:IFeathersControl;

		/**
		 * The drawer that appears below the primary content.
		 *
		 * <p>In the following example, a <code>List</code> is added as the
		 * bottom drawer:</p>
		 *
		 * <listing version="3.0">
		 * var list:List = new List();
		 * // set data provider and other properties here
		 * drawers.bottomDrawer = list;</listing>
		 *
		 * @default null
		 *
		 * @see #bottomDrawerDockMode
		 * @see #bottomDrawerToggleEventType
		 */
		public function get bottomDrawer():IFeathersControl
		{
			return this._bottomDrawer;

		}

		/**
		 * @private
		 */
		public function set bottomDrawer(value:IFeathersControl):void
		{
			if(this._bottomDrawer === value)
			{
				return;
			}
			if(this.isBottomDrawerOpen && value === null)
			{
				this.isBottomDrawerOpen = false;
			}
			if(this._bottomDrawer && this._bottomDrawer.parent === this)
			{
				this.removeChild(DisplayObject(this._bottomDrawer), false);
			}
			this._bottomDrawer = value;
			this._originalBottomDrawerWidth = NaN;
			this._originalBottomDrawerHeight = NaN;
			if(this._bottomDrawer)
			{
				this._bottomDrawer.visible = false;
				this._bottomDrawer.addEventListener(FeathersEventType.RESIZE, drawer_resizeHandler);
				if(this._openMode === RelativeDepth.ABOVE)
				{
					this.addChild(DisplayObject(this._bottomDrawer));
				}
				else //below
				{
					this.addChildAt(DisplayObject(this._bottomDrawer), 0);
				}
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _bottomDrawerDivider:DisplayObject;

		/**
		 * @private
		 */
		public function get bottomDrawerDivider():DisplayObject
		{
			return this._bottomDrawerDivider;
		}

		/**
		 * @private
		 */
		public function set bottomDrawerDivider(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._bottomDrawerDivider === value)
			{
				return;
			}
			if(this._bottomDrawerDivider && this._bottomDrawerDivider.parent == this)
			{
				this.removeChild(this._bottomDrawerDivider, false);
			}
			this._bottomDrawerDivider = value;
			if(this._bottomDrawerDivider)
			{
				this._bottomDrawerDivider.visible = false;
				this.addChild(this._bottomDrawerDivider);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _bottomDrawerDockMode:String = Orientation.NONE;

		[Inspectable(type="String",enumeration="portrait,landscape,both,none")]
		/**
		 * Determines if the bottom drawer is docked in all, some, or no stage
		 * orientations. The current stage orientation is determined by
		 * calculating the aspect ratio of the stage.
		 *
		 * <p>In the following example, the bottom drawer is docked in the
		 * landscape stage orientation:</p>
		 *
		 * <listing version="3.0">
		 * drawers.bottomDrawerDockMode = Orientation.LANDSCAPE;</listing>
		 *
		 * @default feathers.layout.Orientation.NONE
		 *
		 * @see feathers.layout.Orientation#PORTRAIT
		 * @see feathers.layout.Orientation#LANDSCAPE
		 * @see feathers.layout.Orientation#NONE
		 * @see feathers.layout.Orientation#BOTH
		 * @see #bottomDrawer
		 */
		public function get bottomDrawerDockMode():String
		{
			return this._bottomDrawerDockMode;
		}

		/**
		 * @private
		 */
		public function set bottomDrawerDockMode(value:String):void
		{
			if(this._bottomDrawerDockMode == value)
			{
				return;
			}
			this._bottomDrawerDockMode = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _bottomDrawerToggleEventType:String;

		/**
		 * When this event is dispatched by the content event dispatcher, the
		 * bottom drawer will toggle open and closed.
		 *
		 * <p>In the following example, the bottom drawer is toggled when the
		 * content dispatches an event of type <code>Event.OPEN</code>:</p>
		 *
		 * <listing version="3.0">
		 * drawers.bottomDrawerToggleEventType = Event.OPEN;</listing>
		 *
		 * @default null
		 *
		 * @see #content
		 * @see #bottomDrawer
		 */
		public function get bottomDrawerToggleEventType():String
		{
			return this._bottomDrawerToggleEventType;
		}

		/**
		 * @private
		 */
		public function set bottomDrawerToggleEventType(value:String):void
		{
			if(this._bottomDrawerToggleEventType == value)
			{
				return;
			}
			if(this.contentEventDispatcher && this._bottomDrawerToggleEventType)
			{
				this.contentEventDispatcher.removeEventListener(this._bottomDrawerToggleEventType, content_bottomDrawerToggleEventTypeHandler);
			}
			this._bottomDrawerToggleEventType = value;
			if(this.contentEventDispatcher && this._bottomDrawerToggleEventType)
			{
				this.contentEventDispatcher.addEventListener(this._bottomDrawerToggleEventType, content_bottomDrawerToggleEventTypeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _isBottomDrawerOpen:Boolean = false;

		/**
		 * Indicates if the bottom drawer is currently open. If you want to check
		 * if the bottom drawer is docked, check <code>isBottomDrawerDocked</code>
		 * instead.
		 *
		 * <p>To animate the bottom drawer open or closed, call
		 * <code>toggleBottomDrawer()</code>. Setting <code>isBottomDrawerOpen</code>
		 * will open or close the bottom drawer without animation.</p>
		 *
		 * <p>In the following example, we check if the bottom drawer is open:</p>
		 *
		 * <listing version="3.0">
		 * if( drawers.isBottomDrawerOpen )
		 * {
		 *     // do something
		 * }</listing>
		 *
		 * @default false
		 *
		 * @see #bottomDrawer
		 * @see #isBottomDrawerOpen
		 * @see #toggleBottomDrawer()
		 */
		public function get isBottomDrawerOpen():Boolean
		{
			return this._bottomDrawer && this._isBottomDrawerOpen;
		}

		/**
		 * @private
		 */
		public function set isBottomDrawerOpen(value:Boolean):void
		{
			if(this.isBottomDrawerDocked || this._isBottomDrawerOpen == value)
			{
				return;
			}
			if(value)
			{
				this.isTopDrawerOpen = false;
				this.isRightDrawerOpen = false;
				this.isLeftDrawerOpen = false;
			}
			this._isBottomDrawerOpen = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * Indicates if the bottom drawer is currently docked. Docking behavior of
		 * the bottom drawer is controlled with the <code>bottomDrawerDockMode</code>
		 * property. To check if the bottom drawer is open, but not docked, use
		 * the <code>isBottomDrawerOpen</code> property.
		 *
		 * @see #bottomDrawer
		 * @see #bottomDrawerDockMode
		 * @see #isBottomDrawerOpen
		 */
		public function get isBottomDrawerDocked():Boolean
		{
			if(!this._bottomDrawer)
			{
				return false;
			}
			if(this._bottomDrawerDockMode === Orientation.BOTH)
			{
				return true;
			}
			if(this._bottomDrawerDockMode === Orientation.NONE)
			{
				return false;
			}
			var stage:Stage = this.stage;
			if(stage === null)
			{
				//fall back to the current stage, but it may be wrong...
				stage = Starling.current.stage;
			}
			if(stage.stageWidth > stage.stageHeight)
			{
				return this._bottomDrawerDockMode === Orientation.LANDSCAPE;
			}
			return this._bottomDrawerDockMode === Orientation.PORTRAIT;
		}

		/**
		 * @private
		 */
		protected var _originalLeftDrawerWidth:Number = NaN;

		/**
		 * @private
		 */
		protected var _originalLeftDrawerHeight:Number = NaN;

		/**
		 * @private
		 */
		protected var _leftDrawer:IFeathersControl;

		/**
		 * The drawer that appears below the primary content.
		 *
		 * <p>In the following example, a <code>List</code> is added as the
		 * left drawer:</p>
		 *
		 * <listing version="3.0">
		 * var list:List = new List();
		 * // set data provider and other properties here
		 * drawers.leftDrawer = list;</listing>
		 *
		 * @default null
		 *
		 * @see #leftDrawerDockMode
		 * @see #leftDrawerToggleEventType
		 */
		public function get leftDrawer():IFeathersControl
		{
			return this._leftDrawer;
		}

		/**
		 * @private
		 */
		public function set leftDrawer(value:IFeathersControl):void
		{
			if(this._leftDrawer === value)
			{
				return;
			}
			if(this.isLeftDrawerOpen && value === null)
			{
				this.isLeftDrawerOpen = false;
			}
			if(this._leftDrawer && this._leftDrawer.parent === this)
			{
				this.removeChild(DisplayObject(this._leftDrawer), false);
			}
			this._leftDrawer = value;
			this._originalLeftDrawerWidth = NaN;
			this._originalLeftDrawerHeight = NaN;
			if(this._leftDrawer)
			{
				this._leftDrawer.visible = false;
				this._leftDrawer.addEventListener(FeathersEventType.RESIZE, drawer_resizeHandler);
				if(this._openMode === RelativeDepth.ABOVE)
				{
					this.addChild(DisplayObject(this._leftDrawer));
				}
				else //below
				{
					this.addChildAt(DisplayObject(this._leftDrawer), 0);
				}
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _leftDrawerDivider:DisplayObject;

		/**
		 * @private
		 */
		public function get leftDrawerDivider():DisplayObject
		{
			return this._leftDrawerDivider;
		}

		/**
		 * @private
		 */
		public function set leftDrawerDivider(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._leftDrawerDivider === value)
			{
				return;
			}
			if(this._leftDrawerDivider && this._leftDrawerDivider.parent == this)
			{
				this.removeChild(this._leftDrawerDivider, false);
			}
			this._leftDrawerDivider = value;
			if(this._leftDrawerDivider)
			{
				this._leftDrawerDivider.visible = false;
				this.addChild(this._leftDrawerDivider);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _leftDrawerDockMode:String = Orientation.NONE;

		[Inspectable(type="String",enumeration="portrait,landscape,both,none")]
		/**
		 * Determines if the left drawer is docked in all, some, or no stage
		 * orientations. The current stage orientation is determined by
		 * calculating the aspect ratio of the stage.
		 *
		 * <p>In the following example, the left drawer is docked in the
		 * landscape stage orientation:</p>
		 *
		 * <listing version="3.0">
		 * drawers.leftDrawerDockMode = Orientation.LANDSCAPE;</listing>
		 *
		 * @default feathers.layout.Orientation.NONE
		 *
		 * @see feathers.layout.Orientation#PORTRAIT
		 * @see feathers.layout.Orientation#LANDSCAPE
		 * @see feathers.layout.Orientation#NONE
		 * @see feathers.layout.Orientation#BOTH
		 * @see #leftDrawer
		 */
		public function get leftDrawerDockMode():String
		{
			return this._leftDrawerDockMode;
		}

		/**
		 * @private
		 */
		public function set leftDrawerDockMode(value:String):void
		{
			if(this._leftDrawerDockMode == value)
			{
				return;
			}
			this._leftDrawerDockMode = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _leftDrawerToggleEventType:String;

		/**
		 * When this event is dispatched by the content event dispatcher, the
		 * left drawer will toggle open and closed.
		 *
		 * <p>In the following example, the left drawer is toggled when the
		 * content dispatches and event of type <code>Event.OPEN</code>:</p>
		 *
		 * <listing version="3.0">
		 * drawers.leftDrawerToggleEventType = Event.OPEN;</listing>
		 *
		 * @default null
		 *
		 * @see #content
		 * @see #leftDrawer
		 */
		public function get leftDrawerToggleEventType():String
		{
			return this._leftDrawerToggleEventType;
		}

		/**
		 * @private
		 */
		public function set leftDrawerToggleEventType(value:String):void
		{
			if(this._leftDrawerToggleEventType == value)
			{
				return;
			}
			if(this.contentEventDispatcher && this._leftDrawerToggleEventType)
			{
				this.contentEventDispatcher.removeEventListener(this._leftDrawerToggleEventType, content_leftDrawerToggleEventTypeHandler);
			}
			this._leftDrawerToggleEventType = value;
			if(this.contentEventDispatcher && this._leftDrawerToggleEventType)
			{
				this.contentEventDispatcher.addEventListener(this._leftDrawerToggleEventType, content_leftDrawerToggleEventTypeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _isLeftDrawerOpen:Boolean = false;

		/**
		 * Indicates if the left drawer is currently open. If you want to check
		 * if the left drawer is docked, check <code>isLeftDrawerDocked</code>
		 * instead.
		 *
		 * <p>To animate the left drawer open or closed, call
		 * <code>toggleLeftDrawer()</code>. Setting <code>isLeftDrawerOpen</code>
		 * will open or close the left drawer without animation.</p>
		 *
		 * <p>In the following example, we check if the left drawer is open:</p>
		 *
		 * <listing version="3.0">
		 * if( drawers.isLeftDrawerOpen )
		 * {
		 *     // do something
		 * }</listing>
		 *
		 * @default false
		 *
		 * @see #leftDrawer
		 * @see #isLeftDrawerDocked
		 * @see #toggleLeftDrawer()
		 */
		public function get isLeftDrawerOpen():Boolean
		{
			return this._leftDrawer && this._isLeftDrawerOpen;
		}

		/**
		 * @private
		 */
		public function set isLeftDrawerOpen(value:Boolean):void
		{
			if(this.isLeftDrawerDocked || this._isLeftDrawerOpen == value)
			{
				return;
			}
			if(value)
			{
				this.isTopDrawerOpen = false;
				this.isRightDrawerOpen = false;
				this.isBottomDrawerOpen = false;
			}
			this._isLeftDrawerOpen = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * Indicates if the left drawer is currently docked. Docking behavior of
		 * the left drawer is controlled with the <code>leftDrawerDockMode</code>
		 * property. To check if the left drawer is open, but not docked, use
		 * the <code>isLeftDrawerOpen</code> property.
		 *
		 * @see #leftDrawer
		 * @see #leftDrawerDockMode
		 * @see #isLeftDrawerOpen
		 */
		public function get isLeftDrawerDocked():Boolean
		{
			if(!this._leftDrawer)
			{
				return false;
			}
			if(this._leftDrawerDockMode === Orientation.BOTH)
			{
				return true;
			}
			if(this._leftDrawerDockMode === Orientation.NONE)
			{
				return false;
			}
			var stage:Stage = this.stage;
			if(stage === null)
			{
				//fall back to the current stage, but it may be wrong...
				stage = Starling.current.stage;
			}
			if(stage.stageWidth > stage.stageHeight)
			{
				return this._leftDrawerDockMode === Orientation.LANDSCAPE;
			}
			return this._leftDrawerDockMode == Orientation.PORTRAIT;
		}

		/**
		 * @private
		 */
		protected var _autoSizeMode:String = AutoSizeMode.STAGE;

		[Inspectable(type="String",enumeration="stage,content")]
		/**
		 * Determines how the drawers container will set its own size when its
		 * dimensions (width and height) aren't set explicitly.
		 *
		 * <p>In the following example, the drawers container will be sized to
		 * match its content:</p>
		 *
		 * <listing version="3.0">
		 * drawers.autoSizeMode = AutoSizeMode.CONTENT;</listing>
		 *
		 * @default feathers.controls.AutoSizeMode.STAGE
		 *
		 * @see feathers.controls.AutoSizeMode#STAGE
		 * @see feathers.controls.AutoSizeMode#CONTENT
		 */
		public function get autoSizeMode():String
		{
			return this._autoSizeMode;
		}

		/**
		 * @private
		 */
		public function set autoSizeMode(value:String):void
		{
			if(this._autoSizeMode == value)
			{
				return;
			}
			this._autoSizeMode = value;
			if(this._content !== null)
			{
				if(this._autoSizeMode == AutoSizeMode.CONTENT)
				{
					this._content.addEventListener(FeathersEventType.RESIZE, content_resizeHandler);
				}
				else
				{
					this._content.removeEventListener(FeathersEventType.RESIZE, content_resizeHandler);
				}
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _clipDrawers:Boolean = true;

		/**
		 * Determines if the drawers are clipped while opening or closing. If
		 * the content does not have a background, the drawers should
		 * generally be clipped so that the drawer does not show under the
		 * content. If the content has a fully opaque background that will
		 * conceal the drawers, then clipping may be disabled to potentially
		 * improve performance.
		 *
		 * <p>In the following example, clipping will be disabled:</p>
		 *
		 * <listing version="3.0">
		 * navigator.clipDrawers = false;</listing>
		 *
		 * @default true
		 *
		 * @see #topDrawer
		 * @see #rightDrawer
		 * @see #bottomDrawer
		 * @see #leftDrawer
		 */
		public function get clipDrawers():Boolean
		{
			return this._clipDrawers;
		}

		/**
		 * @private
		 */
		public function set clipDrawers(value:Boolean):void
		{
			if(this._clipDrawers == value)
			{
				return;
			}
			this._clipDrawers = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _openMode:String = RelativeDepth.BELOW;

		[Inspectable(type="String",enumeration="below,above")]
		/**
		 * @private
		 */
		public function get openMode():String
		{
			return this._openMode;
		}

		/**
		 * @private
		 */
		public function set openMode(value:String):void
		{
			//for legacy reasons, OPEN_MODE_ABOVE had a different string value
			if(value === "overlay")
			{
				value = RelativeDepth.ABOVE;
			}
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._openMode == value)
			{
				return;
			}
			this._openMode = value;
			if(this._content !== null)
			{
				if(this._openMode === RelativeDepth.ABOVE)
				{
					this.setChildIndex(DisplayObject(this._content), 0);
				}
				else //below
				{
					if(this._overlaySkin)
					{
						//the content should below the overlay skin
						this.setChildIndex(DisplayObject(this._content), this.numChildren - 1);
						this.setChildIndex(this._overlaySkin, this.numChildren - 1);
					}
					else
					{
						this.setChildIndex(DisplayObject(this._content), this.numChildren - 1);
					}
				}
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _openGesture:String = DragGesture.EDGE;

		[Inspectable(type="String",enumeration="content,edge,none")]
		/**
		 * An optional touch gesture used to open a drawer.
		 *
		 * <p>In the following example, the drawers are opened by dragging
		 * anywhere inside the content:</p>
		 *
		 * <listing version="3.0">
		 * drawers.openGesture = DragGesture.CONTENT;</listing>
		 *
		 * @default feathers.controls.DragGesture.EDGE
		 *
		 * @see feathers.controls.DragGesture#NONE
		 * @see feathers.controls.DragGesture#CONTENT
		 * @see feathers.controls.DragGesture#EDGE
		 * @see #openGestureEdgeSize
		 */
		public function get openGesture():String
		{
			return this._openGesture;
		}

		/**
		 * @private
		 */
		public function set openGesture(value:String):void
		{
			if(value === "dragContent")
			{
				value = DragGesture.CONTENT;
			}
			else if(value === "dragContentEdge")
			{
				value = DragGesture.EDGE;
			}
			this._openGesture = value;
		}

		/**
		 * @private
		 */
		protected var _minimumDragDistance:Number = 0.04;

		/**
		 * The minimum physical distance (in inches) that a touch must move
		 * before a drag gesture begins.
		 *
		 * <p>In the following example, the minimum drag distance is customized:</p>
		 *
		 * <listing version="3.0">
		 * drawers.minimumDragDistance = 0.1;</listing>
		 *
		 * @default 0.04
		 */
		public function get minimumDragDistance():Number
		{
			return this._minimumDragDistance;
		}

		/**
		 * @private
		 */
		public function set minimumDragDistance(value:Number):void
		{
			this._minimumDragDistance = value;
		}

		/**
		 * @private
		 */
		protected var _minimumDrawerThrowVelocity:Number = 5;

		/**
		 * The minimum physical velocity (in inches per second) that a touch
		 * must move before the a drawern can be "thrown" to open or close it.
		 * Otherwise, it will settle open or closed based on which state is
		 * closer when the touch ends.
		 *
		 * <p>In the following example, the minimum drawer throw velocity is customized:</p>
		 *
		 * <listing version="3.0">
		 * drawers.minimumDrawerThrowVelocity = 2;</listing>
		 *
		 * @default 5
		 */
		public function get minimumDrawerThrowVelocity():Number
		{
			return this._minimumDrawerThrowVelocity;
		}

		/**
		 * @private
		 */
		public function set minimumDrawerThrowVelocity(value:Number):void
		{
			this._minimumDrawerThrowVelocity = value;
		}

		/**
		 * @private
		 */
		protected var _openGestureEdgeSize:Number = 0.1;

		/**
		 * The size (in inches) of the region near the edge of the content that
		 * can be dragged when the <code>openGesture</code> property is set to
		 * <code>DragGesture.EDGE</code>.
		 *
		 * <p>In the following example, the open gesture edge size is customized:</p>
		 *
		 * <listing version="3.0">
		 * drawers.openGestureEdgeSize = 0.25;</listing>
		 *
		 * @default 0.1
		 *
		 * @see #openGesture
		 * @see feathers.controls.DragGesture#EDGE
		 */
		public function get openGestureEdgeSize():Number
		{
			return this._openGestureEdgeSize;
		}

		/**
		 * @private
		 */
		public function set openGestureEdgeSize(value:Number):void
		{
			this._openGestureEdgeSize = value;
		}

		/**
		 * @private
		 */
		protected var _contentEventDispatcherChangeEventType:String;

		/**
		 * The event dispatched by the content to indicate that the content
		 * event dispatcher has changed. When this event is dispatched by the
		 * content, the drawers container will listen for the drawer toggle
		 * events from the new dispatcher that discovered using
		 * <code>contentEventDispatcherField</code> or
		 * <code>contentEventDispatcherFunction</code>.
		 *
		 * <p>For <code>StackScreenNavigator</code> and
		 * <code>ScreenNavigator</code> components, this value is automatically
		 * set to <code>Event.CHANGE</code>.</p>
		 *
		 * <p>In the following example, the drawers container will update its
		 * content event dispatcher when the content dispatches an event of type
		 * <code>Event.CHANGE</code>:</p>
		 *
		 * <listing version="3.0">
		 * drawers.contentEventDispatcherChangeEventType = Event.CHANGE;</listing>
		 *
		 * @default null
		 *
		 * @see #contentEventDispatcherField
		 * @see #contentEventDispatcherFunction
		 */
		public function get contentEventDispatcherChangeEventType():String
		{
			return this._contentEventDispatcherChangeEventType;
		}

		/**
		 * @private
		 */
		public function set contentEventDispatcherChangeEventType(value:String):void
		{
			if(this._contentEventDispatcherChangeEventType == value)
			{
				return;
			}
			if(this._content !== null && this._contentEventDispatcherChangeEventType)
			{
				this._content.removeEventListener(this._contentEventDispatcherChangeEventType, content_eventDispatcherChangeHandler);
			}
			this._contentEventDispatcherChangeEventType = value;
			if(this._content !== null && this._contentEventDispatcherChangeEventType)
			{
				this._content.addEventListener(this._contentEventDispatcherChangeEventType, content_eventDispatcherChangeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _contentEventDispatcherField:String;

		/**
		 * A property of the <code>content</code> that references an event
		 * dispatcher that dispatches events to toggle drawers open and closed.
		 *
		 * <p>For <code>StackScreenNavigator</code> and
		 * <code>ScreenNavigator</code> components, this value is automatically
		 * set to <code>"activeScreen"</code> to listen for events from the
		 * currently active/visible screen.</p>
		 *
		 * <p>In the following example, the content event dispatcher field is
		 * customized:</p>
		 *
		 * <listing version="3.0">
		 * drawers.contentEventDispatcherField = "selectedChild";</listing>
		 *
		 * @default null
		 *
		 * @see #contentEventDispatcherFunction
		 * @see #contentEventDispatcherChangeEventType
		 * @see #topDrawerToggleEventType
		 * @see #rightDrawerToggleEventType
		 * @see #bottomDrawerToggleEventType
		 * @see #leftDrawerToggleEventType
		 */
		public function get contentEventDispatcherField():String
		{
			return this._contentEventDispatcherField;
		}

		/**
		 * @private
		 */
		public function set contentEventDispatcherField(value:String):void
		{
			if(this._contentEventDispatcherField == value)
			{
				return;
			}
			this._contentEventDispatcherField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _contentEventDispatcherFunction:Function;

		/**
		 * A function that returns an event dispatcher that dispatches events to
		 * toggle drawers open and closed.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 *
		 * <pre>function( content:DisplayObject ):EventDispatcher</pre>
		 *
		 * <p>In the following example, the content event dispatcher function is
		 * customized:</p>
		 *
		 * <listing version="3.0">
		 * drawers.contentEventDispatcherField = function( content:CustomView ):void
		 * {
		 *     return content.selectedChild;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #contentEventDispatcherField
		 * @see #contentEventDispatcherChangeEventType
		 * @see #topDrawerToggleEventType
		 * @see #rightDrawerToggleEventType
		 * @see #bottomDrawerToggleEventType
		 * @see #leftDrawerToggleEventType
		 */
		public function get contentEventDispatcherFunction():Function
		{
			return this._contentEventDispatcherFunction;
		}

		/**
		 * @private
		 */
		public function set contentEventDispatcherFunction(value:Function):void
		{
			if(this._contentEventDispatcherFunction == value)
			{
				return;
			}
			this._contentEventDispatcherFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _openOrCloseTween:Tween;

		/**
		 * @private
		 */
		protected var _openOrCloseDuration:Number = 0.25;

		/**
		 * @private
		 */
		public function get openOrCloseDuration():Number
		{
			return this._openOrCloseDuration;
		}

		/**
		 * @private
		 */
		public function set openOrCloseDuration(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._openOrCloseDuration = value;
		}

		/**
		 * @private
		 */
		protected var _openOrCloseEase:Object = Transitions.EASE_OUT;

		/**
		 * @private
		 */
		public function get openOrCloseEase():Object
		{
			return this._openOrCloseEase;
		}

		/**
		 * @private
		 */
		public function set openOrCloseEase(value:Object):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._openOrCloseEase = value;
		}

		/**
		 * @private
		 */
		protected var isToggleTopDrawerPending:Boolean = false;

		/**
		 * @private
		 */
		protected var isToggleRightDrawerPending:Boolean = false;

		/**
		 * @private
		 */
		protected var isToggleBottomDrawerPending:Boolean = false;

		/**
		 * @private
		 */
		protected var isToggleLeftDrawerPending:Boolean = false;

		/**
		 * @private
		 */
		protected var pendingToggleDuration:Number;

		/**
		 * @private
		 */
		protected var touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _isDragging:Boolean = false;

		/**
		 * @private
		 */
		protected var _isDraggingTopDrawer:Boolean = false;

		/**
		 * @private
		 */
		protected var _isDraggingRightDrawer:Boolean = false;

		/**
		 * @private
		 */
		protected var _isDraggingBottomDrawer:Boolean = false;

		/**
		 * @private
		 */
		protected var _isDraggingLeftDrawer:Boolean = false;

		/**
		 * @private
		 */
		protected var _startTouchX:Number;

		/**
		 * @private
		 */
		protected var _startTouchY:Number;

		/**
		 * @private
		 */
		protected var _currentTouchX:Number;

		/**
		 * @private
		 */
		protected var _currentTouchY:Number;

		/**
		 * @private
		 */
		protected var _previousTouchTime:int;

		/**
		 * @private
		 */
		protected var _previousTouchX:Number;

		/**
		 * @private
		 */
		protected var _previousTouchY:Number;

		/**
		 * @private
		 */
		protected var _velocityX:Number = 0;

		/**
		 * @private
		 */
		protected var _velocityY:Number = 0;

		/**
		 * @private
		 */
		protected var _previousVelocityX:Vector.<Number> = new <Number>[];

		/**
		 * @private
		 */
		protected var _previousVelocityY:Vector.<Number> = new <Number>[];

		/**
		 * @private
		 */
		override public function hitTest(localPoint:Point):DisplayObject
		{
			var result:DisplayObject = super.hitTest(localPoint);
			if(result)
			{
				if(this._isDragging)
				{
					return this;
				}
				if(this.isTopDrawerOpen && result != this._topDrawer && !(this._topDrawer is DisplayObjectContainer && DisplayObjectContainer(this._topDrawer).contains(result)))
				{
					return this;
				}
				else if(this.isRightDrawerOpen && result != this._rightDrawer && !(this._rightDrawer is DisplayObjectContainer && DisplayObjectContainer(this._rightDrawer).contains(result)))
				{
					return this;
				}
				else if(this.isBottomDrawerOpen && result != this._bottomDrawer && !(this._bottomDrawer is DisplayObjectContainer && DisplayObjectContainer(this._bottomDrawer).contains(result)))
				{
					return this;
				}
				else if(this.isLeftDrawerOpen && result != this._leftDrawer && !(this._leftDrawer is DisplayObjectContainer && DisplayObjectContainer(this._leftDrawer).contains(result)))
				{
					return this;
				}
				return result;
			}
			//we want to register touches in our hitArea as a last resort
			if(!this.visible || !this.touchable)
			{
				return null;
			}
			return this._hitArea.contains(localPoint.x, localPoint.y) ? this : null;
		}

		/**
		 * Opens or closes the top drawer. If the <code>duration</code> argument
		 * is <code>NaN</code>, the default <code>openOrCloseDuration</code> is
		 * used. The default value of the <code>duration</code> argument is
		 * <code>NaN</code>. Otherwise, this value is the duration of the
		 * animation, in seconds.
		 *
		 * <p>To open or close the top drawer without animation, set the
		 * <code>isTopDrawerOpen</code> property.</p>
		 *
		 * @see #isTopDrawerOpen
		 * @see #openOrCloseDuration
		 * @see #openOrCloseEase
		 */
		public function toggleTopDrawer(duration:Number = NaN):void
		{
			if(!this._topDrawer || this.isTopDrawerDocked)
			{
				return;
			}
			this.pendingToggleDuration = duration;
			if(this.isToggleTopDrawerPending)
			{
				return;
			}
			if(!this.isTopDrawerOpen)
			{
				this.isRightDrawerOpen = false;
				this.isBottomDrawerOpen = false;
				this.isLeftDrawerOpen = false;
			}
			this.isToggleTopDrawerPending = true;
			this.isToggleRightDrawerPending = false;
			this.isToggleBottomDrawerPending = false;
			this.isToggleLeftDrawerPending = false;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * Opens or closes the right drawer. If the <code>duration</code> argument
		 * is <code>NaN</code>, the default <code>openOrCloseDuration</code> is
		 * used. The default value of the <code>duration</code> argument is
		 * <code>NaN</code>. Otherwise, this value is the duration of the
		 * animation, in seconds.
		 *
		 * <p>To open or close the right drawer without animation, set the
		 * <code>isRightDrawerOpen</code> property.</p>
		 *
		 * @see #isRightDrawerOpen
		 * @see #openOrCloseDuration
		 * @see #openOrCloseEase
		 */
		public function toggleRightDrawer(duration:Number = NaN):void
		{
			if(!this._rightDrawer || this.isRightDrawerDocked)
			{
				return;
			}
			this.pendingToggleDuration = duration;
			if(this.isToggleRightDrawerPending)
			{
				return;
			}
			if(!this.isRightDrawerOpen)
			{
				this.isTopDrawerOpen = false;
				this.isBottomDrawerOpen = false;
				this.isLeftDrawerOpen = false;
			}
			this.isToggleTopDrawerPending = false;
			this.isToggleRightDrawerPending = true;
			this.isToggleBottomDrawerPending = false;
			this.isToggleLeftDrawerPending = false;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * Opens or closes the bottom drawer. If the <code>duration</code> argument
		 * is <code>NaN</code>, the default <code>openOrCloseDuration</code> is
		 * used. The default value of the <code>duration</code> argument is
		 * <code>NaN</code>. Otherwise, this value is the duration of the
		 * animation, in seconds.
		 *
		 * <p>To open or close the bottom drawer without animation, set the
		 * <code>isBottomDrawerOpen</code> property.</p>
		 *
		 * @see #isBottomDrawerOpen
		 * @see #openOrCloseDuration
		 * @see #openOrCloseEase
		 */
		public function toggleBottomDrawer(duration:Number = NaN):void
		{
			if(!this._bottomDrawer || this.isBottomDrawerDocked)
			{
				return;
			}
			this.pendingToggleDuration = duration;
			if(this.isToggleBottomDrawerPending)
			{
				return;
			}
			if(!this.isBottomDrawerOpen)
			{
				this.isTopDrawerOpen = false;
				this.isRightDrawerOpen = false;
				this.isLeftDrawerOpen = false;
			}
			this.isToggleTopDrawerPending = false;
			this.isToggleRightDrawerPending = false;
			this.isToggleBottomDrawerPending = true;
			this.isToggleLeftDrawerPending = false;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * Opens or closes the left drawer. If the <code>duration</code> argument
		 * is <code>NaN</code>, the default <code>openOrCloseDuration</code> is
		 * used. The default value of the <code>duration</code> argument is
		 * <code>NaN</code>. Otherwise, this value is the duration of the
		 * animation, in seconds.
		 *
		 * <p>To open or close the left drawer without animation, set the
		 * <code>isLeftDrawerOpen</code> property.</p>
		 *
		 * @see #isLeftDrawerOpen
		 * @see #openOrCloseDuration
		 * @see #openOrCloseEase
		 */
		public function toggleLeftDrawer(duration:Number = NaN):void
		{
			if(!this._leftDrawer || this.isLeftDrawerDocked)
			{
				return;
			}
			this.pendingToggleDuration = duration;
			if(this.isToggleLeftDrawerPending)
			{
				return;
			}
			if(!this.isLeftDrawerOpen)
			{
				this.isTopDrawerOpen = false;
				this.isRightDrawerOpen = false;
				this.isBottomDrawerOpen = false;
			}
			this.isToggleTopDrawerPending = false;
			this.isToggleRightDrawerPending = false;
			this.isToggleBottomDrawerPending = false;
			this.isToggleLeftDrawerPending = true;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);
			var selectedInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SELECTED);

			if(dataInvalid)
			{
				this.refreshCurrentEventTarget();
			}

			if(sizeInvalid || layoutInvalid)
			{
				this.refreshDrawerStates();
			}
			if(sizeInvalid || layoutInvalid || selectedInvalid)
			{
				this.refreshOverlayState();
			}

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			this.layoutChildren();

			this.handlePendingActions();
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			var measureContent:Boolean = this._autoSizeMode === AutoSizeMode.CONTENT || !this.stage;
			var isTopDrawerDocked:Boolean = this.isTopDrawerDocked;
			var isRightDrawerDocked:Boolean = this.isRightDrawerDocked;
			var isBottomDrawerDocked:Boolean = this.isBottomDrawerDocked;
			var isLeftDrawerDocked:Boolean = this.isLeftDrawerDocked;
			if(measureContent)
			{
				if(this._content !== null)
				{
					this._content.validate();
					if(this._originalContentWidth !== this._originalContentWidth) //isNaN
					{
						this._originalContentWidth = this._content.width;
					}
					if(this._originalContentHeight !== this._originalContentHeight) //isNaN
					{
						this._originalContentHeight = this._content.height;
					}
				}
				if(isTopDrawerDocked)
				{
					this._topDrawer.validate();
					if(this._originalTopDrawerWidth !== this._originalTopDrawerWidth) //isNaN
					{
						this._originalTopDrawerWidth = this._topDrawer.width;
					}
					if(this._originalTopDrawerHeight !== this._originalTopDrawerHeight) //isNaN
					{
						this._originalTopDrawerHeight = this._topDrawer.height;
					}
				}
				if(isRightDrawerDocked)
				{
					this._rightDrawer.validate();
					if(this._originalRightDrawerWidth !== this._originalRightDrawerWidth) //isNaN
					{
						this._originalRightDrawerWidth = this._rightDrawer.width;
					}
					if(this._originalRightDrawerHeight !== this._originalRightDrawerHeight) //isNaN
					{
						this._originalRightDrawerHeight = this._rightDrawer.height;
					}
				}
				if(isBottomDrawerDocked)
				{
					this._bottomDrawer.validate();
					if(this._originalBottomDrawerWidth !== this._originalBottomDrawerWidth) //isNaN
					{
						this._originalBottomDrawerWidth = this._bottomDrawer.width;
					}
					if(this._originalBottomDrawerHeight !== this._originalBottomDrawerHeight) //isNaN
					{
						this._originalBottomDrawerHeight = this._bottomDrawer.height;
					}
				}
				if(isLeftDrawerDocked)
				{
					this._leftDrawer.validate();
					if(this._originalLeftDrawerWidth !== this._originalLeftDrawerWidth) //isNaN
					{
						this._originalLeftDrawerWidth = this._leftDrawer.width;
					}
					if(this._originalLeftDrawerHeight !== this._originalLeftDrawerHeight) //isNaN
					{
						this._originalLeftDrawerHeight = this._leftDrawer.height;
					}
				}
			}

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				if(measureContent)
				{
					if(this._content !== null)
					{
						newWidth = this._originalContentWidth;
					}
					else
					{
						newWidth = 0;
					}
					if(isLeftDrawerDocked)
					{
						newWidth += this._originalLeftDrawerWidth;
					}
					if(isRightDrawerDocked)
					{
						newWidth += this._originalRightDrawerWidth;
					}
					if(isTopDrawerDocked && this._originalTopDrawerWidth > newWidth)
					{
						newWidth = this._originalTopDrawerWidth;
					}
					if(isBottomDrawerDocked && this._originalBottomDrawerWidth > newWidth)
					{
						newWidth = this._originalBottomDrawerWidth;
					}
				}
				else
				{
					newWidth = this.stage.stageWidth;
				}
			}

			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				if(measureContent)
				{
					if(this._content !== null)
					{
						newHeight = this._originalContentHeight;
					}
					else
					{
						newHeight = 0;
					}
					if(isTopDrawerDocked)
					{
						newHeight += this._originalTopDrawerHeight;
					}
					if(isBottomDrawerDocked)
					{
						newHeight += this._originalBottomDrawerHeight;
					}
					if(isLeftDrawerDocked && this._originalLeftDrawerHeight > newHeight)
					{
						newHeight = this._originalLeftDrawerHeight;
					}
					if(isRightDrawerDocked && this._originalRightDrawerHeight > newHeight)
					{
						newHeight = this._originalRightDrawerHeight;
					}
				}
				else
				{
					newHeight = this.stage.stageHeight;
				}
			}

			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				if(measureContent)
				{
					if(this._content !== null)
					{
						newMinWidth = this._content.minWidth;
					}
					else
					{
						newMinWidth = 0;
					}
					if(isLeftDrawerDocked)
					{
						newMinWidth += this._leftDrawer.minWidth;
					}
					if(isRightDrawerDocked)
					{
						newMinWidth += this._rightDrawer.minWidth;
					}
					if(isTopDrawerDocked && this._topDrawer.minWidth > newMinWidth)
					{
						newMinWidth = this._topDrawer.minWidth;
					}
					if(isBottomDrawerDocked && this._bottomDrawer.minWidth > newMinWidth)
					{
						newMinWidth = this._bottomDrawer.minWidth;
					}
				}
				else
				{
					newMinWidth = this.stage.stageWidth;
				}
			}

			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				if(measureContent)
				{
					if(this._content !== null)
					{
						newMinHeight = this._content.minHeight;
					}
					else
					{
						newMinHeight = 0;
					}
					if(isTopDrawerDocked)
					{
						newMinHeight += this._topDrawer.minHeight;
					}
					if(isBottomDrawerDocked)
					{
						newMinHeight += this._bottomDrawer.minHeight;
					}
					if(isLeftDrawerDocked && this._leftDrawer.minHeight > newMinHeight)
					{
						newMinHeight = this._leftDrawer.minHeight;
					}
					if(isRightDrawerDocked && this._rightDrawer.minHeight > newMinHeight)
					{
						newMinHeight = this._rightDrawer.minHeight;
					}
				}
				else
				{
					newMinHeight = this.stage.stageHeight;
				}
			}

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * Positions and sizes the children.
		 */
		protected function layoutChildren():void
		{
			var isTopDrawerOpen:Boolean = this.isTopDrawerOpen;
			var isRightDrawerOpen:Boolean = this.isRightDrawerOpen;
			var isBottomDrawerOpen:Boolean = this.isBottomDrawerOpen;
			var isLeftDrawerOpen:Boolean = this.isLeftDrawerOpen;
			var isTopDrawerDocked:Boolean = this.isTopDrawerDocked;
			var isRightDrawerDocked:Boolean = this.isRightDrawerDocked;
			var isBottomDrawerDocked:Boolean = this.isBottomDrawerDocked;
			var isLeftDrawerDocked:Boolean = this.isLeftDrawerDocked;

			var topDrawerHeight:Number = 0;
			var bottomDrawerHeight:Number = 0;
			if(this._topDrawer !== null)
			{
				this._topDrawer.width = this.actualWidth;
				this._topDrawer.validate();
				topDrawerHeight = this._topDrawer.height;
				if(this._topDrawerDivider !== null)
				{
					this._topDrawerDivider.width = this._topDrawer.width;
					if(this._topDrawerDivider is IValidating)
					{
						IValidating(this._topDrawerDivider).validate();
					}
				}
			}
			if(this._bottomDrawer !== null)
			{
				this._bottomDrawer.width = this.actualWidth;
				this._bottomDrawer.validate();
				bottomDrawerHeight = this._bottomDrawer.height;
				if(this._bottomDrawerDivider !== null)
				{
					this._bottomDrawerDivider.width = this._bottomDrawer.width;
					if(this._bottomDrawerDivider is IValidating)
					{
						IValidating(this._bottomDrawerDivider).validate();
					}
				}
			}

			var contentHeight:Number = this.actualHeight;
			if(isTopDrawerDocked)
			{
				contentHeight -= topDrawerHeight;
				if(this._topDrawerDivider !== null)
				{
					contentHeight -= this._topDrawerDivider.height;
				}
			}
			if(isBottomDrawerDocked)
			{
				contentHeight -= bottomDrawerHeight;
				if(this._bottomDrawerDivider !== null)
				{
					contentHeight -= this._bottomDrawerDivider.height;
				}
			}
			if(contentHeight < 0)
			{
				contentHeight = 0;
			}

			var rightDrawerWidth:Number = 0;
			var leftDrawerWidth:Number = 0;
			if(this._rightDrawer !== null)
			{
				if(isRightDrawerDocked)
				{
					this._rightDrawer.height = contentHeight;
				}
				else
				{
					this._rightDrawer.height = this.actualHeight;
				}
				this._rightDrawer.validate();
				rightDrawerWidth = this._rightDrawer.width;
				if(this._rightDrawerDivider !== null)
				{
					this._rightDrawerDivider.height = this._rightDrawer.height;
					if(this._rightDrawerDivider is IValidating)
					{
						IValidating(this._rightDrawerDivider).validate();
					}
				}
			}
			if(this._leftDrawer !== null)
			{
				if(isLeftDrawerDocked)
				{
					this._leftDrawer.height = contentHeight;
				}
				else
				{
					this._leftDrawer.height = this.actualHeight;
				}
				this._leftDrawer.validate();
				leftDrawerWidth = this._leftDrawer.width;
				if(this._leftDrawerDivider !== null)
				{
					this._leftDrawerDivider.height = this._leftDrawer.height;
					if(this._leftDrawerDivider is IValidating)
					{
						IValidating(this._leftDrawerDivider).validate();
					}
				}
			}

			var contentWidth:Number = this.actualWidth;
			if(isLeftDrawerDocked)
			{
				contentWidth -= leftDrawerWidth;
				if(this._leftDrawerDivider !== null)
				{
					contentWidth -= this._leftDrawerDivider.width;
				}
			}
			if(isRightDrawerDocked)
			{
				contentWidth -= rightDrawerWidth;
				if(this._rightDrawerDivider !== null)
				{
					contentWidth -= this._rightDrawerDivider.width;
				}
			}
			if(contentWidth < 0)
			{
				contentWidth = 0;
			}

			var contentX:Number = 0;
			if(isRightDrawerOpen && this._openMode === RelativeDepth.BELOW)
			{
				contentX = -rightDrawerWidth;
				if(isLeftDrawerDocked)
				{
					contentX += leftDrawerWidth;
					if(this._leftDrawerDivider)
					{
						contentX += this._leftDrawerDivider.width;
					}
				}
			}
			else if((isLeftDrawerOpen && this._openMode === RelativeDepth.BELOW) || isLeftDrawerDocked)
			{
				contentX = leftDrawerWidth;
				if(this._leftDrawerDivider && isLeftDrawerDocked)
				{
					contentX += this._leftDrawerDivider.width;
				}
			}
			var contentY:Number = 0;
			if(isBottomDrawerOpen && this._openMode === RelativeDepth.BELOW)
			{
				contentY = -bottomDrawerHeight;
				if(isTopDrawerDocked)
				{
					contentY += topDrawerHeight;
					if(this._topDrawerDivider)
					{
						contentY += this._topDrawerDivider.height;
					}
				}
			}
			else if((isTopDrawerOpen && this._openMode === RelativeDepth.BELOW) || isTopDrawerDocked)
			{
				contentY = topDrawerHeight;
				if(this._topDrawerDivider && isTopDrawerDocked)
				{
					contentY += this._topDrawerDivider.height;
				}
			}
			if(this._content !== null)
			{
				this._content.x = contentX;
				this._content.y = contentY;
				if(this._autoSizeMode !== AutoSizeMode.CONTENT)
				{
					this._content.width = contentWidth;
					this._content.height = contentHeight;

					//final validation to avoid juggler next frame issues
					this._content.validate();
				}
			}

			if(this._topDrawer !== null)
			{
				var topDrawerX:Number = 0;
				var topDrawerY:Number = 0;
				if(isTopDrawerDocked)
				{
					if(isBottomDrawerOpen && this._openMode === RelativeDepth.BELOW)
					{
						topDrawerY -= bottomDrawerHeight;
					}
					if(!isLeftDrawerDocked)
					{
						topDrawerX = contentX;
					}
				}
				else if(this._openMode === RelativeDepth.ABOVE &&
					!this._isTopDrawerOpen)
				{
					topDrawerY -= topDrawerHeight;
				}
				this._topDrawer.x = topDrawerX;
				this._topDrawer.y = topDrawerY;
				this._topDrawer.visible = isTopDrawerOpen || isTopDrawerDocked || this._isDraggingTopDrawer;
				if(this._topDrawerDivider !== null)
				{
					this._topDrawerDivider.visible = isTopDrawerDocked;
					this._topDrawerDivider.x = topDrawerX;
					this._topDrawerDivider.y = topDrawerY + topDrawerHeight;
				}

				//final validation to avoid juggler next frame issues
				this._topDrawer.validate();
			}

			if(this._rightDrawer !== null)
			{
				var rightDrawerX:Number = this.actualWidth - rightDrawerWidth;
				var rightDrawerY:Number = 0;
				if(isRightDrawerDocked)
				{
					rightDrawerX = contentX + contentWidth;
					if(this._rightDrawerDivider)
					{
						rightDrawerX += this._rightDrawerDivider.width;
					}
					rightDrawerY = contentY;
				}
				else if(this._openMode === RelativeDepth.ABOVE &&
					!this._isRightDrawerOpen)
				{
					rightDrawerX += rightDrawerWidth;
				}
				this._rightDrawer.x = rightDrawerX;
				this._rightDrawer.y = rightDrawerY;
				this._rightDrawer.visible = isRightDrawerOpen || isRightDrawerDocked || this._isDraggingRightDrawer;
				if(this._rightDrawerDivider !== null)
				{
					this._rightDrawerDivider.visible = isRightDrawerDocked;
					this._rightDrawerDivider.x = rightDrawerX - this._rightDrawerDivider.width;
					this._rightDrawerDivider.y = rightDrawerY;
				}

				//final validation to avoid juggler next frame issues
				this._rightDrawer.validate();
			}

			if(this._bottomDrawer !== null)
			{
				var bottomDrawerX:Number = 0;
				var bottomDrawerY:Number = this.actualHeight - bottomDrawerHeight;
				if(isBottomDrawerDocked)
				{
					if(!isLeftDrawerDocked)
					{
						bottomDrawerX = contentX;
					}
					bottomDrawerY = contentY + contentHeight;
					if(this._bottomDrawerDivider)
					{
						bottomDrawerY += this._bottomDrawerDivider.height;
					}
				}
				else if(this._openMode === RelativeDepth.ABOVE &&
					!this._isBottomDrawerOpen)
				{
					bottomDrawerY += bottomDrawerHeight;
				}
				this._bottomDrawer.x = bottomDrawerX;
				this._bottomDrawer.y = bottomDrawerY;
				this._bottomDrawer.visible = isBottomDrawerOpen || isBottomDrawerDocked || this._isDraggingBottomDrawer;
				if(this._bottomDrawerDivider !== null)
				{
					this._bottomDrawerDivider.visible = isBottomDrawerDocked;
					this._bottomDrawerDivider.x = bottomDrawerX;
					this._bottomDrawerDivider.y = bottomDrawerY - this._bottomDrawerDivider.height;
				}

				//final validation to avoid juggler next frame issues
				this._bottomDrawer.validate();
			}

			if(this._leftDrawer !== null)
			{
				var leftDrawerX:Number = 0;
				var leftDrawerY:Number = 0;
				if(isLeftDrawerDocked)
				{
					if(isRightDrawerOpen && this._openMode === RelativeDepth.BELOW)
					{
						leftDrawerX -= rightDrawerWidth;
					}
					leftDrawerY = contentY;
				}
				else if(this._openMode === RelativeDepth.ABOVE &&
					!this._isLeftDrawerOpen)
				{
					leftDrawerX -= leftDrawerWidth;
				}
				this._leftDrawer.x = leftDrawerX;
				this._leftDrawer.y = leftDrawerY;
				this._leftDrawer.visible = isLeftDrawerOpen || isLeftDrawerDocked || this._isDraggingLeftDrawer;
				if(this._leftDrawerDivider !== null)
				{
					this._leftDrawerDivider.visible = isLeftDrawerDocked;
					this._leftDrawerDivider.x = leftDrawerX + leftDrawerWidth;
					this._leftDrawerDivider.y = leftDrawerY;
				}

				//final validation to avoid juggler next frame issues
				this._leftDrawer.validate();
			}

			if(this._overlaySkin !== null)
			{
				this.positionOverlaySkin();
				this._overlaySkin.width = this.actualWidth;
				this._overlaySkin.height = this.actualHeight;

				//final validation to avoid juggler next frame issues
				if(this._overlaySkin is IValidating)
				{
					IValidating(this._overlaySkin).validate();
				}
			}
		}

		/**
		 * @private
		 */
		protected function handlePendingActions():void
		{
			if(this.isToggleTopDrawerPending)
			{
				this._isTopDrawerOpen = !this._isTopDrawerOpen;
				this.isToggleTopDrawerPending = false;
				this.openOrCloseTopDrawer();
			}
			else if(this.isToggleRightDrawerPending)
			{
				this._isRightDrawerOpen = !this._isRightDrawerOpen;
				this.isToggleRightDrawerPending = false;
				this.openOrCloseRightDrawer();
			}
			else if(this.isToggleBottomDrawerPending)
			{
				this._isBottomDrawerOpen = !this._isBottomDrawerOpen;
				this.isToggleBottomDrawerPending = false;
				this.openOrCloseBottomDrawer();
			}
			else if(this.isToggleLeftDrawerPending)
			{
				this._isLeftDrawerOpen = !this._isLeftDrawerOpen;
				this.isToggleLeftDrawerPending = false;
				this.openOrCloseLeftDrawer();
			}
		}

		/**
		 * @private
		 */
		protected function openOrCloseTopDrawer():void
		{
			if(!this._topDrawer || this.isTopDrawerDocked)
			{
				return;
			}
			if(this._openOrCloseTween)
			{
				this._openOrCloseTween.advanceTime(this._openOrCloseTween.totalTime);
				Starling.juggler.remove(this._openOrCloseTween);
				this._openOrCloseTween = null;
			}
			this.prepareTopDrawer();
			if(this._overlaySkin)
			{
				this._overlaySkin.visible = true;
				if(this._isTopDrawerOpen)
				{
					this._overlaySkin.alpha = 0;
				}
				else
				{
					this._overlaySkin.alpha = this._overlaySkinOriginalAlpha;
				}
			}
			var targetPosition:Number = this._isTopDrawerOpen ? this._topDrawer.height : 0;
			var duration:Number = this.pendingToggleDuration;
			if(duration !== duration) //isNaN
			{
				duration = this._openOrCloseDuration;
			}
			this.pendingToggleDuration = NaN;
			if(this._openMode === RelativeDepth.ABOVE)
			{
				targetPosition = targetPosition == 0 ? -this._topDrawer.height : 0;
				this._openOrCloseTween = new Tween(this._topDrawer, duration, this._openOrCloseEase);
			}
			else //below
			{
				this._openOrCloseTween = new Tween(this._content, duration, this._openOrCloseEase);
			}
			this._openOrCloseTween.animate("y", targetPosition);
			this._openOrCloseTween.onUpdate = topDrawerOpenOrCloseTween_onUpdate;
			this._openOrCloseTween.onComplete = topDrawerOpenOrCloseTween_onComplete;
			Starling.juggler.add(this._openOrCloseTween);
		}

		/**
		 * @private
		 */
		protected function openOrCloseRightDrawer():void
		{
			if(!this._rightDrawer || this.isRightDrawerDocked)
			{
				return;
			}
			if(this._openOrCloseTween)
			{
				this._openOrCloseTween.advanceTime(this._openOrCloseTween.totalTime);
				Starling.juggler.remove(this._openOrCloseTween);
				this._openOrCloseTween = null;
			}
			this.prepareRightDrawer();
			if(this._overlaySkin)
			{
				this._overlaySkin.visible = true;
				if(this._isRightDrawerOpen)
				{
					this._overlaySkin.alpha = 0;
				}
				else
				{
					this._overlaySkin.alpha = this._overlaySkinOriginalAlpha;
				}
			}
			var targetPosition:Number = 0;
			if(this._isRightDrawerOpen)
			{
				targetPosition = -this._rightDrawer.width;
			}
			if(this.isLeftDrawerDocked && this._openMode === RelativeDepth.BELOW)
			{
				targetPosition += this._leftDrawer.width;
				if(this._leftDrawerDivider)
				{
					targetPosition += this._leftDrawerDivider.width;
				}
			}
			var duration:Number = this.pendingToggleDuration;
			if(duration !== duration) //isNaN
			{
				duration = this._openOrCloseDuration;
			}
			this.pendingToggleDuration = NaN;
			if(this._openMode === RelativeDepth.ABOVE)
			{
				this._openOrCloseTween = new Tween(this._rightDrawer, duration, this._openOrCloseEase);
				targetPosition += this.actualWidth;
			}
			else //below
			{
				this._openOrCloseTween = new Tween(this._content, duration, this._openOrCloseEase);
			}
			this._openOrCloseTween.animate("x", targetPosition);
			this._openOrCloseTween.onUpdate = rightDrawerOpenOrCloseTween_onUpdate;
			this._openOrCloseTween.onComplete = rightDrawerOpenOrCloseTween_onComplete;
			Starling.juggler.add(this._openOrCloseTween);
		}

		/**
		 * @private
		 */
		protected function openOrCloseBottomDrawer():void
		{
			if(!this._bottomDrawer || this.isBottomDrawerDocked)
			{
				return;
			}
			if(this._openOrCloseTween)
			{
				this._openOrCloseTween.advanceTime(this._openOrCloseTween.totalTime);
				Starling.juggler.remove(this._openOrCloseTween);
				this._openOrCloseTween = null;
			}
			this.prepareBottomDrawer();
			if(this._overlaySkin)
			{
				this._overlaySkin.visible = true;
				if(this._isBottomDrawerOpen)
				{
					this._overlaySkin.alpha = 0;
				}
				else
				{
					this._overlaySkin.alpha = this._overlaySkinOriginalAlpha;
				}
			}
			var targetPosition:Number = 0;
			if(this._isBottomDrawerOpen)
			{
				targetPosition = -this._bottomDrawer.height;
			}
			if(this.isTopDrawerDocked && this._openMode === RelativeDepth.BELOW)
			{
				targetPosition += this._topDrawer.height;
				if(this._topDrawerDivider)
				{
					targetPosition += this._topDrawerDivider.height;
				}
			}
			var duration:Number = this.pendingToggleDuration;
			if(duration !== duration) //isNaN
			{
				duration = this._openOrCloseDuration;
			}
			this.pendingToggleDuration = NaN;
			if(this._openMode === RelativeDepth.ABOVE)
			{
				targetPosition += this.actualHeight;
				this._openOrCloseTween = new Tween(this._bottomDrawer, duration, this._openOrCloseEase);
			}
			else //below
			{
				this._openOrCloseTween = new Tween(this._content, duration, this._openOrCloseEase);
			}
			this._openOrCloseTween.animate("y", targetPosition);
			this._openOrCloseTween.onUpdate = bottomDrawerOpenOrCloseTween_onUpdate;
			this._openOrCloseTween.onComplete = bottomDrawerOpenOrCloseTween_onComplete;
			Starling.juggler.add(this._openOrCloseTween);
		}

		/**
		 * @private
		 */
		protected function openOrCloseLeftDrawer():void
		{
			if(!this._leftDrawer || this.isLeftDrawerDocked)
			{
				return;
			}
			if(this._openOrCloseTween)
			{
				this._openOrCloseTween.advanceTime(this._openOrCloseTween.totalTime);
				Starling.juggler.remove(this._openOrCloseTween);
				this._openOrCloseTween = null;
			}
			this.prepareLeftDrawer();
			if(this._overlaySkin)
			{
				this._overlaySkin.visible = true;
				if(this._isLeftDrawerOpen)
				{
					this._overlaySkin.alpha = 0;
				}
				else
				{
					this._overlaySkin.alpha = this._overlaySkinOriginalAlpha;
				}
			}
			var targetPosition:Number = this._isLeftDrawerOpen ? this._leftDrawer.width : 0;
			var duration:Number = this.pendingToggleDuration;
			if(duration !== duration) //isNaN
			{
				duration = this._openOrCloseDuration;
			}
			this.pendingToggleDuration = NaN;
			if(this._openMode === RelativeDepth.ABOVE)
			{
				targetPosition = targetPosition == 0 ? -this._leftDrawer.width : 0;
				this._openOrCloseTween = new Tween(this._leftDrawer, duration, this._openOrCloseEase);
			}
			else //below
			{
				this._openOrCloseTween = new Tween(this._content, duration, this._openOrCloseEase);
			}
			this._openOrCloseTween.animate("x", targetPosition);
			this._openOrCloseTween.onUpdate = leftDrawerOpenOrCloseTween_onUpdate;
			this._openOrCloseTween.onComplete = leftDrawerOpenOrCloseTween_onComplete;
			Starling.juggler.add(this._openOrCloseTween);
		}

		/**
		 * @private
		 */
		protected function prepareTopDrawer():void
		{
			this._topDrawer.visible = true;
			if(this._openMode === RelativeDepth.ABOVE)
			{
				if(this._overlaySkin)
				{
					this.setChildIndex(this._overlaySkin, this.numChildren - 1);
				}
				this.setChildIndex(DisplayObject(this._topDrawer), this.numChildren - 1);
			}
			if(!this._clipDrawers || this._openMode !== RelativeDepth.BELOW)
			{
				return;
			}
			if(this._topDrawer.mask === null)
			{
				var mask:Quad = new Quad(1, 1, 0xff00ff);
				//the initial dimensions cannot be 0 or there's a runtime error,
				//and these values might be 0
				mask.width = this.actualWidth;
				mask.height = this._content.y;
				this._topDrawer.mask = mask;
			}
		}

		/**
		 * @private
		 */
		protected function prepareRightDrawer():void
		{
			this._rightDrawer.visible = true;
			if(this._openMode === RelativeDepth.ABOVE)
			{
				if(this._overlaySkin)
				{
					this.setChildIndex(this._overlaySkin, this.numChildren - 1);
				}
				this.setChildIndex(DisplayObject(this._rightDrawer), this.numChildren - 1);
			}
			if(!this._clipDrawers || this._openMode !== RelativeDepth.BELOW)
			{
				return;
			}
			if(this._rightDrawer.mask === null)
			{
				var mask:Quad = new Quad(1, 1, 0xff00ff);
				//the initial dimensions cannot be 0 or there's a runtime error,
				//and these values might be 0
				if(this.isLeftDrawerDocked)
				{
					mask.width = -this._leftDrawer.x;
				}
				else
				{
					mask.width = -this._content.x;
				}
				mask.height = this.actualHeight;
				this._rightDrawer.mask = mask;
			}
		}

		/**
		 * @private
		 */
		protected function prepareBottomDrawer():void
		{
			this._bottomDrawer.visible = true;
			if(this._openMode === RelativeDepth.ABOVE)
			{
				if(this._overlaySkin)
				{
					this.setChildIndex(this._overlaySkin, this.numChildren - 1);
				}
				this.setChildIndex(DisplayObject(this._bottomDrawer), this.numChildren - 1);
			}
			if(!this._clipDrawers || this._openMode !== RelativeDepth.BELOW)
			{
				return;
			}
			if(this._bottomDrawer.mask === null)
			{
				var mask:Quad = new Quad(1, 1, 0xff00ff);
				//the initial dimensions cannot be 0 or there's a runtime error,
				//and these values might be 0
				mask.width = this.actualWidth;
				if(this.isTopDrawerDocked)
				{
					mask.height = -this._topDrawer.y;
				}
				else
				{
					mask.height = -this._content.y;
				}
				this._bottomDrawer.mask = mask;
			}
		}

		/**
		 * @private
		 */
		protected function prepareLeftDrawer():void
		{
			this._leftDrawer.visible = true;
			if(this._openMode === RelativeDepth.ABOVE)
			{
				if(this._overlaySkin)
				{
					this.setChildIndex(this._overlaySkin, this.numChildren - 1);
				}
				this.setChildIndex(DisplayObject(this._leftDrawer), this.numChildren - 1);
			}
			if(!this._clipDrawers || this._openMode !== RelativeDepth.BELOW)
			{
				return;
			}
			if(this._leftDrawer.mask === null)
			{
				var mask:Quad = new Quad(1, 1, 0xff00ff);
				//the initial dimensions cannot be 0 or there's a runtime error,
				//and these values might be 0
				mask.width = this._content.x;
				mask.height = this.actualHeight;
				this._leftDrawer.mask = mask;
			}
		}

		/**
		 * Uses the content event dispatcher fields and functions to generate a
		 * content event dispatcher icon for the content.
		 *
		 * <p>All of the content event dispatcher fields and functions, ordered
		 * by priority:</p>
		 * <ol>
		 *     <li><code>contentEventDispatcherFunction</code></li>
		 *     <li><code>contentEventDispatcherField</code></li>
		 * </ol>
		 *
		 * @see #content
		 * @see #contentEventDispatcherField
		 * @see #contentEventDispatcherFunction
		 * @see #contentEventDispatcherChangeEventType
		 */
		protected function contentToContentEventDispatcher():EventDispatcher
		{
			if(this._contentEventDispatcherFunction !== null)
			{
				return this._contentEventDispatcherFunction(this._content) as EventDispatcher;
			}
			else if(this._contentEventDispatcherField !== null && this._content && (this._contentEventDispatcherField in this._content))
			{
				return this._content[this._contentEventDispatcherField] as EventDispatcher;
			}
			return this._content as EventDispatcher;
		}

		/**
		 * @private
		 */
		protected function refreshCurrentEventTarget():void
		{
			if(this.contentEventDispatcher)
			{
				if(this._topDrawerToggleEventType)
				{
					this.contentEventDispatcher.removeEventListener(this._topDrawerToggleEventType, content_topDrawerToggleEventTypeHandler);
				}
				if(this._rightDrawerToggleEventType)
				{
					this.contentEventDispatcher.removeEventListener(this._rightDrawerToggleEventType, content_rightDrawerToggleEventTypeHandler);
				}
				if(this._bottomDrawerToggleEventType)
				{
					this.contentEventDispatcher.removeEventListener(this._bottomDrawerToggleEventType, content_bottomDrawerToggleEventTypeHandler);
				}
				if(this._leftDrawerToggleEventType)
				{
					this.contentEventDispatcher.removeEventListener(this._leftDrawerToggleEventType, content_leftDrawerToggleEventTypeHandler);
				}
			}
			this.contentEventDispatcher = this.contentToContentEventDispatcher();
			if(this.contentEventDispatcher)
			{
				if(this._topDrawerToggleEventType)
				{
					this.contentEventDispatcher.addEventListener(this._topDrawerToggleEventType, content_topDrawerToggleEventTypeHandler);
				}
				if(this._rightDrawerToggleEventType)
				{
					this.contentEventDispatcher.addEventListener(this._rightDrawerToggleEventType, content_rightDrawerToggleEventTypeHandler);
				}
				if(this._bottomDrawerToggleEventType)
				{
					this.contentEventDispatcher.addEventListener(this._bottomDrawerToggleEventType, content_bottomDrawerToggleEventTypeHandler);
				}
				if(this._leftDrawerToggleEventType)
				{
					this.contentEventDispatcher.addEventListener(this._leftDrawerToggleEventType, content_leftDrawerToggleEventTypeHandler);
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshDrawerStates():void
		{
			if(this.isTopDrawerDocked && this._isTopDrawerOpen)
			{
				this._isTopDrawerOpen = false;
			}
			if(this.isRightDrawerDocked && this._isRightDrawerOpen)
			{
				this._isRightDrawerOpen = false;
			}
			if(this.isBottomDrawerDocked && this._isBottomDrawerOpen)
			{
				this._isBottomDrawerOpen = false;
			}
			if(this.isLeftDrawerDocked && this._isLeftDrawerOpen)
			{
				this._isLeftDrawerOpen = false;
			}
		}

		/**
		 * @private
		 */
		protected function refreshOverlayState():void
		{
			if(!this._overlaySkin || this._isDragging)
			{
				return;
			}
			var showOverlay:Boolean = (this._isTopDrawerOpen && !this.isTopDrawerDocked) ||
				(this._isRightDrawerOpen && !this.isRightDrawerDocked) ||
				(this._isBottomDrawerOpen && !this.isBottomDrawerDocked) ||
				(this._isLeftDrawerOpen && !this.isLeftDrawerDocked);
			if(showOverlay !== this._overlaySkin.visible)
			{
				this._overlaySkin.visible = showOverlay;
				this._overlaySkin.alpha = showOverlay ? this._overlaySkinOriginalAlpha : 0;
			}
		}

		/**
		 * @private
		 */
		protected function handleTapToClose(touch:Touch):void
		{
			touch.getLocation(this.stage, HELPER_POINT);
			if(this !== this.stage.hitTest(HELPER_POINT))
			{
				return;
			}

			if(this.isTopDrawerOpen)
			{
				this._isTopDrawerOpen = false;
				this.openOrCloseTopDrawer();
			}
			else if(this.isRightDrawerOpen)
			{
				this._isRightDrawerOpen = false;
				this.openOrCloseRightDrawer();
			}
			else if(this.isBottomDrawerOpen)
			{
				this._isBottomDrawerOpen = false;
				this.openOrCloseBottomDrawer();
			}
			else if(this.isLeftDrawerOpen)
			{
				this._isLeftDrawerOpen = false;
				this.openOrCloseLeftDrawer();
			}
		}

		/**
		 * @private
		 */
		protected function handleTouchBegan(touch:Touch):void
		{
			var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
			if(exclusiveTouch.getClaim(touch.id))
			{
				//already claimed
				return;
			}

			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			touch.getLocation(this, HELPER_POINT);
			var localX:Number = HELPER_POINT.x;
			var localY:Number = HELPER_POINT.y;
			if(!this.isTopDrawerOpen && !this.isRightDrawerOpen && !this.isBottomDrawerOpen && !this.isLeftDrawerOpen)
			{
				if(this._openGesture === DragGesture.NONE)
				{
					return;
				}
				if(this._openGesture === DragGesture.EDGE)
				{
					var isNearAnyEdge:Boolean = false;
					if(this._topDrawer && !this.isTopDrawerDocked)
					{
						var topInches:Number = localY / (DeviceCapabilities.dpi / starling.contentScaleFactor);
						if(topInches >= 0 && topInches <= this._openGestureEdgeSize)
						{
							isNearAnyEdge = true;
						}
					}
					if(!isNearAnyEdge)
					{
						if(this._rightDrawer && !this.isRightDrawerDocked)
						{
							var rightInches:Number = (this.actualWidth - localX) / (DeviceCapabilities.dpi / starling.contentScaleFactor);
							if(rightInches >= 0 && rightInches <= this._openGestureEdgeSize)
							{
								isNearAnyEdge = true;
							}
						}
						if(!isNearAnyEdge)
						{
							if(this._bottomDrawer && !this.isBottomDrawerDocked)
							{
								var bottomInches:Number = (this.actualHeight - localY) / (DeviceCapabilities.dpi / starling.contentScaleFactor);
								if(bottomInches >= 0 && bottomInches <= this._openGestureEdgeSize)
								{
									isNearAnyEdge = true;
								}
							}
							if(!isNearAnyEdge)
							{
								if(this._leftDrawer && !this.isLeftDrawerDocked)
								{
									var leftInches:Number = localX / (DeviceCapabilities.dpi / starling.contentScaleFactor);
									if(leftInches >= 0 && leftInches <= this._openGestureEdgeSize)
									{
										isNearAnyEdge = true;
									}
								}
							}
						}
					}
					if(!isNearAnyEdge)
					{
						return;
					}
				}
			}
			else if(this._openMode === RelativeDepth.BELOW && touch.target !== this)
			{
				//when the drawer is opened below, it will only close when
				//something outside of the drawer is touched
				return;
			}
			//when the drawer is opened above, anything may be touched

			this.touchPointID = touch.id;
			this._velocityX = 0;
			this._velocityY = 0;
			this._previousVelocityX.length = 0;
			this._previousVelocityY.length = 0;
			this._previousTouchTime = getTimer();
			this._previousTouchX = this._startTouchX = this._currentTouchX = localX;
			this._previousTouchY = this._startTouchY = this._currentTouchY = localY;
			this._isDragging = false;
			this._isDraggingTopDrawer = false;
			this._isDraggingRightDrawer = false;
			this._isDraggingBottomDrawer = false;
			this._isDraggingLeftDrawer = false;

			exclusiveTouch.addEventListener(Event.CHANGE, exclusiveTouch_changeHandler);
		}

		/**
		 * @private
		 */
		protected function handleTouchMoved(touch:Touch):void
		{
			touch.getLocation(this, HELPER_POINT);
			this._currentTouchX = HELPER_POINT.x;
			this._currentTouchY = HELPER_POINT.y;
			var now:int = getTimer();
			var timeOffset:int = now - this._previousTouchTime;
			if(timeOffset > 0)
			{
				//we're keeping previous velocity updates to improve accuracy
				this._previousVelocityX[this._previousVelocityX.length] = this._velocityX;
				if(this._previousVelocityX.length > MAXIMUM_SAVED_VELOCITY_COUNT)
				{
					this._previousVelocityX.shift();
				}
				this._previousVelocityY[this._previousVelocityY.length] = this._velocityY;
				if(this._previousVelocityY.length > MAXIMUM_SAVED_VELOCITY_COUNT)
				{
					this._previousVelocityY.shift();
				}
				this._velocityX = (this._currentTouchX - this._previousTouchX) / timeOffset;
				this._velocityY = (this._currentTouchY - this._previousTouchY) / timeOffset;
				this._previousTouchTime = now;
				this._previousTouchX = this._currentTouchX;
				this._previousTouchY = this._currentTouchY;
			}
		}

		/**
		 * @private
		 */
		protected function handleDragEnd():void
		{
			//take the average for more accuracy
			var sum:Number = this._velocityX * CURRENT_VELOCITY_WEIGHT;
			var velocityCount:int = this._previousVelocityX.length;
			var totalWeight:Number = CURRENT_VELOCITY_WEIGHT;
			for(var i:int = 0; i < velocityCount; i++)
			{
				var weight:Number = VELOCITY_WEIGHTS[i];
				sum += this._previousVelocityX.shift() * weight;
				totalWeight += weight;
			}

			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var inchesPerSecondX:Number = 1000 * (sum / totalWeight) / (DeviceCapabilities.dpi / starling.contentScaleFactor);

			sum = this._velocityY * CURRENT_VELOCITY_WEIGHT;
			velocityCount = this._previousVelocityY.length;
			totalWeight = CURRENT_VELOCITY_WEIGHT;
			for(i = 0; i < velocityCount; i++)
			{
				weight = VELOCITY_WEIGHTS[i];
				sum += this._previousVelocityY.shift() * weight;
				totalWeight += weight;
			}
			var inchesPerSecondY:Number = 1000 * (sum / totalWeight) / (DeviceCapabilities.dpi / starling.contentScaleFactor);

			this._isDragging = false;
			if(this._isDraggingTopDrawer)
			{
				this._isDraggingTopDrawer = false;
				if(!this._isTopDrawerOpen && inchesPerSecondY > this._minimumDrawerThrowVelocity)
				{
					this._isTopDrawerOpen = true;
				}
				else if(this._isTopDrawerOpen && inchesPerSecondY < -this._minimumDrawerThrowVelocity)
				{
					this._isTopDrawerOpen = false;
				}
				else if(this._openMode === RelativeDepth.ABOVE)
				{
					this._isTopDrawerOpen = roundToNearest(this._topDrawer.y, this._topDrawer.height) == 0;
				}
				else //below
				{
					this._isTopDrawerOpen = roundToNearest(this._content.y, this._topDrawer.height) != 0;
				}
				this.openOrCloseTopDrawer();
			}
			else if(this._isDraggingRightDrawer)
			{
				this._isDraggingRightDrawer = false;
				if(!this._isRightDrawerOpen && inchesPerSecondX < -this._minimumDrawerThrowVelocity)
				{
					this._isRightDrawerOpen = true;
				}
				else if(this._isRightDrawerOpen && inchesPerSecondX > this._minimumDrawerThrowVelocity)
				{
					this._isRightDrawerOpen = false;
				}
				else if(this._openMode === RelativeDepth.ABOVE)
				{
					this._isRightDrawerOpen = roundToNearest(this.actualWidth - this._rightDrawer.x, this._rightDrawer.width) != 0;
				}
				else //bottom
				{
					var positionToCheck:Number = this._content.x;
					if(this.isLeftDrawerDocked)
					{
						positionToCheck -= this._leftDrawer.width;
					}
					this._isRightDrawerOpen = roundToNearest(positionToCheck, this._rightDrawer.width) != 0;
				}
				this.openOrCloseRightDrawer();
			}
			else if(this._isDraggingBottomDrawer)
			{
				this._isDraggingBottomDrawer = false;
				if(!this._isBottomDrawerOpen && inchesPerSecondY < -this._minimumDrawerThrowVelocity)
				{
					this._isBottomDrawerOpen = true;
				}
				else if(this._isBottomDrawerOpen && inchesPerSecondY > this._minimumDrawerThrowVelocity)
				{
					this._isBottomDrawerOpen = false;
				}
				else if(this._openMode === RelativeDepth.ABOVE)
				{
					this._isBottomDrawerOpen = roundToNearest(this.actualHeight - this._bottomDrawer.y, this._bottomDrawer.height) != 0;
				}
				else //below
				{
					positionToCheck = this._content.y;
					if(this.isTopDrawerDocked)
					{
						positionToCheck -= this._topDrawer.height;
					}
					this._isBottomDrawerOpen = roundToNearest(positionToCheck, this._bottomDrawer.height) != 0;
				}
				this.openOrCloseBottomDrawer();
			}
			else if(this._isDraggingLeftDrawer)
			{
				this._isDraggingLeftDrawer = false;
				if(!this._isLeftDrawerOpen && inchesPerSecondX > this._minimumDrawerThrowVelocity)
				{
					this._isLeftDrawerOpen = true;
				}
				else if(this._isLeftDrawerOpen && inchesPerSecondX < -this._minimumDrawerThrowVelocity)
				{
					this._isLeftDrawerOpen = false;
				}
				else if(this._openMode === RelativeDepth.ABOVE)
				{
					this._isLeftDrawerOpen = roundToNearest(this._leftDrawer.x, this._leftDrawer.width) == 0;
				}
				else //below
				{
					this._isLeftDrawerOpen = roundToNearest(this._content.x, this._leftDrawer.width) != 0;
				}
				this.openOrCloseLeftDrawer();
			}
		}

		/**
		 * @private
		 */
		protected function handleDragMove():void
		{
			var contentX:Number = 0;
			var contentY:Number = 0;
			if(this.isLeftDrawerDocked)
			{
				contentX = this._leftDrawer.width;
				if(this._leftDrawerDivider !== null)
				{
					contentX += this._leftDrawerDivider.width;
				}
			}
			if(this.isTopDrawerDocked)
			{
				contentY = this._topDrawer.height;
				if(this._topDrawerDivider !== null)
				{
					contentY += this._topDrawerDivider.height;
				}
			}
			if(this._isDraggingLeftDrawer)
			{
				var leftDrawerWidth:Number = this._leftDrawer.width;
				if(this.isLeftDrawerOpen)
				{
					contentX = leftDrawerWidth + this._currentTouchX - this._startTouchX;
				}
				else
				{
					contentX = this._currentTouchX - this._startTouchX;
				}
				if(contentX < 0)
				{
					contentX = 0;
				}
				if(contentX > leftDrawerWidth)
				{
					contentX = leftDrawerWidth;
				}
			}
			else if(this._isDraggingRightDrawer)
			{
				var rightDrawerWidth:Number = this._rightDrawer.width;
				if(this.isRightDrawerOpen)
				{
					contentX = -rightDrawerWidth + this._currentTouchX - this._startTouchX;
				}
				else
				{
					contentX = this._currentTouchX - this._startTouchX;
				}
				if(contentX < -rightDrawerWidth)
				{
					contentX = -rightDrawerWidth;
				}
				if(contentX > 0)
				{
					contentX = 0;
				}
				if(this.isLeftDrawerDocked && this._openMode === RelativeDepth.BELOW)
				{
					contentX += this._leftDrawer.width;
					if(this._leftDrawerDivider !== null)
					{
						contentX += this._leftDrawerDivider.width;
					}
				}
			}
			else if(this._isDraggingTopDrawer)
			{
				var topDrawerHeight:Number = this._topDrawer.height;
				if(this.isTopDrawerOpen)
				{
					contentY = topDrawerHeight + this._currentTouchY - this._startTouchY;
				}
				else
				{
					contentY = this._currentTouchY - this._startTouchY;
				}
				if(contentY < 0)
				{
					contentY = 0;
				}
				if(contentY > topDrawerHeight)
				{
					contentY = topDrawerHeight;
				}
			}
			else if(this._isDraggingBottomDrawer)
			{
				var bottomDrawerHeight:Number = this._bottomDrawer.height;
				if(this.isBottomDrawerOpen)
				{
					contentY = -bottomDrawerHeight + this._currentTouchY - this._startTouchY;
				}
				else
				{
					contentY = this._currentTouchY - this._startTouchY;
				}
				if(contentY < -bottomDrawerHeight)
				{
					contentY = -bottomDrawerHeight;
				}
				if(contentY > 0)
				{
					contentY = 0;
				}
				if(this.isTopDrawerDocked && this._openMode === RelativeDepth.BELOW)
				{
					contentY += this._topDrawer.height;
					if(this._topDrawerDivider !== null)
					{
						contentY += this._topDrawerDivider.height;
					}
				}
			}
			if(this._openMode === RelativeDepth.ABOVE)
			{
				if(this._isDraggingTopDrawer)
				{
					this._topDrawer.y = contentY - this._topDrawer.height;
				}
				else if(this._isDraggingRightDrawer)
				{
					this._rightDrawer.x = this.actualWidth + contentX;
				}
				else if(this._isDraggingBottomDrawer)
				{
					this._bottomDrawer.y = this.actualHeight + contentY;
				}
				else if(this._isDraggingLeftDrawer)
				{
					this._leftDrawer.x = contentX - this._leftDrawer.width;
				}
			}
			else //below
			{
				this._content.x = contentX;
				this._content.y = contentY;
			}
			if(this._isDraggingTopDrawer)
			{
				this.topDrawerOpenOrCloseTween_onUpdate();
			}
			else if(this._isDraggingRightDrawer)
			{
				this.rightDrawerOpenOrCloseTween_onUpdate();
			}
			else if(this._isDraggingBottomDrawer)
			{
				this.bottomDrawerOpenOrCloseTween_onUpdate();
			}
			else if(this._isDraggingLeftDrawer)
			{
				this.leftDrawerOpenOrCloseTween_onUpdate();
			}
		}

		/**
		 * @private
		 */
		protected function checkForDragToClose():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var horizontalInchesMoved:Number = (this._currentTouchX - this._startTouchX) / (DeviceCapabilities.dpi / starling.contentScaleFactor);
			var verticalInchesMoved:Number = (this._currentTouchY - this._startTouchY) / (DeviceCapabilities.dpi / starling.contentScaleFactor);
			if(this.isLeftDrawerOpen && horizontalInchesMoved <= -this._minimumDragDistance)
			{
				this._isDragging = true;
				this._isDraggingLeftDrawer = true;
				this.prepareLeftDrawer();
			}
			else if(this.isRightDrawerOpen && horizontalInchesMoved >= this._minimumDragDistance)
			{
				this._isDragging = true;
				this._isDraggingRightDrawer = true;
				this.prepareRightDrawer();
			}
			else if(this.isTopDrawerOpen && verticalInchesMoved <= -this._minimumDragDistance)
			{
				this._isDragging = true;
				this._isDraggingTopDrawer = true;
				this.prepareTopDrawer();
			}
			else if(this.isBottomDrawerOpen && verticalInchesMoved >= this._minimumDragDistance)
			{
				this._isDragging = true;
				this._isDraggingBottomDrawer = true;
				this.prepareBottomDrawer();
			}

			if(this._isDragging)
			{
				if(this._overlaySkin)
				{
					this._overlaySkin.visible = true;
					this._overlaySkin.alpha = this._overlaySkinOriginalAlpha;
				}
				this._startTouchX = this._currentTouchX;
				this._startTouchY = this._currentTouchY;
				var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
				exclusiveTouch.removeEventListener(Event.CHANGE, exclusiveTouch_changeHandler);
				exclusiveTouch.claimTouch(this.touchPointID, this);
				this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
			}
		}

		/**
		 * @private
		 */
		protected function checkForDragToOpen():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var horizontalInchesMoved:Number = (this._currentTouchX - this._startTouchX) / (DeviceCapabilities.dpi / starling.contentScaleFactor);
			var verticalInchesMoved:Number = (this._currentTouchY - this._startTouchY) / (DeviceCapabilities.dpi / starling.contentScaleFactor);
			if(this._leftDrawer && !this.isLeftDrawerDocked && horizontalInchesMoved >= this._minimumDragDistance)
			{
				this._isDragging = true;
				this._isDraggingLeftDrawer = true;
				this.prepareLeftDrawer();
			}
			else if(this._rightDrawer && !this.isRightDrawerDocked && horizontalInchesMoved <= -this._minimumDragDistance)
			{
				this._isDragging = true;
				this._isDraggingRightDrawer = true;
				this.prepareRightDrawer();
			}
			else if(this._topDrawer && !this.isTopDrawerDocked && verticalInchesMoved >= this._minimumDragDistance)
			{
				this._isDragging = true;
				this._isDraggingTopDrawer = true;
				this.prepareTopDrawer();
			}
			else if(this._bottomDrawer && !this.isBottomDrawerDocked && verticalInchesMoved <= -this._minimumDragDistance)
			{
				this._isDragging = true;
				this._isDraggingBottomDrawer = true;
				this.prepareBottomDrawer();
			}

			if(this._isDragging)
			{
				if(this._overlaySkin)
				{
					this._overlaySkin.visible = true;
					this._overlaySkin.alpha = 0;
				}
				this._startTouchX = this._currentTouchX;
				this._startTouchY = this._currentTouchY;
				var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
				exclusiveTouch.claimTouch(this.touchPointID, this);
				exclusiveTouch.removeEventListener(Event.CHANGE, exclusiveTouch_changeHandler);
				this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
			}
		}

		/**
		 * @private
		 */
		protected function positionOverlaySkin():void
		{
			if(this._overlaySkin === null)
			{
				return;
			}

			if(this.isLeftDrawerDocked)
			{
				this._overlaySkin.x = this._leftDrawer.x;
			}
			else if(this._openMode === RelativeDepth.ABOVE && this._leftDrawer)
			{
				this._overlaySkin.x = this._leftDrawer.x + this._leftDrawer.width;
			}
			else //below or no left drawer
			{
				if(this._content !== null)
				{
					this._overlaySkin.x = this._content.x;
				}
				else
				{
					this._overlaySkin.x = 0;
				}
			}

			if(this.isTopDrawerDocked)
			{
				this._overlaySkin.y = this._topDrawer.y;
			}
			else if(this._openMode === RelativeDepth.ABOVE && this._topDrawer)
			{
				this._overlaySkin.y = this._topDrawer.y + this._topDrawer.height;
			}
			else //below or now top drawer
			{
				if(this._content !== null)
				{
					this._overlaySkin.y = this._content.y;
				}
				else
				{
					this._overlaySkin.y = 0;
				}
			}
		}

		/**
		 * @private
		 */
		protected function topDrawerOpenOrCloseTween_onUpdate():void
		{
			if(this._overlaySkin)
			{
				if(this._openMode === RelativeDepth.ABOVE)
				{
					var ratio:Number = 1 + this._topDrawer.y / this._topDrawer.height;
				}
				else //below
				{
					ratio = this._content.y / this._topDrawer.height;
				}
				this._overlaySkin.alpha = this._overlaySkinOriginalAlpha * ratio;
			}
			this.openOrCloseTween_onUpdate();
		}

		/**
		 * @private
		 */
		protected function rightDrawerOpenOrCloseTween_onUpdate():void
		{
			if(this._overlaySkin)
			{
				if(this._openMode === RelativeDepth.ABOVE)
				{
					var ratio:Number = -(this._rightDrawer.x - this.actualWidth) / this._rightDrawer.width;
				}
				else //below
				{
					ratio = (this.actualWidth - this._content.x - this._content.width) / this._rightDrawer.width;
				}
				this._overlaySkin.alpha = this._overlaySkinOriginalAlpha * ratio;
			}
			this.openOrCloseTween_onUpdate();
		}

		/**
		 * @private
		 */
		protected function bottomDrawerOpenOrCloseTween_onUpdate():void
		{
			if(this._overlaySkin)
			{
				if(this._openMode === RelativeDepth.ABOVE)
				{
					var ratio:Number = -(this._bottomDrawer.y - this.actualHeight) / this._bottomDrawer.height;
				}
				else //below
				{
					ratio = (this.actualHeight - this._content.y - this._content.height) / this._bottomDrawer.height;
				}
				this._overlaySkin.alpha = this._overlaySkinOriginalAlpha * ratio;
			}
			this.openOrCloseTween_onUpdate();
		}

		/**
		 * @private
		 */
		protected function leftDrawerOpenOrCloseTween_onUpdate():void
		{
			if(this._overlaySkin)
			{
				if(this._openMode === RelativeDepth.ABOVE)
				{
					var ratio:Number = 1 + this._leftDrawer.x / this._leftDrawer.width;
				}
				else //below
				{
					ratio = this._content.x / this._leftDrawer.width;
				}
				this._overlaySkin.alpha = this._overlaySkinOriginalAlpha * ratio;
			}
			this.openOrCloseTween_onUpdate();
		}

		/**
		 * @private
		 */
		protected function openOrCloseTween_onUpdate():void
		{
			if(this._clipDrawers && this._openMode === RelativeDepth.BELOW)
			{
				var isTopDrawerDocked:Boolean = this.isTopDrawerDocked;
				var isRightDrawerDocked:Boolean = this.isRightDrawerDocked;
				var isBottomDrawerDocked:Boolean = this.isBottomDrawerDocked;
				var isLeftDrawerDocked:Boolean = this.isLeftDrawerDocked;
				var contentX:Number = this._content.x;
				var contentY:Number = this._content.y;
				if(isTopDrawerDocked)
				{
					if(isLeftDrawerDocked)
					{
						var leftDrawerDockedWidth:Number = this._leftDrawer.width;
						if(this._leftDrawerDivider !== null)
						{
							leftDrawerDockedWidth += this._leftDrawerDivider.width;
						}
						this._topDrawer.x = contentX - leftDrawerDockedWidth;
					}
					else
					{
						this._topDrawer.x = contentX;
					}
					if(this._topDrawerDivider !== null)
					{
						this._topDrawerDivider.x = this._topDrawer.x;
						this._topDrawerDivider.y = contentY - this._topDrawerDivider.height;
						this._topDrawer.y = this._topDrawerDivider.y - this._topDrawer.height;
					}
					else
					{
						this._topDrawer.y = contentY - this._topDrawer.height;
					}
				}
				if(isRightDrawerDocked)
				{
					if(this._rightDrawerDivider !== null)
					{
						this._rightDrawerDivider.x = contentX + this._content.width;
						this._rightDrawer.x = this._rightDrawerDivider.x + this._rightDrawerDivider.width;
						this._rightDrawerDivider.y = contentY;
					}
					else
					{
						this._rightDrawer.x = contentX + this._content.width;
					}
					this._rightDrawer.y = contentY;
				}
				if(isBottomDrawerDocked)
				{
					if(isLeftDrawerDocked)
					{
						leftDrawerDockedWidth = this._leftDrawer.width;
						if(this._leftDrawerDivider !== null)
						{
							leftDrawerDockedWidth += this._leftDrawerDivider.width;
						}
						this._bottomDrawer.x = contentX - leftDrawerDockedWidth;
					}
					else
					{
						this._bottomDrawer.x = contentX;
					}
					if(this._bottomDrawerDivider !== null)
					{
						this._bottomDrawerDivider.x = this._bottomDrawer.x;
						this._bottomDrawerDivider.y = contentY + this._content.height;
						this._bottomDrawer.y = this._bottomDrawerDivider.y + this._bottomDrawerDivider.height;
					}
					else
					{
						this._bottomDrawer.y = contentY + this._content.height;
					}
				}
				if(isLeftDrawerDocked)
				{
					if(this._leftDrawerDivider !== null)
					{
						this._leftDrawerDivider.x = contentX - this._leftDrawerDivider.width;
						this._leftDrawer.x = this._leftDrawerDivider.x - this._leftDrawer.width;
						this._leftDrawerDivider.y = contentY;
					}
					else
					{
						this._leftDrawer.x = contentX - this._leftDrawer.width;
					}
					this._leftDrawer.y = contentY;
				}
				if(this._topDrawer !== null)
				{
					var mask:Quad = this._topDrawer.mask as Quad;
					if(mask !== null)
					{
						mask.height = contentY;
					}
				}
				if(this._rightDrawer !== null)
				{
					mask = this._rightDrawer.mask as Quad;
					if(mask !== null)
					{
						var rightClipWidth:Number = -contentX;
						if(isLeftDrawerDocked)
						{
							rightClipWidth = -this._leftDrawer.x;
						}
						mask.x = this._rightDrawer.width - rightClipWidth;
						mask.width = rightClipWidth;
					}
				}
				if(this._bottomDrawer !== null)
				{
					mask = this._bottomDrawer.mask as Quad;
					if(mask !== null)
					{
						var bottomClipHeight:Number = -contentY;
						if(isTopDrawerDocked)
						{
							bottomClipHeight = -this._topDrawer.y;
						}
						mask.y = this._bottomDrawer.height - bottomClipHeight;
						mask.height = bottomClipHeight;
					}
				}
				if(this._leftDrawer !== null)
				{
					mask = this._leftDrawer.mask as Quad;
					if(mask !== null)
					{
						mask.width = contentX;
					}
				}
			}

			if(this._overlaySkin !== null)
			{
				this.positionOverlaySkin();
			}
		}

		/**
		 * @private
		 */
		protected function topDrawerOpenOrCloseTween_onComplete():void
		{
			if(this._overlaySkin)
			{
				this._overlaySkin.alpha = this._overlaySkinOriginalAlpha;
			}
			this._openOrCloseTween = null;
			this._topDrawer.mask = null;
			var isTopDrawerOpen:Boolean = this.isTopDrawerOpen;
			var isTopDrawerDocked:Boolean = this.isTopDrawerDocked;
			this._topDrawer.visible = isTopDrawerOpen || isTopDrawerDocked;
			if(this._overlaySkin)
			{
				this._overlaySkin.visible = isTopDrawerOpen;
			}
			if(isTopDrawerOpen)
			{
				this.dispatchEventWith(Event.OPEN, false, this._topDrawer);
			}
			else
			{
				this.dispatchEventWith(Event.CLOSE, false, this._topDrawer);
			}
		}

		/**
		 * @private
		 */
		protected function rightDrawerOpenOrCloseTween_onComplete():void
		{
			this._openOrCloseTween = null;
			this._rightDrawer.mask = null;
			var isRightDrawerOpen:Boolean = this.isRightDrawerOpen;
			var isRightDrawerDocked:Boolean = this.isRightDrawerDocked;
			this._rightDrawer.visible = isRightDrawerOpen || isRightDrawerDocked;
			if(this._overlaySkin)
			{
				this._overlaySkin.visible = isRightDrawerOpen;
			}
			if(isRightDrawerOpen)
			{
				this.dispatchEventWith(Event.OPEN, false, this._rightDrawer);
			}
			else
			{
				this.dispatchEventWith(Event.CLOSE, false, this._rightDrawer);
			}
		}

		/**
		 * @private
		 */
		protected function bottomDrawerOpenOrCloseTween_onComplete():void
		{
			this._openOrCloseTween = null;
			this._bottomDrawer.mask = null;
			var isBottomDrawerOpen:Boolean = this.isBottomDrawerOpen;
			var isBottomDrawerDocked:Boolean = this.isBottomDrawerDocked;
			this._bottomDrawer.visible = isBottomDrawerOpen || isBottomDrawerDocked;
			if(this._overlaySkin)
			{
				this._overlaySkin.visible = isBottomDrawerOpen;
			}
			if(isBottomDrawerOpen)
			{
				this.dispatchEventWith(Event.OPEN, false, this._bottomDrawer);
			}
			else
			{
				this.dispatchEventWith(Event.CLOSE, false, this._bottomDrawer);
			}
		}

		/**
		 * @private
		 */
		protected function leftDrawerOpenOrCloseTween_onComplete():void
		{
			this._openOrCloseTween = null;
			this._leftDrawer.mask = null;
			var isLeftDrawerOpen:Boolean = this.isLeftDrawerOpen;
			var isLeftDrawerDocked:Boolean = this.isLeftDrawerDocked;
			this._leftDrawer.visible = isLeftDrawerOpen || isLeftDrawerDocked;
			if(this._overlaySkin)
			{
				this._overlaySkin.visible = isLeftDrawerOpen;
			}
			if(isLeftDrawerOpen)
			{
				this.dispatchEventWith(Event.OPEN, false, this._leftDrawer);
			}
			else
			{
				this.dispatchEventWith(Event.CLOSE, false, this._leftDrawer);
			}
		}

		/**
		 * @private
		 */
		protected function content_eventDispatcherChangeHandler(event:Event):void
		{
			this.refreshCurrentEventTarget();
		}

		/**
		 * @private
		 */
		protected function drawers_addedToStageHandler(event:Event):void
		{
			this.stage.addEventListener(ResizeEvent.RESIZE, stage_resizeHandler);
			//using priority here is a hack so that objects higher up in the
			//display list have a chance to cancel the event first.
			var priority:int = -getDisplayObjectDepthFromStage(this);
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			starling.nativeStage.addEventListener(KeyboardEvent.KEY_DOWN, drawers_nativeStage_keyDownHandler, false, priority, true);
		}

		/**
		 * @private
		 */
		protected function drawers_removedFromStageHandler(event:Event):void
		{
			if(this.touchPointID >= 0)
			{
				var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
				exclusiveTouch.removeEventListener(Event.CHANGE, exclusiveTouch_changeHandler);
			}
			this.touchPointID = -1;
			this._isDragging = false;
			this._isDraggingTopDrawer = false;
			this._isDraggingRightDrawer = false;
			this._isDraggingBottomDrawer = false;
			this._isDraggingLeftDrawer = false;
			this.stage.removeEventListener(ResizeEvent.RESIZE, stage_resizeHandler);
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			starling.nativeStage.removeEventListener(KeyboardEvent.KEY_DOWN, drawers_nativeStage_keyDownHandler);
		}

		/**
		 * @private
		 */
		protected function drawers_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled || this._openOrCloseTween)
			{
				this.touchPointID = -1;
				return;
			}
			if(this.touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this, null, this.touchPointID);
				if(!touch)
				{
					return;
				}
				if(touch.phase == TouchPhase.MOVED)
				{
					this.handleTouchMoved(touch);

					if(!this._isDragging)
					{
						if(this.isTopDrawerOpen || this.isRightDrawerOpen || this.isBottomDrawerOpen || this.isLeftDrawerOpen)
						{
							this.checkForDragToClose();
						}
						else
						{
							this.checkForDragToOpen();
						}
					}
					if(this._isDragging)
					{
						this.handleDragMove();
					}
				}
				else if(touch.phase == TouchPhase.ENDED)
				{
					this.touchPointID = -1;
					if(this._isDragging)
					{
						this.handleDragEnd();
						this.dispatchEventWith(FeathersEventType.END_INTERACTION);
					}
					else
					{
						ExclusiveTouch.forStage(this.stage).removeEventListener(Event.CHANGE, exclusiveTouch_changeHandler);
						if(this.isTopDrawerOpen || this.isRightDrawerOpen || this.isBottomDrawerOpen || this.isLeftDrawerOpen)
						{
							//there is no drag, so we may have a tap
							this.handleTapToClose(touch);
						}
					}

				}
			}
			else
			{
				touch = event.getTouch(this, TouchPhase.BEGAN);
				if(!touch)
				{
					return;
				}

				this.handleTouchBegan(touch);
			}
		}

		/**
		 * @private
		 */
		protected function exclusiveTouch_changeHandler(event:Event, touchID:int):void
		{
			if(this.touchPointID < 0 || this.touchPointID != touchID || this._isDragging)
			{
				return;
			}

			var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
			if(exclusiveTouch.getClaim(touchID) == this)
			{
				return;
			}

			this.touchPointID = -1;

		}

		/**
		 * @private
		 */
		protected function stage_resizeHandler(event:ResizeEvent):void
		{
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected function drawers_nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.isDefaultPrevented())
			{
				//someone else already handled this one
				return;
			}
			if(event.keyCode == Keyboard.BACK)
			{
				var isAnyDrawerOpen:Boolean = false;
				if(this.isTopDrawerOpen)
				{
					this.toggleTopDrawer();
					isAnyDrawerOpen = true;
				}
				else if(this.isRightDrawerOpen)
				{
					this.toggleRightDrawer();
					isAnyDrawerOpen = true;
				}
				else if(this.isBottomDrawerOpen)
				{
					this.toggleBottomDrawer();
					isAnyDrawerOpen = true;
				}
				else if(this.isLeftDrawerOpen)
				{
					this.toggleLeftDrawer();
					isAnyDrawerOpen = true;
				}
				if(isAnyDrawerOpen)
				{
					event.preventDefault();
				}
			}
		}

		/**
		 * @private
		 */
		protected function content_topDrawerToggleEventTypeHandler(event:Event):void
		{
			if(!this._topDrawer || this.isTopDrawerDocked)
			{
				return;
			}
			this._isTopDrawerOpen = !this._isTopDrawerOpen;
			this.openOrCloseTopDrawer();
		}

		/**
		 * @private
		 */
		protected function content_rightDrawerToggleEventTypeHandler(event:Event):void
		{
			if(!this._rightDrawer || this.isRightDrawerDocked)
			{
				return;
			}
			this._isRightDrawerOpen = !this._isRightDrawerOpen;
			this.openOrCloseRightDrawer();
		}

		/**
		 * @private
		 */
		protected function content_bottomDrawerToggleEventTypeHandler(event:Event):void
		{
			if(!this._bottomDrawer || this.isBottomDrawerDocked)
			{
				return;
			}
			this._isBottomDrawerOpen = !this._isBottomDrawerOpen;
			this.openOrCloseBottomDrawer();
		}

		/**
		 * @private
		 */
		protected function content_leftDrawerToggleEventTypeHandler(event:Event):void
		{
			if(!this._leftDrawer || this.isLeftDrawerDocked)
			{
				return;
			}
			this._isLeftDrawerOpen = !this._isLeftDrawerOpen;
			this.openOrCloseLeftDrawer();
		}

		/**
		 * @private
		 */
		protected function content_resizeHandler(event:Event):void
		{
			if(this._isValidating || this._autoSizeMode != AutoSizeMode.CONTENT)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected function drawer_resizeHandler(event:Event):void
		{
			if(this._isValidating)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}
	}
}


================================================
FILE: source/feathers/controls/GroupedList.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer;
	import feathers.controls.renderers.DefaultGroupedListItemRenderer;
	import feathers.controls.renderers.IGroupedListFooterRenderer;
	import feathers.controls.renderers.IGroupedListHeaderRenderer;
	import feathers.controls.renderers.IGroupedListItemRenderer;
	import feathers.controls.supportClasses.GroupedListDataViewPort;
	import feathers.core.IFocusContainer;
	import feathers.core.PropertyProxy;
	import feathers.data.IHierarchicalCollection;
	import feathers.events.CollectionEventType;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.ILayout;
	import feathers.layout.IVariableVirtualLayout;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.skins.IStyleProvider;
	import feathers.system.DeviceCapabilities;

	import flash.events.KeyboardEvent;
	import flash.geom.Point;
	import flash.ui.Keyboard;

	import starling.events.Event;
	import starling.utils.Pool;

	/**
	 * A style name to add to all item renderers in this list. Typically
	 * used by a theme to provide different styles to different grouped
	 * lists.
	 *
	 * <p>The following example sets the item renderer style name:</p>
	 *
	 * <listing version="3.0">
	 * list.customItemRendererStyleName = "my-custom-item-renderer";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different skins than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( DefaultGroupedListItemRenderer ).setFunctionForStyleName( "my-custom-item-renderer", setCustomItemRendererStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #style:customFirstItemRendererStyleName
	 * @see #style:customLastItemRendererStyleName
	 * @see #style:customSingleItemRendererStyleName
	 */
	[Style(name="customItemRendererStyleName",type="String")]

	/**
	 * A style name to add to all item renderers in this grouped list that
	 * are the first item in a group. Typically used by a theme to provide
	 * different styles to different grouped lists, and to differentiate
	 * first items from regular items if they are created with the same
	 * class. If this value is <code>null</code>, the regular
	 * <code>customItemRendererStyleName</code> will be used instead.
	 *
	 * <p>The following example provides a style name for the first item
	 * renderer in each group:</p>
	 *
	 * <listing version="3.0">
	 * list.customFirstItemRendererStyleName = "my-custom-first-item-renderer";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( DefaultGroupedListItemRenderer ).setFunctionForStyleName( "my-custom-first-item-renderer", setCustomFirstItemRendererStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #style:customItemRendererStyleName
	 * @see #style:customLastItemRendererStyleName
	 * @see #style:customSingleItemRendererStyleName
	 */
	[Style(name="customFirstItemRendererStyleName",type="String")]

	/**
	 * A style name to add to all item renderers in this grouped list that
	 * are the last item in a group. Typically used by a theme to provide
	 * different styles to different grouped lists, and to differentiate
	 * last items from regular items if they are created with the same
	 * class. If this value is <code>null</code> the regular
	 * <code>customItemRendererStyleName</code> will be used instead.
	 *
	 * <p>The following example provides a style name for the last item
	 * renderer in each group:</p>
	 *
	 * <listing version="3.0">
	 * list.customLastItemRendererStyleName = "my-custom-last-item-renderer";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( DefaultGroupedListItemRenderer ).setFunctionForStyleName( "my-custom-last-item-renderer", setCustomLastItemRendererStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #style:customItemRendererStyleName
	 * @see #style:customFirstItemRendererStyleName
	 * @see #style:customSingleItemRendererStyleName
	 */
	[Style(name="customLastItemRendererStyleName",type="String")]

	/**
	 * A style name to add to all item renderers in this grouped list that
	 * are a single item in a group with no other items. Typically used by a
	 * theme to provide different styles to different grouped lists, and to
	 * differentiate single items from regular items if they are created
	 * with the same class. If this value is <code>null</code> the regular
	 * <code>customItemRendererStyleName</code> will be used instead.
	 *
	 * <p>The following example provides a style name for a single item
	 * renderer in each group:</p>
	 *
	 * <listing version="3.0">
	 * list.customSingleItemRendererStyleName = "my-custom-single-item-renderer";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different skins than the default style:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( DefaultGroupedListItemRenderer ).setFunctionForStyleName( "my-custom-single-item-renderer", setCustomSingleItemRendererStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #style:customItemRendererStyleName
	 * @see #style:customFirstItemRendererStyleName
	 * @see #style:customLastItemRendererStyleName
	 */
	[Style(name="customSingleItemRendererStyleName",type="String")]

	/**
	 * A style name to add to all header renderers in this grouped list.
	 * Typically used by a theme to provide different styles to different
	 * grouped lists.
	 *
	 * <p>The following example sets the header renderer style name:</p>
	 *
	 * <listing version="3.0">
	 * list.customHeaderRendererStyleName = "my-custom-header-renderer";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different skins than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( DefaultGroupedListHeaderOrFooterRenderer ).setFunctionForStyleName( "my-custom-header-renderer", setCustomHeaderRendererStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 */
	[Style(name="customHeaderRendererStyleName",type="String")]

	/**
	 * A style name to add to all footer renderers in this grouped list.
	 * Typically used by a theme to provide different styles to different
	 * grouped lists.
	 *
	 * <p>The following example sets the footer renderer style name:</p>
	 *
	 * <listing version="3.0">
	 * list.customFooterRendererStyleName = "my-custom-footer-renderer";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( DefaultGroupedListHeaderOrFooterRenderer ).setFunctionForStyleName( "my-custom-footer-renderer", setCustomFooterRendererStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 */
	[Style(name="customFooterRendererStyleName",type="String")]

	/**
	 * The duration, in seconds, of the animation when the selected item is
	 * changed by keyboard navigation and the item scrolls into view.
	 *
	 * <p>In the following example, the duration of the animation that
	 * scrolls the list to a new selected item is set to 500 milliseconds:</p>
	 *
	 * <listing version="3.0">
	 * list.keyScrollDuration = 0.5;</listing>
	 *
	 * @default 0.25
	 */
	[Style(name="keyScrollDuration",type="Number")]

	/**
	 * The layout algorithm used to position and, optionally, size the
	 * list's items.
	 *
	 * <p>By default, if no layout is provided by the time that the list
	 * initializes, a vertical layout with options targeted at touch screens
	 * is created.</p>
	 *
	 * <p>The following example tells the list to use a horizontal layout:</p>
	 *
	 * <listing version="3.0">
	 * var layout:HorizontalLayout = new HorizontalLayout();
	 * layout.gap = 20;
	 * layout.padding = 20;
	 * list.layout = layout;</listing>
	 */
	[Style(name="layout",type="feathers.layout.ILayout")]

	/**
	 * Dispatched when the selected item changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #selectedItem
	 * @see #selectedGroupIndex
	 * @see #selectedItemIndex
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the the user taps or clicks an item renderer in the list.
	 * The touch must remain within the bounds of the item renderer on release,
	 * and the list must not have scrolled, to register as a tap or a click.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The item associated with the item
	 *   renderer that was triggered.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.TRIGGERED
	 */
	[Event(name="triggered",type="starling.events.Event")]

	/**
	 * Dispatched when an item renderer is added to the list. When the layout is
	 * virtualized, item renderers may not exist for every item in the data
	 * provider. This event can be used to track which items currently have
	 * renderers.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The item renderer that was added</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.RENDERER_ADD
	 */
	[Event(name="rendererAdd",type="starling.events.Event")]

	/**
	 * Dispatched when an item renderer is removed from the list. When the layout is
	 * virtualized, item renderers may not exist for every item in the data
	 * provider. This event can be used to track which items currently have
	 * renderers.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The item renderer that was removed</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.RENDERER_REMOVE
	 */
	[Event(name="rendererRemove",type="starling.events.Event")]

	/**
	 * Displays a list of items divided into groups or sections. Takes a
	 * hierarchical provider limited to two levels of hierarchy. This component
	 * supports scrolling, custom item (and header and footer) renderers, and
	 * custom layouts.
	 *
	 * <p>Layouts may be, and are highly encouraged to be, <em>virtual</em>,
	 * meaning that the List is capable of creating a limited number of item
	 * renderers to display a subset of the data provider instead of creating a
	 * renderer for every single item. This allows for optimal performance with
	 * very large data providers.</p>
	 *
	 * <p>The following example creates a grouped list, gives it a data
	 * provider, tells the item renderer how to interpret the data, and listens
	 * for when the selection changes:</p>
	 *
	 * <listing version="3.0">
	 * var list:GroupedList = new GroupedList();
	 * 
	 * list.dataProvider = new ArrayHierarchicalCollection(
	 * [
	 *     {
	 *         header: "Dairy",
	 *         children:
	 *         [
	 *             { text: "Milk", thumbnail: textureAtlas.getTexture( "milk" ) },
	 *             { text: "Cheese", thumbnail: textureAtlas.getTexture( "cheese" ) },
	 *         ]
	 *     },
	 *     {
	 *         header: "Bakery",
	 *         children:
	 *         [
	 *             { text: "Bread", thumbnail: textureAtlas.getTexture( "bread" ) },
	 *         ]
	 *     },
	 *     {
	 *         header: "Produce",
	 *         children:
	 *         [
	 *             { text: "Bananas", thumbnail: textureAtlas.getTexture( "bananas" ) },
	 *             { text: "Lettuce", thumbnail: textureAtlas.getTexture( "lettuce" ) },
	 *             { text: "Onion", thumbnail: textureAtlas.getTexture( "onion" ) },
	 *         ]
	 *     },
	 * ]);
	 * 
	 * list.itemRendererFactory = function():IGroupedListItemRenderer
	 * {
	 *     var renderer:DefaultGroupedListItemRenderer = new DefaultGroupedListItemRenderer();
	 *     renderer.labelField = "text";
	 *     renderer.iconSourceField = "thumbnail";
	 *     return renderer;
	 * };
	 * 
	 * list.addEventListener( Event.CHANGE, list_changeHandler );
	 * 
	 * this.addChild( list );</listing>
	 *
	 * @see ../../../help/grouped-list.html How to use the Feathers GroupedList component
	 * @see ../../../help/default-item-renderers.html How to use the Feathers default item renderer
	 * @see ../../../help/item-renderers.html Creating custom item renderers for the Feathers List and GroupedList components
	 * @see feathers.controls.List
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class GroupedList extends Scroller implements IFocusContainer
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>GroupedList</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * An alternate style name to use with <code>GroupedList</code> to allow
		 * a theme to give it an inset style. If a theme does not provide a
		 * style for an inset grouped list, the theme will automatically fall
		 * back to using the default grouped list style.
		 *
		 * <p>An alternate style name should always be added to a component's
		 * <code>styleNameList</code> before the component is initialized. If
		 * the style name is added later, it will be ignored.</p>
		 *
		 * <p>In the following example, the inset style is applied to a grouped
		 * list:</p>
		 *
		 * <listing version="3.0">
		 * var list:GroupedList = new GroupedList();
		 * list.styleNameList.add( GroupedList.ALTERNATE_STYLE_NAME_INSET_GROUPED_LIST );
		 * this.addChild( list );</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_INSET_GROUPED_LIST:String = "feathers-inset-grouped-list";

		/**
		 * The default name to use with header renderers.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_HEADER_RENDERER:String = "feathers-grouped-list-header-renderer";

		/**
		 * An alternate name to use with header renderers to give them an inset
		 * style. This name is usually only referenced inside themes.
		 *
		 * <p>In the following example, the inset style is applied to a grouped
		 * list's header:</p>
		 *
		 * <listing version="3.0">
		 * list.customHeaderRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_HEADER_RENDERER;</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_CHILD_STYLE_NAME_INSET_HEADER_RENDERER:String = "feathers-grouped-list-inset-header-renderer";

		/**
		 * The default name to use with footer renderers.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_FOOTER_RENDERER:String = "feathers-grouped-list-footer-renderer";

		/**
		 * An alternate name to use with footer renderers to give them an inset
		 * style. This name is usually only referenced inside themes.
		 *
		 * <p>In the following example, the inset style is applied to a grouped
		 * list's footer:</p>
		 *
		 * <listing version="3.0">
		 * list.customFooterRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_FOOTER_RENDERER;</listing>
		 */
		public static const ALTERNATE_CHILD_STYLE_NAME_INSET_FOOTER_RENDERER:String = "feathers-grouped-list-inset-footer-renderer";

		/**
		 * An alternate name to use with item renderers to give them an inset
		 * style. This name is usually only referenced inside themes.
		 *
		 * <p>In the following example, the inset style is applied to a grouped
		 * list's item renderer:</p>
		 *
		 * <listing version="3.0">
		 * list.customItemRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_ITEM_RENDERER;</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_CHILD_STYLE_NAME_INSET_ITEM_RENDERER:String = "feathers-grouped-list-inset-item-renderer";

		/**
		 * An alternate name to use for item renderers to give them an inset
		 * style. Typically meant to be used for the renderer of the first item
		 * in a group. This name is usually only referenced inside themes.
		 *
		 * <p>In the following example, the inset style is applied to a grouped
		 * list's first item renderer:</p>
		 *
		 * <listing version="3.0">
		 * list.customFirstItemRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_FIRST_ITEM_RENDERER;</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_CHILD_STYLE_NAME_INSET_FIRST_ITEM_RENDERER:String = "feathers-grouped-list-inset-first-item-renderer";

		/**
		 * An alternate name to use for item renderers to give them an inset
		 * style. Typically meant to be used for the renderer of the last item
		 * in a group. This name is usually only referenced inside themes.
		 *
		 * <p>In the following example, the inset style is applied to a grouped
		 * list's last item renderer:</p>
		 *
		 * <listing version="3.0">
		 * list.customLastItemRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_LAST_ITEM_RENDERER;</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_CHILD_STYLE_NAME_INSET_LAST_ITEM_RENDERER:String = "feathers-grouped-list-inset-last-item-renderer";

		/**
		 * An alternate name to use for item renderers to give them an inset
		 * style. Typically meant to be used for the renderer of an item in a
		 * group that has no other items. This name is usually only referenced
		 * inside themes.
		 *
		 * <p>In the following example, the inset style is applied to a grouped
		 * list's single item renderer:</p>
		 *
		 * <listing version="3.0">
		 * list.customSingleItemRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_SINGLE_ITEM_RENDERER;</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_CHILD_STYLE_NAME_INSET_SINGLE_ITEM_RENDERER:String = "feathers-grouped-list-inset-single-item-renderer";

		/**
		 * Constructor.
		 */
		public function GroupedList()
		{
			super();
		}

		/**
		 * @private
		 * The guts of the List's functionality. Handles layout and selection.
		 */
		protected var dataViewPort:GroupedListDataViewPort;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return GroupedList.globalStyleProvider;
		}

		/**
		 * @private
		 */
		override public function get isFocusEnabled():Boolean
		{
			return (this._isSelectable || this._minHorizontalScrollPosition != this._maxHorizontalScrollPosition ||
				this._minVerticalScrollPosition != this._maxVerticalScrollPosition) &&
				this._isEnabled && this._isFocusEnabled;
		}

		/**
		 * @private
		 */
		protected var _isChildFocusEnabled:Boolean = true;

		/**
		 * @copy feathers.core.IFocusContainer#isChildFocusEnabled
		 *
		 * @default true
		 *
		 * @see #isFocusEnabled
		 */
		public function get isChildFocusEnabled():Boolean
		{
			return this._isEnabled && this._isChildFocusEnabled;
		}

		/**
		 * @private
		 */
		public function set isChildFocusEnabled(value:Boolean):void
		{
			this._isChildFocusEnabled = value;
		}

		/**
		 * @private
		 */
		protected var _layout:ILayout;

		/**
		 * @private
		 */
		public function get layout():ILayout
		{
			return this._layout;
		}

		/**
		 * @private
		 */
		public function set layout(value:ILayout):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._layout == value)
			{
				return;
			}
			if(this._layout)
			{
				this._layout.removeEventListener(Event.SCROLL, layout_scrollHandler);
			}
			this._layout = value;
			if(this._layout is IVariableVirtualLayout)
			{
				this._layout.addEventListener(Event.SCROLL, layout_scrollHandler);
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _dataProvider:IHierarchicalCollection;

		/**
		 * The collection of data displayed by the list. Changing this property
		 * to a new value is considered a drastic change to the list's data, so
		 * the horizontal and vertical scroll positions will be reset, and the
		 * list's selection will be cleared.
		 *
		 * <p>The following example passes in a data provider and tells the item
		 * renderer how to interpret the data:</p>
		 *
		 * <listing version="3.0">
		 * list.dataProvider = new ArrayHierarchicalCollection(
		 * [
		 *     {
		 *     	   header: "Dairy",
		 *     	   children:
		 *     	   [
		 *     	       { text: "Milk", thumbnail: textureAtlas.getTexture( "milk" ) },
		 *     	       { text: "Cheese", thumbnail: textureAtlas.getTexture( "cheese" ) },
		 *     	   ]
		 *     },
		 *     {
		 *         header: "Bakery",
		 *         children:
		 *         [
		 *             { text: "Bread", thumbnail: textureAtlas.getTexture( "bread" ) },
		 *         ]
		 *     },
		 *     {
		 *         header: "Produce",
		 *         children:
		 *         [
		 *             { text: "Bananas", thumbnail: textureAtlas.getTexture( "bananas" ) },
		 *             { text: "Lettuce", thumbnail: textureAtlas.getTexture( "lettuce" ) },
		 *             { text: "Onion", thumbnail: textureAtlas.getTexture( "onion" ) },
		 *         ]
		 *     },
		 * ]);
		 * 
		 * list.itemRendererFactory = function():IGroupedListItemRenderer
		 * {
		 *     var renderer:DefaultGroupedListItemRenderer = new DefaultGroupedListItemRenderer();
		 *     renderer.labelField = "text";
		 *     renderer.iconSourceField = "thumbnail";
		 *     return renderer;
		 * };</listing>
		 *
		 * <p><em>Warning:</em> A grouped list's data provider cannot contain
		 * duplicate items. To display the same item in multiple item renderers,
		 * you must create separate objects with the same properties. This
		 * restriction exists because it significantly improves performance.</p>
		 *
		 * <p><em>Warning:</em> If the data provider contains display objects,
		 * concrete textures, or anything that needs to be disposed, those
		 * objects will not be automatically disposed when the grouped list is
		 * disposed. Similar to how <code>starling.display.Image</code> cannot
		 * automatically dispose its texture because the texture may be used
		 * by other display objects, a list cannot dispose its data provider
		 * because the data provider may be used by other lists. See the
		 * <code>dispose()</code> function on <code>IHierarchicalCollection</code>
		 * to see how the data provider can be disposed properly.</p>
		 *
		 * @default null
		 *
		 * @see feathers.data.ArrayHierarchicalCollection
		 * @see feathers.data.VectorHierarchicalCollection
		 * @see feathers.data.XMLListHierarchicalCollection
		 */
		public function get dataProvider():IHierarchicalCollection
		{
			return this._dataProvider;
		}

		/**
		 * @private
		 */
		public function set dataProvider(value:IHierarchicalCollection):void
		{
			if(this._dataProvider == value)
			{
				return;
			}
			if(this._dataProvider)
			{
				this._dataProvider.removeEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ALL, dataProvider_removeAllHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.removeEventListener(Event.CHANGE, dataProvider_changeHandler);
			}
			this._dataProvider = value;
			if(this._dataProvider)
			{
				this._dataProvider.addEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ALL, dataProvider_removeAllHandler);
				this._dataProvider.addEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.addEventListener(Event.CHANGE, dataProvider_changeHandler);
			}

			//reset the scroll position because this is a drastic change and
			//the data is probably completely different
			this.horizontalScrollPosition = 0;
			this.verticalScrollPosition = 0;

			//clear the selection for the same reason
			this.setSelectedLocation(-1, -1);

			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _isSelectable:Boolean = true;

		/**
		 * Determines if an item in the list may be selected.
		 *
		 * <p>The following example disables selection:</p>
		 *
		 * <listing version="3.0">
		 * list.isSelectable = false;</listing>
		 *
		 * @default true
		 *
		 * @see #selectedItem
		 * @see #selectedGroupIndex
		 * @see #selectedItemIndex
		 */
		public function get isSelectable():Boolean
		{
			return this._isSelectable;
		}

		/**
		 * @private
		 */
		public function set isSelectable(value:Boolean):void
		{
			if(this._isSelectable == value)
			{
				return;
			}
			this._isSelectable = value;
			if(!this._isSelectable)
			{
				this.setSelectedLocation(-1, -1);
			}
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * @private
		 */
		protected var _helperLocation:Vector.<int> = new <int>[];

		/**
		 * @private
		 */
		protected var _selectedGroupIndex:int = -1;

		/**
		 * The group index of the currently selected item. Returns <code>-1</code>
		 * if no item is selected.
		 *
		 * <p>Because the selection consists of both a group index and an item
		 * index, this property does not have a setter. To change the selection,
		 * call <code>setSelectedLocation()</code> instead.</p>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected group index and selected item index:</p>
		 *
		 * <listing version="3.0">
		 * function list_changeHandler( event:Event ):void
		 * {
		 *     var list:List = GroupedList(event.currentTarget);
		 *     var groupIndex:int = list.selectedGroupIndex;
		 *     var itemIndex:int = list.selectedItemIndex;
		 * 
		 * }
		 * list.addEventListener( Event.CHANGE, list_changeHandler );</listing>
		 *
		 * @default -1
		 *
		 * @see #selectedItemIndex
		 * @see #setSelectedLocation()
		 */
		public function get selectedGroupIndex():int
		{
			return this._selectedGroupIndex;
		}

		/**
		 * @private
		 */
		protected var _selectedItemIndex:int = -1;

		/**
		 * The item index of the currently selected item. Returns <code>-1</code>
		 * if no item is selected.
		 *
		 * <p>Because the selection consists of both a group index and an item
		 * index, this property does not have a setter. To change the selection,
		 * call <code>setSelectedLocation()</code> instead.</p>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected group index and selected item index:</p>
		 *
		 * <listing version="3.0">
		 * function list_changeHandler( event:Event ):void
		 * {
		 *     var list:GroupedList = GroupedList( event.currentTarget );
		 *     var groupIndex:int = list.selectedGroupIndex;
		 *     var itemIndex:int = list.selectedItemIndex;
		 * 
		 * }
		 * list.addEventListener( Event.CHANGE, list_changeHandler );</listing>
		 *
		 * @default -1
		 *
		 * @see #selectedGroupIndex
		 * @see #setSelectedLocation()
		 */
		public function get selectedItemIndex():int
		{
			return this._selectedItemIndex;
		}

		/**
		 * The currently selected item. Returns <code>null</code> if no item is
		 * selected.
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected item:</p>
		 *
		 * <listing version="3.0">
		 * function list_changeHandler( event:Event ):void
		 * {
		 *     var list:GroupedList = GroupedList( event.currentTarget );
		 *     var item:Object = list.selectedItem;
		 * 
		 * }
		 * list.addEventListener( Event.CHANGE, list_changeHandler );</listing>
		 *
		 * @default null
		 */
		public function get selectedItem():Object
		{
			if(!this._dataProvider || this._selectedGroupIndex < 0 || this._selectedItemIndex < 0)
			{
				return null;
			}
			this._helperLocation.length = 2;
			this._helperLocation[0] = this._selectedGroupIndex;
			this._helperLocation[1] = this._selectedItemIndex;
			var result:Object = this._dataProvider.getItemAt(this._selectedGroupIndex, this._selectedItemIndex);
			this._helperLocation.length = 0;
			return result;
		}

		/**
		 * @private
		 */
		public function set selectedItem(value:Object):void
		{
			if(!this._dataProvider)
			{
				this.setSelectedLocation(-1, -1);
				return;
			}
			var result:Vector.<int> = this._dataProvider.getItemLocation(value);
			if(result.length == 2)
			{
				this.setSelectedLocation(result[0], result[1]);
			}
			else
			{
				this.setSelectedLocation(-1, -1);
			}
		}

		/**
		 * @private
		 */
		protected var _itemRendererType:Class = DefaultGroupedListItemRenderer;

		/**
		 * The class used to instantiate item renderers. Must implement the
		 * <code>IGroupedListItemRenderer</code> interface.
		 *
		 * <p>To customize properties on the item renderer, use
		 * <code>itemRendererFactory</code> instead.</p>
		 *
		 * <p>The following example changes the item renderer type:</p>
		 *
		 * <listing version="3.0">
		 * list.itemRendererType = CustomItemRendererClass;</listing>
		 *
		 * <p>The first item and last item in a group may optionally use
		 * different item renderer types, if desired. Use the
		 * <code>firstItemRendererType</code> and <code>lastItemRendererType</code>,
		 * respectively. Additionally, if a group contains only one item, it may
		 * also have a different type. Use the <code>singleItemRendererType</code>.
		 * Finally, factories for each of these types may also be customized.</p>
		 *
		 * @default feathers.controls.renderers.DefaultGroupedListItemRenderer
		 *
		 * @see feathers.controls.renderers.IGroupedListItemRenderer
		 * @see #itemRendererFactory
		 * @see #firstItemRendererType
		 * @see #lastItemRendererType
		 * @see #singleItemRendererType
		 */
		public function get itemRendererType():Class
		{
			return this._itemRendererType;
		}

		/**
		 * @private
		 */
		public function set itemRendererType(value:Class):void
		{
			if(this._itemRendererType == value)
			{
				return;
			}

			this._itemRendererType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _itemRendererFactories:Object;

		/**
		 * @private
		 */
		protected var _itemRendererFactory:Function;

		/**
		 * A function called that is expected to return a new item renderer. Has
		 * a higher priority than <code>itemRendererType</code>. Typically, you
		 * would use an <code>itemRendererFactory</code> instead of an
		 * <code>itemRendererType</code> if you wanted to initialize some
		 * properties on each separate item renderer, such as skins.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 *
		 * <pre>function():IGroupedListItemRenderer</pre>
		 *
		 * <p>The following example provides a factory for the item renderer:</p>
		 *
		 * <listing version="3.0">
		 * list.itemRendererFactory = function():IGroupedListItemRenderer
		 * {
		 *     var renderer:CustomItemRendererClass = new CustomItemRendererClass();
		 *     renderer.backgroundSkin = new Quad( 10, 10, 0xff0000 );
		 *     return renderer;
		 * };</listing>
		 *
		 * <p>The first item and last item in a group may optionally use
		 * different item renderer factories, if desired. Use the
		 * <code>firstItemRendererFactory</code> and <code>lastItemRendererFactory</code>,
		 * respectively. Additionally, if a group contains only one item, it may
		 * also have a different factory. Use the <code>singleItemRendererFactory</code>.</p>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderers.IGroupedListItemRenderer
		 * @see #itemRendererType
		 * @see #setItemRendererFactoryWithID()
		 */
		public function get itemRendererFactory():Function
		{
			return this._itemRendererFactory;
		}

		/**
		 * @private
		 */
		public function set itemRendererFactory(value:Function):void
		{
			if(this._itemRendererFactory === value)
			{
				return;
			}

			this._itemRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _factoryIDFunction:Function;

		/**
		 * When a list requires multiple item renderer types, this function is
		 * used to determine which type of item renderer is required for a
		 * specific item (or index). Returns the ID of the item renderer type
		 * to use for the item, or <code>null</code> if the default
		 * <code>itemRendererFactory</code> should be used.
		 *
		 * <p>The function is expected to have one of the following
		 * signatures:</p>
		 *
		 * <pre>function(item:Object):String</pre>
		 *
		 * <pre>function(item:Object, groupIndex:int, itemIndex:int):String</pre>
		 *
		 * <p>The following example provides a <code>factoryIDFunction</code>:</p>
		 *
		 * <listing version="3.0">
		 * function regularItemFactory():IGroupedListItemRenderer
		 * {
		 *     return new DefaultGroupedListItemRenderer();
		 * }
		 * function firstItemFactory():IGroupedListItemRenderer
		 * {
		 *     return new CustomItemRenderer();
		 * }
		 * list.setItemRendererFactoryWithID( "regular-item", regularItemFactory );
		 * list.setItemRendererFactoryWithID( "first-item", firstItemFactory );
		 * 
		 * list.factoryIDFunction = function( item:Object, groupIndex:int, itemIndex:int ):String
		 * {
		 *     if(index == 0)
		 *     {
		 *         return "first-item";
		 *     }
		 *     return "regular-item";
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #setItemRendererFactoryWithID()
		 * @see #itemRendererFactory
		 */
		public function get factoryIDFunction():Function
		{
			return this._factoryIDFunction;
		}

		/**
		 * @private
		 */
		public function set factoryIDFunction(value:Function):void
		{
			if(this._factoryIDFunction === value)
			{
				return;
			}
			this._factoryIDFunction = value;
			if(value !== null && this._itemRendererFactories === null)
			{
				this._itemRendererFactories = {};
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _typicalItem:Object = null;

		/**
		 * Used to auto-size the list when a virtualized layout is used. If the
		 * list's width or height is unknown, the list will try to automatically
		 * pick an ideal size. This item is used to create a sample item
		 * renderer to measure item renderers that are virtual and not visible
		 * in the viewport.
		 *
		 * <p>The following example provides a typical item:</p>
		 *
		 * <listing version="3.0">
		 * list.typicalItem = { text: "A typical item", thumbnail: texture };</listing>
		 *
		 * @default null
		 */
		public function get typicalItem():Object
		{
			return this._typicalItem;
		}

		/**
		 * @private
		 */
		public function set typicalItem(value:Object):void
		{
			if(this._typicalItem == value)
			{
				return;
			}
			this._typicalItem = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _customItemRendererStyleName:String;

		/**
		 * @private
		 */
		public function get customItemRendererStyleName():String
		{
			return this._customItemRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customItemRendererStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customItemRendererStyleName === value)
			{
				return;
			}
			this._customItemRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _itemRendererProperties:PropertyProxy;

		/**
		 * An object that stores properties for all of the list's item
		 * renderers, and the properties will be passed down to every item
		 * renderer when the list validates. The available properties
		 * depend on which <code>IGroupedListItemRenderer</code> implementation
		 * is returned by <code>itemRendererFactory</code>.
		 *
		 * <p>By default, the <code>itemRendererFactory</code> will return a
		 * <code>DefaultGroupedListItemRenderer</code> instance. If you aren't
		 * using a custom item renderer, you can refer to
		 * <a href="renderers/DefaultGroupedListItemRenderer.html"><code>feathers.controls.renderers.DefaultGroupedListItemRenderer</code></a>
		 * for a list of available properties.</p>
		 *
		 * <p>These properties are shared by every item renderer, so anything
		 * that cannot be shared (such as display objects, which cannot be added
		 * to multiple parents) should be passed to item renderers using the
		 * <code>itemRendererFactory</code> or in the theme.</p>
		 *
		 * <p>The following example customizes some item renderer properties
		 * (this example assumes that the item renderer's label text renderer
		 * is a <code>BitmapFontTextRenderer</code>):</p>
		 *
		 * <listing version="3.0">
		 * list.itemRendererProperties.labelField = "text";
		 * list.itemRendererProperties.accessoryField = "control";</listing>
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>itemRendererFactory</code> function instead
		 * of using <code>itemRendererProperties</code> will result in better
		 * performance.</p>
		 *
		 * @default null
		 *
		 * @see #itemRendererFactory
		 * @see feathers.controls.renderers.IGroupedListItemRenderer
		 * @see feathers.controls.renderers.DefaultGroupedListItemRenderer
		 */
		public function get itemRendererProperties():Object
		{
			if(!this._itemRendererProperties)
			{
				this._itemRendererProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._itemRendererProperties;
		}

		/**
		 * @private
		 */
		public function set itemRendererProperties(value:Object):void
		{
			if(this._itemRendererProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._itemRendererProperties)
			{
				this._itemRendererProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._itemRendererProperties = PropertyProxy(value);
			if(this._itemRendererProperties)
			{
				this._itemRendererProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _firstItemRendererType:Class;

		/**
		 * The class used to instantiate the item renderer for the first item in
		 * a group. Must implement the <code>IGroupedListItemRenderer</code>
		 * interface.
		 *
		 * <p>The following example changes the first item renderer type:</p>
		 *
		 * <listing version="3.0">
		 * list.firstItemRendererType = CustomItemRendererClass;</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderer.IGroupedListItemRenderer
		 * @see #itemRendererType
		 * @see #lastItemRendererType
		 * @see #singleItemRendererType
		 */
		public function get firstItemRendererType():Class
		{
			return this._firstItemRendererType;
		}

		/**
		 * @private
		 */
		public function set firstItemRendererType(value:Class):void
		{
			if(this._firstItemRendererType == value)
			{
				return;
			}

			this._firstItemRendererType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _firstItemRendererFactory:Function;

		/**
		 * A function called that is expected to return a new item renderer for
		 * the first item in a group. Has a higher priority than
		 * <code>firstItemRendererType</code>. Typically, you would use an
		 * <code>firstItemRendererFactory</code> instead of an
		 * <code>firstItemRendererType</code> if you wanted to initialize some
		 * properties on each separate item renderer, such as skins.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 *
		 * <pre>function():IGroupedListItemRenderer</pre>
		 *
		 * <p>The following example provides a factory for the item renderer
		 * used for the first item in a group:</p>
		 *
		 * <listing version="3.0">
		 * list.firstItemRendererFactory = function():IGroupedListItemRenderer
		 * {
		 *     var renderer:CustomItemRendererClass = new CustomItemRendererClass();
		 *     renderer.backgroundSkin = new Quad( 10, 10, 0xff0000 );
		 *     return renderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderers.IGroupedListItemRenderer
		 * @see #firstItemRendererType
		 * @see #itemRendererFactory
		 * @see #lastItemRendererFactory
		 * @see #singleItemRendererFactory
		 */
		public function get firstItemRendererFactory():Function
		{
			return this._firstItemRendererFactory;
		}

		/**
		 * @private
		 */
		public function set firstItemRendererFactory(value:Function):void
		{
			if(this._firstItemRendererFactory === value)
			{
				return;
			}

			this._firstItemRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _customFirstItemRendererStyleName:String;

		/**
		 * @private
		 */
		public function get customFirstItemRendererStyleName():String
		{
			return this._customFirstItemRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customFirstItemRendererStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customFirstItemRendererStyleName === value)
			{
				return;
			}
			this._customFirstItemRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _lastItemRendererType:Class;

		/**
		 * The class used to instantiate the item renderer for the last item in
		 * a group. Must implement the <code>IGroupedListItemRenderer</code>
		 * interface.
		 *
		 * <p>The following example changes the last item renderer type:</p>
		 *
		 * <listing version="3.0">
		 * list.lastItemRendererType = CustomItemRendererClass;</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderer.IGroupedListItemRenderer
		 * @see #lastItemRendererFactory
		 * @see #itemRendererType
		 * @see #firstItemRendererType
		 * @see #singleItemRendererType
		 */
		public function get lastItemRendererType():Class
		{
			return this._lastItemRendererType;
		}

		/**
		 * @private
		 */
		public function set lastItemRendererType(value:Class):void
		{
			if(this._lastItemRendererType == value)
			{
				return;
			}

			this._lastItemRendererType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _lastItemRendererFactory:Function;

		/**
		 * A function called that is expected to return a new item renderer for
		 * the last item in a group. Has a higher priority than
		 * <code>lastItemRendererType</code>. Typically, you would use an
		 * <code>lastItemRendererFactory</code> instead of an
		 * <code>lastItemRendererType</code> if you wanted to initialize some
		 * properties on each separate item renderer, such as skins.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 *
		 * <pre>function():IGroupedListItemRenderer</pre>
		 *
		 * <p>The following example provides a factory for the item renderer
		 * used for the last item in a group:</p>
		 *
		 * <listing version="3.0">
		 * list.firstItemRendererFactory = function():IGroupedListItemRenderer
		 * {
		 *     var renderer:CustomItemRendererClass = new CustomItemRendererClass();
		 *     renderer.backgroundSkin = new Quad( 10, 10, 0xff0000 );
		 *     return renderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderers.IGroupedListItemRenderer
		 * @see #lastItemRendererType
		 * @see #itemRendererFactory
		 * @see #firstItemRendererFactory
		 * @see #singleItemRendererFactory
		 */
		public function get lastItemRendererFactory():Function
		{
			return this._lastItemRendererFactory;
		}

		/**
		 * @private
		 */
		public function set lastItemRendererFactory(value:Function):void
		{
			if(this._lastItemRendererFactory === value)
			{
				return;
			}

			this._lastItemRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _customLastItemRendererStyleName:String;

		/**
		 * @private
		 */
		public function get customLastItemRendererStyleName():String
		{
			return this._customLastItemRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customLastItemRendererStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customLastItemRendererStyleName === value)
			{
				return;
			}
			this._customLastItemRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _singleItemRendererType:Class;

		/**
		 * The class used to instantiate the item renderer for an item in a
		 * group with no other items. Must implement the
		 * <code>IGroupedListItemRenderer</code> interface.
		 *
		 * <p>The following example changes the single item renderer type:</p>
		 *
		 * <listing version="3.0">
		 * list.singleItemRendererType = CustomItemRendererClass;</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderer.IGroupedListItemRenderer
		 * @see #singleItemRendererFactory
		 * @see #itemRendererType
		 * @see #firstItemRendererType
		 * @see #lastItemRendererType
		 */
		public function get singleItemRendererType():Class
		{
			return this._singleItemRendererType;
		}

		/**
		 * @private
		 */
		public function set singleItemRendererType(value:Class):void
		{
			if(this._singleItemRendererType == value)
			{
				return;
			}

			this._singleItemRendererType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _singleItemRendererFactory:Function;

		/**
		 * A function called that is expected to return a new item renderer for
		 * an item in a group with no other items. Has a higher priority than
		 * <code>singleItemRendererType</code>. Typically, you would use an
		 * <code>singleItemRendererFactory</code> instead of an
		 * <code>singleItemRendererType</code> if you wanted to initialize some
		 * properties on each separate item renderer, such as skins.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 *
		 * <pre>function():IGroupedListItemRenderer</pre>
		 *
		 * <p>The following example provides a factory for the item renderer
		 * used for when only one item appears in a group:</p>
		 *
		 * <listing version="3.0">
		 * list.firstItemRendererFactory = function():IGroupedListItemRenderer
		 * {
		 *     var renderer:CustomItemRendererClass = new CustomItemRendererClass();
		 *     renderer.backgroundSkin = new Quad( 10, 10, 0xff0000 );
		 *     return renderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderers.IGroupedListItemRenderer
		 * @see #singleItemRendererType
		 * @see #itemRendererFactory
		 * @see #firstItemRendererFactory
		 * @see #lastItemRendererFactory
		 */
		public function get singleItemRendererFactory():Function
		{
			return this._singleItemRendererFactory;
		}

		/**
		 * @private
		 */
		public function set singleItemRendererFactory(value:Function):void
		{
			if(this._singleItemRendererFactory === value)
			{
				return;
			}

			this._singleItemRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _customSingleItemRendererStyleName:String;

		/**
		 * @private
		 */
		public function get customSingleItemRendererStyleName():String
		{
			return this._customSingleItemRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customSingleItemRendererStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customSingleItemRendererStyleName === value)
			{
				return;
			}
			this._customSingleItemRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _headerRendererType:Class = DefaultGroupedListHeaderOrFooterRenderer;

		/**
		 * The class used to instantiate header renderers. Must implement the
		 * <code>IGroupedListHeaderOrFooterRenderer</code> interface.
		 *
		 * <p>The following example changes the header renderer type:</p>
		 *
		 * <listing version="3.0">
		 * list.headerRendererType = CustomHeaderRendererClass;</listing>
		 *
		 * @default feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer
		 *
		 * @see feathers.controls.renderers.IGroupedListHeaderOrFooterRenderer
		 * @see #headerRendererFactory
		 */
		public function get headerRendererType():Class
		{
			return this._headerRendererType;
		}

		/**
		 * @private
		 */
		public function set headerRendererType(value:Class):void
		{
			if(this._headerRendererType == value)
			{
				return;
			}

			this._headerRendererType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _headerRendererFactories:Object;

		/**
		 * @private
		 */
		protected var _headerRendererFactory:Function;

		/**
		 * A function called that is expected to return a new header renderer.
		 * Has a higher priority than <code>headerRendererType</code>.
		 * Typically, you would use an <code>headerRendererFactory</code>
		 * instead of a <code>headerRendererType</code> if you wanted to
		 * initialize some properties on each separate header renderer, such as
		 * skins.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 *
		 * <pre>function():IGroupedListHeaderOrFooterRenderer</pre>
		 *
		 * <p>The following example provides a factory for the header renderer:</p>
		 *
		 * <listing version="3.0">
		 * list.itemRendererFactory = function():IGroupedListHeaderOrFooterRenderer
		 * {
		 *     var renderer:CustomHeaderRendererClass = new CustomHeaderRendererClass();
		 *     renderer.backgroundSkin = new Quad( 10, 10, 0xff0000 );
		 *     return renderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderers.IGroupedListHeaderOrFooterRenderer
		 * @see #headerRendererType
		 * @see #setHeaderRendererFactoryWithID()
		 */
		public function get headerRendererFactory():Function
		{
			return this._headerRendererFactory;
		}

		/**
		 * @private
		 */
		public function set headerRendererFactory(value:Function):void
		{
			if(this._headerRendererFactory === value)
			{
				return;
			}

			this._headerRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _headerFactoryIDFunction:Function;

		/**
		 * When a list requires multiple header renderer types, this function is
		 * used to determine which type of header renderer is required for a
		 * specific header (or group index). Returns the ID of the factory
		 * to use for the header, or <code>null</code> if the default
		 * <code>headerRendererFactory</code> should be used.
		 *
		 * <p>The function is expected to have one of the following
		 * signatures:</p>
		 *
		 * <pre>function(header:Object):String</pre>
		 *
		 * <pre>function(header:Object, groupIndex:int):String</pre>
		 *
		 * <p>The following example provides a <code>headerFactoryIDFunction</code>:</p>
		 *
		 * <listing version="3.0">
		 * function regularHeaderFactory():IGroupedListHeaderRenderer
		 * {
		 *     return new DefaultGroupedListHeaderOrFooterRenderer();
		 * }
		 * function customHeaderFactory():IGroupedListHeaderRenderer
		 * {
		 *     return new CustomHeaderRenderer();
		 * }
		 * list.setHeaderRendererFactoryWithID( "regular-header", regularHeaderFactory );
		 * list.setHeaderRendererFactoryWithID( "custom-header", customHeaderFactory );
		 * 
		 * list.headerFactoryIDFunction = function( header:Object, groupIndex:int ):String
		 * {
		 *     //check if the subTitle property exists in the header data
		 *     if( "subTitle" in header )
		 *     {
		 *         return "custom-header";
		 *     }
		 *     return "regular-header";
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #setHeaderRendererFactoryWithID()
		 * @see #headerRendererFactory
		 */
		public function get headerFactoryIDFunction():Function
		{
			return this._headerFactoryIDFunction;
		}

		/**
		 * @private
		 */
		public function set headerFactoryIDFunction(value:Function):void
		{
			if(this._headerFactoryIDFunction === value)
			{
				return;
			}
			this._headerFactoryIDFunction = value;
			if(value !== null && this._headerRendererFactories === null)
			{
				this._headerRendererFactories = {};
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _customHeaderRendererStyleName:String = DEFAULT_CHILD_STYLE_NAME_HEADER_RENDERER;

		/**
		 * @private
		 */
		public function get customHeaderRendererStyleName():String
		{
			return this._customHeaderRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customHeaderRendererStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customHeaderRendererStyleName === value)
			{
				return;
			}
			this._customHeaderRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _headerRendererProperties:PropertyProxy;

		/**
		 * An object that stores properties for all of the list's header
		 * renderers, and the properties will be passed down to every header
		 * renderer when the list validates. The available properties
		 * depend on which <code>IGroupedListHeaderOrFooterRenderer</code>
		 * implementation is returned by <code>headerRendererFactory</code>.
		 *
		 * <p>By default, the <code>headerRendererFactory</code> will return a
		 * <code>DefaultGroupedListHeaderOrFooterRenderer</code> instance. If
		 * you aren't using a custom header renderer, you can refer to
		 * <a href="renderers/DefaultGroupedListHeaderOrFooterRenderer.html"><code>feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer</code></a>
		 * for a list of available properties.</p>
		 *
		 * <p>These properties are shared by every header renderer, so anything
		 * that cannot be shared (such as display objects, which cannot be added
		 * to multiple parents) should be passed to header renderers using the
		 * <code>headerRendererFactory</code> or in the theme.</p>
		 *
		 * <p>The following example customizes some header renderer properties:</p>
		 *
		 * <listing version="3.0">
		 * list.headerRendererProperties.contentLabelField = "headerText";
		 * list.headerRendererProperties.contentLabelStyleName = "custom-header-renderer-content-label";</listing>
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>headerRendererFactory</code> function instead
		 * of using <code>headerRendererProperties</code> will result in better
		 * performance.</p>
		 *
		 * @default null
		 *
		 * @see #headerRendererFactory
		 * @see feathers.controls.renderers.IGroupedListHeaderOrFooterRenderer
		 * @see feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer
		 */
		public function get headerRendererProperties():Object
		{
			if(!this._headerRendererProperties)
			{
				this._headerRendererProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._headerRendererProperties;
		}

		/**
		 * @private
		 */
		public function set headerRendererProperties(value:Object):void
		{
			if(this._headerRendererProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._headerRendererProperties)
			{
				this._headerRendererProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._headerRendererProperties = PropertyProxy(value);
			if(this._headerRendererProperties)
			{
				this._headerRendererProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _footerRendererType:Class = DefaultGroupedListHeaderOrFooterRenderer;

		/**
		 * The class used to instantiate footer renderers. Must implement the
		 * <code>IGroupedListHeaderOrFooterRenderer</code> interface.
		 *
		 * <p>The following example changes the footer renderer type:</p>
		 *
		 * <listing version="3.0">
		 * list.footerRendererType = CustomFooterRendererClass;</listing>
		 *
		 * @default feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer
		 *
		 * @see feathers.controls.renderers.IGroupedListHeaderOrFooterRenderer
		 * @see #footerRendererFactory
		 */
		public function get footerRendererType():Class
		{
			return this._footerRendererType;
		}

		/**
		 * @private
		 */
		public function set footerRendererType(value:Class):void
		{
			if(this._footerRendererType == value)
			{
				return;
			}

			this._footerRendererType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _footerRendererFactories:Object;

		/**
		 * @private
		 */
		protected var _footerRendererFactory:Function;

		/**
		 * A function called that is expected to return a new footer renderer.
		 * Has a higher priority than <code>footerRendererType</code>.
		 * Typically, you would use an <code>footerRendererFactory</code>
		 * instead of a <code>footerRendererType</code> if you wanted to
		 * initialize some properties on each separate footer renderer, such as
		 * skins.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 *
		 * <pre>function():IGroupedListHeaderOrFooterRenderer</pre>
		 *
		 * <p>The following example provides a factory for the footer renderer:</p>
		 *
		 * <listing version="3.0">
		 * list.itemRendererFactory = function():IGroupedListHeaderOrFooterRenderer
		 * {
		 *     var renderer:CustomFooterRendererClass = new CustomFooterRendererClass();
		 *     renderer.backgroundSkin = new Quad( 10, 10, 0xff0000 );
		 *     return renderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderers.IGroupedListHeaderOrFooterRenderer
		 * @see #footerRendererType
		 * @see #setFooterRendererFactoryWithID()
		 */
		public function get footerRendererFactory():Function
		{
			return this._footerRendererFactory;
		}

		/**
		 * @private
		 */
		public function set footerRendererFactory(value:Function):void
		{
			if(this._footerRendererFactory === value)
			{
				return;
			}

			this._footerRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _footerFactoryIDFunction:Function;

		/**
		 * When a list requires multiple footer renderer types, this function is
		 * used to determine which type of footer renderer is required for a
		 * specific footer (or group index). Returns the ID of the factory
		 * to use for the footer, or <code>null</code> if the default
		 * <code>footerRendererFactory</code> should be used.
		 *
		 * <p>The function is expected to have one of the following
		 * signatures:</p>
		 *
		 * <pre>function(footer:Object):String</pre>
		 *
		 * <pre>function(footer:Object, groupIndex:int):String</pre>
		 *
		 * <p>The following example provides a <code>footerFactoryIDFunction</code>:</p>
		 *
		 * <listing version="3.0">
		 * function regularFooterFactory():IGroupedListFooterRenderer
		 * {
		 *     return new DefaultGroupedListHeaderOrFooterRenderer();
		 * }
		 * function customFooterFactory():IGroupedListFooterRenderer
		 * {
		 *     return new CustomFooterRenderer();
		 * }
		 * list.setFooterRendererFactoryWithID( "regular-footer", regularFooterFactory );
		 * list.setFooterRendererFactoryWithID( "custom-footer", customFooterFactory );
		 * 
		 * list.footerFactoryIDFunction = function( footer:Object, groupIndex:int ):String
		 * {
		 *     //check if the footerAccessory property exists in the footer data
		 *     if( "footerAccessory" in footer )
		 *     {
		 *         return "custom-footer";
		 *     }
		 *     return "regular-footer";
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #setFooterRendererFactoryWithID()
		 * @see #footerRendererFactory
		 */
		public function get footerFactoryIDFunction():Function
		{
			return this._footerFactoryIDFunction;
		}

		/**
		 * @private
		 */
		public function set footerFactoryIDFunction(value:Function):void
		{
			if(this._footerFactoryIDFunction === value)
			{
				return;
			}
			this._footerFactoryIDFunction = value;
			if(value !== null && this._footerRendererFactories === null)
			{
				this._footerRendererFactories = {};
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _customFooterRendererStyleName:String = DEFAULT_CHILD_STYLE_NAME_FOOTER_RENDERER;

		/**
		 * @private
		 */
		public function get customFooterRendererStyleName():String
		{
			return this._customFooterRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customFooterRendererStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customFooterRendererStyleName === value)
			{
				return;
			}
			this._customFooterRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _footerRendererProperties:PropertyProxy;

		/**
		 * An object that stores properties for all of the list's footer
		 * renderers, and the properties will be passed down to every footer
		 * renderer when the list validates. The available properties
		 * depend on which <code>IGroupedListHeaderOrFooterRenderer</code>
		 * implementation is returned by <code>footerRendererFactory</code>.
		 *
		 * <p>By default, the <code>footerRendererFactory</code> will return a
		 * <code>DefaultGroupedListHeaderOrFooterRenderer</code> instance. If
		 * you aren't using a custom footer renderer, you can refer to
		 * <a href="renderers/DefaultGroupedListHeaderOrFooterRenderer.html"><code>feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer</code></a>
		 * for a list of available properties.</p>
		 *
		 * <p>These properties are shared by every footer renderer, so anything
		 * that cannot be shared (such as display objects, which cannot be added
		 * to multiple parents) should be passed to footer renderers using the
		 * <code>footerRendererFactory</code> or in the theme.</p>
		 *
		 * <p>The following example customizes some footer renderer properties:</p>
		 *
		 * <listing version="3.0">
		 * list.footerRendererProperties.contentLabelField = "footerText";
		 * list.footerRendererProperties.contentLabelStyleName = "custom-footer-renderer-content-label";</listing>
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>footerRendererFactory</code> function instead
		 * of using <code>footerRendererProperties</code> will result in better
		 * performance.</p>
		 *
		 * @default null
		 *
		 * @see #footerRendererFactory
		 * @see feathers.controls.renderers.IGroupedListHeaderOrFooterRenderer
		 * @see feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer
		 */
		public function get footerRendererProperties():Object
		{
			if(!this._footerRendererProperties)
			{
				this._footerRendererProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._footerRendererProperties;
		}

		/**
		 * @private
		 */
		public function set footerRendererProperties(value:Object):void
		{
			if(this._footerRendererProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._footerRendererProperties)
			{
				this._footerRendererProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._footerRendererProperties = PropertyProxy(value);
			if(this._footerRendererProperties)
			{
				this._footerRendererProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _headerField:String = "header";

		/**
		 * The field in a group that contains the data for a header. If the
		 * group does not have this field, and a <code>headerFunction</code> is
		 * not defined, then no header will be displayed for the group. In other
		 * words, a header is optional, and a group may not have one.
		 *
		 * <p>All of the header fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>headerFunction</code></li>
		 *     <li><code>headerField</code></li>
		 * </ol>
		 *
		 * <p>The following example sets the header field:</p>
		 *
		 * <listing version="3.0">
		 * list.headerField = "alphabet";</listing>
		 *
		 * @default "header"
		 *
		 * @see #headerFunction
		 */
		public function get headerField():String
		{
			return this._headerField;
		}

		/**
		 * @private
		 */
		public function set headerField(value:String):void
		{
			if(this._headerField == value)
			{
				return;
			}
			this._headerField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _headerFunction:Function;

		/**
		 * A function used to generate header data for a specific group. If this
		 * function is not null, then the <code>headerField</code> will be
		 * ignored.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):Object</pre>
		 *
		 * <p>All of the header fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>headerFunction</code></li>
		 *     <li><code>headerField</code></li>
		 * </ol>
		 *
		 * <p>The following example sets the header function:</p>
		 *
		 * <listing version="3.0">
		 * list.headerFunction = function( group:Object ):Object
		 * {
		 *    return group.header;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #headerField
		 */
		public function get headerFunction():Function
		{
			return this._headerFunction;
		}

		/**
		 * @private
		 */
		public function set headerFunction(value:Function):void
		{
			if(this._headerFunction == value)
			{
				return;
			}
			this._headerFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _footerField:String = "footer";

		/**
		 * The field in a group that contains the data for a footer. If the
		 * group does not have this field, and a <code>footerFunction</code> is
		 * not defined, then no footer will be displayed for the group. In other
		 * words, a footer is optional, and a group may not have one.
		 *
		 * <p>All of the footer fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>footerFunction</code></li>
		 *     <li><code>footerField</code></li>
		 * </ol>
		 *
		 * <p>The following example sets the footer field:</p>
		 *
		 * <listing version="3.0">
		 * list.footerField = "controls";</listing>
		 *
		 * @default "footer"
		 *
		 * @see #footerFunction
		 */
		public function get footerField():String
		{
			return this._footerField;
		}

		/**
		 * @private
		 */
		public function set footerField(value:String):void
		{
			if(this._footerField == value)
			{
				return;
			}
			this._footerField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _footerFunction:Function;

		/**
		 * A function used to generate footer data for a specific group. If this
		 * function is not null, then the <code>footerField</code> will be
		 * ignored.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):Object</pre>
		 *
		 * <p>All of the footer fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>footerFunction</code></li>
		 *     <li><code>footerField</code></li>
		 * </ol>
		 *
		 * <p>The following example sets the footer function:</p>
		 *
		 * <listing version="3.0">
		 * list.footerFunction = function( group:Object ):Object
		 * {
		 *    return group.footer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #footerField
		 */
		public function get footerFunction():Function
		{
			return this._footerFunction;
		}

		/**
		 * @private
		 */
		public function set footerFunction(value:Function):void
		{
			if(this._footerFunction == value)
			{
				return;
			}
			this._footerFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _keyScrollDuration:Number = 0.25;

		/**
		 * @private
		 */
		public function get keyScrollDuration():Number
		{
			return this._keyScrollDuration;
		}

		/**
		 * @private
		 */
		public function set keyScrollDuration(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._keyScrollDuration == value)
			{
				return;
			}
			this._keyScrollDuration = value;
		}

		/**
		 * The pending group index to scroll to after validating. A value of
		 * <code>-1</code> means that the scroller won't scroll to a group after
		 * validating.
		 */
		protected var pendingGroupIndex:int = -1;

		/**
		 * The pending item index to scroll to after validating. A value of
		 * <code>-1</code> means that the scroller won't scroll to an item after
		 * validating.
		 */
		protected var pendingItemIndex:int = -1;

		/**
		 * @private
		 */
		override public function dispose():void
		{
			//clearing selection now so that the data provider setter won't
			//cause a selection change that triggers events.
			this._selectedGroupIndex = -1;
			this._selectedItemIndex = -1;
			this.dataProvider = null;
			this.layout = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override public function scrollToPosition(horizontalScrollPosition:Number, verticalScrollPosition:Number, animationDuration:Number = NaN):void
		{
			this.pendingItemIndex = -1;
			super.scrollToPosition(horizontalScrollPosition, verticalScrollPosition, animationDuration);
		}

		/**
		 * @private
		 */
		override public function scrollToPageIndex(horizontalPageIndex:int, verticalPageIndex:int, animationDuration:Number = NaN):void
		{
			this.pendingGroupIndex = -1;
			this.pendingItemIndex = -1;
			super.scrollToPageIndex(horizontalPageIndex, verticalPageIndex, animationDuration);
		}

		/**
		 * After the next validation, scrolls the list so that the specified
		 * item is visible. If <code>animationDuration</code> is greater than
		 * zero, the scroll will animate. The duration is in seconds.
		 *
		 * <p>The <code>itemIndex</code> parameter is optional. If set to
		 * <code>-1</code>, the list will scroll to the start of the specified
		 * group.</p>
		 *
		 * <p>In the following example, the list is scrolled to display the
		 * third item in the second group:</p>
		 *
		 * <listing version="3.0">
		 * list.scrollToDisplayIndex( 1, 2 );</listing>
		 *
		 * <p>In the following example, the list is scrolled to display the
		 * third group:</p>
		 *
		 * <listing version="3.0">
		 * list.scrollToDisplayIndex( 2 );</listing>
		 */
		public function scrollToDisplayIndex(groupIndex:int, itemIndex:int = -1, animationDuration:Number = 0):void
		{
			//cancel any pending scroll to a different page or scroll position.
			//we can have only one type of pending scroll at a time.
			this.hasPendingHorizontalPageIndex = false;
			this.hasPendingVerticalPageIndex = false;
			this.pendingHorizontalScrollPosition = NaN;
			this.pendingVerticalScrollPosition = NaN;
			if(this.pendingGroupIndex == groupIndex &&
				this.pendingItemIndex == itemIndex &&
				this.pendingScrollDuration == animationDuration)
			{
				return;
			}
			this.pendingGroupIndex = groupIndex;
			this.pendingItemIndex = itemIndex;
			this.pendingScrollDuration = animationDuration;
			this.invalidate(INVALIDATION_FLAG_PENDING_SCROLL);
		}

		/**
		 * Sets the selected group and item index.
		 *
		 * <p>In the following example, the third item in the second group
		 * is selected:</p>
		 *
		 * <listing version="3.0">
		 * list.setSelectedLocation( 1, 2 );</listing>
		 *
		 * <p>In the following example, the selection is cleared:</p>
		 *
		 * <listing version="3.0">
		 * list.setSelectedLocation( -1, -1 );</listing>
		 *
		 * @see #selectedGroupIndex
		 * @see #selectedItemIndex
		 * @see #selectedItem
		 */
		public function setSelectedLocation(groupIndex:int, itemIndex:int):void
		{
			if(this._selectedGroupIndex == groupIndex && this._selectedItemIndex == itemIndex)
			{
				return;
			}
			if((groupIndex < 0 && itemIndex >= 0) || (groupIndex >= 0 && itemIndex < 0))
			{
				throw new ArgumentError("To deselect items, group index and item index must both be < 0.");
			}
			this._selectedGroupIndex = groupIndex;
			this._selectedItemIndex = itemIndex;

			this.invalidate(INVALIDATION_FLAG_SELECTED);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * Returns the item renderer factory associated with a specific ID.
		 * Returns <code>null</code> if no factory is associated with the ID.
		 *
		 * @see #setItemRendererFactoryWithID()
		 */
		public function getItemRendererFactoryWithID(id:String):Function
		{
			if(this._itemRendererFactories && (id in this._itemRendererFactories))
			{
				return this._itemRendererFactories[id] as Function;
			}
			return null;
		}

		/**
		 * Associates an item renderer factory with an ID to allow multiple
		 * types of item renderers may be displayed in the list. A custom
		 * <code>factoryIDFunction</code> may be specified to return the ID of
		 * the factory to use for a specific item in the data provider.
		 *
		 * @see #factoryIDFunction
		 * @see #getItemRendererFactoryWithID()
		 */
		public function setItemRendererFactoryWithID(id:String, factory:Function):void
		{
			if(id === null)
			{
				this.itemRendererFactory = factory;
				return;
			}
			if(this._itemRendererFactories === null)
			{
				this._itemRendererFactories = {};
			}
			if(factory !== null)
			{
				this._itemRendererFactories[id] = factory;
			}
			else
			{
				delete this._itemRendererFactories[id];
			}
		}

		/**
		 * Returns the header renderer factory associated with a specific ID.
		 * Returns <code>null</code> if no factory is associated with the ID.
		 *
		 * @see #setHeaderRendererFactoryWithID()
		 */
		public function getHeaderRendererFactoryWithID(id:String):Function
		{
			if(this._headerRendererFactories && (id in this._headerRendererFactories))
			{
				return this._headerRendererFactories[id] as Function;
			}
			return null;
		}

		/**
		 * Associates a header renderer factory with an ID to allow multiple
		 * types of header renderers may be displayed in the list. A custom
		 * <code>headerFactoryIDFunction</code> may be specified to return the
		 * ID of the factory to use for a specific header in the data provider.
		 *
		 * @see #headerFactoryIDFunction
		 * @see #getHeaderRendererFactoryWithID()
		 */
		public function setHeaderRendererFactoryWithID(id:String, factory:Function):void
		{
			if(id === null)
			{
				this.headerRendererFactory = factory;
				return;
			}
			if(this._headerRendererFactories === null)
			{
				this._headerRendererFactories = {};
			}
			if(factory !== null)
			{
				this._headerRendererFactories[id] = factory;
			}
			else
			{
				delete this._headerRendererFactories[id];
			}
		}

		/**
		 * Returns the footer renderer factory associated with a specific ID.
		 * Returns <code>null</code> if no factory is associated with the ID.
		 *
		 * @see #setFooterRendererFactoryWithID()
		 */
		public function getFooterRendererFactoryWithID(id:String):Function
		{
			if(this._footerRendererFactories && (id in this._footerRendererFactories))
			{
				return this._footerRendererFactories[id] as Function;
			}
			return null;
		}

		/**
		 * Associates a footer renderer factory with an ID to allow multiple
		 * types of footer renderers may be displayed in the list. A custom
		 * <code>footerFactoryIDFunction</code> may be specified to return the
		 * ID of the factory to use for a specific footer in the data provider.
		 *
		 * @see #footerFactoryIDFunction
		 * @see #getFooterRendererFactoryWithID()
		 */
		public function setFooterRendererFactoryWithID(id:String, factory:Function):void
		{
			if(id === null)
			{
				this.footerRendererFactory = factory;
				return;
			}
			if(this._footerRendererFactories === null)
			{
				this._footerRendererFactories = {};
			}
			if(factory !== null)
			{
				this._footerRendererFactories[id] = factory;
			}
			else
			{
				delete this._footerRendererFactories[id];
			}
		}

		/**
		 * Extracts header data from a group object.
		 */
		public function groupToHeaderData(group:Object):Object
		{
			if(this._headerFunction != null)
			{
				return this._headerFunction(group);
			}
			else if(this._headerField != null && group && group.hasOwnProperty(this._headerField))
			{
				return group[this._headerField];
			}

			return null;
		}

		/**
		 * Extracts footer data from a group object.
		 */
		public function groupToFooterData(group:Object):Object
		{
			if(this._footerFunction != null)
			{
				return this._footerFunction(group);
			}
			else if(this._footerField != null && group && group.hasOwnProperty(this._footerField))
			{
				return group[this._footerField];
			}

			return null;
		}

		/**
		 * Returns the current item renderer used to render a specific item. May
		 * return <code>null</code> if an item doesn't currently have an item
		 * renderer. Most lists use virtual layouts where only the visible items
		 * will have an item renderer, so the result will usually be
		 * <code>null</code> for most items in the data provider.
		 *
		 * @see ../../../help/faq/layout-virtualization.html What is layout virtualization?
		 */
		public function itemToItemRenderer(item:Object):IGroupedListItemRenderer
		{
			return this.dataViewPort.itemToItemRenderer(item);
		}

		/**
		 * Returns the current header renderer used to render specific header
		 * data. May return <code>null</code> if the header data doesn't
		 * currently have a header renderer. Most lists use virtual layouts
		 * where only the visible headers will have a header renderer, so the
		 * result will usually be <code>null</code> for most header data in the
		 * data provider.
		 *
		 * @see #groupToHeaderData()
		 * @see ../../../help/faq/layout-virtualization.html What is layout virtualization?
		 */
		public function headerDataToHeaderRenderer(headerData:Object):IGroupedListHeaderRenderer
		{
			return this.dataViewPort.headerDataToHeaderRenderer(headerData);
		}

		/**
		 * Returns the current footer renderer used to render specific footer
		 * data. May return <code>null</code> if the footer data doesn't
		 * currently have a footer renderer. Most lists use virtual layouts
		 * where only the visible footers will have a footer renderer, so the
		 * result will usually be <code>null</code> for most footer data in the
		 * data provider.
		 *
		 * @see #groupToFooterData()
		 * @see ../../../help/faq/layout-virtualization.html What is layout virtualization?
		 */
		public function footerDataToFooterRenderer(footerData:Object):IGroupedListFooterRenderer
		{
			return this.dataViewPort.footerDataToFooterRenderer(footerData);
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			var hasLayout:Boolean = this._layout !== null;

			super.initialize();

			if(!this.dataViewPort)
			{
				this.viewPort = this.dataViewPort = new GroupedListDataViewPort();
				this.dataViewPort.owner = this;
				this.dataViewPort.addEventListener(Event.CHANGE, dataViewPort_changeHandler);
				this.viewPort = this.dataViewPort;
			}

			if(!hasLayout)
			{
				if(this._hasElasticEdges &&
					this._verticalScrollPolicy === ScrollPolicy.AUTO &&
					this._scrollBarDisplayMode !== ScrollBarDisplayMode.FIXED)
				{
					//so that the elastic edges work even when the max scroll
					//position is 0, similar to iOS.
					this._verticalScrollPolicy = ScrollPolicy.ON;
				}

				var layout:VerticalLayout = new VerticalLayout();
				layout.useVirtualLayout = true;
				layout.padding = 0;
				layout.gap = 0;
				layout.horizontalAlign = HorizontalAlign.JUSTIFY;
				layout.verticalAlign = VerticalAlign.TOP;
				layout.stickyHeader = !this._styleNameList.contains(ALTERNATE_STYLE_NAME_INSET_GROUPED_LIST);
				this.ignoreNextStyleRestriction();
				this.layout = layout;
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			this.refreshDataViewPortProperties();
			super.draw();
		}

		/**
		 * @private
		 */
		protected function refreshDataViewPortProperties():void
		{
			this.dataViewPort.isSelectable = this._isSelectable;
			this.dataViewPort.setSelectedLocation(this._selectedGroupIndex, this._selectedItemIndex);
			this.dataViewPort.dataProvider = this._dataProvider;
			this.dataViewPort.typicalItem = this._typicalItem;

			this.dataViewPort.itemRendererType = this._itemRendererType;
			this.dataViewPort.itemRendererFactory = this._itemRendererFactory;
			this.dataViewPort.itemRendererFactories = this._itemRendererFactories;
			this.dataViewPort.factoryIDFunction = this._factoryIDFunction;
			this.dataViewPort.itemRendererProperties = this._itemRendererProperties;
			this.dataViewPort.customItemRendererStyleName = this._customItemRendererStyleName;

			this.dataViewPort.firstItemRendererType = this._firstItemRendererType;
			this.dataViewPort.firstItemRendererFactory = this._firstItemRendererFactory;
			this.dataViewPort.customFirstItemRendererStyleName = this._customFirstItemRendererStyleName;

			this.dataViewPort.lastItemRendererType = this._lastItemRendererType;
			this.dataViewPort.lastItemRendererFactory = this._lastItemRendererFactory;
			this.dataViewPort.customLastItemRendererStyleName = this._customLastItemRendererStyleName;

			this.dataViewPort.singleItemRendererType = this._singleItemRendererType;
			this.dataViewPort.singleItemRendererFactory = this._singleItemRendererFactory;
			this.dataViewPort.customSingleItemRendererStyleName = this._customSingleItemRendererStyleName;

			this.dataViewPort.headerRendererType = this._headerRendererType;
			this.dataViewPort.headerRendererFactory = this._headerRendererFactory;
			this.dataViewPort.headerRendererFactories = this._headerRendererFactories;
			this.dataViewPort.headerFactoryIDFunction = this._headerFactoryIDFunction;
			this.dataViewPort.headerRendererProperties = this._headerRendererProperties;
			this.dataViewPort.customHeaderRendererStyleName = this._customHeaderRendererStyleName;

			this.dataViewPort.footerRendererType = this._footerRendererType;
			this.dataViewPort.footerRendererFactory = this._footerRendererFactory;
			this.dataViewPort.footerRendererFactories = this._footerRendererFactories;
			this.dataViewPort.footerFactoryIDFunction = this._footerFactoryIDFunction;
			this.dataViewPort.footerRendererProperties = this._footerRendererProperties;
			this.dataViewPort.customFooterRendererStyleName = this._customFooterRendererStyleName;

			this.dataViewPort.layout = this._layout;
		}

		/**
		 * @private
		 */
		override protected function handlePendingScroll():void
		{
			if(this.pendingGroupIndex >= 0)
			{
				var pendingData:Object = null;
				if(this._dataProvider !== null)
				{
					if(this.pendingItemIndex >= 0)
					{
						this._helperLocation.length = 2;
						this._helperLocation[0] = this._selectedGroupIndex;
						this._helperLocation[1] = this._selectedItemIndex;
						pendingData = this._dataProvider.getItemAt(this.pendingGroupIndex, this.pendingItemIndex);
						this._helperLocation.length = 0;
					}
					else
					{
						this._helperLocation.length = 1;
						this._helperLocation[0] = this._selectedGroupIndex;
						pendingData = this._dataProvider.getItemAt(this.pendingGroupIndex);
						this._helperLocation.length = 0;
					}
				}
				if(pendingData is Object)
				{
					var point:Point = Pool.getPoint();
					this.dataViewPort.getScrollPositionForIndex(this.pendingGroupIndex, this.pendingItemIndex, point);
					this.pendingGroupIndex = -1;
					this.pendingItemIndex = -1;

					var targetHorizontalScrollPosition:Number = point.x;
					var targetVerticalScrollPosition:Number = point.y;
					Pool.putPoint(point);
					if(targetHorizontalScrollPosition < this._minHorizontalScrollPosition)
					{
						targetHorizontalScrollPosition = this._minHorizontalScrollPosition;
					}
					else if(targetHorizontalScrollPosition > this._maxHorizontalScrollPosition)
					{
						targetHorizontalScrollPosition = this._maxHorizontalScrollPosition;
					}
					if(targetVerticalScrollPosition < this._minVerticalScrollPosition)
					{
						targetVerticalScrollPosition = this._minVerticalScrollPosition;
					}
					else if(targetVerticalScrollPosition > this._maxVerticalScrollPosition)
					{
						targetVerticalScrollPosition = this._maxVerticalScrollPosition;
					}
					this.throwTo(targetHorizontalScrollPosition, targetVerticalScrollPosition, this.pendingScrollDuration);
				}
			}
			super.handlePendingScroll();
		}

		/**
		 * @private
		 */
		override protected function nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(!this._isSelectable)
			{
				//not selectable, but should scroll
				super.nativeStage_keyDownHandler(event);
				return;
			}
			if(event.isDefaultPrevented())
			{
				return;
			}
			if(!this._dataProvider)
			{
				return;
			}
			if(this._selectedGroupIndex != -1 && this._selectedItemIndex != -1 &&
				(event.keyCode == Keyboard.SPACE ||
				((event.keyLocation == 4 || DeviceCapabilities.simulateDPad) && event.keyCode == Keyboard.ENTER)))
			{
				this.dispatchEventWith(Event.TRIGGERED, false, this.selectedItem);
			}
			if(event.keyCode == Keyboard.HOME || event.keyCode == Keyboard.END ||
				event.keyCode == Keyboard.PAGE_UP || event.keyCode == Keyboard.PAGE_DOWN ||
				event.keyCode == Keyboard.UP || event.keyCode == Keyboard.DOWN ||
				event.keyCode == Keyboard.LEFT || event.keyCode == Keyboard.RIGHT)
			{
				this.dataViewPort.calculateNavigationDestination(this._selectedGroupIndex, this._selectedItemIndex, event.keyCode, this._helperLocation);
				var newGroupIndex:int = this._helperLocation[0];
				var newItemIndex:int = this._helperLocation[1];
				if(newGroupIndex == -1 || newItemIndex == -1)
				{
					this.setSelectedLocation(-1, -1);
				}
				else if(this._selectedGroupIndex != newGroupIndex || this._selectedItemIndex != newItemIndex)
				{
					event.preventDefault();
					this.setSelectedLocation(newGroupIndex, newItemIndex);
					var point:Point = Pool.getPoint();
					this.dataViewPort.getNearestScrollPositionForIndex(this._selectedGroupIndex, this.selectedItemIndex, point);
					this.scrollToPosition(point.x, point.y, this._keyScrollDuration);
					Pool.putPoint(point);
				}
			}
		}

		/**
		 * @private
		 */
		protected function dataProvider_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function dataProvider_resetHandler(event:Event):void
		{
			this.horizontalScrollPosition = 0;
			this.verticalScrollPosition = 0;

			//the entire data provider was replaced. select no item.
			this.setSelectedLocation(-1, -1);
		}

		/**
		 * @private
		 */
		protected function dataProvider_addItemHandler(event:Event, indices:Array):void
		{
			if(this._selectedGroupIndex == -1)
			{
				return;
			}
			var groupIndex:int = indices[0] as int;
			if(indices.length > 1) //adding an item to a group
			{
				var itemIndex:int = indices[1] as int;
				if(this._selectedGroupIndex == groupIndex && this._selectedItemIndex >= itemIndex)
				{
					//adding an item at an index that is less than or equal to
					//the item that is selected. need to update the selected
					//item index.
					this.setSelectedLocation(this._selectedGroupIndex, this._selectedItemIndex + 1);
				}
			}
			else //adding an entire group
			{
				//adding a group before the group that the selected item is in.
				//need to update the selected group index.
				this.setSelectedLocation(this._selectedGroupIndex + 1, this._selectedItemIndex);
			}
		}

		/**
		 * @private
		 */
		protected function dataProvider_removeAllHandler(event:Event):void
		{
			this.setSelectedLocation(-1, -1);
		}

		/**
		 * @private
		 */
		protected function dataProvider_removeItemHandler(event:Event, indices:Array):void
		{
			if(this._selectedGroupIndex == -1)
			{
				return;
			}
			var groupIndex:int = indices[0] as int;
			if(indices.length > 1) //removing an item from a group
			{
				var itemIndex:int = indices[1] as int;
				if(this._selectedGroupIndex == groupIndex)
				{
					if(this._selectedItemIndex == itemIndex)
					{
						//removing the item that was selected.
						//now, nothing will be selected.
						this.setSelectedLocation(-1, -1);
					}
					else if(this._selectedItemIndex > itemIndex)
					{
						//removing an item from the same group that appears
						//before the item that is selected. need to update the
						//selected item index.
						this.setSelectedLocation(this._selectedGroupIndex, this._selectedItemIndex - 1);
					}
				}
			}
			else //removing an entire group
			{
				if(this._selectedGroupIndex == groupIndex)
				{
					//removing the group that the selected item was in.
					//now, nothing will be selected.
					this.setSelectedLocation(-1, -1);
				}
				else if(this._selectedGroupIndex > groupIndex)
				{
					//removing a group before the group that the selected item
					//is in. need to update the selected group index.
					this.setSelectedLocation(this._selectedGroupIndex - 1, this._selectedItemIndex);
				}
			}
		}

		/**
		 * @private
		 */
		protected function dataProvider_replaceItemHandler(event:Event, indices:Array):void
		{
			if(this._selectedGroupIndex == -1)
			{
				return;
			}
			var groupIndex:int = indices[0] as int;
			if(indices.length > 1) //replacing an item from a group
			{
				var itemIndex:int = indices[1] as int;
				if(this._selectedGroupIndex == groupIndex && this._selectedItemIndex == itemIndex)
				{
					//replacing the selected item.
					//now, nothing will be selected.
					this.setSelectedLocation(-1, -1);
				}
			}
			else if(this._selectedGroupIndex == groupIndex) //replacing an entire group
			{
				//replacing the group with the selected item.
				//now, nothing will be selected.
				this.setSelectedLocation(-1, -1);
			}
		}

		/**
		 * @private
		 */
		protected function dataViewPort_changeHandler(event:Event):void
		{
			this.setSelectedLocation(this.dataViewPort.selectedGroupIndex, this.dataViewPort.selectedItemIndex);
		}

		/**
		 * @private
		 */
		private function layout_scrollHandler(event:Event, scrollOffset:Point):void
		{
			var layout:IVariableVirtualLayout = IVariableVirtualLayout(this._layout);
			if(!this.isScrolling || !layout.useVirtualLayout || !layout.hasVariableItemDimensions)
			{
				return;
			}

			var scrollOffsetX:Number = scrollOffset.x;
			this._startHorizontalScrollPosition += scrollOffsetX;
			this._horizontalScrollPosition += scrollOffsetX;
			if(this._horizontalAutoScrollTween)
			{
				this._targetHorizontalScrollPosition += scrollOffsetX;
				this.throwTo(this._targetHorizontalScrollPosition, NaN, this._horizontalAutoScrollTween.totalTime - this._horizontalAutoScrollTween.currentTime);
			}

			var scrollOffsetY:Number = scrollOffset.y;
			this._startVerticalScrollPosition += scrollOffsetY;
			this._verticalScrollPosition += scrollOffsetY;
			if(this._verticalAutoScrollTween)
			{
				this._targetVerticalScrollPosition += scrollOffsetY;
				this.throwTo(NaN, this._targetVerticalScrollPosition, this._verticalAutoScrollTween.totalTime - this._verticalAutoScrollTween.currentTime);
			}
		}
	}
}


================================================
FILE: source/feathers/controls/Header.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.ITextRenderer;
	import feathers.core.IValidating;
	import feathers.core.PropertyProxy;
	import feathers.events.FeathersEventType;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.VerticalAlign;
	import feathers.layout.ViewPortBounds;
	import feathers.skins.IStyleProvider;
	import feathers.system.DeviceCapabilities;
	import feathers.text.FontStylesSet;
	import feathers.utils.display.ScreenDensityScaleCalculator;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;

	import flash.display.Stage;
	import flash.display.StageDisplayState;
	import flash.events.FullScreenEvent;
	import flash.geom.Point;
	import flash.system.Capabilities;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.text.TextFormat;
	import starling.utils.Pool;

	/**
	 * A display object displayed behind the header's content.
	 *
	 * <p>In the following example, the header's background skin is set to
	 * a <code>Quad</code>:</p>
	 *
	 * <listing version="3.0">
	 * header.backgroundSkin = new Quad( 10, 10, 0xff0000 );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundDisabledSkin
	 */
	[Style(name="backgroundSkin",type="starling.display.DisplayObject")]

	/**
	 * A background to display when the header is disabled. If the property
	 * is <code>null</code>, the value of the <code>backgroundSkin</code>
	 * property will be used instead.
	 *
	 * <p>In the following example, the header's disabled background skin is
	 * set to a <code>Quad</code>:</p>
	 *
	 * <listing version="3.0">
	 * header.backgroundDisabledSkin = new Quad( 10, 10, 0x999999 );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundSkin
	 */
	[Style(name="backgroundDisabledSkin",type="starling.display.DisplayObject")]

	/**
	 * A style name to add to the header's title text renderer
	 * sub-component. Typically used by a theme to provide different styles
	 * to different headers.
	 *
	 * <p>In the following example, a custom title style name is passed to
	 * the header:</p>
	 *
	 * <listing version="3.0">
	 * header.customTitleStyleName = "my-custom-header-title";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( BitmapFontTextRenderer ).setFunctionForStyleName( "my-custom-header-title", setCustomHeaderTitleStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_TITLE
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #titleFactory
	 */
	[Style(name="customTitleStyleName",type="String")]

	/**
	 * The font styles used to display the title's text when the header is
	 * disabled.
	 *
	 * <p>In the following example, the disabled font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * header.disabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>titleFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:fontStyles
	 */
	[Style(name="disabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the title's text.
	 *
	 * <p>In the following example, the font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * header.fontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>titleFactory</code> to set more advanced styles.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:disabledFontStyles
	 */
	[Style(name="fontStyles",type="starling.text.TextFormat")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the header's padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * header.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, between the header's top edge and the
	 * header's content.
	 *
	 * <p>In the following example, the header's top padding is set to 20
	 * pixels:</p>
	 *
	 * <listing version="3.0">
	 * header.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the header's right edge and the
	 * header's content.
	 *
	 * <p>In the following example, the header's right padding is set to 20
	 * pixels:</p>
	 *
	 * <listing version="3.0">
	 * header.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the header's bottom edge and
	 * the header's content.
	 *
	 * <p>In the following example, the header's bottom padding is set to 20
	 * pixels:</p>
	 *
	 * <listing version="3.0">
	 * header.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the header's left edge and the
	 * header's content.
	 *
	 * <p>In the following example, the header's left padding is set to 20
	 * pixels:</p>
	 *
	 * <listing version="3.0">
	 * header.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * Space, in pixels, between items. The same value is used with the
	 * <code>leftItems</code> and <code>rightItems</code>.
	 *
	 * <p>Set the <code>titleGap</code> to make the gap on the left and
	 * right of the title use a different value.</p>
	 *
	 * <p>In the following example, the header's gap between items is set to
	 * 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * header.gap = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:titleGap
	 * @see #leftItems
	 * @see #rightItems
	 * @see #centerItems
	 */
	[Style(name="gap",type="Number")]

	/**
	 * The preferred horizontal position of the title.
	 *
	 * <p>If <code>titleAlign</code> is set to
	 * <code>HorizontalAlign.LEFT</code>, but <code>leftItems</code> is not
	 * empty, the title will be positioned slightly to the right of the
	 * left items. If <code>centerItems</code> is also not empty, the title
	 * will not be displayed.</p>
	 *
	 * <p>If <code>titleAlign</code> is set to
	 * <code>HorizontalAlign.RIGHT</code>, but <code>rightItems</code> is
	 * not empty, the title will be positioned slightly to the left of the
	 * right items. If <code>centerItems</code> is also not empty, the title
	 * will not be displayed.</p>
	 *
	 * <p>If <code>titleAlign</code> is set to
	 * <code>HorizontalAlign.CENTER</code>, but <code>centerItems</code> is
	 * not <code>null</code>, the title will not be displayed.</p>
	 *
	 * <p>In the following example, the header's title alignment is set to
	 * prefer the left side:</p>
	 *
	 * <listing version="3.0">
	 * header.titleAlign = HorizontalAlign.LEFT;</listing>
	 *
	 * @default feathers.layout.HorizontalAlign.CENTER
	 *
	 * @see feathers.layout.HorizontalAlign#CENTER
	 * @see feathers.layout.HorizontalAlign#LEFT
	 * @see feathers.layout.HorizontalAlign#RIGHT
	 */
	[Style(name="titleAlign",type="String")]

	/**
	 * Space, in pixels, between the title and the left or right groups of
	 * items. If <code>NaN</code> (the default), the default <code>gap</code>
	 * property is used instead.
	 *
	 * <p>In the following example, the header's title gap is set to 20
	 * pixels:</p>
	 *
	 * <listing version="3.0">
	 * header.titleGap = 20;</listing>
	 *
	 * @default NaN
	 *
	 * @see #style:gap
	 */
	[Style(name="titleGap",type="Number")]

	/**
	 * If enabled, the header's top padding will be increased to account for
	 * the height of the OS status bar when the app is rendered under the OS
	 * status bar. The header will not add extra padding to apps that aren't
	 * rendered under the OS status bar.
	 *
	 * <p>iOS started rendering apps that aren't full screen under the OS
	 * status bar in version 7.</p>
	 *
	 * <p>In the following example, the header's padding will account for
	 * the iOS status bar height:</p>
	 *
	 * <listing version="3.0">
	 * header.useExtraPaddingForOSStatusBar = true;</listing>
	 *
	 * @default false;
	 *
	 * @see #style:paddingTop
	 */
	[Style(name="useExtraPaddingForOSStatusBar",type="Boolean")]

	/**
	 * The alignment of the items vertically, on the y-axis.
	 *
	 * <p>In the following example, the header's vertical alignment is set
	 * to the middle:</p>
	 *
	 * <listing version="3.0">
	 * header.verticalAlign = VerticalAlign.MIDDLE;</listing>
	 *
	 * @default feathers.layout.VerticalAlign.MIDDLE
	 *
	 * @see feathers.layout.VerticalAlign#TOP
	 * @see feathers.layout.VerticalAlign#MIDDLE
	 * @see feathers.layout.VerticalAlign#BOTTOM
	 */
	[Style(name="verticalAlign",type="String")]

	/**
	 * Determines if the text wraps to the next line when it reaches the
	 * width (or max width) of the component.
	 *
	 * <p>In the following example, the header's title is wrapped:</p>
	 *
	 * <listing version="3.0">
	 * header.wordWrap = true;</listing>
	 *
	 * @default false
	 */
	[Style(name="wordWrap",type="Boolean")]

	/**
	 * A header that displays an optional title along with a horizontal regions
	 * on the sides for additional UI controls. The left side is typically for
	 * navigation (to display a back button, for example) and the right for
	 * additional actions. The title is displayed in the center by default,
	 * but it may be aligned to the left or right if there are no items on the
	 * desired side.
	 *
	 * <p>In the following example, a header is created, given a title, and a
	 * back button:</p>
	 *
	 * <listing version="3.0">
	 * var header:Header = new Header();
	 * header.title = "I'm a header";
	 * 
	 * var backButton:Button = new Button();
	 * backButton.label = "Back";
	 * backButton.styleNameList.add( Button.ALTERNATE_STYLE_NAME_BACK_BUTTON );
	 * backButton.addEventListener( Event.TRIGGERED, backButton_triggeredHandler );
	 * header.leftItems = new &lt;DisplayObject&gt;[ backButton ];
	 * 
	 * this.addChild( header );</listing>
	 *
	 * @see ../../../help/header.html How to use the Feathers Header component
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class Header extends FeathersControl
	{
		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_LEFT_CONTENT:String = "leftContent";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_RIGHT_CONTENT:String = "rightContent";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_CENTER_CONTENT:String = "centerContent";

		/**
		 * @private
		 */
		protected static const IOS_STATUS_BAR_HEIGHT:Number = 20;

		/**
		 * @private
		 */
		protected static const IOS_NOTCH_STATUS_BAR_HEIGHT:Number = 44;

		/**
		 * @private
		 */
		protected static var iOSStatusBarScaledHeight:Number;

		/**
		 * @private
		 */
		protected static const IOS_NAME_PREFIX:String = "iOS ";

		/**
		 * @private
		 */
		protected static const OLD_IOS_NAME_PREFIX:String = "iPhone OS ";

		/**
		 * @private
		 */
		protected static const STATUS_BAR_MIN_IOS_VERSION:int = 7;

		/**
		 * The default <code>IStyleProvider</code> for all <code>Header</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * The default value added to the <code>styleNameList</code> of the header's
		 * items.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ITEM:String = "feathers-header-item";

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * header's title text renderer.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 * @see ../../../help/text-renderers.html Introduction to Feathers text renderers
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_TITLE:String = "feathers-header-title";

		/**
		 * @private
		 */
		private static const HELPER_BOUNDS:ViewPortBounds = new ViewPortBounds();

		/**
		 * @private
		 */
		private static const HELPER_LAYOUT_RESULT:LayoutBoundsResult = new LayoutBoundsResult();

		/**
		 * Constructor.
		 */
		public function Header()
		{
			super();
			if(this._fontStylesSet === null)
			{
				this._fontStylesSet = new FontStylesSet();
				this._fontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
			this.addEventListener(Event.ADDED_TO_STAGE, header_addedToStageHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, header_removedFromStageHandler);
		}

		/**
		 * The text renderer for the header's title.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #title
		 * @see #titleFactory
		 * @see #createTitle()
		 */
		protected var titleTextRenderer:ITextRenderer;

		/**
		 * The value added to the <code>styleNameList</code> of the header's
		 * title text renderer. This variable is <code>protected</code> so that
		 * sub-classes can customize the title text renderer style name in their
		 * constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_TITLE</code>.
		 *
		 * <p>To customize the title text renderer style name without
		 * subclassing, see <code>customTitleStyleName</code>.</p>
		 *
		 * @see #style:customTitleStyleName
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var titleStyleName:String = DEFAULT_CHILD_STYLE_NAME_TITLE;

		/**
		 * The value added to the <code>styleNameList</code> of each of the
		 * header's items. This variable is <code>protected</code> so that
		 * sub-classes can customize the item style name in their constructors
		 * instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_ITEM</code>.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var itemStyleName:String = DEFAULT_CHILD_STYLE_NAME_ITEM;

		/**
		 * @private
		 */
		protected var leftItemsWidth:Number = 0;

		/**
		 * @private
		 */
		protected var rightItemsWidth:Number = 0;

		/**
		 * @private
		 * The layout algorithm. Shared by both sides.
		 */
		protected var _layout:HorizontalLayout;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return Header.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _title:String = null;

		/**
		 * The text displayed for the header's title.
		 *
		 * <p>In the following example, the header's title is set:</p>
		 *
		 * <listing version="3.0">
		 * header.title = "I'm a Header";</listing>
		 *
		 * @default ""
		 *
		 * @see #titleFactory
		 */
		public function get title():String
		{
			return this._title;
		}

		/**
		 * @private
		 */
		public function set title(value:String):void
		{
			if(this._title === value)
			{
				return;
			}
			this._title = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _titleFactory:Function;

		/**
		 * A function used to instantiate the header's title text renderer
		 * sub-component. By default, the header will use the global text
		 * renderer factory, <code>FeathersControl.defaultTextRendererFactory()</code>,
		 * to create the title text renderer. The title text renderer must be an
		 * instance of <code>ITextRenderer</code>. This factory can be used to
		 * change properties on the title text renderer when it is first
		 * created. For instance, if you are skinning Feathers components
		 * without a theme, you might use this factory to style the title text
		 * renderer.
		 *
		 * <p>If you are not using a theme, the title factory can be used to
		 * provide skin the title with appropriate text styles.</p>
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():ITextRenderer</pre>
		 *
		 * <p>In the following example, a custom title factory is passed to the
		 * header:</p>
		 *
		 * <listing version="3.0">
		 * header.titleFactory = function():ITextRenderer
		 * {
		 *     var titleRenderer:TextFieldTextRenderer = new TextFieldTextRenderer();
		 *     titleRenderer.textFormat = new TextFormat( "_sans", 12, 0xff0000 );
		 *     return titleRenderer;
		 * }</listing>
		 *
		 * @default null
		 *
		 * @see #title
		 * @see feathers.core.ITextRenderer
		 * @see feathers.core.FeathersControl#defaultTextRendererFactory
		 */
		public function get titleFactory():Function
		{
			return this._titleFactory;
		}

		/**
		 * @private
		 */
		public function set titleFactory(value:Function):void
		{
			if(this._titleFactory == value)
			{
				return;
			}
			this._titleFactory = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _disposeItems:Boolean = true;

		/**
		 * Determines if the <code>leftItems</code>, <code>centerItems</code>,
		 * and <code>rightItems</code> are disposed or not when the header is
		 * disposed.
		 *
		 * <p>If you change this value to <code>false</code>, you must dispose
		 * the items manually. Failing to dispose the items may result in a
		 * memory leak.</p>
		 *
		 * @default true
		 */
		public function get disposeItems():Boolean
		{
			return this._disposeItems;
		}

		/**
		 * @private
		 */
		public function set disposeItems(value:Boolean):void
		{
			this._disposeItems = value;
		}

		/**
		 * @private
		 */
		protected var _ignoreItemResizing:Boolean = false;

		/**
		 * @private
		 */
		protected var _leftItems:Vector.<DisplayObject>;

		/**
		 * The UI controls that appear in the left region of the header.
		 *
		 * <p>If <code>leftItems</code> is not empty, and
		 * <code>titleAlign</code> is <code>HorizontalAlign.LEFT</code>, the
		 * title text renderer will appear to the right of the left items.</p>
		 *
		 * <p>In the following example, a back button is displayed on the left
		 * side of the header:</p>
		 *
		 * <listing version="3.0">
		 * var backButton:Button = new Button();
		 * backButton.label = "Back";
		 * backButton.styleNameList.add( Button.ALTERNATE_STYLE_NAME_BACK_BUTTON );
		 * backButton.addEventListener( Event.TRIGGERED, backButton_triggeredHandler );
		 * header.leftItems = new &lt;DisplayObject&gt;[ backButton ];</listing>
		 *
		 * @default null
		 */
		public function get leftItems():Vector.<DisplayObject>
		{
			return this._leftItems;
		}

		/**
		 * @private
		 */
		public function set leftItems(value:Vector.<DisplayObject>):void
		{
			if(this._leftItems == value)
			{
				return;
			}
			if(this._leftItems)
			{
				for each(var item:DisplayObject in this._leftItems)
				{
					if(item is IFeathersControl)
					{
						IFeathersControl(item).styleNameList.remove(this.itemStyleName);
						item.removeEventListener(FeathersEventType.RESIZE, item_resizeHandler);
					}
					item.removeFromParent();
				}
			}
			this._leftItems = value;
			if(this._leftItems)
			{
				for each(item in this._leftItems)
				{
					if(item is IFeathersControl)
					{
						item.addEventListener(FeathersEventType.RESIZE, item_resizeHandler);
					}
				}
			}
			this.invalidate(INVALIDATION_FLAG_LEFT_CONTENT);
		}

		/**
		 * @private
		 */
		protected var _centerItems:Vector.<DisplayObject>;

		/**
		 * The UI controls that appear in the center region of the header. If
		 * <code>centerItems</code> is not empty, and <code>titleAlign</code>
		 * is <code>HorizontalAlign.CENTER</code>, the title text renderer will
		 * be hidden.
		 *
		 * <p>In the following example, a settings button is displayed in the
		 * center of the header:</p>
		 *
		 * <listing version="3.0">
		 * var settingsButton:Button = new Button();
		 * settingsButton.label = "Settings";
		 * settingsButton.addEventListener( Event.TRIGGERED, settingsButton_triggeredHandler );
		 * header.centerItems = new &lt;DisplayObject&gt;[ settingsButton ];</listing>
		 *
		 * @default null
		 */
		public function get centerItems():Vector.<DisplayObject>
		{
			return this._centerItems;
		}

		/**
		 * @private
		 */
		public function set centerItems(value:Vector.<DisplayObject>):void
		{
			if(this._centerItems == value)
			{
				return;
			}
			if(this._centerItems)
			{
				for each(var item:DisplayObject in this._centerItems)
				{
					if(item is IFeathersControl)
					{
						IFeathersControl(item).styleNameList.remove(this.itemStyleName);
						item.removeEventListener(FeathersEventType.RESIZE, item_resizeHandler);
					}
					item.removeFromParent();
				}
			}
			this._centerItems = value;
			if(this._centerItems)
			{
				for each(item in this._centerItems)
				{
					if(item is IFeathersControl)
					{
						item.addEventListener(FeathersEventType.RESIZE, item_resizeHandler);
					}
				}
			}
			this.invalidate(INVALIDATION_FLAG_CENTER_CONTENT);
		}

		/**
		 * @private
		 */
		protected var _rightItems:Vector.<DisplayObject>;

		/**
		 * The UI controls that appear in the right region of the header.
		 *
		 * <p>If <code>rightItems</code> is not empty, and
		 * <code>titleAlign</code> is <code>HorizontalAlign.RIGHT</code>, the
		 * title text renderer will appear to the left of the right items.</p>
		 *
		 * <p>In the following example, a settings button is displayed on the
		 * right side of the header:</p>
		 *
		 * <listing version="3.0">
		 * var settingsButton:Button = new Button();
		 * settingsButton.label = "Settings";
		 * settingsButton.addEventListener( Event.TRIGGERED, settingsButton_triggeredHandler );
		 * header.rightItems = new &lt;DisplayObject&gt;[ settingsButton ];</listing>
		 *
		 * @default null
		 */
		public function get rightItems():Vector.<DisplayObject>
		{
			return this._rightItems;
		}

		/**
		 * @private
		 */
		public function set rightItems(value:Vector.<DisplayObject>):void
		{
			if(this._rightItems == value)
			{
				return;
			}
			if(this._rightItems)
			{
				for each(var item:DisplayObject in this._rightItems)
				{
					if(item is IFeathersControl)
					{
						IFeathersControl(item).styleNameList.remove(this.itemStyleName);
						item.removeEventListener(FeathersEventType.RESIZE, item_resizeHandler);
					}
					item.removeFromParent();
				}
			}
			this._rightItems = value;
			if(this._rightItems)
			{
				for each(item in this._rightItems)
				{
					if(item is IFeathersControl)
					{
						item.addEventListener(FeathersEventType.RESIZE, item_resizeHandler);
					}
				}
			}
			this.invalidate(INVALIDATION_FLAG_RIGHT_CONTENT);
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _gap:Number = 0;

		/**
		 * @private
		 */
		public function get gap():Number
		{
			return _gap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._gap == value)
			{
				return;
			}
			this._gap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _titleGap:Number = NaN;

		/**
		 * @private
		 */
		public function get titleGap():Number
		{
			return _titleGap;
		}

		/**
		 * @private
		 */
		public function set titleGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._titleGap == value)
			{
				return;
			}
			this._titleGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _useExtraPaddingForOSStatusBar:Boolean = false;

		/**
		 * @private
		 */
		public function get useExtraPaddingForOSStatusBar():Boolean
		{
			return this._useExtraPaddingForOSStatusBar;
		}

		/**
		 * @private
		 */
		public function set useExtraPaddingForOSStatusBar(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._useExtraPaddingForOSStatusBar === value)
			{
				return;
			}
			this._useExtraPaddingForOSStatusBar = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.MIDDLE;

		[Inspectable(type="String",enumeration="top,middle,bottom")]
		/**
		 * @private
		 */
		public function get verticalAlign():String
		{
			return this._verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._verticalAlign === value)
			{
				return;
			}
			this._verticalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var currentBackgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		protected var _explicitBackgroundWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxHeight:Number;

		/**
		 * @private
		 */
		protected var _backgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundSkin():DisplayObject
		{
			return this._backgroundSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundSkin === value)
			{
				return;
			}
			if(this._backgroundSkin !== null &&
				this.currentBackgroundSkin === this._backgroundSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _backgroundDisabledSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundDisabledSkin():DisplayObject
		{
			return this._backgroundDisabledSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundDisabledSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundDisabledSkin === value)
			{
				return;
			}
			if(this._backgroundDisabledSkin !== null &&
				this.currentBackgroundSkin === this._backgroundDisabledSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundDisabledSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundDisabledSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _fontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get fontStyles():TextFormat
		{
			return this._fontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set fontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get disabledFontStyles():TextFormat
		{
			return this._fontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set disabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _wordWrap:Boolean = false;

		/**
		 * @private
		 */
		public function get wordWrap():Boolean
		{
			return this._wordWrap;
		}

		/**
		 * @private
		 */
		public function set wordWrap(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._wordWrap === value)
			{
				return;
			}
			this._wordWrap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _customTitleStyleName:String;

		/**
		 * @private
		 */
		public function get customTitleStyleName():String
		{
			return this._customTitleStyleName;
		}

		/**
		 * @private
		 */
		public function set customTitleStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customTitleStyleName === value)
			{
				return;
			}
			this._customTitleStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _titleProperties:PropertyProxy;

		/**
		 * An object that stores properties for the header's title text renderer
		 * sub-component, and the properties will be passed down to the text
		 * renderer when the header validates. The available properties
		 * depend on which <code>ITextRenderer</code> implementation is returned
		 * by <code>textRendererFactory</code>. Refer to
		 * <a href="../core/ITextRenderer.html"><code>feathers.core.ITextRenderer</code></a>
		 * for a list of available text renderer implementations.
		 *
		 * <p>In the following example, some properties are set for the header's
		 * title text renderer (this example assumes that the title text renderer
		 * is a <code>BitmapFontTextRenderer</code>):</p>
		 *
		 * <listing version="3.0">
		 * header.titleProperties.textFormat = new BitmapFontTextFormat( bitmapFont );
		 * header.titleProperties.wordWrap = true;</listing>
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>titleFactory</code> function instead
		 * of using <code>titleProperties</code> will result in better
		 * performance.</p>
		 *
		 * @default null
		 *
		 * @see #titleFactory
		 * @see feathers.core.ITextRenderer
		 */
		public function get titleProperties():Object
		{
			if(!this._titleProperties)
			{
				this._titleProperties = new PropertyProxy(titleProperties_onChange);
			}
			return this._titleProperties;
		}

		/**
		 * @private
		 */
		public function set titleProperties(value:Object):void
		{
			if(this._titleProperties == value)
			{
				return;
			}
			if(value && !(value is PropertyProxy))
			{
				value = PropertyProxy.fromObject(value);
			}
			if(this._titleProperties)
			{
				this._titleProperties.removeOnChangeCallback(titleProperties_onChange);
			}
			this._titleProperties = PropertyProxy(value);
			if(this._titleProperties)
			{
				this._titleProperties.addOnChangeCallback(titleProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _titleAlign:String = HorizontalAlign.CENTER;

		[Inspectable(type="String",enumeration="center,left,right")]
		/**
		 * @private
		 */
		public function get titleAlign():String
		{
			return this._titleAlign;
		}

		/**
		 * @private
		 */
		public function set titleAlign(value:String):void
		{
			if(value === "preferLeft")
			{
				value = HorizontalAlign.LEFT;
			}
			else if(value === "preferRight")
			{
				value = HorizontalAlign.RIGHT;
			}
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._titleAlign === value)
			{
				return;
			}
			this._titleAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * The number of text lines displayed by the header. The component may
		 * contain multiple text lines if the text contains line breaks or if
		 * the <code>wordWrap</code> property is enabled.
		 *
		 * @see #wordWrap
		 */
		public function get numLines():int
		{
			if(this.titleTextRenderer === null)
			{
				return 0;
			}
			return this.titleTextRenderer.numLines;
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			//we don't dispose it if the header is the parent because it'll
			//already get disposed in super.dispose()
			if(this._backgroundSkin !== null &&
				this._backgroundSkin.parent !== this)
			{
				this._backgroundSkin.dispose();
			}
			if(this._backgroundDisabledSkin !== null &&
				this._backgroundDisabledSkin.parent !== this)
			{
				this._backgroundDisabledSkin.dispose();
			}
			if(this._disposeItems)
			{
				for each(var item:DisplayObject in this._leftItems)
				{
					item.dispose();
				}
				for each(item in this._centerItems)
				{
					item.dispose();
				}
				for each(item in this._rightItems)
				{
					item.dispose();
				}
			}
			this.leftItems = null;
			this.rightItems = null;
			this.centerItems = null;
			if(this._fontStylesSet !== null)
			{
				this._fontStylesSet.dispose();
				this._fontStylesSet = null;
			}
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(this._layout === null)
			{
				var layout:HorizontalLayout = new HorizontalLayout();
				layout.useVirtualLayout = false;
				layout.verticalAlign = VerticalAlign.MIDDLE;
				this._layout = layout;
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var leftContentInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LEFT_CONTENT);
			var rightContentInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_RIGHT_CONTENT);
			var centerContentInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_CENTER_CONTENT);
			var textRendererInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_TEXT_RENDERER);

			if(textRendererInvalid)
			{
				this.createTitle();
			}

			if(textRendererInvalid || dataInvalid)
			{
				this.titleTextRenderer.text = this._title;
			}

			if(stateInvalid || stylesInvalid)
			{
				this.refreshBackground();
			}

			if(textRendererInvalid || stylesInvalid || sizeInvalid)
			{
				this.refreshLayout();
			}
			if(textRendererInvalid || stylesInvalid)
			{
				this.refreshTitleStyles();
			}

			var oldIgnoreItemResizing:Boolean = this._ignoreItemResizing;
			this._ignoreItemResizing = true;
			if(leftContentInvalid)
			{
				if(this._leftItems)
				{
					for each(var item:DisplayObject in this._leftItems)
					{
						if(item is IFeathersControl)
						{
							IFeathersControl(item).styleNameList.add(this.itemStyleName);
						}
						this.addChild(item);
					}
				}
			}

			if(rightContentInvalid)
			{
				if(this._rightItems)
				{
					for each(item in this._rightItems)
					{
						if(item is IFeathersControl)
						{
							IFeathersControl(item).styleNameList.add(this.itemStyleName);
						}
						this.addChild(item);
					}
				}
			}

			if(centerContentInvalid)
			{
				if(this._centerItems)
				{
					for each(item in this._centerItems)
					{
						if(item is IFeathersControl)
						{
							IFeathersControl(item).styleNameList.add(this.itemStyleName);
						}
						this.addChild(item);
					}
				}
			}
			this._ignoreItemResizing = oldIgnoreItemResizing;

			if(stateInvalid || textRendererInvalid)
			{
				this.refreshEnabled();
			}

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			this.layoutBackground();

			if(sizeInvalid || leftContentInvalid || rightContentInvalid || centerContentInvalid || stylesInvalid)
			{
				this.leftItemsWidth = 0;
				this.rightItemsWidth = 0;
				if(this._leftItems)
				{
					this.layoutLeftItems();
				}
				if(this._rightItems)
				{
					this.layoutRightItems();
				}
				if(this._centerItems)
				{
					this.layoutCenterItems();
				}
			}

			if(textRendererInvalid || sizeInvalid || stylesInvalid || dataInvalid || leftContentInvalid || rightContentInvalid || centerContentInvalid)
			{
				this.layoutTitle();
			}

		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			resetFluidChildDimensionsForMeasurement(this.currentBackgroundSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitBackgroundWidth, this._explicitBackgroundHeight,
				this._explicitBackgroundMinWidth, this._explicitBackgroundMinHeight,
				this._explicitBackgroundMaxWidth, this._explicitBackgroundMaxHeight);
			var measureSkin:IMeasureDisplayObject = this.currentBackgroundSkin as IMeasureDisplayObject;
			if(this.currentBackgroundSkin is IValidating)
			{
				IValidating(this.currentBackgroundSkin).validate();
			}

			var extraPaddingTop:Number = this.calculateExtraOSStatusBarPadding();

			var totalContentWidth:Number = 0;
			var maxContentHeight:Number = 0;
			var hasLeftItems:Boolean = this._leftItems !== null && this._leftItems.length > 0;
			var hasRightItems:Boolean = this._rightItems !== null && this._rightItems.length > 0;
			var hasCenterItems:Boolean = this._centerItems !== null && this._centerItems.length > 0;
			var oldIgnoreItemResizing:Boolean = this._ignoreItemResizing;
			this._ignoreItemResizing = true;
			if(hasLeftItems)
			{
				var itemCount:int = this._leftItems.length;
				for(var i:int = 0; i < itemCount; i++)
				{
					var item:DisplayObject = this._leftItems[i];
					if(item is IValidating)
					{
						IValidating(item).validate();
					}
					var itemWidth:Number = item.width;
					if(itemWidth === itemWidth) //!isNaN
					{
						totalContentWidth += itemWidth;
						if(i > 0)
						{
							totalContentWidth += this._gap;
						}
					}
					var itemHeight:Number = item.height;
					if(itemHeight === itemHeight && //!isNaN
						itemHeight > maxContentHeight)
					{
						maxContentHeight = itemHeight;
					}
				}
			}
			if(hasCenterItems)
			{
				itemCount = this._centerItems.length;
				for(i = 0; i < itemCount; i++)
				{
					item = this._centerItems[i];
					if(item is IValidating)
					{
						IValidating(item).validate();
					}
					itemWidth = item.width;
					if(itemWidth === itemWidth) //!isNaN
					{
						totalContentWidth += itemWidth;
						if(i > 0)
						{
							totalContentWidth += this._gap;
						}
					}
					itemHeight = item.height;
					if(itemHeight === itemHeight && //!isNaN
						itemHeight > maxContentHeight)
					{
						maxContentHeight = itemHeight;
					}
				}
			}
			if(hasRightItems)
			{
				itemCount = this._rightItems.length;
				for(i = 0; i < itemCount; i++)
				{
					item = this._rightItems[i];
					if(item is IValidating)
					{
						IValidating(item).validate();
					}
					itemWidth = item.width;
					if(itemWidth === itemWidth) //!isNaN
					{
						totalContentWidth += itemWidth;
						if(i > 0)
						{
							totalContentWidth += this._gap;
						}
					}
					itemHeight = item.height;
					if(itemHeight === itemHeight && //!isNaN
						itemHeight > maxContentHeight)
					{
						maxContentHeight = itemHeight;
					}
				}
			}
			this._ignoreItemResizing = oldIgnoreItemResizing;

			if(this._titleAlign === HorizontalAlign.CENTER && hasCenterItems)
			{
				if(hasLeftItems)
				{
					totalContentWidth += this._gap;
				}
				if(hasRightItems)
				{
					totalContentWidth += this._gap;
				}
			}
			else if(this._title !== null)
			{
				var calculatedTitleGap:Number = this._titleGap;
				if(calculatedTitleGap !== calculatedTitleGap) //isNaN
				{
					calculatedTitleGap = this._gap;
				}
				var maxTitleWidth:Number = this._explicitWidth;
				if(needsWidth)
				{
					maxTitleWidth = this._explicitMaxWidth;
				}
				maxTitleWidth -= totalContentWidth;
				if(hasLeftItems)
				{
					maxTitleWidth -= calculatedTitleGap;
				}
				if(hasCenterItems)
				{
					maxTitleWidth -= calculatedTitleGap;
				}
				if(hasRightItems)
				{
					maxTitleWidth -= calculatedTitleGap;
				}
				if(maxTitleWidth < 0)
				{
					maxTitleWidth = 0;
				}
				this.titleTextRenderer.maxWidth = maxTitleWidth;
				var point:Point = Pool.getPoint();
				this.titleTextRenderer.measureText(point);
				var measuredTitleWidth:Number = point.x;
				var measuredTitleHeight:Number = point.y;
				Pool.putPoint(point);
				if(measuredTitleWidth === measuredTitleWidth) //!isNaN
				{
					if(hasLeftItems)
					{
						measuredTitleWidth += calculatedTitleGap;
					}
					if(hasRightItems)
					{
						measuredTitleWidth += calculatedTitleGap;
					}
				}
				else
				{
					measuredTitleWidth = 0;
				}
				totalContentWidth += measuredTitleWidth;
				if(measuredTitleHeight === measuredTitleHeight && //!isNaN
					measuredTitleHeight > maxContentHeight)
				{
					maxContentHeight = measuredTitleHeight;
				}
			}

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				newWidth = totalContentWidth + this._paddingLeft + this._paddingRight;
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.width > newWidth)
				{
					newWidth = this.currentBackgroundSkin.width;
				}
			}

			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				newHeight = maxContentHeight;
				newHeight += this._paddingTop + this._paddingBottom;
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.height > newHeight)
				{
					newHeight = this.currentBackgroundSkin.height;
				}
				//normally, padding is included before before the background
				//skin's dimensions, but this is special extra padding that
				//should simply be added on top of the normal measurement. if
				//the explicit height of the background is large enough, this
				//extra padding could be swallowed instead.
				if(extraPaddingTop > 0)
				{
					//account for the minimum height before adding the padding
					if(newHeight < this._explicitMinHeight)
					{
						newHeight = this._explicitMinHeight;
					}
					newHeight += extraPaddingTop;
				}
			}

			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				newMinWidth = totalContentWidth + this._paddingLeft + this._paddingRight;
				if(this.currentBackgroundSkin !== null)
				{
					if(measureSkin !== null)
					{
						if(measureSkin.minWidth > newMinWidth)
						{
							newMinWidth = measureSkin.minWidth;
						}
					}
					else if(this._explicitBackgroundMinWidth > newMinWidth)
					{
						newMinWidth = this._explicitBackgroundMinWidth;
					}
				}
			}

			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				newMinHeight = maxContentHeight;
				newMinHeight += this._paddingTop + this._paddingBottom;
				if(this.currentBackgroundSkin !== null)
				{
					if(measureSkin !== null)
					{
						if(measureSkin.minHeight > newMinHeight)
						{
							newMinHeight = measureSkin.minHeight;
						}
					}
					else if(this._explicitBackgroundMinHeight > newMinHeight)
					{
						newMinHeight = this._explicitBackgroundMinHeight;
					}
				}
				//set note above about why the extra padding is included after
				//the background skin
				if(extraPaddingTop > 0)
				{
					newMinHeight += extraPaddingTop;
				}
			}

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * Creates and adds the <code>titleTextRenderer</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #title
		 * @see #titleTextRenderer
		 * @see #titleFactory
		 */
		protected function createTitle():void
		{
			if(this.titleTextRenderer)
			{
				this.removeChild(DisplayObject(this.titleTextRenderer), true);
				this.titleTextRenderer = null;
			}

			var factory:Function = this._titleFactory != null ? this._titleFactory : FeathersControl.defaultTextRendererFactory;
			this.titleTextRenderer = ITextRenderer(factory());
			var uiTitleRenderer:IFeathersControl = IFeathersControl(this.titleTextRenderer);
			var titleStyleName:String = this._customTitleStyleName != null ? this._customTitleStyleName : this.titleStyleName;
			uiTitleRenderer.styleNameList.add(titleStyleName);
			this.addChild(DisplayObject(uiTitleRenderer));
		}

		/**
		 * @private
		 */
		protected function refreshBackground():void
		{
			var oldBackgroundSkin:DisplayObject = this.currentBackgroundSkin;
			this.currentBackgroundSkin = this._backgroundSkin;
			if(!this._isEnabled && this._backgroundDisabledSkin !== null)
			{
				this.currentBackgroundSkin = this._backgroundDisabledSkin;
			}
			if(this.currentBackgroundSkin !== oldBackgroundSkin)
			{
				this.removeCurrentBackgroundSkin(oldBackgroundSkin);
				if(this.currentBackgroundSkin !== null)
				{
					if(this.currentBackgroundSkin is IFeathersControl)
					{
						IFeathersControl(this.currentBackgroundSkin).initializeNow();
					}
					if(this.currentBackgroundSkin is IMeasureDisplayObject)
					{
						var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this.currentBackgroundSkin);
						this._explicitBackgroundWidth = measureSkin.explicitWidth;
						this._explicitBackgroundHeight = measureSkin.explicitHeight;
						this._explicitBackgroundMinWidth = measureSkin.explicitMinWidth;
						this._explicitBackgroundMinHeight = measureSkin.explicitMinHeight;
						this._explicitBackgroundMaxWidth = measureSkin.explicitMaxWidth;
						this._explicitBackgroundMaxHeight = measureSkin.explicitMaxHeight;
					}
					else
					{
						this._explicitBackgroundWidth = this.currentBackgroundSkin.width;
						this._explicitBackgroundHeight = this.currentBackgroundSkin.height;
						this._explicitBackgroundMinWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMinHeight = this._explicitBackgroundHeight;
						this._explicitBackgroundMaxWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMaxHeight = this._explicitBackgroundHeight;
					}
					this.addChildAt(this.currentBackgroundSkin, 0);
				}
			}
		}

		/**
		 * @private
		 */
		protected function removeCurrentBackgroundSkin(skin:DisplayObject):void
		{
			if(skin === null)
			{
				return;
			}
			if(skin.parent === this)
			{
				//we need to restore these values so that they won't be lost the
				//next time that this skin is used for measurement
				skin.width = this._explicitBackgroundWidth;
				skin.height = this._explicitBackgroundHeight;
				if(skin is IMeasureDisplayObject)
				{
					var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(skin);
					measureSkin.minWidth = this._explicitBackgroundMinWidth;
					measureSkin.minHeight = this._explicitBackgroundMinHeight;
					measureSkin.maxWidth = this._explicitBackgroundMaxWidth;
					measureSkin.maxHeight = this._explicitBackgroundMaxHeight;
				}
				skin.removeFromParent(false);
			}
		}

		/**
		 * @private
		 */
		protected function refreshLayout():void
		{
			this._layout.gap = this._gap;
			this._layout.paddingTop = this._paddingTop + this.calculateExtraOSStatusBarPadding();
			this._layout.paddingBottom = this._paddingBottom;
			this._layout.verticalAlign = this._verticalAlign;
		}

		/**
		 * @private
		 */
		protected function refreshEnabled():void
		{
			this.titleTextRenderer.isEnabled = this._isEnabled;
		}

		/**
		 * @private
		 */
		protected function refreshTitleStyles():void
		{
			this.titleTextRenderer.fontStyles = this._fontStylesSet;
			this.titleTextRenderer.wordWrap = this._wordWrap;
			for(var propertyName:String in this._titleProperties)
			{
				var propertyValue:Object = this._titleProperties[propertyName];
				this.titleTextRenderer[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function calculateExtraOSStatusBarPadding():Number
		{
			if(!this._useExtraPaddingForOSStatusBar)
			{
				return 0;
			}
			//first, we check if it's iOS or not. at this time, we only need to
			//use extra padding on iOS. android and others are fine.
			var os:String = Capabilities.os;
			if(os.indexOf(IOS_NAME_PREFIX) != -1)
			{
				os = os.substring(IOS_NAME_PREFIX.length, os.indexOf("."));
			}
			else if(os.indexOf(OLD_IOS_NAME_PREFIX) != -1)
			{
				os = os.substring(OLD_IOS_NAME_PREFIX.length, os.indexOf("."));
			}
			else
			{
				return 0;
			}
			//then, we check the major version of iOS. the extra padding is not
			//required before version 7.
			//the version string will always contain major and minor values, so
			//search for the first . character.
			if(parseInt(os, 10) < STATUS_BAR_MIN_IOS_VERSION)
			{
				return 0;
			}
			//next, we check if the app is full screen or not. if it is full
			//screen, then the status bar isn't visible, and we don't need the
			//extra padding.
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var nativeStage:Stage = starling.nativeStage;
			if(nativeStage.displayState !== StageDisplayState.NORMAL)
			{
				return 0;
			}

			//this value only needs to be calculated once
			if(iOSStatusBarScaledHeight !== iOSStatusBarScaledHeight) //isNaN
			{
				//uses the same mechanism as ScreenDensityScaleFactorManager,
				//but uses different density values
				var scaleSelector:ScreenDensityScaleCalculator = new ScreenDensityScaleCalculator();
				scaleSelector.addScaleForDensity(168, 1); //original
				scaleSelector.addScaleForDensity(326, 2); //retina
				scaleSelector.addScaleForDensity(401, 3); //retina HD
				if(this.hasNotch())
				{
					iOSStatusBarScaledHeight = IOS_NOTCH_STATUS_BAR_HEIGHT * scaleSelector.getScale(DeviceCapabilities.dpi);
				}
				else
				{
					iOSStatusBarScaledHeight = IOS_STATUS_BAR_HEIGHT * scaleSelector.getScale(DeviceCapabilities.dpi);
				}
			}

			//while it probably won't change, contentScaleFactor shouldn't be
			//considered constant, so do this calculation every time
			return iOSStatusBarScaledHeight / starling.contentScaleFactor;
		}

		/**
		 * @private
		 */
		protected function hasNotch():Boolean
		{
			//this is not an ideal way to detect the status bar height
			//because future devices will need to be added to this list
			//manually!
			var osString:String = Capabilities.os;
			var notchIDs:Vector.<String> = new <String>[
				"iPhone10,3", //iPhone X
				"iPhone10,6", //iPhone X
				"iPhone11,2", //iPhone XS
				"iPhone11,4", //iPhone XS Max
				"iPhone11,6", //iPhone XS Max
				"iPhone11,8", //iPhone XR
			];
			var idCount:int = notchIDs.length;
			for(var i:int = 0; i < idCount; i++)
			{
				var id:String = notchIDs[i];
				var index:int = osString.lastIndexOf(id);
				if(index != -1 && index == osString.length - id.length)
				{
					return true;
				}
			}
			return false;
		}

		/**
		 * @private
		 */
		protected function layoutBackground():void
		{
			if(!this.currentBackgroundSkin)
			{
				return;
			}
			this.currentBackgroundSkin.width = this.actualWidth;
			this.currentBackgroundSkin.height = this.actualHeight;
		}

		/**
		 * @private
		 */
		protected function layoutLeftItems():void
		{
			for each(var item:DisplayObject in this._leftItems)
			{
				if(item is IValidating)
				{
					IValidating(item).validate();
				}
			}
			HELPER_BOUNDS.x = HELPER_BOUNDS.y = 0;
			HELPER_BOUNDS.scrollX = HELPER_BOUNDS.scrollY = 0;
			HELPER_BOUNDS.explicitWidth = this.actualWidth;
			HELPER_BOUNDS.explicitHeight = this.actualHeight;
			this._layout.horizontalAlign = HorizontalAlign.LEFT;
			this._layout.paddingRight = 0;
			this._layout.paddingLeft = this._paddingLeft;
			this._layout.layout(this._leftItems, HELPER_BOUNDS, HELPER_LAYOUT_RESULT);
			this.leftItemsWidth = HELPER_LAYOUT_RESULT.contentWidth;
			if(this.leftItemsWidth !== this.leftItemsWidth) //isNaN
			{
				this.leftItemsWidth = 0;
			}

		}

		/**
		 * @private
		 */
		protected function layoutRightItems():void
		{
			for each(var item:DisplayObject in this._rightItems)
			{
				if(item is IValidating)
				{
					IValidating(item).validate();
				}
			}
			HELPER_BOUNDS.x = HELPER_BOUNDS.y = 0;
			HELPER_BOUNDS.scrollX = HELPER_BOUNDS.scrollY = 0;
			HELPER_BOUNDS.explicitWidth = this.actualWidth;
			HELPER_BOUNDS.explicitHeight = this.actualHeight;
			this._layout.horizontalAlign = HorizontalAlign.RIGHT;
			this._layout.paddingRight = this._paddingRight;
			this._layout.paddingLeft = 0;
			this._layout.layout(this._rightItems, HELPER_BOUNDS, HELPER_LAYOUT_RESULT);
			this.rightItemsWidth = HELPER_LAYOUT_RESULT.contentWidth;
			if(this.rightItemsWidth !== this.rightItemsWidth) //isNaN
			{
				this.rightItemsWidth = 0;
			}
		}

		/**
		 * @private
		 */
		protected function layoutCenterItems():void
		{
			for each(var item:DisplayObject in this._centerItems)
			{
				if(item is IValidating)
				{
					IValidating(item).validate();
				}
			}
			HELPER_BOUNDS.x = HELPER_BOUNDS.y = 0;
			HELPER_BOUNDS.scrollX = HELPER_BOUNDS.scrollY = 0;
			HELPER_BOUNDS.explicitWidth = this.actualWidth;
			HELPER_BOUNDS.explicitHeight = this.actualHeight;
			this._layout.horizontalAlign = HorizontalAlign.CENTER;
			this._layout.paddingRight = this._paddingRight;
			this._layout.paddingLeft = this._paddingLeft;
			this._layout.layout(this._centerItems, HELPER_BOUNDS, HELPER_LAYOUT_RESULT);
		}

		/**
		 * @private
		 */
		protected function layoutTitle():void
		{
			var hasLeftItems:Boolean = this._leftItems !== null && this._leftItems.length > 0;
			var hasRightItems:Boolean = this._rightItems !== null && this._rightItems.length > 0;
			var hasCenterItems:Boolean = this._centerItems !== null && this._centerItems.length > 0;
			if(this._titleAlign === HorizontalAlign.CENTER && hasCenterItems)
			{
				this.titleTextRenderer.visible = false;
				return;
			}
			if(this._titleAlign === HorizontalAlign.LEFT && hasLeftItems && hasCenterItems)
			{
				this.titleTextRenderer.visible = false;
				return;
			}
			if(this._titleAlign === HorizontalAlign.RIGHT && hasRightItems && hasCenterItems)
			{
				this.titleTextRenderer.visible = false;
				return;
			}
			this.titleTextRenderer.visible = true;
			var calculatedTitleGap:Number = this._titleGap;
			if(calculatedTitleGap !== calculatedTitleGap) //isNaN
			{
				calculatedTitleGap = this._gap;
			}
			var leftOffset:Number = this._paddingLeft;
			if(hasLeftItems)
			{
				//leftItemsWidth already includes padding
				leftOffset = this.leftItemsWidth + calculatedTitleGap;
			}
			var rightOffset:Number = this._paddingRight;
			if(hasRightItems)
			{
				//rightItemsWidth already includes padding
				rightOffset = this.rightItemsWidth + calculatedTitleGap;
			}
			if(this._titleAlign === HorizontalAlign.LEFT)
			{
				var titleMaxWidth:Number = this.actualWidth - leftOffset - rightOffset;
				if(titleMaxWidth < 0)
				{
					titleMaxWidth = 0;
				}
				this.titleTextRenderer.maxWidth = titleMaxWidth;
				this.titleTextRenderer.validate();
				this.titleTextRenderer.x = leftOffset;
			}
			else if(this._titleAlign === HorizontalAlign.RIGHT)
			{
				titleMaxWidth = this.actualWidth - leftOffset - rightOffset;
				if(titleMaxWidth < 0)
				{
					titleMaxWidth = 0;
				}
				this.titleTextRenderer.maxWidth = titleMaxWidth;
				this.titleTextRenderer.validate();
				this.titleTextRenderer.x = this.actualWidth - this.titleTextRenderer.width - rightOffset;
			}
			else //center
			{
				var actualWidthMinusPadding:Number = this.actualWidth - this._paddingLeft - this._paddingRight;
				if(actualWidthMinusPadding < 0)
				{
					actualWidthMinusPadding = 0;
				}
				var actualWidthMinusOffsets:Number = this.actualWidth - leftOffset - rightOffset;
				if(actualWidthMinusOffsets < 0)
				{
					actualWidthMinusOffsets = 0;
				}
				this.titleTextRenderer.maxWidth = actualWidthMinusOffsets;
				this.titleTextRenderer.validate();
				//we try to keep the title centered between the paddings, if
				//possible. however, if the combined width of the left or right
				//items is too large to allow that, we center between the items.
				//this seems to match the behavior on iOS.
				var idealTitlePosition:Number = this._paddingLeft + Math.round((actualWidthMinusPadding - this.titleTextRenderer.width) / 2);
				if(leftOffset > idealTitlePosition ||
					(idealTitlePosition + this.titleTextRenderer.width) > (this.actualWidth - rightOffset))
				{
					this.titleTextRenderer.x = leftOffset + Math.round((actualWidthMinusOffsets - this.titleTextRenderer.width) / 2);
				}
				else
				{
					this.titleTextRenderer.x = idealTitlePosition;
				}
			}
			var paddingTop:Number = this._paddingTop + this.calculateExtraOSStatusBarPadding();
			switch(this._verticalAlign)
			{
				case VerticalAlign.TOP:
				{
					this.titleTextRenderer.y = paddingTop;
					break;
				}
				case VerticalAlign.BOTTOM:
				{
					this.titleTextRenderer.y = this.actualHeight - this._paddingBottom - this.titleTextRenderer.height;
					break;
				}
				default: //center
				{
					this.titleTextRenderer.y = paddingTop + Math.round((this.actualHeight - paddingTop - this._paddingBottom - this.titleTextRenderer.height) / 2);
					break;
				}
			}
		}

		/**
		 * @private
		 */
		protected function header_addedToStageHandler(event:Event):void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			starling.nativeStage.addEventListener("fullScreen", nativeStage_fullScreenHandler);
		}

		/**
		 * @private
		 */
		protected function header_removedFromStageHandler(event:Event):void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			starling.nativeStage.removeEventListener("fullScreen", nativeStage_fullScreenHandler);
		}

		/**
		 * @private
		 */
		protected function nativeStage_fullScreenHandler(event:FullScreenEvent):void
		{
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected function fontStyles_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function titleProperties_onChange(proxy:PropertyProxy, propertyName:String):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function item_resizeHandler(event:Event):void
		{
			if(this._ignoreItemResizing)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}
	}
}


================================================
FILE: source/feathers/controls/IDirectionalScrollBar.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * A scroll bar that supports both horizontal or vertical orientations. The
	 * <code>feathers.controls.Scroller</code> class (and all subclasses) will
	 * automatically set the <code>direction</code> property when an
	 * <code>IDirectionalScrollBar</code> is returned by its scroll bar
	 * factories.
	 *
	 * @productversion Feathers 2.0.0
	 */
	public interface IDirectionalScrollBar extends IScrollBar
	{
		/**
		 * The direction of the scroll bar, either horizontal or vertical.
		 *
		 * @see feathers.layout.Direction#HORIZONTAL
		 * @see feathers.layout.Direction#VERTICAL
		 */
		function get direction():String;

		/**
		 * @private
		 */
		function set direction(value:String):void;
	}
}


================================================
FILE: source/feathers/controls/IRange.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.IFeathersControl;

	/**
	 * Dispatched when the value changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #value
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * A UI component that displays a range of values from a minimum to a maximum.
	 *
	 * @productversion Feathers 1.3.0
	 */
	public interface IRange extends IFeathersControl
	{
		/**
		 * The minimum numeric value of the range.
		 *
		 * <p>In the following example, the minimum is changed to 0:</p>
		 *
		 * <listing version="3.0">
		 * component.minimum = 0;
		 * component.maximum = 100;
		 * component.step = 1;
		 * component.page = 10
		 * component.value = 12;</listing>
		 */
		function get minimum():Number;

		/**
		 * @private
		 */
		function set minimum(value:Number):void;

		/**
		 * The maximum numeric value of the range.
		 *
		 * <p>In the following example, the maximum is changed to 100:</p>
		 *
		 * <listing version="3.0">
		 * component.minimum = 0;
		 * component.maximum = 100;
		 * component.step = 1;
		 * component.page = 10
		 * component.value = 12;</listing>
		 */
		function get maximum():Number;

		/**
		 * @private
		 */
		function set maximum(value:Number):void;

		/**
		 * The current numeric value.
		 *
		 * <p>In the following example, the value is changed to 12:</p>
		 *
		 * <listing version="3.0">
		 * component.minimum = 0;
		 * component.maximum = 100;
		 * component.step = 1;
		 * component.page = 10
		 * component.value = 12;</listing>
		 */
		function get value():Number;

		/**
		 * @private
		 */
		function set value(value:Number):void;

		/**
		 * The amount the value must change to increment or decrement.
		 *
		 * <p>In the following example, the step is changed to 1:</p>
		 *
		 * <listing version="3.0">
		 * component.minimum = 0;
		 * component.maximum = 100;
		 * component.step = 1;
		 * component.page = 10
		 * component.value = 12;</listing>
		 */
		function get step():Number;

		/**
		 * @private
		 */
		function set step(value:Number):void;
	}
}


================================================
FILE: source/feathers/controls/IScreen.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.IFeathersControl;

	/**
	 * A screen to display in a screen navigator.
	 *
	 * @see feathers.controls.StackScreenNavigator
	 * @see feathers.controls.ScreenNavigator
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface IScreen extends IFeathersControl
	{
		/**
		 * The identifier for the screen. This value is passed in by the
		 * <code>ScreenNavigator</code> when the screen is instantiated.
		 */
		function get screenID():String;

		/**
		 * @private
		 */
		function set screenID(value:String):void;

		/**
		 * The screen navigator that is currently displaying this screen.
		 */
		function get owner():Object;

		/**
		 * @private
		 */
		function set owner(value:Object):void;
	}
}


================================================
FILE: source/feathers/controls/IScrollBar.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * Dispatched when the scroll bar's value changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #value
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Minimum requirements for a scroll bar to be usable with a <code>Scroller</code>
	 * component.
	 *
	 * @see Scroller
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface IScrollBar extends IRange
	{
		/**
		 * The amount the scroll bar value must change to get from one "page" to
		 * the next.
		 *
		 * <p>If this value is <code>0</code>, the <code>step</code> value
		 * will be used instead. If the <code>step</code> value is
		 * <code>0</code>, paging is not possible.</p>
		 *
		 * <p>In the following example, the page is changed to 10:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.minimum = 0;
		 * scrollBar.maximum = 100;
		 * scrollBar.step = 1;
		 * scrollBar.page = 10
		 * scrollBar.value = 12;</listing>
		 */
		function get page():Number;

		/**
		 * @private
		 */
		function set page(value:Number):void;
	}
}


================================================
FILE: source/feathers/controls/IScrollContainer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.IFeathersControl;

	import starling.display.DisplayObject;

	/**
	 * Defines functions for a <code>Scroller</code> subclass that delegates
	 * display list manipulations to its <code>IViewPort</code>.
	 *
	 * <p>Mainly intended for <code>ScrollContainer</code>, but other subclasses
	 * of <code>Scroller</code> could possibly implement it too.</p>
	 *
	 * @see feathers.controls.Scroller
	 * @see feathers.controls.ScrollContainer
	 *
	 * @productversion Feathers 1.3.0
	 */
	public interface IScrollContainer extends IFeathersControl
	{
		/**
		 * Returns the number of raw children that are added directly to the
		 * <code>Scroller</code> rather than delegating the call to the view
		 * port.
		 */
		function get numRawChildren():int;

		/**
		 * Gets the name of a direct child of the <code>Scroller</code> rather
		 * than delegating the call to the view port.
		 */
		function getRawChildByName(name:String):DisplayObject;

		/**
		 * Gets the index of a direct child of the <code>Scroller</code> rather
		 * than delegating the call to the view port.
		 */
		function getRawChildIndex(child:DisplayObject):int;

		/**
		 * Gets the direct child of the <code>Scroller</code> at a specific
		 * index rather than delegating the call to the view port.
		 */
		function getRawChildAt(index:int):DisplayObject;

		/**
		 * Sets the index of a direct child of the <code>Scroller</code> rather
		 * than delegating the call to the view port.
		 */
		function setRawChildIndex(child:DisplayObject, index:int):void;

		/**
		 * Adds a child to the <code>Scroller</code> rather than delegating the
		 * call to the view port.
		 */
		function addRawChild(child:DisplayObject):DisplayObject;

		/**
		 * Adds a child to the <code>Scroller</code> at a specific index rather
		 * than delegating the call to the view port.
		 */
		function addRawChildAt(child:DisplayObject, index:int):DisplayObject;

		/**
		 * Removes a child from the <code>Scroller</code> rather than delegating
		 * the call to the view port.
		 */
		function removeRawChild(child:DisplayObject, dispose:Boolean = false):DisplayObject;

		/**
		 * Removes a child from the <code>Scroller</code> at a specific index
		 * rather than delegating the call to the view port.
		 */
		function removeRawChildAt(index:int, dispose:Boolean = false):DisplayObject;

		/**
		 * Swaps the children of the <code>Scroller</code> rather than
		 * delegating the call to the view port.
		 */
		function swapRawChildren(child1:DisplayObject, child2:DisplayObject):void;

		/**
		 * Swaps the children of the <code>Scroller</code> rather than
		 * delegating the call to the view port.
		 */
		function swapRawChildrenAt(index1:int, index2:int):void;

		/**
		 * Sorts the children of the <code>Scroller</code> rather than
		 * delegating the call to the view port.
		 */
		function sortRawChildren(compareFunction:Function):void;
	}
}


================================================
FILE: source/feathers/controls/ImageLoader.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.events.FeathersEventType;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.skins.IStyleProvider;
	import feathers.utils.textures.TextureCache;

	import flash.display.Bitmap;
	import flash.display.BitmapData;
	import flash.display.Loader;
	import flash.display.LoaderInfo;
	import flash.display3D.Context3DTextureFormat;
	import flash.errors.IllegalOperationError;
	import flash.events.ErrorEvent;
	import flash.events.Event;
	import flash.events.IOErrorEvent;
	import flash.events.ProgressEvent;
	import flash.events.SecurityErrorEvent;
	import flash.geom.Rectangle;
	import flash.net.URLLoader;
	import flash.net.URLLoaderDataFormat;
	import flash.net.URLRequest;
	import flash.system.ImageDecodingPolicy;
	import flash.system.LoaderContext;
	import flash.utils.ByteArray;
	import flash.utils.setTimeout;

	import starling.core.Starling;
	import starling.display.Image;
	import starling.display.Mesh;
	import starling.display.Quad;
	import starling.events.EnterFrameEvent;
	import starling.events.Event;
	import starling.styles.MeshStyle;
	import starling.textures.Texture;
	import starling.textures.TextureSmoothing;
	import starling.utils.RectangleUtil;
	import starling.utils.ScaleMode;
	import starling.utils.SystemUtil;

	/**
	 * The tint value to use on the internal
	 * <code>starling.display.Image</code>.
	 *
	 * <p>In the following example, the image loader's texture color is
	 * customized:</p>
	 *
	 * <listing version="3.0">
	 * loader.color = 0xff00ff;</listing>
	 *
	 * @default 0xffffff
	 *
	 * @see http://doc.starling-framework.org/core/starling/display/Image.html#color starling.display.Image.color
	 */
	[Style(name="color",type="uint")]

	/**
	 * A texture to display while a URL source is loading.
	 *
	 * <p>In the following example, the image loader's loading texture is
	 * customized:</p>
	 *
	 * <listing version="3.0">
	 * loader.source = "http://example.com/example.png";
	 * loader.loadingTexture = texture;</listing>
	 *
	 * @default null
	 *
	 * @see #style:errorTexture
	 */
	[Style(name="loadingTexture",type="starling.textures.Texture")]

	/**
	 * A texture to display when a URL source cannot be loaded for any
	 * reason.
	 *
	 * <p>In the following example, the image loader's error texture is
	 * customized:</p>
	 *
	 * <listing version="3.0">
	 * loader.source = "http://example.com/example.png";
	 * loader.errorTexture = texture;</listing>
	 *
	 * @default null
	 *
	 * @see #style:loadingTexture
	 */
	[Style(name="errorTexture",type="starling.textures.Texture")]

	/**
	 * The location where the content is aligned horizontally (on
	 * the x-axis) when its width is larger or smaller than the width of
	 * the <code>ImageLoader</code>.
	 *
	 * <p>If the <code>scaleContent</code> property is set to
	 * <code>true</code>, the <code>horizontalAlign</code> property is
	 * ignored.</p>
	 *
	 * <p>The following example aligns the content to the right:</p>
	 *
	 * <listing version="3.0">
	 * loader.horizontalAlign = HorizontalAlign.RIGHT;</listing>
	 *
	 * <p><strong>Note:</strong> The <code>HorizontalAlign.JUSTIFY</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.HorizontalAlign.LEFT
	 *
	 * @see #style:scaleContent
	 * @see #style:scaleMode
	 * @see feathers.layout.HorizontalAlign#LEFT
	 * @see feathers.layout.HorizontalAlign#CENTER
	 * @see feathers.layout.HorizontalAlign#RIGHT
	 */
	[Style(name="horizontalAlign",type="String")]

	/**
	 * Determines if the aspect ratio of the texture is maintained when the
	 * dimensions of the <code>ImageLoader</code> are changed manually and
	 * the new dimensions have a different aspect ratio than the texture.
	 *
	 * <p>If the <code>scaleContent</code> property is set to
	 * <code>false</code> or if the <code>scale9Grid</code> property is not
	 * <code>null</code>, the <code>maintainAspectRatio</code> property is
	 * ignored.</p>
	 *
	 * <p>In the following example, the image loader's aspect ratio is not
	 * maintained:</p>
	 *
	 * <listing version="3.0">
	 * loader.maintainAspectRatio = false;</listing>
	 *
	 * @default true
	 *
	 * @see #style:scaleContent
	 * @see #style:scaleMode
	 */
	[Style(name="maintainAspectRatio",type="Boolean")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the image loader's padding is set to
	 * 20 pixels on all sides:</p>
	 *
	 * <listing version="3.0">
	 * loader.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, between the control's top edge and the
	 * control's content. Value may be negative to extend the content
	 * outside the edges of the control. Useful for skinning.
	 *
	 * <p>In the following example, the image loader's top padding is set
	 * to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * loader.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the control's right edge and the
	 * control's content. Value may be negative to extend the content
	 * outside the edges of the control. Useful for skinning.
	 *
	 * <p>In the following example, the image loader's right padding is set
	 * to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * loader.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the control's bottom edge and the
	 * control's content. Value may be negative to extend the content
	 * outside the edges of the control. Useful for skinning.
	 *
	 * <p>In the following example, the image loader's bottom padding is set
	 * to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * loader.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the control's left edge and the
	 * control's content. Value may be negative to extend the content
	 * outside the edges of the control. Useful for skinning.
	 *
	 * <p>In the following example, the image loader's left padding is set
	 * to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * loader.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * The <code>pixelSnapping</code> value to use on the internal
	 * <code>starling.display.Image</code>.
	 *
	 * <p>In the following example, the image loader's pixelSnapping is
	 * disabled:</p>
	 *
	 * <listing version="3.0">
	 * loader.pixelSnapping = false;</listing>
	 *
	 * @default true
	 *
	 * @see http://doc.starling-framework.org/core/starling/display/Mesh.html#pixelSnapping starling.display.Mesh.pixelSnapping
	 */
	[Style(name="pixelSnapping",type="Boolean")]

	/**
	 * The <code>scale9Grid</code> value to use on the internal
	 * <code>starling.display.Image</code>.
	 *
	 * <p>If this property is not <code>null</code>, the
	 * <code>maintainAspectRatio</code> property will be ignored.</p>
	 *
	 * <p>In the following example, the image loader's scale9Grid is set to a
	 * custom value:</p>
	 *
	 * <listing version="3.0">
	 * loader.scale9Grid = Rectangle(2, 3, 7, 12);</listing>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/core/starling/display/Image.html#scale9Grid starling.display.Image.scale9Grid
	 */
	[Style(name="scale9Grid",type="flash.geom.Rectangle")]

	/**
	 * Determines if the content will be scaled if the dimensions of the
	 * <code>ImageLoader</code> are changed.
	 *
	 * <p>In the following example, the image loader's content is not
	 * scaled:</p>
	 *
	 * <listing version="3.0">
	 * loader.scaleContent = false;</listing>
	 *
	 * @default true
	 *
	 * @see #style:horizontalAlign
	 * @see #style:verticalAlign
	 * @see #style:maintainAspectRatio
	 * @see #style:scaleMode
	 */
	[Style(name="scaleContent",type="Boolean")]

	/**
	 * Determines how the texture is scaled if <code>scaleContent</code> and
	 * <code>maintainAspectRatio</code> are both set to <code>true</code>.
	 * See the <code>starling.utils.ScaleMode</code> class for details about
	 * each scaling mode.
	 *
	 * <p>If the <code>scaleContent</code> property is set to
	 * <code>false</code>, or the <code>maintainAspectRatio</code> property
	 * is set to false, the <code>scaleMode</code> property is ignored.</p>
	 *
	 * <p>In the following example, the image loader's scale mode is changed:</p>
	 *
	 * <listing version="3.0">
	 * loader.scaleMode = ScaleMode.NO_BORDER;</listing>
	 *
	 * @default starling.utils.ScaleMode.SHOW_ALL
	 *
	 * @see #style:scaleContent
	 * @see #style:maintainAspectRatio
	 * @see http://doc.starling-framework.org/core/starling/utils/ScaleMode.html starling.utils.ScaleMode
	 */
	[Style(name="scaleMode",type="String")]

	/**
	 * The texture smoothing value to use on the internal
	 * <code>starling.display.Image</code>.
	 *
	 * <p>In the following example, the image loader's smoothing is set to a
	 * custom value:</p>
	 *
	 * <listing version="3.0">
	 * loader.textureSmoothing = TextureSmoothing.NONE;</listing>
	 *
	 * @default starling.textures.TextureSmoothing.BILINEAR
	 *
	 * @see http://doc.starling-framework.org/core/starling/textures/TextureSmoothing.html starling.textures.TextureSmoothing
	 * @see http://doc.starling-framework.org/core/starling/display/Mesh.html#textureSmoothing starling.display.Mesh.textureSmoothing
	 */
	[Style(name="textureSmoothing",type="String")]

	/**
	 * The <code>tileGrid</code> value to use on the internal
	 * <code>starling.display.Image</code>.
	 *
	 * <p>In the following example, the image loader's tileGrid is set to a
	 * custom value:</p>
	 *
	 * <listing version="3.0">
	 * loader.tileGrid = Rectangle();</listing>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/core/starling/display/Image.html#tileGrid starling.display.Image.tileGrid
	 */
	[Style(name="tileGrid",type="flash.geom.Rectangle")]

	/**
	 * The location where the content is aligned vertically (on
	 * the y-axis) when its height is larger or smaller than the height of
	 * the <code>ImageLoader</code>.
	 *
	 * <p>If the <code>scaleContent</code> property is set to
	 * <code>true</code>, the <code>verticalAlign</code> property is
	 * ignored.</p>
	 *
	 * <p>The following example aligns the content to the bottom:</p>
	 *
	 * <listing version="3.0">
	 * loader.verticalAlign = VerticalAlign.BOTTOM;</listing>
	 *
	 * <p><strong>Note:</strong> The <code>VerticalAlign.JUSTIFY</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.VerticalAlign.TOP
	 *
	 * @see #style:scaleContent
	 * @see #style:scaleMode
	 * @see feathers.layout.VerticalAlign#TOP
	 * @see feathers.layout.VerticalAlign#MIDDLE
	 * @see feathers.layout.VerticalAlign#BOTTOM
	 */
	[Style(name="verticalAlign",type="String")]

	/**
	 * Dispatched when the source finishes loading, if the source is a URL. This
	 * event is not dispatched when the source is a texture.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.COMPLETE
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * Dispatched periodically as the source loads, if the source is a URL. This
	 * event is not dispatched when the source is a texture.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>A value between 0.0 and 1.0 to indicate
	 *   how much image data has loaded.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.PROGRESS
	 */
	[Event(name="progress",type="starling.events.Event")]

	/**
	 * @private
	 * DEPRECATED: Replaced by <code>Event.IO_ERROR</code> and
	 * <code>Event.SECURITY_ERROR</code>.
	 *
	 * <p><strong>DEPRECATION WARNING:</strong> This event is deprecated
	 * starting with Feathers 2.2. It will be removed in a future version of
	 * Feathers according to the standard
	 * <a target="_top" href="../../../help/deprecation-policy.html">Feathers deprecation policy</a>.</p>
	 *
	 * @eventType feathers.events.FeathersEventType.ERROR
	 *
	 * @see #event:ioError
	 * @see #event:securityError
	 */
	[Event(name="error",type="starling.events.Event")]

	/**
	 * Dispatched if an IO error occurs while loading the source content.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The <code>flash.events.IOErrorEvent</code>
	 *   dispatched by the loader.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.IO_ERROR
	 */
	[Event(name="ioError",type="starling.events.Event")]

	/**
	 * Dispatched if a security error occurs while loading the source content.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The <code>flash.events.SecurityErrorEvent</code>
	 *   dispatched by the loader.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.SECURITY_ERROR
	 */
	[Event(name="securityError",type="starling.events.Event")]

	/**
	 * Displays an image, either from an existing <code>Texture</code> object or
	 * from an image file loaded with its URL. Supported image files include ATF
	 * format and any bitmap formats that may be loaded by
	 * <code>flash.display.Loader</code>, including JPG, GIF, and PNG.
	 *
	 * <p>The following example passes a URL to an image loader and listens for
	 * its complete event:</p>
	 *
	 * <listing version="3.0">
	 * var loader:ImageLoader = new ImageLoader();
	 * loader.source = "http://example.com/example.png";
	 * loader.addEventListener( Event.COMPLETE, loader_completeHandler );
	 * this.addChild( loader );</listing>
	 *
	 * <p>The following example passes an existing texture to an image loader:</p>
	 *
	 * <listing version="3.0">
	 * var loader:ImageLoader = new ImageLoader();
	 * loader.source = Texture.fromBitmap( bitmap );
	 * this.addChild( loader );</listing>
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class ImageLoader extends FeathersControl
	{
		/**
		 * @private
		 */
		private static const HELPER_RECTANGLE:Rectangle = new Rectangle();

		/**
		 * @private
		 */
		private static const HELPER_RECTANGLE2:Rectangle = new Rectangle();

		/**
		 * @private
		 */
		private static const CONTEXT_LOST_WARNING:String = "ImageLoader: Context lost while processing loaded image, retrying...";

		/**
		 * @private
		 */
		protected static const ATF_FILE_EXTENSION:String = "atf";

		/**
		 * @private
		 */
		protected static var textureQueueHead:ImageLoader;

		/**
		 * @private
		 */
		protected static var textureQueueTail:ImageLoader;

		/**
		 * The default <code>IStyleProvider</code> for all <code>ImageLoader</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function ImageLoader()
		{
			this.isQuickHitAreaEnabled = true;
		}

		/**
		 * The internal <code>starling.display.Image</code> child.
		 */
		protected var image:Image;

		/**
		 * The internal <code>flash.display.Loader</code> used to load textures
		 * from URLs.
		 */
		protected var loader:Loader;

		/**
		 * The internal <code>flash.net.URLLoader</code> used to load raw data
		 * from URLs.
		 */
		protected var urlLoader:URLLoader;

		/**
		 * @private
		 */
		protected var _lastURL:String;

		/**
		 * @private
		 */
		protected var _originalTextureWidth:Number = NaN;

		/**
		 * @private
		 */
		protected var _originalTextureHeight:Number = NaN;

		/**
		 * @private
		 */
		protected var _currentTextureWidth:Number = NaN;

		/**
		 * @private
		 */
		protected var _currentTextureHeight:Number = NaN;

		/**
		 * @private
		 */
		protected var _currentTexture:Texture;

		/**
		 * @private
		 */
		protected var _isRestoringTexture:Boolean = false;

		/**
		 * @private
		 */
		protected var _texture:Texture;

		/**
		 * @private
		 */
		protected var _isTextureOwner:Boolean = false;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return ImageLoader.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _source:Object;

		/**
		 * The <code>Texture</code> to display, or a URL pointing to an image
		 * file. Supported image files include ATF format and any bitmap formats
		 * that may be loaded by <code>flash.display.Loader</code>, including
		 * JPG, GIF, and PNG.
		 *
		 * <p>In the following example, the image loader's source is set to a
		 * texture:</p>
		 *
		 * <listing version="3.0">
		 * loader.source = Texture.fromBitmap( bitmap );</listing>
		 *
		 * <p>In the following example, the image loader's source is set to the
		 * URL of a PNG image:</p>
		 *
		 * <listing version="3.0">
		 * loader.source = "http://example.com/example.png";</listing>
		 *
		 * @default null
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/display/Loader.html
		 * @see http://wiki.starling-framework.org/manual/atf_textures
		 */
		public function get source():Object
		{
			return this._source;
		}

		/**
		 * @private
		 */
		public function set source(value:Object):void
		{
			if(this._source == value)
			{
				return;
			}
			this._isRestoringTexture = false;
			if(this._isInTextureQueue)
			{
				this.removeFromTextureQueue();
			}

			var oldTexture:Texture;
			//we should try to reuse the existing texture, if possible.
			if(this._isTextureOwner && value && !(value is Texture))
			{
				oldTexture = this._texture;
				this._isTextureOwner = false;
			}
			this.cleanupTexture();

			//the source variable needs to be set after cleanupTexture() is
			//called because cleanupTexture() needs to know the old source if
			//a TextureCache is in use.
			this._source = value;

			if(oldTexture)
			{
				this._texture = oldTexture;
				this._isTextureOwner = true;
			}
			if(this.image)
			{
				this.image.visible = false;
			}
			this.cleanupLoaders(true);
			this._lastURL = null;
			if(this._source is Texture)
			{
				this._isLoaded = true;
			}
			else
			{

				this._isLoaded = false;
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _textureCache:TextureCache;

		/**
		 * An optional cache for textures.
		 *
		 * <p>In the following example, a cache is provided for textures:</p>
		 *
		 * <listing version="3.0">
		 * var cache:TextureCache = new TextureCache(30);
		 * loader1.textureCache = cache;
		 * loader2.textureCache = cache;</listing>
		 *
		 * <p><strong>Warning:</strong> the textures in the cache will not be
		 * disposed automatically. When the cache is no longer needed (such as
		 * when the <code>ImageLoader</code> components have all been disposed),
		 * you must call the <code>dispose()</code> method on the
		 * <code>TextureCache</code>. Failing to do so will result in a serious
		 * memory leak.</p>
		 *
		 * @default null
		 */
		public function get textureCache():TextureCache
		{
			return this._textureCache;
		}

		/**
		 * @private
		 */
		public function set textureCache(value:TextureCache):void
		{
			this._textureCache = value;
		}

		/**
		 * @private
		 */
		protected var _loadingTexture:Texture;

		/**
		 * @private
		 */
		public function get loadingTexture():Texture
		{
			return this._loadingTexture;
		}

		/**
		 * @private
		 */
		public function set loadingTexture(value:Texture):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._loadingTexture === value)
			{
				return;
			}
			this._loadingTexture = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _errorTexture:Texture;

		/**
		 * @private
		 */
		public function get errorTexture():Texture
		{
			return this._errorTexture;
		}

		/**
		 * @private
		 */
		public function set errorTexture(value:Texture):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._errorTexture === value)
			{
				return;
			}
			this._errorTexture = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isLoaded:Boolean = false;

		/**
		 * Indicates if the source has completed loading, if the source is a
		 * URL. Always returns <code>true</code> when the source is a texture.
		 *
		 * <p>In the following example, we check if the image loader's source
		 * has finished loading:</p>
		 *
		 * <listing version="3.0">
		 * if( loader.isLoaded )
		 * {
		 *     //do something
		 * }</listing>
		 */
		public function get isLoaded():Boolean
		{
			return this._isLoaded;
		}

		/**
		 * @private
		 */
		private var _textureScale:Number = 1;

		/**
		 * Scales the texture dimensions during measurement, but does not set
		 * the texture's scale factor. Useful for UI that should scale based on
		 * screen density or resolution without accounting for
		 * <code>contentScaleFactor</code>.
		 *
		 * <p>In the following example, the image loader's texture scale is
		 * customized:</p>
		 *
		 * <listing version="3.0">
		 * loader.textureScale = 0.5;</listing>
		 *
		 * @default 1
		 */
		public function get textureScale():Number
		{
			return this._textureScale;
		}

		/**
		 * @private
		 */
		public function set textureScale(value:Number):void
		{
			if(this._textureScale == value)
			{
				return;
			}
			this._textureScale = value;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		private var _scaleFactor:Number = 1;

		/**
		 * The scale factor value to pass to <code>Texture.fromBitmapData()</code>
		 * when creating a texture loaded from a URL.
		 *
		 * <p>In the following example, the image loader's scale factor is
		 * customized:</p>
		 *
		 * <listing version="3.0">
		 * loader.scaleFactor = 2;</listing>
		 *
		 * @default 1
		 */
		public function get scaleFactor():Number
		{
			return this._scaleFactor;
		}

		/**
		 * @private
		 */
		public function set scaleFactor(value:Number):void
		{
			if(this._scaleFactor == value)
			{
				return;
			}
			this._scaleFactor = value;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		private var _textureSmoothing:String = TextureSmoothing.BILINEAR;

		/**
		 * @private
		 */
		public function get textureSmoothing():String
		{
			return this._textureSmoothing;
		}

		/**
		 * @private
		 */
		public function set textureSmoothing(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._textureSmoothing === value)
			{
				return;
			}
			this._textureSmoothing = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _defaultStyle:MeshStyle = null;

		/**
		 * @private
		 */
		protected var _style:MeshStyle = null;

		/**
		 * The style that is used to render the loader's image.
		 *
		 * <p>In the following example, the loader uses a custom style:</p>
		 *
		 * <listing version="3.0">
		 * loader.style = new CustomMeshStyle();</listing>
		 *
		 * @default null
		 */
		public function get style():MeshStyle
		{
			return this._style;
		}

		/**
		 * @private
		 */
		public function set style(value:MeshStyle):void
		{
			if(this._style == value)
			{
				return;
			}
			this._style = value;
			if(this._style)
			{
				this._defaultStyle = null;
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _scale9Grid:Rectangle;

		/**
		 * @private
		 */
		public function get scale9Grid():Rectangle
		{
			return this._scale9Grid;
		}

		/**
		 * @private
		 */
		public function set scale9Grid(value:Rectangle):void
		{
			if(this._scale9Grid == value)
			{
				return;
			}
			this._scale9Grid = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _tileGrid:Rectangle;

		/**
		 * @private
		 */
		public function get tileGrid():Rectangle
		{
			return this._tileGrid;
		}

		/**
		 * @private
		 */
		public function set tileGrid(value:Rectangle):void
		{
			if(this._tileGrid == value)
			{
				return;
			}
			this._tileGrid = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _pixelSnapping:Boolean = true;

		/**
		 * @private
		 */
		public function get pixelSnapping():Boolean
		{
			return this._pixelSnapping;
		}

		/**
		 * @private
		 */
		public function set pixelSnapping(value:Boolean):void
		{
			if(this._pixelSnapping == value)
			{
				return;
			}
			this._pixelSnapping = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _color:uint = 0xffffff;

		/**
		 * @private
		 */
		public function get color():uint
		{
			return this._color;
		}

		/**
		 * @private
		 */
		public function set color(value:uint):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._color == value)
			{
				return;
			}
			this._color = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _textureFormat:String = Context3DTextureFormat.BGRA;

		/**
		 * The texture format to use when creating a texture loaded from a URL.
		 *
		 * <p>In the following example, the image loader's texture format is set
		 * to a custom value:</p>
		 *
		 * <listing version="3.0">
		 * loader.textureFormat = Context3DTextureFormat.BGRA_PACKED;</listing>
		 *
		 * @default flash.display3d.Context3DTextureFormat.BGRA
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/display3D/Context3DTextureFormat.html flash.display3d.Context3DTextureFormat
		 */
		public function get textureFormat():String
		{
			return this._textureFormat;
		}

		/**
		 * @private
		 */
		public function set textureFormat(value:String):void
		{
			if(this._textureFormat == value)
			{
				return;
			}
			this._textureFormat = value;
			this._lastURL = null;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		private var _scaleContent:Boolean = true;

		/**
		 * @private
		 */
		public function get scaleContent():Boolean
		{
			return this._scaleContent;
		}

		/**
		 * @private
		 */
		public function set scaleContent(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._scaleContent === value)
			{
				return;
			}
			this._scaleContent = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		private var _maintainAspectRatio:Boolean = true;

		/**
		 * @private
		 */
		public function get maintainAspectRatio():Boolean
		{
			return this._maintainAspectRatio;
		}

		/**
		 * @private
		 */
		public function set maintainAspectRatio(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._maintainAspectRatio === value)
			{
				return;
			}
			this._maintainAspectRatio = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		private var _scaleMode:String = ScaleMode.SHOW_ALL;

		[Inspectable(type="String",enumeration="showAll,noBorder,none")]
		/**
		 * @private
		 */
		public function get scaleMode():String
		{
			return this._scaleMode;
		}

		/**
		 * @private
		 */
		public function set scaleMode(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._scaleMode === value)
			{
				return;
			}
			this._scaleMode = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.LEFT;

		[Inspectable(type="String",enumeration="left,center,right")]
		/**
		 * @private
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._horizontalAlign === value)
			{
				return;
			}
			this._horizontalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.TOP;

		[Inspectable(type="String",enumeration="top,middle,bottom")]
		/**
		 * @private
		 */
		public function get verticalAlign():String
		{
			return _verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._verticalAlign === value)
			{
				return;
			}
			this._verticalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * The original width of the source content, in pixels. This value will
		 * be <code>0</code> until the source content finishes loading. If the
		 * source is a texture, this value will be <code>0</code> until the
		 * <code>ImageLoader</code> validates.
		 */
		public function get originalSourceWidth():Number
		{
			if(this._originalTextureWidth === this._originalTextureWidth) //!isNaN
			{
				return this._originalTextureWidth;
			}
			return 0;
		}

		/**
		 * The original height of the source content, in pixels. This value will
		 * be <code>0</code> until the source content finishes loading. If the
		 * source is a texture, this value will be <code>0</code> until the
		 * <code>ImageLoader</code> validates.
		 */
		public function get originalSourceHeight():Number
		{
			if(this._originalTextureHeight === this._originalTextureHeight) //!isNaN
			{
				return this._originalTextureHeight;
			}
			return 0;
		}

		/**
		 * @private
		 */
		protected var _pendingBitmapDataTexture:BitmapData;

		/**
		 * @private
		 */
		protected var _pendingRawTextureData:ByteArray;

		/**
		 * @private
		 */
		protected var _delayTextureCreation:Boolean = false;

		/**
		 * Determines if a loaded bitmap may be converted to a texture
		 * immediately after loading. If <code>true</code>, the loaded bitmap
		 * will be saved until this property is set to <code>false</code>, and
		 * only then it will be used to create the texture.
		 *
		 * <p>This property is intended to be used while a parent container,
		 * such as a <code>List</code>, is scrolling in order to keep scrolling
		 * as smooth as possible. Creating textures is expensive and performance
		 * can be affected by it. Set this property to <code>true</code> when
		 * the <code>List</code> dispatches <code>FeathersEventType.SCROLL_START</code>
		 * and set back to false when the <code>List</code> dispatches
		 * <code>FeathersEventType.SCROLL_COMPLETE</code>. You may also need
		 * to set to false if the <code>isScrolling</code> property of the
		 * <code>List</code> is <code>true</code> before you listen to those
		 * events.</p>
		 *
		 * <p>In the following example, the image loader's texture creation is
		 * delayed:</p>
		 *
		 * <listing version="3.0">
		 * loader.delayTextureCreation = true;</listing>
		 *
		 * @default false
		 *
		 * @see #textureQueueDuration
		 * @see feathers.controls.Scroller#event:scrollStart
		 * @see feathers.controls.Scroller#event:scrollComplete
		 * @see feathers.controls.Scroller#isScrolling
		 */
		public function get delayTextureCreation():Boolean
		{
			return this._delayTextureCreation;
		}

		/**
		 * @private
		 */
		public function set delayTextureCreation(value:Boolean):void
		{
			if(this._delayTextureCreation == value)
			{
				return;
			}
			this._delayTextureCreation = value;
			if(!this._delayTextureCreation)
			{
				this.processPendingTexture();
			}
		}

		/**
		 * @private
		 */
		protected var _isInTextureQueue:Boolean = false;

		/**
		 * @private
		 */
		protected var _textureQueuePrevious:ImageLoader;

		/**
		 * @private
		 */
		protected var _textureQueueNext:ImageLoader;

		/**
		 * @private
		 */
		protected var _accumulatedPrepareTextureTime:Number;

		/**
		 * @private
		 */
		protected var _textureQueueDuration:Number = Number.POSITIVE_INFINITY;

		/**
		 * If <code>delayTextureCreation</code> is <code>true</code> and the
		 * duration is not <code>Number.POSITIVE_INFINITY</code>, the loader
		 * will be added to a queue where the textures are uploaded to the GPU
		 * in sequence to avoid significantly affecting performance. Useful for
		 * lists where many textures may need to be uploaded during scrolling.
		 *
		 * <p>If the duration is <code>Number.POSITIVE_INFINITY</code>, the
		 * default value, the texture will not be uploaded until
		 * <code>delayTextureCreation</code> is set to <code>false</code>. In
		 * this situation, the loader will not be added to the queue, and other
		 * loaders with a duration won't be affected.</p>
		 *
		 * <p>In the following example, the image loader's texture creation is
		 * delayed by half a second:</p>
		 *
		 * <listing version="3.0">
		 * loader.delayTextureCreation = true;
		 * loader.textureQueueDuration = 0.5;</listing>
		 *
		 * @default Number.POSITIVE_INFINITY
		 *
		 * @see #delayTextureCreation
		 */
		public function get textureQueueDuration():Number
		{
			return this._textureQueueDuration;
		}

		/**
		 * @private
		 */
		public function set textureQueueDuration(value:Number):void
		{
			if(this._textureQueueDuration == value)
			{
				return;
			}
			var oldDuration:Number = this._textureQueueDuration;
			this._textureQueueDuration = value;
			if(this._delayTextureCreation)
			{
				if((this._pendingBitmapDataTexture || this._pendingRawTextureData) &&
					oldDuration == Number.POSITIVE_INFINITY && this._textureQueueDuration < Number.POSITIVE_INFINITY)
				{
					this.addToTextureQueue();
				}
				else if(this._isInTextureQueue && this._textureQueueDuration == Number.POSITIVE_INFINITY)
				{
					this.removeFromTextureQueue();
				}
			}
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _asyncTextureUpload:Boolean = true;

		/**
		 * Determines if textures loaded from URLs are uploaded asynchronously
		 * or not.
		 *
		 * <p>Note: depending on the version of AIR and the platform it is
		 * running on, textures may be uploaded synchronously, even when this
		 * property is <code>true</code>.</p>
		 *
		 * <p>In the following example, the texture will be uploaded
		 * synchronously:</p>
		 *
		 * <listing version="3.0">
		 * loader.asyncTextureUpload = false;</listing>
		 *
		 * @default true
		 */
		public function get asyncTextureUpload():Boolean
		{
			return this._asyncTextureUpload;
		}

		/**
		 * @private
		 */
		public function set asyncTextureUpload(value:Boolean):void
		{
			this._asyncTextureUpload = value;
		}

		/**
		 * @private
		 */
		protected var _imageDecodingOnLoad:Boolean = false;

		/**
		 * @private
		 */
		protected var _loaderContext:LoaderContext = null;

		/**
		 * If the texture is loaded using <code>flash.display.Loader</code>,
		 * a custom <code>flash.system.LoaderContext</code> may optionally
		 * be provided.
		 *
		 * <p>In the following example, a custom loader context is provided:</p>
		 *
		 * <listing version="3.0">
		 * var context:LoaderContext = new LoaderContext();
		 * context.loadPolicyFile = true;
		 * loader.loaderContext = context;
		 * </listing>
		 *
		 * @see https://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/system/LoaderContext.html flash.system.LoaderContext
		 */
		public function get loaderContext():LoaderContext
		{
			return this._loaderContext;
		}

		/**
		 * @private
		 */
		public function set loaderContext(value:LoaderContext):void
		{
			this._loaderContext = value;
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this._isRestoringTexture = false;
			this.cleanupLoaders(true);
			this.cleanupTexture();
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);

			if(dataInvalid)
			{
				this.commitData();
			}

			if(dataInvalid || stylesInvalid)
			{
				this.commitStyles();
			}

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			if(dataInvalid || layoutInvalid || sizeInvalid || stylesInvalid)
			{
				this.layout();
			}
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			var heightScale:Number = 1;
			var widthScale:Number = 1;
			if(this._scaleContent && this._maintainAspectRatio &&
				this._scaleMode !== ScaleMode.NONE &&
				this._scale9Grid === null)
			{
				if(!needsHeight)
				{
					heightScale = this._explicitHeight / (this._currentTextureHeight * this._textureScale);
				}
				else if(this._explicitMaxHeight < this._currentTextureHeight)
				{
					heightScale = this._explicitMaxHeight / (this._currentTextureHeight * this._textureScale);
				}
				else if(this._explicitMinHeight > this._currentTextureHeight)
				{
					heightScale = this._explicitMinHeight / (this._currentTextureHeight * this._textureScale);
				}
				if(!needsWidth)
				{
					widthScale = this._explicitWidth / (this._currentTextureWidth * this._textureScale);
				}
				else if(this._explicitMaxWidth < this._currentTextureWidth)
				{
					widthScale = this._explicitMaxWidth / (this._currentTextureWidth * this._textureScale);
				}
				else if(this._explicitMinWidth > this._currentTextureWidth)
				{
					widthScale = this._explicitMinWidth / (this._currentTextureWidth * this._textureScale);
				}
			}

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				if(this._currentTextureWidth === this._currentTextureWidth) //!isNaN
				{
					newWidth = this._currentTextureWidth * this._textureScale * heightScale;
				}
				else
				{
					newWidth = 0;
				}
				newWidth += this._paddingLeft + this._paddingRight;
			}

			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				if(this._currentTextureHeight === this._currentTextureHeight) //!isNaN
				{
					newHeight = this._currentTextureHeight * this._textureScale * widthScale;
				}
				else
				{
					newHeight = 0;
				}
				newHeight += this._paddingTop + this._paddingBottom;
			}

			//this ensures that an ImageLoader can recover from width or height
			//being set to 0 by percentWidth or percentHeight
			if(needsHeight && needsMinHeight)
			{
				//if no height values are set, use the original texture width
				//for the minWidth
				heightScale = 1;
			}
			if(needsWidth && needsMinWidth)
			{
				//if no width values are set, use the original texture height
				//for the minHeight
				widthScale = 1;
			}

			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				if(this._currentTextureWidth === this._currentTextureWidth) //!isNaN
				{
					newMinWidth = this._currentTextureWidth * this._textureScale * heightScale;
				}
				else
				{
					newMinWidth = 0;
				}
				newMinWidth += this._paddingLeft + this._paddingRight;
			}

			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				if(this._currentTextureHeight === this._currentTextureHeight) //!isNaN
				{
					newMinHeight = this._currentTextureHeight * this._textureScale * widthScale;
				}
				else
				{
					newMinHeight = 0;
				}
				newMinHeight += this._paddingTop + this._paddingBottom;
			}

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * @private
		 */
		protected function commitData():void
		{
			if(this._source is Texture)
			{
				this._lastURL = null;
				this._texture = Texture(this._source);
				this.refreshCurrentTexture();
			}
			else
			{
				var sourceURL:String = this._source as String;
				if(!sourceURL)
				{
					this._lastURL = null;
				}
				else if(sourceURL != this._lastURL)
				{
					this._lastURL = sourceURL;

					if(this.findSourceInCache())
					{
						return;
					}

					if(isATFURL(sourceURL))
					{
						if(this.loader)
						{
							this.loader = null;
						}
						if(!this.urlLoader)
						{
							this.urlLoader = new URLLoader();
							this.urlLoader.dataFormat = URLLoaderDataFormat.BINARY;
						}
						this.urlLoader.addEventListener(flash.events.Event.COMPLETE, rawDataLoader_completeHandler);
						this.urlLoader.addEventListener(ProgressEvent.PROGRESS, rawDataLoader_progressHandler);
						this.urlLoader.addEventListener(IOErrorEvent.IO_ERROR, rawDataLoader_ioErrorHandler);
						this.urlLoader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, rawDataLoader_securityErrorHandler);
						this.urlLoader.load(new URLRequest(sourceURL));
						return;
					}
					else //not ATF
					{
						if(this.urlLoader)
						{
							this.urlLoader = null;
						}
						if(!this.loader)
						{
							this.loader = new Loader();
						}
						this.loader.contentLoaderInfo.addEventListener(flash.events.Event.COMPLETE, loader_completeHandler);
						this.loader.contentLoaderInfo.addEventListener(ProgressEvent.PROGRESS, loader_progressHandler);
						this.loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, loader_ioErrorHandler);
						this.loader.contentLoaderInfo.addEventListener(SecurityErrorEvent.SECURITY_ERROR, loader_securityErrorHandler);
						if(this._loaderContext === null)
						{
							//create a default loader context that checks
							//policy files, and also decodes images on load for
							//better performance
							this._loaderContext = new LoaderContext(true);
							this._loaderContext.imageDecodingPolicy = ImageDecodingPolicy.ON_LOAD;
						}
						//save this value because the _loaderContext might
						//change before we need to access it.
						//we will need it if we need to clean up the Loader.
						this._imageDecodingOnLoad = this._loaderContext.imageDecodingPolicy === ImageDecodingPolicy.ON_LOAD;
						this.loader.load(new URLRequest(sourceURL), this._loaderContext);
					}
				}
				this.refreshCurrentTexture();
			}
		}

		/**
		 * @private
		 */
		protected function commitStyles():void
		{
			if(!this.image)
			{
				return;
			}
			this.image.textureSmoothing = this._textureSmoothing;
			this.image.color = this._color;
			this.image.scale9Grid = this._scale9Grid;
			this.image.tileGrid = this._tileGrid;
			this.image.pixelSnapping = this._pixelSnapping;
			if(this._style !== null)
			{
				this.image.style = this._style;
			}
			else
			{
				if(this._defaultStyle === null)
				{
					this._defaultStyle = Mesh.createDefaultStyle(this.image);
				}
				this.image.style = this._defaultStyle;
			}
		}

		/**
		 * @private
		 */
		protected function layout():void
		{
			if(!this.image || !this._currentTexture)
			{
				return;
			}
			if(this._scaleContent)
			{
				if(this._maintainAspectRatio && this._scale9Grid === null)
				{
					HELPER_RECTANGLE.x = 0;
					HELPER_RECTANGLE.y = 0;
					HELPER_RECTANGLE.width = this._currentTextureWidth * this._textureScale;
					HELPER_RECTANGLE.height = this._currentTextureHeight * this._textureScale;
					HELPER_RECTANGLE2.x = 0;
					HELPER_RECTANGLE2.y = 0;
					HELPER_RECTANGLE2.width = this.actualWidth - this._paddingLeft - this._paddingRight;
					HELPER_RECTANGLE2.height = this.actualHeight - this._paddingTop - this._paddingBottom;
					RectangleUtil.fit(HELPER_RECTANGLE, HELPER_RECTANGLE2, this._scaleMode, false, HELPER_RECTANGLE);
					this.image.x = HELPER_RECTANGLE.x + this._paddingLeft;
					this.image.y = HELPER_RECTANGLE.y + this._paddingTop;
					this.image.width = HELPER_RECTANGLE.width;
					this.image.height = HELPER_RECTANGLE.height;
				}
				else
				{
					this.image.x = this._paddingLeft;
					this.image.y = this._paddingTop;
					this.image.width = this.actualWidth - this._paddingLeft - this._paddingRight;
					this.image.height = this.actualHeight - this._paddingTop - this._paddingBottom;
				}
			}
			else
			{
				var imageWidth:Number = this._currentTextureWidth * this._textureScale;
				var imageHeight:Number = this._currentTextureHeight * this._textureScale;
				if(this._horizontalAlign === HorizontalAlign.RIGHT)
				{
					this.image.x = this.actualWidth - this._paddingRight - imageWidth;
				}
				else if(this._horizontalAlign === HorizontalAlign.CENTER)
				{
					this.image.x = this._paddingLeft + ((this.actualWidth - this._paddingLeft - this._paddingRight) - imageWidth) / 2;
				}
				else //left
				{
					this.image.x = this._paddingLeft;
				}
				if(this._verticalAlign === VerticalAlign.BOTTOM)
				{
					this.image.y = this.actualHeight - this._paddingBottom - imageHeight;
				}
				else if(this._verticalAlign === VerticalAlign.MIDDLE)
				{
					this.image.y = this._paddingTop + ((this.actualHeight - this._paddingTop - this._paddingBottom) - imageHeight) / 2;
				}
				else //top
				{
					this.image.y = this._paddingTop;
				}
				this.image.width = imageWidth;
				this.image.height = imageHeight;
			}
			if((!this._scaleContent || (this._maintainAspectRatio && this._scaleMode !== ScaleMode.SHOW_ALL)) &&
				(this.actualWidth != imageWidth || this.actualHeight != imageHeight))
			{
				var mask:Quad = this.image.mask as Quad;
				if(mask !== null)
				{
					mask.x = 0;
					mask.y = 0;
					mask.width = this.actualWidth;
					mask.height = this.actualHeight;
				}
				else
				{
					mask = new Quad(1, 1, 0xff00ff);
					//the initial dimensions cannot be 0 or there's a runtime error,
					//and these values might be 0
					mask.width = this.actualWidth;
					mask.height = this.actualHeight;
					this.image.mask = mask;
					this.addChild(mask);
				}
			}
			else
			{
				mask = this.image.mask as Quad;
				if(mask !== null)
				{
					mask.removeFromParent(true);
					this.image.mask = null;
				}
			}
		}

		/**
		 * @private
		 */
		protected function isATFURL(sourceURL:String):Boolean
		{
			var index:int = sourceURL.indexOf("?");
			if(index >= 0)
			{
				sourceURL = sourceURL.substr(0, index);
			}
			return sourceURL.toLowerCase().lastIndexOf(ATF_FILE_EXTENSION) == sourceURL.length - 3;
		}

		/**
		 * @private
		 */
		protected function refreshCurrentTexture():void
		{
			var newTexture:Texture = this._isLoaded ? this._texture : null;
			if(!newTexture)
			{
				if(this.loader || this.urlLoader)
				{
					newTexture = this._loadingTexture;
				}
				else
				{
					newTexture = this._errorTexture;
				}
			}

			if(this._currentTexture == newTexture)
			{
				return;
			}
			this._currentTexture = newTexture;

			if(!this._currentTexture)
			{
				if(this.image)
				{
					this.removeChild(this.image, true);
					this.image = null;
					this._defaultStyle = null;
				}
				return;
			}

			//save the texture's frame so that we don't need to create a new
			//rectangle every time that we want to access it.
			var frame:Rectangle = this._currentTexture.frame;
			if(frame)
			{
				this._currentTextureWidth = frame.width;
				this._currentTextureHeight = frame.height;
			}
			else
			{
				this._currentTextureWidth = this._currentTexture.width;
				this._currentTextureHeight = this._currentTexture.height;
				this._originalTextureWidth = this._currentTexture.nativeWidth;
				this._originalTextureHeight = this._currentTexture.nativeHeight;
			}
			if(!this.image)
			{
				this.image = new Image(this._currentTexture);
				this.addChild(this.image);
			}
			else
			{
				this.image.texture = this._currentTexture;
				this.image.readjustSize();
			}
			this.image.visible = true;
		}

		/**
		 * @private
		 */
		protected function cleanupTexture():void
		{
			if(this._texture)
			{
				if(this._isTextureOwner)
				{
					if(!SystemUtil.isDesktop && !SystemUtil.isApplicationActive)
					{
						//avoiding stage3d calls when a mobile application isn't active
						SystemUtil.executeWhenApplicationIsActive(this._texture.dispose);
					}
					else
					{
						this._texture.dispose();
					}
				}
				else if(this._textureCache !== null)
				{
					var cacheKey:String = this.sourceToTextureCacheKey(this._source);
					if(cacheKey !== null)
					{
						this._textureCache.releaseTexture(cacheKey);
					}
				}
			}
			if(this._pendingBitmapDataTexture)
			{
				this._pendingBitmapDataTexture.dispose();
			}
			if(this._pendingRawTextureData)
			{
				this._pendingRawTextureData.clear();
			}
			this._currentTexture = null;
			this._currentTextureWidth = NaN;
			this._currentTextureHeight = NaN;
			this._originalTextureWidth = NaN;
			this._originalTextureHeight = NaN;
			this._pendingBitmapDataTexture = null;
			this._pendingRawTextureData = null;
			this._texture = null;
			this._isTextureOwner = false;
		}

		/**
		 * @private
		 */
		protected function cleanupLoaders(close:Boolean):void
		{
			if(this.urlLoader)
			{
				this.urlLoader.removeEventListener(flash.events.Event.COMPLETE, rawDataLoader_completeHandler);
				this.urlLoader.removeEventListener(ProgressEvent.PROGRESS, rawDataLoader_progressHandler);
				this.urlLoader.removeEventListener(IOErrorEvent.IO_ERROR, rawDataLoader_ioErrorHandler);
				this.urlLoader.removeEventListener(SecurityErrorEvent.SECURITY_ERROR, rawDataLoader_securityErrorHandler);
				if(close)
				{
					try
					{
						this.urlLoader.close();
					}
					catch(error:Error)
					{
						//no need to do anything in response
					}
				}
				this.urlLoader = null;
			}

			if(this.loader)
			{
				this.loader.contentLoaderInfo.removeEventListener(flash.events.Event.COMPLETE, loader_completeHandler);
				this.loader.contentLoaderInfo.removeEventListener(ProgressEvent.PROGRESS, loader_progressHandler);
				this.loader.contentLoaderInfo.removeEventListener(IOErrorEvent.IO_ERROR, loader_ioErrorHandler);
				this.loader.contentLoaderInfo.removeEventListener(SecurityErrorEvent.SECURITY_ERROR, loader_securityErrorHandler);
				if(close)
				{
					var closed:Boolean = false;
					if(!this._imageDecodingOnLoad)
					{
						//when using ImageDecodingPolicy.ON_LOAD, calling close()
						//seems to cause the image data to get stuck in memory,
						//unable to be garbage collected!
						//to clean up the memory, we need to wait for Event.COMPLETE
						//to dispose the BitmapData and call unload(). we can't do
						//either of those things here.
						try
						{
							this.loader.close();
							closed = true;
						}
						catch(error:Error)
						{
						}
					}
					if(!closed)
					{
						//if we couldn't close() the loader, for some reason,
						//our best option is to let it complete and clean
						//things up then.
						this.loader.contentLoaderInfo.addEventListener(flash.events.Event.COMPLETE, orphanedLoader_completeHandler);
						//be sure to add listeners for these events, or errors
						//could be thrown! issue #1627
						this.loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, orphanedLoader_errorHandler);
						this.loader.contentLoaderInfo.addEventListener(SecurityErrorEvent.SECURITY_ERROR, orphanedLoader_errorHandler);
					}
				}
				this.loader = null;
			}
		}

		/**
		 * @private
		 */
		protected function findSourceInCache():Boolean
		{
			var cacheKey:String = this.sourceToTextureCacheKey(this._source);
			if(this._textureCache !== null && !this._isRestoringTexture &&
				cacheKey !== null && this._textureCache.hasTexture(cacheKey))
			{
				this._texture = this._textureCache.retainTexture(cacheKey);
				this._isTextureOwner = false;
				this._isRestoringTexture = false;
				this._isLoaded = true;
				this.refreshCurrentTexture();
				this.dispatchEventWith(starling.events.Event.COMPLETE);
				return true;
			}
			return false;
		}

		/**
		 * @private
		 * Subclasses may override this method to support sources other than
		 * URLs in the texture cache.
		 */
		protected function sourceToTextureCacheKey(source:Object):String
		{
			if(source is String)
			{
				return source as String;
			}
			return null;
		}

		/**
		 * @private
		 */
		protected function verifyCurrentStarling():void
		{
			if(this.stage === null || Starling.current.stage === this.stage)
			{
				return;
			}
			this.stage.starling.makeCurrent();
		}

		/**
		 * @private
		 */
		protected function replaceBitmapDataTexture(bitmapData:BitmapData):void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			if(!starling.contextValid)
			{
				//this trace duplicates the behavior of AssetManager
				trace(CONTEXT_LOST_WARNING);
				setTimeout(replaceBitmapDataTexture, 1, bitmapData);
				return;
			}
			if(!SystemUtil.isDesktop && !SystemUtil.isApplicationActive)
			{
				//avoiding stage3d calls when a mobile application isn't active
				SystemUtil.executeWhenApplicationIsActive(replaceBitmapDataTexture, bitmapData);
				return;
			}
			this.verifyCurrentStarling();

			if(this.findSourceInCache())
			{
				//someone else added this URL to the cache while we were in the
				//middle of loading it. we can reuse the texture from the cache!

				//don't forget to dispose the BitmapData, though...
				bitmapData.dispose();

				//then invalidate so that everything is resized correctly
				this.invalidate(INVALIDATION_FLAG_DATA);
				return;
			}

			if(!this._texture)
			{
				//skip Texture.fromBitmapData() because we don't want
				//it to create an onRestore function that will be
				//immediately discarded for garbage collection.
				try
				{
					this._texture = Texture.empty(bitmapData.width / this._scaleFactor,
						bitmapData.height / this._scaleFactor, true, false, false,
						this._scaleFactor, this._textureFormat);
				}
				catch(error:Error)
				{
					this.cleanupTexture();
					this.invalidate(INVALIDATION_FLAG_DATA);
					this.dispatchEventWith(starling.events.Event.IO_ERROR, false, new IOErrorEvent(IOErrorEvent.IO_ERROR, false, false, error.toString()));
					return;
				}
				this._texture.root.onRestore = this.createTextureOnRestore(this._texture,
					this._source, this._textureFormat, this._scaleFactor);
				if(this._textureCache)
				{
					var cacheKey:String = this.sourceToTextureCacheKey(this._source);
					if(cacheKey !== null)
					{
						this._textureCache.addTexture(cacheKey, this._texture, true);
					}
				}
			}
			if(this._asyncTextureUpload)
			{
				this._texture.root.uploadBitmapData(bitmapData, function():void
				{
					if(image !== null)
					{
						//this isn't technically required because other properties of
						//the Image will be changed, but to avoid potential future
						//refactoring headaches, it won't hurt to be extra careful.
						image.setRequiresRedraw();
					}
					bitmapData.dispose();
					_isTextureOwner = _textureCache === null;
					_isRestoringTexture = false;
					_isLoaded = true;
					refreshCurrentTexture();
					invalidate(INVALIDATION_FLAG_DATA);
					dispatchEventWith(starling.events.Event.COMPLETE);
				});
			}
			else //synchronous
			{
				this._texture.root.uploadBitmapData(bitmapData);
				if(this.image !== null)
				{
					//this isn't technically required because other properties of
					//the Image will be changed, but to avoid potential future
					//refactoring headaches, it won't hurt to be extra careful.
					this.image.setRequiresRedraw();
				}
				bitmapData.dispose();
				this._isTextureOwner = this._textureCache === null;
				this._isRestoringTexture = false;
				this._isLoaded = true;
				//let's refresh the texture right away so that properties like
				//originalSourceWidth and originalSourceHeight return the
				//correct values in the Event.COMPLETE listeners.
				this.refreshCurrentTexture();
				//we can still do other things later, like layout
				this.invalidate(INVALIDATION_FLAG_DATA);
				this.dispatchEventWith(starling.events.Event.COMPLETE);
			}
		}

		/**
		 * @private
		 */
		protected function replaceRawTextureData(rawData:ByteArray):void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			if(!starling.contextValid)
			{
				//this trace duplicates the behavior of AssetManager
				trace(CONTEXT_LOST_WARNING);
				setTimeout(replaceRawTextureData, 1, rawData);
				return;
			}
			if(!SystemUtil.isDesktop && !SystemUtil.isApplicationActive)
			{
				//avoiding stage3d calls when a mobile application isn't active
				SystemUtil.executeWhenApplicationIsActive(replaceRawTextureData, rawData);
				return;
			}
			this.verifyCurrentStarling();

			if(this.findSourceInCache())
			{
				//someone else added this URL to the cache while we were in the
				//middle of loading it. we can reuse the texture from the cache!

				//don't forget to clear the ByteArray, though...
				rawData.clear();

				//then invalidate so that everything is resized correctly
				this.invalidate(INVALIDATION_FLAG_DATA);
				return;
			}

			if(this._texture)
			{
				this._texture.root.uploadAtfData(rawData);
			}
			else
			{
				try
				{
					this._texture = Texture.fromAtfData(rawData, this._scaleFactor);
				}
				catch(error:Error)
				{
					this.cleanupTexture();
					this.invalidate(INVALIDATION_FLAG_DATA);
					this.dispatchEventWith(starling.events.Event.IO_ERROR, false, new IOErrorEvent(IOErrorEvent.IO_ERROR, false, false, error.toString()));
					return;
				}
				this._texture.root.onRestore = this.createTextureOnRestore(this._texture,
					this._source, this._textureFormat, this._scaleFactor);
				if(this._textureCache)
				{
					var cacheKey:String = this.sourceToTextureCacheKey(this._source);
					if(cacheKey !== null)
					{
						this._textureCache.addTexture(cacheKey, this._texture, true);
					}
				}
			}
			rawData.clear();
			//if we have a cache for the textures, then the cache is the owner
			//because other ImageLoaders may use the same texture.
			this._isTextureOwner = this._textureCache === null;
			this._isRestoringTexture = false;
			this._isLoaded = true;
			this.invalidate(INVALIDATION_FLAG_DATA);
			this.dispatchEventWith(starling.events.Event.COMPLETE);
		}

		/**
		 * @private
		 */
		protected function addToTextureQueue():void
		{
			if(!this._delayTextureCreation)
			{
				throw new IllegalOperationError("Cannot add loader to delayed texture queue if delayTextureCreation is false.");
			}
			if(this._textureQueueDuration == Number.POSITIVE_INFINITY)
			{
				throw new IllegalOperationError("Cannot add loader to delayed texture queue if textureQueueDuration is Number.POSITIVE_INFINITY.");
			}
			if(this._isInTextureQueue)
			{
				throw new IllegalOperationError("Cannot add loader to delayed texture queue more than once.");
			}
			this.addEventListener(starling.events.Event.REMOVED_FROM_STAGE, imageLoader_removedFromStageHandler);
			this._isInTextureQueue = true;
			if(textureQueueTail)
			{
				textureQueueTail._textureQueueNext = this;
				this._textureQueuePrevious = textureQueueTail;
				textureQueueTail = this;
			}
			else
			{
				textureQueueHead = this;
				textureQueueTail = this;
				this.preparePendingTexture();
			}
		}

		/**
		 * @private
		 */
		protected function removeFromTextureQueue():void
		{
			if(!this._isInTextureQueue)
			{
				return;
			}
			var previous:ImageLoader = this._textureQueuePrevious;
			var next:ImageLoader = this._textureQueueNext;
			this._textureQueuePrevious = null;
			this._textureQueueNext = null;
			this._isInTextureQueue = false;
			this.removeEventListener(starling.events.Event.REMOVED_FROM_STAGE, imageLoader_removedFromStageHandler);
			this.removeEventListener(EnterFrameEvent.ENTER_FRAME, processTextureQueue_enterFrameHandler);
			if(previous)
			{
				previous._textureQueueNext = next;
			}
			if(next)
			{
				next._textureQueuePrevious = previous;
			}
			var wasHead:Boolean = textureQueueHead == this;
			var wasTail:Boolean = textureQueueTail == this;
			if(wasTail)
			{
				textureQueueTail = previous;
				if(wasHead)
				{
					textureQueueHead = previous;
				}
			}
			if(wasHead)
			{
				textureQueueHead = next;
				if(wasTail)
				{
					textureQueueTail = next;
				}
			}
			if(wasHead && textureQueueHead)
			{
				textureQueueHead.preparePendingTexture();
			}
		}

		/**
		 * @private
		 */
		protected function preparePendingTexture():void
		{
			if(this._textureQueueDuration > 0)
			{
				this._accumulatedPrepareTextureTime = 0;
				this.addEventListener(EnterFrameEvent.ENTER_FRAME, processTextureQueue_enterFrameHandler);
			}
			else
			{
				this.processPendingTexture();
			}
		}

		/**
		 * @private
		 */
		protected function processPendingTexture():void
		{
			if(this._pendingBitmapDataTexture)
			{
				var bitmapData:BitmapData = this._pendingBitmapDataTexture;
				this._pendingBitmapDataTexture = null;
				this.replaceBitmapDataTexture(bitmapData);
			}
			if(this._pendingRawTextureData)
			{
				var rawData:ByteArray = this._pendingRawTextureData;
				this._pendingRawTextureData = null;
				this.replaceRawTextureData(rawData);
			}
			if(this._isInTextureQueue)
			{
				this.removeFromTextureQueue();
			}
		}

		/**
		 * @private
		 */
		protected function createTextureOnRestore(texture:Texture, source:Object,
			format:String, scaleFactor:Number):Function
		{
			return function():void
			{
				if(_texture === texture)
				{
					texture_onRestore();
					return;
				}
				//this is a hacky way to handle restoring the texture when the
				//current ImageLoader is no longer displaying the texture being
				//restored.
				var otherLoader:ImageLoader = new ImageLoader();
				otherLoader.source = source;
				otherLoader._texture = texture;
				otherLoader._textureFormat = format;
				otherLoader._scaleFactor = scaleFactor;
				otherLoader.validate();
				otherLoader.addEventListener(starling.events.Event.COMPLETE, onRestore_onComplete);
			};
		}

		/**
		 * @private
		 */
		protected function onRestore_onComplete(event:starling.events.Event):void
		{
			var otherLoader:ImageLoader = ImageLoader(event.currentTarget);
			otherLoader._isTextureOwner = false;
			otherLoader._texture = null;
			otherLoader.dispose();
		}

		/**
		 * @private
		 */
		protected function texture_onRestore():void
		{
			//reload the texture from the URL
			this._isRestoringTexture = true;
			this._lastURL = null;
			this._isLoaded = false;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function processTextureQueue_enterFrameHandler(event:EnterFrameEvent):void
		{
			this._accumulatedPrepareTextureTime += event.passedTime;
			if(this._accumulatedPrepareTextureTime >= this._textureQueueDuration)
			{
				this.removeEventListener(EnterFrameEvent.ENTER_FRAME, processTextureQueue_enterFrameHandler);
				this.processPendingTexture();
			}
		}

		/**
		 * @private
		 */
		protected function imageLoader_removedFromStageHandler(event:starling.events.Event):void
		{
			if(this._isInTextureQueue)
			{
				this.removeFromTextureQueue();
			}
		}

		/**
		 * @private
		 */
		protected function loader_completeHandler(event:flash.events.Event):void
		{
			var bitmap:Bitmap = Bitmap(this.loader.content);
			this.cleanupLoaders(false);

			var bitmapData:BitmapData = bitmap.bitmapData;

			//if the upload is synchronous, attempt to reuse the existing
			//texture so that we don't need to create a new one.
			//when AIR-4198247 is fixed in a stable build, this can be removed
			//(perhaps with some kind of AIR version detection, though)
			var canReuseTexture:Boolean =
				this._texture !== null &&
				(!Texture.asyncBitmapUploadEnabled || !this._asyncTextureUpload) &&
				this._texture.nativeWidth == bitmapData.width &&
				this._texture.nativeHeight == bitmapData.height &&
				this._texture.scale == this._scaleFactor &&
				this._texture.format == this._textureFormat;
			if(!canReuseTexture)
			{
				this.cleanupTexture();
				if(this._textureCache)
				{
					//we need to replace the current texture in the cache,
					//so we need to remove the old one so that the cache
					//doesn't throw an error because there's already a
					//texture with this key.
					var key:String = this.sourceToTextureCacheKey(this._source);
					this._textureCache.removeTexture(key);
				}
			}
			if(this._delayTextureCreation && !this._isRestoringTexture)
			{
				this._pendingBitmapDataTexture = bitmapData;
				if(this._textureQueueDuration < Number.POSITIVE_INFINITY)
				{
					this.addToTextureQueue();
				}
			}
			else
			{
				this.replaceBitmapDataTexture(bitmapData);
			}
		}

		/**
		 * @private
		 */
		protected function loader_progressHandler(event:ProgressEvent):void
		{
			this.dispatchEventWith(FeathersEventType.PROGRESS, false, event.bytesLoaded / event.bytesTotal);
		}

		/**
		 * @private
		 */
		protected function loader_ioErrorHandler(event:IOErrorEvent):void
		{
			this.cleanupLoaders(false);
			this.cleanupTexture();
			this.invalidate(INVALIDATION_FLAG_DATA);
			this.dispatchEventWith(FeathersEventType.ERROR, false, event);
			this.dispatchEventWith(starling.events.Event.IO_ERROR, false, event);
		}

		/**
		 * @private
		 */
		protected function loader_securityErrorHandler(event:SecurityErrorEvent):void
		{
			this.cleanupLoaders(false);
			this.cleanupTexture();
			this.invalidate(INVALIDATION_FLAG_DATA);
			this.dispatchEventWith(FeathersEventType.ERROR, false, event);
			this.dispatchEventWith(starling.events.Event.SECURITY_ERROR, false, event);
		}

		/**
		 * @private
		 */
		protected function orphanedLoader_completeHandler(event:flash.events.Event):void
		{
			var loaderInfo:LoaderInfo = LoaderInfo(event.currentTarget);
			loaderInfo.removeEventListener(flash.events.Event.COMPLETE, orphanedLoader_completeHandler);
			loaderInfo.removeEventListener(IOErrorEvent.IO_ERROR, orphanedLoader_errorHandler);
			loaderInfo.removeEventListener(SecurityErrorEvent.SECURITY_ERROR, orphanedLoader_errorHandler);
			var loader:Loader = loaderInfo.loader;
			var bitmap:Bitmap = Bitmap(loader.content);
			bitmap.bitmapData.dispose();
			//we could call unloadAndStop() and force the garbage collector to
			//run, but that could hurt performance, so let it happen naturally.
			loader.unload();
		}

		/**
		 * @private
		 */
		protected function orphanedLoader_errorHandler(event:flash.events.Event):void
		{
			var loaderInfo:LoaderInfo = LoaderInfo(event.currentTarget);
			loaderInfo.removeEventListener(flash.events.Event.COMPLETE, orphanedLoader_completeHandler);
			loaderInfo.removeEventListener(IOErrorEvent.IO_ERROR, orphanedLoader_errorHandler);
			loaderInfo.removeEventListener(SecurityErrorEvent.SECURITY_ERROR, orphanedLoader_errorHandler);
			//no need to do anything else. this listener only exists to avoid
			//a runtime error on an resource that is no longer required
		}

		/**
		 * @private
		 */
		protected function rawDataLoader_completeHandler(event:flash.events.Event):void
		{
			var rawData:ByteArray = ByteArray(this.urlLoader.data);
			this.cleanupLoaders(false);

			//only clear the texture if we're not restoring
			if(!this._isRestoringTexture)
			{
				this.cleanupTexture();
			}
			if(this._delayTextureCreation && !this._isRestoringTexture)
			{
				this._pendingRawTextureData = rawData;
				if(this._textureQueueDuration < Number.POSITIVE_INFINITY)
				{
					this.addToTextureQueue();
				}
			}
			else
			{
				this.replaceRawTextureData(rawData);
			}
		}

		/**
		 * @private
		 */
		protected function rawDataLoader_progressHandler(event:ProgressEvent):void
		{
			this.dispatchEventWith(FeathersEventType.PROGRESS, false, event.bytesLoaded / event.bytesTotal);
		}

		/**
		 * @private
		 */
		protected function rawDataLoader_ioErrorHandler(event:ErrorEvent):void
		{
			this.cleanupLoaders(false);
			this.cleanupTexture();
			this.invalidate(INVALIDATION_FLAG_DATA);
			this.dispatchEventWith(FeathersEventType.ERROR, false, event);
			this.dispatchEventWith(starling.events.Event.IO_ERROR, false, event);
		}

		/**
		 * @private
		 */
		protected function rawDataLoader_securityErrorHandler(event:ErrorEvent):void
		{
			this.cleanupLoaders(false);
			this.cleanupTexture();
			this.invalidate(INVALIDATION_FLAG_DATA);
			this.dispatchEventWith(FeathersEventType.ERROR, false, event);
			this.dispatchEventWith(starling.events.Event.SECURITY_ERROR, false, event);
		}
	}
}

================================================
FILE: source/feathers/controls/ItemRendererLayoutOrder.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * Layout options for the default item renderers.
	 *
	 * @see feathers.controls.DefaultListItemRenderer
	 * @see feathers.controls.DefaultGroupedListItemRenderer
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class ItemRendererLayoutOrder
	{
		/**
		 * The layout order will be the label first, then the accessory relative
		 * to the label, then the icon relative to both. Best used when the
		 * accessory should be between the label and the icon or when the icon
		 * position shouldn't be affected by the accessory.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const LABEL_ACCESSORY_ICON:String = "labelAccessoryIcon";

		/**
		 * The layout order will be the label first, then the icon relative to
		 * label, then the accessory relative to both.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const LABEL_ICON_ACCESSORY:String = "labelIconAccessory";
	}
}


================================================
FILE: source/feathers/controls/Label.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.ITextBaselineControl;
	import feathers.core.ITextRenderer;
	import feathers.core.IToolTip;
	import feathers.core.IValidating;
	import feathers.core.PropertyProxy;
	import feathers.skins.IStyleProvider;
	import feathers.text.FontStylesSet;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;

	import flash.geom.Point;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.text.TextFormat;
	import starling.utils.Pool;

	/**
	 * A background to display when the label is disabled.
	 *
	 * <p>In the following example, the label is given a disabled background skin:</p>
	 *
	 * <listing version="3.0">
	 * label.backgroundDisabledSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #backgroundSkin
	 */
	[Style(name="backgroundDisabledSkin",type="starling.display.DisplayObject")]

	/**
	 * The default background to display behind the label's text.
	 *
	 * <p>In the following example, the label is given a background skin:</p>
	 *
	 * <listing version="3.0">
	 * label.backgroundSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #backgroundDisabledSkin
	 */
	[Style(name="backgroundSkin",type="starling.display.DisplayObject")]

	/**
	 * A style name to add to the label's text renderer sub-component.
	 * Typically used by a theme to provide different styles to different
	 * labels.
	 *
	 * <p>In the following example, a custom text renderer style name is
	 * passed to the label:</p>
	 *
	 * <listing version="3.0">
	 * label.customTextRendererStyleName = "my-custom-label-text-renderer";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( BitmapFontTextRenderer ).setFunctionForStyleName( "my-custom-label-text-renderer", setCustomLabelTextRendererStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_TEXT_RENDERER
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #textRendererFactory
	 */
	[Style(name="customTextRendererStyleName",type="String")]

	/**
	 * The font styles used to display the label's text when the label is
	 * disabled.
	 *
	 * <p>In the following example, the disabled font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * label.disabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>textRendererFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:fontStyles
	 */
	[Style(name="disabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the label's text.
	 *
	 * <p>In the following example, the font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * label.fontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>textRendererFactory</code> to set more advanced styles.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:disabledFontStyles
	 */
	[Style(name="fontStyles",type="starling.text.TextFormat")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * label.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, between the label's top edge and the
	 * label's text.
	 *
	 * <p>In the following example, the top padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * label.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the label's right edge and
	 * the label's text.
	 *
	 * <p>In the following example, the right padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * label.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the label's bottom edge and
	 * the label's text.
	 *
	 * <p>In the following example, the bottom padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * label.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the label's left edge and the
	 * label's text.
	 *
	 * <p>In the following example, the left padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * label.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * Determines if the text wraps to the next line when it reaches the
	 * width (or max width) of the component.
	 *
	 * <p>In the following example, the label's text is wrapped:</p>
	 *
	 * <listing version="3.0">
	 * label.wordWrap = true;</listing>
	 *
	 * @default false
	 */
	[Style(name="wordWrap",type="Boolean")]

	/**
	 * Displays text using a text renderer.
	 *
	 * @see ../../../help/label.html How to use the Feathers Label component
	 * @see ../../../help/text-renderers.html Introduction to Feathers text renderers
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class Label extends FeathersControl implements ITextBaselineControl, IToolTip
	{
		/**
		 * The default value added to the <code>styleNameList</code> of the text
		 * renderer.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 * @see ../../../help/text-renderers.html Introduction to Feathers text renderers
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_TEXT_RENDERER:String = "feathers-label-text-renderer";

		/**
		 * An alternate style name to use with <code>Label</code> to allow a
		 * theme to give it a larger style meant for headings. If a theme does
		 * not provide a style for a heading label, the theme will automatically
		 * fall back to using the default style for a label.
		 *
		 * <p>An alternate style name should always be added to a component's
		 * <code>styleNameList</code> before the component is initialized. If
		 * the style name is added later, it will be ignored.</p>
		 *
		 * <p>In the following example, the heading style is applied to a label:</p>
		 *
		 * <listing version="3.0">
		 * var label:Label = new Label();
		 * label.text = "Very Important Heading";
		 * label.styleNameList.add( Label.ALTERNATE_STYLE_NAME_HEADING );
		 * this.addChild( label );</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_HEADING:String = "feathers-heading-label";

		/**
		 * An alternate style name to use with <code>Label</code> to allow a
		 * theme to give it a smaller style meant for less-important details. If
		 * a theme does not provide a style for a detail label, the theme will
		 * automatically fall back to using the default style for a label.
		 *
		 * <p>An alternate style name should always be added to a component's
		 * <code>styleNameList</code> before the component is initialized. If
		 * the style name is added later, it will be ignored.</p>
		 *
		 * <p>In the following example, the detail style is applied to a label:</p>
		 *
		 * <listing version="3.0">
		 * var label:Label = new Label();
		 * label.text = "Less important, detailed text";
		 * label.styleNameList.add( Label.ALTERNATE_STYLE_NAME_DETAIL );
		 * this.addChild( label );</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_DETAIL:String = "feathers-detail-label";

		/**
		 * An alternate style name to use with <code>Label</code> to allow a
		 * theme to give it a tool tip style for use with the tool tip manager.
		 * If a theme does not provide a style for a tool tip label, the theme
		 * will automatically fall back to using the default style for a label.
		 *
		 * <p>An alternate style name should always be added to a component's
		 * <code>styleNameList</code> before the component is initialized. If
		 * the style name is added later, it will be ignored.</p>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_TOOL_TIP:String = "feathers-tool-tip";

		/**
		 * The default <code>IStyleProvider</code> for all <code>Label</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function Label()
		{
			super();
			this.isQuickHitAreaEnabled = true;
			if(this._fontStylesSet === null)
			{
				this._fontStylesSet = new FontStylesSet();
				this._fontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
		}

		/**
		 * The value added to the <code>styleNameList</code> of the text
		 * renderer. This variable is <code>protected</code> so that sub-classes
		 * can customize the text renderer style name in their constructors
		 * instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_TEXT_RENDERER</code>.
		 *
		 * <p>To customize the text renderer style name without subclassing, see
		 * <code>customTextRendererStyleName</code>.</p>
		 *
		 * @see #style:customTextRendererStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var textRendererStyleName:String = DEFAULT_CHILD_STYLE_NAME_TEXT_RENDERER;

		/**
		 * The text renderer.
		 *
		 * @see #createTextRenderer()
		 * @see #textRendererFactory
		 */
		protected var textRenderer:ITextRenderer;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return Label.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _text:String = null;

		/**
		 * The text displayed by the label.
		 *
		 * <p>In the following example, the label's text is updated:</p>
		 *
		 * <listing version="3.0">
		 * label.text = "Hello World";</listing>
		 *
		 * @default null
		 */
		public function get text():String
		{
			return this._text;
		}

		/**
		 * @private
		 */
		public function set text(value:String):void
		{
			if(this._text == value)
			{
				return;
			}
			this._text = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _wordWrap:Boolean = false;

		/**
		 * @private
		 */
		public function get wordWrap():Boolean
		{
			return this._wordWrap;
		}

		/**
		 * @private
		 */
		public function set wordWrap(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._wordWrap === value)
			{
				return;
			}
			this._wordWrap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * The baseline measurement of the text, in pixels.
		 */
		public function get baseline():Number
		{
			if(!this.textRenderer)
			{
				return this.scaledActualHeight;
			}
			return this.scaleY * (this.textRenderer.y + this.textRenderer.baseline);
		}

		/**
		 * The number of text lines displayed by the label. The component may
		 * contain multiple text lines if the text contains line breaks or if
		 * the <code>wordWrap</code> property is enabled.
		 *
		 * @see #wordWrap
		 */
		public function get numLines():int
		{
			if(this.textRenderer === null)
			{
				return 0;
			}
			return this.textRenderer.numLines;
		}

		/**
		 * @private
		 */
		protected var _textRendererFactory:Function;

		/**
		 * A function used to instantiate the label's text renderer
		 * sub-component. By default, the label will use the global text
		 * renderer factory, <code>FeathersControl.defaultTextRendererFactory()</code>,
		 * to create the text renderer. The text renderer must be an instance of
		 * <code>ITextRenderer</code>. This factory can be used to change
		 * properties on the text renderer when it is first created. For
		 * instance, if you are skinning Feathers components without a theme,
		 * you might use this factory to style the text renderer.
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():ITextRenderer</pre>
		 *
		 * <p>In the following example, a custom text renderer factory is passed
		 * to the label:</p>
		 *
		 * <listing version="3.0">
		 * label.textRendererFactory = function():ITextRenderer
		 * {
		 *     return new TextFieldTextRenderer();
		 * }</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.ITextRenderer
		 * @see feathers.core.FeathersControl#defaultTextRendererFactory
		 */
		public function get textRendererFactory():Function
		{
			return this._textRendererFactory;
		}

		/**
		 * @private
		 */
		public function set textRendererFactory(value:Function):void
		{
			if(this._textRendererFactory == value)
			{
				return;
			}
			this._textRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _customTextRendererStyleName:String;

		/**
		 * @private
		 */
		public function get customTextRendererStyleName():String
		{
			return this._customTextRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customTextRendererStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customTextRendererStyleName === value)
			{
				return;
			}
			this._customTextRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _fontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get fontStyles():TextFormat
		{
			return this._fontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set fontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get disabledFontStyles():TextFormat
		{
			return this._fontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set disabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _textRendererProperties:PropertyProxy;

		/**
		 * An object that stores properties for the label's text renderer
		 * sub-component, and the properties will be passed down to the text
		 * renderer when the label validates. The available properties
		 * depend on which <code>ITextRenderer</code> implementation is returned
		 * by <code>textRendererFactory</code>. Refer to
		 * <a href="../core/ITextRenderer.html"><code>feathers.core.ITextRenderer</code></a>
		 * for a list of available text renderer implementations.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>textRendererFactory</code> function
		 * instead of using <code>textRendererProperties</code> will result in
		 * better performance.</p>
		 *
		 * <p>In the following example, the label's text renderer's properties
		 * are updated (this example assumes that the label text renderer is a
		 * <code>TextFieldTextRenderer</code>):</p>
		 *
		 * <listing version="3.0">
		 * label.textRendererProperties.textFormat = new TextFormat( "Source Sans Pro", 16, 0x333333 );
		 * label.textRendererProperties.embedFonts = true;</listing>
		 *
		 * @default null
		 *
		 * @see #textRendererFactory
		 * @see feathers.core.ITextRenderer
		 */
		public function get textRendererProperties():Object
		{
			if(!this._textRendererProperties)
			{
				this._textRendererProperties = new PropertyProxy(textRendererProperties_onChange);
			}
			return this._textRendererProperties;
		}

		/**
		 * @private
		 */
		public function set textRendererProperties(value:Object):void
		{
			if(this._textRendererProperties == value)
			{
				return;
			}
			if(value && !(value is PropertyProxy))
			{
				value = PropertyProxy.fromObject(value);
			}
			if(this._textRendererProperties)
			{
				this._textRendererProperties.removeOnChangeCallback(textRendererProperties_onChange);
			}
			this._textRendererProperties = PropertyProxy(value);
			if(this._textRendererProperties)
			{
				this._textRendererProperties.addOnChangeCallback(textRendererProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _explicitTextRendererWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitTextRendererHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitTextRendererMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitTextRendererMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitTextRendererMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitTextRendererMaxHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxHeight:Number;

		/**
		 * @private
		 */
		protected var currentBackgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		protected var _backgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundSkin():DisplayObject
		{
			return this._backgroundSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundSkin === value)
			{
				return;
			}
			if(this._backgroundSkin !== null &&
				this.currentBackgroundSkin === this._backgroundSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _backgroundDisabledSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundDisabledSkin():DisplayObject
		{
			return this._backgroundDisabledSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundDisabledSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundDisabledSkin !== null &&
				this.currentBackgroundSkin == this._backgroundDisabledSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundDisabledSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundDisabledSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			//we don't dispose it if the label is the parent because it'll
			//already get disposed in super.dispose()
			if(this._backgroundSkin !== null &&
				this._backgroundSkin.parent !== this)
			{
				this._backgroundSkin.dispose();
			}
			if(this._backgroundDisabledSkin !== null &&
				this._backgroundDisabledSkin.parent !== this)
			{
				this._backgroundDisabledSkin.dispose();
			}
			if(this._fontStylesSet !== null)
			{
				this._fontStylesSet.dispose();
				this._fontStylesSet = null;
			}
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var textRendererInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_TEXT_RENDERER);

			if(sizeInvalid || stylesInvalid || stateInvalid)
			{
				this.refreshBackgroundSkin();
			}

			if(textRendererInvalid)
			{
				this.createTextRenderer();
			}

			if(textRendererInvalid || dataInvalid || stateInvalid)
			{
				this.refreshTextRendererData();
			}

			if(textRendererInvalid || stateInvalid)
			{
				this.refreshEnabled();
			}

			if(textRendererInvalid || stylesInvalid)
			{
				this.refreshTextRendererStyles();
			}

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			this.layoutChildren();
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			resetFluidChildDimensionsForMeasurement(DisplayObject(this.textRenderer),
				this._explicitWidth - this._paddingLeft - this._paddingRight,
				this._explicitHeight - this._paddingTop - this._paddingBottom,
				this._explicitMinWidth - this._paddingLeft - this._paddingRight,
				this._explicitMinHeight - this._paddingTop - this._paddingBottom,
				this._explicitMaxWidth - this._paddingLeft - this._paddingRight,
				this._explicitMaxHeight - this._paddingTop - this._paddingBottom,
				this._explicitTextRendererWidth, this._explicitTextRendererHeight,
				this._explicitTextRendererMinWidth, this._explicitTextRendererMinHeight,
				this._explicitTextRendererMaxWidth, this._explicitTextRendererMaxHeight);
			this.textRenderer.maxWidth = this._explicitMaxWidth - this._paddingLeft - this._paddingRight;
			this.textRenderer.maxHeight = this._explicitMaxHeight - this._paddingTop - this._paddingBottom;
			var point:Point = Pool.getPoint();
			this.textRenderer.measureText(point);

			var measureBackground:IMeasureDisplayObject = this.currentBackgroundSkin as IMeasureDisplayObject;
			resetFluidChildDimensionsForMeasurement(this.currentBackgroundSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitBackgroundWidth, this._explicitBackgroundHeight,
				this._explicitBackgroundMinWidth, this._explicitBackgroundMinHeight,
				this._explicitBackgroundMaxWidth, this._explicitBackgroundMaxHeight);
			if(this.currentBackgroundSkin is IValidating)
			{
				IValidating(this.currentBackgroundSkin).validate();
			}

			//minimum dimensions
			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				//if we don't have an explicitWidth, then the minimum width
				//should be small to allow wrapping or truncation
				if(this._text && !needsWidth)
				{
					newMinWidth = point.x;
				}
				else
				{
					newMinWidth = 0;
				}
				newMinWidth += this._paddingLeft + this._paddingRight;
				var backgroundMinWidth:Number = 0;
				if(measureBackground !== null)
				{
					backgroundMinWidth = measureBackground.minWidth;
				}
				else if(this.currentBackgroundSkin !== null)
				{
					backgroundMinWidth = this._explicitBackgroundMinWidth;
				}
				if(backgroundMinWidth > newMinWidth)
				{
					newMinWidth = backgroundMinWidth;
				}
			}
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				if(this._text)
				{
					newMinHeight = point.y;
				}
				else
				{
					newMinHeight = 0;
				}
				newMinHeight += this._paddingTop + this._paddingBottom;
				var backgroundMinHeight:Number = 0;
				if(measureBackground !== null)
				{
					backgroundMinHeight = measureBackground.minHeight;
				}
				else if(this.currentBackgroundSkin !== null)
				{
					backgroundMinHeight = this._explicitBackgroundMinHeight;
				}
				if(backgroundMinHeight > newMinHeight)
				{
					newMinHeight = backgroundMinHeight;
				}
			}

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				if(this._text)
				{
					newWidth = point.x;
				}
				else
				{
					newWidth = 0;
				}
				newWidth += this._paddingLeft + this._paddingRight;
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.width > newWidth)
				{
					newWidth = this.currentBackgroundSkin.width;
				}
			}

			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				if(this._text)
				{
					newHeight = point.y;
				}
				else
				{
					newHeight = 0;
				}
				newHeight += this._paddingTop + this._paddingBottom;
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.height > newHeight) //!isNaN
				{
					newHeight = this.currentBackgroundSkin.height;
				}
			}

			Pool.putPoint(point);

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * Creates and adds the <code>textRenderer</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #textRenderer
		 * @see #textRendererFactory
		 */
		protected function createTextRenderer():void
		{
			if(this.textRenderer !== null)
			{
				this.removeChild(DisplayObject(this.textRenderer), true);
				this.textRenderer = null;
			}

			var factory:Function = this._textRendererFactory != null ? this._textRendererFactory : FeathersControl.defaultTextRendererFactory;
			this.textRenderer = ITextRenderer(factory());
			var textRendererStyleName:String = this._customTextRendererStyleName != null ? this._customTextRendererStyleName : this.textRendererStyleName;
			this.textRenderer.styleNameList.add(textRendererStyleName);
			this.addChild(DisplayObject(this.textRenderer));

			this.textRenderer.initializeNow();
			this._explicitTextRendererWidth = this.textRenderer.explicitWidth;
			this._explicitTextRendererHeight = this.textRenderer.explicitHeight;
			this._explicitTextRendererMinWidth = this.textRenderer.explicitMinWidth;
			this._explicitTextRendererMinHeight = this.textRenderer.explicitMinHeight;
			this._explicitTextRendererMaxWidth = this.textRenderer.explicitMaxWidth;
			this._explicitTextRendererMaxHeight = this.textRenderer.explicitMaxHeight;
		}

		/**
		 * Choose the appropriate background skin based on the control's current
		 * state.
		 */
		protected function refreshBackgroundSkin():void
		{
			var newCurrentBackgroundSkin:DisplayObject = this._backgroundSkin;
			if(!this._isEnabled && this._backgroundDisabledSkin !== null)
			{
				newCurrentBackgroundSkin = this._backgroundDisabledSkin;
			}
			if(this.currentBackgroundSkin !== newCurrentBackgroundSkin)
			{
				this.removeCurrentBackgroundSkin(this.currentBackgroundSkin);
				this.currentBackgroundSkin = newCurrentBackgroundSkin;
				if(this.currentBackgroundSkin !== null)
				{
					if(this.currentBackgroundSkin is IFeathersControl)
					{
						IFeathersControl(this.currentBackgroundSkin).initializeNow();
					}
					if(this.currentBackgroundSkin is IMeasureDisplayObject)
					{
						var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this.currentBackgroundSkin);
						this._explicitBackgroundWidth = measureSkin.explicitWidth;
						this._explicitBackgroundHeight = measureSkin.explicitHeight;
						this._explicitBackgroundMinWidth = measureSkin.explicitMinWidth;
						this._explicitBackgroundMinHeight = measureSkin.explicitMinHeight;
						this._explicitBackgroundMaxWidth = measureSkin.explicitMaxWidth;
						this._explicitBackgroundMaxHeight = measureSkin.explicitMaxHeight;
					}
					else
					{
						this._explicitBackgroundWidth = this.currentBackgroundSkin.width;
						this._explicitBackgroundHeight = this.currentBackgroundSkin.height;
						this._explicitBackgroundMinWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMinHeight = this._explicitBackgroundHeight;
						this._explicitBackgroundMaxWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMaxHeight = this._explicitBackgroundHeight;
					}
					this.addChildAt(this.currentBackgroundSkin, 0);
				}
			}
		}

		/**
		 * @private
		 */
		protected function removeCurrentBackgroundSkin(skin:DisplayObject):void
		{
			if(skin === null)
			{
				return;
			}
			if(skin.parent === this)
			{
				//we need to restore these values so that they won't be lost the
				//next time that this skin is used for measurement
				skin.width = this._explicitBackgroundWidth;
				skin.height = this._explicitBackgroundHeight;
				if(skin is IMeasureDisplayObject)
				{
					var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(skin);
					measureSkin.minWidth = this._explicitBackgroundMinWidth;
					measureSkin.minHeight = this._explicitBackgroundMinHeight;
					measureSkin.maxWidth = this._explicitBackgroundMaxWidth;
					measureSkin.maxHeight = this._explicitBackgroundMaxHeight;
				}
				skin.removeFromParent(false);
			}
		}

		/**
		 * Positions and sizes children based on the actual width and height
		 * values.
		 */
		protected function layoutChildren():void
		{
			if(this.currentBackgroundSkin !== null)
			{
				this.currentBackgroundSkin.x = 0;
				this.currentBackgroundSkin.y = 0;
				this.currentBackgroundSkin.width = this.actualWidth;
				this.currentBackgroundSkin.height = this.actualHeight;
			}
			this.textRenderer.x = this._paddingLeft;
			this.textRenderer.y = this._paddingTop;
			this.textRenderer.width = this.actualWidth - this._paddingLeft - this._paddingRight;
			this.textRenderer.height = this.actualHeight - this._paddingTop - this._paddingBottom;
			this.textRenderer.validate();
		}

		/**
		 * @private
		 */
		protected function refreshEnabled():void
		{
			this.textRenderer.isEnabled = this._isEnabled;
		}

		/**
		 * @private
		 */
		protected function refreshTextRendererData():void
		{
			this.textRenderer.text = this._text;
			this.textRenderer.visible = this._text && this._text.length > 0;
		}

		/**
		 * @private
		 */
		protected function refreshTextRendererStyles():void
		{
			this.textRenderer.fontStyles = this._fontStylesSet;
			this.textRenderer.wordWrap = this._wordWrap;
			for(var propertyName:String in this._textRendererProperties)
			{
				var propertyValue:Object = this._textRendererProperties[propertyName];
				this.textRenderer[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function fontStyles_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function textRendererProperties_onChange(proxy:PropertyProxy, propertyName:String):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}
	}
}


================================================
FILE: source/feathers/controls/LayoutGroup.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IValidating;
	import feathers.events.FeathersEventType;
	import feathers.layout.ILayout;
	import feathers.layout.ILayoutDisplayObject;
	import feathers.layout.IVirtualLayout;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.ViewPortBounds;
	import feathers.skins.IStyleProvider;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;

	import flash.geom.Point;

	import starling.core.starling_internal;
	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.filters.FragmentFilter;
	import starling.rendering.Painter;

	/**
	 * The background to display behind all content when the layout group is
	 * disabled. The background skin is resized to fill the full width and
	 * height of the layout group.
	 *
	 * <p>In the following example, the group is given a background skin:</p>
	 *
	 * <listing version="3.0">
	 * group.backgroundDisabledSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundSkin
	 */
	[Style(name="backgroundDisabledSkin",type="starling.display.DisplayObject")]

	/**
	 * The default background to display behind all content. The background
	 * skin is resized to fill the full width and height of the layout
	 * group.
	 *
	 * <p>In the following example, the group is given a background skin:</p>
	 *
	 * <listing version="3.0">
	 * group.backgroundSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundDisabledSkin
	 */
	[Style(name="backgroundSkin",type="starling.display.DisplayObject")]

	/**
	 * If true, the group will be clipped to its bounds. In other words,
	 * anything appearing beyond the edges of the group will be masked or
	 * hidden.
	 *
	 * <p>Since <code>LayoutGroup</code> is designed to be a light
	 * container focused on performance, clipping is disabled by default.</p>
	 *
	 * <p>In the following example, clipping is enabled:</p>
	 *
	 * <listing version="3.0">
	 * group.clipContent = true;</listing>
	 *
	 * @default false
	 */
	[Style(name="clipContent",type="Boolean")]

	/**
	 * Controls the way that the group's children are positioned and sized.
	 *
	 * <p>The following example tells the group to use a horizontal layout:</p>
	 *
	 * <listing version="3.0">
	 * var layout:HorizontalLayout = new HorizontalLayout();
	 * layout.gap = 20;
	 * layout.padding = 20;
	 * container.layout = layout;</listing>
	 *
	 * @default null
	 */
	[Style(name="layout",type="feathers.layout.ILayout")]

	/**
	 * A generic container that supports layout. For a container that supports
	 * scrolling and more robust skinning options, see <code>ScrollContainer</code>.
	 *
	 * <p>The following example creates a layout group with a horizontal
	 * layout and adds two buttons to it:</p>
	 *
	 * <listing version="3.0">
	 * var group:LayoutGroup = new LayoutGroup();
	 * var layout:HorizontalLayout = new HorizontalLayout();
	 * layout.gap = 20;
	 * layout.padding = 20;
	 * group.layout = layout;
	 * this.addChild( group );
	 * 
	 * var yesButton:Button = new Button();
	 * yesButton.label = "Yes";
	 * group.addChild( yesButton );
	 * 
	 * var noButton:Button = new Button();
	 * noButton.label = "No";
	 * group.addChild( noButton );</listing>
	 *
	 * @see ../../../help/layout-group.html How to use the Feathers LayoutGroup component
	 * @see feathers.controls.ScrollContainer
	 *
	 * @productversion Feathers 1.2.0
	 */
	public class LayoutGroup extends FeathersControl
	{
		/**
		 * Flag to indicate that the clipping has changed.
		 */
		protected static const INVALIDATION_FLAG_CLIPPING:String = "clipping";

		/**
		 * An alternate style name to use with <code>LayoutGroup</code> to
		 * allow a theme to give it a toolbar style. If a theme does not provide
		 * a style for the toolbar container, the theme will automatically fall
		 * back to using the default scroll container skin.
		 *
		 * <p>An alternate style name should always be added to a component's
		 * <code>styleNameList</code> before the component is initialized. If
		 * the style name is added later, it will be ignored.</p>
		 *
		 * <p>In the following example, the toolbar style is applied to a layout
		 * group:</p>
		 *
		 * <listing version="3.0">
		 * var group:LayoutGroup = new LayoutGroup();
		 * group.styleNameList.add( LayoutGroup.ALTERNATE_STYLE_NAME_TOOLBAR );
		 * this.addChild( group );</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_TOOLBAR:String = "feathers-toolbar-layout-group";

		/**
		 * The default <code>IStyleProvider</code> for all <code>LayoutGroup</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function LayoutGroup()
		{
			super();
			this.addEventListener(Event.ADDED_TO_STAGE, layoutGroup_addedToStageHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, layoutGroup_removedFromStageHandler);
		}

		/**
		 * The items added to the group.
		 */
		protected var items:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * The view port bounds result object passed to the layout. Its values
		 * should be set in <code>refreshViewPortBounds()</code>.
		 */
		protected var viewPortBounds:ViewPortBounds = new ViewPortBounds();

		/**
		 * @private
		 */
		protected var _layoutResult:LayoutBoundsResult = new LayoutBoundsResult();

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return LayoutGroup.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _layout:ILayout;

		/**
		 * @private
		 */
		public function get layout():ILayout
		{
			return this._layout;
		}

		/**
		 * @private
		 */
		public function set layout(value:ILayout):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._layout == value)
			{
				return;
			}
			if(this._layout)
			{
				this._layout.removeEventListener(Event.CHANGE, layout_changeHandler);
			}
			this._layout = value;
			if(this._layout)
			{
				if(this._layout is IVirtualLayout)
				{
					IVirtualLayout(this._layout).useVirtualLayout = false;
				}
				this._layout.addEventListener(Event.CHANGE, layout_changeHandler);
				//if we don't have a layout, nothing will need to be redrawn
				this.invalidate(INVALIDATION_FLAG_LAYOUT);
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _clipContent:Boolean = false;

		/**
		 * @private
		 */
		public function get clipContent():Boolean
		{
			return this._clipContent;
		}

		/**
		 * @private
		 */
		public function set clipContent(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._clipContent === value)
			{
				return;
			}
			this._clipContent = value;
			if(!value)
			{
				this.mask = null;
			}
			this.invalidate(INVALIDATION_FLAG_CLIPPING);
		}

		/**
		 * @private
		 */
		protected var _explicitBackgroundWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxHeight:Number;

		/**
		 * @private
		 */
		protected var currentBackgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		protected var _backgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundSkin():DisplayObject
		{
			return this._backgroundSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundSkin === value)
			{
				return;
			}
			if(this._backgroundSkin !== null &&
				this.currentBackgroundSkin === this._backgroundSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundSkin = value;
			this.invalidate(INVALIDATION_FLAG_SKIN);
		}

		/**
		 * @private
		 */
		protected var _backgroundDisabledSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundDisabledSkin():DisplayObject
		{
			return this._backgroundDisabledSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundDisabledSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundDisabledSkin === value)
			{
				return;
			}
			if(this._backgroundDisabledSkin !== null &&
				this.currentBackgroundSkin === this._backgroundDisabledSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundDisabledSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundDisabledSkin = value;
			this.invalidate(INVALIDATION_FLAG_SKIN);
		}

		/**
		 * @private
		 */
		protected var _autoSizeMode:String = AutoSizeMode.CONTENT;

		[Inspectable(type="String",enumeration="stage,content")]
		/**
		 * Determines how the layout group will set its own size when its
		 * dimensions (width and height) aren't set explicitly.
		 *
		 * <p>In the following example, the layout group will be sized to
		 * match the stage:</p>
		 *
		 * <listing version="3.0">
		 * group.autoSizeMode = AutoSizeMode.STAGE;</listing>
		 *
		 * <p>Usually defaults to <code>AutoSizeMode.CONTENT</code>. However, if
		 * this component is the root of the Starling display list, defaults to
		 * <code>AutoSizeMode.STAGE</code> instead.</p>
		 *
		 * @see feathers.controls.AutoSizeMode#STAGE
		 * @see feathers.controls.AutoSizeMode#CONTENT
		 */
		public function get autoSizeMode():String
		{
			return this._autoSizeMode;
		}

		/**
		 * @private
		 */
		public function set autoSizeMode(value:String):void
		{
			if(this._autoSizeMode == value)
			{
				return;
			}
			this._autoSizeMode = value;
			if(this.stage !== null)
			{
				if(this._autoSizeMode === AutoSizeMode.STAGE)
				{
					this.stage.addEventListener(Event.RESIZE, stage_resizeHandler);
				}
				else
				{
					this.stage.removeEventListener(Event.RESIZE, stage_resizeHandler);
				}
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _ignoreChildChanges:Boolean = false;

		/**
		 * @private
		 * This is similar to _ignoreChildChanges, but setInvalidationFlag()
		 * may still be called.
		 */
		protected var _ignoreChildChangesButSetFlags:Boolean = false;

		/**
		 * @private
		 */
		override public function addChildAt(child:DisplayObject, index:int):DisplayObject
		{
			if(child is IFeathersControl)
			{
				child.addEventListener(FeathersEventType.RESIZE, child_resizeHandler);
			}
			if(child is ILayoutDisplayObject)
			{
				child.addEventListener(FeathersEventType.LAYOUT_DATA_CHANGE, child_layoutDataChangeHandler);
			}
			var oldIndex:int = this.items.indexOf(child);
			if(oldIndex == index)
			{
				return child;
			}
			if(oldIndex >= 0)
			{
				this.items.removeAt(oldIndex);
			}
			this.items.insertAt(index, child);
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
			return super.addChildAt(child, index);
		}

		/**
		 * @private
		 */
		override public function removeChildAt(index:int, dispose:Boolean = false):DisplayObject
		{
			if(index >= 0 && index < this.items.length)
			{
				this.items.removeAt(index);
			}
			var child:DisplayObject = super.removeChildAt(index, dispose);
			if(child is IFeathersControl)
			{
				child.removeEventListener(FeathersEventType.RESIZE, child_resizeHandler);
			}
			if(child is ILayoutDisplayObject)
			{
				child.removeEventListener(FeathersEventType.LAYOUT_DATA_CHANGE, child_layoutDataChangeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
			return child;
		}

		/**
		 * @private
		 */
		override public function setChildIndex(child:DisplayObject, index:int):void
		{
			super.setChildIndex(child, index);
			var oldIndex:int = this.items.indexOf(child);
			if(oldIndex == index)
			{
				return;
			}
			//the super function already checks if oldIndex < 0, and throws an
			//appropriate error, so no need to do it again!

			this.items.removeAt(oldIndex);
			this.items.insertAt(index, child);
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		override public function swapChildrenAt(index1:int, index2:int):void
		{
			super.swapChildrenAt(index1, index2);
			var child1:DisplayObject = this.items[index1];
			var child2:DisplayObject = this.items[index2];
			this.items[index1] = child2;
			this.items[index2] = child1;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		override public function sortChildren(compareFunction:Function):void
		{
			super.sortChildren(compareFunction);
			this.items.sort(compareFunction);
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		override public function hitTest(localPoint:Point):DisplayObject
		{
			var localX:Number = localPoint.x;
			var localY:Number = localPoint.y;
			var result:DisplayObject = super.hitTest(localPoint);
			if(result)
			{
				if(!this._isEnabled)
				{
					return this;
				}
				return result;
			}
			if(!this.visible || !this.touchable)
			{
				return null;
			}
			if(this.currentBackgroundSkin && this._hitArea.contains(localX, localY))
			{
				return this;
			}
			return null;
		}

		/**
		 * @private
		 */
		override public function render(painter:Painter):void
		{
			if(this.currentBackgroundSkin !== null &&
				this.currentBackgroundSkin.visible &&
				this.currentBackgroundSkin.alpha > 0)
			{
				//render() won't be called unless the LayoutGroup requires a
				//redraw, so it's not a performance issue to set this flag on
				//the background skin.
				//this is needed to ensure that the background skin position and
				//things are properly updated when the LayoutGroup is
				//transformed
				this.currentBackgroundSkin.setRequiresRedraw();

				var mask:DisplayObject = this.currentBackgroundSkin.mask;
				var filter:FragmentFilter = this.currentBackgroundSkin.filter;
				painter.pushState();
				painter.setStateTo(this.currentBackgroundSkin.transformationMatrix, this.currentBackgroundSkin.alpha, this.currentBackgroundSkin.blendMode);
				if(mask !== null)
				{
					painter.drawMask(mask);
				}
				if(filter !== null)
				{
					filter.render(painter);
				}
				else
				{
					this.currentBackgroundSkin.render(painter);
				}
				if(mask !== null)
				{
					painter.eraseMask(mask);
				}
				painter.popState();
			}
			super.render(painter);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this.currentBackgroundSkin !== null)
			{
				this.currentBackgroundSkin.starling_internal::setParent(null);
			}
			//we don't dispose it if the group is the parent because it'll
			//already get disposed in super.dispose()
			if(this._backgroundSkin !== null &&
				this._backgroundSkin.parent !== this)
			{
				this._backgroundSkin.dispose();
			}
			if(this._backgroundDisabledSkin !== null &&
				this._backgroundDisabledSkin.parent !== this)
			{
				this._backgroundDisabledSkin.dispose();
			}
			this.layout = null;
			super.dispose();
		}

		/**
		 * Readjusts the layout of the group according to its current content.
		 * Call this method when changes to the content cannot be automatically
		 * detected by the container. For instance, Feathers components dispatch
		 * <code>FeathersEventType.RESIZE</code> when their width and height
		 * values change, but standard Starling display objects like
		 * <code>Sprite</code> and <code>Image</code> do not.
		 */
		public function readjustLayout():void
		{
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		override public function validate():void
		{
			//for the start of validation, we're going to ignore when children
			//resize or dispatch changes to layout data. this allows subclasses
			//to modify children in draw() before the layout is applied.
			var oldIgnoreChildChanges:Boolean = this._ignoreChildChangesButSetFlags;
			this._ignoreChildChangesButSetFlags = true;
			super.validate();
			//if super.validate() returns without calling draw(), the flag
			//won't be reset before layout is called, so we need reset manually.
			this._ignoreChildChangesButSetFlags = oldIgnoreChildChanges;
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(this.stage !== null)
			{
				//we use starling.root because a pop-up's root and the stage
				//root may be different.
				if(this.stage.starling.root === this)
				{
					this.autoSizeMode = AutoSizeMode.STAGE;
				}
			}
			super.initialize();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			//children are allowed to change during draw() in a subclass up
			//until it calls super.draw().
			this._ignoreChildChangesButSetFlags = false;

			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var clippingInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_CLIPPING);
			//we don't have scrolling, but a subclass might
			var scrollInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SCROLL);
			var skinInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SKIN);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);

			//scrolling only affects the layout is requiresLayoutOnScroll is true
			if(!layoutInvalid && scrollInvalid && this._layout && this._layout.requiresLayoutOnScroll)
			{
				layoutInvalid = true;
			}

			if(skinInvalid || stateInvalid)
			{
				this.refreshBackgroundSkin();
			}

			if(sizeInvalid || layoutInvalid || skinInvalid || stateInvalid)
			{
				this.refreshViewPortBounds();
				if(this._layout)
				{
					var oldIgnoreChildChanges:Boolean = this._ignoreChildChanges;
					this._ignoreChildChanges = true;
					this._layout.layout(this.items, this.viewPortBounds, this._layoutResult);
					this._ignoreChildChanges = oldIgnoreChildChanges;
				}
				else
				{
					this.handleManualLayout();
				}
				this.handleLayoutResult();
				this.refreshBackgroundLayout();

				//final validation to avoid juggler next frame issues
				this.validateChildren();
			}

			if(sizeInvalid || clippingInvalid)
			{
				this.refreshClipRect();
			}
		}

		/**
		 * Choose the appropriate background skin based on the control's current
		 * state.
		 */
		protected function refreshBackgroundSkin():void
		{
			var oldBackgroundSkin:DisplayObject = this.currentBackgroundSkin;
			this.currentBackgroundSkin = this.getCurrentBackgroundSkin();
			if(this.currentBackgroundSkin !== oldBackgroundSkin)
			{
				this.removeCurrentBackgroundSkin(oldBackgroundSkin);
				if(this.currentBackgroundSkin !== null)
				{
					if(this.currentBackgroundSkin is IFeathersControl)
					{
						IFeathersControl(this.currentBackgroundSkin).initializeNow();
					}
					if(this.currentBackgroundSkin is IMeasureDisplayObject)
					{
						var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this.currentBackgroundSkin);
						this._explicitBackgroundWidth = measureSkin.explicitWidth;
						this._explicitBackgroundHeight = measureSkin.explicitHeight;
						this._explicitBackgroundMinWidth = measureSkin.explicitMinWidth;
						this._explicitBackgroundMinHeight = measureSkin.explicitMinHeight;
						this._explicitBackgroundMaxWidth = measureSkin.explicitMaxWidth;
						this._explicitBackgroundMaxHeight = measureSkin.explicitMaxHeight;
					}
					else
					{
						this._explicitBackgroundWidth = this.currentBackgroundSkin.width;
						this._explicitBackgroundHeight = this.currentBackgroundSkin.height;
						this._explicitBackgroundMinWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMinHeight = this._explicitBackgroundHeight;
						this._explicitBackgroundMaxWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMaxHeight = this._explicitBackgroundHeight;
					}
					this.currentBackgroundSkin.starling_internal::setParent(this);
				}
			}
		}

		/**
		 * @private
		 */
		protected function removeCurrentBackgroundSkin(skin:DisplayObject):void
		{
			if(skin === null)
			{
				return;
			}
			if(skin.parent === this)
			{
				//we need to restore these values so that they won't be lost the
				//next time that this skin is used for measurement
				skin.width = this._explicitBackgroundWidth;
				skin.height = this._explicitBackgroundHeight;
				if(skin is IMeasureDisplayObject)
				{
					var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(skin);
					measureSkin.minWidth = this._explicitBackgroundMinWidth;
					measureSkin.minHeight = this._explicitBackgroundMinHeight;
					measureSkin.maxWidth = this._explicitBackgroundMaxWidth;
					measureSkin.maxHeight = this._explicitBackgroundMaxHeight;
				}
				this.setRequiresRedraw();
				skin.starling_internal::setParent(null);
			}
		}

		/**
		 * @private
		 */
		protected function getCurrentBackgroundSkin():DisplayObject
		{
			if(!this._isEnabled && this._backgroundDisabledSkin !== null)
			{
				return this._backgroundDisabledSkin;
			}
			return this._backgroundSkin;
		}

		/**
		 * @private
		 */
		protected function refreshBackgroundLayout():void
		{
			if(this.currentBackgroundSkin === null)
			{
				return;
			}
			if(this.currentBackgroundSkin.width != this.actualWidth ||
				this.currentBackgroundSkin.height != this.actualHeight)
			{
				this.currentBackgroundSkin.width = this.actualWidth;
				this.currentBackgroundSkin.height = this.actualHeight;
			}
		}

		/**
		 * Refreshes the values in the <code>viewPortBounds</code> variable that
		 * is passed to the layout.
		 */
		protected function refreshViewPortBounds():void
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN

			resetFluidChildDimensionsForMeasurement(this.currentBackgroundSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitBackgroundWidth, this._explicitBackgroundHeight,
				this._explicitBackgroundMinWidth, this._explicitBackgroundMinHeight,
				this._explicitBackgroundMaxWidth, this._explicitBackgroundMaxHeight);

			this.viewPortBounds.x = 0;
			this.viewPortBounds.y = 0;
			this.viewPortBounds.scrollX = 0;
			this.viewPortBounds.scrollY = 0;
			if(needsWidth && this._autoSizeMode === AutoSizeMode.STAGE &&
				this.stage !== null)
			{
				this.viewPortBounds.explicitWidth = this.stage.stageWidth;
			}
			else
			{
				this.viewPortBounds.explicitWidth = this._explicitWidth;
			}
			if(needsHeight && this._autoSizeMode === AutoSizeMode.STAGE &&
				this.stage !== null)
			{
				this.viewPortBounds.explicitHeight = this.stage.stageHeight;
			}
			else
			{
				this.viewPortBounds.explicitHeight = this._explicitHeight;
			}
			var viewPortMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				viewPortMinWidth = 0;
			}
			var viewPortMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				viewPortMinHeight = 0;
			}
			if(this.currentBackgroundSkin !== null)
			{
				//because the layout might need it, we account for the
				//dimensions of the background skin when determining the minimum
				//dimensions of the view port.
				//we can't use the minimum dimensions of the background skin
				if(this.currentBackgroundSkin.width > viewPortMinWidth)
				{
					viewPortMinWidth = this.currentBackgroundSkin.width;
				}
				if(this.currentBackgroundSkin.height > viewPortMinHeight)
				{
					viewPortMinHeight = this.currentBackgroundSkin.height;
				}
			}
			this.viewPortBounds.minWidth = viewPortMinWidth;
			this.viewPortBounds.minHeight = viewPortMinHeight;
			this.viewPortBounds.maxWidth = this._explicitMaxWidth;
			this.viewPortBounds.maxHeight = this._explicitMaxHeight;
		}

		/**
		 * @private
		 */
		protected function handleLayoutResult():void
		{
			//the layout's dimensions are also the minimum dimensions
			//we calculate the minimum dimensions for the background skin in
			//refreshViewPortBounds() and let the layout handle it
			var viewPortWidth:Number = this._layoutResult.viewPortWidth;
			var viewPortHeight:Number = this._layoutResult.viewPortHeight;
			this.saveMeasurements(viewPortWidth, viewPortHeight,
				viewPortWidth, viewPortHeight);
		}

		/**
		 * @private
		 */
		protected function handleManualLayout():void
		{
			var maxX:Number = this.viewPortBounds.explicitWidth;
			if(maxX !== maxX) //isNaN
			{
				maxX = 0;
			}
			var maxY:Number = this.viewPortBounds.explicitHeight;
			if(maxY !== maxY) //isNaN
			{
				maxY = 0;
			}
			var oldIgnoreChildChanges:Boolean = this._ignoreChildChanges;
			this._ignoreChildChanges = true;
			var itemCount:int = this.items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = this.items[i];
				if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
				{
					continue;
				}
				if(item is IValidating)
				{
					IValidating(item).validate();
				}
				var itemMaxX:Number = item.x - item.pivotX + item.width;
				var itemMaxY:Number = item.y - item.pivotY + item.height;
				if(itemMaxX === itemMaxX && //!isNaN
					itemMaxX > maxX)
				{
					maxX = itemMaxX;
				}
				if(itemMaxY === itemMaxY && //!isNaN
					itemMaxY > maxY)
				{
					maxY = itemMaxY;
				}
			}
			this._ignoreChildChanges = oldIgnoreChildChanges;
			this._layoutResult.contentX = 0;
			this._layoutResult.contentY = 0;
			this._layoutResult.contentWidth = maxX;
			this._layoutResult.contentHeight = maxY;
			if(this.viewPortBounds.explicitWidth === this.viewPortBounds.explicitWidth) //!isNaN
			{
				this._layoutResult.viewPortWidth = this.viewPortBounds.explicitWidth;
			}
			else
			{
				var viewPortMinWidth:Number = this.viewPortBounds.minWidth;
				if(maxX < viewPortMinWidth)
				{
					maxX = viewPortMinWidth;
				}
				var viewPortMaxWidth:Number = this.viewPortBounds.maxWidth;
				if(maxX > viewPortMaxWidth)
				{
					maxX = viewPortMaxWidth;
				}
				this._layoutResult.viewPortWidth = maxX;
			}
			if(this.viewPortBounds.explicitHeight === this.viewPortBounds.explicitHeight)
			{
				this._layoutResult.viewPortHeight = this.viewPortBounds.explicitHeight;
			}
			else
			{
				var viewPortMinHeight:Number = this.viewPortBounds.minHeight;
				if(maxY < viewPortMinHeight)
				{
					maxY = viewPortMinHeight;
				}
				var viewPortMaxHeight:Number = this.viewPortBounds.maxHeight;
				if(maxY > viewPortMaxHeight)
				{
					maxY = viewPortMaxHeight;
				}
				this._layoutResult.viewPortHeight = maxY;
			}
		}

		/**
		 * @private
		 */
		protected function validateChildren():void
		{
			if(this.currentBackgroundSkin is IValidating)
			{
				IValidating(this.currentBackgroundSkin).validate();
			}
			var itemCount:int = this.items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = this.items[i];
				if(item is IValidating)
				{
					IValidating(item).validate();
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshClipRect():void
		{
			if(!this._clipContent)
			{
				return;
			}

			var mask:Quad = this.mask as Quad;
			if(mask)
			{
				mask.x = 0;
				mask.y = 0;
				mask.width = this.actualWidth;
				mask.height = this.actualHeight;
			}
			else
			{
				mask = new Quad(1, 1, 0xff00ff);
				//the initial dimensions cannot be 0 or there's a runtime error,
				//and these values might be 0
				mask.width = this.actualWidth;
				mask.height = this.actualHeight;
				this.mask = mask;
			}
		}

		/**
		 * @private
		 */
		protected function layoutGroup_addedToStageHandler(event:Event):void
		{
			if(this._autoSizeMode === AutoSizeMode.STAGE)
			{
				//if we validated before being added to the stage, or if we've
				//been removed from stage and added again, we need to be sure
				//that the new stage dimensions are accounted for.
				this.invalidate(INVALIDATION_FLAG_SIZE);

				this.stage.addEventListener(Event.RESIZE, stage_resizeHandler);
			}
		}

		/**
		 * @private
		 */
		protected function layoutGroup_removedFromStageHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.RESIZE, stage_resizeHandler);
		}

		/**
		 * @private
		 */
		protected function layout_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected function child_resizeHandler(event:Event):void
		{
			if(this._ignoreChildChanges)
			{
				return;
			}
			if(this._ignoreChildChangesButSetFlags)
			{
				this.setInvalidationFlag(INVALIDATION_FLAG_LAYOUT);
				return;
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected function child_layoutDataChangeHandler(event:Event):void
		{
			if(this._ignoreChildChanges)
			{
				return;
			}
			if(this._ignoreChildChangesButSetFlags)
			{
				this.setInvalidationFlag(INVALIDATION_FLAG_LAYOUT);
				return;
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected function stage_resizeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}
	}
}


================================================
FILE: source/feathers/controls/List.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.controls.supportClasses.ListDataViewPort;
	import feathers.core.IFocusContainer;
	import feathers.core.PropertyProxy;
	import feathers.data.IListCollection;
	import feathers.data.ListCollection;
	import feathers.dragDrop.IDragSource;
	import feathers.dragDrop.IDropTarget;
	import feathers.events.CollectionEventType;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.ILayout;
	import feathers.layout.ISpinnerLayout;
	import feathers.layout.IVariableVirtualLayout;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.skins.IStyleProvider;
	import feathers.system.DeviceCapabilities;

	import flash.events.KeyboardEvent;
	import flash.events.TransformGestureEvent;
	import flash.geom.Point;
	import flash.ui.Keyboard;
	import flash.utils.Dictionary;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.utils.Pool;

	/**
	 * A style name to add to all item renderers in this list. Typically
	 * used by a theme to provide different skins to different lists.
	 *
	 * <p>The following example sets the item renderer name:</p>
	 *
	 * <listing version="3.0">
	 * list.customItemRendererStyleName = "my-custom-item-renderer";</listing>
	 *
	 * <p>In your theme, you can target this sub-component name to provide
	 * different skins than the default style:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( DefaultListItemRenderer ).setFunctionForStyleName( "my-custom-item-renderer", setCustomItemRendererStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 */
	[Style(name="customItemRendererStyleName",type="String")]

	/**
	 * A skin to display when dragging one an item to indicate where it can be
	 * dropped.
	 *
	 * <p>In the following example, the list's drop indicator is provided:</p>
	 *
	 * <listing version="3.0">
	 * list.dropIndicatorSkin = new Image( texture );</listing>
	 *
	 * @default null
	 */
	[Style(name="dropIndicatorSkin",type="starling.display.DisplayObject")]

	/**
	 * The duration, in seconds, of the animation when the selected item is
	 * changed by keyboard navigation and the item scrolls into view.
	 *
	 * <p>In the following example, the duration of the animation that
	 * scrolls the list to a new selected item is set to 500 milliseconds:</p>
	 *
	 * <listing version="3.0">
	 * list.keyScrollDuration = 0.5;</listing>
	 *
	 * @default 0.25
	 */
	[Style(name="keyScrollDuration",type="Number")]

	/**
	 * The layout algorithm used to position and, optionally, size the
	 * list's items.
	 *
	 * <p>By default, if no layout is provided by the time that the list
	 * initializes, a vertical layout with options targeted at touch screens
	 * is created.</p>
	 *
	 * <p>The following example tells the list to use a horizontal layout:</p>
	 *
	 * <listing version="3.0">
	 * var layout:HorizontalLayout = new HorizontalLayout();
	 * layout.gap = 20;
	 * layout.padding = 20;
	 * list.layout = layout;</listing>
	 *
	 * @default null
	 */
	[Style(name="layout",type="feathers.layout.ILayout")]

	/**
	 * Dispatched when the selected item changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #selectedItem
	 * @see #selectedIndex
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the the user taps or clicks an item renderer in the list.
	 * The touch must remain within the bounds of the item renderer on release,
	 * and the list must not have scrolled, to register as a tap or a click.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The item associated with the item
	 *   renderer that was triggered.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.TRIGGERED
	 */
	[Event(name="triggered",type="starling.events.Event")]

	/**
	 * Dispatched when an item renderer is added to the list. When the layout is
	 * virtualized, item renderers may not exist for every item in the data
	 * provider. This event can be used to track which items currently have
	 * renderers.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The item renderer that was added.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.RENDERER_ADD
	 */
	[Event(name="rendererAdd",type="starling.events.Event")]

	/**
	 * Dispatched when an item renderer is removed from the list. When the layout is
	 * virtualized, item renderers may not exist for every item in the data
	 * provider. This event can be used to track which items currently have
	 * renderers.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The item renderer that was removed.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.RENDERER_REMOVE
	 */
	[Event(name="rendererRemove",type="starling.events.Event")]

	/**
	 * Displays a one-dimensional list of items. Supports scrolling, custom
	 * item renderers, and custom layouts.
	 *
	 * <p>Layouts may be, and are highly encouraged to be, <em>virtual</em>,
	 * meaning that the List is capable of creating a limited number of item
	 * renderers to display a subset of the data provider instead of creating a
	 * renderer for every single item. This allows for optimal performance with
	 * very large data providers.</p>
	 *
	 * <p>The following example creates a list, gives it a data provider, tells
	 * the item renderer how to interpret the data, and listens for when the
	 * selection changes:</p>
	 *
	 * <listing version="3.0">
	 * var list:List = new List();
	 * 
	 * list.dataProvider = new ArrayCollection(
	 * [
	 *     { text: "Milk", thumbnail: textureAtlas.getTexture( "milk" ) },
	 *     { text: "Eggs", thumbnail: textureAtlas.getTexture( "eggs" ) },
	 *     { text: "Bread", thumbnail: textureAtlas.getTexture( "bread" ) },
	 *     { text: "Chicken", thumbnail: textureAtlas.getTexture( "chicken" ) },
	 * ]);
	 * 
	 * list.itemRendererFactory = function():IListItemRenderer
	 * {
	 *     var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
	 *     itemRenderer.labelField = "text";
	 *     itemRenderer.iconSourceField = "thumbnail";
	 *     return itemRenderer;
	 * };
	 * 
	 * list.addEventListener( Event.CHANGE, list_changeHandler );
	 * 
	 * this.addChild( list );</listing>
	 *
	 * @see ../../../help/list.html How to use the Feathers List component
	 * @see ../../../help/default-item-renderers.html How to use the Feathers default item renderer
	 * @see ../../../help/item-renderers.html Creating custom item renderers for the Feathers List and GroupedList components
	 * @see feathers.controls.GroupedList
	 * @see feathers.controls.SpinnerList
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class List extends Scroller implements IFocusContainer, IDragSource, IDropTarget
	{
		/**
		 * @private
		 */
		protected static const DEFAULT_DRAG_FORMAT:String = "feathers-list-item";

		/**
		 * The default <code>IStyleProvider</code> for all <code>List</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function List()
		{
			super();
			this._selectedIndices.addEventListener(Event.CHANGE, selectedIndices_changeHandler);
		}

		/**
		 * @private
		 * The guts of the List's functionality. Handles layout and selection.
		 */
		protected var dataViewPort:ListDataViewPort;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return List.globalStyleProvider;
		}

		/**
		 * @private
		 */
		override public function get isFocusEnabled():Boolean
		{
			return (this._isSelectable || this._minHorizontalScrollPosition != this._maxHorizontalScrollPosition ||
				this._minVerticalScrollPosition != this._maxVerticalScrollPosition) &&
				this._isEnabled && this._isFocusEnabled;
		}

		/**
		 * @private
		 */
		protected var _isChildFocusEnabled:Boolean = true;

		/**
		 * @copy feathers.core.IFocusContainer#isChildFocusEnabled
		 *
		 * @default true
		 *
		 * @see #isFocusEnabled
		 */
		public function get isChildFocusEnabled():Boolean
		{
			return this._isEnabled && this._isChildFocusEnabled;
		}

		/**
		 * @private
		 */
		public function set isChildFocusEnabled(value:Boolean):void
		{
			this._isChildFocusEnabled = value;
		}

		/**
		 * @private
		 */
		protected var _layout:ILayout;

		/**
		 * @private
		 */
		public function get layout():ILayout
		{
			return this._layout;
		}

		/**
		 * @private
		 */
		public function set layout(value:ILayout):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._layout == value)
			{
				return;
			}
			if(!(this is SpinnerList) && value is ISpinnerLayout)
			{
				throw new ArgumentError("Layouts that implement the ISpinnerLayout interface should be used with the SpinnerList component.");
			}
			if(this._layout)
			{
				this._layout.removeEventListener(Event.SCROLL, layout_scrollHandler);
			}
			this._layout = value;
			if(this._layout is IVariableVirtualLayout)
			{
				this._layout.addEventListener(Event.SCROLL, layout_scrollHandler);
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _addedItems:Dictionary = null;

		/**
		 * @private
		 */
		protected var _removedItems:Dictionary = null;

		/**
		 * @private
		 */
		protected var _dataProvider:IListCollection;

		/**
		 * The collection of data displayed by the list. Changing this property
		 * to a new value is considered a drastic change to the list's data, so
		 * the horizontal and vertical scroll positions will be reset, and the
		 * list's selection will be cleared.
		 *
		 * <p>The following example passes in a data provider and tells the item
		 * renderer how to interpret the data:</p>
		 *
		 * <listing version="3.0">
		 * list.dataProvider = new ArrayCollection(
		 * [
		 *     { text: "Milk", thumbnail: textureAtlas.getTexture( "milk" ) },
		 *     { text: "Eggs", thumbnail: textureAtlas.getTexture( "eggs" ) },
		 *     { text: "Bread", thumbnail: textureAtlas.getTexture( "bread" ) },
		 *     { text: "Chicken", thumbnail: textureAtlas.getTexture( "chicken" ) },
		 * ]);
		 * 
		 * list.itemRendererFactory = function():IListItemRenderer
		 * {
		 *     var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();
		 *     renderer.labelField = "text";
		 *     renderer.iconSourceField = "thumbnail";
		 *     return renderer;
		 * };</listing>
		 *
		 * <p><em>Warning:</em> A list's data provider cannot contain duplicate
		 * items. To display the same item in multiple item renderers, you must
		 * create separate objects with the same properties. This restriction
		 * exists because it significantly improves performance.</p>
		 *
		 * <p><em>Warning:</em> If the data provider contains display objects,
		 * concrete textures, or anything that needs to be disposed, those
		 * objects will not be automatically disposed when the list is disposed.
		 * Similar to how <code>starling.display.Image</code> cannot
		 * automatically dispose its texture because the texture may be used
		 * by other display objects, a list cannot dispose its data provider
		 * because the data provider may be used by other lists. See the
		 * <code>dispose()</code> function on <code>IListCollection</code> to
		 * see how the data provider can be disposed properly.</p>
		 *
		 * @default null
		 *
		 * @see feathers.data.IListCollection#dispose()
		 * @see feathers.data.ArrayCollection
		 * @see feathers.data.VectorCollection
		 * @see feathers.data.XMLListCollection
		 */
		public function get dataProvider():IListCollection
		{
			return this._dataProvider;
		}

		/**
		 * @private
		 */
		public function set dataProvider(value:IListCollection):void
		{
			if(this._dataProvider == value)
			{
				return;
			}
			if(this._dataProvider)
			{
				this._dataProvider.removeEventListener(CollectionEventType.SORT_CHANGE, dataProvider_sortChangeHandler);
				this._dataProvider.removeEventListener(CollectionEventType.FILTER_CHANGE, dataProvider_filterChangeHandler);
				this._dataProvider.removeEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ALL, dataProvider_removeAllHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.removeEventListener(Event.CHANGE, dataProvider_changeHandler);
			}
			this._dataProvider = value;
			if(this._dataProvider)
			{
				this._dataProvider.addEventListener(CollectionEventType.SORT_CHANGE, dataProvider_sortChangeHandler);
				this._dataProvider.addEventListener(CollectionEventType.FILTER_CHANGE, dataProvider_filterChangeHandler);
				this._dataProvider.addEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ALL, dataProvider_removeAllHandler);
				this._dataProvider.addEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.addEventListener(Event.CHANGE, dataProvider_changeHandler);
			}

			//reset the scroll position because this is a drastic change and
			//the data is probably completely different
			this.horizontalScrollPosition = 0;
			this.verticalScrollPosition = 0;

			//clear the selection for the same reason
			this.selectedIndex = -1;

			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _isSelectable:Boolean = true;

		/**
		 * Determines if items in the list may be selected. By default only a
		 * single item may be selected at any given time. In other words, if
		 * item A is selected, and the user selects item B, item A will be
		 * deselected automatically. Set <code>allowMultipleSelection</code>
		 * to <code>true</code> to select more than one item without
		 * automatically deselecting other items.
		 *
		 * <p>The following example disables selection:</p>
		 *
		 * <listing version="3.0">
		 * list.isSelectable = false;</listing>
		 *
		 * @default true
		 *
		 * @see #selectedItem
		 * @see #selectedIndex
		 * @see #allowMultipleSelection
		 */
		public function get isSelectable():Boolean
		{
			return this._isSelectable;
		}

		/**
		 * @private
		 */
		public function set isSelectable(value:Boolean):void
		{
			if(this._isSelectable == value)
			{
				return;
			}
			this._isSelectable = value;
			if(!this._isSelectable)
			{
				this.selectedIndex = -1;
			}
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * @private
		 */
		protected var _selectedIndex:int = -1;

		/**
		 * The index of the currently selected item. Returns <code>-1</code> if
		 * no item is selected.
		 *
		 * <p>The following example selects an item by its index:</p>
		 *
		 * <listing version="3.0">
		 * list.selectedIndex = 2;</listing>
		 *
		 * <p>The following example clears the selected index:</p>
		 *
		 * <listing version="3.0">
		 * list.selectedIndex = -1;</listing>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected index:</p>
		 *
		 * <listing version="3.0">
		 * function list_changeHandler( event:Event ):void
		 * {
		 *     var list:List = List( event.currentTarget );
		 *     var index:int = list.selectedIndex;
		 *     trace( "change: " + index );
		 * }
		 * list.addEventListener( Event.CHANGE, list_changeHandler );</listing>
		 *
		 * @default -1
		 *
		 * @see #selectedItem
		 * @see #allowMultipleSelection
		 * @see #selectedItems
		 * @see #selectedIndices
		 */
		public function get selectedIndex():int
		{
			return this._selectedIndex;
		}

		/**
		 * @private
		 */
		public function set selectedIndex(value:int):void
		{
			if(this._selectedIndex == value)
			{
				return;
			}
			if(value >= 0)
			{
				this._selectedIndices.data = new <int>[value];
			}
			else
			{
				this._selectedIndices.removeAll();
			}
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * The currently selected item. Returns <code>null</code> if no item is
		 * selected.
		 *
		 * <p>The following example changes the selected item:</p>
		 *
		 * <listing version="3.0">
		 * list.selectedItem = list.dataProvider.getItemAt(0);</listing>
		 *
		 * <p>The following example clears the selected item:</p>
		 *
		 * <listing version="3.0">
		 * list.selectedItem = null;</listing>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected item:</p>
		 *
		 * <listing version="3.0">
		 * function list_changeHandler( event:Event ):void
		 * {
		 *     var list:List = List( event.currentTarget );
		 *     var item:Object = list.selectedItem;
		 *     trace( "change: " + item );
		 * }
		 * list.addEventListener( Event.CHANGE, list_changeHandler );</listing>
		 *
		 * @default null
		 *
		 * @see #selectedIndex
		 * @see #allowMultipleSelection
		 * @see #selectedItems
		 * @see #selectedIndices
		 */
		public function get selectedItem():Object
		{
			if(!this._dataProvider || this._selectedIndex < 0 || this._selectedIndex >= this._dataProvider.length)
			{
				return null;
			}

			return this._dataProvider.getItemAt(this._selectedIndex);
		}

		/**
		 * @private
		 */
		public function set selectedItem(value:Object):void
		{
			if(!this._dataProvider)
			{
				this.selectedIndex = -1;
				return;
			}
			this.selectedIndex = this._dataProvider.getItemIndex(value);
		}

		/**
		 * @private
		 */
		protected var _allowMultipleSelection:Boolean = false;

		/**
		 * If <code>true</code> multiple items may be selected at a time. If
		 * <code>false</code>, then only a single item may be selected at a
		 * time, and if the selection changes, other items are deselected. Has
		 * no effect if <code>isSelectable</code> is <code>false</code>.
		 *
		 * <p>In the following example, multiple selection is enabled:</p>
		 *
		 * <listing version="3.0">
		 * list.allowMultipleSelection = true;</listing>
		 *
		 * @default false
		 *
		 * @see #isSelectable
		 * @see #selectedIndices
		 * @see #selectedItems
		 */
		public function get allowMultipleSelection():Boolean
		{
			return this._allowMultipleSelection;
		}

		/**
		 * @private
		 */
		public function set allowMultipleSelection(value:Boolean):void
		{
			if(this._allowMultipleSelection == value)
			{
				return;
			}
			this._allowMultipleSelection = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * @private
		 */
		protected var _selectedIndices:ListCollection = new ListCollection(new <int>[]);

		/**
		 * The indices of the currently selected items. Returns an empty <code>Vector.&lt;int&gt;</code>
		 * if no items are selected. If <code>allowMultipleSelection</code> is
		 * <code>false</code>, only one item may be selected at a time.
		 *
		 * <p>The following example selects two items by their indices:</p>
		 *
		 * <listing version="3.0">
		 * list.selectedIndices = new &lt;int&gt;[ 2, 3 ];</listing>
		 *
		 * <p>The following example clears the selected indices:</p>
		 *
		 * <listing version="3.0">
		 * list.selectedIndices = null;</listing>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected indices:</p>
		 *
		 * <listing version="3.0">
		 * function list_changeHandler( event:Event ):void
		 * {
		 *     var list:List = List( event.currentTarget );
		 *     var indices:Vector.&lt;int&gt; = list.selectedIndices;
		 * 
		 * }
		 * list.addEventListener( Event.CHANGE, list_changeHandler );</listing>
		 *
		 * @see #allowMultipleSelection
		 * @see #selectedItems
		 * @see #selectedIndex
		 * @see #selectedItem
		 */
		public function get selectedIndices():Vector.<int>
		{
			return this._selectedIndices.data as Vector.<int>;
		}

		/**
		 * @private
		 */
		public function set selectedIndices(value:Vector.<int>):void
		{
			var oldValue:Vector.<int> = this._selectedIndices.data as Vector.<int>;
			if(oldValue == value)
			{
				return;
			}
			if(!value)
			{
				if(this._selectedIndices.length == 0)
				{
					return;
				}
				this._selectedIndices.removeAll();
			}
			else
			{
				if(!this._allowMultipleSelection && value.length > 0)
				{
					value.length = 1;
				}
				this._selectedIndices.data = value;
			}
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * @private
		 */
		protected var _selectedItems:Vector.<Object> = new <Object>[];

		/**
		 * The currently selected item. The getter returns an empty
		 * <code>Vector.&lt;Object&gt;</code> if no item is selected. If any
		 * items are selected, the getter creates a new
		 * <code>Vector.&lt;Object&gt;</code> to return a list of selected
		 * items.
		 *
		 * <p>The following example selects two items:</p>
		 *
		 * <listing version="3.0">
		 * list.selectedItems = new &lt;Object&gt;[ list.dataProvider.getItemAt(2) , list.dataProvider.getItemAt(3) ];</listing>
		 *
		 * <p>The following example clears the selected items:</p>
		 *
		 * <listing version="3.0">
		 * list.selectedItems = null;</listing>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected items:</p>
		 *
		 * <listing version="3.0">
		 * function list_changeHandler( event:Event ):void
		 * {
		 *     var list:List = List( event.currentTarget );
		 *     var items:Vector.&lt;Object&gt; = list.selectedItems;
		 * 
		 * }
		 * list.addEventListener( Event.CHANGE, list_changeHandler );</listing>
		 *
		 * @see #allowMultipleSelection
		 * @see #selectedIndices
		 * @see #selectedIndex
		 * @see #selectedItem
		 */
		public function get selectedItems():Vector.<Object>
		{
			return this._selectedItems;
		}

		/**
		 * @private
		 */
		public function set selectedItems(value:Vector.<Object>):void
		{
			if(!value || !this._dataProvider)
			{
				this.selectedIndex = -1;
				return;
			}
			var indices:Vector.<int> = new <int>[];
			var itemCount:int = value.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = value[i];
				var index:int = this._dataProvider.getItemIndex(item);
				if(index >= 0)
				{
					indices.push(index);
				}
			}
			this.selectedIndices = indices;
		}

		/**
		 * Returns the selected items, with the ability to pass in an optional
		 * result vector. Better for performance than the <code>selectedItems</code>
		 * getter because it can avoid the allocation, and possibly garbage
		 * collection, of the result object.
		 *
		 * @see #selectedItems
		 */
		public function getSelectedItems(result:Vector.<Object> = null):Vector.<Object>
		{
			if(result !== null)
			{
				result.length = 0;
			}
			else
			{
				result = new <Object>[];
			}
			if(!this._dataProvider)
			{
				return result;
			}
			var indexCount:int = this._selectedIndices.length;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = this._selectedIndices.getItemAt(i) as int;
				var item:Object = this._dataProvider.getItemAt(index);
				result[i] = item;
			}
			return result;
		}

		/**
		 * @private
		 */
		protected var _itemRendererType:Class = DefaultListItemRenderer;

		/**
		 * The class used to instantiate item renderers. Must implement the
		 * <code>IListItemRenderer</code> interface.
		 *
		 * <p>To customize properties on the item renderer, use
		 * <code>itemRendererFactory</code> instead.</p>
		 *
		 * <p>The following example changes the item renderer type:</p>
		 *
		 * <listing version="3.0">
		 * list.itemRendererType = CustomItemRendererClass;</listing>
		 *
		 * @default feathers.controls.renderers.DefaultListItemRenderer
		 *
		 * @see feathers.controls.renderers.IListItemRenderer
		 * @see #itemRendererFactory
		 */
		public function get itemRendererType():Class
		{
			return this._itemRendererType;
		}

		/**
		 * @private
		 */
		public function set itemRendererType(value:Class):void
		{
			if(this._itemRendererType == value)
			{
				return;
			}

			this._itemRendererType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _itemRendererFactories:Object;

		/**
		 * @private
		 */
		protected var _itemRendererFactory:Function;

		/**
		 * A function called that is expected to return a new item renderer. Has
		 * a higher priority than <code>itemRendererType</code>. Typically, you
		 * would use an <code>itemRendererFactory</code> instead of an
		 * <code>itemRendererType</code> if you wanted to initialize some
		 * properties on each separate item renderer, such as skins.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 *
		 * <pre>function():IListItemRenderer</pre>
		 *
		 * <p>The following example provides a factory for the item renderer:</p>
		 *
		 * <listing version="3.0">
		 * list.itemRendererFactory = function():IListItemRenderer
		 * {
		 *     var renderer:CustomItemRendererClass = new CustomItemRendererClass();
		 *     renderer.backgroundSkin = new Quad( 10, 10, 0xff0000 );
		 *     return renderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderers.IListItemRenderer
		 * @see #itemRendererType
		 * @see #setItemRendererFactoryWithID()
		 */
		public function get itemRendererFactory():Function
		{
			return this._itemRendererFactory;
		}

		/**
		 * @private
		 */
		public function set itemRendererFactory(value:Function):void
		{
			if(this._itemRendererFactory === value)
			{
				return;
			}

			this._itemRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _factoryIDFunction:Function;

		/**
		 * When a list requires multiple item renderer types, this function is
		 * used to determine which type of item renderer is required for a
		 * specific item (or index). Returns the ID of the item renderer type
		 * to use for the item, or <code>null</code> if the default
		 * <code>itemRendererFactory</code> should be used.
		 *
		 * <p>The function is expected to have one of the following
		 * signatures:</p>
		 *
		 * <pre>function(item:Object):String</pre>
		 *
		 * <pre>function(item:Object, index:int):String</pre>
		 *
		 * <p>The following example provides a <code>factoryIDFunction</code>:</p>
		 *
		 * <listing version="3.0">
		 * function regularItemFactory():IListItemRenderer
		 * {
		 *     return new DefaultListItemRenderer();
		 * }
		 * function headerItemFactory():IListItemRenderer
		 * {
		 *     return new CustomItemRenderer();
		 * }
		 * list.setItemRendererFactoryWithID( "regular-item", regularItemFactory );
		 * list.setItemRendererFactoryWithID( "header-item", listHeaderFactory );
		 * 
		 * list.factoryIDFunction = function( item:Object, index:int ):String
		 * {
		 *     if(index == 0)
		 *     {
		 *         return "header-item";
		 *     }
		 *     return "regular-item";
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #setItemRendererFactoryWithID()
		 * @see #itemRendererFactory
		 */
		public function get factoryIDFunction():Function
		{
			return this._factoryIDFunction;
		}

		/**
		 * @private
		 */
		public function set factoryIDFunction(value:Function):void
		{
			if(this._factoryIDFunction === value)
			{
				return;
			}
			this._factoryIDFunction = value;
			if(value !== null && this._itemRendererFactories === null)
			{
				this._itemRendererFactories = {};
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _typicalItem:Object = null;

		/**
		 * Used to auto-size the list when a virtualized layout is used. If the
		 * list's width or height is unknown, the list will try to automatically
		 * pick an ideal size. This item is used to create a sample item
		 * renderer to measure item renderers that are virtual and not visible
		 * in the viewport.
		 *
		 * <p>The following example provides a typical item:</p>
		 *
		 * <listing version="3.0">
		 * list.typicalItem = { text: "A typical item", thumbnail: texture };</listing>
		 *
		 * @default null
		 */
		public function get typicalItem():Object
		{
			return this._typicalItem;
		}

		/**
		 * @private
		 */
		public function set typicalItem(value:Object):void
		{
			if(this._typicalItem == value)
			{
				return;
			}
			this._typicalItem = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _customItemRendererStyleName:String;

		/**
		 * @private
		 */
		public function get customItemRendererStyleName():String
		{
			return this._customItemRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customItemRendererStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customItemRendererStyleName === value)
			{
				return;
			}
			this._customItemRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _itemRendererProperties:PropertyProxy;

		/**
		 * An object that stores properties for all of the list's item
		 * renderers, and the properties will be passed down to every item
		 * renderer when the list validates. The available properties
		 * depend on which <code>IListItemRenderer</code> implementation is
		 * returned by <code>itemRendererFactory</code>.
		 *
		 * <p>By default, the <code>itemRendererFactory</code> will return a
		 * <code>DefaultListItemRenderer</code> instance. If you aren't using a
		 * custom item renderer, you can refer to
		 * <a href="renderers/DefaultListItemRenderer.html"><code>feathers.controls.renderers.DefaultListItemRenderer</code></a>
		 * for a list of available properties.</p>
		 *
		 * <p>These properties are shared by every item renderer, so anything
		 * that cannot be shared (such as display objects, which cannot be added
		 * to multiple parents) should be passed to item renderers using the
		 * <code>itemRendererFactory</code> or in the theme.</p>
		 *
		 * <p>The following example customizes some item renderer properties
		 * (this example assumes that the item renderer's label text renderer
		 * is a <code>BitmapFontTextRenderer</code>):</p>
		 *
		 * <listing version="3.0">
		 * list.itemRendererProperties.labelField = "text";
		 * list.itemRendererProperties.accessoryField = "control";</listing>
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>itemRendererFactory</code> function
		 * instead of using <code>itemRendererProperties</code> will result in
		 * better performance.</p>
		 *
		 * @default null
		 *
		 * @see #itemRendererFactory
		 * @see feathers.controls.renderers.IListItemRenderer
		 * @see feathers.controls.renderers.DefaultListItemRenderer
		 */
		public function get itemRendererProperties():Object
		{
			if(!this._itemRendererProperties)
			{
				this._itemRendererProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._itemRendererProperties;
		}

		/**
		 * @private
		 */
		public function set itemRendererProperties(value:Object):void
		{
			if(this._itemRendererProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._itemRendererProperties)
			{
				this._itemRendererProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._itemRendererProperties = PropertyProxy(value);
			if(this._itemRendererProperties)
			{
				this._itemRendererProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _keyScrollDuration:Number = 0.25;

		/**
		 * @private
		 */
		public function get keyScrollDuration():Number
		{
			return this._keyScrollDuration;
		}

		/**
		 * @private
		 */
		public function set keyScrollDuration(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._keyScrollDuration = value;
		}

		/**
		 * @private
		 */
		protected var _dragFormat:String = DEFAULT_DRAG_FORMAT;

		/**
		 * Drag and drop is restricted to components that have the same
		 * <code>dragFormat</code>.
		 *
		 * <p>In the following example, the drag format of two lists is customized:</p>
		 *
		 * <listing version="3.0">
		 * list1.dragFormat = "my-custom-format";
		 * list2.dragFormat = "my-custom-format";</listing>
		 *
		 * @default "feathers-list-item"
		 */
		public function get dragFormat():String
		{
			return this._dragFormat;
		}

		/**
		 * @private
		 */
		public function set dragFormat(value:String):void
		{
			if(!value)
			{
				value = DEFAULT_DRAG_FORMAT;
			}
			if(this._dragFormat == value)
			{
				return;
			}
			this._dragFormat = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _dragEnabled:Boolean = false;

		/**
		 * Indicates if this list can initiate drag and drop operations by
		 * touching an item and dragging it. The <code>dragEnabled</code>
		 * property enables dragging items, but dropping items must be enabled
		 * separately with the <code>dropEnabled</code> property.
		 *
		 * <p>In the following example, a list's items may be dragged:</p>
		 *
		 * <listing version="3.0">
		 * list.dragEnabled = true;</listing>
		 *
		 * @see #dropEnabled
		 * @see #dragFormat
		 */
		public function get dragEnabled():Boolean
		{
			return this._dragEnabled;
		}

		/**
		 * @private
		 */
		public function set dragEnabled(value:Boolean):void
		{
			if(this._dragEnabled == value)
			{
				return;
			}
			this._dragEnabled = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _dropEnabled:Boolean = false;

		/**
		 * Indicates if this list can accept items that are dragged and
		 * dropped over the list's hit area.
		 *
		 * <p>In the following example, a list's items may be dropped:</p>
		 *
		 * <listing version="3.0">
		 * list.dropEnabled = true;</listing>
		 *
		 * @see #dragEnabled
		 * @see #dragFormat
		 */
		public function get dropEnabled():Boolean
		{
			return this._dropEnabled;
		}

		/**
		 * @private
		 */
		public function set dropEnabled(value:Boolean):void
		{
			if(this._dropEnabled == value)
			{
				return;
			}
			this._dropEnabled = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _dropIndicatorSkin:DisplayObject = null;

		/**
		 * @private
		 */
		public function get dropIndicatorSkin():DisplayObject
		{
			return this._dropIndicatorSkin;
		}

		/**
		 * @private
		 */
		public function set dropIndicatorSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			this._dropIndicatorSkin = value;
		}

		/**
		 * @private
		 */
		protected var _minimumAutoScrollDistance:Number = 0.2;

		/**
		 * The minimum physical distance (in inches) that a touch must be from
		 * the edge of the container during a drag and drop action before the
		 * container starts scrolling.
		 *
		 * <p>In the following example, the minimum auto-scroll distance is customized:</p>
		 *
		 * <listing version="3.0">
		 * scroller.minimumAutoScrollDistance = 0.1;</listing>
		 *
		 * @default 0.3
		 */
		public function get minimumAutoScrollDistance():Number
		{
			return this._minimumAutoScrollDistance;
		}

		/**
		 * @private
		 */
		public function set minimumAutoScrollDistance(value:Number):void
		{
			if(this._minimumAutoScrollDistance == value)
			{
				return;
			}
			this._minimumAutoScrollDistance = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * The pending item index to scroll to after validating. A value of
		 * <code>-1</code> means that the scroller won't scroll to an item after
		 * validating.
		 */
		protected var pendingItemIndex:int = -1;

		/**
		 * @private
		 */
		override public function scrollToPosition(horizontalScrollPosition:Number, verticalScrollPosition:Number, animationDuration:Number = NaN):void
		{
			this.pendingItemIndex = -1;
			super.scrollToPosition(horizontalScrollPosition, verticalScrollPosition, animationDuration);
		}

		/**
		 * @private
		 */
		override public function scrollToPageIndex(horizontalPageIndex:int, verticalPageIndex:int, animationDuration:Number = NaN):void
		{
			this.pendingItemIndex = -1;
			super.scrollToPageIndex(horizontalPageIndex, verticalPageIndex, animationDuration);
		}

		/**
		 * Scrolls the list so that the specified item is visible. If
		 * <code>animationDuration</code> is greater than zero, the scroll will
		 * animate. The duration is in seconds.
		 *
		 * <p>If the layout is virtual with variable item dimensions, this
		 * function may not accurately scroll to the exact correct position. A
		 * virtual layout with variable item dimensions is often forced to
		 * estimate positions, so the results aren't guaranteed to be accurate.</p>
		 *
		 * <p>If you want to scroll to the end of the list, it is better to use
		 * <code>scrollToPosition()</code> with <code>maxHorizontalScrollPosition</code>
		 * or <code>maxVerticalScrollPosition</code>.</p>
		 *
		 * <p>In the following example, the list is scrolled to display index 10:</p>
		 *
		 * <listing version="3.0">
		 * list.scrollToDisplayIndex( 10 );</listing>
		 *
		 * @param index The integer index of an item from the data provider.
		 * @param animationDuration The length of time, in seconds, of the animation. May be zero to scroll instantly.
		 *
		 * @see #scrollToPosition()
		 */
		public function scrollToDisplayIndex(index:int, animationDuration:Number = 0):void
		{
			//cancel any pending scroll to a different page or scroll position.
			//we can have only one type of pending scroll at a time.
			this.hasPendingHorizontalPageIndex = false;
			this.hasPendingVerticalPageIndex = false;
			this.pendingHorizontalScrollPosition = NaN;
			this.pendingVerticalScrollPosition = NaN;
			if(this.pendingItemIndex == index &&
				this.pendingScrollDuration == animationDuration)
			{
				return;
			}
			this.pendingItemIndex = index;
			this.pendingScrollDuration = animationDuration;
			this.invalidate(INVALIDATION_FLAG_PENDING_SCROLL);
		}

		/**
		 * Returns the item renderer factory associated with a specific ID.
		 * Returns <code>null</code> if no factory is associated with the ID.
		 *
		 * @see #setItemRendererFactoryWithID()
		 */
		public function getItemRendererFactoryWithID(id:String):Function
		{
			if(this._itemRendererFactories && (id in this._itemRendererFactories))
			{
				return this._itemRendererFactories[id] as Function;
			}
			return null;
		}

		/**
		 * Associates an item renderer factory with an ID to allow multiple
		 * types of item renderers may be displayed in the list. A custom
		 * <code>factoryIDFunction</code> may be specified to return the ID of
		 * the factory to use for a specific item in the data provider.
		 *
		 * @see #factoryIDFunction
		 * @see #getItemRendererFactoryWithID()
		 */
		public function setItemRendererFactoryWithID(id:String, factory:Function):void
		{
			if(id === null)
			{
				this.itemRendererFactory = factory;
				return;
			}
			if(this._itemRendererFactories === null)
			{
				this._itemRendererFactories = {};
			}
			if(factory !== null)
			{
				this._itemRendererFactories[id] = factory;
			}
			else
			{
				delete this._itemRendererFactories[id];
			}
		}

		/**
		 * Returns the current item renderer used to render a specific item. May
		 * return <code>null</code> if an item doesn't currently have an item
		 * renderer. Most lists use virtual layouts where only the visible items
		 * will have an item renderer, so the result will usually be
		 * <code>null</code> for most items in the data provider.
		 *
		 * @see ../../../help/faq/layout-virtualization.html What is layout virtualization?
		 */
		public function itemToItemRenderer(item:Object):IListItemRenderer
		{
			return this.dataViewPort.itemToItemRenderer(item);
		}

		/**
		 * Adds an item from the data provider and animates its item renderer
		 * using an effect.
		 *
		 * <p>In the following example, an effect fades the item renderer's
		 * <code>alpha</code> property from <code>0</code> to <code>1</code>:</p>
		 *
		 * <listing version="3.0">
		 * list.addItemWithEffect(newItem, list.dataProvider.length, Fade.createFadeBetweenEffect(0, 1));</listing>
		 *
		 * <p>A number of animated effects may be found in the
		 * <a href="../motion/package-detail.html">feathers.motion</a> package.
		 * However, you are not limited to only these effects. It's possible
		 * to create custom effects too.</p>
		 *
		 * <p>A custom effect function should have the following signature:</p>
		 * <pre>function(target:DisplayObject):IEffectContext</pre>
		 *
		 * <p>The <code>IEffectContext</code> is used by the component to
		 * control the effect, performing actions like playing the effect,
		 * pausing it, or cancelling it.</p>
		 *
		 * <p>Custom animated effects that use
		 * <code>starling.display.Tween</code> typically return a
		 * <code>TweenEffectContext</code>. In the following example, we
		 * recreate the <code>Fade.createFadeBetweenEffect()</code> used in the
		 * previous example.</p>
		 *
		 * <listing version="3.0">
		 * function customEffect(target:DisplayObject):IEffectContext
		 * {
		 *     target.alpha = 0;
		 *     var tween:Tween = new Tween(target, 0.5, Transitions.EASE_OUT);
		 *     tween.fadeTo(1);
		 *     return new TweenEffectContext(target, tween);
		 * }
		 * list.addItemWithEffect(newItem, list.dataProvider.length, customEffect);</listing>
		 *
		 * @see #removeItemWithEffect()
		 * @see feathers.data.IListCollection#addItem()
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 * @see feathers.motion.effectClasses.IEffectContext
		 * @see feathers.motion.effectClasses.TweenEffectContext
		 */
		public function addItemWithEffect(item:Object, index:int, effect:Function):void
		{
			//add to the data provider immediately
			this._dataProvider.addItemAt(item, index);
			if(this._addedItems === null)
			{
				this._addedItems = new Dictionary();
			}
			this._addedItems[item] = effect;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * Removes an item from the data provider <strong>after</strong>
		 * animating its item renderer using an effect.
		 *
		 * <p>In the following example, an effect fades the item renderer's
		 * <code>alpha</code> property to <code>0</code>:</p>
		 *
		 * <listing version="3.0">
		 * list.removeItemWithEffect(newItem, list.dataProvider.length, Fade.createFadeOutEffect());</listing>
		 *
		 * <p>A number of animated effects may be found in the
		 * <a href="../motion/package-detail.html">feathers.motion</a> package.
		 * However, you are not limited to only these effects. It's possible
		 * to create custom effects too.</p>
		 *
		 * <p>A custom effect function should have the following signature:</p>
		 * <pre>function(target:DisplayObject):IEffectContext</pre>
		 *
		 * <p>The <code>IEffectContext</code> is used by the component to
		 * control the effect, performing actions like playing the effect,
		 * pausing it, or cancelling it.</p>
		 *
		 * <p>Custom animated effects that use
		 * <code>starling.display.Tween</code> typically return a
		 * <code>TweenEffectContext</code>. In the following example, we
		 * recreate the <code>Fade.createFadeOutEffect()</code> used in the
		 * previous example.</p>
		 *
		 * <listing version="3.0">
		 * function customEffect(target:DisplayObject):IEffectContext
		 * {
		 *     var tween:Tween = new Tween(target, 0.5, Transitions.EASE_OUT);
		 *     tween.fadeTo(0);
		 *     return new TweenEffectContext(target, tween);
		 * }
		 * list.removeItemWithEffect(newItem, customEffect);</listing>
		 *
		 * @see #addItemWithEffect()
		 * @see feathers.data.IListCollection#removeItem()
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 * @see feathers.motion.effectClasses.IEffectContext
		 * @see feathers.motion.effectClasses.TweenEffectContext
		 */
		public function removeItemWithEffect(item:Object, effect:Function):void
		{
			//don't remove from the data provider yet because that will
			//immediately remove the item renderer. we'll wait until the effect
			//finishes instead.
			if(this._removedItems === null)
			{
				this._removedItems = new Dictionary();
			}
			this._removedItems[item] = effect;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			//clearing selection now so that the data provider setter won't
			//cause a selection change that triggers events.
			this._selectedIndices.removeEventListeners();
			this._selectedIndex = -1;
			this.dataProvider = null;
			this.layout = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			var hasLayout:Boolean = this._layout !== null;

			super.initialize();

			if(!this.dataViewPort)
			{
				this.viewPort = this.dataViewPort = new ListDataViewPort();
				this.dataViewPort.owner = this;
				this.viewPort = this.dataViewPort;
			}

			if(!hasLayout)
			{
				if(this._hasElasticEdges &&
					this._verticalScrollPolicy === ScrollPolicy.AUTO &&
					this._scrollBarDisplayMode !== ScrollBarDisplayMode.FIXED)
				{
					//so that the elastic edges work even when the max scroll
					//position is 0, similar to iOS.
					this._verticalScrollPolicy = ScrollPolicy.ON;
				}

				var layout:VerticalLayout = new VerticalLayout();
				layout.useVirtualLayout = true;
				layout.padding = 0;
				layout.gap = 0;
				layout.horizontalAlign = HorizontalAlign.JUSTIFY;
				layout.verticalAlign = VerticalAlign.TOP;
				this.ignoreNextStyleRestriction();
				this.layout = layout;
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			this.refreshDataViewPortProperties();
			super.draw();
		}

		/**
		 * @private
		 */
		protected function refreshDataViewPortProperties():void
		{
			this.dataViewPort.isSelectable = this._isSelectable;
			this.dataViewPort.allowMultipleSelection = this._allowMultipleSelection;
			this.dataViewPort.selectedIndices = this._selectedIndices;
			this.dataViewPort.dataProvider = this._dataProvider;
			this.dataViewPort.itemRendererType = this._itemRendererType;
			this.dataViewPort.itemRendererFactory = this._itemRendererFactory;
			this.dataViewPort.itemRendererFactories = this._itemRendererFactories;
			this.dataViewPort.factoryIDFunction = this._factoryIDFunction;
			this.dataViewPort.itemRendererProperties = this._itemRendererProperties;
			this.dataViewPort.customItemRendererStyleName = this._customItemRendererStyleName;
			this.dataViewPort.typicalItem = this._typicalItem;
			this.dataViewPort.layout = this._layout;
			this.dataViewPort.addedItems = this._addedItems;
			this.dataViewPort.removedItems = this._removedItems;
			this.dataViewPort.dragFormat = this._dragFormat;
			this.dataViewPort.dragEnabled = this._dragEnabled;
			this.dataViewPort.dropEnabled = this._dropEnabled;
			this.dataViewPort.dropIndicatorSkin = this._dropIndicatorSkin;
			this.dataViewPort.minimumAutoScrollDistance = this._minimumAutoScrollDistance;
			this._addedItems = null;
			this._removedItems = null;
		}

		/**
		 * @private
		 */
		override protected function handlePendingScroll():void
		{
			if(this.pendingItemIndex >= 0)
			{
				var item:Object = null;
				if(this._dataProvider !== null)
				{
					item = this._dataProvider.getItemAt(this.pendingItemIndex);
				}
				if(item is Object)
				{
					var point:Point = Pool.getPoint();
					this.dataViewPort.getScrollPositionForIndex(this.pendingItemIndex, point);
					this.pendingItemIndex = -1;

					var targetHorizontalScrollPosition:Number = point.x;
					var targetVerticalScrollPosition:Number = point.y;
					Pool.putPoint(point);
					if(targetHorizontalScrollPosition < this._minHorizontalScrollPosition)
					{
						targetHorizontalScrollPosition = this._minHorizontalScrollPosition;
					}
					else if(targetHorizontalScrollPosition > this._maxHorizontalScrollPosition)
					{
						targetHorizontalScrollPosition = this._maxHorizontalScrollPosition;
					}
					if(targetVerticalScrollPosition < this._minVerticalScrollPosition)
					{
						targetVerticalScrollPosition = this._minVerticalScrollPosition;
					}
					else if(targetVerticalScrollPosition > this._maxVerticalScrollPosition)
					{
						targetVerticalScrollPosition = this._maxVerticalScrollPosition;
					}
					this.throwTo(targetHorizontalScrollPosition, targetVerticalScrollPosition, this.pendingScrollDuration);
				}
			}
			super.handlePendingScroll();
		}

		/**
		 * @private
		 */
		override protected function nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(!this._isSelectable)
			{
				//not selectable, but should scroll
				super.nativeStage_keyDownHandler(event);
				return;
			}
			if(event.isDefaultPrevented())
			{
				return;
			}
			if(!this._dataProvider)
			{
				return;
			}
			if(this._selectedIndex != -1 && (event.keyCode == Keyboard.SPACE ||
				((event.keyLocation == 4 || DeviceCapabilities.simulateDPad) && event.keyCode == Keyboard.ENTER)))
			{
				this.dispatchEventWith(Event.TRIGGERED, false, this.selectedItem);
			}
			if(event.keyCode == Keyboard.HOME || event.keyCode == Keyboard.END ||
				event.keyCode == Keyboard.PAGE_UP || event.keyCode == Keyboard.PAGE_DOWN ||
				event.keyCode == Keyboard.UP || event.keyCode == Keyboard.DOWN ||
				event.keyCode == Keyboard.LEFT || event.keyCode == Keyboard.RIGHT)
			{
				var newIndex:int = this.dataViewPort.calculateNavigationDestination(this.selectedIndex, event.keyCode);
				if(this.selectedIndex != newIndex)
				{
					event.preventDefault();
					this.selectedIndex = newIndex;
					var point:Point = Pool.getPoint();
					this.dataViewPort.getNearestScrollPositionForIndex(this.selectedIndex, point);
					this.scrollToPosition(point.x, point.y, this._keyScrollDuration);
					Pool.putPoint(point);
				}
			}
		}

		/**
		 * @private
		 */
		override protected function stage_gestureDirectionalTapHandler(event:TransformGestureEvent):void
		{
			if(event.isDefaultPrevented())
			{
				//something else has already handled this event
				return;
			}
			var keyCode:uint = int.MAX_VALUE;
			if(event.offsetY < 0)
			{
				keyCode = Keyboard.UP;
			}
			else if(event.offsetY > 0)
			{
				keyCode = Keyboard.DOWN;
			}
			else if(event.offsetX > 0)
			{
				keyCode = Keyboard.RIGHT;
			}
			else if(event.offsetX < 0)
			{
				keyCode = Keyboard.LEFT;
			}
			if(keyCode == int.MAX_VALUE)
			{
				return;
			}
			var newIndex:int = this.dataViewPort.calculateNavigationDestination(this.selectedIndex, keyCode);
			if(this.selectedIndex != newIndex)
			{
				event.stopImmediatePropagation();
				//event.preventDefault();
				this.selectedIndex = newIndex;
				var point:Point = Pool.getPoint();
				this.dataViewPort.getNearestScrollPositionForIndex(this.selectedIndex, point);
				this.scrollToPosition(point.x, point.y, this._keyScrollDuration);
				Pool.putPoint(point);
			}
		}

		/**
		 * @private
		 */
		protected function dataProvider_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function dataProvider_resetHandler(event:Event):void
		{
			this.horizontalScrollPosition = 0;
			this.verticalScrollPosition = 0;

			//the entire data provider was replaced. select no item.
			this._selectedIndices.removeAll();
		}

		/**
		 * @private
		 */
		protected function dataProvider_addItemHandler(event:Event, index:int):void
		{
			if(this._selectedIndex == -1)
			{
				return;
			}
			var selectionChanged:Boolean = false;
			var newIndices:Vector.<int> = new <int>[];
			var indexCount:int = this._selectedIndices.length;
			for(var i:int = 0; i < indexCount; i++)
			{
				var currentIndex:int = this._selectedIndices.getItemAt(i) as int;
				if(currentIndex >= index)
				{
					currentIndex++;
					selectionChanged = true;
				}
				newIndices.push(currentIndex);
			}
			if(selectionChanged)
			{
				this._selectedIndices.data = newIndices;
			}
		}

		/**
		 * @private
		 */
		protected function dataProvider_removeAllHandler(event:Event):void
		{
			this.selectedIndex = -1;
		}

		/**
		 * @private
		 */
		protected function dataProvider_removeItemHandler(event:Event, index:int):void
		{
			if(this._selectedIndex == -1)
			{
				return;
			}
			var selectionChanged:Boolean = false;
			var newIndices:Vector.<int> = new <int>[];
			var indexCount:int = this._selectedIndices.length;
			for(var i:int = 0; i < indexCount; i++)
			{
				var currentIndex:int = this._selectedIndices.getItemAt(i) as int;
				if(currentIndex == index)
				{
					selectionChanged = true;
				}
				else
				{
					if(currentIndex > index)
					{
						currentIndex--;
						selectionChanged = true;
					}
					newIndices.push(currentIndex);
				}
			}
			if(selectionChanged)
			{
				this._selectedIndices.data = newIndices;
			}
		}

		/**
		 * @private
		 */
		protected function refreshSelectedIndicesAfterFilterOrSort():void
		{
			if(this._selectedIndex == -1)
			{
				return;
			}
			var selectionChanged:Boolean = false;
			var newIndices:Vector.<int> = new <int>[];
			var pushIndex:int = 0;
			var count:int = this._selectedItems.length;
			for(var i:int = 0; i < count; i++)
			{
				var selectedItem:Object = this._selectedItems[i];
				var oldIndex:int = this._selectedIndices.getItemAt(i) as int;
				var newIndex:int = this._dataProvider.getItemIndex(selectedItem);
				if(newIndex >= 0)
				{
					if(newIndex != oldIndex)
					{
						//the item was not filtered, but it moved to a new index
						selectionChanged = true;
					}
					newIndices[pushIndex] = newIndex;
					pushIndex++;
				}
				else
				{
					//the item is filtered, so it should not be selected
					selectionChanged = true;
				}
			}
			if(selectionChanged)
			{
				this._selectedIndices.data = newIndices;
			}
		}

		/**
		 * @private
		 */
		protected function dataProvider_filterChangeHandler(event:Event):void
		{
			this.refreshSelectedIndicesAfterFilterOrSort();
		}

		/**
		 * @private
		 */
		protected function dataProvider_sortChangeHandler(event:Event):void
		{
			this.refreshSelectedIndicesAfterFilterOrSort();
		}

		/**
		 * @private
		 */
		protected function dataProvider_replaceItemHandler(event:Event, index:int):void
		{
			if(this._selectedIndex == -1)
			{
				return;
			}
			var indexOfIndex:int = this._selectedIndices.getItemIndex(index);
			if(indexOfIndex >= 0)
			{
				this._selectedIndices.removeItemAt(indexOfIndex);
			}
		}

		/**
		 * @private
		 */
		protected function selectedIndices_changeHandler(event:Event):void
		{
			this.getSelectedItems(this._selectedItems);
			if(this._selectedIndices.length > 0)
			{
				this._selectedIndex = this._selectedIndices.getItemAt(0) as int;
			}
			else
			{
				if(this._selectedIndex < 0)
				{
					//no change
					return;
				}
				this._selectedIndex = -1;
			}
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		private function layout_scrollHandler(event:Event, scrollOffset:Point):void
		{
			var layout:IVariableVirtualLayout = IVariableVirtualLayout(this._layout);
			if(!this.isScrolling || !layout.useVirtualLayout || !layout.hasVariableItemDimensions)
			{
				return;
			}

			var scrollOffsetX:Number = scrollOffset.x;
			this._startHorizontalScrollPosition += scrollOffsetX;
			this._horizontalScrollPosition += scrollOffsetX;
			if(this._horizontalAutoScrollTween)
			{
				this._targetHorizontalScrollPosition += scrollOffsetX;
				this.throwTo(this._targetHorizontalScrollPosition, NaN, this._horizontalAutoScrollTween.totalTime - this._horizontalAutoScrollTween.currentTime);
			}

			var scrollOffsetY:Number = scrollOffset.y;
			this._startVerticalScrollPosition += scrollOffsetY;
			this._verticalScrollPosition += scrollOffsetY;
			if(this._verticalAutoScrollTween)
			{
				this._targetVerticalScrollPosition += scrollOffsetY;
				this.throwTo(NaN, this._targetVerticalScrollPosition, this._verticalAutoScrollTween.totalTime - this._verticalAutoScrollTween.currentTime);
			}
		}
	}
}

================================================
FILE: source/feathers/controls/NumericStepper.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IAdvancedNativeFocusOwner;
	import feathers.core.ITextBaselineControl;
	import feathers.core.PropertyProxy;
	import feathers.events.ExclusiveTouch;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;
	import feathers.utils.math.clamp;
	import feathers.utils.math.roundToNearest;
	import feathers.utils.math.roundToPrecision;

	import flash.events.TimerEvent;
	import flash.ui.Keyboard;
	import flash.utils.Timer;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.events.KeyboardEvent;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	/**
	 * How the buttons are positioned relative to the text input.
	 *
	 * <p>In the following example, the button layout is set to place the
	 * buttons on the right side, stacked vertically, for a desktop
	 * appearance:</p>
	 *
	 * <listing version="3.0">
	 * stepper.buttonLayoutMode = NumericStepper.StepperButtonLayoutMode.RIGHT_SIDE_VERTICAL;</listing>
	 *
	 * @default feathers.controls.StepperButtonLayoutMode.SPLIT_HORIZONTAL
	 *
	 * @see feathers.controls.StepperButtonLayoutMode#SPLIT_HORIZONTAL
	 * @see feathers.controls.StepperButtonLayoutMode#SPLIT_VERTICAL
	 * @see feathers.controls.StepperButtonLayoutMode#RIGHT_SIDE_VERTICAL
	 */
	[Style(name="buttonLayoutMode",type="String")]

	/**
	 * The gap, in pixels, between the numeric stepper's increment and
	 * decrement buttons when they are both positioned on the same side. If
	 * the buttons are split between two sides, this value is not used.
	 *
	 * <p>In the following example, the gap between buttons is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * stepper.buttonLayoutMode = StepperButtonLayoutMode.RIGHT_SIDE_VERTICAL;
	 * stepper.buttonGap = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:textInputGap
	 * @see #style:buttonLayoutMode
	 */
	[Style(name="buttonGap",type="Number")]

	/**
	 * A style name to add to the numeric stepper's decrement button
	 * sub-component. Typically used by a theme to provide different styles
	 * to different numeric steppers.
	 *
	 * <p>In the following example, a custom decrement button style name is
	 * passed to the stepper:</p>
	 *
	 * <listing version="3.0">
	 * stepper.customDecrementButtonStyleName = "my-custom-decrement-button";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-decrement-button", setCustomDecrementButtonStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #decrementButtonFactory
	 */
	[Style(name="customDecrementButtonStyleName",type="String")]

	/**
	 * A style name to add to the numeric stepper's increment button
	 * sub-component. Typically used by a theme to provide different styles
	 * to different numeric steppers.
	 *
	 * <p>In the following example, a custom increment button style name is
	 * passed to the stepper:</p>
	 *
	 * <listing version="3.0">
	 * stepper.customIncrementButtonStyleName = "my-custom-increment-button";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-increment-button", setCustomIncrementButtonStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #incrementButtonFactory
	 */
	[Style(name="customIncrementButtonStyleName",type="String")]

	/**
	 * A style name to add to the numeric stepper's text input sub-component.
	 * Typically used by a theme to provide different styles to different
	 * text inputs.
	 *
	 * <p>In the following example, a custom text input style name is passed
	 * to the stepper:</p>
	 *
	 * <listing version="3.0">
	 * stepper.customTextInputStyleName = "my-custom-text-input";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( TextInput ).setFunctionForStyleName( "my-custom-text-input", setCustomTextInputStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_TEXT_INPUT
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #textInputFactory
	 */
	[Style(name="customTextInputStyleName",type="String")]

	/**
	 * The text displayed by the decrement button. Often, there is no text
	 * displayed on this button and an icon is used instead.
	 *
	 * <p>In the following example, the decrement button's label is customized:</p>
	 *
	 * <listing version="3.0">
	 * stepper.decrementButtonLabel = "-";</listing>
	 *
	 * @default null
	 */
	[Style(name="decrementButtonLabel",type="String")]

	/**
	 * The text displayed by the increment button. Often, there is no text
	 * displayed on this button and an icon is used instead.
	 *
	 * <p>In the following example, the increment button's label is customized:</p>
	 *
	 * <listing version="3.0">
	 * stepper.incrementButtonLabel = "+";</listing>
	 *
	 * @default null
	 */
	[Style(name="incrementButtonLabel",type="String")]

	/**
	 * The gap, in pixels, between the numeric stepper's text input and its
	 * buttons. If the buttons are split, this gap is used on both sides. If
	 * the buttons both appear on the same side, the gap is used only on
	 * that side.
	 *
	 * <p>In the following example, the gap between the text input and buttons is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * stepper.textInputGap = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:buttonGap
	 * @see #style:buttonLayoutMode
	 */
	[Style(name="textInputGap",type="Number")]

	/**
	 * Dispatched when the stepper's value changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #value
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Select a value between a minimum and a maximum by using increment and
	 * decrement buttons or typing in a value in a text input.
	 *
	 * <p>The following example sets the stepper's range and listens for when
	 * the value changes:</p>
	 *
	 * <listing version="3.0">
	 * var stepper:NumericStepper = new NumericStepper();
	 * stepper.minimum = 0;
	 * stepper.maximum = 100;
	 * stepper.step = 1;
	 * stepper.value = 12;
	 * stepper.addEventListener( Event.CHANGE, stepper_changeHandler );
	 * this.addChild( stepper );</listing>
	 *
	 * @see ../../../help/numeric-stepper.html How to use the Feathers NumericStepper component
	 *
	 * @productversion Feathers 1.1.0
	 */
	public class NumericStepper extends FeathersControl implements IRange, IAdvancedNativeFocusOwner, ITextBaselineControl
	{
		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_DECREMENT_BUTTON_FACTORY:String = "decrementButtonFactory";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_INCREMENT_BUTTON_FACTORY:String = "incrementButtonFactory";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_TEXT_INPUT_FACTORY:String = "textInputFactory";

		/**
		 * The default value added to the <code>styleNameList</code> of the decrement
		 * button.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON:String = "feathers-numeric-stepper-decrement-button";

		/**
		 * The default value added to the <code>styleNameList</code> of the increment
		 * button.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON:String = "feathers-numeric-stepper-increment-button";

		/**
		 * The default value added to the <code>styleNameList</code> of the text
		 * input.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_TEXT_INPUT:String = "feathers-numeric-stepper-text-input";

		/**
		 * The default <code>IStyleProvider</code> for all <code>NumericStepper</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static function defaultDecrementButtonFactory():Button
		{
			return new Button();
		}

		/**
		 * @private
		 */
		protected static function defaultIncrementButtonFactory():Button
		{
			return new Button();
		}

		/**
		 * @private
		 */
		protected static function defaultTextInputFactory():TextInput
		{
			return new TextInput();
		}

		/**
		 * Constructor.
		 */
		public function NumericStepper()
		{
			super();
			this.addEventListener(Event.REMOVED_FROM_STAGE, numericStepper_removedFromStageHandler);
		}

		/**
		 * The value added to the <code>styleNameList</code> of the decrement
		 * button. This variable is <code>protected</code> so that sub-classes
		 * can customize the decrement button style name in their constructors
		 * instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON</code>.
		 *
		 * <p>To customize the decrement button name without subclassing, see
		 * <code>customDecrementButtonStyleName</code>.</p>
		 *
		 * @see #style:customDecrementButtonStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var decrementButtonStyleName:String = DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON;

		/**
		 * The value added to the <code>styleNameList</code> of the increment
		 * button. This variable is <code>protected</code> so that sub-classes
		 * can customize the increment button style name in their constructors
		 * instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON</code>.
		 *
		 * <p>To customize the increment button name without subclassing, see
		 * <code>customIncrementButtonStyleName</code>.</p>
		 *
		 * @see #style:customIncrementButtonStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var incrementButtonStyleName:String = DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON;

		/**
		 * The value added to the <code>styleNameList</code> of the text input.
		 * This variable is <code>protected</code> so that sub-classes can
		 * customize the text input style name in their constructors instead of
		 * using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_TEXT_INPUT</code>.
		 *
		 * <p>To customize the text input name without subclassing, see
		 * <code>customTextInputStyleName</code>.</p>
		 *
		 * @see #style:customTextInputStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var textInputStyleName:String = DEFAULT_CHILD_STYLE_NAME_TEXT_INPUT;

		/**
		 * The decrement button sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #createDecrementButton()
		 */
		protected var decrementButton:Button;

		/**
		 * The increment button sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #createIncrementButton()
		 */
		protected var incrementButton:Button;

		/**
		 * The text input sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #createTextInput()
		 */
		protected var textInput:TextInput;

		/**
		 * @private
		 */
		protected var textInputExplicitWidth:Number;

		/**
		 * @private
		 */
		protected var textInputExplicitHeight:Number;

		/**
		 * @private
		 */
		protected var textInputExplicitMinWidth:Number;

		/**
		 * @private
		 */
		protected var textInputExplicitMinHeight:Number;

		/**
		 * @private
		 */
		protected var touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _textInputHasFocus:Boolean = false;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return NumericStepper.globalStyleProvider;
		}

		/**
		 * A text input's text editor may be an <code>INativeFocusOwner</code>,
		 * so we need to return the value of its <code>nativeFocus</code>
		 * property.
		 *
		 * @see feathers.core.INativeFocusOwner
		 */
		public function get nativeFocus():Object
		{
			if(this.textInput !== null)
			{
				return this.textInput.nativeFocus;
			}
			return null;
		}

		/**
		 * @private
		 */
		protected var _value:Number = 0;

		/**
		 * The value of the numeric stepper, between the minimum and maximum.
		 *
		 * <p>In the following example, the value is changed to 12:</p>
		 *
		 * <listing version="3.0">
		 * stepper.minimum = 0;
		 * stepper.maximum = 100;
		 * stepper.step = 1;
		 * stepper.value = 12;</listing>
		 *
		 * @default 0
		 *
		 * @see #minimum
		 * @see #maximum
		 * @see #step
		 * @see #event:change
		 */
		public function get value():Number
		{
			return this._value;
		}

		/**
		 * @private
		 */
		public function set value(newValue:Number):void
		{
			if(this._step != 0 && newValue != this._maximum && newValue != this._minimum)
			{
				//roundToPrecision helps us to avoid numbers like 1.00000000000000001
				//caused by the inaccuracies of floating point math.
				newValue = roundToPrecision(roundToNearest(newValue - this._minimum, this._step) + this._minimum, 10);
			}
			newValue = clamp(newValue, this._minimum, this._maximum);
			if(this._value == newValue)
			{
				return;
			}
			this._value = newValue;
			this.invalidate(INVALIDATION_FLAG_DATA);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _minimum:Number = 0;

		/**
		 * The numeric stepper's value will not go lower than the minimum.
		 *
		 * <p>In the following example, the minimum is changed to 0:</p>
		 *
		 * <listing version="3.0">
		 * stepper.minimum = 0;
		 * stepper.maximum = 100;
		 * stepper.step = 1;
		 * stepper.value = 12;</listing>
		 *
		 * @default 0
		 *
		 * @see #value
		 * @see #maximum
		 * @see #step
		 */
		public function get minimum():Number
		{
			return this._minimum;
		}

		/**
		 * @private
		 */
		public function set minimum(value:Number):void
		{
			if(this._minimum == value)
			{
				return;
			}
			this._minimum = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _maximum:Number = 0;

		/**
		 * The numeric stepper's value will not go higher than the maximum.
		 *
		 * <p>In the following example, the maximum is changed to 100:</p>
		 *
		 * <listing version="3.0">
		 * stepper.minimum = 0;
		 * stepper.maximum = 100;
		 * stepper.step = 1;
		 * stepper.value = 12;</listing>
		 *
		 * @default 0
		 *
		 * @see #value
		 * @see #minimum
		 * @see #step
		 */
		public function get maximum():Number
		{
			return this._maximum;
		}

		/**
		 * @private
		 */
		public function set maximum(value:Number):void
		{
			if(this._maximum == value)
			{
				return;
			}
			this._maximum = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _step:Number = 0;

		/**
		 * As the numeric stepper's buttons are pressed, the value is snapped to
		 * a multiple of the step.
		 *
		 * <p>In the following example, the step is changed to 1:</p>
		 *
		 * <listing version="3.0">
		 * stepper.minimum = 0;
		 * stepper.maximum = 100;
		 * stepper.step = 1;
		 * stepper.value = 12;</listing>
		 *
		 * @default 0
		 *
		 * @see #value
		 * @see #minimum
		 * @see #maximum
		 */
		public function get step():Number
		{
			return this._step;
		}

		/**
		 * @private
		 */
		public function set step(value:Number):void
		{
			if(this._step == value)
			{
				return;
			}
			this._step = value;
		}

		/**
		 * @private
		 */
		protected var _useLeftAndRightKeys:Boolean = false;

		/**
		 * Indicates if the <code>Keyboard.LEFT</code> and
		 * <code>Keyboard.RIGHT</code> keys should be used to change the value
		 * of the stepper, instead of the default <code>Keyboard.DOWN</code> and
		 * <code>Keyboard.UP</code> keys.
		 *
		 * <p>In the following example, the left and right keys are preferred:</p>
		 *
		 * <listing version="3.0">
		 * stepper.useLeftAndRightKeys = true;</listing>
		 *
		 * @default false
		 */
		public function get useLeftAndRightKeys():Boolean
		{
			return this._useLeftAndRightKeys;
		}

		/**
		 * @private
		 */
		public function set useLeftAndRightKeys(newValue:Boolean):void
		{
			this._useLeftAndRightKeys = newValue;
		}

		/**
		 * @private
		 */
		protected var _valueFormatFunction:Function;

		/**
		 * A callback that formats the numeric stepper's value as a string to
		 * display to the user.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function(value:Number):String</pre>
		 *
		 * <p>In the following example, the stepper's value format function is
		 * customized:</p>
		 *
		 * <listing version="3.0">
		 * stepper.valueFormatFunction = function(value:Number):String
		 * {
		 *     return currencyFormatter.format(value, true);
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #valueParseFunction
		 */
		public function get valueFormatFunction():Function
		{
			return this._valueFormatFunction;
		}

		/**
		 * @private
		 */
		public function set valueFormatFunction(value:Function):void
		{
			if(this._valueFormatFunction == value)
			{
				return;
			}
			this._valueFormatFunction = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _valueParseFunction:Function;

		/**
		 * A callback that accepts the displayed text of the numeric stepper and
		 * converts it to a simple numeric value.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function(displayedText:String):Number</pre>
		 *
		 * <p>In the following example, the stepper's value parse function is
		 * customized:</p>
		 *
		 * <listing version="3.0">
		 * stepper.valueParseFunction = function(displayedText:String):Number
		 * {
		 *     return currencyFormatter.parse(displayedText).value;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #valueFormatFunction
		 */
		public function get valueParseFunction():Function
		{
			return this._valueParseFunction;
		}

		/**
		 * @private
		 */
		public function set valueParseFunction(value:Function):void
		{
			this._valueParseFunction = value;
		}

		/**
		 * @private
		 */
		protected var currentRepeatAction:Function;

		/**
		 * @private
		 */
		protected var _repeatTimer:Timer;

		/**
		 * @private
		 */
		protected var _repeatDelay:Number = 0.05;

		/**
		 * The time, in seconds, before actions are repeated. The first repeat
		 * happens after a delay that is five times longer than the following
		 * repeats.
		 *
		 * <p>In the following example, the stepper's repeat delay is set to
		 * 500 milliseconds:</p>
		 *
		 * <listing version="3.0">
		 * stepper.repeatDelay = 0.5;</listing>
		 *
		 * @default 0.05
		 */
		public function get repeatDelay():Number
		{
			return this._repeatDelay;
		}

		/**
		 * @private
		 */
		public function set repeatDelay(value:Number):void
		{
			if(this._repeatDelay == value)
			{
				return;
			}
			this._repeatDelay = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _buttonLayoutMode:String = StepperButtonLayoutMode.SPLIT_HORIZONTAL;

		[Inspectable(type="String",enumeration="splitHorizontal,splitVertical,rightSideVertical")]
		/**
		 * @private
		 */
		public function get buttonLayoutMode():String
		{
			return this._buttonLayoutMode;
		}

		/**
		 * @private
		 */
		public function set buttonLayoutMode(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._buttonLayoutMode === value)
			{
				return;
			}
			this._buttonLayoutMode = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _buttonGap:Number = 0;

		/**
		 * @private
		 */
		public function get buttonGap():Number
		{
			return this._buttonGap;
		}

		/**
		 * @private
		 */
		public function set buttonGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._buttonGap == value)
			{
				return;
			}
			this._buttonGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _textInputGap:Number = 0;

		/**
		 * @private
		 */
		public function get textInputGap():Number
		{
			return this._textInputGap;
		}

		/**
		 * @private
		 */
		public function set textInputGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._textInputGap == value)
			{
				return;
			}
			this._textInputGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _decrementButtonFactory:Function;

		/**
		 * A function used to generate the numeric stepper's decrement button
		 * sub-component. The decrement button must be an instance of
		 * <code>Button</code>. This factory can be used to change properties on
		 * the decrement button when it is first created. For instance, if you
		 * are skinning Feathers components without a theme, you might use this
		 * factory to set skins and other styles on the decrement button.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():Button</pre>
		 *
		 * <p>In the following example, a custom decrement button factory is passed
		 * to the stepper:</p>
		 *
		 * <listing version="3.0">
		 * stepper.decrementButtonFactory = function():Button
		 * {
		 *     var button:Button = new Button();
		 *     button.defaultSkin = new Image( upTexture );
		 *     button.downSkin = new Image( downTexture );
		 *     return button;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.Button
		 */
		public function get decrementButtonFactory():Function
		{
			return this._decrementButtonFactory;
		}

		/**
		 * @private
		 */
		public function set decrementButtonFactory(value:Function):void
		{
			if(this._decrementButtonFactory == value)
			{
				return;
			}
			this._decrementButtonFactory = value;
			this.invalidate(INVALIDATION_FLAG_DECREMENT_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customDecrementButtonStyleName:String;

		/**
		 * @private
		 */
		public function get customDecrementButtonStyleName():String
		{
			return this._customDecrementButtonStyleName;
		}

		/**
		 * @private
		 */
		public function set customDecrementButtonStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customDecrementButtonStyleName === value)
			{
				return;
			}
			this._customDecrementButtonStyleName = value;
			this.invalidate(INVALIDATION_FLAG_DECREMENT_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _decrementButtonProperties:PropertyProxy;

		/**
		 * An object that stores properties for the numeric stepper's decrement
		 * button sub-component, and the properties will be passed down to the
		 * decrement button when the numeric stepper validates. For a list of
		 * available properties, refer to <a href="Button.html"><code>feathers.controls.Button</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>decrementButtonFactory</code>
		 * function instead of using <code>decrementButtonProperties</code> will
		 * result in better performance.</p>
		 *
		 * <p>In the following example, the stepper's decrement button properties
		 * are updated:</p>
		 *
		 * <listing version="3.0">
		 * stepper.decrementButtonProperties.defaultSkin = new Image( upTexture );
		 * stepper.decrementButtonProperties.downSkin = new Image( downTexture );</listing>
		 *
		 * @default null
		 *
		 * @see #decrementButtonFactory
		 * @see feathers.controls.Button
		 */
		public function get decrementButtonProperties():Object
		{
			if(!this._decrementButtonProperties)
			{
				this._decrementButtonProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._decrementButtonProperties;
		}

		/**
		 * @private
		 */
		public function set decrementButtonProperties(value:Object):void
		{
			if(this._decrementButtonProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._decrementButtonProperties)
			{
				this._decrementButtonProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._decrementButtonProperties = PropertyProxy(value);
			if(this._decrementButtonProperties)
			{
				this._decrementButtonProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _decrementButtonLabel:String = null;

		/**
		 * @private
		 */
		public function get decrementButtonLabel():String
		{
			return this._decrementButtonLabel;
		}

		/**
		 * @private
		 */
		public function set decrementButtonLabel(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._decrementButtonLabel === value)
			{
				return;
			}
			this._decrementButtonLabel = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _incrementButtonFactory:Function;

		/**
		 * A function used to generate the numeric stepper's increment button
		 * sub-component. The increment button must be an instance of
		 * <code>Button</code>. This factory can be used to change properties on
		 * the increment button when it is first created. For instance, if you
		 * are skinning Feathers components without a theme, you might use this
		 * factory to set skins and other styles on the increment button.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():Button</pre>
		 *
		 * <p>In the following example, a custom increment button factory is passed
		 * to the stepper:</p>
		 *
		 * <listing version="3.0">
		 * stepper.incrementButtonFactory = function():Button
		 * {
		 *     var button:Button = new Button();
		 *     button.defaultSkin = new Image( upTexture );
		 *     button.downSkin = new Image( downTexture );
		 *     return button;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.Button
		 */
		public function get incrementButtonFactory():Function
		{
			return this._incrementButtonFactory;
		}

		/**
		 * @private
		 */
		public function set incrementButtonFactory(value:Function):void
		{
			if(this._incrementButtonFactory == value)
			{
				return;
			}
			this._incrementButtonFactory = value;
			this.invalidate(INVALIDATION_FLAG_INCREMENT_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customIncrementButtonStyleName:String;

		/**
		 * @private
		 */
		public function get customIncrementButtonStyleName():String
		{
			return this._customIncrementButtonStyleName;
		}

		/**
		 * @private
		 */
		public function set customIncrementButtonStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customIncrementButtonStyleName === value)
			{
				return;
			}
			this._customIncrementButtonStyleName = value;
			this.invalidate(INVALIDATION_FLAG_INCREMENT_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _incrementButtonProperties:PropertyProxy;

		/**
		 * An object that stores properties for the numeric stepper's increment
		 * button sub-component, and the properties will be passed down to the
		 * increment button when the numeric stepper validates. For a list of
		 * available properties, refer to <a href="Button.html"><code>feathers.controls.Button</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>incrementButtonFactory</code>
		 * function instead of using <code>incrementButtonProperties</code> will
		 * result in better performance.</p>
		 *
		 * <p>In the following example, the stepper's increment button properties
		 * are updated:</p>
		 *
		 * <listing version="3.0">
		 * stepper.incrementButtonProperties.defaultSkin = new Image( upTexture );
		 * stepper.incrementButtonProperties.downSkin = new Image( downTexture );</listing>
		 *
		 * @default null
		 *
		 * @see #incrementButtonFactory
		 * @see feathers.controls.Button
		 */
		public function get incrementButtonProperties():Object
		{
			if(!this._incrementButtonProperties)
			{
				this._incrementButtonProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._incrementButtonProperties;
		}

		/**
		 * @private
		 */
		public function set incrementButtonProperties(value:Object):void
		{
			if(this._incrementButtonProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._incrementButtonProperties)
			{
				this._incrementButtonProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._incrementButtonProperties = PropertyProxy(value);
			if(this._incrementButtonProperties)
			{
				this._incrementButtonProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _incrementButtonLabel:String = null;

		/**
		 * @private
		 */
		public function get incrementButtonLabel():String
		{
			return this._incrementButtonLabel;
		}

		/**
		 * @private
		 */
		public function set incrementButtonLabel(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._incrementButtonLabel === value)
			{
				return;
			}
			this._incrementButtonLabel = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _textInputFactory:Function;

		/**
		 * A function used to generate the numeric stepper's text input
		 * sub-component. The text input must be an instance of <code>TextInput</code>.
		 * This factory can be used to change properties on the text input when
		 * it is first created. For instance, if you are skinning Feathers
		 * components without a theme, you might use this factory to set skins
		 * and other styles on the text input.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():TextInput</pre>
		 *
		 * <p>In the following example, a custom text input factory is passed
		 * to the stepper:</p>
		 *
		 * <listing version="3.0">
		 * stepper.textInputFactory = function():TextInput
		 * {
		 *     var textInput:TextInput = new TextInput();
		 *     textInput.backgroundSkin = new Image( texture );
		 *     return textInput;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.TextInput
		 */
		public function get textInputFactory():Function
		{
			return this._textInputFactory;
		}

		/**
		 * @private
		 */
		public function set textInputFactory(value:Function):void
		{
			if(this._textInputFactory == value)
			{
				return;
			}
			this._textInputFactory = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_INPUT_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customTextInputStyleName:String;

		/**
		 * @private
		 */
		public function get customTextInputStyleName():String
		{
			return this._customTextInputStyleName;
		}

		/**
		 * @private
		 */
		public function set customTextInputStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customTextInputStyleName === value)
			{
				return;
			}
			this._customTextInputStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_INPUT_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _textInputProperties:PropertyProxy;

		/**
		 * An object that stores properties for the numeric stepper's text
		 * input sub-component, and the properties will be passed down to the
		 * text input when the numeric stepper validates. For a list of
		 * available properties, refer to <a href="TextInput.html"><code>feathers.controls.TextInput</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>textInputFactory</code> function
		 * instead of using <code>textInputProperties</code> will result in
		 * better performance.</p>
		 *
		 * <p>In the following example, the stepper's text input properties
		 * are updated:</p>
		 *
		 * <listing version="3.0">
		 * stepper.textInputProperties.backgroundSkin = new Image( texture );</listing>
		 *
		 * @default null
		 *
		 * @see #textInputFactory
		 * @see feathers.controls.TextInput
		 */
		public function get textInputProperties():Object
		{
			if(!this._textInputProperties)
			{
				this._textInputProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._textInputProperties;
		}

		/**
		 * @private
		 */
		public function set textInputProperties(value:Object):void
		{
			if(this._textInputProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._textInputProperties)
			{
				this._textInputProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._textInputProperties = PropertyProxy(value);
			if(this._textInputProperties)
			{
				this._textInputProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @inheritDoc
		 */
		public function get baseline():Number
		{
			if(!this.textInput)
			{
				return this.scaledActualHeight;
			}
			return this.scaleY * (this.textInput.y + this.textInput.baseline);
		}

		/**
		 * @private
		 */
		public function get hasFocus():Boolean
		{
			return this._hasFocus;
		}

		/**
		 * @private
		 */
		public function setFocus():void
		{
			if(this.textInput === null)
			{
				return;
			}
			this.textInput.setFocus();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var decrementButtonFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DECREMENT_BUTTON_FACTORY);
			var incrementButtonFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_INCREMENT_BUTTON_FACTORY);
			var textInputFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_TEXT_INPUT_FACTORY);
			var focusInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_FOCUS);

			if(decrementButtonFactoryInvalid)
			{
				this.createDecrementButton();
			}

			if(incrementButtonFactoryInvalid)
			{
				this.createIncrementButton();
			}

			if(textInputFactoryInvalid)
			{
				this.createTextInput();
			}

			if(decrementButtonFactoryInvalid || stylesInvalid)
			{
				this.refreshDecrementButtonStyles();
			}

			if(incrementButtonFactoryInvalid || stylesInvalid)
			{
				this.refreshIncrementButtonStyles();
			}

			if(textInputFactoryInvalid || stylesInvalid)
			{
				this.refreshTextInputStyles();
			}

			if(textInputFactoryInvalid || dataInvalid)
			{
				this.refreshTypicalText();
				this.refreshDisplayedText();
			}

			if(decrementButtonFactoryInvalid || stateInvalid)
			{
				this.decrementButton.isEnabled = this._isEnabled;
			}

			if(incrementButtonFactoryInvalid || stateInvalid)
			{
				this.incrementButton.isEnabled = this._isEnabled;
			}

			if(textInputFactoryInvalid || stateInvalid)
			{
				this.textInput.isEnabled = this._isEnabled;
			}

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			this.layoutChildren();

			if(sizeInvalid || focusInvalid)
			{
				this.refreshFocusIndicator();
			}
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			var newWidth:Number = this._explicitWidth;
			var newHeight:Number = this._explicitHeight;
			var newMinWidth:Number = this._explicitMinWidth;
			var newMinHeight:Number = this._explicitMinHeight;

			this.decrementButton.validate();
			this.incrementButton.validate();
			var decrementButtonWidth:Number = this.decrementButton.width;
			var decrementButtonHeight:Number = this.decrementButton.height;
			var decrementButtonMinWidth:Number = this.decrementButton.minWidth;
			var decrementButtonMinHeight:Number = this.decrementButton.minHeight;
			var incrementButtonWidth:Number = this.incrementButton.width;
			var incrementButtonHeight:Number = this.incrementButton.height;
			var incrementButtonMinWidth:Number = this.incrementButton.minWidth;
			var incrementButtonMinHeight:Number = this.incrementButton.minHeight;

			//we'll default to the values set in the textInputFactory
			var textInputWidth:Number = this.textInputExplicitWidth;
			var textInputHeight:Number = this.textInputExplicitHeight;
			var textInputMinWidth:Number = this.textInputExplicitMinWidth;
			var textInputMinHeight:Number = this.textInputExplicitMinHeight;
			var textInputMaxWidth:Number = Number.POSITIVE_INFINITY;
			var textInputMaxHeight:Number = Number.POSITIVE_INFINITY;

			if(this._buttonLayoutMode === StepperButtonLayoutMode.RIGHT_SIDE_VERTICAL)
			{
				var maxButtonWidth:Number = decrementButtonWidth;
				if(incrementButtonWidth > maxButtonWidth)
				{
					maxButtonWidth = incrementButtonWidth;
				}
				var maxButtonMinWidth:Number = decrementButtonMinWidth;
				if(incrementButtonMinWidth > maxButtonMinWidth)
				{
					maxButtonMinWidth = incrementButtonMinWidth;
				}

				if(!needsWidth)
				{
					textInputWidth = this._explicitWidth - maxButtonWidth - this._textInputGap;
				}
				if(!needsHeight)
				{
					textInputHeight = this._explicitHeight;
				}
				if(!needsMinWidth)
				{
					textInputMinWidth = this._explicitMinWidth - maxButtonMinWidth - this._textInputGap;
					if(this.textInputExplicitMinWidth > textInputMinWidth)
					{
						textInputMinWidth = this.textInputExplicitMinWidth;
					}
				}
				if(!needsMinHeight)
				{
					textInputMinHeight = this._explicitMinHeight;
					if(this.textInputExplicitMinHeight > textInputMinHeight)
					{
						textInputMinHeight = this.textInputExplicitMinHeight;
					}
				}
				textInputMaxWidth = this._explicitMaxWidth - maxButtonWidth - this._textInputGap;
			}
			else if(this._buttonLayoutMode === StepperButtonLayoutMode.SPLIT_VERTICAL)
			{
				if(!needsWidth)
				{
					textInputWidth = this._explicitWidth;
				}
				if(!needsHeight)
				{
					textInputHeight = this._explicitHeight - decrementButtonHeight - incrementButtonHeight;
				}
				if(!needsMinWidth)
				{
					textInputMinWidth = this._explicitMinWidth;
					if(this.textInputExplicitMinWidth > textInputMinWidth)
					{
						textInputMinWidth = this.textInputExplicitMinWidth;
					}
				}
				if(!needsMinHeight)
				{
					textInputMinHeight = this._explicitMinHeight - decrementButtonMinHeight - incrementButtonMinHeight;
					if(this.textInputExplicitMinHeight > textInputMinHeight)
					{
						textInputMinHeight = this.textInputExplicitMinHeight;
					}
				}
				textInputMaxHeight = this._explicitMaxHeight - decrementButtonHeight - incrementButtonHeight;
			}
			else //split horizontal
			{
				if(!needsWidth)
				{
					textInputWidth = this._explicitWidth - decrementButtonWidth - incrementButtonWidth;
				}
				if(!needsHeight)
				{
					textInputHeight = this._explicitHeight;
				}
				if(!needsMinWidth)
				{
					textInputMinWidth = this._explicitMinWidth - decrementButtonMinWidth - incrementButtonMinWidth;
					if(textInputMinWidth < this.textInputExplicitMinWidth)
					{
						textInputMinWidth = this.textInputExplicitMinWidth;
					}
				}
				if(!needsMinHeight)
				{
					textInputMinHeight = this._explicitMinHeight;
					if(this.textInputExplicitMinHeight > textInputMinHeight)
					{
						textInputMinHeight = this.textInputExplicitMinHeight;
					}
				}
				textInputMaxWidth = this._explicitMaxWidth - decrementButtonWidth - incrementButtonWidth;
			}

			if(textInputWidth < 0)
			{
				textInputWidth = 0;
			}
			if(textInputHeight < 0)
			{
				textInputHeight = 0;
			}
			if(textInputMinWidth < 0)
			{
				textInputMinWidth = 0;
			}
			if(textInputMinHeight < 0)
			{
				textInputMinHeight = 0;
			}
			this.textInput.width = textInputWidth;
			this.textInput.height = textInputHeight;
			this.textInput.minWidth = textInputMinWidth;
			this.textInput.minHeight = textInputMinHeight;
			this.textInput.maxWidth = textInputMaxWidth;
			this.textInput.maxHeight = textInputMaxHeight;
			this.textInput.validate();

			if(this._buttonLayoutMode === StepperButtonLayoutMode.RIGHT_SIDE_VERTICAL)
			{
				if(needsWidth)
				{
					newWidth = this.textInput.width + maxButtonWidth + this._textInputGap;
				}
				if(needsHeight)
				{
					newHeight = decrementButtonHeight + this._buttonGap + incrementButtonHeight;
					if(this.textInput.height > newHeight)
					{
						newHeight = this.textInput.height;
					}
				}
				if(needsMinWidth)
				{
					newMinWidth = this.textInput.minWidth + maxButtonMinWidth + this._textInputGap;
				}
				if(needsMinHeight)
				{
					newMinHeight = decrementButtonMinHeight + this._buttonGap + incrementButtonMinHeight;
					if(this.textInput.minHeight > newMinHeight)
					{
						newMinHeight = this.textInput.minHeight;
					}
				}
			}
			else if(this._buttonLayoutMode === StepperButtonLayoutMode.SPLIT_VERTICAL)
			{
				if(needsWidth)
				{
					newWidth = this.textInput.width;
					if(decrementButtonWidth > newWidth)
					{
						newWidth = decrementButtonWidth;
					}
					if(incrementButtonWidth > newWidth)
					{
						newWidth = incrementButtonWidth;
					}
				}
				if(needsHeight)
				{
					newHeight = decrementButtonHeight + this.textInput.height + incrementButtonHeight + 2 * this._textInputGap;
				}
				if(needsMinWidth)
				{
					newMinWidth = this.textInput.minWidth;
					if(decrementButtonMinWidth > newMinWidth)
					{
						newMinWidth = decrementButtonMinWidth;
					}
					if(incrementButtonMinWidth > newMinWidth)
					{
						newMinWidth = incrementButtonMinWidth;
					}
				}
				if(needsMinHeight)
				{
					newMinHeight = decrementButtonMinHeight + this.textInput.minHeight + incrementButtonMinHeight + 2 * this._textInputGap;
				}
			}
			else //split horizontal
			{
				if(needsWidth)
				{
					newWidth = decrementButtonWidth + this.textInput.width + incrementButtonWidth + 2 * this._textInputGap;
				}
				if(needsHeight)
				{
					newHeight = this.textInput.height;
					if(decrementButtonHeight > newHeight)
					{
						newHeight = decrementButtonHeight;
					}
					if(incrementButtonHeight > newHeight)
					{
						newHeight = incrementButtonHeight;
					}
				}
				if(needsMinWidth)
				{
					newMinWidth = decrementButtonMinWidth + this.textInput.minWidth + incrementButtonMinWidth + 2 * this._textInputGap;
				}
				if(needsMinHeight)
				{
					newMinHeight = this.textInput.minHeight;
					if(decrementButtonMinHeight > newMinHeight)
					{
						newMinHeight = decrementButtonMinHeight;
					}
					if(incrementButtonMinHeight > newMinHeight)
					{
						newMinHeight = incrementButtonMinHeight;
					}
				}
			}

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * @private
		 */
		protected function decrement():void
		{
			this.value = this._value - this._step;
			this.validate();
			this.textInput.selectRange(0, this.textInput.text.length);
		}

		/**
		 * @private
		 */
		protected function increment():void
		{
			this.value = this._value + this._step;
			this.validate();
			this.textInput.selectRange(0, this.textInput.text.length);
		}

		/**
		 * @private
		 */
		protected function toMinimum():void
		{
			this.value = this._minimum;
			this.validate();
			this.textInput.selectRange(0, this.textInput.text.length);
		}

		/**
		 * @private
		 */
		protected function toMaximum():void
		{
			this.value = this._maximum;
			this.validate();
			this.textInput.selectRange(0, this.textInput.text.length);
		}

		/**
		 * Creates and adds the <code>decrementButton</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #decrementButton
		 * @see #decrementButtonFactory
		 * @see #style:customDecrementButtonStyleName
		 */
		protected function createDecrementButton():void
		{
			if(this.decrementButton)
			{
				this.decrementButton.removeFromParent(true);
				this.decrementButton = null;
			}

			var factory:Function = this._decrementButtonFactory != null ? this._decrementButtonFactory : defaultDecrementButtonFactory;
			var decrementButtonStyleName:String = this._customDecrementButtonStyleName != null ? this._customDecrementButtonStyleName : this.decrementButtonStyleName;
			this.decrementButton = Button(factory());
			this.decrementButton.styleNameList.add(decrementButtonStyleName);
			this.decrementButton.addEventListener(TouchEvent.TOUCH, decrementButton_touchHandler);
			this.addChild(this.decrementButton);
		}

		/**
		 * Creates and adds the <code>incrementButton</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #incrementButton
		 * @see #incrementButtonFactory
		 * @see #style:customIncrementButtonStyleName
		 */
		protected function createIncrementButton():void
		{
			if(this.incrementButton)
			{
				this.incrementButton.removeFromParent(true);
				this.incrementButton = null;
			}

			var factory:Function = this._incrementButtonFactory != null ? this._incrementButtonFactory : defaultIncrementButtonFactory;
			var incrementButtonStyleName:String = this._customIncrementButtonStyleName != null ? this._customIncrementButtonStyleName : this.incrementButtonStyleName;
			this.incrementButton = Button(factory());
			this.incrementButton.styleNameList.add(incrementButtonStyleName);
			this.incrementButton.addEventListener(TouchEvent.TOUCH, incrementButton_touchHandler);
			this.addChild(this.incrementButton);
		}

		/**
		 * Creates and adds the <code>textInput</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #textInput
		 * @see #textInputFactory
		 * @see #style:customTextInputStyleName
		 */
		protected function createTextInput():void
		{
			if(this.textInput)
			{
				this.textInput.removeFromParent(true);
				this.textInput = null;
			}

			var factory:Function = this._textInputFactory != null ? this._textInputFactory : defaultTextInputFactory;
			var textInputStyleName:String = this._customTextInputStyleName != null ? this._customTextInputStyleName : this.textInputStyleName;
			this.textInput = TextInput(factory());
			this.textInput.styleNameList.add(textInputStyleName);
			this.textInput.addEventListener(FeathersEventType.ENTER, textInput_enterHandler);
			this.textInput.addEventListener(FeathersEventType.FOCUS_IN, textInput_focusInHandler);
			this.textInput.addEventListener(FeathersEventType.FOCUS_OUT, textInput_focusOutHandler);
			//while we're setting isFocusEnabled to false on the text input when
			//we have a focus manager, we'll still be able to call setFocus() on
			//the text input manually.
			this.textInput.isFocusEnabled = !this._focusManager;
			this.addChild(this.textInput);

			//we will use these values for measurement, if possible
			this.textInput.initializeNow();
			this.textInputExplicitWidth = this.textInput.explicitWidth;
			this.textInputExplicitHeight = this.textInput.explicitHeight;
			this.textInputExplicitMinWidth = this.textInput.explicitMinWidth;
			this.textInputExplicitMinHeight = this.textInput.explicitMinHeight;
		}

		/**
		 * @private
		 */
		protected function refreshDecrementButtonStyles():void
		{
			for(var propertyName:String in this._decrementButtonProperties)
			{
				var propertyValue:Object = this._decrementButtonProperties[propertyName];
				this.decrementButton[propertyName] = propertyValue;
			}
			this.decrementButton.label = this._decrementButtonLabel;
		}

		/**
		 * @private
		 */
		protected function refreshIncrementButtonStyles():void
		{
			for(var propertyName:String in this._incrementButtonProperties)
			{
				var propertyValue:Object = this._incrementButtonProperties[propertyName];
				this.incrementButton[propertyName] = propertyValue;
			}
			this.incrementButton.label = this._incrementButtonLabel;
		}

		/**
		 * @private
		 */
		protected function refreshTextInputStyles():void
		{
			for(var propertyName:String in this._textInputProperties)
			{
				var propertyValue:Object = this._textInputProperties[propertyName];
				this.textInput[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function refreshDisplayedText():void
		{
			if(this._valueFormatFunction != null)
			{
				this.textInput.text = this._valueFormatFunction(this._value);
			}
			else
			{
				this.textInput.text = this._value.toString();
			}
		}

		/**
		 * @private
		 */
		protected function refreshTypicalText():void
		{
			var typicalText:String = "";
			var maxCharactersBeforeDecimal:Number = Math.max(int(this._minimum).toString().length, int(this._maximum).toString().length, int(this._step).toString().length);

			//roundToPrecision() helps us to avoid numbers like 1.00000000000000001
			//caused by the inaccuracies of floating point math.
			var maxCharactersAfterDecimal:Number = Math.max(roundToPrecision(this._minimum - int(this._minimum), 10).toString().length,
				roundToPrecision(this._maximum - int(this._maximum), 10).toString().length,
				roundToPrecision(this._step - int(this._step), 10).toString().length) - 2;
			if(maxCharactersAfterDecimal < 0)
			{
				maxCharactersAfterDecimal = 0;
			}
			var characterCount:int = maxCharactersBeforeDecimal + maxCharactersAfterDecimal;
			for(var i:int = 0; i < characterCount; i++)
			{
				typicalText += "0";
			}
			if(maxCharactersAfterDecimal > 0)
			{
				typicalText += ".";
			}
			this.textInput.typicalText = typicalText;
		}

		/**
		 * @private
		 */
		protected function layoutChildren():void
		{
			if(this._buttonLayoutMode === StepperButtonLayoutMode.RIGHT_SIDE_VERTICAL)
			{
				var buttonHeight:Number = (this.actualHeight - this._buttonGap) / 2;
				this.incrementButton.y = 0;
				this.incrementButton.height = buttonHeight;
				this.incrementButton.validate();

				this.decrementButton.y = buttonHeight + this._buttonGap;
				this.decrementButton.height = buttonHeight;
				this.decrementButton.validate();

				var buttonWidth:Number = Math.max(this.decrementButton.width, this.incrementButton.width);
				var buttonX:Number = this.actualWidth - buttonWidth;
				this.decrementButton.x = buttonX;
				this.incrementButton.x = buttonX;

				this.textInput.x = 0;
				this.textInput.y = 0;
				this.textInput.width = buttonX - this._textInputGap;
				this.textInput.height = this.actualHeight;
			}
			else if(this._buttonLayoutMode === StepperButtonLayoutMode.SPLIT_VERTICAL)
			{
				this.incrementButton.x = 0;
				this.incrementButton.y = 0;
				this.incrementButton.width = this.actualWidth;
				this.incrementButton.validate();

				this.decrementButton.x = 0;
				this.decrementButton.width = this.actualWidth;
				this.decrementButton.validate();
				this.decrementButton.y = this.actualHeight - this.decrementButton.height;

				this.textInput.x = 0;
				this.textInput.y = this.incrementButton.height + this._textInputGap;
				this.textInput.width = this.actualWidth;
				this.textInput.height = Math.max(0, this.actualHeight - this.decrementButton.height - this.incrementButton.height - 2 * this._textInputGap);
			}
			else //split horizontal
			{
				this.decrementButton.x = 0;
				this.decrementButton.y = 0;
				this.decrementButton.height = this.actualHeight;
				this.decrementButton.validate();

				this.incrementButton.y = 0;
				this.incrementButton.height = this.actualHeight;
				this.incrementButton.validate();
				this.incrementButton.x = this.actualWidth - this.incrementButton.width;

				this.textInput.x = this.decrementButton.width + this._textInputGap;
				this.textInput.width = this.actualWidth - this.decrementButton.width - this.incrementButton.width - 2 * this._textInputGap;
				this.textInput.height = this.actualHeight;
			}

			//final validation to avoid juggler next frame issues
			this.textInput.validate();
		}

		/**
		 * @private
		 */
		protected function startRepeatTimer(action:Function):void
		{
			if(this.touchPointID >= 0)
			{
				var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
				var claim:DisplayObject = exclusiveTouch.getClaim(this.touchPointID);
				if(claim != this)
				{
					if(claim)
					{
						//already claimed by another display object
						return;
					}
					else
					{
						exclusiveTouch.claimTouch(this.touchPointID, this);
					}
				}
			}
			this.currentRepeatAction = action;
			if(this._repeatDelay > 0)
			{
				if(!this._repeatTimer)
				{
					this._repeatTimer = new Timer(this._repeatDelay * 1000);
					this._repeatTimer.addEventListener(TimerEvent.TIMER, repeatTimer_timerHandler);
				}
				else
				{
					this._repeatTimer.reset();
					this._repeatTimer.delay = this._repeatDelay * 1000;
				}
				this._repeatTimer.start();
			}
		}

		/**
		 * @private
		 */
		protected function parseTextInputValue():void
		{
			if(this._valueParseFunction != null)
			{
				var newValue:Number = this._valueParseFunction(this.textInput.text);
			}
			else
			{
				newValue = parseFloat(this.textInput.text);
			}
			if(newValue === newValue) //!isNaN
			{
				this.value = newValue;
			}
			//we need to force invalidation just to be sure that the text input
			//is displaying the correct value.
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function childProperties_onChange(proxy:PropertyProxy, name:Object):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function numericStepper_removedFromStageHandler(event:Event):void
		{
			this.touchPointID = -1;
		}

		/**
		 * @private
		 */
		override protected function focusInHandler(event:Event):void
		{
			super.focusInHandler(event);
			this.textInput.setFocus();
			this.textInput.selectRange(0, this.textInput.text.length);
			this.stage.addEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
		}

		/**
		 * @private
		 */
		override protected function focusOutHandler(event:Event):void
		{
			super.focusOutHandler(event);
			this.textInput.clearFocus();
			this.stage.removeEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
		}

		/**
		 * @private
		 */
		protected function textInput_enterHandler(event:Event):void
		{
			this.parseTextInputValue();
		}

		/**
		 * @private
		 */
		protected function textInput_focusInHandler(event:Event):void
		{
			this._textInputHasFocus = true;
		}

		/**
		 * @private
		 */
		protected function textInput_focusOutHandler(event:Event):void
		{
			this._textInputHasFocus = false;
			this.parseTextInputValue();
		}

		/**
		 * @private
		 */
		protected function decrementButton_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this.touchPointID = -1;
				return;
			}

			if(this.touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this.decrementButton, TouchPhase.ENDED, this.touchPointID);
				if(!touch)
				{
					return;
				}
				this.touchPointID = -1;
				this._repeatTimer.stop();
				this.dispatchEventWith(FeathersEventType.END_INTERACTION);
			}
			else //if we get here, we don't have a saved touch ID yet
			{
				touch = event.getTouch(this.decrementButton, TouchPhase.BEGAN);
				if(!touch)
				{
					return;
				}
				if(this._textInputHasFocus)
				{
					this.parseTextInputValue();
				}
				this.touchPointID = touch.id;
				this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
				this.decrement();
				this.startRepeatTimer(this.decrement);
			}
		}

		/**
		 * @private
		 */
		protected function incrementButton_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this.touchPointID = -1;
				return;
			}

			if(this.touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this.incrementButton, TouchPhase.ENDED, this.touchPointID);
				if(!touch)
				{
					return;
				}
				this.touchPointID = -1;
				this._repeatTimer.stop();
				this.dispatchEventWith(FeathersEventType.END_INTERACTION);
			}
			else //if we get here, we don't have a saved touch ID yet
			{
				touch = event.getTouch(this.incrementButton, TouchPhase.BEGAN);
				if(!touch)
				{
					return;
				}
				if(this._textInputHasFocus)
				{
					this.parseTextInputValue();
				}
				this.touchPointID = touch.id;
				this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
				this.increment();
				this.startRepeatTimer(this.increment);
			}
		}

		/**
		 * @private
		 */
		protected function stage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.keyCode == Keyboard.HOME)
			{
				//prevent default so that text input selection doesn't change
				event.preventDefault();
				this.toMinimum();
			}
			else if(event.keyCode == Keyboard.END)
			{
				//prevent default so that text input selection doesn't change
				event.preventDefault();
				this.toMaximum();
			}
			else if(this._useLeftAndRightKeys)
			{
				if(event.keyCode == Keyboard.RIGHT)
				{
					//prevent default so that text input selection doesn't change
					event.preventDefault();
					this.increment();
				}
				else if(event.keyCode == Keyboard.LEFT)
				{
					//prevent default so that text input selection doesn't change
					event.preventDefault();
					this.decrement();
				}
			}
			else if(event.keyCode == Keyboard.UP)
			{
				//prevent default so that text input selection doesn't change
				event.preventDefault();
				this.increment();
			}
			else if(event.keyCode == Keyboard.DOWN)
			{
				//prevent default so that text input selection doesn't change
				event.preventDefault();
				this.decrement();
			}
		}

		/**
		 * @private
		 */
		protected function repeatTimer_timerHandler(event:TimerEvent):void
		{
			if(this._repeatTimer.currentCount < 5)
			{
				return;
			}
			this.currentRepeatAction();
		}
	}
}


================================================
FILE: source/feathers/controls/PageIndicator.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IValidating;
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.ILayout;
	import feathers.layout.IVirtualLayout;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.layout.ViewPortBounds;
	import feathers.skins.IStyleProvider;

	import flash.geom.Point;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * The symbols may be positioned vertically or horizontally.
	 *
	 * <p>In the following example, the direction is changed to vertical:</p>
	 *
	 * <listing version="3.0">
	 * pages.direction = Direction.VERTICAL;</listing>
	 *
	 * <p><strong>Note:</strong> The <code>Direction.NONE</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.Direction.HORIZONTAL
	 *
	 * @see feathers.layout.Direction#HORIZONTAL
	 * @see feathers.layout.Direction#VERTICAL
	 */
	[Style(name="direction",type="String")]

	/**
	 * The spacing, in pixels, between symbols.
	 *
	 * <p>In the following example, the gap between symbols is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * pages.gap = 20;</listing>
	 *
	 * @default 0
	 */
	[Style(name="gap",type="Number")]

	/**
	 * The alignment of the symbols on the horizontal axis.
	 *
	 * <p>In the following example, the symbols are horizontally aligned to
	 * the right:</p>
	 *
	 * <listing version="3.0">
	 * pages.horizontalAlign = HorizontalAlign.RIGHT;</listing>
	 *
	 * <p><strong>Note:</strong> The <code>HorizontalAlign.JUSTIFY</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.HorizontalAlign.CENTER
	 *
	 * @see feathers.layout.HorizontalAlign#LEFT
	 * @see feathers.layout.HorizontalAlign#CENTER
	 * @see feathers.layout.HorizontalAlign#RIGHT
	 */
	[Style(name="horizontalAlign",type="String")]

	/**
	 * Determines how the selected index changes on touch.
	 *
	 * <p>In the following example, the interaction mode is changed to precise:</p>
	 *
	 * <listing version="3.0">
	 * pages.interactionMode = PageIndicatorInteractionMode.PRECISE;</listing>
	 *
	 * @default feathers.controls.PageIndicatorInteractionMode.PREVIOUS_NEXT
	 *
	 * @see feathers.controls.PageIndicatorInteractionMode#PREVIOUS_NEXT
	 * @see feathers.controls.PageIndicatorInteractionMode#PRECISE
	 */
	[Style(name="interactionMode",type="String")]

	/**
	 * A function used to create a normal symbol. May be any Starling
	 * display object.
	 *
	 * <p>This function should have the following signature:</p>
	 * <pre>function():DisplayObject</pre>
	 *
	 * <p>In the following example, a custom normal symbol factory is provided
	 * to the page indicator:</p>
	 *
	 * <listing version="3.0">
	 * pages.normalSymbolFactory = function():DisplayObject
	 * {
	 *     return new Image( texture );
	 * };</listing>
	 *
	 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html starling.display.DisplayObject
	 * @see #style:selectedSymbolFactory
	 */
	[Style(name="normalSymbolFactory",type="Function")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * pages.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, between the top edge of the component
	 * and the top edge of the content.
	 *
	 * <p>In the following example, the top padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * pages.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the right edge of the component
	 * and the right edge of the content.
	 *
	 * <p>In the following example, the right padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * pages.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the bottom edge of the component
	 * and the bottom edge of the content.
	 *
	 * <p>In the following example, the bottom padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * pages.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the left edge of the component
	 * and the left edge of the content.
	 *
	 * <p>In the following example, the left padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * pages.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * A function used to create a selected symbol. May be any Starling
	 * display object.
	 *
	 * <p>This function should have the following signature:</p>
	 * <pre>function():DisplayObject</pre>
	 *
	 * <p>In the following example, a custom selected symbol factory is provided
	 * to the page indicator:</p>
	 *
	 * <listing version="3.0">
	 * pages.selectedSymbolFactory = function():DisplayObject
	 * {
	 *     return new Image( texture );
	 * };</listing>
	 *
	 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html starling.display.DisplayObject
	 * @see #style:normalSymbolFactory
	 */
	[Style(name="selectedSymbolFactory",type="Function")]

	/**
	 * The alignment of the symbols on the vertical axis.
	 *
	 * <p>In the following example, the symbols are vertically aligned to
	 * the bottom:</p>
	 *
	 * <listing version="3.0">
	 * pages.verticalAlign = VerticalAlign.BOTTOM;</listing>
	 *
	 * <p><strong>Note:</strong> The <code>VerticalAlign.JUSTIFY</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.VerticalAlign.MIDDLE
	 *
	 * @see feathers.layout.VerticalAlign#TOP
	 * @see feathers.layout.VerticalAlign#MIDDLE
	 * @see feathers.layout.VerticalAlign#BOTTOM
	 */
	[Style(name="verticalAlign",type="String")]

	/**
	 * Dispatched when the selected item changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #selectedIndex
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Displays a selected index, usually corresponding to a page index in
	 * another UI control, using a highlighted symbol.
	 *
	 * @see ../../../help/page-indicator.html How to use the Feathers PageIndicator component
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class PageIndicator extends FeathersControl
	{
		/**
		 * @private
		 */
		private static const LAYOUT_RESULT:LayoutBoundsResult = new LayoutBoundsResult();

		/**
		 * @private
		 */
		private static const SUGGESTED_BOUNDS:ViewPortBounds = new ViewPortBounds();

		/**
		 * The default <code>IStyleProvider</code> for all <code>PageIndicator</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static function defaultSelectedSymbolFactory():Quad
		{
			return new Quad(25, 25, 0xffffff);
		}

		/**
		 * @private
		 */
		protected static function defaultNormalSymbolFactory():Quad
		{
			return new Quad(25, 25, 0xcccccc);
		}

		/**
		 * Constructor.
		 */
		public function PageIndicator()
		{
			super();
			this.isQuickHitAreaEnabled = true;
			this.addEventListener(TouchEvent.TOUCH, touchHandler);
		}

		/**
		 * @private
		 */
		protected var selectedSymbol:DisplayObject;

		/**
		 * @private
		 */
		protected var cache:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * @private
		 */
		protected var unselectedSymbols:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * @private
		 */
		protected var symbols:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * @private
		 */
		protected var touchPointID:int = -1;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return PageIndicator.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _pageCount:int = 1;

		/**
		 * The number of available pages.
		 *
		 * <p>In the following example, the page count is changed:</p>
		 *
		 * <listing version="3.0">
		 * pages.pageCount = 5;</listing>
		 *
		 * @default 1
		 */
		public function get pageCount():int
		{
			return this._pageCount;
		}

		/**
		 * @private
		 */
		public function set pageCount(value:int):void
		{
			if(this._pageCount == value)
			{
				return;
			}
			this._pageCount = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _selectedIndex:int = 0;

		/**
		 * The currently selected index.
		 *
		 * <p>In the following example, the page indicator's selected index is
		 * changed:</p>
		 *
		 * <listing version="3.0">
		 * pages.selectedIndex = 2;</listing>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected index:</p>
		 *
		 * <listing version="3.0">
		 * function pages_changeHandler( event:Event ):void
		 * {
		 *     var pages:PageIndicator = PageIndicator( event.currentTarget );
		 *     var index:int = pages.selectedIndex;
		 * 
		 * }
		 * pages.addEventListener( Event.CHANGE, pages_changeHandler );</listing>
		 *
		 * @default 0
		 */
		public function get selectedIndex():int
		{
			return this._selectedIndex;
		}

		/**
		 * @private
		 */
		public function set selectedIndex(value:int):void
		{
			value = Math.max(0, Math.min(value, this._pageCount - 1));
			if(this._selectedIndex == value)
			{
				return;
			}
			this._selectedIndex = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _interactionMode:String = PageIndicatorInteractionMode.PREVIOUS_NEXT;

		[Inspectable(type="String",enumeration="previousNext,precise")]
		/**
		 * @private
		 */
		public function get interactionMode():String
		{
			return this._interactionMode;
		}

		/**
		 * @private
		 */
		public function set interactionMode(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._interactionMode = value;
		}

		/**
		 * @private
		 */
		protected var _layout:ILayout;

		/**
		 * @private
		 */
		protected var _direction:String = Direction.HORIZONTAL;

		[Inspectable(type="String",enumeration="horizontal,vertical")]
		/**
		 * @private
		 */
		public function get direction():String
		{
			return this._direction;
		}

		/**
		 * @private
		 */
		public function set direction(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._direction === value)
			{
				return;
			}
			this._direction = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.CENTER;

		[Inspectable(type="String",enumeration="left,center,right")]
		/**
		 * @private
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._horizontalAlign === value)
			{
				return;
			}
			this._horizontalAlign = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.MIDDLE;

		[Inspectable(type="String",enumeration="top,middle,bottom")]
		/**
		 * @private
		 */
		public function get verticalAlign():String
		{
			return this._verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._verticalAlign === value)
			{
				return;
			}
			this._verticalAlign = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _gap:Number = 0;

		/**
		 * @private
		 */
		public function get gap():Number
		{
			return this._gap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._gap == value)
			{
				return;
			}
			this._gap = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _normalSymbolFactory:Function = defaultNormalSymbolFactory;

		/**
		 * @private
		 */
		public function get normalSymbolFactory():Function
		{
			return this._normalSymbolFactory;
		}

		/**
		 * @private
		 */
		public function set normalSymbolFactory(value:Function):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._normalSymbolFactory === value)
			{
				return;
			}
			this._normalSymbolFactory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _selectedSymbolFactory:Function = defaultSelectedSymbolFactory;

		/**
		 * @private
		 */
		public function get selectedSymbolFactory():Function
		{
			return this._selectedSymbolFactory;
		}

		/**
		 * @private
		 */
		public function set selectedSymbolFactory(value:Function):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._selectedSymbolFactory === value)
			{
				return;
			}
			this._selectedSymbolFactory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var selectionInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SELECTED);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);

			if(dataInvalid || selectionInvalid || stylesInvalid)
			{
				this.refreshSymbols(stylesInvalid);
			}

			this.layoutSymbols(layoutInvalid);
		}

		/**
		 * @private
		 */
		protected function refreshSymbols(symbolsInvalid:Boolean):void
		{
			this.symbols.length = 0;
			var temp:Vector.<DisplayObject> = this.cache;
			if(symbolsInvalid)
			{
				var symbolCount:int = this.unselectedSymbols.length;
				for(var i:int = 0; i < symbolCount; i++)
				{
					var symbol:DisplayObject = this.unselectedSymbols.shift();
					this.removeChild(symbol, true);
				}
				if(this.selectedSymbol)
				{
					this.removeChild(this.selectedSymbol, true);
					this.selectedSymbol = null;
				}
			}
			this.cache = this.unselectedSymbols;
			this.unselectedSymbols = temp;
			for(i = 0; i < this._pageCount; i++)
			{
				if(i == this._selectedIndex)
				{
					if(!this.selectedSymbol)
					{
						this.selectedSymbol = this._selectedSymbolFactory();
						this.addChild(this.selectedSymbol);
					}
					this.symbols.push(this.selectedSymbol);
					if(this.selectedSymbol is IValidating)
					{
						IValidating(this.selectedSymbol).validate();
					}
				}
				else
				{
					if(this.cache.length > 0)
					{
						symbol = this.cache.shift();
					}
					else
					{
						symbol = this._normalSymbolFactory();
						this.addChild(symbol);
					}
					this.unselectedSymbols.push(symbol);
					this.symbols.push(symbol);
					if(symbol is IValidating)
					{
						IValidating(symbol).validate();
					}
				}
			}

			symbolCount = this.cache.length;
			for(i = 0; i < symbolCount; i++)
			{
				symbol = this.cache.shift();
				this.removeChild(symbol, true);
			}

		}

		/**
		 * @private
		 */
		protected function layoutSymbols(layoutInvalid:Boolean):void
		{
			if(layoutInvalid)
			{
				if(this._direction == Direction.VERTICAL && !(this._layout is VerticalLayout))
				{
					this._layout = new VerticalLayout();
					IVirtualLayout(this._layout).useVirtualLayout = false;
				}
				else if(this._direction != Direction.VERTICAL && !(this._layout is HorizontalLayout))
				{
					this._layout = new HorizontalLayout();
					IVirtualLayout(this._layout).useVirtualLayout = false;
				}
				if(this._layout is VerticalLayout)
				{
					var verticalLayout:VerticalLayout = VerticalLayout(this._layout);
					verticalLayout.paddingTop = this._paddingTop;
					verticalLayout.paddingRight = this._paddingRight;
					verticalLayout.paddingBottom = this._paddingBottom;
					verticalLayout.paddingLeft = this._paddingLeft;
					verticalLayout.gap = this._gap;
					verticalLayout.horizontalAlign = this._horizontalAlign;
					verticalLayout.verticalAlign = this._verticalAlign;
				}
				if(this._layout is HorizontalLayout)
				{
					var horizontalLayout:HorizontalLayout = HorizontalLayout(this._layout);
					horizontalLayout.paddingTop = this._paddingTop;
					horizontalLayout.paddingRight = this._paddingRight;
					horizontalLayout.paddingBottom = this._paddingBottom;
					horizontalLayout.paddingLeft = this._paddingLeft;
					horizontalLayout.gap = this._gap;
					horizontalLayout.horizontalAlign = this._horizontalAlign;
					horizontalLayout.verticalAlign = this._verticalAlign;
				}
			}
			SUGGESTED_BOUNDS.x = SUGGESTED_BOUNDS.y = 0;
			SUGGESTED_BOUNDS.scrollX = SUGGESTED_BOUNDS.scrollY = 0;
			SUGGESTED_BOUNDS.explicitWidth = this._explicitWidth;
			SUGGESTED_BOUNDS.explicitHeight = this._explicitHeight;
			SUGGESTED_BOUNDS.maxWidth = this._explicitMaxWidth;
			SUGGESTED_BOUNDS.maxHeight = this._explicitMaxHeight;
			SUGGESTED_BOUNDS.minWidth = this._explicitMinWidth;
			SUGGESTED_BOUNDS.minHeight = this._explicitMinHeight;
			this._layout.layout(this.symbols, SUGGESTED_BOUNDS, LAYOUT_RESULT);
			this.saveMeasurements(LAYOUT_RESULT.contentWidth, LAYOUT_RESULT.contentHeight,
				LAYOUT_RESULT.contentWidth, LAYOUT_RESULT.contentHeight);
		}

		/**
		 * @private
		 */
		protected function touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled || this._pageCount < 2)
			{
				this.touchPointID = -1;
				return;
			}

			if(this.touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this, TouchPhase.ENDED, this.touchPointID);
				if(!touch)
				{
					return;
				}
				this.touchPointID = -1;
				var point:Point = Pool.getPoint();
				touch.getLocation(this.stage, point);
				var isInBounds:Boolean = this.contains(this.stage.hitTest(point));
				if(isInBounds)
				{
					var lastPageIndex:int = this._pageCount - 1;
					this.globalToLocal(point, point);
					if(this._direction == Direction.VERTICAL)
					{
						if(this._interactionMode === PageIndicatorInteractionMode.PRECISE)
						{
							var symbolHeight:Number = this.selectedSymbol.height + (this.unselectedSymbols[0].height + this._gap) * lastPageIndex;
							var newIndex:int = Math.round(lastPageIndex * (point.y - this.symbols[0].y) / symbolHeight);
							if(newIndex < 0)
							{
								newIndex = 0;
							}
							else if(newIndex > lastPageIndex)
							{
								newIndex = lastPageIndex;
							}
							this.selectedIndex = newIndex;
						}
						else //previous/next
						{
							if(point.y < this.selectedSymbol.y)
							{
								this.selectedIndex = Math.max(0, this._selectedIndex - 1);
							}
							if(point.y > (this.selectedSymbol.y + this.selectedSymbol.height))
							{
								this.selectedIndex = Math.min(lastPageIndex, this._selectedIndex + 1);
							}
						}
					}
					else
					{
						if(this._interactionMode === PageIndicatorInteractionMode.PRECISE)
						{
							var symbolWidth:Number = this.selectedSymbol.width + (this.unselectedSymbols[0].width + this._gap) * lastPageIndex;
							newIndex = Math.round(lastPageIndex * (point.x - this.symbols[0].x) / symbolWidth);
							if(newIndex < 0)
							{
								newIndex = 0;
							}
							else if(newIndex >= this._pageCount)
							{
								newIndex = lastPageIndex;
							}
							this.selectedIndex = newIndex;
						}
						else //previous/next
						{
							if(point.x < this.selectedSymbol.x)
							{
								this.selectedIndex = Math.max(0, this._selectedIndex - 1);
							}
							if(point.x > (this.selectedSymbol.x + this.selectedSymbol.width))
							{
								this.selectedIndex = Math.min(lastPageIndex, this._selectedIndex + 1);
							}
						}
					}
				}
				Pool.putPoint(point);
			}
			else //if we get here, we don't have a saved touch ID yet
			{
				touch = event.getTouch(this, TouchPhase.BEGAN);
				if(!touch)
				{
					return;
				}
				this.touchPointID = touch.id;
			}
		}

	}
}


================================================
FILE: source/feathers/controls/PageIndicatorInteractionMode.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * Interaction modes for page indicators.
	 *
	 * @see feathers.controls.PageIndicator
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class PageIndicatorInteractionMode
	{
		/**
		 * Touching the page indicator on the left of the selected symbol will
		 * select the previous index and to the right of the selected symbol
		 * will select the next index.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const PREVIOUS_NEXT:String = "previousNext";

		/**
		 * Touching the page indicator on a symbol will select that symbol's
		 * exact index.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const PRECISE:String = "precise";
	}
}


================================================
FILE: source/feathers/controls/Panel.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.IFeathersControl;
	import feathers.core.IFocusExtras;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IValidating;
	import feathers.core.PropertyProxy;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;

	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * A style name to add to the panel's header sub-component. Typically
	 * used by a theme to provide different styles to different panels.
	 *
	 * <p>In the following example, a custom header style name is passed to
	 * the panel:</p>
	 *
	 * <listing version="3.0">
	 * panel.customHeaderStyleName = "my-custom-header";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default (this example assumes that the
	 * header is a <code>Header</code>, but it can be any
	 * <code>IFeathersControl</code>):</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Header ).setFunctionForStyleName( "my-custom-header", setCustomHeaderStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_HEADER
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #headerFactory
	 */
	[Style(name="customHeaderStyleName",type="String")]

	/**
	 * A style name to add to the panel's footer sub-component. Typically
	 * used by a theme to provide different styles to different panels.
	 *
	 * <p>In the following example, a custom footer style name is passed to
	 * the panel:</p>
	 *
	 * <listing version="3.0">
	 * panel.customFooterStyleName = "my-custom-footer";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default (this example assumes that the
	 * footer is a <code>ScrollContainer</code>, but it can be any
	 * <code>IFeathersControl</code>):</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( ScrollContainer ).setFunctionForStyleName( "my-custom-footer", setCustomFooterStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_FOOTER
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #footerFactory
	 */
	[Style(name="customFooterStyleName",type="String")]

	/**
	 * Quickly sets all outer padding properties to the same value. The
	 * <code>outerPadding</code> getter always returns the value of
	 * <code>outerPaddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the outer padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * panel.outerPadding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:outerPaddingTop
	 * @see #style:outerPaddingRight
	 * @see #style:outerPaddingBottom
	 * @see #style:outerPaddingLeft
	 * @see feathers.controls.Scroller#style:padding
	 */
	[Style(name="outerPadding",type="Number")]

	/**
	 * The minimum space, in pixels, between the panel's top edge and the
	 * panel's header.
	 *
	 * <p>Note: The <code>paddingTop</code> property applies to the
	 * middle content only, and it does not affect the header. Use
	 * <code>outerPaddingTop</code> if you want to include padding above
	 * the header. <code>outerPaddingTop</code> and <code>paddingTop</code>
	 * may be used simultaneously to define padding around the outer edges
	 * of the panel and additional padding around its middle content.</p>
	 *
	 * <p>In the following example, the top padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * panel.outerPaddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:outerPadding
	 * @see feathers.controls.Scroller#style:paddingTop
	 */
	[Style(name="outerPaddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the panel's right edge and the
	 * panel's header, middle content, and footer.
	 *
	 * <p>Note: The <code>paddingRight</code> property applies to the middle
	 * content only, and it does not affect the header or footer. Use
	 * <code>outerPaddingRight</code> if you want to include padding around
	 * the header and footer too. <code>outerPaddingRight</code> and
	 * <code>paddingRight</code> may be used simultaneously to define
	 * padding around the outer edges of the panel plus additional padding
	 * around its middle content.</p>
	 *
	 * <p>In the following example, the right outer padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * panel.outerPaddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:outerPadding
	 * @see feathers.controls.Scroller#style:paddingRight
	 */
	[Style(name="outerPaddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the panel's bottom edge and the
	 * panel's footer.
	 *
	 * <p>Note: The <code>paddingBottom</code> property applies to the
	 * middle content only, and it does not affect the footer. Use
	 * <code>outerPaddingBottom</code> if you want to include padding below
	 * the footer. <code>outerPaddingBottom</code> and <code>paddingBottom</code>
	 * may be used simultaneously to define padding around the outer edges
	 * of the panel and additional padding around its middle content.</p>
	 *
	 * <p>In the following example, the bottom outer padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * panel.outerPaddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:outerPadding
	 * @see feathers.controls.Scroller#style:paddingBottom
	 */
	[Style(name="outerPaddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the panel's left edge and the
	 * panel's header, middle content, and footer.
	 *
	 * <p>Note: The <code>paddingLeft</code> property applies to the middle
	 * content only, and it does not affect the header or footer. Use
	 * <code>outerPaddingLeft</code> if you want to include padding around
	 * the header and footer too. <code>outerPaddingLeft</code> and
	 * <code>paddingLeft</code> may be used simultaneously to define padding
	 * around the outer edges of the panel and additional padding around its
	 * middle content.</p>
	 *
	 * <p>In the following example, the left outer padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scroller.outerPaddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:outerPadding
	 * @see feathers.controls.Scroller#style:paddingLeft
	 */
	[Style(name="outerPaddingLeft",type="Number")]

	/**
	 * A container with layout, optional scrolling, a header, and an optional
	 * footer.
	 *
	 * <p>The following example creates a panel with a horizontal layout and
	 * adds two buttons to it:</p>
	 *
	 * <listing version="3.0">
	 * var panel:Panel = new Panel();
	 * panel.title = "Is it time to party?";
	 * 
	 * var layout:HorizontalLayout = new HorizontalLayout();
	 * layout.gap = 20;
	 * layout.padding = 20;
	 * panel.layout = layout;
	 * 
	 * this.addChild( panel );
	 * 
	 * var yesButton:Button = new Button();
	 * yesButton.label = "Yes";
	 * panel.addChild( yesButton );
	 * 
	 * var noButton:Button = new Button();
	 * noButton.label = "No";
	 * panel.addChild( noButton );</listing>
	 *
	 * @see ../../../help/panel.html How to use the Feathers Panel component
	 *
	 * @productversion Feathers 1.1.0
	 */
	public class Panel extends ScrollContainer implements IFocusExtras
	{
		/**
		 * The default value added to the <code>styleNameList</code> of the header.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_HEADER:String = "feathers-panel-header";

		/**
		 * The default value added to the <code>styleNameList</code> of the footer.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_FOOTER:String = "feathers-panel-footer";

		/**
		 * The default <code>IStyleProvider</code> for all <code>Panel</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_HEADER_FACTORY:String = "headerFactory";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_FOOTER_FACTORY:String = "footerFactory";

		/**
		 * @private
		 */
		protected static function defaultHeaderFactory():IFeathersControl
		{
			return new Header();
		}

		/**
		 * Constructor.
		 */
		public function Panel()
		{
			super();
		}

		/**
		 * The header sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #headerFactory
		 * @see #createHeader()
		 */
		protected var header:IFeathersControl;

		/**
		 * The footer sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #footerFactory
		 * @see #createFooter()
		 */
		protected var footer:IFeathersControl;

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * header. This variable is <code>protected</code> so that sub-classes
		 * can customize the header style name in their constructors instead of
		 * using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_HEADER</code>.
		 *
		 * <p>To customize the header style name without subclassing, see
		 * <code>customHeaderStyleName</code>.</p>
		 *
		 * @see #style:customHeaderStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var headerStyleName:String = DEFAULT_CHILD_STYLE_NAME_HEADER;

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * footer. This variable is <code>protected</code> so that sub-classes
		 * can customize the footer style name in their constructors instead of
		 * using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_FOOTER</code>.
		 *
		 * <p>To customize the footer style name without subclassing, see
		 * <code>customFooterStyleName</code>.</p>
		 *
		 * @see #style:customFooterStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var footerStyleName:String = DEFAULT_CHILD_STYLE_NAME_FOOTER;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return Panel.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _explicitHeaderWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitHeaderHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitHeaderMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitHeaderMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitFooterWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitFooterHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitFooterMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitFooterMinHeight:Number;

		/**
		 * @private
		 */
		protected var _title:String = null;

		/**
		 * The panel's title to display in the header.
		 *
		 * <p>By default, this value is passed to the <code>title</code>
		 * property of the header, if that property exists. However, if the
		 * header is not a <code>feathers.controls.Header</code> instance,
		 * changing the value of <code>titleField</code> will allow the panel to
		 * pass its title to a different property on the header instead.</p>
		 *
		 * <p>In the following example, a custom header factory is provided to
		 * the panel:</p>
		 *
		 * <listing version="3.0">
		 * panel.title = "Settings";</listing>
		 *
		 * @default null
		 *
		 * @see #headerTitleField
		 * @see #headerFactory
		 */
		public function get title():String
		{
			return this._title;
		}

		/**
		 * @private
		 */
		public function set title(value:String):void
		{
			if(this._title == value)
			{
				return;
			}
			this._title = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _headerTitleField:String = "title";

		/**
		 * A property of the header that should be used to display the panel's
		 * title.
		 *
		 * <p>By default, this value is passed to the <code>title</code>
		 * property of the header, if that property exists. However, if the
		 * header is not a <code>feathers.controls.Header</code> instance,
		 * changing the value of <code>titleField</code> will allow the panel to
		 * pass the title to a different property name instead.</p>
		 *
		 * <p>In the following example, a <code>Button</code> is used as a
		 * custom header, and the title is passed to its <code>label</code>
		 * property:</p>
		 *
		 * <listing version="3.0">
		 * panel.headerFactory = function():IFeathersControl
		 * {
		 *     return new Button();
		 * };
		 * panel.titleField = "label";</listing>
		 *
		 * @default "title"
		 *
		 * @see #title
		 * @see #headerFactory
		 */
		public function get headerTitleField():String
		{
			return this._headerTitleField;
		}

		/**
		 * @private
		 */
		public function set headerTitleField(value:String):void
		{
			if(this._headerTitleField == value)
			{
				return;
			}
			this._headerTitleField = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _headerFactory:Function;

		/**
		 * A function used to generate the panel's header sub-component.
		 * The header must be an instance of <code>IFeathersControl</code>, but
		 * the default is an instance of <code>Header</code>. This factory can
		 * be used to change properties on the header when it is first
		 * created. For instance, if you are skinning Feathers components
		 * without a theme, you might use this factory to set skins and other
		 * styles on the header.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():IFeathersControl</pre>
		 *
		 * <p>In the following example, a custom header factory is provided to
		 * the panel:</p>
		 *
		 * <listing version="3.0">
		 * panel.headerFactory = function():IFeathersControl
		 * {
		 *     var header:Header = new Header();
		 *     var closeButton:Button = new Button();
		 *     closeButton.label = "Close";
		 *     closeButton.addEventListener( Event.TRIGGERED, closeButton_triggeredHandler );
		 *     header.rightItems = new &lt;DisplayObject&gt;[ closeButton ];
		 *     return header;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.Header
		 */
		public function get headerFactory():Function
		{
			return this._headerFactory;
		}

		/**
		 * @private
		 */
		public function set headerFactory(value:Function):void
		{
			if(this._headerFactory == value)
			{
				return;
			}
			this._headerFactory = value;
			this.invalidate(INVALIDATION_FLAG_HEADER_FACTORY);
			//hack because the super class doesn't know anything about the
			//header factory
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _customHeaderStyleName:String;

		/**
		 * @private
		 */
		public function get customHeaderStyleName():String
		{
			return this._customHeaderStyleName;
		}

		/**
		 * @private
		 */
		public function set customHeaderStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customHeaderStyleName === value)
			{
				return;
			}
			this._customHeaderStyleName = value;
			this.invalidate(INVALIDATION_FLAG_HEADER_FACTORY);
			//hack because the super class doesn't know anything about the
			//header factory
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _headerProperties:PropertyProxy;

		/**
		 * An object that stores properties for the container's header
		 * sub-component, and the properties will be passed down to the header
		 * when the container validates. Any Feathers component may be used as
		 * the container's header, so the available properties depend on which
		 * type of component is returned by <code>headerFactory</code>.
		 *
		 * <p>By default, the <code>headerFactory</code> will return a
		 * <code>Header</code> instance. If you aren't using a different type of
		 * component as the container's header, you can refer to
		 * <a href="Header.html"><code>feathers.controls.Header</code></a>
		 * for a list of available properties. Otherwise, refer to the
		 * appropriate documentation for details about which properties are
		 * available on the component that you're using as the header.</p>
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>headerFactory</code> function
		 * instead of using <code>headerProperties</code> will result in better
		 * performance.</p>
		 *
		 * <p>In the following example, the header properties are customized:</p>
		 *
		 * <listing version="3.0">
		 * var closeButton:Button = new Button();
		 * closeButton.label = "Close";
		 * closeButton.addEventListener( Event.TRIGGERED, closeButton_triggeredHandler );
		 * panel.headerProperties.rightItems = new &lt;DisplayObject&gt;[ closeButton ];</listing>
		 *
		 * @default null
		 *
		 * @see #headerFactory
		 * @see feathers.controls.Header
		 */
		public function get headerProperties():Object
		{
			if(!this._headerProperties)
			{
				this._headerProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._headerProperties;
		}

		/**
		 * @private
		 */
		public function set headerProperties(value:Object):void
		{
			if(this._headerProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._headerProperties)
			{
				this._headerProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._headerProperties = PropertyProxy(value);
			if(this._headerProperties)
			{
				this._headerProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _footerFactory:Function;

		/**
		 * A function used to generate the panel's footer sub-component.
		 * The footer must be an instance of <code>IFeathersControl</code>, and
		 * by default, there is no footer. This factory can be used to change
		 * properties on the footer when it is first created. For instance, if
		 * you are skinning Feathers components without a theme, you might use
		 * this factory to set skins and other styles on the footer.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():IFeathersControl</pre>
		 *
		 * <p>In the following example, a custom footer factory is provided to
		 * the panel:</p>
		 *
		 * <listing version="3.0">
		 * panel.footerFactory = function():IFeathersControl
		 * {
		 *     return new ScrollContainer();
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.FeathersControl
		 */
		public function get footerFactory():Function
		{
			return this._footerFactory;
		}

		/**
		 * @private
		 */
		public function set footerFactory(value:Function):void
		{
			if(this._footerFactory == value)
			{
				return;
			}
			this._footerFactory = value;
			this.invalidate(INVALIDATION_FLAG_FOOTER_FACTORY);
			//hack because the super class doesn't know anything about the
			//header factory
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _customFooterStyleName:String;

		/**
		 * @private
		 */
		public function get customFooterStyleName():String
		{
			return this._customFooterStyleName;
		}

		/**
		 * @private
		 */
		public function set customFooterStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customFooterStyleName === value)
			{
				return;
			}
			this._customFooterStyleName = value;
			this.invalidate(INVALIDATION_FLAG_FOOTER_FACTORY);
			//hack because the super class doesn't know anything about the
			//header factory
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _footerProperties:PropertyProxy;

		/**
		 * An object that stores properties for the container's footer
		 * sub-component, and the properties will be passed down to the footer
		 * when the container validates. Any Feathers component may be used as
		 * the container's footer, so the available properties depend on which
		 * type of component is returned by <code>footerFactory</code>. Refer to
		 * the appropriate documentation for details about which properties are
		 * available on the component that you're using as the footer.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>footerFactory</code> function
		 * instead of using <code>footerProperties</code> will result in better
		 * performance.</p>
		 *
		 * <p>In the following example, the footer properties are customized:</p>
		 *
		 * <listing version="3.0">
		 * panel.footerProperties.verticalScrollPolicy = ScrollPolicy.OFF;</listing>
		 *
		 * @default null
		 *
		 * @see #footerFactory
		 */
		public function get footerProperties():Object
		{
			if(!this._footerProperties)
			{
				this._footerProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._footerProperties;
		}

		/**
		 * @private
		 */
		public function set footerProperties(value:Object):void
		{
			if(this._footerProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._footerProperties)
			{
				this._footerProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._footerProperties = PropertyProxy(value);
			if(this._footerProperties)
			{
				this._footerProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _focusExtrasBefore:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * @inheritDoc
		 */
		public function get focusExtrasBefore():Vector.<DisplayObject>
		{
			return this._focusExtrasBefore;
		}

		/**
		 * @private
		 */
		private var _focusExtrasAfter:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * @inheritDoc
		 */
		public function get focusExtrasAfter():Vector.<DisplayObject>
		{
			return this._focusExtrasAfter;
		}

		/**
		 * @private
		 */
		public function get outerPadding():Number
		{
			return this._outerPaddingTop;
		}

		/**
		 * @private
		 */
		public function set outerPadding(value:Number):void
		{
			this.outerPaddingTop = value;
			this.outerPaddingRight = value;
			this.outerPaddingBottom = value;
			this.outerPaddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _outerPaddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get outerPaddingTop():Number
		{
			return this._outerPaddingTop;
		}

		/**
		 * @private
		 */
		public function set outerPaddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._outerPaddingTop == value)
			{
				return;
			}
			this._outerPaddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _outerPaddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get outerPaddingRight():Number
		{
			return this._outerPaddingRight;
		}

		/**
		 * @private
		 */
		public function set outerPaddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._outerPaddingRight == value)
			{
				return;
			}
			this._outerPaddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _outerPaddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get outerPaddingBottom():Number
		{
			return this._outerPaddingBottom;
		}

		/**
		 * @private
		 */
		public function set outerPaddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._outerPaddingBottom == value)
			{
				return;
			}
			this._outerPaddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _outerPaddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get outerPaddingLeft():Number
		{
			return this._outerPaddingLeft;
		}

		/**
		 * @private
		 */
		public function set outerPaddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._outerPaddingLeft == value)
			{
				return;
			}
			this._outerPaddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _ignoreHeaderResizing:Boolean = false;

		/**
		 * @private
		 */
		protected var _ignoreFooterResizing:Boolean = false;

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var headerFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_HEADER_FACTORY);
			var footerFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_FOOTER_FACTORY);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);

			if(headerFactoryInvalid)
			{
				this.createHeader();
			}

			if(footerFactoryInvalid)
			{
				this.createFooter();
			}

			if(headerFactoryInvalid || stylesInvalid)
			{
				this.refreshHeaderStyles();
			}

			if(footerFactoryInvalid || stylesInvalid)
			{
				this.refreshFooterStyles();
			}

			super.draw();
		}

		/**
		 * @inheritDoc
		 */
		override protected function autoSizeIfNeeded():Boolean
		{
			if(this._autoSizeMode === AutoSizeMode.STAGE)
			{
				//the implementation in ScrollContainer can handle this
				return super.autoSizeIfNeeded();
			}

			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			resetFluidChildDimensionsForMeasurement(this.currentBackgroundSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitBackgroundWidth, this._explicitBackgroundHeight,
				this._explicitBackgroundMinWidth, this._explicitBackgroundMinHeight,
				this._explicitBackgroundMaxWidth, this._explicitBackgroundMaxHeight);
			var measureBackground:IMeasureDisplayObject = this.currentBackgroundSkin as IMeasureDisplayObject;
			if(this.currentBackgroundSkin is IValidating)
			{
				IValidating(this.currentBackgroundSkin).validate();
			}

			//we don't measure the header and footer here because they are
			//handled in calculateViewPortOffsets(), which is automatically
			//called by Scroller before autoSizeIfNeeded().

			var newWidth:Number = this._explicitWidth;
			var newHeight:Number = this._explicitHeight;
			var newMinWidth:Number = this._explicitMinWidth;
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsWidth)
			{
				if(this._measureViewPort)
				{
					newWidth = this._viewPort.visibleWidth;
				}
				else
				{
					newWidth = 0;
				}
				//we don't need to account for the icon and gap because it is
				//already included in the left offset
				newWidth += this._rightViewPortOffset + this._leftViewPortOffset;
				var headerWidth:Number = this.header.width + this._outerPaddingLeft + this._outerPaddingRight;
				if(headerWidth > newWidth)
				{
					newWidth = headerWidth;
				}
				if(this.footer !== null)
				{
					var footerWidth:Number = this.footer.width + this._outerPaddingLeft + this._outerPaddingRight;
					if(footerWidth > newWidth)
					{
						newWidth = footerWidth;
					}
				}
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.width > newWidth)
				{
					newWidth = this.currentBackgroundSkin.width;
				}
			}
			if(needsHeight)
			{
				if(this._measureViewPort)
				{
					newHeight = this._viewPort.visibleHeight;
				}
				else
				{
					newHeight = 0;
				}
				newHeight += this._bottomViewPortOffset + this._topViewPortOffset;
				//we don't need to account for the header and footer because
				//they're already included in the top and bottom offsets
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.height > newHeight)
				{
					newHeight = this.currentBackgroundSkin.height;
				}
			}
			if(needsMinWidth)
			{
				if(this._measureViewPort)
				{
					newMinWidth = this._viewPort.minVisibleWidth;
				}
				else
				{
					newMinWidth = 0;
				}
				//we don't need to account for the icon and gap because it is
				//already included in the left offset
				newMinWidth += this._rightViewPortOffset + this._leftViewPortOffset;
				var headerMinWidth:Number = this.header.minWidth + this._outerPaddingLeft + this._outerPaddingRight;
				if(headerMinWidth > newMinWidth)
				{
					newMinWidth = headerMinWidth;
				}
				if(this.footer !== null)
				{
					var footerMinWidth:Number = this.footer.minWidth + this._outerPaddingLeft + this._outerPaddingRight;
					if(footerMinWidth > newMinWidth)
					{
						newMinWidth = footerMinWidth;
					}
				}
				if(this.currentBackgroundSkin !== null)
				{
					if(measureBackground !== null)
					{
						if(measureBackground.minWidth > newMinWidth)
						{
							newMinWidth = measureBackground.minWidth;
						}
					}
					else if(this._explicitBackgroundMinWidth > newMinWidth)
					{
						newMinWidth = this._explicitBackgroundMinWidth;
					}
				}
			}
			if(needsMinHeight)
			{
				if(this._measureViewPort)
				{
					newMinHeight = this._viewPort.minVisibleHeight;
				}
				else
				{
					newMinHeight = 0;
				}
				newMinHeight += this._bottomViewPortOffset + this._topViewPortOffset;
				//we don't need to account for the header and footer because
				//they're already included in the top and bottom offsets
				if(this.currentBackgroundSkin !== null)
				{
					if(measureBackground !== null)
					{
						if(measureBackground.minHeight > newMinHeight)
						{
							newMinHeight = measureBackground.minHeight;
						}
					}
					else if(this._explicitBackgroundMinHeight > newMinHeight)
					{
						newMinHeight = this._explicitBackgroundMinHeight;
					}
				}
			}

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * Creates and adds the <code>header</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #header
		 * @see #headerFactory
		 * @see #style:customHeaderStyleName
		 */
		protected function createHeader():void
		{
			if(this.header !== null)
			{
				this.header.removeEventListener(FeathersEventType.RESIZE, header_resizeHandler);
				var displayHeader:DisplayObject = DisplayObject(this.header);
				this._focusExtrasBefore.splice(this._focusExtrasBefore.indexOf(displayHeader), 1);
				this.removeRawChild(displayHeader, true);
				this.header = null;
			}

			var factory:Function = this._headerFactory != null ? this._headerFactory : defaultHeaderFactory;
			var headerStyleName:String = this._customHeaderStyleName != null ? this._customHeaderStyleName : this.headerStyleName;
			this.header = IFeathersControl(factory());
			this.header.styleNameList.add(headerStyleName);
			displayHeader = DisplayObject(this.header);
			this.addRawChild(displayHeader);
			this._focusExtrasBefore.push(displayHeader);
			this.header.addEventListener(FeathersEventType.RESIZE, header_resizeHandler);

			this.header.initializeNow();
			this._explicitHeaderWidth = this.header.explicitWidth;
			this._explicitHeaderHeight = this.header.explicitHeight;
			this._explicitHeaderMinWidth = this.header.explicitMinWidth;
			this._explicitHeaderMinHeight = this.header.explicitMinHeight;
		}

		/**
		 * Creates and adds the <code>footer</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #footer
		 * @see #footerFactory
		 * @see #style:customFooterStyleName
		 */
		protected function createFooter():void
		{
			if(this.footer !== null)
			{
				this.footer.removeEventListener(FeathersEventType.RESIZE, footer_resizeHandler);
				var displayFooter:DisplayObject = DisplayObject(this.footer);
				this._focusExtrasAfter.splice(this._focusExtrasAfter.indexOf(displayFooter), 1);
				this.removeRawChild(displayFooter, true);
				this.footer = null;
			}

			if(this._footerFactory === null)
			{
				return;
			}
			var footerStyleName:String = this._customFooterStyleName != null ? this._customFooterStyleName : this.footerStyleName;
			this.footer = IFeathersControl(this._footerFactory());
			this.footer.styleNameList.add(footerStyleName);
			this.footer.addEventListener(FeathersEventType.RESIZE, footer_resizeHandler);
			displayFooter = DisplayObject(this.footer);
			this.addRawChild(displayFooter);
			this._focusExtrasAfter.push(displayFooter);

			this.footer.initializeNow();
			this._explicitFooterWidth = this.footer.explicitWidth;
			this._explicitFooterHeight = this.footer.explicitHeight;
			this._explicitFooterMinWidth = this.footer.explicitMinWidth;
			this._explicitFooterMinHeight = this.footer.explicitMinHeight;
		}

		/**
		 * @private
		 */
		protected function refreshHeaderStyles():void
		{
			if(Object(this.header).hasOwnProperty(this._headerTitleField))
			{
				this.header[this._headerTitleField] = this._title;
			}
			for(var propertyName:String in this._headerProperties)
			{
				var propertyValue:Object = this._headerProperties[propertyName];
				this.header[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function refreshFooterStyles():void
		{
			for(var propertyName:String in this._footerProperties)
			{
				var propertyValue:Object = this._footerProperties[propertyName];
				this.footer[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		override protected function calculateViewPortOffsets(forceScrollBars:Boolean = false, useActualBounds:Boolean = false):void
		{
			super.calculateViewPortOffsets(forceScrollBars);

			this._leftViewPortOffset += this._outerPaddingLeft;
			this._rightViewPortOffset += this._outerPaddingRight;

			var oldIgnoreHeaderResizing:Boolean = this._ignoreHeaderResizing;
			this._ignoreHeaderResizing = true;
			if(useActualBounds)
			{
				this.header.width = this.actualWidth - this._outerPaddingLeft - this._outerPaddingRight;
				this.header.minWidth = this.actualMinWidth - this._outerPaddingLeft - this._outerPaddingRight;
			}
			else
			{
				this.header.width = this._explicitWidth - this._outerPaddingLeft - this._outerPaddingRight;
				this.header.minWidth = this._explicitMinWidth - this._outerPaddingLeft - this._outerPaddingRight;
			}
			this.header.maxWidth = this._explicitMaxWidth - this._outerPaddingLeft - this._outerPaddingRight;
			this.header.height = this._explicitHeaderHeight;
			this.header.minHeight = this._explicitHeaderMinHeight;
			this.header.validate();
			this._topViewPortOffset += this.header.height + this._outerPaddingTop;
			this._ignoreHeaderResizing = oldIgnoreHeaderResizing;

			if(this.footer !== null)
			{
				var oldIgnoreFooterResizing:Boolean = this._ignoreFooterResizing;
				this._ignoreFooterResizing = true;
				if(useActualBounds)
				{
					this.footer.width = this.actualWidth - this._outerPaddingLeft - this._outerPaddingRight;
					this.footer.minWidth = this.actualMinWidth - this._outerPaddingLeft - this._outerPaddingRight;
				}
				else
				{
					this.footer.width = this._explicitWidth - this._outerPaddingLeft - this._outerPaddingRight;
					this.footer.minWidth = this._explicitMinWidth - this._outerPaddingLeft - this._outerPaddingRight;
				}
				this.footer.maxWidth = this._explicitMaxWidth - this._outerPaddingLeft - this._outerPaddingRight;
				this.footer.height = this._explicitFooterHeight;
				this.footer.minHeight = this._explicitFooterMinHeight;
				this.footer.validate();
				this._bottomViewPortOffset += this.footer.height + this._outerPaddingBottom;
				this._ignoreFooterResizing = oldIgnoreFooterResizing;
			}
			else
			{
				this._bottomViewPortOffset += this._outerPaddingBottom;
			}
		}

		/**
		 * @private
		 */
		override protected function layoutChildren():void
		{
			super.layoutChildren();

			var oldIgnoreHeaderResizing:Boolean = this._ignoreHeaderResizing;
			this._ignoreHeaderResizing = true;
			this.header.x = this._outerPaddingLeft;
			this.header.y = this._outerPaddingTop;
			this.header.width = this.actualWidth - this._outerPaddingLeft - this._outerPaddingRight;
			this.header.height = this._explicitHeaderHeight;
			this.header.validate();
			this._ignoreHeaderResizing = oldIgnoreHeaderResizing;

			if(this.footer !== null)
			{
				var oldIgnoreFooterResizing:Boolean = this._ignoreFooterResizing;
				this._ignoreFooterResizing = true;
				this.footer.x = this._outerPaddingLeft;
				this.footer.width = this.actualWidth - this._outerPaddingLeft - this._outerPaddingRight;
				this.footer.height = this._explicitFooterHeight;
				this.footer.validate();
				this.footer.y = this.actualHeight - this.footer.height - this._outerPaddingBottom;
				this._ignoreFooterResizing = oldIgnoreFooterResizing;
			}
		}

		/**
		 * @private
		 */
		protected function header_resizeHandler(event:Event):void
		{
			if(this._ignoreHeaderResizing)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected function footer_resizeHandler(event:Event):void
		{
			if(this._ignoreFooterResizing)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}
	}
}


================================================
FILE: source/feathers/controls/PanelScreen.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.skins.IStyleProvider;
	import feathers.utils.display.getDisplayObjectDepthFromStage;

	import flash.events.KeyboardEvent;
	import flash.ui.Keyboard;

	import starling.events.Event;

	/**
	 * Dispatched when the transition animation begins as the screen is shown
	 * by the screen navigator.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.TRANSITION_IN_START
	 */
	[Event(name="transitionInStart",type="starling.events.Event")]

	/**
	 * Dispatched when the transition animation finishes as the screen is shown
	 * by the screen navigator.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.TRANSITION_IN_COMPLETE
	 */
	[Event(name="transitionInComplete",type="starling.events.Event")]

	/**
	 * Dispatched when the transition animation begins as a different screen is
	 * shown by the screen navigator and this screen is hidden.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.TRANSITION_OUT_START
	 */
	[Event(name="transitionOutStart",type="starling.events.Event")]

	/**
	 * Dispatched when the transition animation finishes as a different screen
	 * is shown by the screen navigator and this screen is hidden.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.TRANSITION_OUT_COMPLETE
	 */
	[Event(name="transitionOutComplete",type="starling.events.Event")]

	/**
	 * A screen for use with <code>ScreenNavigator</code>, based on <code>Panel</code>
	 * in order to provide a header and layout.
	 *
	 * <p>This component is generally not instantiated directly. Instead it is
	 * typically used as a super class for concrete implementations of screens.
	 * With that in mind, no code example is included here.</p>
	 *
	 * <p>The following example provides a basic framework for a new panel screen:</p>
	 *
	 * <listing version="3.0">
	 * package
	 * {
	 *     import feathers.controls.PanelScreen;
	 * 
	 *     public class CustomScreen extends PanelScreen
	 *     {
	 *         public function CustomScreen()
	 *         {
	 *             super();
	 *         }
	 * 
	 *         override protected function initialize():void
	 *         {
	 *             //runs once when screen is first added to the stage
	 *             //a good place to add children and customize the layout
	 * 
	 *             //don't forget to call this!
	 *             super.initialize()
	 *         }
	 *     }
	 * }</listing>
	 *
	 * @see ../../../panel-screen.html How to use the Feathers PanelScreen component
	 * @see feathers.controls.StackScreenNavigator
	 * @see feathers.controls.ScreenNavigator
	 *
	 * @productversion Feathers 1.1.0
	 */
	public class PanelScreen extends Panel implements IScreen
	{
		/**
		 * The default value added to the <code>styleNameList</code> of the header.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_HEADER:String = "feathers-panel-screen-header";

		/**
		 * The default value added to the <code>styleNameList</code> of the footer.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_FOOTER:String = "feathers-panel-screen-footer";

		/**
		 * The default <code>IStyleProvider</code> for all <code>PanelScreen</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function PanelScreen()
		{
			this.addEventListener(Event.ADDED_TO_STAGE, panelScreen_addedToStageHandler);
			super();
			this.headerStyleName = DEFAULT_CHILD_STYLE_NAME_HEADER;
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return PanelScreen.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _screenID:String;

		/**
		 * @inheritDoc
		 */
		public function get screenID():String
		{
			return this._screenID;
		}

		/**
		 * @private
		 */
		public function set screenID(value:String):void
		{
			this._screenID = value;
		}

		/**
		 * @private
		 */
		protected var _owner:Object;

		/**
		 * @inheritDoc
		 */
		public function get owner():Object
		{
			return this._owner;
		}

		/**
		 * @private
		 */
		public function set owner(value:Object):void
		{
			this._owner = value;
		}

		/**
		 * Optional callback for the back hardware key. Automatically handles
		 * keyboard events to cancel the default behavior.
		 *
		 * <p>This function has the following signature:</p>
		 *
		 * <pre>function():void</pre>
		 *
		 * <p>In the following example, a function will dispatch <code>Event.COMPLETE</code>
		 * when the back button is pressed:</p>
		 *
		 * <listing version="3.0">
		 * this.backButtonHandler = onBackButton;
		 * 
		 * private function onBackButton():void
		 * {
		 *     this.dispatchEvent( Event.COMPLETE );
		 * };</listing>
		 *
		 * @default null
		 */
		protected var backButtonHandler:Function;

		/**
		 * Optional callback for the menu hardware key. Automatically handles
		 * keyboard events to cancel the default behavior.
		 *
		 * <p>This function has the following signature:</p>
		 *
		 * <pre>function():void</pre>
		 *
		 * <p>In the following example, a function will be called when the menu
		 * button is pressed:</p>
		 *
		 * <listing version="3.0">
		 * this.menuButtonHandler = onMenuButton;
		 * 
		 * private function onMenuButton():void
		 * {
		 *     //do something with the menu button
		 * };</listing>
		 *
		 * @default null
		 */
		protected var menuButtonHandler:Function;

		/**
		 * Optional callback for the search hardware key. Automatically handles
		 * keyboard events to cancel the default behavior.
		 *
		 * <p>This function has the following signature:</p>
		 *
		 * <pre>function():void</pre>
		 *
		 * <p>In the following example, a function will be called when the search
		 * button is pressed:</p>
		 *
		 * <listing version="3.0">
		 * this.searchButtonHandler = onSearchButton;
		 * 
		 * private function onSearchButton():void
		 * {
		 *     //do something with the search button
		 * };</listing>
		 *
		 * @default null
		 */
		protected var searchButtonHandler:Function;

		/**
		 * @private
		 */
		protected function panelScreen_addedToStageHandler(event:Event):void
		{
			this.addEventListener(Event.REMOVED_FROM_STAGE, panelScreen_removedFromStageHandler);
			//using priority here is a hack so that objects higher up in the
			//display list have a chance to cancel the event first.
			var priority:int = -getDisplayObjectDepthFromStage(this);
			this.stage.starling.nativeStage.addEventListener(KeyboardEvent.KEY_DOWN, panelScreen_nativeStage_keyDownHandler, false, priority, true);
		}

		/**
		 * @private
		 */
		protected function panelScreen_removedFromStageHandler(event:Event):void
		{
			this.removeEventListener(Event.REMOVED_FROM_STAGE, panelScreen_removedFromStageHandler);
			this.stage.starling.nativeStage.removeEventListener(KeyboardEvent.KEY_DOWN, panelScreen_nativeStage_keyDownHandler);
		}

		/**
		 * @private
		 */
		protected function panelScreen_nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.isDefaultPrevented())
			{
				//someone else already handled this one
				return;
			}
			if(this.backButtonHandler != null &&
				event.keyCode == Keyboard.BACK)
			{
				event.preventDefault();
				this.backButtonHandler();
			}

			if(this.menuButtonHandler != null &&
				event.keyCode == Keyboard.MENU)
			{
				event.preventDefault();
				this.menuButtonHandler();
			}

			if(this.searchButtonHandler != null &&
				event.keyCode == Keyboard.SEARCH)
			{
				event.preventDefault();
				this.searchButtonHandler();
			}
		}
	}
}


================================================
FILE: source/feathers/controls/PickerList.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.popups.CalloutPopUpContentManager;
	import feathers.controls.popups.DropDownPopUpContentManager;
	import feathers.controls.popups.IPersistentPopUpContentManager;
	import feathers.controls.popups.IPopUpContentManager;
	import feathers.controls.popups.IPopUpContentManagerWithPrompt;
	import feathers.controls.popups.VerticalCenteredPopUpContentManager;
	import feathers.core.FeathersControl;
	import feathers.core.IFocusDisplayObject;
	import feathers.core.ITextBaselineControl;
	import feathers.core.IToggle;
	import feathers.core.PropertyProxy;
	import feathers.data.IListCollection;
	import feathers.events.CollectionEventType;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;
	import feathers.system.DeviceCapabilities;

	import flash.ui.Keyboard;

	import starling.core.Starling;
	import starling.events.Event;
	import starling.events.EventDispatcher;
	import starling.events.KeyboardEvent;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.SystemUtil;

	/**
	 * A style name to add to the picker list's button sub-component.
	 * Typically used by a theme to provide different styles to different
	 * picker lists.
	 *
	 * <p>In the following example, a custom button style name is passed to
	 * the picker list:</p>
	 *
	 * <listing version="3.0">
	 * list.customButtonStyleName = "my-custom-button";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-button", setCustomButtonStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_BUTTON
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #buttonFactory
	 */
	[Style(name="customButtonStyleName",type="String")]

	/**
	 * A style name to add to all item renderers in the pop-up list. Typically
	 * used by a theme to provide different skins to different lists.
	 *
	 * <p>The following example sets the item renderer name:</p>
	 *
	 * <listing version="3.0">
	 * list.customItemRendererStyleName = "my-custom-item-renderer";</listing>
	 *
	 * <p>In your theme, you can target this sub-component name to provide
	 * different skins than the default style:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( DefaultListItemRenderer ).setFunctionForStyleName( "my-custom-item-renderer", setCustomItemRendererStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 */
	[Style(name="customItemRendererStyleName",type="String")]

	/**
	 * A style name to add to the picker list's list sub-component.
	 * Typically used by a theme to provide different styles to different
	 * picker lists.
	 *
	 * <p>In the following example, a custom list style name is passed to the
	 * picker list:</p>
	 *
	 * <listing version="3.0">
	 * list.customListStyleName = "my-custom-list";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to provide
	 * different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( List ).setFunctionForStyleName( "my-custom-list", setCustomListStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_LIST
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #listFactory
	 */
	[Style(name="customListStyleName",type="String")]

	/**
	 * A manager that handles the details of how to display the pop-up list.
	 *
	 * <p>In the following example, a pop-up content manager is provided:</p>
	 *
	 * <listing version="3.0">
	 * list.popUpContentManager = new CalloutPopUpContentManager();</listing>
	 *
	 * @default null
	 */
	[Style(name="popUpContentManager",type="feathers.controls.popups.IPopUpContentManager")]

	/**
	 * Determines if the <code>isSelected</code> property of the picker
	 * list's button sub-component is toggled when the list is opened and
	 * closed, if the class used to create the thumb implements the
	 * <code>IToggle</code> interface. Useful for skinning to provide a
	 * different appearance for the button based on whether the list is open
	 * or not.
	 *
	 * <p>In the following example, the button is toggled on open and close:</p>
	 *
	 * <listing version="3.0">
	 * list.toggleButtonOnOpenAndClose = true;</listing>
	 *
	 * @default false
	 *
	 * @see feathers.core.IToggle
	 * @see feathers.controls.ToggleButton
	 */
	[Style(name="toggleButtonOnOpenAndClose",type="Boolean")]

	/**
	 * Dispatched when the pop-up list is opened.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.OPEN
	 */
	[Event(name="open",type="starling.events.Event")]

	/**
	 * Dispatched when the pop-up list is closed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CLOSE
	 */
	[Event(name="close",type="starling.events.Event")]

	/**
	 * Dispatched when the selected item changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #selectedItem
	 * @see #selectedIndex
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Displays a button that may be triggered to display a pop-up list.
	 * The list may be customized to display in different ways, such as a
	 * drop-down, in a <code>Callout</code>, or as a modal overlay.
	 *
	 * <p>The following example creates a picker list, gives it a data provider,
	 * tells the item renderer how to interpret the data, and listens for when
	 * the selection changes:</p>
	 *
	 * <listing version="3.0">
	 * var list:PickerList = new PickerList();
	 * 
	 * list.dataProvider = new ArrayCollection(
	 * [
	 *     { text: "Milk", thumbnail: textureAtlas.getTexture( "milk" ) },
	 *     { text: "Eggs", thumbnail: textureAtlas.getTexture( "eggs" ) },
	 *     { text: "Bread", thumbnail: textureAtlas.getTexture( "bread" ) },
	 *     { text: "Chicken", thumbnail: textureAtlas.getTexture( "chicken" ) },
	 * ]);
	 * 
	 * list.itemRendererFactory = function():IListItemRenderer
	 * {
	 *     var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();
	 *     renderer.labelField = "text";
	 *     renderer.iconSourceField = "thumbnail";
	 *     return renderer;
	 * };
	 * 
	 * list.addEventListener( Event.CHANGE, list_changeHandler );
	 * 
	 * this.addChild( list );</listing>
	 *
	 * @see ../../../help/picker-list.html How to use the Feathers PickerList component
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class PickerList extends FeathersControl implements IFocusDisplayObject, ITextBaselineControl
	{
		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_BUTTON_FACTORY:String = "buttonFactory";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_LIST_FACTORY:String = "listFactory";

		/**
		 * The default value added to the <code>styleNameList</code> of the button.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_BUTTON:String = "feathers-picker-list-button";

		/**
		 * The default value added to the <code>styleNameList</code> of the pop-up
		 * list.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_LIST:String = "feathers-picker-list-list";

		/**
		 * The default <code>IStyleProvider</code> for all <code>PickerList</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static function defaultButtonFactory():Button
		{
			return new Button();
		}

		/**
		 * @private
		 */
		protected static function defaultListFactory():List
		{
			return new List();
		}

		/**
		 * Constructor.
		 */
		public function PickerList()
		{
			super();
		}

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * button. This variable is <code>protected</code> so that sub-classes
		 * can customize the button style name in their constructors instead of
		 * using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_BUTTON</code>.
		 *
		 * <p>To customize the button style name without subclassing, see
		 * <code>customButtonStyleName</code>.</p>
		 *
		 * @see #style:customButtonStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var buttonStyleName:String = DEFAULT_CHILD_STYLE_NAME_BUTTON;

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * pop-up list. This variable is <code>protected</code> so that
		 * sub-classes can customize the list style name in their constructors
		 * instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_LIST</code>.
		 *
		 * <p>To customize the pop-up list name without subclassing, see
		 * <code>customListStyleName</code>.</p>
		 *
		 * @see #style:customListStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var listStyleName:String = DEFAULT_CHILD_STYLE_NAME_LIST;

		/**
		 * The button sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #buttonFactory
		 * @see #createButton()
		 */
		protected var button:Button;

		/**
		 * The list sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #listFactory
		 * @see #createList()
		 */
		protected var list:List;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return PickerList.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var buttonExplicitWidth:Number;

		/**
		 * @private
		 */
		protected var buttonExplicitHeight:Number;

		/**
		 * @private
		 */
		protected var buttonExplicitMinWidth:Number;

		/**
		 * @private
		 */
		protected var buttonExplicitMinHeight:Number;

		/**
		 * @private
		 */
		protected var _dataProvider:IListCollection;

		/**
		 * The collection of data displayed by the list.
		 *
		 * <p>The following example passes in a data provider and tells the item
		 * renderer how to interpret the data:</p>
		 *
		 * <listing version="3.0">
		 * list.dataProvider = new ArrayCollection(
		 * [
		 *     { text: "Milk", thumbnail: textureAtlas.getTexture( "milk" ) },
		 *     { text: "Eggs", thumbnail: textureAtlas.getTexture( "eggs" ) },
		 *     { text: "Bread", thumbnail: textureAtlas.getTexture( "bread" ) },
		 *     { text: "Chicken", thumbnail: textureAtlas.getTexture( "chicken" ) },
		 * ]);
		 * 
		 * list.itemRendererFactory = function():IListItemRenderer
		 * {
		 *     var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();
		 *     renderer.labelField = "text";
		 *     renderer.iconSourceField = "thumbnail";
		 *     return renderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.data.ArrayCollection
		 * @see feathers.data.VectorCollection
		 * @see feathers.data.XMLListCollection
		 */
		public function get dataProvider():IListCollection
		{
			return this._dataProvider;
		}

		/**
		 * @private
		 */
		public function set dataProvider(value:IListCollection):void
		{
			if(this._dataProvider == value)
			{
				return;
			}
			var oldSelectedIndex:int = this.selectedIndex;
			var oldSelectedItem:Object = this.selectedItem;
			if(this._dataProvider)
			{
				this._dataProvider.removeEventListener(CollectionEventType.RESET, dataProvider_multipleEventHandler);
				this._dataProvider.removeEventListener(CollectionEventType.ADD_ITEM, dataProvider_multipleEventHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_multipleEventHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ALL, dataProvider_multipleEventHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_multipleEventHandler);
				this._dataProvider.removeEventListener(CollectionEventType.UPDATE_ITEM, dataProvider_updateItemHandler);
			}
			this._dataProvider = value;
			if(this._dataProvider)
			{
				this._dataProvider.addEventListener(CollectionEventType.RESET, dataProvider_multipleEventHandler);
				this._dataProvider.addEventListener(CollectionEventType.ADD_ITEM, dataProvider_multipleEventHandler);
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_multipleEventHandler);
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ALL, dataProvider_multipleEventHandler);
				this._dataProvider.addEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_multipleEventHandler);
				this._dataProvider.addEventListener(CollectionEventType.UPDATE_ITEM, dataProvider_updateItemHandler);
			}
			if(!this._dataProvider || this._dataProvider.length == 0)
			{
				this.selectedIndex = -1;
			}
			else
			{
				this.selectedIndex = 0;
			}
			//this ensures that Event.CHANGE will dispatch for selectedItem
			//changing, even if selectedIndex has not changed.
			if(this.selectedIndex == oldSelectedIndex && this.selectedItem != oldSelectedItem)
			{
				this.dispatchEventWith(Event.CHANGE);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _ignoreSelectionChanges:Boolean = false;

		/**
		 * @private
		 */
		protected var _selectedIndex:int = -1;

		/**
		 * The index of the currently selected item. Returns <code>-1</code> if
		 * no item is selected.
		 *
		 * <p>The following example selects an item by its index:</p>
		 *
		 * <listing version="3.0">
		 * list.selectedIndex = 2;</listing>
		 *
		 * <p>The following example clears the selected index:</p>
		 *
		 * <listing version="3.0">
		 * list.selectedIndex = -1;</listing>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected index:</p>
		 *
		 * <listing version="3.0">
		 * function list_changeHandler( event:Event ):void
		 * {
		 *     var list:PickerList = PickerList( event.currentTarget );
		 *     var index:int = list.selectedIndex;
		 * 
		 * }
		 * list.addEventListener( Event.CHANGE, list_changeHandler );</listing>
		 *
		 * @default -1
		 *
		 * @see #selectedItem
		 */
		public function get selectedIndex():int
		{
			return this._selectedIndex;
		}

		/**
		 * @private
		 */
		public function set selectedIndex(value:int):void
		{
			if(this._selectedIndex == value)
			{
				return;
			}
			this._selectedIndex = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * The currently selected item. Returns <code>null</code> if no item is
		 * selected.
		 *
		 * <p>The following example changes the selected item:</p>
		 *
		 * <listing version="3.0">
		 * list.selectedItem = list.dataProvider.getItemAt(0);</listing>
		 *
		 * <p>The following example clears the selected item:</p>
		 *
		 * <listing version="3.0">
		 * list.selectedItem = null;</listing>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected item:</p>
		 *
		 * <listing version="3.0">
		 * function list_changeHandler( event:Event ):void
		 * {
		 *     var list:PickerList = PickerList( event.currentTarget );
		 *     var item:Object = list.selectedItem;
		 * 
		 * }
		 * list.addEventListener( Event.CHANGE, list_changeHandler );</listing>
		 *
		 * @default null
		 *
		 * @see #selectedIndex
		 */
		public function get selectedItem():Object
		{
			if(!this._dataProvider || this._selectedIndex < 0 || this._selectedIndex >= this._dataProvider.length)
			{
				return null;
			}
			return this._dataProvider.getItemAt(this._selectedIndex);
		}

		/**
		 * @private
		 */
		public function set selectedItem(value:Object):void
		{
			if(!this._dataProvider)
			{
				this.selectedIndex = -1;
				return;
			}
			this.selectedIndex = this._dataProvider.getItemIndex(value);
		}

		/**
		 * @private
		 */
		protected var _prompt:String;

		/**
		 * Text displayed by the button sub-component when no items are
		 * currently selected.
		 *
		 * <p>In the following example, a prompt is given to the picker list
		 * and the selected item is cleared to display the prompt:</p>
		 *
		 * <listing version="3.0">
		 * list.prompt = "Select an Item";
		 * list.selectedIndex = -1;</listing>
		 *
		 * @default null
		 */
		public function get prompt():String
		{
			return this._prompt;
		}

		/**
		 * @private
		 */
		public function set prompt(value:String):void
		{
			if(this._prompt == value)
			{
				return;
			}
			this._prompt = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * @private
		 */
		protected var _labelField:String = "label";

		/**
		 * The field in the selected item that contains the label text to be
		 * displayed by the picker list's button control. If the selected item
		 * does not have this field, and a <code>labelFunction</code> is not
		 * defined, then the picker list will default to calling
		 * <code>toString()</code> on the selected item. To omit the
		 * label completely, define a <code>labelFunction</code> that returns an
		 * empty string.
		 *
		 * <p><strong>Important:</strong> This value only affects the selected
		 * item displayed by the picker list's button control. It will <em>not</em>
		 * affect the label text of the pop-up list's item renderers.</p>
		 *
		 * <p>In the following example, the label field is changed:</p>
		 *
		 * <listing version="3.0">
		 * list.labelField = "text";</listing>
		 *
		 * @default "label"
		 *
		 * @see #labelFunction
		 */
		public function get labelField():String
		{
			return this._labelField;
		}

		/**
		 * @private
		 */
		public function set labelField(value:String):void
		{
			if(this._labelField == value)
			{
				return;
			}
			this._labelField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _labelFunction:Function;

		/**
		 * A function used to generate label text for the selected item
		 * displayed by the picker list's button control. If this
		 * function is not null, then the <code>labelField</code> will be
		 * ignored.
		 *
		 * <p><strong>Important:</strong> This value only affects the selected
		 * item displayed by the picker list's button control. It will <em>not</em>
		 * affect the label text of the pop-up list's item renderers.</p>
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):String</pre>
		 *
		 * <p>All of the label fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>labelFunction</code></li>
		 *     <li><code>labelField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the label field is changed:</p>
		 *
		 * <listing version="3.0">
		 * list.labelFunction = function( item:Object ):String
		 * {
		 *     return item.firstName + " " + item.lastName;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #labelField
		 */
		public function get labelFunction():Function
		{
			return this._labelFunction;
		}

		/**
		 * @private
		 */
		public function set labelFunction(value:Function):void
		{
			this._labelFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _popUpContentManager:IPopUpContentManager;

		/**
		 * @private
		 */
		public function get popUpContentManager():IPopUpContentManager
		{
			return this._popUpContentManager;
		}

		/**
		 * @private
		 */
		public function set popUpContentManager(value:IPopUpContentManager):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._popUpContentManager === value)
			{
				return;
			}
			if(this._popUpContentManager is EventDispatcher)
			{
				var dispatcher:EventDispatcher = EventDispatcher(this._popUpContentManager);
				dispatcher.removeEventListener(Event.OPEN, popUpContentManager_openHandler);
				dispatcher.removeEventListener(Event.CLOSE, popUpContentManager_closeHandler);
			}
			this._popUpContentManager = value;
			if(this._popUpContentManager is EventDispatcher)
			{
				dispatcher = EventDispatcher(this._popUpContentManager);
				dispatcher.addEventListener(Event.OPEN, popUpContentManager_openHandler);
				dispatcher.addEventListener(Event.CLOSE, popUpContentManager_closeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _typicalItem:Object = null;

		/**
		 * Used to auto-size the list. If the list's width or height is NaN, the
		 * list will try to automatically pick an ideal size. This item is
		 * used in that process to create a sample item renderer.
		 *
		 * <p>The following example provides a typical item:</p>
		 *
		 * <listing version="3.0">
		 * list.typicalItem = { text: "A typical item", thumbnail: texture };</listing>
		 *
		 * @default null
		 */
		public function get typicalItem():Object
		{
			return this._typicalItem;
		}

		/**
		 * @private
		 */
		public function set typicalItem(value:Object):void
		{
			if(this._typicalItem == value)
			{
				return;
			}
			this._typicalItem = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _buttonFactory:Function;

		/**
		 * A function used to generate the picker list's button sub-component.
		 * The button must be an instance of <code>Button</code>. This factory
		 * can be used to change properties on the button when it is first
		 * created. For instance, if you are skinning Feathers components
		 * without a theme, you might use this factory to set skins and other
		 * styles on the button.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():Button</pre>
		 *
		 * <p>In the following example, a custom button factory is passed to the
		 * picker list:</p>
		 *
		 * <listing version="3.0">
		 * list.buttonFactory = function():Button
		 * {
		 *     var button:Button = new Button();
		 *     button.defaultSkin = new Image( upTexture );
		 *     button.downSkin = new Image( downTexture );
		 *     return button;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.Button
		 */
		public function get buttonFactory():Function
		{
			return this._buttonFactory;
		}

		/**
		 * @private
		 */
		public function set buttonFactory(value:Function):void
		{
			if(this._buttonFactory == value)
			{
				return;
			}
			this._buttonFactory = value;
			this.invalidate(INVALIDATION_FLAG_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customButtonStyleName:String;

		/**
		 * @private
		 */
		public function get customButtonStyleName():String
		{
			return this._customButtonStyleName;
		}

		/**
		 * @private
		 */
		public function set customButtonStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customButtonStyleName === value)
			{
				return;
			}
			this._customButtonStyleName = value;
			this.invalidate(INVALIDATION_FLAG_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _buttonProperties:PropertyProxy;

		/**
		 * An object that stores properties for the picker's button
		 * sub-component, and the properties will be passed down to the button
		 * when the picker validates. For a list of available
		 * properties, refer to
		 * <a href="Button.html"><code>feathers.controls.Button</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>buttonFactory</code> function
		 * instead of using <code>buttonProperties</code> will result in better
		 * performance.</p>
		 *
		 * <p>In the following example, the button properties are passed to the
		 * picker list:</p>
		 *
		 * <listing version="3.0">
		 * list.buttonProperties.defaultSkin = new Image( upTexture );
		 * list.buttonProperties.downSkin = new Image( downTexture );</listing>
		 *
		 * @default null
		 *
		 * @see #buttonFactory
		 * @see feathers.controls.Button
		 */
		public function get buttonProperties():Object
		{
			if(!this._buttonProperties)
			{
				this._buttonProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._buttonProperties;
		}

		/**
		 * @private
		 */
		public function set buttonProperties(value:Object):void
		{
			if(this._buttonProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._buttonProperties)
			{
				this._buttonProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._buttonProperties = PropertyProxy(value);
			if(this._buttonProperties)
			{
				this._buttonProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _listFactory:Function;

		/**
		 * A function used to generate the picker list's pop-up list
		 * sub-component. The list must be an instance of <code>List</code>.
		 * This factory can be used to change properties on the list when it is
		 * first created. For instance, if you are skinning Feathers components
		 * without a theme, you might use this factory to set skins and other
		 * styles on the list.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():List</pre>
		 *
		 * <p>In the following example, a custom list factory is passed to the
		 * picker list:</p>
		 *
		 * <listing version="3.0">
		 * list.listFactory = function():List
		 * {
		 *     var popUpList:List = new List();
		 *     popUpList.backgroundSkin = new Image( texture );
		 *     return popUpList;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.List
		 */
		public function get listFactory():Function
		{
			return this._listFactory;
		}

		/**
		 * @private
		 */
		public function set listFactory(value:Function):void
		{
			if(this._listFactory == value)
			{
				return;
			}
			this._listFactory = value;
			this.invalidate(INVALIDATION_FLAG_LIST_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customListStyleName:String;

		/**
		 * @private
		 */
		public function get customListStyleName():String
		{
			return this._customListStyleName;
		}

		/**
		 * @private
		 */
		public function set customListStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customListStyleName === value)
			{
				return;
			}
			this._customListStyleName = value;
			this.invalidate(INVALIDATION_FLAG_LIST_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _listProperties:PropertyProxy;

		/**
		 * An object that stores properties for the picker's pop-up list
		 * sub-component, and the properties will be passed down to the pop-up
		 * list when the picker validates. For a list of available
		 * properties, refer to
		 * <a href="List.html"><code>feathers.controls.List</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>listFactory</code> function
		 * instead of using <code>listProperties</code> will result in better
		 * performance.</p>
		 *
		 * <p>In the following example, the list properties are passed to the
		 * picker list:</p>
		 *
		 * <listing version="3.0">
		 * list.listProperties.backgroundSkin = new Image( texture );</listing>
		 *
		 * @default null
		 *
		 * @see #listFactory
		 * @see feathers.controls.List
		 */
		public function get listProperties():Object
		{
			if(!this._listProperties)
			{
				this._listProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._listProperties;
		}

		/**
		 * @private
		 */
		public function set listProperties(value:Object):void
		{
			if(this._listProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._listProperties)
			{
				this._listProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._listProperties = PropertyProxy(value);
			if(this._listProperties)
			{
				this._listProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _toggleButtonOnOpenAndClose:Boolean = false;

		/**
		 * @private
		 */
		public function get toggleButtonOnOpenAndClose():Boolean
		{
			return this._toggleButtonOnOpenAndClose;
		}

		/**
		 * @private
		 */
		public function set toggleButtonOnOpenAndClose(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._toggleButtonOnOpenAndClose === value)
			{
				return;
			}
			this._toggleButtonOnOpenAndClose = value;
			if(this.button is IToggle)
			{
				if(this._toggleButtonOnOpenAndClose && this._popUpContentManager.isOpen)
				{
					IToggle(this.button).isSelected = true;
				}
				else
				{
					IToggle(this.button).isSelected = false;
				}
			}
		}

		/**
		 * @private
		 */
		protected var _itemRendererFactory:Function = null;

		/**
		 * A function called that is expected to return a new item renderer.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 *
		 * <pre>function():IListItemRenderer</pre>
		 *
		 * <p>The following example provides a factory for the item renderer:</p>
		 *
		 * <listing version="3.0">
		 * list.itemRendererFactory = function():IListItemRenderer
		 * {
		 *     var renderer:CustomItemRendererClass = new CustomItemRendererClass();
		 *     renderer.backgroundSkin = new Quad( 10, 10, 0xff0000 );
		 *     return renderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderers.IListItemRenderer
		 */
		public function get itemRendererFactory():Function
		{
			return this._itemRendererFactory;
		}

		/**
		 * @private
		 */
		public function set itemRendererFactory(value:Function):void
		{
			if(this._itemRendererFactory === value)
			{
				return;
			}
			this._itemRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_LIST_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customItemRendererStyleName:String;

		/**
		 * @private
		 */
		public function get customItemRendererStyleName():String
		{
			return this._customItemRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customItemRendererStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customItemRendererStyleName === value)
			{
				return;
			}
			this._customItemRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_LIST_FACTORY);
		}

		/**
		 * @inheritDoc
		 */
		public function get baseline():Number
		{
			if(!this.button)
			{
				return this.scaledActualHeight;
			}
			return this.scaleY * (this.button.y + this.button.baseline);
		}

		/**
		 * @private
		 */
		protected var _triggered:Boolean = false;

		/**
		 * @private
		 */
		protected var _isOpenListPending:Boolean = false;

		/**
		 * @private
		 */
		protected var _isCloseListPending:Boolean = false;

		/**
		 * Using <code>labelField</code> and <code>labelFunction</code>,
		 * generates a label from the selected item to be displayed by the
		 * picker list's button control.
		 *
		 * <p><strong>Important:</strong> This value only affects the selected
		 * item displayed by the picker list's button control. It will <em>not</em>
		 * affect the label text of the pop-up list's item renderers.</p>
		 */
		public function itemToLabel(item:Object):String
		{
			if(this._labelFunction !== null)
			{
				var labelResult:Object = this._labelFunction(item);
				if(labelResult is String)
				{
					return labelResult as String;
				}
				else if(labelResult !== null)
				{
					return labelResult.toString();
				}
			}
			else if(this._labelField !== null && item !== null && item.hasOwnProperty(this._labelField))
			{
				labelResult = item[this._labelField];
				if(labelResult is String)
				{
					return labelResult as String;
				}
				else if(labelResult !== null)
				{
					return labelResult.toString();
				}
			}
			else if(item is String)
			{
				return item as String;
			}
			else if(item !== null)
			{
				//we need to use strict equality here because the data can be
				//non-strictly equal to null
				return item.toString();
			}
			return null;
		}

		/**
		 * @private
		 */
		protected var _buttonHasFocus:Boolean = false;

		/**
		 * @private
		 */
		protected var _buttonTouchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _listIsOpenOnTouchBegan:Boolean = false;

		/**
		 * Opens the pop-up list, if it isn't already open.
		 */
		public function openList():void
		{
			this._isCloseListPending = false;
			if(this._popUpContentManager.isOpen)
			{
				return;
			}
			if(!this._isValidating && this.isInvalid())
			{
				this._isOpenListPending = true;
				return;
			}
			this._isOpenListPending = false;
			if(this._popUpContentManager is IPopUpContentManagerWithPrompt)
			{
				IPopUpContentManagerWithPrompt(this._popUpContentManager).prompt = this._prompt;
			}
			this._popUpContentManager.open(this.list, this);
			this.list.scrollToDisplayIndex(this._selectedIndex);
			this.list.validate();
			if(this.list.focusManager)
			{
				this.list.focusManager.focus = this.list;
				this.stage.addEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
				this.list.addEventListener(FeathersEventType.FOCUS_OUT, list_focusOutHandler);
			}
		}

		/**
		 * Closes the pop-up list, if it is open.
		 */
		public function closeList():void
		{
			this._isOpenListPending = false;
			if(!this._popUpContentManager.isOpen)
			{
				return;
			}
			if(!this._isValidating && this.isInvalid())
			{
				this._isCloseListPending = true;
				return;
			}
			this._isCloseListPending = false;
			this.list.validate();
			//don't clean up anything from openList() in closeList(). The list
			//may be closed by removing it from the PopUpManager, which would
			//result in closeList() never being called.
			//instead, clean up in the Event.REMOVED_FROM_STAGE listener.
			this._popUpContentManager.close();
		}

		/**
		 * @inheritDoc
		 */
		override public function dispose():void
		{
			if(this.list)
			{
				this.closeList();
				this.list.dispose();
				this.list = null;
			}
			if(this._popUpContentManager)
			{
				this._popUpContentManager.dispose();
				this._popUpContentManager = null;
			}
			//clearing selection now so that the data provider setter won't
			//cause a selection change that triggers events.
			this._selectedIndex = -1;
			this.dataProvider = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override public function showFocus():void
		{
			if(!this.button)
			{
				return;
			}
			this.button.showFocus();
		}

		/**
		 * @private
		 */
		override public function hideFocus():void
		{
			if(!this.button)
			{
				return;
			}
			this.button.hideFocus();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(this._popUpContentManager === null)
			{
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				if(SystemUtil.isDesktop)
				{
					var popUpContentManager:IPopUpContentManager = new DropDownPopUpContentManager();
				}
				else if(DeviceCapabilities.isTablet(starling.nativeStage))
				{
					popUpContentManager = new CalloutPopUpContentManager();
				}
				else
				{
					popUpContentManager = new VerticalCenteredPopUpContentManager();
				}
				this.ignoreNextStyleRestriction();
				this.popUpContentManager = popUpContentManager;
			}
			super.initialize();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var selectionInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SELECTED);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var buttonFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_BUTTON_FACTORY);
			var listFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LIST_FACTORY);

			if(buttonFactoryInvalid)
			{
				this.createButton();
			}

			if(listFactoryInvalid)
			{
				this.createList();
			}

			if(buttonFactoryInvalid || stylesInvalid || selectionInvalid)
			{
				//this section asks the button to auto-size again, if our
				//explicit dimensions aren't set.
				//set this before buttonProperties is used because it might
				//contain width or height changes.
				if(this._explicitWidth !== this._explicitWidth) //isNaN
				{
					this.button.width = NaN;
				}
				if(this._explicitHeight !== this._explicitHeight) //isNaN
				{
					this.button.height = NaN;
				}
			}

			if(buttonFactoryInvalid || stylesInvalid)
			{
				this.refreshButtonProperties();
			}

			if(listFactoryInvalid || stylesInvalid)
			{
				this.refreshListProperties();
			}

			if(listFactoryInvalid || dataInvalid)
			{
				var oldIgnoreSelectionChanges:Boolean = this._ignoreSelectionChanges;
				this._ignoreSelectionChanges = true;
				this.list.dataProvider = this._dataProvider;
				this._ignoreSelectionChanges = oldIgnoreSelectionChanges;
			}

			if(buttonFactoryInvalid || listFactoryInvalid || stateInvalid)
			{
				this.button.isEnabled = this._isEnabled;
				this.list.isEnabled = this._isEnabled;
			}

			if(buttonFactoryInvalid || dataInvalid || selectionInvalid)
			{
				this.refreshButtonLabel();
			}
			if(listFactoryInvalid || dataInvalid || selectionInvalid)
			{
				oldIgnoreSelectionChanges = this._ignoreSelectionChanges;
				this._ignoreSelectionChanges = true;
				this.list.selectedIndex = this._selectedIndex;
				this._ignoreSelectionChanges = oldIgnoreSelectionChanges;
			}

			this.autoSizeIfNeeded();
			this.layout();

			if(this.list.stage)
			{
				//final validation to avoid juggler next frame issues
				//only validate if it's on the display list, though, because the
				//popUpContentManager may need to place restrictions on
				//dimensions or make other important changes.
				//otherwise, the List may create an item renderer for every item
				//in the data provider, which is not good for performance!
				this.list.validate();
			}

			this.handlePendingActions();
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			var buttonWidth:Number = this._explicitWidth;
			if(buttonWidth !== buttonWidth) //isNaN
			{
				//we save the button's explicitWidth (and other explicit
				//dimensions) after the buttonFactory() returns so that
				//measurement always accounts for it, even after the button's
				//width is set by the PickerList
				buttonWidth = this.buttonExplicitWidth;
			}
			var buttonHeight:Number = this._explicitHeight;
			if(buttonHeight !== buttonHeight) //isNaN
			{
				buttonHeight = this.buttonExplicitHeight;
			}
			var buttonMinWidth:Number = this._explicitMinWidth;
			if(buttonMinWidth !== buttonMinWidth) //isNaN
			{
				buttonMinWidth = this.buttonExplicitMinWidth;
			}
			var buttonMinHeight:Number = this._explicitMinHeight;
			if(buttonMinHeight !== buttonMinHeight) //isNaN
			{
				buttonMinHeight = this.buttonExplicitMinHeight;
			}
			if(this._typicalItem !== null)
			{
				this.button.label = this.itemToLabel(this._typicalItem);
			}
			this.button.width = buttonWidth;
			this.button.height = buttonHeight;
			this.button.minWidth = buttonMinWidth;
			this.button.minHeight = buttonMinHeight;
			this.button.validate();

			if(this._typicalItem !== null)
			{
				this.refreshButtonLabel();
			}

			var newWidth:Number = this._explicitWidth;
			var newHeight:Number = this._explicitHeight;
			var newMinWidth:Number = this._explicitMinWidth;
			var newMinHeight:Number = this._explicitMinHeight;

			if(needsWidth)
			{
				newWidth = this.button.width;
			}
			if(needsHeight)
			{
				newHeight = this.button.height;
			}
			if(needsMinWidth)
			{
				newMinWidth = this.button.minWidth;
			}
			if(needsMinHeight)
			{
				newMinHeight = this.button.minHeight;
			}

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * Creates and adds the <code>button</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #button
		 * @see #buttonFactory
		 * @see #style:customButtonStyleName
		 */
		protected function createButton():void
		{
			if(this.button)
			{
				this.button.removeFromParent(true);
				this.button = null;
			}

			var factory:Function = this._buttonFactory != null ? this._buttonFactory : defaultButtonFactory;
			var buttonStyleName:String = this._customButtonStyleName != null ? this._customButtonStyleName : this.buttonStyleName;
			this.button = Button(factory());
			if(this.button is ToggleButton)
			{
				//we'll control the value of isSelected manually
				ToggleButton(this.button).isToggle = false;
			}
			this.button.styleNameList.add(buttonStyleName);
			this.button.addEventListener(TouchEvent.TOUCH, button_touchHandler);
			this.button.addEventListener(Event.TRIGGERED, button_triggeredHandler);
			this.addChild(this.button);

			//we will use these values for measurement, if possible
			this.button.initializeNow();
			this.buttonExplicitWidth = this.button.explicitWidth;
			this.buttonExplicitHeight = this.button.explicitHeight;
			this.buttonExplicitMinWidth = this.button.explicitMinWidth;
			this.buttonExplicitMinHeight = this.button.explicitMinHeight;
		}

		/**
		 * Creates and adds the <code>list</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #list
		 * @see #listFactory
		 * @see #style:customListStyleName
		 */
		protected function createList():void
		{
			if(this.list)
			{
				this.list.removeFromParent(false);
				//disposing separately because the list may not have a parent
				this.list.dispose();
				this.list = null;
			}

			var factory:Function = this._listFactory != null ? this._listFactory : defaultListFactory;
			var listStyleName:String = this._customListStyleName != null ? this._customListStyleName : this.listStyleName;
			this.list = List(factory());
			this.list.focusOwner = this;
			this.list.styleNameList.add(listStyleName);
			//for backwards compatibility, allow the listFactory to take
			//precedence if it also sets customItemRendererStyleName and our
			//value is null. if our value is not null, we'll use it.
			if(this._customItemRendererStyleName !== null)
			{
				this.list.customItemRendererStyleName = this._customItemRendererStyleName;
			}
			if(this._itemRendererFactory !== null)
			{
				this.list.itemRendererFactory = this._itemRendererFactory;
			}
			this.list.addEventListener(Event.CHANGE, list_changeHandler);
			this.list.addEventListener(Event.TRIGGERED, list_triggeredHandler);
			this.list.addEventListener(TouchEvent.TOUCH, list_touchHandler);
			this.list.addEventListener(Event.REMOVED_FROM_STAGE, list_removedFromStageHandler);
		}

		/**
		 * @private
		 */
		protected function refreshButtonLabel():void
		{
			if(this._selectedIndex >= 0)
			{
				this.button.label = this.itemToLabel(this.selectedItem);
			}
			else
			{
				this.button.label = this._prompt;
			}
		}

		/**
		 * @private
		 */
		protected function refreshButtonProperties():void
		{
			for(var propertyName:String in this._buttonProperties)
			{
				var propertyValue:Object = this._buttonProperties[propertyName];
				this.button[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function refreshListProperties():void
		{
			for(var propertyName:String in this._listProperties)
			{
				var propertyValue:Object = this._listProperties[propertyName];
				this.list[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function layout():void
		{
			this.button.width = this.actualWidth;
			this.button.height = this.actualHeight;

			//final validation to avoid juggler next frame issues
			this.button.validate();
		}

		/**
		 * @private
		 */
		protected function handlePendingActions():void
		{
			if(this._isOpenListPending)
			{
				this.openList();
			}
			if(this._isCloseListPending)
			{
				this.closeList();
			}
		}

		/**
		 * @private
		 */
		override protected function focusInHandler(event:Event):void
		{
			super.focusInHandler(event);
			this._buttonHasFocus = true;
			this.button.dispatchEventWith(FeathersEventType.FOCUS_IN);
		}

		/**
		 * @private
		 */
		override protected function focusOutHandler(event:Event):void
		{
			if(this._buttonHasFocus)
			{
				this.button.dispatchEventWith(FeathersEventType.FOCUS_OUT);
				this._buttonHasFocus = false;
			}
			super.focusOutHandler(event);
		}

		/**
		 * @private
		 */
		protected function childProperties_onChange(proxy:PropertyProxy, name:String):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function button_touchHandler(event:TouchEvent):void
		{
			if(this._buttonTouchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this.button, TouchPhase.ENDED, this._buttonTouchPointID);
				if(!touch)
				{
					return;
				}
				this._buttonTouchPointID = -1;
				//the button will dispatch Event.TRIGGERED before this touch
				//listener is called, so it is safe to clear this flag.
				//we're clearing it because Event.TRIGGERED may also be
				//dispatched after keyboard input.
				this._listIsOpenOnTouchBegan = false;
			}
			else
			{
				touch = event.getTouch(this.button, TouchPhase.BEGAN);
				if(!touch)
				{
					return;
				}
				this._buttonTouchPointID = touch.id;
				this._listIsOpenOnTouchBegan = this._popUpContentManager.isOpen;
			}
		}

		/**
		 * @private
		 */
		protected function button_triggeredHandler(event:Event):void
		{
			if(this._focusManager && this._listIsOpenOnTouchBegan)
			{
				return;
			}
			if(this._popUpContentManager.isOpen)
			{
				this.closeList();
				return;
			}
			this.openList();
		}

		/**
		 * @private
		 */
		protected function list_changeHandler(event:Event):void
		{
			if(this._ignoreSelectionChanges ||
				this._popUpContentManager is IPersistentPopUpContentManager)
			{
				return;
			}
			this.selectedIndex = this.list.selectedIndex;
		}

		/**
		 * @private
		 */
		protected function popUpContentManager_openHandler(event:Event):void
		{
			if(this._toggleButtonOnOpenAndClose && this.button is IToggle)
			{
				IToggle(this.button).isSelected = true;
			}
			this.list.revealScrollBars();
			this.dispatchEventWith(Event.OPEN);
		}

		/**
		 * @private
		 */
		protected function popUpContentManager_closeHandler(event:Event):void
		{
			if(this._popUpContentManager is IPersistentPopUpContentManager)
			{
				this.selectedIndex = this.list.selectedIndex;
			}
			if(this._toggleButtonOnOpenAndClose && this.button is IToggle)
			{
				IToggle(this.button).isSelected = false;
			}
			this.dispatchEventWith(Event.CLOSE);
		}

		/**
		 * @private
		 */
		protected function list_removedFromStageHandler(event:Event):void
		{
			if(this._focusManager)
			{
				this.list.stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
				this.list.removeEventListener(FeathersEventType.FOCUS_OUT, list_focusOutHandler);
			}
		}

		/**
		 * @private
		 */
		protected function list_focusOutHandler(event:Event):void
		{
			if(!this._popUpContentManager.isOpen)
			{
				return;
			}
			this.closeList();
		}

		/**
		 * @private
		 */
		protected function list_triggeredHandler(event:Event):void
		{
			if(!this._isEnabled ||
				this._popUpContentManager is IPersistentPopUpContentManager)
			{
				return;
			}
			this._triggered = true;
		}

		/**
		 * @private
		 */
		protected function list_touchHandler(event:TouchEvent):void
		{
			var touch:Touch = event.getTouch(this.list);
			if(touch === null)
			{
				return;
			}
			if(touch.phase === TouchPhase.BEGAN)
			{
				this._triggered = false;
			}
			if(touch.phase === TouchPhase.ENDED && this._triggered)
			{
				this.closeList();
			}
		}

		/**
		 * @private
		 */
		protected function dataProvider_multipleEventHandler(event:Event):void
		{
			//we need to ensure that the pop-up list has received the new
			//selected index, or it might update the selected index to an
			//incorrect value after an item is added, removed, or replaced.
			this.validate();
		}

		/**
		 * @private
		 */
		protected function dataProvider_updateItemHandler(event:Event, index:int):void
		{
			if(index == this._selectedIndex)
			{
				this.invalidate(INVALIDATION_FLAG_SELECTED);
			}
		}

		/**
		 * @private
		 */
		protected function stage_keyUpHandler(event:KeyboardEvent):void
		{
			if(!this._popUpContentManager.isOpen)
			{
				return;
			}
			if(event.keyCode == Keyboard.ENTER)
			{
				this.closeList();
			}
		}
	}
}

================================================
FILE: source/feathers/controls/ProgressBar.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IValidating;
	import feathers.layout.Direction;
	import feathers.skins.IStyleProvider;
	import feathers.utils.math.clamp;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;

	import starling.display.DisplayObject;

	/**
	 * The primary background to display in the progress bar. The background
	 * skin is displayed below the fill skin, and the fill skin is affected
	 * by the padding, and the background skin may be seen around the edges.
	 *
	 * <p>The original width or height of the background skin will be one
	 * of the values used to calculate the width or height of the progress
	 * bar, if the <code>width</code> and <code>height</code> properties are
	 * not set explicitly. The fill skin and padding values will also be
	 * used.</p>
	 *
	 * <p>If the background skin is a Feathers component, the
	 * <code>minWidth</code> or <code>minHeight</code> properties will be
	 * one of the values used to calculate the width or height of the
	 * progress bar. If the background skin is a regular Starling display
	 * object, the original width and height of the display object will be
	 * used to calculate the minimum dimensions instead.</p>
	 *
	 * <p>In the following example, the progress bar is given a background
	 * skin:</p>
	 *
	 * <listing version="3.0">
	 * progress.backgroundSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundDisabledSkin
	 * @see #style:fillSkin
	 */
	[Style(name="backgroundSkin",type="starling.display.DisplayObject")]

	/**
	 * A background to display when the progress bar is disabled.
	 *
	 * <p>In the following example, the progress bar is given a disabled
	 * background skin:</p>
	 *
	 * <listing version="3.0">
	 * progress.backgroundDisabledSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundSkin
	 * @see #style:fillDisabledSkin
	 */
	[Style(name="backgroundDisabledSkin",type="starling.display.DisplayObject")]

	/**
	 * Determines the direction that the progress bar fills. When this value
	 * changes, the progress bar's width and height values do not change
	 * automatically.
	 *
	 * <p>In the following example, the direction is set to vertical:</p>
	 *
	 * <listing version="3.0">
	 * progress.direction = Direction.VERTICAL;</listing>
	 *
	 * <p><strong>Note:</strong> The <code>Direction.NONE</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.Direction.HORIZONTAL
	 *
	 * @see feathers.layout.Direction#HORIZONTAL
	 * @see feathers.layout.Direction#VERTICAL
	 */
	[Style(name="direction",type="String")]

	/**
	 * The primary fill to display in the progress bar. The fill skin is
	 * displayed over the background skin, with padding around the edges of
	 * the fill skin to reveal the background skin behind.
	 *
	 * <p>Note: The size of the <code>fillSkin</code>, at the time that it
	 * is passed to the setter, will be used used as the size of the fill
	 * when the progress bar is set to the minimum value. In other words,
	 * if the fill of a horizontal progress bar with a value from 0 to 100
	 * should be virtually invisible when the value is 0, then the
	 * <code>fillSkin</code> should have a width of 0 when you pass it in.
	 * On the other hand, if you're using an <code>Image</code> with a
	 * <code>scale9Grid</code> as the skin, it may require a minimum width
	 * before the image parts begin to overlap. In that case, the
	 * <code>Image</code> instance passed to the <code>fillSkin</code>
	 * setter should have a <code>width</code> value that is the same as
	 * that minimum width value where the image parts do not overlap.</p>
	 *
	 * <p>In the following example, the progress bar is given a fill
	 * skin:</p>
	 *
	 * <listing version="3.0">
	 * progress.fillSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:fillDisabledSkin
	 * @see #style:backgroundSkin
	 */
	[Style(name="fillSkin",type="starling.display.DisplayObject")]

	/**
	 * A fill to display when the progress bar is disabled.
	 *
	 * <p>In the following example, the progress bar is given a disabled fill
	 * skin:</p>
	 *
	 * <listing version="3.0">
	 * progress.fillDisabledSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:fillSkin
	 * @see #style:backgroundDisabledSkin
	 */
	[Style(name="fillDisabledSkin",type="starling.display.DisplayObject")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * progress.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, between the progress bar's top edge and
	 * the progress bar's content.
	 *
	 * <p>In the following example, the top padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * progress.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the progress bar's right edge
	 * and the progress bar's content.
	 *
	 * <p>In the following example, the right padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * progress.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the progress bar's bottom edge
	 * and the progress bar's content.
	 *
	 * <p>In the following example, the bottom padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * progress.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the progress bar's left edge
	 * and the progress bar's content.
	 *
	 * <p>In the following example, the left padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * progress.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * Displays the progress of a task over time. Non-interactive.
	 *
	 * <p>The following example creates a progress bar:</p>
	 *
	 * <listing version="3.0">
	 * var progress:ProgressBar = new ProgressBar();
	 * progress.minimum = 0;
	 * progress.maximum = 100;
	 * progress.value = 20;
	 * this.addChild( progress );</listing>
	 *
	 * @see ../../../help/progress-bar.html How to use the Feathers ProgressBar component
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class ProgressBar extends FeathersControl
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>ProgressBar</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function ProgressBar()
		{
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return ProgressBar.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _direction:String = Direction.HORIZONTAL;

		[Inspectable(type="String",enumeration="horizontal,vertical")]
		/**
		 * @private
		 */
		public function get direction():String
		{
			return this._direction;
		}

		/**
		 * @private
		 */
		public function set direction(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._direction === value)
			{
				return;
			}
			this._direction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _value:Number = 0;

		/**
		 * The value of the progress bar, between the minimum and maximum.
		 *
		 * <p>In the following example, the value is set to 12:</p>
		 *
		 * <listing version="3.0">
		 * progress.minimum = 0;
		 * progress.maximum = 100;
		 * progress.value = 12;</listing>
		 *
		 * @default 0
		 *
		 * @see #minimum
		 * @see #maximum
		 */
		public function get value():Number
		{
			return this._value;
		}

		/**
		 * @private
		 */
		public function set value(newValue:Number):void
		{
			newValue = clamp(newValue, this._minimum, this._maximum);
			if(this._value == newValue)
			{
				return;
			}
			this._value = newValue;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _minimum:Number = 0;

		/**
		 * The progress bar's value will not go lower than the minimum.
		 *
		 * <p>In the following example, the minimum is set to 0:</p>
		 *
		 * <listing version="3.0">
		 * progress.minimum = 0;
		 * progress.maximum = 100;
		 * progress.value = 12;</listing>
		 *
		 * @default 0
		 *
		 * @see #value
		 * @see #maximum
		 */
		public function get minimum():Number
		{
			return this._minimum;
		}

		/**
		 * @private
		 */
		public function set minimum(value:Number):void
		{
			if(this._minimum == value)
			{
				return;
			}
			this._minimum = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _maximum:Number = 1;

		/**
		 * The progress bar's value will not go higher than the maximum.
		 *
		 * <p>In the following example, the maximum is set to 100:</p>
		 *
		 * <listing version="3.0">
		 * progress.minimum = 0;
		 * progress.maximum = 100;
		 * progress.value = 12;</listing>
		 *
		 * @default 1
		 *
		 * @see #value
		 * @see #minimum
		 */
		public function get maximum():Number
		{
			return this._maximum;
		}

		/**
		 * @private
		 */
		public function set maximum(value:Number):void
		{
			if(this._maximum == value)
			{
				return;
			}
			this._maximum = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _explicitBackgroundWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxHeight:Number;

		/**
		 * @private
		 */
		protected var currentBackground:DisplayObject;

		/**
		 * @private
		 */
		protected var _backgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundSkin():DisplayObject
		{
			return this._backgroundSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundSkin === value)
			{
				return;
			}
			if(this._backgroundSkin !== null &&
				this.currentBackground === this._backgroundSkin)
			{
				this.removeCurrentBackground(this._backgroundSkin);
				this.currentBackground = null;
			}
			this._backgroundSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _backgroundDisabledSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundDisabledSkin():DisplayObject
		{
			return this._backgroundDisabledSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundDisabledSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundDisabledSkin === value)
			{
				return;
			}
			if(this._backgroundDisabledSkin !== null &&
				this.currentBackground === this._backgroundDisabledSkin)
			{
				this.removeCurrentBackground(this._backgroundDisabledSkin);
				this.currentBackground = null;
			}
			this._backgroundDisabledSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 * The width of the first fill skin that was displayed.
		 */
		protected var _originalFillWidth:Number = NaN;

		/**
		 * @private
		 * The width of the first fill skin that was displayed.
		 */
		protected var _originalFillHeight:Number = NaN;

		/**
		 * @private
		 */
		protected var currentFill:DisplayObject;

		/**
		 * @private
		 */
		protected var _fillSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get fillSkin():DisplayObject
		{
			return this._fillSkin;
		}

		/**
		 * @private
		 */
		public function set fillSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._fillSkin === value)
			{
				return;
			}
			if(this._fillSkin && this._fillSkin != this._fillDisabledSkin)
			{
				this.removeChild(this._fillSkin);
			}
			this._fillSkin = value;
			if(this._fillSkin && this._fillSkin.parent != this)
			{
				this._fillSkin.visible = false;
				this.addChild(this._fillSkin);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _fillDisabledSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get fillDisabledSkin():DisplayObject
		{
			return this._fillDisabledSkin;
		}

		/**
		 * @private
		 */
		public function set fillDisabledSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._fillDisabledSkin === value)
			{
				return;
			}
			if(this._fillDisabledSkin && this._fillDisabledSkin != this._fillSkin)
			{
				this.removeChild(this._fillDisabledSkin);
			}
			this._fillDisabledSkin = value;
			if(this._fillDisabledSkin && this._fillDisabledSkin.parent != this)
			{
				this._fillDisabledSkin.visible = false;
				this.addChild(this._fillDisabledSkin);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			//we don't dispose it if the label is the parent because it'll
			//already get disposed in super.dispose()
			if(this._backgroundSkin !== null &&
				this._backgroundSkin.parent !== this)
			{
				this._backgroundSkin.dispose();
			}
			if(this._backgroundDisabledSkin !== null &&
				this._backgroundDisabledSkin.parent !== this)
			{
				this._backgroundDisabledSkin.dispose();
			}
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);

			if(stylesInvalid || stateInvalid)
			{
				this.refreshBackground();
				this.refreshFill();
			}

			this.autoSizeIfNeeded();

			this.layoutChildren();

			if(this.currentBackground is IValidating)
			{
				IValidating(this.currentBackground).validate();
			}
			if(this.currentFill is IValidating)
			{
				IValidating(this.currentFill).validate();
			}
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			var measureBackground:IMeasureDisplayObject = this.currentBackground as IMeasureDisplayObject;
			resetFluidChildDimensionsForMeasurement(this.currentBackground,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitBackgroundWidth, this._explicitBackgroundHeight,
				this._explicitBackgroundMinWidth, this._explicitBackgroundMinHeight,
				this._explicitBackgroundMaxWidth, this._explicitBackgroundMaxHeight);
			if(this.currentBackground is IValidating)
			{
				IValidating(this.currentBackground).validate();
			}
			if(this.currentFill is IValidating)
			{
				IValidating(this.currentFill).validate();
			}

			//minimum dimensions
			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				if(measureBackground !== null)
				{
					newMinWidth = measureBackground.minWidth;
				}
				else if(this.currentBackground !== null)
				{
					newMinWidth = this._explicitBackgroundMinWidth;
				}
				else
				{
					newMinWidth = 0;
				}
				var fillMinWidth:Number = this._originalFillWidth;
				if(this.currentFill is IFeathersControl)
				{
					fillMinWidth = IFeathersControl(this.currentFill).minWidth;
				}
				fillMinWidth += this._paddingLeft + this._paddingRight;
				if(fillMinWidth > newMinWidth)
				{
					newMinWidth = fillMinWidth;
				}
			}
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				if(measureBackground !== null)
				{
					newMinHeight = measureBackground.minHeight;
				}
				else if(this.currentBackground !== null)
				{
					newMinHeight = this._explicitBackgroundMinHeight;
				}
				else
				{
					newMinHeight = 0;
				}
				var fillMinHeight:Number = this._originalFillHeight;
				if(this.currentFill is IFeathersControl)
				{
					fillMinHeight = IFeathersControl(this.currentFill).minHeight;
				}
				fillMinHeight += this._paddingTop + this._paddingBottom;
				if(fillMinHeight > newMinHeight)
				{
					newMinHeight = fillMinHeight;
				}
			}

			//current dimensions
			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				if(this.currentBackground !== null)
				{
					newWidth = this.currentBackground.width;
				}
				else
				{
					newWidth = 0;
				}
				var fillWidth:Number = this._originalFillWidth + this._paddingLeft + this._paddingRight;
				if(fillWidth > newWidth)
				{
					newWidth = fillWidth;
				}
			}
			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				if(this.currentBackground !== null)
				{
					newHeight = this.currentBackground.height;
				}
				else
				{
					newHeight = 0;
				}
				var fillHeight:Number = this._originalFillHeight + this._paddingTop + this._paddingBottom;
				if(fillHeight > newHeight)
				{
					newHeight = fillHeight;
				}
			}

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * @private
		 */
		protected function refreshBackground():void
		{
			var oldBackground:DisplayObject = this.currentBackground;
			this.currentBackground = this._backgroundSkin;
			if(!this._isEnabled && this._backgroundDisabledSkin !== null)
			{
				this.currentBackground = this._backgroundDisabledSkin;
			}
			if(oldBackground !== this.currentBackground)
			{
				this.removeCurrentBackground(oldBackground);
				if(this.currentBackground !== null)
				{
					if(this.currentBackground is IFeathersControl)
					{
						IFeathersControl(this.currentBackground).initializeNow();
					}
					if(this.currentBackground is IMeasureDisplayObject)
					{
						var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this.currentBackground);
						this._explicitBackgroundWidth = measureSkin.explicitWidth;
						this._explicitBackgroundHeight = measureSkin.explicitHeight;
						this._explicitBackgroundMinWidth = measureSkin.explicitMinWidth;
						this._explicitBackgroundMinHeight = measureSkin.explicitMinHeight;
						this._explicitBackgroundMaxWidth = measureSkin.explicitMaxWidth;
						this._explicitBackgroundMaxHeight = measureSkin.explicitMaxHeight;
					}
					else
					{
						this._explicitBackgroundWidth = this.currentBackground.width;
						this._explicitBackgroundHeight = this.currentBackground.height;
						this._explicitBackgroundMinWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMinHeight = this._explicitBackgroundHeight;
						this._explicitBackgroundMaxWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMaxHeight = this._explicitBackgroundHeight;
					}
					this.addChildAt(this.currentBackground, 0);
				}
			}
		}

		/**
		 * @private
		 */
		protected function removeCurrentBackground(skin:DisplayObject):void
		{
			if(skin === null)
			{
				return;
			}
			if(skin.parent === this)
			{
				//we need to restore these values so that they won't be lost the
				//next time that this skin is used for measurement
				skin.width = this._explicitBackgroundWidth;
				skin.height = this._explicitBackgroundHeight;
				if(skin is IMeasureDisplayObject)
				{
					var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(skin);
					measureSkin.minWidth = this._explicitBackgroundMinWidth;
					measureSkin.minHeight = this._explicitBackgroundMinHeight;
					measureSkin.maxWidth = this._explicitBackgroundMaxWidth;
					measureSkin.maxHeight = this._explicitBackgroundMaxHeight;
				}
				skin.removeFromParent(false);
			}
		}

		/**
		 * @private
		 */
		protected function refreshFill():void
		{
			this.currentFill = this._fillSkin;
			if(this._fillDisabledSkin)
			{
				if(this._isEnabled)
				{
					this._fillDisabledSkin.visible = false;
				}
				else
				{
					this.currentFill = this._fillDisabledSkin;
					if(this._backgroundSkin)
					{
						this._fillSkin.visible = false;
					}
				}
			}
			if(this.currentFill)
			{
				if(this.currentFill is IValidating)
				{
					IValidating(this.currentFill).validate();
				}
				if(this._originalFillWidth !== this._originalFillWidth) //isNaN
				{
					this._originalFillWidth = this.currentFill.width;
				}
				if(this._originalFillHeight !== this._originalFillHeight) //isNaN
				{
					this._originalFillHeight = this.currentFill.height;
				}
				this.currentFill.visible = true;
			}
		}

		/**
		 * @private
		 */
		protected function layoutChildren():void
		{
			if(this.currentBackground !== null)
			{
				this.currentBackground.width = this.actualWidth;
				this.currentBackground.height = this.actualHeight;
			}

			if(this._minimum == this._maximum)
			{
				var percentage:Number = 1;
			}
			else
			{
				percentage = (this._value - this._minimum) / (this._maximum - this._minimum);
				if(percentage < 0)
				{
					percentage = 0;
				}
				else if(percentage > 1)
				{
					percentage = 1;
				}
			}
			if(this._direction === Direction.VERTICAL)
			{
				var calculatedHeight:Number = Math.round(percentage * (this.actualHeight - this._paddingTop - this._paddingBottom));
				if(calculatedHeight < this._originalFillHeight)
				{
					calculatedHeight = this._originalFillHeight;
					//if the size is too small, and the value is equal to the
					//minimum, people don't expect to see the fill
					this.currentFill.visible = this._value > this._minimum;
				}
				else
				{
					//if it was hidden before, we want to show it again
					this.currentFill.visible = true;
				}
				this.currentFill.width = this.actualWidth - this._paddingLeft - this._paddingRight;
				this.currentFill.height = calculatedHeight;
				this.currentFill.x = this._paddingLeft;
				this.currentFill.y = this.actualHeight - this._paddingBottom - this.currentFill.height;
			}
			else //horizontal
			{
				var calculatedWidth:Number = Math.round(percentage * (this.actualWidth - this._paddingLeft - this._paddingRight));
				if(calculatedWidth < this._originalFillWidth)
				{
					calculatedWidth = this._originalFillWidth;
					//if the size is too small, and the value is equal to the
					//minimum, people don't expect to see the fill
					this.currentFill.visible = this._value > this._minimum;
				}
				else
				{
					//if it was hidden before, we want to show it again
					this.currentFill.visible = true;
				}
				this.currentFill.width = calculatedWidth;
				this.currentFill.height = this.actualHeight - this._paddingTop - this._paddingBottom;
				this.currentFill.x = this._paddingLeft;
				this.currentFill.y = this._paddingTop;
			}
		}
	}
}


================================================
FILE: source/feathers/controls/PullViewDisplayMode.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * Constants that define how pull views are displayed in a container.
	 *
	 * @productversion Feathers 3.2.0
	 */
	public class PullViewDisplayMode
	{
		/**
		 * The pull view is fixed to the edge of the the scroller's view port.
		 * If <code>hasElasticEdges</code> is <code>true</code>, the pull view
		 * will be revealed under the scroller's content. If
		 * <code>hasElasticEdges</code> is <code>false</code>, the pull view
		 * will fade in above the scroller's content.
		 *
		 * @productversion Feathers 3.2.0
		 */
		public static const FIXED:String = "fixed";

		/**
		 * The pull view may be dragged with the scroller's content. If
		 * <code>hasElasticEdges</code> is <code>false</code>, and the scroll
		 * position reaches the minimum or maximum, the pull view may be dragged
		 * while the content remains fixed.
		 *
		 * @productversion Feathers 3.2.0
		 */
		public static const DRAG:String = "drag";
	}
}


================================================
FILE: source/feathers/controls/Radio.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.IGroupedToggle;
	import feathers.core.ToggleGroup;
	import feathers.skins.IStyleProvider;

	import flash.errors.IllegalOperationError;

	import starling.events.Event;

	[Exclude(name="isToggle",kind="property")]

	/**
	 * A toggleable control that exists in a set that requires a single,
	 * exclusive toggled item.
	 *
	 * <p>In the following example, a set of radios are created, along with a
	 * toggle group to group them together:</p>
	 *
	 * <listing version="3.0">
	 * var group:ToggleGroup = new ToggleGroup();
	 * group.addEventListener( Event.CHANGE, group_changeHandler );
	 * 
	 * var radio1:Radio = new Radio();
	 * radio1.label = "One";
	 * radio1.toggleGroup = group;
	 * this.addChild( radio1 );
	 * 
	 * var radio2:Radio = new Radio();
	 * radio2.label = "Two";
	 * radio2.toggleGroup = group;
	 * this.addChild( radio2 );
	 * 
	 * var radio3:Radio = new Radio();
	 * radio3.label = "Three";
	 * radio3.toggleGroup = group;
	 * this.addChild( radio3 );</listing>
	 *
	 * @see ../../../help/radio.html How to use the Feathers Radio component
	 * @see feathers.core.ToggleGroup
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class Radio extends ToggleButton implements IGroupedToggle
	{
		/**
		 * The default value added to the <code>styleNameList</code> of the label.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_LABEL:String = "feathers-radio-label";

		/**
		 * If a <code>Radio</code> has not been added to a <code>ToggleGroup</code>,
		 * it will automatically be added to this group. If the Radio's
		 * <code>toggleGroup</code> property is set to a different group, it
		 * will be automatically removed from this group, if required.
		 */
		public static const defaultRadioGroup:ToggleGroup = new ToggleGroup();

		/**
		 * The default <code>IStyleProvider</code> for all <code>Radio</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function Radio()
		{
			super();
			super.isToggle = true;
			this.labelStyleName = DEFAULT_CHILD_STYLE_NAME_LABEL;
			this.addEventListener(Event.ADDED_TO_STAGE, radio_addedToStageHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, radio_removedFromStageHandler);
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return Radio.globalStyleProvider;
		}

		/**
		 * @private
		 */
		override public function set isToggle(value:Boolean):void
		{
			throw IllegalOperationError("Radio isToggle must always be true.");
		}

		/**
		 * @private
		 */
		override public function set toggleGroup(value:ToggleGroup):void
		{
			if(this._toggleGroup === value)
			{
				return;
			}
			//a null toggle group will automatically add it to
			//defaultRadioGroup. however, if toggleGroup is already
			//defaultRadioGroup, then we really want to use null because
			//otherwise we'd remove the radio from defaultRadioGroup and then
			//immediately add it back because ToggleGroup sets the toggleGroup
			//property to null when removing an item.
			if(!value && this._toggleGroup !== defaultRadioGroup && this.stage)
			{
				value = defaultRadioGroup;
			}
			super.toggleGroup = value;
		}

		/**
		 * @private
		 */
		protected function radio_addedToStageHandler(event:Event):void
		{
			if(!this._toggleGroup)
			{
				this.toggleGroup = defaultRadioGroup;
			}
		}

		/**
		 * @private
		 */
		protected function radio_removedFromStageHandler(event:Event):void
		{
			if(this._toggleGroup == defaultRadioGroup)
			{
				this._toggleGroup.removeItem(this);
			}
		}
	}
}


================================================
FILE: source/feathers/controls/Screen.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.skins.IStyleProvider;
	import feathers.utils.display.getDisplayObjectDepthFromStage;

	import flash.events.KeyboardEvent;
	import flash.ui.Keyboard;

	import starling.events.Event;

	/**
	 * Dispatched when the transition animation begins as the screen is shown
	 * by the screen navigator.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.TRANSITION_IN_START
	 */
	[Event(name="transitionInStart",type="starling.events.Event")]

	/**
	 * Dispatched when the transition animation finishes as the screen is shown
	 * by the screen navigator.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.TRANSITION_IN_COMPLETE
	 */
	[Event(name="transitionInComplete",type="starling.events.Event")]

	/**
	 * Dispatched when the transition animation begins as a different screen is
	 * shown by the screen navigator and this screen is hidden.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.TRANSITION_OUT_START
	 */
	[Event(name="transitionOutStart",type="starling.events.Event")]

	/**
	 * Dispatched when the transition animation finishes as a different screen
	 * is shown by the screen navigator and this screen is hidden.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.TRANSITION_OUT_COMPLETE
	 */
	[Event(name="transitionOutComplete",type="starling.events.Event")]

	/**
	 * A basic screen to be displayed by <code>ScreenNavigator</code>. Provides
	 * layout capabilities, but no scrolling.
	 *
	 * <p>The following example provides a basic framework for a new screen:</p>
	 *
	 * <listing version="3.0">
	 * package
	 * {
	 *     import feathers.controls.Screen;
	 * 
	 *     public class CustomScreen extends Screen
	 *     {
	 *         public function CustomScreen()
	 *         {
	 *             super();
	 *         }
	 * 
	 *         override protected function initialize():void
	 *         {
	 *             //runs once when screen is first added to the stage
	 *             //a good place to add children and customize the layout
	 * 
	 *             //don't forget to call this!
	 *             super.initialize()
	 *         }
	 *     }
	 * }</listing>
	 *
	 * @see ../../../help/screen.html How to use the Feathers Screen component
	 * @see feathers.controls.StackScreenNavigator
	 * @see feathers.controls.ScreenNavigator
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class Screen extends LayoutGroup implements IScreen
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>Screen</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function Screen()
		{
			this.addEventListener(Event.ADDED_TO_STAGE, screen_addedToStageHandler);
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return Screen.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _screenID:String;

		/**
		 * @inheritDoc
		 */
		public function get screenID():String
		{
			return this._screenID;
		}

		/**
		 * @private
		 */
		public function set screenID(value:String):void
		{
			this._screenID = value;
		}

		/**
		 * @private
		 */
		protected var _owner:Object;

		/**
		 * @inheritDoc
		 */
		public function get owner():Object
		{
			return this._owner;
		}

		/**
		 * @private
		 */
		public function set owner(value:Object):void
		{
			this._owner = value;
		}

		/**
		 * Optional callback for the back hardware key. Automatically handles
		 * keyboard events to cancel the default behavior.
		 *
		 * <p>This function has the following signature:</p>
		 *
		 * <pre>function():void</pre>
		 *
		 * <p>In the following example, a function will dispatch <code>Event.COMPLETE</code>
		 * when the back button is pressed:</p>
		 *
		 * <listing version="3.0">
		 * this.backButtonHandler = onBackButton;
		 * 
		 * private function onBackButton():void
		 * {
		 *     this.dispatchEvent( Event.COMPLETE );
		 * };</listing>
		 *
		 * @default null
		 */
		protected var backButtonHandler:Function;

		/**
		 * Optional callback for the menu hardware key. Automatically handles
		 * keyboard events to cancel the default behavior.
		 *
		 * <p>This function has the following signature:</p>
		 *
		 * <pre>function():void</pre>
		 *
		 * <p>In the following example, a function will be called when the menu
		 * button is pressed:</p>
		 *
		 * <listing version="3.0">
		 * this.menuButtonHandler = onMenuButton;
		 * 
		 * private function onMenuButton():void
		 * {
		 *     //do something with the menu button
		 * };</listing>
		 *
		 * @default null
		 */
		protected var menuButtonHandler:Function;

		/**
		 * Optional callback for the search hardware key. Automatically handles
		 * keyboard events to cancel the default behavior.
		 *
		 * <p>This function has the following signature:</p>
		 *
		 * <pre>function():void</pre>
		 *
		 * <p>In the following example, a function will be called when the search
		 * button is pressed:</p>
		 *
		 * <listing version="3.0">
		 * this.searchButtonHandler = onSearchButton;
		 * 
		 * private function onSearchButton():void
		 * {
		 *     //do something with the search button
		 * };</listing>
		 *
		 * @default null
		 */
		protected var searchButtonHandler:Function;

		/**
		 * @private
		 */
		protected function screen_addedToStageHandler(event:Event):void
		{
			if(event.target != this)
			{
				return;
			}
			this.addEventListener(Event.REMOVED_FROM_STAGE, screen_removedFromStageHandler);
			//using priority here is a hack so that objects higher up in the
			//display list have a chance to cancel the event first.
			var priority:int = -getDisplayObjectDepthFromStage(this);
			this.stage.starling.nativeStage.addEventListener(KeyboardEvent.KEY_DOWN, screen_nativeStage_keyDownHandler, false, priority, true);
		}

		/**
		 * @private
		 */
		protected function screen_removedFromStageHandler(event:Event):void
		{
			if(event.target != this)
			{
				return;
			}
			this.removeEventListener(Event.REMOVED_FROM_STAGE, screen_removedFromStageHandler);
			this.stage.starling.nativeStage.removeEventListener(KeyboardEvent.KEY_DOWN, screen_nativeStage_keyDownHandler);
		}

		/**
		 * @private
		 */
		protected function screen_nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.isDefaultPrevented())
			{
				//someone else already handled this one
				return;
			}
			if(this.backButtonHandler != null &&
				event.keyCode == Keyboard.BACK)
			{
				event.preventDefault();
				this.backButtonHandler();
			}

			if(this.menuButtonHandler != null &&
				event.keyCode == Keyboard.MENU)
			{
				event.preventDefault();
				this.menuButtonHandler();
			}

			if(this.searchButtonHandler != null &&
				event.keyCode == Keyboard.SEARCH)
			{
				event.preventDefault();
				this.searchButtonHandler();
			}
		}
	}
}

================================================
FILE: source/feathers/controls/ScreenNavigator.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.supportClasses.BaseScreenNavigator;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;

	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * Typically used to provide some kind of animation or visual effect,
	 * this function is called when a new screen is shown.
	 *
	 * <p>In the following example, the screen navigator is given a
	 * transition that fades in the new screen on top of the old screen:</p>
	 *
	 * <listing version="3.0">
	 * navigator.transition = Fade.createFadeInTransition();</listing>
	 *
	 * <p>A number of animated transitions may be found in the
	 * <a href="../motion/package-detail.html">feathers.motion</a> package.
	 * However, you are not limited to only these transitions. It's possible
	 * to create custom transitions too.</p>
	 *
	 * <p>A custom transition function should have the following signature:</p>
	 * <pre>function(oldScreen:DisplayObject, newScreen:DisplayObject, completeCallback:Function):void</pre>
	 *
	 * <p>Either of the <code>oldScreen</code> and <code>newScreen</code>
	 * arguments may be <code>null</code>, but never both. The
	 * <code>oldScreen</code> argument will be <code>null</code> when the
	 * first screen is displayed or when a new screen is displayed after
	 * clearing the screen. The <code>newScreen</code> argument will
	 * be null when clearing the screen.</p>
	 *
	 * <p>The <code>completeCallback</code> function <em>must</em> be called
	 * when the transition effect finishes.This callback indicate to the
	 * screen navigator that the transition has finished. This function has
	 * the following signature:</p>
	 *
	 * <pre>function(cancelTransition:Boolean = false):void</pre>
	 *
	 * <p>The first argument defaults to <code>false</code>, meaning that
	 * the transition completed successfully. In most cases, this callback
	 * may be called without arguments. If a transition is cancelled before
	 * completion (perhaps through some kind of user interaction), and the
	 * previous screen should be restored, pass <code>true</code> as the
	 * first argument to the callback to inform the screen navigator that
	 * the transition is cancelled.</p>
	 *
	 * @default null
	 *
	 * @see #showScreen()
	 * @see #clearScreen()
	 * @see ../../../help/transitions.html Transitions for Feathers screen navigators
	 */
	[Style(name="transition",type="Function")]

	/**
	 * A "view stack"-like container that supports navigation between screens
	 * (any display object) through events.
	 *
	 * <p>The following example creates a screen navigator, adds a screen and
	 * displays it:</p>
	 *
	 * <listing version="3.0">
	 * var navigator:ScreenNavigator = new ScreenNavigator();
	 * navigator.addScreen( "mainMenu", new ScreenNavigatorItem( MainMenuScreen ) );
	 * this.addChild( navigator );
	 * navigator.showScreen( "mainMenu" );</listing>
	 *
	 * @see ../../../help/screen-navigator.html How to use the Feathers ScreenNavigator component
	 * @see ../../../help/transitions.html Transitions for Feathers screen navigators
	 * @see feathers.controls.ScreenNavigatorItem
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class ScreenNavigator extends BaseScreenNavigator
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>ScreenNavigator</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function ScreenNavigator()
		{
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return ScreenNavigator.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _transition:Function;

		/**
		 * @private
		 */
		public function get transition():Function
		{
			return this._transition;
		}

		/**
		 * @private
		 */
		public function set transition(value:Function):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._transition = value;
		}

		/**
		 * @private
		 */
		protected var _screenEvents:Object = {};

		/**
		 * Registers a new screen with a string identifier that can be used
		 * to reference the screen in other calls, like <code>removeScreen()</code>
		 * or <code>showScreen()</code>.
		 *
		 * @see #removeScreen()
		 */
		public function addScreen(id:String, item:ScreenNavigatorItem):void
		{
			this.addScreenInternal(id, item);
		}

		/**
		 * Removes an existing screen using the identifier assigned to it in the
		 * call to <code>addScreen()</code>.
		 *
		 * @see #removeAllScreens()
		 * @see #addScreen()
		 */
		public function removeScreen(id:String):ScreenNavigatorItem
		{
			return ScreenNavigatorItem(this.removeScreenInternal(id));
		}

		/**
		 * Returns the <code>ScreenNavigatorItem</code> instance with the
		 * specified identifier.
		 */
		public function getScreen(id:String):ScreenNavigatorItem
		{
			if(this._screens.hasOwnProperty(id))
			{
				return ScreenNavigatorItem(this._screens[id]);
			}
			return null;
		}

		/**
		 * Displays a screen and returns a reference to it. If a previous
		 * transition is running, the new screen will be queued, and no
		 * reference will be returned.
		 *
		 * <p>An optional transition may be specified. If <code>null</code> the
		 * <code>transition</code> property will be used instead.</p>
		 *
		 * @see #style:transition
		 */
		public function showScreen(id:String, transition:Function = null):DisplayObject
		{
			if(this._activeScreenID === id)
			{
				return this._activeScreen;
			}
			if(transition === null)
			{
				transition = this._transition;
			}
			return this.showScreenInternal(id, transition);
		}

		/**
		 * Removes the current screen, leaving the <code>ScreenNavigator</code>
		 * empty.
		 *
		 * <p>An optional transition may be specified. If <code>null</code> the
		 * <code>transition</code> property will be used instead.</p>
		 *
		 * @see #style:transition
		 */
		public function clearScreen(transition:Function = null):void
		{
			if(transition == null)
			{
				transition = this._transition;
			}
			this.clearScreenInternal(transition);
			this.dispatchEventWith(FeathersEventType.CLEAR);
		}

		/**
		 * @private
		 */
		override protected function prepareActiveScreen():void
		{
			var item:ScreenNavigatorItem = ScreenNavigatorItem(this._screens[this._activeScreenID]);
			var events:Object = item.events;
			var savedScreenEvents:Object = {};
			for(var eventName:String in events)
			{
				var signal:Object = null;
				if(BaseScreenNavigator.SIGNAL_TYPE !== null &&
					this._activeScreen.hasOwnProperty(eventName))
				{
					signal = this._activeScreen[eventName] as BaseScreenNavigator.SIGNAL_TYPE;
				}
				var eventAction:Object = events[eventName];
				if(eventAction is Function)
				{
					if(signal)
					{
						signal.add(eventAction as Function);
					}
					else
					{
						this._activeScreen.addEventListener(eventName, eventAction as Function);
					}
				}
				else if(eventAction is String)
				{
					if(signal)
					{
						var eventListener:Function = this.createShowScreenSignalListener(eventAction as String, signal);
						signal.add(eventListener);
					}
					else
					{
						eventListener = this.createShowScreenEventListener(eventAction as String);
						this._activeScreen.addEventListener(eventName, eventListener);
					}
					savedScreenEvents[eventName] = eventListener;
				}
				else
				{
					throw new TypeError("Unknown event action defined for screen:", eventAction.toString());
				}
			}
			this._screenEvents[this._activeScreenID] = savedScreenEvents;
		}

		/**
		 * @private
		 */
		override protected function cleanupActiveScreen():void
		{
			var item:ScreenNavigatorItem = ScreenNavigatorItem(this._screens[this._activeScreenID]);
			var events:Object = item.events;
			var savedScreenEvents:Object = this._screenEvents[this._activeScreenID];
			for(var eventName:String in events)
			{
				var signal:Object = null;
				if(BaseScreenNavigator.SIGNAL_TYPE !== null &&
					this._activeScreen.hasOwnProperty(eventName))
				{
					signal = this._activeScreen[eventName] as BaseScreenNavigator.SIGNAL_TYPE;
				}
				var eventAction:Object = events[eventName];
				if(eventAction is Function)
				{
					if(signal)
					{
						signal.remove(eventAction as Function);
					}
					else
					{
						this._activeScreen.removeEventListener(eventName, eventAction as Function);
					}
				}
				else if(eventAction is String)
				{
					var eventListener:Function = savedScreenEvents[eventName] as Function;
					if(signal)
					{
						signal.remove(eventListener);
					}
					else
					{
						this._activeScreen.removeEventListener(eventName, eventListener);
					}
				}
			}
			this._screenEvents[this._activeScreenID] = null;
		}

		/**
		 * @private
		 */
		protected function createShowScreenEventListener(screenID:String):Function
		{
			var self:ScreenNavigator = this;
			var eventListener:Function = function(event:Event):void
			{
				self.showScreen(screenID);
			};

			return eventListener;
		}

		/**
		 * @private
		 */
		protected function createShowScreenSignalListener(screenID:String, signal:Object):Function
		{
			var self:ScreenNavigator = this;
			if(signal.valueClasses.length == 1)
			{
				//shortcut to avoid the allocation of the rest array
				var signalListener:Function = function(arg0:Object):void
				{
					self.showScreen(screenID);
				};
			}
			else
			{
				signalListener = function(...rest:Array):void
				{
					self.showScreen(screenID);
				};
			}

			return signalListener;
		}
	}

}

================================================
FILE: source/feathers/controls/ScreenNavigatorItem.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.supportClasses.IScreenNavigatorItem;

	import starling.display.DisplayObject;

	/**
	 * Data for an individual screen that will be displayed by a
	 * <code>ScreenNavigator</code> component.
	 *
	 * <p>The following example creates a new <code>ScreenNavigatorItem</code>
	 * using the <code>SettingsScreen</code> class to instantiate the screen
	 * instance. When the screen is shown, its <code>settings</code> property
	 * will be set. When the screen instance dispatches
	 * <code>Event.COMPLETE</code>, the <code>ScreenNavigator</code> will
	 * navigate to a screen with the ID <code>"mainMenu"</code>.</p>
	 *
	 * <listing version="3.0">
	 * var settingsData:Object = { volume: 0.8, difficulty: "hard" };
	 * var item:ScreenNavigatorItem = new ScreenNavigatorItem( SettingsScreen );
	 * item.properties.settings = settingsData;
	 * item.setScreenIDForEvent( Event.COMPLETE, "mainMenu" );
	 * navigator.addScreen( "settings", item );</listing>
	 *
	 * @see ../../../help/screen-navigator.html How to use the Feathers ScreenNavigator component
	 * @see feathers.controls.ScreenNavigator
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class ScreenNavigatorItem implements IScreenNavigatorItem
	{
		/**
		 * Constructor.
		 */
		public function ScreenNavigatorItem(screen:Object = null, events:Object = null, properties:Object = null)
		{
			this._screen = screen;
			this._events = events ? events : {};
			this._properties = properties ? properties : {};
		}

		/**
		 * @private
		 */
		protected var _screen:Object;

		/**
		 * The screen to be displayed by the <code>ScreenNavigator</code>. It
		 * may be one of several possible types:
		 *
		 * <ul>
		 *     <li>a <code>Class</code> that may be instantiated to create a <code>DisplayObject</code></li>
		 *     <li>a <code>Function</code> that returns a <code>DisplayObject</code></li>
		 *     <li>a Starling <code>DisplayObject</code> that is already instantiated</li>
		 * </ul>
		 *
		 * <p>If the screen is a <code>Class</code> or a <code>Function</code>,
		 * a new instance of the screen will be instantiated every time that it
		 * is shown by the <code>ScreenNavigator</code>. The screen's state
		 * will not be saved automatically. The screen's state may be saved in
		 * <code>properties</code>, if needed.</p>
		 *
		 * <p>If the screen is a <code>DisplayObject</code>, the same instance
		 * will be reused every time that it is shown by the
		 * <code>ScreenNavigator</code>. When the screen is shown again, its
		 * state will remain the same as when it was previously hidden. However,
		 * the screen will also be kept in memory even when it isn't visible,
		 * limiting the resources that are available for other screens.</p>
		 *
		 * @default null
		 */
		public function get screen():Object
		{
			return this._screen;
		}

		/**
		 * @private
		 */
		public function set screen(value:Object):void
		{
			this._screen = value;
		}

		/**
		 * @private
		 */
		protected var _events:Object;

		/**
		 * A set of key-value pairs representing actions that should be
		 * triggered when events are dispatched by the screen when it is shown.
		 * A pair's key is the event type to listen for (or the property name of
		 * an <code>ISignal</code> instance), and a pair's value is one of two
		 * possible types. When this event is dispatched, and a pair's value
		 * is a <code>String</code>, the <code>ScreenNavigator</code> will show
		 * another screen with an ID equal to the string value. When this event
		 * is dispatched, and the pair's value is a <code>Function</code>, the
		 * function will be called as if it were a listener for the event.
		 *
		 * @see #setFunctionForEvent()
		 * @see #setScreenIDForEvent()
		 */
		public function get events():Object
		{
			return this._events;
		}

		/**
		 * @private
		 */
		public function set events(value:Object):void
		{
			if(!value)
			{
				value = {};
			}
			this._events = value;
		}

		/**
		 * @private
		 */
		protected var _properties:Object;

		/**
		 * A set of key-value pairs representing properties to be set on the
		 * screen when it is shown. A pair's key is the name of the screen's
		 * property, and a pair's value is the value to be passed to the
		 * screen's property.
		 */
		public function get properties():Object
		{
			return this._properties;
		}

		/**
		 * @private
		 */
		public function set properties(value:Object):void
		{
			if(!value)
			{
				value = {};
			}
			this._properties = value;
		}

		/**
		 * @inheritDoc
		 */
		public function get canDispose():Boolean
		{
			return !(this._screen is DisplayObject);
		}

		/**
		 * @private
		 */
		protected var _transitionDelayEvent:String = null;

		/**
		 * @inheritDoc
		 */
		public function get transitionDelayEvent():String
		{
			return this._transitionDelayEvent;
		}

		/**
		 * @private
		 */
		public function set transitionDelayEvent(value:String):void
		{
			this._transitionDelayEvent = value;
		}

		/**
		 * Specifies a function to call when an event is dispatched by the
		 * screen.
		 *
		 * <p>If the screen is currently being displayed by a
		 * <code>ScreenNavigator</code>, and you call
		 * <code>setFunctionForEvent()</code> on the <code>ScreenNavigatorItem</code>,
		 * the <code>ScreenNavigator</code> won't listen for the event until
		 * the next time that the screen is shown.</p>
		 *
		 * @see #setScreenIDForEvent()
		 * @see #clearEvent()
		 * @see #events
		 */
		public function setFunctionForEvent(eventType:String, action:Function):void
		{
			this._events[eventType] = action;
		}

		/**
		 * Specifies another screen to navigate to when an event is dispatched
		 * by this screen. The other screen should be specified by its ID that
		 * is registered with the <code>ScreenNavigator</code>.
		 *
		 * <p>If the screen is currently being displayed by a
		 * <code>ScreenNavigator</code>, and you call
		 * <code>setScreenIDForEvent()</code> on the <code>ScreenNavigatorItem</code>,
		 * the <code>ScreenNavigator</code> won't listen for the event until the
		 * next time that the screen is shown.</p>
		 *
		 * @see #setFunctionForEvent()
		 * @see #clearEvent()
		 * @see #events
		 */
		public function setScreenIDForEvent(eventType:String, screenID:String):void
		{
			this._events[eventType] = screenID;
		}

		/**
		 * Cancels the action previously registered to be triggered when the
		 * screen dispatches an event.
		 *
		 * @see #events
		 */
		public function clearEvent(eventType:String):void
		{
			delete this._events[eventType];
		}

		/**
		 * @inheritDoc
		 */
		public function getScreen():DisplayObject
		{
			var screenInstance:DisplayObject;
			if(this._screen is Class)
			{
				var ScreenType:Class = Class(this._screen);
				screenInstance = new ScreenType();
			}
			else if(this._screen is Function)
			{
				screenInstance = DisplayObject((this._screen as Function)());
			}
			else
			{
				screenInstance = DisplayObject(this._screen);
			}
			if(!(screenInstance is DisplayObject))
			{
				throw new ArgumentError("ScreenNavigatorItem \"getScreen()\" must return a Starling display object.");
			}

			if(this._properties)
			{
				for(var propertyName:String in this._properties)
				{
					screenInstance[propertyName] = this._properties[propertyName];
				}
			}

			return screenInstance;
		}
	}
}

================================================
FILE: source/feathers/controls/ScrollBar.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IFocusDisplayObject;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IValidating;
	import feathers.core.PropertyProxy;
	import feathers.events.FeathersEventType;
	import feathers.layout.Direction;
	import feathers.skins.IStyleProvider;
	import feathers.utils.math.clamp;
	import feathers.utils.math.roundDownToNearest;
	import feathers.utils.math.roundToNearest;
	import feathers.utils.math.roundUpToNearest;

	import flash.events.TimerEvent;
	import flash.geom.Point;
	import flash.utils.Timer;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * A style name to add to the scroll bar's decrement button
	 * sub-component. Typically used by a theme to provide different styles
	 * to different scroll bars.
	 *
	 * <p>In the following example, a custom decrement button style name is
	 * passed to the scroll bar:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.customDecrementButtonStyleName = "my-custom-decrement-button";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different skins than the default style:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-decrement-button", setCustomDecrementButtonStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #decrementButtonFactory
	 */
	[Style(name="customDecrementButtonStyleName",type="String")]

	/**
	 * A style name to add to the scroll bar's increment button
	 * sub-component. Typically used by a theme to provide different styles
	 * to different scroll bars.
	 *
	 * <p>In the following example, a custom increment button style name is
	 * passed to the scroll bar:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.customIncrementButtonStyleName = "my-custom-increment-button";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-increment-button", setCustomIncrementButtonStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #incrementButtonFactory
	 */
	[Style(name="customIncrementButtonStyleName",type="String")]

	/**
	 * A style name to add to the scroll bar's minimum track sub-component.
	 * Typically used by a theme to provide different styles to different
	 * scroll bars.
	 *
	 * <p>In the following example, a custom minimum track style name is
	 * passed to the scroll bar:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.customMinimumTrackStyleName = "my-custom-minimum-track";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to provide
	 * different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-minimum-track", setCustomMinimumTrackStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #minimumTrackFactory
	 */
	[Style(name="customMinimumTrackStyleName",type="String")]

	/**
	 * A style name to add to the scroll bar's maximum track sub-component.
	 * Typically used by a theme to provide different styles to different
	 * scroll bars.
	 *
	 * <p>In the following example, a custom maximum track style name is
	 * passed to the scroll bar:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.customMaximumTrackStyleName = "my-custom-maximum-track";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-maximum-track", setCustomMaximumTrackStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #maximumTrackFactory
	 */
	[Style(name="customMaximumTrackStyleName",type="String")]

	/**
	 * A style name to add to the scroll bar's thumb sub-component.
	 * Typically used by a theme to provide different styles to different
	 * scroll bars.
	 *
	 * <p>In the following example, a custom thumb style name is passed
	 * to the scroll bar:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.customThumbStyleName = "my-custom-thumb";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-thumb", setCustomThumbStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_THUMB
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #thumbFactory
	 */
	[Style(name="customThumbStyleName",type="String")]

	/**
	 * Determines if the scroll bar's thumb can be dragged horizontally or
	 * vertically. When this value changes, the scroll bar's width and
	 * height values do not change automatically.
	 *
	 * <p>Note: When using a <code>ScrollBar</code> with a scrolling
	 * container, the container will automatically set the correct
	 * <code>direction</code> value. Generally, you should not need to set this
	 * style manually.</p>
	 *
	 * <p>In the following example, the direction is changed to vertical:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.direction = Direction.VERTICAL;</listing>
	 *
	 * <p><strong>Note:</strong> The <code>Direction.NONE</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.Direction.HORIZONTAL
	 *
	 * @see feathers.layout.Direction#HORIZONTAL
	 * @see feathers.layout.Direction#VERTICAL
	 */
	[Style(name="direction",type="String")]

	/**
	 * Determines if the scroll bar's thumb will be resized based on the
	 * scrollable range, or if it will be rendered at its preferred size.
	 *
	 * <p>In the following example, the thumb size is fixed:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.fixedThumbSize = true;</listing>
	 *
	 * @default false
	 */
	[Style(name="fixedThumbSize",type="Boolean")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the padding is changed to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, above the content, not
	 * including the track(s).
	 *
	 * <p>In the following example, the top padding is changed to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, to the right of the content, not
	 * including the track(s).
	 *
	 * <p>In the following example, the right padding is changed to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, below the content, not
	 * including the track(s).
	 *
	 * <p>In the following example, the bottom padding is changed to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, to the left of the content, not
	 * including the track(s).
	 *
	 * <p>In the following example, the left padding is changed to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * Determines how the minimum and maximum track skins are positioned and
	 * sized.
	 *
	 * <p>In the following example, the scroll bar is given two tracks:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.trackLayoutMode = TrackLayoutMode.SPLIT;</listing>
	 *
	 * @default feathers.controls.TrackLayoutMode.SINGLE
	 *
	 * @see feathers.controls.TrackLayoutMode#SINGLE
	 * @see feathers.controls.TrackLayoutMode#SPLIT
	 */
	[Style(name="trackLayoutMode",type="String")]

	/**
	 * Dispatched when the scroll bar's value changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the user starts interacting with the scroll bar's thumb,
	 * track, or buttons.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.BEGIN_INTERACTION
	 */
	[Event(name="beginInteraction",type="starling.events.Event")]

	/**
	 * Dispatched when the user stops interacting with the scroll bar's thumb,
	 * track, or buttons.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.END_INTERACTION
	 */
	[Event(name="endInteraction",type="starling.events.Event")]

	/**
	 * Select a value between a minimum and a maximum by dragging a thumb over
	 * a physical range or by using step buttons. This is a desktop-centric
	 * scroll bar with many skinnable parts. For mobile, the
	 * <code>SimpleScrollBar</code> is probably a better choice as it provides
	 * only the thumb to indicate position without all the extra chrome.
	 *
	 * <p>The following example updates a list to use scroll bars:</p>
	 *
	 * <listing version="3.0">
	 * list.horizontalScrollBarFactory = function():IScrollBar
	 * {
	 *     return new ScrollBar();
	 * };
	 * list.verticalScrollBarFactory = function():IScrollBar
	 * {
	 *     return new ScrollBar();
	 * };</listing>
	 *
	 * @see ../../../help/scroll-bar.html How to use the Feathers ScrollBar component
	 * @see feathers.controls.SimpleScrollBar
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class ScrollBar extends FeathersControl implements IDirectionalScrollBar
	{
		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_THUMB_FACTORY:String = "thumbFactory";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_MINIMUM_TRACK_FACTORY:String = "minimumTrackFactory";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_MAXIMUM_TRACK_FACTORY:String = "maximumTrackFactory";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_DECREMENT_BUTTON_FACTORY:String = "decrementButtonFactory";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_INCREMENT_BUTTON_FACTORY:String = "incrementButtonFactory";

		/**
		 * The default value added to the <code>styleNameList</code> of the minimum
		 * track.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK:String = "feathers-scroll-bar-minimum-track";

		/**
		 * The default value added to the <code>styleNameList</code> of the maximum
		 * track.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK:String = "feathers-scroll-bar-maximum-track";

		/**
		 * The default value added to the <code>styleNameList</code> of the thumb.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_THUMB:String = "feathers-scroll-bar-thumb";

		/**
		 * The default value added to the <code>styleNameList</code> of the decrement
		 * button.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON:String = "feathers-scroll-bar-decrement-button";

		/**
		 * The default value added to the <code>styleNameList</code> of the increment
		 * button.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON:String = "feathers-scroll-bar-increment-button";

		/**
		 * The default <code>IStyleProvider</code> for all <code>ScrollBar</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static function defaultThumbFactory():BasicButton
		{
			return new Button();
		}

		/**
		 * @private
		 */
		protected static function defaultMinimumTrackFactory():BasicButton
		{
			return new Button();
		}

		/**
		 * @private
		 */
		protected static function defaultMaximumTrackFactory():BasicButton
		{
			return new Button();
		}

		/**
		 * @private
		 */
		protected static function defaultDecrementButtonFactory():BasicButton
		{
			return new Button();
		}

		/**
		 * @private
		 */
		protected static function defaultIncrementButtonFactory():BasicButton
		{
			return new Button();
		}

		/**
		 * Constructor.
		 */
		public function ScrollBar()
		{
			super();
			this.addEventListener(Event.REMOVED_FROM_STAGE, removedFromStageHandler);
		}

		/**
		 * The value added to the <code>styleNameList</code> of the minimum
		 * track. This variable is <code>protected</code> so that sub-classes
		 * can customize the minimum track style name in their constructors
		 * instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK</code>.
		 *
		 * <p>To customize the minimum track style name without subclassing, see
		 * <code>customMinimumTrackStyleName</code>.</p>
		 *
		 * @see #style:customMinimumTrackStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var minimumTrackStyleName:String = DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK;

		/**
		 * The value added to the <code>styleNameList</code> of the maximum
		 * track. This variable is <code>protected</code> so that sub-classes
		 * can customize the maximum track style name in their constructors
		 * instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK</code>.
		 *
		 * <p>To customize the maximum track style name without subclassing, see
		 * <code>customMaximumTrackStyleName</code>.</p>
		 *
		 * @see #style:customMaximumTrackStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var maximumTrackStyleName:String = DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK;

		/**
		 * The value added to the <code>styleNameList</code> of the thumb. This
		 * variable is <code>protected</code> so that sub-classes can customize
		 * the thumb style name in their constructors instead of using the
		 * default style name defined by <code>DEFAULT_CHILD_STYLE_NAME_THUMB</code>.
		 *
		 * <p>To customize the thumb style name without subclassing, see
		 * <code>customThumbStyleName</code>.</p>
		 *
		 * @see #style:customThumbStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var thumbStyleName:String = DEFAULT_CHILD_STYLE_NAME_THUMB;

		/**
		 * The value added to the <code>styleNameList</code> of the decrement
		 * button. This variable is <code>protected</code> so that sub-classes
		 * can customize the decrement button style name in their constructors
		 * instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON</code>.
		 *
		 * <p>To customize the decrement button style name without subclassing,
		 * see <code>customDecrementButtonStyleName</code>.</p>
		 *
		 * @see #style:customDecrementButtonStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var decrementButtonStyleName:String = DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON;

		/**
		 * The value added to the <code>styleNameList</code> of the increment
		 * button. This variable is <code>protected</code> so that sub-classes
		 * can customize the increment button style name in their constructors
		 * instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON</code>.
		 *
		 * <p>To customize the increment button style name without subclassing,
		 * see <code>customIncrementButtonName</code>.</p>
		 *
		 * @see #style:customIncrementButtonStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var incrementButtonStyleName:String = DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON;

		/**
		 * @private
		 */
		protected var thumbOriginalWidth:Number = NaN;

		/**
		 * @private
		 */
		protected var thumbOriginalHeight:Number = NaN;

		/**
		 * @private
		 */
		protected var minimumTrackOriginalWidth:Number = NaN;

		/**
		 * @private
		 */
		protected var minimumTrackOriginalHeight:Number = NaN;

		/**
		 * @private
		 */
		protected var maximumTrackOriginalWidth:Number = NaN;

		/**
		 * @private
		 */
		protected var maximumTrackOriginalHeight:Number = NaN;

		/**
		 * The scroll bar's decrement button sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #decrementButtonFactory
		 * @see #createDecrementButton()
		 */
		protected var decrementButton:BasicButton;

		/**
		 * The scroll bar's increment button sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #incrementButtonFactory
		 * @see #createIncrementButton()
		 */
		protected var incrementButton:BasicButton;

		/**
		 * The scroll bar's thumb sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #thumbFactory
		 * @see #createThumb()
		 */
		protected var thumb:DisplayObject;

		/**
		 * The scroll bar's minimum track sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #minimumTrackFactory
		 * @see #createMinimumTrack()
		 */
		protected var minimumTrack:DisplayObject;

		/**
		 * The scroll bar's maximum track sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #maximumTrackFactory
		 * @see #createMaximumTrack()
		 */
		protected var maximumTrack:DisplayObject;

		/**
		 * @private
		 */
		protected var _minimumTrackSkinExplicitWidth:Number;

		/**
		 * @private
		 */
		protected var _minimumTrackSkinExplicitHeight:Number;

		/**
		 * @private
		 */
		protected var _minimumTrackSkinExplicitMinWidth:Number;

		/**
		 * @private
		 */
		protected var _minimumTrackSkinExplicitMinHeight:Number;

		/**
		 * @private
		 */
		protected var _maximumTrackSkinExplicitWidth:Number;

		/**
		 * @private
		 */
		protected var _maximumTrackSkinExplicitHeight:Number;

		/**
		 * @private
		 */
		protected var _maximumTrackSkinExplicitMinWidth:Number;

		/**
		 * @private
		 */
		protected var _maximumTrackSkinExplicitMinHeight:Number;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return ScrollBar.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _direction:String = Direction.HORIZONTAL;

		[Inspectable(type="String",enumeration="horizontal,vertical")]
		/**
		 * @private
		 */
		public function get direction():String
		{
			return this._direction;
		}

		/**
		 * @private
		 */
		public function set direction(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._direction === value)
			{
				return;
			}
			this._direction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
			this.invalidate(INVALIDATION_FLAG_DECREMENT_BUTTON_FACTORY);
			this.invalidate(INVALIDATION_FLAG_INCREMENT_BUTTON_FACTORY);
			this.invalidate(INVALIDATION_FLAG_MINIMUM_TRACK_FACTORY);
			this.invalidate(INVALIDATION_FLAG_MAXIMUM_TRACK_FACTORY);
			this.invalidate(INVALIDATION_FLAG_THUMB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _fixedThumbSize:Boolean = false;

		/**
		 * @private
		 */
		public function get fixedThumbSize():Boolean
		{
			return this._fixedThumbSize;
		}

		/**
		 * @private
		 */
		public function set fixedThumbSize(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._fixedThumbSize === value)
			{
				return;
			}
			this._fixedThumbSize = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _value:Number = 0;

		/**
		 * @inheritDoc
		 *
		 * @default 0
		 *
		 * @see #minimum
		 * @see #maximum
		 * @see #step
		 * @see #page
		 * @see #event:change
		 */
		public function get value():Number
		{
			return this._value;
		}

		/**
		 * @private
		 */
		public function set value(newValue:Number):void
		{
			newValue = clamp(newValue, this._minimum, this._maximum);
			if(this._value == newValue)
			{
				return;
			}
			this._value = newValue;
			this.invalidate(INVALIDATION_FLAG_DATA);
			if(this.liveDragging || !this.isDragging)
			{
				this.dispatchEventWith(Event.CHANGE);
			}
		}

		/**
		 * @private
		 */
		protected var _minimum:Number = 0;

		/**
		 * @inheritDoc
		 *
		 * @default 0
		 *
		 * @see #value
		 * @see #maximum
		 */
		public function get minimum():Number
		{
			return this._minimum;
		}

		/**
		 * @private
		 */
		public function set minimum(value:Number):void
		{
			if(this._minimum == value)
			{
				return;
			}
			this._minimum = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _maximum:Number = 0;

		/**
		 * @inheritDoc
		 *
		 * @default 0
		 *
		 * @see #value
		 * @see #minimum
		 */
		public function get maximum():Number
		{
			return this._maximum;
		}

		/**
		 * @private
		 */
		public function set maximum(value:Number):void
		{
			if(this._maximum == value)
			{
				return;
			}
			this._maximum = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _step:Number = 0;

		/**
		 * @inheritDoc
		 *
		 * @default 0
		 *
		 * @see #value
		 * @see #page
		 */
		public function get step():Number
		{
			return this._step;
		}

		/**
		 * @private
		 */
		public function set step(value:Number):void
		{
			this._step = value;
		}

		/**
		 * @private
		 */
		protected var _page:Number = 0;

		/**
		 * @inheritDoc
		 *
		 * @default 0
		 *
		 * @see #value
		 * @see #step
		 */
		public function get page():Number
		{
			return this._page;
		}

		/**
		 * @private
		 */
		public function set page(value:Number):void
		{
			if(this._page == value)
			{
				return;
			}
			this._page = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var currentRepeatAction:Function;

		/**
		 * @private
		 */
		protected var _repeatTimer:Timer;

		/**
		 * @private
		 */
		protected var _repeatDelay:Number = 0.05;

		/**
		 * The time, in seconds, before actions are repeated. The first repeat
		 * happens after a delay that is five times longer than the following
		 * repeats.
		 *
		 * <p>In the following example, the repeat delay is changed to 500 milliseconds:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.repeatDelay = 0.5;</listing>
		 *
		 * @default 0.05
		 */
		public function get repeatDelay():Number
		{
			return this._repeatDelay;
		}

		/**
		 * @private
		 */
		public function set repeatDelay(value:Number):void
		{
			if(this._repeatDelay == value)
			{
				return;
			}
			this._repeatDelay = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var isDragging:Boolean = false;

		/**
		 * Determines if the scroll bar dispatches the <code>Event.CHANGE</code>
		 * event every time the thumb moves, or only once it stops moving.
		 *
		 * <p>In the following example, live dragging is disabled:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.liveDragging = false;</listing>
		 *
		 * @default true
		 */
		public var liveDragging:Boolean = true;

		/**
		 * @private
		 */
		protected var _trackLayoutMode:String = TrackLayoutMode.SINGLE;

		[Inspectable(type="String",enumeration="single,split")]
		/**
		 * @private
		 */
		public function get trackLayoutMode():String
		{
			return this._trackLayoutMode;
		}

		/**
		 * @private
		 */
		public function set trackLayoutMode(value:String):void
		{
			if(value === "minMax")
			{
				value = TrackLayoutMode.SPLIT;
			}
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._trackLayoutMode === value)
			{
				return;
			}
			this._trackLayoutMode = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _minimumTrackFactory:Function;

		/**
		 * A function used to generate the scroll bar's minimum track
		 * sub-component. The minimum track must be an instance of
		 * <code>BasicButton</code>. This factory can be used to change
		 * properties on the minimum track when it is first created. For
		 * instance, if you are skinning Feathers components without a theme,
		 * you might use this factory to set skins and other styles on the
		 * minimum track.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():BasicButton</pre>
		 *
		 * <p>In the following example, a custom minimum track factory is passed
		 * to the scroll bar:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.minimumTrackFactory = function():BasicButton
		 * {
		 *     var track:BasicButton = new BasicButton();
		 *     track.defaultSkin = new Image( upTexture );
		 *     track.downSkin = new Image( downTexture );
		 *     return track;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 */
		public function get minimumTrackFactory():Function
		{
			return this._minimumTrackFactory;
		}

		/**
		 * @private
		 */
		public function set minimumTrackFactory(value:Function):void
		{
			if(this._minimumTrackFactory == value)
			{
				return;
			}
			this._minimumTrackFactory = value;
			this.invalidate(INVALIDATION_FLAG_MINIMUM_TRACK_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customMinimumTrackStyleName:String;

		/**
		 * @private
		 */
		public function get customMinimumTrackStyleName():String
		{
			return this._customMinimumTrackStyleName;
		}

		/**
		 * @private
		 */
		public function set customMinimumTrackStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customMinimumTrackStyleName === value)
			{
				return;
			}
			this._customMinimumTrackStyleName = value;
			this.invalidate(INVALIDATION_FLAG_MINIMUM_TRACK_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _minimumTrackProperties:PropertyProxy;

		/**
		 * An object that stores properties for the scroll bar's "minimum"
		 * track, and the properties will be passed down to the "minimum" track when
		 * the scroll bar validates. For a list of available properties, refer to
		 * <a href="Button.html"><code>feathers.controls.BasicButton</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>minimumTrackFactory</code> function
		 * instead of using <code>minimumTrackProperties</code> will result in
		 * better performance.</p>
		 *
		 * <p>In the following example, the scroll bar's minimum track properties
		 * are updated:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.minimumTrackProperties.defaultSkin = new Image( upTexture );
		 * scrollBar.minimumTrackProperties.downSkin = new Image( downTexture );</listing>
		 *
		 * @default null
		 *
		 * @see #minimumTrackFactory
		 * @see feathers.controls.BasicButton
		 */
		public function get minimumTrackProperties():Object
		{
			if(!this._minimumTrackProperties)
			{
				this._minimumTrackProperties = new PropertyProxy(minimumTrackProperties_onChange);
			}
			return this._minimumTrackProperties;
		}

		/**
		 * @private
		 */
		public function set minimumTrackProperties(value:Object):void
		{
			if(this._minimumTrackProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._minimumTrackProperties)
			{
				this._minimumTrackProperties.removeOnChangeCallback(minimumTrackProperties_onChange);
			}
			this._minimumTrackProperties = PropertyProxy(value);
			if(this._minimumTrackProperties)
			{
				this._minimumTrackProperties.addOnChangeCallback(minimumTrackProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _maximumTrackFactory:Function;

		/**
		 * A function used to generate the scroll bar's maximum track
		 * sub-component. The maximum track must be an instance of
		 * <code>BasicButton</code>. This factory can be used to change
		 * properties on the maximum track when it is first created. For
		 * instance, if you are skinning Feathers components without a theme,
		 * you might use this factory to set skins and other styles on the
		 * maximum track.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():BasicButton</pre>
		 *
		 * <p>In the following example, a custom maximum track factory is passed
		 * to the scroll bar:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.maximumTrackFactory = function():BasicButton
		 * {
		 *     var track:BasicButton = new BasicButton();
		 *     track.defaultSkin = new Image( upTexture );
		 *     track.downSkin = new Image( downTexture );
		 *     return track;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 */
		public function get maximumTrackFactory():Function
		{
			return this._maximumTrackFactory;
		}

		/**
		 * @private
		 */
		public function set maximumTrackFactory(value:Function):void
		{
			if(this._maximumTrackFactory == value)
			{
				return;
			}
			this._maximumTrackFactory = value;
			this.invalidate(INVALIDATION_FLAG_MAXIMUM_TRACK_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customMaximumTrackStyleName:String;

		/**
		 * @private
		 */
		public function get customMaximumTrackStyleName():String
		{
			return this._customMaximumTrackStyleName;
		}

		/**
		 * @private
		 */
		public function set customMaximumTrackStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customMaximumTrackStyleName === value)
			{
				return;
			}
			this._customMaximumTrackStyleName = value;
			this.invalidate(INVALIDATION_FLAG_MAXIMUM_TRACK_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _maximumTrackProperties:PropertyProxy;

		/**
		 * An object that stores properties for the scroll bar's "maximum"
		 * track, and the properties will be passed down to the "maximum" track when
		 * the scroll bar validates. For a list of available properties, refer to
		 * <a href="Button.html"><code>feathers.controls.BasicButton</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>maximumTrackFactory</code> function
		 * instead of using <code>maximumTrackProperties</code> will result in
		 * better performance.</p>
		 *
		 * <p>In the following example, the scroll bar's maximum track properties
		 * are updated:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.maximumTrackProperties.defaultSkin = new Image( upTexture );
		 * scrollBar.maximumTrackProperties.downSkin = new Image( downTexture );</listing>
		 *
		 * @default null
		 *
		 * @see #maximumTrackFactory
		 * @see feathers.controls.BasicButton
		 */
		public function get maximumTrackProperties():Object
		{
			if(!this._maximumTrackProperties)
			{
				this._maximumTrackProperties = new PropertyProxy(maximumTrackProperties_onChange);
			}
			return this._maximumTrackProperties;
		}

		/**
		 * @private
		 */
		public function set maximumTrackProperties(value:Object):void
		{
			if(this._maximumTrackProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._maximumTrackProperties)
			{
				this._maximumTrackProperties.removeOnChangeCallback(maximumTrackProperties_onChange);
			}
			this._maximumTrackProperties = PropertyProxy(value);
			if(this._maximumTrackProperties)
			{
				this._maximumTrackProperties.addOnChangeCallback(maximumTrackProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _thumbFactory:Function;

		/**
		 * A function used to generate the scroll bar's thumb sub-component.
		 * The thumb must be an instance of <code>Button</code>. This factory
		 * can be used to change properties on the thumb when it is first
		 * created. For instance, if you are skinning Feathers components
		 * without a theme, you might use this factory to set skins and other
		 * styles on the thumb.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():BasicButton</pre>
		 *
		 * <p>In the following example, a custom thumb factory is passed
		 * to the scroll bar:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.thumbFactory = function():BasicButton
		 * {
		 *     var thumb:BasicButton = new BasicButton();
		 *     thumb.defaultSkin = new Image( upTexture );
		 *     thumb.downSkin = new Image( downTexture );
		 *     return thumb;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 */
		public function get thumbFactory():Function
		{
			return this._thumbFactory;
		}

		/**
		 * @private
		 */
		public function set thumbFactory(value:Function):void
		{
			if(this._thumbFactory == value)
			{
				return;
			}
			this._thumbFactory = value;
			this.invalidate(INVALIDATION_FLAG_THUMB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customThumbStyleName:String;

		/**
		 * @private
		 */
		public function get customThumbStyleName():String
		{
			return this._customThumbStyleName;
		}

		/**
		 * @private
		 */
		public function set customThumbStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customThumbStyleName === value)
			{
				return;
			}
			this._customThumbStyleName = value;
			this.invalidate(INVALIDATION_FLAG_THUMB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _thumbProperties:PropertyProxy;

		/**
		 * An object that stores properties for the scroll bar's thumb, and the
		 * properties will be passed down to the thumb when the scroll bar
		 * validates. For a list of available properties, refer to
		 * <a href="Button.html"><code>feathers.controls.BasicButton</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>thumbFactory</code> function instead
		 * of using <code>thumbProperties</code> will result in better
		 * performance.</p>
		 *
		 * <p>In the following example, the scroll bar's thumb properties
		 * are updated:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.thumbProperties.defaultSkin = new Image( upTexture );
		 * scrollBar.thumbProperties.downSkin = new Image( downTexture );</listing>
		 *
		 * @default null
		 *
		 * @see #thumbFactory
		 * @see feathers.controls.BasicButton
		 */
		public function get thumbProperties():Object
		{
			if(!this._thumbProperties)
			{
				this._thumbProperties = new PropertyProxy(thumbProperties_onChange);
			}
			return this._thumbProperties;
		}

		/**
		 * @private
		 */
		public function set thumbProperties(value:Object):void
		{
			if(this._thumbProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._thumbProperties)
			{
				this._thumbProperties.removeOnChangeCallback(thumbProperties_onChange);
			}
			this._thumbProperties = PropertyProxy(value);
			if(this._thumbProperties)
			{
				this._thumbProperties.addOnChangeCallback(thumbProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _decrementButtonFactory:Function;

		/**
		 * A function used to generate the scroll bar's decrement button
		 * sub-component. The decrement button must be an instance of
		 * <code>BasicButton</code>. This factory can be used to change
		 * properties on the decrement button when it is first created. For
		 * instance, if you are skinning Feathers components without a theme,
		 * you might use this factory to set skins and other styles on the
		 * decrement button.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():BasicButton</pre>
		 *
		 * <p>In the following example, a custom decrement button factory is passed
		 * to the scroll bar:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.decrementButtonFactory = function():BasicButton
		 * {
		 *     var button:BasicButton = new BasicButton();
		 *     button.defaultSkin = new Image( upTexture );
		 *     button.downSkin = new Image( downTexture );
		 *     return button;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 */
		public function get decrementButtonFactory():Function
		{
			return this._decrementButtonFactory;
		}

		/**
		 * @private
		 */
		public function set decrementButtonFactory(value:Function):void
		{
			if(this._decrementButtonFactory == value)
			{
				return;
			}
			this._decrementButtonFactory = value;
			this.invalidate(INVALIDATION_FLAG_DECREMENT_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customDecrementButtonStyleName:String;

		/**
		 * @private
		 */
		public function get customDecrementButtonStyleName():String
		{
			return this._customDecrementButtonStyleName;
		}

		/**
		 * @private
		 */
		public function set customDecrementButtonStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customDecrementButtonStyleName === value)
			{
				return;
			}
			this._customDecrementButtonStyleName = value;
			this.invalidate(INVALIDATION_FLAG_DECREMENT_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _decrementButtonProperties:PropertyProxy;

		/**
		 * An object that stores properties for the scroll bar's decrement
		 * button, and the properties will be passed down to the decrement
		 * button when the scroll bar validates. For a list of available
		 * properties, refer to
		 * <a href="Button.html"><code>feathers.controls.BasicButton</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>decrementButtonFactory</code>
		 * function instead of using <code>decrementButtonProperties</code> will
		 * result in better performance.</p>
		 *
		 * <p>In the following example, the scroll bar's decrement button properties
		 * are updated:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.decrementButtonProperties.defaultSkin = new Image( upTexture );
		 * scrollBar.decrementButtonProperties.downSkin = new Image( downTexture );</listing>
		 *
		 * @default null
		 *
		 * @see #decrementButtonFactory
		 * @see feathers.controls.BasicButton
		 */
		public function get decrementButtonProperties():Object
		{
			if(!this._decrementButtonProperties)
			{
				this._decrementButtonProperties = new PropertyProxy(decrementButtonProperties_onChange);
			}
			return this._decrementButtonProperties;
		}

		/**
		 * @private
		 */
		public function set decrementButtonProperties(value:Object):void
		{
			if(this._decrementButtonProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._decrementButtonProperties)
			{
				this._decrementButtonProperties.removeOnChangeCallback(decrementButtonProperties_onChange);
			}
			this._decrementButtonProperties = PropertyProxy(value);
			if(this._decrementButtonProperties)
			{
				this._decrementButtonProperties.addOnChangeCallback(decrementButtonProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _incrementButtonFactory:Function;

		/**
		 * A function used to generate the scroll bar's increment button
		 * sub-component. The increment button must be an instance of
		 * <code>BasicButton</code>. This factory can be used to change
		 * properties on the increment button when it is first created. For
		 * instance, if you are skinning Feathers components without a theme,
		 * you might use this factory to set skins and other styles on the
		 * increment button.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():BasicButton</pre>
		 *
		 * <p>In the following example, a custom increment button factory is passed
		 * to the scroll bar:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.incrementButtonFactory = function():BasicButton
		 * {
		 *     var button:BasicButton = new BasicButton();
		 *     button.defaultSkin = new Image( upTexture );
		 *     button.downSkin = new Image( downTexture );
		 *     return button;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 */
		public function get incrementButtonFactory():Function
		{
			return this._incrementButtonFactory;
		}

		/**
		 * @private
		 */
		public function set incrementButtonFactory(value:Function):void
		{
			if(this._incrementButtonFactory == value)
			{
				return;
			}
			this._incrementButtonFactory = value;
			this.invalidate(INVALIDATION_FLAG_INCREMENT_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customIncrementButtonStyleName:String;

		/**
		 * @private
		 */
		public function get customIncrementButtonStyleName():String
		{
			return this._customIncrementButtonStyleName;
		}

		/**
		 * @private
		 */
		public function set customIncrementButtonStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customIncrementButtonStyleName === value)
			{
				return;
			}
			this._customIncrementButtonStyleName = value;
			this.invalidate(INVALIDATION_FLAG_INCREMENT_BUTTON_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _incrementButtonProperties:PropertyProxy;

		/**
		 * An object that stores properties for the scroll bar's increment
		 * button, and the properties will be passed down to the increment
		 * button when the scroll bar validates. For a list of available
		 * properties, refer to
		 * <a href="Button.html"><code>feathers.controls.BasicButton</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>incrementButtonFactory</code>
		 * function instead of using <code>incrementButtonProperties</code> will
		 * result in better performance.</p>
		 *
		 * <p>In the following example, the scroll bar's increment button properties
		 * are updated:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.incrementButtonProperties.defaultSkin = new Image( upTexture );
		 * scrollBar.incrementButtonProperties.downSkin = new Image( downTexture );</listing>
		 *
		 * @default null
		 *
		 * @see #incrementButtonFactory
		 * @see feathers.controls.BasicButton
		 */
		public function get incrementButtonProperties():Object
		{
			if(!this._incrementButtonProperties)
			{
				this._incrementButtonProperties = new PropertyProxy(incrementButtonProperties_onChange);
			}
			return this._incrementButtonProperties;
		}

		/**
		 * @private
		 */
		public function set incrementButtonProperties(value:Object):void
		{
			if(this._incrementButtonProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._incrementButtonProperties)
			{
				this._incrementButtonProperties.removeOnChangeCallback(incrementButtonProperties_onChange);
			}
			this._incrementButtonProperties = PropertyProxy(value);
			if(this._incrementButtonProperties)
			{
				this._incrementButtonProperties.addOnChangeCallback(incrementButtonProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _touchStartX:Number = NaN;

		/**
		 * @private
		 */
		protected var _touchStartY:Number = NaN;

		/**
		 * @private
		 */
		protected var _thumbStartX:Number = NaN;

		/**
		 * @private
		 */
		protected var _thumbStartY:Number = NaN;

		/**
		 * @private
		 */
		protected var _pageStartValue:Number;

		/**
		 * @private
		 */
		protected var _touchValue:Number;

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(this._value < this._minimum)
			{
				this.value = this._minimum;
			}
			else if(this._value > this._maximum)
			{
				this.value = this._maximum;
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);
			var thumbFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_THUMB_FACTORY);
			var minimumTrackFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_MINIMUM_TRACK_FACTORY);
			var maximumTrackFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_MAXIMUM_TRACK_FACTORY);
			var incrementButtonFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_INCREMENT_BUTTON_FACTORY);
			var decrementButtonFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DECREMENT_BUTTON_FACTORY);

			if(thumbFactoryInvalid)
			{
				this.createThumb();
			}
			if(minimumTrackFactoryInvalid)
			{
				this.createMinimumTrack();
			}
			if(maximumTrackFactoryInvalid || layoutInvalid)
			{
				this.createMaximumTrack();
			}
			if(decrementButtonFactoryInvalid)
			{
				this.createDecrementButton();
			}
			if(incrementButtonFactoryInvalid)
			{
				this.createIncrementButton();
			}

			if(thumbFactoryInvalid || stylesInvalid)
			{
				this.refreshThumbStyles();
			}
			if(minimumTrackFactoryInvalid || stylesInvalid)
			{
				this.refreshMinimumTrackStyles();
			}
			if((maximumTrackFactoryInvalid || stylesInvalid || layoutInvalid) && this.maximumTrack)
			{
				this.refreshMaximumTrackStyles();
			}
			if(decrementButtonFactoryInvalid || stylesInvalid)
			{
				this.refreshDecrementButtonStyles();
			}
			if(incrementButtonFactoryInvalid || stylesInvalid)
			{
				this.refreshIncrementButtonStyles();
			}

			if(dataInvalid || stateInvalid || thumbFactoryInvalid ||
				minimumTrackFactoryInvalid || maximumTrackFactoryInvalid ||
				decrementButtonFactoryInvalid || incrementButtonFactoryInvalid)
			{
				this.refreshEnabled();
			}

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			this.layout();
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			if(this._direction === Direction.VERTICAL)
			{
				return this.measureVertical();
			}
			return this.measureHorizontal();
		}

		/**
		 * @private
		 */
		protected function measureHorizontal():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}
			var isSingle:Boolean = this._trackLayoutMode === TrackLayoutMode.SINGLE;
			if(needsWidth)
			{
				this.minimumTrack.width = this._minimumTrackSkinExplicitWidth;
			}
			else if(isSingle)
			{
				this.minimumTrack.width = this._explicitWidth;
			}
			if(this.minimumTrack is IMeasureDisplayObject)
			{
				var measureMinTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.minimumTrack);
				if(needsMinWidth)
				{
					measureMinTrack.minWidth = this._minimumTrackSkinExplicitMinWidth;
				}
				else if(isSingle)
				{
					var minTrackMinWidth:Number = this._explicitMinWidth;
					if(this._minimumTrackSkinExplicitMinWidth > minTrackMinWidth)
					{
						minTrackMinWidth = this._minimumTrackSkinExplicitMinWidth;
					}
					measureMinTrack.minWidth = minTrackMinWidth;
				}
			}
			if(!isSingle)
			{
				if(needsWidth)
				{
					this.maximumTrack.width = this._maximumTrackSkinExplicitWidth;
				}
				if(this.maximumTrack is IMeasureDisplayObject)
				{
					var measureMaxTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.maximumTrack);
					if(needsMinWidth)
					{
						measureMaxTrack.minWidth = this._maximumTrackSkinExplicitMinWidth;
					}
				}
			}
			if(this.minimumTrack is IValidating)
			{
				IValidating(this.minimumTrack).validate();
			}
			if(this.maximumTrack is IValidating)
			{
				IValidating(this.maximumTrack).validate();
			}
			if(this.thumb is IValidating)
			{
				IValidating(this.thumb).validate();
			}
			if(this.decrementButton is IValidating)
			{
				IValidating(this.decrementButton).validate();
			}
			if(this.incrementButton is IValidating)
			{
				IValidating(this.incrementButton).validate();
			}
			var newWidth:Number = this._explicitWidth;
			var newHeight:Number = this._explicitHeight;
			var newMinWidth:Number = this._explicitMinWidth;
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsWidth)
			{
				newWidth = this.minimumTrack.width;
				if(!isSingle) //split
				{
					newWidth += this.maximumTrack.width;
				}
				newWidth += this.decrementButton.width + this.incrementButton.width;
			}
			if(needsHeight)
			{
				newHeight = this.minimumTrack.height;
				if(!isSingle && //split
					this.maximumTrack.height > newHeight)
				{
					newHeight = this.maximumTrack.height;
				}
				if(this.thumb.height > newHeight)
				{
					newHeight = this.thumb.height;
				}
				if(this.decrementButton.height > newHeight)
				{
					newHeight = this.decrementButton.height;
				}
				if(this.incrementButton.height > newHeight)
				{
					newHeight = this.incrementButton.height;
				}
			}
			if(needsMinWidth)
			{
				if(measureMinTrack !== null)
				{
					newMinWidth = measureMinTrack.minWidth;
				}
				else
				{
					newMinWidth = this.minimumTrack.width;
				}
				if(!isSingle) //split
				{
					if(measureMaxTrack !== null)
					{
						newMinWidth += measureMaxTrack.minWidth;
					}
					else if(this.maximumTrack.width > newMinWidth)
					{
						newMinWidth += this.maximumTrack.width;
					}
				}
				if(this.decrementButton is IMeasureDisplayObject)
				{
					newMinWidth += IMeasureDisplayObject(this.decrementButton).minWidth;
				}
				else
				{
					newMinWidth += this.decrementButton.width;
				}
				if(this.incrementButton is IMeasureDisplayObject)
				{
					newMinWidth += IMeasureDisplayObject(this.incrementButton).minWidth;
				}
				else
				{
					newMinWidth += this.incrementButton.width;
				}
			}
			if(needsMinHeight)
			{
				if(measureMinTrack !== null)
				{
					newMinHeight = measureMinTrack.minHeight;
				}
				else
				{
					newMinHeight = this.minimumTrack.height;
				}
				if(!isSingle) //split
				{
					if(measureMaxTrack !== null)
					{
						if(measureMaxTrack.minHeight > newMinHeight)
						{
							newMinHeight = measureMaxTrack.minHeight;
						}
					}
					else if(this.maximumTrack.height > newMinHeight)
					{
						newMinHeight = this.maximumTrack.height;
					}
				}
				if(this.thumb is IMeasureDisplayObject)
				{
					var measureThumb:IMeasureDisplayObject = IMeasureDisplayObject(this.thumb);
					if(measureThumb.minHeight > newMinHeight)
					{
						newMinHeight = measureThumb.minHeight;
					}
				}
				else if(this.thumb.height > newMinHeight)
				{
					newMinHeight = this.thumb.height;
				}
				if(this.decrementButton is IMeasureDisplayObject)
				{
					var measureDecrementButton:IMeasureDisplayObject = IMeasureDisplayObject(this.decrementButton);
					if(measureDecrementButton.minHeight > newMinHeight)
					{
						newMinHeight = measureDecrementButton.minHeight;
					}
				}
				else if(this.decrementButton.height > newMinHeight)
				{
					newMinHeight = this.decrementButton.height;
				}
				if(this.incrementButton is IMeasureDisplayObject)
				{
					var measureIncrementButton:IMeasureDisplayObject = IMeasureDisplayObject(this.incrementButton);
					if(measureIncrementButton.minHeight > newMinHeight)
					{
						newMinHeight = measureIncrementButton.minHeight;
					}
				}
				else if(this.incrementButton.height > newMinHeight)
				{
					newMinHeight = this.incrementButton.height;
				}
			}
			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * @private
		 */
		protected function measureVertical():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}
			var isSingle:Boolean = this._trackLayoutMode === TrackLayoutMode.SINGLE;
			if(needsHeight)
			{
				this.minimumTrack.height = this._minimumTrackSkinExplicitHeight;
			}
			else if(isSingle)
			{
				this.minimumTrack.height = this._explicitHeight;
			}
			if(this.minimumTrack is IMeasureDisplayObject)
			{
				var measureMinTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.minimumTrack);
				if(needsMinHeight)
				{
					measureMinTrack.minHeight = this._minimumTrackSkinExplicitMinHeight;
				}
				else if(isSingle)
				{
					var minTrackMinHeight:Number = this._explicitMinHeight;
					if(this._minimumTrackSkinExplicitMinHeight > minTrackMinHeight)
					{
						minTrackMinHeight = this._minimumTrackSkinExplicitMinHeight;
					}
					measureMinTrack.minHeight = minTrackMinHeight;
				}
			}
			if(!isSingle)
			{
				if(needsHeight)
				{
					this.maximumTrack.height = this._maximumTrackSkinExplicitHeight;
				}
				if(this.maximumTrack is IMeasureDisplayObject)
				{
					var measureMaxTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.maximumTrack);
					if(needsMinHeight)
					{
						measureMaxTrack.minHeight = this._maximumTrackSkinExplicitMinHeight;
					}
				}
			}
			if(this.minimumTrack is IValidating)
			{
				IValidating(this.minimumTrack).validate();
			}
			if(this.maximumTrack is IValidating)
			{
				IValidating(this.maximumTrack).validate();
			}
			if(this.thumb is IValidating)
			{
				IValidating(this.thumb).validate();
			}
			if(this.decrementButton is IValidating)
			{
				IValidating(this.decrementButton).validate();
			}
			if(this.incrementButton is IValidating)
			{
				IValidating(this.incrementButton).validate();
			}
			var newWidth:Number = this._explicitWidth;
			var newHeight:Number = this._explicitHeight;
			var newMinWidth:Number = this._explicitMinWidth;
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsWidth)
			{
				newWidth = this.minimumTrack.width;
				if(!isSingle && //split
					this.maximumTrack.width > newWidth)
				{
					newWidth = this.maximumTrack.width;
				}
				if(this.thumb.width > newWidth)
				{
					newWidth = this.thumb.width;
				}
				if(this.decrementButton.width > newWidth)
				{
					newWidth = this.decrementButton.width;
				}
				if(this.incrementButton.width > newWidth)
				{
					newWidth = this.incrementButton.width;
				}
			}
			if(needsHeight)
			{
				newHeight = this.minimumTrack.height;
				if(!isSingle) //split
				{
					newHeight += this.maximumTrack.height;
				}
				newHeight += this.decrementButton.height + this.incrementButton.height;
			}
			if(needsMinWidth)
			{
				if(measureMinTrack !== null)
				{
					newMinWidth = measureMinTrack.minWidth;
				}
				else
				{
					newMinWidth = this.minimumTrack.width;
				}
				if(!isSingle) //split
				{
					if(measureMaxTrack !== null)
					{
						if(measureMaxTrack.minWidth > newMinWidth)
						{
							newMinWidth = measureMaxTrack.minWidth;
						}
					}
					else if(this.maximumTrack.width > newMinWidth)
					{
						newMinWidth = this.maximumTrack.width;
					}
				}
				if(this.thumb is IMeasureDisplayObject)
				{
					var measureThumb:IMeasureDisplayObject = IMeasureDisplayObject(this.thumb);
					if(measureThumb.minWidth > newMinWidth)
					{
						newMinWidth = measureThumb.minWidth;
					}
				}
				else if(this.thumb.width > newMinWidth)
				{
					newMinWidth = this.thumb.width;
				}
				if(this.decrementButton is IMeasureDisplayObject)
				{
					var measureDecrementButton:IMeasureDisplayObject = IMeasureDisplayObject(this.decrementButton);
					if(measureDecrementButton.minWidth > newMinWidth)
					{
						newMinWidth = measureDecrementButton.minWidth;
					}
				}
				else if(this.decrementButton.width > newMinWidth)
				{
					newMinWidth = this.decrementButton.width;
				}
				if(this.incrementButton is IMeasureDisplayObject)
				{
					var measureIncrementButton:IMeasureDisplayObject = IMeasureDisplayObject(this.incrementButton);
					if(measureIncrementButton.minWidth > newMinWidth)
					{
						newMinWidth = measureIncrementButton.minWidth;
					}
				}
				else if(this.incrementButton.width > newMinWidth)
				{
					newMinWidth = this.incrementButton.width;
				}
			}
			if(needsMinHeight)
			{
				if(measureMinTrack !== null)
				{
					newMinHeight = measureMinTrack.minHeight;
				}
				else
				{
					newMinHeight = this.minimumTrack.height;
				}
				if(!isSingle) //split
				{
					if(measureMaxTrack !== null)
					{
						newMinHeight += measureMaxTrack.minHeight;
					}
					else
					{
						newMinHeight += this.maximumTrack.height;
					}
				}
				if(this.decrementButton is IMeasureDisplayObject)
				{
					newMinHeight += IMeasureDisplayObject(this.decrementButton).minHeight;
				}
				else
				{
					newMinHeight += this.decrementButton.height;
				}
				if(this.incrementButton is IMeasureDisplayObject)
				{
					newMinHeight += IMeasureDisplayObject(this.incrementButton).minHeight;
				}
				else
				{
					newMinHeight += this.incrementButton.height;
				}
			}
			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * Creates and adds the <code>thumb</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #thumb
		 * @see #thumbFactory
		 * @see #style:customThumbStyleName
		 */
		protected function createThumb():void
		{
			if(this.thumb)
			{
				this.thumb.removeFromParent(true);
				this.thumb = null;
			}

			var factory:Function = this._thumbFactory != null ? this._thumbFactory : defaultThumbFactory;
			var thumbStyleName:String = this._customThumbStyleName != null ? this._customThumbStyleName : this.thumbStyleName;
			var thumb:BasicButton = BasicButton(factory());
			thumb.styleNameList.add(thumbStyleName);
			thumb.keepDownStateOnRollOut = true;
			if(thumb is IFocusDisplayObject)
			{
				thumb.isFocusEnabled = false;
			}
			thumb.addEventListener(TouchEvent.TOUCH, thumb_touchHandler);
			this.addChild(thumb);
			this.thumb = thumb;
		}

		/**
		 * Creates and adds the <code>minimumTrack</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #minimumTrack
		 * @see #minimumTrackFactory
		 * @see #style:customMinimumTrackStyleName
		 */
		protected function createMinimumTrack():void
		{
			if(this.minimumTrack)
			{
				this.minimumTrack.removeFromParent(true);
				this.minimumTrack = null;
			}

			var factory:Function = this._minimumTrackFactory != null ? this._minimumTrackFactory : defaultMinimumTrackFactory;
			var minimumTrackStyleName:String = this._customMinimumTrackStyleName != null ? this._customMinimumTrackStyleName : this.minimumTrackStyleName;
			var minimumTrack:BasicButton = BasicButton(factory());
			minimumTrack.styleNameList.add(minimumTrackStyleName);
			minimumTrack.keepDownStateOnRollOut = true;
			if(minimumTrack is IFocusDisplayObject)
			{
				minimumTrack.isFocusEnabled = false;
			}
			minimumTrack.addEventListener(TouchEvent.TOUCH, track_touchHandler);
			this.addChildAt(minimumTrack, 0);
			this.minimumTrack = minimumTrack;

			if(this.minimumTrack is IFeathersControl)
			{
				IFeathersControl(this.minimumTrack).initializeNow();
			}
			if(this.minimumTrack is IMeasureDisplayObject)
			{
				var measureMinTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.minimumTrack);
				this._minimumTrackSkinExplicitWidth = measureMinTrack.explicitWidth;
				this._minimumTrackSkinExplicitHeight = measureMinTrack.explicitHeight;
				this._minimumTrackSkinExplicitMinWidth = measureMinTrack.explicitMinWidth;
				this._minimumTrackSkinExplicitMinHeight = measureMinTrack.explicitMinHeight;
			}
			else
			{
				//this is a regular display object, and we'll treat its
				//measurements as explicit when we auto-size the scroll bar
				this._minimumTrackSkinExplicitWidth = this.minimumTrack.width;
				this._minimumTrackSkinExplicitHeight = this.minimumTrack.height;
				this._minimumTrackSkinExplicitMinWidth = this._minimumTrackSkinExplicitWidth;
				this._minimumTrackSkinExplicitMinHeight = this._minimumTrackSkinExplicitHeight;
			}
		}

		/**
		 * Creates and adds the <code>maximumTrack</code> sub-component and
		 * removes the old instance, if one exists. If the maximum track is not
		 * needed, it will not be created.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #maximumTrack
		 * @see #maximumTrackFactory
		 * @see #style:customMaximumTrackStyleName
		 */
		protected function createMaximumTrack():void
		{
			if(this.maximumTrack)
			{
				this.maximumTrack.removeFromParent(true);
				this.maximumTrack = null;
			}
			if(this._trackLayoutMode !== TrackLayoutMode.SPLIT)
			{
				return;
			}
			var factory:Function = this._maximumTrackFactory != null ? this._maximumTrackFactory : defaultMaximumTrackFactory;
			var maximumTrackStyleName:String = this._customMaximumTrackStyleName != null ? this._customMaximumTrackStyleName : this.maximumTrackStyleName;
			var maximumTrack:BasicButton = BasicButton(factory());
			maximumTrack.styleNameList.add(maximumTrackStyleName);
			maximumTrack.keepDownStateOnRollOut = true;
			if(maximumTrack is IFocusDisplayObject)
			{
				maximumTrack.isFocusEnabled = false;
			}
			maximumTrack.addEventListener(TouchEvent.TOUCH, track_touchHandler);
			this.addChildAt(maximumTrack, 1);
			this.maximumTrack = maximumTrack;

			if(this.maximumTrack is IFeathersControl)
			{
				IFeathersControl(this.maximumTrack).initializeNow();
			}
			if(this.maximumTrack is IMeasureDisplayObject)
			{
				var measureMaxTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.maximumTrack);
				this._maximumTrackSkinExplicitWidth = measureMaxTrack.explicitWidth;
				this._maximumTrackSkinExplicitHeight = measureMaxTrack.explicitHeight;
				this._maximumTrackSkinExplicitMinWidth = measureMaxTrack.explicitMinWidth;
				this._maximumTrackSkinExplicitMinHeight = measureMaxTrack.explicitMinHeight;
			}
			else
			{
				//this is a regular display object, and we'll treat its
				//measurements as explicit when we auto-size the scroll bar
				this._maximumTrackSkinExplicitWidth = this.maximumTrack.width;
				this._maximumTrackSkinExplicitHeight = this.maximumTrack.height;
				this._maximumTrackSkinExplicitMinWidth = this._maximumTrackSkinExplicitWidth;
				this._maximumTrackSkinExplicitMinHeight = this._maximumTrackSkinExplicitHeight;
			}
		}

		/**
		 * Creates and adds the <code>decrementButton</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #decrementButton
		 * @see #decrementButtonFactory
		 * @see #style:customDecremenButtonStyleName
		 */
		protected function createDecrementButton():void
		{
			if(this.decrementButton)
			{
				this.decrementButton.removeFromParent(true);
				this.decrementButton = null;
			}

			var factory:Function = this._decrementButtonFactory != null ? this._decrementButtonFactory : defaultDecrementButtonFactory;
			var decrementButtonStyleName:String = this._customDecrementButtonStyleName != null ? this._customDecrementButtonStyleName : this.decrementButtonStyleName;
			this.decrementButton = BasicButton(factory());
			this.decrementButton.styleNameList.add(decrementButtonStyleName);
			this.decrementButton.keepDownStateOnRollOut = true;
			if(this.decrementButton is IFocusDisplayObject)
			{
				this.decrementButton.isFocusEnabled = false;
			}
			this.decrementButton.addEventListener(TouchEvent.TOUCH, decrementButton_touchHandler);
			this.addChild(this.decrementButton);
		}

		/**
		 * Creates and adds the <code>incrementButton</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #incrementButton
		 * @see #incrementButtonFactory
		 * @see #style:customIncrementButtonStyleName
		 */
		protected function createIncrementButton():void
		{
			if(this.incrementButton)
			{
				this.incrementButton.removeFromParent(true);
				this.incrementButton = null;
			}

			var factory:Function = this._incrementButtonFactory != null ? this._incrementButtonFactory : defaultIncrementButtonFactory;
			var incrementButtonStyleName:String = this._customIncrementButtonStyleName != null ? this._customIncrementButtonStyleName : this.incrementButtonStyleName;
			this.incrementButton = BasicButton(factory());
			this.incrementButton.styleNameList.add(incrementButtonStyleName);
			this.incrementButton.keepDownStateOnRollOut = true;
			if(this.incrementButton is IFocusDisplayObject)
			{
				this.incrementButton.isFocusEnabled = false;
			}
			this.incrementButton.addEventListener(TouchEvent.TOUCH, incrementButton_touchHandler);
			this.addChild(this.incrementButton);
		}

		/**
		 * @private
		 */
		protected function refreshThumbStyles():void
		{
			for(var propertyName:String in this._thumbProperties)
			{
				var propertyValue:Object = this._thumbProperties[propertyName];
				this.thumb[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function refreshMinimumTrackStyles():void
		{
			for(var propertyName:String in this._minimumTrackProperties)
			{
				var propertyValue:Object = this._minimumTrackProperties[propertyName];
				this.minimumTrack[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function refreshMaximumTrackStyles():void
		{
			if(!this.maximumTrack)
			{
				return;
			}
			for(var propertyName:String in this._maximumTrackProperties)
			{
				var propertyValue:Object = this._maximumTrackProperties[propertyName];
				this.maximumTrack[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function refreshDecrementButtonStyles():void
		{
			for(var propertyName:String in this._decrementButtonProperties)
			{
				var propertyValue:Object = this._decrementButtonProperties[propertyName];
				this.decrementButton[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function refreshIncrementButtonStyles():void
		{
			for(var propertyName:String in this._incrementButtonProperties)
			{
				var propertyValue:Object = this._incrementButtonProperties[propertyName];
				this.incrementButton[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function refreshEnabled():void
		{
			var isEnabled:Boolean = this._isEnabled && this._maximum > this._minimum;
			if(this.thumb is IFeathersControl)
			{
				IFeathersControl(this.thumb).isEnabled = isEnabled;
			}
			if(this.minimumTrack is IFeathersControl)
			{
				IFeathersControl(this.minimumTrack).isEnabled = isEnabled;
			}
			if(this.maximumTrack is IFeathersControl)
			{
				IFeathersControl(this.maximumTrack).isEnabled = isEnabled;
			}
			this.decrementButton.isEnabled = isEnabled;
			this.incrementButton.isEnabled = isEnabled;
		}

		/**
		 * @private
		 */
		protected function layout():void
		{
			this.layoutStepButtons();
			this.layoutThumb();

			if(this._trackLayoutMode == TrackLayoutMode.SPLIT)
			{
				this.layoutTrackWithMinMax();
			}
			else //single
			{
				this.layoutTrackWithSingle();
			}
		}

		/**
		 * @private
		 */
		protected function layoutStepButtons():void
		{
			if(this._direction == Direction.VERTICAL)
			{
				this.decrementButton.x = (this.actualWidth - this.decrementButton.width) / 2;
				this.decrementButton.y = 0;
				this.incrementButton.x = (this.actualWidth - this.incrementButton.width) / 2;
				this.incrementButton.y = this.actualHeight - this.incrementButton.height;
			}
			else
			{
				this.decrementButton.x = 0;
				this.decrementButton.y = (this.actualHeight - this.decrementButton.height) / 2;
				this.incrementButton.x = this.actualWidth - this.incrementButton.width;
				this.incrementButton.y = (this.actualHeight - this.incrementButton.height) / 2;
			}
			var showButtons:Boolean = this._maximum != this._minimum;
			this.decrementButton.visible = showButtons;
			this.incrementButton.visible = showButtons;
		}

		/**
		 * @private
		 */
		protected function layoutThumb():void
		{
			var range:Number = this._maximum - this._minimum;
			this.thumb.visible = range > 0 && range < Number.POSITIVE_INFINITY && this._isEnabled;
			if(!this.thumb.visible)
			{
				return;
			}

			//this will auto-size the thumb, if needed
			if(this.thumb is IValidating)
			{
				IValidating(this.thumb).validate();
			}

			var contentWidth:Number = this.actualWidth - this._paddingLeft - this._paddingRight;
			var contentHeight:Number = this.actualHeight - this._paddingTop - this._paddingBottom;
			var adjustedPage:Number = this._page;
			if(this._page == 0)
			{
				adjustedPage = this._step;
			}
			if(adjustedPage > range)
			{
				adjustedPage = range;
			}
			if(this._direction == Direction.VERTICAL)
			{
				contentHeight -= (this.decrementButton.height + this.incrementButton.height);
				var thumbMinHeight:Number = this.thumbOriginalHeight;
				if(this.thumb is IMeasureDisplayObject)
				{
					thumbMinHeight = IMeasureDisplayObject(this.thumb).minHeight;
				}
				this.thumb.width = this.thumbOriginalWidth;
				if(this._fixedThumbSize)
				{
					this.thumb.height = this.thumbOriginalHeight;
				}
				else
				{
					this.thumb.height = Math.max(thumbMinHeight, contentHeight * adjustedPage / range);
				}
				var trackScrollableHeight:Number = contentHeight - this.thumb.height;
				this.thumb.x = this._paddingLeft + (this.actualWidth - this._paddingLeft - this._paddingRight - this.thumb.width) / 2;
				this.thumb.y = this.decrementButton.height + this._paddingTop + Math.max(0, Math.min(trackScrollableHeight, trackScrollableHeight * (this._value - this._minimum) / range));
			}
			else //horizontal
			{
				contentWidth -= (this.decrementButton.width + this.decrementButton.width);
				var thumbMinWidth:Number = this.thumbOriginalWidth;
				if(this.thumb is IMeasureDisplayObject)
				{
					thumbMinWidth = IMeasureDisplayObject(this.thumb).minWidth;
				}
				if(this._fixedThumbSize)
				{
					this.thumb.width = this.thumbOriginalWidth;
				}
				else
				{
					this.thumb.width = Math.max(thumbMinWidth, contentWidth * adjustedPage / range);
				}
				this.thumb.height = this.thumbOriginalHeight;
				var trackScrollableWidth:Number = contentWidth - this.thumb.width;
				this.thumb.x = this.decrementButton.width + this._paddingLeft + Math.max(0, Math.min(trackScrollableWidth, trackScrollableWidth * (this._value - this._minimum) / range));
				this.thumb.y = this._paddingTop + (this.actualHeight - this._paddingTop - this._paddingBottom - this.thumb.height) / 2;
			}
		}

		/**
		 * @private
		 */
		protected function layoutTrackWithMinMax():void
		{
			var range:Number = this._maximum - this._minimum;
			this.minimumTrack.touchable = range > 0 && range < Number.POSITIVE_INFINITY;
			if(this.maximumTrack)
			{
				this.maximumTrack.touchable = range > 0 && range < Number.POSITIVE_INFINITY;
			}

			var showButtons:Boolean = this._maximum != this._minimum;
			if(this._direction === Direction.VERTICAL)
			{
				this.minimumTrack.x = 0;
				if(showButtons)
				{
					this.minimumTrack.y = this.decrementButton.height;
				}
				else
				{
					this.minimumTrack.y = 0;
				}
				this.minimumTrack.width = this.actualWidth;
				this.minimumTrack.height = (this.thumb.y + this.thumb.height / 2) - this.minimumTrack.y;

				this.maximumTrack.x = 0;
				this.maximumTrack.y = this.minimumTrack.y + this.minimumTrack.height;
				this.maximumTrack.width = this.actualWidth;
				if(showButtons)
				{
					this.maximumTrack.height = this.actualHeight - this.incrementButton.height - this.maximumTrack.y;
				}
				else
				{
					this.maximumTrack.height = this.actualHeight - this.maximumTrack.y;
				}
			}
			else //horizontal
			{
				if(showButtons)
				{
					this.minimumTrack.x = this.decrementButton.width;
				}
				else
				{
					this.minimumTrack.x = 0;
				}
				this.minimumTrack.y = 0;
				this.minimumTrack.width = (this.thumb.x + this.thumb.width / 2) - this.minimumTrack.x;
				this.minimumTrack.height = this.actualHeight;

				this.maximumTrack.x = this.minimumTrack.x + this.minimumTrack.width;
				this.maximumTrack.y = 0;
				if(showButtons)
				{
					this.maximumTrack.width = this.actualWidth - this.incrementButton.width - this.maximumTrack.x;
				}
				else
				{
					this.maximumTrack.width = this.actualWidth - this.maximumTrack.x;
				}
				this.maximumTrack.height = this.actualHeight;
			}

			//final validation to avoid juggler next frame issues
			if(this.minimumTrack is IValidating)
			{
				IValidating(this.minimumTrack).validate();
			}
			if(this.maximumTrack is IValidating)
			{
				IValidating(this.maximumTrack).validate();
			}
		}

		/**
		 * @private
		 */
		protected function layoutTrackWithSingle():void
		{
			var range:Number = this._maximum - this._minimum;
			this.minimumTrack.touchable = range > 0 && range < Number.POSITIVE_INFINITY;

			var showButtons:Boolean = this._maximum != this._minimum;
			if(this._direction === Direction.VERTICAL)
			{
				this.minimumTrack.x = 0;
				if(showButtons)
				{
					this.minimumTrack.y = this.decrementButton.height;
				}
				else
				{
					this.minimumTrack.y = 0;
				}
				this.minimumTrack.width = this.actualWidth;
				if(showButtons)
				{
					this.minimumTrack.height = this.actualHeight - this.minimumTrack.y - this.incrementButton.height;
				}
				else
				{
					this.minimumTrack.height = this.actualHeight - this.minimumTrack.y;
				}
			}
			else //horizontal
			{
				if(showButtons)
				{
					this.minimumTrack.x = this.decrementButton.width;
				}
				else
				{
					this.minimumTrack.x = 0;
				}
				this.minimumTrack.y = 0;
				if(showButtons)
				{
					this.minimumTrack.width = this.actualWidth - this.minimumTrack.x - this.incrementButton.width;
				}
				else
				{
					this.minimumTrack.width = this.actualWidth - this.minimumTrack.x;
				}
				this.minimumTrack.height = this.actualHeight;
			}

			//final validation to avoid juggler next frame issues
			if(this.minimumTrack is IValidating)
			{
				IValidating(this.minimumTrack).validate();
			}
		}

		/**
		 * @private
		 */
		protected function locationToValue(location:Point):Number
		{
			var percentage:Number = 0;
			if(this._direction == Direction.VERTICAL)
			{
				var trackScrollableHeight:Number = this.actualHeight - this.thumb.height - this.decrementButton.height - this.incrementButton.height - this._paddingTop - this._paddingBottom;
				if(trackScrollableHeight > 0)
				{
					var yOffset:Number = location.y - this._touchStartY - this._paddingTop;
					var yPosition:Number = Math.min(Math.max(0, this._thumbStartY + yOffset - this.decrementButton.height), trackScrollableHeight);
					percentage = yPosition / trackScrollableHeight;
				}
			}
			else //horizontal
			{
				var trackScrollableWidth:Number = this.actualWidth - this.thumb.width - this.decrementButton.width - this.incrementButton.width - this._paddingLeft - this._paddingRight;
				if(trackScrollableWidth > 0)
				{
					var xOffset:Number = location.x - this._touchStartX - this._paddingLeft;
					var xPosition:Number = Math.min(Math.max(0, this._thumbStartX + xOffset - this.decrementButton.width), trackScrollableWidth);
					percentage = xPosition / trackScrollableWidth;
				}
			}

			return this._minimum + percentage * (this._maximum - this._minimum);
		}

		/**
		 * @private
		 */
		protected function decrement():void
		{
			this.value -= this._step;
		}

		/**
		 * @private
		 */
		protected function increment():void
		{
			this.value += this._step;
		}

		/**
		 * @private
		 */
		protected function adjustPage():void
		{
			var range:Number = this._maximum - this._minimum;
			var adjustedPage:Number = this._page;
			if(this._page == 0)
			{
				adjustedPage = this._step;
			}
			if(adjustedPage > range)
			{
				adjustedPage = range;
			}
			if(this._touchValue < this._pageStartValue)
			{
				var newValue:Number = Math.max(this._touchValue, this._value - adjustedPage);
				if(this._step != 0 && newValue != this._maximum && newValue != this._minimum)
				{
					newValue = roundDownToNearest(newValue, this._step);
				}
				this.value = newValue;
			}
			else if(this._touchValue > this._pageStartValue)
			{
				newValue = Math.min(this._touchValue, this._value + adjustedPage);
				if(this._step != 0 && newValue != this._maximum && newValue != this._minimum)
				{
					newValue = roundUpToNearest(newValue, this._step);
				}
				this.value = newValue;
			}
		}

		/**
		 * @private
		 */
		protected function startRepeatTimer(action:Function):void
		{
			this.currentRepeatAction = action;
			if(this._repeatDelay > 0)
			{
				if(!this._repeatTimer)
				{
					this._repeatTimer = new Timer(this._repeatDelay * 1000);
					this._repeatTimer.addEventListener(TimerEvent.TIMER, repeatTimer_timerHandler);
				}
				else
				{
					this._repeatTimer.reset();
					this._repeatTimer.delay = this._repeatDelay * 1000;
				}
				this._repeatTimer.start();
			}
		}

		/**
		 * @private
		 */
		protected function thumbProperties_onChange(proxy:PropertyProxy, name:Object):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function minimumTrackProperties_onChange(proxy:PropertyProxy, name:Object):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function maximumTrackProperties_onChange(proxy:PropertyProxy, name:Object):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function decrementButtonProperties_onChange(proxy:PropertyProxy, name:Object):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function incrementButtonProperties_onChange(proxy:PropertyProxy, name:Object):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function removedFromStageHandler(event:Event):void
		{
			this._touchPointID = -1;
			if(this._repeatTimer)
			{
				this._repeatTimer.stop();
			}
		}

		/**
		 * @private
		 */
		protected function track_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._touchPointID = -1;
				return;
			}

			var track:DisplayObject = DisplayObject(event.currentTarget);
			if(this._touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(track, null, this._touchPointID);
				if(touch === null)
				{
					return;
				}
				if(touch.phase === TouchPhase.MOVED)
				{
					var location:Point = touch.getLocation(this, Pool.getPoint());
					this._touchValue = this.locationToValue(location);
					Pool.putPoint(location);
				}
				else if(touch.phase === TouchPhase.ENDED)
				{
					this._touchPointID = -1;
					this._repeatTimer.stop();
					this.dispatchEventWith(FeathersEventType.END_INTERACTION);
				}
			}
			else
			{
				touch = event.getTouch(track, TouchPhase.BEGAN);
				if(touch === null)
				{
					return;
				}
				this._touchPointID = touch.id;
				this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
				location = touch.getLocation(this, Pool.getPoint());
				this._touchStartX = location.x;
				this._touchStartY = location.y;
				this._thumbStartX = this._touchStartX;
				this._thumbStartY = this._touchStartY;
				this._touchValue = this.locationToValue(location);
				Pool.putPoint(location);
				this._pageStartValue = this._value;
				this.adjustPage();
				this.startRepeatTimer(this.adjustPage);
			}
		}

		/**
		 * @private
		 */
		protected function thumb_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._touchPointID = -1;
				return;
			}

			if(this._touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this.thumb, null, this._touchPointID);
				if(touch === null)
				{
					return;
				}
				if(touch.phase === TouchPhase.MOVED)
				{
					var location:Point = touch.getLocation(this, Pool.getPoint());
					var newValue:Number = this.locationToValue(location);
					Pool.putPoint(location);
					if(this._step != 0 && newValue != this._maximum && newValue != this._minimum)
					{
						newValue = roundToNearest(newValue, this._step);
					}
					this.value = newValue;
				}
				else if(touch.phase === TouchPhase.ENDED)
				{
					this._touchPointID = -1;
					this.isDragging = false;
					if(!this.liveDragging)
					{
						this.dispatchEventWith(Event.CHANGE);
					}
					this.dispatchEventWith(FeathersEventType.END_INTERACTION);
				}
			}
			else
			{
				touch = event.getTouch(this.thumb, TouchPhase.BEGAN);
				if(touch === null)
				{
					return;
				}
				location = touch.getLocation(this, Pool.getPoint());
				this._touchPointID = touch.id;
				this._thumbStartX = this.thumb.x;
				this._thumbStartY = this.thumb.y;
				this._touchStartX = location.x;
				this._touchStartY = location.y;
				Pool.putPoint(location);
				this.isDragging = true;
				this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
			}
		}

		/**
		 * @private
		 */
		protected function decrementButton_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._touchPointID = -1;
				return;
			}

			if(this._touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this.decrementButton, TouchPhase.ENDED, this._touchPointID);
				if(touch === null)
				{
					return;
				}
				this._touchPointID = -1;
				this._repeatTimer.stop();
				this.dispatchEventWith(FeathersEventType.END_INTERACTION);
			}
			else //if we get here, we don't have a saved touch ID yet
			{
				touch = event.getTouch(this.decrementButton, TouchPhase.BEGAN);
				if(touch === null)
				{
					return;
				}
				this._touchPointID = touch.id;
				this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
				this.decrement();
				this.startRepeatTimer(this.decrement);
			}
		}

		/**
		 * @private
		 */
		protected function incrementButton_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._touchPointID = -1;
				return;
			}

			if(this._touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this.incrementButton, TouchPhase.ENDED, this._touchPointID);
				if(touch === null)
				{
					return;
				}
				this._touchPointID = -1;
				this._repeatTimer.stop();
				this.dispatchEventWith(FeathersEventType.END_INTERACTION);
			}
			else //if we get here, we don't have a saved touch ID yet
			{
				touch = event.getTouch(this.incrementButton, TouchPhase.BEGAN);
				if(touch === null)
				{
					return;
				}
				this._touchPointID = touch.id;
				this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
				this.increment();
				this.startRepeatTimer(this.increment);
			}
		}

		/**
		 * @private
		 */
		protected function repeatTimer_timerHandler(event:TimerEvent):void
		{
			if(this._repeatTimer.currentCount < 5)
			{
				return;
			}
			this.currentRepeatAction();
		}
	}
}


================================================
FILE: source/feathers/controls/ScrollBarDisplayMode.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * Constants that define how scroll bars are displayed in a container.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class ScrollBarDisplayMode
	{
		/**
		 * The scroll bars appear above the scroller's view port, overlapping
		 * the content, and they fade out when not in use.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const FLOAT:String = "float";

		/**
		 * The scroll bars are always visible and appear next to the scroller's
		 * view port, making the view port smaller than the scroller.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const FIXED:String = "fixed";

		/**
		 * The scroll bars appear above the scroller's view port, overlapping
		 * the content, but they do not fade out when not in use.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const FIXED_FLOAT:String = "fixedFloat";

		/**
		 * The scroll bars are never visible.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const NONE:String = "none";
	}
}


================================================
FILE: source/feathers/controls/ScrollContainer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.supportClasses.LayoutViewPort;
	import feathers.core.IFeathersControl;
	import feathers.core.IFocusContainer;
	import feathers.events.FeathersEventType;
	import feathers.layout.ILayout;
	import feathers.layout.ILayoutDisplayObject;
	import feathers.layout.IVirtualLayout;
	import feathers.skins.IStyleProvider;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.events.Event;

	/**
	 * Controls the way that the container's children are positioned and
	 * sized.
	 *
	 * <p>The following example tells the container to use a horizontal layout:</p>
	 *
	 * <listing version="3.0">
	 * var layout:HorizontalLayout = new HorizontalLayout();
	 * layout.gap = 20;
	 * layout.padding = 20;
	 * container.layout = layout;</listing>
	 *
	 * @default null
	 */
	[Style(name="layout",type="feathers.layout.ILayout")]

	/**
	 * A generic container that supports layout, scrolling, and a background
	 * skin. For a lighter container, see <code>LayoutGroup</code>, which
	 * focuses specifically on layout without scrolling.
	 *
	 * <p>The following example creates a scroll container with a horizontal
	 * layout and adds two buttons to it:</p>
	 *
	 * <listing version="3.0">
	 * var container:ScrollContainer = new ScrollContainer();
	 * var layout:HorizontalLayout = new HorizontalLayout();
	 * layout.gap = 20;
	 * layout.padding = 20;
	 * container.layout = layout;
	 * this.addChild( container );
	 * 
	 * var yesButton:Button = new Button();
	 * yesButton.label = "Yes";
	 * container.addChild( yesButton );
	 * 
	 * var noButton:Button = new Button();
	 * noButton.label = "No";
	 * container.addChild( noButton );</listing>
	 *
	 * @see ../../../help/scroll-container.html How to use the Feathers ScrollContainer component
	 * @see feathers.controls.LayoutGroup
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class ScrollContainer extends Scroller implements IScrollContainer, IFocusContainer
	{
		/**
		 * An alternate style name to use with <code>ScrollContainer</code> to
		 * allow a theme to give it a toolbar style. If a theme does not provide
		 * a style for the toolbar container, the theme will automatically fall
		 * back to using the default scroll container skin.
		 *
		 * <p>An alternate style name should always be added to a component's
		 * <code>styleNameList</code> before the component is initialized. If
		 * the style name is added later, it will be ignored.</p>
		 *
		 * <p>In the following example, the toolbar style is applied to a scroll
		 * container:</p>
		 *
		 * <listing version="3.0">
		 * var container:ScrollContainer = new ScrollContainer();
		 * container.styleNameList.add( ScrollContainer.ALTERNATE_STYLE_NAME_TOOLBAR );
		 * this.addChild( container );</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_TOOLBAR:String = "feathers-toolbar-scroll-container";

		/**
		 * The default <code>IStyleProvider</code> for all <code>ScrollContainer</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function ScrollContainer()
		{
			super();
			this.layoutViewPort = new LayoutViewPort();
			this.viewPort = this.layoutViewPort;
			this.addEventListener(Event.ADDED_TO_STAGE, scrollContainer_addedToStageHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, scrollContainer_removedFromStageHandler);
		}

		/**
		 * A flag that indicates if the display list functions like <code>addChild()</code>
		 * and <code>removeChild()</code> will be passed to the internal view
		 * port.
		 */
		protected var displayListBypassEnabled:Boolean = true;

		/**
		 * @private
		 */
		protected var layoutViewPort:LayoutViewPort;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return ScrollContainer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _isChildFocusEnabled:Boolean = true;

		/**
		 * @copy feathers.core.IFocusContainer#isChildFocusEnabled
		 *
		 * @default true
		 *
		 * @see #isFocusEnabled
		 */
		public function get isChildFocusEnabled():Boolean
		{
			return this._isEnabled && this._isChildFocusEnabled;
		}

		/**
		 * @private
		 */
		public function set isChildFocusEnabled(value:Boolean):void
		{
			this._isChildFocusEnabled = value;
		}

		/**
		 * @private
		 */
		protected var _layout:ILayout;

		/**
		 * @private
		 */
		public function get layout():ILayout
		{
			return this._layout;
		}

		/**
		 * @private
		 */
		public function set layout(value:ILayout):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._layout === value)
			{
				return;
			}
			this._layout = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _autoSizeMode:String = AutoSizeMode.CONTENT;

		[Inspectable(type="String",enumeration="stage,content")]
		/**
		 * Determines how the container will set its own size when its
		 * dimensions (width and height) aren't set explicitly.
		 *
		 * <p>In the following example, the container will be sized to
		 * match the stage:</p>
		 *
		 * <listing version="3.0">
		 * container.autoSizeMode = AutoSizeMode.STAGE;</listing>
		 *
		 * <p>Usually defaults to <code>AutoSizeMode.CONTENT</code>. However, if
		 * this component is the root of the Starling display list, defaults to
		 * <code>AutoSizeMode.STAGE</code> instead.</p>
		 *
		 * @see feathers.controls.AutoSizeMode#STAGE
		 * @see feathers.controls.AutoSizeMode#CONTENT
		 */
		public function get autoSizeMode():String
		{
			return this._autoSizeMode;
		}

		/**
		 * @private
		 */
		public function set autoSizeMode(value:String):void
		{
			if(this._autoSizeMode == value)
			{
				return;
			}
			this._autoSizeMode = value;
			this._measureViewPort = this._autoSizeMode != AutoSizeMode.STAGE;
			if(this.stage !== null)
			{
				if(this._autoSizeMode === AutoSizeMode.STAGE)
				{
					this.stage.addEventListener(Event.RESIZE, scrollContainer_stage_resizeHandler);
				}
				else
				{
					this.stage.removeEventListener(Event.RESIZE, scrollContainer_stage_resizeHandler);
				}
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _ignoreChildChanges:Boolean = false;

		/**
		 * @private
		 * This is similar to _ignoreChildChanges, but setInvalidationFlag()
		 * may still be called.
		 */
		protected var _ignoreChildChangesButSetFlags:Boolean = false;

		/**
		 * @private
		 */
		override public function get numChildren():int
		{
			if(!this.displayListBypassEnabled)
			{
				return super.numChildren;
			}
			return DisplayObjectContainer(this.viewPort).numChildren;
		}

		/**
		 * @inheritDoc
		 */
		public function get numRawChildren():int
		{
			var oldBypass:Boolean = this.displayListBypassEnabled;
			this.displayListBypassEnabled = false;
			var result:int = super.numChildren;
			this.displayListBypassEnabled = oldBypass;
			return result;
		}

		/**
		 * @private
		 */
		override public function getChildByName(name:String):DisplayObject
		{
			if(!this.displayListBypassEnabled)
			{
				return super.getChildByName(name);
			}
			return DisplayObjectContainer(this.viewPort).getChildByName(name);
		}

		/**
		 * @inheritDoc
		 */
		public function getRawChildByName(name:String):DisplayObject
		{
			var oldBypass:Boolean = this.displayListBypassEnabled;
			this.displayListBypassEnabled = false;
			var child:DisplayObject = super.getChildByName(name);
			this.displayListBypassEnabled = oldBypass;
			return child;
		}

		/**
		 * @private
		 */
		override public function getChildAt(index:int):DisplayObject
		{
			if(!this.displayListBypassEnabled)
			{
				return super.getChildAt(index);
			}
			return DisplayObjectContainer(this.viewPort).getChildAt(index);
		}

		/**
		 * @inheritDoc
		 */
		public function getRawChildAt(index:int):DisplayObject
		{
			var oldBypass:Boolean = this.displayListBypassEnabled;
			this.displayListBypassEnabled = false;
			var child:DisplayObject = super.getChildAt(index);
			this.displayListBypassEnabled = oldBypass;
			return child;
		}

		/**
		 * @inheritDoc
		 */
		public function addRawChild(child:DisplayObject):DisplayObject
		{
			var oldBypass:Boolean = this.displayListBypassEnabled;
			this.displayListBypassEnabled = false;
			if(child.parent == this)
			{
				super.setChildIndex(child, super.numChildren);
			}
			else
			{
				child = super.addChildAt(child, super.numChildren);
			}
			this.displayListBypassEnabled = oldBypass;
			return child;
		}

		/**
		 * @private
		 */
		override public function addChild(child:DisplayObject):DisplayObject
		{
			return this.addChildAt(child, this.numChildren);
		}

		/**
		 * @private
		 */
		override public function addChildAt(child:DisplayObject, index:int):DisplayObject
		{
			if(!this.displayListBypassEnabled)
			{
				return super.addChildAt(child, index);
			}
			var result:DisplayObject = DisplayObjectContainer(this.viewPort).addChildAt(child, index);
			if(result is IFeathersControl)
			{
				result.addEventListener(Event.RESIZE, child_resizeHandler);
			}
			if(result is ILayoutDisplayObject)
			{
				result.addEventListener(FeathersEventType.LAYOUT_DATA_CHANGE, child_layoutDataChangeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function addRawChildAt(child:DisplayObject, index:int):DisplayObject
		{
			var oldBypass:Boolean = this.displayListBypassEnabled;
			this.displayListBypassEnabled = false;
			child = super.addChildAt(child, index);
			this.displayListBypassEnabled = oldBypass;
			return child;
		}

		/**
		 * @inheritDoc
		 */
		public function removeRawChild(child:DisplayObject, dispose:Boolean = false):DisplayObject
		{
			var oldBypass:Boolean = this.displayListBypassEnabled;
			this.displayListBypassEnabled = false;
			var index:int = super.getChildIndex(child);
			if(index >= 0)
			{
				super.removeChildAt(index, dispose);
			}
			this.displayListBypassEnabled = oldBypass;
			return child;
		}

		/**
		 * @private
		 */
		override public function removeChildAt(index:int, dispose:Boolean = false):DisplayObject
		{
			if(!this.displayListBypassEnabled)
			{
				return super.removeChildAt(index, dispose);
			}
			var result:DisplayObject = DisplayObjectContainer(this.viewPort).removeChildAt(index, dispose);
			if(result is IFeathersControl)
			{
				result.removeEventListener(Event.RESIZE, child_resizeHandler);
			}
			if(result is ILayoutDisplayObject)
			{
				result.removeEventListener(FeathersEventType.LAYOUT_DATA_CHANGE, child_layoutDataChangeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function removeRawChildAt(index:int, dispose:Boolean = false):DisplayObject
		{
			var oldBypass:Boolean = this.displayListBypassEnabled;
			this.displayListBypassEnabled = false;
			var child:DisplayObject = super.removeChildAt(index, dispose);
			this.displayListBypassEnabled = oldBypass;
			return child;
		}

		/**
		 * @private
		 */
		override public function getChildIndex(child:DisplayObject):int
		{
			if(!this.displayListBypassEnabled)
			{
				return super.getChildIndex(child);
			}
			return DisplayObjectContainer(this.viewPort).getChildIndex(child);
		}

		/**
		 * @inheritDoc
		 */
		public function getRawChildIndex(child:DisplayObject):int
		{
			var oldBypass:Boolean = this.displayListBypassEnabled;
			this.displayListBypassEnabled = false;
			var index:int = super.getChildIndex(child);
			this.displayListBypassEnabled = oldBypass;
			return index;
		}

		/**
		 * @private
		 */
		override public function setChildIndex(child:DisplayObject, index:int):void
		{
			if(!this.displayListBypassEnabled)
			{
				super.setChildIndex(child, index);
				return;
			}
			DisplayObjectContainer(this.viewPort).setChildIndex(child, index);
		}

		/**
		 * @inheritDoc
		 */
		public function setRawChildIndex(child:DisplayObject, index:int):void
		{
			var oldBypass:Boolean = this.displayListBypassEnabled;
			this.displayListBypassEnabled = false;
			super.setChildIndex(child, index);
			this.displayListBypassEnabled = oldBypass;
		}

		/**
		 * @inheritDoc
		 */
		public function swapRawChildren(child1:DisplayObject, child2:DisplayObject):void
		{
			var index1:int = this.getRawChildIndex(child1);
			var index2:int = this.getRawChildIndex(child2);
			if(index1 < 0 || index2 < 0)
			{
				throw new ArgumentError("Not a child of this container");
			}
			var oldBypass:Boolean = this.displayListBypassEnabled;
			this.displayListBypassEnabled = false;
			this.swapRawChildrenAt(index1, index2);
			this.displayListBypassEnabled = oldBypass;
		}

		/**
		 * @private
		 */
		override public function swapChildrenAt(index1:int, index2:int):void
		{
			if(!this.displayListBypassEnabled)
			{
				super.swapChildrenAt(index1, index2);
				return;
			}
			DisplayObjectContainer(this.viewPort).swapChildrenAt(index1, index2);
		}

		/**
		 * @inheritDoc
		 */
		public function swapRawChildrenAt(index1:int, index2:int):void
		{
			var oldBypass:Boolean = this.displayListBypassEnabled;
			this.displayListBypassEnabled = false;
			super.swapChildrenAt(index1, index2);
			this.displayListBypassEnabled = oldBypass;
		}

		/**
		 * @private
		 */
		override public function sortChildren(compareFunction:Function):void
		{
			if(!this.displayListBypassEnabled)
			{
				super.sortChildren(compareFunction);
				return;
			}
			DisplayObjectContainer(this.viewPort).sortChildren(compareFunction);
		}

		/**
		 * @inheritDoc
		 */
		public function sortRawChildren(compareFunction:Function):void
		{
			var oldBypass:Boolean = this.displayListBypassEnabled;
			this.displayListBypassEnabled = false;
			super.sortChildren(compareFunction);
			this.displayListBypassEnabled = oldBypass;
		}

		/**
		 * Readjusts the layout of the container according to its current
		 * content. Call this method when changes to the content cannot be
		 * automatically detected by the container. For instance, Feathers
		 * components dispatch <code>FeathersEventType.RESIZE</code> when their
		 * width and height values change, but standard Starling display objects
		 * like <code>Sprite</code> and <code>Image</code> do not.
		 */
		public function readjustLayout():void
		{
			this.layoutViewPort.readjustLayout();
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		override public function validate():void
		{
			//for the start of validation, we're going to ignore when children
			//resize or dispatch changes to layout data. this allows subclasses
			//to modify children in draw() before the layout is applied.
			var oldIgnoreChildChanges:Boolean = this._ignoreChildChangesButSetFlags;
			this._ignoreChildChangesButSetFlags = true;
			super.validate();
			//if super.validate() returns without calling draw(), the flag
			//won't be reset before layout is called, so we need reset manually.
			this._ignoreChildChangesButSetFlags = oldIgnoreChildChanges;
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(this.stage !== null)
			{
				//we use starling.root because a pop-up's root and the stage
				//root may be different.
				if(this.stage.starling.root === this)
				{
					this.autoSizeMode = AutoSizeMode.STAGE;
				}
			}
			super.initialize();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			//children are allowed to change during draw() in a subclass up
			//until it calls super.draw().
			this._ignoreChildChangesButSetFlags = false;

			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);

			if(layoutInvalid)
			{
				if(this._layout is IVirtualLayout)
				{
					IVirtualLayout(this._layout).useVirtualLayout = false;
				}
				this.layoutViewPort.layout = this._layout;
			}

			var oldIgnoreChildChanges:Boolean = this._ignoreChildChanges;
			this._ignoreChildChanges = true;
			super.draw();
			this._ignoreChildChanges = oldIgnoreChildChanges;
		}

		/**
		 * @private
		 */
		override protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}
			if(this._autoSizeMode === AutoSizeMode.STAGE &&
				this.stage !== null)
			{
				var newWidth:Number = this.stage.stageWidth;
				var newHeight:Number = this.stage.stageHeight;
				return this.saveMeasurements(newWidth, newHeight, newWidth, newHeight);
			}
			return super.autoSizeIfNeeded();
		}

		/**
		 * @private
		 */
		protected function scrollContainer_addedToStageHandler(event:Event):void
		{
			if(this._autoSizeMode === AutoSizeMode.STAGE)
			{
				//if we validated before being added to the stage, or if we've
				//been removed from stage and added again, we need to be sure
				//that the new stage dimensions are accounted for.
				this.invalidate(INVALIDATION_FLAG_SIZE);

				this.stage.addEventListener(Event.RESIZE, scrollContainer_stage_resizeHandler);
			}
		}

		/**
		 * @private
		 */
		protected function scrollContainer_removedFromStageHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.RESIZE, scrollContainer_stage_resizeHandler);
		}

		/**
		 * @private
		 */
		protected function child_resizeHandler(event:Event):void
		{
			if(this._ignoreChildChanges)
			{
				return;
			}
			if(this._ignoreChildChangesButSetFlags)
			{
				this.setInvalidationFlag(INVALIDATION_FLAG_SIZE);
				return;
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected function child_layoutDataChangeHandler(event:Event):void
		{
			if(this._ignoreChildChanges)
			{
				return;
			}
			if(this._ignoreChildChangesButSetFlags)
			{
				this.setInvalidationFlag(INVALIDATION_FLAG_SIZE);
				return;
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected function scrollContainer_stage_resizeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}
	}
}


================================================
FILE: source/feathers/controls/ScrollInteractionMode.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * Different ways that the user can interact with a scrolling container to
	 * control its scroll position.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class ScrollInteractionMode
	{
		/**
		 * The user may touch anywhere on the scroller and drag to scroll. The
		 * scroll bars will be visual indicator of position, but they will not
		 * be interactive.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const TOUCH:String = "touch";

		/**
		 * The user may only interact with the scroll bars to scroll. The user
		 * cannot touch anywhere in the scroller's content and drag like a touch
		 * interface.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const MOUSE:String = "mouse";

		/**
		 * The user may touch anywhere on the scroller and drag to scroll, and
		 * the scroll bars may be dragged separately. For most touch interfaces,
		 * this is not a common behavior. The scroll bar on touch interfaces is
		 * often simply a visual indicator and non-interactive.
		 *
		 * <p>One case where this mode might be used is a "scroll bar" that
		 * displays a tappable alphabetical index to navigate a
		 * <code>GroupedList</code> with alphabetical categories.</p>
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const TOUCH_AND_SCROLL_BARS:String = "touchAndScrollBars";
	}
}


================================================
FILE: source/feathers/controls/ScrollPolicy.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * Constants that define whether a container allows scrolling or not.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class ScrollPolicy
	{
		/**
		 * The scroller may scroll if the content is larger than the
		 * view port's bounds. If the interaction mode is touch, the elastic
		 * edges will only be active if the maximum scroll position is greater
		 * than zero. If the scroll bar display mode is fixed, the scroll bar
		 * will only be visible when the maximum scroll position is greater than
		 * zero.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const AUTO:String = "auto";

		/**
		 * The scroller will always scroll. If the interaction mode is touch,
		 * elastic edges will always be active, even when the maximum scroll
		 * position is zero. If the scroll bar display mode is fixed, the scroll
		 * bar will always be visible.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const ON:String = "on";

		/**
		 * The scroller does not scroll at all, even if the content is larger
		 * than the view port's bounds. If the scroll bar display mode is fixed
		 * or float, the scroll bar will never be visible.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const OFF:String = "off";
	}
}


================================================
FILE: source/feathers/controls/ScrollScreen.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.skins.IStyleProvider;
	import feathers.utils.display.getDisplayObjectDepthFromStage;

	import flash.events.KeyboardEvent;
	import flash.ui.Keyboard;

	import starling.events.Event;

	/**
	 * Dispatched when the transition animation begins as the screen is shown
	 * by the screen navigator.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.TRANSITION_IN_START
	 */
	[Event(name="transitionInStart",type="starling.events.Event")]

	/**
	 * Dispatched when the transition animation finishes as the screen is shown
	 * by the screen navigator.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.TRANSITION_IN_COMPLETE
	 */
	[Event(name="transitionInComplete",type="starling.events.Event")]

	/**
	 * Dispatched when the transition animation begins as a different screen is
	 * shown by the screen navigator and this screen is hidden.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.TRANSITION_OUT_START
	 */
	[Event(name="transitionOutStart",type="starling.events.Event")]

	/**
	 * Dispatched when the transition animation finishes as a different screen
	 * is shown by the screen navigator and this screen is hidden.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.TRANSITION_OUT_COMPLETE
	 */
	[Event(name="transitionOutComplete",type="starling.events.Event")]

	/**
	 * A screen for use with <code>ScreenNavigator</code>, based on
	 * <code>ScrollContainer</code> in order to provide scrolling and layout.
	 *
	 * <p>This component is generally not instantiated directly. Instead it is
	 * typically used as a super class for concrete implementations of screens.
	 * With that in mind, no code example is included here.</p>
	 *
	 * <p>The following example provides a basic framework for a new scroll screen:</p>
	 *
	 * <listing version="3.0">
	 * package
	 * {
	 *     import feathers.controls.ScrollScreen;
	 * 
	 *     public class CustomScreen extends ScrollScreen
	 *     {
	 *         public function CustomScreen()
	 *         {
	 *             super();
	 *         }
	 * 
	 *         override protected function initialize():void
	 *         {
	 *             //runs once when screen is first added to the stage
	 *             //a good place to add children and customize the layout
	 * 
	 *             //don't forget to call this!
	 *             super.initialize()
	 *         }
	 *     }
	 * }</listing>
	 *
	 * @see ../../../help/scroll-screen.html How to use the Feathers ScrollScreen component
	 * @see feathers.controls.StackScreenNavigator
	 * @see feathers.controls.ScreenNavigator
	 *
	 * @productversion Feathers 1.3.0
	 */
	public class ScrollScreen extends ScrollContainer implements IScreen
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>ScrollScreen</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function ScrollScreen()
		{
			this.addEventListener(Event.ADDED_TO_STAGE, scrollScreen_addedToStageHandler);
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return ScrollScreen.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _screenID:String;

		/**
		 * @inheritDoc
		 */
		public function get screenID():String
		{
			return this._screenID;
		}

		/**
		 * @private
		 */
		public function set screenID(value:String):void
		{
			this._screenID = value;
		}

		/**
		 * @private
		 */
		protected var _owner:Object;

		/**
		 * @inheritDoc
		 */
		public function get owner():Object
		{
			return this._owner;
		}

		/**
		 * @private
		 */
		public function set owner(value:Object):void
		{
			this._owner = value;
		}

		/**
		 * Optional callback for the back hardware key. Automatically handles
		 * keyboard events to cancel the default behavior.
		 *
		 * <p>This function has the following signature:</p>
		 *
		 * <pre>function():void</pre>
		 *
		 * <p>In the following example, a function will dispatch <code>Event.COMPLETE</code>
		 * when the back button is pressed:</p>
		 *
		 * <listing version="3.0">
		 * this.backButtonHandler = onBackButton;
		 * 
		 * private function onBackButton():void
		 * {
		 *     this.dispatchEvent( Event.COMPLETE );
		 * };</listing>
		 *
		 * @default null
		 */
		protected var backButtonHandler:Function;

		/**
		 * Optional callback for the menu hardware key. Automatically handles
		 * keyboard events to cancel the default behavior.
		 *
		 * <p>This function has the following signature:</p>
		 *
		 * <pre>function():void</pre>
		 *
		 * <p>In the following example, a function will be called when the menu
		 * button is pressed:</p>
		 *
		 * <listing version="3.0">
		 * this.menuButtonHandler = onMenuButton;
		 * 
		 * private function onMenuButton():void
		 * {
		 *     //do something with the menu button
		 * };</listing>
		 *
		 * @default null
		 */
		protected var menuButtonHandler:Function;

		/**
		 * Optional callback for the search hardware key. Automatically handles
		 * keyboard events to cancel the default behavior.
		 *
		 * <p>This function has the following signature:</p>
		 *
		 * <pre>function():void</pre>
		 *
		 * <p>In the following example, a function will be called when the search
		 * button is pressed:</p>
		 *
		 * <listing version="3.0">
		 * this.searchButtonHandler = onSearchButton;
		 * 
		 * private function onSearchButton():void
		 * {
		 *     //do something with the search button
		 * };</listing>
		 *
		 * @default null
		 */
		protected var searchButtonHandler:Function;

		/**
		 * @private
		 */
		protected function scrollScreen_addedToStageHandler(event:Event):void
		{
			this.addEventListener(Event.REMOVED_FROM_STAGE, scrollScreen_removedFromStageHandler);
			//using priority here is a hack so that objects higher up in the
			//display list have a chance to cancel the event first.
			var priority:int = -getDisplayObjectDepthFromStage(this);
			this.stage.starling.nativeStage.addEventListener(KeyboardEvent.KEY_DOWN, scrollScreen_nativeStage_keyDownHandler, false, priority, true);
		}

		/**
		 * @private
		 */
		protected function scrollScreen_removedFromStageHandler(event:Event):void
		{
			this.removeEventListener(Event.REMOVED_FROM_STAGE, scrollScreen_removedFromStageHandler);
			this.stage.starling.nativeStage.removeEventListener(KeyboardEvent.KEY_DOWN, scrollScreen_nativeStage_keyDownHandler);
		}

		/**
		 * @private
		 */
		protected function scrollScreen_nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.isDefaultPrevented())
			{
				//someone else already handled this one
				return;
			}
			if(this.backButtonHandler != null &&
				event.keyCode == Keyboard.BACK)
			{
				event.preventDefault();
				this.backButtonHandler();
			}

			if(this.menuButtonHandler != null &&
				event.keyCode == Keyboard.MENU)
			{
				event.preventDefault();
				this.menuButtonHandler();
			}

			if(this.searchButtonHandler != null &&
				event.keyCode == Keyboard.SEARCH)
			{
				event.preventDefault();
				this.searchButtonHandler();
			}
		}
	}
}


================================================
FILE: source/feathers/controls/ScrollText.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.supportClasses.TextFieldViewPort;
	import feathers.core.INativeFocusOwner;
	import feathers.skins.IStyleProvider;
	import feathers.text.FontStylesSet;

	import flash.text.AntiAliasType;
	import flash.text.GridFitType;
	import flash.text.StyleSheet;
	import flash.text.TextFormat;

	import starling.events.Event;
	import starling.text.TextFormat;

	/**
	 * The type of anti-aliasing used for this text field, defined as
	 * constants in the <code>flash.text.AntiAliasType</code> class.
	 *
	 * <p>In the following example, the anti-alias type is changed:</p>
	 *
	 * <listing version="3.0">
	 * textRenderer.antiAliasType = AntiAliasType.NORMAL;</listing>
	 *
	 * @default flash.text.AntiAliasType.ADVANCED
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#antiAliasType Full description of flash.text.TextField.antiAliasType in Adobe's Flash Platform API Reference
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/AntiAliasType.html flash.text.AntiAliasType
	 */
	[Style(name="antiAliasType",type="String")]

	/**
	 * Specifies whether the text field has a background fill. Use the
	 * <code>backgroundColor</code> property to set the background color of
	 * a text field.
	 *
	 * <p>In the following example, the background is enabled:</p>
	 *
	 * <listing version="3.0">
	 * scrollText.background = true;
	 * scrollText.backgroundColor = 0xff0000;</listing>
	 *
	 * @default false
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#background Full description of flash.text.TextField.background in Adobe's Flash Platform API Reference
	 * @see #style:backgroundColor
	 */
	[Style(name="background",type="Boolean")]

	/**
	 * The color of the text field background that is displayed if the
	 * <code>background</code> property is set to <code>true</code>.
	 *
	 * <p>In the following example, the background color is changed:</p>
	 *
	 * <listing version="3.0">
	 * scrollText.background = true;
	 * scrollText.backgroundColor = 0xff000ff;</listing>
	 *
	 * @default 0xffffff
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#backgroundColor Full description of flash.text.TextField.backgroundColor in Adobe's Flash Platform API Reference
	 * @see #style:background
	 */
	[Style(name="backgroundColor",type="uint")]

	/**
	 * Specifies whether the text field has a border. Use the
	 * <code>borderColor</code> property to set the border color.
	 *
	 * <p>In the following example, the border is enabled:</p>
	 *
	 * <listing version="3.0">
	 * scrollText.border = true;
	 * scrollText.borderColor = 0xff0000;</listing>
	 *
	 * @default false
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#border Full description of flash.text.TextField.border in Adobe's Flash Platform API Reference
	 * @see #style:borderColor
	 */
	[Style(name="border",type="Boolean")]

	/**
	 * The color of the text field border that is displayed if the
	 * <code>border</code> property is set to <code>true</code>.
	 *
	 * <p>In the following example, the border color is changed:</p>
	 *
	 * <listing version="3.0">
	 * scrollText.border = true;
	 * scrollText.borderColor = 0xff00ff;</listing>
	 *
	 * @default 0x000000
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#borderColor Full description of flash.text.TextField.borderColor in Adobe's Flash Platform API Reference
	 * @see #style:border
	 */
	[Style(name="borderColor",type="uint")]

	/**
	 * If set to <code>true</code>, an internal bitmap representation of the
	 * <code>TextField</code> on the classic display list is cached by the
	 * runtime. This caching may affect performance.
	 *
	 * <p>In the following example, bitmap caching is disabled:</p>
	 *
	 * <listing version="3.0">
	 * scrollText.cacheAsBitmap = false;</listing>
	 *
	 * @default true
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/display/DisplayObject.html#cacheAsBitmap Full description of flash.display.DisplayObject.cacheAsBitmap in Adobe's Flash Platform API Reference
	 */
	[Style(name="cacheAsBitmap",type="Boolean")]

	/**
	 * A boolean value that specifies whether extra white space (spaces,
	 * line breaks, and so on) in a text field with HTML text is removed.
	 *
	 * <p>In the following example, whitespace is condensed:</p>
	 *
	 * <listing version="3.0">
	 * scrollText.condenseWhite = true;</listing>
	 *
	 * @default false
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#condenseWhite Full description of flash.text.TextField.condenseWhite in Adobe's Flash Platform API Reference
	 * @see #isHTML
	 */
	[Style(name="condenseWhite",type="Boolean")]

	/**
	 * The font styles used to display the label's text when the label is
	 * disabled.
	 *
	 * <p>If the <code>textFormat</code> property or the
	 * <code>disabledTextFormat</code> property is not <code>null</code>,
	 * the <code>disabledFontStyles</code> property will be ignored.</p>
	 *
	 * <p>In the following example, the disabled font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * label.disabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but <code>ScrollText</code> supports
	 * a larger number of ways to be customized. Use the
	 * <code>disabledTextFormat</code> property to set more advanced styles
	 * on the text renderer. If the <code>disabledTextFormat</code> property
	 * is not <code>null</code>, the <code>disabledFontStyles</code>
	 * property will be ignored.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:fontStyles
	 */
	[Style(name="disabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * Advanced font formatting used to draw the text when the component is
	 * disabled if <code>disabledFontStyles</code> cannot be used.
	 *
	 * <p>If this property is not <code>null</code>, the
	 * <code>disabledFontStyles</code> property will be ignored.</p>
	 *
	 * <p>Note: It is considered best practice to use the
	 * <code>fontStyles</code> and <code>disabledFontStyles</code>
	 * properties with <code>starling.text.TextFormat</code> for font
	 * formatting. The <code>textFormat</code> property is available for
	 * advanced uses where features of <code>flash.text.TextField</code>
	 * that are not exposed by Starling's <code>TextFormat</code> need to be
	 * customized. In most cases, these advanced features are not required.</p>
	 *
	 * <p>In the following example, the disabled text format is changed:</p>
	 *
	 * <listing version="3.0">
	 * textRenderer.isEnabled = false;
	 * textRenderer.disabledTextFormat = new TextFormat( "_sans", 16, 0xcccccc );</listing>
	 *
	 * @default null
	 *
	 * @see #style:disabledFontStyles
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextFormat.html flash.text.TextFormat
	 */
	[Style(name="disabledTextFormat",type="flash.text.TextFormat")]

	/**
	 * Specifies whether the text field is a password text field that hides
	 * the input characters using asterisks instead of the actual
	 * characters.
	 *
	 * <p>In the following example, the text is displayed as a password:</p>
	 *
	 * <listing version="3.0">
	 * scrollText.displayAsPassword = true;</listing>
	 *
	 * @default false
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#displayAsPassword Full description of flash.text.TextField.displayAsPassword in Adobe's Flash Platform API Reference
	 */
	[Style(name="displayAsPassword",type="Boolean")]

	/**
	 * If advanced <code>flash.text.TextFormat</code> styles are specified,
	 * determines if the component should use an embedded font or not. If
	 * the specified font is not actually embedded, the text may not be
	 * displayed at all.
	 *
	 * <p>If the font styles are passed in using
	 * <code>starling.text.TextFormat</code>, the component  will automatically
	 * detect if a font is embedded or not, and the <code>embedFonts</code>
	 * property will be ignored if it is set to <code>false</code>. Setting it
	 * to <code>true</code> will force the component to always try to use
	 * embedded fonts.</p>
	 *
	 * <p>In the following example, some text is formatted with an embedded
	 * font:</p>
	 *
	 * <listing version="3.0">
	 * scrollText.textFormat = new TextFormat( "Source Sans Pro", 16, 0x333333;
	 * scrollText.embedFonts = true;</listing>
	 *
	 * @default false
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#embedFonts Full description of flash.text.TextField.embedFonts in Adobe's Flash Platform API Reference
	 * @see #textFormat
	 */
	[Style(name="embedFonts",type="Boolean")]

	/**
	 * The font styles used to display the label's text.
	 *
	 * <p>In the following example, the font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * label.fontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but <code>ScrollText</code> supports
	 * a larger number of ways to be customized. Use the
	 * <code>textFormat</code> property to set more advanced styles
	 * on the text renderer. If the <code>textFormat</code> property is not
	 * <code>null</code>, the <code>fontStyles</code> property will be
	 * ignored.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:disabledFontStyles
	 */
	[Style(name="fontStyles",type="starling.text.TextFormat")]

	/**
	 * Determines whether Flash Player forces strong horizontal and vertical
	 * lines to fit to a pixel or subpixel grid, or not at all using the
	 * constants defined in the <code>flash.text.GridFitType</code> class.
	 * This property applies only if the <code>antiAliasType</code> property
	 * of the text field is set to <code>flash.text.AntiAliasType.ADVANCED</code>.
	 *
	 * <p>In the following example, the grid fit type is changed:</p>
	 *
	 * <listing version="3.0">
	 * scrollText.gridFitType = GridFitType.SUBPIXEL;</listing>
	 *
	 * @default flash.text.GridFitType.PIXEL
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#gridFitType Full description of flash.text.TextField.gridFitType in Adobe's Flash Platform API Reference
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/GridFitType.html flash.text.GridFitType
	 * @see #style:antiAliasType
	 */
	[Style(name="gridFitType",type="String")]

	/**
	 * Quickly sets all outer padding properties to the same value. The
	 * <code>outerPadding</code> getter always returns the value of
	 * <code>outerPaddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the outer padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * panel.outerPadding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:outerPaddingTop
	 * @see #style:outerPaddingRight
	 * @see #style:outerPaddingBottom
	 * @see #style:outerPaddingLeft
	 * @see feathers.controls.Scroller#style:padding
	 */
	[Style(name="outerPadding",type="Number")]

	/**
	 * The minimum space, in pixels, between the view port's top edge and the
	 * top edge of the component.
	 *
	 * <p>Note: The <code>paddingTop</code> property applies to padding inside
	 * the view port, and may not be visible on all sides if the text may be
	 * scroll. Use <code>outerPaddingTop</code> if you want to always display
	 * padding on the top side of the component. <code>outerPaddingTop</code>
	 * and <code>paddingTop</code> may be used simultaneously to define
	 * padding around the outer edges of the container and additional padding
	 * around the text.</p>
	 *
	 * <p>In the following example, the top padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * panel.outerPaddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:outerPadding
	 * @see feathers.controls.Scroller#style:paddingTop
	 */
	[Style(name="outerPaddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the view port's right edge and the
	 * right edge of the component.
	 *
	 * <p>Note: The <code>paddingRight</code> property applies to padding inside
	 * the view port, and may not be visible on all sides if the text may be
	 * scroll. Use <code>outerPaddingRight</code> if you want to always display
	 * padding on the right side of the component. <code>outerPaddingRight</code>
	 * and <code>paddingRight</code> may be used simultaneously to define
	 * padding around the outer edges of the container and additional padding
	 * around the text.</p>
	 *
	 * <p>In the following example, the right outer padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * panel.outerPaddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:outerPadding
	 * @see feathers.controls.Scroller#style:paddingRight
	 */
	[Style(name="outerPaddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the view port's bottom edge and the
	 * bottom edge of the component.
	 *
	 * <p>Note: The <code>paddingBottom</code> property applies to padding inside
	 * the view port, and may not be visible on all sides if the text may be
	 * scroll. Use <code>outerPaddingBottom</code> if you want to always display
	 * padding on the bottom edge of the component. <code>outerPaddingBottom</code>
	 * and <code>paddingBottom</code> may be used simultaneously to define
	 * padding around the outer edges of the container and additional padding
	 * around the text.</p>
	 *
	 * <p>In the following example, the bottom outer padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * panel.outerPaddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:outerPadding
	 * @see feathers.controls.Scroller#style:paddingBottom
	 */
	[Style(name="outerPaddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the view port's left edge and the
	 * left edge of the component.
	 *
	 * <p>Note: The <code>paddingLeft</code> property applies to padding inside
	 * the view port, and may not be visible on all sides if the text may be
	 * scroll. Use <code>outerPaddingLeft</code> if you want to always display
	 * padding on the left side of the component. <code>outerPaddingLeft</code>
	 * and <code>paddingLeft</code> may be used simultaneously to define
	 * padding around the outer edges of the container and additional padding
	 * around the text.</p>
	 *
	 * <p>In the following example, the left outer padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scrollText.outerPaddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:outerPadding
	 * @see feathers.controls.Scroller#style:paddingLeft
	 */
	[Style(name="outerPaddingLeft",type="Number")]

	/**
	 * The sharpness of the glyph edges in this text field. This property
	 * applies only if the <code>antiAliasType</code> property of the text
	 * field is set to <code>flash.text.AntiAliasType.ADVANCED</code>. The
	 * range for <code>sharpness</code> is a number from <code>-400</code>
	 * to <code>400</code>.
	 *
	 * <p>In the following example, the sharpness is changed:</p>
	 *
	 * <listing version="3.0">
	 * scrollText.sharpness = 200;</listing>
	 *
	 * @default 0
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#sharpness Full description of flash.text.TextField.sharpness in Adobe's Flash Platform API Reference
	 * @see #style:antiAliasType
	 */
	[Style(name="sharpness",type="Number")]

	/**
	 * The <code>StyleSheet</code> object to pass to the TextField.
	 *
	 * <p>In the following example, a style sheet is applied:</p>
	 *
	 * <listing version="3.0">
	 * var style:StyleSheet = new StyleSheet();
	 * var heading:Object = new Object();
	 * heading.fontWeight = "bold";
	 * heading.color = "#FF0000";
	 * 
	 * var body:Object = new Object();
	 * body.fontStyle = "italic";
	 * 
	 * style.setStyle(".heading", heading);
	 * style.setStyle("body", body);
	 * 
	 * scrollText.styleSheet = style;
	 * scrollText.isHTML = true;
	 * scrollText.text = "&lt;body&gt;&lt;span class='heading'&gt;Hello&lt;/span&gt; World...&lt;/body&gt;";</listing>
	 *
	 * @default null
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#styleSheet Full description of flash.text.TextField.styleSheet in Adobe's Flash Platform API Reference
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StyleSheet.html flash.text.StyleSheet
	 * @see #isHTML
	 */
	[Style(name="styleSheet",type="flash.text.StyleSheet")]

	/**
	 * Advanced font formatting used to draw the text if
	 * <code>fontStyles</code> cannot be used.
	 *
	 * <p>If this property is not <code>null</code>, the
	 * <code>fontStyles</code> property will be ignored.</p>
	 *
	 * <p>Note: It is considered best practice to use the
	 * <code>fontStyles</code> property and
	 * <code>starling.text.TextFormat</code> for font formatting. The
	 * <code>textFormat</code> property is available for advanced uses where
	 * features of <code>flash.text.TextField</code> that are not exposed by
	 * Starling's <code>TextFormat</code> need to be customized. In most
	 * cases, these advanced features are not required.</p>
	 *
	 * <p>In the following example, the text is formatted:</p>
	 *
	 * <listing version="3.0">
	 * scrollText.textFormat = new TextFormat( "_sans", 16, 0x333333 );</listing>
	 *
	 * @default null
	 *
	 * @see #style:fontStyles
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextFormat.html flash.text.TextFormat
	 */
	[Style(name="textFormat",type="flash.text.TextFormat")]

	/**
	 * The thickness of the glyph edges in this text field. This property
	 * applies only if the <code>antiAliasType</code> property is set to
	 * <code>flash.text.AntiAliasType.ADVANCED</code>. The range for
	 * <code>thickness</code> is a number from <code>-200</code> to
	 * <code>200</code>.
	 *
	 * <p>In the following example, the thickness is changed:</p>
	 *
	 * <listing version="3.0">
	 * scrollText.thickness = 100;</listing>
	 *
	 * @default 0
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#thickness Full description of flash.text.TextField.thickness in Adobe's Flash Platform API Reference
	 * @see #style:antiAliasType
	 */
	[Style(name="thickness",type="Number")]

	/**
	 * Dispatched when an anchor (<code>&lt;a&gt;</code>) element in the HTML
	 * text is triggered when the <code>href</code> attribute begins with
	 * <code>"event:"</code>. This event is dispatched when the internal
	 * <code>flash.text.TextField</code> dispatches its own
	 * <code>TextEvent.LINK</code>.
	 *
	 * <p>The <code>data</code> property of the <code>Event</code> object that
	 * is dispatched by the <code>ScrollText</code> contains the value of the
	 * <code>text</code> property of the <code>TextEvent</code> that is
	 * dispatched by the <code>flash.text.TextField</code>.</p>
	 *
	 * <p>The following example listens for <code>Event.TRIGGERED</code> on a
	 * <code>ScrollText</code> component:</p>
	 *
	 * <listing version="3.0">
	 * var scrollText:ScrollText = new ScrollText();
	 * scrollText.text = "&lt;a href=\"event:hello\"&gt;Hello&lt;/a&gt; World";
	 * scrollText.addEventListener( Event.TRIGGERED, scrollText_triggeredHandler );
	 * this.addChild( scrollText );</listing>
	 *
	 * <p>The following example shows a listener for <code>Event.TRIGGERED</code>:</p>
	 *
	 * <listing version="3.0">
	 * function scrollText_triggeredHandler(event:Event):void
	 * {
	 *     trace( event.data ); //hello
	 * }</listing>
	 *
	 * @eventType starling.events.Event.TRIGGERED
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/events/TextEvent.html#LINK flash.events.TextEvent.LINK
	 */
	[Event(name="triggered",type="starling.events.Event")]

	/**
	 * Displays long passages of text in a scrollable container using the
	 * runtime's software-based <code>flash.text.TextField</code> as an overlay
	 * above Starling content on the classic display list. This component will
	 * <strong>always</strong> appear above Starling content. The only way to
	 * put something above ScrollText is to put something above it on the
	 * classic display list.
	 *
	 * <p>Meant as a workaround component for when TextFieldTextRenderer runs
	 * into the runtime texture limits.</p>
	 *
	 * <p>Since this component is rendered with the runtime's software renderer,
	 * rather than on the GPU, it may not perform very well on mobile devices
	 * with high resolution screens.</p>
	 *
	 * <p>The following example displays some text:</p>
	 *
	 * <listing version="3.0">
	 * var scrollText:ScrollText = new ScrollText();
	 * scrollText.text = "Hello World";
	 * this.addChild( scrollText );</listing>
	 *
	 * @see ../../../help/scroll-text.html How to use the Feathers ScrollText component
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html flash.text.TextField
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class ScrollText extends Scroller implements INativeFocusOwner
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>ScrollText</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function ScrollText()
		{
			super();
			if(this._fontStylesSet === null)
			{
				this._fontStylesSet = new FontStylesSet();
				this._fontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
			this.textViewPort = new TextFieldViewPort();
			this.textViewPort.addEventListener(Event.TRIGGERED, textViewPort_triggeredHandler);
			this.viewPort = this.textViewPort;
		}

		/**
		 * @private
		 */
		protected var textViewPort:TextFieldViewPort;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return ScrollText.globalStyleProvider;
		}

		/**
		 * @private
		 */
		public function get nativeFocus():Object
		{
			if(this.viewPort === null)
			{
				return null;
			}
			return this.textViewPort.nativeFocus;
		}

		/**
		 * @private
		 */
		protected var _text:String = "";

		/**
		 * The text to display. If <code>isHTML</code> is <code>true</code>, the
		 * text will be rendered as HTML with the same capabilities as the
		 * <code>htmlText</code> property of <code>flash.text.TextField</code>.
		 *
		 * <p>In the following example, some text is displayed:</p>
		 *
		 * <listing version="3.0">
		 * scrollText.text = "Hello World";</listing>
		 *
		 * @default ""
		 *
		 * @see #isHTML
		 */
		public function get text():String
		{
			return this._text;
		}

		/**
		 * @private
		 */
		public function set text(value:String):void
		{
			if(!value)
			{
				value = "";
			}
			if(this._text == value)
			{
				return;
			}
			this._text = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _isHTML:Boolean = false;

		/**
		 * Determines if the TextField should display the text as HTML or not.
		 *
		 * <p>In the following example, some HTML-formatted text is displayed:</p>
		 *
		 * <listing version="3.0">
		 * scrollText.isHTML = true;
		 * scrollText.text = "&lt;b&gt;Hello&lt;/b&gt; &lt;i&gt;World&lt;/i&gt;";</listing>
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#htmlText flash.text.TextField.htmlText
		 * @see #text
		 */
		public function get isHTML():Boolean
		{
			return this._isHTML;
		}

		/**
		 * @private
		 */
		public function set isHTML(value:Boolean):void
		{
			if(this._isHTML == value)
			{
				return;
			}
			this._isHTML = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _fontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get fontStyles():starling.text.TextFormat
		{
			return this._fontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set fontStyles(value:starling.text.TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._fontStylesSet.format = value;
		}

		/**
		 * @private
		 */
		public function get disabledFontStyles():starling.text.TextFormat
		{
			return this._fontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set disabledFontStyles(value:starling.text.TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._fontStylesSet.disabledFormat = value;
		}

		/**
		 * @private
		 */
		protected var _textFormat:flash.text.TextFormat;

		/**
		 * @private
		 */
		public function get textFormat():flash.text.TextFormat
		{
			return this._textFormat;
		}

		/**
		 * @private
		 */
		public function set textFormat(value:flash.text.TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._textFormat === value)
			{
				return;
			}
			this._textFormat = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _disabledTextFormat:flash.text.TextFormat;

		/**
		 * @private
		 */
		public function get disabledTextFormat():flash.text.TextFormat
		{
			return this._disabledTextFormat;
		}

		/**
		 * @private
		 */
		public function set disabledTextFormat(value:flash.text.TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._disabledTextFormat === value)
			{
				return;
			}
			this._disabledTextFormat = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _styleSheet:StyleSheet;

		/**
		 * @private
		 */
		public function get styleSheet():StyleSheet
		{
			return this._styleSheet;
		}

		/**
		 * @private
		 */
		public function set styleSheet(value:StyleSheet):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._styleSheet === value)
			{
				return;
			}
			this._styleSheet = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _embedFonts:Boolean = false;

		/**
		 * @private
		 */
		public function get embedFonts():Boolean
		{
			return this._embedFonts;
		}

		/**
		 * @private
		 */
		public function set embedFonts(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._embedFonts === value)
			{
				return;
			}
			this._embedFonts = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _antiAliasType:String = AntiAliasType.ADVANCED;

		/**
		 * @private
		 */
		public function get antiAliasType():String
		{
			return this._antiAliasType;
		}

		/**
		 * @private
		 */
		public function set antiAliasType(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._antiAliasType === value)
			{
				return;
			}
			this._antiAliasType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _background:Boolean = false;

		/**
		 * @private
		 */
		public function get background():Boolean
		{
			return this._background;
		}

		/**
		 * @private
		 */
		public function set background(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._background === value)
			{
				return;
			}
			this._background = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _backgroundColor:uint = 0xffffff;

		/**
		 * @private
		 */
		public function get backgroundColor():uint
		{
			return this._backgroundColor;
		}

		/**
		 * @private
		 */
		public function set backgroundColor(value:uint):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._backgroundColor == value)
			{
				return;
			}
			this._backgroundColor = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _border:Boolean = false;

		/**
		 * @private
		 */
		public function get border():Boolean
		{
			return this._border;
		}

		/**
		 * @private
		 */
		public function set border(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._border === value)
			{
				return;
			}
			this._border = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _borderColor:uint = 0x000000;

		/**
		 * @private
		 */
		public function get borderColor():uint
		{
			return this._borderColor;
		}

		/**
		 * @private
		 */
		public function set borderColor(value:uint):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._borderColor == value)
			{
				return;
			}
			this._borderColor = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _cacheAsBitmap:Boolean = true;

		/**
		 * @private
		 */
		public function get cacheAsBitmap():Boolean
		{
			return this._cacheAsBitmap;
		}

		/**
		 * @private
		 */
		public function set cacheAsBitmap(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._cacheAsBitmap === value)
			{
				return;
			}
			this._cacheAsBitmap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _condenseWhite:Boolean = false;

		/**
		 * @private
		 */
		public function get condenseWhite():Boolean
		{
			return this._condenseWhite;
		}

		/**
		 * @private
		 */
		public function set condenseWhite(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._condenseWhite === value)
			{
				return;
			}
			this._condenseWhite = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _displayAsPassword:Boolean = false;

		/**
		 * @private
		 */
		public function get displayAsPassword():Boolean
		{
			return this._displayAsPassword;
		}

		/**
		 * @private
		 */
		public function set displayAsPassword(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._displayAsPassword === value)
			{
				return;
			}
			this._displayAsPassword = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _gridFitType:String = GridFitType.PIXEL;

		/**
		 * @private
		 */
		public function get gridFitType():String
		{
			return this._gridFitType;
		}

		/**
		 * @private
		 */
		public function set gridFitType(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._gridFitType === value)
			{
				return;
			}
			this._gridFitType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _sharpness:Number = 0;

		/**
		 * @private
		 */
		public function get sharpness():Number
		{
			return this._sharpness;
		}

		/**
		 * @private
		 */
		public function set sharpness(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._sharpness == value)
			{
				return;
			}
			this._sharpness = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		private var _thickness:Number = 0;

		/**
		 * @private
		 */
		public function get thickness():Number
		{
			return this._thickness;
		}

		/**
		 * @private
		 */
		public function set thickness(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._thickness == value)
			{
				return;
			}
			this._thickness = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		override public function get padding():Number
		{
			return this._textPaddingTop;
		}

		//no setter for padding because the one in Scroller is acceptable

		/**
		 * @private
		 */
		protected var _textPaddingTop:Number = 0;

		/**
		 * @private
		 */
		override public function get paddingTop():Number
		{
			return this._textPaddingTop;
		}

		/**
		 * @private
		 */
		override public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._textPaddingTop == value)
			{
				return;
			}
			this._textPaddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _textPaddingRight:Number = 0;

		/**
		 * @private
		 */
		override public function get paddingRight():Number
		{
			return this._textPaddingRight;
		}

		/**
		 * @private
		 */
		override public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._textPaddingRight == value)
			{
				return;
			}
			this._textPaddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _textPaddingBottom:Number = 0;

		/**
		 * @private
		 */
		override public function get paddingBottom():Number
		{
			return this._textPaddingBottom;
		}

		/**
		 * @private
		 */
		override public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._textPaddingBottom == value)
			{
				return;
			}
			this._textPaddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _textPaddingLeft:Number = 0;

		/**
		 * @private
		 */
		override public function get paddingLeft():Number
		{
			return this._textPaddingLeft;
		}

		/**
		 * @private
		 */
		override public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._textPaddingLeft == value)
			{
				return;
			}
			this._textPaddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		public function get outerPadding():Number
		{
			return this._outerPaddingTop;
		}

		/**
		 * @private
		 */
		public function set outerPadding(value:Number):void
		{
			this.outerPaddingTop = value;
			this.outerPaddingRight = value;
			this.outerPaddingBottom = value;
			this.outerPaddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _outerPaddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get outerPaddingTop():Number
		{
			return this._outerPaddingTop;
		}

		/**
		 * @private
		 */
		public function set outerPaddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._outerPaddingTop == value)
			{
				return;
			}
			this._outerPaddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _outerPaddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get outerPaddingRight():Number
		{
			return this._outerPaddingRight;
		}

		/**
		 * @private
		 */
		public function set outerPaddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._outerPaddingRight == value)
			{
				return;
			}
			this._outerPaddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _outerPaddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get outerPaddingBottom():Number
		{
			return this._outerPaddingBottom;
		}

		/**
		 * @private
		 */
		public function set outerPaddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._outerPaddingBottom == value)
			{
				return;
			}
			this._outerPaddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _outerPaddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get outerPaddingLeft():Number
		{
			return this._outerPaddingLeft;
		}

		/**
		 * @private
		 */
		public function set outerPaddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._outerPaddingLeft == value)
			{
				return;
			}
			this._outerPaddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _visible:Boolean = true;

		/**
		 * @private
		 */
		override public function get visible():Boolean
		{
			return this._visible;
		}

		/**
		 * @private
		 */
		override public function set visible(value:Boolean):void
		{
			if(this._visible == value)
			{
				return;
			}
			this._visible = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _alpha:Number = 1;

		/**
		 * @private
		 */
		override public function get alpha():Number
		{
			return this._alpha;
		}

		/**
		 * @private
		 */
		override public function set alpha(value:Number):void
		{
			if(this._alpha == value)
			{
				return;
			}
			this._alpha = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this._fontStylesSet !== null)
			{
				this._fontStylesSet.dispose();
				this._fontStylesSet = null;
			}
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var scrollInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SCROLL);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);

			if(dataInvalid)
			{
				this.textViewPort.text = this._text;
				this.textViewPort.isHTML = this._isHTML;
			}

			if(stylesInvalid)
			{
				this.textViewPort.antiAliasType = this._antiAliasType;
				this.textViewPort.background = this._background;
				this.textViewPort.backgroundColor = this._backgroundColor;
				this.textViewPort.border = this._border;
				this.textViewPort.borderColor = this._borderColor;
				this.textViewPort.cacheAsBitmap = this._cacheAsBitmap;
				this.textViewPort.condenseWhite = this._condenseWhite;
				this.textViewPort.displayAsPassword = this._displayAsPassword;
				this.textViewPort.gridFitType = this._gridFitType;
				this.textViewPort.sharpness = this._sharpness;
				this.textViewPort.thickness = this._thickness;
				this.textViewPort.textFormat = this._textFormat;
				this.textViewPort.disabledTextFormat = this._disabledTextFormat;
				this.textViewPort.fontStyles = this._fontStylesSet;
				this.textViewPort.styleSheet = this._styleSheet;
				this.textViewPort.embedFonts = this._embedFonts;
				this.textViewPort.paddingTop = this._textPaddingTop;
				this.textViewPort.paddingRight = this._textPaddingRight;
				this.textViewPort.paddingBottom = this._textPaddingBottom;
				this.textViewPort.paddingLeft = this._textPaddingLeft;
				this.textViewPort.visible = this._visible;
				this.textViewPort.alpha = this._alpha;
			}

			super.draw();
		}

		/**
		 * @private
		 */
		override protected function calculateViewPortOffsets(forceScrollBars:Boolean = false, useActualBounds:Boolean = false):void
		{
			super.calculateViewPortOffsets(forceScrollBars);

			this._topViewPortOffset += this._outerPaddingTop;
			this._rightViewPortOffset += this._outerPaddingRight;
			this._bottomViewPortOffset += this._outerPaddingBottom;
			this._leftViewPortOffset += this._outerPaddingLeft;
		}

		/**
		 * @private
		 */
		protected function textViewPort_triggeredHandler(event:Event, link:String):void
		{
			this.dispatchEventWith(Event.TRIGGERED, false, link);
		}

		/**
		 * @private
		 */
		protected function fontStyles_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}
	}
}


================================================
FILE: source/feathers/controls/Scroller.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.supportClasses.IViewPort;
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IFocusDisplayObject;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IValidating;
	import feathers.core.PropertyProxy;
	import feathers.events.ExclusiveTouch;
	import feathers.events.FeathersEventType;
	import feathers.layout.Direction;
	import feathers.layout.RelativePosition;
	import feathers.system.DeviceCapabilities;
	import feathers.utils.display.getDisplayObjectDepthFromStage;
	import feathers.utils.math.roundDownToNearest;
	import feathers.utils.math.roundToNearest;
	import feathers.utils.math.roundUpToNearest;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;

	import flash.errors.IllegalOperationError;
	import flash.events.KeyboardEvent;
	import flash.events.MouseEvent;
	import flash.events.TransformGestureEvent;
	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.ui.Keyboard;
	import flash.utils.getQualifiedClassName;
	import flash.utils.getTimer;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.MathUtil;
	import starling.utils.Pool;

	/**
	 * If <code>true</code>, the background's <code>visible</code> property
	 * will be set to <code>false</code> when the scroll position is greater
	 * than or equal to the minimum scroll position and less than or equal
	 * to the maximum scroll position. The background will be visible when
	 * the content is extended beyond the scrolling bounds, such as when
	 * <code>hasElasticEdges</code> is <code>true</code>.
	 *
	 * <p>If the content is not fully opaque, this setting should not be
	 * enabled.</p>
	 *
	 * <p>This setting may be enabled to potentially improve performance.</p>
	 *
	 * <p>In the following example, the background is automatically hidden:</p>
	 *
	 * <listing version="3.0">
	 * scroller.autoHideBackground = true;</listing>
	 *
	 * @default false
	 * 
	 * @see #style:backgroundSkin
	 */
	[Style(name="autoHideBackground",type="Boolean")]

	/**
	 * The default background to display.
	 *
	 * <p>In the following example, the scroller is given a background skin:</p>
	 *
	 * <listing version="3.0">
	 * scroller.backgroundSkin = new Image( texture );</listing>
	 *
	 * @default null
	 * 
	 * @see #style:backgroundDisabledSkin
	 */
	[Style(name="backgroundSkin",type="starling.display.DisplayObject")]

	/**
	 * A background to display when the container is disabled.
	 *
	 * <p>In the following example, the scroller is given a disabled background skin:</p>
	 *
	 * <listing version="3.0">
	 * scroller.backgroundDisabledSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundSkin
	 */
	[Style(name="backgroundDisabledSkin",type="starling.display.DisplayObject")]

	/**
	 * If true, the viewport will be clipped to the scroller's bounds. In
	 * other words, anything appearing outside the scroller's bounds will
	 * not be visible.
	 *
	 * <p>To improve performance, turn off clipping and place other display
	 * objects over the edges of the scroller to hide the content that
	 * bleeds outside of the scroller's bounds.</p>
	 *
	 * <p>In the following example, clipping is disabled:</p>
	 *
	 * <listing version="3.0">
	 * scroller.clipContent = false;</listing>
	 *
	 * @default true
	 */
	[Style(name="clipContent",type="Boolean")]

	/**
	 * A style name to add to the container's horizontal scroll bar
	 * sub-component. Typically used by a theme to provide different styles
	 * to different containers.
	 *
	 * <p>In the following example, a custom horizontal scroll bar style
	 * name is passed to the scroller:</p>
	 *
	 * <listing version="3.0">
	 * scroller.customHorizontalScrollBarStyleName = "my-custom-horizontal-scroll-bar";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( SimpleScrollBar ).setFunctionForStyleName( "my-custom-horizontal-scroll-bar", setCustomHorizontalScrollBarStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_HORIZONTAL_SCROLL_BAR
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #horizontalScrollBarFactory
	 */
	[Style(name="customHorizontalScrollBarStyleName",type="String")]

	/**
	 * A style name to add to the container's vertical scroll bar
	 * sub-component. Typically used by a theme to provide different styles
	 * to different containers.
	 *
	 * <p>In the following example, a custom vertical scroll bar style name
	 * is passed to the scroller:</p>
	 *
	 * <listing version="3.0">
	 * scroller.customVerticalScrollBarStyleName = "my-custom-vertical-scroll-bar";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( SimpleScrollBar ).setFunctionForStyleName( "my-custom-vertical-scroll-bar", setCustomVerticalScrollBarStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_VERTICAL_SCROLL_BAR
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #verticalScrollBarFactory
	 */
	[Style(name="customVerticalScrollBarStyleName",type="String")]

	/**
	 * This value is used to decelerate the scroller when "thrown". The
	 * velocity of a throw is multiplied by this value once per millisecond
	 * to decelerate. A value greater than <code>0</code> and less than
	 * <code>1</code> is expected.
	 *
	 * <p>In the following example, deceleration rate is lowered to adjust
	 * the behavior of a throw:</p>
	 *
	 * <listing version="3.0">
	 * scroller.decelerationRate = DecelerationRate.FAST;</listing>
	 *
	 * @default feathers.controls.DecelerationRate.NORMAL
	 *
	 * @see feathers.controls.DecelerationRate#NORMAL
	 * @see feathers.controls.DecelerationRate#FAST
	 */
	[Style(name="decelerationRate",type="Number")]

	/**
	 * If the scroll position goes outside the minimum or maximum bounds
	 * when the scroller's content is being actively dragged, the scrolling
	 * will be constrained using this multiplier. A value of <code>0</code>
	 * means that the scroller will not go beyond its minimum or maximum
	 * bounds. A value of <code>1</code> means that going beyond the minimum
	 * or maximum bounds is completely unrestrained.
	 *
	 * <p>In the following example, the elasticity of dragging beyond the
	 * scroller's edges is customized:</p>
	 *
	 * <listing version="3.0">
	 * scroller.elasticity = 0.5;</listing>
	 *
	 * @default 0.33
	 *
	 * @see #style:hasElasticEdges
	 * @see #style:throwElasticity
	 */
	[Style(name="elasticity",type="Number")]

	/**
	 * The duration, in seconds, of the animation when a the scroller snaps
	 * back to the minimum or maximum position after going out of bounds.
	 *
	 * <p>In the following example, the duration of the animation that snaps
	 * the content back after pulling it beyond the edge is set to 750
	 * milliseconds:</p>
	 *
	 * <listing version="3.0">
	 * scroller.elasticSnapDuration = 0.75;</listing>
	 *
	 * @default 0.5
	 * 
	 * @see #style:hasElasticEdges
	 */
	[Style(name="elasticSnapDuration",type="Number")]

	/**
	 * Determines if the scrolling can go beyond the edges of the viewport.
	 *
	 * <p>In the following example, elastic edges are disabled:</p>
	 *
	 * <listing version="3.0">
	 * scroller.hasElasticEdges = false;</listing>
	 *
	 * @default true
	 *
	 * @see #style:elasticity
	 * @see #style:throwElasticity
	 */
	[Style(name="hasElasticEdges",type="Boolean")]

	/**
	 * The duration, in seconds, of the animation when a scroll bar fades
	 * out.
	 *
	 * <p>In the following example, the duration of the animation that hides
	 * the scroll bars is set to 500 milliseconds:</p>
	 *
	 * <listing version="3.0">
	 * scroller.hideScrollBarAnimationDuration = 0.5;</listing>
	 *
	 * @default 0.2
	 * 
	 * @see #style:scrollBarDisplayMode
	 */
	[Style(name="hideScrollBarAnimationDuration",type="Number")]

	/**
	 * The easing function used for hiding the scroll bars, if applicable.
	 *
	 * <p>In the following example, the ease of the animation that hides
	 * the scroll bars is customized:</p>
	 *
	 * <listing version="3.0">
	 * scroller.hideScrollBarAnimationEase = Transitions.EASE_IN_OUT;</listing>
	 *
	 * @default starling.animation.Transitions.EASE_OUT
	 *
	 * @see http://doc.starling-framework.org/core/starling/animation/Transitions.html starling.animation.Transitions
	 *
	 * @see #style:scrollBarDisplayMode
	 */
	[Style(name="hideScrollBarAnimationEase",type="Object")]

	/**
	 * Determines where the horizontal scroll bar will be positioned.
	 *
	 * <p>In the following example, the scroll bars is positioned on the top:</p>
	 *
	 * <listing version="3.0">
	 * scroller.horizontalScrollBarPosition = RelativePosition.TOP;</listing>
	 *
	 * @default feathers.layout.RelativePosition.BOTTOM
	 *
	 * @see feathers.layout.RelativePosition#TOP
	 * @see feathers.layout.RelativePosition#BOTTOM
	 */
	[Style(name="horizontalScrollBarPosition",type="String")]

	/**
	 * Determines how the user may interact with the scroller.
	 *
	 * <p>In the following example, the interaction mode is optimized for mouse:</p>
	 *
	 * <listing version="3.0">
	 * scroller.interactionMode = ScrollInteractionMode.MOUSE;</listing>
	 *
	 * @default feathers.controls.ScrollInteractionMode.TOUCH
	 *
	 * @see feathers.controls.ScrollInteractionMode#TOUCH
	 * @see feathers.controls.ScrollInteractionMode#MOUSE
	 * @see feathers.controls.ScrollInteractionMode#TOUCH_AND_SCROLL_BARS
	 */
	[Style(name="interactionMode",type="String")]

	/**
	 * The duration, in seconds, of the animation when the mouse wheel
	 * initiates a scroll action.
	 *
	 * <p>In the following example, the duration of the animation that runs
	 * when the mouse wheel is scrolled is set to 500 milliseconds:</p>
	 *
	 * <listing version="3.0">
	 * scroller.mouseWheelScrollDuration = 0.5;</listing>
	 *
	 * @default 0.35
	 */
	[Style(name="mouseWheelScrollDuration",type="Number")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scroller.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, between the container's top edge and the
	 * container's content.
	 *
	 * <p>In the following example, the top padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scroller.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the container's right edge and
	 * the container's content.
	 *
	 * <p>In the following example, the right padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scroller.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the container's bottom edge and
	 * the container's content.
	 *
	 * <p>In the following example, the bottom padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scroller.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the container's left edge and the
	 * container's content.
	 *
	 * <p>In the following example, the left padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scroller.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * The duration, in seconds, of the animation when the scroller is
	 * thrown to a page.
	 *
	 * <p>In the following example, the duration of the animation that
	 * changes the page when thrown is set to 250 milliseconds:</p>
	 *
	 * <listing version="3.0">
	 * scroller.pageThrowDuration = 0.25;</listing>
	 *
	 * @default 0.5
	 */
	[Style(name="pageThrowDuration",type="Number")]

	/**
	 * The duration, in seconds, that the scroll bars will be shown when
	 * calling <code>revealScrollBars()</code>
	 *
	 * @default 1.0
	 *
	 * @see #revealScrollBars()
	 */
	[Style(name="revealScrollBarsDuration",type="Number")]

	/**
	 * Determines how the scroll bars are displayed.
	 *
	 * <p>In the following example, the scroll bars are fixed:</p>
	 *
	 * <listing version="3.0">
	 * scroller.scrollBarDisplayMode = ScrollBarDisplayMode.FIXED;</listing>
	 *
	 * @default feathers.controls.ScrollBarDisplayMode.FLOAT
	 *
	 * @see feathers.controls.ScrollBarDisplayMode#FLOAT
	 * @see feathers.controls.ScrollBarDisplayMode#FIXED
	 * @see feathers.controls.ScrollBarDisplayMode#FIXED_FLOAT
	 * @see feathers.controls.ScrollBarDisplayMode#NONE
	 */
	[Style(name="scrollBarDisplayMode",type="String")]

	/**
	 * If enabled, the scroll position will always be adjusted to the nearest
	 * pixel on the physical screen. Depending on the value of Starling's
	 * <code>contentScaleFactor</code>, this may or may not result in an integer
	 * value for the scroll position.
	 *
	 * <p>In the following example, the scroll position is not snapped to pixels:</p>
	 *
	 * <listing version="3.0">
	 * scroller.snapScrollPositionsToPixels = false;</listing>
	 *
	 * @default true
	 */
	[Style(name="snapScrollPositionsToPixels",type="Boolean")]

	/**
	 * Determines if scrolling will snap to the nearest page.
	 *
	 * <p>In the following example, the scroller snaps to the nearest page:</p>
	 *
	 * <listing version="3.0">
	 * scroller.snapToPages = true;</listing>
	 *
	 * @default false
	 */
	[Style(name="snapToPages",type="Boolean")]

	/**
	 * The easing function used for "throw" animations.
	 *
	 * <p>In the following example, the ease of throwing animations is
	 * customized:</p>
	 *
	 * <listing version="3.0">
	 * scroller.throwEase = Transitions.EASE_IN_OUT;</listing>
	 *
	 * @see http://doc.starling-framework.org/core/starling/animation/Transitions.html starling.animation.Transitions
	 */
	[Style(name="throwEase",type="Object")]

	/**
	 * If the scroll position goes outside the minimum or maximum bounds
	 * when the scroller's content is "thrown", the scrolling will be
	 * constrained using this multiplier. A value of <code>0</code> means
	 * that the scroller will not go beyond its minimum or maximum bounds.
	 * A value of <code>1</code> means that going beyond the minimum or
	 * maximum bounds is completely unrestrained.
	 *
	 * <p>In the following example, the elasticity of throwing beyond the
	 * scroller's edges is customized:</p>
	 *
	 * <listing version="3.0">
	 * scroller.throwElasticity = 0.1;</listing>
	 *
	 * @default 0.05
	 *
	 * @see #style:hasElasticEdges
	 * @see #style:elasticity
	 */
	[Style(name="throwElasticity",type="Number")]

	/**
	 * If <code>true</code>, the duration of a "throw" animation will be the
	 * same no matter the value of the throw's initial velocity. This value
	 * may be set to <code>false</code> to have the scroller calculate a
	 * variable duration based on the velocity of the throw.
	 *
	 * <p>It may seem unintuitive, but using the same fixed duration for any
	 * velocity is recommended if you are looking to closely match the
	 * behavior of native scrolling on iOS.</p>
	 *
	 * <p>In the following example, the behavior of a "throw" animation is
	 * changed:</p>
	 *
	 * <listing version="3.0">
	 * scroller.useFixedThrowDuration = false;</listing>
	 *
	 * @default true
	 *
	 * @see #style:decelerationRate
	 */
	[Style(name="useFixedThrowDuration",type="Boolean")]

	/**
	 * Determines where the vertical scroll bar will be positioned.
	 *
	 * <p>In the following example, the scroll bars is positioned on the left:</p>
	 *
	 * <listing version="3.0">
	 * scroller.verticalScrollBarPosition = RelativePosition.LEFT;</listing>
	 *
	 * @default feathers.layout.RelativePosition.RIGHT
	 *
	 * @see feathers.layout.RelativePosition#RIGHT
	 * @see feathers.layout.RelativePosition#LEFT
	 */
	[Style(name="verticalScrollBarPosition",type="String")]

	/**
	 * Dispatched when the scroller scrolls in either direction or when the view
	 * port's scrolling bounds have changed. Listen for <code>FeathersEventType.SCROLL_START</code>
	 * to know when scrolling starts as a result of user interaction or when
	 * scrolling is triggered by an animation. Similarly, listen for
	 * <code>FeathersEventType.SCROLL_COMPLETE</code> to know when the scrolling
	 * ends.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.SCROLL
	 * @see #event:scrollStart feathers.events.FeathersEventType.SCROLL_START
	 * @see #event:scrollComplete feathers.events.FeathersEventType.SCROLL_COMPLETE
	 */
	[Event(name="scroll",type="starling.events.Event")]

	/**
	 * Dispatched when the scroller starts scrolling in either direction
	 * as a result of either user interaction or animation.
	 *
	 * <p>Note: If <code>horizontalScrollPosition</code> or <code>verticalScrollPosition</code>
	 * is set manually (in other words, the scrolling is not triggered by user
	 * interaction or an animated scroll), no <code>FeathersEventType.SCROLL_START</code>
	 * or <code>FeathersEventType.SCROLL_COMPLETE</code> events will be
	 * dispatched.</p>
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.SCROLL_START
	 * @see #event:scrollComplete feathers.events.FeathersEventType.SCROLL_COMPLETE
	 * @see #event:scroll feathers.events.FeathersEventType.SCROLL
	 */
	[Event(name="scrollStart",type="starling.events.Event")]

	/**
	 * Dispatched when the scroller finishes scrolling in either direction
	 * as a result of either user interaction or animation. Animations may not
	 * end at the same time that user interaction ends, so the event may be
	 * delayed if user interaction triggers scrolling again.
	 *
	 * <p>Note: If <code>horizontalScrollPosition</code> or <code>verticalScrollPosition</code>
	 * is set manually (in other words, the scrolling is not triggered by user
	 * interaction or an animated scroll), no <code>FeathersEventType.SCROLL_START</code>
	 * or <code>FeathersEventType.SCROLL_COMPLETE</code> events will be
	 * dispatched.</p>
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.SCROLL_COMPLETE
	 * @see #event:scrollStart feathers.events.FeathersEventType.SCROLL_START
	 * @see #event:scroll feathers.events.FeathersEventType.SCROLL
	 */
	[Event(name="scrollComplete",type="starling.events.Event")]

	/**
	 * Dispatched when the user starts dragging the scroller when
	 * <code>ScrollInteractionMode.TOUCH</code> is enabled or when the user
	 * starts interacting with the scroll bar.
	 *
	 * <p>Note: If <code>horizontalScrollPosition</code> or <code>verticalScrollPosition</code>
	 * is set manually (in other words, the scrolling is not triggered by user
	 * interaction), no <code>FeathersEventType.BEGIN_INTERACTION</code>
	 * or <code>FeathersEventType.END_INTERACTION</code> events will be
	 * dispatched.</p>
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.BEGIN_INTERACTION
	 * @see #event:endInteraction feathers.events.FeathersEventType.END_INTERACTION
	 * @see #event:scroll feathers.events.FeathersEventType.SCROLL
	 */
	[Event(name="beginInteraction",type="starling.events.Event")]

	/**
	 * Dispatched when the user stops dragging the scroller when
	 * <code>ScrollInteractionMode.TOUCH</code> is enabled or when the user
	 * stops interacting with the scroll bar. The scroller may continue
	 * scrolling after this event is dispatched if the user interaction has also
	 * triggered an animation.
	 *
	 * <p>Note: If <code>horizontalScrollPosition</code> or <code>verticalScrollPosition</code>
	 * is set manually (in other words, the scrolling is not triggered by user
	 * interaction), no <code>FeathersEventType.BEGIN_INTERACTION</code>
	 * or <code>FeathersEventType.END_INTERACTION</code> events will be
	 * dispatched.</p>
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.END_INTERACTION
	 * @see #event:beginInteraction feathers.events.FeathersEventType.BEGIN_INTERACTION
	 * @see #event:scroll feathers.events.FeathersEventType.SCROLL
	 */
	[Event(name="endInteraction",type="starling.events.Event")]

	/**
	 * Dispatched when the component receives focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_IN
	 */
	[Event(name="focusIn",type="starling.events.Event")]

	/**
	 * Dispatched when the component loses focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_OUT
	 */
	[Event(name="focusOut",type="starling.events.Event")]

	/**
	 * Dispatched when a pull view is activated.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The pull view that was activated.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.UPDATE
	 */
	[Event(name="update",type="starling.events.Event")]

	/**
	 * Allows horizontal and vertical scrolling of a <em>view port</em>. Not
	 * meant to be used as a standalone container or component. Generally meant
	 * to be the super class of another component that needs to support
	 * scrolling. To put components in a generic scrollable container (with
	 * optional layout), see <code>ScrollContainer</code>. To scroll long
	 * passages of text, see <code>ScrollText</code>.
	 *
	 * <p>This component is generally not instantiated directly. Instead it is
	 * typically used as a super class for other scrolling components like lists
	 * and containers. With that in mind, no code example is included here.</p>
	 *
	 * @see feathers.controls.ScrollContainer
	 *
	 * @productversion Feathers 1.1.0
	 */
	public class Scroller extends FeathersControl implements IFocusDisplayObject
	{
		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_SCROLL_BAR_RENDERER:String = "scrollBarRenderer";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_PENDING_SCROLL:String = "pendingScroll";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_PENDING_REVEAL_SCROLL_BARS:String = "pendingRevealScrollBars";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_PENDING_PULL_VIEW:String = "pendingPullView";

		/**
		 * Flag to indicate that the clipping has changed.
		 */
		protected static const INVALIDATION_FLAG_CLIPPING:String = "clipping";

		/**
		 * @private
		 * The point where we stop calculating velocity changes because floating
		 * point issues can start to appear.
		 */
		private static const MINIMUM_VELOCITY:Number = 0.02;

		/**
		 * @private
		 * The current velocity is given high importance.
		 */
		private static const CURRENT_VELOCITY_WEIGHT:Number = 2.33;

		/**
		 * @private
		 * Older saved velocities are given less importance.
		 */
		private static const VELOCITY_WEIGHTS:Vector.<Number> = new <Number>[1, 1.33, 1.66, 2];

		/**
		 * @private
		 */
		private static const MAXIMUM_SAVED_VELOCITY_COUNT:int = 4;

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * horizontal scroll bar.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_HORIZONTAL_SCROLL_BAR:String = "feathers-scroller-horizontal-scroll-bar";

		/**
		 * The default value added to the <code>styleNameList</code> of the vertical
		 * scroll bar.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_VERTICAL_SCROLL_BAR:String = "feathers-scroller-vertical-scroll-bar";

		/**
		 * @private
		 */
		protected static const PAGE_INDEX_EPSILON:Number = 0.01;

		/**
		 * @private
		 */
		protected static function defaultScrollBarFactory():IScrollBar
		{
			return new SimpleScrollBar();
		}

		/**
		 * @private
		 */
		protected static function defaultThrowEase(ratio:Number):Number
		{
			ratio -= 1;
			return 1 - ratio * ratio * ratio * ratio;
		}

		/**
		 * Constructor.
		 */
		public function Scroller()
		{
			super();

			this.addEventListener(Event.ADDED_TO_STAGE, scroller_addedToStageHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, scroller_removedFromStageHandler);
		}

		/**
		 * The value added to the <code>styleNameList</code> of the horizontal
		 * scroll bar. This variable is <code>protected</code> so that
		 * sub-classes can customize the horizontal scroll bar style name in
		 * their constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_HORIZONTAL_SCROLL_BAR</code>.
		 *
		 * <p>To customize the horizontal scroll bar style name without
		 * subclassing, see <code>customHorizontalScrollBarStyleName</code>.</p>
		 *
		 * @see #style:customHorizontalScrollBarStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var horizontalScrollBarStyleName:String = DEFAULT_CHILD_STYLE_NAME_HORIZONTAL_SCROLL_BAR;

		/**
		 * The value added to the <code>styleNameList</code> of the vertical
		 * scroll bar. This variable is <code>protected</code> so that
		 * sub-classes can customize the vertical scroll bar style name in their
		 * constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_VERTICAL_SCROLL_BAR</code>.
		 *
		 * <p>To customize the vertical scroll bar style name without
		 * subclassing, see <code>customVerticalScrollBarStyleName</code>.</p>
		 *
		 * @see #style:customVerticalScrollBarStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var verticalScrollBarStyleName:String = DEFAULT_CHILD_STYLE_NAME_VERTICAL_SCROLL_BAR;

		/**
		 * The horizontal scrollbar instance. May be null.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #horizontalScrollBarFactory
		 * @see #createScrollBars()
		 */
		protected var horizontalScrollBar:IScrollBar;

		/**
		 * The vertical scrollbar instance. May be null.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #verticalScrollBarFactory
		 * @see #createScrollBars()
		 */
		protected var verticalScrollBar:IScrollBar;

		/**
		 * @private
		 */
		override public function get isFocusEnabled():Boolean
		{
			return (this._maxVerticalScrollPosition != this._minVerticalScrollPosition ||
				this._maxHorizontalScrollPosition != this._minHorizontalScrollPosition) &&
				super.isFocusEnabled;
		}

		/**
		 * @private
		 */
		protected var _topViewPortOffset:Number;

		/**
		 * @private
		 */
		protected var _rightViewPortOffset:Number;

		/**
		 * @private
		 */
		protected var _bottomViewPortOffset:Number;

		/**
		 * @private
		 */
		protected var _leftViewPortOffset:Number;

		/**
		 * @private
		 */
		protected var _hasHorizontalScrollBar:Boolean = false;

		/**
		 * @private
		 */
		protected var _hasVerticalScrollBar:Boolean = false;

		/**
		 * @private
		 */
		protected var _horizontalScrollBarTouchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _verticalScrollBarTouchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _startTouchX:Number;

		/**
		 * @private
		 */
		protected var _startTouchY:Number;

		/**
		 * @private
		 */
		protected var _startHorizontalScrollPosition:Number;

		/**
		 * @private
		 */
		protected var _startVerticalScrollPosition:Number;

		/**
		 * @private
		 */
		protected var _currentTouchX:Number;

		/**
		 * @private
		 */
		protected var _currentTouchY:Number;

		/**
		 * @private
		 */
		protected var _previousTouchTime:int;

		/**
		 * @private
		 */
		protected var _previousTouchX:Number;

		/**
		 * @private
		 */
		protected var _previousTouchY:Number;

		/**
		 * @private
		 */
		protected var _velocityX:Number = 0;

		/**
		 * @private
		 */
		protected var _velocityY:Number = 0;

		/**
		 * @private
		 */
		protected var _previousVelocityX:Vector.<Number> = new <Number>[];

		/**
		 * @private
		 */
		protected var _previousVelocityY:Vector.<Number> = new <Number>[];

		/**
		 * @private
		 */
		protected var _pendingVelocityChange:Boolean = false;

		/**
		 * @private
		 */
		protected var _lastViewPortWidth:Number = 0;

		/**
		 * @private
		 */
		protected var _lastViewPortHeight:Number = 0;

		/**
		 * @private
		 */
		protected var _hasViewPortBoundsChanged:Boolean = false;

		/**
		 * @private
		 */
		protected var _horizontalAutoScrollTween:Tween;

		/**
		 * @private
		 */
		protected var _verticalAutoScrollTween:Tween;

		/**
		 * @private
		 */
		protected var _topPullTween:Tween;

		/**
		 * @private
		 */
		protected var _rightPullTween:Tween;

		/**
		 * @private
		 */
		protected var _bottomPullTween:Tween;

		/**
		 * @private
		 */
		protected var _leftPullTween:Tween;

		/**
		 * @private
		 */
		protected var _isDraggingHorizontally:Boolean = false;

		/**
		 * @private
		 */
		protected var _isDraggingVertically:Boolean = false;

		/**
		 * @private
		 */
		protected var ignoreViewPortResizing:Boolean = false;

		/**
		 * @private
		 */
		protected var _viewPort:IViewPort;

		/**
		 * The display object displayed and scrolled within the Scroller.
		 *
		 * @default null
		 */
		public function get viewPort():IViewPort
		{
			return this._viewPort;
		}

		/**
		 * @private
		 */
		public function set viewPort(value:IViewPort):void
		{
			if(this._viewPort == value)
			{
				return;
			}
			if(this._viewPort !== null)
			{
				this._viewPort.removeEventListener(FeathersEventType.RESIZE, viewPort_resizeHandler);
				this.removeRawChildInternal(DisplayObject(this._viewPort));
			}
			this._viewPort = value;
			if(this._viewPort !== null)
			{
				this._viewPort.addEventListener(FeathersEventType.RESIZE, viewPort_resizeHandler);
				this.addRawChildAtInternal(DisplayObject(this._viewPort), 0);
				if(this._viewPort is IFeathersControl)
				{
					IFeathersControl(this._viewPort).initializeNow();
				}
				this._explicitViewPortWidth = this._viewPort.explicitWidth;
				this._explicitViewPortHeight = this._viewPort.explicitHeight;
				this._explicitViewPortMinWidth = this._viewPort.explicitMinWidth;
				this._explicitViewPortMinHeight = this._viewPort.explicitMinHeight;
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _explicitViewPortWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitViewPortHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitViewPortMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitViewPortMinHeight:Number;

		/**
		 * @private
		 */
		protected var _measureViewPort:Boolean = true;

		/**
		 * Determines if the dimensions of the view port are used when measuring
		 * the scroller. If disabled, only children other than the view port
		 * (such as the background skin) are used for measurement.
		 *
		 * <p>In the following example, the view port measurement is disabled:</p>
		 *
		 * <listing version="3.0">
		 * scroller.measureViewPort = false;</listing>
		 *
		 * @default true
		 */
		public function get measureViewPort():Boolean
		{
			return this._measureViewPort;
		}

		/**
		 * @private
		 */
		public function set measureViewPort(value:Boolean):void
		{
			if(this._measureViewPort == value)
			{
				return;
			}
			this._measureViewPort = value;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _snapToPages:Boolean = false;

		/**
		 * @private
		 */
		public function get snapToPages():Boolean
		{
			return this._snapToPages;
		}

		/**
		 * @private
		 */
		public function set snapToPages(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._snapToPages === value)
			{
				return;
			}
			this._snapToPages = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		/**
		 * @private
		 */
		protected var _snapOnComplete:Boolean = false;

		/**
		 * @private
		 */
		protected var _horizontalScrollBarFactory:Function = defaultScrollBarFactory;

		/**
		 * Creates the horizontal scroll bar. The horizontal scroll bar must be
		 * an instance of <code>IScrollBar</code>. This factory can be used to
		 * change properties on the horizontal scroll bar when it is first
		 * created. For instance, if you are skinning Feathers components
		 * without a theme, you might use this factory to set skins and other
		 * styles on the horizontal scroll bar.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 *
		 * <pre>function():IScrollBar</pre>
		 *
		 * <p>In the following example, a custom horizontal scroll bar factory
		 * is passed to the scroller:</p>
		 *
		 * <listing version="3.0">
		 * scroller.horizontalScrollBarFactory = function():IScrollBar
		 * {
		 *     return new ScrollBar();
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.IScrollBar
		 */
		public function get horizontalScrollBarFactory():Function
		{
			return this._horizontalScrollBarFactory;
		}

		/**
		 * @private
		 */
		public function set horizontalScrollBarFactory(value:Function):void
		{
			if(this._horizontalScrollBarFactory == value)
			{
				return;
			}
			this._horizontalScrollBarFactory = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL_BAR_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _customHorizontalScrollBarStyleName:String;

		/**
		 * @private
		 */
		public function get customHorizontalScrollBarStyleName():String
		{
			return this._customHorizontalScrollBarStyleName;
		}

		/**
		 * @private
		 */
		public function set customHorizontalScrollBarStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customHorizontalScrollBarStyleName === value)
			{
				return;
			}
			this._customHorizontalScrollBarStyleName = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL_BAR_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _horizontalScrollBarProperties:PropertyProxy;

		/**
		 * An object that stores properties for the container's horizontal
		 * scroll bar, and the properties will be passed down to the horizontal
		 * scroll bar when the container validates. The available properties
		 * depend on which <code>IScrollBar</code> implementation is returned
		 * by <code>horizontalScrollBarFactory</code>. Refer to
		 * <a href="IScrollBar.html"><code>feathers.controls.IScrollBar</code></a>
		 * for a list of available scroll bar implementations.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>horizontalScrollBarFactory</code>
		 * function instead of using <code>horizontalScrollBarProperties</code>
		 * will result in better performance.</p>
		 *
		 * <p>In the following example, properties for the horizontal scroll bar
		 * are passed to the scroller:</p>
		 *
		 * <listing version="3.0">
		 * scroller.horizontalScrollBarProperties.liveDragging = false;</listing>
		 *
		 * @default null
		 *
		 * @see #horizontalScrollBarFactory
		 * @see feathers.controls.IScrollBar
		 * @see feathers.controls.SimpleScrollBar
		 * @see feathers.controls.ScrollBar
		 */
		public function get horizontalScrollBarProperties():Object
		{
			if(!this._horizontalScrollBarProperties)
			{
				this._horizontalScrollBarProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._horizontalScrollBarProperties;
		}

		/**
		 * @private
		 */
		public function set horizontalScrollBarProperties(value:Object):void
		{
			if(this._horizontalScrollBarProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._horizontalScrollBarProperties)
			{
				this._horizontalScrollBarProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._horizontalScrollBarProperties = PropertyProxy(value);
			if(this._horizontalScrollBarProperties)
			{
				this._horizontalScrollBarProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _verticalScrollBarPosition:String = RelativePosition.RIGHT;

		[Inspectable(type="String",enumeration="right,left")]
		/**
		 * @private
		 */
		public function get verticalScrollBarPosition():String
		{
			return this._verticalScrollBarPosition;
		}

		/**
		 * @private
		 */
		public function set verticalScrollBarPosition(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._verticalScrollBarPosition === value)
			{
				return;
			}
			this._verticalScrollBarPosition = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}
		/**
		 * @private
		 */
		protected var _horizontalScrollBarPosition:String = RelativePosition.BOTTOM;

		[Inspectable(type="String",enumeration="bottom,top")]
		/**
		 * @private
		 */
		public function get horizontalScrollBarPosition():String
		{
			return this._horizontalScrollBarPosition;
		}

		/**
		 * @private
		 */
		public function set horizontalScrollBarPosition(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._horizontalScrollBarPosition === value)
			{
				return;
			}
			this._horizontalScrollBarPosition = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _verticalScrollBarFactory:Function = defaultScrollBarFactory;

		/**
		 * Creates the vertical scroll bar. The vertical scroll bar must be an
		 * instance of <code>Button</code>. This factory can be used to change
		 * properties on the vertical scroll bar when it is first created. For
		 * instance, if you are skinning Feathers components without a theme,
		 * you might use this factory to set skins and other styles on the
		 * vertical scroll bar.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 *
		 * <pre>function():IScrollBar</pre>
		 *
		 * <p>In the following example, a custom vertical scroll bar factory
		 * is passed to the scroller:</p>
		 *
		 * <listing version="3.0">
		 * scroller.verticalScrollBarFactory = function():IScrollBar
		 * {
		 *     return new ScrollBar();
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.IScrollBar
		 */
		public function get verticalScrollBarFactory():Function
		{
			return this._verticalScrollBarFactory;
		}

		/**
		 * @private
		 */
		public function set verticalScrollBarFactory(value:Function):void
		{
			if(this._verticalScrollBarFactory == value)
			{
				return;
			}
			this._verticalScrollBarFactory = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL_BAR_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _customVerticalScrollBarStyleName:String;

		/**
		 * @private
		 */
		public function get customVerticalScrollBarStyleName():String
		{
			return this._customVerticalScrollBarStyleName;
		}

		/**
		 * @private
		 */
		public function set customVerticalScrollBarStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customVerticalScrollBarStyleName === value)
			{
				return;
			}
			this._customVerticalScrollBarStyleName = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL_BAR_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _verticalScrollBarProperties:PropertyProxy;

		/**
		 * An object that stores properties for the container's vertical scroll
		 * bar, and the properties will be passed down to the vertical scroll
		 * bar when the container validates. The available properties depend on
		 * which <code>IScrollBar</code> implementation is returned by
		 * <code>verticalScrollBarFactory</code>. Refer to
		 * <a href="IScrollBar.html"><code>feathers.controls.IScrollBar</code></a>
		 * for a list of available scroll bar implementations.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>verticalScrollBarFactory</code>
		 * function instead of using <code>verticalScrollBarProperties</code>
		 * will result in better performance.</p>
		 *
		 * <p>In the following example, properties for the vertical scroll bar
		 * are passed to the container:</p>
		 *
		 * <listing version="3.0">
		 * scroller.verticalScrollBarProperties.liveDragging = false;</listing>
		 *
		 * @default null
		 *
		 * @see #verticalScrollBarFactory
		 * @see feathers.controls.IScrollBar
		 * @see feathers.controls.SimpleScrollBar
		 * @see feathers.controls.ScrollBar
		 */
		public function get verticalScrollBarProperties():Object
		{
			if(!this._verticalScrollBarProperties)
			{
				this._verticalScrollBarProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._verticalScrollBarProperties;
		}

		/**
		 * @private
		 */
		public function set verticalScrollBarProperties(value:Object):void
		{
			if(this._horizontalScrollBarProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._verticalScrollBarProperties)
			{
				this._verticalScrollBarProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._verticalScrollBarProperties = PropertyProxy(value);
			if(this._verticalScrollBarProperties)
			{
				this._verticalScrollBarProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var actualHorizontalScrollStep:Number = 1;

		/**
		 * @private
		 */
		protected var explicitHorizontalScrollStep:Number = NaN;

		/**
		 * The number of pixels the horizontal scroll position can be adjusted
		 * by a "step". Passed to the horizontal scroll bar, if one exists.
		 * Touch scrolling is not affected by the step value.
		 *
		 * <p>In the following example, the horizontal scroll step is customized:</p>
		 *
		 * <listing version="3.0">
		 * scroller.horizontalScrollStep = 0;</listing>
		 *
		 * @default NaN
		 */
		public function get horizontalScrollStep():Number
		{
			return this.actualHorizontalScrollStep;
		}

		/**
		 * @private
		 */
		public function set horizontalScrollStep(value:Number):void
		{
			if(this.explicitHorizontalScrollStep == value)
			{
				return;
			}
			this.explicitHorizontalScrollStep = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		/**
		 * @private
		 */
		protected var _targetHorizontalScrollPosition:Number;

		/**
		 * @private
		 */
		protected var _horizontalScrollPosition:Number = 0;

		/**
		 * The number of pixels the container has been scrolled horizontally (on
		 * the x-axis).
		 *
		 * <p>In the following example, the horizontal scroll position is customized:</p>
		 *
		 * <listing version="3.0">
		 * scroller.horizontalScrollPosition = scroller.maxHorizontalScrollPosition;</listing>
		 *
		 * @see #minHorizontalScrollPosition
		 * @see #maxHorizontalScrollPosition
		 */
		public function get horizontalScrollPosition():Number
		{
			return this._horizontalScrollPosition;
		}

		/**
		 * @private
		 */
		public function set horizontalScrollPosition(value:Number):void
		{
			if(this._horizontalScrollPosition == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				//there isn't any recovery from this, so stop it early
				throw new ArgumentError("horizontalScrollPosition cannot be NaN.");
			}
			this._horizontalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		/**
		 * @private
		 */
		protected var _minHorizontalScrollPosition:Number = 0;

		/**
		 * The number of pixels the scroller may be scrolled horizontally to the
		 * left. This value is automatically calculated based on the bounds of
		 * the viewport. The <code>horizontalScrollPosition</code> property may
		 * have a lower value than the minimum due to elastic edges. However,
		 * once the user stops interacting with the scroller, it will
		 * automatically animate back to the maximum or minimum position.
		 *
		 * @see #horizontalScrollPosition
		 * @see #maxHorizontalScrollPosition
		 */
		public function get minHorizontalScrollPosition():Number
		{
			return this._minHorizontalScrollPosition;
		}

		/**
		 * @private
		 */
		protected var _maxHorizontalScrollPosition:Number = 0;

		/**
		 * The number of pixels the scroller may be scrolled horizontally to the
		 * right. This value is automatically calculated based on the bounds of
		 * the viewport. The <code>horizontalScrollPosition</code> property may
		 * have a higher value than the maximum due to elastic edges. However,
		 * once the user stops interacting with the scroller, it will
		 * automatically animate back to the maximum or minimum position.
		 *
		 * @see #horizontalScrollPosition
		 * @see #minHorizontalScrollPosition
		 */
		public function get maxHorizontalScrollPosition():Number
		{
			return this._maxHorizontalScrollPosition;
		}

		/**
		 * @private
		 */
		protected var _horizontalPageIndex:int = 0;

		/**
		 * The index of the horizontal page, if snapping is enabled. If snapping
		 * is disabled, the index will always be <code>0</code>.
		 * 
		 * @see #horizontalPageCount
		 * @see #minHorizontalPageIndex
		 * @see #maxHorizontalPageIndex
		 */
		public function get horizontalPageIndex():int
		{
			if(this.hasPendingHorizontalPageIndex)
			{
				return this.pendingHorizontalPageIndex;
			}
			return this._horizontalPageIndex;
		}

		/**
		 * @private
		 */
		public function set horizontalPageIndex(value:int):void
		{
			if(!this._snapToPages)
			{
				throw new IllegalOperationError("The horizontalPageIndex may not be set if snapToPages is false.");
			}
			this.hasPendingHorizontalPageIndex = false;
			this.pendingHorizontalScrollPosition = NaN;
			if(this._horizontalPageIndex == value)
			{
				return;
			}
			if(!this.isInvalid())
			{
				if(value < this._minHorizontalPageIndex)
				{
					value = this._minHorizontalPageIndex;
				}
				else if(value > this._maxHorizontalPageIndex)
				{
					value = this._maxHorizontalPageIndex;
				}
				this._horizontalScrollPosition = this.actualPageWidth * value;
			}
			else
			{
				//minimum and maximum values haven't been calculated yet, so we
				//need to wait for validation to change the scroll position
				this.hasPendingHorizontalPageIndex = true;
				this.pendingHorizontalPageIndex = value;
				this.pendingScrollDuration = 0;
			}
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		/**
		 * @private
		 */
		protected var _minHorizontalPageIndex:int = 0;

		/**
		 * The minimum horizontal page index that may be displayed by this
		 * container, if page snapping is enabled.
		 *
		 * @see #snapToPages
		 * @see #horizontalPageCount
		 * @see #maxHorizontalPageIndex
		 */
		public function get minHorizontalPageIndex():int
		{
			return this._minHorizontalPageIndex;
		}

		/**
		 * @private
		 */
		protected var _maxHorizontalPageIndex:int = 0;

		/**
		 * The maximum horizontal page index that may be displayed by this
		 * container, if page snapping is enabled.
		 *
		 * @see #snapToPages
		 * @see #horizontalPageCount
		 * @see #minHorizontalPageIndex
		 */
		public function get maxHorizontalPageIndex():int
		{
			return this._maxHorizontalPageIndex;
		}

		/**
		 * The number of horizontal pages, if snapping is enabled. If snapping
		 * is disabled, the page count will always be <code>1</code>.
		 *
		 * <p>If the scroller's view port supports infinite scrolling, this
		 * property will return <code>int.MAX_VALUE</code>, since an
		 * <code>int</code> cannot hold the value <code>Number.POSITIVE_INFINITY</code>.</p>
		 *
		 * @see #snapToPages
		 * @see #horizontalPageIndex
		 * @see #minHorizontalPageIndex
		 * @see #maxHorizontalPageIndex
		 */
		public function get horizontalPageCount():int
		{
			if(this._maxHorizontalPageIndex == int.MAX_VALUE ||
				this._minHorizontalPageIndex == int.MIN_VALUE)
			{
				return int.MAX_VALUE;
			}
			return this._maxHorizontalPageIndex - this._minHorizontalPageIndex + 1;
		}

		/**
		 * @private
		 */
		protected var _horizontalScrollPolicy:String = ScrollPolicy.AUTO;

		[Inspectable(type="String",enumeration="auto,on,off")]
		/**
		 * Determines whether the scroller may scroll horizontally (on the
		 * x-axis) or not.
		 *
		 * <p>In the following example, horizontal scrolling is disabled:</p>
		 *
		 * <listing version="3.0">
		 * scroller.horizontalScrollPolicy = ScrollPolicy.OFF;</listing>
		 *
		 * @default feathers.controls.ScrollPolicy.AUTO
		 *
		 * @see feathers.controls.ScrollPolicy#AUTO
		 * @see feathers.controls.ScrollPolicy#ON
		 * @see feathers.controls.ScrollPolicy#OFF
		 */
		public function get horizontalScrollPolicy():String
		{
			return this._horizontalScrollPolicy;
		}

		/**
		 * @private
		 */
		public function set horizontalScrollPolicy(value:String):void
		{
			if(this._horizontalScrollPolicy == value)
			{
				return;
			}
			this._horizontalScrollPolicy = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
			this.invalidate(INVALIDATION_FLAG_SCROLL_BAR_RENDERER);
		}

		/**
		 * @private
		 */
		protected var actualVerticalScrollStep:Number = 1;

		/**
		 * @private
		 */
		protected var explicitVerticalScrollStep:Number = NaN;

		/**
		 * The number of pixels the vertical scroll position can be adjusted
		 * by a "step". Passed to the vertical scroll bar, if one exists.
		 * Touch scrolling is not affected by the step value.
		 *
		 * <p>In the following example, the vertical scroll step is customized:</p>
		 *
		 * <listing version="3.0">
		 * scroller.verticalScrollStep = 0;</listing>
		 *
		 * @default NaN
		 */
		public function get verticalScrollStep():Number
		{
			return this.actualVerticalScrollStep;
		}

		/**
		 * @private
		 */
		public function set verticalScrollStep(value:Number):void
		{
			if(this.explicitVerticalScrollStep == value)
			{
				return;
			}
			this.explicitVerticalScrollStep = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		/**
		 * @private
		 */
		protected var _verticalMouseWheelScrollStep:Number = NaN;

		/**
		 * The number of pixels the vertical scroll position can be adjusted by
		 * a "step" when using the mouse wheel. If this value is
		 * <code>NaN</code>, the mouse wheel will use the same scroll step as the scroll bars.
		 *
		 * <p>In the following example, the vertical mouse wheel scroll step is
		 * customized:</p>
		 *
		 * <listing version="3.0">
		 * scroller.verticalMouseWheelScrollStep = 10;</listing>
		 *
		 * @default NaN
		 */
		public function get verticalMouseWheelScrollStep():Number
		{
			return this._verticalMouseWheelScrollStep;
		}

		/**
		 * @private
		 */
		public function set verticalMouseWheelScrollStep(value:Number):void
		{
			if(this._verticalMouseWheelScrollStep == value)
			{
				return;
			}
			this._verticalMouseWheelScrollStep = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		/**
		 * @private
		 */
		protected var _targetVerticalScrollPosition:Number;

		/**
		 * @private
		 */
		protected var _verticalScrollPosition:Number = 0;

		/**
		 * The number of pixels the container has been scrolled vertically (on
		 * the y-axis).
		 *
		 * <p>In the following example, the vertical scroll position is customized:</p>
		 *
		 * <listing version="3.0">
		 * scroller.verticalScrollPosition = scroller.maxVerticalScrollPosition;</listing>
		 * 
		 * @see #minVerticalScrollPosition
		 * @see #maxVerticalScrollPosition
		 */
		public function get verticalScrollPosition():Number
		{
			return this._verticalScrollPosition;
		}

		/**
		 * @private
		 */
		public function set verticalScrollPosition(value:Number):void
		{
			if(this._verticalScrollPosition == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				//there isn't any recovery from this, so stop it early
				throw new ArgumentError("verticalScrollPosition cannot be NaN.");
			}
			this._verticalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		/**
		 * @private
		 */
		protected var _minVerticalScrollPosition:Number = 0;

		/**
		 * The number of pixels the scroller may be scrolled vertically beyond
		 * the top edge. This value is automatically calculated based on the
		 * bounds of the viewport. The <code>verticalScrollPosition</code>
		 * property may have a lower value than the minimum due to elastic
		 * edges. However, once the user stops interacting with the scroller, it
		 * will automatically animate back to the maximum or minimum position.
		 *
		 * @see #verticalScrollPosition
		 * @see #maxVerticalScrollPosition
		 */
		public function get minVerticalScrollPosition():Number
		{
			return this._minVerticalScrollPosition;
		}

		/**
		 * @private
		 */
		protected var _maxVerticalScrollPosition:Number = 0;

		/**
		 * The number of pixels the scroller may be scrolled vertically beyond
		 * the bottom edge. This value is automatically calculated based on the
		 * bounds of the viewport. The <code>verticalScrollPosition</code>
		 * property may have a lower value than the minimum due to elastic
		 * edges. However, once the user stops interacting with the scroller, it
		 * will automatically animate back to the maximum or minimum position.
		 *
		 * @see #verticalScrollPosition
		 * @see #minVerticalScrollPosition
		 */
		public function get maxVerticalScrollPosition():Number
		{
			return this._maxVerticalScrollPosition;
		}

		/**
		 * @private
		 */
		protected var _verticalPageIndex:int = 0;

		/**
		 * The index of the vertical page, if snapping is enabled. If snapping
		 * is disabled, the index will always be <code>0</code>.
		 *
		 * @see #verticalPageCount
		 * @see #minVerticalPageIndex
		 * @see #maxVerticalPageIndex
		 */
		public function get verticalPageIndex():int
		{
			if(this.hasPendingVerticalPageIndex)
			{
				return this.pendingVerticalPageIndex;
			}
			return this._verticalPageIndex;
		}

		/**
		 * @private
		 */
		public function set verticalPageIndex(value:int):void
		{
			if(!this._snapToPages)
			{
				throw new IllegalOperationError("The verticalPageIndex may not be set if snapToPages is false.");
			}
			this.hasPendingVerticalPageIndex = false;
			this.pendingVerticalScrollPosition = NaN;
			if(this._verticalPageIndex == value)
			{
				return;
			}
			if(!this.isInvalid())
			{
				if(value < this._minVerticalPageIndex)
				{
					value = this._minVerticalPageIndex;
				}
				else if(value > this._maxVerticalPageIndex)
				{
					value = this._maxVerticalPageIndex;
				}
				this._verticalScrollPosition = this.actualPageHeight * value;
			}
			else
			{
				//minimum and maximum values haven't been calculated yet, so we
				//need to wait for validation to change the scroll position
				this.hasPendingVerticalPageIndex = true;
				this.pendingVerticalPageIndex = value;
				this.pendingScrollDuration = 0;
			}
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		/**
		 * @private
		 */
		protected var _minVerticalPageIndex:int = 0;

		/**
		 * The minimum vertical page index that may be displayed by this
		 * container, if page snapping is enabled.
		 *
		 * @see #snapToPages
		 * @see #verticalPageCount
		 * @see #maxVerticalPageIndex
		 */
		public function get minVerticalPageIndex():int
		{
			return this._minVerticalPageIndex;
		}

		/**
		 * @private
		 */
		protected var _maxVerticalPageIndex:int = 0;

		/**
		 * The maximum vertical page index that may be displayed by this
		 * container, if page snapping is enabled.
		 *
		 * @see #snapToPages
		 * @see #verticalPageCount
		 * @see #minVerticalPageIndex
		 */
		public function get maxVerticalPageIndex():int
		{
			return this._maxVerticalPageIndex;
		}

		/**
		 * The number of vertical pages, if snapping is enabled. If snapping
		 * is disabled, the page count will always be <code>1</code>.
		 *
		 * <p>If the scroller's view port supports infinite scrolling, this
		 * property will return <code>int.MAX_VALUE</code>, since an
		 * <code>int</code> cannot hold the value <code>Number.POSITIVE_INFINITY</code>.</p>
		 *
		 * @see #snapToPages
		 * @see #verticalPageIndex
		 * @see #minVerticalPageIndex
		 * @see #maxVerticalPageIndex
		 */
		public function get verticalPageCount():int
		{
			if(this._maxVerticalPageIndex == int.MAX_VALUE ||
				this._minVerticalPageIndex == int.MIN_VALUE)
			{
				return int.MAX_VALUE;
			}
			return this._maxVerticalPageIndex - this._minVerticalPageIndex + 1;
		}

		/**
		 * @private
		 */
		protected var _verticalScrollPolicy:String = ScrollPolicy.AUTO;

		[Inspectable(type="String",enumeration="auto,on,off")]
		/**
		 * Determines whether the scroller may scroll vertically (on the
		 * y-axis) or not.
		 *
		 * <p>In the following example, vertical scrolling is disabled:</p>
		 *
		 * <listing version="3.0">
		 * scroller.verticalScrollPolicy = ScrollPolicy.OFF;</listing>
		 *
		 * @default feathers.controls.ScrollPolicy.AUTO
		 *
		 * @see feathers.controls.ScrollPolicy#AUTO
		 * @see feathers.controls.ScrollPolicy#ON
		 * @see feathers.controls.ScrollPolicy#OFF
		 */
		public function get verticalScrollPolicy():String
		{
			return this._verticalScrollPolicy;
		}

		/**
		 * @private
		 */
		public function set verticalScrollPolicy(value:String):void
		{
			if(this._verticalScrollPolicy == value)
			{
				return;
			}
			this._verticalScrollPolicy = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
			this.invalidate(INVALIDATION_FLAG_SCROLL_BAR_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _clipContent:Boolean = true;

		/**
		 * @private
		 */
		public function get clipContent():Boolean
		{
			return this._clipContent;
		}

		/**
		 * @private
		 */
		public function set clipContent(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._clipContent === value)
			{
				return;
			}
			this._clipContent = value;
			if(!value && this._viewPort)
			{
				this._viewPort.mask = null;
			}
			this.invalidate(INVALIDATION_FLAG_CLIPPING);
		}

		/**
		 * @private
		 */
		protected var actualPageWidth:Number = 0;

		/**
		 * @private
		 */
		protected var explicitPageWidth:Number = NaN;

		/**
		 * When set, the horizontal pages snap to this width value instead of
		 * the width of the scroller.
		 *
		 * <p>In the following example, the page width is set to 200 pixels:</p>
		 *
		 * <listing version="3.0">
		 * scroller.pageWidth = 200;</listing>
		 *
		 * @see #snapToPages
		 */
		public function get pageWidth():Number
		{
			return this.actualPageWidth;
		}

		/**
		 * @private
		 */
		public function set pageWidth(value:Number):void
		{
			if(this.explicitPageWidth == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN && this.explicitPageWidth !== this.explicitPageWidth) //isNaN
			{
				return;
			}
			this.explicitPageWidth = value;
			if(valueIsNaN)
			{
				//we need to calculate this value during validation
				this.actualPageWidth = 0;
			}
			else
			{
				this.actualPageWidth = this.explicitPageWidth;
			}
		}

		/**
		 * @private
		 */
		protected var actualPageHeight:Number = 0;

		/**
		 * @private
		 */
		protected var explicitPageHeight:Number = NaN;

		/**
		 * When set, the vertical pages snap to this height value instead of
		 * the height of the scroller.
		 *
		 * <p>In the following example, the page height is set to 200 pixels:</p>
		 *
		 * <listing version="3.0">
		 * scroller.pageHeight = 200;</listing>
		 *
		 * @see #snapToPages
		 */
		public function get pageHeight():Number
		{
			return this.actualPageHeight;
		}

		/**
		 * @private
		 */
		public function set pageHeight(value:Number):void
		{
			if(this.explicitPageHeight == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN && this.explicitPageHeight !== this.explicitPageHeight) //isNaN
			{
				return;
			}
			this.explicitPageHeight = value;
			if(valueIsNaN)
			{
				//we need to calculate this value during validation
				this.actualPageHeight = 0;
			}
			else
			{
				this.actualPageHeight = this.explicitPageHeight;
			}
		}

		/**
		 * @private
		 */
		protected var _hasElasticEdges:Boolean = true;

		/**
		 * @private
		 */
		public function get hasElasticEdges():Boolean
		{
			return this._hasElasticEdges;
		}

		/**
		 * @private
		 */
		public function set hasElasticEdges(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._hasElasticEdges = value;
		}

		/**
		 * @private
		 */
		protected var _elasticity:Number = 0.33;

		/**
		 * @private
		 */
		public function get elasticity():Number
		{
			return this._elasticity;
		}

		/**
		 * @private
		 */
		public function set elasticity(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._elasticity = value;
		}

		/**
		 * @private
		 */
		protected var _throwElasticity:Number = 0.05;

		/**
		 * @private
		 */
		public function get throwElasticity():Number
		{
			return this._throwElasticity;
		}

		/**
		 * @private
		 */
		public function set throwElasticity(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._throwElasticity = value;
		}

		/**
		 * @private
		 */
		protected var _scrollBarDisplayMode:String = ScrollBarDisplayMode.FLOAT;

		[Inspectable(type="String",enumeration="float,fixed,fixedFloat,none")]
		/**
		 * @private
		 */
		public function get scrollBarDisplayMode():String
		{
			return this._scrollBarDisplayMode;
		}

		/**
		 * @private
		 */
		public function set scrollBarDisplayMode(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._scrollBarDisplayMode === value)
			{
				return;
			}
			this._scrollBarDisplayMode = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL_BAR_RENDERER);
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _interactionMode:String = ScrollInteractionMode.TOUCH;

		[Inspectable(type="String",enumeration="touch,mouse,touchAndScrollBars")]
		/**
		 * @private
		 */
		public function get interactionMode():String
		{
			return this._interactionMode;
		}

		/**
		 * @private
		 */
		public function set interactionMode(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._interactionMode === value)
			{
				return;
			}
			this._interactionMode = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _explicitBackgroundWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxHeight:Number;

		/**
		 * @private
		 */
		protected var currentBackgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		protected var _backgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundSkin():DisplayObject
		{
			return this._backgroundSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundSkin === value)
			{
				return;
			}
			if(this._backgroundSkin !== null &&
				this.currentBackgroundSkin === this._backgroundSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _backgroundDisabledSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundDisabledSkin():DisplayObject
		{
			return this._backgroundDisabledSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundDisabledSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundDisabledSkin === value)
			{
				return;
			}
			if(this._backgroundDisabledSkin !== null &&
				this.currentBackgroundSkin === this._backgroundDisabledSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundDisabledSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundDisabledSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _autoHideBackground:Boolean = false;

		/**
		 * @private
		 */
		public function get autoHideBackground():Boolean
		{
			return this._autoHideBackground;
		}

		/**
		 * @private
		 */
		public function set autoHideBackground(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._autoHideBackground === value)
			{
				return;
			}
			this._autoHideBackground = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _minimumDragDistance:Number = 0.04;

		/**
		 * The minimum physical distance (in inches) that a touch must move
		 * before the scroller starts scrolling.
		 *
		 * <p>In the following example, the minimum drag distance is customized:</p>
		 *
		 * <listing version="3.0">
		 * scroller.minimumDragDistance = 0.1;</listing>
		 *
		 * @default 0.04
		 */
		public function get minimumDragDistance():Number
		{
			return this._minimumDragDistance;
		}

		/**
		 * @private
		 */
		public function set minimumDragDistance(value:Number):void
		{
			this._minimumDragDistance = value;
		}

		/**
		 * @private
		 */
		protected var _minimumPageThrowVelocity:Number = 5;

		/**
		 * The minimum physical velocity (in inches per second) that a touch
		 * must move before the scroller will "throw" to the next page.
		 * Otherwise, it will settle to the nearest page.
		 *
		 * <p>In the following example, the minimum page throw velocity is customized:</p>
		 *
		 * <listing version="3.0">
		 * scroller.minimumPageThrowVelocity = 2;</listing>
		 *
		 * @default 5
		 */
		public function get minimumPageThrowVelocity():Number
		{
			return this._minimumPageThrowVelocity;
		}

		/**
		 * @private
		 */
		public function set minimumPageThrowVelocity(value:Number):void
		{
			this._minimumPageThrowVelocity = value;
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _horizontalScrollBarHideTween:Tween;

		/**
		 * @private
		 */
		protected var _verticalScrollBarHideTween:Tween;

		/**
		 * @private
		 */
		protected var _hideScrollBarAnimationDuration:Number = 0.2;

		/**
		 * @private
		 */
		public function get hideScrollBarAnimationDuration():Number
		{
			return this._hideScrollBarAnimationDuration;
		}

		/**
		 * @private
		 */
		public function set hideScrollBarAnimationDuration(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._hideScrollBarAnimationDuration = value;
		}

		/**
		 * @private
		 */
		protected var _hideScrollBarAnimationEase:Object = Transitions.EASE_OUT;

		/**
		 * @private
		 */
		public function get hideScrollBarAnimationEase():Object
		{
			return this._hideScrollBarAnimationEase;
		}

		/**
		 * @private
		 */
		public function set hideScrollBarAnimationEase(value:Object):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._hideScrollBarAnimationEase = value;
		}

		/**
		 * @private
		 */
		protected var _elasticSnapDuration:Number = 0.5;

		/**
		 * @private
		 */
		public function get elasticSnapDuration():Number
		{
			return this._elasticSnapDuration;
		}

		/**
		 * @private
		 */
		public function set elasticSnapDuration(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._elasticSnapDuration = value;
		}

		/**
		 * @private
		 * This value is precalculated. See the <code>decelerationRate</code>
		 * setter for the dynamic calculation.
		 */
		protected var _logDecelerationRate:Number = -0.0020020026706730793;

		/**
		 * @private
		 */
		protected var _decelerationRate:Number = DecelerationRate.NORMAL;

		/**
		 * @private
		 */
		public function get decelerationRate():Number
		{
			return this._decelerationRate;
		}

		/**
		 * @private
		 */
		public function set decelerationRate(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._decelerationRate == value)
			{
				return;
			}
			this._decelerationRate = value;
			this._logDecelerationRate = Math.log(this._decelerationRate);
			this._fixedThrowDuration = -0.1 / Math.log(Math.pow(this._decelerationRate, 1000 / 60));
		}

		/**
		 * @private
		 * This value is precalculated. See the <code>decelerationRate</code>
		 * setter for the dynamic calculation.
		 */
		protected var _fixedThrowDuration:Number = 2.996998998998728;

		/**
		 * @private
		 */
		protected var _useFixedThrowDuration:Boolean = true;

		/**
		 * @private
		 */
		public function get useFixedThrowDuration():Boolean
		{
			return this._useFixedThrowDuration;
		}

		/**
		 * @private
		 */
		public function set useFixedThrowDuration(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._useFixedThrowDuration = value;
		}

		/**
		 * @private
		 */
		protected var _pageThrowDuration:Number = 0.5;

		/**
		 * @private
		 */
		public function get pageThrowDuration():Number
		{
			return this._pageThrowDuration;
		}

		/**
		 * @private
		 */
		public function set pageThrowDuration(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._pageThrowDuration = value;
		}

		/**
		 * @private
		 */
		protected var _mouseWheelScrollDuration:Number = 0.35;

		/**
		 * @private
		 */
		public function get mouseWheelScrollDuration():Number
		{
			return this._mouseWheelScrollDuration;
		}

		/**
		 * @private
		 */
		public function set mouseWheelScrollDuration(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._mouseWheelScrollDuration = value;
		}

		/**
		 * @private
		 */
		protected var _verticalMouseWheelScrollDirection:String = Direction.VERTICAL;

		/**
		 * The direction of scrolling when the user scrolls the mouse wheel
		 * vertically. In some cases, it is common for a container that only
		 * scrolls horizontally to scroll even when the mouse wheel is scrolled
		 * vertically.
		 *
		 * <p>In the following example, the direction of scrolling when using
		 * the mouse wheel is changed:</p>
		 *
		 * <listing version="3.0">
		 * scroller.verticalMouseWheelScrollDirection = Direction.HORIZONTAL;</listing>
		 *
		 * @default feathers.layout.Direction.VERTICAL
		 *
		 * @see feathers.layout.Direction#HORIZONTAL
		 * @see feathers.layout.Direction#VERTICAL
		 */
		public function get verticalMouseWheelScrollDirection():String
		{
			return this._verticalMouseWheelScrollDirection;
		}

		/**
		 * @private
		 */
		public function set verticalMouseWheelScrollDirection(value:String):void
		{
			this._verticalMouseWheelScrollDirection = value;
		}

		/**
		 * @private
		 */
		protected var _throwEase:Object = defaultThrowEase;

		/**
		 * @private
		 */
		public function get throwEase():Object
		{
			return this._throwEase;
		}

		/**
		 * @private
		 */
		public function set throwEase(value:Object):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(value == null)
			{
				value = defaultThrowEase;
			}
			this._throwEase = value;
		}

		/**
		 * @private
		 */
		protected var _snapScrollPositionsToPixels:Boolean = true;

		/**
		 * @private
		 */
		public function get snapScrollPositionsToPixels():Boolean
		{
			return this._snapScrollPositionsToPixels;
		}

		/**
		 * @private
		 */
		public function set snapScrollPositionsToPixels(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._snapScrollPositionsToPixels === value)
			{
				return;
			}
			this._snapScrollPositionsToPixels = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		/**
		 * @private
		 */
		protected var _horizontalScrollBarIsScrolling:Boolean = false;

		/**
		 * @private
		 */
		protected var _verticalScrollBarIsScrolling:Boolean = false;

		/**
		 * @private
		 */
		protected var _isScrolling:Boolean = false;

		/**
		 * Determines if the scroller is currently scrolling with user
		 * interaction or with animation.
		 */
		public function get isScrolling():Boolean
		{
			return this._isScrolling;
		}

		/**
		 * @private
		 */
		protected var _isScrollingStopped:Boolean = false;

		/**
		 * The pending horizontal scroll position to scroll to after validating.
		 * A value of <code>NaN</code> means that the scroller won't scroll to a
		 * horizontal position after validating.
		 */
		protected var pendingHorizontalScrollPosition:Number = NaN;

		/**
		 * The pending vertical scroll position to scroll to after validating.
		 * A value of <code>NaN</code> means that the scroller won't scroll to a
		 * vertical position after validating.
		 */
		protected var pendingVerticalScrollPosition:Number = NaN;

		/**
		 * A flag that indicates if the scroller should scroll to a new page
		 * when it validates. If <code>true</code>, it will use the value of
		 * <code>pendingHorizontalPageIndex</code> as the target page index.
		 * 
		 * @see #pendingHorizontalPageIndex
		 */
		protected var hasPendingHorizontalPageIndex:Boolean = false;

		/**
		 * A flag that indicates if the scroller should scroll to a new page
		 * when it validates. If <code>true</code>, it will use the value of
		 * <code>pendingVerticalPageIndex</code> as the target page index.
		 *
		 * @see #pendingVerticalPageIndex
		 */
		protected var hasPendingVerticalPageIndex:Boolean = false;

		/**
		 * The pending horizontal page index to scroll to after validating. The
		 * flag <code>hasPendingHorizontalPageIndex</code> must be set to true
		 * if there is a pending page index to scroll to.
		 * 
		 * @see #hasPendingHorizontalPageIndex
		 */
		protected var pendingHorizontalPageIndex:int;

		/**
		 * The pending vertical page index to scroll to after validating. The
		 * flag <code>hasPendingVerticalPageIndex</code> must be set to true
		 * if there is a pending page index to scroll to.
		 *
		 * @see #hasPendingVerticalPageIndex
		 */
		protected var pendingVerticalPageIndex:int;

		/**
		 * The duration of the pending scroll action.
		 */
		protected var pendingScrollDuration:Number;

		/**
		 * @private
		 */
		protected var isScrollBarRevealPending:Boolean = false;

		/**
		 * @private
		 */
		protected var _revealScrollBarsDuration:Number = 1.0;

		/**
		 * @private
		 */
		public function get revealScrollBarsDuration():Number
		{
			return this._revealScrollBarsDuration;
		}

		/**
		 * @private
		 */
		public function set revealScrollBarsDuration(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._revealScrollBarsDuration = value;
		}

		/**
		 * @private
		 */
		protected var _isTopPullViewPending:Boolean = false;

		/**
		 * @private
		 */
		protected var _isTopPullViewActive:Boolean = false;

		/**
		 * Indicates if the <code>topPullView</code> has been activated. Set to
		 * <code>false</code> to close the <code>topPullView</code>.
		 * 
		 * <p>Note: Manually setting <code>isTopPullViewActive</code> to
		 * <code>true</code> will not result in <code>Event.UPDATE</code> being
		 * dispatched.</p>
		 * 
		 * @see #topPullView
		 */
		public function get isTopPullViewActive():Boolean
		{
			return this._isTopPullViewActive;
		}

		/**
		 * @private
		 */
		public function set isTopPullViewActive(value:Boolean):void
		{
			if(this._isTopPullViewActive === value)
			{
				return;
			}
			if(this._topPullView === null)
			{
				return;
			}
			this._isTopPullViewActive = value;
			this._isTopPullViewPending = true;
			this.invalidate(INVALIDATION_FLAG_PENDING_PULL_VIEW);
		}

		/**
		 * @private
		 */
		protected var _topPullView:DisplayObject = null;

		/**
		 * A view that is displayed at the top of the scroller's view port when
		 * dragging down.
		 *
		 * <strong>Events</strong>
		 * 
		 * <p>The scroller will dispatch <code>FeathersEventType.PULLING</code>
		 * on the pull view as it is dragged into view. The event's
		 * <code>data</code> property will be a value between <code>0</code> and
		 * <code>1</code> to indicate how far the pull view has been dragged so
		 * far. A value of <code>1</code> does not necessarily indicate that
		 * the pull view has been activated yet. A value greater than
		 * <code>1</code> is possible if <code>hasElasticEdges</code> is
		 * <code>true</code>.</p>
		 * 
		 * <p>When the pull view is activated by the user, the scroller will
		 * dispatch <code>Event.UPDATE</code>. When the pull view should
		 * be deactivated, set the <code>isTopPullViewActive</code> property
		 * to <code>false</code>.</p>
		 * 
		 * @default null
		 *
		 * @see #isTopPullViewActive
		 * @see #topPullViewDisplayMode
		 * @see #event:update starling.events.Event.UPDATE
		 */
		public function get topPullView():DisplayObject
		{
			return this._topPullView;
		}

		/**
		 * @private
		 */
		public function set topPullView(value:DisplayObject):void
		{
			if(this._topPullView !== null)
			{
				this._topPullView.mask.dispose();
				this._topPullView.mask = null;
				if(this._topPullView.parent === this)
				{
					this.removeRawChildInternal(this._topPullView, false);
				}
			}
			this._topPullView = value;
			if(this._topPullView !== null)
			{
				this._topPullView.mask = new Quad(1, 1, 0xff00ff);
				this._topPullView.visible = false;
				this.addRawChildInternal(this._topPullView);
			}
			else
			{
				this.isTopPullViewActive = false;
			}
		}

		/**
		 * @private
		 */
		protected var _topPullViewDisplayMode:String = PullViewDisplayMode.DRAG;

		/**
		 * Indicates whether the top pull view may be dragged with the content,
		 * or if its position is fixed to the edge of the scroller.
		 *
		 * @default feathers.controls.PullViewDisplayMode.DRAG
		 *
		 * @see feathers.controls.PullViewDisplayMode#DRAG
		 * @see feathers.controls.PullViewDisplayMode#FIXED
		 * @see #topPullView
		 */
		public function get topPullViewDisplayMode():String
		{
			return this._topPullViewDisplayMode;
		}

		/**
		 * @private
		 */
		public function set topPullViewDisplayMode(value:String):void
		{
			if(this._topPullViewDisplayMode === value)
			{
				return;
			}
			this._topPullViewDisplayMode = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _topPullViewRatio:Number = 0;

		/**
		 * @private
		 */
		protected function get topPullViewRatio():Number
		{
			return this._topPullViewRatio;
		}

		/**
		 * @private
		 */
		protected function set topPullViewRatio(value:Number):void
		{
			if(this._topPullViewRatio == value)
			{
				return;
			}
			this._topPullViewRatio = value;
			if(!this._isTopPullViewActive && this._topPullView !== null)
			{
				this._topPullView.dispatchEventWith(FeathersEventType.PULLING, false, value);
			}
		}

		/**
		 * @private
		 */
		protected var _isRightPullViewPending:Boolean = false;

		/**
		 * @private
		 */
		protected var _isRightPullViewActive:Boolean = false;

		/**
		 * Indicates if the <code>rightPullView</code> has been activated. Set
		 * to <code>false</code> to close the <code>rightPullView</code>.
		 *
		 * <p>Note: Manually setting <code>isRightPullViewActive</code> to
		 * <code>true</code> will not result in <code>Event.UPDATE</code> being
		 * dispatched.</p>
		 *
		 * @see #rightPullView
		 */
		public function get isRightPullViewActive():Boolean
		{
			return this._isRightPullViewActive;
		}

		/**
		 * @private
		 */
		public function set isRightPullViewActive(value:Boolean):void
		{
			if(this._isRightPullViewActive === value)
			{
				return;
			}
			if(this._rightPullView === null)
			{
				return;
			}
			this._isRightPullViewActive = value;
			this._isRightPullViewPending = true;
			this.invalidate(INVALIDATION_FLAG_PENDING_PULL_VIEW);
		}

		/**
		 * @private
		 */
		protected var _rightPullView:DisplayObject = null;

		/**
		 * A view that is displayed to the right of the scroller's view port
		 * when dragging to the left.
		 *
		 * <strong>Events</strong>
		 *
		 * <p>The scroller will dispatch <code>FeathersEventType.PULLING</code>
		 * on the pull view as it is dragged into view. The event's
		 * <code>data</code> property will be a value between <code>0</code> and
		 * <code>1</code> to indicate how far the pull view has been dragged so
		 * far. A value of <code>1</code> does not necessarily indicate that
		 * the pull view has been activated yet. A value greater than
		 * <code>1</code> is possible if <code>hasElasticEdges</code> is
		 * <code>true</code>.</p>
		 *
		 * <p>When the pull view is activated by the user, the scroller will
		 * dispatch <code>Event.UPDATE</code>. When the pull view should
		 * be deactivated, set the <code>isRightPullViewActive</code> property
		 * to <code>false</code>.</p>
		 *
		 * @default null
		 *
		 * @see #isRightPullViewActive
		 * @see #rightPullViewDisplayMode
		 * @see #event:update starling.events.Event.UPDATE
		 */
		public function get rightPullView():DisplayObject
		{
			return this._rightPullView;
		}

		/**
		 * @private
		 */
		public function set rightPullView(value:DisplayObject):void
		{
			if(this._rightPullView !== null)
			{
				this._rightPullView.mask.dispose();
				this._rightPullView.mask = null;
				if(this._rightPullView.parent === this)
				{
					this.removeRawChildInternal(this._rightPullView, false);
				}
			}
			this._rightPullView = value;
			if(this._rightPullView !== null)
			{
				this._rightPullView.mask = new Quad(1, 1, 0xff00ff);
				this._rightPullView.visible = false;
				this.addRawChildInternal(this._rightPullView);
			}
			else
			{
				this.isRightPullViewActive = false;
			}
		}

		/**
		 * @private
		 */
		protected var _rightPullViewDisplayMode:String = PullViewDisplayMode.DRAG;

		/**
		 * Indicates whether the right pull view may be dragged with the
		 * content, or if its position is fixed to the edge of the scroller.
		 *
		 * @default feathers.controls.PullViewDisplayMode.DRAG
		 *
		 * @see feathers.controls.PullViewDisplayMode#DRAG
		 * @see feathers.controls.PullViewDisplayMode#FIXED
		 * @see #rightPullView
		 */
		public function get rightPullViewDisplayMode():String
		{
			return this._rightPullViewDisplayMode;
		}

		/**
		 * @private
		 */
		public function set rightPullViewDisplayMode(value:String):void
		{
			if(this._rightPullViewDisplayMode === value)
			{
				return;
			}
			this._rightPullViewDisplayMode = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _rightPullViewRatio:Number = 0;

		/**
		 * @private
		 */
		protected function get rightPullViewRatio():Number
		{
			return this._rightPullViewRatio;
		}

		/**
		 * @private
		 */
		protected function set rightPullViewRatio(value:Number):void
		{
			if(this._rightPullViewRatio == value)
			{
				return;
			}
			this._rightPullViewRatio = value;
			if(!this._isRightPullViewActive && this._rightPullView !== null)
			{
				this._rightPullView.dispatchEventWith(FeathersEventType.PULLING, false, value);
			}
		}

		/**
		 * @private
		 */
		protected var _isBottomPullViewPending:Boolean = false;

		/**
		 * @private
		 */
		protected var _isBottomPullViewActive:Boolean = false;

		/**
		 * Indicates if the <code>bottomPullView</code> has been activated. Set
		 * to <code>false</code> to close the <code>bottomPullView</code>.
		 *
		 * <p>Note: Manually setting <code>isBottomPullViewActive</code> to
		 * <code>true</code> will not result in <code>Event.UPDATE</code> being
		 * dispatched.</p>
		 *
		 * @see #bottomPullView
		 */
		public function get isBottomPullViewActive():Boolean
		{
			return this._isBottomPullViewActive;
		}

		/**
		 * @private
		 */
		public function set isBottomPullViewActive(value:Boolean):void
		{
			if(this._isBottomPullViewActive === value)
			{
				return;
			}
			if(this._bottomPullView === null)
			{
				return;
			}
			this._isBottomPullViewActive = value;
			this._isBottomPullViewPending = true;
			this.invalidate(INVALIDATION_FLAG_PENDING_PULL_VIEW);
		}

		/**
		 * @private
		 */
		protected var _bottomPullView:DisplayObject = null;

		/**
		 * A view that is displayed at the bottom of the scroller's view port
		 * when dragging up.
		 *
		 * <strong>Events</strong>
		 *
		 * <p>The scroller will dispatch <code>FeathersEventType.PULLING</code>
		 * on the pull view as it is dragged into view. The event's
		 * <code>data</code> property will be a value between <code>0</code> and
		 * <code>1</code> to indicate how far the pull view has been dragged so
		 * far. A value of <code>1</code> does not necessarily indicate that
		 * the pull view has been activated yet. A value greater than
		 * <code>1</code> is possible if <code>hasElasticEdges</code> is
		 * <code>true</code>.</p>
		 *
		 * <p>When the pull view is activated by the user, the scroller will
		 * dispatch <code>Event.UPDATE</code>. When the pull view should
		 * be deactivated, set the <code>isBottomPullViewActive</code> property
		 * to <code>false</code>.</p>
		 *
		 * @default null
		 *
		 * @see #isBottomPullViewActive
		 * @see #bottomPullViewDisplayMode
		 * @see #event:update starling.events.Event.UPDATE
		 */
		public function get bottomPullView():DisplayObject
		{
			return this._bottomPullView;
		}

		/**
		 * @private
		 */
		public function set bottomPullView(value:DisplayObject):void
		{
			if(this._bottomPullView !== null)
			{
				this._bottomPullView.mask.dispose();
				this._bottomPullView.mask = null;
				if(this._bottomPullView.parent === this)
				{
					this.removeRawChildInternal(this._bottomPullView, false);
				}
			}
			this._bottomPullView = value;
			if(this._bottomPullView !== null)
			{
				this._bottomPullView.mask = new Quad(1, 1, 0xff00ff);
				this._bottomPullView.visible = false;
				this.addRawChildInternal(this._bottomPullView);
			}
			else
			{
				this.isBottomPullViewActive = false;
			}
		}

		/**
		 * @private
		 */
		protected var _bottomPullViewDisplayMode:String = PullViewDisplayMode.DRAG;

		/**
		 * Indicates whether the bottom pull view may be dragged with the
		 * content, or if its position is fixed to the edge of the scroller.
		 *
		 * @default feathers.controls.PullViewDisplayMode.DRAG
		 *
		 * @see feathers.controls.PullViewDisplayMode#DRAG
		 * @see feathers.controls.PullViewDisplayMode#FIXED
		 * @see #bottomPullView
		 */
		public function get bottomPullViewDisplayMode():String
		{
			return this._bottomPullViewDisplayMode;
		}

		/**
		 * @private
		 */
		public function set bottomPullViewDisplayMode(value:String):void
		{
			if(this._bottomPullViewDisplayMode === value)
			{
				return;
			}
			this._bottomPullViewDisplayMode = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _bottomPullViewRatio:Number = 0;

		/**
		 * @private
		 */
		protected function get bottomPullViewRatio():Number
		{
			return this._bottomPullViewRatio;
		}

		/**
		 * @private
		 */
		protected function set bottomPullViewRatio(value:Number):void
		{
			if(this._bottomPullViewRatio == value)
			{
				return;
			}
			this._bottomPullViewRatio = value;
			if(!this._isBottomPullViewActive && this._bottomPullView !== null)
			{
				this._bottomPullView.dispatchEventWith(FeathersEventType.PULLING, false, value);
			}
		}

		/**
		 * @private
		 */
		protected var _isLeftPullViewPending:Boolean = false;

		/**
		 * @private
		 */
		protected var _isLeftPullViewActive:Boolean = false;

		/**
		 * Indicates if the <code>leftPullView</code> has been activated. Set to
		 * <code>false</code> to close the <code>leftPullView</code>.
		 *
		 * <p>Note: Manually setting <code>isLeftpPullViewActive</code> to
		 * <code>true</code> will not result in <code>Event.UPDATE</code> being
		 * dispatched.</p>
		 *
		 * @see #leftPullView
		 */
		public function get isLeftPullViewActive():Boolean
		{
			return this._isLeftPullViewActive;
		}

		/**
		 * @private
		 */
		public function set isLeftPullViewActive(value:Boolean):void
		{
			if(this._isLeftPullViewActive === value)
			{
				return;
			}
			if(this._leftPullView === null)
			{
				return;
			}
			this._isLeftPullViewActive = value;
			this._isLeftPullViewPending = true;
			this.invalidate(INVALIDATION_FLAG_PENDING_PULL_VIEW);
		}

		/**
		 * @private
		 */
		protected var _leftPullView:DisplayObject = null;

		/**
		 * A view that is displayed to the left of the scroller's view port
		 * when dragging to the right.
		 *
		 * <strong>Events</strong>
		 *
		 * <p>The scroller will dispatch <code>FeathersEventType.PULLING</code>
		 * on the pull view as it is dragged into view. The event's
		 * <code>data</code> property will be a value between <code>0</code> and
		 * <code>1</code> to indicate how far the pull view has been dragged so
		 * far. A value of <code>1</code> does not necessarily indicate that
		 * the pull view has been activated yet. A value greater than
		 * <code>1</code> is possible if <code>hasElasticEdges</code> is
		 * <code>true</code>.</p>
		 *
		 * <p>When the pull view is activated by the user, the scroller will
		 * dispatch <code>Event.UPDATE</code>. When the pull view should
		 * be deactivated, set the <code>isLeftPullViewActive</code> property
		 * to <code>false</code>.</p>
		 *
		 * @default null
		 *
		 * @see #isLeftPullViewActive
		 * @see #leftPullViewDisplayMode
		 * @see #event:update starling.events.Event.UPDATE
		 */
		public function get leftPullView():DisplayObject
		{
			return this._leftPullView;
		}

		/**
		 * @private
		 */
		public function set leftPullView(value:DisplayObject):void
		{
			if(this._leftPullView !== null)
			{
				this._leftPullView.mask.dispose();
				this._leftPullView.mask = null;
				if(this._leftPullView.parent === this)
				{
					this.removeRawChildInternal(this._leftPullView, false);
				}
			}
			this._leftPullView = value;
			if(this._leftPullView !== null)
			{
				this._leftPullView.mask = new Quad(1, 1, 0xff00ff);
				this._leftPullView.visible = false;
				this.addRawChildInternal(this._leftPullView);
			}
			else
			{
				this.isLeftPullViewActive = false;
			}
		}

		/**
		 * @private
		 */
		protected var _leftPullViewRatio:Number = 0;

		/**
		 * @private
		 */
		protected function get leftPullViewRatio():Number
		{
			return this._leftPullViewRatio;
		}

		/**
		 * @private
		 */
		protected function set leftPullViewRatio(value:Number):void
		{
			if(this._leftPullViewRatio == value)
			{
				return;
			}
			this._leftPullViewRatio = value;
			if(!this._isLeftPullViewActive && this._leftPullView !== null)
			{
				this._leftPullView.dispatchEventWith(FeathersEventType.PULLING, false, value);
			}
		}

		/**
		 * @private
		 */
		protected var _leftPullViewDisplayMode:String = PullViewDisplayMode.DRAG;

		/**
		 * Indicates whether the left pull view may be dragged with the content,
		 * or if its position is fixed to the edge of the scroller.
		 *
		 * @default feathers.controls.PullViewDisplayMode.DRAG
		 *
		 * @see feathers.controls.PullViewDisplayMode#DRAG
		 * @see feathers.controls.PullViewDisplayMode#FIXED
		 * @see #leftPullView
		 */
		public function get leftPullViewDisplayMode():String
		{
			return this._leftPullViewDisplayMode;
		}

		/**
		 * @private
		 */
		public function set leftPullViewDisplayMode(value:String):void
		{
			if(this._leftPullViewDisplayMode === value)
			{
				return;
			}
			this._leftPullViewDisplayMode = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _horizontalAutoScrollTweenEndRatio:Number = 1;

		/**
		 * @private
		 */
		protected var _verticalAutoScrollTweenEndRatio:Number = 1;

		/**
		 * @private
		 */
		override public function dispose():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			starling.nativeStage.removeEventListener(MouseEvent.MOUSE_WHEEL, nativeStage_mouseWheelHandler);
			starling.nativeStage.removeEventListener("orientationChange", nativeStage_orientationChangeHandler);

			//we don't dispose it if the scroller is the parent because it'll
			//already get disposed in super.dispose()
			if(this._backgroundSkin !== null &&
				this._backgroundSkin.parent !== this)
			{
				this._backgroundSkin.dispose();
			}
			if(this._backgroundDisabledSkin !== null &&
				this._backgroundDisabledSkin.parent !== this)
			{
				this._backgroundDisabledSkin.dispose();
			}
			super.dispose();
		}

		/**
		 * If the user is scrolling with touch or if the scrolling is animated,
		 * calling stopScrolling() will cause the scroller to ignore the drag
		 * and stop animations. This function may only be called during scrolling,
		 * so if you need to stop scrolling on a <code>TouchEvent</code> with
		 * <code>TouchPhase.BEGAN</code>, you may need to wait for the scroller
		 * to start scrolling before you can call this function.
		 *
		 * <p>In the following example, we listen for <code>FeathersEventType.SCROLL_START</code>
		 * to stop scrolling:</p>
		 *
		 * <listing version="3.0">
		 * scroller.addEventListener( FeathersEventType.SCROLL_START, function( event:Event ):void
		 * {
		 *     scroller.stopScrolling();
		 * });</listing>
		 */
		public function stopScrolling():void
		{
			if(this._horizontalAutoScrollTween)
			{
				Starling.juggler.remove(this._horizontalAutoScrollTween);
				this._horizontalAutoScrollTween = null;
			}
			if(this._verticalAutoScrollTween)
			{
				Starling.juggler.remove(this._verticalAutoScrollTween);
				this._verticalAutoScrollTween = null;
			}
			this._isScrollingStopped = true;
			this._velocityX = 0;
			this._velocityY = 0;
			this._previousVelocityX.length = 0;
			this._previousVelocityY.length = 0;
			this.hideHorizontalScrollBar();
			this.hideVerticalScrollBar();
		}

		/**
		 * After the next validation, animates the scroll positions to a
		 * specific location. May scroll in only one direction by passing in a
		 * value of <code>NaN</code> for either scroll position. If the
		 * <code>animationDuration</code> argument is <code>NaN</code> (the
		 * default value), the duration of a standard throw is used. The
		 * duration is in seconds.
		 *
		 * <p>Because this function is primarily designed for animation, using a
		 * duration of <code>0</code> may require a frame or two before the
		 * scroll position updates.</p>
		 *
		 * <p>In the following example, we scroll to the maximum vertical scroll
		 * position:</p>
		 *
		 * <listing version="3.0">
		 * scroller.scrollToPosition( scroller.horizontalScrollPosition, scroller.maxVerticalScrollPosition );</listing>
		 *
		 * @see #horizontalScrollPosition
		 * @see #verticalScrollPosition
		 * @see #throwEase
		 */
		public function scrollToPosition(horizontalScrollPosition:Number, verticalScrollPosition:Number, animationDuration:Number = NaN):void
		{
			if(animationDuration !== animationDuration) //isNaN
			{
				if(this._useFixedThrowDuration)
				{
					animationDuration = this._fixedThrowDuration;
				}
				else
				{
					var point:Point = Pool.getPoint(horizontalScrollPosition - this._horizontalScrollPosition, verticalScrollPosition - this._verticalScrollPosition);
					animationDuration = this.calculateDynamicThrowDuration(point.length * this._logDecelerationRate + MINIMUM_VELOCITY);
					Pool.putPoint(point);
				}
			}
			//cancel any pending scroll to a different page. we can have only
			//one type of pending scroll at a time.
			this.hasPendingHorizontalPageIndex = false;
			this.hasPendingVerticalPageIndex = false;
			if(this.pendingHorizontalScrollPosition == horizontalScrollPosition &&
				this.pendingVerticalScrollPosition == verticalScrollPosition &&
				this.pendingScrollDuration == animationDuration)
			{
				return;
			}
			this.pendingHorizontalScrollPosition = horizontalScrollPosition;
			this.pendingVerticalScrollPosition = verticalScrollPosition;
			this.pendingScrollDuration = animationDuration;
			this.invalidate(INVALIDATION_FLAG_PENDING_SCROLL);
		}

		/**
		 * After the next validation, animates the scroll position to a specific
		 * page index. To scroll in only one direction, pass in the value of the
		 * <code>horizontalPageIndex</code> or the
		 * <code>verticalPageIndex</code> property to the appropriate parameter.
		 * If the <code>animationDuration</code> argument is <code>NaN</code>
		 * (the default value) the value of the <code>pageThrowDuration</code>
		 * property is used for the duration. The duration is in seconds.
		 *
		 * <p>You can only scroll to a page if the <code>snapToPages</code>
		 * property is <code>true</code>.</p>
		 *
		 * <p>In the following example, we scroll to the last horizontal page:</p>
		 *
		 * <listing version="3.0">
		 * scroller.scrollToPageIndex( scroller.horizontalPageCount - 1, scroller.verticalPageIndex );</listing>
		 *
		 * @see #snapToPages
		 * @see #pageThrowDuration
		 * @see #throwEase
		 * @see #horizontalPageIndex
		 * @see #verticalPageIndex
		 */
		public function scrollToPageIndex(horizontalPageIndex:int, verticalPageIndex:int, animationDuration:Number = NaN):void
		{
			if(animationDuration !== animationDuration) //isNaN
			{
				animationDuration = this._pageThrowDuration;
			}
			//cancel any pending scroll to a specific scroll position. we can
			//have only one type of pending scroll at a time.
			this.pendingHorizontalScrollPosition = NaN;
			this.pendingVerticalScrollPosition = NaN;
			this.hasPendingHorizontalPageIndex = this._horizontalPageIndex !== horizontalPageIndex;
			this.hasPendingVerticalPageIndex = this._verticalPageIndex !== verticalPageIndex;
			if(!this.hasPendingHorizontalPageIndex && !this.hasPendingVerticalPageIndex)
			{
				return;
			}
			this.pendingHorizontalPageIndex = horizontalPageIndex;
			this.pendingVerticalPageIndex = verticalPageIndex;
			this.pendingScrollDuration = animationDuration;
			this.invalidate(INVALIDATION_FLAG_PENDING_SCROLL);
		}

		/**
		 * If the scroll bars are floating, briefly show them as a hint to the
		 * user. Useful when first navigating to a screen to give the user
		 * context about both the ability to scroll and the current scroll
		 * position.
		 *
		 * @see #revealScrollBarsDuration
		 */
		public function revealScrollBars():void
		{
			this.isScrollBarRevealPending = true;
			this.invalidate(INVALIDATION_FLAG_PENDING_REVEAL_SCROLL_BARS);
		}

		/**
		 * @private
		 */
		override public function hitTest(localPoint:Point):DisplayObject
		{
			//save localX and localY because localPoint could change after the
			//call to super.hitTest().
			var localX:Number = localPoint.x;
			var localY:Number = localPoint.y;
			//first check the children for touches
			var result:DisplayObject = super.hitTest(localPoint);
			if((this._isDraggingHorizontally || this._isDraggingVertically) &&
				this.viewPort is DisplayObjectContainer &&
				DisplayObjectContainer(this.viewPort).contains(result))
			{
				result = DisplayObject(this.viewPort);
			}
			if(result === null)
			{
				//we want to register touches in our hitArea as a last resort
				if(!this.visible || !this.touchable)
				{
					return null;
				}
				return this._hitArea.contains(localX, localY) ? this : null;
			}
			return result;
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			//we don't use this flag in this class, but subclasses will use it,
			//and it's better to handle it here instead of having them
			//invalidate unrelated flags
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			//similarly, this flag may be set in subclasses
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);
			var scrollInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SCROLL);
			var clippingInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_CLIPPING);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var scrollBarInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SCROLL_BAR_RENDERER);
			var pendingScrollInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_PENDING_SCROLL);
			var pendingRevealScrollBarsInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_PENDING_REVEAL_SCROLL_BARS);
			var pendingPullViewInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_PENDING_PULL_VIEW);

			if(scrollBarInvalid)
			{
				this.createScrollBars();
			}

			if(sizeInvalid || stylesInvalid || stateInvalid)
			{
				this.refreshBackgroundSkin();
			}

			if(scrollBarInvalid || stylesInvalid)
			{
				this.refreshScrollBarStyles();
				this.refreshInteractionModeEvents();
			}

			if(scrollBarInvalid || stateInvalid)
			{
				this.refreshEnabled();
			}

			if(this.horizontalScrollBar)
			{
				this.horizontalScrollBar.validate();
			}
			if(this.verticalScrollBar)
			{
				this.verticalScrollBar.validate();
			}

			var oldMaxHorizontalScrollPosition:Number = this._maxHorizontalScrollPosition;
			var oldMaxVerticalScrollPosition:Number = this._maxVerticalScrollPosition;
			var needsMeasurement:Boolean = (scrollInvalid && this._viewPort.requiresMeasurementOnScroll) ||
				dataInvalid || sizeInvalid || stylesInvalid || scrollBarInvalid || stateInvalid || layoutInvalid;
			this.refreshViewPort(needsMeasurement);
			if(oldMaxHorizontalScrollPosition != this._maxHorizontalScrollPosition)
			{
				this.refreshHorizontalAutoScrollTweenEndRatio();
				scrollInvalid = true;
			}
			if(oldMaxVerticalScrollPosition != this._maxVerticalScrollPosition)
			{
				this.refreshVerticalAutoScrollTweenEndRatio();
				scrollInvalid = true;
			}
			if(scrollInvalid)
			{
				this.dispatchEventWith(Event.SCROLL);
			}

			this.showOrHideChildren();
			this.layoutChildren();

			if(scrollInvalid || sizeInvalid || stylesInvalid || scrollBarInvalid)
			{
				this.refreshScrollBarValues();
			}

			if(needsMeasurement || scrollInvalid || clippingInvalid)
			{
				this.refreshMask();
			}
			this.refreshFocusIndicator();

			if(pendingScrollInvalid)
			{
				this.handlePendingScroll();
			}

			if(pendingRevealScrollBarsInvalid)
			{
				this.handlePendingRevealScrollBars();
			}

			if(pendingPullViewInvalid)
			{
				this.handlePendingPullView();
			}
		}

		/**
		 * @private
		 */
		protected function refreshViewPort(measure:Boolean):void
		{
			if(this._snapScrollPositionsToPixels)
			{
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				var pixelSize:Number = 1 / starling.contentScaleFactor;
				this._viewPort.horizontalScrollPosition = Math.round(this._horizontalScrollPosition / pixelSize) * pixelSize;
				this._viewPort.verticalScrollPosition = Math.round(this._verticalScrollPosition / pixelSize) * pixelSize;
			}
			else
			{
				this._viewPort.horizontalScrollPosition = this._horizontalScrollPosition;
				this._viewPort.verticalScrollPosition = this._verticalScrollPosition;
			}
			if(!measure)
			{
				this._viewPort.validate();
				this.refreshScrollValues();
				return;
			}
			var loopCount:int = 0;
			do
			{
				this._hasViewPortBoundsChanged = false;
				//if we don't need to do any measurement, we can skip
				//this stuff and improve performance
				if(this._measureViewPort)
				{
					this.calculateViewPortOffsets(true, false);
					this.refreshViewPortBoundsForMeasurement();
				}
				this.calculateViewPortOffsets(false, false);

				this.autoSizeIfNeeded();

				//just in case autoSizeIfNeeded() is overridden, we need to call
				//this again and use actualWidth/Height instead of
				//explicitWidth/Height.
				this.calculateViewPortOffsets(false, true);

				this.refreshViewPortBoundsForLayout();
				this.refreshScrollValues();
				loopCount++;
				if(loopCount >= 10)
				{
					//if it still fails after ten tries, we've probably entered
					//an infinite loop. it could be things like rounding errors,
					//layout issues, or custom item renderers that don't measure
					//correctly
					throw new Error(getQualifiedClassName(this) + " stuck in an infinite loop during measurement and validation. This may be an issue with the layout or children, such as custom item renderers.");
				}
			}
			while(this._hasViewPortBoundsChanged);
			this._lastViewPortWidth = this._viewPort.width;
			this._lastViewPortHeight = this._viewPort.height;
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			resetFluidChildDimensionsForMeasurement(this.currentBackgroundSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitBackgroundWidth, this._explicitBackgroundHeight,
				this._explicitBackgroundMinWidth, this._explicitBackgroundMinHeight,
				this._explicitBackgroundMaxWidth, this._explicitBackgroundMaxHeight);
			var measureBackground:IMeasureDisplayObject = this.currentBackgroundSkin as IMeasureDisplayObject;
			if(this.currentBackgroundSkin is IValidating)
			{
				IValidating(this.currentBackgroundSkin).validate();
			}

			var newWidth:Number = this._explicitWidth;
			var newHeight:Number = this._explicitHeight;
			var newMinWidth:Number = this._explicitMinWidth;
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsWidth)
			{
				if(this._measureViewPort)
				{
					newWidth = this._viewPort.visibleWidth;
				}
				else
				{
					newWidth = 0;
				}
				newWidth += this._rightViewPortOffset + this._leftViewPortOffset;
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.width > newWidth)
				{
					newWidth = this.currentBackgroundSkin.width;
				}
			}
			if(needsHeight)
			{
				if(this._measureViewPort)
				{
					newHeight = this._viewPort.visibleHeight;
				}
				else
				{
					newHeight = 0;
				}
				newHeight += this._bottomViewPortOffset + this._topViewPortOffset;
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.height > newHeight)
				{
					newHeight = this.currentBackgroundSkin.height;
				}
			}
			if(needsMinWidth)
			{
				if(this._measureViewPort)
				{
					newMinWidth = this._viewPort.minVisibleWidth;
				}
				else
				{
					newMinWidth = 0;
				}
				newMinWidth += this._rightViewPortOffset + this._leftViewPortOffset;
				if(this.currentBackgroundSkin !== null)
				{
					if(measureBackground !== null)
					{
						if(measureBackground.minWidth > newMinWidth)
						{
							newMinWidth = measureBackground.minWidth;
						}
					}
					else if(this._explicitBackgroundMinWidth > newMinWidth)
					{
						newMinWidth = this._explicitBackgroundMinWidth;
					}
				}
			}
			if(needsMinHeight)
			{
				if(this._measureViewPort)
				{
					newMinHeight = this._viewPort.minVisibleHeight;
				}
				else
				{
					newMinHeight = 0;
				}
				newMinHeight += this._bottomViewPortOffset + this._topViewPortOffset;
				if(this.currentBackgroundSkin !== null)
				{
					if(measureBackground !== null)
					{
						if(measureBackground.minHeight > newMinHeight)
						{
							newMinHeight = measureBackground.minHeight;
						}
					}
					else if(this._explicitBackgroundMinHeight > newMinHeight)
					{
						newMinHeight = this._explicitBackgroundMinHeight;
					}
				}
			}
			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * Creates and adds the <code>horizontalScrollBar</code> and
		 * <code>verticalScrollBar</code> sub-components and removes the old
		 * instances, if they exist.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #horizontalScrollBar
		 * @see #verticalScrollBar
		 * @see #horizontalScrollBarFactory
		 * @see #verticalScrollBarFactory
		 */
		protected function createScrollBars():void
		{
			if(this.horizontalScrollBar)
			{
				this.horizontalScrollBar.removeEventListener(FeathersEventType.BEGIN_INTERACTION, horizontalScrollBar_beginInteractionHandler);
				this.horizontalScrollBar.removeEventListener(FeathersEventType.END_INTERACTION, horizontalScrollBar_endInteractionHandler);
				this.horizontalScrollBar.removeEventListener(Event.CHANGE, horizontalScrollBar_changeHandler);
				this.removeRawChildInternal(DisplayObject(this.horizontalScrollBar), true);
				this.horizontalScrollBar = null;
			}
			if(this.verticalScrollBar)
			{
				this.verticalScrollBar.removeEventListener(FeathersEventType.BEGIN_INTERACTION, verticalScrollBar_beginInteractionHandler);
				this.verticalScrollBar.removeEventListener(FeathersEventType.END_INTERACTION, verticalScrollBar_endInteractionHandler);
				this.verticalScrollBar.removeEventListener(Event.CHANGE, verticalScrollBar_changeHandler);
				this.removeRawChildInternal(DisplayObject(this.verticalScrollBar), true);
				this.verticalScrollBar = null;
			}

			if(this._scrollBarDisplayMode != ScrollBarDisplayMode.NONE &&
				this._horizontalScrollPolicy != ScrollPolicy.OFF && this._horizontalScrollBarFactory != null)
			{
				this.horizontalScrollBar = IScrollBar(this._horizontalScrollBarFactory());
				if(this.horizontalScrollBar is IDirectionalScrollBar)
				{
					IDirectionalScrollBar(this.horizontalScrollBar).direction = Direction.HORIZONTAL;
				}
				var horizontalScrollBarStyleName:String = this._customHorizontalScrollBarStyleName != null ? this._customHorizontalScrollBarStyleName : this.horizontalScrollBarStyleName;
				this.horizontalScrollBar.styleNameList.add(horizontalScrollBarStyleName);
				this.horizontalScrollBar.addEventListener(Event.CHANGE, horizontalScrollBar_changeHandler);
				this.horizontalScrollBar.addEventListener(FeathersEventType.BEGIN_INTERACTION, horizontalScrollBar_beginInteractionHandler);
				this.horizontalScrollBar.addEventListener(FeathersEventType.END_INTERACTION, horizontalScrollBar_endInteractionHandler);
				this.addRawChildInternal(DisplayObject(this.horizontalScrollBar));
			}
			if(this._scrollBarDisplayMode != ScrollBarDisplayMode.NONE &&
				this._verticalScrollPolicy != ScrollPolicy.OFF && this._verticalScrollBarFactory != null)
			{
				this.verticalScrollBar = IScrollBar(this._verticalScrollBarFactory());
				if(this.verticalScrollBar is IDirectionalScrollBar)
				{
					IDirectionalScrollBar(this.verticalScrollBar).direction = Direction.VERTICAL;
				}
				var verticalScrollBarStyleName:String = this._customVerticalScrollBarStyleName != null ? this._customVerticalScrollBarStyleName : this.verticalScrollBarStyleName;
				this.verticalScrollBar.styleNameList.add(verticalScrollBarStyleName);
				this.verticalScrollBar.addEventListener(Event.CHANGE, verticalScrollBar_changeHandler);
				this.verticalScrollBar.addEventListener(FeathersEventType.BEGIN_INTERACTION, verticalScrollBar_beginInteractionHandler);
				this.verticalScrollBar.addEventListener(FeathersEventType.END_INTERACTION, verticalScrollBar_endInteractionHandler);
				this.addRawChildInternal(DisplayObject(this.verticalScrollBar));
			}
		}

		/**
		 * Choose the appropriate background skin based on the control's current
		 * state.
		 */
		protected function refreshBackgroundSkin():void
		{
			var newCurrentBackgroundSkin:DisplayObject = this.getCurrentBackgroundSkin();
			if(this.currentBackgroundSkin !== newCurrentBackgroundSkin)
			{
				this.removeCurrentBackgroundSkin(this.currentBackgroundSkin);
				this.currentBackgroundSkin = newCurrentBackgroundSkin;
				if(this.currentBackgroundSkin !== null)
				{
					if(this.currentBackgroundSkin is IFeathersControl)
					{
						IFeathersControl(this.currentBackgroundSkin).initializeNow();
					}
					if(this.currentBackgroundSkin is IMeasureDisplayObject)
					{
						var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this.currentBackgroundSkin);
						this._explicitBackgroundWidth = measureSkin.explicitWidth;
						this._explicitBackgroundHeight = measureSkin.explicitHeight;
						this._explicitBackgroundMinWidth = measureSkin.explicitMinWidth;
						this._explicitBackgroundMinHeight = measureSkin.explicitMinHeight;
						this._explicitBackgroundMaxWidth = measureSkin.explicitMaxWidth;
						this._explicitBackgroundMaxHeight = measureSkin.explicitMaxHeight;
					}
					else
					{
						this._explicitBackgroundWidth = this.currentBackgroundSkin.width;
						this._explicitBackgroundHeight = this.currentBackgroundSkin.height;
						this._explicitBackgroundMinWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMinHeight = this._explicitBackgroundHeight;
						this._explicitBackgroundMaxWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMaxHeight = this._explicitBackgroundHeight;
					}
					this.addRawChildAtInternal(this.currentBackgroundSkin, 0);
				}
			}
		}

		/**
		 * @private
		 */
		protected function getCurrentBackgroundSkin():DisplayObject
		{
			var newCurrentBackgroundSkin:DisplayObject = this._backgroundSkin;
			if(!this._isEnabled && this._backgroundDisabledSkin !== null)
			{
				newCurrentBackgroundSkin = this._backgroundDisabledSkin;
			}
			return newCurrentBackgroundSkin;
		}

		/**
		 * @private
		 */
		protected function removeCurrentBackgroundSkin(skin:DisplayObject):void
		{
			if(skin === null)
			{
				return;
			}
			if(skin.parent === this)
			{
				//we need to restore these values so that they won't be lost the
				//next time that this skin is used for measurement
				skin.width = this._explicitBackgroundWidth;
				skin.height = this._explicitBackgroundHeight;
				if(skin is IMeasureDisplayObject)
				{
					var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(skin);
					measureSkin.minWidth = this._explicitBackgroundMinWidth;
					measureSkin.minHeight = this._explicitBackgroundMinHeight;
					measureSkin.maxWidth = this._explicitBackgroundMaxWidth;
					measureSkin.maxHeight = this._explicitBackgroundMaxHeight;
				}
				this.removeRawChildInternal(skin);
			}
		}

		/**
		 * @private
		 */
		protected function refreshScrollBarStyles():void
		{
			if(this.horizontalScrollBar)
			{
				for(var propertyName:String in this._horizontalScrollBarProperties)
				{
					var propertyValue:Object = this._horizontalScrollBarProperties[propertyName];
					this.horizontalScrollBar[propertyName] = propertyValue;
				}
				if(this._horizontalScrollBarHideTween)
				{
					Starling.juggler.remove(this._horizontalScrollBarHideTween);
					this._horizontalScrollBarHideTween = null;
				}
				this.horizontalScrollBar.alpha = this._scrollBarDisplayMode == ScrollBarDisplayMode.FLOAT ? 0 : 1;
			}
			if(this.verticalScrollBar)
			{
				for(propertyName in this._verticalScrollBarProperties)
				{
					propertyValue = this._verticalScrollBarProperties[propertyName];
					this.verticalScrollBar[propertyName] = propertyValue;
				}
				if(this._verticalScrollBarHideTween)
				{
					Starling.juggler.remove(this._verticalScrollBarHideTween);
					this._verticalScrollBarHideTween = null;
				}
				this.verticalScrollBar.alpha = this._scrollBarDisplayMode == ScrollBarDisplayMode.FLOAT ? 0 : 1;
			}
		}

		/**
		 * @private
		 */
		protected function refreshEnabled():void
		{
			if(this._viewPort)
			{
				this._viewPort.isEnabled = this._isEnabled;
			}
			if(this.horizontalScrollBar)
			{
				this.horizontalScrollBar.isEnabled = this._isEnabled;
			}
			if(this.verticalScrollBar)
			{
				this.verticalScrollBar.isEnabled = this._isEnabled;
			}
		}

		/**
		 * @private
		 */
		override protected function refreshFocusIndicator():void
		{
			if(this._focusIndicatorSkin)
			{
				if(this._hasFocus && this._showFocus)
				{
					if(this._focusIndicatorSkin.parent != this)
					{
						this.addRawChildInternal(this._focusIndicatorSkin);
					}
					else
					{
						this.setRawChildIndexInternal(this._focusIndicatorSkin, this.numRawChildrenInternal - 1);
					}
				}
				else if(this._focusIndicatorSkin.parent == this)
				{
					this.removeRawChildInternal(this._focusIndicatorSkin, false);
				}
				this._focusIndicatorSkin.x = this._focusPaddingLeft;
				this._focusIndicatorSkin.y = this._focusPaddingTop;
				this._focusIndicatorSkin.width = this.actualWidth - this._focusPaddingLeft - this._focusPaddingRight;
				this._focusIndicatorSkin.height = this.actualHeight - this._focusPaddingTop - this._focusPaddingBottom;
			}
		}

		/**
		 * @private
		 */
		protected function refreshViewPortBoundsForMeasurement():void
		{
			var horizontalWidthOffset:Number = this._leftViewPortOffset + this._rightViewPortOffset;
			var verticalHeightOffset:Number = this._topViewPortOffset + this._bottomViewPortOffset;

			resetFluidChildDimensionsForMeasurement(this.currentBackgroundSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitBackgroundWidth, this._explicitBackgroundHeight,
				this._explicitBackgroundMinWidth, this._explicitBackgroundMinHeight,
				this._explicitBackgroundMaxWidth, this._explicitBackgroundMaxHeight);
			var measureBackground:IMeasureDisplayObject = this.currentBackgroundSkin as IMeasureDisplayObject;
			if(this.currentBackgroundSkin is IValidating)
			{
				IValidating(this.currentBackgroundSkin).validate();
			}

			//we account for the explicit minimum dimensions of the view port
			//and the minimum dimensions of the background skin because it helps
			//the final measurements stabilize faster.
			var viewPortMinWidth:Number = this._explicitMinWidth;
			if(viewPortMinWidth !== viewPortMinWidth || //isNaN
				this._explicitViewPortMinWidth > viewPortMinWidth)
			{
				viewPortMinWidth = this._explicitViewPortMinWidth;
			}
			if(viewPortMinWidth !== viewPortMinWidth || //isNaN
				this._explicitWidth > viewPortMinWidth)
			{
				viewPortMinWidth = this._explicitWidth;
			}
			if(this.currentBackgroundSkin !== null)
			{
				var backgroundMinWidth:Number = this.currentBackgroundSkin.width;
				if(measureBackground !== null)
				{
					backgroundMinWidth = measureBackground.minWidth;
				}
				if(viewPortMinWidth !== viewPortMinWidth || //isNaN
					backgroundMinWidth > viewPortMinWidth)
				{
					viewPortMinWidth = backgroundMinWidth;
				}
			}
			viewPortMinWidth -= horizontalWidthOffset;

			var viewPortMinHeight:Number = this._explicitMinHeight;
			if(viewPortMinHeight !== viewPortMinHeight || //isNaN
				this._explicitViewPortMinHeight > viewPortMinHeight)
			{
				viewPortMinHeight = this._explicitViewPortMinHeight;
			}
			if(viewPortMinHeight !== viewPortMinHeight || //isNaN
				this._explicitHeight > viewPortMinHeight)
			{
				viewPortMinHeight = this._explicitHeight;
			}
			if(this.currentBackgroundSkin !== null)
			{
				var backgroundMinHeight:Number = this.currentBackgroundSkin.height;
				if(measureBackground !== null)
				{
					backgroundMinHeight = measureBackground.minHeight;
				}
				if(viewPortMinHeight !== viewPortMinHeight || //isNaN
					backgroundMinHeight > viewPortMinHeight)
				{
					viewPortMinHeight = backgroundMinHeight;
				}
			}
			viewPortMinHeight -= verticalHeightOffset;

			var oldIgnoreViewPortResizing:Boolean = this.ignoreViewPortResizing;
			//setting some of the properties below may result in a resize
			//event, which forces another layout pass for the view port and
			//hurts performance (because it needs to break out of an
			//infinite loop)
			this.ignoreViewPortResizing = true;

			//if scroll bars are fixed, we're going to include the offsets even
			//if they may not be needed in the final pass. if not fixed, the
			//view port fills the entire bounds.
			this._viewPort.visibleWidth = this._explicitWidth - horizontalWidthOffset;
			this._viewPort.minVisibleWidth = this._explicitMinWidth - horizontalWidthOffset;
			this._viewPort.maxVisibleWidth = this._explicitMaxWidth - horizontalWidthOffset;
			this._viewPort.minWidth = viewPortMinWidth;

			this._viewPort.visibleHeight = this._explicitHeight - verticalHeightOffset;
			this._viewPort.minVisibleHeight = this._explicitMinHeight - verticalHeightOffset;
			this._viewPort.maxVisibleHeight = this._explicitMaxHeight - verticalHeightOffset;
			this._viewPort.minHeight = viewPortMinHeight;
			this._viewPort.validate();
			//we don't want to listen for a resize event from the view port
			//while it is validating this time. during the next validation is
			//where it matters if the view port resizes. 
			this.ignoreViewPortResizing = oldIgnoreViewPortResizing;
		}

		/**
		 * @private
		 */
		protected function refreshViewPortBoundsForLayout():void
		{
			var horizontalWidthOffset:Number = this._leftViewPortOffset + this._rightViewPortOffset;
			var verticalHeightOffset:Number = this._topViewPortOffset + this._bottomViewPortOffset;

			var oldIgnoreViewPortResizing:Boolean = this.ignoreViewPortResizing;
			//setting some of the properties below may result in a resize
			//event, which forces another layout pass for the view port and
			//hurts performance (because it needs to break out of an
			//infinite loop)
			this.ignoreViewPortResizing = true;

			var visibleWidth:Number = this.actualWidth - horizontalWidthOffset;
			//we'll only set the view port's visibleWidth and visibleHeight if
			//our dimensions are explicit. this allows the view port to know
			//whether it needs to re-measure on scroll.
			if(this._viewPort.visibleWidth != visibleWidth)
			{
				this._viewPort.visibleWidth = visibleWidth;
			}
			this._viewPort.minVisibleWidth = this.actualMinWidth - horizontalWidthOffset;
			this._viewPort.maxVisibleWidth = this._explicitMaxWidth - horizontalWidthOffset;
			this._viewPort.minWidth = visibleWidth;

			var visibleHeight:Number = this.actualHeight - verticalHeightOffset;
			if(this._viewPort.visibleHeight != visibleHeight)
			{
				this._viewPort.visibleHeight = visibleHeight;
			}
			this._viewPort.minVisibleHeight = this.actualMinHeight - verticalHeightOffset;
			this._viewPort.maxVisibleHeight = this._explicitMaxHeight - verticalHeightOffset;
			this._viewPort.minHeight = visibleHeight;

			//this time, we care whether a resize event is dispatched while the
			//view port is validating because it means we'll need to try another
			//measurement pass. we restore the flag before calling validate().
			this.ignoreViewPortResizing = oldIgnoreViewPortResizing;

			this._viewPort.validate();
		}

		/**
		 * @private
		 */
		protected function refreshScrollValues():void
		{
			this.refreshScrollSteps();

			var oldMaxHSP:Number = this._maxHorizontalScrollPosition;
			var oldMaxVSP:Number = this._maxVerticalScrollPosition;
			this.refreshMinAndMaxScrollPositions();
			var maximumPositionsChanged:Boolean = this._maxHorizontalScrollPosition != oldMaxHSP || this._maxVerticalScrollPosition != oldMaxVSP;
			if(maximumPositionsChanged && this._touchPointID < 0)
			{
				this.clampScrollPositions();
			}

			this.refreshPageCount();
			this.refreshPageIndices();
		}

		/**
		 * @private
		 */
		protected function clampScrollPositions():void
		{
			if(!this._horizontalAutoScrollTween)
			{
				if(this._snapToPages)
				{
					this._horizontalScrollPosition = roundToNearest(this._horizontalScrollPosition, this.actualPageWidth);
				}
				var targetHorizontalScrollPosition:Number = this._horizontalScrollPosition;
				if(targetHorizontalScrollPosition < this._minHorizontalScrollPosition)
				{
					targetHorizontalScrollPosition = this._minHorizontalScrollPosition;
				}
				else if(targetHorizontalScrollPosition > this._maxHorizontalScrollPosition)
				{
					targetHorizontalScrollPosition = this._maxHorizontalScrollPosition;
				}
				this.horizontalScrollPosition = targetHorizontalScrollPosition;
			}
			if(!this._verticalAutoScrollTween)
			{
				if(this._snapToPages)
				{
					this._verticalScrollPosition = roundToNearest(this._verticalScrollPosition, this.actualPageHeight);
				}
				var targetVerticalScrollPosition:Number = this._verticalScrollPosition;
				if(targetVerticalScrollPosition < this._minVerticalScrollPosition)
				{
					targetVerticalScrollPosition = this._minVerticalScrollPosition;
				}
				else if(targetVerticalScrollPosition > this._maxVerticalScrollPosition)
				{
					targetVerticalScrollPosition = this._maxVerticalScrollPosition;
				}
				this.verticalScrollPosition = targetVerticalScrollPosition;
			}
		}

		/**
		 * @private
		 */
		protected function refreshScrollSteps():void
		{
			if(this.explicitHorizontalScrollStep !== this.explicitHorizontalScrollStep) //isNaN
			{
				if(this._viewPort)
				{
					this.actualHorizontalScrollStep = this._viewPort.horizontalScrollStep;
				}
				else
				{
					this.actualHorizontalScrollStep = 1;
				}
			}
			else
			{
				this.actualHorizontalScrollStep = this.explicitHorizontalScrollStep;
			}
			if(this.explicitVerticalScrollStep !== this.explicitVerticalScrollStep) //isNaN
			{
				if(this._viewPort)
				{
					this.actualVerticalScrollStep = this._viewPort.verticalScrollStep;
				}
				else
				{
					this.actualVerticalScrollStep = 1;
				}
			}
			else
			{
				this.actualVerticalScrollStep = this.explicitVerticalScrollStep;
			}
		}

		/**
		 * @private
		 */
		protected function refreshMinAndMaxScrollPositions():void
		{
			var visibleViewPortWidth:Number = this.actualWidth - (this._leftViewPortOffset + this._rightViewPortOffset);
			var visibleViewPortHeight:Number = this.actualHeight - (this._topViewPortOffset + this._bottomViewPortOffset);
			if(this.explicitPageWidth !== this.explicitPageWidth) //isNaN
			{
				this.actualPageWidth = visibleViewPortWidth;
			}
			if(this.explicitPageHeight !== this.explicitPageHeight) //isNaN
			{
				this.actualPageHeight = visibleViewPortHeight;
			}
			if(this._viewPort)
			{
				this._minHorizontalScrollPosition = this._viewPort.contentX;
				if(this._viewPort.width == Number.POSITIVE_INFINITY)
				{
					//we don't want to risk the possibility of negative infinity
					//being added to positive infinity. the result is NaN.
					this._maxHorizontalScrollPosition = Number.POSITIVE_INFINITY;
				}
				else
				{
					this._maxHorizontalScrollPosition = this._minHorizontalScrollPosition + this._viewPort.width - visibleViewPortWidth;
				}
				if(this._maxHorizontalScrollPosition < this._minHorizontalScrollPosition)
				{
					this._maxHorizontalScrollPosition = this._minHorizontalScrollPosition;
				}
				this._minVerticalScrollPosition = this._viewPort.contentY;
				if(this._viewPort.height == Number.POSITIVE_INFINITY)
				{
					//we don't want to risk the possibility of negative infinity
					//being added to positive infinity. the result is NaN.
					this._maxVerticalScrollPosition = Number.POSITIVE_INFINITY;
				}
				else
				{
					this._maxVerticalScrollPosition = this._minVerticalScrollPosition + this._viewPort.height - visibleViewPortHeight;
				}
				if(this._maxVerticalScrollPosition < this._minVerticalScrollPosition)
				{
					this._maxVerticalScrollPosition =  this._minVerticalScrollPosition;
				}
			}
			else
			{
				this._minHorizontalScrollPosition = 0;
				this._minVerticalScrollPosition = 0;
				this._maxHorizontalScrollPosition = 0;
				this._maxVerticalScrollPosition = 0;
			}
		}

		/**
		 * @private
		 */
		protected function refreshPageCount():void
		{
			if(this._snapToPages)
			{
				var horizontalScrollRange:Number = this._maxHorizontalScrollPosition - this._minHorizontalScrollPosition;
				if(horizontalScrollRange == Number.POSITIVE_INFINITY)
				{
					//trying to put positive infinity into an int results in 0
					//so we need a special case to provide a large int value.
					if(this._minHorizontalScrollPosition == Number.NEGATIVE_INFINITY)
					{
						this._minHorizontalPageIndex = int.MIN_VALUE;
					}
					else
					{
						this._minHorizontalPageIndex = 0;
					}
					this._maxHorizontalPageIndex = int.MAX_VALUE;
				}
				else
				{
					this._minHorizontalPageIndex = 0;
					var unroundedPageIndex:Number = horizontalScrollRange / this.actualPageWidth;
					var nearestPageIndex:int = Math.round(unroundedPageIndex);
					if(MathUtil.isEquivalent(unroundedPageIndex, nearestPageIndex, PAGE_INDEX_EPSILON))
					{
						//we almost always want to round up, but a
						//floating point math error, or a page width that
						//isn't an integer (when snapping to pixels) could
						//cause the page index to be off by one
						this._maxHorizontalPageIndex = nearestPageIndex;
					}
					else
					{
						this._maxHorizontalPageIndex = Math.ceil(unroundedPageIndex);
					}
				}

				var verticalScrollRange:Number = this._maxVerticalScrollPosition - this._minVerticalScrollPosition;
				if(verticalScrollRange == Number.POSITIVE_INFINITY)
				{
					//trying to put positive infinity into an int results in 0
					//so we need a special case to provide a large int value.
					if(this._minVerticalScrollPosition == Number.NEGATIVE_INFINITY)
					{
						this._minVerticalPageIndex = int.MIN_VALUE;
					}
					else
					{
						this._minVerticalPageIndex = 0;
					}
					this._maxVerticalPageIndex = int.MAX_VALUE;
				}
				else
				{
					this._minVerticalPageIndex = 0;
					unroundedPageIndex = verticalScrollRange / this.actualPageHeight;
					nearestPageIndex = Math.round(unroundedPageIndex);
					if(MathUtil.isEquivalent(unroundedPageIndex, nearestPageIndex, PAGE_INDEX_EPSILON))
					{
						//we almost always want to round up, but a
						//floating point math error, or a page height that
						//isn't an integer (when snapping to pixels) could
						//cause the page index to be off by one
						this._maxVerticalPageIndex = nearestPageIndex;
					}
					else
					{
						this._maxVerticalPageIndex = Math.ceil(unroundedPageIndex);
					}
				}
			}
			else
			{
				this._maxHorizontalPageIndex = 0;
				this._maxHorizontalPageIndex = 0;
				this._minVerticalPageIndex = 0;
				this._maxVerticalPageIndex = 0;
			}
		}

		/**
		 * @private
		 */
		protected function refreshPageIndices():void
		{
			if(!this._horizontalAutoScrollTween && !this.hasPendingHorizontalPageIndex)
			{
				if(this._snapToPages)
				{
					if(this._horizontalScrollPosition == this._maxHorizontalScrollPosition)
					{
						this._horizontalPageIndex = this._maxHorizontalPageIndex;
					}
					else if(this._horizontalScrollPosition == this._minHorizontalScrollPosition)
					{
						this._horizontalPageIndex = this._minHorizontalPageIndex;
					}
					else
					{
						if(this._minHorizontalScrollPosition == Number.NEGATIVE_INFINITY && this._horizontalScrollPosition < 0)
						{
							var unroundedPageIndex:Number = this._horizontalScrollPosition / this.actualPageWidth;
						}
						else if(this._maxHorizontalScrollPosition == Number.POSITIVE_INFINITY && this._horizontalScrollPosition >= 0)
						{
							unroundedPageIndex = this._horizontalScrollPosition / this.actualPageWidth;
						}
						else
						{
							var adjustedHorizontalScrollPosition:Number = this._horizontalScrollPosition - this._minHorizontalScrollPosition;
							unroundedPageIndex = adjustedHorizontalScrollPosition / this.actualPageWidth;
						}
						var nearestPageIndex:int = Math.round(unroundedPageIndex);
						if(unroundedPageIndex != nearestPageIndex &&
							MathUtil.isEquivalent(unroundedPageIndex, nearestPageIndex, PAGE_INDEX_EPSILON))
						{
							//we almost always want to round down, but a
							//floating point math error, or a page width that
							//isn't an integer (when snapping to pixels) could
							//cause the page index to be off by one
							this._horizontalPageIndex = nearestPageIndex;
						}
						else
						{
							this._horizontalPageIndex = Math.floor(unroundedPageIndex);
						}
					}
				}
				else
				{
					this._horizontalPageIndex = this._minHorizontalPageIndex;
				}
				if(this._horizontalPageIndex < this._minHorizontalPageIndex)
				{
					this._horizontalPageIndex = this._minHorizontalPageIndex;
				}
				if(this._horizontalPageIndex > this._maxHorizontalPageIndex)
				{
					this._horizontalPageIndex = this._maxHorizontalPageIndex;
				}
			}
			if(!this._verticalAutoScrollTween && !this.hasPendingVerticalPageIndex)
			{
				if(this._snapToPages)
				{
					if(this._verticalScrollPosition == this._maxVerticalScrollPosition)
					{
						this._verticalPageIndex = this._maxVerticalPageIndex;
					}
					else if(this._verticalScrollPosition == this._minVerticalScrollPosition)
					{
						this._verticalPageIndex = this._minVerticalPageIndex;
					}
					else
					{
						if(this._minVerticalScrollPosition == Number.NEGATIVE_INFINITY && this._verticalScrollPosition < 0)
						{
							unroundedPageIndex = this._verticalScrollPosition / this.actualPageHeight;
						}
						else if(this._maxVerticalScrollPosition == Number.POSITIVE_INFINITY && this._verticalScrollPosition >= 0)
						{
							unroundedPageIndex = this._verticalScrollPosition / this.actualPageHeight;
						}
						else
						{
							var adjustedVerticalScrollPosition:Number = this._verticalScrollPosition - this._minVerticalScrollPosition;
							unroundedPageIndex = adjustedVerticalScrollPosition / this.actualPageHeight;
						}
						nearestPageIndex = Math.round(unroundedPageIndex);
						if(unroundedPageIndex != nearestPageIndex &&
							MathUtil.isEquivalent(unroundedPageIndex, nearestPageIndex, PAGE_INDEX_EPSILON))
						{
							//we almost always want to round down, but a
							//floating point math error, or a page height that
							//isn't an integer (when snapping to pixels) could
							//cause the page index to be off by one
							this._verticalPageIndex = nearestPageIndex;
						}
						else
						{
							this._verticalPageIndex = Math.floor(unroundedPageIndex);
						}
					}
				}
				else
				{
					this._verticalPageIndex = this._minVerticalScrollPosition;
				}
				if(this._verticalPageIndex < this._minVerticalScrollPosition)
				{
					this._verticalPageIndex = this._minVerticalScrollPosition;
				}
				if(this._verticalPageIndex > this._maxVerticalPageIndex)
				{
					this._verticalPageIndex = this._maxVerticalPageIndex;
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshScrollBarValues():void
		{
			if(this.horizontalScrollBar)
			{
				this.horizontalScrollBar.minimum = this._minHorizontalScrollPosition;
				this.horizontalScrollBar.maximum = this._maxHorizontalScrollPosition;
				this.horizontalScrollBar.value = this._horizontalScrollPosition;
				this.horizontalScrollBar.page = (this._maxHorizontalScrollPosition - this._minHorizontalScrollPosition) * this.actualPageWidth / this._viewPort.width;
				this.horizontalScrollBar.step = this.actualHorizontalScrollStep;
			}

			if(this.verticalScrollBar)
			{
				this.verticalScrollBar.minimum = this._minVerticalScrollPosition;
				this.verticalScrollBar.maximum = this._maxVerticalScrollPosition;
				this.verticalScrollBar.value = this._verticalScrollPosition;
				this.verticalScrollBar.page = (this._maxVerticalScrollPosition - this._minVerticalScrollPosition) * this.actualPageHeight / this._viewPort.height;
				this.verticalScrollBar.step = this.actualVerticalScrollStep;
			}
		}

		/**
		 * @private
		 */
		protected function showOrHideChildren():void
		{
			var childCount:int = this.numRawChildrenInternal;
			if(this.verticalScrollBar)
			{
				this.verticalScrollBar.visible = this._hasVerticalScrollBar;
				this.verticalScrollBar.touchable = this._hasVerticalScrollBar && this._interactionMode != ScrollInteractionMode.TOUCH;
				this.setRawChildIndexInternal(DisplayObject(this.verticalScrollBar), childCount - 1);
			}
			if(this.horizontalScrollBar)
			{
				this.horizontalScrollBar.visible = this._hasHorizontalScrollBar;
				this.horizontalScrollBar.touchable = this._hasHorizontalScrollBar && this._interactionMode != ScrollInteractionMode.TOUCH;
				if(this.verticalScrollBar)
				{
					this.setRawChildIndexInternal(DisplayObject(this.horizontalScrollBar), childCount - 2);
				}
				else
				{
					this.setRawChildIndexInternal(DisplayObject(this.horizontalScrollBar), childCount - 1);
				}
			}
			if(this.currentBackgroundSkin)
			{
				if(this._autoHideBackground)
				{
					this.currentBackgroundSkin.visible = this._viewPort.width <= this.actualWidth ||
						this._viewPort.height <= this.actualHeight ||
						this._horizontalScrollPosition < 0 ||
						this._horizontalScrollPosition > this._maxHorizontalScrollPosition ||
						this._verticalScrollPosition < 0 ||
						this._verticalScrollPosition > this._maxVerticalScrollPosition;
				}
				else
				{
					this.currentBackgroundSkin.visible = true;
				}
			}

		}

		/**
		 * @private
		 */
		protected function calculateViewPortOffsetsForFixedHorizontalScrollBar(forceScrollBars:Boolean = false, useActualBounds:Boolean = false):void
		{
			if(this.horizontalScrollBar && (this._measureViewPort || useActualBounds))
			{
				var scrollerWidth:Number = useActualBounds ? this.actualWidth : this._explicitWidth;
				if(!useActualBounds && !forceScrollBars &&
					scrollerWidth !== scrollerWidth) //isNaN
				{
					//even if explicitWidth is NaN, the view port might measure
					//a view port width smaller than its content width
					scrollerWidth = this._viewPort.visibleWidth + this._leftViewPortOffset + this._rightViewPortOffset;
				}
				var totalWidth:Number = this._viewPort.width + this._leftViewPortOffset + this._rightViewPortOffset;
				if(forceScrollBars || this._horizontalScrollPolicy === ScrollPolicy.ON ||
					((totalWidth > scrollerWidth || totalWidth > this._explicitMaxWidth) &&
						this._horizontalScrollPolicy !== ScrollPolicy.OFF))
				{
					this._hasHorizontalScrollBar = true;
					if(this._scrollBarDisplayMode === ScrollBarDisplayMode.FIXED)
					{
						if(this._horizontalScrollBarPosition === RelativePosition.TOP)
						{
							this._topViewPortOffset += this.horizontalScrollBar.height;
						}
						else
						{
							this._bottomViewPortOffset += this.horizontalScrollBar.height;
						}
					}
				}
				else
				{
					this._hasHorizontalScrollBar = false;
				}
			}
			else
			{
				this._hasHorizontalScrollBar = false;
			}
		}

		/**
		 * @private
		 */
		protected function calculateViewPortOffsetsForFixedVerticalScrollBar(forceScrollBars:Boolean = false, useActualBounds:Boolean = false):void
		{
			if(this.verticalScrollBar && (this._measureViewPort || useActualBounds))
			{
				var scrollerHeight:Number = useActualBounds ? this.actualHeight : this._explicitHeight;
				if(!useActualBounds && !forceScrollBars &&
					scrollerHeight !== scrollerHeight) //isNaN
				{
					//even if explicitHeight is NaN, the view port might measure
					//a view port height smaller than its content height
					scrollerHeight = this._viewPort.visibleHeight + this._topViewPortOffset + this._bottomViewPortOffset;
				}
				var totalHeight:Number = this._viewPort.height + this._topViewPortOffset + this._bottomViewPortOffset;
				if(forceScrollBars || this._verticalScrollPolicy === ScrollPolicy.ON ||
					((totalHeight > scrollerHeight || totalHeight > this._explicitMaxHeight) &&
						this._verticalScrollPolicy !== ScrollPolicy.OFF))
				{
					this._hasVerticalScrollBar = true;
					if(this._scrollBarDisplayMode === ScrollBarDisplayMode.FIXED)
					{
						if(this._verticalScrollBarPosition === RelativePosition.LEFT)
						{
							this._leftViewPortOffset += this.verticalScrollBar.width;
						}
						else
						{
							this._rightViewPortOffset += this.verticalScrollBar.width;
						}
					}
				}
				else
				{
					this._hasVerticalScrollBar = false;
				}
			}
			else
			{
				this._hasVerticalScrollBar = false;
			}
		}

		/**
		 * @private
		 */
		protected function calculateViewPortOffsets(forceScrollBars:Boolean = false, useActualBounds:Boolean = false):void
		{
			//in fixed mode, if we determine that scrolling is required, we
			//remember the offsets for later. if scrolling is not needed, then
			//we will ignore the offsets from here forward
			this._topViewPortOffset = this._paddingTop;
			this._rightViewPortOffset = this._paddingRight;
			this._bottomViewPortOffset = this._paddingBottom;
			this._leftViewPortOffset = this._paddingLeft;
			this.calculateViewPortOffsetsForFixedHorizontalScrollBar(forceScrollBars, useActualBounds);
			this.calculateViewPortOffsetsForFixedVerticalScrollBar(forceScrollBars, useActualBounds);
			//we need to double check the horizontal scroll bar if the scroll
			//bars are fixed because adding a vertical scroll bar may require a
			//horizontal one too.
			if(this._scrollBarDisplayMode == ScrollBarDisplayMode.FIXED &&
				this._hasVerticalScrollBar && !this._hasHorizontalScrollBar)
			{
				this.calculateViewPortOffsetsForFixedHorizontalScrollBar(forceScrollBars, useActualBounds);
			}
		}

		/**
		 * @private
		 */
		protected function refreshInteractionModeEvents():void
		{
			if(this._interactionMode == ScrollInteractionMode.TOUCH || this._interactionMode == ScrollInteractionMode.TOUCH_AND_SCROLL_BARS)
			{
				this.addEventListener(TouchEvent.TOUCH, scroller_touchHandler);
			}
			else
			{
				this.removeEventListener(TouchEvent.TOUCH, scroller_touchHandler);
			}

			if((this._interactionMode == ScrollInteractionMode.MOUSE || this._interactionMode == ScrollInteractionMode.TOUCH_AND_SCROLL_BARS) &&
				this._scrollBarDisplayMode == ScrollBarDisplayMode.FLOAT)
			{
				if(this.horizontalScrollBar)
				{
					this.horizontalScrollBar.addEventListener(TouchEvent.TOUCH, horizontalScrollBar_touchHandler);
				}
				if(this.verticalScrollBar)
				{
					this.verticalScrollBar.addEventListener(TouchEvent.TOUCH, verticalScrollBar_touchHandler);
				}
			}
			else
			{
				if(this.horizontalScrollBar)
				{
					this.horizontalScrollBar.removeEventListener(TouchEvent.TOUCH, horizontalScrollBar_touchHandler);
				}
				if(this.verticalScrollBar)
				{
					this.verticalScrollBar.removeEventListener(TouchEvent.TOUCH, verticalScrollBar_touchHandler);
				}
			}
		}

		/**
		 * Positions and sizes children based on the actual width and height
		 * values.
		 */
		protected function layoutChildren():void
		{
			var visibleWidth:Number = this.actualWidth - this._leftViewPortOffset - this._rightViewPortOffset;
			var visibleHeight:Number = this.actualHeight - this._topViewPortOffset - this._bottomViewPortOffset;

			if(this.currentBackgroundSkin !== null)
			{
				this.currentBackgroundSkin.width = this.actualWidth;
				this.currentBackgroundSkin.height = this.actualHeight;
			}

			if(this._snapScrollPositionsToPixels)
			{
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				var pixelSize:Number = 1 / starling.contentScaleFactor;
				this._viewPort.x = Math.round((this._leftViewPortOffset - this._horizontalScrollPosition) / pixelSize) * pixelSize;
				this._viewPort.y = Math.round((this._topViewPortOffset - this._verticalScrollPosition) / pixelSize) * pixelSize;
			}
			else
			{
				this._viewPort.x = this._leftViewPortOffset - this._horizontalScrollPosition;
				this._viewPort.y = this._topViewPortOffset - this._verticalScrollPosition;
			}

			this.layoutPullViews();
			this.layoutScrollBars();
		}

		/**
		 * @private
		 */
		protected function layoutScrollBars():void
		{
			var visibleWidth:Number = this.actualWidth - this._leftViewPortOffset - this._rightViewPortOffset;
			var visibleHeight:Number = this.actualHeight - this._topViewPortOffset - this._bottomViewPortOffset;
			if(this.horizontalScrollBar !== null)
			{
				this.horizontalScrollBar.validate();
			}
			if(this.verticalScrollBar !== null)
			{
				this.verticalScrollBar.validate();
			}
			if(this.horizontalScrollBar !== null)
			{
				if(this._horizontalScrollBarPosition === RelativePosition.TOP)
				{
					this.horizontalScrollBar.y = this._paddingTop;
				}
				else
				{
					this.horizontalScrollBar.y = this._topViewPortOffset + visibleHeight;
				}
				this.horizontalScrollBar.x = this._leftViewPortOffset;
				if(this._scrollBarDisplayMode !== ScrollBarDisplayMode.FIXED)
				{
					this.horizontalScrollBar.y -= this.horizontalScrollBar.height;
					if((this._hasVerticalScrollBar || this._verticalScrollBarHideTween) && this.verticalScrollBar)
					{
						this.horizontalScrollBar.width = visibleWidth - this.verticalScrollBar.width;
					}
					else
					{
						this.horizontalScrollBar.width = visibleWidth;
					}
				}
				else
				{
					this.horizontalScrollBar.width = visibleWidth;
				}
			}

			if(this.verticalScrollBar !== null)
			{
				if(this._verticalScrollBarPosition === RelativePosition.LEFT)
				{
					this.verticalScrollBar.x = this._paddingLeft;
				}
				else
				{
					this.verticalScrollBar.x = this._leftViewPortOffset + visibleWidth;
				}
				this.verticalScrollBar.y = this._topViewPortOffset;
				if(this._scrollBarDisplayMode !== ScrollBarDisplayMode.FIXED)
				{
					this.verticalScrollBar.x -= this.verticalScrollBar.width;
					if((this._hasHorizontalScrollBar || this._horizontalScrollBarHideTween) && this.horizontalScrollBar)
					{
						this.verticalScrollBar.height = visibleHeight - this.horizontalScrollBar.height;
					}
					else
					{
						this.verticalScrollBar.height = visibleHeight;
					}
				}
				else
				{
					this.verticalScrollBar.height = visibleHeight;
				}
			}
		}

		/**
		 * @private
		 */
		protected function layoutPullViews():void
		{
			var viewPortIndex:int = this.getRawChildIndexInternal(DisplayObject(this._viewPort));
			if(this._topPullView !== null)
			{
				if(this._topPullView is IValidating)
				{
					IValidating(this._topPullView).validate();
				}
				this._topPullView.x = this._topPullView.pivotX * this._topPullView.scaleX +
					(this.actualWidth - this._topPullView.width) / 2;
				//if the animation is active, we don't want to interrupt it.
				//if the user starts dragging, the animation will be stopped.
				if(this._topPullTween === null)
				{
					var pullViewSize:Number = this._topPullView.height;
					var finalRatio:Number = this._topPullViewRatio;
					if(this._verticalScrollPosition < this._minVerticalScrollPosition)
					{
						var scrollRatio:Number = (this._minVerticalScrollPosition - this._verticalScrollPosition) / pullViewSize;
						if(scrollRatio > finalRatio)
						{
							finalRatio = scrollRatio;
						}
					}
					if(this._isTopPullViewActive && finalRatio < 1)
					{
						finalRatio = 1;
					}
					if(finalRatio > 0)
					{
						if(this._topPullViewDisplayMode === PullViewDisplayMode.FIXED)
						{
							this._topPullView.y = this._topViewPortOffset +
								this._topPullView.pivotY * this._topPullView.scaleY;
						}
						else
						{
							this._topPullView.y = this._topViewPortOffset +
								this._topPullView.pivotY * this._topPullView.scaleY +
								(finalRatio * pullViewSize) - pullViewSize;
						}
						this._topPullView.visible = true;
						this.refreshTopPullViewMask();
					}
					else
					{
						this._topPullView.visible = false;
					}
				}
				var pullViewIndex:int = this.getRawChildIndexInternal(this._topPullView);
				if(this._topPullViewDisplayMode === PullViewDisplayMode.FIXED &&
					this._hasElasticEdges)
				{
					//if fixed and elastic, the pull view should appear below
					//the view port
					if(viewPortIndex < pullViewIndex)
					{
						this.setRawChildIndexInternal(this._topPullView, viewPortIndex);
						viewPortIndex++;
					}
				}
				else
				{
					//otherwise, it should appear above
					if(viewPortIndex > pullViewIndex)
					{
						this.removeRawChildInternal(this._topPullView);
						this.addRawChildAtInternal(this._topPullView, viewPortIndex);
						viewPortIndex--;
					}
				}
			}
			if(this._rightPullView !== null)
			{
				if(this._rightPullView is IValidating)
				{
					IValidating(this._rightPullView).validate();
				}
				this._rightPullView.y = this._rightPullView.pivotY * this._rightPullView.scaleY +
					(this.actualHeight - this._rightPullView.height) / 2;
				//if the animation is active, we don't want to interrupt it.
				//if the user starts dragging, the animation will be stopped.
				if(this._rightPullTween === null)
				{
					pullViewSize = this._rightPullView.width;
					finalRatio = this._rightPullViewRatio;
					if(this._horizontalScrollPosition > this._maxHorizontalScrollPosition)
					{
						scrollRatio = (this._horizontalScrollPosition - this._maxHorizontalScrollPosition) / pullViewSize;
						if(scrollRatio > finalRatio)
						{
							finalRatio = scrollRatio;
						}
					}
					if(this._isRightPullViewActive && finalRatio < 1)
					{
						finalRatio = 1;
					}
					if(finalRatio > 0)
					{
						if(this._rightPullViewDisplayMode === PullViewDisplayMode.FIXED)
						{
							this._rightPullView.x = this._rightPullView.pivotX * this._rightPullView.scaleX +
								this.actualWidth - this._rightViewPortOffset - pullViewSize;
						}
						else
						{
							this._rightPullView.x = this._rightPullView.pivotX * this._rightPullView.scaleX +
								this.actualWidth - this._rightViewPortOffset - (finalRatio * pullViewSize);
						}
						this._rightPullView.visible = true;
						this.refreshRightPullViewMask();
					}
					else
					{
						this._rightPullView.visible = false;
					}
				}
				pullViewIndex = this.getRawChildIndexInternal(this._rightPullView);
				if(this._rightPullViewDisplayMode === PullViewDisplayMode.FIXED &&
					this._hasElasticEdges)
				{
					//if fixed and elastic, the pull view should appear below
					//the view port
					if(viewPortIndex < pullViewIndex)
					{
						this.setRawChildIndexInternal(this._rightPullView, viewPortIndex);
						viewPortIndex++;
					}
				}
				else
				{
					//otherwise, it should appear above
					if(viewPortIndex > pullViewIndex)
					{
						this.removeRawChildInternal(this._rightPullView);
						this.addRawChildAtInternal(this._rightPullView, viewPortIndex);
						viewPortIndex--;
					}
				}
			}
			if(this._bottomPullView !== null)
			{
				if(this._bottomPullView is IValidating)
				{
					IValidating(this._bottomPullView).validate();
				}
				this._bottomPullView.x = this._bottomPullView.pivotX * this._bottomPullView.scaleX +
					(this.actualWidth - this._bottomPullView.width) / 2;
				//if the animation is active, we don't want to interrupt it.
				//if the user starts dragging, the animation will be stopped.
				if(this._bottomPullTween === null)
				{
					pullViewSize = this._bottomPullView.height;
					finalRatio = this._bottomPullViewRatio;
					if(this._verticalScrollPosition > this._maxVerticalScrollPosition)
					{
						//if the scroll position is greater than the pull
						//position, then prefer the scroll position
						scrollRatio = (this._verticalScrollPosition - this._maxVerticalScrollPosition) / pullViewSize;
						if(scrollRatio > finalRatio)
						{
							finalRatio = scrollRatio;
						}
					}
					if(this._isBottomPullViewActive && finalRatio < 1)
					{
						finalRatio = 1;
					}
					if(finalRatio > 0)
					{
						if(this._bottomPullViewDisplayMode === PullViewDisplayMode.FIXED)
						{
							this._bottomPullView.y = this._bottomPullView.pivotY * this._bottomPullView.scaleY +
								this.actualHeight - this._bottomViewPortOffset - pullViewSize;
						}
						else
						{
							this._bottomPullView.y = this._bottomPullView.pivotY * this._bottomPullView.scaleY +
								this.actualHeight - this._bottomViewPortOffset - (finalRatio * pullViewSize);
						}
						this._bottomPullView.visible = true;
						this.refreshBottomPullViewMask();
					}
					else
					{
						this._bottomPullView.visible = false;
					}
				}
				pullViewIndex = this.getRawChildIndexInternal(this._bottomPullView);
				if(this._bottomPullViewDisplayMode === PullViewDisplayMode.FIXED &&
					this._hasElasticEdges)
				{
					//if fixed and elastic, the pull view should appear below
					//the view port
					if(viewPortIndex < pullViewIndex)
					{
						this.setRawChildIndexInternal(this._bottomPullView, viewPortIndex);
						viewPortIndex++;
					}
				}
				else
				{
					//otherwise, it should appear above
					if(viewPortIndex > pullViewIndex)
					{
						this.removeRawChildInternal(this._bottomPullView);
						this.addRawChildAtInternal(this._bottomPullView, viewPortIndex);
						viewPortIndex--;
					}
				}
			}
			if(this._leftPullView !== null)
			{
				if(this._leftPullView is IValidating)
				{
					IValidating(this._leftPullView).validate();
				}
				this._leftPullView.y = this._leftPullView.pivotY * this._leftPullView.scaleY +
					(this.actualHeight - this._leftPullView.height) / 2;
				//if the animation is active, we don't want to interrupt it.
				//if the user starts dragging, the animation will be stopped.
				if(this._leftPullTween === null)
				{
					pullViewSize = this._leftPullView.width;
					finalRatio = this._leftPullViewRatio;
					if(this._horizontalScrollPosition < this._minHorizontalScrollPosition)
					{
						//if the scroll position is less than the pull position,
						//then prefer the scroll position
						scrollRatio = (this._minHorizontalScrollPosition - this._horizontalScrollPosition) / pullViewSize;
						if(scrollRatio > finalRatio)
						{
							finalRatio = scrollRatio;
						}
					}
					if(this._isLeftPullViewActive && finalRatio < 1)
					{
						finalRatio = 1;
					}
					if(finalRatio > 0)
					{
						if(this._leftPullViewDisplayMode === PullViewDisplayMode.FIXED)
						{
							this._leftPullView.x = this._leftViewPortOffset +
								this._leftPullView.pivotX * this._leftPullView.scaleX;
						}
						else
						{
							this._leftPullView.x = this._leftViewPortOffset +
								this._leftPullView.pivotX * this._leftPullView.scaleX +
								 (finalRatio * pullViewSize) - pullViewSize;
						}
						this._leftPullView.visible = true;
						this.refreshLeftPullViewMask();
					}
					else
					{
						this._leftPullView.visible = false;
					}
				}
				pullViewIndex = this.getRawChildIndexInternal(this._leftPullView);
				if(this._leftPullViewDisplayMode === PullViewDisplayMode.FIXED &&
					this._hasElasticEdges)
				{
					//if fixed and elastic, the pull view should appear below
					//the view port
					if(viewPortIndex < pullViewIndex)
					{
						this.setRawChildIndexInternal(this._leftPullView, viewPortIndex);
					}
				}
				else
				{
					//otherwise, it should appear above
					if(viewPortIndex > pullViewIndex)
					{
						this.removeRawChildInternal(this._leftPullView);
						this.addRawChildAtInternal(this._leftPullView, viewPortIndex);
					}
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshTopPullViewMask():void
		{
			var pullViewHeight:Number = this._topPullView.height / this._topPullView.scaleY;
			var mask:DisplayObject = this._topPullView.mask;
			var maskHeight:Number = pullViewHeight + ((this._topPullView.y - this._topPullView.pivotY * this._topPullView.scaleY - this._paddingTop) / this._topPullView.scaleY);
			if(maskHeight < 0)
			{
				maskHeight = 0;
			}
			else if(maskHeight > pullViewHeight)
			{
				maskHeight = pullViewHeight;
			}
			mask.width = this._topPullView.width / this._topPullView.scaleX;
			mask.height = maskHeight;
			mask.x = 0;
			mask.y = pullViewHeight - maskHeight;
		}

		/**
		 * @private
		 */
		protected function refreshRightPullViewMask():void
		{
			var pullViewWidth:Number = this._rightPullView.width / this._rightPullView.scaleX;
			var mask:DisplayObject = this._rightPullView.mask;
			var maskWidth:Number = this.actualWidth - this._rightViewPortOffset - ((this._rightPullView.x - this._rightPullView.pivotX / this._rightPullView.scaleX) / this._rightPullView.scaleX);
			if(maskWidth < 0)
			{
				maskWidth = 0;
			}
			else if(maskWidth > pullViewWidth)
			{
				maskWidth = pullViewWidth;
			}
			mask.width = maskWidth;
			mask.height = this._rightPullView.height / this._rightPullView.scaleY;
			mask.x = 0;
			mask.y = 0;
		}

		/**
		 * @private
		 */
		protected function refreshBottomPullViewMask():void
		{
			var pullViewHeight:Number = this._bottomPullView.height / this._bottomPullView.scaleY;
			var mask:DisplayObject = this._bottomPullView.mask;
			var maskHeight:Number = this.actualHeight - this._bottomViewPortOffset - ((this._bottomPullView.y - this._bottomPullView.pivotY / this._bottomPullView.scaleY) / this._bottomPullView.scaleY);
			if(maskHeight < 0)
			{
				maskHeight = 0;
			}
			else if(maskHeight > pullViewHeight)
			{
				maskHeight = pullViewHeight;
			}
			mask.width = this._bottomPullView.width / this._bottomPullView.scaleX;
			mask.height = maskHeight;
			mask.x = 0;
			mask.y = 0;
		}

		/**
		 * @private
		 */
		protected function refreshLeftPullViewMask():void
		{
			var pullViewWidth:Number = this._leftPullView.width / this._leftPullView.scaleX;
			var mask:DisplayObject = this._leftPullView.mask;
			var maskWidth:Number = pullViewWidth + ((this._leftPullView.x - this._leftPullView.pivotX * this._leftPullView.scaleX - this._paddingLeft) / this._leftPullView.scaleX);
			if(maskWidth < 0)
			{
				maskWidth = 0;
			}
			else if(maskWidth > pullViewWidth)
			{
				maskWidth = pullViewWidth;
			}
			mask.width = maskWidth;
			mask.height = this._leftPullView.height / this._leftPullView.scaleY;
			mask.x = pullViewWidth - maskWidth;
			mask.y = 0;
		}

		/**
		 * @private
		 */
		protected function refreshMask():void
		{
			if(!this._clipContent)
			{
				return;
			}
			var clipWidth:Number = this.actualWidth - this._leftViewPortOffset - this._rightViewPortOffset;
			if(clipWidth < 0)
			{
				clipWidth = 0;
			}
			var clipHeight:Number = this.actualHeight - this._topViewPortOffset - this._bottomViewPortOffset;
			if(clipHeight < 0)
			{
				clipHeight = 0;
			}
			var mask:Quad = this._viewPort.mask as Quad;
			if(!mask)
			{
				mask = new Quad(1, 1, 0xff0ff);
				this._viewPort.mask = mask;
			}
			mask.x = this._horizontalScrollPosition;
			mask.y = this._verticalScrollPosition;
			mask.width = clipWidth;
			mask.height = clipHeight;
		}

		/**
		 * @private
		 */
		protected function get numRawChildrenInternal():int
		{
			if(this is IScrollContainer)
			{
				return IScrollContainer(this).numRawChildren;
			}
			return this.numChildren;
		}

		/**
		 * @private
		 */
		protected function addRawChildInternal(child:DisplayObject):DisplayObject
		{
			if(this is IScrollContainer)
			{
				return IScrollContainer(this).addRawChild(child);
			}
			return this.addChild(child);
		}

		/**
		 * @private
		 */
		protected function addRawChildAtInternal(child:DisplayObject, index:int):DisplayObject
		{
			if(this is IScrollContainer)
			{
				return IScrollContainer(this).addRawChildAt(child, index);
			}
			return this.addChildAt(child, index);
		}

		/**
		 * @private
		 */
		protected function removeRawChildInternal(child:DisplayObject, dispose:Boolean = false):DisplayObject
		{
			if(this is IScrollContainer)
			{
				return IScrollContainer(this).removeRawChild(child, dispose);
			}
			return this.removeChild(child, dispose);
		}

		/**
		 * @private
		 */
		protected function removeRawChildAtInternal(index:int, dispose:Boolean = false):DisplayObject
		{
			if(this is IScrollContainer)
			{
				return IScrollContainer(this).removeRawChildAt(index, dispose);
			}
			return this.removeChildAt(index, dispose);
		}

		/**
		 * @private
		 */
		protected function getRawChildIndexInternal(child:DisplayObject):int
		{
			if(this is IScrollContainer)
			{
				return IScrollContainer(this).getRawChildIndex(child);
			}
			return this.getChildIndex(child);
		}

		/**
		 * @private
		 */
		protected function setRawChildIndexInternal(child:DisplayObject, index:int):void
		{
			if(this is IScrollContainer)
			{
				IScrollContainer(this).setRawChildIndex(child, index);
				return;
			}
			this.setChildIndex(child, index);
		}

		/**
		 * @private
		 */
		protected function updateHorizontalScrollFromTouchPosition(touchX:Number):void
		{
			var offset:Number = this._startTouchX - touchX;
			var position:Number = this._startHorizontalScrollPosition + offset;
			var adjustedMinScrollPosition:Number = this._minHorizontalScrollPosition;
			if(this._isLeftPullViewActive && this._hasElasticEdges)
			{
				adjustedMinScrollPosition -= this._leftPullView.width;
			}
			var adjustedMaxScrollPosition:Number = this._maxHorizontalScrollPosition;
			if(this._isRightPullViewActive && this._hasElasticEdges)
			{
				adjustedMaxScrollPosition += this._rightPullView.width;
			}
			if(position < adjustedMinScrollPosition)
			{
				//first, calculate the position as if elastic edges were enabled
				position = position - (position - adjustedMinScrollPosition) * (1 - this._elasticity);
				if(this._leftPullView !== null && position < adjustedMinScrollPosition)
				{
					if(this._isLeftPullViewActive)
					{
						this.leftPullViewRatio = 1;
					}
					else
					{
						//save the difference between that position and the minimum
						//to use for the position of the pull view
						this.leftPullViewRatio = (adjustedMinScrollPosition - position) / this._leftPullView.width;
					}
				}
				if(this._rightPullView !== null && !this._isRightPullViewActive)
				{
					this.rightPullViewRatio = 0;
				}
				if(!this._hasElasticEdges ||
					(this._isRightPullViewActive && this._minHorizontalScrollPosition == this._maxHorizontalScrollPosition))
				{
					//if elastic edges aren't enabled, use the minimum
					position = adjustedMinScrollPosition;
				}
			}
			else if(position > adjustedMaxScrollPosition)
			{
				position = position - (position - adjustedMaxScrollPosition) * (1 - this._elasticity);
				if(this._rightPullView !== null && position > adjustedMaxScrollPosition)
				{
					if(this._isRightPullViewActive)
					{
						this.rightPullViewRatio = 1;
					}
					else
					{
						this.rightPullViewRatio = (position - adjustedMaxScrollPosition) / this._rightPullView.width;
					}
				}
				if(this._leftPullView !== null && !this._isLeftPullViewActive)
				{
					this.leftPullViewRatio = 0;
				}
				if(!this._hasElasticEdges ||
					(this._isLeftPullViewActive && this._minHorizontalScrollPosition == this._maxHorizontalScrollPosition))
				{
					position = adjustedMaxScrollPosition;
				}
			}
			else
			{
				if(this._leftPullView !== null && !this._isLeftPullViewActive)
				{
					this.leftPullViewRatio = 0;
				}
				if(this._rightPullView !== null && !this._isRightPullViewActive)
				{
					this.rightPullViewRatio = 0;
				}
			}
			if(this._leftPullViewRatio > 0)
			{
				if(this._leftPullTween !== null)
				{
					this._leftPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
					this._leftPullTween = null;
				}
				//ensure that the component invalidates, even if the
				//horizontalScrollPosition does not change
				this.invalidate(INVALIDATION_FLAG_SCROLL);
			}
			if(this._rightPullViewRatio > 0)
			{
				if(this._rightPullTween !== null)
				{
					this._rightPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
					this._rightPullTween = null;
				}
				//see note above with previous call to invalidate()
				this.invalidate(INVALIDATION_FLAG_SCROLL);
			}
			this.horizontalScrollPosition = position;
		}

		/**
		 * @private
		 */
		protected function updateVerticalScrollFromTouchPosition(touchY:Number):void
		{
			var offset:Number = this._startTouchY - touchY;
			var position:Number = this._startVerticalScrollPosition + offset;
			var adjustedMinScrollPosition:Number = this._minVerticalScrollPosition;
			if(this._isTopPullViewActive && this._hasElasticEdges)
			{
				adjustedMinScrollPosition -= this._topPullView.height;
			}
			var adjustedMaxScrollPosition:Number = this._maxVerticalScrollPosition;
			if(this._isBottomPullViewActive && this._hasElasticEdges)
			{
				adjustedMaxScrollPosition += this._bottomPullView.height;
			}
			if(position < adjustedMinScrollPosition)
			{
				//first, calculate the position as if elastic edges were enabled
				position = position - (position - adjustedMinScrollPosition) * (1 - this._elasticity);
				if(this._topPullView !== null && position < adjustedMinScrollPosition)
				{
					if(this._isTopPullViewActive)
					{
						this.topPullViewRatio = 1;
					}
					else
					{
						this.topPullViewRatio = (adjustedMinScrollPosition - position) / this._topPullView.height;
					}
				}
				if(this._bottomPullView !== null && !this._isBottomPullViewActive)
				{
					this.bottomPullViewRatio = 0;
				}
				if(!this._hasElasticEdges ||
					(this._isBottomPullViewActive && this._minVerticalScrollPosition == this._maxVerticalScrollPosition))
				{
					//if elastic edges aren't enabled, use the minimum
					position = adjustedMinScrollPosition;
				}
			}
			else if(position > adjustedMaxScrollPosition)
			{
				position = position - (position - adjustedMaxScrollPosition) * (1 - this._elasticity);
				if(this._bottomPullView !== null && position > adjustedMaxScrollPosition)
				{
					if(this._isBottomPullViewActive)
					{
						this.bottomPullViewRatio = 1;
					}
					else
					{
						this.bottomPullViewRatio = (position - adjustedMaxScrollPosition) / this._bottomPullView.height;
					}
				}
				if(this._topPullView !== null && !this._isTopPullViewActive)
				{
					this.topPullViewRatio = 0;
				}
				if(!this._hasElasticEdges ||
					(this._isTopPullViewActive && this._minVerticalScrollPosition == this._maxVerticalScrollPosition))
				{
					position = adjustedMaxScrollPosition;
				}
			}
			else
			{
				if(this._topPullView !== null && !this._isTopPullViewActive)
				{
					this.topPullViewRatio = 0;
				}
				if(this._bottomPullView !== null && !this._isBottomPullViewActive)
				{
					this.bottomPullViewRatio = 0;
				}
			}
			if(this._topPullViewRatio > 0)
			{
				if(this._topPullTween !== null)
				{
					this._topPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
					this._topPullTween = null;
				}
				//ensure that the component invalidates, even if the
				//verticalScrollPosition does not change
				this.invalidate(INVALIDATION_FLAG_SCROLL);
			}
			if(this._bottomPullViewRatio > 0)
			{
				if(this._bottomPullTween !== null)
				{
					this._bottomPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
					this._bottomPullTween = null;
				}
				//see note above with previous call to invalidate()
				this.invalidate(INVALIDATION_FLAG_SCROLL);
			}
			this.verticalScrollPosition = position;
		}

		/**
		 * Immediately throws the scroller to the specified position, with
		 * optional animation. If you want to throw in only one direction, pass
		 * in <code>NaN</code> for the value that you do not want to change. The
		 * scroller should be validated before throwing.
		 *
		 * @see #scrollToPosition()
		 */
		protected function throwTo(targetHorizontalScrollPosition:Number = NaN, targetVerticalScrollPosition:Number = NaN, duration:Number = 0.5):void
		{
			var changedPosition:Boolean = false;
			if(targetHorizontalScrollPosition === targetHorizontalScrollPosition) //!isNaN
			{
				if(this._snapToPages && targetHorizontalScrollPosition > this._minHorizontalScrollPosition &&
					targetHorizontalScrollPosition < this._maxHorizontalScrollPosition)
				{
					targetHorizontalScrollPosition = roundToNearest(targetHorizontalScrollPosition, this.actualPageWidth);
				}
				if(this._horizontalAutoScrollTween)
				{
					Starling.juggler.remove(this._horizontalAutoScrollTween);
					this._horizontalAutoScrollTween = null;
				}
				if(this._horizontalScrollPosition != targetHorizontalScrollPosition)
				{
					changedPosition = true;
					this.revealHorizontalScrollBar();
					this.startScroll();
					if(duration == 0)
					{
						this.horizontalScrollPosition = targetHorizontalScrollPosition;
					}
					else
					{
						this._startHorizontalScrollPosition = this._horizontalScrollPosition;
						this._targetHorizontalScrollPosition = targetHorizontalScrollPosition;
						this._horizontalAutoScrollTween = new Tween(this, duration, this._throwEase);
						this._horizontalAutoScrollTween.animate("horizontalScrollPosition", targetHorizontalScrollPosition);
						if(this._snapScrollPositionsToPixels)
						{
							this._horizontalAutoScrollTween.onUpdate = this.horizontalAutoScrollTween_onUpdate;
						}
						this._horizontalAutoScrollTween.onComplete = this.horizontalAutoScrollTween_onComplete;
						Starling.juggler.add(this._horizontalAutoScrollTween);
						this.refreshHorizontalAutoScrollTweenEndRatio();
					}
				}
				else
				{
					this.finishScrollingHorizontally();
				}
			}

			if(targetVerticalScrollPosition === targetVerticalScrollPosition) //!isNaN
			{
				if(this._snapToPages && targetVerticalScrollPosition > this._minVerticalScrollPosition &&
					targetVerticalScrollPosition < this._maxVerticalScrollPosition)
				{
					targetVerticalScrollPosition = roundToNearest(targetVerticalScrollPosition, this.actualPageHeight);
				}
				if(this._verticalAutoScrollTween)
				{
					Starling.juggler.remove(this._verticalAutoScrollTween);
					this._verticalAutoScrollTween = null;
				}
				if(this._verticalScrollPosition != targetVerticalScrollPosition)
				{
					changedPosition = true;
					this.revealVerticalScrollBar();
					this.startScroll();
					if(duration == 0)
					{
						this.verticalScrollPosition = targetVerticalScrollPosition;
					}
					else
					{
						this._startVerticalScrollPosition = this._verticalScrollPosition;
						this._targetVerticalScrollPosition = targetVerticalScrollPosition;
						this._verticalAutoScrollTween = new Tween(this, duration, this._throwEase);
						this._verticalAutoScrollTween.animate("verticalScrollPosition", targetVerticalScrollPosition);
						if(this._snapScrollPositionsToPixels)
						{
							this._verticalAutoScrollTween.onUpdate = this.verticalAutoScrollTween_onUpdate;
						}
						this._verticalAutoScrollTween.onComplete = this.verticalAutoScrollTween_onComplete;
						Starling.juggler.add(this._verticalAutoScrollTween);
						this.refreshVerticalAutoScrollTweenEndRatio();
					}
				}
				else
				{
					this.finishScrollingVertically();
				}
			}

			if(changedPosition && duration == 0)
			{
				this.completeScroll();
			}
		}

		/**
		 * Immediately throws the scroller to the specified page index, with
		 * optional animation. If you want to throw in only one direction, pass
		 * in the value from the <code>horizontalPageIndex</code> or
		 * <code>verticalPageIndex</code> property to the appropriate parameter.
		 * The scroller must be validated before throwing, to ensure that the
		 * minimum and maximum scroll positions are accurate.
		 *
		 * @see #scrollToPageIndex()
		 */
		protected function throwToPage(targetHorizontalPageIndex:int, targetVerticalPageIndex:int, duration:Number = 0.5):void
		{
			var targetHorizontalScrollPosition:Number = this._horizontalScrollPosition;
			if(targetHorizontalPageIndex >= this._minHorizontalPageIndex)
			{
				targetHorizontalScrollPosition = this.actualPageWidth * targetHorizontalPageIndex;
			}
			if(targetHorizontalScrollPosition < this._minHorizontalScrollPosition)
			{
				targetHorizontalScrollPosition = this._minHorizontalScrollPosition;
			}
			if(targetHorizontalScrollPosition > this._maxHorizontalScrollPosition)
			{
				targetHorizontalScrollPosition = this._maxHorizontalScrollPosition;
			}
			var targetVerticalScrollPosition:Number = this._verticalScrollPosition;
			if(targetVerticalPageIndex >= this._minVerticalPageIndex)
			{
				targetVerticalScrollPosition = this.actualPageHeight * targetVerticalPageIndex;
			}
			if(targetVerticalScrollPosition < this._minVerticalScrollPosition)
			{
				targetVerticalScrollPosition = this._minVerticalScrollPosition;
			}
			if(targetVerticalScrollPosition > this._maxVerticalScrollPosition)
			{
				targetVerticalScrollPosition = this._maxVerticalScrollPosition;
			}
			if(targetHorizontalPageIndex >= this._minHorizontalPageIndex)
			{
				this._horizontalPageIndex = targetHorizontalPageIndex;
			}
			if(targetVerticalPageIndex >= this._minVerticalPageIndex)
			{
				this._verticalPageIndex = targetVerticalPageIndex;
			}
			this.throwTo(targetHorizontalScrollPosition, targetVerticalScrollPosition, duration);
		}

		/**
		 * @private
		 */
		protected function calculateDynamicThrowDuration(pixelsPerMS:Number):Number
		{
			return (Math.log(MINIMUM_VELOCITY / Math.abs(pixelsPerMS)) / this._logDecelerationRate) / 1000;
		}

		/**
		 * @private
		 */
		protected function calculateThrowDistance(pixelsPerMS:Number):Number
		{
			return (pixelsPerMS - MINIMUM_VELOCITY) / this._logDecelerationRate;
		}

		/**
		 * @private
		 */
		protected function finishScrollingHorizontally():void
		{
			var adjustedMinScrollPosition:Number = this._minHorizontalScrollPosition;
			if(this._isLeftPullViewActive && this._hasElasticEdges)
			{
				adjustedMinScrollPosition -= this._leftPullView.width;
			}
			var adjustedMaxScrollPosition:Number = this._maxHorizontalScrollPosition;
			if(this._isRightPullViewActive && this._hasElasticEdges)
			{
				adjustedMaxScrollPosition += this._rightPullView.width;
			}
			var targetHorizontalScrollPosition:Number = NaN;
			if(this._horizontalScrollPosition < adjustedMinScrollPosition)
			{
				targetHorizontalScrollPosition = adjustedMinScrollPosition;
			}
			else if(this._horizontalScrollPosition > adjustedMaxScrollPosition)
			{
				targetHorizontalScrollPosition = adjustedMaxScrollPosition;
			}

			this._isDraggingHorizontally = false;
			if(targetHorizontalScrollPosition !== targetHorizontalScrollPosition) //isNaN
			{
				this.completeScroll();
			}
			else if(Math.abs(targetHorizontalScrollPosition - this._horizontalScrollPosition) < 1)
			{
				//this distance is too small to animate. just finish now.
				this.horizontalScrollPosition = targetHorizontalScrollPosition;
				this.completeScroll();
			}
			else
			{
				this.throwTo(targetHorizontalScrollPosition, NaN, this._elasticSnapDuration);
			}
			this.restoreHorizontalPullViews();
		}

		/**
		 * @private
		 */
		protected function finishScrollingVertically():void
		{
			var adjustedMinScrollPosition:Number = this._minVerticalScrollPosition;
			if(this._isTopPullViewActive && this._hasElasticEdges)
			{
				adjustedMinScrollPosition -= this._topPullView.height;
			}
			var adjustedMaxScrollPosition:Number = this._maxVerticalScrollPosition;
			if(this._isBottomPullViewActive && this._hasElasticEdges)
			{
				adjustedMaxScrollPosition += this._bottomPullView.height;
			}
			var targetVerticalScrollPosition:Number = NaN;
			if(this._verticalScrollPosition < adjustedMinScrollPosition)
			{
				targetVerticalScrollPosition = adjustedMinScrollPosition;
			}
			else if(this._verticalScrollPosition > adjustedMaxScrollPosition)
			{
				targetVerticalScrollPosition = adjustedMaxScrollPosition;
			}

			this._isDraggingVertically = false;
			if(targetVerticalScrollPosition !== targetVerticalScrollPosition) //isNaN
			{
				this.completeScroll();
			}
			else if(Math.abs(targetVerticalScrollPosition - this._verticalScrollPosition) < 1)
			{
				//this distance is too small to animate. just finish now.
				this.verticalScrollPosition = targetVerticalScrollPosition;
				this.completeScroll();
			}
			else
			{
				this.throwTo(NaN, targetVerticalScrollPosition, this._elasticSnapDuration);
			}
			this.restoreVerticalPullViews();
		}

		/**
		 * @private
		 */
		protected function restoreVerticalPullViews():void
		{
			if(this._topPullView !== null &&
				this._topPullViewRatio > 0)
			{
				if(this._topPullTween !== null)
				{
					this._topPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
					this._topPullTween = null;
				}
				if(this._topPullViewDisplayMode === PullViewDisplayMode.DRAG)
				{
					var yPosition:Number = this._topViewPortOffset + 
						this._topPullView.pivotY * this._topPullView.scaleY;
					if(!this._isTopPullViewActive)
					{
						yPosition -= this._topPullView.height;
					}
					if(this._topPullView.y != yPosition)
					{
						this._topPullTween = new Tween(this._topPullView, this._elasticSnapDuration, this._throwEase);
						this._topPullTween.animate("y", yPosition);
						this._topPullTween.onUpdate = this.refreshTopPullViewMask;
						this._topPullTween.onComplete = this.topPullTween_onComplete;
						Starling.juggler.add(this._topPullTween);
					}
				}
				else
				{
					this.topPullTween_onComplete();
				}
			}
			if(this._bottomPullView !== null &&
				this._bottomPullViewRatio > 0)
			{
				if(this._bottomPullTween !== null)
				{
					this._bottomPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
					this._bottomPullTween = null;
				}
				if(this._bottomPullViewDisplayMode === PullViewDisplayMode.DRAG)
				{
					yPosition = this.actualHeight - this._bottomViewPortOffset +
						this._bottomPullView.pivotY * this._bottomPullView.scaleY;
					if(this._isBottomPullViewActive)
					{
						yPosition -= this._bottomPullView.height;
					}
					if(this._bottomPullView.y != yPosition)
					{
						this._bottomPullTween = new Tween(this._bottomPullView, this._elasticSnapDuration, this._throwEase);
						this._bottomPullTween.animate("y", yPosition);
						this._bottomPullTween.onUpdate = this.refreshBottomPullViewMask;
						this._bottomPullTween.onComplete = this.bottomPullTween_onComplete;
						Starling.juggler.add(this._bottomPullTween);
					}
				}
				else
				{
					this.bottomPullTween_onComplete();
				}
			}
		}

		/**
		 * @private
		 */
		protected function restoreHorizontalPullViews():void
		{
			if(this._leftPullView !== null &&
				this._leftPullViewRatio > 0)
			{
				if(this._leftPullTween !== null)
				{
					this._leftPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
					this._leftPullTween = null;
				}
				if(this._leftPullViewDisplayMode === PullViewDisplayMode.DRAG)
				{
					var xPosition:Number = this._leftViewPortOffset +
						this._leftPullView.pivotX * this._leftPullView.scaleX;
					if(!this._isLeftPullViewActive)
					{
						xPosition -= this._leftPullView.width;
					}
					if(this._leftPullView.x != xPosition)
					{
						this._leftPullTween = new Tween(this._leftPullView, this._elasticSnapDuration, this._throwEase);
						this._leftPullTween.animate("x", xPosition);
						this._leftPullTween.onUpdate = this.refreshLeftPullViewMask;
						this._leftPullTween.onComplete = this.leftPullTween_onComplete;
						Starling.juggler.add(this._leftPullTween);
					}
				}
				else
				{
					this.leftPullTween_onComplete();
				}
			}
			if(this._rightPullView !== null &&
				this._rightPullViewRatio > 0)
			{
				if(this._rightPullTween !== null)
				{
					this._rightPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
					this._rightPullTween = null;
				}
				if(this._rightPullViewDisplayMode === PullViewDisplayMode.DRAG)
				{
					xPosition = this.actualWidth - this._rightViewPortOffset +
						this._rightPullView.pivotX * this._rightPullView.scaleX;
					if(this._isRightPullViewActive)
					{
						xPosition -= this._rightPullView.width;
					}
					if(this._rightPullView.x != xPosition)
					{
						this._rightPullTween = new Tween(this._rightPullView, this._elasticSnapDuration, this._throwEase);
						this._rightPullTween.animate("x", xPosition);
						this._rightPullTween.onUpdate = this.refreshRightPullViewMask;
						this._rightPullTween.onComplete = this.rightPullTween_onComplete;
						Starling.juggler.add(this._rightPullTween);
					}
				}
				else
				{
					this.rightPullTween_onComplete();
				}
			}
		}

		/**
		 * @private
		 */
		protected function throwHorizontally(pixelsPerMS:Number):void
		{
			if(this._snapToPages && !this._snapOnComplete)
			{
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				var inchesPerSecond:Number = 1000 * pixelsPerMS / (DeviceCapabilities.dpi / starling.contentScaleFactor);
				if(inchesPerSecond > this._minimumPageThrowVelocity)
				{
					var snappedPageHorizontalScrollPosition:Number = roundDownToNearest(this._horizontalScrollPosition, this.actualPageWidth);
				}
				else if(inchesPerSecond < -this._minimumPageThrowVelocity)
				{
					snappedPageHorizontalScrollPosition = roundUpToNearest(this._horizontalScrollPosition, this.actualPageWidth);
				}
				else
				{
					var lastPageWidth:Number = this._maxHorizontalScrollPosition % this.actualPageWidth;
					var startOfLastPage:Number = this._maxHorizontalScrollPosition - lastPageWidth;
					if(lastPageWidth < this.actualPageWidth && this._horizontalScrollPosition >= startOfLastPage)
					{
						var lastPagePosition:Number = this._horizontalScrollPosition - startOfLastPage;
						if(inchesPerSecond > this._minimumPageThrowVelocity)
						{
							snappedPageHorizontalScrollPosition = startOfLastPage + roundDownToNearest(lastPagePosition, lastPageWidth);
						}
						else if(inchesPerSecond < -this._minimumPageThrowVelocity)
						{
							snappedPageHorizontalScrollPosition = startOfLastPage + roundUpToNearest(lastPagePosition, lastPageWidth);
						}
						else
						{
							snappedPageHorizontalScrollPosition = startOfLastPage + roundToNearest(lastPagePosition, lastPageWidth);
						}
					}
					else
					{
						snappedPageHorizontalScrollPosition = roundToNearest(this._horizontalScrollPosition, this.actualPageWidth);
					}
				}
				if(snappedPageHorizontalScrollPosition < this._minHorizontalScrollPosition)
				{
					snappedPageHorizontalScrollPosition = this._minHorizontalScrollPosition;
				}
				else if(snappedPageHorizontalScrollPosition > this._maxHorizontalScrollPosition)
				{
					snappedPageHorizontalScrollPosition = this._maxHorizontalScrollPosition;
				}
				if(snappedPageHorizontalScrollPosition == this._maxHorizontalScrollPosition)
				{
					var targetHorizontalPageIndex:int = this._maxHorizontalPageIndex;
				}
				else
				{
					//we need to use Math.round() on these values to avoid
					//floating-point errors that could result in the values
					//being rounded down too far.
					if(this._minHorizontalScrollPosition == Number.NEGATIVE_INFINITY)
					{
						targetHorizontalPageIndex = Math.round(snappedPageHorizontalScrollPosition / this.actualPageWidth);
					}
					else
					{
						targetHorizontalPageIndex = Math.round((snappedPageHorizontalScrollPosition - this._minHorizontalScrollPosition) / this.actualPageWidth);
					}
				}
				this.throwToPage(targetHorizontalPageIndex, -1, this._pageThrowDuration);
				return;
			}

			var absPixelsPerMS:Number = Math.abs(pixelsPerMS);
			if(!this._snapToPages && absPixelsPerMS <= MINIMUM_VELOCITY)
			{
				this.finishScrollingHorizontally();
				return;
			}

			var duration:Number = this._fixedThrowDuration;
			if(!this._useFixedThrowDuration)
			{
				duration = this.calculateDynamicThrowDuration(pixelsPerMS);
			}
			this.throwTo(this._horizontalScrollPosition + this.calculateThrowDistance(pixelsPerMS), NaN, duration);
		}

		/**
		 * @private
		 */
		protected function throwVertically(pixelsPerMS:Number):void
		{
			if(this._snapToPages && !this._snapOnComplete)
			{
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				var inchesPerSecond:Number = 1000 * pixelsPerMS / (DeviceCapabilities.dpi / starling.contentScaleFactor);
				if(inchesPerSecond > this._minimumPageThrowVelocity)
				{
					var snappedPageVerticalScrollPosition:Number = roundDownToNearest(this._verticalScrollPosition, this.actualPageHeight);
				}
				else if(inchesPerSecond < -this._minimumPageThrowVelocity)
				{
					snappedPageVerticalScrollPosition = roundUpToNearest(this._verticalScrollPosition, this.actualPageHeight);
				}
				else
				{
					var lastPageHeight:Number = this._maxVerticalScrollPosition % this.actualPageHeight;
					var startOfLastPage:Number = this._maxVerticalScrollPosition - lastPageHeight;
					if(lastPageHeight < this.actualPageHeight && this._verticalScrollPosition >= startOfLastPage)
					{
						var lastPagePosition:Number = this._verticalScrollPosition - startOfLastPage;
						if(inchesPerSecond > this._minimumPageThrowVelocity)
						{
							snappedPageVerticalScrollPosition = startOfLastPage + roundDownToNearest(lastPagePosition, lastPageHeight);
						}
						else if(inchesPerSecond < -this._minimumPageThrowVelocity)
						{
							snappedPageVerticalScrollPosition = startOfLastPage + roundUpToNearest(lastPagePosition, lastPageHeight);
						}
						else
						{
							snappedPageVerticalScrollPosition = startOfLastPage + roundToNearest(lastPagePosition, lastPageHeight);
						}
					}
					else
					{
						snappedPageVerticalScrollPosition = roundToNearest(this._verticalScrollPosition, this.actualPageHeight);
					}
				}
				if(snappedPageVerticalScrollPosition < this._minVerticalScrollPosition)
				{
					snappedPageVerticalScrollPosition = this._minVerticalScrollPosition;
				}
				else if(snappedPageVerticalScrollPosition > this._maxVerticalScrollPosition)
				{
					snappedPageVerticalScrollPosition = this._maxVerticalScrollPosition;
				}
				if(snappedPageVerticalScrollPosition == this._maxVerticalScrollPosition)
				{
					var targetVerticalPageIndex:int = this._maxVerticalPageIndex;
				}
				else
				{
					//we need to use Math.round() on these values to avoid
					//floating-point errors that could result in the values
					//being rounded down too far.
					if(this._minVerticalScrollPosition == Number.NEGATIVE_INFINITY)
					{
						targetVerticalPageIndex = Math.round(snappedPageVerticalScrollPosition / this.actualPageHeight);
					}
					else
					{
						targetVerticalPageIndex = Math.round((snappedPageVerticalScrollPosition - this._minVerticalScrollPosition) / this.actualPageHeight);
					}
				}
				this.throwToPage(-1, targetVerticalPageIndex, this._pageThrowDuration);
				return;
			}

			var absPixelsPerMS:Number = Math.abs(pixelsPerMS);
			if(!this._snapToPages && absPixelsPerMS <= MINIMUM_VELOCITY)
			{
				this.finishScrollingVertically();
				return;
			}

			var duration:Number = this._fixedThrowDuration;
			if(!this._useFixedThrowDuration)
			{
				duration = this.calculateDynamicThrowDuration(pixelsPerMS);
			}
			this.throwTo(NaN, this._verticalScrollPosition + this.calculateThrowDistance(pixelsPerMS), duration);
		}

		/**
		 * @private
		 */
		protected function horizontalAutoScrollTween_onUpdateWithEndRatio():void
		{
			var ratio:Number = this._horizontalAutoScrollTween.transitionFunc(this._horizontalAutoScrollTween.currentTime / this._horizontalAutoScrollTween.totalTime);
			if(ratio >= this._horizontalAutoScrollTweenEndRatio &&
				this._horizontalAutoScrollTween.currentTime < this._horizontalAutoScrollTween.totalTime)
			{
				//check that the currentTime is less than totalTime because if
				//the tween is complete, we don't want it set to null before
				//the onComplete callback
				if(!this._hasElasticEdges)
				{
					if(this._horizontalScrollPosition < this._minHorizontalScrollPosition)
					{
						this._horizontalScrollPosition = this._minHorizontalScrollPosition;
					}
					else if(this._horizontalScrollPosition > this._maxHorizontalScrollPosition)
					{
						this._horizontalScrollPosition = this._maxHorizontalScrollPosition;
					}
				}
				Starling.juggler.remove(this._horizontalAutoScrollTween);
				this._horizontalAutoScrollTween = null;
				this.finishScrollingHorizontally();
				return;
			}
			if(this._snapScrollPositionsToPixels)
			{
				this.horizontalAutoScrollTween_onUpdate();
			}
		}

		/**
		 * @private
		 */
		protected function verticalAutoScrollTween_onUpdateWithEndRatio():void
		{
			var ratio:Number = this._verticalAutoScrollTween.transitionFunc(this._verticalAutoScrollTween.currentTime / this._verticalAutoScrollTween.totalTime);
			if(ratio >= this._verticalAutoScrollTweenEndRatio &&
				this._verticalAutoScrollTween.currentTime < this._verticalAutoScrollTween.totalTime)
			{
				//check that the currentTime is less than totalTime because if
				//the tween is complete, we don't want it set to null before
				//the onComplete callback
				if(!this._hasElasticEdges)
				{
					if(this._verticalScrollPosition < this._minVerticalScrollPosition)
					{
						this._verticalScrollPosition = this._minVerticalScrollPosition;
					}
					else if(this._verticalScrollPosition > this._maxVerticalScrollPosition)
					{
						this._verticalScrollPosition = this._maxVerticalScrollPosition;
					}
				}
				Starling.juggler.remove(this._verticalAutoScrollTween);
				this._verticalAutoScrollTween = null;
				this.finishScrollingVertically();
				return;
			}
			if(this._snapScrollPositionsToPixels)
			{
				this.verticalAutoScrollTween_onUpdate();
			}
		}

		/**
		 * @private
		 */
		protected function refreshHorizontalAutoScrollTweenEndRatio():void
		{
			var adjustedMinVerticalScrollPosition:Number = this._minHorizontalScrollPosition;
			if(this._isLeftPullViewActive && this._hasElasticEdges)
			{
				adjustedMinVerticalScrollPosition -= this._leftPullView.width;
			}
			var adjustedMaxScrollPosition:Number = this._maxHorizontalScrollPosition;
			if(this._isRightPullViewActive && this._hasElasticEdges)
			{
				adjustedMaxScrollPosition += this._rightPullView.width;
			}
			var distance:Number = Math.abs(this._targetHorizontalScrollPosition - this._startHorizontalScrollPosition);
			var ratioOutOfBounds:Number = 0;
			if(this._targetHorizontalScrollPosition > adjustedMaxScrollPosition)
			{
				ratioOutOfBounds = (this._targetHorizontalScrollPosition - adjustedMaxScrollPosition) / distance;
			}
			else if(this._targetHorizontalScrollPosition < adjustedMinVerticalScrollPosition)
			{
				ratioOutOfBounds = (adjustedMinVerticalScrollPosition - this._targetHorizontalScrollPosition) / distance;
			}
			if(ratioOutOfBounds > 0)
			{
				if(this._hasElasticEdges)
				{
					this._horizontalAutoScrollTweenEndRatio = (1 - ratioOutOfBounds) + (ratioOutOfBounds * this._throwElasticity);
				}
				else
				{
					this._horizontalAutoScrollTweenEndRatio = 1 - ratioOutOfBounds;
				}
			}
			else
			{
				this._horizontalAutoScrollTweenEndRatio = 1;
			}
			if(this._horizontalAutoScrollTween)
			{
				if(this._horizontalAutoScrollTweenEndRatio < 1)
				{
					this._horizontalAutoScrollTween.onUpdate = this.horizontalAutoScrollTween_onUpdateWithEndRatio;
				}
				else if(this._snapScrollPositionsToPixels)
				{
					this._horizontalAutoScrollTween.onUpdate = this.horizontalAutoScrollTween_onUpdate;
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshVerticalAutoScrollTweenEndRatio():void
		{
			var adjustedMinVerticalScrollPosition:Number = this._minVerticalScrollPosition;
			if(this._isTopPullViewActive && this._hasElasticEdges)
			{
				adjustedMinVerticalScrollPosition -= this._topPullView.height;
			}
			var adjustedMaxScrollPosition:Number = this._maxVerticalScrollPosition;
			if(this._isBottomPullViewActive && this._hasElasticEdges)
			{
				adjustedMaxScrollPosition += this._bottomPullView.height;
			}
			var distance:Number = Math.abs(this._targetVerticalScrollPosition - this._startVerticalScrollPosition);
			var ratioOutOfBounds:Number = 0;
			if(this._targetVerticalScrollPosition > adjustedMaxScrollPosition)
			{
				ratioOutOfBounds = (this._targetVerticalScrollPosition - adjustedMaxScrollPosition) / distance;
			}
			else if(this._targetVerticalScrollPosition < adjustedMinVerticalScrollPosition)
			{
				ratioOutOfBounds = (adjustedMinVerticalScrollPosition - this._targetVerticalScrollPosition) / distance;
			}
			if(ratioOutOfBounds > 0)
			{
				if(this._hasElasticEdges)
				{
					this._verticalAutoScrollTweenEndRatio = (1 - ratioOutOfBounds) + (ratioOutOfBounds * this._throwElasticity);
				}
				else
				{
					this._verticalAutoScrollTweenEndRatio = 1 - ratioOutOfBounds;
				}
			}
			else
			{
				this._verticalAutoScrollTweenEndRatio = 1;
			}
			if(this._verticalAutoScrollTween)
			{
				if(this._verticalAutoScrollTweenEndRatio < 1)
				{
					this._verticalAutoScrollTween.onUpdate = this.verticalAutoScrollTween_onUpdateWithEndRatio;
				}
				else if(this._snapScrollPositionsToPixels)
				{
					this._verticalAutoScrollTween.onUpdate = this.verticalAutoScrollTween_onUpdate;
				}
			}
		}

		/**
		 * @private
		 */
		protected function hideHorizontalScrollBar(delay:Number = 0):void
		{
			if(!this.horizontalScrollBar || this._scrollBarDisplayMode != ScrollBarDisplayMode.FLOAT || this._horizontalScrollBarHideTween)
			{
				return;
			}
			if(this.horizontalScrollBar.alpha == 0)
			{
				return;
			}
			if(this._hideScrollBarAnimationDuration == 0 && delay == 0)
			{
				this.horizontalScrollBar.alpha = 0;
			}
			else
			{
				this._horizontalScrollBarHideTween = new Tween(this.horizontalScrollBar, this._hideScrollBarAnimationDuration, this._hideScrollBarAnimationEase);
				this._horizontalScrollBarHideTween.fadeTo(0);
				this._horizontalScrollBarHideTween.delay = delay;
				this._horizontalScrollBarHideTween.onComplete = horizontalScrollBarHideTween_onComplete;
				Starling.juggler.add(this._horizontalScrollBarHideTween);
			}
		}

		/**
		 * @private
		 */
		protected function hideVerticalScrollBar(delay:Number = 0):void
		{
			if(!this.verticalScrollBar || this._scrollBarDisplayMode != ScrollBarDisplayMode.FLOAT || this._verticalScrollBarHideTween)
			{
				return;
			}
			if(this.verticalScrollBar.alpha == 0)
			{
				return;
			}
			if(this._hideScrollBarAnimationDuration == 0 && delay == 0)
			{
				this.verticalScrollBar.alpha = 0;
			}
			else
			{
				this._verticalScrollBarHideTween = new Tween(this.verticalScrollBar, this._hideScrollBarAnimationDuration, this._hideScrollBarAnimationEase);
				this._verticalScrollBarHideTween.fadeTo(0);
				this._verticalScrollBarHideTween.delay = delay;
				this._verticalScrollBarHideTween.onComplete = verticalScrollBarHideTween_onComplete;
				Starling.juggler.add(this._verticalScrollBarHideTween);
			}
		}

		/**
		 * @private
		 */
		protected function revealHorizontalScrollBar():void
		{
			if(!this.horizontalScrollBar || this._scrollBarDisplayMode != ScrollBarDisplayMode.FLOAT)
			{
				return;
			}
			if(this._horizontalScrollBarHideTween)
			{
				Starling.juggler.remove(this._horizontalScrollBarHideTween);
				this._horizontalScrollBarHideTween = null;
			}
			this.horizontalScrollBar.alpha = 1;
		}

		/**
		 * @private
		 */
		protected function revealVerticalScrollBar():void
		{
			if(!this.verticalScrollBar || this._scrollBarDisplayMode != ScrollBarDisplayMode.FLOAT)
			{
				return;
			}
			if(this._verticalScrollBarHideTween)
			{
				Starling.juggler.remove(this._verticalScrollBarHideTween);
				this._verticalScrollBarHideTween = null;
			}
			this.verticalScrollBar.alpha = 1;
		}

		/**
		 * If scrolling hasn't already started, prepares the scroller to scroll
		 * and dispatches <code>FeathersEventType.SCROLL_START</code>.
		 */
		protected function startScroll():void
		{
			if(this._isScrolling)
			{
				return;
			}
			this._isScrolling = true;
			this.dispatchEventWith(FeathersEventType.SCROLL_START);
		}

		/**
		 * Prepares the scroller for normal interaction and dispatches
		 * <code>FeathersEventType.SCROLL_COMPLETE</code>.
		 */
		protected function completeScroll():void
		{
			if(!this._isScrolling || this._verticalAutoScrollTween || this._horizontalAutoScrollTween ||
				this._isDraggingHorizontally || this._isDraggingVertically ||
				this._horizontalScrollBarIsScrolling || this._verticalScrollBarIsScrolling)
			{
				return;
			}
			this._isScrolling = false;
			this.hideHorizontalScrollBar();
			this.hideVerticalScrollBar();
			//we validate to ensure that the final Event.SCROLL
			//dispatched before FeathersEventType.SCROLL_COMPLETE
			this.validate();
			this.dispatchEventWith(FeathersEventType.SCROLL_COMPLETE);
		}

		/**
		 * Scrolls to a pending scroll position, if required.
		 */
		protected function handlePendingScroll():void
		{
			if(this.pendingHorizontalScrollPosition === this.pendingHorizontalScrollPosition ||
				this.pendingVerticalScrollPosition === this.pendingVerticalScrollPosition) //!isNaN
			{
				this.throwTo(this.pendingHorizontalScrollPosition, this.pendingVerticalScrollPosition, this.pendingScrollDuration);
				this.pendingHorizontalScrollPosition = NaN;
				this.pendingVerticalScrollPosition = NaN;
			}
			if(this.hasPendingHorizontalPageIndex && this.hasPendingVerticalPageIndex)
			{
				//both
				this.throwToPage(this.pendingHorizontalPageIndex, this.pendingVerticalPageIndex, this.pendingScrollDuration);
			}
			else if(this.hasPendingHorizontalPageIndex)
			{
				//horizontal only
				this.throwToPage(this.pendingHorizontalPageIndex, this._verticalPageIndex, this.pendingScrollDuration);
			}
			else if(this.hasPendingVerticalPageIndex)
			{
				//vertical only
				this.throwToPage(this._horizontalPageIndex, this.pendingVerticalPageIndex, this.pendingScrollDuration);
			}
			this.hasPendingHorizontalPageIndex = false;
			this.hasPendingVerticalPageIndex = false;
		}

		/**
		 * @private
		 */
		protected function handlePendingRevealScrollBars():void
		{
			if(!this.isScrollBarRevealPending)
			{
				return;
			}
			this.isScrollBarRevealPending = false;
			if(this._scrollBarDisplayMode != ScrollBarDisplayMode.FLOAT)
			{
				return;
			}
			this.revealHorizontalScrollBar();
			this.revealVerticalScrollBar();
			this.hideHorizontalScrollBar(this._revealScrollBarsDuration);
			this.hideVerticalScrollBar(this._revealScrollBarsDuration);
		}

		/**
		 * @private
		 */
		protected function handlePendingPullView():void
		{
			if(this._isTopPullViewPending)
			{
				this._isTopPullViewPending = false;
				if(this._isTopPullViewActive)
				{
					if(this._topPullTween !== null)
					{
						this._topPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
						this._topPullTween = null;
					}
					if(this._topPullView is IValidating)
					{
						IValidating(this._topPullView).validate();
					}
					this._topPullView.visible = true;
					this._topPullViewRatio = 1;
					if(this._topPullViewDisplayMode === PullViewDisplayMode.DRAG)
					{
						var targetY:Number = this._topViewPortOffset +
							this._topPullView.pivotY * this._topPullView.scaleY;
						if(this.isCreated)
						{
							this._topPullView.y = targetY - this._topPullView.height;
							this._topPullTween = new Tween(this._topPullView, this._elasticSnapDuration, this._throwEase);
							this._topPullTween.animate("y", targetY);
							this._topPullTween.onUpdate = this.refreshTopPullViewMask;
							this._topPullTween.onComplete = this.topPullTween_onComplete;
							Starling.juggler.add(this._topPullTween);
						}
						else
						{
							//if this is the first time the component validates,
							//we don't need animation
							this._topPullView.y = targetY;
						}
					}
				}
				else
				{
					if(this._isScrolling)
					{
						this.restoreVerticalPullViews();
					}
					else
					{
						this.finishScrollingVertically();
					}
				}
			}
			if(this._isRightPullViewPending)
			{
				this._isRightPullViewPending = false;
				if(this._isRightPullViewActive)
				{
					if(this._rightPullTween !== null)
					{
						this._rightPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
						this._rightPullTween = null;
					}
					if(this._rightPullView is IValidating)
					{
						IValidating(this._rightPullView).validate();
					}
					this._rightPullView.visible = true;
					this._rightPullViewRatio = 1;
					if(this._rightPullViewDisplayMode === PullViewDisplayMode.DRAG)
					{
						var targetX:Number = this.actualWidth - this._rightViewPortOffset +
							this._rightPullView.pivotX * this._rightPullView.scaleX -
							this._rightPullView.width;
						if(this.isCreated)
						{
							this._rightPullView.x = targetX + this._rightPullView.width;
							this._rightPullTween = new Tween(this._rightPullView, this._elasticSnapDuration, this._throwEase);
							this._rightPullTween.animate("x", targetX);
							this._rightPullTween.onUpdate = this.refreshRightPullViewMask;
							this._rightPullTween.onComplete = this.rightPullTween_onComplete;
							Starling.juggler.add(this._rightPullTween);
						}
						else
						{
							//if this is the first time the component validates,
							//we don't need animation
							this._rightPullView.x = targetX;
						}
					}
				}
				else
				{
					if(this._isScrolling)
					{
						this.restoreHorizontalPullViews();
					}
					else
					{
						this.finishScrollingHorizontally();
					}
				}
			}
			if(this._isBottomPullViewPending)
			{
				this._isBottomPullViewPending = false;
				if(this._isBottomPullViewActive)
				{
					if(this._bottomPullTween !== null)
					{
						this._bottomPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
						this._bottomPullTween = null;
					}
					if(this._bottomPullView is IValidating)
					{
						IValidating(this._bottomPullView).validate();
					}
					this._bottomPullView.visible = true;
					this._bottomPullViewRatio = 1;
					if(this._bottomPullViewDisplayMode === PullViewDisplayMode.DRAG)
					{
						targetY = this.actualHeight - this._bottomViewPortOffset +
							this._bottomPullView.pivotY * this._bottomPullView.scaleY -
							this._bottomPullView.height;
						if(this.isCreated)
						{
							this._bottomPullView.y = targetY + this._bottomPullView.height;
							this._bottomPullTween = new Tween(this._bottomPullView, this._elasticSnapDuration, this._throwEase);
							this._bottomPullTween.animate("y", targetY);
							this._bottomPullTween.onUpdate = this.refreshBottomPullViewMask;
							this._bottomPullTween.onComplete = this.bottomPullTween_onComplete;
							Starling.juggler.add(this._bottomPullTween);
						}
						else
						{
							this._bottomPullView.y = targetY;
						}
					}
				}
				else
				{
					if(this._isScrolling)
					{
						this.restoreVerticalPullViews();
					}
					else
					{
						this.finishScrollingVertically();
					}
				}
			}
			if(this._isLeftPullViewPending)
			{
				this._isLeftPullViewPending = false;
				if(this._isLeftPullViewActive)
				{
					if(this._leftPullTween !== null)
					{
						this._leftPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
						this._leftPullTween = null;
					}
					if(this._leftPullView is IValidating)
					{
						IValidating(this._leftPullView).validate();
					}
					this._leftPullView.visible = true;
					this._leftPullViewRatio = 1;
					if(this._leftPullViewDisplayMode === PullViewDisplayMode.DRAG)
					{
						targetX = this._leftViewPortOffset +
							this._leftPullView.pivotX * this._leftPullView.scaleX;
						if(this.isCreated)
						{
							this._leftPullView.x = targetX - this._leftPullView.width;
							this._leftPullTween = new Tween(this._leftPullView, this._elasticSnapDuration, this._throwEase);
							this._leftPullTween.animate("x", targetX);
							this._leftPullTween.onUpdate = this.refreshLeftPullViewMask;
							this._leftPullTween.onComplete = this.leftPullTween_onComplete;
							Starling.juggler.add(this._leftPullTween);
						}
						else
						{
							//if this is the first time the component validates,
							//we don't need animation
							this._leftPullView.x = targetX;
						}
					}
				}
				else
				{
					if(this._isScrolling)
					{
						this.restoreHorizontalPullViews();
					}
					else
					{
						this.finishScrollingHorizontally();
					}
				}
			}
		}

		/**
		 * @private
		 */
		protected function checkForDrag():void
		{
			if(this._isScrollingStopped)
			{
				return;
			}
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var horizontalInchesMoved:Number = (this._currentTouchX - this._startTouchX) / (DeviceCapabilities.dpi / starling.contentScaleFactor);
			var verticalInchesMoved:Number = (this._currentTouchY - this._startTouchY) / (DeviceCapabilities.dpi / starling.contentScaleFactor);
			if(!this._isDraggingHorizontally &&
				(
					this._horizontalScrollPolicy === ScrollPolicy.ON ||
					(this._horizontalScrollPolicy === ScrollPolicy.AUTO && this._minHorizontalScrollPosition != this._maxHorizontalScrollPosition) ||
					(this._leftPullView !== null && (this._currentTouchX > this._startTouchX || this._horizontalScrollPosition < this._minHorizontalScrollPosition)) ||
					(this._rightPullView !== null && (this._currentTouchX < this._startTouchX || this._horizontalScrollPosition > this._minHorizontalScrollPosition))
				) &&
				(
					((horizontalInchesMoved <= -this._minimumDragDistance) && (this._hasElasticEdges || this._horizontalScrollPosition < this._maxHorizontalScrollPosition || this._rightPullView !== null)) ||
					((horizontalInchesMoved >= this._minimumDragDistance) && (this._hasElasticEdges || this._horizontalScrollPosition > this._minHorizontalScrollPosition || this._leftPullView !== null))
				))
			{
				if(this.horizontalScrollBar)
				{
					this.revealHorizontalScrollBar();
				}
				this._startTouchX = this._currentTouchX;
				this._startHorizontalScrollPosition = this._horizontalScrollPosition;
				this._isDraggingHorizontally = true;
				//if we haven't already started dragging in the other direction,
				//we need to dispatch the event that says we're starting.
				if(!this._isDraggingVertically)
				{
					this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
					var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
					exclusiveTouch.removeEventListener(Event.CHANGE, exclusiveTouch_changeHandler);
					exclusiveTouch.claimTouch(this._touchPointID, this);
					this.startScroll();
				}
			}
			if(!this._isDraggingVertically &&
				(
					this._verticalScrollPolicy == ScrollPolicy.ON ||
					(this._verticalScrollPolicy == ScrollPolicy.AUTO && this._minVerticalScrollPosition != this._maxVerticalScrollPosition) ||
					(this._topPullView !== null && (this._currentTouchY > this._startTouchY || this._verticalScrollPosition < this._minVerticalScrollPosition)) ||
					(this._bottomPullView !== null && (this._currentTouchY < this._startTouchY || this._verticalScrollPosition > this._minVerticalScrollPosition))
				) &&
				(
					((verticalInchesMoved <= -this._minimumDragDistance) && (this._hasElasticEdges || this._verticalScrollPosition < this._maxVerticalScrollPosition || this._bottomPullView !== null)) ||
					((verticalInchesMoved >= this._minimumDragDistance) && (this._hasElasticEdges || this._verticalScrollPosition > this._minVerticalScrollPosition || this._topPullView !== null))
				))
			{
				if(this.verticalScrollBar)
				{
					this.revealVerticalScrollBar();
				}
				this._startTouchY = this._currentTouchY;
				this._startVerticalScrollPosition = this._verticalScrollPosition;
				this._isDraggingVertically = true;
				if(!this._isDraggingHorizontally)
				{
					exclusiveTouch = ExclusiveTouch.forStage(this.stage);
					exclusiveTouch.removeEventListener(Event.CHANGE, exclusiveTouch_changeHandler);
					exclusiveTouch.claimTouch(this._touchPointID, this);
					this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
					this.startScroll();
				}
			}
			if(this._isDraggingHorizontally && !this._horizontalAutoScrollTween)
			{
				this.updateHorizontalScrollFromTouchPosition(this._currentTouchX);
			}
			if(this._isDraggingVertically && !this._verticalAutoScrollTween)
			{
				this.updateVerticalScrollFromTouchPosition(this._currentTouchY);
			}
		}

		/**
		 * @private
		 */
		protected function saveVelocity():void
		{
			this._pendingVelocityChange = false;
			if(this._isScrollingStopped)
			{
				return;
			}
			var now:int = getTimer();
			var timeOffset:int = now - this._previousTouchTime;
			if(timeOffset > 0)
			{
				//we're keeping previous velocity updates to improve accuracy
				this._previousVelocityX[this._previousVelocityX.length] = this._velocityX;
				if(this._previousVelocityX.length > MAXIMUM_SAVED_VELOCITY_COUNT)
				{
					this._previousVelocityX.shift();
				}
				this._previousVelocityY[this._previousVelocityY.length] = this._velocityY;
				if(this._previousVelocityY.length > MAXIMUM_SAVED_VELOCITY_COUNT)
				{
					this._previousVelocityY.shift();
				}
				this._velocityX = (this._currentTouchX - this._previousTouchX) / timeOffset;
				this._velocityY = (this._currentTouchY - this._previousTouchY) / timeOffset;
				this._previousTouchTime = now;
				this._previousTouchX = this._currentTouchX;
				this._previousTouchY = this._currentTouchY;
			}
		}

		/**
		 * @private
		 */
		protected function viewPort_resizeHandler(event:Event):void
		{
			if(this.ignoreViewPortResizing ||
				(this._viewPort.width == this._lastViewPortWidth && this._viewPort.height == this._lastViewPortHeight))
			{
				return;
			}
			this._lastViewPortWidth = this._viewPort.width;
			this._lastViewPortHeight = this._viewPort.height;
			if(this._isValidating)
			{
				this._hasViewPortBoundsChanged = true;
			}
			else
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		/**
		 * @private
		 */
		protected function childProperties_onChange(proxy:PropertyProxy, name:String):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function verticalScrollBar_changeHandler(event:Event):void
		{
			this.verticalScrollPosition = this.verticalScrollBar.value;
		}

		/**
		 * @private
		 */
		protected function horizontalScrollBar_changeHandler(event:Event):void
		{
			this.horizontalScrollPosition = this.horizontalScrollBar.value;
		}

		/**
		 * @private
		 */
		protected function horizontalScrollBar_beginInteractionHandler(event:Event):void
		{
			if(this._horizontalAutoScrollTween)
			{
				Starling.juggler.remove(this._horizontalAutoScrollTween);
				this._horizontalAutoScrollTween = null;
			}
			this._isDraggingHorizontally = false;
			this._horizontalScrollBarIsScrolling = true;
			this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
			if(!this._isScrolling)
			{
				this.startScroll();
			}
		}

		/**
		 * @private
		 */
		protected function horizontalScrollBar_endInteractionHandler(event:Event):void
		{
			this._horizontalScrollBarIsScrolling = false;
			this.dispatchEventWith(FeathersEventType.END_INTERACTION);
			this.completeScroll();
		}

		/**
		 * @private
		 */
		protected function verticalScrollBar_beginInteractionHandler(event:Event):void
		{
			if(this._verticalAutoScrollTween)
			{
				Starling.juggler.remove(this._verticalAutoScrollTween);
				this._verticalAutoScrollTween = null;
			}
			this._isDraggingVertically = false;
			this._verticalScrollBarIsScrolling = true;
			this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
			if(!this._isScrolling)
			{
				this.startScroll();
			}
		}

		/**
		 * @private
		 */
		protected function verticalScrollBar_endInteractionHandler(event:Event):void
		{
			this._verticalScrollBarIsScrolling = false;
			this.dispatchEventWith(FeathersEventType.END_INTERACTION);
			this.completeScroll();
		}

		/**
		 * @private
		 */
		protected function horizontalAutoScrollTween_onUpdate():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var pixelSize:Number = 1 / starling.contentScaleFactor;
			var viewPortX:Number = Math.round((this._leftViewPortOffset - this._horizontalScrollPosition) / pixelSize) * pixelSize;
			var targetViewPortX:Number = Math.round((this._leftViewPortOffset - this._targetHorizontalScrollPosition) / pixelSize) * pixelSize;
			if(viewPortX == targetViewPortX)
			{
				//we've reached the snapped position, but the tween may not
				//have ended yet. since the user won't see any further changes,
				//force the tween to the end.
				this._horizontalAutoScrollTween.advanceTime(this._horizontalAutoScrollTween.totalTime);
			}
		}

		/**
		 * @private
		 */
		protected function horizontalAutoScrollTween_onComplete():void
		{
			//because the onUpdate callback may call advanceTime(), remove
			//the callbacks to be sure that they aren't called too many times.
			if(this._horizontalAutoScrollTween !== null)
			{
				this._horizontalAutoScrollTween.onUpdate = null;
				this._horizontalAutoScrollTween.onComplete = null;
				this._horizontalAutoScrollTween = null;
			}
			//the page index will not have updated during the animation, so we
			//need to ensure that it is updated now.
			this.invalidate(INVALIDATION_FLAG_SCROLL);
			this.finishScrollingHorizontally();
		}

		/**
		 * @private
		 */
		protected function verticalAutoScrollTween_onUpdate():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var pixelSize:Number = 1 / starling.contentScaleFactor;
			var viewPortY:Number = Math.round((this._topViewPortOffset - this._verticalScrollPosition) / pixelSize) * pixelSize;
			var targetViewPortY:Number = Math.round((this._topViewPortOffset - this._targetVerticalScrollPosition) / pixelSize) * pixelSize;
			if(viewPortY == targetViewPortY)
			{
				//we've reached the snapped position, but the tween may not
				//have ended yet. since the user won't see any further changes,
				//force the tween to the end.
				this._verticalAutoScrollTween.advanceTime(this._verticalAutoScrollTween.totalTime);
			}
		}

		/**
		 * @private
		 */
		protected function verticalAutoScrollTween_onComplete():void
		{
			//because the onUpdate callback may call advanceTime(), remove
			//the callbacks to be sure that they aren't called too many times.
			if(this._verticalAutoScrollTween !== null)
			{
				this._verticalAutoScrollTween.onUpdate = null;
				this._verticalAutoScrollTween.onComplete = null;
				this._verticalAutoScrollTween = null;
			}
			//the page index will not have updated during the animation, so we
			//need to ensure that it is updated now.
			this.invalidate(INVALIDATION_FLAG_SCROLL);
			this.finishScrollingVertically();
		}

		/**
		 * @private
		 */
		protected function topPullTween_onComplete():void
		{
			this._topPullTween = null;
			if(this._isTopPullViewActive)
			{
				this._topPullViewRatio = 1;
			}
			else
			{
				this._topPullViewRatio = 0;
			}
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		/**
		 * @private
		 */
		protected function rightPullTween_onComplete():void
		{
			this._rightPullTween = null;
			if(this._isRightPullViewActive)
			{
				this._rightPullViewRatio = 1;
			}
			else
			{
				this._rightPullViewRatio = 0;
			}
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		/**
		 * @private
		 */
		protected function bottomPullTween_onComplete():void
		{
			this._bottomPullTween = null;
			if(this._isBottomPullViewActive)
			{
				this._bottomPullViewRatio = 1;
			}
			else
			{
				this._bottomPullViewRatio = 0;
			}
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		/**
		 * @private
		 */
		protected function leftPullTween_onComplete():void
		{
			this._leftPullTween = null;
			if(this._isLeftPullViewActive)
			{
				this._leftPullViewRatio = 1;
			}
			else
			{
				this._leftPullViewRatio = 0;
			}
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		/**
		 * @private
		 */
		protected function horizontalScrollBarHideTween_onComplete():void
		{
			this._horizontalScrollBarHideTween = null;
		}

		/**
		 * @private
		 */
		protected function verticalScrollBarHideTween_onComplete():void
		{
			this._verticalScrollBarHideTween = null;
		}

		/**
		 * @private
		 */
		protected function scroller_touchHandler(event:TouchEvent):void
		{
			//it's rare, but the stage could be null if the scroller is removed
			//in a listener for the same event.
			if(!this._isEnabled || this.stage === null)
			{
				this._touchPointID = -1;
				return;
			}
			if(this._touchPointID != -1)
			{
				return;
			}

			//any began touch is okay here. we don't need to check all touches.
			var touch:Touch = event.getTouch(this, TouchPhase.BEGAN);
			if(touch === null)
			{
				return;
			}

			if(this._interactionMode == ScrollInteractionMode.TOUCH_AND_SCROLL_BARS &&
				(event.interactsWith(DisplayObject(this.horizontalScrollBar)) || event.interactsWith(DisplayObject(this.verticalScrollBar))))
			{
				return;
			}

			var touchPosition:Point = touch.getLocation(this, Pool.getPoint());
			var touchX:Number = touchPosition.x;
			var touchY:Number = touchPosition.y;
			Pool.putPoint(touchPosition);
			if(touchX < this._leftViewPortOffset || touchY < this._topViewPortOffset ||
				touchX >= (this.actualWidth - this._rightViewPortOffset) ||
				touchY >= (this.actualHeight - this._bottomViewPortOffset))
			{
				return;
			}

			var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
			if(exclusiveTouch.getClaim(touch.id))
			{
				//already claimed
				return;
			}

			//if the scroll policy is off, we shouldn't stop this animation
			if(this._horizontalAutoScrollTween !== null && this._horizontalScrollPolicy !== ScrollPolicy.OFF)
			{
				Starling.juggler.remove(this._horizontalAutoScrollTween);
				this._horizontalAutoScrollTween = null;
			}
			if(this._verticalAutoScrollTween !== null && this._verticalScrollPolicy !== ScrollPolicy.OFF)
			{
				Starling.juggler.remove(this._verticalAutoScrollTween);
				this._verticalAutoScrollTween = null;
			}

			this._touchPointID = touch.id;
			this._velocityX = 0;
			this._velocityY = 0;
			this._previousVelocityX.length = 0;
			this._previousVelocityY.length = 0;
			this._previousTouchTime = getTimer();
			this._previousTouchX = this._startTouchX = this._currentTouchX = touchX;
			this._previousTouchY = this._startTouchY = this._currentTouchY = touchY;
			this._startHorizontalScrollPosition = this._horizontalScrollPosition;
			this._startVerticalScrollPosition = this._verticalScrollPosition;
			this._isScrollingStopped = false;
			if(!this._isScrolling || !this._snapToPages)
			{
				//if snapToPages is enabled, we need it to snap to the nearest
				//page on TouchPhase.ENDED, even if we don't drag again
				//BowlerHatLLC/feathersui-starling#1771
				this._isDraggingVertically = false;
				this._isDraggingHorizontally = false;
			}
			if(this._isScrolling)
			{
				//if it was scrolling, stop it immediately
				this.completeScroll();
			}

			this.addEventListener(Event.ENTER_FRAME, scroller_enterFrameHandler);

			//we need to listen on the stage because if we scroll the bottom or
			//right edge past the top of the scroller, it gets stuck and we stop
			//receiving touch events for "this".
			this.stage.addEventListener(TouchEvent.TOUCH, stage_touchHandler);

			exclusiveTouch.addEventListener(Event.CHANGE, exclusiveTouch_changeHandler);
		}

		/**
		 * @private
		 */
		protected function scroller_enterFrameHandler(event:Event):void
		{
			this.saveVelocity();
		}

		/**
		 * @private
		 */
		protected function stage_touchHandler(event:TouchEvent):void
		{
			if(this._touchPointID < 0)
			{
				//if the touch is claimed with ExclusiveTouch by a child, the
				//listener is removed, but the current event will keep bubbling
				return;
			}
			var touch:Touch = event.getTouch(this.stage, null, this._touchPointID);
			if(touch === null)
			{
				return;
			}

			if(touch.phase === TouchPhase.MOVED)
			{
				var touchPosition:Point = touch.getLocation(this, Pool.getPoint());
				this._currentTouchX = touchPosition.x;
				this._currentTouchY = touchPosition.y;
				Pool.putPoint(touchPosition);
				this.checkForDrag();
				//we don't call saveVelocity() on TouchPhase.MOVED because the
				//time interval may be very short, which could lead to
				//inaccurate results. instead, we wait for the next frame.
				this._pendingVelocityChange = true;
			}
			else if(touch.phase === TouchPhase.ENDED)
			{
				if(this._pendingVelocityChange)
				{
					//we may need to do this one last time because the enter
					//frame listener may not have been called since the last
					//TouchPhase.MOVED
					this.saveVelocity();
				}
				if(!this._isDraggingHorizontally && !this._isDraggingVertically)
				{
					ExclusiveTouch.forStage(this.stage).removeEventListener(Event.CHANGE, exclusiveTouch_changeHandler);
				}
				this.removeEventListener(Event.ENTER_FRAME, scroller_enterFrameHandler);
				this.stage.removeEventListener(TouchEvent.TOUCH, stage_touchHandler);
				this._touchPointID = -1;
				this.dispatchEventWith(FeathersEventType.END_INTERACTION);

				if(!this._isTopPullViewActive && this._isDraggingVertically &&
					this._topPullView !== null &&
					this._topPullViewRatio >= 1)
				{
					this._isTopPullViewActive = true;
					this._topPullView.dispatchEventWith(Event.UPDATE);
					this.dispatchEventWith(Event.UPDATE, false, this._topPullView);
				}
				if(!this._isRightPullViewActive && this._isDraggingHorizontally &&
					this._rightPullView !== null &&
					this._rightPullViewRatio >= 1)
				{
					this._isRightPullViewActive = true;
					this._rightPullView.dispatchEventWith(Event.UPDATE);
					this.dispatchEventWith(Event.UPDATE, false, this._rightPullView);
				}
				if(!this._isBottomPullViewActive && this._isDraggingVertically &&
					this._bottomPullView !== null &&
					this._bottomPullViewRatio >= 1)
				{
					this._isBottomPullViewActive = true;
					this._bottomPullView.dispatchEventWith(Event.UPDATE);
					this.dispatchEventWith(Event.UPDATE, false, this._bottomPullView);
				}
				if(!this._isLeftPullViewActive && this._isDraggingHorizontally && 
					this._leftPullView !== null &&
					this._leftPullViewRatio >= 1)
				{
					this._isLeftPullViewActive = true;
					this._leftPullView.dispatchEventWith(Event.UPDATE);
					this.dispatchEventWith(Event.UPDATE, false, this._leftPullView);
				}

				var isFinishingHorizontally:Boolean = false;
				var adjustedMinHorizontalScrollPosition:Number = this._minHorizontalScrollPosition;
				if(this._isLeftPullViewActive && this._hasElasticEdges)
				{
					adjustedMinHorizontalScrollPosition -= this._leftPullView.width;
				}
				var adjustedMaxHorizontalScrollPosition:Number = this._maxHorizontalScrollPosition;
				if(this._isRightPullViewActive && this._hasElasticEdges)
				{
					adjustedMaxHorizontalScrollPosition += this._rightPullView.width;
				}
				if(this._horizontalScrollPosition < adjustedMinHorizontalScrollPosition ||
					this._horizontalScrollPosition > adjustedMaxHorizontalScrollPosition)
				{
					isFinishingHorizontally = true;
					this.finishScrollingHorizontally();
				}
				var isFinishingVertically:Boolean = false;
				var adjustedMinVerticalScrollPosition:Number = this._minVerticalScrollPosition;
				if(this._isTopPullViewActive && this._hasElasticEdges)
				{
					adjustedMinVerticalScrollPosition -= this._topPullView.height;
				}
				var adjustedMaxVerticalScrollPosition:Number = this._maxVerticalScrollPosition;
				if(this._isBottomPullViewActive && this._hasElasticEdges)
				{
					adjustedMaxVerticalScrollPosition += this._bottomPullView.height;
				}
				if(this._verticalScrollPosition < adjustedMinVerticalScrollPosition ||
					this._verticalScrollPosition > adjustedMaxVerticalScrollPosition)
				{
					isFinishingVertically = true;
					this.finishScrollingVertically();
				}

				if(isFinishingHorizontally && isFinishingVertically)
				{
					return;
				}

				if(!isFinishingHorizontally)
				{
					if(this._isDraggingHorizontally)
					{
						//take the average for more accuracy
						var sum:Number = this._velocityX * CURRENT_VELOCITY_WEIGHT;
						var velocityCount:int = this._previousVelocityX.length;
						var totalWeight:Number = CURRENT_VELOCITY_WEIGHT;
						for(var i:int = 0; i < velocityCount; i++)
						{
							var weight:Number = VELOCITY_WEIGHTS[i];
							sum += this._previousVelocityX.shift() * weight;
							totalWeight += weight;
						}
						this.throwHorizontally(sum / totalWeight);
					}
					else
					{
						this.hideHorizontalScrollBar();
					}
				}

				if(!isFinishingVertically)
				{
					if(this._isDraggingVertically)
					{
						sum = this._velocityY * CURRENT_VELOCITY_WEIGHT;
						velocityCount = this._previousVelocityY.length;
						totalWeight = CURRENT_VELOCITY_WEIGHT;
						for(i = 0; i < velocityCount; i++)
						{
							weight = VELOCITY_WEIGHTS[i];
							sum += this._previousVelocityY.shift() * weight;
							totalWeight += weight;
						}
						this.throwVertically(sum / totalWeight);
					}
					else
					{
						this.hideVerticalScrollBar();
					}
				}
			}
		}

		/**
		 * @private
		 */
		protected function exclusiveTouch_changeHandler(event:Event, touchID:int):void
		{
			if(this._touchPointID < 0 || this._touchPointID != touchID || this._isDraggingHorizontally || this._isDraggingVertically)
			{
				return;
			}
			var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
			if(exclusiveTouch.getClaim(touchID) == this)
			{
				return;
			}

			this._touchPointID = -1;
			this.removeEventListener(Event.ENTER_FRAME, scroller_enterFrameHandler);
			this.stage.removeEventListener(TouchEvent.TOUCH, stage_touchHandler);
			exclusiveTouch.removeEventListener(Event.CHANGE, exclusiveTouch_changeHandler);
			this.dispatchEventWith(FeathersEventType.END_INTERACTION);
		}

		/**
		 * @private
		 */
		protected function nativeStage_mouseWheelHandler(event:MouseEvent):void
		{
			if(!this._isEnabled)
			{
				this._touchPointID = -1;
				return;
			}
			if((this._verticalMouseWheelScrollDirection === Direction.VERTICAL && (this._maxVerticalScrollPosition == this._minVerticalScrollPosition || this._verticalScrollPolicy == ScrollPolicy.OFF)) ||
				(this._verticalMouseWheelScrollDirection === Direction.HORIZONTAL && (this._maxHorizontalScrollPosition == this._minHorizontalScrollPosition || this._horizontalScrollPolicy == ScrollPolicy.OFF)))
			{
				return;
			}

			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var nativeScaleFactor:Number = 1;
			if(starling.supportHighResolutions)
			{
				nativeScaleFactor = starling.nativeStage.contentsScaleFactor;
			}
			var starlingViewPort:Rectangle = starling.viewPort;
			var scaleFactor:Number = nativeScaleFactor / starling.contentScaleFactor;
			var point:Point = Pool.getPoint(
				(event.stageX - starlingViewPort.x) * scaleFactor,
				(event.stageY - starlingViewPort.y) * scaleFactor);
			var isContained:Boolean = this.stage !== null && this.contains(this.stage.hitTest(point));
			if(!isContained)
			{
				Pool.putPoint(point);
			}
			else
			{
				this.globalToLocal(point, point);
				var localMouseX:Number = point.x;
				var localMouseY:Number = point.y;
				Pool.putPoint(point);
				if(localMouseX < this._leftViewPortOffset || localMouseY < this._topViewPortOffset ||
					localMouseX >= this.actualWidth - this._rightViewPortOffset ||
					localMouseY >= this.actualHeight - this._bottomViewPortOffset)
				{
					return;
				}
				var targetHorizontalScrollPosition:Number = this._horizontalScrollPosition;
				var targetVerticalScrollPosition:Number = this._verticalScrollPosition;
				var scrollStep:Number = this._verticalMouseWheelScrollStep;
				if(this._verticalMouseWheelScrollDirection == Direction.HORIZONTAL)
				{
					if(scrollStep !== scrollStep) //isNaN
					{
						scrollStep = this.actualHorizontalScrollStep;
					}
					targetHorizontalScrollPosition -= event.delta * scrollStep;
					if(targetHorizontalScrollPosition < this._minHorizontalScrollPosition)
					{
						targetHorizontalScrollPosition = this._minHorizontalScrollPosition;
					}
					else if(targetHorizontalScrollPosition > this._maxHorizontalScrollPosition)
					{
						targetHorizontalScrollPosition = this._maxHorizontalScrollPosition;
					}
				}
				else //vertical
				{
					if(scrollStep !== scrollStep) //isNaN
					{
						scrollStep = this.actualVerticalScrollStep;
					}
					targetVerticalScrollPosition -= event.delta * scrollStep;
					if(targetVerticalScrollPosition < this._minVerticalScrollPosition)
					{
						targetVerticalScrollPosition = this._minVerticalScrollPosition;
					}
					else if(targetVerticalScrollPosition > this._maxVerticalScrollPosition)
					{
						targetVerticalScrollPosition = this._maxVerticalScrollPosition;
					}
				}
				this.throwTo(targetHorizontalScrollPosition, targetVerticalScrollPosition, this._mouseWheelScrollDuration);
			}
		}

		/**
		 * @private
		 */
		protected function nativeStage_orientationChangeHandler(event:flash.events.Event):void
		{
			if(this._touchPointID < 0)
			{
				return;
			}
			this._startTouchX = this._previousTouchX = this._currentTouchX;
			this._startTouchY = this._previousTouchY = this._currentTouchY;
			this._startHorizontalScrollPosition = this._horizontalScrollPosition;
			this._startVerticalScrollPosition = this._verticalScrollPosition;
		}

		/**
		 * @private
		 */
		protected function horizontalScrollBar_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._horizontalScrollBarTouchPointID = -1;
				return;
			}

			var displayHorizontalScrollBar:DisplayObject = DisplayObject(event.currentTarget);
			if(this._horizontalScrollBarTouchPointID >= 0)
			{
				var touch:Touch = event.getTouch(displayHorizontalScrollBar, TouchPhase.ENDED, this._horizontalScrollBarTouchPointID);
				if(!touch)
				{
					return;
				}

				this._horizontalScrollBarTouchPointID = -1;
				var touchPosition:Point = touch.getLocation(displayHorizontalScrollBar, Pool.getPoint());
				var isInBounds:Boolean = this.horizontalScrollBar.hitTest(touchPosition) !== null;
				Pool.putPoint(touchPosition);
				if(!isInBounds)
				{
					this.hideHorizontalScrollBar();
				}
			}
			else
			{
				touch = event.getTouch(displayHorizontalScrollBar, TouchPhase.BEGAN);
				if(touch)
				{
					this._horizontalScrollBarTouchPointID = touch.id;
					return;
				}
				if(this._isScrolling)
				{
					return;
				}
				touch = event.getTouch(displayHorizontalScrollBar, TouchPhase.HOVER);
				if(touch)
				{
					this.revealHorizontalScrollBar();
					return;
				}

				//end hover
				this.hideHorizontalScrollBar();
			}
		}

		/**
		 * @private
		 */
		protected function verticalScrollBar_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._verticalScrollBarTouchPointID = -1;
				return;
			}

			var displayVerticalScrollBar:DisplayObject = DisplayObject(event.currentTarget);
			if(this._verticalScrollBarTouchPointID >= 0)
			{
				var touch:Touch = event.getTouch(displayVerticalScrollBar, TouchPhase.ENDED, this._verticalScrollBarTouchPointID);
				if(!touch)
				{
					return;
				}

				this._verticalScrollBarTouchPointID = -1;
				var touchPosition:Point = touch.getLocation(displayVerticalScrollBar, Pool.getPoint());
				var isInBounds:Boolean = this.verticalScrollBar.hitTest(touchPosition) !== null;
				Pool.putPoint(touchPosition);
				if(!isInBounds)
				{
					this.hideVerticalScrollBar();
				}
			}
			else
			{
				touch = event.getTouch(displayVerticalScrollBar, TouchPhase.BEGAN);
				if(touch)
				{
					this._verticalScrollBarTouchPointID = touch.id;
					return;
				}
				if(this._isScrolling)
				{
					return;
				}
				touch = event.getTouch(displayVerticalScrollBar, TouchPhase.HOVER);
				if(touch)
				{
					this.revealVerticalScrollBar();
					return;
				}

				//end hover
				this.hideVerticalScrollBar();
			}
		}

		/**
		 * @private
		 */
		protected function scroller_addedToStageHandler(event:Event):void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			starling.nativeStage.addEventListener(MouseEvent.MOUSE_WHEEL, nativeStage_mouseWheelHandler, false, 0, true);
			starling.nativeStage.addEventListener("orientationChange", nativeStage_orientationChangeHandler, false, 0, true);
		}

		/**
		 * @private
		 */
		protected function scroller_removedFromStageHandler(event:Event):void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			starling.nativeStage.removeEventListener(MouseEvent.MOUSE_WHEEL, nativeStage_mouseWheelHandler);
			starling.nativeStage.removeEventListener("orientationChange", nativeStage_orientationChangeHandler);
			if(this._touchPointID >= 0)
			{
				var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
				exclusiveTouch.removeEventListener(Event.CHANGE, exclusiveTouch_changeHandler);
			}
			this._touchPointID = -1;
			this._horizontalScrollBarTouchPointID = -1;
			this._verticalScrollBarTouchPointID = -1;
			this._isDraggingHorizontally = false;
			this._isDraggingVertically = false;
			this._velocityX = 0;
			this._velocityY = 0;
			this._previousVelocityX.length = 0;
			this._previousVelocityY.length = 0;
			this._horizontalScrollBarIsScrolling = false;
			this._verticalScrollBarIsScrolling = false;
			this.removeEventListener(Event.ENTER_FRAME, scroller_enterFrameHandler);
			this.stage.removeEventListener(TouchEvent.TOUCH, stage_touchHandler);
			if(this._verticalAutoScrollTween)
			{
				Starling.juggler.remove(this._verticalAutoScrollTween);
				this._verticalAutoScrollTween = null;
			}
			if(this._horizontalAutoScrollTween)
			{
				Starling.juggler.remove(this._horizontalAutoScrollTween);
				this._horizontalAutoScrollTween = null;
			}
			if(this._topPullTween)
			{
				this._topPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
				this._topPullTween = null;
			}
			if(this._rightPullTween)
			{
				this._rightPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
				this._rightPullTween = null;
			}
			if(this._bottomPullTween)
			{
				this._bottomPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
				this._bottomPullTween = null;
			}
			if(this._leftPullTween)
			{
				this._leftPullTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
				this._leftPullTween = null;
			}

			//if we stopped the animation while the list was outside the scroll
			//bounds, then let's account for that
			var oldHorizontalScrollPosition:Number = this._horizontalScrollPosition;
			var oldVerticalScrollPosition:Number = this._verticalScrollPosition;
			if(this._horizontalScrollPosition < this._minHorizontalScrollPosition)
			{
				this._horizontalScrollPosition = this._minHorizontalScrollPosition;
			}
			else if(this._horizontalScrollPosition > this._maxHorizontalScrollPosition)
			{
				this._horizontalScrollPosition = this._maxHorizontalScrollPosition;
			}
			if(this._verticalScrollPosition < this._minVerticalScrollPosition)
			{
				this._verticalScrollPosition = this._minVerticalScrollPosition;
			}
			else if(this._verticalScrollPosition > this._maxVerticalScrollPosition)
			{
				this._verticalScrollPosition = this._maxVerticalScrollPosition;
			}
			if(oldHorizontalScrollPosition != this._horizontalScrollPosition ||
				oldVerticalScrollPosition != this._verticalScrollPosition)
			{
				this.dispatchEventWith(Event.SCROLL);
			}
			this.completeScroll();
		}

		/**
		 * @private
		 */
		override protected function focusInHandler(event:Event):void
		{
			super.focusInHandler(event);
			//using priority here is a hack so that objects deeper in the
			//display list have a chance to cancel the event first.
			var priority:int = -getDisplayObjectDepthFromStage(this);
			this.stage.starling.nativeStage.addEventListener(KeyboardEvent.KEY_DOWN, nativeStage_keyDownHandler, false, priority, true);
			this.stage.starling.nativeStage.addEventListener("gestureDirectionalTap", stage_gestureDirectionalTapHandler, false, priority, true);
		}

		/**
		 * @private
		 */
		override protected function focusOutHandler(event:Event):void
		{
			super.focusOutHandler(event);
			this.stage.starling.nativeStage.removeEventListener(KeyboardEvent.KEY_DOWN, nativeStage_keyDownHandler);
			this.stage.starling.nativeStage.removeEventListener("gestureDirectionalTap", stage_gestureDirectionalTapHandler);
		}

		/**
		 * @private
		 */
		protected function nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.isDefaultPrevented())
			{
				return;
			}
			var newHorizontalScrollPosition:Number = this._horizontalScrollPosition;
			var newVerticalScrollPosition:Number = this._verticalScrollPosition;
			if(event.keyCode == Keyboard.HOME)
			{
				newVerticalScrollPosition = this._minVerticalScrollPosition;
			}
			else if(event.keyCode == Keyboard.END)
			{
				newVerticalScrollPosition = this._maxVerticalScrollPosition;
			}
			else if(event.keyCode == Keyboard.PAGE_UP)
			{
				newVerticalScrollPosition = Math.max(this._minVerticalScrollPosition, this._verticalScrollPosition - this.viewPort.visibleHeight);
			}
			else if(event.keyCode == Keyboard.PAGE_DOWN)
			{
				newVerticalScrollPosition = Math.min(this._maxVerticalScrollPosition, this._verticalScrollPosition + this.viewPort.visibleHeight);
			}
			else if(event.keyCode == Keyboard.UP)
			{
				newVerticalScrollPosition = Math.max(this._minVerticalScrollPosition, this._verticalScrollPosition - this.verticalScrollStep);
			}
			else if(event.keyCode == Keyboard.DOWN)
			{
				newVerticalScrollPosition = Math.min(this._maxVerticalScrollPosition, this._verticalScrollPosition + this.verticalScrollStep);
			}
			else if(event.keyCode == Keyboard.LEFT)
			{
				newHorizontalScrollPosition = Math.max(this._minHorizontalScrollPosition, this._horizontalScrollPosition - this.horizontalScrollStep);
			}
			else if(event.keyCode == Keyboard.RIGHT)
			{
				newHorizontalScrollPosition = Math.min(this._maxHorizontalScrollPosition, this._horizontalScrollPosition + this.horizontalScrollStep);
			}
			if(this._horizontalScrollPosition != newHorizontalScrollPosition &&
				this._horizontalScrollPolicy != ScrollPolicy.OFF)
			{
				event.preventDefault();
				this.horizontalScrollPosition = newHorizontalScrollPosition;
			}
			if(this._verticalScrollPosition != newVerticalScrollPosition &&
				this._verticalScrollPolicy != ScrollPolicy.OFF)
			{
				event.preventDefault();
				this.verticalScrollPosition = newVerticalScrollPosition;
			}
		}

		/**
		 * @private
		 */
		protected function stage_gestureDirectionalTapHandler(event:TransformGestureEvent):void
		{
			if(event.isDefaultPrevented())
			{
				return;
			}
			var newHorizontalScrollPosition:Number = this._horizontalScrollPosition;
			var newVerticalScrollPosition:Number = this._verticalScrollPosition;
			if(event.offsetY < 0)
			{
				newVerticalScrollPosition = Math.max(this._minVerticalScrollPosition, this._verticalScrollPosition - this.verticalScrollStep);
			}
			else if(event.offsetY > 0)
			{
				newVerticalScrollPosition = Math.min(this._maxVerticalScrollPosition, this._verticalScrollPosition + this.verticalScrollStep);
			}
			else if(event.offsetX < 0)
			{
				newHorizontalScrollPosition = Math.max(this._maxHorizontalScrollPosition, this._horizontalScrollPosition - this.horizontalScrollStep);
			}
			else if(event.offsetX > 0)
			{
				newHorizontalScrollPosition = Math.min(this._maxHorizontalScrollPosition, this._horizontalScrollPosition + this.horizontalScrollStep);
			}
			if(this._horizontalScrollPosition != newHorizontalScrollPosition)
			{
				event.stopImmediatePropagation();
				//event.preventDefault();
				this.horizontalScrollPosition = newHorizontalScrollPosition;
			}
			if(this._verticalScrollPosition != newVerticalScrollPosition)
			{
				event.stopImmediatePropagation();
				//event.preventDefault();
				this.verticalScrollPosition = newVerticalScrollPosition;
			}
		}
	}
}


================================================
FILE: source/feathers/controls/SimpleScrollBar.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IFocusDisplayObject;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IValidating;
	import feathers.core.PropertyProxy;
	import feathers.events.FeathersEventType;
	import feathers.layout.Direction;
	import feathers.skins.IStyleProvider;
	import feathers.utils.math.clamp;
	import feathers.utils.math.roundDownToNearest;
	import feathers.utils.math.roundToNearest;
	import feathers.utils.math.roundUpToNearest;

	import flash.events.TimerEvent;
	import flash.geom.Point;
	import flash.utils.Timer;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * A style name to add to the scroll bar's thumb sub-component.
	 * Typically used by a theme to provide different styles to different
	 * scroll bars.
	 *
	 * <p>In the following example, a custom thumb style name is passed
	 * to the scroll bar:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.customThumbStyleName = "my-custom-thumb";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-thumb", setCustomThumbStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_THUMB
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #thumbFactory
	 */
	[Style(name="customThumbStyleName",type="String")]

	/**
	 * Determines if the scroll bar's thumb can be dragged horizontally or
	 * vertically. When this value changes, the scroll bar's width and
	 * height values do not change automatically.
	 *
	 * <p>Note: When using a <code>SimpleScrollBar</code> with a scrolling
	 * container, the container will automatically set the correct
	 * <code>direction</code> value. Generally, you should not need to set this
	 * style manually.</p>
	 *
	 * <p>In the following example, the direction is changed to vertical:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.direction = Direction.VERTICAL;</listing>
	 *
	 * <p><strong>Note:</strong> The <code>Direction.NONE</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.Direction.HORIZONTAL
	 *
	 * @see feathers.layout.Direction#HORIZONTAL
	 * @see feathers.layout.Direction#VERTICAL
	 */
	[Style(name="direction",type="String")]

	/**
	 * Determines if the scroll bar's thumb will be resized based on the
	 * scrollable range, or if it will be rendered at its preferred size.
	 *
	 * <p>In the following example, the thumb size is fixed:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.fixedThumbSize = true;</listing>
	 *
	 * @default false
	 */
	[Style(name="fixedThumbSize",type="Boolean")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the padding is changed to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, above the thumb.
	 *
	 * <p>In the following example, the top padding is changed to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, to the right of the thumb.
	 *
	 * <p>In the following example, the right padding is changed to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, below the thumb.
	 *
	 * <p>In the following example, the bottom padding is changed to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, to the left of the thumb.
	 *
	 * <p>In the following example, the left padding is changed to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * scrollBar.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * Dispatched when the scroll bar's value changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #value
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the user starts dragging the scroll bar's thumb.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.BEGIN_INTERACTION
	 */
	[Event(name="beginInteraction",type="starling.events.Event")]

	/**
	 * Dispatched when the user stops dragging the scroll bar's thumb.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.END_INTERACTION
	 */
	[Event(name="endInteraction",type="starling.events.Event")]

	/**
	 * Select a value between a minimum and a maximum by dragging a thumb over
	 * a physical range. This type of scroll bar does not have a visible track,
	 * and it does not have increment and decrement buttons. It is ideal for
	 * mobile applications where the scroll bar is often simply a visual element
	 * to indicate the scroll position. For a more feature-rich scroll bar,
	 * see the <code>ScrollBar</code> component.
	 *
	 * <p>The following example updates a list to use simple scroll bars:</p>
	 *
	 * <listing version="3.0">
	 * list.horizontalScrollBarFactory = function():IScrollBar
	 * {
	 *     return new SimpleScrollBar();
	 * };
	 * list.verticalScrollBarFactory = function():IScrollBar
	 * {
	 *     return new SimpleScrollBar();
	 * };</listing>
	 *
	 * @see ../../../help/simple-scroll-bar.html How to use the Feathers SimpleScrollBar component
	 * @see feathers.controls.ScrollBar
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class SimpleScrollBar extends FeathersControl implements IDirectionalScrollBar
	{
		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_THUMB_FACTORY:String = "thumbFactory";

		/**
		 * The default value added to the <code>styleNameList</code> of the thumb.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_THUMB:String = "feathers-simple-scroll-bar-thumb";

		/**
		 * The default <code>IStyleProvider</code> for all <code>SimpleScrollBar</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static function defaultThumbFactory():BasicButton
		{
			return new Button();
		}

		/**
		 * Constructor.
		 */
		public function SimpleScrollBar()
		{
			super();
			this.addEventListener(Event.REMOVED_FROM_STAGE, removedFromStageHandler);
		}

		/**
		 * The value added to the <code>styleNameList</code> of the thumb. This
		 * variable is <code>protected</code> so that sub-classes can customize
		 * the thumb style name in their constructors instead of using the
		 * default style name defined by <code>DEFAULT_CHILD_STYLE_NAME_THUMB</code>.
		 *
		 * <p>To customize the thumb style name without subclassing, see
		 * <code>customThumbStyleName</code>.</p>
		 *
		 * @see #style:customThumbStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var thumbStyleName:String = DEFAULT_CHILD_STYLE_NAME_THUMB;

		/**
		 * @private
		 */
		protected var _thumbExplicitWidth:Number;

		/**
		 * @private
		 */
		protected var _thumbExplicitHeight:Number;

		/**
		 * @private
		 */
		protected var _thumbExplicitMinWidth:Number;

		/**
		 * @private
		 */
		protected var _thumbExplicitMinHeight:Number;

		/**
		 * The thumb sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #thumbFactory
		 * @see #createThumb()
		 */
		protected var thumb:DisplayObject;

		/**
		 * @private
		 */
		protected var track:Quad;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return SimpleScrollBar.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _direction:String = Direction.HORIZONTAL;

		[Inspectable(type="String",enumeration="horizontal,vertical")]
		/**
		 * @private
		 */
		public function get direction():String
		{
			return this._direction;
		}

		/**
		 * @private
		 */
		public function set direction(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._direction === value)
			{
				return;
			}
			this._direction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
			this.invalidate(INVALIDATION_FLAG_THUMB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _fixedThumbSize:Boolean = false;

		/**
		 * @private
		 */
		public function get fixedThumbSize():Boolean
		{
			return this._fixedThumbSize;
		}

		/**
		 * @private
		 */
		public function set fixedThumbSize(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._fixedThumbSize === value)
			{
				return;
			}
			this._fixedThumbSize = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * Determines if the value should be clamped to the range between the
		 * minimum and maximum. If <code>false</code> and the value is outside of the range,
		 * the thumb will shrink as if the range were increasing.
		 *
		 * <p>In the following example, the clamping behavior is updated:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.clampToRange = true;</listing>
		 *
		 * @default false
		 */
		public var clampToRange:Boolean = false;

		/**
		 * @private
		 */
		protected var _value:Number = 0;

		/**
		 * @inheritDoc
		 *
		 * @default 0
		 *
		 * @see #maximum
		 * @see #minimum
		 * @see #step
		 * @see #page
		 * @see #event:change
		 */
		public function get value():Number
		{
			return this._value;
		}

		/**
		 * @private
		 */
		public function set value(newValue:Number):void
		{
			if(this.clampToRange)
			{
				newValue = clamp(newValue, this._minimum, this._maximum);
			}
			if(this._value == newValue)
			{
				return;
			}
			this._value = newValue;
			this.invalidate(INVALIDATION_FLAG_DATA);
			if(this.liveDragging || !this.isDragging)
			{
				this.dispatchEventWith(Event.CHANGE);
			}
		}

		/**
		 * @private
		 */
		protected var _minimum:Number = 0;

		/**
		 * @inheritDoc
		 *
		 * @default 0
		 *
		 * @see #value
		 * @see #maximum
		 */
		public function get minimum():Number
		{
			return this._minimum;
		}

		/**
		 * @private
		 */
		public function set minimum(value:Number):void
		{
			if(this._minimum == value)
			{
				return;
			}
			this._minimum = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _maximum:Number = 0;

		/**
		 * @inheritDoc
		 *
		 * @default 0
		 *
		 * @see #value
		 * @see #minimum
		 */
		public function get maximum():Number
		{
			return this._maximum;
		}

		/**
		 * @private
		 */
		public function set maximum(value:Number):void
		{
			if(this._maximum == value)
			{
				return;
			}
			this._maximum = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _step:Number = 0;

		/**
		 * @inheritDoc
		 *
		 * @default 0
		 *
		 * @see #value
		 * @see #page
		 */
		public function get step():Number
		{
			return this._step;
		}

		/**
		 * @private
		 */
		public function set step(value:Number):void
		{
			this._step = value;
		}

		/**
		 * @private
		 */
		protected var _page:Number = 0;

		/**
		 * @inheritDoc
		 *
		 * @default 0
		 *
		 * @see #value
		 * @see #step
		 */
		public function get page():Number
		{
			return this._page;
		}

		/**
		 * @private
		 */
		public function set page(value:Number):void
		{
			if(this._page == value)
			{
				return;
			}
			this._page = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var currentRepeatAction:Function;

		/**
		 * @private
		 */
		protected var _repeatTimer:Timer;

		/**
		 * @private
		 */
		protected var _repeatDelay:Number = 0.05;

		/**
		 * The time, in seconds, before actions are repeated. The first repeat
		 * happens after a delay that is five times longer than the following
		 * repeats.
		 *
		 * <p>In the following example, the repeat delay is changed to 500 milliseconds:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.repeatDelay = 0.5;</listing>
		 *
		 * @default 0.05
		 */
		public function get repeatDelay():Number
		{
			return this._repeatDelay;
		}

		/**
		 * @private
		 */
		public function set repeatDelay(value:Number):void
		{
			if(this._repeatDelay == value)
			{
				return;
			}
			this._repeatDelay = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var isDragging:Boolean = false;

		/**
		 * Determines if the scroll bar dispatches the <code>Event.CHANGE</code>
		 * event every time the thumb moves, or only once it stops moving.
		 *
		 * <p>In the following example, live dragging is disabled:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.liveDragging = false;</listing>
		 *
		 * @default true
		 */
		public var liveDragging:Boolean = true;

		/**
		 * @private
		 */
		protected var _thumbFactory:Function;

		/**
		 * A function used to generate the scroll bar's thumb sub-component.
		 * The thumb must be an instance of <code>BasicButton</code>. This
		 * factory can be used to change properties on the thumb when it is
		 * first created. For instance, if you are skinning Feathers components
		 * without a theme, you might use this factory to set skins and other
		 * styles on the thumb.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():BasicButton</pre>
		 *
		 * <p>In the following example, a custom thumb factory is passed
		 * to the scroll bar:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.thumbFactory = function():BasicButton
		 * {
		 *     var thumb:BasicButton = new BasicButton();
		 *     var skin:ImageSkin = new ImageSkin( upTexture );
		 *     skin.setTextureForState( ButtonState.DOWN, downTexture );
		 *     thumb.defaultSkin = skin;
		 *     return thumb;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 */
		public function get thumbFactory():Function
		{
			return this._thumbFactory;
		}

		/**
		 * @private
		 */
		public function set thumbFactory(value:Function):void
		{
			if(this._thumbFactory == value)
			{
				return;
			}
			this._thumbFactory = value;
			this.invalidate(INVALIDATION_FLAG_THUMB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customThumbStyleName:String;

		/**
		 * @private
		 */
		public function get customThumbStyleName():String
		{
			return this._customThumbStyleName;
		}

		/**
		 * @private
		 */
		public function set customThumbStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customThumbStyleName === value)
			{
				return;
			}
			this._customThumbStyleName = value;
			this.invalidate(INVALIDATION_FLAG_THUMB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _thumbProperties:PropertyProxy;

		/**
		 * An object that stores properties for the scroll bar's thumb, and the
		 * properties will be passed down to the thumb when the scroll bar
		 * validates. For a list of available properties, refer to
		 * <a href="Button.html"><code>feathers.controls.BasicButton</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>thumbFactory</code> function instead
		 * of using <code>thumbProperties</code> will result in better
		 * performance.</p>
		 *
		 * <p>In the following example, the scroll bar's thumb properties
		 * are updated:</p>
		 *
		 * <listing version="3.0">
		 * scrollBar.thumbProperties.defaultSkin = new Image( upTexture );
		 * scrollBar.thumbProperties.downSkin = new Image( downTexture );</listing>
		 *
		 * @default null
		 *
		 * @see #thumbFactory
		 * @see feathers.controls.BasicButton
		 */
		public function get thumbProperties():Object
		{
			if(!this._thumbProperties)
			{
				this._thumbProperties = new PropertyProxy(thumbProperties_onChange);
			}
			return this._thumbProperties;
		}

		/**
		 * @private
		 */
		public function set thumbProperties(value:Object):void
		{
			if(this._thumbProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._thumbProperties)
			{
				this._thumbProperties.removeOnChangeCallback(thumbProperties_onChange);
			}
			this._thumbProperties = PropertyProxy(value);
			if(this._thumbProperties)
			{
				this._thumbProperties.addOnChangeCallback(thumbProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _touchStartX:Number = NaN;

		/**
		 * @private
		 */
		protected var _touchStartY:Number = NaN;

		/**
		 * @private
		 */
		protected var _thumbStartX:Number = NaN;

		/**
		 * @private
		 */
		protected var _thumbStartY:Number = NaN;

		/**
		 * @private
		 */
		protected var _touchValue:Number;

		/**
		 * @private
		 */
		protected var _pageStartValue:Number;

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(!this.track)
			{
				this.track = new Quad(10, 10, 0xff00ff);
				this.track.alpha = 0;
				this.track.addEventListener(TouchEvent.TOUCH, track_touchHandler);
				this.addChild(this.track);
			}
			if(this._value < this._minimum)
			{
				this.value = this._minimum;
			}
			else if(this._value > this._maximum)
			{
				this.value = this._maximum;
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var thumbFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_THUMB_FACTORY);

			if(thumbFactoryInvalid)
			{
				this.createThumb();
			}

			if(thumbFactoryInvalid || stylesInvalid)
			{
				this.refreshThumbStyles();
			}

			if(dataInvalid || thumbFactoryInvalid || stateInvalid)
			{
				this.refreshEnabled();
			}

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			this.layout();
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			this.thumb.width = this._thumbExplicitWidth;
			this.thumb.height = this._thumbExplicitHeight;
			var measureThumb:IMeasureDisplayObject;
			if(this.thumb is IMeasureDisplayObject)
			{
				measureThumb = IMeasureDisplayObject(this.thumb);
				measureThumb.minWidth = this._thumbExplicitMinWidth;
				measureThumb.minHeight = this._thumbExplicitMinHeight;
			}
			if(this.thumb is IValidating)
			{
				IValidating(this.thumb).validate();
			}

			var range:Number = this._maximum - this._minimum;
			var adjustedPage:Number = this._page;
			if(adjustedPage == 0)
			{
				//fall back to using step!
				adjustedPage = this._step;
			}
			if(adjustedPage > range)
			{
				adjustedPage = range;
			}
			var newWidth:Number = this._explicitWidth;
			var newHeight:Number = this._explicitHeight;
			var newMinWidth:Number = this._explicitMinWidth;
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsWidth)
			{
				newWidth = this.thumb.width;
				if(this._direction !== Direction.VERTICAL && adjustedPage != 0)
				{
					newWidth *= range / adjustedPage;
				}
				newWidth += this._paddingLeft + this._paddingRight;
			}
			if(needsHeight)
			{
				newHeight = this.thumb.height;
				if(this._direction === Direction.VERTICAL && adjustedPage != 0)
				{
					newHeight *= range / adjustedPage;
				}
				newHeight += this._paddingTop + this._paddingBottom;
			}
			if(needsMinWidth)
			{
				if(measureThumb !== null)
				{
					newMinWidth = measureThumb.minWidth;
				}
				else
				{
					newMinWidth = this.thumb.width;
				}
				if(this._direction !== Direction.VERTICAL && adjustedPage != 0)
				{
					newMinWidth *= range / adjustedPage;
				}
				newMinWidth += this._paddingLeft + this._paddingRight;
			}
			if(needsMinHeight)
			{
				if(measureThumb !== null)
				{
					newMinHeight = measureThumb.minHeight;
				}
				else
				{
					newMinHeight = this.thumb.height;
				}
				if(this._direction === Direction.VERTICAL && adjustedPage != 0)
				{
					newMinHeight *= range / adjustedPage;
				}
				newMinHeight += this._paddingTop + this._paddingBottom;
			}
			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * Creates and adds the <code>thumb</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #thumb
		 * @see #thumbFactory
		 * @see #style:customThumbStyleName
		 */
		protected function createThumb():void
		{
			if(this.thumb)
			{
				this.thumb.removeFromParent(true);
				this.thumb = null;
			}

			var factory:Function = this._thumbFactory != null ? this._thumbFactory : defaultThumbFactory;
			var thumbStyleName:String = this._customThumbStyleName != null ? this._customThumbStyleName : this.thumbStyleName;
			var thumb:BasicButton = BasicButton(factory());
			thumb.styleNameList.add(thumbStyleName);
			if(thumb is IFocusDisplayObject)
			{
				thumb.isFocusEnabled = false;
			}
			thumb.keepDownStateOnRollOut = true;
			thumb.addEventListener(TouchEvent.TOUCH, thumb_touchHandler);
			this.addChild(thumb);
			this.thumb = thumb;

			if(this.thumb is IFeathersControl)
			{
				IFeathersControl(this.thumb).initializeNow();
			}
			if(this.thumb is IMeasureDisplayObject)
			{
				var measureThumb:IMeasureDisplayObject = IMeasureDisplayObject(this.thumb);
				this._thumbExplicitWidth = measureThumb.explicitWidth;
				this._thumbExplicitHeight = measureThumb.explicitHeight;
				this._thumbExplicitMinWidth = measureThumb.explicitMinWidth;
				this._thumbExplicitMinHeight = measureThumb.explicitMinHeight;
			}
			else
			{
				//this is a regular display object, and we'll treat its
				//measurements as explicit when we auto-size the scroll bar
				this._thumbExplicitWidth = this.thumb.width;
				this._thumbExplicitHeight = this.thumb.height;
				this._thumbExplicitMinWidth = this._thumbExplicitWidth;
				this._thumbExplicitMinHeight = this._thumbExplicitHeight;
			}
		}

		/**
		 * @private
		 */
		protected function refreshThumbStyles():void
		{
			for(var propertyName:String in this._thumbProperties)
			{
				var propertyValue:Object = this._thumbProperties[propertyName];
				this.thumb[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function refreshEnabled():void
		{
			if(this.thumb is IFeathersControl)
			{
				IFeathersControl(this.thumb).isEnabled = this._isEnabled && this._maximum > this._minimum;
			}
		}

		/**
		 * @private
		 */
		protected function layout():void
		{
			this.track.width = this.actualWidth;
			this.track.height = this.actualHeight;

			var range:Number = this._maximum - this._minimum;
			this.thumb.visible = range > 0;
			if(!this.thumb.visible)
			{
				return;
			}

			//this will auto-size the thumb, if needed
			if(this.thumb is IValidating)
			{
				IValidating(this.thumb).validate();
			}

			var contentWidth:Number = this.actualWidth - this._paddingLeft - this._paddingRight;
			var contentHeight:Number = this.actualHeight - this._paddingTop - this._paddingBottom;
			var adjustedPage:Number = this._page;
			if(this._page == 0)
			{
				adjustedPage = this._step;
			}
			else if(adjustedPage > range)
			{
				adjustedPage = range;
			}
			var valueOffset:Number = 0;
			if(this._value < this._minimum)
			{
				valueOffset = (this._minimum - this._value);
			}
			if(this._value > this._maximum)
			{
				valueOffset = (this._value - this._maximum);
			}
			if(this._direction == Direction.VERTICAL)
			{
				this.thumb.width = contentWidth;
				var thumbMinHeight:Number = this._thumbExplicitMinHeight;
				if(this.thumb is IMeasureDisplayObject)
				{
					thumbMinHeight = IMeasureDisplayObject(this.thumb).minHeight;
				}
				if(this._fixedThumbSize)
				{
					this.thumb.height = this._thumbExplicitHeight;
				}
				else
				{
					var thumbHeight:Number = contentHeight * adjustedPage / range;
					var heightOffset:Number = contentHeight - thumbHeight;
					if(heightOffset > thumbHeight)
					{
						heightOffset = thumbHeight;
					}
					heightOffset *= valueOffset / (range * thumbHeight / contentHeight);
					thumbHeight -= heightOffset;
					if(thumbHeight < thumbMinHeight)
					{
						thumbHeight = thumbMinHeight;
					}
					this.thumb.height = thumbHeight;
				}
				this.thumb.x = this._paddingLeft + (this.actualWidth - this._paddingLeft - this._paddingRight - this.thumb.width) / 2;
				var trackScrollableHeight:Number = contentHeight - this.thumb.height;
				var thumbY:Number = trackScrollableHeight * (this._value - this._minimum) / range;
				if(thumbY > trackScrollableHeight)
				{
					thumbY = trackScrollableHeight;
				}
				else if(thumbY < 0)
				{
					thumbY = 0;
				}
				this.thumb.y = this._paddingTop + thumbY;
			}
			else //horizontal
			{
				var thumbMinWidth:Number = this._thumbExplicitMinWidth;
				if(this.thumb is IMeasureDisplayObject)
				{
					thumbMinWidth = IMeasureDisplayObject(this.thumb).minWidth;
				}
				if(this._fixedThumbSize)
				{
					this.thumb.width = this._thumbExplicitWidth;
				}
				else
				{
					var thumbWidth:Number = contentWidth * adjustedPage / range;
					var widthOffset:Number = contentWidth - thumbWidth;
					if(widthOffset > thumbWidth)
					{
						widthOffset = thumbWidth;
					}
					widthOffset *= valueOffset / (range * thumbWidth / contentWidth);
					thumbWidth -= widthOffset;
					if(thumbWidth < thumbMinWidth)
					{
						thumbWidth = thumbMinWidth;
					}
					this.thumb.width = thumbWidth;
				}
				this.thumb.height = contentHeight;
				var trackScrollableWidth:Number = contentWidth - this.thumb.width;
				var thumbX:Number = trackScrollableWidth * (this._value - this._minimum) / range;
				if(thumbX > trackScrollableWidth)
				{
					thumbX = trackScrollableWidth;
				}
				else if(thumbX < 0)
				{
					thumbX = 0;
				}
				this.thumb.x = this._paddingLeft + thumbX;
				this.thumb.y = this._paddingTop + (this.actualHeight - this._paddingTop - this._paddingBottom - this.thumb.height) / 2;
			}

			//final validation to avoid juggler next frame issues
			if(this.thumb is IValidating)
			{
				IValidating(this.thumb).validate();
			}
		}

		/**
		 * @private
		 */
		protected function locationToValue(location:Point):Number
		{
			var percentage:Number = 0;
			if(this._direction == Direction.VERTICAL)
			{
				var trackScrollableHeight:Number = this.actualHeight - this.thumb.height - this._paddingTop - this._paddingBottom;
				if(trackScrollableHeight > 0)
				{
					var yOffset:Number = location.y - this._touchStartY - this._paddingTop;
					var yPosition:Number = Math.min(Math.max(0, this._thumbStartY + yOffset), trackScrollableHeight);
					percentage = yPosition / trackScrollableHeight;
				}
			}
			else //horizontal
			{
				var trackScrollableWidth:Number = this.actualWidth - this.thumb.width - this._paddingLeft - this._paddingRight;
				if(trackScrollableWidth > 0)
				{
					var xOffset:Number = location.x - this._touchStartX - this._paddingLeft;
					var xPosition:Number = Math.min(Math.max(0, this._thumbStartX + xOffset), trackScrollableWidth);
					percentage = xPosition / trackScrollableWidth;
				}
			}

			return this._minimum + percentage * (this._maximum - this._minimum);
		}

		/**
		 * @private
		 */
		protected function adjustPage():void
		{
			var range:Number = this._maximum - this._minimum;
			var adjustedPage:Number = this._page;
			if(adjustedPage == 0)
			{
				adjustedPage = this._step;
			}
			if(adjustedPage > range)
			{
				adjustedPage = range;
			}
			if(this._touchValue < this._pageStartValue)
			{
				var newValue:Number = Math.max(this._touchValue, this._value - adjustedPage);
				if(this._step != 0 && newValue != this._maximum && newValue != this._minimum)
				{
					newValue = roundDownToNearest(newValue, this._step);
				}
				newValue = clamp(newValue, this._minimum, this._maximum);
				this.value = newValue;
			}
			else if(this._touchValue > this._pageStartValue)
			{
				newValue = Math.min(this._touchValue, this._value + adjustedPage);
				if(this._step != 0 && newValue != this._maximum && newValue != this._minimum)
				{
					newValue = roundUpToNearest(newValue, this._step);
				}
				newValue = clamp(newValue, this._minimum, this._maximum);
				this.value = newValue;
			}
		}

		/**
		 * @private
		 */
		protected function startRepeatTimer(action:Function):void
		{
			this.currentRepeatAction = action;
			if(this._repeatDelay > 0)
			{
				if(!this._repeatTimer)
				{
					this._repeatTimer = new Timer(this._repeatDelay * 1000);
					this._repeatTimer.addEventListener(TimerEvent.TIMER, repeatTimer_timerHandler);
				}
				else
				{
					this._repeatTimer.reset();
					this._repeatTimer.delay = this._repeatDelay * 1000;
				}
				this._repeatTimer.start();
			}
		}

		/**
		 * @private
		 */
		protected function thumbProperties_onChange(proxy:PropertyProxy, name:Object):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function removedFromStageHandler(event:Event):void
		{
			this._touchPointID = -1;
			if(this._repeatTimer)
			{
				this._repeatTimer.stop();
			}
		}

		/**
		 * @private
		 */
		protected function track_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._touchPointID = -1;
				return;
			}

			if(this._touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(track, null, this._touchPointID);
				if(touch === null)
				{
					return;
				}
				if(touch.phase === TouchPhase.MOVED)
				{
					var location:Point = touch.getLocation(this, Pool.getPoint());
					this._touchValue = this.locationToValue(location);
					Pool.putPoint(location);
				}
				else if(touch.phase === TouchPhase.ENDED)
				{
					this._touchPointID = -1;
					this._repeatTimer.stop();
				}
			}
			else
			{
				touch = event.getTouch(this.track, TouchPhase.BEGAN);
				if(touch === null)
				{
					return;
				}
				this._touchPointID = touch.id;
				location = touch.getLocation(this, Pool.getPoint());
				this._touchStartX = location.x;
				this._touchStartY = location.y;
				this._thumbStartX = this._touchStartX;
				this._thumbStartY = this._touchStartY;
				this._touchValue = this.locationToValue(location);
				Pool.putPoint(location);
				this._pageStartValue = this._value;
				this.adjustPage();
				this.startRepeatTimer(this.adjustPage);
			}
		}

		/**
		 * @private
		 */
		protected function thumb_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				return;
			}

			if(this._touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this.thumb, null, this._touchPointID);
				if(touch === null)
				{
					return;
				}
				if(touch.phase === TouchPhase.MOVED)
				{
					var location:Point = touch.getLocation(this, Pool.getPoint());
					var newValue:Number = this.locationToValue(location);
					Pool.putPoint(location);
					if(this._step != 0 && newValue != this._maximum && newValue != this._minimum)
					{
						newValue = roundToNearest(newValue, this._step);
					}
					this.value = newValue;
				}
				else if(touch.phase === TouchPhase.ENDED)
				{
					this._touchPointID = -1;
					this.isDragging = false;
					if(!this.liveDragging)
					{
						this.dispatchEventWith(Event.CHANGE);
					}
					this.dispatchEventWith(FeathersEventType.END_INTERACTION);
				}
			}
			else
			{
				touch = event.getTouch(this.thumb, TouchPhase.BEGAN);
				if(touch === null)
				{
					return;
				}
				location = touch.getLocation(this, Pool.getPoint());
				this._touchPointID = touch.id;
				this._thumbStartX = this.thumb.x;
				this._thumbStartY = this.thumb.y;
				this._touchStartX = location.x;
				this._touchStartY = location.y;
				Pool.putPoint(location);
				this.isDragging = true;
				this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
			}
		}

		/**
		 * @private
		 */
		protected function repeatTimer_timerHandler(event:TimerEvent):void
		{
			if(this._repeatTimer.currentCount < 5)
			{
				return;
			}
			this.currentRepeatAction();
		}
	}
}


================================================
FILE: source/feathers/controls/Slider.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IFocusDisplayObject;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IValidating;
	import feathers.core.PropertyProxy;
	import feathers.events.ExclusiveTouch;
	import feathers.events.FeathersEventType;
	import feathers.layout.Direction;
	import feathers.skins.IStyleProvider;
	import feathers.utils.math.clamp;
	import feathers.utils.math.roundDownToNearest;
	import feathers.utils.math.roundToNearest;
	import feathers.utils.math.roundUpToNearest;

	import flash.events.TimerEvent;
	import flash.geom.Point;
	import flash.ui.Keyboard;
	import flash.utils.Timer;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.events.KeyboardEvent;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * A style name to add to the slider's maximum track sub-component.
	 * Typically used by a theme to provide different skins to different
	 * sliders.
	 *
	 * <p>In the following example, a custom maximum track style name is
	 * passed to the slider:</p>
	 *
	 * <listing version="3.0">
	 * slider.customMaximumTrackStyleName = "my-custom-maximum-track";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-maximum-track", setCustomMaximumTrackStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #maximumTrackFactory
	 */
	[Style(name="customMaximumTrackStyleName",type="String")]

	/**
	 * A style name to add to the slider's minimum track sub-component.
	 * Typically used by a theme to provide different styles to different
	 * sliders.
	 *
	 * <p>In the following example, a custom minimum track style name is
	 * passed to the slider:</p>
	 *
	 * <listing version="3.0">
	 * slider.customMinimumTrackStyleName = "my-custom-minimum-track";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-minimum-track", setCustomMinimumTrackStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #minimumTrackFactory
	 */
	[Style(name="customMinimumTrackStyleName",type="String")]

	/**
	 * A style name to add to the slider's thumb sub-component. Typically
	 * used by a theme to provide different styles to different sliders.
	 *
	 * <p>In the following example, a custom thumb style name is passed
	 * to the slider:</p>
	 *
	 * <listing version="3.0">
	 * slider.customThumbStyleName = "my-custom-thumb";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-thumb", setCustomThumbStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_THUMB
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #thumbFactory
	 */
	[Style(name="customThumbStyleName",type="String")]

	/**
	 * Determines if the slider's thumb can be dragged horizontally or
	 * vertically. When this value changes, the slider's width and height
	 * values do not change automatically.
	 *
	 * <p>In the following example, the direction is changed to vertical:</p>
	 *
	 * <listing version="3.0">
	 * slider.direction = Direction.VERTICAL;</listing>
	 *
	 * <p><strong>Note:</strong> The <code>Direction.NONE</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.Direction.HORIZONTAL
	 *
	 * @see feathers.layout.Direction#HORIZONTAL
	 * @see feathers.layout.Direction#VERTICAL
	 */
	[Style(name="direction",type="String")]

	/**
	 * The space, in pixels, between the maximum position of the thumb and
	 * the maximum edge of the track. May be negative to extend the range
	 * of the thumb.
	 *
	 * <p>In the following example, maximum padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * slider.maximumPadding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:minimumPadding
	 */
	[Style(name="maximumPadding",type="Number")]

	/**
	 * The space, in pixels, between the minimum position of the thumb and
	 * the minimum edge of the track. May be negative to extend the range of
	 * the thumb.
	 *
	 * <p>In the following example, minimum padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * slider.minimumPadding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:maximumPadding
	 */
	[Style(name="minimumPadding",type="Number")]

	/**
	 * Determines if the thumb should be displayed.
	 *
	 * <p>In the following example, the thumb is hidden:</p>
	 *
	 * <listing version="3.0">
	 * slider.showThumb = false;</listing>
	 *
	 * @default true
	 */
	[Style(name="showThumb",type="Boolean")]

	/**
	 * Offsets the position of the thumb by a certain number of pixels in a
	 * direction perpendicular to the track. This does not affect the
	 * measurement of the slider. The slider will measure itself as if the
	 * thumb were not offset from its original position.
	 *
	 * <p>In the following example, the thumb is offset by 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * slider.thumbOffset = 20;</listing>
	 *
	 * @default 0
	 */
	[Style(name="thumbOffset",type="Number")]

	/**
	 * Determines how the slider's value changes when the track is touched.
	 *
	 * <p>If <code>showThumb</code> is set to <code>false</code>, the slider
	 * will always behave as if <code>trackInteractionMode</code> has been
	 * set to <code>TrackInteractionMode.TO_VALUE</code>. In other
	 * words, the value of <code>trackInteractionMode</code> may be ignored
	 * if the thumb is hidden.</p>
	 *
	 * <p>In the following example, the slider's track interaction is changed:</p>
	 *
	 * <listing version="3.0">
	 * slider.trackScaleMode = TrackInteractionMode.BY_PAGE;</listing>
	 *
	 * @default TrackInteractionMode.TO_VALUE
	 *
	 * @see feathers.controls.TrackInteractionMode#TO_VALUE
	 * @see feathers.controls.TrackInteractionMode#BY_PAGE
	 * @see #page
	 */
	[Style(name="trackInteractionMode",type="String")]

	/**
	 * Determines how the minimum and maximum track skins are positioned and
	 * sized.
	 *
	 * <p>In the following example, the slider is given two tracks:</p>
	 *
	 * <listing version="3.0">
	 * slider.trackLayoutMode = TrackLayoutMode.SPLIT;</listing>
	 *
	 * @default feathers.controls.TrackLayoutMode.SINGLE
	 *
	 * @see feathers.controls.TrackLayoutMode#SINGLE
	 * @see feathers.controls.TrackLayoutMode#SPLIT
	 * @see #style:trackScaleMode
	 */
	[Style(name="trackLayoutMode",type="String")]

	/**
	 * Determines how the minimum and maximum track skins are positioned and
	 * sized.
	 *
	 * <p>In the following example, the slider's track layout is customized:</p>
	 *
	 * <listing version="3.0">
	 * slider.trackScaleMode = TrackScaleMode.EXACT_FIT;</listing>
	 *
	 * @default feathers.controls.TrackScaleMode.DIRECTIONAL
	 *
	 * @see feathers.controls.TrackScaleMode#DIRECTIONAL
	 * @see feathers.controls.TrackScaleMode#EXACT_FIT
	 * @see #style:trackLayoutMode
	 */
	[Style(name="trackScaleMode",type="String")]

	/**
	 * Dispatched when the slider's value changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #value
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the user starts dragging the slider's thumb or track.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.BEGIN_INTERACTION
	 */
	[Event(name="beginInteraction",type="starling.events.Event")]

	/**
	 * Dispatched when the user stops dragging the slider's thumb or track.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.END_INTERACTION
	 */
	[Event(name="endInteraction",type="starling.events.Event")]

	/**
	 * Select a value between a minimum and a maximum by dragging a thumb over
	 * the bounds of a track. The slider's track is divided into two parts split
	 * by the thumb.
	 *
	 * <p>The following example sets the slider's range and listens for when the
	 * value changes:</p>
	 *
	 * <listing version="3.0">
	 * var slider:Slider = new Slider();
	 * slider.minimum = 0;
	 * slider.maximum = 100;
	 * slider.step = 1;
	 * slider.page = 10;
	 * slider.value = 12;
	 * slider.addEventListener( Event.CHANGE, slider_changeHandler );
	 * this.addChild( slider );</listing>
	 *
	 * @see ../../../help/slider.html How to use the Feathers Slider component
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class Slider extends FeathersControl implements IDirectionalScrollBar, IFocusDisplayObject
	{
		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_THUMB_FACTORY:String = "thumbFactory";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_MINIMUM_TRACK_FACTORY:String = "minimumTrackFactory";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_MAXIMUM_TRACK_FACTORY:String = "maximumTrackFactory";

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * minimum track.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK:String = "feathers-slider-minimum-track";

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * maximum track.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK:String = "feathers-slider-maximum-track";

		/**
		 * The default value added to the <code>styleNameList</code> of the thumb.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_THUMB:String = "feathers-slider-thumb";

		/**
		 * The default <code>IStyleProvider</code> for all <code>Slider</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static function defaultThumbFactory():BasicButton
		{
			return new Button();
		}

		/**
		 * @private
		 */
		protected static function defaultMinimumTrackFactory():BasicButton
		{
			return new Button();
		}

		/**
		 * @private
		 */
		protected static function defaultMaximumTrackFactory():BasicButton
		{
			return new Button();
		}

		/**
		 * Constructor.
		 */
		public function Slider()
		{
			super();
			this.addEventListener(Event.REMOVED_FROM_STAGE, slider_removedFromStageHandler);
		}

		/**
		 * The value added to the <code>styleNameList</code> of the minimum
		 * track. This variable is <code>protected</code> so that sub-classes
		 * can customize the minimum track style name in their constructors
		 * instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK</code>.
		 *
		 * <p>To customize the minimum track style name without subclassing, see
		 * <code>customMinimumTrackStyleName</code>.</p>
		 *
		 * @see #style:customMinimumTrackStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var minimumTrackStyleName:String = DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK;

		/**
		 * The value added to the <code>styleNameList</code> of the maximum
		 * track. This variable is <code>protected</code> so that sub-classes
		 * can customize the maximum track style name in their constructors
		 * instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK</code>.
		 *
		 * <p>To customize the maximum track style name without subclassing, see
		 * <code>customMaximumTrackStyleName</code>.</p>
		 *
		 * @see #style:customMaximumTrackStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var maximumTrackStyleName:String = DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK;

		/**
		 * The value added to the <code>styleNameList</code> of the thumb. This
		 * variable is <code>protected</code> so that sub-classes can customize
		 * the thumb style name in their constructors instead of using the
		 * default style name defined by <code>DEFAULT_CHILD_STYLE_NAME_THUMB</code>.
		 *
		 * <p>To customize the thumb style name without subclassing, see
		 * <code>customThumbStyleName</code>.</p>
		 *
		 * @see #style:customThumbStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var thumbStyleName:String = DEFAULT_CHILD_STYLE_NAME_THUMB;

		/**
		 * The thumb sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #thumbFactory
		 * @see #createThumb()
		 */
		protected var thumb:DisplayObject;

		/**
		 * The minimum track sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #minimumTrackFactory
		 * @see #createMinimumTrack()
		 */
		protected var minimumTrack:DisplayObject;

		/**
		 * The maximum track sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #maximumTrackFactory
		 * @see #createMaximumTrack()
		 */
		protected var maximumTrack:DisplayObject;

		/**
		 * @private
		 */
		protected var _minimumTrackSkinExplicitWidth:Number;

		/**
		 * @private
		 */
		protected var _minimumTrackSkinExplicitHeight:Number;

		/**
		 * @private
		 */
		protected var _minimumTrackSkinExplicitMinWidth:Number;

		/**
		 * @private
		 */
		protected var _minimumTrackSkinExplicitMinHeight:Number;

		/**
		 * @private
		 */
		protected var _maximumTrackSkinExplicitWidth:Number;

		/**
		 * @private
		 */
		protected var _maximumTrackSkinExplicitHeight:Number;

		/**
		 * @private
		 */
		protected var _maximumTrackSkinExplicitMinWidth:Number;

		/**
		 * @private
		 */
		protected var _maximumTrackSkinExplicitMinHeight:Number;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return Slider.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _direction:String = Direction.HORIZONTAL;

		[Inspectable(type="String",enumeration="horizontal,vertical")]
		/**
		 * @private
		 */
		public function get direction():String
		{
			return this._direction;
		}

		/**
		 * @private
		 */
		public function set direction(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._direction === value)
			{
				return;
			}
			this._direction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
			this.invalidate(INVALIDATION_FLAG_MINIMUM_TRACK_FACTORY);
			this.invalidate(INVALIDATION_FLAG_MAXIMUM_TRACK_FACTORY);
			this.invalidate(INVALIDATION_FLAG_THUMB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _value:Number = 0;

		/**
		 * The value of the slider, between the minimum and maximum.
		 *
		 * <p>In the following example, the value is changed to 12:</p>
		 *
		 * <listing version="3.0">
		 * slider.minimum = 0;
		 * slider.maximum = 100;
		 * slider.step = 1;
		 * slider.page = 10
		 * slider.value = 12;</listing>
		 *
		 * @default 0
		 *
		 * @see #minimum
		 * @see #maximum
		 * @see #step
		 * @see #page
		 */
		public function get value():Number
		{
			return this._value;
		}

		/**
		 * @private
		 */
		public function set value(newValue:Number):void
		{
			if(this._step != 0 && newValue != this._maximum && newValue != this._minimum)
			{
				newValue = roundToNearest(newValue - this._minimum, this._step) + this._minimum;
			}
			newValue = clamp(newValue, this._minimum, this._maximum);
			if(this._value == newValue)
			{
				return;
			}
			this._value = newValue;
			this.invalidate(INVALIDATION_FLAG_DATA);
			if(this.liveDragging || !this.isDragging)
			{
				this.dispatchEventWith(Event.CHANGE);
			}
		}

		/**
		 * @private
		 */
		protected var _minimum:Number = 0;

		/**
		 * The slider's value will not go lower than the minimum.
		 *
		 * <p>In the following example, the minimum is set to 0:</p>
		 *
		 * <listing version="3.0">
		 * slider.minimum = 0;
		 * slider.maximum = 100;
		 * slider.step = 1;
		 * slider.page = 10
		 * slider.value = 12;</listing>
		 *
		 * @default 0
		 *
		 * @see #value
		 * @see #maximum
		 */
		public function get minimum():Number
		{
			return this._minimum;
		}

		/**
		 * @private
		 */
		public function set minimum(value:Number):void
		{
			if(this._minimum == value)
			{
				return;
			}
			this._minimum = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _maximum:Number = 0;

		/**
		 * The slider's value will not go higher than the maximum. The maximum
		 * is zero (<code>0</code>), by default, and it should almost always be
		 * changed to something more appropriate.
		 *
		 * <p>In the following example, the maximum is set to 100:</p>
		 *
		 * <listing version="3.0">
		 * slider.minimum = 0;
		 * slider.maximum = 100;
		 * slider.step = 1;
		 * slider.page = 10
		 * slider.value = 12;</listing>
		 *
		 * @default 0
		 *
		 * @see #value
		 * @see #minimum
		 */
		public function get maximum():Number
		{
			return this._maximum;
		}

		/**
		 * @private
		 */
		public function set maximum(value:Number):void
		{
			if(this._maximum == value)
			{
				return;
			}
			this._maximum = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _step:Number = 0;

		/**
		 * As the slider's thumb is dragged, the value is snapped to a multiple
		 * of the step. Paging using the slider's track will use the <code>step</code>
		 * value if the <code>page</code> value is <code>NaN</code>. If the
		 * <code>step</code> is zero (<code>0</code>), paging with the track will not be possible.
		 *
		 * <p>In the following example, the step is changed to 1:</p>
		 *
		 * <listing version="3.0">
		 * slider.minimum = 0;
		 * slider.maximum = 100;
		 * slider.step = 1;
		 * slider.page = 10;
		 * slider.value = 10;</listing>
		 *
		 * @default 0
		 *
		 * @see #value
		 * @see #page
		 */
		public function get step():Number
		{
			return this._step;
		}

		/**
		 * @private
		 */
		public function set step(value:Number):void
		{
			if(this._step == value)
			{
				return;
			}
			this._step = value;
		}

		/**
		 * @private
		 */
		protected var _page:Number = NaN;

		/**
		 * If the <code>trackInteractionMode</code> property is set to
		 * <code>TrackInteractionMode.BY_PAGE</code>, and the slider's
		 * track is touched, and the thumb is shown, the slider value will be
		 * incremented or decremented by the page value. If the
		 * <code>trackInteractionMode</code> property is set to
		 * <code>TrackInteractionMode.TO_VALUE</code>, this property will be
		 * ignored.
		 *
		 * <p>If this value is <code>NaN</code>, the <code>step</code> value
		 * will be used instead. If the <code>step</code> value is zero, paging
		 * with the track is not possible.</p>
		 *
		 * <p>In the following example, the page is changed to 10:</p>
		 *
		 * <listing version="3.0">
		 * slider.minimum = 0;
		 * slider.maximum = 100;
		 * slider.step = 1;
		 * slider.page = 10
		 * slider.value = 12;</listing>
		 *
		 * @default NaN
		 *
		 * @see #value
		 * @see #page
		 * @see #style:trackInteractionMode
		 */
		public function get page():Number
		{
			return this._page;
		}

		/**
		 * @private
		 */
		public function set page(value:Number):void
		{
			if(this._page == value)
			{
				return;
			}
			this._page = value;
		}

		/**
		 * @private
		 */
		protected var isDragging:Boolean = false;

		/**
		 * Determines if the slider dispatches the <code>Event.CHANGE</code>
		 * event every time the thumb moves, or only once it stops moving.
		 *
		 * <p>In the following example, live dragging is disabled:</p>
		 *
		 * <listing version="3.0">
		 * slider.liveDragging = false;</listing>
		 *
		 * @default true
		 */
		public var liveDragging:Boolean = true;

		/**
		 * @private
		 */
		protected var _showThumb:Boolean = true;

		/**
		 * @private
		 */
		public function get showThumb():Boolean
		{
			return this._showThumb;
		}

		/**
		 * @private
		 */
		public function set showThumb(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._showThumb === value)
			{
				return;
			}
			this._showThumb = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _thumbOffset:Number = 0;

		/**
		 * @private
		 */
		public function get thumbOffset():Number
		{
			return this._thumbOffset;
		}

		/**
		 * @private
		 */
		public function set thumbOffset(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._thumbOffset == value)
			{
				return;
			}
			this._thumbOffset = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _minimumPadding:Number = 0;

		/**
		 * @private
		 */
		public function get minimumPadding():Number
		{
			return this._minimumPadding;
		}

		/**
		 * @private
		 */
		public function set minimumPadding(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._minimumPadding == value)
			{
				return;
			}
			this._minimumPadding = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _maximumPadding:Number = 0;

		/**
		 * @private
		 */
		public function get maximumPadding():Number
		{
			return this._maximumPadding;
		}

		/**
		 * @private
		 */
		public function set maximumPadding(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._maximumPadding == value)
			{
				return;
			}
			this._maximumPadding = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _trackLayoutMode:String = TrackLayoutMode.SINGLE;

		[Inspectable(type="String",enumeration="single,split")]
		/**
		 * @private
		 */
		public function get trackLayoutMode():String
		{
			return this._trackLayoutMode;
		}

		/**
		 * @private
		 */
		public function set trackLayoutMode(value:String):void
		{
			if(value === "minMax")
			{
				value = TrackLayoutMode.SPLIT;
			}
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._trackLayoutMode === value)
			{
				return;
			}
			this._trackLayoutMode = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _trackScaleMode:String = TrackScaleMode.DIRECTIONAL;

		[Inspectable(type="String",enumeration="exactFit,directional")]
		/**
		 * @private
		 */
		public function get trackScaleMode():String
		{
			return this._trackScaleMode;
		}

		/**
		 * @private
		 */
		public function set trackScaleMode(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._trackScaleMode === value)
			{
				return;
			}
			this._trackScaleMode = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _trackInteractionMode:String = TrackInteractionMode.TO_VALUE;

		[Inspectable(type="String",enumeration="toValue,byPage")]
		/**
		 * @private
		 */
		public function get trackInteractionMode():String
		{
			return this._trackInteractionMode;
		}

		/**
		 * @private
		 */
		public function set trackInteractionMode(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._trackInteractionMode = value;
		}

		/**
		 * @private
		 */
		protected var currentRepeatAction:Function;

		/**
		 * @private
		 */
		protected var _repeatTimer:Timer;

		/**
		 * @private
		 */
		protected var _repeatDelay:Number = 0.05;

		/**
		 * The time, in seconds, before actions are repeated. The first repeat
		 * happens after a delay that is five times longer than the following
		 * repeats.
		 *
		 * <p>In the following example, the slider's repeat delay is set to
		 * 500 milliseconds:</p>
		 *
		 * <listing version="3.0">
		 * slider.repeatDelay = 0.5;</listing>
		 *
		 * @default 0.05
		 */
		public function get repeatDelay():Number
		{
			return this._repeatDelay;
		}

		/**
		 * @private
		 */
		public function set repeatDelay(value:Number):void
		{
			if(this._repeatDelay == value)
			{
				return;
			}
			this._repeatDelay = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _minimumTrackFactory:Function;

		/**
		 * A function used to generate the slider's minimum track sub-component.
		 * The minimum track must be an instance of <code>BasicButton</code> (or
		 * a subclass). This factory can be used to change properties on the
		 * minimum track when it is first created. For instance, if you are
		 * skinning Feathers components without a theme, you might use this
		 * factory to set skins and other styles on the minimum track.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():BasicButton</pre>
		 *
		 * <p>In the following example, a custom minimum track factory is passed
		 * to the slider:</p>
		 *
		 * <listing version="3.0">
		 * slider.minimumTrackFactory = function():BasicButton
		 * {
		 *     var track:BasicButton = new BasicButton();
		 *     var skin:ImageSkin = new ImageSkin( upTexture );
		 *     skin.setTextureForState( ButtonState.DOWN, downTexture );
		 *     track.defaultSkin = skin;
		 *     return track;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 */
		public function get minimumTrackFactory():Function
		{
			return this._minimumTrackFactory;
		}

		/**
		 * @private
		 */
		public function set minimumTrackFactory(value:Function):void
		{
			if(this._minimumTrackFactory == value)
			{
				return;
			}
			this._minimumTrackFactory = value;
			this.invalidate(INVALIDATION_FLAG_MINIMUM_TRACK_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customMinimumTrackStyleName:String;

		/**
		 * @private
		 */
		public function get customMinimumTrackStyleName():String
		{
			return this._customMinimumTrackStyleName;
		}

		/**
		 * @private
		 */
		public function set customMinimumTrackStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customMinimumTrackStyleName === value)
			{
				return;
			}
			this._customMinimumTrackStyleName = value;
			this.invalidate(INVALIDATION_FLAG_MINIMUM_TRACK_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _minimumTrackProperties:PropertyProxy;

		/**
		 * An object that stores properties for the slider's "minimum" track,
		 * and the properties will be passed down to the "minimum" track when
		 * the slider validates. For a list of available properties, refer to
		 * <a href="BasicButton.html"><code>feathers.controls.BasicButton</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>minimumTrackFactory</code> function
		 * instead of using <code>minimumTrackProperties</code> will result in
		 * better performance.</p>
		 *
		 * <p>In the following example, the slider's minimum track properties
		 * are updated:</p>
		 *
		 * <listing version="3.0">
		 * slider.minimumTrackProperties.defaultSkin = new Image( upTexture );
		 * slider.minimumTrackProperties.downSkin = new Image( downTexture );</listing>
		 *
		 * @default null
		 *
		 * @see #minimumTrackFactory
		 * @see feathers.controls.BasicButton
		 */
		public function get minimumTrackProperties():Object
		{
			if(!this._minimumTrackProperties)
			{
				this._minimumTrackProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._minimumTrackProperties;
		}

		/**
		 * @private
		 */
		public function set minimumTrackProperties(value:Object):void
		{
			if(this._minimumTrackProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._minimumTrackProperties)
			{
				this._minimumTrackProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._minimumTrackProperties = PropertyProxy(value);
			if(this._minimumTrackProperties)
			{
				this._minimumTrackProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _maximumTrackFactory:Function;

		/**
		 * A function used to generate the slider's maximum track sub-component.
		 * The maximum track must be an instance of <code>BasicButton</code> (or
		 * a subclass). This factory can be used to change properties on the
		 * maximum track when it is first created. For instance, if you are
		 * skinning Feathers components without a theme, you might use this
		 * factory to set skins and other styles on the maximum track.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():BasicButton</pre>
		 *
		 * <p>In the following example, a custom maximum track factory is passed
		 * to the slider:</p>
		 *
		 * <listing version="3.0">
		 * slider.maximumTrackFactory = function():BasicButton
		 * {
		 *     var track:BasicButton = new BasicButton();
		 *     var skin:ImageSkin = new ImageSkin( upTexture );
		 *     skin.setTextureForState( ButtonState.DOWN, downTexture );
		 *     track.defaultSkin = skin;
		 *     return track;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 */
		public function get maximumTrackFactory():Function
		{
			return this._maximumTrackFactory;
		}

		/**
		 * @private
		 */
		public function set maximumTrackFactory(value:Function):void
		{
			if(this._maximumTrackFactory == value)
			{
				return;
			}
			this._maximumTrackFactory = value;
			this.invalidate(INVALIDATION_FLAG_MAXIMUM_TRACK_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customMaximumTrackStyleName:String;

		/**
		 * @private
		 */
		public function get customMaximumTrackStyleName():String
		{
			return this._customMaximumTrackStyleName;
		}

		/**
		 * @private
		 */
		public function set customMaximumTrackStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customMaximumTrackStyleName === value)
			{
				return;
			}
			this._customMaximumTrackStyleName = value;
			this.invalidate(INVALIDATION_FLAG_MAXIMUM_TRACK_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _maximumTrackProperties:PropertyProxy;

		/**
		 * An object that stores properties for the slider's "maximum" track,
		 * and the properties will be passed down to the "maximum" track when
		 * the slider validates. For a list of available properties, refer to
		 * <a href="BasicButton.html"><code>feathers.controls.BasicButton</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>maximumTrackFactory</code> function
		 * instead of using <code>maximumTrackProperties</code> will result in
		 * better performance.</p>
		 *
		 * <p>In the following example, the slider's maximum track properties
		 * are updated:</p>
		 *
		 * <listing version="3.0">
		 * slider.maximumTrackProperties.defaultSkin = new Image( upTexture );
		 * slider.maximumTrackProperties.downSkin = new Image( downTexture );</listing>
		 *
		 * @default null
		 *
		 * @see #maximumTrackFactory
		 * @see feathers.controls.BasicButton
		 */
		public function get maximumTrackProperties():Object
		{
			if(!this._maximumTrackProperties)
			{
				this._maximumTrackProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._maximumTrackProperties;
		}

		/**
		 * @private
		 */
		public function set maximumTrackProperties(value:Object):void
		{
			if(this._maximumTrackProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._maximumTrackProperties)
			{
				this._maximumTrackProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._maximumTrackProperties = PropertyProxy(value);
			if(this._maximumTrackProperties)
			{
				this._maximumTrackProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _thumbFactory:Function;

		/**
		 * A function used to generate the slider's thumb sub-component.
		 * The thumb must be an instance of <code>BasicButton</code> (or a
		 * subclass). This factory can be used to change properties on the thumb
		 * when it is first created. For instance, if you are skinning Feathers
		 * components without a theme, you might use this factory to set skins
		 * and other styles on the thumb.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():BasicButton</pre>
		 *
		 * <p>In the following example, a custom thumb factory is passed
		 * to the slider:</p>
		 *
		 * <listing version="3.0">
		 * slider.thumbFactory = function():BasicButton
		 * {
		 *     var thumb:BasicButton = new BasicButton();
		 *     var skin:ImageSkin = new ImageSkin( upTexture );
		 *     skin.setTextureForState( ButtonState.DOWN, downTexture );
		 *     thumb.defaultSkin = skin;
		 *     return thumb;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 */
		public function get thumbFactory():Function
		{
			return this._thumbFactory;
		}

		/**
		 * @private
		 */
		public function set thumbFactory(value:Function):void
		{
			if(this._thumbFactory == value)
			{
				return;
			}
			this._thumbFactory = value;
			this.invalidate(INVALIDATION_FLAG_THUMB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customThumbStyleName:String;

		/**
		 * @private
		 */
		public function get customThumbStyleName():String
		{
			return this._customThumbStyleName;
		}

		/**
		 * @private
		 */
		public function set customThumbStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customThumbStyleName === value)
			{
				return;
			}
			this._customThumbStyleName = value;
			this.invalidate(INVALIDATION_FLAG_THUMB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _thumbProperties:PropertyProxy;

		/**
		 * An object that stores properties for the slider's thumb, and the
		 * properties will be passed down to the thumb when the slider
		 * validates. For a list of available properties, refer to
		 * <a href="BasicButton.html"><code>feathers.controls.BasicButton</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>thumbFactory</code> function instead
		 * of using <code>thumbProperties</code> will result in better
		 * performance.</p>
		 *
		 * <p>In the following example, the slider's thumb properties
		 * are updated:</p>
		 *
		 * <listing version="3.0">
		 * slider.thumbProperties.defaultSkin = new Image( upTexture );
		 * slider.thumbProperties.downSkin = new Image( downTexture );</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 * @see #thumbFactory
		 */
		public function get thumbProperties():Object
		{
			if(!this._thumbProperties)
			{
				this._thumbProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._thumbProperties;
		}

		/**
		 * @private
		 */
		public function set thumbProperties(value:Object):void
		{
			if(this._thumbProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._thumbProperties)
			{
				this._thumbProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._thumbProperties = PropertyProxy(value);
			if(this._thumbProperties)
			{
				this._thumbProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _touchStartX:Number = NaN;

		/**
		 * @private
		 */
		protected var _touchStartY:Number = NaN;

		/**
		 * @private
		 */
		protected var _thumbStartX:Number = NaN;

		/**
		 * @private
		 */
		protected var _thumbStartY:Number = NaN;

		/**
		 * @private
		 */
		protected var _touchValue:Number;

		/**
		 * @private
		 */
		protected var _pageStartValue:Number;

		/**
		 * @private
		 */
		override public function hitTest(local:Point):DisplayObject
		{
			var result:DisplayObject = super.hitTest(local);
			if(result !== null && this._trackInteractionMode === TrackInteractionMode.TO_VALUE)
			{
				return this.thumb;
			}
			return result;
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(this._value < this._minimum)
			{
				this.value = this._minimum;
			}
			else if(this._value > this._maximum)
			{
				this.value = this._maximum;
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var focusInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_FOCUS);
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);
			var thumbFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_THUMB_FACTORY);
			var minimumTrackFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_MINIMUM_TRACK_FACTORY);
			var maximumTrackFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_MAXIMUM_TRACK_FACTORY);

			if(thumbFactoryInvalid)
			{
				this.createThumb();
			}

			if(minimumTrackFactoryInvalid)
			{
				this.createMinimumTrack();
			}

			if(maximumTrackFactoryInvalid || layoutInvalid)
			{
				this.createMaximumTrack();
			}

			if(thumbFactoryInvalid || stylesInvalid)
			{
				this.refreshThumbStyles();
			}
			if(minimumTrackFactoryInvalid || stylesInvalid)
			{
				this.refreshMinimumTrackStyles();
			}
			if((maximumTrackFactoryInvalid || layoutInvalid || stylesInvalid) && this.maximumTrack)
			{
				this.refreshMaximumTrackStyles();
			}

			if(stateInvalid || thumbFactoryInvalid || minimumTrackFactoryInvalid ||
				maximumTrackFactoryInvalid)
			{
				this.refreshEnabled();
			}

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			this.layoutChildren();

			if(sizeInvalid || focusInvalid)
			{
				this.refreshFocusIndicator();
			}
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			if(this._direction === Direction.VERTICAL)
			{
				return this.measureVertical();
			}
			return this.measureHorizontal();
		}

		/**
		 * @private
		 */
		protected function measureVertical():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}
			var isSingle:Boolean = this._trackLayoutMode === TrackLayoutMode.SINGLE;
			if(needsHeight)
			{
				this.minimumTrack.height = this._minimumTrackSkinExplicitHeight;
			}
			else if(isSingle)
			{
				this.minimumTrack.height = this._explicitHeight;
			}
			if(this.minimumTrack is IMeasureDisplayObject)
			{
				var measureMinTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.minimumTrack);
				if(needsMinHeight)
				{
					measureMinTrack.minHeight = this._minimumTrackSkinExplicitMinHeight;
				}
				else if(isSingle)
				{
					var minTrackMinHeight:Number = this._explicitMinHeight;
					if(this._minimumTrackSkinExplicitMinHeight > minTrackMinHeight)
					{
						minTrackMinHeight = this._minimumTrackSkinExplicitMinHeight;
					}
					measureMinTrack.minHeight = minTrackMinHeight;
				}
			}
			if(!isSingle)
			{
				if(needsHeight)
				{
					this.maximumTrack.height = this._maximumTrackSkinExplicitHeight;
				}
				if(this.maximumTrack is IMeasureDisplayObject)
				{
					var measureMaxTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.maximumTrack);
					if(needsMinHeight)
					{
						measureMaxTrack.minHeight = this._maximumTrackSkinExplicitMinHeight;
					}
				}
			}
			if(this.minimumTrack is IValidating)
			{
				IValidating(this.minimumTrack).validate();
			}
			if(this.maximumTrack is IValidating)
			{
				IValidating(this.maximumTrack).validate();
			}
			if(this.thumb is IValidating)
			{
				IValidating(this.thumb).validate();
			}
			var newWidth:Number = this._explicitWidth;
			var newHeight:Number = this._explicitHeight;
			var newMinWidth:Number = this._explicitMinWidth;
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsWidth)
			{
				newWidth = this.minimumTrack.width;
				if(!isSingle && //split
					this.maximumTrack.width > newWidth)
				{
					newWidth = this.maximumTrack.width;
				}
				if(this.thumb.width > newWidth)
				{
					newWidth = this.thumb.width;
				}
			}
			if(needsHeight)
			{
				newHeight = this.minimumTrack.height;
				if(!isSingle) //split
				{
					if(this.maximumTrack.height > newHeight)
					{
						newHeight = this.maximumTrack.height;
					}
					newHeight += this.thumb.height / 2;
				}
			}
			if(needsMinWidth)
			{
				if(measureMinTrack !== null)
				{
					newMinWidth = measureMinTrack.minWidth;
				}
				else
				{
					newMinWidth = this.minimumTrack.width;
				}
				if(!isSingle) //split
				{
					if(measureMaxTrack !== null)
					{
						if(measureMaxTrack.minWidth > newMinWidth)
						{
							newMinWidth = measureMaxTrack.minWidth;
						}
					}
					else if(this.maximumTrack.width > newMinWidth)
					{
						newMinWidth = this.maximumTrack.width;
					}
				}
				if(this.thumb is IMeasureDisplayObject)
				{
					var measureThumb:IMeasureDisplayObject = IMeasureDisplayObject(this.thumb);
					if(measureThumb.minWidth > newMinWidth)
					{
						newMinWidth = measureThumb.minWidth;
					}
				}
				else if(this.thumb.width > newMinWidth)
				{
					newMinWidth = this.thumb.width;
				}
			}
			if(needsMinHeight)
			{
				if(measureMinTrack !== null)
				{
					newMinHeight = measureMinTrack.minHeight;
				}
				else
				{
					newMinHeight = this.minimumTrack.height;
				}
				if(!isSingle) //split
				{
					if(measureMaxTrack !== null)
					{
						if(measureMaxTrack.minHeight > newMinHeight)
						{
							newMinHeight = measureMaxTrack.minHeight;
						}
					}
					else
					{
						newMinHeight = this.maximumTrack.height;
					}
					if(this.thumb is IMeasureDisplayObject)
					{
						newMinHeight += IMeasureDisplayObject(this.thumb).minHeight / 2;
					}
					else
					{
						newMinHeight += this.thumb.height / 2;
					}
				}
			}
			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * @private
		 */
		protected function measureHorizontal():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}
			var isSingle:Boolean = this._trackLayoutMode === TrackLayoutMode.SINGLE;
			if(needsWidth)
			{
				this.minimumTrack.width = this._minimumTrackSkinExplicitWidth;
			}
			else if(isSingle)
			{
				this.minimumTrack.width = this._explicitWidth;
			}
			if(this.minimumTrack is IMeasureDisplayObject)
			{
				var measureMinTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.minimumTrack);
				if(needsMinWidth)
				{
					measureMinTrack.minWidth = this._minimumTrackSkinExplicitMinWidth;
				}
				else if(isSingle)
				{
					var minTrackMinWidth:Number = this._explicitMinWidth;
					if(this._minimumTrackSkinExplicitMinWidth > minTrackMinWidth)
					{
						minTrackMinWidth = this._minimumTrackSkinExplicitMinWidth;
					}
					measureMinTrack.minWidth = minTrackMinWidth;
				}
			}
			if(!isSingle)
			{
				if(needsWidth)
				{
					this.maximumTrack.width = this._maximumTrackSkinExplicitWidth;
				}
				if(this.maximumTrack is IMeasureDisplayObject)
				{
					var measureMaxTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.maximumTrack);
					if(needsMinWidth)
					{
						measureMaxTrack.minWidth = this._maximumTrackSkinExplicitMinWidth;
					}
				}
			}
			if(this.minimumTrack is IValidating)
			{
				IValidating(this.minimumTrack).validate();
			}
			if(this.maximumTrack is IValidating)
			{
				IValidating(this.maximumTrack).validate();
			}
			if(this.thumb is IValidating)
			{
				IValidating(this.thumb).validate();
			}
			var newWidth:Number = this._explicitWidth;
			var newHeight:Number = this._explicitHeight;
			var newMinWidth:Number = this._explicitMinWidth;
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsWidth)
			{
				newWidth = this.minimumTrack.width;
				if(!isSingle) //split
				{
					if(this.maximumTrack.width > newWidth)
					{
						newWidth = this.maximumTrack.width;
					}
					newWidth += this.thumb.width / 2;
				}
			}
			if(needsHeight)
			{
				newHeight = this.minimumTrack.height;
				if(!isSingle && //split
					this.maximumTrack.height > newHeight)
				{
					newHeight = this.maximumTrack.height;
				}
				if(this.thumb.height > newHeight)
				{
					newHeight = this.thumb.height;
				}
			}
			if(needsMinWidth)
			{
				if(measureMinTrack !== null)
				{
					newMinWidth = measureMinTrack.minWidth;
				}
				else
				{
					newMinWidth = this.minimumTrack.width;
				}
				if(!isSingle) //split
				{
					if(measureMaxTrack !== null)
					{
						if(measureMaxTrack.minWidth > newMinWidth)
						{
							newMinWidth = measureMaxTrack.minWidth;
						}
					}
					else if(this.maximumTrack.width > newMinWidth)
					{
						newMinWidth = this.maximumTrack.width;
					}
					if(this.thumb is IMeasureDisplayObject)
					{
						newMinWidth += IMeasureDisplayObject(this.thumb).minWidth / 2;
					}
					else
					{
						newMinWidth += this.thumb.width / 2;
					}
				}
			}
			if(needsMinHeight)
			{
				if(measureMinTrack !== null)
				{
					newMinHeight = measureMinTrack.minHeight;
				}
				else
				{
					newMinHeight = this.minimumTrack.height;
				}
				if(!isSingle) //split
				{
					if(measureMaxTrack !== null)
					{
						if(measureMaxTrack.minHeight > newMinHeight)
						{
							newMinHeight = measureMaxTrack.minHeight;
						}
					}
					else if(this.maximumTrack.height > newMinHeight)
					{
						newMinHeight = this.maximumTrack.height;
					}
				}
				if(this.thumb is IMeasureDisplayObject)
				{
					var measureThumb:IMeasureDisplayObject = IMeasureDisplayObject(this.thumb);
					if(measureThumb.minHeight > newMinHeight)
					{
						newMinHeight = measureThumb.minHeight;
					}
				}
				else if(this.thumb.height > newMinHeight)
				{
					newMinHeight = this.thumb.height;
				}
			}
			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * Creates and adds the <code>thumb</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #thumb
		 * @see #thumbFactory
		 * @see #style:customThumbStyleName
		 */
		protected function createThumb():void
		{
			if(this.thumb)
			{
				this.thumb.removeFromParent(true);
				this.thumb = null;
			}

			var factory:Function = this._thumbFactory != null ? this._thumbFactory : defaultThumbFactory;
			var thumbStyleName:String = this._customThumbStyleName != null ? this._customThumbStyleName : this.thumbStyleName;
			var thumb:BasicButton = BasicButton(factory());
			thumb.styleNameList.add(thumbStyleName);
			thumb.keepDownStateOnRollOut = true;
			thumb.addEventListener(TouchEvent.TOUCH, thumb_touchHandler);
			this.addChild(thumb);
			this.thumb = thumb;
		}

		/**
		 * Creates and adds the <code>minimumTrack</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #minimumTrack
		 * @see #minimumTrackFactory
		 * @see #style:customMinimumTrackStyleName
		 */
		protected function createMinimumTrack():void
		{
			if(this.minimumTrack)
			{
				this.minimumTrack.removeFromParent(true);
				this.minimumTrack = null;
			}

			var factory:Function = this._minimumTrackFactory != null ? this._minimumTrackFactory : defaultMinimumTrackFactory;
			var minimumTrackStyleName:String = this._customMinimumTrackStyleName != null ? this._customMinimumTrackStyleName : this.minimumTrackStyleName;
			var minimumTrack:BasicButton = BasicButton(factory());
			minimumTrack.styleNameList.add(minimumTrackStyleName);
			minimumTrack.keepDownStateOnRollOut = true;
			minimumTrack.addEventListener(TouchEvent.TOUCH, track_touchHandler);
			this.addChildAt(minimumTrack, 0);
			this.minimumTrack = minimumTrack;

			if(this.minimumTrack is IFeathersControl)
			{
				IFeathersControl(this.minimumTrack).initializeNow();
			}
			if(this.minimumTrack is IMeasureDisplayObject)
			{
				var measureMinTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.minimumTrack);
				this._minimumTrackSkinExplicitWidth = measureMinTrack.explicitWidth;
				this._minimumTrackSkinExplicitHeight = measureMinTrack.explicitHeight;
				this._minimumTrackSkinExplicitMinWidth = measureMinTrack.explicitMinWidth;
				this._minimumTrackSkinExplicitMinHeight = measureMinTrack.explicitMinHeight;
			}
			else
			{
				//this is a regular display object, and we'll treat its
				//measurements as explicit when we auto-size the slider
				this._minimumTrackSkinExplicitWidth = this.minimumTrack.width;
				this._minimumTrackSkinExplicitHeight = this.minimumTrack.height;
				this._minimumTrackSkinExplicitMinWidth = this._minimumTrackSkinExplicitWidth;
				this._minimumTrackSkinExplicitMinHeight = this._minimumTrackSkinExplicitHeight;
			}
		}

		/**
		 * Creates and adds the <code>maximumTrack</code> sub-component and
		 * removes the old instance, if one exists. If the maximum track is not
		 * needed, it will not be created.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #maximumTrack
		 * @see #maximumTrackFactory
		 * @see #style:customMaximumTrackStyleName
		 */
		protected function createMaximumTrack():void
		{
			if(this.maximumTrack !== null)
			{
				this.maximumTrack.removeFromParent(true);
				this.maximumTrack = null;
			}
			if(this._trackLayoutMode === TrackLayoutMode.SINGLE)
			{
				return;
			}

			var factory:Function = this._maximumTrackFactory != null ? this._maximumTrackFactory : defaultMaximumTrackFactory;
			var maximumTrackStyleName:String = this._customMaximumTrackStyleName != null ? this._customMaximumTrackStyleName : this.maximumTrackStyleName;
			var maximumTrack:BasicButton = BasicButton(factory());
			maximumTrack.styleNameList.add(maximumTrackStyleName);
			maximumTrack.keepDownStateOnRollOut = true;
			maximumTrack.addEventListener(TouchEvent.TOUCH, track_touchHandler);
			this.addChildAt(maximumTrack, 1);
			this.maximumTrack = maximumTrack;

			if(this.maximumTrack is IFeathersControl)
			{
				IFeathersControl(this.maximumTrack).initializeNow();
			}
			if(this.maximumTrack is IMeasureDisplayObject)
			{
				var measureMaxTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.maximumTrack);
				this._maximumTrackSkinExplicitWidth = measureMaxTrack.explicitWidth;
				this._maximumTrackSkinExplicitHeight = measureMaxTrack.explicitHeight;
				this._maximumTrackSkinExplicitMinWidth = measureMaxTrack.explicitMinWidth;
				this._maximumTrackSkinExplicitMinHeight = measureMaxTrack.explicitMinHeight;
			}
			else
			{
				//this is a regular display object, and we'll treat its
				//measurements as explicit when we auto-size the slider
				this._maximumTrackSkinExplicitWidth = this.maximumTrack.width;
				this._maximumTrackSkinExplicitHeight = this.maximumTrack.height;
				this._maximumTrackSkinExplicitMinWidth = this._maximumTrackSkinExplicitWidth;
				this._maximumTrackSkinExplicitMinHeight = this._maximumTrackSkinExplicitHeight;
			}
		}

		/**
		 * @private
		 */
		protected function refreshThumbStyles():void
		{
			for(var propertyName:String in this._thumbProperties)
			{
				var propertyValue:Object = this._thumbProperties[propertyName];
				this.thumb[propertyName] = propertyValue;
			}
			this.thumb.visible = this._showThumb;
		}

		/**
		 * @private
		 */
		protected function refreshMinimumTrackStyles():void
		{
			for(var propertyName:String in this._minimumTrackProperties)
			{
				var propertyValue:Object = this._minimumTrackProperties[propertyName];
				this.minimumTrack[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function refreshMaximumTrackStyles():void
		{
			if(!this.maximumTrack)
			{
				return;
			}
			for(var propertyName:String in this._maximumTrackProperties)
			{
				var propertyValue:Object = this._maximumTrackProperties[propertyName];
				this.maximumTrack[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function refreshEnabled():void
		{
			if(this.thumb is IFeathersControl)
			{
				IFeathersControl(this.thumb).isEnabled = this._isEnabled;
			}
			if(this.minimumTrack is IFeathersControl)
			{
				IFeathersControl(this.minimumTrack).isEnabled = this._isEnabled;
			}
			if(this.maximumTrack is IFeathersControl)
			{
				IFeathersControl(this.maximumTrack).isEnabled = this._isEnabled;
			}
		}

		/**
		 * @private
		 */
		protected function layoutChildren():void
		{
			this.layoutThumb();

			if(this._trackLayoutMode == TrackLayoutMode.SPLIT)
			{
				this.layoutTrackWithMinMax();
			}
			else //single
			{
				this.layoutTrackWithSingle();
			}
		}

		/**
		 * @private
		 */
		protected function layoutThumb():void
		{
			//this will auto-size the thumb, if needed
			if(this.thumb is IValidating)
			{
				IValidating(this.thumb).validate();
			}

			if(this._minimum == this._maximum)
			{
				var percentage:Number = 1;
			}
			else
			{
				percentage = (this._value - this._minimum) / (this._maximum - this._minimum);
				if(percentage < 0)
				{
					percentage = 0;
				}
				else if(percentage > 1)
				{
					percentage = 1;
				}
			}
			if(this._direction == Direction.VERTICAL)
			{
				var trackScrollableHeight:Number = this.actualHeight - this.thumb.height - this._minimumPadding - this._maximumPadding;
				this.thumb.x = Math.round((this.actualWidth - this.thumb.width) / 2) + this._thumbOffset;
				//maximum is at the top, so we need to start the y position of
				//the thumb from the maximum padding
				this.thumb.y = Math.round(this._maximumPadding + trackScrollableHeight * (1 - percentage));
			}
			else //horizontal
			{
				var trackScrollableWidth:Number = this.actualWidth - this.thumb.width - this._minimumPadding - this._maximumPadding;
				//minimum is at the left, so we need to start the x position of
				//the thumb from the minimum padding
				this.thumb.x = Math.round(this._minimumPadding + (trackScrollableWidth * percentage));
				this.thumb.y = Math.round((this.actualHeight - this.thumb.height) / 2) + this._thumbOffset;
			}
		}

		/**
		 * @private
		 */
		protected function layoutTrackWithMinMax():void
		{
			if(this._direction === Direction.VERTICAL)
			{
				var maximumTrackHeight:Number = Math.round(this.thumb.y + (this.thumb.height / 2));
				this.maximumTrack.y = 0;
				this.maximumTrack.height = maximumTrackHeight;
				this.minimumTrack.y = maximumTrackHeight;
				this.minimumTrack.height = this.actualHeight - maximumTrackHeight;
				if(this._trackScaleMode === TrackScaleMode.EXACT_FIT)
				{
					this.maximumTrack.x = 0;
					this.maximumTrack.width = this.actualWidth;
					this.minimumTrack.x = 0;
					this.minimumTrack.width = this.actualWidth;
				}
				else //directional
				{
					this.maximumTrack.width = this._maximumTrackSkinExplicitWidth;
					this.minimumTrack.width = this._minimumTrackSkinExplicitWidth;
				}

				//final validation to avoid juggler next frame issues
				if(this.minimumTrack is IValidating)
				{
					IValidating(this.minimumTrack).validate();
				}
				if(this.maximumTrack is IValidating)
				{
					IValidating(this.maximumTrack).validate();
				}

				if(this._trackScaleMode === TrackScaleMode.DIRECTIONAL)
				{
					this.maximumTrack.x = Math.round((this.actualWidth - this.maximumTrack.width) / 2);
					this.minimumTrack.x = Math.round((this.actualWidth - this.minimumTrack.width) / 2);
				}
			}
			else //horizontal
			{
				var minimumTrackWidth:Number = Math.round(this.thumb.x + (this.thumb.width / 2));
				this.minimumTrack.x = 0;
				this.minimumTrack.width = minimumTrackWidth;
				this.maximumTrack.x = minimumTrackWidth;
				this.maximumTrack.width = this.actualWidth - minimumTrackWidth;

				if(this._trackScaleMode === TrackScaleMode.EXACT_FIT)
				{
					this.minimumTrack.y = 0;
					this.minimumTrack.height = this.actualHeight;
					this.maximumTrack.y = 0;
					this.maximumTrack.height = this.actualHeight;
				}
				else //directional
				{
					this.minimumTrack.height = this._minimumTrackSkinExplicitHeight;
					this.maximumTrack.height = this._maximumTrackSkinExplicitHeight;
				}

				//final validation to avoid juggler next frame issues
				if(this.minimumTrack is IValidating)
				{
					IValidating(this.minimumTrack).validate();
				}
				if(this.maximumTrack is IValidating)
				{
					IValidating(this.maximumTrack).validate();
				}

				if(this._trackScaleMode === TrackScaleMode.DIRECTIONAL)
				{
					this.minimumTrack.y = Math.round((this.actualHeight - this.minimumTrack.height) / 2);
					this.maximumTrack.y = Math.round((this.actualHeight - this.maximumTrack.height) / 2);
				}
			}
		}

		/**
		 * @private
		 */
		protected function layoutTrackWithSingle():void
		{
			if(this._direction === Direction.VERTICAL)
			{
				this.minimumTrack.y = 0;
				this.minimumTrack.height = this.actualHeight;
				if(this._trackScaleMode === TrackScaleMode.EXACT_FIT)
				{
					this.minimumTrack.x = 0;
					this.minimumTrack.width = this.actualWidth;
				}
				else //directional
				{
					//we'll calculate x after validation in case the track needs
					//to auto-size
					this.minimumTrack.width = this._minimumTrackSkinExplicitWidth;
				}

				//final validation to avoid juggler next frame issues
				if(this.minimumTrack is IValidating)
				{
					IValidating(this.minimumTrack).validate();
				}

				if(this._trackScaleMode === TrackScaleMode.DIRECTIONAL)
				{
					this.minimumTrack.x = Math.round((this.actualWidth - this.minimumTrack.width) / 2);
				}
			}
			else //horizontal
			{
				this.minimumTrack.x = 0;
				this.minimumTrack.width = this.actualWidth;
				if(this._trackScaleMode === TrackScaleMode.EXACT_FIT)
				{
					this.minimumTrack.y = 0;
					this.minimumTrack.height = this.actualHeight;
				}
				else //directional
				{
					//we'll calculate y after validation in case the track needs
					//to auto-size
					this.minimumTrack.height = this._minimumTrackSkinExplicitHeight;
				}

				//final validation to avoid juggler next frame issues
				if(this.minimumTrack is IValidating)
				{
					IValidating(this.minimumTrack).validate();
				}

				if(this._trackScaleMode === TrackScaleMode.DIRECTIONAL)
				{
					this.minimumTrack.y = Math.round((this.actualHeight - this.minimumTrack.height) / 2);
				}
			}
		}

		/**
		 * @private
		 */
		protected function locationToValue(location:Point):Number
		{
			var percentage:Number;
			if(this._direction == Direction.VERTICAL)
			{
				var trackScrollableHeight:Number = this.actualHeight - this.thumb.height - this._minimumPadding - this._maximumPadding;
				var yOffset:Number = location.y - this._touchStartY - this._maximumPadding;
				var yPosition:Number = Math.min(Math.max(0, this._thumbStartY + yOffset), trackScrollableHeight);
				percentage = 1 - (yPosition / trackScrollableHeight);
			}
			else //horizontal
			{
				var trackScrollableWidth:Number = this.actualWidth - this.thumb.width - this._minimumPadding - this._maximumPadding;
				var xOffset:Number = location.x - this._touchStartX - this._minimumPadding;
				var xPosition:Number = Math.min(Math.max(0, this._thumbStartX + xOffset), trackScrollableWidth);
				percentage = xPosition / trackScrollableWidth;
			}

			return this._minimum + percentage * (this._maximum - this._minimum);
		}

		/**
		 * @private
		 */
		protected function startRepeatTimer(action:Function):void
		{
			this.currentRepeatAction = action;
			if(this._repeatDelay > 0)
			{
				if(!this._repeatTimer)
				{
					this._repeatTimer = new Timer(this._repeatDelay * 1000);
					this._repeatTimer.addEventListener(TimerEvent.TIMER, repeatTimer_timerHandler);
				}
				else
				{
					this._repeatTimer.reset();
					this._repeatTimer.delay = this._repeatDelay * 1000;
				}
				this._repeatTimer.start();
			}
		}

		/**
		 * @private
		 */
		protected function adjustPage():void
		{
			var page:Number = this._page;
			if(page !== page) //isNaN
			{
				page = this._step;
			}
			if(this._touchValue < this._pageStartValue)
			{
				var newValue:Number = Math.max(this._touchValue, this._value - page);
				if(this._step != 0 && newValue != this._maximum && newValue != this._minimum)
				{
					newValue = roundDownToNearest(newValue, this._step);
				}
				this.value = newValue;
			}
			else if(this._touchValue > this._pageStartValue)
			{
				newValue = Math.min(this._touchValue, this._value + page);
				if(this._step != 0 && newValue != this._maximum && newValue != this._minimum)
				{
					newValue = roundUpToNearest(newValue, this._step);
				}
				this.value = newValue;
			}
		}

		/**
		 * @private
		 */
		protected function childProperties_onChange(proxy:PropertyProxy, name:Object):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function slider_removedFromStageHandler(event:Event):void
		{
			this._touchPointID = -1;
			var wasDragging:Boolean = this.isDragging;
			this.isDragging = false;
			if(wasDragging && !this.liveDragging)
			{
				this.dispatchEventWith(Event.CHANGE);
			}
		}

		/**
		 * @private
		 */
		override protected function focusInHandler(event:Event):void
		{
			super.focusInHandler(event);
			this.stage.addEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
		}

		/**
		 * @private
		 */
		override protected function focusOutHandler(event:Event):void
		{
			super.focusOutHandler(event);
			this.stage.removeEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
		}

		/**
		 * @private
		 */
		protected function track_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._touchPointID = -1;
				return;
			}

			var track:DisplayObject = DisplayObject(event.currentTarget);
			if(this._touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(track, null, this._touchPointID);
				if(touch === null)
				{
					return;
				}
				if(touch.phase === TouchPhase.MOVED)
				{
					var location:Point = touch.getLocation(this, Pool.getPoint());
					this._touchValue = this.locationToValue(location);
					Pool.putPoint(location);
					if(!this._showThumb || this._trackInteractionMode !== TrackInteractionMode.BY_PAGE)
					{
						this.value = this._touchValue;
					}
				}
				else if(touch.phase === TouchPhase.ENDED)
				{
					if(this._repeatTimer !== null)
					{
						this._repeatTimer.stop();
					}
					this._touchPointID = -1;
					this.isDragging = false;
					if(!this.liveDragging)
					{
						this.dispatchEventWith(Event.CHANGE);
					}
					this.dispatchEventWith(FeathersEventType.END_INTERACTION);
				}
			}
			else
			{
				touch = event.getTouch(track, TouchPhase.BEGAN);
				if(touch === null)
				{
					return;
				}
				location = touch.getLocation(this, Pool.getPoint());
				this._touchPointID = touch.id;
				if(this._direction == Direction.VERTICAL)
				{
					this._thumbStartX = location.x;
					this._thumbStartY = Math.min(this.actualHeight - this.thumb.height - this._maximumPadding, Math.max(this._minimumPadding, location.y - this.thumb.height / 2));
				}
				else //horizontal
				{
					this._thumbStartX = Math.min(this.actualWidth - this.thumb.width - this._maximumPadding, Math.max(this._minimumPadding, location.x - this.thumb.width / 2));
					this._thumbStartY = location.y;
				}
				this._touchStartX = location.x;
				this._touchStartY = location.y;
				this._touchValue = this.locationToValue(location);
				Pool.putPoint(location);
				this._pageStartValue = this._value;
				this.isDragging = true;
				this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
				if(this._showThumb && this._trackInteractionMode === TrackInteractionMode.BY_PAGE)
				{
					this.adjustPage();
					this.startRepeatTimer(this.adjustPage);
				}
				else
				{
					this.value = this._touchValue;
				}
			}
		}

		/**
		 * @private
		 */
		protected function thumb_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._touchPointID = -1;
				return;
			}

			if(this._trackInteractionMode === TrackInteractionMode.TO_VALUE)
			{
				var touch:Touch = event.getTouch(this.thumb, null, this._touchPointID);
				if(touch !== null)
				{
					var location:Point = touch.getLocation(this.thumb, Pool.getPoint());
					if(this.thumb.hitTest(location) === null)
					{
						//the touch is not actually on the thumb, so behave as
						//if the track were touched
						Pool.putPoint(location);
						this.track_touchHandler(event);
						return;
					}
					//the touch is on the thumb
					Pool.putPoint(location);
				}
			}

			if(this._touchPointID >= 0)
			{
				touch = event.getTouch(this.thumb, null, this._touchPointID);
				if(touch === null)
				{
					return;
				}
				if(touch.phase === TouchPhase.MOVED)
				{
					var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
					var claim:DisplayObject = exclusiveTouch.getClaim(this._touchPointID);
					if(claim != this)
					{
						if(claim)
						{
							//already claimed by another display object
							return;
						}
						else
						{
							exclusiveTouch.claimTouch(this._touchPointID, this);
						}
					}
					location = touch.getLocation(this, Pool.getPoint());
					this.value = this.locationToValue(location);
					Pool.putPoint(location);
				}
				else if(touch.phase === TouchPhase.ENDED)
				{
					this._touchPointID = -1;
					this.isDragging = false;
					if(!this.liveDragging)
					{
						this.dispatchEventWith(Event.CHANGE);
					}
					this.dispatchEventWith(FeathersEventType.END_INTERACTION);
				}
			}
			else
			{
				touch = event.getTouch(this.thumb, TouchPhase.BEGAN);
				if(touch === null)
				{
					return;
				}
				location = touch.getLocation(this, Pool.getPoint());
				this._touchPointID = touch.id;
				this._thumbStartX = this.thumb.x;
				this._thumbStartY = this.thumb.y;
				this._touchStartX = location.x;
				this._touchStartY = location.y;
				Pool.putPoint(location);
				this.isDragging = true;
				this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
			}
		}

		/**
		 * @private
		 */
		protected function stage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.keyCode == Keyboard.HOME)
			{
				event.preventDefault();
				this.value = this._minimum;
				return;
			}
			if(event.keyCode == Keyboard.END)
			{
				event.preventDefault();
				this.value = this._maximum;
				return;
			}
			var page:Number = this._page;
			if(page !== page) //isNaN
			{
				page = this._step;
			}
			if(this._direction == Direction.VERTICAL)
			{
				if(event.keyCode == Keyboard.UP)
				{
					event.preventDefault();
					if(event.shiftKey)
					{
						this.value += page;
					}
					else
					{
						this.value += this._step;
					}
				}
				else if(event.keyCode == Keyboard.DOWN)
				{
					event.preventDefault();
					if(event.shiftKey)
					{
						this.value -= page;
					}
					else
					{
						this.value -= this._step;
					}
				}
			}
			else
			{
				if(event.keyCode == Keyboard.LEFT)
				{
					event.preventDefault();
					if(event.shiftKey)
					{
						this.value -= page;
					}
					else
					{
						this.value -= this._step;
					}
				}
				else if(event.keyCode == Keyboard.RIGHT)
				{
					event.preventDefault();
					if(event.shiftKey)
					{
						this.value += page;
					}
					else
					{
						this.value += this._step;
					}
				}
			}
		}

		/**
		 * @private
		 */
		protected function repeatTimer_timerHandler(event:TimerEvent):void
		{
			var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
			var claim:DisplayObject = exclusiveTouch.getClaim(this._touchPointID);
			if(claim && claim != this)
			{
				return;
			}
			if(this._repeatTimer.currentCount < 5)
			{
				return;
			}
			this.currentRepeatAction();
		}
	}
}

================================================
FILE: source/feathers/controls/SpinnerList.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.core.IValidating;
	import feathers.data.IListCollection;
	import feathers.events.FeathersEventType;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.ILayout;
	import feathers.layout.ISpinnerLayout;
	import feathers.layout.VerticalSpinnerLayout;
	import feathers.skins.IStyleProvider;

	import flash.events.KeyboardEvent;
	import flash.events.TransformGestureEvent;
	import flash.geom.Rectangle;
	import flash.ui.Keyboard;

	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * Determines if the <code>selectionOverlaySkin</code> is hidden when
	 * the list is not focused.
	 *
	 * <listing version="3.0">
	 * list.hideSelectionOverlayUnlessFocused = true;</listing>
	 *
	 * <p>Note: If the <code>showSelectionOverlay</code> property is
	 * <code>false</code>, the <code>selectionOverlaySkin</code> will always
	 * be hidden.</p>
	 *
	 * @default false
	 *
	 * @see #style:selectionOverlaySkin
	 * @see #style:showSelectionOverlay
	 */
	[Style(name="hideSelectionOverlayUnlessFocused",type="Boolean")]

	/**
	 * An optional skin to display in the horizontal or vertical center of
	 * the list to highlight the currently selected item. If the list
	 * scrolls vertically, the <code>selectionOverlaySkin</code> will fill
	 * the entire width of the list, and it will be positioned in the
	 * vertical center. If the list scrolls horizontally, the
	 * <code>selectionOverlaySkin</code> will fill the entire height of the
	 * list, and it will be positioned in the horizontal center.
	 *
	 * <p>The following example gives the spinner list a selection overlay
	 * skin:</p>
	 *
	 * <listing version="3.0">
	 * list.selectionOverlaySkin = new Image( texture );</listing>
	 *
	 * @default null
	 */
	[Style(name="selectionOverlaySkin",type="starling.display.DisplayObject")]

	/**
	 * Determines if the <code>selectionOverlaySkin</code> is visible or hidden.
	 *
	 * <p>The following example hides the selection overlay skin:</p>
	 *
	 * <listing version="3.0">
	 * list.showSelectionOverlay = false;</listing>
	 *
	 * @default true
	 *
	 * @see #style:selectionOverlaySkin
	 * @see #style:hideSelectionOverlayUnlessFocused
	 */
	[Style(name="showSelectionOverlay",type="Boolean")]

	/**
	 * A customized <code>List</code> component where scrolling updates the
	 * the selected item. Layouts may loop infinitely.
	 *
	 * <p>The following example creates a list, gives it a data provider, tells
	 * the item renderer how to interpret the data, and listens for when the
	 * selection changes:</p>
	 *
	 * <listing version="3.0">
	 * var list:SpinnerList = new SpinnerList();
	 * 
	 * list.dataProvider = new ArrayCollection(
	 * [
	 *     { text: "Milk", thumbnail: textureAtlas.getTexture( "milk" ) },
	 *     { text: "Eggs", thumbnail: textureAtlas.getTexture( "eggs" ) },
	 *     { text: "Bread", thumbnail: textureAtlas.getTexture( "bread" ) },
	 *     { text: "Chicken", thumbnail: textureAtlas.getTexture( "chicken" ) },
	 * ]);
	 * 
	 * list.itemRendererFactory = function():IListItemRenderer
	 * {
	 *     var renderer:DefaultListItemRenderer = new DefaultListItemRenderer();
	 *     renderer.labelField = "text";
	 *     renderer.iconSourceField = "thumbnail";
	 *     return renderer;
	 * };
	 * 
	 * list.addEventListener( Event.CHANGE, list_changeHandler );
	 * 
	 * this.addChild( list );</listing>
	 *
	 * @see ../../../help/spinner-list.html How to use the Feathers SpinnerList component
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class SpinnerList extends List
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>SpinnerList</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function SpinnerList()
		{
			super();
			this._scrollBarDisplayMode = ScrollBarDisplayMode.NONE;
			this._snapToPages = true;
			this._snapOnComplete = true;
			this.decelerationRate = DecelerationRate.FAST;
			this.addEventListener(Event.TRIGGERED, spinnerList_triggeredHandler);
			this.addEventListener(FeathersEventType.SCROLL_COMPLETE, spinnerList_scrollCompleteHandler);
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			if(SpinnerList.globalStyleProvider)
			{
				return SpinnerList.globalStyleProvider;
			}
			return List.globalStyleProvider;
		}

		/**
		 * <code>SpinnerList</code> requires that the <code>snapToPages</code>
		 * property is set to <code>true</code>. Attempts to set it to
		 * <code>false</code> will result in a runtime error.
		 *
		 * @throws ArgumentError SpinnerList requires snapToPages to be true.
		 */
		override public function set snapToPages(value:Boolean):void
		{
			if(!value)
			{
				throw new ArgumentError("SpinnerList requires snapToPages to be true.");
			}
			super.snapToPages = value;
		}

		/**
		 * <code>SpinnerList</code> requires that the <code>allowMultipleSelection</code>
		 * property is set to <code>false</code>. Attempts to set it to
		 * <code>true</code> will result in a runtime error.
		 *
		 * @throws ArgumentError SpinnerList requires allowMultipleSelection to be false.
		 */
		override public function set allowMultipleSelection(value:Boolean):void
		{
			if(value)
			{
				throw new ArgumentError("SpinnerList requires allowMultipleSelection to be false.");
			}
			super.allowMultipleSelection = value;
		}

		/**
		 * <code>SpinnerList</code> requires that the <code>isSelectable</code>
		 * property is set to <code>true</code>. Attempts to set it to
		 * <code>false</code> will result in a runtime error.
		 *
		 * @throws ArgumentError SpinnerList requires isSelectable to be true.
		 */
		override public function set isSelectable(value:Boolean):void
		{
			if(!value)
			{
				throw new ArgumentError("SpinnerList requires isSelectable to be true.");
			}
			super.isSelectable = value;
		}

		/**
		 * @private
		 */
		protected var _spinnerLayout:ISpinnerLayout;

		/**
		 * @private
		 */
		override public function set layout(value:ILayout):void
		{
			if(value && !(value is ISpinnerLayout))
			{
				throw new ArgumentError("SpinnerList requires layouts to implement the ISpinnerLayout interface.");
			}
			super.layout = value;
			this._spinnerLayout = ISpinnerLayout(value);
		}

		/**
		 * @private
		 */
		override public function set selectedIndex(value:int):void
		{
			if(value < 0 && this._dataProvider !== null && this._dataProvider.length > 0)
			{
				//a SpinnerList must always select an item, unless the data
				//provider is empty
				return;
			}
			if(this._selectedIndex != value)
			{
				this.scrollToDisplayIndex(value, 0);
			}
			super.selectedIndex = value;
		}

		/**
		 * @private
		 */
		override public function set selectedItem(value:Object):void
		{
			if(this._dataProvider === null)
			{
				this.selectedIndex = -1;
				return;
			}
			var index:int = this._dataProvider.getItemIndex(value);
			if(index < 0)
			{
				return;
			}
			this.selectedIndex = index;
		}

		/**
		 * @private
		 */
		override public function set dataProvider(value:IListCollection):void
		{
			if(this._dataProvider == value)
			{
				return;
			}
			super.dataProvider = value;
			if(!this._dataProvider || this._dataProvider.length == 0)
			{
				this.selectedIndex = -1;
			}
			else
			{
				this.selectedIndex = 0;
			}
		}

		/**
		 * @private
		 */
		protected var _selectionOverlaySkin:DisplayObject = null;

		/**
		 * @private
		 */
		public function get selectionOverlaySkin():DisplayObject
		{
			return this._selectionOverlaySkin;
		}

		/**
		 * @private
		 */
		public function set selectionOverlaySkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._selectionOverlaySkin === value)
			{
				return;
			}
			if(this._selectionOverlaySkin && this._selectionOverlaySkin.parent == this)
			{
				this.removeRawChildInternal(this._selectionOverlaySkin);
			}
			this._selectionOverlaySkin = value;
			if(this._selectionOverlaySkin)
			{
				this.addRawChildInternal(this._selectionOverlaySkin);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _showSelectionOverlay:Boolean = true;

		/**
		 * @private
		 */
		public function get showSelectionOverlay():Boolean
		{
			return this._showSelectionOverlay;
		}

		/**
		 * @private
		 */
		public function set showSelectionOverlay(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._showSelectionOverlay === value)
			{
				return;
			}
			this._showSelectionOverlay = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _hideSelectionOverlayUnlessFocused:Boolean = false;

		/**
		 * @private
		 */
		public function get hideSelectionOverlayUnlessFocused():Boolean
		{
			return this._hideSelectionOverlayUnlessFocused;
		}

		/**
		 * @private
		 */
		public function set hideSelectionOverlayUnlessFocused(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._hideSelectionOverlayUnlessFocused === value)
			{
				return;
			}
			this._hideSelectionOverlayUnlessFocused = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			//SpinnerList has a different default layout than its superclass,
			//List, so set it before calling super.initialize()
			if(this._layout === null)
			{
				if(this._hasElasticEdges &&
					this._verticalScrollPolicy === ScrollPolicy.AUTO &&
					this._scrollBarDisplayMode !== ScrollBarDisplayMode.FIXED)
				{
					//so that the elastic edges work even when the max scroll
					//position is 0, similar to iOS.
					this._verticalScrollPolicy = ScrollPolicy.ON;
				}

				var layout:VerticalSpinnerLayout = new VerticalSpinnerLayout();
				layout.useVirtualLayout = true;
				layout.padding = 0;
				layout.gap = 0;
				layout.horizontalAlign = HorizontalAlign.JUSTIFY;
				layout.requestedRowCount = 4;
				this.ignoreNextStyleRestriction();
				this.layout = layout;
			}

			super.initialize();
		}

		/**
		 * @private
		 */
		override protected function refreshMinAndMaxScrollPositions():void
		{
			var oldActualPageWidth:Number = this.actualPageWidth;
			var oldActualPageHeight:Number = this.actualPageHeight;
			super.refreshMinAndMaxScrollPositions();
			if(this._maxVerticalScrollPosition != this._minVerticalScrollPosition)
			{
				this.actualPageHeight = this._spinnerLayout.snapInterval;
				if(!this.isScrolling && this.pendingItemIndex == -1 &&
					this.actualPageHeight != oldActualPageHeight)
				{
					//if the height of items have changed, we need to tweak the
					//scroll position to re-center the selected item.
					//we don't do this if the user is currently scrolling or if
					//the selected index has changed (which will set
					//pendingItemIndex).
					var verticalPageIndex:int = this.calculateNearestPageIndexForItem(this._selectedIndex, this._verticalPageIndex, this._maxVerticalPageIndex);
					this._verticalScrollPosition = this.actualPageHeight * verticalPageIndex;
				}
			}
			else if(this._maxHorizontalScrollPosition != this._minHorizontalScrollPosition)
			{
				this.actualPageWidth = this._spinnerLayout.snapInterval;
				if(!this.isScrolling && this.pendingItemIndex == -1 &&
					this.actualPageWidth != oldActualPageWidth)
				{
					var horizontalPageIndex:int = this.calculateNearestPageIndexForItem(this._selectedIndex, this._horizontalPageIndex, this._maxHorizontalPageIndex);
					this._horizontalScrollPosition = this.actualPageWidth * horizontalPageIndex;
				}
			}
		}

		/**
		 * @private
		 */
		override protected function handlePendingScroll():void
		{
			if(this.pendingItemIndex >= 0)
			{
				var itemIndex:int = this.pendingItemIndex;
				this.pendingItemIndex = -1;
				if(this._maxVerticalPageIndex != this._minVerticalPageIndex)
				{
					this.pendingVerticalPageIndex = this.calculateNearestPageIndexForItem(itemIndex, this._verticalPageIndex, this._maxVerticalPageIndex);
					this.hasPendingVerticalPageIndex = this.pendingVerticalPageIndex != this._verticalPageIndex;
				}
				else if(this._maxHorizontalPageIndex != this._minHorizontalPageIndex)
				{
					this.pendingHorizontalPageIndex = this.calculateNearestPageIndexForItem(itemIndex, this._horizontalPageIndex, this._maxHorizontalPageIndex);
					this.hasPendingHorizontalPageIndex = this.pendingHorizontalPageIndex != this._horizontalPageIndex;
				}
			}
			super.handlePendingScroll();
		}

		/**
		 * @private
		 */
		override protected function layoutChildren():void
		{
			super.layoutChildren();

			if(this._selectionOverlaySkin !== null)
			{
				if(this._showSelectionOverlay && this._hideSelectionOverlayUnlessFocused &&
					this._focusManager !== null && this._isFocusEnabled)
				{
					this._selectionOverlaySkin.visible = this._hasFocus;
				}
				else
				{
					this._selectionOverlaySkin.visible = this._showSelectionOverlay;
				}
				var selectionBounds:Rectangle = this._spinnerLayout.selectionBounds;
				this._selectionOverlaySkin.x = this._leftViewPortOffset + selectionBounds.x;
				this._selectionOverlaySkin.y = this._topViewPortOffset + selectionBounds.y;
				this._selectionOverlaySkin.width = selectionBounds.width;
				this._selectionOverlaySkin.height = selectionBounds.height;
				if(this._selectionOverlaySkin is IValidating)
				{
					IValidating(this._selectionOverlaySkin).validate();
				}
			}
		}

		/**
		 * @private
		 */
		protected function calculateNearestPageIndexForItem(itemIndex:int, currentPageIndex:int, maxPageIndex:int):int
		{
			if(maxPageIndex != int.MAX_VALUE)
			{
				return itemIndex;
			}
			var itemCount:int = this._dataProvider.length;
			var fullDataProviderOffsets:int = currentPageIndex / itemCount;
			var currentItemIndex:int = currentPageIndex % itemCount;
			if(itemIndex < currentItemIndex)
			{
				var previousPageIndex:Number = fullDataProviderOffsets * itemCount + itemIndex;
				var nextPageIndex:Number = (fullDataProviderOffsets + 1) * itemCount + itemIndex;
			}
			else
			{
				previousPageIndex = (fullDataProviderOffsets - 1) * itemCount + itemIndex;
				nextPageIndex = fullDataProviderOffsets * itemCount + itemIndex;
			}
			if((nextPageIndex - currentPageIndex) < (currentPageIndex - previousPageIndex))
			{
				return nextPageIndex;
			}
			return previousPageIndex;
		}

		/**
		 * @private
		 */
		override protected function scroller_removedFromStageHandler(event:Event):void
		{
			if(this._verticalAutoScrollTween)
			{
				this._verticalAutoScrollTween.advanceTime(this._verticalAutoScrollTween.totalTime);
			}
			if(this._horizontalAutoScrollTween)
			{
				this._horizontalAutoScrollTween.advanceTime(this._horizontalAutoScrollTween.totalTime);
			}
			super.scroller_removedFromStageHandler(event);
		}

		/**
		 * @private
		 */
		protected function spinnerList_scrollCompleteHandler(event:Event):void
		{
			var itemCount:int = this._dataProvider.length;
			if(this._maxVerticalPageIndex != this._minVerticalPageIndex)
			{
				var pageIndex:int = this._verticalPageIndex % itemCount;
			}
			else if(this._maxHorizontalPageIndex != this._minHorizontalPageIndex)
			{
				pageIndex = this._horizontalPageIndex % itemCount;
			}
			if(pageIndex < 0)
			{
				pageIndex = itemCount + pageIndex;
			}
			var item:Object = this._dataProvider.getItemAt(pageIndex);
			var itemRenderer:IListItemRenderer = this.itemToItemRenderer(item);
			if(itemRenderer !== null && !itemRenderer.isEnabled)
			{
				//if the item renderer isn't enabled, we cannot select it
				//go back to the previously selected index
				if(this._maxVerticalPageIndex != this._minVerticalPageIndex)
				{
					this.scrollToPageIndex(this._horizontalPageIndex, this._selectedIndex, this._pageThrowDuration);
				}
				else if(this._maxHorizontalPageIndex != this._minHorizontalPageIndex)
				{
					this.scrollToPageIndex(this._selectedIndex, this._verticalPageIndex, this._pageThrowDuration);
				}
				return;
			}
			this.selectedIndex = pageIndex;
		}

		/**
		 * @private
		 */
		protected function spinnerList_triggeredHandler(event:Event, item:Object):void
		{
			var itemIndex:int = this._dataProvider.getItemIndex(item);
			//property must change immediately, but the animation can take longer
			this.selectedIndex = itemIndex;
			if(this._maxVerticalPageIndex != this._minVerticalPageIndex)
			{
				itemIndex = this.calculateNearestPageIndexForItem(itemIndex, this._verticalPageIndex, this._maxVerticalPageIndex);
				this.throwToPage(this._horizontalPageIndex, itemIndex, this._pageThrowDuration);
			}
			else if(this._maxHorizontalPageIndex != this._minHorizontalPageIndex)
			{
				itemIndex = this.calculateNearestPageIndexForItem(itemIndex, this._horizontalPageIndex, this._maxHorizontalPageIndex);
				this.throwToPage(itemIndex, this._verticalPageIndex, this._pageThrowDuration);
			}
		}

		/**
		 * @private
		 */
		override protected function dataProvider_removeItemHandler(event:Event, index:int):void
		{
			super.dataProvider_removeItemHandler(event, index);
			if(this._maxVerticalPageIndex != this._minVerticalPageIndex)
			{
				var itemIndex:int = this.calculateNearestPageIndexForItem(this._selectedIndex, this._verticalPageIndex, this._maxVerticalPageIndex);
				if(itemIndex > this._dataProvider.length)
				{
					itemIndex -= this._dataProvider.length;
				}
				this.scrollToDisplayIndex(itemIndex, 0);
			}
			else if(this._maxHorizontalPageIndex != this._minHorizontalPageIndex)
			{
				itemIndex = this.calculateNearestPageIndexForItem(this._selectedIndex, this._horizontalPageIndex, this._maxHorizontalPageIndex);
				if(itemIndex > this._dataProvider.length)
				{
					itemIndex -= this._dataProvider.length;
				}
				this.scrollToDisplayIndex(itemIndex, 0);
			}
		}

		/**
		 * @private
		 */
		override protected function dataProvider_addItemHandler(event:Event, index:int):void
		{
			super.dataProvider_addItemHandler(event, index);
			if(this._maxVerticalPageIndex != this._minVerticalPageIndex)
			{
				var itemIndex:int = this.calculateNearestPageIndexForItem(this._selectedIndex, this._verticalPageIndex, this._maxVerticalPageIndex);
				if(itemIndex > this._dataProvider.length)
				{
					itemIndex -= this._dataProvider.length;
				}
				this.scrollToDisplayIndex(itemIndex, 0);
			}
			else if(this._maxHorizontalPageIndex != this._minHorizontalPageIndex)
			{
				itemIndex = this.calculateNearestPageIndexForItem(this._selectedIndex, this._horizontalPageIndex, this._maxHorizontalPageIndex);
				if(itemIndex > this._dataProvider.length)
				{
					itemIndex -= this._dataProvider.length;
				}
				this.scrollToDisplayIndex(itemIndex, 0);
			}
		}

		/**
		 * @private
		 */
		override protected function nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.isDefaultPrevented())
			{
				return;
			}
			if(!this._dataProvider)
			{
				return;
			}
			if(event.keyCode == Keyboard.HOME || event.keyCode == Keyboard.END ||
				event.keyCode == Keyboard.PAGE_UP || event.keyCode == Keyboard.PAGE_DOWN ||
				event.keyCode == Keyboard.UP || event.keyCode == Keyboard.DOWN ||
				event.keyCode == Keyboard.LEFT || event.keyCode == Keyboard.RIGHT)
			{
				var newIndex:int = this.dataViewPort.calculateNavigationDestination(this.selectedIndex, event.keyCode);
				if(this.selectedIndex != newIndex)
				{
					//property must change immediately, but the animation can take longer
					this.selectedIndex = newIndex;
					if(this._maxVerticalPageIndex != this._minVerticalPageIndex)
					{
						event.preventDefault();
						var pageIndex:int = this.calculateNearestPageIndexForItem(newIndex, this._verticalPageIndex, this._maxVerticalPageIndex);
						this.throwToPage(this._horizontalPageIndex, pageIndex, this._pageThrowDuration);
					}
					else if(this._maxHorizontalPageIndex != this._minHorizontalPageIndex)
					{
						event.preventDefault();
						pageIndex = this.calculateNearestPageIndexForItem(newIndex, this._horizontalPageIndex, this._maxHorizontalPageIndex);
						this.throwToPage(pageIndex, this._verticalPageIndex, this._pageThrowDuration);
					}
				}
			}
		}

		/**
		 * @private
		 */
		override protected function stage_gestureDirectionalTapHandler(event:TransformGestureEvent):void
		{
			if(event.isDefaultPrevented())
			{
				//something else has already handled this event
				return;
			}
			var keyCode:uint = int.MAX_VALUE;
			if(event.offsetY < 0)
			{
				keyCode = Keyboard.UP;
			}
			else if(event.offsetY > 0)
			{
				keyCode = Keyboard.DOWN;
			}
			else if(event.offsetX > 0)
			{
				keyCode = Keyboard.RIGHT;
			}
			else if(event.offsetX < 0)
			{
				keyCode = Keyboard.LEFT;
			}
			if(keyCode == int.MAX_VALUE)
			{
				return;
			}
			var newIndex:int = this.dataViewPort.calculateNavigationDestination(this.selectedIndex, keyCode);
			if(this.selectedIndex != newIndex)
			{
				//property must change immediately, but the animation can take longer
				this.selectedIndex = newIndex;
				if(this._maxVerticalPageIndex != this._minVerticalPageIndex)
				{
					event.stopImmediatePropagation();
					//event.preventDefault();
					var pageIndex:int = this.calculateNearestPageIndexForItem(newIndex, this._verticalPageIndex, this._maxVerticalPageIndex);
					this.throwToPage(this._horizontalPageIndex, pageIndex, this._pageThrowDuration);
				}
				else if(this._maxHorizontalPageIndex != this._minHorizontalPageIndex)
				{
					event.stopImmediatePropagation();
					//event.preventDefault();
					pageIndex = this.calculateNearestPageIndexForItem(newIndex, this._horizontalPageIndex, this._maxHorizontalPageIndex);
					this.throwToPage(pageIndex, this._verticalPageIndex, this._pageThrowDuration);
				}
			}
		}
	}
}


================================================
FILE: source/feathers/controls/StackScreenNavigator.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.supportClasses.BaseScreenNavigator;
	import feathers.events.ExclusiveTouch;
	import feathers.events.FeathersEventType;
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.skins.IStyleProvider;
	import feathers.system.DeviceCapabilities;

	import flash.geom.Point;
	import flash.utils.getTimer;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * Typically used to provide some kind of animation or visual effect,
	 * this function that is called when the screen navigator pushes a new
	 * screen onto the stack.
	 *
	 * <p>In the following example, the screen navigator is given a push
	 * transition that slides the screens to the left:</p>
	 *
	 * <listing version="3.0">
	 * navigator.pushTransition = Slide.createSlideLeftTransition();</listing>
	 *
	 * <p>A number of animated transitions may be found in the
	 * <a href="../motion/package-detail.html">feathers.motion</a> package.
	 * However, you are not limited to only these transitions. It's possible
	 * to create custom transitions too.</p>
	 *
	 * <p>A custom transition function should have the following signature:</p>
	 * <pre>function(oldScreen:DisplayObject, newScreen:DisplayObject, completeCallback:Function):void</pre>
	 *
	 * <p>Either of the <code>oldScreen</code> and <code>newScreen</code>
	 * arguments may be <code>null</code>, but never both. The
	 * <code>oldScreen</code> argument will be <code>null</code> when the
	 * first screen is displayed or when a new screen is displayed after
	 * clearing the screen. The <code>newScreen</code> argument will
	 * be null when clearing the screen.</p>
	 *
	 * <p>The <code>completeCallback</code> function <em>must</em> be called
	 * when the transition effect finishes. This callback indicate to the
	 * screen navigator that the transition has finished. This function has
	 * the following signature:</p>
	 *
	 * <pre>function(cancelTransition:Boolean = false):void</pre>
	 *
	 * <p>The first argument defaults to <code>false</code>, meaning that
	 * the transition completed successfully. In most cases, this callback
	 * may be called without arguments. If a transition is cancelled before
	 * completion (perhaps through some kind of user interaction), and the
	 * previous screen should be restored, pass <code>true</code> as the
	 * first argument to the callback to inform the screen navigator that
	 * the transition is cancelled.</p>
	 *
	 * @default null
	 *
	 * @see ../../../help/transitions.html Transitions for Feathers screen navigators
	 * @see #pushScreen()
	 * @see #popTransition
	 * @see #popToRootTransition
	 */
	[Style(name="pushTransition",type="Function")]

	/**
	 * Typically used to provide some kind of animation or visual effect,
	 * this function that is called when the screen navigator pops a screen
	 * from the top of the stack.
	 *
	 * <p>In the following example, the screen navigator is given a pop
	 * transition that slides the screens to the right:</p>
	 *
	 * <listing version="3.0">
	 * navigator.popTransition = Slide.createSlideRightTransition();</listing>
	 *
	 * <p>A number of animated transitions may be found in the
	 * <a href="../motion/package-detail.html">feathers.motion</a> package.
	 * However, you are not limited to only these transitions. It's possible
	 * to create custom transitions too.</p>
	 *
	 * <p>A custom transition function should have the following signature:</p>
	 * <pre>function(oldScreen:DisplayObject, newScreen:DisplayObject, completeCallback:Function):void</pre>
	 *
	 * <p>Either of the <code>oldScreen</code> and <code>newScreen</code>
	 * arguments may be <code>null</code>, but never both. The
	 * <code>oldScreen</code> argument will be <code>null</code> when the
	 * first screen is displayed or when a new screen is displayed after
	 * clearing the screen. The <code>newScreen</code> argument will
	 * be null when clearing the screen.</p>
	 *
	 * <p>The <code>completeCallback</code> function <em>must</em> be called
	 * when the transition effect finishes. This callback indicate to the
	 * screen navigator that the transition has finished. This function has
	 * the following signature:</p>
	 *
	 * <pre>function(cancelTransition:Boolean = false):void</pre>
	 *
	 * <p>The first argument defaults to <code>false</code>, meaning that
	 * the transition completed successfully. In most cases, this callback
	 * may be called without arguments. If a transition is cancelled before
	 * completion (perhaps through some kind of user interaction), and the
	 * previous screen should be restored, pass <code>true</code> as the
	 * first argument to the callback to inform the screen navigator that
	 * the transition is cancelled.</p>
	 *
	 * @default null
	 *
	 * @see ../../../help/transitions.html Transitions for Feathers screen navigators
	 * @see #popScreen()
	 * @see #pushTransition
	 * @see #popToRootTransition
	 */
	[Style(name="popTransition",type="Function")]

	/**
	 * Typically used to provide some kind of animation or visual effect, a
	 * function that is called when the screen navigator clears its stack,
	 * to show the first screen that was pushed onto the stack.
	 *
	 * <p>If this property is <code>null</code>, the value of the
	 * <code>popTransition</code> property will be used instead.</p>
	 *
	 * <p>In the following example, a custom pop to root transition is
	 * passed to the screen navigator:</p>
	 *
	 * <listing version="3.0">
	 * navigator.popToRootTransition = Fade.createFadeInTransition();</listing>
	 *
	 * <p>A number of animated transitions may be found in the
	 * <a href="../motion/package-detail.html">feathers.motion</a> package.
	 * However, you are not limited to only these transitions. It's possible
	 * to create custom transitions too.</p>
	 *
	 * <p>A custom transition function should have the following signature:</p>
	 * <pre>function(oldScreen:DisplayObject, newScreen:DisplayObject, completeCallback:Function):void</pre>
	 *
	 * <p>Either of the <code>oldScreen</code> and <code>newScreen</code>
	 * arguments may be <code>null</code>, but never both. The
	 * <code>oldScreen</code> argument will be <code>null</code> when the
	 * first screen is displayed or when a new screen is displayed after
	 * clearing the screen. The <code>newScreen</code> argument will
	 * be null when clearing the screen.</p>
	 *
	 * <p>The <code>completeCallback</code> function <em>must</em> be called
	 * when the transition effect finishes. This callback indicate to the
	 * screen navigator that the transition has finished. This function has
	 * the following signature:</p>
	 *
	 * <pre>function(cancelTransition:Boolean = false):void</pre>
	 *
	 * <p>The first argument defaults to <code>false</code>, meaning that
	 * the transition completed successfully. In most cases, this callback
	 * may be called without arguments. If a transition is cancelled before
	 * completion (perhaps through some kind of user interaction), and the
	 * previous screen should be restored, pass <code>true</code> as the
	 * first argument to the callback to inform the screen navigator that
	 * the transition is cancelled.</p>
	 *
	 * @default null
	 *
	 * @see ../../../help/transitions.html Transitions for Feathers screen navigators
	 * @see #popToRootScreen()
	 * @see #pushTransition
	 * @see #popTransition
	 */
	[Style(name="popToRootTransition",type="Function")]

	/**
	 * A "view stack"-like container that supports navigation between screens
	 * (any display object) through events.
	 *
	 * <p>The following example creates a screen navigator, adds a screen and
	 * displays it:</p>
	 *
	 * <listing version="3.0">
	 * var navigator:StackScreenNavigator = new StackScreenNavigator();
	 * navigator.addScreen( "mainMenu", new StackScreenNavigatorItem( MainMenuScreen ) );
	 * this.addChild( navigator );
	 * 
	 * navigator.rootScreenID = "mainMenu";</listing>
	 *
	 * @see ../../../help/stack-screen-navigator.html How to use the Feathers StackScreenNavigator component
	 * @see ../../../help/transitions.html Transitions for Feathers screen navigators
	 * @see feathers.controls.StackScreenNavigatorItem
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class StackScreenNavigator extends BaseScreenNavigator
	{
		/**
		 * @private
		 * The current velocity is given high importance.
		 */
		private static const CURRENT_VELOCITY_WEIGHT:Number = 2.33;

		/**
		 * @private
		 * Older saved velocities are given less importance.
		 */
		private static const VELOCITY_WEIGHTS:Vector.<Number> = new <Number>[1, 1.33, 1.66, 2];

		/**
		 * @private
		 */
		private static const MAXIMUM_SAVED_VELOCITY_COUNT:int = 4;

		/**
		 * The default <code>IStyleProvider</code> for all <code>StackScreenNavigator</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function StackScreenNavigator()
		{
			super();
			this.addEventListener(FeathersEventType.INITIALIZE, stackScreenNavigator_initializeHandler);
			this.addEventListener(TouchEvent.TOUCH, stackScreenNavigator_touchHandler);
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return StackScreenNavigator.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _isDragging:Boolean = false;

		/**
		 * @private
		 */
		protected var _dragCancelled:Boolean = false;

		/**
		 * @private
		 */
		protected var _startTouchX:Number;

		/**
		 * @private
		 */
		protected var _currentTouchX:Number;

		/**
		 * @private
		 */
		protected var _previousTouchTime:int;

		/**
		 * @private
		 */
		protected var _previousTouchX:Number;

		/**
		 * @private
		 */
		protected var _velocityX:Number = 0;

		/**
		 * @private
		 */
		protected var _previousVelocityX:Vector.<Number> = new <Number>[];

		/**
		 * @private
		 */
		protected var _pushTransition:Function;

		/**
		 * @private
		 */
		public function get pushTransition():Function
		{
			return this._pushTransition;
		}

		/**
		 * @private
		 */
		public function set pushTransition(value:Function):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._pushTransition = value;
		}

		/**
		 * @private
		 */
		protected var _popTransition:Function;

		/**
		 * @private
		 */
		public function get popTransition():Function
		{
			return this._popTransition;
		}

		/**
		 * @private
		 */
		public function set popTransition(value:Function):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._popTransition = value;
		}

		/**
		 * @private
		 */
		protected var _popToRootTransition:Function = null;

		/**
		 * @private
		 */
		public function get popToRootTransition():Function
		{
			return this._popToRootTransition;
		}

		/**
		 * @private
		 */
		public function set popToRootTransition(value:Function):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._popToRootTransition = value;
		}

		/**
		 * @private
		 */
		protected var _poppedStackItem:StackItem = null;

		/**
		 * @private
		 */
		protected var _stack:Vector.<StackItem> = new <StackItem>[];

		/**
		 * @private
		 */
		public function get stackCount():int
		{
			var stackLength:int = this._stack.length;
			if(stackLength > 0)
			{
				return this._stack.length + 1;
			}
			if(this._activeScreen)
			{
				return 1;
			}
			return 0;
		}

		/**
		 * @private
		 */
		protected var _pushScreenEvents:Object = {};

		/**
		 * @private
		 */
		protected var _replaceScreenEvents:Object;

		/**
		 * @private
		 */
		protected var _popScreenEvents:Vector.<String>;

		/**
		 * @private
		 */
		protected var _popToRootScreenEvents:Vector.<String>;

		/**
		 * @private
		 */
		protected var _tempRootScreenID:String;

		/**
		 * Sets the first screen at the bottom of the stack, or the root screen.
		 * When this screen is shown, there will be no transition.
		 *
		 * <p>If the stack contains screens when you set this property, they
		 * will be removed from the stack. In other words, setting this property
		 * will clear the stack, erasing the current history.</p>
		 *
		 * <p>In the following example, the root screen is set:</p>
		 *
		 * <listing version="3.0">
		 * navigator.rootScreenID = "someScreen";</listing>
		 *
		 * @see #popToRootScreen()
		 */
		public function get rootScreenID():String
		{
			if(this._tempRootScreenID !== null)
			{
				return this._tempRootScreenID;
			}
			else if(this._stack.length == 0)
			{
				return this._activeScreenID;
			}
			return this._stack[0].id;
		}

		/**
		 * @private
		 */
		public function set rootScreenID(value:String):void
		{
			if(this._isInitialized)
			{
				//we may have delayed showing the root screen until after
				//initialization, but this property could be set between when
				//_isInitialized is set to true and when the screen is actually
				//shown, so we need to clear this variable, just in case.
				this._tempRootScreenID = null;

				//this clears the whole stack and starts fresh
				this._stack.length = 0;
				if(value !== null)
				{
					//show without a transition because we're not navigating.
					//we're forcibly replacing the root screen.
					this.showScreenInternal(value, null);
				}
				else
				{
					this.clearScreenInternal(null);
				}
			}
			else
			{
				this._tempRootScreenID = value;
			}
		}

		/**
		 * @private
		 */
		protected var _minimumDragDistance:Number = 0.04;

		/**
		 * The minimum physical distance (in inches) that a touch must move
		 * before a drag gesture begins when <code>isSwipeToPopEnabled</code>
		 * is <code>true</code>.
		 *
		 * <p>In the following example, the minimum drag distance is customized:</p>
		 *
		 * <listing version="3.0">
		 * scroller.minimumDragDistance = 0.1;</listing>
		 *
		 * @default 0.04
		 *
		 * @see #isSwipeToPopEnabled
		 */
		public function get minimumDragDistance():Number
		{
			return this._minimumDragDistance;
		}

		/**
		 * @private
		 */
		public function set minimumDragDistance(value:Number):void
		{
			this._minimumDragDistance = value;
		}

		/**
		 * @private
		 */
		protected var _minimumSwipeVelocity:Number = 5;

		/**
		 * The minimum physical velocity (in inches per second) that a touch
		 * must move before a swipe is detected. Otherwise, it will settle which
		 * screen to navigate to based on which one is closer when the touch ends.
		 *
		 * <p>In the following example, the minimum swipe velocity is customized:</p>
		 *
		 * <listing version="3.0">
		 * navigator.minimumSwipeVelocity = 2;</listing>
		 *
		 * @default 5
		 *
		 * @see #isSwipeToPopEnabled
		 */
		public function get minimumSwipeVelocity():Number
		{
			return this._minimumSwipeVelocity;
		}

		/**
		 * @private
		 */
		public function set minimumSwipeVelocity(value:Number):void
		{
			this._minimumSwipeVelocity = value;
		}

		/**
		 * @private
		 */
		protected var _isSwipeToPopEnabled:Boolean = false;

		/**
		 * Determines if the swipe gesture to pop the current screen is enabled.
		 *
		 * <p>In the following example, swiping to go back is enabled:</p>
		 *
		 * <listing version="3.0">
		 * navigator.isSwipeToPopEnabled = true;</listing>
		 *
		 * @default false
		 */
		public function get isSwipeToPopEnabled():Boolean
		{
			return this._isSwipeToPopEnabled;
		}

		/**
		 * @private
		 */
		public function set isSwipeToPopEnabled(value:Boolean):void
		{
			this._isSwipeToPopEnabled = value;
		}

		/**
		 * @private
		 */
		protected var _swipeToPopGestureEdgeSize:Number = 0.1;

		/**
		 * The size (in inches) of the region near the left edge of the content
		 * that can be dragged when <code>isSwipeToPopEnabled</code> is
		 * <code>true</code>.
		 *
		 * <p>In the following example, the swipe-to-pop gesture edge size is
		 * customized:</p>
		 *
		 * <listing version="3.0">
		 * drawers.swipeToPopGestureEdgeSize = 0.25;</listing>
		 *
		 * @default 0.1
		 *
		 * @see #isSwipeToPopEnabled
		 */
		public function get swipeToPopGestureEdgeSize():Number
		{
			return this._swipeToPopGestureEdgeSize;
		}

		/**
		 * @private
		 */
		public function set swipeToPopGestureEdgeSize(value:Number):void
		{
			this._swipeToPopGestureEdgeSize = value;
		}

		/**
		 * @private
		 */
		protected var _savedTransitionOnComplete:Function = null;

		/**
		 * @private
		 */
		protected var _dragEffectContext:IEffectContext = null;

		/**
		 * @private
		 */
		protected var _dragEffectTransition:Function = null;

		/**
		 * Registers a new screen with a string identifier that can be used
		 * to reference the screen in other calls, like <code>removeScreen()</code>
		 * or <code>pushScreen()</code>.
		 *
		 * @see #removeScreen()
		 */
		public function addScreen(id:String, item:StackScreenNavigatorItem):void
		{
			this.addScreenInternal(id, item);
		}

		/**
		 * Removes an existing screen using the identifier assigned to it in the
		 * call to <code>addScreen()</code>.
		 *
		 * @see #removeAllScreens()
		 * @see #addScreen()
		 */
		public function removeScreen(id:String):StackScreenNavigatorItem
		{
			var stackCount:int = this._stack.length;
			for(var i:int = stackCount - 1; i >= 0; i--)
			{
				var item:StackItem = this._stack[i];
				if(item.id === id)
				{
					this._stack.removeAt(i);
					//don't break here because there might be multiple screens
					//with this ID in the stack
				}
			}
			return StackScreenNavigatorItem(this.removeScreenInternal(id));
		}

		/**
		 * @private
		 */
		override public function removeAllScreens():void
		{
			this._stack.length = 0;
			super.removeAllScreens();
		}

		/**
		 * Returns the <code>StackScreenNavigatorItem</code> instance with the
		 * specified identifier.
		 */
		public function getScreen(id:String):StackScreenNavigatorItem
		{
			if(this._screens.hasOwnProperty(id))
			{
				return StackScreenNavigatorItem(this._screens[id]);
			}
			return null;
		}

		/**
		 * Pushes a screen onto the top of the stack.
		 *
		 * <p>A set of key-value pairs representing properties on the previous
		 * screen may be passed in. If the new screen is popped, these values
		 * may be used to restore the previous screen's state.</p>
		 *
		 * <p>An optional transition may be specified. If <code>null</code> the
		 * <code>pushTransition</code> property will be used instead.</p>
		 *
		 * <p>Returns a reference to the new screen, unless a transition is
		 * currently active. In that case, the new screen will be queued until
		 * the transition has completed, and no reference will be returned.</p>
		 *
		 * @see #pushTransition
		 */
		public function pushScreen(id:String, savedPreviousScreenProperties:Object = null, transition:Function = null):DisplayObject
		{
			if(transition === null)
			{
				var item:StackScreenNavigatorItem = this.getScreen(id);
				if(item && item.pushTransition !== null)
				{
					transition = item.pushTransition;
				}
				else
				{
					transition = this.pushTransition;
				}
			}
			if(this._activeScreenID)
			{
				this._stack[this._stack.length] = new StackItem(this._activeScreenID, savedPreviousScreenProperties);
			}
			else if(savedPreviousScreenProperties)
			{
				throw new ArgumentError("Cannot save properties for the previous screen because there is no previous screen.");
			}
			return this.showScreenInternal(id, transition);
		}

		/**
		 * Pops the current screen from the top of the stack, returning to the
		 * previous screen.
		 *
		 * <p>An optional transition may be specified. If <code>null</code> the
		 * <code>popTransition</code> property will be used instead.</p>
		 *
		 * <p>Returns a reference to the new screen, unless a transition is
		 * currently active. In that case, the new screen will be queued until
		 * the transition has completed, and no reference will be returned.</p>
		 *
		 * @see #popTransition
		 */
		public function popScreen(transition:Function = null):DisplayObject
		{
			if(this._stack.length == 0)
			{
				return this._activeScreen;
			}
			if(transition === null)
			{
				var screenItem:StackScreenNavigatorItem = this.getScreen(this._activeScreenID);
				if(screenItem && screenItem.popTransition !== null)
				{
					transition = screenItem.popTransition;
				}
				else
				{
					transition = this.popTransition;
				}
			}
			this._poppedStackItem = this._stack.pop();
			return this.showScreenInternal(this._poppedStackItem.id, transition, this._poppedStackItem.properties);
		}

		/**
		 * Returns to the root screen, at the bottom of the stack.
		 *
		 * <p>An optional transition may be specified. If <code>null</code>, the
		 * <code>popToRootTransition</code> or <code>popTransition</code>
		 * property will be used instead.</p>
		 *
		 * <p>Returns a reference to the new screen, unless a transition is
		 * currently active. In that case, the new screen will be queued until
		 * the transition has completed, and no reference will be returned.</p>
		 *
		 * @see #popToRootTransition
		 * @see #popTransition
		 */
		public function popToRootScreen(transition:Function = null):DisplayObject
		{
			if(this._stack.length == 0)
			{
				return this._activeScreen;
			}
			if(transition == null)
			{
				transition = this.popToRootTransition;
				if(transition == null)
				{
					transition = this.popTransition;
				}
			}
			var item:StackItem = this._stack[0];
			this._stack.length = 0;
			return this.showScreenInternal(item.id, transition, item.properties);
		}

		/**
		 * Pops all screens from the stack, leaving the
		 * <code>StackScreenNavigator</code> empty.
		 *
		 * <p>An optional transition may be specified. If <code>null</code>, the
		 * <code>popTransition</code> property will be used instead.</p>
		 *
		 * @see #popTransition
		 */
		public function popAll(transition:Function = null):void
		{
			if(!this._activeScreen)
			{
				return;
			}
			if(transition == null)
			{
				transition = this.popTransition;
			}
			this._stack.length = 0;
			this.clearScreenInternal(transition);
		}

		/**
		 * Returns to the root screen, at the bottom of the stack, but replaces
		 * it with a new root screen.
		 *
		 * <p>An optional transition may be specified. If <code>null</code>, the
		 * <code>popToRootTransition</code> or <code>popTransition</code>
		 * property will be used instead.</p>
		 *
		 * <p>Returns a reference to the new screen, unless a transition is
		 * currently active. In that case, the new screen will be queued until
		 * the transition has completed, and no reference will be returned.</p>
		 *
		 * @see #popToRootTransition
		 * @see #popTransition
		 */
		public function popToRootScreenAndReplace(id:String, transition:Function = null):DisplayObject
		{
			if(transition == null)
			{
				transition = this.popToRootTransition;
				if(transition == null)
				{
					transition = this.popTransition;
				}
			}
			this._stack.length = 0;
			return this.showScreenInternal(id, transition);
		}

		/**
		 * Replaces the current screen on the top of the stack with a new
		 * screen. May be used in the case where you want to navigate from
		 * screen A to screen B and then to screen C, but when popping screen C,
		 * you want to skip screen B and return to screen A.
		 *
		 * <p>Returns a reference to the new screen, unless a transition is
		 * currently active. In that case, the new screen will be queued until
		 * the transition has completed, and no reference will be returned.</p>
		 *
		 * <p>An optional transition may be specified. If <code>null</code> the
		 * <code>pushTransition</code> property will be used instead.</p>
		 *
		 * @see #pushTransition
		 */
		public function replaceScreen(id:String, transition:Function = null):DisplayObject
		{
			if(transition === null)
			{
				var item:StackScreenNavigatorItem = this.getScreen(id);
				if(item && item.pushTransition !== null)
				{
					transition = item.pushTransition;
				}
				else
				{
					transition = this.pushTransition;
				}
			}
			return this.showScreenInternal(id, transition);
		}

		/**
		 * @private
		 */
		override public function hitTest(local:Point):DisplayObject
		{
			var result:DisplayObject = super.hitTest(local);
			if(this._isDragging && result !== null)
			{
				//don't allow touches to reach children while dragging
				return this;
			}
			return result;
		}

		/**
		 * @private
		 */
		override protected function prepareActiveScreen():void
		{
			var item:StackScreenNavigatorItem = StackScreenNavigatorItem(this._screens[this._activeScreenID]);
			this.addPushEventsToActiveScreen(item);
			this.addReplaceEventsToActiveScreen(item);
			this.addPopEventsToActiveScreen(item);
			this.addPopToRootEventsToActiveScreen(item);
		}

		/**
		 * @private
		 */
		override protected function cleanupActiveScreen():void
		{
			var item:StackScreenNavigatorItem = StackScreenNavigatorItem(this._screens[this._activeScreenID]);
			this.removePushEventsFromActiveScreen(item);
			this.removeReplaceEventsFromActiveScreen(item);
			this.removePopEventsFromActiveScreen(item);
			this.removePopToRootEventsFromActiveScreen(item);
		}

		/**
		 * @private
		 */
		protected function addPushEventsToActiveScreen(item:StackScreenNavigatorItem):void
		{
			var events:Object = item.pushEvents;
			var savedScreenEvents:Object = {};
			for(var eventName:String in events)
			{
				var signal:Object = null;
				if(BaseScreenNavigator.SIGNAL_TYPE !== null &&
					this._activeScreen.hasOwnProperty(eventName))
				{
					signal = this._activeScreen[eventName] as BaseScreenNavigator.SIGNAL_TYPE;
				}
				var eventAction:Object = events[eventName];
				if(eventAction is Function)
				{
					if(signal)
					{
						signal.add(eventAction as Function);
					}
					else
					{
						this._activeScreen.addEventListener(eventName, eventAction as Function);
					}
				}
				else if(eventAction is String)
				{
					if(signal)
					{
						var eventListener:Function = this.createPushScreenSignalListener(eventAction as String, signal);
						signal.add(eventListener);
					}
					else
					{
						eventListener = this.createPushScreenEventListener(eventAction as String);
						this._activeScreen.addEventListener(eventName, eventListener);
					}
					savedScreenEvents[eventName] = eventListener;
				}
				else
				{
					throw new TypeError("Unknown push event action defined for screen:", eventAction.toString());
				}
			}
			this._pushScreenEvents[this._activeScreenID] = savedScreenEvents;
		}

		/**
		 * @private
		 */
		protected function removePushEventsFromActiveScreen(item:StackScreenNavigatorItem):void
		{
			var pushEvents:Object = item.pushEvents;
			var savedScreenEvents:Object = this._pushScreenEvents[this._activeScreenID];
			for(var eventName:String in pushEvents)
			{
				var signal:Object = null;
				if(BaseScreenNavigator.SIGNAL_TYPE !== null &&
					this._activeScreen.hasOwnProperty(eventName))
				{
					signal = this._activeScreen[eventName] as BaseScreenNavigator.SIGNAL_TYPE;
				}
				var eventAction:Object = pushEvents[eventName];
				if(eventAction is Function)
				{
					if(signal)
					{
						signal.remove(eventAction as Function);
					}
					else
					{
						this._activeScreen.removeEventListener(eventName, eventAction as Function);
					}
				}
				else if(eventAction is String)
				{
					var eventListener:Function = savedScreenEvents[eventName] as Function;
					if(signal)
					{
						signal.remove(eventListener);
					}
					else
					{
						this._activeScreen.removeEventListener(eventName, eventListener);
					}
				}
			}
			this._pushScreenEvents[this._activeScreenID] = null;
		}

		/**
		 * @private
		 */
		protected function addReplaceEventsToActiveScreen(item:StackScreenNavigatorItem):void
		{
			var events:Object = item.replaceEvents;
			if(!events)
			{
				return;
			}
			var savedScreenEvents:Object = {};
			for(var eventName:String in events)
			{
				var signal:Object = null;
				if(BaseScreenNavigator.SIGNAL_TYPE !== null &&
					this._activeScreen.hasOwnProperty(eventName))
				{
					signal = this._activeScreen[eventName] as BaseScreenNavigator.SIGNAL_TYPE;
				}
				var eventAction:Object = events[eventName];
				if(eventAction is String)
				{
					if(signal)
					{
						var eventListener:Function = this.createReplaceScreenSignalListener(eventAction as String, signal);
						signal.add(eventListener);
					}
					else
					{
						eventListener = this.createReplaceScreenEventListener(eventAction as String);
						this._activeScreen.addEventListener(eventName, eventListener);
					}
					savedScreenEvents[eventName] = eventListener;
				}
				else
				{
					throw new TypeError("Unknown replace event action defined for screen:", eventAction.toString());
				}
			}
			if(!this._replaceScreenEvents)
			{
				this._replaceScreenEvents = {};
			}
			this._replaceScreenEvents[this._activeScreenID] = savedScreenEvents;
		}

		/**
		 * @private
		 */
		protected function removeReplaceEventsFromActiveScreen(item:StackScreenNavigatorItem):void
		{
			var replaceEvents:Object = item.replaceEvents;
			if(!replaceEvents)
			{
				return;
			}
			var savedScreenEvents:Object = this._replaceScreenEvents[this._activeScreenID];
			for(var eventName:String in replaceEvents)
			{
				var signal:Object = null;
				if(BaseScreenNavigator.SIGNAL_TYPE !== null &&
					this._activeScreen.hasOwnProperty(eventName))
				{
					signal = this._activeScreen[eventName] as BaseScreenNavigator.SIGNAL_TYPE;
				}
				var eventAction:Object = replaceEvents[eventName];
				if(eventAction is String)
				{
					var eventListener:Function = savedScreenEvents[eventName] as Function;
					if(signal)
					{
						signal.remove(eventListener);
					}
					else
					{
						this._activeScreen.removeEventListener(eventName, eventListener);
					}
				}
			}
			this._replaceScreenEvents[this._activeScreenID] = null;
		}

		/**
		 * @private
		 */
		protected function addPopEventsToActiveScreen(item:StackScreenNavigatorItem):void
		{
			if(!item.popEvents)
			{
				return;
			}
			//creating a copy because this array could change before the screen
			//is removed.
			var popEvents:Vector.<String> = item.popEvents.slice();
			var eventCount:int = popEvents.length;
			for(var i:int = 0; i < eventCount; i++)
			{
				var eventName:String = popEvents[i];
				var signal:Object = null;
				if(BaseScreenNavigator.SIGNAL_TYPE !== null &&
					this._activeScreen.hasOwnProperty(eventName))
				{
					signal = this._activeScreen[eventName] as BaseScreenNavigator.SIGNAL_TYPE;
				}
				if(signal)
				{
					signal.add(popSignalListener);
				}
				else
				{
					this._activeScreen.addEventListener(eventName, popEventListener);
				}
			}
			this._popScreenEvents = popEvents;
		}

		/**
		 * @private
		 */
		protected function removePopEventsFromActiveScreen(item:StackScreenNavigatorItem):void
		{
			if(!this._popScreenEvents)
			{
				return;
			}
			var eventCount:int = this._popScreenEvents.length;
			for(var i:int = 0; i < eventCount; i++)
			{
				var eventName:String = this._popScreenEvents[i];
				var signal:Object = null;
				if(BaseScreenNavigator.SIGNAL_TYPE !== null &&
					this._activeScreen.hasOwnProperty(eventName))
				{
					signal = this._activeScreen[eventName] as BaseScreenNavigator.SIGNAL_TYPE;
				}
				if(signal)
				{
					signal.remove(popSignalListener);
				}
				else
				{
					this._activeScreen.removeEventListener(eventName, popEventListener);
				}
			}
			this._popScreenEvents = null;
		}

		/**
		 * @private
		 */
		protected function removePopToRootEventsFromActiveScreen(item:StackScreenNavigatorItem):void
		{
			if(!this._popToRootScreenEvents)
			{
				return;
			}
			var eventCount:int = this._popToRootScreenEvents.length;
			for(var i:int = 0; i < eventCount; i++)
			{
				var eventName:String = this._popToRootScreenEvents[i];
				var signal:Object = null;
				if(BaseScreenNavigator.SIGNAL_TYPE !== null &&
					this._activeScreen.hasOwnProperty(eventName))
				{
					signal = this._activeScreen[eventName] as BaseScreenNavigator.SIGNAL_TYPE;
				}
				if(signal)
				{
					signal.remove(popToRootSignalListener);
				}
				else
				{
					this._activeScreen.removeEventListener(eventName, popToRootEventListener);
				}
			}
			this._popToRootScreenEvents = null;
		}

		/**
		 * @private
		 */
		protected function addPopToRootEventsToActiveScreen(item:StackScreenNavigatorItem):void
		{
			if(!item.popToRootEvents)
			{
				return;
			}
			//creating a copy because this array could change before the screen
			//is removed.
			var popToRootEvents:Vector.<String> = item.popToRootEvents.slice();
			var eventCount:int = popToRootEvents.length;
			for(var i:int = 0; i < eventCount; i++)
			{
				var eventName:String = popToRootEvents[i];
				var signal:Object = null;
				if(BaseScreenNavigator.SIGNAL_TYPE !== null &&
					this._activeScreen.hasOwnProperty(eventName))
				{
					signal = this._activeScreen[eventName] as BaseScreenNavigator.SIGNAL_TYPE;
				}
				if(signal)
				{
					signal.add(popToRootSignalListener);
				}
				else
				{
					this._activeScreen.addEventListener(eventName, popToRootEventListener);
				}
			}
			this._popToRootScreenEvents = popToRootEvents;
		}

		/**
		 * @private
		 */
		protected function createPushScreenEventListener(screenID:String):Function
		{
			var self:StackScreenNavigator = this;
			var eventListener:Function = function(event:Event, data:Object):void
			{
				self.pushScreen(screenID, data);
			};

			return eventListener;
		}

		/**
		 * @private
		 */
		protected function createPushScreenSignalListener(screenID:String, signal:Object):Function
		{
			var self:StackScreenNavigator = this;
			if(signal.valueClasses.length == 1)
			{
				//shortcut to avoid the allocation of the rest array
				var signalListener:Function = function(arg0:Object):void
				{
					self.pushScreen(screenID, arg0);
				};
			}
			else
			{
				signalListener = function(...rest:Array):void
				{
					var data:Object;
					if(rest.length > 0)
					{
						data = rest[0];
					}
					self.pushScreen(screenID, data);
				};
			}

			return signalListener;
		}

		/**
		 * @private
		 */
		protected function createReplaceScreenEventListener(screenID:String):Function
		{
			var self:StackScreenNavigator = this;
			var eventListener:Function = function(event:Event):void
			{
				self.replaceScreen(screenID);
			};

			return eventListener;
		}

		/**
		 * @private
		 */
		protected function createReplaceScreenSignalListener(screenID:String, signal:Object):Function
		{
			var self:StackScreenNavigator = this;
			if(signal.valueClasses.length == 0)
			{
				//shortcut to avoid the allocation of the rest array
				var signalListener:Function = function():void
				{
					self.replaceScreen(screenID);
				};
			}
			else
			{
				signalListener = function(...rest:Array):void
				{
					self.replaceScreen(screenID);
				};
			}

			return signalListener;
		}

		/**
		 * @private
		 */
		protected function handleTouchBegan(touch:Touch):void
		{
			var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
			if(exclusiveTouch.getClaim(touch.id))
			{
				//already claimed
				return;
			}

			var point:Point = Pool.getPoint();
			touch.getLocation(this, point);
			var localX:Number = point.x;
			Pool.putPoint(point);

			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var leftInches:Number = localX / (DeviceCapabilities.dpi / starling.contentScaleFactor);
			if(leftInches < 0 || leftInches > this._swipeToPopGestureEdgeSize)
			{
				//we're not close enough to the edge
				return;
			}

			this._touchPointID = touch.id;
			this._velocityX = 0;
			this._previousVelocityX.length = 0;
			this._previousTouchTime = getTimer();
			this._previousTouchX = this._startTouchX = this._currentTouchX = localX;
			this._isDragging = false;
			this._dragCancelled = false;

			exclusiveTouch.addEventListener(Event.CHANGE, exclusiveTouch_changeHandler);
		}

		/**
		 * @private
		 */
		protected function handleTouchMoved(touch:Touch):void
		{
			var point:Point = Pool.getPoint();
			touch.getLocation(this, point);
			this._currentTouchX = point.x;
			Pool.putPoint(point);
			var now:int = getTimer();
			var timeOffset:int = now - this._previousTouchTime;
			if(timeOffset > 0)
			{
				//we're keeping previous velocity updates to improve accuracy
				this._previousVelocityX[this._previousVelocityX.length] = this._velocityX;
				if(this._previousVelocityX.length > MAXIMUM_SAVED_VELOCITY_COUNT)
				{
					this._previousVelocityX.shift();
				}
				this._velocityX = (this._currentTouchX - this._previousTouchX) / timeOffset;
				this._previousTouchTime = now;
				this._previousTouchX = this._currentTouchX;
			}
		}

		/**
		 * @private
		 */
		protected function dragTransition(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function):void
		{
			this._savedTransitionOnComplete = onComplete;
			this._dragEffectContext = this._dragEffectTransition(this._previousScreenInTransition, this._activeScreen, null, true);
			this._dragEffectTransition = null;
			this.handleDragMove();
		}

		/**
		 * @private
		 */
		protected function handleDragMove():void
		{
			if(this._dragEffectContext === null)
			{
				//the transition may not have started yet
				return;
			}
			var offsetX:Number = this._currentTouchX - this._startTouchX;
			this._dragEffectContext.position = offsetX / this.screenContainer.width;
		}

		/**
		 * @private
		 */
		protected function handleDragEnd():void
		{
			if(this._dragEffectContext === null)
			{
				//if we're waiting to start the transition for performance
				//reasons, force it to start immediately
				if(this._waitingTransition !== null)
				{
					this.startWaitingTransition();
				}
			}

			this._dragCancelled = false;
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;

			var sum:Number = this._velocityX * CURRENT_VELOCITY_WEIGHT;
			var velocityCount:int = this._previousVelocityX.length;
			var totalWeight:Number = CURRENT_VELOCITY_WEIGHT;
			for(var i:int = 0; i < velocityCount; i++)
			{
				var weight:Number = VELOCITY_WEIGHTS[i];
				sum += this._previousVelocityX.shift() * weight;
				totalWeight += weight;
			}

			var inchesPerSecondX:Number = 1000 * (sum / totalWeight) / (DeviceCapabilities.dpi / starling.contentScaleFactor);
			if(inchesPerSecondX < -this._minimumSwipeVelocity)
			{
				//force back to current screen
				if(this._isDragging)
				{
					this._dragCancelled = true;
				}
			}
			else
			{
				var offsetX:Number = this._currentTouchX - this._startTouchX;
				var ratio:Number = offsetX / this.screenContainer.width;
				if(ratio <= 0.5)
				{
					if(this._isDragging)
					{
						this._dragCancelled = true;
					}
				}
			}

			this._dragEffectContext.addEventListener(Event.COMPLETE, dragEffectContext_completeHandler);
			if(this._dragCancelled)
			{
				this._dragEffectContext.playReverse();
			}
			else
			{
				this._dragEffectContext.play();
			}
		}

		/**
		 * @private
		 */
		protected function checkForDrag():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var horizontalInchesMoved:Number = (this._currentTouchX - this._startTouchX) / (DeviceCapabilities.dpi / starling.contentScaleFactor);
			if(horizontalInchesMoved < this._minimumDragDistance)
			{
				return;
			}

			this._dragEffectTransition = null;
			var screenItem:StackScreenNavigatorItem = this.getScreen(this._activeScreenID);
			if(screenItem && screenItem.popTransition !== null)
			{
				this._dragEffectTransition = screenItem.popTransition;
			}
			else
			{
				this._dragEffectTransition = this.popTransition;
			}

			//if no transition has been specified, use the default
			if(this._dragEffectTransition === null)
			{
				this._dragEffectTransition = defaultTransition;
			}

			//if this is an old transition that doesn't support being managed,
			//simply start it without management.
			if(this._dragEffectTransition.length < 4)
			{
				this._dragEffectTransition = null;
				this.popScreen();
				return;
			}

			this._isDragging = true;
			this.popScreen(dragTransition);
			this._startTouchX = this._currentTouchX;
			var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
			exclusiveTouch.removeEventListener(Event.CHANGE, exclusiveTouch_changeHandler);
			exclusiveTouch.claimTouch(this._touchPointID, this);
			this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
		}

		/**
		 * @private
		 */
		override protected function transitionComplete(cancelTransition:Boolean = false):void
		{
			this._poppedStackItem = null;
			super.transitionComplete(cancelTransition);
		}

		/**
		 * @private
		 */
		protected function popEventListener(event:Event):void
		{
			this.popScreen();
		}

		/**
		 * @private
		 */
		protected function popSignalListener(...rest:Array):void
		{
			this.popScreen();
		}

		/**
		 * @private
		 */
		protected function popToRootEventListener(event:Event):void
		{
			this.popToRootScreen();
		}

		/**
		 * @private
		 */
		protected function popToRootSignalListener(...rest:Array):void
		{
			this.popToRootScreen();
		}

		/**
		 * @private
		 */
		protected function stackScreenNavigator_initializeHandler(event:Event):void
		{
			if(this._tempRootScreenID !== null)
			{
				var screenID:String = this._tempRootScreenID;
				this._tempRootScreenID = null;
				this.showScreenInternal(screenID, null);
			}
		}

		/**
		 * @private
		 */
		protected function stackScreenNavigator_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled || !this._isSwipeToPopEnabled || (this._stack.length == 0 && !this._isDragging))
			{
				this._touchPointID = -1;
				return;
			}
			if(this._touchPointID != -1)
			{
				var touch:Touch = event.getTouch(this, null, this._touchPointID);
				if(touch === null)
				{
					return;
				}
				if(touch.phase === TouchPhase.MOVED)
				{
					this.handleTouchMoved(touch);

					if(!this._isDragging)
					{
						this.checkForDrag();
					}
					if(this._isDragging)
					{
						this.handleDragMove();
					}
				}
				else if(touch.phase === TouchPhase.ENDED)
				{
					this._touchPointID = -1;
					if(this._isDragging)
					{
						this.handleDragEnd();
						this.dispatchEventWith(FeathersEventType.END_INTERACTION);
					}
				}
			}
			else
			{
				touch = event.getTouch(this, TouchPhase.BEGAN);
				if(touch === null)
				{
					return;
				}
				this.handleTouchBegan(touch);
			}
		}

		/**
		 * @private
		 */
		protected function exclusiveTouch_changeHandler(event:Event, touchID:int):void
		{
			if(this._touchPointID == -1 || this._touchPointID != touchID || this._isDragging)
			{
				return;
			}

			var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
			if(exclusiveTouch.getClaim(touchID) === this)
			{
				return;
			}

			this._touchPointID = -1;
		}

		/**
		 * @private
		 */
		protected function dragEffectContext_completeHandler(event:Event):void
		{
			this._dragEffectContext.removeEventListeners();
			this._dragEffectContext = null;
			this._isDragging = false;
			var cancelled:Boolean = this._dragCancelled;
			this._dragCancelled = false;
			var onComplete:Function = this._savedTransitionOnComplete;
			this._savedTransitionOnComplete = null;
			if(cancelled)
			{
				this._stack[this._stack.length] = this._poppedStackItem;
			}
			onComplete(cancelled);
		}
	}
}

final class StackItem
{
	public function StackItem(id:String, properties:Object)
	{
		this.id = id;
		this.properties = properties;
	}

	public var id:String;
	public var properties:Object;
}


================================================
FILE: source/feathers/controls/StackScreenNavigatorItem.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.supportClasses.IScreenNavigatorItem;

	import starling.display.DisplayObject;

	/**
	 * Data for an individual screen that will be displayed by a
	 * <code>StackScreenNavigator</code> component.
	 *
	 * <p>The following example creates a new
	 * <code>StackScreenNavigatorItem</code> using the
	 * <code>SettingsScreen</code> class to instantiate the screen instance.
	 * When the screen is shown, its <code>settings</code> property will be set.
	 * When the screen instance dispatches the
	 * <code>SettingsScreen.SHOW_ADVANCED_SETTINGS</code> event, the
	 * <code>StackScreenNavigator</code> will push a screen with the ID
	 * <code>"advancedSettings"</code> onto its stack. When the screen instance
	 * dispatches <code>Event.COMPLETE</code>, the <code>StackScreenNavigator</code>
	 * will pop the screen instance from its stack.</p>
	 *
	 * <listing version="3.0">
	 * var settingsData:Object = { volume: 0.8, difficulty: "hard" };
	 * var item:StackScreenNavigatorItem = new StackScreenNavigatorItem( SettingsScreen );
	 * item.properties.settings = settingsData;
	 * item.setScreenIDForPushEvent( SettingsScreen.SHOW_ADVANCED_SETTINGS, "advancedSettings" );
	 * item.addPopEvent( Event.COMPLETE );
	 * navigator.addScreen( "settings", item );</listing>
	 *
	 * @see ../../../help/stack-screen-navigator.html How to use the Feathers StackScreenNavigator component
	 * @see feathers.controls.StackScreenNavigator
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class StackScreenNavigatorItem implements IScreenNavigatorItem
	{
		/**
		 * Constructor.
		 *
		 * @param screen The screen to display. Must be a <code>Class</code>, <code>Function</code>, or Starling display object.
		 * @param pushEvents The screen navigator push a new screen when these events are dispatched.
		 * @param popEvent An event that pops the screen from the top of the stack.
		 * @param properties A set of key-value pairs to pass to the screen when it is shown.
		 */
		public function StackScreenNavigatorItem(screen:Object = null, pushEvents:Object = null, popEvent:String = null, properties:Object = null)
		{
			this._screen = screen;
			this._pushEvents = pushEvents ? pushEvents : {};
			if(popEvent)
			{
				this.addPopEvent(popEvent);
			}
			this._properties = properties ? properties : {};
		}

		/**
		 * @private
		 */
		protected var _screen:Object;

		/**
		 * The screen to be displayed by the <code>ScreenNavigator</code>. It
		 * may be one of several possible types:
		 *
		 * <ul>
		 *     <li>a <code>Class</code> that may be instantiated to create a <code>DisplayObject</code></li>
		 *     <li>a <code>Function</code> that returns a <code>DisplayObject</code></li>
		 *     <li>a Starling <code>DisplayObject</code> that is already instantiated</li>
		 * </ul>
		 *
		 * <p>If the screen is a <code>Class</code> or a <code>Function</code>,
		 * a new instance of the screen will be instantiated every time that it
		 * is shown by the <code>ScreenNavigator</code>. The screen's state
		 * will not be saved automatically. The screen's state may be saved in
		 * <code>properties</code>, if needed.</p>
		 *
		 * <p>If the screen is a <code>DisplayObject</code>, the same instance
		 * will be reused every time that it is shown by the
		 * <code>ScreenNavigator</code> When the screen is shown again, its
		 * state will remain the same as when it was previously hidden. However,
		 * the screen will also be kept in memory even when it isn't visible,
		 * limiting the resources that are available for other screens.</p>
		 *
		 * @default null
		 */
		public function get screen():Object
		{
			return this._screen;
		}

		/**
		 * @private
		 */
		public function set screen(value:Object):void
		{
			this._screen = value;
		}

		/**
		 * @private
		 */
		protected var _pushEvents:Object;

		/**
		 * A set of key-value pairs representing actions that should be
		 * triggered when events are dispatched by the screen when it is shown.
		 * A pair's key is the event type to listen for (or the property name of
		 * an <code>ISignal</code> instance), and a pair's value is one of two
		 * possible types. When this event is dispatched, and a pair's value
		 * is a <code>String</code>, the <code>StackScreenNavigator</code> will
		 * show another screen with an ID equal to the string value. When this
		 * event is dispatched, and the pair's value is a <code>Function</code>,
		 * the function will be called as if it were a listener for the event.
		 *
		 * @see #setFunctionForPushEvent()
		 * @see #setScreenIDForPushEvent()
		 */
		public function get pushEvents():Object
		{
			return this._pushEvents;
		}

		/**
		 * @private
		 */
		public function set pushEvents(value:Object):void
		{
			if(!value)
			{
				value = {};
			}
			this._pushEvents = value;
		}

		/**
		 * @private
		 */
		protected var _replaceEvents:Object;

		/**
		 * A set of key-value pairs representing actions that should be
		 * triggered when events are dispatched by the screen when it is shown.
		 * A pair's key is the event type to listen for (or the property name of
		 * an <code>ISignal</code> instance), and a pair's value is a
		 * <code>String</code> that is the ID of another screen that will
		 * replace the currently active screen.
		 *
		 * @see #setScreenIDForReplaceEvent()
		 */
		public function get replaceEvents():Object
		{
			return this._replaceEvents;
		}

		/**
		 * @private
		 */
		public function set replaceEvents(value:Object):void
		{
			if(!value)
			{
				value = {};
			}
			this._replaceEvents = value;
		}

		/**
		 * @private
		 */
		protected var _popEvents:Vector.<String>;

		/**
		 * A list of events that will cause the screen navigator to pop this
		 * screen off the top of the stack.
		 *
		 * @see #addPopEvent()
		 * @see #removePopEvent()
		 */
		public function get popEvents():Vector.<String>
		{
			return this._popEvents;
		}

		/**
		 * @private
		 */
		public function set popEvents(value:Vector.<String>):void
		{
			if(!value)
			{
				value = new <String>[];
			}
			this._popEvents = value;
		}

		/**
		 * @private
		 */
		protected var _popToRootEvents:Vector.<String>;

		/**
		 * A list of events that will cause the screen navigator to clear its
		 * stack and show the first screen added to the stack.
		 *
		 * @see #addPopToRootEvent()
		 * @see #removePopToRootEvent()
		 */
		public function get popToRootEvents():Vector.<String>
		{
			return this._popToRootEvents;
		}

		/**
		 * @private
		 */
		public function set popToRootEvents(value:Vector.<String>):void
		{
			this._popToRootEvents = value;
		}

		/**
		 * @private
		 */
		protected var _properties:Object;

		/**
		 * A set of key-value pairs representing properties to be set on the
		 * screen when it is shown. A pair's key is the name of the screen's
		 * property, and a pair's value is the value to be passed to the
		 * screen's property.
		 */
		public function get properties():Object
		{
			return this._properties;
		}

		/**
		 * @private
		 */
		public function set properties(value:Object):void
		{
			if(!value)
			{
				value = {};
			}
			this._properties = value;
		}

		/**
		 * @private
		 */
		protected var _pushTransition:Function;

		/**
		 * A custom push transition for this screen only. If <code>null</code>,
		 * the default <code>pushTransition</code> defined by the
		 * <code>StackScreenNavigator</code> will be used.
		 *
		 * <p>In the following example, the screen navigator item is given a
		 * push transition:</p>
		 *
		 * <listing version="3.0">
		 * item.pushTransition = Slide.createSlideLeftTransition();</listing>
		 *
		 * <p>A number of animated transitions may be found in the
		 * <a href="../motion/package-detail.html">feathers.motion</a> package.
		 * However, you are not limited to only these transitions. It's possible
		 * to create custom transitions too.</p>
		 *
		 * <p>A custom transition function should have the following signature:</p>
		 * <pre>function(oldScreen:DisplayObject, newScreen:DisplayObject, completeCallback:Function):void</pre>
		 *
		 * <p>Either of the <code>oldScreen</code> and <code>newScreen</code>
		 * arguments may be <code>null</code>, but never both. The
		 * <code>oldScreen</code> argument will be <code>null</code> when the
		 * first screen is displayed or when a new screen is displayed after
		 * clearing the screen. The <code>newScreen</code> argument will
		 * be null when clearing the screen.</p>
		 *
		 * <p>The <code>completeCallback</code> function <em>must</em> be called
		 * when the transition effect finishes. This callback indicate to the
		 * screen navigator that the transition has finished. This function has
		 * the following signature:</p>
		 *
		 * <pre>function(cancelTransition:Boolean = false):void</pre>
		 *
		 * <p>The first argument defaults to <code>false</code>, meaning that
		 * the transition completed successfully. In most cases, this callback
		 * may be called without arguments. If a transition is cancelled before
		 * completion (perhaps through some kind of user interaction), and the
		 * previous screen should be restored, pass <code>true</code> as the
		 * first argument to the callback to inform the screen navigator that
		 * the transition is cancelled.</p>
		 *
		 * @default null
		 *
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see ../../../help/transitions.html Transitions for Feathers screen navigators
		 */
		public function get pushTransition():Function
		{
			return this._pushTransition;
		}

		/**
		 * @private
		 */
		public function set pushTransition(value:Function):void
		{
			this._pushTransition = value;
		}

		/**
		 * @private
		 */
		protected var _popTransition:Function;

		/**
		 * A custom pop transition for this screen only. If <code>null</code>,
		 * the default <code>popTransition</code> defined by the
		 * <code>StackScreenNavigator</code> will be used.
		 *
		 * <p>In the following example, the screen navigator item is given a
		 * pop transition:</p>
		 *
		 * <listing version="3.0">
		 * item.popTransition = Slide.createSlideRightTransition();</listing>
		 *
		 * <p>A number of animated transitions may be found in the
		 * <a href="../motion/package-detail.html">feathers.motion</a> package.
		 * However, you are not limited to only these transitions. It's possible
		 * to create custom transitions too.</p>
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function(oldScreen:DisplayObject, newScreen:DisplayObject, completeCallback:Function):void</pre>
		 *
		 * <p>Either of the <code>oldScreen</code> and <code>newScreen</code>
		 * arguments may be <code>null</code>, but never both. The
		 * <code>oldScreen</code> argument will be <code>null</code> when the
		 * first screen is displayed or when a new screen is displayed after
		 * clearing the screen. The <code>newScreen</code> argument will
		 * be null when clearing the screen.</p>
		 *
		 * <p>The <code>completeCallback</code> function <em>must</em> be called
		 * when the transition effect finishes. This callback indicate to the
		 * screen navigator that the transition has finished. This function has
		 * the following signature:</p>
		 *
		 * <pre>function(cancelTransition:Boolean = false):void</pre>
		 *
		 * <p>The first argument defaults to <code>false</code>, meaning that
		 * the transition completed successfully. In most cases, this callback
		 * may be called without arguments. If a transition is cancelled before
		 * completion (perhaps through some kind of user interaction), and the
		 * previous screen should be restored, pass <code>true</code> as the
		 * first argument to the callback to inform the screen navigator that
		 * the transition is cancelled.</p>
		 *
		 * @default null
		 *
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see ../../../help/transitions.html Transitions for Feathers screen navigators
		 */
		public function get popTransition():Function
		{
			return this._popTransition;
		}

		/**
		 * @private
		 */
		public function set popTransition(value:Function):void
		{
			this._popTransition = value;
		}

		/**
		 * @inheritDoc
		 */
		public function get canDispose():Boolean
		{
			return !(this._screen is DisplayObject);
		}

		/**
		 * @private
		 */
		protected var _transitionDelayEvent:String = null;

		/**
		 * @inheritDoc
		 */
		public function get transitionDelayEvent():String
		{
			return this._transitionDelayEvent;
		}

		/**
		 * @private
		 */
		public function set transitionDelayEvent(value:String):void
		{
			this._transitionDelayEvent = value;
		}

		/**
		 * Specifies a function to call when an event is dispatched by the
		 * screen.
		 *
		 * <p>If the screen is currently being displayed by a
		 * <code>StackScreenNavigator</code>, and you call
		 * <code>setFunctionForPushEvent()</code> on the <code>StackScreenNavigatorItem</code>,
		 * the <code>StackScreenNavigator</code> won't listen for the event
		 * until the next time that the screen is shown.</p>
		 *
		 * @see #setScreenIDForPushEvent()
		 * @see #clearEvent()
		 * @see #events
		 */
		public function setFunctionForPushEvent(eventType:String, action:Function):void
		{
			this._pushEvents[eventType] = action;
		}

		/**
		 * Specifies another screen to push on the stack when an event is
		 * dispatched by this screen. The other screen should be specified by
		 * its ID that was registered with a call to <code>addScreen()</code> on
		 * the <code>StackScreenNavigator</code>.
		 *
		 * <p>If the screen is currently being displayed by a
		 * <code>StackScreenNavigator</code>, and you call
		 * <code>setScreenIDForPushEvent()</code> on the <code>StackScreenNavigatorItem</code>,
		 * the <code>StackScreenNavigator</code> won't listen for the event
		 * until the next time that the screen is shown.</p>
		 *
		 * @see #setFunctionForPushEvent()
		 * @see #clearPushEvent()
		 * @see #pushEvents
		 */
		public function setScreenIDForPushEvent(eventType:String, screenID:String):void
		{
			this._pushEvents[eventType] = screenID;
		}

		/**
		 * Cancels the "push" action previously registered to be triggered when
		 * the screen dispatches an event.
		 *
		 * @see #pushEvents
		 */
		public function clearPushEvent(eventType:String):void
		{
			delete this._pushEvents[eventType];
		}

		/**
		 * Specifies another screen to replace this screen on the top of the
		 * stack when an event is dispatched by this screen. The other screen
		 * should be specified by its ID that was registered with a call to
		 * <code>addScreen()</code> on the <code>StackScreenNavigator</code>.
		 *
		 * <p>If the screen is currently being displayed by a
		 * <code>StackScreenNavigator</code>, and you call
		 * <code>setScreenIDForPushEvent()</code> on the <code>StackScreenNavigatorItem</code>,
		 * the <code>StackScreenNavigator</code> won't listen for the event
		 * until the next time that the screen is shown.</p>
		 *
		 * @see #clearReplaceEvent()
		 * @see #replaceEvents
		 */
		public function setScreenIDForReplaceEvent(eventType:String, screenID:String):void
		{
			if(!this._replaceEvents)
			{
				this._replaceEvents = {};
			}
			this._replaceEvents[eventType] = screenID;
		}

		/**
		 * Cancels the "replace" action previously registered to be triggered
		 * when the screen dispatches an event.
		 *
		 * @see #replaceEvents
		 */
		public function clearReplaceEvent(eventType:String):void
		{
			if(!this._replaceEvents)
			{
				return;
			}
			delete this._replaceEvents[eventType];
		}

		/**
		 * Specifies an event dispatched by the screen that will cause the
		 * <code>StackScreenNavigator</code> to pop the screen off the top of
		 * the stack and return to the previous screen.
		 *
		 * <p>If the screen is currently being displayed by a
		 * <code>StackScreenNavigator</code>, and you call
		 * <code>addPopEvent()</code> on the <code>StackScreenNavigatorItem</code>,
		 * the <code>StackScreenNavigator</code> won't listen for the event
		 * until the next time that the screen is shown.</p>
		 *
		 * @see #removePopEvent()
		 * @see #popEvents
		 */
		public function addPopEvent(eventType:String):void
		{
			if(!this._popEvents)
			{
				this._popEvents = new <String>[];
			}
			var index:int = this._popEvents.indexOf(eventType);
			if(index >= 0)
			{
				return;
			}
			this._popEvents[this._popEvents.length] = eventType;
		}

		/**
		 * Removes an event that would cause the <code>StackScreenNavigator</code>
		 * to remove this screen from the top of the stack.
		 *
		 * <p>If the screen is currently being displayed by a
		 * <code>StackScreenNavigator</code>, and you call
		 * <code>removePopEvent()</code> on the <code>StackScreenNavigatorItem</code>,
		 * the <code>StackScreenNavigator</code> won't remove the listener for
		 * the event on the currently displayed screen. The event listener won't
		 * be added the next time that the screen is shown.</p>
		 *
		 * @see #addPopEvent()
		 * @see #popEvents
		 */
		public function removePopEvent(eventType:String):void
		{
			if(!this._popEvents)
			{
				return;
			}
			var index:int = this._popEvents.indexOf(eventType);
			if(index == -1)
			{
				return;
			}
			this._popEvents.removeAt(index);
		}

		/**
		 * Specifies an event dispatched by the screen that will cause the
		 * <code>StackScreenNavigator</code> to pop the screen off the top of
		 * the stack and return to the previous screen.
		 *
		 * <p>If the screen is currently being displayed by a
		 * <code>StackScreenNavigator</code>, and you call
		 * <code>addPopToRootEvent()</code> on the <code>StackScreenNavigatorItem</code>,
		 * the <code>StackScreenNavigator</code> won't listen for the event
		 * until the next time that the screen is shown.</p>
		 *
		 * @see #removePopToRootEvent()
		 * @see #popToRootEvents
		 */
		public function addPopToRootEvent(eventType:String):void
		{
			if(!this._popToRootEvents)
			{
				this._popToRootEvents = new <String>[];
			}
			var index:int = this._popToRootEvents.indexOf(eventType);
			if(index >= 0)
			{
				return;
			}
			this._popToRootEvents[this._popToRootEvents.length] = eventType;
		}

		/**
		 * Removes an event that would have cause the <code>StackScreenNavigator</code>
		 * to clear its stack to show the first screen added to the stack.
		 *
		 * <p>If the screen is currently being displayed by a
		 * <code>StackScreenNavigator</code>, and you call
		 * <code>removePopEvent()</code> on the <code>StackScreenNavigatorItem</code>,
		 * the <code>StackScreenNavigator</code> won't remove the listener for
		 * the event on the currently displayed screen. The event listener won't
		 * be added the next time that the screen is shown.</p>
		 *
		 * @see #addPopToRootEvent()
		 * @see #popToRootEvents
		 */
		public function removePopToRootEvent(eventType:String):void
		{
			if(!this._popToRootEvents)
			{
				return;
			}
			var index:int = this._popToRootEvents.indexOf(eventType);
			if(index == -1)
			{
				return;
			}
			this._popToRootEvents.removeAt(index);
		}

		/**
		 * @inheritDoc
		 */
		public function getScreen():DisplayObject
		{
			var screenInstance:DisplayObject;
			if(this._screen is Class)
			{
				var ScreenType:Class = Class(this._screen);
				screenInstance = new ScreenType();
			}
			else if(this._screen is Function)
			{
				screenInstance = DisplayObject((this._screen as Function)());
			}
			else
			{
				screenInstance = DisplayObject(this._screen);
			}
			if(!(screenInstance is DisplayObject))
			{
				throw new ArgumentError("StackScreenNavigatorItem \"getScreen()\" must return a Starling display object.");
			}
			if(this._properties)
			{
				for(var propertyName:String in this._properties)
				{
					screenInstance[propertyName] = this._properties[propertyName];
				}
			}

			return screenInstance;
		}
	}
}


================================================
FILE: source/feathers/controls/StepperButtonLayoutMode.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * Layout options for stepper controls.
	 *
	 * @see feathers.controls.NumericStepper
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class StepperButtonLayoutMode
	{
		/**
		 * The decrement button will be placed on the left side of the text
		 * input and the increment button will be placed on the right side of
		 * the text input.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const SPLIT_HORIZONTAL:String = "splitHorizontal";

		/**
		 * The decrement button will be placed below the text input and the
		 * increment button will be placed above the text input.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const SPLIT_VERTICAL:String = "splitVertical";

		/**
		 * Both the decrement and increment button will be placed on the right
		 * side of the text input. The increment button will be above the
		 * decrement button.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const RIGHT_SIDE_VERTICAL:String = "rightSideVertical";
	}
}


================================================
FILE: source/feathers/controls/TabBar.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IFocusDisplayObject;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.ITextBaselineControl;
	import feathers.core.IValidating;
	import feathers.core.PropertyProxy;
	import feathers.core.ToggleGroup;
	import feathers.data.IListCollection;
	import feathers.dragDrop.DragData;
	import feathers.dragDrop.DragDropManager;
	import feathers.dragDrop.IDragSource;
	import feathers.dragDrop.IDropTarget;
	import feathers.events.CollectionEventType;
	import feathers.events.DragDropEvent;
	import feathers.events.ExclusiveTouch;
	import feathers.events.FeathersEventType;
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.layout.ViewPortBounds;
	import feathers.skins.IStyleProvider;

	import flash.geom.Point;
	import flash.ui.Keyboard;
	import flash.utils.Dictionary;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.events.KeyboardEvent;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * A style name to add to the first tab in this tab bar. Typically used
	 * by a theme to provide different styles to the first tab.
	 *
	 * <p>In the following example, a custom first tab style name is
	 * provided to the tab bar:</p>
	 *
	 * <listing version="3.0">
	 * tabs.customFirstTabStyleName = "my-custom-first-tab";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( ToggleButton ).setFunctionForStyleName( "my-custom-first-tab", setCustomFirstTabStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #style:customTabStyleName
	 * @see #style:customLastTabStyleName
	 */
	[Style(name="customFirstTabStyleName",type="String")]

	/**
	 * A style name to add to the last tab in this tab bar. Typically used
	 * by a theme to provide different styles to the last tab.
	 *
	 * <p>In the following example, a custom last tab style name is provided
	 * to the tab bar:</p>
	 *
	 * <listing version="3.0">
	 * tabs.customLastTabStyleName = "my-custom-last-tab";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( ToggleButton ).setFunctionForStyleName( "my-custom-last-tab", setCustomLastTabStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #style:customTabStyleName
	 * @see #style:customFirstTabStyleName
	 */
	[Style(name="customLastTabStyleName",type="String")]

	/**
	 * A style name to add to all tabs in this tab bar. Typically used by a
	 * theme to provide different styles to different tab bars.
	 *
	 * <p>In the following example, a custom tab style name is provided to
	 * the tab bar:</p>
	 *
	 * <listing version="3.0">
	 * tabs.customTabStyleName = "my-custom-tab";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( ToggleButton ).setFunctionForStyleName( "my-custom-tab", setCustomTabStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_TAB
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #style:customFirstTabStyleName
	 * @see #style:customLastTabStyleName
	 */
	[Style(name="customTabStyleName",type="String")]

	/**
	 * The tab bar layout is either vertical or horizontal.
	 *
	 * <p>In the following example, the tab bar's direction is set to
	 * vertical:</p>
	 *
	 * <listing version="3.0">
	 * tabs.direction = Direction.VERTICAL;</listing>
	 *
	 * <p><strong>Note:</strong> The <code>Direction.NONE</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.Direction.HORIZONTAL
	 *
	 * @see feathers.layout.Direction#HORIZONTAL
	 * @see feathers.layout.Direction#VERTICAL
	 */
	[Style(name="direction",type="String")]

	/**
	 * If <code>true</code>, the tabs will be equally sized in the direction
	 * of the layout. In other words, if the tab bar is horizontal, each tab
	 * will have the same width, and if the tab bar is vertical, each tab
	 * will have the same height. If <code>false</code>, the tabs will be
	 * sized to their ideal dimensions.
	 *
	 * <p>The following example aligns the tabs to the middle without distributing them:</p>
	 *
	 * <listing version="3.0">
	 * tabs.direction = Direction.VERTICAL;
	 * tabs.verticalAlign = VerticalAlign.MIDDLE;
	 * tabs.distributeTabSizes = false;</listing>
	 *
	 * @default true
	 */
	[Style(name="distributeTabSizes",type="Boolean")]

	/**
	 * A skin to display when dragging one an item to indicate where it can be
	 * dropped.
	 *
	 * <p>In the following example, the tab bar's drop indicator is provided:</p>
	 *
	 * <listing version="3.0">
	 * tabs.dropIndicatorSkin = new Image( texture );</listing>
	 *
	 * @default null
	 */
	[Style(name="dropIndicatorSkin",type="starling.display.DisplayObject")]

	/**
	 * Space, in pixels, between the first two tabs. If <code>NaN</code>,
	 * the default <code>gap</code> property will be used.
	 *
	 * <p>The following example sets the gap between the first and second
	 * tab to a different value than the standard gap:</p>
	 *
	 * <listing version="3.0">
	 * tabs.firstGap = 30;
	 * tabs.gap = 20;</listing>
	 *
	 * @default NaN
	 *
	 * @see #style:gap
	 * @see #style:lastGap
	 */
	[Style(name="firstGap",type="Number")]

	/**
	 * Space, in pixels, between tabs.
	 *
	 * <p>In the following example, the tab bar's gap is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * tabs.gap = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:firstGap
	 * @see #style:lastGap
	 */
	[Style(name="gap",type="Number")]

	/**
	 * Determines how the tabs are horizontally aligned within the bounds
	 * of the tab bar (on the x-axis).
	 *
	 * <p>The following example aligns the tabs to the left:</p>
	 *
	 * <listing version="3.0">
	 * tabs.horizontalAlign = HorizontalAlign.LEFT;</listing>
	 *
	 * @default feathers.layout.HorizontalAlign.JUSTIFY
	 *
	 * @see feathers.layout.HorizontalAlign#LEFT
	 * @see feathers.layout.HorizontalAlign#CENTER
	 * @see feathers.layout.HorizontalAlign#RIGHT
	 * @see feathers.layout.HorizontalAlign#JUSTIFY
	 */
	[Style(name="horizontalAlign",type="String")]

	/**
	 * Space, in pixels, between the last two tabs. If <code>NaN</code>,
	 * the default <code>gap</code> property will be used.
	 *
	 * <p>The following example sets the gap between the last and next to last
	 * tab to a different value than the standard gap:</p>
	 *
	 * <listing version="3.0">
	 * tabs.lastGap = 30;
	 * tabs.gap = 20;</listing>
	 *
	 * @default NaN
	 *
	 * @see #style:gap
	 * @see #style:firstGap
	 */
	[Style(name="lastGap",type="Number")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the padding of all sides of the tab bar
	 * is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * tabs.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, between the tab bar's top edge and the
	 * tabs.
	 *
	 * <p>In the following example, the padding on the top edge of the
	 * tab bar is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * tabs.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the tab bar's right edge and
	 * the tabs.
	 *
	 * <p>In the following example, the padding on the right edge of the
	 * tab bar is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * tabs.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the tab bar's bottom edge and
	 * the tabs.
	 *
	 * <p>In the following example, the padding on the bottom edge of the
	 * tab bar is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * tabs.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the tab bar's left edge and the
	 * tabs.
	 *
	 * <p>In the following example, the padding on the left edge of the
	 * tab bar is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * tabs.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * The time, in seconds, of the animation that changes the position and
	 * size of the <code>selectionSkin</code> skin when the selected
	 * tab changes.
	 *
	 * <p>The following example customizes the duration to 500ms:</p>
	 *
	 * <listing version="3.0">
	 * tabs.selectionChangeDuration = 0.5;</listing>
	 *
	 * @default 0.25
	 *
	 * @see #style:selectionSkin
	 * @see #style:selectionChangeEase
	 */
	[Style(name="selectionChangeDuration",type="Number")]

	/**
	 * The easing function used for moving and resizing the
	 * <code>selectionSkin</code> when the selected tab changes.
	 *
	 * <p>In the following example, the ease of the animation that moves
	 * the <code>selectionSkin</code> is customized:</p>
	 *
	 * <listing version="3.0">
	 * tabs.selectionChangeEase = Transitions.EASE_IN_OUT;</listing>
	 *
	 * @default starling.animation.Transitions.EASE_OUT
	 *
	 * @see http://doc.starling-framework.org/core/starling/animation/Transitions.html starling.animation.Transitions
	 * @see #style:selectionSkin
	 * @see #style:selectionChangeDuration
	 */
	[Style(name="selectionChangeEase",type="Object")]

	/**
	 * A skin displayed over the selected tab. Its position is animated when
	 * the selection changes.
	 *
	 * <p>The following example passes the tab bar a selection skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image(texture)
	 * skin.scale9Grid = new Rectangle(1, 2, 4, 4);
	 * tabs.selectionSkin = skin;</listing>
	 *
	 * @default null
	 *
	 * @see #style:selectionChangeDuration
	 * @see #style:selectionChangeEase
	 */
	[Style(name="selectionSkin",type="starling.display.DisplayObject")]

	/**
	 * Determines how the tabs are vertically aligned within the bounds
	 * of the tab bar (on the y-axis).
	 *
	 * <p>The following example aligns the tabs to the top:</p>
	 *
	 * <listing version="3.0">
	 * tabs.verticalAlign = VerticalAlign.TOP;</listing>
	 *
	 * @default feathers.layout.VerticalAlign.JUSTIFY
	 *
	 * @see feathers.layout.VerticalAlign#TOP
	 * @see feathers.layout.VerticalAlign#MIDDLE
	 * @see feathers.layout.VerticalAlign#BOTTOM
	 * @see feathers.layout.VerticalAlign#JUSTIFY
	 */
	[Style(name="verticalAlign",type="String")]

	/**
	 * Dispatched when the selected tab changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #selectedItem
	 * @see #selectedIndex
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when one of the tabs is triggered. The <code>data</code>
	 * property of the event contains the item from the data provider that is
	 * associated with the tab that was triggered.
	 *
	 * <p>The following example listens to <code>Event.TRIGGERED</code> on the
	 * tab bar:</p>
	 *
	 * <listing version="3.0">
	 * tabs.dataProvider = new ArrayCollection(
	 * [
	 *     { label: "1" },
	 *     { label: "2" },
	 *     { label: "3" },
	 * ]);
	 * tabs.addEventListener( Event.TRIGGERED, function( event:Event, data:Object ):void
	 * {
	 *    trace( "The tab with label \"" + data.label + "\" was triggered." );
	 * }</listing>
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The item associated with the tab
	 *   that was triggered.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.TRIGGERED
	 */
	[Event(name="triggered",type="starling.events.Event")]

	/**
	 * A line of tabs (vertical or horizontal), where one may be selected at a
	 * time.
	 *
	 * <p>The following example sets the data provider, selects the second tab,
	 * and listens for when the selection changes:</p>
	 *
	 * <listing version="3.0">
	 * var tabs:TabBar = new TabBar();
	 * tabs.dataProvider = new ArrayCollection(
	 * [
	 *     { label: "One" },
	 *     { label: "Two" },
	 *     { label: "Three" },
	 * ]);
	 * tabs.selectedIndex = 1;
	 * tabs.addEventListener( Event.CHANGE, tabs_changeHandler );
	 * this.addChild( tabs );</listing>
	 *
	 * @see ../../../help/tab-bar.html How to use the Feathers TabBar component
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class TabBar extends FeathersControl implements IFocusDisplayObject, ITextBaselineControl, IDragSource, IDropTarget
	{
		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_TAB_FACTORY:String = "tabFactory";

		/**
		 * @private
		 */
		private static const DEFAULT_TAB_FIELDS:Vector.<String> = new <String>
		[
			"upIcon",
			"downIcon",
			"hoverIcon",
			"disabledIcon",
			"defaultSelectedIcon",
			"selectedUpIcon",
			"selectedDownIcon",
			"selectedHoverIcon",
			"selectedDisabledIcon",
			"name"
		];

		/**
		 * @private
		 */
		protected static const DEFAULT_DRAG_FORMAT:String = "feathers-tab-bar-item";

		/**
		 * The default value added to the <code>styleNameList</code> of the tabs.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_TAB:String = "feathers-tab-bar-tab";

		/**
		 * The default <code>IStyleProvider</code> for all <code>TabBar</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static function defaultTabFactory():ToggleButton
		{
			return new ToggleButton();
		}

		/**
		 * Constructor.
		 */
		public function TabBar()
		{
			super();
		}

		/**
		 * The value added to the <code>styleNameList</code> of the tabs. This
		 * variable is <code>protected</code> so that sub-classes can customize
		 * the tab style name in their constructors instead of using the default
		 * style name defined by <code>DEFAULT_CHILD_STYLE_NAME_TAB</code>.
		 *
		 * <p>To customize the tab style name without subclassing, see
		 * <code>customTabStyleName</code>.</p>
		 *
		 * @see #style:customTabStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var tabStyleName:String = DEFAULT_CHILD_STYLE_NAME_TAB;

		/**
		 * The value added to the <code>styleNameList</code> of the first tab.
		 * This variable is <code>protected</code> so that sub-classes can
		 * customize the first tab style name in their constructors instead of
		 * using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_TAB</code>.
		 *
		 * <p>To customize the first tab name without subclassing, see
		 * <code>customFirstTabStyleName</code>.</p>
		 *
		 * @see #style:customFirstTabStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var firstTabStyleName:String = DEFAULT_CHILD_STYLE_NAME_TAB;

		/**
		 * The value added to the <code>styleNameList</code> of the last tab.
		 * This variable is <code>protected</code> so that sub-classes can
		 * customize the last tab style name in their constructors instead of
		 * using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_TAB</code>.
		 *
		 * <p>To customize the last tab name without subclassing, see
		 * <code>customLastTabStyleName</code>.</p>
		 *
		 * @see #style:customLastTabStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var lastTabStyleName:String = DEFAULT_CHILD_STYLE_NAME_TAB;

		/**
		 * The toggle group.
		 */
		protected var toggleGroup:ToggleGroup;

		/**
		 * @private
		 */
		protected var activeFirstTab:ToggleButton;

		/**
		 * @private
		 */
		protected var inactiveFirstTab:ToggleButton;

		/**
		 * @private
		 */
		protected var activeLastTab:ToggleButton;

		/**
		 * @private
		 */
		protected var inactiveLastTab:ToggleButton;

		/**
		 * @private
		 */
		protected var _layoutItems:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * @private
		 */
		protected var activeTabs:Vector.<ToggleButton> = new <ToggleButton>[];

		/**
		 * @private
		 */
		protected var inactiveTabs:Vector.<ToggleButton> = new <ToggleButton>[];

		/**
		 * @private
		 */
		protected var _tabToItem:Dictionary = new Dictionary(true);

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return TabBar.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _dataProvider:IListCollection;

		/**
		 * The collection of data to be displayed with tabs. The default
		 * <em>tab initializer</em> interprets this data to customize the tabs
		 * with various fields available to buttons, including the following:
		 *
		 * <ul>
		 *     <li>label</li>
		 *     <li>defaultIcon</li>
		 *     <li>upIcon</li>
		 *     <li>downIcon</li>
		 *     <li>hoverIcon</li>
		 *     <li>disabledIcon</li>
		 *     <li>defaultSelectedIcon</li>
		 *     <li>selectedUpIcon</li>
		 *     <li>selectedDownIcon</li>
		 *     <li>selectedHoverIcon</li>
		 *     <li>selectedDisabledIcon</li>
		 *     <li>isEnabled</li>
		 *     <li>name</li>
		 * </ul>
		 *
		 * <p>The following example passes in a data provider:</p>
		 *
		 * <listing version="3.0">
		 * list.dataProvider = new ArrayCollection(
		 * [
		 *     { label: "General", defaultIcon: new Image( generalTexture ) },
		 *     { label: "Security", defaultIcon: new Image( securityTexture ) },
		 *     { label: "Advanced", defaultIcon: new Image( advancedTexture ) },
		 * ]);</listing>
		 *
		 * @default null
		 *
		 * @see #tabInitializer
		 * @see feathers.data.ArrayCollection
		 * @see feathers.data.VectorCollection
		 * @see feathers.data.XMLListCollection
		 */
		public function get dataProvider():IListCollection
		{
			return this._dataProvider;
		}

		/**
		 * @private
		 */
		public function set dataProvider(value:IListCollection):void
		{
			if(this._dataProvider == value)
			{
				return;
			}
			var oldSelectedIndex:int = this.selectedIndex;
			var oldSelectedItem:Object = this.selectedItem;
			if(this._dataProvider)
			{
				this._dataProvider.removeEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ALL, dataProvider_removeAllHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.FILTER_CHANGE, dataProvider_filterChangeHandler);
				this._dataProvider.removeEventListener(CollectionEventType.SORT_CHANGE, dataProvider_sortChangeHandler);
				this._dataProvider.removeEventListener(CollectionEventType.UPDATE_ITEM, dataProvider_updateItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.UPDATE_ALL, dataProvider_updateAllHandler);
				this._dataProvider.removeEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
			}
			this._dataProvider = value;
			if(this._dataProvider)
			{
				this._dataProvider.addEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ALL, dataProvider_removeAllHandler);
				this._dataProvider.addEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.FILTER_CHANGE, dataProvider_filterChangeHandler);
				this._dataProvider.addEventListener(CollectionEventType.SORT_CHANGE, dataProvider_sortChangeHandler);
				this._dataProvider.addEventListener(CollectionEventType.UPDATE_ITEM, dataProvider_updateItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.UPDATE_ALL, dataProvider_updateAllHandler);
				this._dataProvider.addEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
			}
			if(!this._dataProvider || this._dataProvider.length == 0)
			{
				this.selectedIndex = -1;
			}
			else
			{
				this.selectedIndex = 0;
			}
			//this ensures that Event.CHANGE will dispatch for selectedItem
			//changing, even if selectedIndex has not changed.
			if(this.selectedIndex == oldSelectedIndex && this.selectedItem != oldSelectedItem)
			{
				this.dispatchEventWith(Event.CHANGE);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var verticalLayout:VerticalLayout;

		/**
		 * @private
		 */
		protected var horizontalLayout:HorizontalLayout;

		/**
		 * @private
		 */
		protected var _viewPortBounds:ViewPortBounds = new ViewPortBounds();

		/**
		 * @private
		 */
		protected var _layoutResult:LayoutBoundsResult = new LayoutBoundsResult();

		/**
		 * @private
		 */
		protected var _direction:String = Direction.HORIZONTAL;

		[Inspectable(type="String",enumeration="horizontal,vertical")]
		/**
		 * @private
		 */
		public function get direction():String
		{
			return this._direction;
		}

		/**
		 * @private
		 */
		public function set direction(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._direction === value)
			{
				return;
			}
			this._direction = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.JUSTIFY;

		[Inspectable(type="String",enumeration="left,center,right,justify")]
		/**
		 * @private
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._horizontalAlign === value)
			{
				return;
			}
			this._horizontalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.JUSTIFY;

		[Inspectable(type="String",enumeration="top,middle,bottom,justify")]
		/**
		 * @private
		 */
		public function get verticalAlign():String
		{
			return this._verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._verticalAlign === value)
			{
				return;
			}
			this._verticalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _selectionSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get selectionSkin():DisplayObject
		{
			return this._selectionSkin;
		}

		/**
		 * @private
		 */
		public function set selectionSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._selectionSkin === value)
			{
				return;
			}
			if(this._selectionSkin !== null &&
				this._selectionSkin.parent === this)
			{
				this._selectionSkin.removeFromParent(false);
			}
			this._selectionSkin = value;
			if(this._selectionSkin !== null)
			{
				this._selectionSkin.touchable = false;
				this.addChild(this._selectionSkin);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _selectionChangeTween:Tween;

		/**
		 * @private
		 */
		protected var _selectionChangeDuration:Number = 0.25;

		/**
		 * @private
		 */
		public function get selectionChangeDuration():Number
		{
			return this._selectionChangeDuration;
		}

		/**
		 * @private
		 */
		public function set selectionChangeDuration(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._selectionChangeDuration = value;
		}

		/**
		 * @private
		 */
		protected var _selectionChangeEase:Object = Transitions.EASE_OUT;

		/**
		 * @private
		 */
		public function get selectionChangeEase():Object
		{
			return this._selectionChangeEase;
		}

		/**
		 * @private
		 */
		public function set selectionChangeEase(value:Object):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._selectionChangeEase = value;
		}

		/**
		 * @private
		 */
		protected var _distributeTabSizes:Boolean = true;

		/**
		 * @private
		 */
		public function get distributeTabSizes():Boolean
		{
			return this._distributeTabSizes;
		}

		/**
		 * @private
		 */
		public function set distributeTabSizes(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._distributeTabSizes === value)
			{
				return;
			}
			this._distributeTabSizes = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _gap:Number = 0;

		/**
		 * @private
		 */
		public function get gap():Number
		{
			return this._gap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._gap == value)
			{
				return;
			}
			this._gap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _firstGap:Number = NaN;

		/**
		 * @private
		 */
		public function get firstGap():Number
		{
			return this._firstGap;
		}

		/**
		 * @private
		 */
		public function set firstGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._firstGap == value)
			{
				return;
			}
			this._firstGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _lastGap:Number = NaN;

		/**
		 * @private
		 */
		public function get lastGap():Number
		{
			return this._lastGap;
		}

		/**
		 * @private
		 */
		public function set lastGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._lastGap == value)
			{
				return;
			}
			this._lastGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _tabFactory:Function = defaultTabFactory;

		/**
		 * Creates each tab. A tab must be an instance of
		 * <code>ToggleButton</code>. This factory can be used to change
		 * properties on the tabs when they are first created. For instance, if
		 * you are skinning Feathers components without a theme, you might use
		 * this factory to set skins and other styles on a tab.
		 *
		 * <p>Optionally, the first tab and the last tab may be different than
		 * the other tabs in the middle. Use the <code>firstTabFactory</code>
		 * and/or the <code>lastTabFactory</code> to customize one or both of
		 * these tabs.</p>
		 *
		 * <p>This function is expected to have the following signature:</p>
		 *
		 * <pre>function():ToggleButton</pre>
		 *
		 * <p>In the following example, a custom tab factory is passed to the
		 * tab bar:</p>
		 *
		 * <listing version="3.0">
		 * tabs.tabFactory = function():ToggleButton
		 * {
		 *     var tab:ToggleButton = new ToggleButton();
		 *     tab.defaultSkin = new Image( upTexture );
		 *     tab.defaultSelectedSkin = new Image( selectedTexture );
		 *     tab.downSkin = new Image( downTexture );
		 *     return tab;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.ToggleButton
		 * @see #firstTabFactory
		 * @see #lastTabFactory
		 */
		public function get tabFactory():Function
		{
			return this._tabFactory;
		}

		/**
		 * @private
		 */
		public function set tabFactory(value:Function):void
		{
			if(this._tabFactory == value)
			{
				return;
			}
			this._tabFactory = value;
			this.invalidate(INVALIDATION_FLAG_TAB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _firstTabFactory:Function;

		/**
		 * If not <code>null</code>, creates the first tab. If the
		 * <code>firstTabFactory</code> is <code>null</code>, then the tab bar
		 * will use the <code>tabFactory</code>. The first tab must be an
		 * instance of <code>ToggleButton</code>. This factory can be used to
		 * change properties on the first tab when it is initially created. For
		 * instance, if you are skinning Feathers components without a theme,
		 * you might use this factory to set skins and other styles on the first
		 * tab.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 *
		 * <pre>function():ToggleButton</pre>
		 *
		 * <p>In the following example, a custom first tab factory is passed to the
		 * tab bar:</p>
		 *
		 * <listing version="3.0">
		 * tabs.firstTabFactory = function():ToggleButton
		 * {
		 *     var tab:ToggleButton = new ToggleButton();
		 *     tab.defaultSkin = new Image( upTexture );
		 *     tab.defaultSelectedSkin = new Image( selectedTexture );
		 *     tab.downSkin = new Image( downTexture );
		 *     return tab;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.ToggleButton
		 * @see #tabFactory
		 * @see #lastTabFactory
		 */
		public function get firstTabFactory():Function
		{
			return this._firstTabFactory;
		}

		/**
		 * @private
		 */
		public function set firstTabFactory(value:Function):void
		{
			if(this._firstTabFactory == value)
			{
				return;
			}
			this._firstTabFactory = value;
			this.invalidate(INVALIDATION_FLAG_TAB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _lastTabFactory:Function;

		/**
		 * If not <code>null</code>, creates the last tab. If the
		 * <code>lastTabFactory</code> is <code>null</code>, then the tab bar
		 * will use the <code>tabFactory</code>. The last tab must be an
		 * instance of <code>ToggleButton</code>. This factory can be used to
		 * change properties on the last tab when it is initially created. For
		 * instance, if you are skinning Feathers components without a theme,
		 * you might use this factory to set skins and other styles on the last
		 * tab.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 *
		 * <pre>function():ToggleButton</pre>
		 *
		 * <p>In the following example, a custom last tab factory is passed to the
		 * tab bar:</p>
		 *
		 * <listing version="3.0">
		 * tabs.lastTabFactory = function():ToggleButton
		 * {
		 *     var tab:ToggleButton = new Button();
		 *     tab.defaultSkin = new Image( upTexture );
		 *     tab.defaultSelectedSkin = new Image( selectedTexture );
		 *     tab.downSkin = new Image( downTexture );
		 *     return tab;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.ToggleButton
		 * @see #tabFactory
		 * @see #firstTabFactory
		 */
		public function get lastTabFactory():Function
		{
			return this._lastTabFactory;
		}

		/**
		 * @private
		 */
		public function set lastTabFactory(value:Function):void
		{
			if(this._lastTabFactory == value)
			{
				return;
			}
			this._lastTabFactory = value;
			this.invalidate(INVALIDATION_FLAG_TAB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _tabInitializer:Function = defaultTabInitializer;

		/**
		 * Modifies the properties of an individual tab, using an item from the
		 * data provider. The default initializer will set the tab's label and
		 * icons. A custom tab initializer can be provided to update additional
		 * properties or to use different field names in the data provider.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 * <pre>function( tab:ToggleButton, item:Object ):void</pre>
		 *
		 * <p>In the following example, a custom tab initializer is passed to the
		 * tab bar:</p>
		 *
		 * <listing version="3.0">
		 * tabs.tabInitializer = function( tab:ToggleButton, item:Object ):void
		 * {
		 *     tab.label = item.text;
		 *     tab.defaultIcon = item.icon;
		 * };</listing>
		 *
		 * @see #dataProvider
		 * @see #tabReleaser
		 */
		public function get tabInitializer():Function
		{
			return this._tabInitializer;
		}

		/**
		 * @private
		 */
		public function set tabInitializer(value:Function):void
		{
			if(this._tabInitializer == value)
			{
				return;
			}
			this._tabInitializer = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _tabReleaser:Function = defaultTabReleaser;

		/**
		 * Resets the properties of an individual tab, using the item from the
		 * data provider that was associated with the tab.
		 *
		 * <p>This function is expected to have one of the following signatures:</p>
		 * <pre>function( tab:ToggleButton ):void</pre>
		 * <pre>function( tab:ToggleButton, oldItem:Object ):void</pre>
		 *
		 * <p>In the following example, a custom tab releaser is passed to the
		 * tab bar:</p>
		 *
		 * <listing version="3.0">
		 * tabs.tabReleaser = function( tab:ToggleButton, oldItem:Object ):void
		 * {
		 *     tab.label = null;
		 *     tab.defaultIcon = null;
		 * };</listing>
		 *
		 * @see #tabInitializer
		 */
		public function get tabReleaser():Function
		{
			return this._tabReleaser;
		}

		/**
		 * @private
		 */
		public function set tabReleaser(value:Function):void
		{
			if(this._tabReleaser == value)
			{
				return;
			}
			this._tabReleaser = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _labelField:String = "label";

		/**
		 * The field in the item that contains the label text to be displayed by
		 * the tabs. If the item does not have this field, and a
		 * <code>labelFunction</code> is not defined, then the tabs will
		 * default to calling <code>toString()</code> on the item.
		 *
		 * <p>All of the label fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>labelFunction</code></li>
		 *     <li><code>labelField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the label field is customized:</p>
		 *
		 * <listing version="3.0">
		 * tabs.labelField = "text";</listing>
		 *
		 * @default "label"
		 *
		 * @see #labelFunction
		 */
		public function get labelField():String
		{
			return this._labelField;
		}

		/**
		 * @private
		 */
		public function set labelField(value:String):void
		{
			if(this._labelField == value)
			{
				return;
			}
			this._labelField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _labelFunction:Function;

		/**
		 * A function used to generate label text for a specific tab. If this
		 * function is not <code>null</code>, then the <code>labelField</code>
		 * will be ignored.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):String</pre>
		 *
		 * <p>All of the label fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>labelFunction</code></li>
		 *     <li><code>labelField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the label function is customized:</p>
		 *
		 * <listing version="3.0">
		 * tabs.labelFunction = function( item:Object ):String
		 * {
		 *    return item.label + " (" + item.unread + ")";
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #labelField
		 */
		public function get labelFunction():Function
		{
			return this._labelFunction;
		}

		/**
		 * @private
		 */
		public function set labelFunction(value:Function):void
		{
			if(this._labelFunction == value)
			{
				return;
			}
			this._labelFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _enabledField:String = "isEnabled";

		/**
		 * The field in the item that determines if the tab is enabled. If the
		 * item does not have this field, and a <code>enabledFunction</code> is
		 * not defined, then the tab will default to being enabled, unless the
		 * tab bar is not enabled. All tabs will always be disabled if the tab
		 * bar is disabled.
		 *
		 * <p>All of the label fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>enabledFunction</code></li>
		 *     <li><code>enabledField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the enabled field is customized:</p>
		 *
		 * <listing version="3.0">
		 * tabs.enabledField = "isEnabled";</listing>
		 *
		 * @default "enabled"
		 *
		 * @see #enabledFunction
		 */
		public function get enabledField():String
		{
			return this._enabledField;
		}

		/**
		 * @private
		 */
		public function set enabledField(value:String):void
		{
			if(this._enabledField == value)
			{
				return;
			}
			this._enabledField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _iconField:String = "defaultIcon";
		//I'd like to use "icon" here instead, but defaultIcon is needed for
		//backwards compatibility...

		/**
		 * The field in the item that contains a display object to be displayed
		 * as an icon or other graphic next to the label in the tab.
		 *
		 * <p>Warning: It is your responsibility to dispose all icons
		 * included in the data provider and accessed with <code>iconField</code>,
		 * or any display objects returned by <code>iconFunction</code>.
		 * These display objects will not be disposed when the list is disposed.
		 * Not disposing an icon may result in a memory leak.</p>
		 *
		 * <p>All of the icon fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>iconFunction</code></li>
		 *     <li><code>iconField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the icon field is customized:</p>
		 *
		 * <listing version="3.0">
		 * tabs.iconField = "photo";</listing>
		 *
		 * @default "icon"
		 *
		 * @see #iconFunction
		 */
		public function get iconField():String
		{
			return this._iconField;
		}

		/**
		 * @private
		 */
		public function set iconField(value:String):void
		{
			if(this._iconField == value)
			{
				return;
			}
			this._iconField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _iconFunction:Function;

		/**
		 * A function used to generate an icon for a specific tab, based on its
		 * associated item in the data provider.
		 *
		 * <p>Note: This function may be called more than once for each
		 * individual item in the tab bar's data provider. The function should
		 * not simply return a new icon every time. This will result in the
		 * unnecessary creation and destruction of many icons, which will
		 * overwork the garbage collector, hurt performance, and possibly lead
		 * to memory leaks. It's better to return a new icon the first time this
		 * function is called for a particular item and then return the same
		 * icon if that item is passed to this function again.</p>
		 *
		 * <p>Warning: It is your responsibility to dispose all icons
		 * included in the data provider and accessed with <code>iconField</code>,
		 * or any display objects returned by <code>iconFunction</code>.
		 * These display objects will not be disposed when the list is disposed.
		 * Not disposing an icon may result in a memory leak.</p>
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):DisplayObject</pre>
		 *
		 * <p>All of the icon fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>iconFunction</code></li>
		 *     <li><code>iconField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the icon function is customized:</p>
		 *
		 * <listing version="3.0">
		 * var cachedIcons:Dictionary = new Dictionary( true );
		 * tabs.iconFunction = function( item:Object ):DisplayObject
		 * {
		 *    if(item in cachedIcons)
		 *    {
		 *        return cachedIcons[item];
		 *    }
		 *    var icon:Image = new Image( textureAtlas.getTexture( item.textureName ) );
		 *    cachedIcons[item] = icon;
		 *    return icon;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #iconField
		 */
		public function get iconFunction():Function
		{
			return this._iconFunction;
		}

		/**
		 * @private
		 */
		public function set iconFunction(value:Function):void
		{
			if(this._iconFunction == value)
			{
				return;
			}
			this._iconFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _enabledFunction:Function;

		/**
		 * A function used to determine if a specific tab is enabled. If this
		 * function is not <code>null</code>, then the <code>enabledField</code>
		 * will be ignored.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):Boolean</pre>
		 *
		 * <p>All of the enabled fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>enabledFunction</code></li>
		 *     <li><code>enabledField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the enabled function is customized:</p>
		 *
		 * <listing version="3.0">
		 * tabs.enabledFunction = function( item:Object ):Boolean
		 * {
		 *    return item.isEnabled;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #enabledField
		 */
		public function get enabledFunction():Function
		{
			return this._enabledFunction;
		}

		/**
		 * @private
		 */
		public function set enabledFunction(value:Function):void
		{
			if(this._enabledFunction == value)
			{
				return;
			}
			this._enabledFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _ignoreSelectionChanges:Boolean = false;

		/**
		 * @private
		 */
		protected var _selectedIndex:int = -1;

		/**
		 * The index of the currently selected tab. Returns -1 if no tab is
		 * selected.
		 *
		 * <p>In the following example, the tab bar's selected index is changed:</p>
		 *
		 * <listing version="3.0">
		 * tabs.selectedIndex = 2;</listing>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected index:</p>
		 *
		 * <listing version="3.0">
		 * function tabs_changeHandler( event:Event ):void
		 * {
		 *     var tabs:TabBar = TabBar( event.currentTarget );
		 *     var index:int = tabs.selectedIndex;
		 * 
		 * }
		 * tabs.addEventListener( Event.CHANGE, tabs_changeHandler );</listing>
		 *
		 * @default -1
		 *
		 * @see #selectedItem
		 */
		public function get selectedIndex():int
		{
			return this._selectedIndex;
		}

		/**
		 * @private
		 */
		public function set selectedIndex(value:int):void
		{
			this._animateSelectionChange = false;
			if(this._selectedIndex == value)
			{
				return;
			}
			this._selectedIndex = value;
			this.refreshSelectedItem();
			this.invalidate(INVALIDATION_FLAG_SELECTED);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _selectedItem:Object = null;

		/**
		 * The currently selected item from the data provider. Returns
		 * <code>null</code> if no item is selected.
		 *
		 * <p>In the following example, the tab bar's selected item is changed:</p>
		 *
		 * <listing version="3.0">
		 * tabs.selectedItem = tabs.dataProvider.getItemAt(2);</listing>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected item:</p>
		 *
		 * <listing version="3.0">
		 * function tabs_changeHandler( event:Event ):void
		 * {
		 *     var tabs:TabBar = TabBar( event.currentTarget );
		 *     var item:Object = tabs.selectedItem;
		 * 
		 * }
		 * tabs.addEventListener( Event.CHANGE, tabs_changeHandler );</listing>
		 *
		 * @default null
		 *
		 * @see #selectedIndex
		 */
		public function get selectedItem():Object
		{
			return this._selectedItem;
		}

		/**
		 * @private
		 */
		public function set selectedItem(value:Object):void
		{
			if(this._selectedItem === value)
			{
				return;
			}
			//we don't need to set _animateSelectionChange to false because we
			//always call the selectedIndex setter below, which sets it;
			if(this._dataProvider === null)
			{
				this.selectedIndex = -1;
				return;
			}
			var newIndex:int = this._dataProvider.getItemIndex(value);
			if(newIndex == -1)
			{
				this.selectedIndex = -1;
			}
			else if(this._selectedIndex != newIndex)
			{
				this.selectedIndex = newIndex;
			}
			else
			{
				//it's possible for the item to change, but not the index
				this._animateSelectionChange = false;
				this._selectedItem = value;
				this.invalidate(INVALIDATION_FLAG_SELECTED);
				this.dispatchEventWith(Event.CHANGE);
			}
		}

		/**
		 * @private
		 */
		protected var _customTabStyleName:String;

		/**
		 * @private
		 */
		public function get customTabStyleName():String
		{
			return this._customTabStyleName;
		}

		/**
		 * @private
		 */
		public function set customTabStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customTabStyleName === value)
			{
				return;
			}
			this._customTabStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TAB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customFirstTabStyleName:String;

		/**
		 * @private
		 */
		public function get customFirstTabStyleName():String
		{
			return this._customFirstTabStyleName;
		}

		/**
		 * @private
		 */
		public function set customFirstTabStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customFirstTabStyleName === value)
			{
				return;
			}
			this._customFirstTabStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TAB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customLastTabStyleName:String;

		/**
		 * @private
		 */
		public function get customLastTabStyleName():String
		{
			return this._customLastTabStyleName;
		}

		/**
		 * @private
		 */
		public function set customLastTabStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customLastTabStyleName === value)
			{
				return;
			}
			this._customLastTabStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TAB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _tabProperties:PropertyProxy;

		/**
		 * An object that stores properties for all of the tab bar's tabs, and
		 * the properties will be passed down to every tab when the tab bar
		 * validates. For a list of available properties, refer to
		 * <a href="ToggleButton.html"><code>feathers.controls.ToggleButton</code></a>.
		 *
		 * <p>These properties are shared by every tab, so anything that cannot
		 * be shared (such as display objects, which cannot be added to multiple
		 * parents) should be passed to tabs using the <code>tabFactory</code>
		 * or in the theme.</p>
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>tabFactory</code> function instead
		 * of using <code>tabProperties</code> will result in better
		 * performance.</p>
		 *
		 * <p>In the following example, the tab bar's tab properties are updated:</p>
		 *
		 * <listing version="3.0">
		 * tabs.tabProperties.iconPosition = RelativePosition.RIGHT;</listing>
		 *
		 * @default null
		 *
		 * @see #tabFactory
		 * @see feathers.controls.ToggleButton
		 */
		public function get tabProperties():Object
		{
			if(!this._tabProperties)
			{
				this._tabProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._tabProperties;
		}

		/**
		 * @private
		 */
		public function set tabProperties(value:Object):void
		{
			if(this._tabProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._tabProperties)
			{
				this._tabProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._tabProperties = PropertyProxy(value);
			if(this._tabProperties)
			{
				this._tabProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @inheritDoc
		 */
		public function get baseline():Number
		{
			if(!this.activeTabs || this.activeTabs.length == 0)
			{
				return this.scaledActualHeight;
			}
			var firstTab:ToggleButton = this.activeTabs[0];
			return this.scaleY * (firstTab.y + firstTab.baseline);
		}

		/**
		 * @private
		 */
		protected var _animateSelectionChange:Boolean = false;

		/**
		 * @private
		 */
		protected var _dragFormat:String = DEFAULT_DRAG_FORMAT;

		/**
		 * Drag and drop is restricted to components that have the same
		 * <code>dragFormat</code>.
		 *
		 * <p>In the following example, the drag format of two tab bars is customized:</p>
		 *
		 * <listing version="3.0">
		 * tabs1.dragFormat = "my-custom-format";
		 * tabs2.dragFormat = "my-custom-format";</listing>
		 *
		 * @default "feathers-tab-bar-item"
		 */
		public function get dragFormat():String
		{
			return this._dragFormat;
		}

		/**
		 * @private
		 */
		public function set dragFormat(value:String):void
		{
			if(!value)
			{
				value = DEFAULT_DRAG_FORMAT;
			}
			if(this._dragFormat == value)
			{
				return;
			}
			this._dragFormat = value;
		}

		/**
		 * @private
		 */
		protected var _dragTouchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _droppedOnSelf:Boolean = false;

		/**
		 * @private
		 */
		protected var _dragEnabled:Boolean = false;

		/**
		 * Indicates if this tab bar can initiate drag and drop operations by
		 * touching an item and dragging it. The <code>dragEnabled</code>
		 * property enables dragging items, but dropping items must be enabled
		 * separately with the <code>dropEnabled</code> property.
		 *
		 * <p>In the following example, a tab bar's items may be dragged:</p>
		 *
		 * <listing version="3.0">
		 * tabs.dragEnabled = true;</listing>
		 *
		 * @see #dropEnabled
		 * @see #dragFormat
		 */
		public function get dragEnabled():Boolean
		{
			return this._dragEnabled;
		}

		/**
		 * @private
		 */
		public function set dragEnabled(value:Boolean):void
		{
			if(this._dragEnabled == value)
			{
				return;
			}
			this._dragEnabled = value;
			if(this._dragEnabled)
			{
				this.addEventListener(DragDropEvent.DRAG_COMPLETE, dragCompleteHandler);
			}
			else
			{
				this.removeEventListener(DragDropEvent.DRAG_COMPLETE, dragCompleteHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _dropEnabled:Boolean = false;

		/**
		 * Indicates if this tab bar can accept items that are dragged and
		 * dropped over the tab bar's hit area.
		 *
		 * <p>In the following example, a tab bar's items may be dropped:</p>
		 *
		 * <listing version="3.0">
		 * tabs.dropEnabled = true;</listing>
		 *
		 * @see #dragEnabled
		 * @see #dragFormat
		 */
		public function get dropEnabled():Boolean
		{
			return this._dropEnabled;
		}

		/**
		 * @private
		 */
		public function set dropEnabled(value:Boolean):void
		{
			if(this._dropEnabled == value)
			{
				return;
			}
			this._dropEnabled = value;
			if(this._dropEnabled)
			{
				this.addEventListener(DragDropEvent.DRAG_ENTER, dragEnterHandler);
				this.addEventListener(DragDropEvent.DRAG_MOVE, dragMoveHandler);
				this.addEventListener(DragDropEvent.DRAG_EXIT, dragExitHandler);
				this.addEventListener(DragDropEvent.DRAG_DROP, dragDropHandler);
			}
			else
			{
				this.removeEventListener(DragDropEvent.DRAG_ENTER, dragEnterHandler);
				this.removeEventListener(DragDropEvent.DRAG_MOVE, dragMoveHandler);
				this.removeEventListener(DragDropEvent.DRAG_EXIT, dragExitHandler);
				this.removeEventListener(DragDropEvent.DRAG_DROP, dragDropHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _explicitDropIndicatorWidth:Number = NaN;

		/**
		 * @private
		 */
		protected var _explicitDropIndicatorHeight:Number = NaN;

		/**
		 * @private
		 */
		protected var _dropIndicatorSkin:DisplayObject = null;

		/**
		 * @private
		 */
		public function get dropIndicatorSkin():DisplayObject
		{
			return this._dropIndicatorSkin;
		}

		/**
		 * @private
		 */
		public function set dropIndicatorSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			this._dropIndicatorSkin = value;
			if(this._dropIndicatorSkin is IMeasureDisplayObject)
			{
				var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this._dropIndicatorSkin);
				this._explicitDropIndicatorWidth = measureSkin.explicitWidth;
				this._explicitDropIndicatorHeight = measureSkin.explicitHeight;
			}
			else if(this._dropIndicatorSkin)
			{
				this._explicitDropIndicatorWidth = this._dropIndicatorSkin.width;
				this._explicitDropIndicatorHeight = this._dropIndicatorSkin.height;
			}
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this._dropIndicatorSkin !== null &&
				this._dropIndicatorSkin.parent === null)
			{
				this._dropIndicatorSkin.dispose();
				this._dropIndicatorSkin = null;
			}

			//clearing selection now so that the data provider setter won't
			//cause a selection change that triggers events.
			this._selectedIndex = -1;
			//this flag also ensures that removing items from the ToggleGroup
			//won't result in selection events
			this._ignoreSelectionChanges = true;

			//the tabs may contain things that shouldn't be disposed, so clean
			//them up before super.dispose()
			var tabCount:int = this.activeTabs.length;
			for(var i:int = 0; i < tabCount; i++)
			{
				var tab:ToggleButton = this.activeTabs.shift();
				this.destroyTab(tab);
			}

			//ensures that listeners are removed to avoid memory leaks
			this.dataProvider = null;

			super.dispose();
		}

		/**
		 * Changes the <code>selectedIndex</code> property, but animates the
		 * <code>selectionSkin</code> to the new position, as if the user
		 * triggered a tab.
		 *
		 * @see #selectedIndex
		 */
		public function setSelectedIndexWithAnimation(selectedIndex:int):void
		{
			if(this._selectedIndex == selectedIndex)
			{
				return;
			}
			this._selectedIndex = selectedIndex;
			this.refreshSelectedItem();
			//set this flag before dispatching the event because the TabBar
			//might be forced to validate in an event listener
			this._animateSelectionChange = true;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * Changes the <code>selectedItem</code> property, but animates the
		 * <code>selectionSkin</code> to the new position, as if the user
		 * triggered a tab.
		 *
		 * @see #selectedItem
		 * @see #selectedIndex
		 * @see #setSelectedIndexWithAnimation()
		 */
		public function setSelectedItemWithAnimation(selectedItem:Object):void
		{
			if(this.selectedItem == selectedItem)
			{
				return;
			}
			var selectedIndex:int = -1;
			if(this._dataProvider !== null)
			{
				selectedIndex = this._dataProvider.getItemIndex(selectedItem);
			}
			this.setSelectedIndexWithAnimation(selectedIndex);
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this.toggleGroup = new ToggleGroup();
			this.toggleGroup.isSelectionRequired = true;
			this.toggleGroup.addEventListener(Event.CHANGE, toggleGroup_changeHandler);
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var selectionInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SELECTED);
			var tabFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_TAB_FACTORY);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);

			if(dataInvalid || tabFactoryInvalid || stateInvalid)
			{
				this.refreshTabs(tabFactoryInvalid);
			}

			if(dataInvalid || tabFactoryInvalid || stylesInvalid)
			{
				this.refreshTabStyles();
			}

			if(dataInvalid || tabFactoryInvalid || selectionInvalid)
			{
				this.commitSelection();
			}

			if(dataInvalid || tabFactoryInvalid || stateInvalid)
			{
				this.commitEnabled();
			}

			if(stylesInvalid)
			{
				this.refreshLayoutStyles();
			}

			this.layoutTabs();
		}

		/**
		 * @private
		 */
		protected function commitSelection():void
		{
			this.toggleGroup.selectedIndex = this._selectedIndex;
		}

		/**
		 * @private
		 */
		protected function commitEnabled():void
		{
			for each(var tab:ToggleButton in this.activeTabs)
			{
				tab.isEnabled &&= this._isEnabled;
			}
		}

		/**
		 * @private
		 */
		protected function refreshTabStyles():void
		{
			for(var propertyName:String in this._tabProperties)
			{
				var propertyValue:Object = this._tabProperties[propertyName];
				for each(var tab:ToggleButton in this.activeTabs)
				{
					tab[propertyName] = propertyValue;
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshLayoutStyles():void
		{
			if(this._direction == Direction.VERTICAL)
			{
				if(this.horizontalLayout)
				{
					this.horizontalLayout = null;
				}
				if(!this.verticalLayout)
				{
					this.verticalLayout = new VerticalLayout();
					this.verticalLayout.useVirtualLayout = false;
				}
				this.verticalLayout.distributeHeights = this._distributeTabSizes;
				this.verticalLayout.horizontalAlign = this._horizontalAlign;
				this.verticalLayout.verticalAlign = (this._verticalAlign == VerticalAlign.JUSTIFY) ? VerticalAlign.TOP : this._verticalAlign;
				this.verticalLayout.gap = this._gap;
				this.verticalLayout.firstGap = this._firstGap;
				this.verticalLayout.lastGap = this._lastGap;
				this.verticalLayout.paddingTop = this._paddingTop;
				this.verticalLayout.paddingRight = this._paddingRight;
				this.verticalLayout.paddingBottom = this._paddingBottom;
				this.verticalLayout.paddingLeft = this._paddingLeft;
			}
			else //horizontal
			{
				if(this.verticalLayout)
				{
					this.verticalLayout = null;
				}
				if(!this.horizontalLayout)
				{
					this.horizontalLayout = new HorizontalLayout();
					this.horizontalLayout.useVirtualLayout = false;
				}
				this.horizontalLayout.distributeWidths = this._distributeTabSizes;
				this.horizontalLayout.horizontalAlign = (this._horizontalAlign == HorizontalAlign.JUSTIFY) ? HorizontalAlign.LEFT : this._horizontalAlign;
				this.horizontalLayout.verticalAlign = this._verticalAlign;
				this.horizontalLayout.gap = this._gap;
				this.horizontalLayout.firstGap = this._firstGap;
				this.horizontalLayout.lastGap = this._lastGap;
				this.horizontalLayout.paddingTop = this._paddingTop;
				this.horizontalLayout.paddingRight = this._paddingRight;
				this.horizontalLayout.paddingBottom = this._paddingBottom;
				this.horizontalLayout.paddingLeft = this._paddingLeft;
			}
		}

		/**
		 * @private
		 */
		protected function commitTabData(tab:ToggleButton, item:Object):void
		{
			if(item !== null)
			{
				if(this._labelFunction !== null)
				{
					tab.label = this._labelFunction(item);
				}
				else if(this._labelField !== null && item !== null && this._labelField in item)
				{
					tab.label = item[this._labelField];
				}
				else if(item is String)
				{
					tab.label = item as String;
				}
				else
				{
					tab.label = item.toString();
				}
				if(this._iconFunction !== null)
				{
					tab.defaultIcon = this._iconFunction(item);
				}
				else if(this._iconField !== null && item !== null && this._iconField in item)
				{
					tab.defaultIcon = item[this._iconField] as DisplayObject;
				}
				if(this._enabledFunction !== null)
				{
					//we account for this._isEnabled later
					tab.isEnabled = this._enabledFunction(item);
				}
				else if(this._enabledField !== null && item !== null && this._enabledField in item)
				{
					//we account for this._isEnabled later
					tab.isEnabled = item[this._enabledField] as Boolean;
				}
				else
				{
					tab.isEnabled = this._isEnabled;
				}
				if(this._tabInitializer !== null)
				{
					this._tabInitializer(tab, item);
				}
			}
			else
			{
				tab.label = "";
				tab.isEnabled = this._isEnabled;
			}
		}

		/**
		 * @private
		 */
		protected function defaultTabInitializer(tab:ToggleButton, item:Object):void
		{
			if(item !== null)
			{
				for each(var field:String in DEFAULT_TAB_FIELDS)
				{
					if(item.hasOwnProperty(field))
					{
						tab[field] = item[field];
					}
				}
			}
		}

		/**
		 * @private
		 */
		protected function defaultTabReleaser(tab:ToggleButton, oldItem:Object):void
		{
			for each(var field:String in DEFAULT_TAB_FIELDS)
			{
				if(oldItem.hasOwnProperty(field))
				{
					tab[field] = null;
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshTabs(isFactoryInvalid:Boolean):void
		{
			var oldIgnoreSelectionChanges:Boolean = this._ignoreSelectionChanges;
			this._ignoreSelectionChanges = true;
			var oldSelectedIndex:int = this.toggleGroup.selectedIndex;
			this.toggleGroup.removeAllItems();
			var temp:Vector.<ToggleButton> = this.inactiveTabs;
			this.inactiveTabs = this.activeTabs;
			this.activeTabs = temp;
			this.activeTabs.length = 0;
			this._layoutItems.length = 0;
			temp = null;
			if(isFactoryInvalid)
			{
				this.clearInactiveTabs();
			}
			else
			{
				if(this.activeFirstTab)
				{
					this.inactiveTabs.shift();
				}
				this.inactiveFirstTab = this.activeFirstTab;

				if(this.activeLastTab)
				{
					this.inactiveTabs.pop();
				}
				this.inactiveLastTab = this.activeLastTab;
			}
			this.activeFirstTab = null;
			this.activeLastTab = null;

			var pushIndex:int = 0;
			var itemCount:int = this._dataProvider ? this._dataProvider.length : 0;
			var lastItemIndex:int = itemCount - 1;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = this._dataProvider.getItemAt(i);
				if(i == 0)
				{
					var tab:ToggleButton = this.activeFirstTab = this.createFirstTab(item);
				}
				else if(i == lastItemIndex)
				{
					tab = this.activeLastTab = this.createLastTab(item);
				}
				else
				{
					tab = this.createTab(item);
				}
				this.toggleGroup.addItem(tab);
				this.activeTabs[pushIndex] = tab;
				this._layoutItems[pushIndex] = tab;
				pushIndex++;
			}

			this.clearInactiveTabs();
			this._ignoreSelectionChanges = oldIgnoreSelectionChanges;
			if(oldSelectedIndex >= 0)
			{
				var newSelectedIndex:int = this.activeTabs.length - 1;
				if(oldSelectedIndex < newSelectedIndex)
				{
					newSelectedIndex = oldSelectedIndex;
				}
				//removing all items from the ToggleGroup clears the selection,
				//so we need to set it back to the old value (or a new clamped
				//value). we want the change event to dispatch only if the old
				//value and the new value don't match.
				this._ignoreSelectionChanges = oldSelectedIndex == newSelectedIndex;
				this.toggleGroup.selectedIndex = newSelectedIndex;
				this._ignoreSelectionChanges = oldIgnoreSelectionChanges;
			}
		}

		/**
		 * @private
		 */
		protected function clearInactiveTabs():void
		{
			var itemCount:int = this.inactiveTabs.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var tab:ToggleButton = this.inactiveTabs.shift();
				this.destroyTab(tab);
			}

			if(this.inactiveFirstTab)
			{
				this.destroyTab(this.inactiveFirstTab);
				this.inactiveFirstTab = null;
			}

			if(this.inactiveLastTab)
			{
				this.destroyTab(this.inactiveLastTab);
				this.inactiveLastTab = null;
			}
		}

		/**
		 * @private
		 */
		protected function createFirstTab(item:Object):ToggleButton
		{
			var isNewInstance:Boolean = false;
			if(this.inactiveFirstTab !== null)
			{
				var tab:ToggleButton = this.inactiveFirstTab;
				this.releaseTab(tab);
				this.inactiveFirstTab = null;
			}
			else
			{
				isNewInstance = true;
				var factory:Function = this._firstTabFactory != null ? this._firstTabFactory : this._tabFactory;
				tab = ToggleButton(factory());
				if(this._customFirstTabStyleName)
				{
					tab.styleNameList.add(this._customFirstTabStyleName);
				}
				else if(this._customTabStyleName)
				{
					tab.styleNameList.add(this._customTabStyleName);
				}
				else
				{
					tab.styleNameList.add(this.firstTabStyleName);
				}
				tab.isToggle = true;
				this.addChild(tab);
			}
			this.commitTabData(tab, item);
			this._tabToItem[tab] = item;
			if(isNewInstance)
			{
				//we need to listen for events after the initializer
				//is called to avoid runtime errors because the tab may be
				//disposed by the time listeners in the initializer are called.
				this.addTabListeners(tab);
			}
			return tab;
		}

		/**
		 * @private
		 */
		protected function createLastTab(item:Object):ToggleButton
		{
			var isNewInstance:Boolean = false;
			if(this.inactiveLastTab !== null)
			{
				var tab:ToggleButton = this.inactiveLastTab;
				this.releaseTab(tab);
				this.inactiveLastTab = null;
			}
			else
			{
				isNewInstance = true;
				var factory:Function = this._lastTabFactory != null ? this._lastTabFactory : this._tabFactory;
				tab = ToggleButton(factory());
				if(this._customLastTabStyleName)
				{
					tab.styleNameList.add(this._customLastTabStyleName);
				}
				else if(this._customTabStyleName)
				{
					tab.styleNameList.add(this._customTabStyleName);
				}
				else
				{
					tab.styleNameList.add(this.lastTabStyleName);
				}
				tab.isToggle = true;
				this.addChild(tab);
			}
			this.commitTabData(tab, item);
			this._tabToItem[tab] = item;
			if(isNewInstance)
			{
				//we need to listen for events after the initializer
				//is called to avoid runtime errors because the tab may be
				//disposed by the time listeners in the initializer are called.
				this.addTabListeners(tab);
			}
			return tab;
		}

		/**
		 * @private
		 */
		protected function createTab(item:Object):ToggleButton
		{
			var isNewInstance:Boolean = false;
			if(this.inactiveTabs.length == 0)
			{
				isNewInstance = true;
				var tab:ToggleButton = ToggleButton(this._tabFactory());
				if(this._customTabStyleName)
				{
					tab.styleNameList.add(this._customTabStyleName);
				}
				else
				{
					tab.styleNameList.add(this.tabStyleName);
				}
				tab.isToggle = true;
				this.addChild(tab);
			}
			else
			{
				tab = this.inactiveTabs.shift();
				this.releaseTab(tab);
			}
			this.commitTabData(tab, item);
			this._tabToItem[tab] = item;
			if(isNewInstance)
			{
				//we need to listen for events after the initializer
				//is called to avoid runtime errors because the tab may be
				//disposed by the time listeners in the initializer are called.
				this.addTabListeners(tab);
			}
			return tab;
		}

		protected function addTabListeners(tab:ToggleButton):void
		{
			tab.addEventListener(Event.TRIGGERED, tab_triggeredHandler);
			tab.addEventListener(TouchEvent.TOUCH, tab_drag_touchHandler);
		}

		/**
		 * @private
		 */
		protected function releaseTab(tab:ToggleButton):void
		{
			var item:Object = this._tabToItem[tab];
			delete this._tabToItem[tab];
			if(this._labelFunction !== null || this._labelField in item)
			{
				tab.label = null;
			}
			if(this._iconFunction !== null || this._iconField in item)
			{
				tab.defaultIcon = null;
			}
			if(this._tabReleaser !== null)
			{
				if(this._tabReleaser.length == 1)
				{
					this._tabReleaser(tab);
				}
				else
				{
					this._tabReleaser(tab, item);
				}
			}
		}

		/**
		 * @private
		 */
		protected function destroyTab(tab:ToggleButton):void
		{
			this.toggleGroup.removeItem(tab);
			this.releaseTab(tab);
			tab.removeEventListener(Event.TRIGGERED, tab_triggeredHandler);
			tab.removeEventListener(TouchEvent.TOUCH, tab_drag_touchHandler);
			this.removeChild(tab, true);
		}

		/**
		 * @private
		 */
		protected function layoutTabs():void
		{
			this._viewPortBounds.x = 0;
			this._viewPortBounds.y = 0;
			this._viewPortBounds.scrollX = 0;
			this._viewPortBounds.scrollY = 0;
			this._viewPortBounds.explicitWidth = this._explicitWidth;
			this._viewPortBounds.explicitHeight = this._explicitHeight;
			this._viewPortBounds.minWidth = this._explicitMinWidth;
			this._viewPortBounds.minHeight = this._explicitMinHeight;
			this._viewPortBounds.maxWidth = this._explicitMaxWidth;
			this._viewPortBounds.maxHeight = this._explicitMaxHeight;
			if(this.verticalLayout)
			{
				this.verticalLayout.layout(this._layoutItems, this._viewPortBounds, this._layoutResult);
			}
			else if(this.horizontalLayout)
			{
				this.horizontalLayout.layout(this._layoutItems, this._viewPortBounds, this._layoutResult);
			}

			var contentWidth:Number = this._layoutResult.contentWidth;
			var contentHeight:Number = this._layoutResult.contentHeight;
			//minimum dimensions are the same as the measured dimensions
			this.saveMeasurements(contentWidth, contentHeight, contentWidth, contentHeight);

			//final validation to avoid juggler next frame issues
			for each(var tab:ToggleButton in this.activeTabs)
			{
				tab.validate();
			}
			if(this._selectionSkin !== null)
			{
				//always on top
				this.setChildIndex(this._selectionSkin, this.numChildren - 1);

				if(this._selectionChangeTween !== null)
				{
					this._selectionChangeTween.advanceTime(this._selectionChangeTween.totalTime);
				}
				if(this._selectedIndex >= 0)
				{
					this._selectionSkin.visible = true;
					tab = this.activeTabs[this._selectedIndex];
					if(this._animateSelectionChange)
					{
						this._selectionChangeTween = new Tween(this._selectionSkin, this._selectionChangeDuration, this._selectionChangeEase);
						if(this._direction === Direction.VERTICAL)
						{
							this._selectionChangeTween.animate("y", tab.y);
							this._selectionChangeTween.animate("height", tab.height);
						}
						else //horizontal
						{
							this._selectionChangeTween.animate("x", tab.x);
							this._selectionChangeTween.animate("width", tab.width);
						}
						this._selectionChangeTween.onComplete = selectionChangeTween_onComplete;
						Starling.juggler.add(this._selectionChangeTween);
					}
					else
					{
						if(this._direction === Direction.VERTICAL)
						{
							this._selectionSkin.y = tab.y;
							this._selectionSkin.height = tab.height;
						}
						else //horizontal
						{
							this._selectionSkin.x = tab.x;
							this._selectionSkin.width = tab.width;
						}
					}
				}
				else
				{
					this._selectionSkin.visible = false;
				}
				this._animateSelectionChange = false;
				if(this._selectionSkin is IValidating)
				{
					IValidating(this._selectionSkin).validate();
				}
			}
		}

		/**
		 * @private
		 */
		override public function showFocus():void
		{
			if(!this._hasFocus)
			{
				return;
			}

			this._showFocus = true;
			this.showFocusedTab();
			this.invalidate(INVALIDATION_FLAG_FOCUS);
		}

		/**
		 * @private
		 */
		override public function hideFocus():void
		{
			if(!this._hasFocus)
			{
				return;
			}
			this._showFocus = false;
			this.hideFocusedTab();
			this.invalidate(INVALIDATION_FLAG_FOCUS);
		}

		/**
		 * @private
		 */
		protected function hideFocusedTab():void
		{
			if(this._focusedTabIndex < 0)
			{
				return;
			}
			var focusedTab:ToggleButton = this.activeTabs[this._focusedTabIndex];
			focusedTab.hideFocus();
		}

		/**
		 * @private
		 */
		protected function showFocusedTab():void
		{
			if(!this._showFocus || this._focusedTabIndex < 0)
			{
				return;
			}
			var tab:ToggleButton = this.activeTabs[this._focusedTabIndex];
			tab.showFocus();
		}

		/**
		 * @private
		 */
		protected function focusedTabFocusIn():void
		{
			if(this._focusedTabIndex < 0)
			{
				return;
			}
			var tab:ToggleButton = this.activeTabs[this._focusedTabIndex];
			tab.dispatchEventWith(FeathersEventType.FOCUS_IN);
		}

		/**
		 * @private
		 */
		protected function focusedTabFocusOut():void
		{
			if(this._focusedTabIndex < 0)
			{
				return;
			}
			var tab:ToggleButton = this.activeTabs[this._focusedTabIndex];
			tab.dispatchEventWith(FeathersEventType.FOCUS_OUT);
		}

		/**
		 * @private
		 */
		protected function refreshSelectedItem():void
		{
			if(this._selectedIndex == -1)
			{
				this._selectedItem = null;
			}
			else
			{
				this._selectedItem = this._dataProvider.getItemAt(this._selectedIndex);
			}
		}

		/**
		 * @private
		 */
		protected function getDropIndex(event:DragDropEvent):int
		{
			var point:Point = Pool.getPoint(event.localX, event.localY);
			this.localToGlobal(point, point);
			var globalX:Number = point.x;
			var globalY:Number = point.y;
			Pool.putPoint(point);

			var tabCount:int = this.activeTabs.length;
			for(var i:int = 0; i < tabCount; i++)
			{
				var tab:ToggleButton = this.activeTabs[i];
				if(this._direction === Direction.HORIZONTAL)
				{
					point = Pool.getPoint(tab.width / 2, 0);
				}
				else
				{
					point = Pool.getPoint(0, tab.height / 2);
				}
				tab.localToGlobal(point, point);
				var tabGlobalMiddleX:Number = point.x;
				var tabGlobalMiddleY:Number = point.y;
				Pool.putPoint(point);
				if(this._direction === Direction.VERTICAL)
				{
					if(globalY < tabGlobalMiddleY)
					{
						return i;
					}
				}
				else //horizontal
				{
					if(globalX < tabGlobalMiddleX)
					{
						return i;
					}
				}
			}
			return tabCount;
		}

		/**
		 * @private
		 */
		protected function refreshDropIndicator(event:DragDropEvent):void
		{
			if(!this._dropIndicatorSkin)
			{
				return;
			}
			var dropIndex:int = this.getDropIndex(event);
			if(this._direction == Direction.VERTICAL)
			{
				var dropIndicatorY:Number = 0;
				if(dropIndex == this.activeTabs.length)
				{
					dropIndicatorY = this.actualHeight - this._dropIndicatorSkin.height;
				}
				else if(dropIndex == 0)
				{
					dropIndicatorY = 0;
				}
				else
				{
					var tab:ToggleButton = this.activeTabs[dropIndex];
					dropIndicatorY = tab.y - (this._gap + this._dropIndicatorSkin.height) / 2;
				}
				this._dropIndicatorSkin.x = 0;
				this._dropIndicatorSkin.y = dropIndicatorY;
				this._dropIndicatorSkin.width = this.actualWidth;
				//just in case the direction changed, reset this value
				this._dropIndicatorSkin.height = this._explicitDropIndicatorHeight;
			}
			else //horizontal
			{
				var dropIndicatorX:Number = 0;
				if(dropIndex == this.activeTabs.length)
				{
					dropIndicatorX = this.actualWidth - this._dropIndicatorSkin.width;
				}
				else if(dropIndex == 0)
				{
					dropIndicatorX = 0;
				}
				else
				{
					tab = this.activeTabs[dropIndex];
					dropIndicatorX = tab.x - (this._gap + this._dropIndicatorSkin.width) / 2;
				}
				this._dropIndicatorSkin.x = dropIndicatorX;
				this._dropIndicatorSkin.y = 0;
				//just in case the direction changed, reset this value
				this._dropIndicatorSkin.width = this._explicitDropIndicatorWidth;
				this._dropIndicatorSkin.height = this.actualHeight;
			}
			this.addChild(this._dropIndicatorSkin);
		}

		/**
		 * @private
		 */
		protected function childProperties_onChange(proxy:PropertyProxy, name:String):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function selectionChangeTween_onComplete():void
		{
			this._selectionChangeTween = null;
		}

		/**
		 * @private
		 */
		override protected function focusInHandler(event:Event):void
		{
			super.focusInHandler(event);
			this._focusedTabIndex = this._selectedIndex;
			this.focusedTabFocusIn();
			this.stage.addEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
		}

		/**
		 * @private
		 */
		override protected function focusOutHandler(event:Event):void
		{
			super.focusOutHandler(event);
			this.hideFocusedTab();
			this.focusedTabFocusOut();
			this.stage.removeEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
		}

		/**
		 * @private
		 */
		protected var _focusedTabIndex:int = -1;

		/**
		 * @private
		 */
		protected function stage_keyDownHandler(event:KeyboardEvent):void
		{
			if(!this._isEnabled)
			{
				return;
			}
			if(!this._dataProvider || this._dataProvider.length == 0)
			{
				return;
			}
			var newFocusedTabIndex:int = this._focusedTabIndex;
			var maxFocusedTabIndex:int = this._dataProvider.length - 1;
			if(event.keyCode == Keyboard.HOME)
			{
				this.selectedIndex = newFocusedTabIndex = 0;
			}
			else if(event.keyCode == Keyboard.END)
			{
				this.selectedIndex = newFocusedTabIndex = maxFocusedTabIndex;
			}
			else if(event.keyCode == Keyboard.PAGE_UP)
			{
				newFocusedTabIndex--;
				if(newFocusedTabIndex < 0)
				{
					newFocusedTabIndex = maxFocusedTabIndex;
				}
				this.selectedIndex = newFocusedTabIndex;
			}
			else if(event.keyCode == Keyboard.PAGE_DOWN)
			{
				newFocusedTabIndex++;
				if(newFocusedTabIndex > maxFocusedTabIndex)
				{
					newFocusedTabIndex = 0;
				}
				this.selectedIndex = newFocusedTabIndex;
			}
			else if(event.keyCode == Keyboard.UP || event.keyCode == Keyboard.LEFT)
			{
				newFocusedTabIndex--;
				if(newFocusedTabIndex < 0)
				{
					newFocusedTabIndex = maxFocusedTabIndex;
				}
			}
			else if(event.keyCode == Keyboard.DOWN || event.keyCode == Keyboard.RIGHT)
			{
				newFocusedTabIndex++;
				if(newFocusedTabIndex > maxFocusedTabIndex)
				{
					newFocusedTabIndex = 0;
				}
			}

			if(newFocusedTabIndex >= 0 && newFocusedTabIndex != this._focusedTabIndex)
			{
				this.hideFocusedTab();
				this.focusedTabFocusOut();
				this._focusedTabIndex = newFocusedTabIndex;
				this.focusedTabFocusIn();
				this.showFocusedTab();
			}
		}

		/**
		 * @private
		 */
		protected function tab_triggeredHandler(event:Event):void
		{
			//if this was called after dispose, ignore it
			if(!this._dataProvider || !this.activeTabs)
			{
				return;
			}
			var tab:ToggleButton = ToggleButton(event.currentTarget);
			var index:int = this.activeTabs.indexOf(tab);
			var item:Object = this._dataProvider.getItemAt(index);
			this.dispatchEventWith(Event.TRIGGERED, false, item);
		}

		/**
		 * @private
		 */
		protected function dragEnterHandler(event:DragDropEvent):void
		{
			if(!this._dropEnabled)
			{
				return;
			}
			if(!event.dragData.hasDataForFormat(this._dragFormat))
			{
				return;
			}
			DragDropManager.acceptDrag(this);
			this.refreshDropIndicator(event);
		}

		/**
		 * @private
		 */
		protected function dragMoveHandler(event:DragDropEvent):void
		{
			if(!this._dropEnabled)
			{
				return;
			}
			if(!event.dragData.hasDataForFormat(this._dragFormat))
			{
				return;
			}
			this.refreshDropIndicator(event);
		}

		/**
		 * @private
		 */
		protected function dragExitHandler(event:DragDropEvent):void
		{
			if(this._dropIndicatorSkin)
			{
				this._dropIndicatorSkin.removeFromParent(false);
			}
		}

		/**
		 * @private
		 */
		protected function dragDropHandler(event:DragDropEvent):void
		{
			if(this._dropIndicatorSkin)
			{
				this._dropIndicatorSkin.removeFromParent(false);
			}
			var index:int = this.getDropIndex(event);
			var item:Object = event.dragData.getDataForFormat(this._dragFormat);
			var selectItem:Boolean = this._selectedItem == item;
			if(event.dragSource == this)
			{
				//if we wait to remove this item in the dragComplete handler,
				//the wrong index might be removed.
				var oldIndex:int = this._dataProvider.getItemIndex(item);
				this._dataProvider.removeItemAt(oldIndex);
				this._droppedOnSelf = true;
				if(index > oldIndex)
				{
					index--;
				}
			}
			this._dataProvider.addItemAt(item, index);
			if(selectItem)
			{
				this.selectedIndex = index;
			}
		}

		/**
		 * @private
		 */
		protected function dragCompleteHandler(event:DragDropEvent):void
		{
			if(!event.isDropped)
			{
				//nothing to modify
				return;
			}
			if(this._droppedOnSelf)
			{
				//already modified the data provider in the dragDrop handler
				this._droppedOnSelf = false;
				return;
			}
			var item:Object = event.dragData.getDataForFormat(this._dragFormat);
			this._dataProvider.removeItem(item);
		}

		/**
		 * @private
		 */
		protected function tab_drag_touchHandler(event:TouchEvent):void
		{
			if(!this._dragEnabled)
			{
				this._dragTouchPointID = -1;
				return;
			}
			if(DragDropManager.isDragging)
			{
				this._dragTouchPointID = -1;
				return;
			}
			var tab:ToggleButton = ToggleButton(event.currentTarget);
			if(this._dragTouchPointID != -1)
			{
				var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(tab.stage);
				if(exclusiveTouch.getClaim(this._dragTouchPointID))
				{
					this._dragTouchPointID = -1;
					return;
				}
				var touch:Touch = event.getTouch(tab, null, this._dragTouchPointID);
				if(touch.phase == TouchPhase.MOVED)
				{
					var index:int = this.activeTabs.indexOf(tab);
					var item:Object = this._dataProvider.getItemAt(index);
					var dragData:DragData = new DragData();
					dragData.setDataForFormat(this._dragFormat, item);
					var avatar:ToggleButton = this.createTab(item);
					avatar.width = tab.width;
					avatar.height = tab.height;
					avatar.alpha = 0.8;
					var point:Point = Pool.getPoint();
					touch.getLocation(tab, point);
					this._droppedOnSelf = false;
					DragDropManager.startDrag(this, touch, dragData, avatar, -point.x, -point.y);
					Pool.putPoint(point);
					exclusiveTouch.claimTouch(this._dragTouchPointID, tab);
					this._dragTouchPointID = -1;
				}
				else if(touch.phase == TouchPhase.ENDED)
				{
					this._dragTouchPointID = -1;
				}
			}
			else
			{
				//we aren't tracking another touch, so let's look for a new one.
				touch = event.getTouch(tab, TouchPhase.BEGAN);
				if(!touch)
				{
					//we only care about the began phase. ignore all other
					//phases when we don't have a saved touch ID.
					return;
				}
				this._dragTouchPointID = touch.id;
			}
		}

		/**
		 * @private
		 */
		protected function toggleGroup_changeHandler(event:Event):void
		{
			if(this._ignoreSelectionChanges)
			{
				return;
			}
			//it should only get here if the change happened by the user
			//triggering a tab.
			this.setSelectedIndexWithAnimation(this.toggleGroup.selectedIndex);
		}

		/**
		 * @private
		 */
		protected function dataProvider_addItemHandler(event:Event, index:int):void
		{
			if(this._selectedIndex >= index)
			{
				//we're keeping the same selected item, but the selected index
				//will change, so we need to manually dispatch the change event
				this.selectedIndex += 1;
				this.invalidate(INVALIDATION_FLAG_SELECTED);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function dataProvider_removeAllHandler(event:Event):void
		{
			this.selectedIndex = -1;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function dataProvider_removeItemHandler(event:Event, index:int):void
		{
			if(this._selectedIndex > index)
			{
				//the same item is selected, but its index has changed.
				this.selectedIndex -= 1;
			}
			else if(this._selectedIndex == index)
			{
				var oldIndex:int = this._selectedIndex;
				var newIndex:int = oldIndex;
				var maxIndex:int = this._dataProvider.length - 1;
				if(newIndex > maxIndex)
				{
					newIndex = maxIndex;
				}
				if(oldIndex == newIndex)
				{
					//we're keeping the same selected index, but the selected
					//item will change, so we need to manually dispatch the
					//change event
					this.refreshSelectedItem();
					this.invalidate(INVALIDATION_FLAG_SELECTED);
					this.dispatchEventWith(Event.CHANGE);
				}
				else
				{
					//we're selecting both a different index and a different
					//item, so we'll just call the selectedIndex setter
					this.selectedIndex = newIndex;
				}
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function dataProvider_resetHandler(event:Event):void
		{
			if(this._dataProvider.length > 0)
			{
				//the data provider has changed drastically. we should reset the
				//selection to the first item.
				if(this._selectedIndex != 0)
				{
					this.selectedIndex = 0;
				}
				else
				{
					//we're keeping the same selected index, but the selected
					//item will change, so we need to manually dispatch the
					//change event
					this.refreshSelectedItem();
					this.invalidate(INVALIDATION_FLAG_SELECTED);
					this.dispatchEventWith(Event.CHANGE);
				}
			}
			else if(this._selectedIndex >= 0)
			{
				this.selectedIndex = -1;
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function dataProvider_replaceItemHandler(event:Event, index:int):void
		{
			if(this._selectedIndex == index)
			{
				//we're keeping the same selected index, but the selected
				//item will change, so we need to manually dispatch the
				//change event
				this.refreshSelectedItem();
				this.invalidate(INVALIDATION_FLAG_SELECTED);
				this.dispatchEventWith(Event.CHANGE);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function refreshSelectedIndicesAfterFilterOrSort():void
		{
			var oldIndex:int = this._dataProvider.getItemIndex(this._selectedItem);
			if(oldIndex == -1)
			{
				//the selected item was filtered
				var newIndex:int = this._selectedIndex;
				var maxIndex:int = this._dataProvider.length - 1;
				if(newIndex > maxIndex)
				{
					//try to keep the same selectedIndex, but use the largest
					//index if the same one can't be used
					newIndex = maxIndex;
				}
				if(newIndex != -1)
				{
					this.selectedItem = this._dataProvider.getItemAt(newIndex);
				}
				else
				{
					this.selectedIndex = -1;
				}
			}
			else if(oldIndex != this._selectedIndex)
			{
				//the selectedItem is the same, but its index has changed
				this.selectedIndex = oldIndex;
			}
		}

		protected function dataProvider_sortChangeHandler(event:Event):void
		{
			this.refreshSelectedIndicesAfterFilterOrSort();
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function dataProvider_filterChangeHandler(event:Event):void
		{
			this.refreshSelectedIndicesAfterFilterOrSort();
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function dataProvider_updateItemHandler(event:Event, index:int):void
		{
			//no need to dispatch a change event. the index and the item are the
			//same. the item's properties have changed, but that doesn't require
			//a change event.
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function dataProvider_updateAllHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}
	}
}


================================================
FILE: source/feathers/controls/TabNavigator.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.supportClasses.BaseScreenNavigator;
	import feathers.core.IFeathersControl;
	import feathers.data.IListCollection;
	import feathers.data.VectorCollection;
	import feathers.events.ExclusiveTouch;
	import feathers.events.FeathersEventType;
	import feathers.layout.Direction;
	import feathers.layout.RelativePosition;
	import feathers.skins.IStyleProvider;
	import feathers.system.DeviceCapabilities;

	import flash.geom.Point;
	import flash.utils.getTimer;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * A style name to add to the navigator's tab bar sub-component.
	 * Typically used by a theme to provide different styles to different
	 * navigators.
	 *
	 * <p>In the following example, a custom tab bar style name is passed
	 * to the navigator:</p>
	 *
	 * <listing version="3.0">
	 * navigator.customTabBarStyleName = "my-custom-tab-bar";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( TabBar ).setFunctionForStyleName( "my-custom-tab-bar", setCustomTabBarStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_TAB_BAR
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #tabBarFactory
	 */
	[Style(name="customTabBarStyleName",type="String")]

	/**
	 * The duration, in seconds, of the animation for a swipe gesture.
	 *
	 * <p>In the following example, the duration of the animation for a swipe
	 * gesture is set to 500 milliseconds:</p>
	 *
	 * <listing version="3.0">
	 * navigator.swipeDuration = 0.5;</listing>
	 *
	 * @default 0.25
	 *
	 * @see #style:swipeEase
	 * @see #isSwipeEnabled
	 */
	[Style(name="swipeDuration",type="Number")]

	/**
	 * The easing function used with the animation for a swipe gesture.
	 *
	 * <p>In the following example, the ease of the animation for a swipe
	 * gesture is customized:</p>
	 *
	 * <listing version="3.0">
	 * navigator.swipeEase = Transitions.EASE_IN_OUT;</listing>
	 *
	 * @default starling.animation.Transitions.EASE_OUT
	 *
	 * @see http://doc.starling-framework.org/core/starling/animation/Transitions.html starling.animation.Transitions
	 * @see #style:swipeDuration
	 * @see #isSwipeEnabled
	 */
	[Style(name="swipeEase",type="Object")]

	/**
	 * The location of the tab bar.
	 *
	 * <p>The following example positions the tab bar on the top of the
	 * navigator:</p>
	 *
	 * <listing version="3.0">
	 * navigator.tabBarPosition = RelativePosition.TOP;</listing>
	 *
	 * @default feathers.layout.RelativePosition.BOTTOM
	 *
	 * @see feathers.layout.RelativePosition#TOP
	 * @see feathers.layout.RelativePosition#RIGHT
	 * @see feathers.layout.RelativePosition#BOTTOM
	 * @see feathers.layout.RelativePosition#LEFT
	 */
	[Style(name="tabBarPosition",type="String")]

	/**
	 * Typically used to provide some kind of animation or visual effect,
	 * this function is called when a new screen is shown.
	 *
	 * <p>In the following example, the tab navigator is given a
	 * transition that fades in the new screen on top of the old screen:</p>
	 *
	 * <listing version="3.0">
	 * navigator.transition = Fade.createFadeInTransition();</listing>
	 *
	 * <p>A number of animated transitions may be found in the
	 * <a href="../motion/package-detail.html">feathers.motion</a> package.
	 * However, you are not limited to only these transitions. It's possible
	 * to create custom transitions too.</p>
	 *
	 * <p>A custom transition function should have the following signature:</p>
	 * <pre>function(oldScreen:DisplayObject, newScreen:DisplayObject, completeCallback:Function):void</pre>
	 *
	 * <p>Either of the <code>oldScreen</code> and <code>newScreen</code>
	 * arguments may be <code>null</code>, but never both. The
	 * <code>oldScreen</code> argument will be <code>null</code> when the
	 * first screen is displayed or when a new screen is displayed after
	 * clearing the screen. The <code>newScreen</code> argument will
	 * be null when clearing the screen.</p>
	 *
	 * <p>The <code>completeCallback</code> function <em>must</em> be called
	 * when the transition effect finishes.This callback indicate to the
	 * tab navigator that the transition has finished. This function has
	 * the following signature:</p>
	 *
	 * <pre>function(cancelTransition:Boolean = false):void</pre>
	 *
	 * <p>The first argument defaults to <code>false</code>, meaning that
	 * the transition completed successfully. In most cases, this callback
	 * may be called without arguments. If a transition is cancelled before
	 * completion (perhaps through some kind of user interaction), and the
	 * previous screen should be restored, pass <code>true</code> as the
	 * first argument to the callback to inform the tab navigator that
	 * the transition is cancelled.</p>
	 *
	 * @default null
	 *
	 * @see ../../../help/transitions.html Transitions for Feathers screen navigators
	 * @see #showScreen()
	 */
	[Style(name="transition",type="Function")]

	/**
	 * Dispatched when one of the tabs is triggered. The <code>data</code>
	 * property of the event contains the <code>TabNavigatorItem</code> that is
	 * associated with the tab that was triggered.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The <code>TabNavigatorItem</code>
	 *   associated with the tab that was triggered.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.TRIGGERED
	 */
	[Event(name="triggered",type="starling.events.Event")]

	/**
	 * Dispatched when the user starts a swipe gesture to switch tabs.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.BEGIN_INTERACTION
	 * @see #event:endInteraction feathers.events.FeathersEventType.END_INTERACTION
	 * @see #isSwipeEnabled
	 */
	[Event(name="beginInteraction",type="starling.events.Event")]

	/**
	 * Dispatched when the user stops a swipe gesture. If the user interaction
	 * has also triggered an animation, the content may continue moving after
	 * this event is dispatched.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.END_INTERACTION
	 * @see #event:beginInteraction feathers.events.FeathersEventType.BEGIN_INTERACTION
	 * @see #isSwipeEnabled
	 */
	[Event(name="endInteraction",type="starling.events.Event")]

	/**
	 * A tabbed container.
	 *
	 * <p>The following example creates a tab navigator, adds a couple of tabs
	 * and displays the navigator:</p>
	 *
	 * <listing version="3.0">
	 * var navigator:TabNavigator = new TabNavigator();
	 * navigator.addScreen( "newsFeed", new TabNavigatorItem( NewsFeedTab, "News" ) );
	 * navigator.addScreen( "profile", new TabNavigatorItem( ProfileTab, "Profile" ) );
	 * this.addChild( navigator );
	 * </listing>
	 *
	 * @see ../../../help/tab-navigator.html How to use the Feathers TabNavigator component
	 * @see feathers.controls.TabNavigatorItem
	 *
	 * @productversion Feathers 3.1.0
	 */
	public class TabNavigator extends BaseScreenNavigator
	{
		/**
		 * @private
		 * The current velocity is given high importance.
		 */
		private static const CURRENT_VELOCITY_WEIGHT:Number = 2.33;

		/**
		 * @private
		 * Older saved velocities are given less importance.
		 */
		private static const VELOCITY_WEIGHTS:Vector.<Number> = new <Number>[1, 1.33, 1.66, 2];

		/**
		 * @private
		 */
		private static const MAXIMUM_SAVED_VELOCITY_COUNT:int = 4;

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_TAB_BAR_FACTORY:String = "tabBarFactory";

		/**
		 * The default value added to the <code>styleNameList</code> of the tab
		 * bar.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_TAB_BAR:String = "feathers-tab-navigator-tab-bar";

		/**
		 * The default <code>IStyleProvider</code> for all <code>TabNavigator</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static function defaultTabBarFactory():TabBar
		{
			return new TabBar();
		}

		/**
		 * Constructor.
		 */
		public function TabNavigator()
		{
			super();
			this.screenContainer = new LayoutGroup();
			this.screenContainer.addEventListener(TouchEvent.TOUCH, screenContainer_touchHandler);
			this.addChild(this.screenContainer);
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return TabNavigator.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _selectedIndex:int = -1;

		/**
		 * The index of the currently selected tab. Returns <code>-1</code> if
		 * no tab is selected.
		 *
		 * <p>In the following example, the tab navigator's selected index is changed:</p>
		 *
		 * <listing version="3.0">
		 * navigator.selectedIndex = 2;</listing>
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected index:</p>
		 *
		 * <listing version="3.0">
		 * function navigator_changeHandler( event:Event ):void
		 * {
		 *     var navigator:TabNavigator = TabNavigator( event.currentTarget );
		 *     var index:int = navigator.selectedIndex;
		 * 
		 * }
		 * navigator.addEventListener( Event.CHANGE, navigator_changeHandler );</listing>
		 *
		 * @default -1
		 */
		public function get selectedIndex():int
		{
			return this._selectedIndex;
		}

		/**
		 * @private
		 */
		public function set selectedIndex(value:int):void
		{
			if(this._selectedIndex == value)
			{
				return;
			}
			this._selectedIndex = value;
			if(value < 0)
			{
				this.clearScreenInternal();
			}
			else
			{
				var id:String = this._tabBarDataProvider.getItemAt(this._selectedIndex) as String;
				if(this._activeScreenID === id)
				{
					return;
				}
				this.showScreen(id);
			}
		}

		/**
		 * The value added to the <code>styleNameList</code> of the tab bar.
		 * This variable is <code>protected</code> so that sub-classes can
		 * customize the tab bar style name in their constructors instead of
		 * using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_TAB_BAR</code>.
		 *
		 * <p>To customize the tab bar style name without subclassing, see
		 * <code>customTabBarStyleName</code>.</p>
		 *
		 * @see #style:customTabBarStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var tabBarStyleName:String = DEFAULT_CHILD_STYLE_NAME_TAB_BAR;

		//this would be a VectorCollection with a Vector.<String>, but the ASC1
		//compiler doesn't like it!
		/**
		 * @private
		 */
		protected var _tabBarDataProvider:IListCollection = new VectorCollection(new <String>[]);

		/**
		 * @private
		 */
		protected var _ignoreTabBarChanges:Boolean = false;

		/**
		 * @private
		 */
		protected var tabBar:TabBar;

		/**
		 * @private
		 */
		protected var _tabBarFactory:Function;

		/**
		 * A function used to generate the navigator's tab bar sub-component.
		 * The tab bar must be an instance of <code>TabBar</code> (or a
		 * subclass). This factory can be used to change properties on the tab
		 * bar when it is first created. For instance, if you are skinning
		 * Feathers components without a theme, you might use this factory to
		 * set skins and other styles on the tab bar.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():TabBar</pre>
		 *
		 * <p>In the following example, a custom tab bar factory is passed
		 * to the navigator:</p>
		 *
		 * <listing version="3.0">
		 * navigator.tabBarFactory = function():TabBar
		 * {
		 *     var tabs:TabBar = new TabBar();
		 *     tabs.distributeTabSizes = true;
		 *     return tabs;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.TabBar
		 */
		public function get tabBarFactory():Function
		{
			return this._tabBarFactory;
		}

		/**
		 * @private
		 */
		public function set tabBarFactory(value:Function):void
		{
			if(this._tabBarFactory == value)
			{
				return;
			}
			this._tabBarFactory = value;
			this.invalidate(INVALIDATION_FLAG_TAB_BAR_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customTabBarStyleName:String;

		/**
		 * @private
		 */
		public function get customTabBarStyleName():String
		{
			return this._customTabBarStyleName;
		}

		/**
		 * @private
		 */
		public function set customTabBarStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customTabBarStyleName === value)
			{
				return;
			}
			this._customTabBarStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TAB_BAR_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _tabBarPosition:String = RelativePosition.BOTTOM;

		[Inspectable(type="String",enumeration="top,right,bottom,left")]
		/**
		 * @private
		 */
		public function get tabBarPosition():String
		{
			return this._tabBarPosition;
		}

		/**
		 * @private
		 */
		public function set tabBarPosition(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._tabBarPosition === value)
			{
				return;
			}
			this._tabBarPosition = value;
			this.invalidate(INVALIDATION_FLAG_TAB_BAR_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _transition:Function;

		/**
		 * @private
		 */
		public function get transition():Function
		{
			return this._transition;
		}

		/**
		 * @private
		 */
		public function set transition(value:Function):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._transition = value;
		}

		/**
		 * @private
		 */
		protected var _dragCancelled:Boolean = false;

		/**
		 * @private
		 */
		protected var _isDragging:Boolean = false;

		/**
		 * @private
		 */
		protected var _isDraggingPrevious:Boolean = false;

		/**
		 * @private
		 */
		protected var _isDraggingNext:Boolean = false;

		/**
		 * @private
		 */
		protected var _swipeTween:Tween = null;

		/**
		 * @private
		 */
		protected var _isSwipeEnabled:Boolean = false;

		/**
		 * Determines if the swipe gesture to switch between tabs is enabled.
		 *
		 * <p>In the following example, swiping between tabs is enabled:</p>
		 *
		 * <listing version="3.0">
		 * navigator.isSwipeEnabled = true;</listing>
		 *
		 * @default false
		 */
		public function get isSwipeEnabled():Boolean
		{
			return this._isSwipeEnabled;
		}

		/**
		 * @private
		 */
		public function set isSwipeEnabled(value:Boolean):void
		{
			this._isSwipeEnabled = value;
		}

		/**
		 * @private
		 */
		protected var _swipeDuration:Number = 0.25;

		/**
		 * @private
		 */
		public function get swipeDuration():Number
		{
			return this._swipeDuration;
		}

		/**
		 * @private
		 */
		public function set swipeDuration(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._swipeDuration = value;
		}

		/**
		 * @private
		 */
		protected var _swipeEase:Object = Transitions.EASE_OUT;

		/**
		 * @private
		 */
		public function get swipeEase():Object
		{
			return this._swipeEase;
		}

		/**
		 * @private
		 */
		public function set swipeEase(value:Object):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._swipeEase = value;
		}

		/**
		 * @private
		 */
		protected var _minimumDragDistance:Number = 0.04;

		/**
		 * The minimum physical distance (in inches) that a touch must move
		 * before a drag gesture begins.
		 *
		 * <p>In the following example, the minimum drag distance is customized:</p>
		 *
		 * <listing version="3.0">
		 * scroller.minimumDragDistance = 0.1;</listing>
		 *
		 * @default 0.04
		 */
		public function get minimumDragDistance():Number
		{
			return this._minimumDragDistance;
		}

		/**
		 * @private
		 */
		public function set minimumDragDistance(value:Number):void
		{
			this._minimumDragDistance = value;
		}

		/**
		 * @private
		 */
		protected var _minimumSwipeVelocity:Number = 5;

		/**
		 * The minimum physical velocity (in inches per second) that a touch
		 * must move before a swipe is detected. Otherwise, it will settle which
		 * screen to navigate to based on which one is closer when the touch ends.
		 *
		 * <p>In the following example, the minimum swipe velocity is customized:</p>
		 *
		 * <listing version="3.0">
		 * navigator.minimumSwipeVelocity = 2;</listing>
		 *
		 * @default 5
		 */
		public function get minimumSwipeVelocity():Number
		{
			return this._minimumSwipeVelocity;
		}

		/**
		 * @private
		 */
		public function set minimumSwipeVelocity(value:Number):void
		{
			this._minimumSwipeVelocity = value;
		}

		/**
		 * @private
		 */
		protected var _startTouchX:Number;

		/**
		 * @private
		 */
		protected var _startTouchY:Number;

		/**
		 * @private
		 */
		protected var _currentTouchX:Number;

		/**
		 * @private
		 */
		protected var _currentTouchY:Number;

		/**
		 * @private
		 */
		protected var _previousTouchTime:int;

		/**
		 * @private
		 */
		protected var _previousTouchX:Number;

		/**
		 * @private
		 */
		protected var _previousTouchY:Number;

		/**
		 * @private
		 */
		protected var _velocityX:Number = 0;

		/**
		 * @private
		 */
		protected var _velocityY:Number = 0;

		/**
		 * @private
		 */
		protected var _previousVelocityX:Vector.<Number> = new <Number>[];

		/**
		 * @private
		 */
		protected var _previousVelocityY:Vector.<Number> = new <Number>[];

		/**
		 * @private
		 */
		protected var _savedTransitionOnComplete:Function;

		/**
		 * Registers a new screen with a string identifier that can be used
		 * to reference the screen in other calls, like <code>removeScreen()</code>
		 * or <code>showScreen()</code>.
		 *
		 * @see #addScreenAt()
		 * @see #removeScreen()
		 * @see #removeScreenAt()
		 */
		public function addScreen(id:String, item:TabNavigatorItem):void
		{
			this.addScreenAt(id, item, this._tabBarDataProvider.length);
		}

		/**
		 * Registers a new screen with a string identifier that can be used
		 * to reference the screen in other calls, like <code>removeScreen()</code>
		 * or <code>showScreen()</code>.
		 *
		 * @see #addScreen()
		 * @see #removeScreen()
		 * @see #removeScreenAt()
		 */
		public function addScreenAt(id:String, item:TabNavigatorItem, index:int):void
		{
			this.addScreenInternal(id, item);
			this._tabBarDataProvider.addItemAt(id, index);
			if(this._selectedIndex < 0 && this._tabBarDataProvider.length == 1)
			{
				this.selectedIndex = 0;
			}
		}

		/**
		 * Removes an existing screen using the identifier assigned to it in the
		 * call to <code>addScreen()</code> or <code>addScreenAt()</code>.
		 *
		 * @see #removeScreenAt()
		 * @see #removeAllScreens()
		 * @see #addScreen()
		 * @see #addScreenAt()
		 */
		public function removeScreen(id:String):TabNavigatorItem
		{
			this._tabBarDataProvider.removeItem(id);
			return TabNavigatorItem(this.removeScreenInternal(id));
		}

		/**
		 * Removes an existing screen using the identifier assigned to it in the
		 * call to <code>addScreen()</code>.
		 *
		 * @see #removeScreen()
		 * @see #removeAllScreens()
		 * @see #addScreen()
		 * @see #addScreenAt()
		 */
		public function removeScreenAt(index:int):TabNavigatorItem
		{
			var id:String = this._tabBarDataProvider.removeItemAt(index) as String;
			return TabNavigatorItem(this.removeScreenInternal(id));
		}

		/**
		 * @private
		 */
		override public function removeAllScreens():void
		{
			this._tabBarDataProvider.removeAll();
			super.removeAllScreens();
		}

		/**
		 *
		 * Displays the screen with the specified id. An optional transition may
		 * be passed in. If <code>null</code> the <code>transition</code>
		 * property will be used instead.
		 *
		 * <p>Returns a reference to the new screen, unless a transition is
		 * currently active. In that case, the new screen will be queued until
		 * the transition has completed, and no reference will be returned.</p>
		 *
		 * @see #transition
		 */
		public function showScreen(id:String, transition:Function = null):DisplayObject
		{
			if(this._activeScreenID === id)
			{
				//if we're already showing this id, do nothing
				return this._activeScreen;
			}
			if(transition === null)
			{
				var item:TabNavigatorItem = this.getScreen(id);
				if(item !== null && item.transition !== null)
				{
					transition = item.transition;
				}
				else
				{
					transition = this.transition;
				}
			}
			//showScreenInternal() dispatches Event.CHANGE, so we want to be
			//sure that the selectedIndex property returns the correct value
			this._selectedIndex = this._tabBarDataProvider.getItemIndex(id);
			var result:DisplayObject = this.showScreenInternal(id, transition);
			//however, we don't want to set the tab bar's selectedIndex before
			//calling setScreenInternal() because it would cause showScreen()
			//to be called again if we did it first
			this.tabBar.selectedIndex = this._selectedIndex;
			return result;
		}

		/**
		 * Returns the <code>TabNavigatorItem</code> instance with the
		 * specified identifier.
		 */
		public function getScreen(id:String):TabNavigatorItem
		{
			if(this._screens.hasOwnProperty(id))
			{
				return TabNavigatorItem(this._screens[id]);
			}
			return null;
		}

		/**
		 * @private
		 */
		override public function hitTest(localPoint:Point):DisplayObject
		{
			var result:DisplayObject = super.hitTest(localPoint);
			if(result)
			{
				if(this._isDragging)
				{
					return this.screenContainer;
				}
				return result;
			}
			//we want to register touches in our hitArea as a last resort
			if(!this.visible || !this.touchable)
			{
				return null;
			}
			return this._hitArea.contains(localPoint.x, localPoint.y) ? this.screenContainer : null;
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var tabBarFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_TAB_BAR_FACTORY);

			if(tabBarFactoryInvalid)
			{
				this.createTabBar();
			}

			super.draw();
		}

		/**
		 * Creates and adds the <code>tabBar</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #tabBar
		 * @see #tabBarFactory
		 * @see #style:customTabBarStyleName
		 */
		protected function createTabBar():void
		{
			if(this.tabBar)
			{
				this.tabBar.removeFromParent(true);
				this.tabBar = null;
			}

			var factory:Function = this._tabBarFactory != null ? this._tabBarFactory : defaultTabBarFactory;
			var tabBarStyleName:String = this._customTabBarStyleName != null ? this._customTabBarStyleName : this.tabBarStyleName;
			this.tabBar = TabBar(factory());
			this.tabBar.styleNameList.add(tabBarStyleName);
			if(this._tabBarPosition === RelativePosition.LEFT ||
				this._tabBarPosition === RelativePosition.RIGHT)
			{
				this.tabBar.direction = Direction.VERTICAL;
			}
			else //top or bottom
			{
				this.tabBar.direction = Direction.HORIZONTAL;
			}
			this.tabBar.addEventListener(Event.CHANGE, tabBar_changeHandler);
			this.tabBar.addEventListener(Event.TRIGGERED, tabBar_triggeredHandler);
			this.tabBar.dataProvider = this._tabBarDataProvider;
			this.tabBar.labelFunction = this.getTabLabel;
			this.tabBar.iconFunction = this.getTabIcon;
			this.addChild(this.tabBar);
		}

		/**
		 * @private
		 */
		protected function getTabLabel(id:String):String
		{
			var item:TabNavigatorItem = this.getScreen(id);
			return item.label;
		}

		/**
		 * @private
		 */
		protected function getTabIcon(id:String):DisplayObject
		{
			var item:TabNavigatorItem = this.getScreen(id);
			return item.icon;
		}

		/**
		 * @private
		 */
		override protected function prepareActiveScreen():void
		{
			if(this._activeScreen is StackScreenNavigator)
			{
				//always show root screen when switching to this tab
				StackScreenNavigator(this._activeScreen).popToRootScreen(defaultTransition);
			}
		}

		/**
		 * @private
		 */
		override protected function cleanupActiveScreen():void
		{
		}

		/**
		 * @private
		 */
		override protected function layoutChildren():void
		{
			var screenWidth:Number = this.actualWidth;
			var screenHeight:Number = this.actualHeight;
			if(this._tabBarPosition === RelativePosition.LEFT ||
				this._tabBarPosition === RelativePosition.RIGHT)
			{
				this.tabBar.y = 0;
				this.tabBar.height = this.actualHeight;
				this.tabBar.validate();
				if(this._tabBarPosition === RelativePosition.LEFT)
				{
					this.tabBar.x = 0;
				}
				else
				{
					this.tabBar.x = this.actualWidth - this.tabBar.width;
				}
				screenWidth -= this.tabBar.width;
			}
			else //top or bottom
			{
				this.tabBar.x = 0;
				this.tabBar.width = this.actualWidth;
				this.tabBar.validate();
				if(this._tabBarPosition === RelativePosition.TOP)
				{
					this.tabBar.y = 0;
				}
				else
				{
					this.tabBar.y = this.actualHeight - this.tabBar.height;
				}
				screenHeight -= this.tabBar.height;
			}

			if(this._tabBarPosition === RelativePosition.LEFT)
			{
				this.screenContainer.x = this.tabBar.width;
			}
			else //top, bottom, or right
			{
				this.screenContainer.x = 0;
			}
			if(this._tabBarPosition === RelativePosition.TOP)
			{
				this.screenContainer.y = this.tabBar.height;
			}
			else //right, left, or bottom
			{
				this.screenContainer.y = 0;
			}
			this.screenContainer.width = screenWidth;
			this.screenContainer.height = screenHeight;
			if(this._activeScreen !== null)
			{
				this._activeScreen.x = 0;
				this._activeScreen.y = 0;
				this._activeScreen.width = screenWidth;
				this._activeScreen.height = screenHeight;
			}
		}

		/**
		 * @private
		 */
		protected function tabBar_triggeredHandler(event:Event, id:String):void
		{
			this.dispatchEventWith(Event.TRIGGERED, false, this.getScreen(id));
			if(id !== this._activeScreenID)
			{
				return;
			}
			if(this._activeScreen is StackScreenNavigator)
			{
				var navigator:StackScreenNavigator = StackScreenNavigator(this._activeScreen);
				navigator.popToRootScreen();
			}
		}

		/**
		 * @private
		 */
		protected function tabBar_changeHandler(event:Event):void
		{
			if(this._ignoreTabBarChanges)
			{
				return;
			}
			var id:String = this.tabBar.selectedItem as String;
			if(this._activeScreenID === id)
			{
				//we're already showing this screen, so no need to do anything
				//this probably isn't a bug because we sometimes update the
				//tab bar's selected index after the activeScreenID is updated
				return;
			}
			var transition:Function = null;
			if(this._activeScreenID === null)
			{
				transition = defaultTransition;
			}
			this.showScreen(id, transition);
		}

		/**
		 * @private
		 */
		protected function exclusiveTouch_changeHandler(event:Event, touchID:int):void
		{
			if(this.touchPointID < 0 || this.touchPointID != touchID || this._isDragging)
			{
				return;
			}

			var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
			if(exclusiveTouch.getClaim(touchID) == this)
			{
				return;
			}

			this.touchPointID = -1;
		}

		/**
		 * @private
		 */
		protected function dragTransition(oldScreen:IFeathersControl, newScreen:IFeathersControl, onComplete:Function):void
		{
			this._savedTransitionOnComplete = onComplete;
			if(this._swipeTween !== null)
			{
				//it's possible that TouchPhase.ENDED is dispatched before the
				//transition starts. if that's the case, the tween will already
				//be created, and we simply add it to the juggler.
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				starling.juggler.add(this._swipeTween);
			}
			else
			{
				this.handleDragMove();
			}
		}

		/**
		 * @private
		 */
		protected function handleTouchBegan(touch:Touch):void
		{
			var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
			if(exclusiveTouch.getClaim(touch.id))
			{
				//already claimed
				return;
			}

			var point:Point = Pool.getPoint();
			touch.getLocation(this, point);
			var localX:Number = point.x;
			var localY:Number = point.y;
			Pool.putPoint(point);

			this.touchPointID = touch.id;
			this._velocityX = 0;
			this._velocityY = 0;
			this._previousVelocityX.length = 0;
			this._previousVelocityY.length = 0;
			this._previousTouchTime = getTimer();
			this._previousTouchX = this._startTouchX = this._currentTouchX = localX;
			this._previousTouchY = this._startTouchY = this._currentTouchY = localY;
			this._isDraggingPrevious = false;
			this._isDraggingNext = false;
			this._isDragging = false;
			this._dragCancelled = false;

			exclusiveTouch.addEventListener(Event.CHANGE, exclusiveTouch_changeHandler);
		}

		/**
		 * @private
		 */
		protected function handleTouchMoved(touch:Touch):void
		{
			var point:Point = Pool.getPoint();
			touch.getLocation(this, point);
			this._currentTouchX = point.x;
			this._currentTouchY = point.y;
			Pool.putPoint(point);
			var now:int = getTimer();
			var timeOffset:int = now - this._previousTouchTime;
			if(timeOffset > 0)
			{
				//we're keeping previous velocity updates to improve accuracy
				this._previousVelocityX[this._previousVelocityX.length] = this._velocityX;
				if(this._previousVelocityX.length > MAXIMUM_SAVED_VELOCITY_COUNT)
				{
					this._previousVelocityX.shift();
				}
				this._previousVelocityY[this._previousVelocityY.length] = this._velocityY;
				if(this._previousVelocityY.length > MAXIMUM_SAVED_VELOCITY_COUNT)
				{
					this._previousVelocityY.shift();
				}
				this._velocityX = (this._currentTouchX - this._previousTouchX) / timeOffset;
				this._velocityY = (this._currentTouchY - this._previousTouchY) / timeOffset;
				this._previousTouchTime = now;
				this._previousTouchX = this._currentTouchX;
				this._previousTouchY = this._currentTouchY;
			}
		}

		/**
		 * @private
		 */
		protected function handleDragMove():void
		{
			if(this._tabBarPosition === RelativePosition.LEFT ||
				this._tabBarPosition === RelativePosition.RIGHT)
			{
				this._previousScreenInTransition.y = this._currentTouchY - this._startTouchY;
			}
			else //top or bottom
			{
				this._previousScreenInTransition.x = this._currentTouchX - this._startTouchX;
			}
			this.swipeTween_onUpdate();
		}

		/**
		 * @private
		 */
		override protected function transitionComplete(cancelTransition:Boolean = false):void
		{
			if(cancelTransition)
			{
				this._selectedIndex = this._tabBarDataProvider.getItemIndex(this._previousScreenInTransitionID);
				var oldIgnoreTabBarChanges:Boolean = this._ignoreTabBarChanges;
				this._ignoreTabBarChanges = true;
				this.tabBar.selectedIndex = this._selectedIndex;
				this._ignoreTabBarChanges = oldIgnoreTabBarChanges;
			}
			super.transitionComplete(cancelTransition);
		}

		/**
		 * @private
		 */
		protected function swipeTween_onUpdate():void
		{
			if(this._tabBarPosition === RelativePosition.LEFT ||
				this._tabBarPosition === RelativePosition.RIGHT)
			{
				if(this._isDraggingPrevious)
				{
					this._activeScreen.x = this._previousScreenInTransition.x;
					this._activeScreen.y = this._previousScreenInTransition.y - this._activeScreen.height;
				}
				else if(this._isDraggingNext)
				{
					this._activeScreen.x = this._previousScreenInTransition.x;
					this._activeScreen.y = this._previousScreenInTransition.y + this._previousScreenInTransition.height;
				}
			}
			else //top or bottom
			{
				if(this._isDraggingPrevious)
				{
					this._activeScreen.x = this._previousScreenInTransition.x - this._activeScreen.width;
					this._activeScreen.y = this._previousScreenInTransition.y;
				}
				else if(this._isDraggingNext)
				{
					this._activeScreen.x = this._previousScreenInTransition.x + this._previousScreenInTransition.width;
					this._activeScreen.y = this._previousScreenInTransition.y;
				}
			}
		}

		/**
		 * @private
		 */
		protected function swipeTween_onComplete():void
		{
			this._swipeTween = null;
			this._isDragging = false;
			this._isDraggingPrevious = false;
			this._isDraggingNext = false;
			var cancelled:Boolean = this._dragCancelled;
			this._dragCancelled = false;
			var onComplete:Function = this._savedTransitionOnComplete;
			this._savedTransitionOnComplete = null;
			onComplete(cancelled);
		}

		/**
		 * @private
		 */
		protected function handleDragEnd():void
		{
			this._dragCancelled = false;
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			if(this._tabBarPosition === RelativePosition.LEFT ||
				this._tabBarPosition === RelativePosition.RIGHT)
			{
				//take the average for more accuracy
				var sum:Number = this._velocityY * CURRENT_VELOCITY_WEIGHT;
				var velocityCount:int = this._previousVelocityY.length;
				var totalWeight:Number = CURRENT_VELOCITY_WEIGHT;
				for(var i:int = 0; i < velocityCount; i++)
				{
					var weight:Number = VELOCITY_WEIGHTS[i];
					sum += this._previousVelocityY.shift() * weight;
					totalWeight += weight;
				}
				var inchesPerSecondY:Number = 1000 * (sum / totalWeight) / (DeviceCapabilities.dpi / starling.contentScaleFactor);

				if(inchesPerSecondY < -this._minimumSwipeVelocity)
				{
					//force next
					if(this._isDraggingPrevious)
					{
						this._dragCancelled = true;
					}
				}
				else if(inchesPerSecondY > this._minimumSwipeVelocity)
				{
					//force previous
					if(this._isDraggingNext)
					{
						this._dragCancelled = true;
					}
				}
				else if(this._activeScreen.y >= (this.screenContainer.height / 2))
				{
					if(this._isDraggingNext)
					{
						this._dragCancelled = true;
					}
				}
				else if(this._activeScreen.y <= -(this.screenContainer.height / 2))
				{
					if(this._isDraggingPrevious)
					{
						this._dragCancelled = true;
					}
				}
			}
			else //top or bottom
			{
				sum = this._velocityX * CURRENT_VELOCITY_WEIGHT;
				velocityCount = this._previousVelocityX.length;
				totalWeight = CURRENT_VELOCITY_WEIGHT;
				for(i = 0; i < velocityCount; i++)
				{
					weight = VELOCITY_WEIGHTS[i];
					sum += this._previousVelocityX.shift() * weight;
					totalWeight += weight;
				}

				var inchesPerSecondX:Number = 1000 * (sum / totalWeight) / (DeviceCapabilities.dpi / starling.contentScaleFactor);

				if(inchesPerSecondX < -this._minimumSwipeVelocity)
				{
					//force next
					if(this._isDraggingPrevious)
					{
						this._dragCancelled = true;
					}
				}
				else if(inchesPerSecondX > this._minimumSwipeVelocity)
				{
					//force previous
					if(this._isDraggingNext)
					{
						this._dragCancelled = true;
					}
				}
				else if(this._activeScreen.x >= (this.screenContainer.width / 2))
				{
					if(this._isDraggingNext)
					{
						this._dragCancelled = true;
					}
				}
				else if(this._activeScreen.x <= -(this.screenContainer.width / 2))
				{
					if(this._isDraggingPrevious)
					{
						this._dragCancelled = true;
					}
				}
			}

			this._swipeTween = new Tween(this._previousScreenInTransition, this._swipeDuration, this._swipeEase);
			if(this._tabBarPosition === RelativePosition.LEFT ||
				this._tabBarPosition === RelativePosition.RIGHT)
			{
				if(this._dragCancelled)
				{
					this._swipeTween.animate("y", 0);
				}
				else if(this._isDraggingPrevious)
				{
					this._swipeTween.animate("y", this.screenContainer.height);
				}
				else if(this._isDraggingNext)
				{
					this._swipeTween.animate("y", -this.screenContainer.height);
				}
			}
			else //top or bottom
			{
				if(this._dragCancelled)
				{
					this._swipeTween.animate("x", 0);
				}
				else if(this._isDraggingPrevious)
				{
					this._swipeTween.animate("x", this.screenContainer.width);
				}
				else if(this._isDraggingNext)
				{
					this._swipeTween.animate("x", -this.screenContainer.width);
				}
			}
			this._swipeTween.onUpdate = this.swipeTween_onUpdate;
			this._swipeTween.onComplete = this.swipeTween_onComplete;
			if(this._savedTransitionOnComplete !== null)
			{
				//it's possible that we get here before the transition has
				//officially start. if that's the case, we won't add the tween
				//to the juggler now, and we'll do it later.
				starling.juggler.add(this._swipeTween);
			}
		}

		/**
		 * @private
		 */
		protected function checkForDrag():void
		{
			var maxIndex:int = this._tabBarDataProvider.length - 1;
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var horizontalInchesMoved:Number = (this._currentTouchX - this._startTouchX) / (DeviceCapabilities.dpi / starling.contentScaleFactor);
			var verticalInchesMoved:Number = (this._currentTouchY - this._startTouchY) / (DeviceCapabilities.dpi / starling.contentScaleFactor);
			if(this._tabBarPosition === RelativePosition.LEFT ||
				this._tabBarPosition === RelativePosition.RIGHT)
			{
				if(this._selectedIndex > 0 && verticalInchesMoved >= this._minimumDragDistance)
				{
					this._isDraggingPrevious = true;
				}
				else if(this._selectedIndex < maxIndex && verticalInchesMoved <= -this._minimumDragDistance)
				{
					this._isDraggingNext = true;
				}
			}
			else //top or bottom
			{
				if(this._selectedIndex > 0 && horizontalInchesMoved >= this._minimumDragDistance)
				{
					this._isDraggingPrevious = true;
				}
				else if(this._selectedIndex < maxIndex && horizontalInchesMoved <= -this._minimumDragDistance)
				{
					this._isDraggingNext = true;
				}
			}

			if(this._isDraggingPrevious)
			{
				var previousIndex:int = this._selectedIndex - 1;
				this._isDragging = true;
				var previousID:String = this._tabBarDataProvider.getItemAt(previousIndex) as String;
				this.showScreen(previousID, dragTransition);
			}
			if(this._isDraggingNext)
			{
				var nextIndex:int = this._selectedIndex + 1;
				this._isDragging = true;
				var nextID:String = this._tabBarDataProvider.getItemAt(nextIndex) as String;
				this.showScreen(nextID, dragTransition);
			}
			if(this._isDragging)
			{
				this._startTouchX = this._currentTouchX;
				this._startTouchY = this._currentTouchY;
				var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
				exclusiveTouch.removeEventListener(Event.CHANGE, exclusiveTouch_changeHandler);
				exclusiveTouch.claimTouch(this.touchPointID, this);
				this.dispatchEventWith(FeathersEventType.BEGIN_INTERACTION);
			}
		}

		/**
		 * @private
		 */
		protected function screenContainer_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled || this._swipeTween !== null || !this._isSwipeEnabled)
			{
				this.touchPointID = -1;
				return;
			}
			if(this.touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this.screenContainer, null, this.touchPointID);
				if(!touch)
				{
					return;
				}
				if(touch.phase == TouchPhase.MOVED)
				{
					this.handleTouchMoved(touch);

					if(!this._isDragging)
					{
						this.checkForDrag();
					}
					if(this._isDragging)
					{
						this.handleDragMove();
					}
				}
				else if(touch.phase == TouchPhase.ENDED)
				{
					this.touchPointID = -1;
					if(this._isDragging)
					{
						this.handleDragEnd();
						this.dispatchEventWith(FeathersEventType.END_INTERACTION);
					}
				}
			}
			else
			{
				touch = event.getTouch(this.screenContainer, TouchPhase.BEGAN);
				if(!touch)
				{
					return;
				}
				this.handleTouchBegan(touch);
			}
		}
	}
}


================================================
FILE: source/feathers/controls/TabNavigatorItem.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.supportClasses.IScreenNavigatorItem;

	import starling.display.DisplayObject;

	//it's required by IScreenNavigatorItem, but we always return null
	[Exclude(name="transitionDelayEvent",kind="property")]

	/**
	 * Data for an individual tab that will be displayed by a
	 * <code>TabNavigator</code> component.
	 *
	 * @see ../../../help/tab-navigator.html How to use the Feathers TabNavigator component
	 * @see feathers.controls.TabNavigator
	 *
	 * @productversion Feathers 3.1.0
	 */
	public class TabNavigatorItem implements IScreenNavigatorItem
	{
		/**
		 * Constructor.
		 */
		public function TabNavigatorItem(classOrFunctionOrDisplayObject:Object = null,
			label:String = null, icon:DisplayObject = null)
		{
			if(classOrFunctionOrDisplayObject is DisplayObject)
			{
				this.screenDisplayObject = DisplayObject(classOrFunctionOrDisplayObject);
			}
			else if(classOrFunctionOrDisplayObject is Class)
			{
				this.screenClass = classOrFunctionOrDisplayObject as Class;
			}
			else if(classOrFunctionOrDisplayObject is Function)
			{
				this.screenFunction = classOrFunctionOrDisplayObject as Function;
			}
			else if(classOrFunctionOrDisplayObject !== null)
			{
				throw new ArgumentError("Unknown view type. Must be Class, Function, or DisplayObject.");
			}
			this._label = label;
			this._icon = icon;
			this._properties = {};
		}

		/**
		 * @private
		 */
		protected var _screenClass:Class;

		/**
		 * A <code>Class</code> that may be instantiated to create a
		 * <code>DisplayObject</code> instance to display when the associated
		 * tab is selected. A new instance of the screen will be instantiated
		 * every time that it is shown by the <code>TabNavigator</code>. The
		 * screen's state will not be saved automatically, but it may be saved
		 * in <code>properties</code>, if needed.
		 *
		 * @default null
		 *
		 * @see #screenFunction
		 * @see #screenDisplayObject
		 */
		public function get screenClass():Class
		{
			return this._screenClass;
		}

		/**
		 * @private
		 */
		public function set screenClass(value:Class):void
		{
			if(this._screenClass === value)
			{
				return;
			}
			this._screenClass = value;
			if(value !== null)
			{
				this.screenFunction = null;
				this.screenDisplayObject = null;
			}
		}

		/**
		 * @private
		 */
		protected var _screenFunction:Function;

		/**
		 * A <code>Function</code> that may be called to return a
		 * <code>DisplayObject</code> instance to display when the associated
		 * tab is selected. A new instance of the screen will be instantiated
		 * every time that it is shown by the <code>TabNavigator</code>. The
		 * screen's state will not be saved automatically, but it may be saved
		 * in <code>properties</code>, if needed.
		 *
		 * @default null
		 *
		 * @see #screenClass
		 * @see #screenDisplayObject
		 */
		public function get screenFunction():Function
		{
			return this._screenFunction;
		}

		/**
		 * @private
		 */
		public function set screenFunction(value:Function):void
		{
			if(this._screenFunction === value)
			{
				return;
			}
			this._screenFunction = value;
			if(value !== null)
			{
				this.screenClass = null;
				this.screenDisplayObject = null;
			}
		}

		/**
		 * @private
		 */
		protected var _screenDisplayObject:DisplayObject;

		/**
		 * A display object to be displayed by the <code>TabNavigator</code>
		 * when the associted tab is selected. The same instance will be reused
		 * every time that it is shown by the <code>TabNavigator</code>. Whe
		 * the screen is hidden and shown again, its state will remain the same
		 * as when it was hidden. However, the screen will also be kept in
		 * memory even when it isn't displayed, limiting the resources that are
		 * available for other views.
		 *
		 * <p>Using <code>screenClass</code> or <code>screenFunction</code>
		 * instead of <code>screenDisplayObject</code> is the recommended best
		 * practice. In general, <code>screenDisplayObject</code> should only be
		 * used in rare situations where instantiating a new screen would be
		 * extremely expensive.</p>
		 *
		 * @default null
		 *
		 * @see #screenClass
		 * @see #screenFunction
		 */
		public function get screenDisplayObject():DisplayObject
		{
			return this._screenDisplayObject;
		}

		/**
		 * @private
		 */
		public function set screenDisplayObject(value:DisplayObject):void
		{
			if(this._screenDisplayObject === value)
			{
				return;
			}
			this._screenDisplayObject = value;
			if(value !== null)
			{
				this.screenClass = null;
				this.screenFunction = null;
			}
		}

		/**
		 * @private
		 */
		protected var _label:String;

		/**
		 * The label to display on the tab.
		 */
		public function get label():String
		{
			return this._label;
		}

		/**
		 * @private
		 */
		public function set label(value:String):void
		{
			this._label = value;
		}

		/**
		 * @private
		 */
		protected var _icon:DisplayObject;

		/**
		 * The optional icon to display on the tab.
		 */
		public function get icon():DisplayObject
		{
			return this._icon;
		}

		/**
		 * @private
		 */
		public function set icon(value:DisplayObject):void
		{
			this._icon = value;
		}

		/**
		 * @private
		 */
		protected var _properties:Object;

		/**
		 * A set of key-value pairs representing properties to be set on the
		 * screen when it is shown. A pair's key is the name of the screen's
		 * property, and a pair's value is the value to be passed to the
		 * screen's property.
		 */
		public function get properties():Object
		{
			return this._properties;
		}

		/**
		 * @private
		 */
		public function set properties(value:Object):void
		{
			if(!value)
			{
				value = {};
			}
			this._properties = value;
		}

		/**
		 * @private
		 */
		protected var _transition:Function;

		/**
		 * A custom transition for this screen only. If <code>null</code>,
		 * the default <code>transition</code> defined by the
		 * <code>TabNavigator</code> will be used.
		 *
		 * <p>In the following example, the tab navigator item is given a custom
		 * transition:</p>
		 *
		 * <listing version="3.0">
		 * item.transition = Fade.createFadeInTransition();</listing>
		 *
		 * <p>A number of animated transitions may be found in the
		 * <a href="../motion/package-detail.html">feathers.motion</a> package.
		 * However, you are not limited to only these transitions. It's possible
		 * to create custom transitions too.</p>
		 *
		 * <p>A custom transition function should have the following signature:</p>
		 * <pre>function(oldScreen:DisplayObject, newScreen:DisplayObject, completeCallback:Function):void</pre>
		 *
		 * <p>Either of the <code>oldScreen</code> and <code>newScreen</code>
		 * arguments may be <code>null</code>, but never both. The
		 * <code>oldScreen</code> argument will be <code>null</code> when the
		 * first screen is displayed or when a new screen is displayed after
		 * clearing the screen. The <code>newScreen</code> argument will
		 * be null when clearing the screen.</p>
		 *
		 * <p>The <code>completeCallback</code> function <em>must</em> be called
		 * when the transition effect finishes. This callback indicate to the
		 * tab navigator that the transition has finished. This function has
		 * the following signature:</p>
		 *
		 * <pre>function(cancelTransition:Boolean = false):void</pre>
		 *
		 * <p>The first argument defaults to <code>false</code>, meaning that
		 * the transition completed successfully. In most cases, this callback
		 * may be called without arguments. If a transition is cancelled before
		 * completion (perhaps through some kind of user interaction), and the
		 * previous screen should be restored, pass <code>true</code> as the
		 * first argument to the callback to inform the tab navigator that
		 * the transition is cancelled.</p>
		 *
		 * @default null
		 *
		 * @see feathers.controls.TabNavigator#transition
		 * @see ../../../help/transitions.html Transitions for Feathers screen navigators
		 */
		public function get transition():Function
		{
			return this._transition;
		}

		/**
		 * @private
		 */
		public function set transition(value:Function):void
		{
			this._transition = value;
		}

		/**
		 * @inheritDoc
		 */
		public function get canDispose():Boolean
		{
			return this._screenDisplayObject === null;
		}

		/**
		 * @private
		 */
		public function get transitionDelayEvent():String
		{
			return null;
		}

		/**
		 * @inheritDoc
		 */
		public function getScreen():DisplayObject
		{
			var viewInstance:DisplayObject;
			if(this._screenDisplayObject !== null)
			{
				viewInstance = this._screenDisplayObject;
			}
			else if(this._screenClass !== null)
			{
				var ViewType:Class = Class(this._screenClass);
				viewInstance = new ViewType();
			}
			else if(this._screenFunction !== null)
			{
				viewInstance = DisplayObject(this._screenFunction.call());
			}
			if(!(viewInstance is DisplayObject))
			{
				throw new ArgumentError("TabNavigatorItem \"getScreen()\" must return a Starling display object.");
			}
			if(this._properties)
			{
				for(var propertyName:String in this._properties)
				{
					viewInstance[propertyName] = this._properties[propertyName];
				}
			}

			return viewInstance;
		}
	}
}


================================================
FILE: source/feathers/controls/TextArea.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.text.ITextEditorViewPort;
	import feathers.controls.text.TextFieldTextEditorViewPort;
	import feathers.core.FeathersControl;
	import feathers.core.IAdvancedNativeFocusOwner;
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.INativeFocusOwner;
	import feathers.core.IStateContext;
	import feathers.core.IStateObserver;
	import feathers.core.ITextRenderer;
	import feathers.core.PopUpManager;
	import feathers.core.PropertyProxy;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;
	import feathers.text.FontStylesSet;

	import flash.events.KeyboardEvent;
	import flash.geom.Point;
	import flash.ui.Mouse;
	import flash.ui.MouseCursor;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.text.TextFormat;
	import starling.utils.Pool;

	/**
	 * A display object displayed behind the text area's content when it
	 * is disabled.
	 *
	 * <p>In the following example, the text area's disabled background skin
	 * is specified:</p>
	 *
	 * <listing version="3.0">
	 * textArea.isEnabled = false;
	 * textArea.backgroundDisabledSkin = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setSkinForState()</code> with
	 * <code>TextInputState.DISABLED</code> to set the same skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * textArea.setSkinForState( TextInputState.DISABLED, skin );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundSkin
	 * @see #setSkinForState()
	 */
	[Style(name="backgroundDisabledSkin",type="starling.display.DisplayObject")]

	/**
	 * A display object displayed behind the text area's content when it
	 * has focus.
	 *
	 * <p>In the following example, the text area's focused background skin is
	 * specified:</p>
	 *
	 * <listing version="3.0">
	 * textArea.backgroundFocusedSkin = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setSkinForState()</code> with
	 * <code>TextInputState.FOCUSED</code> to set the same skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * textArea.setSkinForState( TextInputState.FOCUSED, skin );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundSkin
	 * @see #setSkinForState()
	 */
	[Style(name="backgroundFocusedSkin",type="starling.display.DisplayObject")]

	/**
	 * The skin used for the text area's error state. If <code>null</code>,
	 * then <code>backgroundSkin</code> is used instead.
	 *
	 * <p>The following example gives the text area a skin for the error state:</p>
	 *
	 * <listing version="3.0">
	 * textArea.backgroundErrorSkin = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setSkinForState()</code> with
	 * <code>TextInputState.ERROR</code> to set the same skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * textArea.setSkinForState( TextInputState.ERROR, skin );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundSkin
	 * @see #setSkinForState()
	 */
	[Style(name="backgroundErrorSkin",type="starling.display.DisplayObject")]

	/**
	 * A style name to add to the text area's error callout sub-component.
	 * Typically used by a theme to provide different styles to different
	 * text areas.
	 *
	 * <p>In the following example, a custom error callout style name
	 * is passed to the text area:</p>
	 *
	 * <listing version="3.0">
	 * textArea.customErrorCalloutStyleName = "my-custom-text-area-error-callout";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Callout ).setFunctionForStyleName( "my-custom-text-area-error-callout", setCustomTextAreaErrorCalloutStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT
	 * @see feathers.core.FeathersControl#styleNameList
	 */
	[Style(name="customErrorCalloutStyleName",type="String")]

	/**
	 * A style name to add to the text area's prompt text renderer
	 * sub-component. Typically used by a theme to provide different styles
	 * to different text inputs.
	 *
	 * <p>In the following example, a custom prompt text renderer style name
	 * is passed to the text area:</p>
	 *
	 * <listing version="3.0">
	 * textArea.customPromptStyleName = "my-custom-text-area-prompt";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( BitmapFontTextRenderer ).setFunctionForStyleName( "my-custom-text-area-prompt", setCustomTextAreaPromptStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_PROMPT
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #promptFactory
	 */
	[Style(name="customPromptStyleName",type="String")]

	/**
	 * A style name to add to the text area's text editor sub-component.
	 * Typically used by a theme to provide different styles to different
	 * text areas.
	 *
	 * <p>In the following example, a custom text editor style name is
	 * passed to the text area:</p>
	 *
	 * <listing version="3.0">
	 * textArea.customTextEditorStyleName = "my-custom-text-area-text-editor";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( TextFieldTextEditorViewPort ).setFunctionForStyleName( "my-custom-text-area-text-editor", setCustomTextAreaTextEditorStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_TEXT_EDITOR
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #textEditorFactory
	 */
	[Style(name="customTextEditorStyleName",type="String")]

	/**
	 * The font styles used to display the text area's text when the text
	 * area is disabled.
	 *
	 * <p>In the following example, the disabled font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * textArea.disabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Alternatively, you may use <code>setFontStylesForState()</code> with
	 * <code>TextInputState.DISABLED</code> to set the same font styles:</p>
	 *
	 * <listing version="3.0">
	 * var fontStyles:TextFormat = new TextFormat( "Helvetica", 20, 0x999999 );
	 * textArea.setFontStylesForState( TextInputState.DISABLED, fontStyles );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text editor being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>textEditorFactory</code> to set more advanced styles on the
	 * text editor.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:fontStyles
	 * @see #setFontStylesForState()
	 */
	[Style(name="disabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the text area's text.
	 *
	 * <p>In the following example, the font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * textArea.fontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text editor being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>textEditorFactory</code> to set more advanced styles on the
	 * text editor.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:disabledFontStyles
	 * @see #setFontStylesForState()
	 */
	[Style(name="fontStyles",type="starling.text.TextFormat")]

	/**
	 * Quickly sets all inner padding properties to the same value. The
	 * <code>innerPadding</code> getter always returns the value of
	 * <code>innerPaddingTop</code>, but the other innert padding values may be
	 * different.
	 *
	 * <p>The following example gives the button 20 pixels of padding on all
	 * sides:</p>
	 *
	 * <listing version="3.0">
	 * textArea.innerPadding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:innerPaddingTop
	 * @see #style:innerPaddingRight
	 * @see #style:innerPaddingBottom
	 * @see #style:innerPaddingLeft
	 */
	[Style(name="innerPadding",type="Number")]

	/**
	 * The minimum space, in pixels, between the text area's top edge and the
	 * text area's content.
	 *
	 * <p>The following example gives the text area 20 pixels of inner padding
	 * on the top edge only:</p>
	 *
	 * <listing version="3.0">
	 * textArea.innerPaddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:innerPadding
	 */
	[Style(name="innerPaddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the text area's right edge and the
	 * text area's content.
	 *
	 * <p>The following example gives the text area 20 pixels of inner padding
	 * on the right edge only:</p>
	 *
	 * <listing version="3.0">
	 * textArea.innerPaddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:innerPadding
	 */
	[Style(name="innerPaddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the text area's bottom edge and the
	 * text area's content.
	 *
	 * <p>The following example gives the text area 20 pixels of inner padding
	 * on the bottom edge only:</p>
	 *
	 * <listing version="3.0">
	 * textArea.innerPaddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:innerPadding
	 */
	[Style(name="innerPaddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the text area's left edge and the
	 * text area's content.
	 *
	 * <p>The following example gives the text area 20 pixels of inner padding
	 * on the left edge only:</p>
	 *
	 * <listing version="3.0">
	 * textArea.innerPaddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:innerPadding
	 */
	[Style(name="innerPaddingLeft",type="Number")]

	/**
	 * The font styles used to display the text area's prompt when the text area
	 * is disabled.
	 *
	 * <p>In the following example, the disabled font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * textArea.promptDisabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>promptFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:promptFontStyles
	 * @see #setPromptFontStylesForState()
	 */
	[Style(name="promptDisabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the text area's prompt text.
	 *
	 * <p>In the following example, the font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * textArea.promptFontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>promptFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:promptDisabledFontStyles
	 * @see #setPromptFontStylesForState()
	 */
	[Style(name="promptFontStyles",type="starling.text.TextFormat")]

	/**
	 * Dispatched when the text area's <code>text</code> property changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #text
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the display object's state changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.STATE_CHANGE
	 *
	 * @see #currentState
	 */
	[Event(name="stateChange",type="starling.events.Event")]

	/**
	 * A text entry control that allows users to enter and edit multiple lines
	 * of uniformly-formatted text with the ability to scroll.
	 *
	 * <p>The following example sets the text in a text area, selects the text,
	 * and listens for when the text value changes:</p>
	 *
	 * <listing version="3.0">
	 * var textArea:TextArea = new TextArea();
	 * textArea.text = "Hello\nWorld"; //it's multiline!
	 * textArea.selectRange( 0, textArea.text.length );
	 * textArea.addEventListener( Event.CHANGE, textArea_changeHandler );
	 * this.addChild( textArea );</listing>
	 *
	 * @see ../../../help/text-area.html How to use the Feathers TextArea component
	 * @see feathers.controls.TextInput
	 *
	 * @productversion Feathers 1.1.0
	 */
	public class TextArea extends Scroller implements IAdvancedNativeFocusOwner, IStateContext
	{
		/**
		 * The default value added to the <code>styleNameList</code> of the text
		 * editor.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_TEXT_EDITOR:String = "feathers-text-area-text-editor";

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * prompt text renderer.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_PROMPT:String = "feathers-text-input-prompt";

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * error callout.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT:String = "feathers-text-area-error-callout";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_ERROR_CALLOUT_FACTORY:String = "errorCalloutFactory";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_PROMPT_FACTORY:String = "promptFactory";

		/**
		 * The default <code>IStyleProvider</code> for all <code>TextArea</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		private static function defaultErrorCalloutFactory():TextCallout
		{
			return new TextCallout();
		}

		/**
		 * Constructor.
		 */
		public function TextArea()
		{
			super();
			if(this._fontStylesSet === null)
			{
				this._fontStylesSet = new FontStylesSet();
				this._fontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
			if(this._promptFontStylesSet === null)
			{
				this._promptFontStylesSet = new FontStylesSet();
				this._promptFontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
			this._measureViewPort = false;
			this.addEventListener(TouchEvent.TOUCH, textArea_touchHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, textArea_removedFromStageHandler);
		}

		/**
		 * @private
		 */
		protected var textEditorViewPort:ITextEditorViewPort;

		/**
		 * The <code>TextCallout</code> that displays the value of the
		 * <code>errorString</code> property. The value may be <code>null</code>
		 * if there is no current error string or if the text area doesn't have
		 * focus.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected var callout:TextCallout;

		/**
		 * The prompt text renderer sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected var promptTextRenderer:ITextRenderer;

		/**
		 * The value added to the <code>styleNameList</code> of the text editor.
		 * This variable is <code>protected</code> so that sub-classes can
		 * customize the text editor style name in their constructors instead of
		 * using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_TEXT_EDITOR</code>.
		 *
		 * <p>To customize the text editor style name without subclassing, see
		 * <code>customTextEditorStyleName</code>.</p>
		 *
		 * @see #style:customTextEditorStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var textEditorStyleName:String = DEFAULT_CHILD_STYLE_NAME_TEXT_EDITOR;

		/**
		 * The value added to the <code>styleNameList</code> of the prompt text
		 * renderer. This variable is <code>protected</code> so that sub-classes
		 * can customize the prompt text renderer style name in their
		 * constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_PROMPT</code>.
		 *
		 * <p>To customize the prompt text renderer style name without
		 * subclassing, see <code>customPromptStyleName</code>.</p>
		 *
		 * @see #style:customPromptStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var promptStyleName:String = DEFAULT_CHILD_STYLE_NAME_PROMPT;

		/**
		 * The value added to the <code>styleNameList</code> of the error
		 * callout. This variable is <code>protected</code> so that sub-classes
		 * can customize the error callout text renderer style name in their
		 * constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT</code>.
		 *
		 * <p>To customize the error callout style name without subclassing, see
		 * <code>customErrorCalloutStyleName</code>.</p>
		 *
		 * @see #style:customErrorCalloutStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var errorCalloutStyleName:String = DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT;

		/**
		 * @private
		 */
		protected var _textEditorHasFocus:Boolean = false;

		/**
		 * A text editor may be an <code>INativeFocusOwner</code>, so we need to
		 * return the value of its <code>nativeFocus</code> property. If not,
		 * then we return <code>null</code>.
		 *
		 * @see feathers.core.INativeFocusOwner
		 */
		public function get nativeFocus():Object
		{
			if(this.textEditorViewPort is INativeFocusOwner)
			{
				return INativeFocusOwner(this.textEditorViewPort).nativeFocus;
			}
			return null;
		}

		/**
		 * @private
		 */
		protected var _isWaitingToSetFocus:Boolean = false;

		/**
		 * @private
		 */
		protected var _pendingSelectionBeginIndex:int = -1;

		/**
		 * @private
		 */
		protected var _pendingSelectionEndIndex:int = -1;

		/**
		 * @private
		 */
		protected var _textAreaTouchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _oldMouseCursor:String = null;

		/**
		 * @private
		 */
		protected var _ignoreTextChanges:Boolean = false;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return TextArea.globalStyleProvider;
		}

		/**
		 * @private
		 */
		override public function get isFocusEnabled():Boolean
		{
			if(this._isEditable)
			{
				//the behavior is different when editable.
				return this._isEnabled && this._isFocusEnabled;
			}
			return super.isFocusEnabled;
		}

		/**
		 * When the <code>FocusManager</code> isn't enabled, <code>hasFocus</code>
		 * can be used instead of <code>FocusManager.focus == textArea</code>
		 * to determine if the text area has focus.
		 */
		public function get hasFocus():Boolean
		{
			if(!this._focusManager)
			{
				return this._textEditorHasFocus;
			}
			return this._hasFocus;
		}

		/**
		 * @private
		 */
		override public function set isEnabled(value:Boolean):void
		{
			super.isEnabled = value;
			this.refreshState();
		}

		/**
		 * @private
		 */
		protected var _currentState:String = TextInputState.ENABLED;

		/**
		 * The current state of the text area.
		 *
		 * @see feathers.controls.TextInputState
		 * @see #event:stateChange feathers.events.FeathersEventType.STATE_CHANGE
		 */
		public function get currentState():String
		{
			return this._currentState;
		}

		/**
		 * @private
		 */
		protected var _text:String = "";

		/**
		 * The text displayed by the text area. The text area dispatches
		 * <code>Event.CHANGE</code> when the value of the <code>text</code>
		 * property changes for any reason.
		 *
		 * <p>In the following example, the text area's text is updated:</p>
		 *
		 * <listing version="3.0">
		 * textArea.text = "Hello World";</listing>
		 *
		 * @see #event:change
		 *
		 * @default ""
		 */
		public function get text():String
		{
			return this._text;
		}

		/**
		 * @private
		 */
		public function set text(value:String):void
		{
			if(!value)
			{
				//don't allow null or undefined
				value = "";
			}
			if(this._text == value)
			{
				return;
			}
			this._text = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _prompt:String = null;

		/**
		 * The prompt, hint, or description text displayed by the text area when
		 * the value of its text is empty.
		 *
		 * <p>In the following example, the text area's prompt is updated:</p>
		 *
		 * <listing version="3.0">
		 * textArea.prompt = "User Name";</listing>
		 *
		 * @default null
		 */
		public function get prompt():String
		{
			return this._prompt;
		}

		/**
		 * @private
		 */
		public function set prompt(value:String):void
		{
			if(this._prompt == value)
			{
				return;
			}
			this._prompt = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _maxChars:int = 0;

		/**
		 * The maximum number of characters that may be entered.
		 *
		 * <p>In the following example, the text area's maximum characters is
		 * specified:</p>
		 *
		 * <listing version="3.0">
		 * textArea.maxChars = 10;</listing>
		 *
		 * @default 0
		 */
		public function get maxChars():int
		{
			return this._maxChars;
		}

		/**
		 * @private
		 */
		public function set maxChars(value:int):void
		{
			if(this._maxChars == value)
			{
				return;
			}
			this._maxChars = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _restrict:String;

		/**
		 * Limits the set of characters that may be entered.
		 *
		 * <p>In the following example, the text area's allowed characters are
		 * restricted:</p>
		 *
		 * <listing version="3.0">
		 * textArea.restrict = "0-9;</listing>
		 *
		 * @default null
		 */
		public function get restrict():String
		{
			return this._restrict;
		}

		/**
		 * @private
		 */
		public function set restrict(value:String):void
		{
			if(this._restrict == value)
			{
				return;
			}
			this._restrict = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isEditable:Boolean = true;

		/**
		 * Determines if the text area is editable. If the text area is not
		 * editable, it will still appear enabled.
		 *
		 * <p>In the following example, the text area is not editable:</p>
		 *
		 * <listing version="3.0">
		 * textArea.isEditable = false;</listing>
		 *
		 * @default true
		 */
		public function get isEditable():Boolean
		{
			return this._isEditable;
		}

		/**
		 * @private
		 */
		public function set isEditable(value:Boolean):void
		{
			if(this._isEditable == value)
			{
				return;
			}
			this._isEditable = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _errorString:String = null;

		/**
		 * Error text to display in a <code>Callout</code> when the text area
		 * has focus. When this value is not <code>null</code> the text area's
		 * state is changed to <code>TextInputState.ERROR</code>.
		 *
		 * An empty string will change the background, but no
		 * <code>Callout</code> will appear on focus.
		 *
		 * To clear an error, the <code>errorString</code> property must be set
		 * to <code>null</code>
		 *
		 * <p>The following example displays an error string:</p>
		 *
		 * <listing version="3.0">
		 * textArea.errorString = "Something is wrong";</listing>
		 *
		 * @default null
		 *
		 * @see #currentState
		 */
		public function get errorString():String
		{
			return this._errorString;
		}

		/**
		 * @private
		 */
		public function set errorString(value:String):void
		{
			if(this._errorString === value)
			{
				return;
			}
			this._errorString = value;
			this.refreshState();
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _stateToSkin:Object = {};

		/**
		 * @private
		 */
		override public function get backgroundDisabledSkin():DisplayObject
		{
			return this.getSkinForState(TextInputState.DISABLED);
		}

		/**
		 * @private
		 */
		override public function set backgroundDisabledSkin(value:DisplayObject):void
		{
			this.setSkinForState(TextInputState.DISABLED, value);
		}

		/**
		 * @private
		 */
		public function get backgroundFocusedSkin():DisplayObject
		{
			return this.getSkinForState(TextInputState.FOCUSED);
		}

		/**
		 * @private
		 */
		public function set backgroundFocusedSkin(value:DisplayObject):void
		{
			this.setSkinForState(TextInputState.FOCUSED, value);
		}

		/**
		 * @private
		 */
		public function get backgroundErrorSkin():DisplayObject
		{
			return this.getSkinForState(TextInputState.ERROR);
		}

		/**
		 * @private
		 */
		public function set backgroundErrorSkin(value:DisplayObject):void
		{
			this.setSkinForState(TextInputState.ERROR, value);
		}

		/**
		 * @private
		 */
		protected var _fontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get fontStyles():TextFormat
		{
			return this._fontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set fontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get disabledFontStyles():TextFormat
		{
			return this._fontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set disabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _textEditorFactory:Function;

		/**
		 * A function used to instantiate the text editor view port. If
		 * <code>null</code>, a <code>TextFieldTextEditorViewPort</code> will
		 * be instantiated. The text editor must be an instance of
		 * <code>ITextEditorViewPort</code>. This factory can be used to change
		 * properties on the text editor view port when it is first created. For
		 * instance, if you are skinning Feathers components without a theme,
		 * you might use this factory to set styles on the text editor view
		 * port.
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():ITextEditorViewPort</pre>
		 *
		 * <p>In the following example, a custom text editor factory is passed
		 * to the text area:</p>
		 *
		 * <listing version="3.0">
		 * textArea.textEditorFactory = function():ITextEditorViewPort
		 * {
		 *     return new TextFieldTextEditorViewPort();
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.text.ITextEditorViewPort
		 */
		public function get textEditorFactory():Function
		{
			return this._textEditorFactory;
		}

		/**
		 * @private
		 */
		public function set textEditorFactory(value:Function):void
		{
			if(this._textEditorFactory == value)
			{
				return;
			}
			this._textEditorFactory = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_EDITOR);
		}

		/**
		 * @private
		 */
		protected var _customTextEditorStyleName:String;

		/**
		 * @private
		 */
		public function get customTextEditorStyleName():String
		{
			return this._customTextEditorStyleName;
		}

		/**
		 * @private
		 */
		public function set customTextEditorStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customTextEditorStyleName === value)
			{
				return;
			}
			this._customTextEditorStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _textEditorProperties:PropertyProxy;

		/**
		 * An object that stores properties for the text area's text editor
		 * sub-component, and the properties will be passed down to the
		 * text editor when the text area validates. The available properties
		 * depend on which <code>ITextEditorViewPort</code> implementation is
		 * returned by <code>textEditorFactory</code>. Refer to
		 * <a href="text/ITextEditorViewPort.html"><code>feathers.controls.text.ITextEditorViewPort</code></a>
		 * for a list of available text editor implementations for text area.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>textEditorFactory</code> function
		 * instead of using <code>textEditorProperties</code> will result in
		 * better performance.</p>
		 *
		 * <p>In the following example, the text input's text editor properties
		 * are specified (this example assumes that the text editor is a
		 * <code>TextFieldTextEditorViewPort</code>):</p>
		 *
		 * <listing version="3.0">
		 * textArea.textEditorProperties.textFormat = new TextFormat( "Source Sans Pro", 16, 0x333333);
		 * textArea.textEditorProperties.embedFonts = true;</listing>
		 *
		 * @default null
		 *
		 * @see #textEditorFactory
		 * @see feathers.controls.text.ITextEditorViewPort
		 */
		public function get textEditorProperties():Object
		{
			if(!this._textEditorProperties)
			{
				this._textEditorProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._textEditorProperties;
		}

		/**
		 * @private
		 */
		public function set textEditorProperties(value:Object):void
		{
			if(this._textEditorProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._textEditorProperties)
			{
				this._textEditorProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._textEditorProperties = PropertyProxy(value);
			if(this._textEditorProperties)
			{
				this._textEditorProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _promptFontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get promptFontStyles():TextFormat
		{
			return this._promptFontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set promptFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._promptFontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._promptFontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get promptDisabledFontStyles():TextFormat
		{
			return this._promptFontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set promptDisabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._promptFontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._promptFontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _promptFactory:Function;

		/**
		 * A function used to instantiate the prompt text renderer. If null,
		 * <code>FeathersControl.defaultTextRendererFactory</code> is used
		 * instead. The prompt text renderer must be an instance of
		 * <code>ITextRenderer</code>. This factory can be used to change
		 * properties on the prompt when it is first created. For instance, if
		 * you are skinning Feathers components without a theme, you might use
		 * this factory to set styles on the prompt.
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():ITextRenderer</pre>
		 *
		 * <p>If the <code>prompt</code> property is <code>null</code>, the
		 * prompt text renderer will not be created.</p>
		 *
		 * <p>In the following example, a custom prompt factory is passed to the
		 * text input:</p>
		 *
		 * <listing version="3.0">
		 * input.promptFactory = function():ITextRenderer
		 * {
		 *     return new TextFieldTextRenderer();
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #prompt
		 * @see feathers.core.ITextRenderer
		 * @see feathers.core.FeathersControl#defaultTextRendererFactory
		 */
		public function get promptFactory():Function
		{
			return this._promptFactory;
		}

		/**
		 * @private
		 */
		public function set promptFactory(value:Function):void
		{
			if(this._promptFactory == value)
			{
				return;
			}
			this._promptFactory = value;
			this.invalidate(INVALIDATION_FLAG_PROMPT_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customPromptStyleName:String;

		/**
		 * @private
		 */
		public function get customPromptStyleName():String
		{
			return this._customPromptStyleName;
		}

		/**
		 * @private
		 */
		public function set customPromptStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customPromptStyleName === value)
			{
				return;
			}
			this._customPromptStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}
		
		/**
		 * @private
		 */
		protected var _errorCalloutFactory:Function;
		
		/**
		 * A function used to instantiate the error text callout. If null,
		 * <code>new TextCallout()</code> is used instead.
		 * The error text callout must be an instance of
		 * <code>TextCallout</code>. This factory can be used to change
		 * properties on the callout when it is first created. For instance, if
		 * you are skinning Feathers components without a theme, you might use
		 * this factory to set styles on the callout.
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():TextCallout</pre>
		 *
		 * <p>In the following example, a custom error callout factory is passed
		 * to the text area:</p>
		 *
		 * <listing version="3.0">
		 * textArea.errorCalloutFactory = function():TextCallout
		 * {
		 *     return new TextCallout();
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #errorString
		 * @see feathers.controls.TextCallout
		 */
		public function get errorCalloutFactory():Function
		{
			return this._errorCalloutFactory;
		}
		
		public function set errorCalloutFactory(value:Function):void
		{
			if(this._errorCalloutFactory == value)
			{
				return;
			}
			this._errorCalloutFactory = value;
			this.invalidate(INVALIDATION_FLAG_ERROR_CALLOUT_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customErrorCalloutStyleName:String;

		/**
		 * @private
		 */
		public function get customErrorCalloutStyleName():String
		{
			return this._customErrorCalloutStyleName;
		}

		/**
		 * @private
		 */
		public function set customErrorCalloutStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customErrorCalloutStyleName === value)
			{
				return;
			}
			this._customErrorCalloutStyleName = value;
			this.invalidate(INVALIDATION_FLAG_ERROR_CALLOUT_FACTORY);
		}

		/**
		 * @private
		 */
		public function get innerPadding():Number
		{
			return this._innerPaddingTop;
		}

		/**
		 * @private
		 */
		public function set innerPadding(value:Number):void
		{
			this.innerPaddingTop = value;
			this.innerPaddingRight = value;
			this.innerPaddingBottom = value;
			this.innerPaddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _innerPaddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get innerPaddingTop():Number
		{
			return this._innerPaddingTop;
		}

		/**
		 * @private
		 */
		public function set innerPaddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._innerPaddingTop == value)
			{
				return;
			}
			this._innerPaddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _innerPaddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get innerPaddingRight():Number
		{
			return this._innerPaddingRight;
		}

		/**
		 * @private
		 */
		public function set innerPaddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._innerPaddingRight == value)
			{
				return;
			}
			this._innerPaddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _innerPaddingBottom:Number = 0;

		/**
		 * @private
		 */
		[Deprecated(since="4.2.0",replacement="innerPaddingBottom")]
		public function get paddinnerPaddingBottomingBottom():Number
		{
			return this._innerPaddingBottom;
		}

		/**
		 * @private
		 */
		public function get innerPaddingBottom():Number
		{
			return this._innerPaddingBottom;
		}

		/**
		 * @private
		 */
		public function set innerPaddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._innerPaddingBottom == value)
			{
				return;
			}
			this._innerPaddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _innerPaddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get innerPaddingLeft():Number
		{
			return this._innerPaddingLeft;
		}

		/**
		 * @private
		 */
		public function set innerPaddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._innerPaddingLeft == value)
			{
				return;
			}
			this._innerPaddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @copy feathers.core.ITextEditor#selectionBeginIndex
		 */
		public function get selectionBeginIndex():int
		{
			if(this._pendingSelectionBeginIndex >= 0)
			{
				return this._pendingSelectionBeginIndex;
			}
			if(this.textEditorViewPort)
			{
				return this.textEditorViewPort.selectionBeginIndex;
			}
			return 0;
		}

		/**
		 * @copy feathers.core.ITextEditor#selectionEndIndex
		 */
		public function get selectionEndIndex():int
		{
			if(this._pendingSelectionEndIndex >= 0)
			{
				return this._pendingSelectionEndIndex;
			}
			if(this.textEditorViewPort)
			{
				return this.textEditorViewPort.selectionEndIndex;
			}
			return 0;
		}

		/**
		 * Focuses the text area control so that it may be edited.
		 */
		public function setFocus():void
		{
			if(this._textEditorHasFocus)
			{
				return;
			}
			if(this.textEditorViewPort)
			{
				this._isWaitingToSetFocus = false;
				this.textEditorViewPort.setFocus();
			}
			else
			{
				this._isWaitingToSetFocus = true;
				this.invalidate(INVALIDATION_FLAG_SELECTED);
			}
		}

		/**
		 * Manually removes focus from the text area control.
		 */
		public function clearFocus():void
		{
			this._isWaitingToSetFocus = false;
			if(!this.textEditorViewPort || !this._textEditorHasFocus)
			{
				return;
			}
			this.textEditorViewPort.clearFocus();
		}

		/**
		 * Sets the range of selected characters. If both values are the same,
		 * or the end index is <code>-1</code>, the text insertion position is
		 * changed and nothing is selected.
		 */
		public function selectRange(beginIndex:int, endIndex:int = -1):void
		{
			if(endIndex < 0)
			{
				endIndex = beginIndex;
			}
			if(beginIndex < 0)
			{
				throw new RangeError("Expected begin index greater than or equal to 0. Received " + beginIndex + ".");
			}
			if(endIndex > this._text.length)
			{
				throw new RangeError("Expected begin index less than " + this._text.length + ". Received " + endIndex + ".");
			}

			//if it's invalid, we need to wait until validation before changing
			//the selection
			if(this.textEditorViewPort !== null && (this._isValidating || !this.isInvalid()))
			{
				this._pendingSelectionBeginIndex = -1;
				this._pendingSelectionEndIndex = -1;
				this.textEditorViewPort.selectRange(beginIndex, endIndex);
			}
			else
			{
				this._pendingSelectionBeginIndex = beginIndex;
				this._pendingSelectionEndIndex = endIndex;
				this.invalidate(INVALIDATION_FLAG_SELECTED);
			}
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			//we don't dispose it if the text area is the parent because it'll
			//already get disposed in super.dispose()
			for(var state:String in this._stateToSkin)
			{
				var skin:DisplayObject = this._stateToSkin[state] as DisplayObject;
				if(skin !== null && skin.parent !== this)
				{
					skin.dispose();
				}
			}
			if(this._fontStylesSet !== null)
			{
				this._fontStylesSet.dispose();
				this._fontStylesSet = null;
			}
			if(this._promptFontStylesSet !== null)
			{
				this._promptFontStylesSet.dispose();
				this._promptFontStylesSet = null;
			}
			super.dispose();
		}

		/**
		 * Gets the font styles to be used to display the text area's text when
		 * the text area's <code>currentState</code> property matches the
		 * specified state value.
		 *
		 * <p>If font styles are not defined for a specific state, returns
		 * <code>null</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #setFontStylesForState()
		 * @see #style:fontStyles
		 */
		public function getFontStylesForState(state:String):TextFormat
		{
			if(this._fontStylesSet === null)
			{
				return null;
			}
			return this._fontStylesSet.getFormatForState(state);
		}

		/**
		 * Sets the font styles to be used to display the text area's text when
		 * the text area's <code>currentState</code> property matches the
		 * specified state value.
		 *
		 * <p>If font styles are not defined for a specific state, the value of
		 * the <code>fontStyles</code> property will be used instead.</p>
		 *
		 * <p>Note: if the text editor has been customized with advanced font
		 * formatting, it may override the values specified with
		 * <code>setFontStylesForState()</code> and properties like
		 * <code>fontStyles</code> and <code>disabledFontStyles</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #style:fontStyles
		 */
		public function setFontStylesForState(state:String, format:TextFormat):void
		{
			var key:String = "setFontStylesForState--" + state;
			if(this.processStyleRestriction(key))
			{
				return;
			}
			function changeHandler(event:Event):void
			{
				processStyleRestriction(key);
			}
			var oldFormat:TextFormat = this._fontStylesSet.getFormatForState(state);
			if(oldFormat !== null)
			{
				oldFormat.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.setFormatForState(state, format);
			if(format !== null)
			{
				format.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * Gets the font styles to be used to display the text area's prompt
		 * when the text area's <code>currentState</code> property matches the
		 * specified state value.
		 *
		 * <p>If prompt font styles are not defined for a specific state, returns
		 * <code>null</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #setPromptFontStylesForState()
		 * @see #promptFontStyles
		 */
		public function getPromptFontStylesForState(state:String):TextFormat
		{
			if(this._promptFontStylesSet === null)
			{
				return null;
			}
			return this._promptFontStylesSet.getFormatForState(state);
		}

		/**
		 * Sets the font styles to be used to display the text area's prompt
		 * when the text area's <code>currentState</code> property matches the
		 * specified state value.
		 *
		 * <p>If prompt font styles are not defined for a specific state, the
		 * value of the <code>promptFontStyles</code> property will be used instead.</p>
		 *
		 * <p>Note: if the text renderer has been customized with advanced font
		 * formatting, it may override the values specified with
		 * <code>setPromptFontStylesForState()</code> and properties like
		 * <code>promptFontStyles</code> and <code>promptDisabledFontStyles</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #promptFontStyles
		 */
		public function setPromptFontStylesForState(state:String, format:TextFormat):void
		{
			var key:String = "setPromptFontStylesForState--" + state;
			if(this.processStyleRestriction(key))
			{
				return;
			}
			function changeHandler(event:Event):void
			{
				processStyleRestriction(key);
			}
			var oldFormat:TextFormat = this._promptFontStylesSet.getFormatForState(state);
			if(oldFormat !== null)
			{
				oldFormat.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._promptFontStylesSet.setFormatForState(state, format);
			if(format !== null)
			{
				format.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * Gets the skin to be used by the text area when its
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If a skin is not defined for a specific state, returns
		 * <code>null</code>.</p>
		 *
		 * @see #setSkinForState()
		 * @see feathers.controls.TextInputState
		 */
		public function getSkinForState(state:String):DisplayObject
		{
			return this._stateToSkin[state] as DisplayObject;
		}

		/**
		 * Sets the skin to be used by the text area when its
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If a skin is not defined for a specific state, the value of the
		 * <code>backgroundSkin</code> property will be used instead.</p>
		 *
		 * @see #backgroundSkin
		 * @see #getSkinForState()
		 * @see feathers.controls.TextInputState
		 */
		public function setSkinForState(state:String, skin:DisplayObject):void
		{
			var key:String = "setSkinForState--" + state;
			if(this.processStyleRestriction(key))
			{
				if(skin !== null)
				{
					skin.dispose();
				}
				return;
			}
			if(skin !== null)
			{
				this._stateToSkin[state] = skin;
			}
			else
			{
				delete this._stateToSkin[state];
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var textEditorInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_TEXT_EDITOR);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var promptFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_PROMPT_FACTORY);

			if(textEditorInvalid)
			{
				this.createTextEditor();
			}

			if(promptFactoryInvalid || (this._prompt !== null && !this.promptTextRenderer))
			{
				this.createPrompt();
			}

			if(textEditorInvalid || stylesInvalid)
			{
				this.refreshTextEditorProperties();
			}

			if(textEditorInvalid || dataInvalid)
			{
				var oldIgnoreTextChanges:Boolean = this._ignoreTextChanges;
				this._ignoreTextChanges = true;
				this.textEditorViewPort.text = this._text;
				this._ignoreTextChanges = oldIgnoreTextChanges;
			}

			if(promptFactoryInvalid || stylesInvalid)
			{
				this.refreshPromptProperties();
			}

			if(this.promptTextRenderer)
			{
				if(promptFactoryInvalid || dataInvalid || stylesInvalid)
				{
					this.promptTextRenderer.visible = this._prompt && this._text.length == 0;
				}

				if(promptFactoryInvalid || stateInvalid)
				{
					this.promptTextRenderer.isEnabled = this._isEnabled;
				}
			}

			if(textEditorInvalid || stateInvalid)
			{
				this.textEditorViewPort.isEnabled = this._isEnabled;
				if(!this._isEnabled && Mouse.supportsNativeCursor && this._oldMouseCursor)
				{
					Mouse.cursor = this._oldMouseCursor;
					this._oldMouseCursor = null;
				}
			}

			super.draw();

			//the state might not change if the text input has focus when
			//the error string changes, so check for styles too!
			if(stateInvalid || stylesInvalid)
			{
				this.refreshErrorCallout();
			}

			this.doPendingActions();
		}

		/**
		 * Creates and adds the <code>textEditorViewPort</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #textEditorViewPort
		 * @see #textEditorFactory
		 */
		protected function createTextEditor():void
		{
			if(this.textEditorViewPort)
			{
				this.textEditorViewPort.removeEventListener(Event.CHANGE, textEditor_changeHandler);
				this.textEditorViewPort.removeEventListener(FeathersEventType.FOCUS_IN, textEditor_focusInHandler);
				this.textEditorViewPort.removeEventListener(FeathersEventType.FOCUS_OUT, textEditor_focusOutHandler);
				this.textEditorViewPort = null;
			}

			if(this._textEditorFactory != null)
			{
				this.textEditorViewPort = ITextEditorViewPort(this._textEditorFactory());
			}
			else
			{
				this.textEditorViewPort = new TextFieldTextEditorViewPort();
			}
			var textEditorStyleName:String = this._customTextEditorStyleName != null ? this._customTextEditorStyleName : this.textEditorStyleName;
			this.textEditorViewPort.styleNameList.add(textEditorStyleName);
			if(this.textEditorViewPort is IStateObserver)
			{
				IStateObserver(this.textEditorViewPort).stateContext = this;
			}
			this.textEditorViewPort.addEventListener(Event.CHANGE, textEditor_changeHandler);
			this.textEditorViewPort.addEventListener(FeathersEventType.FOCUS_IN, textEditor_focusInHandler);
			this.textEditorViewPort.addEventListener(FeathersEventType.FOCUS_OUT, textEditor_focusOutHandler);

			var oldViewPort:ITextEditorViewPort = ITextEditorViewPort(this._viewPort);
			this.viewPort = this.textEditorViewPort;
			if(oldViewPort)
			{
				//the view port setter won't do this
				oldViewPort.dispose();
			}
		}

		/**
		 * @private
		 */
		protected function createPrompt():void
		{
			if(this.promptTextRenderer)
			{
				this.removeChild(DisplayObject(this.promptTextRenderer), true);
				this.promptTextRenderer = null;
			}

			if(this._prompt === null)
			{
				return;
			}

			var factory:Function = this._promptFactory != null ? this._promptFactory : FeathersControl.defaultTextRendererFactory;
			this.promptTextRenderer = ITextRenderer(factory());
			var promptStyleName:String = this._customPromptStyleName != null ? this._customPromptStyleName : this.promptStyleName;
			this.promptTextRenderer.styleNameList.add(promptStyleName);
			this.addChild(DisplayObject(this.promptTextRenderer));
		}

		/**
		 * @private
		 */
		protected function createErrorCallout():void
		{
			if(this.callout !== null)
			{
				this.callout.removeFromParent(true);
				this.callout = null;
			}

			if(this._errorString === null)
			{
				return;
			}
 			var factory:Function = this._errorCalloutFactory != null ? this._errorCalloutFactory : defaultErrorCalloutFactory;
 			this.callout = TextCallout(factory());
			var errorCalloutStyleName:String = this._customErrorCalloutStyleName != null ? this._customErrorCalloutStyleName : this.errorCalloutStyleName;
			this.callout.styleNameList.add(errorCalloutStyleName);
			this.callout.closeOnKeys = null;
			this.callout.closeOnTouchBeganOutside = false;
			this.callout.closeOnTouchEndedOutside = false;
			this.callout.touchable = false;
			this.callout.origin = this;
			PopUpManager.addPopUp(this.callout, false, false);
		}

		/**
		 * @private
		 */
		protected function changeState(state:String):void
		{
			if(this._currentState === state)
			{
				return;
			}
			this._currentState = state;
			this.invalidate(INVALIDATION_FLAG_STATE);
			this.dispatchEventWith(FeathersEventType.STATE_CHANGE);
		}

		/**
		 * @private
		 */
		protected function doPendingActions():void
		{
			if(this._isWaitingToSetFocus || (this._focusManager && this._focusManager.focus == this))
			{
				this._isWaitingToSetFocus = false;
				if(!this._textEditorHasFocus)
				{
					this.textEditorViewPort.setFocus();
				}
			}
			if(this._pendingSelectionBeginIndex >= 0)
			{
				var beginIndex:int = this._pendingSelectionBeginIndex;
				var endIndex:int = this._pendingSelectionEndIndex;
				this._pendingSelectionBeginIndex = -1;
				this._pendingSelectionEndIndex = -1;
				this.selectRange(beginIndex, endIndex);
			}
		}

		/**
		 * @private
		 */
		protected function refreshTextEditorProperties():void
		{
			this.textEditorViewPort.fontStyles = this._fontStylesSet;
			this.textEditorViewPort.maxChars = this._maxChars;
			this.textEditorViewPort.restrict = this._restrict;
			this.textEditorViewPort.isEditable = this._isEditable;
			this.textEditorViewPort.paddingTop = this._innerPaddingTop;
			this.textEditorViewPort.paddingRight = this._innerPaddingRight;
			this.textEditorViewPort.paddingBottom = this._innerPaddingBottom;
			this.textEditorViewPort.paddingLeft = this._innerPaddingLeft;
			for(var propertyName:String in this._textEditorProperties)
			{
				var propertyValue:Object = this._textEditorProperties[propertyName];
				this.textEditorViewPort[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function refreshPromptProperties():void
		{
			if(!this.promptTextRenderer)
			{
				return;
			}
			this.promptTextRenderer.text = this._prompt;
			this.promptTextRenderer.fontStyles = this._promptFontStylesSet;
		}

		/**
		 * @private
		 */
		override protected function refreshBackgroundSkin():void
		{
			var oldSkin:DisplayObject = this.currentBackgroundSkin;
			this.currentBackgroundSkin = this.getCurrentBackgroundSkin();
			if(oldSkin !== this.currentBackgroundSkin)
			{
				if(oldSkin !== null)
				{
					if(oldSkin is IStateObserver)
					{
						IStateObserver(oldSkin).stateContext = null;
					}
					this.removeChild(oldSkin, false);
				}
				if(this.currentBackgroundSkin !== null)
				{
					if(this.currentBackgroundSkin is IStateObserver)
					{
						IStateObserver(this.currentBackgroundSkin).stateContext = this;
					}
					this.addChildAt(this.currentBackgroundSkin, 0);
					if(this.currentBackgroundSkin is IFeathersControl)
					{
						IFeathersControl(this.currentBackgroundSkin).initializeNow();
					}
					if(this.currentBackgroundSkin is IMeasureDisplayObject)
					{
						var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this.currentBackgroundSkin);
						this._explicitBackgroundWidth = measureSkin.explicitWidth;
						this._explicitBackgroundHeight = measureSkin.explicitHeight;
						this._explicitBackgroundMinWidth = measureSkin.explicitMinWidth;
						this._explicitBackgroundMinHeight = measureSkin.explicitMinHeight;
					}
					else
					{
						this._explicitBackgroundWidth = this.currentBackgroundSkin.width;
						this._explicitBackgroundHeight = this.currentBackgroundSkin.height;
						this._explicitBackgroundMinWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMinHeight = this._explicitBackgroundHeight;
					}
				}
			}
		}

		/**
		 * @private
		 */
		override protected function getCurrentBackgroundSkin():DisplayObject
		{
			var result:DisplayObject = this._stateToSkin[this._currentState] as DisplayObject;
			if(result !== null)
			{
				return result;
			}
			return this._backgroundSkin;
		}

		/**
		 * @private
		 */
		protected function refreshState():void
		{
			if(this._isEnabled)
			{
				if(this._textEditorHasFocus)
				{
					this.changeState(TextInputState.FOCUSED);
				}
				else if(this._errorString !== null)
				{
					this.changeState(TextInputState.ERROR);
				}
				else
				{
					this.changeState(TextInputState.ENABLED);
				}
			}
			else
			{
				this.changeState(TextInputState.DISABLED);
			}
		}

		/**
		 * @private
		 */
		protected function refreshErrorCallout():void
		{
			if(this._textEditorHasFocus && this.callout === null &&
				this._errorString !== null && this._errorString.length > 0)
			{
				this.createErrorCallout();
			}
			else if(this.callout !== null &&
				(!this._textEditorHasFocus || this._errorString === null || this._errorString.length == 0))
			{
				this.callout.removeFromParent(true);
				this.callout = null;
			}
			if(this.callout !== null)
			{
				this.callout.text = this._errorString;
			}
		}

		/**
		 * @private
		 */
		override protected function layoutChildren():void
		{
			super.layoutChildren();

			if(this.promptTextRenderer !== null)
			{
				this.promptTextRenderer.x = this._leftViewPortOffset + this._innerPaddingLeft;
				this.promptTextRenderer.y = this._topViewPortOffset + this._innerPaddingTop;
				this.promptTextRenderer.width = this.actualWidth - this._leftViewPortOffset - this._rightViewPortOffset - this._innerPaddingLeft - this._innerPaddingRight;
				this.promptTextRenderer.height = this.actualHeight - this._topViewPortOffset - this._bottomViewPortOffset - this._innerPaddingTop - this._innerPaddingBottom;
			}
		}

		/**
		 * @private
		 */
		protected function setFocusOnTextEditorWithTouch(touch:Touch):void
		{
			if(!this.isFocusEnabled)
			{
				return;
			}
			var point:Point = Pool.getPoint();
			touch.getLocation(this.stage, point);
			var isInBounds:Boolean = this.contains(this.stage.hitTest(point));
			if(!this._textEditorHasFocus && isInBounds)
			{
				this.globalToLocal(point, point);
				point.x -= this._paddingLeft;
				point.y -= this._paddingTop;
				//we account for the scroll position in the text editor view
				//port, so don't do it here!
				this._isWaitingToSetFocus = false;
				this.textEditorViewPort.setFocus(point);
			}
			Pool.putPoint(point);
		}

		/**
		 * @private
		 */
		protected function textArea_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._textAreaTouchPointID = -1;
				return;
			}

			var horizontalScrollBar:DisplayObject = DisplayObject(this.horizontalScrollBar);
			var verticalScrollBar:DisplayObject = DisplayObject(this.verticalScrollBar);
			if(this._textAreaTouchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this, TouchPhase.ENDED, this._textAreaTouchPointID);
				if(!touch || touch.isTouching(verticalScrollBar) || touch.isTouching(horizontalScrollBar))
				{
					return;
				}
				this.removeEventListener(Event.SCROLL, textArea_scrollHandler);
				this._textAreaTouchPointID = -1;
				if(this.textEditorViewPort.setTouchFocusOnEndedPhase)
				{
					this.setFocusOnTextEditorWithTouch(touch);
				}
			}
			else
			{
				touch = event.getTouch(this, TouchPhase.BEGAN);
				if(touch)
				{
					if(touch.isTouching(verticalScrollBar) || touch.isTouching(horizontalScrollBar))
					{
						return;
					}
					this._textAreaTouchPointID = touch.id;
					if(!this.textEditorViewPort.setTouchFocusOnEndedPhase)
					{
						this.setFocusOnTextEditorWithTouch(touch);
					}
					this.addEventListener(Event.SCROLL, textArea_scrollHandler);
					return;
				}
				touch = event.getTouch(this, TouchPhase.HOVER);
				if(touch)
				{
					if(touch.isTouching(verticalScrollBar) || touch.isTouching(horizontalScrollBar))
					{
						return;
					}
					if(Mouse.supportsNativeCursor && !this._oldMouseCursor)
					{
						this._oldMouseCursor = Mouse.cursor;
						Mouse.cursor = MouseCursor.IBEAM;
					}
					return;
				}
				//end hover
				if(Mouse.supportsNativeCursor && this._oldMouseCursor)
				{
					Mouse.cursor = this._oldMouseCursor;
					this._oldMouseCursor = null;
				}
			}
		}

		/**
		 * @private
		 */
		protected function textArea_scrollHandler(event:Event):void
		{
			this.removeEventListener(Event.SCROLL, textArea_scrollHandler);
			this._textAreaTouchPointID = -1;
		}

		/**
		 * @private
		 */
		protected function textArea_removedFromStageHandler(event:Event):void
		{
			if(!this._focusManager && this._textEditorHasFocus)
			{
				this.clearFocus();
			}
			this._isWaitingToSetFocus = false;
			this._textEditorHasFocus = false;
			this._textAreaTouchPointID = -1;
			this.removeEventListener(Event.SCROLL, textArea_scrollHandler);
			if(Mouse.supportsNativeCursor && this._oldMouseCursor)
			{
				Mouse.cursor = this._oldMouseCursor;
				this._oldMouseCursor = null;
			}
		}

		/**
		 * @private
		 */
		override protected function focusInHandler(event:Event):void
		{
			if(!this._focusManager)
			{
				return;
			}
			super.focusInHandler(event);
			this.setFocus();
		}

		/**
		 * @private
		 */
		override protected function focusOutHandler(event:Event):void
		{
			if(!this._focusManager)
			{
				return;
			}
			super.focusOutHandler(event);
			this.textEditorViewPort.clearFocus();
			this.invalidate(INVALIDATION_FLAG_STATE);
		}

		/**
		 * @private
		 */
		override protected function nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(this._isEditable)
			{
				return;
			}
			super.nativeStage_keyDownHandler(event);
		}

		/**
		 * @private
		 */
		protected function textEditor_changeHandler(event:Event):void
		{
			if(this._ignoreTextChanges)
			{
				return;
			}
			this.text = this.textEditorViewPort.text;
		}

		/**
		 * @private
		 */
		protected function textEditor_focusInHandler(event:Event):void
		{
			this._textEditorHasFocus = true;
			this.refreshState();
			this.refreshErrorCallout();
			this._touchPointID = -1;
			this.invalidate(INVALIDATION_FLAG_STATE);
			if(this._focusManager && this.isFocusEnabled && this._focusManager.focus !== this)
			{
				//if setFocus() was called manually, we need to notify the focus
				//manager (unless isFocusEnabled is false).
				//if the focus manager already knows that we have focus, it will
				//simply return without doing anything.
				this._focusManager.focus = this;
			}
			else if(!this._focusManager)
			{
				this.dispatchEventWith(FeathersEventType.FOCUS_IN);
			}
		}

		/**
		 * @private
		 */
		protected function textEditor_focusOutHandler(event:Event):void
		{
			this._textEditorHasFocus = false;
			this.refreshState();
			this.refreshErrorCallout();
			this.invalidate(INVALIDATION_FLAG_STATE);
			if(this._focusManager && this._focusManager.focus === this)
			{
				//if clearFocus() was called manually, we need to notify the
				//focus manager if it still thinks we have focus.
				this._focusManager.focus = null;
			}
			else if(!this._focusManager)
			{
				this.dispatchEventWith(FeathersEventType.FOCUS_OUT);
			}
		}

		/**
		 * @private
		 */
		protected function fontStyles_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}
	}
}


================================================
FILE: source/feathers/controls/TextCallout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.ITextRenderer;
	import feathers.core.IToolTip;
	import feathers.core.PopUpManager;
	import feathers.skins.IStyleProvider;
	import feathers.text.FontStylesSet;

	import flash.ui.Keyboard;

	import starling.display.DisplayObject;
	import starling.events.EnterFrameEvent;
	import starling.events.Event;
	import starling.text.TextFormat;

	[Exclude(name="content",kind="property")]

	/**
	 * A style name to add to the callout's text renderer sub-component.
	 * Typically used by a theme to provide different styles to different
	 * callouts.
	 *
	 * <p>In the following example, a custom text renderer style name is
	 * passed to the callout:</p>
	 *
	 * <listing version="3.0">
	 * button.customTextRendererStyleName = "my-custom-text-callout-text-renderer";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( BitmapFontTextRenderer ).setFunctionForStyleName( "my-custom-text-callout-text-renderer", setCustomTextCalloutTextRendererStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_TEXT_RENDERER
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #textRendererFactory
	 */
	[Style(name="customTextRendererStyleName",type="String")]

	/**
	 * The font styles used to display the callout's text when the callout is
	 * disabled.
	 *
	 * <p>In the following example, the disabled font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * callout.disabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>textRendererFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:fontStyles
	 */
	[Style(name="disabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the callout's text.
	 *
	 * <p>In the following example, the font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * callout.fontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>textRendererFactory</code> to set more advanced styles.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:disabledFontStyles
	 */
	[Style(name="fontStyles",type="starling.text.TextFormat")]

	/**
	 * Determines if the text wraps to the next line when it reaches the
	 * width (or max width) of the component.
	 *
	 * <p>In the following example, the text is not wrapped:</p>
	 *
	 * <listing version="3.0">
	 * label.wordWrap = false;</listing>
	 *
	 * @default true
	 */
	[Style(name="wordWrap",type="Boolean")]

	/**
	 * Dispatched when the callout is closed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CLOSE
	 */
	[Event(name="close",type="starling.events.Event")]

	/**
	 * A special <code>Callout</code> designed to display text.
	 *
	 * <p>In the following example, a text callout is shown when a
	 * <code>Button</code> is triggered:</p>
	 *
	 * <listing version="3.0">
	 * button.addEventListener( Event.TRIGGERED, button_triggeredHandler );
	 * 
	 * function button_triggeredHandler( event:Event ):void
	 * {
	 *     var button:Button = Button( event.currentTarget );
	 *     Callout.show( "Hello World", button );
	 * }</listing>
	 *
	 * @see ../../../help/text-callout.html How to use the Feathers Callout component
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class TextCallout extends Callout implements IToolTip
	{
		/**
		 * The default value added to the <code>styleNameList</code> of the text
		 * renderer sub-component.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 * @see ../../../help/text-renderers.html Introduction to Feathers text renderers
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_TEXT_RENDERER:String = "feathers-text-callout-text-renderer";

		/**
		 * The default <code>IStyleProvider</code> for all <code>Label</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Returns a new <code>TextCallout</code> instance when
		 * <code>TextCallout.show()</code> is called. If one wishes to skin the
		 * callout manually or change its behavior, a custom factory may be
		 * provided.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 *
		 * <pre>function():TextCallout</pre>
		 *
		 * <p>The following example shows how to create a custom text callout factory:</p>
		 *
		 * <listing version="3.0">
		 * TextCallout.calloutFactory = function():TextCallout
		 * {
		 *     var callout:TextCallout = new TextCallout();
		 *     //set properties here!
		 *     return callout;
		 * };</listing>
		 *
		 * <p>Note: the default callout factory sets the following properties:</p>
		 *
		 * <listing version="3.0">
		 * callout.closeOnTouchBeganOutside = true;
		 * callout.closeOnTouchEndedOutside = true;
		 * callout.closeOnKeys = new &lt;uint&gt;[Keyboard.BACK, Keyboard.ESCAPE];</listing>
		 *
		 * @see #show()
		 */
		public static var calloutFactory:Function = defaultCalloutFactory;

		/**
		 * The default factory that creates callouts when
		 * <code>TextCallout.show()</code> is called. To use a different
		 * factory, you need to set <code>TextCallout.calloutFactory</code> to a
		 * <code>Function</code> instance.
		 */
		public static function defaultCalloutFactory():TextCallout
		{
			var callout:TextCallout = new TextCallout();
			callout.closeOnTouchBeganOutside = true;
			callout.closeOnTouchEndedOutside = true;
			callout.closeOnKeys = new <uint>[Keyboard.BACK, Keyboard.ESCAPE];
			return callout;
		}

		/**
		 * Creates a callout that displays some text, and then positions and
		 * sizes it automatically based on an origin rectangle and the specified
		 * positions, relative to the origin.
		 *
		 * <p>In the following example, a text callout is shown when a
		 * <code>Button</code> is triggered:</p>
		 *
		 * <listing version="3.0">
		 * button.addEventListener( Event.TRIGGERED, button_triggeredHandler );
		 * 
		 * function button_triggeredHandler( event:Event ):void
		 * {
		 *     var button:Button = Button( event.currentTarget );
		 *     TextCallout.show( "Hello World", button );
		 * }</listing>
		 */
		public static function show(text:String, origin:DisplayObject, supportedPositions:Vector.<String> = null,
			isModal:Boolean = true, customCalloutFactory:Function = null, customOverlayFactory:Function = null):TextCallout
		{
			if(!origin.stage)
			{
				throw new ArgumentError("TextCallout origin must be added to the stage.");
			}
			var factory:Function = customCalloutFactory;
			if(factory === null)
			{
				factory = calloutFactory;
				if(factory === null)
				{
					factory = defaultCalloutFactory;
				}
			}
			var callout:TextCallout = TextCallout(factory());
			callout.text = text;
			callout.supportedPositions = supportedPositions;
			callout.origin = origin;
			factory = customOverlayFactory;
			if(factory == null)
			{
				factory = calloutOverlayFactory;
				if(factory == null)
				{
					factory = PopUpManager.defaultOverlayFactory;
				}
			}
			PopUpManager.addPopUp(callout, isModal, false, factory);
			callout.validate();
			return callout;
		}

		/**
		 * Constructor.
		 */
		public function TextCallout()
		{
			super();
			this.isQuickHitAreaEnabled = true;
			if(this._fontStylesSet === null)
			{
				this._fontStylesSet = new FontStylesSet();
				this._fontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
		}

		/**
		 * The text renderer.
		 *
		 * @see #createTextRenderer()
		 * @see #textRendererFactory
		 */
		protected var textRenderer:ITextRenderer;

		/**
		 * The value added to the <code>styleNameList</code> of the text
		 * renderer sub-component. This variable is <code>protected</code> so
		 * that sub-classes can customize the label text renderer style name in
		 * their constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_TEXT_RENDERER</code>.
		 *
		 * <p>To customize the text renderer style name without subclassing, see
		 * <code>customTextRendererStyleName</code>.</p>
		 *
		 * @see #style:customTextRendererStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var textRendererStyleName:String = DEFAULT_CHILD_STYLE_NAME_TEXT_RENDERER;

		/**
		 * @private
		 */
		protected var _text:String;

		/**
		 * The text to display in the callout.
		 */
		public function get text():String
		{
			return this._text;
		}

		/**
		 * @private
		 */
		public function set text(value:String):void
		{
			if(this._text === value)
			{
				return;
			}
			this._text = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _wordWrap:Boolean = true;

		/**
		 * @private
		 */
		public function get wordWrap():Boolean
		{
			return this._wordWrap;
		}

		/**
		 * @private
		 */
		public function set wordWrap(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._wordWrap === value)
			{
				return;
			}
			this._wordWrap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _fontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get fontStyles():TextFormat
		{
			return this._fontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set fontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get disabledFontStyles():TextFormat
		{
			return this._fontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set disabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _textRendererFactory:Function;

		/**
		 * A function used to instantiate the callout's text renderer
		 * sub-component. By default, the callout will use the global text
		 * renderer factory, <code>FeathersControl.defaultTextRendererFactory()</code>,
		 * to create the text renderer. The text renderer must be an instance of
		 * <code>ITextRenderer</code>. This factory can be used to change
		 * properties on the text renderer when it is first created. For
		 * instance, if you are skinning Feathers components without a theme,
		 * you might use this factory to style the text renderer.
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():ITextRenderer</pre>
		 *
		 * <p>In the following example, a custom text renderer factory is passed
		 * to the callout:</p>
		 *
		 * <listing version="3.0">
		 * callout.textRendererFactory = function():ITextRenderer
		 * {
		 *     return new TextFieldTextRenderer();
		 * }</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.ITextRenderer
		 * @see feathers.core.FeathersControl#defaultTextRendererFactory
		 */
		public function get textRendererFactory():Function
		{
			return this._textRendererFactory;
		}

		/**
		 * @private
		 */
		public function set textRendererFactory(value:Function):void
		{
			if(this._textRendererFactory == value)
			{
				return;
			}
			this._textRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _customTextRendererStyleName:String;

		/**
		 * @private
		 */
		public function get customTextRendererStyleName():String
		{
			return this._customTextRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customTextRendererStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customTextRendererStyleName === value)
			{
				return;
			}
			this._customTextRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			if(TextCallout.globalStyleProvider !== null)
			{
				return TextCallout.globalStyleProvider;
			}
			return Callout.globalStyleProvider;
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this._fontStylesSet !== null)
			{
				this._fontStylesSet.dispose();
				this._fontStylesSet = null;
			}
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var textRendererInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_TEXT_RENDERER);

			if(textRendererInvalid)
			{
				this.createTextRenderer();
			}

			if(textRendererInvalid || dataInvalid || stateInvalid)
			{
				this.refreshTextRendererData();
			}

			if(textRendererInvalid || stylesInvalid)
			{
				this.refreshTextRendererStyles();
			}
			super.draw();
		}

		/**
		 * Creates and adds the <code>textRenderer</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #textRenderer
		 * @see #textRendererFactory
		 * @see #style:customTextRendererStyleName
		 */
		protected function createTextRenderer():void
		{
			if(this.textRenderer !== null)
			{
				this.removeChild(DisplayObject(this.textRenderer), true);
				this.textRenderer = null;
			}

			var factory:Function = this._textRendererFactory != null ? this._textRendererFactory : FeathersControl.defaultTextRendererFactory;
			this.textRenderer = ITextRenderer(factory());
			var textRendererStyleName:String = this._customTextRendererStyleName !== null ? this._customTextRendererStyleName : this.textRendererStyleName;
			this.textRenderer.styleNameList.add(textRendererStyleName);
			this.content = DisplayObject(this.textRenderer);
		}

		/**
		 * @private
		 */
		protected function refreshTextRendererData():void
		{
			this.textRenderer.text = this._text;
			this.textRenderer.visible = this._text && this._text.length > 0;
		}

		/**
		 * @private
		 */
		protected function refreshTextRendererStyles():void
		{
			this.textRenderer.wordWrap = this._wordWrap;
			this.textRenderer.fontStyles = this._fontStylesSet;
		}

		/**
		 * @private
		 */
		override protected function callout_enterFrameHandler(event:EnterFrameEvent):void
		{
			//wait for validation
			if(this.isCreated)
			{
				this.positionRelativeToOrigin();
			}
		}

		/**
		 * @private
		 */
		protected function fontStyles_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}
	}
}


================================================
FILE: source/feathers/controls/TextInput.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IAdvancedNativeFocusOwner;
	import feathers.core.IFeathersControl;
	import feathers.core.IFocusDisplayObject;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IMultilineTextEditor;
	import feathers.core.INativeFocusOwner;
	import feathers.core.IStateContext;
	import feathers.core.IStateObserver;
	import feathers.core.ITextBaselineControl;
	import feathers.core.ITextEditor;
	import feathers.core.ITextRenderer;
	import feathers.core.IValidating;
	import feathers.core.PopUpManager;
	import feathers.core.PropertyProxy;
	import feathers.events.FeathersEventType;
	import feathers.layout.RelativePosition;
	import feathers.layout.VerticalAlign;
	import feathers.skins.IStyleProvider;
	import feathers.text.FontStylesSet;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;

	import flash.geom.Point;
	import flash.ui.Mouse;
	import flash.ui.MouseCursor;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.text.TextFormat;
	import starling.utils.Pool;

	/**
	 * The skin used for the input's disabled state. If <code>null</code>,
	 * then <code>backgroundSkin</code> is used instead.
	 *
	 * <p>The following example gives the input a skin for the disabled state:</p>
	 *
	 * <listing version="3.0">
	 * input.backgroundDisabledSkin = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setSkinForState()</code> with
	 * <code>TextInputState.DISABLED</code> to set the same skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * input.setSkinForState( TextInputState.DISABLED, skin );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundSkin
	 * @see #setSkinForState()
	 * @see feathers.controls.TextInputState#DISABLED
	 */
	[Style(name="backgroundDisabledSkin",type="starling.display.DisplayObject")]

	/**
	 * The skin used for the input's enabled state. If <code>null</code>,
	 * then <code>backgroundSkin</code> is used instead.
	 *
	 * <p>The following example gives the input a skin for the enabled state:</p>
	 *
	 * <listing version="3.0">
	 * input.backgroundEnabledSkin = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setSkinForState()</code> with
	 * <code>TextInputState.ENABLED</code> to set the same skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * input.setSkinForState( TextInputState.ENABLED, skin );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundSkin
	 * @see #setSkinForState()
	 * @see feathers.controls.TextInputState#ENABLED
	 */
	[Style(name="backgroundEnabledSkin",type="starling.display.DisplayObject")]

	/**
	 * The skin used for the input's error state. If <code>null</code>,
	 * then <code>backgroundSkin</code> is used instead.
	 *
	 * <p>The following example gives the input a skin for the error state:</p>
	 *
	 * <listing version="3.0">
	 * input.backgroundErrorSkin = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setSkinForState()</code> with
	 * <code>TextInputState.ERROR</code> to set the same skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * input.setSkinForState( TextInputState.ERROR, skin );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundSkin
	 * @see #setSkinForState()
	 * @see feathers.controls.TextInputState#ERROR
	 */
	[Style(name="backgroundErrorSkin",type="starling.display.DisplayObject")]

	/**
	 * The skin used for the input's focused state. If <code>null</code>,
	 * then <code>backgroundSkin</code> is used instead.
	 *
	 * <p>The following example gives the input a skin for the focused state:</p>
	 *
	 * <listing version="3.0">
	 * input.backgroundFocusedSkin = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setSkinForState()</code> with
	 * <code>TextInputState.FOCUSED</code> to set the same skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * input.setSkinForState( TextInputState.FOCUSED, skin );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundSkin
	 * @see #setSkinForState()
	 * @see feathers.controls.TextInputState#FOCUSED
	 */
	[Style(name="backgroundFocusedSkin",type="starling.display.DisplayObject")]

	/**
	 * The skin used when no other skin is defined for the current state.
	 * Intended for use when multiple states should use the same skin.
	 *
	 * <p>The following example gives the input a default skin to use for
	 * all states when no specific skin is available:</p>
	 *
	 * <listing version="3.0">
	 * input.backgroundSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #setSkinForState()
	 */
	[Style(name="backgroundSkin",type="starling.display.DisplayObject")]

	/**
	 * A style name to add to the text input's error callout sub-component.
	 * Typically used by a theme to provide different styles to different
	 * text inputs.
	 *
	 * <p>In the following example, a custom error callout style name
	 * is passed to the text input:</p>
	 *
	 * <listing version="3.0">
	 * input.customErrorCalloutStyleName = "my-custom-text-input-error-callout";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Callout ).setFunctionForStyleName( "my-custom-text-input-error-callout", setCustomTextInputErrorCalloutStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT
	 * @see feathers.core.FeathersControl#styleNameList
	 */
	[Style(name="customErrorCalloutStyleName",type="String")]

	/**
	 * A style name to add to the text input's prompt text renderer
	 * sub-component. Typically used by a theme to provide different styles
	 * to different text inputs.
	 *
	 * <p>In the following example, a custom prompt text renderer style name
	 * is passed to the text input:</p>
	 *
	 * <listing version="3.0">
	 * input.customPromptStyleName = "my-custom-text-input-prompt";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( BitmapFontTextRenderer ).setFunctionForStyleName( "my-custom-text-input-prompt", setCustomTextInputPromptStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_PROMPT
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #promptFactory
	 */
	[Style(name="customPromptStyleName",type="String")]

	/**
	 * A style name to add to the text input's text editor sub-component.
	 * Typically used by a theme to provide different styles to different
	 * text inputs.
	 *
	 * <p>In the following example, a custom text editor style name is
	 * passed to the text input:</p>
	 *
	 * <listing version="3.0">
	 * input.customTextEditorStyleName = "my-custom-text-input-text-editor";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( StageTextTextEditor ).setFunctionForStyleName( "my-custom-text-input-text-editor", setCustomTextInputTextEditorStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_TEXT_EDITOR
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #textEditorFactory
	 */
	[Style(name="customTextEditorStyleName",type="String")]

	/**
	 * The icon used when no other icon is defined for the current state.
	 * Intended for use when multiple states should use the same icon.
	 *
	 * <p>The following example gives the input a default icon to use for
	 * all states when no specific icon is available:</p>
	 *
	 * <listing version="3.0">
	 * input.defaultIcon = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #setIconForState()
	 */
	[Style(name="defaultIcon",type="starling.display.DisplayObject")]

	/**
	 * The font styles used to display the input's text when the input is
	 * disabled.
	 *
	 * <p>In the following example, the disabled font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * input.disabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Alternatively, you may use <code>setFontStylesForState()</code> with
	 * <code>TextInputState.DISABLED</code> to set the same font styles:</p>
	 *
	 * <listing version="3.0">
	 * var fontStyles:TextFormat = new TextFormat( "Helvetica", 20, 0x999999 );
	 * input.setFontStylesForState( TextInputState.DISABLED, fontStyles );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text editor being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>textEditorFactory</code> to set more advanced styles on the
	 * text editor.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:fontStyles
	 * @see #setFontStylesForState()
	 * @see feathers.controls.TextInputState#DISABLED
	 */
	[Style(name="disabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The icon used for the input's disabled state. If <code>null</code>,
	 * then <code>defaultIcon</code> is used instead.
	 *
	 * <p>The following example gives the input an icon for the disabled state:</p>
	 *
	 * <listing version="3.0">
	 * button.disabledIcon = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setIconForState()</code> with
	 * <code>TextInputState.DISABLED</code> to set the same icon:</p>
	 *
	 * <listing version="3.0">
	 * var icon:Image = new Image( texture );
	 * input.setIconForState( TextInputState.DISABLED, icon );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultIcon
	 * @see #setIconForState()
	 * @see feathers.controls.TextInputState#DISABLED
	 */
	[Style(name="disabledIcon",type="starling.display.DisplayObject")]

	/**
	 * The icon used for the input's enabled state. If <code>null</code>,
	 * then <code>defaultIcon</code> is used instead.
	 *
	 * <p>The following example gives the input an icon for the enabled state:</p>
	 *
	 * <listing version="3.0">
	 * button.enabledIcon = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setIconForState()</code> with
	 * <code>TextInputState.ENABLED</code> to set the same icon:</p>
	 *
	 * <listing version="3.0">
	 * var icon:Image = new Image( texture );
	 * input.setIconForState( TextInputState.ENABLED, icon );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultIcon
	 * @see #setIconForState()
	 * @see feathers.controls.TextInputState#ENABLED
	 */
	[Style(name="enabledIcon",type="starling.display.DisplayObject")]

	/**
	 * The icon used for the input's error state. If <code>null</code>,
	 * then <code>defaultIcon</code> is used instead.
	 *
	 * <p>The following example gives the input an icon for the error state:</p>
	 *
	 * <listing version="3.0">
	 * button.errorIcon = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setIconForState()</code> with
	 * <code>TextInputState.ERROR</code> to set the same icon:</p>
	 *
	 * <listing version="3.0">
	 * var icon:Image = new Image( texture );
	 * input.setIconForState( TextInputState.ERROR, icon );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultIcon
	 * @see #setIconForState()
	 * @see feathers.controls.TextInputState#ERROR
	 */
	[Style(name="errorIcon",type="starling.display.DisplayObject")]

	/**
	 * The icon used for the input's focused state. If <code>null</code>,
	 * then <code>defaultIcon</code> is used instead.
	 *
	 * <p>The following example gives the input an icon for the focused state:</p>
	 *
	 * <listing version="3.0">
	 * button.focusedIcon = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setIconForState()</code> with
	 * <code>TextInputState.FOCUSED</code> to set the same icon:</p>
	 *
	 * <listing version="3.0">
	 * var icon:Image = new Image( texture );
	 * input.setIconForState( TextInputState.FOCUSED, icon );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultIcon
	 * @see #setIconForState()
	 * @see feathers.controls.TextInputState#FOCUSED
	 */
	[Style(name="focusedIcon",type="starling.display.DisplayObject")]

	/**
	 * The font styles used to display the input's text.
	 *
	 * <p>In the following example, the font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * input.fontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text editor being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>textEditorFactory</code> to set more advanced styles on the
	 * text editor.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:disabledFontStyles
	 * @see #setFontStylesForState()
	 */
	[Style(name="fontStyles",type="starling.text.TextFormat")]

	/**
	 * The space, in pixels, between the icon and the text editor, if an
	 * icon exists.
	 *
	 * <p>The following example creates a gap of 50 pixels between the icon
	 * and the text editor:</p>
	 *
	 * <listing version="3.0">
	 * button.defaultIcon = new Image( texture );
	 * button.gap = 50;</listing>
	 *
	 * @default 0
	 */
	[Style(name="gap",type="Number")]

	/**
	 * The location of the icon, relative to the text renderer.
	 *
	 * <p>The following example positions the icon to the right of the
	 * text renderer:</p>
	 *
	 * <listing version="3.0">
	 * input.defaultIcon = new Image( texture );
	 * input.iconPosition = RelativePosition.RIGHT;</listing>
	 *
	 * @default feathers.layout.RelativePosition.LEFT
	 *
	 * @see feathers.layout.RelativePosition#RIGHT
	 * @see feathers.layout.RelativePosition#LEFT
	 */
	[Style(name="iconPosition",type="String")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the text input's padding is set to
	 * 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * input.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, between the input's top edge and the
	 * input's content.
	 *
	 * <p>In the following example, the text input's top padding is set to
	 * 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * input.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the input's right edge and the
	 * input's content.
	 *
	 * <p>In the following example, the text input's right padding is set to
	 * 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * input.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the input's bottom edge and
	 * the input's content.
	 *
	 * <p>In the following example, the text input's bottom padding is set to
	 * 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * input.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the input's left edge and the
	 * input's content.
	 *
	 * <p>In the following example, the text input's left padding is set to
	 * 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * input.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * The font styles used to display the input's prompt when the input is
	 * disabled.
	 *
	 * <p>In the following example, the disabled font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * input.promptDisabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>promptFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:promptFontStyles
	 * @see #setPromptFontStylesForState()
	 */
	[Style(name="promptDisabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the input's prompt text.
	 *
	 * <p>In the following example, the font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * input.promptFontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>promptFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:promptDisabledFontStyles
	 * @see #setPromptFontStylesForState()
	 */
	[Style(name="promptFontStyles",type="starling.text.TextFormat")]

	/**
	 * If not <code>null</code>, the dimensions of the
	 * <code>typicalText</code> will be used in the calculation of the text
	 * input's full dimensions. If the text input's dimensions haven't been
	 * set explicitly, it's calculated dimensions will be at least large
	 * enough to display the <code>typicalText</code>. Other children, such
	 * as the background skin and the prompt text renderer may also affect
	 * the dimensions of the text input, allowing it to, potentially, be
	 * bigger than the rendered <code>typicalText</code>.
	 *
	 * <p>In the following example, the text input's typical text is
	 * updated:</p>
	 *
	 * <listing version="3.0">
	 * input.text = "We want to allow the text input to show all of this text";</listing>
	 *
	 * @default null
	 */
	[Style(name="typicalText",type="String")]

	/**
	 * The location where the text editor is aligned vertically (on
	 * the y-axis).
	 *
	 * <p>The following example aligns the text editor to the top:</p>
	 *
	 * <listing version="3.0">
	 * input.verticalAlign = VerticalAlign.TOP;</listing>
	 *
	 * @default feathers.layout.VerticalAlign.MIDDLE
	 *
	 * @see feathers.layout.VerticalAlign#TOP
	 * @see feathers.layout.VerticalAlign#MIDDLE
	 * @see feathers.layout.VerticalAlign#BOTTOM
	 * @see feathers.layout.VerticalAlign#JUSTIFY
	 */
	[Style(name="verticalAlign",type="String")]

	/**
	 * Dispatched when the text input's <code>text</code> property changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #text
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the user presses the Enter key while the text input
	 * has focus. This event may not be dispatched at all times. Certain text
	 * editors will not dispatch an event for the enter key on some platforms,
	 * depending on the values of certain properties. This may include the
	 * default values for some platforms! If you've encountered this issue,
	 * please see the specific text editor's API documentation for complete
	 * details of this event's limitations and requirements.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.ENTER
	 */
	[Event(name="enter",type="starling.events.Event")]

	/**
	 * Dispatched when the text input receives focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_IN
	 */
	[Event(name="focusIn",type="starling.events.Event")]

	/**
	 * Dispatched when the text input loses focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_OUT
	 */
	[Event(name="focusOut",type="starling.events.Event")]

	/**
	 * Dispatched when the soft keyboard is about the be activated by the text
	 * editor. Not all text editors will activate a soft keyboard.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.SOFT_KEYBOARD_ACTIVATING
	 */
	[Event(name="softKeyboardActivating",type="starling.events.Event")]

	/**
	 * Dispatched when the soft keyboard is activated by the text editor. Not
	 * all text editors will activate a soft keyboard.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.SOFT_KEYBOARD_ACTIVATE
	 */
	[Event(name="softKeyboardActivate",type="starling.events.Event")]

	/**
	 * Dispatched when the soft keyboard is deactivated by the text editor. Not
	 * all text editors will activate a soft keyboard.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.SOFT_KEYBOARD_DEACTIVATE
	 */
	[Event(name="softKeyboardDeactivate",type="starling.events.Event")]

	/**
	 * Dispatched when the display object's state changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.STATE_CHANGE
	 *
	 * @see #currentState
	 */
	[Event(name="stateChange",type="starling.events.Event")]

	/**
	 * A text entry control that allows users to enter and edit a single line of
	 * uniformly-formatted text.
	 *
	 * <p>The following example sets the text in a text input, selects the text,
	 * and listens for when the text value changes:</p>
	 *
	 * <listing version="3.0">
	 * var input:TextInput = new TextInput();
	 * input.text = "Hello World";
	 * input.selectRange( 0, input.text.length );
	 * input.addEventListener( Event.CHANGE, input_changeHandler );
	 * this.addChild( input );</listing>
	 *
	 * @see ../../../help/text-input.html How to use the Feathers TextInput component
	 * @see ../../../help/text-editors.html Introduction to Feathers text editors
	 * @see feathers.core.ITextEditor
	 * @see feathers.controls.AutoComplete
	 * @see feathers.controls.TextArea
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class TextInput extends FeathersControl implements ITextBaselineControl, IAdvancedNativeFocusOwner, IStateContext
	{
		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_PROMPT_FACTORY:String = "promptFactory";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_ERROR_CALLOUT_FACTORY:String = "errorCalloutFactory";

		/**
		 * The default value added to the <code>styleNameList</code> of the text
		 * editor.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_TEXT_EDITOR:String = "feathers-text-input-text-editor";

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * prompt text renderer.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_PROMPT:String = "feathers-text-input-prompt";

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * error callout.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT:String = "feathers-text-input-error-callout";

		/**
		 * An alternate style name to use with <code>TextInput</code> to allow a
		 * theme to give it a search input style. If a theme does not provide a
		 * style for the search text input, the theme will automatically fal
		 * back to using the default text input style.
		 *
		 * <p>An alternate style name should always be added to a component's
		 * <code>styleNameList</code> before the component is initialized. If
		 * the style name is added later, it will be ignored.</p>
		 *
		 * <p>In the following example, the search style is applied to a text
		 * input:</p>
		 *
		 * <listing version="3.0">
		 * var input:TextInput = new TextInput();
		 * input.styleNameList.add( TextInput.ALTERNATE_STYLE_NAME_SEARCH_TEXT_INPUT );
		 * this.addChild( input );</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_SEARCH_TEXT_INPUT:String = "feathers-search-text-input";

		/**
		 * The default <code>IStyleProvider</code> for all <code>TextInput</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		private static function defaultErrorCalloutFactory():TextCallout
		{
			return new TextCallout();
		}
		
		/**
		 * Constructor.
		 */
		public function TextInput()
		{
			super();
			if(this._fontStylesSet === null)
			{
				this._fontStylesSet = new FontStylesSet();
				this._fontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
			if(this._promptFontStylesSet === null)
			{
				this._promptFontStylesSet = new FontStylesSet();
				this._promptFontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
			this.addEventListener(TouchEvent.TOUCH, textInput_touchHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, textInput_removedFromStageHandler);
		}

		/**
		 * The text editor sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected var textEditor:ITextEditor;

		/**
		 * The prompt text renderer sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected var promptTextRenderer:ITextRenderer;

		/**
		 * The currently selected background, based on state.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected var currentBackground:DisplayObject;

		/**
		 * The currently visible icon. The value will be <code>null</code> if
		 * there is no currently visible icon.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected var currentIcon:DisplayObject;

		/**
		 * The <code>TextCallout</code> that displays the value of the
		 * <code>errorString</code> property. The value may be
		 * <code>null</code> if there is no current error string or the text
		 * input does not have focus.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected var callout:TextCallout;

		/**
		 * The value added to the <code>styleNameList</code> of the text editor.
		 * This variable is <code>protected</code> so that sub-classes can
		 * customize the text editor style name in their constructors instead of
		 * using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_TEXT_EDITOR</code>.
		 *
		 * <p>To customize the text editor style name without subclassing, see
		 * <code>customTextEditorStyleName</code>.</p>
		 *
		 * @see #style:customTextEditorStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var textEditorStyleName:String = DEFAULT_CHILD_STYLE_NAME_TEXT_EDITOR;

		/**
		 * The value added to the <code>styleNameList</code> of the prompt text
		 * renderer. This variable is <code>protected</code> so that sub-classes
		 * can customize the prompt text renderer style name in their
		 * constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_PROMPT</code>.
		 *
		 * <p>To customize the prompt text renderer style name without
		 * subclassing, see <code>customPromptStyleName</code>.</p>
		 *
		 * @see #style:customPromptStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var promptStyleName:String = DEFAULT_CHILD_STYLE_NAME_PROMPT;

		/**
		 * The value added to the <code>styleNameList</code> of the error
		 * callout. This variable is <code>protected</code> so that sub-classes
		 * can customize the prompt text renderer style name in their
		 * constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT</code>.
		 *
		 * <p>To customize the error callout style name without subclassing, see
		 * <code>customErrorCalloutStyleName</code>.</p>
		 *
		 * @see #style:customErrorCalloutStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var errorCalloutStyleName:String = DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT;

		/**
		 * @private
		 */
		protected var _textEditorHasFocus:Boolean = false;

		/**
		 * A text editor may be an <code>INativeFocusOwner</code>, so we need to
		 * return the value of its <code>nativeFocus</code> property. If not,
		 * then we return <code>null</code>.
		 *
		 * @see feathers.core.INativeFocusOwner
		 */
		public function get nativeFocus():Object
		{
			if(this.textEditor is INativeFocusOwner)
			{
				return INativeFocusOwner(this.textEditor).nativeFocus;
			}
			return null;
		}

		/**
		 * @private
		 */
		override public function get maintainTouchFocus():Boolean
		{
			if(this.textEditor is IFocusDisplayObject)
			{
				return IFocusDisplayObject(this.textEditor).maintainTouchFocus;
			}
			return super.maintainTouchFocus;
		}

		/**
		 * @private
		 */
		protected var _ignoreTextChanges:Boolean = false;

		/**
		 * @private
		 */
		protected var _touchPointID:int = -1;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return TextInput.globalStyleProvider;
		}

		/**
		 * When the <code>FocusManager</code> isn't enabled, <code>hasFocus</code>
		 * can be used instead of <code>FocusManager.focus == textInput</code>
		 * to determine if the text input has focus.
		 */
		public function get hasFocus():Boolean
		{
			return this._textEditorHasFocus;
		}

		/**
		 * @private
		 */
		override public function set isEnabled(value:Boolean):void
		{
			super.isEnabled = value;
			this.refreshState();
		}

		/**
		 * @private
		 */
		protected var _currentState:String = TextInputState.ENABLED;

		/**
		 * The current state of the text input.
		 *
		 * @see feathers.controls.TextInputState
		 * @see #event:stateChange feathers.events.FeathersEventType.STATE_CHANGE
		 */
		public function get currentState():String
		{
			return this._currentState;
		}

		/**
		 * @private
		 */
		protected var _text:String = "";

		/**
		 * The text displayed by the text input. The text input dispatches
		 * <code>Event.CHANGE</code> when the value of the <code>text</code>
		 * property changes for any reason.
		 *
		 * <p>In the following example, the text input's text is updated:</p>
		 *
		 * <listing version="3.0">
		 * input.text = "Hello World";</listing>
		 *
		 * @see #event:change
		 *
		 * @default ""
		 */
		public function get text():String
		{
			return this._text;
		}

		/**
		 * @private
		 */
		public function set text(value:String):void
		{
			if(!value)
			{
				//don't allow null or undefined
				value = "";
			}
			if(this._text == value)
			{
				return;
			}
			this._text = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * The baseline measurement of the text, in pixels.
		 */
		public function get baseline():Number
		{
			if(!this.textEditor)
			{
				return 0;
			}
			return this.textEditor.y + this.textEditor.baseline;
		}

		/**
		 * @private
		 */
		protected var _prompt:String = null;

		/**
		 * The prompt, hint, or description text displayed by the input when the
		 * value of its text is empty.
		 *
		 * <p>In the following example, the text input's prompt is updated:</p>
		 *
		 * <listing version="3.0">
		 * input.prompt = "User Name";</listing>
		 *
		 * @default null
		 */
		public function get prompt():String
		{
			return this._prompt;
		}

		/**
		 * @private
		 */
		public function set prompt(value:String):void
		{
			if(this._prompt == value)
			{
				return;
			}
			this._prompt = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _typicalText:String = null;

		/**
		 * @private
		 */
		public function get typicalText():String
		{
			return this._typicalText;
		}

		/**
		 * @private
		 */
		public function set typicalText(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._typicalText === value)
			{
				return;
			}
			this._typicalText = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _maxChars:int = 0;

		/**
		 * The maximum number of characters that may be entered. If <code>0</code>,
		 * any number of characters may be entered.
		 *
		 * <p>In the following example, the text input's maximum characters is
		 * specified:</p>
		 *
		 * <listing version="3.0">
		 * input.maxChars = 10;</listing>
		 *
		 * @default 0
		 */
		public function get maxChars():int
		{
			return this._maxChars;
		}

		/**
		 * @private
		 */
		public function set maxChars(value:int):void
		{
			if(this._maxChars == value)
			{
				return;
			}
			this._maxChars = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _restrict:String;

		/**
		 * Limits the set of characters that may be entered.
		 *
		 * <p>In the following example, the text input's allowed characters are
		 * restricted:</p>
		 *
		 * <listing version="3.0">
		 * input.restrict = "0-9";</listing>
		 *
		 * @default null
		 */
		public function get restrict():String
		{
			return this._restrict;
		}

		/**
		 * @private
		 */
		public function set restrict(value:String):void
		{
			if(this._restrict == value)
			{
				return;
			}
			this._restrict = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _displayAsPassword:Boolean = false;

		/**
		 * Determines if the entered text will be masked so that it cannot be
		 * seen, such as for a password input.
		 *
		 * <p>In the following example, the text input's text is displayed as
		 * a password:</p>
		 *
		 * <listing version="3.0">
		 * input.displayAsPassword = true;</listing>
		 *
		 * @default false
		 */
		public function get displayAsPassword():Boolean
		{
			return this._displayAsPassword;
		}

		/**
		 * @private
		 */
		public function set displayAsPassword(value:Boolean):void
		{
			if(this._displayAsPassword == value)
			{
				return;
			}
			this._displayAsPassword = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isEditable:Boolean = true;

		/**
		 * Determines if the text input is editable. If the text input is not
		 * editable, it will still appear enabled.
		 *
		 * <p>In the following example, the text input is not editable:</p>
		 *
		 * <listing version="3.0">
		 * input.isEditable = false;</listing>
		 *
		 * @default true
		 *
		 * @see #isSelectable
		 */
		public function get isEditable():Boolean
		{
			return this._isEditable;
		}

		/**
		 * @private
		 */
		public function set isEditable(value:Boolean):void
		{
			if(this._isEditable == value)
			{
				return;
			}
			this._isEditable = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isSelectable:Boolean = true;

		/**
		 * If the <code>isEditable</code> property is set to <code>false</code>,
		 * the <code>isSelectable</code> property determines if the text is
		 * selectable. If the <code>isEditable</code> property is set to
		 * <code>true</code>, the text will always be selectable.
		 *
		 * <p>In the following example, the text input is not selectable:</p>
		 *
		 * <listing version="3.0">
		 * input.isEditable = false;
		 * input.isSelectable = false;</listing>
		 *
		 * @default true
		 *
		 * @see #isEditable
		 */
		public function get isSelectable():Boolean
		{
			return this._isSelectable;
		}

		/**
		 * @private
		 */
		public function set isSelectable(value:Boolean):void
		{
			if(this._isSelectable == value)
			{
				return;
			}
			this._isSelectable = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _errorString:String = null;

		/**
		 * Error text to display in a <code>Callout</code> when the input has
		 * focus. When this value is not <code>null</code> the input's state is
		 * changed to <code>TextInputState.ERROR</code>.
		 *
		 * An empty string will change the background, but no
		 * <code>Callout</code> will appear on focus.
		 *
		 * To clear an error, the <code>errorString</code> property must be set
		 * to <code>null</code>
		 *
		 * <p>The following example displays an error string:</p>
		 *
		 * <listing version="3.0">
		 * input.errorString = "Something is wrong";</listing>
		 *
		 * @default null
		 *
		 * @see #currentState
		 */
		public function get errorString():String
		{
			return this._errorString;
		}

		/**
		 * @private
		 */
		public function set errorString(value:String):void
		{
			if(this._errorString === value)
			{
				return;
			}
			this._errorString = value;
			this.refreshState();
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _fontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get fontStyles():TextFormat
		{
			return this._fontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set fontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get disabledFontStyles():TextFormat
		{
			return this._fontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set disabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _textEditorFactory:Function;

		/**
		 * A function used to instantiate the text editor. If null,
		 * <code>FeathersControl.defaultTextEditorFactory</code> is used
		 * instead. The text editor must be an instance of
		 * <code>ITextEditor</code>. This factory can be used to change
		 * properties on the text editor when it is first created. For instance,
		 * if you are skinning Feathers components without a theme, you might
		 * use this factory to set styles on the text editor.
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():ITextEditor</pre>
		 *
		 * <p>In the following example, a custom text editor factory is passed
		 * to the text input:</p>
		 *
		 * <listing version="3.0">
		 * input.textEditorFactory = function():ITextEditor
		 * {
		 *     return new TextFieldTextEditor();
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.ITextEditor
		 * @see feathers.core.FeathersControl#defaultTextEditorFactory
		 */
		public function get textEditorFactory():Function
		{
			return this._textEditorFactory;
		}

		/**
		 * @private
		 */
		public function set textEditorFactory(value:Function):void
		{
			if(this._textEditorFactory == value)
			{
				return;
			}
			this._textEditorFactory = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_EDITOR);
		}

		/**
		 * @private
		 */
		protected var _customTextEditorStyleName:String;

		/**
		 * @private
		 */
		public function get customTextEditorStyleName():String
		{
			return this._customTextEditorStyleName;
		}

		/**
		 * @private
		 */
		public function set customTextEditorStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customTextEditorStyleName === value)
			{
				return;
			}
			this._customTextEditorStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _promptFontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get promptFontStyles():TextFormat
		{
			return this._promptFontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set promptFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._promptFontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._promptFontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get promptDisabledFontStyles():TextFormat
		{
			return this._promptFontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set promptDisabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._promptFontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._promptFontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _promptFactory:Function;

		/**
		 * A function used to instantiate the prompt text renderer. If null,
		 * <code>FeathersControl.defaultTextRendererFactory</code> is used
		 * instead. The prompt text renderer must be an instance of
		 * <code>ITextRenderer</code>. This factory can be used to change
		 * properties on the prompt when it is first created. For instance, if
		 * you are skinning Feathers components without a theme, you might use
		 * this factory to set styles on the prompt.
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():ITextRenderer</pre>
		 *
		 * <p>If the <code>prompt</code> property is <code>null</code>, the
		 * prompt text renderer will not be created.</p>
		 *
		 * <p>In the following example, a custom prompt factory is passed to the
		 * text input:</p>
		 *
		 * <listing version="3.0">
		 * input.promptFactory = function():ITextRenderer
		 * {
		 *     return new TextFieldTextRenderer();
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #prompt
		 * @see feathers.core.ITextRenderer
		 * @see feathers.core.FeathersControl#defaultTextRendererFactory
		 */
		public function get promptFactory():Function
		{
			return this._promptFactory;
		}

		/**
		 * @private
		 */
		public function set promptFactory(value:Function):void
		{
			if(this._promptFactory == value)
			{
				return;
			}
			this._promptFactory = value;
			this.invalidate(INVALIDATION_FLAG_PROMPT_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customPromptStyleName:String;

		/**
		 * @private
		 */
		public function get customPromptStyleName():String
		{
			return this._customPromptStyleName;
		}

		/**
		 * @private
		 */
		public function set customPromptStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customPromptStyleName === value)
			{
				return;
			}
			this._customPromptStyleName = value;
			this.invalidate(INVALIDATION_FLAG_PROMPT_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _promptProperties:PropertyProxy;

		/**
		 * An object that stores properties for the input's prompt text
		 * renderer sub-component, and the properties will be passed down to the
		 * text renderer when the input validates. The available properties
		 * depend on which <code>ITextRenderer</code> implementation is returned
		 * by <code>messageFactory</code>. Refer to
		 * <a href="../core/ITextRenderer.html"><code>feathers.core.ITextRenderer</code></a>
		 * for a list of available text renderer implementations.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>promptFactory</code> function
		 * instead of using <code>promptProperties</code> will result in
		 * better performance.</p>
		 *
		 * <p>In the following example, the text input's prompt's properties are
		 * updated (this example assumes that the prompt text renderer is a
		 * <code>TextFieldTextRenderer</code>):</p>
		 *
		 * <listing version="3.0">
		 * input.promptProperties.textFormat = new TextFormat( "Source Sans Pro", 16, 0x333333 );
		 * input.promptProperties.embedFonts = true;</listing>
		 *
		 * @default null
		 *
		 * @see #prompt
		 * @see #promptFactory
		 * @see feathers.core.ITextRenderer
		 */
		public function get promptProperties():Object
		{
			if(!this._promptProperties)
			{
				this._promptProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._promptProperties;
		}

		/**
		 * @private
		 */
		public function set promptProperties(value:Object):void
		{
			if(this._promptProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._promptProperties)
			{
				this._promptProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._promptProperties = PropertyProxy(value);
			if(this._promptProperties)
			{
				this._promptProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}
		
		/**
		 * @private
		 */
		protected var _errorCalloutFactory:Function;
		
		/**
		 * A function used to instantiate the error text callout. If null,
		 * <code>new TextCallout()</code> is used instead.
		 * The error text callout must be an instance of
		 * <code>TextCallout</code>. This factory can be used to change
		 * properties on the callout when it is first created. For instance, if
		 * you are skinning Feathers components without a theme, you might use
		 * this factory to set styles on the callout.
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():TextCallout</pre>
		 *
		 * <p>In the following example, a custom error callout factory is passed
		 * to the text input:</p>
		 *
		 * <listing version="3.0">
		 * input.errorCalloutFactory = function():TextCallout
		 * {
		 *     return new TextCallout();
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #errorString
		 * @see feathers.controls.TextCallout
		 */
		public function get errorCalloutFactory():Function
		{
			return this._errorCalloutFactory;
		}
		
		public function set errorCalloutFactory(value:Function):void
		{
			if(this._errorCalloutFactory == value)
			{
				return;
			}
			this._errorCalloutFactory = value;
			this.invalidate(INVALIDATION_FLAG_ERROR_CALLOUT_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customErrorCalloutStyleName:String;

		/**
		 * @private
		 */
		public function get customErrorCalloutStyleName():String
		{
			return this._customErrorCalloutStyleName;
		}

		/**
		 * @private
		 */
		public function set customErrorCalloutStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customErrorCalloutStyleName === value)
			{
				return;
			}
			this._customErrorCalloutStyleName = value;
			this.invalidate(INVALIDATION_FLAG_ERROR_CALLOUT_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _explicitBackgroundWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxHeight:Number;

		/**
		 * @private
		 */
		protected var _backgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundSkin():DisplayObject
		{
			return this._backgroundSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._backgroundSkin === value)
			{
				return;
			}
			if(this._backgroundSkin !== null &&
				this.currentBackground === this._backgroundSkin)
			{
				//if this skin needs to be reused somewhere else, we need to
				//properly clean it up
				this.removeCurrentBackground(this._backgroundSkin);
				this.currentBackground = null;
			}
			this._backgroundSkin = value;
			this.invalidate(INVALIDATION_FLAG_SKIN);
		}

		/**
		 * @private
		 */
		protected var _stateToSkin:Object = {};

		/**
		 * @private
		 */
		public function get backgroundEnabledSkin():DisplayObject
		{
			return this.getSkinForState(TextInputState.ENABLED);
		}

		/**
		 * @private
		 */
		public function set backgroundEnabledSkin(value:DisplayObject):void
		{
			this.setSkinForState(TextInputState.ENABLED, value);
		}

		/**
		 * @private
		 */
		public function get backgroundFocusedSkin():DisplayObject
		{
			return this.getSkinForState(TextInputState.FOCUSED);
		}

		/**
		 * @private
		 */
		public function set backgroundFocusedSkin(value:DisplayObject):void
		{
			this.setSkinForState(TextInputState.FOCUSED, value);
		}

		/**
		 * @private
		 */
		public function get backgroundErrorSkin():DisplayObject
		{
			return this.getSkinForState(TextInputState.ERROR);
		}

		/**
		 * @private
		 */
		public function set backgroundErrorSkin(value:DisplayObject):void
		{
			this.setSkinForState(TextInputState.ERROR, value);
		}

		/**
		 * @private
		 */
		public function get backgroundDisabledSkin():DisplayObject
		{
			return this.getSkinForState(TextInputState.DISABLED);
		}

		/**
		 * @private
		 */
		public function set backgroundDisabledSkin(value:DisplayObject):void
		{
			this.setSkinForState(TextInputState.DISABLED, value);
		}

		/**
		 * @private
		 * The width of the first icon that was displayed.
		 */
		protected var _originalIconWidth:Number = NaN;

		/**
		 * @private
		 * The height of the first icon that was displayed.
		 */
		protected var _originalIconHeight:Number = NaN;

		/**
		 * @private
		 */
		protected var _defaultIcon:DisplayObject;

		/**
		 * @private
		 */
		public function get defaultIcon():DisplayObject
		{
			return this._defaultIcon;
		}

		/**
		 * @private
		 */
		public function set defaultIcon(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._defaultIcon === value)
			{
				return;
			}
			this._defaultIcon = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _stateToIcon:Object = {};

		/**
		 * @private
		 */
		public function get enabledIcon():DisplayObject
		{
			return this.getIconForState(TextInputState.ENABLED);
		}

		/**
		 * @private
		 */
		public function set enabledIcon(value:DisplayObject):void
		{
			this.setIconForState(TextInputState.ENABLED, value);
		}

		/**
		 * @private
		 */
		public function get disabledIcon():DisplayObject
		{
			return this.getIconForState(TextInputState.DISABLED);
		}

		/**
		 * @private
		 */
		public function set disabledIcon(value:DisplayObject):void
		{
			this.setIconForState(TextInputState.DISABLED, value);
		}

		/**
		 * @private
		 */
		public function get focusedIcon():DisplayObject
		{
			return this.getIconForState(TextInputState.FOCUSED);
		}

		/**
		 * @private
		 */
		public function set focusedIcon(value:DisplayObject):void
		{
			this.setIconForState(TextInputState.FOCUSED, value);
		}

		/**
		 * @private
		 */
		public function get errorIcon():DisplayObject
		{
			return this.getIconForState(TextInputState.ERROR);
		}

		/**
		 * @private
		 */
		public function set errorIcon(value:DisplayObject):void
		{
			this.setIconForState(TextInputState.ERROR, value);
		}

		/**
		 * @private
		 */
		protected var _iconPosition:String = RelativePosition.LEFT;

		[Inspectable(type="String",enumeration="left,right")]
		/**
		 * @private
		 */
		public function get iconPosition():String
		{
			return this._iconPosition;
		}

		/**
		 * @private
		 */
		public function set iconPosition(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._iconPosition === value)
			{
				return;
			}
			this._iconPosition = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _gap:Number = 0;

		/**
		 * @private
		 */
		public function get gap():Number
		{
			return this._gap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._gap == value)
			{
				return;
			}
			this._gap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.MIDDLE;

		[Inspectable(type="String",enumeration="top,middle,bottom,justify")]
		/**
		 * @private
		 */
		public function get verticalAlign():String
		{
			return this._verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._verticalAlign === value)
			{
				return;
			}
			this._verticalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 * Flag indicating that the text editor should get focus after it is
		 * created.
		 */
		protected var _isWaitingToSetFocus:Boolean = false;

		/**
		 * @private
		 */
		protected var _pendingSelectionBeginIndex:int = -1;

		/**
		 * @private
		 */
		protected var _pendingSelectionEndIndex:int = -1;

		/**
		 * @private
		 */
		protected var _oldMouseCursor:String = null;

		/**
		 * @private
		 */
		protected var _textEditorProperties:PropertyProxy;

		/**
		 * An object that stores properties for the input's text editor
		 * sub-component, and the properties will be passed down to the
		 * text editor when the input validates. The available properties
		 * depend on which <code>ITextEditor</code> implementation is returned
		 * by <code>textEditorFactory</code>. Refer to
		 * <a href="../core/ITextEditor.html"><code>feathers.core.ITextEditor</code></a>
		 * for a list of available text editor implementations.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>textEditorFactory</code> function
		 * instead of using <code>textEditorProperties</code> will result in
		 * better performance.</p>
		 *
		 * <p>In the following example, the text input's text editor properties
		 * are specified (this example assumes that the text editor is a
		 * <code>StageTextTextEditor</code>):</p>
		 *
		 * <listing version="3.0">
		 * input.textEditorProperties.fontName = "Helvetica";
		 * input.textEditorProperties.fontSize = 16;</listing>
		 *
		 * @default null
		 *
		 * @see #textEditorFactory
		 * @see feathers.core.ITextEditor
		 */
		public function get textEditorProperties():Object
		{
			if(!this._textEditorProperties)
			{
				this._textEditorProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._textEditorProperties;
		}

		/**
		 * @private
		 */
		public function set textEditorProperties(value:Object):void
		{
			if(this._textEditorProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._textEditorProperties)
			{
				this._textEditorProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._textEditorProperties = PropertyProxy(value);
			if(this._textEditorProperties)
			{
				this._textEditorProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @copy feathers.core.ITextEditor#selectionBeginIndex
		 */
		public function get selectionBeginIndex():int
		{
			if(this._pendingSelectionBeginIndex >= 0)
			{
				return this._pendingSelectionBeginIndex;
			}
			if(this.textEditor)
			{
				return this.textEditor.selectionBeginIndex;
			}
			return 0;
		}

		/**
		 * @copy feathers.core.ITextEditor#selectionEndIndex
		 */
		public function get selectionEndIndex():int
		{
			if(this._pendingSelectionEndIndex >= 0)
			{
				return this._pendingSelectionEndIndex;
			}
			if(this.textEditor)
			{
				return this.textEditor.selectionEndIndex;
			}
			return 0;
		}

		/**
		 * @private
		 */
		override public function set visible(value:Boolean):void
		{
			if(!value)
			{
				this._isWaitingToSetFocus = false;
			}
			super.visible = value;
			//call clearFocus() after setting super.visible because the text
			//editor may check the visible property
			if(!value && this._textEditorHasFocus)
			{
				this.textEditor.clearFocus();
			}
		}

		/**
		 * @private
		 */
		override public function hitTest(localPoint:Point):DisplayObject
		{
			if(!this.visible || !this.touchable)
			{
				return null;
			}
			if(this.mask && !this.hitTestMask(localPoint))
			{
				return null;
			}
			return this._hitArea.containsPoint(localPoint) ? DisplayObject(this.textEditor) : null;
		}

		/**
		 * Focuses the text input control so that it may be edited, and selects
		 * all of its text. Call <code>selectRange()</code> after
		 * <code>setFocus()</code> to select a different range.
		 *
		 * @see #selectRange()
		 */
		public function setFocus():void
		{
			//if the text editor has focus, no need to set focus
			//if this is invisible, it wouldn't make sense to set focus
			//if there's a touch point ID, we'll be setting focus on our own
			if(this._textEditorHasFocus || !this.visible || this._touchPointID >= 0)
			{
				return;
			}
			if(this._isEditable || this._isSelectable)
			{
				this.selectRange(0, this._text.length);
			}
			if(this.textEditor)
			{
				this._isWaitingToSetFocus = false;
				this.textEditor.setFocus();
			}
			else
			{
				this._isWaitingToSetFocus = true;
				this.invalidate(INVALIDATION_FLAG_SELECTED);
			}
		}

		/**
		 * Manually removes focus from the text input control.
		 */
		public function clearFocus():void
		{
			this._isWaitingToSetFocus = false;
			if(!this.textEditor || !this._textEditorHasFocus)
			{
				return;
			}
			this.textEditor.clearFocus();
		}

		/**
		 * Sets the range of selected characters. If both values are the same,
		 * or the end index is <code>-1</code>, the text insertion position is
		 * changed and nothing is selected.
		 */
		public function selectRange(beginIndex:int, endIndex:int = -1):void
		{
			if(endIndex < 0)
			{
				endIndex = beginIndex;
			}
			if(beginIndex < 0)
			{
				throw new RangeError("Expected begin index >= 0. Received " + beginIndex + ".");
			}
			if(endIndex > this._text.length)
			{
				throw new RangeError("Expected end index <= " + this._text.length + ". Received " + endIndex + ".");
			}

			//if it's invalid, we need to wait until validation before changing
			//the selection
			if(this.textEditor && (this._isValidating || !this.isInvalid()))
			{
				this._pendingSelectionBeginIndex = -1;
				this._pendingSelectionEndIndex = -1;
				this.textEditor.selectRange(beginIndex, endIndex);
			}
			else
			{
				this._pendingSelectionBeginIndex = beginIndex;
				this._pendingSelectionEndIndex = endIndex;
				this.invalidate(INVALIDATION_FLAG_SELECTED);
			}
		}

		/**
		 * Gets the font styles to be used to display the input's text when the
		 * input's <code>currentState</code> property matches the specified
		 * state value.
		 *
		 * <p>If font styles are not defined for a specific state, returns
		 * <code>null</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #setFontStylesForState()
		 * @see #style:fontStyles
		 */
		public function getFontStylesForState(state:String):TextFormat
		{
			if(this._fontStylesSet === null)
			{
				return null;
			}
			return this._fontStylesSet.getFormatForState(state);
		}

		/**
		 * Sets the font styles to be used to display the input's text when the
		 * input's <code>currentState</code> property matches the specified
		 * state value.
		 *
		 * <p>If font styles are not defined for a specific state, the value of
		 * the <code>fontStyles</code> property will be used instead.</p>
		 *
		 * <p>Note: if the text editor has been customized with advanced font
		 * formatting, it may override the values specified with
		 * <code>setFontStylesForState()</code> and properties like
		 * <code>fontStyles</code> and <code>disabledFontStyles</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #style:fontStyles
		 */
		public function setFontStylesForState(state:String, format:TextFormat):void
		{
			var key:String = "setFontStylesForState--" + state;
			if(this.processStyleRestriction(key))
			{
				return;
			}
			function changeHandler(event:Event):void
			{
				processStyleRestriction(key);
			}
			var oldFormat:TextFormat = this._fontStylesSet.getFormatForState(state);
			if(oldFormat !== null)
			{
				oldFormat.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.setFormatForState(state, format);
			if(format !== null)
			{
				format.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * Gets the font styles to be used to display the input's prompt when
		 * the input's <code>currentState</code> property matches the specified
		 * state value.
		 *
		 * <p>If prompt font styles are not defined for a specific state, returns
		 * <code>null</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #setPromptFontStylesForState()
		 * @see #promptFontStyles
		 */
		public function getPromptFontStylesForState(state:String):TextFormat
		{
			if(this._promptFontStylesSet === null)
			{
				return null;
			}
			return this._promptFontStylesSet.getFormatForState(state);
		}

		/**
		 * Sets the font styles to be used to display the input's prompt when
		 * the input's <code>currentState</code> property matches the specified
		 * state value.
		 *
		 * <p>If prompt font styles are not defined for a specific state, the
		 * value of the <code>promptFontStyles</code> property will be used instead.</p>
		 *
		 * <p>Note: if the text renderer has been customized with advanced font
		 * formatting, it may override the values specified with
		 * <code>setPromptFontStylesForState()</code> and properties like
		 * <code>promptFontStyles</code> and <code>promptDisabledFontStyles</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #promptFontStyles
		 */
		public function setPromptFontStylesForState(state:String, format:TextFormat):void
		{
			var key:String = "setPromptFontStylesForState--" + state;
			if(this.processStyleRestriction(key))
			{
				return;
			}
			function changeHandler(event:Event):void
			{
				processStyleRestriction(key);
			}
			var oldFormat:TextFormat = this._promptFontStylesSet.getFormatForState(state);
			if(oldFormat !== null)
			{
				oldFormat.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._promptFontStylesSet.setFormatForState(state, format);
			if(format !== null)
			{
				format.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * Gets the skin to be used by the text input when the input's
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If a skin is not defined for a specific state, returns
		 * <code>null</code>.</p>
		 *
		 * @see #setSkinForState()
		 * @see feathers.controls.TextInputState
		 */
		public function getSkinForState(state:String):DisplayObject
		{
			return this._stateToSkin[state] as DisplayObject;
		}

		/**
		 * Sets the skin to be used by the text input when the input's
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If a skin is not defined for a specific state, the value of the
		 * <code>backgroundSkin</code> property will be used instead.</p>
		 *
		 * @see #backgroundSkin
		 * @see #getSkinForState()
		 * @see feathers.controls.TextInputState
		 */
		public function setSkinForState(state:String, skin:DisplayObject):void
		{
			var key:String = "setSkinForState--" + state;
			if(this.processStyleRestriction(key))
			{
				if(skin !== null)
				{
					skin.dispose();
				}
				return;
			}
			var oldSkin:DisplayObject = this._stateToSkin[state] as DisplayObject;
			if(oldSkin !== null &&
				this.currentBackground === oldSkin)
			{
				//if this skin needs to be reused somewhere else, we need to
				//properly clean it up
				this.removeCurrentBackground(oldSkin);
				this.currentBackground = null;
			}
			if(skin !== null)
			{
				this._stateToSkin[state] = skin;
			}
			else
			{
				delete this._stateToSkin[state];
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * Gets the icon to be used by the text input when the input's
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If a icon is not defined for a specific state, returns
		 * <code>null</code>.</p>
		 *
		 * @see #setIconForState()
		 */
		public function getIconForState(state:String):DisplayObject
		{
			return this._stateToIcon[state] as DisplayObject;
		}

		/**
		 * Sets the icon to be used by the text input when the input's
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If an icon is not defined for a specific state, the value of the
		 * <code>defaultIcon</code> property will be used instead.</p>
		 *
		 * @see #defaultIcon
		 * @see #getIconForState()
		 */
		public function setIconForState(state:String, icon:DisplayObject):void
		{
			var key:String = "setIconForState--" + state;
			if(this.processStyleRestriction(key))
			{
				if(icon !== null)
				{
					icon.dispose();
				}
				return;
			}
			if(icon !== null)
			{
				this._stateToIcon[state] = icon;
			}
			else
			{
				delete this._stateToIcon[state];
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			//we don't dispose it if the text input is the parent because it'll
			//already get disposed in super.dispose()
			if(this._backgroundSkin !== null && this._backgroundSkin.parent !== this)
			{
				this._backgroundSkin.dispose();
			}
			for(var state:String in this._stateToSkin)
			{
				var skin:DisplayObject = this._stateToSkin[state] as DisplayObject;
				if(skin !== null && skin.parent !== this)
				{
					skin.dispose();
				}
			}
			if(this._defaultIcon !== null && this._defaultIcon.parent !== this)
			{
				this._defaultIcon.dispose();
			}
			for(state in this._stateToIcon)
			{
				var icon:DisplayObject = this._stateToIcon[state] as DisplayObject;
				if(icon !== null && icon.parent !== this)
				{
					icon.dispose();
				}
			}
			if(this._fontStylesSet !== null)
			{
				this._fontStylesSet.dispose();
				this._fontStylesSet = null;
			}
			if(this._promptFontStylesSet !== null)
			{
				this._promptFontStylesSet.dispose();
				this._promptFontStylesSet = null;
			}
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var skinInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SKIN);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var textEditorInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_TEXT_EDITOR);
			var promptFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_PROMPT_FACTORY);
			var focusInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_FOCUS);

			if(textEditorInvalid)
			{
				this.createTextEditor();
			}

			if(promptFactoryInvalid || (this._prompt !== null && !this.promptTextRenderer))
			{
				this.createPrompt();
			}

			if(textEditorInvalid || stylesInvalid)
			{
				this.refreshTextEditorProperties();
			}

			if(promptFactoryInvalid || stylesInvalid)
			{
				this.refreshPromptProperties();
			}

			if(textEditorInvalid || dataInvalid)
			{
				var oldIgnoreTextChanges:Boolean = this._ignoreTextChanges;
				this._ignoreTextChanges = true;
				this.textEditor.text = this._text;
				this._ignoreTextChanges = oldIgnoreTextChanges;
			}

			if(this.promptTextRenderer)
			{
				if(promptFactoryInvalid || dataInvalid || stylesInvalid)
				{
					this.promptTextRenderer.visible = this._prompt && this._text.length == 0;
				}

				if(promptFactoryInvalid || stateInvalid)
				{
					this.promptTextRenderer.isEnabled = this._isEnabled;
				}
			}

			if(textEditorInvalid || stateInvalid)
			{
				this.textEditor.isEnabled = this._isEnabled;
				if(!this._isEnabled && Mouse.supportsNativeCursor && this._oldMouseCursor)
				{
					Mouse.cursor = this._oldMouseCursor;
					this._oldMouseCursor = null;
				}
			}

			if(stateInvalid || skinInvalid)
			{
				this.refreshBackgroundSkin();
			}
			if(stateInvalid || stylesInvalid)
			{
				this.refreshIcon();
			}

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			this.layoutChildren();

			//the state might not change if the text input has focus when
			//the error string changes, so check for styles too!
			if(stateInvalid || stylesInvalid)
			{
				this.refreshErrorCallout();
			}

			if(sizeInvalid || focusInvalid)
			{
				this.refreshFocusIndicator();
			}

			this.doPendingActions();
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			var measureBackground:IMeasureDisplayObject = this.currentBackground as IMeasureDisplayObject;
			resetFluidChildDimensionsForMeasurement(this.currentBackground,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitBackgroundWidth, this._explicitBackgroundHeight,
				this._explicitBackgroundMinWidth, this._explicitBackgroundMinHeight,
				this._explicitBackgroundMaxWidth, this._explicitBackgroundMaxHeight);
			if(this.currentBackground is IValidating)
			{
				IValidating(this.currentBackground).validate();
			}
			if(this.currentIcon is IValidating)
			{
				IValidating(this.currentIcon).validate();
			}

			var measuredContentWidth:Number = 0;
			var measuredContentHeight:Number = 0;

			//if the typicalText is specified, the dimensions of the text editor
			//can affect the final dimensions. otherwise, the background skin or
			//prompt should be used for measurement.
			if(this._typicalText !== null)
			{
				var point:Point = Pool.getPoint();
				var oldTextEditorWidth:Number = this.textEditor.width;
				var oldTextEditorHeight:Number = this.textEditor.height;
				var oldIgnoreTextChanges:Boolean = this._ignoreTextChanges;
				this._ignoreTextChanges = true;
				this.textEditor.setSize(NaN, NaN);
				this.textEditor.text = this._typicalText;
				this.textEditor.measureText(point);
				this.textEditor.text = this._text;
				this._ignoreTextChanges = oldIgnoreTextChanges;
				measuredContentWidth = point.x;
				measuredContentHeight = point.y;
				Pool.putPoint(point);
			}
			if(this._prompt !== null)
			{
				point = Pool.getPoint();
				this.promptTextRenderer.setSize(NaN, NaN);
				this.promptTextRenderer.measureText(point);
				if(point.x > measuredContentWidth)
				{
					measuredContentWidth = point.x;
				}
				if(point.y > measuredContentHeight)
				{
					measuredContentHeight = point.y;
				}
				Pool.putPoint(point);
			}

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				newWidth = measuredContentWidth;
				if(this._originalIconWidth === this._originalIconWidth) //!isNaN
				{
					newWidth += this._originalIconWidth + this._gap;
				}
				newWidth += this._paddingLeft + this._paddingRight;
				if(this.currentBackground !== null &&
					this.currentBackground.width > newWidth)
				{
					newWidth = this.currentBackground.width;
				}
			}
			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				newHeight = measuredContentHeight;
				if(this._originalIconHeight === this._originalIconHeight && //!isNaN
					this._originalIconHeight > newHeight)
				{
					newHeight = this._originalIconHeight;
				}
				newHeight += this._paddingTop + this._paddingBottom;
				if(this.currentBackground !== null &&
					this.currentBackground.height > newHeight)
				{
					newHeight = this.currentBackground.height;
				}
			}

			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				newMinWidth = measuredContentWidth;
				if(this.currentIcon is IFeathersControl)
				{
					newMinWidth += IFeathersControl(this.currentIcon).minWidth + this._gap;
				}
				else if(this._originalIconWidth === this._originalIconWidth)
				{
					newMinWidth += this._originalIconWidth + this._gap;
				}
				newMinWidth += this._paddingLeft + this._paddingRight;
				var backgroundMinWidth:Number = 0;
				if(measureBackground !== null)
				{
					backgroundMinWidth = measureBackground.minWidth;
				}
				else if(this.currentBackground !== null)
				{
					backgroundMinWidth = this._explicitBackgroundMinWidth;
				}
				if(backgroundMinWidth > newMinWidth)
				{
					newMinWidth = backgroundMinWidth;
				}
			}
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				newMinHeight = measuredContentHeight;
				if(this.currentIcon is IFeathersControl)
				{
					var iconMinHeight:Number = IFeathersControl(this.currentIcon).minHeight;
					if(iconMinHeight > newMinHeight)
					{
						newMinHeight = iconMinHeight;
					}
				}
				else if(this._originalIconHeight === this._originalIconHeight && //!isNaN
					this._originalIconHeight > newMinHeight)
				{
					newMinHeight = this._originalIconHeight;
				}
				newMinHeight += this._paddingTop + this._paddingBottom;
				var backgroundMinHeight:Number = 0;
				if(measureBackground !== null)
				{
					backgroundMinHeight = measureBackground.minHeight;
				}
				else if(this.currentBackground !== null)
				{
					backgroundMinHeight = this._explicitBackgroundMinHeight;
				}
				if(backgroundMinHeight > newMinHeight)
				{
					newMinHeight = backgroundMinHeight;
				}
			}

			var isMultiline:Boolean = this.textEditor is IMultilineTextEditor && IMultilineTextEditor(this.textEditor).multiline;
			if(this._typicalText !== null && (this._verticalAlign == VerticalAlign.JUSTIFY || isMultiline))
			{
				this.textEditor.width = oldTextEditorWidth;
				this.textEditor.height = oldTextEditorHeight;
			}

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * Creates and adds the <code>textEditor</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #textEditor
		 * @see #textEditorFactory
		 */
		protected function createTextEditor():void
		{
			if(this.textEditor)
			{
				this.removeChild(DisplayObject(this.textEditor), true);
				this.textEditor.removeEventListener(Event.CHANGE, textEditor_changeHandler);
				this.textEditor.removeEventListener(FeathersEventType.ENTER, textEditor_enterHandler);
				this.textEditor.removeEventListener(FeathersEventType.FOCUS_IN, textEditor_focusInHandler);
				this.textEditor.removeEventListener(FeathersEventType.FOCUS_OUT, textEditor_focusOutHandler);
				this.textEditor = null;
			}

			var factory:Function = this._textEditorFactory != null ? this._textEditorFactory : FeathersControl.defaultTextEditorFactory;
			this.textEditor = ITextEditor(factory());
			var textEditorStyleName:String = this._customTextEditorStyleName != null ? this._customTextEditorStyleName : this.textEditorStyleName;
			this.textEditor.styleNameList.add(textEditorStyleName);
			if(this.textEditor is IStateObserver)
			{
				IStateObserver(this.textEditor).stateContext = this;
			}
			this.textEditor.addEventListener(Event.CHANGE, textEditor_changeHandler);
			this.textEditor.addEventListener(FeathersEventType.ENTER, textEditor_enterHandler);
			this.textEditor.addEventListener(FeathersEventType.FOCUS_IN, textEditor_focusInHandler);
			this.textEditor.addEventListener(FeathersEventType.FOCUS_OUT, textEditor_focusOutHandler);
			this.addChild(DisplayObject(this.textEditor));
		}

		/**
		 * @private
		 */
		protected function createPrompt():void
		{
			if(this.promptTextRenderer)
			{
				this.removeChild(DisplayObject(this.promptTextRenderer), true);
				this.promptTextRenderer = null;
			}

			if(this._prompt === null)
			{
				return;
			}

			var factory:Function = this._promptFactory != null ? this._promptFactory : FeathersControl.defaultTextRendererFactory;
			this.promptTextRenderer = ITextRenderer(factory());
			var promptStyleName:String = this._customPromptStyleName != null ? this._customPromptStyleName : this.promptStyleName;
			this.promptTextRenderer.styleNameList.add(promptStyleName);
			this.addChild(DisplayObject(this.promptTextRenderer));
		}

		/**
		 * @private
		 */
		protected function createErrorCallout():void
		{
			if(this.callout !== null)
			{
				this.callout.removeFromParent(true);
				this.callout = null;
			}

			if(this._errorString === null)
			{
				return;
			}
			
			var factory:Function = this._errorCalloutFactory != null ? this._errorCalloutFactory : defaultErrorCalloutFactory;
			this.callout = TextCallout(factory());
			var errorCalloutStyleName:String = this._customErrorCalloutStyleName != null ? this._customErrorCalloutStyleName : this.errorCalloutStyleName;
			this.callout.styleNameList.add(errorCalloutStyleName);
			this.callout.closeOnKeys = null;
			this.callout.closeOnTouchBeganOutside = false;
			this.callout.closeOnTouchEndedOutside = false;
			this.callout.touchable = false;
			this.callout.origin = this;
			PopUpManager.addPopUp(this.callout, false, false);
		}

		/**
		 * @private
		 */
		protected function changeState(state:String):void
		{
			if(this._currentState === state)
			{
				return;
			}
			this._currentState = state;
			this.invalidate(INVALIDATION_FLAG_STATE);
			this.dispatchEventWith(FeathersEventType.STATE_CHANGE);
		}

		/**
		 * @private
		 */
		protected function doPendingActions():void
		{
			if(this._isWaitingToSetFocus)
			{
				this._isWaitingToSetFocus = false;
				if(!this._textEditorHasFocus)
				{
					if((this._isEditable || this._isSelectable) &&
						this._pendingSelectionBeginIndex < 0)
					{
						this._pendingSelectionBeginIndex = 0;
						this._pendingSelectionEndIndex = this._text.length;
					}
					this.textEditor.setFocus();
				}
			}
			if(this._pendingSelectionBeginIndex >= 0)
			{
				var startIndex:int = this._pendingSelectionBeginIndex;
				var endIndex:int = this._pendingSelectionEndIndex;
				this._pendingSelectionBeginIndex = -1;
				this._pendingSelectionEndIndex = -1;
				if(endIndex >= 0)
				{
					var textLength:int = this._text.length;
					if(endIndex > textLength)
					{
						endIndex = textLength;
					}
				}
				this.selectRange(startIndex, endIndex);
			}
		}

		/**
		 * @private
		 */
		protected function refreshTextEditorProperties():void
		{
			this.textEditor.displayAsPassword = this._displayAsPassword;
			this.textEditor.maxChars = this._maxChars;
			this.textEditor.restrict = this._restrict;
			this.textEditor.isEditable = this._isEditable;
			this.textEditor.isSelectable = this._isSelectable;
			this.textEditor.fontStyles = this._fontStylesSet;
			for(var propertyName:String in this._textEditorProperties)
			{
				var propertyValue:Object = this._textEditorProperties[propertyName];
				this.textEditor[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function refreshPromptProperties():void
		{
			if(!this.promptTextRenderer)
			{
				return;
			}
			this.promptTextRenderer.text = this._prompt;
			this.promptTextRenderer.fontStyles = this._promptFontStylesSet;
			for(var propertyName:String in this._promptProperties)
			{
				var propertyValue:Object = this._promptProperties[propertyName];
				this.promptTextRenderer[propertyName] = propertyValue;
			}
		}

		/**
		 * Sets the <code>currentBackground</code> property.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected function refreshBackgroundSkin():void
		{
			var oldSkin:DisplayObject = this.currentBackground;
			this.currentBackground = this.getCurrentSkin();
			if(this.currentBackground !== oldSkin)
			{
				this.removeCurrentBackground(oldSkin);
				if(this.currentBackground !== null)
				{
					if(this.currentBackground is IStateObserver)
					{
						IStateObserver(this.currentBackground).stateContext = this;
					}
					if(this.currentBackground is IFeathersControl)
					{
						IFeathersControl(this.currentBackground).initializeNow();
					}
					if(this.currentBackground is IMeasureDisplayObject)
					{
						var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this.currentBackground);
						this._explicitBackgroundWidth = measureSkin.explicitWidth;
						this._explicitBackgroundHeight = measureSkin.explicitHeight;
						this._explicitBackgroundMinWidth = measureSkin.explicitMinWidth;
						this._explicitBackgroundMinHeight = measureSkin.explicitMinHeight;
						this._explicitBackgroundMaxWidth = measureSkin.explicitMaxWidth;
						this._explicitBackgroundMaxHeight = measureSkin.explicitMaxHeight;
					}
					else
					{
						this._explicitBackgroundWidth = this.currentBackground.width;
						this._explicitBackgroundHeight = this.currentBackground.height;
						this._explicitBackgroundMinWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMinHeight = this._explicitBackgroundHeight;
						this._explicitBackgroundMaxWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMaxHeight = this._explicitBackgroundHeight;
					}
					this.addChildAt(this.currentBackground, 0);
				}
			}
		}

		/**
		 * @private
		 */
		protected function removeCurrentBackground(skin:DisplayObject):void
		{
			if(skin === null)
			{
				return;
			}
			if(skin is IStateObserver)
			{
				IStateObserver(skin).stateContext = null;
			}
			if(skin.parent === this)
			{
				//we need to restore these values so that they won't be lost the
				//next time that this skin is used for measurement
				skin.width = this._explicitBackgroundWidth;
				skin.height = this._explicitBackgroundHeight;
				if(skin is IMeasureDisplayObject)
				{
					var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(skin);
					measureSkin.minWidth = this._explicitBackgroundMinWidth;
					measureSkin.minHeight = this._explicitBackgroundMinHeight;
					measureSkin.maxWidth = this._explicitBackgroundMaxWidth;
					measureSkin.maxHeight = this._explicitBackgroundMaxHeight;
				}
				skin.removeFromParent(false);
			}
		}

		/**
		 * Sets the <code>currentIcon</code> property.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected function refreshIcon():void
		{
			var oldIcon:DisplayObject = this.currentIcon;
			this.currentIcon = this.getCurrentIcon();
			if(this.currentIcon is IFeathersControl)
			{
				IFeathersControl(this.currentIcon).isEnabled = this._isEnabled;
			}
			if(this.currentIcon !== oldIcon)
			{
				if(oldIcon)
				{
					if(oldIcon is IStateObserver)
					{
						IStateObserver(oldIcon).stateContext = null;
					}
					this.removeChild(oldIcon, false);
				}
				if(this.currentIcon)
				{
					if(this.currentIcon is IStateObserver)
					{
						IStateObserver(this.currentIcon).stateContext = this;
					}
					//we want the icon to appear below the text editor
					var index:int = this.getChildIndex(DisplayObject(this.textEditor));
					this.addChildAt(this.currentIcon, index);
				}
			}
			if(this.currentIcon &&
				(this._originalIconWidth !== this._originalIconWidth || //isNaN
				this._originalIconHeight !== this._originalIconHeight)) //isNaN
			{
				if(this.currentIcon is IValidating)
				{
					IValidating(this.currentIcon).validate();
				}
				this._originalIconWidth = this.currentIcon.width;
				this._originalIconHeight = this.currentIcon.height;
			}
		}

		/**
		 * @private
		 */
		protected function getCurrentSkin():DisplayObject
		{
			var result:DisplayObject = this._stateToSkin[this._currentState] as DisplayObject;
			if(result !== null)
			{
				return result;
			}
			return this._backgroundSkin;
		}

		/**
		 * @private
		 */
		protected function getCurrentIcon():DisplayObject
		{
			var result:DisplayObject = this._stateToIcon[this._currentState] as DisplayObject;
			if(result !== null)
			{
				return result;
			}
			return this._defaultIcon;
		}

		/**
		 * Positions and sizes the text input's children.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected function layoutChildren():void
		{
			if(this.currentBackground !== null)
			{
				this.currentBackground.visible = true;
				this.currentBackground.touchable = true;
				this.currentBackground.width = this.actualWidth;
				this.currentBackground.height = this.actualHeight;
			}

			if(this.currentIcon is IValidating)
			{
				IValidating(this.currentIcon).validate();
			}

			if(this.currentIcon !== null)
			{
				if(this._iconPosition === RelativePosition.RIGHT)
				{
					this.currentIcon.x = this.actualWidth - this.currentIcon.width - this._paddingRight;
					this.textEditor.x = this._paddingLeft;
					if(this.promptTextRenderer !== null)
					{
						this.promptTextRenderer.x = this._paddingLeft;
					}
				}
				else //left
				{
					this.currentIcon.x = this._paddingLeft;
					this.textEditor.x = this.currentIcon.x + this.currentIcon.width + this._gap;
					if(this.promptTextRenderer !== null)
					{
						this.promptTextRenderer.x = this.currentIcon.x + this.currentIcon.width + this._gap;
					}
				}
			}
			else
			{
				this.textEditor.x = this._paddingLeft;
				if(this.promptTextRenderer !== null)
				{
					this.promptTextRenderer.x = this._paddingLeft;
				}
			}

			var textEditorWidth:Number = this.actualWidth - this._paddingRight - this.textEditor.x;
			if(this.currentIcon !== null && this._iconPosition === RelativePosition.RIGHT)
			{
				textEditorWidth -= (this.currentIcon.width + this._gap);
			}
			this.textEditor.width = textEditorWidth;
			if(this.promptTextRenderer !== null)
			{
				this.promptTextRenderer.width = textEditorWidth;
			}

			var isMultiline:Boolean = this.textEditor is IMultilineTextEditor && IMultilineTextEditor(this.textEditor).multiline;
			if(isMultiline || this._verticalAlign === VerticalAlign.JUSTIFY)
			{
				//multiline is treated the same as justify
				this.textEditor.height = this.actualHeight - this._paddingTop - this._paddingBottom;
			}
			else
			{
				//clear the height and auto-size instead
				this.textEditor.height = NaN;
			}
			this.textEditor.validate();
			if(this.promptTextRenderer !== null)
			{
				this.promptTextRenderer.validate();
			}

			var biggerHeight:Number = this.textEditor.height;
			var biggerBaseline:Number = this.textEditor.baseline;
			if(this.promptTextRenderer !== null)
			{
				var promptBaseline:Number = this.promptTextRenderer.baseline;
				var promptHeight:Number = this.promptTextRenderer.height;
				if(promptBaseline > biggerBaseline)
				{
					biggerBaseline = promptBaseline;
				}
				if(promptHeight > biggerHeight)
				{
					biggerHeight = promptHeight;
				}
			}

			if(isMultiline)
			{
				this.textEditor.y = this._paddingTop + biggerBaseline - this.textEditor.baseline;
				if(this.promptTextRenderer !== null)
				{
					this.promptTextRenderer.y = this._paddingTop + biggerBaseline - promptBaseline;
					this.promptTextRenderer.height = this.actualHeight - this.promptTextRenderer.y - this._paddingBottom;
				}
				if(this.currentIcon !== null)
				{
					this.currentIcon.y = this._paddingTop;
				}
			}
			else
			{
				switch(this._verticalAlign)
				{
					case VerticalAlign.JUSTIFY:
					{
						this.textEditor.y = this._paddingTop + biggerBaseline - this.textEditor.baseline;
						if(this.promptTextRenderer)
						{
							this.promptTextRenderer.y = this._paddingTop + biggerBaseline - promptBaseline;
							this.promptTextRenderer.height = this.actualHeight - this.promptTextRenderer.y - this._paddingBottom;
						}
						if(this.currentIcon)
						{
							this.currentIcon.y = this._paddingTop;
						}
						break;
					}
					case VerticalAlign.TOP:
					{
						this.textEditor.y = this._paddingTop + biggerBaseline - this.textEditor.baseline;
						if(this.promptTextRenderer)
						{
							this.promptTextRenderer.y = this._paddingTop + biggerBaseline - promptBaseline;
						}
						if(this.currentIcon)
						{
							this.currentIcon.y = this._paddingTop;
						}
						break;
					}
					case VerticalAlign.BOTTOM:
					{
						this.textEditor.y = this.actualHeight - this._paddingBottom - biggerHeight + biggerBaseline - this.textEditor.baseline;
						if(this.promptTextRenderer)
						{
							this.promptTextRenderer.y = this.actualHeight - this._paddingBottom - biggerHeight + biggerBaseline - promptBaseline;
						}
						if(this.currentIcon)
						{
							this.currentIcon.y = this.actualHeight - this._paddingBottom - this.currentIcon.height;
						}
						break;
					}
					default: //middle
					{
						this.textEditor.y = biggerBaseline - this.textEditor.baseline + this._paddingTop + Math.round((this.actualHeight - this._paddingTop - this._paddingBottom - biggerHeight) / 2);
						if(this.promptTextRenderer)
						{
							this.promptTextRenderer.y = biggerBaseline - promptBaseline + this._paddingTop + Math.round((this.actualHeight - this._paddingTop - this._paddingBottom - biggerHeight) / 2);
						}
						if(this.currentIcon)
						{
							this.currentIcon.y = this._paddingTop + Math.round((this.actualHeight - this._paddingTop - this._paddingBottom - this.currentIcon.height) / 2);
						}
					}
				}
			}
		}

		/**
		 * @private
		 */
		protected function setFocusOnTextEditorWithTouch(touch:Touch):void
		{
			if(!this.isFocusEnabled)
			{
				return;
			}

			var point:Point = Pool.getPoint();
			touch.getLocation(this.stage, point);
			var isInBounds:Boolean = this.contains(this.stage.hitTest(point));
			//if the focus manager is enabled, _hasFocus will determine if we
			//pass focus to the text editor.
			//if there is no focus manager, then we check if the touch is in
			//the bounds of the text input.
			if((this._hasFocus || isInBounds) && !this._textEditorHasFocus)
			{
				this.textEditor.globalToLocal(point, point);
				this._isWaitingToSetFocus = false;
				this.textEditor.setFocus(point);
			}
			Pool.putPoint(point);
		}

		/**
		 * @private
		 */
		protected function refreshState():void
		{
			if(this._isEnabled)
			{
				//this component can have focus while its text editor does not
				//have focus. StageText, in particular, can't receive focus
				//when its enabled property is false, but we still want to show
				//that the input is focused.
				if(this._textEditorHasFocus || this._hasFocus)
				{
					this.changeState(TextInputState.FOCUSED);
				}
				else if(this._errorString !== null)
				{
					this.changeState(TextInputState.ERROR);
				}
				else
				{
					this.changeState(TextInputState.ENABLED);
				}
			}
			else
			{
				this.changeState(TextInputState.DISABLED);
			}
		}

		/**
		 * @private
		 */
		protected function refreshErrorCallout():void
		{
			if(this._textEditorHasFocus && this.callout === null &&
				this._errorString !== null && this._errorString.length > 0)
			{
				this.createErrorCallout();
			}
			else if(this.callout !== null &&
				(!this._textEditorHasFocus || this._errorString === null || this._errorString.length == 0))
			{
				this.callout.removeFromParent(true);
				this.callout = null;
			}
			if(this.callout !== null)
			{
				this.callout.text = this._errorString;
			}
		}

		/**
		 * @private
		 */
		protected function childProperties_onChange(proxy:PropertyProxy, name:Object):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function textInput_removedFromStageHandler(event:Event):void
		{
			if(!this._focusManager && this._textEditorHasFocus)
			{
				this.clearFocus();
			}
			this._textEditorHasFocus = false;
			this._isWaitingToSetFocus = false;
			this._touchPointID = -1;
			if(Mouse.supportsNativeCursor && this._oldMouseCursor)
			{
				Mouse.cursor = this._oldMouseCursor;
				this._oldMouseCursor = null;
			}
		}

		/**
		 * @private
		 */
		protected function textInput_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._touchPointID = -1;
				return;
			}

			if(this._touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this, TouchPhase.ENDED, this._touchPointID);
				if(!touch)
				{
					return;
				}
				var point:Point = Pool.getPoint();
				touch.getLocation(this.stage, point);
				var isInBounds:Boolean = this.contains(this.stage.hitTest(point));
				Pool.putPoint(point);
				if(!isInBounds)
				{
					//if not in bounds on TouchPhase.ENDED, there won't be a
					//hover end event, so we need to clear the mouse cursor
					if(Mouse.supportsNativeCursor && this._oldMouseCursor)
					{
						Mouse.cursor = this._oldMouseCursor;
						this._oldMouseCursor = null;
					}
				}
				this._touchPointID = -1;
				if(this.textEditor.setTouchFocusOnEndedPhase)
				{
					this.setFocusOnTextEditorWithTouch(touch);
				}
			}
			else
			{
				touch = event.getTouch(this, TouchPhase.BEGAN);
				if(touch)
				{
					this._touchPointID = touch.id;
					if(!this.textEditor.setTouchFocusOnEndedPhase)
					{
						this.setFocusOnTextEditorWithTouch(touch);
					}
					return;
				}
				touch = event.getTouch(this, TouchPhase.HOVER);
				if(touch)
				{
					if((this._isEditable || this._isSelectable) &&
						Mouse.supportsNativeCursor && !this._oldMouseCursor)
					{
						this._oldMouseCursor = Mouse.cursor;
						Mouse.cursor = MouseCursor.IBEAM;
					}
					return;
				}

				//end hover
				if(Mouse.supportsNativeCursor && this._oldMouseCursor)
				{
					Mouse.cursor = this._oldMouseCursor;
					this._oldMouseCursor = null;
				}
			}
		}

		/**
		 * @private
		 */
		override protected function focusInHandler(event:Event):void
		{
			if(!this._focusManager)
			{
				return;
			}
			super.focusInHandler(event);
			//in some cases the text editor cannot receive focus, so it won't
			//dispatch an event. we need to detect the focused state using the
			//_hasFocus variable
			this.refreshState();
			this.setFocus();
		}

		/**
		 * @private
		 */
		override protected function focusOutHandler(event:Event):void
		{
			if(!this._focusManager)
			{
				return;
			}
			super.focusOutHandler(event);
			//similar to above, we refresh the state based on the _hasFocus
			//because the text editor may not be able to receive focus
			this.refreshState();
			this.textEditor.clearFocus();
		}

		/**
		 * @private
		 */
		protected function textEditor_changeHandler(event:Event):void
		{
			if(this._ignoreTextChanges)
			{
				return;
			}
			this.text = this.textEditor.text;
		}

		/**
		 * @private
		 */
		protected function textEditor_enterHandler(event:Event):void
		{
			this.dispatchEventWith(FeathersEventType.ENTER);
		}

		/**
		 * @private
		 */
		protected function textEditor_focusInHandler(event:Event):void
		{
			if(!this.visible)
			{
				this.textEditor.clearFocus();
				return;
			}
			this._textEditorHasFocus = true;
			this.refreshState();
			this.refreshErrorCallout();
			if(this._focusManager !== null && this.isFocusEnabled)
			{
				if(this._focusManager.focus !== this)
				{
					//if setFocus() was called manually, we need to notify the focus
					//manager (unless isFocusEnabled is false).
					//if the focus manager already knows that we have focus, it will
					//simply return without doing anything.
					this._focusManager.focus = this;
				}
			}
			else
			{
				this.dispatchEventWith(FeathersEventType.FOCUS_IN);
			}
		}

		/**
		 * @private
		 */
		protected function textEditor_focusOutHandler(event:Event):void
		{
			this._textEditorHasFocus = false;
			this.refreshState();
			this.refreshErrorCallout();
			if(this._focusManager !== null && this.isFocusEnabled)
			{
				if(this._focusManager.focus === this)
				{
					//if clearFocus() was called manually, we need to notify the
					//focus manager if it still thinks we have focus.
					this._focusManager.focus = null;
				}
			}
			else
			{
				this.dispatchEventWith(FeathersEventType.FOCUS_OUT);
			}
		}

		/**
		 * @private
		 */
		protected function fontStyles_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}
	}
}


================================================
FILE: source/feathers/controls/TextInputState.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * States for text input components.
	 *
	 * @see feathers.controls.TextInput
	 * @see feathers.controls.TextArea
	 * @see feathers.controls.AutoComplete
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class TextInputState
	{
		/**
		 * The default state, when the input is enabled.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const ENABLED:String = "enabled";

		/**
		 * The disabled state, when the input is not enabled.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const DISABLED:String = "disabled";

		/**
		 * The focused state, when the input is currently in focus and the user
		 * can interact with it.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const FOCUSED:String = "focused";

		/**
		 * The state when the input has an error string.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const ERROR:String = "error";
	}
}


================================================
FILE: source/feathers/controls/Toast.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.ITextRenderer;
	import feathers.core.IValidating;
	import feathers.core.PopUpManager;
	import feathers.data.IListCollection;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.RelativePosition;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.motion.Fade;
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.skins.IStyleProvider;
	import feathers.system.DeviceCapabilities;
	import feathers.text.FontStylesSet;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;

	import flash.geom.Point;
	import flash.utils.Dictionary;
	import flash.utils.getTimer;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.events.Event;
	import starling.text.TextFormat;
	import starling.utils.Pool;

	/**
	 * The primary background to display behind the toast's content.
	 *
	 * <p>In the following example, the toast's background is set to an image:</p>
	 *
	 * <listing version="3.0">
	 * toast.backgroundSkin = new Image( texture );</listing>
	 *
	 * @default null
	 */
	[Style(name="backgroundSkin",type="starling.display.DisplayObject")]

	/**
	 * A style name to add to the toast's actions button group sub-component.
	 * Typically used by a theme to provide different styles to different toasts.
	 *
	 * <p>In the following example, a custom actions button group style name is
	 * passed to the toast:</p>
	 *
	 * <listing version="3.0">
	 * toast.customActionsStyleName = "my-custom-toast-actions";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( ButtonGroup ).setFunctionForStyleName( "my-custom-toast-actions", setCustomToastActionsStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_ACTIONS
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #actionsFactory
	 */
	[Style(name="customActionsStyleName",type="String")]

	/**
	 * A style name to add to the toast's message text renderer
	 * sub-component. Typically used by a theme to provide different styles
	 * to different toasts.
	 *
	 * <p>In the following example, a custom message style name is passed to
	 * the toast:</p>
	 *
	 * <listing version="3.0">
	 * toast.customMessageStyleName = "my-custom-toast-message";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( BitmapFontTextRenderer ).setFunctionForStyleName( "my-custom-toast-message", setCustomToastMessageStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_MESSAGE
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #messageFactory
	 */
	[Style(name="customLabelStyleName",type="String")]

	/**
	 * The font styles used to display the toast's message when the button is
	 * disabled.
	 *
	 * <p>In the following example, the disabled font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * toast.disabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>messageFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:fontStyles
	 */
	[Style(name="disabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the toast's message.
	 *
	 * <p>In the following example, the font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * toast.fontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>messageFactory</code> to set more advanced styles.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #disabledFontStyles
	 */
	[Style(name="fontStyles",type="starling.text.TextFormat")]

	/**
	 * The space, in pixels, between the message text renderer and the actions
	 * button group. Applies to either horizontal or vertical spacing, depending
	 * on the value of <code>actionsPosition</code>.
	 *
	 * <p>If <code>gap</code> is set to <code>Number.POSITIVE_INFINITY</code>,
	 * the message and actions will be positioned as far apart as possible. In
	 * other words, they will be positioned at the edges of the toast,
	 * adjusted for padding.</p>
	 *
	 * <p>The following example creates a gap of 50 pixels between the label
	 * and the icon:</p>
	 *
	 * <listing version="3.0">
	 * toast.gap = 50;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:iconPosition
	 * @see #style:minGap
	 */
	[Style(name="gap",type="Number")]

	/**
	 * If the value of the <code>gap</code> property is
	 * <code>Number.POSITIVE_INFINITY</code>, meaning that the gap will
	 * fill as much space as possible, the final calculated value will not be
	 * smaller than the value of the <code>minGap</code> property.
	 *
	 * <p>The following example ensures that the gap is never smaller than
	 * 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * toast.gap = Number.POSITIVE_INFINITY;
	 * toast.minGap = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:gap
	 */
	[Style(name="minGap",type="Number")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the padding of all sides of the toast
	 * is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * toast.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, between the toast's top edge and the
	 * toast's content.
	 *
	 * <p>In the following example, the padding on the top edge of the
	 * toast is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * toast.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the toast's right edge and
	 * the toast's content.
	 *
	 * <p>In the following example, the padding on the right edge of the
	 * toast is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * toast.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the toast's bottom edge and
	 * the toast's content.
	 *
	 * <p>In the following example, the padding on the bottom edge of the
	 * toast is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * toast.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the toast's left edge and the
	 * toast's content.
	 *
	 * <p>In the following example, the padding on the left edge of the
	 * toast is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * toast.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * Dispatched when the toast is opened. This event is dispatched after the
	 * <code>openEffect</code> has completed, if one is defined.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.OPEN
	 *
	 * @see #openEffect
	 * @see #event:close starling.events.Event.CLOSE
	 */
	[Event(name="open",type="starling.events.Event")]

	/**
	 * Dispatched when the toast is closed. This event is dispatched after the
	 * <code>closeEffect</code> has completed, if one is defined.
	 *
	 * <p>The <code>data</code> property of the event object will contain
	 * the item from the <code>ButtonGroup</code> data provider for the button
	 * that is triggered. If no button is triggered, then the <code>data</code>
	 * property will be <code>null</code>.</p>
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The triggered button, or
	 *   <code>null</code></td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CLOSE
	 *
	 * @see #close()
	 * @see #closeEffect
	 * @see #event:open starling.events.Event.OPEN
	 */
	[Event(name="close",type="starling.events.Event")]

	/**
	 * Displays a notification-like message in a popup over the rest of your
	 * app's content. May contain a message and optional actions, or completely
	 * custom content.
	 *
	 * <p>In the following example, a toast displaying a message and actions is
	 * triggered:</p>
	 *
	 * <listing version="3.0">
	 * button.addEventListener( Event.TRIGGERED, button_triggeredHandler );
	 * 
	 * function button_triggeredHandler( event:Event ):void
	 * {
	 *     Toast.showMessageWithActions( "Item deleted", new ArrayCollection([{ label: "Undo" }]) );
	 * }</listing>
	 *
	 * <p><a href="https://feathersui.com/help/beta-policy.html" target="_blank"><strong>Beta Component:</strong></a> This is a new component, and its APIs
	 * may need some changes between now and the next version of Feathers to
	 * account for overlooked requirements or other issues. Upgrading to future
	 * versions of Feathers may involve manual changes to your code that uses
	 * this component. The
	 * <a href="https://feathersui.com/help/deprecation-policy.html" target="_blank">Feathers deprecation policy</a>
	 * will not go into effect until this component's status is upgraded from
	 * beta to stable.</p>
	 *
	 * @see ../../../help/toast.html How to use the Feathers Toast component
	 * @see #showMessage()
	 * @see #showMessageWithActions()
	 * @see #showContent()
	 *
	 * @productversion Feathers 4.0.0
	 */
	public class Toast extends FeathersControl
	{
		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * message text renderer.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 * @see ../../../help/text-renderers.html Introduction to Feathers text renderers
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_MESSAGE:String = "feathers-toast-message";

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * actions button group.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ACTIONS:String = "feathers-toast-actions";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_ACTIONS_FACTORY:String = "actionsFactory";

		/**
		 * The default <code>IStyleProvider</code> for all <code>Toast</code>
		 * components.
		 *
		 * @default null
		 *
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		private static var _maxVisibleToasts:int = 1;

		/**
		 * The maximum number of toasts that can be displayed simultaneously.
		 * Additional toasts will be queued up to display after the current
		 * toasts are removed.
		 */
		public static function get maxVisibleToasts():int
		{
			return _maxVisibleToasts;
		}

		/**
		 * @private
		 */
		public static function set maxVisibleToasts(value:int):void
		{
			if(_maxVisibleToasts == value)
			{
				return;
			}
			if(value <= 0)
			{
				throw new RangeError("maxVisibleToasts must be greater than 0.");
			}
			_maxVisibleToasts = value;
			while(_activeToasts.length < _maxVisibleToasts && _queue.length > 0)
			{
				showNextInQueue();
			}
		}

		/**
		 * @private
		 */
		private static var _queueMode:String = ToastQueueMode.CANCEL_TIMEOUT;

		/**
		 * Determines how timeouts are treated when toasts need to be queued up
		 * because there are already <code>maxVisibleToasts</code> visible.
		 * Either waits until the timeout is complete, or immediately closes an
		 * existing toast and shows the queued toast after the closing effect is
		 * done.
		 */
		public static function get queueMode():String
		{
			return _queueMode;
		}

		/**
		 * @private
		 */
		public static function set queueMode(value:String):void
		{
			_queueMode = value;
		}

		/**
		 * @private
		 */
		private static var _toastFactory:Function = defaultToastFactory;

		/**
		 * Used to create a new <code>Toast</code> instance in the
		 * <code>showMessage()</code>, <code>showMessageWithActions()</code>, or
		 * <code>showContent()</code> functions. Useful for customizing the
		 * styles of toasts without a theme.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 *
		 * <pre>function():Toast</pre>
		 *
		 * <p>The following example shows how to create a custom toast factory:</p>
		 *
		 * <listing version="3.0">
		 * Toast.toastFactory = function():Toast
		 * {
		 *     var toast:Toast = new Toast();
		 *     toast.backgroundSkin = new Image( texture );
		 *     toast.padding = 10;
		 *     return toast;
		 * };</listing>
		 *
		 * @see #showMessage()
		 * @see #showMessageWithStyles()
		 * @see #showContent()
		 */
		public static function get toastFactory():Function
		{
			return Toast._toastFactory;
		}

		/**
		 * @private
		 */
		public static function set toastFactory(value:Function):void
		{
			Toast._toastFactory = value;
		}

		/**
		 * @private
		 */
		private static var _containerFactory:Function = defaultContainerFactory;

		/**
		 * Create a container for toasts that is added to the pop-up manager.
		 * Useful for customizing the layout of toasts.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 *
		 * <pre>function():DisplayObjectContainer</pre>
		 *
		 * <p>The following example shows how to create a custom toast container:</p>
		 *
		 * <listing version="3.0">
		 * Toast.containerFactory = function():DisplayObjectContainer
		 * {
		 *     var container:LayoutGroup = new LayoutGroup();
		 *     container.layout = new VerticalLayout();
		 *     return container;
		 * };</listing>
		 *
		 * @see #showMessage()
		 * @see #showMessageWithStyles()
		 * @see #showContent()
		 */
		public static function get containerFactory():Function
		{
			return Toast._containerFactory;
		}

		/**
		 * @private
		 */
		public static function set containerFactory(value:Function):void
		{
			Toast._containerFactory = value;
		}

		/**
		 * @private
		 */
		protected static var _activeToasts:Vector.<Toast> = new <Toast>[];

		/**
		 * @private
		 */
		protected static var _queue:Vector.<Toast> = new <Toast>[];

		/**
		 * @private
		 */
		protected static var _containers:Dictionary = new Dictionary(true);

		/**
		 * Shows a toast with custom content.
		 *
		 * @see #showMessage()
		 * @see #showMessageWithActions()
		 */
		public static function showContent(content:DisplayObject, timeout:Number = 4, toastFactory:Function = null):Toast
		{
			var factory:Function = toastFactory !== null ? toastFactory : Toast._toastFactory;
			if(factory === null)
			{
				factory = defaultToastFactory;
			}
			var toast:Toast = Toast(factory());
			toast.content = content;
			return showToast(toast, timeout);
		}

		/**
		 * Shows a toast with a simple text message.
		 *
		 * @see #showMessageWithActions()
		 * @see #showContent()
		 */
		public static function showMessage(message:String, timeout:Number = 4, toastFactory:Function = null):Toast
		{
			var factory:Function = toastFactory !== null ? toastFactory : Toast._toastFactory;
			if(factory === null)
			{
				factory = defaultToastFactory;
			}
			var toast:Toast = Toast(factory());
			toast.message = message;
			return showToast(toast, timeout);
		}

		/**
		 * Shows a toast with a text message and some action buttons.
		 *
		 * @see #showMessage()
		 * @see #showContent()
		 */
		public static function showMessageWithActions(message:String, actions:IListCollection, timeout:Number = 4, toastFactory:Function = null):Toast
		{
			var factory:Function = toastFactory !== null ? toastFactory : Toast._toastFactory;
			if(factory === null)
			{
				factory = defaultToastFactory;
			}
			var toast:Toast = Toast(factory());
			toast.message = message;
			toast.actions = actions;
			return showToast(toast, timeout);
		}

		/**
		 * Shows a toast instance.
		 *
		 * @see #showMessage()
		 * @see #showMessageWithActions()
		 * @see #showContent()
		 */
		public static function showToast(toast:Toast, timeout:Number):Toast
		{
			toast.timeout = timeout;
			if(_activeToasts.length >= _maxVisibleToasts)
			{
				_queue[_queue.length] = toast;
				if(_queueMode == ToastQueueMode.CANCEL_TIMEOUT)
				{
					var toastCount:int = _activeToasts.length;
					for(var i:int = 0; i < toastCount; i++)
					{
						var activeToast:Toast = _activeToasts[i];
						if(activeToast.timeout < Number.POSITIVE_INFINITY &&
							!activeToast.isClosing)
						{
							activeToast.close(activeToast.disposeOnSelfClose);
							break;
						}
					}
				}
				return toast;
			}
			_activeToasts[_activeToasts.length] = toast;
			toast.addEventListener(Event.CLOSE, toast_closeHandler);
			var container:DisplayObjectContainer = getContainerForStarling(Starling.current);
			container.addChild(toast);
			if(container is IValidating)
			{
				//validate the parent container before opening the toast because
				//we want to be sure that the toast is positioned properly in
				//the layout for things that may rely on the position, like
				//openEffect
				IValidating(container).validate();
			}
			toast.open();
			return toast;
		}

		/**
		 * @private
		 */
		protected static function showNextInQueue():void
		{
			if(_queue.length == 0)
			{
				return;
			}
			do
			{
				var toast:Toast = _queue.shift();
			}
			//keep skipping toasts that have a timeout
			while(_queueMode == ToastQueueMode.CANCEL_TIMEOUT &&
				_queue.length > 0 &&
				toast.timeout < Number.POSITIVE_INFINITY);
			showToast(toast, toast.timeout);
		}

		/**
		 * @private
		 */
		protected static function toast_closeHandler(event:Event):void
		{
			var toast:Toast = Toast(event.currentTarget);
			toast.removeEventListener(Event.CLOSE, toast_closeHandler);
			var index:int = _activeToasts.indexOf(toast);
			_activeToasts.removeAt(index);
			showNextInQueue();
		}

		/**
		 * @private
		 */
		protected static function getContainerForStarling(starling:Starling):DisplayObjectContainer
		{
			if(starling in Toast._containers)
			{
				var container:DisplayObjectContainer = DisplayObjectContainer(Toast._containers[starling]);
				// always move it to the top, so that new toasts don't appear
				// behind other pop-ups added after the first toast
				container.parent.setChildIndex(container, container.parent.numChildren - 1);
				return container;
			}
			var factory:Function = Toast._containerFactory !== null ? Toast._containerFactory : defaultContainerFactory;
			container = DisplayObjectContainer(factory());
			Toast._containers[starling] = container;
			container.addEventListener(Event.REMOVED_FROM_STAGE, function(event:Event):void
			{
				delete Toast._containers[starling];
			});
			PopUpManager.forStarling(starling).addPopUp(container, false, false);
			return container;
		}

		/**
		 * @private
		 */
		protected static function defaultToastFactory():Toast
		{
			return new Toast();
		}

		/**
		 * @private
		 */
		protected static function defaultContainerFactory():DisplayObjectContainer
		{
			var container:LayoutGroup = new LayoutGroup();
			container.autoSizeMode = AutoSizeMode.STAGE;
			var layout:VerticalLayout = new VerticalLayout();
			layout.verticalAlign = VerticalAlign.BOTTOM;
			if(DeviceCapabilities.isPhone())
			{
				layout.horizontalAlign = HorizontalAlign.JUSTIFY;
			}
			else
			{
				layout.horizontalAlign = HorizontalAlign.LEFT;
			}
			container.layout = layout;
			return container;
		}

		/**
		 * The default factory that creates the action button group. To use a
		 * different factory, you need to set <code>actionsFactory</code>
		 * to a <code>Function</code> instance.
		 */
		public static function defaultActionsFactory():ButtonGroup
		{
			return new ButtonGroup();
		}

		/**
		 * Constructor.
		 */
		public function Toast()
		{
			super();
			if(this._fontStylesSet === null)
			{
				this._fontStylesSet = new FontStylesSet();
				this._fontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
		}

		/**
		 * The value added to the <code>styleNameList</code> of the toast's
		 * message text renderer. This variable is <code>protected</code> so
		 * that sub-classes can customize the message style name in their
		 * constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_MESSAGE</code>.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var messageStyleName:String = DEFAULT_CHILD_STYLE_NAME_MESSAGE;

		/**
		 * The value added to the <code>styleNameList</code> of the toast's
		 * actions button group. This variable is <code>protected</code> so
		 * that sub-classes can customize the actions style name in their
		 * constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_ACTIONS</code>.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var actionsStyleName:String = DEFAULT_CHILD_STYLE_NAME_ACTIONS;

		/**
		 * The message text renderer sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected var messageTextRenderer:ITextRenderer = null;

		/**
		 * The actions button group sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected var actionsGroup:ButtonGroup = null;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return Toast.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _explicitMessageWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitMessageHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitMessageMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitMessageMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitMessageMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitMessageMaxHeight:Number;

		/**
		 * @private
		 */
		protected var _message:String = null;

		/**
		 * The toast's main text content.
		 */
		public function get message():String
		{
			return this._message;
		}

		/**
		 * @private
		 */
		public function set message(value:String):void
		{
			if(this._message == value)
			{
				return;
			}
			this._message = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _actions:IListCollection = null;

		/**
		 * The data provider of the toast's <code>ButtonGroup</code>.
		 */
		public function get actions():IListCollection
		{
			return this._actions;
		}

		/**
		 * @private
		 */
		public function set actions(value:IListCollection):void
		{
			if(this._actions == value)
			{
				return;
			}
			this._actions = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _explicitContentWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitContentHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitContentMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitContentMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitContentMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitContentMaxHeight:Number;

		/**
		 * @private
		 */
		protected var _content:DisplayObject = null;

		/**
		 * Optional custom content to display in the toast.
		 */
		public function get content():DisplayObject
		{
			return this._content;
		}

		/**
		 * @private
		 */
		public function set content(value:DisplayObject):void
		{
			if(this._content == value)
			{
				return;
			}
			if(this._content && this._content.parent == this)
			{
				this._content.removeFromParent(false);
			}
			this._content = value;
			if(this._content)
			{
				if(this._content is IFeathersControl)
				{
					IFeathersControl(this._content).initializeNow();
				}
				if(this._content is IMeasureDisplayObject)
				{
					var measureContent:IMeasureDisplayObject = IMeasureDisplayObject(this._content);
					this._explicitContentWidth = measureContent.explicitWidth;
					this._explicitContentHeight = measureContent.explicitHeight;
					this._explicitContentMinWidth = measureContent.explicitMinWidth;
					this._explicitContentMinHeight = measureContent.explicitMinHeight;
					this._explicitContentMaxWidth = measureContent.explicitMaxWidth;
					this._explicitContentMaxHeight = measureContent.explicitMaxHeight;
				}
				else
				{
					this._explicitContentWidth = this._content.width;
					this._explicitContentHeight = this._content.height;
					this._explicitContentMinWidth = this._explicitContentWidth;
					this._explicitContentMinHeight = this._explicitContentHeight;
					this._explicitContentMaxWidth = this._explicitContentWidth;
					this._explicitContentMaxHeight = this._explicitContentHeight;
				}
				this.addChild(this._content);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
			this.invalidate(INVALIDATION_FLAG_ACTIONS_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _startTime:int = -1;

		/**
		 * @private
		 */
		protected var _timeout:Number = Number.POSITIVE_INFINITY;

		/**
		 * The time, in seconds, when the toast will automatically close. Set
		 * to <code>Number.POSITIVE_INFINITY</code> to require the toast to be
		 * closed manually.
		 *
		 * @default Number.POSITIVE_INFINITY
		 */
		public function get timeout():Number
		{
			return this._timeout;
		}

		/**
		 * @private
		 */
		public function set timeout(value:Number):void
		{
			if(this._timeout == value)
			{
				return;
			}
			this._timeout = value;
			if(this._isOpen)
			{
				this.startTimeout();
			}
		}

		/**
		 * @private
		 */
		protected var _openEffectContext:IEffectContext = null;

		/**
		 * @private
		 */
		protected var _openEffect:Function = Fade.createFadeInEffect();

		/**
		 * An optional effect that is activated when the toast is opened.
		 *
		 * <p>In the following example, a open effect fades the toast's
		 * <code>alpha</code> property from <code>0</code> to <code>1</code>:</p>
		 *
		 * <listing version="3.0">
		 * toast.openEffect = Fade.createFadeBetweenEffect(0, 1);</listing>
		 *
		 * <p>A number of animated effects may be found in the
		 * <a href="../motion/package-detail.html">feathers.motion</a> package.
		 * However, you are not limited to only these effects. It's possible
		 * to create custom effects too.</p>
		 *
		 * <p>A custom effect function should have the following signature:</p>
		 * <pre>function(target:DisplayObject):IEffectContext</pre>
		 *
		 * <p>The <code>IEffectContext</code> is used by the component to
		 * control the effect, performing actions like playing the effect,
		 * pausing it, or cancelling it.</p>
		 *
		 * <p>Custom animated effects that use
		 * <code>starling.display.Tween</code> typically return a
		 * <code>TweenEffectContext</code>. In the following example, we
		 * recreate the <code>Fade.createFadeBetweenEffect()</code> used in the
		 * previous example.</p>
		 *
		 * <listing version="3.0">
		 * toast.closeEffect = function(target:DisplayObject):IEffectContext
		 * {
		 *     toast.alpha = 0;
		 *     var tween:Tween = new Tween(target, 0.5, Transitions.EASE_OUT);
		 *     tween.fadeTo(1);
		 *     return new TweenEffectContext(target, tween);
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.FeathersControl#closeEffect
		 * @see #showToast()
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 * @see feathers.motion.effectClasses.IEffectContext
		 * @see feathers.motion.effectClasses.TweenEffectContext
		 */
		public function get openEffect():Function
		{
			return this._openEffect;
		}

		/**
		 * @private
		 */
		public function set openEffect(value:Function):void
		{
			if(this._openEffect == value)
			{
				return;
			}
			this._openEffect = value;
		}

		/**
		 * @private
		 */
		protected var _closeEffectContext:IEffectContext = null;

		/**
		 * @private
		 */
		protected var _closeEffect:Function = Fade.createFadeOutEffect();

		/**
		 * An optional effect that is activated when the toast is closed.
		 *
		 * <p>In the following example, a close effect fades the toast's
		 * <code>alpha</code> property from <code>1</code> to <code>0</code>:</p>
		 *
		 * <listing version="3.0">
		 * toast.closeEffect = Fade.createFadeBetweenEffect(1, 0);</listing>
		 *
		 * <p>A number of animated effects may be found in the
		 * <a href="../motion/package-detail.html">feathers.motion</a> package.
		 * However, you are not limited to only these effects. It's possible
		 * to create custom effects too.</p>
		 *
		 * <p>A custom effect function should have the following signature:</p>
		 * <pre>function(target:DisplayObject):IEffectContext</pre>
		 *
		 * <p>The <code>IEffectContext</code> is used by the component to
		 * control the effect, performing actions like playing the effect,
		 * pausing it, or cancelling it.</p>
		 *
		 * <p>Custom animated effects that use
		 * <code>starling.display.Tween</code> typically return a
		 * <code>TweenEffectContext</code>. In the following example, we
		 * recreate the <code>Fade.createFadeBetweenEffect()</code> used in the
		 * previous example.</p>
		 *
		 * <listing version="3.0">
		 * toast.closeEffect = function(target:DisplayObject):IEffectContext
		 * {
		 *     toast.alpha = 1;
		 *     var tween:Tween = new Tween(target, 0.5, Transitions.EASE_OUT);
		 *     tween.fadeTo(0);
		 *     return new TweenEffectContext(target, tween);
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.FeathersControl#openEffect
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 * @see feathers.motion.effectClasses.IEffectContext
		 * @see feathers.motion.effectClasses.TweenEffectContext
		 */
		public function get closeEffect():Function
		{
			return this._closeEffect;
		}

		/**
		 * @private
		 */
		public function set closeEffect(value:Function):void
		{
			if(this._closeEffect == value)
			{
				return;
			}
			this._closeEffect = value;
		}

		/**
		 * @private
		 */
		protected var _fontStylesSet:FontStylesSet = null;

		/**
		 * @private
		 */
		public function get fontStyles():TextFormat
		{
			return this._fontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set fontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get disabledFontStyles():TextFormat
		{
			return this._fontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set disabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _messageFactory:Function = null;

		/**
		 * A function used to instantiate the toast's message text renderer
		 * sub-component. By default, the toast will use the global text
		 * renderer factory, <code>FeathersControl.defaultTextRendererFactory()</code>,
		 * to create the message text renderer. The message text renderer must
		 * be an instance of <code>ITextRenderer</code>. This factory can be
		 * used to change properties on the message text renderer when it is
		 * first created. For instance, if you are skinning Feathers components
		 * without a theme, you might use this factory to style the message text
		 * renderer.
		 *
		 * <p>If you are not using a theme, the message factory can be used to
		 * provide skin the message text renderer with appropriate text styles.</p>
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():ITextRenderer</pre>
		 *
		 * <p>In the following example, a custom message factory is passed to
		 * the toast:</p>
		 *
		 * <listing version="3.0">
		 * toast.messageFactory = function():ITextRenderer
		 * {
		 *     var messageRenderer:TextFieldTextRenderer = new TextFieldTextRenderer();
		 *     messageRenderer.textFormat = new TextFormat( "_sans", 12, 0xff0000 );
		 *     return messageRenderer;
		 * }</listing>
		 *
		 * @default null
		 *
		 * @see #message
		 * @see feathers.core.ITextRenderer
		 * @see feathers.core.FeathersControl#defaultTextRendererFactory
		 */
		public function get messageFactory():Function
		{
			return this._messageFactory;
		}

		/**
		 * @private
		 */
		public function set messageFactory(value:Function):void
		{
			if(this._messageFactory == value)
			{
				return;
			}
			this._messageFactory = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _customMessageStyleName:String;

		/**
		 * @private
		 */
		public function get customMessageStyleName():String
		{
			return this._customMessageStyleName;
		}

		/**
		 * @private
		 */
		public function set customMessageStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customMessageStyleName === value)
			{
				return;
			}
			this._customMessageStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _actionsFactory:Function = null;

		/**
		 * A function used to generate the toast's button group sub-component.
		 * The button group must be an instance of <code>ButtonGroup</code>.
		 * This factory can be used to change properties on the button group
		 * when it is first created. For instance, if you are skinning Feathers
		 * components without a theme, you might use this factory to set skins
		 * and other styles on the button group.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():ButtonGroup</pre>
		 *
		 * <p>In the following example, a custom button group factory is
		 * provided to the toast:</p>
		 *
		 * <listing version="3.0">
		 * toast.actionsFactory = function():ButtonGroup
		 * {
		 *     return new ButtonGroup();
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.ButtonGroup
		 */
		public function get actionsFactory():Function
		{
			return this._actionsFactory;
		}

		/**
		 * @private
		 */
		public function set actionsFactory(value:Function):void
		{
			if(this._actionsFactory == value)
			{
				return;
			}
			this._actionsFactory = value;
			this.invalidate(INVALIDATION_FLAG_ACTIONS_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customActionsStyleName:String = null;

		/**
		 * @private
		 */
		public function get customActionsStyleName():String
		{
			return this._customActionsStyleName;
		}

		/**
		 * @private
		 */
		public function set customActionsStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customActionsStyleName === value)
			{
				return;
			}
			this._customActionsStyleName = value;
			this.invalidate(INVALIDATION_FLAG_ACTIONS_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _disposeFromCloseCall:Boolean = false;

		/**
		 * @private
		 */
		protected var _disposeOnSelfClose:Boolean = true;

		/**
		 * Determines if the toast will be disposed when <code>close()</code>
		 * is called internally. Close may be called internally in a variety of
		 * cases, depending on values such as <code>timeout</code> and
		 * <code>actions</code>. If set to <code>false</code>, you may reuse the
		 * toast later by passing it to <code>Toast.showToast()</code>.
		 *
		 * <p>In the following example, the toast will not be disposed when it
		 * closes itself:</p>
		 *
		 * <listing version="3.0">
		 * toast.disposeOnSelfClose = false;</listing>
		 *
		 * @default true
		 *
		 * @see #close()
		 * @see #disposeContent
		 */
		public function get disposeOnSelfClose():Boolean
		{
			return this._disposeOnSelfClose;
		}

		/**
		 * @private
		 */
		public function set disposeOnSelfClose(value:Boolean):void
		{
			this._disposeOnSelfClose = value;
		}

		/**
		 * @private
		 */
		public var _disposeContent:Boolean = true;

		/**
		 * Determines if the toast's content will be disposed when the toast
		 * is disposed. If set to <code>false</code>, the toast's content may
		 * be added to the display list again later.
		 *
		 * <p>In the following example, the toast's content will not be
		 * disposed when the toast is disposed:</p>
		 *
		 * <listing version="3.0">
		 * toast.disposeContent = false;</listing>
		 *
		 * @default true
		 *
		 * @see #disposeOnSelfClose
		 */
		public function get disposeContent():Boolean
		{
			return this._disposeContent;
		}

		/**
		 * @private
		 */
		public function set disposeContent(value:Boolean):void
		{
			this._disposeContent = value;
		}

		/**
		 * @private
		 */
		protected var _closeData:Object = null;

		/**
		 * @private
		 */
		protected var _isClosing:Boolean = false;

		/**
		 * Indicates if the toast is currently closing.
		 *
		 * @see #isOpening
		 * @see #isOpen
		 */
		public function get isClosing():Boolean
		{
			return this._isClosing;
		}

		/**
		 * @private
		 */
		protected var _isOpening:Boolean = false;

		/**
		 * Indicates if the toast is currently opening.
		 *
		 * @see #isClosing
		 */
		public function get isOpening():Boolean
		{
			return this._isOpening;
		}

		/**
		 * @private
		 */
		protected var _isOpen:Boolean = false;

		/**
		 * Indicates if the toast is currently open. Does not change from
		 * <code>false</code> to <code>true</code> until the open effect has
		 * completed. Similarly, does not change from <code>true</code> to
		 * <code>false</code> until the close effect has completed.
		 *
		 * @see #isOpening
		 * @see #isClosing
		 * @see #event:open starling.events.Event.OPEN
		 * @see #event:close starling.events.Event.CLOSE
		 */
		public function get isOpen():Boolean
		{
			return this._isOpen;
		}

		/**
		 * @private
		 */
		protected var _explicitBackgroundSkinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundSkinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundSkinMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundSkinMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundSkinMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundSkinMaxHeight:Number;

		/**
		 * @private
		 */
		protected var _backgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundSkin():DisplayObject
		{
			return this._backgroundSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundSkin === value)
			{
				return;
			}
			if(this._backgroundSkin !== null && this._backgroundSkin.parent === this)
			{
				//we need to restore these values so that they won't be lost the
				//next time that this skin is used for measurement
				this._backgroundSkin.width = this._explicitBackgroundSkinWidth;
				this._backgroundSkin.height = this._explicitBackgroundSkinHeight;
				if(this._backgroundSkin is IMeasureDisplayObject)
				{
					var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this._backgroundSkin);
					measureSkin.minWidth = this._explicitBackgroundSkinMinWidth;
					measureSkin.minHeight = this._explicitBackgroundSkinMinHeight;
					measureSkin.maxWidth = this._explicitBackgroundSkinMaxWidth;
					measureSkin.maxHeight = this._explicitBackgroundSkinMaxHeight;
				}
				this._backgroundSkin.removeFromParent(false);
			}
			this._backgroundSkin = value;
			if(this._backgroundSkin !== null)
			{
				if(this._backgroundSkin is IFeathersControl)
				{
					IFeathersControl(this._backgroundSkin).initializeNow();
				}
				if(this._backgroundSkin is IMeasureDisplayObject)
				{
					measureSkin = IMeasureDisplayObject(this._backgroundSkin);
					this._explicitBackgroundSkinWidth = measureSkin.explicitWidth;
					this._explicitBackgroundSkinHeight = measureSkin.explicitHeight;
					this._explicitBackgroundSkinMinWidth = measureSkin.explicitMinWidth;
					this._explicitBackgroundSkinMinHeight = measureSkin.explicitMinHeight;
					this._explicitBackgroundSkinMaxWidth = measureSkin.explicitMaxWidth;
					this._explicitBackgroundSkinMaxHeight = measureSkin.explicitMaxHeight;
				}
				else
				{
					this._explicitBackgroundSkinWidth = this._backgroundSkin.width;
					this._explicitBackgroundSkinHeight = this._backgroundSkin.height;
					this._explicitBackgroundSkinMinWidth = this._explicitBackgroundSkinWidth;
					this._explicitBackgroundSkinMinHeight = this._explicitBackgroundSkinHeight;
					this._explicitBackgroundSkinMaxWidth = this._explicitBackgroundSkinWidth;
					this._explicitBackgroundSkinMaxHeight = this._explicitBackgroundSkinHeight;
				}
				this.addChildAt(this._backgroundSkin, 0);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.CENTER;

		[Inspectable(type="String",enumeration="left,center,right")]
		/**
		 * @private
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._horizontalAlign === value)
			{
				return;
			}
			this._horizontalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.MIDDLE;

		[Inspectable(type="String",enumeration="top,middle,bottom")]
		/**
		 * @private
		 */
		public function get verticalAlign():String
		{
			return this._verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._verticalAlign === value)
			{
				return;
			}
			this._verticalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _gap:Number = 0;

		/**
		 * @private
		 */
		public function get gap():Number
		{
			return this._gap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._gap == value)
			{
				return;
			}
			this._gap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _minGap:Number = 0;

		/**
		 * @private
		 */
		public function get minGap():Number
		{
			return this._minGap;
		}

		/**
		 * @private
		 */
		public function set minGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._minGap == value)
			{
				return;
			}
			this._minGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _actionsPosition:String = RelativePosition.RIGHT;

		[Inspectable(type="String",enumeration="top,right,bottom,left")]
		/**
		 * @private
		 */
		public function get actionsPosition():String
		{
			return this._actionsPosition;
		}

		/**
		 * @private
		 */
		public function set actionsPosition(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._actionsPosition === value)
			{
				return;
			}
			this._actionsPosition = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this._fontStylesSet !== null)
			{
				this._fontStylesSet.dispose();
				this._fontStylesSet = null;
			}
			var savedContent:DisplayObject = this._content;
			this.content = null;
			//remove the content safely if it should not be disposed
			if(savedContent !== null && this._disposeContent)
			{
				savedContent.dispose();
			}
			super.dispose();
		}

		/**
		 * @private
		 *
		 * @see #showToast()
		 */
		protected function open():void
		{
			if(this._isOpen || this._isOpening)
			{
				return;
			}
			if(this._suspendEffectsCount == 0 && this._closeEffectContext !== null)
			{
				this._closeEffectContext.interrupt();
				this._closeEffectContext = null;
			}
			if(this._openEffect !== null)
			{
				this._isOpening = true;
				this._openEffectContext = IEffectContext(this._openEffect(this));
				this._openEffectContext.addEventListener(Event.COMPLETE, openEffectContext_completeHandler);
				this._openEffectContext.play();
			}
			else
			{
				this.completeOpen();
			}
		}

		/**
		 * Closes the toast and optionally disposes it. If a
		 * <code>closeEffect</code> has been specified, it will be played.
		 *
		 * @see #closeEffect
		 */
		public function close(dispose:Boolean = true):void
		{
			this.closeToast(null, dispose);
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var textRendererInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_TEXT_RENDERER);
			var actionsInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_ACTIONS_FACTORY);

			if(textRendererInvalid)
			{
				this.createMessage();
			}

			if(actionsInvalid)
			{
				this.createActions();
			}

			if(textRendererInvalid || dataInvalid)
			{
				if(this.messageTextRenderer)
				{
					this.messageTextRenderer.text = this._message;
				}
			}

			if(textRendererInvalid || stylesInvalid)
			{
				this.refreshMessageStyles();
			}

			if(actionsInvalid || dataInvalid)
			{
				if(this.actionsGroup)
				{
					this.actionsGroup.dataProvider = this._actions;
				}
			}

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			this.layoutChildren();
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			var adjustedGap:Number = this._gap;
			if(adjustedGap == Number.POSITIVE_INFINITY)
			{
				adjustedGap = this._minGap;
			}

			resetFluidChildDimensionsForMeasurement(this._backgroundSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitBackgroundSkinWidth, this._explicitBackgroundSkinHeight,
				this._explicitBackgroundSkinMinWidth, this._explicitBackgroundSkinMinHeight,
				this._explicitBackgroundSkinMaxWidth, this._explicitBackgroundSkinMaxHeight);
			var measureSkin:IMeasureDisplayObject = this._backgroundSkin as IMeasureDisplayObject;

			resetFluidChildDimensionsForMeasurement(this._content,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitContentWidth, this._explicitContentHeight,
				this._explicitContentMinWidth, this._explicitContentMinHeight,
				this._explicitContentMaxWidth, this._explicitContentMaxHeight);
			var measureContent:IMeasureDisplayObject = this._content as IMeasureDisplayObject;

			if(this._content is IValidating)
			{
				IValidating(this._content).validate();
			}
			var messageSize:Point = Pool.getPoint();
			if(this.messageTextRenderer !== null)
			{
				this.refreshMessageTextRendererDimensions(true);
				this.messageTextRenderer.measureText(messageSize);
			}
			if(this.actionsGroup)
			{
				this.actionsGroup.validate();
			}
			if(this._backgroundSkin is IValidating)
			{
				IValidating(this._backgroundSkin).validate();
			}

			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				if(this._content !== null)
				{
					if(measureContent !== null)
					{
						newMinWidth = measureContent.minWidth;
					}
					else
					{
						newMinWidth = this._content.width;
					}
				}
				else if(this.messageTextRenderer !== null)
				{
					newMinWidth = messageSize.x;
				}
				else
				{
					newMinWidth = 0;
				}
				if(this.actionsGroup !== null)
				{
					if(this.messageTextRenderer !== null) //both message and actions
					{
						if(this._actionsPosition !== RelativePosition.TOP &&
							this._actionsPosition !== RelativePosition.BOTTOM)
						{
							newMinWidth += adjustedGap;
							newMinWidth += this.actionsGroup.minWidth;
						}
						else //top or bottom
						{
							var iconMinWidth:Number = this.actionsGroup.minWidth;
							if(iconMinWidth > newMinWidth)
							{
								newMinWidth = iconMinWidth;
							}
						}
					}
					else //no message
					{
						newMinWidth = this.actionsGroup.minWidth;
					}
				}
				newMinWidth += this._paddingLeft + this._paddingRight;
				if(this._backgroundSkin !== null)
				{
					if(measureSkin !== null)
					{
						if(measureSkin.minWidth > newMinWidth)
						{
							newMinWidth = measureSkin.minWidth;
						}
					}
					else if(this._explicitBackgroundSkinMinWidth > newMinWidth)
					{
						newMinWidth = this._explicitBackgroundSkinMinWidth;
					}
				}
			}

			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				if(this._content !== null)
				{
					if(measureContent !== null)
					{
						newMinHeight = measureContent.minHeight;
					}
					else
					{
						newMinHeight = this._content.height;
					}
				}
				else if(this.messageTextRenderer !== null)
				{
					newMinHeight = messageSize.y;
				}
				else
				{
					newMinHeight = 0;
				}
				if(this.actionsGroup !== null)
				{
					if(this.messageTextRenderer !== null) //both message and actions
					{
						if(this._actionsPosition === RelativePosition.TOP ||
							this._actionsPosition === RelativePosition.BOTTOM)
						{
							newMinHeight += adjustedGap;
							newMinHeight += this.actionsGroup.minHeight;
						}
						else //left or right
						{
							var iconMinHeight:Number = this.actionsGroup.minHeight;
							if(iconMinHeight > newMinHeight)
							{
								newMinHeight = iconMinHeight;
							}
						}
					}
					else //no message
					{
						newMinHeight = this.actionsGroup.minHeight;
					}
				}
				newMinHeight += this._paddingTop + this._paddingBottom;
				if(this._backgroundSkin !== null)
				{
					if(measureSkin !== null)
					{
						if(measureSkin.minHeight > newMinHeight)
						{
							newMinHeight = measureSkin.minHeight;
						}
					}
					else if(this._explicitBackgroundSkinMinHeight > newMinHeight)
					{
						newMinHeight = this._explicitBackgroundSkinMinHeight;
					}
				}
			}

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				if(this._content !== null)
				{
					newWidth = this._content.width;
				}
				else if(this.messageTextRenderer !== null)
				{
					newWidth = messageSize.x;
				}
				else
				{
					newWidth = 0;
				}
				if(this.actionsGroup !== null)
				{
					if(this.messageTextRenderer !== null) //both message and actions
					{
						if(this._actionsPosition !== RelativePosition.TOP &&
							this._actionsPosition !== RelativePosition.BOTTOM)
						{
							newWidth += adjustedGap + this.actionsGroup.width;
						}
						else if(this.actionsGroup.width > newWidth) //top or bottom
						{
							newWidth = this.actionsGroup.width;
						}
					}
					else //no message
					{
						newWidth = this.actionsGroup.width;
					}
				}
				newWidth += this._paddingLeft + this._paddingRight;
				if(this._backgroundSkin !== null &&
					this._backgroundSkin.width > newWidth)
				{
					newWidth = this._backgroundSkin.width;
				}
			}

			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				if(this._content !== null)
				{
					newHeight = this._content.height;
				}
				else if(this.messageTextRenderer !== null)
				{
					newHeight = messageSize.y;
				}
				else
				{
					newHeight = 0;
				}
				if(this.actionsGroup !== null)
				{
					if(this.messageTextRenderer !== null) //both message and actions
					{
						if(this._actionsPosition === RelativePosition.TOP ||
							this._actionsPosition === RelativePosition.BOTTOM)
						{
							newHeight += adjustedGap + this.actionsGroup.height;
						}
						else if(this.actionsGroup.height > newHeight) //left or right
						{
							newHeight = this.actionsGroup.height;
						}
					}
					else //no message
					{
						newHeight = this.actionsGroup.height;
					}
				}
				newHeight += this._paddingTop + this._paddingBottom;
				if(this._backgroundSkin !== null &&
					this._backgroundSkin.height > newHeight)
				{
					newHeight = this._backgroundSkin.height;
				}
			}

			Pool.putPoint(messageSize);

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * @private
		 */
		protected function refreshMessageTextRendererDimensions(forMeasurement:Boolean):void
		{
			if(this.actionsGroup !== null)
			{
				this.actionsGroup.validate();
			}
			if(!this.messageTextRenderer)
			{
				return;
			}
			var calculatedWidth:Number = this.actualWidth;
			var calculatedHeight:Number = this.actualHeight;
			if(forMeasurement)
			{
				calculatedWidth = this._explicitWidth;
				if(calculatedWidth !== calculatedWidth) //isNaN
				{
					calculatedWidth = this._explicitMaxWidth;
				}
				calculatedHeight = this._explicitHeight;
				if(calculatedHeight !== calculatedHeight) //isNaN
				{
					calculatedHeight = this._explicitMaxHeight;
				}
			}
			calculatedWidth -= (this._paddingLeft + this._paddingRight);
			calculatedHeight -= (this._paddingTop + this._paddingBottom);
			if(this.actionsGroup !== null)
			{
				var adjustedGap:Number = this._gap;
				if(adjustedGap == Number.POSITIVE_INFINITY)
				{
					adjustedGap = this._minGap;
				}
				if(this._actionsPosition === RelativePosition.LEFT ||
					this._actionsPosition === RelativePosition.RIGHT)
				{
					calculatedWidth -= (this.actionsGroup.width + adjustedGap);
				}
				if(this._actionsPosition === RelativePosition.TOP || this._actionsPosition === RelativePosition.BOTTOM)
				{
					calculatedHeight -= (this.actionsGroup.height + adjustedGap);
				}
			}
			if(calculatedWidth < 0)
			{
				calculatedWidth = 0;
			}
			if(calculatedHeight < 0)
			{
				calculatedHeight = 0;
			}
			if(calculatedWidth > this._explicitMessageMaxWidth)
			{
				calculatedWidth = this._explicitMessageMaxWidth;
			}
			if(calculatedHeight > this._explicitMessageMaxHeight)
			{
				calculatedHeight = this._explicitMessageMaxHeight;
			}
			this.messageTextRenderer.width = this._explicitMessageWidth;
			this.messageTextRenderer.height = this._explicitMessageHeight;
			this.messageTextRenderer.minWidth = this._explicitMessageMinWidth;
			this.messageTextRenderer.minHeight = this._explicitMessageMinHeight;
			this.messageTextRenderer.maxWidth = calculatedWidth;
			this.messageTextRenderer.maxHeight = calculatedHeight;
			this.messageTextRenderer.validate();
			if(!forMeasurement)
			{
				calculatedWidth = this.messageTextRenderer.width;
				calculatedHeight = this.messageTextRenderer.height;
				//setting all of these dimensions explicitly means that the text
				//renderer won't measure itself again when it validates, which
				//helps performance. we'll reset them when the toast needs to
				//measure itself.
				this.messageTextRenderer.width = calculatedWidth;
				this.messageTextRenderer.height = calculatedHeight;
				this.messageTextRenderer.minWidth = calculatedWidth;
				this.messageTextRenderer.minHeight = calculatedHeight;
			}
		}

		/**
		 * Creates and adds the <code>messageTextRenderer</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #message
		 * @see #messageTextRenderer
		 * @see #messageFactory
		 */
		protected function createMessage():void
		{
			if(this.messageTextRenderer)
			{
				this.removeChild(DisplayObject(this.messageTextRenderer), true);
				this.messageTextRenderer = null;
			}

			if(this._message === null)
			{
				return;
			}

			var factory:Function = this._messageFactory != null ? this._messageFactory : FeathersControl.defaultTextRendererFactory;
			this.messageTextRenderer = ITextRenderer(factory());
			this.messageTextRenderer.wordWrap = true;
			var messageStyleName:String = this._customMessageStyleName != null ? this._customMessageStyleName : this.messageStyleName;
			var uiTextRenderer:IFeathersControl = IFeathersControl(this.messageTextRenderer);
			uiTextRenderer.styleNameList.add(messageStyleName);
			uiTextRenderer.touchable = false;
			this.addChild(DisplayObject(this.messageTextRenderer));
			this._explicitMessageWidth = this.messageTextRenderer.explicitWidth;
			this._explicitMessageHeight = this.messageTextRenderer.explicitHeight;
			this._explicitMessageMinWidth = this.messageTextRenderer.explicitMinWidth;
			this._explicitMessageMinHeight = this.messageTextRenderer.explicitMinHeight;
			this._explicitMessageMaxWidth = this.messageTextRenderer.explicitMaxWidth;
			this._explicitMessageMaxHeight = this.messageTextRenderer.explicitMaxHeight;
		}

		/**
		 * @private
		 */
		protected function refreshMessageStyles():void
		{
			if(!this.messageTextRenderer)
			{
				return;
			}
			this.messageTextRenderer.fontStyles = this._fontStylesSet;
		}

		/**
		 * Creates and adds the <code>actionsGroup</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #actionsGroup
		 * @see #actionsFactory
		 * @see #style:customActionsStyleName
		 */
		protected function createActions():void
		{
			if(this.actionsGroup)
			{
				this.actionsGroup.removeEventListener(Event.TRIGGERED, actionsGroup_triggeredHandler);
				this.removeChild(this.actionsGroup, true);
				this.actionsGroup = null;
			}

			if(this._actions === null)
			{
				return;
			}
			var factory:Function = this._actionsFactory !== null ? this._actionsFactory : defaultActionsFactory;
			if(factory === null)
			{
				return;
			}
			var actionsStyleName:String = this._customActionsStyleName != null ? this._customActionsStyleName : this.actionsStyleName;
			this.actionsGroup = ButtonGroup(factory());
			this.actionsGroup.styleNameList.add(actionsStyleName);
			this.actionsGroup.addEventListener(Event.TRIGGERED, actionsGroup_triggeredHandler);
			this.addChild(this.actionsGroup);
		}

		/**
		 * Positions and sizes the toast's content.
		 *
		 * <p>For internal use in subclasses.</p>
		 */
		protected function layoutChildren():void
		{
			if(this._backgroundSkin)
			{
				this._backgroundSkin.width = this.actualWidth;
				this._backgroundSkin.height = this.actualHeight;
			}
			if(this._content)
			{
				this._content.x = this._paddingLeft;
				this._content.y = this._paddingTop;
				this._content.width = this.actualWidth - this._paddingLeft - this._paddingRight;
				this._content.height = this.actualHeight - this._paddingTop - this._paddingBottom;
			}

			this.refreshMessageTextRendererDimensions(false);
			if(this.actionsGroup)
			{
				this.positionSingleChild(DisplayObject(this.messageTextRenderer));
				this.positionActionsRelativeToMessage();
			}
			else if(this.messageTextRenderer)
			{
				this.positionSingleChild(DisplayObject(this.messageTextRenderer));
			}
		}

		/**
		 * @private
		 */
		protected function positionSingleChild(displayObject:DisplayObject):void
		{
			if(this._horizontalAlign == HorizontalAlign.LEFT)
			{
				displayObject.x = this._paddingLeft;
			}
			else if(this._horizontalAlign == HorizontalAlign.RIGHT)
			{
				displayObject.x = this.actualWidth - this._paddingRight - displayObject.width;
			}
			else //center
			{
				displayObject.x = this._paddingLeft + Math.round((this.actualWidth - this._paddingLeft - this._paddingRight - displayObject.width) / 2);
			}
			if(this._verticalAlign == VerticalAlign.TOP)
			{
				displayObject.y = this._paddingTop;
			}
			else if(this._verticalAlign == VerticalAlign.BOTTOM)
			{
				displayObject.y = this.actualHeight - this._paddingBottom - displayObject.height;
			}
			else //middle
			{
				displayObject.y = this._paddingTop + Math.round((this.actualHeight - this._paddingTop - this._paddingBottom - displayObject.height) / 2);
			}
		}

		/**
		 * @private
		 */
		protected function positionActionsRelativeToMessage():void
		{
			if(this._actionsPosition == RelativePosition.TOP)
			{
				if(this._gap == Number.POSITIVE_INFINITY)
				{
					this.actionsGroup.y = this._paddingTop;
					this.messageTextRenderer.y = this.actualHeight - this._paddingBottom - this.messageTextRenderer.height;
				}
				else
				{
					if(this._verticalAlign == VerticalAlign.TOP)
					{
						this.messageTextRenderer.y += this.actionsGroup.height + this._gap;
					}
					else if(this._verticalAlign == VerticalAlign.MIDDLE)
					{
						this.messageTextRenderer.y += Math.round((this.actionsGroup.height + this._gap) / 2);
					}
					this.actionsGroup.y = this.messageTextRenderer.y - this.actionsGroup.height - this._gap;
				}
			}
			else if(this._actionsPosition == RelativePosition.RIGHT)
			{
				if(this._gap == Number.POSITIVE_INFINITY)
				{
					this.messageTextRenderer.x = this._paddingLeft;
					this.actionsGroup.x = this.actualWidth - this._paddingRight - this.actionsGroup.width;
				}
				else
				{
					if(this._horizontalAlign == HorizontalAlign.RIGHT)
					{
						this.messageTextRenderer.x -= this.actionsGroup.width + this._gap;
					}
					else if(this._horizontalAlign == HorizontalAlign.CENTER)
					{
						this.messageTextRenderer.x -= Math.round((this.actionsGroup.width + this._gap) / 2);
					}
					this.actionsGroup.x = this.messageTextRenderer.x + this.messageTextRenderer.width + this._gap;
				}
			}
			else if(this._actionsPosition == RelativePosition.BOTTOM)
			{
				if(this._gap == Number.POSITIVE_INFINITY)
				{
					this.messageTextRenderer.y = this._paddingTop;
					this.actionsGroup.y = this.actualHeight - this._paddingBottom - this.actionsGroup.height;
				}
				else
				{
					if(this._verticalAlign == VerticalAlign.BOTTOM)
					{
						this.messageTextRenderer.y -= this.actionsGroup.height + this._gap;
					}
					else if(this._verticalAlign == VerticalAlign.MIDDLE)
					{
						this.messageTextRenderer.y -= Math.round((this.actionsGroup.height + this._gap) / 2);
					}
					this.actionsGroup.y = this.messageTextRenderer.y + this.messageTextRenderer.height + this._gap;
				}
			}
			else if(this._actionsPosition == RelativePosition.LEFT)
			{
				if(this._gap == Number.POSITIVE_INFINITY)
				{
					this.actionsGroup.x = this._paddingLeft;
					this.messageTextRenderer.x = this.actualWidth - this._paddingRight - this.messageTextRenderer.width;
				}
				else
				{
					if(this._horizontalAlign == HorizontalAlign.LEFT)
					{
						this.messageTextRenderer.x += this._gap + this.actionsGroup.width;
					}
					else if(this._horizontalAlign == HorizontalAlign.CENTER)
					{
						this.messageTextRenderer.x += Math.round((this._gap + this.actionsGroup.width) / 2);
					}
					this.actionsGroup.x = this.messageTextRenderer.x - this._gap - this.actionsGroup.width;
				}
			}

			if(this._actionsPosition == RelativePosition.LEFT || this._actionsPosition == RelativePosition.RIGHT)
			{
				if(this._verticalAlign == VerticalAlign.TOP)
				{
					this.actionsGroup.y = this._paddingTop;
				}
				else if(this._verticalAlign == VerticalAlign.BOTTOM)
				{
					this.actionsGroup.y = this.actualHeight - this._paddingBottom - this.actionsGroup.height;
				}
				else
				{
					this.actionsGroup.y = this._paddingTop + Math.round((this.actualHeight - this._paddingTop - this._paddingBottom - this.actionsGroup.height) / 2);
				}
			}
			else //top or bottom
			{
				if(this._horizontalAlign == HorizontalAlign.LEFT)
				{
					this.actionsGroup.x = this._paddingLeft;
				}
				else if(this._horizontalAlign == HorizontalAlign.RIGHT)
				{
					this.actionsGroup.x = this.actualWidth - this._paddingRight - this.actionsGroup.width;
				}
				else
				{
					this.actionsGroup.x = this._paddingLeft + Math.round((this.actualWidth - this._paddingLeft - this._paddingRight - this.actionsGroup.width) / 2);
				}
			}
		}

		/**
		 * @private
		 */
		protected function startTimeout():void
		{
			if(this._timeout == Number.POSITIVE_INFINITY)
			{
				this.removeEventListener(Event.ENTER_FRAME, this.toast_timeout_enterFrameHandler);
				return;
			}
			this._startTime = getTimer();
			this.addEventListener(Event.ENTER_FRAME, this.toast_timeout_enterFrameHandler);
		}

		/**
		 * @private
		 */
		protected function completeClose():void
		{
			var closeData:Object = this._closeData;
			var dispose:Boolean = this._disposeFromCloseCall;
			this._closeEffectContext = null;
			this._closeData = null;
			this._disposeFromCloseCall = false;
			this._isClosing = false;
			this._isOpen = false;
			//remove from parent before dispatching close so that the parent
			//layout is updated before any new toasts are added, but don't
			//dispose the toast yet!
			this.removeFromParent(false);
			this.dispatchEventWith(Event.CLOSE, false, closeData);
			if(dispose)
			{
				//dispose after the close event has been dispatched so that the
				//listeners aren't removed
				this.dispose();
			}
		}

		/**
		 * @private
		 */
		protected function completeOpen():void
		{
			this._openEffectContext = null;
			this._isOpening = false;
			this._isOpen = true;
			this.dispatchEventWith(Event.OPEN);
			this.startTimeout();
		}

		/**
		 * @private
		 */
		protected function toast_timeout_enterFrameHandler(event:Event):void
		{
			var totalTime:int = (getTimer() - this._startTime) / 1000;
			if(totalTime > this._timeout)
			{
				this.close(this._disposeOnSelfClose);
			}
		}

		/**
		 * @private
		 */
		protected function fontStyles_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function closeToast(data:Object, dispose:Boolean):void
		{
			if(!this.parent || this._isClosing)
			{
				return;
			}
			if(this._suspendEffectsCount == 0 && this._openEffectContext !== null)
			{
				this._openEffectContext.interrupt();
				this._openEffectContext = null;
			}
			this._isClosing = true;
			this._closeData = data;
			this._disposeFromCloseCall = dispose;
			this.removeEventListener(Event.ENTER_FRAME, this.toast_timeout_enterFrameHandler);
			if(this._closeEffect !== null)
			{
				this._closeEffectContext = IEffectContext(this._closeEffect(this));
				this._closeEffectContext.addEventListener(Event.COMPLETE, closeEffectContext_completeHandler);
				this._closeEffectContext.play();
			}
			else
			{
				this.completeClose();
			}
		}

		/**
		 * @private
		 */
		protected function actionsGroup_triggeredHandler(event:Event, data:Object):void
		{
			this.closeToast(data, this._disposeOnSelfClose);
		}

		/**
		 * @private
		 */
		protected function closeEffectContext_completeHandler(event:Event):void
		{
			this.completeClose();
		}

		/**
		 * @private
		 */
		protected function openEffectContext_completeHandler(event:Event):void
		{
			this.completeOpen();
		}
	}
}

================================================
FILE: source/feathers/controls/ToastQueueMode.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * Constants to control how the toast queue will behave when the maximum
	 * number of allowed toasts are visible.
	 *
	 * @productversion Feathers 4.0.0
	 *
	 * @see feathers.controls.Toast
	 */
	public class ToastQueueMode
	{
		/**
		 * If a new toast is queued up, and any of the active toasts have a
		 * timeout, the timeout is cancelled immediately, and the new toast is
		 * displayed after the active toast has finished closing.
		 *
		 * @productversion Feathers 4.0.0
		 */
		public static const CANCEL_TIMEOUT:String = "cancelTimeout";

		/**
		 * If a new toast is queued up, waits indefinitely until the next active
		 * toast closes.
		 *
		 * @productversion Feathers 4.0.0
		 */
		public static const WAIT_FOR_TIMEOUT:String = "waitForTimeout";
	}
}

================================================
FILE: source/feathers/controls/ToggleButton.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.IGroupedToggle;
	import feathers.core.ToggleGroup;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;
	import feathers.utils.keyboard.KeyToSelect;
	import feathers.utils.touch.TapToSelect;

	import flash.ui.Keyboard;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.text.TextFormat;

	[Exclude(name="defaultSelectedLabelProperties",kind="property")]
	[Exclude(name="selectedUpLabelProperties",kind="property")]
	[Exclude(name="selectedDownLabelProperties",kind="property")]
	[Exclude(name="selectedHoverLabelProperties",kind="property")]
	[Exclude(name="selectedDisabledLabelProperties",kind="property")]

	/**
	 * The icon used when no other icon is defined for the current state
	 * when the button is selected. Has a higher priority than
	 * <code>defaultIcon</code>, but a lower priority than other selected
	 * icons.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToIconFunction</code> property.</p>
	 *
	 * <p>The following example gives the button a default icon to use for
	 * all selected states when no specific icon is available:</p>
	 *
	 * <listing version="3.0">
	 * button.defaultSelectedIcon = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultIcon
	 * @see #setIconForState()
	 */
	[Style(name="defaultSelectedIcon",type="starling.display.DisplayObject")]

	/**
	 * The skin used when no other skin is defined for the current state
	 * when the button is selected. Has a higher priority than
	 * <code>defaultSkin</code>, but a lower priority than other selected
	 * skins.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToSkinFunction</code> property.</p>
	 *
	 * <p>The following example gives the button a default skin to use for
	 * all selected states when no specific skin is available:</p>
	 *
	 * <listing version="3.0">
	 * button.defaultSelectedSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultSkin
	 * @see #setSkinForState()
	 */
	[Style(name="defaultSelectedSkin",type="starling.display.DisplayObject")]

	/**
	 * If not <code>NaN</code>, the button renders at this scale when selected.
	 * Otherwise, defaults to <code>1</code>.
	 *
	 * <p>The following example scales the button when selected:</p>
	 *
	 * <listing version="3.0">
	 * button.scaleWhenSelected = 0.9;</listing>
	 *
	 * @default 1
	 *
	 * @see #isSelected
	 * @see #getScaleForState()
	 * @see #setScaleForState()
	 */
	[Style(name="scaleWhenSelected",type="Number")]

	/**
	 * The icon used for the button's disabled state when the button is
	 * selected. If <code>null</code>, then <code>defaultSelectedIcon</code>
	 * is used instead. If <code>defaultSelectedIcon</code> is also
	 * <code>null</code>, then <code>defaultIcon</code> is used.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToIconFunction</code> property.</p>
	 *
	 * <p>The following example gives the button an icon for the selected disabled state:</p>
	 *
	 * <listing version="3.0">
	 * button.selectedDisabledIcon = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setIconForState()</code> with
	 * <code>ButtonState.DISABLED_AND_SELECTED</code> to set the same icon:</p>
	 *
	 * <listing version="3.0">
	 * var icon:Image = new Image( texture );
	 * button.setIconForState( ButtonState.DISABLED_AND_SELECTED, icon );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultIcon
	 * @see #style:defaultSelectedIcon
	 * @see feathers.controls.ButtonState#DISABLED_AND_SELECTED
	 */
	[Style(name="selectedDisabledIcon",type="starling.display.DisplayObject")]

	/**
	 * The skin used for the button's disabled state when the button is
	 * selected. If <code>null</code>, then <code>defaultSelectedSkin</code>
	 * is used instead. If <code>defaultSelectedSkin</code> is also
	 * <code>null</code>, then <code>defaultSkin</code> is used.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToSkinFunction</code> property.</p>
	 *
	 * <p>The following example gives the button a skin for the selected disabled state:</p>
	 *
	 * <listing version="3.0">
	 * button.selectedDisabledSkin = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setSkinForState()</code> with
	 * <code>ButtonState.DISABLED_AND_SELECTED</code> to set the same skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * button.setSkinForState( ButtonState.DISABLED_AND_SELECTED, skin );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultSkin
	 * @see #style:defaultSelectedSkin
	 * @see feathers.controls.ButtonState#DISABLED_AND_SELECTED
	 */
	[Style(name="selectedDisabledSkin",type="starling.display.DisplayObject")]

	/**
	 * The font styles used to display the button's text when the button is
	 * selected.
	 *
	 * <p>In the following example, the selected font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * button.selectedFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>labelFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:fontStyles
	 */
	[Style(name="selectedFontStyles",type="starling.text.TextFormat")]

	/**
	 * The icon used for the button's hover state when the button is
	 * selected. If <code>null</code>, then <code>defaultSelectedIcon</code>
	 * is used instead. If <code>defaultSelectedIcon</code> is also
	 * <code>null</code>, then <code>defaultIcon</code> is used.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToIconFunction</code> property.</p>
	 *
	 * <p>The following example gives the button an icon for the selected hover state:</p>
	 *
	 * <listing version="3.0">
	 * button.selectedHoverIcon = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setIconForState()</code> with
	 * <code>ButtonState.HOVER_AND_SELECTED</code> to set the same icon:</p>
	 *
	 * <listing version="3.0">
	 * var icon:Image = new Image( texture );
	 * button.setIconForState( ButtonState.HOVER_AND_SELECTED, icon );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultIcon
	 * @see #style:defaultSelectedIcon
	 * @see feathers.controls.ButtonState#HOVER_AND_SELECTED
	 */
	[Style(name="selectedHoverIcon",type="starling.display.DisplayObject")]

	/**
	 * The skin used for the button's hover state when the button is
	 * selected. If <code>null</code>, then <code>defaultSelectedSkin</code>
	 * is used instead. If <code>defaultSelectedSkin</code> is also
	 * <code>null</code>, then <code>defaultSkin</code> is used.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToSkinFunction</code> property.</p>
	 *
	 * <p>The following example gives the button a skin for the selected hover state:</p>
	 *
	 * <listing version="3.0">
	 * button.selectedHoverSkin = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setSkinForState()</code> with
	 * <code>ButtonState.HOVER_AND_SELECTED</code> to set the same skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * button.setSkinForState( ButtonState.HOVER_AND_SELECTED, skin );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultSkin
	 * @see #style:defaultSelectedSkin
	 * @see feathers.controls.ButtonState#HOVER_AND_SELECTED
	 */
	[Style(name="selectedHoverSkin",type="starling.display.DisplayObject")]

	/**
	 * The icon used for the button's down state when the button is
	 * selected. If <code>null</code>, then <code>defaultSelectedIcon</code>
	 * is used instead. If <code>defaultSelectedIcon</code> is also
	 * <code>null</code>, then <code>defaultIcon</code> is used.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToIconFunction</code> property.</p>
	 *
	 * <p>The following example gives the button an icon for the selected down state:</p>
	 *
	 * <listing version="3.0">
	 * button.selectedDownIcon = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setIconForState()</code> with
	 * <code>ButtonState.DOWN_AND_SELECTED</code> to set the same icon:</p>
	 *
	 * <listing version="3.0">
	 * var icon:Image = new Image( texture );
	 * button.setIconForState( ButtonState.DOWN_AND_SELECTED, icon );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultIcon
	 * @see #style:defaultSelectedIcon
	 * @see feathers.controls.ButtonState#DOWN_AND_SELECTED
	 */
	[Style(name="selectedDownIcon",type="starling.display.DisplayObject")]

	/**
	 * The skin used for the button's down state when the button is
	 * selected. If <code>null</code>, then <code>defaultSelectedSkin</code>
	 * is used instead. If <code>defaultSelectedSkin</code> is also
	 * <code>null</code>, then <code>defaultSkin</code> is used.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToSkinFunction</code> property.</p>
	 *
	 * <p>The following example gives the button a skin for the selected down state:</p>
	 *
	 * <listing version="3.0">
	 * button.selectedDownSkin = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setSkinForState()</code> with
	 * <code>ButtonState.DOWN_AND_SELECTED</code> to set the same skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * button.setSkinForState( ButtonState.DOWN_AND_SELECTED, skin );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultSkin
	 * @see #style:defaultSelectedSkin
	 * @see feathers.controls.ButtonState#DOWN_AND_SELECTED
	 */
	[Style(name="selectedDownSkin",type="starling.display.DisplayObject")]

	/**
	 * The icon used for the button's up state when the button is
	 * selected. If <code>null</code>, then <code>defaultSelectedIcon</code>
	 * is used instead. If <code>defaultSelectedIcon</code> is also
	 * <code>null</code>, then <code>defaultIcon</code> is used.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToIconFunction</code> property.</p>
	 *
	 * <p>The following example gives the button an icon for the selected up state:</p>
	 *
	 * <listing version="3.0">
	 * button.selectedUpIcon = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setIconForState()</code> with
	 * <code>ButtonState.UP_AND_SELECTED</code> to set the same icon:</p>
	 *
	 * <listing version="3.0">
	 * var icon:Image = new Image( texture );
	 * button.setIconForState( ButtonState.UP_AND_SELECTED, icon );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultIcon
	 * @see #style:defaultSelectedIcon
	 * @see feathers.controls.ButtonState#UP_AND_SELECTED
	 */
	[Style(name="selectedUpIcon",type="starling.display.DisplayObject")]

	/**
	 * The skin used for the button's up state when the button is selected.
	 * If <code>null</code>, then <code>defaultSelectedSkin</code> is used
	 * instead. If <code>defaultSelectedSkin</code> is also
	 * <code>null</code>, then <code>defaultSkin</code> is used.
	 *
	 * <p>This property will be ignored if a function is passed to the
	 * <code>stateToSkinFunction</code> property.</p>
	 *
	 * <p>The following example gives the button a skin for the selected up state:</p>
	 *
	 * <listing version="3.0">
	 * button.selectedUpSkin = new Image( texture );</listing>
	 *
	 * <p>Alternatively, you may use <code>setSkinForState()</code> with
	 * <code>ButtonState.UP_AND_SELECTED</code> to set the same skin:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * button.setSkinForState( ButtonState.UP_AND_SELECTED, skin );</listing>
	 *
	 * @default null
	 *
	 * @see #style:defaultSkin
	 * @see #style:defaultSelectedSkin
	 * @see feathers.controls.ButtonState#UP_AND_SELECTED
	 */
	[Style(name="selectedUpSkin",type="starling.display.DisplayObject")]

	/**
	 * Dispatched when the button is selected or deselected either
	 * programmatically or as a result of user interaction. The value of the
	 * <code>isSelected</code> property indicates whether the button is selected
	 * or not. Use interaction may only change selection when the
	 * <code>isToggle</code> property is set to <code>true</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 *
	 * @see #isSelected
	 * @see #isToggle
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * A button that may be selected and deselected when triggered.
	 *
	 * <p>The following example creates a toggle button, and listens for when
	 * its selection changes:</p>
	 *
	 * <listing version="3.0">
	 * var button:ToggleButton = new ToggleButton();
	 * button.label = "Click Me";
	 * button.addEventListener( Event.CHANGE, button_changeHandler );
	 * this.addChild( button );</listing>
	 *
	 * @see ../../../help/toggle-button.html How to use the Feathers ToggleButton component
	 *
	 * @productversion Feathers 2.0.0
	 */
	public class ToggleButton extends Button implements IGroupedToggle
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>ToggleButton</code>
		 * components. If <code>null</code>, falls back to using
		 * <code>Button.globalStyleProvider</code> instead.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 * @see feathers.controls.Button#globalStyleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function ToggleButton()
		{
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			if(ToggleButton.globalStyleProvider)
			{
				return ToggleButton.globalStyleProvider;
			}
			return Button.globalStyleProvider;
		}

		/**
		 * @private
		 */
		override public function get currentState():String
		{
			if(this._isSelected)
			{
				return super.currentState + "AndSelected";
			}
			return super.currentState;
		}

		/**
		 * @private
		 */
		protected var tapToSelect:TapToSelect;

		/**
		 * @private
		 */
		protected var keyToSelect:KeyToSelect;

		/**
		 * @private
		 */
		protected var dpadEnterKeyToSelect:KeyToSelect;

		/**
		 * @private
		 */
		protected var _isToggle:Boolean = true;

		/**
		 * Determines if the button may be selected or deselected as a result of
		 * user interaction. If <code>true</code>, the value of the
		 * <code>isSelected</code> property will be toggled when the button is
		 * triggered.
		 *
		 * <p>The following example disables the ability to toggle:</p>
		 *
		 * <listing version="3.0">
		 * button.isToggle = false;</listing>
		 *
		 * @default true
		 *
		 * @see #isSelected
		 * @see #event:triggered Event.TRIGGERED
		 */
		public function get isToggle():Boolean
		{
			return this._isToggle;
		}

		/**
		 * @private
		 */
		public function set isToggle(value:Boolean):void
		{
			if(this._isToggle === value)
			{
				return;
			}
			this._isToggle = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isSelected:Boolean = false;

		/**
		 * Indicates if the button is selected or not. The button may be
		 * selected programmatically, even if <code>isToggle</code> is <code>false</code>,
		 * but generally, <code>isToggle</code> should be set to <code>true</code>
		 * to allow the user to select and deselect it by triggering the button
		 * with a click or tap. If focus management is enabled, a button may
		 * also be triggered with the spacebar when the button has focus.
		 *
		 * <p>The following example enables the button to toggle and selects it
		 * automatically:</p>
		 *
		 * <listing version="3.0">
		 * button.isToggle = true;
		 * button.isSelected = true;</listing>
		 *
		 * <p><strong>Warning:</strong> Do not listen to
		 * <code>Event.TRIGGERED</code> to be notified when the
		 * <code>isSelected</code> property changes. You must listen to
		 * <code>Event.CHANGE</code>.</p>
		 *
		 * @default false
		 *
		 * @see #event:change Event.CHANGE
		 * @see #isToggle
		 */
		public function get isSelected():Boolean
		{
			return this._isSelected;
		}

		/**
		 * @private
		 */
		public function set isSelected(value:Boolean):void
		{
			if(this._isSelected === value)
			{
				return;
			}
			this._isSelected = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
			this.invalidate(INVALIDATION_FLAG_STATE);
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(FeathersEventType.STATE_CHANGE);
		}

		/**
		 * @private
		 */
		protected var _toggleGroup:ToggleGroup;

		/**
		 * @inheritDoc
		 */
		public function get toggleGroup():ToggleGroup
		{
			return this._toggleGroup;
		}

		/**
		 * @private
		 */
		public function set toggleGroup(value:ToggleGroup):void
		{
			if(this._toggleGroup == value)
			{
				return;
			}
			if(this._toggleGroup && this._toggleGroup.hasItem(this))
			{
				this._toggleGroup.removeItem(this);
			}
			this._toggleGroup = value;
			if(this._toggleGroup && !this._toggleGroup.hasItem(this))
			{
				this._toggleGroup.addItem(this);
			}
		}

		/**
		 * @private
		 */
		protected var _defaultSelectedSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get defaultSelectedSkin():DisplayObject
		{
			return this._defaultSelectedSkin;
		}

		/**
		 * @private
		 */
		public function set defaultSelectedSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._defaultSelectedSkin === value)
			{
				return;
			}
			if(this._defaultSelectedSkin !== null &&
				this.currentSkin === this._defaultSelectedSkin)
			{
				//if this icon needs to be reused somewhere else, we need to
				//properly clean it up
				this.removeCurrentSkin(this._defaultSelectedSkin);
				this.currentSkin = null;
			}
			this._defaultSelectedSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		public function get selectedUpSkin():DisplayObject
		{
			return this.getSkinForState(ButtonState.UP_AND_SELECTED);
		}

		/**
		 * @private
		 */
		public function set selectedUpSkin(value:DisplayObject):void
		{
			this.setSkinForState(ButtonState.UP_AND_SELECTED, value);
		}

		/**
		 * @private
		 */
		public function get selectedDownSkin():DisplayObject
		{
			return this.getSkinForState(ButtonState.DOWN_AND_SELECTED);
		}

		/**
		 * @private
		 */
		public function set selectedDownSkin(value:DisplayObject):void
		{
			this.setSkinForState(ButtonState.DOWN_AND_SELECTED, value);
		}

		/**
		 * @private
		 */
		public function get selectedHoverSkin():DisplayObject
		{
			return this.getSkinForState(ButtonState.HOVER_AND_SELECTED);
		}

		/**
		 * @private
		 */
		public function set selectedHoverSkin(value:DisplayObject):void
		{
			this.setSkinForState(ButtonState.HOVER_AND_SELECTED, value);
		}

		/**
		 * @private
		 */
		public function get selectedDisabledSkin():DisplayObject
		{
			return this.getSkinForState(ButtonState.DISABLED_AND_SELECTED);
		}

		/**
		 * @private
		 */
		public function set selectedDisabledSkin(value:DisplayObject):void
		{
			this.setSkinForState(ButtonState.DISABLED_AND_SELECTED, value);
		}

		/**
		 * @private
		 */
		public function get selectedFontStyles():TextFormat
		{
			return this._fontStylesSet.selectedFormat;
		}

		/**
		 * @private
		 */
		public function set selectedFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.selectedFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.selectedFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _defaultSelectedIcon:DisplayObject;

		/**
		 * @private
		 */
		public function get defaultSelectedIcon():DisplayObject
		{
			return this._defaultSelectedIcon;
		}

		/**
		 * @private
		 */
		public function set defaultSelectedIcon(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._defaultSelectedIcon === value)
			{
				return;
			}
			if(this._defaultSelectedIcon !== null &&
				this.currentIcon === this._defaultSelectedIcon)
			{
				//if this icon needs to be reused somewhere else, we need to
				//properly clean it up
				this.removeCurrentIcon(this._defaultSelectedIcon);
				this.currentIcon = null;
			}
			this._defaultSelectedIcon = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		public function get selectedUpIcon():DisplayObject
		{
			return this.getIconForState(ButtonState.UP_AND_SELECTED);
		}

		/**
		 * @private
		 */
		public function set selectedUpIcon(value:DisplayObject):void
		{
			this.setIconForState(ButtonState.UP_AND_SELECTED, value);
		}

		/**
		 * @private
		 */
		public function get selectedDownIcon():DisplayObject
		{
			return this.getIconForState(ButtonState.DOWN_AND_SELECTED);
		}

		/**
		 * @private
		 */
		public function set selectedDownIcon(value:DisplayObject):void
		{
			this.setIconForState(ButtonState.DOWN_AND_SELECTED, value);
		}

		/**
		 * @private
		 */
		public function get selectedHoverIcon():DisplayObject
		{
			return this.getIconForState(ButtonState.HOVER_AND_SELECTED);
		}

		/**
		 * @private
		 */
		public function set selectedHoverIcon(value:DisplayObject):void
		{
			this.setIconForState(ButtonState.HOVER_AND_SELECTED, value);
		}

		/**
		 * @private
		 */
		public function get selectedDisabledIcon():DisplayObject
		{
			return this.getIconForState(ButtonState.DISABLED_AND_SELECTED);
		}

		/**
		 * @private
		 */
		public function set selectedDisabledIcon(value:DisplayObject):void
		{
			this.setIconForState(ButtonState.DISABLED_AND_SELECTED, value);
		}

		/**
		 * @private
		 */
		protected var _scaleWhenSelected:Number = 1;

		/**
		 * @private
		 */
		public function get scaleWhenSelected():Number
		{
			return this._scaleWhenSelected;
		}

		/**
		 * @private
		 */
		public function set scaleWhenSelected(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._scaleWhenSelected == value)
			{
				return;
			}
			this._scaleWhenSelected = value;
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this._defaultSelectedSkin && this._defaultSelectedSkin.parent !== this)
			{
				this._defaultSelectedSkin.dispose();
			}
			if(this._defaultSelectedIcon && this._defaultSelectedIcon.parent !== this)
			{
				this._defaultSelectedIcon.dispose();
			}
			if(this.keyToSelect !== null)
			{
				//setting the target to null will remove listeners and do any
				//other clean up that is needed
				this.keyToSelect.target = null;
			}
			if(this.dpadEnterKeyToSelect !== null)
			{
				this.dpadEnterKeyToSelect.target = null;
			}
			if(this.tapToSelect !== null)
			{
				this.tapToSelect.target = null;
			}
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			super.initialize();
			if(!this.tapToSelect)
			{
				this.tapToSelect = new TapToSelect(this);
				this.longPress.tapToSelect = this.tapToSelect;
			}
			if(!this.keyToSelect)
			{
				this.keyToSelect = new KeyToSelect(this);
			}
			if(!this.dpadEnterKeyToSelect)
			{
				this.dpadEnterKeyToSelect = new KeyToSelect(this, Keyboard.ENTER);
				this.dpadEnterKeyToState.keyLocation = 4; //KeyLocation.D_PAD is only in AIR
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);

			if(stylesInvalid || stateInvalid)
			{
				this.refreshSelectionEvents();
			}

			super.draw();
		}

		/**
		 * @private
		 */
		override protected function getCurrentSkin():DisplayObject
		{
			//we use the currentState getter here instead of the variable
			//because the variable does not keep track of the selection
			var result:DisplayObject = this._stateToSkin[this.currentState] as DisplayObject;
			if(result !== null)
			{
				return result;
			}
			if(this._isSelected && this._defaultSelectedSkin !== null)
			{
				return this._defaultSelectedSkin;
			}
			return this._defaultSkin;
		}

		/**
		 * @private
		 */
		override protected function getCurrentIcon():DisplayObject
		{
			//we use the currentState getter here instead of the variable
			//because the variable does not keep track of the selection
			var result:DisplayObject = this._stateToIcon[this.currentState] as DisplayObject;
			if(result !== null)
			{
				return result;
			}
			if(this._isSelected && this._defaultSelectedIcon !== null)
			{
				return this._defaultSelectedIcon;
			}
			return this._defaultIcon;
		}

		/**
		 * @private
		 */
		override protected function getScaleForCurrentState(state:String = null):Number
		{
			if(state === null)
			{
				state = this.currentState;
			}
			if(state in this._stateToScale)
			{
				return this._stateToScale[state];
			}
			else if(this._isSelected)
			{
				return this._scaleWhenSelected;
			}
			return 1;
		}

		/**
		 * @private
		 */
		protected function refreshSelectionEvents():void
		{
			this.tapToSelect.isEnabled = this._isEnabled && this._isToggle;
			this.tapToSelect.tapToDeselect = this._isToggle;
			this.keyToSelect.isEnabled = this._isEnabled && this._isToggle;
			this.keyToSelect.keyToDeselect = this._isToggle;
			this.dpadEnterKeyToSelect.isEnabled = this._isEnabled && this._isToggle;
			this.dpadEnterKeyToSelect.keyToDeselect = this._isToggle;
		}
	}
}


================================================
FILE: source/feathers/controls/ToggleState.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * States for simple toggle components.
	 *
	 * @see feathers.core.IToggle
	 * @see feathers.controls.ToggleSwitch
	 *
	 * @productversion Feathers 3.1.0
	 */
	public class ToggleState
	{
		/**
		 * The state where the component is not selected. If the component
		 * implements the <code>IToggle</code> interface, the
		 * <code>isSelected</code> property will be <code>false</code>.
		 *
		 * @see feathers.core.IToggle
		 *
		 * @productversion Feathers 3.1.0
		 */
		public static const NOT_SELECTED:String = "notSelected";

		/**
		 * The state where the component is selected. If the component
		 * implements the <code>IToggle</code> interface, the
		 * <code>isSelected</code> property will be <code>true</code>.
		 *
		 * @see feathers.core.IToggle
		 *
		 * @productversion Feathers 3.1.0
		 */
		public static const SELECTED:String = "selected";

		/**
		 * The state where the component is not selected and disabled. If the
		 * component implements the <code>IToggle</code> interface, the
		 * <code>isSelected</code> property will be <code>false</code>. The
		 * <code>isEnabled</code> property will be <code>false</code>.
		 *
		 * @see feathers.core.IToggle
		 *
		 * @productversion Feathers 3.1.0
		 */
		public static const DISABLED:String = "disabled";

		/**
		 * The state where the component is selected and disabled. If the
		 * component implements the <code>IToggle</code> interface, the
		 * <code>isSelected</code> property will be <code>true</code>. The
		 * <code>isEnabled</code> property will be <code>false</code>.
		 *
		 * @see feathers.core.IToggle
		 *
		 * @productversion Feathers 3.1.0
		 */
		public static const SELECTED_AND_DISABLED:String = "selectedAndDisabled";
	}
}


================================================
FILE: source/feathers/controls/ToggleSwitch.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IFocusDisplayObject;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IStateContext;
	import feathers.core.ITextBaselineControl;
	import feathers.core.ITextRenderer;
	import feathers.core.IToggle;
	import feathers.core.IValidating;
	import feathers.core.PropertyProxy;
	import feathers.events.ExclusiveTouch;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;
	import feathers.system.DeviceCapabilities;
	import feathers.text.FontStylesSet;

	import flash.geom.Point;
	import flash.ui.KeyLocation;
	import flash.ui.Keyboard;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.KeyboardEvent;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.text.TextFormat;
	import starling.utils.SystemUtil;

	/**
	 * A style name to add to the toggle switch's on label text renderer
	 * sub-component. Typically used by a theme to provide different styles
	 * to different buttons.
	 *
	 * <p>In the following example, a custom on label style name is passed
	 * to the toggle switch:</p>
	 *
	 * <listing version="3.0">
	 * toggle.customOnLabelStyleName = "my-custom-toggle-on-label";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( BitmapFontTextRenderer ).setFunctionForStyleName( "my-custom-toggle-on-label", setCustomToggleSwitchOnLabelStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_ON_LABEL
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #onLabelFactory
	 */
	[Style(name="customOnLabelStyleName",type="String")]

	/**
	 * A style name to add to the toggle switch's on track sub-component.
	 * Typically used by a theme to provide different styles to different
	 * toggle switches.
	 *
	 * <p>In the following example, a custom on track style name is passed to
	 * the toggle switch:</p>
	 *
	 * <listing version="3.0">
	 * toggle.customOnTrackStyleName = "my-custom-on-track";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-on-track", setCustomOnTrackStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_ON_TRACK
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #onTrackFactory
	 */
	[Style(name="customOnTrackStyleName",type="String")]

	/**
	 * A style name to add to the toggle switch's off label text renderer
	 * sub-component. Typically used by a theme to provide different styles
	 * to different toggle switches.
	 *
	 * <p>In the following example, a custom off label style name is passed
	 * to the toggle switch:</p>
	 *
	 * <listing version="3.0">
	 * toggle.customOffLabelStyleName = "my-custom-toggle-off-label";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( BitmapFontTextRenderer ).setFunctionForStyleName( "my-custom-toggle-off-label", setCustomToggleSwitchOffLabelStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_OFF_LABEL
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #offLabelFactory
	 */
	[Style(name="customOffLabelStyleName",type="String")]

	/**
	 * A style name to add to the toggle switch's off track sub-component.
	 * Typically used by a theme to provide different styles to different
	 * toggle switches.
	 *
	 * <p>In the following example, a custom off track style name is passed
	 * to the toggle switch:</p>
	 *
	 * <listing version="3.0">
	 * toggle.customOffTrackStyleName = "my-custom-off-track";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-off-track", setCustomOffTrackStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_OFF_TRACK
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #offTrackFactory
	 */
	[Style(name="customOffTrackStyleName",type="String")]

	/**
	 * A style name to add to the toggle switch's thumb sub-component.
	 * Typically used by a theme to provide different styles to different
	 * toggle switches.
	 *
	 * <p>In the following example, a custom thumb style name is passed to
	 * the toggle switch:</p>
	 *
	 * <listing version="3.0">
	 * toggle.customThumbStyleName = "my-custom-thumb";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( Button ).setFunctionForStyleName( "my-custom-thumb", setCustomThumbStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_THUMB
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #thumbFactory
	 */
	[Style(name="customThumbStyleName",type="String")]

	/**
	 * The font styles used to display the on label's text when the toggle
	 * switch is disabled.
	 *
	 * <p>In the following example, the on labels' disabled font styles are
	 * customized:</p>
	 *
	 * <listing version="3.0">
	 * toggle.onLabelDisabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>onLabelFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:onLabelFontStyles
	 */
	[Style(name="onLabelDisabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the on label's text.
	 *
	 * <p>In the following example, the on label's font styles are
	 * customized:</p>
	 *
	 * <listing version="3.0">
	 * toggle.onLabelFontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>onLabelFactory</code> to set more advanced styles.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:onLabelDisabledFontStyles
	 * @see #style:onLabelSelectedFontStyles
	 * @see #setOnLabelFontStylesForState();
	 */
	[Style(name="onLabelFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the on label's text when the toggle
	 * switch is selected.
	 *
	 * <p>In the following example, the on label's selected font styles are
	 * customized:</p>
	 *
	 * <listing version="3.0">
	 * toggle.onLabelSelectedFontStyles = new TextFormat( "Helvetica", 20, 0xff0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>onLabelFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:onLabelFontStyles
	 */
	[Style(name="onLabelSelectedFontStyles",type="starling.text.TextFormat")]

	/**
	 * The text to display in the "on" label text renderer.
	 *
	 * <p>In the following example, the toggle switch's "on" label text is
	 * updated:</p>
	 *
	 * <listing version="3.0">
	 * toggle.onText = "on";</listing>
	 *
	 * @default "ON"
	 *
	 * @see #style:offText
	 */
	[Style(name="onText",type="String")]

	/**
	 * The font styles used to display the off label's text when the toggle
	 * switch is disabled.
	 *
	 * <p>In the following example, the off labels' disabled font styles are
	 * customized:</p>
	 *
	 * <listing version="3.0">
	 * toggle.offLabelDisabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>offLabelFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:offLabelFontStyles
	 */
	[Style(name="offLabelDisabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the off label's text.
	 *
	 * <p>In the following example, the off label's font styles are
	 * customized:</p>
	 *
	 * <listing version="3.0">
	 * toggle.offLabelFontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>offLabelFactory</code> to set more advanced styles.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:offLabelDisabledFontStyles
	 * @see #style:offLabelSelectedFontStyles
	 * @see #setOffLabelFontStylesForState();
	 */
	[Style(name="offLabelFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the off label's text when the toggle
	 * switch is selected.
	 *
	 * <p>In the following example, the off label's selected font styles are
	 * customized:</p>
	 *
	 * <listing version="3.0">
	 * toggle.offLabelSelectedFontStyles = new TextFormat( "Helvetica", 20, 0xff0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>offLabelFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:offLabelFontStyles
	 */
	[Style(name="offLabelSelectedFontStyles",type="starling.text.TextFormat")]

	/**
	 * The text to display in the "off" label text renderer.
	 *
	 * <p>In the following example, the toggle switch's off label text is
	 * updated:</p>
	 *
	 * <listing version="3.0">
	 * toggle.offText = "off";</listing>
	 *
	 * @default "OFF"
	 *
	 * @see #style:onText
	 */
	[Style(name="offText",type="String")]

	/**
	 * The minimum space, in pixels, between the switch's left edge and the
	 * switch's content.
	 *
	 * <p>In the following example, the toggle switch's left padding is
	 * set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * toggle.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingRight
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * The minimum space, in pixels, between the switch's right edge and the
	 * switch's content.
	 *
	 * <p>In the following example, the toggle switch's right padding is
	 * set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * toggle.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingLeft
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * Determines if the labels should be drawn. The onTrackSkin and
	 * offTrackSkin backgrounds may include the text instead.
	 *
	 * <p>In the following example, the toggle switch's labels are hidden:</p>
	 *
	 * <listing version="3.0">
	 * toggle.showLabels = false;</listing>
	 *
	 * @default true
	 */
	[Style(name="showLabels",type="Boolean")]

	/**
	 * Determines if the thumb should be displayed. This stops interaction
	 * while still displaying the background.
	 *
	 * <p>In the following example, the toggle switch's thumb is hidden:</p>
	 *
	 * <listing version="3.0">
	 * toggle.showThumb = false;</listing>
	 *
	 * @default true
	 */
	[Style(name="showThumb",type="Boolean")]

	/**
	 * The duration, in seconds, of the animation when the toggle switch
	 * is toggled and animates the position of the thumb.
	 *
	 * <p>In the following example, the duration of the toggle switch thumb
	 * animation is updated:</p>
	 *
	 * <listing version="3.0">
	 * toggle.toggleDuration = 0.5;</listing>
	 *
	 * @default 0.15
	 */
	[Style(name="toggleDuration",type="Number")]

	/**
	 * The easing function used for toggle animations.
	 *
	 * <p>In the following example, the easing function used by the toggle
	 * switch's thumb animation is updated:</p>
	 *
	 * <listing version="3.0">
	 * toggle.toggleEase = Transitions.EASE_IN_OUT;</listing>
	 *
	 * @default starling.animation.Transitions.EASE_OUT
	 *
	 * @see http://doc.starling-framework.org/core/starling/animation/Transitions.html starling.animation.Transitions
	 */
	[Style(name="toggleEase",type="Object")]

	/**
	 * Determines if the <code>isSelected</code> property of the thumb
	 * is updated to match the <code>isSelected</code> property of the
	 * toggle switch, if the class used to create the thumb implements the
	 * <code>IToggle</code> interface. Useful for skinning to provide a
	 * different appearance for the thumb based on whether the toggle switch
	 * is selected or not.
	 *
	 * <p>In the following example, the thumb selection is toggled:</p>
	 *
	 * <listing version="3.0">
	 * toggle.toggleThumbSelection = true;</listing>
	 *
	 * @default false
	 *
	 * @see feathers.core.IToggle
	 * @see feathers.controls.ToggleButton
	 */
	[Style(name="toggleThumbSelection",type="Boolean")]

	/**
	 * Determines how the on and off track skins are positioned and sized.
	 *
	 * <p>In the following example, the toggle switch's track layout mode is
	 * updated to use two tracks:</p>
	 *
	 * <listing version="3.0">
	 * toggle.trackLayoutMode = TrackLayoutMode.SPLIT;</listing>
	 *
	 * @default feathers.controls.TrackLayoutMode.SINGLE
	 *
	 * @see feathers.controls.TrackLayoutMode#SINGLE
	 * @see feathers.controls.TrackLayoutMode#SPLIT
	 * @see #style:trackScaleMode
	 */
	[Style(name="trackLayoutMode",type="String")]

	/**
	 * Determines how the on and off track skins are positioned and sized.
	 *
	 * <p>In the following example, the toggle switch's track scale is
	 * customized:</p>
	 *
	 * <listing version="3.0">
	 * toggle.trackScaleMode = TrackScaleMode.EXACT_FIT;</listing>
	 *
	 * @default feathers.controls.TrackScaleMode.DIRECTIONAL
	 *
	 * @see feathers.controls.TrackScaleMode#DIRECTIONAL
	 * @see feathers.controls.TrackScaleMode#EXACT_FIT
	 * @see #style:trackLayoutMode
	 */
	[Style(name="trackScaleMode",type="String")]

	/**
	 * @copy feathers.core.IToggle#event:change
	 *
	 * @see #isSelected
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the display object's state changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.STATE_CHANGE
	 *
	 * @see #currentState
	 */
	[Event(name="stateChange",type="starling.events.Event")]

	/**
	 * Similar to a light switch with on and off states. Generally considered an
	 * alternative to a check box.
	 *
	 * <p>The following example programmatically selects a toggle switch and
	 * listens for when the selection changes:</p>
	 *
	 * <listing version="3.0">
	 * var toggle:ToggleSwitch = new ToggleSwitch();
	 * toggle.isSelected = true;
	 * toggle.addEventListener( Event.CHANGE, toggle_changeHandler );
	 * this.addChild( toggle );</listing>
	 *
	 * @see ../../../help/toggle-switch.html How to use the Feathers ToggleSwitch component
	 * @see feathers.controls.Check
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class ToggleSwitch extends FeathersControl implements IToggle, IFocusDisplayObject, ITextBaselineControl, IStateContext
	{
		/**
		 * @private
		 */
		private static const HELPER_POINT:Point = new Point();

		/**
		 * @private
		 * The minimum physical distance (in inches) that a touch must move
		 * before the scroller starts scrolling.
		 */
		private static const MINIMUM_DRAG_DISTANCE:Number = 0.04;

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_THUMB_FACTORY:String = "thumbFactory";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_ON_TRACK_FACTORY:String = "onTrackFactory";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_OFF_TRACK_FACTORY:String = "offTrackFactory";

		/**
		 * The default value added to the <code>styleNameList</code> of the "off
		 * label" text renderer.
		 *
		 * <p>Note: the "off label" text renderer is not a
		 * <code>feathers.controls.Label</code>. It is an instance of one of the
		 * <code>ITextRenderer</code> implementations.</p>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 * @see ../../../help/text-renderers.html Introduction to Feathers text renderers
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_OFF_LABEL:String = "feathers-toggle-switch-off-label";

		/**
		 * The default value added to the <code>styleNameList</code> of the "on
		 * label" text renderer.
		 *
		 * <p>Note: the "on label" text renderer is not a
		 * <code>feathers.controls.Label</code>. It is an instance of one of the
		 * <code>ITextRenderer</code> implementations.</p>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 * @see ../../../help/text-renderers.html Introduction to Feathers text renderers
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ON_LABEL:String = "feathers-toggle-switch-on-label";

		/**
		 * The default value added to the <code>styleNameList</code> of the off track.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_OFF_TRACK:String = "feathers-toggle-switch-off-track";

		/**
		 * The default value added to the <code>styleNameList</code> of the on track.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ON_TRACK:String = "feathers-toggle-switch-on-track";

		/**
		 * The default value added to the <code>styleNameList</code> of the thumb.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_THUMB:String = "feathers-toggle-switch-thumb";

		/**
		 * The default <code>IStyleProvider</code> for all <code>ToggleSwitch</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static function defaultThumbFactory():BasicButton
		{
			return new Button();
		}

		/**
		 * @private
		 */
		protected static function defaultOnTrackFactory():BasicButton
		{
			return new Button();
		}

		/**
		 * @private
		 */
		protected static function defaultOffTrackFactory():BasicButton
		{
			return new Button();
		}

		/**
		 * Constructor.
		 */
		public function ToggleSwitch()
		{
			super();
			if(this._onLabelFontStylesSet === null)
			{
				this._onLabelFontStylesSet = new FontStylesSet();
				this._onLabelFontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
			if(this._offLabelFontStylesSet === null)
			{
				this._offLabelFontStylesSet = new FontStylesSet();
				this._offLabelFontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
			this.addEventListener(TouchEvent.TOUCH, toggleSwitch_touchHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, toggleSwitch_removedFromStageHandler);
		}

		/**
		 * The value added to the <code>styleNameList</code> of the off label
		 * text renderer. This variable is <code>protected</code> so that
		 * sub-classes can customize the on label text renderer style name in
		 * their constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_ON_LABEL</code>.
		 *
		 * <p>To customize the "on" label text renderer style name without
		 * subclassing, see <code>customOnLabelStyleName</code>.</p>
		 *
		 * @see #style:customOnLabelStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var onLabelStyleName:String = DEFAULT_CHILD_STYLE_NAME_ON_LABEL;

		/**
		 * The value added to the <code>styleNameList</code> of the off label
		 * text renderer. This variable is <code>protected</code> so that
		 * sub-classes can customize the off label text renderer style name in
		 * their constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_OFF_LABEL</code>.
		 *
		 * <p>To customize the "off" label text renderer style name without
		 * subclassing, see <code>customOffLabelStyleName</code>.</p>
		 *
		 * @see #style:customOffLabelStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var offLabelStyleName:String = DEFAULT_CHILD_STYLE_NAME_OFF_LABEL;

		/**
		 * The value added to the <code>styleNameList</code> of the on track.
		 * This variable is <code>protected</code> so that sub-classes can
		 * customize the on track style name in their constructors instead of
		 * using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_ON_TRACK</code>.
		 *
		 * <p>To customize the on track style name without subclassing, see
		 * <code>customOnTrackStyleName</code>.</p>
		 *
		 * @see #style:customOnTrackStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var onTrackStyleName:String = DEFAULT_CHILD_STYLE_NAME_ON_TRACK;

		/**
		 * The value added to the <code>styleNameList</code> of the off track.
		 * This variable is <code>protected</code> so that sub-classes can
		 * customize the off track style name in their constructors instead of
		 * using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_OFF_TRACK</code>.
		 *
		 * <p>To customize the off track style name without subclassing, see
		 * <code>customOffTrackStyleName</code>.</p>
		 *
		 * @see #style:customOffTrackStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var offTrackStyleName:String = DEFAULT_CHILD_STYLE_NAME_OFF_TRACK;

		/**
		 * The value added to the <code>styleNameList</code> of the thumb. This
		 * variable is <code>protected</code> so that sub-classes can customize
		 * the thumb style name in their constructors instead of using the
		 * default stylename defined by <code>DEFAULT_CHILD_STYLE_NAME_THUMB</code>.
		 *
		 * <p>To customize the thumb style name without subclassing, see
		 * <code>customThumbStyleName</code>.</p>
		 *
		 * @see #style:customThumbStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var thumbStyleName:String = DEFAULT_CHILD_STYLE_NAME_THUMB;

		/**
		 * The thumb sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #thumbFactory
		 * @see #createThumb()
		 */
		protected var thumb:DisplayObject;

		/**
		 * The "on" text renderer sub-component.
		 *
		 * @see #labelFactory
		 */
		protected var onTextRenderer:ITextRenderer;

		/**
		 * The "off" text renderer sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #labelFactory
		 */
		protected var offTextRenderer:ITextRenderer;

		/**
		 * The "on" track sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #onTrackFactory
		 * @see #createOnTrack()
		 */
		protected var onTrack:DisplayObject;

		/**
		 * The "off" track sub-component.
		 *
		 * <p>For internal use in subclasses.</p>
		 *
		 * @see #offTrackFactory
		 * @see #createOffTrack()
		 */
		protected var offTrack:DisplayObject;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return ToggleSwitch.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _currentState:String = ToggleState.NOT_SELECTED;

		/**
		 * The current state of the toggle switch.
		 *
		 * @see feathers.controls.ToggleState
		 * @see #event:stateChange feathers.events.FeathersEventType.STATE_CHANGE
		 */
		public function get currentState():String
		{
			return this._currentState;
		}

		/**
		 * @private
		 */
		override public function set isEnabled(value:Boolean):void
		{
			if(this._isEnabled === value)
			{
				return;
			}
			super.isEnabled = value;
			this.resetState();
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _showLabels:Boolean = true;

		/**
		 * @private
		 */
		public function get showLabels():Boolean
		{
			return _showLabels;
		}

		/**
		 * @private
		 */
		public function set showLabels(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._showLabels === value)
			{
				return;
			}
			this._showLabels = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _showThumb:Boolean = true;

		/**
		 * @private
		 */
		public function get showThumb():Boolean
		{
			return this._showThumb;
		}

		/**
		 * @private
		 */
		public function set showThumb(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._showThumb === value)
			{
				return;
			}
			this._showThumb = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _trackLayoutMode:String = TrackLayoutMode.SINGLE;

		[Inspectable(type="String",enumeration="single,split")]
		/**
		 * @private
		 */
		public function get trackLayoutMode():String
		{
			return this._trackLayoutMode;
		}

		/**
		 * @private
		 */
		public function set trackLayoutMode(value:String):void
		{
			if(value === "onOff")
			{
				value = TrackLayoutMode.SPLIT;
			}
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._trackLayoutMode === value)
			{
				return;
			}
			this._trackLayoutMode = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _trackScaleMode:String = TrackScaleMode.DIRECTIONAL;

		[Inspectable(type="String",enumeration="exactFit,directional")]
		/**
		 * @private
		 */
		public function get trackScaleMode():String
		{
			return this._trackScaleMode;
		}

		/**
		 * @private
		 */
		public function set trackScaleMode(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._trackScaleMode === value)
			{
				return;
			}
			this._trackScaleMode = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _defaultLabelProperties:PropertyProxy;

		/**
		 * An object that stores properties for the toggle switch's label text
		 * renderers when the toggle switch is enabled, and the properties will
		 * be passed down to the text renderers when the toggle switch
		 * validates. The available properties depend on which
		 * <code>ITextRenderer</code> implementation is returned by
		 * <code>labelFactory</code> (possibly <code>onLabelFactory</code> or
		 * <code>offLabelFactory</code> instead). Refer to
		 * <a href="../core/ITextRenderer.html"><code>feathers.core.ITextRenderer</code></a>
		 * for a list of available text renderer implementations.
		 *
		 * <p>In the following example, the toggle switch's default label
		 * properties are updated (this example assumes that the label text
		 * renderers are of type <code>TextFieldTextRenderer</code>):</p>
		 *
		 * <listing version="3.0">
		 * toggle.defaultLabelProperties.textFormat = new TextFormat( "Source Sans Pro", 16, 0x333333 );
		 * toggle.defaultLabelProperties.embedFonts = true;</listing>
		 *
		 * @default null
		 *
		 * @see #labelFactory
		 * @see #onLabelFactory
		 * @see #offLabelFactory
		 * @see feathers.core.ITextRenderer
		 */
		public function get defaultLabelProperties():Object
		{
			if(!this._defaultLabelProperties)
			{
				this._defaultLabelProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._defaultLabelProperties;
		}

		/**
		 * @private
		 */
		public function set defaultLabelProperties(value:Object):void
		{
			if(!(value is PropertyProxy))
			{
				value = PropertyProxy.fromObject(value);
			}
			if(this._defaultLabelProperties)
			{
				this._defaultLabelProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._defaultLabelProperties = PropertyProxy(value);
			if(this._defaultLabelProperties)
			{
				this._defaultLabelProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _disabledLabelProperties:PropertyProxy;

		/**
		 * An object that stores properties for the toggle switch's label text
		 * renderers when the toggle switch is disabled, and the properties will
		 * be passed down to the text renderers when the toggle switch
		 * validates. The available properties depend on which
		 * <code>ITextRenderer</code> implementation is returned by
		 * <code>labelFactory</code> (possibly <code>onLabelFactory</code> or
		 * <code>offLabelFactory</code> instead). Refer to
		 * <a href="../core/ITextRenderer.html"><code>feathers.core.ITextRenderer</code></a>
		 * for a list of available text renderer implementations.
		 *
		 * <p>In the following example, the toggle switch's disabled label
		 * properties are updated (this example assumes that the label text
		 * renderers are of type <code>TextFieldTextRenderer</code>):</p>
		 *
		 * <listing version="3.0">
		 * toggle.disabledLabelProperties.textFormat = new TextFormat( "Source Sans Pro", 16, 0x333333 );
		 * toggle.disabledLabelProperties.embedFonts = true;</listing>
		 *
		 * @default null
		 *
		 * @see #labelFactory
		 * @see #onLabelFactory
		 * @see #offLabelFactory
		 * @see feathers.core.ITextRenderer
		 */
		public function get disabledLabelProperties():Object
		{
			if(!this._disabledLabelProperties)
			{
				this._disabledLabelProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._disabledLabelProperties;
		}

		/**
		 * @private
		 */
		public function set disabledLabelProperties(value:Object):void
		{
			if(!(value is PropertyProxy))
			{
				value = PropertyProxy.fromObject(value);
			}
			if(this._disabledLabelProperties)
			{
				this._disabledLabelProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._disabledLabelProperties = PropertyProxy(value);
			if(this._disabledLabelProperties)
			{
				this._disabledLabelProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _onLabelProperties:PropertyProxy;

		/**
		 * An object that stores properties for the toggle switch's "on" label
		 * text renderer, and the properties will be passed down to the text
		 * renderer when the toggle switch validates. If <code>null</code>, then
		 * <code>defaultLabelProperties</code> is used instead.
		 *
		 * <p>The available properties depend on which
		 * <code>ITextRenderer</code> implementation is returned by
		 * <code>labelFactory</code> (possibly <code>onLabelFactory</code>
		 * instead). Refer to
		 * <a href="../core/ITextRenderer.html"><code>feathers.core.ITextRenderer</code></a>
		 * for a list of available text renderer implementations.</p>
		 *
		 * <p>In the following example, the toggle switch's on label properties
		 * are updated (this example assumes that the on label text renderer is a
		 * <code>TextFieldTextRenderer</code>):</p>
		 *
		 * <listing version="3.0">
		 * toggle.onLabelProperties.textFormat = new TextFormat( "Source Sans Pro", 16, 0x333333 );
		 * toggle.onLabelProperties.embedFonts = true;</listing>
		 *
		 * @default null
		 *
		 * @see #labelFactory
		 * @see feathers.core.ITextRenderer
		 */
		public function get onLabelProperties():Object
		{
			if(!this._onLabelProperties)
			{
				this._onLabelProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._onLabelProperties;
		}

		/**
		 * @private
		 */
		public function set onLabelProperties(value:Object):void
		{
			if(!(value is PropertyProxy))
			{
				value = PropertyProxy.fromObject(value);
			}
			if(this._onLabelProperties)
			{
				this._onLabelProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._onLabelProperties = PropertyProxy(value);
			if(this._onLabelProperties)
			{
				this._onLabelProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _offLabelProperties:PropertyProxy;

		/**
		 * An object that stores properties for the toggle switch's "off" label
		 * text renderer, and the properties will be passed down to the text
		 * renderer when the toggle switch validates. If <code>null</code>, then
		 * <code>defaultLabelProperties</code> is used instead.
		 *
		 * <p>The available properties depend on which
		 * <code>ITextRenderer</code> implementation is returned by
		 * <code>labelFactory</code> (possibly <code>offLabelFactory</code>
		 * instead). Refer to
		 * <a href="../core/ITextRenderer.html"><code>feathers.core.ITextRenderer</code></a>
		 * for a list of available text renderer implementations.</p>
		 *
		 * <p>In the following example, the toggle switch's off label properties
		 * are updated (this example assumes that the off label text renderer is a
		 * <code>TextFieldTextRenderer</code>):</p>
		 *
		 * <listing version="3.0">
		 * toggle.offLabelProperties.textFormat = new TextFormat( "Source Sans Pro", 16, 0x333333 );
		 * toggle.offLabelProperties.embedFonts = true;</listing>
		 *
		 * @default null
		 *
		 * @see #labelFactory
		 * @see feathers.core.ITextRenderer
		 */
		public function get offLabelProperties():Object
		{
			if(!this._offLabelProperties)
			{
				this._offLabelProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._offLabelProperties;
		}

		/**
		 * @private
		 */
		public function set offLabelProperties(value:Object):void
		{
			if(!(value is PropertyProxy))
			{
				value = PropertyProxy.fromObject(value);
			}
			if(this._offLabelProperties)
			{
				this._offLabelProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._offLabelProperties = PropertyProxy(value);
			if(this._offLabelProperties)
			{
				this._offLabelProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _labelFactory:Function;

		/**
		 * A function used to instantiate the toggle switch's label text
		 * renderer sub-components, if specific factories for those label text
		 * renderers are not provided. The label text renderers must be
		 * instances of <code>ITextRenderer</code>. This factory can be used to
		 * change properties of the label text renderers when they are first
		 * created. For instance, if you are skinning Feathers components
		 * without a theme, you might use this factory to style the label text
		 * renderers.
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():ITextRenderer</pre>
		 *
		 * <p>In the following example, the toggle switch uses a custom label
		 * factory:</p>
		 *
		 * <listing version="3.0">
		 * toggle.labelFactory = function():ITextRenderer
		 * {
		 *     return new TextFieldTextRenderer();
		 * }</listing>
		 *
		 * @default null
		 *
		 * @see #onLabelFactory
		 * @see #offLabelFactory
		 * @see feathers.core.ITextRenderer
		 * @see feathers.core.FeathersControl#defaultTextRendererFactory
		 */
		public function get labelFactory():Function
		{
			return this._labelFactory;
		}

		/**
		 * @private
		 */
		public function set labelFactory(value:Function):void
		{
			if(this._labelFactory == value)
			{
				return;
			}
			this._labelFactory = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _onLabelFontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get onLabelFontStyles():TextFormat
		{
			return this._onLabelFontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set onLabelFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._onLabelFontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._onLabelFontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get onLabelDisabledFontStyles():TextFormat
		{
			return this._onLabelFontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set onLabelDisabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._onLabelFontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._onLabelFontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get onLabelSelectedFontStyles():TextFormat
		{
			return this._onLabelFontStylesSet.selectedFormat;
		}

		/**
		 * @private
		 */
		public function set onLabelSelectedFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._onLabelFontStylesSet.selectedFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._onLabelFontStylesSet.selectedFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _onLabelFactory:Function;

		/**
		 * A function used to instantiate the toggle switch's on label text
		 * renderer sub-component. The on label text renderer must be an
		 * instance of <code>ITextRenderer</code>. This factory can be used to
		 * change properties of the on label text renderer when it is first
		 * created. For instance, if you are skinning Feathers components
		 * without a theme, you might use this factory to style the on label
		 * text renderer.
		 *
		 * <p>If an <code>onLabelFactory</code> is not provided, the default
		 * <code>labelFactory</code> will be used.</p>
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():ITextRenderer</pre>
		 *
		 * <p>In the following example, the toggle switch uses a custom on label
		 * factory:</p>
		 *
		 * <listing version="3.0">
		 * toggle.onLabelFactory = function():ITextRenderer
		 * {
		 *     return new TextFieldTextRenderer();
		 * }</listing>
		 *
		 * @default null
		 *
		 * @see #labelFactory
		 * @see #offLabelFactory
		 * @see feathers.core.ITextRenderer
		 * @see feathers.core.FeathersControl#defaultTextRendererFactory
		 */
		public function get onLabelFactory():Function
		{
			return this._onLabelFactory;
		}

		/**
		 * @private
		 */
		public function set onLabelFactory(value:Function):void
		{
			if(this._onLabelFactory == value)
			{
				return;
			}
			this._onLabelFactory = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _customOnLabelStyleName:String;

		/**
		 * @private
		 */
		public function get customOnLabelStyleName():String
		{
			return this._customOnLabelStyleName;
		}

		/**
		 * @private
		 */
		public function set customOnLabelStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customOnLabelStyleName === value)
			{
				return;
			}
			this._customOnLabelStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _offLabelFontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get offLabelFontStyles():TextFormat
		{
			return this._offLabelFontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set offLabelFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._offLabelFontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._offLabelFontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get offLabelDisabledFontStyles():TextFormat
		{
			return this._offLabelFontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set offLabelDisabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._offLabelFontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._offLabelFontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get offLabelSelectedFontStyles():TextFormat
		{
			return this._offLabelFontStylesSet.selectedFormat;
		}

		/**
		 * @private
		 */
		public function set offLabelSelectedFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._offLabelFontStylesSet.selectedFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._offLabelFontStylesSet.selectedFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _offLabelFactory:Function;

		/**
		 * A function used to instantiate the toggle switch's off label text
		 * renderer sub-component. The off label text renderer must be an
		 * instance of <code>ITextRenderer</code>. This factory can be used to
		 * change properties of the off label text renderer when it is first
		 * created. For instance, if you are skinning Feathers components
		 * without a theme, you might use this factory to style the off label
		 * text renderer.
		 *
		 * <p>If an <code>offLabelFactory</code> is not provided, the default
		 * <code>labelFactory</code> will be used.</p>
		 *
		 * <p>The factory should have the following function signature:</p>
		 * <pre>function():ITextRenderer</pre>
		 *
		 * <p>In the following example, the toggle switch uses a custom on label
		 * factory:</p>
		 *
		 * <listing version="3.0">
		 * toggle.offLabelFactory = function():ITextRenderer
		 * {
		 *     return new TextFieldTextRenderer();
		 * }</listing>
		 *
		 * @default null
		 *
		 * @see #labelFactory
		 * @see #onLabelFactory
		 * @see feathers.core.ITextRenderer
		 * @see feathers.core.FeathersControl#defaultTextRendererFactory
		 */
		public function get offLabelFactory():Function
		{
			return this._offLabelFactory;
		}

		/**
		 * @private
		 */
		public function set offLabelFactory(value:Function):void
		{
			if(this._offLabelFactory == value)
			{
				return;
			}
			this._offLabelFactory = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _customOffLabelStyleName:String;

		/**
		 * @private
		 */
		public function get customOffLabelStyleName():String
		{
			return this._customOffLabelStyleName;
		}

		/**
		 * @private
		 */
		public function set customOffLabelStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customOffLabelStyleName === value)
			{
				return;
			}
			this._customOffLabelStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _onTrackSkinExplicitWidth:Number;

		/**
		 * @private
		 */
		protected var _onTrackSkinExplicitHeight:Number;

		/**
		 * @private
		 */
		protected var _onTrackSkinExplicitMinWidth:Number;

		/**
		 * @private
		 */
		protected var _onTrackSkinExplicitMinHeight:Number;

		/**
		 * @private
		 */
		protected var _offTrackSkinExplicitWidth:Number;

		/**
		 * @private
		 */
		protected var _offTrackSkinExplicitHeight:Number;

		/**
		 * @private
		 */
		protected var _offTrackSkinExplicitMinWidth:Number;

		/**
		 * @private
		 */
		protected var _offTrackSkinExplicitMinHeight:Number;

		/**
		 * @private
		 */
		protected var _isSelected:Boolean = false;

		/**
		 * Indicates if the toggle switch is selected (ON) or not (OFF).
		 *
		 * <p>In the following example, the toggle switch is selected:</p>
		 *
		 * <listing version="3.0">
		 * toggle.isSelected = true;</listing>
		 *
		 * @default false
		 *
		 * @see #setSelectionWithAnimation()
		 */
		public function get isSelected():Boolean
		{
			return this._isSelected;
		}

		/**
		 * @private
		 */
		public function set isSelected(value:Boolean):void
		{
			this._animateSelectionChange = false;
			if(this._isSelected == value)
			{
				return;
			}
			this._isSelected = value;
			this.resetState();
			this.invalidate(INVALIDATION_FLAG_SELECTED);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _toggleThumbSelection:Boolean = false;

		/**
		 * @private
		 */
		public function get toggleThumbSelection():Boolean
		{
			return this._toggleThumbSelection;
		}

		/**
		 * @private
		 */
		public function set toggleThumbSelection(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._toggleThumbSelection === value)
			{
				return;
			}
			this._toggleThumbSelection = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * @private
		 */
		protected var _toggleDuration:Number = 0.15;

		/**
		 * @private
		 */
		public function get toggleDuration():Number
		{
			return this._toggleDuration;
		}

		/**
		 * @private
		 */
		public function set toggleDuration(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._toggleDuration = value;
		}

		/**
		 * @private
		 */
		protected var _toggleEase:Object = Transitions.EASE_OUT;

		/**
		 * @private
		 */
		public function get toggleEase():Object
		{
			return this._toggleEase;
		}

		/**
		 * @private
		 */
		public function set toggleEase(value:Object):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._toggleEase = value;
		}

		/**
		 * @private
		 */
		protected var _onText:String = "ON";

		/**
		 * @private
		 */
		public function get onText():String
		{
			return this._onText;
		}

		/**
		 * @private
		 */
		public function set onText(value:String):void
		{
			if(value === null)
			{
				value = "";
			}
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._onText === value)
			{
				return;
			}
			this._onText = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _offText:String = "OFF";

		/**
		 * @private
		 */
		public function get offText():String
		{
			return this._offText;
		}

		/**
		 * @private
		 */
		public function set offText(value:String):void
		{
			if(value === null)
			{
				value = "";
			}
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._offText === value)
			{
				return;
			}
			this._offText = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _toggleTween:Tween;

		/**
		 * @private
		 */
		protected var _ignoreTapHandler:Boolean = false;

		/**
		 * @private
		 */
		protected var _touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _thumbStartX:Number;

		/**
		 * @private
		 */
		protected var _touchStartX:Number;

		/**
		 * @private
		 */
		protected var _animateSelectionChange:Boolean = false;

		/**
		 * @private
		 */
		protected var _onTrackFactory:Function;

		/**
		 * A function used to generate the toggle switch's "on" track
		 * sub-component. The "on" track must be an instance of
		 * <code>BasicButton</code> (or a subclass). This factory can be used to
		 * change properties on the "on" track when it is first created. For
		 * instance, if you are skinning Feathers components without a theme,
		 * you might use this factory to set skins and other styles on the "on"
		 * track.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():BasicButton</pre>
		 *
		 * <p>In the following example, a custom on track factory is passed to
		 * the toggle switch:</p>
		 *
		 * <listing version="3.0">
		 * toggle.onTrackFactory = function():BasicButton
		 * {
		 *     var onTrack:BasicButton = new BasicButton();
		 *     onTrack.defaultSkin = new Image( texture );
		 *     return onTrack;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 */
		public function get onTrackFactory():Function
		{
			return this._onTrackFactory;
		}

		/**
		 * @private
		 */
		public function set onTrackFactory(value:Function):void
		{
			if(this._onTrackFactory == value)
			{
				return;
			}
			this._onTrackFactory = value;
			this.invalidate(INVALIDATION_FLAG_ON_TRACK_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customOnTrackStyleName:String;

		/**
		 * @private
		 */
		public function get customOnTrackStyleName():String
		{
			return this._customOnTrackStyleName;
		}

		/**
		 * @private
		 */
		public function set customOnTrackStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customOnTrackStyleName === value)
			{
				return;
			}
			this._customOnTrackStyleName = value;
			this.invalidate(INVALIDATION_FLAG_ON_TRACK_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _onTrackProperties:PropertyProxy;

		/**
		 * An object that stores properties for the toggle switch's "on" track,
		 * and the properties will be passed down to the "on" track when the
		 * toggle switch validates. For a list of available properties,
		 * refer to <a href="BasicButton.html"><code>feathers.controls.BasicButton</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>onTrackFactory</code> function
		 * instead of using <code>onTrackProperties</code> will result in
		 * better performance.</p>
		 *
		 * <p>In the following example, the toggle switch's on track properties
		 * are updated:</p>
		 *
		 * <listing version="3.0">
		 * toggle.onTrackProperties.defaultSkin = new Image( texture );</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 * @see #onTrackFactory
		 */
		public function get onTrackProperties():Object
		{
			if(!this._onTrackProperties)
			{
				this._onTrackProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._onTrackProperties;
		}

		/**
		 * @private
		 */
		public function set onTrackProperties(value:Object):void
		{
			if(this._onTrackProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._onTrackProperties)
			{
				this._onTrackProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._onTrackProperties = PropertyProxy(value);
			if(this._onTrackProperties)
			{
				this._onTrackProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _offTrackFactory:Function;

		/**
		 * A function used to generate the toggle switch's "off" track
		 * sub-component. The "off" track must be an instance of
		 * <code>BasicButton</code> (or a subclass). This factory can be used to
		 * change properties on the "off" track when it is first created. For
		 * instance, if you are skinning Feathers components without a theme,
		 * you might use this factory to set skins and other styles on the "off"
		 * track.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():BasicButton</pre>
		 *
		 * <p>In the following example, a custom off track factory is passed to
		 * the toggle switch:</p>
		 *
		 * <listing version="3.0">
		 * toggle.offTrackFactory = function():BasicButton
		 * {
		 *     var offTrack:BasicButton = new BasicButton();
		 *     offTrack.defaultSkin = new Image( texture );
		 *     return offTrack;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 */
		public function get offTrackFactory():Function
		{
			return this._offTrackFactory;
		}

		/**
		 * @private
		 */
		public function set offTrackFactory(value:Function):void
		{
			if(this._offTrackFactory == value)
			{
				return;
			}
			this._offTrackFactory = value;
			this.invalidate(INVALIDATION_FLAG_OFF_TRACK_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customOffTrackStyleName:String;

		/**
		 * @private
		 */
		public function get customOffTrackStyleName():String
		{
			return this._customOffTrackStyleName;
		}

		/**
		 * @private
		 */
		public function set customOffTrackStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customOffTrackStyleName === value)
			{
				return;
			}
			this._customOffTrackStyleName = value;
			this.invalidate(INVALIDATION_FLAG_OFF_TRACK_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _offTrackProperties:PropertyProxy;

		/**
		 * An object that stores properties for the toggle switch's "off" track,
		 * and the properties will be passed down to the "off" track when the
		 * toggle switch validates. For a list of available properties,
		 * refer to <a href="BasicButton.html"><code>feathers.controls.BasicButton</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>offTrackFactory</code> function
		 * instead of using <code>offTrackProperties</code> will result in
		 * better performance.</p>
		 *
		 * <p>In the following example, the toggle switch's off track properties
		 * are updated:</p>
		 *
		 * <listing version="3.0">
		 * toggle.offTrackProperties.defaultSkin = new Image( texture );</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 * @see #offTrackFactory
		 */
		public function get offTrackProperties():Object
		{
			if(!this._offTrackProperties)
			{
				this._offTrackProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._offTrackProperties;
		}

		/**
		 * @private
		 */
		public function set offTrackProperties(value:Object):void
		{
			if(this._offTrackProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._offTrackProperties)
			{
				this._offTrackProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._offTrackProperties = PropertyProxy(value);
			if(this._offTrackProperties)
			{
				this._offTrackProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _thumbFactory:Function;

		/**
		 * A function used to generate the toggle switch's thumb sub-component.
		 * The thumb must be an instance of <code>BasicButton</code> (or a
		 * subclass). This factory can be used to change properties on the thumb
		 * when it is first created. For instance, if you are skinning Feathers
		 * components without a theme, you might use <code>thumbFactory</code>
		 * to set skins and other styles on the thumb.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():BasicButton</pre>
		 *
		 * <p>In the following example, a custom thumb factory is passed to the
		 * toggle switch:</p>
		 *
		 * <listing version="3.0">
		 * toggle.thumbFactory = function():BasicButton
		 * {
		 *     var button:BasicButton = new BasicButton();
		 *     button.defaultSkin = new Image( texture );
		 *     return button;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 */
		public function get thumbFactory():Function
		{
			return this._thumbFactory;
		}

		/**
		 * @private
		 */
		public function set thumbFactory(value:Function):void
		{
			if(this._thumbFactory == value)
			{
				return;
			}
			this._thumbFactory = value;
			this.invalidate(INVALIDATION_FLAG_THUMB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customThumbStyleName:String;

		/**
		 * @private
		 */
		public function get customThumbStyleName():String
		{
			return this._customThumbStyleName;
		}

		/**
		 * @private
		 */
		public function set customThumbStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customThumbStyleName === value)
			{
				return;
			}
			this._customThumbStyleName = value;
			this.invalidate(INVALIDATION_FLAG_THUMB_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _thumbProperties:PropertyProxy;

		/**
		 * An object that stores properties for the toggle switch's thumb
		 * sub-component, and the properties will be passed down to the thumb
		 * when the toggle switch validates. For a list of available properties,
		 * refer to <a href="BasicButton.html"><code>feathers.controls.BasicButton</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>thumbFactory</code> function instead
		 * of using <code>thumbProperties</code> will result in better
		 * performance.</p>
		 *
		 * <p>In the following example, the toggle switch's thumb properties
		 * are updated:</p>
		 *
		 * <listing version="3.0">
		 * toggle.thumbProperties.defaultSkin = new Image( texture );</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.BasicButton
		 * @see #thumbFactory
		 */
		public function get thumbProperties():Object
		{
			if(!this._thumbProperties)
			{
				this._thumbProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._thumbProperties;
		}

		/**
		 * @private
		 */
		public function set thumbProperties(value:Object):void
		{
			if(this._thumbProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._thumbProperties)
			{
				this._thumbProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._thumbProperties = PropertyProxy(value);
			if(this._thumbProperties)
			{
				this._thumbProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @inheritDoc
		 */
		public function get baseline():Number
		{
			if(!this.onTextRenderer)
			{
				return this.scaledActualHeight;
			}
			return this.scaleY * (this.onTextRenderer.y + this.onTextRenderer.baseline);
		}

		/**
		 * Changes the <code>isSelected</code> property, but animates the thumb
		 * to the new position, as if the user tapped the toggle switch.
		 *
		 * @see #isSelected
		 */
		public function setSelectionWithAnimation(isSelected:Boolean):void
		{
			if(this._isSelected == isSelected)
			{
				return;
			}
			this.isSelected = isSelected;
			this._animateSelectionChange = true;
		}

		/**
		 * Gets the font styles to be used to display the toggle switch's on
		 * label text when the toggle switch's <code>currentState</code>
		 * property matches the specified state value.
		 *
		 * <p>If font styles are not defined for a specific state, returns
		 * <code>null</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #setOnLabelFontStylesForState()
		 * @see #onLabelFontStyles
		 */
		public function getOnLabelFontStylesForState(state:String):TextFormat
		{
			if(this._onLabelFontStylesSet === null)
			{
				return null;
			}
			return this._onLabelFontStylesSet.getFormatForState(state);
		}

		/**
		 * Sets the font styles to be used to display the toggle switch's on
		 * label text when the toggle switch's <code>currentState</code>
		 * property matches the specified state value.
		 *
		 * <p>If font styles are not defined for a specific state, the value of
		 * the <code>onLabelFontStyles</code> property will be used instead.</p>
		 *
		 * <p>Note: if the text renderer has been customized with advanced font
		 * formatting, it may override the values specified with
		 * <code>setOnLabelFontStylesForState()</code> and properties like
		 * <code>onLabelFontStyles</code> and <code>onLabelDisabledFontStyles</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #onLabelFontStyles
		 */
		public function setOnLabelFontStylesForState(state:String, format:TextFormat):void
		{
			var key:String = "setOnLabelFontStylesForState--" + state;
			if(this.processStyleRestriction(key))
			{
				return;
			}
			function changeHandler(event:Event):void
			{
				processStyleRestriction(key);
			}
			var oldFormat:TextFormat = this._onLabelFontStylesSet.getFormatForState(state);
			if(oldFormat !== null)
			{
				oldFormat.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._onLabelFontStylesSet.setFormatForState(state, format);
			if(format !== null)
			{
				format.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * Gets the font styles to be used to display the toggle switch's off
		 * label text when the toggle switch's <code>currentState</code>
		 * property matches the specified state value.
		 *
		 * <p>If font styles are not defined for a specific state, returns
		 * <code>null</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #setOffLabelFontStylesForState()
		 * @see #offLabelFontStyles
		 */
		public function getOffLabelFontStylesForState(state:String):TextFormat
		{
			if(this._offLabelFontStylesSet === null)
			{
				return null;
			}
			return this._offLabelFontStylesSet.getFormatForState(state);
		}

		/**
		 * Sets the font styles to be used to display the toggle switch's off
		 * label text when the toggle switch's <code>currentState</code>
		 * property matches the specified state value.
		 *
		 * <p>If font styles are not defined for a specific state, the value of
		 * the <code>offLabelFontStyles</code> property will be used instead.</p>
		 *
		 * <p>Note: if the text renderer has been customized with advanced font
		 * formatting, it may override the values specified with
		 * <code>setOffLabelFontStylesForState()</code> and properties like
		 * <code>offLabelFontStyles</code> and <code>offLabelDisabledFontStyles</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #offLabelFontStyles
		 */
		public function setOffLabelFontStylesForState(state:String, format:TextFormat):void
		{
			var key:String = "setOffLabelFontStylesForState--" + state;
			if(this.processStyleRestriction(key))
			{
				return;
			}
			function changeHandler(event:Event):void
			{
				processStyleRestriction(key);
			}
			var oldFormat:TextFormat = this._offLabelFontStylesSet.getFormatForState(state);
			if(oldFormat !== null)
			{
				oldFormat.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._offLabelFontStylesSet.setFormatForState(state, format);
			if(format !== null)
			{
				format.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this._onLabelFontStylesSet !== null)
			{
				this._onLabelFontStylesSet.dispose();
				this._onLabelFontStylesSet = null;
			}
			if(this._offLabelFontStylesSet !== null)
			{
				this._offLabelFontStylesSet.dispose();
				this._offLabelFontStylesSet = null;
			}
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var selectionInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SELECTED);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var focusInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_FOCUS);
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);
			var textRendererInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_TEXT_RENDERER);
			var thumbFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_THUMB_FACTORY);
			var onTrackFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_ON_TRACK_FACTORY);
			var offTrackFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_OFF_TRACK_FACTORY);

			if(thumbFactoryInvalid)
			{
				this.createThumb();
			}

			if(onTrackFactoryInvalid)
			{
				this.createOnTrack();
			}

			if(offTrackFactoryInvalid || layoutInvalid)
			{
				this.createOffTrack();
			}

			if(textRendererInvalid)
			{
				this.createLabels();
			}

			if(textRendererInvalid || stylesInvalid || stateInvalid)
			{
				this.refreshOnLabelStyles();
				this.refreshOffLabelStyles();
			}

			if(thumbFactoryInvalid || stylesInvalid)
			{
				this.refreshThumbStyles();
			}
			if(onTrackFactoryInvalid || stylesInvalid)
			{
				this.refreshOnTrackStyles();
			}
			if((offTrackFactoryInvalid || layoutInvalid || stylesInvalid) && this.offTrack)
			{
				this.refreshOffTrackStyles();
			}

			if(stateInvalid || layoutInvalid || thumbFactoryInvalid || onTrackFactoryInvalid ||
				onTrackFactoryInvalid || textRendererInvalid)
			{
				this.refreshEnabled();
			}

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			if(sizeInvalid || stylesInvalid || selectionInvalid)
			{
				this.updateSelection();
			}

			this.layoutChildren();

			if(sizeInvalid || focusInvalid)
			{
				this.refreshFocusIndicator();
			}
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}
			var isSingle:Boolean = this._trackLayoutMode === TrackLayoutMode.SINGLE;
			if(needsWidth)
			{
				this.onTrack.width = this._onTrackSkinExplicitWidth;
			}
			else if(isSingle)
			{
				this.onTrack.width = this._explicitWidth;
			}
			if(this.onTrack is IMeasureDisplayObject)
			{
				var measureOnTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.onTrack);
				if(needsMinWidth)
				{
					measureOnTrack.minWidth = this._onTrackSkinExplicitMinWidth;
				}
				else if(isSingle)
				{
					var minTrackMinWidth:Number = this._explicitMinWidth;
					if(this._onTrackSkinExplicitMinWidth > minTrackMinWidth)
					{
						minTrackMinWidth = this._onTrackSkinExplicitMinWidth;
					}
					measureOnTrack.minWidth = minTrackMinWidth;
				}
			}
			if(!isSingle)
			{
				if(needsWidth)
				{
					this.offTrack.width = this._offTrackSkinExplicitWidth;
				}
				if(this.offTrack is IMeasureDisplayObject)
				{
					var measureOffTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.offTrack);
					if(needsMinWidth)
					{
						measureOffTrack.minWidth = this._offTrackSkinExplicitMinWidth;
					}
				}
			}
			if(this.onTrack is IValidating)
			{
				IValidating(this.onTrack).validate();
			}
			if(this.offTrack is IValidating)
			{
				IValidating(this.offTrack).validate();
			}
			if(this.thumb is IValidating)
			{
				IValidating(this.thumb).validate();
			}
			var newWidth:Number = this._explicitWidth;
			var newHeight:Number = this._explicitHeight;
			var newMinWidth:Number = this._explicitMinWidth;
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsWidth)
			{
				newWidth = this.onTrack.width;
				if(!isSingle) //split
				{
					if(this.offTrack.width > newWidth)
					{
						newWidth = this.offTrack.width;
					}
					newWidth += this.thumb.width / 2;
				}
			}
			if(needsHeight)
			{
				newHeight = this.onTrack.height;
				if(!isSingle && //split
					this.offTrack.height > newHeight)
				{
					newHeight = this.offTrack.height;
				}
				if(this.thumb.height > newHeight)
				{
					newHeight = this.thumb.height;
				}
			}
			if(needsMinWidth)
			{
				if(measureOnTrack !== null)
				{
					newMinWidth = measureOnTrack.minWidth;
				}
				else
				{
					newMinWidth = this.onTrack.width;
				}
				if(!isSingle) //split
				{
					if(measureOffTrack !== null)
					{
						if(measureOffTrack.minWidth > newMinWidth)
						{
							newMinWidth = measureOffTrack.minWidth;
						}
					}
					else if(this.offTrack.width > newMinWidth)
					{
						newMinWidth = this.offTrack.width;
					}
					if(this.thumb is IMeasureDisplayObject)
					{
						newMinWidth += IMeasureDisplayObject(this.thumb).minWidth / 2;
					}
					else
					{
						newMinWidth += this.thumb.width / 2;
					}
				}
			}
			if(needsMinHeight)
			{
				if(measureOnTrack !== null)
				{
					newMinHeight = measureOnTrack.minHeight;
				}
				else
				{
					newMinHeight = this.onTrack.height;
				}
				if(!isSingle) //split
				{
					if(measureOffTrack !== null)
					{
						if(measureOffTrack.minHeight > newMinHeight)
						{
							newMinHeight = measureOffTrack.minHeight;
						}
					}
					else if(this.offTrack.height > newMinHeight)
					{
						newMinHeight = this.offTrack.height;
					}
				}
				if(this.thumb is IMeasureDisplayObject)
				{
					var measureThumb:IMeasureDisplayObject = IMeasureDisplayObject(this.thumb);
					if(measureThumb.minHeight > newMinHeight)
					{
						newMinHeight = measureThumb.minHeight;
					}
				}
				else if(this.thumb.height > newMinHeight)
				{
					newMinHeight = this.thumb.height;
				}
			}
			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * Creates and adds the <code>thumb</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #thumb
		 * @see #thumbFactory
		 * @see #style:customThumbStyleName
		 */
		protected function createThumb():void
		{
			if(this.thumb !== null)
			{
				this.thumb.removeFromParent(true);
				this.thumb = null;
			}

			var factory:Function = this._thumbFactory != null ? this._thumbFactory : defaultThumbFactory;
			var thumbStyleName:String = this._customThumbStyleName != null ? this._customThumbStyleName : this.thumbStyleName;
			var thumb:BasicButton = BasicButton(factory());
			thumb.styleNameList.add(thumbStyleName);
			thumb.keepDownStateOnRollOut = true;
			thumb.addEventListener(TouchEvent.TOUCH, thumb_touchHandler);
			this.addChild(thumb);
			this.thumb = thumb;
		}

		/**
		 * Creates and adds the <code>onTrack</code> sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #onTrack
		 * @see #onTrackFactory
		 * @see #style:customOnTrackStyleName
		 */
		protected function createOnTrack():void
		{
			if(this.onTrack !== null)
			{
				this.onTrack.removeFromParent(true);
				this.onTrack = null;
			}

			var factory:Function = this._onTrackFactory != null ? this._onTrackFactory : defaultOnTrackFactory;
			var onTrackStyleName:String = this._customOnTrackStyleName != null ? this._customOnTrackStyleName : this.onTrackStyleName;
			var onTrack:BasicButton = BasicButton(factory());
			onTrack.styleNameList.add(onTrackStyleName);
			onTrack.keepDownStateOnRollOut = true;
			this.addChildAt(onTrack, 0);
			this.onTrack = onTrack;

			if(this.onTrack is IFeathersControl)
			{
				IFeathersControl(this.onTrack).initializeNow();
			}
			if(this.onTrack is IMeasureDisplayObject)
			{
				var measureOnTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.onTrack);
				this._onTrackSkinExplicitWidth = measureOnTrack.explicitWidth;
				this._onTrackSkinExplicitHeight = measureOnTrack.explicitHeight;
				this._onTrackSkinExplicitMinWidth = measureOnTrack.explicitMinWidth;
				this._onTrackSkinExplicitMinHeight = measureOnTrack.explicitMinHeight;
			}
			else
			{
				//this is a regular display object, and we'll treat its
				//measurements as explicit when we auto-size the toggle switch
				this._onTrackSkinExplicitWidth = this.onTrack.width;
				this._onTrackSkinExplicitHeight = this.onTrack.height;
				this._onTrackSkinExplicitMinWidth = this._onTrackSkinExplicitWidth;
				this._onTrackSkinExplicitMinHeight = this._onTrackSkinExplicitHeight;
			}
		}

		/**
		 * Creates and adds the <code>offTrack</code> sub-component and
		 * removes the old instance, if one exists. If the off track is not
		 * needed, it will not be created.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #offTrack
		 * @see #offTrackFactory
		 * @see #style:customOffTrackStyleName
		 */
		protected function createOffTrack():void
		{
			if(this.offTrack !== null)
			{
				this.offTrack.removeFromParent(true);
				this.offTrack = null;
			}
			if(this._trackLayoutMode === TrackLayoutMode.SINGLE)
			{
				return;
			}
			var factory:Function = this._offTrackFactory != null ? this._offTrackFactory : defaultOffTrackFactory;
			var offTrackStyleName:String = this._customOffTrackStyleName != null ? this._customOffTrackStyleName : this.offTrackStyleName;
			var offTrack:BasicButton = BasicButton(factory());
			offTrack.styleNameList.add(offTrackStyleName);
			offTrack.keepDownStateOnRollOut = true;
			this.addChildAt(offTrack, 1);
			this.offTrack = offTrack;

			if(this.offTrack is IFeathersControl)
			{
				IFeathersControl(this.offTrack).initializeNow();
			}
			if(this.offTrack is IMeasureDisplayObject)
			{
				var measureOffTrack:IMeasureDisplayObject = IMeasureDisplayObject(this.offTrack);
				this._offTrackSkinExplicitWidth = measureOffTrack.explicitWidth;
				this._offTrackSkinExplicitHeight = measureOffTrack.explicitHeight;
				this._offTrackSkinExplicitMinWidth = measureOffTrack.explicitMinWidth;
				this._offTrackSkinExplicitMinHeight = measureOffTrack.explicitMinHeight;
			}
			else
			{
				//this is a regular display object, and we'll treat its
				//measurements as explicit when we auto-size the toggle switch
				this._offTrackSkinExplicitWidth = this.offTrack.width;
				this._offTrackSkinExplicitHeight = this.offTrack.height;
				this._offTrackSkinExplicitMinWidth = this._offTrackSkinExplicitWidth;
				this._offTrackSkinExplicitMinHeight = this._offTrackSkinExplicitHeight;
			}
		}

		/**
		 * @private
		 */
		protected function createLabels():void
		{
			if(this.offTextRenderer)
			{
				this.removeChild(DisplayObject(this.offTextRenderer), true);
				this.offTextRenderer = null;
			}
			if(this.onTextRenderer)
			{
				this.removeChild(DisplayObject(this.onTextRenderer), true);
				this.onTextRenderer = null;
			}

			var index:int = this.getChildIndex(this.thumb);
			var offLabelFactory:Function = this._offLabelFactory;
			if(offLabelFactory == null)
			{
				offLabelFactory = this._labelFactory;
			}
			if(offLabelFactory == null)
			{
				offLabelFactory = FeathersControl.defaultTextRendererFactory;
			}
			this.offTextRenderer = ITextRenderer(offLabelFactory());
			this.offTextRenderer.stateContext = this;
			var offLabelStyleName:String = this._customOffLabelStyleName != null ? this._customOffLabelStyleName : this.offLabelStyleName;
			this.offTextRenderer.styleNameList.add(offLabelStyleName);
			var mask:Quad = new Quad(1, 1, 0xff00ff);
			//the initial dimensions cannot be 0 or there's a runtime error
			mask.width = 0;
			mask.height = 0;
			this.offTextRenderer.mask = mask;
			this.addChildAt(DisplayObject(this.offTextRenderer), index);

			var onLabelFactory:Function = this._onLabelFactory;
			if(onLabelFactory == null)
			{
				onLabelFactory = this._labelFactory;
			}
			if(onLabelFactory == null)
			{
				onLabelFactory = FeathersControl.defaultTextRendererFactory;
			}
			this.onTextRenderer = ITextRenderer(onLabelFactory());
			this.onTextRenderer.stateContext = this;
			var onLabelStyleName:String = this._customOnLabelStyleName != null ? this._customOnLabelStyleName : this.onLabelStyleName;
			this.onTextRenderer.styleNameList.add(onLabelStyleName);
			mask = new Quad(1, 1, 0xff00ff);
			//the initial dimensions cannot be 0 or there's a runtime error
			mask.width = 0;
			mask.height = 0;
			this.onTextRenderer.mask = mask;
			this.addChildAt(DisplayObject(this.onTextRenderer), index);
		}

		/**
		 * @private
		 */
		protected function changeState(state:String):void
		{
			if(this._currentState === state)
			{
				return;
			}
			this._currentState = state;
			this.invalidate(INVALIDATION_FLAG_STATE);
			this.dispatchEventWith(FeathersEventType.STATE_CHANGE);
		}

		/**
		 * @private
		 */
		protected function resetState():void
		{
			if(this._isEnabled)
			{
				if(this._isSelected)
				{
					this.changeState(ToggleState.SELECTED);
				}
				else
				{
					this.changeState(ToggleState.NOT_SELECTED);
				}
			}
			else
			{
				if(this._isSelected)
				{
					this.changeState(ToggleState.SELECTED_AND_DISABLED);
				}
				else
				{
					this.changeState(ToggleState.DISABLED);
				}
			}
		}

		/**
		 * @private
		 */
		protected function layoutChildren():void
		{
			if(this.thumb is IValidating)
			{
				IValidating(this.thumb).validate();
			}
			this.thumb.y = (this.actualHeight - this.thumb.height) / 2;

			var maxLabelWidth:Number = Math.max(0, this.actualWidth - this.thumb.width - this._paddingLeft - this._paddingRight);
			var totalLabelHeight:Number = Math.max(this.onTextRenderer.height, this.offTextRenderer.height);

			var mask:DisplayObject = this.onTextRenderer.mask;
			mask.width = maxLabelWidth;
			mask.height = totalLabelHeight;

			this.onTextRenderer.y = (this.actualHeight - totalLabelHeight) / 2;

			mask = this.offTextRenderer.mask;
			mask.width = maxLabelWidth;
			mask.height = totalLabelHeight;

			this.offTextRenderer.y = (this.actualHeight - totalLabelHeight) / 2;

			this.layoutTracks();
		}

		/**
		 * @private
		 */
		protected function layoutTracks():void
		{
			var maxLabelWidth:Number = Math.max(0, this.actualWidth - this.thumb.width - this._paddingLeft - this._paddingRight);
			var thumbOffset:Number = this.thumb.x - this._paddingLeft;

			var onScrollOffset:Number = maxLabelWidth - thumbOffset - (maxLabelWidth - this.onTextRenderer.width) / 2;
			var currentMask:DisplayObject = this.onTextRenderer.mask;
			currentMask.x = onScrollOffset;
			this.onTextRenderer.x = this._paddingLeft - onScrollOffset;

			var offScrollOffset:Number = -thumbOffset - (maxLabelWidth - this.offTextRenderer.width) / 2;
			currentMask = this.offTextRenderer.mask;
			currentMask.x = offScrollOffset;
			this.offTextRenderer.x = this.actualWidth - this._paddingRight - maxLabelWidth - offScrollOffset;

			if(this._trackLayoutMode == TrackLayoutMode.SPLIT)
			{
				this.layoutTrackWithOnOff();
			}
			else
			{
				this.layoutTrackWithSingle();
			}
		}

		/**
		 * @private
		 */
		protected function updateSelection():void
		{
			if(this.thumb is IToggle)
			{
				var toggleThumb:IToggle = IToggle(this.thumb);
				if(this._toggleThumbSelection)
				{
					toggleThumb.isSelected = this._isSelected;
				}
				else
				{
					toggleThumb.isSelected = false;
				}
			}
			if(this.thumb is IValidating)
			{
				IValidating(this.thumb).validate();
			}

			var xPosition:Number = this._paddingLeft;
			if(this._isSelected)
			{
				xPosition = this.actualWidth - this.thumb.width - this._paddingRight;
			}

			//stop the tween, no matter what
			if(this._toggleTween)
			{
				Starling.juggler.remove(this._toggleTween);
				this._toggleTween = null;
			}

			if(this._animateSelectionChange)
			{
				this._toggleTween = new Tween(this.thumb, this._toggleDuration, this._toggleEase);
				this._toggleTween.animate("x", xPosition);
				this._toggleTween.onUpdate = selectionTween_onUpdate;
				this._toggleTween.onComplete = selectionTween_onComplete;
				Starling.juggler.add(this._toggleTween);
			}
			else
			{
				this.thumb.x = xPosition;
			}
			this._animateSelectionChange = false;
		}

		/**
		 * @private
		 */
		protected function refreshOnLabelStyles():void
		{
			//no need to style the label field if there's no text to display
			if(!this._showLabels || !this._showThumb)
			{
				this.onTextRenderer.visible = false;
				return;
			}

			this.onTextRenderer.fontStyles = this._onLabelFontStylesSet;
			var properties:PropertyProxy;
			if(!this._isEnabled)
			{
				properties = this._disabledLabelProperties;
			}
			if(!properties && this._onLabelProperties)
			{
				properties = this._onLabelProperties;
			}
			if(!properties)
			{
				properties = this._defaultLabelProperties;
			}

			this.onTextRenderer.text = this._onText;
			if(properties)
			{
				var displayRenderer:DisplayObject = DisplayObject(this.onTextRenderer);
				for(var propertyName:String in properties)
				{
					var propertyValue:Object = properties[propertyName];
					displayRenderer[propertyName] = propertyValue;
				}
			}
			this.onTextRenderer.validate();
			this.onTextRenderer.visible = true;
		}

		/**
		 * @private
		 */
		protected function refreshOffLabelStyles():void
		{
			//no need to style the label field if there's no text to display
			if(!this._showLabels || !this._showThumb)
			{
				this.offTextRenderer.visible = false;
				return;
			}

			this.offTextRenderer.fontStyles = this._offLabelFontStylesSet;
			var properties:PropertyProxy;
			if(!this._isEnabled)
			{
				properties = this._disabledLabelProperties;
			}
			if(!properties && this._offLabelProperties)
			{
				properties = this._offLabelProperties;
			}
			if(!properties)
			{
				properties = this._defaultLabelProperties;
			}

			this.offTextRenderer.text = this._offText;
			if(properties)
			{
				var displayRenderer:DisplayObject = DisplayObject(this.offTextRenderer);
				for(var propertyName:String in properties)
				{
					var propertyValue:Object = properties[propertyName];
					displayRenderer[propertyName] = propertyValue;
				}
			}
			this.offTextRenderer.validate();
			this.offTextRenderer.visible = true;
		}

		/**
		 * @private
		 */
		protected function refreshThumbStyles():void
		{
			for(var propertyName:String in this._thumbProperties)
			{
				var propertyValue:Object = this._thumbProperties[propertyName];
				this.thumb[propertyName] = propertyValue;
			}
			this.thumb.visible = this._showThumb;
		}

		/**
		 * @private
		 */
		protected function refreshOnTrackStyles():void
		{
			for(var propertyName:String in this._onTrackProperties)
			{
				var propertyValue:Object = this._onTrackProperties[propertyName];
				this.onTrack[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function refreshOffTrackStyles():void
		{
			if(!this.offTrack)
			{
				return;
			}
			for(var propertyName:String in this._offTrackProperties)
			{
				var propertyValue:Object = this._offTrackProperties[propertyName];
				this.offTrack[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function refreshEnabled():void
		{
			if(this.thumb is IFeathersControl)
			{
				IFeathersControl(this.thumb).isEnabled = this._isEnabled;
			}
			if(this.onTrack is IFeathersControl)
			{
				IFeathersControl(this.onTrack).isEnabled = this._isEnabled;
			}
			if(this.offTrack is IFeathersControl)
			{
				IFeathersControl(this.offTrack).isEnabled = this._isEnabled;
			}
			this.onTextRenderer.isEnabled = this._isEnabled;
			this.offTextRenderer.isEnabled = this._isEnabled;
		}

		/**
		 * @private
		 */
		protected function layoutTrackWithOnOff():void
		{
			var onTrackWidth:Number = Math.round(this.thumb.x + (this.thumb.width / 2));
			this.onTrack.x = 0;
			this.onTrack.width = onTrackWidth;
			this.offTrack.x = onTrackWidth;
			this.offTrack.width = this.actualWidth - onTrackWidth;
			if(this._trackScaleMode === TrackScaleMode.EXACT_FIT)
			{
				this.onTrack.y = 0;
				this.onTrack.height = this.actualHeight;

				this.offTrack.y = 0;
				this.offTrack.height = this.actualHeight;
			}

			//final validation to avoid juggler next frame issues
			if(this.onTrack is IValidating)
			{
				IValidating(this.onTrack).validate();
			}
			if(this.offTrack is IValidating)
			{
				IValidating(this.offTrack).validate();
			}

			if(this._trackScaleMode === TrackScaleMode.DIRECTIONAL)
			{
				this.onTrack.y = Math.round((this.actualHeight - this.onTrack.height) / 2);
				this.offTrack.y = Math.round((this.actualHeight - this.offTrack.height) / 2);
			}
		}

		/**
		 * @private
		 */
		protected function layoutTrackWithSingle():void
		{
			this.onTrack.x = 0;
			this.onTrack.width = this.actualWidth;
			if(this._trackScaleMode === TrackScaleMode.EXACT_FIT)
			{
				this.onTrack.y = 0;
				this.onTrack.height = this.actualHeight;
			}
			else
			{
				//we'll calculate y after validation in case the track needs
				//to auto-size
				this.onTrack.height = this._onTrackSkinExplicitHeight;
			}

			//final validation to avoid juggler next frame issues
			if(this.onTrack is IValidating)
			{
				IValidating(this.onTrack).validate();
			}

			if(this._trackScaleMode === TrackScaleMode.DIRECTIONAL)
			{
				this.onTrack.y = Math.round((this.actualHeight - this.onTrack.height) / 2);
			}
		}

		/**
		 * @private
		 */
		protected function childProperties_onChange(proxy:PropertyProxy, name:Object):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function toggleSwitch_removedFromStageHandler(event:Event):void
		{
			this._touchPointID = -1;
		}

		/**
		 * @private
		 */
		override protected function focusInHandler(event:Event):void
		{
			super.focusInHandler(event);
			this.stage.addEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
			this.stage.addEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
		}

		/**
		 * @private
		 */
		override protected function focusOutHandler(event:Event):void
		{
			super.focusOutHandler(event);
			this.stage.removeEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
			this.stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
		}

		/**
		 * @private
		 */
		protected function toggleSwitch_touchHandler(event:TouchEvent):void
		{
			if(this._ignoreTapHandler)
			{
				this._ignoreTapHandler = false;
				return;
			}
			if(!this._isEnabled)
			{
				this._touchPointID = -1;
				return;
			}

			var touch:Touch = event.getTouch(this, TouchPhase.ENDED);
			if(!touch)
			{
				return;
			}
			this._touchPointID = -1;
			touch.getLocation(this.stage, HELPER_POINT);
			var isInBounds:Boolean = this.contains(this.stage.hitTest(HELPER_POINT));
			if(isInBounds)
			{
				this.setSelectionWithAnimation(!this._isSelected);
			}
		}

		/**
		 * @private
		 */
		protected function thumb_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._touchPointID = -1;
				return;
			}

			if(this._touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this.thumb, null, this._touchPointID);
				if(!touch)
				{
					return;
				}
				touch.getLocation(this, HELPER_POINT);
				var trackScrollableWidth:Number = this.actualWidth - this._paddingLeft - this._paddingRight - this.thumb.width;
				if(touch.phase == TouchPhase.MOVED)
				{
					var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
					var claim:DisplayObject = exclusiveTouch.getClaim(this._touchPointID);
					if(claim !== this)
					{
						if(claim)
						{
							//already claimed by another display object
							return;
						}
						else
						{
							exclusiveTouch.claimTouch(this._touchPointID, this);
						}
					}
					var xOffset:Number = HELPER_POINT.x - this._touchStartX;
					var xPosition:Number = Math.min(Math.max(this._paddingLeft, this._thumbStartX + xOffset), this._paddingLeft + trackScrollableWidth);
					this.thumb.x = xPosition;
					this.layoutTracks();
				}
				else if(touch.phase == TouchPhase.ENDED)
				{
					var pixelsMoved:Number = Math.abs(HELPER_POINT.x - this._touchStartX);
					var inchesMoved:Number = pixelsMoved / DeviceCapabilities.dpi;
					if(inchesMoved > MINIMUM_DRAG_DISTANCE || (SystemUtil.isDesktop && pixelsMoved >= 1))
					{
						this._touchPointID = -1;
						this._ignoreTapHandler = true;
						this.setSelectionWithAnimation(this.thumb.x > (this._paddingLeft + trackScrollableWidth / 2));
						//we still need to invalidate, even if there's no change
						//because the thumb may be in the middle!
						this.invalidate(INVALIDATION_FLAG_SELECTED);
					}
				}
			}
			else
			{
				touch = event.getTouch(this.thumb, TouchPhase.BEGAN);
				if(!touch)
				{
					return;
				}
				touch.getLocation(this, HELPER_POINT);
				this._touchPointID = touch.id;
				this._thumbStartX = this.thumb.x;
				this._touchStartX = HELPER_POINT.x;
			}
		}

		/**
		 * @private
		 */
		protected function stage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.keyCode == Keyboard.ESCAPE)
			{
				this._touchPointID = -1;
			}
			if(this._touchPointID != -1 || !(event.keyCode == Keyboard.SPACE || (event.keyCode == Keyboard.ENTER && (event.keyLocation == KeyLocation.D_PAD || DeviceCapabilities.simulateDPad))))
			{
				return;
			}
			this._touchPointID = int.MAX_VALUE;
		}

		/**
		 * @private
		 */
		protected function stage_keyUpHandler(event:KeyboardEvent):void
		{
			if(this._touchPointID != int.MAX_VALUE || !(event.keyCode == Keyboard.SPACE || (event.keyCode == Keyboard.ENTER && (event.keyLocation == KeyLocation.D_PAD || DeviceCapabilities.simulateDPad))))
			{
				return;
			}
			this._touchPointID = -1;
			this.setSelectionWithAnimation(!this._isSelected);
		}

		/**
		 * @private
		 */
		protected function selectionTween_onUpdate():void
		{
			this.layoutTracks();
		}

		/**
		 * @private
		 */
		protected function selectionTween_onComplete():void
		{
			this._toggleTween = null;
		}

		/**
		 * @private
		 */
		protected function fontStyles_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}
	}
}

================================================
FILE: source/feathers/controls/TrackInteractionMode.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * Interaction modes for components with a track.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class TrackInteractionMode
	{
		/**
		 * When the track is touched, the slider's thumb jumps directly to the
		 * touch position, and the slider's <code>value</code> property is
		 * updated to match as if the thumb were dragged to that position, and
		 * the thumb may continue to be dragged until the touch ends.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const TO_VALUE:String = "toValue";

		/**
		 * When the track is touched, the <code>value</code> is increased or
		 * decreased (depending on the location of the touch) by the value of
		 * the <code>page</code> property.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const BY_PAGE:String = "byPage";
	}
}


================================================
FILE: source/feathers/controls/TrackLayoutMode.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * Layout modes for components with a thumb that is dragged along a track.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class TrackLayoutMode
	{
		/**
		 * The component has only one track, that fills its full length.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const SINGLE:String = "single";

		/**
		 * The component has multiple tracks, meeting in the middle of the thumb
		 * and filling the available space on each side. The tracks will be
		 * resized as the thumb moves.
		 *
		 * <p>This track layout mode is designed for components where the track
		 * on different sides of the thumb may be colored differently to show
		 * the value "filling up" as the thumb is dragged.</p>
		 *
		 * <p>Since the tracks will be resized when the thumb is dragged,
		 * consider using a display object that is capable of resizing without
		 * distortion, such as an <code>Image</code> with a
		 * <code>scale9Grid</code> or a <code>tileGrid</code>.</p>
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const SPLIT:String = "split";
	}
}


================================================
FILE: source/feathers/controls/TrackScaleMode.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	/**
	 * How the track is sized perpendicular to the direction it is dragged.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class TrackScaleMode
	{
		/**
		 * The track dimensions fill the full width and height of the component.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const EXACT_FIT:String = "exactFit";

		/**
		 * If the component's direction is horizontal, the width of the track
		 * will fill the full width of the component, and if the component's
		 * direction is vertical, the height of the track will fill the full
		 * height of the component. The other edge will not be scaled, and its
		 * preferred size will be used instead.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const DIRECTIONAL:String = "directional";
	}
}


================================================
FILE: source/feathers/controls/Tree.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.controls.Scroller;
	import feathers.controls.renderers.DefaultTreeItemRenderer;
	import feathers.controls.renderers.ITreeItemRenderer;
	import feathers.controls.supportClasses.TreeDataViewPort;
	import feathers.data.ArrayCollection;
	import feathers.data.IHierarchicalCollection;
	import feathers.events.CollectionEventType;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.ILayout;
	import feathers.layout.IVariableVirtualLayout;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.skins.IStyleProvider;
	import feathers.system.DeviceCapabilities;

	import flash.events.KeyboardEvent;
	import flash.geom.Point;
	import flash.ui.Keyboard;

	import starling.events.Event;
	import starling.utils.Pool;

	/**
	 * A style name to add to all item renderers in this tree. Typically
	 * used by a theme to provide different styles to different trees.
	 *
	 * <p>The following example sets the item renderer style name:</p>
	 *
	 * <listing version="3.0">
	 * tree.customItemRendererStyleName = "my-custom-item-renderer";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different skins than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( DefaultTreeItemRenderer ).setFunctionForStyleName( "my-custom-item-renderer", setCustomItemRendererStyles );</listing>
	 *
	 * @default null
	 *
	 * @see feathers.core.FeathersControl#styleNameList
	 */
	[Style(name="customItemRendererStyleName",type="String")]

	/**
	 * The duration, in seconds, of the animation when the selected item is
	 * changed by keyboard navigation and the item scrolls into view.
	 *
	 * <p>In the following example, the duration of the animation that
	 * scrolls the tree to a new selected item is set to 500 milliseconds:</p>
	 *
	 * <listing version="3.0">
	 * tree.keyScrollDuration = 0.5;</listing>
	 *
	 * @default 0.25
	 */
	[Style(name="keyScrollDuration",type="Number")]

	/**
	 * The layout algorithm used to position and, optionally, size the
	 * tree's items.
	 *
	 * <p>By default, if no layout is provided by the time that the tree
	 * initializes, a vertical layout with options targeted at touch screens
	 * is created.</p>
	 *
	 * <p>The following example tells the tree to use a horizontal layout:</p>
	 *
	 * <listing version="3.0">
	 * var layout:HorizontalLayout = new HorizontalLayout();
	 * layout.gap = 20;
	 * layout.padding = 20;
	 * tree.layout = layout;</listing>
	 */
	[Style(name="layout",type="feathers.layout.ILayout")]

	/**
	 * Dispatched when the selected item changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #selectedItem
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the the user taps or clicks an item renderer in the tree.
	 * The touch must remain within the bounds of the item renderer on release,
	 * and the tree must not have scrolled, to register as a tap or a click.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The item associated with the item
	 *   renderer that was triggered.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.TRIGGERED
	 */
	[Event(name="triggered",type="starling.events.Event")]

	/**
	 * Dispatched when an item renderer is added to the tree. When the layout is
	 * virtualized, item renderers may not exist for every item in the data
	 * provider. This event can be used to track which items currently have
	 * renderers.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The item renderer that was added</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.RENDERER_ADD
	 */
	[Event(name="rendererAdd",type="starling.events.Event")]

	/**
	 * Dispatched when an item renderer is removed from the tree. When the layout is
	 * virtualized, item renderers may not exist for every item in the data
	 * provider. This event can be used to track which items currently have
	 * renderers.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The item renderer that was removed</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.RENDERER_REMOVE
	 */
	[Event(name="rendererRemove",type="starling.events.Event")]

	/**
	 * Dispatched when a branch is opened.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The data for the branch that was opened</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.OPEN
	 *
	 * @see #event:close starling.events.Event.CLOSE
	 * @see #isBranchOpen()
	 * @see #toggleBranch()
	 */
	[Event(name="open",type="starling.events.Event")]

	/**
	 * Dispatched when a branch is closed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The data for the branch that was closed</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CLOSE
	 *
	 * @see #event:open starling.events.Event.OPEN
	 * @see #isBranchOpen()
	 * @see #toggleBranch()
	 */
	[Event(name="close",type="starling.events.Event")]

	/**
	 * Displays a hierarchical tree of items. Supports scrolling, custom item
	 * renderers, and custom layouts.
	 *
	 * <p>The following example creates a tree, gives it a data provider, and
	 * tells the item renderer how to interpret the data:</p>
	 *
	 * <listing version="3.0">
	 * var tree:Tree = new Tree();
	 * 
	 * tree.dataProvider = new ArrayHierarchicalCollection(
	 * [
	 *     {
	 *         text: "Node 1",
	 *         children:
	 *         [
	 *             {
	 *                 text: "Node 1A",
	 *                 children:
	 *                 [
	 *                     { text: "Node 1A-I" },
	 *                     { text: "Node 1A-II" },
	 *                 ]
	 *             },
	 *             { text: "Node 1B" },
	 *         ]
	 *     },
	 *     { text: "Node 2" },
	 *     {
	 *         text: "Node 3",
	 *         children:
	 *         [
	 *             { text: "Node 3A" },
	 *             { text: "Node 3B" },
	 *             { text: "Node 3C" },
	 *         ]
	 *     }
	 * ]);
	 * 
	 * tree.itemRendererFactory = function():ITreeItemRenderer
	 * {
	 *     var itemRenderer:DefaultTreeItemRenderer = new DefaultTreeItemRenderer();
	 *     itemRenderer.labelField = "text";
	 *     return itemRenderer;
	 * };
	 * 
	 * this.addChild( tree );</listing>
	 *
	 * @see ../../../help/tree.html How to use the Feathers Tree component
	 * @see ../../../help/default-item-renderers.html How to use the Feathers default item renderer
	 * @see ../../../help/item-renderers.html Creating custom item renderers for the Feathers Tree component
	 *
	 * @productversion Feathers 3.3.0
	 */
	public class Tree extends Scroller
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>Tree</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor
		 */
		public function Tree()
		{
			super();
		}

		/**
		 * @private
		 * The guts of the Tree's functionality. Handles layout and selection.
		 */
		protected var dataViewPort:TreeDataViewPort;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return Tree.globalStyleProvider;
		}

		/**
		 * @private
		 */
		override public function get isFocusEnabled():Boolean
		{
			return (this._isSelectable || this._minHorizontalScrollPosition != this._maxHorizontalScrollPosition ||
				this._minVerticalScrollPosition != this._maxVerticalScrollPosition) &&
				this._isEnabled && this._isFocusEnabled;
		}

		/**
		 * @private
		 */
		protected var _dataProvider:IHierarchicalCollection = null;

		/**
		 * The collection of data displayed by the tree. Changing this property
		 * to a new value is considered a drastic change to the tree's data, so
		 * the horizontal and vertical scroll positions will be reset, and the
		 * tree's selection will be cleared.
		 *
		 * <p>The following example passes in a data provider and tells the item
		 * renderer how to interpret the data:</p>
		 *
		 * <listing version="3.0">
		 * tree.dataProvider = new ArrayHierarchicalCollection(
		 * [
		 *     {
		 *         text: "Node 1",
		 *         children:
		 *         [
		 *             {
		 *                 text: "Node 1A",
		 *                 children:
		 *                 [
		 *                     { text: "Node 1A-I" },
		 *                     { text: "Node 1A-II" },
		 *                 ]
		 *             },
		 *             { text: "Node 1B" },
		 *         ]
		 *     },
		 *     { text: "Node 2" },
		 *     {
		 *         text: "Node 3",
		 *         children:
		 *         [
		 *             { text: "Node 3A" },
		 *             { text: "Node 3B" },
		 *             { text: "Node 3C" },
		 *         ]
		 *     }
		 * ]);
		 * 
		 * tree.itemRendererFactory = function():ITreeItemRenderer
		 * {
		 *     var itemRenderer:DefaultTreeItemRenderer = new DefaultTreeItemRenderer();
		 *     itemRenderer.labelField = "text";
		 *     return itemRenderer;
		 * };</listing>
		 *
		 * <p><em>Warning:</em> A tree's data provider cannot contain duplicate
		 * items. To display the same item in multiple item renderers, you must
		 * create separate objects with the same properties. This restriction
		 * exists because it significantly improves performance.</p>
		 *
		 * <p><em>Warning:</em> If the data provider contains display objects,
		 * concrete textures, or anything that needs to be disposed, those
		 * objects will not be automatically disposed when the list is disposed.
		 * Similar to how <code>starling.display.Image</code> cannot
		 * automatically dispose its texture because the texture may be used
		 * by other display objects, a list cannot dispose its data provider
		 * because the data provider may be used by other lists. See the
		 * <code>dispose()</code> function on <code>IHierarchicalCollection</code> to
		 * see how the data provider can be disposed properly.</p>
		 *
		 * @default null
		 *
		 * @see feathers.data.IHierarchicalCollection#dispose()
		 * @see feathers.data.ArrayHierarchicalCollection
		 * @see feathers.data.VectorHierarchicalCollection
		 * @see feathers.data.XMLListHierarchicalCollection
		 */
		public function get dataProvider():IHierarchicalCollection
		{
			return this._dataProvider;
		}

		/**
		 * @private
		 */
		public function set dataProvider(value:IHierarchicalCollection):void
		{
			if(this._dataProvider === value)
			{
				return;
			}
			if(this._dataProvider !== null)
			{
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ALL, dataProvider_removeAllHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.removeEventListener(Event.CHANGE, dataProvider_changeHandler);
			}
			this._dataProvider = value;
			if(this._dataProvider !== null)
			{
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ALL, dataProvider_removeAllHandler);
				this._dataProvider.addEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.addEventListener(Event.CHANGE, dataProvider_changeHandler);
			}

			//reset the scroll position because this is a drastic change and
			//the data is probably completely different
			this.horizontalScrollPosition = 0;
			this.verticalScrollPosition = 0;

			//clear the selection for the same reason
			this.selectedItem = null;

			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _isSelectable:Boolean = true;

		/**
		 * Determines if an item in the tree may be selected.
		 *
		 * <p>The following example disables selection:</p>
		 *
		 * <listing version="3.0">
		 * tree.isSelectable = false;</listing>
		 *
		 * @default true
		 *
		 * @see #selectedItem
		 */
		public function get isSelectable():Boolean
		{
			return this._isSelectable;
		}

		/**
		 * @private
		 */
		public function set isSelectable(value:Boolean):void
		{
			if(this._isSelectable === value)
			{
				return;
			}
			this._isSelectable = value;
			if(!this._isSelectable)
			{
				this.selectedItem = null;
			}
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * @private
		 */
		protected var _helperLocation:Vector.<int> = new <int>[];

		/**
		 * The currently selected location. Returns an empty
		 * <code>Vector.&lt;int&gt;</code> if no item is selected.
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected location:</p>
		 *
		 * <listing version="3.0">
		 * function tree_changeHandler( event:Event ):void
		 * {
		 *     var tree:Tree = Tree( event.currentTarget );
		 *     var location:Vector.&lt;int&gt; = tree.selectedLocation;
		 * 
		 * }
		 * tree.addEventListener( Event.CHANGE, tree_changeHandler );</listing>
		 *
		 * <p>Alternatively, you may use the <code>getSelectedLocation()</code>
		 * method to get the selected location without creating a new
		 * <code>Vector.&lt;int&gt;</code> instance, to avoid garbage
		 * collection of temporary objects.</p>
		 *
		 * @see #getSelectedLocation()
		 */
		public function get selectedLocation():Vector.<int>
		{
			return this.getSelectedLocation();
		}

		/**
		 * @private
		 */
		public function set selectedLocation(value:Vector.<int>):void
		{
			var item:Object = this._dataProvider.getItemAtLocation(value);
			this.selectedItem = item;
		}

		/**
		 * @private
		 */
		protected var _selectedItem:Object = null;

		/**
		 * The currently selected item. Returns <code>null</code> if no item is
		 * selected.
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected item:</p>
		 *
		 * <listing version="3.0">
		 * function tree_changeHandler( event:Event ):void
		 * {
		 *     var tree:Tree = Tree( event.currentTarget );
		 *     var item:Object = tree.selectedItem;
		 * 
		 * }
		 * tree.addEventListener( Event.CHANGE, tree_changeHandler );</listing>
		 *
		 * @default null
		 */
		public function get selectedItem():Object
		{
			return this._selectedItem;
		}

		/**
		 * @private
		 */
		public function set selectedItem(value:Object):void
		{
			if(this._selectedItem === value)
			{
				return;
			}
			if(this._dataProvider === null)
			{
				value = null;
			}
			if(value !== null)
			{
				var result:Vector.<int> = this._dataProvider.getItemLocation(value, this._helperLocation);
				if(result === null || result.length == 0)
				{
					value = null;
				}
			}
			if(this._selectedItem === value)
			{
				return;
			}
			this._selectedItem = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _layout:ILayout;

		/**
		 * @private
		 */
		public function get layout():ILayout
		{
			return this._layout;
		}

		/**
		 * @private
		 */
		public function set layout(value:ILayout):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._layout === value)
			{
				return;
			}
			if(this._layout !== null)
			{
				this._layout.removeEventListener(Event.SCROLL, layout_scrollHandler);
			}
			this._layout = value;
			if(this._layout is IVariableVirtualLayout)
			{
				this._layout.addEventListener(Event.SCROLL, layout_scrollHandler);
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * @private
		 */
		protected var _itemRendererType:Class = DefaultTreeItemRenderer;

		/**
		 * The class used to instantiate item renderers. Must implement the
		 * <code>ITreeItemRenderer</code> interface.
		 *
		 * <p>To customize properties on the item renderer, use
		 * <code>itemRendererFactory</code> instead.</p>
		 *
		 * <p>The following example changes the item renderer type:</p>
		 *
		 * <listing version="3.0">
		 * tree.itemRendererType = CustomItemRendererClass;</listing>
		 *
		 * @default feathers.controls.renderers.DefaultTreeItemRenderer
		 *
		 * @see feathers.controls.renderers.ITreeItemRenderer
		 * @see #itemRendererFactory
		 */
		public function get itemRendererType():Class
		{
			return this._itemRendererType;
		}

		/**
		 * @private
		 */
		public function set itemRendererType(value:Class):void
		{
			if(this._itemRendererType === value)
			{
				return;
			}

			this._itemRendererType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _itemRendererFactories:Object;

		/**
		 * @private
		 */
		protected var _itemRendererFactory:Function;

		/**
		 * A function called that is expected to return a new item renderer. Has
		 * a higher priority than <code>itemRendererType</code>. Typically, you
		 * would use an <code>itemRendererFactory</code> instead of an
		 * <code>itemRendererType</code> if you wanted to initialize some
		 * properties on each separate item renderer, such as skins.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 *
		 * <pre>function():ITreeItemRenderer</pre>
		 *
		 * <p>The following example provides a factory for the item renderer:</p>
		 *
		 * <listing version="3.0">
		 * tree.itemRendererFactory = function():ITreeItemRenderer
		 * {
		 *     var renderer:CustomItemRendererClass = new CustomItemRendererClass();
		 *     renderer.backgroundSkin = new Quad( 10, 10, 0xff0000 );
		 *     return renderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.renderers.ITreeItemRenderer
		 * @see #itemRendererType
		 * @see #setItemRendererFactoryWithID()
		 */
		public function get itemRendererFactory():Function
		{
			return this._itemRendererFactory;
		}

		/**
		 * @private
		 */
		public function set itemRendererFactory(value:Function):void
		{
			if(this._itemRendererFactory === value)
			{
				return;
			}

			this._itemRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _factoryIDFunction:Function;

		/**
		 * When a tree requires multiple item renderer types, this function is
		 * used to determine which type of item renderer is required for a
		 * specific item (or index). Returns the ID of the item renderer type
		 * to use for the item, or <code>null</code> if the default
		 * <code>itemRendererFactory</code> should be used.
		 *
		 * <p>The function is expected to have one of the following
		 * signatures:</p>
		 *
		 * <pre>function(item:Object):String</pre>
		 *
		 * <pre>function(item:Object, location:Vector.&lt;int&gt;):String</pre>
		 *
		 * <p>The following example provides a <code>factoryIDFunction</code>:</p>
		 *
		 * <listing version="3.0">
		 * function regularItemFactory():ITreeItemRenderer
		 * {
		 *     return new DefaultTreeItemRenderer();
		 * }
		 * function firstItemFactory():ITreeItemRenderer
		 * {
		 *     return new CustomItemRenderer();
		 * }
		 * tree.setItemRendererFactoryWithID( "regular-item", regularItemFactory );
		 * tree.setItemRendererFactoryWithID( "first-item", firstItemFactory );
		 * 
		 * tree.factoryIDFunction = function( item:Object, location:Vector.&lt;int&gt; ):String
		 * {
		 *     if(location.length == 1 &amp;&amp; location[0] == 0)
		 *     {
		 *         return "first-item";
		 *     }
		 *     return "regular-item";
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #setItemRendererFactoryWithID()
		 * @see #itemRendererFactory
		 */
		public function get factoryIDFunction():Function
		{
			return this._factoryIDFunction;
		}

		/**
		 * @private
		 */
		public function set factoryIDFunction(value:Function):void
		{
			if(this._factoryIDFunction === value)
			{
				return;
			}
			this._factoryIDFunction = value;
			if(value !== null && this._itemRendererFactories === null)
			{
				this._itemRendererFactories = {};
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _typicalItem:Object = null;

		/**
		 * Used to auto-size the tree when a virtualized layout is used. If the
		 * tree's width or height is unknown, the tree will try to automatically
		 * pick an ideal size. This item is used to create a sample item
		 * renderer to measure item renderers that are virtual and not visible
		 * in the viewport.
		 *
		 * <p>The following example provides a typical item:</p>
		 *
		 * <listing version="3.0">
		 * tree.typicalItem = { text: "A typical item", thumbnail: texture };</listing>
		 *
		 * @default null
		 */
		public function get typicalItem():Object
		{
			return this._typicalItem;
		}

		/**
		 * @private
		 */
		public function set typicalItem(value:Object):void
		{
			if(this._typicalItem === value)
			{
				return;
			}
			this._typicalItem = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _customItemRendererStyleName:String;

		/**
		 * @private
		 */
		public function get customItemRendererStyleName():String
		{
			return this._customItemRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customItemRendererStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customItemRendererStyleName === value)
			{
				return;
			}
			this._customItemRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _keyScrollDuration:Number = 0.25;

		/**
		 * @private
		 */
		public function get keyScrollDuration():Number
		{
			return this._keyScrollDuration;
		}

		/**
		 * @private
		 */
		public function set keyScrollDuration(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._keyScrollDuration == value)
			{
				return;
			}
			this._keyScrollDuration = value;
		}

		/**
		 * @private
		 */
		protected var pendingLocation:Vector.<int> = null;

		/**
		 * @private
		 */
		override public function dispose():void
		{
			//clearing selection now so that the data provider setter won't
			//cause a selection change that triggers events.
			this._selectedItem = null;
			this.dataProvider = null;
			this.layout = null;
			super.dispose();
		}

		/**
		 * Returns the item renderer factory associated with a specific ID.
		 * Returns <code>null</code> if no factory is associated with the ID.
		 *
		 * @see #setItemRendererFactoryWithID()
		 */
		public function getItemRendererFactoryWithID(id:String):Function
		{
			if(this._itemRendererFactories && (id in this._itemRendererFactories))
			{
				return this._itemRendererFactories[id] as Function;
			}
			return null;
		}

		/**
		 * Associates an item renderer factory with an ID to allow multiple
		 * types of item renderers may be displayed in the tree. A custom
		 * <code>factoryIDFunction</code> may be specified to return the ID of
		 * the factory to use for a specific item in the data provider.
		 *
		 * @see #factoryIDFunction
		 * @see #getItemRendererFactoryWithID()
		 */
		public function setItemRendererFactoryWithID(id:String, factory:Function):void
		{
			if(id === null)
			{
				this.itemRendererFactory = factory;
				return;
			}
			if(this._itemRendererFactories === null)
			{
				this._itemRendererFactories = {};
			}
			if(factory !== null)
			{
				this._itemRendererFactories[id] = factory;
			}
			else
			{
				delete this._itemRendererFactories[id];
			}
		}

		/**
		 * Returns the current item renderer used to render a specific item. May
		 * return <code>null</code> if an item doesn't currently have an item
		 * renderer. Most trees use virtual layouts where only the visible items
		 * will have an item renderer, so the result will usually be
		 * <code>null</code> for most items in the data provider.
		 *
		 * @see ../../../help/faq/layout-virtualization.html What is layout virtualization?
		 */
		public function itemToItemRenderer(item:Object):ITreeItemRenderer
		{
			return this.dataViewPort.itemToItemRenderer(item);
		}

		/**
		 * @private
		 */
		protected var _openBranches:ArrayCollection = new ArrayCollection();

		/**
		 * Opens or closes a branch.
		 *
		 * @see #isBranchOpen()
		 * @see #event:open starling.events.Event.OPEN
		 * @see #event:close starling.events.Event.CLOSE
		 */
		public function toggleBranch(branch:Object, open:Boolean):void
		{
			if(this._dataProvider === null || !this._dataProvider.isBranch(branch))
			{
				throw new ArgumentError("toggleBranch() may not open an item that is not a branch.");
			}
			var index:int = this._openBranches.getItemIndex(branch);
			if(open)
			{
				if(index != -1)
				{
					//the branch is already open
					return;
				}
				this._openBranches.addItem(branch);
				this.dispatchEventWith(Event.OPEN, false, branch);
			}
			else //close
			{
				if(index == -1)
				{
					//the branch is already closed
					return;
				}
				this._openBranches.removeItem(branch);
				this.dispatchEventWith(Event.CLOSE, false, branch);
			}
		}

		/**
		 * Indicates if a branch from the data provider is open or closed.
		 *
		 * @see #toggleBranch()
		 * @see #event:open starling.events.Event.OPEN
		 * @see #event:close starling.events.Event.CLOSE
		 */
		public function isBranchOpen(branch:Object):Boolean
		{
			if(this._dataProvider === null || !this._dataProvider.isBranch(branch))
			{
				return false;
			}
			return this._openBranches.getItemIndex(branch) != -1;
		}

		/**
		 * Returns the currently selected location, or an empty
		 * <code>Vector.&lt;int&gt;</code>, if no item is currently selected.
		 *
		 * <p>The following example listens for when selection changes and
		 * requests the selected location:</p>
		 *
		 * <listing version="3.0">
		 * function tree_changeHandler( event:Event ):void
		 * {
		 *     var tree:Tree = Tree( event.currentTarget );
		 *     var result:Vector.&lt;int&gt; = new &lt;int&gt;[];
		 *     var location:Vector.&lt;int&gt; = tree.getSelectedLocation(result);
		 * }
		 * tree.addEventListener( Event.CHANGE, tree_changeHandler );</listing>
		 *
		 * @see #selectedItem
		 * @see #selectedLocation
		 */
		public function getSelectedLocation(result:Vector.<int> = null):Vector.<int>
		{
			if(result === null)
			{
				result = new <int>[];
			}
			else
			{
				result.length = 0;
			}
			if(this._dataProvider === null || this._selectedItem === null)
			{
				return result;
			}
			return this._dataProvider.getItemLocation(this._selectedItem, result);
		}

		/**
		 * @private
		 */
		override public function scrollToPosition(horizontalScrollPosition:Number, verticalScrollPosition:Number, animationDuration:Number = NaN):void
		{
			this.pendingLocation = null;
			super.scrollToPosition(horizontalScrollPosition, verticalScrollPosition, animationDuration);
		}

		/**
		 * @private
		 */
		override public function scrollToPageIndex(horizontalPageIndex:int, verticalPageIndex:int, animationDuration:Number = NaN):void
		{
			this.pendingLocation = null;
			super.scrollToPageIndex(horizontalPageIndex, verticalPageIndex, animationDuration);
		}

		/**
		 * After the next validation, scrolls the list so that the specified
		 * item is visible. If <code>animationDuration</code> is greater than
		 * zero, the scroll will animate. The duration is in seconds.
		 *
		 * <p>In the following example, the list is scrolled to display the
		 * third item in the second branch:</p>
		 *
		 * <listing version="3.0">
		 * tree.scrollToDisplayLocation( new &lt;int&gt;[1, 2] );</listing>
		 */
		public function scrollToDisplayLocation(location:Vector.<int>, animationDuration:Number = 0):void
		{
			//cancel any pending scroll to a different page or scroll position.
			//we can have only one type of pending scroll at a time.
			this.hasPendingHorizontalPageIndex = false;
			this.hasPendingVerticalPageIndex = false;
			this.pendingHorizontalScrollPosition = NaN;
			this.pendingVerticalScrollPosition = NaN;
			if(this.pendingLocation !== null &&
				this.pendingLocation.length == location.length &&
				this.pendingScrollDuration == animationDuration)
			{
				var locationsEqual:Boolean = this.pendingLocation.every(function(item:int, index:int, source:Vector.<int>):Boolean
				{
					return item == location[index];
				});
				if(locationsEqual)
				{
					return;
				}
			}
			this.pendingLocation = location;
			this.pendingScrollDuration = animationDuration;
			this.invalidate(INVALIDATION_FLAG_PENDING_SCROLL);
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			var hasLayout:Boolean = this._layout !== null;

			super.initialize();

			if(!this.dataViewPort)
			{
				this.viewPort = this.dataViewPort = new TreeDataViewPort();
				this.dataViewPort.owner = this;
				this.dataViewPort.addEventListener(Event.CHANGE, dataViewPort_changeHandler);
				this.viewPort = this.dataViewPort;
			}

			if(!hasLayout)
			{
				if(this._hasElasticEdges &&
					this._verticalScrollPolicy === ScrollPolicy.AUTO &&
					this._scrollBarDisplayMode !== ScrollBarDisplayMode.FIXED)
				{
					//so that the elastic edges work even when the max scroll
					//position is 0, similar to iOS.
					this._verticalScrollPolicy = ScrollPolicy.ON;
				}

				var layout:VerticalLayout = new VerticalLayout();
				layout.useVirtualLayout = true;
				layout.padding = 0;
				layout.gap = 0;
				layout.horizontalAlign = HorizontalAlign.JUSTIFY;
				layout.verticalAlign = VerticalAlign.TOP;
				this.ignoreNextStyleRestriction();
				this.layout = layout;
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			this.refreshDataViewPortProperties();
			super.draw();
		}

		/**
		 * @private
		 */
		override protected function handlePendingScroll():void
		{
			if(this.pendingLocation !== null)
			{
				var pendingData:Object = null;
				if(this._dataProvider !== null)
				{
					pendingData = this._dataProvider.getItemAtLocation(this.pendingLocation);
				}
				if(pendingData is Object)
				{
					var point:Point = Pool.getPoint();
					var result:Point = this.dataViewPort.getScrollPositionForLocation(this.pendingLocation, point);
					this.pendingLocation = null;
					if(result === null)
					{
						//we can't scroll to that location...
						//probably because the branch isn't open!
						Pool.putPoint(point);
					}
					else
					{
						var targetHorizontalScrollPosition:Number = point.x;
						var targetVerticalScrollPosition:Number = point.y;
						Pool.putPoint(point);
						if(targetHorizontalScrollPosition < this._minHorizontalScrollPosition)
						{
							targetHorizontalScrollPosition = this._minHorizontalScrollPosition;
						}
						else if(targetHorizontalScrollPosition > this._maxHorizontalScrollPosition)
						{
							targetHorizontalScrollPosition = this._maxHorizontalScrollPosition;
						}
						if(targetVerticalScrollPosition < this._minVerticalScrollPosition)
						{
							targetVerticalScrollPosition = this._minVerticalScrollPosition;
						}
						else if(targetVerticalScrollPosition > this._maxVerticalScrollPosition)
						{
							targetVerticalScrollPosition = this._maxVerticalScrollPosition;
						}
						this.throwTo(targetHorizontalScrollPosition, targetVerticalScrollPosition, this.pendingScrollDuration);
					}
				}
			}
			super.handlePendingScroll();
		}

		/**
		 * @private
		 */
		protected function refreshDataViewPortProperties():void
		{
			this.dataViewPort.isSelectable = this._isSelectable;
			this.dataViewPort.selectedItem = this._selectedItem;
			this.dataViewPort.dataProvider = this._dataProvider;
			this.dataViewPort.typicalItem = this._typicalItem;
			this.dataViewPort.openBranches = this._openBranches;

			this.dataViewPort.itemRendererType = this._itemRendererType;
			this.dataViewPort.itemRendererFactory = this._itemRendererFactory;
			this.dataViewPort.itemRendererFactories = this._itemRendererFactories;
			this.dataViewPort.factoryIDFunction = this._factoryIDFunction;
			this.dataViewPort.customItemRendererStyleName = this._customItemRendererStyleName;

			this.dataViewPort.layout = this._layout;
		}

		/**
		 * @private
		 */
		protected function validateSelectedItemIsInCollection():void
		{
			if(this._selectedItem === null)
			{
				return;
			}
			var selectedItemLocation:Vector.<int> = this._dataProvider.getItemLocation(this._selectedItem, this._helperLocation);
			if(selectedItemLocation === null || selectedItemLocation.length == 0)
			{
				this.selectedItem = null;
			}
		}

		/**
		 * @private
		 */
		protected function dataViewPort_changeHandler(event:Event):void
		{
			this.selectedItem = this.dataViewPort.selectedItem;
		}

		/**
		 * @private
		 */
		protected function dataProvider_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function dataProvider_resetHandler(event:Event):void
		{
			this.horizontalScrollPosition = 0;
			this.verticalScrollPosition = 0;

			//the entire data provider was replaced. select no item.
			this.selectedItem = null;
		}

		/**
		 * @private
		 */
		protected function dataProvider_removeAllHandler(event:Event):void
		{
			this.selectedItem = null;
		}

		/**
		 * @private
		 */
		protected function dataProvider_removeItemHandler(event:Event, indices:Array):void
		{
			this.validateSelectedItemIsInCollection();
		}

		/**
		 * @private
		 */
		protected function dataProvider_filterChangeHandler(event:Event):void
		{
			this.validateSelectedItemIsInCollection();
		}

		/**
		 * @private
		 */
		protected function dataProvider_replaceItemHandler(event:Event, indices:Array):void
		{
			this.validateSelectedItemIsInCollection();
		}

		/**
		 * @private
		 */
		private function layout_scrollHandler(event:Event, scrollOffset:Point):void
		{
			var layout:IVariableVirtualLayout = IVariableVirtualLayout(this._layout);
			if(!this.isScrolling || !layout.useVirtualLayout || !layout.hasVariableItemDimensions)
			{
				return;
			}

			var scrollOffsetX:Number = scrollOffset.x;
			this._startHorizontalScrollPosition += scrollOffsetX;
			this._horizontalScrollPosition += scrollOffsetX;
			if(this._horizontalAutoScrollTween)
			{
				this._targetHorizontalScrollPosition += scrollOffsetX;
				this.throwTo(this._targetHorizontalScrollPosition, NaN, this._horizontalAutoScrollTween.totalTime - this._horizontalAutoScrollTween.currentTime);
			}

			var scrollOffsetY:Number = scrollOffset.y;
			this._startVerticalScrollPosition += scrollOffsetY;
			this._verticalScrollPosition += scrollOffsetY;
			if(this._verticalAutoScrollTween)
			{
				this._targetVerticalScrollPosition += scrollOffsetY;
				this.throwTo(NaN, this._targetVerticalScrollPosition, this._verticalAutoScrollTween.totalTime - this._verticalAutoScrollTween.currentTime);
			}
		}

		/**
		 * @private
		 */
		override protected function nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(!this._isSelectable)
			{
				//not selectable, but should scroll
				super.nativeStage_keyDownHandler(event);
				return;
			}
			if(event.isDefaultPrevented())
			{
				return;
			}
			if(!this._dataProvider)
			{
				return;
			}
			if(this._selectedItem !== null &&
				(event.keyCode == Keyboard.SPACE ||
				((event.keyLocation == 4 || DeviceCapabilities.simulateDPad) && event.keyCode == Keyboard.ENTER)))
			{
				this.dispatchEventWith(Event.TRIGGERED, false, this.selectedItem);
			}
		}
	}
}

================================================
FILE: source/feathers/controls/WebView.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls
{
	import feathers.core.FeathersControl;
	import feathers.events.FeathersEventType;
	import feathers.utils.geom.matrixToScaleX;
	import feathers.utils.geom.matrixToScaleY;

	import flash.errors.IllegalOperationError;
	import flash.events.ErrorEvent;
	import flash.geom.Matrix;
	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.utils.getDefinitionByName;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.rendering.Painter;
	import starling.utils.MatrixUtil;
	import starling.utils.Pool;

	/**
	 * Dispatched when a URL has finished loading with <code>loadURL()</code> or a
	 * string has finished loading with <code>loadString()</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.COMPLETE
	 *
	 * @see #loadURL()
	 * @see #loadString()
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * Indicates that the <code>location</code> property has changed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #location
	 *
	 * @eventType feathers.events.FeathersEventType.LOCATION_CHANGE
	 */
	[Event(name="locationChange",type="starling.events.Event")]

	/**
	 * Indicates that the <code>location</code> property is about to change.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The <code>flash.events.LocationChangeEvent</code>
	 *   dispatched by the <code>StageWebView</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #location
	 *
	 * @eventType feathers.events.FeathersEventType.LOCATION_CHANGING
	 */
	[Event(name="locationChanging",type="starling.events.Event")]

	/**
	 * Indicates that an error occurred in the <code>StageWebView</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The <code>flash.events.ErrorEvent</code>
	 *   dispatched by the <code>StageWebView</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.ERROR
	 */
	[Event(name="error",type="starling.events.Event")]

	/**
	 * A Feathers component that displays a web browser in Adobe AIR, using the
	 * <code>flash.media.StageWebView</code> class.
	 *
	 * <p>Warning: This component is only compatible with Adobe AIR. It cannot
	 * be used with Adobe Flash Player in a web browser.</p>
	 *
	 * @see ../../../help/web-view.html How to use the Feathers WebView component
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class WebView extends FeathersControl
	{
		/**
		 * @private
		 */
		protected static const STAGE_WEB_VIEW_NOT_SUPPORTED_ERROR:String = "Feathers WebView is only supported in Adobe AIR. It cannot be used in Adobe Flash Player.";

		/**
		 * @private
		 */
		protected static const USE_NATIVE_ERROR:String = "The useNative property may only be set before the WebView component validates for the first time.";

		/**
		 * @private
		 */
		protected static const DEFAULT_SIZE:Number = 320;

		/**
		 * @private
		 */
		protected static const DEFAULT_MIN_SIZE:Number = 50;

		/**
		 * @private
		 */
		protected static const STAGE_WEB_VIEW_FULLY_QUALIFIED_CLASS_NAME:String = "flash.media.StageWebView";

		/**
		 * @private
		 */
		protected static var STAGE_WEB_VIEW_CLASS:Class;

		/**
		 * Indicates if this component is supported on the current platform.
		 */
		public static function get isSupported():Boolean
		{
			if(!STAGE_WEB_VIEW_CLASS)
			{
				try
				{
					STAGE_WEB_VIEW_CLASS = Class(getDefinitionByName(STAGE_WEB_VIEW_FULLY_QUALIFIED_CLASS_NAME));
				}
				catch(error:Error)
				{
					return false;
				}
			}
			return STAGE_WEB_VIEW_CLASS.isSupported;
		}

		/**
		 * Constructor.
		 */
		public function WebView()
		{
			this.addEventListener(Event.ADDED_TO_STAGE, webView_addedToStageHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, webView_removedFromStageHandler);
		}

		/**
		 * @private
		 */
		protected var stageWebView:Object;

		/**
		 * @private
		 */
		protected var _useNative:Boolean = false;

		/**
		 * Determines if the system native web browser control is used or if
		 * Adobe AIR's embedded version of the WebKit engine is used.
		 *
		 * <p>Note: Although it is not prohibited, with some content, failures can occur when the same process uses both the embedded and the system WebKit, so it is recommended that all StageWebViews in a given application be constructed with the same value for useNative. In addition, as HTMLLoader depends on the embedded WebKit, applications using HTMLLoader should only construct StageWebViews with useNative set to false.</p>
		 */
		public function get useNative():Boolean
		{
			return this._useNative;
		}

		/**
		 * @private
		 */
		public function set useNative(value:Boolean):void
		{
			if(this.isCreated)
			{
				throw new IllegalOperationError(USE_NATIVE_ERROR);
			}
			this._useNative = value;
		}

		/**
		 * The URL of the currently loaded page.
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/StageWebView.html#location Full description of flash.media.StageWebView.location in Adobe's Flash Platform API Reference
		 */
		public function get location():String
		{
			if(this.stageWebView)
			{
				return this.stageWebView.location;
			}
			return null;
		}

		/**
		 * The title of the currently loaded page.
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/StageWebView.html#title Full description of flash.media.StageWebView.title in Adobe's Flash Platform API Reference
		 */
		public function get title():String
		{
			if(this.stageWebView)
			{
				return this.stageWebView.title;
			}
			return null;
		}

		/**
		 * Indicates if the web view can navigate back in its history.
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/StageWebView.html#isHistoryBackEnabled Full description of flash.media.StageWebView.isHistoryBackEnabled in Adobe's Flash Platform API Reference
		 */
		public function get isHistoryBackEnabled():Boolean
		{
			if(this.stageWebView)
			{
				return this.stageWebView.isHistoryBackEnabled;
			}
			return false;
		}

		/**
		 * Indicates if the web view can navigate forward in its history.
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/StageWebView.html#isHistoryForwardEnabled Full description of flash.media.StageWebView.isHistoryForwardEnabled in Adobe's Flash Platform API Reference
		 */
		public function get isHistoryForwardEnabled():Boolean
		{
			if(this.stageWebView)
			{
				return this.stageWebView.isHistoryForwardEnabled;
			}
			return false;
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this.stageWebView)
			{
				this.stageWebView.stage = null;
				this.stageWebView.dispose();
				this.stageWebView = null;
			}
			super.dispose();
		}

		/**
		 * @private
		 */
		override public function render(painter:Painter):void
		{
			this.refreshViewPort();
			super.render(painter);
		}

		/**
		 * Loads the specified URL.
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/StageWebView.html#loadURL() Full description of flash.media.StageWebView.loadURL() in Adobe's Flash Platform API Reference
		 */
		public function loadURL(url:String):void
		{
			this.validate();
			this.stageWebView.loadURL(url);
		}

		/**
		 * Renders the specified HTML or XHTML string.
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/StageWebView.html#loadString() Full description of flash.media.StageWebView.loadString() in Adobe's Flash Platform API Reference
		 */
		public function loadString(text:String, mimeType:String = "text/html"):void
		{
			this.validate();
			this.stageWebView.loadString(text, mimeType);
		}

		/**
		 * Stops the current page from loading.
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/StageWebView.html#stop() Full description of flash.media.StageWebView.stop() in Adobe's Flash Platform API Reference
		 */
		public function stop():void
		{
			this.validate();
			this.stageWebView.stop();
		}

		/**
		 * Reloads the currently loaded page.
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/StageWebView.html#reload() Full description of flash.media.StageWebView.reload() in Adobe's Flash Platform API Reference
		 */
		public function reload():void
		{
			this.validate();
			this.stageWebView.reload();
		}

		/**
		 * Navigates to the previous page in the browsing history.
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/StageWebView.html#historyBack() Full description of flash.media.StageWebView.historyBack() in Adobe's Flash Platform API Reference
		 * @see #isHistoryBackEnabled
		 */
		public function historyBack():void
		{
			this.validate();
			this.stageWebView.historyBack();
		}

		/**
		 * Navigates to the next page in the browsing history.
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/StageWebView.html#historyForward() Full description of flash.media.StageWebView.historyForward() in Adobe's Flash Platform API Reference
		 * @see #isHistoryForwardEnabled
		 */
		public function historyForward():void
		{
			this.validate();
			this.stageWebView.historyForward();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this.createStageWebView();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;
			if(sizeInvalid)
			{
				this.refreshViewPort();
			}
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}
			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				newWidth = DEFAULT_SIZE;
			}
			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				newHeight = DEFAULT_SIZE;
			}
			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				newMinWidth = DEFAULT_MIN_SIZE;
			}
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				newMinHeight = DEFAULT_MIN_SIZE;
			}
			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * Creates the <code>StageWebView</code> instance.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function createStageWebView():void
		{
			if(isSupported)
			{
				this.stageWebView = new STAGE_WEB_VIEW_CLASS(this._useNative);
			}
			else
			{
				throw new IllegalOperationError(STAGE_WEB_VIEW_NOT_SUPPORTED_ERROR);
			}
			this.stageWebView.addEventListener(ErrorEvent.ERROR, stageWebView_errorHandler);
			//we're using the string here because this class is AIR-only
			this.stageWebView.addEventListener("locationChange", stageWebView_locationChangeHandler);
			this.stageWebView.addEventListener("locationChanging", stageWebView_locationChangingHandler);
			this.stageWebView.addEventListener(flash.events.Event.COMPLETE, stageWebView_completeHandler);
		}

		/**
		 * @private
		 */
		protected function refreshViewPort():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var starlingViewPort:Rectangle = starling.viewPort;
			var stageWebViewViewPort:Rectangle = this.stageWebView.viewPort;
			if(!stageWebViewViewPort)
			{
				stageWebViewViewPort = new Rectangle();
			}

			var point:Point = Pool.getPoint();
			var matrix:Matrix = Pool.getMatrix();
			this.getTransformationMatrix(this.stage, matrix);
			var globalScaleX:Number = matrixToScaleX(matrix);
			var globalScaleY:Number = matrixToScaleY(matrix);
			MatrixUtil.transformCoords(matrix, 0, 0, point);
			var nativeScaleFactor:Number = 1;
			if(starling.supportHighResolutions)
			{
				nativeScaleFactor = starling.nativeStage.contentsScaleFactor;
			}
			var scaleFactor:Number = starling.contentScaleFactor / nativeScaleFactor;
			stageWebViewViewPort.x = Math.round(starlingViewPort.x + point.x * scaleFactor);
			stageWebViewViewPort.y = Math.round(starlingViewPort.y + point.y * scaleFactor);
			var viewPortWidth:Number = Math.round(this.actualWidth * scaleFactor * globalScaleX);
			if(viewPortWidth < 1 ||
				viewPortWidth !== viewPortWidth) //isNaN
			{
				viewPortWidth = 1;
			}
			var viewPortHeight:Number = Math.round(this.actualHeight * scaleFactor * globalScaleY);
			if(viewPortHeight < 1 ||
				viewPortHeight !== viewPortHeight) //isNaN
			{
				viewPortHeight = 1;
			}
			stageWebViewViewPort.width = viewPortWidth;
			stageWebViewViewPort.height = viewPortHeight;
			this.stageWebView.viewPort = stageWebViewViewPort;
			Pool.putPoint(point);
			Pool.putMatrix(matrix);
		}

		/**
		 * @private
		 */
		protected function webView_addedToStageHandler(event:Event):void
		{
			this.stageWebView.stage = this.stage.starling.nativeStage;
			this.addEventListener(Event.ENTER_FRAME, webView_enterFrameHandler);
		}

		/**
		 * @private
		 */
		protected function webView_removedFromStageHandler(event:Event):void
		{
			if(this.stageWebView)
			{
				this.stageWebView.stage = null;
			}
			this.removeEventListener(Event.ENTER_FRAME, webView_enterFrameHandler);
		}

		/**
		 * @private
		 */
		protected function webView_enterFrameHandler(event:Event):void
		{
			var target:DisplayObject = this;
			do
			{
				if(!target.visible)
				{
					this.stageWebView.stage = null;
					return;
				}
				target = target.parent;
			}
			while(target);
			this.stageWebView.stage = this.stage.starling.nativeStage;
		}

		/**
		 * @private
		 */
		protected function stageWebView_errorHandler(event:ErrorEvent):void
		{
			this.dispatchEventWith(FeathersEventType.ERROR, false, event);
		}

		/**
		 * @private
		 */
		protected function stageWebView_locationChangeHandler(event:flash.events.Event):void
		{
			this.dispatchEventWith(FeathersEventType.LOCATION_CHANGE);
		}

		/**
		 * @private
		 */
		protected function stageWebView_locationChangingHandler(event:flash.events.Event):void
		{
			this.dispatchEventWith(FeathersEventType.LOCATION_CHANGING, false, event);
		}

		/**
		 * @private
		 */
		protected function stageWebView_completeHandler(event:flash.events.Event):void
		{
			this.dispatchEventWith(Event.COMPLETE);
		}
	}
}


================================================
FILE: source/feathers/controls/popups/BottomDrawerPopUpContentManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.popups
{
	import feathers.controls.Button;
	import feathers.controls.Header;
	import feathers.controls.Panel;
	import feathers.core.PopUpManager;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.utils.display.getDisplayObjectDepthFromStage;
	import feathers.utils.geom.matrixToScaleX;
	import feathers.utils.geom.matrixToScaleY;

	import flash.errors.IllegalOperationError;
	import flash.events.KeyboardEvent;
	import flash.geom.Matrix;
	import flash.geom.Point;
	import flash.ui.Keyboard;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Stage;
	import starling.events.Event;
	import starling.events.EventDispatcher;
	import starling.events.ResizeEvent;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * Dispatched when the pop-up content opens.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.OPEN
	 */
	[Event(name="open",type="starling.events.Event")]

	/**
	 * Dispatched when the pop-up content closes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CLOSE
	 */
	[Event(name="close",type="starling.events.Event")]

	/**
	 * Displays pop-up content as a mobile-style drawer that opens from the
	 * bottom of the stage.
	 *
	 * @productversion Feathers 2.3.0
	 */
	public class BottomDrawerPopUpContentManager extends EventDispatcher implements IPersistentPopUpContentManager, IPopUpContentManagerWithPrompt
	{
		/**
		 * @private
		 */
		protected static function defaultPanelFactory():Panel
		{
			return new Panel();
		}

		/**
		 * @private
		 */
		protected static function defaultCloseButtonFactory():Button
		{
			return new Button();
		}

		/**
		 * Constructor.
		 */
		public function BottomDrawerPopUpContentManager()
		{
			super();
		}

		/**
		 * @private
		 */
		protected var panel:Panel;

		/**
		 * @private
		 */
		protected var content:DisplayObject;

		/**
		 * @private
		 */
		protected var isClosing:Boolean = false;

		/**
		 * @inheritDoc
		 */
		public function get isOpen():Boolean
		{
			return this.content !== null;
		}

		/**
		 * Creates the <code>Panel</code> that wraps the content.
		 *
		 * <p>In the following example, a custom panel factory is provided:</p>
		 *
		 * <listing version="3.0">
		 * manager.panelFactory = function():Panel
		 * {
		 *     var panel:Panel = new Panel();
		 *     panel.backgroundSkin = new Image( texture );
		 *     return panel;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.Panel
		 */
		public var panelFactory:Function = null;

		/**
		 * Adds a style name to the <code>Panel</code> that wraps the content.
		 *
		 * <p>In the following example, a custom style name is provided:</p>
		 *
		 * <listing version="3.0">
		 * manager.customPanelStyleName = "my-custom-pop-up-panel";</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.Panel
		 */
		public var customPanelStyleName:String = null;

		/**
		 * Creates the <code>Button</code> that closes the pop-up.
		 *
		 * <p>In the following example, a custom close button factory is provided:</p>
		 *
		 * <listing version="3.0">
		 * manager.closeButtonFactory = function():Button
		 * {
		 *     var closeButton:Button = new Button();
		 *     closeButton.defaultSkin = new Image( texture );
		 *     return closeButton;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.Button
		 */
		public var closeButtonFactory:Function = null;

		/**
		 * Adds a style name to the close button.
		 *
		 * <p>In the following example, a custom style name is provided:</p>
		 *
		 * <listing version="3.0">
		 * manager.customCloseButtonStyleName = "my-custom-close-button";</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.Button
		 */
		public var customCloseButtonStyleName:String = null;

		/**
		 * @private
		 */
		protected var _prompt:String;

		/**
		 * A prompt to display in the panel's title.
		 *
		 * <p>Note: If using this manager with a component that has its own
		 * prompt (like <code>PickerList</code>), this value may be overridden
		 * by the component.</p>
		 *
		 * <p>In the following example, a custom title is provided:</p>
		 *
		 * <listing version="3.0">
		 * manager.prompt = "Pick a value";</listing>
		 *
		 * @default null
		 */
		public function get prompt():String
		{
			return this._prompt;
		}

		/**
		 * @private
		 */
		public function set prompt(value:String):void
		{
			this._prompt = value;
		}

		/**
		 * @private
		 */
		protected var _closeButtonLabel:String = "Done";

		/**
		 * The text to display in the label of the close button.
		 *
		 * <p>In the following example, a custom close button label is provided:</p>
		 *
		 * <listing version="3.0">
		 * manager.closeButtonLabel = "Save";</listing>
		 *
		 * @default "Done"
		 */
		public function get closeButtonLabel():String
		{
			return this._closeButtonLabel;
		}

		/**
		 * @private
		 */
		public function set closeButtonLabel(value:String):void
		{
			this._closeButtonLabel = value;
		}

		/**
		 * @private
		 */
		protected var _openOrCloseDuration:Number = 0.5;

		/**
		 * The duration, in seconds, of the animation to open or close the
		 * pop-up.
		 *
		 * <p>In the following example, the duration is changed to 2 seconds:</p>
		 *
		 * <listing version="3.0">
		 * manager.openOrCloseDuration = 2.0;</listing>
		 *
		 * @default 0.5
		 */
		public function get openOrCloseDuration():Number
		{
			return this._openOrCloseDuration;
		}

		/**
		 * @private
		 */
		public function set openOrCloseDuration(value:Number):void
		{
			this._openOrCloseDuration = value;
		}

		/**
		 * @private
		 */
		protected var _openOrCloseEase:Object = Transitions.EASE_OUT;

		/**
		 * The easing function used for opening or closing the pop-up.
		 *
		 * <p>In the following example, the animation ease is changed:</p>
		 *
		 * <listing version="3.0">
		 * manager.openOrCloseEase = Transitions.EASE_IN_OUT;</listing>
		 *
		 * @default starling.animation.Transitions.EASE_OUT
		 *
		 * @see http://doc.starling-framework.org/core/starling/animation/Transitions.html starling.animation.Transitions
		 * @see #openOrCloseDuration
		 */
		public function get openOrCloseEase():Object
		{
			return this._openOrCloseEase;
		}

		/**
		 * @private
		 */
		public function set openOrCloseEase(value:Object):void
		{
			this._openOrCloseEase = value;
		}

		/**
		 * @private
		 */
		protected var _overlayFactory:Function = null;

		/**
		 * This function may be used to customize the modal overlay displayed by
		 * the pop-up manager. If the value of <code>overlayFactory</code> is
		 * <code>null</code>, the pop-up manager's default overlay factory will
		 * be used instead.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 * <pre>function():DisplayObject</pre>
		 *
		 * <p>In the following example, the overlay is customized:</p>
		 *
		 * <listing version="3.0">
		 * manager.overlayFactory = function():DisplayObject
		 * {
		 *     var quad:Quad = new Quad(1, 1, 0xff00ff);
		 *     quad.alpha = 0;
		 *     return quad;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.PopUpManager#overlayFactory
		 */
		public function get overlayFactory():Function
		{
			return this._overlayFactory;
		}

		/**
		 * @private
		 */
		public function set overlayFactory(value:Function):void
		{
			this._overlayFactory = value;
		}

		/**
		 * @private
		 */
		protected var touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var openTween:Tween;

		/**
		 * @private
		 */
		protected var closeTween:Tween;

		/**
		 * @inheritDoc
		 */
		public function open(content:DisplayObject, source:DisplayObject):void
		{
			if(this.isOpen)
			{
				throw new IllegalOperationError("Pop-up content is already open. Close the previous content before opening new content.");
			}

			this.content = content;

			var layout:VerticalLayout = new VerticalLayout();
			layout.horizontalAlign = HorizontalAlign.JUSTIFY;

			var panelFactory:Function = (this.panelFactory !== null) ? this.panelFactory : defaultPanelFactory;
			this.panel = Panel(panelFactory());
			if(this.customPanelStyleName)
			{
				this.panel.styleNameList.add(this.customPanelStyleName);
			}
			this.panel.title = this._prompt;
			this.panel.layout = layout;
			this.panel.headerFactory = headerFactory;
			this.panel.touchable = false;
			this.panel.addChild(content);

			//make sure the content is scaled the same as the source
			var matrix:Matrix = Pool.getMatrix();
			source.getTransformationMatrix(PopUpManager.root, matrix);
			panel.scaleX = matrixToScaleX(matrix);
			panel.scaleY = matrixToScaleY(matrix);
			Pool.putMatrix(matrix);

			PopUpManager.addPopUp(this.panel, true, false, this._overlayFactory);
			this.layout();

			this.panel.addEventListener(Event.REMOVED_FROM_STAGE, panel_removedFromStageHandler);

			var stage:Stage = Starling.current.stage;
			stage.addEventListener(TouchEvent.TOUCH, stage_touchHandler);
			stage.addEventListener(ResizeEvent.RESIZE, stage_resizeHandler);

			//using priority here is a hack so that objects higher up in the
			//display list have a chance to cancel the event first.
			var priority:int = -getDisplayObjectDepthFromStage(this.panel);
			Starling.current.nativeStage.addEventListener(KeyboardEvent.KEY_DOWN, nativeStage_keyDownHandler, false, priority, true);

			this.panel.y = this.panel.stage.stageHeight;
			this.openTween = new Tween(this.panel, this.openOrCloseDuration, this.openOrCloseEase);
			this.openTween.moveTo(0, this.panel.stage.stageHeight - this.panel.height);
			this.openTween.onComplete = openTween_onComplete;
			Starling.juggler.add(this.openTween);
		}

		/**
		 * @inheritDoc
		 */
		public function close():void
		{
			if(!this.isOpen || this.isClosing)
			{
				return;
			}

			if(this.openTween)
			{
				Starling.juggler.remove(this.openTween);
				this.openTween = null;
			}
			if(this.content.stage)
			{
				this.isClosing = true;
				this.panel.touchable = false;
				this.closeTween = new Tween(this.panel, this.openOrCloseDuration, this.openOrCloseEase);
				this.closeTween.moveTo(0, this.panel.stage.stageHeight);
				this.closeTween.onComplete = closeTween_onComplete;
				Starling.juggler.add(this.closeTween);
			}
			else
			{
				this.cleanup();
				this.dispatchEventWith(Event.CLOSE);
			}
		}

		/**
		 * @inheritDoc
		 */
		public function dispose():void
		{
			this.close();
		}

		/**
		 * @private
		 */
		protected function headerFactory():Header
		{
			var header:Header = new Header();
			var closeButtonFactory:Function = (this.closeButtonFactory !== null) ? this.closeButtonFactory : defaultCloseButtonFactory;
			var closeButton:Button = Button(closeButtonFactory());
			if(this.customCloseButtonStyleName !== null)
			{
				closeButton.styleNameList.add(this.customCloseButtonStyleName);
			}
			closeButton.label = this.closeButtonLabel;
			closeButton.addEventListener(Event.TRIGGERED, closeButton_triggeredHandler);
			header.rightItems = new <DisplayObject>[closeButton];
			return header;
		}

		/**
		 * @private
		 */
		protected function layout():void
		{
			this.panel.width = this.panel.stage.stageWidth;
			this.panel.x = 0;
			this.panel.maxHeight = this.panel.stage.stageHeight;
			this.panel.validate();
			this.panel.y = this.panel.stage.stageHeight - this.panel.height;
		}

		/**
		 * @private
		 */
		protected function cleanup():void
		{
			var stage:Stage = Starling.current.stage;
			stage.removeEventListener(TouchEvent.TOUCH, stage_touchHandler);
			stage.removeEventListener(ResizeEvent.RESIZE, stage_resizeHandler);
			Starling.current.nativeStage.removeEventListener(KeyboardEvent.KEY_DOWN, nativeStage_keyDownHandler);

			if(this.panel)
			{
				this.panel.removeEventListener(Event.REMOVED_FROM_STAGE, panel_removedFromStageHandler);
				if(this.panel.contains(this.content))
				{
					this.panel.removeChild(this.content, false);
				}
				this.panel.removeFromParent(true);
				this.panel = null;
			}
			this.content = null;
		}

		/**
		 * @private
		 */
		protected function openTween_onComplete():void
		{
			this.openTween = null;
			this.panel.touchable = true;
			this.dispatchEventWith(Event.OPEN);
		}

		/**
		 * @private
		 */
		protected function closeTween_onComplete():void
		{
			this.isClosing = false;
			this.closeTween = null;
			this.cleanup();
			this.dispatchEventWith(Event.CLOSE);
		}

		/**
		 * @private
		 */
		protected function closeButton_triggeredHandler(event:Event):void
		{
			this.close();
		}

		/**
		 * @private
		 */
		protected function panel_removedFromStageHandler(event:Event):void
		{
			this.close();
		}

		/**
		 * @private
		 */
		protected function nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.isDefaultPrevented())
			{
				//someone else already handled this one
				return;
			}
			if(event.keyCode != Keyboard.BACK && event.keyCode != Keyboard.ESCAPE)
			{
				return;
			}
			//don't let the OS handle the event
			event.preventDefault();

			this.close();
		}

		/**
		 * @private
		 */
		protected function stage_resizeHandler(event:ResizeEvent):void
		{
			if(this.closeTween)
			{
				this.closeTween.advanceTime(this.closeTween.totalTime);
				//the onComplete callback will remove the panel, so no layout is
				//required.
				return;
			}

			if(this.openTween)
			{
				//just stop the animation and go to the final layout
				Starling.juggler.remove(this.openTween);
				this.openTween = null;
			}
			this.layout();
		}

		/**
		 * @private
		 */
		protected function stage_touchHandler(event:TouchEvent):void
		{
			if(!PopUpManager.isTopLevelPopUp(this.panel))
			{
				return;
			}
			var stage:Stage = Starling.current.stage;
			if(this.touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(stage, TouchPhase.ENDED, this.touchPointID);
				if(!touch)
				{
					return;
				}
				var point:Point = Pool.getPoint();
				touch.getLocation(stage, point);
				var hitTestResult:DisplayObject = stage.hitTest(point);
				Pool.putPoint(point);
				if(!this.panel.contains(hitTestResult))
				{
					this.touchPointID = -1;
					this.close();
				}
			}
			else
			{
				touch = event.getTouch(stage, TouchPhase.BEGAN);
				if(!touch)
				{
					return;
				}
				point = Pool.getPoint();
				touch.getLocation(stage, point);
				hitTestResult = stage.hitTest(point);
				Pool.putPoint(point);
				if(this.panel.contains(hitTestResult))
				{
					return;
				}
				this.touchPointID = touch.id;
			}
		}
	}
}


================================================
FILE: source/feathers/controls/popups/CalloutPopUpContentManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.popups
{
	import feathers.controls.Callout;
	import feathers.core.PopUpManager;
	import feathers.utils.geom.matrixToScaleX;
	import feathers.utils.geom.matrixToScaleY;

	import flash.errors.IllegalOperationError;
	import flash.geom.Matrix;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.events.EventDispatcher;
	import starling.utils.Pool;

	/**
	 * Dispatched when the pop-up content opens.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.OPEN
	 */
	[Event(name="open",type="starling.events.Event")]

	/**
	 * Dispatched when the pop-up content closes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CLOSE
	 */
	[Event(name="close",type="starling.events.Event")]

	/**
	 * Displays pop-up content (such as the List in a PickerList) in a Callout.
	 *
	 * @see feathers.controls.PickerList
	 * @see feathers.controls.Callout
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class CalloutPopUpContentManager extends EventDispatcher implements IPopUpContentManager
	{
		/**
		 * Constructor.
		 */
		public function CalloutPopUpContentManager()
		{
			super();
		}

		/**
		 * The factory used to create the <code>Callout</code> instance. If
		 * <code>null</code>, <code>Callout.calloutFactory()</code> will be used.
		 *
		 * <p>Note: If you change this value while a callout is open, the new
		 * value will not go into effect until the callout is closed and a new
		 * callout is opened.</p>
		 *
		 * @see feathers.controls.Callout#calloutFactory
		 *
		 * @default null
		 */
		public var calloutFactory:Function;

		/**
		 * The position of the callout, relative to its origin. Accepts a
		 * <code>Vector.&lt;String&gt;</code> containing one or more of the
		 * constants from <code>feathers.layout.RelativePosition</code> or
		 * <code>null</code>. If <code>null</code>, the callout will attempt to
		 * position itself using values in the following order:
		 *
		 * <ul>
		 *     <li><code>RelativePosition.BOTTOM</code></li>
		 *     <li><code>RelativePosition.TOP</code></li>
		 *     <li><code>RelativePosition.RIGHT</code></li>
		 *     <li><code>RelativePosition.LEFT</code></li>
		 * </ul>
		 *
		 * <p>Note: If you change this value while a callout is open, the new
		 * value will not go into effect until the callout is closed and a new
		 * callout is opened.</p>
		 *
		 * <p>In the following example, the callout's supported positions are
		 * restricted to the top and bottom of the origin:</p>
		 *
		 * <listing version="3.0">
		 * manager.supportedPositions = new &lt;String&gt;[RelativePosition.TOP, RelativePosition.BOTTOM];</listing>
		 *
		 * <p>In the following example, the callout's position is restricted to
		 * the right of the origin:</p>
		 *
		 * <listing version="3.0">
		 * manager.supportedPositions = new &lt;String&gt;[RelativePosition.RIGHT];</listing>
		 *
		 * @default null
		 *
		 * @see feathers.layout.RelativePosition#TOP
		 * @see feathers.layout.RelativePosition#RIGHT
		 * @see feathers.layout.RelativePosition#BOTTOM
		 * @see feathers.layout.RelativePosition#LEFT
		 */
		public var supportedPositions:Vector.<String> = Callout.DEFAULT_POSITIONS;

		/**
		 * Determines if the callout will be modal or not.
		 *
		 * <p>Note: If you change this value while a callout is open, the new
		 * value will not go into effect until the callout is closed and a new
		 * callout is opened.</p>
		 *
		 * <p>In the following example, the callout is not modal:</p>
		 *
		 * <listing version="3.0">
		 * manager.isModal = false;</listing>
		 *
		 * @default true
		 */
		public var isModal:Boolean = true;

		/**
		 * @private
		 */
		protected var _overlayFactory:Function = null;

		/**
		 * If <code>isModal</code> is <code>true</code>, this function may be
		 * used to customize the modal overlay displayed by the pop-up manager.
		 * If the value of <code>overlayFactory</code> is <code>null</code>, the
		 * pop-up manager's default overlay factory will be used instead.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 * <pre>function():DisplayObject</pre>
		 *
		 * <p>In the following example, the overlay is customized:</p>
		 *
		 * <listing version="3.0">
		 * manager.isModal = true;
		 * manager.overlayFactory = function():DisplayObject
		 * {
		 *     var quad:Quad = new Quad(1, 1, 0xff00ff);
		 *     quad.alpha = 0;
		 *     return quad;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.PopUpManager#overlayFactory
		 */
		public function get overlayFactory():Function
		{
			return this._overlayFactory;
		}

		/**
		 * @private
		 */
		public function set overlayFactory(value:Function):void
		{
			this._overlayFactory = value;
		}

		/**
		 * @private
		 */
		protected var content:DisplayObject;

		/**
		 * @private
		 */
		protected var callout:Callout;

		/**
		 * @inheritDoc
		 */
		public function get isOpen():Boolean
		{
			return this.content !== null;
		}

		/**
		 * @inheritDoc
		 */
		public function open(content:DisplayObject, source:DisplayObject):void
		{
			if(this.isOpen)
			{
				throw new IllegalOperationError("Pop-up content is already open. Close the previous content before opening new content.");
			}

			var scaledCalloutFactory:Function = this.calloutFactory;
			//make sure the content is scaled the same as the source
			var matrix:Matrix = Pool.getMatrix();
			source.getTransformationMatrix(PopUpManager.root, matrix);
			var contentScaleX:Number = matrixToScaleX(matrix);
			var contentScaleY:Number = matrixToScaleY(matrix);
			Pool.putMatrix(matrix);
			if(contentScaleX != 1 || contentScaleY != 1)
			{
				var originalCalloutFactory:Function = this.calloutFactory;
				if(originalCalloutFactory === null)
				{
					originalCalloutFactory = Callout.calloutFactory;
				}
				scaledCalloutFactory = function():Callout
				{
					var callout:Callout = originalCalloutFactory();
					callout.scaleX = contentScaleX;
					callout.scaleY = contentScaleY;
					return callout;
				};

			}

			this.content = content;
			this.callout = Callout.show(content, source, this.supportedPositions, this.isModal, scaledCalloutFactory, this._overlayFactory);
			this.callout.addEventListener(Event.REMOVED_FROM_STAGE, callout_removedFromStageHandler);
			this.dispatchEventWith(Event.OPEN);
		}

		/**
		 * @inheritDoc
		 */
		public function close():void
		{
			if(!this.isOpen)
			{
				return;
			}
			this.callout.close();
		}

		/**
		 * @inheritDoc
		 */
		public function dispose():void
		{
			this.close();
		}

		/**
		 * @private
		 */
		protected function cleanup():void
		{
			this.content = null;
			this.callout.content = null;
			this.callout.removeEventListener(Event.REMOVED_FROM_STAGE, callout_removedFromStageHandler);
			this.callout = null;
		}

		/**
		 * @private
		 */
		protected function callout_removedFromStageHandler(event:Event):void
		{
			this.cleanup();
			this.dispatchEventWith(Event.CLOSE);
		}
	}
}


================================================
FILE: source/feathers/controls/popups/DropDownPopUpContentManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.popups
{
	import feathers.core.IFeathersControl;
	import feathers.core.IValidating;
	import feathers.core.PopUpManager;
	import feathers.core.ValidationQueue;
	import feathers.display.RenderDelegate;
	import feathers.events.FeathersEventType;
	import feathers.layout.RelativePosition;
	import feathers.utils.display.getDisplayObjectDepthFromStage;
	import feathers.utils.geom.matrixToScaleX;
	import feathers.utils.geom.matrixToScaleY;

	import flash.errors.IllegalOperationError;
	import flash.events.KeyboardEvent;
	import flash.geom.Matrix;
	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.ui.Keyboard;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Quad;
	import starling.display.Stage;
	import starling.events.Event;
	import starling.events.EventDispatcher;
	import starling.events.ResizeEvent;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * Dispatched when the pop-up content opens.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.OPEN
	 */
	[Event(name="open",type="starling.events.Event")]

	/**
	 * Dispatched when the pop-up content closes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CLOSE
	 */
	[Event(name="close",type="starling.events.Event")]

	/**
	 * Displays pop-up content as a desktop-style drop-down.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class DropDownPopUpContentManager extends EventDispatcher implements IPopUpContentManager
	{
		/**
		 * Constructor.
		 */
		public function DropDownPopUpContentManager()
		{
			super();
		}

		/**
		 * @private
		 */
		protected var content:DisplayObject;

		/**
		 * @private
		 */
		protected var source:DisplayObject;

		/**
		 * @private
		 */
		protected var _delegate:RenderDelegate;

		/**
		 * @private
		 * Stores the same value as the content property, but the content
		 * property may be set to null before the animation ends.
		 */
		protected var _openCloseTweenTarget:DisplayObject;

		/**
		 * @private
		 */
		protected var _openCloseTween:Tween;

		/**
		 * @inheritDoc
		 */
		public function get isOpen():Boolean
		{
			return this.content !== null;
		}

		/**
		 * @private
		 */
		protected var _isModal:Boolean = false;

		/**
		 * Determines if the pop-up will be modal or not.
		 *
		 * <p>Note: If you change this value while a pop-up is displayed, the
		 * new value will not go into effect until the pop-up is removed and a
		 * new pop-up is added.</p>
		 *
		 * <p>In the following example, the pop-up is modal:</p>
		 *
		 * <listing version="3.0">
		 * manager.isModal = true;</listing>
		 *
		 * @default false
		 */
		public function get isModal():Boolean
		{
			return this._isModal;
		}

		/**
		 * @private
		 */
		public function set isModal(value:Boolean):void
		{
			this._isModal = value;
		}

		/**
		 * @private
		 */
		protected var _overlayFactory:Function;

		/**
		 * If <code>isModal</code> is <code>true</code>, this function may be
		 * used to customize the modal overlay displayed by the pop-up manager.
		 * If the value of <code>overlayFactory</code> is <code>null</code>, the
		 * pop-up manager's default overlay factory will be used instead.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 * <pre>function():DisplayObject</pre>
		 *
		 * <p>In the following example, the overlay is customized:</p>
		 *
		 * <listing version="3.0">
		 * manager.isModal = true;
		 * manager.overlayFactory = function():DisplayObject
		 * {
		 *     var quad:Quad = new Quad(1, 1, 0xff00ff);
		 *     quad.alpha = 0;
		 *     return quad;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.PopUpManager#overlayFactory
		 */
		public function get overlayFactory():Function
		{
			return this._overlayFactory;
		}

		/**
		 * @private
		 */
		public function set overlayFactory(value:Function):void
		{
			this._overlayFactory = value;
		}

		/**
		 * @private
		 */
		protected var _gap:Number = 0;

		/**
		 * The space, in pixels, between the source and the pop-up.
		 */
		public function get gap():Number
		{
			return this._gap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			this._gap = value;
		}

		/**
		 * @private
		 */
		protected var _openCloseDuration:Number = 0.2;

		/**
		 * The duration, in seconds, of the open and close animation.
		 */
		public function get openCloseDuration():Number
		{
			return this._openCloseDuration;
		}

		/**
		 * @private
		 */
		public function set openCloseDuration(value:Number):void
		{
			this._openCloseDuration = value;
		}

		/**
		 * @private
		 */
		protected var _openCloseEase:Object = Transitions.EASE_OUT;

		/**
		 * The easing function to use for the open and close animation.
		 */
		public function get openCloseEase():Object
		{
			return this._openCloseEase;
		}

		/**
		 * @private
		 */
		public function set openCloseEase(value:Object):void
		{
			this._openCloseEase = value;
		}

		/**
		 * @private
		 */
		protected var _actualDirection:String;

		/**
		 * @private
		 */
		protected var _primaryDirection:String = RelativePosition.BOTTOM;

		/**
		 * The preferred position of the pop-up, relative to the source. If
		 * there is not enough space to position pop-up at the preferred
		 * position, it may be positioned elsewhere.
		 *
		 * @default feathers.layout.RelativePosition.BOTTOM
		 *
		 * @see feathers.layout.RelativePosition#BOTTOM
		 * @see feathers.layout.RelativePosition#TOP
		 */
		public function get primaryDirection():String
		{
			return this._primaryDirection;
		}

		/**
		 * @private
		 */
		public function set primaryDirection(value:String):void
		{
			if(value === "up")
			{
				value = RelativePosition.TOP;
			}
			else if(value === "down")
			{
				value = RelativePosition.BOTTOM;
			}
			this._primaryDirection = value;
		}

		/**
		 * @private
		 */
		protected var _fitContentMinWidthToOrigin:Boolean = true;

		/**
		 * If enabled, the pop-up content's <code>minWidth</code> property will
		 * be set to the <code>width</code> property of the origin, if it is
		 * smaller.
		 *
		 * @default true
		 */
		public function get fitContentMinWidthToOrigin():Boolean
		{
			return this._fitContentMinWidthToOrigin;
		}

		/**
		 * @private
		 */
		public function set fitContentMinWidthToOrigin(value:Boolean):void
		{
			this._fitContentMinWidthToOrigin = value;
		}

		/**
		 * @private
		 */
		protected var _lastOriginX:Number;

		/**
		 * @private
		 */
		protected var _lastOriginY:Number;

		/**
		 * @inheritDoc
		 */
		public function open(content:DisplayObject, source:DisplayObject):void
		{
			if(this.isOpen)
			{
				throw new IllegalOperationError("Pop-up content is already open. Close the previous content before opening new content.");
			}

			//make sure the content is scaled the same as the source
			var matrix:Matrix = Pool.getMatrix();
			source.getTransformationMatrix(PopUpManager.root, matrix);
			content.scaleX = matrixToScaleX(matrix);
			content.scaleY = matrixToScaleY(matrix);
			Pool.putMatrix(matrix);

			this.content = content;
			this.source = source;
			PopUpManager.addPopUp(content, this._isModal, false, this._overlayFactory);
			if(content is IFeathersControl)
			{
				content.addEventListener(FeathersEventType.RESIZE, content_resizeHandler);
			}
			content.addEventListener(Event.REMOVED_FROM_STAGE, content_removedFromStageHandler);
			this.layout();
			if(this._openCloseTween !== null)
			{
				this._openCloseTween.advanceTime(this._openCloseTween.totalTime);
			}
			if(this._openCloseDuration > 0)
			{
				this._delegate = new RenderDelegate(content);
				this._delegate.scaleX = content.scaleX;
				this._delegate.scaleY = content.scaleY;
				//temporarily hide the content while the delegate is displayed
				content.visible = false;
				PopUpManager.addPopUp(this._delegate, false, false);
				this._delegate.x = content.x;
				if(this._actualDirection === RelativePosition.TOP)
				{
					this._delegate.y = content.y + content.height;
				}
				else //bottom
				{
					this._delegate.y = content.y - content.height;
				}
				var mask:Quad = new Quad(1, 1, 0xff00ff);
				mask.width = content.width / content.scaleX;
				mask.height = 0;
				this._delegate.mask = mask;
				mask.height = 0;
				this._openCloseTween = new Tween(this._delegate, this._openCloseDuration, this._openCloseEase);
				this._openCloseTweenTarget = content;
				this._openCloseTween.animate("y", content.y);
				this._openCloseTween.onUpdate = openCloseTween_onUpdate;
				this._openCloseTween.onComplete = openTween_onComplete;
				Starling.juggler.add(this._openCloseTween);
			}
			var stage:Stage = this.source.stage;
			stage.addEventListener(TouchEvent.TOUCH, stage_touchHandler);
			stage.addEventListener(ResizeEvent.RESIZE, stage_resizeHandler);
			stage.addEventListener(Event.ENTER_FRAME, stage_enterFrameHandler);

			//using priority here is a hack so that objects higher up in the
			//display list have a chance to cancel the event first.
			var priority:int = -getDisplayObjectDepthFromStage(this.content);
			Starling.current.nativeStage.addEventListener(KeyboardEvent.KEY_DOWN, nativeStage_keyDownHandler, false, priority, true);
			this.dispatchEventWith(Event.OPEN);
		}

		/**
		 * @inheritDoc
		 */
		public function close():void
		{
			if(!this.isOpen)
			{
				return;
			}
			if(this._openCloseTween !== null)
			{
				this._openCloseTween.advanceTime(this._openCloseTween.totalTime);
			}
			var content:DisplayObject = this.content;
			this.source = null;
			this.content = null;
			var stage:Stage = content.stage;
			stage.removeEventListener(TouchEvent.TOUCH, stage_touchHandler);
			stage.removeEventListener(ResizeEvent.RESIZE, stage_resizeHandler);
			stage.removeEventListener(Event.ENTER_FRAME, stage_enterFrameHandler);
			stage.starling.nativeStage.removeEventListener(KeyboardEvent.KEY_DOWN, nativeStage_keyDownHandler);
			if(content is IFeathersControl)
			{
				content.removeEventListener(FeathersEventType.RESIZE, content_resizeHandler);
			}
			content.removeEventListener(Event.REMOVED_FROM_STAGE, content_removedFromStageHandler);
			if(content.parent)
			{
				content.removeFromParent(false);
			}
			if(this._openCloseDuration > 0)
			{
				this._delegate = new RenderDelegate(content);
				this._delegate.scaleX = content.scaleX;
				this._delegate.scaleY = content.scaleY;
				PopUpManager.addPopUp(this._delegate, false, false);
				this._delegate.x = content.x;
				this._delegate.y = content.y;
				var mask:Quad = new Quad(1, 1, 0xff00ff);
				mask.width = content.width / content.scaleX;
				mask.height = content.height / content.scaleY;
				this._delegate.mask = mask;
				this._openCloseTween = new Tween(this._delegate, this._openCloseDuration, this._openCloseEase);
				this._openCloseTweenTarget = content;
				if(this._actualDirection === RelativePosition.TOP)
				{
					this._openCloseTween.animate("y", content.y + content.height);
				}
				else
				{
					this._openCloseTween.animate("y", content.y - content.height);
				}
				this._openCloseTween.onUpdate = openCloseTween_onUpdate;
				this._openCloseTween.onComplete = closeTween_onComplete;
				Starling.juggler.add(this._openCloseTween);
			}
			else
			{
				this.dispatchEventWith(Event.CLOSE);
			}
		}

		/**
		 * @inheritDoc
		 */
		public function dispose():void
		{
			this.openCloseDuration = 0;
			this.close();
		}

		/**
		 * @private
		 */
		protected function layout():void
		{
			if(this.source is IValidating)
			{
				IValidating(this.source).validate();
				if(!this.isOpen)
				{
					//it's possible that the source will close its pop-up during
					//validation, so we should check for that.
					return;
				}
			}

			var originBoundsInParent:Rectangle = this.source.getBounds(PopUpManager.root);
			var sourceWidth:Number = originBoundsInParent.width;
			var hasSetBounds:Boolean = false;
			var uiContent:IFeathersControl = this.content as IFeathersControl;
			if(this._fitContentMinWidthToOrigin && uiContent && uiContent.minWidth < sourceWidth)
			{
				uiContent.minWidth = sourceWidth;
				hasSetBounds = true;
			}
			if(this.content is IValidating)
			{
				uiContent.validate();
			}
			if(!hasSetBounds && this._fitContentMinWidthToOrigin && this.content.width < sourceWidth)
			{
				this.content.width = sourceWidth;
			}

			var stage:Stage = this.source.stage;

			//we need to be sure that the source is properly positioned before
			//positioning the content relative to it.
			var validationQueue:ValidationQueue = ValidationQueue.forStarling(stage.starling);
			if(validationQueue && !validationQueue.isValidating)
			{
				//force a COMPLETE validation of everything
				//but only if we're not already doing that...
				validationQueue.advanceTime(0);
			}

			originBoundsInParent = this.source.getBounds(PopUpManager.root);
			this._lastOriginX = originBoundsInParent.x;
			this._lastOriginY = originBoundsInParent.y;

			var stageDimensionsInParent:Point = new Point(stage.stageWidth, stage.stageHeight);
			PopUpManager.root.globalToLocal(stageDimensionsInParent, stageDimensionsInParent);

			var downSpace:Number = (stageDimensionsInParent.y - this.content.height) - (originBoundsInParent.y + originBoundsInParent.height + this._gap);
			//skip this if the primary direction is up
			if(this._primaryDirection == RelativePosition.BOTTOM && downSpace >= 0)
			{
				layoutBelow(originBoundsInParent, stageDimensionsInParent);
				return;
			}

			var upSpace:Number = originBoundsInParent.y - this._gap - this.content.height;
			if(upSpace >= 0)
			{
				layoutAbove(originBoundsInParent, stageDimensionsInParent);
				return;
			}

			//do what we skipped earlier if the primary direction is up
			if(this._primaryDirection == RelativePosition.TOP && downSpace >= 0)
			{
				layoutBelow(originBoundsInParent, stageDimensionsInParent);
				return;
			}

			//worst case: pick the side that has the most available space
			if(upSpace >= downSpace)
			{
				layoutAbove(originBoundsInParent, stageDimensionsInParent);
			}
			else
			{
				layoutBelow(originBoundsInParent, stageDimensionsInParent);
			}

			//the content is too big for the space, so we need to adjust it to
			//fit properly
			var newMaxHeight:Number = stageDimensionsInParent.y - (originBoundsInParent.y + originBoundsInParent.height);
			if(uiContent)
			{
				if(uiContent.maxHeight > newMaxHeight)
				{
					uiContent.maxHeight = newMaxHeight;
				}
			}
			else if(this.content.height > newMaxHeight)
			{
				this.content.height = newMaxHeight;
			}
		}

		/**
		 * @private
		 */
		protected function layoutAbove(originBoundsInParent:Rectangle, stageDimensionsInParent:Point):void
		{
			this._actualDirection = RelativePosition.TOP;
			this.content.x = this.calculateXPosition(originBoundsInParent, stageDimensionsInParent);
			this.content.y = originBoundsInParent.y - this.content.height - this._gap;
		}

		/**
		 * @private
		 */
		protected function layoutBelow(originBoundsInParent:Rectangle, stageDimensionsInParent:Point):void
		{
			this._actualDirection = RelativePosition.BOTTOM;
			this.content.x = this.calculateXPosition(originBoundsInParent, stageDimensionsInParent);
			this.content.y = originBoundsInParent.y + originBoundsInParent.height + this._gap;
		}

		/**
		 * @private
		 */
		protected function calculateXPosition(originBoundsInParent:Rectangle, stageDimensionsInParent:Point):Number
		{
			var idealXPosition:Number = originBoundsInParent.x;
			var fallbackXPosition:Number = idealXPosition + originBoundsInParent.width - this.content.width;
			var maxXPosition:Number = stageDimensionsInParent.x - this.content.width;
			var xPosition:Number = idealXPosition;
			if(xPosition > maxXPosition)
			{
				if(fallbackXPosition >= 0)
				{
					xPosition = fallbackXPosition;
				}
				else
				{
					xPosition = maxXPosition;
				}
			}
			if(xPosition < 0)
			{
				xPosition = 0;
			}
			return xPosition;
		}

		/**
		 * @private
		 */
		protected function openCloseTween_onUpdate():void
		{
			var mask:DisplayObject = this._delegate.mask;
			if(this._actualDirection === RelativePosition.TOP)
			{
				mask.height = (this._openCloseTweenTarget.height - (this._delegate.y - this._openCloseTweenTarget.y)) / this._openCloseTweenTarget.scaleY;
				mask.y = 0;
			}
			else
			{
				mask.height = (this._openCloseTweenTarget.height - (this._openCloseTweenTarget.y - this._delegate.y)) / this._openCloseTweenTarget.scaleY;
				mask.y = (this._openCloseTweenTarget.height / this._openCloseTweenTarget.scaleY) - mask.height;
			}
		}

		/**
		 * @private
		 */
		protected function openCloseTween_onComplete():void
		{
			this._openCloseTween = null;
			this._delegate.removeFromParent(true);
			this._delegate = null;
		}

		/**
		 * @private
		 */
		protected function openTween_onComplete():void
		{
			this.openCloseTween_onComplete();
			this.content.visible = true;
		}

		/**
		 * @private
		 */
		protected function closeTween_onComplete():void
		{
			this.openCloseTween_onComplete();
			this.dispatchEventWith(Event.CLOSE);
		}

		/**
		 * @private
		 */
		protected function content_resizeHandler(event:Event):void
		{
			this.layout();
		}

		/**
		 * @private
		 */
		protected function stage_enterFrameHandler(event:Event):void
		{
			var rect:Rectangle = Pool.getRectangle();
			this.source.getBounds(PopUpManager.root, rect);
			var rectX:Number = rect.x;
			var rectY:Number = rect.y;
			Pool.putRectangle(rect);
			if(rectY != this._lastOriginX || rectY != this._lastOriginY)
			{
				this.layout();
			}
		}

		/**
		 * @private
		 */
		protected function content_removedFromStageHandler(event:Event):void
		{
			this.close();
		}

		/**
		 * @private
		 */
		protected function nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.isDefaultPrevented())
			{
				//someone else already handled this one
				return;
			}
			if(event.keyCode != Keyboard.BACK && event.keyCode != Keyboard.ESCAPE)
			{
				return;
			}
			//don't let the OS handle the event
			event.preventDefault();

			this.close();
		}

		/**
		 * @private
		 */
		protected function stage_resizeHandler(event:ResizeEvent):void
		{
			this.layout();
		}

		/**
		 * @private
		 */
		protected function stage_touchHandler(event:TouchEvent):void
		{
			var target:DisplayObject = DisplayObject(event.target);
			if(this.content == target || (this.content is DisplayObjectContainer && DisplayObjectContainer(this.content).contains(target)))
			{
				return;
			}
			if(this.source == target || (this.source is DisplayObjectContainer && DisplayObjectContainer(this.source).contains(target)))
			{
				return;
			}
			if(!PopUpManager.isTopLevelPopUp(this.content))
			{
				return;
			}
			//any began touch is okay here. we don't need to check all touches
			var stage:Stage = Stage(event.currentTarget);
			var touch:Touch = event.getTouch(stage, TouchPhase.BEGAN);
			if(!touch)
			{
				return;
			}
			this.close();
		}
	}
}

================================================
FILE: source/feathers/controls/popups/IPersistentPopUpContentManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.popups
{
	/**
	 * An <code>IPopUpContentManager</code> that wraps its content in a custom
	 * UI that should keep the content open until closed by the user.
	 *
	 * <p>For example, a <code>PickerList</code> using this type of manager
	 * would keep its pop-up open after a list item is selected or triggered.
	 * The manager will provide its own custom UI to close itself, such as a
	 * close button.</p>
	 *
	 * @productversion Feathers 2.3.0
	 */
	public interface IPersistentPopUpContentManager extends IPopUpContentManager
	{
	}
}


================================================
FILE: source/feathers/controls/popups/IPopUpContentManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.popups
{
	import feathers.core.IFeathersEventDispatcher;

	import starling.display.DisplayObject;

	/**
	 * Dispatched when the pop-up content opens.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.OPEN
	 */
	[Event(name="open",type="starling.events.Event")]

	/**
	 * Dispatched when the pop-up content closes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CLOSE
	 */
	[Event(name="close",type="starling.events.Event")]

	/**
	 * Automatically manages pop-up content layout and positioning.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface IPopUpContentManager extends IFeathersEventDispatcher
	{
		/**
		 * Indicates if the pop-up content is open or not.
		 */
		function get isOpen():Boolean;

		/**
		 * Displays the pop-up content.
		 *
		 * @param content		The content for the pop-up content manager to display.
		 * @param source		The source of the pop-up. May be used to position and/or size the pop-up. May be completely ignored instead.
		 */
		function open(content:DisplayObject, source:DisplayObject):void;

		/**
		 * Closes the pop-up content. If it is not opened, nothing happens.
		 */
		function close():void;

		/**
		 * Cleans up the manager.
		 */
		function dispose():void;
	}
}


================================================
FILE: source/feathers/controls/popups/IPopUpContentManagerWithPrompt.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.popups
{
	/**
	 * A custom <code>IPopUpContentManager</code> that has a prompt that may
	 * be customized by the parent component.
	 *
	 * @productversion Feathers 2.3.0
	 */
	public interface IPopUpContentManagerWithPrompt extends IPopUpContentManager
	{
		/**
		 * Some descriptive text to display with the pop-up.
		 */
		function get prompt():String;

		/**
		 * @private
		 */
		function set prompt(value:String):void;
	}
}


================================================
FILE: source/feathers/controls/popups/VerticalCenteredPopUpContentManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.popups
{
	import feathers.core.IFeathersControl;
	import feathers.core.IValidating;
	import feathers.core.PopUpManager;
	import feathers.events.FeathersEventType;
	import feathers.utils.display.getDisplayObjectDepthFromStage;
	import feathers.utils.geom.matrixToScaleX;
	import feathers.utils.geom.matrixToScaleY;

	import flash.errors.IllegalOperationError;
	import flash.events.KeyboardEvent;
	import flash.geom.Matrix;
	import flash.geom.Point;
	import flash.ui.Keyboard;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Stage;
	import starling.events.Event;
	import starling.events.EventDispatcher;
	import starling.events.ResizeEvent;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * Dispatched when the pop-up content opens.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.OPEN
	 */
	[Event(name="open",type="starling.events.Event")]

	/**
	 * Dispatched when the pop-up content closes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CLOSE
	 */
	[Event(name="close",type="starling.events.Event")]

	/**
	 * Displays a pop-up at the center of the stage, filling the vertical space.
	 * The content will be sized horizontally so that it is no larger than the
	 * the width or height of the stage (whichever is smaller).
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class VerticalCenteredPopUpContentManager extends EventDispatcher implements IPopUpContentManager
	{
		/**
		 * Constructor.
		 */
		public function VerticalCenteredPopUpContentManager()
		{
		}

		/**
		 * Quickly sets all margin properties to the same value. The
		 * <code>margin</code> getter always returns the value of
		 * <code>marginTop</code>, but the other padding values may be
		 * different.
		 *
		 * <p>The following example gives the pop-up a minimum of 20 pixels of
		 * margin on all sides:</p>
		 *
		 * <listing version="3.0">
		 * manager.margin = 20;</listing>
		 *
		 * @default 0
		 *
		 * @see #marginTop
		 * @see #marginRight
		 * @see #marginBottom
		 * @see #marginLeft
		 */
		public function get margin():Number
		{
			return this.marginTop;
		}

		/**
		 * @private
		 */
		public function set margin(value:Number):void
		{
			this.marginTop = value;
			this.marginRight = value;
			this.marginBottom = value;
			this.marginLeft = value;
		}

		/**
		 * The minimum space, in pixels, between the top edge of the content and
		 * the top edge of the stage.
		 *
		 * <p>The following example gives the pop-up a minimum of 20 pixels of
		 * margin on the top:</p>
		 *
		 * <listing version="3.0">
		 * manager.marginTop = 20;</listing>
		 *
		 * @default 0
		 *
		 * @see #margin
		 */
		public var marginTop:Number = 0;

		/**
		 * The minimum space, in pixels, between the right edge of the content
		 * and the right edge of the stage.
		 *
		 * <p>The following example gives the pop-up a minimum of 20 pixels of
		 * margin on the right:</p>
		 *
		 * <listing version="3.0">
		 * manager.marginRight = 20;</listing>
		 *
		 * @default 0
		 *
		 * @see #margin
		 */
		public var marginRight:Number = 0;

		/**
		 * The minimum space, in pixels, between the bottom edge of the content
		 * and the bottom edge of the stage.
		 *
		 * <p>The following example gives the pop-up a minimum of 20 pixels of
		 * margin on the bottom:</p>
		 *
		 * <listing version="3.0">
		 * manager.marginBottom = 20;</listing>
		 *
		 * @default 0
		 *
		 * @see #margin
		 */
		public var marginBottom:Number = 0;

		/**
		 * The minimum space, in pixels, between the left edge of the content
		 * and the left edge of the stage.
		 *
		 * <p>The following example gives the pop-up a minimum of 20 pixels of
		 * margin on the left:</p>
		 *
		 * <listing version="3.0">
		 * manager.marginLeft = 20;</listing>
		 *
		 * @default 0
		 *
		 * @see #margin
		 */
		public var marginLeft:Number = 0;

		/**
		 * @private
		 */
		protected var _overlayFactory:Function = null;

		/**
		 * This function may be used to customize the modal overlay displayed by
		 * the pop-up manager. If the value of <code>overlayFactory</code> is
		 * <code>null</code>, the pop-up manager's default overlay factory will
		 * be used instead.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 * <pre>function():DisplayObject</pre>
		 *
		 * <p>In the following example, the overlay is customized:</p>
		 *
		 * <listing version="3.0">
		 * manager.overlayFactory = function():DisplayObject
		 * {
		 *     var quad:Quad = new Quad(1, 1, 0xff00ff);
		 *     quad.alpha = 0;
		 *     return quad;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.PopUpManager#overlayFactory
		 */
		public function get overlayFactory():Function
		{
			return this._overlayFactory;
		}

		/**
		 * @private
		 */
		public function set overlayFactory(value:Function):void
		{
			this._overlayFactory = value;
		}

		/**
		 * @private
		 */
		protected var content:DisplayObject;

		/**
		 * @private
		 */
		protected var touchPointID:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get isOpen():Boolean
		{
			return this.content !== null;
		}

		/**
		 * @inheritDoc
		 */
		public function open(content:DisplayObject, source:DisplayObject):void
		{
			if(this.isOpen)
			{
				throw new IllegalOperationError("Pop-up content is already open. Close the previous content before opening new content.");
			}

			//make sure the content is scaled the same as the source
			var matrix:Matrix = Pool.getMatrix();
			source.getTransformationMatrix(PopUpManager.root, matrix);
			content.scaleX = matrixToScaleX(matrix);
			content.scaleY = matrixToScaleY(matrix);
			Pool.putMatrix(matrix);

			this.content = content;
			PopUpManager.addPopUp(this.content, true, false, this._overlayFactory);
			if(this.content is IFeathersControl)
			{
				this.content.addEventListener(FeathersEventType.RESIZE, content_resizeHandler);
			}
			this.content.addEventListener(Event.REMOVED_FROM_STAGE, content_removedFromStageHandler);
			this.layout();
			var stage:Stage = Starling.current.stage;
			stage.addEventListener(TouchEvent.TOUCH, stage_touchHandler);
			stage.addEventListener(ResizeEvent.RESIZE, stage_resizeHandler);

			//using priority here is a hack so that objects higher up in the
			//display list have a chance to cancel the event first.
			var priority:int = -getDisplayObjectDepthFromStage(this.content);
			Starling.current.nativeStage.addEventListener(KeyboardEvent.KEY_DOWN, nativeStage_keyDownHandler, false, priority, true);
			this.dispatchEventWith(Event.OPEN);
		}

		/**
		 * @inheritDoc
		 */
		public function close():void
		{
			if(!this.isOpen)
			{
				return;
			}
			var content:DisplayObject = this.content;
			this.content = null;
			var stage:Stage = Starling.current.stage;
			stage.removeEventListener(TouchEvent.TOUCH, stage_touchHandler);
			stage.removeEventListener(ResizeEvent.RESIZE, stage_resizeHandler);
			Starling.current.nativeStage.removeEventListener(KeyboardEvent.KEY_DOWN, nativeStage_keyDownHandler);
			if(content is IFeathersControl)
			{
				content.removeEventListener(FeathersEventType.RESIZE, content_resizeHandler);
			}
			content.removeEventListener(Event.REMOVED_FROM_STAGE, content_removedFromStageHandler);
			if(content.parent)
			{
				content.removeFromParent(false);
			}
			this.dispatchEventWith(Event.CLOSE);
		}

		/**
		 * @inheritDoc
		 */
		public function dispose():void
		{
			this.close();
		}

		/**
		 * @private
		 */
		protected function layout():void
		{
			var stage:Stage = Starling.current.stage;
			var point:Point = Pool.getPoint(stage.stageWidth, stage.stageHeight);
			PopUpManager.root.globalToLocal(point, point);
			var parentWidth:Number = point.x;
			var parentHeight:Number = point.y;
			Pool.putPoint(point);
			var maxWidth:Number = parentWidth;
			if(maxWidth > parentHeight)
			{
				maxWidth = parentHeight;
			}
			maxWidth -= (this.marginLeft + this.marginRight);
			var maxHeight:Number = parentHeight - this.marginTop - this.marginBottom;
			var hasSetBounds:Boolean = false;
			if(this.content is IFeathersControl)
			{
				//if it's a ui control that is able to auto-size, this section
				//will ensure that the control stays within the required bounds.
				var uiContent:IFeathersControl = IFeathersControl(this.content);
				uiContent.minWidth = maxWidth;
				uiContent.maxWidth = maxWidth;
				uiContent.maxHeight = maxHeight;
				hasSetBounds = true;
			}
			if(this.content is IValidating)
			{
				IValidating(this.content).validate();
			}
			if(!hasSetBounds)
			{
				//if it's not a ui control, and the control's explicit width and
				//height values are greater than our maximum bounds, then we
				//will enforce the maximum bounds the hard way.
				if(this.content.width > maxWidth)
				{
					this.content.width = maxWidth;
				}
				if(this.content.height > maxHeight)
				{
					this.content.height = maxHeight;
				}
			}
			//round to the nearest pixel to avoid unnecessary smoothing
			this.content.x = Math.round((parentWidth - this.content.width) / 2);
			this.content.y = Math.round((parentHeight - this.content.height) / 2);
		}

		/**
		 * @private
		 */
		protected function content_resizeHandler(event:Event):void
		{
			this.layout();
		}

		/**
		 * @private
		 */
		protected function content_removedFromStageHandler(event:Event):void
		{
			this.close();
		}

		/**
		 * @private
		 */
		protected function nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.isDefaultPrevented())
			{
				//someone else already handled this one
				return;
			}
			if(event.keyCode != Keyboard.BACK && event.keyCode != Keyboard.ESCAPE)
			{
				return;
			}
			//don't let the OS handle the event
			event.preventDefault();

			this.close();
		}

		/**
		 * @private
		 */
		protected function stage_resizeHandler(event:ResizeEvent):void
		{
			this.layout();
		}

		/**
		 * @private
		 */
		protected function stage_touchHandler(event:TouchEvent):void
		{
			if(!PopUpManager.isTopLevelPopUp(this.content))
			{
				return;
			}
			var stage:Stage = Starling.current.stage;
			if(this.touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(stage, TouchPhase.ENDED, this.touchPointID);
				if(!touch)
				{
					return;
				}
				var point:Point = Pool.getPoint();
				touch.getLocation(stage, point);
				var hitTestResult:DisplayObject = stage.hitTest(point);
				Pool.putPoint(point);
				var isInBounds:Boolean = false;
				if(this.content is DisplayObjectContainer)
				{
					isInBounds = DisplayObjectContainer(this.content).contains(hitTestResult);
				}
				else
				{
					isInBounds = this.content == hitTestResult;
				}
				if(!isInBounds)
				{
					this.touchPointID = -1;
					this.close();
				}
			}
			else
			{
				touch = event.getTouch(stage, TouchPhase.BEGAN);
				if(!touch)
				{
					return;
				}
				point = Pool.getPoint();
				touch.getLocation(stage, point);
				hitTestResult = stage.hitTest(point);
				Pool.putPoint(point);
				isInBounds = false;
				if(this.content is DisplayObjectContainer)
				{
					isInBounds = DisplayObjectContainer(this.content).contains(hitTestResult);
				}
				else
				{
					isInBounds = this.content == hitTestResult;
				}
				if(isInBounds)
				{
					return;
				}
				this.touchPointID = touch.id;
			}
		}

	}
}


================================================
FILE: source/feathers/controls/renderers/BaseDefaultItemRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.ButtonState;
	import feathers.controls.ImageLoader;
	import feathers.controls.ItemRendererLayoutOrder;
	import feathers.controls.Scroller;
	import feathers.controls.ToggleButton;
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IFocusContainer;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IStateObserver;
	import feathers.core.ITextRenderer;
	import feathers.core.IValidating;
	import feathers.core.PropertyProxy;
	import feathers.events.FeathersEventType;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.RelativePosition;
	import feathers.layout.VerticalAlign;
	import feathers.text.FontStylesSet;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;
	import feathers.utils.touch.DelayedDownTouchToState;

	import flash.geom.Point;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.text.TextFormat;

	[Exclude(name="stateToAccessoryFunction",kind="property")]

	/**
	 * The location of the accessory, relative to one of the other children.
	 * Use <code>RelativePosition.MANUAL</code> to position the accessory
	 * from the top-left corner.
	 *
	 * <p>In the following example, the accessory is placed on the bottom:</p>
	 *
	 * <listing version="3.0">
	 * renderer.accessoryPosition = RelativePosition.BOTTOM;</listing>
	 *
	 * @default feathers.layout.RelativePosition.RIGHT
	 *
	 * @see feathers.layout.RelativePosition#TOP
	 * @see feathers.layout.RelativePosition#RIGHT
	 * @see feathers.layout.RelativePosition#BOTTOM
	 * @see feathers.layout.RelativePosition#LEFT
	 * @see feathers.layout.RelativePosition#MANUAL
	 * @see #style:layoutOrder
	 * @see #style:iconPosition
	 */
	[Style(name="accessoryPosition",type="String")]

	/**
	 * Offsets the x position of the accessory by a certain number of pixels.
	 *
	 * <p>In the following example, the accessory x position is adjusted by 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * renderer.accessoryOffsetX = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:accessoryOffsetY
	 */
	[Style(name="accessoryOffsetX",type="Number")]

	/**
	 * Offsets the y position of the accessory by a certain number of pixels.
	 *
	 * <p>In the following example, the accessory y position is adjusted by 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * renderer.accessoryOffsetY = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:accessoryOffsetX
	 */
	[Style(name="accessoryOffsetY",type="Number")]

	/**
	 * The space, in pixels, between the accessory and the other child it is
	 * positioned relative to. Applies to either horizontal or vertical
	 * spacing, depending on the value of <code>accessoryPosition</code>. If
	 * the value is <code>NaN</code>, the value of the <code>gap</code>
	 * property will be used instead.
	 *
	 * <p>If <code>accessoryGap</code> is set to <code>Number.POSITIVE_INFINITY</code>,
	 * the accessory and the component it is relative to will be positioned
	 * as far apart as possible.</p>
	 *
	 * <p>In the following example, the accessory gap is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * renderer.accessoryGap = 20;</listing>
	 *
	 * @default NaN
	 *
	 * @see #style:gap
	 * @see #style:accessoryPosition
	 */
	[Style(name="accessoryGap",type="Number")]

	/**
	 * A style name to add to the item renderer's accessory loader
	 * sub-component. Typically used by a theme to provide different styles
	 * to different item renderers.
	 *
	 * <p>In the following example, a custom accessory loader style name is
	 * passed to the item renderer:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.customAccessoryLoaderStyleName = "my-custom-accessory-loader";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( ImageLoader ).setFunctionForStyleName( "my-custom-accessory-loader", setCustomAccessoryLoaderStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LOADER
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #accessoryLoaderFactory
	 */
	[Style(name="customAccessoryLoaderStyleName",type="String")]

	/**
	 * A style name to add to the item renderer's accessory label text
	 * renderer sub-component. Typically used by a theme to provide
	 * different styles to different item renderers.
	 *
	 * <p>In the following example, a custom accessory label style name is
	 * passed to the item renderer:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.customAccessoryLabelStyleName = "my-custom-accessory-label";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( BitmapFontTextRenderer ).setFunctionForStyleName( "my-custom-accessory-label", setCustomAccessoryLabelStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LABEL
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #accessoryLabelFactory
	 */
	[Style(name="customAccessoryLabelStyleName",type="String")]

	/**
	 * A style name to add to the item renderer's icon loader sub-component.
	 * Typically used by a theme to provide different styles to different
	 * item renderers.
	 *
	 * <p>In the following example, a custom icon loader style name is passed
	 * to the item renderer:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.customIconLodaerStyleName = "my-custom-icon-loader";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( ImageLoader ).setFunctionForStyleName( "my-custom-icon-loader", setCustomIconLoaderStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_ICON_LOADER
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #iconLoaderFactory
	 */
	[Style(name="customIconLoaderStyleName",type="String")]

	/**
	 * A style name to add to the item renderer's icon label text renderer
	 * sub-component. Typically used by a theme to provide  different styles
	 * to different item renderers.
	 *
	 * <p>In the following example, a custom icon label style name is passed
	 * to the item renderer:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.customIconLabelStyleName = "my-custom-icon-label";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( BitmapFontTextRenderer ).setFunctionForStyleName( "my-custom-icon-label", setCustomIconLabelStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_ICON_LABEL
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #iconLabelFactory
	 */
	[Style(name="customIconLabelStyleName",type="String")]

	/**
	 * The accessory's position will be based on which other child (the
	 * label or the icon) the accessory should be relative to.
	 *
	 * <p>The <code>accessoryPositionOrigin</code> property will be ignored
	 * if <code>accessoryPosition</code> is set to <code>RelativePosition.MANUAL</code>.</p>
	 *
	 * <p>In the following example, the layout order is changed:</p>
	 *
	 * <listing version="3.0">
	 * renderer.layoutOrder = ItemRendererLayoutOrder.LABEL_ACCESSORY_ICON;</listing>
	 *
	 * @default feathers.controls.ItemRendererLayoutOrder.LABEL_ICON_ACCESSORY
	 *
	 * @see feathers.controls.ItemRendererLayoutOrder#LABEL_ICON_ACCESSORY
	 * @see feathers.controls.ItemRendererLayoutOrder#LABEL_ACCESSORY_ICON
	 * @see #style:accessoryPosition
	 * @see #style:iconPosition
	 */
	[Style(name="layoutOrder",type="String")]

	/**
	 * If the value of the <code>accessoryGap</code> property is
	 * <code>Number.POSITIVE_INFINITY</code>, meaning that the gap will
	 * fill as much space as possible, the final calculated value will not be
	 * smaller than the value of the <code>minAccessoryGap</code> property.
	 * If the value of <code>minAccessoryGap</code> is <code>NaN</code>, the
	 * value of the <code>minGap</code> property will be used instead.
	 *
	 * <p>The following example ensures that the gap is never smaller than
	 * 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * button.gap = Number.POSITIVE_INFINITY;
	 * button.minGap = 20;</listing>
	 *
	 * <listing version="3.0">
	 * renderer.accessoryGap = 20;</listing>
	 *
	 * @default NaN
	 *
	 * @see #style:accessoryGap
	 */
	[Style(name="minAccessoryGap",type="Number")]

	/**
	 * The font styles used to display the item renderer's icon label text.
	 *
	 * <p>In the following example, the icon label font styles are
	 * customized:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.iconLabelFontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>iconLabelFactory</code> to set more advanced styles.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:iconLabelDisabledFontStyles
	 * @see #style:iconLabelSelectedFontStyles
	 * @see #setIconLabelFontStylesForState()
	 */
	[Style(name="iconLabelFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the item renderer's icon label text
	 * when the item renderer is disabled.
	 *
	 * <p>In the following example, the icon label disabled font styles are
	 * customized:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.iconLabelDisabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>iconLabelFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:iconLabelFontStyles
	 * @see #setIconLabelFontStylesForState()
	 */
	[Style(name="iconLabelDisabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the item renderer's icon label text
	 * when the item renderer is selected.
	 *
	 * <p>In the following example, the icon label selected font styles are
	 * customized:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.iconLabelSelectedFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>iconLabelFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:iconLabelFontStyles
	 * @see #setIconLabelFontStylesForState()
	 */
	[Style(name="iconLabelSelectedFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the item renderer's accessory label
	 * text.
	 *
	 * <p>In the following example, the accessory label font styles are
	 * customized:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.accessoryLabelFontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>accessoryLabelFactory</code> to set more advanced styles.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:accessoryLabelDisabledFontStyles
	 * @see #style:accessoryLabelSelectedFontStyles
	 * @see #setAccessoryLabelFontStylesForState()
	 */
	[Style(name="accessoryLabelFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the item renderer's accessory label
	 * text when the item renderer is disabled.
	 *
	 * <p>In the following example, the accessory label disabled font styles
	 * are customized:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.accessoryLabelDisabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>accessoryLabelFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #accessoryLabelFontStyles
	 * @see #setAccessoryLabelFontStylesForState()
	 */
	[Style(name="accessoryLabelDisabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the item renderer's accessory label
	 * text when the item renderer is selected.
	 *
	 * <p>In the following example, the accessory label selected font styles
	 * are customized:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.accessoryLabelSelectedFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>accessoryLabelFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #accessoryLabelFontStyles
	 * @see #setAccessoryLabelFontStylesForState()
	 */
	[Style(name="accessoryLabelSelectedFontStyles",type="starling.text.TextFormat")]

	/**
	 * If true, the down state (and subsequent state changes) will be delayed
	 * to improve the user experience when scrolling on a touch screen. Without
	 * the delay, the down state will appear immediately and then disappear once
	 * touch-based scrolling begins. This might be described as flickering,
	 * which is typically undesirable.
	 *
	 * <p>In the following example, the state delay timer is disabled:</p>
	 *
	 * <listing version="3.0">
	 * renderer.useStateDelayTimer = false;</listing>
	 *
	 * @default true
	 */
	[Style(name="useStateDelayTimer",type="Boolean")]

	/**
	 * An abstract class for item renderer implementations.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class BaseDefaultItemRenderer extends ToggleButton implements IFocusContainer
	{
		/**
		 * An alternate style name to use with the default item renderer to
		 * allow a theme to give it a "drill-down" style. If a theme
		 * does not provide a style for a drill-down item renderer, the theme
		 * will automatically fall back to using the default item renderer
		 * style.
		 *
		 * <p>An alternate style name should always be added to a component's
		 * <code>styleNameList</code> before the component is initialized. If
		 * the style name is added later, it will be ignored.</p>
		 *
		 * <p>In the following example, the drill-down style is applied to
		 * a list's item renderers:</p>
		 *
		 * <listing version="3.0">
		 * list.itemRendererFactory = function():IListItemRenderer
		 * {
		 *     var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
		 *     itemRenderer.styleNameList.add( DefaultListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN );
		 *     return itemRenderer;
		 * };</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_DRILL_DOWN:String = "feathers-drill-down-item-renderer";

		/**
		 * An alternate style name to use with the default item renderer to
		 * allow a theme to give it a "check" style. If a theme does not provide
		 * a style for a check item renderer, the theme will automatically fall
		 * back to using the default item renderer style.
		 *
		 * <p>An alternate style name should always be added to a component's
		 * <code>styleNameList</code> before the component is initialized. If
		 * the style name is added later, it will be ignored.</p>
		 *
		 * <p>In the following example, the check item renderer style is applied
		 * to a list's item renderers:</p>
		 *
		 * <listing version="3.0">
		 * list.itemRendererFactory = function():IListItemRenderer
		 * {
		 *     var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
		 *     itemRenderer.styleNameList.add( DefaultListItemRenderer.ALTERNATE_STYLE_NAME_CHECK );
		 *     return itemRenderer;
		 * };</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_CHECK:String = "feathers-check-item-renderer";

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * primary label.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_LABEL:String = "feathers-item-renderer-label";

		/**
		 * The default value added to the <code>styleNameList</code> of the icon
		 * label, if it exists.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ICON_LABEL:String = "feathers-item-renderer-icon-label";

		/**
		 * The default value added to the <code>styleNameList</code> of the icon
		 * loader, if it exists.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ICON_LOADER:String = "feathers-item-renderer-icon-loader";

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * accessory label, if it exists.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LABEL:String = "feathers-item-renderer-accessory-label";

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * accessory loader, if it exists.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LOADER:String = "feathers-item-renderer-accessory-loader";

		/**
		 * @private
		 */
		private static const HELPER_POINT:Point = new Point();

		/**
		 * @private
		 */
		protected static function defaultLoaderFactory():ImageLoader
		{
			return new ImageLoader();
		}

		/**
		 * Constructor.
		 */
		public function BaseDefaultItemRenderer()
		{
			super();
			if(this._iconLabelFontStylesSet === null)
			{
				this._iconLabelFontStylesSet = new FontStylesSet();
				this._iconLabelFontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
			if(this._accessoryLabelFontStylesSet === null)
			{
				this._accessoryLabelFontStylesSet = new FontStylesSet();
				this._accessoryLabelFontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
			this._explicitIsEnabled = this._isEnabled;
			this.labelStyleName = DEFAULT_CHILD_STYLE_NAME_LABEL;
			this.isFocusEnabled = false;
			this.isQuickHitAreaEnabled = false;
			this.addEventListener(Event.REMOVED_FROM_STAGE, itemRenderer_removedFromStageHandler);
		}

		/**
		 * The value added to the <code>styleNameList</code> of the icon label
		 * text renderer, if it exists. This variable is <code>protected</code>
		 * so that sub-classes can customize the icon label text renderer style
		 * name in their constructors instead of using the default style name
		 * defined by <code>DEFAULT_CHILD_STYLE_NAME_ICON_LABEL</code>.
		 *
		 * <p>To customize the icon label text renderer style name without
		 * subclassing, see <code>customIconLabelStyleName</code>.</p>
		 *
		 * @see #style:customIconLabelStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var iconLabelStyleName:String = DEFAULT_CHILD_STYLE_NAME_ICON_LABEL;

		/**
		 * The value added to the <code>styleNameList</code> of the icon loader,
		 * if it exists. This variable is <code>protected</code>
		 * so that sub-classes can customize the icon loader style name in their
		 * constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_ICON_LOADER</code>.
		 *
		 * <p>To customize the icon loader style name without subclassing, see
		 * <code>customIconLoaderStyleName</code>.</p>
		 *
		 * @see #style:customIconLoaderStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var iconLoaderStyleName:String = DEFAULT_CHILD_STYLE_NAME_ICON_LOADER;

		/**
		 * The value added to the <code>styleNameList</code> of the accessory
		 * label text renderer, if it exists. This variable is
		 * <code>protected</code> so that sub-classes can customize the
		 * accessory label text renderer style name in their constructors
		 * instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LABEL</code>.
		 *
		 * <p>To customize the accessory label text renderer style name without
		 * subclassing, see <code>customAccessoryLabelStyleName</code>.</p>
		 *
		 * @see #style:customAccessoryLabelStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var accessoryLabelStyleName:String = DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LABEL;

		/**
		 * The value added to the <code>styleNameList</code> of the accessory
		 * loader, if it exists. This variable is <code>protected</code> so that
		 * sub-classes can customize the accessory loader style name in their
		 * constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LOADER</code>.
		 *
		 * <p>To customize the accessory loader style name without subclassing,
		 * see <code>customAccessoryLoaderStyleName</code>.</p>
		 *
		 * @see #style:customAccessoryLoaderStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var accessoryLoaderStyleName:String = DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LOADER;

		/**
		 * @private
		 */
		protected var _isChildFocusEnabled:Boolean = true;

		/**
		 * @copy feathers.core.IFocusContainer#isChildFocusEnabled
		 *
		 * @default true
		 *
		 * @see #isFocusEnabled
		 */
		public function get isChildFocusEnabled():Boolean
		{
			return this._isEnabled && this._isChildFocusEnabled;
		}

		/**
		 * @private
		 */
		public function set isChildFocusEnabled(value:Boolean):void
		{
			this._isChildFocusEnabled = value;
		}

		/**
		 * @private
		 */
		protected var skinLoader:ImageLoader;

		/**
		 * @private
		 */
		protected var iconLoader:ImageLoader;

		/**
		 * @private
		 */
		protected var iconLabel:ITextRenderer;

		/**
		 * @private
		 */
		protected var accessoryLoader:ImageLoader;

		/**
		 * @private
		 */
		protected var accessoryLabel:ITextRenderer;

		/**
		 * @private
		 */
		protected var currentAccessory:DisplayObject;

		/**
		 * @private
		 */
		protected var _skinIsFromItem:Boolean = false;

		/**
		 * @private
		 */
		protected var _iconIsFromItem:Boolean = false;

		/**
		 * @private
		 */
		protected var _accessoryIsFromItem:Boolean = false;

		/**
		 * @private
		 */
		override public function set defaultIcon(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._defaultIcon === value)
			{
				return;
			}
			this.replaceIcon(null);
			this._iconIsFromItem = false;
			super.defaultIcon = value;
		}

		/**
		 * @private
		 */
		override public function set defaultSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._defaultSkin === value)
			{
				return;
			}
			this.replaceSkin(null);
			this._skinIsFromItem = false;
			super.defaultSkin = value;
		}

		/**
		 * @private
		 */
		protected var _data:Object;

		/**
		 * The item displayed by this renderer. This property is set by the
		 * list, and should not be set manually.
		 */
		public function get data():Object
		{
			return this._data;
		}

		/**
		 * @private
		 */
		public function set data(value:Object):void
		{
			//we need to use strict equality here because the data can be
			//non-strictly equal to null
			if(this._data === value)
			{
				return;
			}
			this._data = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _owner:Scroller;

		/**
		 * @private
		 */
		protected var _factoryID:String;

		/**
		 * @copy feathers.controls.renderers.IListItemRenderer#factoryID
		 */
		public function get factoryID():String
		{
			return this._factoryID;
		}

		/**
		 * @private
		 */
		public function set factoryID(value:String):void
		{
			this._factoryID = value;
		}

		/**
		 * @private
		 */
		protected var _useStateDelayTimer:Boolean = true;

		/**
		 * @private
		 */
		public function get useStateDelayTimer():Boolean
		{
			return this._useStateDelayTimer;
		}

		/**
		 * @private
		 */
		public function set useStateDelayTimer(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._useStateDelayTimer = value;
		}

		/**
		 * Determines if the item renderer can be selected even if
		 * <code>isToggle</code> is set to <code>false</code>. Subclasses are
		 * expected to change this value, if required.
		 */
		protected var isSelectableWithoutToggle:Boolean = true;

		/**
		 * @private
		 */
		protected var _itemHasLabel:Boolean = true;

		/**
		 * If true, the label will come from the renderer's item using the
		 * appropriate field or function for the label. If false, the label may
		 * be set externally.
		 *
		 * <p>In the following example, the item doesn't have a label:</p>
		 *
		 * <listing version="3.0">
		 * renderer.itemHasLabel = false;</listing>
		 *
		 * @default true
		 *
		 * @see #labelField
		 * @see #labelFunction
		 * @see #label
		 */
		public function get itemHasLabel():Boolean
		{
			return this._itemHasLabel;
		}

		/**
		 * @private
		 */
		public function set itemHasLabel(value:Boolean):void
		{
			if(this._itemHasLabel == value)
			{
				return;
			}
			this._itemHasLabel = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _itemHasIcon:Boolean = true;

		/**
		 * If true, the icon will come from the renderer's item using the
		 * appropriate field or function for the icon. If false, the icon may
		 * be skinned for each state externally.
		 *
		 * <p>In the following example, the item doesn't have an icon:</p>
		 *
		 * <listing version="3.0">
		 * renderer.itemHasIcon = false;</listing>
		 *
		 * @default true
		 */
		public function get itemHasIcon():Boolean
		{
			return this._itemHasIcon;
		}

		/**
		 * @private
		 */
		public function set itemHasIcon(value:Boolean):void
		{
			if(this._itemHasIcon == value)
			{
				return;
			}
			this._itemHasIcon = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _itemHasAccessory:Boolean = true;

		/**
		 * If true, the accessory will come from the renderer's item using the
		 * appropriate field or function for the accessory. If false, the
		 * accessory may be set using other means.
		 *
		 * <p>In the following example, the item doesn't have an accessory:</p>
		 *
		 * <listing version="3.0">
		 * renderer.itemHasAccessory = false;</listing>
		 *
		 * @default true
		 */
		public function get itemHasAccessory():Boolean
		{
			return this._itemHasAccessory;
		}

		/**
		 * @private
		 */
		public function set itemHasAccessory(value:Boolean):void
		{
			if(this._itemHasAccessory == value)
			{
				return;
			}
			this._itemHasAccessory = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _itemHasSkin:Boolean = false;

		/**
		 * If true, the skin will come from the renderer's item using the
		 * appropriate field or function for the skin. If false, the skin may
		 * be set for each state externally.
		 *
		 * <p>In the following example, the item has a skin:</p>
		 *
		 * <listing version="3.0">
		 * renderer.itemHasSkin = true;
		 * renderer.skinField = "background";</listing>
		 *
		 * @default false
		 */
		public function get itemHasSkin():Boolean
		{
			return this._itemHasSkin;
		}

		/**
		 * @private
		 */
		public function set itemHasSkin(value:Boolean):void
		{
			if(this._itemHasSkin == value)
			{
				return;
			}
			this._itemHasSkin = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _itemHasSelectable:Boolean = false;

		/**
		 * If true, the ability to select the renderer will come from the
		 * renderer's item using the appropriate field or function for
		 * selectable. If false, the renderer will be selectable if its owner
		 * is selectable.
		 *
		 * <p>In the following example, the item doesn't have an accessory:</p>
		 *
		 * <listing version="3.0">
		 * renderer.itemHasSelectable = true;</listing>
		 *
		 * @default false
		 *
		 * @see #selectableField
		 * @see #selectableFunction
		 */
		public function get itemHasSelectable():Boolean
		{
			return this._itemHasSelectable;
		}

		/**
		 * @private
		 */
		public function set itemHasSelectable(value:Boolean):void
		{
			if(this._itemHasSelectable == value)
			{
				return;
			}
			this._itemHasSelectable = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _itemHasEnabled:Boolean = false;

		/**
		 * If true, the renderer's enabled state will come from the renderer's
		 * item using the appropriate field or function for enabled. If false,
		 * the renderer will be enabled if its owner is enabled.
		 *
		 * <p>In the following example, the item doesn't have an accessory:</p>
		 *
		 * <listing version="3.0">
		 * renderer.itemHasEnabled = true;</listing>
		 *
		 * @default false
		 *
		 * @see #enabledField
		 * @see #enabledFunction
		 */
		public function get itemHasEnabled():Boolean
		{
			return this._itemHasEnabled;
		}

		/**
		 * @private
		 */
		public function set itemHasEnabled(value:Boolean):void
		{
			if(this._itemHasEnabled == value)
			{
				return;
			}
			this._itemHasEnabled = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _accessoryPosition:String = RelativePosition.RIGHT;

		[Inspectable(type="String",enumeration="top,right,bottom,left,manual")]
		/**
		 * @private
		 */
		public function get accessoryPosition():String
		{
			return this._accessoryPosition;
		}

		/**
		 * @private
		 */
		public function set accessoryPosition(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._accessoryPosition === value)
			{
				return;
			}
			this._accessoryPosition = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _layoutOrder:String = ItemRendererLayoutOrder.LABEL_ICON_ACCESSORY;

		[Inspectable(type="String",enumeration="labelIconAccessory,labelAccessoryIcon")]
		/**
		 * @private
		 */
		public function get layoutOrder():String
		{
			return this._layoutOrder;
		}

		/**
		 * @private
		 */
		public function set layoutOrder(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._layoutOrder === value)
			{
				return;
			}
			this._layoutOrder = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _accessoryOffsetX:Number = 0;

		/**
		 * @private
		 */
		public function get accessoryOffsetX():Number
		{
			return this._accessoryOffsetX;
		}

		/**
		 * @private
		 */
		public function set accessoryOffsetX(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._accessoryOffsetX == value)
			{
				return;
			}
			this._accessoryOffsetX = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _accessoryOffsetY:Number = 0;

		/**
		 * @private
		 */
		public function get accessoryOffsetY():Number
		{
			return this._accessoryOffsetY;
		}

		/**
		 * @private
		 */
		public function set accessoryOffsetY(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._accessoryOffsetY == value)
			{
				return;
			}
			this._accessoryOffsetY = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _accessoryGap:Number = NaN;

		/**
		 * @private
		 */
		public function get accessoryGap():Number
		{
			return this._accessoryGap;
		}

		/**
		 * @private
		 */
		public function set accessoryGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._accessoryGap == value)
			{
				return;
			}
			this._accessoryGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _minAccessoryGap:Number = NaN;

		/**
		 * @private
		 */
		public function get minAccessoryGap():Number
		{
			return this._minAccessoryGap;
		}

		/**
		 * @private
		 */
		public function set minAccessoryGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._minAccessoryGap == value)
			{
				return;
			}
			this._minAccessoryGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _defaultAccessory:DisplayObject;

		/**
		 * The accessory used when no other accessory is defined for the current
		 * state. Intended to be used when multiple states should share the same
		 * accessory.
		 *
		 * <p>This property will be ignored if a function is passed to the
		 * <code>stateToAccessoryFunction</code> property. This property may be
		 * ignored if the <code>itemHasAccessory</code> property is
		 * <code>true</code>.</p>
		 *
		 * <p>The following example gives the item renderer a default accessory
		 * to use for all states when no specific accessory is available:</p>
		 *
		 * <listing version="3.0">
		 * itemRenderer.defaultAccessory = new Image( texture );</listing>
		 *
		 * @default null
		 *
		 * @see #setAccessoryForState()
		 * @see #itemHasAccessory
		 */
		public function get defaultAccessory():DisplayObject
		{
			return this._defaultAccessory;
		}

		/**
		 * @private
		 */
		public function set defaultAccessory(value:DisplayObject):void
		{
			if(this._defaultAccessory === value)
			{
				return;
			}
			this.replaceAccessory(null);
			this._accessoryIsFromItem = false;
			this._defaultAccessory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _stateToAccessory:Object = {};

		/**
		 * @private
		 */
		protected var accessoryTouchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _stopScrollingOnAccessoryTouch:Boolean = true;

		/**
		 * If enabled, calls owner.stopScrolling() when TouchEvents are
		 * dispatched by the accessory.
		 *
		 * <p>In the following example, the list won't stop scrolling when the
		 * accessory is touched:</p>
		 *
		 * <listing version="3.0">
		 * renderer.stopScrollingOnAccessoryTouch = false;</listing>
		 *
		 * @default true
		 */
		public function get stopScrollingOnAccessoryTouch():Boolean
		{
			return this._stopScrollingOnAccessoryTouch;
		}

		/**
		 * @private
		 */
		public function set stopScrollingOnAccessoryTouch(value:Boolean):void
		{
			this._stopScrollingOnAccessoryTouch = value;
		}

		/**
		 * @private
		 */
		protected var _isSelectableOnAccessoryTouch:Boolean = false;

		/**
		 * If enabled, the item renderer may be selected by touching the
		 * accessory. By default, the accessory will not trigger selection when
		 * using <code>defaultAccessory</code>, <code>accessoryField</code>, or
		 * <code>accessoryFunction</code> and the accessory is a Feathers
		 * component.
		 *
		 * <p>In the following example, the item renderer can be selected when
		 * the accessory is touched:</p>
		 *
		 * <listing version="3.0">
		 * renderer.isSelectableOnAccessoryTouch = true;</listing>
		 *
		 * @default false
		 */
		public function get isSelectableOnAccessoryTouch():Boolean
		{
			return this._isSelectableOnAccessoryTouch;
		}

		/**
		 * @private
		 */
		public function set isSelectableOnAccessoryTouch(value:Boolean):void
		{
			this._isSelectableOnAccessoryTouch = value;
		}

		/**
		 * @private
		 */
		protected var _delayTextureCreationOnScroll:Boolean = false;

		/**
		 * If enabled, automatically manages the <code>delayTextureCreation</code>
		 * property on accessory and icon <code>ImageLoader</code> instances
		 * when the owner scrolls. This applies to the loaders created when the
		 * following properties are set: <code>accessorySourceField</code>,
		 * <code>accessorySourceFunction</code>, <code>iconSourceField</code>,
		 * and <code>iconSourceFunction</code>.
		 *
		 * <p>In the following example, any loaded textures won't be uploaded to
		 * the GPU until the owner stops scrolling:</p>
		 *
		 * <listing version="3.0">
		 * renderer.delayTextureCreationOnScroll = true;</listing>
		 *
		 * @default false
		 */
		public function get delayTextureCreationOnScroll():Boolean
		{
			return this._delayTextureCreationOnScroll;
		}

		/**
		 * @private
		 */
		public function set delayTextureCreationOnScroll(value:Boolean):void
		{
			this._delayTextureCreationOnScroll = value;
		}

		/**
		 * @private
		 */
		protected var _labelField:String = "label";

		/**
		 * The field in the item that contains the label text to be displayed by
		 * the renderer. If the item does not have this field, and a
		 * <code>labelFunction</code> is not defined, then the renderer will
		 * default to calling <code>toString()</code> on the item. To omit the
		 * label completely, either provide a custom item renderer without a
		 * label or define a <code>labelFunction</code> that returns an empty
		 * string.
		 *
		 * <p>All of the label fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>labelFunction</code></li>
		 *     <li><code>labelField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the label field is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.labelField = "text";</listing>
		 *
		 * @default "label"
		 *
		 * @see #labelFunction
		 */
		public function get labelField():String
		{
			return this._labelField;
		}

		/**
		 * @private
		 */
		public function set labelField(value:String):void
		{
			if(this._labelField == value)
			{
				return;
			}
			this._labelField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _labelFunction:Function;

		/**
		 * A function used to generate label text for a specific item. If this
		 * function is not null, then the <code>labelField</code> will be
		 * ignored.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):String</pre>
		 *
		 * <p>If the item renderer is an <code>IListItemRenderer</code>, the
		 * function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, index:int ):String</pre>
		 *
		 * <p>If the item renderer is an <code>IGroupedListItemRenderer</code>,
		 * the function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, groupIndex:int, itemIndex:int ):String</pre>
		 *
		 * <p>All of the label fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>labelFunction</code></li>
		 *     <li><code>labelField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the label function is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.labelFunction = function( item:Object ):String
		 * {
		 *    return item.firstName + " " + item.lastName;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #labelField
		 */
		public function get labelFunction():Function
		{
			return this._labelFunction;
		}

		/**
		 * @private
		 */
		public function set labelFunction(value:Function):void
		{
			if(this._labelFunction == value)
			{
				return;
			}
			this._labelFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _iconField:String = "icon";

		/**
		 * The field in the item that contains a display object to be displayed
		 * as an icon or other graphic next to the label in the renderer.
		 *
		 * <p>Warning: It is your responsibility to dispose all icons
		 * included in the data provider and accessed with <code>iconField</code>,
		 * or any display objects returned by <code>iconFunction</code>.
		 * These display objects will not be disposed when the list is disposed.
		 * Not disposing an icon may result in a memory leak.</p>
		 *
		 * <p>All of the icon fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>iconSourceFunction</code></li>
		 *     <li><code>iconSourceField</code></li>
		 *     <li><code>iconLabelFunction</code></li>
		 *     <li><code>iconLabelField</code></li>
		 *     <li><code>iconFunction</code></li>
		 *     <li><code>iconField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the icon field is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.iconField = "photo";</listing>
		 *
		 * @default "icon"
		 *
		 * @see #itemHasIcon
		 * @see #iconFunction
		 * @see #iconSourceField
		 * @see #iconSourceFunction
		 */
		public function get iconField():String
		{
			return this._iconField;
		}

		/**
		 * @private
		 */
		public function set iconField(value:String):void
		{
			if(this._iconField == value)
			{
				return;
			}
			this._iconField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _iconFunction:Function;

		/**
		 * A function used to generate an icon for a specific item.
		 *
		 * <p>Note: As the list scrolls, this function will almost always be
		 * called more than once for each individual item in the list's data
		 * provider. Your function should not simply return a new icon every
		 * time. This will result in the unnecessary creation and destruction of
		 * many icons, which will overwork the garbage collector and hurt
		 * performance. It's better to return a new icon the first time this
		 * function is called for a particular item and then return the same
		 * icon if that item is passed to this function again.</p>
		 *
		 * <p>Warning: It is your responsibility to dispose all icons
		 * included in the data provider and accessed with <code>iconField</code>,
		 * or any display objects returned by <code>iconFunction</code>.
		 * These display objects will not be disposed when the list is disposed.
		 * Not disposing an icon may result in a memory leak.</p>
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):DisplayObject</pre>
		 *
		 * <p>If the item renderer is an <code>IListItemRenderer</code>, the
		 * function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, index:int ):DisplayObject</pre>
		 *
		 * <p>If the item renderer is an <code>IGroupedListItemRenderer</code>,
		 * the function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, groupIndex:int, itemIndex:int ):DisplayObject</pre>
		 *
		 * <p>All of the icon fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>iconSourceFunction</code></li>
		 *     <li><code>iconSourceField</code></li>
		 *     <li><code>iconLabelFunction</code></li>
		 *     <li><code>iconLabelField</code></li>
		 *     <li><code>iconFunction</code></li>
		 *     <li><code>iconField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the icon function is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.iconFunction = function( item:Object ):DisplayObject
		 * {
		 *    if(item in cachedIcons)
		 *    {
		 *        return cachedIcons[item];
		 *    }
		 *    var icon:Image = new Image( textureAtlas.getTexture( item.textureName ) );
		 *    cachedIcons[item] = icon;
		 *    return icon;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #itemHasIcon
		 * @see #iconField
		 * @see #iconSourceField
		 * @see #iconSourceFunction
		 */
		public function get iconFunction():Function
		{
			return this._iconFunction;
		}

		/**
		 * @private
		 */
		public function set iconFunction(value:Function):void
		{
			if(this._iconFunction == value)
			{
				return;
			}
			this._iconFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _iconSourceField:String = "iconSource";

		/**
		 * The field in the item that contains a <code>starling.textures.Texture</code>
		 * or a URL that points to a bitmap to be used as the item renderer's
		 * icon. The renderer will automatically manage and reuse an internal
		 * <code>ImageLoader</code> sub-component and this value will be passed
		 * to the <code>source</code> property. The <code>ImageLoader</code> may
		 * be customized by changing the <code>iconLoaderFactory</code>.
		 *
		 * <p>Using an icon source will result in better performance than
		 * passing in an <code>ImageLoader</code> or <code>Image</code> through
		 * a <code>iconField</code> or <code>iconFunction</code>
		 * because the renderer can avoid costly display list manipulation.</p>
		 *
		 * <p>All of the icon fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>iconSourceFunction</code></li>
		 *     <li><code>iconSourceField</code></li>
		 *     <li><code>iconLabelFunction</code></li>
		 *     <li><code>iconLabelField</code></li>
		 *     <li><code>iconFunction</code></li>
		 *     <li><code>iconField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the icon source field is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.iconSourceField = "texture";</listing>
		 *
		 * @default "iconSource"
		 *
		 * @see feathers.controls.ImageLoader#source
		 * @see #itemHasIcon
		 * @see #iconLoaderFactory
		 * @see #iconSourceFunction
		 * @see #iconField
		 * @see #iconFunction
		 */
		public function get iconSourceField():String
		{
			return this._iconSourceField;
		}

		/**
		 * @private
		 */
		public function set iconSourceField(value:String):void
		{
			if(this._iconSourceField == value)
			{
				return;
			}
			this._iconSourceField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _iconSourceFunction:Function;

		/**
		 * A function used to generate a <code>starling.textures.Texture</code>
		 * or a URL that points to a bitmap to be used as the item renderer's
		 * icon. The renderer will automatically manage and reuse an internal
		 * <code>ImageLoader</code> sub-component and this value will be passed
		 * to the <code>source</code> property. The <code>ImageLoader</code> may
		 * be customized by changing the <code>iconLoaderFactory</code>.
		 *
		 * <p>Using an icon source will result in better performance than
		 * passing in an <code>ImageLoader</code> or <code>Image</code> through
		 * a <code>iconField</code> or <code>iconFunction</code>
		 * because the renderer can avoid costly display list manipulation.</p>
		 *
		 * <p>Note: As the list scrolls, this function will almost always be
		 * called more than once for each individual item in the list's data
		 * provider. Your function should not simply return a new texture every
		 * time. This will result in the unnecessary creation and destruction of
		 * many textures, which will overwork the garbage collector and hurt
		 * performance. Creating a new texture at all is dangerous, unless you
		 * are absolutely sure to dispose it when necessary because neither the
		 * list nor its item renderer will dispose of the texture for you. If
		 * you are absolutely sure that you are managing the texture memory with
		 * proper disposal, it's better to return a new texture the first
		 * time this function is called for a particular item and then return
		 * the same texture if that item is passed to this function again.</p>
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):Object</pre>
		 *
		 * <p>If the item renderer is an <code>IListItemRenderer</code>, the
		 * function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, index:int ):Object</pre>
		 *
		 * <p>If the item renderer is an <code>IGroupedListItemRenderer</code>,
		 * the function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, groupIndex:int, itemIndex:int ):Object</pre>
		 *
		 * <p>The return value is a valid value for the <code>source</code>
		 * property of an <code>ImageLoader</code> component.</p>
		 *
		 * <p>All of the icon fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>iconSourceFunction</code></li>
		 *     <li><code>iconSourceField</code></li>
		 *     <li><code>iconLabelFunction</code></li>
		 *     <li><code>iconLabelField</code></li>
		 *     <li><code>iconFunction</code></li>
		 *     <li><code>iconField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the icon source function is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.iconSourceFunction = function( item:Object ):Object
		 * {
		 *    return "http://www.example.com/thumbs/" + item.name + "-thumb.png";
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.ImageLoader#source
		 * @see #itemHasIcon
		 * @see #iconLoaderFactory
		 * @see #iconSourceField
		 * @see #iconField
		 * @see #iconFunction
		 */
		public function get iconSourceFunction():Function
		{
			return this._iconSourceFunction;
		}

		/**
		 * @private
		 */
		public function set iconSourceFunction(value:Function):void
		{
			if(this._iconSourceFunction == value)
			{
				return;
			}
			this._iconSourceFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _iconLabelField:String = "iconLabel";

		/**
		 * The field in the item that contains a string to be displayed in a
		 * renderer-managed <code>ITextRenderer</code> in the icon position of
		 * the renderer. The renderer will automatically reuse an internal
		 * <code>ITextRenderer</code> and swap the text when the data changes.
		 * This <code>ITextRenderer</code> may be skinned by changing the
		 * <code>iconLabelFactory</code>.
		 *
		 * <p>Using an icon label will result in better performance than
		 * passing in an <code>ITextRenderer</code> through a <code>iconField</code>
		 * or <code>iconFunction</code> because the renderer can avoid
		 * costly display list manipulation.</p>
		 *
		 * <p>All of the icon fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>iconSourceFunction</code></li>
		 *     <li><code>iconSourceField</code></li>
		 *     <li><code>iconLabelFunction</code></li>
		 *     <li><code>iconLabelField</code></li>
		 *     <li><code>iconFunction</code></li>
		 *     <li><code>iconField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the icon label field is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.iconLabelField = "text";</listing>
		 *
		 * @default "iconLabel"
		 *
		 * @see #itemHasIcon
		 * @see #iconLabelFactory
		 * @see #iconLabelFunction
		 * @see #iconField
		 * @see #iconFunction
		 * @see #iconySourceField
		 * @see #iconSourceFunction
		 */
		public function get iconLabelField():String
		{
			return this._iconLabelField;
		}

		/**
		 * @private
		 */
		public function set iconLabelField(value:String):void
		{
			if(this._iconLabelField == value)
			{
				return;
			}
			this._iconLabelField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _iconLabelFunction:Function;

		/**
		 * A function that returns a string to be displayed in a
		 * renderer-managed <code>ITextRenderer</code> in the icon position of
		 * the renderer. The renderer will automatically reuse an internal
		 * <code>ITextRenderer</code> and swap the text when the data changes.
		 * This <code>ITextRenderer</code> may be skinned by changing the
		 * <code>iconLabelFactory</code>.
		 *
		 * <p>Using an icon label will result in better performance than
		 * passing in an <code>ITextRenderer</code> through a <code>iconField</code>
		 * or <code>iconFunction</code> because the renderer can avoid costly
		 * display list manipulation.</p>
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):String</pre>
		 *
		 * <p>If the item renderer is an <code>IListItemRenderer</code>, the
		 * function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, index:int ):String</pre>
		 *
		 * <p>If the item renderer is an <code>IGroupedListItemRenderer</code>,
		 * the function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, groupIndex:int, itemIndex:int ):String</pre>
		 *
		 * <p>All of the icon fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>iconSourceFunction</code></li>
		 *     <li><code>iconSourceField</code></li>
		 *     <li><code>iconLabelFunction</code></li>
		 *     <li><code>iconLabelField</code></li>
		 *     <li><code>iconFunction</code></li>
		 *     <li><code>iconField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the icon label function is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.iconLabelFunction = function( item:Object ):String
		 * {
		 *    return item.firstName + " " + item.lastName;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #itemHasIcon
		 * @see #iconLabelFactory
		 * @see #iconLabelField
		 * @see #iconField
		 * @see #iconFunction
		 * @see #iconSourceField
		 * @see #iconSourceFunction
		 */
		public function get iconLabelFunction():Function
		{
			return this._iconLabelFunction;
		}

		/**
		 * @private
		 */
		public function set iconLabelFunction(value:Function):void
		{
			if(this._iconLabelFunction == value)
			{
				return;
			}
			this._iconLabelFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _customIconLoaderStyleName:String;

		/**
		 * @private
		 */
		public function get customIconLoaderStyleName():String
		{
			return this._customIconLoaderStyleName;
		}

		/**
		 * @private
		 */
		public function set customIconLoaderStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customIconLoaderStyleName === value)
			{
				return;
			}
			this._customIconLoaderStyleName = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _customIconLabelStyleName:String;

		/**
		 * @private
		 */
		public function get customIconLabelStyleName():String
		{
			return this._customIconLabelStyleName;
		}

		/**
		 * @private
		 */
		public function set customIconLabelStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customIconLabelStyleName === value)
			{
				return;
			}
			this._customIconLabelStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _accessoryField:String = "accessory";

		/**
		 * The field in the item that contains a display object to be positioned
		 * in the accessory position of the renderer. If you wish to display an
		 * <code>Image</code> in the accessory position, it's better for
		 * performance to use <code>accessorySourceField</code> instead.
		 *
		 * <p>Warning: It is your responsibility to dispose all accessories
		 * included in the data provider and accessed with <code>accessoryField</code>,
		 * or any display objects returned by <code>accessoryFunction</code>.
		 * These display objects will not be disposed when the list is disposed.
		 * Not disposing an accessory may result in a memory leak.</p>
		 *
		 * <p>All of the accessory fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>accessorySourceFunction</code></li>
		 *     <li><code>accessorySourceField</code></li>
		 *     <li><code>accessoryLabelFunction</code></li>
		 *     <li><code>accessoryLabelField</code></li>
		 *     <li><code>accessoryFunction</code></li>
		 *     <li><code>accessoryField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the accessory field is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.accessoryField = "component";</listing>
		 *
		 * @default "accessory"
		 *
		 * @see #itemHasAccessory
		 * @see #accessorySourceField
		 * @see #accessoryFunction
		 * @see #accessorySourceFunction
		 * @see #accessoryLabelField
		 * @see #accessoryLabelFunction
		 */
		public function get accessoryField():String
		{
			return this._accessoryField;
		}

		/**
		 * @private
		 */
		public function set accessoryField(value:String):void
		{
			if(this._accessoryField == value)
			{
				return;
			}
			this._accessoryField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _accessoryFunction:Function;

		/**
		 * A function that returns a display object to be positioned in the
		 * accessory position of the renderer. If you wish to display an
		 * <code>Image</code> in the accessory position, it's better for
		 * performance to use <code>accessorySourceFunction</code> instead.
		 *
		 * <p>Note: As the list scrolls, this function will almost always be
		 * called more than once for each individual item in the list's data
		 * provider. Your function should not simply return a new accessory
		 * every time. This will result in the unnecessary creation and
		 * destruction of many icons, which will overwork the garbage collector
		 * and hurt performance. It's better to return a new accessory the first
		 * time this function is called for a particular item and then return
		 * the same accessory if that item is passed to this function again.</p>
		 *
		 * <p>Warning: It is your responsibility to dispose all accessories
		 * included in the data provider and accessed with <code>accessoryField</code>,
		 * or any display objects returned by <code>accessoryFunction</code>.
		 * These display objects will not be disposed when the list is disposed.
		 * Not disposing an accessory may result in a memory leak.</p>
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):DisplayObject</pre>
		 *
		 * <p>If the item renderer is an <code>IListItemRenderer</code>, the
		 * function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, index:int ):DisplayObject</pre>
		 *
		 * <p>If the item renderer is an <code>IGroupedListItemRenderer</code>,
		 * the function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, groupIndex:int, itemIndex:int ):DisplayObject</pre>
		 *
		 * <p>All of the accessory fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>accessorySourceFunction</code></li>
		 *     <li><code>accessorySourceField</code></li>
		 *     <li><code>accessoryLabelFunction</code></li>
		 *     <li><code>accessoryLabelField</code></li>
		 *     <li><code>accessoryFunction</code></li>
		 *     <li><code>accessoryField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the accessory function is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.accessoryFunction = function( item:Object ):DisplayObject
		 * {
		 *    if(item in cachedAccessories)
		 *    {
		 *        return cachedAccessories[item];
		 *    }
		 *    var accessory:DisplayObject = createAccessoryForItem( item );
		 *    cachedAccessories[item] = accessory;
		 *    return accessory;
		 * };</listing>
		 *
		 * @default null
		 **
		 * @see #itemHasAccessory
		 * @see #accessoryField
		 * @see #accessorySourceField
		 * @see #accessorySourceFunction
		 * @see #accessoryLabelField
		 * @see #accessoryLabelFunction
		 */
		public function get accessoryFunction():Function
		{
			return this._accessoryFunction;
		}

		/**
		 * @private
		 */
		public function set accessoryFunction(value:Function):void
		{
			if(this._accessoryFunction == value)
			{
				return;
			}
			this._accessoryFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _accessorySourceField:String = "accessorySource";

		/**
		 * A field in the item that contains a <code>starling.textures.Texture</code>
		 * or a URL that points to a bitmap to be used as the item renderer's
		 * accessory. The renderer will automatically manage and reuse an internal
		 * <code>ImageLoader</code> sub-component and this value will be passed
		 * to the <code>source</code> property. The <code>ImageLoader</code> may
		 * be customized by changing the <code>accessoryLoaderFactory</code>.
		 *
		 * <p>Using an accessory source will result in better performance than
		 * passing in an <code>ImageLoader</code> or <code>Image</code> through
		 * a <code>accessoryField</code> or <code>accessoryFunction</code> because
		 * the renderer can avoid costly display list manipulation.</p>
		 *
		 * <p>All of the accessory fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>accessorySourceFunction</code></li>
		 *     <li><code>accessorySourceField</code></li>
		 *     <li><code>accessoryLabelFunction</code></li>
		 *     <li><code>accessoryLabelField</code></li>
		 *     <li><code>accessoryFunction</code></li>
		 *     <li><code>accessoryField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the accessory source field is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.accessorySourceField = "texture";</listing>
		 *
		 * @default "accessorySource"
		 *
		 * @see feathers.controls.ImageLoader#source
		 * @see #itemHasAccessory
		 * @see #accessoryLoaderFactory
		 * @see #accessorySourceFunction
		 * @see #accessoryField
		 * @see #accessoryFunction
		 * @see #accessoryLabelField
		 * @see #accessoryLabelFunction
		 */
		public function get accessorySourceField():String
		{
			return this._accessorySourceField;
		}

		/**
		 * @private
		 */
		public function set accessorySourceField(value:String):void
		{
			if(this._accessorySourceField == value)
			{
				return;
			}
			this._accessorySourceField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _accessorySourceFunction:Function;

		/**
		 * A function that generates a <code>starling.textures.Texture</code>
		 * or a URL that points to a bitmap to be used as the item renderer's
		 * accessory. The renderer will automatically manage and reuse an internal
		 * <code>ImageLoader</code> sub-component and this value will be passed
		 * to the <code>source</code> property. The <code>ImageLoader</code> may
		 * be customized by changing the <code>accessoryLoaderFactory</code>.
		 *
		 * <p>Using an accessory source will result in better performance than
		 * passing in an <code>ImageLoader</code> or <code>Image</code> through
		 * a <code>accessoryField</code> or <code>accessoryFunction</code>
		 * because the renderer can avoid costly display list manipulation.</p>
		 *
		 * <p>Note: As the list scrolls, this function will almost always be
		 * called more than once for each individual item in the list's data
		 * provider. Your function should not simply return a new texture every
		 * time. This will result in the unnecessary creation and destruction of
		 * many textures, which will overwork the garbage collector and hurt
		 * performance. Creating a new texture at all is dangerous, unless you
		 * are absolutely sure to dispose it when necessary because neither the
		 * list nor its item renderer will dispose of the texture for you. If
		 * you are absolutely sure that you are managing the texture memory with
		 * proper disposal, it's better to return a new texture the first
		 * time this function is called for a particular item and then return
		 * the same texture if that item is passed to this function again.</p>
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):Object</pre>
		 *
		 * <p>If the item renderer is an <code>IListItemRenderer</code>, the
		 * function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, index:int ):Object</pre>
		 *
		 * <p>If the item renderer is an <code>IGroupedListItemRenderer</code>,
		 * the function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, groupIndex:int, itemIndex:int ):Object</pre>
		 *
		 * <p>The return value is a valid value for the <code>source</code>
		 * property of an <code>ImageLoader</code> component.</p>
		 *
		 * <p>All of the accessory fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>accessorySourceFunction</code></li>
		 *     <li><code>accessorySourceField</code></li>
		 *     <li><code>accessoryLabelFunction</code></li>
		 *     <li><code>accessoryLabelField</code></li>
		 *     <li><code>accessoryFunction</code></li>
		 *     <li><code>accessoryField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the accessory source function is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.accessorySourceFunction = function( item:Object ):Object
		 * {
		 *    return "http://www.example.com/thumbs/" + item.name + "-thumb.png";
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.ImageLoader#source
		 * @see #itemHasAccessory
		 * @see #accessoryLoaderFactory
		 * @see #accessorySourceField
		 * @see #accessoryField
		 * @see #accessoryFunction
		 * @see #accessoryLabelField
		 * @see #accessoryLabelFunction
		 */
		public function get accessorySourceFunction():Function
		{
			return this._accessorySourceFunction;
		}

		/**
		 * @private
		 */
		public function set accessorySourceFunction(value:Function):void
		{
			if(this._accessorySourceFunction == value)
			{
				return;
			}
			this._accessorySourceFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _accessoryLabelField:String = "accessoryLabel";

		/**
		 * The field in the item that contains a string to be displayed in a
		 * renderer-managed <code>ITextRenderer</code> in the accessory position
		 * of the renderer. The renderer will automatically reuse an internal
		 * <code>ITextRenderer</code> and swap the text when the data changes.
		 * This <code>ITextRenderer</code> may be skinned by changing the
		 * <code>accessoryLabelFactory</code>.
		 *
		 * <p>Using an accessory label will result in better performance than
		 * passing in a <code>ITextRenderer</code> through an <code>accessoryField</code>
		 * or <code>accessoryFunction</code> because the renderer can avoid
		 * costly display list manipulation.</p>
		 *
		 * <p>All of the accessory fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>accessorySourceFunction</code></li>
		 *     <li><code>accessorySourceField</code></li>
		 *     <li><code>accessoryLabelFunction</code></li>
		 *     <li><code>accessoryLabelField</code></li>
		 *     <li><code>accessoryFunction</code></li>
		 *     <li><code>accessoryField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the accessory label field is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.accessoryLabelField = "text";</listing>
		 *
		 * @default "accessoryLabel"
		 **
		 * @see #itemHasAccessory
		 * @see #accessoryLabelFactory
		 * @see #accessoryLabelFunction
		 * @see #accessoryField
		 * @see #accessoryFunction
		 * @see #accessorySourceField
		 * @see #accessorySourceFunction
		 */
		public function get accessoryLabelField():String
		{
			return this._accessoryLabelField;
		}

		/**
		 * @private
		 */
		public function set accessoryLabelField(value:String):void
		{
			if(this._accessoryLabelField == value)
			{
				return;
			}
			this._accessoryLabelField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _accessoryLabelFunction:Function;

		/**
		 * A function that returns a string to be displayed in a
		 * renderer-managed <code>ITextRenderer</code> in the accessory position
		 * of the renderer. The renderer will automatically reuse an internal
		 * <code>ITextRenderer</code> and swap the text when the data changes.
		 * This <code>ITextRenderer</code> may be skinned by changing the
		 * <code>accessoryLabelFactory</code>.
		 *
		 * <p>Using an accessory label will result in better performance than
		 * passing in an <code>ITextRenderer</code> through an <code>accessoryField</code>
		 * or <code>accessoryFunction</code> because the renderer can avoid
		 * costly display list manipulation.</p>
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):String</pre>
		 *
		 * <p>If the item renderer is an <code>IListItemRenderer</code>, the
		 * function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, index:int ):String</pre>
		 *
		 * <p>If the item renderer is an <code>IGroupedListItemRenderer</code>,
		 * the function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, groupIndex:int, itemIndex:int ):String</pre>
		 *
		 * <p>All of the accessory fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>accessorySourceFunction</code></li>
		 *     <li><code>accessorySourceField</code></li>
		 *     <li><code>accessoryLabelFunction</code></li>
		 *     <li><code>accessoryLabelField</code></li>
		 *     <li><code>accessoryFunction</code></li>
		 *     <li><code>accessoryField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the accessory label function is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.accessoryLabelFunction = function( item:Object ):String
		 * {
		 *    return item.firstName + " " + item.lastName;
		 * };</listing>
		 *
		 * @default null
		 **
		 * @see #itemHasAccessory
		 * @see #accessoryLabelFactory
		 * @see #accessoryLabelField
		 * @see #accessoryField
		 * @see #accessoryFunction
		 * @see #accessorySourceField
		 * @see #accessorySourceFunction
		 */
		public function get accessoryLabelFunction():Function
		{
			return this._accessoryLabelFunction;
		}

		/**
		 * @private
		 */
		public function set accessoryLabelFunction(value:Function):void
		{
			if(this._accessoryLabelFunction == value)
			{
				return;
			}
			this._accessoryLabelFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _customAccessoryLabelStyleName:String;

		/**
		 * @private
		 */
		public function get customAccessoryLabelStyleName():String
		{
			return this._customAccessoryLabelStyleName;
		}

		/**
		 * @private
		 */
		public function set customAccessoryLabelStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customAccessoryLabelStyleName === value)
			{
				return;
			}
			this._customAccessoryLabelStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _customAccessoryLoaderStyleName:String;

		/**
		 * @private
		 */
		public function get customAccessoryLoaderStyleName():String
		{
			return this._customAccessoryLoaderStyleName;
		}

		/**
		 * @private
		 */
		public function set customAccessoryLoaderStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customAccessoryLoaderStyleName === value)
			{
				return;
			}
			this._customAccessoryLoaderStyleName = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _skinField:String = "skin";

		/**
		 * The field in the item that contains a display object to be displayed
		 * as a background skin.
		 *
		 * <p>All of the icon fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>skinSourceFunction</code></li>
		 *     <li><code>skinSourceField</code></li>
		 *     <li><code>skinFunction</code></li>
		 *     <li><code>skinField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the skin field is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.itemHasSkin = true;
		 * renderer.skinField = "background";</listing>
		 *
		 * @default "skin"
		 *
		 * @see #itemHasSkin
		 * @see #skinFunction
		 * @see #skinSourceField
		 * @see #skinSourceFunction
		 */
		public function get skinField():String
		{
			return this._skinField;
		}

		/**
		 * @private
		 */
		public function set skinField(value:String):void
		{
			if(this._skinField == value)
			{
				return;
			}
			this._skinField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _skinFunction:Function;

		/**
		 * A function used to generate a background skin for a specific item.
		 *
		 * <p>Note: As the list scrolls, this function will almost always be
		 * called more than once for each individual item in the list's data
		 * provider. Your function should not simply return a new display object
		 * every time. This will result in the unnecessary creation and
		 * destruction of many skins, which will overwork the garbage collector
		 * and hurt performance. It's better to return a new skin the first time
		 * this function is called for a particular item and then return the same
		 * skin if that item is passed to this function again.</p>
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):DisplayObject</pre>
		 *
		 * <p>If the item renderer is an <code>IListItemRenderer</code>, the
		 * function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, index:int ):DisplayObject</pre>
		 *
		 * <p>If the item renderer is an <code>IGroupedListItemRenderer</code>,
		 * the function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, groupIndex:int, itemIndex:int ):DisplayObject</pre>
		 *
		 * <p>All of the skin fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>skinSourceFunction</code></li>
		 *     <li><code>skinSourceField</code></li>
		 *     <li><code>skinFunction</code></li>
		 *     <li><code>skinField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the skin function is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.itemHasSkin = true;
		 * renderer.skinFunction = function( item:Object ):DisplayObject
		 * {
		 *    if(item in cachedSkin)
		 *    {
		 *        return cachedSkin[item];
		 *    }
		 *    var skin:Image = new Image( textureAtlas.getTexture( item.textureName ) );
		 *    cachedSkin[item] = skin;
		 *    return skin;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #itemHasSkin
		 * @see #skinField
		 * @see #skinSourceField
		 * @see #skinSourceFunction
		 */
		public function get skinFunction():Function
		{
			return this._skinFunction;
		}

		/**
		 * @private
		 */
		public function set skinFunction(value:Function):void
		{
			if(this._skinFunction == value)
			{
				return;
			}
			this._skinFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _skinSourceField:String = "skinSource";

		/**
		 * The field in the item that contains a <code>starling.textures.Texture</code>
		 * or a URL that points to a bitmap to be used as the item renderer's
		 * skin. The renderer will automatically manage and reuse an internal
		 * <code>ImageLoader</code> sub-component and this value will be passed
		 * to the <code>source</code> property. The <code>ImageLoader</code> may
		 * be customized by changing the <code>skinLoaderFactory</code>.
		 *
		 * <p>Using a skin source will result in better performance than
		 * passing in an <code>ImageLoader</code> or <code>Image</code> through
		 * a <code>skinField</code> or <code>skinFunction</code>
		 * because the renderer can avoid costly display list manipulation.</p>
		 *
		 * <p>All of the skin fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>skinSourceFunction</code></li>
		 *     <li><code>skinSourceField</code></li>
		 *     <li><code>skinFunction</code></li>
		 *     <li><code>skinField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the skin source field is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.itemHasSkin = true;
		 * renderer.skinSourceField = "texture";</listing>
		 *
		 * @default "skinSource"
		 *
		 * @see feathers.controls.ImageLoader#source
		 * @see #itemHasSkin
		 * @see #skinLoaderFactory
		 * @see #skinSourceFunction
		 * @see #skinField
		 * @see #skinFunction
		 */
		public function get skinSourceField():String
		{
			return this._skinSourceField;
		}

		/**
		 * @private
		 */
		public function set skinSourceField(value:String):void
		{
			if(this._skinSourceField == value)
			{
				return;
			}
			this._skinSourceField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _skinSourceFunction:Function;

		/**
		 * A function used to generate a <code>starling.textures.Texture</code>
		 * or a URL that points to a bitmap to be used as the item renderer's
		 * skin. The renderer will automatically manage and reuse an internal
		 * <code>ImageLoader</code> sub-component and this value will be passed
		 * to the <code>source</code> property. The <code>ImageLoader</code> may
		 * be customized by changing the <code>skinLoaderFactory</code>.
		 *
		 * <p>Using a skin source will result in better performance than
		 * passing in an <code>ImageLoader</code> or <code>Image</code> through
		 * a <code>skinField</code> or <code>skinnFunction</code>
		 * because the renderer can avoid costly display list manipulation.</p>
		 *
		 * <p>Note: As the list scrolls, this function will almost always be
		 * called more than once for each individual item in the list's data
		 * provider. Your function should not simply return a new texture every
		 * time. This will result in the unnecessary creation and destruction of
		 * many textures, which will overwork the garbage collector and hurt
		 * performance. Creating a new texture at all is dangerous, unless you
		 * are absolutely sure to dispose it when necessary because neither the
		 * list nor its item renderer will dispose of the texture for you. If
		 * you are absolutely sure that you are managing the texture memory with
		 * proper disposal, it's better to return a new texture the first
		 * time this function is called for a particular item and then return
		 * the same texture if that item is passed to this function again.</p>
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):Object</pre>
		 *
		 * <p>If the item renderer is an <code>IListItemRenderer</code>, the
		 * function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, index:int ):Object</pre>
		 *
		 * <p>If the item renderer is an <code>IGroupedListItemRenderer</code>,
		 * the function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, groupIndex:int, itemIndex:int ):Object</pre>
		 *
		 * <p>The return value is a valid value for the <code>source</code>
		 * property of an <code>ImageLoader</code> component.</p>
		 *
		 * <p>All of the skin fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>skinSourceFunction</code></li>
		 *     <li><code>skinSourceField</code></li>
		 *     <li><code>skinFunction</code></li>
		 *     <li><code>skinField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the skin source function is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.itemHasSkin = true;
		 * renderer.skinSourceFunction = function( item:Object ):Object
		 * {
		 *    return "http://www.example.com/images/" + item.name + "-skin.png";
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.ImageLoader#source
		 * @see #itemHasSkin
		 * @see #skinLoaderFactory
		 * @see #skinSourceField
		 * @see #skinField
		 * @see #skinFunction
		 */
		public function get skinSourceFunction():Function
		{
			return this._skinSourceFunction;
		}

		/**
		 * @private
		 */
		public function set skinSourceFunction(value:Function):void
		{
			if(this._skinSourceFunction == value)
			{
				return;
			}
			this._skinSourceFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _selectableField:String = "selectable";

		/**
		 * The field in the item that determines if the item renderer can be
		 * selected, if the list allows selection. If the item does not have
		 * this field, and a <code>selectableFunction</code> is not defined,
		 * then the renderer will default to being selectable.
		 *
		 * <p>All of the label fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>selectableFunction</code></li>
		 *     <li><code>selectableField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the selectable field is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.itemHasSelectable = true;
		 * renderer.selectableField = "isSelectable";</listing>
		 *
		 * @default "selectable"
		 *
		 * @see #selectableFunction
		 * @see #itemHasSelectable
		 */
		public function get selectableField():String
		{
			return this._selectableField;
		}

		/**
		 * @private
		 */
		public function set selectableField(value:String):void
		{
			if(this._selectableField == value)
			{
				return;
			}
			this._selectableField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _selectableFunction:Function;

		/**
		 * A function used to determine if a specific item is selectable. If this
		 * function is not null, then the <code>selectableField</code> will be
		 * ignored.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):Boolean</pre>
		 *
		 * <p>If the item renderer is an <code>IListItemRenderer</code>, the
		 * function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, index:int ):Boolean</pre>
		 *
		 * <p>If the item renderer is an <code>IGroupedListItemRenderer</code>,
		 * the function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, groupIndex:int, itemIndex:int ):Boolean</pre>
		 *
		 * <p>All of the selectable fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>selectableFunction</code></li>
		 *     <li><code>selectableField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the selectable function is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.itemHasSelectable = true;
		 * renderer.selectableFunction = function( item:Object ):Boolean
		 * {
		 *    return item.isSelectable;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #selectableField
		 * @see #itemHasSelectable
		 */
		public function get selectableFunction():Function
		{
			return this._selectableFunction;
		}

		/**
		 * @private
		 */
		public function set selectableFunction(value:Function):void
		{
			if(this._selectableFunction == value)
			{
				return;
			}
			this._selectableFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _enabledField:String = "enabled";

		/**
		 * The field in the item that determines if the item renderer is
		 * enabled, if the list is enabled. If the item does not have
		 * this field, and a <code>enabledFunction</code> is not defined,
		 * then the renderer will default to being enabled.
		 *
		 * <p>All of the label fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>enabledFunction</code></li>
		 *     <li><code>enabledField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the enabled field is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.itemHasEnabled = true;
		 * renderer.enabledField = "isEnabled";</listing>
		 *
		 * @default "enabled"
		 *
		 * @see #enabledFunction
		 * @see #itemHasEnabled
		 */
		public function get enabledField():String
		{
			return this._enabledField;
		}

		/**
		 * @private
		 */
		public function set enabledField(value:String):void
		{
			if(this._enabledField == value)
			{
				return;
			}
			this._enabledField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _enabledFunction:Function;

		/**
		 * A function used to determine if a specific item is enabled. If this
		 * function is not null, then the <code>enabledField</code> will be
		 * ignored.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):Boolean</pre>
		 *
		 * <p>If the item renderer is an <code>IListItemRenderer</code>, the
		 * function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, index:int ):Boolean</pre>
		 *
		 * <p>If the item renderer is an <code>IGroupedListItemRenderer</code>,
		 * the function may optionally have the following signature instead:</p>
		 * <pre>function( item:Object, groupIndex:int, itemIndex:int ):Boolean</pre>
		 *
		 * <p>All of the enabled fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>enabledFunction</code></li>
		 *     <li><code>enabledField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the enabled function is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.itemHasEnabled = true;
		 * renderer.enabledFunction = function( item:Object ):Boolean
		 * {
		 *    return item.isEnabled;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #enabledField
		 * @see #itemHasEnabled
		 */
		public function get enabledFunction():Function
		{
			return this._enabledFunction;
		}

		/**
		 * @private
		 */
		public function set enabledFunction(value:Function):void
		{
			if(this._enabledFunction == value)
			{
				return;
			}
			this._enabledFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _explicitIsToggle:Boolean = false;

		/**
		 * @private
		 */
		override public function set isToggle(value:Boolean):void
		{
			if(this._explicitIsToggle == value)
			{
				return;
			}
			super.isToggle = value;
			this._explicitIsToggle = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _explicitIsEnabled:Boolean;

		/**
		 * @private
		 */
		override public function set isEnabled(value:Boolean):void
		{
			if(this._explicitIsEnabled == value)
			{
				return;
			}
			this._explicitIsEnabled = value;
			super.isEnabled = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _iconLoaderFactory:Function = defaultLoaderFactory;

		/**
		 * A function that generates an <code>ImageLoader</code> that uses the result
		 * of <code>iconSourceField</code> or <code>iconSourceFunction</code>.
		 * Useful for transforming the <code>ImageLoader</code> in some way. For
		 * example, you might want to scale the texture for current screen
		 * density or apply pixel snapping.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function():ImageLoader</pre>
		 *
		 * <p>In the following example, the loader factory is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.iconLoaderFactory = function():ImageLoader
		 * {
		 *    var loader:ImageLoader = new ImageLoader();
		 *    loader.scaleFactor = 2;
		 *    return loader;
		 * };</listing>
		 *
		 * @default function():ImageLoader { return new ImageLoader(); }
		 *
		 * @see feathers.controls.ImageLoader
		 * @see #iconSourceField
		 * @see #iconSourceFunction
		 */
		public function get iconLoaderFactory():Function
		{
			return this._iconLoaderFactory;
		}

		/**
		 * @private
		 */
		public function set iconLoaderFactory(value:Function):void
		{
			if(this._iconLoaderFactory == value)
			{
				return;
			}
			this._iconLoaderFactory = value;
			this._iconIsFromItem = false;
			this.replaceIcon(null);
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _iconLabelFontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get iconLabelFontStyles():TextFormat
		{
			return this._iconLabelFontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set iconLabelFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._iconLabelFontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._iconLabelFontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get iconLabelDisabledFontStyles():TextFormat
		{
			return this._iconLabelFontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set iconLabelDisabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._iconLabelFontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._iconLabelFontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get iconLabelSelectedFontStyles():TextFormat
		{
			return this._iconLabelFontStylesSet.selectedFormat;
		}

		/**
		 * @private
		 */
		public function set iconLabelSelectedFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._iconLabelFontStylesSet.selectedFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._iconLabelFontStylesSet.selectedFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _iconLabelFactory:Function;

		/**
		 * A function that generates <code>ITextRenderer</code> that uses the result
		 * of <code>iconLabelField</code> or <code>iconLabelFunction</code>.
		 * CAn be used to set properties on the <code>ITextRenderer</code>.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function():ITextRenderer</pre>
		 *
		 * <p>In the following example, the icon label factory is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.iconLabelFactory = function():ITextRenderer
		 * {
		 *    var renderer:TextFieldTextRenderer = new TextFieldTextRenderer();
		 *    renderer.textFormat = new TextFormat( "Source Sans Pro", 16, 0x333333 );
		 *    renderer.embedFonts = true;
		 *    return renderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.ITextRenderer
		 * @see feathers.core.FeathersControl#defaultTextRendererFactory
		 * @see #iconLabelField
		 * @see #iconLabelFunction
		 */
		public function get iconLabelFactory():Function
		{
			return this._iconLabelFactory;
		}

		/**
		 * @private
		 */
		public function set iconLabelFactory(value:Function):void
		{
			if(this._iconLabelFactory == value)
			{
				return;
			}
			this._iconLabelFactory = value;
			this._iconIsFromItem = false;
			this.replaceIcon(null);
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _iconLabelProperties:PropertyProxy;

		/**
		 * An object that stores properties for the icon label text renderer
		 * sub-component (if using <code>iconLabelField</code> or
		 * <code>iconLabelFunction</code>), and the properties will be passed
		 * down to the text renderer when this component validates. The
		 * available properties depend on which <code>ITextRenderer</code>
		 * implementation is returned by <code>iconLabelFactory</code>. Refer to
		 * <a href="../../core/ITextRenderer.html"><code>feathers.core.ITextRenderer</code></a>
		 * for a list of available text renderer implementations.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>iconLabelFactory</code>
		 * function instead of using <code>iconLabelProperties</code> will
		 * result in better performance.</p>
		 *
		 * <p>In the following example, the icon label properties are customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.&#64;iconLabelProperties.textFormat = new TextFormat( "Source Sans Pro", 16, 0x333333 );
		 * renderer.&#64;iconLabelProperties.embedFonts = true;</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.ITextRenderer
		 * @see #iconLabelFactory
		 * @see #iconLabelField
		 * @see #iconLabelFunction
		 */
		public function get iconLabelProperties():Object
		{
			if(!this._iconLabelProperties)
			{
				this._iconLabelProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._iconLabelProperties;
		}

		/**
		 * @private
		 */
		public function set iconLabelProperties(value:Object):void
		{
			if(this._iconLabelProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._iconLabelProperties)
			{
				this._iconLabelProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._iconLabelProperties = PropertyProxy(value);
			if(this._iconLabelProperties)
			{
				this._iconLabelProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _accessoryLoaderFactory:Function = defaultLoaderFactory;

		/**
		 * A function that generates an <code>ImageLoader</code> that uses the result
		 * of <code>accessorySourceField</code> or <code>accessorySourceFunction</code>.
		 * Useful for transforming the <code>ImageLoader</code> in some way. For
		 * example, you might want to scale the texture for current screen
		 * density or apply pixel snapping.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function():ImageLoader</pre>
		 *
		 * <p>In the following example, the loader factory is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.accessoryLoaderFactory = function():ImageLoader
		 * {
		 *    var loader:ImageLoader = new ImageLoader();
		 *    loader.scaleFactor = 2;
		 *    return loader;
		 * };</listing>
		 *
		 * @default function():ImageLoader { return new ImageLoader(); }
		 *
		 * @see feathers.controls.ImageLoader
		 * @see #accessorySourceField;
		 * @see #accessorySourceFunction;
		 */
		public function get accessoryLoaderFactory():Function
		{
			return this._accessoryLoaderFactory;
		}

		/**
		 * @private
		 */
		public function set accessoryLoaderFactory(value:Function):void
		{
			if(this._accessoryLoaderFactory == value)
			{
				return;
			}
			this._accessoryLoaderFactory = value;
			this._accessoryIsFromItem = false;
			this.replaceAccessory(null);
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _accessoryLabelFontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get accessoryLabelFontStyles():TextFormat
		{
			return this._accessoryLabelFontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set accessoryLabelFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._accessoryLabelFontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._accessoryLabelFontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get accessoryLabelDisabledFontStyles():TextFormat
		{
			return this._accessoryLabelFontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set accessoryLabelDisabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._accessoryLabelFontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._accessoryLabelFontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get accessoryLabelSelectedFontStyles():TextFormat
		{
			return this._accessoryLabelFontStylesSet.selectedFormat;
		}

		/**
		 * @private
		 */
		public function set accessoryLabelSelectedFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._accessoryLabelFontStylesSet.selectedFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._accessoryLabelFontStylesSet.selectedFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _accessoryLabelFactory:Function;

		/**
		 * A function that generates <code>ITextRenderer</code> that uses the result
		 * of <code>accessoryLabelField</code> or <code>accessoryLabelFunction</code>.
		 * CAn be used to set properties on the <code>ITextRenderer</code>.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function():ITextRenderer</pre>
		 *
		 * <p>In the following example, the accessory label factory is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.accessoryLabelFactory = function():ITextRenderer
		 * {
		 *    var renderer:TextFieldTextRenderer = new TextFieldTextRenderer();
		 *    renderer.textFormat = new TextFormat( "Source Sans Pro", 16, 0x333333 );
		 *    renderer.embedFonts = true;
		 *    return renderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.ITextRenderer
		 * @see feathers.core.FeathersControl#defaultTextRendererFactory
		 * @see #accessoryLabelField
		 * @see #accessoryLabelFunction
		 */
		public function get accessoryLabelFactory():Function
		{
			return this._accessoryLabelFactory;
		}

		/**
		 * @private
		 */
		public function set accessoryLabelFactory(value:Function):void
		{
			if(this._accessoryLabelFactory == value)
			{
				return;
			}
			this._accessoryLabelFactory = value;
			this._accessoryIsFromItem = false;
			this.replaceAccessory(null);
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _accessoryLabelProperties:PropertyProxy;

		/**
		 * An object that stores properties for the accessory label text
		 * renderer sub-component (if using <code>accessoryLabelField</code> or
		 * <code>accessoryLabelFunction</code>), and the properties will be
		 * passed down to the text renderer when this component validates. The
		 * available properties depend on which <code>ITextRenderer</code>
		 * implementation is returned by <code>accessoryLabelFactory</code>.
		 * Refer to <a href="../../core/ITextRenderer.html"><code>feathers.core.ITextRenderer</code></a>
		 * for a list of available text renderer implementations.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>accessoryLabelFactory</code>
		 * function instead of using <code>accessoryLabelProperties</code> will
		 * result in better performance.</p>
		 *
		 * <p>In the following example, the accessory label properties are customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.&#64;accessoryLabelProperties.textFormat = new TextFormat( "Source Sans Pro", 16, 0x333333 );
		 * renderer.&#64;accessoryLabelProperties.embedFonts = true;</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.ITextRenderer
		 * @see #accessoryLabelFactory
		 * @see #accessoryLabelField
		 * @see #accessoryLabelFunction
		 */
		public function get accessoryLabelProperties():Object
		{
			if(!this._accessoryLabelProperties)
			{
				this._accessoryLabelProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._accessoryLabelProperties;
		}

		/**
		 * @private
		 */
		public function set accessoryLabelProperties(value:Object):void
		{
			if(this._accessoryLabelProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._accessoryLabelProperties)
			{
				this._accessoryLabelProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._accessoryLabelProperties = PropertyProxy(value);
			if(this._accessoryLabelProperties)
			{
				this._accessoryLabelProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _skinLoaderFactory:Function = defaultLoaderFactory;

		/**
		 * A function that generates an <code>ImageLoader</code> that uses the result
		 * of <code>skinSourceField</code> or <code>skinSourceFunction</code>.
		 * Useful for transforming the <code>ImageLoader</code> in some way. For
		 * example, you might want to scale the texture for current screen
		 * density or apply pixel snapping.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function():ImageLoader</pre>
		 *
		 * <p>In the following example, the loader factory is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.skinLoaderFactory = function():ImageLoader
		 * {
		 *    var loader:ImageLoader = new ImageLoader();
		 *    loader.scaleFactor = 2;
		 *    return loader;
		 * };</listing>
		 *
		 * @default function():ImageLoader { return new ImageLoader(); }
		 *
		 * @see feathers.controls.ImageLoader
		 * @see #skinSourceField
		 * @see #skinSourceFunction
		 */
		public function get skinLoaderFactory():Function
		{
			return this._skinLoaderFactory;
		}

		/**
		 * @private
		 */
		public function set skinLoaderFactory(value:Function):void
		{
			if(this._skinLoaderFactory == value)
			{
				return;
			}
			this._skinLoaderFactory = value;
			this._skinIsFromItem = false;
			this.replaceSkin(null);
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _ignoreAccessoryResizes:Boolean = false;

		/**
		 * @private
		 */
		protected var _topOffset:Number = 0;

		/**
		 * @private
		 */
		protected var _rightOffset:Number = 0;

		/**
		 * @private
		 */
		protected var _bottomOffset:Number = 0;

		/**
		 * @private
		 */
		protected var _leftOffset:Number = 0;

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this._iconIsFromItem)
			{
				this.replaceIcon(null);
			}
			if(this._accessoryIsFromItem)
			{
				this.replaceAccessory(null);
			}
			if(this._skinIsFromItem)
			{
				this.replaceSkin(null);
			}
			if(this._iconLabelFontStylesSet !== null)
			{
				this._iconLabelFontStylesSet.dispose();
				this._iconLabelFontStylesSet = null;
			}
			if(this._accessoryLabelFontStylesSet !== null)
			{
				this._accessoryLabelFontStylesSet.dispose();
				this._accessoryLabelFontStylesSet = null;
			}
			super.dispose();
		}

		/**
		 * Using <code>labelField</code> and <code>labelFunction</code>,
		 * generates a label from the item.
		 *
		 * <p>All of the label fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>labelFunction</code></li>
		 *     <li><code>labelField</code></li>
		 * </ol>
		 */
		public function itemToLabel(item:Object):String
		{
			if(this._labelFunction !== null)
			{
				var labelResult:Object;
				if(this is IListItemRenderer && this._labelFunction.length == 2)
				{
					labelResult = this._labelFunction(item, IListItemRenderer(this).index);
				}
				else if(this is IGroupedListItemRenderer && this._labelFunction.length == 3)
				{
					var groupItemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(this);
					labelResult = this._labelFunction(item, groupItemRenderer.groupIndex, groupItemRenderer.itemIndex);
				}
				else
				{
					labelResult = this._labelFunction(item);
				}
				if(labelResult is String)
				{
					return labelResult as String;
				}
				else if(labelResult !== null)
				{
					return labelResult.toString();
				}
			}
			else if(this._labelField !== null && item !== null && item.hasOwnProperty(this._labelField))
			{
				labelResult = item[this._labelField];
				if(labelResult is String)
				{
					return labelResult as String;
				}
				else if(labelResult !== null)
				{
					return labelResult.toString();
				}
			}
			else if(item is String)
			{
				return item as String;
			}
			else if(item !== null)
			{
				//we need to use strict equality here because the data can be
				//non-strictly equal to null
				return item.toString();
			}
			return null;
		}

		/**
		 * Uses the icon fields and functions to generate an icon for a specific
		 * item.
		 *
		 * <p>All of the icon fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>iconSourceFunction</code></li>
		 *     <li><code>iconSourceField</code></li>
		 *     <li><code>iconLabelFunction</code></li>
		 *     <li><code>iconLabelField</code></li>
		 *     <li><code>iconFunction</code></li>
		 *     <li><code>iconField</code></li>
		 * </ol>
		 */
		protected function itemToIcon(item:Object):DisplayObject
		{
			if(this._iconSourceFunction !== null)
			{
				var source:Object;
				if(this is IListItemRenderer && this._iconSourceFunction.length == 2)
				{
					source = this._iconSourceFunction(item, IListItemRenderer(this).index);
				}
				else if(this is IGroupedListItemRenderer && this._iconSourceFunction.length == 3)
				{
					var groupItemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(this);
					source = this._iconSourceFunction(item, groupItemRenderer.groupIndex, groupItemRenderer.itemIndex);
				}
				else
				{
					source = this._iconSourceFunction(item);
				}
				this.refreshIconSource(source);
				return this.iconLoader;
			}
			else if(this._iconSourceField !== null && item !== null && item.hasOwnProperty(this._iconSourceField))
			{
				source = item[this._iconSourceField];
				this.refreshIconSource(source);
				return this.iconLoader;
			}
			else if(this._iconLabelFunction !== null)
			{
				var labelResult:Object;
				if(this is IListItemRenderer && this._iconLabelFunction.length == 2)
				{
					labelResult = this._iconLabelFunction(item, IListItemRenderer(this).index);
				}
				else if(this is IGroupedListItemRenderer && this._iconLabelFunction.length == 3)
				{
					groupItemRenderer = IGroupedListItemRenderer(this);
					labelResult = this._iconLabelFunction(item, groupItemRenderer.groupIndex, groupItemRenderer.itemIndex);
				}
				else
				{
					labelResult = this._iconLabelFunction(item);
				}
				if(labelResult is String)
				{
					this.refreshIconLabel(labelResult as String);
				}
				else
				{
					this.refreshIconLabel(labelResult.toString());
				}
				return DisplayObject(this.iconLabel);
			}
			else if(this._iconLabelField !== null && item !== null && item.hasOwnProperty(this._iconLabelField))
			{
				labelResult = item[this._iconLabelField];
				if(labelResult is String)
				{
					this.refreshIconLabel(labelResult as String);
				}
				else
				{
					this.refreshIconLabel(labelResult.toString());
				}
				return DisplayObject(this.iconLabel);
			}
			else if(this._iconFunction !== null)
			{
				if(this is IListItemRenderer && this._iconFunction.length == 2)
				{
					return this._iconFunction(item, IListItemRenderer(this).index) as DisplayObject;
				}
				else if(this is IGroupedListItemRenderer && this._iconFunction.length == 3)
				{
					groupItemRenderer = IGroupedListItemRenderer(this);
					return this._iconFunction(item, groupItemRenderer.groupIndex, groupItemRenderer.itemIndex) as DisplayObject;
				}
				return this._iconFunction(item) as DisplayObject;
			}
			else if(this._iconField !== null && item !== null && item.hasOwnProperty(this._iconField))
			{
				return item[this._iconField] as DisplayObject;
			}

			return null;
		}

		/**
		 * Uses the accessory fields and functions to generate an accessory for
		 * a specific item.
		 *
		 * <p>All of the accessory fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>accessorySourceFunction</code></li>
		 *     <li><code>accessorySourceField</code></li>
		 *     <li><code>accessoryLabelFunction</code></li>
		 *     <li><code>accessoryLabelField</code></li>
		 *     <li><code>accessoryFunction</code></li>
		 *     <li><code>accessoryField</code></li>
		 * </ol>
		 */
		protected function itemToAccessory(item:Object):DisplayObject
		{
			if(this._accessorySourceFunction !== null)
			{
				var source:Object;
				if(this is IListItemRenderer && this._accessorySourceFunction.length == 2)
				{
					source = this._accessorySourceFunction(item, IListItemRenderer(this).index);
				}
				else if(this is IGroupedListItemRenderer && this._accessorySourceFunction.length == 3)
				{
					var groupItemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(this);
					source = this._accessorySourceFunction(item, groupItemRenderer.groupIndex, groupItemRenderer.itemIndex);
				}
				else
				{
					source = this._accessorySourceFunction(item);
				}
				this.refreshAccessorySource(source);
				return this.accessoryLoader;
			}
			else if(this._accessorySourceField !== null && item !== null && item.hasOwnProperty(this._accessorySourceField))
			{
				source = item[this._accessorySourceField];
				this.refreshAccessorySource(source);
				return this.accessoryLoader;
			}
			else if(this._accessoryLabelFunction !== null)
			{
				var labelResult:Object;
				if(this is IListItemRenderer && this._accessoryLabelFunction.length == 2)
				{
					labelResult = this._accessoryLabelFunction(item, IListItemRenderer(this).index);
				}
				else if(this is IGroupedListItemRenderer && this._accessoryLabelFunction.length == 3)
				{
					groupItemRenderer = IGroupedListItemRenderer(this);
					labelResult = this._accessoryLabelFunction(item, groupItemRenderer.groupIndex, groupItemRenderer.itemIndex);
				}
				else
				{
					labelResult = this._accessoryLabelFunction(item);
				}
				if(labelResult is String)
				{
					this.refreshAccessoryLabel(labelResult as String);
				}
				else
				{
					this.refreshAccessoryLabel(labelResult.toString());
				}
				return DisplayObject(this.accessoryLabel);
			}
			else if(this._accessoryLabelField !== null && item !== null && item.hasOwnProperty(this._accessoryLabelField))
			{
				labelResult = item[this._accessoryLabelField];
				if(labelResult is String)
				{
					this.refreshAccessoryLabel(labelResult as String);
				}
				else
				{
					this.refreshAccessoryLabel(labelResult.toString());
				}
				return DisplayObject(this.accessoryLabel);
			}
			else if(this._accessoryFunction !== null)
			{
				if(this is IListItemRenderer && this._accessoryFunction.length == 2)
				{
					return this._accessoryFunction(item, IListItemRenderer(this).index) as DisplayObject;
				}
				else if(this is IGroupedListItemRenderer && this._accessoryFunction.length == 3)
				{
					groupItemRenderer = IGroupedListItemRenderer(this);
					return this._accessoryFunction(item, groupItemRenderer.groupIndex, groupItemRenderer.itemIndex) as DisplayObject;
				}
				return this._accessoryFunction(item) as DisplayObject;
			}
			else if(this._accessoryField !== null && item !== null && item.hasOwnProperty(this._accessoryField))
			{
				return item[this._accessoryField] as DisplayObject;
			}

			return null;
		}

		/**
		 * Uses the skin fields and functions to generate a skin for a specific
		 * item.
		 *
		 * <p>All of the skin fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>skinSourceFunction</code></li>
		 *     <li><code>skinSourceField</code></li>
		 *     <li><code>skinFunction</code></li>
		 *     <li><code>skinField</code></li>
		 * </ol>
		 */
		protected function itemToSkin(item:Object):DisplayObject
		{
			if(this._skinSourceFunction !== null)
			{
				var source:Object;
				if(this is IListItemRenderer && this._skinSourceFunction.length == 2)
				{
					source = this._skinSourceFunction(item, IListItemRenderer(this).index);
				}
				else if(this is IGroupedListItemRenderer && this._skinSourceFunction.length == 3)
				{
					var groupItemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(this);
					source = this._skinSourceFunction(item, groupItemRenderer.groupIndex, groupItemRenderer.itemIndex);
				}
				else
				{
					source = this._skinSourceFunction(item);
				}
				this.refreshSkinSource(source);
				return this.skinLoader;
			}
			else if(this._skinSourceField !== null && item !== null && item.hasOwnProperty(this._skinSourceField))
			{
				source = item[this._skinSourceField];
				this.refreshSkinSource(source);
				return this.skinLoader;
			}
			else if(this._skinFunction !== null)
			{
				if(this is IListItemRenderer && this._skinFunction.length == 2)
				{
					return this._skinFunction(item, IListItemRenderer(this).index) as DisplayObject;
				}
				else if(this is IGroupedListItemRenderer && this._skinFunction.length == 3)
				{
					groupItemRenderer = IGroupedListItemRenderer(this);
					return this._skinFunction(item, groupItemRenderer.groupIndex, groupItemRenderer.itemIndex) as DisplayObject;
				}
				return this._skinFunction(item) as DisplayObject;
			}
			else if(this._skinField !== null && item !== null && item.hasOwnProperty(this._skinField))
			{
				return item[this._skinField] as DisplayObject;
			}

			return null;
		}

		/**
		 * Uses the selectable fields and functions to generate a selectable
		 * value for a specific item.
		 *
		 * <p>All of the selectable fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>selectableFunction</code></li>
		 *     <li><code>selectableField</code></li>
		 * </ol>
		 */
		protected function itemToSelectable(item:Object):Boolean
		{
			if(this._selectableFunction !== null)
			{
				if(this is IListItemRenderer && this._selectableFunction.length == 2)
				{
					return this._selectableFunction(item, IListItemRenderer(this).index) as Boolean;
				}
				else if(this is IGroupedListItemRenderer && this._selectableFunction.length == 3)
				{
					var groupItemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(this);
					return this._selectableFunction(item, groupItemRenderer.groupIndex, groupItemRenderer.itemIndex) as Boolean;
				}
				return this._selectableFunction(item) as Boolean;
			}
			else if(this._selectableField !== null && item !== null && item.hasOwnProperty(this._selectableField))
			{
				return item[this._selectableField] as Boolean;
			}
			return true;
		}

		/**
		 * Uses the enabled fields and functions to generate a enabled value for
		 * a specific item.
		 *
		 * <p>All of the enabled fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>enabledFunction</code></li>
		 *     <li><code>enabledField</code></li>
		 * </ol>
		 */
		protected function itemToEnabled(item:Object):Boolean
		{
			if(this._enabledFunction !== null)
			{
				if(this is IListItemRenderer && this._enabledFunction.length == 2)
				{
					return this._enabledFunction(item, IListItemRenderer(this).index) as Boolean;
				}
				else if(this is IGroupedListItemRenderer && this._enabledFunction.length == 3)
				{
					var groupItemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(this);
					return this._enabledFunction(item, groupItemRenderer.groupIndex, groupItemRenderer.itemIndex) as Boolean;
				}
				return this._enabledFunction(item) as Boolean;
			}
			else if(this._enabledField !== null && item !== null && item.hasOwnProperty(this._enabledField))
			{
				return item[this._enabledField] as Boolean;
			}

			return true;
		}

		/**
		 * Gets the font styles to be used to display the item renderer's icon
		 * label text when the item renderer's <code>currentState</code>
		 * property matches the specified state value.
		 *
		 * <p>If icon label font styles are not defined for a specific state,
		 * returns <code>null</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #setIconLabelFontStylesForState()
		 * @see #iconLabelFontStyles
		 */
		public function getIconLabelFontStylesForState(state:String):TextFormat
		{
			if(this._iconLabelFontStylesSet === null)
			{
				return null;
			}
			return this._iconLabelFontStylesSet.getFormatForState(state);
		}

		/**
		 * Sets the font styles to be used to display the icon label's text when
		 * the item renderer's <code>currentState</code> property matches the
		 * specified state value.
		 *
		 * <p>If font styles are not defined for a specific state, the value of
		 * the <code>iconLabelFontStyles</code> property will be used instead.</p>
		 *
		 * <p>Note: if the text renderer has been customized with advanced font
		 * formatting, it may override the values specified with
		 * <code>setIconLabelFontStylesForState()</code> and properties like
		 * <code>iconLabelFontStyles</code> and
		 * <code>disabledIconLabelFontStyles</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #iconLabelFontStyles
		 */
		public function setIconLabelFontStylesForState(state:String, format:TextFormat):void
		{
			var key:String = "setIconLabelFontStylesForState--" + state;
			if(this.processStyleRestriction(key))
			{
				return;
			}
			function changeHandler(event:Event):void
			{
				processStyleRestriction(key);
			}
			var oldFormat:TextFormat = this._iconLabelFontStylesSet.getFormatForState(state);
			if(oldFormat !== null)
			{
				oldFormat.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._iconLabelFontStylesSet.setFormatForState(state, format);
			if(format !== null)
			{
				format.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * Gets the font styles to be used to display the item renderer's
		 * accessory label text when the item renderer's
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If icon label font styles are not defined for a specific state,
		 * returns <code>null</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #setAccessoryLabelFontStylesForState()
		 * @see #accessoryLabelfontStyles
		 */
		public function getAccessoryLabelFontStylesForState(state:String):TextFormat
		{
			if(this._accessoryLabelFontStylesSet === null)
			{
				return null;
			}
			return this._accessoryLabelFontStylesSet.getFormatForState(state);
		}

		/**
		 * Sets the font styles to be used to display the accessory label's text
		 * when the item renderer's <code>currentState</code> property matches
		 * the specified state value.
		 *
		 * <p>If font styles are not defined for a specific state, the value of
		 * the <code>accessoryLabelFontStyles</code> property will be used instead.</p>
		 *
		 * <p>Note: if the text renderer has been customized with advanced font
		 * formatting, it may override the values specified with
		 * <code>setAccessoryLabelFontStylesForState()</code> and properties like
		 * <code>accessoryLabelFontStyles</code> and
		 * <code>disabledAccessoryLabelFontStyles</code>.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 * @see #accessoryLabelFontStyles
		 */
		public function setAccessoryLabelFontStylesForState(state:String, format:TextFormat):void
		{
			var key:String = "setAccessoryLabelFontStylesForState--" + state;
			if(this.processStyleRestriction(key))
			{
				return;
			}
			function changeHandler(event:Event):void
			{
				processStyleRestriction(key);
			}
			var oldFormat:TextFormat = this._accessoryLabelFontStylesSet.getFormatForState(state);
			if(oldFormat !== null)
			{
				oldFormat.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._accessoryLabelFontStylesSet.setFormatForState(state, format);
			if(format !== null)
			{
				format.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * Gets the accessory to be used by the item renderer when the item
		 * renderer's <code>currentState</code> property matches the specified
		 * state value.
		 *
		 * <p>If a accessory is not defined for a specific state, returns
		 * <code>null</code>.</p>
		 *
		 * @see #setAccessoryForState()
		 */
		public function getAccessoryForState(state:String):DisplayObject
		{
			return this._stateToAccessory[state] as DisplayObject;
		}

		/**
		 * Sets the accessory to be used by the item renderer when the item
		 * renderer's <code>currentState</code> property matches the specified
		 * state value.
		 *
		 * <p>If an accessory is not defined for a specific state, the value of
		 * the <code>defaultAccessory</code> property will be used instead.</p>
		 *
		 * @see #defaultAccessory
		 */
		public function setAccessoryForState(state:String, accessory:DisplayObject):void
		{
			if(accessory !== null)
			{
				this._stateToAccessory[state] = accessory;
			}
			else
			{
				delete this._stateToAccessory[state];
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(this.touchToState === null && this._useStateDelayTimer)
			{
				this.touchToState = new DelayedDownTouchToState(this, this.changeState);
			}
			super.initialize();
			this.tapToTrigger.customHitTest = this.hitTestWithAccessory;
			this.tapToSelect.customHitTest = this.hitTestWithAccessory;
			this.longPress.customHitTest = this.hitTestWithAccessory;
			this.touchToState.customHitTest = this.hitTestWithAccessory;
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			if(dataInvalid)
			{
				this.commitData();
			}
			if(stateInvalid || dataInvalid || stylesInvalid)
			{
				this.refreshAccessory();
			}
			this.refreshOffsets();
			super.draw();
		}

		/**
		 * @inheritDoc
		 */
		override protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			var oldIgnoreAccessoryResizes:Boolean = this._ignoreAccessoryResizes;
			this._ignoreAccessoryResizes = true;
			var labelRenderer:ITextRenderer = null;
			if(this._label !== null && this.labelTextRenderer !== null)
			{
				labelRenderer = this.labelTextRenderer;
				this.refreshLabelTextRendererDimensions(true);
				this.labelTextRenderer.measureText(HELPER_POINT);
			}
			if(this.currentIcon is IValidating)
			{
				IValidating(this.currentIcon).validate();
			}
			if(this.currentAccessory is IValidating)
			{
				IValidating(this.currentAccessory).validate();
			}

			resetFluidChildDimensionsForMeasurement(this.currentSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitSkinWidth, this._explicitSkinHeight,
				this._explicitSkinMinWidth, this._explicitSkinMinHeight,
				this._explicitSkinMaxWidth, this._explicitSkinMaxHeight);
			var measureSkin:IMeasureDisplayObject = this.currentSkin as IMeasureDisplayObject;

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				if(labelRenderer !== null)
				{
					newWidth = HELPER_POINT.x;
				}
				else
				{
					newWidth = 0;
				}
				if(this._layoutOrder === ItemRendererLayoutOrder.LABEL_ACCESSORY_ICON)
				{
					newWidth = this.addAccessoryWidth(newWidth);
					newWidth = this.addIconWidth(newWidth);
				}
				else
				{
					newWidth = this.addIconWidth(newWidth);
					newWidth = this.addAccessoryWidth(newWidth);
				}
				newWidth += this._leftOffset + this._rightOffset;
				if(this.currentSkin !== null &&
					this.currentSkin.width > newWidth)
				{
					newWidth = this.currentSkin.width;
				}
			}

			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				if(labelRenderer !== null)
				{
					newHeight = HELPER_POINT.y;
				}
				else
				{
					newHeight = 0;
				}
				if(this._layoutOrder === ItemRendererLayoutOrder.LABEL_ACCESSORY_ICON)
				{
					newHeight = this.addAccessoryHeight(newHeight);
					newHeight = this.addIconHeight(newHeight);
				}
				else
				{
					newHeight = this.addIconHeight(newHeight);
					newHeight = this.addAccessoryHeight(newHeight);
				}
				newHeight += this._topOffset + this._bottomOffset;
				if(this.currentSkin !== null &&
					this.currentSkin.height > newHeight)
				{
					newHeight = this.currentSkin.height;
				}
			}

			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				if(labelRenderer !== null)
				{
					newMinWidth = HELPER_POINT.x;
				}
				else
				{
					newMinWidth = 0;
				}
				if(this._layoutOrder === ItemRendererLayoutOrder.LABEL_ACCESSORY_ICON)
				{
					newMinWidth = this.addAccessoryWidth(newMinWidth);
					newMinWidth = this.addIconWidth(newMinWidth);
				}
				else
				{
					newMinWidth = this.addIconWidth(newMinWidth);
					newMinWidth = this.addAccessoryWidth(newMinWidth);
				}
				newMinWidth += this._leftOffset + this._rightOffset;
				if(this.currentSkin !== null)
				{
					if(measureSkin !== null)
					{
						if(measureSkin.minWidth > newMinWidth)
						{
							newMinWidth = measureSkin.minWidth;
						}
					}
					else if(this._explicitSkinMinWidth > newMinWidth)
					{
						newMinWidth = this._explicitSkinMinWidth;
					}
				}
			}

			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				if(labelRenderer !== null)
				{
					newMinHeight = HELPER_POINT.y;
				}
				else
				{
					newMinHeight = 0;
				}
				if(this._layoutOrder === ItemRendererLayoutOrder.LABEL_ACCESSORY_ICON)
				{
					newMinHeight = this.addAccessoryHeight(newMinHeight);
					newMinHeight = this.addIconHeight(newMinHeight);
				}
				else
				{
					newMinHeight = this.addIconHeight(newMinHeight);
					newMinHeight = this.addAccessoryHeight(newMinHeight);
				}
				newMinHeight += this._topOffset + this._bottomOffset;
				if(this.currentSkin !== null)
				{
					if(measureSkin !== null)
					{
						if(measureSkin.minHeight > newMinHeight)
						{
							newMinHeight = measureSkin.minHeight;
						}
					}
					else if(this._explicitSkinMinHeight > newMinHeight)
					{
						newMinHeight = this._explicitSkinMinHeight;
					}
				}
			}
			this._ignoreAccessoryResizes = oldIgnoreAccessoryResizes;

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * @private
		 */
		override protected function changeState(value:String):void
		{
			if(this._isEnabled && !this._isToggle &&
				(!this.isSelectableWithoutToggle || (this._itemHasSelectable && !this.itemToSelectable(this._data))))
			{
				value = ButtonState.UP;
			}
			super.changeState(value);
		}

		/**
		 * @private
		 */
		protected function addIconWidth(width:Number):Number
		{
			if(!this.currentIcon)
			{
				return width;
			}
			var iconWidth:Number = this.currentIcon.width;
			if(iconWidth !== iconWidth) //isNaN
			{
				return width;
			}

			var hasPreviousItem:Boolean = width === width; //!isNaN
			if(!hasPreviousItem)
			{
				width = 0;
			}

			if(this._iconPosition == RelativePosition.LEFT || this._iconPosition == RelativePosition.LEFT_BASELINE || this._iconPosition == RelativePosition.RIGHT || this._iconPosition == RelativePosition.RIGHT_BASELINE)
			{
				if(hasPreviousItem)
				{
					var adjustedGap:Number = this._gap;
					if(this._gap == Number.POSITIVE_INFINITY)
					{
						adjustedGap = this._minGap;
					}
					width += adjustedGap;
				}
				width += iconWidth;
			}
			else if(iconWidth > width)
			{
				width = iconWidth;
			}
			return width;
		}

		/**
		 * @private
		 */
		protected function addAccessoryWidth(width:Number):Number
		{
			if(!this.currentAccessory)
			{
				return width;
			}
			var accessoryWidth:Number = this.currentAccessory.width;
			if(accessoryWidth !== accessoryWidth) //isNaN
			{
				return width;
			}

			var hasPreviousItem:Boolean = width === width; //!isNaN;
			if(!hasPreviousItem)
			{
				width = 0;
			}

			if(this._accessoryPosition == RelativePosition.LEFT || this._accessoryPosition == RelativePosition.RIGHT)
			{
				if(hasPreviousItem)
				{
					var adjustedAccessoryGap:Number = this._accessoryGap;
					//for some reason, if we do the !== check on a local variable right
					//here, compiling with the flex 4.6 SDK will throw a VerifyError
					//for a stack overflow.
					//we could change the !== check back to isNaN() instead, but
					//isNaN() can allocate an object that needs garbage collection.
					if(this._accessoryGap !== this._accessoryGap) //isNaN
					{
						adjustedAccessoryGap = this._gap;
					}
					if(adjustedAccessoryGap == Number.POSITIVE_INFINITY)
					{
						if(this._minAccessoryGap !== this._minAccessoryGap) //isNaN
						{
							adjustedAccessoryGap = this._minGap;
						}
						else
						{
							adjustedAccessoryGap = this._minAccessoryGap;
						}
					}
					width += adjustedAccessoryGap;
				}
				width += accessoryWidth;
			}
			else if(accessoryWidth > width)
			{
				width = accessoryWidth;
			}
			return width;
		}

		/**
		 * @private
		 */
		protected function addIconHeight(height:Number):Number
		{
			if(this.currentIcon === null)
			{
				return height;
			}
			var iconHeight:Number = this.currentIcon.height;
			if(iconHeight !== iconHeight) //isNaN
			{
				return height;
			}

			var hasPreviousItem:Boolean = height === height; //!isNaN
			if(!hasPreviousItem)
			{
				height = 0;
			}

			if(this._iconPosition === RelativePosition.TOP || this._iconPosition === RelativePosition.BOTTOM)
			{
				if(hasPreviousItem)
				{
					var adjustedGap:Number = this._gap;
					if(this._gap == Number.POSITIVE_INFINITY)
					{
						adjustedGap = this._minGap;
					}
					height += adjustedGap;
				}
				height += iconHeight;
			}
			else if(iconHeight > height)
			{
				height = iconHeight;
			}
			return height;
		}

		/**
		 * @private
		 */
		protected function addAccessoryHeight(height:Number):Number
		{
			if(this.currentAccessory === null)
			{
				return height;
			}
			var accessoryHeight:Number = this.currentAccessory.height;
			if(accessoryHeight !== accessoryHeight) //isNaN
			{
				return height;
			}

			var hasPreviousItem:Boolean = height === height; //!isNaN
			if(!hasPreviousItem)
			{
				height = 0;
			}

			if(this._accessoryPosition === RelativePosition.TOP || this._accessoryPosition === RelativePosition.BOTTOM)
			{
				if(hasPreviousItem)
				{
					var adjustedAccessoryGap:Number = this._accessoryGap;
					//for some reason, if we do the !== check on a local variable right
					//here, compiling with the flex 4.6 SDK will throw a VerifyError
					//for a stack overflow.
					//we could change the !== check back to isNaN() instead, but
					//isNaN() can allocate an object that needs garbage collection.
					if(this._accessoryGap !== this._accessoryGap) //isNaN
					{
						adjustedAccessoryGap = this._gap;
					}
					if(adjustedAccessoryGap == Number.POSITIVE_INFINITY)
					{
						if(this._minAccessoryGap !== this._minAccessoryGap) //isNaN
						{
							adjustedAccessoryGap = this._minGap;
						}
						else
						{
							adjustedAccessoryGap = this._minAccessoryGap;
						}
					}
					height += adjustedAccessoryGap;
				}
				height += accessoryHeight;
			}
			else if(accessoryHeight > height)
			{
				height = accessoryHeight;
			}
			return height;
		}

		/**
		 * @private
		 */
		protected function getDataToRender():Object
		{
			return this._data;
		}

		/**
		 * Updates the renderer to display the item's data. Override this
		 * function to pass data to sub-components and react to data changes.
		 *
		 * <p>Don't forget to handle the case where the data is <code>null</code>.</p>
		 */
		protected function commitData():void
		{
			var dataToRender:Object = this.getDataToRender();
			//we need to use strict equality here because the data can be
			//non-strictly equal to null
			if(dataToRender !== null)
			{
				if(this._itemHasLabel)
				{
					this._label = this.itemToLabel(dataToRender);
					//we don't need to invalidate because the label setter
					//uses the same data invalidation flag that triggered this
					//call to commitData(), so we're already properly invalid.
				}
				if(this._itemHasSkin)
				{
					var newSkin:DisplayObject = this.itemToSkin(dataToRender);
					this._skinIsFromItem = newSkin != null;
					this.replaceSkin(newSkin);
				}
				else if(this._skinIsFromItem)
				{
					this._skinIsFromItem = false;
					this.replaceSkin(null);
				}
				if(this._itemHasIcon)
				{
					var newIcon:DisplayObject = this.itemToIcon(dataToRender);
					this._iconIsFromItem = newIcon != null;
					this.replaceIcon(newIcon);
				}
				else if(this._iconIsFromItem)
				{
					this._iconIsFromItem = false;
					this.replaceIcon(null);
				}
				if(this._itemHasAccessory)
				{
					var newAccessory:DisplayObject = this.itemToAccessory(dataToRender);
					this._accessoryIsFromItem = newAccessory != null;
					this.replaceAccessory(newAccessory);
				}
				else if(this._accessoryIsFromItem)
				{
					this._accessoryIsFromItem = false;
					this.replaceAccessory(null);
				}
				if(this._itemHasSelectable)
				{
					this._isToggle = this._explicitIsToggle && this.itemToSelectable(dataToRender);
				}
				else
				{
					this._isToggle = this._explicitIsToggle;
				}
				if(this._itemHasEnabled)
				{
					this.refreshIsEnabled(this._explicitIsEnabled && this.itemToEnabled(dataToRender));
				}
				else
				{
					this.refreshIsEnabled(this._explicitIsEnabled);
				}
			}
			else
			{
				if(this._itemHasLabel)
				{
					this._label = "";
				}
				if(this._itemHasIcon || this._iconIsFromItem)
				{
					this._iconIsFromItem = false;
					this.replaceIcon(null);
				}
				if(this._itemHasSkin || this._skinIsFromItem)
				{
					this._skinIsFromItem = false;
					this.replaceSkin(null);
				}
				if(this._itemHasAccessory || this._accessoryIsFromItem)
				{
					this._accessoryIsFromItem = false;
					this.replaceAccessory(null);
				}
				if(this._itemHasSelectable)
				{
					this._isToggle = this._explicitIsToggle;
				}
				if(this._itemHasEnabled)
				{
					this.refreshIsEnabled(this._explicitIsEnabled);
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshIsEnabled(value:Boolean):void
		{
			if(this._isEnabled == value)
			{
				return;
			}
			this._isEnabled = value;
			if(this._isEnabled)
			{
				//might be in another state for some reason
				//let's only change to up if needed
				if(this._currentState == ButtonState.DISABLED)
				{
					this._currentState = ButtonState.UP;
				}
				this.touchable = true;
			}
			else
			{
				this._currentState = ButtonState.DISABLED;
				this.touchable = false;
			}
			this.setInvalidationFlag(INVALIDATION_FLAG_STATE);
			this.dispatchEventWith(FeathersEventType.STATE_CHANGE);
		}

		/**
		 * @private
		 */
		protected function replaceIcon(newIcon:DisplayObject):void
		{
			if(this.iconLoader && this.iconLoader != newIcon)
			{
				this.iconLoader.removeEventListener(Event.COMPLETE, loader_completeOrErrorHandler);
				this.iconLoader.removeEventListener(FeathersEventType.ERROR, loader_completeOrErrorHandler);
				this.iconLoader.dispose();
				this.iconLoader = null;
			}

			if(this.iconLabel && this.iconLabel != newIcon)
			{
				//we can dispose this one, though, since we created it
				this.iconLabel.dispose();
				this.iconLabel = null;
			}

			if(this._itemHasIcon && this.currentIcon && this.currentIcon != newIcon && this.currentIcon.parent == this)
			{
				//the icon is created using the data provider, and it is not
				//created inside this class, so it is not our responsibility to
				//dispose the icon. if we dispose it, it may break something.
				this.currentIcon.removeFromParent(false);
				this.currentIcon = null;
			}
			//we're using currentIcon above, but we're emulating calling the
			//defaultIcon setter here. the Button class sets the currentIcon
			//elsewhere, so we want to take advantage of that exisiting code.

			//we're not calling the defaultIcon setter directly because we're in
			//the middle of validating, and it will just invalidate, which will
			//require another validation later. we want the Button class to
			//process the new icon immediately when we call super.draw().
			if(this._defaultIcon !== newIcon)
			{
				this._defaultIcon = newIcon;
				//we don't need to do a full invalidation. the superclass will
				//correctly see this flag when we call super.draw().
				this.setInvalidationFlag(INVALIDATION_FLAG_STYLES);
			}

			if(this.iconLoader !== null)
			{
				this.iconLoader.delayTextureCreation = this._delayTextureCreationOnScroll && this._owner !== null && this._owner.isScrolling;
			}
		}

		/**
		 * @private
		 */
		protected function replaceAccessory(newAccessory:DisplayObject):void
		{
			if(this.accessoryLoader && this.accessoryLoader != newAccessory)
			{
				this.accessoryLoader.removeEventListener(Event.COMPLETE, loader_completeOrErrorHandler);
				this.accessoryLoader.removeEventListener(FeathersEventType.ERROR, loader_completeOrErrorHandler);
				this.accessoryLoader.dispose();
				this.accessoryLoader = null;
			}

			if(this.accessoryLabel && this.accessoryLabel != newAccessory)
			{
				//we can dispose this one, though, since we created it
				this.accessoryLabel.dispose();
				this.accessoryLabel = null;
			}

			if(this._itemHasAccessory && this.currentAccessory && this.currentAccessory != newAccessory && this.currentAccessory.parent == this)
			{
				//the icon is created using the data provider, and it is not
				//created inside this class, so it is not our responsibility to
				//dispose the icon. if we dispose it, it may break something.
				this.currentAccessory.removeFromParent(false);
				this.currentAccessory = null;
			}
			//we're using currentIcon above, but we're emulating calling the
			//defaultIcon setter here. the Button class sets the currentIcon
			//elsewhere, so we want to take advantage of that exisiting code.

			//we're not calling the defaultIcon setter directly because we're in
			//the middle of validating, and it will just invalidate, which will
			//require another validation later. we want the Button class to
			//process the new icon immediately when we call super.draw().
			if(this._defaultAccessory !== newAccessory)
			{
				this._defaultAccessory = newAccessory;
				//we don't need to do a full invalidation. the superclass will
				//correctly see this flag when we call super.draw().
				this.setInvalidationFlag(INVALIDATION_FLAG_STYLES);
			}

			if(this.accessoryLoader !== null)
			{
				this.accessoryLoader.delayTextureCreation = this._delayTextureCreationOnScroll && this._owner !== null && this._owner.isScrolling;
			}
		}

		/**
		 * @private
		 */
		protected function replaceSkin(newSkin:DisplayObject):void
		{
			if(this.skinLoader && this.skinLoader != newSkin)
			{
				this.skinLoader.removeEventListener(Event.COMPLETE, loader_completeOrErrorHandler);
				this.skinLoader.removeEventListener(FeathersEventType.ERROR, loader_completeOrErrorHandler);
				this.skinLoader.dispose();
				this.skinLoader = null;
			}

			if(this._itemHasSkin && this.currentSkin && this.currentSkin != newSkin && this.currentSkin.parent == this)
			{
				//the icon is created using the data provider, and it is not
				//created inside this class, so it is not our responsibility to
				//dispose the icon. if we dispose it, it may break something.
				this.currentSkin.removeFromParent(false);
				this.currentSkin = null;
			}
			//we're using currentIcon above, but we're emulating calling the
			//defaultIcon setter here. the Button class sets the currentIcon
			//elsewhere, so we want to take advantage of that exisiting code.

			//we're not calling the defaultSkin setter directly because we're in
			//the middle of validating, and it will just invalidate, which will
			//require another validation later. we want the Button class to
			//process the new skin immediately when we call super.draw().
			if(this._defaultSkin !== newSkin)
			{
				this._defaultSkin = newSkin;
				//we don't need to do a full invalidation. the superclass will
				//correctly see this flag when we call super.draw().
				this.setInvalidationFlag(INVALIDATION_FLAG_STYLES);
			}

			if(this.skinLoader !== null)
			{
				this.skinLoader.delayTextureCreation = this._delayTextureCreationOnScroll && this._owner !== null && this._owner.isScrolling;
			}
		}

		/**
		 * @private
		 */
		override protected function refreshIcon():void
		{
			super.refreshIcon();
			if(this.iconLabel !== null)
			{
				this.iconLabel.fontStyles = this._iconLabelFontStylesSet;
				var displayIconLabel:DisplayObject = DisplayObject(this.iconLabel);
				for(var propertyName:String in this._iconLabelProperties)
				{
					var propertyValue:Object = this._iconLabelProperties[propertyName];
					displayIconLabel[propertyName] = propertyValue;
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshAccessory():void
		{
			var oldAccessory:DisplayObject = this.currentAccessory;
			this.currentAccessory = this.getCurrentAccessory();
			if(this.currentAccessory is IFeathersControl)
			{
				IFeathersControl(this.currentAccessory).isEnabled = this._isEnabled;
			}
			if(this.currentAccessory != oldAccessory)
			{
				if(oldAccessory)
				{
					if(oldAccessory is IStateObserver)
					{
						IStateObserver(oldAccessory).stateContext = null;
					}
					if(oldAccessory is IFeathersControl)
					{
						IFeathersControl(oldAccessory).removeEventListener(FeathersEventType.RESIZE, accessory_resizeHandler);
						IFeathersControl(oldAccessory).removeEventListener(TouchEvent.TOUCH, accessory_touchHandler);
					}
					this.removeChild(oldAccessory, false);
				}
				if(this.currentAccessory)
				{
					if(this.currentAccessory is IStateObserver)
					{
						IStateObserver(this.currentAccessory).stateContext = this;
					}
					this.addChild(this.currentAccessory);
					if(this.currentAccessory is IFeathersControl)
					{
						IFeathersControl(this.currentAccessory).addEventListener(FeathersEventType.RESIZE, accessory_resizeHandler);
						IFeathersControl(this.currentAccessory).addEventListener(TouchEvent.TOUCH, accessory_touchHandler);
					}
				}
			}
			if(this.accessoryLabel !== null)
			{
				this.accessoryLabel.fontStyles = this._accessoryLabelFontStylesSet;
				var displayAccessoryLabel:DisplayObject = DisplayObject(this.accessoryLabel);
				for(var propertyName:String in this._accessoryLabelProperties)
				{
					var propertyValue:Object = this._accessoryLabelProperties[propertyName];
					displayAccessoryLabel[propertyName] = propertyValue;
				}
			}
		}

		/**
		 * @private
		 */
		protected function getCurrentAccessory():DisplayObject
		{
			//we use the currentState getter here instead of the variable
			//because the variable does not keep track of the selection
			var result:DisplayObject = this._stateToAccessory[this.currentState] as DisplayObject;
			if(result !== null)
			{
				return result;
			}
			return this._defaultAccessory;
		}

		/**
		 * @private
		 */
		protected function refreshIconSource(source:Object):void
		{
			if(!this.iconLoader)
			{
				this.iconLoader = this._iconLoaderFactory();
				this.iconLoader.addEventListener(Event.COMPLETE, loader_completeOrErrorHandler);
				this.iconLoader.addEventListener(Event.IO_ERROR, loader_completeOrErrorHandler);
				this.iconLoader.addEventListener(Event.SECURITY_ERROR, loader_completeOrErrorHandler);
				var iconLoaderStyleName:String = this._customIconLoaderStyleName != null ? this._customIconLoaderStyleName : this.iconLoaderStyleName;
				this.iconLoader.styleNameList.add(iconLoaderStyleName);
			}
			this.iconLoader.source = source;
		}

		/**
		 * @private
		 */
		protected function refreshIconLabel(label:String):void
		{
			if(this.iconLabel === null)
			{
				var factory:Function = this._iconLabelFactory != null ? this._iconLabelFactory : FeathersControl.defaultTextRendererFactory;
				this.iconLabel = ITextRenderer(factory());
				if(this.iconLabel is IStateObserver)
				{
					IStateObserver(this.iconLabel).stateContext = this;
				}
				var iconLabelStyleName:String = this._customIconLabelStyleName != null ? this._customIconLabelStyleName : this.iconLabelStyleName;
				this.iconLabel.styleNameList.add(iconLabelStyleName);
			}
			this.iconLabel.text = label;
		}

		/**
		 * @private
		 */
		protected function refreshAccessorySource(source:Object):void
		{
			if(!this.accessoryLoader)
			{
				this.accessoryLoader = this._accessoryLoaderFactory();
				this.accessoryLoader.addEventListener(Event.COMPLETE, loader_completeOrErrorHandler);
				this.accessoryLoader.addEventListener(Event.IO_ERROR, loader_completeOrErrorHandler);
				this.accessoryLoader.addEventListener(Event.SECURITY_ERROR, loader_completeOrErrorHandler);
				var accessoryLoaderStyleName:String = this._customAccessoryLoaderStyleName != null ? this._customAccessoryLoaderStyleName : this.accessoryLoaderStyleName;
				this.accessoryLoader.styleNameList.add(accessoryLoaderStyleName);
			}
			this.accessoryLoader.source = source;
		}

		/**
		 * @private
		 */
		protected function refreshAccessoryLabel(label:String):void
		{
			if(this.accessoryLabel === null)
			{
				var factory:Function = this._accessoryLabelFactory != null ? this._accessoryLabelFactory : FeathersControl.defaultTextRendererFactory;
				this.accessoryLabel = ITextRenderer(factory());
				if(this.accessoryLabel is IStateObserver)
				{
					IStateObserver(this.accessoryLabel).stateContext = this;
				}
				var accessoryLabelStyleName:String = this._customAccessoryLabelStyleName != null ? this._customAccessoryLabelStyleName : this.accessoryLabelStyleName;
				this.accessoryLabel.styleNameList.add(accessoryLabelStyleName);
			}
			this.accessoryLabel.text = label;
		}

		/**
		 * @private
		 */
		protected function refreshSkinSource(source:Object):void
		{
			if(!this.skinLoader)
			{
				this.skinLoader = this._skinLoaderFactory();
				this.skinLoader.addEventListener(Event.COMPLETE, loader_completeOrErrorHandler);
				this.skinLoader.addEventListener(FeathersEventType.ERROR, loader_completeOrErrorHandler);
			}
			this.skinLoader.source = source;
		}

		/**
		 * @private
		 */
		override protected function layoutContent():void
		{
			var oldIgnoreAccessoryResizes:Boolean = this._ignoreAccessoryResizes;
			this._ignoreAccessoryResizes = true;
			var oldIgnoreIconResizes:Boolean = this._ignoreIconResizes;
			this._ignoreIconResizes = true;
			this.refreshLabelTextRendererDimensions(false);
			var labelRenderer:DisplayObject = null;
			if(this._label !== null && this.labelTextRenderer !== null)
			{
				labelRenderer = DisplayObject(this.labelTextRenderer);
			}
			var iconIsInLayout:Boolean = this.currentIcon && this._iconPosition != RelativePosition.MANUAL;
			var accessoryIsInLayout:Boolean = this.currentAccessory && this._accessoryPosition != RelativePosition.MANUAL;
			var accessoryGap:Number = this._accessoryGap;
			if(accessoryGap !== accessoryGap) //isNaN
			{
				accessoryGap = this._gap;
			}
			if(labelRenderer && iconIsInLayout && accessoryIsInLayout)
			{
				this.positionSingleChild(labelRenderer);
				if(this._layoutOrder == ItemRendererLayoutOrder.LABEL_ACCESSORY_ICON)
				{
					this.positionRelativeToOthers(this.currentAccessory, labelRenderer, null, this._accessoryPosition, accessoryGap, null, 0);
					var iconPosition:String = this._iconPosition;
					if(iconPosition == RelativePosition.LEFT_BASELINE)
					{
						iconPosition = RelativePosition.LEFT;
					}
					else if(iconPosition == RelativePosition.RIGHT_BASELINE)
					{
						iconPosition = RelativePosition.RIGHT;
					}
					this.positionRelativeToOthers(this.currentIcon, labelRenderer, this.currentAccessory, iconPosition, this._gap, this._accessoryPosition, accessoryGap);
				}
				else
				{
					this.positionLabelAndIcon();
					this.positionRelativeToOthers(this.currentAccessory, labelRenderer, this.currentIcon, this._accessoryPosition, accessoryGap, this._iconPosition, this._gap);
				}
			}
			else if(labelRenderer)
			{
				this.positionSingleChild(labelRenderer);
				//we won't position both the icon and accessory here, otherwise
				//we would have gone into the previous conditional
				if(iconIsInLayout)
				{
					this.positionLabelAndIcon();
				}
				else if(accessoryIsInLayout)
				{
					this.positionRelativeToOthers(this.currentAccessory, labelRenderer, null, this._accessoryPosition, accessoryGap, null, 0);
				}
			}
			else if(iconIsInLayout)
			{
				this.positionSingleChild(this.currentIcon);
				if(accessoryIsInLayout)
				{
					this.positionRelativeToOthers(this.currentAccessory, this.currentIcon, null, this._accessoryPosition, accessoryGap, null, 0);
				}
			}
			else if(accessoryIsInLayout)
			{
				this.positionSingleChild(this.currentAccessory);
			}

			if(this.currentAccessory)
			{
				if(!accessoryIsInLayout)
				{
					this.currentAccessory.x = this._leftOffset;
					this.currentAccessory.y = this._topOffset;
				}
				this.currentAccessory.x += this._accessoryOffsetX;
				this.currentAccessory.y += this._accessoryOffsetY;
			}
			if(this.currentIcon)
			{
				if(!iconIsInLayout)
				{
					this.currentIcon.x = this._leftOffset;
					this.currentIcon.y = this._topOffset;
				}
				this.currentIcon.x += this._iconOffsetX;
				this.currentIcon.y += this._iconOffsetY;
			}
			if(labelRenderer)
			{
				this.labelTextRenderer.x += this._labelOffsetX;
				this.labelTextRenderer.y += this._labelOffsetY;
			}
			this._ignoreIconResizes = oldIgnoreIconResizes;
			this._ignoreAccessoryResizes = oldIgnoreAccessoryResizes;
		}

		/**
		 * @private
		 */
		protected function refreshOffsets():void
		{
			this._topOffset = this._paddingTop;
			this._rightOffset = this._paddingRight;
			this._bottomOffset = this._paddingBottom;
			this._leftOffset = this._paddingLeft;
		}

		/**
		 * @private
		 */
		override protected function refreshLabelTextRendererDimensions(forMeasurement:Boolean):void
		{
			var oldIgnoreIconResizes:Boolean = this._ignoreIconResizes;
			this._ignoreIconResizes = true;
			var calculatedWidth:Number = this.actualWidth;
			if(forMeasurement)
			{
				calculatedWidth = this._explicitWidth;
				if(calculatedWidth !== calculatedWidth) //isNaN
				{
					calculatedWidth = this._explicitMaxWidth;
				}
			}
			calculatedWidth -= (this._leftOffset + this._rightOffset);
			var calculatedHeight:Number = this.actualHeight;
			if(forMeasurement)
			{
				calculatedHeight = this._explicitHeight;
				if(calculatedHeight !== calculatedHeight) //isNaN
				{
					calculatedHeight = this._explicitMaxHeight;
				}
			}
			calculatedHeight -= (this._topOffset + this._bottomOffset);

			var adjustedGap:Number = this._gap;
			if(adjustedGap == Number.POSITIVE_INFINITY)
			{
				adjustedGap = this._minGap;
			}
			var adjustedAccessoryGap:Number = this._accessoryGap;
			if(adjustedAccessoryGap !== adjustedAccessoryGap) //isNaN
			{
				adjustedAccessoryGap = this._gap;
			}
			if(adjustedAccessoryGap == Number.POSITIVE_INFINITY)
			{
				adjustedAccessoryGap = this._minAccessoryGap;
				if(adjustedAccessoryGap !== adjustedAccessoryGap) //isNaN
				{
					adjustedAccessoryGap = this._minGap;
				}
			}

			var hasIconToLeftOrRight:Boolean = this.currentIcon && (this._iconPosition == RelativePosition.LEFT || this._iconPosition == RelativePosition.LEFT_BASELINE ||
				this._iconPosition == RelativePosition.RIGHT || this._iconPosition == RelativePosition.RIGHT_BASELINE);
			var hasIconToTopOrBottom:Boolean = this.currentIcon && (this._iconPosition == RelativePosition.TOP || this._iconPosition == RelativePosition.BOTTOM);
			var hasAccessoryToLeftOrRight:Boolean = this.currentAccessory && (this._accessoryPosition == RelativePosition.LEFT || this._accessoryPosition == RelativePosition.RIGHT);
			var hasAccessoryToTopOrBottom:Boolean = this.currentAccessory && (this._accessoryPosition == RelativePosition.TOP || this._accessoryPosition == RelativePosition.BOTTOM);

			if(this.accessoryLabel)
			{
				var iconAffectsAccessoryLabelMaxWidth:Boolean = hasIconToLeftOrRight &&
					(hasAccessoryToLeftOrRight || this._layoutOrder === ItemRendererLayoutOrder.LABEL_ACCESSORY_ICON);
				if(this.iconLabel)
				{
					this.iconLabel.maxWidth = calculatedWidth - adjustedGap;
					if(this.iconLabel.maxWidth < 0)
					{
						this.iconLabel.maxWidth = 0;
					}
				}
				if(this.currentIcon is IValidating)
				{
					IValidating(this.currentIcon).validate();
				}
				if(iconAffectsAccessoryLabelMaxWidth)
				{
					calculatedWidth -= (this.currentIcon.width + adjustedGap);
				}
				if(calculatedWidth < 0)
				{
					calculatedWidth = 0;
				}
				this.accessoryLabel.maxWidth = calculatedWidth;
				this.accessoryLabel.maxHeight = calculatedHeight;
				if(hasIconToLeftOrRight && this.currentIcon && !iconAffectsAccessoryLabelMaxWidth)
				{
					calculatedWidth -= (this.currentIcon.width + adjustedGap);
				}
				if(this.currentAccessory is IValidating)
				{
					IValidating(this.currentAccessory).validate();
				}
				if(hasAccessoryToLeftOrRight)
				{
					calculatedWidth -= (this.currentAccessory.width + adjustedAccessoryGap);
				}
				if(hasAccessoryToTopOrBottom)
				{
					calculatedHeight -= (this.currentAccessory.height + adjustedAccessoryGap);
				}
			}
			else if(this.iconLabel)
			{
				var accessoryAffectsIconLabelMaxWidth:Boolean = hasAccessoryToLeftOrRight &&
					(hasIconToLeftOrRight || this._layoutOrder === ItemRendererLayoutOrder.LABEL_ICON_ACCESSORY);
				if(this.currentAccessory is IValidating)
				{
					IValidating(this.currentAccessory).validate();
				}
				if(accessoryAffectsIconLabelMaxWidth)
				{
					calculatedWidth -= (adjustedAccessoryGap + this.currentAccessory.width);
				}
				if(calculatedWidth < 0)
				{
					calculatedWidth = 0;
				}
				this.iconLabel.maxWidth = calculatedWidth;
				this.iconLabel.maxHeight = calculatedHeight;
				if(hasAccessoryToLeftOrRight && this.currentAccessory && !accessoryAffectsIconLabelMaxWidth)
				{
					calculatedWidth -= (adjustedAccessoryGap + this.currentAccessory.width);
				}
				if(this.currentIcon is IValidating)
				{
					IValidating(this.currentIcon).validate();
				}
				if(hasIconToLeftOrRight)
				{
					calculatedWidth -= (this.currentIcon.width + adjustedGap);
				}
				if(hasIconToTopOrBottom)
				{
					calculatedHeight -= (this.currentIcon.height + adjustedGap);
				}
			}
			else
			{
				if(this.currentIcon is IValidating)
				{
					IValidating(this.currentIcon).validate();
				}
				if(hasIconToLeftOrRight)
				{
					calculatedWidth -= (adjustedGap + this.currentIcon.width);
				}
				if(hasIconToTopOrBottom)
				{
					calculatedHeight -= (adjustedGap + this.currentIcon.height);
				}
				if(this.currentAccessory is IValidating)
				{
					IValidating(this.currentAccessory).validate();
				}
				if(hasAccessoryToLeftOrRight)
				{
					calculatedWidth -= (adjustedAccessoryGap + this.currentAccessory.width);
				}
				if(hasAccessoryToTopOrBottom)
				{
					calculatedHeight -= (adjustedAccessoryGap + this.currentAccessory.height);
				}
			}
			if(calculatedWidth < 0)
			{
				calculatedWidth = 0;
			}
			if(calculatedHeight < 0)
			{
				calculatedHeight = 0;
			}
			if(calculatedWidth > this._explicitLabelMaxWidth)
			{
				calculatedWidth = this._explicitLabelMaxWidth;
			}
			if(calculatedHeight > this._explicitLabelMaxHeight)
			{
				calculatedHeight = this._explicitLabelMaxHeight;
			}
			if(this.labelTextRenderer !== null)
			{
				this.labelTextRenderer.width = this._explicitLabelWidth;
				this.labelTextRenderer.height = this._explicitLabelHeight;
				this.labelTextRenderer.minWidth = this._explicitLabelMinWidth;
				this.labelTextRenderer.minHeight = this._explicitLabelMinHeight;
				this.labelTextRenderer.maxWidth = calculatedWidth;
				this.labelTextRenderer.maxHeight = calculatedHeight;
				this.labelTextRenderer.validate();
				if(!forMeasurement)
				{
					calculatedWidth = this.labelTextRenderer.width;
					calculatedHeight = this.labelTextRenderer.height;
					//setting all of these dimensions explicitly means that the
					//text renderer won't measure itself again when it
					//validates, which helps performance. we'll reset them when
					//the item renderer needs to measure itself.
					this.labelTextRenderer.width = calculatedWidth;
					this.labelTextRenderer.height = calculatedHeight;
					this.labelTextRenderer.minWidth = calculatedWidth;
					this.labelTextRenderer.minHeight = calculatedHeight;
				}
			}
			this._ignoreIconResizes = oldIgnoreIconResizes;
		}

		/**
		 * @private
		 */
		override protected function positionSingleChild(displayObject:DisplayObject):void
		{
			if(this._horizontalAlign === HorizontalAlign.LEFT)
			{
				displayObject.x = this._leftOffset;
			}
			else if(this._horizontalAlign === HorizontalAlign.RIGHT)
			{
				displayObject.x = this.actualWidth - this._rightOffset - displayObject.width;
			}
			else //center
			{
				displayObject.x = this._leftOffset + Math.round((this.actualWidth - this._leftOffset - this._rightOffset - displayObject.width) / 2);
			}
			if(this._verticalAlign === VerticalAlign.TOP)
			{
				displayObject.y = this._topOffset;
			}
			else if(this._verticalAlign === VerticalAlign.BOTTOM)
			{
				displayObject.y = this.actualHeight - this._bottomOffset - displayObject.height;
			}
			else //middle
			{
				displayObject.y = this._topOffset + Math.round((this.actualHeight - this._topOffset - this._bottomOffset - displayObject.height) / 2);
			}
		}

		/**
		 * @private
		 */
		protected function positionRelativeToOthers(object:DisplayObject, relativeTo:DisplayObject, relativeTo2:DisplayObject, position:String, gap:Number, otherPosition:String, otherGap:Number):void
		{
			var relativeToX:Number = relativeTo.x;
			if(relativeTo2 !== null && relativeTo2.x < relativeToX)
			{
				relativeToX = relativeTo2.x;
			}
			var relativeToY:Number = relativeTo.y;
			if(relativeTo2 !== null && relativeTo2.y < relativeToY)
			{
				relativeToY = relativeTo2.y;
			}
			var relativeToWidth:Number = relativeTo.width;
			if(relativeTo2 !== null)
			{
				relativeToWidth = relativeTo.x + relativeTo.width;
				var relativeToWidth2:Number = relativeTo2.x + relativeTo2.width;
				if(relativeToWidth2 > relativeToWidth)
				{
					relativeToWidth = relativeToWidth2;
				}
				relativeToWidth -= relativeToX;
			}
			var relativeToHeight:Number = relativeTo.height;
			if(relativeTo2 !== null)
			{
				relativeToHeight = relativeTo.y + relativeTo.height;
				var relativeToHeight2:Number = relativeTo2.y + relativeTo2.height;
				if(relativeToHeight2 > relativeToHeight)
				{
					relativeToHeight = relativeToHeight2;
				}
				relativeToHeight -= relativeToY;
			}
			var newRelativeToX:Number = relativeToX;
			var newRelativeToY:Number = relativeToY;
			if(position == RelativePosition.TOP)
			{
				if(gap == Number.POSITIVE_INFINITY)
				{
					object.y = this._topOffset;
					newRelativeToY = this.actualHeight - this._bottomOffset - relativeToHeight;
				}
				else
				{
					if(this._verticalAlign == VerticalAlign.TOP)
					{
						newRelativeToY += object.height + gap;
					}
					else if(this._verticalAlign == VerticalAlign.MIDDLE)
					{
						newRelativeToY += Math.round((object.height + gap) / 2);
					}
					if(relativeTo2 != null)
					{
						var newRelativeToY2:Number = this._topOffset + object.height + gap;
						if(newRelativeToY2 > newRelativeToY)
						{
							newRelativeToY = newRelativeToY2;
						}
					}
					object.y = newRelativeToY - object.height - gap;
				}
			}
			else if(position == RelativePosition.RIGHT)
			{
				if(gap == Number.POSITIVE_INFINITY)
				{
					newRelativeToX = this._leftOffset;
					object.x = this.actualWidth - this._rightOffset - object.width;
				}
				else
				{
					if(this._horizontalAlign == HorizontalAlign.RIGHT)
					{
						newRelativeToX -= (object.width + gap);
					}
					else if(this._horizontalAlign == HorizontalAlign.CENTER)
					{
						newRelativeToX -= Math.round((object.width + gap) / 2);
					}
					if(relativeTo2 !== null)
					{
						var newRelativeToX2:Number = this.actualWidth - this._rightOffset - object.width - relativeToWidth - gap;
						if(newRelativeToX2 < newRelativeToX)
						{
							newRelativeToX = newRelativeToX2;
						}
					}
					object.x = newRelativeToX + relativeToWidth + gap;
				}
			}
			else if(position == RelativePosition.BOTTOM)
			{
				if(gap == Number.POSITIVE_INFINITY)
				{
					newRelativeToY = this._topOffset;
					object.y = this.actualHeight - this._bottomOffset - object.height;
				}
				else
				{
					if(this._verticalAlign == VerticalAlign.BOTTOM)
					{
						newRelativeToY -= (object.height + gap);
					}
					else if(this._verticalAlign == VerticalAlign.MIDDLE)
					{
						newRelativeToY -= Math.round((object.height + gap) / 2);
					}
					if(relativeTo2 !== null)
					{
						newRelativeToY2 = this.actualHeight - this._bottomOffset - object.height - relativeToHeight - gap;
						if(newRelativeToY2 < newRelativeToY)
						{
							newRelativeToY = newRelativeToY2;
						}
					}
					object.y = newRelativeToY + relativeToHeight + gap;
				}
			}
			else if(position == RelativePosition.LEFT)
			{
				if(gap == Number.POSITIVE_INFINITY)
				{
					object.x = this._leftOffset;
					newRelativeToX = this.actualWidth - this._rightOffset - relativeToWidth;
				}
				else
				{
					if(this._horizontalAlign == HorizontalAlign.LEFT)
					{
						newRelativeToX += gap + object.width;
					}
					else if(this._horizontalAlign == HorizontalAlign.CENTER)
					{
						newRelativeToX += Math.round((gap + object.width) / 2);
					}
					if(relativeTo2 !== null)
					{
						newRelativeToX2 = this._leftOffset + object.width + gap;
						if(newRelativeToX2 > newRelativeToX)
						{
							newRelativeToX = newRelativeToX2;
						}
					}
					object.x = newRelativeToX - gap - object.width;
				}
			}

			var offsetX:Number = newRelativeToX - relativeToX;
			var offsetY:Number = newRelativeToY - relativeToY;
			if(!relativeTo2 || otherGap != Number.POSITIVE_INFINITY || !(
				(position == RelativePosition.TOP && otherPosition == RelativePosition.TOP) ||
				(position == RelativePosition.RIGHT && otherPosition == RelativePosition.RIGHT) ||
				(position == RelativePosition.BOTTOM && otherPosition == RelativePosition.BOTTOM) ||
				(position == RelativePosition.LEFT && otherPosition == RelativePosition.LEFT)
			))
			{
				relativeTo.x += offsetX;
				relativeTo.y += offsetY;
			}
			if(relativeTo2)
			{
				if(otherGap != Number.POSITIVE_INFINITY || !(
					(position == RelativePosition.LEFT && otherPosition == RelativePosition.RIGHT) ||
					(position == RelativePosition.RIGHT && otherPosition == RelativePosition.LEFT) ||
					(position == RelativePosition.TOP && otherPosition == RelativePosition.BOTTOM) ||
					(position == RelativePosition.BOTTOM && otherPosition == RelativePosition.TOP)
				))
				{
					relativeTo2.x += offsetX;
					relativeTo2.y += offsetY;
				}
				if(gap == Number.POSITIVE_INFINITY && otherGap == Number.POSITIVE_INFINITY)
				{
					if(position == RelativePosition.RIGHT && otherPosition == RelativePosition.LEFT)
					{
						relativeTo.x = relativeTo2.x + Math.round((object.x - relativeTo2.x + relativeTo2.width - relativeTo.width) / 2);
					}
					else if(position == RelativePosition.LEFT && otherPosition == RelativePosition.RIGHT)
					{
						relativeTo.x = object.x + Math.round((relativeTo2.x - object.x + object.width - relativeTo.width) / 2);
					}
					else if(position == RelativePosition.RIGHT && otherPosition == RelativePosition.RIGHT)
					{
						relativeTo2.x = relativeTo.x + Math.round((object.x - relativeTo.x + relativeTo.width - relativeTo2.width) / 2);
					}
					else if(position == RelativePosition.LEFT && otherPosition == RelativePosition.LEFT)
					{
						relativeTo2.x = object.x + Math.round((relativeTo.x - object.x + object.width - relativeTo2.width) / 2);
					}
					else if(position == RelativePosition.BOTTOM && otherPosition == RelativePosition.TOP)
					{
						relativeTo.y = relativeTo2.y + Math.round((object.y - relativeTo2.y + relativeTo2.height - relativeTo.height) / 2);
					}
					else if(position == RelativePosition.TOP && otherPosition == RelativePosition.BOTTOM)
					{
						relativeTo.y = object.y + Math.round((relativeTo2.y - object.y + object.height - relativeTo.height) / 2);
					}
					else if(position == RelativePosition.BOTTOM && otherPosition == RelativePosition.BOTTOM)
					{
						relativeTo2.y = relativeTo.y + Math.round((object.y - relativeTo.y + relativeTo.height - relativeTo2.height) / 2);
					}
					else if(position == RelativePosition.TOP && otherPosition == RelativePosition.TOP)
					{
						relativeTo2.y = object.y + Math.round((relativeTo.y - object.y + object.height - relativeTo2.height) / 2);
					}
				}
			}

			if(position == RelativePosition.LEFT || position == RelativePosition.RIGHT)
			{
				if(this._verticalAlign == VerticalAlign.TOP)
				{
					object.y = this._topOffset;
				}
				else if(this._verticalAlign == VerticalAlign.BOTTOM)
				{
					object.y = this.actualHeight - this._bottomOffset - object.height;
				}
				else //middle
				{
					object.y = this._topOffset + Math.round((this.actualHeight - this._topOffset - this._bottomOffset - object.height) / 2);
				}
			}
			else if(position == RelativePosition.TOP || position == RelativePosition.BOTTOM)
			{
				if(this._horizontalAlign == HorizontalAlign.LEFT)
				{
					object.x = this._leftOffset;
				}
				else if(this._horizontalAlign == HorizontalAlign.RIGHT)
				{
					object.x = this.actualWidth - this._rightOffset - object.width;
				}
				else //center
				{
					object.x = this._leftOffset + Math.round((this.actualWidth - this._leftOffset - this._rightOffset - object.width) / 2);
				}
			}
		}

		/**
		 * @private
		 */
		override protected function refreshSelectionEvents():void
		{
			var selectionEnabled:Boolean = this._isEnabled &&
				(this._isToggle || this.isSelectableWithoutToggle);
			if(this._itemHasSelectable)
			{
				selectionEnabled &&= this.itemToSelectable(this._data);
			}
			if(this.accessoryTouchPointID >= 0)
			{
				selectionEnabled &&= this._isSelectableOnAccessoryTouch;
			}
			this.tapToSelect.isEnabled = selectionEnabled;
			this.tapToSelect.tapToDeselect = this._isToggle;
			this.keyToSelect.isEnabled = false;
		}

		/**
		 * @private
		 */
		protected function hitTestWithAccessory(localPosition:Point):Boolean
		{
			if(this._isQuickHitAreaEnabled ||
				this._isSelectableOnAccessoryTouch ||
				this.currentAccessory === null ||
				this.currentAccessory === this.accessoryLabel ||
				this.currentAccessory === this.accessoryLoader)
			{
				return true;
			}
			if(this.currentAccessory is DisplayObjectContainer)
			{
				var container:DisplayObjectContainer = DisplayObjectContainer(this.currentAccessory);
				return !container.contains(this.hitTest(localPosition));
			}
			return this.hitTest(localPosition) !== this.currentAccessory;
		}

		/**
		 * @private
		 */
		protected function owner_scrollStartHandler(event:Event):void
		{
			if(this._delayTextureCreationOnScroll)
			{
				if(this.accessoryLoader)
				{
					this.accessoryLoader.delayTextureCreation = true;
				}
				if(this.iconLoader)
				{
					this.iconLoader.delayTextureCreation = true;
				}
			}

			if(this.accessoryTouchPointID >= 0)
			{
				this._owner.stopScrolling();
			}
		}

		/**
		 * @private
		 */
		protected function owner_scrollCompleteHandler(event:Event):void
		{
			if(this._delayTextureCreationOnScroll)
			{
				if(this.accessoryLoader)
				{
					this.accessoryLoader.delayTextureCreation = false;
				}
				if(this.iconLoader)
				{
					this.iconLoader.delayTextureCreation = false;
				}
			}
		}

		/**
		 * @private
		 */
		protected function itemRenderer_removedFromStageHandler(event:Event):void
		{
			this.accessoryTouchPointID = -1;
		}

		/**
		 * @private
		 */
		protected function accessory_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this.accessoryTouchPointID = -1;
				return;
			}
			if(!this._stopScrollingOnAccessoryTouch ||
				this.currentAccessory === this.accessoryLabel ||
				this.currentAccessory === this.accessoryLoader)
			{
				//do nothing
				return;
			}

			if(this.accessoryTouchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this.currentAccessory, TouchPhase.ENDED, this.accessoryTouchPointID);
				if(!touch)
				{
					return;
				}
				this.accessoryTouchPointID = -1;
				this.refreshSelectionEvents();
			}
			else //if we get here, we don't have a saved touch ID yet
			{
				touch = event.getTouch(this.currentAccessory, TouchPhase.BEGAN);
				if(!touch)
				{
					return;
				}
				this.accessoryTouchPointID = touch.id;
				this.refreshSelectionEvents();
			}
		}

		/**
		 * @private
		 */
		protected function accessory_resizeHandler(event:Event):void
		{
			if(this._ignoreAccessoryResizes)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected function loader_completeOrErrorHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}
	}
}

================================================
FILE: source/feathers/controls/renderers/DefaultDataGridCellRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.DataGrid;
	import feathers.controls.DataGridColumn;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;

	/**
	 * The default cell renderer for the <code>DataGrid</code> component.
	 * Supports up to three optional sub-views, including a label to display
	 * text, an icon to display an image, and an "accessory" to display a UI
	 * component or another display object (with shortcuts for including a
	 * second image or a second label).
	 *
	 * @see feathers.controls.DataGrid
	 *
	 * @productversion Feathers 3.4.0
	 */
	public class DefaultDataGridCellRenderer extends BaseDefaultItemRenderer implements IDataGridCellRenderer
	{
		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#ALTERNATE_STYLE_NAME_CHECK
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_CHECK:String = "feathers-check-item-renderer";

		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#DEFAULT_CHILD_STYLE_NAME_LABEL
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_LABEL:String = "feathers-item-renderer-label";

		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#DEFAULT_CHILD_STYLE_NAME_ICON_LABEL
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ICON_LABEL:String = "feathers-item-renderer-icon-label";

		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LABEL
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LABEL:String = "feathers-item-renderer-accessory-label";

		/**
		 * The default <code>IStyleProvider</code> for all <code>DefaultListItemRenderer</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function DefaultDataGridCellRenderer()
		{
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return DefaultDataGridCellRenderer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _rowIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get rowIndex():int
		{
			return this._rowIndex;
		}

		/**
		 * @private
		 */
		public function set rowIndex(value:int):void
		{
			if(this._rowIndex == value)
			{
				return;
			}
			this._rowIndex = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _columnIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get columnIndex():int
		{
			return this._columnIndex;
		}

		/**
		 * @private
		 */
		public function set columnIndex(value:int):void
		{
			if(this._columnIndex == value)
			{
				return;
			}
			this._columnIndex = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _dataField:String = null;

		/**
		 * @inheritDoc
		 */
		public function get dataField():String
		{
			return this._dataField;
		}

		/**
		 * @private
		 */
		public function set dataField(value:String):void
		{
			if(this._dataField === value)
			{
				return;
			}
			this._dataField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _column:DataGridColumn = null;

		/**
		 * @inheritDoc
		 */
		public function get column():DataGridColumn
		{
			return this._column;
		}

		/**
		 * @private
		 */
		public function set column(value:DataGridColumn):void
		{
			if(this._column === value)
			{
				return;
			}
			this._column = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @inheritDoc
		 */
		public function get owner():DataGrid
		{
			return DataGrid(this._owner);
		}

		/**
		 * @private
		 */
		public function set owner(value:DataGrid):void
		{
			if(this._owner === value)
			{
				return;
			}
			if(this._owner)
			{
				this._owner.removeEventListener(FeathersEventType.SCROLL_START, owner_scrollStartHandler);
				this._owner.removeEventListener(FeathersEventType.SCROLL_COMPLETE, owner_scrollCompleteHandler);
			}
			this._owner = value;
			if(this._owner)
			{
				var grid:DataGrid = DataGrid(this._owner);
				this.isSelectableWithoutToggle = grid.isSelectable;
				if(grid.allowMultipleSelection)
				{
					//toggling is forced in this case
					this.isToggle = true;
				}
				this._owner.addEventListener(FeathersEventType.SCROLL_START, owner_scrollStartHandler);
				this._owner.addEventListener(FeathersEventType.SCROLL_COMPLETE, owner_scrollCompleteHandler);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.owner = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			super.initialize();
			//every cell in a row should be affected by touches anywhere
			//in the row, so use the parent as the target
			this.touchToState.target = this.parent;
		}

		/**
		 * @private
		 */
		override protected function getDataToRender():Object
		{
			if(this._data === null || this._dataField === null)
			{
				return this._data;
			}
			return this._data[this._dataField];
		}
	}
}

================================================
FILE: source/feathers/controls/renderers/DefaultDataGridHeaderRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.DataGrid;
	import feathers.controls.DataGridColumn;
	import feathers.controls.ImageLoader;
	import feathers.controls.renderers.IDataGridHeaderRenderer;
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.ITextRenderer;
	import feathers.core.IValidating;
	import feathers.data.SortOrder;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.skins.IStyleProvider;
	import feathers.text.FontStylesSet;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;
	import feathers.utils.touch.TapToTrigger;

	import flash.geom.Point;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.text.TextFormat;
	import starling.utils.Pool;

	/**
	 * A background to behind the header renderer's content.
	 *
	 * <p>In the following example, the header renderers is given a
	 * background skin:</p>
	 *
	 * <listing version="3.0">
	 * headerRenderer.backgroundSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundDisabledSkin
	 */
	[Style(name="backgroundSkin",type="starling.display.DisplayObject")]

	/**
	 * A background to display when the header renderer is disabled.
	 *
	 * <p>In the following example, the header renderers is given a
	 * disabled background skin:</p>
	 *
	 * <listing version="3.0">
	 * headerRenderer.backgroundDisabledSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundSkin
	 */
	[Style(name="backgroundDisabledSkin",type="starling.display.DisplayObject")]

	/**
	 * A style name to add to the header renderer's text renderer
	 * sub-component. Typically used by a theme to provide different styles to
	 * different header renderers.
	 *
	 * <p>In the following example, a custom text renderer style name is passed
	 * to the header renderer:</p>
	 *
	 * <listing version="3.0">
	 * headerRenderer.customTextRendererStyleName = "my-custom-header-text";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( BitmapFontTextRenderer ).setFunctionForStyleName( "my-custom-header-text", setCustomHeaderTextStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_TEXT_RENDERER
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #textRendererFactory
	 */
	[Style(name="customTextRendererStyleName",type="String")]

	/**
	 * The font styles used to display the header renderer's text when the
	 * component is disabled.
	 *
	 * <p>In the following example, the disabled font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * headerRenderer.disabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>textRendererFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:fontStyles
	 */
	[Style(name="disabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the header renderer's text.
	 *
	 * <p>In the following example, the font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * headerRenderer.fontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>textRendererFactory</code> to set more advanced styles.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:disabledFontStyles
	 */
	[Style(name="fontStyles",type="starling.text.TextFormat")]

	/**
	 * The location where the header renderer's content is aligned horizontally
	 * (on the x-axis).
	 *
	 * <p>In the following example, the horizontal alignment is changed to
	 * right:</p>
	 *
	 * <listing version="3.0">
	 * headerRenderer.horizontalAlign = HorizontalAlign.RIGHT;</listing>
	 *
	 * <p><strong>Note:</strong> The <code>HorizontalAlign.JUSTIFY</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.HorizontalAlign.LEFT
	 *
	 * @see feathers.layout.HorizontalAlign#LEFT
	 * @see feathers.layout.HorizontalAlign#CENTER
	 * @see feathers.layout.HorizontalAlign#RIGHT
	 */
	[Style(name="horizontalAlign",type="String")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the padding on all four sides is set to 20
	 * pixels:</p>
	 *
	 * <listing version="3.0">
	 * headerRenderer.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, between the component's top edge and
	 * the component's content.
	 *
	 * <p>In the following example, the top padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * headerRenderer.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the component's right edge
	 * and the component's content.
	 *
	 * <p>In the following example, the right padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * headerRenderer.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the component's bottom edge
	 * and the component's content.
	 *
	 * <p>In the following example, the bottom padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * headerRenderer.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the component's left edge
	 * and the component's content.
	 *
	 * <p>In the following example, the left padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * headerRenderer.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * An icon to display when the column is sorted in ascending order.
	 *
	 * <p>In the following example, sort ascending icon is customized:</p>
	 *
	 * <listing version="3.0">
	 * headerRenderer.sortAscendingIcon = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:sortDescendingIcon
	 */
	[Style(name="sortAscendingIcon",type="starling.display.DisplayObject")]

	/**
	 * An icon to display when the column is sorted in descending order.
	 *
	 * <p>In the following example, the sort descending icon is customized:</p>
	 *
	 * <listing version="3.0">
	 * headerRenderer.sortDescendingIcon = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:sortAscendingIcon
	 */
	[Style(name="sortDescendingIcon",type="starling.display.DisplayObject")]

	/**
	 * The location where the header renderer's content is aligned vertically
	 * (on the y-axis).
	 *
	 * <p>In the following example, the vertical alignment is changed to
	 * bottom:</p>
	 *
	 * <listing version="3.0">
	 * headerRenderer.verticalAlign = VerticalAlign.BOTTOM;</listing>
	 *
	 * <p><strong>Note:</strong> The <code>VerticalAlign.JUSTIFY</code>
	 * constant is not supported.</p>
	 *
	 * @default feathers.layout.VerticalAlign.MIDDLE
	 *
	 * @see feathers.layout.VerticalAlign#TOP
	 * @see feathers.layout.VerticalAlign#MIDDLE
	 * @see feathers.layout.VerticalAlign#BOTTOM
	 */
	[Style(name="verticalAlign",type="String")]

	/**
	 * Determines if the text wraps to the next line when it reaches the
	 * width (or max width) of the component.
	 *
	 * <p>In the following example, the header renderer's text is wrapped:</p>
	 *
	 * <listing version="3.0">
	 * headerRenderer.wordWrap = true;</listing>
	 *
	 * @default false
	 */
	[Style(name="wordWrap",type="Boolean")]

	/**
	 * Dispatched when the the user taps or clicks the header renderer. The touch
	 * must remain within the bounds of the header renderer on release to register
	 * as a tap or a click.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.TRIGGERED
	 */
	[Event(name="triggered",type="starling.events.Event")]

	/**
	 * The default renderer used for headers in a <code>DataGrid</code> component.
	 *
	 * @see feathers.controls.DataGrid
	 *
	 * @productversion Feathers 3.4.0
	 */
	public class DefaultDataGridHeaderRenderer extends FeathersControl implements IDataGridHeaderRenderer
	{
		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * text renderer.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_TEXT_RENDERER:String = "feathers-data-grid-header-renderer-text-renderer";

		/**
		 * The default <code>IStyleProvider</code> for all <code>DefaultDataGridHeaderRenderer</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static function defaultImageLoaderFactory():ImageLoader
		{
			return new ImageLoader();
		}

		/**
		 * Constructor.
		 */
		public function DefaultDataGridHeaderRenderer()
		{
			super();
			this.isQuickHitAreaEnabled = true;
			if(this._fontStylesSet === null)
			{
				this._fontStylesSet = new FontStylesSet();
				this._fontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _tapToTrigger:TapToTrigger = null;

		/**
		 * The value added to the <code>styleNameList</code> of the text
		 * renderer. This variable is <code>protected</code> so that
		 * sub-classes can customize the label text renderer style name in their
		 * constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_TEXT_RENDERER</code>.
		 *
		 * <p>To customize the text renderer style name without
		 * subclassing, see <code>customTextRendererStyleName</code>.</p>
		 *
		 * @see #style:customTextRendererStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var textRendererStyleName:String = DEFAULT_CHILD_STYLE_NAME_TEXT_RENDERER;

		/**
		 * @private
		 */
		protected var textRenderer:ITextRenderer;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return DefaultDataGridHeaderRenderer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _data:DataGridColumn = null;

		/**
		 * @inheritDoc
		 */
		public function get data():DataGridColumn
		{
			return this._data;
		}

		/**
		 * @private
		 */
		public function set data(value:DataGridColumn):void
		{
			if(this._data == value)
			{
				return;
			}
			this._data = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _columnIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get columnIndex():int
		{
			return this._columnIndex;
		}

		/**
		 * @private
		 */
		public function set columnIndex(value:int):void
		{
			this._columnIndex = value;
		}

		/**
		 * @private
		 */
		protected var _owner:DataGrid = null;

		/**
		 * @inheritDoc
		 */
		public function get owner():DataGrid
		{
			return this._owner;
		}

		/**
		 * @private
		 */
		public function set owner(value:DataGrid):void
		{
			if(this._owner === value)
			{
				return;
			}
			this._owner = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _sortOrder:String = SortOrder.NONE;

		/**
		 * @inheritDoc
		 */
		public function get sortOrder():String
		{
			return this._sortOrder;
		}

		/**
		 * @private
		 */
		public function set sortOrder(value:String):void
		{
			if(this._sortOrder === value)
			{
				return;
			}
			this._sortOrder = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.LEFT;

		[Inspectable(type="String",enumeration="left,center,right")]
		/**
		 * @private
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._horizontalAlign === value)
			{
				return;
			}
			this._horizontalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.MIDDLE;

		[Inspectable(type="String",enumeration="top,middle,bottom")]
		/**
		 * @private
		 */
		public function get verticalAlign():String
		{
			return _verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._verticalAlign === value)
			{
				return;
			}
			this._verticalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _fontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get fontStyles():TextFormat
		{
			return this._fontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set fontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get disabledFontStyles():TextFormat
		{
			return this._fontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set disabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		private var _wordWrap:Boolean = false;

		/**
		 * @private
		 */
		public function get wordWrap():Boolean
		{
			return this._wordWrap;
		}

		/**
		 * @private
		 */
		public function set wordWrap(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._wordWrap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _textRendererFactory:Function = null;

		/**
		 * A function that generates an <code>ITextRenderer</code> that
		 * displays the header's text. The factory may be used to set custom
		 * properties on the <code>ITextRenderer</code>.
		 *
		 * <p>In the following example, a custom text renderer factory is passed
		 * to the renderer:</p>
		 *
		 * <listing version="3.0">
		 * headerRenderer.textRendererFactory = function():ITextRenderer
		 * {
		 *     var textRenderer:TextFieldTextRenderer = new TextFieldTextRenderer();
		 *     textRenderer.textFormat = new TextFormat( "Source Sans Pro", 16, 0x333333 );
		 *     textRenderer.embedFonts = true;
		 *     return textRenderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.ITextRenderer
		 * @see feathers.core.FeathersControl#defaultTextRendererFactory
		 */
		public function get textRendererFactory():Function
		{
			return this._textRendererFactory;
		}

		/**
		 * @private
		 */
		public function set textRendererFactory(value:Function):void
		{
			if(this._textRendererFactory == value)
			{
				return;
			}
			this._textRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _customTextRendererStyleName:String = null;

		/**
		 * @private
		 */
		public function get customTextRendererStyleName():String
		{
			return this._customTextRendererStyleName;
		}

		/**
		 * @private
		 */
		public function set customTextRendererStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customTextRendererStyleName === value)
			{
				return;
			}
			this._customTextRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _explicitBackgroundWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitTextRendererWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitTextRendererHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitTextRendererMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitTextRendererMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitTextRendererMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitTextRendererMaxHeight:Number;

		/**
		 * @private
		 */
		protected var currentBackgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		protected var _backgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundSkin():DisplayObject
		{
			return this._backgroundSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundSkin === value)
			{
				return;
			}
			if(this._backgroundSkin !== null &&
				this.currentBackgroundSkin === this._backgroundSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _backgroundDisabledSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundDisabledSkin():DisplayObject
		{
			return this._backgroundDisabledSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundDisabledSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundDisabledSkin === value)
			{
				return;
			}
			if(this._backgroundDisabledSkin !== null &&
				this.currentBackgroundSkin === this._backgroundDisabledSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundDisabledSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundDisabledSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var currentSortIcon:DisplayObject = null;

		/**
		 * @private
		 */
		protected var _sortAscendingIcon:DisplayObject = null;

		/**
		 * @private
		 */
		public function get sortAscendingIcon():DisplayObject
		{
			return this._sortAscendingIcon;
		}

		/**
		 * @private
		 */
		public function set sortAscendingIcon(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._sortAscendingIcon === value)
			{
				return;
			}
			if(this._sortAscendingIcon !== null &&
				this.currentSortIcon === this._sortAscendingIcon)
			{
				this.removeCurrentSortIcon(this._sortAscendingIcon);
				this.currentSortIcon = null;
			}
			this._sortAscendingIcon = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _sortDescendingIcon:DisplayObject = null;

		/**
		 * @private
		 */
		public function get sortDescendingIcon():DisplayObject
		{
			return this._sortDescendingIcon;
		}

		/**
		 * @private
		 */
		public function set sortDescendingIcon(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._sortDescendingIcon === value)
			{
				return;
			}
			if(this._sortDescendingIcon !== null &&
				this.currentSortIcon === this._sortDescendingIcon)
			{
				this.removeCurrentSortIcon(this._sortDescendingIcon);
				this.currentSortIcon = null;
			}
			this._sortDescendingIcon = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * The number of text lines displayed by the renderer. The component may
		 * contain multiple text lines if the text contains line breaks or if
		 * the <code>wordWrap</code> property is enabled.
		 *
		 * @see #wordWrap
		 */
		public function get numLines():int
		{
			if(this.textRenderer === null)
			{
				return 0;
			}
			return this.textRenderer.numLines;
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			//we don't dispose it if the renderer is the parent because it'll
			//already get disposed in super.dispose()
			if(this._backgroundSkin !== null &&
				this._backgroundSkin.parent !== this)
			{
				this._backgroundSkin.dispose();
			}
			if(this._backgroundDisabledSkin !== null &&
				this._backgroundDisabledSkin.parent !== this)
			{
				this._backgroundDisabledSkin.dispose();
			}
			if(this._fontStylesSet !== null)
			{
				this._fontStylesSet.dispose();
				this._fontStylesSet = null;
			}
			super.dispose();
		}

		/**
		 * Determines which text to display in the header.
		 */
		protected function itemToText(item:DataGridColumn):String
		{
			if(item !== null)
			{
				if(item.headerText !== null)
				{
					return item.headerText;
				}
				else if(item.dataField !== null)
				{
					return item.dataField;
				}
				return Object(item).toString();
			}
			return null;
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			super.initialize();

			if(this._tapToTrigger === null)
			{
				this._tapToTrigger = new TapToTrigger(this);
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var textRendererInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_TEXT_RENDERER);

			if(stylesInvalid || stateInvalid)
			{
				this.refreshBackgroundSkin();
			}

			if(stylesInvalid || dataInvalid)
			{
				this.refreshSortIcon();
			}

			if(textRendererInvalid)
			{
				this.createTextRenderer();
			}

			if(textRendererInvalid || dataInvalid)
			{
				this.commitData();
			}

			if(dataInvalid || stylesInvalid)
			{
				this.refreshTextRendererStyles();
			}

			if(dataInvalid || stateInvalid)
			{
				this.refreshEnabled();
			}

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;
			this.layoutChildren();
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			resetFluidChildDimensionsForMeasurement(DisplayObject(this.textRenderer),
				this._explicitWidth - this._paddingLeft - this._paddingRight,
				this._explicitHeight - this._paddingTop - this._paddingBottom,
				this._explicitMinWidth - this._paddingLeft - this._paddingRight,
				this._explicitMinHeight - this._paddingTop - this._paddingBottom,
				this._explicitMaxWidth - this._paddingLeft - this._paddingRight,
				this._explicitMaxHeight - this._paddingTop - this._paddingBottom,
				this._explicitTextRendererWidth, this._explicitTextRendererHeight,
				this._explicitTextRendererMinWidth, this._explicitTextRendererMinHeight,
				this._explicitTextRendererMaxWidth, this._explicitTextRendererMaxHeight);
			this.textRenderer.maxWidth = this._explicitMaxWidth - this._paddingLeft - this._paddingRight;
			this.textRenderer.maxHeight = this._explicitMaxHeight - this._paddingTop - this._paddingBottom;
			var point:Point = Pool.getPoint();
			this.textRenderer.measureText(point);

			resetFluidChildDimensionsForMeasurement(this.currentBackgroundSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitBackgroundWidth, this._explicitBackgroundHeight,
				this._explicitBackgroundMinWidth, this._explicitBackgroundMinHeight,
				this._explicitBackgroundMaxWidth, this._explicitBackgroundMaxHeight);
			var measureSkin:IMeasureDisplayObject = this.currentBackgroundSkin as IMeasureDisplayObject;

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				newWidth = point.x;
				newWidth += this._paddingLeft + this._paddingRight;
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.width > newWidth)
				{
					newWidth = this.currentBackgroundSkin.width;
				}
			}
			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				newHeight = point.y;
				newHeight += this._paddingTop + this._paddingBottom;
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.height > newHeight)
				{
					newHeight = this.currentBackgroundSkin.height;
				}
			}
			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				newMinWidth = point.x;
				newMinWidth += this._paddingLeft + this._paddingRight;
				if(this.currentBackgroundSkin !== null)
				{
					if(measureSkin !== null)
					{
						if(measureSkin.minWidth > newMinWidth)
						{
							newMinWidth = measureSkin.minWidth;
						}
					}
					else if(this._explicitBackgroundMinWidth > newMinWidth)
					{
						newMinWidth = this._explicitBackgroundMinWidth;
					}
				}
			}
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				newMinHeight = point.y;
				newMinHeight += this._paddingTop + this._paddingBottom;
				if(this.currentBackgroundSkin !== null)
				{
					if(measureSkin !== null)
					{
						if(measureSkin.minHeight > newMinHeight)
						{
							newMinHeight = measureSkin.minHeight;
						}
					}
					else if(this._explicitBackgroundMinHeight > newMinHeight)
					{
						newMinHeight = this._explicitBackgroundMinHeight;
					}
				}
			}
			Pool.putPoint(point);
			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * @private
		 */
		protected function refreshBackgroundSkin():void
		{
			var oldBackgroundSkin:DisplayObject = this.currentBackgroundSkin;
			this.currentBackgroundSkin = this._backgroundSkin;
			if(!this._isEnabled && this._backgroundDisabledSkin !== null)
			{
				this.currentBackgroundSkin = this._backgroundDisabledSkin;
			}
			if(oldBackgroundSkin !== this.currentBackgroundSkin)
			{
				this.removeCurrentBackgroundSkin(oldBackgroundSkin);
				if(this.currentBackgroundSkin !== null)
				{
					if(this.currentBackgroundSkin is IFeathersControl)
					{
						IFeathersControl(this.currentBackgroundSkin).initializeNow();
					}
					if(this.currentBackgroundSkin is IMeasureDisplayObject)
					{
						var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this.currentBackgroundSkin);
						this._explicitBackgroundWidth = measureSkin.explicitWidth;
						this._explicitBackgroundHeight = measureSkin.explicitHeight;
						this._explicitBackgroundMinWidth = measureSkin.explicitMinWidth;
						this._explicitBackgroundMinHeight = measureSkin.explicitMinHeight;
						this._explicitBackgroundMaxWidth = measureSkin.explicitMaxWidth;
						this._explicitBackgroundMaxHeight = measureSkin.explicitMaxHeight;
					}
					else
					{
						this._explicitBackgroundWidth = this.currentBackgroundSkin.width;
						this._explicitBackgroundHeight = this.currentBackgroundSkin.height;
						this._explicitBackgroundMinWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMinHeight = this._explicitBackgroundHeight;
						this._explicitBackgroundMaxWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMaxHeight = this._explicitBackgroundHeight;
					}
					this.addChildAt(this.currentBackgroundSkin, 0);
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshSortIcon():void
		{
			var oldSortIcon:DisplayObject = this.currentSortIcon;
			this.currentSortIcon = null;
			if(this._sortOrder === SortOrder.ASCENDING)
			{
				this.currentSortIcon = this._sortAscendingIcon;
			}
			else if(this._sortOrder === SortOrder.DESCENDING)
			{
				this.currentSortIcon = this._sortDescendingIcon;
			}
			if(oldSortIcon !== this.currentSortIcon)
			{
				this.removeCurrentSortIcon(oldSortIcon);
				if(this.currentSortIcon !== null)
				{
					this.addChild(this.currentSortIcon);
				}
			}
		}

		/**
		 * @private
		 */
		protected function removeCurrentBackgroundSkin(skin:DisplayObject):void
		{
			if(skin === null)
			{
				return;
			}
			if(skin.parent === this)
			{
				//we need to restore these values so that they won't be lost the
				//next time that this skin is used for measurement
				skin.width = this._explicitBackgroundWidth;
				skin.height = this._explicitBackgroundHeight;
				if(skin is IMeasureDisplayObject)
				{
					var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(skin);
					measureSkin.minWidth = this._explicitBackgroundMinWidth;
					measureSkin.minHeight = this._explicitBackgroundMinHeight;
					measureSkin.maxWidth = this._explicitBackgroundMaxWidth;
					measureSkin.maxHeight = this._explicitBackgroundMaxHeight;
				}
				skin.removeFromParent(false);
			}
		}

		/**
		 * @private
		 */
		protected function removeCurrentSortIcon(icon:DisplayObject):void
		{
			if(icon === null)
			{
				return;
			}
			if(icon.parent === this)
			{
				icon.removeFromParent(false);
			}
		}

		/**
		 * @private
		 */
		protected function createTextRenderer():void
		{
			if(this.textRenderer !== null)
			{
				this.removeChild(DisplayObject(this.textRenderer), true);
				this.textRenderer = null;
			}

			var factory:Function = this._textRendererFactory != null ? this._textRendererFactory : FeathersControl.defaultTextRendererFactory;
			this.textRenderer = ITextRenderer(factory());
			var textRendererStyleName:String = this._customTextRendererStyleName != null ? this._customTextRendererStyleName : this.textRendererStyleName;
			this.textRenderer.styleNameList.add(textRendererStyleName);
			this.addChild(DisplayObject(this.textRenderer));

			this.textRenderer.initializeNow();
			this._explicitTextRendererWidth = this.textRenderer.explicitWidth;
			this._explicitTextRendererHeight = this.textRenderer.explicitHeight;
			this._explicitTextRendererMinWidth = this.textRenderer.explicitMinWidth;
			this._explicitTextRendererMinHeight = this.textRenderer.explicitMinHeight;
			this._explicitTextRendererMaxWidth = this.textRenderer.explicitMaxWidth;
			this._explicitTextRendererMaxHeight = this.textRenderer.explicitMaxHeight;
		}

		/**
		 * @private
		 */
		protected function commitData():void
		{
			if(this._owner)
			{
				this.textRenderer.text = this.itemToText(this._data);
			}
			else
			{
				this.textRenderer.text = null;
			}
		}

		/**
		 * @private
		 */
		protected function refreshEnabled():void
		{
			this.textRenderer.isEnabled = this._isEnabled;
		}

		/**
		 * @private
		 */
		protected function refreshTextRendererStyles():void
		{
			this.textRenderer.fontStyles = this._fontStylesSet;
			this.textRenderer.wordWrap = this._wordWrap;
		}

		/**
		 * @private
		 */
		protected function layoutChildren():void
		{
			if(this.currentBackgroundSkin !== null)
			{
				this.currentBackgroundSkin.width = this.actualWidth;
				this.currentBackgroundSkin.height = this.actualHeight;
			}

			if(this.currentSortIcon is IValidating)
			{
				IValidating(this.currentSortIcon).validate();
			}
			var availableTextWidth:Number = this.actualWidth - this._paddingLeft - this._paddingRight;
			if(this.currentSortIcon)
			{
				availableTextWidth -= this.currentSortIcon.width;
			}

			this.textRenderer.width = this._explicitTextRendererWidth;
			this.textRenderer.height = this._explicitTextRendererHeight;
			this.textRenderer.minWidth = this._explicitTextRendererMinWidth;
			this.textRenderer.minHeight = this._explicitTextRendererMinHeight;
			this.textRenderer.maxWidth = availableTextWidth;
			this.textRenderer.maxHeight = this._explicitTextRendererMaxHeight;
			this.textRenderer.validate();

			switch(this._horizontalAlign)
			{
				case HorizontalAlign.CENTER:
				{
					this.textRenderer.x = this._paddingLeft + (availableTextWidth - this.textRenderer.width) / 2;
					break;
				}
				case HorizontalAlign.RIGHT:
				{
					this.textRenderer.x = this._paddingLeft + availableTextWidth - this.textRenderer.width;
					break;
				}
				default: //left
				{
					this.textRenderer.x = this._paddingLeft;
				}
			}
			if(this.currentSortIcon !== null)
			{
				this.currentSortIcon.x = this.actualWidth - this._paddingRight - this.currentSortIcon.width;
			}

			switch(this._verticalAlign)
			{
				case VerticalAlign.TOP:
				{
					this.textRenderer.y = this._paddingTop;
					if(this.currentSortIcon !== null)
					{
						this.currentSortIcon.y = this._paddingTop;
					}
					break;
				}
				case VerticalAlign.BOTTOM:
				{
					this.textRenderer.y = this.actualHeight - this._paddingBottom - this.textRenderer.height;
					if(this.currentSortIcon !== null)
					{
						this.currentSortIcon.y = this.actualHeight - this._paddingBottom - this.currentSortIcon.height;
					}
					break;
				}
				default: //middle
				{
					this.textRenderer.y = this._paddingTop + (this.actualHeight - this._paddingTop - this._paddingBottom - this.textRenderer.height) / 2;
					if(this.currentSortIcon !== null)
					{
						this.currentSortIcon.y = this._paddingTop + (this.actualHeight - this._paddingTop - this._paddingBottom - this.currentSortIcon.height) / 2;
					}
				}
			}

		}

		/**
		 * @private
		 */
		protected function fontStyles_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}
	}
}


================================================
FILE: source/feathers/controls/renderers/DefaultGroupedListHeaderOrFooterRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.GroupedList;
	import feathers.controls.ImageLoader;
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.ITextRenderer;
	import feathers.core.IValidating;
	import feathers.core.PropertyProxy;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.skins.IStyleProvider;
	import feathers.text.FontStylesSet;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;

	import flash.geom.Point;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.text.TextFormat;

	/**
	 * A background to behind the component's content.
	 *
	 * <p>In the following example, the header renderers is given a
	 * background skin:</p>
	 *
	 * <listing version="3.0">
	 * renderer.backgroundSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundDisabledSkin
	 */
	[Style(name="backgroundSkin",type="starling.display.DisplayObject")]

	/**
	 * A background to display when the component is disabled.
	 *
	 * <p>In the following example, the header renderers is given a
	 * disabled background skin:</p>
	 *
	 * <listing version="3.0">
	 * renderer.backgroundDisabledSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:backgroundSkin
	 */
	[Style(name="backgroundDisabledSkin",type="starling.display.DisplayObject")]

	/**
	 * A style name to add to the renderer's label text renderer
	 * sub-component. Typically used by a theme to provide different styles
	 * to different renderers.
	 *
	 * <p>In the following example, a custom label style name is passed to
	 * the renderer:</p>
	 *
	 * <listing version="3.0">
	 * renderer.customContentLabelStyleName = "my-custom-header-or-footer-renderer-label";</listing>
	 *
	 * <p>In your theme, you can target this sub-component style name to
	 * provide different styles than the default:</p>
	 *
	 * <listing version="3.0">
	 * getStyleProviderForClass( BitmapFontTextRenderer ).setFunctionForStyleName( "my-custom-header-or-footer-label", setCustomHeaderOrFooterLabelStyles );</listing>
	 *
	 * @default null
	 *
	 * @see #DEFAULT_CHILD_STYLE_NAME_CONTENT_LABEL
	 * @see feathers.core.FeathersControl#styleNameList
	 * @see #contentLabelFactory
	 */
	[Style(name="customContentLabelStyleName",type="String")]

	/**
	 * The font styles used to display the content label's text when the
	 * component is disabled.
	 *
	 * <p>In the following example, the disabled font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * renderer.disabledFontStyles = new TextFormat( "Helvetica", 20, 0x999999 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>contentLabelFactory</code> to set more advanced styles on the
	 * text renderer.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:fontStyles
	 */
	[Style(name="disabledFontStyles",type="starling.text.TextFormat")]

	/**
	 * The font styles used to display the content label's text.
	 *
	 * <p>In the following example, the font styles are customized:</p>
	 *
	 * <listing version="3.0">
	 * renderer.fontStyles = new TextFormat( "Helvetica", 20, 0xcc0000 );</listing>
	 *
	 * <p>Note: The <code>starling.text.TextFormat</code> class defines a
	 * number of common font styles, but the text renderer being used may
	 * support a larger number of ways to be customized. Use the
	 * <code>contentLabelFactory</code> to set more advanced styles.</p>
	 *
	 * @default null
	 *
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 * @see #style:disabledFontStyles
	 */
	[Style(name="fontStyles",type="starling.text.TextFormat")]

	/**
	 * The location where the renderer's content is aligned horizontally
	 * (on the x-axis).
	 *
	 * <p>In the following example, the horizontal alignment is changed to
	 * right:</p>
	 *
	 * <listing version="3.0">
	 * renderer.horizontalAlign = HorizontalAlign.RIGHT;</listing>
	 *
	 * @default feathers.layout.HorizontalAlign.LEFT
	 *
	 * @see feathers.layout.HorizontalAlign#LEFT
	 * @see feathers.layout.HorizontalAlign#CENTER
	 * @see feathers.layout.HorizontalAlign#RIGHT
	 * @see feathers.layout.HorizontalAlign#JUSTIFY
	 */
	[Style(name="horizontalAlign",type="String")]

	/**
	 * Quickly sets all padding properties to the same value. The
	 * <code>padding</code> getter always returns the value of
	 * <code>paddingTop</code>, but the other padding values may be
	 * different.
	 *
	 * <p>In the following example, the padding on all four sides is set to 20
	 * pixels:</p>
	 *
	 * <listing version="3.0">
	 * renderer.padding = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:paddingTop
	 * @see #style:paddingRight
	 * @see #style:paddingBottom
	 * @see #style:paddingLeft
	 */
	[Style(name="padding",type="Number")]

	/**
	 * The minimum space, in pixels, between the component's top edge and
	 * the component's content.
	 *
	 * <p>In the following example, the top padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * renderer.paddingTop = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the component's right edge
	 * and the component's content.
	 *
	 * <p>In the following example, the right padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * renderer.paddingRight = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the component's bottom edge
	 * and the component's content.
	 *
	 * <p>In the following example, the bottom padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * renderer.paddingBottom = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the component's left edge
	 * and the component's content.
	 *
	 * <p>In the following example, the left padding is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * renderer.paddingLeft = 20;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:padding
	 */
	[Style(name="paddingLeft",type="Number")]

	/**
	 * The location where the renderer's content is aligned vertically (on
	 * the y-axis).
	 *
	 * <p>In the following example, the vertical alignment is changed to
	 * bottom:</p>
	 *
	 * <listing version="3.0">
	 * renderer.verticalAlign = VerticalAlign.BOTTOM;</listing>
	 *
	 * @default feathers.layout.VerticalAlign.MIDDLE
	 *
	 * @see feathers.layout.VerticalAlign#TOP
	 * @see feathers.layout.VerticalAlign#MIDDLE
	 * @see feathers.layout.VerticalAlign#BOTTOM
	 * @see feathers.layout.VerticalAlign#JUSTIFY
	 */
	[Style(name="verticalAlign",type="String")]

	/**
	 * Determines if the text wraps to the next line when it reaches the
	 * width (or max width) of the component.
	 *
	 * <p>In the following example, the renderer's text is wrapped:</p>
	 *
	 * <listing version="3.0">
	 * renderer.wordWrap = true;</listing>
	 *
	 * @default false
	 */
	[Style(name="wordWrap",type="Boolean")]

	/**
	 * The default renderer used for headers and footers in a GroupedList
	 * control.
	 *
	 * @see feathers.controls.GroupedList
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class DefaultGroupedListHeaderOrFooterRenderer extends FeathersControl implements IGroupedListHeaderRenderer, IGroupedListFooterRenderer
	{
		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * content label.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_CONTENT_LABEL:String = "feathers-header-footer-renderer-content-label";

		/**
		 * The default <code>IStyleProvider</code> for all <code>DefaultGroupedListHeaderOrFooterRenderer</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		private static const HELPER_POINT:Point = new Point();

		/**
		 * @private
		 */
		protected static function defaultImageLoaderFactory():ImageLoader
		{
			return new ImageLoader();
		}

		/**
		 * Constructor.
		 */
		public function DefaultGroupedListHeaderOrFooterRenderer()
		{
			super();
			if(this._fontStylesSet === null)
			{
				this._fontStylesSet = new FontStylesSet();
				this._fontStylesSet.addEventListener(Event.CHANGE, fontStyles_changeHandler);
			}
		}

		/**
		 * The value added to the <code>styleNameList</code> of the content
		 * label text renderer. This variable is <code>protected</code> so that
		 * sub-classes can customize the label text renderer style name in their
		 * constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_CONTENT_LABEL</code>.
		 *
		 * <p>To customize the content label text renderer style name without
		 * subclassing, see <code>customContentLabelStyleName</code>.</p>
		 *
		 * @see #style:customContentLabelStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var contentLabelStyleName:String = DEFAULT_CHILD_STYLE_NAME_CONTENT_LABEL;

		/**
		 * @private
		 */
		protected var contentImage:ImageLoader;

		/**
		 * @private
		 */
		protected var contentLabel:ITextRenderer;

		/**
		 * @private
		 */
		protected var content:DisplayObject;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return DefaultGroupedListHeaderOrFooterRenderer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _data:Object;

		/**
		 * @inheritDoc
		 */
		public function get data():Object
		{
			return this._data;
		}

		/**
		 * @private
		 */
		public function set data(value:Object):void
		{
			if(this._data == value)
			{
				return;
			}
			this._data = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _groupIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get groupIndex():int
		{
			return this._groupIndex;
		}

		/**
		 * @private
		 */
		public function set groupIndex(value:int):void
		{
			this._groupIndex = value;
		}

		/**
		 * @private
		 */
		protected var _layoutIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get layoutIndex():int
		{
			return this._layoutIndex;
		}

		/**
		 * @private
		 */
		public function set layoutIndex(value:int):void
		{
			this._layoutIndex = value;
		}

		/**
		 * @private
		 */
		protected var _owner:GroupedList;

		/**
		 * @inheritDoc
		 */
		public function get owner():GroupedList
		{
			return this._owner;
		}

		/**
		 * @private
		 */
		public function set owner(value:GroupedList):void
		{
			if(this._owner == value)
			{
				return;
			}
			this._owner = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _factoryID:String;

		/**
		 * @inheritDoc
		 */
		public function get factoryID():String
		{
			return this._factoryID;
		}

		/**
		 * @private
		 */
		public function set factoryID(value:String):void
		{
			this._factoryID = value;
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.LEFT;

		[Inspectable(type="String",enumeration="left,center,right,justify")]
		/**
		 * @private
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._horizontalAlign === value)
			{
				return;
			}
			this._horizontalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.MIDDLE;

		[Inspectable(type="String",enumeration="top,middle,bottom,justify")]
		/**
		 * @private
		 */
		public function get verticalAlign():String
		{
			return _verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._verticalAlign === value)
			{
				return;
			}
			this._verticalAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _contentField:String = "content";

		/**
		 * The field in the item that contains a display object to be positioned
		 * in the content position of the renderer. If you wish to display a
		 * texture in the content position, it's better for performance to use
		 * <code>contentSourceField</code> instead.
		 *
		 * <p>All of the content fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>contentSourceFunction</code></li>
		 *     <li><code>contentSourceField</code></li>
		 *     <li><code>contentLabelFunction</code></li>
		 *     <li><code>contentLabelField</code></li>
		 *     <li><code>contentFunction</code></li>
		 *     <li><code>contentField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the content field is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.contentField = "header";</listing>
		 *
		 * @default "content"
		 *
		 * @see #contentSourceField
		 * @see #contentFunction
		 * @see #contentSourceFunction
		 * @see #contentLabelField
		 * @see #contentLabelFunction
		 */
		public function get contentField():String
		{
			return this._contentField;
		}

		/**
		 * @private
		 */
		public function set contentField(value:String):void
		{
			if(this._contentField == value)
			{
				return;
			}
			this._contentField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _contentFunction:Function;

		/**
		 * A function that returns a display object to be positioned in the
		 * content position of the renderer. If you wish to display a texture in
		 * the content position, it's better for performance to use
		 * <code>contentSourceFunction</code> instead.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):DisplayObject</pre>
		 *
		 * <p>All of the content fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>contentSourceFunction</code></li>
		 *     <li><code>contentSourceField</code></li>
		 *     <li><code>contentLabelFunction</code></li>
		 *     <li><code>contentLabelField</code></li>
		 *     <li><code>contentFunction</code></li>
		 *     <li><code>contentField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the content function is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.contentFunction = function( item:Object ):DisplayObject
		 * {
		 *    if(item in cachedContent)
		 *    {
		 *        return cachedContent[item];
		 *    }
		 *    var content:DisplayObject = createContentForHeader( item );
		 *    cachedContent[item] = content;
		 *    return content;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #contentField
		 * @see #contentSourceField
		 * @see #contentSourceFunction
		 * @see #contentLabelField
		 * @see #contentLabelFunction
		 */
		public function get contentFunction():Function
		{
			return this._contentFunction;
		}

		/**
		 * @private
		 */
		public function set contentFunction(value:Function):void
		{
			if(this._contentFunction == value)
			{
				return;
			}
			this._contentFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _contentSourceField:String = "source";

		/**
		 * The field in the data that contains a <code>starling.textures.Texture</code>
		 * or a URL that points to a bitmap to be used as the renderer's
		 * content. The renderer will automatically manage and reuse an internal
		 * <code>ImageLoader</code> sub-component and this value will be passed
		 * to the <code>source</code> property. The <code>ImageLoader</code> may
		 * be customized by changing the <code>contentLoaderFactory</code>.
		 *
		 * <p>Using an content source will result in better performance than
		 * passing in an <code>ImageLoader</code> or <code>Image</code> through
		 * <code>contentField</code> or <code>contentFunction</code> because the
		 * renderer can avoid costly display list manipulation.</p>
		 *
		 * <p>All of the content fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>contentSourceFunction</code></li>
		 *     <li><code>contentSourceField</code></li>
		 *     <li><code>contentLabelFunction</code></li>
		 *     <li><code>contentLabelField</code></li>
		 *     <li><code>contentFunction</code></li>
		 *     <li><code>contentField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the content source field is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.contentSourceField = "texture";</listing>
		 *
		 * @default "source"
		 *
		 * @see feathers.controls.ImageLoader#source
		 * @see #contentLoaderFactory
		 * @see #contentSourceFunction
		 * @see #contentField
		 * @see #contentFunction
		 * @see #contentLabelField
		 * @see #contentLabelFunction
		 */
		public function get contentSourceField():String
		{
			return this._contentSourceField;
		}

		/**
		 * @private
		 */
		public function set contentSourceField(value:String):void
		{
			if(this._contentSourceField == value)
			{
				return;
			}
			this._contentSourceField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _contentSourceFunction:Function;

		/**
		 * A function used to generate a <code>starling.textures.Texture</code>
		 * or a URL that points to a bitmap to be used as the renderer's
		 * content. The renderer will automatically manage and reuse an internal
		 * <code>ImageLoader</code> sub-component and this value will be passed
		 * to the <code>source</code> property. The <code>ImageLoader</code> may
		 * be customized by changing the <code>contentLoaderFactory</code>.
		 *
		 * <p>Using an content source will result in better performance than
		 * passing in an <code>ImageLoader</code> or <code>Image</code> through
		 * <code>contentField</code> or <code>contentFunction</code> because the
		 * renderer can avoid costly display list manipulation.</p>
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):Object</pre>
		 *
		 * <p>The return value is a valid value for the <code>source</code>
		 * property of an <code>ImageLoader</code> component.</p>
		 *
		 * <p>All of the content fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>contentSourceFunction</code></li>
		 *     <li><code>contentSourceField</code></li>
		 *     <li><code>contentLabelFunction</code></li>
		 *     <li><code>contentLabelField</code></li>
		 *     <li><code>contentFunction</code></li>
		 *     <li><code>contentField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the content source function is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.contentSourceFunction = function( item:Object ):Object
		 * {
		 *    return "http://www.example.com/thumbs/" + item.name + "-thumb.png";
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.controls.ImageLoader#source
		 * @see #contentLoaderFactory
		 * @see #contentSourceField
		 * @see #contentField
		 * @see #contentFunction
		 * @see #contentLabelField
		 * @see #contentLabelFunction
		 */
		public function get contentSourceFunction():Function
		{
			return this._contentSourceFunction;
		}

		/**
		 * @private
		 */
		public function set contentSourceFunction(value:Function):void
		{
			if(this.contentSourceFunction == value)
			{
				return;
			}
			this._contentSourceFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _contentLabelField:String = "label";

		/**
		 * The field in the item that contains a string to be displayed in a
		 * renderer-managed <code>Label</code> in the content position of the
		 * renderer. The renderer will automatically reuse an internal
		 * <code>Label</code> and swap the text when the data changes. This
		 * <code>Label</code> may be skinned by changing the
		 * <code>contentLabelFactory</code>.
		 *
		 * <p>Using an content label will result in better performance than
		 * passing in a <code>Label</code> through a <code>contentField</code>
		 * or <code>contentFunction</code> because the renderer can avoid
		 * costly display list manipulation.</p>
		 *
		 * <p>All of the content fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>contentTextureFunction</code></li>
		 *     <li><code>contentTextureField</code></li>
		 *     <li><code>contentLabelFunction</code></li>
		 *     <li><code>contentLabelField</code></li>
		 *     <li><code>contentFunction</code></li>
		 *     <li><code>contentField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the content label field is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.contentLabelField = "text";</listing>
		 *
		 * @default "label"
		 *
		 * @see #contentLabelFactory
		 * @see #contentLabelFunction
		 * @see #contentField
		 * @see #contentFunction
		 * @see #contentSourceField
		 * @see #contentSourceFunction
		 */
		public function get contentLabelField():String
		{
			return this._contentLabelField;
		}

		/**
		 * @private
		 */
		public function set contentLabelField(value:String):void
		{
			if(this._contentLabelField == value)
			{
				return;
			}
			this._contentLabelField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _contentLabelFunction:Function;

		/**
		 * A function that returns a string to be displayed in a
		 * renderer-managed <code>Label</code> in the content position of the
		 * renderer. The renderer will automatically reuse an internal
		 * <code>Label</code> and swap the text when the data changes. This
		 * <code>Label</code> may be skinned by changing the
		 * <code>contentLabelFactory</code>.
		 *
		 * <p>Using an content label will result in better performance than
		 * passing in a <code>Label</code> through a <code>contentField</code>
		 * or <code>contentFunction</code> because the renderer can avoid
		 * costly display list manipulation.</p>
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):String</pre>
		 *
		 * <p>All of the content fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>contentTextureFunction</code></li>
		 *     <li><code>contentTextureField</code></li>
		 *     <li><code>contentLabelFunction</code></li>
		 *     <li><code>contentLabelField</code></li>
		 *     <li><code>contentFunction</code></li>
		 *     <li><code>contentField</code></li>
		 * </ol>
		 *
		 * <p>In the following example, the content label function is customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.contentLabelFunction = function( item:Object ):String
		 * {
		 *    return item.category + " > " + item.subCategory;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #contentLabelFactory
		 * @see #contentLabelField
		 * @see #contentField
		 * @see #contentFunction
		 * @see #contentSourceField
		 * @see #contentSourceFunction
		 */
		public function get contentLabelFunction():Function
		{
			return this._contentLabelFunction;
		}

		/**
		 * @private
		 */
		public function set contentLabelFunction(value:Function):void
		{
			if(this._contentLabelFunction == value)
			{
				return;
			}
			this._contentLabelFunction = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _contentLoaderFactory:Function = defaultImageLoaderFactory;

		/**
		 * A function that generates an <code>ImageLoader</code> that uses the result
		 * of <code>contentSourceField</code> or <code>contentSourceFunction</code>.
		 * Useful for transforming the <code>ImageLoader</code> in some way. For
		 * example, you might want to scale it for current screen density or
		 * apply pixel snapping.
		 *
		 * <p>In the following example, a custom content loader factory is passed
		 * to the renderer:</p>
		 *
		 * <listing version="3.0">
		 * renderer.contentLoaderFactory = function():ImageLoader
		 * {
		 *     var loader:ImageLoader = new ImageLoader();
		 *     loader.scaleFactor = 2;
		 *     return loader;
		 * };</listing>
		 *
		 * @default function():ImageLoader { return new ImageLoader(); }
		 *
		 * @see feathers.controls.ImageLoader
		 * @see #contentSourceField
		 * @see #contentSourceFunction
		 */
		public function get contentLoaderFactory():Function
		{
			return this._contentLoaderFactory;
		}

		/**
		 * @private
		 */
		public function set contentLoaderFactory(value:Function):void
		{
			if(this._contentLoaderFactory == value)
			{
				return;
			}
			this._contentLoaderFactory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _fontStylesSet:FontStylesSet;

		/**
		 * @private
		 */
		public function get fontStyles():TextFormat
		{
			return this._fontStylesSet.format;
		}

		/**
		 * @private
		 */
		public function set fontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.format;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.format = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		public function get disabledFontStyles():TextFormat
		{
			return this._fontStylesSet.disabledFormat;
		}

		/**
		 * @private
		 */
		public function set disabledFontStyles(value:TextFormat):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			var savedCallee:Function = arguments.callee;
			function changeHandler(event:Event):void
			{
				processStyleRestriction(savedCallee);
			}
			var oldValue:TextFormat = this._fontStylesSet.disabledFormat;
			if(oldValue !== null)
			{
				oldValue.removeEventListener(Event.CHANGE, changeHandler);
			}
			this._fontStylesSet.disabledFormat = value;
			if(value !== null)
			{
				value.addEventListener(Event.CHANGE, changeHandler);
			}
		}

		/**
		 * @private
		 */
		private var _wordWrap:Boolean = false;

		/**
		 * @private
		 */
		public function get wordWrap():Boolean
		{
			return this._wordWrap;
		}

		/**
		 * @private
		 */
		public function set wordWrap(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			this._wordWrap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _contentLabelFactory:Function;

		/**
		 * A function that generates an <code>ITextRenderer</code> that uses the result
		 * of <code>contentLabelField</code> or <code>contentLabelFunction</code>.
		 * Can be used to set properties on the <code>ITextRenderer</code>.
		 *
		 * <p>In the following example, a custom content label factory is passed
		 * to the renderer:</p>
		 *
		 * <listing version="3.0">
		 * renderer.contentLabelFactory = function():ITextRenderer
		 * {
		 *     var renderer:TextFieldTextRenderer = new TextFieldTextRenderer();
		 *     renderer.textFormat = new TextFormat( "Source Sans Pro", 16, 0x333333 );
		 *     renderer.embedFonts = true;
		 *     return renderer;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.ITextRenderer
		 * @see feathers.core.FeathersControl#defaultTextRendererFactory
		 * @see #contentLabelField
		 * @see #contentLabelFunction
		 */
		public function get contentLabelFactory():Function
		{
			return this._contentLabelFactory;
		}

		/**
		 * @private
		 */
		public function set contentLabelFactory(value:Function):void
		{
			if(this._contentLabelFactory == value)
			{
				return;
			}
			this._contentLabelFactory = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _customContentLabelStyleName:String;

		/**
		 * @private
		 */
		public function get customContentLabelStyleName():String
		{
			return this._customContentLabelStyleName;
		}

		/**
		 * @private
		 */
		public function set customContentLabelStyleName(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._customContentLabelStyleName === value)
			{
				return;
			}
			this._customContentLabelStyleName = value;
			this.invalidate(INVALIDATION_FLAG_TEXT_RENDERER);
		}

		/**
		 * @private
		 */
		protected var _contentLabelProperties:PropertyProxy;

		/**
		 * An object that stores properties for the content label text renderer
		 * sub-component, and the properties will be passed down to the
		 * text renderer when this component validates. The available properties
		 * depend on which <code>ITextRenderer</code> implementation is returned
		 * by <code>contentLabelFactory</code>. Refer to
		 * <a href="../../core/ITextRenderer.html"><code>feathers.core.ITextRenderer</code></a>
		 * for a list of available text renderer implementations.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>In the following example, a custom content label properties are
		 * customized:</p>
		 *
		 * <listing version="3.0">
		 * renderer.contentLabelProperties.textFormat = new TextFormat( "Source Sans Pro", 16, 0x333333 );
		 * renderer.contentLabelProperties.embedFonts = true;</listing>
		 *
		 * @default null
		 *
		 * @see feathers.core.ITextRenderer
		 * @see #contentLabelField
		 * @see #contentLabelFunction
		 */
		public function get contentLabelProperties():Object
		{
			if(!this._contentLabelProperties)
			{
				this._contentLabelProperties = new PropertyProxy(contentLabelProperties_onChange);
			}
			return this._contentLabelProperties;
		}

		/**
		 * @private
		 */
		public function set contentLabelProperties(value:Object):void
		{
			if(this._contentLabelProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._contentLabelProperties)
			{
				this._contentLabelProperties.removeOnChangeCallback(contentLabelProperties_onChange);
			}
			this._contentLabelProperties = PropertyProxy(value);
			if(this._contentLabelProperties)
			{
				this._contentLabelProperties.addOnChangeCallback(contentLabelProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _explicitBackgroundWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitBackgroundMaxHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitContentWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitContentHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitContentMinWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitContentMinHeight:Number;

		/**
		 * @private
		 */
		protected var _explicitContentMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _explicitContentMaxHeight:Number;

		/**
		 * @private
		 */
		protected var currentBackgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		protected var _backgroundSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundSkin():DisplayObject
		{
			return this._backgroundSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundSkin === value)
			{
				return;
			}
			if(this._backgroundSkin !== null &&
				this.currentBackgroundSkin === this._backgroundSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _backgroundDisabledSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundDisabledSkin():DisplayObject
		{
			return this._backgroundDisabledSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundDisabledSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundDisabledSkin === value)
			{
				return;
			}
			if(this._backgroundDisabledSkin !== null &&
				this.currentBackgroundSkin === this._backgroundDisabledSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundDisabledSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundDisabledSkin = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * The number of text lines displayed by the renderer. The component may
		 * contain multiple text lines if the text contains line breaks or if
		 * the <code>wordWrap</code> property is enabled.
		 *
		 * @see #wordWrap
		 */
		public function get numLines():int
		{
			if(this.contentLabel === null)
			{
				return 0;
			}
			return this.contentLabel.numLines;
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			//we don't dispose it if the renderer is the parent because it'll
			//already get disposed in super.dispose()
			if(this._backgroundSkin !== null &&
				this._backgroundSkin.parent !== this)
			{
				this._backgroundSkin.dispose();
			}
			if(this._backgroundDisabledSkin !== null &&
				this._backgroundDisabledSkin.parent !== this)
			{
				this._backgroundDisabledSkin.dispose();
			}

			//the content may have come from outside of this class. it's up
			//to that code to dispose of the content. in fact, if we disposed
			//of it here, we might screw something up!
			if(this.content)
			{
				this.content.removeFromParent();
			}

			//however, we need to dispose these, if they exist, since we made
			//them here.
			if(this.contentImage)
			{
				this.contentImage.dispose();
				this.contentImage = null;
			}
			if(this.contentLabel)
			{
				DisplayObject(this.contentLabel).dispose();
				this.contentLabel = null;
			}
			if(this._fontStylesSet !== null)
			{
				this._fontStylesSet.dispose();
				this._fontStylesSet = null;
			}
			super.dispose();
		}

		/**
		 * Uses the content fields and functions to generate content for a
		 * specific group header or footer.
		 *
		 * <p>All of the content fields and functions, ordered by priority:</p>
		 * <ol>
		 *     <li><code>contentTextureFunction</code></li>
		 *     <li><code>contentTextureField</code></li>
		 *     <li><code>contentLabelFunction</code></li>
		 *     <li><code>contentLabelField</code></li>
		 *     <li><code>contentFunction</code></li>
		 *     <li><code>contentField</code></li>
		 * </ol>
		 */
		protected function itemToContent(item:Object):DisplayObject
		{
			if(this._contentSourceFunction != null)
			{
				var source:Object = this._contentSourceFunction(item);
				this.refreshContentSource(source);
				return this.contentImage;
			}
			else if(this._contentSourceField != null && item && item.hasOwnProperty(this._contentSourceField))
			{
				source = item[this._contentSourceField];
				this.refreshContentSource(source);
				return this.contentImage;
			}
			else if(this._contentLabelFunction != null)
			{
				var labelResult:Object = this._contentLabelFunction(item);
				if(labelResult is String)
				{
					this.refreshContentLabel(labelResult as String);
				}
				else if(labelResult !== null)
				{
					this.refreshContentLabel(labelResult.toString());
				}
				else
				{
					this.refreshContentLabel(null);
				}
				return DisplayObject(this.contentLabel);
			}
			else if(this._contentLabelField != null && item && item.hasOwnProperty(this._contentLabelField))
			{
				labelResult = item[this._contentLabelField];
				if(labelResult is String)
				{
					this.refreshContentLabel(labelResult as String);
				}
				else if(labelResult !== null)
				{
					this.refreshContentLabel(labelResult.toString());
				}
				else
				{
					this.refreshContentLabel(null);
				}
				return DisplayObject(this.contentLabel);
			}
			else if(this._contentFunction != null)
			{
				return this._contentFunction(item) as DisplayObject;
			}
			else if(this._contentField != null && item && item.hasOwnProperty(this._contentField))
			{
				return item[this._contentField] as DisplayObject;
			}
			else if(item is String)
			{
				this.refreshContentLabel(item as String);
				return DisplayObject(this.contentLabel);
			}
			else if(item !== null)
			{
				this.refreshContentLabel(item.toString());
				return DisplayObject(this.contentLabel);
			}
			else
			{
				this.refreshContentLabel(null);
			}

			return null;
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);

			if(stylesInvalid || stateInvalid)
			{
				this.refreshBackgroundSkin();
			}

			if(dataInvalid)
			{
				this.commitData();
			}

			if(dataInvalid || stylesInvalid)
			{
				this.refreshContentLabelStyles();
			}

			if(dataInvalid || stateInvalid)
			{
				this.refreshEnabled();
			}

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;
			this.layoutChildren();
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}
			var measureContent:IMeasureDisplayObject = this.content as IMeasureDisplayObject;
			if(this.contentLabel !== null)
			{
				//special case for label to allow word wrap
				var labelMaxWidth:Number = this._explicitWidth;
				if(needsWidth)
				{
					labelMaxWidth = this._explicitMaxWidth;
				}
				this.contentLabel.maxWidth = labelMaxWidth - this._paddingLeft - this._paddingRight;
				this.contentLabel.measureText(HELPER_POINT);
			}
			else if(this.content !== null)
			{
				if(this._horizontalAlign === HorizontalAlign.JUSTIFY && this._verticalAlign === VerticalAlign.JUSTIFY)
				{
					resetFluidChildDimensionsForMeasurement(this.content,
						this._explicitWidth - this._paddingLeft - this._paddingRight,
						this._explicitHeight - this._paddingTop - this._paddingBottom,
						this._explicitMinWidth - this._paddingLeft - this._paddingRight,
						this._explicitMinHeight - this._paddingTop - this._paddingBottom,
						this._explicitMaxWidth - this._paddingLeft - this._paddingRight,
						this._explicitMaxHeight - this._paddingTop - this._paddingBottom,
						this._explicitContentWidth, this._explicitContentHeight,
						this._explicitContentMinWidth, this._explicitContentMinHeight,
						this._explicitContentMaxWidth, this._explicitContentMaxHeight);
				}
				else
				{
					this.content.width = this._explicitContentWidth;
					this.content.height = this._explicitContentHeight;
					if(measureContent !== null)
					{
						measureContent.minWidth = this._explicitContentMinWidth;
						measureContent.minHeight = this._explicitContentMinHeight;
					}
				}
				if(this.content is IValidating)
				{
					IValidating(this.content).validate();
				}
			}
			resetFluidChildDimensionsForMeasurement(this.currentBackgroundSkin,
				this._explicitWidth, this._explicitHeight,
				this._explicitMinWidth, this._explicitMinHeight,
				this._explicitMaxWidth, this._explicitMaxHeight,
				this._explicitBackgroundWidth, this._explicitBackgroundHeight,
				this._explicitBackgroundMinWidth, this._explicitBackgroundMinHeight,
				this._explicitBackgroundMaxWidth, this._explicitBackgroundMaxHeight);
			var measureSkin:IMeasureDisplayObject = this.currentBackgroundSkin as IMeasureDisplayObject;

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				if(this.contentLabel !== null)
				{
					newWidth = HELPER_POINT.x;
				}
				else if(this.content !== null)
				{
					newWidth = this.content.width;
				}
				else
				{
					newWidth = 0;
				}
				newWidth += this._paddingLeft + this._paddingRight;
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.width > newWidth)
				{
					newWidth = this.currentBackgroundSkin.width;
				}
			}
			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				if(this.contentLabel !== null)
				{
					newHeight = HELPER_POINT.y;
				}
				else if(this.content !== null)
				{
					newHeight = this.content.height;
				}
				else
				{
					newHeight = 0;
				}
				newHeight += this._paddingTop + this._paddingBottom;
				if(this.currentBackgroundSkin !== null &&
					this.currentBackgroundSkin.height > newHeight)
				{
					newHeight = this.currentBackgroundSkin.height;
				}
			}
			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				if(this.contentLabel !== null)
				{
					newMinWidth = HELPER_POINT.x;
				}
				else if(measureContent !== null)
				{
					newMinWidth = measureContent.minWidth;
				}
				else if(this.content !== null)
				{
					newMinWidth = this.content.width;
				}
				else
				{
					newMinWidth = 0;
				}
				newMinWidth += this._paddingLeft + this._paddingRight;
				if(this.currentBackgroundSkin !== null)
				{
					if(measureSkin !== null)
					{
						if(measureSkin.minWidth > newMinWidth)
						{
							newMinWidth = measureSkin.minWidth;
						}
					}
					else if(this._explicitBackgroundMinWidth > newMinWidth)
					{
						newMinWidth = this._explicitBackgroundMinWidth;
					}
				}
			}
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				if(this.contentLabel !== null)
				{
					newMinHeight = HELPER_POINT.y;
				}
				else if(measureContent !== null)
				{
					newMinHeight = measureContent.minHeight;
				}
				else if(this.content !== null)
				{
					newMinHeight = this.content.height;
				}
				else
				{
					newMinHeight = 0;
				}
				newMinHeight += this._paddingTop + this._paddingBottom;
				if(this.currentBackgroundSkin !== null)
				{
					if(measureSkin !== null)
					{
						if(measureSkin.minHeight > newMinHeight)
						{
							newMinHeight = measureSkin.minHeight;
						}
					}
					else if(this._explicitBackgroundMinHeight > newMinHeight)
					{
						newMinHeight = this._explicitBackgroundMinHeight;
					}
				}
			}
			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * @private
		 */
		protected function refreshBackgroundSkin():void
		{
			var oldBackgroundSkin:DisplayObject = this.currentBackgroundSkin;
			this.currentBackgroundSkin = this._backgroundSkin;
			if(!this._isEnabled && this._backgroundDisabledSkin !== null)
			{
				this.currentBackgroundSkin = this._backgroundDisabledSkin;
			}
			if(oldBackgroundSkin !== this.currentBackgroundSkin)
			{
				this.removeCurrentBackgroundSkin(oldBackgroundSkin);
				if(this.currentBackgroundSkin !== null)
				{
					if(this.currentBackgroundSkin is IFeathersControl)
					{
						IFeathersControl(this.currentBackgroundSkin).initializeNow();
					}
					if(this.currentBackgroundSkin is IMeasureDisplayObject)
					{
						var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this.currentBackgroundSkin);
						this._explicitBackgroundWidth = measureSkin.explicitWidth;
						this._explicitBackgroundHeight = measureSkin.explicitHeight;
						this._explicitBackgroundMinWidth = measureSkin.explicitMinWidth;
						this._explicitBackgroundMinHeight = measureSkin.explicitMinHeight;
						this._explicitBackgroundMaxWidth = measureSkin.explicitMaxWidth;
						this._explicitBackgroundMaxHeight = measureSkin.explicitMaxHeight;
					}
					else
					{
						this._explicitBackgroundWidth = this.currentBackgroundSkin.width;
						this._explicitBackgroundHeight = this.currentBackgroundSkin.height;
						this._explicitBackgroundMinWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMinHeight = this._explicitBackgroundHeight;
						this._explicitBackgroundMaxWidth = this._explicitBackgroundWidth;
						this._explicitBackgroundMaxHeight = this._explicitBackgroundHeight;
					}
					this.addChildAt(this.currentBackgroundSkin, 0);
				}
			}
		}

		/**
		 * @private
		 */
		protected function removeCurrentBackgroundSkin(skin:DisplayObject):void
		{
			if(skin === null)
			{
				return;
			}
			if(skin.parent === this)
			{
				//we need to restore these values so that they won't be lost the
				//next time that this skin is used for measurement
				skin.width = this._explicitBackgroundWidth;
				skin.height = this._explicitBackgroundHeight;
				if(skin is IMeasureDisplayObject)
				{
					var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(skin);
					measureSkin.minWidth = this._explicitBackgroundMinWidth;
					measureSkin.minHeight = this._explicitBackgroundMinHeight;
					measureSkin.maxWidth = this._explicitBackgroundMaxWidth;
					measureSkin.maxHeight = this._explicitBackgroundMaxHeight;
				}
				skin.removeFromParent(false);
			}
		}

		/**
		 * @private
		 */
		protected function commitData():void
		{
			if(this._owner)
			{
				var newContent:DisplayObject = this.itemToContent(this._data);
				if(newContent !== this.content)
				{
					if(this.content !== null)
					{
						this.content.removeFromParent();
					}
					this.content = newContent;
					if(this.content !== null)
					{
						this.addChild(this.content);
						if(this.content is IFeathersControl)
						{
							IFeathersControl(this.content).initializeNow();
						}
						if(this.content is IMeasureDisplayObject)
						{
							var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this.content);
							this._explicitContentWidth = measureSkin.explicitWidth;
							this._explicitContentHeight = measureSkin.explicitHeight;
							this._explicitContentMinWidth = measureSkin.explicitMinWidth;
							this._explicitContentMinHeight = measureSkin.explicitMinHeight;
							this._explicitContentMaxWidth = measureSkin.explicitMaxWidth;
							this._explicitContentMaxHeight = measureSkin.explicitMaxHeight;
						}
						else
						{
							this._explicitContentWidth = this.content.width;
							this._explicitContentHeight = this.content.height;
							this._explicitContentMinWidth = this._explicitContentWidth;
							this._explicitContentMinHeight = this._explicitContentHeight;
							this._explicitContentMaxWidth = this._explicitContentWidth;
							this._explicitContentMaxHeight = this._explicitContentHeight;
						}
					}
				}
			}
			else
			{
				if(this.content)
				{
					this.content.removeFromParent();
					this.content = null;
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshContentSource(source:Object):void
		{
			if(!this.contentImage)
			{
				this.contentImage = this._contentLoaderFactory();
			}
			this.contentImage.source = source;
		}

		/**
		 * @private
		 */
		protected function refreshContentLabel(label:String):void
		{
			if(label !== null)
			{
				if(this.contentLabel === null)
				{
					var factory:Function = this._contentLabelFactory != null ? this._contentLabelFactory : FeathersControl.defaultTextRendererFactory;
					this.contentLabel = ITextRenderer(factory());
					var contentLabelStyleName:String = this._customContentLabelStyleName != null ? this._customContentLabelStyleName : this.contentLabelStyleName;
					FeathersControl(this.contentLabel).styleNameList.add(contentLabelStyleName);
				}
				this.contentLabel.text = label;
			}
			else if(this.contentLabel !== null)
			{
				DisplayObject(this.contentLabel).removeFromParent(true);
				this.contentLabel = null;
			}
		}

		/**
		 * @private
		 */
		protected function refreshEnabled():void
		{
			if(this.content is IFeathersControl)
			{
				IFeathersControl(this.content).isEnabled = this._isEnabled;
			}
		}

		/**
		 * @private
		 */
		protected function refreshContentLabelStyles():void
		{
			if(this.contentLabel === null)
			{
				return;
			}
			this.contentLabel.fontStyles = this._fontStylesSet;
			this.contentLabel.wordWrap = this._wordWrap;
			for(var propertyName:String in this._contentLabelProperties)
			{
				var propertyValue:Object = this._contentLabelProperties[propertyName];
				this.contentLabel[propertyName] = propertyValue;
			}
		}

		/**
		 * @private
		 */
		protected function layoutChildren():void
		{
			if(this.currentBackgroundSkin !== null)
			{
				this.currentBackgroundSkin.width = this.actualWidth;
				this.currentBackgroundSkin.height = this.actualHeight;
			}

			if(this.content === null)
			{
				return;
			}

			if(this.contentLabel !== null)
			{
				this.contentLabel.maxWidth = this.actualWidth - this._paddingLeft - this._paddingRight;
			}

			if(this.content is IValidating)
			{
				IValidating(this.content).validate();
			}
			switch(this._horizontalAlign)
			{
				case HorizontalAlign.CENTER:
				{
					this.content.x = this._paddingLeft + (this.actualWidth - this._paddingLeft - this._paddingRight - this.content.width) / 2;
					break;
				}
				case HorizontalAlign.RIGHT:
				{
					this.content.x = this.actualWidth - this._paddingRight - this.content.width;
					break;
				}
				case HorizontalAlign.JUSTIFY:
				{
					this.content.x = this._paddingLeft;
					this.content.width = this.actualWidth - this._paddingLeft - this._paddingRight;
					break;
				}
				default: //left
				{
					this.content.x = this._paddingLeft;
				}
			}

			switch(this._verticalAlign)
			{
				case VerticalAlign.TOP:
				{
					this.content.y = this._paddingTop;
					break;
				}
				case VerticalAlign.BOTTOM:
				{
					this.content.y = this.actualHeight - this._paddingBottom - this.content.height;
					break;
				}
				case VerticalAlign.JUSTIFY:
				{
					this.content.y = this._paddingTop;
					this.content.height = this.actualHeight - this._paddingTop - this._paddingBottom;
					break;
				}
				default: //middle
				{
					this.content.y = this._paddingTop + (this.actualHeight - this._paddingTop - this._paddingBottom - this.content.height) / 2;
				}
			}
		}

		/**
		 * @private
		 */
		protected function fontStyles_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected function contentLabelProperties_onChange(proxy:PropertyProxy, name:String):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}
	}
}


================================================
FILE: source/feathers/controls/renderers/DefaultGroupedListItemRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.GroupedList;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;

	/**
	 * The default item renderer for a GroupedList control. Supports up to three
	 * optional sub-views, including a label to display text, an icon to display
	 * an image, and an "accessory" to display a UI control or another display
	 * object (with shortcuts for including a second image or a second label).
	 *
	 * @see feathers.controls.GroupedList
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class DefaultGroupedListItemRenderer extends BaseDefaultItemRenderer implements IGroupedListItemRenderer
	{
		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#ALTERNATE_STYLE_NAME_DRILL_DOWN
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_DRILL_DOWN:String = "feathers-drill-down-item-renderer";

		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#ALTERNATE_STYLE_NAME_CHECK
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_CHECK:String = "feathers-check-item-renderer";

		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#DEFAULT_CHILD_STYLE_NAME_LABEL
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_LABEL:String = "feathers-item-renderer-label";

		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#DEFAULT_CHILD_STYLE_NAME_ICON_LABEL
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ICON_LABEL:String = "feathers-item-renderer-icon-label";

		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LABEL
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LABEL:String = "feathers-item-renderer-accessory-label";

		/**
		 * The default <code>IStyleProvider</code> for all <code>DefaultGroupedListItemRenderer</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function DefaultGroupedListItemRenderer()
		{
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return DefaultGroupedListItemRenderer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _groupIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get groupIndex():int
		{
			return this._groupIndex;
		}

		/**
		 * @private
		 */
		public function set groupIndex(value:int):void
		{
			this._groupIndex = value;
		}

		/**
		 * @private
		 */
		protected var _itemIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get itemIndex():int
		{
			return this._itemIndex;
		}

		/**
		 * @private
		 */
		public function set itemIndex(value:int):void
		{
			this._itemIndex = value;
		}

		/**
		 * @private
		 */
		protected var _layoutIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get layoutIndex():int
		{
			return this._layoutIndex;
		}

		/**
		 * @private
		 */
		public function set layoutIndex(value:int):void
		{
			this._layoutIndex = value;
		}

		/**
		 * @inheritDoc
		 */
		public function get owner():GroupedList
		{
			return GroupedList(this._owner);
		}

		/**
		 * @private
		 */
		public function set owner(value:GroupedList):void
		{
			if(this._owner == value)
			{
				return;
			}
			if(this._owner)
			{
				this._owner.removeEventListener(FeathersEventType.SCROLL_START, owner_scrollStartHandler);
				this._owner.removeEventListener(FeathersEventType.SCROLL_COMPLETE, owner_scrollCompleteHandler);
			}
			this._owner = value;
			if(this._owner)
			{
				var list:GroupedList = GroupedList(this._owner);
				this.isSelectableWithoutToggle = list.isSelectable;
				this._owner.addEventListener(FeathersEventType.SCROLL_START, owner_scrollStartHandler);
				this._owner.addEventListener(FeathersEventType.SCROLL_COMPLETE, owner_scrollCompleteHandler);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.owner = null;
			super.dispose();
		}
	}
}

================================================
FILE: source/feathers/controls/renderers/DefaultListItemRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.List;
	import feathers.core.IFeathersControl;
	import feathers.core.IValidating;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;

	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * An optional icon used to drag and drop the list item.
	 *
	 * <p>The following example gives the item renderer a drag icon:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.dragIcon = new Image( texture );</listing>
	 *
	 * @default null
	 */
	[Style(name="dragIcon",type="starling.display.DisplayObject")]

	/**
	 * The default item renderer for List control. Supports up to three optional
	 * sub-views, including a label to display text, an icon to display an
	 * image, and an "accessory" to display a UI control or another display
	 * object (with shortcuts for including a second image or a second label).
	 *
	 * @see feathers.controls.List
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class DefaultListItemRenderer extends BaseDefaultItemRenderer implements IListItemRenderer, IDragAndDropItemRenderer
	{
		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#ALTERNATE_STYLE_NAME_DRILL_DOWN
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_DRILL_DOWN:String = "feathers-drill-down-item-renderer";

		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#ALTERNATE_STYLE_NAME_CHECK
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_CHECK:String = "feathers-check-item-renderer";

		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#DEFAULT_CHILD_STYLE_NAME_LABEL
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_LABEL:String = "feathers-item-renderer-label";

		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#DEFAULT_CHILD_STYLE_NAME_ICON_LABEL
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ICON_LABEL:String = "feathers-item-renderer-icon-label";

		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LABEL
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LABEL:String = "feathers-item-renderer-accessory-label";

		/**
		 * The default <code>IStyleProvider</code> for all <code>DefaultListItemRenderer</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function DefaultListItemRenderer()
		{
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return DefaultListItemRenderer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _index:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get index():int
		{
			return this._index;
		}

		/**
		 * @private
		 */
		public function set index(value:int):void
		{
			this._index = value;
		}

		/**
		 * @inheritDoc
		 */
		public function get owner():List
		{
			return List(this._owner);
		}

		/**
		 * @private
		 */
		public function set owner(value:List):void
		{
			if(this._owner === value)
			{
				return;
			}
			if(this._owner)
			{
				this._owner.removeEventListener(FeathersEventType.SCROLL_START, owner_scrollStartHandler);
				this._owner.removeEventListener(FeathersEventType.SCROLL_COMPLETE, owner_scrollCompleteHandler);
			}
			this._owner = value;
			if(this._owner)
			{
				var list:List = List(this._owner);
				this.isSelectableWithoutToggle = list.isSelectable;
				if(list.allowMultipleSelection)
				{
					//toggling is forced in this case
					this.isToggle = true;
				}
				this._owner.addEventListener(FeathersEventType.SCROLL_START, owner_scrollStartHandler);
				this._owner.addEventListener(FeathersEventType.SCROLL_COMPLETE, owner_scrollCompleteHandler);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _dragEnabled:Boolean = false;

		/**
		 * @private
		 */
		public function get dragEnabled():Boolean
		{
			return this._dragEnabled;
		}

		/**
		 * @private
		 */
		public function set dragEnabled(value:Boolean):void
		{
			if(this._dragEnabled === value)
			{
				return;
			}
			this._dragEnabled = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _dragIcon:DisplayObject = null;

		/**
		 * @private
		 */
		public function get dragIcon():DisplayObject
		{
			return this._dragIcon;
		}

		/**
		 * @private
		 */
		public function set dragIcon(value:DisplayObject):void
		{
			if(this._dragIcon === value)
			{
				return;
			}
			if(this._dragIcon !== null)
			{
				if(this._dragIcon is IFeathersControl)
				{
					IFeathersControl(this._dragIcon).removeEventListener(FeathersEventType.RESIZE, dragIcon_resizeHandler);
				}
				//if this icon needs to be reused somewhere else, we need to
				//properly clean it up
				if(this._dragIcon.parent === this)
				{
					this._dragIcon.removeFromParent(false);
				}
				this._dragIcon = null;
			}
			this._dragIcon = value;
			if(this._dragIcon !== null)
			{
				this.addChild(this._dragIcon);
				if(this._dragIcon is IFeathersControl)
				{
					IFeathersControl(this._dragIcon).addEventListener(FeathersEventType.RESIZE, dragIcon_resizeHandler);
				}
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _dragGap:Number = NaN;

		/**
		 * @private
		 */
		public function get dragGap():Number
		{
			return this._dragGap;
		}

		/**
		 * @private
		 */
		public function set dragGap(value:Number):void
		{
			if(this._dragGap == value)
			{
				return;
			}
			this._dragGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _ignoreDragIconResizes:Boolean = false;

		/**
		 * @private
		 */
		public function get dragProxy():DisplayObject
		{
			return this._dragIcon;
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.owner = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function refreshOffsets():void
		{
			super.refreshOffsets();
			var dragGap:Number = this._gap;
			if(this._dragGap === this._dragGap) //!isNaN
			{
				dragGap = this._dragGap;
			}
			if(this._dragEnabled && this._dragIcon !== null)
			{
				var oldIgnoreIconResizes:Boolean = this._ignoreDragIconResizes;
				this._ignoreDragIconResizes = true;
				if(this._dragIcon is IValidating)
				{
					IValidating(this._dragIcon).validate();
				}
				this._ignoreDragIconResizes = oldIgnoreIconResizes;
				this._leftOffset += this._dragIcon.width + dragGap;
			}
		}

		/**
		 * @private
		 */
		override protected function layoutContent():void
		{
			super.layoutContent();
			if(this._dragIcon !== null)
			{
				if(this._dragEnabled)
				{
					var oldIgnoreIconResizes:Boolean = this._ignoreDragIconResizes;
					this._ignoreDragIconResizes = true;
					if(this._dragIcon is IValidating)
					{
						IValidating(this._dragIcon).validate();
					}
					this._ignoreDragIconResizes = oldIgnoreIconResizes;
					this._dragIcon.x = this._paddingLeft;
					this._dragIcon.y = this._paddingTop + ((this.actualHeight - this._paddingTop - this._paddingBottom) - this._dragIcon.height) / 2;
					this._dragIcon.visible = true;
				}
				else
				{
					this._dragIcon.visible = false;
				}
			}
		}

		/**
		 * @private
		 */
		protected function dragIcon_resizeHandler(event:Event):void
		{
			if(this._ignoreDragIconResizes)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}
	}
}

================================================
FILE: source/feathers/controls/renderers/DefaultTreeItemRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.BasicButton;
	import feathers.controls.Tree;
	import feathers.controls.renderers.ITreeItemRenderer;
	import feathers.core.IFeathersControl;
	import feathers.core.IStateObserver;
	import feathers.core.IValidating;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;
	import feathers.utils.touch.TapToTrigger;

	import flash.geom.Point;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.events.Event;

	/**
	 * The icon used to indicate if the tree item is a branch.
	 *
	 * <p>The following example gives the item renderer a branch icon:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.branchIcon = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:branchOpenIcon
	 * @see #style:branchClosedIcon
	 */
	[Style(name="branchIcon",type="starling.display.DisplayObject")]

	/**
	 * The icon used to indicate if the tree item is an open branch. If
	 * <code>null</code>, the <code>branchIcon</code> will be used instead.
	 *
	 * <p>The following example gives the item renderer a branch open icon:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.branchOpenIcon = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:branchClosedIcon
	 */
	[Style(name="branchOpenIcon",type="starling.display.DisplayObject")]

	/**
	 * The icon used to indicate if the tree item is a closed branch. If
	 * <code>null</code>, the <code>branchIcon</code> will be used instead.
	 *
	 * <p>The following example gives the item renderer a branch closed icon:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.branchClosedIcon = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:branchOpenIcon
	 */
	[Style(name="branchClosedIcon",type="starling.display.DisplayObject")]

	/**
	 * The space, in pixels, between the disclosure icon and left edge of the
	 * other children in the item renderer. If the value is <code>NaN</code>,
	 * the value of the <code>gap</code> property will be used instead.
	 *
	 * <p>In the following example, the disclosure gap is set to 20 pixels:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.disclosureGap = 20;</listing>
	 *
	 * @default NaN
	 *
	 * @see #style:gap
	 */
	[Style(name="disclosureGap",type="Number")]

	/**
	 * The icon used to indicate if the tree item is open or closed.
	 *
	 * <p>The following example gives the item renderer a disclosure icon:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.disclosureIcon = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:disclosureOpenIcon
	 * @see #style:disclosureClosedIcon
	 */
	[Style(name="disclosureIcon",type="starling.display.DisplayObject")]

	/**
	 * The icon used to indicate if the tree item is open. If
	 * <code>null</code>, the <code>disclosureIcon</code> will be used instead.
	 *
	 * <p>The following example gives the item renderer a disclosure open icon:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.disclosureOpenIcon = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:disclosureClosedIcon
	 */
	[Style(name="disclosureOpenIcon",type="starling.display.DisplayObject")]

	/**
	 * The icon used to indicate if the tree item is closed. If
	 * <code>null</code>, the <code>disclosureIcon</code> will be used instead.
	 *
	 * <p>The following example gives the item renderer a disclosure closed icon:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.disclosureClosedIcon = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:disclosureOpenIcon
	 */
	[Style(name="disclosureClosedIcon",type="starling.display.DisplayObject")]

	/**
	 * The size, in pixels, of the indentation when an item is a child of a branch.
	 *
	 * <p>In the following example, the indentation is set to 15 pixels:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.indentation = 15;</listing>
	 *
	 * @default 10
	 */
	[Style(name="indentation",type="Number")]

	/**
	 * The icon used to indicate if the tree item is a leaf.
	 *
	 * <p>The following example gives the item renderer a leaf icon:</p>
	 *
	 * <listing version="3.0">
	 * itemRenderer.leafIcon = new Image( texture );</listing>
	 *
	 * @default null
	 */
	[Style(name="leafIcon",type="starling.display.DisplayObject")]

	/**
	 * The default item renderer for Tree control. Supports up to three optional
	 * sub-views, including a label to display text, an icon to display an
	 * image, and an "accessory" to display a UI control or another display
	 * object (with shortcuts for including a second image or a second label).
	 *
	 * @see feathers.controls.Tree
	 *
	 * @productversion Feathers 3.3.0
	 */
	public class DefaultTreeItemRenderer extends BaseDefaultItemRenderer implements ITreeItemRenderer
	{
		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#DEFAULT_CHILD_STYLE_NAME_LABEL
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_LABEL:String = "feathers-item-renderer-label";

		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#DEFAULT_CHILD_STYLE_NAME_ICON_LABEL
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ICON_LABEL:String = "feathers-item-renderer-icon-label";

		/**
		 * @copy feathers.controls.renderers.BaseDefaultItemRenderer#DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LABEL
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_ACCESSORY_LABEL:String = "feathers-item-renderer-accessory-label";

		/**
		 * The default <code>IStyleProvider</code> for all <code>DefaultTreeItemRenderer</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function DefaultTreeItemRenderer()
		{
			super();
			this.addEventListener(Event.TRIGGERED, treeItemRenderer_triggeredHandler);
		}

		/**
		 * @private
		 */
		protected var _ignoreDisclosureIconResizes:Boolean = false;

		/**
		 * @private
		 */
		protected var _ignoreBranchOrLeafIconResizes:Boolean = false;

		/**
		 * @private
		 */
		protected var _disclosureIconTapToTrigger:TapToTrigger = null;

		/**
		 * @private
		 */
		protected var _currentDisclosureIcon:DisplayObject = null;

		/**
		 * @private
		 */
		protected var _disclosureIcon:DisplayObject = null;

		/**
		 * @private
		 */
		public function get disclosureIcon():DisplayObject
		{
			return this._disclosureIcon;
		}

		/**
		 * @private
		 */
		public function set disclosureIcon(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._disclosureIcon === value)
			{
				return;
			}
			if(this._disclosureIcon !== null &&
				this._currentDisclosureIcon === this._disclosureIcon)
			{
				//if this icon needs to be reused somewhere else, we need to
				//properly clean it up
				this.removeCurrentDisclosureIcon(this._disclosureIcon);
				this._currentDisclosureIcon = null;
			}
			this._disclosureIcon = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _disclosureOpenIcon:DisplayObject = null;

		/**
		 * @private
		 */
		public function get disclosureOpenIcon():DisplayObject
		{
			return this._disclosureOpenIcon;
		}

		/**
		 * @private
		 */
		public function set disclosureOpenIcon(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._disclosureOpenIcon === value)
			{
				return;
			}
			if(this._disclosureOpenIcon !== null &&
				this._currentDisclosureIcon === this._disclosureOpenIcon)
			{
				//if this icon needs to be reused somewhere else, we need to
				//properly clean it up
				this.removeCurrentDisclosureIcon(this._disclosureOpenIcon);
				this._currentDisclosureIcon = null;
			}
			this._disclosureOpenIcon = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _disclosureClosedIcon:DisplayObject = null;

		/**
		 * @private
		 */
		public function get disclosureClosedIcon():DisplayObject
		{
			return this._disclosureClosedIcon;
		}

		/**
		 * @private
		 */
		public function set disclosureClosedIcon(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._disclosureClosedIcon === value)
			{
				return;
			}
			if(this._disclosureClosedIcon !== null &&
				this._currentDisclosureIcon === this._disclosureClosedIcon)
			{
				//if this icon needs to be reused somewhere else, we need to
				//properly clean it up
				this.removeCurrentDisclosureIcon(this._disclosureClosedIcon);
				this._currentDisclosureIcon = null;
			}
			this._disclosureClosedIcon = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _currentBranchOrLeafIcon:DisplayObject = null;

		/**
		 * @private
		 */
		protected var _branchIcon:DisplayObject = null;

		/**
		 * @private
		 */
		public function get branchIcon():DisplayObject
		{
			return this._branchIcon;
		}

		/**
		 * @private
		 */
		public function set branchIcon(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._branchIcon === value)
			{
				return;
			}
			if(this._branchIcon !== null &&
				this._currentBranchOrLeafIcon === this._branchIcon)
			{
				//if this icon needs to be reused somewhere else, we need to
				//properly clean it up
				this.removeCurrentBranchOrLeafIcon(this._branchIcon);
				this._currentBranchOrLeafIcon = null;
			}
			this._branchIcon = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _branchOpenIcon:DisplayObject = null;

		/**
		 * @private
		 */
		public function get branchOpenIcon():DisplayObject
		{
			return this._branchOpenIcon;
		}

		/**
		 * @private
		 */
		public function set branchOpenIcon(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._branchOpenIcon === value)
			{
				return;
			}
			if(this._branchOpenIcon !== null &&
				this._currentBranchOrLeafIcon === this._branchOpenIcon)
			{
				//if this icon needs to be reused somewhere else, we need to
				//properly clean it up
				this.removeCurrentBranchOrLeafIcon(this._branchOpenIcon);
				this._currentBranchOrLeafIcon = null;
			}
			this._branchOpenIcon = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _branchClosedIcon:DisplayObject = null;

		/**
		 * @private
		 */
		public function get branchClosedIcon():DisplayObject
		{
			return this._branchClosedIcon;
		}

		/**
		 * @private
		 */
		public function set branchClosedIcon(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._branchOpenIcon === value)
			{
				return;
			}
			if(this._branchClosedIcon !== null &&
				this._currentBranchOrLeafIcon === this._branchClosedIcon)
			{
				//if this icon needs to be reused somewhere else, we need to
				//properly clean it up
				this.removeCurrentBranchOrLeafIcon(this._branchClosedIcon);
				this._currentBranchOrLeafIcon = null;
			}
			this._branchClosedIcon = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _leafIcon:DisplayObject = null;

		/**
		 * @private
		 */
		public function get leafIcon():DisplayObject
		{
			return this._leafIcon;
		}

		/**
		 * @private
		 */
		public function set leafIcon(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._leafIcon === value)
			{
				return;
			}
			if(this._leafIcon !== null &&
				this._currentBranchOrLeafIcon === this._leafIcon)
			{
				//if this icon needs to be reused somewhere else, we need to
				//properly clean it up
				this.removeCurrentBranchOrLeafIcon(this._leafIcon);
				this._currentBranchOrLeafIcon = null;
			}
			this._leafIcon = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return DefaultTreeItemRenderer.globalStyleProvider;
		}

		/**
		 * @inheritDoc
		 */
		public function get owner():Tree
		{
			return Tree(this._owner);
		}

		/**
		 * @private
		 */
		public function set owner(value:Tree):void
		{
			if(this._owner === value)
			{
				return;
			}
			if(this._owner)
			{
				this._owner.removeEventListener(FeathersEventType.SCROLL_START, owner_scrollStartHandler);
				this._owner.removeEventListener(FeathersEventType.SCROLL_COMPLETE, owner_scrollCompleteHandler);
			}
			this._owner = value;
			if(this._owner)
			{
				var list:Tree = Tree(this._owner);
				this.isSelectableWithoutToggle = list.isSelectable;
				this._owner.addEventListener(FeathersEventType.SCROLL_START, owner_scrollStartHandler);
				this._owner.addEventListener(FeathersEventType.SCROLL_COMPLETE, owner_scrollCompleteHandler);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _location:Vector.<int> = null;

		/**
		 * @inheritDoc
		 */
		public function get location():Vector.<int>
		{
			return this._location;
		}

		/**
		 * @private
		 */
		public function set location(value:Vector.<int>):void
		{
			if(this._location === value)
			{
				return;
			}
			this._location = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _layoutIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get layoutIndex():int
		{
			return this._layoutIndex;
		}

		/**
		 * @private
		 */
		public function set layoutIndex(value:int):void
		{
			this._layoutIndex = value;
		}

		/**
		 * @private
		 */
		protected var _indentation:Number = 10;

		/**
		 * @private
		 */
		public function get indentation():Number
		{
			return this._indentation;
		}

		/**
		 * @private
		 */
		public function set indentation(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._indentation == value)
			{
				return;
			}
			this._indentation = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _disclosureGap:Number = NaN;

		/**
		 * @private
		 */
		public function get disclosureGap():Number
		{
			return this._disclosureGap;
		}

		/**
		 * @private
		 */
		public function set disclosureGap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._disclosureGap == value)
			{
				return;
			}
			this._disclosureGap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isOpen:Boolean = false;

		/**
		 * @private
		 */
		public function get isOpen():Boolean
		{
			return this._isOpen;
		}

		/**
		 * @private
		 */
		public function set isOpen(value:Boolean):void
		{
			if(this._isOpen === value)
			{
				return;
			}
			this._isOpen = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _isBranch:Boolean = false;

		/**
		 * @private
		 */
		public function get isBranch():Boolean
		{
			return this._isBranch;
		}

		/**
		 * @private
		 */
		public function set isBranch(value:Boolean):void
		{
			if(this._isBranch === value)
			{
				return;
			}
			this._isBranch = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			//we don't dispose it if the item renderer is the parent because
			//it'll already get disposed in super.dispose()
			if(this._disclosureIcon !== null && this._disclosureIcon.parent !== this)
			{
				this._disclosureIcon.dispose();
			}
			if(this._disclosureOpenIcon !== null && this._disclosureOpenIcon.parent !== this)
			{
				this._disclosureOpenIcon.dispose();
			}
			if(this._disclosureClosedIcon !== null && this._disclosureClosedIcon.parent !== this)
			{
				this._disclosureClosedIcon.dispose();
			}
			if(this._branchIcon !== null && this._branchIcon.parent !== this)
			{
				this._branchIcon.dispose();
			}
			if(this._branchOpenIcon !== null && this._branchOpenIcon.parent !== this)
			{
				this._branchOpenIcon.dispose();
			}
			if(this._branchClosedIcon !== null && this._branchClosedIcon.parent !== this)
			{
				this._branchClosedIcon.dispose();
			}
			if(this._leafIcon !== null && this._leafIcon.parent !== this)
			{
				this._leafIcon.dispose();
			}
			this.owner = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			if(dataInvalid || stateInvalid || stylesInvalid)
			{
				this.refreshDisclosureIcon();
				this.refreshBranchOrLeafIcon();
			}
			super.draw();
		}

		/**
		 * @private
		 */
		override protected function refreshOffsets():void
		{
			super.refreshOffsets();
			if(this._location !== null)
			{
				//if the data provider is empty, but the tree has a typicalItem,
				//the location will be null
				this._leftOffset += this._indentation * (this._location.length - 1);
			}
			var disclosureGap:Number = this._gap;
			if(this._disclosureGap === this._disclosureGap) //!isNaN
			{
				disclosureGap = this._disclosureGap;
			}
			if(this._currentDisclosureIcon !== null)
			{
				var oldIgnoreIconResizes:Boolean = this._ignoreDisclosureIconResizes;
				this._ignoreDisclosureIconResizes = true;
				if(this._currentDisclosureIcon is IValidating)
				{
					IValidating(this._currentDisclosureIcon).validate();
				}
				this._ignoreDisclosureIconResizes = oldIgnoreIconResizes;
				this._leftOffset += this._currentDisclosureIcon.width + disclosureGap;
				if(this._isBranch)
				{
					this._currentDisclosureIcon.visible = true;
				}
				else
				{
					this._currentDisclosureIcon.visible = false;
				}
			}
			if(this._currentBranchOrLeafIcon !== null)
			{
				oldIgnoreIconResizes = this._ignoreBranchOrLeafIconResizes;
				this._ignoreBranchOrLeafIconResizes = true;
				if(this._currentBranchOrLeafIcon is IValidating)
				{
					IValidating(this._currentBranchOrLeafIcon).validate();
				}
				this._ignoreBranchOrLeafIconResizes = oldIgnoreIconResizes;
				this._leftOffset += this._currentBranchOrLeafIcon.width + disclosureGap;
			}
		}

		/**
		 * @private
		 */
		override protected function layoutContent():void
		{
			super.layoutContent();
			var indent:Number = this._paddingLeft;
			if(this._location !== null)
			{
				indent += this._indentation * (this._location.length - 1);
			}
			if(this._currentDisclosureIcon !== null)
			{
				var oldIgnoreIconResizes:Boolean = this._ignoreDisclosureIconResizes;
				this._ignoreDisclosureIconResizes = true;
				if(this._currentDisclosureIcon is IValidating)
				{
					IValidating(this._currentDisclosureIcon).validate();
				}
				this._ignoreDisclosureIconResizes = oldIgnoreIconResizes;
				this._currentDisclosureIcon.x = indent;
				this._currentDisclosureIcon.y = this._paddingTop + ((this.actualHeight - this._paddingTop - this._paddingBottom) - this._currentDisclosureIcon.height) / 2;
				indent += this._currentDisclosureIcon.width + this._gap;
			}
			if(this._currentBranchOrLeafIcon !== null)
			{
				oldIgnoreIconResizes = this._ignoreBranchOrLeafIconResizes;
				this._ignoreBranchOrLeafIconResizes = true;
				if(this._currentBranchOrLeafIcon is IValidating)
				{
					IValidating(this._currentBranchOrLeafIcon).validate();
				}
				this._ignoreBranchOrLeafIconResizes = oldIgnoreIconResizes;
				this._currentBranchOrLeafIcon.x = indent;
				this._currentBranchOrLeafIcon.y = this._paddingTop + ((this.actualHeight - this._paddingTop - this._paddingBottom) - this._currentBranchOrLeafIcon.height) / 2;
			}
		}

		/**
		 * @private
		 */
		override protected function hitTestWithAccessory(localPosition:Point):Boolean
		{
			if(this._currentDisclosureIcon !== null)
			{
				if(this._currentDisclosureIcon is DisplayObjectContainer)
				{
					var container:DisplayObjectContainer = DisplayObjectContainer(this._currentDisclosureIcon);
					if(container.contains(this.hitTest(localPosition)))
					{
						return false;
					}
				}
				if(this.hitTest(localPosition) === this._currentDisclosureIcon)
				{
					return false;
				}
			}
			return super.hitTestWithAccessory(localPosition);
		}

		/**
		 * @private
		 */
		protected function getCurrentDisclosureIcon():DisplayObject
		{
			var newIcon:DisplayObject = this._disclosureIcon;
			if(this._isOpen && this._disclosureOpenIcon !== null)
			{
				newIcon = this._disclosureOpenIcon;
			}
			else if(!this._isOpen && this._disclosureClosedIcon !== null)
			{
				newIcon = this._disclosureClosedIcon;
			}
			return newIcon;
		}

		/**
		 * @private
		 */
		protected function getCurrentBranchOrLeafIcon():DisplayObject
		{
			var newIcon:DisplayObject = this._leafIcon;
			if(this._isBranch)
			{
				newIcon = this._branchIcon;
				if(this._isOpen && this._branchOpenIcon !== null)
				{
					newIcon = this._branchOpenIcon;
				}
				else if(!this._isOpen && this._branchClosedIcon !== null)
				{
					newIcon = this._branchClosedIcon;
				}
			}
			return newIcon;
		}

		/**
		 * @private
		 */
		protected function removeCurrentDisclosureIcon(icon:DisplayObject):void
		{
			if(icon === null)
			{
				return;
			}
			if(icon is IFeathersControl)
			{
				IFeathersControl(icon).removeEventListener(FeathersEventType.RESIZE, currentDisclosureIcon_resizeHandler);
			}
			icon.removeEventListener(Event.TRIGGERED, disclosureIcon_triggeredHandler);
			if(icon is IStateObserver)
			{
				IStateObserver(icon).stateContext = null;
			}
			if(icon.parent === this)
			{
				this.removeChild(icon, false);
			}
		}

		/**
		 * @private
		 */
		protected function removeCurrentBranchOrLeafIcon(icon:DisplayObject):void
		{
			if(icon === null)
			{
				return;
			}
			if(icon is IFeathersControl)
			{
				IFeathersControl(icon).removeEventListener(FeathersEventType.RESIZE, currentBranchOrLeafIcon_resizeHandler);
			}
			if(icon is IStateObserver)
			{
				IStateObserver(icon).stateContext = null;
			}
			if(icon.parent === this)
			{
				this.removeChild(icon, false);
			}
		}

		/**
		 * @private
		 */
		protected function refreshDisclosureIcon():void
		{
			var oldIcon:DisplayObject = this._currentDisclosureIcon;
			this._currentDisclosureIcon = this.getCurrentDisclosureIcon();
			if(this._currentDisclosureIcon is IFeathersControl)
			{
				IFeathersControl(this._currentDisclosureIcon).isEnabled = this._isEnabled;
			}
			if(this._currentDisclosureIcon !== oldIcon)
			{
				if(oldIcon !== null)
				{
					this.removeCurrentDisclosureIcon(oldIcon);
				}
				if(this._currentDisclosureIcon !== null)
				{
					if(this._currentDisclosureIcon is IStateObserver)
					{
						IStateObserver(this._currentDisclosureIcon).stateContext = this;
					}
					this.addChild(this._currentDisclosureIcon);
					if(!(this._currentDisclosureIcon is BasicButton))
					{
						if(this._disclosureIconTapToTrigger !== null)
						{
							this._disclosureIconTapToTrigger.target = this._currentDisclosureIcon;
						}
						else
						{
							this._disclosureIconTapToTrigger = new TapToTrigger(this._currentDisclosureIcon);
						}
					}
					this._currentDisclosureIcon.addEventListener(Event.TRIGGERED, disclosureIcon_triggeredHandler);
					if(this._currentDisclosureIcon is IFeathersControl)
					{
						IFeathersControl(this._currentDisclosureIcon).addEventListener(FeathersEventType.RESIZE, currentDisclosureIcon_resizeHandler);
					}
				}
				else
				{
					this._disclosureIconTapToTrigger = null;
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshBranchOrLeafIcon():void
		{
			var oldIcon:DisplayObject = this._currentBranchOrLeafIcon;
			this._currentBranchOrLeafIcon = this.getCurrentBranchOrLeafIcon();
			if(this._currentBranchOrLeafIcon is IFeathersControl)
			{
				IFeathersControl(this._currentBranchOrLeafIcon).isEnabled = this._isEnabled;
			}
			if(this._currentBranchOrLeafIcon !== oldIcon)
			{
				if(oldIcon !== null)
				{
					this.removeCurrentBranchOrLeafIcon(oldIcon);
				}
				if(this._currentBranchOrLeafIcon !== null)
				{
					if(this._currentBranchOrLeafIcon is IStateObserver)
					{
						IStateObserver(this._currentBranchOrLeafIcon).stateContext = this;
					}
					this.addChild(this._currentBranchOrLeafIcon);
					if(this._currentBranchOrLeafIcon is IFeathersControl)
					{
						IFeathersControl(this._currentBranchOrLeafIcon).addEventListener(FeathersEventType.RESIZE, currentBranchOrLeafIcon_resizeHandler);
					}
				}
			}
		}

		/**
		 * @private
		 */
		protected function disclosureIcon_triggeredHandler(event:Event):void
		{
			this.owner.toggleBranch(this._data, !this._isOpen);
		}

		/**
		 * @private
		 */
		protected function treeItemRenderer_triggeredHandler(event:Event):void
		{
			if((this._currentDisclosureIcon !== null && !this._isQuickHitAreaEnabled) || !this._isBranch)
			{
				return;
			}
			//if there is no disclosure icon, then the branch is toggled simply
			//by triggering it with a click/tap
			this.owner.toggleBranch(this._data, !this._isOpen);
		}

		/**
		 * @private
		 */
		protected function currentDisclosureIcon_resizeHandler():void
		{
			if(this._ignoreDisclosureIconResizes)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected function currentBranchOrLeafIcon_resizeHandler():void
		{
			if(this._ignoreBranchOrLeafIconResizes)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}
	}
}

================================================
FILE: source/feathers/controls/renderers/IDataGridCellRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.DataGrid;
	import feathers.controls.DataGridColumn;
	import feathers.core.IToggle;
	import feathers.layout.ILayoutDisplayObject;

	/**
	 * Interface to implement a renderer for a data grid cell.
	 *
	 * @productversion Feathers 3.4.0
	 */
	public interface IDataGridCellRenderer extends IToggle, ILayoutDisplayObject
	{
		/**
		 * An item from the data grid's data provider. The data may change if this
		 * item renderer is reused for a new item because it's no longer needed
		 * for the original item.
		 *
		 * <p>This property is set by the data grid, and should not be set manually.</p>
		 *
		 * @see #dataField
		 */
		function get data():Object;

		/**
		 * @private
		 */
		function set data(value:Object):void;

		/**
		 * The column where the cell is rendered in the data grid.
		 *
		 * <p>This property is set by the data grid, and should not be set manually.</p>
		 */
		function get column():DataGridColumn;

		/**
		 * @private
		 */
		function set column(value:DataGridColumn):void;

		/**
		 * The index (numeric position, starting from zero) of the item within
		 * the data grid's columns.
		 *
		 * <p>This property is set by the data grid, and should not be set manually.</p>
		 */
		function get columnIndex():int;

		/**
		 * @private
		 */
		function set columnIndex(value:int):void;

		/**
		 * The index (numeric position, starting from zero) of the item within
		 * the data grid's data provider. Like the <code>data</code> property,
		 * this value may change if this item renderer is reused by the list
		 * for a different item.
		 *
		 * <p>This property is set by the data grid, and should not be set manually.</p>
		 */
		function get rowIndex():int;

		/**
		 * @private
		 */
		function set rowIndex(value:int):void;

		/**
		 * The field used to access this column's data from the item within the
		 * data grid's data provider. Like the <code>data</code> property, this
		 * value may change if this item renderer is reused by the data grid
		 * for a different item.
		 *
		 * <p>This property is set by the data grid, and should not be set manually.</p>
		 *
		 * @see #data
		 */
		function get dataField():String;

		/**
		 * @private
		 */
		function set dataField(value:String):void;

		/**
		 * The data grid that contains this cell renderer.
		 *
		 * <p>This property is set by the data grid, and should not be set manually.</p>
		 */
		function get owner():DataGrid;

		/**
		 * @private
		 */
		function set owner(value:DataGrid):void;
	}
}

================================================
FILE: source/feathers/controls/renderers/IDataGridHeaderRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.DataGrid;
	import feathers.controls.DataGridColumn;
	import feathers.core.IFeathersControl;
	import feathers.layout.ILayoutDisplayObject;

	/**
	 * Dispatched when the the user taps or clicks the header renderer. The touch
	 * must remain within the bounds of the header renderer on release to register
	 * as a tap or a click.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.TRIGGERED
	 *
	 * @see feathers.utils.touch.TapToTrigger
	 */
	[Event(name="triggered",type="starling.events.Event")]

	/**
	 * Interface to implement a renderer for a data grid header.
	 *
	 * @productversion Feathers 3.4.0
	 */
	public interface IDataGridHeaderRenderer extends IFeathersControl, ILayoutDisplayObject
	{
		/**
		 * A column from a data grid. The data may change if this header
		 * renderer is reused for a new column because it's no longer needed
		 * for the original column.
		 *
		 * <p>This property is set by the data grid, and should not be set manually.</p>
		 */
		function get data():DataGridColumn;

		/**
		 * @private
		 */
		function set data(value:DataGridColumn):void;

		/**
		 * The index of the header within the layout.
		 *
		 * <p>This property is set by the data grid, and should not be set manually.</p>
		 */
		function get columnIndex():int;

		/**
		 * @private
		 */
		function set columnIndex(value:int):void;

		/**
		 * The data grid that contains this header renderer.
		 *
		 * <p>This property is set by the data grid, and should not be set manually.</p>
		 */
		function get owner():DataGrid;

		/**
		 * @private
		 */
		function set owner(value:DataGrid):void;

		/**
		 * Indicates if this column is sorted.
		 *
		 * <p>This property is set by the data grid, and should not be set manually.</p>
		 *
		 * @see feathers.data.SortOrder
		 */
		function get sortOrder():String;

		/**
		 * @private
		 */
		function set sortOrder(value:String):void;
	}
}

================================================
FILE: source/feathers/controls/renderers/IDragAndDropItemRenderer.as
================================================
package feathers.controls.renderers
{
	import starling.display.DisplayObject;

	public interface IDragAndDropItemRenderer
	{
		/**
		 * Indicates if the owner has enabled drag actions.
		 *
		 * <p>This property is set by the list, and should not be set manually.</p>
		 */
		function get dragEnabled():Boolean;

		/**
		 * @private
		 */
		function set dragEnabled(value:Boolean):void;

		/**
		 * An optional display object to use to trigger drag and drop in the
		 * list component. If <code>null</code>, the entire item renderer can
		 * be dragged.
		 */
		function get dragProxy():DisplayObject;
	}
}

================================================
FILE: source/feathers/controls/renderers/IGroupedListFooterRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.GroupedList;
	import feathers.core.IFeathersControl;

	/**
	 * Interface to implement a renderer for a grouped list footer.
	 *
	 * @see feathers.controls.GroupedList
	 *
	 * @productversion Feathers 2.3.0
	 */
	public interface IGroupedListFooterRenderer extends IFeathersControl
	{
		/**
		 * Data for a footer renderer from the grouped list's data provider.
		 * A footer renderer should be designed with the assumption that its
		 * <code>data</code> will change as the list scrolls.
		 *
		 * <p>This property is set automatically by the list, and it should not
		 * be set manually.</p>
		 */
		function get data():Object;

		/**
		 * @private
		 */
		function set data(value:Object):void;

		/**
		 * The index of the group within the data provider of the grouped list.
		 *
		 * <p>This property is set automatically by the list, and it should not
		 * be set manually.</p>
		 */
		function get groupIndex():int;

		/**
		 * @private
		 */
		function set groupIndex(value:int):void;

		/**
		 * The index of this display object within the layout.
		 *
		 * <p>This property is set automatically by the list, and it should not
		 * be set manually.</p>
		 */
		function get layoutIndex():int;

		/**
		 * @private
		 */
		function set layoutIndex(value:int):void;

		/**
		 * The grouped list that contains this footer renderer.
		 *
		 * <p>This property is set automatically by the list, and it should not
		 * be set manually.</p>
		 */
		function get owner():GroupedList;

		/**
		 * @private
		 */
		function set owner(value:GroupedList):void;

		/**
		 * The ID of the factory used to create this footer renderer.
		 *
		 * <p>This property is set by the list, and should not be set manually.</p>
		 */
		function get factoryID():String;

		/**
		 * @private
		 */
		function set factoryID(value:String):void;
	}
}


================================================
FILE: source/feathers/controls/renderers/IGroupedListHeaderRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.GroupedList;
	import feathers.core.IFeathersControl;

	/**
	 * Interface to implement a renderer for a grouped list header.
	 *
	 * @see feathers.controls.GroupedList
	 *
	 * @productversion Feathers 2.3.0
	 */
	public interface IGroupedListHeaderRenderer extends IFeathersControl
	{
		/**
		 * Data for a header renderer from the grouped list's data provider.
		 * A header renderer should be designed with the assumption that its
		 * <code>data</code> will change as the list scrolls.
		 *
		 * <p>This property is set automatically by the list, and it should not
		 * be set manually.</p>
		 */
		function get data():Object;

		/**
		 * @private
		 */
		function set data(value:Object):void;

		/**
		 * The index of the group within the data provider of the grouped list.
		 *
		 * <p>This property is set automatically by the list, and it should not
		 * be set manually.</p>
		 */
		function get groupIndex():int;

		/**
		 * @private
		 */
		function set groupIndex(value:int):void;

		/**
		 * The index of this display object within the layout.
		 *
		 * <p>This property is set automatically by the list, and it should not
		 * be set manually.</p>
		 */
		function get layoutIndex():int;

		/**
		 * @private
		 */
		function set layoutIndex(value:int):void;

		/**
		 * The grouped list that contains this header renderer.
		 *
		 * <p>This property is set automatically by the list, and it should not
		 * be set manually.</p>
		 */
		function get owner():GroupedList;

		/**
		 * @private
		 */
		function set owner(value:GroupedList):void;

		/**
		 * The ID of the factory used to create this header renderer.
		 *
		 * <p>This property is set by the list, and should not be set manually.</p>
		 */
		function get factoryID():String;

		/**
		 * @private
		 */
		function set factoryID(value:String):void;
	}
}


================================================
FILE: source/feathers/controls/renderers/IGroupedListItemRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.GroupedList;
	import feathers.core.IToggle;

	/**
	 * Dispatched when the the user taps or clicks the item renderer. The touch
	 * must remain within the bounds of the item renderer on release to register
	 * as a tap or a click.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.TRIGGERED
	 *
	 * @see feathers.utils.touch.TapToTrigger
	 */
	[Event(name="triggered",type="starling.events.Event")]

	/**
	 * Interface to implement a renderer for a grouped list item.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface IGroupedListItemRenderer extends IToggle
	{
		/**
		 * An item from the grouped list's data provider. The data may change if
		 * this item renderer is reused for a new item because it's no longer
		 * needed for the original item.
		 *
		 * <p>This property is set by the list, and should not be set manually.</p>
		 */
		function get data():Object;

		/**
		 * @private
		 */
		function set data(value:Object):void;

		/**
		 * The index of the item's parent group within the data provider of the
		 * grouped list.
		 *
		 * <p>This property is set by the list, and should not be set manually.</p>
		 */
		function get groupIndex():int;

		/**
		 * @private
		 */
		function set groupIndex(value:int):void;

		/**
		 * The index of the item within its parent group.
		 *
		 * <p>This property is set by the list, and should not be set manually.</p>
		 */
		function get itemIndex():int;

		/**
		 * @private
		 */
		function set itemIndex(value:int):void;

		/**
		 * The index of the item within the layout.
		 *
		 * <p>This property is set by the list, and should not be set manually.</p>
		 */
		function get layoutIndex():int;

		/**
		 * @private
		 */
		function set layoutIndex(value:int):void;

		/**
		 * The grouped list that contains this item renderer.
		 *
		 * <p>This property is set by the list, and should not be set manually.</p>
		 */
		function get owner():GroupedList;

		/**
		 * @private
		 */
		function set owner(value:GroupedList):void;

		/**
		 * The ID of the factory used to create this item renderer.
		 *
		 * <p>This property is set by the list, and should not be set manually.</p>
		 */
		function get factoryID():String;

		/**
		 * @private
		 */
		function set factoryID(value:String):void;
	}
}

================================================
FILE: source/feathers/controls/renderers/IListItemRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.List;
	import feathers.core.IToggle;

	/**
	 * Dispatched when the the user taps or clicks the item renderer. The touch
	 * must remain within the bounds of the item renderer on release to register
	 * as a tap or a click.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.TRIGGERED
	 *
	 * @see feathers.utils.touch.TapToTrigger
	 */
	[Event(name="triggered",type="starling.events.Event")]

	/**
	 * Interface to implement a renderer for a list item.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface IListItemRenderer extends IToggle
	{
		/**
		 * An item from the list's data provider. The data may change if this
		 * item renderer is reused for a new item because it's no longer needed
		 * for the original item.
		 *
		 * <p>This property is set by the list, and should not be set manually.</p>
		 */
		function get data():Object;

		/**
		 * @private
		 */
		function set data(value:Object):void;

		/**
		 * The index (numeric position, starting from zero) of the item within
		 * the list's data provider. Like the <code>data</code> property, this
		 * value may change if this item renderer is reused by the list for a
		 * different item.
		 *
		 * <p>This property is set by the list, and should not be set manually.</p>
		 */
		function get index():int;

		/**
		 * @private
		 */
		function set index(value:int):void;

		/**
		 * The list that contains this item renderer.
		 *
		 * <p>This property is set by the list, and should not be set manually.</p>
		 */
		function get owner():List;

		/**
		 * @private
		 */
		function set owner(value:List):void;

		/**
		 * The ID of the factory used to create this item renderer.
		 *
		 * <p>This property is set by the list, and should not be set manually.</p>
		 */
		function get factoryID():String;

		/**
		 * @private
		 */
		function set factoryID(value:String):void;
	}
}

================================================
FILE: source/feathers/controls/renderers/ITreeItemRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.Tree;
	import feathers.core.IToggle;

	/**
	 * Dispatched when the the user taps or clicks the item renderer. The touch
	 * must remain within the bounds of the item renderer on release to register
	 * as a tap or a click.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.TRIGGERED
	 *
	 * @see feathers.utils.touch.TapToTrigger
	 */
	[Event(name="triggered",type="starling.events.Event")]

	/**
	 * Interface to implement a renderer for a tree item.
	 *
	 * @productversion Feathers 3.3.0
	 */
	public interface ITreeItemRenderer extends IToggle
	{
		/**
		 * An item from the tree's data provider. The data may change if this
		 * item renderer is reused for a new item because it's no longer needed
		 * for the original item.
		 *
		 * <p>This property is set by the tree, and it should not be set manually.</p>
		 */
		function get data():Object;

		/**
		 * @private
		 */
		function set data(value:Object):void;

		/**
		 * The tree that contains this item renderer.
		 *
		 * <p>This property is set by the tree, and it should not be set manually.</p>
		 */
		function get owner():Tree;

		/**
		 * @private
		 */
		function set owner(value:Tree):void;

		/**
		 * The location (a vector of numeric indices, starting from zero) of
		 * the item within the tree's data provider. Like the <code>data</code>
		 * property, this value may change if this item renderer is reused by
		 * the tree for a different item.
		 *
		 * <p>This property is set by the tree, and it should not be set manually.</p>
		 */
		function get location():Vector.<int>;

		/**
		 * @private
		 */
		function set location(value:Vector.<int>):void;

		/**
		 * The index of the item within the layout.
		 *
		 * <p>This property is set by the tree, and should not be set manually.</p>
		 */
		function get layoutIndex():int;

		/**
		 * @private
		 */
		function set layoutIndex(value:int):void;

		/**
		 * The ID of the factory used to create this item renderer.
		 *
		 * <p>This property is set by the tree, and it should not be set manually.</p>
		 */
		function get factoryID():String;

		/**
		 * @private
		 */
		function set factoryID(value:String):void;

		/**
		 * Indicates if the data is a branch or a leaf.
		 *
		 * <p>This property is set by the tree, and it should not be set manually.</p>
		 *
		 * @see #isOpen
		 */
		function get isBranch():Boolean;

		/**
		 * @private
		 */
		function set isBranch(value:Boolean):void;

		/**
		 * Indicates if a branch is open or closed. An item that is not a
		 * branch will always return <code>false</code>.
		 *
		 * <p>This property is set by the tree, and it should not be set manually.</p>
		 *
		 * @see #isBranch
		 */
		function get isOpen():Boolean;

		/**
		 * @private
		 */
		function set isOpen(value:Boolean):void;
	}
}

================================================
FILE: source/feathers/controls/renderers/LayoutGroupDataGridCellRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.DataGrid;
	import feathers.controls.DataGridColumn;
	import feathers.controls.LayoutGroup;
	import feathers.skins.IStyleProvider;

	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * The background to display behind all content when the item renderer
	 * is selected. The background skin is resized to fill the full width
	 * and height of the layout group.
	 *
	 * <p>In the following example, the group is given a selected background
	 * skin:</p>
	 *
	 * <listing version="3.0">
	 * group.backgroundSelectedSkin = new Image( texture );</listing>
	 *
	 * @default null
	 */
	[Style(name="backgroundSelectedSkin",type="starling.display.DisplayObject")]

	/**
	 * Based on <code>LayoutGroup</code>, this component is meant as a base
	 * class for creating a custom item renderer for a <code>DataGrid</code>
	 * component.
	 *
	 * <p>Sub-components may be created and added inside <code>initialize()</code>.
	 * This is a good place to add event listeners and to set the layout.</p>
	 *
	 * <p>The <code>data</code> property may be parsed inside <code>commitData()</code>.
	 * Use this function to change properties in your sub-components.</p>
	 *
	 * <p>Sub-components may be positioned manually, but a layout may be
	 * provided as well. An <code>AnchorLayout</code> is recommended for fluid
	 * layouts that can automatically adjust positions when the grid resizes.
	 * Create <code>AnchorLayoutData</code> objects to define the constraints.</p>
	 *
	 * @see feathers.controls.DataGrid
	 *
	 * @productversion Feathers 3.4.0
	 */
	public class LayoutGroupDataGridCellRenderer extends LayoutGroup implements IDataGridCellRenderer
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>LayoutGroupDataGridCellRenderer</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function LayoutGroupDataGridCellRenderer()
		{
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return LayoutGroupDataGridCellRenderer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _rowIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get rowIndex():int
		{
			return this._rowIndex;
		}

		/**
		 * @private
		 */
		public function set rowIndex(value:int):void
		{
			this._rowIndex = value;
		}

		/**
		 * @private
		 */
		protected var _columnIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get columnIndex():int
		{
			return this._columnIndex;
		}

		/**
		 * @private
		 */
		public function set columnIndex(value:int):void
		{
			this._columnIndex = value;
		}

		/**
		 * @private
		 */
		protected var _owner:DataGrid = null;

		/**
		 * @inheritDoc
		 */
		public function get owner():DataGrid
		{
			return this._owner;
		}

		/**
		 * @private
		 */
		public function set owner(value:DataGrid):void
		{
			if(this._owner == value)
			{
				return;
			}
			this._owner = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _data:Object = null;

		/**
		 * @inheritDoc
		 */
		public function get data():Object
		{
			return this._data;
		}

		/**
		 * @private
		 */
		public function set data(value:Object):void
		{
			if(this._data == value)
			{
				return;
			}
			this._data = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
			//LayoutGroup doesn't know about INVALIDATION_FLAG_DATA, so we need
			//set set another flag that it understands.
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _dataField:String = null;

		/**
		 * @inheritDoc
		 */
		public function get dataField():String
		{
			return this._dataField;
		}

		/**
		 * @private
		 */
		public function set dataField(value:String):void
		{
			if(this._dataField === value)
			{
				return;
			}
			this._dataField = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _column:DataGridColumn = null;

		/**
		 * @inheritDoc
		 */
		public function get column():DataGridColumn
		{
			return this._column;
		}

		/**
		 * @private
		 */
		public function set column(value:DataGridColumn):void
		{
			if(this._column === value)
			{
				return;
			}
			this._column = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _isSelected:Boolean;

		/**
		 * @inheritDoc
		 */
		public function get isSelected():Boolean
		{
			return this._isSelected;
		}

		/**
		 * @private
		 */
		public function set isSelected(value:Boolean):void
		{
			if(this._isSelected == value)
			{
				return;
			}
			this._isSelected = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
			//the state flag is needed for updating the background
			this.invalidate(INVALIDATION_FLAG_STATE);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _backgroundSelectedSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundSelectedSkin():DisplayObject
		{
			return this._backgroundSelectedSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundSelectedSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundSelectedSkin === value)
			{
				return;
			}
			if(this._backgroundSelectedSkin !== null &&
				this.currentBackgroundSkin === this._backgroundSelectedSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundSelectedSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundSelectedSkin = value;
			this.invalidate(INVALIDATION_FLAG_SKIN);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.owner = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			//children are allowed to change during draw() in a subclass up
			//until it calls super.draw().
			this._ignoreChildChangesButSetFlags = false;

			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var scrollInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SCROLL);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);

			if(dataInvalid)
			{
				this.commitData();
			}

			if(scrollInvalid || sizeInvalid || layoutInvalid)
			{
				this._ignoreChildChanges = true;
				this.preLayout();
				this._ignoreChildChanges = false;
			}

			super.draw();

			if(scrollInvalid || sizeInvalid || layoutInvalid)
			{
				this._ignoreChildChanges = true;
				this.postLayout();
				this._ignoreChildChanges = false;
			}
		}

		/**
		 * Makes final changes to the layout before it updates the item
		 * renderer's children. If your layout requires changing the
		 * <code>layoutData</code> property on the item renderer's
		 * sub-components, override the <code>preLayout()</code> function to
		 * make those changes.
		 *
		 * <p>In subclasses, if you create properties that affect the layout,
		 * invalidate using <code>INVALIDATION_FLAG_LAYOUT</code> to trigger a
		 * call to the <code>preLayout()</code> function when the component
		 * validates.</p>
		 *
		 * <p>The final width and height of the item renderer are not yet known
		 * when this function is called. It is meant mainly for adjusting values
		 * used by fluid layouts, such as constraints or percentages. If you
		 * need io access the final width and height of the item renderer,
		 * override the <code>postLayout()</code> function instead.</p>
		 *
		 * @see #postLayout()
		 */
		protected function preLayout():void
		{

		}

		/**
		 * Called after the layout updates the item renderer's children. If any
		 * children are excluded from the layout, you can update them in the
		 * <code>postLayout()</code> function if you need to use the final width
		 * and height in any calculations.
		 *
		 * <p>In subclasses, if you create properties that affect the layout,
		 * invalidate using <code>INVALIDATION_FLAG_LAYOUT</code> to trigger a
		 * call to the <code>postLayout()</code> function when the component
		 * validates.</p>
		 *
		 * <p>To make changes to the layout before it updates the item
		 * renderer's children, override the <code>preLayout()</code> function
		 * instead.</p>
		 *
		 * @see #preLayout()
		 */
		protected function postLayout():void
		{

		}

		/**
		 * Updates the renderer to display the item's data. Override this
		 * function to pass data to sub-components and react to data changes.
		 *
		 * <p>Don't forget to handle the case where the data is <code>null</code>.</p>
		 */
		protected function commitData():void
		{

		}

		/**
		 * @private
		 */
		override protected function getCurrentBackgroundSkin():DisplayObject
		{
			if(!this._isEnabled && this._backgroundDisabledSkin !== null)
			{
				return this._backgroundDisabledSkin;
			}
			if(this._isSelected && this._backgroundSelectedSkin !== null)
			{
				return this._backgroundSelectedSkin;
			}
			return this._backgroundSkin;
		}

	}
}


================================================
FILE: source/feathers/controls/renderers/LayoutGroupGroupedListHeaderOrFooterRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.GroupedList;
	import feathers.controls.LayoutGroup;
	import feathers.skins.IStyleProvider;

	import starling.events.Event;

	/**
	 * Based on <code>LayoutGroup</code>, this component is meant as a base
	 * class for creating a custom header or footer renderer for a
	 * <code>GroupedList</code> component.
	 *
	 * <p>Sub-components may be created and added inside <code>initialize()</code>.
	 * This is a good place to add event listeners and to set the layout.</p>
	 *
	 * <p>The <code>data</code> property may be parsed inside <code>commitData()</code>.
	 * Use this function to change properties in your sub-components.</p>
	 *
	 * <p>Sub-components may be positioned manually, but a layout may be
	 * provided as well. An <code>AnchorLayout</code> is recommended for fluid
	 * layouts that can automatically adjust positions when the list resizes.
	 * Create <code>AnchorLayoutData</code> objects to define the constraints.</p>
	 *
	 * @see feathers.controls.GroupedList
	 *
	 * @productversion Feathers 1.2.0
	 */
	public class LayoutGroupGroupedListHeaderOrFooterRenderer extends LayoutGroup implements IGroupedListHeaderRenderer, IGroupedListFooterRenderer
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>LayoutGroupGroupedListHeaderOrFooterRenderer</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function LayoutGroupGroupedListHeaderOrFooterRenderer()
		{
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return LayoutGroupGroupedListHeaderOrFooterRenderer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _groupIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get groupIndex():int
		{
			return this._groupIndex;
		}

		/**
		 * @private
		 */
		public function set groupIndex(value:int):void
		{
			this._groupIndex = value;
		}

		/**
		 * @private
		 */
		protected var _layoutIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get layoutIndex():int
		{
			return this._layoutIndex;
		}

		/**
		 * @private
		 */
		public function set layoutIndex(value:int):void
		{
			this._layoutIndex = value;
		}

		/**
		 * @private
		 */
		protected var _owner:GroupedList;

		/**
		 * @inheritDoc
		 */
		public function get owner():GroupedList
		{
			return this._owner;
		}

		/**
		 * @private
		 */
		public function set owner(value:GroupedList):void
		{
			if(this._owner == value)
			{
				return;
			}
			this._owner = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _factoryID:String;

		/**
		 * @inheritDoc
		 */
		public function get factoryID():String
		{
			return this._factoryID;
		}

		/**
		 * @private
		 */
		public function set factoryID(value:String):void
		{
			this._factoryID = value;
		}

		/**
		 * @private
		 */
		protected var _data:Object;

		/**
		 * @inheritDoc
		 */
		public function get data():Object
		{
			return this._data;
		}

		/**
		 * @private
		 */
		public function set data(value:Object):void
		{
			if(this._data == value)
			{
				return;
			}
			this._data = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
			//LayoutGroup doesn't know about INVALIDATION_FLAG_DATA, so we need
			//set set another flag that it understands.
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _isSelected:Boolean;

		/**
		 * @inheritDoc
		 */
		public function get isSelected():Boolean
		{
			return this._isSelected;
		}

		/**
		 * @private
		 */
		public function set isSelected(value:Boolean):void
		{
			if(this._isSelected == value)
			{
				return;
			}
			this._isSelected = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.owner = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			//children are allowed to change during draw() in a subclass up
			//until it calls super.draw().
			this._ignoreChildChangesButSetFlags = false;

			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var scrollInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SCROLL);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);

			if(dataInvalid)
			{
				this.commitData();
			}

			if(scrollInvalid || sizeInvalid || layoutInvalid)
			{
				this._ignoreChildChanges = true;
				this.preLayout();
				this._ignoreChildChanges = false;
			}

			super.draw();

			if(scrollInvalid || sizeInvalid || layoutInvalid)
			{
				this._ignoreChildChanges = true;
				this.postLayout();
				this._ignoreChildChanges = false;
			}
		}

		/**
		 * Makes final changes to the layout before it updates the item
		 * renderer's children. If your layout requires changing the
		 * <code>layoutData</code> property on the item renderer's
		 * sub-components, override the <code>preLayout()</code> function to
		 * make those changes.
		 *
		 * <p>In subclasses, if you create properties that affect the layout,
		 * invalidate using <code>INVALIDATION_FLAG_LAYOUT</code> to trigger a
		 * call to the <code>preLayout()</code> function when the component
		 * validates.</p>
		 *
		 * <p>The final width and height of the item renderer are not yet known
		 * when this function is called. It is meant mainly for adjusting values
		 * used by fluid layouts, such as constraints or percentages. If you
		 * need io access the final width and height of the item renderer,
		 * override the <code>postLayout()</code> function instead.</p>
		 *
		 * @see #postLayout()
		 */
		protected function preLayout():void
		{

		}

		/**
		 * Called after the layout updates the item renderer's children. If any
		 * children are excluded from the layout, you can update them in the
		 * <code>postLayout()</code> function if you need to use the final width
		 * and height in any calculations.
		 *
		 * <p>In subclasses, if you create properties that affect the layout,
		 * invalidate using <code>INVALIDATION_FLAG_LAYOUT</code> to trigger a
		 * call to the <code>postLayout()</code> function when the component
		 * validates.</p>
		 *
		 * <p>To make changes to the layout before it updates the item
		 * renderer's children, override the <code>preLayout()</code> function
		 * instead.</p>
		 *
		 * @see #preLayout()
		 */
		protected function postLayout():void
		{

		}

		/**
		 * Updates the renderer to display the item's data. Override this
		 * function to pass data to sub-components and react to data changes.
		 *
		 * <p>Don't forget to handle the case where the data is <code>null</code>.</p>
		 */
		protected function commitData():void
		{

		}

	}
}


================================================
FILE: source/feathers/controls/renderers/LayoutGroupGroupedListItemRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.GroupedList;
	import feathers.controls.LayoutGroup;
	import feathers.skins.IStyleProvider;

	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * The background to display behind all content when the item renderer
	 * is selected. The background skin is resized to fill the full width
	 * and height of the layout group.
	 *
	 * <p>In the following example, the group is given a selected background
	 * skin:</p>
	 *
	 * <listing version="3.0">
	 * group.backgroundSelectedSkin = new Image( texture );</listing>
	 *
	 * @default null
	 */
	[Style(name="backgroundSelectedSkin",type="starling.display.DisplayObject")]

	/**
	 * Based on <code>LayoutGroup</code>, this component is meant as a base
	 * class for creating a custom item renderer for a <code>GroupedList</code>
	 * component.
	 *
	 * <p>Sub-components may be created and added inside <code>initialize()</code>.
	 * This is a good place to add event listeners and to set the layout.</p>
	 *
	 * <p>The <code>data</code> property may be parsed inside <code>commitData()</code>.
	 * Use this function to change properties in your sub-components.</p>
	 *
	 * <p>Sub-components may be positioned manually, but a layout may be
	 * provided as well. An <code>AnchorLayout</code> is recommended for fluid
	 * layouts that can automatically adjust positions when the list resizes.
	 * Create <code>AnchorLayoutData</code> objects to define the constraints.</p>
	 *
	 * @see feathers.controls.GroupedList
	 *
	 * @productversion Feathers 1.2.0
	 */
	public class LayoutGroupGroupedListItemRenderer extends LayoutGroup implements IGroupedListItemRenderer
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>LayoutGroupGroupedListItemRenderer</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function LayoutGroupGroupedListItemRenderer()
		{
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return LayoutGroupGroupedListItemRenderer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _groupIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get groupIndex():int
		{
			return this._groupIndex;
		}

		/**
		 * @private
		 */
		public function set groupIndex(value:int):void
		{
			this._groupIndex = value;
		}

		/**
		 * @private
		 */
		protected var _itemIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get itemIndex():int
		{
			return this._itemIndex;
		}

		/**
		 * @private
		 */
		public function set itemIndex(value:int):void
		{
			this._itemIndex = value;
		}

		/**
		 * @private
		 */
		protected var _layoutIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get layoutIndex():int
		{
			return this._layoutIndex;
		}

		/**
		 * @private
		 */
		public function set layoutIndex(value:int):void
		{
			this._layoutIndex = value;
		}

		/**
		 * @private
		 */
		protected var _owner:GroupedList;

		/**
		 * @inheritDoc
		 */
		public function get owner():GroupedList
		{
			return this._owner;
		}

		/**
		 * @private
		 */
		public function set owner(value:GroupedList):void
		{
			if(this._owner == value)
			{
				return;
			}
			this._owner = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _data:Object;

		/**
		 * @inheritDoc
		 */
		public function get data():Object
		{
			return this._data;
		}

		/**
		 * @private
		 */
		public function set data(value:Object):void
		{
			if(this._data == value)
			{
				return;
			}
			this._data = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
			//LayoutGroup doesn't know about INVALIDATION_FLAG_DATA, so we need
			//set set another flag that it understands.
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _isSelected:Boolean;

		/**
		 * @inheritDoc
		 */
		public function get isSelected():Boolean
		{
			return this._isSelected;
		}

		/**
		 * @private
		 */
		public function set isSelected(value:Boolean):void
		{
			if(this._isSelected == value)
			{
				return;
			}
			this._isSelected = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
			//the state flag is needed for updating the background
			this.invalidate(INVALIDATION_FLAG_STATE);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _factoryID:String;

		/**
		 * @inheritDoc
		 */
		public function get factoryID():String
		{
			return this._factoryID;
		}

		/**
		 * @private
		 */
		public function set factoryID(value:String):void
		{
			this._factoryID = value;
		}

		/**
		 * @private
		 */
		protected var _backgroundSelectedSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundSelectedSkin():DisplayObject
		{
			return this._backgroundSelectedSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundSelectedSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundSelectedSkin === value)
			{
				return;
			}
			if(this._backgroundSelectedSkin !== null &&
				this.currentBackgroundSkin === this._backgroundSelectedSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundSelectedSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundSelectedSkin = value;
			this.invalidate(INVALIDATION_FLAG_SKIN);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.owner = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			//children are allowed to change during draw() in a subclass up
			//until it calls super.draw().
			this._ignoreChildChangesButSetFlags = false;

			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var scrollInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SCROLL);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);

			if(dataInvalid)
			{
				this.commitData();
			}

			if(scrollInvalid || sizeInvalid || layoutInvalid)
			{
				this._ignoreChildChanges = true;
				this.preLayout();
				this._ignoreChildChanges = false;
			}

			super.draw();

			if(scrollInvalid || sizeInvalid || layoutInvalid)
			{
				this._ignoreChildChanges = true;
				this.postLayout();
				this._ignoreChildChanges = false;
			}
		}

		/**
		 * Makes final changes to the layout before it updates the item
		 * renderer's children. If your layout requires changing the
		 * <code>layoutData</code> property on the item renderer's
		 * sub-components, override the <code>preLayout()</code> function to
		 * make those changes.
		 *
		 * <p>In subclasses, if you create properties that affect the layout,
		 * invalidate using <code>INVALIDATION_FLAG_LAYOUT</code> to trigger a
		 * call to the <code>preLayout()</code> function when the component
		 * validates.</p>
		 *
		 * <p>The final width and height of the item renderer are not yet known
		 * when this function is called. It is meant mainly for adjusting values
		 * used by fluid layouts, such as constraints or percentages. If you
		 * need io access the final width and height of the item renderer,
		 * override the <code>postLayout()</code> function instead.</p>
		 *
		 * @see #postLayout()
		 */
		protected function preLayout():void
		{

		}

		/**
		 * Called after the layout updates the item renderer's children. If any
		 * children are excluded from the layout, you can update them in the
		 * <code>postLayout()</code> function if you need to use the final width
		 * and height in any calculations.
		 *
		 * <p>In subclasses, if you create properties that affect the layout,
		 * invalidate using <code>INVALIDATION_FLAG_LAYOUT</code> to trigger a
		 * call to the <code>postLayout()</code> function when the component
		 * validates.</p>
		 *
		 * <p>To make changes to the layout before it updates the item
		 * renderer's children, override the <code>preLayout()</code> function
		 * instead.</p>
		 *
		 * @see #preLayout()
		 */
		protected function postLayout():void
		{

		}

		/**
		 * Updates the renderer to display the item's data. Override this
		 * function to pass data to sub-components and react to data changes.
		 *
		 * <p>Don't forget to handle the case where the data is <code>null</code>.</p>
		 */
		protected function commitData():void
		{

		}

		/**
		 * @private
		 */
		override protected function getCurrentBackgroundSkin():DisplayObject
		{
			if(!this._isEnabled && this._backgroundDisabledSkin !== null)
			{
				return this._backgroundDisabledSkin;
			}
			if(this._isSelected && this._backgroundSelectedSkin !== null)
			{
				return this._backgroundSelectedSkin;
			}
			return this._backgroundSkin;
		}

	}
}


================================================
FILE: source/feathers/controls/renderers/LayoutGroupListItemRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.LayoutGroup;
	import feathers.controls.List;
	import feathers.skins.IStyleProvider;

	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * The background to display behind all content when the item renderer
	 * is selected. The background skin is resized to fill the full width
	 * and height of the layout group.
	 *
	 * <p>In the following example, the group is given a selected background
	 * skin:</p>
	 *
	 * <listing version="3.0">
	 * group.backgroundSelectedSkin = new Image( texture );</listing>
	 *
	 * @default null
	 */
	[Style(name="backgroundSelectedSkin",type="starling.display.DisplayObject")]

	/**
	 * Based on <code>LayoutGroup</code>, this component is meant as a base
	 * class for creating a custom item renderer for a <code>List</code>
	 * component.
	 *
	 * <p>Sub-components may be created and added inside <code>initialize()</code>.
	 * This is a good place to add event listeners and to set the layout.</p>
	 *
	 * <p>The <code>data</code> property may be parsed inside <code>commitData()</code>.
	 * Use this function to change properties in your sub-components.</p>
	 *
	 * <p>Sub-components may be positioned manually, but a layout may be
	 * provided as well. An <code>AnchorLayout</code> is recommended for fluid
	 * layouts that can automatically adjust positions when the list resizes.
	 * Create <code>AnchorLayoutData</code> objects to define the constraints.</p>
	 *
	 * @see feathers.controls.List
	 *
	 * @productversion Feathers 1.2.0
	 */
	public class LayoutGroupListItemRenderer extends LayoutGroup implements IListItemRenderer
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>LayoutGroupListItemRenderer</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function LayoutGroupListItemRenderer()
		{
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return LayoutGroupListItemRenderer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _index:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get index():int
		{
			return this._index;
		}

		/**
		 * @private
		 */
		public function set index(value:int):void
		{
			this._index = value;
		}

		/**
		 * @private
		 */
		protected var _owner:List;

		/**
		 * @inheritDoc
		 */
		public function get owner():List
		{
			return this._owner;
		}

		/**
		 * @private
		 */
		public function set owner(value:List):void
		{
			if(this._owner == value)
			{
				return;
			}
			this._owner = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _data:Object;

		/**
		 * @inheritDoc
		 */
		public function get data():Object
		{
			return this._data;
		}

		/**
		 * @private
		 */
		public function set data(value:Object):void
		{
			if(this._data == value)
			{
				return;
			}
			this._data = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
			//LayoutGroup doesn't know about INVALIDATION_FLAG_DATA, so we need
			//set set another flag that it understands.
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _isSelected:Boolean;

		/**
		 * @inheritDoc
		 */
		public function get isSelected():Boolean
		{
			return this._isSelected;
		}

		/**
		 * @private
		 */
		public function set isSelected(value:Boolean):void
		{
			if(this._isSelected == value)
			{
				return;
			}
			this._isSelected = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
			//the state flag is needed for updating the background
			this.invalidate(INVALIDATION_FLAG_STATE);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _factoryID:String;

		/**
		 * @inheritDoc
		 */
		public function get factoryID():String
		{
			return this._factoryID;
		}

		/**
		 * @private
		 */
		public function set factoryID(value:String):void
		{
			this._factoryID = value;
		}

		/**
		 * @private
		 */
		protected var _backgroundSelectedSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundSelectedSkin():DisplayObject
		{
			return this._backgroundSelectedSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundSelectedSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundSelectedSkin === value)
			{
				return;
			}
			if(this._backgroundSelectedSkin !== null &&
				this.currentBackgroundSkin === this._backgroundSelectedSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundSelectedSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundSelectedSkin = value;
			this.invalidate(INVALIDATION_FLAG_SKIN);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.owner = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			//children are allowed to change during draw() in a subclass up
			//until it calls super.draw().
			this._ignoreChildChangesButSetFlags = false;

			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var scrollInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SCROLL);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);

			if(dataInvalid)
			{
				this.commitData();
			}

			if(scrollInvalid || sizeInvalid || layoutInvalid)
			{
				this._ignoreChildChanges = true;
				this.preLayout();
				this._ignoreChildChanges = false;
			}

			super.draw();

			if(scrollInvalid || sizeInvalid || layoutInvalid)
			{
				this._ignoreChildChanges = true;
				this.postLayout();
				this._ignoreChildChanges = false;
			}
		}

		/**
		 * Makes final changes to the layout before it updates the item
		 * renderer's children. If your layout requires changing the
		 * <code>layoutData</code> property on the item renderer's
		 * sub-components, override the <code>preLayout()</code> function to
		 * make those changes.
		 *
		 * <p>In subclasses, if you create properties that affect the layout,
		 * invalidate using <code>INVALIDATION_FLAG_LAYOUT</code> to trigger a
		 * call to the <code>preLayout()</code> function when the component
		 * validates.</p>
		 *
		 * <p>The final width and height of the item renderer are not yet known
		 * when this function is called. It is meant mainly for adjusting values
		 * used by fluid layouts, such as constraints or percentages. If you
		 * need io access the final width and height of the item renderer,
		 * override the <code>postLayout()</code> function instead.</p>
		 *
		 * @see #postLayout()
		 */
		protected function preLayout():void
		{

		}

		/**
		 * Called after the layout updates the item renderer's children. If any
		 * children are excluded from the layout, you can update them in the
		 * <code>postLayout()</code> function if you need to use the final width
		 * and height in any calculations.
		 *
		 * <p>In subclasses, if you create properties that affect the layout,
		 * invalidate using <code>INVALIDATION_FLAG_LAYOUT</code> to trigger a
		 * call to the <code>postLayout()</code> function when the component
		 * validates.</p>
		 *
		 * <p>To make changes to the layout before it updates the item
		 * renderer's children, override the <code>preLayout()</code> function
		 * instead.</p>
		 *
		 * @see #preLayout()
		 */
		protected function postLayout():void
		{

		}

		/**
		 * Updates the renderer to display the item's data. Override this
		 * function to pass data to sub-components and react to data changes.
		 *
		 * <p>Don't forget to handle the case where the data is <code>null</code>.</p>
		 */
		protected function commitData():void
		{

		}

		/**
		 * @private
		 */
		override protected function getCurrentBackgroundSkin():DisplayObject
		{
			if(!this._isEnabled && this._backgroundDisabledSkin !== null)
			{
				return this._backgroundDisabledSkin;
			}
			if(this._isSelected && this._backgroundSelectedSkin !== null)
			{
				return this._backgroundSelectedSkin;
			}
			return this._backgroundSkin;
		}

	}
}


================================================
FILE: source/feathers/controls/renderers/LayoutGroupTreeItemRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.renderers
{
	import feathers.controls.LayoutGroup;
	import feathers.controls.Tree;
	import feathers.skins.IStyleProvider;

	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * The background to display behind all content when the item renderer
	 * is selected. The background skin is resized to fill the full width
	 * and height of the layout group.
	 *
	 * <p>In the following example, the group is given a selected background
	 * skin:</p>
	 *
	 * <listing version="3.0">
	 * group.backgroundSelectedSkin = new Image( texture );</listing>
	 *
	 * @default null
	 */
	[Style(name="backgroundSelectedSkin",type="starling.display.DisplayObject")]

	/**
	 * Based on <code>LayoutGroup</code>, this component is meant as a base
	 * class for creating a custom item renderer for a <code>Tree</code>
	 * component.
	 *
	 * <p>Sub-components may be created and added inside <code>initialize()</code>.
	 * This is a good place to add event listeners and to set the layout.</p>
	 *
	 * <p>The <code>data</code> property may be parsed inside <code>commitData()</code>.
	 * Use this function to change properties in your sub-components.</p>
	 *
	 * <p>Sub-components may be positioned manually, but a layout may be
	 * provided as well. An <code>AnchorLayout</code> is recommended for fluid
	 * layouts that can automatically adjust positions when the list resizes.
	 * Create <code>AnchorLayoutData</code> objects to define the constraints.</p>
	 *
	 * @see feathers.controls.Tree
	 *
	 * @productversion Feathers 1.2.0
	 */
	public class LayoutGroupTreeItemRenderer extends LayoutGroup implements ITreeItemRenderer
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>LayoutGroupTreeItemRenderer</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function LayoutGroupTreeItemRenderer()
		{
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return LayoutGroupTreeItemRenderer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _location:Vector.<int> = null;

		/**
		 * @inheritDoc
		 */
		public function get location():Vector.<int>
		{
			return this._location;
		}

		/**
		 * @private
		 */
		public function set location(value:Vector.<int>):void
		{
			this._location = value;
		}

		/**
		 * @private
		 */
		protected var _layoutIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get layoutIndex():int
		{
			return this._layoutIndex;
		}

		/**
		 * @private
		 */
		public function set layoutIndex(value:int):void
		{
			this._layoutIndex = value;
		}

		/**
		 * @private
		 */
		protected var _owner:Tree;

		/**
		 * @inheritDoc
		 */
		public function get owner():Tree
		{
			return this._owner;
		}

		/**
		 * @private
		 */
		public function set owner(value:Tree):void
		{
			if(this._owner == value)
			{
				return;
			}
			this._owner = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _data:Object;

		/**
		 * @inheritDoc
		 */
		public function get data():Object
		{
			return this._data;
		}

		/**
		 * @private
		 */
		public function set data(value:Object):void
		{
			if(this._data == value)
			{
				return;
			}
			this._data = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
			//LayoutGroup doesn't know about INVALIDATION_FLAG_DATA, so we need
			//set set another flag that it understands.
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _isSelected:Boolean;

		/**
		 * @inheritDoc
		 */
		public function get isSelected():Boolean
		{
			return this._isSelected;
		}

		/**
		 * @private
		 */
		public function set isSelected(value:Boolean):void
		{
			if(this._isSelected == value)
			{
				return;
			}
			this._isSelected = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
			//the state flag is needed for updating the background
			this.invalidate(INVALIDATION_FLAG_STATE);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _isBranch:Boolean;

		/**
		 * @inheritDoc
		 */
		public function get isBranch():Boolean
		{
			return this._isBranch;
		}

		/**
		 * @private
		 */
		public function set isBranch(value:Boolean):void
		{
			if(this._isBranch === value)
			{
				return;
			}
			this._isBranch = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _isOpen:Boolean;

		/**
		 * @inheritDoc
		 */
		public function get isOpen():Boolean
		{
			return this._isOpen;
		}

		/**
		 * @private
		 */
		public function set isOpen(value:Boolean):void
		{
			if(this._isOpen === value)
			{
				return;
			}
			this._isOpen = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _factoryID:String;

		/**
		 * @inheritDoc
		 */
		public function get factoryID():String
		{
			return this._factoryID;
		}

		/**
		 * @private
		 */
		public function set factoryID(value:String):void
		{
			this._factoryID = value;
		}

		/**
		 * @private
		 */
		protected var _backgroundSelectedSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get backgroundSelectedSkin():DisplayObject
		{
			return this._backgroundSelectedSkin;
		}

		/**
		 * @private
		 */
		public function set backgroundSelectedSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._backgroundSelectedSkin === value)
			{
				return;
			}
			if(this._backgroundSelectedSkin !== null &&
				this.currentBackgroundSkin === this._backgroundSelectedSkin)
			{
				this.removeCurrentBackgroundSkin(this._backgroundSelectedSkin);
				this.currentBackgroundSkin = null;
			}
			this._backgroundSelectedSkin = value;
			this.invalidate(INVALIDATION_FLAG_SKIN);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.owner = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			//children are allowed to change during draw() in a subclass up
			//until it calls super.draw().
			this._ignoreChildChangesButSetFlags = false;

			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var scrollInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SCROLL);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);

			if(dataInvalid)
			{
				this.commitData();
			}

			if(scrollInvalid || sizeInvalid || layoutInvalid)
			{
				this._ignoreChildChanges = true;
				this.preLayout();
				this._ignoreChildChanges = false;
			}

			super.draw();

			if(scrollInvalid || sizeInvalid || layoutInvalid)
			{
				this._ignoreChildChanges = true;
				this.postLayout();
				this._ignoreChildChanges = false;
			}
		}

		/**
		 * Makes final changes to the layout before it updates the item
		 * renderer's children. If your layout requires changing the
		 * <code>layoutData</code> property on the item renderer's
		 * sub-components, override the <code>preLayout()</code> function to
		 * make those changes.
		 *
		 * <p>In subclasses, if you create properties that affect the layout,
		 * invalidate using <code>INVALIDATION_FLAG_LAYOUT</code> to trigger a
		 * call to the <code>preLayout()</code> function when the component
		 * validates.</p>
		 *
		 * <p>The final width and height of the item renderer are not yet known
		 * when this function is called. It is meant mainly for adjusting values
		 * used by fluid layouts, such as constraints or percentages. If you
		 * need io access the final width and height of the item renderer,
		 * override the <code>postLayout()</code> function instead.</p>
		 *
		 * @see #postLayout()
		 */
		protected function preLayout():void
		{

		}

		/**
		 * Called after the layout updates the item renderer's children. If any
		 * children are excluded from the layout, you can update them in the
		 * <code>postLayout()</code> function if you need to use the final width
		 * and height in any calculations.
		 *
		 * <p>In subclasses, if you create properties that affect the layout,
		 * invalidate using <code>INVALIDATION_FLAG_LAYOUT</code> to trigger a
		 * call to the <code>postLayout()</code> function when the component
		 * validates.</p>
		 *
		 * <p>To make changes to the layout before it updates the item
		 * renderer's children, override the <code>preLayout()</code> function
		 * instead.</p>
		 *
		 * @see #preLayout()
		 */
		protected function postLayout():void
		{

		}

		/**
		 * Updates the renderer to display the item's data. Override this
		 * function to pass data to sub-components and react to data changes.
		 *
		 * <p>Don't forget to handle the case where the data is <code>null</code>.</p>
		 */
		protected function commitData():void
		{

		}

		/**
		 * @private
		 */
		override protected function getCurrentBackgroundSkin():DisplayObject
		{
			if(!this._isEnabled && this._backgroundDisabledSkin !== null)
			{
				return this._backgroundDisabledSkin;
			}
			if(this._isSelected && this._backgroundSelectedSkin !== null)
			{
				return this._backgroundSelectedSkin;
			}
			return this._backgroundSkin;
		}

	}
}


================================================
FILE: source/feathers/controls/supportClasses/BaseScreenNavigator.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.supportClasses
{
	import feathers.controls.AutoSizeMode;
	import feathers.controls.IScreen;
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IValidating;
	import feathers.events.FeathersEventType;
	import feathers.utils.skins.resetFluidChildDimensionsForMeasurement;

	import flash.errors.IllegalOperationError;
	import flash.utils.getDefinitionByName;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Quad;
	import starling.errors.AbstractMethodError;
	import starling.events.Event;

	/**
	 * Dispatched when the active screen changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #activeScreen
	 * @see #activeScreenID
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the current screen is removed and there is no active
	 * screen.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.CLEAR
	 */
	[Event(name="clear",type="starling.events.Event")]

	/**
	 * Dispatched when the transition between screens begins.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.TRANSITION_START
	 */
	[Event(name="transitionStart",type="starling.events.Event")]

	/**
	 * Dispatched when the transition between screens has completed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.TRANSITION_COMPLETE
	 */
	[Event(name="transitionComplete",type="starling.events.Event")]

	/**
	 * A base class for screen navigator components that isn't meant to be
	 * instantiated directly. It should only be subclassed.
	 *
	 * @see feathers.controls.StackScreenNavigator
	 * @see feathers.controls.ScreenNavigator
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class BaseScreenNavigator extends FeathersControl
	{
		/**
		 * @private
		 */
		protected static var SIGNAL_TYPE:Class;

		/**
		 * The default transition function.
		 */
		protected static function defaultTransition(oldScreen:DisplayObject, newScreen:DisplayObject, completeCallback:Function):void
		{
			//in short, do nothing
			completeCallback();
		}

		/**
		 * Constructor.
		 */
		public function BaseScreenNavigator()
		{
			super();
			if(Object(this).constructor == BaseScreenNavigator)
			{
				throw new Error(FeathersControl.ABSTRACT_CLASS_ERROR);
			}
			if(!SIGNAL_TYPE)
			{
				try
				{
					SIGNAL_TYPE = Class(getDefinitionByName("org.osflash.signals.ISignal"));
				}
				catch(error:Error)
				{
					//signals not being used
				}
			}
			this.screenContainer = this;
			this.addEventListener(Event.ADDED_TO_STAGE, screenNavigator_addedToStageHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, screenNavigator_removedFromStageHandler);
		}

		/**
		 * @private
		 */
		protected var _activeScreenID:String;

		/**
		 * The string identifier for the currently active screen.
		 */
		public function get activeScreenID():String
		{
			return this._activeScreenID;
		}

		/**
		 * @private
		 */
		protected var _activeScreen:DisplayObject;

		/**
		 * A reference to the currently active screen.
		 */
		public function get activeScreen():DisplayObject
		{
			return this._activeScreen;
		}

		/**
		 * @private
		 */
		protected var screenContainer:DisplayObjectContainer;

		/**
		 * @private
		 */
		protected var _activeScreenExplicitWidth:Number;

		/**
		 * @private
		 */
		protected var _activeScreenExplicitHeight:Number;

		/**
		 * @private
		 */
		protected var _activeScreenExplicitMinWidth:Number;

		/**
		 * @private
		 */
		protected var _activeScreenExplicitMinHeight:Number;

		/**
		 * @private
		 */
		protected var _activeScreenExplicitMaxWidth:Number;

		/**
		 * @private
		 */
		protected var _activeScreenExplicitMaxHeight:Number;

		/**
		 * @private
		 */
		protected var _screens:Object = {};

		/**
		 * @private
		 */
		protected var _previousScreenInTransitionID:String;

		/**
		 * @private
		 */
		protected var _previousScreenInTransition:DisplayObject;

		/**
		 * @private
		 */
		protected var _nextScreenID:String = null;

		/**
		 * @private
		 */
		protected var _nextScreenTransition:Function = null;

		/**
		 * @private
		 */
		protected var _clearAfterTransition:Boolean = false;

		/**
		 * @private
		 */
		protected var _delayedTransition:Function = null;

		/**
		 * @private
		 */
		protected var _waitingForDelayedTransition:Boolean = false;

		/**
		 * @private
		 */
		protected var _clipContent:Boolean = false;

		/**
		 * Determines if the navigator's content should be clipped to the width
		 * and height.
		 *
		 * <p>In the following example, clipping is enabled:</p>
		 *
		 * <listing version="3.0">
		 * navigator.clipContent = true;</listing>
		 *
		 * @default false
		 */
		public function get clipContent():Boolean
		{
			return this._clipContent;
		}

		/**
		 * @private
		 */
		public function set clipContent(value:Boolean):void
		{
			if(this._clipContent == value)
			{
				return;
			}
			this._clipContent = value;
			if(!value)
			{
				this.mask = null;
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _autoSizeMode:String = AutoSizeMode.STAGE;

		[Inspectable(type="String",enumeration="stage,content")]
		/**
		 * Determines how the screen navigator will set its own size when its
		 * dimensions (width and height) aren't set explicitly.
		 *
		 * <p>In the following example, the screen navigator will be sized to
		 * match its content:</p>
		 *
		 * <listing version="3.0">
		 * navigator.autoSizeMode = AutoSizeMode.CONTENT;</listing>
		 *
		 * @default feathers.controls.AutoSizeMode.STAGE
		 *
		 * @see feathers.controls.AutoSizeMode#STAGE
		 * @see feathers.controls.AutoSizeMode#CONTENT
		 */
		public function get autoSizeMode():String
		{
			return this._autoSizeMode;
		}

		/**
		 * @private
		 */
		public function set autoSizeMode(value:String):void
		{
			if(this._autoSizeMode == value)
			{
				return;
			}
			this._autoSizeMode = value;
			if(this._activeScreen)
			{
				if(this._autoSizeMode == AutoSizeMode.CONTENT)
				{
					this._activeScreen.addEventListener(Event.RESIZE, activeScreen_resizeHandler);
				}
				else
				{
					this._activeScreen.removeEventListener(Event.RESIZE, activeScreen_resizeHandler);
				}
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _waitingTransition:Function;

		/**
		 * @private
		 */
		private var _waitingForTransitionFrameCount:int = 1;

		/**
		 * @private
		 */
		protected var _isTransitionActive:Boolean = false;

		/**
		 * Indicates whether the screen navigator is currently transitioning
		 * between screens.
		 */
		public function get isTransitionActive():Boolean
		{
			return this._isTransitionActive;
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this._activeScreen)
			{
				this.cleanupActiveScreen();
				this._activeScreen = null;
				this._activeScreenID = null;
			}
			super.dispose();
		}

		/**
		 * Removes all screens that were added with <code>addScreen()</code>.
		 *
		 * @see #addScreen()
		 */
		public function removeAllScreens():void
		{
			if(this._isTransitionActive)
			{
				throw new IllegalOperationError("Cannot remove all screens while a transition is active.");
			}
			if(this._activeScreen)
			{
				//if someone meant to have a transition, they would have called
				//clearScreen()
				this.clearScreenInternal(null);
				this.dispatchEventWith(FeathersEventType.CLEAR);
			}
			for(var id:String in this._screens)
			{
				delete this._screens[id];
			}
		}

		/**
		 * Determines if the specified screen identifier has been added with
		 * <code>addScreen()</code>.
		 *
		 * @see #addScreen()
		 */
		public function hasScreen(id:String):Boolean
		{
			return this._screens.hasOwnProperty(id);
		}

		/**
		 * Returns a list of the screen identifiers that have been added.
		 */
		public function getScreenIDs(result:Vector.<String> = null):Vector.<String>
		{
			if(result)
			{
				result.length = 0;
			}
			else
			{
				result = new <String>[];
			}
			var pushIndex:int = 0;
			for(var id:String in this._screens)
			{
				result[pushIndex] = id;
				pushIndex++;
			}
			return result;
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var selectionInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SELECTED);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			this.layoutChildren();

			if(stylesInvalid || sizeInvalid)
			{
				this.refreshMask();
			}
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			var needsToMeasureContent:Boolean = this._autoSizeMode === AutoSizeMode.CONTENT || this.stage === null;
			var measureScreen:IMeasureDisplayObject = this._activeScreen as IMeasureDisplayObject;
			if(needsToMeasureContent)
			{
				if(this._activeScreen !== null)
				{
					resetFluidChildDimensionsForMeasurement(this._activeScreen,
						this._explicitWidth, this._explicitHeight,
						this._explicitMinWidth, this._explicitMinHeight,
						this._explicitMaxWidth, this._explicitMaxHeight,
						this._activeScreenExplicitWidth, this._activeScreenExplicitHeight,
						this._activeScreenExplicitMinWidth, this._activeScreenExplicitMinHeight,
						this._activeScreenExplicitMaxWidth, this._activeScreenExplicitMaxHeight);
					if(this._activeScreen is IValidating)
					{
						IValidating(this._activeScreen).validate();
					}
				}
			}

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				if(needsToMeasureContent)
				{
					if(this._activeScreen !== null)
					{
						newWidth = this._activeScreen.width;
					}
					else
					{
						newWidth = 0;
					}
				}
				else
				{
					newWidth = this.stage.stageWidth;
				}
			}

			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				if(needsToMeasureContent)
				{
					if(this._activeScreen !== null)
					{
						newHeight = this._activeScreen.height;
					}
					else
					{
						newHeight = 0;
					}
				}
				else
				{
					newHeight = this.stage.stageHeight;
				}
			}

			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				if(needsToMeasureContent)
				{
					if(measureScreen !== null)
					{
						newMinWidth = measureScreen.minWidth;
					}
					else if(this._activeScreen !== null)
					{
						newMinWidth = this._activeScreen.width;
					}
					else
					{
						newMinWidth = 0;
					}
				}
				else
				{
					newMinWidth = this.stage.stageWidth;
				}
			}

			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				if(needsToMeasureContent)
				{
					if(measureScreen !== null)
					{
						newMinHeight = measureScreen.minHeight;
					}
					else if(this._activeScreen !== null)
					{
						newMinHeight = this._activeScreen.height;
					}
					else
					{
						newMinHeight = 0;
					}
				}
				else
				{
					newMinHeight = this.stage.stageHeight;
				}
			}

			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * @private
		 */
		protected function addScreenInternal(id:String, item:IScreenNavigatorItem):void
		{
			if(this._screens.hasOwnProperty(id))
			{
				throw new ArgumentError("Screen with id '" + id + "' already defined. Cannot add two screens with the same id.");
			}
			this._screens[id] = item;
		}

		/**
		 * @private
		 */
		protected function refreshMask():void
		{
			if(!this._clipContent)
			{
				return;
			}
			var mask:DisplayObject = this.mask as Quad;
			if(mask)
			{
				mask.width = this.actualWidth;
				mask.height = this.actualHeight;
			}
			else
			{
				mask = new Quad(1, 1, 0xff00ff);
				//the initial dimensions cannot be 0 or there's a runtime error,
				//and these values might be 0
				mask.width = this.actualWidth;
				mask.height = this.actualHeight;
				this.mask = mask;
			}
		}

		/**
		 * @private
		 */
		protected function removeScreenInternal(id:String):IScreenNavigatorItem
		{
			if(!this._screens.hasOwnProperty(id))
			{
				throw new ArgumentError("Screen '" + id + "' cannot be removed because it has not been added.");
			}
			if(this._isTransitionActive && (id == this._previousScreenInTransitionID || id == this._activeScreenID))
			{
				throw new IllegalOperationError("Cannot remove a screen while it is transitioning in or out.");
			}
			if(this._activeScreenID == id)
			{
				//if someone meant to have a transition, they would have called
				//clearScreen()
				this.clearScreenInternal(null);
				this.dispatchEventWith(FeathersEventType.CLEAR);
			}
			var item:IScreenNavigatorItem = IScreenNavigatorItem(this._screens[id]);
			delete this._screens[id];
			return item;
		}

		/**
		 * @private
		 */
		protected function showScreenInternal(id:String, transition:Function, properties:Object = null):DisplayObject
		{
			if(!this.hasScreen(id))
			{
				throw new ArgumentError("Screen with id '" + id + "' cannot be shown because it has not been defined.");
			}

			if(this._isTransitionActive)
			{
				this._nextScreenID = id;
				this._nextScreenTransition = transition;
				this._clearAfterTransition = false;
				return null;
			}

			this._previousScreenInTransition = this._activeScreen;
			this._previousScreenInTransitionID = this._activeScreenID;
			if(this._activeScreen !== null)
			{
				this.cleanupActiveScreen();
			}

			this._isTransitionActive = true;

			var item:IScreenNavigatorItem = IScreenNavigatorItem(this._screens[id]);
			this._activeScreen = item.getScreen();
			this._activeScreenID = id;
			if(item.transitionDelayEvent !== null)
			{
				this._waitingForDelayedTransition = true;
				this._activeScreen.addEventListener(item.transitionDelayEvent, screen_transitionDelayHandler);
			}
			else
			{
				this._waitingForDelayedTransition = false;
			}
			for(var propertyName:String in properties)
			{
				this._activeScreen[propertyName] = properties[propertyName];
			}
			if(this._activeScreen is IScreen)
			{
				var screen:IScreen = IScreen(this._activeScreen);
				screen.screenID = this._activeScreenID;
				screen.owner = this; //subclasses will implement the interface
			}
			if(this._autoSizeMode === AutoSizeMode.CONTENT || !this.stage)
			{
				this._activeScreen.addEventListener(Event.RESIZE, activeScreen_resizeHandler);
			}
			this.prepareActiveScreen();
			var isSameInstance:Boolean = this._previousScreenInTransition === this._activeScreen;
			this.screenContainer.addChild(this._activeScreen);
			if(this._activeScreen is IFeathersControl)
			{
				IFeathersControl(this._activeScreen).initializeNow();
			}
			var measureScreen:IMeasureDisplayObject = this._activeScreen as IMeasureDisplayObject;
			if(measureScreen !== null)
			{
				this._activeScreenExplicitWidth = measureScreen.explicitWidth;
				this._activeScreenExplicitHeight = measureScreen.explicitHeight;
				this._activeScreenExplicitMinWidth = measureScreen.explicitMinWidth;
				this._activeScreenExplicitMinHeight = measureScreen.explicitMinHeight;
				this._activeScreenExplicitMaxWidth = measureScreen.explicitMaxWidth;
				this._activeScreenExplicitMaxHeight = measureScreen.explicitMaxHeight;
			}
			else
			{
				this._activeScreenExplicitWidth = this._activeScreen.width;
				this._activeScreenExplicitHeight = this._activeScreen.height;
				this._activeScreenExplicitMinWidth = this._activeScreenExplicitWidth;
				this._activeScreenExplicitMinHeight = this._activeScreenExplicitHeight;
				this._activeScreenExplicitMaxWidth = this._activeScreenExplicitWidth;
				this._activeScreenExplicitMaxHeight = this._activeScreenExplicitHeight;
			}

			this.invalidate(INVALIDATION_FLAG_SELECTED);
			if(this._validationQueue && !this._validationQueue.isValidating)
			{
				//force a COMPLETE validation of everything
				//but only if we're not already doing that...
				this._validationQueue.advanceTime(0);
			}
			else if(!this._isValidating)
			{
				this.validate();
			}

			if(isSameInstance)
			{
				//we can't transition if both screens are the same display
				//object, so skip the transition!
				this._previousScreenInTransition = null;
				this._previousScreenInTransitionID = null;
				this._isTransitionActive = false;
			}
			else if(item.transitionDelayEvent !== null && this._waitingForDelayedTransition)
			{
				this._waitingForDelayedTransition = false;
				this._activeScreen.visible = false;
				this._delayedTransition = transition;
			}
			else
			{
				if(item.transitionDelayEvent !== null)
				{
					//if we skipped the delay because the event was already
					//dispatched, then don't forget to remove the listener
					this._activeScreen.removeEventListener(item.transitionDelayEvent, screen_transitionDelayHandler);
				}
				this.startTransition(transition);
			}

			this.dispatchEventWith(Event.CHANGE);
			return this._activeScreen;
		}

		/**
		 * @private
		 */
		protected function clearScreenInternal(transition:Function = null):void
		{
			if(this._activeScreen === null)
			{
				//no screen visible.
				return;
			}

			if(this._isTransitionActive)
			{
				this._nextScreenID = null;
				this._clearAfterTransition = true;
				this._nextScreenTransition = transition;
				return;
			}

			this.cleanupActiveScreen();

			this._isTransitionActive = true;
			this._previousScreenInTransition = this._activeScreen;
			this._previousScreenInTransitionID = this._activeScreenID;
			this._activeScreen = null;
			this._activeScreenID = null;

			this.dispatchEventWith(FeathersEventType.TRANSITION_START);
			this._previousScreenInTransition.dispatchEventWith(FeathersEventType.TRANSITION_OUT_START);
			if(transition !== null)
			{
				this._waitingForTransitionFrameCount = 0;
				this._waitingTransition = transition;
				//this is a workaround for an issue with transition performance.
				//see the comment in the listener for details.
				this.addEventListener(Event.ENTER_FRAME, waitingForTransition_enterFrameHandler);
			}
			else
			{
				defaultTransition(this._previousScreenInTransition, this._activeScreen, transitionComplete);
			}
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * @private
		 */
		protected function prepareActiveScreen():void
		{
			throw new AbstractMethodError();
		}

		/**
		 * @private
		 */
		protected function cleanupActiveScreen():void
		{
			throw new AbstractMethodError();
		}

		/**
		 * @private
		 */
		protected function layoutChildren():void
		{
			if(this._activeScreen !== null)
			{
				if(this._activeScreen.width != this.actualWidth)
				{
					this._activeScreen.width = this.actualWidth;
				}
				if(this._activeScreen.height != this.actualHeight)
				{
					this._activeScreen.height = this.actualHeight;
				}
				if(this._activeScreen is IValidating)
				{
					IValidating(this._activeScreen).validate();
				}
			}
		}

		/**
		 * @private
		 */
		protected function startTransition(transition:Function):void
		{
			this.dispatchEventWith(FeathersEventType.TRANSITION_START);
			this._activeScreen.dispatchEventWith(FeathersEventType.TRANSITION_IN_START);
			if(this._previousScreenInTransition !== null)
			{
				this._previousScreenInTransition.dispatchEventWith(FeathersEventType.TRANSITION_OUT_START);
			}
			if(transition !== null && transition !== defaultTransition)
			{
				//temporarily make the active screen invisible because the
				//transition doesn't start right away.
				this._activeScreen.visible = false;
				this._waitingForTransitionFrameCount = 0;
				this._waitingTransition = transition;
				//this is a workaround for an issue with transition performance.
				//see the comment in the listener for details.
				this.addEventListener(Event.ENTER_FRAME, waitingForTransition_enterFrameHandler);
			}
			else
			{
				//the screen may have been hidden if the transition was delayed
				this._activeScreen.visible = true;
				defaultTransition(this._previousScreenInTransition, this._activeScreen, transitionComplete);
			}
		}

		/**
		 * @private
		 */
		protected function startWaitingTransition():void
		{
			this.removeEventListener(Event.ENTER_FRAME, waitingForTransition_enterFrameHandler);
			if(this._activeScreen)
			{
				this._activeScreen.visible = true;
			}

			var transition:Function = this._waitingTransition;
			this._waitingTransition = null;
			transition(this._previousScreenInTransition, this._activeScreen, transitionComplete);
		}

		/**
		 * @private
		 */
		protected function transitionComplete(cancelTransition:Boolean = false):void
		{
			//consider the transition still active if something is already
			//queued up to happen next. if an event listener asks to show a new
			//screen, it needs to replace what is queued up.
			this._isTransitionActive = this._clearAfterTransition || this._nextScreenID;
			if(cancelTransition)
			{
				if(this._activeScreen !== null)
				{
					var item:IScreenNavigatorItem = IScreenNavigatorItem(this._screens[this._activeScreenID]);
					this.cleanupActiveScreen();
					this.screenContainer.removeChild(this._activeScreen, item.canDispose);
					if(!item.canDispose)
					{
						this._activeScreen.width = this._activeScreenExplicitWidth;
						this._activeScreen.height = this._activeScreenExplicitHeight;
						var measureScreen:IMeasureDisplayObject = this._activeScreen as IMeasureDisplayObject;
						if(measureScreen !== null)
						{
							measureScreen.minWidth = this._activeScreenExplicitMinWidth;
							measureScreen.minHeight = this._activeScreenExplicitMinHeight;
						}
					}
				}
				this._activeScreen = this._previousScreenInTransition;
				this._activeScreenID = this._previousScreenInTransitionID;
				this._previousScreenInTransition = null;
				this._previousScreenInTransitionID = null;
				this.prepareActiveScreen();
				this.dispatchEventWith(FeathersEventType.TRANSITION_CANCEL);
				this.dispatchEventWith(Event.CHANGE);
			}
			else
			{
				//we need to save these in local variables because a new
				//transition may be started in the listeners for the transition
				//complete events, and that will overwrite them.
				var activeScreen:DisplayObject = this._activeScreen;
				var previousScreen:DisplayObject = this._previousScreenInTransition;
				var previousScreenID:String = this._previousScreenInTransitionID;
				item = IScreenNavigatorItem(this._screens[previousScreenID]);
				this._previousScreenInTransition = null;
				this._previousScreenInTransitionID = null;
				if(previousScreen !== null)
				{
					previousScreen.dispatchEventWith(FeathersEventType.TRANSITION_OUT_COMPLETE);
				}
				if(activeScreen !== null)
				{
					activeScreen.dispatchEventWith(FeathersEventType.TRANSITION_IN_COMPLETE);
				}
				//we need to dispatch this event before the previous screen's
				//owner property is set to null because legacy code that was
				//written before TRANSITION_OUT_COMPLETE existed may be using
				//this event for the same purpose.
				this.dispatchEventWith(FeathersEventType.TRANSITION_COMPLETE);
				if(previousScreen !== null)
				{
					if(previousScreen is IScreen)
					{
						var screen:IScreen = IScreen(previousScreen);
						screen.screenID = null;
						screen.owner = null;
					}
					previousScreen.removeEventListener(Event.RESIZE, activeScreen_resizeHandler);
					this.screenContainer.removeChild(previousScreen, item.canDispose);
				}
			}

			this._isTransitionActive = false;
			var nextTransition:Function = this._nextScreenTransition;
			this._nextScreenTransition = null;
			if(this._clearAfterTransition)
			{
				this._clearAfterTransition = false;
				this.clearScreenInternal(nextTransition);
			}
			else if(this._nextScreenID !== null)
			{
				var nextScreenID:String = this._nextScreenID;
				this._nextScreenID = null;
				this.showScreenInternal(nextScreenID, nextTransition);
			}
		}

		/**
		 * @private
		 */
		protected function screenNavigator_addedToStageHandler(event:Event):void
		{
			if(this._autoSizeMode === AutoSizeMode.STAGE)
			{
				//if we validated before being added to the stage, or if we've
				//been removed from stage and added again, we need to be sure
				//that the new stage dimensions are accounted for.
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			this.stage.addEventListener(Event.RESIZE, stage_resizeHandler);
		}

		/**
		 * @private
		 */
		protected function screenNavigator_removedFromStageHandler(event:Event):void
		{
			this.stage.removeEventListener(Event.RESIZE, stage_resizeHandler);
		}

		/**
		 * @private
		 */
		protected function activeScreen_resizeHandler(event:Event):void
		{
			if(this._isValidating || this._autoSizeMode != AutoSizeMode.CONTENT)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected function stage_resizeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected function screen_transitionDelayHandler(event:Event):void
		{
			this._activeScreen.removeEventListener(event.type, screen_transitionDelayHandler);
			var wasWaiting:Boolean = this._waitingForDelayedTransition;
			this._waitingForDelayedTransition = false;
			if(wasWaiting)
			{
				return;
			}
			var transition:Function = this._delayedTransition;
			this._delayedTransition = null;
			this.startTransition(transition);
		}

		/**
		 * @private
		 */
		private function waitingForTransition_enterFrameHandler(event:Event):void
		{
			//we need to wait a couple of frames before we can start the
			//transition to make it as smooth as possible. this feels a little
			//hacky, to be honest, but I can't figure out why waiting only one
			//frame won't do the trick. the delay is so small though that it's
			//virtually impossible to notice.
			if(this._waitingForTransitionFrameCount < 2)
			{
				this._waitingForTransitionFrameCount++;
				return;
			}
			this.startWaitingTransition();
		}
	}
}


================================================
FILE: source/feathers/controls/supportClasses/DataGridDataViewPort.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.supportClasses
{
	import feathers.controls.DataGrid;
	import feathers.controls.Scroller;
	import feathers.controls.renderers.IDataGridCellRenderer;
	import feathers.controls.supportClasses.DataGridRowRenderer;
	import feathers.controls.supportClasses.IViewPort;
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IValidating;
	import feathers.data.IListCollection;
	import feathers.data.ListCollection;
	import feathers.events.CollectionEventType;
	import feathers.events.FeathersEventType;
	import feathers.layout.ILayout;
	import feathers.layout.IVariableVirtualLayout;
	import feathers.layout.IVirtualLayout;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.ViewPortBounds;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;
	import flash.utils.Dictionary;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.utils.Pool;

	/**
	 * @private
	 * Used internally by DataGrid. Not meant to be used on its own.
	 *
	 * @see feathers.controls.DataGrid
	 *
	 * @productversion Feathers 3.4.0
	 */
	public class DataGridDataViewPort extends FeathersControl implements IViewPort
	{
		private static const INVALIDATION_FLAG_ROW_RENDERER_FACTORY:String = "rowRendererFactory";
		private static const HELPER_VECTOR:Vector.<int> = new <int>[];

		public function DataGridDataViewPort()
		{
			super();
		}

		private var _viewPortBounds:ViewPortBounds = new ViewPortBounds();

		private var _layoutResult:LayoutBoundsResult = new LayoutBoundsResult();

		private var _typicalRowIsInDataProvider:Boolean = false;
		private var _typicalRowRenderer:DataGridRowRenderer;
		private var _rows:Vector.<DisplayObject> = new <DisplayObject>[];
		private var _rowRendererMap:Dictionary = new Dictionary(true);
		private var _unrenderedRows:Vector.<int> = new <int>[];
		private var _rowStorage:RowRendererFactoryStorage = new RowRendererFactoryStorage();
		private var _minimumRowCount:int = 0;

		private var _actualMinVisibleWidth:Number = 0;

		private var _explicitMinVisibleWidth:Number;

		public function get minVisibleWidth():Number
		{
			if(this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth) //isNaN
			{
				return this._actualMinVisibleWidth;
			}
			return this._explicitMinVisibleWidth;
		}

		public function set minVisibleWidth(value:Number):void
		{
			if(this._explicitMinVisibleWidth == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth) //isNaN
			{
				return;
			}
			var oldValue:Number = this._explicitMinVisibleWidth;
			this._explicitMinVisibleWidth = value;
			if(valueIsNaN)
			{
				this._actualMinVisibleWidth = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this._actualMinVisibleWidth = value;
				if(this._explicitVisibleWidth !== this._explicitVisibleWidth && //isNaN
					(this._actualVisibleWidth < value || this._actualVisibleWidth == oldValue))
				{
					//only invalidate if this change might affect the visibleWidth
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		private var _maxVisibleWidth:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleWidth():Number
		{
			return this._maxVisibleWidth;
		}

		public function set maxVisibleWidth(value:Number):void
		{
			if(this._maxVisibleWidth == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleWidth cannot be NaN");
			}
			var oldValue:Number = this._maxVisibleWidth;
			this._maxVisibleWidth = value;
			if(this._explicitVisibleWidth !== this._explicitVisibleWidth && //isNaN
				(this._actualVisibleWidth > value || this._actualVisibleWidth == oldValue))
			{
				//only invalidate if this change might affect the visibleWidth
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualVisibleWidth:Number = 0;

		private var _explicitVisibleWidth:Number = NaN;

		public function get visibleWidth():Number
		{
			return this._actualVisibleWidth;
		}

		public function set visibleWidth(value:Number):void
		{
			if(this._explicitVisibleWidth == value ||
				(value !== value && this._explicitVisibleWidth !== this._explicitVisibleWidth)) //isNaN
			{
				return;
			}
			this._explicitVisibleWidth = value;
			if(this._actualVisibleWidth != value)
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualMinVisibleHeight:Number = 0;

		private var _explicitMinVisibleHeight:Number;

		public function get minVisibleHeight():Number
		{
			if(this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight) //isNaN
			{
				return this._actualMinVisibleHeight;
			}
			return this._explicitMinVisibleHeight;
		}

		public function set minVisibleHeight(value:Number):void
		{
			if(this._explicitMinVisibleHeight == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight) //isNaN
			{
				return;
			}
			var oldValue:Number = this._explicitMinVisibleHeight;
			this._explicitMinVisibleHeight = value;
			if(valueIsNaN)
			{
				this._actualMinVisibleHeight = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this._actualMinVisibleHeight = value;
				if(this._explicitVisibleHeight !== this._explicitVisibleHeight && //isNaN
					(this._actualVisibleHeight < value || this._actualVisibleHeight == oldValue))
				{
					//only invalidate if this change might affect the visibleHeight
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		private var _maxVisibleHeight:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleHeight():Number
		{
			return this._maxVisibleHeight;
		}

		public function set maxVisibleHeight(value:Number):void
		{
			if(this._maxVisibleHeight == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleHeight cannot be NaN");
			}
			var oldValue:Number = this._maxVisibleHeight;
			this._maxVisibleHeight = value;
			if(this._explicitVisibleHeight !== this._explicitVisibleHeight && //isNaN
				(this._actualVisibleHeight > value || this._actualVisibleHeight == oldValue))
			{
				//only invalidate if this change might affect the visibleHeight
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualVisibleHeight:Number = 0;

		private var _explicitVisibleHeight:Number = NaN;

		public function get visibleHeight():Number
		{
			return this._actualVisibleHeight;
		}

		public function set visibleHeight(value:Number):void
		{
			if(this._explicitVisibleHeight == value ||
				(value !== value && this._explicitVisibleHeight !== this._explicitVisibleHeight)) //isNaN
			{
				return;
			}
			this._explicitVisibleHeight = value;
			if(this._actualVisibleHeight != value)
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		protected var _contentX:Number = 0;

		public function get contentX():Number
		{
			return this._contentX;
		}

		protected var _contentY:Number = 0;

		public function get contentY():Number
		{
			return this._contentY;
		}

		private var _horizontalScrollPosition:Number = 0;

		public function get horizontalScrollPosition():Number
		{
			return this._horizontalScrollPosition;
		}

		public function set horizontalScrollPosition(value:Number):void
		{
			if(this._horizontalScrollPosition == value)
			{
				return;
			}
			this._horizontalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		private var _verticalScrollPosition:Number = 0;

		public function get verticalScrollPosition():Number
		{
			return this._verticalScrollPosition;
		}

		public function set verticalScrollPosition(value:Number):void
		{
			if(this._verticalScrollPosition == value)
			{
				return;
			}
			this._verticalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		public function get horizontalScrollStep():Number
		{
			var rowRenderer:DisplayObject = null;
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			if(virtualLayout === null || !virtualLayout.useVirtualLayout)
			{
				if(this._rows.length > 0)
				{
					rowRenderer = this._rows[0] as DisplayObject;
				}
			}
			if(rowRenderer === null)
			{
				rowRenderer = this._typicalRowRenderer as DisplayObject;
			}
			if(rowRenderer === null)
			{
				return 0;
			}
			var rowRendererWidth:Number = rowRenderer.width;
			var rowRendererHeight:Number = rowRenderer.height;
			if(rowRendererWidth < rowRendererHeight)
			{
				return rowRendererWidth;
			}
			return rowRendererHeight;
		}

		public function get verticalScrollStep():Number
		{
			var rowRenderer:DisplayObject = null;
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			if(virtualLayout === null || !virtualLayout.useVirtualLayout)
			{
				if(this._rows.length > 0)
				{
					rowRenderer = this._rows[0] as DisplayObject;
				}
			}
			if(rowRenderer === null)
			{
				rowRenderer = this._typicalRowRenderer as DisplayObject;
			}
			if(rowRenderer === null)
			{
				return 0;
			}
			var rowRendererWidth:Number = rowRenderer.width;
			var rowRendererHeight:Number = rowRenderer.height;
			if(rowRendererWidth < rowRendererHeight)
			{
				return rowRendererWidth;
			}
			return rowRendererHeight;
		}

		private var _owner:DataGrid = null;

		public function get owner():DataGrid
		{
			return this._owner;
		}

		public function set owner(value:DataGrid):void
		{
			this._owner = value;
		}

		private var _updateForDataReset:Boolean = false;

		private var _dataProvider:IListCollection = null;

		public function get dataProvider():IListCollection
		{
			return this._dataProvider;
		}

		public function set dataProvider(value:IListCollection):void
		{
			if(this._dataProvider == value)
			{
				return;
			}
			if(this._dataProvider)
			{
				this._dataProvider.removeEventListener(Event.CHANGE, dataProvider_changeHandler);
				this._dataProvider.removeEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.removeEventListener(CollectionEventType.FILTER_CHANGE, dataProvider_filterChangeHandler);
				this._dataProvider.removeEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.UPDATE_ITEM, dataProvider_updateItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.UPDATE_ALL, dataProvider_updateAllHandler);
			}
			this._dataProvider = value;
			if(this._dataProvider)
			{
				this._dataProvider.addEventListener(Event.CHANGE, dataProvider_changeHandler);
				this._dataProvider.addEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.addEventListener(CollectionEventType.FILTER_CHANGE, dataProvider_filterChangeHandler);
				this._dataProvider.addEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.UPDATE_ITEM, dataProvider_updateItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.UPDATE_ALL, dataProvider_updateAllHandler);
			}
			if(this._layout is IVariableVirtualLayout)
			{
				IVariableVirtualLayout(this._layout).resetVariableVirtualCache();
			}
			this._updateForDataReset = true;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		protected var _columns:IListCollection = null;

		public function get columns():IListCollection
		{
			return this._columns;
		}

		public function set columns(value:IListCollection):void
		{
			if(this._columns == value)
			{
				return;
			}
			if(this._columns)
			{
				this._columns.removeEventListener(Event.CHANGE, columns_changeHandler);
			}
			this._columns = value;
			if(this._columns)
			{
				this._columns.addEventListener(Event.CHANGE, columns_changeHandler);
			}

			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private var _ignoreLayoutChanges:Boolean = false;
		private var _ignoreRendererResizing:Boolean = false;

		private var _layout:ILayout = null;

		public function get layout():ILayout
		{
			return this._layout;
		}

		public function set layout(value:ILayout):void
		{
			if(this._layout == value)
			{
				return;
			}
			if(this._layout)
			{
				this._layout.removeEventListener(Event.CHANGE, layout_changeHandler);
			}
			this._layout = value;
			if(this._layout)
			{
				if(this._layout is IVariableVirtualLayout)
				{
					IVariableVirtualLayout(this._layout).resetVariableVirtualCache();
				}
				this._layout.addEventListener(Event.CHANGE, layout_changeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		private var _typicalItem:Object = null;

		public function get typicalItem():Object
		{
			return this._typicalItem;
		}

		public function set typicalItem(value:Object):void
		{
			if(this._typicalItem == value)
			{
				return;
			}
			this._typicalItem = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private var _customColumnSizes:Vector.<Number> = null;

		public function get customColumnSizes():Vector.<Number>
		{
			return this._customColumnSizes;
		}

		public function set customColumnSizes(value:Vector.<Number>):void
		{
			if(this._customColumnSizes === value)
			{
				return;
			}
			this._customColumnSizes = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private var _ignoreSelectionChanges:Boolean = false;

		private var _isSelectable:Boolean = true;

		public function get isSelectable():Boolean
		{
			return this._isSelectable;
		}

		public function set isSelectable(value:Boolean):void
		{
			if(this._isSelectable == value)
			{
				return;
			}
			this._isSelectable = value;
			if(!value)
			{
				this.selectedIndices = null;
			}
		}

		private var _allowMultipleSelection:Boolean = false;

		public function get allowMultipleSelection():Boolean
		{
			return this._allowMultipleSelection;
		}

		public function set allowMultipleSelection(value:Boolean):void
		{
			this._allowMultipleSelection = value;
		}

		private var _selectedIndices:ListCollection;

		public function get selectedIndices():ListCollection
		{
			return this._selectedIndices;
		}

		public function set selectedIndices(value:ListCollection):void
		{
			if(this._selectedIndices == value)
			{
				return;
			}
			if(this._selectedIndices)
			{
				this._selectedIndices.removeEventListener(Event.CHANGE, selectedIndices_changeHandler);
			}
			this._selectedIndices = value;
			if(this._selectedIndices)
			{
				this._selectedIndices.addEventListener(Event.CHANGE, selectedIndices_changeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		public function get requiresMeasurementOnScroll():Boolean
		{
			return this._layout.requiresLayoutOnScroll &&
				(this._explicitVisibleWidth !== this._explicitVisibleWidth || //isNaN
				this._explicitVisibleHeight !== this._explicitVisibleHeight); //isNaN
		}

		public function calculateNavigationDestination(index:int, keyCode:uint):int
		{
			return this._layout.calculateNavigationDestination(this._rows, index, keyCode, this._layoutResult);
		}

		public function getScrollPositionForIndex(index:int, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}
			return this._layout.getScrollPositionForIndex(index, this._rows,
				0, 0, this._actualVisibleWidth, this._actualVisibleHeight, result);
		}

		public function getNearestScrollPositionForIndex(index:int, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}
			return this._layout.getNearestScrollPositionForIndex(index,
				this._horizontalScrollPosition, this._verticalScrollPosition,
				this._rows, 0, 0, this._actualVisibleWidth, this._actualVisibleHeight, result);
		}

		public function itemToCellRenderer(item:Object, columnIndex:int):IDataGridCellRenderer
		{
			var rowRenderer:DataGridRowRenderer = this._rowRendererMap[item] as DataGridRowRenderer;
			if(rowRenderer === null)
			{
				return null;
			}
			return rowRenderer.getCellRendererForColumn(columnIndex);
		}

		override public function dispose():void
		{
			this.refreshInactiveRowRenderers(true);
			this.owner = null;
			this.layout = null;
			this.dataProvider = null;
			this.columns = null;
			super.dispose();
		}

		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var scrollInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SCROLL);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var selectionInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SELECTED);
			var rowRendererInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_ROW_RENDERER_FACTORY);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);

			//scrolling only affects the layout is requiresLayoutOnScroll is true
			if(!layoutInvalid && scrollInvalid && this._layout && this._layout.requiresLayoutOnScroll)
			{
				layoutInvalid = true;
			}

			var basicsInvalid:Boolean = sizeInvalid || dataInvalid || layoutInvalid || rowRendererInvalid;

			var oldIgnoreRendererResizing:Boolean = this._ignoreRendererResizing;
			this._ignoreRendererResizing = true;
			var oldIgnoreLayoutChanges:Boolean = this._ignoreLayoutChanges;
			this._ignoreLayoutChanges = true;

			if(scrollInvalid || sizeInvalid)
			{
				this.refreshViewPortBounds();
			}
			if(basicsInvalid)
			{
				this.refreshInactiveRowRenderers(false);
			}
			if(dataInvalid || layoutInvalid || rowRendererInvalid)
			{
				this.refreshLayoutTypicalItem();
			}
			if(basicsInvalid)
			{
				this.refreshRowRenderers();
			}
			if(selectionInvalid || basicsInvalid)
			{
				//unlike resizing renderers and layout changes, we only want to
				//stop listening for selection changes when we're forcibly
				//updating selection. other property changes on item renderers
				//can validly change selection, and we need to detect that.
				var oldIgnoreSelectionChanges:Boolean = this._ignoreSelectionChanges;
				this._ignoreSelectionChanges = true;
				this.refreshSelection();
				this._ignoreSelectionChanges = oldIgnoreSelectionChanges;
			}
			if(stateInvalid || basicsInvalid)
			{
				this.refreshEnabled();
			}
			this._ignoreLayoutChanges = oldIgnoreLayoutChanges;

			if(stateInvalid || selectionInvalid || stylesInvalid || basicsInvalid)
			{
				this._layout.layout(this._rows, this._viewPortBounds, this._layoutResult);
			}

			this._ignoreRendererResizing = oldIgnoreRendererResizing;

			this._contentX = this._layoutResult.contentX;
			this._contentY = this._layoutResult.contentY;
			this.saveMeasurements(this._layoutResult.contentWidth, this._layoutResult.contentHeight,
				this._layoutResult.contentWidth, this._layoutResult.contentHeight);
			this._actualVisibleWidth = this._layoutResult.viewPortWidth;
			this._actualVisibleHeight = this._layoutResult.viewPortHeight;
			this._actualMinVisibleWidth = this._layoutResult.viewPortWidth;
			this._actualMinVisibleHeight = this._layoutResult.viewPortHeight;

			//final validation to avoid juggler next frame issues
			this.validateRowRenderers();
		}

		private function refreshViewPortBounds():void
		{
			var needsMinWidth:Boolean = this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight; //isNaN
			this._viewPortBounds.x = 0;
			this._viewPortBounds.y = 0;
			this._viewPortBounds.scrollX = this._horizontalScrollPosition;
			this._viewPortBounds.scrollY = this._verticalScrollPosition;
			this._viewPortBounds.explicitWidth = this._explicitVisibleWidth;
			this._viewPortBounds.explicitHeight = this._explicitVisibleHeight;
			if(needsMinWidth)
			{
				this._viewPortBounds.minWidth = 0;
			}
			else
			{
				this._viewPortBounds.minWidth = this._explicitMinVisibleWidth;
			}
			if(needsMinHeight)
			{
				this._viewPortBounds.minHeight = 0;
			}
			else
			{
				this._viewPortBounds.minHeight = this._explicitMinVisibleHeight;
			}
			this._viewPortBounds.maxWidth = this._maxVisibleWidth;
			this._viewPortBounds.maxHeight = this._maxVisibleHeight;
		}

		private function refreshInactiveRowRenderers(forceCleanup:Boolean):void
		{
			var temp:Vector.<DataGridRowRenderer> = this._rowStorage.inactiveRowRenderers;
			this._rowStorage.inactiveRowRenderers = this._rowStorage.activeRowRenderers;
			this._rowStorage.activeRowRenderers = temp;
			if(this._rowStorage.activeRowRenderers.length > 0)
			{
				throw new IllegalOperationError("DataGridDataViewPort: active row renderers should be empty.");
			}
			if(forceCleanup)
			{
				this.recoverInactiveRowRenderers();
				this.freeInactiveRowRenderers(0);
				if(this._typicalRowRenderer !== null)
				{
					if(this._typicalRowIsInDataProvider)
					{
						delete this._rowRendererMap[this._typicalRowRenderer.data];
					}
					this.destroyRowRenderer(this._typicalRowRenderer);
					this._typicalRowRenderer = null;
					this._typicalRowIsInDataProvider = false;
				}
			}
			this._rows.length = 0;
		}

		private function recoverInactiveRowRenderers():void
		{
			var inactiveRowRenderers:Vector.<DataGridRowRenderer> = this._rowStorage.inactiveRowRenderers;
			var itemCount:int = inactiveRowRenderers.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var rowRenderer:DataGridRowRenderer = inactiveRowRenderers[i];
				if(rowRenderer === null || rowRenderer.data === null)
				{
					continue;
				}
				this._owner.dispatchEventWith(FeathersEventType.RENDERER_REMOVE, false, rowRenderer);
				delete this._rowRendererMap[rowRenderer.data];
			}
		}

		private function freeInactiveRowRenderers(minimumItemCount:int):void
		{
			var inactiveRowRenderers:Vector.<DataGridRowRenderer> = this._rowStorage.inactiveRowRenderers;
			var activeRowRenderers:Vector.<DataGridRowRenderer> = this._rowStorage.activeRowRenderers;
			var activeRowRenderersCount:int = activeRowRenderers.length;

			//we may keep around some extra renderers to avoid too much
			//allocation and garbage collection. they'll be hidden.
			var itemCount:int = inactiveRowRenderers.length;
			var keepCount:int = minimumItemCount - activeRowRenderersCount;
			if(keepCount > itemCount)
			{
				keepCount = itemCount;
			}
			for(var i:int = 0; i < keepCount; i++)
			{
				var rowRenderer:DataGridRowRenderer = inactiveRowRenderers.shift();
				if(rowRenderer === null)
				{
					keepCount++;
					if(itemCount < keepCount)
					{
						keepCount = itemCount;
					}
					continue;
				}
				rowRenderer.data = null;
				rowRenderer.columns = null;
				rowRenderer.index = -1;
				rowRenderer.visible = false;
				rowRenderer.customColumnSizes = null;
				activeRowRenderers[activeRowRenderersCount] = rowRenderer;
				activeRowRenderersCount++;
			}
			itemCount -= keepCount;
			for(i = 0; i < itemCount; i++)
			{
				rowRenderer = inactiveRowRenderers.shift();
				if(rowRenderer === null)
				{
					continue;
				}
				this.destroyRowRenderer(rowRenderer);
			}
		}

		private function createRowRenderer(item:Object, rowIndex:int, useCache:Boolean, isTemporary:Boolean):DataGridRowRenderer
		{
			var inactiveRowRenderers:Vector.<DataGridRowRenderer> = this._rowStorage.inactiveRowRenderers;
			var activeRowRenderers:Vector.<DataGridRowRenderer> = this._rowStorage.activeRowRenderers;
			var rowRenderer:DataGridRowRenderer = null;
			do
			{
				if(!useCache || isTemporary || inactiveRowRenderers.length == 0)
				{
					rowRenderer = new DataGridRowRenderer();
					this.addChild(DisplayObject(rowRenderer));
				}
				else
				{
					rowRenderer = inactiveRowRenderers.shift();
				}
				//wondering why this all is in a loop?
				//_inactiveRenderers.shift() may return null because we're
				//storing null values instead of calling splice() to improve
				//performance.
			}
			while(rowRenderer === null);
			rowRenderer.data = item;
			rowRenderer.columns = this._columns;
			rowRenderer.index = rowIndex;
			rowRenderer.owner = this._owner;
			rowRenderer.customColumnSizes = this._customColumnSizes;

			if(!isTemporary)
			{
				this._rowRendererMap[item] = rowRenderer;
				activeRowRenderers[activeRowRenderers.length] = rowRenderer;
				rowRenderer.addEventListener(Event.TRIGGERED, rowRenderer_triggeredHandler);
				rowRenderer.addEventListener(Event.CHANGE, rowRenderer_changeHandler);
				rowRenderer.addEventListener(FeathersEventType.RESIZE, rowRenderer_resizeHandler);
				this._owner.dispatchEventWith(FeathersEventType.RENDERER_ADD, false, rowRenderer);
			}

			return rowRenderer;
		}

		private function destroyRowRenderer(rowRenderer:DataGridRowRenderer):void
		{
			rowRenderer.removeEventListener(Event.TRIGGERED, rowRenderer_triggeredHandler);
			rowRenderer.removeEventListener(Event.CHANGE, rowRenderer_changeHandler);
			rowRenderer.removeEventListener(FeathersEventType.RESIZE, rowRenderer_resizeHandler);
			rowRenderer.data = null;
			rowRenderer.columns = null;
			rowRenderer.index = -1;
			this.removeChild(DisplayObject(rowRenderer), true);
			rowRenderer.owner = null;
		}

		private function refreshLayoutTypicalItem():void
		{
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			if(virtualLayout === null || !virtualLayout.useVirtualLayout)
			{
				//the old layout was virtual, but this one isn't
				if(!this._typicalRowIsInDataProvider && this._typicalRowRenderer !== null)
				{
					//it's safe to destroy this renderer
					this.destroyRowRenderer(this._typicalRowRenderer);
					this._typicalRowRenderer = null;
				}
				return;
			}
			var typicalItemIndex:int = 0;
			var newTypicalItemIsInDataProvider:Boolean = false;
			var typicalItem:Object = this._typicalItem;
			if(typicalItem !== null)
			{
				if(this._dataProvider !== null)
				{
					typicalItemIndex = this._dataProvider.getItemIndex(typicalItem);
					newTypicalItemIsInDataProvider = typicalItemIndex >= 0;
				}
				if(typicalItemIndex < 0)
				{
					typicalItemIndex = 0;
				}
			}
			else
			{
				if(this._dataProvider !== null && this._dataProvider.length > 0)
				{
					newTypicalItemIsInDataProvider = true;
					typicalItem = this._dataProvider.getItemAt(0);
				}
			}

			//#1645 The typicalItem can be null if the data provider contains
			//a null value at index 0. this is the only time we allow null.
			if(typicalItem !== null || newTypicalItemIsInDataProvider)
			{
				var typicalRenderer:DataGridRowRenderer = this._rowRendererMap[typicalItem] as DataGridRowRenderer;
				if(typicalRenderer !== null)
				{
					//at this point, the item already has a row renderer.
					//(this doesn't necessarily mean that the current typical
					//item was the typical item last time this function was
					//called)

					//the index may have changed if items were added, removed or
					//reordered in the data provider
					typicalRenderer.index = typicalItemIndex;
				}
				if(typicalRenderer === null && this._typicalRowRenderer !== null)
				{
					//the typical item has changed, and doesn't have a row
					//renderer yet. the previous typical item had a row
					//renderer, so we will try to reuse it.

					//we can reuse the existing typical row renderer if the old
					//typical item wasn't in the data provider. otherwise, it
					//may still be needed for the same item.
					var canReuse:Boolean = !this._typicalRowIsInDataProvider;
					var oldTypicalItemRemoved:Boolean = this._typicalRowIsInDataProvider &&
						this._dataProvider && this._dataProvider.getItemIndex(this._typicalRowRenderer.data) < 0;
					if(!canReuse && oldTypicalItemRemoved)
					{
						//special case: if the old typical item was in the data
						//provider, but it has been removed, it's safe to reuse.
						canReuse = true;
					}
					if(canReuse)
					{
						//we can reuse the item renderer used for the old
						//typical item!

						//if the old typical item was in the data provider,
						//remove it from the renderer map.
						if(this._typicalRowIsInDataProvider)
						{
							delete this._rowRendererMap[this._typicalRowRenderer.data];
						}
						typicalRenderer = this._typicalRowRenderer;
						typicalRenderer.data = typicalItem;
						typicalRenderer.index = typicalItemIndex;
						//if the new typical item is in the data provider, add it
						//to the renderer map.
						if(newTypicalItemIsInDataProvider)
						{
							this._rowRendererMap[typicalItem] = typicalRenderer;
						}
					}
				}
				if(typicalRenderer === null)
				{
					//if we still don't have a typical row renderer, we need to
					//create a new one.
					typicalRenderer = this.createRowRenderer(typicalItem, typicalItemIndex, false, !newTypicalItemIsInDataProvider);
					if(!this._typicalRowIsInDataProvider && this._typicalRowRenderer !== null)
					{
						//get rid of the old typical row renderer if it isn't
						//needed anymore.  since it was not in the data
						//provider, we don't need to mess with the renderer map
						//dictionary or dispatch any events.
						this.destroyRowRenderer(this._typicalRowRenderer);
						this._typicalRowRenderer = null;
					}
				}
			}

			virtualLayout.typicalItem = DisplayObject(typicalRenderer);
			this._typicalRowRenderer = typicalRenderer;
			this._typicalRowIsInDataProvider = newTypicalItemIsInDataProvider;
			if(this._typicalRowRenderer !== null && !this._typicalRowIsInDataProvider)
			{
				//we need to know if this item renderer resizes to adjust the
				//layout because the layout may use this item renderer to resize
				//the other item renderers
				this._typicalRowRenderer.addEventListener(FeathersEventType.RESIZE, rowRenderer_resizeHandler);
			}
		}

		private function refreshRowRenderers():void
		{
			if(this._typicalRowRenderer !== null && this._typicalRowIsInDataProvider)
			{
				var inactiveRowRenderers:Vector.<DataGridRowRenderer> = this._rowStorage.inactiveRowRenderers;
				var activeRowRenderers:Vector.<DataGridRowRenderer> = this._rowStorage.activeRowRenderers;
				//this renderer is already is use by the typical item, so we
				//don't want to allow it to be used by other items.
				var inactiveIndex:int = inactiveRowRenderers.indexOf(this._typicalRowRenderer);
				if(inactiveIndex >= 0)
				{
					inactiveRowRenderers[inactiveIndex] = null;
				}
				//if refreshLayoutTypicalItem() was called, it will have already
				//added the typical row renderer to the active renderers. if
				//not, we need to do it here.
				var activeRendererCount:int = activeRowRenderers.length;
				if(activeRendererCount == 0)
				{
					activeRowRenderers[activeRendererCount] = this._typicalRowRenderer;
				}
			}

			this.findUnrenderedRowData();
			this.recoverInactiveRowRenderers();
			this.renderUnrenderedRowData();
			this.freeInactiveRowRenderers(this._minimumRowCount);
		}

		private function findUnrenderedRowData():void
		{
			var itemCount:int = 0;
			if(this._dataProvider !== null)
			{
				itemCount = this._dataProvider.length;
			}
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			var useVirtualLayout:Boolean = virtualLayout && virtualLayout.useVirtualLayout;
			if(useVirtualLayout)
			{
				var point:Point = Pool.getPoint();
				virtualLayout.measureViewPort(itemCount, this._viewPortBounds, point);
				virtualLayout.getVisibleIndicesAtScrollPosition(this._horizontalScrollPosition, this._verticalScrollPosition, point.x, point.y, itemCount, HELPER_VECTOR);
				Pool.putPoint(point);
			}

			this._rows.length = itemCount;

			var unrenderedItemCount:int = itemCount;
			if(useVirtualLayout)
			{
				unrenderedItemCount = HELPER_VECTOR.length;
			}
			if(useVirtualLayout && this._typicalRowIsInDataProvider && this._typicalRowRenderer &&
				HELPER_VECTOR.indexOf(this._typicalRowRenderer.index) >= 0)
			{
				//add an extra item renderer if the typical item is from the
				//data provider and it is visible. this helps keep the number of
				//item renderers constant!
				this._minimumRowCount = unrenderedItemCount + 1;
			}
			else
			{
				this._minimumRowCount = unrenderedItemCount;
			}

			var unrenderedDataLastIndex:int = this._unrenderedRows.length;
			for(var i:int = 0; i < unrenderedItemCount; i++)
			{
				var index:int = i;
				if(useVirtualLayout)
				{
					index = HELPER_VECTOR[i];
				}
				if(index < 0 || index >= itemCount)
				{
					continue;
				}
				var item:Object = this._dataProvider.getItemAt(index);
				var rowRenderer:DataGridRowRenderer = this._rowRendererMap[item] as DataGridRowRenderer;
				if(rowRenderer !== null)
				{
					//the index may have changed if items were added, removed or
					//reordered in the data provider
					rowRenderer.index = index;
					//if this row renderer used to be the typical row
					//renderer, but it isn't anymore, it may have been set invisible!
					rowRenderer.visible = true;
					rowRenderer.customColumnSizes = this._customColumnSizes;
					if(this._updateForDataReset)
					{
						//similar to calling updateItemAt(), replacing the data
						//provider or resetting its source means that we should
						//trick the item renderer into thinking it has new data.
						//many developers seem to expect this behavior, so while
						//it's not the most optimal for performance, it saves on
						//support time in the forums. thankfully, it's still
						//somewhat optimized since the same item renderer will
						//receive the same data, and the children generally
						//won't have changed much, if at all.
						rowRenderer.data = null;
						rowRenderer.data = item;
					}

					//the typical row renderer is a special case, and we will
					//have already put it into the active renderers, so we don't
					//want to do it again!
					if(this._typicalRowRenderer !== rowRenderer)
					{
						var activeRowRenderers:Vector.<DataGridRowRenderer> = this._rowStorage.activeRowRenderers;
						var inactiveRowRenderers:Vector.<DataGridRowRenderer> = this._rowStorage.inactiveRowRenderers;
						activeRowRenderers[activeRowRenderers.length] = rowRenderer;
						var inactiveIndex:int = inactiveRowRenderers.indexOf(rowRenderer);
						if(inactiveIndex >= 0)
						{
							inactiveRowRenderers[inactiveIndex] = null;
						}
						else
						{
							throw new IllegalOperationError("DataGridDataViewPort: row renderer map contains bad data. This may be caused by duplicate items in the data provider, which is not allowed.");
						}
					}
					this._rows[index] = DisplayObject(rowRenderer);
				}
				else
				{
					this._unrenderedRows[unrenderedDataLastIndex] = index;
					unrenderedDataLastIndex++;
				}
			}
			//update the typical row renderer's visibility
			if(this._typicalRowRenderer !== null)
			{
				if(useVirtualLayout && this._typicalRowIsInDataProvider)
				{
					index = HELPER_VECTOR.indexOf(this._typicalRowRenderer.index);
					if(index >= 0)
					{
						this._typicalRowRenderer.visible = true;
					}
					else
					{
						this._typicalRowRenderer.visible = false;

						//uncomment these lines to see a hidden typical row for
						//debugging purposes...
						/*this._typicalRowRenderer.visible = true;
						this._typicalRowRenderer.x = this._horizontalScrollPosition;
						this._typicalRowRenderer.y = this._verticalScrollPosition;*/
					}
				}
				else
				{
					this._typicalRowRenderer.visible = this._typicalRowIsInDataProvider;
				}
			}
			HELPER_VECTOR.length = 0;
		}

		private function renderUnrenderedRowData():void
		{
			var rowRendererCount:int = this._unrenderedRows.length;
			for(var i:int = 0; i < rowRendererCount; i++)
			{
				var rowIndex:int = this._unrenderedRows.shift();
				var item:Object = this._dataProvider.getItemAt(rowIndex);
				var rowRenderer:DataGridRowRenderer = this.createRowRenderer(
					item, rowIndex, true, false);
				rowRenderer.visible = true;
				this._rows[rowIndex] = DisplayObject(rowRenderer);
			}
		}

		private function refreshSelection():void
		{
			var itemCount:int = this._rows.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var rowRenderer:DataGridRowRenderer = this._rows[i] as DataGridRowRenderer;
				if(rowRenderer !== null)
				{
					rowRenderer.isSelected = this._selectedIndices.getItemIndex(rowRenderer.index) >= 0;
				}
			}
		}

		private function refreshEnabled():void
		{
			var itemCount:int = this._rows.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var control:IFeathersControl = this._rows[i] as IFeathersControl;
				if(control !== null)
				{
					control.isEnabled = this._isEnabled;
				}
			}
		}

		private function validateRowRenderers():void
		{
			var itemCount:int = this._rows.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:IValidating = this._rows[i] as IValidating;
				if(item !== null)
				{
					item.validate();
				}
			}
		}

		private function invalidateParent(flag:String = INVALIDATION_FLAG_ALL):void
		{
			Scroller(this.parent).invalidate(flag);
		}

		private function columns_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private function dataProvider_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private function dataProvider_addItemHandler(event:Event, index:int):void
		{
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			layout.addToVariableVirtualCacheAtIndex(index);
		}

		private function dataProvider_removeItemHandler(event:Event, index:int):void
		{
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			layout.removeFromVariableVirtualCacheAtIndex(index);
		}

		private function dataProvider_replaceItemHandler(event:Event, index:int):void
		{
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			layout.resetVariableVirtualCacheAtIndex(index);
		}

		private function dataProvider_resetHandler(event:Event):void
		{
			this._updateForDataReset = true;

			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			layout.resetVariableVirtualCache();
		}

		private function dataProvider_filterChangeHandler(event:Event):void
		{
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			//we don't know exactly which indices have changed, so reset the
			//whole cache.
			layout.resetVariableVirtualCache();
		}

		private function dataProvider_updateItemHandler(event:Event, index:int):void
		{
			var item:Object = this._dataProvider.getItemAt(index);
			var rowRenderer:DataGridRowRenderer = this._rowRendererMap[item] as DataGridRowRenderer;
			if(rowRenderer === null)
			{
				return;
			}
			//in order to display the same item with modified properties, this
			//hack tricks the item renderer into thinking that it has been given
			//a different item to render.
			rowRenderer.data = null;
			rowRenderer.data = item;
			if(this._explicitVisibleWidth !== this._explicitVisibleWidth || //isNaN
				this._explicitVisibleHeight !== this._explicitVisibleHeight) //isNaN
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
				this.invalidateParent(INVALIDATION_FLAG_SIZE);
			}
		}

		private function dataProvider_updateAllHandler(event:Event):void
		{
			//we're treating this similar to the RESET event because enough
			//users are treating UPDATE_ALL similarly. technically, UPDATE_ALL
			//is supposed to affect only existing items, but it's confusing when
			//new items are added and not displayed.
			this._updateForDataReset = true;
			this.invalidate(INVALIDATION_FLAG_DATA);

			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			layout.resetVariableVirtualCache();
		}

		private function rowRenderer_triggeredHandler(event:Event):void
		{
			var rowRenderer:DataGridRowRenderer = DataGridRowRenderer(event.currentTarget);
			this.parent.dispatchEventWith(Event.TRIGGERED, false, rowRenderer.data);
		}

		private function rowRenderer_changeHandler(event:Event):void
		{
			if(this._ignoreSelectionChanges)
			{
				return;
			}
			var rowRenderer:DataGridRowRenderer = DataGridRowRenderer(event.currentTarget);
			if(!this._isSelectable || this._owner.isScrolling)
			{
				rowRenderer.isSelected = false;
				return;
			}
			var isSelected:Boolean = rowRenderer.isSelected;
			var index:int = rowRenderer.index;
			if(this._allowMultipleSelection)
			{
				var indexOfIndex:int = this._selectedIndices.getItemIndex(index);
				if(isSelected && indexOfIndex < 0)
				{
					this._selectedIndices.addItem(index);
				}
				else if(!isSelected && indexOfIndex >= 0)
				{
					this._selectedIndices.removeItemAt(indexOfIndex);
				}
			}
			else if(isSelected)
			{
				this._selectedIndices.data = new <int>[index];
			}
			else
			{
				this._selectedIndices.removeAll();
			}
		}

		private function rowRenderer_resizeHandler(event:Event):void
		{
			if(this._ignoreRendererResizing)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
			this.invalidateParent(INVALIDATION_FLAG_LAYOUT);
			if(event.currentTarget === this._typicalRowRenderer && !this._typicalRowIsInDataProvider)
			{
				return;
			}
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			var rowRenderer:DataGridRowRenderer = DataGridRowRenderer(event.currentTarget);
			layout.resetVariableVirtualCacheAtIndex(rowRenderer.index, DisplayObject(rowRenderer));
		}

		private function layout_changeHandler(event:Event):void
		{
			if(this._ignoreLayoutChanges)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
			this.invalidateParent(INVALIDATION_FLAG_LAYOUT);
		}

		private function selectedIndices_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}
	}
}

import feathers.controls.supportClasses.DataGridRowRenderer;

class RowRendererFactoryStorage
{
	public function RowRendererFactoryStorage()
	{

	}

	public var activeRowRenderers:Vector.<DataGridRowRenderer> = new <DataGridRowRenderer>[];
	public var inactiveRowRenderers:Vector.<DataGridRowRenderer> = new <DataGridRowRenderer>[];
}

================================================
FILE: source/feathers/controls/supportClasses/DataGridRowRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.supportClasses
{
	import feathers.controls.DataGrid;
	import feathers.controls.DataGridColumn;
	import feathers.controls.LayoutGroup;
	import feathers.controls.renderers.DefaultDataGridCellRenderer;
	import feathers.controls.renderers.IDataGridCellRenderer;
	import feathers.core.IToggle;
	import feathers.data.IListCollection;
	import feathers.events.CollectionEventType;
	import feathers.events.FeathersEventType;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.HorizontalLayoutData;
	import feathers.layout.VerticalAlign;
	import feathers.utils.touch.TapToSelect;
	import feathers.utils.touch.TapToTrigger;

	import flash.errors.IllegalOperationError;
	import flash.utils.Dictionary;

	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * @private
	 * Used internally by DataGrid. Not meant to be used on its own.
	 *
	 * @see feathers.controls.DataGrid
	 *
	 * @productversion Feathers 3.4.0
	 */
	public class DataGridRowRenderer extends LayoutGroup implements IToggle
	{
		/**
		 * @private
		 */
		protected static function defaultCellRendererFactory():IDataGridCellRenderer
		{
			return new DefaultDataGridCellRenderer();
		}

		/**
		 * Constructor.
		 */
		public function DataGridRowRenderer()
		{
			super();
		}

		/**
		 * @private
		 */
		protected var _tapToTrigger:TapToTrigger = null;

		/**
		 * @private
		 */
		protected var _tapToSelect:TapToSelect = null;

		/**
		 * @private
		 */
		protected var _unrenderedData:Vector.<int> = new <int>[];

		/**
		 * @private
		 */
		protected var _cellRendererMap:Dictionary = new Dictionary(true);

		/**
		 * @private
		 */
		protected var _defaultStorage:CellRendererFactoryStorage = new CellRendererFactoryStorage();

		/**
		 * @private
		 */
		protected var _additionalStorage:Vector.<CellRendererFactoryStorage> = null;

		/**
		 * @private
		 */
		protected var _index:int = -1;

		/**
		 * The index (numeric position, starting from zero) of the item within
		 * the data grid's dat provider.
		 *
		 * <p>This property is set by the data grid, and should not be set manually.</p>
		 */
		public function get index():int
		{
			return this._index;
		}

		/**
		 * @private
		 */
		public function set index(value:int):void
		{
			if(this._index == value)
			{
				return;
			}
			this._index = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _owner:DataGrid = null;

		/**
		 * The <code>DataGrid</code> component that owns this row renderer.
		 *
		 * <p>This property is set by the data grid, and should not be set manually.</p>
		 */
		public function get owner():DataGrid
		{
			return this._owner;
		}

		/**
		 * @private
		 */
		public function set owner(value:DataGrid):void
		{
			if(this._owner === value)
			{
				return;
			}
			this._owner = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _data:Object = null;

		/**
		 * The item from the data provider that is rendered by this row.
		 *
		 * <p>This property is set by the data grid, and should not be set manually.</p>
		 */
		public function get data():Object
		{
			return this._data;
		}

		/**
		 * @private
		 */
		public function set data(value:Object):void
		{
			if(this._data === value)
			{
				return;
			}
			this._data = value;
			if(value === null)
			{
				//ensure that the data property of each cell renderer
				//is set to null before being set to any new value
				this._updateForDataReset = true;
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _updateForDataReset:Boolean = false;

		/**
		 * @private
		 */
		protected var _columns:IListCollection = null;

		/**
		 * The columns from the data grid.
		 *
		 * <p>This property is set by the data grid, and should not be set manually.</p>
		 */
		public function get columns():IListCollection
		{
			return this._columns;
		}

		/**
		 * @private
		 */
		public function set columns(value:IListCollection):void
		{
			if(this._columns === value)
			{
				return;
			}
			if(this._columns !== null)
			{
				this._columns.removeEventListener(Event.CHANGE, columns_changeHandler);
				this._columns.removeEventListener(CollectionEventType.RESET, columns_resetHandler);
				this._columns.removeEventListener(CollectionEventType.UPDATE_ALL, columns_updateAllHandler);
			}
			this._columns = value;
			if(this._columns !== null)
			{
				this._columns.addEventListener(Event.CHANGE, columns_changeHandler);
				this._columns.addEventListener(CollectionEventType.RESET, columns_resetHandler);
				this._columns.addEventListener(CollectionEventType.UPDATE_ALL, columns_updateAllHandler);
			}
			this._updateForDataReset = true;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _isSelected:Boolean;

		/**
		 * Indicates if the row is selected or not.
		 *
		 * <p>This property is set by the data grid, and should not be set manually.</p>
		 */
		public function get isSelected():Boolean
		{
			return this._isSelected;
		}

		/**
		 * @private
		 */
		public function set isSelected(value:Boolean):void
		{
			if(this._isSelected === value)
			{
				return;
			}
			this._isSelected = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		private var _customColumnSizes:Vector.<Number> = null;

		/**
		 * @private
		 */
		public function get customColumnSizes():Vector.<Number>
		{
			return this._customColumnSizes;
		}

		/**
		 * @private
		 */
		public function set customColumnSizes(value:Vector.<Number>):void
		{
			if(this._customColumnSizes === value)
			{
				return;
			}
			this._customColumnSizes = value;
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		/**
		 * Returns the cell renderer for the specified column index, or
		 * <code>null</code>, if no cell renderer can be found.
		 */
		public function getCellRendererForColumn(columnIndex:int):IDataGridCellRenderer
		{
			var column:DataGridColumn = DataGridColumn(this._columns.getItemAt(columnIndex));
			var storage:CellRendererFactoryStorage = this.factoryToStorage(column.cellRendererFactory);
			var activeCellRenderers:Vector.<IDataGridCellRenderer> = storage.activeCellRenderers;
			if(columnIndex < 0 || columnIndex > activeCellRenderers.length)
			{
				return null;
			}
			return IDataGridCellRenderer(activeCellRenderers[columnIndex]);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.refreshInactiveCellRenderers(this._defaultStorage, true);
			if(this._additionalStorage !== null)
			{
				var storageCount:int = this._additionalStorage.length;
				for(var i:int = 0; i < storageCount; i++)
				{
					var storage:CellRendererFactoryStorage = this._additionalStorage[i];
					this.refreshInactiveCellRenderers(storage, true);
				}
			}
			this.owner = null;
			this.data = null;
			this.columns = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			super.initialize();

			if(this._layout === null)
			{
				var layout:HorizontalLayout = new HorizontalLayout();
				layout.verticalAlign = VerticalAlign.MIDDLE;
				layout.useVirtualLayout = false;
				this._layout = layout;
			}

			if(this._tapToTrigger === null)
			{
				this._tapToTrigger = new TapToTrigger(this);
			}

			if(this._tapToSelect === null)
			{
				this._tapToSelect = new TapToSelect(this);
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var oldIgnoreChildChanges:Boolean = this._ignoreChildChanges;
			this._ignoreChildChanges = true;
			this.preLayout();
			this._ignoreChildChanges = oldIgnoreChildChanges;

			this.refreshSelectionEvents();

			super.draw();
		}

		/**
		 * @private
		 */
		protected function preLayout():void
		{
			this.refreshInactiveCellRenderers(this._defaultStorage, false);
			if(this._additionalStorage !== null)
			{
				var storageCount:int = this._additionalStorage.length;
				for(var i:int = 0; i < storageCount; i++)
				{
					var storage:CellRendererFactoryStorage = this._additionalStorage[i];
					this.refreshInactiveCellRenderers(storage, false);
				}
			}
			this.findUnrenderedData();
			this.recoverInactiveCellRenderers(this._defaultStorage);
			if(this._additionalStorage !== null)
			{
				storageCount = this._additionalStorage.length;
				for(i = 0; i < storageCount; i++)
				{
					storage = this._additionalStorage[i];
					this.recoverInactiveCellRenderers(storage);
				}
			}
			this.renderUnrenderedData();
			this.freeInactiveCellRenderers(this._defaultStorage);
			if(this._additionalStorage !== null)
			{
				storageCount = this._additionalStorage.length;
				for(i = 0; i < storageCount; i++)
				{
					storage = this._additionalStorage[i];
					this.freeInactiveCellRenderers(storage);
				}
			}
			
			this._updateForDataReset = false;
		}

		/**
		 * @private
		 */
		protected function refreshSelectionEvents():void
		{
			this._tapToSelect.isEnabled = this._isEnabled;
			this._tapToSelect.tapToDeselect = this._owner.allowMultipleSelection;
		}

		/**
		 * @private
		 */
		protected function createCellRenderer(columnIndex:int, column:DataGridColumn):IDataGridCellRenderer
		{
			var cellRenderer:IDataGridCellRenderer = null;
			var storage:CellRendererFactoryStorage = this.factoryToStorage(column.cellRendererFactory);
			var activeCellRenderers:Vector.<IDataGridCellRenderer> = storage.activeCellRenderers;
			var inactiveCellRenderers:Vector.<IDataGridCellRenderer> = storage.inactiveCellRenderers;
			do
			{
				if(inactiveCellRenderers.length == 0)
				{
					var cellRendererFactory:Function = column.cellRendererFactory;
					if(cellRendererFactory === null)
					{
						cellRendererFactory = this._owner.cellRendererFactory;
					}
					if(cellRendererFactory === null)
					{
						cellRendererFactory = defaultCellRendererFactory;
					}
					cellRenderer = IDataGridCellRenderer(cellRendererFactory());
					var customCellRendererStyleName:String = column.customCellRendererStyleName;
					if(customCellRendererStyleName === null)
					{
						customCellRendererStyleName = this._owner.customCellRendererStyleName;
					}
					if(customCellRendererStyleName !== null && customCellRendererStyleName.length > 0)
					{
						cellRenderer.styleNameList.add(customCellRendererStyleName);
					}
					this.addChildAt(DisplayObject(cellRenderer), columnIndex);
				}
				else
				{
					cellRenderer = inactiveCellRenderers.shift();
				}
				//wondering why this all is in a loop?
				//_inactiveRenderers.shift() may return null because we're
				//storing null values instead of calling splice() to improve
				//performance.
			}
			while(cellRenderer === null);
			this.refreshCellRendererProperties(cellRenderer, columnIndex, column);

			column.addEventListener(Event.CHANGE, column_changeHandler);

			this._cellRendererMap[column] = cellRenderer;
			activeCellRenderers[activeCellRenderers.length] = cellRenderer;
			this._owner.dispatchEventWith(FeathersEventType.RENDERER_ADD, false, cellRenderer);

			return cellRenderer;
		}

		/**
		 * @private
		 */
		protected function destroyCellRenderer(cellRenderer:IDataGridCellRenderer):void
		{
			if(cellRenderer.column !== null)
			{
				cellRenderer.column.removeEventListener(Event.CHANGE, column_changeHandler);
			}
			cellRenderer.data = null;
			cellRenderer.owner = null;
			cellRenderer.rowIndex = -1;
			cellRenderer.columnIndex = -1;
			this.removeChild(DisplayObject(cellRenderer), true);
		}

		/**
		 * @private
		 */
		protected function factoryToStorage(factory:Function):CellRendererFactoryStorage
		{
			if(factory !== null)
			{
				if(this._additionalStorage === null)
				{
					this._additionalStorage = new <CellRendererFactoryStorage>[];
				}
				var storageCount:int = this._additionalStorage.length;
				for(var i:int = 0; i < storageCount; i++)
				{
					var storage:CellRendererFactoryStorage = this._additionalStorage[i];
					if(storage.factory === factory)
					{
						return storage;
					}
				}
				storage = new CellRendererFactoryStorage(factory);
				this._additionalStorage[this._additionalStorage.length] = storage;
				return storage;
			}
			return this._defaultStorage;
		}

		/**
		 * @private
		 */
		protected function refreshInactiveCellRenderers(storage:CellRendererFactoryStorage, forceCleanup:Boolean):void
		{
			var temp:Vector.<IDataGridCellRenderer> = storage.inactiveCellRenderers;
			storage.inactiveCellRenderers = storage.activeCellRenderers;
			storage.activeCellRenderers = temp;
			if(storage.activeCellRenderers.length > 0)
			{
				throw new IllegalOperationError("DataGridRowRenderer: active cell renderers should be empty.");
			}
			if(forceCleanup)
			{
				this.recoverInactiveCellRenderers(storage);
				this.freeInactiveCellRenderers(storage);
			}
		}

		/**
		 * @private
		 */
		protected function findUnrenderedData():void
		{
			var columns:IListCollection = this._owner.columns;
			var columnCount:int = columns.length;
			var unrenderedDataLastIndex:int = this._unrenderedData.length;
			for(var i:int = 0; i < columnCount; i++)
			{
				if(i < 0 || i >= columnCount)
				{
					continue;
				}
				var column:DataGridColumn = DataGridColumn(columns.getItemAt(i));
				var cellRenderer:IDataGridCellRenderer = this._cellRendererMap[column] as IDataGridCellRenderer;
				if(cellRenderer !== null)
				{
					//the properties may have changed if items were added, removed or
					//reordered in the data provider
					this.refreshCellRendererProperties(cellRenderer, i, column);

					var storage:CellRendererFactoryStorage = this.factoryToStorage(column.cellRendererFactory);
					var activeCellRenderers:Vector.<IDataGridCellRenderer> = storage.activeCellRenderers;
					var inactiveCellRenderers:Vector.<IDataGridCellRenderer> = storage.inactiveCellRenderers;

					activeCellRenderers[activeCellRenderers.length] = cellRenderer;
					var inactiveIndex:int = inactiveCellRenderers.indexOf(cellRenderer);
					if(inactiveIndex >= 0)
					{
						inactiveCellRenderers[inactiveIndex] = null;
					}
					else
					{
						throw new IllegalOperationError("DataGridRowRenderer: cell renderer map contains bad data. This may be caused by duplicate items in the data provider, which is not allowed.");
					}
				}
				else
				{
					this._unrenderedData[unrenderedDataLastIndex] = i;
					unrenderedDataLastIndex++;
				}
			}
		}

		/**
		 * @private
		 */
		protected function recoverInactiveCellRenderers(storage:CellRendererFactoryStorage):void
		{
			var inactiveCellRenderers:Vector.<IDataGridCellRenderer> = storage.inactiveCellRenderers;
			var itemCount:int = inactiveCellRenderers.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var cellRenderer:IDataGridCellRenderer = inactiveCellRenderers[i];
				if(cellRenderer === null || cellRenderer.column === null)
				{
					continue;
				}
				this._owner.dispatchEventWith(FeathersEventType.RENDERER_REMOVE, false, cellRenderer);
				delete this._cellRendererMap[cellRenderer.column];
			}
		}

		/**
		 * @private
		 */
		protected function renderUnrenderedData():void
		{
			var columns:IListCollection = this._owner.columns;
			var cellRendererCount:int = this._unrenderedData.length;
			for(var i:int = 0; i < cellRendererCount; i++)
			{
				var columnIndex:int = this._unrenderedData.shift();
				var column:DataGridColumn = DataGridColumn(columns.getItemAt(i));
				var cellRenderer:IDataGridCellRenderer = this.createCellRenderer(columnIndex, column);
			}
		}

		/**
		 * @private
		 */
		protected function freeInactiveCellRenderers(storage:CellRendererFactoryStorage):void
		{
			var activeCellRenderers:Vector.<IDataGridCellRenderer> = storage.activeCellRenderers;
			var inactiveCellRenderers:Vector.<IDataGridCellRenderer> = storage.inactiveCellRenderers;
			var activeCellRenderersCount:int = activeCellRenderers.length;
			var itemCount:int = inactiveCellRenderers.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var cellRenderer:IDataGridCellRenderer = inactiveCellRenderers.shift();
				if(cellRenderer === null)
				{
					continue;
				}
				this.destroyCellRenderer(cellRenderer);
			}
		}

		/**
		 * @private
		 */
		protected function refreshCellRendererProperties(cellRenderer:IDataGridCellRenderer, columnIndex:int, column:DataGridColumn):void
		{
			if(this._updateForDataReset)
			{
				//similar to calling updateItemAt(), replacing the data
				//provider or resetting its source means that we should
				//trick the item renderer into thinking it has new data.
				//many developers seem to expect this behavior, so while
				//it's not the most optimal for performance, it saves on
				//support time in the forums. thankfully, it's still
				//somewhat optimized since the same item renderer will
				//receive the same data, and the children generally
				//won't have changed much, if at all.
				cellRenderer.data = null;
				cellRenderer.column = null;
			}
			cellRenderer.owner = this._owner;
			cellRenderer.data = this._data;
			cellRenderer.rowIndex = this._index;
			cellRenderer.column = column;
			cellRenderer.columnIndex = columnIndex;
			cellRenderer.isSelected = this._isSelected;
			cellRenderer.dataField = column.dataField;
			cellRenderer.minWidth = column.minWidth;
			if(column.width === column.width) //!isNaN
			{
				cellRenderer.width = column.width;
				cellRenderer.layoutData = null;
			}
			else if(this._customColumnSizes !== null && columnIndex < this._customColumnSizes.length)
			{
				cellRenderer.width = this._customColumnSizes[columnIndex];
				cellRenderer.layoutData = null;
			}
			else
			{
				var layoutData:HorizontalLayoutData = cellRenderer.layoutData as HorizontalLayoutData;
				if(layoutData === null)
				{
					cellRenderer.layoutData = new HorizontalLayoutData(100, NaN);
				}
				else
				{
					layoutData.percentWidth = 100;
					layoutData.percentHeight = NaN;
				}
			}
			this.setChildIndex(DisplayObject(cellRenderer), columnIndex);
		}

		/**
		 * @private
		 */
		protected function columns_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function columns_resetHandler(event:Event):void
		{
			this._updateForDataReset = true;
		}

		/**
		 * @private
		 */
		protected function columns_updateAllHandler(event:Event):void
		{
			//we're treating this similar to the RESET event because enough
			//users are treating UPDATE_ALL similarly. technically, UPDATE_ALL
			//is supposed to affect only existing items, but it's confusing when
			//new items are added and not displayed.
			this._updateForDataReset = true;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function column_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
			//since we extend LayoutGroup, and the DataGridColumn includes some
			//layout information, we need to use this flag too
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}
	}
}

import feathers.controls.renderers.IDataGridCellRenderer;

class CellRendererFactoryStorage
{
	public function CellRendererFactoryStorage(factory:Function = null)
	{
		this.factory = factory;
	}

	public var activeCellRenderers:Vector.<IDataGridCellRenderer> = new <IDataGridCellRenderer>[];
	public var inactiveCellRenderers:Vector.<IDataGridCellRenderer> = new <IDataGridCellRenderer>[];
	public var factory:Function;
}


================================================
FILE: source/feathers/controls/supportClasses/GroupedListDataViewPort.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.supportClasses
{
	import feathers.controls.GroupedList;
	import feathers.controls.Scroller;
	import feathers.controls.renderers.IGroupedListFooterRenderer;
	import feathers.controls.renderers.IGroupedListHeaderRenderer;
	import feathers.controls.renderers.IGroupedListItemRenderer;
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IValidating;
	import feathers.core.PropertyProxy;
	import feathers.data.IHierarchicalCollection;
	import feathers.events.CollectionEventType;
	import feathers.events.FeathersEventType;
	import feathers.layout.IGroupedLayout;
	import feathers.layout.ILayout;
	import feathers.layout.IVariableVirtualLayout;
	import feathers.layout.IVirtualLayout;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.ViewPortBounds;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;
	import flash.utils.Dictionary;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.utils.Pool;

	/**
	 * @private
	 * Used internally by GroupedList. Not meant to be used on its own.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class GroupedListDataViewPort extends FeathersControl implements IViewPort
	{
		private static const INVALIDATION_FLAG_ITEM_RENDERER_FACTORY:String = "itemRendererFactory";

		private static const FIRST_ITEM_RENDERER_FACTORY_ID:String = "GroupedListDataViewPort-first";
		private static const SINGLE_ITEM_RENDERER_FACTORY_ID:String = "GroupedListDataViewPort-single";
		private static const LAST_ITEM_RENDERER_FACTORY_ID:String = "GroupedListDataViewPort-last";

		private static const HELPER_VECTOR:Vector.<int> = new <int>[];
		private static const LOCATION_HELPER_VECTOR:Vector.<int> = new <int>[];

		public function GroupedListDataViewPort()
		{
			super();
		}

		private var _viewPortBounds:ViewPortBounds = new ViewPortBounds();

		private var _layoutResult:LayoutBoundsResult = new LayoutBoundsResult();

		private var _actualMinVisibleWidth:Number = 0;

		private var _explicitMinVisibleWidth:Number;

		public function get minVisibleWidth():Number
		{
			if(this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth) //isNaN
			{
				return this._actualMinVisibleWidth;
			}
			return this._explicitMinVisibleWidth;
		}

		public function set minVisibleWidth(value:Number):void
		{
			if(this._explicitMinVisibleWidth == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth) //isNaN
			{
				return;
			}
			var oldValue:Number = this._explicitMinVisibleWidth;
			this._explicitMinVisibleWidth = value;
			if(valueIsNaN)
			{
				this._actualMinVisibleWidth = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this._actualMinVisibleWidth = value;
				if(this._explicitVisibleWidth !== this._explicitVisibleWidth && //isNaN
					(this._actualVisibleWidth < value || this._actualVisibleWidth == oldValue))
				{
					//only invalidate if this change might affect the visibleWidth
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		private var _maxVisibleWidth:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleWidth():Number
		{
			return this._maxVisibleWidth;
		}

		public function set maxVisibleWidth(value:Number):void
		{
			if(this._maxVisibleWidth == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleWidth cannot be NaN");
			}
			var oldValue:Number = this._maxVisibleWidth;
			this._maxVisibleWidth = value;
			if(this._explicitVisibleWidth !== this._explicitVisibleWidth && //isNaN
				(this._actualVisibleWidth > value || this._actualVisibleWidth == oldValue))
			{
				//only invalidate if this change might affect the visibleWidth
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualVisibleWidth:Number = NaN;

		private var _explicitVisibleWidth:Number = NaN;

		public function get visibleWidth():Number
		{
			return this._actualVisibleWidth;
		}

		public function set visibleWidth(value:Number):void
		{
			if(this._explicitVisibleWidth == value ||
				(value !== value && this._explicitVisibleWidth !== this._explicitVisibleWidth)) //isNaN
			{
				return;
			}
			this._explicitVisibleWidth = value;
			if(this._actualVisibleWidth != value)
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualMinVisibleHeight:Number = 0;

		private var _explicitMinVisibleHeight:Number;

		public function get minVisibleHeight():Number
		{
			if(this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight) //isNaN
			{
				return this._actualMinVisibleHeight;
			}
			return this._explicitMinVisibleHeight;
		}

		public function set minVisibleHeight(value:Number):void
		{
			if(this._explicitMinVisibleHeight == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight) //isNaN
			{
				return;
			}
			var oldValue:Number = this._explicitMinVisibleHeight;
			this._explicitMinVisibleHeight = value;
			if(valueIsNaN)
			{
				this._actualMinVisibleHeight = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this._actualMinVisibleHeight = value;
				if(this._explicitVisibleHeight !== this._explicitVisibleHeight && //isNaN
					(this._actualVisibleHeight < value || this._actualVisibleHeight == oldValue))
				{
					//only invalidate if this change might affect the visibleHeight
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		private var _maxVisibleHeight:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleHeight():Number
		{
			return this._maxVisibleHeight;
		}

		public function set maxVisibleHeight(value:Number):void
		{
			if(this._maxVisibleHeight == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleHeight cannot be NaN");
			}
			var oldValue:Number = this._maxVisibleHeight;
			this._maxVisibleHeight = value;
			if(this._explicitVisibleHeight !== this._explicitVisibleHeight && //isNaN
				(this._actualVisibleHeight > value || this._actualVisibleHeight == oldValue))
			{
				//only invalidate if this change might affect the visibleHeight
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualVisibleHeight:Number;

		private var _explicitVisibleHeight:Number = NaN;

		public function get visibleHeight():Number
		{
			return this._actualVisibleHeight;
		}

		public function set visibleHeight(value:Number):void
		{
			if(this._explicitVisibleHeight == value ||
				(value !== value && this._explicitVisibleHeight !== this._explicitVisibleHeight)) //isNaN
			{
				return;
			}
			this._explicitVisibleHeight = value;
			if(this._actualVisibleHeight != value)
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		protected var _contentX:Number = 0;

		public function get contentX():Number
		{
			return this._contentX;
		}

		protected var _contentY:Number = 0;

		public function get contentY():Number
		{
			return this._contentY;
		}

		public function get horizontalScrollStep():Number
		{
			var itemRenderer:DisplayObject = null;
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			if(virtualLayout === null || !virtualLayout.useVirtualLayout)
			{
				if(this._layoutItems.length > 0)
				{
					itemRenderer = this._layoutItems[0] as DisplayObject;
				}
			}
			if(itemRenderer === null)
			{
				itemRenderer = this._typicalItemRenderer as DisplayObject;
			}
			if(itemRenderer === null)
			{
				return 0;
			}
			var itemRendererWidth:Number = itemRenderer.width;
			var itemRendererHeight:Number = itemRenderer.height;
			if(itemRendererWidth < itemRendererHeight)
			{
				return itemRendererWidth;
			}
			return itemRendererHeight;
		}

		public function get verticalScrollStep():Number
		{
			var itemRenderer:DisplayObject = null;
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			if(virtualLayout === null || !virtualLayout.useVirtualLayout)
			{
				if(this._layoutItems.length > 0)
				{
					itemRenderer = this._layoutItems[0] as DisplayObject;
				}
			}
			if(itemRenderer === null)
			{
				itemRenderer = this._typicalItemRenderer as DisplayObject;
			}
			if(itemRenderer === null)
			{
				return 0;
			}
			var itemRendererWidth:Number = itemRenderer.width;
			var itemRendererHeight:Number = itemRenderer.height;
			if(itemRendererWidth < itemRendererHeight)
			{
				return itemRendererWidth;
			}
			return itemRendererHeight;
		}

		private var _layoutItems:Vector.<DisplayObject> = new <DisplayObject>[];

		private var _typicalItemIsInDataProvider:Boolean = false;
		private var _typicalItemRenderer:IGroupedListItemRenderer;

		private var _unrenderedItems:Vector.<int> = new <int>[];
		private var _defaultItemRendererStorage:ItemRendererFactoryStorage = new ItemRendererFactoryStorage();
		private var _itemStorageMap:Object = {};
		private var _itemRendererMap:Dictionary = new Dictionary(true);

		private var _unrenderedHeaders:Vector.<int> = new <int>[];
		private var _defaultHeaderRendererStorage:HeaderRendererFactoryStorage = new HeaderRendererFactoryStorage();
		private var _headerStorageMap:Object;
		private var _headerRendererMap:Dictionary = new Dictionary(true);

		private var _unrenderedFooters:Vector.<int> = new <int>[];
		private var _defaultFooterRendererStorage:FooterRendererFactoryStorage = new FooterRendererFactoryStorage();
		private var _footerStorageMap:Object;
		private var _footerRendererMap:Dictionary = new Dictionary(true);

		private var _headerIndices:Vector.<int> = new <int>[];
		private var _footerIndices:Vector.<int> = new <int>[];

		private var _owner:GroupedList;

		public function get owner():GroupedList
		{
			return this._owner;
		}

		public function set owner(value:GroupedList):void
		{
			this._owner = value;
		}

		private var _updateForDataReset:Boolean = false;

		private var _dataProvider:IHierarchicalCollection;

		public function get dataProvider():IHierarchicalCollection
		{
			return this._dataProvider;
		}

		public function set dataProvider(value:IHierarchicalCollection):void
		{
			if(this._dataProvider == value)
			{
				return;
			}
			if(this._dataProvider)
			{
				this._dataProvider.removeEventListener(Event.CHANGE, dataProvider_changeHandler);
				this._dataProvider.removeEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.removeEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.UPDATE_ITEM, dataProvider_updateItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.UPDATE_ALL, dataProvider_updateAllHandler);
			}
			this._dataProvider = value;
			if(this._dataProvider)
			{
				this._dataProvider.addEventListener(Event.CHANGE, dataProvider_changeHandler);
				this._dataProvider.addEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.addEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.UPDATE_ITEM, dataProvider_updateItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.UPDATE_ALL, dataProvider_updateAllHandler);
			}
			if(this._layout is IVariableVirtualLayout)
			{
				IVariableVirtualLayout(this._layout).resetVariableVirtualCache();
			}
			this._updateForDataReset = true;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private var _isSelectable:Boolean = true;

		public function get isSelectable():Boolean
		{
			return this._isSelectable;
		}

		public function set isSelectable(value:Boolean):void
		{
			if(this._isSelectable == value)
			{
				return;
			}
			this._isSelectable = value;
			if(!this._isSelectable)
			{
				this.setSelectedLocation(-1, -1);
			}
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		private var _selectedGroupIndex:int = -1;

		public function get selectedGroupIndex():int
		{
			return this._selectedGroupIndex;
		}

		private var _selectedItemIndex:int = -1;

		public function get selectedItemIndex():int
		{
			return this._selectedItemIndex;
		}

		private var _itemRendererType:Class;

		public function get itemRendererType():Class
		{
			return this._itemRendererType;
		}

		public function set itemRendererType(value:Class):void
		{
			if(this._itemRendererType == value)
			{
				return;
			}

			this._itemRendererType = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _itemRendererFactory:Function;

		public function get itemRendererFactory():Function
		{
			return this._itemRendererFactory;
		}

		public function set itemRendererFactory(value:Function):void
		{
			if(this._itemRendererFactory === value)
			{
				return;
			}

			this._itemRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _itemRendererFactories:Object;

		public function get itemRendererFactories():Object
		{
			return this._itemRendererFactories;
		}

		/**
		 * @private
		 */
		public function set itemRendererFactories(value:Object):void
		{
			if(this._itemRendererFactories === value)
			{
				return;
			}

			this._itemRendererFactories = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _factoryIDFunction:Function;

		public function get factoryIDFunction():Function
		{
			return this._factoryIDFunction;
		}

		/**
		 * @private
		 */
		public function set factoryIDFunction(value:Function):void
		{
			if(this._factoryIDFunction === value)
			{
				return;
			}

			this._factoryIDFunction = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _customItemRendererStyleName:String;

		public function get customItemRendererStyleName():String
		{
			return this._customItemRendererStyleName;
		}

		public function set customItemRendererStyleName(value:String):void
		{
			if(this._customItemRendererStyleName == value)
			{
				return;
			}
			this._customItemRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _typicalItem:Object = null;

		public function get typicalItem():Object
		{
			return this._typicalItem;
		}

		public function set typicalItem(value:Object):void
		{
			if(this._typicalItem == value)
			{
				return;
			}
			this._typicalItem = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private var _itemRendererProperties:PropertyProxy;

		public function get itemRendererProperties():PropertyProxy
		{
			return this._itemRendererProperties;
		}

		public function set itemRendererProperties(value:PropertyProxy):void
		{
			if(this._itemRendererProperties == value)
			{
				return;
			}
			if(this._itemRendererProperties)
			{
				this._itemRendererProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._itemRendererProperties = PropertyProxy(value);
			if(this._itemRendererProperties)
			{
				this._itemRendererProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		private var _firstItemRendererType:Class;

		public function get firstItemRendererType():Class
		{
			return this._firstItemRendererType;
		}

		public function set firstItemRendererType(value:Class):void
		{
			if(this._firstItemRendererType == value)
			{
				return;
			}

			this._firstItemRendererType = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _firstItemRendererFactory:Function;

		public function get firstItemRendererFactory():Function
		{
			return this._firstItemRendererFactory;
		}

		public function set firstItemRendererFactory(value:Function):void
		{
			if(this._firstItemRendererFactory === value)
			{
				return;
			}

			this._firstItemRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _customFirstItemRendererStyleName:String;

		public function get customFirstItemRendererStyleName():String
		{
			return this._customFirstItemRendererStyleName;
		}

		public function set customFirstItemRendererStyleName(value:String):void
		{
			if(this._customFirstItemRendererStyleName == value)
			{
				return;
			}
			this._customFirstItemRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _lastItemRendererType:Class;

		public function get lastItemRendererType():Class
		{
			return this._lastItemRendererType;
		}

		public function set lastItemRendererType(value:Class):void
		{
			if(this._lastItemRendererType == value)
			{
				return;
			}

			this._lastItemRendererType = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _lastItemRendererFactory:Function;

		public function get lastItemRendererFactory():Function
		{
			return this._lastItemRendererFactory;
		}

		public function set lastItemRendererFactory(value:Function):void
		{
			if(this._lastItemRendererFactory === value)
			{
				return;
			}

			this._lastItemRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _customLastItemRendererStyleName:String;

		public function get customLastItemRendererStyleName():String
		{
			return this._customLastItemRendererStyleName;
		}

		public function set customLastItemRendererStyleName(value:String):void
		{
			if(this._customLastItemRendererStyleName == value)
			{
				return;
			}
			this._customLastItemRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _singleItemRendererType:Class;

		public function get singleItemRendererType():Class
		{
			return this._singleItemRendererType;
		}

		public function set singleItemRendererType(value:Class):void
		{
			if(this._singleItemRendererType == value)
			{
				return;
			}

			this._singleItemRendererType = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _singleItemRendererFactory:Function;

		public function get singleItemRendererFactory():Function
		{
			return this._singleItemRendererFactory;
		}

		public function set singleItemRendererFactory(value:Function):void
		{
			if(this._singleItemRendererFactory === value)
			{
				return;
			}

			this._singleItemRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _customSingleItemRendererStyleName:String;

		public function get customSingleItemRendererStyleName():String
		{
			return this._customSingleItemRendererStyleName;
		}

		public function set customSingleItemRendererStyleName(value:String):void
		{
			if(this._customSingleItemRendererStyleName == value)
			{
				return;
			}
			this._customSingleItemRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _headerRendererType:Class;

		public function get headerRendererType():Class
		{
			return this._headerRendererType;
		}

		public function set headerRendererType(value:Class):void
		{
			if(this._headerRendererType == value)
			{
				return;
			}

			this._headerRendererType = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _headerRendererFactory:Function;

		public function get headerRendererFactory():Function
		{
			return this._headerRendererFactory;
		}

		public function set headerRendererFactory(value:Function):void
		{
			if(this._headerRendererFactory === value)
			{
				return;
			}

			this._headerRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _headerRendererFactories:Object;

		public function get headerRendererFactories():Object
		{
			return this._headerRendererFactories;
		}

		/**
		 * @private
		 */
		public function set headerRendererFactories(value:Object):void
		{
			if(this._headerRendererFactories === value)
			{
				return;
			}

			this._headerRendererFactories = value;
			if(value !== null)
			{
				this._headerStorageMap = {};
			}
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _headerFactoryIDFunction:Function;

		public function get headerFactoryIDFunction():Function
		{
			return this._headerFactoryIDFunction;
		}

		/**
		 * @private
		 */
		public function set headerFactoryIDFunction(value:Function):void
		{
			if(this._headerFactoryIDFunction === value)
			{
				return;
			}

			this._headerFactoryIDFunction = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _customHeaderRendererStyleName:String;

		public function get customHeaderRendererStyleName():String
		{
			return this._customHeaderRendererStyleName;
		}

		public function set customHeaderRendererStyleName(value:String):void
		{
			if(this._customHeaderRendererStyleName == value)
			{
				return;
			}
			this._customHeaderRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _headerRendererProperties:PropertyProxy;

		public function get headerRendererProperties():PropertyProxy
		{
			return this._headerRendererProperties;
		}

		public function set headerRendererProperties(value:PropertyProxy):void
		{
			if(this._headerRendererProperties == value)
			{
				return;
			}
			if(this._headerRendererProperties)
			{
				this._headerRendererProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._headerRendererProperties = PropertyProxy(value);
			if(this._headerRendererProperties)
			{
				this._headerRendererProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		private var _footerRendererType:Class;

		public function get footerRendererType():Class
		{
			return this._footerRendererType;
		}

		public function set footerRendererType(value:Class):void
		{
			if(this._footerRendererType == value)
			{
				return;
			}

			this._footerRendererType = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _footerRendererFactory:Function;

		public function get footerRendererFactory():Function
		{
			return this._footerRendererFactory;
		}

		public function set footerRendererFactory(value:Function):void
		{
			if(this._footerRendererFactory === value)
			{
				return;
			}

			this._footerRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _footerRendererFactories:Object;

		public function get footerRendererFactories():Object
		{
			return this._footerRendererFactories;
		}

		/**
		 * @private
		 */
		public function set footerRendererFactories(value:Object):void
		{
			if(this._footerRendererFactories === value)
			{
				return;
			}

			this._footerRendererFactories = value;
			if(value !== null)
			{
				this._footerStorageMap = {};
			}
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _footerFactoryIDFunction:Function;

		public function get footerFactoryIDFunction():Function
		{
			return this._footerFactoryIDFunction;
		}

		/**
		 * @private
		 */
		public function set footerFactoryIDFunction(value:Function):void
		{
			if(this._footerFactoryIDFunction === value)
			{
				return;
			}

			this._footerFactoryIDFunction = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _customFooterRendererStyleName:String;

		public function get customFooterRendererStyleName():String
		{
			return this._customFooterRendererStyleName;
		}

		public function set customFooterRendererStyleName(value:String):void
		{
			if(this._customFooterRendererStyleName == value)
			{
				return;
			}
			this._customFooterRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _footerRendererProperties:PropertyProxy;

		public function get footerRendererProperties():PropertyProxy
		{
			return this._footerRendererProperties;
		}

		public function set footerRendererProperties(value:PropertyProxy):void
		{
			if(this._footerRendererProperties == value)
			{
				return;
			}
			if(this._footerRendererProperties)
			{
				this._footerRendererProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._footerRendererProperties = PropertyProxy(value);
			if(this._footerRendererProperties)
			{
				this._footerRendererProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		private var _ignoreLayoutChanges:Boolean = false;
		private var _ignoreRendererResizing:Boolean = false;

		private var _layout:ILayout;

		public function get layout():ILayout
		{
			return this._layout;
		}

		public function set layout(value:ILayout):void
		{
			if(this._layout == value)
			{
				return;
			}
			if(this._layout)
			{
				this._layout.removeEventListener(Event.CHANGE, layout_changeHandler);
			}
			this._layout = value;
			if(this._layout)
			{
				if(this._layout is IVariableVirtualLayout)
				{
					var variableVirtualLayout:IVariableVirtualLayout = IVariableVirtualLayout(this._layout);

					//headers and footers are almost always going to have a
					//different height, so we might as well force it because if
					//we don't, there will be a lot of support requests
					variableVirtualLayout.hasVariableItemDimensions = true;

					variableVirtualLayout.resetVariableVirtualCache();
				}
				this._layout.addEventListener(Event.CHANGE, layout_changeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		private var _horizontalScrollPosition:Number = 0;

		public function get horizontalScrollPosition():Number
		{
			return this._horizontalScrollPosition;
		}

		public function set horizontalScrollPosition(value:Number):void
		{
			if(this._horizontalScrollPosition == value)
			{
				return;
			}
			this._horizontalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		private var _verticalScrollPosition:Number = 0;

		public function get verticalScrollPosition():Number
		{
			return this._verticalScrollPosition;
		}

		public function set verticalScrollPosition(value:Number):void
		{
			if(this._verticalScrollPosition == value)
			{
				return;
			}
			this._verticalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		public function get requiresMeasurementOnScroll():Boolean
		{
			return this._layout.requiresLayoutOnScroll &&
				(this._explicitVisibleWidth !== this._explicitVisibleWidth ||
				this._explicitVisibleHeight !== this._explicitVisibleHeight);
		}

		private var _minimumItemCount:int;
		private var _minimumHeaderCount:int;
		private var _minimumFooterCount:int;
		private var _minimumFirstAndLastItemCount:int;
		private var _minimumSingleItemCount:int;

		private var _ignoreSelectionChanges:Boolean = false;

		public function setSelectedLocation(groupIndex:int, itemIndex:int):void
		{
			if(this._selectedGroupIndex == groupIndex && this._selectedItemIndex == itemIndex)
			{
				return;
			}
			if((groupIndex < 0 && itemIndex >= 0) || (groupIndex >= 0 && itemIndex < 0))
			{
				throw new ArgumentError("To deselect items, group index and item index must both be < 0.");
			}
			this._selectedGroupIndex = groupIndex;
			this._selectedItemIndex = itemIndex;

			this.invalidate(INVALIDATION_FLAG_SELECTED);
			this.dispatchEventWith(Event.CHANGE);
		}

		public function calculateNavigationDestination(groupIndex:int, itemIndex:int, keyCode:uint, result:Vector.<int>):void
		{
			var displayIndex:int = this.locationToDisplayIndex(groupIndex, itemIndex);
			var newDisplayIndex:int = this._layout.calculateNavigationDestination(this._layoutItems, displayIndex, keyCode, this._layoutResult);
			this.displayIndexToLocation(newDisplayIndex, result);
		}

		public function getScrollPositionForIndex(groupIndex:int, itemIndex:int, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}

			var displayIndex:int = this.locationToDisplayIndex(groupIndex, itemIndex);
			return this._layout.getScrollPositionForIndex(displayIndex, this._layoutItems,
				0, 0, this._actualVisibleWidth, this._actualVisibleHeight, result);
		}

		public function getNearestScrollPositionForIndex(groupIndex:int, itemIndex:int, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}

			var displayIndex:int = this.locationToDisplayIndex(groupIndex, itemIndex);
			return this._layout.getNearestScrollPositionForIndex(displayIndex, this._horizontalScrollPosition,
				this._verticalScrollPosition, this._layoutItems, 0, 0, this._actualVisibleWidth, this._actualVisibleHeight, result);
		}

		public function itemToItemRenderer(item:Object):IGroupedListItemRenderer
		{
			if(item is XML || item is XMLList)
			{
				return IGroupedListItemRenderer(this._itemRendererMap[item.toXMLString()]);
			}
			return IGroupedListItemRenderer(this._itemRendererMap[item]);
		}

		public function headerDataToHeaderRenderer(headerData:Object):IGroupedListHeaderRenderer
		{
			if(headerData is XML || headerData is XMLList)
			{
				return IGroupedListHeaderRenderer(this._headerRendererMap[headerData.toXMLString()]);
			}
			return IGroupedListHeaderRenderer(this._headerRendererMap[headerData]);
		}

		public function footerDataToFooterRenderer(footerData:Object):IGroupedListFooterRenderer
		{
			if(footerData is XML || footerData is XMLList)
			{
				return IGroupedListFooterRenderer(this._footerRendererMap[footerData.toXMLString()]);
			}
			return IGroupedListFooterRenderer(this._footerRendererMap[footerData]);
		}

		override public function dispose():void
		{
			this.refreshInactiveRenderers(true);
			this.owner = null;
			this.dataProvider = null;
			this.layout = null;
			super.dispose();
		}

		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var scrollInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SCROLL);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var selectionInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SELECTED);
			var itemRendererInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);

			//scrolling only affects the layout is requiresLayoutOnScroll is true
			if(!layoutInvalid && scrollInvalid && this._layout && this._layout.requiresLayoutOnScroll)
			{
				layoutInvalid = true;
			}

			var basicsInvalid:Boolean = sizeInvalid || dataInvalid || layoutInvalid || itemRendererInvalid;

			var oldIgnoreRendererResizing:Boolean = this._ignoreRendererResizing;
			this._ignoreRendererResizing = true;
			var oldIgnoreLayoutChanges:Boolean = this._ignoreLayoutChanges;
			this._ignoreLayoutChanges = true;

			if(scrollInvalid || sizeInvalid)
			{
				this.refreshViewPortBounds();
			}
			if(basicsInvalid)
			{
				this.refreshInactiveRenderers(itemRendererInvalid);
			}
			if(dataInvalid || layoutInvalid || itemRendererInvalid)
			{
				this.refreshLayoutTypicalItem();
			}
			if(basicsInvalid)
			{
				this.refreshRenderers();
			}
			if(stylesInvalid || basicsInvalid)
			{
				this.refreshHeaderRendererStyles();
				this.refreshFooterRendererStyles();
				this.refreshItemRendererStyles();
			}
			if(selectionInvalid || basicsInvalid)
			{
				//unlike resizing renderers and layout changes, we only want to
				//stop listening for selection changes when we're forcibly
				//updating selection. other property changes on item renderers
				//can validly change selection, and we need to detect that.
				var oldIgnoreSelectionChanges:Boolean = this._ignoreSelectionChanges;
				this._ignoreSelectionChanges = true;
				this.refreshSelection();
				this._ignoreSelectionChanges = oldIgnoreSelectionChanges;
			}
			if(stateInvalid || basicsInvalid)
			{
				this.refreshEnabled();
			}
			this._ignoreLayoutChanges = oldIgnoreLayoutChanges;

			if(stateInvalid || selectionInvalid || stylesInvalid || basicsInvalid)
			{
				this._layout.layout(this._layoutItems, this._viewPortBounds, this._layoutResult);
			}

			this._ignoreRendererResizing = oldIgnoreRendererResizing;

			this._contentX = this._layoutResult.contentX;
			this._contentY = this._layoutResult.contentY;
			this.saveMeasurements(this._layoutResult.contentWidth, this._layoutResult.contentHeight,
				this._layoutResult.contentWidth, this._layoutResult.contentHeight);
			this._actualVisibleWidth = this._layoutResult.viewPortWidth;
			this._actualVisibleHeight = this._layoutResult.viewPortHeight;
			this._actualMinVisibleWidth = this._layoutResult.viewPortWidth;
			this._actualMinVisibleHeight = this._layoutResult.viewPortHeight;

			//final validation to avoid juggler next frame issues
			this.validateRenderers();
		}

		private function validateRenderers():void
		{
			var itemCount:int = this._layoutItems.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:IValidating = this._layoutItems[i] as IValidating;
				if(item)
				{
					item.validate();
				}
			}
		}

		private function refreshEnabled():void
		{
			for each(var item:DisplayObject in this._layoutItems)
			{
				var control:IFeathersControl = item as IFeathersControl;
				if(control)
				{
					control.isEnabled = this._isEnabled;
				}
			}
		}

		private function invalidateParent(flag:String = INVALIDATION_FLAG_ALL):void
		{
			Scroller(this.parent).invalidate(flag);
		}

		private function refreshLayoutTypicalItem():void
		{
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			if(!virtualLayout || !virtualLayout.useVirtualLayout)
			{
				if(!this._typicalItemIsInDataProvider && this._typicalItemRenderer)
				{
					//the old layout was virtual, but this one isn't
					this.destroyItemRenderer(this._typicalItemRenderer);
					this._typicalItemRenderer = null;
				}
				return;
			}

			var newTypicalItemIsInDataProvider:Boolean = false;
			var typicalItem:Object = this._typicalItem;
			var groupCount:int = 0;
			var typicalGroupLength:int = 0;
			var typicalItemGroupIndex:int = 0;
			var typicalItemItemIndex:int = 0;
			if(this._dataProvider)
			{
				if(typicalItem !== null)
				{
					this._dataProvider.getItemLocation(typicalItem, HELPER_VECTOR);
					if(HELPER_VECTOR.length > 1)
					{
						newTypicalItemIsInDataProvider = true;
						typicalItemGroupIndex = HELPER_VECTOR[0];
						typicalItemItemIndex = HELPER_VECTOR[1];
						HELPER_VECTOR.length = 0;
					}
				}
				else
				{
					groupCount = this._dataProvider.getLengthAtLocation();
					if(groupCount > 0)
					{
						for(var i:int = 0; i < groupCount; i++)
						{
							LOCATION_HELPER_VECTOR.length = 1;
							LOCATION_HELPER_VECTOR[0] = i;
							typicalGroupLength = this._dataProvider.getLengthAtLocation(LOCATION_HELPER_VECTOR);
							if(typicalGroupLength > 0)
							{
								newTypicalItemIsInDataProvider = true;
								typicalItemGroupIndex = i;
								LOCATION_HELPER_VECTOR.length = 2;
								LOCATION_HELPER_VECTOR[1] = 0;
								typicalItem = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
								break;
							}
						}
						LOCATION_HELPER_VECTOR.length = 0;
					}
				}
			}

			//#1645 The typicalItem can be null if the data provider contains
			//a null value at index 0. this is the only time we allow null.
			if(typicalItem !== null || newTypicalItemIsInDataProvider)
			{
				var typicalItemRenderer:IGroupedListItemRenderer = this.itemToItemRenderer(typicalItem);
				if(typicalItemRenderer)
				{
					//at this point, the item already has an item renderer.
					//(this doesn't necessarily mean that the current typical
					//item was the typical item last time this function was
					//called)

					//the indices may have changed if items were added, removed,
					//or reordered in the data provider
					typicalItemRenderer.groupIndex = typicalItemGroupIndex;
					typicalItemRenderer.itemIndex = typicalItemItemIndex;
				}
				if(!typicalItemRenderer && this._typicalItemRenderer)
				{
					//the typical item has changed, and doesn't have an item
					//renderer yet. the previous typical item had an item
					//renderer, so we will try to reuse it.

					var canReuse:Boolean = !this._typicalItemIsInDataProvider;
					if(canReuse)
					{
						//we can't reuse if the factoryID has changed, though!
						var factoryID:String = this.getFactoryID(typicalItem, typicalItemGroupIndex, typicalItemItemIndex);
						if(this._typicalItemRenderer.factoryID !== factoryID)
						{
							canReuse = false;
						}
					}
					if(canReuse)
					{
						//we can reuse the item renderer used for the old
						//typical item!
						typicalItemRenderer = this._typicalItemRenderer;
						typicalItemRenderer.data = typicalItem;
						typicalItemRenderer.groupIndex = typicalItemGroupIndex;
						typicalItemRenderer.itemIndex = typicalItemItemIndex;
					}
				}
				if(!typicalItemRenderer)
				{
					typicalItemRenderer = this.createItemRenderer(typicalItem, 0, 0, 0, false, !newTypicalItemIsInDataProvider);
					if(!this._typicalItemIsInDataProvider && this._typicalItemRenderer)
					{
						//get rid of the old one if it isn't needed anymore
						//since it is not in the data provider, we don't need to mess
						//with the renderer map dictionary.
						this.destroyItemRenderer(this._typicalItemRenderer);
						this._typicalItemRenderer = null;
					}
				}
			}

			virtualLayout.typicalItem = DisplayObject(typicalItemRenderer);
			this._typicalItemRenderer = typicalItemRenderer;
			this._typicalItemIsInDataProvider = newTypicalItemIsInDataProvider;
			if(this._typicalItemRenderer && !this._typicalItemIsInDataProvider)
			{
				//we need to know if this item renderer resizes to adjust the
				//layout because the layout may use this item renderer to resize
				//the other item renderers
				this._typicalItemRenderer.addEventListener(FeathersEventType.RESIZE, itemRenderer_resizeHandler);
			}
		}

		private function refreshItemRendererStyles():void
		{
			for each(var item:DisplayObject in this._layoutItems)
			{
				var itemRenderer:IGroupedListItemRenderer = item as IGroupedListItemRenderer;
				if(itemRenderer)
				{
					this.refreshOneItemRendererStyles(itemRenderer);
				}
			}
		}

		private function refreshHeaderRendererStyles():void
		{
			for each(var item:DisplayObject in this._layoutItems)
			{
				var headerRenderer:IGroupedListHeaderRenderer = item as IGroupedListHeaderRenderer;
				if(headerRenderer)
				{
					this.refreshOneHeaderRendererStyles(headerRenderer);
				}
			}
		}

		private function refreshFooterRendererStyles():void
		{
			for each(var item:DisplayObject in this._layoutItems)
			{
				var footerRenderer:IGroupedListFooterRenderer = item as IGroupedListFooterRenderer;
				if(footerRenderer)
				{
					this.refreshOneFooterRendererStyles(footerRenderer);
				}
			}
		}

		private function refreshOneItemRendererStyles(renderer:IGroupedListItemRenderer):void
		{
			var displayRenderer:DisplayObject = DisplayObject(renderer);
			for(var propertyName:String in this._itemRendererProperties)
			{
				var propertyValue:Object = this._itemRendererProperties[propertyName];
				displayRenderer[propertyName] = propertyValue;
			}
		}

		private function refreshOneHeaderRendererStyles(renderer:IGroupedListHeaderRenderer):void
		{
			var displayRenderer:DisplayObject = DisplayObject(renderer);
			for(var propertyName:String in this._headerRendererProperties)
			{
				var propertyValue:Object = this._headerRendererProperties[propertyName];
				displayRenderer[propertyName] = propertyValue;
			}
		}

		private function refreshOneFooterRendererStyles(renderer:IGroupedListFooterRenderer):void
		{
			var displayRenderer:DisplayObject = DisplayObject(renderer);
			for(var propertyName:String in this._footerRendererProperties)
			{
				var propertyValue:Object = this._footerRendererProperties[propertyName];
				displayRenderer[propertyName] = propertyValue;
			}
		}

		private function refreshSelection():void
		{
			for each(var item:DisplayObject in this._layoutItems)
			{
				var itemRenderer:IGroupedListItemRenderer = item as IGroupedListItemRenderer;
				if(itemRenderer)
				{
					itemRenderer.isSelected = itemRenderer.groupIndex == this._selectedGroupIndex &&
						itemRenderer.itemIndex == this._selectedItemIndex;
				}
			}
		}

		private function refreshViewPortBounds():void
		{
			var needsMinWidth:Boolean = this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight; //isNaN
			this._viewPortBounds.x = 0;
			this._viewPortBounds.y = 0;
			this._viewPortBounds.scrollX = this._horizontalScrollPosition;
			this._viewPortBounds.scrollY = this._verticalScrollPosition;
			this._viewPortBounds.explicitWidth = this._explicitVisibleWidth;
			this._viewPortBounds.explicitHeight = this._explicitVisibleHeight;
			if(needsMinWidth)
			{
				this._viewPortBounds.minWidth = 0;
			}
			else
			{
				this._viewPortBounds.minWidth = this._explicitMinVisibleWidth;
			}
			if(needsMinHeight)
			{
				this._viewPortBounds.minHeight = 0;
			}
			else
			{
				this._viewPortBounds.minHeight = this._explicitMinVisibleHeight;
			}
			this._viewPortBounds.maxWidth = this._maxVisibleWidth;
			this._viewPortBounds.maxHeight = this._maxVisibleHeight;
		}

		private function refreshInactiveRenderers(itemRendererTypeIsInvalid:Boolean):void
		{
			this.refreshInactiveItemRenderers(this._defaultItemRendererStorage, itemRendererTypeIsInvalid);
			for(var factoryID:String in this._itemStorageMap)
			{
				var itemStorage:ItemRendererFactoryStorage = ItemRendererFactoryStorage(this._itemStorageMap[factoryID]);
				this.refreshInactiveItemRenderers(itemStorage, itemRendererTypeIsInvalid);
			}

			this.refreshInactiveHeaderRenderers(this._defaultHeaderRendererStorage, itemRendererTypeIsInvalid);
			for(factoryID in this._headerStorageMap)
			{
				var headerStorage:HeaderRendererFactoryStorage = HeaderRendererFactoryStorage(this._headerStorageMap[factoryID]);
				this.refreshInactiveHeaderRenderers(headerStorage, itemRendererTypeIsInvalid);
			}

			this.refreshInactiveFooterRenderers(this._defaultFooterRendererStorage, itemRendererTypeIsInvalid);
			for(factoryID in this._footerStorageMap)
			{
				var footerStorage:FooterRendererFactoryStorage = FooterRendererFactoryStorage(this._footerStorageMap[factoryID]);
				this.refreshInactiveFooterRenderers(footerStorage, itemRendererTypeIsInvalid);
			}

			if(itemRendererTypeIsInvalid && this._typicalItemRenderer)
			{
				if(this._typicalItemIsInDataProvider)
				{
					var item:Object = this._typicalItemRenderer.data;
					if(item is XML || item is XMLList)
					{
						delete this._itemRendererMap[item.toXMLString()];
					}
					else
					{
						delete this._itemRendererMap[item];
					}
				}
				this.destroyItemRenderer(this._typicalItemRenderer);
				this._typicalItemRenderer = null;
				this._typicalItemIsInDataProvider = false;
			}

			this._headerIndices.length = 0;
			this._footerIndices.length = 0;
		}

		private function refreshInactiveItemRenderers(storage:ItemRendererFactoryStorage, itemRendererTypeIsInvalid:Boolean):void
		{
			var temp:Vector.<IGroupedListItemRenderer> = storage.inactiveItemRenderers;
			storage.inactiveItemRenderers = storage.activeItemRenderers;
			storage.activeItemRenderers = temp;
			if(storage.activeItemRenderers.length > 0)
			{
				throw new IllegalOperationError("GroupedListDataViewPort: active item renderers should be empty.");
			}

			if(itemRendererTypeIsInvalid)
			{
				this.recoverInactiveItemRenderers(storage);
				this.freeInactiveItemRenderers(storage, 0);
			}
		}

		private function refreshInactiveHeaderRenderers(storage:HeaderRendererFactoryStorage, itemRendererTypeIsInvalid:Boolean):void
		{
			var temp:Vector.<IGroupedListHeaderRenderer> = storage.inactiveHeaderRenderers;
			storage.inactiveHeaderRenderers = storage.activeHeaderRenderers;
			storage.activeHeaderRenderers = temp;
			if(storage.activeHeaderRenderers.length > 0)
			{
				throw new IllegalOperationError("GroupedListDataViewPort: active header renderers should be empty.");
			}

			if(itemRendererTypeIsInvalid)
			{
				this.recoverInactiveHeaderRenderers(storage);
				this.freeInactiveHeaderRenderers(storage, 0);
			}
		}

		private function refreshInactiveFooterRenderers(storage:FooterRendererFactoryStorage, itemRendererTypeIsInvalid:Boolean):void
		{
			var temp:Vector.<IGroupedListFooterRenderer> = storage.inactiveFooterRenderers;
			storage.inactiveFooterRenderers = storage.activeFooterRenderers;
			storage.activeFooterRenderers = temp;
			if(storage.activeFooterRenderers.length > 0)
			{
				throw new IllegalOperationError("GroupedListDataViewPort: active footer renderers should be empty.");
			}

			if(itemRendererTypeIsInvalid)
			{
				this.recoverInactiveFooterRenderers(storage);
				this.freeInactiveFooterRenderers(storage, 0);
			}
		}

		private function refreshRenderers():void
		{
			if(this._typicalItemRenderer)
			{
				if(this._typicalItemIsInDataProvider)
				{
					var itemStorage:ItemRendererFactoryStorage = this.factoryIDToStorage(this._typicalItemRenderer.factoryID,
						this._typicalItemRenderer.groupIndex, this._typicalItemRenderer.itemIndex);
					var inactiveItemRenderers:Vector.<IGroupedListItemRenderer> = itemStorage.inactiveItemRenderers;
					var activeItemRenderers:Vector.<IGroupedListItemRenderer> = itemStorage.activeItemRenderers;

					//this renderer is already is use by the typical item, so we
					//don't want to allow it to be used by other items.
					var inactiveIndex:int = inactiveItemRenderers.indexOf(this._typicalItemRenderer);
					if(inactiveIndex >= 0)
					{
						inactiveItemRenderers.removeAt(inactiveIndex);
					}
					//if refreshLayoutTypicalItem() was called, it will have already
					//added the typical item renderer to the active renderers. if
					//not, we need to do it here.
					var activeRenderersCount:int = activeItemRenderers.length;
					if(activeRenderersCount == 0)
					{
						activeItemRenderers[activeRenderersCount] = this._typicalItemRenderer;
					}
				}
				//we need to set the typical item renderer's properties here
				//because they may be needed for proper measurement in a virtual
				//layout.
				this.refreshOneItemRendererStyles(this._typicalItemRenderer);
			}

			this.findUnrenderedData();
			this.recoverInactiveItemRenderers(this._defaultItemRendererStorage);
			if(this._itemStorageMap)
			{
				for(var factoryID:String in this._itemStorageMap)
				{
					itemStorage = ItemRendererFactoryStorage(this._itemStorageMap[factoryID]);
					this.recoverInactiveItemRenderers(itemStorage);
				}
			}
			this.recoverInactiveHeaderRenderers(this._defaultHeaderRendererStorage);
			if(this._headerStorageMap)
			{
				for(factoryID in this._headerStorageMap)
				{
					var headerStorage:HeaderRendererFactoryStorage = HeaderRendererFactoryStorage(this._headerStorageMap[factoryID]);
					this.recoverInactiveHeaderRenderers(headerStorage);
				}
			}
			this.recoverInactiveFooterRenderers(this._defaultFooterRendererStorage);
			if(this._footerStorageMap)
			{
				for(factoryID in this._footerStorageMap)
				{
					var footerStorage:FooterRendererFactoryStorage = FooterRendererFactoryStorage(this._footerStorageMap[factoryID]);
					this.recoverInactiveFooterRenderers(footerStorage);
				}
			}

			this.renderUnrenderedData();

			this.freeInactiveItemRenderers(this._defaultItemRendererStorage, this._minimumItemCount);
			if(this._itemStorageMap)
			{
				for(factoryID in this._itemStorageMap)
				{
					itemStorage = ItemRendererFactoryStorage(this._itemStorageMap[factoryID]);
					this.freeInactiveItemRenderers(itemStorage, 1);
				}
			}
			this.freeInactiveHeaderRenderers(this._defaultHeaderRendererStorage, this._minimumHeaderCount);
			if(this._headerStorageMap)
			{
				for(factoryID in this._headerStorageMap)
				{
					headerStorage = HeaderRendererFactoryStorage(this._headerStorageMap[factoryID]);
					this.freeInactiveHeaderRenderers(headerStorage, 1);
				}
			}
			this.freeInactiveFooterRenderers(this._defaultFooterRendererStorage, this._minimumFooterCount);
			if(this._footerStorageMap)
			{
				for(factoryID in this._footerStorageMap)
				{
					footerStorage = FooterRendererFactoryStorage(this._footerStorageMap[factoryID]);
					this.freeInactiveFooterRenderers(footerStorage, 1);
				}
			}

			this._updateForDataReset = false;
		}

		private function findUnrenderedData():void
		{
			var groupCount:int = this._dataProvider ? this._dataProvider.getLengthAtLocation() : 0;
			var totalLayoutCount:int = 0;
			var totalHeaderCount:int = 0;
			var totalFooterCount:int = 0;
			var totalSingleItemCount:int = 0;
			var averageItemsPerGroup:int = 0;
			LOCATION_HELPER_VECTOR.length = 1;
			for(var i:int = 0; i < groupCount; i++)
			{
				LOCATION_HELPER_VECTOR[0] = i;
				var group:Object = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
				if(this._owner.groupToHeaderData(group) !== null)
				{
					this._headerIndices[totalHeaderCount] = totalLayoutCount;
					totalLayoutCount++;
					totalHeaderCount++;
				}
				var currentItemCount:int = this._dataProvider.getLengthAtLocation(LOCATION_HELPER_VECTOR);
				totalLayoutCount += currentItemCount;
				averageItemsPerGroup += currentItemCount;
				if(currentItemCount == 0)
				{
					totalSingleItemCount++;
				}
				if(this._owner.groupToFooterData(group) !== null)
				{
					this._footerIndices[totalFooterCount] = totalLayoutCount;
					totalLayoutCount++;
					totalFooterCount++;
				}
			}
			LOCATION_HELPER_VECTOR.length = 0;
			this._layoutItems.length = totalLayoutCount;
			if(this._layout is IGroupedLayout)
			{
				IGroupedLayout(this._layout).headerIndices = this._headerIndices;
			}
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			var useVirtualLayout:Boolean = virtualLayout && virtualLayout.useVirtualLayout;
			if(useVirtualLayout)
			{
				var point:Point = Pool.getPoint();
				virtualLayout.measureViewPort(totalLayoutCount, this._viewPortBounds, point);
				var viewPortWidth:Number = point.x;
				var viewPortHeight:Number = point.y;
				Pool.putPoint(point);
				virtualLayout.getVisibleIndicesAtScrollPosition(this._horizontalScrollPosition, this._verticalScrollPosition, viewPortWidth, viewPortHeight, totalLayoutCount, HELPER_VECTOR);

				averageItemsPerGroup /= groupCount;

				if(this._typicalItemRenderer)
				{
					var minimumTypicalItemEdge:Number = this._typicalItemRenderer.height;
					if(this._typicalItemRenderer.width < minimumTypicalItemEdge)
					{
						minimumTypicalItemEdge = this._typicalItemRenderer.width;
					}

					var maximumViewPortEdge:Number = viewPortWidth;
					if(viewPortHeight > viewPortWidth)
					{
						maximumViewPortEdge = viewPortHeight;
					}
					this._minimumFirstAndLastItemCount = this._minimumSingleItemCount = this._minimumHeaderCount = this._minimumFooterCount = Math.ceil(maximumViewPortEdge / (minimumTypicalItemEdge * averageItemsPerGroup));
					this._minimumHeaderCount = Math.min(this._minimumHeaderCount, totalHeaderCount);
					this._minimumFooterCount = Math.min(this._minimumFooterCount, totalFooterCount);
					this._minimumSingleItemCount = Math.min(this._minimumSingleItemCount, totalSingleItemCount);

					//assumes that zero headers/footers might be visible
					this._minimumItemCount = Math.ceil(maximumViewPortEdge / minimumTypicalItemEdge) + 1;
				}
				else
				{
					this._minimumFirstAndLastItemCount = 1;
					this._minimumHeaderCount = 1;
					this._minimumFooterCount = 1;
					this._minimumSingleItemCount = 1;
					this._minimumItemCount = 1;
				}
			}
			var currentIndex:int = 0;
			for(i = 0; i < groupCount; i++)
			{
				LOCATION_HELPER_VECTOR.length = 1;
				LOCATION_HELPER_VECTOR[0] = i;
				group = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
				LOCATION_HELPER_VECTOR.length = 0;
				var header:Object = this._owner.groupToHeaderData(group);
				if(header !== null)
				{
					//the end index is included in the visible items
					if(useVirtualLayout && HELPER_VECTOR.indexOf(currentIndex) < 0)
					{
						this._layoutItems[currentIndex] = null;
					}
					else
					{
						this.findRendererForHeader(header, i, currentIndex);
					}
					currentIndex++;
				}
				LOCATION_HELPER_VECTOR.length = 1;
				LOCATION_HELPER_VECTOR[0] = i;
				currentItemCount = this._dataProvider.getLengthAtLocation(LOCATION_HELPER_VECTOR);
				LOCATION_HELPER_VECTOR.length = 0;
				for(var j:int = 0; j < currentItemCount; j++)
				{
					if(useVirtualLayout && HELPER_VECTOR.indexOf(currentIndex) < 0)
					{
						if(this._typicalItemRenderer && this._typicalItemIsInDataProvider &&
							this._typicalItemRenderer.groupIndex == i &&
							this._typicalItemRenderer.itemIndex == j)
						{
							//the indices may have changed if items were added, removed,
							//or reordered in the data provider
							this._typicalItemRenderer.layoutIndex = currentIndex;
						}
						this._layoutItems[currentIndex] = null;
					}
					else
					{
						LOCATION_HELPER_VECTOR.length = 2;
						LOCATION_HELPER_VECTOR[0] = i;
						LOCATION_HELPER_VECTOR[1] = j;
						var item:Object = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
						LOCATION_HELPER_VECTOR.length = 0;
						this.findRendererForItem(item, i, j, currentIndex);
					}
					currentIndex++;
				}
				var footer:Object = this._owner.groupToFooterData(group);
				if(footer !== null)
				{
					if(useVirtualLayout && HELPER_VECTOR.indexOf(currentIndex) < 0)
					{
						this._layoutItems[currentIndex] = null;
					}
					else
					{
						this.findRendererForFooter(footer, i, currentIndex);
					}
					currentIndex++;
				}
			}
			LOCATION_HELPER_VECTOR.length = 0;
			//update the typical item renderer's visibility
			if(this._typicalItemRenderer)
			{
				if(useVirtualLayout && this._typicalItemIsInDataProvider)
				{
					var index:int = HELPER_VECTOR.indexOf(this._typicalItemRenderer.layoutIndex);
					if(index >= 0)
					{
						this._typicalItemRenderer.visible = true;
					}
					else
					{
						this._typicalItemRenderer.visible = false;

						//uncomment these lines to see a hidden typical item for
						//debugging purposes...
						/*this._typicalItemRenderer.visible = true;
						this._typicalItemRenderer.x = this._horizontalScrollPosition;
						this._typicalItemRenderer.y = this._verticalScrollPosition;*/
					}
				}
				else
				{
					this._typicalItemRenderer.visible = this._typicalItemIsInDataProvider;
				}
			}
			HELPER_VECTOR.length = 0;
		}

		private function findRendererForItem(item:Object, groupIndex:int, itemIndex:int, layoutIndex:int):void
		{
			var itemRenderer:IGroupedListItemRenderer = this.itemToItemRenderer(item);
			if(this._factoryIDFunction !== null && itemRenderer !== null)
			{
				var newFactoryID:String = this.getFactoryID(itemRenderer.data, groupIndex, itemIndex);
				if(newFactoryID !== itemRenderer.factoryID)
				{
					itemRenderer = null;
					if(item is XML || item is XMLList)
					{
						delete this._itemRendererMap[item.toXMLString()];
					}
					else
					{
						delete this._itemRendererMap[item];
					}
				}
			}
			if(itemRenderer !== null)
			{
				//the indices may have changed if items were added, removed,
				//or reordered in the data provider
				itemRenderer.groupIndex = groupIndex;
				itemRenderer.itemIndex = itemIndex;
				itemRenderer.layoutIndex = layoutIndex;
				if(this._updateForDataReset)
				{
					//similar to calling updateItemAt(), replacing the data
					//provider or resetting its source means that we should
					//trick the item renderer into thinking it has new data.
					//many developers seem to expect this behavior, so while
					//it's not the most optimal for performance, it saves on
					//support time in the forums. thankfully, it's still
					//somewhat optimized since the same item renderer will
					//receive the same data, and the children generally
					//won't have changed much, if at all.
					itemRenderer.data = null;
					itemRenderer.data = item;
				}

				//the typical item renderer is a special case, and we will
				//have already put it into the active renderers, so we don't
				//want to do it again!
				if(this._typicalItemRenderer !== itemRenderer)
				{
					var storage:ItemRendererFactoryStorage = this.factoryIDToStorage(itemRenderer.factoryID,
						itemRenderer.groupIndex, itemRenderer.itemIndex);
					var activeItemRenderers:Vector.<IGroupedListItemRenderer> = storage.activeItemRenderers;
					var inactiveItemRenderers:Vector.<IGroupedListItemRenderer> = storage.inactiveItemRenderers;
					activeItemRenderers[activeItemRenderers.length] = itemRenderer;
					var inactiveIndex:int = inactiveItemRenderers.indexOf(itemRenderer);
					if(inactiveIndex >= 0)
					{
						inactiveItemRenderers.removeAt(inactiveIndex);
					}
					else
					{
						throw new IllegalOperationError("GroupedListDataViewPort: item renderer map contains bad data. This may be caused by duplicate items in the data provider, which is not allowed.");
					}
				}
				itemRenderer.visible = true;
				this._layoutItems[layoutIndex] = DisplayObject(itemRenderer);
			}
			else
			{
				var pushIndex:int = this._unrenderedItems.length;
				this._unrenderedItems[pushIndex] = groupIndex;
				pushIndex++;
				this._unrenderedItems[pushIndex] = itemIndex;
				pushIndex++;
				this._unrenderedItems[pushIndex] = layoutIndex;
			}
		}

		private function findRendererForHeader(header:Object, groupIndex:int, layoutIndex:int):void
		{
			var headerRenderer:IGroupedListHeaderRenderer = this.headerDataToHeaderRenderer(header);
			if(this._headerFactoryIDFunction !== null && headerRenderer !== null)
			{
				var newFactoryID:String = this.getHeaderFactoryID(headerRenderer.data, groupIndex);
				if(newFactoryID !== headerRenderer.factoryID)
				{
					headerRenderer = null;
					if(header is XML || header is XMLList)
					{
						delete this._headerRendererMap[header.toXMLString()];
					}
					else
					{
						delete this._headerRendererMap[header];
					}
				}
			}
			if(headerRenderer !== null)
			{
				headerRenderer.groupIndex = groupIndex;
				headerRenderer.layoutIndex = layoutIndex;
				if(this._updateForDataReset)
				{
					//see comments in item renderer section below
					headerRenderer.data = null;
					headerRenderer.data = header;
				}
				var storage:HeaderRendererFactoryStorage = this.headerFactoryIDToStorage(headerRenderer.factoryID);
				var activeHeaderRenderers:Vector.<IGroupedListHeaderRenderer> = storage.activeHeaderRenderers;
				var inactiveHeaderRenderers:Vector.<IGroupedListHeaderRenderer> = storage.inactiveHeaderRenderers;
				activeHeaderRenderers[activeHeaderRenderers.length] = headerRenderer;
				var inactiveIndex:int = inactiveHeaderRenderers.indexOf(headerRenderer);
				if(inactiveIndex >= 0)
				{
					inactiveHeaderRenderers.removeAt(inactiveIndex);
				}
				else
				{
					throw new IllegalOperationError("GroupedListDataViewPort: header renderer map contains bad data. This may be caused by duplicate headers in the data provider, which is not allowed.");
				}
				headerRenderer.visible = true;
				this._layoutItems[layoutIndex] = DisplayObject(headerRenderer);
			}
			else
			{
				var pushIndex:int = this._unrenderedHeaders.length;
				this._unrenderedHeaders[pushIndex] = groupIndex;
				pushIndex++;
				this._unrenderedHeaders[pushIndex] = layoutIndex;
			}
		}

		private function findRendererForFooter(footer:Object, groupIndex:int, layoutIndex:int):void
		{
			var footerRenderer:IGroupedListFooterRenderer = this.footerDataToFooterRenderer(footer);
			if(this._footerFactoryIDFunction !== null && footerRenderer !== null)
			{
				var newFactoryID:String = this.getFooterFactoryID(footerRenderer.data, groupIndex);
				if(newFactoryID !== footerRenderer.factoryID)
				{
					footerRenderer = null;
					if(footer is XML || footer is XMLList)
					{
						delete this._footerRendererMap[footer.toXMLString()];
					}
					else
					{
						delete this._footerRendererMap[footer];
					}
				}
			}
			if(footerRenderer !== null)
			{
				footerRenderer.groupIndex = groupIndex;
				footerRenderer.layoutIndex = layoutIndex;
				if(this._updateForDataReset)
				{
					//see comments in item renderer section above
					footerRenderer.data = null;
					footerRenderer.data = footer;
				}
				var storage:FooterRendererFactoryStorage = this.footerFactoryIDToStorage(footerRenderer.factoryID);
				var activeFooterRenderers:Vector.<IGroupedListFooterRenderer> = storage.activeFooterRenderers;
				var inactiveFooterRenderers:Vector.<IGroupedListFooterRenderer> = storage.inactiveFooterRenderers;
				activeFooterRenderers[activeFooterRenderers.length] = footerRenderer;
				var inactiveIndex:int = inactiveFooterRenderers.indexOf(footerRenderer);
				if(inactiveIndex >= 0)
				{
					inactiveFooterRenderers.removeAt(inactiveIndex);
				}
				else
				{
					throw new IllegalOperationError("GroupedListDataViewPort: footer renderer map contains bad data. This may be caused by duplicate footers in the data provider, which is not allowed.");
				}
				footerRenderer.visible = true;
				this._layoutItems[layoutIndex] = DisplayObject(footerRenderer);
			}
			else
			{
				var pushIndex:int = this._unrenderedFooters.length;
				this._unrenderedFooters[pushIndex] = groupIndex;
				pushIndex++;
				this._unrenderedFooters[pushIndex] = layoutIndex;
			}
		}

		private function renderUnrenderedData():void
		{
			LOCATION_HELPER_VECTOR.length = 2;
			var rendererCount:int = this._unrenderedItems.length;
			for(var i:int = 0; i < rendererCount; i += 3)
			{
				var groupIndex:int = this._unrenderedItems.shift();
				var itemIndex:int = this._unrenderedItems.shift();
				var layoutIndex:int = this._unrenderedItems.shift();
				LOCATION_HELPER_VECTOR[0] = groupIndex;
				LOCATION_HELPER_VECTOR[1] = itemIndex;
				var item:Object = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
				var itemRenderer:IGroupedListItemRenderer = this.createItemRenderer(
					item, groupIndex, itemIndex, layoutIndex, true, false);
				this._layoutItems[layoutIndex] = DisplayObject(itemRenderer);
			}

			LOCATION_HELPER_VECTOR.length = 1;
			rendererCount = this._unrenderedHeaders.length;
			for(i = 0; i < rendererCount; i += 2)
			{
				groupIndex = this._unrenderedHeaders.shift();
				layoutIndex = this._unrenderedHeaders.shift();
				LOCATION_HELPER_VECTOR[0] = groupIndex;
				item = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
				item = this._owner.groupToHeaderData(item);
				var headerRenderer:IGroupedListHeaderRenderer = this.createHeaderRenderer(item, groupIndex, layoutIndex, false);
				this._layoutItems[layoutIndex] = DisplayObject(headerRenderer);
			}

			rendererCount = this._unrenderedFooters.length;
			for(i = 0; i < rendererCount; i += 2)
			{
				groupIndex = this._unrenderedFooters.shift();
				layoutIndex = this._unrenderedFooters.shift();
				LOCATION_HELPER_VECTOR[0] = groupIndex;
				item = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
				item = this._owner.groupToFooterData(item);
				var footerRenderer:IGroupedListFooterRenderer = this.createFooterRenderer(item, groupIndex, layoutIndex, false);
				this._layoutItems[layoutIndex] = DisplayObject(footerRenderer);
			}
			LOCATION_HELPER_VECTOR.length = 0;
		}

		private function recoverInactiveItemRenderers(storage:ItemRendererFactoryStorage):void
		{
			var inactiveItemRenderers:Vector.<IGroupedListItemRenderer> = storage.inactiveItemRenderers;
			var rendererCount:int = inactiveItemRenderers.length;
			for(var i:int = 0; i < rendererCount; i++)
			{
				var itemRenderer:IGroupedListItemRenderer = inactiveItemRenderers[i];
				if(!itemRenderer || itemRenderer.groupIndex < 0)
				{
					continue;
				}
				this._owner.dispatchEventWith(FeathersEventType.RENDERER_REMOVE, false, itemRenderer);
				var item:Object = itemRenderer.data;
				if(item is XML || item is XMLList)
				{
					delete this._itemRendererMap[item.toXMLString()];
				}
				else
				{
					delete this._itemRendererMap[item];
				}
			}
		}

		private function recoverInactiveHeaderRenderers(storage:HeaderRendererFactoryStorage):void
		{
			var inactiveHeaderRenderers:Vector.<IGroupedListHeaderRenderer> = storage.inactiveHeaderRenderers;
			var headerRendererCount:int = inactiveHeaderRenderers.length;
			for(var i:int = 0; i < headerRendererCount; i++)
			{
				var headerRenderer:IGroupedListHeaderRenderer = inactiveHeaderRenderers[i];
				if(!headerRenderer)
				{
					continue;
				}
				this._owner.dispatchEventWith(FeathersEventType.RENDERER_REMOVE, false, headerRenderer);
				var headerData:Object = headerRenderer.data;
				if(headerData is XML || headerData is XMLList)
				{
					delete this._headerRendererMap[headerData.toXMLString()];
				}
				else
				{
					delete this._headerRendererMap[headerData];
				}
			}
		}

		private function recoverInactiveFooterRenderers(storage:FooterRendererFactoryStorage):void
		{
			var inactiveFooterRenderers:Vector.<IGroupedListFooterRenderer> = storage.inactiveFooterRenderers;
			var footerRendererCount:int = inactiveFooterRenderers.length;
			for(var i:int = 0; i < footerRendererCount; i++)
			{
				var footerRenderer:IGroupedListFooterRenderer = inactiveFooterRenderers[i];
				if(!footerRenderer)
				{
					continue;
				}
				this._owner.dispatchEventWith(FeathersEventType.RENDERER_REMOVE, false, footerRenderer);
				var footerData:Object = footerRenderer.data;
				if(footerData is XML || footerData is XMLList)
				{
					delete this._footerRendererMap[footerData.toXMLString()];
				}
				else
				{
					delete this._footerRendererMap[footerData];
				}
			}
		}

		private function freeInactiveItemRenderers(storage:ItemRendererFactoryStorage, minimumItemCount:int):void
		{
			var inactiveItemRenderers:Vector.<IGroupedListItemRenderer> = storage.inactiveItemRenderers;
			var activeItemRenderers:Vector.<IGroupedListItemRenderer> = storage.activeItemRenderers;
			var activeItemRenderersCount:int = activeItemRenderers.length;

			//we may keep around some extra renderers to avoid too much
			//allocation and garbage collection. they'll be hidden.
			var keepCount:int = minimumItemCount - activeItemRenderersCount;
			if(keepCount > inactiveItemRenderers.length)
			{
				keepCount = inactiveItemRenderers.length;
			}
			for(var i:int = 0; i < keepCount; i++)
			{
				var itemRenderer:IGroupedListItemRenderer = inactiveItemRenderers.shift();
				itemRenderer.data = null;
				itemRenderer.groupIndex = -1;
				itemRenderer.itemIndex = -1;
				itemRenderer.layoutIndex = -1;
				itemRenderer.visible = false;
				activeItemRenderers[activeItemRenderersCount] = itemRenderer;
				activeItemRenderersCount++;
			}
			var rendererCount:int = inactiveItemRenderers.length;
			for(i = 0; i < rendererCount; i++)
			{
				itemRenderer = inactiveItemRenderers.shift();
				if(!itemRenderer)
				{
					continue;
				}
				this.destroyItemRenderer(itemRenderer);
			}
		}

		private function freeInactiveHeaderRenderers(storage:HeaderRendererFactoryStorage, minimumHeaderCount:int):void
		{
			var inactiveHeaderRenderers:Vector.<IGroupedListHeaderRenderer> = storage.inactiveHeaderRenderers;
			var activeHeaderRenderers:Vector.<IGroupedListHeaderRenderer> = storage.activeHeaderRenderers;
			var activeHeaderRenderersCount:int = activeHeaderRenderers.length;

			var keepCount:int = minimumHeaderCount - activeHeaderRenderersCount;
			if(keepCount > inactiveHeaderRenderers.length)
			{
				keepCount = inactiveHeaderRenderers.length;
			}
			for(var i:int = 0; i < keepCount; i++)
			{
				var headerRenderer:IGroupedListHeaderRenderer = inactiveHeaderRenderers.shift();
				headerRenderer.visible = false;
				headerRenderer.data = null;
				headerRenderer.groupIndex = -1;
				headerRenderer.layoutIndex = -1;
				activeHeaderRenderers[activeHeaderRenderersCount] = headerRenderer;
				activeHeaderRenderersCount++;
			}
			var inactiveHeaderRendererCount:int = inactiveHeaderRenderers.length;
			for(i = 0; i < inactiveHeaderRendererCount; i++)
			{
				headerRenderer = inactiveHeaderRenderers.shift();
				if(!headerRenderer)
				{
					continue;
				}
				this.destroyHeaderRenderer(headerRenderer);
			}
		}

		private function freeInactiveFooterRenderers(storage:FooterRendererFactoryStorage, minimumFooterCount:int):void
		{
			var inactiveFooterRenderers:Vector.<IGroupedListFooterRenderer> = storage.inactiveFooterRenderers;
			var activeFooterRenderers:Vector.<IGroupedListFooterRenderer> = storage.activeFooterRenderers;
			var activeFooterRenderersCount:int = activeFooterRenderers.length;

			var keepCount:int = minimumFooterCount - activeFooterRenderersCount;
			if(keepCount > inactiveFooterRenderers.length)
			{
				keepCount = inactiveFooterRenderers.length;
			}
			for(var i:int = 0; i < keepCount; i++)
			{
				var footerRenderer:IGroupedListFooterRenderer = inactiveFooterRenderers.shift();
				footerRenderer.visible = false;
				footerRenderer.data = null;
				footerRenderer.groupIndex = -1;
				footerRenderer.layoutIndex = -1;
				activeFooterRenderers[activeFooterRenderersCount] = footerRenderer;
				activeFooterRenderersCount++;
			}
			var inactiveFooterRendererCount:int = inactiveFooterRenderers.length;
			for(i = 0; i < inactiveFooterRendererCount; i++)
			{
				footerRenderer = inactiveFooterRenderers.shift();
				if(!footerRenderer)
				{
					continue;
				}
				this.destroyFooterRenderer(footerRenderer);
			}
		}

		private function createItemRenderer(item:Object, groupIndex:int, itemIndex:int,
			layoutIndex:int, useCache:Boolean, isTemporary:Boolean):IGroupedListItemRenderer
		{
			var factoryID:String = this.getFactoryID(item, groupIndex, itemIndex);
			var itemRendererFactory:Function = this.factoryIDToFactory(factoryID, groupIndex, itemIndex);
			var storage:ItemRendererFactoryStorage = this.factoryIDToStorage(factoryID, groupIndex, itemIndex);
			var customStyleName:String = this.indexToCustomStyleName(groupIndex, itemIndex);
			var inactiveItemRenderers:Vector.<IGroupedListItemRenderer> = storage.inactiveItemRenderers;
			var activeItemRenderers:Vector.<IGroupedListItemRenderer> = storage.activeItemRenderers;
			if(!useCache || isTemporary || inactiveItemRenderers.length == 0)
			{
				var itemRenderer:IGroupedListItemRenderer;
				if(itemRendererFactory !== null)
				{
					itemRenderer = IGroupedListItemRenderer(itemRendererFactory());
				}
				else
				{
					var ItemRendererType:Class = this.indexToItemRendererType(groupIndex, itemIndex);
					itemRenderer = IGroupedListItemRenderer(new ItemRendererType());
				}
				var uiRenderer:IFeathersControl = IFeathersControl(itemRenderer);
				if(customStyleName && customStyleName.length > 0)
				{
					uiRenderer.styleNameList.add(customStyleName);
				}
				this.addChild(DisplayObject(itemRenderer));
			}
			else
			{
				itemRenderer = inactiveItemRenderers.shift();
			}
			itemRenderer.data = item;
			itemRenderer.groupIndex = groupIndex;
			itemRenderer.itemIndex = itemIndex;
			itemRenderer.layoutIndex = layoutIndex;
			itemRenderer.owner = this._owner;
			itemRenderer.factoryID = factoryID;
			itemRenderer.visible = true;

			if(!isTemporary)
			{
				if(item is XML || item is XMLList)
				{
					this._itemRendererMap[item.toXMLString()] = itemRenderer;
				}
				else
				{
					this._itemRendererMap[item] = itemRenderer;
				}
				activeItemRenderers.push(itemRenderer);
				itemRenderer.addEventListener(Event.TRIGGERED, renderer_triggeredHandler);
				itemRenderer.addEventListener(Event.CHANGE, renderer_changeHandler);
				itemRenderer.addEventListener(FeathersEventType.RESIZE, itemRenderer_resizeHandler);
				this._owner.dispatchEventWith(FeathersEventType.RENDERER_ADD, false, itemRenderer);
			}

			return itemRenderer;
		}

		private function createHeaderRenderer(header:Object, groupIndex:int, layoutIndex:int, isTemporary:Boolean = false):IGroupedListHeaderRenderer
		{
			var factoryID:String = this.getHeaderFactoryID(header, groupIndex);
			var headerRendererFactory:Function = this.headerFactoryIDToFactory(factoryID);
			var storage:HeaderRendererFactoryStorage = this.headerFactoryIDToStorage(factoryID);
			var inactiveHeaderRenderers:Vector.<IGroupedListHeaderRenderer> = storage.inactiveHeaderRenderers;
			var activeHeaderRenderers:Vector.<IGroupedListHeaderRenderer> = storage.activeHeaderRenderers;
			if(isTemporary || inactiveHeaderRenderers.length == 0)
			{
				var headerRenderer:IGroupedListHeaderRenderer;
				if(headerRendererFactory !== null)
				{
					headerRenderer = IGroupedListHeaderRenderer(headerRendererFactory());
				}
				else
				{
					headerRenderer = IGroupedListHeaderRenderer(new this._headerRendererType());
				}
				var uiRenderer:IFeathersControl = IFeathersControl(headerRenderer);
				if(this._customHeaderRendererStyleName && this._customHeaderRendererStyleName.length > 0)
				{
					uiRenderer.styleNameList.add(this._customHeaderRendererStyleName);
				}
				this.addChild(DisplayObject(headerRenderer));
			}
			else
			{
				headerRenderer = inactiveHeaderRenderers.shift();
			}
			headerRenderer.data = header;
			headerRenderer.groupIndex = groupIndex;
			headerRenderer.layoutIndex = layoutIndex;
			headerRenderer.owner = this._owner;
			headerRenderer.factoryID = factoryID;
			headerRenderer.visible = true;

			if(!isTemporary)
			{
				if(header is XML || header is XMLList)
				{
					this._headerRendererMap[header.toXMLString()] = headerRenderer;
				}
				else
				{
					this._headerRendererMap[header] = headerRenderer;
				}
				activeHeaderRenderers.push(headerRenderer);
				headerRenderer.addEventListener(FeathersEventType.RESIZE, headerRenderer_resizeHandler);
				this._owner.dispatchEventWith(FeathersEventType.RENDERER_ADD, false, headerRenderer);
			}

			return headerRenderer;
		}

		private function createFooterRenderer(footer:Object, groupIndex:int, layoutIndex:int, isTemporary:Boolean = false):IGroupedListFooterRenderer
		{
			var factoryID:String = this.getFooterFactoryID(footer, groupIndex);
			var footerRendererFactory:Function = this.footerFactoryIDToFactory(factoryID);
			var storage:FooterRendererFactoryStorage = this.footerFactoryIDToStorage(factoryID);
			var inactiveFooterRenderers:Vector.<IGroupedListFooterRenderer> = storage.inactiveFooterRenderers;
			var activeFooterRenderers:Vector.<IGroupedListFooterRenderer> = storage.activeFooterRenderers;
			if(isTemporary || inactiveFooterRenderers.length == 0)
			{
				var footerRenderer:IGroupedListFooterRenderer;
				if(footerRendererFactory !== null)
				{
					footerRenderer = IGroupedListFooterRenderer(footerRendererFactory());
				}
				else
				{
					footerRenderer = IGroupedListFooterRenderer(new this._footerRendererType());
				}
				var uiRenderer:IFeathersControl = IFeathersControl(footerRenderer);
				if(this._customFooterRendererStyleName && this._customFooterRendererStyleName.length > 0)
				{
					uiRenderer.styleNameList.add(this._customFooterRendererStyleName);
				}
				this.addChild(DisplayObject(footerRenderer));
			}
			else
			{
				footerRenderer = inactiveFooterRenderers.shift();
			}
			footerRenderer.data = footer;
			footerRenderer.groupIndex = groupIndex;
			footerRenderer.layoutIndex = layoutIndex;
			footerRenderer.owner = this._owner;
			footerRenderer.factoryID = factoryID;
			footerRenderer.visible = true;

			if(!isTemporary)
			{
				if(footer is XML || footer is XMLList)
				{
					this._footerRendererMap[footer.toXMLString()] = footerRenderer;
				}
				else
				{
					this._footerRendererMap[footer] = footerRenderer;
				}
				activeFooterRenderers[activeFooterRenderers.length] = footerRenderer;
				footerRenderer.addEventListener(FeathersEventType.RESIZE, footerRenderer_resizeHandler);
				this._owner.dispatchEventWith(FeathersEventType.RENDERER_ADD, false, footerRenderer);
			}

			return footerRenderer;
		}

		private function destroyItemRenderer(renderer:IGroupedListItemRenderer):void
		{
			renderer.removeEventListener(Event.TRIGGERED, renderer_triggeredHandler);
			renderer.removeEventListener(Event.CHANGE, renderer_changeHandler);
			renderer.removeEventListener(FeathersEventType.RESIZE, itemRenderer_resizeHandler);
			renderer.owner = null;
			renderer.data = null;
			this.removeChild(DisplayObject(renderer), true);
		}

		private function destroyHeaderRenderer(renderer:IGroupedListHeaderRenderer):void
		{
			renderer.removeEventListener(FeathersEventType.RESIZE, headerRenderer_resizeHandler);
			renderer.owner = null;
			renderer.data = null;
			this.removeChild(DisplayObject(renderer), true);
		}

		private function destroyFooterRenderer(renderer:IGroupedListFooterRenderer):void
		{
			renderer.removeEventListener(FeathersEventType.RESIZE, footerRenderer_resizeHandler);
			renderer.owner = null;
			renderer.data = null;
			this.removeChild(DisplayObject(renderer), true);
		}

		private function groupToHeaderDisplayIndex(groupIndex:int):int
		{
			LOCATION_HELPER_VECTOR.length = 1;
			LOCATION_HELPER_VECTOR[0] = groupIndex;
			var group:Object = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
			var header:Object = this._owner.groupToHeaderData(group);
			if(!header)
			{
				LOCATION_HELPER_VECTOR.length = 0;
				return -1;
			}
			LOCATION_HELPER_VECTOR.length = 1;
			var displayIndex:int = 0;
			var groupCount:int = this._dataProvider.getLengthAtLocation();
			for(var i:int = 0; i < groupCount; i++)
			{
				LOCATION_HELPER_VECTOR[0] = i;
				group = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
				header = this._owner.groupToHeaderData(group);
				if(header)
				{
					if(groupIndex == i)
					{
						LOCATION_HELPER_VECTOR.length = 0;
						return displayIndex;
					}
					displayIndex++;
				}
				var groupLength:int = this._dataProvider.getLengthAtLocation(LOCATION_HELPER_VECTOR);
				for(var j:int = 0; j < groupLength; j++)
				{
					displayIndex++;
				}
				var footer:Object = this._owner.groupToFooterData(group);
				if(footer)
				{
					displayIndex++;
				}
			}
			LOCATION_HELPER_VECTOR.length = 0;
			return -1;
		}

		private function groupToFooterDisplayIndex(groupIndex:int):int
		{
			LOCATION_HELPER_VECTOR.length = 1;
			LOCATION_HELPER_VECTOR[0] = groupIndex;
			var group:Object = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
			var footer:Object = this._owner.groupToFooterData(group);
			if(!footer)
			{
				LOCATION_HELPER_VECTOR.length = 0;
				return -1;
			}
			LOCATION_HELPER_VECTOR.length = 1;
			var displayIndex:int = 0;
			var groupCount:int = this._dataProvider.getLengthAtLocation();
			for(var i:int = 0; i < groupCount; i++)
			{
				LOCATION_HELPER_VECTOR[0] = i;
				group = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
				var header:Object = this._owner.groupToHeaderData(group);
				if(header)
				{
					displayIndex++;
				}
				var groupLength:int = this._dataProvider.getLengthAtLocation(LOCATION_HELPER_VECTOR);
				for(var j:int = 0; j < groupLength; j++)
				{
					displayIndex++;
				}
				footer = this._owner.groupToFooterData(group);
				if(footer)
				{
					if(groupIndex == i)
					{
						LOCATION_HELPER_VECTOR.length = 0;
						return displayIndex;
					}
					displayIndex++;
				}
			}
			LOCATION_HELPER_VECTOR.length = 0;
			return -1;
		}

		private function displayIndexToLocation(displayIndex:int, result:Vector.<int>):void
		{
			result.length = 2;
			LOCATION_HELPER_VECTOR.length = 1;
			var totalCount:int = 0;
			var groupCount:int = this._dataProvider.getLengthAtLocation();
			for(var i:int = 0; i < groupCount; i++)
			{
				LOCATION_HELPER_VECTOR[0] = i;
				var group:Object = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
				var header:Object = this._owner.groupToHeaderData(group);
				if(header !== null)
				{
					totalCount++;
				}
				var groupLength:int = this._dataProvider.getLengthAtLocation(LOCATION_HELPER_VECTOR);
				totalCount += groupLength;
				if(totalCount > displayIndex)
				{
					var itemIndex:int = displayIndex - (totalCount - groupLength);
					if(itemIndex == -1)
					{
						result[0] = -1;
						result[1] = -1;
					}
					else
					{
						result[0] = i;
						result[1] = itemIndex;
					}
					LOCATION_HELPER_VECTOR.length = 0;
					return;
				}
				var footer:Object = this._owner.groupToFooterData(group);
				if(footer !== null)
				{
					totalCount++;
				}
			}
			//we didn't find it!
			result[0] = -1;
			result[1] = -1;
			LOCATION_HELPER_VECTOR.length = 0;
		}

		private function locationToDisplayIndex(groupIndex:int, itemIndex:int):int
		{
			LOCATION_HELPER_VECTOR.length = 1;
			var displayIndex:int = 0;
			var groupCount:int = this._dataProvider.getLengthAtLocation();
			for(var i:int = 0; i < groupCount; i++)
			{
				if(itemIndex < 0 && groupIndex == i)
				{
					LOCATION_HELPER_VECTOR.length = 0;
					return displayIndex;
				}
				LOCATION_HELPER_VECTOR[0] = i;
				var group:Object = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
				var header:Object = this._owner.groupToHeaderData(group);
				if(header)
				{
					displayIndex++;
				}
				var groupLength:int = this._dataProvider.getLengthAtLocation(LOCATION_HELPER_VECTOR);
				for(var j:int = 0; j < groupLength; j++)
				{
					if(groupIndex == i && itemIndex == j)
					{
						LOCATION_HELPER_VECTOR.length = 0;
						return displayIndex;
					}
					displayIndex++;
				}
				var footer:Object = this._owner.groupToFooterData(group);
				if(footer)
				{
					displayIndex++;
				}
			}
			LOCATION_HELPER_VECTOR.length = 0;
			return -1;
		}

		private function indexToItemRendererType(groupIndex:int, itemIndex:int):Class
		{
			var groupLength:int = 0;
			if(this._dataProvider !== null && this._dataProvider.getLengthAtLocation() > 0)
			{
				LOCATION_HELPER_VECTOR.length = 1;
				LOCATION_HELPER_VECTOR[0] = groupIndex;
				groupLength = this._dataProvider.getLengthAtLocation(LOCATION_HELPER_VECTOR);
				LOCATION_HELPER_VECTOR.length = 0;
			}
			if(itemIndex == 0)
			{
				if(this._singleItemRendererType !== null && groupLength == 1)
				{
					return this._singleItemRendererType;
				}
				else if(this._firstItemRendererType !== null)
				{
					return this._firstItemRendererType;
				}
			}
			if(this._lastItemRendererType !== null && itemIndex == (groupLength - 1))
			{
				return this._lastItemRendererType;
			}
			return this._itemRendererType;
		}

		private function indexToCustomStyleName(groupIndex:int, itemIndex:int):String
		{
			var groupLength:int = 0;
			if(this._dataProvider !== null && this._dataProvider.getLengthAtLocation() > 0)
			{
				LOCATION_HELPER_VECTOR.length = 1;
				LOCATION_HELPER_VECTOR[0] = groupIndex;
				groupLength = this._dataProvider.getLengthAtLocation(LOCATION_HELPER_VECTOR);
				LOCATION_HELPER_VECTOR.length = 0;
			}
			if(itemIndex == 0)
			{
				if(this._customSingleItemRendererStyleName !== null && groupLength == 1)
				{
					return this._customSingleItemRendererStyleName;
				}
				else if(this._customFirstItemRendererStyleName !== null)
				{
					return this._customFirstItemRendererStyleName;
				}
			}
			if(this._customLastItemRendererStyleName !== null && itemIndex == (groupLength - 1))
			{
				return this._customLastItemRendererStyleName;
			}
			return this._customItemRendererStyleName;
		}

		private function getFactoryID(item:Object, groupIndex:int, itemIndex:int):String
		{
			var factoryID:String = null;
			if(this._factoryIDFunction !== null)
			{
				if(this._factoryIDFunction.length == 1)
				{
					factoryID = this._factoryIDFunction(item);
				}
				else
				{
					factoryID = this._factoryIDFunction(item, groupIndex, itemIndex);
				}
			}
			if(factoryID !== null)
			{
				return factoryID;
			}
			var groupLength:int = 0;
			if(this._dataProvider !== null && this._dataProvider.getLengthAtLocation() > 0)
			{
				LOCATION_HELPER_VECTOR.length = 1;
				LOCATION_HELPER_VECTOR[0] = groupIndex;
				groupLength = this._dataProvider.getLengthAtLocation(LOCATION_HELPER_VECTOR);
				LOCATION_HELPER_VECTOR.length = 0;
			}
			if(itemIndex == 0)
			{
				if((this._singleItemRendererType !== null ||
					this._singleItemRendererFactory !== null ||
					this._customSingleItemRendererStyleName !== null) &&
					groupLength == 1)
				{
					return SINGLE_ITEM_RENDERER_FACTORY_ID;
				}
				else if(this._firstItemRendererType !== null || this._firstItemRendererFactory !== null || this._customFirstItemRendererStyleName !== null)
				{
					return FIRST_ITEM_RENDERER_FACTORY_ID;
				}
			}
			if((this._lastItemRendererType !== null ||
				this._lastItemRendererFactory !== null ||
				this._customLastItemRendererStyleName !== null) &&
				itemIndex == (groupLength - 1))
			{
				return LAST_ITEM_RENDERER_FACTORY_ID;
			}
			return null;
		}

		private function factoryIDToFactory(id:String, groupIndex:int, itemIndex:int):Function
		{
			if(id !== null)
			{
				if(id === FIRST_ITEM_RENDERER_FACTORY_ID)
				{
					if(this._firstItemRendererFactory !== null)
					{
						return this._firstItemRendererFactory;
					}
					else
					{
						return this._itemRendererFactory;
					}
				}
				else if(id === LAST_ITEM_RENDERER_FACTORY_ID)
				{
					if(this._lastItemRendererFactory !== null)
					{
						return this._lastItemRendererFactory;
					}
					else
					{
						return this._itemRendererFactory;
					}
				}
				else if(id === SINGLE_ITEM_RENDERER_FACTORY_ID)
				{
					if(this._singleItemRendererFactory !== null)
					{
						return this._singleItemRendererFactory;
					}
					else
					{
						return this._itemRendererFactory;
					}
				}
				if(id in this._itemRendererFactories)
				{
					return this._itemRendererFactories[id] as Function;
				}
				else
				{
					throw new ReferenceError("Cannot find item renderer factory for ID \"" + id + "\".");
				}
			}
			return this._itemRendererFactory;
		}

		private function factoryIDToStorage(id:String, groupIndex:int, itemIndex:int):ItemRendererFactoryStorage
		{
			if(id !== null)
			{
				if(id in this._itemStorageMap)
				{
					return ItemRendererFactoryStorage(this._itemStorageMap[id]);
				}
				var storage:ItemRendererFactoryStorage = new ItemRendererFactoryStorage();
				this._itemStorageMap[id] = storage;
				return storage;
			}
			return this._defaultItemRendererStorage;
		}

		private function getHeaderFactoryID(header:Object, groupIndex:int):String
		{
			if(this._headerFactoryIDFunction === null)
			{
				return null;
			}
			if(this._headerFactoryIDFunction.length == 1)
			{
				return this._headerFactoryIDFunction(header);
			}
			return this._headerFactoryIDFunction(header, groupIndex);
		}

		private function getFooterFactoryID(footer:Object, groupIndex:int):String
		{
			if(this._footerFactoryIDFunction === null)
			{
				return null;
			}
			if(this._footerFactoryIDFunction.length == 1)
			{
				return this._footerFactoryIDFunction(footer);
			}
			return this._footerFactoryIDFunction(footer, groupIndex);
		}

		private function headerFactoryIDToFactory(id:String):Function
		{
			if(id !== null)
			{
				if(id in this._headerRendererFactories)
				{
					return this._headerRendererFactories[id] as Function;
				}
				else
				{
					throw new ReferenceError("Cannot find header renderer factory for ID \"" + id + "\".");
				}
			}
			return this._headerRendererFactory;
		}

		private function headerFactoryIDToStorage(id:String):HeaderRendererFactoryStorage
		{
			if(id !== null)
			{
				if(id in this._headerStorageMap)
				{
					return HeaderRendererFactoryStorage(this._headerStorageMap[id]);
				}
				var storage:HeaderRendererFactoryStorage = new HeaderRendererFactoryStorage();
				this._headerStorageMap[id] = storage;
				return storage;
			}
			return this._defaultHeaderRendererStorage;
		}

		private function footerFactoryIDToFactory(id:String):Function
		{
			if(id !== null)
			{
				if(id in this._footerRendererFactories)
				{
					return this._footerRendererFactories[id] as Function;
				}
				else
				{
					throw new ReferenceError("Cannot find footer renderer factory for ID \"" + id + "\".");
				}
			}
			return this._footerRendererFactory;
		}

		private function footerFactoryIDToStorage(id:String):FooterRendererFactoryStorage
		{
			if(id !== null)
			{
				if(id in this._footerStorageMap)
				{
					return FooterRendererFactoryStorage(this._footerStorageMap[id]);
				}
				var storage:FooterRendererFactoryStorage = new FooterRendererFactoryStorage();
				this._footerStorageMap[id] = storage;
				return storage;
			}
			return this._defaultFooterRendererStorage;
		}

		private function childProperties_onChange(proxy:PropertyProxy, name:String):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		private function dataProvider_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private function dataProvider_addItemHandler(event:Event, indices:Array):void
		{
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			var groupIndex:int = indices[0] as int;
			if(indices.length > 1) //adding an item
			{
				var itemIndex:int = indices[1] as int;
				var itemDisplayIndex:int = this.locationToDisplayIndex(groupIndex, itemIndex);
				layout.addToVariableVirtualCacheAtIndex(itemDisplayIndex);
			}
			else //adding a whole group
			{
				var headerDisplayIndex:int = this.groupToHeaderDisplayIndex(groupIndex);
				if(headerDisplayIndex >= 0)
				{
					layout.addToVariableVirtualCacheAtIndex(headerDisplayIndex);
				}
				LOCATION_HELPER_VECTOR.length = 1;
				LOCATION_HELPER_VECTOR[0] = groupIndex;
				var groupLength:int = this._dataProvider.getLengthAtLocation(LOCATION_HELPER_VECTOR);
				LOCATION_HELPER_VECTOR.length = 0;
				if(groupLength > 0)
				{
					var displayIndex:int = headerDisplayIndex;
					if(displayIndex < 0)
					{
						displayIndex = this.locationToDisplayIndex(groupIndex, 0);
					}
					groupLength += displayIndex;
					for(var i:int = displayIndex; i < groupLength; i++)
					{
						layout.addToVariableVirtualCacheAtIndex(displayIndex);
					}
				}
				var footerDisplayIndex:int = this.groupToFooterDisplayIndex(groupIndex);
				if(footerDisplayIndex >= 0)
				{
					layout.addToVariableVirtualCacheAtIndex(footerDisplayIndex);
				}
			}
		}

		private function dataProvider_removeItemHandler(event:Event, indices:Array):void
		{
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			var groupIndex:int = indices[0] as int;
			if(indices.length > 1) //removing an item
			{
				var itemIndex:int = indices[1] as int;
				var displayIndex:int = this.locationToDisplayIndex(groupIndex, itemIndex);
				layout.removeFromVariableVirtualCacheAtIndex(displayIndex);
			}
			else //removing a whole group
			{
				//TODO: figure out the length of the previous group so that we
				//don't need to reset the whole cache
				layout.resetVariableVirtualCache();
			}
		}

		private function dataProvider_replaceItemHandler(event:Event, indices:Array):void
		{
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			var groupIndex:int = indices[0] as int;
			if(indices.length > 1) //replacing an item
			{
				var itemIndex:int = indices[1] as int;
				var displayIndex:int = this.locationToDisplayIndex(groupIndex, itemIndex);
				layout.resetVariableVirtualCacheAtIndex(displayIndex);
			}
			else //replacing a whole group
			{
				//TODO: figure out the length of the previous group so that we
				//don't need to reset the whole cache
				layout.resetVariableVirtualCache();
			}
		}

		private function dataProvider_resetHandler(event:Event):void
		{
			this._updateForDataReset = true;

			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			layout.resetVariableVirtualCache();
		}

		private function dataProvider_updateItemHandler(event:Event, indices:Array):void
		{
			var groupIndex:int = indices[0] as int;
			if(indices.length > 1) //updating a single item
			{
				var itemIndex:int = indices[1] as int;
				LOCATION_HELPER_VECTOR.length = 2;
				LOCATION_HELPER_VECTOR[0] = groupIndex;
				LOCATION_HELPER_VECTOR[1] = itemIndex;
				var item:Object = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
				LOCATION_HELPER_VECTOR.length = 0;
				var itemRenderer:IGroupedListItemRenderer = this.itemToItemRenderer(item);
				if(itemRenderer !== null)
				{
					//in order to display the same item with modified properties, this
					//hack tricks the item renderer into thinking that it has been given
					//a different item to render.
					itemRenderer.data = null;
					itemRenderer.data = item;
					if(this._explicitVisibleWidth !== this._explicitVisibleWidth || //isNaN
						this._explicitVisibleHeight !== this._explicitVisibleHeight) //isNaN
					{
						this.invalidate(INVALIDATION_FLAG_SIZE);
						this.invalidateParent(INVALIDATION_FLAG_SIZE);
					}
				}
			}
			else //updating a whole group
			{
				LOCATION_HELPER_VECTOR.length = 1;
				LOCATION_HELPER_VECTOR[0] = groupIndex;
				var groupLength:int = this._dataProvider.getLengthAtLocation(LOCATION_HELPER_VECTOR);
				LOCATION_HELPER_VECTOR.length = 2;
				for(var i:int = 0; i < groupLength; i++)
				{
					LOCATION_HELPER_VECTOR[1] = i;
					item = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
					if(item !== null)
					{
						itemRenderer = this.itemToItemRenderer(item);
						if(itemRenderer !== null)
						{
							itemRenderer.data = null;
							itemRenderer.data = item;
						}
					}
				}
				LOCATION_HELPER_VECTOR.length = 1;
				var group:Object = this._dataProvider.getItemAtLocation(LOCATION_HELPER_VECTOR);
				LOCATION_HELPER_VECTOR.length = 0;
				item = this._owner.groupToHeaderData(group);
				if(item)
				{
					var headerRenderer:IGroupedListHeaderRenderer = this.headerDataToHeaderRenderer(item);
					if(headerRenderer)
					{
						headerRenderer.data = null;
						headerRenderer.data = item;
					}
				}
				item = this._owner.groupToFooterData(group);
				if(item)
				{
					var footerRenderer:IGroupedListFooterRenderer = this.footerDataToFooterRenderer(item);
					if(footerRenderer)
					{
						footerRenderer.data = null;
						footerRenderer.data = item;
					}
				}

				//we need to invalidate because the group may have more or fewer items
				this.invalidate(INVALIDATION_FLAG_DATA);

				var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
				if(layout === null || !layout.hasVariableItemDimensions)
				{
					return;
				}
				//TODO: figure out the length of the previous group so that we
				//don't need to reset the whole cache
				layout.resetVariableVirtualCache();
			}
		}

		private function dataProvider_updateAllHandler(event:Event):void
		{
			//we're treating this similar to the RESET event because enough
			//users are treating UPDATE_ALL similarly. technically, UPDATE_ALL
			//is supposed to affect only existing items, but it's confusing when
			//new items are added and not displayed.
			this._updateForDataReset = true;
			this.invalidate(INVALIDATION_FLAG_DATA);

			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			layout.resetVariableVirtualCache();
		}

		private function layout_changeHandler(event:Event):void
		{
			if(this._ignoreLayoutChanges)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
			this.invalidateParent(INVALIDATION_FLAG_LAYOUT);
		}

		private function itemRenderer_resizeHandler(event:Event):void
		{
			if(this._ignoreRendererResizing)
			{
				return;
			}
			if(event.currentTarget === this._typicalItemRenderer && !this._typicalItemIsInDataProvider)
			{
				return;
			}
			var renderer:IGroupedListItemRenderer = IGroupedListItemRenderer(event.currentTarget);
			if(renderer.layoutIndex < 0)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
			this.invalidateParent(INVALIDATION_FLAG_LAYOUT);
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			layout.resetVariableVirtualCacheAtIndex(renderer.layoutIndex, DisplayObject(renderer));
		}

		private function headerRenderer_resizeHandler(event:Event):void
		{
			if(this._ignoreRendererResizing)
			{
				return;
			}
			var renderer:IGroupedListHeaderRenderer = IGroupedListHeaderRenderer(event.currentTarget);
			if(renderer.layoutIndex < 0)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
			this.invalidateParent(INVALIDATION_FLAG_LAYOUT);
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			layout.resetVariableVirtualCacheAtIndex(renderer.layoutIndex, DisplayObject(renderer));
		}

		private function footerRenderer_resizeHandler(event:Event):void
		{
			if(this._ignoreRendererResizing)
			{
				return;
			}
			var renderer:IGroupedListFooterRenderer = IGroupedListFooterRenderer(event.currentTarget);
			if(renderer.layoutIndex < 0)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
			this.invalidateParent(INVALIDATION_FLAG_LAYOUT);
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			layout.resetVariableVirtualCacheAtIndex(renderer.layoutIndex, DisplayObject(renderer));
		}

		private function renderer_triggeredHandler(event:Event):void
		{
			var renderer:IGroupedListItemRenderer = IGroupedListItemRenderer(event.currentTarget);
			this.parent.dispatchEventWith(Event.TRIGGERED, false, renderer.data);
		}

		private function renderer_changeHandler(event:Event):void
		{
			if(this._ignoreSelectionChanges)
			{
				return;
			}
			var renderer:IGroupedListItemRenderer = IGroupedListItemRenderer(event.currentTarget);
			if(!this._isSelectable || this._owner.isScrolling)
			{
				renderer.isSelected = false;
				return;
			}
			if(renderer.isSelected)
			{
				this.setSelectedLocation(renderer.groupIndex, renderer.itemIndex);
			}
			else
			{
				this.setSelectedLocation(-1, -1);
			}
		}
	}
}

import feathers.controls.renderers.IGroupedListFooterRenderer;
import feathers.controls.renderers.IGroupedListHeaderRenderer;
import feathers.controls.renderers.IGroupedListItemRenderer;

class ItemRendererFactoryStorage
{
	public function ItemRendererFactoryStorage()
	{

	}

	public var activeItemRenderers:Vector.<IGroupedListItemRenderer> = new <IGroupedListItemRenderer>[];
	public var inactiveItemRenderers:Vector.<IGroupedListItemRenderer> = new <IGroupedListItemRenderer>[];
}

class HeaderRendererFactoryStorage
{
	public function HeaderRendererFactoryStorage()
	{

	}

	public var activeHeaderRenderers:Vector.<IGroupedListHeaderRenderer> = new <IGroupedListHeaderRenderer>[];
	public var inactiveHeaderRenderers:Vector.<IGroupedListHeaderRenderer> = new <IGroupedListHeaderRenderer>[];
}

class FooterRendererFactoryStorage
{
	public function FooterRendererFactoryStorage()
	{

	}

	public var activeFooterRenderers:Vector.<IGroupedListFooterRenderer> = new <IGroupedListFooterRenderer>[];
	public var inactiveFooterRenderers:Vector.<IGroupedListFooterRenderer> = new <IGroupedListFooterRenderer>[];
}


================================================
FILE: source/feathers/controls/supportClasses/IScreenNavigatorItem.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.supportClasses
{
	import starling.display.DisplayObject;

	/**
	 * @private
	 * A simple interface for screen navigator items to be used by
	 * <code>BaseScreenNavigator</code>.
	 *
	 * @see BaseScreenNavigator
	 *
	 * @productversion Feathers 2.1.0
	 */
	public interface IScreenNavigatorItem
	{
		/**
		 * An optional event that the screen will dispatch when it's ready for
		 * the transition to start. If <code>null</code>, the transition will
		 * start immediately.
		 *
		 * <p>Useful for loading assets or doing other long tasks to prepare
		 * the screen before it is shown. It is recommended to display some
		 * kind of progress indicator over the previous screen during this
		 * delay to ensure that users don't get confused and think that the
		 * app has frozen.</p>
		 */
		function get transitionDelayEvent():String;

		/**
		 * Determines if a display object returned by <code>getScreen()</code>
		 * can be disposed or not when a screen is no longer active.
		 *
		 * @see #getScreen()
		 */
		function get canDispose():Boolean;

		/**
		 * Returns a display object instance of this screen.
		 */
		function getScreen():DisplayObject;
	}
}


================================================
FILE: source/feathers/controls/supportClasses/IViewPort.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.supportClasses
{
	import feathers.core.IFeathersControl;

	/**
	 * Interface used for the view port of scrolling containers.
	 *
	 * @see feathers.controls.Scroller
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface IViewPort extends IFeathersControl
	{
		function get visibleWidth():Number;
		function set visibleWidth(value:Number):void;
		function get minVisibleWidth():Number;
		function set minVisibleWidth(value:Number):void;
		function get maxVisibleWidth():Number;
		function set maxVisibleWidth(value:Number):void;
		function get visibleHeight():Number;
		function set visibleHeight(value:Number):void;
		function get minVisibleHeight():Number;
		function set minVisibleHeight(value:Number):void;
		function get maxVisibleHeight():Number;
		function set maxVisibleHeight(value:Number):void;

		function get contentX():Number;
		function get contentY():Number;

		function get horizontalScrollPosition():Number;
		function set horizontalScrollPosition(value:Number):void;
		function get verticalScrollPosition():Number;
		function set verticalScrollPosition(value:Number):void;
		function get horizontalScrollStep():Number;
		function get verticalScrollStep():Number;

		function get requiresMeasurementOnScroll():Boolean;
	}
}


================================================
FILE: source/feathers/controls/supportClasses/LayoutViewPort.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.supportClasses
{
	import feathers.controls.AutoSizeMode;
	import feathers.controls.LayoutGroup;
	import feathers.core.IValidating;
	import feathers.layout.ILayoutDisplayObject;

	import starling.display.DisplayObject;

	/**
	 * @private
	 * Used internally by ScrollContainer. Not meant to be used on its own.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class LayoutViewPort extends LayoutGroup implements IViewPort
	{
		public function LayoutViewPort()
		{
		}

		private var _actualMinVisibleWidth:Number = 0;

		private var _explicitMinVisibleWidth:Number;

		public function get minVisibleWidth():Number
		{
			if(this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth) //isNaN
			{
				return this._actualMinVisibleWidth;
			}
			return this._explicitMinVisibleWidth;
		}

		public function set minVisibleWidth(value:Number):void
		{
			if(this._explicitMinVisibleWidth == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth) //isNaN
			{
				return;
			}
			var oldValue:Number = this._explicitMinVisibleWidth;
			this._explicitMinVisibleWidth = value;
			if(valueIsNaN)
			{
				this._actualMinVisibleWidth = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this._actualMinVisibleWidth = value;
				if(this._explicitVisibleWidth !== this._explicitVisibleWidth && //isNaN
					(this._actualVisibleWidth < value || this._actualVisibleWidth == oldValue))
				{
					//only invalidate if this change might affect the visibleWidth
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		private var _maxVisibleWidth:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleWidth():Number
		{
			return this._maxVisibleWidth;
		}

		public function set maxVisibleWidth(value:Number):void
		{
			if(this._maxVisibleWidth == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleWidth cannot be NaN");
			}
			var oldValue:Number = this._maxVisibleWidth;
			this._maxVisibleWidth = value;
			if(this._explicitVisibleWidth !== this._explicitVisibleWidth && //isNaN
				(this._actualVisibleWidth > value || this._actualVisibleWidth == oldValue))
			{
				//only invalidate if this change might affect the visibleWidth
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualVisibleWidth:Number = 0;

		private var _explicitVisibleWidth:Number;

		public function get visibleWidth():Number
		{
			if(this._explicitVisibleWidth !== this._explicitVisibleWidth) //isNaN
			{
				return this._actualVisibleWidth;
			}
			return this._explicitVisibleWidth;
		}

		public function set visibleWidth(value:Number):void
		{
			if(this._explicitVisibleWidth == value ||
				(value !== value && this._explicitVisibleWidth !== this._explicitVisibleWidth)) //isNaN
			{
				return;
			}
			this._explicitVisibleWidth = value;
			if(this._actualVisibleWidth != value)
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualMinVisibleHeight:Number = 0;

		private var _explicitMinVisibleHeight:Number;

		public function get minVisibleHeight():Number
		{
			if(this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight) //isNaN
			{
				return this._actualMinVisibleHeight;
			}
			return this._explicitMinVisibleHeight;
		}

		public function set minVisibleHeight(value:Number):void
		{
			if(this._explicitMinVisibleHeight == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight) //isNaN
			{
				return;
			}
			var oldValue:Number = this._explicitMinVisibleHeight;
			this._explicitMinVisibleHeight = value;
			if(valueIsNaN)
			{
				this._actualMinVisibleHeight = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this._actualMinVisibleHeight = value;
				if(this._explicitVisibleHeight !== this._explicitVisibleHeight && //isNaN
					(this._actualVisibleHeight < value || this._actualVisibleHeight == oldValue))
				{
					//only invalidate if this change might affect the visibleHeight
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		private var _maxVisibleHeight:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleHeight():Number
		{
			return this._maxVisibleHeight;
		}

		public function set maxVisibleHeight(value:Number):void
		{
			if(this._maxVisibleHeight == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleHeight cannot be NaN");
			}
			var oldValue:Number = this._maxVisibleHeight;
			this._maxVisibleHeight = value;
			if(this._explicitVisibleHeight !== this._explicitVisibleHeight && //isNaN
				(this._actualVisibleHeight > value || this._actualVisibleHeight == oldValue))
			{
				//only invalidate if this change might affect the visibleHeight
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualVisibleHeight:Number = 0;

		private var _explicitVisibleHeight:Number;

		public function get visibleHeight():Number
		{
			if(this._explicitVisibleHeight !== this._explicitVisibleHeight) //isNaN
			{
				return this._actualVisibleHeight;
			}
			return this._explicitVisibleHeight;
		}

		public function set visibleHeight(value:Number):void
		{
			if(this._explicitVisibleHeight == value ||
				(value !== value && this._explicitVisibleHeight !== this._explicitVisibleHeight)) //isNaN
			{
				return;
			}
			this._explicitVisibleHeight = value;
			if(this._actualVisibleHeight != value)
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _contentX:Number = 0;

		public function get contentX():Number
		{
			return this._contentX;
		}

		private var _contentY:Number = 0;

		public function get contentY():Number
		{
			return this._contentY;
		}

		public function get horizontalScrollStep():Number
		{
			if(this.actualWidth < this.actualHeight)
			{
				return this.actualWidth / 10;
			}
			return this.actualHeight / 10;
		}

		public function get verticalScrollStep():Number
		{
			if(this.actualWidth < this.actualHeight)
			{
				return this.actualWidth / 10;
			}
			return this.actualHeight / 10;
		}

		private var _horizontalScrollPosition:Number = 0;

		public function get horizontalScrollPosition():Number
		{
			return this._horizontalScrollPosition;
		}

		public function set horizontalScrollPosition(value:Number):void
		{
			if(this._horizontalScrollPosition == value)
			{
				return;
			}
			this._horizontalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		private var _verticalScrollPosition:Number = 0;

		public function get verticalScrollPosition():Number
		{
			return this._verticalScrollPosition;
		}

		public function set verticalScrollPosition(value:Number):void
		{
			if(this._verticalScrollPosition == value)
			{
				return;
			}
			this._verticalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		public function get requiresMeasurementOnScroll():Boolean
		{
			return this._layout !== null && this._layout.requiresLayoutOnScroll &&
				(this._explicitVisibleWidth !== this._explicitVisibleWidth || //isNaN
				this._explicitVisibleHeight !== this._explicitVisibleHeight); //isNaN
		}

		override public function dispose():void
		{
			this.layout = null;
			super.dispose();
		}

		override protected function refreshViewPortBounds():void
		{
			var needsWidth:Boolean = this._explicitVisibleWidth !== this._explicitVisibleWidth; //isNaN
			var needsHeight:Boolean = this._explicitVisibleHeight !== this._explicitVisibleHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight; //isNaN

			this.viewPortBounds.x = 0;
			this.viewPortBounds.y = 0;
			this.viewPortBounds.scrollX = this._horizontalScrollPosition;
			this.viewPortBounds.scrollY = this._verticalScrollPosition;
			if(this._autoSizeMode === AutoSizeMode.STAGE && needsWidth)
			{
				this.viewPortBounds.explicitWidth = this.stage.stageWidth;
			}
			else
			{
				//layouts can handle NaN for explicit dimensions
				this.viewPortBounds.explicitWidth = this._explicitVisibleWidth;
			}
			if(this._autoSizeMode === AutoSizeMode.STAGE && needsHeight)
			{
				this.viewPortBounds.explicitHeight = this.stage.stageHeight;
			}
			else
			{
				//layouts can handle NaN for explicit dimensions
				this.viewPortBounds.explicitHeight = this._explicitVisibleHeight;
			}
			if(needsMinWidth)
			{
				//layouts don't expect NaN for minimum dimensions
				this.viewPortBounds.minWidth = 0;
			}
			else
			{
				this.viewPortBounds.minWidth = this._explicitMinVisibleWidth;
			}
			if(needsMinHeight)
			{
				//layouts don't expect NaN for minimum dimensions
				this.viewPortBounds.minHeight = 0;
			}
			else
			{
				this.viewPortBounds.minHeight = this._explicitMinVisibleHeight;
			}
			this.viewPortBounds.maxWidth = this._maxVisibleWidth;
			this.viewPortBounds.maxHeight = this._maxVisibleHeight;
		}

		override protected function handleLayoutResult():void
		{
			var contentWidth:Number = this._layoutResult.contentWidth;
			var contentHeight:Number = this._layoutResult.contentHeight;
			this.saveMeasurements(contentWidth, contentHeight,
				contentWidth, contentHeight);
			this._contentX = this._layoutResult.contentX;
			this._contentY = this._layoutResult.contentY;
			var viewPortWidth:Number = this._layoutResult.viewPortWidth;
			var viewPortHeight:Number = this._layoutResult.viewPortHeight;
			this._actualVisibleWidth = viewPortWidth;
			this._actualVisibleHeight = viewPortHeight;
			this._actualMinVisibleWidth = viewPortWidth;
			this._actualMinVisibleHeight = viewPortHeight;
		}

		override protected function handleManualLayout():void
		{
			var minX:Number = 0;
			var minY:Number = 0;
			var explicitViewPortWidth:Number = this.viewPortBounds.explicitWidth;
			var maxX:Number = explicitViewPortWidth;
			//for some reason, if we don't call a function right here,
			//compiling with the flex 4.6 SDK will throw a VerifyError
			//for a stack overflow.
			//we could change the !== check back to isNaN() instead, but
			//isNaN() can allocate an object, so we should call a different
			//function without allocation.
			this.doNothing();
			if(maxX !== maxX) //isNaN
			{
				maxX = 0;
			}
			var explicitViewPortHeight:Number = this.viewPortBounds.explicitHeight;
			var maxY:Number = explicitViewPortHeight;
			//see explanation above the previous call to this function.
			this.doNothing();
			if(maxY !== maxY) //isNaN
			{
				maxY = 0;
			}
			this._ignoreChildChanges = true;
			var itemCount:int = this.items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = this.items[i];
				if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
				{
					continue;
				}
				if(item is IValidating)
				{
					IValidating(item).validate();
				}
				var itemX:Number = item.x - item.pivotX * item.scaleX;
				var itemY:Number = item.y - item.pivotY * item.scaleY;
				var itemMaxX:Number = itemX + item.width;
				var itemMaxY:Number = itemY + item.height;
				if(itemX === itemX && //!isNaN
					itemX < minX)
				{
					minX = itemX;
				}
				if(itemY === itemY && //!isNaN
					itemY < minY)
				{
					minY = itemY;
				}
				if(itemMaxX === itemMaxX && //!isNaN
					itemMaxX > maxX)
				{
					maxX = itemMaxX;
				}
				if(itemMaxY === itemMaxY && //!isNaN
					itemMaxY > maxY)
				{
					maxY = itemMaxY;
				}
			}
			var minWidth:Number = this.viewPortBounds.minWidth;
			var maxWidth:Number = this.viewPortBounds.maxWidth;
			var minHeight:Number = this.viewPortBounds.minHeight;
			var maxHeight:Number = this.viewPortBounds.maxHeight;
			var calculatedWidth:Number = maxX - minX;
			if(calculatedWidth < minWidth)
			{
				calculatedWidth = minWidth;
			}
			else if(calculatedWidth > maxWidth)
			{
				calculatedWidth = maxWidth;
			}
			var calculatedHeight:Number = maxY - minY;
			if(calculatedHeight < minHeight)
			{
				calculatedHeight = minHeight;
			}
			else if(calculatedHeight > maxHeight)
			{
				calculatedHeight = maxHeight;
			}
			this._ignoreChildChanges = false;
			if(explicitViewPortWidth !== explicitViewPortWidth) //isNaN
			{
				this._actualVisibleWidth = calculatedWidth;
			}
			else
			{
				this._actualVisibleWidth = explicitViewPortWidth;
			}
			if(explicitViewPortHeight !== explicitViewPortHeight) //isNaN
			{
				this._actualVisibleHeight = calculatedHeight;
			}
			else
			{
				this._actualVisibleHeight = explicitViewPortHeight;
			}
			this._layoutResult.contentX = minX;
			this._layoutResult.contentY = minY;
			this._layoutResult.contentWidth = calculatedWidth;
			this._layoutResult.contentHeight = calculatedHeight;
			this._layoutResult.viewPortWidth = calculatedWidth;
			this._layoutResult.viewPortHeight = calculatedHeight;
		}

		/**
		 * @private
		 * This function is here to work around a bug in the Flex 4.6 SDK
		 * compiler. For explanation, see the places where it gets called.
		 */
		protected function doNothing():void {}
	}
}


================================================
FILE: source/feathers/controls/supportClasses/ListDataViewPort.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.supportClasses
{
	import feathers.controls.List;
	import feathers.controls.Scroller;
	import feathers.controls.renderers.IDragAndDropItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IValidating;
	import feathers.core.PropertyProxy;
	import feathers.data.IListCollection;
	import feathers.data.ListCollection;
	import feathers.display.RenderDelegate;
	import feathers.dragDrop.DragData;
	import feathers.dragDrop.DragDropManager;
	import feathers.events.CollectionEventType;
	import feathers.events.DragDropEvent;
	import feathers.events.ExclusiveTouch;
	import feathers.events.FeathersEventType;
	import feathers.layout.IDragDropLayout;
	import feathers.layout.ILayout;
	import feathers.layout.ISpinnerLayout;
	import feathers.layout.ITrimmedVirtualLayout;
	import feathers.layout.IVariableVirtualLayout;
	import feathers.layout.IVirtualLayout;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.ViewPortBounds;
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.system.DeviceCapabilities;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;
	import flash.utils.Dictionary;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.EnterFrameEvent;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * @private
	 * Used internally by List. Not meant to be used on its own.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class ListDataViewPort extends FeathersControl implements IViewPort
	{
		private static const INVALIDATION_FLAG_ITEM_RENDERER_FACTORY:String = "itemRendererFactory";

		private static const HELPER_VECTOR:Vector.<int> = new <int>[];

		public function ListDataViewPort()
		{
			super();
		}

		private var _viewPortBounds:ViewPortBounds = new ViewPortBounds();

		private var _layoutResult:LayoutBoundsResult = new LayoutBoundsResult();

		private var _actualMinVisibleWidth:Number = 0;

		private var _explicitMinVisibleWidth:Number;

		public function get minVisibleWidth():Number
		{
			if(this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth) //isNaN
			{
				return this._actualMinVisibleWidth;
			}
			return this._explicitMinVisibleWidth;
		}

		public function set minVisibleWidth(value:Number):void
		{
			if(this._explicitMinVisibleWidth == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth) //isNaN
			{
				return;
			}
			var oldValue:Number = this._explicitMinVisibleWidth;
			this._explicitMinVisibleWidth = value;
			if(valueIsNaN)
			{
				this._actualMinVisibleWidth = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this._actualMinVisibleWidth = value;
				if(this.explicitVisibleWidth !== this.explicitVisibleWidth && //isNaN
					(this.actualVisibleWidth < value || this.actualVisibleWidth == oldValue))
				{
					//only invalidate if this change might affect the visibleWidth
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		private var _maxVisibleWidth:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleWidth():Number
		{
			return this._maxVisibleWidth;
		}

		public function set maxVisibleWidth(value:Number):void
		{
			if(this._maxVisibleWidth == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleWidth cannot be NaN");
			}
			var oldValue:Number = this._maxVisibleWidth;
			this._maxVisibleWidth = value;
			if(this.explicitVisibleWidth !== this.explicitVisibleWidth && //isNaN
				(this.actualVisibleWidth > value || this.actualVisibleWidth == oldValue))
			{
				//only invalidate if this change might affect the visibleWidth
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var actualVisibleWidth:Number = 0;

		private var explicitVisibleWidth:Number = NaN;

		public function get visibleWidth():Number
		{
			return this.actualVisibleWidth;
		}

		public function set visibleWidth(value:Number):void
		{
			if(this.explicitVisibleWidth == value ||
				(value !== value && this.explicitVisibleWidth !== this.explicitVisibleWidth)) //isNaN
			{
				return;
			}
			this.explicitVisibleWidth = value;
			if(this.actualVisibleWidth != value)
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualMinVisibleHeight:Number = 0;

		private var _explicitMinVisibleHeight:Number;

		public function get minVisibleHeight():Number
		{
			if(this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight) //isNaN
			{
				return this._actualMinVisibleHeight;
			}
			return this._explicitMinVisibleHeight;
		}

		public function set minVisibleHeight(value:Number):void
		{
			if(this._explicitMinVisibleHeight == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight) //isNaN
			{
				return;
			}
			var oldValue:Number = this._explicitMinVisibleHeight;
			this._explicitMinVisibleHeight = value;
			if(valueIsNaN)
			{
				this._actualMinVisibleHeight = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this._actualMinVisibleHeight = value;
				if(this.explicitVisibleHeight !== this.explicitVisibleHeight && //isNaN
					(this.actualVisibleHeight < value || this.actualVisibleHeight == oldValue))
				{
					//only invalidate if this change might affect the visibleHeight
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		private var _maxVisibleHeight:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleHeight():Number
		{
			return this._maxVisibleHeight;
		}

		public function set maxVisibleHeight(value:Number):void
		{
			if(this._maxVisibleHeight == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleHeight cannot be NaN");
			}
			var oldValue:Number = this._maxVisibleHeight;
			this._maxVisibleHeight = value;
			if(this.explicitVisibleHeight !== this.explicitVisibleHeight && //isNaN
				(this.actualVisibleHeight > value || this.actualVisibleHeight == oldValue))
			{
				//only invalidate if this change might affect the visibleHeight
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var actualVisibleHeight:Number = 0;

		private var explicitVisibleHeight:Number = NaN;

		public function get visibleHeight():Number
		{
			return this.actualVisibleHeight;
		}

		public function set visibleHeight(value:Number):void
		{
			if(this.explicitVisibleHeight == value ||
				(value !== value && this.explicitVisibleHeight !== this.explicitVisibleHeight)) //isNaN
			{
				return;
			}
			this.explicitVisibleHeight = value;
			if(this.actualVisibleHeight != value)
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		protected var _contentX:Number = 0;

		public function get contentX():Number
		{
			return this._contentX;
		}

		protected var _contentY:Number = 0;

		public function get contentY():Number
		{
			return this._contentY;
		}

		private var _typicalItemIsInDataProvider:Boolean = false;
		private var _typicalItemRenderer:IListItemRenderer;
		private var _unrenderedData:Array = [];
		private var _layoutItems:Vector.<DisplayObject> = new <DisplayObject>[];
		private var _defaultStorage:ItemRendererFactoryStorage = new ItemRendererFactoryStorage();
		private var _storageMap:Object;
		private var _rendererMap:Dictionary = new Dictionary(true);
		private var _minimumItemCount:int;

		private var _layoutIndexOffset:int = 0;
		private var _layoutIndexRolloverIndex:int = -1;

		private var _owner:List;

		public function get owner():List
		{
			return this._owner;
		}

		public function set owner(value:List):void
		{
			if(this._owner == value)
			{
				return;
			}
			if(this._owner)
			{
				this._owner.removeEventListener(DragDropEvent.DRAG_ENTER, dragEnterHandler);
				this._owner.removeEventListener(DragDropEvent.DRAG_MOVE, dragMoveHandler);
				this._owner.removeEventListener(DragDropEvent.DRAG_EXIT, dragExitHandler);
				this._owner.removeEventListener(DragDropEvent.DRAG_DROP, dragDropHandler);
				this._owner.removeEventListener(DragDropEvent.DRAG_COMPLETE, dragCompleteHandler);
			}
			this._owner = value;
			if(this._owner)
			{
				this._owner.addEventListener(DragDropEvent.DRAG_ENTER, dragEnterHandler);
				this._owner.addEventListener(DragDropEvent.DRAG_MOVE, dragMoveHandler);
				this._owner.addEventListener(DragDropEvent.DRAG_EXIT, dragExitHandler);
				this._owner.addEventListener(DragDropEvent.DRAG_DROP, dragDropHandler);
				this._owner.addEventListener(DragDropEvent.DRAG_COMPLETE, dragCompleteHandler);
			}
		}

		private var _updateForDataReset:Boolean = false;

		private var _dataProvider:IListCollection;

		public function get dataProvider():IListCollection
		{
			return this._dataProvider;
		}

		public function set dataProvider(value:IListCollection):void
		{
			if(this._dataProvider == value)
			{
				return;
			}
			if(this._dataProvider)
			{
				this._dataProvider.removeEventListener(Event.CHANGE, dataProvider_changeHandler);
				this._dataProvider.removeEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.removeEventListener(CollectionEventType.FILTER_CHANGE, dataProvider_filterChangeHandler);
				this._dataProvider.removeEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.UPDATE_ITEM, dataProvider_updateItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.UPDATE_ALL, dataProvider_updateAllHandler);
			}
			this._dataProvider = value;
			if(this._dataProvider)
			{
				this._dataProvider.addEventListener(Event.CHANGE, dataProvider_changeHandler);
				this._dataProvider.addEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.addEventListener(CollectionEventType.FILTER_CHANGE, dataProvider_filterChangeHandler);
				this._dataProvider.addEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.UPDATE_ITEM, dataProvider_updateItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.UPDATE_ALL, dataProvider_updateAllHandler);
			}
			if(this._layout is IVariableVirtualLayout)
			{
				IVariableVirtualLayout(this._layout).resetVariableVirtualCache();
			}
			this._updateForDataReset = true;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private var _itemRendererType:Class;

		public function get itemRendererType():Class
		{
			return this._itemRendererType;
		}

		public function set itemRendererType(value:Class):void
		{
			if(this._itemRendererType == value)
			{
				return;
			}

			this._itemRendererType = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _itemRendererFactory:Function;

		public function get itemRendererFactory():Function
		{
			return this._itemRendererFactory;
		}

		public function set itemRendererFactory(value:Function):void
		{
			if(this._itemRendererFactory === value)
			{
				return;
			}

			this._itemRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _itemRendererFactories:Object;

		public function get itemRendererFactories():Object
		{
			return this._itemRendererFactories;
		}

		public function set itemRendererFactories(value:Object):void
		{
			if(this._itemRendererFactories === value)
			{
				return;
			}

			this._itemRendererFactories = value;
			if(value !== null)
			{
				this._storageMap = {};
			}
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _factoryIDFunction:Function;

		public function get factoryIDFunction():Function
		{
			return this._factoryIDFunction;
		}

		public function set factoryIDFunction(value:Function):void
		{
			if(this._factoryIDFunction === value)
			{
				return;
			}

			this._factoryIDFunction = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _customItemRendererStyleName:String;

		public function get customItemRendererStyleName():String
		{
			return this._customItemRendererStyleName;
		}

		public function set customItemRendererStyleName(value:String):void
		{
			if(this._customItemRendererStyleName == value)
			{
				return;
			}
			this._customItemRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _typicalItem:Object = null;

		public function get typicalItem():Object
		{
			return this._typicalItem;
		}

		public function set typicalItem(value:Object):void
		{
			if(this._typicalItem == value)
			{
				return;
			}
			this._typicalItem = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private var _itemRendererProperties:PropertyProxy;

		public function get itemRendererProperties():PropertyProxy
		{
			return this._itemRendererProperties;
		}

		public function set itemRendererProperties(value:PropertyProxy):void
		{
			if(this._itemRendererProperties == value)
			{
				return;
			}
			if(this._itemRendererProperties)
			{
				this._itemRendererProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._itemRendererProperties = PropertyProxy(value);
			if(this._itemRendererProperties)
			{
				this._itemRendererProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		private var _ignoreLayoutChanges:Boolean = false;
		private var _ignoreRendererResizing:Boolean = false;

		private var _layout:ILayout;

		public function get layout():ILayout
		{
			return this._layout;
		}

		public function set layout(value:ILayout):void
		{
			if(this._layout == value)
			{
				return;
			}
			if(this._layout)
			{
				this._layout.removeEventListener(Event.CHANGE, layout_changeHandler);
			}
			this._layout = value;
			if(this._layout)
			{
				if(this._layout is IVariableVirtualLayout)
				{
					IVariableVirtualLayout(this._layout).resetVariableVirtualCache();
				}
				this._layout.addEventListener(Event.CHANGE, layout_changeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		public function get horizontalScrollStep():Number
		{
			var itemRenderer:DisplayObject = null;
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			if(virtualLayout === null || !virtualLayout.useVirtualLayout)
			{
				if(this._layoutItems.length > 0)
				{
					itemRenderer = this._layoutItems[0] as DisplayObject;
				}
			}
			if(itemRenderer === null)
			{
				itemRenderer = this._typicalItemRenderer as DisplayObject;
			}
			if(itemRenderer === null)
			{
				return 0;
			}
			var itemRendererWidth:Number = itemRenderer.width;
			var itemRendererHeight:Number = itemRenderer.height;
			if(itemRendererWidth < itemRendererHeight)
			{
				return itemRendererWidth;
			}
			return itemRendererHeight;
		}

		public function get verticalScrollStep():Number
		{
			var itemRenderer:DisplayObject = null;
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			if(virtualLayout === null || !virtualLayout.useVirtualLayout)
			{
				if(this._layoutItems.length > 0)
				{
					itemRenderer = this._layoutItems[0] as DisplayObject;
				}
			}
			if(itemRenderer === null)
			{
				itemRenderer = this._typicalItemRenderer as DisplayObject;
			}
			if(itemRenderer === null)
			{
				return 0;
			}
			var itemRendererWidth:Number = itemRenderer.width;
			var itemRendererHeight:Number = itemRenderer.height;
			if(itemRendererWidth < itemRendererHeight)
			{
				return itemRendererWidth;
			}
			return itemRendererHeight;
		}

		private var _horizontalScrollPosition:Number = 0;

		public function get horizontalScrollPosition():Number
		{
			return this._horizontalScrollPosition;
		}

		public function set horizontalScrollPosition(value:Number):void
		{
			if(this._horizontalScrollPosition == value)
			{
				return;
			}
			this._horizontalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		private var _verticalScrollPosition:Number = 0;

		public function get verticalScrollPosition():Number
		{
			return this._verticalScrollPosition;
		}

		public function set verticalScrollPosition(value:Number):void
		{
			if(this._verticalScrollPosition == value)
			{
				return;
			}
			this._verticalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		private var _ignoreSelectionChanges:Boolean = false;

		private var _isSelectable:Boolean = true;

		public function get isSelectable():Boolean
		{
			return this._isSelectable;
		}

		public function set isSelectable(value:Boolean):void
		{
			if(this._isSelectable == value)
			{
				return;
			}
			this._isSelectable = value;
			if(!value)
			{
				this.selectedIndices = null;
			}
		}

		private var _allowMultipleSelection:Boolean = false;

		public function get allowMultipleSelection():Boolean
		{
			return this._allowMultipleSelection;
		}

		public function set allowMultipleSelection(value:Boolean):void
		{
			this._allowMultipleSelection = value;
		}

		private var _selectedIndices:ListCollection;

		public function get selectedIndices():ListCollection
		{
			return this._selectedIndices;
		}

		public function set selectedIndices(value:ListCollection):void
		{
			if(this._selectedIndices == value)
			{
				return;
			}
			if(this._selectedIndices)
			{
				this._selectedIndices.removeEventListener(Event.CHANGE, selectedIndices_changeHandler);
			}
			this._selectedIndices = value;
			if(this._selectedIndices)
			{
				this._selectedIndices.addEventListener(Event.CHANGE, selectedIndices_changeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		protected var _addItemEffectContexts:Vector.<IEffectContext> = null;

		protected var _removeItemEffectContexts:Vector.<IEffectContext> = null;

		protected var _addedItems:Dictionary = null;

		public function get addedItems():Dictionary
		{
			return this._addedItems;
		}

		public function set addedItems(value:Dictionary):void
		{
			if(this._addedItems === value)
			{
				return;
			}
			this._addedItems = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		protected var _removedItems:Dictionary = null;

		public function get removedItems():Dictionary
		{
			return this._removedItems;
		}

		public function set removedItems(value:Dictionary):void
		{
			if(this._removedItems === value)
			{
				return;
			}
			this._removedItems = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		protected var _dragTouchPointID:int = -1;

		protected var _dragFormat:String;

		public function get dragFormat():String
		{
			return this._dragFormat;
		}

		public function set dragFormat(value:String):void
		{
			this._dragFormat = value;
		}

		protected var _dragEnabled:Boolean = false;

		public function get dragEnabled():Boolean
		{
			return this._dragEnabled;
		}

		public function set dragEnabled(value:Boolean):void
		{
			this._dragEnabled = value;
		}

		protected var _dropEnabled:Boolean = false;

		public function get dropEnabled():Boolean
		{
			return this._dropEnabled;
		}

		public function set dropEnabled(value:Boolean):void
		{
			this._dropEnabled = value;
		}

		protected var _minimumAutoScrollDistance:Number = 0.04;

		public function get minimumAutoScrollDistance():Number
		{
			return this._minimumAutoScrollDistance;
		}

		public function set minimumAutoScrollDistance(value:Number):void
		{
			this._minimumAutoScrollDistance = value;
		}

		protected var _droppedOnSelf:Boolean = false;

		/**
		 * @private
		 */
		protected var _explicitDropIndicatorWidth:Number = NaN;

		/**
		 * @private
		 */
		protected var _explicitDropIndicatorHeight:Number = NaN;

		protected var _dropIndicatorSkin:DisplayObject = null;

		public function get dropIndicatorSkin():DisplayObject
		{
			return this._dropIndicatorSkin;
		}

		public function set dropIndicatorSkin(value:DisplayObject):void
		{
			if(this._dropIndicatorSkin === value)
			{
				return;
			}
			this._dropIndicatorSkin = value;
			if(this._dropIndicatorSkin is IMeasureDisplayObject)
			{
				var measureSkin:IMeasureDisplayObject = IMeasureDisplayObject(this._dropIndicatorSkin);
				this._explicitDropIndicatorWidth = measureSkin.explicitWidth;
				this._explicitDropIndicatorHeight = measureSkin.explicitHeight;
			}
			else if(this._dropIndicatorSkin)
			{
				this._explicitDropIndicatorWidth = this._dropIndicatorSkin.width;
				this._explicitDropIndicatorHeight = this._dropIndicatorSkin.height;
			}
		}

		protected var _startDragX:Number;
		protected var _startDragY:Number;

		protected var _dragLocalX:Number = -1;
		protected var _dragLocalY:Number = -1;

		protected var _acceptedDrag:Boolean = false;

		protected var _minimumDragDropDistance:Number = 0.04;

		public function get minimumDragDropDistance():Number
		{
			return this._minimumDragDropDistance;
		}

		public function set minimumDragDropDistance(value:Number):void
		{
			this._minimumDragDropDistance = value;
		}

		public function get requiresMeasurementOnScroll():Boolean
		{
			return this._layout.requiresLayoutOnScroll &&
				(this.explicitVisibleWidth !== this.explicitVisibleWidth ||
				this.explicitVisibleHeight !== this.explicitVisibleHeight);
		}

		public function calculateNavigationDestination(index:int, keyCode:uint):int
		{
			return this._layout.calculateNavigationDestination(this._layoutItems, index, keyCode, this._layoutResult);
		}

		public function getScrollPositionForIndex(index:int, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}
			return this._layout.getScrollPositionForIndex(index, this._layoutItems,
				0, 0, this.actualVisibleWidth, this.actualVisibleHeight, result);
		}

		public function getNearestScrollPositionForIndex(index:int, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}
			return this._layout.getNearestScrollPositionForIndex(index,
				this._horizontalScrollPosition, this._verticalScrollPosition,
				this._layoutItems, 0, 0, this.actualVisibleWidth, this.actualVisibleHeight, result);
		}

		public function itemToItemRenderer(item:Object):IListItemRenderer
		{
			return IListItemRenderer(this._rendererMap[item]);
		}

		override public function dispose():void
		{
			if(this._dropIndicatorSkin !== null &&
				this._dropIndicatorSkin.parent === null)
			{
				this._dropIndicatorSkin.dispose();
				this._dropIndicatorSkin = null;
			}
			this.refreshInactiveRenderers(null, true);
			if(this._storageMap)
			{
				for(var factoryID:String in this._storageMap)
				{
					this.refreshInactiveRenderers(factoryID, true);
				}
			}
			this.owner = null;
			this.layout = null;
			this.dataProvider = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override public function hitTest(localPoint:Point):DisplayObject
		{
			var result:DisplayObject = super.hitTest(localPoint);
			if(result && this._acceptedDrag)
			{
				return this._owner;
			}
			return result;
		}

		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var scrollInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SCROLL);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var selectionInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SELECTED);
			var itemRendererInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);

			//scrolling only affects the layout is requiresLayoutOnScroll is true
			if(!layoutInvalid && scrollInvalid && this._layout && this._layout.requiresLayoutOnScroll)
			{
				layoutInvalid = true;
			}

			var basicsInvalid:Boolean = sizeInvalid || dataInvalid || layoutInvalid || itemRendererInvalid;

			var oldIgnoreRendererResizing:Boolean = this._ignoreRendererResizing;
			this._ignoreRendererResizing = true;
			var oldIgnoreLayoutChanges:Boolean = this._ignoreLayoutChanges;
			this._ignoreLayoutChanges = true;

			if(scrollInvalid || sizeInvalid)
			{
				this.refreshViewPortBounds();
			}
			if(basicsInvalid)
			{
				this.refreshInactiveRenderers(null, itemRendererInvalid);
				if(this._storageMap)
				{
					for(var factoryID:String in this._storageMap)
					{
						this.refreshInactiveRenderers(factoryID, itemRendererInvalid);
					}
				}
			}
			if(dataInvalid || layoutInvalid || itemRendererInvalid)
			{
				this.refreshLayoutTypicalItem();
			}
			if(basicsInvalid)
			{
				this.refreshRenderers();
			}
			if(stylesInvalid || basicsInvalid)
			{
				this.refreshItemRendererStyles();
			}
			if(selectionInvalid || basicsInvalid)
			{
				//unlike resizing renderers and layout changes, we only want to
				//stop listening for selection changes when we're forcibly
				//updating selection. other property changes on item renderers
				//can validly change selection, and we need to detect that.
				var oldIgnoreSelectionChanges:Boolean = this._ignoreSelectionChanges;
				this._ignoreSelectionChanges = true;
				this.refreshSelection();
				this._ignoreSelectionChanges = oldIgnoreSelectionChanges;
			}
			if(stateInvalid || basicsInvalid)
			{
				this.refreshEnabled();
			}
			this._ignoreLayoutChanges = oldIgnoreLayoutChanges;

			if(stateInvalid || selectionInvalid || stylesInvalid || basicsInvalid)
			{
				this._layout.layout(this._layoutItems, this._viewPortBounds, this._layoutResult);
			}

			this._ignoreRendererResizing = oldIgnoreRendererResizing;

			this._contentX = this._layoutResult.contentX;
			this._contentY = this._layoutResult.contentY;
			this.saveMeasurements(this._layoutResult.contentWidth, this._layoutResult.contentHeight,
				this._layoutResult.contentWidth, this._layoutResult.contentHeight);
			this.actualVisibleWidth = this._layoutResult.viewPortWidth;
			this.actualVisibleHeight = this._layoutResult.viewPortHeight;
			this._actualMinVisibleWidth = this._layoutResult.viewPortWidth;
			this._actualMinVisibleHeight = this._layoutResult.viewPortHeight;

			//final validation to avoid juggler next frame issues
			this.validateItemRenderers();

			this.handlePendingItemRendererEffects();

			if(scrollInvalid && this.hasEventListener(Event.ENTER_FRAME, this.dragScroll_enterFrameHandler))
			{
				this.refreshDropIndicator(this._dragLocalX, this._dragLocalY);
			}
		}

		private function handlePendingItemRendererEffects():void
		{
			if(this._addedItems !== null)
			{
				if(this._addItemEffectContexts === null)
				{
					this._addItemEffectContexts = new <IEffectContext>[];
				}
				for(var item:Object in this._addedItems)
				{
					var itemRenderer:IListItemRenderer = this._rendererMap[item] as IListItemRenderer;
					if(itemRenderer !== null)
					{
						this.interruptRemoveItemEffects(itemRenderer, false);
						var effect:Function = this._addedItems[item] as Function;
						var context:IEffectContext = IEffectContext(effect(itemRenderer));
						context.addEventListener(Event.COMPLETE, addedItemEffectContext_completeHandler);
						this._addItemEffectContexts[this._addItemEffectContexts.length] = context;
						context.play();
					}
				}
				this._addedItems = null;
			}
			if(this._removedItems !== null)
			{
				if(this._removeItemEffectContexts === null)
				{
					this._removeItemEffectContexts = new <IEffectContext>[];
				}
				for(item in this._removedItems)
				{
					itemRenderer = this._rendererMap[item] as IListItemRenderer;
					if(itemRenderer !== null)
					{
						this.interruptRemoveItemEffects(itemRenderer, true);
						this.interruptAddItemEffects(itemRenderer);
						effect = this._removedItems[item] as Function;
						context = IEffectContext(effect(itemRenderer));
						context.addEventListener(Event.COMPLETE, removedItemEffectContext_completeHandler);
						this._removeItemEffectContexts[this._removeItemEffectContexts.length] = context;
						context.play();
					}
				}
				this._removedItems = null;
			}
		}

		private function interruptAddItemEffects(itemRenderer:IListItemRenderer):void
		{
			if(this._addItemEffectContexts === null)
			{
				return;
			}
			var contextCount:int = this._addItemEffectContexts.length;
			for(var i:int = 0; i < contextCount; i++)
			{
				var context:IEffectContext = this._addItemEffectContexts[i];
				if(context.target !== itemRenderer)
				{
					continue;
				}
				context.interrupt();
				//we've removed this context, so check the same index again
				//because it won't be the same context, and don't go beyond the
				//new, smaller length
				i--;
				contextCount--;
			}
		}

		private function interruptRemoveItemEffects(itemRenderer:IListItemRenderer, stop:Boolean):void
		{
			if(this._removeItemEffectContexts === null)
			{
				return;
			}
			var contextCount:int = this._removeItemEffectContexts.length;
			for(var i:int = 0; i < contextCount; i++)
			{
				var context:IEffectContext = this._removeItemEffectContexts[i];
				if(context.target !== itemRenderer)
				{
					continue;
				}
				if(stop)
				{
					context.stop();
				}
				else
				{
					context.interrupt();
				}
				//we've removed this context, so check the same index again
				//because it won't be the same context, and don't go beyond the
				//new, smaller length
				i--;
				contextCount--;
			}
		}

		private function invalidateParent(flag:String = INVALIDATION_FLAG_ALL):void
		{
			Scroller(this.parent).invalidate(flag);
		}

		private function validateItemRenderers():void
		{
			var itemCount:int = this._layoutItems.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:IValidating = this._layoutItems[i] as IValidating;
				if(item)
				{
					item.validate();
				}
			}
		}

		private function refreshLayoutTypicalItem():void
		{
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			if(!virtualLayout || !virtualLayout.useVirtualLayout)
			{
				//the old layout was virtual, but this one isn't
				if(!this._typicalItemIsInDataProvider && this._typicalItemRenderer)
				{
					//it's safe to destroy this renderer
					this.destroyRenderer(this._typicalItemRenderer);
					this._typicalItemRenderer = null;
				}
				return;
			}
			var typicalItemIndex:int = 0;
			var newTypicalItemIsInDataProvider:Boolean = false;
			var typicalItem:Object = this._typicalItem;
			if(typicalItem !== null)
			{
				if(this._dataProvider)
				{
					typicalItemIndex = this._dataProvider.getItemIndex(typicalItem);
					newTypicalItemIsInDataProvider = typicalItemIndex >= 0;
				}
				if(typicalItemIndex < 0)
				{
					typicalItemIndex = 0;
				}
			}
			else
			{
				if(this._dataProvider && this._dataProvider.length > 0)
				{
					newTypicalItemIsInDataProvider = true;
					typicalItem = this._dataProvider.getItemAt(0);
				}
			}

			//#1645 The typicalItem can be null if the data provider contains
			//a null value at index 0. this is the only time we allow null.
			if(typicalItem !== null || newTypicalItemIsInDataProvider)
			{
				var typicalRenderer:IListItemRenderer = IListItemRenderer(this._rendererMap[typicalItem]);
				if(typicalRenderer)
				{
					//at this point, the item already has an item renderer.
					//(this doesn't necessarily mean that the current typical
					//item was the typical item last time this function was
					//called)

					//the index may have changed if items were added, removed or
					//reordered in the data provider
					typicalRenderer.index = typicalItemIndex;
					if(typicalRenderer is IDragAndDropItemRenderer)
					{
						IDragAndDropItemRenderer(typicalRenderer).dragEnabled = this._dragEnabled;
					}
				}
				if(!typicalRenderer && this._typicalItemRenderer)
				{
					//the typical item has changed, and doesn't have an item
					//renderer yet. the previous typical item had an item
					//renderer, so we will try to reuse it.

					//we can reuse the existing typical item renderer if the old
					//typical item wasn't in the data provider. otherwise, it
					//may still be needed for the same item.
					var canReuse:Boolean = !this._typicalItemIsInDataProvider;
					var oldTypicalItemRemoved:Boolean = this._typicalItemIsInDataProvider &&
						this._dataProvider && this._dataProvider.getItemIndex(this._typicalItemRenderer.data) < 0;
					if(!canReuse && oldTypicalItemRemoved)
					{
						//special case: if the old typical item was in the data
						//provider, but it has been removed, it's safe to reuse.
						canReuse = true;
					}
					if(canReuse)
					{
						//we can't reuse if the factoryID has changed, though!
						var factoryID:String = null;
						if(this._factoryIDFunction !== null)
						{
							factoryID = this.getFactoryID(typicalItem, typicalItemIndex);
						}
						if(this._typicalItemRenderer.factoryID !== factoryID)
						{
							canReuse = false;
						}
					}
					if(canReuse)
					{
						//we can reuse the item renderer used for the old
						//typical item!

						//if the old typical item was in the data provider,
						//remove it from the renderer map.
						if(this._typicalItemIsInDataProvider)
						{
							delete this._rendererMap[this._typicalItemRenderer.data];
						}
						typicalRenderer = this._typicalItemRenderer;
						typicalRenderer.data = typicalItem;
						typicalRenderer.index = typicalItemIndex;
						//if the new typical item is in the data provider, add it
						//to the renderer map.
						if(newTypicalItemIsInDataProvider)
						{
							this._rendererMap[typicalItem] = typicalRenderer;
						}
					}
				}
				if(!typicalRenderer)
				{
					//if we still don't have a typical item renderer, we need to
					//create a new one.
					typicalRenderer = this.createRenderer(typicalItem, typicalItemIndex, false, !newTypicalItemIsInDataProvider);
					if(!this._typicalItemIsInDataProvider && this._typicalItemRenderer)
					{
						//get rid of the old typical item renderer if it isn't
						//needed anymore.  since it was not in the data
						//provider, we don't need to mess with the renderer map
						//dictionary or dispatch any events.
						this.destroyRenderer(this._typicalItemRenderer);
						this._typicalItemRenderer = null;
					}
				}
			}

			virtualLayout.typicalItem = DisplayObject(typicalRenderer);
			this._typicalItemRenderer = typicalRenderer;
			this._typicalItemIsInDataProvider = newTypicalItemIsInDataProvider;
			if(this._typicalItemRenderer && !this._typicalItemIsInDataProvider)
			{
				//we need to know if this item renderer resizes to adjust the
				//layout because the layout may use this item renderer to resize
				//the other item renderers
				this._typicalItemRenderer.addEventListener(FeathersEventType.RESIZE, renderer_resizeHandler);
			}
		}

		private function refreshItemRendererStyles():void
		{
			for each(var item:DisplayObject in this._layoutItems)
			{
				var itemRenderer:IListItemRenderer = item as IListItemRenderer;
				if(itemRenderer)
				{
					this.refreshOneItemRendererStyles(itemRenderer);
				}
			}
		}

		private function refreshOneItemRendererStyles(renderer:IListItemRenderer):void
		{
			var displayRenderer:DisplayObject = DisplayObject(renderer);
			for(var propertyName:String in this._itemRendererProperties)
			{
				var propertyValue:Object = this._itemRendererProperties[propertyName];
				displayRenderer[propertyName] = propertyValue;
			}
		}

		private function refreshSelection():void
		{
			for each(var item:DisplayObject in this._layoutItems)
			{
				var itemRenderer:IListItemRenderer = item as IListItemRenderer;
				if(itemRenderer)
				{
					itemRenderer.isSelected = this._selectedIndices.getItemIndex(itemRenderer.index) >= 0;
				}
			}
		}

		private function refreshEnabled():void
		{
			for each(var item:DisplayObject in this._layoutItems)
			{
				var control:IFeathersControl = item as IFeathersControl;
				if(control)
				{
					control.isEnabled = this._isEnabled;
				}
			}
		}

		private function refreshViewPortBounds():void
		{
			var needsMinWidth:Boolean = this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight; //isNaN
			this._viewPortBounds.x = 0;
			this._viewPortBounds.y = 0;
			this._viewPortBounds.scrollX = this._horizontalScrollPosition;
			this._viewPortBounds.scrollY = this._verticalScrollPosition;
			this._viewPortBounds.explicitWidth = this.explicitVisibleWidth;
			this._viewPortBounds.explicitHeight = this.explicitVisibleHeight;
			if(needsMinWidth)
			{
				this._viewPortBounds.minWidth = 0;
			}
			else
			{
				this._viewPortBounds.minWidth = this._explicitMinVisibleWidth;
			}
			if(needsMinHeight)
			{
				this._viewPortBounds.minHeight = 0;
			}
			else
			{
				this._viewPortBounds.minHeight = this._explicitMinVisibleHeight;
			}
			this._viewPortBounds.maxWidth = this._maxVisibleWidth;
			this._viewPortBounds.maxHeight = this._maxVisibleHeight;
		}

		private function refreshInactiveRenderers(factoryID:String, itemRendererTypeIsInvalid:Boolean):void
		{
			if(factoryID !== null)
			{
				var storage:ItemRendererFactoryStorage = ItemRendererFactoryStorage(this._storageMap[factoryID]);
			}
			else
			{
				storage = this._defaultStorage;
			}
			var temp:Vector.<IListItemRenderer> = storage.inactiveItemRenderers;
			storage.inactiveItemRenderers = storage.activeItemRenderers;
			storage.activeItemRenderers = temp;
			if(storage.activeItemRenderers.length > 0)
			{
				throw new IllegalOperationError("ListDataViewPort: active renderers should be empty.");
			}
			if(itemRendererTypeIsInvalid)
			{
				this.recoverInactiveRenderers(storage);
				this.freeInactiveRenderers(storage, 0);
				if(this._typicalItemRenderer && this._typicalItemRenderer.factoryID === factoryID)
				{
					if(this._typicalItemIsInDataProvider)
					{
						delete this._rendererMap[this._typicalItemRenderer.data];
					}
					this.destroyRenderer(this._typicalItemRenderer);
					this._typicalItemRenderer = null;
					this._typicalItemIsInDataProvider = false;
				}
			}

			this._layoutItems.length = 0;
		}

		private function refreshRenderers():void
		{
			if(this._typicalItemRenderer)
			{
				if(this._typicalItemIsInDataProvider)
				{
					var storage:ItemRendererFactoryStorage = this.factoryIDToStorage(this._typicalItemRenderer.factoryID);
					var inactiveItemRenderers:Vector.<IListItemRenderer> = storage.inactiveItemRenderers;
					var activeItemRenderers:Vector.<IListItemRenderer> = storage.activeItemRenderers;
					//this renderer is already is use by the typical item, so we
					//don't want to allow it to be used by other items.
					var inactiveIndex:int = inactiveItemRenderers.indexOf(this._typicalItemRenderer);
					if(inactiveIndex >= 0)
					{
						inactiveItemRenderers[inactiveIndex] = null;
					}
					//if refreshLayoutTypicalItem() was called, it will have already
					//added the typical item renderer to the active renderers. if
					//not, we need to do it here.
					var activeRendererCount:int = activeItemRenderers.length;
					if(activeRendererCount == 0)
					{
						activeItemRenderers[activeRendererCount] = this._typicalItemRenderer;
					}
				}
				//we need to set the typical item renderer's properties here
				//because they may be needed for proper measurement in a virtual
				//layout.
				this.refreshOneItemRendererStyles(this._typicalItemRenderer);
			}

			this.findUnrenderedData();
			this.recoverInactiveRenderers(this._defaultStorage);
			if(this._storageMap)
			{
				for(var factoryID:String in this._storageMap)
				{
					storage = ItemRendererFactoryStorage(this._storageMap[factoryID]);
					this.recoverInactiveRenderers(storage);
				}
			}
			this.renderUnrenderedData();
			this.freeInactiveRenderers(this._defaultStorage, this._minimumItemCount);
			if(this._storageMap)
			{
				for(factoryID in this._storageMap)
				{
					storage = ItemRendererFactoryStorage(this._storageMap[factoryID]);
					this.freeInactiveRenderers(storage, 1);
				}
			}
			this._updateForDataReset = false;
		}

		private function findUnrenderedData():void
		{
			var itemCount:int = this._dataProvider ? this._dataProvider.length : 0;
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			var useVirtualLayout:Boolean = virtualLayout && virtualLayout.useVirtualLayout;
			if(useVirtualLayout)
			{
				var point:Point = Pool.getPoint();
				virtualLayout.measureViewPort(itemCount, this._viewPortBounds, point);
				virtualLayout.getVisibleIndicesAtScrollPosition(this._horizontalScrollPosition, this._verticalScrollPosition, point.x, point.y, itemCount, HELPER_VECTOR);
				Pool.putPoint(point);
			}

			var unrenderedItemCount:int = useVirtualLayout ? HELPER_VECTOR.length : itemCount;
			if(useVirtualLayout && this._typicalItemIsInDataProvider && this._typicalItemRenderer &&
				HELPER_VECTOR.indexOf(this._typicalItemRenderer.index) >= 0)
			{
				//add an extra item renderer if the typical item is from the
				//data provider and it is visible. this helps keep the number of
				//item renderers constant!
				this._minimumItemCount = unrenderedItemCount + 1;
			}
			else
			{
				this._minimumItemCount = unrenderedItemCount;
			}
			var canUseBeforeAndAfter:Boolean = this._layout is ITrimmedVirtualLayout && useVirtualLayout &&
				(!(this._layout is IVariableVirtualLayout) || !IVariableVirtualLayout(this._layout).hasVariableItemDimensions) &&
				unrenderedItemCount > 0;
			if(canUseBeforeAndAfter)
			{
				var minIndex:int = HELPER_VECTOR[0];
				var maxIndex:int = minIndex;
				for(var i:int = 1; i < unrenderedItemCount; i++)
				{
					var index:int = HELPER_VECTOR[i];
					if(index < minIndex)
					{
						minIndex = index;
					}
					if(index > maxIndex)
					{
						maxIndex = index;
					}
				}
				if(this._layout is ISpinnerLayout &&
					minIndex == 0 &&
					maxIndex == (this._dataProvider.length - 1) &&
					HELPER_VECTOR[0] > HELPER_VECTOR[HELPER_VECTOR.length - 1])
				{
					var newMin:int = HELPER_VECTOR[0] - this._dataProvider.length;
					var newMax:int = HELPER_VECTOR[HELPER_VECTOR.length - 1];
					var beforeItemCount:int = newMin;
					var afterItemCount:int = itemCount - 1 - newMax + beforeItemCount;
					this._layoutItems.length = HELPER_VECTOR.length;
					this._layoutIndexOffset = -beforeItemCount;
					this._layoutIndexRolloverIndex = HELPER_VECTOR[0];
				}
				else
				{
					beforeItemCount = minIndex - 1;
					if(beforeItemCount < 0)
					{
						beforeItemCount = 0;
					}
					afterItemCount = itemCount - 1 - maxIndex;

					this._layoutItems.length = itemCount - beforeItemCount - afterItemCount;
					this._layoutIndexOffset = -beforeItemCount;
					this._layoutIndexRolloverIndex = -1;
				}
				var trimmedLayout:ITrimmedVirtualLayout = ITrimmedVirtualLayout(this._layout);
				trimmedLayout.beforeVirtualizedItemCount = beforeItemCount;
				trimmedLayout.afterVirtualizedItemCount = afterItemCount;
			}
			else
			{
				this._layoutIndexOffset = 0;
				this._layoutItems.length = itemCount;
			}

			var unrenderedDataLastIndex:int = this._unrenderedData.length;
			for(i = 0; i < unrenderedItemCount; i++)
			{
				index = useVirtualLayout ? HELPER_VECTOR[i] : i;
				if(index < 0 || index >= itemCount)
				{
					continue;
				}
				var item:Object = this._dataProvider.getItemAt(index);
				var itemRenderer:IListItemRenderer = IListItemRenderer(this._rendererMap[item]);
				if(this._factoryIDFunction !== null && itemRenderer !== null)
				{
					var newFactoryID:String = this.getFactoryID(itemRenderer.data, index);
					if(newFactoryID !== itemRenderer.factoryID)
					{
						itemRenderer = null;
						delete this._rendererMap[item];
					}
				}
				if(itemRenderer !== null)
				{
					//the index may have changed if items were added, removed or
					//reordered in the data provider
					itemRenderer.index = index;
					if(itemRenderer is IDragAndDropItemRenderer)
					{
						IDragAndDropItemRenderer(itemRenderer).dragEnabled = this._dragEnabled;
					}
					//if this item renderer used to be the typical item
					//renderer, but it isn't anymore, it may have been set invisible!
					itemRenderer.visible = true;
					if(this._updateForDataReset)
					{
						//similar to calling updateItemAt(), replacing the data
						//provider or resetting its source means that we should
						//trick the item renderer into thinking it has new data.
						//many developers seem to expect this behavior, so while
						//it's not the most optimal for performance, it saves on
						//support time in the forums. thankfully, it's still
						//somewhat optimized since the same item renderer will
						//receive the same data, and the children generally
						//won't have changed much, if at all.
						itemRenderer.data = null;
						itemRenderer.data = item;
					}

					//the typical item renderer is a special case, and we will
					//have already put it into the active renderers, so we don't
					//want to do it again!
					if(this._typicalItemRenderer !== itemRenderer)
					{
						var storage:ItemRendererFactoryStorage = this.factoryIDToStorage(itemRenderer.factoryID);
						var activeItemRenderers:Vector.<IListItemRenderer> = storage.activeItemRenderers;
						var inactiveItemRenderers:Vector.<IListItemRenderer> = storage.inactiveItemRenderers;
						activeItemRenderers[activeItemRenderers.length] = itemRenderer;
						var inactiveIndex:int = inactiveItemRenderers.indexOf(itemRenderer);
						if(inactiveIndex >= 0)
						{
							inactiveItemRenderers[inactiveIndex] = null;
						}
						else
						{
							throw new IllegalOperationError("ListDataViewPort: renderer map contains bad data. This may be caused by duplicate items in the data provider, which is not allowed.");
						}
					}
					if(this._layoutIndexRolloverIndex == -1 || index < this._layoutIndexRolloverIndex)
					{
						var layoutIndex:int = index + this._layoutIndexOffset;
					}
					else
					{
						layoutIndex = index - this._dataProvider.length + this._layoutIndexOffset;
					}
					this._layoutItems[layoutIndex] = DisplayObject(itemRenderer);
				}
				else
				{
					this._unrenderedData[unrenderedDataLastIndex] = item;
					unrenderedDataLastIndex++;
				}
			}
			//update the typical item renderer's visibility
			if(this._typicalItemRenderer)
			{
				if(useVirtualLayout && this._typicalItemIsInDataProvider)
				{
					index = HELPER_VECTOR.indexOf(this._typicalItemRenderer.index);
					if(index >= 0)
					{
						this._typicalItemRenderer.visible = true;
					}
					else
					{
						this._typicalItemRenderer.visible = false;

						//uncomment these lines to see a hidden typical item for
						//debugging purposes...
						/*this._typicalItemRenderer.visible = true;
						this._typicalItemRenderer.x = this._horizontalScrollPosition;
						this._typicalItemRenderer.y = this._verticalScrollPosition;*/
					}
				}
				else
				{
					this._typicalItemRenderer.visible = this._typicalItemIsInDataProvider;
				}
			}
			HELPER_VECTOR.length = 0;
		}

		private function renderUnrenderedData():void
		{
			var itemCount:int = this._unrenderedData.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = this._unrenderedData.shift();
				var index:int = this._dataProvider.getItemIndex(item);
				var renderer:IListItemRenderer = this.createRenderer(item, index, true, false);
				renderer.visible = true;
				if(this._layoutIndexRolloverIndex == -1 || index < this._layoutIndexRolloverIndex)
				{
					var layoutIndex:int = index + this._layoutIndexOffset;
				}
				else
				{
					layoutIndex = index - this._dataProvider.length + this._layoutIndexOffset;
				}
				this._layoutItems[layoutIndex] = DisplayObject(renderer);
			}
		}

		private function recoverInactiveRenderers(storage:ItemRendererFactoryStorage):void
		{
			var inactiveItemRenderers:Vector.<IListItemRenderer> = storage.inactiveItemRenderers;

			var itemCount:int = inactiveItemRenderers.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var itemRenderer:IListItemRenderer = inactiveItemRenderers[i];
				if(!itemRenderer || itemRenderer.index < 0)
				{
					continue;
				}
				this._owner.dispatchEventWith(FeathersEventType.RENDERER_REMOVE, false, itemRenderer);
				delete this._rendererMap[itemRenderer.data];
			}
		}

		private function freeInactiveRenderers(storage:ItemRendererFactoryStorage, minimumItemCount:int):void
		{
			var inactiveItemRenderers:Vector.<IListItemRenderer> = storage.inactiveItemRenderers;
			var activeItemRenderers:Vector.<IListItemRenderer> = storage.activeItemRenderers;
			var activeItemRenderersCount:int = activeItemRenderers.length;

			//we may keep around some extra renderers to avoid too much
			//allocation and garbage collection. they'll be hidden.
			var itemCount:int = inactiveItemRenderers.length;
			var keepCount:int = minimumItemCount - activeItemRenderersCount;
			if(keepCount > itemCount)
			{
				keepCount = itemCount;
			}
			for(var i:int = 0; i < keepCount; i++)
			{
				var itemRenderer:IListItemRenderer = inactiveItemRenderers.shift();
				if(!itemRenderer)
				{
					keepCount++;
					if(itemCount < keepCount)
					{
						keepCount = itemCount;
					}
					continue;
				}
				itemRenderer.data = null;
				itemRenderer.index = -1;
				itemRenderer.visible = false;
				activeItemRenderers[activeItemRenderersCount] = itemRenderer;
				activeItemRenderersCount++;
			}
			itemCount -= keepCount;
			for(i = 0; i < itemCount; i++)
			{
				itemRenderer = inactiveItemRenderers.shift();
				if(!itemRenderer)
				{
					continue;
				}
				this.destroyRenderer(itemRenderer);
			}
		}

		private function createRenderer(item:Object, index:int, useCache:Boolean, isTemporary:Boolean):IListItemRenderer
		{
			var factoryID:String = null;
			if(this._factoryIDFunction !== null)
			{
				factoryID = this.getFactoryID(item, index);
			}
			var itemRendererFactory:Function = this.factoryIDToFactory(factoryID);
			var storage:ItemRendererFactoryStorage = this.factoryIDToStorage(factoryID);
			var inactiveItemRenderers:Vector.<IListItemRenderer> = storage.inactiveItemRenderers;
			var activeItemRenderers:Vector.<IListItemRenderer> = storage.activeItemRenderers;
			var itemRenderer:IListItemRenderer;
			do
			{
				if(!useCache || isTemporary || inactiveItemRenderers.length == 0)
				{
					if(itemRendererFactory !== null)
					{
						itemRenderer = IListItemRenderer(itemRendererFactory());
					}
					else
					{
						itemRenderer = IListItemRenderer(new this._itemRendererType());
					}
					if(this._customItemRendererStyleName && this._customItemRendererStyleName.length > 0)
					{
						itemRenderer.styleNameList.add(this._customItemRendererStyleName);
					}
					this.addChild(DisplayObject(itemRenderer));
				}
				else
				{
					itemRenderer = inactiveItemRenderers.shift();
				}
				//wondering why this all is in a loop?
				//_inactiveRenderers.shift() may return null because we're
				//storing null values instead of calling splice() to improve
				//performance.
			}
			while(!itemRenderer);
			itemRenderer.data = item;
			itemRenderer.index = index;
			itemRenderer.owner = this._owner;
			itemRenderer.factoryID = factoryID;
			if(itemRenderer is IDragAndDropItemRenderer)
			{
				IDragAndDropItemRenderer(itemRenderer).dragEnabled = this._dragEnabled;
			}

			if(!isTemporary)
			{
				this._rendererMap[item] = itemRenderer;
				activeItemRenderers[activeItemRenderers.length] = itemRenderer;
				itemRenderer.addEventListener(Event.TRIGGERED, renderer_triggeredHandler);
				itemRenderer.addEventListener(Event.CHANGE, renderer_changeHandler);
				itemRenderer.addEventListener(FeathersEventType.RESIZE, renderer_resizeHandler);
				itemRenderer.addEventListener(TouchEvent.TOUCH, itemRenderer_drag_touchHandler);
				this._owner.dispatchEventWith(FeathersEventType.RENDERER_ADD, false, itemRenderer);
			}

			return itemRenderer;
		}

		private function destroyRenderer(renderer:IListItemRenderer):void
		{
			renderer.removeEventListener(Event.TRIGGERED, renderer_triggeredHandler);
			renderer.removeEventListener(Event.CHANGE, renderer_changeHandler);
			renderer.removeEventListener(FeathersEventType.RESIZE, renderer_resizeHandler);
			renderer.removeEventListener(TouchEvent.TOUCH, itemRenderer_drag_touchHandler);
			renderer.owner = null;
			renderer.data = null;
			renderer.factoryID = null;
			this.removeChild(DisplayObject(renderer), true);
		}

		private function getFactoryID(item:Object, index:int):String
		{
			if(this._factoryIDFunction === null)
			{
				return null;
			}
			if(this._factoryIDFunction.length == 1)
			{
				return this._factoryIDFunction(item);
			}
			return this._factoryIDFunction(item, index);
		}

		private function factoryIDToFactory(id:String):Function
		{
			if(id !== null)
			{
				if(id in this._itemRendererFactories)
				{
					return this._itemRendererFactories[id] as Function;
				}
				else
				{
					throw new ReferenceError("Cannot find item renderer factory for ID \"" + id + "\".");
				}
			}
			return this._itemRendererFactory;
		}

		private function factoryIDToStorage(id:String):ItemRendererFactoryStorage
		{
			if(id !== null)
			{
				if(id in this._storageMap)
				{
					return ItemRendererFactoryStorage(this._storageMap[id]);
				}
				var storage:ItemRendererFactoryStorage = new ItemRendererFactoryStorage();
				this._storageMap[id] = storage;
				return storage;
			}
			return this._defaultStorage;
		}

		protected function refreshDropIndicator(localX:Number, localY:Number):void
		{
			if(!this._dropIndicatorSkin || !(this._layout is IDragDropLayout))
			{
				return;
			}
			var layout:IDragDropLayout = IDragDropLayout(this._layout);
			this._dropIndicatorSkin.width = this._explicitDropIndicatorWidth;
			this._dropIndicatorSkin.height = this._explicitDropIndicatorHeight;

			var dropX:Number = this._horizontalScrollPosition + localX;
			var dropY:Number = this._verticalScrollPosition + localY;
			var dropIndex:int = layout.getDropIndex(dropX, dropY,
				this._layoutItems, 0, 0, this.actualVisibleWidth, this.actualVisibleHeight);
			layout.positionDropIndicator(this._dropIndicatorSkin, dropIndex,
				dropX, dropY, this._layoutItems, this.actualVisibleWidth, this.actualVisibleHeight);
			this.addChild(this._dropIndicatorSkin);
		}

		private function childProperties_onChange(proxy:PropertyProxy, name:String):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		private function dataProvider_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private function dataProvider_addItemHandler(event:Event, index:int):void
		{
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			layout.addToVariableVirtualCacheAtIndex(index);
		}

		private function dataProvider_removeItemHandler(event:Event, index:int):void
		{
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			layout.removeFromVariableVirtualCacheAtIndex(index);
		}

		private function dataProvider_replaceItemHandler(event:Event, index:int):void
		{
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			layout.resetVariableVirtualCacheAtIndex(index);
		}

		private function dataProvider_resetHandler(event:Event):void
		{
			this._updateForDataReset = true;

			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			layout.resetVariableVirtualCache();
		}

		private function dataProvider_filterChangeHandler(event:Event):void
		{
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			//we don't know exactly which indices have changed, so reset the
			//whole cache.
			layout.resetVariableVirtualCache();
		}

		private function dataProvider_updateItemHandler(event:Event, index:int):void
		{
			var item:Object = this._dataProvider.getItemAt(index);
			var renderer:IListItemRenderer = IListItemRenderer(this._rendererMap[item]);
			if(renderer === null)
			{
				return;
			}
			//in order to display the same item with modified properties, this
			//hack tricks the item renderer into thinking that it has been given
			//a different item to render.
			renderer.data = null;
			renderer.data = item;
			if(this.explicitVisibleWidth !== this.explicitVisibleWidth || //isNaN
				this.explicitVisibleHeight !== this.explicitVisibleHeight) //isNaN
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
				this.invalidateParent(INVALIDATION_FLAG_SIZE);
			}
		}

		private function dataProvider_updateAllHandler(event:Event):void
		{
			//we're treating this similar to the RESET event because enough
			//users are treating UPDATE_ALL similarly. technically, UPDATE_ALL
			//is supposed to affect only existing items, but it's confusing when
			//new items are added and not displayed.
			this._updateForDataReset = true;
			this.invalidate(INVALIDATION_FLAG_DATA);

			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			layout.resetVariableVirtualCache();
		}

		private function layout_changeHandler(event:Event):void
		{
			if(this._ignoreLayoutChanges)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
			this.invalidateParent(INVALIDATION_FLAG_LAYOUT);
		}

		private function renderer_resizeHandler(event:Event):void
		{
			if(this._ignoreRendererResizing)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
			this.invalidateParent(INVALIDATION_FLAG_LAYOUT);
			if(event.currentTarget === this._typicalItemRenderer && !this._typicalItemIsInDataProvider)
			{
				return;
			}
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			var renderer:IListItemRenderer = IListItemRenderer(event.currentTarget);
			layout.resetVariableVirtualCacheAtIndex(renderer.index, DisplayObject(renderer));
		}

		private function renderer_triggeredHandler(event:Event):void
		{
			var renderer:IListItemRenderer = IListItemRenderer(event.currentTarget);
			this.parent.dispatchEventWith(Event.TRIGGERED, false, renderer.data);
		}

		private function renderer_changeHandler(event:Event):void
		{
			if(this._ignoreSelectionChanges)
			{
				return;
			}
			var renderer:IListItemRenderer = IListItemRenderer(event.currentTarget);
			if(!this._isSelectable || this._owner.isScrolling)
			{
				renderer.isSelected = false;
				return;
			}
			var isSelected:Boolean = renderer.isSelected;
			var index:int = renderer.index;
			if(this._allowMultipleSelection)
			{
				var indexOfIndex:int = this._selectedIndices.getItemIndex(index);
				if(isSelected && indexOfIndex < 0)
				{
					this._selectedIndices.addItem(index);
				}
				else if(!isSelected && indexOfIndex >= 0)
				{
					this._selectedIndices.removeItemAt(indexOfIndex);
				}
			}
			else if(isSelected)
			{
				this._selectedIndices.data = new <int>[index];
			}
			else
			{
				this._selectedIndices.removeAll();
			}
		}

		private function selectedIndices_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		private function addedItemEffectContext_completeHandler(event:Event):void
		{
			var context:IEffectContext = IEffectContext(event.currentTarget);
			context.removeEventListener(Event.COMPLETE, addedItemEffectContext_completeHandler);
			var index:int = this._addItemEffectContexts.indexOf(context);
			this._addItemEffectContexts.removeAt(index);
		}

		private function removedItemEffectContext_completeHandler(event:Event):void
		{
			var context:IEffectContext = IEffectContext(event.currentTarget);
			context.removeEventListener(Event.COMPLETE, removedItemEffectContext_completeHandler);
			var contextIndex:int = this._removeItemEffectContexts.indexOf(context);
			this._removeItemEffectContexts.removeAt(contextIndex);
			//if it was stopped before completing, we won't remove the item from
			//the data provider
			if(event.data === true)
			{
				return;
			}

			var itemRenderer:IListItemRenderer = IListItemRenderer(context.target);
			//don't remove it from the data provider until the effect is done
			//because we don't want to remove it from the layout yet
			this._dataProvider.removeItem(itemRenderer.data);

			//we're going to completely destroy this item renderer because the
			//effect may have left it in a state where it won't be valid for
			//use by a new item. for instance, if the item faded out, it would
			//start out invisible (unless an item added effect faded it back in,
			//but we can't assume that).

			//recover
			this._owner.dispatchEventWith(FeathersEventType.RENDERER_REMOVE, false, itemRenderer);
			delete this._rendererMap[itemRenderer.data];

			//free
			var storage:ItemRendererFactoryStorage = this.factoryIDToStorage(itemRenderer.factoryID);
			var activeItemRenderers:Vector.<IListItemRenderer> = storage.activeItemRenderers;
			var activeIndex:int = activeItemRenderers.indexOf(itemRenderer);
			activeItemRenderers.removeAt(activeIndex);
			this.destroyRenderer(itemRenderer);
		}

		protected function dragEnterHandler(event:DragDropEvent):void
		{
			this._acceptedDrag = false;
			if(!this._dropEnabled)
			{
				return;
			}
			if(!event.dragData.hasDataForFormat(this._dragFormat))
			{
				return;
			}
			DragDropManager.acceptDrag(this._owner);
			this.refreshDropIndicator(event.localX, event.localY);

			this._acceptedDrag = true;
			this._dragLocalX = event.localX;
			this._dragLocalY = event.localY;
			this.addEventListener(Event.ENTER_FRAME, dragScroll_enterFrameHandler);
		}

		protected function dragMoveHandler(event:DragDropEvent):void
		{
			if(!this._dropEnabled)
			{
				return;
			}
			if(!event.dragData.hasDataForFormat(this._dragFormat))
			{
				return;
			}
			this.refreshDropIndicator(event.localX, event.localY);

			this._dragLocalX = event.localX;
			this._dragLocalY = event.localY;
		}

		protected function dragScroll_enterFrameHandler(event:EnterFrameEvent):void
		{
			var starling:Starling = this.stage.starling;
			var minAutoScrollPixels:Number = this._minimumAutoScrollDistance * (DeviceCapabilities.dpi / starling.contentScaleFactor);
			var velocity:Number = event.passedTime * 500;
			if(this._owner.maxVerticalScrollPosition > this._owner.minVerticalScrollPosition)
			{
				if(this._verticalScrollPosition < this._owner.maxVerticalScrollPosition &&
					this._dragLocalY > (this.visibleHeight - minAutoScrollPixels))
				{
					velocity *= (1 - ((this.visibleHeight - this._dragLocalY) / minAutoScrollPixels));
				}
				else if(this._verticalScrollPosition > this._owner.minVerticalScrollPosition &&
					this._dragLocalY < minAutoScrollPixels)
				{
					velocity *= -(1 - (this._dragLocalY / minAutoScrollPixels));
				}
				else
				{
					velocity = 0;
				}
				if(velocity != 0)
				{
					var verticalScrollPosition:Number = this._owner.verticalScrollPosition + velocity;
					if(verticalScrollPosition > this._owner.maxVerticalScrollPosition)
					{
						verticalScrollPosition = this._owner.maxVerticalScrollPosition;
					}
					else if(verticalScrollPosition < this._owner.minVerticalScrollPosition)
					{
						verticalScrollPosition = this._owner.minVerticalScrollPosition;
					}
					this._owner.verticalScrollPosition = verticalScrollPosition;
				}
			}
			if(this._owner.maxHorizontalScrollPosition > this._owner.minHorizontalScrollPosition)
			{
				if(this._horizontalScrollPosition < this._owner.maxHorizontalScrollPosition &&
					this._dragLocalX > (this.visibleWidth - minAutoScrollPixels))
				{
					velocity *= (1 - ((this.visibleWidth - this._dragLocalX) / minAutoScrollPixels));
				}
				else if(this._horizontalScrollPosition > this._owner.minHorizontalScrollPosition &&
					this._dragLocalX < minAutoScrollPixels)
				{
					velocity *= -(1 - (this._dragLocalX / minAutoScrollPixels));
				}
				else
				{
					velocity = 0;
				}
				if(velocity != 0)
				{
					var horizontalScrollPosition:Number = this._owner.horizontalScrollPosition + velocity;
					if(horizontalScrollPosition > this._owner.maxHorizontalScrollPosition)
					{
						horizontalScrollPosition = this._owner.maxHorizontalScrollPosition;
					}
					else if(horizontalScrollPosition < this._owner.minHorizontalScrollPosition)
					{
						horizontalScrollPosition = this._owner.minHorizontalScrollPosition;
					}
					this._owner.horizontalScrollPosition = horizontalScrollPosition;
				}
			}
		}

		protected function dragExitHandler(event:DragDropEvent):void
		{
			this._acceptedDrag = false;
			if(this._dropIndicatorSkin)
			{
				this._dropIndicatorSkin.removeFromParent(false);
			}
			this._dragLocalX = -1;
			this._dragLocalY = -1;
			this.removeEventListener(Event.ENTER_FRAME, dragScroll_enterFrameHandler);
		}

		protected function dragDropHandler(event:DragDropEvent):void
		{
			this._acceptedDrag = false;
			if(this._dropIndicatorSkin)
			{
				this._dropIndicatorSkin.removeFromParent(false);
			}
			this._dragLocalX = -1;
			this._dragLocalY = -1;
			this.removeEventListener(Event.ENTER_FRAME, dragScroll_enterFrameHandler);

			var item:Object = event.dragData.getDataForFormat(this._dragFormat);
			var dropIndex:int = this._dataProvider.length;
			if(this._layout is IDragDropLayout)
			{
				var layout:IDragDropLayout = IDragDropLayout(this._layout);
				dropIndex = layout.getDropIndex(
					this._horizontalScrollPosition + event.localX,
					this._verticalScrollPosition + event.localY,
					this._layoutItems, 0, 0, this.actualVisibleWidth, this.actualVisibleHeight);
			}
			var dropOffset:int = 0;
			if(event.dragSource == this._owner)
			{
				var oldIndex:int = this._dataProvider.getItemIndex(item);
				if(oldIndex < dropIndex)
				{
					dropOffset = -1;
				}

				//if we wait to remove this item in the dragComplete handler,
				//the wrong index might be removed.
				this._dataProvider.removeItem(item);
				this._droppedOnSelf = true;
			}
			this._dataProvider.addItemAt(item, dropIndex + dropOffset);
		}

		protected function dragCompleteHandler(event:DragDropEvent):void
		{
			if(!event.isDropped)
			{
				//nothing to modify
				return;
			}
			if(this._droppedOnSelf)
			{
				//already modified the data provider in the dragDrop handler
				this._droppedOnSelf = false;
				return;
			}
			var item:Object = event.dragData.getDataForFormat(this._dragFormat);
			this._dataProvider.removeItem(item);
		}

		protected function itemRenderer_drag_touchHandler(event:TouchEvent):void
		{
			if(!this._dragEnabled || !this.stage)
			{
				this._dragTouchPointID = -1;
				return;
			}
			var itemRenderer:IListItemRenderer = IListItemRenderer(event.currentTarget);
			if(DragDropManager.isDragging)
			{
				this._dragTouchPointID = -1;
				return;
			}
			if(itemRenderer is IDragAndDropItemRenderer)
			{
				var dragProxy:DisplayObject = IDragAndDropItemRenderer(itemRenderer).dragProxy;
				if(dragProxy)
				{
					var touch:Touch = event.getTouch(dragProxy, null, this._dragTouchPointID);
					if(!touch)
					{
						return;
					}
				}
			}
			if(this._dragTouchPointID != -1)
			{
				var exclusiveTouch:ExclusiveTouch = ExclusiveTouch.forStage(this.stage);
				if(exclusiveTouch.getClaim(this._dragTouchPointID))
				{
					this._dragTouchPointID = -1;
					return;
				}
				touch = event.getTouch(DisplayObject(itemRenderer), null, this._dragTouchPointID);
				if(touch.phase == TouchPhase.MOVED)
				{
					var point:Point = touch.getLocation(this, Pool.getPoint());
					var currentDragX:Number = point.x;
					var currentDragY:Number = point.y;
					Pool.putPoint(point);

					var starling:Starling = this.stage.starling;
					var verticalInchesMoved:Number = (currentDragX - this._startDragX) / (DeviceCapabilities.dpi / starling.contentScaleFactor);
					var horizontalInchesMoved:Number = (currentDragY - this._startDragY) / (DeviceCapabilities.dpi / starling.contentScaleFactor);
					if(Math.abs(horizontalInchesMoved) > this._minimumDragDropDistance ||
						Math.abs(verticalInchesMoved) > this._minimumDragDropDistance)
					{
						var dragData:DragData = new DragData();
						dragData.setDataForFormat(this._dragFormat, itemRenderer.data);

						//we don't create a new item renderer here because
						//it might remove accessories or icons from the original
						//item renderer that is still visible in the list.
						var avatar:RenderDelegate = new RenderDelegate(DisplayObject(itemRenderer));
						avatar.touchable = false;
						avatar.alpha = 0.8;

						this._droppedOnSelf = false;
						point = touch.getLocation(DisplayObject(itemRenderer), Pool.getPoint());
						DragDropManager.startDrag(this._owner, touch, dragData, DisplayObject(avatar), -point.x, -point.y);
						Pool.putPoint(point);
						exclusiveTouch.claimTouch(this._dragTouchPointID, DisplayObject(itemRenderer));
						this._dragTouchPointID = -1;
					}
				}
				else if(touch.phase == TouchPhase.ENDED)
				{
					this._dragTouchPointID = -1;
				}
			}
			else
			{
				//we aren't tracking another touch, so let's look for a new one.
				touch = event.getTouch(DisplayObject(itemRenderer), TouchPhase.BEGAN);
				if(!touch)
				{
					//we only care about the began phase. ignore all other
					//phases when we don't have a saved touch ID.
					return;
				}
				this._dragTouchPointID = touch.id;
				point = touch.getLocation(this, Pool.getPoint());
				this._startDragX = point.x;
				this._startDragY = point.y;
				Pool.putPoint(point);
			}
		}
	}
}

import feathers.controls.renderers.IListItemRenderer;

class ItemRendererFactoryStorage
{
	public function ItemRendererFactoryStorage()
	{

	}

	public var activeItemRenderers:Vector.<IListItemRenderer> = new <IListItemRenderer>[];
	public var inactiveItemRenderers:Vector.<IListItemRenderer> = new <IListItemRenderer>[];
}

================================================
FILE: source/feathers/controls/supportClasses/TextFieldViewPort.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.supportClasses
{
	import feathers.core.FeathersControl;
	import feathers.text.FontStylesSet;
	import feathers.utils.geom.matrixToRotation;
	import feathers.utils.geom.matrixToScaleX;
	import feathers.utils.geom.matrixToScaleY;

	import flash.display.Sprite;
	import flash.events.TextEvent;
	import flash.geom.Matrix;
	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.text.AntiAliasType;
	import flash.text.FontType;
	import flash.text.GridFitType;
	import flash.text.StyleSheet;
	import flash.text.TextField;
	import flash.text.TextFieldAutoSize;
	import flash.text.TextFormat;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.rendering.Painter;
	import starling.text.TextFormat;
	import starling.utils.MatrixUtil;
	import starling.utils.Pool;
	import starling.utils.SystemUtil;

	/**
	 * @private
	 * Used internally by ScrollText. Not meant to be used on its own.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class TextFieldViewPort extends FeathersControl implements IViewPort
	{
		public function TextFieldViewPort()
		{
			super();
			this.addEventListener(Event.ADDED_TO_STAGE, addedToStageHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, removedFromStageHandler);
		}

		private var _textFieldContainer:Sprite;
		private var _textField:TextField;

		/**
		 * @private
		 */
		public function get nativeFocus():TextField
		{
			return this._textField;
		}

		/**
		 * @private
		 */
		private var _text:String = "";

		/**
		 * @see feathers.controls.ScrollText#text
		 */
		public function get text():String
		{
			return this._text;
		}

		/**
		 * @private
		 */
		public function set text(value:String):void
		{
			if(!value)
			{
				value = "";
			}
			if(this._text == value)
			{
				return;
			}
			this._text = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		private var _isHTML:Boolean = false;

		/**
		 * @see feathers.controls.ScrollText#isHTML
		 */
		public function get isHTML():Boolean
		{
			return this._isHTML;
		}

		/**
		 * @private
		 */
		public function set isHTML(value:Boolean):void
		{
			if(this._isHTML == value)
			{
				return;
			}
			this._isHTML = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _fontStylesTextFormat:flash.text.TextFormat;

		/**
		 * @private
		 */
		protected var _fontStyles:FontStylesSet;

		/**
		 * Generic font styles.
		 */
		public function get fontStyles():FontStylesSet
		{
			return this._fontStyles;
		}

		/**
		 * @private
		 */
		public function set fontStyles(value:FontStylesSet):void
		{
			if(this._fontStyles === value)
			{
				return;
			}
			if(this._fontStyles !== null)
			{
				this._fontStyles.removeEventListener(Event.CHANGE, fontStylesSet_changeHandler);
			}
			this._fontStyles = value;
			if(this._fontStyles !== null)
			{
				this._fontStyles.addEventListener(Event.CHANGE, fontStylesSet_changeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _currentTextFormat:flash.text.TextFormat;

		/**
		 * @private
		 */
		private var _textFormat:flash.text.TextFormat;

		/**
		 * @see feathers.controls.ScrollText#textFormat
		 */
		public function get textFormat():flash.text.TextFormat
		{
			return this._textFormat;
		}

		/**
		 * @private
		 */
		public function set textFormat(value:flash.text.TextFormat):void
		{
			if(this._textFormat == value)
			{
				return;
			}
			this._textFormat = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _disabledTextFormat:flash.text.TextFormat;

		/**
		 * @see feathers.controls.ScrollText#disabledTextFormat
		 */
		public function get disabledTextFormat():flash.text.TextFormat
		{
			return this._disabledTextFormat;
		}

		/**
		 * @private
		 */
		public function set disabledTextFormat(value:flash.text.TextFormat):void
		{
			if(this._disabledTextFormat == value)
			{
				return;
			}
			this._disabledTextFormat = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _styleSheet:StyleSheet;

		/**
		 * @see feathers.controls.ScrollText#styleSheet
		 */
		public function get styleSheet():StyleSheet
		{
			return this._styleSheet;
		}

		/**
		 * @private
		 */
		public function set styleSheet(value:StyleSheet):void
		{
			if(this._styleSheet == value)
			{
				return;
			}
			this._styleSheet = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _embedFonts:Boolean = false;

		/**
		 * @see feathers.controls.ScrollText#embedFonts
		 */
		public function get embedFonts():Boolean
		{
			return this._embedFonts;
		}

		/**
		 * @private
		 */
		public function set embedFonts(value:Boolean):void
		{
			if(this._embedFonts == value)
			{
				return;
			}
			this._embedFonts = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _antiAliasType:String = AntiAliasType.ADVANCED;

		/**
		 * @see feathers.controls.ScrollText#antiAliasType
		 */
		public function get antiAliasType():String
		{
			return this._antiAliasType;
		}

		/**
		 * @private
		 */
		public function set antiAliasType(value:String):void
		{
			if(this._antiAliasType == value)
			{
				return;
			}
			this._antiAliasType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _background:Boolean = false;

		/**
		 * @see feathers.controls.ScrollText#background
		 */
		public function get background():Boolean
		{
			return this._background;
		}

		/**
		 * @private
		 */
		public function set background(value:Boolean):void
		{
			if(this._background == value)
			{
				return;
			}
			this._background = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _backgroundColor:uint = 0xffffff;

		/**
		 * @see feathers.controls.ScrollText#backgroundColor
		 */
		public function get backgroundColor():uint
		{
			return this._backgroundColor;
		}

		/**
		 * @private
		 */
		public function set backgroundColor(value:uint):void
		{
			if(this._backgroundColor == value)
			{
				return;
			}
			this._backgroundColor = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _border:Boolean = false;

		/**
		 * @see feathers.controls.ScrollText#border
		 */
		public function get border():Boolean
		{
			return this._border;
		}

		/**
		 * @private
		 */
		public function set border(value:Boolean):void
		{
			if(this._border == value)
			{
				return;
			}
			this._border = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _borderColor:uint = 0x000000;

		/**
		 * @see feathers.controls.ScrollText#borderColor
		 */
		public function get borderColor():uint
		{
			return this._borderColor;
		}

		/**
		 * @private
		 */
		public function set borderColor(value:uint):void
		{
			if(this._borderColor == value)
			{
				return;
			}
			this._borderColor = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _cacheAsBitmap:Boolean = true;

		/**
		 * @see feathers.controls.ScrollText#cacheAsBitmap
		 */
		public function get cacheAsBitmap():Boolean
		{
			return this._cacheAsBitmap;
		}

		/**
		 * @private
		 */
		public function set cacheAsBitmap(value:Boolean):void
		{
			if(this._cacheAsBitmap == value)
			{
				return;
			}
			this._cacheAsBitmap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _condenseWhite:Boolean = false;

		/**
		 * @see feathers.controls.ScrollText#condenseWhite
		 */
		public function get condenseWhite():Boolean
		{
			return this._condenseWhite;
		}

		/**
		 * @private
		 */
		public function set condenseWhite(value:Boolean):void
		{
			if(this._condenseWhite == value)
			{
				return;
			}
			this._condenseWhite = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _displayAsPassword:Boolean = false;

		/**
		 * @see feathers.controls.ScrollText#displayAsPassword
		 */
		public function get displayAsPassword():Boolean
		{
			return this._displayAsPassword;
		}

		/**
		 * @private
		 */
		public function set displayAsPassword(value:Boolean):void
		{
			if(this._displayAsPassword == value)
			{
				return;
			}
			this._displayAsPassword = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _gridFitType:String = GridFitType.PIXEL;

		/**
		 * @see feathers.controls.ScrollText#gridFitType
		 */
		public function get gridFitType():String
		{
			return this._gridFitType;
		}

		/**
		 * @private
		 */
		public function set gridFitType(value:String):void
		{
			if(this._gridFitType == value)
			{
				return;
			}
			this._gridFitType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _sharpness:Number = 0;

		/**
		 * @see feathers.controls.ScrollText#sharpness
		 */
		public function get sharpness():Number
		{
			return this._sharpness;
		}

		/**
		 * @private
		 */
		public function set sharpness(value:Number):void
		{
			if(this._sharpness == value)
			{
				return;
			}
			this._sharpness = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		private var _thickness:Number = 0;

		/**
		 * @see feathers.controls.ScrollText#thickness
		 */
		public function get thickness():Number
		{
			return this._thickness;
		}

		/**
		 * @private
		 */
		public function set thickness(value:Number):void
		{
			if(this._thickness == value)
			{
				return;
			}
			this._thickness = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private var _actualMinVisibleWidth:Number = 0;

		private var _explicitMinVisibleWidth:Number;

		public function get minVisibleWidth():Number
		{
			if(this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth) //isNaN
			{
				return this._actualMinVisibleWidth;
			}
			return this._explicitMinVisibleWidth;
		}

		public function set minVisibleWidth(value:Number):void
		{
			if(this._explicitMinVisibleWidth == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth) //isNaN
			{
				return;
			}
			var oldValue:Number = this._explicitMinVisibleWidth;
			this._explicitMinVisibleWidth = value;
			if(valueIsNaN)
			{
				this._actualMinVisibleWidth = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this._actualMinVisibleWidth = value;
				if(this._explicitVisibleWidth !== this._explicitVisibleWidth && //isNaN
					(this._actualVisibleWidth < value || this._actualVisibleWidth == oldValue))
				{
					//only invalidate if this change might affect the visibleWidth
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		private var _maxVisibleWidth:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleWidth():Number
		{
			return this._maxVisibleWidth;
		}

		public function set maxVisibleWidth(value:Number):void
		{
			if(this._maxVisibleWidth == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleWidth cannot be NaN");
			}
			var oldValue:Number = this._maxVisibleWidth;
			this._maxVisibleWidth = value;
			if(this._explicitVisibleWidth !== this._explicitVisibleWidth && //isNaN
				(this._actualVisibleWidth > value || this._actualVisibleWidth == oldValue))
			{
				//only invalidate if this change might affect the visibleWidth
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualVisibleWidth:Number = 0;

		private var _explicitVisibleWidth:Number = NaN;

		public function get visibleWidth():Number
		{
			if(this._explicitVisibleWidth !== this._explicitVisibleWidth) //isNaN
			{
				return this._actualVisibleWidth;
			}
			return this._explicitVisibleWidth;
		}

		public function set visibleWidth(value:Number):void
		{
			if(this._explicitVisibleWidth == value ||
				(value !== value && this._explicitVisibleWidth !== this._explicitVisibleWidth)) //isNaN
			{
				return;
			}
			this._explicitVisibleWidth = value;
			if(this._actualVisibleWidth != value)
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualMinVisibleHeight:Number = 0;

		private var _explicitMinVisibleHeight:Number;

		public function get minVisibleHeight():Number
		{
			if(this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight) //isNaN
			{
				return this._actualMinVisibleHeight;
			}
			return this._explicitMinVisibleHeight;
		}

		public function set minVisibleHeight(value:Number):void
		{
			if(this._explicitMinVisibleHeight == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight) //isNaN
			{
				return;
			}
			var oldValue:Number = this._explicitMinVisibleHeight;
			this._explicitMinVisibleHeight = value;
			if(valueIsNaN)
			{
				this._actualMinVisibleHeight = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this._actualMinVisibleHeight = value;
				if(this._explicitVisibleHeight !== this._explicitVisibleHeight && //isNaN
					(this._actualVisibleHeight < value || this._actualVisibleHeight == oldValue))
				{
					//only invalidate if this change might affect the visibleHeight
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		private var _maxVisibleHeight:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleHeight():Number
		{
			return this._maxVisibleHeight;
		}

		public function set maxVisibleHeight(value:Number):void
		{
			if(this._maxVisibleHeight == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleHeight cannot be NaN");
			}
			var oldValue:Number = this._maxVisibleHeight;
			this._maxVisibleHeight = value;
			if(this._explicitVisibleHeight !== this._explicitVisibleHeight && //isNaN
				(this._actualVisibleHeight > value || this._actualVisibleHeight == oldValue))
			{
				//only invalidate if this change might affect the visibleHeight
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualVisibleHeight:Number = 0;

		private var _explicitVisibleHeight:Number = NaN;

		public function get visibleHeight():Number
		{
			if(this._explicitVisibleHeight !== this._explicitVisibleHeight) //isNaN
			{
				return this._actualVisibleHeight;
			}
			return this._explicitVisibleHeight;
		}

		public function set visibleHeight(value:Number):void
		{
			if(this._explicitVisibleHeight == value ||
				(value !== value && this._explicitVisibleHeight !== this._explicitVisibleHeight)) //isNaN
			{
				return;
			}
			this._explicitVisibleHeight = value;
			if(this._actualVisibleHeight != value)
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		public function get contentX():Number
		{
			return 0;
		}

		public function get contentY():Number
		{
			return 0;
		}

		private var _scrollStep:Number;

		public function get horizontalScrollStep():Number
		{
			return this._scrollStep;
		}

		public function get verticalScrollStep():Number
		{
			return this._scrollStep;
		}

		private var _horizontalScrollPosition:Number = 0;

		public function get horizontalScrollPosition():Number
		{
			return this._horizontalScrollPosition;
		}

		public function set horizontalScrollPosition(value:Number):void
		{
			if(this._horizontalScrollPosition == value)
			{
				return;
			}
			this._horizontalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		private var _verticalScrollPosition:Number = 0;

		public function get verticalScrollPosition():Number
		{
			return this._verticalScrollPosition;
		}

		public function set verticalScrollPosition(value:Number):void
		{
			if(this._verticalScrollPosition == value)
			{
				return;
			}
			this._verticalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		public function get requiresMeasurementOnScroll():Boolean
		{
			return false;
		}

		private var _paddingTop:Number = 0;

		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		public function set paddingTop(value:Number):void
		{
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		private var _paddingRight:Number = 0;

		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		public function set paddingRight(value:Number):void
		{
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		private var _paddingBottom:Number = 0;

		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		public function set paddingBottom(value:Number):void
		{
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		private var _paddingLeft:Number = 0;

		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		public function set paddingLeft(value:Number):void
		{
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		override public function render(painter:Painter):void
		{
			//this component is an overlay above Starling, and it should be
			//excluded from the render cache
			painter.excludeFromCache(this);

			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var starlingViewPort:Rectangle = starling.viewPort;
			var matrix:Matrix = Pool.getMatrix();
			var point:Point = Pool.getPoint();
			this.parent.getTransformationMatrix(this.stage, matrix);
			MatrixUtil.transformCoords(matrix, 0, 0, point);
			var nativeScaleFactor:Number = 1;
			if(starling.supportHighResolutions)
			{
				nativeScaleFactor = starling.nativeStage.contentsScaleFactor;
			}
			var scaleFactor:Number = starling.contentScaleFactor / nativeScaleFactor;
			this._textFieldContainer.x = starlingViewPort.x + point.x * scaleFactor;
			this._textFieldContainer.y = starlingViewPort.y + point.y * scaleFactor;
			this._textFieldContainer.scaleX = matrixToScaleX(matrix) * scaleFactor;
			this._textFieldContainer.scaleY = matrixToScaleY(matrix) * scaleFactor;
			this._textFieldContainer.rotation = matrixToRotation(matrix) * 180 / Math.PI;
			this._textFieldContainer.alpha = painter.state.alpha;
			Pool.putPoint(point);
			Pool.putMatrix(matrix);
			super.render(painter);
		}

		override protected function initialize():void
		{
			this._textFieldContainer = new Sprite();
			this._textFieldContainer.visible = false;
			this._textField = new TextField();
			this._textField.autoSize = TextFieldAutoSize.LEFT;
			this._textField.selectable = false;
			this._textField.mouseWheelEnabled = false;
			this._textField.wordWrap = true;
			this._textField.multiline = true;
			this._textField.addEventListener(TextEvent.LINK, textField_linkHandler);
			this._textFieldContainer.addChild(this._textField);
		}

		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var scrollInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SCROLL);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);

			if(stylesInvalid)
			{
				this.refreshTextFormat();
				this._textField.antiAliasType = this._antiAliasType;
				this._textField.background = this._background;
				this._textField.backgroundColor = this._backgroundColor;
				this._textField.border = this._border;
				this._textField.borderColor = this._borderColor;
				this._textField.condenseWhite = this._condenseWhite;
				this._textField.displayAsPassword = this._displayAsPassword;
				this._textField.gridFitType = this._gridFitType;
				this._textField.sharpness = this._sharpness;
				this._textField.thickness = this._thickness;
				this._textField.cacheAsBitmap = this._cacheAsBitmap;
				this._textField.x = this._paddingLeft;
				this._textField.y = this._paddingTop;
			}

			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			if(dataInvalid || stylesInvalid || stateInvalid)
			{
				if(this._styleSheet !== null)
				{
					this._textField.embedFonts = this._embedFonts;
					this._textField.styleSheet = this._styleSheet;
				}
				else
				{
					if(!this._embedFonts &&
						this._currentTextFormat === this._fontStylesTextFormat)
					{
						//when font styles are passed in from the parent component, we
						//automatically determine if the TextField should use embedded
						//fonts, unless embedFonts is explicitly true
						this._textField.embedFonts = SystemUtil.isEmbeddedFont(
							this._currentTextFormat.font, this._currentTextFormat.bold,
							this._currentTextFormat.italic, FontType.EMBEDDED);
					}
					else
					{
						this._textField.embedFonts = this._embedFonts;
					}
					this._textField.styleSheet = null;
					this._textField.defaultTextFormat = this._currentTextFormat;
				}
				if(this._isHTML)
				{
					this._textField.htmlText = this._text;
				}
				else
				{
					this._textField.text = this._text;
				}
				this._scrollStep = this._textField.getLineMetrics(0).height * starling.contentScaleFactor;
			}

			var calculatedVisibleWidth:Number = this._explicitVisibleWidth;
			if(calculatedVisibleWidth != calculatedVisibleWidth)
			{
				if(this.stage !== null)
				{
					calculatedVisibleWidth = this.stage.stageWidth;
				}
				else
				{
					calculatedVisibleWidth = starling.stage.stageWidth;
				}
				if(calculatedVisibleWidth < this._explicitMinVisibleWidth)
				{
					calculatedVisibleWidth = this._explicitMinVisibleWidth;
				}
				else if(calculatedVisibleWidth > this._maxVisibleWidth)
				{
					calculatedVisibleWidth = this._maxVisibleWidth;
				}
			}
			this._textField.width = calculatedVisibleWidth - this._paddingLeft - this._paddingRight;
			var totalContentHeight:Number = this._textField.height + this._paddingTop + this._paddingBottom;
			var calculatedVisibleHeight:Number = this._explicitVisibleHeight;
			if(calculatedVisibleHeight != calculatedVisibleHeight)
			{
				calculatedVisibleHeight = totalContentHeight;
				if(calculatedVisibleHeight < this._explicitMinVisibleHeight)
				{
					calculatedVisibleHeight = this._explicitMinVisibleHeight;
				}
				else if(calculatedVisibleHeight > this._maxVisibleHeight)
				{
					calculatedVisibleHeight = this._maxVisibleHeight;
				}
			}
			sizeInvalid = this.saveMeasurements(
				calculatedVisibleWidth, totalContentHeight,
				calculatedVisibleWidth, totalContentHeight) || sizeInvalid;
			this._actualVisibleWidth = calculatedVisibleWidth;
			this._actualVisibleHeight = calculatedVisibleHeight;
			this._actualMinVisibleWidth = calculatedVisibleWidth;
			this._actualMinVisibleHeight = calculatedVisibleHeight;

			if(sizeInvalid || scrollInvalid)
			{
				var scrollRect:Rectangle = this._textFieldContainer.scrollRect;
				if(!scrollRect)
				{
					scrollRect = new Rectangle();
				}
				scrollRect.width = calculatedVisibleWidth;
				scrollRect.height = calculatedVisibleHeight;
				scrollRect.x = this._horizontalScrollPosition;
				scrollRect.y = this._verticalScrollPosition;
				this._textFieldContainer.scrollRect = scrollRect;
			}
		}

		protected function refreshTextFormat():void
		{
			if(!this._isEnabled && this._disabledTextFormat !== null)
			{
				this._currentTextFormat = this._disabledTextFormat;
			}
			else if(this._textFormat !== null)
			{
				this._currentTextFormat = this._textFormat;
			}
			else if(this._fontStyles !== null)
			{
				this._currentTextFormat = this.getTextFormatFromFontStyles();
			}
		}

		protected function getTextFormatFromFontStyles():flash.text.TextFormat
		{
			if(this.isInvalid(INVALIDATION_FLAG_STYLES) ||
				this.isInvalid(INVALIDATION_FLAG_STATE))
			{
				var fontStylesFormat:starling.text.TextFormat;
				if(this._fontStyles !== null)
				{
					fontStylesFormat = this._fontStyles.getTextFormatForTarget(this);
				}
				if(fontStylesFormat !== null)
				{
					this._fontStylesTextFormat = fontStylesFormat.toNativeFormat(this._fontStylesTextFormat);
				}
				else if(this._fontStylesTextFormat === null)
				{
					//fallback to a default so that something is displayed
					this._fontStylesTextFormat = new flash.text.TextFormat();
				}
			}
			return this._fontStylesTextFormat;
		}

		private function addedToStageHandler(event:Event):void
		{
			this.stage.starling.nativeStage.addChild(this._textFieldContainer);
			this.addEventListener(Event.ENTER_FRAME, enterFrameHandler);
		}

		private function removedFromStageHandler(event:Event):void
		{
			this.stage.starling.nativeStage.removeChild(this._textFieldContainer);
			this.removeEventListener(Event.ENTER_FRAME, enterFrameHandler);
		}

		private function enterFrameHandler(event:Event):void
		{
			var target:DisplayObject = this;
			do
			{
				if(!target.visible)
				{
					this._textFieldContainer.visible = false;
					return;
				}
				target = target.parent;
			}
			while(target);
			this._textFieldContainer.visible = true;
		}

		protected function textField_linkHandler(event:TextEvent):void
		{
			this.dispatchEventWith(Event.TRIGGERED, false, event.text);
		}

		protected function fontStylesSet_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}
	}
}


================================================
FILE: source/feathers/controls/supportClasses/TreeDataViewPort.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.supportClasses
{
	import feathers.controls.Scroller;
	import feathers.controls.Tree;
	import feathers.controls.renderers.ITreeItemRenderer;
	import feathers.core.FeathersControl;
	import feathers.core.IFeathersControl;
	import feathers.core.IValidating;
	import feathers.data.IHierarchicalCollection;
	import feathers.data.IListCollection;
	import feathers.events.FeathersEventType;
	import feathers.layout.ILayout;
	import feathers.layout.IVariableVirtualLayout;
	import feathers.layout.IVirtualLayout;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.ViewPortBounds;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;
	import flash.utils.Dictionary;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.utils.Pool;

	/**
	 * @private
	 * Used internally by Tree. Not meant to be used on its own.
	 *
	 * @productversion Feathers 3.3.0
	 */
	public class TreeDataViewPort extends FeathersControl implements IViewPort
	{
		private static const INVALIDATION_FLAG_ITEM_RENDERER_FACTORY:String = "itemRendererFactory";
		private static const HELPER_VECTOR:Vector.<int> = new <int>[];
		private static const LOCATION_HELPER_VECTOR:Vector.<int> = new <int>[];

		public function TreeDataViewPort()
		{
			super();
		}

		private var _viewPortBounds:ViewPortBounds = new ViewPortBounds();

		private var _layoutResult:LayoutBoundsResult = new LayoutBoundsResult();

		private var _actualMinVisibleWidth:Number = 0;

		private var _explicitMinVisibleWidth:Number;

		public function get minVisibleWidth():Number
		{
			if(this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth) //isNaN
			{
				return this._actualMinVisibleWidth;
			}
			return this._explicitMinVisibleWidth;
		}

		public function set minVisibleWidth(value:Number):void
		{
			if(this._explicitMinVisibleWidth == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth) //isNaN
			{
				return;
			}
			var oldValue:Number = this._explicitMinVisibleWidth;
			this._explicitMinVisibleWidth = value;
			if(valueIsNaN)
			{
				this._actualMinVisibleWidth = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this._actualMinVisibleWidth = value;
				if(this._explicitVisibleWidth !== this._explicitVisibleWidth && //isNaN
					(this._actualVisibleWidth < value || this._actualVisibleWidth == oldValue))
				{
					//only invalidate if this change might affect the visibleWidth
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		private var _maxVisibleWidth:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleWidth():Number
		{
			return this._maxVisibleWidth;
		}

		public function set maxVisibleWidth(value:Number):void
		{
			if(this._maxVisibleWidth == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleWidth cannot be NaN");
			}
			var oldValue:Number = this._maxVisibleWidth;
			this._maxVisibleWidth = value;
			if(this._explicitVisibleWidth !== this._explicitVisibleWidth && //isNaN
				(this._actualVisibleWidth > value || this._actualVisibleWidth == oldValue))
			{
				//only invalidate if this change might affect the visibleWidth
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualVisibleWidth:Number = NaN;

		private var _explicitVisibleWidth:Number = NaN;

		public function get visibleWidth():Number
		{
			return this._actualVisibleWidth;
		}

		public function set visibleWidth(value:Number):void
		{
			if(this._explicitVisibleWidth == value ||
				(value !== value && this._explicitVisibleWidth !== this._explicitVisibleWidth)) //isNaN
			{
				return;
			}
			this._explicitVisibleWidth = value;
			if(this._actualVisibleWidth != value)
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualMinVisibleHeight:Number = 0;

		private var _explicitMinVisibleHeight:Number;

		public function get minVisibleHeight():Number
		{
			if(this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight) //isNaN
			{
				return this._actualMinVisibleHeight;
			}
			return this._explicitMinVisibleHeight;
		}

		public function set minVisibleHeight(value:Number):void
		{
			if(this._explicitMinVisibleHeight == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight) //isNaN
			{
				return;
			}
			var oldValue:Number = this._explicitMinVisibleHeight;
			this._explicitMinVisibleHeight = value;
			if(valueIsNaN)
			{
				this._actualMinVisibleHeight = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this._actualMinVisibleHeight = value;
				if(this._explicitVisibleHeight !== this._explicitVisibleHeight && //isNaN
					(this._actualVisibleHeight < value || this._actualVisibleHeight == oldValue))
				{
					//only invalidate if this change might affect the visibleHeight
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		private var _maxVisibleHeight:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleHeight():Number
		{
			return this._maxVisibleHeight;
		}

		public function set maxVisibleHeight(value:Number):void
		{
			if(this._maxVisibleHeight == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleHeight cannot be NaN");
			}
			var oldValue:Number = this._maxVisibleHeight;
			this._maxVisibleHeight = value;
			if(this._explicitVisibleHeight !== this._explicitVisibleHeight && //isNaN
				(this._actualVisibleHeight > value || this._actualVisibleHeight == oldValue))
			{
				//only invalidate if this change might affect the visibleHeight
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualVisibleHeight:Number;

		private var _explicitVisibleHeight:Number = NaN;

		public function get visibleHeight():Number
		{
			return this._actualVisibleHeight;
		}

		public function set visibleHeight(value:Number):void
		{
			if(this._explicitVisibleHeight == value ||
				(value !== value && this._explicitVisibleHeight !== this._explicitVisibleHeight)) //isNaN
			{
				return;
			}
			this._explicitVisibleHeight = value;
			if(this._actualVisibleHeight != value)
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		protected var _contentX:Number = 0;

		public function get contentX():Number
		{
			return this._contentX;
		}

		protected var _contentY:Number = 0;

		public function get contentY():Number
		{
			return this._contentY;
		}

		public function get horizontalScrollStep():Number
		{
			var itemRenderer:DisplayObject = null;
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			if(virtualLayout === null || !virtualLayout.useVirtualLayout)
			{
				if(this._layoutItems.length > 0)
				{
					itemRenderer = this._layoutItems[0] as DisplayObject;
				}
			}
			if(itemRenderer === null)
			{
				itemRenderer = this._typicalItemRenderer as DisplayObject;
			}
			if(itemRenderer === null)
			{
				return 0;
			}
			var itemRendererWidth:Number = itemRenderer.width;
			var itemRendererHeight:Number = itemRenderer.height;
			if(itemRendererWidth < itemRendererHeight)
			{
				return itemRendererWidth;
			}
			return itemRendererHeight;
		}

		public function get verticalScrollStep():Number
		{
			var itemRenderer:DisplayObject = null;
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			if(virtualLayout === null || !virtualLayout.useVirtualLayout)
			{
				if(this._layoutItems.length > 0)
				{
					itemRenderer = this._layoutItems[0] as DisplayObject;
				}
			}
			if(itemRenderer === null)
			{
				itemRenderer = this._typicalItemRenderer as DisplayObject;
			}
			if(itemRenderer === null)
			{
				return 0;
			}
			var itemRendererWidth:Number = itemRenderer.width;
			var itemRendererHeight:Number = itemRenderer.height;
			if(itemRendererWidth < itemRendererHeight)
			{
				return itemRendererWidth;
			}
			return itemRendererHeight;
		}

		private var _owner:Tree = null;

		public function get owner():Tree
		{
			return this._owner;
		}

		public function set owner(value:Tree):void
		{
			this._owner = value;
		}

		private var _updateForDataReset:Boolean = false;

		private var _dataProvider:IHierarchicalCollection = null;

		public function get dataProvider():IHierarchicalCollection
		{
			return this._dataProvider;
		}

		public function set dataProvider(value:IHierarchicalCollection):void
		{
			if(this._dataProvider == value)
			{
				return;
			}
			if(this._dataProvider)
			{
				this._dataProvider.removeEventListener(Event.CHANGE, dataProvider_changeHandler);
				/*this._dataProvider.removeEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.removeEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.UPDATE_ITEM, dataProvider_updateItemHandler);
				this._dataProvider.removeEventListener(CollectionEventType.UPDATE_ALL, dataProvider_updateAllHandler);*/
			}
			this._dataProvider = value;
			if(this._dataProvider)
			{
				this._dataProvider.addEventListener(Event.CHANGE, dataProvider_changeHandler);
				/*this._dataProvider.addEventListener(CollectionEventType.RESET, dataProvider_resetHandler);
				this._dataProvider.addEventListener(CollectionEventType.ADD_ITEM, dataProvider_addItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REMOVE_ITEM, dataProvider_removeItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.REPLACE_ITEM, dataProvider_replaceItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.UPDATE_ITEM, dataProvider_updateItemHandler);
				this._dataProvider.addEventListener(CollectionEventType.UPDATE_ALL, dataProvider_updateAllHandler);*/
			}
			if(this._layout is IVariableVirtualLayout)
			{
				IVariableVirtualLayout(this._layout).resetVariableVirtualCache();
			}
			this._updateForDataReset = true;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private var _ignoreLayoutChanges:Boolean = false;
		private var _ignoreRendererResizing:Boolean = false;

		private var _layout:ILayout = null;

		public function get layout():ILayout
		{
			return this._layout;
		}

		public function set layout(value:ILayout):void
		{
			if(this._layout == value)
			{
				return;
			}
			if(this._layout)
			{
				this._layout.removeEventListener(Event.CHANGE, layout_changeHandler);
			}
			this._layout = value;
			if(this._layout)
			{
				if(this._layout is IVariableVirtualLayout)
				{
					var variableVirtualLayout:IVariableVirtualLayout = IVariableVirtualLayout(this._layout);
					variableVirtualLayout.resetVariableVirtualCache();
				}
				this._layout.addEventListener(Event.CHANGE, layout_changeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
		}

		private var _horizontalScrollPosition:Number = 0;

		public function get horizontalScrollPosition():Number
		{
			return this._horizontalScrollPosition;
		}

		public function set horizontalScrollPosition(value:Number):void
		{
			if(this._horizontalScrollPosition == value)
			{
				return;
			}
			this._horizontalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		private var _verticalScrollPosition:Number = 0;

		public function get verticalScrollPosition():Number
		{
			return this._verticalScrollPosition;
		}

		public function set verticalScrollPosition(value:Number):void
		{
			if(this._verticalScrollPosition == value)
			{
				return;
			}
			this._verticalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		public function get requiresMeasurementOnScroll():Boolean
		{
			return this._layout.requiresLayoutOnScroll &&
				(this._explicitVisibleWidth !== this._explicitVisibleWidth || //isNaN
				this._explicitVisibleHeight !== this._explicitVisibleHeight); //isNaN
		}

		private var _ignoreSelectionChanges:Boolean = false;

		private var _isSelectable:Boolean = true;

		public function get isSelectable():Boolean
		{
			return this._isSelectable;
		}

		public function set isSelectable(value:Boolean):void
		{
			if(this._isSelectable == value)
			{
				return;
			}
			this._isSelectable = value;
			if(!this._isSelectable)
			{
				this.selectedItem = null;
			}
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		private var _selectedItem:Object = null;

		public function get selectedItem():Object
		{
			return this._selectedItem;
		}

		public function set selectedItem(value:Object):void
		{
			if(this._selectedItem == value)
			{
				return;
			}
			this._selectedItem = value;
			this.invalidate(INVALIDATION_FLAG_SELECTED);
			this.dispatchEventWith(Event.CHANGE);
		}

		private var _typicalItem:Object = null;

		public function get typicalItem():Object
		{
			return this._typicalItem;
		}

		public function set typicalItem(value:Object):void
		{
			if(this._typicalItem == value)
			{
				return;
			}
			this._typicalItem = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private var _itemRendererType:Class;

		public function get itemRendererType():Class
		{
			return this._itemRendererType;
		}

		public function set itemRendererType(value:Class):void
		{
			if(this._itemRendererType == value)
			{
				return;
			}

			this._itemRendererType = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _itemRendererFactory:Function;

		public function get itemRendererFactory():Function
		{
			return this._itemRendererFactory;
		}

		public function set itemRendererFactory(value:Function):void
		{
			if(this._itemRendererFactory === value)
			{
				return;
			}

			this._itemRendererFactory = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _itemRendererFactories:Object;

		public function get itemRendererFactories():Object
		{
			return this._itemRendererFactories;
		}

		public function set itemRendererFactories(value:Object):void
		{
			if(this._itemRendererFactories === value)
			{
				return;
			}

			this._itemRendererFactories = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _factoryIDFunction:Function;

		public function get factoryIDFunction():Function
		{
			return this._factoryIDFunction;
		}

		public function set factoryIDFunction(value:Function):void
		{
			if(this._factoryIDFunction === value)
			{
				return;
			}

			this._factoryIDFunction = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _customItemRendererStyleName:String;

		public function get customItemRendererStyleName():String
		{
			return this._customItemRendererStyleName;
		}

		public function set customItemRendererStyleName(value:String):void
		{
			if(this._customItemRendererStyleName == value)
			{
				return;
			}
			this._customItemRendererStyleName = value;
			this.invalidate(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
		}

		private var _openBranches:IListCollection;

		public function get openBranches():IListCollection
		{
			return this._openBranches;
		}

		public function set openBranches(value:IListCollection):void
		{
			if(this._openBranches == value)
			{
				return;
			}
			if(this._openBranches !== null)
			{
				this._openBranches.removeEventListener(Event.CHANGE, openBranches_changeHandler);
			}
			this._openBranches = value;
			if(this._openBranches !== null)
			{
				this._openBranches.addEventListener(Event.CHANGE, openBranches_changeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private var _typicalItemIsInDataProvider:Boolean = false;
		private var _typicalItemRenderer:ITreeItemRenderer;

		private var _layoutItems:Vector.<DisplayObject> = new <DisplayObject>[];

		private var _unrenderedItems:Array = [];
		private var _defaultItemRendererStorage:ItemRendererFactoryStorage = new ItemRendererFactoryStorage();
		private var _itemStorageMap:Object = {};
		private var _itemRendererMap:Dictionary = new Dictionary(true);
		private var _minimumItemCount:int;

		public function calculateNavigationDestination(location:Vector.<int>, keyCode:uint, result:Vector.<int>):void
		{
			var displayIndex:int = this.locationToDisplayIndex(location, false);
			if(displayIndex == -1)
			{
				throw new ArgumentError("Cannot calculate navigation destination for location: " + location);
			}
			var newDisplayIndex:int = this._layout.calculateNavigationDestination(this._layoutItems, displayIndex, keyCode, this._layoutResult);
			this.displayIndexToLocation(newDisplayIndex, result);
		}

		public function getScrollPositionForLocation(location:Vector.<int>, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}

			var displayIndex:int = this.locationToDisplayIndex(location, true);
			if(displayIndex == -1)
			{
				throw new ArgumentError("Cannot calculate scroll position for location: " + location);
			}
			return this._layout.getScrollPositionForIndex(displayIndex, this._layoutItems,
				0, 0, this._actualVisibleWidth, this._actualVisibleHeight, result);
		}

		public function getNearestScrollPositionForIndex(location:Vector.<int>, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}

			var displayIndex:int = this.locationToDisplayIndex(location, true);
			if(displayIndex == -1)
			{
				throw new ArgumentError("Cannot calculate nearest scroll position for location: " + location);
			}
			return this._layout.getNearestScrollPositionForIndex(displayIndex, this._horizontalScrollPosition,
				this._verticalScrollPosition, this._layoutItems, 0, 0, this._actualVisibleWidth, this._actualVisibleHeight, result);
		}

		public function itemToItemRenderer(item:Object):ITreeItemRenderer
		{
			if(item is XML || item is XMLList)
			{
				return ITreeItemRenderer(this._itemRendererMap[item.toXMLString()]);
			}
			return ITreeItemRenderer(this._itemRendererMap[item]);
		}

		override public function dispose():void
		{
			this.refreshInactiveItemRenderers(null, true);
			if(this._itemStorageMap)
			{
				for(var factoryID:String in this._itemStorageMap)
				{
					this.refreshInactiveItemRenderers(factoryID, true);
				}
			}
			this.owner = null;
			this.dataProvider = null;
			this.layout = null;
			super.dispose();
		}

		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var scrollInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SCROLL);
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);
			var selectionInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SELECTED);
			var itemRendererInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_ITEM_RENDERER_FACTORY);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var layoutInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_LAYOUT);

			//scrolling only affects the layout is requiresLayoutOnScroll is true
			if(!layoutInvalid && scrollInvalid && this._layout && this._layout.requiresLayoutOnScroll)
			{
				layoutInvalid = true;
			}

			var basicsInvalid:Boolean = sizeInvalid || dataInvalid || layoutInvalid || itemRendererInvalid;

			var oldIgnoreRendererResizing:Boolean = this._ignoreRendererResizing;
			this._ignoreRendererResizing = true;
			var oldIgnoreLayoutChanges:Boolean = this._ignoreLayoutChanges;
			this._ignoreLayoutChanges = true;

			if(scrollInvalid || sizeInvalid)
			{
				this.refreshViewPortBounds();
			}
			if(basicsInvalid)
			{
				this.refreshInactiveItemRenderers(null, itemRendererInvalid);
				if(this._itemStorageMap)
				{
					for(var factoryID:String in this._itemStorageMap)
					{
						this.refreshInactiveItemRenderers(factoryID, itemRendererInvalid);
					}
				}
			}
			if(dataInvalid || layoutInvalid || itemRendererInvalid)
			{
				this.refreshLayoutTypicalItem();
			}
			if(basicsInvalid)
			{
				this.refreshItemRenderers();
			}
			if(selectionInvalid || basicsInvalid)
			{
				//unlike resizing renderers and layout changes, we only want to
				//stop listening for selection changes when we're forcibly
				//updating selection. other property changes on item renderers
				//can validly change selection, and we need to detect that.
				var oldIgnoreSelectionChanges:Boolean = this._ignoreSelectionChanges;
				this._ignoreSelectionChanges = true;
				this.refreshSelection();
				this._ignoreSelectionChanges = oldIgnoreSelectionChanges;
			}
			if(stateInvalid || basicsInvalid)
			{
				this.refreshEnabled();
			}
			this._ignoreLayoutChanges = oldIgnoreLayoutChanges;

			if(stateInvalid || selectionInvalid || stylesInvalid || basicsInvalid)
			{
				this._layout.layout(this._layoutItems, this._viewPortBounds, this._layoutResult);
			}

			this._ignoreRendererResizing = oldIgnoreRendererResizing;

			this._contentX = this._layoutResult.contentX;
			this._contentY = this._layoutResult.contentY;
			this.saveMeasurements(this._layoutResult.contentWidth, this._layoutResult.contentHeight,
				this._layoutResult.contentWidth, this._layoutResult.contentHeight);
			this._actualVisibleWidth = this._layoutResult.viewPortWidth;
			this._actualVisibleHeight = this._layoutResult.viewPortHeight;
			this._actualMinVisibleWidth = this._layoutResult.viewPortWidth;
			this._actualMinVisibleHeight = this._layoutResult.viewPortHeight;

			//final validation to avoid juggler next frame issues
			this.validateRenderers();
		}

		private function displayIndexToLocation(displayIndex:int, result:Vector.<int>):void
		{
		}

		private var _displayIndex:int;

		private function locationToDisplayIndex(location:Vector.<int>, returnNearestIfBranchNotOpen:Boolean):int
		{
			this._displayIndex = -1;
			var result:Object = this.locationToDisplayIndexAtBranch(new <int>[], location, returnNearestIfBranchNotOpen);
			if(result !== null)
			{
				return this._displayIndex;
			}
			return -1;
		}

		private function locationToDisplayIndexAtBranch(locationOfBranch:Vector.<int>, locationToFind:Vector.<int>, returnNearestIfBranchNotOpen:Boolean):Object
		{
			var childCount:int = this._dataProvider.getLengthAtLocation(locationOfBranch);
			for(var i:int = 0; i < childCount; i++)
			{
				this._displayIndex++;
				locationOfBranch[locationOfBranch.length] = i;
				var child:Object = this._dataProvider.getItemAtLocation(locationOfBranch);
				if(locationOfBranch.length == locationToFind.length)
				{
					var every:Boolean = locationOfBranch.every(function(item:int, index:int, source:Vector.<int>):Boolean
					{
						return item === locationToFind[index];
					});
					if(every)
					{
						return child;
					}
				}
				if(this._dataProvider.isBranch(child))
				{
					if(this.owner.isBranchOpen(child))
					{
						var result:Object = this.locationToDisplayIndexAtBranch(locationOfBranch, locationToFind, returnNearestIfBranchNotOpen);
						if(result)
						{
							return result;
						}
					}
					else if(returnNearestIfBranchNotOpen)
					{
						//if the location is inside a closed branch
						//return that branch
						every = locationOfBranch.every(function(item:int, index:int, source:Vector.<int>):Boolean
						{
							return item === locationToFind[index];
						});
						if(every)
						{
							return child;
						}
					}
				}
				locationOfBranch.length--;
			}
			//location was not found!
			return null;
		}

		private function refreshViewPortBounds():void
		{
			var needsMinWidth:Boolean = this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight; //isNaN
			this._viewPortBounds.x = 0;
			this._viewPortBounds.y = 0;
			this._viewPortBounds.scrollX = this._horizontalScrollPosition;
			this._viewPortBounds.scrollY = this._verticalScrollPosition;
			this._viewPortBounds.explicitWidth = this._explicitVisibleWidth;
			this._viewPortBounds.explicitHeight = this._explicitVisibleHeight;
			if(needsMinWidth)
			{
				this._viewPortBounds.minWidth = 0;
			}
			else
			{
				this._viewPortBounds.minWidth = this._explicitMinVisibleWidth;
			}
			if(needsMinHeight)
			{
				this._viewPortBounds.minHeight = 0;
			}
			else
			{
				this._viewPortBounds.minHeight = this._explicitMinVisibleHeight;
			}
			this._viewPortBounds.maxWidth = this._maxVisibleWidth;
			this._viewPortBounds.maxHeight = this._maxVisibleHeight;
		}

		private function refreshLayoutTypicalItem():void
		{
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			if(virtualLayout === null || !virtualLayout.useVirtualLayout)
			{
				//the old layout was virtual, but this one isn't
				if(!this._typicalItemIsInDataProvider && this._typicalItemRenderer !== null)
				{
					//it's safe to destroy this renderer
					this.destroyItemRenderer(this._typicalItemRenderer);
					this._typicalItemRenderer = null;
				}
				return;
			}
			var typicalItemLocation:Vector.<int> = null;
			var newTypicalItemIsInDataProvider:Boolean = false;
			var typicalItem:Object = this._typicalItem;
			if(typicalItem !== null)
			{
				if(this._dataProvider !== null)
				{
					typicalItemLocation = this._dataProvider.getItemLocation(typicalItem);
					newTypicalItemIsInDataProvider = typicalItemLocation !== null && typicalItemLocation.length > 0;
				}
			}
			else
			{
				if(this._dataProvider !== null && this._dataProvider.getLengthAtLocation() > 0)
				{
					newTypicalItemIsInDataProvider = true;
					typicalItem = this._dataProvider.getItemAt(0);
					typicalItemLocation = new <int>[0];
				}
			}

			//#1645 The typicalItem can be null if the data provider contains
			//a null value at index 0. this is the only time we allow null.
			if(typicalItem !== null || newTypicalItemIsInDataProvider)
			{
				var typicalItemRenderer:ITreeItemRenderer = this.itemToItemRenderer(typicalItem);
				if(typicalItemRenderer !== null)
				{
					//at this point, the item already has an item renderer.
					//(this doesn't necessarily mean that the current typical
					//item was the typical item last time this function was
					//called)

					//the location may have changed if items were added,
					//removed or reordered in the data provider
					typicalItemRenderer.location = typicalItemLocation;
				}
				if(typicalItemRenderer === null && this._typicalItemRenderer !== null)
				{
					//the typical item has changed, and doesn't have an item
					//renderer yet. the previous typical item had an item
					//renderer, so we will try to reuse it.

					//we can reuse the existing typical item renderer if the old
					//typical item wasn't in the data provider. otherwise, it
					//may still be needed for the same item.
					var canReuse:Boolean = !this._typicalItemIsInDataProvider;
					var oldTypicalItemRemoved:Boolean = this._typicalItemIsInDataProvider &&
						this._dataProvider !== null && this._dataProvider.getItemLocation(this._typicalItemRenderer.data) === null;
					if(!canReuse && oldTypicalItemRemoved)
					{
						//special case: if the old typical item was in the data
						//provider, but it has been removed, it's safe to reuse.
						canReuse = true;
					}
					if(canReuse)
					{
						//we can't reuse if the factoryID has changed, though!
						var factoryID:String = null;
						if(this._factoryIDFunction !== null)
						{
							factoryID = this.getFactoryID(typicalItem, typicalItemLocation);
						}
						if(this._typicalItemRenderer.factoryID !== factoryID)
						{
							canReuse = false;
						}
					}
					if(canReuse)
					{
						//we can reuse the item renderer used for the old
						//typical item!

						//if the old typical item was in the data provider,
						//remove it from the renderer map.
						if(this._typicalItemIsInDataProvider)
						{
							var oldData:Object = this._typicalItemRenderer.data;
							if(oldData is XML || oldData is XMLList)
							{
								delete this._itemRendererMap[oldData.toXMLString()];
							}
							else
							{
								delete this._itemRendererMap[oldData];
							}
						}
						typicalItemRenderer = this._typicalItemRenderer;
						typicalItemRenderer.data = typicalItem;
						typicalItemRenderer.location = typicalItemLocation;
						//if the new typical item is in the data provider, add it
						//to the renderer map.
						if(newTypicalItemIsInDataProvider)
						{
							if(typicalItem is XML || typicalItem is XMLList)
							{
								this._itemRendererMap[typicalItem.toXMLString()] = typicalItemRenderer;
							}
							else
							{
								this._itemRendererMap[typicalItem] = typicalItemRenderer;
							}
						}
					}
				}
				if(typicalItemRenderer === null)
				{
					//if we still don't have a typical item renderer, we need to
					//create a new one.
					typicalItemRenderer = this.createItemRenderer(typicalItem, typicalItemLocation, 0, false, !newTypicalItemIsInDataProvider);
					if(!this._typicalItemIsInDataProvider && this._typicalItemRenderer !== null)
					{
						//get rid of the old typical item renderer if it isn't
						//needed anymore.  since it was not in the data
						//provider, we don't need to mess with the renderer map
						//dictionary or dispatch any events.
						this.destroyItemRenderer(this._typicalItemRenderer);
						this._typicalItemRenderer = null;
					}
				}
			}

			virtualLayout.typicalItem = DisplayObject(typicalItemRenderer);
			this._typicalItemRenderer = typicalItemRenderer;
			this._typicalItemIsInDataProvider = newTypicalItemIsInDataProvider;
			if(this._typicalItemRenderer !== null && !this._typicalItemIsInDataProvider)
			{
				//we need to know if this item renderer resizes to adjust the
				//layout because the layout may use this item renderer to resize
				//the other item renderers
				this._typicalItemRenderer.addEventListener(FeathersEventType.RESIZE, itemRenderer_resizeHandler);
			}
		}

		private function refreshItemRenderers():void
		{
			if(this._typicalItemRenderer !== null && this._typicalItemIsInDataProvider)
			{
				var storage:ItemRendererFactoryStorage = this.factoryIDToStorage(this._typicalItemRenderer.factoryID);
				var inactiveItemRenderers:Vector.<ITreeItemRenderer> = storage.inactiveItemRenderers;
				var activeItemRenderers:Vector.<ITreeItemRenderer> = storage.activeItemRenderers;
				//this renderer is already is use by the typical item, so we
				//don't want to allow it to be used by other items.
				var inactiveIndex:int = inactiveItemRenderers.indexOf(this._typicalItemRenderer);
				if(inactiveIndex >= 0)
				{
					inactiveItemRenderers[inactiveIndex] = null;
				}
				//if refreshLayoutTypicalItem() was called, it will have already
				//added the typical item renderer to the active renderers. if
				//not, we need to do it here.
				var activeRendererCount:int = activeItemRenderers.length;
				if(activeRendererCount == 0)
				{
					activeItemRenderers[activeRendererCount] = this._typicalItemRenderer;
				}
			}

			this.findUnrenderedData();
			this.recoverInactiveItemRenderers(this._defaultItemRendererStorage);
			if(this._itemStorageMap)
			{
				for(var factoryID:String in this._itemStorageMap)
				{
					storage = ItemRendererFactoryStorage(this._itemStorageMap[factoryID]);
					this.recoverInactiveItemRenderers(storage);
				}
			}
			this.renderUnrenderedData();
			this.freeInactiveItemRenderers(this._defaultItemRendererStorage, this._minimumItemCount);
			if(this._itemStorageMap)
			{
				for(factoryID in this._itemStorageMap)
				{
					storage = ItemRendererFactoryStorage(this._itemStorageMap[factoryID]);
					this.freeInactiveItemRenderers(storage, 1);
				}
			}
			this._updateForDataReset = false;
		}

		private function findTotalLayoutCount(location:Vector.<int>):int
		{
			var itemCount:int = 0;
			if(this._dataProvider !== null)
			{
				itemCount = this._dataProvider.getLengthAtLocation(location);
			}
			var result:int = itemCount;
			for(var i:int = 0; i < itemCount; i++)
			{
				location[location.length] = i;
				var item:Object = this._dataProvider.getItemAtLocation(location);
				if(this._dataProvider.isBranch(item) &&
					this._openBranches.contains(item))
				{
					result += this.findTotalLayoutCount(location);
				}
				location.length--;
			}
			return result;
		}

		private function findUnrenderedDataForLocation(location:Vector.<int>, currentIndex:int):int
		{
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			var useVirtualLayout:Boolean = virtualLayout !== null && virtualLayout.useVirtualLayout;
			var itemCount:int = 0;
			if(this._dataProvider !== null)
			{
				itemCount = this._dataProvider.getLengthAtLocation(location);
			}
			for(var i:int = 0; i < itemCount; i++)
			{
				location[location.length] = i;
				var item:Object = this._dataProvider.getItemAtLocation(location);

				if(useVirtualLayout && HELPER_VECTOR.indexOf(currentIndex) == -1)
				{
					if(this._typicalItemRenderer !== null &&
						this._typicalItemIsInDataProvider &&
						this._typicalItemRenderer.data === item)
					{
						//the index may have changed if items were added, removed,
						//or reordered in the data provider
						this._typicalItemRenderer.layoutIndex = currentIndex;
					}
					this._layoutItems[currentIndex] = null;
				}
				else
				{
					this.findRendererForItem(item, location.slice(), currentIndex);
				}
				currentIndex++;

				if(this._dataProvider.isBranch(item) &&
					this._openBranches.contains(item))
				{
					currentIndex = this.findUnrenderedDataForLocation(location, currentIndex);
				}
				location.length--;
			}
			return currentIndex;
		}

		private function findUnrenderedData():void
		{
			LOCATION_HELPER_VECTOR.length = 0;
			var totalLayoutCount:int = this.findTotalLayoutCount(LOCATION_HELPER_VECTOR);
			LOCATION_HELPER_VECTOR.length = 0;
			this._layoutItems.length = totalLayoutCount;
			var virtualLayout:IVirtualLayout = this._layout as IVirtualLayout;
			var useVirtualLayout:Boolean = virtualLayout !== null && virtualLayout.useVirtualLayout;
			if(useVirtualLayout)
			{
				var point:Point = Pool.getPoint();
				virtualLayout.measureViewPort(totalLayoutCount, this._viewPortBounds, point);
				var viewPortWidth:Number = point.x;
				var viewPortHeight:Number = point.y;
				Pool.putPoint(point);
				virtualLayout.getVisibleIndicesAtScrollPosition(this._horizontalScrollPosition, this._verticalScrollPosition, viewPortWidth, viewPortHeight, totalLayoutCount, HELPER_VECTOR);

				if(this._typicalItemRenderer !== null)
				{
					var minimumTypicalItemEdge:Number = this._typicalItemRenderer.height;
					if(this._typicalItemRenderer.width < minimumTypicalItemEdge)
					{
						minimumTypicalItemEdge = this._typicalItemRenderer.width;
					}

					var maximumViewPortEdge:Number = viewPortWidth;
					if(viewPortHeight > viewPortWidth)
					{
						maximumViewPortEdge = viewPortHeight;
					}

					this._minimumItemCount = Math.ceil(maximumViewPortEdge / minimumTypicalItemEdge) + 1;
				}
				else
				{
					this._minimumItemCount = 1;
				}
			}
			LOCATION_HELPER_VECTOR.length = 0;
			this.findUnrenderedDataForLocation(LOCATION_HELPER_VECTOR, 0);
			LOCATION_HELPER_VECTOR.length = 0;
			//update the typical item renderer's visibility
			if(this._typicalItemRenderer !== null)
			{
				if(useVirtualLayout && this._typicalItemIsInDataProvider)
				{
					var index:int = HELPER_VECTOR.indexOf(this._typicalItemRenderer.layoutIndex);
					if(index >= 0)
					{
						this._typicalItemRenderer.visible = true;
					}
					else
					{
						this._typicalItemRenderer.visible = false;

						//uncomment these lines to see a hidden typical item for
						//debugging purposes...
						/*this._typicalItemRenderer.visible = true;
						this._typicalItemRenderer.x = this._horizontalScrollPosition;
						this._typicalItemRenderer.y = this._verticalScrollPosition;*/
					}
				}
				else
				{
					this._typicalItemRenderer.visible = this._typicalItemIsInDataProvider;
				}
			}
			HELPER_VECTOR.length = 0;
		}

		private function findRendererForItem(item:Object, location:Vector.<int>, layoutIndex:int):void
		{
			var itemRenderer:ITreeItemRenderer = this.itemToItemRenderer(item);
			if(this._factoryIDFunction !== null && itemRenderer !== null)
			{
				var newFactoryID:String = this.getFactoryID(itemRenderer.data, location);
				if(newFactoryID !== itemRenderer.factoryID)
				{
					itemRenderer = null;
					if(item is XML || item is XMLList)
					{
						delete this._itemRendererMap[item.toXMLString()];
					}
					else
					{
						delete this._itemRendererMap[item];
					}
				}
			}
			if(itemRenderer !== null)
			{
				//the indices may have changed if items were added, removed,
				//or reordered in the data provider
				itemRenderer.location = location;
				itemRenderer.layoutIndex = layoutIndex;
				itemRenderer.isOpen = this._dataProvider.isBranch(item) && this._openBranches.contains(item);
				if(this._updateForDataReset)
				{
					//similar to calling updateItemAt(), replacing the data
					//provider or resetting its source means that we should
					//trick the item renderer into thinking it has new data.
					//many developers seem to expect this behavior, so while
					//it's not the most optimal for performance, it saves on
					//support time in the forums. thankfully, it's still
					//somewhat optimized since the same item renderer will
					//receive the same data, and the children generally
					//won't have changed much, if at all.
					itemRenderer.data = null;
					itemRenderer.data = item;
				}

				//the typical item renderer is a special case, and we will
				//have already put it into the active renderers, so we don't
				//want to do it again!
				if(this._typicalItemRenderer !== itemRenderer)
				{
					var storage:ItemRendererFactoryStorage = this.factoryIDToStorage(itemRenderer.factoryID);
					var activeItemRenderers:Vector.<ITreeItemRenderer> = storage.activeItemRenderers;
					var inactiveItemRenderers:Vector.<ITreeItemRenderer> = storage.inactiveItemRenderers;
					activeItemRenderers[activeItemRenderers.length] = itemRenderer;
					var inactiveIndex:int = inactiveItemRenderers.indexOf(itemRenderer);
					if(inactiveIndex >= 0)
					{
						inactiveItemRenderers.removeAt(inactiveIndex);
					}
					else
					{
						throw new IllegalOperationError("TreeDataViewPort: item renderer map contains bad data. This may be caused by duplicate items in the data provider, which is not allowed.");
					}
				}
				itemRenderer.visible = true;
				this._layoutItems[layoutIndex] = DisplayObject(itemRenderer);
			}
			else
			{
				var pushIndex:int = this._unrenderedItems.length;
				this._unrenderedItems[pushIndex] = location;
				pushIndex++;
				this._unrenderedItems[pushIndex] = layoutIndex;
			}
		}

		private function renderUnrenderedData():void
		{
			LOCATION_HELPER_VECTOR.length = 2;
			var rendererCount:int = this._unrenderedItems.length;
			for(var i:int = 0; i < rendererCount; i += 2)
			{
				var location:Vector.<int> = this._unrenderedItems.shift();
				var layoutIndex:int = this._unrenderedItems.shift();
				var item:Object = this._dataProvider.getItemAtLocation(location);
				var itemRenderer:ITreeItemRenderer = this.createItemRenderer(
					item, location, layoutIndex, true, false);
				itemRenderer.visible = true;
				this._layoutItems[layoutIndex] = DisplayObject(itemRenderer);
			}
			LOCATION_HELPER_VECTOR.length = 0;
		}

		private function refreshInactiveItemRenderers(factoryID:String, itemRendererTypeIsInvalid:Boolean):void
		{
			if(factoryID !== null)
			{
				var storage:ItemRendererFactoryStorage = ItemRendererFactoryStorage(this._itemStorageMap[factoryID]);
			}
			else
			{
				storage = this._defaultItemRendererStorage;
			}
			var temp:Vector.<ITreeItemRenderer> = storage.inactiveItemRenderers;
			storage.inactiveItemRenderers = storage.activeItemRenderers;
			storage.activeItemRenderers = temp;
			if(storage.activeItemRenderers.length > 0)
			{
				throw new IllegalOperationError("TreeDataViewPort: active renderers should be empty.");
			}
			if(itemRendererTypeIsInvalid)
			{
				this.recoverInactiveItemRenderers(storage);
				this.freeInactiveItemRenderers(storage, 0);
				if(this._typicalItemRenderer && this._typicalItemRenderer.factoryID === factoryID)
				{
					if(this._typicalItemIsInDataProvider)
					{
						var item:Object = this._typicalItemRenderer.data;
						if(item is XML || item is XMLList)
						{
							delete this._itemRendererMap[item.toXMLString()];
						}
						else
						{
							delete this._itemRendererMap[item];
						}
					}
					this.destroyItemRenderer(this._typicalItemRenderer);
					this._typicalItemRenderer = null;
					this._typicalItemIsInDataProvider = false;
				}
			}

			this._layoutItems.length = 0;
		}

		private function recoverInactiveItemRenderers(storage:ItemRendererFactoryStorage):void
		{
			var inactiveItemRenderers:Vector.<ITreeItemRenderer> = storage.inactiveItemRenderers;

			var itemCount:int = inactiveItemRenderers.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var itemRenderer:ITreeItemRenderer = inactiveItemRenderers[i];
				if(itemRenderer === null || itemRenderer.data === null)
				{
					continue;
				}
				this._owner.dispatchEventWith(FeathersEventType.RENDERER_REMOVE, false, itemRenderer);
				var item:Object = itemRenderer.data;
				if(item is XML || item is XMLList)
				{
					delete this._itemRendererMap[item.toXMLString()];
				}
				else
				{
					delete this._itemRendererMap[item];
				}
			}
		}

		private function freeInactiveItemRenderers(storage:ItemRendererFactoryStorage, minimumItemCount:int):void
		{
			var inactiveItemRenderers:Vector.<ITreeItemRenderer> = storage.inactiveItemRenderers;
			var activeItemRenderers:Vector.<ITreeItemRenderer> = storage.activeItemRenderers;
			var activeItemRenderersCount:int = activeItemRenderers.length;

			//we may keep around some extra renderers to avoid too much
			//allocation and garbage collection. they'll be hidden.
			var itemCount:int = inactiveItemRenderers.length;
			var keepCount:int = minimumItemCount - activeItemRenderersCount;
			if(keepCount > itemCount)
			{
				keepCount = itemCount;
			}
			for(var i:int = 0; i < keepCount; i++)
			{
				var itemRenderer:ITreeItemRenderer = inactiveItemRenderers.shift();
				if(!itemRenderer)
				{
					keepCount++;
					if(itemCount < keepCount)
					{
						keepCount = itemCount;
					}
					continue;
				}
				itemRenderer.data = null;
				itemRenderer.location = null;
				itemRenderer.visible = false;
				activeItemRenderers[activeItemRenderersCount] = itemRenderer;
				activeItemRenderersCount++;
			}
			itemCount -= keepCount;
			for(i = 0; i < itemCount; i++)
			{
				itemRenderer = inactiveItemRenderers.shift();
				if(!itemRenderer)
				{
					continue;
				}
				this.destroyItemRenderer(itemRenderer);
			}
		}

		private function createItemRenderer(item:Object, location:Vector.<int>, layoutIndex:int, useCache:Boolean, isTemporary:Boolean):ITreeItemRenderer
		{
			var factoryID:String = null;
			if(this._factoryIDFunction !== null)
			{
				factoryID = this.getFactoryID(item, location);
			}
			var itemRendererFactory:Function = this.factoryIDToFactory(factoryID);
			var storage:ItemRendererFactoryStorage = this.factoryIDToStorage(factoryID);
			var inactiveItemRenderers:Vector.<ITreeItemRenderer> = storage.inactiveItemRenderers;
			var activeItemRenderers:Vector.<ITreeItemRenderer> = storage.activeItemRenderers;
			var itemRenderer:ITreeItemRenderer;
			do
			{
				if(!useCache || isTemporary || inactiveItemRenderers.length == 0)
				{
					if(itemRendererFactory !== null)
					{
						itemRenderer = ITreeItemRenderer(itemRendererFactory());
					}
					else
					{
						itemRenderer = ITreeItemRenderer(new this._itemRendererType());
					}
					if(this._customItemRendererStyleName && this._customItemRendererStyleName.length > 0)
					{
						itemRenderer.styleNameList.add(this._customItemRendererStyleName);
					}
					this.addChild(DisplayObject(itemRenderer));
				}
				else
				{
					itemRenderer = inactiveItemRenderers.shift();
				}
				//wondering why this all is in a loop?
				//_inactiveRenderers.shift() may return null because we're
				//storing null values instead of calling splice() to improve
				//performance.
			}
			while(!itemRenderer);
			itemRenderer.data = item;
			itemRenderer.owner = this._owner;
			itemRenderer.factoryID = factoryID;
			itemRenderer.location = location;
			itemRenderer.layoutIndex = layoutIndex;
			var isBranch:Boolean = this._dataProvider !== null && this._dataProvider.isBranch(item);
			itemRenderer.isBranch = isBranch;
			itemRenderer.isOpen = isBranch && this._openBranches.contains(item);

			if(!isTemporary)
			{
				if(item is XML || item is XMLList)
				{
					this._itemRendererMap[item.toXMLString()] = itemRenderer;
				}
				else
				{
					this._itemRendererMap[item] = itemRenderer;
				}
				activeItemRenderers[activeItemRenderers.length] = itemRenderer;
				itemRenderer.addEventListener(Event.TRIGGERED, itemRenderer_triggeredHandler);
				itemRenderer.addEventListener(Event.CHANGE, itemRenderer_changeHandler);
				itemRenderer.addEventListener(FeathersEventType.RESIZE, itemRenderer_resizeHandler);
				this._owner.dispatchEventWith(FeathersEventType.RENDERER_ADD, false, itemRenderer);
			}

			return itemRenderer;
		}

		private function destroyItemRenderer(itemRenderer:ITreeItemRenderer):void
		{
			itemRenderer.removeEventListener(Event.TRIGGERED, itemRenderer_triggeredHandler);
			itemRenderer.removeEventListener(Event.CHANGE, itemRenderer_changeHandler);
			itemRenderer.removeEventListener(FeathersEventType.RESIZE, itemRenderer_resizeHandler);
			itemRenderer.owner = null;
			itemRenderer.data = null;
			itemRenderer.location = null;
			itemRenderer.layoutIndex = -1;
			itemRenderer.factoryID = null;
			this.removeChild(DisplayObject(itemRenderer), true);
		}

		private function getFactoryID(item:Object, location:Vector.<int>):String
		{
			if(this._factoryIDFunction === null)
			{
				return null;
			}
			if(this._factoryIDFunction.length == 2)
			{
				return this._factoryIDFunction(item, location);
			}
			return this._factoryIDFunction(item);
		}

		private function factoryIDToFactory(id:String):Function
		{
			if(id !== null)
			{
				if(id in this._itemRendererFactories)
				{
					return this._itemRendererFactories[id] as Function;
				}
				else
				{
					throw new ReferenceError("Cannot find item renderer factory for ID \"" + id + "\".");
				}
			}
			return this._itemRendererFactory;
		}

		private function factoryIDToStorage(id:String):ItemRendererFactoryStorage
		{
			if(id !== null)
			{
				if(id in this._itemStorageMap)
				{
					return ItemRendererFactoryStorage(this._itemStorageMap[id]);
				}
				var storage:ItemRendererFactoryStorage = new ItemRendererFactoryStorage();
				this._itemStorageMap[id] = storage;
				return storage;
			}
			return this._defaultItemRendererStorage;
		}

		private function invalidateParent(flag:String = INVALIDATION_FLAG_ALL):void
		{
			Scroller(this.parent).invalidate(flag);
		}

		private function refreshSelection():void
		{
			for each(var item:DisplayObject in this._layoutItems)
			{
				var itemRenderer:ITreeItemRenderer = item as ITreeItemRenderer;
				if(itemRenderer !== null)
				{
					itemRenderer.isSelected = itemRenderer.data === this._selectedItem;
				}
			}
		}

		private function refreshEnabled():void
		{
			for each(var item:DisplayObject in this._layoutItems)
			{
				var control:IFeathersControl = item as IFeathersControl;
				if(control !== null)
				{
					control.isEnabled = this._isEnabled;
				}
			}
		}

		private function validateRenderers():void
		{
			var itemCount:int = this._layoutItems.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:IValidating = this._layoutItems[i] as IValidating;
				if(item !== null)
				{
					item.validate();
				}
			}
		}

		private function layout_changeHandler(event:Event):void
		{
			if(this._ignoreLayoutChanges)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
			this.invalidateParent(INVALIDATION_FLAG_LAYOUT);
		}

		private function dataProvider_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		private function itemRenderer_triggeredHandler(event:Event):void
		{
			var itemRenderer:ITreeItemRenderer = ITreeItemRenderer(event.currentTarget);
			this.parent.dispatchEventWith(Event.TRIGGERED, false, itemRenderer.data);
		}

		private function itemRenderer_changeHandler(event:Event):void
		{
			if(this._ignoreSelectionChanges)
			{
				return;
			}
			var itemRenderer:ITreeItemRenderer = ITreeItemRenderer(event.currentTarget);
			if(!this._isSelectable || this._owner.isScrolling)
			{
				itemRenderer.isSelected = false;
				return;
			}
			var isSelected:Boolean = itemRenderer.isSelected;
			if(isSelected)
			{
				this.selectedItem = itemRenderer.data;
			}
			else
			{
				this.selectedItem = null;
			}
		}

		private function itemRenderer_resizeHandler(event:Event):void
		{
			if(this._ignoreRendererResizing)
			{
				return;
			}
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
			this.invalidateParent(INVALIDATION_FLAG_LAYOUT);
			if(event.currentTarget === this._typicalItemRenderer && !this._typicalItemIsInDataProvider)
			{
				return;
			}
			var layout:IVariableVirtualLayout = this._layout as IVariableVirtualLayout;
			if(!layout || !layout.hasVariableItemDimensions)
			{
				return;
			}
			var itemRenderer:ITreeItemRenderer = ITreeItemRenderer(event.currentTarget);
			layout.resetVariableVirtualCacheAtIndex(itemRenderer.layoutIndex, DisplayObject(itemRenderer));
		}

		private function openBranches_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}
	}
}

import feathers.controls.renderers.ITreeItemRenderer;

class ItemRendererFactoryStorage
{
	public function ItemRendererFactoryStorage()
	{

	}

	public var activeItemRenderers:Vector.<ITreeItemRenderer> = new <ITreeItemRenderer>[];
	public var inactiveItemRenderers:Vector.<ITreeItemRenderer> = new <ITreeItemRenderer>[];
}

================================================
FILE: source/feathers/controls/text/BaseTextRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.text
{
	import feathers.core.FeathersControl;
	import feathers.core.IStateContext;
	import feathers.core.IStateObserver;
	import feathers.events.FeathersEventType;
	import feathers.text.FontStylesSet;

	import starling.events.Event;

	/**
	 * A base class for text renderers that implements some common properties.
	 *
	 * @productversion Feathers 3.1.0
	 */
	public class BaseTextRenderer extends FeathersControl implements IStateObserver
	{
		/**
		 * Constructor.
		 */
		public function BaseTextRenderer()
		{
			super();
		}

		/**
		 * @private
		 */
		protected var _text:String = null;

		/**
		 * @copy feathers.core.ITextRenderer#text
		 */
		public function get text():String
		{
			return this._text;
		}

		/**
		 * @private
		 */
		public function set text(value:String):void
		{
			if(this._text == value)
			{
				return;
			}
			this._text = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _stateContext:IStateContext;

		/**
		 * When the text renderer observes a state context, the text renderer
		 * may change its font styles based on the current state of that
		 * context. Typically, a relevant component will automatically assign
		 * itself as the state context of a text renderer, so this property is
		 * typically meant for internal use only.
		 *
		 * @default null
		 *
		 * @see #setFontStylesForState()
		 */
		public function get stateContext():IStateContext
		{
			return this._stateContext;
		}

		/**
		 * @private
		 */
		public function set stateContext(value:IStateContext):void
		{
			if(this._stateContext === value)
			{
				return;
			}
			if(this._stateContext)
			{
				this._stateContext.removeEventListener(FeathersEventType.STATE_CHANGE, stateContext_stateChangeHandler);
			}
			this._stateContext = value;
			if(this._stateContext)
			{
				this._stateContext.addEventListener(FeathersEventType.STATE_CHANGE, stateContext_stateChangeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_STATE);
		}

		/**
		 * @private
		 */
		protected var _wordWrap:Boolean = false;

		/**
		 * @copy feathers.core.ITextRenderer#wordWrap
		 */
		public function get wordWrap():Boolean
		{
			return this._wordWrap;
		}

		/**
		 * @private
		 */
		public function set wordWrap(value:Boolean):void
		{
			if(this._wordWrap == value)
			{
				return;
			}
			this._wordWrap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _fontStyles:FontStylesSet;

		/**
		 * @copy feathers.core.ITextRenderer#fontStyles
		 */
		public function get fontStyles():FontStylesSet
		{
			return this._fontStyles;
		}

		/**
		 * @private
		 */
		public function set fontStyles(value:FontStylesSet):void
		{
			if(this._fontStyles === value)
			{
				return;
			}
			if(this._fontStyles !== null)
			{
				this._fontStyles.removeEventListener(Event.CHANGE, fontStylesSet_changeHandler);
			}
			this._fontStyles = value;
			if(this._fontStyles !== null)
			{
				this._fontStyles.addEventListener(Event.CHANGE, fontStylesSet_changeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.stateContext = null;
			this.fontStyles = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		protected function stateContext_stateChangeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STATE);
		}

		/**
		 * @private
		 */
		protected function fontStylesSet_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}
	}
}


================================================
FILE: source/feathers/controls/text/BitmapFontTextEditor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.text
{
	import feathers.core.FocusManager;
	import feathers.core.INativeFocusOwner;
	import feathers.core.ITextEditor;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;
	import feathers.utils.text.TextInputNavigation;
	import feathers.utils.text.TextInputRestrict;

	import flash.desktop.Clipboard;
	import flash.desktop.ClipboardFormats;
	import flash.display.Sprite;
	import flash.display.Stage;
	import flash.events.Event;
	import flash.events.TextEvent;
	import flash.geom.Point;
	import flash.text.TextFormatAlign;
	import flash.ui.Keyboard;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.KeyboardEvent;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.rendering.Painter;
	import starling.text.BitmapChar;
	import starling.text.BitmapFont;
	import starling.utils.Pool;

	/**
	 * Dispatched when the text property changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #text
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the user presses the Enter key while the editor has
	 * focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.ENTER
	 */
	[Event(name="enter",type="starling.events.Event")]

	/**
	 * Dispatched when the text editor receives focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_IN
	 */
	[Event(name="focusIn",type="starling.events.Event")]

	/**
	 * Dispatched when the text editor loses focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_OUT
	 */
	[Event(name="focusOut",type="starling.events.Event")]

	/**
	 * Text that may be edited at runtime by the user with the
	 * <code>TextInput</code> component, rendered with
	 * <a href="http://wiki.starling-framework.org/manual/displaying_text#bitmap_fonts" target="_top">bitmap fonts</a>.
	 *
	 * <p>The following example shows how to use
	 * <code>BitmapFontTextEditor</code> with a <code>TextInput</code>:</p>
	 *
	 * <listing version="3.0">
	 * var input:TextInput = new TextInput();
	 * input.textEditorFactory = function():ITextEditor
	 * {
	 *     return new BitmapFontTextEditor();
	 * };
	 * this.addChild( input );</listing>
	 *
	 * <p><strong>Warning:</strong> This text editor is intended for use in
	 * desktop applications only, and it does not provide support for software
	 * keyboards on mobile devices.</p>
	 *
	 * @see feathers.controls.TextInput
	 * @see ../../../../help/text-editors.html Introduction to Feathers text editors
	 * @see http://wiki.starling-framework.org/manual/displaying_text#bitmap_fonts Starling Wiki: Displaying Text with Bitmap Fonts
	 *
	 * @productversion Feathers 2.0.0
	 */
	public class BitmapFontTextEditor extends BitmapFontTextRenderer implements ITextEditor, INativeFocusOwner
	{
		/**
		 * @private
		 */
		protected static const LINE_FEED:String = "\n";

		/**
		 * @private
		 */
		protected static const CARRIAGE_RETURN:String = "\r";

		/**
		 * The default <code>IStyleProvider</code> for all <code>BitmapFontTextEditor</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function BitmapFontTextEditor()
		{
			super();
			this._text = "";
			this.isQuickHitAreaEnabled = true;
			this.truncateToFit = false;
			this.addEventListener(TouchEvent.TOUCH, textEditor_touchHandler);
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _selectionSkin:DisplayObject;

		/**
		 * The skin that indicates the currently selected range of text.
		 */
		public function get selectionSkin():DisplayObject
		{
			return this._selectionSkin;
		}

		/**
		 * @private
		 */
		public function set selectionSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._selectionSkin == value)
			{
				return;
			}
			if(this._selectionSkin && this._selectionSkin.parent == this)
			{
				this._selectionSkin.removeFromParent();
			}
			this._selectionSkin = value;
			if(this._selectionSkin)
			{
				this._selectionSkin.visible = false;
				this.addChildAt(this._selectionSkin, 0);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _cursorDelay:Number = 0.53;

		/**
		 * @private
		 */
		protected var _cursorDelayID:uint = uint.MAX_VALUE;

		/**
		 * @private
		 */
		protected var _cursorSkin:DisplayObject;

		/**
		 * The skin that indicates the current position where text may be
		 * entered.
		 */
		public function get cursorSkin():DisplayObject
		{
			return this._cursorSkin;
		}

		/**
		 * @private
		 */
		public function set cursorSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._cursorSkin === value)
			{
				return;
			}
			if(this._cursorSkin !== null && this._cursorSkin.parent === this)
			{
				this._cursorSkin.removeFromParent();
			}
			this._cursorSkin = value;
			if(this._cursorSkin !== null)
			{
				this._cursorSkin.visible = false;
				this.addChild(this._cursorSkin);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _unmaskedText:String;

		/**
		 * @private
		 */
		protected var _displayAsPassword:Boolean = false;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#displayAsPassword
		 *
		 * @see feathers.controls.TextInput#displayAsPassword
		 * @see #passwordCharCode
		 */
		public function get displayAsPassword():Boolean
		{
			return this._displayAsPassword;
		}

		/**
		 * @private
		 */
		public function set displayAsPassword(value:Boolean):void
		{
			if(this._displayAsPassword == value)
			{
				return;
			}
			this._displayAsPassword = value;
			if(this._displayAsPassword)
			{
				this._unmaskedText = this._text;
				this.refreshMaskedText();
			}
			else
			{
				this._text = this._unmaskedText;
				this._unmaskedText = null;
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _passwordCharCode:int = 42; //asterisk

		/**
		 * The character code of the character used to display a password.
		 *
		 * <p>In the following example, the substitute character for passwords
		 * is set to a bullet:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.displayAsPassword = true;
		 * textEditor.passwordCharCode = "•".charCodeAt(0);</listing>
		 *
		 * @default 42 (asterisk)
		 *
		 * @see #displayAsPassword
		 */
		public function get passwordCharCode():int
		{
			return this._passwordCharCode;
		}

		/**
		 * @private
		 */
		public function set passwordCharCode(value:int):void
		{
			if(this._passwordCharCode == value)
			{
				return;
			}
			this._passwordCharCode = value;
			if(this._displayAsPassword)
			{
				this.refreshMaskedText();
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isEditable:Boolean = true;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#isEditable
		 *
		 * @see feathers.controls.TextInput#isEditable
		 */
		public function get isEditable():Boolean
		{
			return this._isEditable;
		}

		/**
		 * @private
		 */
		public function set isEditable(value:Boolean):void
		{
			if(this._isEditable == value)
			{
				return;
			}
			this._isEditable = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isSelectable:Boolean = true;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#isSelectable
		 *
		 * @see feathers.controls.TextInput#isSelectable
		 */
		public function get isSelectable():Boolean
		{
			return this._isSelectable;
		}

		/**
		 * @private
		 */
		public function set isSelectable(value:Boolean):void
		{
			if(this._isSelectable == value)
			{
				return;
			}
			this._isSelectable = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @inheritDoc
		 *
		 * @default false
		 */
		public function get setTouchFocusOnEndedPhase():Boolean
		{
			return false;
		}

		/**
		 * @private
		 */
		override public function get text():String
		{
			if(this._displayAsPassword)
			{
				return this._unmaskedText;
			}
			return this._text;
		}

		/**
		 * @private
		 */
		override public function set text(value:String):void
		{
			if(value === null)
			{
				//don't allow null or undefined
				value = "";
			}
			var currentValue:String = this._text;
			if(this._displayAsPassword)
			{
				currentValue = this._unmaskedText;
			}
			if(currentValue == value)
			{
				return;
			}
			if(this._displayAsPassword)
			{
				this._unmaskedText = value;
				this.refreshMaskedText();
			}
			else
			{
				this._text = value;
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
			var textLength:int = this._text.length;
			//we need to account for the possibility that the text is in the
			//middle of being selected when it changes
			if(this._selectionAnchorIndex > textLength)
			{
				this._selectionAnchorIndex = textLength;
			}
			//then, we need to make sure the selected range is still valid
			if(this._selectionBeginIndex > textLength)
			{
				this.selectRange(textLength, textLength);
			}
			else if(this._selectionEndIndex > textLength)
			{
				this.selectRange(this._selectionBeginIndex, textLength);
			}
			this.dispatchEventWith(starling.events.Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _maxChars:int = 0;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#maxChars
		 *
		 * @see feathers.controls.TextInput#maxChars
		 */
		public function get maxChars():int
		{
			return this._maxChars;
		}

		/**
		 * @private
		 */
		public function set maxChars(value:int):void
		{
			if(this._maxChars == value)
			{
				return;
			}
			this._maxChars = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _restrict:TextInputRestrict;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#restrict
		 *
		 * @see feathers.controls.TextInput#restrict
		 */
		public function get restrict():String
		{
			if(!this._restrict)
			{
				return null;
			}
			return this._restrict.restrict;
		}

		/**
		 * @private
		 */
		public function set restrict(value:String):void
		{
			if(this._restrict && this._restrict.restrict === value)
			{
				return;
			}
			if(!this._restrict && value === null)
			{
				return;
			}
			if(value === null)
			{
				this._restrict = null;
			}
			else
			{
				if(this._restrict)
				{
					this._restrict.restrict = value;
				}
				else
				{

					this._restrict = new TextInputRestrict(value);
				}
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _selectionBeginIndex:int = 0;

		/**
		 * @inheritDoc
		 *
		 * @see #selectionEndIndex
		 */
		public function get selectionBeginIndex():int
		{
			return this._selectionBeginIndex;
		}

		/**
		 * @private
		 */
		protected var _selectionEndIndex:int = 0;

		/**
		 * @inheritDoc
		 *
		 * @see #selectionBeginIndex
		 */
		public function get selectionEndIndex():int
		{
			return this._selectionEndIndex;
		}

		/**
		 * @private
		 */
		protected var _selectionAnchorIndex:int = 0;

		/**
		 * @private
		 */
		protected var _scrollX:Number = 0;

		/**
		 * @private
		 */
		protected var touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _nativeFocus:Sprite;

		/**
		 * @copy feathers.core.INativeFocusOwner#nativeFocus
		 */
		public function get nativeFocus():Object
		{
			return this._nativeFocus;
		}

		/**
		 * @private
		 */
		protected var _isWaitingToSetFocus:Boolean = false;

		/**
		 * @inheritDoc
		 */
		public function setFocus(position:Point = null):void
		{
			if(this._hasFocus && !position)
			{
				//we already have focus, and there isn't a touch position, we
				//can ignore this because nothing would change
				return;
			}
			if(this._nativeFocus !== null)
			{
				if(this._nativeFocus.parent === null)
				{
					var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
					starling.nativeStage.addChild(this._nativeFocus);
				}
				var newIndex:int = -1;
				if(position !== null)
				{
					newIndex = this.getSelectionIndexAtPoint(position.x, position.y);
				}
				if(newIndex >= 0)
				{
					this.selectRange(newIndex, newIndex);
				}
				this.focusIn();
			}
			else
			{
				this._isWaitingToSetFocus = true;
			}
		}

		/**
		 * @inheritDoc
		 */
		public function clearFocus():void
		{
			if(!this._hasFocus)
			{
				return;
			}
			this._hasFocus = false;
			this._cursorSkin.visible = false;
			this._selectionSkin.visible = false;
			this.refreshCursorBlink();
			this.stage.removeEventListener(TouchEvent.TOUCH, stage_touchHandler);
			this.stage.removeEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
			this.removeEventListener(starling.events.Event.ENTER_FRAME, hasFocus_enterFrameHandler);
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var nativeStage:Stage = starling.nativeStage;
			if(nativeStage.focus === this._nativeFocus)
			{
				//only clear the native focus when our native target has focus
				//because otherwise another component may lose focus.

				//for consistency with StageTextTextEditor and
				//TextFieldTextEditor, we set the native stage's focus to null
				//here instead of setting it to the native stage due to issues
				//with those text editors on Android.
				nativeStage.focus = null;
			}
			this.dispatchEventWith(FeathersEventType.FOCUS_OUT);
		}

		/**
		 * @inheritDoc
		 */
		public function selectRange(beginIndex:int, endIndex:int):void
		{
			if(!this._isEditable && !this._isSelectable)
			{
				return;
			}
			if(endIndex < beginIndex)
			{
				var temp:int = endIndex;
				endIndex = beginIndex;
				beginIndex = temp;
			}
			this._selectionBeginIndex = beginIndex;
			this._selectionEndIndex = endIndex;
			if(beginIndex == endIndex)
			{
				this._selectionAnchorIndex = beginIndex;
				if(beginIndex < 0)
				{
					this._cursorSkin.visible = false;
				}
				else
				{
					//cursor skin is not shown if isSelectable === true and
					//isEditable is false
					this._cursorSkin.visible = this._hasFocus && this._isEditable;
				}
				this._selectionSkin.visible = false;
			}
			else
			{
				this._cursorSkin.visible = false;
				this._selectionSkin.visible = true;
			}
			this.refreshCursorBlink();
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this._nativeFocus && this._nativeFocus.parent)
			{
				this._nativeFocus.parent.removeChild(this._nativeFocus);
			}
			this._nativeFocus = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override public function render(painter:Painter):void
		{
			var oldBatchX:Number = this._batchX;
			var oldCursorX:Number = this._cursorSkin.x;
			this._batchX -= this._scrollX;
			this._cursorSkin.x -= this._scrollX;
			super.render(painter);
			this._batchX = oldBatchX;
			this._cursorSkin.x = oldCursorX;
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(!this._nativeFocus)
			{
				this._nativeFocus = new Sprite();
				//let's ensure that this can only get focus through code
				this._nativeFocus.tabEnabled = false;
				this._nativeFocus.tabChildren = false;
				this._nativeFocus.mouseEnabled = false;
				this._nativeFocus.mouseChildren = false;
				//adds support for mobile
				this._nativeFocus.needsSoftKeyboard = true;
			}
			this._nativeFocus.addEventListener(flash.events.Event.CUT, nativeFocus_cutHandler, false, 0, true);
			this._nativeFocus.addEventListener(flash.events.Event.COPY, nativeFocus_copyHandler, false, 0, true);
			this._nativeFocus.addEventListener(flash.events.Event.PASTE, nativeFocus_pasteHandler, false, 0, true);
			this._nativeFocus.addEventListener(flash.events.Event.SELECT_ALL, nativeFocus_selectAllHandler, false, 0, true);
			this._nativeFocus.addEventListener(TextEvent.TEXT_INPUT, nativeFocus_textInputHandler, false, 0, true);
			if(!this._cursorSkin)
			{
				this.ignoreNextStyleRestriction();
				this.cursorSkin = new Quad(1, 1, 0x000000);
			}
			if(!this._selectionSkin)
			{
				this.ignoreNextStyleRestriction();
				this.selectionSkin = new Quad(1, 1, 0x000000);
			}
			super.initialize();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var selectionInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SELECTED);

			super.draw();

			if(dataInvalid || selectionInvalid)
			{
				this.positionCursorAtCharIndex(this.getCursorIndexFromSelectionRange());
				this.positionSelectionBackground();
			}

			var mask:Quad = this.mask as Quad;
			if(mask)
			{
				mask.x = 0;
				mask.y = 0;
				mask.width = this.actualWidth;
				mask.height = this.actualHeight;
			}
			else
			{
				mask = new Quad(1, 1, 0xff00ff);
				//the initial dimensions cannot be 0 or there's a runtime error,
				//and these values might be 0
				mask.width = this.actualWidth;
				mask.height = this.actualHeight;
				this.mask = mask;
			}
		}

		/**
		 * @private
		 */
		override protected function layoutCharacters(result:MeasureTextResult = null):MeasureTextResult
		{
			result = super.layoutCharacters(result);
			if(this._explicitWidth === this._explicitWidth && //!isNaN
				result.width > this._explicitWidth)
			{
				this._characterBatch.clear();
				var oldTextAlign:String = this._currentTextFormat.align;
				this._currentTextFormat.align = TextFormatAlign.LEFT;
				result = super.layoutCharacters(result);
				this._currentTextFormat.align = oldTextAlign;
			}
			return result;
		}

		/**
		 * @private
		 */
		override protected function refreshTextFormat():void
		{
			super.refreshTextFormat();
			if(this._cursorSkin)
			{
				var font:BitmapFont = this._currentTextFormat.font;
				var customSize:Number = this._currentTextFormat.size;
				var scale:Number = customSize / font.size;
				if(scale !== scale) //isNaN
				{
					scale = 1;
				}
				this._cursorSkin.height = font.lineHeight * scale;
			}
		}

		/**
		 * @private
		 */
		protected function refreshMaskedText():void
		{
			this._text = "";
			var textLength:int = this._unmaskedText.length;
			var maskChar:String = String.fromCharCode(this._passwordCharCode);
			for(var i:int = 0; i < textLength; i++)
			{
				this._text += maskChar;
			}
		}

		/**
		 * @private
		 */
		protected function focusIn():void
		{
			var showSelection:Boolean = (this._isEditable || this._isSelectable) &&
				this._selectionBeginIndex >= 0 &&
				this._selectionBeginIndex != this._selectionEndIndex;
			var showCursor:Boolean = this._isEditable &&
				this._selectionBeginIndex >= 0 &&
				this._selectionBeginIndex == this._selectionEndIndex;
			this._cursorSkin.visible = showCursor;
			this._selectionSkin.visible = showSelection;
			this.refreshCursorBlink();
			if(!FocusManager.isEnabledForStage(this.stage))
			{
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				//if there isn't a focus manager, we need to set focus manually
				starling.nativeStage.focus = this._nativeFocus;
			}
			if(this._isEditable)
			{
				this._nativeFocus.requestSoftKeyboard();
			}
			if(this._hasFocus)
			{
				return;
			}
			//we're reusing this variable. since this isn't a display object
			//that the focus manager can see, it's not being used anyway.
			this._hasFocus = true;
			this.stage.addEventListener(TouchEvent.TOUCH, stage_touchHandler);
			this.stage.addEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
			this.addEventListener(starling.events.Event.ENTER_FRAME, hasFocus_enterFrameHandler);
			this.dispatchEventWith(FeathersEventType.FOCUS_IN);
		}

		/**
		 * @private
		 */
		protected function refreshCursorBlink():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			if(this._cursorDelayID == uint.MAX_VALUE && this._cursorSkin.visible)
			{
				this._cursorSkin.alpha = 1;
				this._cursorDelayID = starling.juggler.delayCall(toggleCursorSkin, this._cursorDelay);
			}
			else if(this._cursorDelayID != uint.MAX_VALUE && !this._cursorSkin.visible)
			{
				starling.juggler.removeByID(this._cursorDelayID);
				this._cursorDelayID = uint.MAX_VALUE;
			}
		}

		/**
		 * @private
		 */
		protected function toggleCursorSkin():void
		{
			if(this._cursorSkin.alpha > 0)
			{
				this._cursorSkin.alpha = 0;
			}
			else
			{
				this._cursorSkin.alpha = 1;
			}
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			this._cursorDelayID = starling.juggler.delayCall(toggleCursorSkin, this._cursorDelay);
		}

		/**
		 * @private
		 */
		protected function getSelectionIndexAtPoint(pointX:Number, pointY:Number):int
		{
			if(!this._text || pointX <= 0)
			{
				return 0;
			}
			var font:BitmapFont = this._currentTextFormat.font;
			var customSize:Number = this._currentTextFormat.size;
			var customLetterSpacing:Number = this._currentTextFormat.letterSpacing;
			var isKerningEnabled:Boolean = this._currentTextFormat.isKerningEnabled;
			var scale:Number = customSize / font.size;
			if(scale !== scale) //isNaN
			{
				scale = 1;
			}
			var align:String = this._currentTextFormat.align;
			if(align !== TextFormatAlign.LEFT)
			{
				var point:Point = Pool.getPoint();
				this.measureTextInternal(point, false);
				var lineWidth:Number = point.x;
				Pool.putPoint(point);
				var hasExplicitWidth:Boolean = this._explicitWidth === this._explicitWidth; //!isNaN
				var maxLineWidth:Number = hasExplicitWidth ? this._explicitWidth : this._explicitMaxWidth;
				if(maxLineWidth > lineWidth)
				{
					if(align === TextFormatAlign.RIGHT)
					{
						pointX -= maxLineWidth - lineWidth;
					}
					else //center
					{
						pointX -= (maxLineWidth - lineWidth) / 2;
					}
				}
			}
			var currentX:Number = 0;
			var previousCharID:Number = NaN;
			var charCount:int = this._text.length;
			for(var i:int = 0; i < charCount; i++)
			{
				var charID:int = this._text.charCodeAt(i);
				var charData:BitmapChar = font.getChar(charID);
				if(!charData)
				{
					continue;
				}
				var currentKerning:Number = 0;
				if(isKerningEnabled &&
					previousCharID === previousCharID) //!isNaN
				{
					currentKerning = charData.getKerning(previousCharID) * scale;
				}
				var charWidth:Number = customLetterSpacing + currentKerning + charData.xAdvance * scale;
				if(pointX >= currentX && pointX < (currentX + charWidth))
				{
					if(pointX > (currentX + charWidth / 2))
					{
						return i + 1;
					}
					return i;
				}
				currentX += charWidth;
				previousCharID = charID;
			}
			if(pointX >= currentX)
			{
				return this._text.length;
			}
			return 0;
		}

		/**
		 * @private
		 */
		protected function getXPositionOfIndex(index:int):Number
		{
			var font:BitmapFont = this._currentTextFormat.font;
			var customSize:Number = this._currentTextFormat.size;
			var customLetterSpacing:Number = this._currentTextFormat.letterSpacing;
			var isKerningEnabled:Boolean = this._currentTextFormat.isKerningEnabled;
			var scale:Number = customSize / font.size;
			if(scale !== scale) //isNaN
			{
				scale = 1;
			}
			var xPositionOffset:Number = 0;
			var align:String = this._currentTextFormat.align;
			if(align !== TextFormatAlign.LEFT)
			{
				var point:Point = Pool.getPoint();
				this.measureTextInternal(point, false);
				var lineWidth:Number = point.x;
				Pool.putPoint(point);
				var hasExplicitWidth:Boolean = this._explicitWidth === this._explicitWidth; //!isNaN
				var maxLineWidth:Number = hasExplicitWidth ? this._explicitWidth : this._explicitMaxWidth;
				if(maxLineWidth > lineWidth)
				{
					if(align === TextFormatAlign.RIGHT)
					{
						xPositionOffset = maxLineWidth - lineWidth;
					}
					else //center
					{
						xPositionOffset = (maxLineWidth - lineWidth) / 2;
					}
				}
			}
			var currentX:Number = 0;
			var previousCharID:Number = NaN;
			var charCount:int = this._text.length;
			if(index < charCount)
			{
				charCount = index;
			}
			for(var i:int = 0; i < charCount; i++)
			{
				var charID:int = this._text.charCodeAt(i);
				var charData:BitmapChar = font.getChar(charID);
				if(!charData)
				{
					continue;
				}
				var currentKerning:Number = 0;
				if(isKerningEnabled &&
					previousCharID === previousCharID) //!isNaN
				{
					currentKerning = charData.getKerning(previousCharID) * scale;
				}
				currentX += customLetterSpacing + currentKerning + charData.xAdvance * scale;
				previousCharID = charID;
			}
			return currentX + xPositionOffset;
		}

		/**
		 * @private
		 */
		protected function positionCursorAtCharIndex(index:int):void
		{
			if(index < 0)
			{
				index = 0;
			}
			var cursorX:Number = this.getXPositionOfIndex(index);
			cursorX = int(cursorX - (this._cursorSkin.width / 2));
			this._cursorSkin.x = cursorX;
			this._cursorSkin.y = this._verticalAlignOffsetY;

			//then we update the scroll to always show the cursor
			var minScrollX:Number = cursorX + this._cursorSkin.width - this.actualWidth;
			var maxScrollX:Number = this.getXPositionOfIndex(this._text.length) - this.actualWidth;
			if(maxScrollX < 0)
			{
				maxScrollX = 0;
			}
			if(this._scrollX < minScrollX)
			{
				this._scrollX = minScrollX;
			}
			else if(this._scrollX > cursorX)
			{
				this._scrollX = cursorX;
			}
			if(this._scrollX > maxScrollX)
			{
				this._scrollX = maxScrollX;
			}
		}

		/**
		 * @private
		 */
		protected function getCursorIndexFromSelectionRange():int
		{
			var cursorIndex:int = this._selectionEndIndex;
			if(this.touchPointID >= 0 && this._selectionAnchorIndex >= 0 && this._selectionAnchorIndex == this._selectionEndIndex)
			{
				cursorIndex = this._selectionBeginIndex;
			}
			return cursorIndex;
		}

		/**
		 * @private
		 */
		protected function positionSelectionBackground():void
		{
			var font:BitmapFont = this._currentTextFormat.font;
			var customSize:Number = this._currentTextFormat.size;
			var scale:Number = customSize / font.size;
			if(scale !== scale) //isNaN
			{
				scale = 1;
			}

			var startX:Number = this.getXPositionOfIndex(this._selectionBeginIndex) - this._scrollX;
			if(startX < 0)
			{
				startX = 0;
			}
			var endX:Number = this.getXPositionOfIndex(this._selectionEndIndex) - this._scrollX;
			if(endX < 0)
			{
				endX = 0;
			}
			this._selectionSkin.x = startX;
			this._selectionSkin.width = endX - startX;
			this._selectionSkin.y = this._verticalAlignOffsetY;
			this._selectionSkin.height = font.lineHeight * scale;
		}

		/**
		 * @private
		 */
		protected function getSelectedText():String
		{
			if(this._selectionBeginIndex == this._selectionEndIndex)
			{
				return null;
			}
			return this._text.substr(this._selectionBeginIndex, this._selectionEndIndex - this._selectionBeginIndex);
		}

		/**
		 * @private
		 */
		protected function deleteSelectedText():void
		{
			var currentValue:String = this._text;
			if(this._displayAsPassword)
			{
				currentValue = this._unmaskedText;
			}
			this.text = currentValue.substr(0, this._selectionBeginIndex) + currentValue.substr(this._selectionEndIndex);
			this.selectRange(this._selectionBeginIndex, this._selectionBeginIndex);
		}

		/**
		 * @private
		 */
		protected function replaceSelectedText(text:String):void
		{
			var currentValue:String = this._text;
			if(this._displayAsPassword)
			{
				currentValue = this._unmaskedText;
			}
			var newText:String = currentValue.substr(0, this._selectionBeginIndex) + text + currentValue.substr(this._selectionEndIndex);
			if(this._maxChars > 0 && newText.length > this._maxChars)
			{
				return;
			}
			this.text = newText;
			var selectionIndex:int = this._selectionBeginIndex + text.length;
			this.selectRange(selectionIndex, selectionIndex);
		}

		/**
		 * @private
		 */
		protected function hasFocus_enterFrameHandler(event:starling.events.Event):void
		{
			var target:DisplayObject = this;
			do
			{
				if(!target.visible)
				{
					this.clearFocus();
					break;
				}
				target = target.parent;
			}
			while(target);
		}

		/**
		 * @private
		 */
		protected function textEditor_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled || (!this._isEditable && !this._isSelectable))
			{
				this.touchPointID = -1;
				return;
			}
			if(this.touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this, null, this.touchPointID);
				var point:Point = Pool.getPoint();
				touch.getLocation(this, point);
				point.x += this._scrollX;
				this.selectRange(this._selectionAnchorIndex, this.getSelectionIndexAtPoint(point.x, point.y));
				Pool.putPoint(point);
				if(touch.phase === TouchPhase.ENDED)
				{
					this.touchPointID = -1;
				}
			}
			else //if we get here, we don't have a saved touch ID yet
			{
				touch = event.getTouch(this, TouchPhase.BEGAN);
				if(!touch)
				{
					return;
				}
				if(touch.tapCount == 2)
				{
					var start:int = TextInputNavigation.findCurrentWordStartIndex(this._text, this._selectionBeginIndex);
					var end:int = TextInputNavigation.findCurrentWordEndIndex(this._text, this._selectionEndIndex);
					this.selectRange(start, end);
					return;
				}
				else if(touch.tapCount > 2)
				{
					this.selectRange(0, this._text.length);
					return;
				}
				this.touchPointID = touch.id;
				point = Pool.getPoint();
				touch.getLocation(this, point);
				point.x += this._scrollX;
				if(event.shiftKey)
				{
					if(this._selectionAnchorIndex < 0)
					{
						this._selectionAnchorIndex = this._selectionBeginIndex;
					}
					this.selectRange(this._selectionAnchorIndex, this.getSelectionIndexAtPoint(point.x, point.y));
				}
				else
				{
					this.setFocus(point);
				}
				Pool.putPoint(point);
			}
		}

		/**
		 * @private
		 */
		protected function stage_touchHandler(event:TouchEvent):void
		{
			if(FocusManager.isEnabledForStage(this.stage))
			{
				//let the focus manager handle clearing focus
				return;
			}
			var touch:Touch = event.getTouch(this.stage, TouchPhase.BEGAN);
			if(!touch) //we only care about began touches
			{
				return;
			}
			var point:Point = Pool.getPoint();
			touch.getLocation(this.stage, point);
			var isInBounds:Boolean = this.contains(this.stage.hitTest(point));
			Pool.putPoint(point);
			if(isInBounds) //if the touch is in the text editor, it's all good
			{
				return;
			}
			//if the touch begins anywhere else, it's a focus out!
			this.clearFocus();
		}

		/**
		 * @private
		 */
		protected function stage_keyDownHandler(event:KeyboardEvent):void
		{
			if(!this._isEnabled || (!this._isEditable && !this._isSelectable) ||
				this.touchPointID >= 0 || event.isDefaultPrevented())
			{
				return;
			}
			//ignore select all, cut, copy, and paste
			var charCode:uint = event.charCode;
			if(event.ctrlKey && (charCode == 97 || charCode == 99 || charCode == 118 || charCode == 120)) //a, c, p, and x
			{
				return;
			}
			var newIndex:int = -1;
			if(!FocusManager.isEnabledForStage(this.stage) && event.keyCode == Keyboard.TAB)
			{
				this.clearFocus();
				return;
			}
			else if(event.keyCode == Keyboard.HOME || event.keyCode == Keyboard.UP)
			{
				newIndex = 0;
				if(event.shiftKey)
				{
					this.selectRange(newIndex, this._selectionAnchorIndex);
					return;
				}
			}
			else if(event.keyCode == Keyboard.END || event.keyCode == Keyboard.DOWN)
			{
				newIndex = this._text.length;
				if(event.shiftKey)
				{
					this.selectRange(this._selectionAnchorIndex, newIndex);
					return;
				}
			}
			else if(event.keyCode == Keyboard.LEFT)
			{
				if(event.shiftKey)
				{
					if(this._selectionAnchorIndex >= 0 && this._selectionAnchorIndex == this._selectionBeginIndex &&
						this._selectionBeginIndex != this._selectionEndIndex)
					{
						newIndex = this._selectionEndIndex - 1;
						this.selectRange(this._selectionBeginIndex, newIndex);
					}
					else
					{
						newIndex = this._selectionBeginIndex - 1;
						if(newIndex < 0)
						{
							newIndex = 0;
						}
						this.selectRange(newIndex, this._selectionEndIndex);
					}
					return;
				}
				else if(this._selectionBeginIndex != this._selectionEndIndex)
				{
					newIndex = this._selectionBeginIndex;
				}
				else
				{
					if(event.altKey || event.ctrlKey)
					{
						newIndex = TextInputNavigation.findPreviousWordStartIndex(this._text, this._selectionBeginIndex);
					}
					else
					{
						newIndex = this._selectionBeginIndex - 1;
					}
					if(newIndex < 0)
					{
						newIndex = 0;
					}
				}
			}
			else if(event.keyCode == Keyboard.RIGHT)
			{
				if(event.shiftKey)
				{
					if(this._selectionAnchorIndex >= 0 && this._selectionAnchorIndex == this._selectionEndIndex &&
						this._selectionBeginIndex != this._selectionEndIndex)
					{
						newIndex = this._selectionBeginIndex + 1;
						this.selectRange(newIndex, this._selectionEndIndex);
					}
					else
					{
						newIndex = this._selectionEndIndex + 1;
						if(newIndex < 0 || newIndex > this._text.length)
						{
							newIndex = this._text.length;
						}
						this.selectRange(this._selectionBeginIndex, newIndex);
					}
					return;
				}
				else if(this._selectionBeginIndex != this._selectionEndIndex)
				{
					newIndex = this._selectionEndIndex;
				}
				else
				{
					if(event.altKey || event.ctrlKey)
					{
						newIndex = TextInputNavigation.findNextWordStartIndex(this._text, this._selectionEndIndex);
					}
					else
					{
						newIndex = this._selectionEndIndex + 1;
					}
					if(newIndex < 0 || newIndex > this._text.length)
					{
						newIndex = this._text.length;
					}
				}
			}
			if(newIndex < 0)
			{
				if(event.keyCode == Keyboard.ENTER)
				{
					this.dispatchEventWith(FeathersEventType.ENTER);
					return;
				}
				//everything after this point edits the text, so return if the text
				//editor isn't editable.
				if(!this._isEditable)
				{
					return;
				}
				var currentValue:String = this._text;
				if(this._displayAsPassword)
				{
					currentValue = this._unmaskedText;
				}
				if(event.keyCode == Keyboard.DELETE)
				{
					if(event.altKey || event.ctrlKey)
					{
						var nextWordStartIndex:int = TextInputNavigation.findNextWordStartIndex(this._text, this._selectionEndIndex);
						this.text = currentValue.substr(0, this._selectionBeginIndex) + currentValue.substr(nextWordStartIndex);
					}
					else if(this._selectionBeginIndex != this._selectionEndIndex)
					{
						this.deleteSelectedText();
					}
					else if(this._selectionEndIndex < currentValue.length)
					{
						this.text = currentValue.substr(0, this._selectionBeginIndex) + currentValue.substr(this._selectionEndIndex + 1);
					}
				}
				else if(event.keyCode == Keyboard.BACKSPACE)
				{
					if(event.altKey || event.ctrlKey)
					{
						newIndex = TextInputNavigation.findPreviousWordStartIndex(this._text, this._selectionBeginIndex);
						this.text = currentValue.substr(0, newIndex) + currentValue.substr(this._selectionEndIndex);
					}
					else if(this._selectionBeginIndex != this._selectionEndIndex)
					{
						this.deleteSelectedText();
					}
					else if(this._selectionBeginIndex > 0)
					{
						newIndex = this._selectionBeginIndex - 1;
						this.text = currentValue.substr(0, this._selectionBeginIndex - 1) + currentValue.substr(this._selectionEndIndex);
					}
				}
			}
			if(newIndex >= 0)
			{
				this.selectRange(newIndex, newIndex);
			}
		}

		/**
		 * @private
		 */
		protected function nativeFocus_textInputHandler(event:TextEvent):void
		{
			if(!this._isEditable || !this._isEnabled)
			{
				return;
			}
			var text:String = event.text;
			if(text === CARRIAGE_RETURN || text === LINE_FEED)
			{
				//ignore new lines
				return;
			}
			var charCode:int = text.charCodeAt(0);
			if(!this._restrict || this._restrict.isCharacterAllowed(charCode))
			{
				this.replaceSelectedText(text);
			}
		}

		/**
		 * @private
		 */
		protected function nativeFocus_selectAllHandler(event:flash.events.Event):void
		{
			if(!this._isEnabled || (!this._isEditable && !this._isSelectable))
			{
				return;
			}
			this._selectionAnchorIndex = 0;
			this.selectRange(0, this._text.length);
		}

		/**
		 * @private
		 */
		protected function nativeFocus_cutHandler(event:flash.events.Event):void
		{
			if(!this._isEnabled || (!this._isEditable && !this._isSelectable) ||
				this._selectionBeginIndex == this._selectionEndIndex || this._displayAsPassword)
			{
				return;
			}
			Clipboard.generalClipboard.setData(ClipboardFormats.TEXT_FORMAT, this.getSelectedText());
			if(!this._isEditable)
			{
				return;
			}
			this.deleteSelectedText();
		}

		/**
		 * @private
		 */
		protected function nativeFocus_copyHandler(event:flash.events.Event):void
		{
			if(!this._isEnabled || (!this._isEditable && !this._isSelectable) ||
				this._selectionBeginIndex == this._selectionEndIndex || this._displayAsPassword)
			{
				return;
			}
			Clipboard.generalClipboard.setData(ClipboardFormats.TEXT_FORMAT, this.getSelectedText());
		}

		/**
		 * @private
		 */
		protected function nativeFocus_pasteHandler(event:flash.events.Event):void
		{
			if(!this._isEditable || !this._isEnabled)
			{
				return;
			}
			var pastedText:String = Clipboard.generalClipboard.getData(ClipboardFormats.TEXT_FORMAT) as String;
			if(pastedText === null)
			{
				//the clipboard doesn't contain any text to paste
				return;
			}
			//new lines are not allowed
			pastedText = pastedText.replace(/[\n\r]/g, "");
			if(this._restrict)
			{
				pastedText = this._restrict.filterText(pastedText);
			}
			this.replaceSelectedText(pastedText);
		}
	}
}


================================================
FILE: source/feathers/controls/text/BitmapFontTextRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.text
{
	import feathers.core.IFeathersControl;
	import feathers.core.ITextRenderer;
	import feathers.core.IToggle;
	import feathers.skins.IStyleProvider;
	import feathers.text.BitmapFontTextFormat;

	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.text.TextFormatAlign;

	import starling.display.Image;
	import starling.display.MeshBatch;
	import starling.rendering.Painter;
	import starling.styles.MeshStyle;
	import starling.text.BitmapChar;
	import starling.text.BitmapFont;
	import starling.text.TextField;
	import starling.text.TextFormat;
	import starling.textures.Texture;
	import starling.utils.Align;
	import starling.utils.MathUtil;
	import starling.utils.Pool;

	/**
	 * Renders text using
	 * <a href="http://wiki.starling-framework.org/manual/displaying_text#bitmap_fonts" target="_top">bitmap fonts</a>.
	 *
	 * <p>The following example shows how to use
	 * <code>BitmapFontTextRenderer</code> with a <code>Label</code>:</p>
	 *
	 * <listing version="3.0">
	 * var label:Label = new Label();
	 * label.text = "I am the very model of a modern Major General";
	 * label.textRendererFactory = function():ITextRenderer
	 * {
	 *     return new BitmapFontTextRenderer();
	 * };
	 * this.addChild( label );</listing>
	 *
	 * @see ../../../../help/text-renderers.html Introduction to Feathers text renderers
	 * @see ../../../../help/bitmap-font-text-renderer.html How to use the Feathers BitmapFontTextRenderer component
	 * @see http://wiki.starling-framework.org/manual/displaying_text#bitmap_fonts Starling Wiki: Displaying Text with Bitmap Fonts
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class BitmapFontTextRenderer extends BaseTextRenderer implements ITextRenderer
	{
		/**
		 * @private
		 */
		private static const HELPER_RESULT:MeasureTextResult = new MeasureTextResult();

		/**
		 * @private
		 */
		private static const CHARACTER_ID_SPACE:int = 32;

		/**
		 * @private
		 */
		private static const CHARACTER_ID_TAB:int = 9;

		/**
		 * @private
		 */
		private static const CHARACTER_ID_LINE_FEED:int = 10;

		/**
		 * @private
		 */
		private static const CHARACTER_ID_CARRIAGE_RETURN:int = 13;

		/**
		 * @private
		 */
		private static var CHARACTER_BUFFER:Vector.<CharLocation>;

		/**
		 * @private
		 */
		private static var CHAR_LOCATION_POOL:Vector.<CharLocation>;

		/**
		 * @private
		 */
		private static const FUZZY_MAX_WIDTH_PADDING:Number = 0.000001;

		/**
		 * The default <code>IStyleProvider</code> for all <code>BitmapFontTextRenderer</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function BitmapFontTextRenderer()
		{
			super();
			if(!CHAR_LOCATION_POOL)
			{
				//compiler doesn't like referencing CharLocation class in a
				//static constant
				CHAR_LOCATION_POOL = new <CharLocation>[];
			}
			if(!CHARACTER_BUFFER)
			{
				CHARACTER_BUFFER = new <CharLocation>[];
			}
			this.isQuickHitAreaEnabled = true;
		}

		/**
		 * @private
		 */
		protected var _characterBatch:MeshBatch = null;

		/**
		 * @private
		 * This variable may be used by subclasses to affect the x position of
		 * the text.
		 */
		protected var _batchX:Number = 0;

		/**
		 * @private
		 */
		protected var _textFormatChanged:Boolean = true;

		/**
		 * @private
		 */
		protected var _currentFontStyles:TextFormat = null;

		/**
		 * @private
		 */
		protected var _fontStylesTextFormat:BitmapFontTextFormat;

		/**
		 * @private
		 */
		protected var _currentVerticalAlign:String;

		/**
		 * @private
		 */
		protected var _verticalAlignOffsetY:Number = 0;

		/**
		 * @private
		 */
		protected var _currentTextFormat:BitmapFontTextFormat;

		/**
		 * For debugging purposes, the current
		 * <code>feathers.text.BitmapFontTextFormat</code> used to render the
		 * text. Updated during validation, and may be <code>null</code> before
		 * the first validation.
		 *
		 * <p>Do not modify this value. It is meant for testing and debugging
		 * only. Use the parent's <code>starling.text.TextFormat</code> font
		 * styles APIs instead.</p>
		 */
		public function get currentTextFormat():BitmapFontTextFormat
		{
			return this._currentTextFormat;
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return BitmapFontTextRenderer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		override public function set maxWidth(value:Number):void
		{
			//this is a special case because truncation may bypass normal rules
			//for determining if changing maxWidth should invalidate
			var needsInvalidate:Boolean = value > this._explicitMaxWidth && this._lastLayoutIsTruncated;
			super.maxWidth = value;
			if(needsInvalidate)
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		/**
		 * @private
		 */
		protected var _numLines:int = 0;

		/**
		 * @copy feathers.core.ITextRenderer#numLines
		 */
		public function get numLines():int
		{
			return this._numLines;
		}

		/**
		 * @private
		 */
		protected var _textFormatForState:Object;

		/**
		 * @private
		 */
		protected var _textFormat:BitmapFontTextFormat;

		/**
		 * Advanced font formatting used to draw the text, if
		 * <code>fontStyles</code> and <code>starling.text.TextFormat</code>
		 * cannot be used on the parent component because the other features of
		 * bitmap fonts are required.
		 *
		 * <p>In the following example, the text format is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.textFormat = new BitmapFontTextFormat( bitmapFont );</listing>
		 *
		 * <p><strong>Warning:</strong> If this property is not
		 * <code>null</code>, any <code>starling.text.TextFormat</code> font
		 * styles that are passed in from the parent component may be ignored.
		 * In other words, advanced font styling with
		 * <code>BitmapFontTextFormat</code> will always take precedence.</p>
		 *
		 * @default null
		 *
		 * @see #setTextFormatForState()
		 * @see #disabledTextFormat
		 * @see #selectedTextFormat
		 */
		public function get textFormat():BitmapFontTextFormat
		{
			return this._textFormat;
		}

		/**
		 * @private
		 */
		public function set textFormat(value:BitmapFontTextFormat):void
		{
			if(this._textFormat == value)
			{
				return;
			}
			this._textFormat = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _disabledTextFormat:BitmapFontTextFormat;

		/**
		 * Advanced font formatting used to draw the text when the component is
		 * disabled, if <code>disabledFontStyles</code> and
		 * <code>starling.text.TextFormat</code> cannot be used on the parent
		 * component because the other features of bitmap fonts are required.
		 *
		 * <p>In the following example, the disabled text format is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.isEnabled = false;
		 * textRenderer.disabledTextFormat = new BitmapFontTextFormat( bitmapFont );</listing>
		 *
		 * <p><strong>Warning:</strong> If this property is not
		 * <code>null</code>, any <code>starling.text.TextFormat</code> font
		 * styles that are passed in from the parent component may be ignored.
		 * In other words, advanced font styling with
		 * <code>BitmapFontTextFormat</code> will always take precedence.</p>
		 *
		 * @default null
		 *
		 * @see #textFormat
		 * @see #selectedTextFormat
		 */
		public function get disabledTextFormat():BitmapFontTextFormat
		{
			return this._disabledTextFormat;
		}

		/**
		 * @private
		 */
		public function set disabledTextFormat(value:BitmapFontTextFormat):void
		{
			if(this._disabledTextFormat == value)
			{
				return;
			}
			this._disabledTextFormat = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _selectedTextFormat:BitmapFontTextFormat;

		/**
		 * Advanced font formatting used to draw the text when the
		 * <code>stateContext</code> is disabled, if
		 * <code>selectedFontStyles</code> and
		 * <code>starling.text.TextFormat</code> cannot be used on the parent
		 * component because the other features of bitmap fonts are required.
		 *
		 * <p>In the following example, the selected text format is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.selectedTextFormat = new BitmapFontTextFormat( bitmapFont );</listing>
		 *
		 * <p><strong>Warning:</strong> If this property is not
		 * <code>null</code>, any <code>starling.text.TextFormat</code> font
		 * styles that are passed in from the parent component may be ignored.
		 * In other words, advanced font styling with
		 * <code>BitmapFontTextFormat</code> will always take precedence.</p>
		 *
		 * @default null
		 *
		 * @see #stateContext
		 * @see feathers.core.IToggle
		 * @see #textFormat
		 * @see #disabledTextFormat
		 */
		public function get selectedTextFormat():BitmapFontTextFormat
		{
			return this._selectedTextFormat;
		}

		/**
		 * @private
		 */
		public function set selectedTextFormat(value:BitmapFontTextFormat):void
		{
			if(this._selectedTextFormat == value)
			{
				return;
			}
			this._selectedTextFormat = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _textureSmoothing:String = null;

		[Inspectable(type="String",enumeration="bilinear,trilinear,none")]
		/**
		 * A texture smoothing value passed to each character image. If
		 * <code>null</code>, defaults to the value specified by the
		 * <code>smoothing</code> property of the <code>BitmapFont</code>.
		 *
		 * <p>In the following example, the texture smoothing is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.textureSmoothing = TextureSmoothing.NONE;</listing>
		 *
		 * @default null
		 *
		 * @see http://doc.starling-framework.org/core/starling/textures/TextureSmoothing.html starling.textures.TextureSmoothing
		 */
		public function get textureSmoothing():String
		{
			return this._textureSmoothing;
		}

		/**
		 * @private
		 */
		public function set textureSmoothing(value:String):void
		{
			if(this._textureSmoothing == value)
			{
				return;
			}
			this._textureSmoothing = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _pixelSnapping:Boolean = true;

		/**
		 * Determines if the position of the text should be snapped to the
		 * nearest whole pixel when rendered. When snapped to a whole pixel, the
		 * text is often more readable. When not snapped, the text may become
		 * blurry due to texture smoothing.
		 *
		 * <p>In the following example, the text is not snapped to pixels:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.pixelSnapping = false;</listing>
		 *
		 * @default true
		 */
		public function get pixelSnapping():Boolean
		{
			return _pixelSnapping;
		}

		/**
		 * @private
		 */
		public function set pixelSnapping(value:Boolean):void
		{
			if(this._pixelSnapping === value)
			{
				return;
			}
			this._pixelSnapping = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _breakLongWords:Boolean = false;

		/**
		 * If <code>wordWrap</code> is <code>true</code>, determines if words
		 * longer than the width of the text renderer will break in the middle
		 * or if the word will extend outside the edges until it ends.
		 *
		 * <p>In the following example, the text will break long words:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.breakLongWords = true;</listing>
		 *
		 * @default false
		 *
		 * @see #wordWrap
		 */
		public function get breakLongWords():Boolean
		{
			return _breakLongWords;
		}

		/**
		 * @private
		 */
		public function set breakLongWords(value:Boolean):void
		{
			if(this._breakLongWords === value)
			{
				return;
			}
			this._breakLongWords = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _truncateToFit:Boolean = true;

		/**
		 * If word wrap is disabled, and the text is longer than the width of
		 * the label, the text may be truncated using <code>truncationText</code>.
		 *
		 * <p>This feature may be disabled to improve performance.</p>
		 *
		 * <p>This feature does not currently support the truncation of text
		 * displayed on multiple lines.</p>
		 *
		 * <p>In the following example, truncation is disabled:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.truncateToFit = false;</listing>
		 *
		 * @default true
		 *
		 * @see #truncationText
		 */
		public function get truncateToFit():Boolean
		{
			return _truncateToFit;
		}

		/**
		 * @private
		 */
		public function set truncateToFit(value:Boolean):void
		{
			if(this._truncateToFit == value)
			{
				return;
			}
			this._truncateToFit = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _truncationText:String = "...";

		/**
		 * The text to display at the end of the label if it is truncated.
		 *
		 * <p>In the following example, the truncation text is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.truncationText = " [more]";</listing>
		 *
		 * @default "..."
		 */
		public function get truncationText():String
		{
			return _truncationText;
		}

		/**
		 * @private
		 */
		public function set truncationText(value:String):void
		{
			if(this._truncationText == value)
			{
				return;
			}
			this._truncationText = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _useSeparateBatch:Boolean = true;

		/**
		 * Determines if the characters are batched normally by Starling or if
		 * they're batched separately. Batching separately may improve
		 * performance for text that changes often, while batching normally
		 * may be better when a lot of text is displayed on screen at once.
		 *
		 * <p>In the following example, separate batching is disabled:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.useSeparateBatch = false;</listing>
		 *
		 * @default true
		 */
		public function get useSeparateBatch():Boolean
		{
			return this._useSeparateBatch;
		}

		/**
		 * @private
		 */
		public function set useSeparateBatch(value:Boolean):void
		{
			if(this._useSeparateBatch == value)
			{
				return;
			}
			this._useSeparateBatch = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _defaultStyle:MeshStyle = null;

		/**
		 * @private
		 */
		protected var _style:MeshStyle = null;

		/**
		 * The style that is used to render the text's mesh.
		 *
		 * <p>In the following example, the text renderer uses a custom style:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.style = new DistanceFieldStyle();</listing>
		 *
		 * @default null
		 */
		public function get style():MeshStyle
		{
			return this._style;
		}

		/**
		 * @private
		 */
		public function set style(value:MeshStyle):void
		{
			if(this._style == value)
			{
				return;
			}
			this._style = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @inheritDoc
		 */
		public function get baseline():Number
		{
			if(this._currentTextFormat === null)
			{
				return 0;
			}
			var font:BitmapFont = this._currentTextFormat.font;
			var formatSize:Number = this._currentTextFormat.size;
			var fontSizeScale:Number = formatSize / font.size;
			if(fontSizeScale !== fontSizeScale) //isNaN
			{
				fontSizeScale = 1;
			}
			var baseline:Number = font.baseline;
			//for some reason, if we do the !== check on a local variable right
			//here, compiling with the flex 4.6 SDK will throw a VerifyError
			//for a stack overflow.
			//we could change the !== check back to isNaN() instead, but
			//isNaN() can allocate an object that needs garbage collection.
			this._compilerWorkaround = baseline;
			if(baseline !== baseline) //isNaN
			{
				return font.lineHeight * fontSizeScale;
			}
			return baseline * fontSizeScale;
		}

		/**
		 * @private
		 */
		protected var _image:Image = null;

		/**
		 * @private
		 * This function is here to work around a bug in the Flex 4.6 SDK
		 * compiler. For explanation, see the places where it gets called.
		 */
		private var _compilerWorkaround:Object;

		/**
		 * @private
		 */
		override public function render(painter:Painter):void
		{
			this._characterBatch.x = this._batchX;
			this._characterBatch.y = this._verticalAlignOffsetY;
			super.render(painter);
		}

		/**
		 * @inheritDoc
		 */
		public function measureText(result:Point = null):Point
		{
			return this.measureTextInternal(result, true);
		}

		/**
		 * Gets the advanced <code>BitmapFontTextFormat</code> font formatting
		 * passed in using <code>setTextFormatForState()</code> for the
		 * specified state.
		 *
		 * <p>If an <code>BitmapFontTextFormat</code> is not defined for a
		 * specific state, returns <code>null</code>.</p>
		 *
		 * @see #setTextFormatForState()
		 */
		public function getTextFormatForState(state:String):BitmapFontTextFormat
		{
			if(this._textFormatForState === null)
			{
				return null;
			}
			return BitmapFontTextFormat(this._textFormatForState[state]);
		}

		/**
		 * Sets the advanced <code>BitmapFontTextFormat</code> font formatting
		 * to be used by the text renderer when the <code>currentState</code>
		 * property of the <code>stateContext</code> matches the specified state
		 * value. For advanced use cases where
		 * <code>starling.text.TextFormat</code> cannot be used on the parent
		 * component because other features of bitmap fonts are required.
		 *
		 * <p>If an <code>BitmapFontTextFormat</code> is not defined for a
		 * specific state, the value of the <code>textFormat</code> property
		 * will be used instead.</p>
		 *
		 * <p>If the <code>disabledTextFormat</code> property is not
		 * <code>null</code> and the <code>isEnabled</code> property is
		 * <code>false</code>, all other text formats will be ignored.</p>
		 *
		 * @see #stateContext
		 * @see #textFormat
		 */
		public function setTextFormatForState(state:String, textFormat:BitmapFontTextFormat):void
		{
			if(textFormat)
			{
				if(!this._textFormatForState)
				{
					this._textFormatForState = {};
				}
				this._textFormatForState[state] = textFormat;
			}
			else
			{
				delete this._textFormatForState[state];
			}
			//if the context's current state is the state that we're modifying,
			//we need to use the new value immediately.
			if(this._stateContext && this._stateContext.currentState === state)
			{
				this.invalidate(INVALIDATION_FLAG_STATE);
			}
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(this._characterBatch === null)
			{
				this._characterBatch = new MeshBatch();
				this._characterBatch.touchable = false;
				this.addChild(this._characterBatch);
			}
		}

		/**
		 * @private
		 */
		protected var _lastLayoutWidth:Number = 0;

		/**
		 * @private
		 */
		protected var _lastLayoutHeight:Number = 0;

		/**
		 * @private
		 */
		protected var _lastLayoutIsTruncated:Boolean = false;

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);

			if(stylesInvalid || stateInvalid)
			{
				this.refreshTextFormat();
			}

			if(stylesInvalid)
			{
				this._characterBatch.pixelSnapping = this._pixelSnapping;
				this._characterBatch.batchable = !this._useSeparateBatch;
			}

			//sometimes, we can determine that the layout will be exactly
			//the same without needing to update. this will result in much
			//better performance.
			var newWidth:Number = this._explicitWidth;
			if(newWidth !== newWidth) //isNaN
			{
				newWidth = this._explicitMaxWidth;
			}

			//sometimes, we can determine that the dimensions will be exactly
			//the same without needing to refresh the text lines. this will
			//result in much better performance.
			if(this._wordWrap)
			{
				//when word wrapped, we need to measure again any time that the
				//width changes.
				var sizeInvalid:Boolean = newWidth != this._lastLayoutWidth;
			}
			else
			{
				//we can skip measuring again more frequently when the text is
				//a single line.

				//if the width is smaller than the last layout width, we need to
				//measure again. when it's larger, the result won't change...
				sizeInvalid = newWidth < this._lastLayoutWidth;

				//...unless the text was previously truncated!
				sizeInvalid ||= (this._lastLayoutIsTruncated && newWidth != this._lastLayoutWidth);

				//... or the text is aligned
				sizeInvalid ||= this._currentTextFormat.align !== TextFormatAlign.LEFT;
			}

			if(dataInvalid || sizeInvalid || stylesInvalid || this._textFormatChanged)
			{
				this._textFormatChanged = false;
				this._characterBatch.clear();
				if(!this._currentTextFormat || this._text === null)
				{
					this.saveMeasurements(0, 0, 0, 0);
					return;
				}
				this.layoutCharacters(HELPER_RESULT);
				//for some reason, we can't just set the style once...
				//we need to set up every time after layout
				if(this._style !== null)
				{
					this._characterBatch.style = this._style;
				}
				else
				{
					//getDefaultMeshStyle doesn't exist in Starling 2.2
					this._defaultStyle = this._currentTextFormat.font.getDefaultMeshStyle(this._defaultStyle, this._currentFontStyles, null);
					if(this._defaultStyle)
					{
						this._characterBatch.style = this._defaultStyle;
					}
				}
				this._lastLayoutWidth = HELPER_RESULT.width;
				this._lastLayoutHeight = HELPER_RESULT.height;
				this._lastLayoutIsTruncated = HELPER_RESULT.isTruncated;
			}
			this.saveMeasurements(this._lastLayoutWidth, this._lastLayoutHeight,
				this._lastLayoutWidth, this._lastLayoutHeight);
			this._verticalAlignOffsetY = this.getVerticalAlignOffsetY();
		}

		/**
		 * @private
		 */
		protected function layoutCharacters(result:MeasureTextResult = null):MeasureTextResult
		{
			if(!result)
			{
				result = new MeasureTextResult();
			}
			this._numLines = 1;

			var font:BitmapFont = this._currentTextFormat.font;
			var customSize:Number = this._currentTextFormat.size;
			var customLetterSpacing:Number = this._currentTextFormat.letterSpacing;
			var isKerningEnabled:Boolean = this._currentTextFormat.isKerningEnabled;
			var scale:Number = customSize / font.size;
			if(scale !== scale) //isNaN
			{
				scale = 1;
			}
			var lineHeight:Number = font.lineHeight * scale + this._currentTextFormat.leading;
			var offsetX:Number = font.offsetX * scale;
			var offsetY:Number = font.offsetY * scale;

			var hasExplicitWidth:Boolean = this._explicitWidth === this._explicitWidth; //!isNaN
			var isAligned:Boolean = this._currentTextFormat.align != TextFormatAlign.LEFT;
			var maxLineWidth:Number = hasExplicitWidth ? this._explicitWidth : this._explicitMaxWidth;
			if(isAligned && maxLineWidth == Number.POSITIVE_INFINITY)
			{
				//we need to measure the text to get the maximum line width
				//so that we can align the text
				var point:Point = Pool.getPoint();
				this.measureText(point);
				maxLineWidth = point.x;
				Pool.putPoint(point);
			}
			var textToDraw:String = this._text;
			if(this._truncateToFit)
			{
				var truncatedText:String = this.getTruncatedText(maxLineWidth);
				result.isTruncated = truncatedText !== textToDraw;
				textToDraw = truncatedText;
			}
			else
			{
				result.isTruncated = false;
			}
			CHARACTER_BUFFER.length = 0;

			var maxX:Number = 0;
			var currentX:Number = 0;
			var currentY:Number = 0;
			var previousCharID:Number = NaN;
			var isWordComplete:Boolean = false;
			var startXOfPreviousWord:Number = 0;
			var widthOfWhitespaceAfterWord:Number = 0;
			var wordLength:int = 0;
			var wordCountForLine:int = 0;
			var charData:BitmapChar = null;
			var charCount:int = textToDraw ? textToDraw.length : 0;
			for(var i:int = 0; i < charCount; i++)
			{
				isWordComplete = false;
				var charID:int = textToDraw.charCodeAt(i);
				if(charID == CHARACTER_ID_LINE_FEED || charID == CHARACTER_ID_CARRIAGE_RETURN) //new line \n or \r
				{
					//remove whitespace after the final character in the line
					currentX -= customLetterSpacing;
					if(charData !== null)
					{
						currentX -= (charData.xAdvance - charData.width) * scale;
					}
					if(currentX < 0)
					{
						currentX = 0;
					}
					if(this._wordWrap || isAligned)
					{
						this.alignBuffer(maxLineWidth, currentX, 0);
						this.addBufferToBatch(0);
					}
					if(maxX < currentX)
					{
						maxX = currentX;
					}
					previousCharID = NaN;
					currentX = 0;
					currentY += lineHeight;
					startXOfPreviousWord = 0;
					widthOfWhitespaceAfterWord = 0;
					wordLength = 0;
					wordCountForLine = 0;
					this._numLines++;
					continue;
				}

				charData = font.getChar(charID);
				if(charData === null)
				{
					trace("Missing character " + String.fromCharCode(charID) + " in font " + font.name + ".");
					continue;
				}

				if(isKerningEnabled &&
					previousCharID === previousCharID) //!isNaN
				{
					currentX += charData.getKerning(previousCharID) * scale;
				}

				var xAdvance:Number = charData.xAdvance * scale;
				if(this._wordWrap)
				{
					var currentCharIsWhitespace:Boolean = charID == CHARACTER_ID_SPACE || charID == CHARACTER_ID_TAB;
					var previousCharIsWhitespace:Boolean = previousCharID == CHARACTER_ID_SPACE || previousCharID == CHARACTER_ID_TAB;
					if(currentCharIsWhitespace)
					{
						if(!previousCharIsWhitespace)
						{
							//this is the spacing after the last character
							//that isn't whitespace
							var previousCharData:BitmapChar = font.getChar(previousCharID);
							widthOfWhitespaceAfterWord = customLetterSpacing + (previousCharData.xAdvance - previousCharData.width) * scale;
						}
						widthOfWhitespaceAfterWord += xAdvance;
					}
					else if(previousCharIsWhitespace)
					{
						startXOfPreviousWord = currentX;
						wordLength = 0;
						wordCountForLine++;
						isWordComplete = true;
					}

					//we may need to move to a new line at the same time
					//that our previous word in the buffer can be batched
					//so we need to add the buffer here rather than after
					//the next section
					if(isWordComplete && !isAligned)
					{
						this.addBufferToBatch(0);
					}

					//floating point errors can cause unnecessary line breaks,
					//so we're going to be a little bit fuzzy on the greater
					//than check. such tiny numbers shouldn't break anything.
					var charWidth:Number = charData.width * scale;
					if(!currentCharIsWhitespace && (wordCountForLine > 0 || this._breakLongWords) && ((currentX + charWidth) - maxLineWidth) > FUZZY_MAX_WIDTH_PADDING)
					{
						if(wordCountForLine == 0)
						{
							//if we're breaking long words, this is where we break.
							//we need to pretend that there's a word before this one.
							wordLength = 0;
							startXOfPreviousWord = currentX;
							widthOfWhitespaceAfterWord = 0;
							if(previousCharID === previousCharID) //!isNaN
							{
								previousCharData = font.getChar(previousCharID);
								widthOfWhitespaceAfterWord = customLetterSpacing + (previousCharData.xAdvance - previousCharData.width) * scale;
							}
							if(!isAligned)
							{
								this.addBufferToBatch(0);
							}
						}
						if(isAligned)
						{
							this.trimBuffer(wordLength);
							this.alignBuffer(maxLineWidth, startXOfPreviousWord - widthOfWhitespaceAfterWord, wordLength);
							this.addBufferToBatch(wordLength);
						}
						this.moveBufferedCharacters(-startXOfPreviousWord, lineHeight, 0);
						//we're just reusing this variable to avoid creating a
						//new one. it'll be reset to 0 in a moment.
						widthOfWhitespaceAfterWord = startXOfPreviousWord - widthOfWhitespaceAfterWord;
						if(maxX < widthOfWhitespaceAfterWord)
						{
							maxX = widthOfWhitespaceAfterWord;
						}
						previousCharID = NaN;
						currentX -= startXOfPreviousWord;
						currentY += lineHeight;
						startXOfPreviousWord = 0;
						widthOfWhitespaceAfterWord = 0;
						wordLength = 0;
						isWordComplete = false;
						wordCountForLine = 0;
						this._numLines++;
					}
				}
				if(this._wordWrap || isAligned)
				{
					var charLocation:CharLocation = CHAR_LOCATION_POOL.length > 0 ? CHAR_LOCATION_POOL.shift() : new CharLocation();
					charLocation.char = charData;
					charLocation.x = currentX + offsetX + charData.xOffset * scale;
					charLocation.y = currentY + offsetY + charData.yOffset * scale;
					charLocation.scale = scale;
					CHARACTER_BUFFER[CHARACTER_BUFFER.length] = charLocation;
					wordLength++;
				}
				else
				{
					this.addCharacterToBatch(charData,
						currentX + offsetX + charData.xOffset * scale,
						currentY + offsetY + charData.yOffset * scale,
						scale);
				}

				currentX += xAdvance + customLetterSpacing;
				previousCharID = charID;
			}
			//remove whitespace after the final character in the final line
			currentX = currentX - customLetterSpacing;
			if(charData !== null)
			{
				currentX -= (charData.xAdvance - charData.width) * scale;
			}
			if(currentX < 0)
			{
				currentX = 0;
			}
			if(this._wordWrap || isAligned)
			{
				this.alignBuffer(maxLineWidth, currentX, 0);
				this.addBufferToBatch(0);
			}
			//if the text ends in extra whitespace, the currentX value will be
			//larger than the max line width. we'll remove that and add extra
			//lines.
			if(this._wordWrap)
			{
				while(currentX > maxLineWidth && !MathUtil.isEquivalent(currentX, maxLineWidth))
				{
					currentX -= maxLineWidth;
					currentY += lineHeight;
					if(maxLineWidth == 0)
					{
						//we don't want to get stuck in an infinite loop!
						break;
					}
				}
			}
			if(maxX < currentX)
			{
				maxX = currentX;
			}

			if(isAligned && !hasExplicitWidth)
			{
				var align:String = this._currentTextFormat.align;
				if(align == TextFormatAlign.CENTER)
				{
					this._batchX = (maxX - maxLineWidth) / 2;
				}
				else if(align == TextFormatAlign.RIGHT)
				{
					this._batchX = maxX - maxLineWidth;
				}
			}
			else
			{
				this._batchX = 0;
			}
			this._characterBatch.x = this._batchX;

			result.width = maxX;
			result.height = currentY + lineHeight - this._currentTextFormat.leading;
			return result;
		}

		/**
		 * @private
		 */
		protected function trimBuffer(skipCount:int):void
		{
			var countToRemove:int = 0;
			var charCount:int = CHARACTER_BUFFER.length - skipCount;
			for(var i:int = charCount - 1; i >= 0; i--)
			{
				var charLocation:CharLocation = CHARACTER_BUFFER[i];
				var charData:BitmapChar = charLocation.char;
				var charID:int = charData.charID;
				if(charID == CHARACTER_ID_SPACE || charID == CHARACTER_ID_TAB)
				{
					countToRemove++;
				}
				else
				{
					break;
				}
			}
			if(countToRemove > 0)
			{
				CHARACTER_BUFFER.splice(i + 1, countToRemove);
			}
		}

		/**
		 * @private
		 */
		protected function alignBuffer(maxLineWidth:Number, currentLineWidth:Number, skipCount:int):void
		{
			var align:String = this._currentTextFormat.align;
			if(align == TextFormatAlign.CENTER)
			{
				this.moveBufferedCharacters(Math.round((maxLineWidth - currentLineWidth) / 2), 0, skipCount);
			}
			else if(align == TextFormatAlign.RIGHT)
			{
				this.moveBufferedCharacters(maxLineWidth - currentLineWidth, 0, skipCount);
			}
		}

		/**
		 * @private
		 */
		protected function addBufferToBatch(skipCount:int):void
		{
			var charCount:int = CHARACTER_BUFFER.length - skipCount;
			var pushIndex:int = CHAR_LOCATION_POOL.length;
			for(var i:int = 0; i < charCount; i++)
			{
				var charLocation:CharLocation = CHARACTER_BUFFER.shift();
				this.addCharacterToBatch(charLocation.char, charLocation.x, charLocation.y, charLocation.scale);
				charLocation.char = null;
				CHAR_LOCATION_POOL[pushIndex] = charLocation;
				pushIndex++;
			}
		}

		/**
		 * @private
		 */
		protected function moveBufferedCharacters(xOffset:Number, yOffset:Number, skipCount:int):void
		{
			var charCount:int = CHARACTER_BUFFER.length - skipCount;
			for(var i:int = 0; i < charCount; i++)
			{
				var charLocation:CharLocation = CHARACTER_BUFFER[i];
				charLocation.x += xOffset;
				charLocation.y += yOffset;
			}
		}

		/**
		 * @private
		 */
		protected function addCharacterToBatch(charData:BitmapChar, x:Number, y:Number, scale:Number, painter:Painter = null):void
		{
			var texture:Texture = charData.texture;
			var frame:Rectangle = texture.frame;
			if(frame)
			{
				if(frame.width == 0 || frame.height == 0)
				{
					return;
				}
			}
			else if(texture.width == 0 || texture.height == 0)
			{
				return;
			}
			var font:BitmapFont = this._currentTextFormat.font;
			if(this._image === null)
			{
				this._image = new Image(texture);
			}
			else
			{
				this._image.texture = texture;
				this._image.readjustSize();
			}
			this._image.scaleX = scale;
			this._image.scaleY = scale;
			this._image.x = x;
			this._image.y = y;
			this._image.color = this._currentTextFormat.color;
			if(this._textureSmoothing !== null)
			{
				this._image.textureSmoothing = this._textureSmoothing;
			}
			else
			{
				this._image.textureSmoothing = font.smoothing;
			}

			if(painter !== null)
			{
				painter.pushState();
				painter.setStateTo(this._image.transformationMatrix);
				painter.batchMesh(this._image);
				painter.popState();
			}
			else
			{
				this._characterBatch.addMesh(this._image);
			}
		}

		/**
		 * @private
		 */
		protected function refreshTextFormat():void
		{
			var textFormat:BitmapFontTextFormat;
			if(this._stateContext !== null)
			{
				if(this._textFormatForState !== null)
				{
					var currentState:String = this._stateContext.currentState;
					if(currentState in this._textFormatForState)
					{
						textFormat = BitmapFontTextFormat(this._textFormatForState[currentState]);
					}
				}
				if(textFormat === null && this._disabledTextFormat !== null &&
					this._stateContext is IFeathersControl && !IFeathersControl(this._stateContext).isEnabled)
				{
					textFormat = this._disabledTextFormat;
				}
				if(textFormat === null && this._selectedTextFormat !== null &&
					this._stateContext is IToggle && IToggle(this._stateContext).isSelected)
				{
					textFormat = this._selectedTextFormat;
				}
			}
			else //no state context
			{
				//we can still check if the text renderer is disabled to see if
				//we should use disabledTextFormat
				if(!this._isEnabled && this._disabledTextFormat !== null)
				{
					textFormat = this._disabledTextFormat;
				}
			}
			if(textFormat === null)
			{
				textFormat = this._textFormat;
			}
			if(textFormat === null)
			{
				textFormat = this.getTextFormatFromFontStyles();
			}
			else
			{
				//when using BitmapFontTextFormat, vertical align is always top
				this._currentVerticalAlign = Align.TOP;
				if(this._currentFontStyles === null)
				{
					this._currentFontStyles = new TextFormat();
				}
				//we need the size to determine the default mesh style
				this._currentFontStyles.size = textFormat.size;
			}
			if(this._currentTextFormat !== textFormat)
			{
				this._currentTextFormat = textFormat;
				this._textFormatChanged = true;
			}
		}

		/**
		 * @private
		 */
		protected function getTextFormatFromFontStyles():BitmapFontTextFormat
		{
			if(this.isInvalid(INVALIDATION_FLAG_STYLES) ||
				this.isInvalid(INVALIDATION_FLAG_STATE))
			{
				var textFormat:TextFormat;
				if(this._fontStyles !== null)
				{
					textFormat = this._fontStyles.getTextFormatForTarget(this);
					this._currentFontStyles = textFormat;
				}
				if(textFormat !== null)
				{
					this._fontStylesTextFormat = new BitmapFontTextFormat(
						textFormat.font, textFormat.size, textFormat.color,
						textFormat.horizontalAlign, textFormat.leading);
					this._fontStylesTextFormat.isKerningEnabled = textFormat.kerning;
					this._fontStylesTextFormat.letterSpacing = textFormat.letterSpacing;
					this._currentVerticalAlign = textFormat.verticalAlign;
				}
				else if(this._fontStylesTextFormat === null)
				{
					//let's fall back to using Starling's embedded mini font if no
					//text format has been specified

					//if it's not registered, do that first
					if(!TextField.getBitmapFont(BitmapFont.MINI))
					{
						var font:BitmapFont = new BitmapFont();
						TextField.registerCompositor(font, font.name);
					}
					this._fontStylesTextFormat = new BitmapFontTextFormat(BitmapFont.MINI, NaN, 0x000000);
					this._currentVerticalAlign = Align.TOP;
				}
			}
			return this._fontStylesTextFormat;
		}

		/**
		 * @private
		 */
		protected function measureTextInternal(result:Point, useExplicit:Boolean):Point
		{
			if(!result)
			{
				result = new Point();
			}

			var needsWidth:Boolean = !useExplicit || this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = !useExplicit || this._explicitHeight !== this._explicitHeight; //isNaN
			if(!needsWidth && !needsHeight)
			{
				result.x = this._explicitWidth;
				result.y = this._explicitHeight;
				return result;
			}

			if(this.isInvalid(INVALIDATION_FLAG_STYLES) || this.isInvalid(INVALIDATION_FLAG_STATE))
			{
				this.refreshTextFormat();
			}

			if(!this._currentTextFormat || this._text === null)
			{
				result.setTo(0, 0);
				return result;
			}

			var font:BitmapFont = this._currentTextFormat.font;
			var customSize:Number = this._currentTextFormat.size;
			var customLetterSpacing:Number = this._currentTextFormat.letterSpacing;
			var isKerningEnabled:Boolean = this._currentTextFormat.isKerningEnabled;
			var scale:Number = customSize / font.size;
			if(scale !== scale) //isNaN
			{
				scale = 1;
			}
			var lineHeight:Number = font.lineHeight * scale + this._currentTextFormat.leading;
			var maxLineWidth:Number = this._explicitWidth;
			if(maxLineWidth !== maxLineWidth) //isNaN
			{
				maxLineWidth = this._explicitMaxWidth;
			}

			var maxX:Number = 0;
			var currentX:Number = 0;
			var currentY:Number = 0;
			var previousCharID:Number = NaN;
			var charCount:int = this._text.length;
			var startXOfPreviousWord:Number = 0;
			var widthOfWhitespaceAfterWord:Number = 0;
			var wordCountForLine:int = 0;
			var line:String = "";
			var word:String = "";
			var charData:BitmapChar = null;
			for(var i:int = 0; i < charCount; i++)
			{
				var charID:int = this._text.charCodeAt(i);
				if(charID == CHARACTER_ID_LINE_FEED || charID == CHARACTER_ID_CARRIAGE_RETURN) //new line \n or \r
				{
					//remove whitespace after the final character in the line
					currentX -= customLetterSpacing;
					if(charData !== null)
					{
						currentX -= (charData.xAdvance - charData.width) * scale;
					}
					if(currentX < 0)
					{
						currentX = 0;
					}
					if(maxX < currentX)
					{
						maxX = currentX;
					}
					previousCharID = NaN;
					currentX = 0;
					currentY += lineHeight;
					startXOfPreviousWord = 0;
					wordCountForLine = 0;
					widthOfWhitespaceAfterWord = 0;
					continue;
				}

				charData = font.getChar(charID);
				if(charData === null)
				{
					trace("Missing character " + String.fromCharCode(charID) + " in font " + font.name + ".");
					continue;
				}

				if(isKerningEnabled &&
					previousCharID === previousCharID) //!isNaN
				{
					currentX += charData.getKerning(previousCharID) * scale;
				}

				var xAdvance:Number = charData.xAdvance * scale;
				if(this._wordWrap)
				{
					var currentCharIsWhitespace:Boolean = charID == CHARACTER_ID_SPACE || charID == CHARACTER_ID_TAB;
					var previousCharIsWhitespace:Boolean = previousCharID == CHARACTER_ID_SPACE || previousCharID == CHARACTER_ID_TAB;
					if(currentCharIsWhitespace)
					{
						if(!previousCharIsWhitespace)
						{
							//this is the spacing after the last character
							//that isn't whitespace
							var previousCharData:BitmapChar = font.getChar(previousCharID);
							widthOfWhitespaceAfterWord = customLetterSpacing + (previousCharData.xAdvance - previousCharData.width) * scale;
						}
						widthOfWhitespaceAfterWord += xAdvance;
					}
					else if(previousCharIsWhitespace)
					{
						startXOfPreviousWord = currentX;
						wordCountForLine++;
						line += word;
						word = "";
					}

					var charWidth:Number = charData.width * scale;
					if(!currentCharIsWhitespace && (wordCountForLine > 0 || this._breakLongWords) && (currentX + charWidth) > maxLineWidth)
					{
						if(wordCountForLine == 0)
						{
							//if we're breaking long words, this is where we break
							startXOfPreviousWord = currentX;
							if(previousCharID === previousCharID) //!isNaN
							{
								previousCharData = font.getChar(previousCharID);
								widthOfWhitespaceAfterWord = customLetterSpacing + (previousCharData.xAdvance - previousCharData.width) * scale;
							}
						}
						//we're just reusing this variable to avoid creating a
						//new one. it'll be reset to 0 in a moment.
						widthOfWhitespaceAfterWord = startXOfPreviousWord - widthOfWhitespaceAfterWord;
						if(maxX < widthOfWhitespaceAfterWord)
						{
							maxX = widthOfWhitespaceAfterWord;
						}
						previousCharID = NaN;
						currentX -= startXOfPreviousWord;
						currentY += lineHeight;
						startXOfPreviousWord = 0;
						widthOfWhitespaceAfterWord = 0;
						wordCountForLine = 0;
						line = "";
					}
				}
				currentX += xAdvance + customLetterSpacing;
				previousCharID = charID;
				word += String.fromCharCode(charID);
			}
			//remove whitespace after the final character in the final line
			currentX -= customLetterSpacing;
			if(charData !== null)
			{
				currentX -= (charData.xAdvance - charData.width) * scale;
			}
			if(currentX < 0)
			{
				currentX = 0;
			}
			//if the text ends in extra whitespace, the currentX value will be
			//larger than the max line width. we'll remove that and add extra
			//lines.
			if(this._wordWrap)
			{
				while(currentX > maxLineWidth && !MathUtil.isEquivalent(currentX, maxLineWidth))
				{
					currentX -= maxLineWidth;
					currentY += lineHeight;
					if(maxLineWidth == 0)
					{
						//we don't want to get stuck in an infinite loop!
						break;
					}
				}
			}
			if(maxX < currentX)
			{
				maxX = currentX;
			}

			if(needsWidth)
			{
				result.x = maxX;
			}
			else
			{
				result.x = this._explicitWidth;
			}
			if(needsHeight)
			{
				result.y = currentY + lineHeight - this._currentTextFormat.leading;
			}
			else
			{
				result.y = this._explicitHeight;
			}

			return result;
		}

		/**
		 * @private
		 */
		protected function getTruncatedText(width:Number):String
		{
			if(!this._text)
			{
				//this shouldn't be called if _text is null, but just in case...
				return "";
			}

			//if the width is infinity or the string is multiline, don't allow truncation
			if(width == Number.POSITIVE_INFINITY || this._wordWrap || this._text.indexOf(String.fromCharCode(CHARACTER_ID_LINE_FEED)) >= 0 || this._text.indexOf(String.fromCharCode(CHARACTER_ID_CARRIAGE_RETURN)) >= 0)
			{
				return this._text;
			}

			var font:BitmapFont = this._currentTextFormat.font;
			var customSize:Number = this._currentTextFormat.size;
			var customLetterSpacing:Number = this._currentTextFormat.letterSpacing;
			var isKerningEnabled:Boolean = this._currentTextFormat.isKerningEnabled;
			var scale:Number = customSize / font.size;
			if(scale !== scale) //isNaN
			{
				scale = 1;
			}
			var currentX:Number = 0;
			var previousCharID:Number = NaN;
			var charCount:int = this._text.length;
			var truncationIndex:int = -1;
			for(var i:int = 0; i < charCount; i++)
			{
				var charID:int = this._text.charCodeAt(i);
				var charData:BitmapChar = font.getChar(charID);
				if(charData === null)
				{
					continue;
				}
				var currentKerning:Number = 0;
				if(isKerningEnabled &&
					previousCharID === previousCharID) //!isNaN
				{
					currentKerning = charData.getKerning(previousCharID) * scale;
				}
				var charWidth:Number = charData.width * scale;
				//add only the width of the character and not the xAdvance
				//because the final character doesn't have whitespace after it
				currentX += currentKerning + charWidth;
				if(currentX > width)
				{
					//floating point errors can cause unnecessary truncation,
					//so we're going to be a little bit fuzzy on the greater
					//than check. such tiny numbers shouldn't break anything.
					var difference:Number = Math.abs(currentX - width);
					if(difference > FUZZY_MAX_WIDTH_PADDING)
					{
						truncationIndex = i;
						//add the extra whitespace back to the end because we'll
						//be appending the truncation text (...)
						currentX += (charData.xAdvance * scale) - charWidth;
						break;
					}
				}
				//add the extra whitespace to the end for the next character
				currentX += customLetterSpacing + (charData.xAdvance * scale) - charWidth;
				previousCharID = charID;
			}

			if(truncationIndex >= 0)
			{
				//first add the width of the truncation text (...)
				charCount = this._truncationText.length;
				for(i = 0; i < charCount; i++)
				{
					charID = this._truncationText.charCodeAt(i);
					charData = font.getChar(charID);
					if(charData === null)
					{
						continue;
					}
					currentKerning = 0;
					if(isKerningEnabled &&
						previousCharID === previousCharID) //!isNaN
					{
						currentKerning = charData.getKerning(previousCharID) * scale;
					}
					currentX += currentKerning + charData.xAdvance * scale + customLetterSpacing;
					previousCharID = charID;
				}
				currentX -= customLetterSpacing;
				if(charData !== null)
				{
					currentX -= (charData.xAdvance - charData.width) * scale;
				}

				//then work our way backwards until we fit into the width
				for(i = truncationIndex; i >= 0; i--)
				{
					charID = this._text.charCodeAt(i);
					previousCharID = (i > 0) ? this._text.charCodeAt(i - 1) : NaN;
					charData = font.getChar(charID);
					if(charData === null)
					{
						continue;
					}
					currentKerning = 0;
					if(isKerningEnabled &&
						previousCharID === previousCharID) //!isNaN
					{
						currentKerning = charData.getKerning(previousCharID) * scale;
					}
					currentX -= (currentKerning + charData.xAdvance * scale + customLetterSpacing);
					if(currentX <= width)
					{
						return this._text.substr(0, i) + this._truncationText;
					}
				}
				return this._truncationText;
			}
			return this._text;
		}

		/**
		 * @private
		 */
		protected function getVerticalAlignOffsetY():Number
		{
			var font:BitmapFont = this._currentTextFormat.font;
			var customSize:Number = this._currentTextFormat.size;
			var scale:Number = customSize / font.size;
			if(scale !== scale) //isNaN
			{
				scale = 1;
			}
			var lineHeight:Number = font.lineHeight * scale + this._currentTextFormat.leading;
			var textHeight:Number = this._numLines * lineHeight;
			if(textHeight > this.actualHeight)
			{
				return 0;
			}
			if(this._currentVerticalAlign === Align.BOTTOM)
			{
				return (this.actualHeight - textHeight);
			}
			else if(this._currentVerticalAlign === Align.CENTER)
			{
				return (this.actualHeight - textHeight) / 2;
			}
			return 0;
		}
	}
}

import starling.text.BitmapChar;

class CharLocation
{
	public function CharLocation()
	{

	}

	public var char:BitmapChar;
	public var scale:Number;
	public var x:Number;
	public var y:Number;
}


================================================
FILE: source/feathers/controls/text/ITextEditorViewPort.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.text
{
	import feathers.controls.supportClasses.IViewPort;
	import feathers.core.ITextEditor;

	/**
	 * Handles the editing of multiline text.
	 *
	 * @see feathers.controls.TextArea
	 *
	 * @productversion Feathers 1.1.0
	 */
	public interface ITextEditorViewPort extends ITextEditor, IViewPort
	{
		/**
		 * The padding between the top edge of the viewport and the text.
		 */
		function get paddingTop():Number;

		/**
		 * @private
		 */
		function set paddingTop(value:Number):void;

		/**
		 * The padding between the right edge of the viewport and the text.
		 */
		function get paddingRight():Number;

		/**
		 * @private
		 */
		function set paddingRight(value:Number):void;

		/**
		 * The padding between the bottom edge of the viewport and the text.
		 */
		function get paddingBottom():Number;

		/**
		 * @private
		 */
		function set paddingBottom(value:Number):void;

		/**
		 * The padding between the left edge of the viewport and the text.
		 */
		function get paddingLeft():Number;

		/**
		 * @private
		 */
		function set paddingLeft(value:Number):void;
	}
}


================================================
FILE: source/feathers/controls/text/MeasureTextResult.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.text
{
	/**
	 * The result of text measurement.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class MeasureTextResult
	{
		/**
		 * Constructor.
		 */
		public function MeasureTextResult(width:Number = 0, height:Number = 0,
			isTruncated:Boolean = false)
		{
			this.width = width;
			this.height = height;
			this.isTruncated = isTruncated;
		}

		/**
		 * The measured width of the text.
		 */
		public var width:Number;

		/**
		 * The measured height of the text.
		 */
		public var height:Number;

		/**
		 * Indicates if the text needed to be truncated.
		 */
		public var isTruncated:Boolean;
	}
}


================================================
FILE: source/feathers/controls/text/StageTextTextEditor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.text
{
	import feathers.core.BaseTextEditor;
	import feathers.core.FocusManager;
	import feathers.core.IFocusDisplayObject;
	import feathers.core.IMultilineTextEditor;
	import feathers.core.INativeFocusOwner;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;
	import feathers.system.DeviceCapabilities;
	import feathers.text.StageTextField;
	import feathers.utils.display.nativeToGlobal;
	import feathers.utils.geom.matrixToScaleX;
	import feathers.utils.geom.matrixToScaleY;

	import flash.display.BitmapData;
	import flash.display.Stage;
	import flash.events.Event;
	import flash.events.FocusEvent;
	import flash.events.KeyboardEvent;
	import flash.events.SoftKeyboardEvent;
	import flash.geom.Matrix;
	import flash.geom.Matrix3D;
	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.geom.Vector3D;
	import flash.system.Capabilities;
	import flash.text.TextField;
	import flash.text.TextFieldAutoSize;
	import flash.text.TextFormat;
	import flash.text.TextFormatAlign;
	import flash.text.engine.FontPosture;
	import flash.text.engine.FontWeight;
	import flash.ui.KeyLocation;
	import flash.ui.Keyboard;
	import flash.utils.getDefinitionByName;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Image;
	import starling.events.Event;
	import starling.rendering.Painter;
	import starling.text.TextFormat;
	import starling.textures.ConcreteTexture;
	import starling.textures.Texture;
	import starling.utils.Align;
	import starling.utils.MatrixUtil;
	import starling.utils.Pool;
	import starling.utils.SystemUtil;

	/**
	 * Dispatched when the text property changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #text
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the user presses the Enter key while the editor has
	 * focus. This event may not be dispatched on some platforms, depending on
	 * the value of <code>returnKeyLabel</code>. This issue may even occur when
	 * using the <em>default value</em> of <code>returnKeyLabel</code>!
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #returnKeyLabel
	 *
	 * @eventType feathers.events.FeathersEventType.ENTER
	 */
	[Event(name="enter",type="starling.events.Event")]

	/**
	 * Dispatched when the text editor receives focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_IN
	 */
	[Event(name="focusIn",type="starling.events.Event")]

	/**
	 * Dispatched when the text editor loses focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_OUT
	 */
	[Event(name="focusOut",type="starling.events.Event")]

	/**
	 * Dispatched when the soft keyboard is about to activate. Not all text
	 * editors will activate a soft keyboard.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.SOFT_KEYBOARD_ACTIVATING
	 */
	[Event(name="softKeyboardActivating",type="starling.events.Event")]

	/**
	 * Dispatched when the soft keyboard is activated. Not all text editors will
	 * activate a soft keyboard.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.SOFT_KEYBOARD_ACTIVATE
	 */
	[Event(name="softKeyboardActivate",type="starling.events.Event")]

	/**
	 * Dispatched when the soft keyboard is deactivated. Not all text editors
	 * will activate a soft keyboard.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.SOFT_KEYBOARD_DEACTIVATE
	 */
	[Event(name="softKeyboardDeactivate",type="starling.events.Event")]

	/**
	 * Text that may be edited at runtime by the user with the
	 * <code>TextInput</code> component, rendered with the native
	 * <code>flash.text.StageText</code> class in Adobe AIR and the custom
	 * <code>feathers.text.StageTextField</code> class in Adobe Flash Player
	 * (<code>StageTextField</code> simulates <code>StageText</code> using
	 * <code>flash.text.TextField</code>). When not in focus, the
	 * <code>StageText</code> (or <code>StageTextField</code>) is drawn to
	 * <code>BitmapData</code> and uploaded to a texture on the GPU. Textures
	 * are managed internally by this component, and they will be automatically
	 * disposed when the component is disposed.
	 *
	 * <p>The following example shows how to use
	 * <code>StageTextTextEditor</code> with a <code>TextInput</code>:</p>
	 *
	 * <listing version="3.0">
	 * var input:TextInput = new TextInput();
	 * input.textEditorFactory = function():ITextEditor
	 * {
	 *     return new StageTextTextEditor();
	 * };
	 * this.addChild( input );</listing>
	 *
	 * @see feathers.controls.TextInput
	 * @see ../../../../help/text-editors.html Introduction to Feathers text editors
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html flash.text.StageText
	 * @see feathers.text.StageTextField
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class StageTextTextEditor extends BaseTextEditor implements IMultilineTextEditor, INativeFocusOwner
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>StageTextTextEditor</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 * The minimum position of the StageText view port. A runtime will be
		 * thrown if the x or y position is smaller than this value.
		 */
		protected static const MIN_VIEW_PORT_POSITION:Number = -8192;

		/**
		 * @private
		 * The maximum position of the StageText view port. A runtime will be
		 * thrown if the x or y position (including width and height) is larger
		 * than this value.
		 */
		protected static const MAX_VIEW_PORT_POSITION:Number = 8191;

		/**
		 * Constructor.
		 */
		public function StageTextTextEditor()
		{
			this._stageTextIsTextField = /^(Windows|Mac OS|Linux) .*/.exec(Capabilities.os) ||
				(Capabilities.playerType === "Desktop" && Capabilities.isDebugger);
			this.isQuickHitAreaEnabled = true;
			this.addEventListener(starling.events.Event.REMOVED_FROM_STAGE, textEditor_removedFromStageHandler);
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return globalStyleProvider;
		}

		/**
		 * The StageText instance. It's typed Object so that a replacement class
		 * can be used in browser-based Flash Player.
		 */
		protected var stageText:Object;

		/**
		 * @copy feathers.core.INativeFocusOwner#nativeFocus
		 */
		public function get nativeFocus():Object
		{
			if(!this._isEditable)
			{
				//assignFocus() doesn't work if StageText's editable property
				//is false, so we'll just let the FocusManager take care of it
				return null;
			}
			return this.stageText;
		}

		/**
		 * An image that displays a snapshot of the native <code>StageText</code>
		 * in the Starling display list when the editor doesn't have focus.
		 */
		protected var textSnapshot:Image;

		/**
		 * @private
		 */
		protected var _needsNewTexture:Boolean = false;

		/**
		 * @private
		 */
		protected var _needsTextureUpdate:Boolean = false;

		/**
		 * @private
		 */
		protected var _ignoreStageTextChanges:Boolean = false;

		/**
		 * @private
		 */
		protected var _measureTextField:TextField;

		/**
		 * @private
		 * This flag tells us if StageText is implemented by a TextField under
		 * the hood. We want to eliminate that damn TextField gutter to improve
		 * consistency across platforms.
		 */
		protected var _stageTextIsTextField:Boolean = false;

		/**
		 * @private
		 */
		protected var _stageTextHasFocus:Boolean = false;

		/**
		 * @private
		 */
		protected var _isWaitingToSetFocus:Boolean = false;

		/**
		 * @private
		 */
		protected var _pendingSelectionBeginIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get selectionBeginIndex():int
		{
			if(this._pendingSelectionBeginIndex >= 0)
			{
				return this._pendingSelectionBeginIndex;
			}
			if(this.stageText)
			{
				return this.stageText.selectionAnchorIndex;
			}
			return 0;
		}

		/**
		 * @private
		 */
		protected var _pendingSelectionEndIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get selectionEndIndex():int
		{
			if(this._pendingSelectionEndIndex >= 0)
			{
				return this._pendingSelectionEndIndex;
			}
			if(this.stageText)
			{
				return this.stageText.selectionActiveIndex;
			}
			return 0;
		}

		/**
		 * @private
		 */
		protected var _stageTextIsComplete:Boolean = false;

		/**
		 * @inheritDoc
		 */
		public function get baseline():Number
		{
			if(!this._measureTextField)
			{
				return 0;
			}
			return this._measureTextField.getLineMetrics(0).ascent;
		}

		/**
		 * @private
		 */
		protected var _autoCapitalize:String = "none";

		/**
		 * Controls how a device applies auto capitalization to user input. This
		 * property is only a hint to the underlying platform, because not all
		 * devices and operating systems support this functionality.
		 *
		 * <p>In the following example, the auto capitalize behavior is changed:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.autoCapitalize = AutoCapitalize.WORD;</listing>
		 *
		 * @default flash.text.AutoCapitalize.NONE
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#autoCapitalize Full description of flash.text.StageText.autoCapitalize in Adobe's Flash Platform API Reference
		 */
		public function get autoCapitalize():String
		{
			return this._autoCapitalize;
		}

		/**
		 * @private
		 */
		public function set autoCapitalize(value:String):void
		{
			if(this._autoCapitalize == value)
			{
				return;
			}
			this._autoCapitalize = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _autoCorrect:Boolean = false;

		/**
		 * Indicates whether a device auto-corrects user input for spelling or
		 * punctuation mistakes. This property is only a hint to the underlying
		 * platform, because not all devices and operating systems support this
		 * functionality.
		 *
		 * <p>In the following example, auto correct is enabled:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.autoCorrect = true;</listing>
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#autoCorrect Full description of flash.text.StageText.autoCorrect in Adobe's Flash Platform API Reference
		 */
		public function get autoCorrect():Boolean
		{
			return this._autoCorrect;
		}

		/**
		 * @private
		 */
		public function set autoCorrect(value:Boolean):void
		{
			if(this._autoCorrect == value)
			{
				return;
			}
			this._autoCorrect = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _color:uint = uint.MAX_VALUE;

		/**
		 * Specifies text color as a number containing three 8-bit RGB
		 * components.
		 *
		 * <p>In the following example, the text color is changed:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.color = 0xff9900;</listing>
		 *
		 * @default 0x000000
		 *
		 * @see #disabledColor
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#color Full description of flash.text.StageText.color in Adobe's Flash Platform API Reference
		 */
		public function get color():uint
		{
			return this._color;
		}

		/**
		 * @private
		 */
		public function set color(value:uint):void
		{
			if(this._color == value)
			{
				return;
			}
			this._color = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _disabledColor:uint = uint.MAX_VALUE;

		/**
		 * Specifies text color when the component is disabled as a number
		 * containing three 8-bit RGB components.
		 *
		 * <p>In the following example, the text color is changed:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.isEnabled = false;
		 * textEditor.disabledColor = 0xff9900;</listing>
		 *
		 * @default 0x999999
		 *
		 * @see #disabledColor
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#color Full description of flash.text.StageText.color in Adobe's Flash Platform API Reference
		 */
		public function get disabledColor():uint
		{
			return this._disabledColor;
		}

		/**
		 * @private
		 */
		public function set disabledColor(value:uint):void
		{
			if(this._disabledColor == value)
			{
				return;
			}
			this._disabledColor = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _displayAsPassword:Boolean = false;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#displayAsPassword
		 *
		 * @see feathers.controls.TextInput#displayAsPassword
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#displayAsPassword Full description of flash.text.StageText.displayAsPassword in Adobe's Flash Platform API Reference
		 */
		public function get displayAsPassword():Boolean
		{
			return this._displayAsPassword;
		}

		/**
		 * @private
		 */
		public function set displayAsPassword(value:Boolean):void
		{
			if(this._displayAsPassword == value)
			{
				return;
			}
			this._displayAsPassword = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isEditable:Boolean = true;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#isEditable
		 *
		 * @see feathers.controls.TextInput#isEditable
		 */
		public function get isEditable():Boolean
		{
			return this._isEditable;
		}

		/**
		 * @private
		 */
		public function set isEditable(value:Boolean):void
		{
			if(this._isEditable == value)
			{
				return;
			}
			this._isEditable = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isSelectable:Boolean = true;

		/**
		 * <p><strong>Warning:</strong> This property is ignored because
		 * <code>flash.text.StageText</code> does not support selectable text
		 * that is not editable.</p>
		 *
		 * @copy feathers.controls.TextInput#isSelectable
		 *
		 * @see feathers.controls.TextInput#isSelectable
		 */
		public function get isSelectable():Boolean
		{
			return this._isSelectable;
		}

		/**
		 * @private
		 */
		public function set isSelectable(value:Boolean):void
		{
			if(this._isSelectable == value)
			{
				return;
			}
			this._isSelectable = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @inheritDoc
		 *
		 * @default true
		 */
		public function get setTouchFocusOnEndedPhase():Boolean
		{
			return true;
		}

		/**
		 * @private
		 */
		protected var _fontFamily:String = null;

		/**
		 * Indicates the name of the current font family. A value of null
		 * indicates the system default.
		 *
		 * <p>In the following example, the font family is changed:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.fontFamily = "Source Sans Pro";</listing>
		 *
		 * @default null
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#fontFamily Full description of flash.text.StageText.fontFamily in Adobe's Flash Platform API Reference
		 */
		public function get fontFamily():String
		{
			return this._fontFamily;
		}

		/**
		 * @private
		 */
		public function set fontFamily(value:String):void
		{
			if(this._fontFamily == value)
			{
				return;
			}
			this._fontFamily = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _fontPosture:String;

		/**
		 * Specifies the font posture, using constants defined in the
		 * <code>flash.text.engine.FontPosture</code> class.
		 *
		 * <p>In the following example, the font posture is changed:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.fontPosture = FontPosture.ITALIC;</listing>
		 *
		 * @default flash.text.engine.FontPosture.NORMAL
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#fontPosture Full description of flash.text.StageText.fontPosture in Adobe's Flash Platform API Reference
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/FontPosture.html flash.text.engine.FontPosture
		 */
		public function get fontPosture():String
		{
			return this._fontPosture;
		}

		/**
		 * @private
		 */
		public function set fontPosture(value:String):void
		{
			if(this._fontPosture == value)
			{
				return;
			}
			this._fontPosture = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _fontSize:int = 0;

		/**
		 * The size in pixels for the current font family.
		 *
		 * <p>In the following example, the font size is increased to 16 pixels:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.fontSize = 16;</listing>
		 *
		 * @default 12
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#fontSize Full description of flash.text.StageText.fontSize in Adobe's Flash Platform API Reference
		 */
		public function get fontSize():int
		{
			return this._fontSize;
		}

		/**
		 * @private
		 */
		public function set fontSize(value:int):void
		{
			if(this._fontSize == value)
			{
				return;
			}
			this._fontSize = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _fontWeight:String = null;

		/**
		 * Specifies the font weight, using constants defined in the
		 * <code>flash.text.engine.FontWeight</code> class.
		 *
		 * <p>In the following example, the font weight is changed to bold:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.fontWeight = FontWeight.BOLD;</listing>
		 *
		 * @default flash.text.engine.FontWeight.NORMAL
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#fontWeight Full description of flash.text.StageText.fontWeight in Adobe's Flash Platform API Reference
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/FontWeight.html flash.text.engine.FontWeight
		 */
		public function get fontWeight():String
		{
			return this._fontWeight;
		}

		/**
		 * @private
		 */
		public function set fontWeight(value:String):void
		{
			if(this._fontWeight == value)
			{
				return;
			}
			this._fontWeight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _locale:String = "en";

		/**
		 * Indicates the locale of the text. <code>StageText</code> uses the
		 * standard locale identifiers. For example <code>"en"</code>,
		 * <code>"en_US"</code> and <code>"en-US"</code> are all English.
		 *
		 * <p>In the following example, the locale is changed to Russian:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.locale = "ru";</listing>
		 *
		 * @default "en"
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#locale Full description of flash.text.StageText.locale in Adobe's Flash Platform API Reference
		 */
		public function get locale():String
		{
			return this._locale;
		}

		/**
		 * @private
		 */
		public function set locale(value:String):void
		{
			if(this._locale == value)
			{
				return;
			}
			this._locale = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _maxChars:int = 0;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#maxChars
		 *
		 * @see feathers.controls.TextInput#maxChars
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#maxChars Full description of flash.text.StageText.maxChars in Adobe's Flash Platform API Reference
		 */
		public function get maxChars():int
		{
			return this._maxChars;
		}

		/**
		 * @private
		 */
		public function set maxChars(value:int):void
		{
			if(this._maxChars == value)
			{
				return;
			}
			this._maxChars = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _multiline:Boolean = false;

		/**
		 * Indicates whether the StageText object can display more than one line
		 * of text. This property is configurable after the text editor is
		 * created, unlike a regular <code>StageText</code> instance. The text
		 * editor will dispose and recreate its internal <code>StageText</code>
		 * instance if the value of the <code>multiline</code> property is
		 * changed after the <code>StageText</code> is initially created.
		 *
		 * <p>In the following example, multiline is enabled:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.multiline = true;</listing>
		 *
		 * When setting this property to <code>true</code>, it is recommended
		 * that the text input's <code>verticalAlign</code> property is set to
		 * <code>VerticalAlign.JUSTIFY</code>.
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#multiline Full description of flash.text.StageText.multiline in Adobe's Flash Platform API Reference
		 */
		public function get multiline():Boolean
		{
			return this._multiline;
		}

		/**
		 * @private
		 */
		public function set multiline(value:Boolean):void
		{
			if(this._multiline == value)
			{
				return;
			}
			this._multiline = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _restrict:String;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#restrict
		 *
		 * @see feathers.controls.TextInput#restrict
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#restrict Full description of flash.text.StageText.restrict in Adobe's Flash Platform API Reference
		 */
		public function get restrict():String
		{
			return this._restrict;
		}

		/**
		 * @private
		 */
		public function set restrict(value:String):void
		{
			if(this._restrict == value)
			{
				return;
			}
			this._restrict = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _returnKeyLabel:String = "default";

		/**
		 * Indicates the label on the Return key for devices that feature a soft
		 * keyboard. The available values are constants defined in the
		 * <code>flash.text.ReturnKeyLabel</code> class. This property is only a
		 * hint to the underlying platform, because not all devices and
		 * operating systems support this functionality.
		 *
		 * <p>In the following example, the return key label is changed:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.returnKeyLabel = ReturnKeyLabel.GO;</listing>
		 *
		 * @default flash.text.ReturnKeyLabel.DEFAULT
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#returnKeyLabel Full description of flash.text.StageText.returnKeyLabel in Adobe's Flash Platform API Reference
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/ReturnKeyLabel.html flash.text.ReturnKeyLabel
		 */
		public function get returnKeyLabel():String
		{
			return this._returnKeyLabel;
		}

		/**
		 * @private
		 */
		public function set returnKeyLabel(value:String):void
		{
			if(this._returnKeyLabel == value)
			{
				return;
			}
			this._returnKeyLabel = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _softKeyboardType:String = "default";

		/**
		 * Controls the appearance of the soft keyboard. Valid values are
		 * defined as constants in the <code>flash.text.SoftKeyboardType</code>
		 * class. This property is only a hint to the underlying platform,
		 * because not all devices and operating systems support this
		 * functionality.
		 *
		 * <p>In the following example, the soft keyboard type is changed:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.softKeyboardType = SoftKeyboardType.NUMBER;</listing>
		 *
		 * @default flash.text.SoftKeyboardType.DEFAULT
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#softKeyboardType Full description of flash.text.StageText.softKeyboardType in Adobe's Flash Platform API Reference
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/SoftKeyboardType.html flash.text.SoftKeyboardType
		 */
		public function get softKeyboardType():String
		{
			return this._softKeyboardType;
		}

		/**
		 * @private
		 */
		public function set softKeyboardType(value:String):void
		{
			if(this._softKeyboardType == value)
			{
				return;
			}
			this._softKeyboardType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _textAlign:String;

		/**
		 * Indicates the paragraph alignment. Valid values are defined as
		 * constants in the <code>flash.text.TextFormatAlign</code> class.
		 *
		 * <p>In the following example, the text is centered:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.textAlign = TextFormatAlign.CENTER;</listing>
		 *
		 * @default flash.text.TextFormatAlign.START
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#textAlign Full description of flash.text.StageText.textAlign in Adobe's Flash Platform API Reference
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextFormatAlign.html flash.text.TextFormatAlign
		 */
		public function get textAlign():String
		{
			return this._textAlign;
		}

		/**
		 * @private
		 */
		public function set textAlign(value:String):void
		{
			if(this._textAlign == value)
			{
				return;
			}
			this._textAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _maintainTouchFocus:Boolean = false;

		/**
		 * If enabled, the text editor will remain in focus, even if something
		 * else is touched.
		 *
		 * <p>Note: If the <code>FocusManager</code> is enabled, this property
		 * will be ignored.</p>
		 *
		 * <p>In the following example, touch focus is maintained:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.maintainTouchFocus = true;</listing>
		 *
		 * @default false
		 */
		override public function get maintainTouchFocus():Boolean
		{
			return this._maintainTouchFocus;
		}

		/**
		 * @private
		 */
		public function set maintainTouchFocus(value:Boolean):void
		{
			this._maintainTouchFocus = value;
		}

		/**
		 * @private
		 */
		protected var _lastGlobalScaleX:Number = 0;

		/**
		 * @private
		 */
		protected var _lastGlobalScaleY:Number = 0;

		/**
		 * @private
		 */
		protected var _updateSnapshotOnScaleChange:Boolean = false;

		/**
		 * Refreshes the texture snapshot every time that the text editor is
		 * scaled. Based on the scale in global coordinates, so scaling the
		 * parent will require a new snapshot.
		 *
		 * <p>Warning: setting this property to true may result in reduced
		 * performance because every change of the scale requires uploading a
		 * new texture to the GPU. Use with caution. Consider setting this
		 * property to false temporarily during animations that modify the
		 * scale.</p>
		 *
		 * <p>In the following example, the snapshot will be updated when the
		 * text editor is scaled:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.updateSnapshotOnScaleChange = true;</listing>
		 *
		 * @default false
		 */
		public function get updateSnapshotOnScaleChange():Boolean
		{
			return this._updateSnapshotOnScaleChange;
		}

		/**
		 * @private
		 */
		public function set updateSnapshotOnScaleChange(value:Boolean):void
		{
			if(this._updateSnapshotOnScaleChange == value)
			{
				return;
			}
			this._updateSnapshotOnScaleChange = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 * The default value doesn't use the constant because it's available in
		 * AIR only, and not Flash Player.
		 */
		protected var _clearButtonMode:String = "whileEditing";

		/**
		 * Determines when the clear button is displayed or hidden by the
		 * <code>StageText</code> object.
		 *
		 * <p>In the following example, the clear button is always hidden:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.clearButtonMode = StageTextClearButtonMode.NEVER;</listing>
		 *
		 * <p>Requires <code>-swf-version=34</code> or newer.</p>
		 *
		 * @default flash.text.StageTextClearButtonMode.WHILE_EDITING
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageText.html#clearButtonMode Full description of flash.text.StageText.clearButtonMode in Adobe's Flash Platform API Reference
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StageTextClearButtonMode.html Full description of flash.text.StageTextClearButtonMode in Adobe's Flash Platform API Reference
		 */
		public function get clearButtonMode():String
		{
			return this._clearButtonMode;
		}

		/**
		 * @private
		 */
		public function set clearButtonMode(value:String):void
		{
			if(this._clearButtonMode == value)
			{
				return;
			}
			this._clearButtonMode = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this._measureTextField !== null)
			{
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				starling.nativeStage.removeChild(this._measureTextField);
				this._measureTextField = null;
			}

			if(this.stageText)
			{
				this.disposeStageText();
			}

			if(this.textSnapshot)
			{
				//avoid the need to call dispose(). we'll create a new snapshot
				//when the renderer is added to stage again.
				this.textSnapshot.texture.dispose();
				this.removeChild(this.textSnapshot, true);
				this.textSnapshot = null;
			}

			super.dispose();
		}

		/**
		 * @private
		 */
		override public function render(painter:Painter):void
		{
			if(this._stageTextHasFocus)
			{
				painter.excludeFromCache(this);
			}
			if(this.textSnapshot !== null && this._updateSnapshotOnScaleChange)
			{
				var matrix:Matrix = Pool.getMatrix();
				this.getTransformationMatrix(this.stage, matrix);
				if(matrixToScaleX(matrix) != this._lastGlobalScaleX ||
					matrixToScaleY(matrix) != this._lastGlobalScaleY)
				{
					//the snapshot needs to be updated because the scale has
					//changed since the last snapshot was taken.
					this.invalidate(INVALIDATION_FLAG_SIZE);
					this.validate();
				}
				Pool.putMatrix(matrix);
			}
			if(this._needsTextureUpdate)
			{
				this._needsTextureUpdate = false;
				var hasText:Boolean = this._text.length > 0;
				if(hasText)
				{
					this.refreshSnapshot();
				}
				if(this.textSnapshot)
				{
					this.textSnapshot.visible = !this._stageTextHasFocus;
					this.textSnapshot.alpha = hasText ? 1 : 0;
				}
				if(!this._stageTextHasFocus)
				{
					//hide the StageText after the snapshot is created
					//native controls don't necessarily render at the same time
					//as starling, and we don't want to see the text disappear
					//for a moment
					this.stageText.visible = false;
				}
			}

			//we'll skip this if the text field isn't visible to avoid running
			//that code every frame.
			if(this.stageText !== null && this.stageText.visible)
			{
				this.refreshViewPortAndFontSize();
			}

			if(this.textSnapshot)
			{
				this.positionSnapshot();
			}

			super.render(painter);
		}

		/**
		 * @inheritDoc
		 */
		public function setFocus(position:Point = null):void
		{
			//setting the editable property of a StageText to false seems to be
			//ignored on Android, so this is the workaround
			if(!this._isEditable && SystemUtil.platform === "AND")
			{
				return;
			}
			if(!this._isEditable && !this._isSelectable)
			{
				return;
			}
			if(this.stage !== null && this.stageText.stage === null)
			{
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				this.stageText.stage = starling.nativeStage;
			}
			if(this.stageText && this._stageTextIsComplete)
			{
				if(position)
				{
					var positionX:Number = position.x + 2;
					var positionY:Number = position.y + 2;
					if(positionX < 0)
					{
						this._pendingSelectionBeginIndex = this._pendingSelectionEndIndex = 0;
					}
					else
					{
						this._pendingSelectionBeginIndex = this._measureTextField.getCharIndexAtPoint(positionX, positionY);
						if(this._pendingSelectionBeginIndex < 0)
						{
							if(this._multiline)
							{
								var lineIndex:int = int(positionY / this._measureTextField.getLineMetrics(0).height);
								try
								{
									this._pendingSelectionBeginIndex = this._measureTextField.getLineOffset(lineIndex) + this._measureTextField.getLineLength(lineIndex);
									if(this._pendingSelectionBeginIndex != this._text.length)
									{
										this._pendingSelectionBeginIndex--;
									}
								}
								catch(error:Error)
								{
									//we may be checking for a line beyond the
									//end that doesn't exist
									this._pendingSelectionBeginIndex = this._text.length;
								}
							}
							else
							{
								this._pendingSelectionBeginIndex = this._measureTextField.getCharIndexAtPoint(positionX, this._measureTextField.getLineMetrics(0).ascent / 2);
								if(this._pendingSelectionBeginIndex < 0)
								{
									this._pendingSelectionBeginIndex = this._text.length;
								}
							}
						}
						else
						{
							var bounds:Rectangle = this._measureTextField.getCharBoundaries(this._pendingSelectionBeginIndex);
							var boundsX:Number = bounds.x;
							if(bounds && (boundsX + bounds.width - positionX) < (positionX - boundsX))
							{
								this._pendingSelectionBeginIndex++;
							}
						}
						this._pendingSelectionEndIndex = this._pendingSelectionBeginIndex;
					}
				}
				else
				{
					this._pendingSelectionBeginIndex = this._pendingSelectionEndIndex = -1;
				}
				this.stageText.visible = true;
				if(!this._isEditable)
				{
					//assignFocus() does not work unless the StageText's
					//editable property is true, but we want the text to be
					//selectable. as a workaround, we temporarily set editable
					//to true before calling assignFocus(). once the StageText
					//has focus, we'll set it back to false.
					this.stageText.editable = true;
				}
				if(!this._stageTextHasFocus)
				{
					//on iOS, calling assignFocus() when the StageText already
					//has focus seems to make it harder to change the selection
					//with a touch and hold gesture. the soft keyboard appears
					//to close and re-open on touch begin more often.
					this.stageText.assignFocus();
				}
			}
			else
			{
				this._isWaitingToSetFocus = true;
			}
		}

		/**
		 * @inheritDoc
		 */
		public function clearFocus():void
		{
			if(!this._stageTextHasFocus)
			{
				return;
			}
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			//setting the focus to Starling.current.nativeStage doesn't work
			//here, so we need to use null. on Android, if we give focus to the
			//nativeStage, focus will be removed from the StageText, but the
			//soft keyboard will incorrectly remain open.
			starling.nativeStage.focus = null;
			if(!this.isParentChainVisible())
			{
				//this normally happens in render(), but if we're not visible,
				//we need to hide the StageText manually.
				this.stageText.visible = false;
			}
		}

		/**
		 * @inheritDoc
		 */
		public function selectRange(beginIndex:int, endIndex:int):void
		{
			if(this._stageTextIsComplete && this.stageText)
			{
				this._pendingSelectionBeginIndex = -1;
				this._pendingSelectionEndIndex = -1;
				this.stageText.selectRange(beginIndex, endIndex);
			}
			else
			{
				this._pendingSelectionBeginIndex = beginIndex;
				this._pendingSelectionEndIndex = endIndex;
			}
		}

		/**
		 * @inheritDoc
		 */
		public function measureText(result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}

			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			if(!needsWidth && !needsHeight)
			{
				result.x = this._explicitWidth;
				result.y = this._explicitHeight;
				return result;
			}

			//if a parent component validates before we're added to the stage,
			//measureText() may be called before initialization, so we need to
			//force it.
			if(!this._isInitialized)
			{
				this.initializeNow();
			}

			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);

			if(stylesInvalid || dataInvalid)
			{
				this.refreshMeasureProperties();
			}

			result = this.measure(result);

			return result;
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			if(this._measureTextField !== null && this._measureTextField.parent === null)
			{
				starling.nativeStage.addChild(this._measureTextField);
			}
			else if(!this._measureTextField)
			{
				this._measureTextField = new TextField();
				this._measureTextField.visible = false;
				this._measureTextField.mouseEnabled = this._measureTextField.mouseWheelEnabled = false;
				this._measureTextField.autoSize = TextFieldAutoSize.LEFT;
				this._measureTextField.multiline = false;
				this._measureTextField.wordWrap = false;
				this._measureTextField.embedFonts = false;
				this._measureTextField.defaultTextFormat = new flash.text.TextFormat(null, 11, 0x000000, false, false, false);
				starling.nativeStage.addChild(this._measureTextField);
			}

			this.createStageText();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);

			this.commit();

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			this.layout(sizeInvalid);
		}

		/**
		 * @private
		 */
		protected function commit():void
		{
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);

			if(stylesInvalid || dataInvalid)
			{
				this.refreshMeasureProperties();
			}

			var oldIgnoreStageTextChanges:Boolean = this._ignoreStageTextChanges;
			this._ignoreStageTextChanges = true;
			if(stateInvalid || stylesInvalid)
			{
				this.refreshStageTextProperties();
			}

			if(dataInvalid)
			{
				if(this.stageText.text != this._text)
				{
					if(this._pendingSelectionBeginIndex < 0)
					{
						this._pendingSelectionBeginIndex = this.stageText.selectionActiveIndex;
						this._pendingSelectionEndIndex = this.stageText.selectionAnchorIndex;
					}
					this.stageText.text = this._text;
				}
			}
			this._ignoreStageTextChanges = oldIgnoreStageTextChanges;

			if(stylesInvalid || stateInvalid)
			{
				this.stageText.editable = this._isEditable && this._isEnabled;
			}
		}

		/**
		 * @private
		 */
		protected function measure(result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}

			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN

			this._measureTextField.autoSize = TextFieldAutoSize.LEFT;

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				newWidth = this._measureTextField.textWidth;
				if(newWidth < this._explicitMinWidth)
				{
					newWidth = this._explicitMinWidth;
				}
				else if(newWidth > this._explicitMaxWidth)
				{
					newWidth = this._explicitMaxWidth;
				}
			}

			//the +4 is accounting for the TextField gutter
			this._measureTextField.width = newWidth + 4;
			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				if(this._stageTextIsTextField)
				{
					//we know that the StageText implementation is using
					//TextField internally, so textHeight will be accurate.
					newHeight = this._measureTextField.textHeight;
				}
				else
				{
					//since we're measuring with TextField, but rendering with
					//StageText, we're using height instead of textHeight here to be
					//sure that the measured size is on the larger side, in case the
					//rendered size is actually bigger than textHeight
					//if only StageText had an API for text measurement, we wouldn't
					//be in this mess...
					newHeight = this._measureTextField.height;
				}
				if(newHeight < this._explicitMinHeight)
				{
					newHeight = this._explicitMinHeight;
				}
				else if(newHeight > this._explicitMaxHeight)
				{
					newHeight = this._explicitMaxHeight;
				}
			}

			this._measureTextField.autoSize = TextFieldAutoSize.NONE;

			//put the width and height back just in case we measured without
			//a full validation
			//the +4 is accounting for the TextField gutter
			this._measureTextField.width = this.actualWidth + 4;
			this._measureTextField.height = this.actualHeight;

			result.x = newWidth;
			result.y = newHeight;

			return result;
		}

		/**
		 * @private
		 */
		protected function layout(sizeInvalid:Boolean):void
		{
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var skinInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SKIN);

			if(sizeInvalid || stylesInvalid || skinInvalid || stateInvalid)
			{
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				this.refreshViewPortAndFontSize();
				this.refreshMeasureTextFieldDimensions();
				var viewPort:Rectangle = this.stageText.viewPort;
				var textureRoot:ConcreteTexture = this.textSnapshot ? this.textSnapshot.texture.root : null;
				this._needsNewTexture = this._needsNewTexture || !this.textSnapshot ||
					(textureRoot !== null && (textureRoot.scale != starling.contentScaleFactor ||
					viewPort.width != textureRoot.nativeWidth || viewPort.height != textureRoot.nativeHeight));
			}

			if(!this._stageTextHasFocus && (stateInvalid || stylesInvalid || dataInvalid || sizeInvalid || this._needsNewTexture))
			{
				if(!this.isParentChainVisible())
				{
					//issue #1620
					//our parent has been hidden, so our render() method won't
					//be called, and we need to hide the StageText.
					this.stageText.visible = false;
				}
				//we're going to update the texture in render() because
				//there's a chance that it will be updated more than once per
				//frame if we do it here.
				this._needsTextureUpdate = true;
				this.setRequiresRedraw();
			}

			this.doPendingActions();
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			var point:Point = Pool.getPoint();
			this.measure(point);
			var result:Boolean = this.saveMeasurements(point.x, point.y, point.x, point.y);
			Pool.putPoint(point);
			return result;
		}

		/**
		 * @private
		 */
		protected function refreshMeasureProperties():void
		{
			this._measureTextField.displayAsPassword = this._displayAsPassword;
			this._measureTextField.maxChars = this._maxChars;
			this._measureTextField.restrict = this._restrict;
			this._measureTextField.multiline = this._multiline;
			this._measureTextField.wordWrap = this._multiline;
			var measureFormat:flash.text.TextFormat = this._measureTextField.defaultTextFormat;
			var fontStylesFormat:starling.text.TextFormat;
			if(this._fontStyles !== null)
			{
				fontStylesFormat = this._fontStyles.getTextFormatForTarget(this);
			}

			if(this._fontFamily !== null)
			{
				measureFormat.font = this._fontFamily;
			}
			else if(fontStylesFormat !== null)
			{
				measureFormat.font = fontStylesFormat.font;
			}
			else
			{
				measureFormat.font = null;
			}

			if(this._fontSize > 0)
			{
				measureFormat.size = this._fontSize;
			}
			else if(fontStylesFormat !== null)
			{
				measureFormat.size = fontStylesFormat.size;
			}
			else
			{
				measureFormat.size = 12;
			}

			if(this._fontWeight !== null)
			{
				measureFormat.bold = this._fontWeight === FontWeight.BOLD;
			}
			else if(fontStylesFormat !== null)
			{
				measureFormat.bold = fontStylesFormat.bold;
			}
			else
			{
				measureFormat.bold = false;
			}

			if(this._fontPosture !== null)
			{
				measureFormat.italic = this._fontPosture === FontPosture.ITALIC;
			}
			else if(fontStylesFormat !== null)
			{
				measureFormat.italic = fontStylesFormat.italic;
			}
			else
			{
				measureFormat.italic = false;
			}
			//color and alignment are ignored because they don't affect
			//measurement

			this._measureTextField.defaultTextFormat = measureFormat;
			this._measureTextField.setTextFormat(measureFormat);
			if(this._text.length == 0)
			{
				this._measureTextField.text = " ";
			}
			else
			{
				this._measureTextField.text = this._text;
			}
		}

		/**
		 * @private
		 */
		protected function refreshStageTextProperties():void
		{
			if(this.stageText.multiline != this._multiline)
			{
				if(this.stageText)
				{
					this.disposeStageText();
				}
				this.createStageText();
			}

			var textFormat:starling.text.TextFormat;
			if(this._fontStyles !== null)
			{
				textFormat = this._fontStyles.getTextFormatForTarget(this);
			}
			this.stageText.autoCapitalize = this._autoCapitalize;
			this.stageText.autoCorrect = this._autoCorrect;
			if(this._isEnabled)
			{
				if(this._color == uint.MAX_VALUE)
				{
					if(textFormat !== null)
					{
						this.stageText.color = textFormat.color;
					}
					else
					{
						this.stageText.color = 0x000000;
					}
				}
				else
				{
					this.stageText.color = this._color;
				}
			}
			else //disabled
			{
				if(this._disabledColor == uint.MAX_VALUE)
				{
					if(this._color == uint.MAX_VALUE)
					{
						if(textFormat !== null)
						{
							this.stageText.color = textFormat.color;
						}
						else
						{
							this.stageText.color = 0x000000;
						}
					}
					else
					{
						this.stageText.color = this._color;
					}
				}
				else
				{
					this.stageText.color = this._disabledColor;
				}
			}
			this.stageText.displayAsPassword = this._displayAsPassword;
			var fontFamily:String = this._fontFamily;
			if(fontFamily === null && textFormat !== null)
			{
				fontFamily = textFormat.font;
			} //default to null
			this.stageText.fontFamily = fontFamily;
			var fontPosture:String = this._fontPosture;
			if(fontPosture === null)
			{
				if(textFormat !== null && textFormat.italic)
				{
					fontPosture = FontPosture.ITALIC;
				}
				else
				{
					fontPosture = FontPosture.NORMAL;
				}
			}
			this.stageText.fontPosture = fontPosture;
			var fontWeight:String = this._fontWeight;
			if(fontWeight === null)
			{
				if(textFormat !== null && textFormat.bold)
				{
					fontWeight = FontWeight.BOLD;
				}
				else
				{
					fontWeight = FontWeight.NORMAL;
				}
			}
			this.stageText.fontWeight = fontWeight;
			this.stageText.locale = this._locale;
			this.stageText.maxChars = this._maxChars;
			this.stageText.restrict = this._restrict;
			this.stageText.returnKeyLabel = this._returnKeyLabel;
			this.stageText.softKeyboardType = this._softKeyboardType;
			var textAlign:String = this._textAlign;
			if(textAlign === null)
			{
				if(textFormat !== null && textFormat.horizontalAlign)
				{
					textAlign = textFormat.horizontalAlign;
				}
				else
				{
					textAlign = TextFormatAlign.START;
				}
			}
			this.stageText.textAlign = textAlign;
			if("clearButtonMode" in this.stageText)
			{
				this.stageText.clearButtonMode = this._clearButtonMode;
			}
		}

		/**
		 * @private
		 */
		protected function doPendingActions():void
		{
			if(this._isWaitingToSetFocus)
			{
				this._isWaitingToSetFocus = false;
				this.setFocus();
			}
			if(this._pendingSelectionBeginIndex >= 0)
			{
				var startIndex:int = this._pendingSelectionBeginIndex;
				var endIndex:int = (this._pendingSelectionEndIndex < 0) ? this._pendingSelectionBeginIndex : this._pendingSelectionEndIndex;
				this._pendingSelectionBeginIndex = -1;
				this._pendingSelectionEndIndex = -1;
				if(this.stageText.selectionAnchorIndex != startIndex || this.stageText.selectionActiveIndex != endIndex)
				{
					//if the same range is already selected, don't try to do it
					//again because on iOS, if the StageText is multiline, this
					//will cause the clipboard menu to appear when it shouldn't.
					this.selectRange(startIndex, endIndex);
				}
			}
		}

		/**
		 * @private
		 */
		protected function texture_onRestore():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			if(this.textSnapshot.texture.scale != starling.contentScaleFactor)
			{
				//if we've changed between scale factors, we need to recreate
				//the texture to match the new scale factor.
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this.refreshSnapshot();
				if(this.textSnapshot)
				{
					this.textSnapshot.visible = !this._stageTextHasFocus;
					this.textSnapshot.alpha = this._text.length > 0 ? 1 : 0;
				}
				if(!this._stageTextHasFocus)
				{
					this.stageText.visible = false;
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshSnapshot():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			//StageText's stage property cannot be null when we call
			//drawViewPortToBitmapData()
			if(this.stage !== null && this.stageText.stage === null)
			{
				this.stageText.stage = starling.nativeStage;
			}
			if(this.stageText.stage === null)
			{
				//we need to keep a flag active so that the snapshot will be
				//refreshed after the text editor is added to the stage
				this.invalidate(INVALIDATION_FLAG_DATA);
				return;
			}
			var viewPort:Rectangle = this.stageText.viewPort;
			if(viewPort.width == 0 || viewPort.height == 0)
			{
				return;
			}
			var nativeScaleFactor:Number = 1;
			if(starling.supportHighResolutions)
			{
				nativeScaleFactor = starling.nativeStage.contentsScaleFactor;
			}
			//StageText sucks because it requires that the BitmapData's width
			//and height exactly match its view port width and height.
			//(may be doubled on Retina Mac)
			try
			{
				var bitmapData:BitmapData = new BitmapData(viewPort.width * nativeScaleFactor, viewPort.height * nativeScaleFactor, true, 0x00ff00ff);
				this.stageText.drawViewPortToBitmapData(bitmapData);
			}
			catch(error:Error)
			{
				//drawing stage text to the bitmap data at double size may fail
				//on runtime versions less than 15, so fall back to using a
				//snapshot that is half size. it's not ideal, but better than
				//nothing.
				bitmapData.dispose();
				bitmapData = new BitmapData(viewPort.width, viewPort.height, true, 0x00ff00ff);
				this.stageText.drawViewPortToBitmapData(bitmapData);
			}

			var newTexture:Texture;
			if(!this.textSnapshot || this._needsNewTexture)
			{
				var scaleFactor:Number = starling.contentScaleFactor;
				//skip Texture.fromBitmapData() because we don't want
				//it to create an onRestore function that will be
				//immediately discarded for garbage collection.
				newTexture = Texture.empty(bitmapData.width / scaleFactor, bitmapData.height / scaleFactor,
					true, false, false, scaleFactor);
				newTexture.root.uploadBitmapData(bitmapData);
				newTexture.root.onRestore = texture_onRestore;
			}
			if(!this.textSnapshot)
			{
				this.textSnapshot = new Image(newTexture);
				this.textSnapshot.pixelSnapping = true;
				this.addChild(this.textSnapshot);
			}
			else
			{
				if(this._needsNewTexture)
				{
					this.textSnapshot.texture.dispose();
					this.textSnapshot.texture = newTexture;
					this.textSnapshot.readjustSize();
				}
				else
				{
					//this is faster, if we haven't resized the bitmapdata
					var existingTexture:Texture = this.textSnapshot.texture;
					existingTexture.root.uploadBitmapData(bitmapData);
					//however, the image won't be notified that its
					//texture has changed, so we need to do it manually
					this.textSnapshot.setRequiresRedraw();
				}
			}
			var matrix:Matrix = Pool.getMatrix();
			this.getTransformationMatrix(this.stage, matrix);
			var globalScaleX:Number = matrixToScaleX(matrix);
			var globalScaleY:Number = matrixToScaleY(matrix);
			Pool.putMatrix(matrix);
			if(this._updateSnapshotOnScaleChange)
			{
				this.textSnapshot.scaleX = 1 / globalScaleX;
				this.textSnapshot.scaleY = 1 / globalScaleY;
				this._lastGlobalScaleX = globalScaleX;
				this._lastGlobalScaleY = globalScaleY;
			}
			else
			{
				this.textSnapshot.scaleX = 1;
				this.textSnapshot.scaleY = 1;
			}
			if(nativeScaleFactor > 1 && bitmapData.width == viewPort.width)
			{
				//when we fall back to using a snapshot that is half size on
				//older runtimes, we need to scale it up.
				this.textSnapshot.scaleX *= nativeScaleFactor;
				this.textSnapshot.scaleY *= nativeScaleFactor;
			}
			bitmapData.dispose();
			this._needsNewTexture = false;
		}

		/**
		 * @private
		 */
		protected function refreshViewPortAndFontSize():void
		{
			var matrix:Matrix = Pool.getMatrix();
			var point:Point = Pool.getPoint();
			var desktopGutterPositionOffset:Number = 0;
			var desktopGutterDimensionsOffset:Number = 0;
			if(this._stageTextIsTextField)
			{
				desktopGutterPositionOffset = 2;
				desktopGutterDimensionsOffset = 4;
			}
			this.getTransformationMatrix(this.stage, matrix);
			if(this._stageTextHasFocus || this._updateSnapshotOnScaleChange)
			{
				var globalScaleX:Number = matrixToScaleX(matrix);
				var globalScaleY:Number = matrixToScaleY(matrix);
				var smallerGlobalScale:Number = globalScaleX;
				if(globalScaleY < smallerGlobalScale)
				{
					smallerGlobalScale = globalScaleY;
				}
			}
			else
			{
				globalScaleX = 1;
				globalScaleY = 1;
				smallerGlobalScale = 1;
			}
			var verticalAlignOffsetY:Number = this.getVerticalAlignmentOffsetY();
			if(this.is3D)
			{
				var matrix3D:Matrix3D = Pool.getMatrix3D();
				var point3D:Vector3D = Pool.getPoint3D();
				this.getTransformationMatrix3D(this.stage, matrix3D);
				MatrixUtil.transformCoords3D(matrix3D, -desktopGutterPositionOffset, -desktopGutterPositionOffset + verticalAlignOffsetY, 0, point3D);
				point.setTo(point3D.x, point3D.y);
				Pool.putPoint3D(point3D);
				Pool.putMatrix3D(matrix3D);
			}
			else
			{
				MatrixUtil.transformCoords(matrix, -desktopGutterPositionOffset, -desktopGutterPositionOffset + verticalAlignOffsetY, point);
			}
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var nativeScaleFactor:Number = 1;
			if(starling.supportHighResolutions)
			{
				nativeScaleFactor = starling.nativeStage.contentsScaleFactor;
			}
			var scaleFactor:Number = starling.contentScaleFactor / nativeScaleFactor;
			var starlingViewPort:Rectangle = starling.viewPort;
			var stageTextViewPort:Rectangle = this.stageText.viewPort;
			if(!stageTextViewPort)
			{
				stageTextViewPort = new Rectangle();
			}
			var viewPortWidth:Number = Math.round((this.actualWidth + desktopGutterDimensionsOffset) * scaleFactor * globalScaleX);
			if(viewPortWidth < 1 ||
				viewPortWidth !== viewPortWidth) //isNaN
			{
				viewPortWidth = 1;
			}
			var viewPortHeight:Number = Math.round((this.actualHeight + desktopGutterDimensionsOffset) * scaleFactor * globalScaleY);
			if(viewPortHeight < 1 ||
				viewPortHeight !== viewPortHeight) //isNaN
			{
				viewPortHeight = 1;
			}
			stageTextViewPort.width = viewPortWidth;
			stageTextViewPort.height = viewPortHeight;
			var viewPortX:Number = Math.round(starlingViewPort.x + (point.x * scaleFactor));
			if((viewPortX + viewPortWidth) > MAX_VIEW_PORT_POSITION)
			{
				viewPortX = MAX_VIEW_PORT_POSITION - viewPortWidth;
			}
			//the previous calculation may have pushed the value below the
			//minimum, so it shouldn't be else if (BowlerHatLLC/feathersui-starling#1779)
			if(viewPortX < MIN_VIEW_PORT_POSITION)
			{
				viewPortX = MIN_VIEW_PORT_POSITION;
			}
			var viewPortY:Number = Math.round(starlingViewPort.y + (point.y * scaleFactor));
			if((viewPortY + viewPortHeight) > MAX_VIEW_PORT_POSITION)
			{
				viewPortY = MAX_VIEW_PORT_POSITION - viewPortHeight;
			}
			//the previous calculation may have pushed the value below the
			//minimum, so it shouldn't be else if (BowlerHatLLC/feathersui-starling#1779)
			if(viewPortY < MIN_VIEW_PORT_POSITION)
			{
				viewPortY = MIN_VIEW_PORT_POSITION;
			}
			stageTextViewPort.x = viewPortX;
			stageTextViewPort.y = viewPortY;
			this.stageText.viewPort = stageTextViewPort;

			var fontSize:int = 12;
			if(this._fontSize > 0)
			{
				fontSize = this._fontSize;
			}
			else if(this._fontStyles !== null)
			{
				var textFormat:starling.text.TextFormat = this._fontStyles.getTextFormatForTarget(this);
				if(textFormat !== null)
				{
					fontSize = textFormat.size;
				}
			}
			//StageText's fontSize property is an int, so we need to
			//specifically avoid using Number here.
			var newFontSize:int = fontSize * scaleFactor * smallerGlobalScale;
			if(this.stageText.fontSize != newFontSize)
			{
				//we need to check if this value has changed because on iOS
				//if displayAsPassword is set to true, the new character
				//will not be shown if the font size changes. instead, it
				//immediately changes to a bullet. (Github issue #881)
				this.stageText.fontSize = newFontSize;
			}
			Pool.putPoint(point);
			Pool.putMatrix(matrix);
		}

		/**
		 * @private
		 */
		protected function refreshMeasureTextFieldDimensions():void
		{
			//the +4 is accounting for the TextField gutter
			this._measureTextField.width = this.actualWidth + 4;
			this._measureTextField.height = this.actualHeight;
		}

		/**
		 * @private
		 */
		protected function positionSnapshot():void
		{
			var matrix:Matrix = Pool.getMatrix();
			this.getTransformationMatrix(this.stage, matrix);
			var desktopGutterPositionOffset:Number = 0;
			if(this._stageTextIsTextField)
			{
				desktopGutterPositionOffset = 2;
			}
			this.textSnapshot.x = Math.round(matrix.tx) - matrix.tx - desktopGutterPositionOffset;
			this.textSnapshot.y = Math.round(matrix.ty) - matrix.ty - desktopGutterPositionOffset +
				this.getVerticalAlignmentOffsetY();
			Pool.putMatrix(matrix);
		}

		/**
		 * @private
		 */
		protected function disposeStageText():void
		{
			if(!this.stageText)
			{
				return;
			}
			this.stageText.removeEventListener(flash.events.Event.CHANGE, stageText_changeHandler);
			this.stageText.removeEventListener(KeyboardEvent.KEY_DOWN, stageText_keyDownHandler);
			this.stageText.removeEventListener(KeyboardEvent.KEY_UP, stageText_keyUpHandler);
			this.stageText.removeEventListener(FocusEvent.FOCUS_IN, stageText_focusInHandler);
			this.stageText.removeEventListener(FocusEvent.FOCUS_OUT, stageText_focusOutHandler);
			this.stageText.removeEventListener(flash.events.Event.COMPLETE, stageText_completeHandler);
			this.stageText.removeEventListener(SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE, stageText_softKeyboardActivateHandler);
			this.stageText.removeEventListener(SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING, stageText_softKeyboardActivatingHandler);
			this.stageText.removeEventListener(SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE, stageText_softKeyboardDeactivateHandler);
			this.stageText.stage = null;
			this.stageText.dispose();
			this.stageText = null;
		}

		/**
		 * Creates and adds the <code>stageText</code> instance.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function createStageText():void
		{
			this._stageTextIsComplete = false;
			var StageTextType:Class;
			var initOptions:Object;
			try
			{
				StageTextType = Class(getDefinitionByName("flash.text.StageText"));
				var StageTextInitOptionsType:Class = Class(getDefinitionByName("flash.text.StageTextInitOptions"));
				initOptions = new StageTextInitOptionsType(this._multiline);
			}
			catch(error:Error)
			{
				StageTextType = StageTextField;
				initOptions = { multiline: this._multiline };
			}
			this.stageText = new StageTextType(initOptions);
			this.stageText.visible = false;
			this.stageText.addEventListener(flash.events.Event.CHANGE, stageText_changeHandler);
			this.stageText.addEventListener(KeyboardEvent.KEY_DOWN, stageText_keyDownHandler);
			this.stageText.addEventListener(KeyboardEvent.KEY_UP, stageText_keyUpHandler);
			this.stageText.addEventListener(FocusEvent.FOCUS_IN, stageText_focusInHandler);
			this.stageText.addEventListener(FocusEvent.FOCUS_OUT, stageText_focusOutHandler);
			this.stageText.addEventListener(SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE, stageText_softKeyboardActivateHandler);
			this.stageText.addEventListener(SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING, stageText_softKeyboardActivatingHandler);
			this.stageText.addEventListener(SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE, stageText_softKeyboardDeactivateHandler);
			this.stageText.addEventListener(flash.events.Event.COMPLETE, stageText_completeHandler);
			this.stageText.addEventListener(FocusEvent.MOUSE_FOCUS_CHANGE, stageText_mouseFocusChangeHandler);
			this.invalidate();
		}

		/**
		 * @private
		 */
		protected function getVerticalAlignment():String
		{
			var verticalAlign:String = null;
			if(this._fontStyles !== null)
			{
				var format:starling.text.TextFormat = this._fontStyles.getTextFormatForTarget(this);
				if(format !== null)
				{
					verticalAlign = format.verticalAlign;
				}
			}
			if(verticalAlign === null)
			{
				verticalAlign = Align.TOP;
			}
			return verticalAlign;
		}

		/**
		 * @private
		 */
		protected function getVerticalAlignmentOffsetY():Number
		{
			var verticalAlign:String = this.getVerticalAlignment();
			if(this._measureTextField.textHeight > this.actualHeight)
			{
				return 0;
			}
			if(verticalAlign === Align.BOTTOM)
			{
				return (this.actualHeight - this._measureTextField.textHeight);
			}
			else if(verticalAlign === Align.CENTER)
			{
				return (this.actualHeight - this._measureTextField.textHeight) / 2;
			}
			return 0;
		}

		/**
		 * @private
		 */
		protected function dispatchKeyFocusChangeEvent(event:KeyboardEvent):void
		{
			var focusEvent:FocusEvent = new FocusEvent(FocusEvent.KEY_FOCUS_CHANGE, true, false, null, event.shiftKey, event.keyCode);
			this.stage.starling.nativeStage.dispatchEvent(focusEvent);
		}

		/**
		 * @private
		 */
		protected function dispatchKeyboardEventToStage(event:KeyboardEvent):void
		{
			this.stage.starling.nativeStage.dispatchEvent(event);
		}

		/**
		 * @private
		 */
		protected function isParentChainVisible():Boolean
		{
			var target:DisplayObject = this;
			do
			{
				if(!target.visible)
				{
					return false;
				}
				target = target.parent;
			}
			while(target);
			return true;
		}

		/**
		 * @private
		 */
		protected function textEditor_removedFromStageHandler(event:starling.events.Event):void
		{
			//remove this from the stage, if needed
			//it will be added back next time we receive focus
			this.stageText.stage = null;
		}

		/**
		 * @private
		 */
		protected function stageText_changeHandler(event:flash.events.Event):void
		{
			if(this._ignoreStageTextChanges)
			{
				return;
			}
			this.text = this.stageText.text;
		}

		/**
		 * @private
		 */
		protected function stageText_completeHandler(event:flash.events.Event):void
		{
			this.stageText.removeEventListener(flash.events.Event.COMPLETE, stageText_completeHandler);
			this.invalidate();

			this._stageTextIsComplete = true;
		}

		/**
		 * @private
		 */
		protected function stageText_focusInHandler(event:FocusEvent):void
		{
			this._stageTextHasFocus = true;
			if(!this._isEditable)
			{
				//see the other half of this hack in setFocus()
				this.stageText.editable = false;
			}
			this.addEventListener(starling.events.Event.ENTER_FRAME, hasFocus_enterFrameHandler);
			if(this.textSnapshot)
			{
				this.textSnapshot.visible = false;
			}
			this.invalidate(INVALIDATION_FLAG_SKIN);
			this.dispatchEventWith(FeathersEventType.FOCUS_IN);
		}

		/**
		 * @private
		 */
		protected function stageText_focusOutHandler(event:FocusEvent):void
		{
			this._stageTextHasFocus = false;
			//since StageText doesn't expose its scroll position, we need to
			//set the selection back to the beginning to scroll there. it's a
			//hack, but so is everything about StageText.
			//in other news, why won't 0,0 work here?
			this.stageText.selectRange(1, 1);

			this.invalidate(INVALIDATION_FLAG_DATA);
			this.invalidate(INVALIDATION_FLAG_SKIN);
			this.dispatchEventWith(FeathersEventType.FOCUS_OUT);
		}

		/**
		 * @private
		 */
		protected function hasFocus_enterFrameHandler(event:starling.events.Event):void
		{
			if(this._stageTextHasFocus)
			{
				if(!this.isParentChainVisible())
				{
					this.stageText.stage.focus = null;
				}
			}
			else
			{
				this.removeEventListener(starling.events.Event.ENTER_FRAME, hasFocus_enterFrameHandler);
			}
		}

		/**
		 * @private
		 */
		protected function stageText_mouseFocusChangeHandler(event:FocusEvent):void
		{
			var nativeStage:Stage = this.stage.starling.nativeStage;
			var point:Point = Pool.getPoint(nativeStage.mouseX, nativeStage.mouseY);
			nativeToGlobal(point, this.stage.starling, point);
			var result:DisplayObject = this.stage.hitTest(point);
			while(result !== null)
			{
				var focusResult:IFocusDisplayObject = result as IFocusDisplayObject;
				if(focusResult !== null)
				{
					var focusOwner:IFocusDisplayObject = focusResult.focusOwner;
					if(focusOwner !== null)
					{
						if(focusOwner is DisplayObjectContainer &&
							DisplayObjectContainer(focusOwner).contains(this))
						{
							//this mouseFocusChange event won't reach the native
							//stage, so the FocusManager can't prevent it
							event.preventDefault();
						}
						break;
					}
					else if(focusResult.isFocusEnabled)
					{
						break;
					}
				}
				result = result.parent;
			}
			if(!this._maintainTouchFocus)
			{
				return;
			}
			event.preventDefault();
		}

		/**
		 * @private
		 */
		protected function stageText_keyDownHandler(event:KeyboardEvent):void
		{
			if(!this._multiline && (event.keyCode == Keyboard.ENTER || event.keyCode == Keyboard.NEXT))
			{
				event.preventDefault();
				this.dispatchEventWith(FeathersEventType.ENTER);
			}
			else if(event.keyCode == Keyboard.BACK)
			{
				//even a listener on the stage won't detect the back key press that
				//will close the application if the StageText has focus, so we
				//always need to prevent it here
				event.preventDefault();
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				starling.nativeStage.focus = starling.nativeStage;
			}
			if(FocusManager.isEnabledForStage(this.stage))
			{
				if(event.keyCode == Keyboard.TAB)
				{
					event.preventDefault();
					this.dispatchKeyFocusChangeEvent(event);
				}
				if((event.keyLocation == KeyLocation.D_PAD || DeviceCapabilities.simulateDPad) &&
					(event.keyCode == Keyboard.ENTER || event.keyCode == Keyboard.UP || event.keyCode == Keyboard.DOWN))
				{
					event.preventDefault();
					this.dispatchKeyboardEventToStage(event);
				}
			}
		}

		/**
		 * @private
		 */
		protected function stageText_keyUpHandler(event:KeyboardEvent):void
		{
			if(!this._multiline && (event.keyCode == Keyboard.ENTER || event.keyCode == Keyboard.NEXT))
			{
				event.preventDefault();
			}
			if(event.keyCode == Keyboard.TAB && FocusManager.isEnabledForStage(this.stage))
			{
				event.preventDefault();
			}
		}

		/**
		 * @private
		 */
		protected function stageText_softKeyboardActivateHandler(event:SoftKeyboardEvent):void
		{
			this.dispatchEventWith(FeathersEventType.SOFT_KEYBOARD_ACTIVATE, true);
		}

		/**
		 * @private
		 */
		protected function stageText_softKeyboardActivatingHandler(event:SoftKeyboardEvent):void
		{
			this.dispatchEventWith(FeathersEventType.SOFT_KEYBOARD_ACTIVATING, true);
		}

		/**
		 * @private
		 */
		protected function stageText_softKeyboardDeactivateHandler(event:SoftKeyboardEvent):void
		{
			this.dispatchEventWith(FeathersEventType.SOFT_KEYBOARD_DEACTIVATE, true);
		}
	}
}


================================================
FILE: source/feathers/controls/text/StageTextTextEditorViewPort.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.text
{
	import feathers.skins.IStyleProvider;

	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.text.TextFieldAutoSize;

	import starling.core.Starling;

	/**
	 * @private
	 * A text editor view port for the <code>TextArea</code> component that uses
	 * <code>flash.text.StageText</code>.
	 *
	 * <p><strong>WARNING!</strong> This component isn't recommended for use in
	 * production apps. It is buggy because <code>StageText</code> has a limited
	 * API that doesn't expose things like scroll position.</p>
	 *
	 * @see feathers.controls.TextArea
	 *
	 * @productversion Feathers 2.3.0
	 */
	public class StageTextTextEditorViewPort extends StageTextTextEditor implements ITextEditorViewPort
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>StageTextTextEditorViewPort</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function StageTextTextEditorViewPort()
		{
			super();
			this.multiline = true;
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return globalStyleProvider;
		}

		/**
		 * Quickly sets all padding properties to the same value. The
		 * <code>padding</code> getter always returns the value of
		 * <code>paddingTop</code>, but the other padding values may be
		 * different.
		 *
		 * @default 0
		 *
		 * @see #paddingTop
		 * @see #paddingRight
		 * @see #paddingBottom
		 * @see #paddingLeft
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * The minimum space, in pixels, between the view port's top edge and
		 * the view port's content.
		 *
		 * @default 0
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * The minimum space, in pixels, between the view port's right edge and
		 * the view port's content.
		 *
		 * @default 0
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * The minimum space, in pixels, between the view port's bottom edge and
		 * the view port's content.
		 *
		 * @default 0
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * The minimum space, in pixels, between the view port's left edge and
		 * the view port's content.
		 *
		 * @default 0
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _minVisibleWidth:Number = 0;

		/**
		 * @inheritDoc
		 */
		public function get minVisibleWidth():Number
		{
			return this._minVisibleWidth;
		}

		/**
		 * @private
		 */
		public function set minVisibleWidth(value:Number):void
		{
			if(this._minVisibleWidth == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("minVisibleWidth cannot be NaN");
			}
			this._minVisibleWidth = value;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		private var _maxVisibleWidth:Number = Number.POSITIVE_INFINITY;

		/**
		 * @inheritDoc
		 */
		public function get maxVisibleWidth():Number
		{
			return this._maxVisibleWidth;
		}

		/**
		 * @private
		 */
		public function set maxVisibleWidth(value:Number):void
		{
			if(this._maxVisibleWidth == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleWidth cannot be NaN");
			}
			this._maxVisibleWidth = value;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		private var _visibleWidth:Number = NaN;

		/**
		 * @inheritDoc
		 */
		public function get visibleWidth():Number
		{
			return this._visibleWidth;
		}

		/**
		 * @private
		 */
		public function set visibleWidth(value:Number):void
		{
			if(this._visibleWidth == value ||
				(value !== value && this._visibleWidth !== this._visibleWidth)) //isNaN
			{
				return;
			}
			this._visibleWidth = value;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		private var _minVisibleHeight:Number = 0;

		/**
		 * @inheritDoc
		 */
		public function get minVisibleHeight():Number
		{
			return this._minVisibleHeight;
		}

		/**
		 * @private
		 */
		public function set minVisibleHeight(value:Number):void
		{
			if(this._minVisibleHeight == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("minVisibleHeight cannot be NaN");
			}
			this._minVisibleHeight = value;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		private var _maxVisibleHeight:Number = Number.POSITIVE_INFINITY;

		/**
		 * @inheritDoc
		 */
		public function get maxVisibleHeight():Number
		{
			return this._maxVisibleHeight;
		}

		/**
		 * @private
		 */
		public function set maxVisibleHeight(value:Number):void
		{
			if(this._maxVisibleHeight == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleHeight cannot be NaN");
			}
			this._maxVisibleHeight = value;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		private var _visibleHeight:Number = NaN;

		/**
		 * @inheritDoc
		 */
		public function get visibleHeight():Number
		{
			return this._visibleHeight;
		}

		/**
		 * @private
		 */
		public function set visibleHeight(value:Number):void
		{
			if(this._visibleHeight == value ||
				(value !== value && this._visibleHeight !== this._visibleHeight)) //isNaN
			{
				return;
			}
			this._visibleHeight = value;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		public function get contentX():Number
		{
			return 0;
		}

		public function get contentY():Number
		{
			return 0;
		}

		/**
		 * @private
		 */
		protected var _scrollStep:int = 1;

		/**
		 * @inheritDoc
		 */
		public function get horizontalScrollStep():Number
		{
			return this._scrollStep;
		}

		/**
		 * @inheritDoc
		 */
		public function get verticalScrollStep():Number
		{
			return this._scrollStep;
		}

		/**
		 * @private
		 */
		private var _horizontalScrollPosition:Number = 0;

		/**
		 * @inheritDoc
		 */
		public function get horizontalScrollPosition():Number
		{
			return this._horizontalScrollPosition;
		}

		/**
		 * @private
		 */
		public function set horizontalScrollPosition(value:Number):void
		{
			//this value is basically ignored because the text does not scroll
			//horizontally. instead, it wraps.
			this._horizontalScrollPosition = value;
		}

		/**
		 * @private
		 */
		private var _verticalScrollPosition:Number = 0;

		/**
		 * @inheritDoc
		 */
		public function get verticalScrollPosition():Number
		{
			return this._verticalScrollPosition;
		}

		/**
		 * @private
		 */
		public function set verticalScrollPosition(value:Number):void
		{
			//this value is basically ignored because the StageText handles
			//scrolling automatically.
			this._verticalScrollPosition = value;
		}

		/**
		 * @private
		 */
		public function get requiresMeasurementOnScroll():Boolean
		{
			return false;
		}

		/**
		 * @private
		 */
		override protected function measure(result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}

			var needsWidth:Boolean = this._visibleWidth !== this._visibleWidth; //isNaN
			var needsHeight:Boolean = this._visibleHeight !== this._visibleHeight; //isNaN

			this._measureTextField.autoSize = TextFieldAutoSize.LEFT;

			var newWidth:Number = this._visibleWidth;
			if(needsWidth)
			{
				newWidth = this._measureTextField.textWidth + this._paddingLeft + this._paddingRight;
				if(newWidth < this._minVisibleWidth)
				{
					newWidth = this._minVisibleWidth;
				}
				else if(newWidth > this._maxVisibleWidth)
				{
					newWidth = this._maxVisibleWidth;
				}
			}

			//the +4 is accounting for the TextField gutter
			this._measureTextField.width = newWidth + 4;
			var newHeight:Number = this._visibleHeight;
			if(needsHeight)
			{
				//since we're measuring with TextField, but rendering with
				//StageText, we're using height instead of textHeight here to be
				//sure that the measured size is on the larger side, in case the
				//rendered size is actually bigger than textHeight
				//if only StageText had an API for text measurement, we wouldn't
				//be in this mess...
				newHeight = this._measureTextField.height + this._paddingTop + this._paddingBottom;
				if(newHeight < this._minVisibleHeight)
				{
					newHeight = this._minVisibleHeight;
				}
				else if(newHeight > this._maxVisibleHeight)
				{
					newHeight = this._maxVisibleHeight;
				}
			}

			this._measureTextField.autoSize = TextFieldAutoSize.NONE;

			//put the width and height back just in case we measured without
			//a full validation
			//the +4 is accounting for the TextField gutter
			this._measureTextField.width = this.actualWidth + 4;
			this._measureTextField.height = this.actualHeight;

			result.x = newWidth;
			result.y = newHeight;

			return result;
		}

		/**
		 * @private
		 */
		override protected function refreshViewPortAndFontSize():void
		{
			super.refreshViewPortAndFontSize();

			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var nativeScaleFactor:Number = 1;
			if(starling.supportHighResolutions)
			{
				nativeScaleFactor = starling.nativeStage.contentsScaleFactor;
			}
			var scaleFactor:Number = starling.contentScaleFactor / nativeScaleFactor;

			var viewPort:Rectangle = this.stageText.viewPort;
			viewPort.x += (this._paddingLeft * scaleFactor);
			viewPort.y += (this._paddingTop * scaleFactor);
			viewPort.width -= ((this._paddingLeft + this._paddingRight) * scaleFactor);
			viewPort.height -= ((this._paddingTop + this._paddingBottom) * scaleFactor);
			this.stageText.viewPort = viewPort;
		}

		/**
		 * @private
		 */
		override protected function positionSnapshot():void
		{
			super.positionSnapshot();
			this.textSnapshot.x += this._paddingLeft;
			this.textSnapshot.y += this._paddingRight;
		}
	}
}


================================================
FILE: source/feathers/controls/text/TextBlockTextEditor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.text
{
	import feathers.core.FocusManager;
	import feathers.core.IIMETextEditor;
	import feathers.core.INativeFocusOwner;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;
	import feathers.utils.text.TextEditorIMEClient;
	import feathers.utils.text.TextInputNavigation;
	import feathers.utils.text.TextInputRestrict;

	import flash.desktop.Clipboard;
	import flash.desktop.ClipboardFormats;
	import flash.display.DisplayObjectContainer;
	import flash.display.Sprite;
	import flash.display.Stage;
	import flash.events.Event;
	import flash.events.TextEvent;
	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.text.TextFormatAlign;
	import flash.text.engine.TextElement;
	import flash.text.engine.TextLine;
	import flash.text.ime.CompositionAttributeRange;
	import flash.ui.Keyboard;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.KeyboardEvent;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.rendering.Painter;
	import starling.utils.Pool;

	/**
	 * Dispatched when the text property changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #text
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the user presses the Enter key while the editor has
	 * focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.ENTER
	 */
	[Event(name="enter",type="starling.events.Event")]

	/**
	 * Dispatched when the text editor receives focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_IN
	 */
	[Event(name="focusIn",type="starling.events.Event")]

	/**
	 * Dispatched when the text editor loses focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_OUT
	 */
	[Event(name="focusOut",type="starling.events.Event")]

	/**
	 * Text that may be edited at runtime by the user with the
	 * <code>TextInput</code> component, rendered with a native
	 * <code>flash.text.engine.TextBlock</code> from
	 * <a href="http://help.adobe.com/en_US/as3/dev/WS9dd7ed846a005b294b857bfa122bd808ea6-8000.html" target="_top">Flash Text Engine</a>
	 * (sometimes abbreviated as FTE). Draws the text to <code>BitmapData</code>
	 * to convert to Starling textures. Textures are managed internally by this
	 * component, and they will be automatically disposed when the component is
	 * disposed.
	 *
	 * <p><strong>Warning:</strong> This text editor is intended for use in
	 * desktop applications only, and it does not provide support for software
	 * keyboards on mobile devices.</p>
	 *
	 * <p>The following example shows how to use
	 * <code>TextBlockTextEditor</code> with a <code>TextInput</code>:</p>
	 *
	 * <listing version="3.0">
	 * var input:TextInput = new TextInput();
	 * input.textEditorFactory = function():ITextEditor
	 * {
	 *     return new TextBlockTextEditor();
	 * };
	 * this.addChild( input );</listing>
	 *
	 * @see feathers.controls.TextInput
	 * @see ../../../../help/text-editors.html Introduction to Feathers text editors
	 * @see http://help.adobe.com/en_US/as3/dev/WS9dd7ed846a005b294b857bfa122bd808ea6-8000.html Using the Flash Text Engine in ActionScript 3.0 Developer's Guide
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/TextBlock.html flash.text.engine.TextBlock
	 *
	 * @productversion Feathers 2.0.0
	 */
	public class TextBlockTextEditor extends TextBlockTextRenderer implements IIMETextEditor, INativeFocusOwner
	{
		/**
		 * The text will be positioned to the left edge.
		 *
		 * @see feathers.controls.text.TextBlockTextRenderer#textAlign
		 */
		public static const TEXT_ALIGN_LEFT:String = "left";

		/**
		 * The text will be centered horizontally.
		 *
		 * @see feathers.controls.text.TextBlockTextRenderer#textAlign
		 */
		public static const TEXT_ALIGN_CENTER:String = "center";

		/**
		 * The text will be positioned to the right edge.
		 *
		 * @see feathers.controls.text.TextBlockTextRenderer#textAlign
		 */
		public static const TEXT_ALIGN_RIGHT:String = "right";

		/**
		 * The default <code>IStyleProvider</code> for all <code>TextBlockTextEditor</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function TextBlockTextEditor()
		{
			super();
			this._text = "";
			this._textElement = new TextElement(this._text);
			this._content = this._textElement;
			this.isQuickHitAreaEnabled = true;
			this.truncateToFit = false;
			this.addEventListener(TouchEvent.TOUCH, textEditor_touchHandler);
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _ignoreNextTextInputEvent:Boolean = false;

		/**
		 * @private
		 */
		protected var _imeText:String;

		/**
		 * @private
		 */
		protected var _imeCursorIndex:int = -1;

		/**
		 * @private
		 */
		protected var _selectionSkin:DisplayObject;

		/**
		 * The skin that indicates the currently selected range of text.
		 */
		public function get selectionSkin():DisplayObject
		{
			return this._selectionSkin;
		}

		/**
		 * @private
		 */
		public function set selectionSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._selectionSkin == value)
			{
				return;
			}
			if(this._selectionSkin && this._selectionSkin.parent == this)
			{
				this._selectionSkin.removeFromParent();
			}
			this._selectionSkin = value;
			if(this._selectionSkin)
			{
				this._selectionSkin.visible = false;
				this.addChildAt(this._selectionSkin, 0);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _cursorDelay:Number = 0.53;

		/**
		 * @private
		 */
		protected var _cursorDelayID:uint = uint.MAX_VALUE;

		/**
		 * @private
		 */
		protected var _cursorSkin:DisplayObject;

		/**
		 * The skin that indicates the current position where text may be
		 * entered.
		 */
		public function get cursorSkin():DisplayObject
		{
			return this._cursorSkin;
		}

		/**
		 * @private
		 */
		public function set cursorSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._cursorSkin === value)
			{
				return;
			}
			if(this._cursorSkin !== null && this._cursorSkin.parent === this)
			{
				this._cursorSkin.removeFromParent();
			}
			this._cursorSkin = value;
			if(this._cursorSkin !== null)
			{
				this._cursorSkin.visible = false;
				this.addChild(this._cursorSkin);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _unmaskedText:String;

		/**
		 * @private
		 */
		protected var _displayAsPassword:Boolean = false;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#displayAsPassword
		 *
		 * @see feathers.controls.TextInput#displayAsPassword
		 *
		 * @see #passwordCharCode
		 */
		public function get displayAsPassword():Boolean
		{
			return this._displayAsPassword;
		}

		/**
		 * @private
		 */
		public function set displayAsPassword(value:Boolean):void
		{
			if(this._displayAsPassword == value)
			{
				return;
			}
			this._displayAsPassword = value;
			if(this._displayAsPassword)
			{
				this._unmaskedText = this._text;
				this.refreshMaskedText();
			}
			else
			{
				this._text = this._unmaskedText;
				this._unmaskedText = null;
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _passwordCharCode:int = 42; //asterisk

		/**
		 * The character code of the character used to display a password.
		 *
		 * <p>In the following example, the substitute character for passwords
		 * is set to a bullet:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.displayAsPassword = true;
		 * textEditor.passwordCharCode = "•".charCodeAt(0);</listing>
		 *
		 * @default 42 (asterisk)
		 *
		 * @see #displayAsPassword
		 */
		public function get passwordCharCode():int
		{
			return this._passwordCharCode;
		}

		/**
		 * @private
		 */
		public function set passwordCharCode(value:int):void
		{
			if(this._passwordCharCode == value)
			{
				return;
			}
			this._passwordCharCode = value;
			if(this._displayAsPassword)
			{
				this.refreshMaskedText();
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isEditable:Boolean = true;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#isEditable
		 *
		 * @see feathers.controls.TextInput#isEditable
		 */
		public function get isEditable():Boolean
		{
			return this._isEditable;
		}

		/**
		 * @private
		 */
		public function set isEditable(value:Boolean):void
		{
			if(this._isEditable == value)
			{
				return;
			}
			this._isEditable = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isSelectable:Boolean = true;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#isSelectable
		 *
		 * @see feathers.controls.TextInput#isSelectable
		 */
		public function get isSelectable():Boolean
		{
			return this._isSelectable;
		}

		/**
		 * @private
		 */
		public function set isSelectable(value:Boolean):void
		{
			if(this._isSelectable == value)
			{
				return;
			}
			this._isSelectable = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @inheritDoc
		 *
		 * @default false
		 */
		public function get setTouchFocusOnEndedPhase():Boolean
		{
			return false;
		}

		/**
		 * @private
		 */
		override public function get text():String
		{
			if(this._displayAsPassword)
			{
				return this._unmaskedText;
			}
			return this._text;
		}

		/**
		 * @private
		 */
		override public function set text(value:String):void
		{
			if(value === null)
			{
				//don't allow null or undefined
				value = "";
			}
			var currentValue:String = this._text;
			if(this._displayAsPassword)
			{
				currentValue = this._unmaskedText;
			}
			if(currentValue == value)
			{
				return;
			}
			if(this._displayAsPassword)
			{
				this._unmaskedText = value;
				this.refreshMaskedText();
			}
			else
			{
				super.text = value;
			}
			var textLength:int = this._text.length;
			//we need to account for the possibility that the text is in the
			//middle of being selected when it changes
			if(this._selectionAnchorIndex > textLength)
			{
				this._selectionAnchorIndex = textLength;
			}
			//then, we need to make sure the selected range is still valid
			if(this._selectionBeginIndex > textLength)
			{
				this.selectRange(textLength, textLength);
			}
			else if(this._selectionEndIndex > textLength)
			{
				this.selectRange(this._selectionBeginIndex, textLength);
			}
			this.dispatchEventWith(starling.events.Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _maxChars:int = 0;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#maxChars
		 *
		 * @see feathers.controls.TextInput#maxChars
		 */
		public function get maxChars():int
		{
			return this._maxChars;
		}

		/**
		 * @private
		 */
		public function set maxChars(value:int):void
		{
			if(this._maxChars == value)
			{
				return;
			}
			this._maxChars = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _restrict:TextInputRestrict;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#restrict
		 *
		 * @see feathers.controls.TextInput#restrict
		 */
		public function get restrict():String
		{
			if(!this._restrict)
			{
				return null;
			}
			return this._restrict.restrict;
		}

		/**
		 * @private
		 */
		public function set restrict(value:String):void
		{
			if(this._restrict && this._restrict.restrict === value)
			{
				return;
			}
			if(!this._restrict && value === null)
			{
				return;
			}
			if(value === null)
			{
				this._restrict = null;
			}
			else
			{
				if(this._restrict)
				{
					this._restrict.restrict = value;
				}
				else
				{

					this._restrict = new TextInputRestrict(value);
				}
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _selectionBeginIndex:int = 0;

		/**
		 * @inheritDoc
		 *
		 * @see #selectionEndIndex
		 */
		public function get selectionBeginIndex():int
		{
			return this._selectionBeginIndex;
		}

		/**
		 * @private
		 */
		protected var _selectionEndIndex:int = 0;

		/**
		 * @inheritDoc
		 *
		 * @see #selectionBeginIndex
		 */
		public function get selectionEndIndex():int
		{
			return this._selectionEndIndex;
		}

		/**
		 * @private
		 */
		protected var _selectionAnchorIndex:int = 0;

		/**
		 * @inheritDoc
		 *
		 * @see #selectionActiveIndex
		 */
		public function get selectionAnchorIndex():int
		{
			return this._selectionAnchorIndex;
		}

		/**
		 * @inheritDoc
		 *
		 * @see #selectionAnchorIndex
		 */
		public function get selectionActiveIndex():int
		{
			if(this._selectionAnchorIndex == this._selectionBeginIndex)
			{
				return this._selectionEndIndex;
			}
			return this._selectionBeginIndex;
		}

		/**
		 * @private
		 */
		protected var touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _nativeFocus:Sprite;

		/**
		 * @copy feathers.core.INativeFocusOwner#nativeFocus
		 */
		public function get nativeFocus():Object
		{
			return this._nativeFocus;
		}

		/**
		 * @private
		 */
		protected var _isWaitingToSetFocus:Boolean = false;

		/**
		 * @inheritDoc
		 */
		public function setFocus(position:Point = null):void
		{
			if(this._hasFocus && !position)
			{
				//we already have focus, and there isn't a touch position, we
				//can ignore this because nothing would change
				return;
			}
			if(this._nativeFocus !== null)
			{
				if(this._nativeFocus.parent === null)
				{
					var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
					starling.nativeStage.addChild(this._nativeFocus);
				}
				var newIndex:int = -1;
				if(position !== null)
				{
					newIndex = this.getSelectionIndexAtPoint(position.x, position.y);
				}
				if(newIndex >= 0)
				{
					this.selectRange(newIndex, newIndex);
				}
				this.focusIn();
			}
			else
			{
				this._isWaitingToSetFocus = true;
			}
		}

		/**
		 * @inheritDoc
		 */
		public function clearFocus():void
		{
			if(!this._hasFocus)
			{
				return;
			}
			this._hasFocus = false;
			this._cursorSkin.visible = false;
			this._selectionSkin.visible = false;
			this.refreshCursorBlink();
			this.stage.removeEventListener(TouchEvent.TOUCH, stage_touchHandler);
			this.stage.removeEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
			this.removeEventListener(starling.events.Event.ENTER_FRAME, hasFocus_enterFrameHandler);
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var nativeStage:Stage = starling.nativeStage;
			if(nativeStage.focus === this._nativeFocus)
			{
				//only clear the native focus when our native target has focus
				//because otherwise another component may lose focus.

				//for consistency with StageTextTextEditor and
				//TextFieldTextEditor, we set the native stage's focus to null
				//here instead of setting it to the native stage due to issues
				//with those text editors on Android.
				nativeStage.focus = null;
			}
			this.dispatchEventWith(FeathersEventType.FOCUS_OUT);
		}

		/**
		 * @inheritDoc
		 */
		public function selectRange(beginIndex:int, endIndex:int):void
		{
			if(!this._isEditable && !this._isSelectable)
			{
				return;
			}
			if(endIndex < beginIndex)
			{
				var temp:int = endIndex;
				endIndex = beginIndex;
				beginIndex = temp;
			}
			this._selectionBeginIndex = beginIndex;
			this._selectionEndIndex = endIndex;
			if(beginIndex == endIndex)
			{
				this._selectionAnchorIndex = beginIndex;
				if(beginIndex < 0)
				{
					this._cursorSkin.visible = false;
				}
				else
				{
					//cursor skin is not shown if isSelectable === true and
					//isEditable is false
					this._cursorSkin.visible = this._hasFocus && this._isEditable;
				}
				this._selectionSkin.visible = false;
			}
			else
			{
				this._cursorSkin.visible = false;
				this._selectionSkin.visible = true;
			}
			this.refreshCursorBlink();
			this.invalidate(INVALIDATION_FLAG_SELECTED);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this._nativeFocus && this._nativeFocus.parent)
			{
				this._nativeFocus.parent.removeChild(this._nativeFocus);
			}
			this._nativeFocus = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override public function render(painter:Painter):void
		{
			var oldSnapshotX:Number = this._textSnapshotOffsetX;
			var oldCursorX:Number = this._cursorSkin.x;
			this._cursorSkin.x -= this._textSnapshotScrollX;
			super.render(painter);
			this._textSnapshotOffsetX = oldSnapshotX;
			this._cursorSkin.x = oldCursorX;
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(!this._nativeFocus)
			{
				this._nativeFocus = new TextEditorIMEClient(this, imeClientStartCallback, imeClientUpdateCallback, imeClientConfirmCallback);
				//let's ensure that this can only get focus through code
				this._nativeFocus.tabEnabled = false;
				this._nativeFocus.tabChildren = false;
				this._nativeFocus.mouseEnabled = false;
				this._nativeFocus.mouseChildren = false;
				//adds support for mobile
				this._nativeFocus.needsSoftKeyboard = true;
			}
			this._nativeFocus.addEventListener(flash.events.Event.CUT, nativeFocus_cutHandler, false, 0, true);
			this._nativeFocus.addEventListener(flash.events.Event.COPY, nativeFocus_copyHandler, false, 0, true);
			this._nativeFocus.addEventListener(flash.events.Event.PASTE, nativeFocus_pasteHandler, false, 0, true);
			this._nativeFocus.addEventListener(flash.events.Event.SELECT_ALL, nativeFocus_selectAllHandler, false, 0, true);
			this._nativeFocus.addEventListener(TextEvent.TEXT_INPUT, nativeFocus_textInputHandler, false, 0, true);
			if(this._cursorSkin === null)
			{
				this.ignoreNextStyleRestriction();
				this.cursorSkin = new Quad(1, 1, 0x000000);
			}
			if(this._selectionSkin === null)
			{
				this.ignoreNextStyleRestriction();
				this.selectionSkin = new Quad(1, 1, 0x000000);
			}
			super.initialize();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var selectionInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SELECTED);
			super.draw();
			if(dataInvalid || selectionInvalid)
			{
				this.positionCursorAtCharIndex(this.getCursorIndexFromSelectionRange());
				this.positionSelectionBackground();
			}
		}

		/**
		 * @private
		 */
		override protected function refreshTextElementText():void
		{
			if(this._textElement === null)
			{
				return;
			}
			var displayText:String = this._text;
			if(this._imeText !== null)
			{
				displayText = this._imeText;
			}
			if(displayText)
			{
				this._textElement.text = displayText;
				if(displayText !== null && displayText.charAt(displayText.length - 1) == " ")
				{
					//add an invisible control character because FTE apparently
					//doesn't think that it's important to include trailing
					//spaces in its width measurement.
					this._textElement.text += String.fromCharCode(3);
				}
			}
			else
			{
				//similar to above. this hack ensures that the baseline is
				//measured properly when the text is an empty string.
				this._textElement.text = String.fromCharCode(3);
			}
		}

		/**
		 * @private
		 */
		override protected function refreshTextLines(textLines:Vector.<TextLine>,
			textLineParent:DisplayObjectContainer, width:Number, height:Number,
			result:MeasureTextResult = null):MeasureTextResult
		{
			result = super.refreshTextLines(textLines, textLineParent, width, height, result);
			if(textLines !== this._measurementTextLines &&
				textLineParent.width > width)
			{
				this.alignTextLines(textLines, width, TextFormatAlign.LEFT);
			}
			return result;
		}

		/**
		 * @private
		 */
		protected function refreshMaskedText():void
		{
			var newText:String = "";
			var textLength:int = this._unmaskedText.length;
			var maskChar:String = String.fromCharCode(this._passwordCharCode);
			for(var i:int = 0; i < textLength; i++)
			{
				newText += maskChar;
			}
			super.text = newText;
		}

		/**
		 * @private
		 */
		protected function focusIn():void
		{
			var showSelection:Boolean = (this._isEditable || this._isSelectable) &&
				this._selectionBeginIndex >= 0 &&
				this._selectionBeginIndex != this._selectionEndIndex;
			var showCursor:Boolean = this._isEditable &&
				this._selectionBeginIndex >= 0 &&
				this._selectionBeginIndex == this._selectionEndIndex;
			this._cursorSkin.visible = showCursor;
			this._selectionSkin.visible = showSelection;
			this.refreshCursorBlink();
			if(!FocusManager.isEnabledForStage(this.stage))
			{
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				//if there isn't a focus manager, we need to set focus manually
				starling.nativeStage.focus = this._nativeFocus;
			}
			if(this._isEditable)
			{
				this._nativeFocus.requestSoftKeyboard();
			}
			if(this._hasFocus)
			{
				return;
			}
			//we're reusing this variable. since this isn't a display object
			//that the focus manager can see, it's not being used anyway.
			this._hasFocus = true;
			this.stage.addEventListener(TouchEvent.TOUCH, stage_touchHandler);
			this.stage.addEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
			this.addEventListener(starling.events.Event.ENTER_FRAME, hasFocus_enterFrameHandler);
			this.dispatchEventWith(FeathersEventType.FOCUS_IN);
		}

		/**
		 * @private
		 */
		protected function refreshCursorBlink():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			if(this._cursorDelayID == uint.MAX_VALUE && this._cursorSkin.visible)
			{
				this._cursorSkin.alpha = 1;
				this._cursorDelayID = starling.juggler.delayCall(toggleCursorSkin, this._cursorDelay);
			}
			else if(this._cursorDelayID != uint.MAX_VALUE && !this._cursorSkin.visible)
			{
				starling.juggler.removeByID(this._cursorDelayID);
				this._cursorDelayID = uint.MAX_VALUE;
			}
		}

		/**
		 * @private
		 */
		protected function toggleCursorSkin():void
		{
			if(this._cursorSkin.alpha > 0)
			{
				this._cursorSkin.alpha = 0;
			}
			else
			{
				this._cursorSkin.alpha = 1;
			}
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			this._cursorDelayID = starling.juggler.delayCall(toggleCursorSkin, this._cursorDelay);
		}

		/**
		 * @private
		 */
		protected function getSelectionIndexAtPoint(pointX:Number, pointY:Number):int
		{
			if(!this._text || this._textLines.length == 0)
			{
				return 0;
			}
			var line:TextLine = this._textLines[0];
			if((pointX - line.x) <= 0)
			{
				if(this._bidiLevel == 1)
				{
					return this._text.length;
				}
				return 0;
			}
			else if((pointX - line.x) >= line.width)
			{
				if(this._bidiLevel == 1)
				{
					return 0;
				}
				return this._text.length;
			}
			var atomIndex:int = line.getAtomIndexAtPoint(pointX, pointY);
			if(atomIndex < 0)
			{
				//try again with the middle of the line
				atomIndex = line.getAtomIndexAtPoint(pointX, line.ascent / 2);
			}
			if(atomIndex < 0)
			{
				//worse case: we couldn't figure it out at all
				return this._text.length;
			}
			//we're constraining the atom index to the text length because we
			//may have added an invisible control character at the end due to
			//the fact that FTE won't include trailing spaces in measurement
			if(atomIndex > this._text.length)
			{
				atomIndex = this._text.length;
			}
			var atomBounds:Rectangle = line.getAtomBounds(atomIndex);
			if((pointX - line.x - atomBounds.x) > atomBounds.width / 2)
			{
				return atomIndex + 1;
			}
			return atomIndex;
		}

		/**
		 * @private
		 */
		protected function getXPositionOfCharIndex(index:int):Number
		{
			var displayText:String = this._text;
			if(this._imeText !== null)
			{
				displayText = this._imeText;
			}
			if(!displayText || this._textLines.length == 0)
			{
				if(this._currentHorizontalAlign == TextFormatAlign.CENTER)
				{
					return Math.round(this.actualWidth / 2);
				}
				else if(this._currentHorizontalAlign == TextFormatAlign.RIGHT)
				{
					return this.actualWidth;
				}
				return 0;
			}
			var line:TextLine = this._textLines[0];
			if(index === displayText.length)
			{
				if(this._bidiLevel == 1)
				{
					return line.x;
				}
				return line.x + line.width;
			}
			var atomIndex:int = line.getAtomIndexAtCharIndex(index);
			var atomBounds:Rectangle = line.getAtomBounds(atomIndex);
			var result:Number = line.x + atomBounds.x;
			if(this._bidiLevel == 1)
			{
				result += atomBounds.width;
			}
			return result;
		}

		/**
		 * @private
		 */
		protected function positionCursorAtCharIndex(index:int):void
		{
			if(index < 0)
			{
				index = 0;
			}
			var cursorX:Number = this.getXPositionOfCharIndex(index);
			cursorX = int(cursorX - (this._cursorSkin.width / 2));
			this._cursorSkin.x = cursorX;
			this._cursorSkin.y = this._verticalAlignOffsetY;
			if(this._textLines.length > 0)
			{
				var line:TextLine = this._textLines[0];
				this._cursorSkin.height = this.calculateLineAscent(line) + line.totalDescent;
			}
			else
			{
				this._cursorSkin.height = this.currentElementFormat.fontSize;
			}

			//then we update the scroll to always show the cursor
			var minScrollX:Number = cursorX + this._cursorSkin.width - this.actualWidth;
			var displayText:String = this._text;
			if(this._imeText !== null)
			{
				displayText = this._imeText;
			}
			var maxScrollX:Number = this.getXPositionOfCharIndex(displayText.length) - this.actualWidth;
			if(maxScrollX < 0)
			{
				maxScrollX = 0;
			}
			var oldScrollX:Number = this._textSnapshotScrollX;
			if(this._textSnapshotScrollX < minScrollX)
			{
				this._textSnapshotScrollX = minScrollX;
			}
			else if(this._textSnapshotScrollX > cursorX)
			{
				this._textSnapshotScrollX = cursorX;
			}
			if(this._textSnapshotScrollX > maxScrollX)
			{
				this._textSnapshotScrollX = maxScrollX;
			}
			if(this._textSnapshotScrollX != oldScrollX)
			{
				this.invalidate(INVALIDATION_FLAG_DATA);
			}
		}

		/**
		 * @private
		 */
		protected function getCursorIndexFromSelectionRange():int
		{
			if(this._imeCursorIndex >= 0)
			{
				return this._imeCursorIndex;
			}
			var cursorIndex:int = this._selectionEndIndex;
			if(this.touchPointID >= 0 && this._selectionAnchorIndex >= 0 && this._selectionAnchorIndex == this._selectionEndIndex)
			{
				cursorIndex = this._selectionBeginIndex;
			}
			return cursorIndex;
		}

		/**
		 * @private
		 */
		protected function positionSelectionBackground():void
		{
			var displayText:String = this._text;
			if(this._imeText !== null)
			{
				displayText = this._imeText;
			}
			var beginIndex:int = this._selectionBeginIndex;
			if(beginIndex > displayText.length)
			{
				beginIndex = displayText.length;
			}
			var startX:Number = this.getXPositionOfCharIndex(beginIndex) - this._textSnapshotScrollX;
			if(startX < 0)
			{
				startX = 0;
			}
			var endIndex:int = this._selectionEndIndex;
			if(endIndex > displayText.length)
			{
				endIndex = displayText.length;
			}
			var endX:Number = this.getXPositionOfCharIndex(endIndex) - this._textSnapshotScrollX;
			if(endX < 0)
			{
				endX = 0;
			}
			else if(endX > this.actualWidth)
			{
				endX = this.actualWidth;
			}
			this._selectionSkin.x = startX;
			this._selectionSkin.width = endX - startX;
			this._selectionSkin.y = this._verticalAlignOffsetY;
			if(this._textLines.length > 0)
			{
				var line:TextLine = this._textLines[0];
				this._selectionSkin.height = this.calculateLineAscent(line) + line.totalDescent;
			}
			else
			{
				this._selectionSkin.height = this.currentElementFormat.fontSize;
			}
		}

		/**
		 * @private
		 */
		protected function getSelectedText():String
		{
			if(this._selectionBeginIndex == this._selectionEndIndex)
			{
				return null;
			}
			return this._text.substr(this._selectionBeginIndex, this._selectionEndIndex - this._selectionBeginIndex);
		}

		/**
		 * @private
		 */
		protected function deleteSelectedText():void
		{
			var currentValue:String = this._text;
			if(this._displayAsPassword)
			{
				currentValue = this._unmaskedText;
			}
			this.text = currentValue.substr(0, this._selectionBeginIndex) + currentValue.substr(this._selectionEndIndex);
			this.validate();
			this.selectRange(this._selectionBeginIndex, this._selectionBeginIndex);
		}

		/**
		 * @private
		 */
		protected function replaceSelectedText(text:String):void
		{
			var currentValue:String = this._text;
			if(this._displayAsPassword)
			{
				currentValue = this._unmaskedText;
			}
			var newText:String = currentValue.substr(0, this._selectionBeginIndex) + text + currentValue.substr(this._selectionEndIndex);
			if(this._maxChars > 0 && newText.length > this._maxChars)
			{
				return;
			}
			this.text = newText;
			this.validate();
			var selectionIndex:int = this._selectionBeginIndex + text.length;
			this.selectRange(selectionIndex, selectionIndex);
		}

		/**
		 * @private
		 */
		protected function imeClientStartCallback():void
		{
		}

		/**
		 * @private
		 */
		protected function imeClientUpdateCallback(text:String, attributes:Vector.<CompositionAttributeRange>, compositionStartIndex:int, compositionEndIndex:int):void
		{
			var currentValue:String = this._text;
			if(this._displayAsPassword)
			{
				currentValue = this._unmaskedText;
			}
			this._imeText = currentValue.substr(0, this._selectionBeginIndex) + text + currentValue.substr(this._selectionEndIndex);
			this._imeCursorIndex = this._selectionBeginIndex + compositionStartIndex;
			this._cursorSkin.visible = this._hasFocus;
			this._selectionSkin.visible = false;
			this.setInvalidationFlag(INVALIDATION_FLAG_DATA);
			this.validate();
		}

		/**
		 * @private
		 */
		protected function imeClientConfirmCallback(text:String = null, preserveSelection:Boolean = false):void
		{
			//the focus will dispatch an extra TextEvent.TEXT_INPUT event, for
			//some reason. we need to ignore it or extra text will be displayed.
			this._ignoreNextTextInputEvent = true;
		}

		/**
		 * @private
		 */
		protected function hasFocus_enterFrameHandler(event:starling.events.Event):void
		{
			var target:DisplayObject = this;
			do
			{
				if(!target.visible)
				{
					this.clearFocus();
					break;
				}
				target = target.parent;
			}
			while(target);
		}

		/**
		 * @private
		 */
		protected function textEditor_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled || (!this._isEditable && !this._isSelectable))
			{
				this.touchPointID = -1;
				return;
			}
			if(this.touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this, null, this.touchPointID);
				var point:Point = Pool.getPoint();
				touch.getLocation(this, point);
				point.x += this._textSnapshotScrollX;
				this.selectRange(this._selectionAnchorIndex, this.getSelectionIndexAtPoint(point.x, point.y));
				Pool.putPoint(point);
				if(touch.phase == TouchPhase.ENDED)
				{
					this.touchPointID = -1;
				}
			}
			else //if we get here, we don't have a saved touch ID yet
			{
				touch = event.getTouch(this, TouchPhase.BEGAN);
				if(!touch)
				{
					return;
				}
				if(touch.tapCount == 2)
				{
					var start:int = TextInputNavigation.findCurrentWordStartIndex(this._text, this._selectionBeginIndex);
					var end:int = TextInputNavigation.findCurrentWordEndIndex(this._text, this._selectionEndIndex);
					this.selectRange(start, end);
					return;
				}
				else if(touch.tapCount > 2)
				{
					this.selectRange(0, this._text.length);
					return;
				}
				this.touchPointID = touch.id;
				point = Pool.getPoint();
				touch.getLocation(this, point);
				point.x += this._textSnapshotScrollX;
				if(event.shiftKey)
				{
					if(this._selectionAnchorIndex < 0)
					{
						this._selectionAnchorIndex = this._selectionBeginIndex;
					}
					this.selectRange(this._selectionAnchorIndex, this.getSelectionIndexAtPoint(point.x, point.y));
				}
				else
				{
					this.setFocus(point);
				}
				Pool.putPoint(point);
			}
		}

		/**
		 * @private
		 */
		protected function stage_touchHandler(event:TouchEvent):void
		{
			if(FocusManager.isEnabledForStage(this.stage))
			{
				//let the focus manager handle clearing focus
				return;
			}
			var touch:Touch = event.getTouch(this.stage, TouchPhase.BEGAN);
			if(!touch) //we only care about began touches
			{
				return;
			}
			var point:Point = Pool.getPoint();
			touch.getLocation(this.stage, point);
			var isInBounds:Boolean = this.contains(this.stage.hitTest(point));
			Pool.putPoint(point);
			if(isInBounds) //if the touch is in the text editor, it's all good
			{
				return;
			}
			//if the touch begins anywhere else, it's a focus out!
			this.clearFocus();
		}

		/**
		 * @private
		 */
		protected function stage_keyDownHandler(event:KeyboardEvent):void
		{
			if(!this._isEnabled || (!this._isEditable && !this._isSelectable) ||
				this.touchPointID >= 0 || event.isDefaultPrevented())
			{
				return;
			}
			//ignore select all, cut, copy, and paste
			var charCode:uint = event.charCode;
			if(event.ctrlKey && (charCode == 97 || charCode == 99 || charCode == 118 || charCode == 120)) //a, c, p, and x
			{
				return;
			}
			var newIndex:int = -1;
			if(!FocusManager.isEnabledForStage(this.stage) && event.keyCode == Keyboard.TAB)
			{
				this.clearFocus();
				return;
			}
			else if(event.keyCode == Keyboard.HOME || event.keyCode == Keyboard.UP)
			{
				newIndex = 0;
				if(event.shiftKey)
				{
					this.selectRange(newIndex, this._selectionAnchorIndex);
					return;
				}
			}
			else if(event.keyCode == Keyboard.END || event.keyCode == Keyboard.DOWN)
			{
				newIndex = this._text.length;
				if(event.shiftKey)
				{
					this.selectRange(this._selectionAnchorIndex, newIndex);
					return;
				}
			}
			else if(event.keyCode == Keyboard.LEFT)
			{
				if(event.shiftKey)
				{
					if(this._selectionAnchorIndex >= 0 && this._selectionAnchorIndex == this._selectionBeginIndex &&
						this._selectionBeginIndex != this._selectionEndIndex)
					{
						newIndex = this._selectionEndIndex - 1;
						this.selectRange(this._selectionBeginIndex, newIndex);
					}
					else
					{
						newIndex = this._selectionBeginIndex - 1;
						if(newIndex < 0)
						{
							newIndex = 0;
						}
						this.selectRange(newIndex, this._selectionEndIndex);
					}
					return;
				}
				else if(this._selectionBeginIndex != this._selectionEndIndex)
				{
					newIndex = this._selectionBeginIndex;
				}
				else
				{
					if(event.altKey || event.ctrlKey)
					{
						newIndex = TextInputNavigation.findPreviousWordStartIndex(this._text, this._selectionBeginIndex);
					}
					else
					{
						newIndex = this._selectionBeginIndex - 1;
					}
					if(newIndex < 0)
					{
						newIndex = 0;
					}
				}
			}
			else if(event.keyCode == Keyboard.RIGHT)
			{
				if(event.shiftKey)
				{
					if(this._selectionAnchorIndex >= 0 && this._selectionAnchorIndex == this._selectionEndIndex &&
						this._selectionBeginIndex != this._selectionEndIndex)
					{
						newIndex = this._selectionBeginIndex + 1;
						this.selectRange(newIndex, this._selectionEndIndex);
					}
					else
					{
						newIndex = this._selectionEndIndex + 1;
						if(newIndex < 0 || newIndex > this._text.length)
						{
							newIndex = this._text.length;
						}
						this.selectRange(this._selectionBeginIndex, newIndex);
					}
					return;
				}
				else if(this._selectionBeginIndex != this._selectionEndIndex)
				{
					newIndex = this._selectionEndIndex;
				}
				else
				{
					if(event.altKey || event.ctrlKey)
					{
						newIndex = TextInputNavigation.findNextWordStartIndex(this._text, this._selectionEndIndex);
					}
					else
					{
						newIndex = this._selectionEndIndex + 1;
					}
					if(newIndex < 0 || newIndex > this._text.length)
					{
						newIndex = this._text.length;
					}
				}
			}
			if(newIndex < 0)
			{
				if(event.keyCode == Keyboard.ENTER)
				{
					this.dispatchEventWith(FeathersEventType.ENTER);
					return;
				}
				//everything after this point edits the text, so return if the text
				//editor isn't editable.
				if(!this._isEditable)
				{
					return;
				}
				var currentValue:String = this._text;
				if(this._displayAsPassword)
				{
					currentValue = this._unmaskedText;
				}
				if(event.keyCode == Keyboard.DELETE)
				{
					if(event.altKey || event.ctrlKey)
					{
						var nextWordStartIndex:int = TextInputNavigation.findNextWordStartIndex(this._text, this._selectionEndIndex);
						this.text = currentValue.substr(0, this._selectionBeginIndex) + currentValue.substr(nextWordStartIndex);
					}
					else if(this._selectionBeginIndex != this._selectionEndIndex)
					{
						this.deleteSelectedText();
					}
					else if(this._selectionEndIndex < currentValue.length)
					{
						this.text = currentValue.substr(0, this._selectionBeginIndex) + currentValue.substr(this._selectionEndIndex + 1);
					}
				}
				else if(event.keyCode == Keyboard.BACKSPACE)
				{
					if(event.altKey || event.ctrlKey)
					{
						newIndex = TextInputNavigation.findPreviousWordStartIndex(this._text, this._selectionBeginIndex);
						this.text = currentValue.substr(0, newIndex) + currentValue.substr(this._selectionEndIndex);
					}
					else if(this._selectionBeginIndex != this._selectionEndIndex)
					{
						this.deleteSelectedText();
					}
					else if(this._selectionBeginIndex > 0)
					{
						newIndex = this._selectionBeginIndex - 1;
						this.text = currentValue.substr(0, this._selectionBeginIndex - 1) + currentValue.substr(this._selectionEndIndex);
					}
				}
			}
			if(newIndex >= 0)
			{
				this.validate();
				this.selectRange(newIndex, newIndex);
			}
		}

		/**
		 * @private
		 */
		protected function nativeFocus_textInputHandler(event:TextEvent):void
		{
			if(this._ignoreNextTextInputEvent)
			{
				this._ignoreNextTextInputEvent = false;
				return;
			}
			if(!this._isEditable || !this._isEnabled)
			{
				return;
			}
			this._imeText = null;
			this._imeCursorIndex = -1;
			var text:String = event.text;
			if(text === CARRIAGE_RETURN || text === LINE_FEED)
			{
				//ignore new lines
				return;
			}
			var charCode:int = text.charCodeAt(0);
			if(!this._restrict || this._restrict.isCharacterAllowed(charCode))
			{
				this.replaceSelectedText(text);
			}
		}

		/**
		 * @private
		 */
		protected function nativeFocus_selectAllHandler(event:flash.events.Event):void
		{
			if(!this._isEnabled || (!this._isEditable && !this._isSelectable))
			{
				return;
			}
			this._selectionAnchorIndex = 0;
			this.selectRange(0, this._text.length);
		}

		/**
		 * @private
		 */
		protected function nativeFocus_cutHandler(event:flash.events.Event):void
		{
			if(!this._isEnabled || (!this._isEditable && !this._isSelectable) ||
				this._selectionBeginIndex == this._selectionEndIndex || this._displayAsPassword)
			{
				return;
			}
			Clipboard.generalClipboard.setData(ClipboardFormats.TEXT_FORMAT, this.getSelectedText());
			if(!this._isEditable)
			{
				return;
			}
			this.deleteSelectedText();
		}

		/**
		 * @private
		 */
		protected function nativeFocus_copyHandler(event:flash.events.Event):void
		{
			if(!this._isEnabled || (!this._isEditable && !this._isSelectable) ||
				this._selectionBeginIndex == this._selectionEndIndex || this._displayAsPassword)
			{
				return;
			}
			Clipboard.generalClipboard.setData(ClipboardFormats.TEXT_FORMAT, this.getSelectedText());
		}

		/**
		 * @private
		 */
		protected function nativeFocus_pasteHandler(event:flash.events.Event):void
		{
			if(!this._isEditable || !this._isEnabled)
			{
				return;
			}
			var pastedText:String = Clipboard.generalClipboard.getData(ClipboardFormats.TEXT_FORMAT) as String;
			if(pastedText === null)
			{
				//the clipboard doesn't contain any text to paste
				return;
			}
			//new lines are not allowed
			pastedText = pastedText.replace(/[\n\r]/g, "");
			if(this._restrict)
			{
				pastedText = this._restrict.filterText(pastedText);
			}
			this.replaceSelectedText(pastedText);
		}
	}
}


================================================
FILE: source/feathers/controls/text/TextBlockTextRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.text
{
	import feathers.core.IFeathersControl;
	import feathers.core.ITextRenderer;
	import feathers.core.IToggle;
	import feathers.layout.HorizontalAlign;
	import feathers.skins.IStyleProvider;
	import feathers.utils.geom.matrixToScaleX;
	import feathers.utils.geom.matrixToScaleY;
	import feathers.utils.textures.calculateSnapshotTextureDimensions;

	import flash.display.BitmapData;
	import flash.display.DisplayObjectContainer;
	import flash.display.Sprite;
	import flash.display3D.Context3DProfile;
	import flash.filters.BitmapFilter;
	import flash.geom.Matrix;
	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.text.FontType;
	import flash.text.engine.ContentElement;
	import flash.text.engine.ElementFormat;
	import flash.text.engine.FontDescription;
	import flash.text.engine.FontLookup;
	import flash.text.engine.FontPosture;
	import flash.text.engine.FontWeight;
	import flash.text.engine.Kerning;
	import flash.text.engine.SpaceJustifier;
	import flash.text.engine.TabStop;
	import flash.text.engine.TextBaseline;
	import flash.text.engine.TextBlock;
	import flash.text.engine.TextElement;
	import flash.text.engine.TextJustifier;
	import flash.text.engine.TextLine;
	import flash.text.engine.TextRotation;

	import starling.core.Starling;
	import starling.display.Image;
	import starling.rendering.Painter;
	import starling.text.TextFormat;
	import starling.textures.ConcreteTexture;
	import starling.textures.Texture;
	import starling.utils.Align;
	import starling.utils.MathUtil;
	import starling.utils.Pool;
	import starling.utils.SystemUtil;

	/**
	 * Renders text with a native <code>flash.text.engine.TextBlock</code> from
	 * <a href="http://help.adobe.com/en_US/as3/dev/WS9dd7ed846a005b294b857bfa122bd808ea6-8000.html" target="_top">Flash Text Engine</a>
	 * (sometimes abbreviated as FTE), and draws it to <code>BitmapData</code>
	 * before uploading it to a texture on the GPU. Textures are managed
	 * internally by this component, and they will be automatically disposed
	 * when the component is disposed.
	 *
	 * <p>For longer passages of text, this component will stitch together
	 * multiple individual textures both horizontally and vertically, as a grid,
	 * if required. This may require quite a lot of texture memory, possibly
	 * exceeding the limits of some mobile devices, so use this component with
	 * caution when displaying a lot of text.</p>
	 *
	 * <p>The following example shows how to use
	 * <code>TextBlockTextRenderer</code> with a <code>Label</code>:</p>
	 *
	 * <listing version="3.0">
	 * var label:Label = new Label();
	 * label.text = "I am the very model of a modern Major General";
	 * label.textRendererFactory = function():ITextRenderer
	 * {
	 *     return new TextBlockTextRenderer();
	 * };
	 * this.addChild( label );</listing>
	 *
	 * <strong>Embedding Fonts</strong>
	 *
	 * <p>This text renderer supports embedded TrueType or OpenType fonts.</p>
	 *
	 * <p>In the following example, a TrueType font is included with
	 * <code>[Embed]</code> metadata:</p>
	 *
	 * <listing version="3.0">
	 * [Embed(source="path/to/font.ttf",fontFamily="MyCustomFont",fontWeight="normal",fontStyle="normal",mimeType="application/x-font",embedAsCFF="true")]
	 * private static const MY_CUSTOM_FONT:Class;</listing>
	 *
	 * <p>The <code>source</code> field should point to the font file, relative
	 * to the current <code>.as</code> file that contains the metadata.</p>
	 *
	 * <p>Set the <code>fontFamily</code> field to the string value that you
	 * want to use when referencing this font in code. For example, you would
	 * use this name when you create a <code>starling.text.TextFormat</code>
	 * object. Replace "MyCustomFont" with an appropriate name for your font.</p>
	 *
	 * <p><strong>Tip:</strong> For best results, try not to set the exact same
	 * name in the <code>fontFamily</code> field as the name of device font
	 * installed on your system. Debugging embedded font issues can be
	 * frustrating when you see the correct font on your development computer,
	 * but it's a different font on other devices. If you use a font name that
	 * doesn't exist on your development computer, you'll see when something is
	 * wrong immediately, instead of discovering it later when you're testing
	 * on other devices.</p>
	 *
	 * <p>If the font is bold, set the <code>fontWeight</code> field to "bold".
	 * Otherwise, set it to "normal".</p>
	 *
	 * <p>If the font is italic, set the <code>fontStyle</code> field to
	 * "italic". Otherwise, set it to "normal".</p>
	 *
	 * <p>Since the text renderer is based on Flash Text Engine, you
	 * <strong>must</strong> set the <code>embedAsCFF</code> field to
	 * "true".</p>
	 *
	 * @see ../../../../help/text-renderers.html Introduction to Feathers text renderers
	 * @see ../../../../help/text-block-text-renderer.html How to use the Feathers TextBlockTextRenderer component
	 * @see http://help.adobe.com/en_US/as3/dev/WS9dd7ed846a005b294b857bfa122bd808ea6-8000.html Using the Flash Text Engine in ActionScript 3.0 Developer's Guide
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/TextBlock.html flash.text.engine.TextBlock
	 *
	 * @productversion Feathers 1.3.0
	 */
	public class TextBlockTextRenderer extends BaseTextRenderer implements ITextRenderer
	{
		/**
		 * @private
		 */
		private static const HELPER_POINT:Point = new Point();

		/**
		 * @private
		 */
		private static const HELPER_RESULT:MeasureTextResult = new MeasureTextResult();

		/**
		 * @private
		 */
		private static const HELPER_MATRIX:Matrix = new Matrix();

		/**
		 * @private
		 */
		private static var HELPER_TEXT_LINES:Vector.<TextLine> = new <TextLine>[];

		/**
		 * @private
		 * This is enforced by the runtime.
		 */
		protected static const MAX_TEXT_LINE_WIDTH:Number = 1000000;

		/**
		 * @private
		 */
		protected static const LINE_FEED:String = "\n";

		/**
		 * @private
		 */
		protected static const CARRIAGE_RETURN:String = "\r";

		/**
		 * @private
		 */
		protected static const FUZZY_TRUNCATION_DIFFERENCE:Number = 0.000001;

		/**
		 * The default <code>IStyleProvider</code> for all <code>TextBlockTextRenderer</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function TextBlockTextRenderer()
		{
			super();
			this.isQuickHitAreaEnabled = true;
		}

		/**
		 * The TextBlock instance used to render the text before taking a
		 * texture snapshot.
		 */
		protected var textBlock:TextBlock;

		/**
		 * An image that displays a snapshot of the native <code>TextBlock</code>
		 * in the Starling display list when the editor doesn't have focus.
		 */
		protected var textSnapshot:Image;

		/**
		 * If multiple snapshots are needed due to texture size limits, the
		 * snapshots appearing after the first are stored here.
		 */
		protected var textSnapshots:Vector.<Image>;

		/**
		 * @private
		 */
		protected var _textSnapshotScrollX:Number = 0;

		/**
		 * @private
		 */
		protected var _textSnapshotScrollY:Number = 0;

		/**
		 * @private
		 */
		protected var _textSnapshotOffsetX:Number = 0;

		/**
		 * @private
		 */
		protected var _textSnapshotOffsetY:Number = 0;

		/**
		 * @private
		 */
		protected var _textSnapshotNativeFiltersWidth:Number = 0;

		/**
		 * @private
		 */
		protected var _textSnapshotNativeFiltersHeight:Number = 0;

		/**
		 * @private
		 */
		protected var _lastGlobalScaleX:Number = 0;

		/**
		 * @private
		 */
		protected var _lastGlobalScaleY:Number = 0;

		/**
		 * @private
		 */
		protected var _lastGlobalContentScaleFactor:Number = 0;

		/**
		 * @private
		 */
		protected var _textLineContainer:Sprite;

		/**
		 * @private
		 */
		protected var _textLines:Vector.<TextLine> = new <TextLine>[];

		/**
		 * @private
		 */
		protected var _measurementTextLineContainer:Sprite;

		/**
		 * @private
		 */
		protected var _measurementTextLines:Vector.<TextLine> = new <TextLine>[];

		/**
		 * @private
		 */
		protected var _previousLayoutActualWidth:Number = NaN;

		/**
		 * @private
		 */
		protected var _previousLayoutActualHeight:Number = NaN;

		/**
		 * @private
		 */
		protected var _savedTextLinesWidth:Number = NaN;

		/**
		 * @private
		 */
		protected var _savedTextLinesHeight:Number = NaN;

		/**
		 * @private
		 */
		protected var _snapshotWidth:int = 0;

		/**
		 * @private
		 */
		protected var _snapshotHeight:int = 0;

		/**
		 * @private
		 */
		protected var _snapshotVisibleWidth:int = 0;

		/**
		 * @private
		 */
		protected var _snapshotVisibleHeight:int = 0;

		/**
		 * @private
		 */
		protected var _needsNewTexture:Boolean = false;

		/**
		 * @private
		 */
		protected var _needsTextureUpdate:Boolean = false;

		/**
		 * @private
		 */
		protected var _truncationOffset:int = 0;

		/**
		 * @private
		 */
		protected var _textElement:TextElement;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return TextBlockTextRenderer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		override public function set maxWidth(value:Number):void
		{
			//this is a special case because truncation may bypass normal rules
			//for determining if changing maxWidth should invalidate
			var needsInvalidate:Boolean = value > this._explicitMaxWidth && this._lastMeasurementWasTruncated;
			super.maxWidth = value;
			if(needsInvalidate)
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		/**
		 * @copy feathers.core.ITextRenderer#numLines
		 */
		public function get numLines():int
		{
			return this._textLines.length;
		}

		/**
		 * @private
		 */
		override public function set text(value:String):void
		{
			if(this._text == value)
			{
				return;
			}
			if(this._textElement === null)
			{
				this._textElement = new TextElement(value);
			}
			this.content = this._textElement;
			super.text = value;
		}

		/**
		 * @private
		 */
		protected var _content:ContentElement;

		/**
		 * Sets the contents of the <code>TextBlock</code> to a complex value
		 * that may contain graphics and text with multiple formats.
		 *
		 * <p>In the following example, the content is set to a
		 * <code>GroupElement</code> that contains text with multiple
		 * formats:</p>
		 *
		 * <listing version="3.0">
		 * var format1:ElementFormat = new ElementFormat(new FontDescription("_sans"), 20, 0x000000);
		 * var format2:ElementFormat = new ElementFormat(new FontDescription("_sans"), 20, 0xff0000);
		 * var format3:ElementFormat = new ElementFormat(new FontDescription("_sans", FontWeight.NORMAL, FontPosture.ITALIC), 20, 0x000000);
		 * var text1:TextElement = new TextElement("Different ", format1);
		 * var text2:TextElement = new TextElement("colors", format2);
		 * var text3:TextElement = new TextElement(" and ", format1);
		 * var text4:TextElement = new TextElement("styles", format3);
		 * var elements:Vector.&lt;ContentElement&gt; = new &lt;ContentElement&gt;[text1, text2, text3, text4];
		 * var group:GroupElement = new GroupElement(elements);
		 * 
		 * var textRenderer:TextBlockTextRenderer = new TextBlockTextRenderer();
		 * textRenderer.content = group;</listing>
		 *
		 * <p>In the following example, the content is set to a
		 * <code>GroupElement</code> that contains both text and a bitmap
		 * graphic:</p>
		 *
		 * <listing version="3.0">
		 * var format:ElementFormat = new ElementFormat(new FontDescription("_sans"), 20);
		 * var text:TextElement = new TextElement("Hi there! ", format);
		 * var bitmap:Bitmap = new EmbeddedBitmap(); //a bitmap included with [Embed]
		 * var graphic:GraphicElement = new GraphicElement(bitmap, bitmap.width, bitmap.height, format);
		 * var elements:Vector.&lt;ContentElement&gt; = new &lt;ContentElement&gt;[text, graphic];
		 * var group:GroupElement = new GroupElement(elements);
		 * 
		 * var textRenderer:TextBlockTextRenderer = new TextBlockTextRenderer();
		 * textRenderer.content = group;</listing>
		 *
		 * <p>Note: The <code>content</code> property cannot be used when the
		 * <code>TextBlockTextRenderer</code> receives its text from a parent
		 * component, such as a <code>Label</code> or a <code>Button</code>.</p>
		 *
		 * @default null
		 *
		 * @see #text
		 */
		public function get content():ContentElement
		{
			return this._content;
		}

		/**
		 * @private
		 */
		public function set content(value:ContentElement):void
		{
			if(this._content === value)
			{
				return;
			}
			if(value is TextElement)
			{
				this._textElement = TextElement(value);
			}
			else
			{
				this._textElement = null;
			}
			this._content = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * For debugging purposes, the current
		 * <code>flash.text.engine.ElementFormat</code> used to render the text.
		 * Updated during validation, and may be <code>null</code> before the
		 * first validation.
		 *
		 * <p>Do not modify this value. It is meant for testing and debugging
		 * only. Use the parent's <code>starling.text.TextFormat</code> font
		 * styles APIs instead.</p>
		 */
		public function get currentElementFormat():ElementFormat
		{
			if(this._textElement === null)
			{
				return null;
			}
			return this._textElement.elementFormat;
		}

		/**
		 * @private
		 */
		protected var _fontStylesElementFormat:ElementFormat;

		/**
		 * @private
		 */
		protected var _currentVerticalAlign:String;

		/**
		 * @private
		 */
		protected var _currentHorizontalAlign:String;

		/**
		 * @private
		 */
		protected var _verticalAlignOffsetY:Number = 0;

		/**
		 * @private
		 */
		protected var _elementFormatForState:Object;

		/**
		 * @private
		 */
		protected var _elementFormat:ElementFormat;

		/**
		 * Advanced font formatting used to draw the text, if
		 * <code>fontStyles</code> and <code>starling.text.TextFormat</code>
		 * cannot be used on the parent component because the full capabilities
		 * of Flash Text Engine are required.
		 *
		 * <p>In the following example, the element format is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.elementFormat = new ElementFormat( new FontDescription( "Source Sans Pro" ) );</listing>
		 *
		 * <p><strong>Warning:</strong> If this property is not
		 * <code>null</code>, any <code>starling.text.TextFormat</code> font
		 * styles that are passed in from the parent component may be ignored.
		 * In other words, advanced font styling with <code>ElementFormat</code>
		 * will always take precedence.</p>
		 *
		 * <p><strong>Warning:</strong> This property will be ignored if the
		 * <code>content</code> property is customized with Flash Text Engine
		 * rich text objects such as <code>GroupElement</code> and
		 * <code>GraphicElement</code>.</p>
		 *
		 * @default null
		 *
		 * @see #setElementFormatForState()
		 * @see #disabledElementFormat
		 * @see #selectedElementFormat
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/ElementFormat.html flash.text.engine.ElementFormat
		 */
		public function get elementFormat():ElementFormat
		{
			return this._elementFormat;
		}

		/**
		 * @private
		 */
		public function set elementFormat(value:ElementFormat):void
		{
			if(this._elementFormat == value)
			{
				return;
			}
			this._elementFormat = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _disabledElementFormat:ElementFormat;

		/**
		 * Advanced font formatting used to draw the text when the component
		 * is disabled, if <code>disabledFontStyles</code> and
		 * <code>starling.text.TextFormat</code> cannot be used on the parent
		 * component because the full capabilities of Flash Text Engine are
		 * required.
		 *
		 * <p>In the following example, the disabled element format is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.isEnabled = false;
		 * textRenderer.disabledElementFormat = new ElementFormat( new FontDescription( "Source Sans Pro" ) );</listing>
		 *
		 * <p><strong>Warning:</strong> If this property is not
		 * <code>null</code>, any <code>starling.text.TextFormat</code> font
		 * styles that are passed in from the parent component may be ignored.
		 * In other words, advanced font styling with <code>ElementFormat</code>
		 * will always take precedence.</p>
		 *
		 * <p><strong>Warning:</strong> This property will be ignored if the
		 * <code>content</code> property is customized with Flash Text Engine
		 * rich text objects such as <code>GroupElement</code> and
		 * <code>GraphicElement</code>.</p>
		 *
		 * @default null
		 *
		 * @see #elementFormat
		 * @see #selectedElementFormat
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/ElementFormat.html flash.text.engine.ElementFormat
		 */
		public function get disabledElementFormat():ElementFormat
		{
			return this._disabledElementFormat;
		}

		/**
		 * @private
		 */
		public function set disabledElementFormat(value:ElementFormat):void
		{
			if(this._disabledElementFormat == value)
			{
				return;
			}
			this._disabledElementFormat = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _selectedElementFormat:ElementFormat;

		/**
		 * Advanced font formatting used to draw the text when the
		 * <code>stateContext</code> is selected, if
		 * <code>selectedFontStyles</code> and
		 * <code>starling.text.TextFormat</code> cannot be used on the parent
		 * component because the full capabilities of Flash Text Engine are
		 * required.
		 *
		 * <p>In the following example, the selected element format is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.selectedElementFormat = new ElementFormat( new FontDescription( "Source Sans Pro" ) );</listing>
		 *
		 * <p><strong>Warning:</strong> If this property is not
		 * <code>null</code>, any <code>starling.text.TextFormat</code> font
		 * styles that are passed in from the parent component may be ignored.
		 * In other words, advanced font styling with <code>ElementFormat</code>
		 * will always take precedence.</p>
		 *
		 * <p><strong>Warning:</strong> This property will be ignored if the
		 * <code>content</code> property is customized with Flash Text Engine
		 * rich text objects such as <code>GroupElement</code> and
		 * <code>GraphicElement</code>.</p>
		 *
		 * @default null
		 *
		 * @see #stateContext
		 * @see feathers.core.IToggle
		 * @see #elementFormat
		 * @see #disabledElementFormat
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/ElementFormat.html flash.text.engine.ElementFormat
		 */
		public function get selectedElementFormat():ElementFormat
		{
			return this._selectedElementFormat;
		}

		/**
		 * @private
		 */
		public function set selectedElementFormat(value:ElementFormat):void
		{
			if(this._selectedElementFormat == value)
			{
				return;
			}
			this._selectedElementFormat = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _currentLeading:Number = 0;

		/**
		 * @private
		 */
		protected var _leading:Number = NaN;

		/**
		 * The amount of vertical space, in pixels, between lines.
		 *
		 * <p>If <code>leading</code> is <code>NaN</code> the leading from the
		 * <code>starling.text.TextFormat</code> font styles may be used. If no
		 * <code>starling.text.TextFormat</code> font styles have been provided
		 * by the parent component, the leading will default to <code>0</code>.</p>
		 *
		 * <p>In the following example, the leading is changed to 20 pixels:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.leading = 20;</listing>
		 *
		 * @default NaN
		 */
		public function get leading():Number
		{
			return this._leading;
		}

		/**
		 * @private
		 */
		public function set leading(value:Number):void
		{
			if(this._leading == value)
			{
				return;
			}
			this._leading = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _textAlign:String = null;

		/**
		 * The alignment of the text. For justified text, see the
		 * <code>textJustifier</code> property.
		 *
		 * <p>If <code>textAlign</code> is <code>null</code> the horizontal
		 * alignment from the <code>starling.text.TextFormat</code> font styles
		 * may be used. If no <code>starling.text.TextFormat</code> font styles
		 * have been provided by the parent component, the alignment will
		 * default to <code>HorizontalAlign.LEFT</code>.</p>
		 *
		 * <p>In the following example, the text alignment is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.textAlign = HorizontalAlign.CENTER;</listing>
		 *
		 * @default null
		 *
		 * @see feathers.layout.HorizontalAlign#LEFT
		 * @see feathers.layout.HorizontalAlign#CENTER
		 * @see feathers.layout.HorizontalAlign#RIGHT
		 * @see #textJustifier
		 */
		public function get textAlign():String
		{
			return this._textAlign;
		}

		/**
		 * @private
		 */
		public function set textAlign(value:String):void
		{
			if(this._textAlign == value)
			{
				return;
			}
			this._textAlign = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @inheritDoc
		 */
		public function get baseline():Number
		{
			if(this._textLines.length == 0)
			{
				return 0;
			}
			return this.calculateLineAscent(this._textLines[0]);
		}

		/**
		 * @private
		 */
		protected var _applyNonLinearFontScaling:Boolean = true;

		/**
		 * Specifies that you want to enhance screen appearance at the expense
		 * of what-you-see-is-what-you-get (WYSIWYG) print fidelity.
		 *
		 * <p>In the following example, this property is changed to false:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.applyNonLinearFontScaling = false;</listing>
		 *
		 * @default true
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/TextBlock.html#applyNonLinearFontScaling Full description of flash.text.engine.TextBlock.applyNonLinearFontScaling in Adobe's Flash Platform API Reference
		 */
		public function get applyNonLinearFontScaling():Boolean
		{
			return this._applyNonLinearFontScaling;
		}

		/**
		 * @private
		 */
		public function set applyNonLinearFontScaling(value:Boolean):void
		{
			if(this._applyNonLinearFontScaling == value)
			{
				return;
			}
			this._applyNonLinearFontScaling = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _baselineFontDescription:FontDescription;

		/**
		 * The font used to determine the baselines for all the lines created from the block, independent of their content.
		 *
		 * <p>In the following example, the baseline font description is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.baselineFontDescription = new FontDescription( "Source Sans Pro", FontWeight.BOLD );</listing>
		 *
		 * @default null
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/TextBlock.html#baselineFontDescription Full description of flash.text.engine.TextBlock.baselineFontDescription in Adobe's Flash Platform API Reference
		 * @see #baselineFontSize
		 */
		public function get baselineFontDescription():FontDescription
		{
			return this._baselineFontDescription;
		}

		/**
		 * @private
		 */
		public function set baselineFontDescription(value:FontDescription):void
		{
			if(this._baselineFontDescription == value)
			{
				return;
			}
			this._baselineFontDescription = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _baselineFontSize:Number = 12;

		/**
		 * The font size used to calculate the baselines for the lines created
		 * from the block.
		 *
		 * <p>In the following example, the baseline font size is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.baselineFontSize = 20;</listing>
		 *
		 * @default 12
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/TextBlock.html#baselineFontSize Full description of flash.text.engine.TextBlock.baselineFontSize in Adobe's Flash Platform API Reference
		 * @see #baselineFontDescription
		 */
		public function get baselineFontSize():Number
		{
			return this._baselineFontSize;
		}

		/**
		 * @private
		 */
		public function set baselineFontSize(value:Number):void
		{
			if(this._baselineFontSize == value)
			{
				return;
			}
			this._baselineFontSize = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _baselineZero:String = TextBaseline.ROMAN;

		/**
		 * Specifies which baseline is at y=0 for lines created from this block.
		 *
		 * <p>In the following example, the baseline zero is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.baselineZero = TextBaseline.ASCENT;</listing>
		 *
		 * @default TextBaseline.ROMAN
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/TextBlock.html#baselineZero Full description of flash.text.engine.TextBlock.baselineZero in Adobe's Flash Platform API Reference
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/TextBaseline.html flash.text.engine.TextBaseline
		 */
		public function get baselineZero():String
		{
			return this._baselineZero;
		}

		/**
		 * @private
		 */
		public function set baselineZero(value:String):void
		{
			if(this._baselineZero == value)
			{
				return;
			}
			this._baselineZero = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _bidiLevel:int = 0;

		/**
		 * Specifies the bidirectional paragraph embedding level of the text
		 * block.
		 *
		 * <p>In the following example, the bidi level is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.bidiLevel = 1;</listing>
		 *
		 * @default 0
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/TextBlock.html#bidiLevel Full description of flash.text.engine.TextBlock.bidiLevel in Adobe's Flash Platform API Reference
		 */
		public function get bidiLevel():int
		{
			return this._bidiLevel;
		}

		/**
		 * @private
		 */
		public function set bidiLevel(value:int):void
		{
			if(this._bidiLevel == value)
			{
				return;
			}
			this._bidiLevel = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _lineRotation:String = TextRotation.ROTATE_0;

		/**
		 * Rotates the text lines in the text block as a unit.
		 *
		 * <p>In the following example, the line rotation is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.lineRotation = TextRotation.ROTATE_90;</listing>
		 *
		 * @default TextRotation.ROTATE_0
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/TextBlock.html#lineRotation Full description of flash.text.engine.TextBlock.lineRotation in Adobe's Flash Platform API Reference
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/TextRotation.html flash.text.engine.TextRotation
		 */
		public function get lineRotation():String
		{
			return this._lineRotation;
		}

		/**
		 * @private
		 */
		public function set lineRotation(value:String):void
		{
			if(this._lineRotation == value)
			{
				return;
			}
			this._lineRotation = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _tabStops:Vector.<TabStop>;

		/**
		 * Specifies the tab stops for the text in the text block, in the form
		 * of a <code>Vector</code> of <code>TabStop</code> objects.
		 *
		 * <p>In the following example, the tab stops changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.tabStops = new &lt;TabStop&gt;[ new TabStop( TabAlignment.CENTER ) ];</listing>
		 *
		 * @default null
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/TextBlock.html#tabStops Full description of flash.text.engine.TextBlock.tabStops in Adobe's Flash Platform API Reference
		 */
		public function get tabStops():Vector.<TabStop>
		{
			return this._tabStops;
		}

		/**
		 * @private
		 */
		public function set tabStops(value:Vector.<TabStop>):void
		{
			if(this._tabStops == value)
			{
				return;
			}
			this._tabStops = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _textJustifier:TextJustifier = new SpaceJustifier();

		/**
		 * Specifies the <code>TextJustifier</code> to use during line creation.
		 *
		 * <p>In the following example, the text justifier is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.textJustifier = new SpaceJustifier( "en", LineJustification.ALL_BUT_LAST );</listing>
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/TextBlock.html#textJustifier Full description of flash.text.engine.TextBlock.textJustifier in Adobe's Flash Platform API Reference
		 */
		public function get textJustifier():TextJustifier
		{
			return this._textJustifier;
		}

		/**
		 * @private
		 */
		public function set textJustifier(value:TextJustifier):void
		{
			if(this._textJustifier == value)
			{
				return;
			}
			this._textJustifier = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _userData:*;

		/**
		 * Provides a way for the application to associate arbitrary data with
		 * the text block.
		 *
		 * <p>In the following example, the user data is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.userData = { author: "William Shakespeare", title: "Much Ado About Nothing" };</listing>
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/TextBlock.html#userData Full description of flash.text.engine.TextBlock.userData in Adobe's Flash Platform API Reference
		 */
		public function get userData():*
		{
			return this._userData;
		}

		/**
		 * @private
		 */
		public function set userData(value:*):void
		{
			if(this._userData === value)
			{
				return;
			}
			this._userData = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _pixelSnapping:Boolean = true;

		/**
		 * Determines if the text should be snapped to the nearest whole pixel
		 * when rendered. When this is <code>false</code>, text may be displayed
		 * on sub-pixels, which often results in blurred rendering due to
		 * texture smoothing.
		 *
		 * <p>In the following example, the text is not snapped to pixels:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.pixelSnapping = false;</listing>
		 *
		 * @default true
		 */
		public function get pixelSnapping():Boolean
		{
			return this._pixelSnapping;
		}

		/**
		 * @private
		 */
		public function set pixelSnapping(value:Boolean):void
		{
			if(this._pixelSnapping === value)
			{
				return;
			}
			this._pixelSnapping = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _maxTextureDimensions:int = 2048;

		/**
		 * The maximum size of individual textures that are managed by this text
		 * renderer. Must be a power of 2. A larger value will create fewer
		 * individual textures, but a smaller value may use less overall texture
		 * memory by incrementing over smaller powers of two.
		 *
		 * <p>In the following example, the maximum size of the textures is
		 * changed:</p>
		 *
		 * <listing version="3.0">
		 * renderer.maxTextureDimensions = 4096;</listing>
		 *
		 * @default 2048
		 */
		public function get maxTextureDimensions():int
		{
			return this._maxTextureDimensions;
		}

		/**
		 * @private
		 */
		public function set maxTextureDimensions(value:int):void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			//check if we can use rectangle textures or not
			if(starling.profile === Context3DProfile.BASELINE_CONSTRAINED)
			{
				value = MathUtil.getNextPowerOfTwo(value);
			}
			if(this._maxTextureDimensions == value)
			{
				return;
			}
			this._maxTextureDimensions = value;
			this._needsNewTexture = true;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _nativeFilters:Array;

		/**
		 * Native filters to pass to the <code>flash.text.engine.TextLine</code>
		 * instances before creating the texture snapshot.
		 *
		 * <p>In the following example, the native filters are changed:</p>
		 *
		 * <listing version="3.0">
		 * renderer.nativeFilters = [ new GlowFilter() ];</listing>
		 *
		 * @default null
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/display/DisplayObject.html#filters Full description of flash.display.DisplayObject.filters in Adobe's Flash Platform API Reference
		 */
		public function get nativeFilters():Array
		{
			return this._nativeFilters;
		}

		/**
		 * @private
		 */
		public function set nativeFilters(value:Array):void
		{
			if(this._nativeFilters == value)
			{
				return;
			}
			this._nativeFilters = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _truncationText:String = "...";

		/**
		 * The text to display at the end of the label if it is truncated.
		 *
		 * <p>In the following example, the truncation text is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.truncationText = " [more]";</listing>
		 *
		 * @default "..."
		 *
		 * @see #truncateToFit
		 */
		public function get truncationText():String
		{
			return _truncationText;
		}

		/**
		 * @private
		 */
		public function set truncationText(value:String):void
		{
			if(this._truncationText == value)
			{
				return;
			}
			this._truncationText = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _truncateToFit:Boolean = true;

		/**
		 * If word wrap is disabled, and the text is longer than the width of
		 * the label, the text may be truncated using <code>truncationText</code>.
		 *
		 * <p>This feature may be disabled to improve performance.</p>
		 *
		 * <p>This feature only works when the <code>text</code> property is
		 * set to a string value. If the <code>content</code> property is set
		 * instead, then the content will not be truncated.</p>
		 *
		 * <p>This feature does not currently support the truncation of text
		 * displayed on multiple lines.</p>
		 *
		 * <p>In the following example, truncation is disabled:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.truncateToFit = false;</listing>
		 *
		 * @default true
		 *
		 * @see #truncationText
		 */
		public function get truncateToFit():Boolean
		{
			return _truncateToFit;
		}

		/**
		 * @private
		 */
		public function set truncateToFit(value:Boolean):void
		{
			if(this._truncateToFit == value)
			{
				return;
			}
			this._truncateToFit = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _updateSnapshotOnScaleChange:Boolean = false;

		/**
		 * Refreshes the texture snapshot every time that the text renderer is
		 * scaled. Based on the scale in global coordinates, so scaling the
		 * parent will require a new snapshot.
		 *
		 * <p>Warning: setting this property to true may result in reduced
		 * performance because every change of the scale requires uploading a
		 * new texture to the GPU. Use with caution. Consider setting this
		 * property to false temporarily during animations that modify the
		 * scale.</p>
		 *
		 * <p>In the following example, the snapshot will be updated when the
		 * text renderer is scaled:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.updateSnapshotOnScaleChange = true;</listing>
		 *
		 * @default false
		 */
		public function get updateSnapshotOnScaleChange():Boolean
		{
			return this._updateSnapshotOnScaleChange;
		}

		/**
		 * @private
		 */
		public function set updateSnapshotOnScaleChange(value:Boolean):void
		{
			if(this._updateSnapshotOnScaleChange == value)
			{
				return;
			}
			this._updateSnapshotOnScaleChange = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _lastMeasurementWidth:Number = 0;

		/**
		 * @private
		 */
		protected var _lastMeasurementHeight:Number = 0;

		/**
		 * @private
		 */
		protected var _lastMeasurementWasTruncated:Boolean = false;

		/**
		 * @private
		 */
		protected var _textBlockChanged:Boolean = true;

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this.textSnapshot)
			{
				this.textSnapshot.texture.dispose();
				this.removeChild(this.textSnapshot, true);
				this.textSnapshot = null;
			}
			if(this.textSnapshots)
			{
				var snapshotCount:int = this.textSnapshots.length;
				for(var i:int = 0; i < snapshotCount; i++)
				{
					var snapshot:Image = this.textSnapshots[i];
					snapshot.texture.dispose();
					this.removeChild(snapshot, true);
				}
				this.textSnapshots = null;
			}
			//this isn't necessary, but if a memory leak keeps the text renderer
			//from being garbage collected, freeing up these things may help
			//ease memory pressure from native filters and other expensive stuff
			this.textBlock = null;
			this._textLineContainer = null;
			this._textLines = null;
			this._measurementTextLineContainer = null;
			this._measurementTextLines = null;
			this._textElement = null;
			this._content = null;

			this._previousLayoutActualWidth = NaN;
			this._previousLayoutActualHeight = NaN;

			this._needsNewTexture = false;
			this._snapshotWidth = 0;
			this._snapshotHeight = 0;

			super.dispose();
		}

		/**
		 * @private
		 */
		override public function render(painter:Painter):void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			if(this._updateSnapshotOnScaleChange)
			{
				this.getTransformationMatrix(this.stage, HELPER_MATRIX);
				var globalScaleX:Number = matrixToScaleX(HELPER_MATRIX);
				var globalScaleY:Number = matrixToScaleY(HELPER_MATRIX);
				if(globalScaleX != this._lastGlobalScaleX ||
					globalScaleY != this._lastGlobalScaleY ||
					starling.contentScaleFactor != this._lastGlobalContentScaleFactor)
				{
					//the snapshot needs to be updated because the scale has
					//changed since the last snapshot was taken.
					this.invalidate(INVALIDATION_FLAG_SIZE);
					this.validate();
				}
			}
			if(this._needsTextureUpdate)
			{
				this._needsTextureUpdate = false;
				if(this._content !== null)
				{
					this.refreshSnapshot();
				}
			}
			if(this.textSnapshot !== null)
			{
				var scaleFactor:Number = starling.contentScaleFactor;
				if(!this._nativeFilters || this._nativeFilters.length == 0)
				{
					var offsetX:Number = 0;
					var offsetY:Number = 0;
				}
				else
				{
					offsetX = this._textSnapshotOffsetX / scaleFactor;
					offsetY = this._textSnapshotOffsetY / scaleFactor;
				}
				offsetY += this._verticalAlignOffsetY * scaleFactor;

				var snapshotIndex:int = -1;
				var totalBitmapWidth:Number = this._snapshotWidth;
				var totalBitmapHeight:Number = this._snapshotHeight;
				var xPosition:Number = offsetX;
				var yPosition:Number = offsetY;
				do
				{
					var currentBitmapWidth:Number = totalBitmapWidth;
					if(currentBitmapWidth > this._maxTextureDimensions)
					{
						currentBitmapWidth = this._maxTextureDimensions;
					}
					do
					{
						var currentBitmapHeight:Number = totalBitmapHeight;
						if(currentBitmapHeight > this._maxTextureDimensions)
						{
							currentBitmapHeight = this._maxTextureDimensions;
						}
						if(snapshotIndex < 0)
						{
							var snapshot:Image = this.textSnapshot;
							snapshot.visible = this._snapshotWidth > 0 && this._snapshotHeight > 0 && this._content !== null;
						}
						else
						{
							snapshot = this.textSnapshots[snapshotIndex];
						}
						snapshot.pixelSnapping = this._pixelSnapping;
						snapshot.x = xPosition / scaleFactor;
						snapshot.y = yPosition / scaleFactor;
						snapshotIndex++;
						yPosition += currentBitmapHeight;
						totalBitmapHeight -= currentBitmapHeight;
					}
					while(totalBitmapHeight > 0);
					xPosition += currentBitmapWidth;
					totalBitmapWidth -= currentBitmapWidth;
					yPosition = offsetY;
					totalBitmapHeight = this._snapshotHeight;
				}
				while(totalBitmapWidth > 0);
			}
			super.render(painter);
		}

		/**
		 * @inheritDoc
		 */
		public function measureText(result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}

			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			if(!needsWidth && !needsHeight)
			{
				result.x = this._explicitWidth;
				result.y = this._explicitHeight;
				return result;
			}

			//if a parent component validates before we're added to the stage,
			//measureText() may be called before initialization, so we need to
			//force it.
			if(!this._isInitialized)
			{
				this.initializeNow();
			}

			this.commit();

			result = this.measure(result);

			return result;
		}

		/**
		 * Gets the advanced <code>ElementFormat</code> font formatting passed
		 * in using <code>setElementFormatForState()</code> for the specified
		 * state.
		 *
		 * <p>If an <code>ElementFormat</code> is not defined for a specific
		 * state, returns <code>null</code>.</p>
		 *
		 * @see #setElementFormatForState()
		 */
		public function getElementFormatForState(state:String):ElementFormat
		{
			if(this._elementFormatForState === null)
			{
				return null;
			}
			return ElementFormat(this._elementFormatForState[state]);
		}

		/**
		 * Sets the advanced <code>ElementFormat</code> font formatting to be
		 * used by the text renderer when the <code>currentState</code> property
		 * of the <code>stateContext</code> matches the specified state value.
		 * For advanced use cases where <code>starling.text.TextFormat</code>
		 * cannot be used on the parent component because the full capabilities
		 * of Flash Text Engine are required.
		 *
		 * <p>If an <code>ElementFormat</code> is not defined for a specific
		 * state, the value of the <code>elementFormat</code> property will be
		 * used instead.</p>
		 *
		 * <p>If the <code>disabledElementFormat</code> property is not
		 * <code>null</code> and the <code>isEnabled</code> property is
		 * <code>false</code>, all other element formats will be ignored.</p>
		 *
		 * @see #stateContext
		 * @see #elementFormat
		 */
		public function setElementFormatForState(state:String, elementFormat:ElementFormat):void
		{
			if(elementFormat)
			{
				if(!this._elementFormatForState)
				{
					this._elementFormatForState = {};
				}
				this._elementFormatForState[state] = elementFormat;
			}
			else
			{
				delete this._elementFormatForState[state];
			}
			//if the context's current state is the state that we're modifying,
			//we need to use the new value immediately.
			if(this._stateContext && this._stateContext.currentState === state)
			{
				this.invalidate(INVALIDATION_FLAG_STATE);
			}
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(!this.textBlock)
			{
				this.textBlock = new TextBlock();
			}
			if(!this._textLineContainer)
			{
				this._textLineContainer = new Sprite();
			}
			if(!this._measurementTextLineContainer)
			{
				this._measurementTextLineContainer = new Sprite();
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);

			this.commit();

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			this.layout(sizeInvalid);
		}

		/**
		 * @private
		 */
		protected function commit():void
		{
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);

			if(dataInvalid || stylesInvalid || stateInvalid)
			{
				this.refreshElementFormat();
			}

			if(stylesInvalid)
			{
				this._textBlockChanged = true;
				this.textBlock.applyNonLinearFontScaling = this._applyNonLinearFontScaling;
				this.textBlock.baselineFontDescription = this._baselineFontDescription;
				this.textBlock.baselineFontSize = this._baselineFontSize;
				this.textBlock.baselineZero = this._baselineZero;
				this.textBlock.bidiLevel = this._bidiLevel;
				this.textBlock.lineRotation = this._lineRotation;
				this.textBlock.tabStops = this._tabStops;
				this.textBlock.textJustifier = this._textJustifier;
				this.textBlock.userData = this._userData;

				this._textLineContainer.filters = this._nativeFilters;
			}

			if(dataInvalid)
			{
				this._textBlockChanged = true;
				this.textBlock.content = this._content;
			}
		}

		/**
		 * @private
		 */
		protected function measure(result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}

			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var newWidth:Number = this._explicitWidth;
			var newHeight:Number = this._explicitHeight;
			if(needsWidth)
			{
				newWidth = this._explicitMaxWidth;
			}
			if(needsHeight)
			{
				newHeight = this._explicitMaxHeight;
			}

			//sometimes, we can determine that the dimensions will be exactly
			//the same without needing to refresh the text lines. this will
			//result in much better performance.
			if(this._wordWrap)
			{
				//when word wrapped, we need to measure again any time that the
				//width changes.
				var needsMeasurement:Boolean = newWidth != this._lastMeasurementWidth;
			}
			else
			{
				//we can skip measuring again more frequently when the text is
				//a single line.

				//if the width is smaller than the last layout width, we need to
				//measure again. when it's larger, the result won't change...
				needsMeasurement = newWidth < this._lastMeasurementWidth;

				//...unless the text was previously truncated!
				needsMeasurement ||= (this._lastMeasurementWasTruncated && newWidth != this._lastMeasurementWidth);
			}
			if(this._textBlockChanged || needsMeasurement)
			{
				this.refreshTextLines(this._measurementTextLines, this._measurementTextLineContainer, newWidth, newHeight, HELPER_RESULT);
				this._lastMeasurementWidth = HELPER_RESULT.width;
				this._lastMeasurementHeight = HELPER_RESULT.height;
				this._lastMeasurementWasTruncated = HELPER_RESULT.isTruncated;
				this._textBlockChanged = false;
			}
			if(needsWidth)
			{
				newWidth = Math.ceil(this._measurementTextLineContainer.width);
				if(newWidth > this._explicitMaxWidth)
				{
					newWidth = this._explicitMaxWidth;
				}
			}
			if(needsHeight)
			{
				newHeight = Math.ceil(this._lastMeasurementHeight);
				if(newHeight <= 0 && this._textElement !== null)
				{
					newHeight = this._textElement.elementFormat.fontSize;
				}
			}

			result.x = newWidth;
			result.y = newHeight;

			return result;
		}

		/**
		 * @private
		 */
		protected function layout(sizeInvalid:Boolean):void
		{
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);

			//first, we check if something will have changed the appearance of
			//the text lines. they will always need to be refreshed for that.
			//if not, we check if the actualWidth and actualHeight have changed
			//since the last time we did layout. sizeInvalid will often be
			//triggered by changing maxWidth or something for measurement, so we
			//need to be more specific.
			var contentStateChanged:Boolean = stylesInvalid || dataInvalid || stateInvalid ||
				this.actualWidth != this._previousLayoutActualWidth ||
				this.actualHeight != this._previousLayoutActualHeight;
			if(contentStateChanged)
			{
				this._previousLayoutActualWidth = this.actualWidth;
				this._previousLayoutActualHeight = this.actualHeight;
				if(this._content !== null)
				{
					this.refreshTextLines(this._textLines, this._textLineContainer, this.actualWidth, this.actualHeight, HELPER_RESULT);
					//since refreshTextLines() isn't called every time that
					//calculateSnapshotDimensions() is called, we need to save
					//these values
					this._savedTextLinesWidth = HELPER_RESULT.width;
					this._savedTextLinesHeight = HELPER_RESULT.height;
					this._verticalAlignOffsetY = this.getVerticalAlignOffsetY();
				}
			}
			//on the other hand, sizeInvalid will always indicate that the
			//snapshot dimensions need to be revisited
			if(contentStateChanged || sizeInvalid)
			{
				this.calculateSnapshotDimensions();
			}

			if(contentStateChanged || this._needsNewTexture)
			{
				//we're going to update the texture in render() because
				//there's a chance that it will be updated more than once per
				//frame if we do it here.
				this._needsTextureUpdate = true;
				this.setRequiresRedraw();
			}
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			if(needsWidth || needsHeight)
			{
				//since the minimum dimensions are based on the regular
				//dimensions, we don't need to measure if only minimum
				//dimensions are required
				this.measure(HELPER_POINT);
			}
			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				newWidth = HELPER_POINT.x;
			}
			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				newHeight = HELPER_POINT.y;
			}
			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				if(needsWidth)
				{
					//this allows wrapping or truncation
					newMinWidth = 0;
				}
				else
				{
					newMinWidth = newWidth;
				}
			}
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				newMinHeight = newHeight;
			}
			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * @private
		 */
		protected function measureNativeFilters(bitmapData:BitmapData, result:Rectangle = null):Rectangle
		{
			if(!result)
			{
				result = new Rectangle();
			}
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var scaleFactor:Number = starling.contentScaleFactor;
			var resultX:Number = 0;
			var resultY:Number = 0;
			var resultWidth:Number = 0;
			var resultHeight:Number = 0;
			var filterCount:int = this._nativeFilters.length;
			for(var i:int = 0; i < filterCount; i++)
			{
				var filter:BitmapFilter = this._nativeFilters[i];
				var filterRect:Rectangle = bitmapData.generateFilterRect(bitmapData.rect, filter);
				var filterX:Number = filterRect.x;
				var filterY:Number = filterRect.y;
				var filterWidth:Number = filterRect.width * scaleFactor;
				var filterHeight:Number = filterRect.height * scaleFactor;
				if(resultX > filterX)
				{
					resultX = filterX;
				}
				if(resultY > filterY)
				{
					resultY = filterY;
				}
				if(resultWidth < filterWidth)
				{
					resultWidth = filterWidth;
				}
				if(resultHeight < filterHeight)
				{
					resultHeight = filterHeight;
				}
			}
			result.setTo(resultX, resultY, resultWidth, resultHeight);
			return result;
		}

		/**
		 * @private
		 */
		protected function refreshElementFormat():void
		{
			var elementFormat:ElementFormat;
			if(this._stateContext !== null)
			{
				if(this._elementFormatForState !== null)
				{
					var currentState:String = this._stateContext.currentState;
					if(currentState in this._elementFormatForState)
					{
						elementFormat = ElementFormat(this._elementFormatForState[currentState]);
					}
				}
				if(elementFormat === null && this._disabledElementFormat !== null &&
					this._stateContext is IFeathersControl && !IFeathersControl(this._stateContext).isEnabled)
				{
					elementFormat = this._disabledElementFormat;
				}
				if(elementFormat === null && this._selectedElementFormat !== null &&
					this._stateContext is IToggle && IToggle(this._stateContext).isSelected)
				{
					elementFormat = this._selectedElementFormat;
				}
			}
			else //no state context
			{
				//we can still check if the text renderer is disabled to see if
				//we should use disabledElementFormat
				if(!this._isEnabled && this._disabledElementFormat !== null)
				{
					elementFormat = this._disabledElementFormat;
				}
			}
			if(elementFormat === null)
			{
				elementFormat = this._elementFormat;
			}
			//ElementFormat is considered more advanced, so it gets precedence
			//over starling.text.TextFormat font styles
			if(elementFormat === null)
			{
				elementFormat = this.getElementFormatFromFontStyles();
			}
			else
			{
				//if using ElementFormat, vertical align is always top
				this._currentVerticalAlign = Align.TOP;
				//these are defaults in case textAlign and leading are not set
				this._currentHorizontalAlign = Align.CENTER;
				this._currentLeading = 0;
			}
			if(this._textAlign !== null)
			{
				this._currentHorizontalAlign = this._textAlign;
			}
			if(this._leading === this._leading) //!isNaN
			{
				this._currentLeading = this._leading;
			}
			if(this._textElement === null)
			{
				return;
			}
			if(this._textElement.elementFormat !== elementFormat)
			{
				this._textBlockChanged = true;
				this._textElement.elementFormat = elementFormat;
			}
		}

		/**
		 * @private
		 */
		protected function getElementFormatFromFontStyles():ElementFormat
		{
			if(this.isInvalid(INVALIDATION_FLAG_STYLES) ||
				this.isInvalid(INVALIDATION_FLAG_STATE))
			{
				var textFormat:TextFormat;
				if(this._fontStyles !== null)
				{
					textFormat = this._fontStyles.getTextFormatForTarget(this);
				}
				if(textFormat !== null)
				{
					var fontWeight:String = FontWeight.NORMAL;
					if(textFormat.bold)
					{
						fontWeight = FontWeight.BOLD;
					}
					var fontPosture:String = FontPosture.NORMAL;
					if(textFormat.italic)
					{
						fontPosture = FontPosture.ITALIC;
					}
					var fontLookup:String = FontLookup.DEVICE;
					if(SystemUtil.isEmbeddedFont(textFormat.font, textFormat.bold, textFormat.italic, FontType.EMBEDDED_CFF))
					{
						fontLookup = FontLookup.EMBEDDED_CFF;
					}
					var fontDescription:FontDescription =
						new FontDescription(textFormat.font, fontWeight, fontPosture, fontLookup);
					this._fontStylesElementFormat = new ElementFormat(fontDescription, textFormat.size, textFormat.color);
					if(textFormat.kerning)
					{
						this._fontStylesElementFormat.kerning = Kerning.ON;
					}
					else
					{
						this._fontStylesElementFormat.kerning = Kerning.OFF;
					}
					var letterSpacing:Number = textFormat.letterSpacing / 2;
					//adobe documentation recommends splitting it between
					//left and right
					//http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/engine/ElementFormat.html#trackingRight
					this._fontStylesElementFormat.trackingRight = letterSpacing;
					this._fontStylesElementFormat.trackingLeft = letterSpacing;
					this._currentLeading = textFormat.leading;
					this._currentVerticalAlign = textFormat.verticalAlign;
					this._currentHorizontalAlign = textFormat.horizontalAlign;
				}
				else if(this._fontStylesElementFormat === null)
				{
					//fallback to a default so that something is displayed
					this._fontStylesElementFormat = new ElementFormat();
					this._currentLeading = 0;
					this._currentVerticalAlign = Align.TOP;
					this._currentHorizontalAlign = Align.LEFT;
				}
			}
			return this._fontStylesElementFormat;
		}

		/**
		 * @private
		 */
		protected function createTextureOnRestoreCallback(snapshot:Image):void
		{
			var self:TextBlockTextRenderer = this;
			var texture:Texture = snapshot.texture;
			texture.root.onRestore = function():void
			{
				var starling:Starling = self.stage !== null ? self.stage.starling : Starling.current;
				var scaleFactor:Number = starling.contentScaleFactor;
				if(texture.scale != scaleFactor)
				{
					//if we've changed between scale factors, we need to
					//recreate the texture to match the new scale factor.
					invalidate(INVALIDATION_FLAG_SIZE);
				}
				else
				{
					HELPER_MATRIX.identity();
					HELPER_MATRIX.scale(scaleFactor, scaleFactor);
					var offsetY:Number = self.getVerticalAlignOffsetY();
					var bitmapData:BitmapData = self.drawTextLinesRegionToBitmapData(
						snapshot.x, snapshot.y - offsetY, texture.nativeWidth, texture.nativeHeight);
					texture.root.uploadBitmapData(bitmapData);
					bitmapData.dispose();
				}
			};
		}

		/**
		 * @private
		 */
		protected function drawTextLinesRegionToBitmapData(textLinesX:Number, textLinesY:Number,
			bitmapWidth:Number, bitmapHeight:Number, bitmapData:BitmapData = null):BitmapData
		{
			var clipWidth:Number = this._snapshotVisibleWidth - textLinesX;
			var clipHeight:Number = this._snapshotVisibleHeight - textLinesY;
			if(!bitmapData || bitmapData.width != bitmapWidth || bitmapData.height != bitmapHeight)
			{
				if(bitmapData)
				{
					bitmapData.dispose();
				}
				bitmapData = new BitmapData(bitmapWidth, bitmapHeight, true, 0x00ff00ff);
			}
			else
			{
				//clear the bitmap data and reuse it
				bitmapData.fillRect(bitmapData.rect, 0x00ff00ff);
			}
			var nativeScaleFactor:Number = 1;
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			if(starling && starling.supportHighResolutions)
			{
				nativeScaleFactor = starling.nativeStage.contentsScaleFactor;
			}
			HELPER_MATRIX.tx = -textLinesX - this._textSnapshotScrollX * nativeScaleFactor - this._textSnapshotOffsetX;
			HELPER_MATRIX.ty = -textLinesY - this._textSnapshotScrollY * nativeScaleFactor - this._textSnapshotOffsetY;
			var rect:Rectangle = Pool.getRectangle(0, 0, clipWidth, clipHeight);
			bitmapData.draw(this._textLineContainer, HELPER_MATRIX, null, null, rect);
			Pool.putRectangle(rect);
			return bitmapData;
		}

		/**
		 * @private
		 */
		protected function calculateSnapshotDimensions():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var scaleFactor:Number = starling.contentScaleFactor;
			this._lastGlobalContentScaleFactor = scaleFactor;
			//these are getting put into an int later, so we don't want it
			//to possibly round down and cut off part of the text.
			if(this._savedTextLinesWidth < this.actualWidth)
			{
				var rectangleSnapshotWidth:Number = Math.ceil(this._savedTextLinesWidth * scaleFactor);
			}
			else
			{
				rectangleSnapshotWidth = Math.ceil(this.actualWidth * scaleFactor);
			}
			if(this._savedTextLinesHeight < this.actualHeight)
			{
				var rectangleSnapshotHeight:Number = Math.ceil(this._savedTextLinesHeight * scaleFactor);
			}
			else
			{
				rectangleSnapshotHeight = Math.ceil(this.actualHeight * scaleFactor);
			}
			if(this._updateSnapshotOnScaleChange)
			{
				this.getTransformationMatrix(this.stage, HELPER_MATRIX);
				this._lastGlobalScaleX = matrixToScaleX(HELPER_MATRIX);
				this._lastGlobalScaleY = matrixToScaleY(HELPER_MATRIX);
				rectangleSnapshotWidth *= this._lastGlobalScaleX;
				rectangleSnapshotHeight *= this._lastGlobalScaleY;
			}
			if(rectangleSnapshotWidth >= 1 && rectangleSnapshotHeight >= 1 &&
				this._nativeFilters !== null && this._nativeFilters.length > 0)
			{
				rectangleSnapshotWidth = this._textSnapshotNativeFiltersWidth;
				rectangleSnapshotHeight = this._textSnapshotNativeFiltersHeight;
			}
			var point:Point = Pool.getPoint();
			calculateSnapshotTextureDimensions(rectangleSnapshotWidth,
				rectangleSnapshotHeight, this._maxTextureDimensions,
				starling.profile !== Context3DProfile.BASELINE_CONSTRAINED, point);
			//the full dimensions of the texture
			this._snapshotWidth = point.x;
			this._snapshotHeight = point.y;
			//the clipping dimensions of the texture, if it is next power-of-two
			this._snapshotVisibleWidth = rectangleSnapshotWidth;
			this._snapshotVisibleHeight = rectangleSnapshotHeight;
			Pool.putPoint(point);

			var textureRoot:ConcreteTexture = this.textSnapshot ? this.textSnapshot.texture.root : null;
			this._needsNewTexture = this._needsNewTexture || this.textSnapshot === null ||
				(textureRoot !== null && (textureRoot.scale != scaleFactor ||
				this._snapshotWidth != textureRoot.nativeWidth || this._snapshotHeight != textureRoot.nativeHeight));
		}

		/**
		 * @private
		 */
		protected function refreshSnapshot():void
		{
			if(this._snapshotWidth <= 0 || this._snapshotHeight <= 0)
			{
				return;
			}
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var scaleFactor:Number = starling.contentScaleFactor;
			if(this._updateSnapshotOnScaleChange)
			{
				this.getTransformationMatrix(this.stage, HELPER_MATRIX);
				var globalScaleX:Number = matrixToScaleX(HELPER_MATRIX);
				var globalScaleY:Number = matrixToScaleY(HELPER_MATRIX);
			}
			HELPER_MATRIX.identity();
			HELPER_MATRIX.scale(scaleFactor, scaleFactor);
			if(this._updateSnapshotOnScaleChange)
			{
				HELPER_MATRIX.scale(globalScaleX, globalScaleY);
			}
			var totalBitmapWidth:Number = this._snapshotWidth;
			var totalBitmapHeight:Number = this._snapshotHeight;
			var xPosition:Number = 0;
			var yPosition:Number = 0;
			var bitmapData:BitmapData;
			var snapshotIndex:int = -1;
			do
			{
				var currentBitmapWidth:Number = totalBitmapWidth;
				if(currentBitmapWidth > this._maxTextureDimensions)
				{
					currentBitmapWidth = this._maxTextureDimensions;
				}
				do
				{
					var currentBitmapHeight:Number = totalBitmapHeight;
					if(currentBitmapHeight > this._maxTextureDimensions)
					{
						currentBitmapHeight = this._maxTextureDimensions;
					}
					bitmapData = this.drawTextLinesRegionToBitmapData(xPosition, yPosition,
						currentBitmapWidth, currentBitmapHeight, bitmapData);
					var newTexture:Texture;
					if(!this.textSnapshot || this._needsNewTexture)
					{
						//skip Texture.fromBitmapData() because we don't want
						//it to create an onRestore function that will be
						//immediately discarded for garbage collection.
						newTexture = Texture.empty(bitmapData.width / scaleFactor, bitmapData.height / scaleFactor,
							true, false, false, scaleFactor);
						newTexture.root.uploadBitmapData(bitmapData);
					}
					var snapshot:Image = null;
					if(snapshotIndex >= 0)
					{
						if(!this.textSnapshots)
						{
							this.textSnapshots = new <Image>[];
						}
						else if(this.textSnapshots.length > snapshotIndex)
						{
							snapshot = this.textSnapshots[snapshotIndex];
						}
					}
					else
					{
						snapshot = this.textSnapshot;
					}

					if(!snapshot)
					{
						snapshot = new Image(newTexture);
						this.addChild(snapshot);
					}
					else
					{
						if(this._needsNewTexture)
						{
							snapshot.texture.dispose();
							snapshot.texture = newTexture;
							snapshot.readjustSize();
						}
						else
						{
							//this is faster, if we haven't resized the bitmapdata
							var existingTexture:Texture = snapshot.texture;
							existingTexture.root.uploadBitmapData(bitmapData);
							//however, the image won't be notified that its
							//texture has changed, so we need to do it manually
							this.textSnapshot.setRequiresRedraw();
						}
					}
					if(newTexture)
					{
						this.createTextureOnRestoreCallback(snapshot);
					}
					if(snapshotIndex >= 0)
					{
						this.textSnapshots[snapshotIndex] = snapshot;
					}
					else
					{
						this.textSnapshot = snapshot;
					}
					snapshot.x = xPosition / scaleFactor;
					snapshot.y = yPosition / scaleFactor;
					if(this._updateSnapshotOnScaleChange)
					{
						snapshot.scaleX = 1 / globalScaleX;
						snapshot.scaleY = 1 / globalScaleY;
					}
					else
					{
						snapshot.scale = 1;
					}
					snapshotIndex++;
					yPosition += currentBitmapHeight;
					totalBitmapHeight -= currentBitmapHeight;
				}
				while(totalBitmapHeight > 0);
				xPosition += currentBitmapWidth;
				totalBitmapWidth -= currentBitmapWidth;
				yPosition = 0;
				totalBitmapHeight = this._snapshotHeight;
			}
			while(totalBitmapWidth > 0);
			bitmapData.dispose();
			if(this.textSnapshots)
			{
				var snapshotCount:int = this.textSnapshots.length;
				for(var i:int = snapshotIndex; i < snapshotCount; i++)
				{
					snapshot = this.textSnapshots[i];
					snapshot.texture.dispose();
					snapshot.removeFromParent(true);
				}
				if(snapshotIndex == 0)
				{
					this.textSnapshots = null;
				}
				else
				{
					this.textSnapshots.length = snapshotIndex;
				}
			}
			if(this._updateSnapshotOnScaleChange)
			{
				this._lastGlobalScaleX = globalScaleX;
				this._lastGlobalScaleY = globalScaleY;
				this._lastGlobalContentScaleFactor = scaleFactor;
			}
			this._needsNewTexture = false;
		}

		/**
		 * @private
		 * the ascent alone doesn't account for diacritical marks,
		 * like accents and things. however, increasing the ascent by
		 * the value of the descent seems to be a good approximation.
		 */
		protected function calculateLineAscent(line:TextLine):Number
		{
			var calculatedAscent:Number = line.ascent + line.descent;
			if(line.totalAscent > calculatedAscent)
			{
				calculatedAscent = line.totalAscent;
			}
			return calculatedAscent;
		}

		/**
		 * @private
		 */
		protected function refreshTextElementText():void
		{
			if(this._textElement === null)
			{
				return;
			}
			var newText:String = this._text;
			if(newText !== null && newText.length > 0)
			{
				if(newText.charAt(newText.length - 1) === " ")
				{
					//add an invisible control character because FTE apparently
					//doesn't think that it's important to include trailing
					//spaces in its width measurement.
					newText += String.fromCharCode(3);
				}
			}
			else
			{
				//similar to above. this hack ensures that the baseline is
				//measured properly when the text is an empty string.
				newText = String.fromCharCode(3);
			}
			this._textElement.text = newText;
		}

		/**
		 * @private
		 */
		protected function refreshTextLines(textLines:Vector.<TextLine>,
			textLineParent:DisplayObjectContainer, width:Number, height:Number,
			result:MeasureTextResult = null):MeasureTextResult
		{
			//clamp the width and height values to a valid range so that it
			//doesn't break the measurement
			if(width < 0)
			{
				width = 0;
			}
			else if(width > MAX_TEXT_LINE_WIDTH)
			{
				width = MAX_TEXT_LINE_WIDTH;
			}
			if(height < 0)
			{
				height = 0;
			}

			var lineCount:int = textLines.length;
			//copy the invalid text lines over to the helper vector so that we
			//can reuse them
			HELPER_TEXT_LINES.length = 0;
			for(var i:int = 0; i < lineCount; i++)
			{
				HELPER_TEXT_LINES[i] = textLines[i];
			}
			textLines.length = 0;

			this.refreshTextElementText();

			var wasTruncated:Boolean = false;
			var maxLineWidth:Number = 0;
			var yPosition:Number = 0;
			if(width >= 0)
			{
				var line:TextLine = null;
				var lineStartIndex:int = 0;
				var canTruncate:Boolean = this._truncateToFit && this._textElement && !this._wordWrap;
				var pushIndex:int = textLines.length;
				var inactiveTextLineCount:int = HELPER_TEXT_LINES.length;
				while(true)
				{
					this._truncationOffset = 0;
					var previousLine:TextLine = line;
					var lineWidth:Number = width;
					if(!this._wordWrap)
					{
						lineWidth = MAX_TEXT_LINE_WIDTH;
					}
					if(inactiveTextLineCount > 0)
					{
						var inactiveLine:TextLine = HELPER_TEXT_LINES[0];
						line = this.textBlock.recreateTextLine(inactiveLine, previousLine, lineWidth, 0, true);
						if(line)
						{
							HELPER_TEXT_LINES.shift();
							inactiveTextLineCount--;
						}
					}
					else
					{
						line = this.textBlock.createTextLine(previousLine, lineWidth, 0, true);
						if(line)
						{
							textLineParent.addChild(line);
						}
					}
					if(!line)
					{
						//end of text
						break;
					}
					var lineLength:int = line.rawTextLength;
					var isTruncated:Boolean = false;
					var difference:Number = 0;
					while(canTruncate && (difference = line.width - width) > FUZZY_TRUNCATION_DIFFERENCE)
					{
						isTruncated = true;
						if(this._truncationOffset == 0)
						{
							//this will quickly skip all of the characters after
							//the maximum width of the line, instead of going
							//one by one.
							var endIndex:int = line.getAtomIndexAtPoint(width, 0);
							if(endIndex >= 0)
							{
								this._truncationOffset = line.rawTextLength - endIndex;
							}
						}
						this._truncationOffset++;
						var truncatedTextLength:int = lineLength - this._truncationOffset;
						//we want to start at this line so that the previous
						//lines don't become invalid.
						var truncatedText:String = this._text.substr(lineStartIndex, truncatedTextLength) + this._truncationText;
						var lineBreakIndex:int = this._text.indexOf(LINE_FEED, lineStartIndex);
						if(lineBreakIndex < 0)
						{
							lineBreakIndex = this._text.indexOf(CARRIAGE_RETURN, lineStartIndex);
						}
						if(lineBreakIndex >= 0)
						{
							truncatedText += this._text.substr(lineBreakIndex);
						}
						this._textElement.text = truncatedText;
						line = this.textBlock.recreateTextLine(line, null, lineWidth, 0, true);
						if(truncatedTextLength <= 0)
						{
							break;
						}
					}
					if(pushIndex > 0)
					{
						yPosition += this._currentLeading;
					}

					if(line.width > maxLineWidth)
					{
						maxLineWidth = line.width;
					}
					yPosition += this.calculateLineAscent(line);
					line.y = yPosition;
					yPosition += line.totalDescent;
					textLines[pushIndex] = line;
					pushIndex++;
					lineStartIndex += lineLength;
					wasTruncated ||= isTruncated;
				}
			}
			if(textLines !== this._measurementTextLines)
			{
				//no need to align the measurement text lines because they won't
				//be rendered
				this.alignTextLines(textLines, width, this._currentHorizontalAlign);
			}
			if(this._currentHorizontalAlign === Align.RIGHT)
			{
				maxLineWidth = width;
			}
			else if(this._currentHorizontalAlign === Align.CENTER)
			{
				maxLineWidth = (width + maxLineWidth) / 2;
			}

			inactiveTextLineCount = HELPER_TEXT_LINES.length;
			for(i = 0; i < inactiveTextLineCount; i++)
			{
				line = HELPER_TEXT_LINES[i];
				textLineParent.removeChild(line);
			}
			HELPER_TEXT_LINES.length = 0;
			if(result === null)
			{
				result = new MeasureTextResult(maxLineWidth, yPosition, wasTruncated);
			}
			else
			{
				result.width = maxLineWidth;
				result.height = yPosition;
				result.isTruncated = wasTruncated;
			}

			if(textLines !== this._measurementTextLines)
			{
				if(result.width >= 1 && result.height >= 1 &&
					this._nativeFilters !== null && this._nativeFilters.length > 0)
				{
					var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
					var scaleFactor:Number = starling.contentScaleFactor;
					HELPER_MATRIX.identity();
					HELPER_MATRIX.scale(scaleFactor, scaleFactor);
					var bitmapData:BitmapData = new BitmapData(result.width, result.height, true, 0x00ff00ff);
					var rect:Rectangle = Pool.getRectangle();
					bitmapData.draw(this._textLineContainer, HELPER_MATRIX, null, null, rect);
					this.measureNativeFilters(bitmapData, rect);
					bitmapData.dispose();
					bitmapData = null;
					this._textSnapshotOffsetX = rect.x;
					this._textSnapshotOffsetY = rect.y;
					this._textSnapshotNativeFiltersWidth = rect.width;
					this._textSnapshotNativeFiltersHeight = rect.height;
					Pool.putRectangle(rect);
				}
				else
				{
					this._textSnapshotOffsetX = 0;
					this._textSnapshotOffsetY = 0;
					this._textSnapshotNativeFiltersWidth = 0;
					this._textSnapshotNativeFiltersHeight = 0;
				}
			}
			return result;
		}

		/**
		 * @private
		 */
		protected function getVerticalAlignOffsetY():Number
		{
			if(this._savedTextLinesHeight > this.actualHeight)
			{
				return 0;
			}
			if(this._currentVerticalAlign === Align.BOTTOM)
			{
				return (this.actualHeight - this._savedTextLinesHeight);
			}
			else if(this._currentVerticalAlign === Align.CENTER)
			{
				return (this.actualHeight - this._savedTextLinesHeight) / 2;
			}
			return 0;
		}

		/**
		 * @private
		 */
		protected function alignTextLines(textLines:Vector.<TextLine>, width:Number, textAlign:String):void
		{
			var lineCount:int = textLines.length;
			for(var i:int = 0; i < lineCount; i++)
			{
				var line:TextLine = textLines[i];
				if(textAlign == HorizontalAlign.CENTER)
				{
					line.x = (width - line.width) / 2;
				}
				else if(textAlign == HorizontalAlign.RIGHT)
				{
					line.x = width - line.width;
				}
				else
				{
					line.x = 0;
				}
			}
		}
	}
}


================================================
FILE: source/feathers/controls/text/TextFieldTextEditor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.text
{
	import feathers.core.BaseTextEditor;
	import feathers.core.FocusManager;
	import feathers.core.IFeathersControl;
	import feathers.core.INativeFocusOwner;
	import feathers.core.ITextEditor;
	import feathers.events.FeathersEventType;
	import feathers.skins.IStyleProvider;
	import feathers.utils.geom.matrixToRotation;
	import feathers.utils.geom.matrixToScaleX;
	import feathers.utils.geom.matrixToScaleY;

	import flash.display.BitmapData;
	import flash.display.Stage;
	import flash.display3D.Context3DProfile;
	import flash.events.FocusEvent;
	import flash.events.KeyboardEvent;
	import flash.events.SoftKeyboardEvent;
	import flash.geom.Matrix;
	import flash.geom.Matrix3D;
	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.geom.Vector3D;
	import flash.text.AntiAliasType;
	import flash.text.FontType;
	import flash.text.GridFitType;
	import flash.text.TextField;
	import flash.text.TextFieldAutoSize;
	import flash.text.TextFieldType;
	import flash.text.TextFormat;
	import flash.ui.Keyboard;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Image;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.rendering.Painter;
	import starling.text.TextFormat;
	import starling.textures.ConcreteTexture;
	import starling.textures.Texture;
	import starling.utils.Align;
	import starling.utils.MathUtil;
	import starling.utils.MatrixUtil;
	import starling.utils.Pool;
	import starling.utils.SystemUtil;

	/**
	 * Dispatched when the text property changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #text
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the user presses the Enter key while the editor has focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.ENTER
	 */
	[Event(name="enter",type="starling.events.Event")]

	/**
	 * Dispatched when the text editor receives focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_IN
	 */
	[Event(name="focusIn",type="starling.events.Event")]

	/**
	 * Dispatched when the text editor loses focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_OUT
	 */
	[Event(name="focusOut",type="starling.events.Event")]

	/**
	 * Dispatched when the soft keyboard is about to activate. Not all text
	 * editors will activate a soft keyboard.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.SOFT_KEYBOARD_ACTIVATING
	 */
	[Event(name="softKeyboardActivating",type="starling.events.Event")]

	/**
	 * Dispatched when the soft keyboard is activated. Not all text editors will
	 * activate a soft keyboard.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.SOFT_KEYBOARD_ACTIVATE
	 */
	[Event(name="softKeyboardActivate",type="starling.events.Event")]

	/**
	 * Dispatched when the soft keyboard is deactivated. Not all text editors
	 * will activate a soft keyboard.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.SOFT_KEYBOARD_DEACTIVATE
	 */
	[Event(name="softKeyboardDeactivate",type="starling.events.Event")]

	/**
	 * Text that may be edited at runtime by the user with the
	 * <code>TextInput</code> component, using the native
	 * <code>flash.text.TextField</code> class with its <code>type</code>
	 * property set to <code>flash.text.TextInputType.INPUT</code>. When not in
	 * focus, the <code>TextField</code> is drawn to <code>BitmapData</code> and
	 * uploaded to a texture on the GPU. Textures are managed internally by this
	 * component, and they will be automatically disposed when the component is
	 * disposed.
	 *
	 * <p>For desktop apps, <code>TextFieldTextEditor</code> is recommended
	 * instead of <code>StageTextTextEditor</code>. <code>StageTextTextEditor</code>
	 * will still work in desktop apps, but it is more appropriate for mobile
	 * apps.</p>
	 *
	 * <p>The following example shows how to use
	 * <code>TextFieldTextEditor</code> with a <code>TextInput</code>:</p>
	 *
	 * <listing version="3.0">
	 * var input:TextInput = new TextInput();
	 * input.textEditorFactory = function():ITextEditor
	 * {
	 *     return new TextFieldTextEditor();
	 * };
	 * this.addChild( input );</listing>
	 *
	 * @see feathers.controls.TextInput
	 * @see ../../../../help/text-editors.html Introduction to Feathers text editors
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html flash.text.TextField
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class TextFieldTextEditor extends BaseTextEditor implements ITextEditor, INativeFocusOwner
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>TextFieldTextEditor</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function TextFieldTextEditor()
		{
			this.isQuickHitAreaEnabled = true;
			this.addEventListener(Event.ADDED_TO_STAGE, textEditor_addedToStageHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, textEditor_removedFromStageHandler);
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return globalStyleProvider;
		}

		/**
		 * The text field sub-component.
		 */
		protected var textField:TextField;

		/**
		 * @copy feathers.core.INativeFocusOwner#nativeFocus
		 */
		public function get nativeFocus():Object
		{
			return this.textField;
		}

		/**
		 * An image that displays a snapshot of the native <code>TextField</code>
		 * in the Starling display list when the editor doesn't have focus.
		 */
		protected var textSnapshot:Image;

		/**
		 * The separate text field sub-component used for measurement.
		 * Typically, the main text field often doesn't report correct values
		 * for a full frame if its dimensions are changed too often.
		 */
		protected var measureTextField:TextField;

		/**
		 * @private
		 */
		protected var _snapshotWidth:int = 0;

		/**
		 * @private
		 */
		protected var _snapshotHeight:int = 0;

		/**
		 * @private
		 */
		protected var _textFieldSnapshotClipRect:Rectangle = new Rectangle();

		/**
		 * @private
		 */
		protected var _textFieldOffsetX:Number = 0;

		/**
		 * @private
		 */
		protected var _textFieldOffsetY:Number = 0;

		/**
		 * @private
		 */
		protected var _lastGlobalScaleX:Number = 0;

		/**
		 * @private
		 */
		protected var _lastGlobalScaleY:Number = 0;

		/**
		 * @private
		 */
		protected var _needsTextureUpdate:Boolean = false;

		/**
		 * @private
		 */
		protected var _needsNewTexture:Boolean = false;

		/**
		 * @inheritDoc
		 */
		public function get baseline():Number
		{
			if(!this.textField)
			{
				return 0;
			}
			var gutterDimensionsOffset:Number = 0;
			if(this._useGutter || this._border)
			{
				gutterDimensionsOffset = 2;
			}
			return gutterDimensionsOffset + this.textField.getLineMetrics(0).ascent;
		}

		/**
		 * @private
		 */
		protected var _previousStarlingTextFormat:starling.text.TextFormat;

		/**
		 * @private
		 */
		protected var _currentStarlingTextFormat:starling.text.TextFormat;

		/**
		 * @private
		 */
		protected var _previousTextFormat:flash.text.TextFormat;

		/**
		 * @private
		 */
		protected var _currentTextFormat:flash.text.TextFormat;

		/**
		 * For debugging purposes, the current
		 * <code>flash.text.TextFormat</code> used to render the text. Updated
		 * during validation, and may be <code>null</code> before the first
		 * validation.
		 *
		 * <p>Do not modify this value. It is meant for testing and debugging
		 * only. Use the parent's <code>starling.text.TextFormat</code> font
		 * styles APIs instead.</p>
		 */
		public function get currentTextFormat():flash.text.TextFormat
		{
			return this._currentTextFormat;
		}

		/**
		 * @private
		 */
		protected var _textFormatForState:Object;

		/**
		 * @private
		 */
		protected var _fontStylesTextFormat:flash.text.TextFormat;

		/**
		 * @private
		 */
		protected var _textFormat:flash.text.TextFormat;

		/**
		 * Advanced font formatting used to draw the text, if
		 * <code>fontStyles</code> and <code>starling.text.TextFormat</code>
		 * cannot be used on the parent component because the full capabilities
		 * of <code>flash.text.TextField</code> are required.
		 *
		 * <p>In the following example, the text format is changed:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.textFormat = new TextFormat( "Source Sans Pro" );;</listing>
		 *
		 * <p><strong>Warning:</strong> If this property is not
		 * <code>null</code>, any <code>starling.text.TextFormat</code> font
		 * styles that are passed in from the parent component may be ignored.
		 * In other words, advanced font styling with
		 * <code>flash.text.TextFormat</code> will always take precedence.</p>
		 *
		 * @default null
		 *
		 * @see #setTextFormatForState()
		 * @see #disabledTextFormat
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextFormat.html flash.text.TextFormat
		 */
		public function get textFormat():flash.text.TextFormat
		{
			return this._textFormat;
		}

		/**
		 * @private
		 */
		public function set textFormat(value:flash.text.TextFormat):void
		{
			if(this._textFormat == value)
			{
				return;
			}
			this._textFormat = value;
			//since the text format has changed, the comparison will return
			//false whether we use the real previous format or null. might as
			//well remove the reference to an object we don't need anymore.
			this._previousTextFormat = null;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _disabledTextFormat:flash.text.TextFormat;

		/**
		 * Advanced font formatting used to draw the text when the component is
		 * disabled, if <code>disabledFontStyles</code> and
		 * <code>starling.text.TextFormat</code> cannot be used on the parent
		 * component because the full capabilities of
		 * <code>flash.text.TextField</code> are required.
		 *
		 * <p>In the following example, the disabled text format is changed:</p>
		 *
		 * <p><strong>Warning:</strong> If this property is not
		 * <code>null</code>, any <code>starling.text.TextFormat</code> font
		 * styles that are passed in from the parent component may be ignored.
		 * In other words, advanced font styling with
		 * <code>flash.text.TextFormat</code> will always take precedence.</p>
		 *
		 * <listing version="3.0">
		 * textEditor.isEnabled = false;
		 * textEditor.disabledTextFormat = new TextFormat( "Source Sans Pro" );</listing>
		 *
		 * @default null
		 *
		 * @see #textFormat
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextFormat.html flash.text.TextFormat
		 */
		public function get disabledTextFormat():flash.text.TextFormat
		{
			return this._disabledTextFormat;
		}

		/**
		 * @private
		 */
		public function set disabledTextFormat(value:flash.text.TextFormat):void
		{
			if(this._disabledTextFormat == value)
			{
				return;
			}
			this._disabledTextFormat = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _embedFonts:Boolean = false;

		/**
		 * If advanced <code>flash.text.TextFormat</code> styles are specified,
		 * determines if the TextField should use an embedded font or not. If
		 * the specified font is not embedded, the text may not be displayed at
		 * all.
		 *
		 * <p>If the font styles are passed in from the parent component, the
		 * text renderer will automatically detect if a font is embedded or not,
		 * and the <code>embedFonts</code> property will be ignored if it is set
		 * to <code>false</code>. Setting it to <code>true</code> will force the
		 * <code>TextField</code> to always try to use embedded fonts.</p>
		 *
		 * <p>In the following example, the font is embedded:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.embedFonts = true;</listing>
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#embedFonts Full description of flash.text.TextField.embedFonts in Adobe's Flash Platform API Reference
		 */
		public function get embedFonts():Boolean
		{
			return this._embedFonts;
		}

		/**
		 * @private
		 */
		public function set embedFonts(value:Boolean):void
		{
			if(this._embedFonts == value)
			{
				return;
			}
			this._embedFonts = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _wordWrap:Boolean = false;

		/**
		 * Determines if the TextField wraps text to the next line.
		 *
		 * <p>In the following example, word wrap is enabled:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.wordWrap = true;</listing>
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#wordWrap Full description of flash.text.TextField.wordWrap in Adobe's Flash Platform API Reference
		 */
		public function get wordWrap():Boolean
		{
			return this._wordWrap;
		}

		/**
		 * @private
		 */
		public function set wordWrap(value:Boolean):void
		{
			if(this._wordWrap == value)
			{
				return;
			}
			this._wordWrap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _multiline:Boolean = false;

		/**
		 * Indicates whether field is a multiline text field.
		 *
		 * <p>In the following example, multiline is enabled:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.multiline = true;</listing>
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#multiline Full description of flash.text.TextField.multiline in Adobe's Flash Platform API Reference
		 */
		public function get multiline():Boolean
		{
			return this._multiline;
		}

		/**
		 * @private
		 */
		public function set multiline(value:Boolean):void
		{
			if(this._multiline == value)
			{
				return;
			}
			this._multiline = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isHTML:Boolean = false;

		/**
		 * Determines if the TextField should display the value of the
		 * <code>text</code> property as HTML or not.
		 *
		 * <p>In the following example, the text is displayed as HTML:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.isHTML = true;</listing>
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#htmlText flash.text.TextField.htmlText
		 */
		public function get isHTML():Boolean
		{
			return this._isHTML;
		}

		/**
		 * @private
		 */
		public function set isHTML(value:Boolean):void
		{
			if(this._isHTML == value)
			{
				return;
			}
			this._isHTML = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _alwaysShowSelection:Boolean = false;

		/**
		 * When set to <code>true</code> and the text field is not in focus,
		 * Flash Player highlights the selection in the text field in gray. When
		 * set to <code>false</code> and the text field is not in focus, Flash
		 * Player does not highlight the selection in the text field.
		 *
		 * <p>In the following example, the selection is always shown:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.alwaysShowSelection = true;</listing>
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#alwaysShowSelection Full description of flash.text.TextField.alwaysShowSelection in Adobe's Flash Platform API Reference
		 */
		public function get alwaysShowSelection():Boolean
		{
			return this._alwaysShowSelection;
		}

		/**
		 * @private
		 */
		public function set alwaysShowSelection(value:Boolean):void
		{
			if(this._alwaysShowSelection == value)
			{
				return;
			}
			this._alwaysShowSelection = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _displayAsPassword:Boolean = false;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * Specifies whether the text field is a password text field that hides
		 * the input characters using asterisks instead of the actual
		 * characters.
		 *
		 * @see feathers.controls.TextInput#displayAsPassword
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#displayAsPassword Full description of flash.text.TextField.displayAsPassword in Adobe's Flash Platform API Reference
		 */
		public function get displayAsPassword():Boolean
		{
			return this._displayAsPassword;
		}

		/**
		 * @private
		 */
		public function set displayAsPassword(value:Boolean):void
		{
			if(this._displayAsPassword == value)
			{
				return;
			}
			this._displayAsPassword = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _maxChars:int = 0;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#maxChars
		 *
		 * @see feathers.controls.TextInput#maxChars
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#maxChars Full description of flash.text.TextField.maxChars in Adobe's Flash Platform API Reference
		 */
		public function get maxChars():int
		{
			return this._maxChars;
		}

		/**
		 * @private
		 */
		public function set maxChars(value:int):void
		{
			if(this._maxChars == value)
			{
				return;
			}
			this._maxChars = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _restrict:String;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#restrict
		 *
		 * @see feathers.controls.TextInput#restrict
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#restrict Full description of flash.text.TextField.restrict in Adobe's Flash Platform API Reference
		 */
		public function get restrict():String
		{
			return this._restrict;
		}

		/**
		 * @private
		 */
		public function set restrict(value:String):void
		{
			if(this._restrict == value)
			{
				return;
			}
			this._restrict = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isEditable:Boolean = true;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#isEditable
		 *
		 * @see feathers.controls.TextInput#isEditable
		 */
		public function get isEditable():Boolean
		{
			return this._isEditable;
		}

		/**
		 * @private
		 */
		public function set isEditable(value:Boolean):void
		{
			if(this._isEditable == value)
			{
				return;
			}
			this._isEditable = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isSelectable:Boolean = true;

		/**
		 * <p>This property is managed by the <code>TextInput</code>.</p>
		 *
		 * @copy feathers.controls.TextInput#isSelectable
		 *
		 * @see feathers.controls.TextInput#isSelectable
		 */
		public function get isSelectable():Boolean
		{
			return this._isSelectable;
		}

		/**
		 * @private
		 */
		public function set isSelectable(value:Boolean):void
		{
			if(this._isSelectable == value)
			{
				return;
			}
			this._isSelectable = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _antiAliasType:String = AntiAliasType.ADVANCED;

		/**
		 * The type of anti-aliasing used for this text field, defined as
		 * constants in the <code>flash.text.AntiAliasType</code> class. You can
		 * control this setting only if the font is embedded (with the
		 * <code>embedFonts</code> property set to true).
		 *
		 * <p>In the following example, the anti-alias type is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.antiAliasType = AntiAliasType.NORMAL;</listing>
		 *
		 * @default flash.text.AntiAliasType.ADVANCED
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#antiAliasType Full description of flash.text.TextField.antiAliasType in Adobe's Flash Platform API Reference
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/AntiAliasType.html flash.text.AntiAliasType
		 * @see #embedFonts
		 */
		public function get antiAliasType():String
		{
			return this._antiAliasType;
		}

		/**
		 * @private
		 */
		public function set antiAliasType(value:String):void
		{
			if(this._antiAliasType == value)
			{
				return;
			}
			this._antiAliasType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _gridFitType:String = GridFitType.PIXEL;

		/**
		 * Determines whether Flash Player forces strong horizontal and vertical
		 * lines to fit to a pixel or subpixel grid, or not at all using the
		 * constants defined in the <code>flash.text.GridFitType</code> class.
		 * This property applies only if the <code>antiAliasType</code> property
		 * of the text field is set to <code>flash.text.AntiAliasType.ADVANCED</code>.
		 *
		 * <p>In the following example, the grid fit type is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.gridFitType = GridFitType.SUBPIXEL;</listing>
		 *
		 * @default flash.text.GridFitType.PIXEL
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#gridFitType Full description of flash.text.TextField.gridFitType in Adobe's Flash Platform API Reference
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/GridFitType.html flash.text.GridFitType
		 * @see #antiAliasType
		 */
		public function get gridFitType():String
		{
			return this._gridFitType;
		}

		/**
		 * @private
		 */
		public function set gridFitType(value:String):void
		{
			if(this._gridFitType == value)
			{
				return;
			}
			this._gridFitType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _sharpness:Number = 0;

		/**
		 * The sharpness of the glyph edges in this text field. This property
		 * applies only if the <code>antiAliasType</code> property of the text
		 * field is set to <code>flash.text.AntiAliasType.ADVANCED</code>. The
		 * range for <code>sharpness</code> is a number from <code>-400</code>
		 * to <code>400</code>.
		 *
		 * <p>In the following example, the sharpness is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.sharpness = 200;</listing>
		 *
		 * @default 0
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#sharpness Full description of flash.text.TextField.sharpness in Adobe's Flash Platform API Reference
		 * @see #antiAliasType
		 */
		public function get sharpness():Number
		{
			return this._sharpness;
		}

		/**
		 * @private
		 */
		public function set sharpness(value:Number):void
		{
			if(this._sharpness == value)
			{
				return;
			}
			this._sharpness = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		private var _thickness:Number = 0;

		/**
		 * The thickness of the glyph edges in this text field. This property
		 * applies only if the <code>antiAliasType</code> property is set to
		 * <code>flash.text.AntiAliasType.ADVANCED</code>. The range for
		 * <code>thickness</code> is a number from <code>-200</code> to
		 * <code>200</code>.
		 *
		 * <p>In the following example, the thickness is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.thickness = 100;</listing>
		 *
		 * @default 0
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#thickness Full description of flash.text.TextField.thickness in Adobe's Flash Platform API Reference
		 * @see #antiAliasType
		 */
		public function get thickness():Number
		{
			return this._thickness;
		}

		/**
		 * @private
		 */
		public function set thickness(value:Number):void
		{
			if(this._thickness == value)
			{
				return;
			}
			this._thickness = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		private var _background:Boolean = false;

		/**
		 * Specifies whether the text field has a background fill. Use the
		 * <code>backgroundColor</code> property to set the background color of
		 * a text field.
		 *
		 * <p>In the following example, the background is enabled:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.background = true;
		 * textRenderer.backgroundColor = 0xff0000;</listing>
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#background Full description of flash.text.TextField.background in Adobe's Flash Platform API Reference
		 * @see #backgroundColor
		 */
		public function get background():Boolean
		{
			return this._background;
		}

		/**
		 * @private
		 */
		public function set background(value:Boolean):void
		{
			if(this._background == value)
			{
				return;
			}
			this._background = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _backgroundColor:uint = 0xffffff;

		/**
		 * The color of the text field background that is displayed if the
		 * <code>background</code> property is set to <code>true</code>.
		 *
		 * <p>In the following example, the background color is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.background = true;
		 * textRenderer.backgroundColor = 0xff000ff;</listing>
		 *
		 * @default 0xffffff
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#backgroundColor Full description of flash.text.TextField.backgroundColor in Adobe's Flash Platform API Reference
		 * @see #background
		 */
		public function get backgroundColor():uint
		{
			return this._backgroundColor;
		}

		/**
		 * @private
		 */
		public function set backgroundColor(value:uint):void
		{
			if(this._backgroundColor == value)
			{
				return;
			}
			this._backgroundColor = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _border:Boolean = false;

		/**
		 * Specifies whether the text field has a border. Use the
		 * <code>borderColor</code> property to set the border color.
		 *
		 * <p>Note: If <code>border</code> is set to <code>true</code>, the
		 * component will behave as if <code>useGutter</code> is also set to
		 * <code>true</code> because the border will not render correctly
		 * without the gutter.</p>
		 *
		 * <p>In the following example, the border is enabled:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.border = true;
		 * textRenderer.borderColor = 0xff0000;</listing>
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#border Full description of flash.text.TextField.border in Adobe's Flash Platform API Reference
		 * @see #borderColor
		 */
		public function get border():Boolean
		{
			return this._border;
		}

		/**
		 * @private
		 */
		public function set border(value:Boolean):void
		{
			if(this._border == value)
			{
				return;
			}
			this._border = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _borderColor:uint = 0x000000;

		/**
		 * The color of the text field border that is displayed if the
		 * <code>border</code> property is set to <code>true</code>.
		 *
		 * <p>In the following example, the border color is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.border = true;
		 * textRenderer.borderColor = 0xff00ff;</listing>
		 *
		 * @default 0x000000
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#borderColor Full description of flash.text.TextField.borderColor in Adobe's Flash Platform API Reference
		 * @see #border
		 */
		public function get borderColor():uint
		{
			return this._borderColor;
		}

		/**
		 * @private
		 */
		public function set borderColor(value:uint):void
		{
			if(this._borderColor == value)
			{
				return;
			}
			this._borderColor = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _useGutter:Boolean = false;

		/**
		 * Determines if the 2-pixel gutter around the edges of the
		 * <code>flash.text.TextField</code> will be used in measurement and
		 * layout. To visually align with other text renderers and text editors,
		 * it is often best to leave the gutter disabled.
		 *
		 * <p>Returns <code>true</code> if the <code>border</code> property is
		 * <code>true</code>.</p>
		 *
		 * <p>In the following example, the gutter is enabled:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.useGutter = true;</listing>
		 *
		 * @default false
		 */
		public function get useGutter():Boolean
		{
			return this._useGutter || this._border;
		}

		/**
		 * @private
		 */
		public function set useGutter(value:Boolean):void
		{
			if(this._useGutter == value)
			{
				return;
			}
			this._useGutter = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @inheritDoc
		 */
		public function get setTouchFocusOnEndedPhase():Boolean
		{
			return false;
		}

		/**
		 * @private
		 */
		protected var _textFieldHasFocus:Boolean = false;

		/**
		 * @private
		 */
		protected var _isWaitingToSetFocus:Boolean = false;

		/**
		 * @private
		 */
		protected var _pendingSelectionBeginIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get selectionBeginIndex():int
		{
			if(this._pendingSelectionBeginIndex >= 0)
			{
				return this._pendingSelectionBeginIndex;
			}
			if(this.textField)
			{
				return this.textField.selectionBeginIndex;
			}
			return 0;
		}

		/**
		 * @private
		 */
		protected var _pendingSelectionEndIndex:int = -1;

		/**
		 * @inheritDoc
		 */
		public function get selectionEndIndex():int
		{
			if(this._pendingSelectionEndIndex >= 0)
			{
				return this._pendingSelectionEndIndex;
			}
			if(this.textField)
			{
				return this.textField.selectionEndIndex;
			}
			return 0;
		}

		/**
		 * @private
		 */
		protected var _maintainTouchFocus:Boolean = false;

		/**
		 * If enabled, the text editor will remain in focus, even if something
		 * else is touched.
		 *
		 * <p>Note: If the <code>FocusManager</code> is enabled, this property
		 * will be ignored.</p>
		 *
		 * <p>In the following example, touch focus is maintained:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.maintainTouchFocus = true;</listing>
		 *
		 * @default false
		 */
		override public function get maintainTouchFocus():Boolean
		{
			return this._maintainTouchFocus;
		}

		/**
		 * @private
		 */
		public function set maintainTouchFocus(value:Boolean):void
		{
			this._maintainTouchFocus = value;
		}

		/**
		 * @private
		 */
		protected var _updateSnapshotOnScaleChange:Boolean = false;

		/**
		 * Refreshes the texture snapshot every time that the text editor is
		 * scaled. Based on the scale in global coordinates, so scaling the
		 * parent will require a new snapshot.
		 *
		 * <p>Warning: setting this property to true may result in reduced
		 * performance because every change of the scale requires uploading a
		 * new texture to the GPU. Use with caution. Consider setting this
		 * property to false temporarily during animations that modify the
		 * scale.</p>
		 *
		 * <p>In the following example, the snapshot will be updated when the
		 * text editor is scaled:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.updateSnapshotOnScaleChange = true;</listing>
		 *
		 * @default false
		 */
		public function get updateSnapshotOnScaleChange():Boolean
		{
			return this._updateSnapshotOnScaleChange;
		}

		/**
		 * @private
		 */
		public function set updateSnapshotOnScaleChange(value:Boolean):void
		{
			if(this._updateSnapshotOnScaleChange == value)
			{
				return;
			}
			this._updateSnapshotOnScaleChange = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _useSnapshotDelayWorkaround:Boolean = false;

		/**
		 * Fixes an issue where <code>flash.text.TextField</code> renders
		 * incorrectly when drawn to <code>BitmapData</code> by waiting one
		 * frame.
		 *
		 * <p>Warning: enabling this workaround may cause slight flickering
		 * after the <code>text</code> property is changed.</p>
		 *
		 * <p>In the following example, the workaround is enabled:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.useSnapshotDelayWorkaround = true;</listing>
		 *
		 * @default false
		 */
		public function get useSnapshotDelayWorkaround():Boolean
		{
			return this._useSnapshotDelayWorkaround;
		}

		/**
		 * @private
		 */
		public function set useSnapshotDelayWorkaround(value:Boolean):void
		{
			if(this._useSnapshotDelayWorkaround == value)
			{
				return;
			}
			this._useSnapshotDelayWorkaround = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _softKeyboard:String = "default"; //constant is available in AIR only

		/**
		 * Customizes the soft keyboard that is displayed on a touch screen
		 * when the text editor has focus.
		 *
		 * <p>In the following example, the soft keyboard type is customized:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.softKeyboard = SoftKeyboardType.NUMBER;</listing>
		 *
		 * @default flash.text.SoftKeyboardType.DEFAULT
		 *
		 * @see https://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/SoftKeyboardType.html flash.text.SoftKeyboardType
		 */
		public function get softKeyboard():String
		{
			return this._softKeyboard;
		}

		/**
		 * @private
		 */
		public function set softKeyboard(value:String):void
		{
			if(this._softKeyboard === value)
			{
				return;
			}
			this._softKeyboard = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _resetScrollOnFocusOut:Boolean = true;

		/**
		 * Indicates of the text editor resets its current scroll position to
		 * 0 on focus out.
		 *
		 * <p>In the following example, the scroll position is not reset on focus out:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.resetScrollOnFocusOut = false;</listing>
		 *
		 * @default true
		 */
		public function get resetScrollOnFocusOut():Boolean
		{
			return this._resetScrollOnFocusOut;
		}

		/**
		 * @private
		 */
		public function set resetScrollOnFocusOut(value:Boolean):void
		{
			this._resetScrollOnFocusOut = value;
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this.textSnapshot)
			{
				//avoid the need to call dispose(). we'll create a new snapshot
				//when the renderer is added to stage again.
				this.textSnapshot.texture.dispose();
				this.removeChild(this.textSnapshot, true);
				this.textSnapshot = null;
			}

			if(this.textField)
			{
				if(this.textField.parent)
				{
					this.textField.parent.removeChild(this.textField);
				}
				this.textField.removeEventListener(flash.events.Event.CHANGE, textField_changeHandler);
				this.textField.removeEventListener(FocusEvent.FOCUS_IN, textField_focusInHandler);
				this.textField.removeEventListener(FocusEvent.FOCUS_OUT, textField_focusOutHandler);
				this.textField.removeEventListener(KeyboardEvent.KEY_DOWN, textField_keyDownHandler);
				this.textField.removeEventListener(SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING, textField_softKeyboardActivatingHandler);
				this.textField.removeEventListener(SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE, textField_softKeyboardActivateHandler);
				this.textField.removeEventListener(SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE, textField_softKeyboardDeactivateHandler);
			}
			//this isn't necessary, but if a memory leak keeps the text renderer
			//from being garbage collected, freeing up the text field may help
			//ease major memory pressure from native filters
			this.textField = null;
			this.measureTextField = null;

			this.stateContext = null;

			super.dispose();
		}

		/**
		 * @private
		 */
		override public function render(painter:Painter):void
		{
			if(this.textSnapshot !== null && this._updateSnapshotOnScaleChange)
			{
				var matrix:Matrix = Pool.getMatrix();
				this.getTransformationMatrix(this.stage, matrix);
				if(matrixToScaleX(matrix) != this._lastGlobalScaleX ||
					matrixToScaleY(matrix) != this._lastGlobalScaleY)
				{
					//the snapshot needs to be updated because the scale has
					//changed since the last snapshot was taken.
					this.invalidate(INVALIDATION_FLAG_SIZE);
					this.validate();
				}
				Pool.putMatrix(matrix);
			}
			if(this._needsTextureUpdate)
			{
				this._needsTextureUpdate = false;
				if(this._useSnapshotDelayWorkaround)
				{
					//sometimes, we need to wait a frame for flash.text.TextField
					//to render properly when drawing to BitmapData.
					this.addEventListener(Event.ENTER_FRAME, refreshSnapshot_enterFrameHandler);
				}
				else
				{
					this.refreshSnapshot();
				}
				this.positionSnapshot();
			}
			//we'll skip this if the text field isn't visible to avoid running
			//that code every frame.
			if(this.textField && this.textField.visible)
			{
				this.transformTextField();
			}
			super.render(painter);
		}

		/**
		 * @inheritDoc
		 */
		public function setFocus(position:Point = null):void
		{
			if(this.textField !== null)
			{
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				if(this.textField.parent === null)
				{
					starling.nativeStage.addChild(this.textField);
				}
				if(position !== null)
				{
					var nativeScaleFactor:Number = 1;
					if(starling.supportHighResolutions)
					{
						nativeScaleFactor = starling.nativeStage.contentsScaleFactor;
					}
					var scaleFactor:Number = starling.contentScaleFactor / nativeScaleFactor;
					var scaleX:Number = this.textField.scaleX;
					var scaleY:Number = this.textField.scaleY;
					var gutterPositionOffset:Number = 2;
					if(this._useGutter || this._border)
					{
						gutterPositionOffset = 0;
					}
					var positionX:Number = position.x + gutterPositionOffset;
					var positionY:Number = position.y + gutterPositionOffset;
					if(positionX < gutterPositionOffset)
					{
						//account for negative positions
						positionX = gutterPositionOffset;
					}
					else
					{
						var maxPositionX:Number = (this.textField.width / scaleX) - gutterPositionOffset;
						if(positionX > maxPositionX)
						{
							positionX = maxPositionX;
						}
					}
					if(positionY < gutterPositionOffset)
					{
						//account for negative positions
						positionY = gutterPositionOffset;
					}
					else
					{
						var maxPositionY:Number = (this.textField.height / scaleY) - gutterPositionOffset;
						if(positionY > maxPositionY)
						{
							positionY = maxPositionY;
						}
					}
					this._pendingSelectionBeginIndex = this.getSelectionIndexAtPoint(positionX, positionY);
					if(this._pendingSelectionBeginIndex < 0)
					{
						if(this._multiline)
						{
							var lineIndex:int = this.textField.getLineIndexAtPoint((this.textField.width / 2) / scaleX, positionY);
							try
							{
								this._pendingSelectionBeginIndex = this.textField.getLineOffset(lineIndex) + this.textField.getLineLength(lineIndex);
								if(this._pendingSelectionBeginIndex != this._text.length)
								{
									this._pendingSelectionBeginIndex--;
								}
							}
							catch(error:Error)
							{
								//we may be checking for a line beyond the
								//end that doesn't exist
								this._pendingSelectionBeginIndex = this._text.length;
							}
						}
						else
						{
							this._pendingSelectionBeginIndex = this.getSelectionIndexAtPoint(positionX, this.textField.getLineMetrics(0).ascent / 2);
							if(this._pendingSelectionBeginIndex < 0)
							{
								this._pendingSelectionBeginIndex = this._text.length;
							}
						}
					}
					else
					{
						var bounds:Rectangle = this.textField.getCharBoundaries(this._pendingSelectionBeginIndex);
						//bounds should never be null because the character
						//index passed to getCharBoundaries() comes from a
						//call to getCharIndexAtPoint(). however, a user
						//reported that a null reference error happened
						//here! I couldn't reproduce, but I might as well
						//assume that the runtime has a bug. won't hurt.
						if(bounds)
						{
							var boundsX:Number = bounds.x;
							if(bounds && (boundsX + bounds.width - positionX) < (positionX - boundsX))
							{
								this._pendingSelectionBeginIndex++;
							}
						}
					}
					this._pendingSelectionEndIndex = this._pendingSelectionBeginIndex;
				}
				else
				{
					this._pendingSelectionBeginIndex = this._pendingSelectionEndIndex = -1;
				}
				if(!FocusManager.isEnabledForStage(this.stage))
				{
					starling.nativeStage.focus = this.textField;
				}
				this.textField.requestSoftKeyboard();
				if(this._textFieldHasFocus)
				{
					this.invalidate(INVALIDATION_FLAG_SELECTED);
				}
			}
			else
			{
				this._isWaitingToSetFocus = true;
			}
		}

		/**
		 * @inheritDoc
		 */
		public function clearFocus():void
		{
			if(!this._textFieldHasFocus)
			{
				return;
			}
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var nativeStage:Stage = starling.nativeStage;
			if(nativeStage.focus === this.textField)
			{
				//only clear the native focus when our native target has focus
				//because otherwise another component may lose focus.

				//setting the focus to Starling.current.nativeStage doesn't work
				//here, so we need to use null. on Android, if we give focus to the
				//nativeStage, focus will be removed from the StageText, but the
				//soft keyboard will incorrectly remain open.
				nativeStage.focus = null;

				//previously, there was a comment here that said that the native
				//stage focus should not be set to null. this was due to an
				//issue in focus manager where focus would be restored
				//incorrectly if the stage focus became null. this issue was
				//fixed, and it is now considered safe to use null.
			}
		}

		/**
		 * @inheritDoc
		 */
		public function selectRange(beginIndex:int, endIndex:int):void
		{
			if(!this._isEditable && !this._isSelectable)
			{
				return;
			}
			if(this.textField)
			{
				if(!this._isValidating)
				{
					this.validate();
				}
				this.textField.setSelection(beginIndex, endIndex);
			}
			else
			{
				this._pendingSelectionBeginIndex = beginIndex;
				this._pendingSelectionEndIndex = endIndex;
			}
		}

		/**
		 * @inheritDoc
		 */
		public function measureText(result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}

			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			if(!needsWidth && !needsHeight)
			{
				result.x = this._explicitWidth;
				result.y = this._explicitHeight;
				return result;
			}

			//if a parent component validates before we're added to the stage,
			//measureText() may be called before initialization, so we need to
			//force it.
			if(!this._isInitialized)
			{
				this.initializeNow();
			}

			this.commit();

			result = this.measure(result);

			return result;
		}

		/**
		 * Gets the advanced <code>flash.text.TextFormat</code> font formatting
		 * passed in using <code>setTextFormatForState()</code> for the
		 * specified state.
		 *
		 * <p>If an <code>flash.text.TextFormat</code> is not defined for a
		 * specific state, returns <code>null</code>.</p>
		 *
		 * @see #setTextFormatForState()
		 */
		public function getTextFormatForState(state:String):flash.text.TextFormat
		{
			if(this._textFormatForState === null)
			{
				return null;
			}
			return flash.text.TextFormat(this._textFormatForState[state]);
		}

		/**
		 * Sets the advanced <code>flash.text.TextFormat</code> font formatting
		 * to be used by the text editor when the <code>currentState</code>
		 * property of the <code>stateContext</code> matches the specified state
		 * value.
		 *
		 * <p>If an <code>TextFormat</code> is not defined for a specific
		 * state, the value of the <code>textFormat</code> property will be
		 * used instead.</p>
		 *
		 * <p>If the <code>disabledTextFormat</code> property is not
		 * <code>null</code> and the <code>isEnabled</code> property is
		 * <code>false</code>, all other text formats will be ignored.</p>
		 *
		 * @see #stateContext
		 * @see #textFormat
		 */
		public function setTextFormatForState(state:String, textFormat:flash.text.TextFormat):void
		{
			if(textFormat)
			{
				if(!this._textFormatForState)
				{
					this._textFormatForState = {};
				}
				this._textFormatForState[state] = textFormat;
			}
			else
			{
				delete this._textFormatForState[state];
			}
			//if the context's current state is the state that we're modifying,
			//we need to use the new value immediately.
			if(this._stateContext && this._stateContext.currentState === state)
			{
				this.invalidate(INVALIDATION_FLAG_STATE);
			}
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this.textField = new TextField();
			//let's ensure that the text field can only get keyboard focus
			//through code. no need to set mouseEnabled to false since the text
			//field won't be visible until it needs to be interactive, so it
			//can't receive focus with mouse/touch anyway.
			this.textField.tabEnabled = false;
			this.textField.visible = false;
			this.textField.needsSoftKeyboard = true;
			this.textField.addEventListener(flash.events.Event.CHANGE, textField_changeHandler);
			this.textField.addEventListener(FocusEvent.FOCUS_IN, textField_focusInHandler);
			this.textField.addEventListener(FocusEvent.FOCUS_OUT, textField_focusOutHandler);
			this.textField.addEventListener(FocusEvent.MOUSE_FOCUS_CHANGE, textField_mouseFocusChangeHandler);
			this.textField.addEventListener(KeyboardEvent.KEY_DOWN, textField_keyDownHandler);
			this.textField.addEventListener(SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING, textField_softKeyboardActivatingHandler);
			this.textField.addEventListener(SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE, textField_softKeyboardActivateHandler);
			this.textField.addEventListener(SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE, textField_softKeyboardDeactivateHandler);
			//when adding more events here, don't forget to remove them when the
			//text editor is disposed

			this.measureTextField = new TextField();
			this.measureTextField.autoSize = TextFieldAutoSize.LEFT;
			this.measureTextField.selectable = false;
			this.measureTextField.tabEnabled = false;
			this.measureTextField.mouseWheelEnabled = false;
			this.measureTextField.mouseEnabled = false;
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);

			this.commit();

			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;

			this.layout(sizeInvalid);
		}

		/**
		 * @private
		 */
		protected function commit():void
		{
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);

			if(dataInvalid || stylesInvalid || stateInvalid)
			{
				this.refreshTextFormat();
				this.commitStylesAndData(this.textField);
			}
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			var point:Point = Pool.getPoint();
			this.measure(point);
			var result:Boolean = this.saveMeasurements(point.x, point.y, point.x, point.y);
			Pool.putPoint(point);
			return result;
		}

		/**
		 * @private
		 */
		protected function measure(result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}

			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN

			if(!needsWidth && !needsHeight)
			{
				result.x = this._explicitWidth;
				result.y = this._explicitHeight;
				return result;
			}

			this.commitStylesAndData(this.measureTextField);

			var gutterDimensionsOffset:Number = 4;
			if(this._useGutter || this._border)
			{
				gutterDimensionsOffset = 0;
			}

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				this.measureTextField.wordWrap = false;
				newWidth = this.measureTextField.width - gutterDimensionsOffset;
				if(newWidth < this._explicitMinWidth)
				{
					newWidth = this._explicitMinWidth;
				}
				else if(newWidth > this._explicitMaxWidth)
				{
					newWidth = this._explicitMaxWidth;
				}
			}

			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				this.measureTextField.wordWrap = this._wordWrap;
				this.measureTextField.width = newWidth + gutterDimensionsOffset;
				newHeight = this.measureTextField.height - gutterDimensionsOffset;
				if(this._useGutter || this._border)
				{
					newHeight += 4;
				}
				if(newHeight < this._explicitMinHeight)
				{
					newHeight = this._explicitMinHeight;
				}
				else if(newHeight > this._explicitMaxHeight)
				{
					newHeight = this._explicitMaxHeight;
				}
			}

			result.x = newWidth;
			result.y = newHeight;

			return result;
		}

		/**
		 * @private
		 */
		protected function commitStylesAndData(textField:TextField):void
		{
			textField.antiAliasType = this._antiAliasType;
			textField.background = this._background;
			textField.backgroundColor = this._backgroundColor;
			textField.border = this._border;
			textField.borderColor = this._borderColor;
			textField.gridFitType = this._gridFitType;
			textField.sharpness = this._sharpness;
			textField.thickness = this._thickness;
			textField.maxChars = this._maxChars;
			textField.restrict = this._restrict;
			textField.alwaysShowSelection = this._alwaysShowSelection;
			textField.displayAsPassword = this._displayAsPassword;
			textField.wordWrap = this._wordWrap;
			textField.multiline = this._multiline;
			//The softKeyboard property is not available in Flash Player.
			//It's only available in AIR.
			if("softKeyboard" in textField)
			{
				textField["softKeyboard"] = this._softKeyboard;
			}
			if(!this._embedFonts &&
				this._currentTextFormat === this._fontStylesTextFormat)
			{
				//when font styles are passed in from the parent component, we
				//automatically determine if the TextField should use embedded
				//fonts, unless embedFonts is explicitly true
				textField.embedFonts = SystemUtil.isEmbeddedFont(
					this._currentTextFormat.font, this._currentTextFormat.bold,
					this._currentTextFormat.italic, FontType.EMBEDDED);
			}
			else
			{
				textField.embedFonts = this._embedFonts;
			}
			textField.type = this._isEditable ? TextFieldType.INPUT : TextFieldType.DYNAMIC;
			textField.selectable = this._isEnabled && (this._isEditable || this._isSelectable);

			var isFormatDifferent:Boolean = false;
			if(textField === this.textField)
			{
				//for some reason, textField.defaultTextFormat always fails
				//comparison against currentTextFormat. if we save to a member
				//variable and compare against that instead, it works.
				//I guess text field creates a different TextFormat object.
				if(this._currentTextFormat === this._fontStylesTextFormat)
				{
					isFormatDifferent = this._previousStarlingTextFormat !== this._currentStarlingTextFormat;
				}
				else
				{
					isFormatDifferent = this._previousTextFormat !== this._currentTextFormat;
				}
				this._previousStarlingTextFormat = this._currentStarlingTextFormat;
				this._previousTextFormat = this._currentTextFormat;
			}
			else
			{
				//for measurement
				isFormatDifferent = true;
			}
			textField.defaultTextFormat = this._currentTextFormat;

			if(this._isHTML)
			{
				if(isFormatDifferent || textField.htmlText != this._text)
				{
					if(textField == this.textField && this._pendingSelectionBeginIndex < 0)
					{
						//if the TextFormat has changed from the last commit,
						//the selection range may be lost when we set the text
						//so we need to save it to restore later.
						this._pendingSelectionBeginIndex = this.textField.selectionBeginIndex;
						this._pendingSelectionEndIndex = this.textField.selectionEndIndex;
					}
					//the TextField's text should be updated after a TextFormat
					//change because otherwise it will keep using the old one.
					textField.htmlText = this._text;
				}
			}
			else
			{
				if(isFormatDifferent || textField.text != this._text)
				{
					if(textField == this.textField && this._pendingSelectionBeginIndex < 0)
					{
						this._pendingSelectionBeginIndex = this.textField.selectionBeginIndex;
						this._pendingSelectionEndIndex = this.textField.selectionEndIndex;
					}
					textField.text = this._text;
				}
			}
		}

		/**
		 * @private
		 */
		protected function refreshTextFormat():void
		{
			var textFormat:flash.text.TextFormat;
			if(this._stateContext !== null)
			{
				if(this._textFormatForState !== null)
				{
					var currentState:String = this._stateContext.currentState;
					if(currentState in this._textFormatForState)
					{
						textFormat = flash.text.TextFormat(this._textFormatForState[currentState]);
					}
				}
				if(textFormat === null && this._disabledTextFormat !== null &&
					this._stateContext is IFeathersControl && !IFeathersControl(this._stateContext).isEnabled)
				{
					textFormat = this._disabledTextFormat;
				}
			}
			else //no state context
			{
				//we can still check if the text renderer is disabled to see if
				//we should use disabledTextFormat
				if(!this._isEnabled && this._disabledTextFormat !== null)
				{
					textFormat = this._disabledTextFormat;
				}
			}
			if(textFormat === null)
			{
				textFormat = this._textFormat;
			}
			//flash.text.TextFormat is considered more advanced, so it gets
			//precedence over starling.text.TextFormat font styles
			if(textFormat === null)
			{
				textFormat = this.getTextFormatFromFontStyles();
			}
			this._currentTextFormat = textFormat;
		}

		/**
		 * @private
		 */
		protected function getTextFormatFromFontStyles():flash.text.TextFormat
		{
			if(this.isInvalid(INVALIDATION_FLAG_STYLES) ||
				this.isInvalid(INVALIDATION_FLAG_STATE))
			{
				if(this._fontStyles !== null)
				{
					this._currentStarlingTextFormat = this._fontStyles.getTextFormatForTarget(this);
				}
				else
				{
					this._currentStarlingTextFormat = null;
				}
				if(this._currentStarlingTextFormat !== null)
				{
					this._fontStylesTextFormat = this._currentStarlingTextFormat.toNativeFormat(this._fontStylesTextFormat);
				}
				else if(this._fontStylesTextFormat === null)
				{
					//fallback to a default so that something is displayed
					this._fontStylesTextFormat = new flash.text.TextFormat();
				}
			}
			return this._fontStylesTextFormat;
		}

		/**
		 * @private
		 */
		protected function getVerticalAlignment():String
		{
			var verticalAlign:String = null;
			if(this._fontStyles !== null)
			{
				var format:starling.text.TextFormat = this._fontStyles.getTextFormatForTarget(this);
				if(format !== null)
				{
					verticalAlign = format.verticalAlign;
				}
			}
			if(verticalAlign === null)
			{
				verticalAlign = Align.TOP;
			}
			return verticalAlign;
		}

		/**
		 * @private
		 */
		protected function getVerticalAlignmentOffsetY():Number
		{
			var verticalAlign:String = this.getVerticalAlignment();
			var textFieldTextHeight:Number = this.textField.textHeight;
			if(textFieldTextHeight > this.actualHeight)
			{
				return 0;
			}
			if(verticalAlign === Align.BOTTOM)
			{
				return this.actualHeight - textFieldTextHeight;
			}
			else if(verticalAlign === Align.CENTER)
			{
				return (this.actualHeight - textFieldTextHeight) / 2;
			}
			return 0;
		}

		/**
		 * @private
		 */
		protected function layout(sizeInvalid:Boolean):void
		{
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);

			if(sizeInvalid)
			{
				this.refreshSnapshotParameters();
				this.refreshTextFieldSize();
				this.transformTextField();
				this.positionSnapshot();
			}

			this.checkIfNewSnapshotIsNeeded();

			if(!this._textFieldHasFocus && (sizeInvalid || stylesInvalid || dataInvalid || stateInvalid || this._needsNewTexture))
			{
				//we're going to update the texture in render() because
				//there's a chance that it will be updated more than once per
				//frame if we do it here.
				this._needsTextureUpdate = true;
				this.setRequiresRedraw();
			}
			this.doPendingActions();
		}

		/**
		 * @private
		 */
		protected function getSelectionIndexAtPoint(pointX:Number, pointY:Number):int
		{
			return this.textField.getCharIndexAtPoint(pointX, pointY);
		}

		/**
		 * @private
		 */
		protected function refreshTextFieldSize():void
		{
			var gutterDimensionsOffset:Number = 4;
			if(this._useGutter || this._border)
			{
				gutterDimensionsOffset = 0;
			}
			this.textField.width = this.actualWidth + gutterDimensionsOffset;
			this.textField.height = this.actualHeight + gutterDimensionsOffset;
		}

		/**
		 * @private
		 */
		protected function refreshSnapshotParameters():void
		{
			this._textFieldOffsetX = 0;
			this._textFieldOffsetY = 0;
			this._textFieldSnapshotClipRect.x = 0;
			this._textFieldSnapshotClipRect.y = 0;

			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var scaleFactor:Number = starling.contentScaleFactor;
			var clipWidth:Number = this.actualWidth * scaleFactor;
			if(this._updateSnapshotOnScaleChange)
			{
				var matrix:Matrix = Pool.getMatrix();
				this.getTransformationMatrix(this.stage, matrix);
				clipWidth *= matrixToScaleX(matrix);
			}
			if(clipWidth < 0)
			{
				clipWidth = 0;
			}
			var clipHeight:Number = this.actualHeight * scaleFactor;
			if(this._updateSnapshotOnScaleChange)
			{
				clipHeight *= matrixToScaleY(matrix);
				Pool.putMatrix(matrix);
			}
			if(clipHeight < 0)
			{
				clipHeight = 0;
			}
			this._textFieldSnapshotClipRect.width = clipWidth;
			this._textFieldSnapshotClipRect.height = clipHeight;
		}

		/**
		 * @private
		 */
		protected function transformTextField():void
		{
			//there used to be some code here that returned immediately if the
			//TextField wasn't visible. some mobile devices displayed the text
			//at the wrong scale if the TextField weren't transformed before
			//being made visible, so I had to remove it. I moved the visible
			//check into render(), since it can still benefit from the
			//optimization there. see issue #1104.

			var matrix:Matrix = Pool.getMatrix();
			var point:Point = Pool.getPoint();
			this.getTransformationMatrix(this.stage, matrix);
			var globalScaleX:Number = matrixToScaleX(matrix);
			var globalScaleY:Number = matrixToScaleY(matrix);
			var smallerGlobalScale:Number = globalScaleX;
			if(globalScaleY < smallerGlobalScale)
			{
				smallerGlobalScale = globalScaleY;
			}
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var nativeScaleFactor:Number = 1;
			if(starling.supportHighResolutions)
			{
				nativeScaleFactor = starling.nativeStage.contentsScaleFactor;
			}
			var scaleFactor:Number = starling.contentScaleFactor / nativeScaleFactor;
			var gutterPositionOffset:Number = 0;
			if(!this._useGutter || this._border)
			{
				gutterPositionOffset = 2 * smallerGlobalScale;
			}
			var verticalAlignOffsetY:Number = this.getVerticalAlignmentOffsetY();
			if(this.is3D)
			{
				var matrix3D:Matrix3D = Pool.getMatrix3D();
				var point3D:Vector3D = Pool.getPoint3D();
				this.getTransformationMatrix3D(this.stage, matrix3D);
				MatrixUtil.transformCoords3D(matrix3D, -gutterPositionOffset, -gutterPositionOffset + verticalAlignOffsetY, 0, point3D);
				point.setTo(point3D.x, point3D.y);
				Pool.putPoint3D(point3D);
				Pool.putMatrix3D(matrix3D);
			}
			else
			{
				MatrixUtil.transformCoords(matrix, -gutterPositionOffset, -gutterPositionOffset + verticalAlignOffsetY, point);
			}
			var starlingViewPort:Rectangle = starling.viewPort;
			this.textField.x = Math.round(starlingViewPort.x + (point.x * scaleFactor));
			this.textField.y = Math.round(starlingViewPort.y + (point.y * scaleFactor));
			this.textField.rotation = matrixToRotation(matrix) * 180 / Math.PI;
			this.textField.scaleX = matrixToScaleX(matrix) * scaleFactor;
			this.textField.scaleY = matrixToScaleY(matrix) * scaleFactor;

			Pool.putPoint(point);
			Pool.putMatrix(matrix);
		}

		/**
		 * @private
		 */
		protected function positionSnapshot():void
		{
			if(!this.textSnapshot)
			{
				return;
			}
			var matrix:Matrix = Pool.getMatrix();
			this.getTransformationMatrix(this.stage, matrix);
			this.textSnapshot.x = Math.round(matrix.tx) - matrix.tx;
			this.textSnapshot.y = Math.round(matrix.ty) - matrix.ty;
			this.textSnapshot.y += this.getVerticalAlignmentOffsetY();
			Pool.putMatrix(matrix);
		}

		/**
		 * @private
		 */
		protected function checkIfNewSnapshotIsNeeded():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var canUseRectangleTexture:Boolean = starling.profile !== Context3DProfile.BASELINE_CONSTRAINED;
			if(canUseRectangleTexture)
			{
				this._snapshotWidth = this._textFieldSnapshotClipRect.width;
				this._snapshotHeight = this._textFieldSnapshotClipRect.height;
			}
			else
			{
				this._snapshotWidth = MathUtil.getNextPowerOfTwo(this._textFieldSnapshotClipRect.width);
				this._snapshotHeight = MathUtil.getNextPowerOfTwo(this._textFieldSnapshotClipRect.height);
			}
			var textureRoot:ConcreteTexture = this.textSnapshot ? this.textSnapshot.texture.root : null;
			this._needsNewTexture = this._needsNewTexture || !this.textSnapshot ||
				(textureRoot !== null && (textureRoot.scale != starling.contentScaleFactor ||
				this._snapshotWidth != textureRoot.nativeWidth || this._snapshotHeight != textureRoot.nativeHeight));
		}

		/**
		 * @private
		 */
		protected function doPendingActions():void
		{
			if(this._isWaitingToSetFocus)
			{
				this._isWaitingToSetFocus = false;
				this.setFocus();
			}

			if(this._pendingSelectionBeginIndex >= 0)
			{
				var startIndex:int = this._pendingSelectionBeginIndex;
				var endIndex:int = this._pendingSelectionEndIndex;
				this._pendingSelectionBeginIndex = -1;
				this._pendingSelectionEndIndex = -1;
				this.selectRange(startIndex, endIndex);
			}
		}

		/**
		 * @private
		 */
		protected function texture_onRestore():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			if(this.textSnapshot && this.textSnapshot.texture &&
				this.textSnapshot.texture.scale != starling.contentScaleFactor)
			{
				//if we've changed between scale factors, we need to recreate
				//the texture to match the new scale factor.
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this.refreshSnapshot();
			}
		}

		/**
		 * @private
		 */
		protected function refreshSnapshot():void
		{
			if(this._snapshotWidth <= 0 || this._snapshotHeight <= 0)
			{
				return;
			}
			var gutterPositionOffset:Number = 2;
			if(this._useGutter || this._border)
			{
				gutterPositionOffset = 0;
			}
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var scaleFactor:Number = starling.contentScaleFactor;
			var matrix:Matrix = Pool.getMatrix();
			if(this._updateSnapshotOnScaleChange)
			{
				this.getTransformationMatrix(this.stage, matrix);
				var globalScaleX:Number = matrixToScaleX(matrix);
				var globalScaleY:Number = matrixToScaleY(matrix);
			}
			matrix.identity();
			matrix.translate(this._textFieldOffsetX - gutterPositionOffset, this._textFieldOffsetY - gutterPositionOffset);
			matrix.scale(scaleFactor, scaleFactor);
			if(this._updateSnapshotOnScaleChange)
			{
				matrix.scale(globalScaleX, globalScaleY);
			}
			var bitmapData:BitmapData = new BitmapData(this._snapshotWidth, this._snapshotHeight, true, 0x00ff00ff);
			bitmapData.draw(this.textField, matrix, null, null, this._textFieldSnapshotClipRect);
			Pool.putMatrix(matrix);
			var newTexture:Texture;
			if(!this.textSnapshot || this._needsNewTexture)
			{
				//skip Texture.fromBitmapData() because we don't want
				//it to create an onRestore function that will be
				//immediately discarded for garbage collection.
				newTexture = Texture.empty(bitmapData.width / scaleFactor, bitmapData.height / scaleFactor,
					true, false, false, scaleFactor);
				newTexture.root.uploadBitmapData(bitmapData);
				newTexture.root.onRestore = texture_onRestore;
			}
			if(!this.textSnapshot)
			{
				this.textSnapshot = new Image(newTexture);
				this.textSnapshot.pixelSnapping = true;
				this.addChild(this.textSnapshot);
			}
			else
			{
				if(this._needsNewTexture)
				{
					this.textSnapshot.texture.dispose();
					this.textSnapshot.texture = newTexture;
					this.textSnapshot.readjustSize();
				}
				else
				{
					//this is faster, if we haven't resized the bitmapdata
					var existingTexture:Texture = this.textSnapshot.texture;
					existingTexture.root.uploadBitmapData(bitmapData);
					//however, the image won't be notified that its
					//texture has changed, so we need to do it manually
					this.textSnapshot.setRequiresRedraw();
				}
			}
			if(this._updateSnapshotOnScaleChange)
			{
				this.textSnapshot.scaleX = 1 / globalScaleX;
				this.textSnapshot.scaleY = 1 / globalScaleY;
				this._lastGlobalScaleX = globalScaleX;
				this._lastGlobalScaleY = globalScaleY;
			}
			this.textSnapshot.alpha = this._text.length > 0 ? 1 : 0;
			bitmapData.dispose();
			this._needsNewTexture = false;
		}

		/**
		 * @private
		 */
		protected function textEditor_addedToStageHandler(event:Event):void
		{
			if(this.textField.parent === null)
			{
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				//the text field needs to be on the native stage to measure properly
				starling.nativeStage.addChild(this.textField);
			}
		}

		/**
		 * @private
		 */
		protected function textEditor_removedFromStageHandler(event:Event):void
		{
			if(this.textField.parent)
			{
				//remove this from the stage, if needed
				//it will be added back next time we receive focus
				this.textField.parent.removeChild(this.textField);
			}
		}

		/**
		 * @private
		 */
		protected function hasFocus_enterFrameHandler(event:Event):void
		{
			if(this.textSnapshot)
			{
				this.textSnapshot.visible = !this._textFieldHasFocus;
			}
			this.textField.visible = this._textFieldHasFocus;

			if(this._textFieldHasFocus)
			{
				var target:DisplayObject = this;
				do
				{
					if(!target.visible)
					{
						this.clearFocus();
						break;
					}
					target = target.parent;
				}
				while(target);
			}
			else
			{
				this.removeEventListener(Event.ENTER_FRAME, hasFocus_enterFrameHandler);
			}
		}

		/**
		 * @private
		 */
		protected function refreshSnapshot_enterFrameHandler(event:Event):void
		{
			this.removeEventListener(Event.ENTER_FRAME, refreshSnapshot_enterFrameHandler);
			this.refreshSnapshot();
		}

		/**
		 * @private
		 */
		protected function stage_touchHandler(event:TouchEvent):void
		{
			if(this._maintainTouchFocus || FocusManager.isEnabledForStage(this.stage))
			{
				return;
			}
			var touch:Touch = event.getTouch(this.stage, TouchPhase.BEGAN);
			if(!touch) //we only care about began touches
			{
				return;
			}
			var point:Point = Pool.getPoint();
			touch.getLocation(this.stage, point);
			var isInBounds:Boolean = this.contains(this.stage.hitTest(point));
			Pool.putPoint(point);
			if(isInBounds) //if the touch is in the text editor, it's all good
			{
				return;
			}
			//if the touch begins anywhere else, it's a focus out!
			this.clearFocus();
		}

		/**
		 * @private
		 */
		protected function textField_changeHandler(event:flash.events.Event):void
		{
			if(this._isHTML)
			{
				this.text = this.textField.htmlText;
			}
			else
			{
				this.text = this.textField.text;
			}
		}

		/**
		 * @private
		 */
		protected function textField_focusInHandler(event:FocusEvent):void
		{
			this._textFieldHasFocus = true;
			this.stage.addEventListener(TouchEvent.TOUCH, stage_touchHandler);
			this.addEventListener(Event.ENTER_FRAME, hasFocus_enterFrameHandler);
			this.dispatchEventWith(FeathersEventType.FOCUS_IN);
		}

		/**
		 * @private
		 */
		protected function textField_focusOutHandler(event:FocusEvent):void
		{
			this._textFieldHasFocus = false;
			this.stage.removeEventListener(TouchEvent.TOUCH, stage_touchHandler);

			if(this._resetScrollOnFocusOut)
			{
				this.textField.scrollH = this.textField.scrollV = 0;
			}

			//the text may have changed, so we invalidate the data flag
			this.invalidate(INVALIDATION_FLAG_DATA);
			this.dispatchEventWith(FeathersEventType.FOCUS_OUT);
		}

		/**
		 * @private
		 */
		protected function textField_mouseFocusChangeHandler(event:FocusEvent):void
		{
			if(!this._maintainTouchFocus)
			{
				return;
			}
			event.preventDefault();
		}

		/**
		 * @private
		 */
		protected function textField_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.keyCode == Keyboard.ENTER)
			{
				this.dispatchEventWith(FeathersEventType.ENTER);
			}
			else if(!FocusManager.isEnabledForStage(this.stage) && event.keyCode == Keyboard.TAB)
			{
				this.clearFocus();
			}
		}

		/**
		 * @private
		 */
		protected function textField_softKeyboardActivateHandler(event:SoftKeyboardEvent):void
		{
			this.dispatchEventWith(FeathersEventType.SOFT_KEYBOARD_ACTIVATE, true);
		}

		/**
		 * @private
		 */
		protected function textField_softKeyboardActivatingHandler(event:SoftKeyboardEvent):void
		{
			this.dispatchEventWith(FeathersEventType.SOFT_KEYBOARD_ACTIVATING, true);
		}

		/**
		 * @private
		 */
		protected function textField_softKeyboardDeactivateHandler(event:SoftKeyboardEvent):void
		{
			this.dispatchEventWith(FeathersEventType.SOFT_KEYBOARD_DEACTIVATE, true);
		}

		/**
		 * @private
		 */
		override protected function fontStylesSet_changeHandler(event:Event):void
		{
			this._previousStarlingTextFormat = null;
			super.fontStylesSet_changeHandler(event);
		}
	}
}


================================================
FILE: source/feathers/controls/text/TextFieldTextEditorViewPort.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.text
{
	import feathers.controls.Scroller;
	import feathers.skins.IStyleProvider;
	import feathers.utils.geom.matrixToRotation;
	import feathers.utils.geom.matrixToScaleX;
	import feathers.utils.geom.matrixToScaleY;
	import feathers.utils.math.roundToNearest;

	import flash.events.Event;
	import flash.events.FocusEvent;
	import flash.geom.Matrix;
	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.text.TextField;

	import starling.core.Starling;
	import starling.utils.MatrixUtil;
	import starling.utils.Pool;

	/**
	 * A text editor view port for the <code>TextArea</code> component that uses
	 * <code>flash.text.TextField</code>.
	 *
	 * @see feathers.controls.TextArea
	 *
	 * @productversion Feathers 1.1.0
	 */
	public class TextFieldTextEditorViewPort extends TextFieldTextEditor implements ITextEditorViewPort
	{
		/**
		 * The default <code>IStyleProvider</code> for all <code>TextFieldTextEditorViewPort</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function TextFieldTextEditorViewPort()
		{
			super();
			this.multiline = true;
			this.wordWrap = true;
			this.resetScrollOnFocusOut = false;
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return globalStyleProvider;
		}

		/**
		 * @private
		 */
		private var _ignoreScrolling:Boolean = false;

		private var _actualMinVisibleWidth:Number = 0;

		private var _explicitMinVisibleWidth:Number;

		public function get minVisibleWidth():Number
		{
			if(this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth) //isNaN
			{
				return this._actualMinVisibleWidth;
			}
			return this._explicitMinVisibleWidth;
		}

		public function set minVisibleWidth(value:Number):void
		{
			if(this._explicitMinVisibleWidth == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth) //isNaN
			{
				return;
			}
			var oldValue:Number = this._explicitMinVisibleWidth;
			this._explicitMinVisibleWidth = value;
			if(valueIsNaN)
			{
				this._actualMinVisibleWidth = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this._actualMinVisibleWidth = value;
				if(this._explicitVisibleWidth !== this._explicitVisibleWidth && //isNaN
					(this._actualVisibleWidth < value || this._actualVisibleWidth == oldValue))
				{
					//only invalidate if this change might affect the visibleWidth
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		private var _maxVisibleWidth:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleWidth():Number
		{
			return this._maxVisibleWidth;
		}

		public function set maxVisibleWidth(value:Number):void
		{
			if(this._maxVisibleWidth == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleWidth cannot be NaN");
			}
			var oldValue:Number = this._maxVisibleWidth;
			this._maxVisibleWidth = value;
			if(this._explicitVisibleWidth !== this._explicitVisibleWidth && //isNaN
				(this._actualVisibleWidth > value || this._actualVisibleWidth == oldValue))
			{
				//only invalidate if this change might affect the visibleWidth
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualVisibleWidth:Number = 0;

		private var _explicitVisibleWidth:Number;

		public function get visibleWidth():Number
		{
			if(this._explicitVisibleWidth !== this._explicitVisibleWidth) //isNaN
			{
				return this._actualVisibleWidth;
			}
			return this._explicitVisibleWidth;
		}

		public function set visibleWidth(value:Number):void
		{
			if(this._explicitVisibleWidth == value ||
				(value !== value && this._explicitVisibleWidth !== this._explicitVisibleWidth)) //isNaN
			{
				return;
			}
			this._explicitVisibleWidth = value;
			if(this._actualVisibleWidth != value)
			{
				this._actualVisibleWidth = value;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualMinVisibleHeight:Number = 0;

		private var _explicitMinVisibleHeight:Number;

		public function get minVisibleHeight():Number
		{
			if(this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight) //isNaN
			{
				return this._actualMinVisibleHeight;
			}
			return this._explicitMinVisibleHeight;
		}

		public function set minVisibleHeight(value:Number):void
		{
			if(this._explicitMinVisibleHeight == value)
			{
				return;
			}
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight) //isNaN
			{
				return;
			}
			var oldValue:Number = this._explicitMinVisibleHeight;
			this._explicitMinVisibleHeight = value;
			if(valueIsNaN)
			{
				this._actualMinVisibleHeight = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				this._actualMinVisibleHeight = value;
				if(this._explicitVisibleHeight !== this._explicitVisibleHeight && //isNaN
					(this._actualVisibleHeight < value || this._actualVisibleHeight == oldValue))
				{
					//only invalidate if this change might affect the visibleHeight
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		private var _maxVisibleHeight:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleHeight():Number
		{
			return this._maxVisibleHeight;
		}

		public function set maxVisibleHeight(value:Number):void
		{
			if(this._maxVisibleHeight == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleHeight cannot be NaN");
			}
			var oldValue:Number = this._maxVisibleHeight;
			this._maxVisibleHeight = value;
			if(this._explicitVisibleHeight !== this._explicitVisibleHeight && //isNaN
				(this._actualVisibleHeight > value || this._actualVisibleHeight == oldValue))
			{
				//only invalidate if this change might affect the visibleHeight
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		private var _actualVisibleHeight:Number = 0;

		private var _explicitVisibleHeight:Number;

		public function get visibleHeight():Number
		{
			if(this._explicitVisibleHeight !== this._explicitVisibleHeight) //isNaN
			{
				return this._actualVisibleHeight;
			}
			return this._explicitVisibleHeight;
		}

		public function set visibleHeight(value:Number):void
		{
			if(this._explicitVisibleHeight == value ||
				(value !== value && this._explicitVisibleHeight !== this._explicitVisibleHeight)) //isNaN
			{
				return;
			}
			this._explicitVisibleHeight = value;
			if(this._actualVisibleHeight != value)
			{
				this._actualVisibleHeight = value;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		/**
		 * @private
		 */
		public function get contentX():Number
		{
			return 0;
		}

		/**
		 * @private
		 */
		public function get contentY():Number
		{
			return 0;
		}

		/**
		 * @private
		 */
		protected var _scrollStep:int = 0;

		/**
		 * @private
		 */
		public function get horizontalScrollStep():Number
		{
			return this._scrollStep;
		}

		/**
		 * @private
		 */
		public function get verticalScrollStep():Number
		{
			return this._scrollStep;
		}

		/**
		 * @private
		 */
		private var _horizontalScrollPosition:Number = 0;

		/**
		 * @private
		 */
		public function get horizontalScrollPosition():Number
		{
			return this._horizontalScrollPosition;
		}

		/**
		 * @private
		 */
		public function set horizontalScrollPosition(value:Number):void
		{
			//this value is basically ignored because the text does not scroll
			//horizontally. instead, it wraps.
			this._horizontalScrollPosition = value;
		}

		/**
		 * @private
		 */
		private var _verticalScrollPosition:Number = 0;

		/**
		 * @private
		 */
		public function get verticalScrollPosition():Number
		{
			return this._verticalScrollPosition;
		}

		/**
		 * @private
		 */
		public function set verticalScrollPosition(value:Number):void
		{
			if(this._verticalScrollPosition == value)
			{
				return;
			}
			this._verticalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
			//hack because the superclass doesn't know about the scroll flag
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		public function get requiresMeasurementOnScroll():Boolean
		{
			return false;
		}

		/**
		 * @private
		 */
		override public function get baseline():Number
		{
			return super.baseline + this._paddingTop + this._verticalScrollPosition;
		}

		/**
		 * Quickly sets all padding properties to the same value. The
		 * <code>padding</code> getter always returns the value of
		 * <code>paddingTop</code>, but the other padding values may be
		 * different.
		 *
		 * @default 0
		 *
		 * @see #paddingTop
		 * @see #paddingRight
		 * @see #paddingBottom
		 * @see #paddingLeft
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * The minimum space, in pixels, between the view port's top edge and
		 * the view port's content.
		 *
		 * @default 0
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * The minimum space, in pixels, between the view port's right edge and
		 * the view port's content.
		 *
		 * @default 0
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * The minimum space, in pixels, between the view port's bottom edge and
		 * the view port's content.
		 *
		 * @default 0
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * The minimum space, in pixels, between the view port's left edge and
		 * the view port's content.
		 *
		 * @default 0
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override public function setFocus(position:Point = null):void
		{
			if(position !== null)
			{
				position.x -= this._paddingLeft;
				position.y -= this._paddingTop;
			}
			super.setFocus(position);
		}

		/**
		 * @private
		 */
		override protected function autoSizeIfNeeded():Boolean
		{
			var result:Boolean = super.autoSizeIfNeeded();
			var needsWidth:Boolean = this._explicitVisibleWidth !== this._explicitVisibleWidth; //isNaN
			var needsHeight:Boolean = this._explicitVisibleHeight !== this._explicitVisibleHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return result;
			}
			if(needsWidth)
			{
				this._actualVisibleWidth = this.actualWidth;
			}
			if(needsHeight)
			{
				this._actualVisibleHeight = this.actualHeight;
			}
			if(needsMinWidth)
			{
				this._actualMinVisibleWidth = this.actualMinWidth;
			}
			if(needsMinHeight)
			{
				this._actualMinVisibleHeight = this.actualMinHeight;
			}
			return result;
		}

		/**
		 * @private
		 */
		override protected function measure(result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}

			var needsWidth:Boolean = this._explicitVisibleWidth !== this._explicitVisibleWidth; //isNaN

			this.commitStylesAndData(this.measureTextField);

			var gutterDimensionsOffset:Number = 4;
			if(this._useGutter)
			{
				gutterDimensionsOffset = 0;
			}

			var newWidth:Number = this._explicitVisibleWidth;
			this.measureTextField.width = newWidth - this._paddingLeft - this._paddingRight + gutterDimensionsOffset;
			if(needsWidth)
			{
				//this.measureTextField.wordWrap = false;
				newWidth = this.measureTextField.width + this._paddingLeft + this._paddingRight - gutterDimensionsOffset;
				if(this._explicitMinVisibleWidth === this._explicitMinVisibleWidth && //!isNaN
					newWidth < this._explicitMinVisibleWidth)
				{
					newWidth = this._explicitMinVisibleWidth;
				}
				else if(newWidth > this._maxVisibleWidth)
				{
					newWidth = this._maxVisibleWidth;
				}
			}
			//this.measureTextField.width = newWidth - this._paddingLeft - this._paddingRight + gutterDimensionsOffset;
			//this.measureTextField.wordWrap = true;
			var newHeight:Number = this.measureTextField.height + this._paddingTop + this._paddingBottom - gutterDimensionsOffset;
			if(this._useGutter)
			{
				newHeight += 4;
			}
			if(this._explicitVisibleHeight === this._explicitVisibleHeight) //!isNaN
			{
				if(newHeight < this._explicitVisibleHeight)
				{
					newHeight = this._explicitVisibleHeight;
				}
			}
			else if(this._explicitMinVisibleHeight === this._explicitMinVisibleHeight) //!isNaN
			{
				if(newHeight < this._explicitMinVisibleHeight)
				{
					newHeight = this._explicitMinVisibleHeight;
				}
			}

			result.x = newWidth;
			result.y = newHeight;

			return result;
		}

		/**
		 * @private
		 */
		override protected function refreshSnapshotParameters():void
		{
			var textFieldWidth:Number = this._actualVisibleWidth - this._paddingLeft - this._paddingRight;
			if(textFieldWidth !== textFieldWidth) //isNaN
			{
				if(this._maxVisibleWidth < Number.POSITIVE_INFINITY)
				{
					textFieldWidth = this._maxVisibleWidth - this._paddingLeft - this._paddingRight;
				}
				else
				{
					textFieldWidth = this._actualMinVisibleWidth - this._paddingLeft - this._paddingRight;
				}
			}
			var textFieldHeight:Number = this._actualVisibleHeight - this._paddingTop - this._paddingBottom;
			if(textFieldHeight !== textFieldHeight) //isNaN
			{
				if(this._maxVisibleHeight < Number.POSITIVE_INFINITY)
				{
					textFieldHeight = this._maxVisibleHeight - this._paddingTop - this._paddingBottom;
				}
				else
				{
					textFieldHeight = this._actualMinVisibleHeight - this._paddingTop - this._paddingBottom;
				}
			}

			this._textFieldOffsetX = 0;
			this._textFieldOffsetY = 0;
			this._textFieldSnapshotClipRect.x = 0;
			this._textFieldSnapshotClipRect.y = 0;

			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var scaleFactor:Number = starling.contentScaleFactor;
			var clipWidth:Number = textFieldWidth * scaleFactor;
			if(this._updateSnapshotOnScaleChange)
			{
				var matrix:Matrix = Pool.getMatrix();
				this.getTransformationMatrix(this.stage, matrix);
				clipWidth *= matrixToScaleX(matrix);
			}
			if(clipWidth < 0)
			{
				clipWidth = 0;
			}
			var clipHeight:Number = textFieldHeight * scaleFactor;
			if(this._updateSnapshotOnScaleChange)
			{
				clipHeight *= matrixToScaleY(matrix);
				Pool.putMatrix(matrix);
			}
			if(clipHeight < 0)
			{
				clipHeight = 0;
			}
			this._textFieldSnapshotClipRect.width = clipWidth;
			this._textFieldSnapshotClipRect.height = clipHeight;
		}

		/**
		 * @private
		 */
		override protected function refreshTextFieldSize():void
		{
			var oldIgnoreScrolling:Boolean = this._ignoreScrolling;
			var gutterDimensionsOffset:Number = 4;
			if(this._useGutter)
			{
				gutterDimensionsOffset = 0;
			}
			this._ignoreScrolling = true;
			this.textField.width = this._actualVisibleWidth - this._paddingLeft - this._paddingRight + gutterDimensionsOffset;
			var textFieldHeight:Number = this._actualVisibleHeight - this._paddingTop - this._paddingBottom + gutterDimensionsOffset;
			if(this.textField.height != textFieldHeight)
			{
				this.textField.height = textFieldHeight;
			}
			var scroller:Scroller = Scroller(this.parent);
			this.textField.scrollV = Math.round(1 + ((this.textField.maxScrollV - 1) * (this._verticalScrollPosition / scroller.maxVerticalScrollPosition)));
			this._ignoreScrolling = oldIgnoreScrolling;
		}

		/**
		 * @private
		 */
		override protected function commitStylesAndData(textField:TextField):void
		{
			super.commitStylesAndData(textField);
			if(textField == this.textField)
			{
				this._scrollStep = textField.getLineMetrics(0).height;
			}
		}

		/**
		 * @private
		 */
		override protected function transformTextField():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var nativeScaleFactor:Number = 1;
			if(starling.supportHighResolutions)
			{
				nativeScaleFactor = starling.nativeStage.contentsScaleFactor;
			}
			var scaleFactor:Number = starling.contentScaleFactor / nativeScaleFactor;
			var matrix:Matrix = Pool.getMatrix();
			var point:Point = Pool.getPoint();
			this.getTransformationMatrix(this.stage, matrix);
			MatrixUtil.transformCoords(matrix, 0, 0, point);
			var scaleX:Number = matrixToScaleX(matrix) * scaleFactor;
			var scaleY:Number = matrixToScaleY(matrix) * scaleFactor;
			var offsetX:Number = Math.round(this._paddingLeft * scaleX);
			var offsetY:Number = Math.round((this._paddingTop + this._verticalScrollPosition) * scaleY);
			var starlingViewPort:Rectangle = starling.viewPort;
			var gutterPositionOffset:Number = 2;
			if(this._useGutter)
			{
				gutterPositionOffset = 0;
			}
			this.textField.x = offsetX + Math.round(starlingViewPort.x + (point.x * scaleFactor) - gutterPositionOffset * scaleX);
			this.textField.y = offsetY + Math.round(starlingViewPort.y + (point.y * scaleFactor) - gutterPositionOffset * scaleY);
			this.textField.rotation = matrixToRotation(matrix) * 180 / Math.PI;
			this.textField.scaleX = scaleX;
			this.textField.scaleY = scaleY;
			Pool.putPoint(point);
			Pool.putMatrix(matrix);
		}

		/**
		 * @private
		 */
		override protected function positionSnapshot():void
		{
			if(!this.textSnapshot)
			{
				return;
			}
			var matrix:Matrix = Pool.getMatrix();
			this.getTransformationMatrix(this.stage, matrix);
			this.textSnapshot.x = this._paddingLeft + Math.round(matrix.tx) - matrix.tx;
			this.textSnapshot.y = this._paddingTop + this._verticalScrollPosition + Math.round(matrix.ty) - matrix.ty;
			Pool.putMatrix(matrix);
		}

		/**
		 * @private
		 */
		override protected function checkIfNewSnapshotIsNeeded():void
		{
			super.checkIfNewSnapshotIsNeeded();
			this._needsNewTexture ||= this.isInvalid(INVALIDATION_FLAG_SCROLL);
		}

		/**
		 * @private
		 */
		override protected function textField_focusInHandler(event:FocusEvent):void
		{
			this.textField.addEventListener(Event.SCROLL, textField_scrollHandler);
			super.textField_focusInHandler(event);
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		override protected function textField_focusOutHandler(event:FocusEvent):void
		{
			this.textField.removeEventListener(Event.SCROLL, textField_scrollHandler);
			super.textField_focusOutHandler(event);
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected function textField_scrollHandler(event:Event):void
		{
			//for some reason, the text field's scroll positions don't work
			//properly unless we access the values here. weird.
			var scrollH:Number = this.textField.scrollH;
			var scrollV:Number = this.textField.scrollV;
			if(this._ignoreScrolling)
			{
				return;
			}
			var scroller:Scroller = Scroller(this.parent);
			if(scroller.maxVerticalScrollPosition > 0 && this.textField.maxScrollV > 1)
			{
				var calculatedVerticalScrollPosition:Number = scroller.maxVerticalScrollPosition * (scrollV - 1) / (this.textField.maxScrollV - 1);
				scroller.verticalScrollPosition = roundToNearest(calculatedVerticalScrollPosition, this._scrollStep);
			}
		}

	}
}


================================================
FILE: source/feathers/controls/text/TextFieldTextRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.controls.text
{
	import feathers.core.IFeathersControl;
	import feathers.core.ITextRenderer;
	import feathers.core.IToggle;
	import feathers.skins.IStyleProvider;
	import feathers.utils.geom.matrixToScaleX;
	import feathers.utils.geom.matrixToScaleY;
	import feathers.utils.math.roundUpToNearest;
	import feathers.utils.textures.calculateSnapshotTextureDimensions;

	import flash.display.BitmapData;
	import flash.display3D.Context3DProfile;
	import flash.filters.BitmapFilter;
	import flash.geom.Matrix;
	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.text.AntiAliasType;
	import flash.text.FontType;
	import flash.text.GridFitType;
	import flash.text.StyleSheet;
	import flash.text.TextField;
	import flash.text.TextFieldAutoSize;
	import flash.text.TextFormat;

	import starling.core.Starling;
	import starling.display.Image;
	import starling.events.Event;
	import starling.rendering.Painter;
	import starling.text.TextFormat;
	import starling.textures.ConcreteTexture;
	import starling.textures.Texture;
	import starling.utils.Align;
	import starling.utils.MathUtil;
	import starling.utils.Pool;
	import starling.utils.SystemUtil;

	/**
	 * Renders text with a native <code>flash.text.TextField</code> and draws
	 * it to <code>BitmapData</code> before uploading it to a texture on the
	 * GPU. Textures are managed internally by this component, and they will be
	 * automatically disposed when the component is disposed.
	 *
	 * <p>For longer passages of text, this component will stitch together
	 * multiple individual textures both horizontally and vertically, as a grid,
	 * if required. This may require quite a lot of texture memory, possibly
	 * exceeding the limits of some mobile devices, so use this component with
	 * caution when displaying a lot of text.</p>
	 *
	 * <p>The following example shows how to use
	 * <code>TextFieldTextRenderer</code> with a <code>Label</code>:</p>
	 *
	 * <listing version="3.0">
	 * var label:Label = new Label();
	 * label.text = "I am the very model of a modern Major General";
	 * label.textRendererFactory = function():ITextRenderer
	 * {
	 *     return new TextFieldTextRenderer();
	 * };
	 * this.addChild( label );</listing>
	 *
	 * <strong>Embedding Fonts</strong>
	 *
	 * <p>This text renderer supports embedded TrueType or OpenType fonts.</p>
	 *
	 * <p>In the following example, a TrueType font is included with
	 * <code>[Embed]</code> metadata:</p>
	 *
	 * <listing version="3.0">
	 * [Embed(source="path/to/font.ttf",fontFamily="MyCustomFont",fontWeight="normal",fontStyle="normal",mimeType="application/x-font",embedAsCFF="false")]
	 * private static const MY_CUSTOM_FONT:Class;</listing>
	 *
	 * <p>The <code>source</code> field should point to the font file, relative
	 * to the current <code>.as</code> file that contains the metadata.</p>
	 *
	 * <p>Set the <code>fontFamily</code> field to the string value that you
	 * want to use when referencing this font in code. For example, you would
	 * use this name when you create a <code>starling.text.TextFormat</code>
	 * object. Replace "MyCustomFont" with an appropriate name for your font.</p>
	 *
	 * <p><strong>Tip:</strong> For best results, try not to set the exact same
	 * name in the <code>fontFamily</code> field as the name of device font
	 * installed on your system. Debugging embedded font issues can be
	 * frustrating when you see the correct font on your development computer,
	 * but it's a different font on other devices. If you use a font name that
	 * doesn't exist on your development computer, you'll see when something is
	 * wrong immediately, instead of discovering it later when you're testing
	 * on other devices.</p>
	 *
	 * <p>If the font is bold, set the <code>fontWeight</code> field to "bold".
	 * Otherwise, set it to "normal".</p>
	 *
	 * <p>If the font is italic, set the <code>fontStyle</code> field to
	 * "italic". Otherwise, set it to "normal".</p>
	 *
	 * <p>Since the text renderer is based on <code>flash.text.TextField</code>,
	 * you <strong>must</strong> set the <code>embedAsCFF</code> field to
	 * "false".</p>
	 *
	 * @see ../../../../help/text-renderers.html Introduction to Feathers text renderers
	 * @see ../../../../help/text-field-text-renderer.html How to use the Feathers TextFieldTextRenderer component
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html flash.text.TextField
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class TextFieldTextRenderer extends BaseTextRenderer implements ITextRenderer
	{
		/**
		 * @private
		 */
		private static const HELPER_POINT:Point = new Point();

		/**
		 * @private
		 */
		private static const HELPER_MATRIX:Matrix = new Matrix();

		/**
		 * @private
		 */
		private static const HELPER_RECTANGLE:Rectangle = new Rectangle();

		/**
		 * The default <code>IStyleProvider</code> for all <code>TextFieldTextRenderer</code>
		 * components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function TextFieldTextRenderer()
		{
			if(this._text === null)
			{
				//flash.text.TextField won't accept a null value
				this._text = "";
			}
			super();
			this.isQuickHitAreaEnabled = true;
		}

		/**
		 * The TextField instance used to render the text before taking a
		 * texture snapshot.
		 */
		protected var textField:TextField;

		/**
		 * An image that displays a snapshot of the native <code>TextField</code>
		 * in the Starling display list when the editor doesn't have focus.
		 */
		protected var textSnapshot:Image;

		/**
		 * If multiple snapshots are needed due to texture size limits, the
		 * snapshots appearing after the first are stored here.
		 */
		protected var textSnapshots:Vector.<Image>;

		/**
		 * @private
		 */
		protected var _textSnapshotOffsetX:Number = 0;

		/**
		 * @private
		 */
		protected var _textSnapshotOffsetY:Number = 0;

		/**
		 * @private
		 */
		protected var _previousActualWidth:Number = NaN;

		/**
		 * @private
		 */
		protected var _previousActualHeight:Number = NaN;

		/**
		 * @private
		 */
		protected var _snapshotWidth:int = 0;

		/**
		 * @private
		 */
		protected var _snapshotHeight:int = 0;

		/**
		 * @private
		 */
		protected var _snapshotVisibleWidth:int = 0;

		/**
		 * @private
		 */
		protected var _snapshotVisibleHeight:int = 0;

		/**
		 * @private
		 */
		protected var _needsTextureUpdate:Boolean = false;

		/**
		 * @private
		 */
		protected var _needsNewTexture:Boolean = false;

		/**
		 * @private
		 */
		protected var _hasMeasured:Boolean = false;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return TextFieldTextRenderer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		override public function set text(value:String):void
		{
			if(value === null)
			{
				//flash.text.TextField won't accept a null value
				value = "";
			}
			super.text = value;
		}

		/**
		 * @private
		 */
		protected var _isHTML:Boolean = false;

		/**
		 * Determines if the TextField should display the text as HTML or not.
		 *
		 * <p>In the following example, the text is displayed as HTML:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.isHTML = true;
		 * textRenderer.text = "&lt;span class='heading'&gt;hello&lt;/span&gt; world!";</listing>
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#htmlText flash.text.TextField.htmlText
		 * @see #text
		 */
		public function get isHTML():Boolean
		{
			return this._isHTML;
		}

		/**
		 * @private
		 */
		public function set isHTML(value:Boolean):void
		{
			if(this._isHTML == value)
			{
				return;
			}
			this._isHTML = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @copy feathers.core.ITextRenderer#numLines
		 */
		public function get numLines():int
		{
			if(this.textField === null)
			{
				return 0;
			}
			return this.textField.numLines;
		}

		/**
		 * @private
		 */
		protected var _currentTextFormat:flash.text.TextFormat;

		/**
		 * For debugging purposes, the current
		 * <code>flash.text.TextFormat</code> used to render the text. Updated
		 * during validation, and may be <code>null</code> before the first
		 * validation.
		 *
		 * <p>Do not modify this value. It is meant for testing and debugging
		 * only. Use the parent's <code>starling.text.TextFormat</code> font
		 * styles APIs instead.</p>
		 */
		public function get currentTextFormat():flash.text.TextFormat
		{
			return this._currentTextFormat;
		}

		/**
		 * @private
		 */
		protected var _fontStylesTextFormat:flash.text.TextFormat;

		/**
		 * @private
		 */
		protected var _currentVerticalAlign:String;

		/**
		 * @private
		 */
		protected var _verticalAlignOffsetY:Number = 0;

		/**
		 * @private
		 */
		protected var _textFormatForState:Object;

		/**
		 * @private
		 */
		protected var _textFormat:flash.text.TextFormat;

		/**
		 * Advanced font formatting used to draw the text, if
		 * <code>fontStyles</code> and <code>starling.text.TextFormat</code>
		 * cannot be used on the parent component because the full capabilities
		 * of <code>flash.text.TextField</code> are required.
		 *
		 * <p>In the following example, the text format is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.textFormat = new TextFormat( "Source Sans Pro" );</listing>
		 *
		 * <p><strong>Warning:</strong> If this property is not
		 * <code>null</code>, any <code>starling.text.TextFormat</code> font
		 * styles that are passed in from the parent component may be ignored.
		 * In other words, advanced font styling with
		 * <code>flash.text.TextFormat</code> will always take precedence.</p>
		 *
		 * @default null
		 *
		 * @see #setTextFormatForState()
		 * @see #disabledTextFormat
		 * @see #selectedTextFormat
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextFormat.html flash.text.TextFormat
		 */
		public function get textFormat():flash.text.TextFormat
		{
			return this._textFormat;
		}

		/**
		 * @private
		 */
		public function set textFormat(value:flash.text.TextFormat):void
		{
			if(this._textFormat == value)
			{
				return;
			}
			this._textFormat = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _disabledTextFormat:flash.text.TextFormat;

		/**
		 * Advanced font formatting used to draw the text when the component is
		 * disabled, if <code>disabledFontStyles</code> and
		 * <code>starling.text.TextFormat</code> cannot be used on the parent
		 * component because the full capabilities of
		 * <code>flash.text.TextField</code> are required.
		 *
		 * <p>In the following example, the disabled text format is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.isEnabled = false;
		 * textRenderer.disabledTextFormat = new TextFormat( "Source Sans Pro" );</listing>
		 *
		 * <p><strong>Warning:</strong> If this property is not
		 * <code>null</code>, any <code>starling.text.TextFormat</code> font
		 * styles that are passed in from the parent component may be ignored.
		 * In other words, advanced font styling with
		 * <code>flash.text.TextFormat</code> will always take precedence.</p>
		 *
		 * @default null
		 *
		 * @see #textFormat
		 * @see #selectedTextFormat
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextFormat.html flash.text.TextFormat
		 */
		public function get disabledTextFormat():flash.text.TextFormat
		{
			return this._disabledTextFormat;
		}

		/**
		 * @private
		 */
		public function set disabledTextFormat(value:flash.text.TextFormat):void
		{
			if(this._disabledTextFormat == value)
			{
				return;
			}
			this._disabledTextFormat = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _selectedTextFormat:flash.text.TextFormat;

		/**
		 * Advanced font formatting used to draw the text when the
		 * <code>stateContext</code> is selected, if
		 * <code>selectedFontStyles</code> and
		 * <code>starling.text.TextFormat</code> cannot be used on the parent
		 * component because the full capabilities of
		 * <code>flash.text.TextField</code> are required.
		 *
		 * The font and styles used to draw the text when the
		 * <code>stateContext</code> implements the <code>IToggle</code>
		 * interface, and it is selected.
		 *
		 * <p>In the following example, the selected text format is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.selectedTextFormat = new TextFormat( "Source Sans Pro" );</listing>
		 *
		 * <p><strong>Warning:</strong> If this property is not
		 * <code>null</code>, any <code>starling.text.TextFormat</code> font
		 * styles that are passed in from the parent component may be ignored.
		 * In other words, advanced font styling with
		 * <code>flash.text.TextFormat</code> will always take precedence.</p>
		 *
		 * @default null
		 *
		 * @see #stateContext
		 * @see feathers.core.IToggle
		 * @see #textFormat
		 * @see #disabledTextFormat
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextFormat.html flash.text.TextFormat
		 */
		public function get selectedTextFormat():flash.text.TextFormat
		{
			return this._selectedTextFormat;
		}

		/**
		 * @private
		 */
		public function set selectedTextFormat(value:flash.text.TextFormat):void
		{
			if(this._selectedTextFormat == value)
			{
				return;
			}
			this._selectedTextFormat = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _styleSheet:StyleSheet;

		/**
		 * The <code>StyleSheet</code> object to pass to the TextField.
		 *
		 * <p>In the following example, a style sheet is applied:</p>
		 *
		 * <listing version="3.0">
		 * var style:StyleSheet = new StyleSheet();
		 * var heading:Object = new Object();
		 * heading.fontWeight = "bold";
		 * heading.color = "#FF0000";
		 * 
		 * var body:Object = new Object();
		 * body.fontStyle = "italic";
		 * 
		 * style.setStyle(".heading", heading);
		 * style.setStyle("body", body);
		 * 
		 * textRenderer.styleSheet = style;
		 * textRenderer.isHTML = true;
		 * textRenderer.text = "&lt;body&gt;&lt;span class='heading'&gt;Hello&lt;/span&gt; World...&lt;/body&gt;";</listing>
		 *
		 * @default null
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#styleSheet Full description of flash.text.TextField.styleSheet in Adobe's Flash Platform API Reference
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/StyleSheet.html flash.text.StyleSheet
		 * @see #isHTML
		 */
		public function get styleSheet():StyleSheet
		{
			return this._styleSheet;
		}

		/**
		 * @private
		 */
		public function set styleSheet(value:StyleSheet):void
		{
			if(this._styleSheet == value)
			{
				return;
			}
			this._styleSheet = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _embedFonts:Boolean = false;

		/**
		 * If advanced <code>flash.text.TextFormat</code> styles are specified,
		 * determines if the TextField should use an embedded font or not. If
		 * the specified font is not embedded, the text may not be displayed at
		 * all.
		 *
		 * <p>If the font styles are passed in from the parent component, the
		 * text renderer will automatically detect if a font is embedded or not,
		 * and the <code>embedFonts</code> property will be ignored if it is set
		 * to <code>false</code>. Setting it to <code>true</code> will force the
		 * <code>TextField</code> to always try to use embedded fonts.</p>
		 *
		 * <p>In the following example, the font is embedded:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.embedFonts = true;</listing>
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#embedFonts Full description of flash.text.TextField.embedFonts in Adobe's Flash Platform API Reference
		 */
		public function get embedFonts():Boolean
		{
			return this._embedFonts;
		}

		/**
		 * @private
		 */
		public function set embedFonts(value:Boolean):void
		{
			if(this._embedFonts == value)
			{
				return;
			}
			this._embedFonts = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @inheritDoc
		 */
		public function get baseline():Number
		{
			if(!this.textField)
			{
				return 0;
			}
			var gutterDimensionsOffset:Number = 0;
			if(this._useGutter || this._border)
			{
				gutterDimensionsOffset = 2;
			}
			return gutterDimensionsOffset + this.textField.getLineMetrics(0).ascent;
		}

		/**
		 * @private
		 */
		protected var _pixelSnapping:Boolean = true;

		/**
		 * Determines if the text should be snapped to the nearest whole pixel
		 * when rendered. When this is <code>false</code>, text may be displayed
		 * on sub-pixels, which often results in blurred rendering due to
		 * texture smoothing.
		 *
		 * <p>In the following example, the text is not snapped to pixels:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.pixelSnapping = false;</listing>
		 *
		 * @default true
		 */
		public function get pixelSnapping():Boolean
		{
			return this._pixelSnapping;
		}

		/**
		 * @private
		 */
		public function set pixelSnapping(value:Boolean):void
		{
			if(this._pixelSnapping === value)
			{
				return;
			}
			this._pixelSnapping = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _antiAliasType:String = AntiAliasType.ADVANCED;

		/**
		 * The type of anti-aliasing used for this text field, defined as
		 * constants in the <code>flash.text.AntiAliasType</code> class. You can
		 * control this setting only if the font is embedded (with the
		 * <code>embedFonts</code> property set to true).
		 *
		 * <p>In the following example, the anti-alias type is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.antiAliasType = AntiAliasType.NORMAL;</listing>
		 *
		 * @default flash.text.AntiAliasType.ADVANCED
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#antiAliasType Full description of flash.text.TextField.antiAliasType in Adobe's Flash Platform API Reference
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/AntiAliasType.html flash.text.AntiAliasType
		 */
		public function get antiAliasType():String
		{
			return this._antiAliasType;
		}

		/**
		 * @private
		 */
		public function set antiAliasType(value:String):void
		{
			if(this._antiAliasType == value)
			{
				return;
			}
			this._antiAliasType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _background:Boolean = false;

		/**
		 * Specifies whether the text field has a background fill. Use the
		 * <code>backgroundColor</code> property to set the background color of
		 * a text field.
		 *
		 * <p>In the following example, the background is enabled:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.background = true;
		 * textRenderer.backgroundColor = 0xff0000;</listing>
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#background Full description of flash.text.TextField.background in Adobe's Flash Platform API Reference
		 * @see #backgroundColor
		 */
		public function get background():Boolean
		{
			return this._background;
		}

		/**
		 * @private
		 */
		public function set background(value:Boolean):void
		{
			if(this._background == value)
			{
				return;
			}
			this._background = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _backgroundColor:uint = 0xffffff;

		/**
		 * The color of the text field background that is displayed if the
		 * <code>background</code> property is set to <code>true</code>.
		 *
		 * <p>In the following example, the background color is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.background = true;
		 * textRenderer.backgroundColor = 0xff000ff;</listing>
		 *
		 * @default 0xffffff
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#backgroundColor Full description of flash.text.TextField.backgroundColor in Adobe's Flash Platform API Reference
		 * @see #background
		 */
		public function get backgroundColor():uint
		{
			return this._backgroundColor;
		}

		/**
		 * @private
		 */
		public function set backgroundColor(value:uint):void
		{
			if(this._backgroundColor == value)
			{
				return;
			}
			this._backgroundColor = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _border:Boolean = false;

		/**
		 * Specifies whether the text field has a border. Use the
		 * <code>borderColor</code> property to set the border color.
		 *
		 * <p>Note: If <code>border</code> is set to <code>true</code>, the
		 * component will behave as if <code>useGutter</code> is also set to
		 * <code>true</code> because the border will not render correctly
		 * without the gutter.</p>
		 *
		 * <p>In the following example, the border is enabled:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.border = true;
		 * textRenderer.borderColor = 0xff0000;</listing>
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#border Full description of flash.text.TextField.border in Adobe's Flash Platform API Reference
		 * @see #borderColor
		 */
		public function get border():Boolean
		{
			return this._border;
		}

		/**
		 * @private
		 */
		public function set border(value:Boolean):void
		{
			if(this._border == value)
			{
				return;
			}
			this._border = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _borderColor:uint = 0x000000;

		/**
		 * The color of the text field border that is displayed if the
		 * <code>border</code> property is set to <code>true</code>.
		 *
		 * <p>In the following example, the border color is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.border = true;
		 * textRenderer.borderColor = 0xff00ff;</listing>
		 *
		 * @default 0x000000
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#borderColor Full description of flash.text.TextField.borderColor in Adobe's Flash Platform API Reference
		 * @see #border
		 */
		public function get borderColor():uint
		{
			return this._borderColor;
		}

		/**
		 * @private
		 */
		public function set borderColor(value:uint):void
		{
			if(this._borderColor == value)
			{
				return;
			}
			this._borderColor = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _condenseWhite:Boolean = false;

		/**
		 * A boolean value that specifies whether extra white space (spaces,
		 * line breaks, and so on) in a text field with HTML text is removed.
		 *
		 * <p>In the following example, whitespace is condensed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.condenseWhite = true;</listing>
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#condenseWhite Full description of flash.text.TextField.condenseWhite in Adobe's Flash Platform API Reference
		 * @see #isHTML
		 */
		public function get condenseWhite():Boolean
		{
			return this._condenseWhite;
		}

		/**
		 * @private
		 */
		public function set condenseWhite(value:Boolean):void
		{
			if(this._condenseWhite == value)
			{
				return;
			}
			this._condenseWhite = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _displayAsPassword:Boolean = false;

		/**
		 * Specifies whether the text field is a password text field that hides
		 * the input characters using asterisks instead of the actual
		 * characters.
		 *
		 * <p>In the following example, the text is displayed as a password:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.displayAsPassword = true;</listing>
		 *
		 * @default false
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#displayAsPassword Full description of flash.text.TextField.displayAsPassword in Adobe's Flash Platform API Reference
		 */
		public function get displayAsPassword():Boolean
		{
			return this._displayAsPassword;
		}

		/**
		 * @private
		 */
		public function set displayAsPassword(value:Boolean):void
		{
			if(this._displayAsPassword == value)
			{
				return;
			}
			this._displayAsPassword = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _gridFitType:String = GridFitType.PIXEL;

		/**
		 * Determines whether Flash Player forces strong horizontal and vertical
		 * lines to fit to a pixel or subpixel grid, or not at all using the
		 * constants defined in the <code>flash.text.GridFitType</code> class.
		 * This property applies only if the <code>antiAliasType</code> property
		 * of the text field is set to <code>flash.text.AntiAliasType.ADVANCED</code>.
		 *
		 * <p>In the following example, the grid fit type is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.gridFitType = GridFitType.SUBPIXEL;</listing>
		 *
		 * @default flash.text.GridFitType.PIXEL
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#gridFitType Full description of flash.text.TextField.gridFitType in Adobe's Flash Platform API Reference
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/GridFitType.html flash.text.GridFitType
		 * @see #antiAliasType
		 */
		public function get gridFitType():String
		{
			return this._gridFitType;
		}

		/**
		 * @private
		 */
		public function set gridFitType(value:String):void
		{
			if(this._gridFitType == value)
			{
				return;
			}
			this._gridFitType = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		private var _sharpness:Number = 0;

		/**
		 * The sharpness of the glyph edges in this text field. This property
		 * applies only if the <code>antiAliasType</code> property of the text
		 * field is set to <code>flash.text.AntiAliasType.ADVANCED</code>. The
		 * range for <code>sharpness</code> is a number from <code>-400</code>
		 * to <code>400</code>.
		 *
		 * <p>In the following example, the sharpness is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.sharpness = 200;</listing>
		 *
		 * @default 0
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#sharpness Full description of flash.text.TextField.sharpness in Adobe's Flash Platform API Reference
		 * @see #antiAliasType
		 */
		public function get sharpness():Number
		{
			return this._sharpness;
		}

		/**
		 * @private
		 */
		public function set sharpness(value:Number):void
		{
			if(this._sharpness == value)
			{
				return;
			}
			this._sharpness = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		private var _thickness:Number = 0;

		/**
		 * The thickness of the glyph edges in this text field. This property
		 * applies only if the <code>antiAliasType</code> property is set to
		 * <code>flash.text.AntiAliasType.ADVANCED</code>. The range for
		 * <code>thickness</code> is a number from <code>-200</code> to
		 * <code>200</code>.
		 *
		 * <p>In the following example, the thickness is changed:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.thickness = 100;</listing>
		 *
		 * @default 0
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#thickness Full description of flash.text.TextField.thickness in Adobe's Flash Platform API Reference
		 * @see #antiAliasType
		 */
		public function get thickness():Number
		{
			return this._thickness;
		}

		/**
		 * @private
		 */
		public function set thickness(value:Number):void
		{
			if(this._thickness == value)
			{
				return;
			}
			this._thickness = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _maxTextureDimensions:int = 2048;

		/**
		 * The maximum size of individual textures that are managed by this text
		 * renderer. Must be a power of 2. A larger value will create fewer
		 * individual textures, but a smaller value may use less overall texture
		 * memory by incrementing over smaller powers of two.
		 *
		 * <p>In the following example, the maximum size of the textures is
		 * changed:</p>
		 *
		 * <listing version="3.0">
		 * renderer.maxTextureDimensions = 4096;</listing>
		 *
		 * @default 2048
		 */
		public function get maxTextureDimensions():int
		{
			return this._maxTextureDimensions;
		}

		/**
		 * @private
		 */
		public function set maxTextureDimensions(value:int):void
		{
			//check if we can use rectangle textures or not
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			if(starling.profile === Context3DProfile.BASELINE_CONSTRAINED)
			{
				value = MathUtil.getNextPowerOfTwo(value);
			}
			if(this._maxTextureDimensions == value)
			{
				return;
			}
			this._maxTextureDimensions = value;
			this._needsNewTexture = true;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		/**
		 * @private
		 */
		protected var _nativeFilters:Array;

		/**
		 * Native filters to pass to the <code>flash.text.TextField</code>
		 * before creating the texture snapshot.
		 *
		 * <p>In the following example, the native filters are changed:</p>
		 *
		 * <listing version="3.0">
		 * renderer.nativeFilters = [ new GlowFilter() ];</listing>
		 *
		 * @default null
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/display/DisplayObject.html#filters Full description of flash.display.DisplayObject.filters in Adobe's Flash Platform API Reference
		 */
		public function get nativeFilters():Array
		{
			return this._nativeFilters;
		}

		/**
		 * @private
		 */
		public function set nativeFilters(value:Array):void
		{
			if(this._nativeFilters == value)
			{
				return;
			}
			this._nativeFilters = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _useGutter:Boolean = false;

		/**
		 * Determines if the 2-pixel gutter around the edges of the
		 * <code>flash.text.TextField</code> will be used in measurement and
		 * layout. To visually align with other text renderers and text editors,
		 * it is often best to leave the gutter disabled.
		 *
		 * <p>Returns <code>true</code> if the <code>border</code> property is
		 * <code>true</code>.</p>
		 *
		 * <p>In the following example, the gutter is enabled:</p>
		 *
		 * <listing version="3.0">
		 * textEditor.useGutter = true;</listing>
		 *
		 * @default false
		 */
		public function get useGutter():Boolean
		{
			return this._useGutter || this._border;
		}

		/**
		 * @private
		 */
		public function set useGutter(value:Boolean):void
		{
			if(this._useGutter == value)
			{
				return;
			}
			this._useGutter = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _lastGlobalScaleX:Number = 0;

		/**
		 * @private
		 */
		protected var _lastGlobalScaleY:Number = 0;

		/**
		 * @private
		 */
		protected var _lastContentScaleFactor:Number = 0;

		/**
		 * @private
		 */
		protected var _updateSnapshotOnScaleChange:Boolean = false;

		/**
		 * Refreshes the texture snapshot every time that the text renderer is
		 * scaled. Based on the scale in global coordinates, so scaling the
		 * parent will require a new snapshot.
		 *
		 * <p>Warning: setting this property to true may result in reduced
		 * performance because every change of the scale requires uploading a
		 * new texture to the GPU. Use with caution. Consider setting this
		 * property to false temporarily during animations that modify the
		 * scale.</p>
		 *
		 * <p>In the following example, the snapshot will be updated when the
		 * text renderer is scaled:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.updateSnapshotOnScaleChange = true;</listing>
		 *
		 * @default false
		 */
		public function get updateSnapshotOnScaleChange():Boolean
		{
			return this._updateSnapshotOnScaleChange;
		}

		/**
		 * @private
		 */
		public function set updateSnapshotOnScaleChange(value:Boolean):void
		{
			if(this._updateSnapshotOnScaleChange == value)
			{
				return;
			}
			this._updateSnapshotOnScaleChange = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _useSnapshotDelayWorkaround:Boolean = false;

		/**
		 * Fixes an issue where <code>flash.text.TextField</code> renders
		 * incorrectly when drawn to <code>BitmapData</code> by waiting one
		 * frame.
		 *
		 * <p>Warning: enabling this workaround may cause slight flickering
		 * after the <code>text</code> property is changed.</p>
		 *
		 * <p>In the following example, the workaround is enabled:</p>
		 *
		 * <listing version="3.0">
		 * textRenderer.useSnapshotDelayWorkaround = true;</listing>
		 *
		 * @default false
		 */
		public function get useSnapshotDelayWorkaround():Boolean
		{
			return this._useSnapshotDelayWorkaround;
		}

		/**
		 * @private
		 */
		public function set useSnapshotDelayWorkaround(value:Boolean):void
		{
			if(this._useSnapshotDelayWorkaround == value)
			{
				return;
			}
			this._useSnapshotDelayWorkaround = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			if(this.textSnapshot)
			{
				this.textSnapshot.texture.dispose();
				this.removeChild(this.textSnapshot, true);
				this.textSnapshot = null;
			}
			if(this.textSnapshots)
			{
				var snapshotCount:int = this.textSnapshots.length;
				for(var i:int = 0; i < snapshotCount; i++)
				{
					var snapshot:Image = this.textSnapshots[i];
					snapshot.texture.dispose();
					this.removeChild(snapshot, true);
				}
				this.textSnapshots = null;
			}
			//this isn't necessary, but if a memory leak keeps the text renderer
			//from being garbage collected, freeing up the text field may help
			//ease major memory pressure from native filters
			this.textField = null;

			this._previousActualWidth = NaN;
			this._previousActualHeight = NaN;

			this._needsNewTexture = false;
			this._snapshotWidth = 0;
			this._snapshotHeight = 0;

			super.dispose();
		}

		/**
		 * @private
		 */
		override public function render(painter:Painter):void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			if(this._updateSnapshotOnScaleChange)
			{
				this.getTransformationMatrix(this.stage, HELPER_MATRIX);
				var globalScaleX:Number = matrixToScaleX(HELPER_MATRIX);
				var globalScaleY:Number = matrixToScaleY(HELPER_MATRIX);
				if(globalScaleX != this._lastGlobalScaleX ||
					globalScaleY != this._lastGlobalScaleY ||
					starling.contentScaleFactor != this._lastContentScaleFactor)
				{
					//the snapshot needs to be updated because the scale has
					//changed since the last snapshot was taken.
					this.invalidate(INVALIDATION_FLAG_SIZE);
					this.validate();
				}
			}
			if(this._needsTextureUpdate)
			{
				this._needsTextureUpdate = false;
				if(this._text.length > 0)
				{
					if(this._useSnapshotDelayWorkaround)
					{
						//we need to wait a frame for the TextField to render
						//properly. sometimes two, and this is a known issue.
						this.addEventListener(Event.ENTER_FRAME, enterFrameHandler);
					}
					else
					{
						this.refreshSnapshot();
					}
				}
			}
			if(this.textSnapshot !== null)
			{
				var scaleFactor:Number = starling.contentScaleFactor;
				if(!this._nativeFilters || this._nativeFilters.length == 0)
				{
					var offsetX:Number = 0;
					var offsetY:Number = 0;
				}
				else
				{
					offsetX = this._textSnapshotOffsetX / scaleFactor;
					offsetY = this._textSnapshotOffsetY / scaleFactor;
				}
				offsetY += this._verticalAlignOffsetY * scaleFactor;

				var snapshotIndex:int = -1;
				var totalBitmapWidth:Number = this._snapshotWidth;
				var totalBitmapHeight:Number = this._snapshotHeight;
				var xPosition:Number = offsetX;
				var yPosition:Number = offsetY;
				do
				{
					var currentBitmapWidth:Number = totalBitmapWidth;
					if(currentBitmapWidth > this._maxTextureDimensions)
					{
						currentBitmapWidth = this._maxTextureDimensions;
					}
					do
					{
						var currentBitmapHeight:Number = totalBitmapHeight;
						if(currentBitmapHeight > this._maxTextureDimensions)
						{
							currentBitmapHeight = this._maxTextureDimensions;
						}
						if(snapshotIndex < 0)
						{
							var snapshot:Image = this.textSnapshot;
							snapshot.visible = this._text.length > 0 && this._snapshotWidth > 0 && this._snapshotHeight > 0;
						}
						else
						{
							snapshot = this.textSnapshots[snapshotIndex];
						}
						snapshot.pixelSnapping = this._pixelSnapping;
						snapshot.x = xPosition / scaleFactor;
						snapshot.y = yPosition / scaleFactor;
						snapshotIndex++;
						yPosition += currentBitmapHeight;
						totalBitmapHeight -= currentBitmapHeight;
					}
					while(totalBitmapHeight > 0);
					xPosition += currentBitmapWidth;
					totalBitmapWidth -= currentBitmapWidth;
					yPosition = offsetY;
					totalBitmapHeight = this._snapshotHeight;
				}
				while(totalBitmapWidth > 0);
			}
			super.render(painter);
		}

		/**
		 * @inheritDoc
		 */
		public function measureText(result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}

			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			if(!needsWidth && !needsHeight)
			{
				result.x = this._explicitWidth;
				result.y = this._explicitHeight;
				return result;
			}

			//if a parent component validates before we're added to the stage,
			//measureText() may be called before initialization, so we need to
			//force it.
			if(!this._isInitialized)
			{
				this.initializeNow();
			}

			this.commit();

			result = this.measure(result);

			return result;
		}

		/**
		 * Gets the advanced <code>flash.text.TextFormat</code> font formatting
		 * passed in using <code>setTextFormatForState()</code> for the
		 * specified state.
		 *
		 * <p>If an <code>flash.text.TextFormat</code> is not defined for a
		 * specific state, returns <code>null</code>.</p>
		 *
		 * @see #setTextFormatForState()
		 */
		public function getTextFormatForState(state:String):flash.text.TextFormat
		{
			if(this._textFormatForState === null)
			{
				return null;
			}
			return flash.text.TextFormat(this._textFormatForState[state]);
		}

		/**
		 * Sets the advanced <code>flash.text.TextFormat</code> font formatting
		 * to be used by the text renderer when the <code>currentState</code>
		 * property of the <code>stateContext</code> matches the specified state
		 * value.
		 *
		 * <p>If a <code>flash.text.TextFormat</code> is not defined for a
		 * specific state, the value of the <code>textFormat</code> property
		 * will be used instead.</p>
		 *
		 * <p>If the <code>disabledTextFormat</code> property is not
		 * <code>null</code> and the <code>isEnabled</code> property is
		 * <code>false</code>, all other text formats will be ignored.</p>
		 *
		 * @see #stateContext
		 * @see #textFormat
		 */
		public function setTextFormatForState(state:String, textFormat:flash.text.TextFormat):void
		{
			if(textFormat)
			{
				if(!this._textFormatForState)
				{
					this._textFormatForState = {};
				}
				this._textFormatForState[state] = textFormat;
			}
			else
			{
				delete this._textFormatForState[state];
			}
			//if the context's current state is the state that we're modifying,
			//we need to use the new value immediately.
			if(this._stateContext && this._stateContext.currentState === state)
			{
				this.invalidate(INVALIDATION_FLAG_STATE);
			}
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(this.textField === null)
			{
				this.textField = new TextField();
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				var scaleFactor:Number = starling.contentScaleFactor;
				this.textField.scaleX = scaleFactor;
				this.textField.scaleY = scaleFactor;
				this.textField.mouseEnabled = this.textField.mouseWheelEnabled = false;
				this.textField.selectable = false;
				this.textField.multiline = true;
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var sizeInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_SIZE);

			this.commit();

			this._hasMeasured = false;
			sizeInvalid = this.autoSizeIfNeeded() || sizeInvalid;
			this._verticalAlignOffsetY = this.getVerticalAlignOffsetY();

			this.layout(sizeInvalid);
		}

		/**
		 * @private
		 */
		protected function commit():void
		{
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);

			if(stylesInvalid || stateInvalid)
			{
				this.refreshTextFormat();
			}

			if(stylesInvalid)
			{
				this.textField.antiAliasType = this._antiAliasType;
				this.textField.background = this._background;
				this.textField.backgroundColor = this._backgroundColor;
				this.textField.border = this._border;
				this.textField.borderColor = this._borderColor;
				this.textField.condenseWhite = this._condenseWhite;
				this.textField.displayAsPassword = this._displayAsPassword;
				this.textField.gridFitType = this._gridFitType;
				this.textField.sharpness = this._sharpness;
				this.textField.thickness = this._thickness;
				this.textField.filters = this._nativeFilters;
			}

			if(dataInvalid || stylesInvalid || stateInvalid)
			{
				this.textField.wordWrap = this._wordWrap;
				if(this._styleSheet)
				{
					this.textField.embedFonts = this._embedFonts;
					this.textField.styleSheet = this._styleSheet;
				}
				else
				{
					if(!this._embedFonts &&
						this._currentTextFormat === this._fontStylesTextFormat)
					{
						//when font styles are passed in from the parent component, we
						//automatically determine if the TextField should use embedded
						//fonts, unless embedFonts is explicitly true
						this.textField.embedFonts = SystemUtil.isEmbeddedFont(
							this._currentTextFormat.font, this._currentTextFormat.bold,
							this._currentTextFormat.italic, FontType.EMBEDDED);
					}
					else
					{
						this.textField.embedFonts = this._embedFonts;
					}
					this.textField.styleSheet = null;
					this.textField.defaultTextFormat = this._currentTextFormat;
				}
				if(this._isHTML)
				{
					this.textField.htmlText = this._text;
				}
				else
				{
					this.textField.text = this._text;
				}
			}
		}

		/**
		 * @private
		 */
		protected function measure(result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}

			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN

			this.textField.autoSize = TextFieldAutoSize.LEFT;
			this.textField.wordWrap = false;

			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var scaleFactor:Number = starling.contentScaleFactor;
			var gutterDimensionsOffset:Number = 4;
			if(this._useGutter || this._border)
			{
				gutterDimensionsOffset = 0;
			}

			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				//yes, this value is never used. this is a workaround for a bug
				//in AIR for iOS where getting the value for textField.width the
				//first time results in an incorrect value, but if you query it
				//again, for some reason, it reports the correct width value.
				var hackWorkaround:Number = this.textField.width;
				newWidth = (this.textField.width / scaleFactor) - gutterDimensionsOffset;
				if(newWidth < this._explicitMinWidth)
				{
					newWidth = this._explicitMinWidth;
				}
				else if(newWidth > this._explicitMaxWidth)
				{
					newWidth = this._explicitMaxWidth;
				}
			}
			//and this is a workaround for an issue where flash.text.TextField
			//will wrap the last word when you pass the value returned by the
			//width getter (when TextFieldAutoSize.LEFT is used) to the width
			//setter. In other words, the value technically isn't changing, but
			//TextField behaves differently.
			if(!needsWidth || ((this.textField.width / scaleFactor) - gutterDimensionsOffset) > newWidth)
			{
				this.textField.width = newWidth + gutterDimensionsOffset;
				this.textField.wordWrap = this._wordWrap;
			}
			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				newHeight = (this.textField.height / scaleFactor) - gutterDimensionsOffset;
				//from what I can gather, TextField measures in twips, like many
				//things in Flash. if the result of the calculation above is
				//just below the nearest twip (due to a rounding error or
				//whatever), some of the text may be cut off. as a workaround,
				//round up to nearest twip.
				newHeight = roundUpToNearest(newHeight, 0.05);
				if(newHeight < this._explicitMinHeight)
				{
					newHeight = this._explicitMinHeight;
				}
				else if(newHeight > this._explicitMaxHeight)
				{
					newHeight = this._explicitMaxHeight;
				}
			}

			this.textField.autoSize = TextFieldAutoSize.NONE;

			//put the width and height back just in case we measured without
			//a full validation
			this.textField.width = this.actualWidth + gutterDimensionsOffset;
			this.textField.height = this.actualHeight + gutterDimensionsOffset;

			result.x = newWidth;
			result.y = newHeight;

			this._hasMeasured = true;
			return result;
		}

		/**
		 * @private
		 */
		protected function layout(sizeInvalid:Boolean):void
		{
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var dataInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_DATA);
			var stateInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STATE);

			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var scaleFactor:Number = starling.contentScaleFactor;
			var gutterDimensionsOffset:Number = 4;
			if(this._useGutter || this._border)
			{
				gutterDimensionsOffset = 0;
			}

			//if measure() isn't called, we need to apply the same workaround
			//for the flash.text.TextField bug with wordWrap.
			if(!this._hasMeasured && this._wordWrap)
			{
				this.textField.autoSize = TextFieldAutoSize.LEFT;
				this.textField.wordWrap = false;
				if(((this.textField.width / scaleFactor) - gutterDimensionsOffset) > this.actualWidth)
				{
					this.textField.wordWrap = true;
				}
				this.textField.autoSize = TextFieldAutoSize.NONE;
				this.textField.width = this.actualWidth + gutterDimensionsOffset;
			}
			if(sizeInvalid)
			{
				this.textField.width = this.actualWidth + gutterDimensionsOffset;
				this.textField.height = this.actualHeight + gutterDimensionsOffset;
				this.calculateSnapshotDimensions();
			}

			//instead of checking sizeInvalid, which will often be triggered by
			//changing maxWidth or something for measurement, we check against
			//the previous actualWidth/Height used for the snapshot.
			if(stylesInvalid || dataInvalid || stateInvalid || this._needsNewTexture ||
				this.actualWidth != this._previousActualWidth ||
				this.actualHeight != this._previousActualHeight)
			{
				this._previousActualWidth = this.actualWidth;
				this._previousActualHeight = this.actualHeight;
				//we're going to update the texture in render() because
				//there's a chance that it will be updated more than once per
				//frame if we do it here.
				this._needsTextureUpdate = true;
				this.setRequiresRedraw();
			}
		}

		/**
		 * If the component's dimensions have not been set explicitly, it will
		 * measure its content and determine an ideal size for itself. If the
		 * <code>explicitWidth</code> or <code>explicitHeight</code> member
		 * variables are set, those value will be used without additional
		 * measurement. If one is set, but not the other, the dimension with the
		 * explicit value will not be measured, but the other non-explicit
		 * dimension will still need measurement.
		 *
		 * <p>Calls <code>saveMeasurements()</code> to set up the
		 * <code>actualWidth</code> and <code>actualHeight</code> member
		 * variables used for layout.</p>
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			var needsMinWidth:Boolean = this._explicitMinWidth !== this._explicitMinWidth; //isNaN
			var needsMinHeight:Boolean = this._explicitMinHeight !== this._explicitMinHeight; //isNaN
			if(!needsWidth && !needsHeight && !needsMinWidth && !needsMinHeight)
			{
				return false;
			}

			this.measure(HELPER_POINT);
			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				newWidth = HELPER_POINT.x;
			}
			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				newHeight = HELPER_POINT.y;
			}
			var newMinWidth:Number = this._explicitMinWidth;
			if(needsMinWidth)
			{
				if(needsWidth)
				{
					//this allows wrapping or truncation
					newMinWidth = 0;
				}
				else
				{
					newMinWidth = newWidth;
				}
			}
			var newMinHeight:Number = this._explicitMinHeight;
			if(needsMinHeight)
			{
				newMinHeight = newHeight;
			}
			return this.saveMeasurements(newWidth, newHeight, newMinWidth, newMinHeight);
		}

		/**
		 * @private
		 */
		protected function measureNativeFilters(bitmapData:BitmapData, result:Rectangle = null):Rectangle
		{
			if(!result)
			{
				result = new Rectangle();
			}
			var resultX:Number = 0;
			var resultY:Number = 0;
			var resultWidth:Number = 0;
			var resultHeight:Number = 0;
			var filterCount:int = this._nativeFilters.length;
			for(var i:int = 0; i < filterCount; i++)
			{
				var filter:BitmapFilter = this._nativeFilters[i];
				var filterRect:Rectangle = bitmapData.generateFilterRect(bitmapData.rect, filter);
				var filterX:Number = filterRect.x;
				var filterY:Number = filterRect.y;
				var filterWidth:Number = filterRect.width;
				var filterHeight:Number = filterRect.height;
				if(resultX > filterX)
				{
					resultX = filterX;
				}
				if(resultY > filterY)
				{
					resultY = filterY;
				}
				if(resultWidth < filterWidth)
				{
					resultWidth = filterWidth;
				}
				if(resultHeight < filterHeight)
				{
					resultHeight = filterHeight;
				}
			}
			result.setTo(resultX, resultY, resultWidth, resultHeight);
			return result;
		}

		/**
		 * @private
		 */
		protected function refreshTextFormat():void
		{
			var textFormat:flash.text.TextFormat;
			if(this._stateContext !== null)
			{
				if(this._textFormatForState !== null)
				{
					var currentState:String = this._stateContext.currentState;
					if(currentState in this._textFormatForState)
					{
						textFormat = flash.text.TextFormat(this._textFormatForState[currentState]);
					}
				}
				if(textFormat === null && this._disabledTextFormat !== null &&
					this._stateContext is IFeathersControl && !IFeathersControl(this._stateContext).isEnabled)
				{
					textFormat = this._disabledTextFormat;
				}
				if(textFormat === null && this._selectedTextFormat !== null &&
					this._stateContext is IToggle && IToggle(this._stateContext).isSelected)
				{
					textFormat = this._selectedTextFormat;
				}
			}
			else //no state context
			{
				//we can still check if the text renderer is disabled to see if
				//we should use disabledTextFormat
				if(!this._isEnabled && this._disabledTextFormat !== null)
				{
					textFormat = this._disabledTextFormat;
				}
			}
			if(textFormat === null)
			{
				textFormat = this._textFormat;
			}
			//flash.text.TextFormat is considered more advanced, so it gets
			//precedence over starling.text.TextFormat font styles
			if(textFormat === null)
			{
				textFormat = this.getTextFormatFromFontStyles();
			}
			else
			{
				//if using flash.text.TextFormat, vertical align is always top
				this._currentVerticalAlign = Align.TOP;
			}
			this._currentTextFormat = textFormat;
		}

		/**
		 * @private
		 */
		protected function getTextFormatFromFontStyles():flash.text.TextFormat
		{
			if(this.isInvalid(INVALIDATION_FLAG_STYLES) ||
				this.isInvalid(INVALIDATION_FLAG_STATE))
			{
				var fontStylesFormat:starling.text.TextFormat;
				if(this._fontStyles !== null)
				{
					fontStylesFormat = this._fontStyles.getTextFormatForTarget(this);
				}
				if(fontStylesFormat !== null)
				{
					this._fontStylesTextFormat = fontStylesFormat.toNativeFormat(this._fontStylesTextFormat);
					this._currentVerticalAlign = fontStylesFormat.verticalAlign;
				}
				else if(this._fontStylesTextFormat === null)
				{
					//fallback to a default so that something is displayed
					this._fontStylesTextFormat = new flash.text.TextFormat();
					this._currentVerticalAlign = Align.TOP;
				}
			}
			return this._fontStylesTextFormat;
		}

		/**
		 * @private
		 */
		protected function getVerticalAlignOffsetY():Number
		{
			var textFieldTextHeight:Number = this.textField.textHeight;
			if(textFieldTextHeight > this.actualHeight)
			{
				return 0;
			}
			if(this._currentVerticalAlign === Align.BOTTOM)
			{
				return this.actualHeight - textFieldTextHeight;
			}
			else if(this._currentVerticalAlign === Align.CENTER)
			{
				return (this.actualHeight - textFieldTextHeight) / 2;
			}
			return 0;
		}

		/**
		 * @private
		 */
		protected function createTextureOnRestoreCallback(snapshot:Image):void
		{
			var self:TextFieldTextRenderer = this;
			var texture:Texture = snapshot.texture;
			texture.root.onRestore = function():void
			{
				var starling:Starling = self.stage !== null ? self.stage.starling : Starling.current;
				var scaleFactor:Number = starling.contentScaleFactor;
				HELPER_MATRIX.identity();
				HELPER_MATRIX.scale(scaleFactor, scaleFactor);
				var offsetY:Number = self.getVerticalAlignOffsetY();
				var bitmapData:BitmapData = self.drawTextFieldRegionToBitmapData(
					snapshot.x, snapshot.y - offsetY, texture.nativeWidth, texture.nativeHeight);
				texture.root.uploadBitmapData(bitmapData);
				bitmapData.dispose();
			};
		}

		/**
		 * @private
		 */
		protected function drawTextFieldRegionToBitmapData(textFieldX:Number, textFieldY:Number,
			bitmapWidth:Number, bitmapHeight:Number, bitmapData:BitmapData = null):BitmapData
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var scaleFactor:Number = starling.contentScaleFactor;
			var clipWidth:Number = this._snapshotVisibleWidth - textFieldX;
			var clipHeight:Number = this._snapshotVisibleHeight - textFieldY;
			if(!bitmapData || bitmapData.width != bitmapWidth || bitmapData.height != bitmapHeight)
			{
				if(bitmapData)
				{
					bitmapData.dispose();
				}
				bitmapData = new BitmapData(bitmapWidth, bitmapHeight, true, 0x00ff00ff);
			}
			else
			{
				//clear the bitmap data and reuse it
				bitmapData.fillRect(bitmapData.rect, 0x00ff00ff);
			}
			var gutterPositionOffset:Number = 2 * scaleFactor;
			if(this._useGutter || this._border)
			{
				gutterPositionOffset = 0;
			}
			HELPER_MATRIX.tx = -(textFieldX + gutterPositionOffset) - this._textSnapshotOffsetX;
			HELPER_MATRIX.ty = -(textFieldY + gutterPositionOffset) - this._textSnapshotOffsetY;
			HELPER_RECTANGLE.setTo(0, 0, clipWidth, clipHeight);
			bitmapData.draw(this.textField, HELPER_MATRIX, null, null, HELPER_RECTANGLE);
			return bitmapData;
		}

		/**
		 * @private
		 */
		protected function calculateSnapshotDimensions():void
		{
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var scaleFactor:Number = starling.contentScaleFactor;
			this._lastContentScaleFactor = scaleFactor;
			//these are getting put into an int later, so we don't want it
			//to possibly round down and cut off part of the text.
			var rectangleSnapshotWidth:Number = Math.ceil(this.textField.width);
			var rectangleSnapshotHeight:Number = Math.ceil(this.textField.height);
			if(this._updateSnapshotOnScaleChange)
			{
				this.getTransformationMatrix(this.stage, HELPER_MATRIX);
				this._lastGlobalScaleX = matrixToScaleX(HELPER_MATRIX);
				this._lastGlobalScaleY = matrixToScaleY(HELPER_MATRIX);
				rectangleSnapshotWidth *= this._lastGlobalScaleX;
				rectangleSnapshotHeight *= this._lastGlobalScaleY;
			}
			if(rectangleSnapshotWidth >= 1 && rectangleSnapshotHeight >= 1 &&
				this._nativeFilters !== null && this._nativeFilters.length > 0)
			{
				HELPER_MATRIX.identity();
				HELPER_MATRIX.scale(scaleFactor, scaleFactor);
				var bitmapData:BitmapData = new BitmapData(rectangleSnapshotWidth, rectangleSnapshotHeight, true, 0x00ff00ff);
				bitmapData.draw(this.textField, HELPER_MATRIX, null, null, HELPER_RECTANGLE);
				this.measureNativeFilters(bitmapData, HELPER_RECTANGLE);
				bitmapData.dispose();
				bitmapData = null;
				this._textSnapshotOffsetX = HELPER_RECTANGLE.x;
				this._textSnapshotOffsetY = HELPER_RECTANGLE.y;
				rectangleSnapshotWidth = HELPER_RECTANGLE.width;
				rectangleSnapshotHeight = HELPER_RECTANGLE.height;
			}
			var point:Point = Pool.getPoint();
			calculateSnapshotTextureDimensions(rectangleSnapshotWidth,
				rectangleSnapshotHeight, this._maxTextureDimensions,
				starling.profile !== Context3DProfile.BASELINE_CONSTRAINED, point);
			//the full dimensions of the texture
			this._snapshotWidth = point.x;
			this._snapshotHeight = point.y;
			//the clipping dimensions of the texture, if it is next power-of-two
			this._snapshotVisibleWidth = rectangleSnapshotWidth;
			this._snapshotVisibleHeight = rectangleSnapshotHeight;
			Pool.putPoint(point);

			var textureRoot:ConcreteTexture = this.textSnapshot ? this.textSnapshot.texture.root : null;
			this._needsNewTexture = this._needsNewTexture || this.textSnapshot === null ||
				(textureRoot !== null && (textureRoot.scale != scaleFactor ||
				this._snapshotWidth != textureRoot.nativeWidth || this._snapshotHeight != textureRoot.nativeHeight));
		}

		/**
		 * @private
		 */
		protected function refreshSnapshot():void
		{
			if(this._snapshotWidth <= 0 || this._snapshotHeight <= 0)
			{
				return;
			}
			var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
			var scaleFactor:Number = starling.contentScaleFactor;
			if(this._updateSnapshotOnScaleChange)
			{
				this.getTransformationMatrix(this.stage, HELPER_MATRIX);
				var globalScaleX:Number = matrixToScaleX(HELPER_MATRIX);
				var globalScaleY:Number = matrixToScaleY(HELPER_MATRIX);
			}
			HELPER_MATRIX.identity();
			HELPER_MATRIX.scale(scaleFactor, scaleFactor);
			if(this._updateSnapshotOnScaleChange)
			{
				HELPER_MATRIX.scale(globalScaleX, globalScaleY);
			}
			var totalBitmapWidth:Number = this._snapshotWidth;
			var totalBitmapHeight:Number = this._snapshotHeight;
			var xPosition:Number = 0;
			var yPosition:Number = 0;
			var bitmapData:BitmapData;
			var snapshotIndex:int = -1;
			do
			{
				var currentBitmapWidth:Number = totalBitmapWidth;
				if(currentBitmapWidth > this._maxTextureDimensions)
				{
					currentBitmapWidth = this._maxTextureDimensions;
				}
				do
				{
					var currentBitmapHeight:Number = totalBitmapHeight;
					if(currentBitmapHeight > this._maxTextureDimensions)
					{
						currentBitmapHeight = this._maxTextureDimensions;
					}
					bitmapData = this.drawTextFieldRegionToBitmapData(xPosition, yPosition,
						currentBitmapWidth, currentBitmapHeight, bitmapData);
					var newTexture:Texture;
					if(!this.textSnapshot || this._needsNewTexture)
					{
						//skip Texture.fromBitmapData() because we don't want
						//it to create an onRestore function that will be
						//immediately discarded for garbage collection.
						newTexture = Texture.empty(bitmapData.width / scaleFactor, bitmapData.height / scaleFactor,
							true, false, false, scaleFactor);
						newTexture.root.uploadBitmapData(bitmapData);
					}
					var snapshot:Image = null;
					if(snapshotIndex >= 0)
					{
						if(!this.textSnapshots)
						{
							this.textSnapshots = new <Image>[];
						}
						else if(this.textSnapshots.length > snapshotIndex)
						{
							snapshot = this.textSnapshots[snapshotIndex];
						}
					}
					else
					{
						snapshot = this.textSnapshot;
					}

					if(!snapshot)
					{
						snapshot = new Image(newTexture);
						snapshot.pixelSnapping = true;
						this.addChild(snapshot);
					}
					else
					{
						if(this._needsNewTexture)
						{
							snapshot.texture.dispose();
							snapshot.texture = newTexture;
							snapshot.readjustSize();
						}
						else
						{
							//this is faster, if we haven't resized the bitmapdata
							var existingTexture:Texture = snapshot.texture;
							existingTexture.root.uploadBitmapData(bitmapData);
							//however, the image won't be notified that its
							//texture has changed, so we need to do it manually
							this.textSnapshot.setRequiresRedraw();
						}
					}
					if(newTexture)
					{
						this.createTextureOnRestoreCallback(snapshot);
					}
					if(snapshotIndex >= 0)
					{
						this.textSnapshots[snapshotIndex] = snapshot;
					}
					else
					{
						this.textSnapshot = snapshot;
					}
					snapshot.x = xPosition / scaleFactor;
					snapshot.y = yPosition / scaleFactor;
					if(this._updateSnapshotOnScaleChange)
					{
						snapshot.scaleX = 1 / globalScaleX;
						snapshot.scaleY = 1 / globalScaleY;
					}
					else
					{
						snapshot.scale = 1;
					}
					snapshotIndex++;
					yPosition += currentBitmapHeight;
					totalBitmapHeight -= currentBitmapHeight;
				}
				while(totalBitmapHeight > 0);
				xPosition += currentBitmapWidth;
				totalBitmapWidth -= currentBitmapWidth;
				yPosition = 0;
				totalBitmapHeight = this._snapshotHeight;
			}
			while(totalBitmapWidth > 0);
			bitmapData.dispose();
			if(this.textSnapshots)
			{
				var snapshotCount:int = this.textSnapshots.length;
				for(var i:int = snapshotIndex; i < snapshotCount; i++)
				{
					snapshot = this.textSnapshots[i];
					snapshot.texture.dispose();
					snapshot.removeFromParent(true);
				}
				if(snapshotIndex == 0)
				{
					this.textSnapshots = null;
				}
				else
				{
					this.textSnapshots.length = snapshotIndex;
				}
			}
			if(this._updateSnapshotOnScaleChange)
			{
				this._lastGlobalScaleX = globalScaleX;
				this._lastGlobalScaleY = globalScaleY;
				this._lastContentScaleFactor = scaleFactor;
			}
			this._needsNewTexture = false;
		}

		/**
		 * @private
		 */
		protected function enterFrameHandler(event:Event):void
		{
			this.removeEventListener(Event.ENTER_FRAME, enterFrameHandler);
			this.refreshSnapshot();
		}
	}
}


================================================
FILE: source/feathers/core/BaseTextEditor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import feathers.events.FeathersEventType;
	import feathers.text.FontStylesSet;

	import starling.events.Event;

	/**
	 * A base class for text editors that implements some common properties.
	 *
	 * @productversion Feathers 3.1.0
	 */
	public class BaseTextEditor extends FeathersControl implements IStateObserver
	{
		/**
		 * Constructor.
		 */
		public function BaseTextEditor()
		{
			super();
		}

		/**
		 * @private
		 */
		protected var _text:String = "";

		/**
		 * @copy feathers.core.ITextEditor#text
		 */
		public function get text():String
		{
			return this._text;
		}

		/**
		 * @private
		 */
		public function set text(value:String):void
		{
			if(!value)
			{
				//don't allow null or undefined
				value = "";
			}
			if(this._text == value)
			{
				return;
			}
			this._text = value;
			this.invalidate(INVALIDATION_FLAG_DATA);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _stateContext:IStateContext;

		/**
		 * When the text editor observes a state context, the text editor may
		 * change its font styles based on the current state of that context.
		 * Typically, a relevant component will automatically assign itself as
		 * the state context of a text editor, so this property is typically
		 * meant for internal use only.
		 *
		 * @default null
		 *
		 * @see #setFontStylesForState()
		 */
		public function get stateContext():IStateContext
		{
			return this._stateContext;
		}

		/**
		 * @private
		 */
		public function set stateContext(value:IStateContext):void
		{
			if(this._stateContext === value)
			{
				return;
			}
			if(this._stateContext)
			{
				this._stateContext.removeEventListener(FeathersEventType.STATE_CHANGE, stateContext_stateChangeHandler);
			}
			this._stateContext = value;
			if(this._stateContext)
			{
				this._stateContext.addEventListener(FeathersEventType.STATE_CHANGE, stateContext_stateChangeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_STATE);
		}

		/**
		 * @private
		 */
		protected var _fontStyles:FontStylesSet;

		/**
		 * @copy feathers.core.ITextEditor#fontStyles
		 */
		public function get fontStyles():FontStylesSet
		{
			return this._fontStyles;
		}

		/**
		 * @private
		 */
		public function set fontStyles(value:FontStylesSet):void
		{
			if(this._fontStyles === value)
			{
				return;
			}
			if(this._fontStyles !== null)
			{
				this._fontStyles.removeEventListener(Event.CHANGE, fontStylesSet_changeHandler);
			}
			this._fontStyles = value;
			if(this._fontStyles !== null)
			{
				this._fontStyles.addEventListener(Event.CHANGE, fontStylesSet_changeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.stateContext = null;
			this.fontStyles = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		protected function stateContext_stateChangeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STATE);
		}

		/**
		 * @private
		 */
		protected function fontStylesSet_changeHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}
	}
}


================================================
FILE: source/feathers/core/DefaultFocusManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import feathers.controls.supportClasses.LayoutViewPort;
	import feathers.core.IFocusContainer;
	import feathers.core.IFocusDisplayObject;
	import feathers.core.IFocusExtras;
	import feathers.events.FeathersEventType;
	import feathers.layout.RelativePosition;
	import feathers.system.DeviceCapabilities;
	import feathers.utils.focus.isBetterFocusForRelativePosition;

	import flash.display.InteractiveObject;
	import flash.display.Stage;
	import flash.errors.IllegalOperationError;
	import flash.events.FocusEvent;
	import flash.events.IEventDispatcher;
	import flash.events.KeyboardEvent;
	import flash.events.TransformGestureEvent;
	import flash.geom.Rectangle;
	import flash.system.Capabilities;
	import flash.ui.KeyLocation;
	import flash.ui.Keyboard;
	import flash.utils.Dictionary;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.events.Event;
	import starling.events.EventDispatcher;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * Dispatched when the value of the <code>focus</code> property changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 *
	 * @see #focus
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * The default <code>IFocusManager</code> implementation. This focus
	 * manager is designed to work on both desktop and mobile. Focus may be
	 * controlled by <code>Keyboard.TAB</code> (including going
	 * backwards when holding the shift key) or with the arrow keys on a d-pad
	 * (such as those that appear on a smart TV remote control and some game
	 * controllers).
	 *
	 * <p>To simulate <code>KeyLocation.D_PAD</code> in the AIR Debug
	 * Launcher on desktop for debugging purposes, set
	 * <code>DeviceCapabilities.simulateDPad</code> to <code>true</code>.</p>
	 *
	 * @see ../../../help/focus.html Keyboard focus management in Feathers
	 * @see feathers.core.FocusManager
	 *
	 * @productversion Feathers 2.0.0
	 */
	public class DefaultFocusManager extends EventDispatcher implements IFocusManager
	{
		/**
		 * @private
		 */
		protected static var NATIVE_STAGE_TO_FOCUS_TARGET:Dictionary = new Dictionary(true);

		/**
		 * Constructor.
		 */
		public function DefaultFocusManager(root:DisplayObjectContainer)
		{
			if(!root.stage)
			{
				throw new ArgumentError("Focus manager root must be added to the stage.");
			}
			this._root = root;
			this._starling = root.stage.starling;
		}

		/**
		 * @private
		 */
		protected var _starling:Starling;

		/**
		 * @private
		 */
		protected var _nativeFocusTarget:NativeFocusTarget;

		/**
		 * @private
		 */
		protected var _root:DisplayObjectContainer;

		/**
		 * @inheritDoc
		 */
		public function get root():DisplayObjectContainer
		{
			return this._root;
		}

		/**
		 * @private
		 */
		protected var _isEnabled:Boolean = false;

		/**
		 * @inheritDoc
		 *
		 * @default false
		 */
		public function get isEnabled():Boolean
		{
			return this._isEnabled;
		}

		/**
		 * @private
		 */
		public function set isEnabled(value:Boolean):void
		{
			if(this._isEnabled == value)
			{
				return;
			}
			this._isEnabled = value;
			if(this._isEnabled)
			{
				this._nativeFocusTarget = NATIVE_STAGE_TO_FOCUS_TARGET[this._starling.nativeStage] as NativeFocusTarget;
				if(!this._nativeFocusTarget)
				{
					this._nativeFocusTarget = new NativeFocusTarget();
					//we must add it directly to the nativeStage because
					//otherwise, the skipUnchangedFrames property won't work
					this._starling.nativeStage.addChild(_nativeFocusTarget);
				}
				else
				{
					this._nativeFocusTarget.referenceCount++;
				}
				//since we weren't listening for objects being added while the
				//focus manager was disabled, we need to do it now in case there
				//are new ones.
				this.setFocusManager(this._root);
				this._root.addEventListener(Event.ADDED, topLevelContainer_addedHandler);
				this._root.addEventListener(Event.REMOVED, topLevelContainer_removedHandler);
				this._root.addEventListener(TouchEvent.TOUCH, topLevelContainer_touchHandler);
				this._starling.nativeStage.addEventListener(FocusEvent.KEY_FOCUS_CHANGE, stage_keyFocusChangeHandler, false, 0, true);
				this._starling.nativeStage.addEventListener(FocusEvent.MOUSE_FOCUS_CHANGE, stage_mouseFocusChangeHandler, false, 0, true);
				this._starling.nativeStage.addEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler, false, 0, true);
				//TransformGestureEvent.GESTURE_DIRECTIONAL_TAP requires
				//AIR 24, but we want to support older versions too
				this._starling.nativeStage.addEventListener("gestureDirectionalTap", stage_gestureDirectionalTapHandler, false, 0, true);
				if(this._savedFocus && !this._savedFocus.stage)
				{
					this._savedFocus = null;
				}
				this.focus = this._savedFocus;
				this._savedFocus = null;
			}
			else
			{
				this._nativeFocusTarget.referenceCount--;
				if(this._nativeFocusTarget.referenceCount <= 0)
				{
					this._nativeFocusTarget.parent.removeChild(this._nativeFocusTarget);
					delete NATIVE_STAGE_TO_FOCUS_TARGET[this._starling.nativeStage];
				}
				this._nativeFocusTarget = null;
				this._root.removeEventListener(Event.ADDED, topLevelContainer_addedHandler);
				this._root.removeEventListener(Event.REMOVED, topLevelContainer_removedHandler);
				this._root.removeEventListener(TouchEvent.TOUCH, topLevelContainer_touchHandler);
				this._starling.nativeStage.removeEventListener(FocusEvent.KEY_FOCUS_CHANGE, stage_keyFocusChangeHandler);
				this._starling.nativeStage.removeEventListener(FocusEvent.MOUSE_FOCUS_CHANGE, stage_mouseFocusChangeHandler);
				this._starling.nativeStage.removeEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
				this._starling.nativeStage.removeEventListener("gestureDirectionalTap", stage_gestureDirectionalTapHandler);
				var focusToSave:IFocusDisplayObject = this.focus;
				this.focus = null;
				this._savedFocus = focusToSave;
			}
		}

		/**
		 * @private
		 */
		protected var _savedFocus:IFocusDisplayObject;

		/**
		 * @private
		 */
		protected var _focus:IFocusDisplayObject;

		/**
		 * @inheritDoc
		 *
		 * @default null
		 */
		public function get focus():IFocusDisplayObject
		{
			return this._focus;
		}

		/**
		 * @private
		 */
		public function set focus(value:IFocusDisplayObject):void
		{
			if(this._focus === value)
			{
				return;
			}
			var shouldHaveFocus:Boolean = false;
			var oldFocus:IFeathersDisplayObject = this._focus;
			if(this._isEnabled && value !== null && value.isFocusEnabled && value.focusManager === this)
			{
				this._focus = value;
				shouldHaveFocus = true;
			}
			else
			{
				this._focus = null;
			}
			var nativeStage:Stage = this._starling.nativeStage;
			if(oldFocus is INativeFocusOwner)
			{
				var nativeFocus:Object = INativeFocusOwner(oldFocus).nativeFocus;
				if(nativeFocus === null && nativeStage !== null)
				{
					nativeFocus = nativeStage.focus;
				}
				if(nativeFocus is IEventDispatcher)
				{
					//this listener restores focus, if it is lost in a way that
					//is out of our control. since we may be manually removing
					//focus in a listener for FeathersEventType.FOCUS_OUT, we
					//don't want it to restore focus.
					IEventDispatcher(nativeFocus).removeEventListener(FocusEvent.FOCUS_OUT, nativeFocus_focusOutHandler);
				}
			}
			if(oldFocus !== null)
			{
				//this event should be dispatched after setting the new value of
				//_focus because we want to be able to access the value of the
				//focus property in the event listener.
				oldFocus.dispatchEventWith(FeathersEventType.FOCUS_OUT);
			}
			if(shouldHaveFocus && this._focus !== value)
			{
				//this shouldn't happen, but if it does, let's not break the
				//current state even more by referencing an old focused object.
				return;
			}
			if(this._isEnabled)
			{
				if(this._focus !== null)
				{
					nativeFocus = null;
					if(this._focus is INativeFocusOwner)
					{
						nativeFocus = INativeFocusOwner(this._focus).nativeFocus;
						if(nativeFocus is InteractiveObject)
						{
							nativeStage.focus = InteractiveObject(nativeFocus);
						}
						else if(nativeFocus !== null)
						{
							if(this._focus is IAdvancedNativeFocusOwner)
							{
								var advancedFocus:IAdvancedNativeFocusOwner = IAdvancedNativeFocusOwner(this._focus);
								if(!advancedFocus.hasFocus)
								{
									//let the focused component handle giving focus to
									//its nativeFocus because it may have a custom API
									advancedFocus.setFocus();
								}
							}
							else
							{
								throw new IllegalOperationError("If nativeFocus does not return an InteractiveObject, class must implement IAdvancedNativeFocusOwner interface");
							}
						}
					}
					//an INativeFocusOwner may return null for its
					//nativeFocus property, so we still need to double-check
					//that the native stage has something in focus. that's
					//why there isn't an else here
					if(nativeFocus === null)
					{
						nativeFocus = this._nativeFocusTarget;
						nativeStage.focus = this._nativeFocusTarget;
					}
					if(nativeFocus is IEventDispatcher)
					{
						IEventDispatcher(nativeFocus).addEventListener(FocusEvent.FOCUS_OUT, nativeFocus_focusOutHandler, false, 0, true);
					}
					this._focus.dispatchEventWith(FeathersEventType.FOCUS_IN);
				}
				else
				{
					nativeStage.focus = null;
				}
			}
			else
			{
				this._savedFocus = value;
			}
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected function setFocusManager(target:DisplayObject):void
		{
			if(target is IFocusDisplayObject)
			{
				var targetWithFocus:IFocusDisplayObject = IFocusDisplayObject(target);
				targetWithFocus.focusManager = this;
			}
			if((target is DisplayObjectContainer && !(target is IFocusDisplayObject)) ||
				(target is IFocusContainer && IFocusContainer(target).isChildFocusEnabled))
			{
				var container:DisplayObjectContainer = DisplayObjectContainer(target);
				var childCount:int = container.numChildren;
				for(var i:int = 0; i < childCount; i++)
				{
					var child:DisplayObject = container.getChildAt(i);
					this.setFocusManager(child);
				}
				if(container is IFocusExtras)
				{
					var containerWithExtras:IFocusExtras = IFocusExtras(container);
					var extras:Vector.<DisplayObject> = containerWithExtras.focusExtrasBefore;
					if(extras)
					{
						childCount = extras.length;
						for(i = 0; i < childCount; i++)
						{
							child = extras[i];
							this.setFocusManager(child);
						}
					}
					extras = containerWithExtras.focusExtrasAfter;
					if(extras)
					{
						childCount = extras.length;
						for(i = 0; i < childCount; i++)
						{
							child = extras[i];
							this.setFocusManager(child);
						}
					}
				}
			}
		}

		/**
		 * @private
		 */
		protected function clearFocusManager(target:DisplayObject):void
		{
			if(target is IFocusDisplayObject)
			{
				var targetWithFocus:IFocusDisplayObject = IFocusDisplayObject(target);
				if(targetWithFocus.focusManager == this)
				{
					if(this._focus == targetWithFocus)
					{
						//change to focus owner, which falls back to null
						this.focus = targetWithFocus.focusOwner;
					}
					targetWithFocus.focusManager = null;
				}
			}
			if(target is DisplayObjectContainer)
			{
				var container:DisplayObjectContainer = DisplayObjectContainer(target);
				var childCount:int = container.numChildren;
				for(var i:int = 0; i < childCount; i++)
				{
					var child:DisplayObject = container.getChildAt(i);
					this.clearFocusManager(child);
				}
				if(container is IFocusExtras)
				{
					var containerWithExtras:IFocusExtras = IFocusExtras(container);
					var extras:Vector.<DisplayObject> = containerWithExtras.focusExtrasBefore;
					if(extras)
					{
						childCount = extras.length;
						for(i = 0; i < childCount; i++)
						{
							child = extras[i];
							this.clearFocusManager(child);
						}
					}
					extras = containerWithExtras.focusExtrasAfter;
					if(extras)
					{
						childCount = extras.length;
						for(i = 0; i < childCount; i++)
						{
							child = extras[i];
							this.clearFocusManager(child);
						}
					}
				}
			}
		}

		/**
		 * @private
		 */
		protected function findPreviousContainerFocus(container:DisplayObjectContainer, beforeChild:DisplayObject, fallbackToGlobal:Boolean):IFocusDisplayObject
		{
			if(container is LayoutViewPort)
			{
				container = container.parent;
			}
			var hasProcessedBeforeChild:Boolean = beforeChild == null;
			if(container is IFocusExtras)
			{
				var focusWithExtras:IFocusExtras = IFocusExtras(container);
				var extras:Vector.<DisplayObject> = focusWithExtras.focusExtrasAfter;
				if(extras)
				{
					var skip:Boolean = false;
					if(beforeChild)
					{
						var startIndex:int = extras.indexOf(beforeChild) - 1;
						hasProcessedBeforeChild = startIndex >= -1;
						skip = !hasProcessedBeforeChild;
					}
					else
					{
						startIndex = extras.length - 1;
					}
					if(!skip)
					{
						for(var i:int = startIndex; i >= 0; i--)
						{
							var child:DisplayObject = extras[i];
							var foundChild:IFocusDisplayObject = this.findPreviousChildFocus(child);
							if(this.isValidFocus(foundChild))
							{
								return foundChild;
							}
						}
					}
				}
			}
			if(beforeChild && !hasProcessedBeforeChild)
			{
				startIndex = container.getChildIndex(beforeChild) - 1;
				hasProcessedBeforeChild = startIndex >= -1;
			}
			else
			{
				startIndex = container.numChildren - 1;
			}
			for(i = startIndex; i >= 0; i--)
			{
				child = container.getChildAt(i);
				foundChild = this.findPreviousChildFocus(child);
				if(this.isValidFocus(foundChild))
				{
					return foundChild;
				}
			}
			if(container is IFocusExtras)
			{
				extras = focusWithExtras.focusExtrasBefore;
				if(extras)
				{
					skip = false;
					if(beforeChild && !hasProcessedBeforeChild)
					{
						startIndex = extras.indexOf(beforeChild) - 1;
						hasProcessedBeforeChild = startIndex >= -1;
						skip = !hasProcessedBeforeChild;
					}
					else
					{
						startIndex = extras.length - 1;
					}
					if(!skip)
					{
						for(i = startIndex; i >= 0; i--)
						{
							child = extras[i];
							foundChild = this.findPreviousChildFocus(child);
							if(this.isValidFocus(foundChild))
							{
								return foundChild;
							}
						}
					}
				}
			}

			if(fallbackToGlobal && container != this._root)
			{
				//try the container itself before moving backwards
				if(container is IFocusDisplayObject)
				{
					var focusContainer:IFocusDisplayObject = IFocusDisplayObject(container);
					if(this.isValidFocus(focusContainer))
					{
						return focusContainer;
					}
				}
				return this.findPreviousContainerFocus(container.parent, container, true);
			}
			return null;
		}

		/**
		 * @private
		 */
		protected function findNextContainerFocus(container:DisplayObjectContainer, afterChild:DisplayObject, fallbackToGlobal:Boolean):IFocusDisplayObject
		{
			if(container is LayoutViewPort)
			{
				container = container.parent;
			}
			var hasProcessedAfterChild:Boolean = afterChild == null;
			if(container is IFocusExtras)
			{
				var focusWithExtras:IFocusExtras = IFocusExtras(container);
				var extras:Vector.<DisplayObject> = focusWithExtras.focusExtrasBefore;
				if(extras)
				{
					var skip:Boolean = false;
					if(afterChild)
					{
						var startIndex:int = extras.indexOf(afterChild) + 1;
						hasProcessedAfterChild = startIndex > 0;
						skip = !hasProcessedAfterChild;
					}
					else
					{
						startIndex = 0;
					}
					if(!skip)
					{
						var childCount:int = extras.length;
						for(var i:int = startIndex; i < childCount; i++)
						{
							var child:DisplayObject = extras[i];
							var foundChild:IFocusDisplayObject = this.findNextChildFocus(child);
							if(this.isValidFocus(foundChild))
							{
								return foundChild;
							}
						}
					}
				}
			}
			if(afterChild && !hasProcessedAfterChild)
			{
				startIndex = container.getChildIndex(afterChild) + 1;
				hasProcessedAfterChild = startIndex > 0;
			}
			else
			{
				startIndex = 0;
			}
			childCount = container.numChildren;
			for(i = startIndex; i < childCount; i++)
			{
				child = container.getChildAt(i);
				foundChild = this.findNextChildFocus(child);
				if(this.isValidFocus(foundChild))
				{
					return foundChild;
				}
			}
			if(container is IFocusExtras)
			{
				extras = focusWithExtras.focusExtrasAfter;
				if(extras)
				{
					skip = false;
					if(afterChild && !hasProcessedAfterChild)
					{
						startIndex = extras.indexOf(afterChild) + 1;
						hasProcessedAfterChild = startIndex > 0;
						skip = !hasProcessedAfterChild;
					}
					else
					{
						startIndex = 0;
					}
					if(!skip)
					{
						childCount = extras.length;
						for(i = startIndex; i < childCount; i++)
						{
							child = extras[i];
							foundChild = this.findNextChildFocus(child);
							if(this.isValidFocus(foundChild))
							{
								return foundChild;
							}
						}
					}
				}
			}

			if(fallbackToGlobal && container != this._root)
			{
				return this.findNextContainerFocus(container.parent, container, true);
			}
			return null;
		}

		/**
		 * @private
		 */
		protected function findPreviousChildFocus(child:DisplayObject):IFocusDisplayObject
		{
			if((child is DisplayObjectContainer && !(child is IFocusDisplayObject)) ||
				(child is IFocusContainer && IFocusContainer(child).isChildFocusEnabled))
			{
				var childContainer:DisplayObjectContainer = DisplayObjectContainer(child);
				var foundChild:IFocusDisplayObject = this.findPreviousContainerFocus(childContainer, null, false);
				if(foundChild)
				{
					return foundChild;
				}
			}
			if(child is IFocusDisplayObject)
			{
				var childWithFocus:IFocusDisplayObject = IFocusDisplayObject(child);
				if(this.isValidFocus(childWithFocus))
				{
					return childWithFocus;
				}
			}
			return null;
		}

		/**
		 * @private
		 */
		protected function findNextChildFocus(child:DisplayObject):IFocusDisplayObject
		{
			if(child is IFocusDisplayObject)
			{
				var childWithFocus:IFocusDisplayObject = IFocusDisplayObject(child);
				if(this.isValidFocus(childWithFocus))
				{
					return childWithFocus;
				}
			}
			if((child is DisplayObjectContainer && !(child is IFocusDisplayObject)) ||
				(child is IFocusContainer && IFocusContainer(child).isChildFocusEnabled))
			{
				var childContainer:DisplayObjectContainer = DisplayObjectContainer(child);
				var foundChild:IFocusDisplayObject = this.findNextContainerFocus(childContainer, null, false);
				if(foundChild)
				{
					return foundChild;
				}
			}
			return null;
		}

		/**
		 * @private
		 */
		protected function findFocusAtRelativePosition(container:DisplayObjectContainer, position:String):IFocusDisplayObject
		{
			var focusableObjects:Vector.<IFocusDisplayObject> = new <IFocusDisplayObject>[];
			findAllFocusableObjects(container, focusableObjects);
			if(this._focus === null)
			{
				if(focusableObjects.length > 0)
				{
					return focusableObjects[0];
				}
				return null;
			}
			var focusedRect:Rectangle = this._focus.getBounds(this._focus.stage, Pool.getRectangle());
			var result:IFocusDisplayObject = null;
			var count:int = focusableObjects.length;
			for(var i:int = 0; i < count; i++)
			{
				var focusableObject:IFocusDisplayObject = focusableObjects[i];
				if(focusableObject === this._focus)
				{
					continue;
				}
				if(isBetterFocusForRelativePosition(focusableObject, result, focusedRect, position))
				{
					result = focusableObject;
				}
			}
			Pool.putRectangle(focusedRect);
			if(result === null)
			{
				//default to keeping the current focus
				return this._focus;
			}
			return result;
		}

		/**
		 * @private
		 */
		protected function findAllFocusableObjects(child:DisplayObject, result:Vector.<IFocusDisplayObject>):void
		{
			if(child is IFocusDisplayObject)
			{
				var focusableObject:IFocusDisplayObject = IFocusDisplayObject(child);
				if(isValidFocus(focusableObject))
				{
					result[result.length] = focusableObject;
				}
			}
			if(child is IFocusExtras)
			{
				var focusExtras:IFocusExtras = IFocusExtras(child);
				var extras:Vector.<DisplayObject> = focusExtras.focusExtrasBefore;
				var count:int = extras.length;
				for(var i:int = 0; i < count; i++)
				{
					var childOfChild:DisplayObject = extras[i];
					findAllFocusableObjects(childOfChild, result);
				}
			}
			if(child is IFocusDisplayObject)
			{
				if(child is IFocusContainer && IFocusContainer(child).isChildFocusEnabled)
				{
					var otherContainer:DisplayObjectContainer = DisplayObjectContainer(child);
					count = otherContainer.numChildren;
					for(i = 0; i < count; i++)
					{
						childOfChild = otherContainer.getChildAt(i);
						findAllFocusableObjects(childOfChild, result);
					}
				}
			}
			else if(child is DisplayObjectContainer)
			{
				otherContainer = DisplayObjectContainer(child);
				count = otherContainer.numChildren;
				for(i = 0; i < count; i++)
				{
					childOfChild = otherContainer.getChildAt(i);
					findAllFocusableObjects(childOfChild, result);
				}
			}
			if(child is IFocusExtras)
			{
				extras = focusExtras.focusExtrasAfter;
				count = extras.length;
				for(i = 0; i < count; i++)
				{
					childOfChild = extras[i];
					findAllFocusableObjects(childOfChild, result);
				}
			}
		}

		/**
		 * @private
		 */
		protected function isValidFocus(child:IFocusDisplayObject):Boolean
		{
			if(child === null || child.focusManager !== this)
			{
				return false;
			}
			if(!child.isFocusEnabled)
			{
				if(child.focusOwner === null || !isValidFocus(child.focusOwner))
				{
					return false;
				}
			}
			var uiChild:IFeathersControl = child as IFeathersControl;
			if(uiChild !== null && !uiChild.isEnabled)
			{
				return false;
			}
			return true;
		}

		/**
		 * @private
		 */
		protected function stage_mouseFocusChangeHandler(event:FocusEvent):void
		{
			if(event.relatedObject)
			{
				//we need to allow mouse focus to be passed to native display
				//objects. for instance, hyperlinks in TextField won't work
				//unless the TextField can be focused.
				this.focus = null;
				return;
			}
			event.preventDefault();
		}

		/**
		 * @private
		 */
		protected function stage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.keyLocation != KeyLocation.D_PAD && !DeviceCapabilities.simulateDPad)
			{
				//focus is controlled only with a d-pad and not the regular
				//keyboard arrow keys
				return;
			}
			if(event.keyCode != Keyboard.UP && event.keyCode != Keyboard.DOWN &&
				event.keyCode != Keyboard.LEFT && event.keyCode != Keyboard.RIGHT)
			{
				return;
			}
			if(event.isDefaultPrevented())
			{
				//something else has already handled this keyboard event
				return;
			}
			var newFocus:IFocusDisplayObject;
			var currentFocus:IFocusDisplayObject = this._focus;
			if(currentFocus !== null && currentFocus.focusOwner !== null)
			{
				newFocus = currentFocus.focusOwner;
			}
			else
			{
				var position:String = RelativePosition.RIGHT;
				switch(event.keyCode)
				{
					case Keyboard.UP:
					{
						position = RelativePosition.TOP;
						if(currentFocus !== null && currentFocus.nextUpFocus !== null)
						{
							newFocus = currentFocus.nextUpFocus;
						}
						break;
					}
					case Keyboard.RIGHT:
					{
						position = RelativePosition.RIGHT;
						if(currentFocus !== null && currentFocus.nextRightFocus !== null)
						{
							newFocus = currentFocus.nextRightFocus;
						}
						break;
					}
					case Keyboard.DOWN:
					{
						position = RelativePosition.BOTTOM;
						if(currentFocus !== null && currentFocus.nextDownFocus !== null)
						{
							newFocus = currentFocus.nextDownFocus;
						}
						break;
					}
					case Keyboard.LEFT:
					{
						position = RelativePosition.LEFT;
						if(currentFocus !== null && currentFocus.nextLeftFocus !== null)
						{
							newFocus = currentFocus.nextLeftFocus;
						}
						break;
					}
				}
				if(newFocus === null)
				{
					newFocus = findFocusAtRelativePosition(this._root, position);
				}
			}
			if(newFocus !== this._focus)
			{
				event.preventDefault();
				this.focus = newFocus;
			}
			if(this._focus)
			{
				this._focus.showFocus();
			}
		}

		/**
		 * @private
		 */
		protected function stage_gestureDirectionalTapHandler(event:TransformGestureEvent):void
		{
			if(event.isDefaultPrevented())
			{
				//something else has already handled this event
				return;
			}
			var position:String = null;
			if(event.offsetY < 0)
			{
				position = RelativePosition.TOP;
			}
			else if(event.offsetY > 0)
			{
				position = RelativePosition.BOTTOM;
			}
			else if(event.offsetX > 0)
			{
				position = RelativePosition.RIGHT;
			}
			else if(event.offsetX < 0)
			{
				position = RelativePosition.LEFT;
			}
			if(position === null)
			{
				return;
			}
			var newFocus:IFocusDisplayObject = findFocusAtRelativePosition(this._root, position);
			if(newFocus !== this._focus)
			{
				event.preventDefault();
				this.focus = newFocus;
			}
			if(this._focus)
			{
				this._focus.showFocus();
			}
		}

		/**
		 * @private
		 */
		protected function stage_keyFocusChangeHandler(event:FocusEvent):void
		{
			//keyCode 0 is sent by IE, for some reason
			if(event.keyCode != Keyboard.TAB && event.keyCode != 0)
			{
				return;
			}

			var newFocus:IFocusDisplayObject;
			var currentFocus:IFocusDisplayObject = this._focus;
			if(currentFocus && currentFocus.focusOwner)
			{
				newFocus = currentFocus.focusOwner;
			}
			else if(event.shiftKey)
			{
				if(currentFocus)
				{
					if(currentFocus.previousTabFocus)
					{
						newFocus = currentFocus.previousTabFocus;
					}
					else
					{
						newFocus = this.findPreviousContainerFocus(currentFocus.parent, DisplayObject(currentFocus), true);
					}
				}
				if(!newFocus)
				{
					newFocus = this.findPreviousContainerFocus(this._root, null, false);
				}
			}
			else
			{
				if(currentFocus)
				{
					if(currentFocus.nextTabFocus)
					{
						newFocus = currentFocus.nextTabFocus;
					}
					else if(currentFocus is IFocusContainer && IFocusContainer(currentFocus).isChildFocusEnabled)
					{
						newFocus = this.findNextContainerFocus(DisplayObjectContainer(currentFocus), null, true);
					}
					else
					{
						newFocus = this.findNextContainerFocus(currentFocus.parent, DisplayObject(currentFocus), true);
					}
				}
				if(!newFocus)
				{
					newFocus = this.findNextContainerFocus(this._root, null, false);
				}
			}
			if(newFocus)
			{
				event.preventDefault();
			}
			this.focus = newFocus;
			if(this._focus)
			{
				this._focus.showFocus();
			}

		}

		/**
		 * @private
		 */
		protected function topLevelContainer_addedHandler(event:Event):void
		{
			this.setFocusManager(DisplayObject(event.target));

		}

		/**
		 * @private
		 */
		protected function topLevelContainer_removedHandler(event:Event):void
		{
			this.clearFocusManager(DisplayObject(event.target));
		}

		/**
		 * @private
		 */
		protected function topLevelContainer_touchHandler(event:TouchEvent):void
		{
			if(Capabilities.os.indexOf("tvOS") != -1)
			{
				return;
			}
			var touch:Touch = event.getTouch(this._root, TouchPhase.BEGAN);
			if(!touch)
			{
				return;
			}
			if(this._focus !== null && this._focus.maintainTouchFocus)
			{
				return;
			}

			var focusTarget:IFocusDisplayObject = null;
			var target:DisplayObject = touch.target;
			do
			{
				if(target is IFocusDisplayObject)
				{
					var tempFocusTarget:IFocusDisplayObject = IFocusDisplayObject(target);
					if(this.isValidFocus(tempFocusTarget))
					{
						if(!focusTarget || !(tempFocusTarget is IFocusContainer) || !(IFocusContainer(tempFocusTarget).isChildFocusEnabled))
						{
							focusTarget = tempFocusTarget;
						}
					}
				}
				target = target.parent;
			}
			while(target);
			if(this._focus !== null && focusTarget !== null)
			{
				//ignore touches on focusOwner because we consider the
				//focusOwner to indirectly have focus already
				var focusOwner:IFocusDisplayObject = this._focus.focusOwner;
				if(focusOwner === focusTarget)
				{
					return;
				}
				//similarly, ignore touches on display objects that have a
				//focusOwner and that owner is the currently focused object
				var result:DisplayObject = DisplayObject(focusTarget);
				while(result != null)
				{
					var focusResult:IFocusDisplayObject = result as IFocusDisplayObject;
					if(focusResult !== null)
					{
						focusOwner = focusResult.focusOwner;
						if(focusOwner !== null)
						{
							if(focusOwner === this._focus)
							{
								//the current focus is the touch target's owner,
								//so we don't need to clear focus
								focusTarget = focusOwner;
							}
							//if we've found a display object with a focus owner,
							//then we've gone far enough up the display list
							break;
						}
						else if(focusResult.isFocusEnabled)
						{
							//if focus in enabled, then we've gone far enough up
							//the display list
							break;
						}
					}
					result = result.parent;
				}
			}
			this.focus = focusTarget;
		}

		/**
		 * @private
		 */
		protected function nativeFocus_focusOutHandler(event:FocusEvent):void
		{
			var nativeFocus:Object = event.currentTarget;
			var nativeStage:Stage = this._starling.nativeStage;
			if(nativeStage.focus !== null && nativeStage.focus !== nativeFocus)
			{
				//we should stop listening for this event because something else
				//has focus now
				if(nativeFocus is IEventDispatcher)
				{
					IEventDispatcher(nativeFocus).removeEventListener(FocusEvent.FOCUS_OUT, nativeFocus_focusOutHandler);
				}
			}
			else if(this._focus !== null)
			{
				if(this._focus is INativeFocusOwner &&
					INativeFocusOwner(this._focus).nativeFocus !== nativeFocus)
				{
					return;
				}
				//if there's still a feathers focus, but the native stage object has
				//lost focus for some reason, and there's no focus at all, force it
				//back into focus.
				//this can happen on app deactivate!
				if(nativeFocus is InteractiveObject)
				{
					nativeStage.focus = InteractiveObject(nativeFocus);
				}
				else //nativeFocus is IAdvancedNativeFocusOwner
				{
					//let the focused component handle giving focus to its
					//nativeFocus because it may have a custom API
					IAdvancedNativeFocusOwner(this._focus).setFocus();
				}
			}
		}
	}
}

import flash.display.Sprite;

class NativeFocusTarget extends Sprite
{
	public function NativeFocusTarget()
	{
		this.tabEnabled = true;
		this.mouseEnabled = false;
		this.mouseChildren = false;
		this.alpha = 0;
	}

	public var referenceCount:int = 1;
}

================================================
FILE: source/feathers/core/DefaultPopUpManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import feathers.events.FeathersEventType;

	import flash.utils.Dictionary;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Quad;
	import starling.display.Stage;
	import starling.events.Event;
	import starling.events.ResizeEvent;

	/**
	 * The default <code>IPopUpManager</code> implementation.
	 *
	 * @see PopUpManager
	 *
	 * @productversion Feathers 1.3.0
	 */
	public class DefaultPopUpManager implements IPopUpManager
	{
		/**
		 * @copy PopUpManager#defaultOverlayFactory()
		 */
		public static function defaultOverlayFactory():DisplayObject
		{
			var quad:Quad = new Quad(100, 100, 0x000000);
			quad.alpha = 0;
			return quad;
		}

		/**
		 * Constructor.
		 */
		public function DefaultPopUpManager(root:DisplayObjectContainer = null)
		{
			this.root = root;
		}

		/**
		 * @private
		 */
		protected var _popUps:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * @copy PopUpManager#popUpCount
		 */
		public function get popUpCount():int
		{
			return this._popUps.length;
		}

		/**
		 * @private
		 */
		protected var _popUpToOverlay:Dictionary = new Dictionary(true);

		/**
		 * @private
		 */
		protected var _popUpToFocusManager:Dictionary = new Dictionary(true);

		/**
		 * @private
		 */
		protected var _centeredPopUps:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * @private
		 */
		protected var _overlayFactory:Function = defaultOverlayFactory;

		/**
		 * @copy PopUpManager#overlayFactory
		 */
		public function get overlayFactory():Function
		{
			return this._overlayFactory;
		}

		/**
		 * @private
		 */
		public function set overlayFactory(value:Function):void
		{
			this._overlayFactory = value;
		}

		/**
		 * @private
		 */
		protected var _ignoreRemoval:Boolean = false;

		/**
		 * @private
		 */
		protected var _root:DisplayObjectContainer;

		/**
		 * @copy PopUpManager#root
		 */
		public function get root():DisplayObjectContainer
		{
			return this._root;
		}

		/**
		 * @private
		 */
		public function set root(value:DisplayObjectContainer):void
		{
			if(this._root == value)
			{
				return;
			}
			var popUpCount:int = this._popUps.length;
			var oldIgnoreRemoval:Boolean = this._ignoreRemoval; //just in case
			this._ignoreRemoval = true;
			for(var i:int = 0; i < popUpCount; i++)
			{
				var popUp:DisplayObject = this._popUps[i];
				var overlay:DisplayObject = DisplayObject(_popUpToOverlay[popUp]);
				popUp.removeFromParent(false);
				if(overlay)
				{
					overlay.removeFromParent(false);
				}
			}
			this._ignoreRemoval = oldIgnoreRemoval;
			this._root = value;
			for(i = 0; i < popUpCount; i++)
			{
				popUp = this._popUps[i];
				overlay = DisplayObject(_popUpToOverlay[popUp]);
				if(overlay)
				{
					this._root.addChild(overlay);
				}
				this._root.addChild(popUp);
			}
		}

		/**
		 * @copy PopUpManager#addPopUp()
		 */
		public function addPopUp(popUp:DisplayObject, isModal:Boolean = true, isCentered:Boolean = true, customOverlayFactory:Function = null):DisplayObject
		{
			if(isModal)
			{
				if(customOverlayFactory == null)
				{
					customOverlayFactory = this._overlayFactory;
				}
				if(customOverlayFactory == null)
				{
					customOverlayFactory = defaultOverlayFactory;
				}
				var overlay:DisplayObject = customOverlayFactory();
				overlay.width = this._root.stage.stageWidth;
				overlay.height = this._root.stage.stageHeight;
				this._root.addChild(overlay);
				this._popUpToOverlay[popUp] = overlay;
			}

			this._popUps.push(popUp);
			this._root.addChild(popUp);
			//this listener needs to be added after the pop-up is added to the
			//root because the pop-up may not have been removed from its old
			//parent yet, which will trigger the listener if it is added first.
			popUp.addEventListener(Event.REMOVED_FROM_STAGE, popUp_removedFromStageHandler);

			if(this._popUps.length == 1)
			{
				this._root.stage.addEventListener(ResizeEvent.RESIZE, stage_resizeHandler);
			}

			if(isModal && FocusManager.isEnabledForStage(this._root.stage) && popUp is DisplayObjectContainer)
			{
				this._popUpToFocusManager[popUp] = FocusManager.pushFocusManager(DisplayObjectContainer(popUp));
			}

			if(isCentered)
			{
				if(popUp is IFeathersControl)
				{
					popUp.addEventListener(FeathersEventType.RESIZE, popUp_resizeHandler);
				}
				this._centeredPopUps.push(popUp);
				this.centerPopUp(popUp);
			}

			return popUp;
		}

		/**
		 * @copy PopUpManager#removePopUp()
		 */
		public function removePopUp(popUp:DisplayObject, dispose:Boolean = false):DisplayObject
		{
			var index:int = this._popUps.indexOf(popUp);
			if(index < 0)
			{
				throw new ArgumentError("Display object is not a pop-up.");
			}
			popUp.removeFromParent(dispose);
			return popUp;
		}

		/**
		 * @copy PopUpManager#removeAllPopUps()
		 */
		public function removeAllPopUps(dispose:Boolean = false):void
		{
			//removing pop-ups may call event listeners that add new pop-ups,
			//and we don't want to remove the new ones or miss old ones, so
			//create a copy of the _popUps Vector to be safe.
			var popUps:Vector.<DisplayObject> = this._popUps.slice();
			var popUpCount:int = popUps.length;
			for(var i:int = 0; i < popUpCount; i++)
			{
				var popUp:DisplayObject = popUps[i];
				//we check if this is still a pop-up because it might have been
				//removed in an Event.REMOVED or Event.REMOVED_FROM_STAGE
				//listener for another pop-up earlier in the loop
				if(this.isPopUp(popUp))
				{
					this.removePopUp(popUp, dispose);
				}
			}
		}

		/**
		 * @copy PopUpManager#isPopUp()
		 */
		public function isPopUp(popUp:DisplayObject):Boolean
		{
			return this._popUps.indexOf(popUp) >= 0;
		}

		/**
		 * @copy PopUpManager#isTopLevelPopUp()
		 */
		public function isTopLevelPopUp(popUp:DisplayObject):Boolean
		{
			var lastIndex:int = this._popUps.length - 1;
			for(var i:int = lastIndex; i >= 0; i--)
			{
				var otherPopUp:DisplayObject = this._popUps[i];
				if(otherPopUp == popUp)
				{
					//we haven't encountered an overlay yet, so it is top-level
					return true;
				}
				var overlay:DisplayObject = this._popUpToOverlay[otherPopUp] as DisplayObject;
				if(overlay)
				{
					//this is the first overlay, and we haven't found the pop-up
					//yet, so it is not top-level
					return false;
				}
			}
			//pop-up was not found at all, so obviously, not top-level
			return false;
		}

		/**
		 * @copy PopUpManager#centerPopUp()
		 */
		public function centerPopUp(popUp:DisplayObject):void
		{
			var stage:Stage = this._root.stage;
			if(popUp is IValidating)
			{
				IValidating(popUp).validate();
			}
			popUp.x = popUp.pivotX + Math.round((stage.stageWidth - popUp.width) / 2);
			popUp.y = popUp.pivotY + Math.round((stage.stageHeight - popUp.height) / 2);
		}

		/**
		 * @private
		 */
		protected function popUp_resizeHandler(event:Event):void
		{
			var popUp:DisplayObject = DisplayObject(event.currentTarget);
			var index:int = this._centeredPopUps.indexOf(popUp);
			if(index < 0)
			{
				return;
			}
			this.centerPopUp(popUp);
		}

		/**
		 * @private
		 */
		protected function popUp_removedFromStageHandler(event:Event):void
		{
			if(this._ignoreRemoval)
			{
				return;
			}
			var popUp:DisplayObject = DisplayObject(event.currentTarget);
			popUp.removeEventListener(Event.REMOVED_FROM_STAGE, popUp_removedFromStageHandler);
			var index:int = this._popUps.indexOf(popUp);
			this._popUps.removeAt(index);
			var overlay:DisplayObject = DisplayObject(this._popUpToOverlay[popUp]);
			if(overlay)
			{
				overlay.removeFromParent(true);
				delete _popUpToOverlay[popUp];
			}
			var focusManager:IFocusManager = this._popUpToFocusManager[popUp] as IFocusManager;
			if(focusManager)
			{
				delete this._popUpToFocusManager[popUp];
				FocusManager.removeFocusManager(focusManager);
			}
			index = this._centeredPopUps.indexOf(popUp);
			if(index >= 0)
			{
				if(popUp is IFeathersControl)
				{
					popUp.removeEventListener(FeathersEventType.RESIZE, popUp_resizeHandler);
				}
				this._centeredPopUps.removeAt(index);
			}

			if(_popUps.length == 0)
			{
				this._root.stage.removeEventListener(ResizeEvent.RESIZE, stage_resizeHandler);
			}
		}

		/**
		 * @private
		 */
		protected function stage_resizeHandler(event:ResizeEvent):void
		{
			var stage:Stage = this._root.stage;
			var popUpCount:int = this._popUps.length;
			for(var i:int = 0; i < popUpCount; i++)
			{
				var popUp:DisplayObject = this._popUps[i];
				var overlay:DisplayObject = DisplayObject(this._popUpToOverlay[popUp]);
				if(overlay)
				{
					overlay.width = stage.stageWidth;
					overlay.height = stage.stageHeight;
				}
			}
			popUpCount = this._centeredPopUps.length;
			for(i = 0; i < popUpCount; i++)
			{
				popUp = this._centeredPopUps[i];
				centerPopUp(popUp);
			}
		}
	}
}


================================================
FILE: source/feathers/core/DefaultToolTipManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import feathers.controls.Label;

	import flash.utils.getTimer;

	import starling.animation.DelayedCall;
	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	/**
	 * The default <code>IToolTipManager</code> implementation.
	 *
	 * @see ../../../help/tool-tips.html Tool tips in Feathers
	 * @see feathers.core.ToolTipManager
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class DefaultToolTipManager implements IToolTipManager
	{
		/**
		 * The default factory that creates a tool tip. Creates a
		 * <code>Label</code> with the style name
		 * <code>Label.ALTERNATE_STYLE_NAME_TOOL_TIP</code>.
		 *
		 * @see #toolTipFactory
		 * @see feathers.controls.Label
		 * @see feathers.controls.Label#ALTERNATE_STYLE_NAME_TOOL_TIP
		 */
		public static function defaultToolTipFactory():IToolTip
		{
			var toolTip:Label = new Label();
			toolTip.styleNameList.add(Label.ALTERNATE_STYLE_NAME_TOOL_TIP);
			return toolTip;
		}

		/**
		 * Constructor.
		 */
		public function DefaultToolTipManager(root:DisplayObjectContainer)
		{
			this._root = root;
			this._root.addEventListener(TouchEvent.TOUCH, root_touchHandler);
		}

		/**
		 * @private
		 */
		protected var _touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _delayedCall:DelayedCall;

		/**
		 * @private
		 */
		protected var _toolTipX:Number = 0;

		/**
		 * @private
		 */
		protected var _toolTipY:Number = 0;

		/**
		 * @private
		 */
		protected var _hideTime:int = 0;

		/**
		 * @private
		 */
		protected var _root:DisplayObjectContainer;

		/**
		 * @private
		 */
		protected var _target:IFeathersControl;

		/**
		 * @private
		 */
		protected var _toolTip:IToolTip;

		/**
		 * @private
		 */
		protected var _toolTipFactory:Function;

		/**
		 * A function that creates a tool tip.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 * <pre>function():IToolTip</pre>
		 *
		 * @see feathers.core.IToolTip
		 */
		public function get toolTipFactory():Function
		{
			return this._toolTipFactory;
		}

		/**
		 * @private
		 */
		public function set toolTipFactory(value:Function):void
		{
			if(this._toolTipFactory === value)
			{
				return;
			}
			this._toolTipFactory = value;
			if(this._toolTip)
			{
				this._toolTip.removeFromParent(true);
				this._toolTip = null;
			}
		}

		/**
		 * @private
		 */
		protected var _showDelay:Number = 0.5;

		/**
		 * The delay, in seconds, before a tool tip may be displayed when the
		 * mouse is idle over a component with a tool tip.
		 *
		 * @default 0.5
		 */
		public function get showDelay():Number
		{
			return this._showDelay;
		}

		/**
		 * @private
		 */
		public function set showDelay(value:Number):void
		{
			this._showDelay = value;
		}

		/**
		 * @private
		 */
		protected var _resetDelay:Number = 0.1;

		/**
		 * The time, in seconds, after hiding a tool tip before the
		 * <code>showDelay</code> is required to show a new tool tip for another
		 * component. If the mouse moves over another component before this
		 * threshold, the tool tip will be shown immediately. This allows
		 * tooltips for adjacent components, such as those appearing in
		 * toolbars, to be shown quickly.
		 *
		 * <p>To disable this behavior, set the <code>resetDelay</code> to
		 * <code>0</code>.</p>
		 *
		 * @default 0.1
		 */
		public function get resetDelay():Number
		{
			return this._resetDelay;
		}

		/**
		 * @private
		 */
		public function set resetDelay(value:Number):void
		{
			this._resetDelay = value;
		}

		/**
		 * @private
		 */
		protected var _offsetX:Number = 0;

		/**
		 * The offset, in pixels, of the tool tip position on the x axis.
		 *
		 * @default 0
		 */
		public function get offsetX():Number
		{
			return this._offsetX;
		}

		/**
		 * @private
		 */
		public function set offsetX(value:Number):void
		{
			this._offsetX = value;
		}

		/**
		 * @private
		 */
		protected var _offsetY:Number = 0;

		/**
		 * The offset, in pixels, of the tool tip position on the y axis.
		 *
		 * @default 0
		 */
		public function get offsetY():Number
		{
			return this._offsetY;
		}

		/**
		 * @private
		 */
		public function set offsetY(value:Number):void
		{
			this._offsetY = value;
		}

		/**
		 * @copy feathers.core.IToolTipManager#dispose()
		 */
		public function dispose():void
		{
			this._root.removeEventListener(TouchEvent.TOUCH, root_touchHandler);
			this._root = null;

			if(Starling.juggler.contains(this._delayedCall))
			{
				Starling.juggler.remove(this._delayedCall);
				this._delayedCall = null;
			}

			if(this._toolTip)
			{
				this._toolTip.removeFromParent(true);
				this._toolTip = null;
			}
		}

		/**
		 * @private
		 */
		protected function getTarget(touch:Touch):IFeathersControl
		{
			var target:DisplayObject = touch.target;
			while(target !== null)
			{
				if(target is IFeathersControl)
				{
					var toolTipSource:IFeathersControl = IFeathersControl(target);
					if(toolTipSource.toolTip)
					{
						return toolTipSource;
					}
				}
				target = target.parent;
			}
			return null;
		}

		/**
		 * @private
		 */
		protected function hoverDelayCallback():void
		{
			if(!this._toolTip)
			{
				var factory:Function = this._toolTipFactory !== null ? this._toolTipFactory : defaultToolTipFactory;
				var toolTip:IToolTip = IToolTip(factory());
				toolTip.touchable = false;
				this._toolTip = toolTip;
			}
			this._toolTip.text = this._target.toolTip;
			this._toolTip.validate();
			var toolTipX:Number = this._toolTipX + this._offsetX;
			if(toolTipX < 0)
			{
				toolTipX = 0;
			}
			else if((toolTipX + this._toolTip.width) > this._target.stage.stageWidth)
			{
				toolTipX = this._target.stage.stageWidth - this._toolTip.width;
			}
			var toolTipY:Number = this._toolTipY - this._toolTip.height + this._offsetY;
			if(toolTipY < 0)
			{
				toolTipY = 0;
			}
			else if((toolTipY + this._toolTip.height) > this._target.stage.stageHeight)
			{
				toolTipY = this._target.stage.stageHeight - this._toolTip.height;
			}
			this._toolTip.x = toolTipX;
			this._toolTip.y = toolTipY;
			PopUpManager.addPopUp(DisplayObject(this._toolTip), false, false);
		}

		/**
		 * @private
		 */
		protected function root_touchHandler(event:TouchEvent):void
		{
			if(this._toolTip !== null && this._toolTip.parent !== null)
			{
				var touch:Touch = event.getTouch(DisplayObject(this._target), null, this._touchPointID);
				if(!touch || touch.phase !== TouchPhase.HOVER)
				{
					//to avoid excessive garbage collection, we reuse the
					//tooltip object
					PopUpManager.removePopUp(DisplayObject(this._toolTip), false);
					this._touchPointID = -1;
					this._target = null;
					this._hideTime = getTimer();
				}
				return;
			}
			if(this._target !== null)
			{
				touch = event.getTouch(DisplayObject(this._target), null, this._touchPointID);
				if(!touch || touch.phase !== TouchPhase.HOVER)
				{
					Starling.juggler.remove(this._delayedCall);
					this._touchPointID = -1;
					this._target = null;
					return;
				}

				//every time TouchPhase.HOVER is dispatched, the mouse has
				//moved. we need to reset the timer and update the position
				//where the tool tip will appear when the timer completes
				this._toolTipX = touch.globalX;
				this._toolTipY = touch.globalY;
				this._delayedCall.reset(hoverDelayCallback, this._showDelay);
			}
			else
			{
				touch = event.getTouch(this._root, TouchPhase.HOVER);
				if(!touch)
				{
					return;
				}
				this._target = this.getTarget(touch);
				if(!this._target)
				{
					return;
				}
				this._touchPointID = touch.id;
				this._toolTipX = touch.globalX;
				this._toolTipY = touch.globalY;
				var timeSinceHide:Number = (getTimer() - this._hideTime) / 1000;
				if(timeSinceHide < this._resetDelay)
				{
					this.hoverDelayCallback();
					return;
				}
				if(this._delayedCall)
				{
					//to avoid excessive garbage collection, we reuse the
					//DelayedCall object.
					this._delayedCall.reset(hoverDelayCallback, this._showDelay);
				}
				else
				{
					this._delayedCall = new DelayedCall(hoverDelayCallback, this._showDelay);
				}
				Starling.juggler.add(this._delayedCall);
			}
		}
	}
}


================================================
FILE: source/feathers/core/FeathersControl.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import feathers.controls.text.BitmapFontTextRenderer;
	import feathers.controls.text.StageTextTextEditor;
	import feathers.events.FeathersEventType;
	import feathers.layout.ILayoutData;
	import feathers.layout.ILayoutDisplayObject;
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.motion.effectClasses.IMoveEffectContext;
	import feathers.motion.effectClasses.IResizeEffectContext;
	import feathers.skins.IStyleProvider;
	import feathers.utils.display.getDisplayObjectDepthFromStage;

	import flash.errors.IllegalOperationError;
	import flash.geom.Matrix;
	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.utils.Dictionary;
	import flash.utils.getQualifiedClassName;

	import starling.display.DisplayObject;
	import starling.display.Sprite;
	import starling.events.Event;
	import starling.events.EventDispatcher;
	import starling.utils.MatrixUtil;
	import starling.utils.Pool;

	/**
	 * If this component supports focus, this optional skin will be
	 * displayed above the component when <code>showFocus()</code> is
	 * called. The focus indicator skin is not always displayed when the
	 * component has focus. Typically, if the component receives focus from
	 * a touch, the focus indicator is not displayed.
	 *
	 * <p>The <code>touchable</code> of this skin will always be set to
	 * <code>false</code> so that it does not "steal" touches from the
	 * component or its sub-components. This skin will not affect the
	 * dimensions of the component or its hit area. It is simply a visual
	 * indicator of focus.</p>
	 *
	 * <p>The implementation of this property is provided for convenience,
	 * but it cannot be used unless a subclass implements the
	 * <code>IFocusDisplayObject</code> interface.</p>
	 *
	 * <p>In the following example, the focus indicator skin is set:</p>
	 *
	 * <listing version="3.0">
	 * control.focusIndicatorSkin = new Image( texture );</listing>
	 *
	 * @default null
	 *
	 * @see #style:focusPaddingTop
	 * @see #style:focusPaddingRight
	 * @see #style:focusPaddingBottom
	 * @see #style:focusPaddingLeft
	 * @see #style:focusPadding
	 */
	[Style(name="focusIndicatorSkin",type="starling.display.DisplayObject")]

	/**
	 * Quickly sets all focus padding properties to the same value. The
	 * <code>focusPadding</code> getter always returns the value of
	 * <code>focusPaddingTop</code>, but the other focus padding values may
	 * be different.
	 *
	 * <p>The implementation of this property is provided for convenience,
	 * but it cannot be used unless a subclass implements the
	 * <code>IFocusDisplayObject</code> interface.</p>
	 *
	 * <p>The following example gives the button 2 pixels of focus padding
	 * on all sides:</p>
	 *
	 * <listing version="3.0">
	 * control.focusPadding = 2;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:focusPaddingTop
	 * @see #style:focusPaddingRight
	 * @see #style:focusPaddingBottom
	 * @see #style:focusPaddingLeft
	 */
	[Style(name="focusPadding",type="Number")]

	/**
	 * The minimum space, in pixels, between the object's top edge and the
	 * top edge of the focus indicator skin. A negative value may be used
	 * to expand the focus indicator skin outside the bounds of the object.
	 *
	 * <p>The implementation of this property is provided for convenience,
	 * but it cannot be used unless a subclass implements the
	 * <code>IFocusDisplayObject</code> interface.</p>
	 *
	 * <p>The following example gives the focus indicator skin -2 pixels of
	 * padding on the top edge only:</p>
	 *
	 * <listing version="3.0">
	 * control.focusPaddingTop = -2;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:focusPadding
	 */
	[Style(name="focusPaddingTop",type="Number")]

	/**
	 * The minimum space, in pixels, between the object's right edge and the
	 * right edge of the focus indicator skin. A negative value may be used
	 * to expand the focus indicator skin outside the bounds of the object.
	 *
	 * <p>The implementation of this property is provided for convenience,
	 * but it cannot be used unless a subclass implements the
	 * <code>IFocusDisplayObject</code> interface.</p>
	 *
	 * <p>The following example gives the focus indicator skin -2 pixels of
	 * padding on the right edge only:</p>
	 *
	 * <listing version="3.0">
	 * control.focusPaddingRight = -2;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:focusPadding
	 */
	[Style(name="focusPaddingRight",type="Number")]

	/**
	 * The minimum space, in pixels, between the object's bottom edge and the
	 * bottom edge of the focus indicator skin. A negative value may be used
	 * to expand the focus indicator skin outside the bounds of the object.
	 *
	 * <p>The implementation of this property is provided for convenience,
	 * but it cannot be used unless a subclass implements the
	 * <code>IFocusDisplayObject</code> interface.</p>
	 *
	 * <p>The following example gives the focus indicator skin -2 pixels of
	 * padding on the bottom edge only:</p>
	 *
	 * <listing version="3.0">
	 * control.focusPaddingBottom = -2;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:focusPadding
	 */
	[Style(name="focusPaddingBottom",type="Number")]

	/**
	 * The minimum space, in pixels, between the object's left edge and the
	 * left edge of the focus indicator skin. A negative value may be used
	 * to expand the focus indicator skin outside the bounds of the object.
	 *
	 * <p>The implementation of this property is provided for convenience,
	 * but it cannot be used unless a subclass implements the
	 * <code>IFocusDisplayObject</code> interface.</p>
	 *
	 * <p>The following example gives the focus indicator skin -2 pixels of
	 * padding on the right edge only:</p>
	 *
	 * <listing version="3.0">
	 * control.focusPaddingLeft = -2;</listing>
	 *
	 * @default 0
	 *
	 * @see #style:focusPadding
	 */
	[Style(name="focusPaddingLeft",type="Number")]

	/**
	 * Dispatched after <code>initialize()</code> has been called, but before
	 * the first time that <code>draw()</code> has been called.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.INITIALIZE
	 */
	[Event(name="initialize",type="starling.events.Event")]

	/**
	 * Dispatched after the component has validated for the first time. Both
	 * <code>initialize()</code> and <code>draw()</code> will have been called,
	 * and all children will have been created.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.CREATION_COMPLETE
	 */
	[Event(name="creationComplete",type="starling.events.Event")]

	/**
	 * Dispatched when the width or height of the control changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.RESIZE
	 */
	[Event(name="resize",type="starling.events.Event")]

	/**
	 * Base class for all UI controls. Implements invalidation and sets up some
	 * basic template functions like <code>initialize()</code> and
	 * <code>draw()</code>.
	 *
	 * <p>This is a base class for Feathers components that isn't meant to be
	 * instantiated directly. It should only be subclassed. For a simple
	 * component that will automatically size itself based on its children,
	 * and with optional support for layouts, see <code>LayoutGroup</code>.</p>
	 *
	 * @see feathers.controls.LayoutGroup
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class FeathersControl extends Sprite implements IFeathersControl, ILayoutDisplayObject
	{
		/**
		 * @private
		 */
		private static const HELPER_POINT:Point = new Point();

		/**
		 * Flag to indicate that everything is invalid and should be redrawn.
		 */
		public static const INVALIDATION_FLAG_ALL:String = "all";

		/**
		 * Invalidation flag to indicate that the state has changed. Used by
		 * <code>isEnabled</code>, but may be used for other control states too.
		 *
		 * @see #isEnabled
		 */
		public static const INVALIDATION_FLAG_STATE:String = "state";

		/**
		 * Invalidation flag to indicate that the dimensions of the UI control
		 * have changed.
		 */
		public static const INVALIDATION_FLAG_SIZE:String = "size";

		/**
		 * Invalidation flag to indicate that the styles or visual appearance of
		 * the UI control has changed.
		 */
		public static const INVALIDATION_FLAG_STYLES:String = "styles";

		/**
		 * Invalidation flag to indicate that the skin of the UI control has changed.
		 */
		public static const INVALIDATION_FLAG_SKIN:String = "skin";

		/**
		 * Invalidation flag to indicate that the layout of the UI control has
		 * changed.
		 */
		public static const INVALIDATION_FLAG_LAYOUT:String = "layout";

		/**
		 * Invalidation flag to indicate that the primary data displayed by the
		 * UI control has changed.
		 */
		public static const INVALIDATION_FLAG_DATA:String = "data";

		/**
		 * Invalidation flag to indicate that the scroll position of the UI
		 * control has changed.
		 */
		public static const INVALIDATION_FLAG_SCROLL:String = "scroll";

		/**
		 * Invalidation flag to indicate that the selection of the UI control
		 * has changed.
		 */
		public static const INVALIDATION_FLAG_SELECTED:String = "selected";

		/**
		 * Invalidation flag to indicate that the focus of the UI control has
		 * changed.
		 */
		public static const INVALIDATION_FLAG_FOCUS:String = "focus";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_TEXT_RENDERER:String = "textRenderer";

		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_TEXT_EDITOR:String = "textEditor";

		/**
		 * @private
		 */
		protected static const ILLEGAL_WIDTH_ERROR:String = "A component's width cannot be NaN.";

		/**
		 * @private
		 */
		protected static const ILLEGAL_HEIGHT_ERROR:String = "A component's height cannot be NaN.";

		/**
		 * @private
		 */
		protected static const ABSTRACT_CLASS_ERROR:String = "FeathersControl is an abstract class. For a lightweight Feathers wrapper, use feathers.controls.LayoutGroup.";

		/**
		 * A function used by all UI controls that support text renderers to
		 * create an ITextRenderer instance. You may replace the default
		 * function with your own, if you prefer not to use the
		 * BitmapFontTextRenderer.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function():ITextRenderer</pre>
		 *
		 * @see ../../../help/text-renderers.html Introduction to Feathers text renderers
		 * @see feathers.core.ITextRenderer
		 */
		public static var defaultTextRendererFactory:Function = function():ITextRenderer
		{
			return new BitmapFontTextRenderer();
		};

		/**
		 * A function used by all UI controls that support text editor to
		 * create an <code>ITextEditor</code> instance. You may replace the
		 * default function with your own, if you prefer not to use the
		 * <code>StageTextTextEditor</code>.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function():ITextEditor</pre>
		 *
		 * @see ../../../help/text-editors.html Introduction to Feathers text editors
		 * @see feathers.core.ITextEditor
		 */
		public static var defaultTextEditorFactory:Function = function():ITextEditor
		{
			return new StageTextTextEditor();
		};

		/**
		 * Constructor.
		 */
		public function FeathersControl()
		{
			super();
			if(Object(this).constructor == FeathersControl)
			{
				throw new Error(ABSTRACT_CLASS_ERROR);
			}
			this.styleProvider = this.defaultStyleProvider;
			this.addEventListener(Event.ADDED_TO_STAGE, feathersControl_addedToStageHandler);
			this.addEventListener(Event.REMOVED_FROM_STAGE, feathersControl_removedFromStageHandler);
			if(this is IFocusDisplayObject)
			{
				this.addEventListener(FeathersEventType.FOCUS_IN, focusInHandler);
				this.addEventListener(FeathersEventType.FOCUS_OUT, focusOutHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _showEffectContext:IEffectContext = null;

		/**
		 * @private
		 */
		protected var _showEffect:Function = null;

		/**
		 * An optional effect that is activated when the component is shown.
		 * More specifically, this effect plays when the <code>visible</code>
		 * property is set to <code>true</code>.
		 *
		 * <p>In the following example, a show effect fades the component's
		 * <code>alpha</code> property from <code>0</code> to <code>1</code>:</p>
		 *
		 * <listing version="3.0">
		 * control.showEffect = Fade.createFadeBetweenEffect(0, 1);</listing>
		 *
		 * <p>A number of animated effects may be found in the
		 * <a href="../motion/package-detail.html">feathers.motion</a> package.
		 * However, you are not limited to only these effects. It's possible
		 * to create custom effects too.</p>
		 *
		 * <p>A custom effect function should have the following signature:</p>
		 * <pre>function(target:DisplayObject):IEffectContext</pre>
		 *
		 * <p>The <code>IEffectContext</code> is used by the component to
		 * control the effect, performing actions like playing the effect,
		 * pausing it, or cancelling it.</p>
		 *
		 * <p>Custom animated effects that use
		 * <code>starling.display.Tween</code> typically return a
		 * <code>TweenEffectContext</code>. In the following example, we
		 * recreate the <code>Fade.createFadeBetweenEffect()</code> used in the
		 * previous example.</p>
		 *
		 * <listing version="3.0">
		 * control.showEffect = function(target:DisplayObject):IEffectContext
		 * {
		 *     target.alpha = 0;
		 *     var tween:Tween = new Tween(target, 0.5, Transitions.EASE_OUT);
		 *     tween.fadeTo(1);
		 *     return new TweenEffectContext(target, tween);
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #visible
		 * @see #hideEffect
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 * @see feathers.motion.effectClasses.IEffectContext
		 * @see feathers.motion.effectClasses.TweenEffectContext
		 */
		public function get showEffect():Function
		{
			return this._showEffect;
		}

		/**
		 * @private
		 */
		public function set showEffect(value:Function):void
		{
			this._showEffect = value;
		}

		/**
		 * @private
		 */
		protected var _hideEffectContext:IEffectContext = null;

		/**
		 * @private
		 */
		protected var _hideEffect:Function = null;

		/**
		 * An optional effect that is activated when the component is hidden.
		 * More specifically, this effect plays when the <code>visible</code>
		 * property is set to <code>false</code>.
		 *
		 * <p>In the following example, a hide effect fades the component's
		 * <code>alpha</code> property to <code>0</code>:</p>
		 *
		 * <listing version="3.0">
		 * control.hideEffect = Fade.createFadeOutEffect();</listing>
		 *
		 * <p>A number of animated effects may be found in the
		 * <a href="../motion/package-detail.html">feathers.motion</a> package.
		 * However, you are not limited to only these effects. It's possible
		 * to create custom effects too.</p>
		 *
		 * <p>A custom effect function should have the following signature:</p>
		 * <pre>function(target:DisplayObject):IEffectContext</pre>
		 *
		 * <p>The <code>IEffectContext</code> is used by the component to
		 * control the effect, performing actions like playing the effect,
		 * pausing it, or cancelling it.</p>
		 *
		 * <p>Custom animated effects that use
		 * <code>starling.display.Tween</code> typically return a
		 * <code>TweenEffectContext</code>. In the following example, we
		 * recreate the <code>Fade.createFadeOutEffect()</code> used in the
		 * previous example.</p>
		 *
		 * <listing version="3.0">
		 * control.hideEffect = function(target:DisplayObject):IEffectContext
		 * {
		 *     var tween:Tween = new Tween(target, 0.5, Transitions.EASE_OUT);
		 *     tween.fadeTo(0);
		 *     return new TweenEffectContext(target, tween);
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #visible
		 * @see #showEffect
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 * @see feathers.motion.effectClasses.IEffectContext
		 * @see feathers.motion.effectClasses.TweenEffectContext
		 */
		public function get hideEffect():Function
		{
			return this._hideEffect;
		}

		/**
		 * @private
		 */
		public function set hideEffect(value:Function):void
		{
			this._hideEffect = value;
		}

		/**
		 * @private
		 */
		protected var _pendingVisible:Boolean = true;

		/**
		 * @private
		 */
		override public function set visible(value:Boolean):void
		{
			if(value == this._pendingVisible)
			{
				return;
			}
			this._pendingVisible = value;
			if(this._suspendEffectsCount == 0 && this._hideEffectContext !== null)
			{
				this._hideEffectContext.interrupt();
				this._hideEffectContext = null;
			}
			if(this._suspendEffectsCount == 0 && this._showEffectContext !== null)
			{
				this._showEffectContext.interrupt();
				this._showEffectContext = null;
			}
			if(this._pendingVisible)
			{
				super.visible = this._pendingVisible;
				if(this.isCreated && this._suspendEffectsCount == 0 && this._showEffect !== null && this.stage !== null)
				{
					this._showEffectContext = IEffectContext(this._showEffect(this));
					this._showEffectContext.addEventListener(Event.COMPLETE, showEffectContext_completeHandler);
					this._showEffectContext.play();
				}
			}
			else
			{
				if(!this.isCreated || this._suspendEffectsCount > 0 || this._hideEffect === null || this.stage === null)
				{
					super.visible = this._pendingVisible;
				}
				else
				{
					this._hideEffectContext = IEffectContext(this._hideEffect(this));
					this._hideEffectContext.addEventListener(Event.COMPLETE, hideEffectContext_completeHandler);
					this._hideEffectContext.play();
				}
			}
		}

		/**
		 * @private
		 */
		protected var _focusInEffectContext:IEffectContext = null;

		/**
		 * @private
		 */
		protected var _focusInEffect:Function = null;

		/**
		 * An optional effect that is activated when the component receives
		 * focus.
		 *
		 * <p>The implementation of this property is provided for convenience,
		 * but it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * <p>A number of animated effects may be found in the
		 * <a href="../motion/package-detail.html">feathers.motion</a> package.
		 * However, you are not limited to only these effects. It's possible
		 * to create custom effects too.</p>
		 *
		 * <p>A custom effect function should have the following signature:</p>
		 * <pre>function(target:DisplayObject):IEffectContext</pre>
		 *
		 * <p>The <code>IEffectContext</code> is used by the component to
		 * control the effect, performing actions like playing the effect,
		 * pausing it, or cancelling it.</p>
		 *
		 * <p>Custom animated effects that use
		 * <code>starling.display.Tween</code> typically return a
		 * <code>TweenEffectContext</code>.</p>
		 *
		 * @default null
		 *
		 * @see #focusOutEffect
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 * @see feathers.motion.effectClasses.IEffectContext
		 * @see feathers.motion.effectClasses.TweenEffectContext
		 */
		public function get focusInEffect():Function
		{
			return this._focusInEffect;
		}

		/**
		 * @private
		 */
		public function set focusInEffect(value:Function):void
		{
			this._focusInEffect = value;
		}

		/**
		 * @private
		 */
		protected var _focusOutEffectContext:IEffectContext = null;

		/**
		 * @private
		 */
		protected var _focusOutEffect:Function = null;

		/**
		 * An optional effect that is activated when the component loses focus.
		 *
		 * <p>The implementation of this property is provided for convenience,
		 * but it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * <p>The implementation of this property is provided for convenience,
		 * but it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * <p>A number of animated effects may be found in the
		 * <a href="../motion/package-detail.html">feathers.motion</a> package.
		 * However, you are not limited to only these effects. It's possible
		 * to create custom effects too.</p>
		 *
		 * <p>A custom effect function should have the following signature:</p>
		 * <pre>function(target:DisplayObject):IEffectContext</pre>
		 *
		 * <p>The <code>IEffectContext</code> is used by the component to
		 * control the effect, performing actions like playing the effect,
		 * pausing it, or cancelling it.</p>
		 *
		 * <p>Custom animated effects that use
		 * <code>starling.display.Tween</code> typically return a
		 * <code>TweenEffectContext</code>.</p>
		 *
		 * @default null
		 *
		 * @see #focusInEffect
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 * @see feathers.motion.effectClasses.IEffectContext
		 * @see feathers.motion.effectClasses.TweenEffectContext
		 */
		public function get focusOutEffect():Function
		{
			return this._focusOutEffect;
		}

		/**
		 * @private
		 */
		public function set focusOutEffect(value:Function):void
		{
			this._focusOutEffect = value;
		}

		/**
		 * @private
		 */
		protected var _addedEffectContext:IEffectContext = null;

		/**
		 * @private
		 */
		protected var _addedEffect:Function = null;

		/**
		 * An optional effect that is activated when the component is added to
		 * the stage. Typically used to animate the component's appearance when
		 * it is first displayed.
		 *
		 * <p>In the following example, an added effect fades the component's
		 * <code>alpha</code> property from <code>0</code> to <code>1</code>:</p>
		 *
		 * <listing version="3.0">
		 * control.addedEffect = Fade.createFadeBetweenEffect(0, 1);</listing>
		 *
		 * <p>A number of animated effects may be found in the
		 * <a href="../motion/package-detail.html">feathers.motion</a> package.
		 * However, you are not limited to only these effects. It's possible
		 * to create custom effects too.</p>
		 *
		 * <p>A custom effect function should have the following signature:</p>
		 * <pre>function(target:DisplayObject):IEffectContext</pre>
		 *
		 * <p>The <code>IEffectContext</code> is used by the component to
		 * control the effect, performing actions like playing the effect,
		 * pausing it, or cancelling it.</p>
		 *
		 * <p>Custom animated effects that use
		 * <code>starling.display.Tween</code> typically return a
		 * <code>TweenEffectContext</code>. In the following example, we
		 * recreate the <code>Fade.createFadeBetweenEffect()</code> used in the
		 * previous example.</p>
		 *
		 * <listing version="3.0">
		 * control.addedEffect = function(target:DisplayObject):IEffectContext
		 * {
		 *     target.alpha = 0;
		 *     var tween:Tween = new Tween(target, 0.5, Transitions.EASE_OUT);
		 *     tween.fadeTo(1);
		 *     return new TweenEffectContext(target, tween);
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see #removeFromParentWithEffect()
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 * @see feathers.motion.effectClasses.IEffectContext
		 * @see feathers.motion.effectClasses.TweenEffectContext
		 */
		public function get addedEffect():Function
		{
			return this._addedEffect;
		}

		/**
		 * @private
		 */
		public function set addedEffect(value:Function):void
		{
			this._addedEffect = value;
		}

		/**
		 * @private
		 */
		protected var _removedEffectContext:IEffectContext = null;

		/**
		 * @private
		 */
		protected var _disposeAfterRemovedEffect:Boolean = false;

		/**
		 * @private
		 */
		protected var _validationQueue:ValidationQueue;

		/**
		 * The concatenated <code>styleNameList</code>, with values separated
		 * by spaces. Style names are somewhat similar to classes in CSS
		 * selectors. In Feathers, they are a non-unique identifier that can
		 * differentiate multiple styles of the same type of UI control. A
		 * single control may have many style names, and many controls can share
		 * a single style name. A <a target="_top" href="../../../help/themes.html">theme</a>
		 * or another skinning mechanism may use style names to provide a
		 * variety of visual appearances for a single component class.
		 *
		 * <p>In general, the <code>styleName</code> property should not be set
		 * directly on a Feathers component. You should add and remove style
		 * names from the <code>styleNameList</code> property instead.</p>
		 *
		 * @default ""
		 *
		 * @see #styleNameList
		 * @see ../../../help/themes.html Introduction the Feathers themes
		 * @see ../../../help/custom-themes.html Creating custom Feathers themes
		 */
		public function get styleName():String
		{
			return this._styleNameList.value;
		}

		/**
		 * @private
		 */
		public function set styleName(value:String):void
		{
			this._styleNameList.value = value;
		}

		/**
		 * @private
		 */
		protected var _styleNameList:TokenList = new TokenList();

		/**
		 * Contains a list of all "styles" assigned to this control. Names are
		 * like classes in CSS selectors. They are a non-unique identifier that
		 * can differentiate multiple styles of the same type of UI control. A
		 * single control may have many names, and many controls can share a
		 * single name. A <a target="_top" href="../../../help/themes.html">theme</a>
		 * or another skinning mechanism may use style names to provide a
		 * variety of visual appearances for a single component class.
		 *
		 * <p>Names may be added, removed, or toggled on the
		 * <code>styleNameList</code>. Names cannot contain spaces.</p>
		 *
		 * <p>In the following example, a name is added to the name list:</p>
		 *
		 * <listing version="3.0">
		 * control.styleNameList.add( "custom-component-name" );</listing>
		 *
		 * @see #styleName
		 * @see ../../../help/themes.html Introduction to Feathers themes
		 * @see ../../../help/custom-themes.html Creating custom Feathers themes
		 */
		public function get styleNameList():TokenList
		{
			return this._styleNameList;
		}

		/**
		 * @private
		 */
		protected var _styleProvider:IStyleProvider;

		/**
		 * When a component initializes, a style provider may be used to set
		 * properties that affect the component's visual appearance.
		 *
		 * <p>You can set or replace an existing style provider at any time
		 * before a component initializes without immediately affecting the
		 * component's visual appearance. After the component initializes, the
		 * style provider may still be changed, but any properties that
		 * were set by the previous style provider will not be reset to their
		 * default values.</p>
		 *
		 * @see #styleName
		 * @see #styleNameList
		 * @see ../../../help/themes.html Introduction to Feathers themes
		 */
		public function get styleProvider():IStyleProvider
		{
			return this._styleProvider;
		}

		/**
		 * @private
		 */
		public function set styleProvider(value:IStyleProvider):void
		{
			if(this._styleProvider === value)
			{
				return;
			}
			if(this._applyingStyles)
			{
				throw new IllegalOperationError("Cannot change styleProvider while the current style provider is applying styles.");
			}
			if(this._styleProvider !== null && this._styleProvider is EventDispatcher)
			{
				EventDispatcher(this._styleProvider).removeEventListener(Event.CHANGE, styleProvider_changeHandler);
			}
			this._styleProvider = value;
			if(this._styleProvider !== null)
			{
				if(this.isInitialized)
				{
					this._applyingStyles = true;
					this._styleProvider.applyStyles(this);
					this._applyingStyles = false;
				}
				if(this._styleProvider is EventDispatcher)
				{
					EventDispatcher(this._styleProvider).addEventListener(Event.CHANGE, styleProvider_changeHandler);
				}
			}
		}

		/**
		 * When the <code>FeathersControl</code> constructor is called, the
		 * <code>styleProvider</code> property is set to this value. May be
		 * <code>null</code>.
		 *
		 * <p>Typically, a subclass of <code>FeathersControl</code> will
		 * override this function to return its static <code>globalStyleProvider</code>
		 * value. For instance, <code>feathers.controls.Button</code> overrides
		 * this function, and its implementation looks like this:</p>
		 *
		 * <listing version="3.0">
		 * override protected function get defaultStyleProvider():IStyleProvider
		 * {
		 *     return Button.globalStyleProvider;
		 * }</listing>
		 *
		 * @see #styleProvider
		 */
		protected function get defaultStyleProvider():IStyleProvider
		{
			return null;
		}

		/**
		 * @private
		 */
		protected var _isQuickHitAreaEnabled:Boolean = false;

		/**
		 * Similar to <code>mouseChildren</code> on the classic display list. If
		 * <code>true</code>, children cannot dispatch touch events, but hit
		 * tests will be much faster. Easier than overriding
		 * <code>hitTest()</code>.
		 *
		 * <p>In the following example, the quick hit area is enabled:</p>
		 *
		 * <listing version="3.0">
		 * control.isQuickHitAreaEnabled = true;</listing>
		 *
		 * @default false
		 */
		public function get isQuickHitAreaEnabled():Boolean
		{
			return this._isQuickHitAreaEnabled;
		}

		/**
		 * @private
		 */
		public function set isQuickHitAreaEnabled(value:Boolean):void
		{
			this._isQuickHitAreaEnabled = value;
		}

		/**
		 * @private
		 */
		protected var _hitArea:Rectangle = new Rectangle();

		/**
		 * @private
		 */
		protected var _isInitializing:Boolean = false;

		/**
		 * @private
		 */
		protected var _isInitialized:Boolean = false;

		/**
		 * Determines if the component has been initialized yet. The
		 * <code>initialize()</code> function is called one time only, when the
		 * Feathers UI control is added to the display list for the first time.
		 *
		 * <p>In the following example, we check if the component is initialized
		 * or not, and we listen for an event if it isn't:</p>
		 *
		 * <listing version="3.0">
		 * if( !control.isInitialized )
		 * {
		 *     control.addEventListener( FeathersEventType.INITIALIZE, initializeHandler );
		 * }</listing>
		 *
		 * @see #event:initialize
		 * @see #isCreated
		 */
		public function get isInitialized():Boolean
		{
			return this._isInitialized;
		}

		/**
		 * @private
		 */
		protected var _applyingStyles:Boolean = false;

		/**
		 * @private
		 */
		protected var _restrictedStyles:Dictionary;

		/**
		 * @private
		 * A flag that indicates that everything is invalid. If true, no other
		 * flags will need to be tracked.
		 */
		protected var _isAllInvalid:Boolean = false;

		/**
		 * @private
		 */
		protected var _invalidationFlags:Object = {};

		/**
		 * @private
		 */
		protected var _delayedInvalidationFlags:Object = {};

		/**
		 * @private
		 */
		protected var _isEnabled:Boolean = true;

		/**
		 * Indicates whether the control is interactive or not.
		 *
		 * <p>In the following example, the control is disabled:</p>
		 *
		 * <listing version="3.0">
		 * control.isEnabled = false;</listing>
		 *
		 * @default true
		 */
		public function get isEnabled():Boolean
		{
			return _isEnabled;
		}

		/**
		 * @private
		 */
		public function set isEnabled(value:Boolean):void
		{
			if(this._isEnabled == value)
			{
				return;
			}
			this._isEnabled = value;
			this.invalidate(INVALIDATION_FLAG_STATE);
		}

		/**
		 * @private
		 */
		protected var _explicitWidth:Number = NaN;

		/**
		 * The width value explicitly set by passing a value to the
		 * <code>width</code> setter or to the <code>setSize()</code> method.
		 */
		public function get explicitWidth():Number
		{
			return this._explicitWidth;
		}

		/**
		 * @private
		 */
		protected var _resizeEffectContext:IEffectContext = null;

		/**
		 * @private
		 */
		protected var _resizeEffect:Function = null;

		/**
		 * An optional effect that is activated when the component is resized
		 * with new dimensions. More specifically, this effect plays when the
		 * <code>width</code> or <code>height</code> property changes.
		 *
		 * <p>In the following example, a resize effect will animate the new
		 * dimensions of the component when it resizes:</p>
		 *
		 * <listing version="3.0">
		 * control.resizeEffect = Resize.createResizeEffect();</listing>
		 *
		 * <p>A custom effect function should have the following signature:</p>
		 * <pre>function(target:DisplayObject):IResizeEffectContext</pre>
		 *
		 * <p>The <code>IResizeEffectContext</code> is used by the component to
		 * control the effect, performing actions like playing the effect,
		 * pausing it, or cancelling it. Custom animated resize effects that use
		 * <code>starling.display.Tween</code> typically return a
		 * <code>TweenResizeEffectContext</code>.</p>
		 *
		 * @see feathers.motion.Resize
		 * @see #width
		 * @see #height
		 * @see #setSize()
		 */
		public function get resizeEffect():Function
		{
			return this._resizeEffect;
		}

		/**
		 * @private
		 */
		public function set resizeEffect(value:Function):void
		{
			this._resizeEffect = value;
		}

		/**
		 * @private
		 */
		protected var _moveEffectContext:IEffectContext = null;

		/**
		 * @private
		 */
		protected var _moveEffect:Function = null;

		/**
		 * An optional effect that is activated when the component is moved to
		 * a new position. More specifically, this effect plays when the
		 * <code>x</code> or <code>y</code> property changes.
		 *
		 * <p>In the following example, a move effect will animate the new
		 * position of the component when it moves:</p>
		 *
		 * <listing version="3.0">
		 * control.moveEffect = Move.createMoveEffect();</listing>
		 *
		 * <p>A custom effect function should have the following signature:</p>
		 * <pre>function(target:DisplayObject):IMoveEffectContext</pre>
		 *
		 * <p>The <code>IMoveEffectContext</code> is used by the component to
		 * control the effect, performing actions like playing the effect,
		 * pausing it, or cancelling it. Custom animated move effects that use
		 * <code>starling.display.Tween</code> typically return a
		 * <code>TweenMoveEffectContext</code>.</p>
		 *
		 * @default null
		 *
		 * @see feathers.motion.Move
		 * @see #x
		 * @see #y
		 * @see #move()
		 */
		public function get moveEffect():Function
		{
			return this._moveEffect;
		}

		/**
		 * @private
		 */
		public function set moveEffect(value:Function):void
		{
			this._moveEffect = value;
		}

		/**
		 * @private
		 */
		override public function set x(value:Number):void
		{
			var newY:Number = this.y;
			if(this._suspendEffectsCount == 0 && this._moveEffectContext !== null)
			{
				if(this._moveEffectContext is IMoveEffectContext)
				{
					var moveEffectContext:IMoveEffectContext = IMoveEffectContext(this._moveEffectContext);
					newY = moveEffectContext.newY;
				}
				this._moveEffectContext.interrupt();
				this._moveEffectContext = null;
			}
			if(this.isCreated && this._suspendEffectsCount == 0 && this._moveEffect !== null)
			{
				this._moveEffectContext = IEffectContext(this._moveEffect(this));
				this._moveEffectContext.addEventListener(Event.COMPLETE, moveEffectContext_completeHandler);
				if(this._moveEffectContext is IMoveEffectContext)
				{
					moveEffectContext = IMoveEffectContext(this._moveEffectContext);
					moveEffectContext.oldX = this.x;
					moveEffectContext.oldY = this.y;
					moveEffectContext.newX = value;
					moveEffectContext.newY = newY;
				}
				else
				{
					super.x = value;
				}
				this._moveEffectContext.play();
			}
			else
			{
				super.x = value;
			}
		}

		/**
		 * @private
		 */
		override public function set y(value:Number):void
		{
			var newX:Number = this.x;
			if(this._suspendEffectsCount == 0 && this._moveEffectContext !== null)
			{
				if(this._moveEffectContext is IMoveEffectContext)
				{
					var moveEffectContext:IMoveEffectContext = IMoveEffectContext(this._moveEffectContext);
					newX = moveEffectContext.newX;
				}
				this._moveEffectContext.interrupt();
				this._moveEffectContext = null;
			}
			if(this.isCreated && this._suspendEffectsCount == 0 && this._moveEffect !== null)
			{
				this._moveEffectContext = IEffectContext(this._moveEffect(this));
				this._moveEffectContext.addEventListener(Event.COMPLETE, moveEffectContext_completeHandler);
				if(this._moveEffectContext is IMoveEffectContext)
				{
					moveEffectContext = IMoveEffectContext(this._moveEffectContext);
					moveEffectContext.oldX = this.x;
					moveEffectContext.oldY = this.y;
					moveEffectContext.newX = newX;
					moveEffectContext.newY = value;
				}
				else
				{
					super.y = value;
				}
				this._moveEffectContext.play();
			}
			else
			{
				super.y = value;
			}
		}

		/**
		 * The final width value that should be used for layout. If the width
		 * has been explicitly set, then that value is used. If not, the actual
		 * width will be calculated automatically. Each component has different
		 * automatic sizing behavior, but it's usually based on the component's
		 * skin or content, including text or subcomponents.
		 */
		protected var actualWidth:Number = 0;

		/**
		 * @private
		 * The <code>actualWidth</code> value that accounts for
		 * <code>scaleX</code>. Not intended to be used for layout since layout
		 * uses unscaled values. This is the value exposed externally through
		 * the <code>width</code> getter.
		 */
		protected var scaledActualWidth:Number = 0;

		/**
		 * The width of the component, in pixels. This could be a value that was
		 * set explicitly, or the component will automatically resize if no
		 * explicit width value is provided. Each component has a different
		 * automatic sizing behavior, but it's usually based on the component's
		 * skin or content, including text or subcomponents.
		 *
		 * <p><strong>Note:</strong> Values of the <code>width</code> and
		 * <code>height</code> properties may not be accurate until after
		 * validation. If you are seeing <code>width</code> or <code>height</code>
		 * values of <code>0</code>, but you can see something on the screen and
		 * know that the value should be larger, it may be because you asked for
		 * the dimensions before the component had validated. Call
		 * <code>validate()</code> to tell the component to immediately redraw
		 * and calculate an accurate values for the dimensions.</p>
		 *
		 * <p>In the following example, the width is set to 120 pixels:</p>
		 *
		 * <listing version="3.0">
		 * control.width = 120;</listing>
		 *
		 * <p>In the following example, the width is cleared so that the
		 * component can automatically measure its own width:</p>
		 *
		 * <listing version="3.0">
		 * control.width = NaN;</listing>
		 *
		 * @see feathers.core.FeathersControl#setSize()
		 * @see feathers.core.FeathersControl#validate()
		 */
		override public function get width():Number
		{
			return this.scaledActualWidth;
		}

		/**
		 * @private
		 */
		override public function set width(value:Number):void
		{
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitWidth !== this._explicitWidth) //isNaN
			{
				return;
			}
			if(this.scaleX != 1)
			{
				value /= this.scaleX;
			}
			if(this._explicitWidth == value)
			{
				return;
			}
			var hasSetExplicitWidth:Boolean = false;
			var newHeight:Number = this.actualHeight;
			if(this._suspendEffectsCount == 0 && this._resizeEffectContext !== null)
			{
				if(this._resizeEffectContext is IResizeEffectContext)
				{
					var resizeEffectContext:IResizeEffectContext = IResizeEffectContext(this._resizeEffectContext);
					newHeight = resizeEffectContext.newHeight;
				}
				this._resizeEffectContext.interrupt();
				this._resizeEffectContext = null;
			}
			if(!valueIsNaN && this.isCreated && this._suspendEffectsCount == 0 && this._resizeEffect !== null)
			{
				this._resizeEffectContext = IEffectContext(this._resizeEffect(this));
				this._resizeEffectContext.addEventListener(Event.COMPLETE, resizeEffectContext_completeHandler);
				if(this._resizeEffectContext is IResizeEffectContext)
				{
					resizeEffectContext = IResizeEffectContext(this._resizeEffectContext);
					resizeEffectContext.oldWidth = this.actualWidth;
					resizeEffectContext.oldHeight = this.actualHeight;
					resizeEffectContext.newWidth = value;
					resizeEffectContext.newHeight = newHeight;
				}
				else
				{
					this._explicitWidth = value;
					hasSetExplicitWidth = true;
				}
				this._resizeEffectContext.play();
			}
			else
			{
				this._explicitWidth = value;
				hasSetExplicitWidth = true;
			}
			if(hasSetExplicitWidth)
			{
				if(valueIsNaN)
				{
					this.actualWidth = this.scaledActualWidth = 0;
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
				else
				{
					var result:Boolean = this.saveMeasurements(value, this.actualHeight, this.actualMinWidth, this.actualMinHeight);
					if(result)
					{
						this.invalidate(INVALIDATION_FLAG_SIZE);
					}
				}
			}
		}

		/**
		 * @private
		 */
		protected var _explicitHeight:Number = NaN;

		/**
		 * The height value explicitly set by passing a value to the
		 * <code>height</code> setter or by calling the <code>setSize()</code>
		 * function.
		 */
		public function get explicitHeight():Number
		{
			return this._explicitHeight;
		}

		/**
		 * The final height value that should be used for layout. If the height
		 * has been explicitly set, then that value is used. If not, the actual
		 * height will be calculated automatically. Each component has different
		 * automatic sizing behavior, but it's usually based on the component's
		 * skin or content, including text or subcomponents.
		 */
		protected var actualHeight:Number = 0;

		/**
		 * @private
		 * The <code>actualHeight</code> value that accounts for
		 * <code>scaleY</code>. Not intended to be used for layout since layout
		 * uses unscaled values. This is the value exposed externally through
		 * the <code>height</code> getter.
		 */
		protected var scaledActualHeight:Number = 0;

		/**
		 * The height of the component, in pixels. This could be a value that
		 * was set explicitly, or the component will automatically resize if no
		 * explicit height value is provided. Each component has a different
		 * automatic sizing behavior, but it's usually based on the component's
		 * skin or content, including text or subcomponents.
		 *
		 * <p><strong>Note:</strong> Values of the <code>width</code> and
		 * <code>height</code> properties may not be accurate until after
		 * validation. If you are seeing <code>width</code> or <code>height</code>
		 * values of <code>0</code>, but you can see something on the screen and
		 * know that the value should be larger, it may be because you asked for
		 * the dimensions before the component had validated. Call
		 * <code>validate()</code> to tell the component to immediately redraw
		 * and calculate an accurate values for the dimensions.</p>
		 *
		 * <p>In the following example, the height is set to 120 pixels:</p>
		 *
		 * <listing version="3.0">
		 * control.height = 120;</listing>
		 *
		 * <p>In the following example, the height is cleared so that the
		 * component can automatically measure its own height:</p>
		 *
		 * <listing version="3.0">
		 * control.height = NaN;</listing>
		 *
		 * @see feathers.core.FeathersControl#setSize()
		 * @see feathers.core.FeathersControl#validate()
		 */
		override public function get height():Number
		{
			return this.scaledActualHeight;
		}

		/**
		 * @private
		 */
		override public function set height(value:Number):void
		{
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitHeight !== this._explicitHeight) //isNaN
			{
				return;
			}
			if(this.scaleY != 1)
			{
				value /= this.scaleY;
			}
			if(this._explicitHeight == value)
			{
				return;
			}
			var hasSetExplicitHeight:Boolean = false;
			var newWidth:Number = this.actualWidth;
			if(this._suspendEffectsCount == 0 && this._resizeEffectContext !== null)
			{
				if(this._resizeEffectContext is IResizeEffectContext)
				{
					var resizeEffectContext:IResizeEffectContext = IResizeEffectContext(this._resizeEffectContext);
					newWidth = resizeEffectContext.newWidth;
				}
				this._resizeEffectContext.interrupt();
				this._resizeEffectContext = null;
			}
			if(!valueIsNaN && this.isCreated && this._suspendEffectsCount == 0 && this._resizeEffect !== null)
			{
				this._resizeEffectContext = IEffectContext(this._resizeEffect(this));
				this._resizeEffectContext.addEventListener(Event.COMPLETE, resizeEffectContext_completeHandler);
				if(this._resizeEffectContext is IResizeEffectContext)
				{
					resizeEffectContext = IResizeEffectContext(this._resizeEffectContext);
					resizeEffectContext.oldWidth = this.actualWidth;
					resizeEffectContext.oldHeight = this.actualHeight;
					resizeEffectContext.newWidth = newWidth;
					resizeEffectContext.newHeight = value;
				}
				else
				{
					this._explicitHeight = value;
					hasSetExplicitHeight = true;
				}
				this._resizeEffectContext.play();
			}
			else
			{
				this._explicitHeight = value;
				hasSetExplicitHeight = true;
			}
			if(hasSetExplicitHeight)
			{
				if(valueIsNaN)
				{
					this.actualHeight = this.scaledActualHeight = 0;
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
				else
				{
					var result:Boolean = this.saveMeasurements(this.actualWidth, value, this.actualMinWidth, this.actualMinHeight);
					if(result)
					{
						this.invalidate(INVALIDATION_FLAG_SIZE);
					}
				}
			}
		}

		/**
		 * @private
		 */
		protected var _minTouchWidth:Number = 0;

		/**
		 * If using <code>isQuickHitAreaEnabled</code>, and the hit area's
		 * width is smaller than this value, it will be expanded.
		 *
		 * <p>In the following example, the minimum width of the hit area is
		 * set to 120 pixels:</p>
		 *
		 * <listing version="3.0">
		 * control.minTouchWidth = 120;</listing>
		 *
		 * @default 0
		 */
		public function get minTouchWidth():Number
		{
			return this._minTouchWidth;
		}

		/**
		 * @private
		 */
		public function set minTouchWidth(value:Number):void
		{
			if(this._minTouchWidth == value)
			{
				return;
			}
			this._minTouchWidth = value;
			this.refreshHitAreaX();
		}

		/**
		 * @private
		 */
		protected var _minTouchHeight:Number = 0;

		/**
		 * If using <code>isQuickHitAreaEnabled</code>, and the hit area's
		 * height is smaller than this value, it will be expanded.
		 *
		 * <p>In the following example, the minimum height of the hit area is
		 * set to 120 pixels:</p>
		 *
		 * <listing version="3.0">
		 * control.minTouchHeight = 120;</listing>
		 *
		 * @default 0
		 */
		public function get minTouchHeight():Number
		{
			return this._minTouchHeight;
		}

		/**
		 * @private
		 */
		public function set minTouchHeight(value:Number):void
		{
			if(this._minTouchHeight == value)
			{
				return;
			}
			this._minTouchHeight = value;
			this.refreshHitAreaY();
		}

		/**
		 * @private
		 */
		protected var _explicitMinWidth:Number = NaN;

		/**
		 * The minimum width value explicitly set by passing a value to the
		 * <code>minWidth</code> setter.
		 *
		 * <p>If no value has been passed to the <code>minWidth</code> setter,
		 * this property returns <code>NaN</code>.</p>
		 */
		public function get explicitMinWidth():Number
		{
			return this._explicitMinWidth;
		}

		/**
		 * The final minimum width value that should be used for layout. If the
		 * minimum width has been explicitly set, then that value is used. If
		 * not, the actual minimum width will be calculated automatically. Each
		 * component has different automatic sizing behavior, but it's usually
		 * based on the component's skin or content, including text or
		 * subcomponents.
		 */
		protected var actualMinWidth:Number = 0;

		/**
		 * @private
		 * The <code>actualMinWidth</code> value that accounts for
		 * <code>scaleX</code>. Not intended to be used for layout since layout
		 * uses unscaled values. This is the value exposed externally through
		 * the <code>minWidth</code> getter.
		 */
		protected var scaledActualMinWidth:Number = 0;

		/**
		 * The minimum recommended width to be used for self-measurement and,
		 * optionally, by any code that is resizing this component. This value
		 * is not strictly enforced in all cases. An explicit width value that
		 * is smaller than <code>minWidth</code> may be set and will not be
		 * affected by the minimum.
		 *
		 * <p>In the following example, the minimum width of the control is
		 * set to 120 pixels:</p>
		 *
		 * <listing version="3.0">
		 * control.minWidth = 120;</listing>
		 *
		 * @default 0
		 */
		public function get minWidth():Number
		{
			return this.scaledActualMinWidth;
		}

		/**
		 * @private
		 */
		public function set minWidth(value:Number):void
		{
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinWidth !== this._explicitMinWidth) //isNaN
			{
				return;
			}
			if(this.scaleX != 1)
			{
				value /= this.scaleX;
			}
			if(this._explicitMinWidth == value)
			{
				return;
			}
			var oldValue:Number = this._explicitMinWidth;
			this._explicitMinWidth = value;
			if(valueIsNaN)
			{
				this.actualMinWidth = this.scaledActualMinWidth = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				//saveMeasurements() might change actualWidth, so keep the old
				//value for the comparisons below
				var actualWidth:Number = this.actualWidth;
				this.saveMeasurements(actualWidth, this.actualHeight, value, this.actualMinHeight);
				if(this._explicitWidth !== this._explicitWidth && //isNaN
					(actualWidth < value || actualWidth == oldValue))
				{
					//only invalidate if this change might affect the width
					//because everything else was handled in saveMeasurements()
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		/**
		 * @private
		 */
		protected var _explicitMinHeight:Number = NaN;

		/**
		 * The minimum height value explicitly set by passing a value to the
		 * <code>minHeight</code> setter.
		 *
		 * <p>If no value has been passed to the <code>minHeight</code> setter,
		 * this property returns <code>NaN</code>.</p>
		 */
		public function get explicitMinHeight():Number
		{
			return this._explicitMinHeight;
		}

		/**
		 * The final minimum height value that should be used for layout. If the
		 * minimum height has been explicitly set, then that value is used. If
		 * not, the actual minimum height will be calculated automatically. Each
		 * component has different automatic sizing behavior, but it's usually
		 * based on the component's skin or content, including text or
		 * subcomponents.
		 */
		protected var actualMinHeight:Number = 0;

		/**
		 * @private
		 * The <code>actuaMinHeight</code> value that accounts for
		 * <code>scaleY</code>. Not intended to be used for layout since layout
		 * uses unscaled values. This is the value exposed externally through
		 * the <code>minHeight</code> getter.
		 */
		protected var scaledActualMinHeight:Number = 0;

		/**
		 * The minimum recommended height to be used for self-measurement and,
		 * optionally, by any code that is resizing this component. This value
		 * is not strictly enforced in all cases. An explicit height value that
		 * is smaller than <code>minHeight</code> may be set and will not be
		 * affected by the minimum.
		 *
		 * <p>In the following example, the minimum height of the control is
		 * set to 120 pixels:</p>
		 *
		 * <listing version="3.0">
		 * control.minHeight = 120;</listing>
		 *
		 * @default 0
		 */
		public function get minHeight():Number
		{
			return this.scaledActualMinHeight;
		}

		/**
		 * @private
		 */
		public function set minHeight(value:Number):void
		{
			var valueIsNaN:Boolean = value !== value; //isNaN
			if(valueIsNaN &&
				this._explicitMinHeight !== this._explicitMinHeight) //isNaN
			{
				return;
			}
			if(this.scaleY != 1)
			{
				value /= this.scaleY;
			}
			if(this._explicitMinHeight == value)
			{
				return;
			}
			var oldValue:Number = this._explicitMinHeight;
			this._explicitMinHeight = value;
			if(valueIsNaN)
			{
				this.actualMinHeight = this.scaledActualMinHeight = 0;
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			else
			{
				//saveMeasurements() might change actualHeight, so keep the old
				//value for the comparisons below
				var actualHeight:Number = this.actualHeight;
				this.saveMeasurements(this.actualWidth, actualHeight, this.actualMinWidth, value);
				if(this._explicitHeight !== this._explicitHeight && //isNaN
					(actualHeight < value || actualHeight == oldValue))
				{
					//only invalidate if this change might affect the height
					//because everything else was handled in saveMeasurements()
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
			}
		}

		/**
		 * @private
		 */
		protected var _explicitMaxWidth:Number = Number.POSITIVE_INFINITY;

		/**
		 * The maximum width value explicitly set by passing a value to the
		 * <code>maxWidth</code> setter.
		 *
		 * <p>If no value has been passed to the <code>maxWidth</code> setter,
		 * this property returns <code>NaN</code>.</p>
		 */
		public function get explicitMaxWidth():Number
		{
			return this._explicitMaxWidth;
		}

		/**
		 * The maximum recommended width to be used for self-measurement and,
		 * optionally, by any code that is resizing this component. This value
		 * is not strictly enforced in all cases. An explicit width value that
		 * is larger than <code>maxWidth</code> may be set and will not be
		 * affected by the maximum.
		 *
		 * <p>In the following example, the maximum width of the control is
		 * set to 120 pixels:</p>
		 *
		 * <listing version="3.0">
		 * control.maxWidth = 120;</listing>
		 *
		 * @default Number.POSITIVE_INFINITY
		 */
		public function get maxWidth():Number
		{
			return this._explicitMaxWidth;
		}

		/**
		 * @private
		 */
		public function set maxWidth(value:Number):void
		{
			if(value < 0)
			{
				value = 0;
			}
			if(this._explicitMaxWidth == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxWidth cannot be NaN");
			}
			var oldValue:Number = this._explicitMaxWidth;
			this._explicitMaxWidth = value;
			if(this._explicitWidth !== this._explicitWidth && //isNaN
				(this.actualWidth > value || this.actualWidth == oldValue))
			{
				//only invalidate if this change might affect the width
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		/**
		 * @private
		 */
		protected var _explicitMaxHeight:Number = Number.POSITIVE_INFINITY;

		/**
		 * The maximum height value explicitly set by passing a value to the
		 * <code>maxHeight</code> setter.
		 *
		 * <p>If no value has been passed to the <code>maxHeight</code> setter,
		 * this property returns <code>NaN</code>.</p>
		 */
		public function get explicitMaxHeight():Number
		{
			return this._explicitMaxHeight;
		}

		/**
		 * The maximum recommended height to be used for self-measurement and,
		 * optionally, by any code that is resizing this component. This value
		 * is not strictly enforced in all cases. An explicit height value that
		 * is larger than <code>maxHeight</code> may be set and will not be
		 * affected by the maximum.
		 *
		 * <p>In the following example, the maximum width of the control is
		 * set to 120 pixels:</p>
		 *
		 * <listing version="3.0">
		 * control.maxWidth = 120;</listing>
		 *
		 * @default Number.POSITIVE_INFINITY
		 */
		public function get maxHeight():Number
		{
			return this._explicitMaxHeight;
		}

		/**
		 * @private
		 */
		public function set maxHeight(value:Number):void
		{
			if(value < 0)
			{
				value = 0;
			}
			if(this._explicitMaxHeight == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxHeight cannot be NaN");
			}
			var oldValue:Number = this._explicitMaxHeight;
			this._explicitMaxHeight = value;
			if(this._explicitHeight !== this._explicitHeight && //isNaN
				(this.actualHeight > value || this.actualHeight == oldValue))
			{
				//only invalidate if this change might affect the width
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
		}

		/**
		 * @private
		 */
		override public function set scaleX(value:Number):void
		{
			super.scaleX = value;
			this.saveMeasurements(this.actualWidth, this.actualHeight, this.actualMinWidth, this.actualMinHeight);
		}

		/**
		 * @private
		 */
		override public function set scaleY(value:Number):void
		{
			super.scaleY = value;
			this.saveMeasurements(this.actualWidth, this.actualHeight, this.actualMinWidth, this.actualMinHeight);
		}

		/**
		 * @private
		 */
		protected var _includeInLayout:Boolean = true;

		/**
		 * @inheritDoc
		 *
		 * @default true
		 */
		public function get includeInLayout():Boolean
		{
			return this._includeInLayout;
		}

		/**
		 * @private
		 */
		public function set includeInLayout(value:Boolean):void
		{
			if(this._includeInLayout == value)
			{
				return;
			}
			this._includeInLayout = value;
			this.dispatchEventWith(FeathersEventType.LAYOUT_DATA_CHANGE);
		}

		/**
		 * @private
		 */
		protected var _layoutData:ILayoutData;

		/**
		 * @inheritDoc
		 *
		 * @default null
		 */
		public function get layoutData():ILayoutData
		{
			return this._layoutData;
		}

		/**
		 * @private
		 */
		public function set layoutData(value:ILayoutData):void
		{
			if(this._layoutData == value)
			{
				return;
			}
			if(this._layoutData)
			{
				this._layoutData.removeEventListener(Event.CHANGE, layoutData_changeHandler);
			}
			this._layoutData = value;
			if(this._layoutData)
			{
				this._layoutData.addEventListener(Event.CHANGE, layoutData_changeHandler);
			}
			this.dispatchEventWith(FeathersEventType.LAYOUT_DATA_CHANGE);
		}

		/**
		 * @private
		 */
		protected var _toolTip:String;

		/**
		 * Text to display in a tool tip to when hovering over this component,
		 * if the <code>ToolTipManager</code> is enabled.
		 *
		 * @default null
		 *
		 * @see ../../../help/tool-tips.html Tool tips in Feathers
		 * @see feathers.core.ToolTipManager
		 */
		public function get toolTip():String
		{
			return this._toolTip;
		}

		/**
		 * @private
		 */
		public function set toolTip(value:String):void
		{
			this._toolTip = value;
		}

		/**
		 * @private
		 */
		protected var _focusManager:IFocusManager;

		/**
		 * <p>The implementation of this property is provided for convenience,
		 * but it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * @copy feathers.core.IFocusDisplayObject#focusManager
		 *
		 * @default null
		 *
		 * @see feathers.core.IFocusDisplayObject
		 */
		public function get focusManager():IFocusManager
		{
			return this._focusManager;
		}

		/**
		 * @private
		 */
		public function set focusManager(value:IFocusManager):void
		{
			if(!(this is IFocusDisplayObject))
			{
				throw new IllegalOperationError("Cannot pass a focus manager to a component that does not implement feathers.core.IFocusDisplayObject");
			}
			if(this._focusManager == value)
			{
				return;
			}
			this._focusManager = value;
		}

		/**
		 * @private
		 */
		protected var _focusOwner:IFocusDisplayObject;

		/**
		 * <p>The implementation of this property is provided for convenience,
		 * but it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * @copy feathers.core.IFocusDisplayObject#focusOwner
		 *
		 * @default null
		 *
		 * @see feathers.core.IFocusDisplayObject
		 */
		public function get focusOwner():IFocusDisplayObject
		{
			return this._focusOwner;
		}

		/**
		 * @private
		 */
		public function set focusOwner(value:IFocusDisplayObject):void
		{
			this._focusOwner = value;
		}

		/**
		 * @private
		 */
		protected var _isFocusEnabled:Boolean = true;

		/**
		 * <p>The implementation of this property is provided for convenience,
		 * but it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * @copy feathers.core.IFocusDisplayObject#isFocusEnabled
		 *
		 * @default true
		 *
		 * @see feathers.core.IFocusDisplayObject
		 */
		public function get isFocusEnabled():Boolean
		{
			return this._isEnabled && this._isFocusEnabled;
		}

		/**
		 * @private
		 */
		public function set isFocusEnabled(value:Boolean):void
		{
			if(!(this is IFocusDisplayObject))
			{
				throw new IllegalOperationError("Cannot enable focus on a component that does not implement feathers.core.IFocusDisplayObject");
			}
			if(this._isFocusEnabled == value)
			{
				return;
			}
			this._isFocusEnabled = value;
		}

		/**
		 * <p>The implementation of this method is provided for convenience, but
		 * it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * @copy feathers.core.IFocusDisplayObject#isShowingFocus
		 *
		 * @see feathers.core.IFocusDisplayObject#showFocus()
		 * @see feathers.core.IFocusDisplayObject#hideFocus()
		 * @see feathers.core.IFocusDisplayObject
		 */
		public function get isShowingFocus():Boolean
		{
			return this._showFocus;
		}

		/**
		 * <p>The implementation of this method is provided for convenience, but
		 * it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * @copy feathers.core.IFocusDisplayObject#maintainTouchFocus
		 *
		 * @see feathers.core.IFocusDisplayObject
		 */
		public function get maintainTouchFocus():Boolean
		{
			return false;
		}

		/**
		 * @private
		 */
		protected var _nextTabFocus:IFocusDisplayObject = null;

		/**
		 * <p>The implementation of this property is provided for convenience,
		 * but it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * @copy feathers.core.IFocusDisplayObject#nextTabFocus
		 *
		 * @default null
		 *
		 * @see feathers.core.IFocusDisplayObject
		 */
		public function get nextTabFocus():IFocusDisplayObject
		{
			return this._nextTabFocus;
		}

		/**
		 * @private
		 */
		public function set nextTabFocus(value:IFocusDisplayObject):void
		{
			if(!(this is IFocusDisplayObject))
			{
				throw new IllegalOperationError("Cannot set nextTabFocus on a component that does not implement feathers.core.IFocusDisplayObject");
			}
			this._nextTabFocus = value;
		}

		/**
		 * @private
		 */
		protected var _previousTabFocus:IFocusDisplayObject = null;

		/**
		 * <p>The implementation of this property is provided for convenience,
		 * but it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * @copy feathers.core.IFocusDisplayObject#previousTabFocus
		 *
		 * @default null
		 *
		 * @see feathers.core.IFocusDisplayObject
		 */
		public function get previousTabFocus():IFocusDisplayObject
		{
			return this._previousTabFocus;
		}

		/**
		 * @private
		 */
		public function set previousTabFocus(value:IFocusDisplayObject):void
		{
			if(!(this is IFocusDisplayObject))
			{
				throw new IllegalOperationError("Cannot set previousTabFocus on a component that does not implement feathers.core.IFocusDisplayObject");
			}
			this._previousTabFocus = value;
		}

		/**
		 * @private
		 */
		protected var _nextUpFocus:IFocusDisplayObject = null;

		/**
		 * <p>The implementation of this property is provided for convenience,
		 * but it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * @copy feathers.core.IFocusDisplayObject#nextUpFocus
		 *
		 * @default null
		 *
		 * @see feathers.core.IFocusDisplayObject
		 *
		 * @productversion Feathers 3.4.0
		 */
		public function get nextUpFocus():IFocusDisplayObject
		{
			return this._nextUpFocus;
		}

		/**
		 * @private
		 */
		public function set nextUpFocus(value:IFocusDisplayObject):void
		{
			if(!(this is IFocusDisplayObject))
			{
				throw new IllegalOperationError("Cannot set nextUpFocus on a component that does not implement feathers.core.IFocusDisplayObject");
			}
			this._nextUpFocus = value;
		}

		/**
		 * @private
		 */
		protected var _nextRightFocus:IFocusDisplayObject = null;

		/**
		 * <p>The implementation of this property is provided for convenience,
		 * but it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * @copy feathers.core.IFocusDisplayObject#nextRightFocus
		 *
		 * @default null
		 *
		 * @see feathers.core.IFocusDisplayObject
		 *
		 * @productversion Feathers 3.4.0
		 */
		public function get nextRightFocus():IFocusDisplayObject
		{
			return this._nextRightFocus;
		}

		/**
		 * @private
		 */
		public function set nextRightFocus(value:IFocusDisplayObject):void
		{
			if(!(this is IFocusDisplayObject))
			{
				throw new IllegalOperationError("Cannot set nextRightFocus on a component that does not implement feathers.core.IFocusDisplayObject");
			}
			this._nextRightFocus = value;
		}

		/**
		 * @private
		 */
		protected var _nextDownFocus:IFocusDisplayObject = null;

		/**
		 * <p>The implementation of this property is provided for convenience,
		 * but it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * @copy feathers.core.IFocusDisplayObject#nextDownFocus
		 *
		 * @default null
		 *
		 * @see feathers.core.IFocusDisplayObject
		 *
		 * @productversion Feathers 3.4.0
		 */
		public function get nextDownFocus():IFocusDisplayObject
		{
			return this._nextDownFocus;
		}

		/**
		 * @private
		 */
		public function set nextDownFocus(value:IFocusDisplayObject):void
		{
			if(!(this is IFocusDisplayObject))
			{
				throw new IllegalOperationError("Cannot set nextDownFocus on a component that does not implement feathers.core.IFocusDisplayObject");
			}
			this._nextDownFocus = value;
		}

		/**
		 * @private
		 */
		protected var _nextLeftFocus:IFocusDisplayObject = null;

		/**
		 * <p>The implementation of this property is provided for convenience,
		 * but it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * @copy feathers.core.IFocusDisplayObject#nextLeftFocus
		 *
		 * @default null
		 *
		 * @see feathers.core.IFocusDisplayObject
		 *
		 * @productversion Feathers 3.4.0
		 */
		public function get nextLeftFocus():IFocusDisplayObject
		{
			return this._nextLeftFocus;
		}

		/**
		 * @private
		 */
		public function set nextLeftFocus(value:IFocusDisplayObject):void
		{
			if(!(this is IFocusDisplayObject))
			{
				throw new IllegalOperationError("Cannot set nextLeftFocus on a component that does not implement feathers.core.IFocusDisplayObject");
			}
			this._nextLeftFocus = value;
		}

		/**
		 * @private
		 */
		protected var _focusIndicatorSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get focusIndicatorSkin():DisplayObject
		{
			return this._focusIndicatorSkin;
		}

		/**
		 * @private
		 */
		public function set focusIndicatorSkin(value:DisplayObject):void
		{
			if(!(this is IFocusDisplayObject))
			{
				throw new IllegalOperationError("Cannot set focus indicator skin on a component that does not implement feathers.core.IFocusDisplayObject");
			}
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._focusIndicatorSkin === value)
			{
				return;
			}
			if(this._focusIndicatorSkin)
			{
				if(this._focusIndicatorSkin.parent == this)
				{
					this._focusIndicatorSkin.removeFromParent(false);
				}
				if(this._focusIndicatorSkin is IStateObserver &&
					this is IStateContext)
				{
					IStateObserver(this._focusIndicatorSkin).stateContext = null;
				}
			}
			this._focusIndicatorSkin = value;
			if(this._focusIndicatorSkin)
			{
				this._focusIndicatorSkin.touchable = false;
			}
			if(this._focusIndicatorSkin is IStateObserver &&
				this is IStateContext)
			{
				IStateObserver(this._focusIndicatorSkin).stateContext = IStateContext(this);
			}
			if(this._focusManager && this._focusManager.focus == this)
			{
				this.invalidate(INVALIDATION_FLAG_STYLES);
			}
		}

		/**
		 * @private
		 */
		public function get focusPadding():Number
		{
			return this._focusPaddingTop;
		}

		/**
		 * @private
		 */
		public function set focusPadding(value:Number):void
		{
			this.focusPaddingTop = value;
			this.focusPaddingRight = value;
			this.focusPaddingBottom = value;
			this.focusPaddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _focusPaddingTop:Number = 0;

		/**
		 * @private
		 */
		public function get focusPaddingTop():Number
		{
			return this._focusPaddingTop;
		}

		/**
		 * @private
		 */
		public function set focusPaddingTop(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._focusPaddingTop == value)
			{
				return;
			}
			this._focusPaddingTop = value;
			this.invalidate(INVALIDATION_FLAG_FOCUS);
		}

		/**
		 * @private
		 */
		protected var _focusPaddingRight:Number = 0;

		/**
		 * @private
		 */
		public function get focusPaddingRight():Number
		{
			return this._focusPaddingRight;
		}

		/**
		 * @private
		 */
		public function set focusPaddingRight(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._focusPaddingRight == value)
			{
				return;
			}
			this._focusPaddingRight = value;
			this.invalidate(INVALIDATION_FLAG_FOCUS);
		}

		/**
		 * @private
		 */
		protected var _focusPaddingBottom:Number = 0;

		/**
		 * @private
		 */
		public function get focusPaddingBottom():Number
		{
			return this._focusPaddingBottom;
		}

		/**
		 * @private
		 */
		public function set focusPaddingBottom(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._focusPaddingBottom == value)
			{
				return;
			}
			this._focusPaddingBottom = value;
			this.invalidate(INVALIDATION_FLAG_FOCUS);
		}

		/**
		 * @private
		 */
		protected var _focusPaddingLeft:Number = 0;

		/**
		 * @private
		 */
		public function get focusPaddingLeft():Number
		{
			return this._focusPaddingLeft;
		}

		/**
		 * @private
		 */
		public function set focusPaddingLeft(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._focusPaddingLeft == value)
			{
				return;
			}
			this._focusPaddingLeft = value;
			this.invalidate(INVALIDATION_FLAG_FOCUS);
		}

		/**
		 * Indicates if effects have been suspended.
		 *
		 * @see #suspendEffects()
		 * @see #resumeEffects()
		 */
		public function get effectsSuspended():Boolean
		{
			return this._suspendEffectsCount > 0;
		}

		/**
		 * @private
		 */
		protected var _hasFocus:Boolean = false;

		/**
		 * @private
		 */
		protected var _showFocus:Boolean = false;

		/**
		 * @private
		 * Flag to indicate that the control is currently validating.
		 */
		protected var _isValidating:Boolean = false;

		/**
		 * @private
		 * Flag to indicate that the control has validated at least once.
		 */
		protected var _hasValidated:Boolean = false;

		/**
		 * Determines if the component has been initialized and validated for
		 * the first time.
		 *
		 * <p>In the following example, we check if the component is created or
		 * not, and we listen for an event if it isn't:</p>
		 *
		 * <listing version="3.0">
		 * if( !control.isCreated )
		 * {
		 *     control.addEventListener( FeathersEventType.CREATION_COMPLETE, creationCompleteHandler );
		 * }</listing>
		 *
		 * @see #event:creationComplete
		 * @see #isInitialized
		 */
		public function get isCreated():Boolean
		{
			return this._hasValidated;
		}

		/**
		 * @private
		 */
		protected var _depth:int = -1;

		/**
		 * @copy feathers.core.IValidating#depth
		 */
		public function get depth():int
		{
			return this._depth;
		}

		/**
		 * @private
		 */
		protected var _suspendEffectsCount:int = 0;

		/**
		 * @private
		 */
		protected var _ignoreNextStyleRestriction:Boolean = false;

		/**
		 * @private
		 */
		protected var _invalidateCount:int = 0;

		/**
		 * Feathers components use an optimized <code>getBounds()</code>
		 * implementation that may sometimes behave differently than regular
		 * Starling display objects. For instance, filters may need some special
		 * customization. If a component's children appear outside of its
		 * bounds (such as at negative dimensions), padding should be added to
		 * the filter to account for these regions.
		 */
		override public function getBounds(targetSpace:DisplayObject, resultRect:Rectangle = null):Rectangle
		{
			if(!resultRect)
			{
				resultRect = new Rectangle();
			}

			var minX:Number = Number.MAX_VALUE;
			var maxX:Number = -Number.MAX_VALUE;
			var minY:Number = Number.MAX_VALUE;
			var maxY:Number = -Number.MAX_VALUE;

			if(targetSpace == this) //optimization
			{
				minX = 0;
				minY = 0;
				maxX = this.actualWidth;
				maxY = this.actualHeight;
			}
			else
			{
				var matrix:Matrix = Pool.getMatrix();
				this.getTransformationMatrix(targetSpace, matrix);

				MatrixUtil.transformCoords(matrix, 0, 0, HELPER_POINT);
				minX = minX < HELPER_POINT.x ? minX : HELPER_POINT.x;
				maxX = maxX > HELPER_POINT.x ? maxX : HELPER_POINT.x;
				minY = minY < HELPER_POINT.y ? minY : HELPER_POINT.y;
				maxY = maxY > HELPER_POINT.y ? maxY : HELPER_POINT.y;

				MatrixUtil.transformCoords(matrix, 0, this.actualHeight, HELPER_POINT);
				minX = minX < HELPER_POINT.x ? minX : HELPER_POINT.x;
				maxX = maxX > HELPER_POINT.x ? maxX : HELPER_POINT.x;
				minY = minY < HELPER_POINT.y ? minY : HELPER_POINT.y;
				maxY = maxY > HELPER_POINT.y ? maxY : HELPER_POINT.y;

				MatrixUtil.transformCoords(matrix, this.actualWidth, 0, HELPER_POINT);
				minX = minX < HELPER_POINT.x ? minX : HELPER_POINT.x;
				maxX = maxX > HELPER_POINT.x ? maxX : HELPER_POINT.x;
				minY = minY < HELPER_POINT.y ? minY : HELPER_POINT.y;
				maxY = maxY > HELPER_POINT.y ? maxY : HELPER_POINT.y;

				MatrixUtil.transformCoords(matrix, this.actualWidth, this.actualHeight, HELPER_POINT);
				minX = minX < HELPER_POINT.x ? minX : HELPER_POINT.x;
				maxX = maxX > HELPER_POINT.x ? maxX : HELPER_POINT.x;
				minY = minY < HELPER_POINT.y ? minY : HELPER_POINT.y;
				maxY = maxY > HELPER_POINT.y ? maxY : HELPER_POINT.y;

				Pool.putMatrix(matrix);
			}

			resultRect.x = minX;
			resultRect.y = minY;
			resultRect.width = maxX - minX;
			resultRect.height = maxY - minY;

			return resultRect;
		}

		/**
		 * @private
		 */
		override public function hitTest(localPoint:Point):DisplayObject
		{
			if(this._isQuickHitAreaEnabled)
			{
				if(!this.visible || !this.touchable)
				{
					return null;
				}
				if(this.mask && !this.hitTestMask(localPoint))
				{
					return null;
				}
				return this._hitArea.containsPoint(localPoint) ? this : null;
			}
			return super.hitTest(localPoint);
		}

		/**
		 * @private
		 */
		protected var _isDisposed:Boolean = false;

		/**
		 * @private
		 */
		override public function dispose():void
		{
			//we don't dispose it if this is the parent because it'll
			//already get disposed in super.dispose()
			if(this._focusIndicatorSkin !== null && this._focusIndicatorSkin.parent !== this)
			{
				this._focusIndicatorSkin.dispose();
			}
			this._isDisposed = true;
			this._validationQueue = null;
			this.layoutData = null;
			this._styleNameList.removeEventListeners();
			super.dispose();
		}

		/**
		 * Call this function to tell the UI control that a redraw is pending.
		 * The redraw will happen immediately before Starling renders the UI
		 * control to the screen. The validation system exists to ensure that
		 * multiple properties can be set together without redrawing multiple
		 * times in between each property change.
		 *
		 * <p>If you cannot wait until later for the validation to happen, you
		 * can call <code>validate()</code> to redraw immediately. As an example,
		 * you might want to validate immediately if you need to access the
		 * correct <code>width</code> or <code>height</code> values of the UI
		 * control, since these values are calculated during validation.</p>
		 *
		 * @see feathers.core.FeathersControl#validate()
		 */
		public function invalidate(flag:String = INVALIDATION_FLAG_ALL):void
		{
			var isAlreadyInvalid:Boolean = this.isInvalid();
			var isAlreadyDelayedInvalid:Boolean = false;
			if(this._isValidating)
			{
				for(var otherFlag:String in this._delayedInvalidationFlags)
				{
					isAlreadyDelayedInvalid = true;
					break;
				}
			}
			if(!flag || flag == INVALIDATION_FLAG_ALL)
			{
				if(this._isValidating)
				{
					this._delayedInvalidationFlags[INVALIDATION_FLAG_ALL] = true;
				}
				else
				{
					this._isAllInvalid = true;
				}
			}
			else
			{
				if(this._isValidating)
				{
					this._delayedInvalidationFlags[flag] = true;
				}
				else if(flag != INVALIDATION_FLAG_ALL && !this._invalidationFlags.hasOwnProperty(flag))
				{
					this._invalidationFlags[flag] = true;
				}
			}
			if(this._validationQueue === null || !this._isInitialized)
			{
				//we'll add this component to the queue later, after it has been
				//added to the stage.
				return;
			}
			if(this._isValidating)
			{
				//if we've already incremented this counter this time, we can
				//return. we're already in queue.
				if(isAlreadyDelayedInvalid)
				{
					return;
				}
				this._invalidateCount++;
				//if invalidate() is called during validation, we'll be added
				//back to the end of the queue. we'll keep trying this a certain
				//number of times, but at some point, it needs to be considered
				//an infinite loop or a serious bug because it affects
				//performance.
				if(this._invalidateCount >= 10)
				{
					throw new Error(getQualifiedClassName(this) + " returned to validation queue too many times during validation. This may be an infinite loop. Try to avoid doing anything that calls invalidate() during validation.");
				}
				this._validationQueue.addControl(this);
				return;
			}
			if(isAlreadyInvalid)
			{
				return;
			}
			this._invalidateCount = 0;
			this._validationQueue.addControl(this);
		}

		/**
		 * @copy feathers.core.IValidating#validate()
		 *
		 * @see #invalidate()
		 */
		public function validate():void
		{
			if(this._isDisposed)
			{
				//disposed components have no reason to validate, but they may
				//have been left in the queue.
				return;
			}
			if(!this._isInitialized)
			{
				if(this._isInitializing)
				{
					throw new IllegalOperationError("A component cannot validate until after it has finished initializing.");
				}
				this.initializeNow();
			}
			//if we're not actually invalid, there's nothing to do here, so
			//simply return.
			if(!this.isInvalid())
			{
				return;
			}
			if(this._isValidating)
			{
				//we were already validating, so there's nothing to do here.
				//the existing validation will continue.
				return;
			}
			this._isValidating = true;
			this.draw();
			for(var flag:String in this._invalidationFlags)
			{
				delete this._invalidationFlags[flag];
			}
			this._isAllInvalid = false;
			for(flag in this._delayedInvalidationFlags)
			{
				if(flag == INVALIDATION_FLAG_ALL)
				{
					this._isAllInvalid = true;
				}
				else
				{
					this._invalidationFlags[flag] = true;
				}
				delete this._delayedInvalidationFlags[flag];
			}
			this._isValidating = false;
			if(!this._hasValidated)
			{
				this._hasValidated = true;
				this.dispatchEventWith(FeathersEventType.CREATION_COMPLETE);

				if(this._suspendEffectsCount == 0 && this.stage !== null && this._addedEffect !== null)
				{
					this._addedEffectContext = IEffectContext(this._addedEffect(this));
					this._addedEffectContext.addEventListener(Event.COMPLETE, addedEffectContext_completeHandler);
					this._addedEffectContext.play();
				}
			}
		}

		/**
		 * Indicates whether the control is pending validation or not. By
		 * default, returns <code>true</code> if any invalidation flag has been
		 * set. If you pass in a specific flag, returns <code>true</code> only
		 * if that flag has been set (others may be set too, but it checks the
		 * specific flag only. If all flags have been marked as invalid, always
		 * returns <code>true</code>.
		 */
		public function isInvalid(flag:String = null):Boolean
		{
			if(this._isAllInvalid)
			{
				return true;
			}
			if(!flag) //return true if any flag is set
			{
				for(flag in this._invalidationFlags)
				{
					return true;
				}
				return false;
			}
			return this._invalidationFlags[flag];
		}

		/**
		 * Sets both the width and the height of the control in a single
		 * function call.
		 *
		 * @see #width
		 * @see #height
		 */
		public function setSize(width:Number, height:Number):void
		{
			var hasSetExplicitSize:Boolean = false;
			if(this._suspendEffectsCount == 0 && this._resizeEffectContext !== null)
			{
				this._resizeEffectContext.interrupt();
				this._resizeEffectContext = null;
			}
			var widthIsNaN:Boolean = width !== width; //isNaN
			var heightIsNaN:Boolean = height !== height; //isNaN
			if((!widthIsNaN || !heightIsNaN) && this.isCreated && this._suspendEffectsCount == 0 && this._resizeEffect !== null)
			{
				this._resizeEffectContext = IEffectContext(this._resizeEffect(this));
				this._resizeEffectContext.addEventListener(Event.COMPLETE, resizeEffectContext_completeHandler);
				if(this._resizeEffectContext is IResizeEffectContext)
				{
					var resizeEffectContext:IResizeEffectContext = IResizeEffectContext(this._resizeEffectContext);
					resizeEffectContext.oldWidth = this.actualWidth;
					resizeEffectContext.oldHeight = this.actualHeight;
					if(widthIsNaN)
					{
						resizeEffectContext.newWidth = this.actualWidth;
					}
					else
					{
						resizeEffectContext.newWidth = width;
					}
					if(heightIsNaN)
					{
						resizeEffectContext.newHeight = this.actualHeight;
					}
					else
					{
						resizeEffectContext.newHeight = height;
					}
				}
				else
				{
					this._explicitWidth = width;
					this._explicitHeight = height;
					hasSetExplicitSize = true;
				}
				this._resizeEffectContext.play();
			}
			else
			{
				this._explicitWidth = width;
				this._explicitHeight = height;
				hasSetExplicitSize = true;
			}
			if(hasSetExplicitSize)
			{
				if(widthIsNaN)
				{
					this.actualWidth = this.scaledActualWidth = 0;
				}
				if(heightIsNaN)
				{
					this.actualHeight = this.scaledActualHeight = 0;
				}

				if(widthIsNaN || heightIsNaN)
				{
					this.invalidate(INVALIDATION_FLAG_SIZE);
				}
				else
				{
					var result:Boolean = this.saveMeasurements(width, height, this.actualMinWidth, this.actualMinHeight);
					if(result)
					{
						this.invalidate(INVALIDATION_FLAG_SIZE);
					}
				}
			}
		}

		/**
		 * Sets both the x and the y positions of the control in a single
		 * function call.
		 *
		 * @see #x
		 * @see #y
		 */
		public function move(x:Number, y:Number):void
		{
			if(this._suspendEffectsCount == 0 && this._moveEffectContext !== null)
			{
				this._moveEffectContext.interrupt();
				this._moveEffectContext = null;
			}
			if(this.isCreated && this._suspendEffectsCount == 0 && this._moveEffect !== null)
			{
				this._moveEffectContext = IEffectContext(this._moveEffect(this));
				this._moveEffectContext.addEventListener(Event.COMPLETE, moveEffectContext_completeHandler);
				if(this._moveEffectContext is IMoveEffectContext)
				{
					var moveEffectContext:IMoveEffectContext = IMoveEffectContext(this._moveEffectContext);
					moveEffectContext.oldX = this.x;
					moveEffectContext.oldY = this.y;
					moveEffectContext.newX = x;
					moveEffectContext.newY = y;
				}
				else
				{
					super.x = x;
					super.y = y;
				}
				this._moveEffectContext.play();
			}
			else
			{
				super.x = x;
				super.y = y;
			}
		}

		/**
		 * Plays an effect before removing the component from its parent.
		 *
		 * <p>In the following example, an effect fades the component's
		 * <code>alpha</code> property to <code>0</code> before removing the
		 * component from its parent:</p>
		 *
		 * <listing version="3.0">
		 * control.removeFromParentWithEffect(Fade.createFadeOutEffect(), true);</listing>
		 *
		 * <p>A number of animated effects may be found in the
		 * <a href="../motion/package-detail.html">feathers.motion</a> package.
		 * However, you are not limited to only these effects. It's possible
		 * to create custom effects too.</p>
		 *
		 * <p>A custom effect function should have the following signature:</p>
		 * <pre>function(target:DisplayObject):IEffectContext</pre>
		 *
		 * <p>The <code>IEffectContext</code> is used by the component to
		 * control the effect, performing actions like playing the effect,
		 * pausing it, or cancelling it.</p>
		 *
		 * <p>Custom animated effects that use
		 * <code>starling.display.Tween</code> typically return a
		 * <code>TweenEffectContext</code>. In the following example, we
		 * recreate the <code>Fade.createFadeOutEffect()</code> used in the
		 * previous example.</p>
		 *
		 * <listing version="3.0">
		 * function customEffect(target:DisplayObject):IEffectContext
		 * {
		 *     var tween:Tween = new Tween(target, 0.5, Transitions.EASE_OUT);
		 *     tween.fadeTo(0);
		 *     return new TweenEffectContext(target, tween);
		 * }
		 * control.removeFromParentWithEffect(customEffect, true);</listing>
		 *
		 * @see #addedEffect
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 * @see feathers.motion.effectClasses.IEffectContext
		 * @see feathers.motion.effectClasses.TweenEffectContext
		 */
		public function removeFromParentWithEffect(effect:Function, dispose:Boolean = false):void
		{
			if(this.isCreated && this._suspendEffectsCount == 0)
			{
				this._disposeAfterRemovedEffect = dispose;
				this._removedEffectContext = IEffectContext(effect(this));
				this._removedEffectContext.addEventListener(Event.COMPLETE, removedEffectContext_completeHandler);
				this._removedEffectContext.play();
			}
			else
			{
				this.removeFromParent(dispose);
			}
		}

		/**
		 * Resets the <code>styleProvider</code> property to its default value,
		 * which is usually the global style provider for the component.
		 *
		 * @see #styleProvider
		 * @see #defaultStyleProvider
		 */
		public function resetStyleProvider():void
		{
			this.styleProvider = this.defaultStyleProvider;
		}

		/**
		 * Indicates that effects should not be activated temporarily. Call
		 * <code>resumeEffects()</code> when effects should be allowed again.
		 *
		 * @see #resumeEffects()
		 */
		public function suspendEffects():void
		{
			this._suspendEffectsCount++;
		}

		/**
		 * Indicates that effects should be re-activated after being suspended.
		 *
		 * @see #suspendEffects()
		 */
		public function resumeEffects():void
		{
			this._suspendEffectsCount--;
		}

		/**
		 * <p>The implementation of this method is provided for convenience, but
		 * it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * @copy feathers.core.IFocusDisplayObject#showFocus()
		 *
		 * @see feathers.core.IFocusDisplayObject
		 */
		public function showFocus():void
		{
			if(!this._hasFocus || !this._focusIndicatorSkin)
			{
				return;
			}

			this._showFocus = true;
			this.invalidate(INVALIDATION_FLAG_FOCUS);
		}

		/**
		 * <p>The implementation of this method is provided for convenience, but
		 * it cannot be used unless a subclass implements the
		 * <code>IFocusDisplayObject</code> interface.</p>
		 *
		 * @copy feathers.core.IFocusDisplayObject#hideFocus()
		 *
		 * @see feathers.core.IFocusDisplayObject
		 */
		public function hideFocus():void
		{
			if(!this._hasFocus || !this._focusIndicatorSkin)
			{
				return;
			}

			this._showFocus = false;
			this.invalidate(INVALIDATION_FLAG_FOCUS);
		}

		/**
		 * If the component has not yet initialized, initializes immediately.
		 * The <code>initialize()</code> function will be called, and the
		 * <code>FeathersEventType.INITIALIZE</code> event will be dispatched.
		 * Then, if the component has a style provider, it will be applied. The
		 * component will not validate, though. To initialize and validate
		 * immediately, call <code>validate()</code> instead.
		 *
		 * @see #isInitialized
		 * @see #initialize()
		 * @see #event:initialize FeathersEventType.INITIALIZE
		 * @see #styleProvider
		 * @see #validate()
		 */
		public function initializeNow():void
		{
			if(this._isInitialized || this._isInitializing)
			{
				return;
			}
			this._isInitializing = true;
			this.initialize();
			this.invalidate(); //invalidate everything
			this._isInitializing = false;
			this._isInitialized = true;
			this.dispatchEventWith(FeathersEventType.INITIALIZE);

			if(this._styleProvider !== null)
			{
				this._applyingStyles = true;
				this._styleProvider.applyStyles(this);
				this._applyingStyles = false;
			}
			this._styleNameList.addEventListener(Event.CHANGE, styleNameList_changeHandler);
		}

		/**
		 * Sets the width and height of the control, with the option of
		 * invalidating or not. Intended to be used when the <code>width</code>
		 * and <code>height</code> values have not been set explicitly, and the
		 * UI control needs to measure itself and choose an "ideal" size.
		 */
		protected function setSizeInternal(width:Number, height:Number, canInvalidate:Boolean):Boolean
		{
			var changed:Boolean = this.saveMeasurements(width, height, this.actualMinWidth, this.actualMinHeight);
			if(canInvalidate && changed)
			{
				this.invalidate(INVALIDATION_FLAG_SIZE);
			}
			return changed;
		}

		/**
		 * Saves the dimensions and minimum dimensions calculated for the
		 * component. Returns true if the reported values have changed and
		 * <code>Event.RESIZE</code> was dispatched.
		 */
		protected function saveMeasurements(width:Number, height:Number, minWidth:Number = 0, minHeight:Number = 0):Boolean
		{
			if(this._explicitMinWidth === this._explicitMinWidth) //!isNaN
			{
				//the min width has been set explicitly. it has precedence over
				//the measured min width
				minWidth = this._explicitMinWidth;
			}
			else if(minWidth > this._explicitMaxWidth)
			{
				//similarly, if the max width has been set explicitly, it can
				//affect the measured min width (but not explicit min width)
				minWidth = this._explicitMaxWidth;
			}
			if(this._explicitMinHeight === this._explicitMinHeight) //!isNaN
			{
				//the min height has been set explicitly. it has precedence over
				//the measured min height
				minHeight = this._explicitMinHeight;
			}
			else if(minHeight > this._explicitMaxHeight)
			{
				//similarly, if the max height has been set explicitly, it can
				//affect the measured min height (but not explicit min height)
				minHeight = this._explicitMaxHeight;
			}
			if(this._explicitWidth === this._explicitWidth) //!isNaN
			{
				width = this._explicitWidth;
			}
			else
			{
				if(width < minWidth)
				{
					width = minWidth;
				}
				else if(width > this._explicitMaxWidth)
				{
					width = this._explicitMaxWidth;
				}
			}
			if(this._explicitHeight === this._explicitHeight) //!isNaN
			{
				height = this._explicitHeight;
			}
			else
			{
				if(height < minHeight)
				{
					height = minHeight;
				}
				else if(height > this._explicitMaxHeight)
				{
					height = this._explicitMaxHeight;
				}
			}
			if(width !== width) //isNaN
			{
				throw new ArgumentError(ILLEGAL_WIDTH_ERROR);
			}
			if(height !== height) //isNaN
			{
				throw new ArgumentError(ILLEGAL_HEIGHT_ERROR);
			}
			var scaleX:Number = this.scaleX;
			if(scaleX < 0)
			{
				scaleX = -scaleX;
			}
			var scaleY:Number = this.scaleY;
			if(scaleY < 0)
			{
				scaleY = -scaleY;
			}
			var resized:Boolean = false;
			if(this.actualWidth != width)
			{
				this.actualWidth = width;
				this.refreshHitAreaX();
				resized = true;
			}
			if(this.actualHeight != height)
			{
				this.actualHeight = height;
				this.refreshHitAreaY();
				resized = true;
			}
			if(this.actualMinWidth != minWidth)
			{
				this.actualMinWidth = minWidth;
				resized = true;
			}
			if(this.actualMinHeight != minHeight)
			{
				this.actualMinHeight = minHeight;
				resized = true;
			}
			width = this.scaledActualWidth;
			height = this.scaledActualHeight;
			this.scaledActualWidth = this.actualWidth * scaleX;
			this.scaledActualHeight = this.actualHeight * scaleY;
			this.scaledActualMinWidth = this.actualMinWidth * scaleX;
			this.scaledActualMinHeight = this.actualMinHeight * scaleY;
			if(width != this.scaledActualWidth || height != this.scaledActualHeight)
			{
				resized = true;
				this.dispatchEventWith(Event.RESIZE);
			}
			return resized;
		}

		/**
		 * Called the first time that the UI control is added to the stage, and
		 * you should override this function to customize the initialization
		 * process. Do things like create children and set up event listeners.
		 * After this function is called, <code>FeathersEventType.INITIALIZE</code>
		 * is dispatched.
		 *
		 * @see #event:initialize feathers.events.FeathersEventType.INITIALIZE
		 */
		protected function initialize():void
		{

		}

		/**
		 * Override to customize layout and to adjust properties of children.
		 * Called when the component validates, if any flags have been marked
		 * to indicate that validation is pending.
		 */
		protected function draw():void
		{

		}

		/**
		 * Sets an invalidation flag. This will not add the component to the
		 * validation queue. It only sets the flag. A subclass might use
		 * this function during <code>draw()</code> to manipulate the flags that
		 * its superclass sees.
		 */
		protected function setInvalidationFlag(flag:String):void
		{
			if(this._invalidationFlags.hasOwnProperty(flag))
			{
				return;
			}
			this._invalidationFlags[flag] = true;
		}

		/**
		 * Clears an invalidation flag. This will not remove the component from
		 * the validation queue. It only clears the flag. A subclass might use
		 * this function during <code>draw()</code> to manipulate the flags that
		 * its superclass sees.
		 */
		protected function clearInvalidationFlag(flag:String):void
		{
			delete this._invalidationFlags[flag];
		}

		/**
		 * Used by setters for properties that are considered "styles" to
		 * determine if the setter has been called directly on the component or
		 * from a <em>style provider</em>. A style provider is typically
		 * associated with a theme. When a style is set directly on the
		 * component (outside of a style provider), then any attempts by the
		 * style provider to set the style later will be ignored. This allows
		 * developers to customize a component's styles directly without
		 * worrying about conflicts from the style provider or theme.
		 *
		 * <p>If a style provider is currently applying styles to the component,
		 * returns <code>true</code> if the style is restricted or false if it
		 * may be set.</p>
		 *
		 * <p>If the style setter is called outside of a style provider, marks
		 * the style as restricted and returns <code>false</code>.</p>
		 *
		 * <p>The <code>key</code> parameter should be a unique value for each
		 * separate style. In most cases, <code>processStyleRestriction()</code>
		 * will be called in the style property setter, so
		 * <code>arguments.callee</code> is recommended. Alternatively, a unique
		 * string value may be used instead.</p>
		 *
		 * <p>The following example shows how to use
		 * <code>processStyleRestriction()</code> in a style property
		 * setter:</p>
		 *
		 * <listing version="3.0">
		 * private var _customStyle:Object;
		 * 
		 * public function get customStyle():Object
		 * {
		 *     return this._customStyle;
		 * }
		 * 
		 * public function set customStyle( value:Object ):void
		 * {
		 *     if( this.processStyleRestriction( arguments.callee ) )
		 *     {
		 *         // if a style is restricted, don't set it
		 *         return;
		 *     }
		 * 
		 *     this._customStyle = value;
		 * }</listing>
		 *
		 * @see #ignoreNextStyleRestriction()
		 */
		protected function processStyleRestriction(key:Object):Boolean
		{
			var ignore:Boolean = this._ignoreNextStyleRestriction;
			this._ignoreNextStyleRestriction = false;
			//in most cases, the style is not restricted, and we can set it
			if(this._applyingStyles)
			{
				return this._restrictedStyles !== null &&
					key in this._restrictedStyles;
			}
			if(ignore)
			{
				return false;
			}
			if(this._restrictedStyles === null)
			{
				//only create the object if it is needed
				this._restrictedStyles = new Dictionary();
			}
			this._restrictedStyles[key] = true;
			return false;
		}

		/**
		 * The next style that is set will not be restricted. This allows
		 * components to set defaults by calling the setter while still allowing
		 * the style property to be replaced by a theme in the future.
		 *
		 * @see #processStyleRestriction()
		 */
		protected function ignoreNextStyleRestriction():void
		{
			this._ignoreNextStyleRestriction = true;
		}

		/**
		 * Updates the focus indicator skin by showing or hiding it and
		 * adjusting its position and dimensions. This function is not called
		 * automatically. Components that support focus should call this
		 * function at an appropriate point within the <code>draw()</code>
		 * function. This function may be overridden if the default behavior is
		 * not desired.
		 */
		protected function refreshFocusIndicator():void
		{
			if(this._focusIndicatorSkin)
			{
				if(this._hasFocus && this._showFocus)
				{
					if(this._focusIndicatorSkin.parent != this)
					{
						this.addChild(this._focusIndicatorSkin);
					}
					else
					{
						this.setChildIndex(this._focusIndicatorSkin, this.numChildren - 1);
					}
				}
				else if(this._focusIndicatorSkin.parent)
				{
					this._focusIndicatorSkin.removeFromParent(false);
				}
				this._focusIndicatorSkin.x = this._focusPaddingLeft;
				this._focusIndicatorSkin.y = this._focusPaddingTop;
				this._focusIndicatorSkin.width = this.actualWidth - this._focusPaddingLeft - this._focusPaddingRight;
				this._focusIndicatorSkin.height = this.actualHeight - this._focusPaddingTop - this._focusPaddingBottom;
			}
		}

		/**
		 * @private
		 */
		protected function refreshHitAreaX():void
		{
			if(this.actualWidth < this._minTouchWidth)
			{
				this._hitArea.width = this._minTouchWidth;
			}
			else
			{
				this._hitArea.width = this.actualWidth;
			}
			var hitAreaX:Number = (this.actualWidth - this._hitArea.width) / 2;
			if(hitAreaX !== hitAreaX) //isNaN
			{
				this._hitArea.x = 0;
			}
			else
			{
				this._hitArea.x = hitAreaX;
			}
		}

		/**
		 * @private
		 */
		protected function refreshHitAreaY():void
		{
			if(this.actualHeight < this._minTouchHeight)
			{
				this._hitArea.height = this._minTouchHeight;
			}
			else
			{
				this._hitArea.height = this.actualHeight;
			}
			var hitAreaY:Number = (this.actualHeight - this._hitArea.height) / 2;
			if(hitAreaY !== hitAreaY) //isNaN
			{
				this._hitArea.y = 0;
			}
			else
			{
				this._hitArea.y = hitAreaY;
			}
		}

		/**
		 * Default event handler for <code>FeathersEventType.FOCUS_IN</code>
		 * that may be overridden in subclasses to perform additional actions
		 * when the component receives focus.
		 */
		protected function focusInHandler(event:Event):void
		{
			this._hasFocus = true;
			this.invalidate(INVALIDATION_FLAG_FOCUS);

			if(this._focusOutEffectContext !== null)
			{
				this._focusOutEffectContext.interrupt();
				this._focusOutEffectContext = null;
			}

			if(this._suspendEffectsCount == 0 && this._focusInEffect !== null)
			{
				this._focusInEffectContext = IEffectContext(this._focusInEffect(this));
				this._focusInEffectContext.addEventListener(Event.COMPLETE, focusInEffectContext_completeHandler);
				this._focusInEffectContext.play();
			}
		}

		/**
		 * Default event handler for <code>FeathersEventType.FOCUS_OUT</code>
		 * that may be overridden in subclasses to perform additional actions
		 * when the component loses focus.
		 */
		protected function focusOutHandler(event:Event):void
		{
			this._hasFocus = false;
			this._showFocus = false;
			this.invalidate(INVALIDATION_FLAG_FOCUS);

			if(this._focusInEffectContext !== null)
			{
				this._focusInEffectContext.interrupt();
				this._focusInEffectContext = null;
			}

			if(this._suspendEffectsCount == 0 && this._focusOutEffect !== null)
			{
				this._focusOutEffectContext = IEffectContext(this._focusOutEffect(this));
				this._focusOutEffectContext.addEventListener(Event.COMPLETE, focusOutEffectContext_completeHandler);
				this._focusOutEffectContext.play();
			}
		}

		/**
		 * @private
		 * Initialize the control, if it hasn't been initialized yet. Then,
		 * invalidate. If already initialized, check if invalid and put back
		 * into queue.
		 */
		protected function feathersControl_addedToStageHandler(event:Event):void
		{
			if(this.stage === null)
			{
				//this could happen if removed from parent in another
				//Event.ADDED_TO_STAGE listener
				return;
			}
			//initialize before setting the validation queue to avoid
			//getting added to the validation queue before initialization
			//completes.
			if(!this._isInitialized)
			{
				this.initializeNow();
			}
			this._depth = getDisplayObjectDepthFromStage(this);
			this._validationQueue = ValidationQueue.forStarling(this.stage.starling);
			if(this.isInvalid())
			{
				this._invalidateCount = 0;
				//add to validation queue, if required
				this._validationQueue.addControl(this);
			}

			//if the removed effect is still active, stop it
			if(this._removedEffectContext !== null)
			{
				this._removedEffectContext.interrupt();
			}

			if(this.isCreated && this._suspendEffectsCount == 0 && this._addedEffect !== null)
			{
				this._addedEffectContext = IEffectContext(this._addedEffect(this));
				this._addedEffectContext.addEventListener(Event.COMPLETE, addedEffectContext_completeHandler);
				this._addedEffectContext.play();
			}
		}

		/**
		 * @private
		 */
		protected function feathersControl_removedFromStageHandler(event:Event):void
		{
			if(this._addedEffectContext !== null)
			{
				this._addedEffectContext.interrupt();
			}
			this._depth = -1;
			this._validationQueue = null;
		}

		/**
		 * @private
		 */
		protected function addedEffectContext_completeHandler(event:Event):void
		{
			this._addedEffectContext = null;
		}

		/**
		 * @private
		 */
		protected function removedEffectContext_completeHandler(event:Event, stopped:Boolean):void
		{
			this._removedEffectContext = null;
			if(!stopped)
			{
				this.removeFromParent(this._disposeAfterRemovedEffect);
			}
		}

		/**
		 * @private
		 */
		protected function showEffectContext_completeHandler(event:Event):void
		{
			this._showEffectContext.removeEventListener(Event.COMPLETE, showEffectContext_completeHandler);
			this._showEffectContext = null;
		}

		/**
		 * @private
		 */
		protected function hideEffectContext_completeHandler(event:Event, stopped:Boolean):void
		{
			this._hideEffectContext.removeEventListener(Event.COMPLETE, hideEffectContext_completeHandler);
			this._hideEffectContext = null;
			if(!stopped)
			{
				this.suspendEffects();
				super.visible = this._pendingVisible;
				this.resumeEffects();
			}
		}

		/**
		 * @private
		 */
		private function focusInEffectContext_completeHandler(event:Event):void
		{
			this._focusInEffectContext.removeEventListener(Event.COMPLETE, focusInEffectContext_completeHandler);
			this._focusInEffectContext = null;
		}

		/**
		 * @private
		 */
		private function focusOutEffectContext_completeHandler(event:Event):void
		{
			this._focusOutEffectContext.removeEventListener(Event.COMPLETE, focusOutEffectContext_completeHandler);
			this._focusOutEffectContext = null;
		}

		/**
		 * @private
		 */
		protected function moveEffectContext_completeHandler(event:Event):void
		{
			this._moveEffectContext.removeEventListener(Event.COMPLETE, moveEffectContext_completeHandler);
			this._moveEffectContext = null;
		}

		/**
		 * @private
		 */
		protected function resizeEffectContext_completeHandler(event:Event):void
		{
			this._resizeEffectContext.removeEventListener(Event.COMPLETE, resizeEffectContext_completeHandler);
			this._resizeEffectContext = null;
		}

		/**
		 * @private
		 */
		protected function layoutData_changeHandler(event:Event):void
		{
			this.dispatchEventWith(FeathersEventType.LAYOUT_DATA_CHANGE);
		}

		/**
		 * @private
		 */
		protected function styleNameList_changeHandler(event:Event):void
		{
			if(this._styleProvider === null)
			{
				return;
			}
			if(this._applyingStyles)
			{
				throw new IllegalOperationError("Cannot change styleNameList while the style provider is applying styles.");
			}
			this._applyingStyles = true;
			this._styleProvider.applyStyles(this);
			this._applyingStyles = false;
		}

		/**
		 * @private
		 */
		protected function styleProvider_changeHandler(event:Event):void
		{
			if(!this._isInitialized)
			{
				//safe to ignore changes until initialization
				return;
			}
			if(this._applyingStyles)
			{
				throw new IllegalOperationError("Cannot change style provider while it is applying styles.");
			}
			this._applyingStyles = true;
			this._styleProvider.applyStyles(this);
			this._applyingStyles = false;
		}
	}
}

================================================
FILE: source/feathers/core/FocusManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import flash.utils.Dictionary;

	import starling.core.Starling;
	import starling.display.DisplayObjectContainer;
	import starling.display.Stage;

	/**
	 * Manages touch and keyboard focus.
	 *
	 * @see ../../../help/focus.html Keyboard focus management in Feathers
	 *
	 * @productversion Feathers 1.1.0
	 */
	public class FocusManager
	{
		/**
		 * @private
		 */
		protected static const FOCUS_MANAGER_NOT_ENABLED_ERROR:String = "The specified action is not permitted when the focus manager is not enabled.";

		/**
		 * @private
		 */
		protected static const FOCUS_MANAGER_ROOT_MUST_BE_ON_STAGE_ERROR:String = "A focus manager may not be added or removed for a display object that is not on stage.";

		/**
		 * @private
		 */
		protected static const STAGE_TO_STACK:Dictionary = new Dictionary(true);

		/**
		 * Returns the active focus manager for the specified Starling stage.
		 * May return <code>null</code> if focus management has not been enabled
		 * for the specified stage.
		 *
		 * @see #isEnabledForStage()
		 * @see #setEnabledForStage()
		 */
		public static function getFocusManagerForStage(stage:Stage):IFocusManager
		{
			var stack:Vector.<IFocusManager> = STAGE_TO_STACK[stage] as Vector.<IFocusManager>;
			if(stack === null || stack.length == 0)
			{
				return null;
			}
			return stack[stack.length - 1];
		}

		/**
		 * The default factory that creates a focus manager.
		 *
		 * @see #focusManagerFactory
		 * @see feathers.core.DefaultFocusManager
		 */
		public static function defaultFocusManagerFactory(root:DisplayObjectContainer):IFocusManager
		{
			return new DefaultFocusManager(root);
		}

		/**
		 * A function that creates a focus manager.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 * <pre>function():IFocusManager</pre>
		 *
		 * <p>In the following example, the focus manager factory is modified:</p>
		 *
		 * <listing version="3.0">
		 * FocusManager.focusManagerFactory = function(root:DisplayObjectContainer):IPopUpManager
		 * {
		 *     return new CustomFocusManager(); //a custom class that implements IFocusManager
		 * };</listing>
		 *
		 * @see feathers.core.IFocusManager
		 */
		public static var focusManagerFactory:Function = defaultFocusManagerFactory;

		/**
		 * Determines if the focus manager is enabled or disabled for the
		 * specified Starling stage.
		 *
		 * @see #setEnabledForStage()
		 * @see #getFocusManagerForStage()
		 */
		public static function isEnabledForStage(stage:Stage):Boolean
		{
			var stack:Vector.<IFocusManager> = STAGE_TO_STACK[stage];
			return stack != null;
		}

		/**
		 * Enables or disables focus management on the specified Starling stage.
		 * For mobile apps, the focus manager should generally remain disabled.
		 * For desktop apps, it is recommended to enable the focus manager to
		 * support keyboard navigation.
		 *
		 * <p>In the following example, focus management is enabled:</p>
		 *
		 * <listing version="3.0">
		 * FocusManager.setEnabledForStage(stage, true);</listing>
		 *
		 * @see #isEnabledForStage()
		 * @see #getFocusManagerForStage()
		 */
		public static function setEnabledForStage(stage:Stage, isEnabled:Boolean):void
		{
			var stack:Vector.<IFocusManager> = STAGE_TO_STACK[stage];
			if((isEnabled && stack) || (!isEnabled && !stack))
			{
				return;
			}
			if(isEnabled)
			{
				STAGE_TO_STACK[stage] = new <IFocusManager>[];
				pushFocusManager(stage);
			}
			else
			{
				while(stack.length > 0)
				{
					var manager:IFocusManager = stack.pop();
					manager.isEnabled = false;
				}
				delete STAGE_TO_STACK[stage];
			}
		}

		/**
		 * Disables focus management on all stages where it has previously been
		 * enabled.
		 */
		public function disableAll():void
		{
			for(var key:Object in STAGE_TO_STACK)
			{
				var stage:Stage = Stage(key);
				var stack:Vector.<IFocusManager> = STAGE_TO_STACK[stage];
				while(stack.length > 0)
				{
					var manager:IFocusManager = stack.pop();
					manager.isEnabled = false;
				}
				delete STAGE_TO_STACK[stage];
			}
		}

		/**
		 * The object that currently has focus on <code>Starling.current.stage</code>.
		 * May return <code>null</code> if no object has focus.
		 *
		 * <p>You can call <code>geFocusManagerForStage()</code> to access the
		 * active <code>IFocusManager</code> instance for any <code>Stage</code>
		 * instance that isn't equal to <code>Starling.current.stage</code>.</p>
		 *
		 * <p>In the following example, the focus is changed on the current stage:</p>
		 *
		 * <listing version="3.0">
		 * FocusManager.focus = someObject;</listing>
		 *
		 * @see #getFocusManagerForStage()
		 */
		public static function get focus():IFocusDisplayObject
		{
			var manager:IFocusManager = getFocusManagerForStage(Starling.current.stage);
			if(manager)
			{
				return manager.focus;
			}
			return null;
		}

		/**
		 * @private
		 */
		public static function set focus(value:IFocusDisplayObject):void
		{
			var manager:IFocusManager = getFocusManagerForStage(Starling.current.stage);
			if(!manager)
			{
				throw new Error(FOCUS_MANAGER_NOT_ENABLED_ERROR);
			}
			manager.focus = value;
		}

		/**
		 * Adds a focus manager to the stack for the <code>root</code>
		 * argument's stage, and gives it exclusive focus. If focus management
		 * has not been enabled for the root's stage, then calling this function
		 * will throw a runtime error.
		 */
		public static function pushFocusManager(root:DisplayObjectContainer):IFocusManager
		{
			var stage:Stage = root.stage;
			if(!stage)
			{
				throw new ArgumentError(FOCUS_MANAGER_ROOT_MUST_BE_ON_STAGE_ERROR);
			}
			var stack:Vector.<IFocusManager> = STAGE_TO_STACK[stage] as Vector.<IFocusManager>;
			if(!stack)
			{
				throw new Error(FOCUS_MANAGER_NOT_ENABLED_ERROR);
			}
			var manager:IFocusManager = FocusManager.focusManagerFactory(root);
			manager.isEnabled = true;
			if(stack.length > 0)
			{
				var oldManager:IFocusManager = stack[stack.length - 1];
				oldManager.isEnabled = false;
			}
			stack.push(manager);
			return manager;
		}

		/**
		 * Removes the specified focus manager from the stack. If it was
		 * the top-most focus manager, the next top-most focus manager is
		 * enabled.
		 */
		public static function removeFocusManager(manager:IFocusManager):void
		{
			var stage:Stage = manager.root.stage;
			var stack:Vector.<IFocusManager> = STAGE_TO_STACK[stage] as Vector.<IFocusManager>;
			if(!stack)
			{
				throw new Error(FOCUS_MANAGER_NOT_ENABLED_ERROR);
			}
			var index:int = stack.indexOf(manager);
			if(index < 0)
			{
				return;
			}
			manager.isEnabled = false;
			stack.removeAt(index);
			//if this is the top-level focus manager, enable the previous one
			if(index > 0 && index == stack.length)
			{
				manager = stack[stack.length - 1];
				manager.isEnabled = true;
			}
		}

	}
}


================================================
FILE: source/feathers/core/IAdvancedNativeFocusOwner.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	/**
	 * If a display object implements <code>INativeFocusOwner</code> and its
	 * <code>nativeFocus</code> property does not return a
	 * <code>flash.display.InteractiveObject</code> (or <code>null</code>), it
	 * must implement this interface so that the focus manager can tell it when
	 * to give focus to its native focus object.
	 *
	 * @see ../../../help/focus.html
	 *
	 * @productversion Feathers 3.0.0
	 */
	public interface IAdvancedNativeFocusOwner extends INativeFocusOwner
	{
		/**
		 * Determines if <code>nativeFocus</code> currently has focus.
		 */
		function get hasFocus():Boolean;

		/**
		 * Called by the focus manager to set focus on <code>nativeFocus</code>.
		 * May also be called manually.
		 */
		function setFocus():void;
	}
}


================================================
FILE: source/feathers/core/IFeathersControl.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import feathers.skins.IStyleProvider;

	/**
	 * Dispatched after the control has been initialized, but before it has
	 * drawn for the first time. Typically, the component's children will have
	 * been created by this point.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.INITIALIZE
	 */
	[Event(name="initialize",type="starling.events.Event")]

	/**
	 * Dispatched after the component has validated for the first time. Both
	 * <code>initialize()</code> and <code>draw()</code> will have been called,
	 * and all children will have been created.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.CREATION_COMPLETE
	 */
	[Event(name="creationComplete",type="starling.events.Event")]

	/**
	 * Dispatched when the width or height of the control changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.RESIZE
	 */
	[Event(name="resize",type="starling.events.Event")]

	/**
	 * Basic interface for Feathers UI controls. A Feathers control must also
	 * be a Starling display object.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface IFeathersControl extends IValidating, IMeasureDisplayObject
	{
		/**
		 * @copy feathers.core.FeathersControl#isEnabled
		 */
		function get isEnabled():Boolean;

		/**
		 * @private
		 */
		function set isEnabled(value:Boolean):void;

		/**
		 * @copy feathers.core.FeathersControl#isInitialized
		 */
		function get isInitialized():Boolean;

		/**
		 * @copy feathers.core.FeathersControl#isCreated
		 */
		function get isCreated():Boolean;

		/**
		 * @copy feathers.core.FeathersControl#styleNameList
		 */
		function get styleNameList():TokenList;

		/**
		 * @copy feathers.core.FeathersControl#styleName
		 */
		function get styleName():String;

		/**
		 * @private
		 */
		function set styleName(value:String):void;

		/**
		 * @copy feathers.core.FeathersControl#styleProvider
		 */
		function get styleProvider():IStyleProvider;

		/**
		 * @private
		 */
		function set styleProvider(value:IStyleProvider):void;

		/**
		 * @copy feathers.core.FeathersControl#toolTip
		 */
		function get toolTip():String;

		/**
		 * @private
		 */
		function set toolTip(value:String):void;

		/**
		 * @copy feathers.core.FeathersControl#effectsSuspended
		 */
		function get effectsSuspended():Boolean;

		/**
		 * @copy feathers.core.FeathersControl#setSize()
		 */
		function setSize(width:Number, height:Number):void;

		/**
		 * @copy feathers.core.FeathersControl#move()
		 */
		function move(x:Number, y:Number):void;

		/**
		 * @copy feathers.core.FeathersControl#resetStyleProvider()
		 */
		function resetStyleProvider():void;

		/**
		 * @copy feathers.core.FeathersControl#initializeNow()
		 */
		function initializeNow():void;

		/**
		 * @copy feathers.core.FeathersControl#suspendEffects()
		 */
		function suspendEffects():void;

		/**
		 * @copy feathers.core.FeathersControl#resumeEffects()
		 */
		function resumeEffects():void;
	}
}


================================================
FILE: source/feathers/core/IFeathersDisplayObject.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import flash.geom.Matrix;
	import flash.geom.Point;
	import flash.geom.Rectangle;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Stage;
	import starling.filters.FragmentFilter;
	import starling.rendering.Painter;

	/**
	 * Public properties and functions from <code>starling.display.DisplayObject</code>
	 * in helpful interface form.
	 *
	 * <p>Never cast an object to this type. Cast to <code>DisplayObject</code>
	 * instead. This interface exists only to support easier code hinting for
	 * interfaces.</p>
	 *
	 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html Full description of starling.display.DisplayObject in Gamua's Starling Framework API Reference
	 *
	 * @productversion Feathers 1.1.0
	 */
	public interface IFeathersDisplayObject extends IFeathersEventDispatcher
	{
		/**
		 * The x, or horizontal, position of the display object in the parent's
		 * coordinate space.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#x Full description of starling.display.DisplayObject.x in Gamua's Starling Framework API Reference
		 */
		function get x():Number;

		/**
		 * @private
		 */
		function set x(value:Number):void;

		/**
		 * The y, or vertical, position of the display object in the parent's
		 * coordinate space.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#y Full description of starling.display.DisplayObject.y in Gamua's Starling Framework API Reference
		 */
		function get y():Number;

		/**
		 * @private
		 */
		function set y(value:Number):void;

		/**
		 * The width of the display object in the parent's coordinate space.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#width Full description of starling.display.DisplayObject.width in Gamua's Starling Framework API Reference
		 */
		function get width():Number;

		/**
		 * @private
		 */
		function set width(value:Number):void;

		/**
		 * The height of the display object in the parent's coordinate space.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#height Full description of starling.display.DisplayObject.height in Gamua's Starling Framework API Reference
		 */
		function get height():Number;

		/**
		 * @private
		 */
		function set height(value:Number):void;

		/**
		 * The x coordinate of the display object's origin in its own coordinate
		 * space.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#pivotX Full description of starling.display.DisplayObject.pivotX in Gamua's Starling Framework API Reference
		 */
		function get pivotX():Number;

		/**
		 * @private
		 */
		function set pivotX(value:Number):void;

		/**
		 * The y coordinate of the display object's origin in its own coordinate
		 * space.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#pivotY Full description of starling.display.DisplayObject.pivotY in Gamua's Starling Framework API Reference
		 */
		function get pivotY():Number;

		/**
		 * @private
		 */
		function set pivotY(value:Number):void;

		/**
		 * This horizontal scale factor.
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#scaleX Full description of starling.display.DisplayObject.scaleX in Gamua's Starling Framework API Reference
		 */
		function get scaleX():Number;

		/**
		 * @private
		 */
		function set scaleX(value:Number):void;

		/**
		 * The vertical scale factor.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#scaleY Full description of starling.display.DisplayObject.scaleY in Gamua's Starling Framework API Reference
		 */
		function get scaleY():Number;

		/**
		 * @private
		 */
		function set scaleY(value:Number):void;

		/**
		 * The horizontal skew, in radians.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#skewX Full description of starling.display.DisplayObject.skewX in Gamua's Starling Framework API Reference
		 */
		function get skewX():Number;

		/**
		 * @private
		 */
		function set skewX(value:Number):void;

		/**
		 * The vertical skew, in radians.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#skewY Full description of starling.display.DisplayObject.skewY in Gamua's Starling Framework API Reference
		 */
		function get skewY():Number;

		/**
		 * @private
		 */
		function set skewY(value:Number):void;

		/**
		 * The blend mode used when rendering the display object.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#blendMode Full description of starling.display.DisplayObject.blendMode in Gamua's Starling Framework API Reference
		 */
		function get blendMode():String;

		/**
		 * @private
		 */
		function set blendMode(value:String):void;

		/**
		 * The name of the display object.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#name Full description of starling.display.DisplayObject.name in Gamua's Starling Framework API Reference
		 */
		function get name():String;

		/**
		 * @private
		 */
		function set name(value:String):void;

		/**
		 * Determines if the display object may be touched.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#touchable Full description of starling.display.DisplayObject.touchable in Gamua's Starling Framework API Reference
		 */
		function get touchable():Boolean;

		/**
		 * @private
		 */
		function set touchable(value:Boolean):void;

		/**
		 * Determines the visibility of the display object.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#visible Full description of starling.display.DisplayObject.visible in Gamua's Starling Framework API Reference
		 */
		function get visible():Boolean;

		/**
		 * @private
		 */
		function set visible(value:Boolean):void;

		/**
		 * The opacity of the display object.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#alpha Full description of starling.display.DisplayObject.alpha in Gamua's Starling Framework API Reference
		 */
		function get alpha():Number;

		/**
		 * @private
		 */
		function set alpha(value:Number):void;

		/**
		 * The rotation of the display object, in radians.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#rotation Full description of starling.display.DisplayObject.rotation in Gamua's Starling Framework API Reference
		 */
		function get rotation():Number;

		/**
		 * @private
		 */
		function set rotation(value:Number):void;

		/**
		 * The display object's mask.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#mask Full description of starling.display.DisplayObject.mask in Gamua's Starling Framework API Reference
		 */
		function get mask():DisplayObject;

		/**
		 * @private
		 */
		function set mask(value:DisplayObject):void;

		/**
		 * The display object's parent, or <code>null</code> if it doesn't have
		 * a parent.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#parent Full description of starling.display.DisplayObject.parent in Gamua's Starling Framework API Reference
		 */
		function get parent():DisplayObjectContainer;

		/**
		 * The top-most object of the display tree that the display object is
		 * connected to.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#base Full description of starling.display.DisplayObject.base in Gamua's Starling Framework API Reference
		 */
		function get base():DisplayObject;

		/**
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#root Full description of starling.display.DisplayObject.root in Gamua's Starling Framework API Reference
		 */
		function get root():DisplayObject;

		/**
		 * The stage that the display object is connected to, or <code>null</code>
		 * if it is not connected to a stage.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#stage Full description of starling.display.DisplayObject.stage in Gamua's Starling Framework API Reference
		 */
		function get stage():Stage;

		/**
		 * The transformation matrix of the display object, relative to its
		 * parent.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#transformationMatrix Full description of starling.display.DisplayObject.transformationMatrix in Gamua's Starling Framework API Reference
		 */
		function get transformationMatrix():Matrix;

		/**
		 * Determines if the mouse cursor should turn into a hand when the mouse
		 * is over the display object.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#useHandCursor Full description of starling.display.DisplayObject.useHandCursor in Gamua's Starling Framework API Reference
		 */
		function get useHandCursor():Boolean;

		/**
		 * @private
		 */
		function set useHandCursor(value:Boolean):void;

		/**
		 * The bounds of the display object in its local coordinate space.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#bounds Full description of starling.display.DisplayObject.bounds in Gamua's Starling Framework API Reference
		 */
		function get bounds():Rectangle;

		/**
		 * The filter used when rendering the display object.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#filter Full description of starling.display.DisplayObject.filter in Gamua's Starling Framework API Reference
		 */
		function get filter():FragmentFilter;

		/**
		 * @private
		 */
		function set filter(value:FragmentFilter):void;

		/**
		 * Removes a display object from its parent.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#removeFromParent() Full description of starling.display.DisplayObject.removeFromParent() in Gamua's Starling Framework API Reference
		 */
		function removeFromParent(dispose:Boolean = false):void;

		/**
		 * Determines if a point exists within the display object's bounds.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#hitTest() Full description of starling.display.DisplayObject.hitTest() in Gamua's Starling Framework API Reference
		 */
		function hitTest(localPoint:Point):DisplayObject;

		/**
		 * Converts a point from the display object's coordinate space to the
		 * stage's coordinate space.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#localToGlobal() Full description of starling.display.DisplayObject.localToGlobal() in Gamua's Starling Framework API Reference
		 */
		function localToGlobal(localPoint:Point, resultPoint:Point = null):Point;

		/**
		 * Converts a point from the stage's coordinate space to the display
		 * object's coordinate space.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#globalToLocal() Full description of starling.display.DisplayObject.globalToLocal() in Gamua's Starling Framework API Reference
		 */
		function globalToLocal(globalPoint:Point, resultPoint:Point = null):Point;

		/**
		 * Calculates a transformation matrix to convert values from the display
		 * object's coordinate space to a target coordinate space.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#getTransformationMatrix() Full description of starling.display.DisplayObject.getTransformationMatrix() in Gamua's Starling Framework API Reference
		 */
		function getTransformationMatrix(targetSpace:DisplayObject, resultMatrix:Matrix = null):Matrix;

		/**
		 * Gets the display object's bounds in the target coordinate space.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#getBounds() Full description of starling.display.DisplayObject.getBounds() in Gamua's Starling Framework API Reference
		 */
		function getBounds(targetSpace:DisplayObject, resultRect:Rectangle = null):Rectangle;

		/**
		 * Renders the display object.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#render() Full description of starling.display.DisplayObject.render() in Gamua's Starling Framework API Reference
		 */
		function render(painter:Painter):void;

		/**
		 * Disposes the display object.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#dispose() Full description of starling.display.DisplayObject.dispose() in Gamua's Starling Framework API Reference
		 */
		function dispose():void;
	}
}


================================================
FILE: source/feathers/core/IFeathersEventDispatcher.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import starling.events.Event;

	/**
	 * Public properties and functions from <code>starling.events.EventDispatcher</code>
	 * in helpful interface form.
	 *
	 * <p>Never cast an object to this type. Cast to <code>EventDispatcher</code>
	 * instead. This interface exists only to support easier code hinting for
	 * interfaces.</p>
	 *
	 * @see http://doc.starling-framework.org/core/starling/events/EventDispatcher.html starling.events.EventDispatcher
	 *
	 * @productversion Feathers 1.1.0
	 */
	public interface IFeathersEventDispatcher
	{
		/**
		 * Adds a listener for an event type.
		 *
		 * @see http://doc.starling-framework.org/core/starling/events/EventDispatcher.html#addEventListener() Full description of starling.events.EventDispatcher.addEventListener() in Gamua's Starling Framework API Reference
		 */
		function addEventListener(type:String, listener:Function):void;

		/**
		 * Removes a listener for an event type.
		 *
		 * @see http://doc.starling-framework.org/core/starling/events/EventDispatcher.html#removeEventListener() Full description of starling.events.EventDispatcher.addEventListener() in Gamua's Starling Framework API Reference
		 */
		function removeEventListener(type:String, listener:Function):void;

		/**
		 * Removes all listeners for an event type.
		 *
		 * @see http://doc.starling-framework.org/core/starling/events/EventDispatcher.html#removeEventListeners() Full description of starling.events.EventDispatcher.removeEventListeners() in Gamua's Starling Framework API Reference
		 */
		function removeEventListeners(type:String = null):void;

		/**
		 * Dispatches an event to all listeners added for the specified event type.
		 *
		 * @see http://doc.starling-framework.org/core/starling/events/EventDispatcher.html#dispatchEvent() Full description of starling.events.EventDispatcher.dispatchEvent() in Gamua's Starling Framework API Reference
		 */
		function dispatchEvent(event:Event):void;

		/**
		 * Dispatches an event from the pool with the specified to all listeners
		 * for the specified event type.
		 *
		 * @see http://doc.starling-framework.org/core/starling/events/EventDispatcher.html#dispatchEventWith() Full description of starling.events.EventDispatcher.dispatchEventWith() in Gamua's Starling Framework API Reference
		 */
		function dispatchEventWith(type:String, bubbles:Boolean = false, data:Object = null):void;

		/**
		 * Checks if a listener has been added for the specified event type.
		 *
		 * @see http://doc.starling-framework.org/core/starling/events/EventDispatcher.html#hasEventListener() Full description of starling.events.EventDispatcher.hasEventListener() in Gamua's Starling Framework API Reference
		 */
		function hasEventListener(type:String, listener:Function = null):Boolean;
	}
}


================================================
FILE: source/feathers/core/IFocusContainer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	/**
	 * A component that can receive focus with children that can receive focus.
	 *
	 * @see ../../../help/focus.html Keyboard focus management in Feathers
	 *
	 * @productversion Feathers 2.1.0
	 */
	public interface IFocusContainer extends IFocusDisplayObject
	{
		/**
		 * Determines if this component's children can receive focus. This
		 * property is completely independent from the <code>isFocusEnabled</code>
		 * property. In other words, it's possible to disable focus on this
		 * component while still allowing focus on its children (or the other
		 * way around).
		 *
		 * <p>In the following example, the focus is disabled:</p>
		 *
		 * <listing version="3.0">
		 * object.isFocusEnabled = false;</listing>
		 *
		 * @see #isFocusEnabled
		 */
		function get isChildFocusEnabled():Boolean;

		/**
		 * @private
		 */
		function set isChildFocusEnabled(value:Boolean):void;
	}
}


================================================
FILE: source/feathers/core/IFocusDisplayObject.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	/**
	 * Dispatched when the display object receives focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_IN
	 */
	[Event(name="focusIn",type="starling.events.Event")]

	/**
	 * Dispatched when the display object loses focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_OUT
	 */
	[Event(name="focusOut",type="starling.events.Event")]

	/**
	 * A component that can receive focus if a focus manager is enabled.
	 *
	 * @see ../../../help/focus.html Keyboard focus management in Feathers
	 *
	 * @productversion Feathers 1.1.0
	 */
	public interface IFocusDisplayObject extends IFeathersDisplayObject
	{
		/**
		 * The current focus manager for this component. May be
		 * <code>null</code> if no focus manager is enabled.
		 */
		function get focusManager():IFocusManager;

		/**
		 * @private
		 */
		function set focusManager(value:IFocusManager):void;

		/**
		 * Determines if this component can receive focus.
		 *
		 * <p>In the following example, the focus is disabled:</p>
		 *
		 * <listing version="3.0">
		 * object.isFocusEnabled = false;</listing>
		 */
		function get isFocusEnabled():Boolean;

		/**
		 * @private
		 */
		function set isFocusEnabled(value:Boolean):void;

		/**
		 * The next object that will receive focus when the tab key is pressed
		 * when a focus manager is enabled. If <code>null</code>, defaults to
		 * the next child on the display list.
		 *
		 * <p>In the following example, the next tab focus is changed:</p>
		 *
		 * <listing version="3.0">
		 * object.nextTabFocus = otherObject;</listing>
		 */
		function get nextTabFocus():IFocusDisplayObject;

		/**
		 * @private
		 */
		function set nextTabFocus(value:IFocusDisplayObject):void;

		/**
		 * The previous object that will receive focus when the tab key is
		 * pressed while holding shift when a focus manager is enabled. If
		 * <code>null</code>, defaults to the previous child on the display
		 * list.
		 *
		 * <p>In the following example, the previous tab focus is changed:</p>
		 *
		 * <listing version="3.0">
		 * object.previousTabFocus = otherObject;</listing>
		 */
		function get previousTabFocus():IFocusDisplayObject;

		/**
		 * @private
		 */
		function set previousTabFocus(value:IFocusDisplayObject):void;

		/**
		 * The next object that will receive focus when
		 * <code>Keyboard.UP</code> is pressed at
		 * <code>KeyLocation.D_PAD</code> and a focus manager is enabled. If
		 * <code>null</code>, defaults to the best available child, as
		 * determined by the focus manager.
		 *
		 * <p>In the following example, the next up focus is changed:</p>
		 *
		 * <listing version="3.0">
		 * object.nextUpFocus = otherObject;</listing>
		 *
		 * <p>To simulate <code>KeyLocation.D_PAD</code> in the AIR Debug
		 * Launcher on desktop for debugging purposes, set
		 * <code>DeviceCapabilities.simulateDPad</code> to <code>true</code>.</p>
		 *
		 * @see feathers.system.DeviceCapabilities#simulateDPad
		 *
		 * @productversion Feathers 3.4.0
		 */
		function get nextUpFocus():IFocusDisplayObject;

		/**
		 * @private
		 */
		function set nextUpFocus(value:IFocusDisplayObject):void;

		/**
		 * The next object that will receive focus when
		 * <code>Keyboard.RIGHT</code> is pressed at
		 * <code>KeyLocation.D_PAD</code> and a focus manager is enabled. If
		 * <code>null</code>, defaults to the best available child, as
		 * determined by the focus manager.
		 *
		 * <p>In the following example, the next right focus is changed:</p>
		 *
		 * <listing version="3.0">
		 * object.nextRightFocus = otherObject;</listing>
		 *
		 * <p>To simulate <code>KeyLocation.D_PAD</code> in the AIR Debug
		 * Launcher on desktop for debugging purposes, set
		 * <code>DeviceCapabilities.simulateDPad</code> to <code>true</code>.</p>
		 *
		 * @see feathers.system.DeviceCapabilities#simulateDPad
		 *
		 * @productversion Feathers 3.4.0
		 */
		function get nextRightFocus():IFocusDisplayObject;

		/**
		 * @private
		 */
		function set nextRightFocus(value:IFocusDisplayObject):void;

		/**
		 * The next object that will receive focus when
		 * <code>Keyboard.DOWN</code> is pressed at
		 * <code>KeyLocation.D_PAD</code> and a focus manager is enabled. If
		 * <code>null</code>, defaults to the best available child, as
		 * determined by the focus manager.
		 *
		 * <p>In the following example, the next down focus is changed:</p>
		 *
		 * <listing version="3.0">
		 * object.nextDownFocus = otherObject;</listing>
		 *
		 * <p>To simulate <code>KeyLocation.D_PAD</code> in the AIR Debug
		 * Launcher on desktop for debugging purposes, set
		 * <code>DeviceCapabilities.simulateDPad</code> to <code>true</code>.</p>
		 *
		 * @see feathers.system.DeviceCapabilities#simulateDPad
		 *
		 * @productversion Feathers 3.4.0
		 */
		function get nextDownFocus():IFocusDisplayObject;

		/**
		 * @private
		 */
		function set nextDownFocus(value:IFocusDisplayObject):void;

		/**
		 * The next object that will receive focus when
		 * <code>Keyboard.LEFT</code> is pressed at
		 * <code>KeyLocation.D_PAD</code> and a focus manager is enabled. If
		 * <code>null</code>, defaults to the best available child, as
		 * determined by the focus manager.
		 *
		 * <p>In the following example, the next left focus is changed:</p>
		 *
		 * <listing version="3.0">
		 * object.nextLeftFocus = otherObject;</listing>
		 *
		 * <p>To simulate <code>KeyLocation.D_PAD</code> in the AIR Debug
		 * Launcher on desktop for debugging purposes, set
		 * <code>DeviceCapabilities.simulateDPad</code> to <code>true</code>.</p>
		 *
		 * @see feathers.system.DeviceCapabilities#simulateDPad
		 *
		 * @productversion Feathers 3.4.0
		 */
		function get nextLeftFocus():IFocusDisplayObject;

		/**
		 * @private
		 */
		function set nextLeftFocus(value:IFocusDisplayObject):void;

		/**
		 * Used for associating focusable display objects that are not direct
		 * children with an "owner" focusable display object, such as pop-ups.
		 * A focus manager may use this property to influence the tab order.
		 *
		 * <p>In the following example, the focus owner is changed:</p>
		 *
		 * <listing version="3.0">
		 * object.focusOwner = otherObject;</listing>
		 */
		function get focusOwner():IFocusDisplayObject;

		/**
		 * @private
		 */
		function set focusOwner(value:IFocusDisplayObject):void;

		/**
		 * Indicates if the <code>showFocus()</code> method has been called on
		 * the object when it has focus.
		 *
		 * <listing version="3.0">
		 * if(object.isShowingFocus)
		 * {
		 * 
		 * }</listing>
		 *
		 * @see #showFocus()
		 * @see #hideFocus()
		 */
		function get isShowingFocus():Boolean;

		/**
		 * If <code>true</code>, the display object should remain in focus,
		 * even if something else is touched. If <code>false</code>, touching
		 * another object will pass focus normally.
		 */
		function get maintainTouchFocus():Boolean;

		/**
		 * If the object has focus, an additional visual indicator may
		 * optionally be displayed to highlight the object. Calling this
		 * function may have no effect. It's merely a suggestion to the object.
		 *
		 * <p><strong>Important:</strong> This function will not give focus to
		 * the display object if it doesn't have focus. To give focus to the
		 * display object, you should set the <code>focus</code> property on
		 * the focus manager.</p>
		 *
		 * <listing version="3.0">
		 * object.focusManager.focus = object;</listing>
		 *
		 * @see #hideFocus()
		 * @see feathers.core.IFocusManager#focus
		 */
		function showFocus():void;

		/**
		 * If the visual indicator of focus has been displayed by
		 * <code>showFocus()</code>, call this function to hide it.
		 *
		 * <p><strong>Important:</strong> This function will not clear focus
		 * from the display object if it has focus. To clear focus from the
		 * display object, you should set the <code>focus</code> property on
		 * the focus manager to <code>null</code> or another display object.</p>
		 *
		 * @see #showFocus()
		 * @see feathers.core.IFocusManager#focus
		 */
		function hideFocus():void;
	}
}


================================================
FILE: source/feathers/core/IFocusExtras.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import starling.display.DisplayObject;

	/**
	 * A container that may have extra children that aren't accessible from the
	 * standard display list functions like <code>getChildAt()</code>, but those
	 * "extra" children may still need to receive focus. An example of this
	 * would be a container with "chrome", such as <code>feathers.controls.Panel</code>.
	 *
	 * @see ../../../help/focus.html Keyboard focus management in Feathers
	 *
	 * @productversion Feathers 1.2.0
	 */
	public interface IFocusExtras
	{
		/**
		 * Extra display objects that are not accessible through standard
		 * display list functions like <code>getChildAt()</code>, but should
		 * appear before those children in the focus order. Typically, this is
		 * for containers that have chrome that is hidden from the normal
		 * display list API.
		 *
		 * <p>May return <code>null</code> if there are no extra children.</p>
		 */
		function get focusExtrasBefore():Vector.<DisplayObject>;

		/**
		 * Extra display objects that are not accessible through standard
		 * display list functions like <code>getChildAt()</code>, but should
		 * appear after those children in the focus order. Typically, this is
		 * for containers that have chrome that is hidden from the normal
		 * display list API.
		 *
		 * <p>May return <code>null</code> if there are no extra children.</p>
		 */
		function get focusExtrasAfter():Vector.<DisplayObject>;
	}
}


================================================
FILE: source/feathers/core/IFocusManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import feathers.core.IFeathersEventDispatcher;

	import starling.display.DisplayObjectContainer;

	/**
	 * Dispatched when the value of the <code>focus</code> property changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 *
	 * @see #focus
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Interface for focus management.
	 *
	 * @see ../../../help/focus.html Keyboard focus management in Feathers
	 * @see feathers.core.FocusManager
	 * @see feathers.core.IFocusDisplayObject
	 *
	 * @productversion Feathers 1.1.0
	 */
	public interface IFocusManager extends IFeathersEventDispatcher
	{
		/**
		 * Determines if this focus manager is enabled. A focus manager may be
		 * disabled when another focus manager has control, such as when a
		 * modal pop-up is displayed.
		 */
		function get isEnabled():Boolean;

		/**
		 * @private
		 */
		function set isEnabled(value:Boolean):void;

		/**
		 * The object that currently has focus. May return <code>null</code> if
		 * no object has focus.
		 *
		 * <p>In the following example, the focus is changed:</p>
		 *
		 * <listing version="3.0">
		 * focusManager.focus = someObject;</listing>
		 */
		function get focus():IFocusDisplayObject;

		/**
		 * @private
		 */
		function set focus(value:IFocusDisplayObject):void;

		/**
		 * The top-level container of the focus manager. This isn't necessarily
		 * the root of the display list.
		 */
		function get root():DisplayObjectContainer;
	}
}


================================================
FILE: source/feathers/core/IGroupedToggle.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	/**
	 * A toggle associated with a specific group.
	 *
	 * @see ToggleGroup
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface IGroupedToggle extends IToggle
	{
		/**
		 * When the toggle is added to a <code>ToggleGroup</code>, the group
		 * will manage the entire group's selection when one of the toggles in
		 * the group changes.
		 *
		 * <p>In the following example, a <code>Radio</code> is added to a <code>ToggleGroup</code>:</p>
		 *
		 * <listing version="3.0">
		 * var group:ToggleGroup = new ToggleGroup();
		 * group.addEventListener( Event.CHANGE, group_changeHandler );
		 * 
		 * var radio:Radio = new Radio();
		 * radio.toggleGroup = group;
		 * this.addChild( radio );</listing>
		 */
		function get toggleGroup():ToggleGroup;

		/**
		 * @private
		 */
		function set toggleGroup(value:ToggleGroup):void;
	}
}


================================================
FILE: source/feathers/core/IIMETextEditor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	/**
	 * @private
	 * A text editor that is compatible with <code>TextEditorIMEClient</code>.
	 *
	 * @see feathers.utils.text.TextEditorIMEClient
	 *
	 * @productversion Feathers 3.0.0
	 */
	public interface IIMETextEditor extends ITextEditor
	{
		/**
		 * The index where the selection is anchored. Will be equal to either
		 * <code>selectionBeginIndex</code> or <code>selectionEndIndex</code>.
		 *
		 * @see #selectionActiveIndex
		 */
		function get selectionAnchorIndex():int;

		/**
		 * The index where the selection is active.
		 *
		 * @see #selectionAnchorIndex
		 */
		function get selectionActiveIndex():int;
	}
}


================================================
FILE: source/feathers/core/IMeasureDisplayObject.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	/**
	 * A display object with extra measurement properties.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public interface IMeasureDisplayObject extends IFeathersDisplayObject
	{
		/**
		 * @copy feathers.core.FeathersControl#explicitWidth
		 */
		function get explicitWidth():Number;

		/**
		 * @copy feathers.core.FeathersControl#explicitMinWidth
		 */
		function get explicitMinWidth():Number;

		/**
		 * @copy feathers.core.FeathersControl#minWidth
		 */
		function get minWidth():Number;

		/**
		 * @private
		 */
		function set minWidth(value:Number):void;

		/**
		 * @copy feathers.core.FeathersControl#explicitMaxWidth
		 */
		function get explicitMaxWidth():Number;

		/**
		 * @copy feathers.core.FeathersControl#maxWidth
		 */
		function get maxWidth():Number;

		/**
		 * @private
		 */
		function set maxWidth(value:Number):void;

		/**
		 * @copy feathers.core.FeathersControl#explicitHeight
		 */
		function get explicitHeight():Number;

		/**
		 * @copy feathers.core.FeathersControl#explicitMinHeight
		 */
		function get explicitMinHeight():Number;

		/**
		 * @copy feathers.core.FeathersControl#minHeight
		 */
		function get minHeight():Number;

		/**
		 * @private
		 */
		function set minHeight(value:Number):void;

		/**
		 * @copy feathers.core.FeathersControl#explicitMaxHeight
		 */
		function get explicitMaxHeight():Number;

		/**
		 * @copy feathers.core.FeathersControl#maxHeight
		 */
		function get maxHeight():Number;

		/**
		 * @private
		 */
		function set maxHeight(value:Number):void;
	}
}


================================================
FILE: source/feathers/core/IMultilineTextEditor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	/**
	 * Handles the editing of text, and supports multiline editing. This is not
	 * a text editor intended for a <code>TextArea</code> component. Instead,
	 * its a text editor intended for a <code>TextInput</code> component and it
	 * is expected to provide its own scroll bars.
	 *
	 * @see feathers.controls.TextInput
	 * @see ../../../help/text-editors Introduction to Feathers text editors
	 *
	 * @productversion Feathers 2.0.0
	 */
	public interface IMultilineTextEditor extends ITextEditor
	{
		/**
		 * Indicates whether the text editor can display more than one line of
		 * text.
		 */
		function get multiline():Boolean;

		/**
		 * @private
		 */
		function set multiline(value:Boolean):void;
	}
}


================================================
FILE: source/feathers/core/INativeFocusOwner.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	/**
	 * If a Feathers component may receive focus, it may be associated with a
	 * display object on the native stage. The focus manager will automatically
	 * pass focus to the native focus.
	 *
	 * @see ../../../help/focus.html
	 *
	 * @productversion Feathers 2.2.0
	 */
	public interface INativeFocusOwner extends IFocusDisplayObject
	{
		/**
		 * An object external to Starling that must be given focus when this
		 * Feathers component is given focus by a focus manager.
		 *
		 * <p>This property may return <code>null</code>. When it returns
		 * <code>null</code>, the focus manager should treat this display object
		 * like any other display object that may receive focus but doesn't
		 * implement <code>INativeFocusOwner</code>.</p>
		 *
		 * <p>If this property doesn't return a
		 * <code>flash.display.InteractiveObject</code>, the class must also
		 * implement <code>IAdvancedNativeFocusOwner</code>.</p>
		 *
		 * @see feathers.core.IAdvancedNativeFocusOwner
		 */
		function get nativeFocus():Object;
	}
}


================================================
FILE: source/feathers/core/IPopUpManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;

	/**
	 * Interface for pop-up management.
	 *
	 * @see feathers.core.PopUpManager
	 *
	 * @productversion Feathers 1.3.0
	 */
	public interface IPopUpManager
	{
		/**
		 * @copy PopUpManager#overlayFactory
		 */
		function get overlayFactory():Function;

		/**
		 * @private
		 */
		function set overlayFactory(value:Function):void;

		/**
		 * @copy PopUpManager#root
		 */
		function get root():DisplayObjectContainer;

		/**
		 * @private
		 */
		function set root(value:DisplayObjectContainer):void;

		/**
		 * @copy PopUpManager#popUpCount
		 */
		function get popUpCount():int;

		/**
		 * @copy PopUpManager#addPopUp()
		 */
		function addPopUp(popUp:DisplayObject, isModal:Boolean = true, isCentered:Boolean = true, customOverlayFactory:Function = null):DisplayObject;

		/**
		 * @copy PopUpManager#removePopUp()
		 */
		function removePopUp(popUp:DisplayObject, dispose:Boolean = false):DisplayObject;

		/**
		 * @copy PopUpManager#removeAllPopUps()
		 */
		function removeAllPopUps(dispose:Boolean = false):void;

		/**
		 * @copy PopUpManager#isPopUp()
		 */
		function isPopUp(popUp:DisplayObject):Boolean;

		/**
		 * @copy PopUpManager#isTopLevelPopUp()
		 */
		function isTopLevelPopUp(popUp:DisplayObject):Boolean;

		/**
		 * @copy PopUpManager#centerPopUp()
		 */
		function centerPopUp(popUp:DisplayObject):void;
	}
}


================================================
FILE: source/feathers/core/IStateContext.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	/**
	 * Dispatched when the display object's state changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.STATE_CHANGE
	 */
	[Event(name="stateChange",type="starling.events.Event")]

	/**
	 * An object with multiple states.
	 *
	 * @productversion Feathers 2.3.0
	 */
	public interface IStateContext extends IFeathersEventDispatcher
	{
		/**
		 * The object's current state.
		 *
		 * @see #event:stateChange feathers.events.FeathersEventType.STATE_CHANGE
		 */
		function get currentState():String;
	}
}


================================================
FILE: source/feathers/core/IStateObserver.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	/**
	 * Watches an <code>IStateContext</code> for state changes.
	 *
	 * @see feathers.core.IStateContext
	 *
	 * @productversion Feathers 2.3.0
	 */
	public interface IStateObserver
	{
		/**
		 * The current state context that is being observed.
		 */
		function get stateContext():IStateContext;

		/**
		 * @private
		 */
		function set stateContext(value:IStateContext):void;
	}
}


================================================
FILE: source/feathers/core/ITextBaselineControl.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	/**
	 * A UI control with text that has a baseline.
	 *
	 * @productversion Feathers 2.0.0
	 */
	public interface ITextBaselineControl extends IFeathersControl
	{
		/**
		 * Returns the text baseline measurement, in pixels.
		 */
		function get baseline():Number;
	}
}


================================================
FILE: source/feathers/core/ITextEditor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import feathers.text.FontStylesSet;

	import flash.geom.Point;

	/**
	 * Dispatched when the text property changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #text
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the user presses the Enter key while the editor has focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.ENTER
	 */
	[Event(name="enter",type="starling.events.Event")]

	/**
	 * Dispatched when the text editor receives focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_IN
	 */
	[Event(name="focusIn",type="starling.events.Event")]

	/**
	 * Dispatched when the text editor loses focus.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.FOCUS_OUT
	 */
	[Event(name="focusOut",type="starling.events.Event")]

	/**
	 * Dispatched when the soft keyboard is activated. Not all text editors will
	 * activate a soft keyboard.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.SOFT_KEYBOARD_ACTIVATE
	 */
	[Event(name="softKeyboardActivate",type="starling.events.Event")]

	/**
	 * Dispatched when the soft keyboard is deactivated. Not all text editors
	 * will activate a soft keyboard.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.SOFT_KEYBOARD_DEACTIVATE
	 */
	[Event(name="softKeyboardDectivate",type="starling.events.Event")]

	/**
	 * Handles the editing of text.
	 *
	 * @see feathers.controls.TextInput
	 * @see ../../../help/text-editors.html Introduction to Feathers text editors
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface ITextEditor extends IFeathersControl, ITextBaselineControl
	{
		/**
		 * The text displayed by the editor.
		 */
		function get text():String;

		/**
		 * @private
		 */
		function set text(value:String):void;

		/**
		 * Determines if the entered text will be masked so that it cannot be
		 * seen, such as for a password input.
		 */
		function get displayAsPassword():Boolean;

		/**
		 * @private
		 */
		function set displayAsPassword(value:Boolean):void;

		/**
		 * The maximum number of characters that may be entered.
		 */
		function get maxChars():int;

		/**
		 * @private
		 */
		function set maxChars(value:int):void;

		/**
		 * Limits the set of characters that may be entered.
		 */
		function get restrict():String;

		/**
		 * @private
		 */
		function set restrict(value:String):void;

		/**
		 * Determines if the text is editable.
		 *
		 * @see #isSelectable
		 */
		function get isEditable():Boolean;

		/**
		 * @private
		 */
		function set isEditable(value:Boolean):void;

		/**
		 * If the <code>isEditable</code> property is set to <code>false</code>,
		 * the <code>isSelectable</code> property determines if the text is
		 * selectable. If the <code>isEditable</code> property is set to
		 * <code>true</code>, the text will always be selectable.
		 *
		 * @see #isEditable
		 */
		function get isSelectable():Boolean;

		/**
		 * @private
		 */
		function set isSelectable(value:Boolean):void;

		/**
		 * Determines if the owner should call <code>setFocus()</code> on
		 * <code>TouchPhase.ENDED</code> or on <code>TouchPhase.BEGAN</code>.
		 * This is a hack because <code>StageText</code> doesn't like being
		 * assigned focus on <code>TouchPhase.BEGAN</code>. In general, most
		 * text editors should simply return <code>false</code>.
		 *
		 * @see #setFocus()
		 */
		function get setTouchFocusOnEndedPhase():Boolean;

		/**
		 * The index of the first character of the selection. If no text is
		 * selected, then this is the value of the caret index. This value will
		 * always be smaller than <code>selectionEndIndex</code>.
		 *
		 * @see #selectionEndIndex
		 */
		function get selectionBeginIndex():int;

		/**
		 * The index of the last character of the selection. If no text is
		 * selected, then this is the value of the caret index. This value will
		 * always be larger than <code>selectionBeginIndex</code>.
		 *
		 * @see #selectionBeginIndex
		 */
		function get selectionEndIndex():int;

		/**
		 * The internal font styles used to render the text that are passed down
		 * from the parent component. Generally, most developers will set font
		 * styles on the parent component.
		 *
		 * <p>Warning: The <code>fontStyles</code> property may be ignored if
		 * more advanced styles defined by the text renderer implementation have
		 * been set.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 */
		function get fontStyles():FontStylesSet;

		/**
		 * @private
		 */
		function set fontStyles(value:FontStylesSet):void;

		/**
		 * Gives focus to the text editor. Includes an optional position which
		 * may be used by the text editor to determine the cursor position. The
		 * position may be outside of the editors bounds.
		 */
		function setFocus(position:Point = null):void;

		/**
		 * Removes focus from the text editor.
		 */
		function clearFocus():void;

		/**
		 * Sets the range of selected characters. If both values are the same,
		 * the text insertion position is changed and nothing is selected.
		 */
		function selectRange(startIndex:int, endIndex:int):void;

		/**
		 * Measures the text's bounds (without a full validation, if
		 * possible).
		 */
		function measureText(result:Point = null):Point;
	}
}


================================================
FILE: source/feathers/core/ITextRenderer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import feathers.text.FontStylesSet;

	import flash.geom.Point;

	/**
	 * Interface that handles common capabilities of rendering text.
	 *
	 * @see ../../../help/text-renderers.html Introduction to Feathers text renderers
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface ITextRenderer extends IStateObserver, IFeathersControl, ITextBaselineControl
	{
		/**
		 * The text to render.
		 *
		 * <p>If using the <code>Label</code> component, this property should
		 * be set on the <code>Label</code>, and it will be passed down to the
		 * text renderer.</p>
		 */
		function get text():String;

		/**
		 * @private
		 */
		function set text(value:String):void;

		/**
		 * Determines if the text wraps to the next line when it reaches the
		 * width (or max width) of the component.
		 *
		 * <p> This property is sometimes controlled by the parent component,
		 * such as on a <code>Label</code> component. If using the
		 * <code>Label</code> component, this property must be set on the
		 * <code>Label</code>, and it will be passed down to the text renderer
		 * automatically.</p>
		 */
		function get wordWrap():Boolean;

		/**
		 * @private
		 */
		function set wordWrap(value:Boolean):void;

		/**
		 * The number of text lines in the text renderer. The text renderer may
		 * contain multiple text lines if the text contains line breaks or if
		 * the <code>wordWrap</code> property is enabled.
		 */
		function get numLines():int;

		/**
		 * The internal font styles used to render the text that are passed down
		 * from the parent component. Generally, most developers will set font
		 * styles on the parent component.
		 *
		 * <p>Warning: The <code>fontStyles</code> property may be ignored if
		 * more advanced styles defined by the text renderer implementation have
		 * been set.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 */
		function get fontStyles():FontStylesSet;

		/**
		 * @private
		 */
		function set fontStyles(value:FontStylesSet):void;

		/**
		 * Measures the text's bounds (without a full validation, if
		 * possible).
		 */
		function measureText(result:Point = null):Point;
	}
}


================================================
FILE: source/feathers/core/IToggle.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	/**
	 * Dispatched when the selection changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #isSelected
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * An interface for something that may be selected.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface IToggle extends IFeathersControl
	{
		/**
		 * Indicates if the IToggle is selected or not.
		 */
		function get isSelected():Boolean;

		/**
		 * @private
		 */
		function set isSelected(value:Boolean):void;
	}
}

================================================
FILE: source/feathers/core/IToolTip.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	/**
	 * An interface for tool tips created by the tool tip manager.
	 *
	 * @see ../../../help/tool-tips.html Tool tips in Feathers
	 * @see feathers.core.ToolTipManager
	 *
	 * @productversion Feathers 3.0.0
	 */
	public interface IToolTip extends IFeathersControl
	{
		/**
		 * The text to display in the tool tip.
		 */
		function get text():String;

		/**
		 * @private
		 */
		function set text(value:String):void;
	}
}


================================================
FILE: source/feathers/core/IToolTipManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	/**
	 * Interface for tool tip management.
	 *
	 * @see ../../../help/tool-tips.html Tool tips in Feathers
	 * @see feathers.core.ToolTipManager
	 *
	 * @productversion Feathers 3.0.0
	 */
	public interface IToolTipManager
	{
		/**
		 * Cleans up event listeners and display objects used by the tool tip
		 * manager.
		 */
		function dispose():void;
	}
}


================================================
FILE: source/feathers/core/IValidating.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	/**
	 * A display object that supports validation. Display objects of this type
	 * will delay updating after property changes until just before Starling
	 * renders the display list to avoid running redundant code.
	 *
	 * @productversion Feathers 1.3.0
	 */
	public interface IValidating extends IFeathersDisplayObject
	{
		/**
		 * The component's depth in the display list, relative to the stage. If
		 * the component isn't on the stage, its depth will be <code>-1</code>.
		 *
		 * <p>Used by the validation system to validate components from the
		 * top down.</p>
		 */
		function get depth():int;

		/**
		 * Immediately validates the display object, if it is invalid. The
		 * validation system exists to postpone updating a display object after
		 * properties are changed until until the last possible moment the
		 * display object is rendered. This allows multiple properties to be
		 * changed at a time without requiring a full update every time.
		 */
		function validate():void;
	}
}


================================================
FILE: source/feathers/core/PopUpManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import flash.utils.Dictionary;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;

	/**
	 * Adds a display object as a pop-up above all content.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class PopUpManager
	{
		/**
		 * @private
		 */
		protected static const _starlingToPopUpManager:Dictionary = new Dictionary(true);

		/**
		 * The default factory that creates a pop-up manager.
		 *
		 * @see feathers.core.DefaultPopUpManager
		 */
		public static function defaultPopUpManagerFactory():IPopUpManager
		{
			return new DefaultPopUpManager();
		}

		/**
		 * Returns the <code>IPopUpManager</code> associated with the specified
		 * <code>Starling</code> instance. If a pop-up manager hasn't been
		 * created yet, it will be created using <code>PopUpManager.popUpManagerFactory</code>.
		 *
		 * <p>In the following example, a pop-up is added:</p>
		 *
		 * <listing version="3.0">
		 * PopUpManager.forStarling( Starling.current ).addPopUp( popUp );</listing>
		 *
		 * @see #popUpManagerFactory
		 */
		public static function forStarling(starling:Starling):IPopUpManager
		{
			if(!starling)
			{
				throw new ArgumentError("PopUpManager not found. Starling cannot be null.");
			}
			var popUpManager:IPopUpManager = _starlingToPopUpManager[starling];
			if(!popUpManager)
			{
				var factory:Function = PopUpManager.popUpManagerFactory;
				if(factory === null)
				{
					factory = PopUpManager.defaultPopUpManagerFactory;
				}
				popUpManager = factory();
				//this allows the factory to optionally set the root, but it
				//also enforces the root being on the correct stage.
				if(!popUpManager.root || !starling.stage.contains(popUpManager.root))
				{
					popUpManager.root = Starling.current.stage;
				}
				PopUpManager._starlingToPopUpManager[starling] = popUpManager;
			}
			return popUpManager;
		}

		/**
		 * A function that creates a pop-up manager.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 * <pre>function():IPopUpManager</pre>
		 *
		 * <p>In the following example, the overlay factory is changed:</p>
		 *
		 * <listing version="3.0">
		 * PopUpManager.popUpManagerFactory = function():IPopUpManager
		 * {
		 *     var popUpManager:DefaultPopUpManager = new DefaultPopUpManager();
		 *     popUpManager.overlayFactory = function():DisplayObject
		 *     {
		 *         var overlay:Quad = new Quad( 100, 100, 0x000000 );
		 *         overlay.alpha = 0.75;
		 *         return overlay;
		 *     };
		 *     return popUpManager;
		 * };</listing>
		 *
		 * @see feathers.core.IPopUpManager
		 */
		public static var popUpManagerFactory:Function = defaultPopUpManagerFactory;

		/**
		 * A function that returns a display object to use as an overlay for
		 * modal pop-ups.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 * <pre>function():DisplayObject</pre>
		 *
		 * <p>In the following example, the overlay factory is changed:</p>
		 *
		 * <listing version="3.0">
		 * PopUpManager.overlayFactory = function():DisplayObject
		 * {
		 *     var overlay:Quad = new Quad( 100, 100, 0x000000 );
		 *     overlay.alpha = 0.75;
		 *     return overlay;
		 * };</listing>
		 */
		public static function get overlayFactory():Function
		{
			return PopUpManager.forStarling(Starling.current).overlayFactory;
		}

		/**
		 * @private
		 */
		public static function set overlayFactory(value:Function):void
		{
			PopUpManager.forStarling(Starling.current).overlayFactory = value;
		}

		/**
		 * The default factory that creates overlays for modal pop-ups. Creates
		 * an invisible <code>Quad</code>.
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/Quad.html starling.display.Quad
		 */
		public static function defaultOverlayFactory():DisplayObject
		{
			return DefaultPopUpManager.defaultOverlayFactory();
		}

		/**
		 * The container where pop-ups are added. If not set manually, defaults
		 * to the Starling stage.
		 *
		 * <p>In the following example, the next tab focus is changed:</p>
		 *
		 * <listing version="3.0">
		 * PopUpManager.root = someSprite;</listing>
		 *
		 * @default null
		 */
		public static function get root():DisplayObjectContainer
		{
			return PopUpManager.forStarling(Starling.current).root;
		}

		/**
		 * @private
		 */
		public static function set root(value:DisplayObjectContainer):void
		{
			PopUpManager.forStarling(Starling.current).root = value;
		}

		/**
		 * The current number of pop-ups.
		 *
		 * <p>In the following example, we check the number of pop-ups:</p>
		 *
		 * <listing version="3.0">
		 * if( PopUpManager.popUpCount > 0 )
		 * {
		 *     // do something
		 * }</listing>
		 */
		public static function get popUpCount():int
		{
			return PopUpManager.forStarling(Starling.current).popUpCount;
		}

		/**
		 * Adds a pop-up to the stage.
		 *
		 * <p>The pop-up may be modal, meaning that an overlay will be displayed
		 * between the pop-up and everything under the pop-up manager, and the
		 * overlay will block touches. The default overlay used for modal
		 * pop-ups is created by <code>PopUpManager.overlayFactory</code>. A
		 * custom overlay factory may be passed to <code>PopUpManager.addPopUp()</code>
		 * to create an overlay that is different from the default one.</p>
		 *
		 * <p>A pop-up may be centered globally on the Starling stage. If the
		 * stage or the pop-up resizes, the pop-up will be repositioned to
		 * remain in the center. To position a pop-up in the center once,
		 * specify a value of <code>false</code> when calling
		 * <code>PopUpManager.addPopUp()</code> and call
		 * <code>PopUpManager.centerPopUp()</code> manually.</p>
		 *
		 * <p>Note: The pop-up manager can only detect if Feathers components
		 * have been resized in order to reposition them to remain centered.
		 * Regular Starling display objects do not dispatch a proper resize
		 * event that the pop-up manager can listen to.</p>
		 */
		public static function addPopUp(popUp:DisplayObject, isModal:Boolean = true, isCentered:Boolean = true, customOverlayFactory:Function = null):DisplayObject
		{
			return PopUpManager.forStarling(Starling.current).addPopUp(popUp, isModal, isCentered, customOverlayFactory);
		}

		/**
		 * Removes a pop-up from the stage.
		 */
		public static function removePopUp(popUp:DisplayObject, dispose:Boolean = false):DisplayObject
		{
			return PopUpManager.forStarling(Starling.current).removePopUp(popUp, dispose);
		}

		/**
		 * Removes all pop-ups from the stage.
		 */
		public static function removeAllPopUps(dispose:Boolean = false):void
		{
			PopUpManager.forStarling(Starling.current).removeAllPopUps(dispose);
		}

		/**
		 * Determines if a display object is a pop-up.
		 *
		 * <p>In the following example, we check if a display object is a pop-up:</p>
		 *
		 * <listing version="3.0">
		 * if( PopUpManager.isPopUp( displayObject ) )
		 * {
		 *     // do something
		 * }</listing>
		 */
		public static function isPopUp(popUp:DisplayObject):Boolean
		{
			return PopUpManager.forStarling(Starling.current).isPopUp(popUp);
		}

		/**
		 * Determines if a display object is above the highest modal overlay. If
		 * there are no modals overlays, determines if a display object is a
		 * pop-up.
		 */
		public static function isTopLevelPopUp(popUp:DisplayObject):Boolean
		{
			return PopUpManager.forStarling(Starling.current).isTopLevelPopUp(popUp);
		}

		/**
		 * Centers a pop-up on the stage. Unlike the <code>isCentered</code>
		 * argument passed to <code>PopUpManager.addPopUp()</code>, the pop-up
		 * will only be positioned once. If the stage or the pop-up resizes,
		 * <code>PopUpManager.centerPopUp()</code> will need to be called again
		 * if it should remain centered.
		 *
		 * <p>In the following example, we center a pop-up:</p>
		 *
		 * <listing version="3.0">
		 * PopUpManager.centerPopUp( displayObject );</listing>
		 */
		public static function centerPopUp(popUp:DisplayObject):void
		{
			PopUpManager.forStarling(Starling.current).centerPopUp(popUp);
		}
	}
}


================================================
FILE: source/feathers/core/PropertyProxy.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import flash.utils.Proxy;
	import flash.utils.flash_proxy;

	/**
	 * Detects when its own properties have changed and dispatches an event
	 * to notify listeners.
	 *
	 * <p>Supports nested <code>PropertyProxy</code> instances using attribute
	 * <code>&#64;</code> notation. Placing an <code>&#64;</code> before a property name
	 * is like saying, "If this nested <code>PropertyProxy</code> doesn't exist
	 * yet, create one. If it does, use the existing one."</p>
	 *
	 * @productversion Feathers 1.0.0
	 */
	public final dynamic class PropertyProxy extends Proxy
	{
		/**
		 * Creates a <code>PropertyProxy</code> from a regular old <code>Object</code>.
		 */
		public static function fromObject(source:Object, onChangeCallback:Function = null):PropertyProxy
		{
			var newValue:PropertyProxy = new PropertyProxy(onChangeCallback);
			for(var propertyName:String in source)
			{
				newValue[propertyName] = source[propertyName];
			}
			return newValue;
		}

		/**
		 * Constructor.
		 */
		public function PropertyProxy(onChangeCallback:Function = null)
		{
			if(onChangeCallback != null)
			{
				this._onChangeCallbacks[this._onChangeCallbacks.length] = onChangeCallback;
			}
		}

		/**
		 * @private
		 */
		private var _subProxyName:String;

		/**
		 * @private
		 */
		private var _onChangeCallbacks:Vector.<Function> = new <Function>[];

		/**
		 * @private
		 */
		private var _names:Array = [];

		/**
		 * @private
		 */
		private var _storage:Object = {};

		/**
		 * @private
		 */
		override flash_proxy function hasProperty(name:*):Boolean
		{
			return this._storage.hasOwnProperty(name);
		}

		/**
		 * @private
		 */
		override flash_proxy function getProperty(name:*):*
		{
			if(this.flash_proxy::isAttribute(name))
			{
				var nameAsString:String = name is QName ? QName(name).localName : name.toString();
				if(!this._storage.hasOwnProperty(nameAsString))
				{
					var subProxy:PropertyProxy = new PropertyProxy(subProxy_onChange);
					subProxy._subProxyName = nameAsString;
					this._storage[nameAsString] = subProxy;
					this._names[this._names.length] = nameAsString;
					this.fireOnChangeCallback(nameAsString);
				}
				return this._storage[nameAsString];
			}
			return this._storage[name];
		}

		/**
		 * @private
		 */
		override flash_proxy function setProperty(name:*, value:*):void
		{
			var nameAsString:String = name is QName ? QName(name).localName : name.toString();
			this._storage[nameAsString] = value;
			if(this._names.indexOf(nameAsString) < 0)
			{
				this._names[this._names.length] = nameAsString;
			}
			this.fireOnChangeCallback(nameAsString);
		}

		/**
		 * @private
		 */
		override flash_proxy function deleteProperty(name:*):Boolean
		{
			var nameAsString:String = name is QName ? QName(name).localName : name.toString();
			var index:int = this._names.indexOf(nameAsString);
			if(index >= 0)
			{
				this._names.removeAt(index);
			}
			var result:Boolean = delete this._storage[nameAsString];
			if(result)
			{
				this.fireOnChangeCallback(nameAsString);
			}
			return result;
		}

		/**
		 * @private
		 */
		override flash_proxy function nextNameIndex(index:int):int
		{
			if(index < this._names.length)
			{
				return index + 1;
			}
			return 0;
		}

		/**
		 * @private
		 */
		override flash_proxy function nextName(index:int):String
		{
			return this._names[index - 1];
		}

		/**
		 * @private
		 */
		override flash_proxy function nextValue(index:int):*
		{
			var name:* = this._names[index - 1];
			return this._storage[name];
		}

		/**
		 * Adds a callback to react to property changes.
		 */
		public function addOnChangeCallback(callback:Function):void
		{
			this._onChangeCallbacks[this._onChangeCallbacks.length] = callback;
		}

		/**
		 * Removes a callback.
		 */
		public function removeOnChangeCallback(callback:Function):void
		{
			var index:int = this._onChangeCallbacks.indexOf(callback);
			if(index < 0)
			{
				return;
			}
			if(index == 0)
			{
				this._onChangeCallbacks.shift();
				return;
			}
			var lastIndex:int = this._onChangeCallbacks.length - 1;
			if(index == lastIndex)
			{
				this._onChangeCallbacks.pop();
				return;
			}
			this._onChangeCallbacks.removeAt(index);
		}

		/**
		 * @private
		 */
		public function toString():String
		{
			var result:String = "[object PropertyProxy";
			for(var propertyName:String in this)
			{
				result += " " + propertyName;
			}
			return result + "]";
		}

		/**
		 * @private
		 */
		private function fireOnChangeCallback(forName:String):void
		{
			var callbackCount:int = this._onChangeCallbacks.length;
			for(var i:int = 0; i < callbackCount; i++)
			{
				var callback:Function = this._onChangeCallbacks[i] as Function;
				callback(this, forName);
			}
		}

		/**
		 * @private
		 */
		private function subProxy_onChange(proxy:PropertyProxy, name:String):void
		{
			this.fireOnChangeCallback(proxy._subProxyName);
		}
	}
}


================================================
FILE: source/feathers/core/ToggleGroup.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import flash.errors.IllegalOperationError;

	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when the selection changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Controls the selection of two or more IToggle instances where only one
	 * may be selected at a time.
	 *
	 * @see IToggle
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class ToggleGroup extends EventDispatcher
	{
		/**
		 * Constructor.
		 */
		public function ToggleGroup()
		{
			super();
		}

		/**
		 * @private
		 */
		protected var _items:Vector.<IToggle> = new Vector.<IToggle>;

		/**
		 * @private
		 */
		protected var _ignoreChanges:Boolean = false;

		/**
		 * @private
		 */
		protected var _isSelectionRequired:Boolean = true;

		/**
		 * Determines if the user can deselect the currently selected item or
		 * not. The selection may always be cleared programmatically by setting
		 * the selected index to <code>-1</code> or the selected item to
		 * <code>null</code>.
		 *
		 * <p>If <code>isSelectionRequired</code> is set to <code>true</code>
		 * and the toggle group has items that were added previously, and there
		 * is no currently selected item, the item at index <code>0</code> will
		 * be selected automatically.</p>
		 *
		 * <p>In the following example, selection is not required:</p>
		 *
		 * <listing version="3.0">
		 * group.isSelectionRequired = false;</listing>
		 *
		 * @default true
		 */
		public function get isSelectionRequired():Boolean
		{
			return this._isSelectionRequired;
		}

		/**
		 * @private
		 */
		public function set isSelectionRequired(value:Boolean):void
		{
			if(this._isSelectionRequired == value)
			{
				return;
			}
			this._isSelectionRequired = value;
			if(this._isSelectionRequired && this._selectedIndex < 0 && this._items.length > 0)
			{
				this.selectedIndex = 0;
			}
		}

		/**
		 * The currently selected toggle.
		 *
		 * <p>In the following example, the selected item is changed:</p>
		 *
		 * <listing version="3.0">
		 * group.selectedItem = radio;</listing>
		 *
		 * @default null
		 */
		public function get selectedItem():IToggle
		{
			if(this._selectedIndex < 0)
			{
				return null;
			}
			return this._items[this._selectedIndex];
		}

		/**
		 * @private
		 */
		public function set selectedItem(value:IToggle):void
		{
			this.selectedIndex = this._items.indexOf(value);
		}

		/**
		 * @private
		 */
		protected var _selectedIndex:int = -1;

		/**
		 * The index of the currently selected toggle.
		 *
		 * <p>In the following example, the selected index is changed:</p>
		 *
		 * <listing version="3.0">
		 * group.selectedIndex = 2;</listing>
		 *
		 * @default -1
		 */
		public function get selectedIndex():int
		{
			return this._selectedIndex;
		}

		/**
		 * @private
		 */
		public function set selectedIndex(value:int):void
		{
			var itemCount:int = this._items.length;
			if(value < -1 || value >= itemCount)
			{
				throw new RangeError("Index " + value + " is out of range " + itemCount + " for ToggleGroup.");
			}
			var hasChanged:Boolean = this._selectedIndex != value;
			this._selectedIndex = value;

			//refresh all the items
			var oldIgnoreChanges:Boolean = this._ignoreChanges;
			this._ignoreChanges = true;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:IToggle = this._items[i];
				item.isSelected = i == value;
			}
			this._ignoreChanges = oldIgnoreChanges;
			if(hasChanged)
			{
				//only dispatch if there's been a change. we didn't return
				//early because this setter could be called if an item is
				//unselected. if selection is required, we need to reselect the
				//item (happens below in the item's onChange listener).
				this.dispatchEventWith(Event.CHANGE);
			}
		}

		/**
		 * The number of items added to the group.
		 */
		public function get numItems():int
		{
			return this._items.length;
		}

		/**
		 * Adds a toggle to the group. If it is the first item added to the
		 * group, and <code>isSelectionRequired</code> is <code>true</code>, it
		 * will be selected automatically.
		 *
		 * <p>In the following example, an item is added to the toggle group:</p>
		 *
		 * <listing version="3.0">
		 * group.addItem( radio );</listing>
		 */
		public function addItem(item:IToggle):void
		{
			if(!item)
			{
				throw new ArgumentError("IToggle passed to ToggleGroup addItem() must not be null.");
			}

			var index:int = this._items.indexOf(item);
			if(index >= 0)
			{
				throw new IllegalOperationError("Cannot add an item to a ToggleGroup more than once.");
			}
			this._items.push(item);
			if(this._selectedIndex < 0 && this._isSelectionRequired)
			{
				this.selectedItem = item;
			}
			else
			{
				item.isSelected = false;
			}
			item.addEventListener(Event.CHANGE, item_changeHandler);

			if(item is IGroupedToggle)
			{
				IGroupedToggle(item).toggleGroup = this;
			}
		}

		/**
		 * Removes a toggle from the group. If the item being removed is
		 * selected and <code>isSelectionRequired</code> is <code>true</code>,
		 * the final item will be selected. If <code>isSelectionRequired</code>
		 * is <code>false</code> instead, no item will be selected.
		 *
		 * <p>In the following example, an item is removed from the toggle group:</p>
		 *
		 * <listing version="3.0">
		 * group.removeItem( radio );</listing>
		 */
		public function removeItem(item:IToggle):void
		{
			var index:int = this._items.indexOf(item);
			if(index < 0)
			{
				return;
			}
			this._items.removeAt(index);
			item.removeEventListener(Event.CHANGE, item_changeHandler);
			if(item is IGroupedToggle)
			{
				IGroupedToggle(item).toggleGroup = null;
			}
			if(this._selectedIndex > index)
			{
				//the same item is selected, but its index has changed.
				this.selectedIndex -= 1;
			}
			else if(this._selectedIndex == index)
			{
				if(this._isSelectionRequired)
				{
					var maxSelectedIndex:int = this._items.length - 1;
					if(this._selectedIndex > maxSelectedIndex)
					{
						//we want to keep the same index, if possible, but if
						//we can't because it is too high, we should select the
						//next highest item.
						this.selectedIndex = maxSelectedIndex;
					}
					else
					{
						//we need to manually dispatch the change event because
						//the selected index hasn't changed, but the selected
						//item has changed.
						this.dispatchEventWith(Event.CHANGE);
					}
				}
				else
				{
					//selection isn't required, and we just removed the selected
					//item, so no item should be selected.
					this.selectedIndex = -1;
				}
			}
		}

		/**
		 * Removes all toggles from the group. No item will be selected.
		 *
		 * <p>In the following example, all items are removed from the toggle group:</p>
		 *
		 * <listing version="3.0">
		 * group.removeAllItems();</listing>
		 */
		public function removeAllItems():void
		{
			var itemCount:int = this._items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:IToggle = this._items.shift();
				item.removeEventListener(Event.CHANGE, item_changeHandler);
				if(item is IGroupedToggle)
				{
					IGroupedToggle(item).toggleGroup = null;
				}
			}
			this.selectedIndex = -1;
		}

		/**
		 * Determines if the group includes the specified item.
		 *
		 * <p>In the following example, we check if an item is in the toggle group:</p>
		 *
		 * <listing version="3.0">
		 * if( group.hasItem( radio ) )
		 * {
		 *     // do something
		 * }</listing>
		 */
		public function hasItem(item:IToggle):Boolean
		{
			var index:int = this._items.indexOf(item);
			return index >= 0;
		}

		/**
		 * Returns the item at the specified index. If the index is out of
		 * range, a <code>RangeError</code> will be thrown.
		 *
		 * <p>In the following example, an item's at a specific index is returned:</p>
		 *
		 * <listing version="3.0">
		 * var item:IToggle = group.getItemAt( 2 );</listing>
		 *
		 * @see #numItems
		 */
		public function getItemAt(index:int):IToggle
		{
			return this._items[index];
		}

		/**
		 * Returns the index of the specified item. Result will be <code>-1</code>
		 * if the item has not been added to the group.
		 *
		 * <p>In the following example, an item's index is calculated:</p>
		 *
		 * <listing version="3.0">
		 * var index:int = group.getItemIndex( radio );</listing>
		 */
		public function getItemIndex(item:IToggle):int
		{
			return this._items.indexOf(item);
		}

		/**
		 * Changes the index of a specified item. Throws an <code>ArgumentError</code>
		 * if the specified item hasn't already been added to this group.
		 *
		 * <p>In the following example, an item's index is changed:</p>
		 *
		 * <listing version="3.0">
		 * group.setItemIndex( radio, 2 );</listing>
		 */
		public function setItemIndex(item:IToggle, index:int):void
		{
			var oldIndex:int = this._items.indexOf(item);
			if(oldIndex < 0)
			{
				throw new ArgumentError("Attempting to set index of an item that has not been added to this ToggleGroup.");
			}
			if(oldIndex == index)
			{
				//no change needed
				return;
			}
			this._items.removeAt(oldIndex);
			this._items.insertAt(index, item);
			if(this._selectedIndex >= 0)
			{
				if(this._selectedIndex == oldIndex)
				{
					this.selectedIndex = index;
				}
				else if(oldIndex < this._selectedIndex && index > this._selectedIndex)
				{
					this.selectedIndex--;
				}
				else if(oldIndex > this._selectedIndex && index < this._selectedIndex)
				{
					this.selectedIndex++;
				}
			}
		}

		/**
		 * @private
		 */
		protected function item_changeHandler(event:Event):void
		{
			if(this._ignoreChanges)
			{
				return;
			}

			var item:IToggle = IToggle(event.currentTarget);
			var index:int = this._items.indexOf(item);
			if(item.isSelected || (this._isSelectionRequired && this._selectedIndex == index))
			{
				//don't let it deselect the item
				this.selectedIndex = index;
			}
			else if(!item.isSelected)
			{
				this.selectedIndex = -1;
			}
		}
	}
}

================================================
FILE: source/feathers/core/TokenList.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when a token is added, removed, or toggled or if all tokens
	 * have been replaced by setting the <code>value</code> property.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * A list of space-delimited tokens. Obviously, since they are delimited by
	 * spaces, tokens cannot contain spaces.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class TokenList extends EventDispatcher
	{
		/**
		 * Constructor.
		 */
		public function TokenList()
		{
		}

		protected var _joinedNames:String = null;

		/**
		 * @private
		 * Storage for the tokens.
		 */
		protected var names:Vector.<String> = new <String>[];

		/**
		 * The tokens formatted with space delimiters.
		 *
		 * @default ""
		 */
		public function get value():String
		{
			if(this._joinedNames === null)
			{
				this._joinedNames = names.join(" ");
			}
			return this._joinedNames;
		}

		/**
		 * @private
		 */
		public function set value(value:String):void
		{
			if(this.value == value)
			{
				return;
			}
			this._joinedNames = value;
			this.names.length = 0;
			this.names = Vector.<String>(value.split(" "));
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * The number of tokens in the list.
		 */
		public function get length():int
		{
			return this.names.length;
		}

		/**
		 * Returns the token at the specified index, or null, if there is no
		 * token at that index.
		 */
		public function item(index:int):String
		{
			if(index < 0 || index >= this.names.length)
			{
				return null;
			}
			return this.names[index];
		}

		/**
		 * Adds a token to the list. If the token already appears in the list,
		 * it will not be added again.
		 */
		public function add(name:String):void
		{
			var index:int = this.names.indexOf(name);
			if(index >= 0)
			{
				return;
			}
			if(this._joinedNames !== null)
			{
				this._joinedNames += " " + name;
			}
			this.names[this.names.length] = name;

			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * Removes a token from the list, if the token is in the list. If the
		 * token doesn't appear in the list, this call does nothing.
		 */
		public function remove(name:String):void
		{
			var index:int = this.names.indexOf(name);
			this.removeAt(index);
		}

		/**
		 * The token is added to the list if it doesn't appear in the list, or
		 * it is removed from the list if it is already in the list.
		 */
		public function toggle(name:String):void
		{
			var index:int = this.names.indexOf(name);
			if(index < 0)
			{
				if(this._joinedNames !== null)
				{
					this._joinedNames += " " + name;
				}
				this.names[this.names.length] = name;
				this.dispatchEventWith(Event.CHANGE);
			}
			else
			{
				this.removeAt(index);
			}
		}

		/**
		 * Determines if the specified token is in the list.
		 */
		public function contains(name:String):Boolean
		{
			return this.names.indexOf(name) >= 0;
		}

		/**
		 * @private
		 */
		protected function removeAt(index:int):void
		{
			if(index < 0)
			{
				return;
			}
			this._joinedNames = null;
			this.names.removeAt(index);
			this.dispatchEventWith(Event.CHANGE);
		}

	}
}


================================================
FILE: source/feathers/core/ToolTipManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import flash.utils.Dictionary;

	import starling.display.DisplayObjectContainer;
	import starling.display.Stage;

	/**
	 * Manages tool tips. Should not be enabled on touch screens, since
	 * TouchPhase.HOVER is not dispatched for touches.
	 *
	 * @see ../../../help/tool-tips.html Tool tips in Feathers
	 * @see feathers.core.FeathersControl#toolTip
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class ToolTipManager
	{
		/**
		 * @private
		 */
		protected static const STAGE_TO_MANAGER:Dictionary = new Dictionary(true);

		/**
		 * Returns the active tool tip manager for the specified Starling stage.
		 * May return <code>null</code> if tool tip management has not been
		 * enabled for the specified stage.
		 *
		 * @see #isEnabledForStage()
		 * @see #setEnabledForStage()
		 */
		public static function getToolTipManagerForStage(stage:Stage):IToolTipManager
		{
			return IToolTipManager(STAGE_TO_MANAGER[stage]);
		}

		/**
		 * The default factory that creates a tool tip manager.
		 *
		 * @see #toolTipManagerFactory
		 * @see feathers.core.DefaultToolTipManager
		 */
		public static function defaultToolTipManagerFactory(root:DisplayObjectContainer):IToolTipManager
		{
			return new DefaultToolTipManager(root);
		}

		/**
		 * A function that creates a tool tip manager.
		 *
		 * <p>This function is expected to have the following signature:</p>
		 * <pre>function():IToolTipManager</pre>
		 *
		 * <p>In the following example, the tool tip manager factory is modified:</p>
		 *
		 * <listing version="3.0">
		 * ToolTipManager.toolTipManagerFactory = function(root:DisplayObjectContainer):IToolTipManager
		 * {
		 *     return new CustomToolTipManager(); //a custom class that implements IToolTipManager
		 * };</listing>
		 *
		 * @see feathers.core.IToolTipManager
		 */
		public static var toolTipManagerFactory:Function = defaultToolTipManagerFactory;

		/**
		 * Determines if the tool tip manager is enabled or disabled for the
		 * specified Starling stage.
		 *
		 * @see #setEnabledForStage()
		 * @see #getToolTipManagerForStage()
		 */
		public static function isEnabledForStage(stage:Stage):Boolean
		{
			return IToolTipManager(STAGE_TO_MANAGER[stage]) !== null;
		}

		/**
		 * Enables or disables toll tip management on the specified Starling
		 * stage. For mobile apps, the tool tip manager should generally remain
		 * disabled. For desktop apps, it is recommended to enable the tool tip
		 * manager.
		 *
		 * <p>In the following example, tool tip management is enabled:</p>
		 *
		 * <listing version="3.0">
		 * ToolTipManager.setEnabledForStage(stage, true);</listing>
		 *
		 * @see #isEnabledForStage()
		 * @see #getToolTipManagerForStage()
		 */
		public static function setEnabledForStage(stage:Stage, isEnabled:Boolean):void
		{
			var manager:IToolTipManager = IToolTipManager(STAGE_TO_MANAGER[stage]);
			if((isEnabled && manager) || (!isEnabled && !manager))
			{
				return;
			}
			if(isEnabled)
			{
				STAGE_TO_MANAGER[stage] = toolTipManagerFactory(stage);
			}
			else
			{
				manager.dispose();
				delete STAGE_TO_MANAGER[stage];
			}
		}

		/**
		 * Disables tool tip management on all stages where it has previously
		 * been enabled.
		 */
		public function disableAll():void
		{
			for(var key:Object in STAGE_TO_MANAGER)
			{
				var stage:Stage = Stage(key);
				var manager:IToolTipManager = IToolTipManager(STAGE_TO_MANAGER[stage]);
				manager.dispose();
				delete STAGE_TO_MANAGER[stage];
			}
		}
	}
}


================================================
FILE: source/feathers/core/ValidationQueue.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.core
{
	import flash.utils.Dictionary;

	import starling.animation.IAnimatable;
	import starling.core.Starling;

	[ExcludeClass]
	/**
	 * @private
	 *
	 * @productversion Feathers 1.0.0
	 */
	public final class ValidationQueue implements IAnimatable
	{
		/**
		 * @private
		 */
		private static const STARLING_TO_VALIDATION_QUEUE:Dictionary = new Dictionary(true);

		/**
		 * Gets the validation queue for the specified Starling instance. If
		 * a validation queue does not exist for the specified Starling
		 * instance, a new one will be created.
		 */
		public static function forStarling(starling:Starling):ValidationQueue
		{
			if(!starling)
			{
				return null;
			}
			var queue:ValidationQueue = STARLING_TO_VALIDATION_QUEUE[starling];
			if(!queue)
			{
				STARLING_TO_VALIDATION_QUEUE[starling] = queue = new ValidationQueue(starling);
			}
			return queue;
		}

		/**
		 * Constructor.
		 */
		public function ValidationQueue(starling:Starling)
		{
			this._starling = starling;
		}

		private var _starling:Starling;

		private var _isValidating:Boolean = false;

		/**
		 * If true, the queue is currently validating.
		 *
		 * <p>In the following example, we check if the queue is currently validating:</p>
		 *
		 * <listing version="3.0">
		 * if( queue.isValidating )
		 * {
		 *     // do something
		 * }</listing>
		 */
		public function get isValidating():Boolean
		{
			return this._isValidating;
		}

		private var _queue:Vector.<IValidating> = new <IValidating>[];

		/**
		 * Disposes the validation queue.
		 */
		public function dispose():void
		{
			if(this._starling)
			{
				this._starling.juggler.remove(this);
				this._starling = null;
			}
		}

		/**
		 * Adds a validating component to the queue.
		 */
		public function addControl(control:IValidating):void
		{
			//if the juggler was purged, we need to add the queue back in.
			if(!this._starling.juggler.contains(this))
			{
				this._starling.juggler.add(this);
			}
			if(this._queue.indexOf(control) >= 0)
			{
				//already queued
				return;
			}
			var queueLength:int = this._queue.length;
			if(this._isValidating)
			{
				//special case: we need to keep it sorted
				var depth:int = control.depth;

				//we're traversing the queue backwards because it's
				//significantly more likely that we're going to push than that
				//we're going to splice, so there's no point to iterating over
				//the whole queue
				for(var i:int = queueLength - 1; i >= 0; i--)
				{
					var otherControl:IValidating = IValidating(this._queue[i]);
					var otherDepth:int = otherControl.depth;
					//we can skip the overhead of calling queueSortFunction and
					//of looking up the value we've already stored in the depth
					//local variable.
					if(depth >= otherDepth)
					{
						break;
					}
				}
				//add one because we're going after the last item we checked
				//if we made it through all of them, i will be -1, and we want 0
				i++;
				this._queue.insertAt(i, control);
			}
			else
			{
				//faster than push() because push() creates a temporary rest
				//Array that needs to be garbage collected
				this._queue[queueLength] = control;
			}
		}

		/**
		 * @private
		 */
		public function advanceTime(time:Number):void
		{
			if(this._isValidating || !this._starling.contextValid)
			{
				return;
			}
			var queueLength:int = this._queue.length;
			if(queueLength == 0)
			{
				return;
			}
			this._isValidating = true;
			if(queueLength > 1)
			{
				//only sort if there's more than one item in the queue because
				//it will avoid allocating objects
				this._queue = this._queue.sort(queueSortFunction);
			}
			//rechecking length every time because addControl() might have added
			//a new item during the last validation.
			//we could use an int and check the length again at the end of the
			//loop, but there is little difference in performance, even with
			//millions of items in queue.
			while(this._queue.length > 0)
			{
				var item:IValidating = this._queue.shift();
				if(item.depth < 0)
				{
					//skip items that are no longer on the display list
					continue;
				}
				item.validate();
			}
			this._isValidating = false;
		}

		/**
		 * @private
		 * This is a static constant to avoid a MethodClosure allocation on iOS
		 */
		protected static const queueSortFunction:Function = function(first:IValidating, second:IValidating):int
		{
			var difference:int = second.depth - first.depth;
			if(difference > 0)
			{
				return -1;
			}
			else if(difference < 0)
			{
				return 1;
			}
			return 0;
		};
	}
}


================================================
FILE: source/feathers/data/ArrayChildrenHierarchicalCollectionDataDescriptor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	/**
	 * A hierarchical data descriptor where children are defined as arrays in a
	 * property defined on each branch. The property name defaults to <code>"children"</code>,
	 * but it may be customized.
	 *
	 * <p>The basic structure of the data source takes the following form. The
	 * root must always be an Array.</p>
	 * <pre>
	 * [
	 *     {
	 *         text: "Branch 1",
	 *         children:
	 *         [
	 *             { text: "Child 1-1" },
	 *             { text: "Child 1-2" }
	 *         ]
	 *     },
	 *     {
	 *         text: "Branch 2",
	 *         children:
	 *         [
	 *             { text: "Child 2-1" },
	 *             { text: "Child 2-2" },
	 *             { text: "Child 2-3" }
	 *         ]
	 *     }
	 * ]</pre>
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class ArrayChildrenHierarchicalCollectionDataDescriptor implements IHierarchicalCollectionDataDescriptor
	{
		/**
		 * Constructor.
		 */
		public function ArrayChildrenHierarchicalCollectionDataDescriptor()
		{
		}

		/**
		 * The field used to access the Array of a branch's children.
		 */
		public var childrenField:String = "children";

		/**
		 * @inheritDoc
		 */
		public function getLength(data:Object, ...rest:Array):int
		{
			var branch:Array = data as Array;
			var indexCount:int = rest.length;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = rest[i] as int;
				branch = branch[index][childrenField] as Array;
			}

			return branch.length;
		}

		/**
		 * @inheritDoc
		 */
		public function getLengthAtLocation(data:Object, location:Vector.<int> = null):int
		{
			var branch:Array = data as Array;
			if(location !== null)
			{
				var indexCount:int = location.length;
				for(var i:int = 0; i < indexCount; i++)
				{
					var index:int = location[i];
					branch = branch[index][childrenField] as Array;
				}
			}
			return branch.length;
		}

		/**
		 * @inheritDoc
		 */
		public function getItemAt(data:Object, index:int, ...rest:Array):Object
		{
			rest.insertAt(0, index);
			var branch:Array = data as Array;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				branch = branch[index][childrenField] as Array;
			}
			var lastIndex:int = rest[indexCount] as int;
			return branch[lastIndex];
		}

		/**
		 * @inheritDoc
		 */
		public function getItemAtLocation(data:Object, location:Vector.<int>):Object
		{
			if(location === null || location.length == 0)
			{
				return null;
			}
			var branch:Array = data as Array;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				branch = branch[index][childrenField] as Array;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + location);
				}
			}
			var lastIndex:int = location[indexCount];
			return branch[lastIndex];
		}

		/**
		 * @inheritDoc
		 */
		public function setItemAt(data:Object, item:Object, index:int, ...rest:Array):void
		{
			rest.insertAt(0, index);
			var branch:Array = data as Array;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				branch = branch[index][childrenField] as Array;
			}
			var lastIndex:int = rest[indexCount] as int;
			branch[lastIndex] = item;
		}

		/**
		 * @inheritDoc
		 */
		public function setItemAtLocation(data:Object, item:Object, location:Vector.<int>):void
		{
			if(location === null || location.length == 0)
			{
				throw new RangeError("Branch not found at location: " + location);
			}
			var branch:Array = data as Array;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				branch = branch[index][childrenField] as Array;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + location);
				}
			}
			var lastIndex:int = location[indexCount];
			branch[lastIndex] = item;
		}

		/**
		 * @inheritDoc
		 */
		public function addItemAt(data:Object, item:Object, index:int, ...rest:Array):void
		{
			rest.insertAt(0, index);
			var branch:Array = data as Array;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				branch = branch[index][childrenField] as Array;
			}
			var lastIndex:int = rest[indexCount] as int;
			branch.insertAt(lastIndex, item);
		}

		/**
		 * @inheritDoc
		 */
		public function addItemAtLocation(data:Object, item:Object, location:Vector.<int>):void
		{
			if(location === null || location.length == 0)
			{
				throw new RangeError("Branch not found at location: " + location);
			}
			var branch:Array = data as Array;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				branch = branch[index][childrenField] as Array;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + location);
				}
			}
			var lastIndex:int = location[indexCount];
			branch.insertAt(lastIndex, item);
		}

		/**
		 * @inheritDoc
		 */
		public function removeItemAt(data:Object, index:int, ...rest:Array):Object
		{
			rest.insertAt(0, index);
			var branch:Array = data as Array;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				branch = branch[index][childrenField] as Array;
			}
			var lastIndex:int = rest[indexCount] as int;
			return branch.removeAt(lastIndex);
		}

		/**
		 * @inheritDoc
		 */
		public function removeItemAtLocation(data:Object, location:Vector.<int>):Object
		{
			if(location === null || location.length == 0)
			{
				throw new RangeError("Branch not found at location: " + location);
			}
			var branch:Array = data as Array;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				branch = branch[index][childrenField] as Array;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + location);
				}
			}
			var lastIndex:int = location[indexCount];
			return branch.removeAt(lastIndex);
		}

		/**
		 * @inheritDoc
		 */
		public function removeAll(data:Object):void
		{
			var branch:Array = data as Array;
			branch.length = 0;
		}

		/**
		 * @inheritDoc
		 */
		public function getItemLocation(data:Object, item:Object, result:Vector.<int> = null, ...rest:Array):Vector.<int>
		{
			if(!result)
			{
				result = new <int>[];
			}
			else
			{
				result.length = 0;
			}
			var branch:Array = data as Array;
			var restCount:int = rest.length;
			for(var i:int = 0; i < restCount; i++)
			{
				var index:int = rest[i] as int;
				result[i] = index;
				branch = branch[index][childrenField] as Array;
			}

			var isFound:Boolean = this.findItemInBranch(branch, item, result);
			if(!isFound)
			{
				result.length = 0;
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function isBranch(node:Object):Boolean
		{
			if(node === null)
			{
				return false;
			}
			return node.hasOwnProperty(this.childrenField) && node[this.childrenField] is Array;
		}

		/**
		 * @private
		 */
		protected function findItemInBranch(branch:Array, item:Object, result:Vector.<int>):Boolean
		{
			var index:int = branch.indexOf(item);
			if(index >= 0)
			{
				result.push(index);
				return true;
			}

			var branchLength:int = branch.length;
			for(var i:int = 0; i < branchLength; i++)
			{
				var branchItem:Object = branch[i];
				if(this.isBranch(branchItem))
				{
					result.push(i);
					var isFound:Boolean = this.findItemInBranch(branchItem[childrenField] as Array, item, result);
					if(isFound)
					{
						return true;
					}
					result.pop();
				}
			}
			return false;
		}
	}
}


================================================
FILE: source/feathers/data/ArrayCollection.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import feathers.events.CollectionEventType;

	import starling.events.Event;
	import starling.events.EventDispatcher;

	[Exclude(name="data",kind="property")]

	/**
	 * Dispatched when the underlying data source changes and components will
	 * need to redraw the data.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the collection has changed drastically, such as when
	 * the underlying data source is replaced completely.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.RESET
	 */
	[Event(name="reset",type="starling.events.Event")]

	/**
	 * Dispatched when an item is added to the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * added. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.ADD_ITEM
	 */
	[Event(name="addItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is removed from the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * removed. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REMOVE_ITEM
	 */
	[Event(name="removeItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is replaced in the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * replaced. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REPLACE_ITEM
	 */
	[Event(name="replaceItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateItemAt()</code> function is called on the
	 * <code>ListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * updated. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateItemAt()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ITEM
	 */
	[Event(name="updateItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateAll()</code> function is called on the
	 * <code>ListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateAll()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ALL
	 */
	[Event(name="updateAll",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>filterFunction</code> property changes or the
	 * <code>refresh()</code> function is called on the <code>IListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #filterFunction
	 * @see #refresh()
	 *
	 * @eventType feathers.events.CollectionEventType.FILTER_CHANGE
	 */
	[Event(name="filterChange",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>sortCompareFunction</code> property changes or
	 * the <code>refresh()</code> function is called on the <code>IListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #sortCompareFunction
	 * @see #refresh()
	 *
	 * @eventType feathers.events.CollectionEventType.SORT_CHANGE
	 */
	[Event(name="sortChange",type="starling.events.Event")]

	/**
	 *
	 * Wraps an <code>Array</code> in the common <code>IListCollection</code>
	 * API used by many Feathers UI controls, including <code>List</code> and
	 * <code>TabBar</code>.
	 *
	 * @productversion Feathers 3.3.0
	 */
	public class ArrayCollection extends EventDispatcher implements IListCollection
	{
		/**
		 * Constructor
		 */
		public function ArrayCollection(data:Array = null)
		{
			if(data === null)
			{
				data = [];
			}
			this._arrayData = data;
		}

		/**
		 * @private
		 */
		protected var _filterAndSortData:Array;

		/**
		 * @private
		 */
		protected var _arrayData:Array;

		/**
		 * The <code>Array</code> data source for this collection.
		 */
		public function get arrayData():Array
		{
			return this._arrayData;
		}

		/**
		 * @private
		 */
		public function set arrayData(value:Array):void
		{
			if(this._arrayData === value)
			{
				return;
			}
			this._arrayData = value;
			this.dispatchEventWith(CollectionEventType.RESET);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _pendingRefresh:Boolean = false;

		/**
		 * @private
		 */
		protected var _filterFunction:Function = null;

		/**
		 * @copy feathers.data.IListCollection#filterFunction
		 */
		public function get filterFunction():Function
		{
			return this._filterFunction;
		}

		/**
		 * @private
		 */
		public function set filterFunction(value:Function):void
		{
			if(this._filterFunction === value)
			{
				return;
			}
			this._filterFunction = value;
			this._pendingRefresh = true;
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.FILTER_CHANGE);
		}

		/**
		 * @private
		 */
		protected var _sortCompareFunction:Function = null;

		/**
		 * @copy feathers.data.IListCollection#sortCompareFunction
		 */
		public function get sortCompareFunction():Function
		{
			return this._sortCompareFunction;
		}

		/**
		 * @private
		 */
		public function set sortCompareFunction(value:Function):void
		{
			if(this._sortCompareFunction === value)
			{
				return;
			}
			this._sortCompareFunction = value;
			this._pendingRefresh = true;
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.SORT_CHANGE);
		}

		/**
		 * @copy feathers.data.IListCollection#length
		 */
		public function get length():int
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._filterAndSortData !== null)
			{
				return this._filterAndSortData.length;
			}
			return this._arrayData.length;
		}

		/**
		 * @copy feathers.data.IListCollection#refresh()
		 */
		public function refresh():void
		{
			if(this._filterFunction === null && this._sortCompareFunction === null)
			{
				return;
			}
			this._pendingRefresh = true;
			this.dispatchEventWith(Event.CHANGE);
			if(this._filterFunction !== null)
			{
				this.dispatchEventWith(CollectionEventType.FILTER_CHANGE);
			}
			if(this._sortCompareFunction !== null)
			{
				this.dispatchEventWith(CollectionEventType.SORT_CHANGE);
			}
		}

		/**
		 * @private
		 */
		protected function refreshFilterAndSort():void
		{
			this._pendingRefresh = false;
			if(this._filterFunction !== null)
			{
				var result:Array = this._filterAndSortData;
				if(result !== null)
				{
					//reuse the old array to avoid garbage collection
					result.length = 0;
				}
				else
				{
					result = [];
				}
				var itemCount:int = this._arrayData.length;
				var pushIndex:int = 0;
				for(var i:int = 0; i < itemCount; i++)
				{
					var item:Object = this._arrayData[i];
					if(this._filterFunction(item))
					{
						result[pushIndex] = item;
						pushIndex++;
					}
				}
				this._filterAndSortData = result;
			}
			else if(this._sortCompareFunction !== null) //no filter
			{
				itemCount = this._arrayData.length;
				result = this._filterAndSortData;
				if(result !== null)
				{
					result.length = itemCount;
					for(i = 0; i < itemCount; i++)
					{
						result[i] = this._arrayData[i];
					}
				}
				else
				{
					//simply make a copy!
					result = this._arrayData.slice();
				}
				this._filterAndSortData = result;
			}
			else //no filter or sort
			{
				this._filterAndSortData = null;
			}
			if(this._sortCompareFunction !== null)
			{
				this._filterAndSortData.sort(this._sortCompareFunction);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#updateItemAt()
		 *
		 * @see #updateAll()
		 */
		public function updateItemAt(index:int):void
		{
			this.dispatchEventWith(CollectionEventType.UPDATE_ITEM, false, index);
		}

		/**
		 * @copy feathers.data.IListCollection#updateAll()
		 *
		 * @see #updateItemAt()
		 */
		public function updateAll():void
		{
			this.dispatchEventWith(CollectionEventType.UPDATE_ALL);
		}

		/**
		 * @copy feathers.data.IListCollection#getItemAt()
		 */
		public function getItemAt(index:int):Object
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._filterAndSortData !== null)
			{
				return this._filterAndSortData[index];
			}
			return this._arrayData[index];
		}

		/**
		 * @copy feathers.data.IListCollection#getItemIndex()
		 */
		public function getItemIndex(item:Object):int
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._filterAndSortData !== null)
			{
				return this._filterAndSortData.indexOf(item);
			}
			return this._arrayData.indexOf(item);
		}

		/**
		 * @copy feathers.data.IListCollection#addItemAt()
		 */
		public function addItemAt(item:Object, index:int):void
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._filterAndSortData !== null)
			{
				if(index < this._filterAndSortData.length)
				{
					//find the item at the index in the filtered data, and use
					//its index from the unfiltered data
					var oldItem:Object = this._filterAndSortData[index];
					var unfilteredIndex:int = this._arrayData.indexOf(oldItem);
				}
				else
				{
					//if the item is added at the end of the filtered data
					//then add it at the end of the unfiltered data
					unfilteredIndex = this._arrayData.length;
				}
				//always add to the original data
				this._arrayData.insertAt(unfilteredIndex, item);
				//but check if the item should be in the filtered data
				var includeItem:Boolean = true;
				if(this._filterFunction !== null)
				{
					includeItem = this._filterFunction(item);
				}
				if(includeItem)
				{
					var sortedIndex:int = index;
					if(this._sortCompareFunction !== null)
					{
						sortedIndex = this.getSortedInsertionIndex(item);
					}
					this._filterAndSortData.insertAt(sortedIndex, item);
					//don't dispatch these events if the item is filtered!
					this.dispatchEventWith(Event.CHANGE);
					this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, sortedIndex);
				}
			}
			else //no filter or sort
			{
				this._arrayData.insertAt(index, item);
				this.dispatchEventWith(Event.CHANGE);
				this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, index);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#removeItemAt()
		 */
		public function removeItemAt(index:int):Object
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._filterAndSortData !== null)
			{
				var item:Object = this._filterAndSortData.removeAt(index);
				var unfilteredIndex:int = this._arrayData.indexOf(item);
				this._arrayData.removeAt(unfilteredIndex);
			}
			else
			{
				item = this._arrayData.removeAt(index);
			}
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, index);
			return item;
		}

		/**
		 * @copy feathers.data.IListCollection#removeItem()
		 */
		public function removeItem(item:Object):void
		{
			var index:int = this.getItemIndex(item);
			if(index >= 0)
			{
				this.removeItemAt(index);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#removeAll()
		 */
		public function removeAll():void
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this.length == 0)
			{
				return;
			}
			if(this._filterAndSortData !== null)
			{
				this._filterAndSortData.length = 0;
			}
			else
			{
				this._arrayData.length = 0;
			}
			this.dispatchEventWith(CollectionEventType.REMOVE_ALL);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IListCollection#setItemAt()
		 */
		public function setItemAt(item:Object, index:int):void
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._filterAndSortData !== null)
			{
				var oldItem:Object = this._filterAndSortData[index];
				var unfilteredIndex:int = this._arrayData.indexOf(oldItem);
				this._arrayData[unfilteredIndex] = item;
				if(this._filterFunction !== null)
				{
					var includeItem:Boolean = this._filterFunction(item);
					if(includeItem)
					{
						this._filterAndSortData[index] = item;
						this.dispatchEventWith(Event.CHANGE);
						this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, index);
						return;
					}
					else
					{
						//if the item is excluded, the item at this index is
						//removed instead of being replaced by the new item
						this._filterAndSortData.removeAt(index);
						this.dispatchEventWith(Event.CHANGE);
						this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, index);
						return;
					}
				}
				else if(this._sortCompareFunction !== null)
				{
					//remove the old item first!
					this._filterAndSortData.removeAt(index);
					//then try to figure out where the new item goes when inserted
					var sortedIndex:int = this.getSortedInsertionIndex(item);
					this._filterAndSortData[sortedIndex] = item;
					this.dispatchEventWith(Event.CHANGE);
					this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, index);
					return;
				}
			}
			else //no filter or sort
			{
				this._arrayData[index] = item;
				this.dispatchEventWith(Event.CHANGE);
				this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, index);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#addItem()
		 */
		public function addItem(item:Object):void
		{
			this.addItemAt(item, this.length);
		}

		/**
		 * @copy feathers.data.IListCollection#push()
		 *
		 * @see #addItem()
		 */
		public function push(item:Object):void
		{
			this.addItemAt(item, this.length);
		}

		/**
		 * @copy feathers.data.IListCollection#addAll()
		 */
		public function addAll(collection:IListCollection):void
		{
			var otherCollectionLength:int = collection.length;
			var pushIndex:int = this._arrayData.length;
			for(var i:int = 0; i < otherCollectionLength; i++)
			{
				var item:Object = collection.getItemAt(i);
				this._arrayData[pushIndex] = item;
				pushIndex++;
			}
		}

		/**
		 * @copy feathers.data.IListCollection#addAllAt()
		 */
		public function addAllAt(collection:IListCollection, index:int):void
		{
			var otherCollectionLength:int = collection.length;
			var currentIndex:int = index;
			for(var i:int = 0; i < otherCollectionLength; i++)
			{
				var item:Object = collection.getItemAt(i);
				this._arrayData.insertAt(currentIndex, item);
				currentIndex++;
			}
		}

		/**
		 * @copy feathers.data.IListCollection#reset()
		 */
		public function reset(collection:IListCollection):void
		{
			this._arrayData.length = 0;
			var otherCollectionLength:int = collection.length;
			for(var i:int = 0; i < otherCollectionLength; i++)
			{
				var item:Object = collection.getItemAt(i);
				this._arrayData[i] = item;
			}
			this.dispatchEventWith(CollectionEventType.RESET);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IListCollection#pop()
		 */
		public function pop():Object
		{
			return this.removeItemAt(this.length - 1);
		}

		/**
		 * @copy feathers.data.IListCollection#unshift()
		 */
		public function unshift(item:Object):void
		{
			this.addItemAt(item, 0);
		}

		/**
		 * @copy feathers.data.IListCollection#shift()
		 */
		public function shift():Object
		{
			return this.removeItemAt(0);
		}

		/**
		 * @copy feathers.data.IListCollection#contains()
		 */
		public function contains(item:Object):Boolean
		{
			return this._arrayData.indexOf(item) != -1;
		}

		/**
		 * @copy feathers.data.IListCollection#dispose()
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#dispose() starling.display.DisplayObject.dispose()
		 * @see http://doc.starling-framework.org/core/starling/textures/Texture.html#dispose() starling.textures.Texture.dispose()
		 */
		public function dispose(disposeItem:Function):void
		{
			//if we're disposing the collection, filters don't matter anymore,
			//and we should ensure that all items are disposed.
			this._filterFunction = null;
			this.refreshFilterAndSort();

			var itemCount:int = this._arrayData.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = this._arrayData[i];
				disposeItem(item);
			}
		}

		/**
		 * @private
		 */
		protected function getSortedInsertionIndex(item:Object):int
		{
			var itemCount:int = this._filterAndSortData.length;
			if(this._sortCompareFunction === null)
			{
				return itemCount;
			}
			for(var i:int = 0; i < itemCount; i++)
			{
				var otherItem:Object = this._filterAndSortData[i];
				var result:int = this._sortCompareFunction(item, otherItem);
				if(result < 1)
				{
					return i;
				}
			}
			return itemCount;
		}
	}
}


================================================
FILE: source/feathers/data/ArrayHierarchicalCollection.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import feathers.events.CollectionEventType;

	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when the underlying data source changes and components will
	 * need to redraw the data.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the collection has changed drastically, such as when
	 * the underlying data source is replaced completely.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.RESET
	 */
	[Event(name="reset",type="starling.events.Event")]

	/**
	 * Dispatched when an item is added to the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been added. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.ADD_ITEM
	 */
	[Event(name="addItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is removed from the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been removed. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REMOVE_ITEM
	 */
	[Event(name="removeItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is replaced in the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been replaced. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REPLACE_ITEM
	 */
	[Event(name="replaceItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateItemAt()</code> function is called on the
	 * hierarchical collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been updated. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateItemAt()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ITEM
	 */
	[Event(name="updateItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateAll()</code> function is called on the
	 * hierarchical collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateAll()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ALL
	 */
	[Event(name="updateAll",type="starling.events.Event")]

	/**
	 * Wraps an <code>Array</code> data source with a common API for use with
	 * UI controls that support hierarchical data.
	 *
	 * @productversion Feathers 3.3.0
	 */
	public class ArrayHierarchicalCollection extends EventDispatcher implements IHierarchicalCollection
	{
		/**
		 * Constructor.
		 */
		public function ArrayHierarchicalCollection(arrayData:Array = null)
		{
			if(arrayData === null)
			{
				arrayData = [];
			}
			this._arrayData = arrayData;
		}

		/**
		 * @private
		 */
		protected var _arrayData:Array = null;

		/**
		 * The <code>Array</code> data source for this collection.
		 */
		public function get arrayData():Array
		{
			return this._arrayData;
		}

		/**
		 * @private
		 */
		public function set arrayData(value:Array):void
		{
			if(this._arrayData === value)
			{
				return;
			}
			this._arrayData = value;
			this.dispatchEventWith(CollectionEventType.RESET);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _childrenField:String = "children";

		/**
		 * The field of a branch object used to access its children. The
		 * field's type must be <code>Array</code> to be treated as a branch.
		 */
		public function get childrenField():String
		{
			return this._childrenField;
		}

		public function set childrenField(value:String):void
		{
			this._childrenField = value;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#isBranch()
		 */
		public function isBranch(node:Object):Boolean
		{
			if(node === null)
			{
				return false;
			}
			return node.hasOwnProperty(this._childrenField) && node[this._childrenField] is Array;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getLength()
		 *
		 * @see #getLengthAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function getLength(...rest:Array):int
		{
			var branch:Array = this._arrayData;
			var indexCount:int = rest.length;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = rest[i] as int;
				branch = branch[index][this._childrenField] as Array;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + rest);
				}
			}
			return branch.length;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getLengthAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function getLengthAtLocation(location:Vector.<int> = null):int
		{
			var branch:Array = this._arrayData;
			if(location !== null)
			{
				var indexCount:int = location.length;
				for(var i:int = 0; i < indexCount; i++)
				{
					var index:int = location[i];
					branch = branch[index][this._childrenField] as Array;
					if(branch === null)
					{
						throw new RangeError("Branch not found at location: " + location);
					}
				}
			}
			return branch.length;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#updateItemAt()
		 *
		 * @see #updateAll()
		 */
		public function updateItemAt(index:int, ...rest:Array):void
		{
			rest.insertAt(0, index);
			this.dispatchEventWith(CollectionEventType.UPDATE_ITEM, false, rest);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#updateAll()
		 *
		 * @see #updateItemAt()
		 */
		public function updateAll():void
		{
			this.dispatchEventWith(CollectionEventType.UPDATE_ALL);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getItemAt()
		 *
		 * @see #getItemAtLocation()
		 */
		public function getItemAt(index:int, ...rest:Array):Object
		{
			rest.insertAt(0, index);
			var branch:Array = this._arrayData;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				branch = branch[index][this._childrenField] as Array;
				if(branch === null)
				{
					return null;
				}
			}
			var lastIndex:int = rest[indexCount] as int;
			return branch[lastIndex];
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getItemAtLocation()
		 */
		public function getItemAtLocation(location:Vector.<int>):Object
		{
			if(location === null || location.length == 0)
			{
				return null;
			}
			var branch:Array = this._arrayData;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				branch = branch[index][this._childrenField] as Array;
				if(branch === null)
				{
					return null;
				}
			}
			index = location[indexCount];
			return branch[index];
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getItemLocation()
		 */
		public function getItemLocation(item:Object, result:Vector.<int> = null):Vector.<int>
		{
			if(!result)
			{
				result = new <int>[];
			}
			else
			{
				result.length = 0;
			}
			var branch:Array = this._arrayData;
			this.findItemInBranch(branch, item, result);
			return result;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#addItemAt()
		 *
		 * @see #addItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function addItemAt(item:Object, index:int, ...rest:Array):void
		{
			rest.insertAt(0, index);
			var branch:Array = this._arrayData;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				branch = branch[index][this._childrenField] as Array;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + rest);
				}
			}
			index = rest[indexCount] as int;
			branch.insertAt(index, item);
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, rest);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#addItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function addItemAtLocation(item:Object, location:Vector.<int>):void
		{
			if(location === null || location.length == 0)
			{
				throw new RangeError("Branch not found at location: " + location);
			}
			var eventIndices:Array = [];
			var branch:Array = this._arrayData;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				branch = branch[index][this._childrenField] as Array;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + location);
				}
				eventIndices[i] = index;
			}
			index = location[indexCount];
			eventIndices[indexCount] = index;
			branch.insertAt(index, item);
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, eventIndices);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeItemAt()
		 *
		 * @see #removeItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function removeItemAt(index:int, ...rest:Array):Object
		{
			rest.insertAt(0, index);
			var branch:Array = this._arrayData;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				branch = branch[index][this._childrenField] as Array;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + rest);
				}
			}
			index = rest[indexCount] as int;
			var item:Object = branch.removeAt(index);
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, rest);
			return item;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function removeItemAtLocation(location:Vector.<int>):Object
		{
			if(location === null || location.length == 0)
			{
				throw new RangeError("Branch not found at location: " + location);
			}
			var eventIndices:Array = [];
			var branch:Array = this._arrayData;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				branch = branch[index][this._childrenField] as Array;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + location);
				}
				eventIndices[i] = index;
			}
			index = location[indexCount];
			eventIndices[indexCount] = index;
			var item:Object = branch.removeAt(index);
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, eventIndices);
			return item;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeItem()
		 */
		public function removeItem(item:Object):void
		{
			var location:Vector.<int> = this.getItemLocation(item);
			if(location !== null)
			{
				this.removeItemAtLocation(location);
			}
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeAll()
		 */
		public function removeAll():void
		{
			if(this.getLength() == 0)
			{
				return;
			}
			this._arrayData.length = 0;
			this.dispatchEventWith(CollectionEventType.REMOVE_ALL);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#setItemAt()
		 *
		 * @see #setItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function setItemAt(item:Object, index:int, ...rest:Array):void
		{
			rest.insertAt(0, index);
			var branch:Array = this._arrayData;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				branch = branch[index][this._childrenField] as Array;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + rest);
				}
			}
			index = rest[indexCount] as int;
			branch[index] = item;
			this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, rest);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#setItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function setItemAtLocation(item:Object, location:Vector.<int>):void
		{
			if(location === null || location.length == 0)
			{
				throw new RangeError("Branch not found at location: " + location);
			}
			var eventIndices:Array = [];
			var branch:Array = this._arrayData;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				branch = branch[index][this._childrenField] as Array;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + location);
				}
				eventIndices[i] = index;
			}
			index = location[indexCount];
			eventIndices[indexCount] = index;
			branch[index] = item;
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, eventIndices);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#dispose()
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#dispose() starling.display.DisplayObject.dispose()
		 * @see http://doc.starling-framework.org/core/starling/textures/Texture.html#dispose() starling.textures.Texture.dispose()
		 */
		public function dispose(disposeBranch:Function, disposeItem:Function):void
		{
			var groupCount:int = this._arrayData.length;
			var path:Array = [];
			for(var i:int = 0; i < groupCount; i++)
			{
				var group:Object = this._arrayData[i];
				path[0] = i;
				this.disposeGroupInternal(group, path, disposeBranch, disposeItem);
				path.length = 0;
			}
		}

		/**
		 * @private
		 */
		protected function disposeGroupInternal(group:Object, path:Array, disposeBranch:Function, disposeItem:Function):void
		{
			if(disposeBranch !== null)
			{
				disposeBranch(group);
			}

			var itemCount:int = this.getLength.apply(this, path);
			for(var i:int = 0; i < itemCount; i++)
			{
				path[path.length] = i;
				var item:Object = this.getItemAt.apply(this, path);
				if(this.isBranch(item))
				{
					this.disposeGroupInternal(item, path, disposeBranch, disposeItem);
				}
				else if(disposeItem !== null)
				{
					disposeItem(item);
				}
				path.length--;
			}
		}

		/**
		 * @private
		 */
		protected function findItemInBranch(branch:Array, item:Object, result:Vector.<int>):Boolean
		{
			var insertIndex:int = result.length;
			var branchLength:int = branch.length;
			for(var i:int = 0; i < branchLength; i++)
			{
				var branchItem:Object = branch[i];
				if(branchItem === item)
				{
					result[insertIndex] = i;
					return true;
				}
				if(this.isBranch(branchItem))
				{
					result[insertIndex] = i;
					var children:Array = branchItem[this._childrenField] as Array;
					var isFound:Boolean = this.findItemInBranch(children, item, result);
					if(isFound)
					{
						return true;
					}
					result.pop();
				}
			}
			return false;
		}
	}
}


================================================
FILE: source/feathers/data/ArrayListCollectionDataDescriptor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import flash.errors.IllegalOperationError;

	/**
	 * An <code>IListCollectionDataDescriptor</code> implementation for Arrays.
	 *
	 * @see ListCollection
	 * @see IListCollectionDataDescriptor
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class ArrayListCollectionDataDescriptor implements IListCollectionDataDescriptor
	{
		/**
		 * Constructor.
		 */
		public function ArrayListCollectionDataDescriptor()
		{
		}

		/**
		 * @inheritDoc
		 */
		public function getLength(data:Object):int
		{
			this.checkForCorrectDataType(data);
			return (data as Array).length;
		}

		/**
		 * @inheritDoc
		 */
		public function getItemAt(data:Object, index:int):Object
		{
			this.checkForCorrectDataType(data);
			return (data as Array)[index];
		}

		/**
		 * @inheritDoc
		 */
		public function setItemAt(data:Object, item:Object, index:int):void
		{
			this.checkForCorrectDataType(data);
			(data as Array)[index] = item;
		}

		/**
		 * @inheritDoc
		 */
		public function addItemAt(data:Object, item:Object, index:int):void
		{
			this.checkForCorrectDataType(data);
			(data as Array).insertAt(index, item);
		}

		/**
		 * @inheritDoc
		 */
		public function removeItemAt(data:Object, index:int):Object
		{
			this.checkForCorrectDataType(data);
			return (data as Array).removeAt(index);
		}

		/**
		 * @inheritDoc
		 */
		public function removeAll(data:Object):void
		{
			this.checkForCorrectDataType(data);
			(data as Array).length = 0;
		}

		/**
		 * @inheritDoc
		 */
		public function getItemIndex(data:Object, item:Object):int
		{
			this.checkForCorrectDataType(data);
			return (data as Array).indexOf(item);
		}

		/**
		 * @private
		 */
		protected function checkForCorrectDataType(data:Object):void
		{
			if(!(data is Array))
			{
				throw new IllegalOperationError("Expected Array. Received " + Object(data).constructor + " instead.");
			}
		}
	}
}

================================================
FILE: source/feathers/data/HierarchicalCollection.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import feathers.events.CollectionEventType;

	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when the underlying data source changes and components will
	 * need to redraw the data.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the collection has changed drastically, such as when
	 * the underlying data source is replaced completely.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.RESET
	 */
	[Event(name="reset",type="starling.events.Event")]

	/**
	 * Dispatched when an item is added to the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been added. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.ADD_ITEM
	 */
	[Event(name="addItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is removed from the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been removed. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REMOVE_ITEM
	 */
	[Event(name="removeItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is replaced in the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been replaced. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REPLACE_ITEM
	 */
	[Event(name="replaceItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateItemAt()</code> function is called on the
	 * hierarchical collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been updated. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateItemAt()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ITEM
	 */
	[Event(name="updateItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateAll()</code> function is called on the
	 * hierarchical collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateAll()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ALL
	 */
	[Event(name="updateAll",type="starling.events.Event")]

	/**
	 * Wraps a two-dimensional data source with a common API for use with UI
	 * controls that support this type of data.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class HierarchicalCollection extends EventDispatcher implements IHierarchicalCollection
	{
		/**
		 * Constructor.
		 */
		public function HierarchicalCollection(data:Object = null)
		{
			if(!data)
			{
				//default to an array if no data is provided
				data = [];
			}
			this.data = data;
		}

		/**
		 * @private
		 */
		protected var _data:Object;

		/**
		 * The data source for this collection. May be any type of data, but a
		 * <code>dataDescriptor</code> needs to be provided to translate from
		 * the data source's APIs to something that can be understood by
		 * hierarchical collection.
		 */
		public function get data():Object
		{
			return _data;
		}

		/**
		 * @private
		 */
		public function set data(value:Object):void
		{
			if(this._data == value)
			{
				return;
			}
			this._data = value;
			this.dispatchEventWith(CollectionEventType.RESET);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _dataDescriptor:IHierarchicalCollectionDataDescriptor = new ArrayChildrenHierarchicalCollectionDataDescriptor();

		/**
		 * Describes the underlying data source by translating APIs.
		 */
		public function get dataDescriptor():IHierarchicalCollectionDataDescriptor
		{
			return this._dataDescriptor;
		}

		/**
		 * @private
		 */
		public function set dataDescriptor(value:IHierarchicalCollectionDataDescriptor):void
		{
			if(this._dataDescriptor == value)
			{
				return;
			}
			this._dataDescriptor = value;
			this.dispatchEventWith(CollectionEventType.RESET);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#isBranch()
		 */
		public function isBranch(node:Object):Boolean
		{
			return this._dataDescriptor.isBranch(node);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getLength()
		 *
		 * @see #getLengthAtLocation()
		 */
		public function getLength(...rest:Array):int
		{
			rest.insertAt(0, this._data);
			return this._dataDescriptor.getLength.apply(null, rest);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getLengthAtLocation()
		 */
		public function getLengthAtLocation(location:Vector.<int> = null):int
		{
			return this._dataDescriptor.getLengthAtLocation(this._data, location);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#updateItemAt()
		 *
		 * @see #updateAll()
		 */
		public function updateItemAt(index:int, ...rest:Array):void
		{
			rest.insertAt(0, index);
			this.dispatchEventWith(CollectionEventType.UPDATE_ITEM, false, rest);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#updateAll()
		 *
		 * @see #updateItemAt()
		 */
		public function updateAll():void
		{
			this.dispatchEventWith(CollectionEventType.UPDATE_ALL);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getItemAt()
		 *
		 * @see #getItemAtLocation()
		 */
		public function getItemAt(index:int, ...rest:Array):Object
		{
			rest.insertAt(0, index);
			rest.insertAt(0, this._data);
			return this._dataDescriptor.getItemAt.apply(null, rest);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getItemAtLocation()
		 */
		public function getItemAtLocation(location:Vector.<int>):Object
		{
			return this._dataDescriptor.getItemAtLocation(this._data, location);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getItemLocation()
		 */
		public function getItemLocation(item:Object, result:Vector.<int> = null):Vector.<int>
		{
			return this._dataDescriptor.getItemLocation(this._data, item, result);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#addItemAt()
		 *
		 * @see #addItemAtLocation()
		 */
		public function addItemAt(item:Object, index:int, ...rest:Array):void
		{
			rest.insertAt(0, index);
			rest.insertAt(0, item);
			rest.insertAt(0, this._data);
			this._dataDescriptor.addItemAt.apply(null, rest);
			this.dispatchEventWith(Event.CHANGE);
			rest.shift();
			rest.shift();
			this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, rest);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#addItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function addItemAtLocation(item:Object, location:Vector.<int>):void
		{
			this._dataDescriptor.addItemAtLocation(this._data, item, location);
			this.dispatchEventWith(Event.CHANGE);
			var result:Array = [];
			var locationCount:int = location.length;
			for(var i:int = 0; i < locationCount; i++)
			{
				result[i] = location[i];
			}
			this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, result);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeItemAt()
		 *
		 * @see #removeItemAtLocation()
		 */
		public function removeItemAt(index:int, ...rest:Array):Object
		{
			rest.insertAt(0, index);
			rest.insertAt(0, this._data);
			var item:Object = this._dataDescriptor.removeItemAt.apply(null, rest);
			this.dispatchEventWith(Event.CHANGE);
			rest.shift();
			this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, rest);
			return item;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function removeItemAtLocation(location:Vector.<int>):Object
		{
			var item:Object = this._dataDescriptor.removeItemAtLocation(this._data, location);
			var result:Array = [];
			var locationCount:int = location.length;
			for(var i:int = 0; i < locationCount; i++)
			{
				result[i] = location[i];
			}
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, result);
			return item;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeItem()
		 */
		public function removeItem(item:Object):void
		{
			var location:Vector.<int> = this.getItemLocation(item);
			if(location !== null)
			{
				this.removeItemAtLocation(location);
			}
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeAll()
		 */
		public function removeAll():void
		{
			if(this.getLength() == 0)
			{
				return;
			}
			this._dataDescriptor.removeAll(this._data);
			this.dispatchEventWith(CollectionEventType.REMOVE_ALL);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#setItemAt()
		 *
		 * @see #setItemAtLocation()
		 */
		public function setItemAt(item:Object, index:int, ...rest:Array):void
		{
			rest.insertAt(0, index);
			rest.insertAt(0, item);
			rest.insertAt(0, this._data);
			this._dataDescriptor.setItemAt.apply(null, rest);
			rest.shift();
			rest.shift();
			this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, rest);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#setItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function setItemAtLocation(item:Object, location:Vector.<int>):void
		{
			this._dataDescriptor.setItemAtLocation(data, item, location);
			this.dispatchEventWith(Event.CHANGE);
			var result:Array = [];
			var locationCount:int = location.length;
			for(var i:int = 0; i < locationCount; i++)
			{
				result[i] = location[i];
			}
			this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, result);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#dispose()
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#dispose() starling.display.DisplayObject.dispose()
		 * @see http://doc.starling-framework.org/core/starling/textures/Texture.html#dispose() starling.textures.Texture.dispose()
		 */
		public function dispose(disposeGroup:Function, disposeItem:Function):void
		{
			var groupCount:int = this.getLength();
			var path:Array = [];
			for(var i:int = 0; i < groupCount; i++)
			{
				var group:Object = this.getItemAt(i);
				path[0] = i;
				this.disposeGroupInternal(group, path, disposeGroup, disposeItem);
				path.length = 0;
			}
		}

		/**
		 * @private
		 */
		protected function disposeGroupInternal(group:Object, path:Array, disposeGroup:Function, disposeItem:Function):void
		{
			if(disposeGroup != null)
			{
				disposeGroup(group);
			}

			var itemCount:int = this.getLength.apply(this, path);
			for(var i:int = 0; i < itemCount; i++)
			{
				path[path.length] = i;
				var item:Object = this.getItemAt.apply(this, path);
				if(this.isBranch(item))
				{
					this.disposeGroupInternal(item, path, disposeGroup, disposeItem);
				}
				else if(disposeItem != null)
				{
					disposeItem(item);
				}
				path.length--;
			}
		}
	}
}


================================================
FILE: source/feathers/data/IAutoCompleteSource.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import feathers.core.IFeathersEventDispatcher;

	/**
	 * Dispatched when the suggestions finish loading.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>A <code>ListCollection</code> containing
	 *   the suggestions to display.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.COMPLETE
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * A source of items to display in the pop-up list of an
	 * <code>AutoComplete</code> component.
	 *
	 * @see feathers.controls.AutoComplete
	 *
	 * @productversion Feathers 2.1.0
	 */
	public interface IAutoCompleteSource extends IFeathersEventDispatcher
	{
		/**
		 * Loads suggestions based on the text entered into an
		 * <code>AutoComplete</code> component.
		 *
		 * <p>If an existing <code>ListCollection</code> is passed in as the
		 * result, all items will be removed before new items are added.</p>
		 */
		function load(textToMatch:String, suggestionsResult:IListCollection = null):void;
	}
}


================================================
FILE: source/feathers/data/IHierarchicalCollection.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import feathers.core.IFeathersEventDispatcher;

	/**
	 * Dispatched when the underlying data source changes and the ui will
	 * need to redraw the data.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the collection has changed drastically, such as when
	 * the underlying data source is replaced completely.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.RESET
	 */
	[Event(name="reset",type="starling.events.Event")]

	/**
	 * Dispatched when an item is added to the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been added. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.ADD_ITEM
	 */
	[Event(name="addItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is removed from the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been removed. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REMOVE_ITEM
	 */
	[Event(name="removeItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is replaced in the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been replaced. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REPLACE_ITEM
	 */
	[Event(name="replaceItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateItemAt()</code> function is called on the
	 * hierarchical collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been updated. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateItemAt()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ITEM
	 */
	[Event(name="updateItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateAll()</code> function is called on the
	 * hierarchical collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateAll()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ALL
	 */
	[Event(name="updateAll",type="starling.events.Event")]

	/**
	 * An interface for hierarchical collections.
	 *
	 * @productversion 3.3.0
	 */
	public interface IHierarchicalCollection extends IFeathersEventDispatcher
	{
		/**
		 * Determines if a node from the data source is a branch.
		 */
		function isBranch(node:Object):Boolean;

		/**
		 * The number of items at the specified location in the collection.
		 *
		 * <p>Calling <code>getLengthOfBranch()</code> instead is recommended
		 * because the <code>Vector.&lt;int&gt;</code> location may be reused to
		 * avoid excessive garbage collection from temporary objects created by
		 * <code>...rest</code> arguments.</p>
		 */
		function getLength(...rest:Array):int;

		/**
		 * The number of items at the specified location in the collection.
		 */
		function getLengthAtLocation(location:Vector.<int> = null):int;

		/**
		 * Call <code>updateItemAt()</code> to manually inform any component
		 * rendering the hierarchical collection that the properties of a
		 * single item in the collection have changed, and that any views
		 * associated with the item should be updated. The collection will
		 * dispatch the <code>CollectionEventType.UPDATE_ITEM</code> event.
		 *
		 * <p>Alternatively, the item can dispatch an event when one of its
		 * properties has changed, and  a custom item renderer can listen for
		 * that event and update itself automatically.</p>
		 *
		 * @see #updateAll()
		 */
		function updateItemAt(index:int, ...rest:Array):void;

		/**
		 * Call <code>updateAll()</code> to manually inform any component
		 * rendering the hierarchical collection that the properties of all, or
		 * many, of the collection's items have changed, and that any rendered
		 * views should be updated. The collection will dispatch the
		 * <code>CollectionEventType.UPDATE_ALL</code> event.
		 *
		 * <p>Alternatively, the item can dispatch an event when one of its
		 * properties has changed, and  a custom item renderer can listen for
		 * that event and update itself automatically.</p>
		 *
		 * @see #updateItemAt()
		 */
		function updateAll():void;

		/**
		 * Returns the item at the specified location in the collection.
		 *
		 * <p>Calling <code>getItemAtLocation()</code> instead is recommended
		 * because the <code>Vector.&lt;int&gt;</code> location may be reused to
		 * avoid excessive garbage collection from temporary objects created by
		 * <code>...rest</code> arguments.</p>
		 */
		function getItemAt(index:int, ...rest:Array):Object;

		/**
		 * Returns the item at the specified location in the collection.
		 */
		function getItemAtLocation(location:Vector.<int>):Object;

		/**
		 * Determines which location the item appears at within the collection. If
		 * the item isn't in the collection, returns an empty vector.
		 */
		function getItemLocation(item:Object, result:Vector.<int> = null):Vector.<int>;

		/**
		 * Adds an item to the collection, at the specified location.
		 *
		 * <p>Calling <code>addItemAtLocation()</code> instead is recommended
		 * because the <code>Vector.&lt;int&gt;</code> location may be reused to
		 * avoid excessive garbage collection from temporary objects created by
		 * <code>...rest</code> arguments.</p>
		 */
		function addItemAt(item:Object, index:int, ...rest:Array):void;

		/**
		 * Adds an item to the collection, at the specified location.
		 */
		function addItemAtLocation(item:Object, location:Vector.<int>):void;

		/**
		 * Removes the item at the specified location from the collection and
		 * returns it.
		 *
		 * <p>Calling <code>removeItemAtLocation()</code> instead is recommended
		 * because the <code>Vector.&lt;int&gt;</code> location may be reused to
		 * avoid excessive garbage collection from temporary objects created by
		 * <code>...rest</code> arguments.</p>
		 */
		function removeItemAt(index:int, ...rest:Array):Object;

		/**
		 * Removes the item at the specified location from the collection and
		 * returns it.
		 */
		function removeItemAtLocation(location:Vector.<int>):Object;

		/**
		 * Removes a specific item from the collection.
		 */
		function removeItem(item:Object):void;

		/**
		 * Removes all items from the collection.
		 */
		function removeAll():void;

		/**
		 * Replaces the item at the specified location with a new item.
		 *
		 * <p>Calling <code>setItemAtLocation()</code> instead is recommended
		 * because the <code>Vector.&lt;int&gt;</code> location may be reused to
		 * avoid excessive garbage collection from temporary objects created by
		 * <code>...rest</code> arguments.</p>
		 */
		function setItemAt(item:Object, index:int, ...rest:Array):void;

		/**
		 * Replaces the item at the specified location with a new item.
		 */
		function setItemAtLocation(item:Object, location:Vector.<int>):void;

		/**
		 * Calls a function for each group in the collection and another
		 * function for each item in a group, where each function handles any
		 * properties that require disposal on these objects. For example,
		 * display objects or textures may need to be disposed. You may pass in
		 * a value of <code>null</code> for either function if you don't have
		 * anything to dispose in one or the other.
		 *
		 * <p>The function to dispose a group is expected to have the following signature:</p>
		 * <pre>function( group:Object ):void</pre>
		 *
		 * <p>The function to dispose an item is expected to have the following signature:</p>
		 * <pre>function( item:Object ):void</pre>
		 *
		 * <p>In the following example, the items in the collection are disposed:</p>
		 *
		 * <listing version="3.0">
		 * collection.dispose( function( group:Object ):void
		 * {
		 *     var content:DisplayObject = DisplayObject(group.content);
		 *     content.dispose();
		 * },
		 * function( item:Object ):void
		 * {
		 *     var accessory:DisplayObject = DisplayObject(item.accessory);
		 *     accessory.dispose();
		 * },)</listing>
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#dispose() starling.display.DisplayObject.dispose()
		 * @see http://doc.starling-framework.org/core/starling/textures/Texture.html#dispose() starling.textures.Texture.dispose()
		 */
		function dispose(disposeGroup:Function, disposeItem:Function):void;
	}
}


================================================
FILE: source/feathers/data/IHierarchicalCollectionDataDescriptor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	/**
	 * An adapter interface to support any kind of data source in
	 * hierarchical collections.
	 *
	 * @see HierarchicalCollection
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface IHierarchicalCollectionDataDescriptor
	{
		/**
		 * Determines if a node from the data source is a branch.
		 */
		function isBranch(node:Object):Boolean;

		/**
		 * The number of items at the specified location in the data source.
		 *
		 * <p>The rest arguments are the indices that make up the location. If
		 * a location is omitted, the length returned will be for the root level
		 * of the collection.</p>
		 *
		 * <p>Calling <code>getLengthOfBranch()</code> instead is recommended
		 * because the <code>Vector.&lt;int&gt;</code> location may be reused to
		 * avoid excessive garbage collection from temporary objects created by
		 * <code>...rest</code> arguments.</p>
		 */
		function getLength(data:Object, ...rest:Array):int;

		/**
		 * The number of items at the specified location in the data source.
		 */
		function getLengthAtLocation(data:Object, location:Vector.<int> = null):int;

		/**
		 * Returns the item at the specified location in the data source.
		 *
		 * <p>The rest arguments are the indices that make up the location.</p>
		 *
		 * <p>Calling <code>getItemAtLocation()</code> instead is recommended
		 * because the <code>Vector.&lt;int&gt;</code> location may be reused to
		 * avoid excessive garbage collection from temporary objects created by
		 * <code>...rest</code> arguments.</p>
		 */
		function getItemAt(data:Object, index:int, ...rest:Array):Object;

		/**
		 * Returns the item at the specified location in the data source.
		 */
		function getItemAtLocation(data:Object, location:Vector.<int>):Object;

		/**
		 * Replaces the item at the specified location with a new item.
		 *
		 * <p>The rest arguments are the indices that make up the location.</p>
		 *
		 * <p>Calling <code>setItemAtLocation()</code> instead is recommended
		 * because the <code>Vector.&lt;int&gt;</code> location may be reused to
		 * avoid excessive garbage collection from temporary objects created by
		 * <code>...rest</code> arguments.</p>
		 */
		function setItemAt(data:Object, item:Object, index:int, ...rest:Array):void;

		/**
		 * Replaces the item at the specified location with a new item.
		 *
		 * <p>The rest arguments are the indices that make up the location.</p>
		 */
		function setItemAtLocation(data:Object, item:Object, location:Vector.<int>):void;

		/**
		 * Adds an item to the data source, at the specified location.
		 *
		 * <p>The rest arguments are the indices that make up the location.</p>
		 *
		 * <p>Calling <code>addItemAtLocation()</code> instead is recommended
		 * because the <code>Vector.&lt;int&gt;</code> location may be reused to
		 * avoid excessive garbage collection from temporary objects created by
		 * <code>...rest</code> arguments.</p>
		 */
		function addItemAt(data:Object, item:Object, index:int, ...rest:Array):void;

		/**
		 * Adds an item to the data source, at the specified location.
		 */
		function addItemAtLocation(data:Object, item:Object, location:Vector.<int>):void;

		/**
		 * Removes the item at the specified location from the data source and
		 * returns it.
		 *
		 * <p>The rest arguments are the indices that make up the location.</p>
		 */
		function removeItemAt(data:Object, index:int, ...rest:Array):Object;

		/**
		 * Removes the item at the specified location from the data source and
		 * returns it.
		 *
		 * <p>The rest arguments are the indices that make up the location.</p>
		 *
		 * <p>Calling <code>removeItemAtLocation()</code> instead is recommended
		 * because the <code>Vector.&lt;int&gt;</code> location may be reused to
		 * avoid excessive garbage collection from temporary objects created by
		 * <code>...rest</code> arguments.</p>
		 */
		function removeItemAtLocation(data:Object, location:Vector.<int>):Object;

		/**
		 * Removes all items from the data source.
		 */
		function removeAll(data:Object):void;

		/**
		 * Determines which location the item appears at within the data source.
		 * If the item isn't in the data source, returns an empty <code>Vector.&lt;int&gt;</code>.
		 *
		 * <p>The <code>rest</code> arguments are optional indices to narrow
		 * the search.</p>
		 */
		function getItemLocation(data:Object, item:Object, result:Vector.<int> = null, ...rest:Array):Vector.<int>;
	}
}


================================================
FILE: source/feathers/data/IListCollection.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import feathers.core.IFeathersEventDispatcher;

	/**
	 * Dispatched when the underlying data source changes and components will
	 * need to redraw the data.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the collection has changed drastically, such as when
	 * the underlying data source is replaced completely.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.RESET
	 */
	[Event(name="reset",type="starling.events.Event")]

	/**
	 * Dispatched when an item is added to the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * added. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.ADD_ITEM
	 */
	[Event(name="addItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is removed from the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * removed. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REMOVE_ITEM
	 */
	[Event(name="removeItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is replaced in the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * replaced. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REPLACE_ITEM
	 */
	[Event(name="replaceItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateItemAt()</code> function is called on the
	 * <code>IListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * updated. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateItemAt()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ITEM
	 */
	[Event(name="updateItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateAll()</code> function is called on the
	 * <code>IListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateAll()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ALL
	 */
	[Event(name="updateAll",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>filterFunction</code> property changes or the
	 * <code>refresh()</code> function is called on the <code>IListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #filterFunction
	 * @see #refresh()
	 *
	 * @eventType feathers.events.CollectionEventType.FILTER_CHANGE
	 */
	[Event(name="filterChange",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>sortCompareFunction</code> property changes or
	 * the <code>refresh()</code> function is called on the <code>IListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #sortCompareFunction
	 * @see #refresh()
	 *
	 * @eventType feathers.events.CollectionEventType.SORT_CHANGE
	 */
	[Event(name="sortChange",type="starling.events.Event")]

	/**
	 * Interface for list collections.
	 *
	 * @productversion Feathers 3.3.0
	 */
	public interface IListCollection extends IFeathersEventDispatcher
	{
		/**
		 * The number of items in the collection.
		 */
		function get length():int;

		/**
		 * A function to determine if each item in the collection should be
		 * included or excluded from visibility through APIs like
		 * <code>length</code> and <code>getItemAt()</code>.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):Boolean</pre>
		 *
		 * <p>In the following example, the filter function is based on the
		 * text of a <code>TextInput</code> component:</p>
		 *
		 * <listing version="3.0">
		 * var collection:IListCollection; //this would be created from a concrete implementation
		 * 
		 * var list:List = new List();
		 * list.dataProvider = collection;
		 * this.addChild( list );
		 * 
		 * var input:TextInput = new TextInput();
		 * input.addEventListener( Event.CHANGE, function():void
		 * {
		 *    if( input.text.length == 0 )
		 *    {
		 *        collection.filterFunction = null;
		 *        return;
		 *    }
		 *    collection.filterFunction = function( item:Object ):Boolean
		 *    {
		 *        var itemText:String = item.label.toLowerCase();
		 *        var filterText:String = input.text.toLowerCase();
		 *        return itemText.indexOf( filterText ) >= 0;
		 *    };
		 * } );
		 * this.addChild( input );</listing>
		 *
		 * @default null
		 */
		function get filterFunction():Function;

		/**
		 * @private
		 */
		function set filterFunction(value:Function):void;

		/**
		 * A function to compare each item in the collection to determine the
		 * order when sorted.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( a:Object, b:Object ):int</pre>
		 *
		 * <p>The return value should be <code>-1</code> if the first item
		 * should appear before the second item when the collection is sorted.
		 * The return value should be <code>1</code> if the first item should
		 * appear after the second item when the collection in sorted. Finally,
		 * the return value should be <code>0</code> if both items have the
		 * same sort order.</p>
		 *
		 * @default null
		 */
		function get sortCompareFunction():Function;

		/**
		 * @private
		 */
		function set sortCompareFunction(value:Function):void;

		/**
		 * Refreshes the collection using the <code>filterFunction</code>
		 * or <code>sortCompareFunction</code> without passing in a new values
		 * for these properties. Useful when either of these functions relies
		 * on external variables that have changed.
		 */
		function refresh():void;

		/**
		 * Call <code>updateItemAt()</code> to manually inform any component
		 * rendering the <code>IListCollection</code> that the properties of a
		 * single item in the collection have changed, and that any views
		 * associated with the item should be updated. The collection will
		 * dispatch the <code>CollectionEventType.UPDATE_ITEM</code> event.
		 *
		 * <p>Alternatively, the item can dispatch an event when one of its
		 * properties has changed, and a custom item renderer can listen for
		 * that event and update itself automatically.</p>
		 *
		 * @see #updateAll()
		 */
		function updateItemAt(index:int):void;

		/**
		 * Call <code>updateAll()</code> to manually inform any component
		 * rendering the <code>IListCollection</code> that the properties of all,
		 * or many, of the collection's items have changed, and that any
		 * rendered views should be updated. The collection will dispatch the
		 * <code>CollectionEventType.UPDATE_ALL</code> event.
		 *
		 * <p>Alternatively, the item can dispatch an event when one of its
		 * properties has changed, and a custom item renderer can listen for
		 * that event and update itself automatically.</p>
		 *
		 * @see #updateItemAt()
		 */
		function updateAll():void;

		/**
		 * Returns the item at the specified index in the collection.
		 */
		function getItemAt(index:int):Object;

		/**
		 * Determines which index the item appears at within the collection. If
		 * the item isn't in the collection, returns <code>-1</code>.
		 *
		 * <p>If the collection is filtered, <code>getItemIndex()</code> will
		 * return <code>-1</code> for items that are excluded by the filter.</p>
		 */
		function getItemIndex(item:Object):int;

		/**
		 * Adds an item to the collection, at the specified index.
		 *
		 * <p>If the collection is filtered, the index is the position in the
		 * filtered data, rather than position in the unfiltered data.</p>
		 */
		function addItemAt(item:Object, index:int):void;

		/**
		 * Removes the item at the specified index from the collection and
		 * returns it.
		 *
		 * <p>If the collection is filtered, the index is the position in the
		 * filtered data, rather than position in the unfiltered data.</p>
		 */
		function removeItemAt(index:int):Object;

		/**
		 * Removes a specific item from the collection.
		 *
		 * <p>If the collection is filtered, <code>removeItem()</code> will not
		 * remove the item from the unfiltered data if it is not included in the
		 * filtered data. If the item is not removed,
		 * <code>CollectionEventType.REMOVE_ITEM</code> will not be dispatched.</p>
		 */
		function removeItem(item:Object):void;

		/**
		 * Removes all items from the collection.
		 */
		function removeAll():void;

		/**
		 * Replaces the item at the specified index with a new item.
		 */
		function setItemAt(item:Object, index:int):void;

		/**
		 * Adds an item to the end of the collection.
		 *
		 * <p>If the collection is filtered, <code>addItem()</code> may add
		 * the item to the unfiltered data, but omit it from the filtered data.
		 * If the item is omitted from the filtered data,
		 * <code>CollectionEventType.ADD_ITEM</code> will not be dispatched.</p>
		 */
		function addItem(item:Object):void;

		/**
		 * Adds all items from another collection.
		 */
		function addAll(collection:IListCollection):void;

		/**
		 * Adds all items from another collection, placing the items at a
		 * specific index in this collection.
		 */
		function addAllAt(collection:IListCollection, index:int):void;

		/**
		 * Replaces the collection's data with data from another collection.
		 */
		function reset(collection:IListCollection):void;

		/**
		 * A convenient alias for <code>addItem()</code>.
		 *
		 * @see #addItem()
		 */
		function push(item:Object):void;

		/**
		 * Removes the item from the end of the collection and returns it.
		 */
		function pop():Object;

		/**
		 * Adds an item to the beginning of the collection.
		 */
		function unshift(item:Object):void;

		/**
		 * Removes the first item in the collection and returns it.
		 */
		function shift():Object;

		/**
		 * Determines if the specified item is in the collection.
		 *
		 * <p>If the collection is filtered, <code>contains()</code> will return
		 * <code>false</code> for items that are excluded by the filter.</p>
		 */
		function contains(item:Object):Boolean;

		/**
		 * Calls a function for each item in the collection that may be used
		 * to dispose any properties on the item. For example, display objects
		 * or textures may need to be disposed.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object ):void</pre>
		 *
		 * <p>In the following example, the items in the collection are disposed:</p>
		 *
		 * <listing version="3.0">
		 * collection.dispose( function( item:Object ):void
		 * {
		 *     var accessory:DisplayObject = DisplayObject(item.accessory);
		 *     accessory.dispose();
		 * }</listing>
		 *
		 * <p>If the collection has a <code>filterFunction</code>, it will be
		 * removed, and it will not be restored.</p>
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#dispose() starling.display.DisplayObject.dispose()
		 * @see http://doc.starling-framework.org/core/starling/textures/Texture.html#dispose() starling.textures.Texture.dispose()
		 */
		function dispose(disposeItem:Function):void;
	}
}


================================================
FILE: source/feathers/data/IListCollectionDataDescriptor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	/**
	 * An adapter interface to support any kind of data source in
	 * <code>ListCollection</code>.
	 *
	 * @see ListCollection
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface IListCollectionDataDescriptor
	{
		/**
		 * The number of items in the data source.
		 */
		function getLength(data:Object):int;

		/**
		 * Returns the item at the specified index in the data source.
		 */
		function getItemAt(data:Object, index:int):Object;

		/**
		 * Replaces the item at the specified index with a new item.
		 */
		function setItemAt(data:Object, item:Object, index:int):void;

		/**
		 * Adds an item to the data source, at the specified index.
		 */
		function addItemAt(data:Object, item:Object, index:int):void;

		/**
		 * Removes the item at the specified index from the data source and
		 * returns it.
		 */
		function removeItemAt(data:Object, index:int):Object;

		/**
		 * Determines which index the item appears at within the data source. If
		 * the item isn't in the data source, returns <code>-1</code>.
		 */
		function getItemIndex(data:Object, item:Object):int;

		/**
		 * Removes all items from the data source.
		 */
		function removeAll(data:Object):void;
	}
}

================================================
FILE: source/feathers/data/ListCollection.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import feathers.events.CollectionEventType;

	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when the underlying data source changes and components will
	 * need to redraw the data.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the collection has changed drastically, such as when
	 * the underlying data source is replaced completely.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.RESET
	 */
	[Event(name="reset",type="starling.events.Event")]

	/**
	 * Dispatched when an item is added to the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * added. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.ADD_ITEM
	 */
	[Event(name="addItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is removed from the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * removed. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REMOVE_ITEM
	 */
	[Event(name="removeItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is replaced in the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * replaced. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REPLACE_ITEM
	 */
	[Event(name="replaceItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateItemAt()</code> function is called on the
	 * <code>ListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * updated. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateItemAt()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ITEM
	 */
	[Event(name="updateItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateAll()</code> function is called on the
	 * <code>ListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateAll()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ALL
	 */
	[Event(name="updateAll",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>filterFunction</code> property changes or the
	 * <code>refresh()</code> function is called on the <code>IListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #filterFunction
	 * @see #refresh()
	 *
	 * @eventType feathers.events.CollectionEventType.FILTER_CHANGE
	 */
	[Event(name="filterChange",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>sortCompareFunction</code> property changes or
	 * the <code>refresh()</code> function is called on the <code>IListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #sortCompareFunction
	 * @see #refresh()
	 *
	 * @eventType feathers.events.CollectionEventType.SORT_CHANGE
	 */
	[Event(name="sortChange",type="starling.events.Event")]

	/**
	 * Wraps a data source with a common API for use with UI controls, like
	 * lists, that support one dimensional collections of data. Supports custom
	 * "data descriptors" so that unexpected data sources may be used. Supports
	 * Arrays, Vectors, and XMLLists automatically.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class ListCollection extends EventDispatcher implements IListCollection
	{
		/**
		 * Constructor
		 */
		public function ListCollection(data:Object = null)
		{
			if(!data)
			{
				//default to an array if no data is provided
				data = [];
			}
			this.data = data;
		}

		/**
		 * @private
		 */
		protected var _localDataDescriptor:ArrayListCollectionDataDescriptor;

		/**
		 * @private
		 */
		protected var _localData:Array;

		/**
		 * @private
		 */
		protected var _data:Object;

		/**
		 * The data source for this collection. May be any type of data, but a
		 * <code>dataDescriptor</code> needs to be provided to translate from
		 * the data source's APIs to something that can be understood by
		 * <code>ListCollection</code>.
		 *
		 * <p>Data sources of type Array, Vector, and XMLList are automatically
		 * detected, and no <code>dataDescriptor</code> needs to be set if the
		 * <code>ListCollection</code> uses one of these types.</p>
		 */
		public function get data():Object
		{
			return _data;
		}

		/**
		 * @private
		 */
		public function set data(value:Object):void
		{
			if(this._data == value)
			{
				return;
			}
			this._data = value;
			//we'll automatically detect an array, vector, or xmllist for convenience
			if(this._data is Array && !(this._dataDescriptor is ArrayListCollectionDataDescriptor))
			{
				this._dataDescriptor = new ArrayListCollectionDataDescriptor();
			}
			else if(this._data is Vector.<Number> && !(this._dataDescriptor is VectorNumberListCollectionDataDescriptor))
			{
				this._dataDescriptor = new VectorNumberListCollectionDataDescriptor();
			}
			else if(this._data is Vector.<int> && !(this._dataDescriptor is VectorIntListCollectionDataDescriptor))
			{
				this._dataDescriptor = new VectorIntListCollectionDataDescriptor();
			}
			else if(this._data is Vector.<uint> && !(this._dataDescriptor is VectorUintListCollectionDataDescriptor))
			{
				this._dataDescriptor = new VectorUintListCollectionDataDescriptor();
			}
			else if(this._data is Vector.<*> && !(this._dataDescriptor is VectorListCollectionDataDescriptor))
			{
				this._dataDescriptor = new VectorListCollectionDataDescriptor();
			}
			else if(this._data is XMLList && !(this._dataDescriptor is XMLListListCollectionDataDescriptor))
			{
				this._dataDescriptor = new XMLListListCollectionDataDescriptor();
			}
			if(this._data === null)
			{
				this._dataDescriptor = null;
			}
			this.dispatchEventWith(CollectionEventType.RESET);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _dataDescriptor:IListCollectionDataDescriptor;

		/**
		 * Describes the underlying data source by translating APIs.
		 *
		 * @see IListCollectionDataDescriptor
		 */
		public function get dataDescriptor():IListCollectionDataDescriptor
		{
			return this._dataDescriptor;
		}

		/**
		 * @private
		 */
		public function set dataDescriptor(value:IListCollectionDataDescriptor):void
		{
			if(this._dataDescriptor == value)
			{
				return;
			}
			this._dataDescriptor = value;
			this.dispatchEventWith(CollectionEventType.RESET);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _pendingRefresh:Boolean = false;

		/**
		 * @private
		 */
		protected var _filterFunction:Function = null;

		/**
		 * @copy feathers.data.IListCollection#filterFunction
		 */
		public function get filterFunction():Function
		{
			return this._filterFunction;
		}

		/**
		 * @private
		 */
		public function set filterFunction(value:Function):void
		{
			if(this._filterFunction === value)
			{
				return;
			}
			this._filterFunction = value;
			this._pendingRefresh = true;
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.FILTER_CHANGE);
		}

		/**
		 * @private
		 */
		protected var _sortCompareFunction:Function = null;

		/**
		 * @copy feathers.data.IListCollection#sortCompareFunction
		 */
		public function get sortCompareFunction():Function
		{
			return this._sortCompareFunction;
		}

		/**
		 * @private
		 */
		public function set sortCompareFunction(value:Function):void
		{
			if(this._sortCompareFunction === value)
			{
				return;
			}
			this._sortCompareFunction = value;
			this._pendingRefresh = true;
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.SORT_CHANGE);
		}

		/**
		 * @copy feathers.data.IListCollection#length
		 */
		public function get length():int
		{
			if(!this._dataDescriptor)
			{
				return 0;
			}
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._localData !== null)
			{
				return this._localDataDescriptor.getLength(this._localData);
			}
			return this._dataDescriptor.getLength(this._data);
		}

		/**
		 * @copy feathers.data.IListCollection#refresh()
		 */
		public function refresh():void
		{
			if(this._filterFunction === null && this._sortCompareFunction === null)
			{
				return;
			}
			this._pendingRefresh = true;
			this.dispatchEventWith(Event.CHANGE);
			if(this._filterFunction !== null)
			{
				this.dispatchEventWith(CollectionEventType.FILTER_CHANGE);
			}
			if(this._sortCompareFunction !== null)
			{
				this.dispatchEventWith(CollectionEventType.SORT_CHANGE);
			}
		}

		/**
		 * @private
		 */
		protected function refreshFilterAndSort():void
		{
			this._pendingRefresh = false;
			if(this._filterFunction !== null)
			{
				var result:Array = this._localData;
				if(result !== null)
				{
					//reuse the old array to avoid garbage collection
					result.length = 0;
				}
				else
				{
					result = [];
				}
				var count:int = this._dataDescriptor.getLength(this._data);
				var pushIndex:int = 0;
				for(var i:int = 0; i < count; i++)
				{
					var item:Object = this._dataDescriptor.getItemAt(this._data, i);
					if(this._filterFunction(item))
					{
						result[pushIndex] = item;
						pushIndex++;
					}
				}
				this._localData = result;
				this._localDataDescriptor = new ArrayListCollectionDataDescriptor();
			}
			else if(this._sortCompareFunction !== null) //no filter
			{
				count = this._dataDescriptor.getLength(this._data);
				if(this._localData === null)
				{
					this._localData = new Array(count);
				}
				else
				{
					this._localData.length = count;
				}
				for(i = 0; i < count; i++)
				{
					this._localData[i] = this._dataDescriptor.getItemAt(this._data, i);
				}
				this._localDataDescriptor = new ArrayListCollectionDataDescriptor();
			}
			else //no filter or sort
			{
				this._localData = null;
				this._localDataDescriptor = null;
			}
			if(this._sortCompareFunction !== null)
			{
				this._localData.sort(this._sortCompareFunction);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#updateItemAt()
		 *
		 * @see #updateAll()
		 */
		public function updateItemAt(index:int):void
		{
			this.dispatchEventWith(CollectionEventType.UPDATE_ITEM, false, index);
		}

		/**
		 * @copy feathers.data.IListCollection#updateAll()
		 *
		 * @see #updateItemAt()
		 */
		public function updateAll():void
		{
			this.dispatchEventWith(CollectionEventType.UPDATE_ALL);
		}

		/**
		 * @copy feathers.data.IListCollection#getItemAt()
		 */
		public function getItemAt(index:int):Object
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._localData !== null)
			{
				return this._localDataDescriptor.getItemAt(this._localData, index);
			}
			return this._dataDescriptor.getItemAt(this._data, index);
		}

		/**
		 * @copy feathers.data.IListCollection#getItemIndex()
		 */
		public function getItemIndex(item:Object):int
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._localData !== null)
			{
				return this._localDataDescriptor.getItemIndex(this._localData, item);
			}
			return this._dataDescriptor.getItemIndex(this._data, item);
		}

		/**
		 * @copy feathers.data.IListCollection#addItemAt()
		 */
		public function addItemAt(item:Object, index:int):void
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._localData !== null)
			{
				if(index < this._localDataDescriptor.getLength(this._localData))
				{
					//find the item at the index in the filtered data, and use
					//its index from the unfiltered data
					var oldItem:Object = this._localDataDescriptor.getItemAt(this._localData, index);
					var unfilteredIndex:int = this._dataDescriptor.getItemIndex(this._data, oldItem);
				}
				else
				{
					//if the item is added at the end of the filtered data
					//then add it at the end of the unfiltered data
					unfilteredIndex = this._dataDescriptor.getLength(this._data);
				}
				//always add to the original data
				this._dataDescriptor.addItemAt(this._data, item, unfilteredIndex);
				//but check if the item should be in the filtered data
				var includeItem:Boolean = true;
				if(this._filterFunction !== null)
				{
					includeItem = this._filterFunction(item);
				}
				if(includeItem)
				{
					var sortedIndex:int = index;
					if(this._sortCompareFunction !== null)
					{
						sortedIndex = this.getSortedInsertionIndex(item);
					}
					this._localDataDescriptor.addItemAt(this._localData, item, sortedIndex);
					//don't dispatch these events if the item is filtered!
					this.dispatchEventWith(Event.CHANGE);
					this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, sortedIndex);
				}
			}
			else //no filter or sort
			{
				this._dataDescriptor.addItemAt(this._data, item, index);
				this.dispatchEventWith(Event.CHANGE);
				this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, index);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#removeItemAt()
		 */
		public function removeItemAt(index:int):Object
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._localData !== null)
			{
				var item:Object = this._localDataDescriptor.removeItemAt(this._localData, index);
				var unfilteredIndex:int = this._dataDescriptor.getItemIndex(this._data, item);
				this._dataDescriptor.removeItemAt(this._data, unfilteredIndex);
			}
			else
			{
				item = this._dataDescriptor.removeItemAt(this._data, index);
			}
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, index);
			return item;
		}

		/**
		 * @copy feathers.data.IListCollection#removeItem()
		 */
		public function removeItem(item:Object):void
		{
			var index:int = this.getItemIndex(item);
			if(index >= 0)
			{
				this.removeItemAt(index);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#removeAll()
		 */
		public function removeAll():void
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this.length == 0)
			{
				return;
			}
			if(this._localData !== null)
			{
				this._localDataDescriptor.removeAll(this._localData);
			}
			else
			{
				this._dataDescriptor.removeAll(this._data);
			}
			this.dispatchEventWith(CollectionEventType.REMOVE_ALL);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IListCollection#setItemAt()
		 */
		public function setItemAt(item:Object, index:int):void
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._localData !== null)
			{
				var oldItem:Object = this._localDataDescriptor.getItemAt(this._localData, index);
				var unfilteredIndex:int = this._dataDescriptor.getItemIndex(this._data, oldItem);
				this._dataDescriptor.setItemAt(this._data, item, unfilteredIndex);
				if(this._filterFunction !== null)
				{
					var includeItem:Boolean = this._filterFunction(item);
					if(includeItem)
					{
						this._localDataDescriptor.setItemAt(this._localData, item, index);
						this.dispatchEventWith(Event.CHANGE);
						this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, index);
						return;
					}
					else
					{
						//if the item is excluded, the item at this index is
						//removed instead of being replaced by the new item
						this._localDataDescriptor.removeItemAt(this._localData, index);
						this.dispatchEventWith(Event.CHANGE);
						this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, index);
					}
				}
				else if(this._sortCompareFunction !== null)
				{
					//remove the old item first!
					this._localDataDescriptor.removeItemAt(this._localData, index);
					//then try to figure out where the new item goes when inserted
					var sortedIndex:int = this.getSortedInsertionIndex(item);
					this._localDataDescriptor.setItemAt(this._localData, item, sortedIndex);
					this.dispatchEventWith(Event.CHANGE);
					this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, index);
					return;
				}
			}
			else //no filter or sort
			{
				this._dataDescriptor.setItemAt(this._data, item, index);
				this.dispatchEventWith(Event.CHANGE);
				this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, index);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#addItem()
		 */
		public function addItem(item:Object):void
		{
			this.addItemAt(item, this.length);
		}

		/**
		 * @copy feathers.data.IListCollection#push()
		 *
		 * @see #addItem()
		 */
		public function push(item:Object):void
		{
			this.addItemAt(item, this.length);
		}

		/**
		 * @copy feathers.data.IListCollection#addAll()
		 */
		public function addAll(collection:IListCollection):void
		{
			var otherCollectionLength:int = collection.length;
			for(var i:int = 0; i < otherCollectionLength; i++)
			{
				var item:Object = collection.getItemAt(i);
				this.addItem(item);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#addAllAt()
		 */
		public function addAllAt(collection:IListCollection, index:int):void
		{
			var otherCollectionLength:int = collection.length;
			var currentIndex:int = index;
			for(var i:int = 0; i < otherCollectionLength; i++)
			{
				var item:Object = collection.getItemAt(i);
				this.addItemAt(item, currentIndex);
				currentIndex++;
			}
		}

		/**
		 * @copy feathers.data.IListCollection#reset()
		 */
		public function reset(collection:IListCollection):void
		{
			this._dataDescriptor.removeAll(this._data);
			var otherCollectionLength:int = collection.length;
			for(var i:int = 0; i < otherCollectionLength; i++)
			{
				var item:Object = collection.getItemAt(i);
				this._dataDescriptor.addItemAt(this._data, item, i);
			}
			this.dispatchEventWith(CollectionEventType.RESET);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IListCollection#pop()
		 */
		public function pop():Object
		{
			return this.removeItemAt(this.length - 1);
		}

		/**
		 * @copy feathers.data.IListCollection#unshift()
		 */
		public function unshift(item:Object):void
		{
			this.addItemAt(item, 0);
		}

		/**
		 * @copy feathers.data.IListCollection#shift()
		 */
		public function shift():Object
		{
			return this.removeItemAt(0);
		}

		/**
		 * @copy feathers.data.IListCollection#contains()
		 */
		public function contains(item:Object):Boolean
		{
			return this.getItemIndex(item) >= 0;
		}

		/**
		 * @copy feathers.data.IListCollection#dispose()
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#dispose() starling.display.DisplayObject.dispose()
		 * @see http://doc.starling-framework.org/core/starling/textures/Texture.html#dispose() starling.textures.Texture.dispose()
		 */
		public function dispose(disposeItem:Function):void
		{
			//if we're disposing the collection, filters don't matter anymore,
			//and we should ensure that all items are disposed.
			this._filterFunction = null;
			this.refreshFilterAndSort();

			var itemCount:int = this.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = this.getItemAt(i);
				disposeItem(item);
			}
		}

		/**
		 * @private
		 */
		protected function getSortedInsertionIndex(item:Object):int
		{
			var itemCount:int = this._localDataDescriptor.getLength(this._localData);
			if(this._sortCompareFunction === null)
			{
				return itemCount;
			}
			for(var i:int = 0; i < itemCount; i++)
			{
				var otherItem:Object = this._localDataDescriptor.getItemAt(this._localData, i);
				var result:int = this._sortCompareFunction(item, otherItem);
				if(result < 1)
				{
					return i;
				}
			}
			return itemCount;
		}
	}
}

================================================
FILE: source/feathers/data/LocalAutoCompleteSource.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when the suggestions finish loading.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>A <code>ListCollection</code> containing
	 *   the suggestions to display.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.COMPLETE
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * Creates a list of suggestions for an <code>AutoComplete</code> component
	 * by searching through items in a <code>ListCollection</code>.
	 *
	 * @see feathers.controls.AutoComplete
	 * @see feathers.data.ListCollection
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class LocalAutoCompleteSource extends EventDispatcher implements IAutoCompleteSource
	{
		/**
		 * @private
		 */
		protected static function defaultCompareFunction(item:Object, textToMatch:String):Boolean
		{
			return item.toString().toLowerCase().indexOf(textToMatch.toLowerCase()) >= 0;
		}

		/**
		 * Constructor.
		 */
		public function LocalAutoCompleteSource(source:IListCollection = null)
		{
			this._dataProvider = source;
		}

		/**
		 * @private
		 */
		private var _dataProvider:IListCollection;

		/**
		 * A collection of items to be used as a source for auto-complete
		 * results.
		 */
		public function get dataProvider():IListCollection
		{
			return this._dataProvider;
		}

		/**
		 * @private
		 */
		public function set dataProvider(value:IListCollection):void
		{
			this._dataProvider = value;
		}

		/**
		 * @private
		 */
		protected var _compareFunction:Function = defaultCompareFunction;

		/**
		 * A function used to compare items from the data provider with the
		 * string passed to the <code>load()</code> function in order to
		 * generate a list of suggestions. The function should return
		 * <code>true</code> if the item should be included in the list of
		 * suggestions.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:Object, textToMatch:String ):Boolean</pre>
		 */
		public function get compareFunction():Function
		{
			return this._compareFunction;
		}

		/**
		 * @private
		 */
		public function set compareFunction(value:Function):void
		{
			if(value === null)
			{
				value = defaultCompareFunction;
			}
			this._compareFunction = value;
		}

		/**
		 * @copy feathers.data.IAutoCompleteSource#load()
		 */
		public function load(textToMatch:String, result:IListCollection = null):void
		{
			if(result)
			{
				result.removeAll();
			}
			else
			{
				result = new ArrayCollection();
			}
			if(!this._dataProvider || textToMatch.length == 0)
			{
				this.dispatchEventWith(Event.COMPLETE, false, result);
				return;
			}
			var compareFunction:Function = this._compareFunction;
			for(var i:int = 0; i < this._dataProvider.length; i++)
			{
				var item:Object = this._dataProvider.getItemAt(i);
				if(compareFunction(item, textToMatch))
				{
					result.addItem(item);
				}
			}
			this.dispatchEventWith(Event.COMPLETE, false, result);
		}
	}
}


================================================
FILE: source/feathers/data/SortOrder.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	/**
	 * Constants for sorting of items in a collection.
	 *
	 * <p>Note: Some constants may not be valid for certain properties. Please
	 * see the description of the property in the API reference for full
	 * details.</p>
	 *
	 * @productversion Feathers 3.4.0
	 */
	public class SortOrder
	{
		/**
		 * Indicates that items are sorted in ascending order.
		 *
		 * @productversion Feathers 3.4.0
		 */
		public static const ASCENDING:String = "ascending";

		/**
		 * Indicates that items are sorted in descending order.
		 *
		 * @productversion Feathers 3.4.0
		 */
		public static const DESCENDING:String = "descending";

		/**
		 * Indicates that items are not sorted.
		 *
		 * @productversion Feathers 3.4.0
		 */
		public static const NONE:String = "none";
	}
}

================================================
FILE: source/feathers/data/URLAutoCompleteSource.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import flash.events.ErrorEvent;
	import flash.events.Event;
	import flash.events.IOErrorEvent;
	import flash.events.SecurityErrorEvent;
	import flash.net.URLLoader;
	import flash.net.URLLoaderDataFormat;
	import flash.net.URLRequest;

	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when the suggestions finish loading.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>A <code>ListCollection</code> containing
	 *   the suggestions to display.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.COMPLETE
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * Creates a list of suggestions for an <code>AutoComplete</code> component
	 * by loading data from a URL.
	 *
	 * <p>Data may be filtered on the server or on the client. The
	 * <code>urlRequestFunction</code> may be used to include the text from the
	 * <code>AutoComplete</code> in the request sent to the server.
	 * Alternatively, the <code>parseResultFunction</code> may filter the
	 * result on the client.</p>
	 *
	 * <p>By default, the <code>URLAutoCompleteSource</code> will parse a JSON
	 * string. However, a custom <code>parseResultFunction</code> may be
	 * provided to parse other formats.</p>
	 *
	 * @see feathers.controls.AutoComplete
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class URLAutoCompleteSource extends EventDispatcher implements IAutoCompleteSource
	{
		/**
		 * @private
		 */
		protected static function defaultParseResultFunction(result:String):Object
		{
			return JSON.parse(result);
		}

		/**
		 * Constructor.
		 */
		public function URLAutoCompleteSource(urlRequestFunction:Function, parseResultFunction:Function = null)
		{
			this.urlRequestFunction = urlRequestFunction;
			this.parseResultFunction = parseResultFunction;
		}

		/**
		 * @private
		 */
		protected var _cachedResult:String;

		/**
		 * @private
		 */
		protected var _urlRequestFunction:Function;

		/**
		 * A function called by the auto-complete source that builds the
		 * <code>flash.net.URLRequest</code> that is to be loaded.
		 *
		 * <p>The function is expected to have one of the following signatures:</p>
		 * <pre>function( textToMatch:String ):URLRequest</pre>
		 * <pre>function():URLRequest</pre>
		 *
		 * <p>The function may optionally accept one argument, the text
		 * entered into the <code>AutoComplete</code> component. If available,
		 * this argument should be included in the <code>URLRequest</code>, and
		 * the server-side script should use it to return a pre-filtered result.
		 * Alternatively, if the function accepts zero arguments, a static URL
		 * will be called, and the <code>parseResultFunction</code> may be used
		 * to filter the result on the client side instead.</p>
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/net/URLRequest.html Full description of flash.net.URLRequest in Adobe's Flash Platform API Reference
		 * @see #parseResultFunction
		 */
		public function get urlRequestFunction():Function
		{
			return this._urlRequestFunction;
		}

		/**
		 * @private
		 */
		public function set urlRequestFunction(value:Function):void
		{
			if(this._urlRequestFunction === value)
			{
				return;
			}
			this._urlRequestFunction = value;
			this._cachedResult = null;
		}

		/**
		 * @private
		 */
		protected var _parseResultFunction:Function = defaultParseResultFunction;

		/**
		 * A function that parses the result loaded from the URL. Any plain-text
		 * data format may be accepted by providing a custom parse function. The
		 * default function parses the result as JSON.
		 *
		 * <p>The function is expected to have one of the following signatures:</p>
		 * <pre>function( loadedText:String ):Object</pre>
		 * <pre>function( loadedText:String, textToMatch:String ):Object</pre>
		 *
		 * <p>The function may accept one or two arguments. The first argument
		 * is always the plain-text result returned from the URL. Optionally,
		 * the second argument is the text entered into the
		 * <code>AutoComplete</code> component. It may be used to filter the
		 * result on the client side. It is meant to be used when the
		 * <code>urlRequestFunction</code> accepts zero arguments and does not
		 * pass the text entered into the <code>AutoComplete</code> component
		 * to the server.</p>
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/JSON.html#parse() Full description of JSON.parse() in Adobe's Flash Platform API Reference
		 * @see #urlRequestFunction
		 */
		public function get parseResultFunction():Function
		{
			return this._parseResultFunction;
		}

		/**
		 * @private
		 */
		public function set parseResultFunction(value:Function):void
		{
			if(value === null)
			{
				value = defaultParseResultFunction;
			}
			if(this._parseResultFunction === value)
			{
				return;
			}
			this._parseResultFunction = value;
			this._cachedResult = null;
		}

		/**
		 * @private
		 */
		protected var _intermediateCollection:ListCollection = new ListCollection();

		/**
		 * @private
		 */
		protected var _savedSuggestionsCollection:IListCollection;

		/**
		 * @private
		 */
		protected var _savedTextToMatch:String;

		/**
		 * @private
		 */
		protected var _urlLoader:URLLoader;

		/**
		 * @copy feathers.data.IAutoCompleteSource#load()
		 */
		public function load(textToMatch:String, suggestionsResult:IListCollection = null):void
		{
			if(!suggestionsResult)
			{
				suggestionsResult = new ArrayCollection();
			}
			var urlRequestFunction:Function = this._urlRequestFunction;
			var request:URLRequest;
			if(urlRequestFunction.length == 1)
			{
				request = URLRequest(urlRequestFunction(textToMatch));
			}
			else
			{
				if(this._cachedResult !== null)
				{
					this.parseData(this._cachedResult, textToMatch, suggestionsResult);
					return;
				}
				request = URLRequest(urlRequestFunction());
			}
			this._savedSuggestionsCollection = suggestionsResult;
			this._savedTextToMatch = textToMatch;
			if(this._urlLoader)
			{
				this._urlLoader.close();
			}
			else
			{
				this._urlLoader = new URLLoader();
				this._urlLoader.dataFormat = URLLoaderDataFormat.TEXT;
				this._urlLoader.addEventListener(flash.events.Event.COMPLETE, urlLoader_completeHandler);
				this._urlLoader.addEventListener(IOErrorEvent.IO_ERROR, urlLoader_errorHandler);
				this._urlLoader.addEventListener(SecurityErrorEvent.SECURITY_ERROR, urlLoader_errorHandler);
			}
			this._urlLoader.load(request);
		}

		/**
		 * @private
		 */
		protected function parseData(resultText:String, textToMatch:String, suggestions:IListCollection):void
		{
			var parseResultFunction:Function = this._parseResultFunction;
			if(parseResultFunction.length == 2)
			{
				//this is kind of hacky, and maybe it would be better to modify
				//parseResultFunction to return an IListCollection
				this._intermediateCollection.data = parseResultFunction(resultText, textToMatch);
			}
			else
			{
				this._intermediateCollection.data = parseResultFunction(resultText);
			}
			suggestions.reset(this._intermediateCollection);
			this.dispatchEventWith(starling.events.Event.COMPLETE, false, suggestions);
		}

		/**
		 * @private
		 */
		protected function urlLoader_completeHandler(event:flash.events.Event):void
		{
			var suggestions:IListCollection = this._savedSuggestionsCollection;
			this._savedSuggestionsCollection = null;
			var textToMatch:String = this._savedTextToMatch;
			this._savedTextToMatch = null;

			var loadedData:String = this._urlLoader.data as String;
			if(this._urlRequestFunction.length == 0)
			{
				this._cachedResult = loadedData;
			}
			if(loadedData)
			{
				this.parseData(loadedData, textToMatch, suggestions);
			}
			else
			{
				suggestions.removeAll();
				this.dispatchEventWith(starling.events.Event.COMPLETE, false, suggestions);
			}
		}

		/**
		 * @private
		 */
		protected function urlLoader_errorHandler(event:ErrorEvent):void
		{
			var result:IListCollection = this._savedSuggestionsCollection;
			result.removeAll();
			this._savedSuggestionsCollection = null;
			this.dispatchEventWith(starling.events.Event.COMPLETE, false, result);
		}

	}
}


================================================
FILE: source/feathers/data/VectorCollection.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import feathers.events.CollectionEventType;

	import starling.events.Event;
	import starling.events.EventDispatcher;

	[Exclude(name="data",kind="property")]

	/**
	 * Dispatched when the underlying data source changes and components will
	 * need to redraw the data.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the collection has changed drastically, such as when
	 * the underlying data source is replaced completely.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.RESET
	 */
	[Event(name="reset",type="starling.events.Event")]

	/**
	 * Dispatched when an item is added to the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * added. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.ADD_ITEM
	 */
	[Event(name="addItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is removed from the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * removed. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REMOVE_ITEM
	 */
	[Event(name="removeItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is replaced in the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * replaced. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REPLACE_ITEM
	 */
	[Event(name="replaceItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateItemAt()</code> function is called on the
	 * <code>ListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * updated. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateItemAt()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ITEM
	 */
	[Event(name="updateItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateAll()</code> function is called on the
	 * <code>ListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateAll()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ALL
	 */
	[Event(name="updateAll",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>filterFunction</code> property changes or the
	 * <code>refresh()</code> function is called on the <code>IListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #filterFunction
	 * @see #refresh()
	 *
	 * @eventType feathers.events.CollectionEventType.FILTER_CHANGE
	 */
	[Event(name="filterChange",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>sortCompareFunction</code> property changes or
	 * the <code>refresh()</code> function is called on the <code>IListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #sortCompareFunction
	 * @see #refresh()
	 *
	 * @eventType feathers.events.CollectionEventType.SORT_CHANGE
	 */
	[Event(name="sortChange",type="starling.events.Event")]

	/**
	 * Wraps a <code>Vector</code> in the common <code>IListCollection</code>
	 * API used by many Feathers UI controls, including <code>List</code> and
	 * <code>TabBar</code>.
	 *
	 * @productversion Feathers 3.3.0
	 */
	public class VectorCollection extends EventDispatcher implements IListCollection
	{
		/**
		 * Constructor
		 */
		public function VectorCollection(data:Object = null)
		{
			if(data === null)
			{
				data = new <*>[];
			}
			else if(!(data is Vector.<*>))
			{
				throw new ArgumentError("VectorCollection data must be of type Vector");
			}
			this._vectorData = data;
		}

		/**
		 * @private
		 */
		protected var _filterAndSortData:Object;

		/**
		 * @private
		 * Due to bugs in the older ASC1 compiler, we cannot type this variable
		 * as Vector.<*>. It will result in failures decoding abc bytecode.
		 */
		protected var _vectorData:Object;

		/**
		 * The <code>Vector</code> data source for this collection.
		 *
		 * <p>Note: Ideally, this property would be typed as something other
		 * than <code>Object</code>, but there is no type that will accept all
		 * <code>Vector</code> objects without requiring a cast first.</p>
		 */
		public function get vectorData():Object
		{
			return this._vectorData;
		}

		/**
		 * @private
		 */
		public function set vectorData(value:Object):void
		{
			if(this._vectorData === value)
			{
				return;
			}
			else if(value !== null && !(value is Vector.<*>))
			{
				throw new ArgumentError("VectorCollection vectorData must be of type Vector");
			}
			this._vectorData = value as Vector.<*>;
			this.dispatchEventWith(CollectionEventType.RESET);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _pendingRefresh:Boolean = false;

		/**
		 * @private
		 */
		protected var _filterFunction:Function = null;

		/**
		 * @copy feathers.data.IListCollection#filterFunction
		 */
		public function get filterFunction():Function
		{
			return this._filterFunction;
		}

		/**
		 * @private
		 */
		public function set filterFunction(value:Function):void
		{
			if(this._filterFunction === value)
			{
				return;
			}
			this._filterFunction = value;
			this._pendingRefresh = true;
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.FILTER_CHANGE);
		}

		/**
		 * @private
		 */
		protected var _sortCompareFunction:Function = null;

		/**
		 * @copy feathers.data.IListCollection#sortCompareFunction
		 */
		public function get sortCompareFunction():Function
		{
			return this._sortCompareFunction;
		}

		/**
		 * @private
		 */
		public function set sortCompareFunction(value:Function):void
		{
			if(this._sortCompareFunction === value)
			{
				return;
			}
			this._sortCompareFunction = value;
			this._pendingRefresh = true;
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.SORT_CHANGE);
		}

		/**
		 * @copy feathers.data.IListCollection#length
		 */
		public function get length():int
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._filterAndSortData !== null)
			{
				return (this._filterAndSortData as Vector.<*>).length;
			}
			return (this._vectorData as Vector.<*>).length;
		}

		/**
		 * @copy feathers.data.IListCollection#refreshFilter()
		 */
		public function refresh():void
		{
			if(this._filterFunction === null && this._sortCompareFunction === null)
			{
				return;
			}
			this._pendingRefresh = true;
			this.dispatchEventWith(Event.CHANGE);
			if(this._filterFunction !== null)
			{
				this.dispatchEventWith(CollectionEventType.FILTER_CHANGE);
			}
			if(this._sortCompareFunction !== null)
			{
				this.dispatchEventWith(CollectionEventType.SORT_CHANGE);
			}
		}

		/**
		 * @private
		 */
		protected function refreshFilterAndSort():void
		{
			this._pendingRefresh = false;
			if(this._filterFunction !== null)
			{
				var result:Vector.<*> = this._filterAndSortData as Vector.<*>;
				if(result !== null)
				{
					//reuse the old array to avoid garbage collection
					result.length = 0;
				}
				else
				{
					result = new <*>[];
				}
				var vectorData:Vector.<*> = this._vectorData as Vector.<*>;
				var itemCount:int = vectorData.length;
				var pushIndex:int = 0;
				for(var i:int = 0; i < itemCount; i++)
				{
					var item:Object = vectorData[i];
					if(this._filterFunction(item))
					{
						result[pushIndex] = item;
						pushIndex++;
					}
				}
				this._filterAndSortData = result;
			}
			else if(this._sortCompareFunction !== null) //no filter
			{
				itemCount = this._vectorData.length;
				result = this._filterAndSortData as Vector.<*>;
				if(result !== null)
				{
					result.length = itemCount;
					for(i = 0; i < itemCount; i++)
					{
						result[i] = this._vectorData[i];
					}
				}
				else
				{
					//simply make a copy!
					result = this._vectorData.slice();
				}
				this._filterAndSortData = result;
			}
			else //no filter or sort
			{
				this._filterAndSortData = null;
			}
			if(this._sortCompareFunction !== null)
			{
				this._filterAndSortData.sort(this._sortCompareFunction);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#updateItemAt()
		 *
		 * @see #updateAll()
		 */
		public function updateItemAt(index:int):void
		{
			this.dispatchEventWith(CollectionEventType.UPDATE_ITEM, false, index);
		}

		/**
		 * @copy feathers.data.IListCollection#updateAll()
		 *
		 * @see #updateItemAt()
		 */
		public function updateAll():void
		{
			this.dispatchEventWith(CollectionEventType.UPDATE_ALL);
		}

		/**
		 * @copy feathers.data.IListCollection#getItemAt()
		 */
		public function getItemAt(index:int):Object
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._filterAndSortData !== null)
			{
				return this._filterAndSortData[index];
			}
			return (this._vectorData as Vector.<*>)[index];
		}

		/**
		 * @copy feathers.data.IListCollection#getItemIndex()
		 */
		public function getItemIndex(item:Object):int
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._filterAndSortData !== null)
			{
				return (this._filterAndSortData as Vector.<*>).indexOf(item);
			}
			return (this._vectorData as Vector.<*>).indexOf(item);
		}

		/**
		 * @copy feathers.data.IListCollection#addItemAt()
		 */
		public function addItemAt(item:Object, index:int):void
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			var filteredData:Vector.<*> = this._filterAndSortData as Vector.<*>;
			var vectorData:Vector.<*> = this._vectorData as Vector.<*>;
			if(this._filterAndSortData !== null)
			{
				if(index < filteredData.length)
				{
					//find the item at the index in the filtered data, and use
					//its index from the unfiltered data
					var oldItem:Object = filteredData[index];
					var unfilteredIndex:int = vectorData.indexOf(oldItem);
				}
				else
				{
					//if the item is added at the end of the filtered data
					//then add it at the end of the unfiltered data
					unfilteredIndex = vectorData.length;
				}
				//always add to the original data
				vectorData.insertAt(unfilteredIndex, item);
				//but check if the item should be in the filtered data
				var includeItem:Boolean = true;
				if(this._filterFunction !== null)
				{
					includeItem = this._filterFunction(item);
				}
				if(includeItem)
				{
					var sortedIndex:int = index;
					if(this._sortCompareFunction !== null)
					{
						sortedIndex = this.getSortedInsertionIndex(item);
					}
					filteredData.insertAt(sortedIndex, item);
					//don't dispatch these events if the item is filtered!
					this.dispatchEventWith(Event.CHANGE);
					this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, sortedIndex);
				}
			}
			else //no filter or sort
			{
				vectorData.insertAt(index, item);
				this.dispatchEventWith(Event.CHANGE);
				this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, index);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#removeItemAt()
		 */
		public function removeItemAt(index:int):Object
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			var filteredData:Vector.<*> = this._filterAndSortData as Vector.<*>;
			var vectorData:Vector.<*> = this._vectorData as Vector.<*>;
			if(this._filterAndSortData !== null)
			{
				var item:Object = filteredData.removeAt(index);
				var unfilteredIndex:int = vectorData.indexOf(item);
				vectorData.removeAt(unfilteredIndex);
			}
			else
			{
				item = vectorData.removeAt(index);
			}
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, index);
			return item;
		}

		/**
		 * @copy feathers.data.IListCollection#removeItem()
		 */
		public function removeItem(item:Object):void
		{
			var index:int = this.getItemIndex(item);
			if(index >= 0)
			{
				this.removeItemAt(index);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#removeAll()
		 */
		public function removeAll():void
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this.length == 0)
			{
				return;
			}
			if(this._filterAndSortData !== null)
			{
				(this._filterAndSortData as Vector.<*>).length = 0;
			}
			else
			{
				(this._vectorData as Vector.<*>).length = 0;
			}
			this.dispatchEventWith(CollectionEventType.REMOVE_ALL);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IListCollection#setItemAt()
		 */
		public function setItemAt(item:Object, index:int):void
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			var filteredData:Vector.<*> = this._filterAndSortData as Vector.<*>;
			var vectorData:Vector.<*> = this._vectorData as Vector.<*>;
			if(this._filterAndSortData !== null)
			{
				var oldItem:Object = filteredData[index];
				var unfilteredIndex:int = vectorData.indexOf(oldItem);
				vectorData[unfilteredIndex] = item;
				if(this._filterFunction !== null)
				{
					var includeItem:Boolean = this._filterFunction(item);
					if(includeItem)
					{
						filteredData[index] = item;
						this.dispatchEventWith(Event.CHANGE);
						this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, index);
						return;
					}
					else
					{
						//if the item is excluded, the item at this index is
						//removed instead of being replaced by the new item
						filteredData.removeAt(index);
						this.dispatchEventWith(Event.CHANGE);
						this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, index);
						return;
					}
				}
				else if(this._sortCompareFunction !== null)
				{
					//remove the old item first!
					this._filterAndSortData.removeAt(index);
					//then try to figure out where the new item goes when inserted
					var sortedIndex:int = this.getSortedInsertionIndex(item);
					this._filterAndSortData[sortedIndex] = item;
					this.dispatchEventWith(Event.CHANGE);
					this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, index);
					return;
				}
			}
			else //no filter or sort
			{
				vectorData[index] = item;
				this.dispatchEventWith(Event.CHANGE);
				this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, index);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#addItem()
		 */
		public function addItem(item:Object):void
		{
			this.addItemAt(item, this.length);
		}

		/**
		 * @copy feathers.data.IListCollection#push()
		 *
		 * @see #addItem()
		 */
		public function push(item:Object):void
		{
			this.addItemAt(item, this.length);
		}

		/**
		 * @copy feathers.data.IListCollection#addAll()
		 */
		public function addAll(collection:IListCollection):void
		{
			var otherCollectionLength:int = collection.length;
			var vectorData:Vector.<*> = this._vectorData as Vector.<*>;
			var pushIndex:int = vectorData.length;
			for(var i:int = 0; i < otherCollectionLength; i++)
			{
				var item:Object = collection.getItemAt(i);
				vectorData[pushIndex] = item;
				pushIndex++;
			}
		}

		/**
		 * @copy feathers.data.IListCollection#addAllAt()
		 */
		public function addAllAt(collection:IListCollection, index:int):void
		{
			var otherCollectionLength:int = collection.length;
			var currentIndex:int = index;
			var vectorData:Vector.<*> = this._vectorData as Vector.<*>;
			for(var i:int = 0; i < otherCollectionLength; i++)
			{
				var item:Object = collection.getItemAt(i);
				vectorData.insertAt(currentIndex, item);
				currentIndex++;
			}
		}

		/**
		 * @copy feathers.data.IListCollection#reset()
		 */
		public function reset(collection:IListCollection):void
		{
			var vectorData:Vector.<*> = this._vectorData as Vector.<*>;
			vectorData.length = 0;
			var otherCollectionLength:int = collection.length;
			for(var i:int = 0; i < otherCollectionLength; i++)
			{
				var item:Object = collection.getItemAt(i);
				vectorData[i] = item;
			}
			this.dispatchEventWith(CollectionEventType.RESET);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IListCollection#pop()
		 */
		public function pop():Object
		{
			return this.removeItemAt(this.length - 1);
		}

		/**
		 * @copy feathers.data.IListCollection#unshift()
		 */
		public function unshift(item:Object):void
		{
			this.addItemAt(item, 0);
		}

		/**
		 * @copy feathers.data.IListCollection#shift()
		 */
		public function shift():Object
		{
			return this.removeItemAt(0);
		}

		/**
		 * @copy feathers.data.IListCollection#contains()
		 */
		public function contains(item:Object):Boolean
		{
			return (this._vectorData as Vector.<*>).indexOf(item) != -1;
		}

		/**
		 * @copy feathers.data.IListCollection#dispose()
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#dispose() starling.display.DisplayObject.dispose()
		 * @see http://doc.starling-framework.org/core/starling/textures/Texture.html#dispose() starling.textures.Texture.dispose()
		 */
		public function dispose(disposeItem:Function):void
		{
			//if we're disposing the collection, filters don't matter anymore,
			//and we should ensure that all items are disposed.
			this._filterFunction = null;
			this.refreshFilterAndSort();

			var vectorData:Vector.<*> = this._vectorData as Vector.<*>;
			var itemCount:int = vectorData.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = vectorData[i];
				disposeItem(item);
			}
		}

		/**
		 * @private
		 */
		protected function getSortedInsertionIndex(item:Object):int
		{
			var itemCount:int = this._filterAndSortData.length;
			if(this._sortCompareFunction === null)
			{
				return itemCount;
			}
			for(var i:int = 0; i < itemCount; i++)
			{
				var otherItem:Object = this._filterAndSortData[i];
				var result:int = this._sortCompareFunction(item, otherItem);
				if(result < 1)
				{
					return i;
				}
			}
			return itemCount;
		}
	}
}


================================================
FILE: source/feathers/data/VectorHierarchicalCollection.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import feathers.events.CollectionEventType;

	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when the underlying data source changes and components will
	 * need to redraw the data.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the collection has changed drastically, such as when
	 * the underlying data source is replaced completely.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.RESET
	 */
	[Event(name="reset",type="starling.events.Event")]

	/**
	 * Dispatched when an item is added to the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been added. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.ADD_ITEM
	 */
	[Event(name="addItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is removed from the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been removed. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REMOVE_ITEM
	 */
	[Event(name="removeItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is replaced in the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been replaced. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REPLACE_ITEM
	 */
	[Event(name="replaceItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateItemAt()</code> function is called on the
	 * hierarchical collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been updated. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateItemAt()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ITEM
	 */
	[Event(name="updateItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateAll()</code> function is called on the
	 * hierarchical collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateAll()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ALL
	 */
	[Event(name="updateAll",type="starling.events.Event")]

	/**
	 * Wraps a <code>Vector</code> data source with a common API for use with
	 * UI controls that support hierarchical data.
	 *
	 * @productversion Feathers 3.3.0
	 */
	public class VectorHierarchicalCollection extends EventDispatcher implements IHierarchicalCollection
	{
		/**
		 * Constructor.
		 */
		public function VectorHierarchicalCollection(vectorData:Object = null)
		{
			if(vectorData === null)
			{
				vectorData = new <*>[];
			}
			else if(!(vectorData is Vector.<*>))
			{
				throw new ArgumentError("VectorHierarchicalCollection data must be of type Vector");
			}
			this._vectorData = vectorData as Vector.<*>;
		}

		/**
		 * @private
		 * Due to bugs in the older ASC1 compiler, we cannot type this variable
		 * as Vector.<*>. It will result in failures decoding abc bytecode.
		 */
		protected var _vectorData:Object = null;

		/**
		 * The <code>Vector</code> data source for this collection.
		 *
		 * <p>Note: Ideally, this property would be typed as something other
		 * than <code>Object</code>, but there is no type that will accept all
		 * <code>Vector</code> objects without requiring a cast first.</p>
		 */
		public function get vectorData():Object
		{
			return this._vectorData;
		}

		/**
		 * @private
		 */
		public function set vectorData(value:Object):void
		{
			if(this._vectorData === value)
			{
				return;
			}
			else if(value !== null && !(value is Vector.<*>))
			{
				throw new ArgumentError("VectorHierarchicalCollection vectorData must be of type Vector");
			}
			this._vectorData = value as Vector.<*>;
			this.dispatchEventWith(CollectionEventType.RESET);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _childrenField:String = "children";

		/**
		 * The field of a branch object used to access its children. The
		 * field's type must be <code>Vector</code> to be treated as a branch.
		 */
		public function get childrenField():String
		{
			return this._childrenField;
		}

		public function set childrenField(value:String):void
		{
			this._childrenField = value;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#isBranch()
		 */
		public function isBranch(node:Object):Boolean
		{
			if(node === null)
			{
				return false;
			}
			return node.hasOwnProperty(this._childrenField) && node[this._childrenField] is Vector.<*>;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getLength()
		 *
		 * @see #getLengthAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function getLength(...rest:Array):int
		{
			var branch:Vector.<*> = this._vectorData as Vector.<*>;
			var indexCount:int = rest.length;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = rest[i] as int;
				branch = branch[index][this._childrenField] as Vector.<*>;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + rest);
				}
			}
			return branch.length;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getLengthAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function getLengthAtLocation(location:Vector.<int> = null):int
		{
			var branch:Vector.<*> = this._vectorData as Vector.<*>;
			if(location !== null)
			{
				var indexCount:int = location.length;
				for(var i:int = 0; i < indexCount; i++)
				{
					var index:int = location[i];
					branch = branch[index][this._childrenField] as Vector.<*>;
					if(branch === null)
					{
						throw new RangeError("Branch not found at location: " + location);
					}
				}
			}
			return branch.length;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#updateItemAt()
		 *
		 * @see #updateAll()
		 */
		public function updateItemAt(index:int, ...rest:Array):void
		{
			rest.insertAt(0, index);
			this.dispatchEventWith(CollectionEventType.UPDATE_ITEM, false, rest);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#updateAll()
		 *
		 * @see #updateItemAt()
		 */
		public function updateAll():void
		{
			this.dispatchEventWith(CollectionEventType.UPDATE_ALL);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getItemAt()
		 *
		 * @see #getItemAtLocation()
		 */
		public function getItemAt(index:int, ...rest:Array):Object
		{
			rest.insertAt(0, index);
			var branch:Vector.<*> = this._vectorData as Vector.<*>;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				branch = branch[index][this._childrenField] as Vector.<*>;
				if(branch === null)
				{
					return null;
				}
			}
			var lastIndex:int = rest[indexCount] as int;
			return branch[lastIndex];
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getItemAtLocation()
		 */
		public function getItemAtLocation(location:Vector.<int>):Object
		{
			if(location === null || location.length == 0)
			{
				return null;
			}
			var branch:Vector.<*> = this._vectorData as Vector.<*>;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				branch = branch[index][this._childrenField] as Vector.<*>;
				if(branch === null)
				{
					return null;
				}
			}
			index = location[indexCount];
			return branch[index];
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getItemLocation()
		 */
		public function getItemLocation(item:Object, result:Vector.<int> = null):Vector.<int>
		{
			if(!result)
			{
				result = new <int>[];
			}
			else
			{
				result.length = 0;
			}
			var branch:Vector.<*> = this._vectorData as Vector.<*>;
			this.findItemInBranch(branch, item, result);
			return result;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#addItemAt()
		 *
		 * @see #addItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function addItemAt(item:Object, index:int, ...rest:Array):void
		{
			rest.insertAt(0, index);
			var branch:Vector.<*> = this._vectorData as Vector.<*>;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				branch = branch[index][this._childrenField] as Vector.<*>;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + rest);
				}
			}
			index = rest[indexCount] as int;
			branch.insertAt(index, item);
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, rest);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#addItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function addItemAtLocation(item:Object, location:Vector.<int>):void
		{
			if(location === null || location.length == 0)
			{
				throw new RangeError("Branch not found at location: " + location);
			}
			var eventIndices:Array = [];
			var branch:Vector.<*> = this._vectorData as Vector.<*>;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				branch = branch[index][this._childrenField] as Vector.<*>;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + location);
				}
				eventIndices[i] = index;
			}
			index = location[indexCount];
			eventIndices[indexCount] = index;
			branch.insertAt(index, item);
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, eventIndices);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeItemAt()
		 *
		 * @see #removeItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function removeItemAt(index:int, ...rest:Array):Object
		{
			rest.insertAt(0, index);
			var branch:Vector.<*> = this._vectorData as Vector.<*>;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				branch = branch[index][this._childrenField] as Vector.<*>;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + rest);
				}
			}
			index = rest[indexCount] as int;
			var item:Object = branch.removeAt(index);
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, rest);
			return item;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function removeItemAtLocation(location:Vector.<int>):Object
		{
			if(location === null || location.length == 0)
			{
				throw new RangeError("Branch not found at location: " + location);
			}
			var eventIndices:Array = [];
			var branch:Vector.<*> = this._vectorData as Vector.<*>;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				branch = branch[index][this._childrenField] as Vector.<*>;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + location);
				}
				eventIndices[i] = index;
			}
			index = location[indexCount];
			eventIndices[indexCount] = index;
			var item:Object = branch.removeAt(index);
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, eventIndices);
			return item;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeItem()
		 */
		public function removeItem(item:Object):void
		{
			var location:Vector.<int> = this.getItemLocation(item);
			if(location !== null)
			{
				this.removeItemAtLocation(location);
			}
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeAll()
		 */
		public function removeAll():void
		{
			if(this.getLength() == 0)
			{
				return;
			}
			this._vectorData.length = 0;
			this.dispatchEventWith(CollectionEventType.REMOVE_ALL);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#setItemAt()
		 *
		 * @see #setItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function setItemAt(item:Object, index:int, ...rest:Array):void
		{
			rest.insertAt(0, index);
			var branch:Vector.<*> = this._vectorData as Vector.<*>;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				branch = branch[index][this._childrenField] as Vector.<*>;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + rest);
				}
			}
			index = rest[indexCount] as int;
			branch[index] = item;
			this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, rest);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#setItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function setItemAtLocation(item:Object, location:Vector.<int>):void
		{
			if(location === null || location.length == 0)
			{
				throw new RangeError("Branch not found at location: " + location);
			}
			var eventIndices:Array = [];
			var branch:Vector.<*> = this._vectorData as Vector.<*>;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				branch = branch[index][this._childrenField] as Vector.<*>;
				if(branch === null)
				{
					throw new RangeError("Branch not found at location: " + location);
				}
				eventIndices[i] = index;
			}
			index = location[indexCount];
			eventIndices[indexCount] = index;
			branch[index] = item;
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, eventIndices);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#dispose()
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#dispose() starling.display.DisplayObject.dispose()
		 * @see http://doc.starling-framework.org/core/starling/textures/Texture.html#dispose() starling.textures.Texture.dispose()
		 */
		public function dispose(disposeBranch:Function, disposeItem:Function):void
		{
			var groupCount:int = this._vectorData.length;
			var path:Array = [];
			for(var i:int = 0; i < groupCount; i++)
			{
				var group:Object = this._vectorData[i];
				path[0] = i;
				this.disposeGroupInternal(group, path, disposeBranch, disposeItem);
				path.length = 0;
			}
		}

		/**
		 * @private
		 */
		protected function disposeGroupInternal(group:Object, path:Array, disposeBranch:Function, disposeItem:Function):void
		{
			if(disposeBranch !== null)
			{
				disposeBranch(group);
			}

			var itemCount:int = this.getLength.apply(this, path);
			for(var i:int = 0; i < itemCount; i++)
			{
				path[path.length] = i;
				var item:Object = this.getItemAt.apply(this, path);
				if(this.isBranch(item))
				{
					this.disposeGroupInternal(item, path, disposeBranch, disposeItem);
				}
				else if(disposeItem !== null)
				{
					disposeItem(item);
				}
				path.length--;
			}
		}

		/**
		 * @private
		 */
		protected function findItemInBranch(branch:Object, item:Object, result:Vector.<int>):Boolean
		{
			var branchVector:Vector.<*> = branch as Vector.<*>;
			var insertIndex:int = result.length;
			var branchLength:int = branchVector.length;
			for(var i:int = 0; i < branchLength; i++)
			{
				var branchItem:Object = branchVector[i];
				if(branchItem === item)
				{
					result[insertIndex] = i;
					return true;
				}
				if(this.isBranch(branchItem))
				{
					result[insertIndex] = i;
					var children:Vector.<*> = branchItem[this._childrenField] as Vector.<*>;
					var isFound:Boolean = this.findItemInBranch(children, item, result);
					if(isFound)
					{
						return true;
					}
					result.pop();
				}
			}
			return false;
		}
	}
}


================================================
FILE: source/feathers/data/VectorIntListCollectionDataDescriptor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import flash.errors.IllegalOperationError;

	/**
	 * An <code>IListCollectionDataDescriptor</code> implementation for Vector.&lt;int&gt;.
	 *
	 * @see ListCollection
	 * @see IListCollectionDataDescriptor
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class VectorIntListCollectionDataDescriptor implements IListCollectionDataDescriptor
	{
		/**
		 * Constructor.
		 */
		public function VectorIntListCollectionDataDescriptor()
		{
		}

		/**
		 * @inheritDoc
		 */
		public function getLength(data:Object):int
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<int>).length;
		}

		/**
		 * @inheritDoc
		 */
		public function getItemAt(data:Object, index:int):Object
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<int>)[index];
		}

		/**
		 * @inheritDoc
		 */
		public function setItemAt(data:Object, item:Object, index:int):void
		{
			this.checkForCorrectDataType(data);
			(data as Vector.<int>)[index] = item as int;
		}

		/**
		 * @inheritDoc
		 */
		public function addItemAt(data:Object, item:Object, index:int):void
		{
			this.checkForCorrectDataType(data);
			(data as Vector.<int>).insertAt(index, item as int);
		}

		/**
		 * @inheritDoc
		 */
		public function removeItemAt(data:Object, index:int):Object
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<int>).removeAt(index);
		}

		/**
		 * @inheritDoc
		 */
		public function removeAll(data:Object):void
		{
			this.checkForCorrectDataType(data);
			(data as Vector.<int>).length = 0;
		}

		/**
		 * @inheritDoc
		 */
		public function getItemIndex(data:Object, item:Object):int
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<int>).indexOf(item as int);
		}

		/**
		 * @private
		 */
		protected function checkForCorrectDataType(data:Object):void
		{
			if(!(data is Vector.<int>))
			{
				throw new IllegalOperationError("Expected Vector.<int>. Received " + Object(data).constructor + " instead.");
			}
		}
	}
}

================================================
FILE: source/feathers/data/VectorListCollectionDataDescriptor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import flash.errors.IllegalOperationError;

	/**
	 * An <code>IListCollectionDataDescriptor</code> implementation for Vectors.
	 *
	 * @see ListCollection
	 * @see IListCollectionDataDescriptor
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class VectorListCollectionDataDescriptor implements IListCollectionDataDescriptor
	{
		/**
		 * Constructor.
		 */
		public function VectorListCollectionDataDescriptor()
		{
		}

		/**
		 * @inheritDoc
		 */
		public function getLength(data:Object):int
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<*>).length;
		}

		/**
		 * @inheritDoc
		 */
		public function getItemAt(data:Object, index:int):Object
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<*>)[index];
		}

		/**
		 * @inheritDoc
		 */
		public function setItemAt(data:Object, item:Object, index:int):void
		{
			this.checkForCorrectDataType(data);
			(data as Vector.<*>)[index] = item;
		}

		/**
		 * @inheritDoc
		 */
		public function addItemAt(data:Object, item:Object, index:int):void
		{
			this.checkForCorrectDataType(data);
			(data as Vector.<*>).insertAt(index, item);
		}

		/**
		 * @inheritDoc
		 */
		public function removeItemAt(data:Object, index:int):Object
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<*>).removeAt(index);
		}

		/**
		 * @inheritDoc
		 */
		public function removeAll(data:Object):void
		{
			this.checkForCorrectDataType(data);
			(data as Vector.<*>).length = 0;
		}

		/**
		 * @inheritDoc
		 */
		public function getItemIndex(data:Object, item:Object):int
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<*>).indexOf(item);
		}

		/**
		 * @private
		 */
		protected function checkForCorrectDataType(data:Object):void
		{
			if(!(data is Vector.<*>))
			{
				throw new IllegalOperationError("Expected Vector. Received " + Object(data).constructor + " instead.");
			}
		}
	}
}

================================================
FILE: source/feathers/data/VectorNumberListCollectionDataDescriptor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import flash.errors.IllegalOperationError;

	/**
	 * An <code>IListCollectionDataDescriptor</code> implementation for Vector.&lt;Number&gt;.
	 *
	 * @see ListCollection
	 * @see IListCollectionDataDescriptor
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class VectorNumberListCollectionDataDescriptor implements IListCollectionDataDescriptor
	{
		/**
		 * Constructor.
		 */
		public function VectorNumberListCollectionDataDescriptor()
		{
		}

		/**
		 * @inheritDoc
		 */
		public function getLength(data:Object):int
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<Number>).length;
		}

		/**
		 * @inheritDoc
		 */
		public function getItemAt(data:Object, index:int):Object
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<Number>)[index];
		}

		/**
		 * @inheritDoc
		 */
		public function setItemAt(data:Object, item:Object, index:int):void
		{
			this.checkForCorrectDataType(data);
			(data as Vector.<Number>)[index] = item as Number;
		}

		/**
		 * @inheritDoc
		 */
		public function addItemAt(data:Object, item:Object, index:int):void
		{
			this.checkForCorrectDataType(data);
			(data as Vector.<Number>).insertAt(index, item as Number);
		}

		/**
		 * @inheritDoc
		 */
		public function removeItemAt(data:Object, index:int):Object
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<Number>).removeAt(index);
		}

		/**
		 * @inheritDoc
		 */
		public function removeAll(data:Object):void
		{
			this.checkForCorrectDataType(data);
			(data as Vector.<Number>).length = 0;
		}

		/**
		 * @inheritDoc
		 */
		public function getItemIndex(data:Object, item:Object):int
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<Number>).indexOf(item as Number);
		}

		/**
		 * @private
		 */
		protected function checkForCorrectDataType(data:Object):void
		{
			if(!(data is Vector.<Number>))
			{
				throw new IllegalOperationError("Expected Vector.<Number>. Received " + Object(data).constructor + " instead.");
			}
		}
	}
}

================================================
FILE: source/feathers/data/VectorUintListCollectionDataDescriptor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import flash.errors.IllegalOperationError;

	/**
	 * An <code>IListCollectionDataDescriptor</code> implementation for Vector.&lt;uint&gt;.
	 *
	 * @see ListCollection
	 * @see IListCollectionDataDescriptor
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class VectorUintListCollectionDataDescriptor implements IListCollectionDataDescriptor
	{
		/**
		 * Constructor.
		 */
		public function VectorUintListCollectionDataDescriptor()
		{
		}

		/**
		 * @inheritDoc
		 */
		public function getLength(data:Object):int
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<uint>).length;
		}

		/**
		 * @inheritDoc
		 */
		public function getItemAt(data:Object, index:int):Object
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<uint>)[index];
		}

		/**
		 * @inheritDoc
		 */
		public function setItemAt(data:Object, item:Object, index:int):void
		{
			this.checkForCorrectDataType(data);
			(data as Vector.<uint>)[index] = item as uint;
		}

		/**
		 * @inheritDoc
		 */
		public function addItemAt(data:Object, item:Object, index:int):void
		{
			this.checkForCorrectDataType(data);
			(data as Vector.<uint>).insertAt(index, item as uint);
		}

		/**
		 * @inheritDoc
		 */
		public function removeItemAt(data:Object, index:int):Object
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<uint>).removeAt(index);
		}

		/**
		 * @inheritDoc
		 */
		public function removeAll(data:Object):void
		{
			this.checkForCorrectDataType(data);
			(data as Vector.<uint>).length = 0;
		}

		/**
		 * @inheritDoc
		 */
		public function getItemIndex(data:Object, item:Object):int
		{
			this.checkForCorrectDataType(data);
			return (data as Vector.<uint>).indexOf(item as uint);
		}

		/**
		 * @private
		 */
		protected function checkForCorrectDataType(data:Object):void
		{
			if(!(data is Vector.<uint>))
			{
				throw new IllegalOperationError("Expected Vector.<uint>. Received " + Object(data).constructor + " instead.");
			}
		}
	}
}

================================================
FILE: source/feathers/data/XMLListCollection.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import feathers.events.CollectionEventType;
	import feathers.utils.xml.xmlListInsertAt;

	import starling.events.Event;
	import starling.events.EventDispatcher;

	[Exclude(name="data",kind="property")]

	/**
	 * Dispatched when the underlying data source changes and components will
	 * need to redraw the data.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the collection has changed drastically, such as when
	 * the underlying data source is replaced completely.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.RESET
	 */
	[Event(name="reset",type="starling.events.Event")]

	/**
	 * Dispatched when an item is added to the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * added. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.ADD_ITEM
	 */
	[Event(name="addItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is removed from the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * removed. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REMOVE_ITEM
	 */
	[Event(name="removeItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is replaced in the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * replaced. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REPLACE_ITEM
	 */
	[Event(name="replaceItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateItemAt()</code> function is called on the
	 * <code>ListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index of the item that has been
	 * updated. It is of type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateItemAt()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ITEM
	 */
	[Event(name="updateItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateAll()</code> function is called on the
	 * <code>ListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateAll()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ALL
	 */
	[Event(name="updateAll",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>filterFunction</code> property changes or the
	 * <code>refresh()</code> function is called on the <code>IListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #filterFunction
	 * @see #refresh()
	 *
	 * @eventType feathers.events.CollectionEventType.FILTER_CHANGE
	 */
	[Event(name="filterChange",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>sortCompareFunction</code> property changes or
	 * the <code>refresh()</code> function is called on the <code>IListCollection</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #sortCompareFunction
	 * @see #refresh()
	 *
	 * @eventType feathers.events.CollectionEventType.SORT_CHANGE
	 */
	[Event(name="sortChange",type="starling.events.Event")]

	/**
	 * Wraps an <code>XMLList</code> in the common <code>IListCollection</code>
	 * API used by many Feathers UI controls, including <code>List</code> and
	 * <code>TabBar</code>.
	 *
	 * @productversion Feathers 3.3.0
	 */
	public class XMLListCollection extends EventDispatcher implements IListCollection
	{
		/**
		 * Constructor.
		 */
		public function XMLListCollection(data:XMLList = null)
		{
			if(xmlListData === null)
			{
				xmlListData = new XMLList();
			}
			this._xmlListData = data;
		}

		/**
		 * @private
		 */
		protected var _filterAndSortData:Array;

		/**
		 * @private
		 */
		protected var _xmlListData:XMLList;

		/**
		 * The <code>XMLList</code> data source for this collection.
		 */
		public function get xmlListData():XMLList
		{
			return this._xmlListData;
		}

		/**
		 * @private
		 */
		public function set xmlListData(value:XMLList):void
		{
			if(this._xmlListData === value)
			{
				return;
			}
			this._xmlListData = value;
			this.dispatchEventWith(CollectionEventType.RESET);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _pendingRefresh:Boolean = false;

		/**
		 * @private
		 */
		protected var _filterFunction:Function = null;

		/**
		 * @copy feathers.data.IListCollection#filterFunction
		 */
		public function get filterFunction():Function
		{
			return this._filterFunction;
		}

		/**
		 * @private
		 */
		public function set filterFunction(value:Function):void
		{
			if(this._filterFunction === value)
			{
				return;
			}
			this._filterFunction = value;
			this._pendingRefresh = true;
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.FILTER_CHANGE);
		}

		/**
		 * @private
		 */
		protected var _sortCompareFunction:Function = null;

		/**
		 * @copy feathers.data.IListCollection#sortCompareFunction
		 */
		public function get sortCompareFunction():Function
		{
			return this._sortCompareFunction;
		}

		/**
		 * @private
		 */
		public function set sortCompareFunction(value:Function):void
		{
			if(this._sortCompareFunction === value)
			{
				return;
			}
			this._sortCompareFunction = value;
			this._pendingRefresh = true;
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.SORT_CHANGE);
		}

		/**
		 * @copy feathers.data.IListCollection#length
		 */
		public function get length():int
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._filterAndSortData !== null)
			{
				return this._filterAndSortData.length;
			}
			return this._xmlListData.length();
		}

		/**
		 * @copy feathers.data.IListCollection#refresh()
		 */
		public function refresh():void
		{
			if(this._filterFunction === null && this._sortCompareFunction === null)
			{
				return;
			}
			this._pendingRefresh = true;
			this.dispatchEventWith(Event.CHANGE);
			if(this._filterFunction !== null)
			{
				this.dispatchEventWith(CollectionEventType.FILTER_CHANGE);
			}
			if(this._sortCompareFunction !== null)
			{
				this.dispatchEventWith(CollectionEventType.SORT_CHANGE);
			}
		}

		/**
		 * @private
		 */
		protected function refreshFilterAndSort():void
		{
			this._pendingRefresh = false;
			if(this._filterFunction !== null)
			{
				var result:Array = this._filterAndSortData;
				if(result !== null)
				{
					//reuse the old array to avoid garbage collection
					result.length = 0;
				}
				else
				{
					result = [];
				}
				var itemCount:int = this._xmlListData.length();
				var pushIndex:int = 0;
				for(var i:int = 0; i < itemCount; i++)
				{
					var item:XML = this._xmlListData[i];
					if(this._filterFunction(item))
					{
						result[pushIndex] = item;
						pushIndex++;
					}
				}
				this._filterAndSortData = result;
			}
			else if(this._sortCompareFunction !== null) //no filter
			{
				itemCount = this._xmlListData.length();
				if(this._filterAndSortData === null)
				{
					this._filterAndSortData = new Array(itemCount);
				}
				else
				{
					this._filterAndSortData.length = itemCount;
				}
				for(i = 0; i < itemCount; i++)
				{
					this._filterAndSortData[i] = this._xmlListData[i];
				}
			}
			else //no filter or sort
			{
				this._filterAndSortData = null;
			}
			if(this._sortCompareFunction !== null)
			{
				this._filterAndSortData.sort(this._sortCompareFunction);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#updateItemAt()
		 *
		 * @see #updateAll()
		 */
		public function updateItemAt(index:int):void
		{
			this.dispatchEventWith(CollectionEventType.UPDATE_ITEM, false, index);
		}

		/**
		 * @copy feathers.data.IListCollection#updateAll()
		 *
		 * @see #updateItemAt()
		 */
		public function updateAll():void
		{
			this.dispatchEventWith(CollectionEventType.UPDATE_ALL);
		}

		/**
		 * @copy feathers.data.IListCollection#getItemAt()
		 */
		public function getItemAt(index:int):Object
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._filterAndSortData !== null)
			{
				return this._filterAndSortData[index];
			}
			return this._xmlListData[index];
		}

		/**
		 * @copy feathers.data.IListCollection#getItemIndex()
		 */
		public function getItemIndex(item:Object):int
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._filterAndSortData !== null)
			{
				return this._filterAndSortData.indexOf(item);
			}
			return this.xmlListIndexOf(item);
		}

		/**
		 * @copy feathers.data.IListCollection#addItemAt()
		 */
		public function addItemAt(item:Object, index:int):void
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._filterAndSortData !== null)
			{
				if(index < this._filterAndSortData.length)
				{
					//find the item at the index in the filtered data, and use
					//its index from the unfiltered data
					var oldItem:Object = this._filterAndSortData[index];
					var unfilteredIndex:int = this.xmlListIndexOf(oldItem);
				}
				else
				{
					//if the item is added at the end of the filtered data
					//then add it at the end of the unfiltered data
					unfilteredIndex = this._xmlListData.length();
				}
				//always add to the original data
				this._xmlListData = xmlListInsertAt(this._xmlListData, unfilteredIndex, item as XML);
				//but check if the item should be in the filtered data
				var includeItem:Boolean = true;
				if(this._filterFunction !== null)
				{
					includeItem = this._filterFunction(item);
				}
				if(includeItem)
				{
					var sortedIndex:int = index;
					if(this._sortCompareFunction !== null)
					{
						sortedIndex = this.getSortedInsertionIndex(item);
					}
					this._filterAndSortData.insertAt(sortedIndex, item);
					//don't dispatch these events if the item is filtered!
					this.dispatchEventWith(Event.CHANGE);
					this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, sortedIndex);
				}
			}
			else //no filter or sort
			{
				this._xmlListData = xmlListInsertAt(this._xmlListData, index, item as XML);
				this.dispatchEventWith(Event.CHANGE);
				this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, index);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#removeItemAt()
		 */
		public function removeItemAt(index:int):Object
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._filterAndSortData !== null)
			{
				var item:Object = this._filterAndSortData.removeAt(index);
				var unfilteredIndex:int = this.xmlListIndexOf(item);
				delete this._xmlListData[unfilteredIndex];
			}
			else
			{
				item = this._xmlListData[index];
				delete this._xmlListData[index];
			}
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, index);
			return item;
		}

		/**
		 * @copy feathers.data.IListCollection#removeItem()
		 */
		public function removeItem(item:Object):void
		{
			var index:int = this.getItemIndex(item);
			if(index >= 0)
			{
				this.removeItemAt(index);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#removeAll()
		 */
		public function removeAll():void
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this.length == 0)
			{
				return;
			}
			if(this._filterAndSortData !== null)
			{
				this._filterAndSortData.length = 0;
			}
			else
			{
				this.xmlListDeleteAll();
			}
			this.dispatchEventWith(CollectionEventType.REMOVE_ALL);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IListCollection#setItemAt()
		 */
		public function setItemAt(item:Object, index:int):void
		{
			if(this._pendingRefresh)
			{
				this.refreshFilterAndSort();
			}
			if(this._filterAndSortData !== null)
			{
				var oldItem:Object = this._filterAndSortData[index];
				var unfilteredIndex:int = this.xmlListIndexOf(oldItem);
				this._xmlListData[unfilteredIndex] = item;
				if(this._filterFunction !== null)
				{
					var includeItem:Boolean = this._filterFunction(item);
					if(includeItem)
					{
						this._filterAndSortData[index] = item;
						this.dispatchEventWith(Event.CHANGE);
						this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, index);
						return;
					}
					else
					{
						//if the item is excluded, the item at this index is
						//removed instead of being replaced by the new item
						this._filterAndSortData.removeAt(index);
						this.dispatchEventWith(Event.CHANGE);
						this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, index);
						return;
					}
				}
				else if(this._sortCompareFunction !== null)
				{
					//remove the old item first!
					this._filterAndSortData.removeAt(index);
					//then try to figure out where the new item goes when inserted
					var sortedIndex:int = this.getSortedInsertionIndex(item);
					this._filterAndSortData[sortedIndex] = item;
					this.dispatchEventWith(Event.CHANGE);
					this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, index);
					return;
				}
			}
			else //no filter or sort
			{
				this._xmlListData[index] = item;
				this.dispatchEventWith(Event.CHANGE);
				this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, index);
			}
		}

		/**
		 * @copy feathers.data.IListCollection#addItem()
		 */
		public function addItem(item:Object):void
		{
			this.addItemAt(item, this.length);
		}

		/**
		 * @copy feathers.data.IListCollection#push()
		 *
		 * @see #addItem()
		 */
		public function push(item:Object):void
		{
			this.addItemAt(item, this.length);
		}

		/**
		 * @copy feathers.data.IListCollection#addAll()
		 */
		public function addAll(collection:IListCollection):void
		{
			var otherCollectionLength:int = collection.length;
			var pushIndex:int = this._xmlListData.length();
			for(var i:int = 0; i < otherCollectionLength; i++)
			{
				var item:Object = collection.getItemAt(i);
				this._xmlListData[pushIndex] = item;
				pushIndex++;
			}
		}

		/**
		 * @copy feathers.data.IListCollection#addAllAt()
		 */
		public function addAllAt(collection:IListCollection, index:int):void
		{
			var otherCollectionLength:int = collection.length;
			var currentIndex:int = index;
			for(var i:int = 0; i < otherCollectionLength; i++)
			{
				var item:Object = collection.getItemAt(i);
				this._xmlListData = xmlListInsertAt(this._xmlListData, currentIndex, item as XML);
				currentIndex++;
			}
		}

		/**
		 * @copy feathers.data.IListCollection#reset()
		 */
		public function reset(collection:IListCollection):void
		{
			this.xmlListDeleteAll();
			var otherCollectionLength:int = collection.length;
			for(var i:int = 0; i < otherCollectionLength; i++)
			{
				var item:Object = collection.getItemAt(i);
				this._xmlListData[i] = item;
			}
			this.dispatchEventWith(CollectionEventType.RESET);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IListCollection#pop()
		 */
		public function pop():Object
		{
			return this.removeItemAt(this.length - 1);
		}

		/**
		 * @copy feathers.data.IListCollection#unshift()
		 */
		public function unshift(item:Object):void
		{
			this.addItemAt(item, 0);
		}

		/**
		 * @copy feathers.data.IListCollection#shift()
		 */
		public function shift():Object
		{
			return this.removeItemAt(0);
		}

		/**
		 * @copy feathers.data.IListCollection#contains()
		 */
		public function contains(item:Object):Boolean
		{
			return this.xmlListIndexOf(item) != -1;
		}

		/**
		 * @copy feathers.data.IListCollection#dispose()
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#dispose() starling.display.DisplayObject.dispose()
		 * @see http://doc.starling-framework.org/core/starling/textures/Texture.html#dispose() starling.textures.Texture.dispose()
		 */
		public function dispose(disposeItem:Function):void
		{
			//if we're disposing the collection, filters don't matter anymore,
			//and we should ensure that all items are disposed.
			this._filterFunction = null;
			this.refreshFilterAndSort();

			var itemCount:int = this._xmlListData.length();
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = this._xmlListData[i];
				disposeItem(item);
			}
		}

		/**
		 * @private
		 */
		protected function xmlListIndexOf(item:Object):int
		{
			var listLength:int = this._xmlListData.length();
			for(var i:int = 0; i < listLength; i++)
			{
				var currentItem:XML = this._xmlListData[i];
				if(currentItem == item)
				{
					return i;
				}
			}
			return -1;
		}

		/**
		 * @private
		 */
		protected function xmlListDeleteAll():void
		{
			var listLength:int = this._xmlListData.length();
			for(var i:int = 0; i < listLength; i++)
			{
				delete this._xmlListData[0];
			}
		}

		/**
		 * @private
		 */
		protected function getSortedInsertionIndex(item:Object):int
		{
			var itemCount:int = this._filterAndSortData.length;
			if(this._sortCompareFunction === null)
			{
				return itemCount;
			}
			for(var i:int = 0; i < itemCount; i++)
			{
				var otherItem:Object = this._filterAndSortData[i];
				var result:int = this._sortCompareFunction(item, otherItem);
				if(result < 1)
				{
					return i;
				}
			}
			return itemCount;
		}
	}
}

================================================
FILE: source/feathers/data/XMLListHierarchicalCollection.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import feathers.events.CollectionEventType;
	import feathers.utils.xml.xmlListInsertAt;

	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when the underlying data source changes and components will
	 * need to redraw the data.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the collection has changed drastically, such as when
	 * the underlying data source is replaced completely.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.RESET
	 */
	[Event(name="reset",type="starling.events.Event")]

	/**
	 * Dispatched when an item is added to the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been added. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.ADD_ITEM
	 */
	[Event(name="addItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is removed from the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been removed. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REMOVE_ITEM
	 */
	[Event(name="removeItem",type="starling.events.Event")]

	/**
	 * Dispatched when an item is replaced in the collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been replaced. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.CollectionEventType.REPLACE_ITEM
	 */
	[Event(name="replaceItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateItemAt()</code> function is called on the
	 * hierarchical collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The index path of the item that has
	 * been updated. It is of type <code>Array</code> and contains objects of
	 * type <code>int</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateItemAt()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ITEM
	 */
	[Event(name="updateItem",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>updateAll()</code> function is called on the
	 * hierarchical collection.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #updateAll()
	 *
	 * @eventType feathers.events.CollectionEventType.UPDATE_ALL
	 */
	[Event(name="updateAll",type="starling.events.Event")]

	/**
	 * Wraps an XML data source with a common API for use with UI controls that
	 * support hierarchical data.
	 *
	 * @productversion Feathers 3.3.0
	 */
	public class XMLListHierarchicalCollection extends EventDispatcher implements IHierarchicalCollection
	{
		/**
		 * Constructor.
		 */
		public function XMLListHierarchicalCollection(xmlListData:XMLList = null)
		{
			if(xmlListData === null)
			{
				xmlListData = new XMLList();
			}
			this._xmlListData = xmlListData;
		}

		/**
		 * @private
		 */
		protected var _xmlListData:XMLList = null;

		/**
		 * The <code>XMLList</code> data source for this collection.
		 */
		public function get xmlListData():XMLList
		{
			return this._xmlListData;
		}

		/**
		 * @private
		 */
		public function set xmlListData(value:XMLList):void
		{
			if(this._xmlListData === value)
			{
				return;
			}
			this._xmlListData = value;
			this.dispatchEventWith(CollectionEventType.RESET);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#isBranch()
		 */
		public function isBranch(node:Object):Boolean
		{
			var xml:XML = node as XML;
			if(xml === null)
			{
				return false;
			}
			return xml.elements().length() > 0;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getLength()
		 *
		 * @see #getLengthAtLocation()
		 */
		public function getLength(...rest:Array):int
		{
			var branch:XMLList = this._xmlListData;
			var indexCount:int = rest.length;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = rest[i] as int;
				branch = branch[index].elements();
			}

			return branch.length();
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getLengthAtLocation()
		 */
		public function getLengthAtLocation(location:Vector.<int> = null):int
		{
			var branch:XMLList = this._xmlListData;
			if(location !== null)
			{
				var indexCount:int = location.length;
				for(var i:int = 0; i < indexCount; i++)
				{
					var index:int = location[i];
					branch = branch[index].elements();
				}
			}
			return branch.length();
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#updateItemAt()
		 *
		 * @see #updateAll()
		 */
		public function updateItemAt(index:int, ...rest:Array):void
		{
			rest.insertAt(0, index);
			this.dispatchEventWith(CollectionEventType.UPDATE_ITEM, false, rest);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#updateAll()
		 *
		 * @see #updateItemAt()
		 */
		public function updateAll():void
		{
			this.dispatchEventWith(CollectionEventType.UPDATE_ALL);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getItemAt()
		 *
		 * @see #getItemAtLocation()
		 */
		public function getItemAt(index:int, ...rest:Array):Object
		{
			rest.insertAt(0, index);
			var branch:XMLList = this._xmlListData;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				branch = branch[index].elements();
			}
			index = rest[indexCount] as int;
			return branch[index] as XML;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getItemAtLocation()
		 */
		public function getItemAtLocation(location:Vector.<int>):Object
		{
			if(location === null || location.length == 0)
			{
				return null;
			}
			var branch:XMLList = this._xmlListData;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				branch = branch[index].elements();
			}
			index = location[indexCount];
			return branch[index] as XML;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#getItemLocation()
		 */
		public function getItemLocation(item:Object, result:Vector.<int> = null):Vector.<int>
		{
			if(result === null)
			{
				result = new <int>[];
			}
			else
			{
				result.length = 0;
			}
			var xmlItem:XML = item as XML;
			if(xmlItem === null)
			{
				return result;
			}
			this.findItemInBranch(this._xmlListData, xmlItem, result);
			return result;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#addItemAt()
		 *
		 * @see #addItemAtLocation()
		 */
		public function addItemAt(item:Object, index:int, ...rest:Array):void
		{
			rest.insertAt(0, index);
			var parentOfBranch:XML = null;
			var branch:XMLList = this._xmlListData;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				parentOfBranch = branch[index] as XML;
				branch = parentOfBranch.elements();
			}
			index = rest[indexCount] as int;
			branch = xmlListInsertAt(branch, index, item as XML);
			if(parentOfBranch === null)
			{
				this._xmlListData = branch;
			}
			else
			{
				parentOfBranch.setChildren(branch);
			}
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, rest);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#addItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function addItemAtLocation(item:Object, location:Vector.<int>):void
		{
			if(location === null || location.length == 0)
			{
				throw new RangeError("Branch not found at location: " + location);
			}
			var eventIndices:Array = [];
			var parentOfBranch:XML = null;
			var branch:XMLList = this._xmlListData;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				parentOfBranch = branch[index] as XML;
				branch = parentOfBranch.elements();
				eventIndices[i] = index;
			}
			index = location[indexCount];
			eventIndices[indexCount] = index;
			branch = xmlListInsertAt(branch, index, item as XML);
			if(parentOfBranch === null)
			{
				this._xmlListData = branch;
			}
			else
			{
				parentOfBranch.setChildren(branch);
			}
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.ADD_ITEM, false, eventIndices);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeItemAt()
		 *
		 * @see #removeItemAtLocation()
		 */
		public function removeItemAt(index:int, ...rest:Array):Object
		{
			rest.insertAt(0, index);
			var branch:XMLList = this._xmlListData;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				branch = branch[index].elements();
			}
			index = rest[indexCount] as int;
			var item:XML = branch[index] as XML;
			delete branch[index];
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, rest);
			return item;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function removeItemAtLocation(location:Vector.<int>):Object
		{
			if(location === null || location.length == 0)
			{
				throw new RangeError("Branch not found at location: " + location);
			}
			var eventIndices:Array = [];
			var branch:XMLList = this._xmlListData;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				branch = branch[index].elements();
				eventIndices[i] = index;
			}
			index = location[indexCount];
			eventIndices[indexCount] = index;
			var item:XML = branch[index] as XML;
			delete branch[index];
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.REMOVE_ITEM, false, eventIndices);
			return item;
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeItem()
		 */
		public function removeItem(item:Object):void
		{
			var location:Vector.<int> = this.getItemLocation(item);
			if(location !== null)
			{
				this.removeItemAtLocation(location);
			}
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#removeAll()
		 */
		public function removeAll():void
		{
			if(this.getLength() == 0)
			{
				return;
			}
			this._xmlListData = new XMLList();
			this.dispatchEventWith(CollectionEventType.REMOVE_ALL);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#setItemAt()
		 *
		 * @see #setItemAtLocation()
		 */
		public function setItemAt(item:Object, index:int, ...rest:Array):void
		{
			rest.insertAt(0, index);
			var branch:XMLList = this._xmlListData;
			var indexCount:int = rest.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				index = rest[i] as int;
				branch = branch[index].elements();
			}
			index = rest[indexCount] as int;
			branch[index] = item;
			this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, rest);
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#setItemAtLocation()
		 *
		 * @throws RangeError Branch not found at specified location
		 */
		public function setItemAtLocation(item:Object, location:Vector.<int>):void
		{
			if(location === null || location.length == 0)
			{
				throw new RangeError("Branch not found at location: " + location);
			}
			var eventIndices:Array = [];
			var branch:XMLList = this._xmlListData;
			var indexCount:int = location.length - 1;
			for(var i:int = 0; i < indexCount; i++)
			{
				var index:int = location[i];
				branch = branch[index].elements();
				eventIndices[i] = index;
			}
			index = location[indexCount];
			eventIndices[indexCount] = index;
			branch[index] = item;
			this.dispatchEventWith(Event.CHANGE);
			this.dispatchEventWith(CollectionEventType.REPLACE_ITEM, false, eventIndices);
		}

		/**
		 * @copy feathers.data.IHierarchicalCollection#dispose()
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/DisplayObject.html#dispose() starling.display.DisplayObject.dispose()
		 * @see http://doc.starling-framework.org/core/starling/textures/Texture.html#dispose() starling.textures.Texture.dispose()
		 */
		public function dispose(disposeGroup:Function, disposeItem:Function):void
		{
			var groupCount:int = this.getLength();
			var path:Array = [];
			for(var i:int = 0; i < groupCount; i++)
			{
				var group:Object = this.getItemAt(i);
				path[0] = i;
				this.disposeGroupInternal(group, path, disposeGroup, disposeItem);
				path.length = 0;
			}
		}

		/**
		 * @private
		 */
		protected function disposeGroupInternal(group:Object, path:Array, disposeGroup:Function, disposeItem:Function):void
		{
			if(disposeGroup != null)
			{
				disposeGroup(group);
			}

			var itemCount:int = this.getLength.apply(this, path);
			for(var i:int = 0; i < itemCount; i++)
			{
				path[path.length] = i;
				var item:Object = this.getItemAt.apply(this, path);
				if(this.isBranch(item))
				{
					this.disposeGroupInternal(item, path, disposeGroup, disposeItem);
				}
				else if(disposeItem != null)
				{
					disposeItem(item);
				}
				path.length--;
			}
		}

		/**
		 * @private
		 */
		protected function findItemInBranch(branch:XMLList, item:XML, result:Vector.<int>):Boolean
		{
			var branchLength:int = branch.length();
			var insertIndex:int = result.length;
			for(var i:int = 0; i < branchLength; i++)
			{
				var branchItem:XML = branch[i] as XML;
				//don't use strict equality here or it may not be possible to
				//find items that were added
				if(branchItem == item)
				{
					result[insertIndex] = i;
					return true;
				}
				if(this.isBranch(branchItem))
				{
					result[insertIndex] = i;
					var isFound:Boolean = this.findItemInBranch(branchItem.elements(), item, result);
					if(isFound)
					{
						return true;
					}
					result.pop();
				}
			}
			return false;
		}
	}
}


================================================
FILE: source/feathers/data/XMLListListCollectionDataDescriptor.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.data
{
	import flash.errors.IllegalOperationError;

	/**
	 * An <code>IListCollectionDataDescriptor</code> implementation for
	 * XMLLists. Has some limitations due to certain things that cannot be done
	 * to XMLLists.
	 *
	 * @see ListCollection
	 * @see IListCollectionDataDescriptor
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class XMLListListCollectionDataDescriptor implements IListCollectionDataDescriptor
	{
		/**
		 * Constructor.
		 */
		public function XMLListListCollectionDataDescriptor()
		{
		}

		/**
		 * @inheritDoc
		 */
		public function getLength(data:Object):int
		{
			this.checkForCorrectDataType(data);
			return (data as XMLList).length();
		}

		/**
		 * @inheritDoc
		 */
		public function getItemAt(data:Object, index:int):Object
		{
			this.checkForCorrectDataType(data);
			return data[index];
		}

		/**
		 * @inheritDoc
		 */
		public function setItemAt(data:Object, item:Object, index:int):void
		{
			this.checkForCorrectDataType(data);
			data[index] = XML(item);
		}

		/**
		 * @inheritDoc
		 */
		public function addItemAt(data:Object, item:Object, index:int):void
		{
			this.checkForCorrectDataType(data);

			//wow, this is weird. unless I have failed epicly, I can find no
			//other way to insert an element into an XMLList at a specific index.
			var dataClone:XMLList = (data as XMLList).copy();
			data[index] = item;
			var listLength:int = dataClone.length();
			for(var i:int = index; i < listLength; i++)
			{
				data[i + 1] = dataClone[i];
			}
		}

		/**
		 * @inheritDoc
		 */
		public function removeItemAt(data:Object, index:int):Object
		{
			this.checkForCorrectDataType(data);
			var item:XML = data[index];
			delete data[index];
			return item;
		}

		/**
		 * @inheritDoc
		 */
		public function removeAll(data:Object):void
		{
			this.checkForCorrectDataType(data);
			var list:XMLList = data as XMLList;
			var listLength:int = list.length();
			for(var i:int = 0; i < listLength; i++)
			{
				delete data[0];
			}
		}

		/**
		 * @inheritDoc
		 */
		public function getItemIndex(data:Object, item:Object):int
		{
			this.checkForCorrectDataType(data);
			var list:XMLList = data as XMLList;
			var listLength:int = list.length();
			for(var i:int = 0; i < listLength; i++)
			{
				var currentItem:XML = list[i];
				if(currentItem == item)
				{
					return i;
				}
			}
			return -1;
		}

		/**
		 * @private
		 */
		protected function checkForCorrectDataType(data:Object):void
		{
			if(!(data is XMLList))
			{
				throw new IllegalOperationError("Expected XMLList. Received " + Object(data).constructor + " instead.");
			}
		}
	}
}

================================================
FILE: source/feathers/display/RenderDelegate.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.display
{
	import flash.geom.Matrix;
	import flash.geom.Point;
	import flash.geom.Rectangle;

	import starling.display.DisplayObject;
	import starling.rendering.Painter;
	import starling.utils.MatrixUtil;
	import starling.utils.Pool;

	/**
	 * Passes rendering to another display object, but provides its own separate
	 * transformation.
	 *
	 * <p>Touching the delegate does not pass touches to the target. The
	 * delegate is a separate display object. However, interacting with the
	 * target may affect the rendering of the delegate.</p>
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class RenderDelegate extends DisplayObject
	{
		/**
		 * @private
		 */
		private static const HELPER_POINT:Point = new Point();

		/**
		 * Constructor.
		 */
		public function RenderDelegate(target:DisplayObject)
		{
			this.target = target;
		}

		/**
		 * @private
		 */
		protected var _target:DisplayObject;

		/**
		 * The displaying object being rendered.
		 */
		public function get target():DisplayObject
		{
			return this._target;
		}

		/**
		 * @private
		 */
		public function set target(value:DisplayObject):void
		{
			if(this._target === value)
			{
				return;
			}
			this._target = value;
			this.setRequiresRedraw();
		}

		/**
		 * @private
		 */
		override public function getBounds(targetSpace:DisplayObject, resultRect:Rectangle = null):Rectangle
		{
			resultRect = this._target.getBounds(this._target, resultRect);
			var matrix:Matrix = Pool.getMatrix();
			this.getTransformationMatrix(targetSpace, matrix);
			var minX:Number = Number.MAX_VALUE;
			var maxX:Number = -Number.MAX_VALUE;
			var minY:Number = Number.MAX_VALUE;
			var maxY:Number = -Number.MAX_VALUE;
			for(var i:int = 0; i < 4; i++)
			{
				MatrixUtil.transformCoords(matrix, i % 2 == 0 ? 0 : resultRect.width, i < 2 ? 0 : resultRect.height, HELPER_POINT);
				if(HELPER_POINT.x < minX)
				{
					minX = HELPER_POINT.x;
				}
				if(HELPER_POINT.x > maxX)
				{
					maxX = HELPER_POINT.x;
				}
				if(HELPER_POINT.y < minY)
				{
					minY = HELPER_POINT.y;
				}
				if(HELPER_POINT.y > maxY)
				{
					maxY = HELPER_POINT.y;
				}
			}
			Pool.putMatrix(matrix);
			resultRect.setTo(minX, minY, maxX - minX, maxY - minY);
			return resultRect;
		}

		/**
		 * @private
		 */
		override public function render(painter:Painter):void
		{
			var oldCacheEnabled:Boolean = painter.cacheEnabled;
			painter.cacheEnabled = false;
			this._target.render(painter);
			painter.cacheEnabled = oldCacheEnabled;
			painter.excludeFromCache(this);
		}
	}
}


================================================
FILE: source/feathers/dragDrop/DragData.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.dragDrop
{
	/**
	 * Stores data associated with a drag and drop operation.
	 *
	 * @see feathers.dragDrop.DragDropManager
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class DragData
	{
		/**
		 * Constructor.
		 */
		public function DragData()
		{
		}

		/**
		 * @private
		 */
		protected var _data:Object = {};

		/**
		 * Determines if the specified data format is available.
		 */
		public function hasDataForFormat(format:String):Boolean
		{
			return this._data.hasOwnProperty(format);
		}

		/**
		 * Returns data for the specified format.
		 */
		public function getDataForFormat(format:String):*
		{
			if(this._data.hasOwnProperty(format))
			{
				return this._data[format];
			}
			return undefined;
		}

		/**
		 * Saves data for the specified format.
		 */
		public function setDataForFormat(format:String, data:*):void
		{
			this._data[format] = data;
		}

		/**
		 * Removes all data for the specified format.
		 */
		public function clearDataForFormat(format:String):*
		{
			var data:* = undefined;
			if(this._data.hasOwnProperty(format))
			{
				data = this._data[format];
			}
			delete this._data[format];
			return data;

		}
	}
}


================================================
FILE: source/feathers/dragDrop/DragDropManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.dragDrop
{
	import feathers.core.PopUpManager;
	import feathers.events.DragDropEvent;

	import flash.errors.IllegalOperationError;
	import flash.events.KeyboardEvent;
	import flash.geom.Point;
	import flash.ui.Keyboard;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Stage;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * Handles drag and drop operations based on Starling touch events.
	 *
	 * @see feathers.dragDrop.IDragSource
	 * @see feathers.dragDrop.IDropTarget
	 * @see feathers.dragDrop.DragData
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class DragDropManager
	{
		/**
		 * @private
		 */
		protected static var _touchPointID:int = -1;

		/**
		 * The ID of the touch that initiated the current drag. Returns <code>-1</code>
		 * if there is not an active drag action. In multi-touch applications,
		 * knowing the touch ID is useful if additional actions need to happen
		 * using the same touch.
		 */
		public static function get touchPointID():int
		{
			return _touchPointID;
		}

		/**
		 * @private
		 */
		protected static var _dragSourceStage:Stage;

		/**
		 * @private
		 */
		protected static var _dragSource:IDragSource;

		/**
		 * The <code>IDragSource</code> that started the current drag.
		 */
		public static function get dragSource():IDragSource
		{
			return _dragSource;
		}

		/**
		 * @private
		 */
		protected static var _dragData:DragData;

		/**
		 * Determines if the drag and drop manager is currently handling a drag.
		 * Only one drag may be active at a time.
		 */
		public static function get isDragging():Boolean
		{
			return _dragData != null;
		}

		/**
		 * The data associated with the current drag. Returns <code>null</code>
		 * if there is not a current drag.
		 */
		public static function get dragData():DragData
		{
			return _dragData;
		}

		/**
		 * @private
		 * The current target of the current drag.
		 */
		protected static var dropTarget:IDropTarget;

		/**
		 * @private
		 * Indicates if the current drag has been accepted by the dropTarget.
		 */
		protected static var isAccepted:Boolean = false;

		/**
		 * @private
		 * The avatar for the current drag data.
		 */
		protected static var avatar:DisplayObject;

		/**
		 * @private
		 */
		protected static var avatarOffsetX:Number;

		/**
		 * @private
		 */
		protected static var avatarOffsetY:Number;

		/**
		 * @private
		 */
		protected static var dropTargetLocalX:Number;

		/**
		 * @private
		 */
		protected static var dropTargetLocalY:Number;

		/**
		 * @private
		 */
		protected static var avatarOldTouchable:Boolean;

		/**
		 * Starts a new drag. If another drag is currently active, it is
		 * immediately cancelled. Includes an optional "avatar", a visual
		 * representation of the data that is being dragged.
		 */
		public static function startDrag(source:IDragSource, touch:Touch, data:DragData, dragAvatar:DisplayObject = null, dragAvatarOffsetX:Number = 0, dragAvatarOffsetY:Number = 0):void
		{
			if(isDragging)
			{
				cancelDrag();
			}
			if(!source)
			{
				throw new ArgumentError("Drag source cannot be null.");
			}
			if(!data)
			{
				throw new ArgumentError("Drag data cannot be null.");
			}
			_dragSource = source;
			_dragData = data;
			_touchPointID = touch.id;
			avatar = dragAvatar;
			avatarOffsetX = dragAvatarOffsetX;
			avatarOffsetY = dragAvatarOffsetY;
			_dragSourceStage = DisplayObject(source).stage;
			var point:Point = Pool.getPoint();
			touch.getLocation(_dragSourceStage, point);
			if(avatar)
			{
				avatarOldTouchable = avatar.touchable;
				avatar.touchable = false;
				avatar.x = point.x + avatarOffsetX;
				avatar.y = point.y + avatarOffsetY;
				PopUpManager.addPopUp(avatar, false, false);
			}
			_dragSourceStage.addEventListener(TouchEvent.TOUCH, stage_touchHandler);
			var starling:Starling = _dragSourceStage.starling;
			starling.nativeStage.addEventListener(KeyboardEvent.KEY_DOWN, nativeStage_keyDownHandler, false, 0, true);
			_dragSource.dispatchEvent(new DragDropEvent(DragDropEvent.DRAG_START, data, false, NaN, NaN, _dragSource));

			updateDropTarget(point);
			Pool.putPoint(point);
		}

		/**
		 * Tells the drag and drop manager if the target will accept the current
		 * drop. Meant to be called in a listener for the target's
		 * <code>DragDropEvent.DRAG_ENTER</code> event.
		 */
		public static function acceptDrag(target:IDropTarget):void
		{
			if(dropTarget != target)
			{
				throw new ArgumentError("Drop target cannot accept a drag at this time. Acceptance may only happen after the DragDropEvent.DRAG_ENTER event is dispatched and before the DragDropEvent.DRAG_EXIT event is dispatched.");
			}
			isAccepted = true;
		}

		/**
		 * Immediately cancels the current drag.
		 */
		public static function cancelDrag():void
		{
			if(!isDragging)
			{
				return;
			}
			completeDrag(false);
		}

		/**
		 * @private
		 */
		protected static function completeDrag(isDropped:Boolean):void
		{
			if(!isDragging)
			{
				throw new IllegalOperationError("Drag cannot be completed because none is currently active.");
			}
			if(dropTarget)
			{
				dropTarget.dispatchEvent(new DragDropEvent(DragDropEvent.DRAG_EXIT, _dragData, false, dropTargetLocalX, dropTargetLocalY, _dragSource));
				dropTarget = null;
			}
			var source:IDragSource = _dragSource;
			var data:DragData = _dragData;
			cleanup();
			source.dispatchEvent(new DragDropEvent(DragDropEvent.DRAG_COMPLETE, data, isDropped, NaN, NaN, source));
		}

		/**
		 * @private
		 */
		protected static function cleanup():void
		{
			if(avatar)
			{
				//may have been removed from parent already in the drop listener
				if(PopUpManager.isPopUp(avatar))
				{
					PopUpManager.removePopUp(avatar);
				}
				avatar.touchable = avatarOldTouchable;
				avatar = null;
			}
			var starling:Starling = _dragSourceStage.starling;
			_dragSourceStage.removeEventListener(TouchEvent.TOUCH, stage_touchHandler);
			starling.nativeStage.removeEventListener(KeyboardEvent.KEY_DOWN, nativeStage_keyDownHandler);
			_dragSource = null;
			_dragData = null;
			_dragSourceStage = null;
		}

		/**
		 * @private
		 */
		protected static function updateDropTarget(location:Point):void
		{
			var target:DisplayObject = _dragSourceStage.hitTest(location);
			while(target && !(target is IDropTarget))
			{
				target = target.parent;
			}
			if(target)
			{
				target.globalToLocal(location, location);
			}
			if(target != dropTarget)
			{
				if(dropTarget)
				{
					//notice that we can reuse the previously saved location
					dropTarget.dispatchEvent(new DragDropEvent(DragDropEvent.DRAG_EXIT, _dragData, false, dropTargetLocalX, dropTargetLocalY, _dragSource));
				}
				dropTarget = IDropTarget(target);
				isAccepted = false;
				if(dropTarget)
				{
					dropTargetLocalX = location.x;
					dropTargetLocalY = location.y;
					dropTarget.dispatchEvent(new DragDropEvent(DragDropEvent.DRAG_ENTER, _dragData, false, dropTargetLocalX, dropTargetLocalY, _dragSource));
				}
			}
			else if(dropTarget)
			{
				dropTargetLocalX = location.x;
				dropTargetLocalY = location.y;
				dropTarget.dispatchEvent(new DragDropEvent(DragDropEvent.DRAG_MOVE, _dragData, false, dropTargetLocalX, dropTargetLocalY, _dragSource));
			}
		}

		/**
		 * @private
		 */
		protected static function nativeStage_keyDownHandler(event:KeyboardEvent):void
		{
			if(event.keyCode == Keyboard.ESCAPE || event.keyCode == Keyboard.BACK)
			{
				event.preventDefault();
				cancelDrag();
			}
		}

		/**
		 * @private
		 */
		protected static function stage_touchHandler(event:TouchEvent):void
		{
			var stage:Stage = Stage(event.currentTarget);
			var touch:Touch = event.getTouch(stage, null, _touchPointID);
			if(!touch)
			{
				return;
			}
			if(touch.phase == TouchPhase.MOVED)
			{
				var point:Point = Pool.getPoint();
				touch.getLocation(stage, point);
				if(avatar)
				{
					avatar.x = point.x + avatarOffsetX;
					avatar.y = point.y + avatarOffsetY;
				}
				updateDropTarget(point);
				Pool.putPoint(point);
			}
			else if(touch.phase == TouchPhase.ENDED)
			{
				_touchPointID = -1;
				var isDropped:Boolean = false;
				if(dropTarget && isAccepted)
				{
					dropTarget.dispatchEvent(new DragDropEvent(DragDropEvent.DRAG_DROP, _dragData, true, dropTargetLocalX, dropTargetLocalY, _dragSource));
					isDropped = true;
				}
				dropTarget = null;
				completeDrag(isDropped);
			}
		}
	}
}


================================================
FILE: source/feathers/dragDrop/IDragSource.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.dragDrop
{
	import starling.events.Event;

	/**
	 * Dispatched when the drag and drop manager begins the drag.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>Same as the dragData property.</td></tr>
	 * <tr><td><code>dragData</code></td><td>The <code>feathers.dragDrop.DragData</code>
	 *   instance associated with this drag.</td></tr>
	 * <tr><td><code>isDropped</code></td><td>false</td></tr>
	 * <tr><td><code>localX</code></td><td>NaN</td></tr>
	 * <tr><td><code>localY</code></td><td>NaN</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.DragDropEvent.DRAG_START
	 */
	[Event(name="dragStart",type="feathers.events.DragDropEvent")]

	/**
	 * Dispatched when the drop has been completed or when the drag has been
	 * cancelled.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>Same as the dragData property.</td></tr>
	 * <tr><td><code>dragData</code></td><td>The <code>feathers.dragDrop.DragData</code>
	 *   instance associated with this drag.</td></tr>
	 * <tr><td><code>isDropped</code></td><td>true, if the dragged object was dropped; false, if it was not.</td></tr>
	 * <tr><td><code>localX</code></td><td>NaN</td></tr>
	 * <tr><td><code>localY</code></td><td>NaN</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.DragDropEvent.DRAG_COMPLETE
	 */
	[Event(name="dragComplete",type="feathers.events.DragDropEvent")]

	/**
	 * An object that can initiate drag actions with the drag and drop manager.
	 *
	 * @see feathers.dragDrop.DragDropManager
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface IDragSource
	{
		function dispatchEvent(event:Event):void;
		function dispatchEventWith(type:String, bubbles:Boolean = false, data:Object = null):void;
	}
}


================================================
FILE: source/feathers/dragDrop/IDropTarget.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.dragDrop
{
	import starling.events.Event;

	/**
	 * Dispatched when the touch enters the drop target's bounds. Call
	 * <code>acceptDrag()</code> on the drag and drop manager to allow
	 * the drag to the be dropped on the target.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>Same as the dragData property.</td></tr>
	 * <tr><td><code>dragData</code></td><td>The <code>feathers.dragDrop.DragData</code>
	 *   instance associated with this drag.</td></tr>
	 * <tr><td><code>isDropped</code></td><td>false</td></tr>
	 * <tr><td><code>localX</code></td><td>The x location, in pixels, of the
	 * current action, in the local coordinate system of the <code>IDropTarget</code>.</td></tr>
	 * <tr><td><code>localY</code></td><td>The y location, in pixels, of the
	 * current action, in the local coordinate system of the <code>IDropTarget</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.DragDropEvent.DRAG_ENTER
	 */
	[Event(name="dragEnter",type="feathers.events.DragDropEvent")]

	/**
	 * Dispatched when the touch moves within the drop target's bounds.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>Same as the dragData property.</td></tr>
	 * <tr><td><code>dragData</code></td><td>The <code>feathers.dragDrop.DragData</code>
	 *   instance associated with this drag.</td></tr>
	 * <tr><td><code>isDropped</code></td><td>false</td></tr>
	 * <tr><td><code>localX</code></td><td>The x location, in pixels, of the
	 * current action, in the local coordinate system of the <code>IDropTarget</code>.</td></tr>
	 * <tr><td><code>localY</code></td><td>The y location, in pixels, of the
	 * current action, in the local coordinate system of the <code>IDropTarget</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.DragDropEvent.DRAG_MOVE
	 */
	[Event(name="dragMove",type="feathers.events.DragDropEvent")]

	/**
	 * Dispatched when the touch exits the drop target's bounds or when
	 * the drag is cancelled while the touch is within the drop target's
	 * bounds. Will <em>not</em> be dispatched if the drop target hasn't
	 * accepted the drag.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>Same as the dragData property.</td></tr>
	 * <tr><td><code>dragData</code></td><td>The <code>feathers.dragDrop.DragData</code>
	 *   instance associated with this drag.</td></tr>
	 * <tr><td><code>isDropped</code></td><td>false</td></tr>
	 * <tr><td><code>localX</code></td><td>The x location, in pixels, of the
	 * current action, in the local coordinate system of the <code>IDropTarget</code>.</td></tr>
	 * <tr><td><code>localY</code></td><td>The y location, in pixels, of the
	 * current action, in the local coordinate system of the <code>IDropTarget</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.DragDropEvent.DRAG_EXIT
	 */
	[Event(name="dragExit",type="feathers.events.DragDropEvent")]

	/**
	 * Dispatched when an accepted drag is dropped on the target. Will
	 * <em>not</em> be dispatched if the drop target hasn't accepted the
	 * drag.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>Same as the dragData property.</td></tr>
	 * <tr><td><code>dragData</code></td><td>The <code>feathers.dragDrop.DragData</code>
	 *   instance associated with this drag.</td></tr>
	 * <tr><td><code>isDropped</code></td><td>true</td></tr>
	 * <tr><td><code>localX</code></td><td>The x location, in pixels, of the
	 * current action, in the local coordinate system of the <code>IDropTarget</code>.</td></tr>
	 * <tr><td><code>localY</code></td><td>The y location, in pixels, of the
	 * current action, in the local coordinate system of the <code>IDropTarget</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.DragDropEvent.DRAG_DROP
	 */
	[Event(name="dragDrop",type="feathers.events.DragDropEvent")]

	/**
	 * A display object that can accept data dropped by the drag and drop
	 * manager.
	 *
	 * @see feathers.dragDrop.DragDropManager
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface IDropTarget
	{
		function dispatchEvent(event:Event):void;
		function dispatchEventWith(type:String, bubbles:Boolean = false, data:Object = null):void;
	}
}


================================================
FILE: source/feathers/events/CollectionEventType.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.events
{
	/**
	 * Event <code>type</code> constants for collections. This class is
	 * not a subclass of <code>starling.events.Event</code> because these
	 * constants are meant to be used with <code>dispatchEventWith()</code> and
	 * take advantage of the Starling's event object pooling. The object passed
	 * to an event listener will be of type <code>starling.events.Event</code>.
	 *
	 * <listing version="3.0">
	 * function listener( event:Event ):void
	 * {
	 *     trace( "add item" );
	 * }
	 * collection.addEventListener( CollectionEventType.ADD_ITEM, listener );</listing>
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class CollectionEventType
	{
		/**
		 * Dispatched when the data provider's source is completely replaced.
		 */
		public static const RESET:String = "reset";

		/**
		 * Dispatched when a filter has been applied to or removed from the
		 * collection. The underlying source remains the same, but zero or more
		 * items may have been removed or added.
		 */
		public static const FILTER_CHANGE:String = "filterChange";

		/**
		 * Dispatched when a sort compare function has been applied to or
		 * removed from the collection. The underlying source remains the same,
		 * but the order may be modified.
		 */
		public static const SORT_CHANGE:String = "sortChange";

		/**
		 * Dispatched when an item is added to the collection.
		 */
		public static const ADD_ITEM:String = "addItem";

		/**
		 * Dispatched when an item is removed from the collection.
		 */
		public static const REMOVE_ITEM:String = "removeItem";

		/**
		 * Dispatched when an item is replaced in the collection with a
		 * different item.
		 */
		public static const REPLACE_ITEM:String = "replaceItem";

		/**
		 * Dispatched when an item in the collection has changed.
		 */
		public static const UPDATE_ITEM:String = "updateItem";

		/**
		 * Dispatched when all existing items in the collection have changed
		 * (but they have not been replaced by different items).
		 */
		public static const UPDATE_ALL:String = "updateAll";

		/**
		 * Dispatched when all items are removed from the collection.
		 */
		public static const REMOVE_ALL:String = "removeAll";
	}
}


================================================
FILE: source/feathers/events/DragDropEvent.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.events
{
	import feathers.dragDrop.DragData;
	import feathers.dragDrop.IDragSource;

	import starling.events.Event;

	/**
	 * Events used by the <code>DragDropManager</code>.
	 *
	 * @see feathers.dragDrop.DragDropManager
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class DragDropEvent extends Event
	{
		/**
		 * Dispatched by the <code>IDragSource</code> when a drag starts.
		 *
		 * @see feathers.dragDrop.IDragSource
		 */
		public static const DRAG_START:String = "dragStart";

		/**
		 * Dispatched by the <code>IDragSource</code> when a drag completes.
		 * This is always dispatched, even when there wasn't a successful drop.
		 * See the <code>isDropped</code> property to determine if the drop
		 * was successful.
		 *
		 * @see feathers.dragDrop.IDragSource
		 */
		public static const DRAG_COMPLETE:String = "dragComplete";

		/**
		 * Dispatched by a <code>IDropTarget</code> when a drag enters its
		 * bounds.
		 *
		 * @see feathers.dragDrop.IDropTarget
		 */
		public static const DRAG_ENTER:String = "dragEnter";

		/**
		 * Dispatched by a <code>IDropTarget</code> when a drag moves to a new
		 * location within its bounds.
		 *
		 * @see feathers.dragDrop.IDropTarget
		 */
		public static const DRAG_MOVE:String = "dragMove";

		/**
		 * Dispatched by a <code>IDropTarget</code> when a drag exits its
		 * bounds.
		 *
		 * @see feathers.dragDrop.IDropTarget
		 */
		public static const DRAG_EXIT:String = "dragExit";

		/**
		 * Dispatched by a <code>IDropTarget</code> when a drop occurs.
		 *
		 * @see feathers.dragDrop.IDropTarget
		 */
		public static const DRAG_DROP:String = "dragDrop";

		/**
		 * Constructor.
		 */
		public function DragDropEvent(type:String, dragData:DragData, isDropped:Boolean, localX:Number = NaN, localY:Number = NaN, dragSource:IDragSource = null)
		{
			super(type, false, dragData);
			this.isDropped = isDropped;
			this.localX = localX;
			this.localY = localY;
			this.dragSource = dragSource;
		}

		/**
		 * The <code>DragData</code> associated with the current drag.
		 */
		public function get dragData():DragData
		{
			return DragData(this.data);
		}

		/**
		 * Determines if there has been a drop.
		 */
		public var isDropped:Boolean;

		/**
		 * The x location, in pixels, of the current action, in the local
		 * coordinate system of the <code>IDropTarget</code>.
		 *
		 * <p>Value will always be <code>NaN</code> for <code>DRAG_START</code>
		 * and <code>DRAG_COMPLETE</code> events.</p>
		 *
		 * @see feathers.dragDrop.IDropTarget
		 */
		public var localX:Number;

		/**
		 * The y location, in pixels, of the current action, in the local
		 * coordinate system of the <code>IDropTarget</code>.
		 *
		 * <p>Value will always be <code>NaN</code> for <code>DRAG_START</code>
		 * and <code>DRAG_COMPLETE</code> events.</p>
		 *
		 * @see feathers.dragDrop.IDropTarget
		 */
		public var localY:Number;

		/**
		 * The source where the drag started.
		 */
		public var dragSource:IDragSource;
	}
}


================================================
FILE: source/feathers/events/ExclusiveTouch.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.events
{
	import flash.utils.Dictionary;

	import starling.display.DisplayObject;
	import starling.display.Stage;
	import starling.events.Event;
	import starling.events.EventDispatcher;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	/**
	 * Dispatched when a touch ID is claimed or a claim is removed. The
	 * <code>data</code> property is the touch ID.
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Allows a component to claim exclusive access to a touch to avoid
	 * dragging, scrolling, or other touch interaction conflicts. In particular,
	 * if objects are nested, and they can be scrolled or dragged, it's better
	 * for one to eventually gain exclusive control over the touch. Multiple
	 * objects being controlled by the same touch often results in unexpected
	 * behavior.
	 *
	 * <p>Due to the way that Starling's touch behavior is implemented, when
	 * objects are nested, the inner object will always have precedence.
	 * However, from a usability perspective, this is generally the expected
	 * behavior, so this restriction isn't expected to cause any issues.</p>
	 *
	 * @productversion Feathers 1.2.0
	 */
	public class ExclusiveTouch extends EventDispatcher
	{
		/**
		 * @private
		 */
		protected static const stageToObject:Dictionary = new Dictionary(true);

		/**
		 * Retrieves the exclusive touch manager for the specified stage.
		 */
		public static function forStage(stage:Stage):ExclusiveTouch
		{
			if(!stage)
			{
				throw new ArgumentError("Stage cannot be null.");
			}
			var object:ExclusiveTouch = ExclusiveTouch(stageToObject[stage]);
			if(object)
			{
				return object;
			}
			object = new ExclusiveTouch(stage);
			stageToObject[stage] = object;
			return object;
		}

		/**
		 * Disposes the exclusive touch manager for the specified stage.
		 */
		public static function disposeForStage(stage:Stage):void
		{
			delete stageToObject[stage];
		}

		/**
		 * Constructor.
		 * @param stage
		 */
		public function ExclusiveTouch(stage:Stage)
		{
			if(!stage)
			{
				throw new ArgumentError("Stage cannot be null.");
			}
			this._stage = stage;
		}

		/**
		 * @private
		 */
		protected var _stageListenerCount:int = 0;

		/**
		 * @private
		 */
		protected var _stage:Stage;

		/**
		 * @private
		 */
		protected var _claims:Dictionary = new Dictionary();

		/**
		 * Allows a display object to claim a touch by its ID. Returns
		 * <code>true</code> if the touch is claimed. Returns <code>false</code>
		 * if the touch was previously claimed by another display object.
		 */
		public function claimTouch(touchID:int, target:DisplayObject):Boolean
		{
			if(!target)
			{
				throw new ArgumentError("Target cannot be null.");
			}
			if(target.stage != this._stage)
			{
				throw new ArgumentError("Target cannot claim a touch on the selected stage because it appears on a different stage.");
			}
			if(touchID < 0)
			{
				throw new ArgumentError("Invalid touch. Touch ID must be >= 0.");
			}
			var existingTarget:DisplayObject = DisplayObject(this._claims[touchID]);
			if(existingTarget)
			{
				return false;
			}
			this._claims[touchID] = target;
			if(this._stageListenerCount == 0)
			{
				this._stage.addEventListener(TouchEvent.TOUCH, stage_touchHandler);
			}
			this._stageListenerCount++;
			this.dispatchEventWith(Event.CHANGE, false, touchID);
			return true;
		}

		/**
		 * Removes a claim to the touch with the specified ID.
		 */
		public function removeClaim(touchID:int):void
		{
			var existingTarget:DisplayObject = DisplayObject(this._claims[touchID]);
			if(!existingTarget)
			{
				return;
			}
			delete this._claims[touchID];
			this.dispatchEventWith(Event.CHANGE, false, touchID);
		}

		/**
		 * Gets the display object that has claimed a touch with the specified
		 * ID. If no touch claims the touch with the specified ID, returns
		 * <code>null</code>.
		 */
		public function getClaim(touchID:int):DisplayObject
		{
			if(touchID < 0)
			{
				throw new ArgumentError("Invalid touch. Touch ID must be >= 0.");
			}
			return DisplayObject(this._claims[touchID]);
		}

		/**
		 * @private
		 */
		protected function stage_touchHandler(event:TouchEvent):void
		{
			for(var key:Object in this._claims)
			{
				var touchID:int = key as int;
				var touch:Touch = event.getTouch(this._stage, TouchPhase.ENDED, touchID);
				if(!touch)
				{
					continue;
				}
				delete this._claims[key];
				this._stageListenerCount--;
			}
			if(this._stageListenerCount == 0)
			{
				this._stage.removeEventListener(TouchEvent.TOUCH, stage_touchHandler);
			}
		}
	}
}


================================================
FILE: source/feathers/events/FeathersEventType.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.events
{
	/**
	 * Event <code>type</code> constants for Feathers controls. This class is
	 * not a subclass of <code>starling.events.Event</code> because these
	 * constants are meant to be used with <code>dispatchEventWith()</code> and
	 * take advantage of the Starling's event object pooling. The object passed
	 * to an event listener will be of type <code>starling.events.Event</code>.
	 *
	 * <listing version="3.0">
	 * function listener( event:Event ):void
	 * {
	 *     trace( "creation complete" );
	 * }
	 * component.addEventListener( FeathersEventType.CREATION_COMPLETE, listener );</listing>
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class FeathersEventType
	{
		/**
		 * The <code>FeathersEventType.INITIALIZE</code> event type is meant to
		 * be used when an <code>IFeathersControl</code> has finished running
		 * its <code>initialize()</code> function.
		 */
		public static const INITIALIZE:String = "initialize";

		/**
		 * The <code>FeathersEventType.CREATION_COMPLETE</code> event type is
		 * meant to be used when an <code>IFeathersControl</code> has finished
		 * validating for the first time. A well-designed component will have
		 * created all of its children and it will be fully ready for user
		 * interaction.
		 */
		public static const CREATION_COMPLETE:String = "creationComplete";

		/**
		 * The <code>FeathersEventType.RESIZE</code> event type is meant to
		 * be used when an <code>IFeathersControl</code> has resized.
		 */
		public static const RESIZE:String = "resize";

		/**
		 * The <code>FeathersEventType.ENTER</code> event type is meant to
		 * be used when the enter key has been pressed in an input control.
		 */
		public static const ENTER:String = "enter";

		/**
		 * The <code>FeathersEventType.CLEAR</code> event type is a generic
		 * event type for when something is "cleared".
		 */
		public static const CLEAR:String = "clear";

		/**
		 * The <code>FeathersEventType.SCROLL_START</code> event type is used
		 * when a control starts scrolling in either direction as a result of
		 * either user interaction or animation.
		 */
		public static const SCROLL_START:String = "scrollStart";

		/**
		 * The <code>FeathersEventType.SCROLL_COMPLETE</code> event type is used
		 * when a control finishes scrolling in either direction as a result of
		 * either user interaction or animation.
		 */
		public static const SCROLL_COMPLETE:String = "scrollComplete";

		/**
		 * The <code>FeathersEventType.BEGIN_INTERACTION</code> event type is
		 * used by many UI controls where a drag or other interaction happens
		 * over time. An example is a <code>Slider</code> control where the
		 * user touches the thumb to begin dragging.
		 */
		public static const BEGIN_INTERACTION:String = "beginInteraction";

		/**
		 * The <code>FeathersEventType.END_INTERACTION</code> event type is
		 * used by many UI controls where a drag or other interaction happens
		 * over time. An example is a <code>Slider</code> control where the
		 * user stops touching the thumb after dragging.
		 *
		 * <p>Depending on the control, the result of the interaction may
		 * continue after the interaction ends. For instance, a <code>Scroller</code>
		 * may be "thrown", and the scrolling will continue animating after the
		 * user has finished interacting with it.</p>
		 */
		public static const END_INTERACTION:String = "endInteraction";

		/**
		 * The <code>FeathersEventType.TRANSITION_START</code> event type is
		 * used by the <code>ScreenNavigator</code> to indicate when a
		 * transition between screens begins.
		 *
		 * @see feathers.controls.ScreenNavigator
		 */
		public static const TRANSITION_START:String = "transitionStart";

		/**
		 * The <code>FeathersEventType.TRANSITION_COMPLETE</code> event type is
		 * used by the <code>ScreenNavigator</code> to indicate when a
		 * transition between screens ends.
		 *
		 * @see feathers.controls.ScreenNavigator
		 */
		public static const TRANSITION_COMPLETE:String = "transitionComplete";

		/**
		 * The <code>FeathersEventType.TRANSITION_IN_START</code> event type is
		 * used by the <code>ScreenNavigator</code> to indicate to a new screen
		 * when it begins to transition in.
		 *
		 * @see feathers.controls.ScreenNavigator
		 */
		public static const TRANSITION_IN_START:String = "transitionInStart";

		/**
		 * The <code>FeathersEventType.TRANSITION_IN_COMPLETE</code> event type is
		 * used by the <code>ScreenNavigator</code> to indicate to a new screen
		 * when it has completed transitioning in.
		 *
		 * @see feathers.controls.ScreenNavigator
		 */
		public static const TRANSITION_IN_COMPLETE:String = "transitionInComplete";

		/**
		 * The <code>FeathersEventType.TRANSITION_OUT_START</code> event type is
		 * used by the <code>ScreenNavigator</code> to indicate to an existing
		 * screen when it begins to transition out.
		 *
		 * @see feathers.controls.ScreenNavigator
		 */
		public static const TRANSITION_OUT_START:String = "transitionOutStart";

		/**
		 * The <code>FeathersEventType.TRANSITION_OUT_COMPLETE</code> event type is
		 * used by the <code>ScreenNavigator</code> to indicate to an existing
		 * screen when it has completed transitioning out.
		 *
		 * @see feathers.controls.ScreenNavigator
		 */
		public static const TRANSITION_OUT_COMPLETE:String = "transitionOutComplete";

		/**
		 * The <code>FeathersEventType.TRANSITION_CANCEL</code> event type is
		 * used by the <code>ScreenNavigator</code> to indicate when a
		 * transition between screens is cancelled.
		 *
		 * @see feathers.controls.ScreenNavigator
		 */
		public static const TRANSITION_CANCEL:String = "transitionCancel";

		/**
		 * The <code>FeathersEventType.FOCUS_IN</code> event type is used by
		 * Feathers components to indicate when they have received focus.
		 */
		public static const FOCUS_IN:String = "focusIn";

		/**
		 * The <code>FeathersEventType.FOCUS_OUT</code> event type is used by
		 * Feathers components to indicate when they have lost focus.
		 */
		public static const FOCUS_OUT:String = "focusOut";

		/**
		 * The <code>FeathersEventType.RENDERER_ADD</code> event type is used by
		 * Feathers components with item renderers to indicate when a new
		 * renderer has been added. This event type is meant to be used with
		 * virtualized layouts where only a limited set of renderers will be
		 * created for a data provider that may include a larger number of items.
		 */
		public static const RENDERER_ADD:String = "rendererAdd";

		/**
		 * The <code>FeathersEventType.RENDERER_REMOVE</code> event type is used
		 * by Feathers controls with item renderers to indicate when a renderer
		 * is removed. This event type is meant to be used with virtualized
		 * layouts where only a limited set of renderers will be created for
		 * a data provider that may include a larger number items.
		 */
		public static const RENDERER_REMOVE:String = "rendererRemove";

		/**
		 * The <code>FeathersEventType.ERROR</code> event type is used by
		 * Feathers controls when an error occurs that can be caught and
		 * safely ignored.
		 */
		public static const ERROR:String = "error";

		/**
		 * The <code>FeathersEventType.LAYOUT_DATA_CHANGE</code> event type is
		 * used by Feathers controls when their layout data has changed.
		 */
		public static const LAYOUT_DATA_CHANGE:String = "layoutDataChange";

		/**
		 * The <code>FeathersEventType.LONG_PRESS</code> event type is used by
		 * the Feathers <code>Button</code> when it is pressed for a long time.
		 *
		 * @see feathers.controls.Button#event:longPress
		 */
		public static const LONG_PRESS:String = "longPress";

		/**
		 * The <code>FeathersEventType.SOFT_KEYBOARD_ACTIVATE</code> event type
		 * is used by Feathers text editors when they activate a device's soft
		 * keyboard.
		 *
		 * @see feathers.core.ITextEditor
		 */
		public static const SOFT_KEYBOARD_ACTIVATE:String = "softKeyboardActivate";

		/**
		 * The <code>FeathersEventType.SOFT_KEYBOARD_ACTIVATING</code> event type
		 * is used by Feathers text editors when they are about to activate a device's soft
		 * keyboard.
		 *
		 * @see feathers.core.ITextEditor
		 */
		public static const SOFT_KEYBOARD_ACTIVATING:String = "softKeyboardActivating";

		/**
		 * The <code>FeathersEventType.SOFT_KEYBOARD_DEACTIVATE</code> event type
		 * is used by Feathers text editors when they deactivate a device's soft
		 * keyboard.
		 *
		 * @see feathers.core.ITextEditor
		 */
		public static const SOFT_KEYBOARD_DEACTIVATE:String = "softKeyboardDeactivate";

		/**
		 * The <code>FeathersEventType.PROGRESS</code> event type is used by
		 * Feathers classes with long-running tasks to indicate that progress
		 * has been made, but the task is incomplete.
		 */
		public static const PROGRESS:String = "progress";

		/**
		 * The <code>FeathersEventType.LOCATION_CHANGE</code> event type is used
		 * by the Feathers <code>WebView</code> component to indicate that its
		 * location has changed.
		 */
		public static const LOCATION_CHANGE:String = "locationChange";

		/**
		 * The <code>FeathersEventType.LOCATION_CHANGING</code> event type is
		 * used by the Feathers <code>WebView</code> component to indicate that
		 * its location is about to change.
		 */
		public static const LOCATION_CHANGING:String = "locationChanging";

		/**
		 * The <code>FeathersEventType.STATE_CHANGE</code> event type is used by
		 * Feathers classes that implement the <code>IStateContext</code>
		 * interface.
		 *
		 * @see feathers.core.IStateContext
		 */
		public static const STATE_CHANGE:String = "stateChange";

		/**
		 * The <code>FeathersEventType.PULLING</code> event type is used by
		 * Feathers scrolling containers to notify pull views of changes.
		 */
		public static const PULLING:String = "pulling";
	}
}


================================================
FILE: source/feathers/events/MediaPlayerEventType.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.events
{
	/**
	 * Event <code>type</code> constants for Feathers media player controls.
	 * This class is not a subclass of <code>starling.events.Event</code>
	 * because these constants are meant to be used with
	 * <code>dispatchEventWith()</code> and take advantage of the Starling's
	 * event object pooling. The object passed to an event listener will be of
	 * type <code>starling.events.Event</code>.
	 *
	 * <listing version="3.0">
	 * function listener( event:Event ):void
	 * {
	 *     trace( mediaPlayer.currentTime );
	 * }
	 * mediaPlayer.addEventListener( MediaPlayerEventType.CURRENT_TIME_CHANGE, listener );</listing>
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class MediaPlayerEventType
	{
		/**
		 * Dispatched when a media player changes to the full-screen display mode
		 * or back to the normal display mode.
		 */
		public static const DISPLAY_STATE_CHANGE:String = "displayStageChange";

		/**
		 * Dispatched when a media player's playback state changes, such as when
		 * it begins playing or is paused.
		 */
		public static const PLAYBACK_STATE_CHANGE:String = "playbackStageChange";

		/**
		 * Dispatched when a media player's total playhead time changes.
		 */
		public static const TOTAL_TIME_CHANGE:String = "totalTimeChange";

		/**
		 * Dispatched when a media player's current playhead time changes.
		 */
		public static const CURRENT_TIME_CHANGE:String = "currentTimeChange";

		/**
		 * Dispatched when the original, native width or height of a video
		 * player's content is calculated.
		 */
		public static const DIMENSIONS_CHANGE:String = "dimensionsChange";

		/**
		 * Dispatched when a media player's sound transform is changed.
		 */
		public static const SOUND_TRANSFORM_CHANGE:String = "soundTransformChange";

		/**
		 * Dispatched when the media's metadata becomes available.
		 */
		public static const METADATA_RECEIVED:String = "metadataReceived";

		/**
		 * Dispatched when the media's cue point is reached.
		 */
		public static const CUE_POINT:String = "cuePoint";

		/**
		 * Dispatched when the media's XMP data is read.
		 */
		public static const XMP_DATA:String = "xmpData";

		/**
		 * Dispatched periodically when a media player's content is loading to
		 * indicate the current progress.
		 */
		public static const LOAD_PROGRESS:String = "loadProgress";

		/**
		 * Dispatched when a media player's content is fully loaded and it
		 * may be played to completion without buffering.
		 */
		public static const LOAD_COMPLETE:String = "loadComplete";
	}
}


================================================
FILE: source/feathers/layout/AnchorLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IValidating;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;

	import starling.display.DisplayObject;
	import starling.events.EventDispatcher;
	import starling.utils.Pool;

	/**
	 * Dispatched when a property of the layout changes, indicating that a
	 * redraw is probably needed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Positions and sizes items by anchoring their edges (or center points)
	 * to their parent container or to other items.
	 *
	 * @see ../../../help/anchor-layout.html How to use AnchorLayout with Feathers containers
	 * @see AnchorLayoutData
	 *
	 * @productversion Feathers 1.1.0
	 */
	public class AnchorLayout extends EventDispatcher implements ILayout
	{
		/**
		 * @private
		 */
		protected static const CIRCULAR_REFERENCE_ERROR:String = "It is impossible to create this layout due to a circular reference in the AnchorLayoutData.";

		/**
		 * Constructor.
		 */
		public function AnchorLayout()
		{
			super();
		}

		/**
		 * @private
		 */
		protected var _helperVector1:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * @private
		 */
		protected var _helperVector2:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * @inheritDoc
		 */
		public function get requiresLayoutOnScroll():Boolean
		{
			return false;
		}

		/**
		 * @inheritDoc
		 */
		public function layout(items:Vector.<DisplayObject>, viewPortBounds:ViewPortBounds = null, result:LayoutBoundsResult = null):LayoutBoundsResult
		{
			var boundsX:Number = viewPortBounds ? viewPortBounds.x : 0;
			var boundsY:Number = viewPortBounds ? viewPortBounds.y : 0;
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;
			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;

			var viewPortWidth:Number = explicitWidth;
			var viewPortHeight:Number = explicitHeight;

			var needsWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			var needsHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			if(needsWidth || needsHeight)
			{
				this.validateItems(items, explicitWidth, explicitHeight,
					maxWidth, maxHeight, true);
				var point:Point = Pool.getPoint();
				this.measureViewPort(items, viewPortWidth, viewPortHeight, point);
				if(needsWidth)
				{
					viewPortWidth = point.x;
					if(viewPortWidth < minWidth)
					{
						viewPortWidth = minWidth;
					}
					else if(viewPortWidth > maxWidth)
					{
						viewPortWidth = maxWidth;
					}
				}
				if(needsHeight)
				{
					viewPortHeight = point.y;
					if(viewPortHeight < minHeight)
					{
						viewPortHeight = minHeight;
					}
					else if(viewPortHeight > maxHeight)
					{
						viewPortHeight = maxHeight;
					}
				}
				Pool.putPoint(point);
			}
			else
			{
				this.validateItems(items, explicitWidth, explicitHeight,
					maxWidth, maxHeight, false);
			}

			this.layoutWithBounds(items, boundsX, boundsY, viewPortWidth, viewPortHeight);

			point = Pool.getPoint();
			this.measureContent(items, viewPortWidth, viewPortHeight, point);

			if(!result)
			{
				result = new LayoutBoundsResult();
			}
			result.contentWidth = point.x;
			result.contentHeight = point.y;
			result.viewPortWidth = viewPortWidth;
			result.viewPortHeight = viewPortHeight;
			Pool.putPoint(point);
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function calculateNavigationDestination(items:Vector.<DisplayObject>, index:int, keyCode:uint, bounds:LayoutBoundsResult):int
		{
			return index;
		}

		/**
		 * @inheritDoc
		 */
		public function getNearestScrollPositionForIndex(index:int, scrollX:Number, scrollY:Number, items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			return this.getScrollPositionForIndex(index, items, x, y, width, height, result);
		}

		/**
		 * @inheritDoc
		 */
		public function getScrollPositionForIndex(index:int, items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}
			result.x = 0;
			result.y = 0;
			return result;
		}

		/**
		 * @private
		 */
		protected function measureViewPort(items:Vector.<DisplayObject>,
			viewPortWidth:Number, viewPortHeight:Number, result:Point):Point
		{
			this._helperVector1.length = 0;
			this._helperVector2.length = 0;
			result.setTo(0, 0);
			var mainVector:Vector.<DisplayObject> = items;
			var otherVector:Vector.<DisplayObject> = this._helperVector1;
			this.measureVector(items, otherVector, result);
			var currentLength:Number = otherVector.length;
			while(currentLength > 0)
			{
				if(otherVector == this._helperVector1)
				{
					mainVector = this._helperVector1;
					otherVector = this._helperVector2;
				}
				else
				{
					mainVector = this._helperVector2;
					otherVector = this._helperVector1;
				}
				this.measureVector(mainVector, otherVector, result);
				var oldLength:Number = currentLength;
				currentLength = otherVector.length;
				if(oldLength == currentLength)
				{
					this._helperVector1.length = 0;
					this._helperVector2.length = 0;
					throw new IllegalOperationError(CIRCULAR_REFERENCE_ERROR);
				}
			}
			this._helperVector1.length = 0;
			this._helperVector2.length = 0;
			return result;
		}

		/**
		 * @private
		 */
		protected function measureVector(items:Vector.<DisplayObject>, unpositionedItems:Vector.<DisplayObject>, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}

			unpositionedItems.length = 0;
			var itemCount:int = items.length;
			var pushIndex:int = 0;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				var layoutData:AnchorLayoutData;
				if(item is ILayoutDisplayObject)
				{
					var layoutItem:ILayoutDisplayObject = ILayoutDisplayObject(item);
					if(!layoutItem.includeInLayout)
					{
						continue;
					}
					layoutData = layoutItem.layoutData as AnchorLayoutData;
				}
				var isReadyForLayout:Boolean = !layoutData || this.isReadyForLayout(layoutData, i, items, unpositionedItems);
				if(!isReadyForLayout)
				{
					unpositionedItems[pushIndex] = item;
					pushIndex++;
					continue;
				}

				this.measureItem(item, result);
			}

			return result;
		}

		/**
		 * @private
		 */
		protected function measureItem(item:DisplayObject, result:Point):void
		{
			var maxX:Number = result.x;
			var maxY:Number = result.y;
			var isAnchored:Boolean = false;
			if(item is ILayoutDisplayObject)
			{
				var layoutItem:ILayoutDisplayObject = ILayoutDisplayObject(item);
				var layoutData:AnchorLayoutData = layoutItem.layoutData as AnchorLayoutData;
				if(layoutData)
				{
					var measurement:Number = this.measureItemHorizontally(layoutItem, layoutData);
					if(measurement > maxX)
					{
						maxX = measurement;
					}
					measurement = this.measureItemVertically(layoutItem, layoutData);
					if(measurement > maxY)
					{
						maxY = measurement;
					}
					isAnchored = true;
				}
			}
			if(!isAnchored)
			{
				measurement = item.x - item.pivotX + item.width;
				if(measurement > maxX)
				{
					maxX = measurement;
				}
				measurement = item.y - item.pivotY + item.height;
				if(measurement > maxY)
				{
					maxY = measurement;
				}
			}

			result.x = maxX;
			result.y = maxY;
		}

		/**
		 * @private
		 */
		protected function measureItemHorizontally(item:ILayoutDisplayObject, layoutData:AnchorLayoutData):Number
		{
			var itemWidth:Number = item.width;
			var displayItem:DisplayObject = DisplayObject(item);
			var left:Number = this.getLeftOffset(displayItem);
			var right:Number = this.getRightOffset(displayItem);
			return itemWidth + left + right;
		}

		/**
		 * @private
		 */
		protected function measureItemVertically(item:ILayoutDisplayObject, layoutData:AnchorLayoutData):Number
		{
			var itemHeight:Number = item.height;
			if(layoutData && item is IFeathersControl)
			{
				var percentHeight:Number = layoutData.percentHeight;
				//for some reason, if we don't call a function right here,
				//compiling with the flex 4.6 SDK will throw a VerifyError
				//for a stack overflow.
				//we could change the === check back to !isNaN() instead, but
				//isNaN() can allocate an object, so we should call a different
				//function without allocation.
				this.doNothing();
				if(percentHeight === percentHeight) //!isNaN
				{
					itemHeight = IFeathersControl(item).minHeight;
				}
			}
			var displayItem:DisplayObject = DisplayObject(item);
			var top:Number = this.getTopOffset(displayItem);
			var bottom:Number = this.getBottomOffset(displayItem);
			return itemHeight + top + bottom;
		}

		/**
		 * @private
		 * This function is here to work around a bug in the Flex 4.6 SDK
		 * compiler. For explanation, see the places where it gets called.
		 */
		protected function doNothing():void {}

		/**
		 * @private
		 */
		protected function getTopOffset(item:DisplayObject):Number
		{
			if(item is ILayoutDisplayObject)
			{
				var layoutItem:ILayoutDisplayObject = ILayoutDisplayObject(item);
				var layoutData:AnchorLayoutData = layoutItem.layoutData as AnchorLayoutData;
				if(layoutData)
				{
					var top:Number = layoutData.top;
					var hasTopPosition:Boolean = top === top; //!isNaN
					var bottom:Number = layoutData.bottom;
					var hasBottomPosition:Boolean = bottom === bottom; //!isNaN
					var verticalCenter:Number = layoutData.verticalCenter;
					var hasVerticalCenterPosition:Boolean = verticalCenter === verticalCenter; //!isNaN
					if(hasTopPosition)
					{
						var topAnchorDisplayObject:DisplayObject = layoutData.topAnchorDisplayObject;
						if(topAnchorDisplayObject)
						{
							top += topAnchorDisplayObject.height + this.getTopOffset(topAnchorDisplayObject);
						}
						else
						{
							return top;
						}
					}
					else if(!hasBottomPosition && !hasVerticalCenterPosition)
					{
						top = item.y;
					}
					else
					{
						top = 0;
					}
					if(hasBottomPosition)
					{
						var bottomAnchorDisplayObject:DisplayObject = layoutData.bottomAnchorDisplayObject;
						if(bottomAnchorDisplayObject)
						{
							top = Math.max(top, -bottomAnchorDisplayObject.height - bottom + this.getTopOffset(bottomAnchorDisplayObject));
						}
					}
					if(hasVerticalCenterPosition)
					{
						var verticalCenterAnchorDisplayObject:DisplayObject = layoutData.verticalCenterAnchorDisplayObject;
						if(verticalCenterAnchorDisplayObject)
						{
							var verticalOffset:Number = verticalCenter - Math.round((item.height - verticalCenterAnchorDisplayObject.height) / 2);
							top = Math.max(top, verticalOffset + this.getTopOffset(verticalCenterAnchorDisplayObject));
						}
						else if(verticalCenter > 0)
						{
							return verticalCenter * 2;
						}
					}
					return top;
				}
			}
			return item.y;
		}

		/**
		 * @private
		 */
		protected function getRightOffset(item:DisplayObject):Number
		{
			if(item is ILayoutDisplayObject)
			{
				var layoutItem:ILayoutDisplayObject = ILayoutDisplayObject(item);
				var layoutData:AnchorLayoutData = layoutItem.layoutData as AnchorLayoutData;
				if(layoutData)
				{
					var right:Number = layoutData.right;
					var hasRightPosition:Boolean = right === right; //!isNaN
					if(hasRightPosition)
					{
						var rightAnchorDisplayObject:DisplayObject = layoutData.rightAnchorDisplayObject;
						if(rightAnchorDisplayObject)
						{
							right += rightAnchorDisplayObject.width + this.getRightOffset(rightAnchorDisplayObject);
						}
						else
						{
							return right;
						}
					}
					else
					{
						right = 0;
					}
					var left:Number = layoutData.left;
					var hasLeftPosition:Boolean = left === left; //!isNaN
					if(hasLeftPosition)
					{
						var leftAnchorDisplayObject:DisplayObject = layoutData.leftAnchorDisplayObject;
						if(leftAnchorDisplayObject)
						{
							right = Math.max(right, -leftAnchorDisplayObject.width - left + this.getRightOffset(leftAnchorDisplayObject));
						}
					}
					var horizontalCenter:Number = layoutData.horizontalCenter;
					var hasHorizontalCenterPosition:Boolean = horizontalCenter === horizontalCenter; //!isNaN
					if(hasHorizontalCenterPosition)
					{
						var horizontalCenterAnchorDisplayObject:DisplayObject = layoutData.horizontalCenterAnchorDisplayObject;
						if(horizontalCenterAnchorDisplayObject)
						{
							var horizontalOffset:Number = -horizontalCenter - Math.round((item.width - horizontalCenterAnchorDisplayObject.width) / 2);
							right = Math.max(right, horizontalOffset + this.getRightOffset(horizontalCenterAnchorDisplayObject));
						}
						else if(horizontalCenter < 0)
						{
							return -horizontalCenter * 2;
						}
					}
					return right;
				}
			}
			return 0;
		}

		/**
		 * @private
		 */
		protected function getBottomOffset(item:DisplayObject):Number
		{
			if(item is ILayoutDisplayObject)
			{
				var layoutItem:ILayoutDisplayObject = ILayoutDisplayObject(item);
				var layoutData:AnchorLayoutData = layoutItem.layoutData as AnchorLayoutData;
				if(layoutData)
				{
					var bottom:Number = layoutData.bottom;
					var hasBottomPosition:Boolean = bottom === bottom; //!isNaN
					if(hasBottomPosition)
					{
						var bottomAnchorDisplayObject:DisplayObject = layoutData.bottomAnchorDisplayObject;
						if(bottomAnchorDisplayObject)
						{
							bottom += bottomAnchorDisplayObject.height + this.getBottomOffset(bottomAnchorDisplayObject);
						}
						else
						{
							return bottom;
						}
					}
					else
					{
						bottom = 0;
					}
					var top:Number = layoutData.top;
					var hasTopPosition:Boolean = top === top; //!isNaN
					if(hasTopPosition)
					{
						var topAnchorDisplayObject:DisplayObject = layoutData.topAnchorDisplayObject;
						if(topAnchorDisplayObject)
						{
							bottom = Math.max(bottom, -topAnchorDisplayObject.height - top + this.getBottomOffset(topAnchorDisplayObject));
						}
					}
					var verticalCenter:Number = layoutData.verticalCenter;
					var hasVerticalCenterPosition:Boolean = verticalCenter === verticalCenter; //!isNaN
					if(hasVerticalCenterPosition)
					{
						var verticalCenterAnchorDisplayObject:DisplayObject = layoutData.verticalCenterAnchorDisplayObject;
						if(verticalCenterAnchorDisplayObject)
						{
							var verticalOffset:Number = -verticalCenter - Math.round((item.height - verticalCenterAnchorDisplayObject.height) / 2);
							bottom = Math.max(bottom, verticalOffset + this.getBottomOffset(verticalCenterAnchorDisplayObject));
						}
						else if(verticalCenter < 0)
						{
							return -verticalCenter * 2;
						}
					}
					return bottom;
				}
			}
			return 0;
		}

		/**
		 * @private
		 */
		protected function getLeftOffset(item:DisplayObject):Number
		{
			if(item is ILayoutDisplayObject)
			{
				var layoutItem:ILayoutDisplayObject = ILayoutDisplayObject(item);
				var layoutData:AnchorLayoutData = layoutItem.layoutData as AnchorLayoutData;
				if(layoutData)
				{
					var left:Number = layoutData.left;
					var hasLeftPosition:Boolean = left === left; //!isNaN
					var right:Number = layoutData.right;
					var hasRightPosition:Boolean = right === right; //!isNaN;
					var horizontalCenter:Number = layoutData.horizontalCenter;
					var hasHorizontalCenterPosition:Boolean = horizontalCenter === horizontalCenter; //!isNaN
					if(hasLeftPosition)
					{
						var leftAnchorDisplayObject:DisplayObject = layoutData.leftAnchorDisplayObject;
						if(leftAnchorDisplayObject)
						{
							left += leftAnchorDisplayObject.width + this.getLeftOffset(leftAnchorDisplayObject);
						}
						else
						{
							return left;
						}
					}
					else if(!hasRightPosition && !hasHorizontalCenterPosition)
					{
						left = item.x;
					}
					else
					{
						left = 0;
					}
					if(hasRightPosition)
					{
						var rightAnchorDisplayObject:DisplayObject = layoutData.rightAnchorDisplayObject;
						if(rightAnchorDisplayObject)
						{
							left = Math.max(left, -rightAnchorDisplayObject.width - right + this.getLeftOffset(rightAnchorDisplayObject));
						}
					}
					if(hasHorizontalCenterPosition)
					{
						var horizontalCenterAnchorDisplayObject:DisplayObject = layoutData.horizontalCenterAnchorDisplayObject;
						if(horizontalCenterAnchorDisplayObject)
						{
							var horizontalOffset:Number = horizontalCenter - Math.round((item.width - horizontalCenterAnchorDisplayObject.width) / 2);
							left = Math.max(left, horizontalOffset + this.getLeftOffset(horizontalCenterAnchorDisplayObject));
						}
						else if(horizontalCenter > 0)
						{
							return horizontalCenter * 2;
						}
					}
					return left;
				}
			}
			return item.x;
		}

		/**
		 * @private
		 */
		protected function layoutWithBounds(items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number):void
		{
			this._helperVector1.length = 0;
			this._helperVector2.length = 0;
			var mainVector:Vector.<DisplayObject> = items;
			var otherVector:Vector.<DisplayObject> = this._helperVector1;
			this.layoutVector(items, otherVector, x, y, width, height);
			var currentLength:Number = otherVector.length;
			while(currentLength > 0)
			{
				if(otherVector == this._helperVector1)
				{
					mainVector = this._helperVector1;
					otherVector = this._helperVector2;
				}
				else
				{
					mainVector = this._helperVector2;
					otherVector = this._helperVector1;
				}
				this.layoutVector(mainVector, otherVector, x, y, width, height);
				var oldLength:Number = currentLength;
				currentLength = otherVector.length;
				if(oldLength == currentLength)
				{
					this._helperVector1.length = 0;
					this._helperVector2.length = 0;
					throw new IllegalOperationError(CIRCULAR_REFERENCE_ERROR);
				}
			}
			this._helperVector1.length = 0;
			this._helperVector2.length = 0;
		}

		/**
		 * @private
		 */
		protected function layoutVector(items:Vector.<DisplayObject>, unpositionedItems:Vector.<DisplayObject>, boundsX:Number, boundsY:Number, viewPortWidth:Number, viewPortHeight:Number):void
		{
			unpositionedItems.length = 0;
			var itemCount:int = items.length;
			var pushIndex:int = 0;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				var layoutItem:ILayoutDisplayObject = item as ILayoutDisplayObject;
				if(!layoutItem || !layoutItem.includeInLayout)
				{
					continue;
				}
				var layoutData:AnchorLayoutData = layoutItem.layoutData as AnchorLayoutData;
				if(!layoutData)
				{
					continue;
				}

				var isReadyForLayout:Boolean = this.isReadyForLayout(layoutData, i, items, unpositionedItems);
				if(!isReadyForLayout)
				{
					unpositionedItems[pushIndex] = item;
					pushIndex++;
					continue;
				}
				this.positionHorizontally(layoutItem, layoutData, boundsX, boundsY, viewPortWidth, viewPortHeight);
				this.positionVertically(layoutItem, layoutData, boundsX, boundsY, viewPortWidth, viewPortHeight);
			}
		}

		/**
		 * @private
		 */
		protected function positionHorizontally(item:ILayoutDisplayObject, layoutData:AnchorLayoutData, boundsX:Number, boundsY:Number, viewPortWidth:Number, viewPortHeight:Number):void
		{
			var uiItem:IMeasureDisplayObject = item as IMeasureDisplayObject;
			var percentWidth:Number = layoutData.percentWidth;
			if(percentWidth === percentWidth) //!isNaN
			{
				if(percentWidth < 0)
				{
					percentWidth = 0;
				}
				else if(percentWidth > 100)
				{
					percentWidth = 100;
				}
				var itemWidth:Number = percentWidth * 0.01 * viewPortWidth;
				if(uiItem !== null)
				{
					var minWidth:Number = uiItem.explicitMinWidth;
					var maxWidth:Number = uiItem.explicitMaxWidth;
					if(itemWidth < minWidth)
					{
						itemWidth = minWidth;
					}
					else if(itemWidth > maxWidth)
					{
						itemWidth = maxWidth;
					}
				}
				if(itemWidth > viewPortWidth)
				{
					itemWidth = viewPortWidth;
				}
				if(uiItem.explicitMaxWidth === uiItem.explicitMaxWidth &&
					uiItem.explicitMaxWidth < itemWidth)
				{
					itemWidth = uiItem.explicitMaxWidth;
				}
				item.width = itemWidth;
			}
			var left:Number = layoutData.left;
			var hasLeftPosition:Boolean = left === left; //!isNaN
			if(hasLeftPosition)
			{
				var leftAnchorDisplayObject:DisplayObject = layoutData.leftAnchorDisplayObject;
				if(leftAnchorDisplayObject)
				{
					item.x = item.pivotX + leftAnchorDisplayObject.x - leftAnchorDisplayObject.pivotX + leftAnchorDisplayObject.width + left;
				}
				else
				{
					item.x = item.pivotX + boundsX + left;
				}
			}
			var horizontalCenter:Number = layoutData.horizontalCenter;
			var hasHorizontalCenterPosition:Boolean = horizontalCenter === horizontalCenter; //!isNaN
			var right:Number = layoutData.right;
			var hasRightPosition:Boolean = right === right; //!isNaN
			if(hasRightPosition)
			{
				var rightAnchorDisplayObject:DisplayObject = layoutData.rightAnchorDisplayObject;
				if(hasLeftPosition)
				{
					var leftRightWidth:Number = viewPortWidth;
					if(rightAnchorDisplayObject)
					{
						leftRightWidth = rightAnchorDisplayObject.x - rightAnchorDisplayObject.pivotX;
					}
					if(leftAnchorDisplayObject)
					{
						leftRightWidth -= (leftAnchorDisplayObject.x - leftAnchorDisplayObject.pivotX + leftAnchorDisplayObject.width);
					}
					itemWidth = leftRightWidth - right - left;
					if(uiItem.explicitMaxWidth === uiItem.explicitMaxWidth && //!isNaN
						uiItem.explicitMaxWidth < itemWidth)
					{
						itemWidth = uiItem.explicitMaxWidth;
					}
					item.width = itemWidth;
				}
				else if(hasHorizontalCenterPosition)
				{
					var horizontalCenterAnchorDisplayObject:DisplayObject = layoutData.horizontalCenterAnchorDisplayObject;
					var xPositionOfCenter:Number;
					if(horizontalCenterAnchorDisplayObject)
					{
						xPositionOfCenter = horizontalCenterAnchorDisplayObject.x - horizontalCenterAnchorDisplayObject.pivotX + Math.round(horizontalCenterAnchorDisplayObject.width / 2) + horizontalCenter;
					}
					else
					{
						xPositionOfCenter = Math.round(viewPortWidth / 2) + horizontalCenter;
					}
					var xPositionOfRight:Number;
					if(rightAnchorDisplayObject)
					{
						xPositionOfRight = rightAnchorDisplayObject.x - rightAnchorDisplayObject.pivotX - right;
					}
					else
					{
						xPositionOfRight = viewPortWidth - right;
					}
					itemWidth = 2 * (xPositionOfRight - xPositionOfCenter);
					if(uiItem.explicitMaxWidth === uiItem.explicitMaxWidth && //!isNaN
						uiItem.explicitMaxWidth < itemWidth)
					{
						itemWidth = uiItem.explicitMaxWidth;
					}
					item.width = itemWidth;
					item.x = item.pivotX + viewPortWidth - right - item.width;
				}
				else
				{
					if(rightAnchorDisplayObject)
					{
						item.x = item.pivotX + rightAnchorDisplayObject.x - rightAnchorDisplayObject.pivotX - item.width - right;
					}
					else
					{
						item.x = item.pivotX + boundsX + viewPortWidth - right - item.width;
					}
				}
			}
			else if(hasHorizontalCenterPosition)
			{
				horizontalCenterAnchorDisplayObject = layoutData.horizontalCenterAnchorDisplayObject;
				if(horizontalCenterAnchorDisplayObject)
				{
					xPositionOfCenter = horizontalCenterAnchorDisplayObject.x - horizontalCenterAnchorDisplayObject.pivotX + Math.round(horizontalCenterAnchorDisplayObject.width / 2) + horizontalCenter;
				}
				else
				{
					xPositionOfCenter = Math.round(viewPortWidth / 2) + horizontalCenter;
				}

				if(hasLeftPosition)
				{
					itemWidth = 2 * (xPositionOfCenter - item.x + item.pivotX);
					if(uiItem.explicitMaxWidth === uiItem.explicitMaxWidth && //!isNaN
						uiItem.explicitMaxWidth < itemWidth)
					{
						itemWidth = uiItem.explicitMaxWidth;
					}
					item.width = itemWidth;
				}
				else
				{
					item.x = item.pivotX + xPositionOfCenter - Math.round(item.width / 2);
				}
			}
		}

		/**
		 * @private
		 */
		protected function positionVertically(item:ILayoutDisplayObject, layoutData:AnchorLayoutData, boundsX:Number, boundsY:Number, viewPortWidth:Number, viewPortHeight:Number):void
		{
			var uiItem:IMeasureDisplayObject = item as IMeasureDisplayObject;
			var percentHeight:Number = layoutData.percentHeight;
			if(percentHeight === percentHeight) //!isNaN
			{
				if(percentHeight < 0)
				{
					percentHeight = 0;
				}
				else if(percentHeight > 100)
				{
					percentHeight = 100;
				}
				var itemHeight:Number = percentHeight * 0.01 * viewPortHeight;
				if(uiItem !== null)
				{
					var minHeight:Number = uiItem.explicitMinHeight;
					var maxHeight:Number = uiItem.explicitMaxHeight;
					if(itemHeight < minHeight)
					{
						itemHeight = minHeight;
					}
					else if(itemHeight > maxHeight)
					{
						itemHeight = maxHeight;
					}
				}
				if(itemHeight > viewPortHeight)
				{
					itemHeight = viewPortHeight;
				}
				if(uiItem.explicitMaxHeight === uiItem.explicitMaxHeight && //!isNaN
					uiItem.explicitMaxHeight < itemHeight)
				{
					itemHeight = uiItem.explicitMaxHeight;
				}
				item.height = itemHeight;
			}
			var top:Number = layoutData.top;
			var hasTopPosition:Boolean = top === top; //!isNaN
			if(hasTopPosition)
			{
				var topAnchorDisplayObject:DisplayObject = layoutData.topAnchorDisplayObject;
				if(topAnchorDisplayObject)
				{
					item.y = item.pivotY + topAnchorDisplayObject.y - topAnchorDisplayObject.pivotY + topAnchorDisplayObject.height + top;
				}
				else
				{
					item.y = item.pivotY + boundsY + top;
				}
			}
			var verticalCenter:Number = layoutData.verticalCenter;
			var hasVerticalCenterPosition:Boolean = verticalCenter === verticalCenter; //!isNaN
			var bottom:Number = layoutData.bottom;
			var hasBottomPosition:Boolean = bottom === bottom; //!isNaN
			if(hasBottomPosition)
			{
				var bottomAnchorDisplayObject:DisplayObject = layoutData.bottomAnchorDisplayObject;
				if(hasTopPosition)
				{
					var topBottomHeight:Number = viewPortHeight;
					if(bottomAnchorDisplayObject)
					{
						topBottomHeight = bottomAnchorDisplayObject.y - bottomAnchorDisplayObject.pivotY;
					}
					if(topAnchorDisplayObject)
					{
						topBottomHeight -= (topAnchorDisplayObject.y - topAnchorDisplayObject.pivotY + topAnchorDisplayObject.height);
					}
					itemHeight = topBottomHeight - bottom - top;
					if(uiItem.explicitMaxHeight === uiItem.explicitMaxHeight && //!isNaN
						uiItem.explicitMaxHeight < itemHeight)
					{
						itemHeight = uiItem.explicitMaxHeight;
					}
					item.height = itemHeight;
				}
				else if(hasVerticalCenterPosition)
				{
					var verticalCenterAnchorDisplayObject:DisplayObject = layoutData.verticalCenterAnchorDisplayObject;
					var yPositionOfCenter:Number;
					if(verticalCenterAnchorDisplayObject)
					{
						yPositionOfCenter = verticalCenterAnchorDisplayObject.y - verticalCenterAnchorDisplayObject.pivotY + Math.round(verticalCenterAnchorDisplayObject.height / 2) + verticalCenter;
					}
					else
					{
						yPositionOfCenter = Math.round(viewPortHeight / 2) + verticalCenter;
					}
					var yPositionOfBottom:Number;
					if(bottomAnchorDisplayObject)
					{
						yPositionOfBottom = bottomAnchorDisplayObject.y - bottomAnchorDisplayObject.pivotY - bottom;
					}
					else
					{
						yPositionOfBottom = viewPortHeight - bottom;
					}
					itemHeight = 2 * (yPositionOfBottom - yPositionOfCenter);
					if(uiItem.explicitMaxHeight === uiItem.explicitMaxHeight && //!isNaN
						uiItem.explicitMaxHeight < itemHeight)
					{
						itemHeight = uiItem.explicitMaxHeight;
					}
					item.height = itemHeight;
					item.y = item.pivotY + viewPortHeight - bottom - item.height;
				}
				else
				{
					if(bottomAnchorDisplayObject)
					{
						item.y = item.pivotY + bottomAnchorDisplayObject.y - bottomAnchorDisplayObject.pivotY - item.height - bottom;
					}
					else
					{
						item.y = item.pivotY + boundsY + viewPortHeight - bottom - item.height;
					}
				}
			}
			else if(hasVerticalCenterPosition)
			{
				verticalCenterAnchorDisplayObject = layoutData.verticalCenterAnchorDisplayObject;
				if(verticalCenterAnchorDisplayObject)
				{
					yPositionOfCenter = verticalCenterAnchorDisplayObject.y - verticalCenterAnchorDisplayObject.pivotY + Math.round(verticalCenterAnchorDisplayObject.height / 2) + verticalCenter;
				}
				else
				{
					yPositionOfCenter = Math.round(viewPortHeight / 2) + verticalCenter;
				}

				if(hasTopPosition)
				{
					itemHeight = 2 * (yPositionOfCenter - item.y + item.pivotY);
					if(uiItem.explicitMaxHeight === uiItem.explicitMaxHeight && //!isNaN
						uiItem.explicitMaxHeight < itemHeight)
					{
						itemHeight = uiItem.explicitMaxHeight;
					}
					item.height = itemHeight;
				}
				else
				{
					item.y = item.pivotY + yPositionOfCenter - Math.round(item.height / 2);
				}
			}
		}

		/**
		 * @private
		 */
		protected function measureContent(items:Vector.<DisplayObject>, viewPortWidth:Number, viewPortHeight:Number, result:Point = null):Point
		{
			var maxX:Number = viewPortWidth;
			var maxY:Number = viewPortHeight;
			var itemCount:int = items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				var itemMaxX:Number = item.x - item.pivotX + item.width;
				var itemMaxY:Number = item.y - item.pivotY + item.height;
				if(itemMaxX === itemMaxX && //!isNaN
					itemMaxX > maxX)
				{
					maxX = itemMaxX;
				}
				if(itemMaxY === itemMaxY && //!isNaN
					itemMaxY > maxY)
				{
					maxY = itemMaxY;
				}
			}
			result.x = maxX;
			result.y = maxY;
			return result;
		}

		/**
		 * @private
		 */
		protected function isReadyForLayout(layoutData:AnchorLayoutData, index:int, items:Vector.<DisplayObject>, unpositionedItems:Vector.<DisplayObject>):Boolean
		{
			var nextIndex:int = index + 1;
			var leftAnchorDisplayObject:DisplayObject = layoutData.leftAnchorDisplayObject;
			if(leftAnchorDisplayObject && (items.indexOf(leftAnchorDisplayObject, nextIndex) >= nextIndex || unpositionedItems.indexOf(leftAnchorDisplayObject) >= 0))
			{
				return false;
			}
			var rightAnchorDisplayObject:DisplayObject = layoutData.rightAnchorDisplayObject;
			if(rightAnchorDisplayObject && (items.indexOf(rightAnchorDisplayObject, nextIndex) >= nextIndex || unpositionedItems.indexOf(rightAnchorDisplayObject) >= 0))
			{
				return false;
			}
			var topAnchorDisplayObject:DisplayObject = layoutData.topAnchorDisplayObject;
			if(topAnchorDisplayObject && (items.indexOf(topAnchorDisplayObject, nextIndex) >= nextIndex || unpositionedItems.indexOf(topAnchorDisplayObject) >= 0))
			{
				return false;
			}
			var bottomAnchorDisplayObject:DisplayObject = layoutData.bottomAnchorDisplayObject;
			if(bottomAnchorDisplayObject && (items.indexOf(bottomAnchorDisplayObject, nextIndex) >= nextIndex || unpositionedItems.indexOf(bottomAnchorDisplayObject) >= 0))
			{
				return false;
			}
			var horizontalCenterAnchorDisplayObject:DisplayObject = layoutData.horizontalCenterAnchorDisplayObject;
			if(horizontalCenterAnchorDisplayObject && (items.indexOf(horizontalCenterAnchorDisplayObject, nextIndex) >= nextIndex || unpositionedItems.indexOf(horizontalCenterAnchorDisplayObject) >= 0))
			{
				return false;
			}
			var verticalCenterAnchorDisplayObject:DisplayObject = layoutData.verticalCenterAnchorDisplayObject;
			if(verticalCenterAnchorDisplayObject && (items.indexOf(verticalCenterAnchorDisplayObject, nextIndex) >= nextIndex || unpositionedItems.indexOf(verticalCenterAnchorDisplayObject) >= 0))
			{
				return false;
			}
			return true;
		}

		/**
		 * @private
		 */
		protected function isReferenced(item:DisplayObject, items:Vector.<DisplayObject>):Boolean
		{
			var itemCount:int = items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var otherItem:ILayoutDisplayObject = items[i] as ILayoutDisplayObject;
				if(!otherItem || otherItem == item)
				{
					continue;
				}
				var layoutData:AnchorLayoutData = otherItem.layoutData as AnchorLayoutData;
				if(!layoutData)
				{
					continue;
				}
				if(layoutData.leftAnchorDisplayObject == item || layoutData.horizontalCenterAnchorDisplayObject == item ||
					layoutData.rightAnchorDisplayObject == item || layoutData.topAnchorDisplayObject == item ||
					layoutData.verticalCenterAnchorDisplayObject == item || layoutData.bottomAnchorDisplayObject == item)
				{
					return true;
				}
			}
			return false;
		}

		/**
		 * @private
		 */
		protected function validateItems(items:Vector.<DisplayObject>,
			explicitWidth:Number, explicitHeight:Number,
			maxWidth:Number, maxHeight:Number, force:Boolean):void
		{
			var needsWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			var needsHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			var containerWidth:Number = explicitWidth;
			if(needsWidth && maxWidth < Number.POSITIVE_INFINITY)
			{
				containerWidth = maxWidth;
			}
			var containerHeight:Number = explicitHeight;
			if(needsHeight && maxHeight < Number.POSITIVE_INFINITY)
			{
				containerHeight = maxHeight;
			}
			var itemCount:int = items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				if(item is ILayoutDisplayObject)
				{
					var layoutItem:ILayoutDisplayObject = ILayoutDisplayObject(item);
					if(!layoutItem.includeInLayout)
					{
						continue;
					}
					var layoutData:AnchorLayoutData = layoutItem.layoutData as AnchorLayoutData;
					if(layoutData !== null)
					{
						var left:Number = layoutData.left;
						var hasLeftPosition:Boolean = left === left; //!isNaN
						var leftAnchor:DisplayObject = layoutData.leftAnchorDisplayObject;
						var right:Number = layoutData.right;
						var rightAnchor:DisplayObject = layoutData.rightAnchorDisplayObject;
						var hasRightPosition:Boolean = right === right; //!isNaN
						var percentWidth:Number = layoutData.percentWidth;
						var hasPercentWidth:Boolean = percentWidth === percentWidth; //!isNaN
						var measureItem:IMeasureDisplayObject = IMeasureDisplayObject(item);
						if(needsWidth)
						{
							if(hasLeftPosition && leftAnchor === null &&
								hasRightPosition && rightAnchor === null)
							{
								measureItem.width = NaN;
								measureItem.maxWidth = maxWidth - left - right;
							}
							else if(hasPercentWidth)
							{
								if(percentWidth < 0)
								{
									percentWidth = 0;
								}
								else if(percentWidth > 100)
								{
									percentWidth = 100;
								}
								measureItem.width = NaN;
								measureItem.maxWidth = percentWidth * 0.01 * maxWidth;
							}
						}
						else
						{
							//optimization: set the child width before
							//validation if the container width is explicit
							//or has a maximum
							if(hasLeftPosition && leftAnchor === null &&
								hasRightPosition && rightAnchor === null)
							{
								var itemWidth:Number = containerWidth - left - right;
								if(measureItem.explicitMaxWidth === measureItem.explicitMaxWidth && //!isNaN
									measureItem.explicitMaxWidth < itemWidth)
								{
									itemWidth = measureItem.explicitMaxWidth;
								}
								item.width = itemWidth;
							}
							else if(hasPercentWidth)
							{
								if(percentWidth < 0)
								{
									percentWidth = 0;
								}
								else if(percentWidth > 100)
								{
									percentWidth = 100;
								}
								itemWidth = percentWidth * 0.01 * containerWidth;
								if(measureItem.explicitMaxWidth === measureItem.explicitMaxWidth && //!isNaN
									measureItem.explicitMaxWidth < itemWidth)
								{
									itemWidth = measureItem.explicitMaxWidth;
								}
								item.width = itemWidth;
							}
						}
						var horizontalCenter:Number = layoutData.horizontalCenter;
						var hasHorizontalCenterPosition:Boolean = horizontalCenter === horizontalCenter; //!isNaN

						var top:Number = layoutData.top;
						var hasTopPosition:Boolean = top === top; //!isNaN
						var topAnchor:DisplayObject = layoutData.topAnchorDisplayObject;
						var bottom:Number = layoutData.bottom;
						var hasBottomPosition:Boolean = bottom === bottom; //!isNaN
						var bottomAnchor:DisplayObject = layoutData.bottomAnchorDisplayObject;
						var percentHeight:Number = layoutData.percentHeight;
						var hasPercentHeight:Boolean = percentHeight === percentHeight; //!isNaN
						if(!needsHeight)
						{
							//optimization: set the child height before
							//validation if the container height is explicit
							//or has a maximum.
							if(hasTopPosition && topAnchor === null &&
								hasBottomPosition && bottomAnchor === null)
							{
								var itemHeight:Number = containerHeight - top - bottom;
								if(measureItem.explicitMaxHeight === measureItem.explicitMaxHeight && //!isNaN
									measureItem.explicitMaxHeight < itemHeight)
								{
									itemHeight = measureItem.explicitMaxHeight;
								}
								item.height = itemHeight;
							}
							else if(hasPercentHeight)
							{
								if(percentHeight < 0)
								{
									percentHeight = 0;
								}
								else if(percentHeight > 100)
								{
									percentHeight = 100;
								}
								itemHeight = percentHeight * 0.01 * containerHeight;
								if(measureItem.explicitMaxHeight === measureItem.explicitMaxHeight && //!isNaN
									measureItem.explicitMaxHeight < itemHeight)
								{
									itemHeight = measureItem.explicitMaxHeight;
								}
								item.height = itemHeight;
							}
						}
						var verticalCenter:Number = layoutData.verticalCenter;
						var hasVerticalCenterPosition:Boolean = verticalCenter === verticalCenter; //!isNaN

						if((hasRightPosition && !hasLeftPosition && !hasHorizontalCenterPosition) ||
							hasHorizontalCenterPosition)
						{
							if(item is IValidating)
							{
								IValidating(item).validate();
							}
							continue;
						}
						else if((hasBottomPosition && !hasTopPosition && !hasVerticalCenterPosition) ||
							hasVerticalCenterPosition)
						{
							if(item is IValidating)
							{
								IValidating(item).validate();
							}
							continue;
						}
					}
				}
				if(force || this.isReferenced(item, items))
				{
					if(item is IValidating)
					{
						IValidating(item).validate();
					}
				}
			}
		}
	}
}


================================================
FILE: source/feathers/layout/AnchorLayoutData.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * @inheritDoc
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Extra, optional data used by an <code>AnchorLayout</code> instance to
	 * position and size a display object.
	 *
	 * @see AnchorLayout
	 * @see ILayoutDisplayObject
	 *
	 * @productversion Feathers 1.1.0
	 */
	public class AnchorLayoutData extends EventDispatcher implements ILayoutData
	{
		/**
		 * Constructor.
		 */
		public function AnchorLayoutData(top:Number = NaN, right:Number = NaN,
			bottom:Number = NaN, left:Number = NaN, horizontalCenter:Number = NaN,
			verticalCenter:Number = NaN)
		{
			this.top = top;
			this.right = right;
			this.bottom = bottom;
			this.left = left;
			this.horizontalCenter = horizontalCenter;
			this.verticalCenter = verticalCenter;
		}

		/**
		 * @private
		 */
		protected var _percentWidth:Number = NaN;

		/**
		 * The width of the layout object, as a percentage of the container's
		 * width.
		 *
		 * <p>A percentage may be specified in the range from <code>0</code>
		 * to <code>100</code>. If the value is set to <code>NaN</code>, this
		 * property is ignored.</p>
		 *
		 * @default NaN
		 */
		public function get percentWidth():Number
		{
			return this._percentWidth;
		}

		/**
		 * @private
		 */
		public function set percentWidth(value:Number):void
		{
			if(this._percentWidth == value)
			{
				return;
			}
			this._percentWidth = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _percentHeight:Number = NaN;

		/**
		 * The height of the layout object, as a percentage of the container's
		 * height.
		 *
		 * <p>A percentage may be specified in the range from <code>0</code>
		 * to <code>100</code>. If the value is set to <code>NaN</code>, this
		 * property is ignored.</p>
		 *
		 * @default NaN
		 */
		public function get percentHeight():Number
		{
			return this._percentHeight;
		}

		/**
		 * @private
		 */
		public function set percentHeight(value:Number):void
		{
			if(this._percentHeight == value)
			{
				return;
			}
			this._percentHeight = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _topAnchorDisplayObject:DisplayObject;

		/**
		 * The top edge of the layout object will be relative to this anchor.
		 * If there is no anchor, the top edge of the parent container will be
		 * the anchor.
		 *
		 * @default null
		 *
		 * @see #top
		 */
		public function get topAnchorDisplayObject():DisplayObject
		{
			return this._topAnchorDisplayObject;
		}

		/**
		 * @private
		 */
		public function set topAnchorDisplayObject(value:DisplayObject):void
		{
			if(this._topAnchorDisplayObject == value)
			{
				return;
			}
			this._topAnchorDisplayObject = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _top:Number = NaN;

		/**
		 * The position, in pixels, of the top edge relative to the top
		 * anchor, or, if there is no top anchor, then the position is relative
		 * to the top edge of the parent container. If this value is
		 * <code>NaN</code>, the object's top edge will not be anchored.
		 *
		 * @default NaN
		 *
		 * @see #topAnchorDisplayObject
		 */
		public function get top():Number
		{
			return this._top;
		}

		/**
		 * @private
		 */
		public function set top(value:Number):void
		{
			if(this._top == value)
			{
				return;
			}
			this._top = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _rightAnchorDisplayObject:DisplayObject;

		/**
		 * The right edge of the layout object will be relative to this anchor.
		 * If there is no anchor, the right edge of the parent container will be
		 * the anchor.
		 *
		 * @default null
		 *
		 * @see #right
		 */
		public function get rightAnchorDisplayObject():DisplayObject
		{
			return this._rightAnchorDisplayObject;
		}

		/**
		 * @private
		 */
		public function set rightAnchorDisplayObject(value:DisplayObject):void
		{
			if(this._rightAnchorDisplayObject == value)
			{
				return;
			}
			this._rightAnchorDisplayObject = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _right:Number = NaN;

		/**
		 * The position, in pixels, of the right edge relative to the right
		 * anchor, or, if there is no right anchor, then the position is relative
		 * to the right edge of the parent container. If this value is
		 * <code>NaN</code>, the object's right edge will not be anchored.
		 *
		 * @default NaN
		 *
		 * @see #rightAnchorDisplayObject
		 */
		public function get right():Number
		{
			return this._right;
		}

		/**
		 * @private
		 */
		public function set right(value:Number):void
		{
			if(this._right == value)
			{
				return;
			}
			this._right = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _bottomAnchorDisplayObject:DisplayObject;

		/**
		 * The bottom edge of the layout object will be relative to this anchor.
		 * If there is no anchor, the bottom edge of the parent container will be
		 * the anchor.
		 *
		 * @default null
		 *
		 * @see #bottom
		 */
		public function get bottomAnchorDisplayObject():DisplayObject
		{
			return this._bottomAnchorDisplayObject;
		}

		/**
		 * @private
		 */
		public function set bottomAnchorDisplayObject(value:DisplayObject):void
		{
			if(this._bottomAnchorDisplayObject == value)
			{
				return;
			}
			this._bottomAnchorDisplayObject = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _bottom:Number = NaN;

		/**
		 * The position, in pixels, of the bottom edge relative to the bottom
		 * anchor, or, if there is no bottom anchor, then the position is relative
		 * to the bottom edge of the parent container. If this value is
		 * <code>NaN</code>, the object's bottom edge will not be anchored.
		 *
		 * @default NaN
		 *
		 * @see #bottomAnchorDisplayObject
		 */
		public function get bottom():Number
		{
			return this._bottom;
		}

		/**
		 * @private
		 */
		public function set bottom(value:Number):void
		{
			if(this._bottom == value)
			{
				return;
			}
			this._bottom = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _leftAnchorDisplayObject:DisplayObject;

		/**
		 * The left edge of the layout object will be relative to this anchor.
		 * If there is no anchor, the left edge of the parent container will be
		 * the anchor.
		 *
		 * @default null
		 *
		 * @see #left
		 */
		public function get leftAnchorDisplayObject():DisplayObject
		{
			return this._leftAnchorDisplayObject;
		}

		/**
		 * @private
		 */
		public function set leftAnchorDisplayObject(value:DisplayObject):void
		{
			if(this._leftAnchorDisplayObject == value)
			{
				return;
			}
			this._leftAnchorDisplayObject = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _left:Number = NaN;

		/**
		 * The position, in pixels, of the left edge relative to the left
		 * anchor, or, if there is no left anchor, then the position is relative
		 * to the left edge of the parent container. If this value is
		 * <code>NaN</code>, the object's left edge will not be anchored.
		 *
		 * @default NaN
		 *
		 * @see #leftAnchorDisplayObject
		 */
		public function get left():Number
		{
			return this._left;
		}

		/**
		 * @private
		 */
		public function set left(value:Number):void
		{
			if(this._left == value)
			{
				return;
			}
			this._left = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _horizontalCenterAnchorDisplayObject:DisplayObject;

		/**
		 * The horizontal center of the layout object will be relative to this
		 * anchor. If there is no anchor, the horizontal center of the parent
		 * container will be the anchor.
		 *
		 * @default null
		 *
		 * @see #horizontalCenter
		 */
		public function get horizontalCenterAnchorDisplayObject():DisplayObject
		{
			return this._horizontalCenterAnchorDisplayObject;
		}

		/**
		 * @private
		 */
		public function set horizontalCenterAnchorDisplayObject(value:DisplayObject):void
		{
			if(this._horizontalCenterAnchorDisplayObject == value)
			{
				return;
			}
			this._horizontalCenterAnchorDisplayObject = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _horizontalCenter:Number = NaN;

		/**
		 * The position, in pixels, of the horizontal center relative to the
		 * horizontal center anchor, or, if there is no horizontal center
		 * anchor, then the position is relative to the horizontal center of the
		 * parent container. If this value is <code>NaN</code>, the object's
		 * horizontal center will not be anchored.
		 *
		 * @default NaN
		 *
		 * @see #horizontalCenterAnchorDisplayObject
		 */
		public function get horizontalCenter():Number
		{
			return this._horizontalCenter;
		}

		/**
		 * @private
		 */
		public function set horizontalCenter(value:Number):void
		{
			if(this._horizontalCenter == value)
			{
				return;
			}
			this._horizontalCenter = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _verticalCenterAnchorDisplayObject:DisplayObject;

		/**
		 * The vertical center of the layout object will be relative to this
		 * anchor. If there is no anchor, the vertical center of the parent
		 * container will be the anchor.
		 *
		 * @default null
		 *
		 * @see #verticalCenter
		 */
		public function get verticalCenterAnchorDisplayObject():DisplayObject
		{
			return this._verticalCenterAnchorDisplayObject;
		}

		/**
		 * @private
		 */
		public function set verticalCenterAnchorDisplayObject(value:DisplayObject):void
		{
			if(this._verticalCenterAnchorDisplayObject == value)
			{
				return;
			}
			this._verticalCenterAnchorDisplayObject = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _verticalCenter:Number = NaN;

		/**
		 * The position, in pixels, of the vertical center relative to the
		 * vertical center anchor, or, if there is no vertical center anchor,
		 * then the position is relative to the vertical center of the parent
		 * container. If this value is <code>NaN</code>, the object's vertical
		 * center will not be anchored.
		 *
		 * @default NaN
		 *
		 * @see #verticalCenterAnchorDisplayObject
		 */
		public function get verticalCenter():Number
		{
			return this._verticalCenter;
		}

		/**
		 * @private
		 */
		public function set verticalCenter(value:Number):void
		{
			if(this._verticalCenter == value)
			{
				return;
			}
			this._verticalCenter = value;
			this.dispatchEventWith(Event.CHANGE);
		}
	}
}


================================================
FILE: source/feathers/layout/BaseLinearLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import starling.display.DisplayObject;
	import starling.errors.AbstractClassError;
	import starling.events.Event;

	/**
	 * Abstract base class for <code>HorizontalLayout</code> and <code>VerticalLayout</code>.
	 *
	 * @productversion Feathers 3.3.0
	 *
	 * @see feathers.layout.HorizontalLayout
	 * @see feathers.layout.VerticalLayout
	 */
	public class BaseLinearLayout extends BaseVariableVirtualLayout
	{
		/**
		 * Constructor.
		 */
		public function BaseLinearLayout()
		{
			super();
			if(Object(this).constructor == BaseLinearLayout)
			{
				throw new AbstractClassError();
			}
		}

		/**
		 * @private
		 */
		protected var _discoveredItemsCache:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * @private
		 */
		protected var _gap:Number = 0;

		/**
		 * The space, in pixels, between items.
		 *
		 * @default 0
		 */
		public function get gap():Number
		{
			return this._gap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			if(this._gap == value)
			{
				return;
			}
			this._gap = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _firstGap:Number = NaN;

		/**
		 * The space, in pixels, between the first and second items. If the
		 * value of <code>firstGap</code> is <code>NaN</code>, the value of the
		 * <code>gap</code> property will be used instead.
		 *
		 * @default NaN
		 */
		public function get firstGap():Number
		{
			return this._firstGap;
		}

		/**
		 * @private
		 */
		public function set firstGap(value:Number):void
		{
			if(this._firstGap == value)
			{
				return;
			}
			this._firstGap = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _lastGap:Number = NaN;

		/**
		 * The space, in pixels, between the last and second to last items. If
		 * the value of <code>lastGap</code> is <code>NaN</code>, the value of
		 * the <code>gap</code> property will be used instead.
		 *
		 * @default NaN
		 */
		public function get lastGap():Number
		{
			return this._lastGap;
		}

		/**
		 * @private
		 */
		public function set lastGap(value:Number):void
		{
			if(this._lastGap == value)
			{
				return;
			}
			this._lastGap = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * Quickly sets all padding properties to the same value. The
		 * <code>padding</code> getter always returns the value of
		 * <code>paddingTop</code>, but the other padding values may be
		 * different.
		 *
		 * @default 0
		 *
		 * @see #paddingTop
		 * @see #paddingRight
		 * @see #paddingBottom
		 * @see #paddingLeft
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * The space, in pixels, that appears on top.
		 *
		 * @default 0
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * The minimum space, in pixels, to the right of the items.
		 *
		 * @default 0
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * The space, in pixels, that appears on the bottom.
		 *
		 * @default 0
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * The minimum space, in pixels, to the left of the items.
		 *
		 * @default 0
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.TOP;

		/**
		 * The alignment of the items vertically, on the x-axis.
		 *
		 * <p><strong>Note:</strong> The <code>VerticalAlign.JUSTIFY</code>
		 * constant is not supported by <code>VerticalLayout</code>. It may be
		 * used with <code>HorizontalLayout</code> only.</p>
		 *
		 * @default feathers.layout.VerticalAlign.TOP
		 *
		 * @see feathers.layout.VerticalAlign#TOP
		 * @see feathers.layout.VerticalAlign#MIDDLE
		 * @see feathers.layout.VerticalAlign#BOTTOM
		 * @see feathers.layout.VerticalAlign#JUSTIFY
		 */
		public function get verticalAlign():String
		{
			return this._verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this._verticalAlign == value)
			{
				return;
			}
			this._verticalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.LEFT;

		/**
		 * The alignment of the items horizontally, on the x-axis.
		 *
		 * <p><strong>Note:</strong> The <code>HorizontalAlign.JUSTIFY</code>
		 * constant is not supported by <code>HorizontalLayout</code>. It may be
		 * used with <code>VerticalLayout</code> only.</p>
		 *
		 * @default feathers.layout.HorizontalAlign.LEFT
		 *
		 * @see feathers.layout.HorizontalAlign#LEFT
		 * @see feathers.layout.HorizontalAlign#CENTER
		 * @see feathers.layout.HorizontalAlign#RIGHT
		 * @see feathers.layout.HorizontalAlign#JUSTIFY
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this._horizontalAlign == value)
			{
				return;
			}
			this._horizontalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _beforeVirtualizedItemCount:int = 0;

		/**
		 * @copy feathers.layout.ITrimmedLayout#beforeVirtualizedItemCount
		 */
		public function get beforeVirtualizedItemCount():int
		{
			return this._beforeVirtualizedItemCount;
		}

		/**
		 * @private
		 */
		public function set beforeVirtualizedItemCount(value:int):void
		{
			if(this._beforeVirtualizedItemCount == value)
			{
				return;
			}
			this._beforeVirtualizedItemCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _afterVirtualizedItemCount:int = 0;

		/**
		 * @copy feathers.layout.ITrimmedLayout#afterVirtualizedItemCount
		 */
		public function get afterVirtualizedItemCount():int
		{
			return this._afterVirtualizedItemCount;
		}

		/**
		 * @private
		 */
		public function set afterVirtualizedItemCount(value:int):void
		{
			if(this._afterVirtualizedItemCount == value)
			{
				return;
			}
			this._afterVirtualizedItemCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _resetTypicalItemDimensionsOnMeasure:Boolean = false;

		/**
		 * If set to <code>true</code>, the width and height of the
		 * <code>typicalItem</code> will be reset to <code>typicalItemWidth</code>
		 * and <code>typicalItemHeight</code>, respectively, whenever the
		 * typical item needs to be measured. The measured dimensions of the
		 * typical item are used to fill in the blanks of a virtualized layout
		 * for virtual items that don't have their own display objects to
		 * measure yet.
		 *
		 * @default false
		 *
		 * @see #typicalItemWidth
		 * @see #typicalItemHeight
		 * @see #typicalItem
		 */
		public function get resetTypicalItemDimensionsOnMeasure():Boolean
		{
			return this._resetTypicalItemDimensionsOnMeasure;
		}

		/**
		 * @private
		 */
		public function set resetTypicalItemDimensionsOnMeasure(value:Boolean):void
		{
			if(this._resetTypicalItemDimensionsOnMeasure == value)
			{
				return;
			}
			this._resetTypicalItemDimensionsOnMeasure = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _typicalItemWidth:Number = NaN;

		/**
		 * Used to reset the width, in pixels, of the <code>typicalItem</code>
		 * for measurement. The measured dimensions of the typical item are used
		 * to fill in the blanks of a virtualized layout for virtual items that
		 * don't have their own display objects to measure yet.
		 *
		 * <p>This value is only used when <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>true</code>. If <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>false</code>, this value will be ignored and the
		 * <code>typicalItem</code> dimensions will not be reset before
		 * measurement.</p>
		 *
		 * <p>If <code>typicalItemWidth</code> is set to <code>NaN</code>, the
		 * typical item will auto-size itself to its preferred width. If you
		 * pass a valid <code>Number</code> value, the typical item's width will
		 * be set to a fixed size. May be used in combination with
		 * <code>typicalItemHeight</code>.</p>
		 *
		 * @default NaN
		 *
		 * @see #resetTypicalItemDimensionsOnMeasure
		 * @see #typicalItemHeight
		 * @see #typicalItem
		 */
		public function get typicalItemWidth():Number
		{
			return this._typicalItemWidth;
		}

		/**
		 * @private
		 */
		public function set typicalItemWidth(value:Number):void
		{
			if(this._typicalItemWidth == value)
			{
				return;
			}
			this._typicalItemWidth = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _typicalItemHeight:Number = NaN;

		/**
		 * Used to reset the height, in pixels, of the <code>typicalItem</code>
		 * for measurement. The measured dimensions of the typical item are used
		 * to fill in the blanks of a virtualized layout for virtual items that
		 * don't have their own display objects to measure yet.
		 *
		 * <p>This value is only used when <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>true</code>. If <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>false</code>, this value will be ignored and the
		 * <code>typicalItem</code> dimensions will not be reset before
		 * measurement.</p>
		 *
		 * <p>If <code>typicalItemHeight</code> is set to <code>NaN</code>, the
		 * typical item will auto-size itself to its preferred height. If you
		 * pass a valid <code>Number</code> value, the typical item's height will
		 * be set to a fixed size. May be used in combination with
		 * <code>typicalItemWidth</code>.</p>
		 *
		 * @default NaN
		 *
		 * @see #resetTypicalItemDimensionsOnMeasure
		 * @see #typicalItemWidth
		 * @see #typicalItem
		 */
		public function get typicalItemHeight():Number
		{
			return this._typicalItemHeight;
		}

		/**
		 * @private
		 */
		public function set typicalItemHeight(value:Number):void
		{
			if(this._typicalItemHeight == value)
			{
				return;
			}
			this._typicalItemHeight = value;
			this.dispatchEventWith(Event.CHANGE);
		}
	}
}


================================================
FILE: source/feathers/layout/BaseTiledLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import feathers.layout.Direction;

	import starling.display.DisplayObject;
	import starling.errors.AbstractClassError;
	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when a property of the layout changes, indicating that a
	 * redraw is probably needed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Abstract base class for <code>TiledRowsLayout</code> and <code>TiledColumnsLayout</code>.
	 *
	 * @productversion Feathers 3.3.0
	 *
	 * @see feathers.layout.TiledRowsLayout
	 * @see feathers.layout.TiledColumnsLayout
	 */
	public class BaseTiledLayout extends EventDispatcher
	{
		/**
		 * Constructor.
		 */
		public function BaseTiledLayout()
		{
			super();
			if(Object(this).constructor == BaseTiledLayout)
			{
				throw new AbstractClassError();
			}
		}

		/**
		 * @private
		 */
		protected var _discoveredItemsCache:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * Quickly sets both <code>horizontalGap</code> and <code>verticalGap</code>
		 * to the same value. The <code>gap</code> getter always returns the
		 * value of <code>horizontalGap</code>, but the value of
		 * <code>verticalGap</code> may be different.
		 *
		 * @default 0
		 *
		 * @see #horizontalGap
		 * @see #verticalGap
		 */
		public function get gap():Number
		{
			return this._horizontalGap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			this.horizontalGap = value;
			this.verticalGap = value;
		}

		/**
		 * @private
		 */
		protected var _horizontalGap:Number = 0;

		/**
		 * The horizontal space, in pixels, between tiles.
		 *
		 * @default 0
		 */
		public function get horizontalGap():Number
		{
			return this._horizontalGap;
		}

		/**
		 * @private
		 */
		public function set horizontalGap(value:Number):void
		{
			if(this._horizontalGap == value)
			{
				return;
			}
			this._horizontalGap = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _verticalGap:Number = 0;

		/**
		 * The vertical space, in pixels, between tiles.
		 *
		 * @default 0
		 */
		public function get verticalGap():Number
		{
			return this._verticalGap;
		}

		/**
		 * @private
		 */
		public function set verticalGap(value:Number):void
		{
			if(this._verticalGap == value)
			{
				return;
			}
			this._verticalGap = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * Quickly sets all padding properties to the same value. The
		 * <code>padding</code> getter always returns the value of
		 * <code>paddingTop</code>, but the other padding values may be
		 * different.
		 *
		 * @default 0
		 *
		 * @see #paddingTop
		 * @see #paddingRight
		 * @see #paddingBottom
		 * @see #paddingLeft
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * The space, in pixels, above of items.
		 *
		 * @default 0
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * The space, in pixels, to the right of the items.
		 *
		 * @default 0
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * The space, in pixels, below the items.
		 *
		 * @default 0
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * The space, in pixels, to the left of the items.
		 *
		 * @default 0
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _requestedColumnCount:int = 0;

		/**
		 * Requests that the layout uses a specific number of columns in a row,
		 * if possible. Set to <code>0</code> to calculate the maximum of
		 * columns that will fit in the available space.
		 *
		 * <p>If the view port's explicit or maximum width is not large enough
		 * to fit the requested number of columns, it will use fewer. If the
		 * view port doesn't have an explicit width and the maximum width is
		 * equal to <code>Number.POSITIVE_INFINITY</code>, the width will be
		 * calculated automatically to fit the exact number of requested
		 * columns.</p>
		 *
		 * <p>If paging is enabled, this value will be used to calculate the
		 * number of columns in a page. If paging isn't enabled, this value will
		 * be used to calculate a minimum number of columns, even if there
		 * aren't enough items to fill each column.</p>
		 *
		 * @default 0
		 */
		public function get requestedColumnCount():int
		{
			return this._requestedColumnCount;
		}

		/**
		 * @private
		 */
		public function set requestedColumnCount(value:int):void
		{
			if(value < 0)
			{
				throw RangeError("requestedColumnCount requires a value >= 0");
			}
			if(this._requestedColumnCount == value)
			{
				return;
			}
			this._requestedColumnCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _requestedRowCount:int = 0;

		/**
		 * Requests that the layout uses a specific number of rows, if possible.
		 * If the view port's explicit or maximum height is not large enough to
		 * fit the requested number of rows, it will use fewer. Set to <code>0</code>
		 * to calculate the number of rows automatically based on width and
		 * height.
		 *
		 * <p>If paging is enabled, this value will be used to calculate the
		 * number of rows in a page. If paging isn't enabled, this value will
		 * be used to calculate a minimum number of rows, even if there aren't
		 * enough items to fill each row.</p>
		 *
		 * @default 0
		 */
		public function get requestedRowCount():int
		{
			return this._requestedRowCount;
		}

		/**
		 * @private
		 */
		public function set requestedRowCount(value:int):void
		{
			if(value < 0)
			{
				throw RangeError("requestedRowCount requires a value >= 0");
			}
			if(this._requestedRowCount == value)
			{
				return;
			}
			this._requestedRowCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.TOP;

		[Inspectable(type="String",enumeration="top,middle,bottom")]
		/**
		 * If the total column height is less than the bounds, the items in the
		 * column can be aligned vertically.
		 *
		 * <p><strong>Note:</strong> VerticalAlign.JUSTIFY is not supported.
		 * The <code>distributeHeights</code> property may be used to fill the
		 * available space when the content is not large enough.</p>
		 *
		 * @default feathers.layout.VerticalAlign.TOP
		 *
		 * @see feathers.layout.VerticalAlign#TOP
		 * @see feathers.layout.VerticalAlign#MIDDLE
		 * @see feathers.layout.VerticalAlign#BOTTOM
		 * @see #distributeHeights
		 */
		public function get verticalAlign():String
		{
			return this._verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this._verticalAlign == value)
			{
				return;
			}
			this._verticalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.CENTER;

		[Inspectable(type="String",enumeration="left,center,right")]
		/**
		 * If the total row width is less than the bounds, the items in the row
		 * can be aligned horizontally.
		 *
		 * <p><strong>Note:</strong> HorizontalAlign.JUSTIFY is not supported.
		 * The <code>distributeWidths</code> property may be used to fill the
		 * available space when the content is not large enough.</p>
		 *
		 * @default feathers.layout.HorizontalAlign.CENTER
		 *
		 * @see feathers.layout.HorizontalAlign#LEFT
		 * @see feathers.layout.HorizontalAlign#CENTER
		 * @see feathers.layout.HorizontalAlign#RIGHT
		 * @see #distributeWidths
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this._horizontalAlign == value)
			{
				return;
			}
			this._horizontalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _tileVerticalAlign:String = VerticalAlign.MIDDLE;

		[Inspectable(type="String",enumeration="top,middle,bottom,justify")]
		/**
		 * If an item's height is less than the tile bounds, the position of the
		 * item can be aligned vertically.
		 *
		 * @default feathers.layout.VerticalAlign.MIDDLE
		 *
		 * @see feathers.layout.VerticalAlign#TOP
		 * @see feathers.layout.VerticalAlign#MIDDLE
		 * @see feathers.layout.VerticalAlign#BOTTOM
		 * @see feathers.layout.VerticalAlign#JUSTIFY
		 */
		public function get tileVerticalAlign():String
		{
			return this._tileVerticalAlign;
		}

		/**
		 * @private
		 */
		public function set tileVerticalAlign(value:String):void
		{
			if(this._tileVerticalAlign == value)
			{
				return;
			}
			this._tileVerticalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _tileHorizontalAlign:String = HorizontalAlign.CENTER;

		[Inspectable(type="String",enumeration="left,center,right,justify")]
		/**
		 * If the item's width is less than the tile bounds, the position of the
		 * item can be aligned horizontally.
		 *
		 * @default feathers.layout.HorizontalAlign.CENTER
		 *
		 * @see feathers.layout.HorizontalAlign#LEFT
		 * @see feathers.layout.HorizontalAlign#CENTER
		 * @see feathers.layout.HorizontalAlign#RIGHT
		 * @see feathers.layout.HorizontalAlign#JUSTIFY
		 */
		public function get tileHorizontalAlign():String
		{
			return this._tileHorizontalAlign;
		}

		/**
		 * @private
		 */
		public function set tileHorizontalAlign(value:String):void
		{
			if(this._tileHorizontalAlign == value)
			{
				return;
			}
			this._tileHorizontalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paging:String = Direction.NONE;

		/**
		 * Indicates if tiles are divided into pages vertically or
		 * horizontally, or if paging is disabled.
		 *
		 * @default feathers.layout.Direction.NONE
		 *
		 * @see feathers.layout.Direction#NONE
		 * @see feathers.layout.Direction#HORIZONTAL
		 * @see feathers.layout.Direction#VERTICAL
		 */
		public function get paging():String
		{
			return this._paging;
		}

		/**
		 * @private
		 */
		public function set paging(value:String):void
		{
			if(this._paging == value)
			{
				return;
			}
			this._paging = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _distributeWidths:Boolean = false;

		/**
		 * If the total width of the tiles in a row (minus padding and gap)
		 * does not fill the entire row, the remaining space will be distributed
		 * to each tile equally.
		 *
		 * <p>If the container using the layout might resize, setting
		 * <code>requestedColumnCount</code> is recommended because the tiles
		 * will resize too, and their dimensions may not be reset.</p>
		 *
		 * @default false
		 *
		 * @see #requestedColumnCount
		 */
		public function get distributeWidths():Boolean
		{
			return this._distributeWidths;
		}

		/**
		 * @private
		 */
		public function set distributeWidths(value:Boolean):void
		{
			if(this._distributeWidths === value)
			{
				return;
			}
			this._distributeWidths = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _distributeHeights:Boolean = false;

		/**
		 * If the total height of the tiles in a column (minus padding and gap)
		 * does not fill the entire column, the remaining space will be
		 * distributed to each tile equally.
		 *
		 * <p>If the container using the layout might resize, setting
		 * <code>requestedRowCount</code> is recommended because the tiles
		 * will resize too, and their dimensions may not be reset.</p>
		 *
		 * @default false
		 *
		 * @see #requestedRowCount
		 * @see #useSquareTiles
		 */
		public function get distributeHeights():Boolean
		{
			return this._distributeHeights;
		}

		/**
		 * @private
		 */
		public function set distributeHeights(value:Boolean):void
		{
			if(this._distributeHeights === value)
			{
				return;
			}
			this._distributeHeights = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _useSquareTiles:Boolean = true;

		/**
		 * Determines if the tiles must be square or if their width and height
		 * may have different values.
		 *
		 * @default true
		 */
		public function get useSquareTiles():Boolean
		{
			return this._useSquareTiles;
		}

		/**
		 * @private
		 */
		public function set useSquareTiles(value:Boolean):void
		{
			if(this._useSquareTiles == value)
			{
				return;
			}
			this._useSquareTiles = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _useVirtualLayout:Boolean = true;

		/**
		 * @copy feathers.layout.IVirtualLayout#useVirtualLayout
		 *
		 * @default true
		 */
		public function get useVirtualLayout():Boolean
		{
			return this._useVirtualLayout;
		}

		/**
		 * @private
		 */
		public function set useVirtualLayout(value:Boolean):void
		{
			if(this._useVirtualLayout == value)
			{
				return;
			}
			this._useVirtualLayout = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _typicalItem:DisplayObject;

		/**
		 * @copy feathers.layout.IVirtualLayout#typicalItem
		 */
		public function get typicalItem():DisplayObject
		{
			return this._typicalItem;
		}

		/**
		 * @private
		 */
		public function set typicalItem(value:DisplayObject):void
		{
			if(this._typicalItem == value)
			{
				return;
			}
			this._typicalItem = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _resetTypicalItemDimensionsOnMeasure:Boolean = false;

		/**
		 * If set to <code>true</code>, the width and height of the
		 * <code>typicalItem</code> will be reset to <code>typicalItemWidth</code>
		 * and <code>typicalItemHeight</code>, respectively, whenever the
		 * typical item needs to be measured. The measured dimensions of the
		 * typical item are used to fill in the blanks of a virtualized layout
		 * for virtual items that don't have their own display objects to
		 * measure yet.
		 *
		 * @default false
		 *
		 * @see #typicalItemWidth
		 * @see #typicalItemHeight
		 * @see #typicalItem
		 */
		public function get resetTypicalItemDimensionsOnMeasure():Boolean
		{
			return this._resetTypicalItemDimensionsOnMeasure;
		}

		/**
		 * @private
		 */
		public function set resetTypicalItemDimensionsOnMeasure(value:Boolean):void
		{
			if(this._resetTypicalItemDimensionsOnMeasure == value)
			{
				return;
			}
			this._resetTypicalItemDimensionsOnMeasure = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _typicalItemWidth:Number = NaN;

		/**
		 * Used to reset the width, in pixels, of the <code>typicalItem</code>
		 * for measurement. The measured dimensions of the typical item are used
		 * to fill in the blanks of a virtualized layout for virtual items that
		 * don't have their own display objects to measure yet.
		 *
		 * <p>This value is only used when <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>true</code>. If <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>false</code>, this value will be ignored and the
		 * <code>typicalItem</code> dimensions will not be reset before
		 * measurement.</p>
		 *
		 * <p>If <code>typicalItemWidth</code> is set to <code>NaN</code>, the
		 * typical item will auto-size itself to its preferred width. If you
		 * pass a valid <code>Number</code> value, the typical item's width will
		 * be set to a fixed size. May be used in combination with
		 * <code>typicalItemHeight</code>.</p>
		 *
		 * @default NaN
		 *
		 * @see #resetTypicalItemDimensionsOnMeasure
		 * @see #typicalItemHeight
		 * @see #typicalItem
		 */
		public function get typicalItemWidth():Number
		{
			return this._typicalItemWidth;
		}

		/**
		 * @private
		 */
		public function set typicalItemWidth(value:Number):void
		{
			if(this._typicalItemWidth == value)
			{
				return;
			}
			this._typicalItemWidth = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _typicalItemHeight:Number = NaN;

		/**
		 * Used to reset the height, in pixels, of the <code>typicalItem</code>
		 * for measurement. The measured dimensions of the typical item are used
		 * to fill in the blanks of a virtualized layout for virtual items that
		 * don't have their own display objects to measure yet.
		 *
		 * <p>This value is only used when <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>true</code>. If <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>false</code>, this value will be ignored and the
		 * <code>typicalItem</code> dimensions will not be reset before
		 * measurement.</p>
		 *
		 * <p>If <code>typicalItemHeight</code> is set to <code>NaN</code>, the
		 * typical item will auto-size itself to its preferred height. If you
		 * pass a valid <code>Number</code> value, the typical item's height will
		 * be set to a fixed size. May be used in combination with
		 * <code>typicalItemWidth</code>.</p>
		 *
		 * @default NaN
		 *
		 * @see #resetTypicalItemDimensionsOnMeasure
		 * @see #typicalItemWidth
		 * @see #typicalItem
		 */
		public function get typicalItemHeight():Number
		{
			return this._typicalItemHeight;
		}

		/**
		 * @private
		 */
		public function set typicalItemHeight(value:Number):void
		{
			if(this._typicalItemHeight == value)
			{
				return;
			}
			this._typicalItemHeight = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.layout.ILayout#requiresLayoutOnScroll
		 */
		public function get requiresLayoutOnScroll():Boolean
		{
			return this._useVirtualLayout;
		}
	}
}

================================================
FILE: source/feathers/layout/BaseVariableVirtualLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import starling.display.DisplayObject;
	import starling.errors.AbstractClassError;
	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when a property of the layout changes, indicating that a
	 * redraw is probably needed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Dispatched when the layout would like to adjust the container's scroll
	 * position. Typically, this is used when the virtual dimensions of an item
	 * differ from its real dimensions. This event allows the container to
	 * adjust scrolling so that it appears smooth, without jarring jumps or
	 * shifts when an item resizes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>A <code>flash.geom.Point</code> object
	 *   representing how much the scroll position should be adjusted in both
	 *   horizontal and vertical directions. Measured in pixels.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.SCROLL
	 */
	[Event(name="scroll",type="starling.events.Event")]

	public class BaseVariableVirtualLayout extends EventDispatcher
	{
		/**
		 * Constructor.
		 */
		public function BaseVariableVirtualLayout()
		{
			super();
			if(Object(this).constructor === BaseLinearLayout)
			{
				throw new AbstractClassError();
			}
		}

		/**
		 * @private
		 */
		protected var _virtualCache:Array = [];

		/**
		 * @private
		 */
		protected var _useVirtualLayout:Boolean = true;

		/**
		 * @copy feathers.layout.IVirtualLayout#useVirtualLayout
		 *
		 * @default true
		 */
		public function get useVirtualLayout():Boolean
		{
			return this._useVirtualLayout;
		}

		/**
		 * @private
		 */
		public function set useVirtualLayout(value:Boolean):void
		{
			if(this._useVirtualLayout == value)
			{
				return;
			}
			this._useVirtualLayout = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _typicalItem:DisplayObject;

		/**
		 * @copy feathers.layout.IVirtualLayout#typicalItem
		 *
		 * @see #resetTypicalItemDimensionsOnMeasure
		 * @see #typicalItemWidth
		 * @see #typicalItemHeight
		 */
		public function get typicalItem():DisplayObject
		{
			return this._typicalItem;
		}

		/**
		 * @private
		 */
		public function set typicalItem(value:DisplayObject):void
		{
			if(this._typicalItem == value)
			{
				return;
			}
			this._typicalItem = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _hasVariableItemDimensions:Boolean = false;

		/**
		 * When the layout is virtualized, and this value is true, the items
		 * may have variable dimensions. If false, the items will all share
		 * the same dimensions with the typical item.
		 *
		 * @default false
		 */
		public function get hasVariableItemDimensions():Boolean
		{
			return this._hasVariableItemDimensions;
		}

		/**
		 * @private
		 */
		public function set hasVariableItemDimensions(value:Boolean):void
		{
			if(this._hasVariableItemDimensions == value)
			{
				return;
			}
			this._hasVariableItemDimensions = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.layout.ILayout#requiresLayoutOnScroll
		 */
		public function get requiresLayoutOnScroll():Boolean
		{
			return this._useVirtualLayout;
		}

		/**
		 * @copy feathers.layout.IVariableVirtualLayout#resetVariableVirtualCache()
		 */
		public function resetVariableVirtualCache():void
		{
			this._virtualCache.length = 0;
		}

		/**
		 * @copy feathers.layout.IVariableVirtualLayout#resetVariableVirtualCacheAtIndex()
		 */
		public function resetVariableVirtualCacheAtIndex(index:int, item:DisplayObject = null):void
		{
			delete this._virtualCache[index];
			if(item)
			{
				this._virtualCache[index] = item.height;
				this.dispatchEventWith(Event.CHANGE);
			}
		}

		/**
		 * @copy feathers.layout.IVariableVirtualLayout#addToVariableVirtualCacheAtIndex()
		 */
		public function addToVariableVirtualCacheAtIndex(index:int, item:DisplayObject = null):void
		{
			var heightValue:* = item ? item.height : undefined;
			this._virtualCache.insertAt(index, heightValue);
		}

		/**
		 * @copy feathers.layout.IVariableVirtualLayout#removeFromVariableVirtualCacheAtIndex()
		 */
		public function removeFromVariableVirtualCacheAtIndex(index:int):void
		{
			this._virtualCache.removeAt(index);
		}
	}
}

================================================
FILE: source/feathers/layout/Direction.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	/**
	 * Constants that define a direction.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class Direction
	{
		/**
		 * The object will be oriented vertically.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const VERTICAL:String = "vertical";

		/**
		 * The object will be oriented horizontally.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const HORIZONTAL:String = "horizontal";

		/**
		 * The object will be oriented in no particular direction.
		 *
		 * @productversion Feathers 3.3.0
		 */
		public static const NONE:String = "none";
	}
}


================================================
FILE: source/feathers/layout/FlowLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import feathers.core.IValidating;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;
	import flash.ui.Keyboard;

	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * Dispatched when a property of the layout changes, indicating that a
	 * redraw is probably needed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Positions items of different dimensions from left to right in multiple
	 * rows. When the width of a row reaches the width of the container, a new
	 * row will be started. Constrained to the suggested width, the flow layout
	 * will change in height as the number of items increases or decreases.
	 *
	 * @see ../../../help/flow-layout.html How to use FlowLayout with Feathers containers
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class FlowLayout extends BaseVariableVirtualLayout implements IVariableVirtualLayout, IDragDropLayout
	{
		/**
		 * Constructor.
		 */
		public function FlowLayout()
		{
			super();
			this._hasVariableItemDimensions = true;
		}

		/**
		 * @private
		 */
		protected var _rowItems:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * Quickly sets both <code>horizontalGap</code> and <code>verticalGap</code>
		 * to the same value. The <code>gap</code> getter always returns the
		 * value of <code>horizontalGap</code>, but the value of
		 * <code>verticalGap</code> may be different.
		 *
		 * @default 0
		 *
		 * @see #horizontalGap
		 * @see #verticalGap
		 */
		public function get gap():Number
		{
			return this._horizontalGap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			this.horizontalGap = value;
			this.verticalGap = value;
		}

		/**
		 * @private
		 */
		protected var _horizontalGap:Number = 0;

		/**
		 * The horizontal space, in pixels, between items.
		 *
		 * @default 0
		 */
		public function get horizontalGap():Number
		{
			return this._horizontalGap;
		}

		/**
		 * @private
		 */
		public function set horizontalGap(value:Number):void
		{
			if(this._horizontalGap == value)
			{
				return;
			}
			this._horizontalGap = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _verticalGap:Number = 0;

		/**
		 * The vertical space, in pixels, between items.
		 *
		 * @default 0
		 */
		public function get verticalGap():Number
		{
			return this._verticalGap;
		}

		/**
		 * @private
		 */
		public function set verticalGap(value:Number):void
		{
			if(this._verticalGap == value)
			{
				return;
			}
			this._verticalGap = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _firstHorizontalGap:Number = NaN;

		/**
		 * The space, in pixels, between the first and second items. If the
		 * value of <code>firstHorizontalGap</code> is <code>NaN</code>, the
		 * value of the <code>horizontalGap</code> property will be used
		 * instead.
		 *
		 * @default NaN
		 *
		 * @see #gap
		 */
		public function get firstHorizontalGap():Number
		{
			return this._firstHorizontalGap;
		}

		/**
		 * @private
		 */
		public function set firstHorizontalGap(value:Number):void
		{
			if(this._firstHorizontalGap == value)
			{
				return;
			}
			this._firstHorizontalGap = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _lastHorizontalGap:Number = NaN;

		/**
		 * The space, in pixels, between the last and second to last items. If
		 * the value of <code>lastHorizontalGap</code> is <code>NaN</code>, the
		 * value of the <code>horizontalGap</code> property will be used instead.
		 *
		 * @default NaN
		 *
		 * @see #gap
		 */
		public function get lastHorizontalGap():Number
		{
			return this._lastHorizontalGap;
		}

		/**
		 * @private
		 */
		public function set lastHorizontalGap(value:Number):void
		{
			if(this._lastHorizontalGap == value)
			{
				return;
			}
			this._lastHorizontalGap = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * Quickly sets all padding properties to the same value. The
		 * <code>padding</code> getter always returns the value of
		 * <code>paddingTop</code>, but the other padding values may be
		 * different.
		 *
		 * @default 0
		 *
		 * @see #paddingTop
		 * @see #paddingRight
		 * @see #paddingBottom
		 * @see #paddingLeft
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * The space, in pixels, above of items.
		 *
		 * @default 0
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * The space, in pixels, to the right of the items.
		 *
		 * @default 0
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * The space, in pixels, below the items.
		 *
		 * @default 0
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * The space, in pixels, to the left of the items.
		 *
		 * @default 0
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.LEFT;

		[Inspectable(type="String",enumeration="left,center,right")]
		/**
		 * If the total row width is less than the bounds, the items in the row
		 * can be aligned horizontally.
		 *
		 * <p><strong>Note:</strong> The <code>HorizontalAlign.JUSTIFY</code>
		 * constant is not supported.</p>
		 *
		 * @default feathers.layout.HorizontalAlign.LEFT
		 *
		 * @see feathers.layout.HorizontalAlign#LEFT
		 * @see feathers.layout.HorizontalAlign#CENTER
		 * @see feathers.layout.HorizontalAlign#RIGHT
		 * @see #verticalAlign
		 * @see #rowVerticalAlign
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this._horizontalAlign == value)
			{
				return;
			}
			this._horizontalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.TOP;

		[Inspectable(type="String",enumeration="top,middle,bottom")]
		/**
		 * If the total height of the content is less than the bounds, the
		 * content may be aligned vertically.
		 *
		 * <p><strong>Note:</strong> The <code>VerticalAlign.JUSTIFY</code>
		 * constant is not supported.</p>
		 *
		 * @default feathers.layout.VerticalAlign.TOP
		 *
		 * @see feathers.layout.VerticalAlign#TOP
		 * @see feathers.layout.VerticalAlign#MIDDLE
		 * @see feathers.layout.VerticalAlign#BOTTOM
		 * @see #horizontalAlign
		 * @see #rowVerticalAlign
		 */
		public function get verticalAlign():String
		{
			return this._verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this._verticalAlign == value)
			{
				return;
			}
			this._verticalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _rowVerticalAlign:String = VerticalAlign.TOP;

		[Inspectable(type="String",enumeration="top,middle,bottom")]
		/**
		 * If the height of an item is less than the height of a row, it can be
		 * aligned vertically.
		 *
		 * @default feathers.layout.VerticalAlign.TOP
		 *
		 * @see feathers.layout.VerticalAlign#TOP
		 * @see feathers.layout.VerticalAlign#MIDDLE
		 * @see feathers.layout.VerticalAlign#BOTTOM
		 * @see #horizontalAlign
		 * @see #verticalAlign
		 */
		public function get rowVerticalAlign():String
		{
			return this._rowVerticalAlign;
		}

		/**
		 * @private
		 */
		public function set rowVerticalAlign(value:String):void
		{
			if(this._rowVerticalAlign == value)
			{
				return;
			}
			this._rowVerticalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _widthCache:Array = [];

		/**
		 * @private
		 */
		protected var _heightCache:Array = [];

		/**
		 * @inheritDoc
		 */
		public function layout(items:Vector.<DisplayObject>, viewPortBounds:ViewPortBounds = null, result:LayoutBoundsResult = null):LayoutBoundsResult
		{
			//this function is very long because it may be called every frame,
			//in some situations. testing revealed that splitting this function
			//into separate, smaller functions affected performance.
			//since the SWC compiler cannot inline functions, we can't use that
			//feature either.

			//since viewPortBounds can be null, we may need to provide some defaults
			var boundsX:Number = viewPortBounds ? viewPortBounds.x : 0;
			var boundsY:Number = viewPortBounds ? viewPortBounds.y : 0;
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;
			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;

			var needsWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			//let's figure out if we can show multiple rows
			var supportsMultipleRows:Boolean = true;
			var availableRowWidth:Number = explicitWidth;
			if(needsWidth)
			{
				availableRowWidth = maxWidth;
				if(availableRowWidth == Number.POSITIVE_INFINITY)
				{
					supportsMultipleRows = false;
				}
			}

			if(this._useVirtualLayout)
			{
				//if the layout is virtualized, we'll need the dimensions of the
				//typical item so that we have fallback values when an item is null
				if(this._typicalItem is IValidating)
				{
					IValidating(this._typicalItem).validate();
				}
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var i:int = 0;
			var itemCount:int = items.length;
			var positionY:Number = boundsY + this._paddingTop;
			var maxRowWidth:Number = 0;
			var maxItemHeight:Number = 0;
			var verticalGap:Number = this._verticalGap;
			var hasFirstHorizontalGap:Boolean = this._firstHorizontalGap === this._firstHorizontalGap; //!isNaN
			var hasLastHorizontalGap:Boolean = this._lastHorizontalGap === this._lastHorizontalGap; //!isNaN
			var secondToLastIndex:int = itemCount - 2;
			do
			{
				if(i > 0)
				{
					positionY += maxItemHeight + verticalGap;
				}
				//this section prepares some variables needed for the following loop
				maxItemHeight = this._useVirtualLayout ? calculatedTypicalItemHeight : 0;
				var positionX:Number = boundsX + this._paddingLeft;
				//we save the items in this row to align them later.
				this._rowItems.length = 0;
				var rowItemCount:int = 0;

				//if there are no items in the row (such as when there are no
				//items in the container!), then we don't want to subtract the
				//gap when calculating the row width, so default to 0.
				var horizontalGap:Number = 0;

				//this first loop sets the x position of items, and it calculates
				//the total width of all items
				for(; i < itemCount; i++)
				{
					var item:DisplayObject = items[i];
					horizontalGap = this._horizontalGap;
					if(hasFirstHorizontalGap && i == 0)
					{
						horizontalGap = this._firstHorizontalGap;
					}
					else if(hasLastHorizontalGap && i > 0 && i == secondToLastIndex)
					{
						horizontalGap = this._lastHorizontalGap;
					}

					if(this._useVirtualLayout && this._hasVariableItemDimensions)
					{
						var cachedWidth:Number = this._widthCache[i];
						var cachedHeight:Number = this._heightCache[i];
					}
					if(this._useVirtualLayout && !item)
					{
						//the item is null, and the layout is virtualized, so we
						//need to estimate the width of the item.

						if(this._hasVariableItemDimensions)
						{
							if(cachedWidth !== cachedWidth) //isNaN
							{
								var itemWidth:Number = calculatedTypicalItemWidth;
							}
							else
							{
								itemWidth = cachedWidth;
							}
							if(cachedHeight !== cachedHeight) //isNaN
							{
								var itemHeight:Number = calculatedTypicalItemHeight;
							}
							else
							{
								itemHeight = cachedHeight;
							}
						}
						else
						{
							itemWidth = calculatedTypicalItemWidth;
							itemHeight = calculatedTypicalItemHeight;
						}
					}
					else
					{
						//we get here if the item isn't null. it is never null if
						//the layout isn't virtualized.
						if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
						{
							continue;
						}
						if(item is IValidating)
						{
							IValidating(item).validate();
						}
						itemWidth = item.width;
						itemHeight = item.height;
						if(this._useVirtualLayout)
						{
							if(this._hasVariableItemDimensions)
							{
								if(itemWidth != cachedWidth)
								{
									//update the cache if needed. this will notify
									//the container that the virtualized layout has
									//changed, and it the view port may need to be
									//re-measured.
									this._widthCache[i] = itemWidth;
									this.dispatchEventWith(Event.CHANGE);
								}
								if(itemHeight != cachedHeight)
								{
									this._heightCache[i] = itemHeight;
									this.dispatchEventWith(Event.CHANGE);
								}
							}
							else
							{
								if(calculatedTypicalItemWidth >= 0)
								{
									item.width = itemWidth = calculatedTypicalItemWidth;
								}
								if(calculatedTypicalItemHeight >= 0)
								{
									item.height = itemHeight = calculatedTypicalItemHeight;
								}
							}
						}
					}
					if(supportsMultipleRows && rowItemCount > 0 && (positionX + itemWidth) > (availableRowWidth - this._paddingRight))
					{
						//we need to restore the previous gap because it will be
						//subtracted from the x position to get the row width.
						var previousIndex:int = i - 1;
						horizontalGap = this._horizontalGap;
						if(hasFirstHorizontalGap && previousIndex == 0)
						{
							horizontalGap = this._firstHorizontalGap;
						}
						else if(hasLastHorizontalGap && previousIndex > 0 && previousIndex == secondToLastIndex)
						{
							horizontalGap = this._lastHorizontalGap;
						}
						//we've reached the end of the row, so go to next
						break;
					}
					if(item)
					{
						this._rowItems[this._rowItems.length] = item;
						item.x = item.pivotX + positionX;
					}
					positionX += itemWidth + horizontalGap;
					//we compare with > instead of Math.max() because the rest
					//arguments on Math.max() cause extra garbage collection and
					//hurt performance
					if(itemHeight > maxItemHeight)
					{
						//we need to know the maximum height of the items in the
						//case where the height of the view port needs to be
						//calculated by the layout.
						maxItemHeight = itemHeight;
					}
					rowItemCount++;
				}

				//this is the total width of all items in the row
				var totalRowWidth:Number = positionX - horizontalGap + this._paddingRight - boundsX;
				if(totalRowWidth > maxRowWidth)
				{
					maxRowWidth = totalRowWidth;
				}
				rowItemCount = this._rowItems.length;

				if(supportsMultipleRows)
				{
					//in this section, we handle horizontal alignment for the
					//current row. however, we may need to adjust it later if
					//the maxRowWidth is smaller than the availableRowWidth.
					var horizontalAlignOffsetX:Number = 0;
					if(this._horizontalAlign === HorizontalAlign.RIGHT)
					{
						horizontalAlignOffsetX = availableRowWidth - totalRowWidth;
					}
					else if(this._horizontalAlign === HorizontalAlign.CENTER)
					{
						horizontalAlignOffsetX = Math.round((availableRowWidth - totalRowWidth) / 2);
					}
					if(horizontalAlignOffsetX != 0)
					{
						for(var j:int = 0; j < rowItemCount; j++)
						{
							item = this._rowItems[j];
							if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
							{
								continue;
							}
							item.x += horizontalAlignOffsetX;
						}
					}
				}

				for(j = 0; j < rowItemCount; j++)
				{
					item = this._rowItems[j];
					var layoutItem:ILayoutDisplayObject = item as ILayoutDisplayObject;
					if(layoutItem && !layoutItem.includeInLayout)
					{
						continue;
					}
					//handle all other vertical alignment values. the y position
					//of all items is set here.
					switch(this._rowVerticalAlign)
					{
						case VerticalAlign.BOTTOM:
						{
							item.y = item.pivotY + positionY + maxItemHeight - item.height;
							break;
						}
						case VerticalAlign.MIDDLE:
						{
							//round to the nearest pixel when dividing by 2 to
							//align in the middle
							item.y = item.pivotY + positionY + Math.round((maxItemHeight - item.height) / 2);
							break;
						}
						default: //top
						{
							item.y = item.pivotY + positionY;
						}
					}
				}
			}
			while(i < itemCount);
			//we don't want to keep a reference to any of the items, so clear
			//this cache
			this._rowItems.length = 0;

			if(supportsMultipleRows && (needsWidth || explicitWidth < maxRowWidth))
			{
				//if the maxRowWidth has changed since any row was aligned, the
				//items in those rows may need to be shifted a bit
				var contentRowWidth:Number = maxRowWidth;
				if(contentRowWidth < minWidth)
				{
					contentRowWidth = minWidth;
				}
				else if(contentRowWidth > maxWidth)
				{
					contentRowWidth = maxWidth;
				}
				horizontalAlignOffsetX = 0;
				if(this._horizontalAlign === HorizontalAlign.RIGHT)
				{
					horizontalAlignOffsetX = availableRowWidth - contentRowWidth;
				}
				else if(this._horizontalAlign === HorizontalAlign.CENTER)
				{
					horizontalAlignOffsetX = Math.round((availableRowWidth - contentRowWidth) / 2);
				}
				if(horizontalAlignOffsetX != 0)
				{
					for(i = 0; i < itemCount; i++)
					{
						item = items[i];
						if(!item || (item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout))
						{
							continue;
						}
						//previously, we used the maxWidth for alignment,
						//but the max row width may be smaller, so we need
						//to account for the difference
						item.x -= horizontalAlignOffsetX;
					}
				}
			}
			else
			{
				contentRowWidth = maxRowWidth;
			}
			if(needsWidth)
			{
				availableRowWidth = contentRowWidth;
			}

			var totalHeight:Number = positionY + maxItemHeight + this._paddingBottom;
			//the available height is the height of the viewport. if the explicit
			//height is NaN, we need to calculate the viewport height ourselves
			//based on the total height of all items.
			var availableHeight:Number = explicitHeight;
			if(availableHeight !== availableHeight) //isNaN
			{
				availableHeight = totalHeight;
				if(availableHeight < minHeight)
				{
					availableHeight = minHeight;
				}
				else if(availableHeight > maxHeight)
				{
					availableHeight = maxHeight;
				}
			}

			if(totalHeight < availableHeight &&
				this._verticalAlign != VerticalAlign.TOP)
			{
				var verticalAlignOffset:Number = availableHeight - totalHeight;
				if(this._verticalAlign === VerticalAlign.MIDDLE)
				{
					verticalAlignOffset /= 2;
				}
				for(i = 0; i < itemCount; i++)
				{
					item = items[i];
					if(!item || (item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout))
					{
						continue;
					}
					item.y += verticalAlignOffset;
				}
			}

			//finally, we want to calculate the result so that the container
			//can use it to adjust its viewport and determine the minimum and
			//maximum scroll positions (if needed)
			if(!result)
			{
				result = new LayoutBoundsResult();
			}
			result.contentX = 0;
			result.contentWidth = maxRowWidth;
			result.contentY = 0;
			result.contentHeight = totalHeight;
			result.viewPortWidth = availableRowWidth;
			result.viewPortHeight = availableHeight;
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function measureViewPort(itemCount:int, viewPortBounds:ViewPortBounds = null, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("measureViewPort() may be called only if useVirtualLayout is true.");
			}
			//this function is very long because it may be called every frame,
			//in some situations. testing revealed that splitting this function
			//into separate, smaller functions affected performance.
			//since the SWC compiler cannot inline functions, we can't use that
			//feature either.

			//since viewPortBounds can be null, we may need to provide some defaults
			var boundsX:Number = viewPortBounds ? viewPortBounds.x : 0;
			var boundsY:Number = viewPortBounds ? viewPortBounds.y : 0;
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;
			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;

			//let's figure out if we can show multiple rows
			var supportsMultipleRows:Boolean = true;
			var availableRowWidth:Number = explicitWidth;
			if(availableRowWidth !== availableRowWidth) //isNaN
			{
				availableRowWidth = maxWidth;
				if(availableRowWidth == Number.POSITIVE_INFINITY)
				{
					supportsMultipleRows = false;
				}
			}

			if(this._typicalItem is IValidating)
			{
				IValidating(this._typicalItem).validate();
			}
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var i:int = 0;
			var positionY:Number = boundsY + this._paddingTop;
			var maxRowWidth:Number = 0;
			var maxItemHeight:Number = 0;
			var verticalGap:Number = this._verticalGap;
			var hasFirstHorizontalGap:Boolean = this._firstHorizontalGap === this._firstHorizontalGap; //!isNaN
			var hasLastHorizontalGap:Boolean = this._lastHorizontalGap === this._lastHorizontalGap; //!isNaN
			var secondToLastIndex:int = itemCount - 2;
			do
			{
				if(i > 0)
				{
					positionY += maxItemHeight + verticalGap;
				}
				//this section prepares some variables needed for the following loop
				maxItemHeight = this._useVirtualLayout ? calculatedTypicalItemHeight : 0;
				var positionX:Number = boundsX + this._paddingLeft;
				var rowItemCount:int = 0;

				//if there are no items in the row (such as when there are no
				//items in the container!), then we don't want to subtract the
				//gap when calculating the row width, so default to 0.
				var horizontalGap:Number = 0;

				//this first loop sets the x position of items, and it calculates
				//the total width of all items
				for(; i < itemCount; i++)
				{
					horizontalGap = this._horizontalGap;
					if(hasFirstHorizontalGap && i == 0)
					{
						horizontalGap = this._firstHorizontalGap;
					}
					else if(hasLastHorizontalGap && i > 0 && i == secondToLastIndex)
					{
						horizontalGap = this._lastHorizontalGap;
					}
					if(this._hasVariableItemDimensions)
					{
						var cachedWidth:Number = this._widthCache[i];
						var cachedHeight:Number = this._heightCache[i];
						if(cachedWidth !== cachedWidth) //isNaN
						{
							var itemWidth:Number = calculatedTypicalItemWidth;
						}
						else
						{
							itemWidth = cachedWidth;
						}
						if(cachedHeight !== cachedHeight) //isNaN
						{
							var itemHeight:Number = calculatedTypicalItemHeight;
						}
						else
						{
							itemHeight = cachedHeight;
						}
					}
					else
					{
						itemWidth = calculatedTypicalItemWidth;
						itemHeight = calculatedTypicalItemHeight;
					}
					if(supportsMultipleRows && rowItemCount > 0 && (positionX + itemWidth) > (availableRowWidth - this._paddingRight))
					{
						//we've reached the end of the row, so go to next
						break;
					}
					positionX += itemWidth + horizontalGap;
					//we compare with > instead of Math.max() because the rest
					//arguments on Math.max() cause extra garbage collection and
					//hurt performance
					if(itemHeight > maxItemHeight)
					{
						//we need to know the maximum height of the items in the
						//case where the height of the view port needs to be
						//calculated by the layout.
						maxItemHeight = itemHeight;
					}
					rowItemCount++;
				}

				//this is the total width of all items in the row
				var totalRowWidth:Number = positionX - horizontalGap + this._paddingRight - boundsX;
				if(totalRowWidth > maxRowWidth)
				{
					maxRowWidth = totalRowWidth;
				}
			}
			while(i < itemCount);

			if(supportsMultipleRows)
			{
				if(explicitWidth !== explicitWidth) //isNaN
				{
					availableRowWidth = maxRowWidth;
					if(availableRowWidth < minWidth)
					{
						availableRowWidth = minWidth;
					}
					else if(availableRowWidth > maxWidth)
					{
						availableRowWidth = maxWidth;
					}
				}
			}
			else
			{
				availableRowWidth = maxRowWidth;
			}

			var totalHeight:Number = positionY + maxItemHeight + this._paddingBottom;
			//the available height is the height of the viewport. if the explicit
			//height is NaN, we need to calculate the viewport height ourselves
			//based on the total height of all items.
			var availableHeight:Number = explicitHeight;
			if(availableHeight !== availableHeight) //isNaN
			{
				availableHeight = totalHeight;
				if(availableHeight < minHeight)
				{
					availableHeight = minHeight;
				}
				else if(availableHeight > maxHeight)
				{
					availableHeight = maxHeight;
				}
			}

			result.x = availableRowWidth;
			result.y = availableHeight;
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getNearestScrollPositionForIndex(index:int, scrollX:Number, scrollY:Number, items:Vector.<DisplayObject>,
			x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			result = this.calculateMaxScrollYAndRowHeightOfIndex(index, items, x, y, width, height, result);
			var maxScrollY:Number = result.x;
			var rowHeight:Number = result.y;

			result.x = 0;

			var bottomPosition:Number = maxScrollY - (height - rowHeight);
			if(scrollY >= bottomPosition && scrollY <= maxScrollY)
			{
				//keep the current scroll position because the item is already
				//fully visible
				result.y = scrollY;
			}
			else
			{
				var topDifference:Number = Math.abs(maxScrollY - scrollY);
				var bottomDifference:Number = Math.abs(bottomPosition - scrollY);
				if(bottomDifference < topDifference)
				{
					result.y = bottomPosition;
				}
				else
				{
					result.y = maxScrollY;
				}
			}

			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function calculateNavigationDestination(items:Vector.<DisplayObject>, index:int, keyCode:uint, bounds:LayoutBoundsResult):int
		{
			var result:int = index;
			if(keyCode == Keyboard.HOME)
			{
				if(items.length > 0)
				{
					result = 0;
				}
			}
			else if(keyCode == Keyboard.END)
			{
				result = items.length - 1;
			}
			else if(keyCode == Keyboard.UP)
			{
				result--;
			}
			else if(keyCode == Keyboard.DOWN)
			{
				result++;
			}
			if(result < 0)
			{
				return 0;
			}
			if(result >= items.length)
			{
				return items.length - 1;
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getScrollPositionForIndex(index:int, items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			result = this.calculateMaxScrollYAndRowHeightOfIndex(index, items, x, y, width, height, result);
			var maxScrollY:Number = result.x;
			var rowHeight:Number = result.y;

			if(this._useVirtualLayout)
			{
				if(this._hasVariableItemDimensions)
				{
					var itemHeight:Number = this._heightCache[index];
					if(itemHeight !== itemHeight) //isNaN
					{
						itemHeight = this._typicalItem.height;
					}
				}
				else
				{
					itemHeight = this._typicalItem.height;
				}
			}
			else
			{
				itemHeight = items[index].height;
			}

			if(!result)
			{
				result = new Point();
			}
			result.x = 0;
			result.y = maxScrollY - Math.round((height - itemHeight) / 2);

			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getDropIndex(x:Number, y:Number, items:Vector.<DisplayObject>,
			boundsX:Number, boundsY:Number, width:Number, height:Number):int
		{
			if(this._useVirtualLayout)
			{
				//if the layout is virtualized, we'll need the dimensions of the
				//typical item so that we have fallback values when an item is null
				if(this._typicalItem is IValidating)
				{
					IValidating(this._typicalItem).validate();
				}
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var horizontalGap:Number = this._horizontalGap;
			var verticalGap:Number = this._verticalGap;
			var maxItemHeight:Number = 0;
			var positionY:Number = this._paddingTop;
			var i:int = 0;
			var itemCount:int = items.length;
			do
			{
				if(i > 0)
				{
					positionY += maxItemHeight + verticalGap;
				}
				//this section prepares some variables needed for the following loop
				maxItemHeight = this._useVirtualLayout ? calculatedTypicalItemHeight : 0;
				var positionX:Number = this._paddingLeft;
				var rowItemCount:int = 0;
				for(; i < itemCount; i++)
				{
					var item:DisplayObject = items[i];

					if(this._useVirtualLayout && this._hasVariableItemDimensions)
					{
						var cachedWidth:Number = this._widthCache[i];
						var cachedHeight:Number = this._heightCache[i];
					}
					if(this._useVirtualLayout && !item)
					{
						//the item is null, and the layout is virtualized, so we
						//need to estimate the width of the item.

						if(this._hasVariableItemDimensions)
						{
							if(cachedWidth !== cachedWidth) //isNaN
							{
								var itemWidth:Number = calculatedTypicalItemWidth;
							}
							else
							{
								itemWidth = cachedWidth;
							}
							if(cachedHeight !== cachedHeight) //isNaN
							{
								var itemHeight:Number = calculatedTypicalItemHeight;
							}
							else
							{
								itemHeight = cachedHeight;
							}
						}
						else
						{
							itemWidth = calculatedTypicalItemWidth;
							itemHeight = calculatedTypicalItemHeight;
						}
					}
					else
					{
						//we get here if the item isn't null. it is never null if
						//the layout isn't virtualized.
						if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
						{
							continue;
						}
						if(item is IValidating)
						{
							IValidating(item).validate();
						}
						itemWidth = item.width;
						itemHeight = item.height;
						if(this._useVirtualLayout && this._hasVariableItemDimensions)
						{
							if(this._hasVariableItemDimensions)
							{
								if(itemWidth != cachedWidth)
								{
									this._widthCache[i] = itemWidth;
									this.dispatchEventWith(Event.CHANGE);
								}
								if(itemHeight != cachedHeight)
								{
									this._heightCache[i] = itemHeight;
									this.dispatchEventWith(Event.CHANGE);
								}
							}
							else
							{
								if(calculatedTypicalItemWidth >= 0)
								{
									itemWidth = calculatedTypicalItemWidth;
								}
								if(calculatedTypicalItemHeight >= 0)
								{
									itemHeight = calculatedTypicalItemHeight;
								}
							}
						}
					}
					var endOfRow:Boolean = rowItemCount > 0 && (positionX + itemWidth) > (width - this._paddingRight);
					if((endOfRow || x < (positionX + (itemWidth / 2))) && y < (positionY + itemHeight + (gap / 2)))
					{
						return i;
					}
					if(endOfRow)
					{
						//we've reached the end of the row, so go to next
						break;
					}
					//we compare with > instead of Math.max() because the rest
					//arguments on Math.max() cause extra garbage collection and
					//hurt performance
					if(itemHeight > maxItemHeight)
					{
						//we need to know the maximum height of the items in the
						//case where the height of the view port needs to be
						//calculated by the layout.
						maxItemHeight = itemHeight;
					}
					positionX += itemWidth + horizontalGap;
					rowItemCount++;
				}
			}
			while(i < itemCount);
			return itemCount;
		}

		/**
		 * @inheritDoc
		 */
		public function positionDropIndicator(dropIndicator:DisplayObject, index:int,
			x:Number, y:Number, items:Vector.<DisplayObject>, width:Number, height:Number):void
		{
			if(dropIndicator is IValidating)
			{
				IValidating(dropIndicator).validate();
			}

			var horizontalGap:Number = this._horizontalGap;
			var verticalGap:Number = this._verticalGap;
			var maxItemHeight:Number = 0;
			var positionY:Number = this._paddingTop;
			var i:int = 0;
			var itemCount:int = items.length;
			do
			{
				if(i > 0)
				{
					if(y < (positionY + itemHeight + (verticalGap / 2)))
					{
						//if the x/y position is closer to the previous row,
						//then display the drop indicator at the end of that row
						var item:DisplayObject = items[i - 1];
						dropIndicator.x = item.x + item.width - dropIndicator.width / 2;
						dropIndicator.y = item.y;
						dropIndicator.height = item.height;
						return;
					}
					positionY += maxItemHeight + verticalGap;
				}
				//this section prepares some variables needed for the following loop
				maxItemHeight = 0;
				var positionX:Number = this._paddingLeft;
				var rowItemCount:int = 0;
				for(; i < itemCount; i++)
				{
					item = items[i];
					var itemWidth:Number = item.width;
					var itemHeight:Number = item.height;
					if(rowItemCount > 0 && (positionX + itemWidth) > (width - this._paddingRight))
					{
						//we've reached the end of the row, so go to next
						break;
					}
					//we compare with > instead of Math.max() because the rest
					//arguments on Math.max() cause extra garbage collection and
					//hurt performance
					if(itemHeight > maxItemHeight)
					{
						//we need to know the maximum height of the items in the
						//case where the height of the view port needs to be
						//calculated by the layout.
						maxItemHeight = itemHeight;
					}
					if(i == index)
					{
						dropIndicator.x = item.x - dropIndicator.width / 2;
						dropIndicator.y = item.y;
						dropIndicator.height = item.height;
						return;
					}
					positionX += itemWidth + horizontalGap;
					rowItemCount++;
				}
			}
			while(i < itemCount);
			var lastItem:DisplayObject = items[itemCount - 1];
			dropIndicator.x = lastItem.x + lastItem.width - dropIndicator.width / 2;
			dropIndicator.y = lastItem.y;
			dropIndicator.height = lastItem.height;
		}

		/**
		 * @inheritDoc
		 */
		override public function resetVariableVirtualCache():void
		{
			this._widthCache.length = 0;
			this._heightCache.length = 0;
		}

		/**
		 * @inheritDoc
		 */
		override public function resetVariableVirtualCacheAtIndex(index:int, item:DisplayObject = null):void
		{
			delete this._widthCache[index];
			delete this._heightCache[index];
			if(item)
			{
				this._widthCache[index] = item.width;
				this._heightCache[index] = item.height;
				this.dispatchEventWith(Event.CHANGE);
			}
		}

		/**
		 * @inheritDoc
		 */
		override public function addToVariableVirtualCacheAtIndex(index:int, item:DisplayObject = null):void
		{
			var widthValue:* = (item !== null) ? item.width : undefined;
			var heightValue:* = (item !== null) ? item.height : undefined;
			this._widthCache.insertAt(index, widthValue);
			this._heightCache.insertAt(index, heightValue);
		}

		/**
		 * @inheritDoc
		 */
		override public function removeFromVariableVirtualCacheAtIndex(index:int):void
		{
			this._widthCache.removeAt(index);
			this._heightCache.removeAt(index);
		}

		/**
		 * @inheritDoc
		 */
		public function getVisibleIndicesAtScrollPosition(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int> = null):Vector.<int>
		{
			if(result)
			{
				result.length = 0;
			}
			else
			{
				result = new <int>[];
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("getVisibleIndicesAtScrollPosition() may be called only if useVirtualLayout is true.");
			}

			if(this._typicalItem is IValidating)
			{
				IValidating(this._typicalItem).validate();
			}
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var resultLastIndex:int = 0;

			var i:int = 0;
			var positionY:Number = this._paddingTop;
			var maxItemHeight:Number = 0;
			var verticalGap:Number = this._verticalGap;
			var maxPositionY:Number = scrollY + height;
			var hasFirstHorizontalGap:Boolean = this._firstHorizontalGap === this._firstHorizontalGap; //!isNaN
			var hasLastHorizontalGap:Boolean = this._lastHorizontalGap === this._lastHorizontalGap; //!isNaN
			var secondToLastIndex:int = itemCount - 2;
			do
			{
				if(i > 0)
				{
					positionY += maxItemHeight + verticalGap;
					if(positionY >= maxPositionY)
					{
						//the following rows will not be visible, so we can stop
						break;
					}
				}
				//this section prepares some variables needed for the following loop
				maxItemHeight = calculatedTypicalItemHeight;
				var positionX:Number = this._paddingLeft;
				var rowItemCount:int = 0;

				//this first loop sets the x position of items, and it calculates
				//the total width of all items
				for(; i < itemCount; i++)
				{
					var horizontalGap:Number = this._horizontalGap;
					if(hasFirstHorizontalGap && i == 0)
					{
						horizontalGap = this._firstHorizontalGap;
					}
					else if(hasLastHorizontalGap && i > 0 && i == secondToLastIndex)
					{
						horizontalGap = this._lastHorizontalGap;
					}
					if(this._hasVariableItemDimensions)
					{
						var cachedWidth:Number = this._widthCache[i];
						var cachedHeight:Number = this._heightCache[i];
					}
					if(this._hasVariableItemDimensions)
					{
						if(cachedWidth !== cachedWidth) //isNaN
						{
							var itemWidth:Number = calculatedTypicalItemWidth;
						}
						else
						{
							itemWidth = cachedWidth;
						}
						if(cachedHeight !== cachedHeight) //isNaN
						{
							var itemHeight:Number = calculatedTypicalItemHeight;
						}
						else
						{
							itemHeight = cachedHeight;
						}
					}
					else
					{
						itemWidth = calculatedTypicalItemWidth;
						itemHeight = calculatedTypicalItemHeight;
					}
					if(rowItemCount > 0 && (positionX + itemWidth) > (width - this._paddingRight))
					{
						//we've reached the end of the row, so go to next
						break;
					}
					if((positionY + itemHeight) > scrollY)
					{
						result[resultLastIndex] = i;
						resultLastIndex++;
					}
					positionX += itemWidth + horizontalGap;
					//we compare with > instead of Math.max() because the rest
					//arguments on Math.max() cause extra garbage collection and
					//hurt performance
					if(itemHeight > maxItemHeight)
					{
						//we need to know the maximum height of the items in the
						//case where the height of the view port needs to be
						//calculated by the layout.
						maxItemHeight = itemHeight;
					}
					rowItemCount++;
				}
			}
			while(i < itemCount);
			return result;
		}

		/**
		 * @private
		 */
		protected function calculateMaxScrollYAndRowHeightOfIndex(index:int, items:Vector.<DisplayObject>,
			x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}
			if(this._useVirtualLayout)
			{
				//if the layout is virtualized, we'll need the dimensions of the
				//typical item so that we have fallback values when an item is null
				if(this._typicalItem is IValidating)
				{
					IValidating(this._typicalItem).validate();
				}
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var horizontalGap:Number = this._horizontalGap;
			var verticalGap:Number = this._verticalGap;
			var maxItemHeight:Number = 0;
			var positionY:Number = y + this._paddingTop;
			var i:int = 0;
			var itemCount:int = items.length;
			var isLastRow:Boolean = false;
			do
			{
				if(isLastRow)
				{
					break;
				}
				if(i > 0)
				{
					positionY += maxItemHeight + verticalGap;
				}
				//this section prepares some variables needed for the following loop
				maxItemHeight = this._useVirtualLayout ? calculatedTypicalItemHeight : 0;
				var positionX:Number = x + this._paddingLeft;
				var rowItemCount:int = 0;
				for(; i < itemCount; i++)
				{
					var item:DisplayObject = items[i];

					if(this._useVirtualLayout && this._hasVariableItemDimensions)
					{
						var cachedWidth:Number = this._widthCache[i];
						var cachedHeight:Number = this._heightCache[i];
					}
					if(this._useVirtualLayout && !item)
					{
						//the item is null, and the layout is virtualized, so we
						//need to estimate the width of the item.

						if(this._hasVariableItemDimensions)
						{
							if(cachedWidth !== cachedWidth) //isNaN
							{
								var itemWidth:Number = calculatedTypicalItemWidth;
							}
							else
							{
								itemWidth = cachedWidth;
							}
							if(cachedHeight !== cachedHeight) //isNaN
							{
								var itemHeight:Number = calculatedTypicalItemHeight;
							}
							else
							{
								itemHeight = cachedHeight;
							}
						}
						else
						{
							itemWidth = calculatedTypicalItemWidth;
							itemHeight = calculatedTypicalItemHeight;
						}
					}
					else
					{
						//we get here if the item isn't null. it is never null if
						//the layout isn't virtualized.
						if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
						{
							continue;
						}
						if(item is IValidating)
						{
							IValidating(item).validate();
						}
						itemWidth = item.width;
						itemHeight = item.height;
						if(this._useVirtualLayout && this._hasVariableItemDimensions)
						{
							if(this._hasVariableItemDimensions)
							{
								if(itemWidth != cachedWidth)
								{
									this._widthCache[i] = itemWidth;
									this.dispatchEventWith(Event.CHANGE);
								}
								if(itemHeight != cachedHeight)
								{
									this._heightCache[i] = itemHeight;
									this.dispatchEventWith(Event.CHANGE);
								}
							}
							else
							{
								if(calculatedTypicalItemWidth >= 0)
								{
									itemWidth = calculatedTypicalItemWidth;
								}
								if(calculatedTypicalItemHeight >= 0)
								{
									itemHeight = calculatedTypicalItemHeight;
								}
							}
						}
					}
					if(rowItemCount > 0 && (positionX + itemWidth) > (width - this._paddingRight))
					{
						//we've reached the end of the row, so go to next
						break;
					}
					//we don't check this at the beginning of the loop because
					//it may break to start a new row and then redo this item
					if(i == index)
					{
						isLastRow = true;
					}
					//we compare with > instead of Math.max() because the rest
					//arguments on Math.max() cause extra garbage collection and
					//hurt performance
					if(itemHeight > maxItemHeight)
					{
						//we need to know the maximum height of the items in the
						//case where the height of the view port needs to be
						//calculated by the layout.
						maxItemHeight = itemHeight;
					}
					positionX += itemWidth + horizontalGap;
					rowItemCount++;
				}
			}
			while(i < itemCount);
			result.setTo(positionY, maxItemHeight);
			return result;
		}
	}
}


================================================
FILE: source/feathers/layout/HorizontalAlign.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	/**
	 * Constants for horizontal alignment of items in a layout.
	 *
	 * <p>Note: Some constants may not be valid for certain properties. Please
	 * see the description of the property in the API reference for full
	 * details.</p>
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class HorizontalAlign
	{
		/**
		 * The items in the layout will be horizontally aligned to the left of
		 * the bounds.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const LEFT:String = "left";

		/**
		 * The items in the layout will be horizontally aligned to the center of
		 * the bounds.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const CENTER:String = "center";

		/**
		 * The items in the layout will be horizontally aligned to the right of
		 * the bounds.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const RIGHT:String = "right";

		/**
		 * The items in the layout will fill the width of the bounds.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const JUSTIFY:String = "justify";
	}
}


================================================
FILE: source/feathers/layout/HorizontalLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IValidating;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;
	import flash.ui.Keyboard;

	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * Positions items from left to right in a single row.
	 *
	 * @see ../../../help/horizontal-layout.html How to use HorizontalLayout with Feathers containers
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class HorizontalLayout extends BaseLinearLayout implements IVariableVirtualLayout, ITrimmedVirtualLayout, IDragDropLayout
	{
		/**
		 * Constructor.
		 */
		public function HorizontalLayout()
		{
			super();
		}

		[Inspectable(type="String",enumeration="left,center,right")]
		/**
		 * If the total item width is less than the bounds, the positions of
		 * the items can be aligned horizontally, on the x-axis.
		 *
		 * <p><strong>Note:</strong> The <code>HorizontalAlign.JUSTIFY</code>
		 * constant is not supported.</p>
		 *
		 * @default feathers.layout.HorizontalAlign.LEFT
		 *
		 * @see feathers.layout.HorizontalAlign#LEFT
		 * @see feathers.layout.HorizontalAlign#CENTER
		 * @see feathers.layout.HorizontalAlign#RIGHT
		 */
		override public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		[Inspectable(type="String",enumeration="top,middle,bottom,justify")]
		/**
		 * The alignment of the items vertically, on the y-axis.
		 *
		 * <p>If the <code>verticalAlign</code> property is set to
		 * <code>feathers.layout.VerticalAlign.JUSTIFY</code>, the
		 * <code>height</code>, <code>minHeight</code>, and
		 * <code>maxHeight</code> properties of the items may be changed, and
		 * their original values ignored by the layout. In this situation, if
		 * the height needs to be constrained, the <code>height</code>,
		 * <code>minHeight</code>, or <code>maxHeight</code> properties should
		 * instead be set on the parent container that is using this layout.</p>
		 *
		 * @default feathers.layout.VerticalAlign.TOP
		 *
		 * @see feathers.layout.VerticalAlign#TOP
		 * @see feathers.layout.VerticalAlign#MIDDLE
		 * @see feathers.layout.VerticalAlign#BOTTOM
		 * @see feathers.layout.VerticalAlign#JUSTIFY
		 */
		override public function get verticalAlign():String
		{
			//this is an override so that this class can have its own documentation.
			return this._verticalAlign;
		}

		/**
		 * @private
		 */
		protected var _distributeWidths:Boolean = false;

		/**
		 * Distributes the width of the view port equally to each item. If the
		 * view port width needs to be measured, the largest item's width will
		 * be used for all items, subject to any specified minimum and maximum
		 * width values.
		 *
		 * @default false
		 */
		public function get distributeWidths():Boolean
		{
			return this._distributeWidths;
		}

		/**
		 * @private
		 */
		public function set distributeWidths(value:Boolean):void
		{
			if(this._distributeWidths == value)
			{
				return;
			}
			this._distributeWidths = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _requestedColumnCount:int = 0;

		/**
		 * Requests that the layout set the view port dimensions to display a
		 * specific number of columns (plus gaps and padding), if possible. If
		 * the explicit width of the view port is set, then this value will be
		 * ignored. If the view port's minimum and/or maximum width are set,
		 * the actual number of visible columns may be adjusted to meet those
		 * requirements. Set this value to <code>0</code> to display as many
		 * columns as possible.
		 *
		 * @default 0
		 *
		 * @see #maxColumnCount
		 */
		public function get requestedColumnCount():int
		{
			return this._requestedColumnCount;
		}

		/**
		 * @private
		 */
		public function set requestedColumnCount(value:int):void
		{
			if(value < 0)
			{
				throw RangeError("requestedColumnCount requires a value >= 0");
			}
			if(this._requestedColumnCount == value)
			{
				return;
			}
			this._requestedColumnCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _maxColumnCount:int = 0;

		/**
		 * The maximum number of columns to display. If the explicit width of
		 * the view port is set or if the <code>requestedColumnCount</code> is
		 * set, then this value will be ignored. If the view port's minimum
		 * and/or maximum width are set, the actual number of visible columns
		 * may be adjusted to meet those requirements. Set this value to
		 * <code>0</code> to display as many columns as possible.
		 *
		 * @default 0
		 */
		public function get maxColumnCount():int
		{
			return this._maxColumnCount;
		}

		/**
		 * @private
		 */
		public function set maxColumnCount(value:int):void
		{
			if(value < 0)
			{
				throw RangeError("maxColumnCount requires a value >= 0");
			}
			if(this._maxColumnCount == value)
			{
				return;
			}
			this._maxColumnCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _scrollPositionHorizontalAlign:String = HorizontalAlign.CENTER;

		[Inspectable(type="String",enumeration="left,center,right")]
		/**
		 * When the scroll position is calculated for an item, an attempt will
		 * be made to align the item to this position.
		 *
		 * @default feathers.layout.HorizontalAlign.CENTER
		 *
		 * @see feathers.layout.HorizontalAlign#LEFT
		 * @see feathers.layout.HorizontalAlign#CENTER
		 * @see feathers.layout.HorizontalAlign#RIGHT
		 */
		public function get scrollPositionHorizontalAlign():String
		{
			return this._scrollPositionHorizontalAlign;
		}

		/**
		 * @private
		 */
		public function set scrollPositionHorizontalAlign(value:String):void
		{
			this._scrollPositionHorizontalAlign = value;
		}

		/**
		 * @inheritDoc
		 */
		public function layout(items:Vector.<DisplayObject>, viewPortBounds:ViewPortBounds = null, result:LayoutBoundsResult = null):LayoutBoundsResult
		{
			//this function is very long because it may be called every frame,
			//in some situations. testing revealed that splitting this function
			//into separate, smaller functions affected performance.
			//since the SWC compiler cannot inline functions, we can't use that
			//feature either.

			//since viewPortBounds can be null, we may need to provide some defaults
			var scrollX:Number = viewPortBounds ? viewPortBounds.scrollX : 0;
			var scrollY:Number = viewPortBounds ? viewPortBounds.scrollY : 0;
			var boundsX:Number = viewPortBounds ? viewPortBounds.x : 0;
			var boundsY:Number = viewPortBounds ? viewPortBounds.y : 0;
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;
			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;

			if(this._useVirtualLayout)
			{
				//if the layout is virtualized, we'll need the dimensions of the
				//typical item so that we have fallback values when an item is null
				this.prepareTypicalItem(explicitHeight - this._paddingTop - this._paddingBottom);
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var needsExplicitWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			var needsExplicitHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			var distributedWidth:Number;
			if(!needsExplicitWidth && this._distributeWidths)
			{
				//we need to calculate this before validateItems() because it
				//needs to be passed in there.
				distributedWidth = this.calculateDistributedWidth(items, explicitWidth, minWidth, maxWidth, false);
				if(this._useVirtualLayout)
				{
					calculatedTypicalItemWidth = distributedWidth;
				}
			}

			if(!this._useVirtualLayout || this._hasVariableItemDimensions || this._distributeWidths ||
				this._verticalAlign != VerticalAlign.JUSTIFY ||
				needsExplicitHeight) //isNaN
			{
				//in some cases, we may need to validate all of the items so
				//that we can use their dimensions below.
				this.validateItems(items, explicitHeight - this._paddingTop - this._paddingBottom,
					minHeight - this._paddingTop - this._paddingBottom,
					maxHeight - this._paddingTop - this._paddingBottom,
					explicitWidth - this._paddingLeft - this._paddingRight,
					minWidth - this._paddingLeft - this._paddingRight,
					maxWidth - this._paddingLeft - this._paddingRight, distributedWidth);
			}

			if(needsExplicitWidth && this._distributeWidths)
			{
				//if we didn't calculate this before, we need to do it now.
				distributedWidth = this.calculateDistributedWidth(items, explicitWidth, minWidth, maxWidth, true);
			}
			var hasDistributedWidth:Boolean = distributedWidth === distributedWidth; //!isNaN

			if(!this._useVirtualLayout)
			{
				//handle the percentWidth property from HorizontalLayoutData,
				//if available.
				this.applyPercentWidths(items, explicitWidth, minWidth, maxWidth);
			}

			//this section prepares some variables needed for the following loop
			var hasFirstGap:Boolean = this._firstGap === this._firstGap; //!isNaN
			var hasLastGap:Boolean = this._lastGap === this._lastGap; //!isNaN
			var maxItemHeight:Number = this._useVirtualLayout ? calculatedTypicalItemHeight : 0;
			var positionX:Number = boundsX + this._paddingLeft;
			var itemCount:int = items.length;
			var totalItemCount:int = itemCount;
			var requestedColumnAvailableWidth:Number = 0;
			var maxColumnAvailableWidth:Number = Number.POSITIVE_INFINITY;
			if(this._useVirtualLayout && !this._hasVariableItemDimensions)
			{
				//if the layout is virtualized, and the items all have the same
				//width, we can make our loops smaller by skipping some items
				//at the beginning and end. this improves performance.
				totalItemCount += this._beforeVirtualizedItemCount + this._afterVirtualizedItemCount;
				positionX += (this._beforeVirtualizedItemCount * (calculatedTypicalItemWidth + this._gap));
				if(hasFirstGap && this._beforeVirtualizedItemCount > 0)
				{
					positionX = positionX - this._gap + this._firstGap;
				}
			}
			var secondToLastIndex:int = totalItemCount - 2;
			//this cache is used to save non-null items in virtual layouts. by
			//using a smaller array, we can improve performance by spending less
			//time in the upcoming loops.
			this._discoveredItemsCache.length = 0;
			var discoveredItemsCacheLastIndex:int = 0;

			//if there are no items in layout, then we don't want to subtract
			//any gap when calculating the total width, so default to 0.
			var gap:Number = 0;

			//this first loop sets the x position of items, and it calculates
			//the total width of all items
			for(var i:int = 0; i < itemCount; i++)
			{
				if(!this._useVirtualLayout)
				{
					if(this._maxColumnCount > 0 && this._maxColumnCount == i)
					{
						maxColumnAvailableWidth = positionX;
					}
					if(this._requestedColumnCount > 0 && this._requestedColumnCount == i)
					{
						requestedColumnAvailableWidth = positionX;
					}
				}
				var item:DisplayObject = items[i];
				//if we're trimming some items at the beginning, we need to
				//adjust i to account for the missing items in the array
				var iNormalized:int = i + this._beforeVirtualizedItemCount;

				//pick the gap that will follow this item. the first and second
				//to last items may have different gaps.
				gap = this._gap;
				if(hasFirstGap && iNormalized == 0)
				{
					gap = this._firstGap;
				}
				else if(hasLastGap && iNormalized > 0 && iNormalized == secondToLastIndex)
				{
					gap = this._lastGap;
				}

				if(this._useVirtualLayout && this._hasVariableItemDimensions)
				{
					var cachedWidth:Number = this._virtualCache[iNormalized];
				}
				if(this._useVirtualLayout && !item)
				{
					//the item is null, and the layout is virtualized, so we
					//need to estimate the width of the item.

					if(!this._hasVariableItemDimensions ||
						cachedWidth !== cachedWidth) //isNaN
					{
						//if all items must have the same width, we will
						//use the width of the typical item (calculatedTypicalItemWidth).

						//if items may have different widths, we first check
						//the cache for a width value. if there isn't one, then
						//we'll use calculatedTypicalItemWidth as a fallback.
						positionX += calculatedTypicalItemWidth + gap;
					}
					else
					{
						//if we have variable item widths, we should use a
						//cached width when there's one available. it will be
						//more accurate than the typical item's width.
						positionX += cachedWidth + gap;
					}
				}
				else
				{
					//we get here if the item isn't null. it is never null if
					//the layout isn't virtualized.
					var layoutItem:ILayoutDisplayObject = item as ILayoutDisplayObject;
					if(layoutItem !== null && !layoutItem.includeInLayout)
					{
						continue;
					}
					var pivotX:Number = item.pivotX;
					if(pivotX != 0)
					{
						pivotX *= item.scaleX;
					}
					item.x = pivotX + positionX;
					var itemWidth:Number;
					if(hasDistributedWidth)
					{
						item.width = itemWidth = distributedWidth;
					}
					else
					{
						itemWidth = item.width;
					}
					var itemHeight:Number = item.height;
					if(this._useVirtualLayout)
					{
						if(this._hasVariableItemDimensions)
						{
							if(itemWidth != cachedWidth)
							{
								//update the cache if needed. this will notify
								//the container that the virtualized layout has
								//changed, and it the view port may need to be
								//re-measured.
								this._virtualCache[iNormalized] = itemWidth;

								//attempt to adjust the scroll position so that
								//it looks like we're scrolling smoothly after
								//this item resizes.
								if(positionX < scrollX &&
									cachedWidth !== cachedWidth && //isNaN
									itemWidth != calculatedTypicalItemWidth)
								{
									this.dispatchEventWith(Event.SCROLL, false, new Point(itemWidth - calculatedTypicalItemWidth, 0));
								}

								this.dispatchEventWith(Event.CHANGE);
							}
						}
						else if(calculatedTypicalItemWidth >= 0)
						{
							//if all items must have the same width, we will
							//use the width of the typical item (calculatedTypicalItemWidth).
							itemWidth = calculatedTypicalItemWidth;
							if(item !== this._typicalItem || item.width != itemWidth)
							{
								//ensure that the typical item's width is not
								//set explicitly so that it can resize
								item.width = itemWidth;
							}
						}
					}
					positionX += itemWidth + gap;
					//we compare with > instead of Math.max() because the rest
					//arguments on Math.max() cause extra garbage collection and
					//hurt performance
					if(itemHeight > maxItemHeight)
					{
						//we need to know the maximum height of the items in the
						//case where the height of the view port needs to be
						//calculated by the layout.
						maxItemHeight = itemHeight;
					}
					if(this._useVirtualLayout)
					{
						this._discoveredItemsCache[discoveredItemsCacheLastIndex] = item;
						discoveredItemsCacheLastIndex++;
					}
				}
			}
			if(this._useVirtualLayout && !this._hasVariableItemDimensions)
			{
				//finish the final calculation of the x position so that it can
				//be used for the total width of all items
				positionX += (this._afterVirtualizedItemCount * (calculatedTypicalItemWidth + this._gap));
				if(hasLastGap && this._afterVirtualizedItemCount > 0)
				{
					positionX = positionX - this._gap + this._lastGap;
				}
			}
			if(!this._useVirtualLayout && this._requestedColumnCount > itemCount)
			{
				if(itemCount > 0)
				{
					requestedColumnAvailableWidth = this._requestedColumnCount * positionX / itemCount;
				}
				else
				{
					requestedColumnAvailableWidth = 0;
				}
			}

			//this array will contain all items that are not null. see the
			//comment above where the discoveredItemsCache is initialized for
			//details about why this is important.
			var discoveredItems:Vector.<DisplayObject> = this._useVirtualLayout ? this._discoveredItemsCache : items;
			var discoveredItemCount:int = discoveredItems.length;

			var totalHeight:Number = maxItemHeight + this._paddingTop + this._paddingBottom;
			//the available height is the height of the viewport. if the explicit
			//height is NaN, we need to calculate the viewport height ourselves
			//based on the total height of all items.
			var availableHeight:Number = explicitHeight;
			if(availableHeight !== availableHeight) //isNaN
			{
				availableHeight = totalHeight;
				if(availableHeight < minHeight)
				{
					availableHeight = minHeight;
				}
				else if(availableHeight > maxHeight)
				{
					availableHeight = maxHeight;
				}
			}

			//this is the total width of all items
			var totalWidth:Number = positionX - gap + this._paddingRight - boundsX;
			//the available width is the width of the viewport. if the explicit
			//width is NaN, we need to calculate the viewport width ourselves
			//based on the total width of all items.
			var availableWidth:Number = explicitWidth;
			if(availableWidth !== availableWidth) //isNaN
			{
				if(this._requestedColumnCount > 0)
				{
					if(this._useVirtualLayout)
					{
						availableWidth = (calculatedTypicalItemWidth + this._gap) * this._requestedColumnCount - this._gap + this._paddingLeft + this._paddingRight;
					}
					else
					{
						availableWidth = requestedColumnAvailableWidth;
					}
				}
				else
				{
					availableWidth = totalWidth;
					if(this._maxColumnCount > 0)
					{
						if(this._useVirtualLayout)
						{
							maxColumnAvailableWidth = (calculatedTypicalItemWidth + this._gap) * this._maxColumnCount - this._gap + this._paddingLeft + this._paddingRight;
						}
						if(maxColumnAvailableWidth < availableWidth)
						{
							availableWidth = maxColumnAvailableWidth;
						}
					}
				}
				if(availableWidth < minWidth)
				{
					availableWidth = minWidth;
				}
				else if(availableWidth > maxWidth)
				{
					availableWidth = maxWidth;
				}
			}

			//in this section, we handle horizontal alignment. items will be
			//aligned horizontally if the total width of all items is less than
			//the available width of the view port.
			if(totalWidth < availableWidth)
			{
				var horizontalAlignOffsetX:Number = 0;
				if(this._horizontalAlign == HorizontalAlign.RIGHT)
				{
					horizontalAlignOffsetX = availableWidth - totalWidth;
				}
				else if(this._horizontalAlign == HorizontalAlign.CENTER)
				{
					horizontalAlignOffsetX = Math.round((availableWidth - totalWidth) / 2);
				}
				if(horizontalAlignOffsetX != 0)
				{
					for(i = 0; i < discoveredItemCount; i++)
					{
						item = discoveredItems[i];
						if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
						{
							continue;
						}
						item.x += horizontalAlignOffsetX;
					}
				}
			}

			var availableHeightMinusPadding:Number = availableHeight - this._paddingTop - this._paddingBottom;
			for(i = 0; i < discoveredItemCount; i++)
			{
				item = discoveredItems[i];
				layoutItem = item as ILayoutDisplayObject;
				if(layoutItem !== null && !layoutItem.includeInLayout)
				{
					continue;
				}

				var pivotY:Number = item.pivotY;
				if(pivotY != 0)
				{
					pivotY *= item.scaleY;
				}

				//in this section, we handle vertical alignment and percent
				//height from HorizontalLayoutData
				if(this._verticalAlign == VerticalAlign.JUSTIFY)
				{
					//if we justify items vertically, we can skip percent height
					item.y = pivotY + boundsY + this._paddingTop;
					item.height = availableHeightMinusPadding;
				}
				else
				{
					if(layoutItem !== null)
					{
						var layoutData:HorizontalLayoutData = layoutItem.layoutData as HorizontalLayoutData;
						if(layoutData !== null)
						{
							//in this section, we handle percentage width if
							//VerticalLayoutData is available.
							var percentHeight:Number = layoutData.percentHeight;
							if(percentHeight === percentHeight) //!isNaN
							{
								if(percentHeight < 0)
								{
									percentHeight = 0;
								}
								if(percentHeight > 100)
								{
									percentHeight = 100;
								}
								itemHeight = percentHeight * availableHeightMinusPadding / 100;
								if(item is IFeathersControl)
								{
									var feathersItem:IFeathersControl = IFeathersControl(item);
									var itemMinHeight:Number = feathersItem.explicitMinHeight;
									//we try to respect the minWidth, but not
									//when it's larger than 100%
									if(itemMinHeight > availableHeightMinusPadding)
									{
										itemMinHeight = availableHeightMinusPadding;
									}
									if(itemHeight < itemMinHeight)
									{
										itemHeight = itemMinHeight;
									}
									else
									{
										var itemMaxHeight:Number = feathersItem.explicitMaxHeight;
										if(itemHeight > itemMaxHeight)
										{
											itemHeight = itemMaxHeight;
										}
									}
								}
								item.height = itemHeight;
							}
						}
					}
					//handle all other vertical alignment values (we handled
					//justify already). the y position of all items is set here.
					var verticalAlignHeight:Number = availableHeight;
					if(totalHeight > verticalAlignHeight)
					{
						verticalAlignHeight = totalHeight;
					}
					switch(this._verticalAlign)
					{
						case VerticalAlign.BOTTOM:
						{
							item.y = pivotY + boundsY + verticalAlignHeight - this._paddingBottom - item.height;
							break;
						}
						case VerticalAlign.MIDDLE:
						{
							item.y = pivotY + boundsY + this._paddingTop + Math.round((verticalAlignHeight - this._paddingTop - this._paddingBottom - item.height) / 2);
							break;
						}
						default: //top
						{
							item.y = pivotY + boundsY + this._paddingTop;
						}
					}
				}
			}
			//we don't want to keep a reference to any of the items, so clear
			//this cache
			this._discoveredItemsCache.length = 0;

			//finally, we want to calculate the result so that the container
			//can use it to adjust its viewport and determine the minimum and
			//maximum scroll positions (if needed)
			if(!result)
			{
				result = new LayoutBoundsResult();
			}
			result.contentX = 0;
			result.contentWidth = totalWidth;
			result.contentY = 0;
			result.contentHeight = this._verticalAlign == VerticalAlign.JUSTIFY ? availableHeight : totalHeight;
			result.viewPortWidth = availableWidth;
			result.viewPortHeight = availableHeight;
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function measureViewPort(itemCount:int, viewPortBounds:ViewPortBounds = null, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("measureViewPort() may be called only if useVirtualLayout is true.");
			}

			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;
			var needsWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			var needsHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			if(!needsWidth && !needsHeight)
			{
				result.x = explicitWidth;
				result.y = explicitHeight;
				return result;
			}
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;

			this.prepareTypicalItem(explicitHeight - this._paddingTop - this._paddingBottom);
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var hasFirstGap:Boolean = this._firstGap === this._firstGap; //!isNaN
			var hasLastGap:Boolean = this._lastGap === this._lastGap; //!isNaN
			var positionX:Number;
			if(this._distributeWidths)
			{
				positionX = (calculatedTypicalItemWidth + this._gap) * itemCount;
			}
			else
			{
				positionX = 0;
				var maxItemHeight:Number = calculatedTypicalItemHeight;
				if(!this._hasVariableItemDimensions)
				{
					positionX += ((calculatedTypicalItemWidth + this._gap) * itemCount);
				}
				else
				{
					for(var i:int = 0; i < itemCount; i++)
					{
						var cachedWidth:Number = this._virtualCache[i];
						if(cachedWidth !== cachedWidth) //isNaN
						{
							positionX += calculatedTypicalItemWidth + this._gap;
						}
						else
						{
							positionX += cachedWidth + this._gap;
						}
					}
				}
			}
			positionX -= this._gap;
			if(hasFirstGap && itemCount > 1)
			{
				positionX = positionX - this._gap + this._firstGap;
			}
			if(hasLastGap && itemCount > 2)
			{
				positionX = positionX - this._gap + this._lastGap;
			}

			if(needsWidth)
			{
				if(this._requestedColumnCount > 0)
				{
					var resultWidth:Number = (calculatedTypicalItemWidth + this._gap) * this._requestedColumnCount - this._gap + this._paddingLeft + this._paddingRight;
				}
				else
				{
					resultWidth = positionX + this._paddingLeft + this._paddingRight;
					if(this._maxColumnCount > 0)
					{
						var maxColumnResultWidth:Number = (calculatedTypicalItemWidth + this._gap) * this._maxColumnCount - this._gap + this._paddingLeft + this._paddingRight;
						if(maxColumnResultWidth < resultWidth)
						{
							resultWidth = maxColumnResultWidth;
						}
					}
				}
				if(resultWidth < minWidth)
				{
					resultWidth = minWidth;
				}
				else if(resultWidth > maxWidth)
				{
					resultWidth = maxWidth;
				}
				result.x = resultWidth;
			}
			else
			{
				result.x = explicitWidth;
			}

			if(needsHeight)
			{
				var resultHeight:Number = maxItemHeight + this._paddingTop + this._paddingBottom;
				if(resultHeight < minHeight)
				{
					resultHeight = minHeight;
				}
				else if(resultHeight > maxHeight)
				{
					resultHeight = maxHeight;
				}
				result.y = resultHeight;
			}
			else
			{
				result.y = explicitHeight;
			}

			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getVisibleIndicesAtScrollPosition(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int> = null):Vector.<int>
		{
			if(result)
			{
				result.length = 0;
			}
			else
			{
				result = new <int>[];
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("getVisibleIndicesAtScrollPosition() may be called only if useVirtualLayout is true.");
			}

			this.prepareTypicalItem(height - this._paddingTop - this._paddingBottom);
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var hasFirstGap:Boolean = this._firstGap === this._firstGap; //!isNaN
			var hasLastGap:Boolean = this._lastGap === this._lastGap; //!isNaN
			var resultLastIndex:int = 0;
			//we add one extra here because the first item renderer in view may
			//be partially obscured, which would reveal an extra item renderer.
			var maxVisibleTypicalItemCount:int = Math.ceil(width / (calculatedTypicalItemWidth + this._gap)) + 1;
			if(!this._hasVariableItemDimensions)
			{
				//this case can be optimized because we know that every item has
				//the same width
				var totalItemWidth:Number = itemCount * (calculatedTypicalItemWidth + this._gap) - this._gap;
				if(hasFirstGap && itemCount > 1)
				{
					totalItemWidth = totalItemWidth - this._gap + this._firstGap;
				}
				if(hasLastGap && itemCount > 2)
				{
					totalItemWidth = totalItemWidth - this._gap + this._lastGap;
				}
				var indexOffset:int = 0;
				if(totalItemWidth < width)
				{
					if(this._horizontalAlign == HorizontalAlign.RIGHT)
					{
						indexOffset = Math.ceil((width - totalItemWidth) / (calculatedTypicalItemWidth + this._gap));
					}
					else if(this._horizontalAlign == HorizontalAlign.CENTER)
					{
						indexOffset = Math.ceil(((width - totalItemWidth) / (calculatedTypicalItemWidth + this._gap)) / 2);
					}
				}
				var minimum:int = (scrollX - this._paddingLeft) / (calculatedTypicalItemWidth + this._gap);
				if(minimum < 0)
				{
					minimum = 0;
				}
				minimum -= indexOffset;
				//if we're scrolling beyond the final item, we should keep the
				//indices consistent so that items aren't destroyed and
				//recreated unnecessarily
				var maximum:int = minimum + maxVisibleTypicalItemCount;
				if(maximum >= itemCount)
				{
					maximum = itemCount - 1;
				}
				minimum = maximum - maxVisibleTypicalItemCount;
				if(minimum < 0)
				{
					minimum = 0;
				}
				for(var i:int = minimum; i <= maximum; i++)
				{
					if(i >= 0 && i < itemCount)
					{
						result[resultLastIndex] = i;
					}
					else if(i < 0)
					{
						result[resultLastIndex] = itemCount + i;
					}
					else if(i >= itemCount)
					{
						result[resultLastIndex] = i - itemCount;
					}
					resultLastIndex++;
				}
				return result;
			}
			var secondToLastIndex:int = itemCount - 2;
			var maxPositionX:Number = scrollX + width;
			var positionX:Number = this._paddingLeft;
			for(i = 0; i < itemCount; i++)
			{
				var gap:Number = this._gap;
				if(hasFirstGap && i == 0)
				{
					gap = this._firstGap;
				}
				else if(hasLastGap && i > 0 && i == secondToLastIndex)
				{
					gap = this._lastGap;
				}
				var cachedWidth:Number = this._virtualCache[i];
				if(cachedWidth !== cachedWidth) //isNaN
				{
					var itemWidth:Number = calculatedTypicalItemWidth;
				}
				else
				{
					itemWidth = cachedWidth;
				}
				var oldPositionX:Number = positionX;
				positionX += itemWidth + gap;
				if(positionX > scrollX && oldPositionX < maxPositionX)
				{
					result[resultLastIndex] = i;
					resultLastIndex++;
				}

				if(positionX >= maxPositionX)
				{
					break;
				}
			}

			//similar to above, in order to avoid costly destruction and
			//creation of item renderers, we're going to fill in some extra
			//indices
			var resultLength:int = result.length;
			var visibleItemCountDifference:int = maxVisibleTypicalItemCount - resultLength;
			if(visibleItemCountDifference > 0 && resultLength > 0)
			{
				//add extra items before the first index
				var firstExistingIndex:int = result[0];
				var lastIndexToAdd:int = firstExistingIndex - visibleItemCountDifference;
				if(lastIndexToAdd < 0)
				{
					lastIndexToAdd = 0;
				}
				for(i = firstExistingIndex - 1; i >= lastIndexToAdd; i--)
				{
					result.insertAt(0, i);
				}
			}
			resultLength = result.length;
			resultLastIndex = resultLength;
			visibleItemCountDifference = maxVisibleTypicalItemCount - resultLength;
			if(visibleItemCountDifference > 0)
			{
				//add extra items after the last index
				var startIndex:int = resultLength > 0 ? (result[resultLength - 1] + 1) : 0;
				var endIndex:int = startIndex + visibleItemCountDifference;
				if(endIndex > itemCount)
				{
					endIndex = itemCount;
				}
				for(i = startIndex; i < endIndex; i++)
				{
					result[resultLastIndex] = i;
					resultLastIndex++;
				}
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getNearestScrollPositionForIndex(index:int, scrollX:Number, scrollY:Number, items:Vector.<DisplayObject>,
			x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			var maxScrollX:Number = this.calculateMaxScrollXOfIndex(index, items, x, y, width, height);

			if(this._useVirtualLayout)
			{
				if(this._hasVariableItemDimensions)
				{
					var itemWidth:Number = this._virtualCache[index];
					if(itemWidth !== itemWidth) //isNaN
					{
						itemWidth = this._typicalItem.width;
					}
				}
				else
				{
					itemWidth = this._typicalItem.width;
				}
			}
			else
			{
				itemWidth = items[index].width;
			}

			if(!result)
			{
				result = new Point();
			}

			var rightPosition:Number = maxScrollX - (width - itemWidth);
			if(scrollX >= rightPosition && scrollX <= maxScrollX)
			{
				//keep the current scroll position because the item is already
				//fully visible
				result.x = scrollX;
			}
			else
			{
				var leftDifference:Number = Math.abs(maxScrollX - scrollX);
				var rightDifference:Number = Math.abs(rightPosition - scrollX);
				if(rightDifference < leftDifference)
				{
					result.x = rightPosition;
				}
				else
				{
					result.x = maxScrollX;
				}
			}
			result.y = 0;

			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function calculateNavigationDestination(items:Vector.<DisplayObject>, index:int, keyCode:uint, bounds:LayoutBoundsResult):int
		{
			var itemArrayCount:int = items.length;
			var itemCount:int = itemArrayCount + this._beforeVirtualizedItemCount + this._afterVirtualizedItemCount;
			if(this._useVirtualLayout)
			{
				//if the layout is virtualized, we'll need the dimensions of the
				//typical item so that we have fallback values when an item is null
				this.prepareTypicalItem(bounds.viewPortHeight - this._paddingTop - this._paddingBottom);
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			}

			var result:int = index;
			if(keyCode == Keyboard.HOME)
			{
				if(itemCount > 0)
				{
					result = 0;
				}
			}
			else if(keyCode == Keyboard.END)
			{
				result = itemCount - 1;
			}
			else if(keyCode == Keyboard.PAGE_UP)
			{
				var xPosition:Number = 0;
				var indexOffset:int = 0;
				if(this._useVirtualLayout && this._hasVariableItemDimensions)
				{
					indexOffset = -this._beforeVirtualizedItemCount;
				}
				for(var i:int = index; i >= 0; i--)
				{
					var iNormalized:int = i + indexOffset;
					if(this._useVirtualLayout && this._hasVariableItemDimensions)
					{
						var cachedWidth:Number = this._virtualCache[i];
					}
					if(iNormalized < 0 || iNormalized >= itemArrayCount)
					{
						if(cachedWidth === cachedWidth) //!isNaN
						{
							xPosition += cachedWidth;
						}
						else
						{
							xPosition += calculatedTypicalItemWidth;
						}
					}
					else
					{
						var item:DisplayObject = items[iNormalized];
						if(item === null)
						{
							if(cachedWidth === cachedWidth) //!isNaN
							{
								xPosition += cachedWidth;
							}
							else
							{
								xPosition += calculatedTypicalItemWidth;
							}
						}
						else
						{
							xPosition += item.width;
						}
					}
					if(xPosition > bounds.viewPortWidth)
					{
						break;
					}
					xPosition += this._gap;
					result = i;
				}
			}
			else if(keyCode == Keyboard.PAGE_DOWN)
			{
				xPosition = 0;
				indexOffset = 0;
				if(this._useVirtualLayout && this._hasVariableItemDimensions)
				{
					indexOffset = -this._beforeVirtualizedItemCount;
				}
				for(i = index; i < itemCount; i++)
				{
					iNormalized = i + indexOffset;
					if(this._useVirtualLayout && this._hasVariableItemDimensions)
					{
						cachedWidth = this._virtualCache[i];
					}
					if(iNormalized < 0 || iNormalized >= itemArrayCount)
					{
						if(cachedWidth === cachedWidth) //!isNaN
						{
							xPosition += cachedWidth;
						}
						else
						{
							xPosition += calculatedTypicalItemWidth;
						}
					}
					else
					{
						item = items[iNormalized];
						if(item === null)
						{
							if(cachedWidth === cachedWidth) //!isNaN
							{
								xPosition += cachedWidth;
							}
							else
							{
								xPosition += calculatedTypicalItemWidth;
							}
						}
						else
						{
							xPosition += item.width;
						}
					}
					if(xPosition > bounds.viewPortWidth)
					{
						break;
					}
					xPosition += this._gap;
					result = i;
				}
			}
			else if(keyCode == Keyboard.LEFT)
			{
				result--;
			}
			else if(keyCode == Keyboard.RIGHT)
			{
				result++;
			}
			if(result < 0)
			{
				return 0;
			}
			if(result >= itemCount)
			{
				return itemCount - 1;
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getScrollPositionForIndex(index:int, items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			var maxScrollX:Number = this.calculateMaxScrollXOfIndex(index, items, x, y, width, height);
			if(this._useVirtualLayout)
			{
				if(this._hasVariableItemDimensions)
				{
					var itemWidth:Number = this._virtualCache[index];
					if(itemWidth !== itemWidth) //isNaN
					{
						itemWidth = this._typicalItem.width;
					}
				}
				else
				{
					itemWidth = this._typicalItem.width;
				}
			}
			else
			{
				itemWidth = items[index].width;
			}
			if(this._scrollPositionHorizontalAlign == HorizontalAlign.CENTER)
			{
				maxScrollX -= Math.round((width - itemWidth) / 2);
			}
			else if(this._scrollPositionHorizontalAlign == HorizontalAlign.RIGHT)
			{
				maxScrollX -= (width - itemWidth);
			}
			result.x = maxScrollX;
			result.y = 0;

			return result;
		}

		/**
		 * @private
		 */
		public function positionDropIndicator(dropIndicator:DisplayObject, index:int,
			x:Number, y:Number, items:Vector.<DisplayObject>, width:Number, height:Number):void
		{
			var indexOffset:int = 0;
			var itemCount:int = items.length;
			var totalItemCount:int = itemCount;
			if(this._useVirtualLayout && !this._hasVariableItemDimensions)
			{
				//if the layout is virtualized, and the items all have the same
				//height, we can make our loops smaller by skipping some items
				//at the beginning and end. this improves performance.
				totalItemCount += this._beforeVirtualizedItemCount + this._afterVirtualizedItemCount;
				indexOffset = this._beforeVirtualizedItemCount;
			}
			var indexMinusOffset:int = index - indexOffset;

			if(dropIndicator is IValidating)
			{
				IValidating(dropIndicator).validate();
			}

			dropIndicator.y = this._paddingTop;
			var xPosition:Number = 0;
			if(index < totalItemCount)
			{
				var item:DisplayObject = items[indexMinusOffset];
				xPosition = item.x - dropIndicator.width / 2;
				dropIndicator.y = item.y;
				dropIndicator.height = item.height;
			}
			else //after the last item
			{
				item = items[indexMinusOffset - 1];
				xPosition = item.x + item.width - dropIndicator.width;
				dropIndicator.y = item.y;
				dropIndicator.height = item.height;
			}
			if(xPosition < 0)
			{
				xPosition = 0;
			}
			dropIndicator.x = xPosition;
		}

		/**
		 * @private
		 */
		public function getDropIndex(x:Number, y:Number, items:Vector.<DisplayObject>,
			boundsX:Number, boundsY:Number, width:Number, height:Number):int
		{
			if(this._useVirtualLayout)
			{
				this.prepareTypicalItem(height - this._paddingTop - this._paddingBottom);
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}
			var hasFirstGap:Boolean = this._firstGap === this._firstGap; //!isNaN
			var hasLastGap:Boolean = this._lastGap === this._lastGap; //!isNaN
			var positionX:Number = boundsX + this._paddingLeft;
			var lastWidth:Number = 0;
			var gap:Number = this._gap;
			var indexOffset:int = 0;
			var itemCount:int = items.length;
			var totalItemCount:int = itemCount;
			if(this._useVirtualLayout && !this._hasVariableItemDimensions)
			{
				totalItemCount += this._beforeVirtualizedItemCount + this._afterVirtualizedItemCount;
				indexOffset = this._beforeVirtualizedItemCount;
			}
			var secondToLastIndex:int = totalItemCount - 2;
			for(var i:int = 0; i <= totalItemCount; i++)
			{
				var item:DisplayObject = null;
				var indexMinusOffset:int = i - indexOffset;
				if(indexMinusOffset >= 0 && indexMinusOffset < itemCount)
				{
					item = items[indexMinusOffset];
				}
				if(hasFirstGap && i == 0)
				{
					gap = this._firstGap;
				}
				else if(hasLastGap && i > 0 && i == secondToLastIndex)
				{
					gap = this._lastGap;
				}
				else
				{
					gap = this._gap;
				}
				if(this._useVirtualLayout && this._hasVariableItemDimensions)
				{
					var cachedWidth:Number = this._virtualCache[i];
				}
				if(this._useVirtualLayout && !item)
				{
					if(!this._hasVariableItemDimensions ||
						cachedWidth !== cachedWidth) //isNaN
					{
						lastWidth = calculatedTypicalItemWidth;
					}
					else
					{
						lastWidth = cachedWidth;
					}
				}
				else
				{
					//use the x position of the item to account for horizontal
					//alignment, in case the total width of the items is less
					//than the width of the container
					positionX = item.x;
					var itemWidth:Number = item.width;
					if(this._useVirtualLayout)
					{
						if(this._hasVariableItemDimensions)
						{
							if(itemWidth != cachedWidth)
							{
								this._virtualCache[i] = itemWidth;
								this.dispatchEventWith(Event.CHANGE);
							}
						}
						else if(calculatedTypicalItemWidth >= 0)
						{
							itemWidth = calculatedTypicalItemWidth;
						}
					}
					lastWidth = itemWidth;
				}
				if(x < (positionX + (lastWidth / 2)))
				{
					return i;
				}
				positionX += lastWidth + gap;
			}
			return totalItemCount;
		}

		/**
		 * @private
		 */
		protected function validateItems(items:Vector.<DisplayObject>,
			explicitHeight:Number, minHeight:Number, maxHeight:Number,
			explicitWidth:Number, minWidth:Number, maxWidth:Number, distributedWidth:Number):void
		{
			var needsWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			var needsHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			var containerWidth:Number = explicitWidth;
			if(needsWidth)
			{
				containerWidth = minWidth;
			}
			//if the alignment is justified, then we want to set the height of
			//each item before validating because setting one dimension may
			//cause the other dimension to change, and that will invalidate the
			//layout if it happens after validation, causing more invalidation
			var isJustified:Boolean = this._verticalAlign == VerticalAlign.JUSTIFY;
			var itemCount:int = items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				if(!item || (item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout))
				{
					continue;
				}
				if(this._distributeWidths)
				{
					item.width = distributedWidth;
				}
				if(isJustified)
				{
					//the alignment is justified, but we don't yet have a width
					//to use, so we need to ensure that we accurately measure
					//the items instead of using an old justified height that
					//may be wrong now!
					item.height = explicitHeight;
					if(item is IFeathersControl)
					{
						var feathersItem:IFeathersControl = IFeathersControl(item);
						feathersItem.minHeight = minHeight;
						feathersItem.maxHeight = maxHeight;
					}
				}
				else if(item is ILayoutDisplayObject)
				{
					var layoutItem:ILayoutDisplayObject = ILayoutDisplayObject(item);
					var layoutData:HorizontalLayoutData = layoutItem.layoutData as HorizontalLayoutData;
					if(layoutData !== null)
					{
						var percentWidth:Number = layoutData.percentWidth;
						var percentHeight:Number = layoutData.percentHeight;
						if(percentWidth === percentWidth) //!isNaN
						{
							if(percentWidth < 0)
							{
								percentWidth = 0;
							}
							if(percentWidth > 100)
							{
								percentWidth = 100;
							}
							var itemWidth:Number = containerWidth * percentWidth / 100;
							var measureItem:IMeasureDisplayObject = IMeasureDisplayObject(item);
							var itemExplicitMinWidth:Number = measureItem.explicitMinWidth;
							if(measureItem.explicitMinWidth === measureItem.explicitMinWidth && //!isNaN
								itemWidth < itemExplicitMinWidth)
							{
								itemWidth = itemExplicitMinWidth;
							}
							//validating this component may be expensive if we
							//don't limit the width! we want to ensure that a
							//component like a horizontal list with many item
							//renderers doesn't completely bypass layout
							//virtualization, so we limit the width to the
							//maximum possible value if it were the only item in
							//the layout.
							//this doesn't need to be perfectly accurate because
							//it's just a maximum
							measureItem.maxWidth = itemWidth;
							//we also need to clear the explicit width because,
							//for many components, it will affect the minWidth
							//which is used in the final calculation
							item.width = NaN;
						}
						if(percentHeight === percentHeight) //!isNaN
						{
							if(percentHeight < 0)
							{
								percentHeight = 0;
							}
							if(percentHeight > 100)
							{
								percentHeight = 100;
							}
							var itemHeight:Number = explicitHeight * percentHeight / 100;
							measureItem = IMeasureDisplayObject(item);
							//we use the explicitMinHeight to make an accurate
							//measurement, and we'll use the component's
							//measured minHeight later, after we validate it.
							var itemExplicitMinHeight:Number = measureItem.explicitMinHeight;
							if(measureItem.explicitMinHeight === measureItem.explicitMinHeight && //!isNaN
								itemHeight < itemExplicitMinHeight)
							{
								itemHeight = itemExplicitMinHeight;
							}
							if(itemHeight > maxHeight)
							{
								itemHeight = maxHeight;
							}
							//unlike above, where we set maxWidth, we can set
							//the height explicitly here
							//in fact, it's required because we need to make
							//an accurate measurement of the total view port
							//height
							item.height = itemHeight;
							//if itemWidth is NaN, we need to set a maximum
							//width instead. this is important for items where
							//the height becomes larger when their width becomes
							//smaller (such as word-wrapped text)
							if(measureItem.explicitHeight !== measureItem.explicitHeight && //isNaN
								measureItem.maxHeight > maxHeight)
							{
								measureItem.maxHeight = maxHeight;
							}
						}
					}
				}
				if(item is IValidating)
				{
					IValidating(item).validate();
				}
			}
		}

		/**
		 * @private
		 */
		protected function prepareTypicalItem(justifyHeight:Number):void
		{
			if(!this._typicalItem)
			{
				return;
			}
			if(this._resetTypicalItemDimensionsOnMeasure)
			{
				this._typicalItem.width = this._typicalItemWidth;
			}
			var hasSetHeight:Boolean = false;
			if(this._verticalAlign == VerticalAlign.JUSTIFY &&
				justifyHeight === justifyHeight) //!isNaN
			{
				hasSetHeight = true;
				this._typicalItem.height = justifyHeight;
			}
			else if(this._typicalItem is ILayoutDisplayObject)
			{
				var layoutItem:ILayoutDisplayObject = ILayoutDisplayObject(this._typicalItem);
				var layoutData:VerticalLayoutData = layoutItem.layoutData as VerticalLayoutData;
				if(layoutData !== null)
				{
					var percentHeight:Number = layoutData.percentHeight;
					if(percentHeight === percentHeight) //!isNaN
					{
						if(percentHeight < 0)
						{
							percentHeight = 0;
						}
						if(percentHeight > 100)
						{
							percentHeight = 100;
						}
						hasSetHeight = true;
						this._typicalItem.height = justifyHeight * percentHeight / 100;
					}
				}
			}
			if(!hasSetHeight && this._resetTypicalItemDimensionsOnMeasure)
			{
				this._typicalItem.height = this._typicalItemHeight;
			}
			if(this._typicalItem is IValidating)
			{
				IValidating(this._typicalItem).validate();
			}
		}

		/**
		 * @private
		 */
		protected function calculateDistributedWidth(items:Vector.<DisplayObject>, explicitWidth:Number, minWidth:Number, maxWidth:Number, measureItems:Boolean):Number
		{
			var needsWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			var maxItemWidth:Number = 0;
			var includedItemCount:int = 0;
			var itemCount:int = items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
				{
					continue;
				}
				includedItemCount++;
				var itemWidth:Number = item.width;
				if(itemWidth > maxItemWidth)
				{
					maxItemWidth = itemWidth;
				}
			}
			if(measureItems && needsWidth)
			{
				explicitWidth = maxItemWidth * includedItemCount + this._paddingLeft + this._paddingRight + this._gap * (includedItemCount - 1);
				var needsRecalculation:Boolean = false;
				if(explicitWidth > maxWidth)
				{
					explicitWidth = maxWidth;
					needsRecalculation = true;
				}
				else if(explicitWidth < minWidth)
				{
					explicitWidth = minWidth;
					needsRecalculation = true;
				}
				if(!needsRecalculation)
				{
					return maxItemWidth;
				}
			}
			var availableSpace:Number = explicitWidth;
			if(needsWidth && maxWidth < Number.POSITIVE_INFINITY)
			{
				availableSpace = maxWidth;
			}
			availableSpace = availableSpace - this._paddingLeft - this._paddingRight - this._gap * (includedItemCount - 1);
			if(includedItemCount > 1 && this._firstGap === this._firstGap) //!isNaN
			{
				availableSpace += this._gap - this._firstGap;
			}
			if(includedItemCount > 2 && this._lastGap === this._lastGap) //!isNaN
			{
				availableSpace += this._gap - this._lastGap;
			}
			return availableSpace / includedItemCount;
		}

		/**
		 * @private
		 */
		protected function applyPercentWidths(items:Vector.<DisplayObject>, explicitWidth:Number, minWidth:Number, maxWidth:Number):void
		{
			var remainingWidth:Number = explicitWidth;
			this._discoveredItemsCache.length = 0;
			var totalExplicitWidth:Number = 0;
			var totalMinWidth:Number = 0;
			var totalPercentWidth:Number = 0;
			var itemCount:int = items.length;
			var pushIndex:int = 0;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				if(item is ILayoutDisplayObject)
				{
					var layoutItem:ILayoutDisplayObject = ILayoutDisplayObject(item);
					if(!layoutItem.includeInLayout)
					{
						continue;
					}
					var layoutData:HorizontalLayoutData = layoutItem.layoutData as HorizontalLayoutData;
					if(layoutData)
					{
						var percentWidth:Number = layoutData.percentWidth;
						if(percentWidth === percentWidth) //!isNaN
						{
							if(percentWidth < 0)
							{
								percentWidth = 0;
							}
							if(layoutItem is IFeathersControl)
							{
								var feathersItem:IFeathersControl = IFeathersControl(layoutItem);
								totalMinWidth += feathersItem.minWidth;
							}
							totalPercentWidth += percentWidth;
							totalExplicitWidth += this._gap;
							this._discoveredItemsCache[pushIndex] = item;
							pushIndex++;
							continue;
						}
					}
				}
				totalExplicitWidth += item.width + this._gap;
			}
			totalExplicitWidth -= this._gap;
			if(this._firstGap === this._firstGap && //!isNaN
				itemCount > 1)
			{
				totalExplicitWidth += (this._firstGap - this._gap);
			}
			else if(this._lastGap === this._lastGap //!isNaN
				&& itemCount > 2)
			{
				totalExplicitWidth += (this._lastGap - this._gap);
			}
			totalExplicitWidth += this._paddingLeft + this._paddingRight;
			if(totalPercentWidth < 100)
			{
				totalPercentWidth = 100;
			}
			if(remainingWidth !== remainingWidth) //isNaN
			{
				remainingWidth = totalExplicitWidth + totalMinWidth;
				if(remainingWidth < minWidth)
				{
					remainingWidth = minWidth;
				}
				else if(remainingWidth > maxWidth)
				{
					remainingWidth = maxWidth;
				}
			}
			remainingWidth -= totalExplicitWidth;
			if(remainingWidth < 0)
			{
				remainingWidth = 0;
			}
			do
			{
				var needsAnotherPass:Boolean = false;
				var percentToPixels:Number = remainingWidth / totalPercentWidth;
				for(i = 0; i < pushIndex; i++)
				{
					layoutItem = ILayoutDisplayObject(this._discoveredItemsCache[i]);
					if(!layoutItem)
					{
						continue;
					}
					layoutData = HorizontalLayoutData(layoutItem.layoutData);
					percentWidth = layoutData.percentWidth;
					if(percentWidth < 0)
					{
						percentWidth = 0;
					}
					var itemWidth:Number = percentToPixels * percentWidth;
					if(layoutItem is IFeathersControl)
					{
						feathersItem = IFeathersControl(layoutItem);
						var itemMinWidth:Number = feathersItem.explicitMinWidth;
						if(itemMinWidth > remainingWidth)
						{
							//we try to respect the item's minimum width, but if
							//it's larger than the remaining space, we need to
							//force it to fit
							itemMinWidth = remainingWidth;
						}
						if(itemWidth < itemMinWidth)
						{
							itemWidth = itemMinWidth;
							remainingWidth -= itemWidth;
							totalPercentWidth -= percentWidth;
							this._discoveredItemsCache[i] = null;
							needsAnotherPass = true;
						}
						//we don't check maxWidth here because it is used in
						//validateItems() for performance optimization, so it
						//isn't a real maximum
					}
					layoutItem.width = itemWidth;
					if(layoutItem is IValidating)
					{
						//changing the width of the item may cause its height
						//to change, so we need to validate. the height is
						//needed for measurement.
						IValidating(layoutItem).validate();
					}
				}
			}
			while(needsAnotherPass);
			this._discoveredItemsCache.length = 0;
		}

		/**
		 * @private
		 */
		protected function calculateMaxScrollXOfIndex(index:int, items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number):Number
		{
			if(this._useVirtualLayout)
			{
				this.prepareTypicalItem(height - this._paddingTop - this._paddingBottom);
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var hasFirstGap:Boolean = this._firstGap === this._firstGap; //!isNaN
			var hasLastGap:Boolean = this._lastGap === this._lastGap; //!isNaN
			var positionX:Number = x + this._paddingLeft;
			var lastWidth:Number = 0;
			var gap:Number = this._gap;
			var startIndexOffset:int = 0;
			var endIndexOffset:Number = 0;
			var itemCount:int = items.length;
			var totalItemCount:int = itemCount;
			if(this._useVirtualLayout && !this._hasVariableItemDimensions)
			{
				totalItemCount += this._beforeVirtualizedItemCount + this._afterVirtualizedItemCount;
				if(index < this._beforeVirtualizedItemCount)
				{
					//this makes it skip the loop below
					startIndexOffset = index + 1;
					lastWidth = calculatedTypicalItemWidth;
					gap = this._gap;
				}
				else
				{
					startIndexOffset = this._beforeVirtualizedItemCount;
					endIndexOffset = index - items.length - this._beforeVirtualizedItemCount + 1;
					if(endIndexOffset < 0)
					{
						endIndexOffset = 0;
					}
					positionX += (endIndexOffset * (calculatedTypicalItemWidth + this._gap));
				}
				positionX += (startIndexOffset * (calculatedTypicalItemWidth + this._gap));
			}
			index -= (startIndexOffset + endIndexOffset);
			var secondToLastIndex:int = totalItemCount - 2;
			for(var i:int = 0; i <= index; i++)
			{
				var item:DisplayObject = items[i];
				var iNormalized:int = i + startIndexOffset;
				if(hasFirstGap && iNormalized == 0)
				{
					gap = this._firstGap;
				}
				else if(hasLastGap && iNormalized > 0 && iNormalized == secondToLastIndex)
				{
					gap = this._lastGap;
				}
				else
				{
					gap = this._gap;
				}
				if(this._useVirtualLayout && this._hasVariableItemDimensions)
				{
					var cachedWidth:Number = this._virtualCache[iNormalized];
				}
				if(this._useVirtualLayout && !item)
				{
					if(!this._hasVariableItemDimensions ||
						cachedWidth !== cachedWidth) //isNaN
					{
						lastWidth = calculatedTypicalItemWidth;
					}
					else
					{
						lastWidth = cachedWidth;
					}
				}
				else
				{
					var itemWidth:Number = item.width;
					if(this._useVirtualLayout)
					{
						if(this._hasVariableItemDimensions)
						{
							if(itemWidth != cachedWidth)
							{
								this._virtualCache[iNormalized] = itemWidth;
								this.dispatchEventWith(Event.CHANGE);
							}
						}
						else if(calculatedTypicalItemWidth >= 0)
						{
							item.width = itemWidth = calculatedTypicalItemWidth;
						}
					}
					lastWidth = itemWidth;
				}
				positionX += lastWidth + gap;
			}
			positionX -= (lastWidth + gap);
			return positionX;
		}
	}
}


================================================
FILE: source/feathers/layout/HorizontalLayoutData.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * @inheritDoc
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Extra, optional data used by an <code>HorizontalLayout</code> instance to
	 * position and size a display object.
	 *
	 * @see HorizontalLayout
	 * @see ILayoutDisplayObject
	 *
	 * @productversion Feathers 1.3.0
	 */
	public class HorizontalLayoutData extends EventDispatcher implements ILayoutData
	{
		/**
		 * Constructor.
		 */
		public function HorizontalLayoutData(percentWidth:Number = NaN, percentHeight:Number = NaN)
		{
			this._percentWidth = percentWidth;
			this._percentHeight = percentHeight;
		}

		/**
		 * @private
		 */
		protected var _percentWidth:Number;

		/**
		 * The width of the layout object, as a percentage of the container's
		 * width. The container will calculate the sum of all of its children
		 * with explicit pixel widths, and then the remaining space will be
		 * distributed to children with percent widths.
		 *
		 * <p>A percentage may be specified in the range from <code>0</code>
		 * to <code>100</code>. If the value is set to <code>NaN</code>, this
		 * property is ignored. It will also be ignored when the
		 * <code>useVirtualLayout</code> property of the
		 * <code>HorizontalLayout</code> is set to <code>false</code>.</p>
		 *
		 * @default NaN
		 */
		public function get percentWidth():Number
		{
			return this._percentWidth;
		}

		/**
		 * @private
		 */
		public function set percentWidth(value:Number):void
		{
			if(this._percentWidth == value)
			{
				return;
			}
			this._percentWidth = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _percentHeight:Number;

		/**
		 * The height of the layout object, as a percentage of the container's
		 * height.
		 *
		 * <p>A percentage may be specified in the range from <code>0</code>
		 * to <code>100</code>. If the value is set to <code>NaN</code>, this
		 * property is ignored.</p>
		 *
		 * <p>Performance tip: If all items in your layout will have 100%
		 * height, it's better to set the <code>verticalAlign</code> property of
		 * the <code>HorizontalLayout</code> to
		 * <code>VerticalAlign.JUSTIFY</code>.</p>
		 *
		 * @default NaN
		 *
		 * @see feathers.layout.VerticalAlign.JUSTIFY
		 */
		public function get percentHeight():Number
		{
			return this._percentHeight;
		}

		/**
		 * @private
		 */
		public function set percentHeight(value:Number):void
		{
			if(this._percentHeight == value)
			{
				return;
			}
			this._percentHeight = value;
			this.dispatchEventWith(Event.CHANGE);
		}
	}
}


================================================
FILE: source/feathers/layout/HorizontalSpinnerLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import feathers.core.IFeathersControl;
	import feathers.core.IValidating;
	import feathers.layout.HorizontalAlign;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.ui.Keyboard;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when a property of the layout changes, indicating that a
	 * redraw is probably needed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * For use with the <code>SpinnerList</code> component, positions items from
	 * left to right in a single row and repeats infinitely.
	 *
	 * @see ../../../help/horizontal-spinner-layout.html How to use HorizontalSpinnerLayout with the Feathers SpinnerList component
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class HorizontalSpinnerLayout extends EventDispatcher implements ISpinnerLayout, ITrimmedVirtualLayout
	{
		/**
		 * Constructor.
		 */
		public function HorizontalSpinnerLayout()
		{
			super();
		}

		/**
		 * @private
		 */
		protected var _discoveredItemsCache:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * @private
		 */
		protected var _gap:Number = 0;

		/**
		 * The space, in pixels, between items.
		 *
		 * @default 0
		 */
		public function get gap():Number
		{
			return this._gap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			if(this._gap == value)
			{
				return;
			}
			this._gap = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * Quickly sets all padding properties to the same value. The
		 * <code>padding</code> getter always returns the value of
		 * <code>paddingTop</code>, but the other padding values may be
		 * different.
		 *
		 * @default 0
		 *
		 * @see #paddingTop
		 * @see #paddingBottom
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingBottom = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * The minimum space, in pixels, above the items.
		 *
		 * @default 0
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * The minimum space, in pixels, to the right of the items, if they
		 * do not repeat. If items repeat, <code>paddingRight</code> will
		 * only be used if <code>horizontalAlign</code> is set to
		 * <code>HorizontalAlign.RIGHT</code>. In this case, the first item,
		 * starting from the right, will be offset by the value of
		 * <code>paddingRight</code>.
		 *
		 * @default 0
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * The minimum space, in pixels, below the items.
		 *
		 * @default 0
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * The minimum space, in pixels, to the right of the items, if they
		 * do not repeat. If items repeat, <code>paddingLeft</code> will
		 * only be used if <code>horizontalAlign</code> is set to
		 * <code>HorizontalAlign.LEFT</code>. In this case, the first item,
		 * starting from the left, will be offset by the value of
		 * <code>paddingLeft</code>.
		 *
		 * @default 0
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.CENTER;

		[Inspectable(type="String",enumeration="left,center,right")]
		/**
		 * The alignment of the items horizontally, on the x-axis.
		 *
		 * <p><strong>Note:</strong> The <code>HorizontalAlign.JUSTIFY</code>
		 * constant is not supported.</p>
		 *
		 * @default feathers.layout.HorizontalAlign.CENTER
		 *
		 * @see feathers.layout.HorizontalAlign#LEFT
		 * @see feathers.layout.HorizontalAlign#CENTER
		 * @see feathers.layout.HorizontalAlign#RIGHT
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this._horizontalAlign == value)
			{
				return;
			}
			this._horizontalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.TOP;

		[Inspectable(type="String",enumeration="top,middle,bottom,justify")]
		/**
		 * The alignment of the items vertically, on the y-axis.
		 *
		 * @default feathers.layout.VerticalAlign.TOP
		 *
		 * @see feathers.layout.VerticalAlign#TOP
		 * @see feathers.layout.VerticalAlign#MIDDLE
		 * @see feathers.layout.VerticalAlign#BOTTOM
		 * @see feathers.layout.VerticalAlign#JUSTIFY
		 */
		public function get verticalAlign():String
		{
			return this._verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this._verticalAlign == value)
			{
				return;
			}
			this._verticalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _useVirtualLayout:Boolean = true;

		/**
		 * @inheritDoc
		 *
		 * @default true
		 */
		public function get useVirtualLayout():Boolean
		{
			return this._useVirtualLayout;
		}

		/**
		 * @private
		 */
		public function set useVirtualLayout(value:Boolean):void
		{
			if(this._useVirtualLayout == value)
			{
				return;
			}
			this._useVirtualLayout = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _requestedColumnCount:int = 0;

		/**
		 * Requests that the layout set the view port dimensions to display a
		 * specific number of columns (plus gaps and padding), if possible. If
		 * the explicit width of the view port is set, then this value will be
		 * ignored. If the view port's minimum and/or maximum width are set,
		 * the actual number of visible columns may be adjusted to meet those
		 * requirements. Set this value to <code>0</code> to display as many
		 * columns as possible.
		 *
		 * @default 0
		 */
		public function get requestedColumnCount():int
		{
			return this._requestedColumnCount;
		}

		/**
		 * @private
		 */
		public function set requestedColumnCount(value:int):void
		{
			if(value < 0)
			{
				throw RangeError("requestedColumnCount requires a value >= 0");
			}
			if(this._requestedColumnCount == value)
			{
				return;
			}
			this._requestedColumnCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _beforeVirtualizedItemCount:int = 0;

		/**
		 * @inheritDoc
		 */
		public function get beforeVirtualizedItemCount():int
		{
			return this._beforeVirtualizedItemCount;
		}

		/**
		 * @private
		 */
		public function set beforeVirtualizedItemCount(value:int):void
		{
			if(this._beforeVirtualizedItemCount == value)
			{
				return;
			}
			this._beforeVirtualizedItemCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _afterVirtualizedItemCount:int = 0;

		/**
		 * @inheritDoc
		 */
		public function get afterVirtualizedItemCount():int
		{
			return this._afterVirtualizedItemCount;
		}

		/**
		 * @private
		 */
		public function set afterVirtualizedItemCount(value:int):void
		{
			if(this._afterVirtualizedItemCount == value)
			{
				return;
			}
			this._afterVirtualizedItemCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _typicalItem:DisplayObject;

		/**
		 * @inheritDoc
		 *
		 * @see #resetTypicalItemDimensionsOnMeasure
		 * @see #typicalItemWidth
		 * @see #typicalItemHeight
		 */
		public function get typicalItem():DisplayObject
		{
			return this._typicalItem;
		}

		/**
		 * @private
		 */
		public function set typicalItem(value:DisplayObject):void
		{
			if(this._typicalItem == value)
			{
				return;
			}
			this._typicalItem = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _resetTypicalItemDimensionsOnMeasure:Boolean = false;

		/**
		 * If set to <code>true</code>, the width and height of the
		 * <code>typicalItem</code> will be reset to <code>typicalItemWidth</code>
		 * and <code>typicalItemHeight</code>, respectively, whenever the
		 * typical item needs to be measured. The measured dimensions of the
		 * typical item are used to fill in the blanks of a virtualized layout
		 * for virtual items that don't have their own display objects to
		 * measure yet.
		 *
		 * @default false
		 *
		 * @see #typicalItemWidth
		 * @see #typicalItemHeight
		 * @see #typicalItem
		 */
		public function get resetTypicalItemDimensionsOnMeasure():Boolean
		{
			return this._resetTypicalItemDimensionsOnMeasure;
		}

		/**
		 * @private
		 */
		public function set resetTypicalItemDimensionsOnMeasure(value:Boolean):void
		{
			if(this._resetTypicalItemDimensionsOnMeasure == value)
			{
				return;
			}
			this._resetTypicalItemDimensionsOnMeasure = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _typicalItemWidth:Number = NaN;

		/**
		 * Used to reset the width, in pixels, of the <code>typicalItem</code>
		 * for measurement. The measured dimensions of the typical item are used
		 * to fill in the blanks of a virtualized layout for virtual items that
		 * don't have their own display objects to measure yet.
		 *
		 * <p>This value is only used when <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>true</code>. If <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>false</code>, this value will be ignored and the
		 * <code>typicalItem</code> dimensions will not be reset before
		 * measurement.</p>
		 *
		 * <p>If <code>typicalItemWidth</code> is set to <code>NaN</code>, the
		 * typical item will auto-size itself to its preferred width. If you
		 * pass a valid <code>Number</code> value, the typical item's width will
		 * be set to a fixed size. May be used in combination with
		 * <code>typicalItemHeight</code>.</p>
		 *
		 * @default NaN
		 *
		 * @see #resetTypicalItemDimensionsOnMeasure
		 * @see #typicalItemHeight
		 * @see #typicalItem
		 */
		public function get typicalItemWidth():Number
		{
			return this._typicalItemWidth;
		}

		/**
		 * @private
		 */
		public function set typicalItemWidth(value:Number):void
		{
			if(this._typicalItemWidth == value)
			{
				return;
			}
			this._typicalItemWidth = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _typicalItemHeight:Number = NaN;

		/**
		 * Used to reset the height, in pixels, of the <code>typicalItem</code>
		 * for measurement. The measured dimensions of the typical item are used
		 * to fill in the blanks of a virtualized layout for virtual items that
		 * don't have their own display objects to measure yet.
		 *
		 * <p>This value is only used when <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>true</code>. If <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>false</code>, this value will be ignored and the
		 * <code>typicalItem</code> dimensions will not be reset before
		 * measurement.</p>
		 *
		 * <p>If <code>typicalItemHeight</code> is set to <code>NaN</code>, the
		 * typical item will auto-size itself to its preferred height. If you
		 * pass a valid <code>Number</code> value, the typical item's height will
		 * be set to a fixed size. May be used in combination with
		 * <code>typicalItemWidth</code>.</p>
		 *
		 * @default NaN
		 *
		 * @see #resetTypicalItemDimensionsOnMeasure
		 * @see #typicalItemWidth
		 * @see #typicalItem
		 */
		public function get typicalItemHeight():Number
		{
			return this._typicalItemHeight;
		}

		/**
		 * @private
		 */
		public function set typicalItemHeight(value:Number):void
		{
			if(this._typicalItemHeight == value)
			{
				return;
			}
			this._typicalItemHeight = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _repeatItems:Boolean = true;

		/**
		 * If set to <code>true</code>, the layout will repeat the items
		 * infinitely, if there are enough items to allow this behavior. If the
		 * total width of the items is smaller than the width of the view port,
		 * the items cannot repeat.
		 *
		 * @default true
		 */
		public function get repeatItems():Boolean
		{
			return this._repeatItems;
		}

		/**
		 * @private
		 */
		public function set repeatItems(value:Boolean):void
		{
			if(this._repeatItems == value)
			{
				return;
			}
			this._repeatItems = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.layout.ISpinnerLayout#snapInterval
		 */
		public function get snapInterval():Number
		{
			if(this._typicalItem === null)
			{
				return 0;
			}
			return this._typicalItem.width + this._gap;
		}

		/**
		 * @inheritDoc
		 */
		public function get requiresLayoutOnScroll():Boolean
		{
			return true;
		}

		/**
		 * @private
		 */
		protected var _selectionBounds:Rectangle = new Rectangle();

		/**
		 * @inheritDoc
		 */
		public function get selectionBounds():Rectangle
		{
			return this._selectionBounds;
		}

		/**
		 * @inheritDoc
		 */
		public function layout(items:Vector.<DisplayObject>, viewPortBounds:ViewPortBounds = null, result:LayoutBoundsResult = null):LayoutBoundsResult
		{
			//this function is very long because it may be called every frame,
			//in some situations. testing revealed that splitting this function
			//into separate, smaller functions affected performance.
			//since the SWC compiler cannot inline functions, we can't use that
			//feature either.

			//since viewPortBounds can be null, we may need to provide some defaults
			var scrollX:Number = viewPortBounds ? viewPortBounds.scrollX : 0;
			var scrollY:Number = viewPortBounds ? viewPortBounds.scrollY : 0;
			var boundsX:Number = viewPortBounds ? viewPortBounds.x : 0;
			var boundsY:Number = viewPortBounds ? viewPortBounds.y : 0;
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;
			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;

			if(this._useVirtualLayout)
			{
				//if the layout is virtualized, we'll need the dimensions of the
				//typical item so that we have fallback values when an item is null
				this.prepareTypicalItem(explicitHeight - this._paddingTop - this._paddingBottom);
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			if(!this._useVirtualLayout || this._verticalAlign != VerticalAlign.JUSTIFY ||
				explicitHeight !== explicitHeight) //isNaN
			{
				//in some cases, we may need to validate all of the items so
				//that we can use their dimensions below.
				this.validateItems(items, explicitWidth, explicitHeight - this._paddingTop - this._paddingBottom);
			}

			//this section prepares some variables needed for the following loop
			var maxItemHeight:Number = this._useVirtualLayout ? calculatedTypicalItemHeight : 0;
			var positionX:Number = boundsX;
			var gap:Number = this._gap;
			var itemCount:int = items.length;
			var totalItemCount:int = itemCount;
			if(this._useVirtualLayout)
			{
				//if the layout is virtualized, and the items all have the same
				//width, we can make our loops smaller by skipping some items
				//at the beginning and end. this improves performance.

				if(this._beforeVirtualizedItemCount > 0)
				{
					//this value may be negative, which means that we're
					//repeating items. we don't want to include this value in
					//the total count, but we'll use it elsewhere.
					totalItemCount += this._beforeVirtualizedItemCount;
				}
				totalItemCount += this._afterVirtualizedItemCount;
				positionX += (this._beforeVirtualizedItemCount * (calculatedTypicalItemWidth + gap));
			}
			//this cache is used to save non-null items in virtual layouts. by
			//using a smaller array, we can improve performance by spending less
			//time in the upcoming loops.
			this._discoveredItemsCache.length = 0;
			var discoveredItemsCacheLastIndex:int = 0;

			//this first loop sets the x position of items, and it calculates
			//the total width of all items
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				if(item)
				{
					//we get here if the item isn't null. it is never null if
					//the layout isn't virtualized.
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					item.x = item.pivotX + positionX;
					item.width = calculatedTypicalItemWidth;
					var itemHeight:Number = item.height;
					//we compare with > instead of Math.max() because the rest
					//arguments on Math.max() cause extra garbage collection and
					//hurt performance
					if(itemHeight > maxItemHeight)
					{
						//we need to know the maximum height of the items in the
						//case where the height of the view port needs to be
						//calculated by the layout.
						maxItemHeight = itemHeight;
					}
					if(this._useVirtualLayout)
					{
						this._discoveredItemsCache[discoveredItemsCacheLastIndex] = item;
						discoveredItemsCacheLastIndex++;
					}
				}
				positionX += calculatedTypicalItemWidth + gap;
			}
			if(this._useVirtualLayout)
			{
				//finish the final calculation of the x position so that it can
				//be used for the total width of all items
				positionX += (this._afterVirtualizedItemCount * (calculatedTypicalItemWidth + gap));
			}

			//this array will contain all items that are not null. see the
			//comment above where the discoveredItemsCache is initialized for
			//details about why this is important.
			var discoveredItems:Vector.<DisplayObject> = this._useVirtualLayout ? this._discoveredItemsCache : items;
			var discoveredItemCount:int = discoveredItems.length;

			var totalHeight:Number = maxItemHeight + this._paddingTop + this._paddingBottom;
			//the available height is the height of the viewport. if the explicit
			//height is NaN, we need to calculate the viewport height ourselves
			//based on the total height of all items.
			var availableHeight:Number = explicitHeight;
			if(availableHeight !== availableHeight) //isNaN
			{
				availableHeight = totalHeight;
				if(availableHeight < minHeight)
				{
					availableHeight = minHeight;
				}
				else if(availableHeight > maxHeight)
				{
					availableHeight = maxHeight;
				}
			}

			//this is the total width of all items
			var totalWidth:Number = positionX - gap - boundsX;
			if(this._useVirtualLayout && this._beforeVirtualizedItemCount < 0)
			{
				totalWidth -= (this._beforeVirtualizedItemCount * (calculatedTypicalItemWidth + gap));
			}
			//the available width is the width of the viewport. if the explicit
			//width is NaN, we need to calculate the viewport width ourselves
			//based on the total width of all items.
			var availableWidth:Number = explicitWidth;
			if(availableWidth !== availableWidth) //isNaN
			{
				if(this._requestedColumnCount > 0)
				{
					availableWidth = this._requestedColumnCount * (calculatedTypicalItemWidth + gap) - gap;
				}
				else
				{
					availableWidth = totalWidth;
				}
				if(availableWidth < minWidth)
				{
					availableWidth = minWidth;
				}
				else if(availableWidth > maxWidth)
				{
					availableWidth = maxWidth;
				}
			}

			//we add one extra here because the first item renderer in view may
			//be partially obscured, which would reveal an extra item renderer.
			var maxVisibleTypicalItemCount:int = Math.ceil(availableWidth / (calculatedTypicalItemWidth + gap)) + 1;
			var minTotalWidthForRepeat:Number = maxVisibleTypicalItemCount * (calculatedTypicalItemWidth + gap) - gap;
			var canRepeatItems:Boolean = this._repeatItems && totalWidth >= minTotalWidthForRepeat;
			if(canRepeatItems)
			{
				totalWidth += gap;
			}

			//in this section, we handle horizontal alignment
			var horizontalAlignOffsetX:Number = this._paddingLeft;
			if(this._horizontalAlign === HorizontalAlign.RIGHT)
			{
				horizontalAlignOffsetX = availableWidth - this._paddingRight - calculatedTypicalItemWidth;
			}
			else if(this._horizontalAlign === HorizontalAlign.CENTER)
			{
				horizontalAlignOffsetX = this._paddingLeft + Math.round((availableWidth - this._paddingLeft - this._paddingRight - calculatedTypicalItemWidth) / 2);
			}
			if(!canRepeatItems)
			{
				totalWidth += horizontalAlignOffsetX + (availableWidth - calculatedTypicalItemWidth - horizontalAlignOffsetX);
			}
			if(horizontalAlignOffsetX != 0)
			{
				for(i = 0; i < discoveredItemCount; i++)
				{
					item = discoveredItems[i];
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					item.x += horizontalAlignOffsetX;
				}
			}

			for(i = 0; i < discoveredItemCount; i++)
			{
				item = discoveredItems[i];
				var layoutItem:ILayoutDisplayObject = item as ILayoutDisplayObject;
				if(layoutItem && !layoutItem.includeInLayout)
				{
					continue;
				}

				//if we're repeating items, then we may need to adjust the x
				//position of some items so that they appear inside the viewport
				if(canRepeatItems)
				{
					var adjustedScrollX:Number = scrollX - horizontalAlignOffsetX;
					if(adjustedScrollX > 0)
					{
						var multiplier:int = int((adjustedScrollX + availableWidth) / totalWidth);
						if(useVirtualLayout && this._beforeVirtualizedItemCount < 0)
						{
							multiplier++;
						}
						item.x += totalWidth * multiplier;
						if(item.x >= (scrollX + availableWidth))
						{
							item.x -= totalWidth;
						}
					}
					else if(adjustedScrollX < 0)
					{
						item.x += totalWidth * (int(adjustedScrollX / totalWidth) - 1);
						if((item.x + item.width) < scrollX)
						{
							item.x += totalWidth;
						}
					}
				}

				//in this section, we handle vertical alignment
				if(this._verticalAlign == VerticalAlign.JUSTIFY)
				{
					//if we justify items vertically, we can skip percent height
					item.y = item.pivotY + boundsY + this._paddingTop;
					item.height = availableHeight - this._paddingTop - this._paddingBottom;
				}
				else
				{
					//handle all other vertical alignment values (we handled
					//justify already). the y position of all items is set here.
					var verticalAlignHeight:Number = availableHeight;
					if(totalHeight > verticalAlignHeight)
					{
						verticalAlignHeight = totalHeight;
					}
					switch(this._verticalAlign)
					{
						case VerticalAlign.BOTTOM:
						{
							item.y = item.pivotY + boundsY + verticalAlignHeight - this._paddingBottom - item.height;
							break;
						}
						case VerticalAlign.MIDDLE:
						{
							//round to the nearest pixel when dividing by 2 to
							//align in the middle
							item.y = item.pivotY + boundsY + this._paddingTop + Math.round((verticalAlignHeight - this._paddingTop - this._paddingBottom - item.height) / 2);
							break;
						}
						default: //top
						{
							item.y = item.pivotY + boundsY + this._paddingTop;
						}
					}
				}
			}
			//we don't want to keep a reference to any of the items, so clear
			//this cache
			this._discoveredItemsCache.length = 0;

			//calculate the bounds of the selection rectangle
			this._selectionBounds.x = horizontalAlignOffsetX;
			this._selectionBounds.y = 0;
			this._selectionBounds.width = calculatedTypicalItemWidth;
			this._selectionBounds.height = availableHeight;

			//finally, we want to calculate the result so that the container
			//can use it to adjust its viewport and determine the minimum and
			//maximum scroll positions (if needed)
			if(!result)
			{
				result = new LayoutBoundsResult();
			}
			if(canRepeatItems)
			{
				result.contentX = Number.NEGATIVE_INFINITY;
				result.contentWidth = Number.POSITIVE_INFINITY;
			}
			else
			{
				result.contentX = 0;
				result.contentWidth = totalWidth;
			}
			result.contentY = 0;
			result.contentHeight = this._verticalAlign == VerticalAlign.JUSTIFY ? availableHeight : totalHeight;
			result.viewPortWidth = availableWidth;
			result.viewPortHeight = availableHeight;
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function measureViewPort(itemCount:int, viewPortBounds:ViewPortBounds = null, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("measureViewPort() may be called only if useVirtualLayout is true.");
			}

			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;
			var needsWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			var needsHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			if(!needsWidth && !needsHeight)
			{
				result.x = explicitWidth;
				result.y = explicitHeight;
				return result;
			}
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;

			this.prepareTypicalItem(explicitHeight - this._paddingTop - this._paddingBottom);
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var gap:Number = this._gap;
			var positionX:Number = 0;

			var maxItemHeight:Number = calculatedTypicalItemHeight;
			positionX += ((calculatedTypicalItemWidth + gap) * itemCount);
			positionX -= gap;

			if(needsWidth)
			{
				if(this._requestedColumnCount > 0)
				{
					var resultWidth:Number = (calculatedTypicalItemWidth + gap) * this._requestedColumnCount - gap;
				}
				else
				{
					resultWidth = positionX;
				}
				if(resultWidth < minWidth)
				{
					resultWidth = minWidth;
				}
				else if(resultWidth > maxWidth)
				{
					resultWidth = maxWidth;
				}
				result.x = resultWidth;
			}
			else
			{
				result.x = explicitWidth;
			}

			if(needsHeight)
			{
				var resultHeight:Number = maxItemHeight + this._paddingTop + this._paddingBottom;
				if(resultHeight < minHeight)
				{
					resultHeight = minHeight;
				}
				else if(resultHeight > maxHeight)
				{
					resultHeight = maxHeight;
				}
				result.y = resultHeight;
			}
			else
			{
				result.y = explicitHeight;
			}

			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getVisibleIndicesAtScrollPosition(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int> = null):Vector.<int>
		{
			if(result)
			{
				result.length = 0;
			}
			else
			{
				result = new <int>[];
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("getVisibleIndicesAtScrollPosition() may be called only if useVirtualLayout is true.");
			}

			this.prepareTypicalItem(height - this._paddingTop - this._paddingBottom);
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var gap:Number = this._gap;

			var resultLastIndex:int = 0;

			var totalItemWidth:Number = itemCount * (calculatedTypicalItemWidth + gap) - gap;

			//the actual code that figures out which items are visible assumes
			//that alignment is left. to make it work with other alignments, we
			//can simply adjust the scroll position!
			if(this._horizontalAlign === HorizontalAlign.CENTER)
			{
				scrollX -= (this._paddingLeft + Math.round((width - calculatedTypicalItemWidth) / 2));
			}
			else if(this._horizontalAlign === HorizontalAlign.RIGHT)
			{
				scrollX -= (width - calculatedTypicalItemWidth - this._paddingRight);
			}
			else //left
			{
				scrollX -= this._paddingLeft;
			}

			//we add one extra here because the first item renderer in view may
			//be partially obscured, which would reveal an extra item renderer.
			var maxVisibleTypicalItemCount:int = Math.ceil(width / (calculatedTypicalItemWidth + gap)) + 1;
			var minTotalWidthForRepeat:Number = maxVisibleTypicalItemCount * (calculatedTypicalItemWidth + gap) - gap;
			var canRepeatItems:Boolean = this._repeatItems && totalItemWidth >= minTotalWidthForRepeat;
			if(canRepeatItems)
			{
				//if we're repeating, then there's an extra gap
				totalItemWidth += gap;
				scrollX %= totalItemWidth;
				if(scrollX < 0)
				{
					scrollX += totalItemWidth;
				}
				var minimum:int = scrollX / (calculatedTypicalItemWidth + gap);
				var maximum:int = minimum + maxVisibleTypicalItemCount;
			}
			else
			{
				minimum = scrollX / (calculatedTypicalItemWidth + gap);
				if(minimum < 0)
				{
					minimum = 0;
				}
				//if we're scrolling beyond the final item, we should keep the
				//indices consistent so that items aren't destroyed and
				//recreated unnecessarily
				maximum = minimum + maxVisibleTypicalItemCount;
				if(maximum >= itemCount)
				{
					maximum = itemCount - 1;
				}
				minimum = maximum - maxVisibleTypicalItemCount;
				if(minimum < 0)
				{
					minimum = 0;
				}
			}
			for(var i:int = minimum; i <= maximum; i++)
			{
				if(!canRepeatItems || (i >= 0 && i < itemCount))
				{
					result[resultLastIndex] = i;
				}
				else if(i < 0)
				{
					result[resultLastIndex] = itemCount + i;
				}
				else if(i >= itemCount)
				{
					var loopedI:int = i - itemCount;
					if(loopedI == minimum)
					{
						//we don't want to repeat items!
						break;
					}
					result[resultLastIndex] = loopedI;
				}
				resultLastIndex++;
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function calculateNavigationDestination(items:Vector.<DisplayObject>, index:int, keyCode:uint, bounds:LayoutBoundsResult):int
		{
			var itemArrayCount:int = items.length;
			var itemCount:int = itemArrayCount + this._afterVirtualizedItemCount;
			if(this._beforeVirtualizedItemCount > 0)
			{
				itemCount += this._beforeVirtualizedItemCount;
			}

			var result:int = index;
			if(keyCode == Keyboard.HOME)
			{
				if(itemCount > 0)
				{
					result = 0;
				}
			}
			else if(keyCode == Keyboard.END)
			{
				result = itemCount - 1;
			}
			else if(keyCode == Keyboard.PAGE_UP)
			{
				var xPosition:Number = 0;
				for(var i:int = index; i >= 0; i--)
				{
					xPosition += this.snapInterval;
					if(xPosition > bounds.viewPortWidth)
					{
						break;
					}
					xPosition += this._gap;
					result = i;
				}
			}
			else if(keyCode == Keyboard.PAGE_DOWN)
			{
				xPosition = 0;
				for(i = index; i < itemCount; i++)
				{
					xPosition += this.snapInterval;
					if(xPosition > bounds.viewPortWidth)
					{
						break;
					}
					xPosition += this._gap;
					result = i;
				}
			}
			else if(keyCode == Keyboard.LEFT)
			{
				result--;
			}
			else if(keyCode == Keyboard.RIGHT)
			{
				result++;
			}
			var canRepeatItems:Boolean = this._repeatItems && bounds.contentWidth == Number.POSITIVE_INFINITY;
			if(canRepeatItems)
			{
				while(result < 0)
				{
					result += itemCount;
				}
				while(result >= itemCount)
				{
					result -= itemCount;
				}
			}
			else if(result < 0)
			{
				return 0;
			}
			if(result >= itemCount)
			{
				return itemCount - 1;
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getNearestScrollPositionForIndex(index:int, scrollX:Number, scrollY:Number, items:Vector.<DisplayObject>,
			x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			//normally, this isn't acceptable, but because the selection is
			//based on the scroll position, it must work this way.
			return this.getScrollPositionForIndex(index, items, x, y, width, height, result);
		}

		/**
		 * @inheritDoc
		 */
		public function getScrollPositionForIndex(index:int, items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			this.prepareTypicalItem(height - this._paddingTop - this._paddingBottom);
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			if(!result)
			{
				result = new Point();
			}
			result.x = 0;
			result.y = calculatedTypicalItemHeight * index;
			return result;
		}

		/**
		 * @private
		 */
		protected function validateItems(items:Vector.<DisplayObject>, distributedWidth:Number, justifyHeight:Number):void
		{
			//if the alignment is justified, then we want to set the height of
			//each item before validating because setting one dimension may
			//cause the other dimension to change, and that will invalidate the
			//layout if it happens after validation, causing more invalidation
			var isJustified:Boolean = this._verticalAlign == VerticalAlign.JUSTIFY;
			var mustSetJustifyHeight:Boolean = isJustified && justifyHeight === justifyHeight; //!isNaN
			var itemCount:int = items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				if(!item || (item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout))
				{
					continue;
				}
				if(mustSetJustifyHeight)
				{
					item.height = justifyHeight;
				}
				else if(isJustified && item is IFeathersControl)
				{
					//the alignment is justified, but we don't yet have a height
					//to use, so we need to ensure that we accurately measure
					//the items instead of using an old justified height that
					//may be wrong now!
					item.height = NaN;
				}
				if(item is IValidating)
				{
					IValidating(item).validate();
				}
			}
		}

		/**
		 * @private
		 */
		protected function prepareTypicalItem(justifyHeight:Number):void
		{
			if(!this._typicalItem)
			{
				return;
			}
			if(this._resetTypicalItemDimensionsOnMeasure)
			{
				this._typicalItem.width = this._typicalItemWidth;
			}
			if(this._verticalAlign == VerticalAlign.JUSTIFY &&
				justifyHeight === justifyHeight) //!isNaN
			{
				this._typicalItem.height = justifyHeight;
			}
			else if(this._resetTypicalItemDimensionsOnMeasure)
			{
				this._typicalItem.height = this._typicalItemHeight;
			}
			if(this._typicalItem is IValidating)
			{
				IValidating(this._typicalItem).validate();
			}
		}
	}
}


================================================
FILE: source/feathers/layout/IDragDropLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import starling.display.DisplayObject;

	/**
	 * Methods for layouts that support drag and drop.
	 */
	public interface IDragDropLayout extends ILayout
	{
		/**
		 * Returns the index of the item if it were dropped at the specified
		 * location.
		 */
		function getDropIndex(x:Number, y:Number, items:Vector.<DisplayObject>,
			boundsX:Number, boundsY:Number, width:Number, height:Number):int;

		/**
		 * Positions the drop indicator in the layout. Must be called after
		 * <code>layout()</code>.
		 */
		function positionDropIndicator(dropIndicator:DisplayObject, index:int,
			x:Number, y:Number, items:Vector.<DisplayObject>, width:Number, height:Number):void;
	}
}

================================================
FILE: source/feathers/layout/IGroupedLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	/**
	 * A layout where items are divided into separate groups, with headers for
	 * each group.
	 *
	 * @see feathers.controls.GroupedList
	 *
	 * @productversion Feathers 2.3.0
	 */
	public interface IGroupedLayout extends ILayout
	{
		/**
		 * Used internally by a component with grouped data to indicate which
		 * indices are headers for a group.
		 */
		function get headerIndices():Vector.<int>;

		/**
		 * @private
		 */
		function set headerIndices(value:Vector.<int>):void;
	}
}


================================================
FILE: source/feathers/layout/ILayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import feathers.core.IFeathersEventDispatcher;

	import flash.geom.Point;

	import starling.display.DisplayObject;

	/**
	 * Dispatched when a property of the layout changes, indicating that a
	 * redraw is probably needed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Interface providing layout capabilities for containers.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface ILayout extends IFeathersEventDispatcher
	{
		/**
		 * Determines if the container calls <code>layout()</code> when the
		 * scroll position changes. Useful for transforming items as the view
		 * port scrolls. This value should be <code>true</code> for layouts that
		 * implement the <code>IVirtualLayout</code> interface and the
		 * <code>useVirtualLayout</code> property is set to <code>true</code>.
		 * May also be used by layouts that toggle item visibility as the items
		 * scroll into and out of the view port.
		 */
		function get requiresLayoutOnScroll():Boolean;

		/**
		 * Positions (and possibly resizes) the supplied items within the
		 * optional bounds argument. If no bounds are specified, the layout
		 * algorithm will assume that the bounds start a 0,0 and have unbounded
		 * dimensions. Returns the actual bounds of the content, which may
		 * be different than the specified bounds.
		 *
		 * <p>Note: The items are <strong>not</strong> absolutely
		 * restricted to appear only within the bounds. The bounds can affect
		 * positioning, but the algorithm may very well ignore them completely.</p>
		 *
		 * <p>If a layout implementation needs to access accurate <code>width</code>
		 * and <code>height</code> values from items that are of type
		 * <code>IFeathersControl</code>, it must call <code>validate()</code>
		 * manually. For performance reasons, the container that is the parent
		 * of the items will not call <code>validate()</code> before passing the
		 * items to a layout implementation. Meeting this requirement may be as
		 * simple as looping through the items at the beginning of
		 * <code>layout()</code> and validating all items that are Feathers UI
		 * controls:</p>
		 *
		 * <listing version="3.0">
		 * const itemCount:int = items.length;
		 * for(var i:int = 0; i &lt; itemCount; i++)
		 * {
		 *     var item:IFeathersControl = items[i] as IFeathersControl;
		 *     if(item)
		 *     {
		 *         item.validate();
		 *     }
		 * }</listing>
		 *
		 * @see feathers.core.FeathersControl#validate()
		 */
		function layout(items:Vector.<DisplayObject>, viewPortBounds:ViewPortBounds = null, result:LayoutBoundsResult = null):LayoutBoundsResult;

		/**
		 * Using the current index and a key press, calculates the new index.
		 * This might be use to change a list's <code>selectedIndex</code> when
		 * a key is pressed.
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/ui/Keyboard.html#UP flash.ui.Keyboard.UP
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/ui/Keyboard.html#DOWN flash.ui.Keyboard.DOWN
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/ui/Keyboard.html#LEFT flash.ui.Keyboard.LEFT
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/ui/Keyboard.html#RIGHT flash.ui.Keyboard.RIGHT
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/ui/Keyboard.html#HOME flash.ui.Keyboard.HOME
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/ui/Keyboard.html#END flash.ui.Keyboard.END
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/ui/Keyboard.html#PAGE_UP flash.ui.Keyboard.PAGE_UP
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/ui/Keyboard.html#PAGE_DOWN flash.ui.Keyboard.PAGE_DOWN
		 */
		function calculateNavigationDestination(items:Vector.<DisplayObject>, index:int, keyCode:uint, bounds:LayoutBoundsResult):int;

		/**
		 * Using the item dimensions, calculates a scroll position that will
		 * ensure that the item at a given index will be visible within the
		 * specified bounds.
		 *
		 * <p>Typically, this function is used to show the item in the most
		 * prominent way, such as centering. To scroll a minimum distance
		 * required to display the full bounds of the item in the view port,
		 * use <code>getNearestScrollPositionForIndex()</code> instead.</p>
		 *
		 * <p>This function should always be called <em>after</em> the
		 * <code>layout()</code> function. The width and height arguments are
		 * the final bounds of the view port, which may be calculated in the
		 * layout() function.</p>
		 *
		 * @see #getNearestScrollPositionForIndex()
		 */
		function getScrollPositionForIndex(index:int, items:Vector.<DisplayObject>,
			x:Number, y:Number, width:Number, height:Number, result:Point = null):Point;

		/**
		 * Calculates the scroll position nearest to the current scroll position
		 * that will display the full bounds of the item within the view port.
		 * If the item is already fully displayed in the view port, the current
		 * scroll position will be returned unchanged.
		 *
		 * <p>While the item will be displayed in the view port without being
		 * clipped in any way, it may not be placed in the most prominent
		 * position possible. To give the item a more prominent location, use
		 * <code>getScrollPositionForIndex()</code> instead.</p>
		 *
		 * <p>This function should always be called <em>after</em> the
		 * <code>layout()</code> function. The width and height arguments are
		 * the final bounds of the view port, which may be calculated in the
		 * layout() function.</p>
		 *
		 * @see #getScrollPositionForIndex()
		 */
		function getNearestScrollPositionForIndex(index:int, scrollX:Number, scrollY:Number,
			items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point = null):Point;
	}
}


================================================
FILE: source/feathers/layout/ILayoutData.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import feathers.core.IFeathersEventDispatcher;

	/**
	 * Dispatched when a property of the layout data changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Extra data used by layout algorithms.
	 *
	 * @productversion Feathers 1.1.0
	 */
	public interface ILayoutData extends IFeathersEventDispatcher
	{
	}
}


================================================
FILE: source/feathers/layout/ILayoutDisplayObject.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import feathers.core.IFeathersDisplayObject;

	/**
	 * Dispatched when a property of the display object's layout data changes.
	 *
	 * @eventType feathers.events.FeathersEventType.LAYOUT_DATA_CHANGE
	 */
	[Event(name="layoutDataChange",type="starling.events.Event")]

	/**
	 * A display object that may be associated with extra data for use with
	 * advanced layouts.
	 *
	 * @productversion Feathers 1.1.0
	 */
	public interface ILayoutDisplayObject extends IFeathersDisplayObject
	{
		/**
		 * Extra parameters associated with this display object that will be
		 * used by the layout algorithm.
		 */
		function get layoutData():ILayoutData;

		/**
		 * @private
		 */
		function set layoutData(value:ILayoutData):void;

		/**
		 * Determines if the ILayout should use this object or ignore it.
		 *
		 * <p>In the following example, the display object is excluded from
		 * the layout:</p>
		 *
		 * <listing version="3.0">
		 * object.includeInLayout = false;</listing>
		 */
		function get includeInLayout():Boolean;

		/**
		 * @private
		 */
		function set includeInLayout(value:Boolean):void;
	}
}


================================================
FILE: source/feathers/layout/ISpinnerLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import flash.geom.Rectangle;

	/**
	 * A layout for the <code>SpinnerList</code> component.
	 *
	 * @see feathers.controls.SpinnerList
	 *
	 * @productversion Feathers 2.1.0
	 */
	public interface ISpinnerLayout extends ILayout
	{
		/**
		 * The interval, in pixels, between snapping points.
		 */
		function get snapInterval():Number;

		/**
		 * A rectangle indicating the bounds of the selected item. Used by the
		 * <code>SpinnerList</code> to position its selection overlay skin.
		 */
		function get selectionBounds():Rectangle;
	}
}


================================================
FILE: source/feathers/layout/ITrimmedVirtualLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	/**
	 * Optimizes a virtual layout by skipping a specific number of items before
	 * and after the set that is passed to <code>layout()</code>.
	 *
	 * @productversion Feathers 1.1.0
	 */
	public interface ITrimmedVirtualLayout extends IVirtualLayout
	{
		/**
		 * Used internally by a component, such as <code>List</code>, to set the
		 * number of virtualized items that appear before the items passed to
		 * <code>layout()</code>. Allows the array of items to be smaller than
		 * the full size. Does not work if the layout has variable item
		 * dimensions.
		 *
		 * <p>This property is meant to be set by the <code>List</code> or other
		 * component that uses the virtual layout. If you're simply creating
		 * a layout for a <code>List</code> or another component, do not use
		 * this property. It is meant for developers creating custom components
		 * only.</p>
		 */
		function get beforeVirtualizedItemCount():int;

		/**
		 * @private
		 */
		function set beforeVirtualizedItemCount(value:int):void;

		/**
		 * Used internally by a component, such as <code>List</code>, to set the
		 * number of virtualized items that appear after the items passed to
		 * <code>layout()</code>. Allows the array of items to be smaller than
		 * the full size. Does not work if the layout has variable item
		 * dimensions.
		 *
		 * <p>This property is meant to be set by the <code>List</code> or other
		 * component that uses the virtual layout. If you're simply creating
		 * a layout for a <code>List</code> or another component, do not use
		 * this property. It is meant for developers creating custom components
		 * only.</p>
		 */
		function get afterVirtualizedItemCount():int;

		/**
		 * @private
		 */
		function set afterVirtualizedItemCount(value:int):void;
	}
}


================================================
FILE: source/feathers/layout/IVariableVirtualLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import starling.display.DisplayObject;

	/**
	 * Dispatched when the layout would like to adjust the container's scroll
	 * position. Typically, this is used when the virtual dimensions of an item
	 * differ from its real dimensions. This event allows the container to
	 * adjust scrolling so that it appears smooth, without jarring jumps or
	 * shifts when an item resizes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>A <code>flash.geom.Point</code> object
	 *   representing how much the scroll position should be adjusted in both
	 *   horizontal and vertical directions. Measured in pixels.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.SCROLL
	 */
	[Event(name="scroll",type="starling.events.Event")]

	/**
	 * A virtual layout that supports variable item dimensions.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface IVariableVirtualLayout extends IVirtualLayout
	{
		/**
		 * When the layout is virtualized, and this value is true, the items may
		 * have variable dimensions. If false, the items will all share the
		 * same dimensions as the typical item. Performance is better for
		 * layouts where all items have the same dimensions.
		 */
		function get hasVariableItemDimensions():Boolean;

		/**
		 * @private
		 */
		function set hasVariableItemDimensions(value:Boolean):void;

		/**
		 * Clears the cached dimensions for all virtualized indices.
		 */
		function resetVariableVirtualCache():void;

		/**
		 * Clears the cached dimensions for one specific virtualized index.
		 */
		function resetVariableVirtualCacheAtIndex(index:int, item:DisplayObject = null):void;

		/**
		 * Inserts an item in to the cache at the specified index, pushing the
		 * old cached value at that index, and all following values, up one
		 * index.
		 */
		function addToVariableVirtualCacheAtIndex(index:int, item:DisplayObject = null):void;

		/**
		 * Removes an item in to the cache at the specified index, moving the
		 * values at following indexes down by one.
		 */
		function removeFromVariableVirtualCacheAtIndex(index:int):void;
	}
}


================================================
FILE: source/feathers/layout/IVirtualLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import flash.geom.Point;

	import starling.display.DisplayObject;

	/**
	 * A layout algorithm that supports virtualization of items so that only
	 * the visible items need to be created. Useful in lists with dozens or
	 * hundreds of items are needed, but only a small subset of the items are
	 * visible at any given moment.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public interface IVirtualLayout extends ILayout
	{
		/**
		 * Determines if virtual layout should be used. Some components don't
		 * support virtual layouts, and they will always change this property to
		 * <code>false</code>. In those cases, the virtual layout options
		 * will be ignored.
		 */
		function get useVirtualLayout():Boolean;

		/**
		 * @private
		 */
		function set useVirtualLayout(value:Boolean):void;

		/**
		 * Used internally by a component that supports layout virtualization,
		 * such as <code>List</code>, to provide a display object with
		 * dimensions that represent a "typical" item in the layout. These
		 * dimensions will be used to fill in blanks for the layout when an
		 * item is virtual and isn't actually on the display list. If you are
		 * simply passing a layout to a component, setting this property will
		 * have no effect. It is meant to be used by the component, and the
		 * component will replace any value you pass to this property.
		 */
		function get typicalItem():DisplayObject;

		/**
		 * @private
		 */
		function set typicalItem(value:DisplayObject):void;

		/**
		 * Used internally by a component, such as <code>List</code>, to measure
		 * the view port based on the typical item dimensions or cached
		 * dimensions, if available.
		 *
		 * <p>This function is meant to be called by the <code>List</code> or
		 * other component that uses the virtual layout. If you're simply
		 * creating a layout for a <code>List</code> or another component, do
		 * not call this function. It is meant for developers creating custom
		 * components only.</p>
		 *
		 * @see #typicalItemWidth
		 * @see #typicalItemHeight
		 */
		function measureViewPort(itemCount:int, viewPortBounds:ViewPortBounds = null, result:Point = null):Point;

		/**
		 * Used internally by a component, such as <code>List</code>, to
		 * determines which indices are visible with the specified view port
		 * bounds and scroll position. Indices that aren't returned are
		 * typically not displayed and can be replaced virtually. Uses the
		 * typical items dimensions, or cached dimensions, if available.
		 *
		 * <p>This function is meant to be called by the <code>List</code> or
		 * other component that uses the virtual layout. If you're simply
		 * creating a layout for a <code>List</code> or another component, do
		 * not call this function. It is meant for developers creating custom
		 * components only.</p>
		 */
		function getVisibleIndicesAtScrollPosition(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int> = null):Vector.<int>;
	}
}


================================================
FILE: source/feathers/layout/LayoutBoundsResult.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	/**
	 * Calculated bounds for layout.
	 *
	 * @productversion Feathers 1.1.0
	 */
	public class LayoutBoundsResult
	{
		/**
		 * Constructor.
		 */
		public function LayoutBoundsResult()
		{

		}

		/**
		 * The starting position of the view port's content on the x axis.
		 * Usually, this value is <code>0</code>, but it may be negative.
		 * negative.
		 */
		public var contentX:Number = 0;

		/**
		 * The starting position of the view port's content on the y axis.
		 * Usually, this value is <code>0</code>, but it may be negative.
		 */
		public var contentY:Number = 0;

		/**
		 * The visible width of the view port. The view port's content may be
		 * clipped.
		 */
		public var viewPortWidth:Number;

		/**
		 * The visible height of the view port. The view port's content may be
		 * clipped.
		 */
		public var viewPortHeight:Number;

		/**
		 * The width of the content. May be larger or smaller than the view
		 * port.
		 */
		public var contentWidth:Number;

		/**
		 * The height of the content. May be larger or smaller than the view
		 * port.
		 */
		public var contentHeight:Number;
	}
}


================================================
FILE: source/feathers/layout/Orientation.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	/**
	 * Constants that define an orientation or set of orientations.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class Orientation
	{
		/**
		 * Landscape orientation where width is larger than height.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const LANDSCAPE:String = "landscape";

		/**
		 * Portrait orientation where height is larger than width.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const PORTRAIT:String = "portrait";

		/**
		 * No orientation.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const NONE:String = "none";

		/**
		 * Both landscape and portrait orientation.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const BOTH:String = "both";
	}
}


================================================
FILE: source/feathers/layout/RelativeDepth.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	/**
	 * Constants for positioning an item at a depth relative to another item's
	 * depth in a layout.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class RelativeDepth
	{
		/**
		 * The item will be positioned above another item.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const ABOVE:String = "above";

		/**
		 * The item will be positioned below another item.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const BELOW:String = "below";
	}
}


================================================
FILE: source/feathers/layout/RelativePosition.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	/**
	 * Constants for positioning an item relative to another item in a layout.
	 *
	 * <p>Note: Some constants may not be valid for certain properties. Please
	 * see the description of the property in the API reference for full
	 * details.</p>
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class RelativePosition
	{
		/**
		 * The item will be positioned above another item.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const TOP:String = "top";

		/**
		 * The item will be positioned to the right of another item.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const RIGHT:String = "right";

		/**
		 * The item will be positioned below another item.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const BOTTOM:String = "bottom";

		/**
		 * The item will be positioned to the left of another item.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const LEFT:String = "left";

		/**
		 * The item will be positioned manually with no relation to the position
		 * of another item. Additional properties may be available to manually
		 * set the x and y position of the item.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const MANUAL:String = "manual";

		/**
		 * The item will be positioned to the left another item, and the
		 * baselines will be aligned to match. If an item doesn't have a
		 * baseline, then its bottom edge will be used as the baseline.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const LEFT_BASELINE:String = "leftBaseline";

		/**
		 * The item will be positioned to the right of another item, and the
		 * baselines will be aligned to match. If an item doesn't have a
		 * baseline, then its bottom edge will be used as the baseline.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const RIGHT_BASELINE:String = "rightBaseline";
	}
}


================================================
FILE: source/feathers/layout/SlideShowLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import feathers.core.IValidating;
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;
	import flash.ui.Keyboard;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when a property of the layout changes, indicating that a
	 * redraw is probably needed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Displays one item per page.
	 *
	 * @see ../../../help/slide-show-layout.html How to use SlideShowLayout with Feathers containers
	 *
	 * @productversion Feathers 3.3.0
	 */
	public class SlideShowLayout extends EventDispatcher implements IVirtualLayout, ITrimmedVirtualLayout
	{
		/**
		 * @private
		 */
		protected static const FUZZY_PAGE_DETECTION:Number = 0.000001;

		/**
		 * Constructor.
		 */
		public function SlideShowLayout()
		{
			super();
		}

		/**
		 * @private
		 */
		protected var _direction:String = Direction.HORIZONTAL;

		[Inspectable(type="String",enumeration="horizontal,vertical")]
		/**
		 * Determines if pages are positioned from left-to-right or from top-to-bottom.
		 *
		 * @default feathers.layout.Direction.HORIZONTAL
		 *
		 * @see feathers.layout.Direction#HORIZONTAL
		 * @see feathers.layout.Direction#VERTICAL
		 */
		public function get direction():String
		{
			return this._direction;
		}

		/**
		 * @private
		 */
		public function set direction(value:String):void
		{
			if(this._direction === value)
			{
				return;
			}
			this._direction = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * Quickly sets all padding properties to the same value. The
		 * <code>padding</code> getter always returns the value of
		 * <code>paddingTop</code>, but the other padding values may be
		 * different.
		 *
		 * @default 0
		 *
		 * @see #paddingTop
		 * @see #paddingRight
		 * @see #paddingBottom
		 * @see #paddingLeft
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * The space, in pixels, that appears on top of each item.
		 *
		 * @default 0
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * The minimum space, in pixels, to the right of each item.
		 *
		 * @default 0
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * The space, in pixels, that appears on the bottom of each item.
		 * item.
		 *
		 * @default 0
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * The minimum space, in pixels, to the left of each item.
		 *
		 * @default 0
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.MIDDLE;

		[Inspectable(type="String",enumeration="top,middle,bottom,justify")]
		/**
		 * The alignment of each item vertically, on the y-axis.
		 *
		 * @default feathers.layout.VerticalAlign.MIDDLE
		 *
		 * @see feathers.layout.VerticalAlign#TOP
		 * @see feathers.layout.VerticalAlign#MIDDLE
		 * @see feathers.layout.VerticalAlign#BOTTOM
		 * @see feathers.layout.VerticalAlign#JUSTIFY
		 */
		public function get verticalAlign():String
		{
			return this._verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this._verticalAlign === value)
			{
				return;
			}
			this._verticalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.CENTER;

		[Inspectable(type="String",enumeration="left,center,right,justify")]
		/**
		 * The alignment of each item horizontally, on the x-axis.
		 *
		 * @default feathers.layout.HorizontalAlign.CENTER
		 *
		 * @see feathers.layout.HorizontalAlign#LEFT
		 * @see feathers.layout.HorizontalAlign#CENTER
		 * @see feathers.layout.HorizontalAlign#RIGHT
		 * @see feathers.layout.HorizontalAlign#JUSTIFY
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this._horizontalAlign === value)
			{
				return;
			}
			this._horizontalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _useVirtualLayout:Boolean = true;

		/**
		 * @inheritDoc
		 *
		 * @default true
		 */
		public function get useVirtualLayout():Boolean
		{
			return this._useVirtualLayout;
		}

		/**
		 * @private
		 */
		public function set useVirtualLayout(value:Boolean):void
		{
			if(this._useVirtualLayout === value)
			{
				return;
			}
			this._useVirtualLayout = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _beforeVirtualizedItemCount:int = 0;

		/**
		 * @inheritDoc
		 */
		public function get beforeVirtualizedItemCount():int
		{
			return this._beforeVirtualizedItemCount;
		}

		/**
		 * @private
		 */
		public function set beforeVirtualizedItemCount(value:int):void
		{
			if(this._beforeVirtualizedItemCount == value)
			{
				return;
			}
			this._beforeVirtualizedItemCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _afterVirtualizedItemCount:int = 0;

		/**
		 * @inheritDoc
		 */
		public function get afterVirtualizedItemCount():int
		{
			return this._afterVirtualizedItemCount;
		}

		/**
		 * @private
		 */
		public function set afterVirtualizedItemCount(value:int):void
		{
			if(this._afterVirtualizedItemCount == value)
			{
				return;
			}
			this._afterVirtualizedItemCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _typicalItem:DisplayObject;

		/**
		 * @inheritDoc
		 */
		public function get typicalItem():DisplayObject
		{
			return this._typicalItem;
		}

		/**
		 * @private
		 */
		public function set typicalItem(value:DisplayObject):void
		{
			if(this._typicalItem === value)
			{
				return;
			}
			this._typicalItem = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _minimumItemCount:int = 1;

		/**
		 * If the layout is virtualized, specifies the minimum total number of
		 * items that will be created, even if some are not currently visible
		 * in the view port.
		 *
		 * @default 1
		 *
		 * @see #useVirtualLayout
		 */
		public function get minimumItemCount():int
		{
			return this._minimumItemCount;
		}

		/**
		 * @private
		 */
		public function set minimumItemCount(value:int):void
		{
			if(this._minimumItemCount == value)
			{
				return;
			}
			this._minimumItemCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @inheritDoc
		 */
		public function get requiresLayoutOnScroll():Boolean
		{
			return this._useVirtualLayout;
		}

		/**
		 * @inheritDoc
		 */
		public function layout(items:Vector.<DisplayObject>, viewPortBounds:ViewPortBounds = null, result:LayoutBoundsResult = null):LayoutBoundsResult
		{
			//since viewPortBounds can be null, we may need to provide some defaults
			var scrollX:Number = viewPortBounds !== null ? viewPortBounds.scrollX : 0;
			var scrollY:Number = viewPortBounds !== null ? viewPortBounds.scrollY : 0;
			var boundsX:Number = viewPortBounds !== null ? viewPortBounds.x : 0;
			var boundsY:Number = viewPortBounds !== null ? viewPortBounds.y : 0;
			var minWidth:Number = viewPortBounds !== null ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds !== null ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds !== null ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds !== null ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;
			var explicitWidth:Number = viewPortBounds !== null ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds !== null ? viewPortBounds.explicitHeight : NaN;
			var itemCount:int = items.length;

			if(this._useVirtualLayout)
			{
				//if the layout is virtualized, we'll need the dimensions of the
				//typical item so that we have fallback values when an item is null
				this.prepareTypicalItem(explicitWidth - this._paddingLeft - this._paddingRight,
					explicitHeight - this._paddingTop - this._paddingBottom);
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var needsExplicitWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			var needsExplicitHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			var viewPortWidth:Number = explicitWidth;
			if(needsExplicitWidth)
			{
				viewPortWidth = calculatedTypicalItemWidth;
			}
			var viewPortHeight:Number = explicitHeight;
			if(needsExplicitHeight)
			{
				viewPortHeight = calculatedTypicalItemHeight;
			}

			if(!this._useVirtualLayout ||
				this._horizontalAlign !== HorizontalAlign.JUSTIFY ||
				this._verticalAlign !== VerticalAlign.JUSTIFY ||
				needsExplicitWidth || needsExplicitHeight)
			{
				//in some cases, we may need to validate all of the items so
				//that we can use their dimensions below.
				this.validateItems(items, explicitWidth - this._paddingLeft - this._paddingRight,
					explicitHeight - this._paddingTop - this._paddingBottom);
			}

			//if the layout isn't virtual and the view port dimensions aren't
			//explicit, we need to calculate them
			if(!this._useVirtualLayout && (needsExplicitWidth || needsExplicitHeight))
			{
				var maxItemWidth:Number = this._useVirtualLayout ? calculatedTypicalItemWidth : 0;
				var maxItemHeight:Number = this._useVirtualLayout ? calculatedTypicalItemHeight : 0;
				for(var i:int = 0; i < itemCount; i++)
				{
					var item:DisplayObject = items[i];
					if(maxItemWidth < item.width)
					{
						maxItemWidth = item.width;
					}
					if(maxItemHeight < item.height)
					{
						maxItemHeight = item.height;
					}
				}
				if(needsExplicitWidth)
				{
					viewPortWidth = maxItemWidth + this._paddingLeft + this._paddingRight;
				}
				if(needsExplicitHeight)
				{
					viewPortHeight = maxItemHeight + this._paddingTop + this._paddingBottom;
				}
			}
			if(needsExplicitWidth)
			{
				if(viewPortWidth < minWidth)
				{
					viewPortWidth = minWidth;
				}
				else if(viewPortWidth > maxWidth)
				{
					viewPortWidth = maxWidth;
				}
			}
			if(needsExplicitHeight)
			{
				if(viewPortHeight < minHeight)
				{
					viewPortHeight = minHeight;
				}
				else if(viewPortHeight > maxHeight)
				{
					viewPortHeight = maxHeight;
				}
			}
			if(this._direction === Direction.VERTICAL)
			{
				var startPosition:Number = boundsY;
			}
			else
			{
				startPosition = boundsX;
			}
			var position:Number = startPosition;
			if(this._useVirtualLayout)
			{
				//if the layout is virtualized, we can make our loops shorter
				//by skipping some items at the beginning and end. this
				//improves performance.
				if(this._direction === Direction.VERTICAL)
				{
					position += (this._beforeVirtualizedItemCount * viewPortHeight);
				}
				else //horizontal
				{
					position += (this._beforeVirtualizedItemCount * viewPortWidth);
				}
			}
			var contentWidth:Number = viewPortWidth - this._paddingLeft - this._paddingRight;
			var contentHeight:Number = viewPortHeight - this._paddingTop - this._paddingBottom;
			for(i = 0; i < itemCount; i++)
			{
				item = items[i];
				if(item !== null)
				{
					//we get here if the item isn't null. it is never null if
					//the layout isn't virtualized.
					var layoutItem:ILayoutDisplayObject = item as ILayoutDisplayObject;
					if(layoutItem !== null && !layoutItem.includeInLayout)
					{
						continue;
					}
					var xPosition:Number = this._direction === Direction.VERTICAL ? 0 : position;
					switch(this._horizontalAlign)
					{
						case HorizontalAlign.JUSTIFY:
						{
							xPosition += this._paddingLeft;
							item.width = contentWidth;
							break;
						}
						case HorizontalAlign.LEFT:
						{
							xPosition += this._paddingLeft;
							break;
						}
						case HorizontalAlign.RIGHT:
						{
							xPosition += contentWidth - item.width;
							break;
						}
						case HorizontalAlign.CENTER:
						{
							xPosition += Math.round((contentWidth - item.width) / 2);
							break;
						}
					}
					item.x = xPosition;
					var yPosition:Number = this._direction === Direction.VERTICAL ? position : 0;
					switch(this._verticalAlign)
					{
						case VerticalAlign.JUSTIFY:
						{
							yPosition += this._paddingTop;
							item.height = contentHeight;
							break;
						}
						case VerticalAlign.TOP:
						{
							yPosition += this._paddingTop;
							break;
						}
						case VerticalAlign.BOTTOM:
						{
							yPosition += contentHeight - item.height;
							break;
						}
						case VerticalAlign.MIDDLE:
						{
							yPosition += Math.round((contentHeight - item.height) / 2);
							break;
						}
					}
					item.y = yPosition;
				}
				if(this._direction === Direction.VERTICAL)
				{
					position += viewPortHeight;
				}
				else //horizontal
				{
					position += viewPortWidth;
				}
			}
			if(position === startPosition)
			{
				//require at least one page
				if(this._direction === Direction.VERTICAL)
				{
					position += viewPortHeight;
				}
				else //horizontal
				{
					position += viewPortWidth;
				}
			}
			if(this._useVirtualLayout)
			{
				position += (viewPortWidth * this._afterVirtualizedItemCount);
			}

			if(!result)
			{
				result = new LayoutBoundsResult();
			}
			result.contentX = 0;
			result.contentY = 0;
			if(this._direction === Direction.VERTICAL)
			{
				result.contentWidth = viewPortWidth;
				result.contentHeight = position;
			}
			else //horizontal
			{
				result.contentWidth = position;
				result.contentHeight = viewPortHeight;
			}
			result.viewPortWidth = viewPortWidth;
			result.viewPortHeight = viewPortHeight;
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function measureViewPort(itemCount:int, viewPortBounds:ViewPortBounds = null, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("measureViewPort() may be called only if useVirtualLayout is true.");
			}

			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;
			var needsWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			var needsHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			if(!needsWidth && !needsHeight)
			{
				result.x = explicitWidth;
				result.y = explicitHeight;
				return result;
			}
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;

			this.prepareTypicalItem(explicitWidth - this._paddingLeft - this._paddingRight,
				explicitHeight - this._paddingTop - this._paddingBottom);
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			if(needsWidth)
			{
				var resultWidth:Number = calculatedTypicalItemWidth + this._paddingLeft + this._paddingRight;
				if(resultWidth < minWidth)
				{
					resultWidth = minWidth;
				}
				else if(resultWidth > maxWidth)
				{
					resultWidth = maxWidth;
				}
				result.x = resultWidth;
			}
			else
			{
				result.x = explicitWidth;
			}

			if(needsHeight)
			{
				var resultHeight:Number = calculatedTypicalItemHeight + this._paddingTop + this._paddingBottom;
				if(resultHeight < minHeight)
				{
					resultHeight = minHeight;
				}
				else if(resultHeight > maxHeight)
				{
					resultHeight = maxHeight;
				}
				result.y = resultHeight;
			}
			else
			{
				result.y = explicitHeight;
			}

			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getVisibleIndicesAtScrollPosition(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int> = null):Vector.<int>
		{
			if(result !== null)
			{
				result.length = 0;
			}
			else
			{
				result = new <int>[];
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("getVisibleIndicesAtScrollPosition() may be called only if useVirtualLayout is true.");
			}
			if(this._direction === Direction.VERTICAL)
			{
				var baseIndex:int = scrollY / height;
				var isBetweenPages:Boolean = ((scrollY / height) - baseIndex) > FUZZY_PAGE_DETECTION;
			}
			else //horizontal
			{
				baseIndex = scrollX / width;
				isBetweenPages = ((scrollX / width) - baseIndex) > FUZZY_PAGE_DETECTION;
			}
			var extraBeforeCount:int = int(this._minimumItemCount / 2);
			var startIndex:int = baseIndex - extraBeforeCount;
			if(startIndex < 0)
			{
				extraBeforeCount += startIndex;
				startIndex = 0;
			}
			var extraAfterCount:int = this._minimumItemCount - extraBeforeCount;
			if(!isBetweenPages || this._minimumItemCount > 2)
			{
				extraAfterCount--;
			}
			var endIndex:int = baseIndex + extraAfterCount;
			var maxIndex:int = itemCount - 1;
			if(endIndex > maxIndex)
			{
				endIndex = maxIndex;
			}
			var pushIndex:int = 0;
			for(var i:int = startIndex; i <= endIndex; i++)
			{
				result[pushIndex] = i;
				pushIndex++;
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getNearestScrollPositionForIndex(index:int, scrollX:Number, scrollY:Number, items:Vector.<DisplayObject>,
			x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			return this.getScrollPositionForIndex(index, items, x, y, width, height, result);
		}

		/**
		 * @inheritDoc
		 */
		public function calculateNavigationDestination(items:Vector.<DisplayObject>, index:int, keyCode:uint, bounds:LayoutBoundsResult):int
		{
			var itemArrayCount:int = items.length;
			var itemCount:int = itemArrayCount + this._beforeVirtualizedItemCount + this._afterVirtualizedItemCount;

			var result:int = index;
			if(keyCode == Keyboard.HOME)
			{
				if(itemCount > 0)
				{
					result = 0;
				}
			}
			else if(keyCode == Keyboard.END)
			{
				result = itemCount - 1;
			}
			else if(keyCode == Keyboard.PAGE_UP ||
				(this._direction === Direction.VERTICAL && keyCode == Keyboard.UP) ||
				(this._direction === Direction.HORIZONTAL && keyCode == Keyboard.LEFT))
			{
				result--;
			}
			else if(keyCode == Keyboard.PAGE_DOWN ||
				(this._direction === Direction.VERTICAL && keyCode == Keyboard.DOWN) ||
				(this._direction === Direction.HORIZONTAL && keyCode == Keyboard.RIGHT))
			{
				result++;
			}
			if(result < 0)
			{
				result = 0;
			}
			if(result >= itemCount)
			{
				result = itemCount - 1;
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getScrollPositionForIndex(index:int, items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			if(result === null)
			{
				result = new Point();
			}
			if(this._direction === Direction.VERTICAL)
			{
				result.x = 0;
				result.y = height * index;
			}
			else //horizontal
			{
				result.x = width * index;
				result.y = 0;
			}

			return result;
		}

		/**
		 * @private
		 */
		protected function validateItems(items:Vector.<DisplayObject>,
			explicitWidth:Number, explicitHeight:Number):void
		{
			//if the alignment is justified, then we want to set the width of
			//each item before validating because setting one dimension may
			//cause the other dimension to change, and that will invalidate the
			//layout if it happens after validation, causing more invalidation
			var itemCount:int = items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				if(!item || (item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout))
				{
					continue;
				}
				if(this._horizontalAlign === HorizontalAlign.JUSTIFY)
				{
					//the alignment is justified, but we don't yet have a width
					//to use, so we need to ensure that we accurately measure
					//the items instead of using an old justified width that may
					//be wrong now!
					item.width = explicitWidth;
				}
				if(this._verticalAlign === VerticalAlign.JUSTIFY)
				{
					item.height = explicitHeight;
				}
				if(item is IValidating)
				{
					IValidating(item).validate();
				}
			}
		}

		/**
		 * @private
		 */
		protected function prepareTypicalItem(justifyWidth:Number, justifyHeight:Number):void
		{
			if(!this._typicalItem)
			{
				return;
			}
			if(this._horizontalAlign === HorizontalAlign.JUSTIFY &&
				justifyWidth === justifyWidth) //!isNaN
			{
				this._typicalItem.width = justifyWidth;
			}
			if(this._verticalAlign === VerticalAlign.JUSTIFY &&
				justifyHeight === justifyHeight) //!isNaN
			{
				this._typicalItem.height = justifyHeight;
			}
			if(this._typicalItem is IValidating)
			{
				IValidating(this._typicalItem).validate();
			}
		}
	}
}


================================================
FILE: source/feathers/layout/TiledColumnsLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import feathers.core.IValidating;
	import feathers.layout.Direction;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;
	import flash.ui.Keyboard;

	import starling.display.DisplayObject;

	/**
	 * Positions items as tiles (equal width and height) from top to bottom
	 * in multiple columns. Constrained to the suggested height, the tiled
	 * columns layout will change in width as the number of items increases or
	 * decreases.
	 *
	 * @see ../../../help/tiled-columns-layout.html How to use TiledColumnsLayout with Feathers containers
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class TiledColumnsLayout extends BaseTiledLayout implements IVirtualLayout, IDragDropLayout
	{
		/**
		 * Constructor.
		 */
		public function TiledColumnsLayout()
		{
			super();
		}

		/**
		 * Requests that the layout uses a specific number of rows in a column,
		 * if possible. Set to <code>0</code> to calculate the maximum of
		 * rows that will fit in the available space.
		 *
		 * <p>If the view port's explicit or maximum height is not large enough
		 * to fit the requested number of rows, it will use fewer. If the
		 * view port doesn't have an explicit height and the maximum height is
		 * equal to <code>Number.POSITIVE_INFINITY</code>, the height will be
		 * calculated automatically to fit the exact number of requested
		 * rows.</p>
		 *
		 * <p>If paging is enabled, this value will be used to calculate the
		 * number of rows in a page. If paging isn't enabled, this value will
		 * be used to calculate a minimum number of rows, even if there aren't
		 * enough items to fill each row.</p>
		 *
		 * @default 0
		 */
		override public function get requestedRowCount():int
		{
			//this is an override so that this class can have its own documentation.
			return this._requestedRowCount;
		}

		/**
		 * Requests that the layout uses a specific number of columns, if
		 * possible. If the view port's explicit or maximum width is not large
		 * enough to fit the requested number of columns, it will use fewer. Set
		 * to <code>0</code> to calculate the number of columns automatically
		 * based on width and height.
		 *
		 * <p>If paging is enabled, this value will be used to calculate the
		 * number of columns in a page. If paging isn't enabled, this value will
		 * be used to calculate a minimum number of columns, even if there
		 * aren't enough items to fill each column.</p>
		 *
		 * @default 0
		 */
		override public function get requestedColumnCount():int
		{
			//this is an override so that this class can have its own documentation.
			return this._requestedColumnCount;
		}

		/**
		 * If the total combined width of the columns is larger than the width
		 * of the view port, the layout will be split into pages where each
		 * page is filled with the maximum number of columns that may be
		 * displayed without cutting off any items.
		 *
		 * @default feathers.layout.Direction.NONE
		 *
		 * @see feathers.layout.Direction#NONE
		 * @see feathers.layout.Direction#HORIZONTAL
		 * @see feathers.layout.Direction#VERTICAL
		 */
		override public function get paging():String
		{
			//this is an override so that this class can have its own documentation.
			return this._paging;
		}

		/**
		 * If the total width of the tiles in a row (minus padding and gap)
		 * does not fill the entire row, the remaining space will be distributed
		 * to each tile equally.
		 *
		 * <p>If the container using the layout might resize, setting
		 * <code>requestedColumnCount</code> is recommended because the tiles
		 * will resize too, and their dimensions may not be reset.</p>
		 *
		 * <p>Note: If the <code>distributeWidths</code> property is set to
		 * <code>true</code>, the <code>useSquareTiles</code> property will be
		 * automatically changed to <code>false</code>.</p>
		 *
		 * @default false
		 *
		 * @see #requestedColumnCount
		 * @see #useSquareTiles
		 */
		override public function get distributeWidths():Boolean
		{
			//this is an override so that this class can have its own documentation.
			return this._distributeWidths;
		}

		/**
		 * @private
		 */
		override public function set distributeWidths(value:Boolean):void
		{
			super.distributeWidths = value;
			if(value)
			{
				this.useSquareTiles = false;
			}
		}

		/**
		 * If the total height of the tiles in a column (minus padding and gap)
		 * does not fill the entire column, the remaining space will be
		 * distributed to each tile equally.
		 *
		 * <p>If the container using the layout might resize, setting
		 * <code>requestedRowCount</code> is recommended because the tiles
		 * will resize too, and their dimensions may not be reset.</p>
		 *
		 * @default false
		 *
		 * @see #requestedRowCount
		 */
		override public function get distributeHeights():Boolean
		{
			return this._distributeHeights;
		}

		/**
		 * @inheritDoc
		 */
		public function layout(items:Vector.<DisplayObject>, viewPortBounds:ViewPortBounds = null, result:LayoutBoundsResult = null):LayoutBoundsResult
		{
			if(!result)
			{
				result = new LayoutBoundsResult();
			}
			if(items.length == 0)
			{
				result.contentX = 0;
				result.contentY = 0;
				result.contentWidth = this._paddingLeft + this._paddingRight;
				result.contentHeight = this._paddingTop + this._paddingBottom;
				result.viewPortWidth = result.contentWidth;
				result.viewPortHeight = result.contentHeight;
				return result;
			}

			var scrollX:Number = viewPortBounds ? viewPortBounds.scrollX : 0;
			var scrollY:Number = viewPortBounds ? viewPortBounds.scrollY : 0;
			var boundsX:Number = viewPortBounds ? viewPortBounds.x : 0;
			var boundsY:Number = viewPortBounds ? viewPortBounds.y : 0;
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;
			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;

			if(this._useVirtualLayout)
			{
				this.prepareTypicalItem();
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}
			this.validateItems(items);

			this._discoveredItemsCache.length = 0;
			var itemCount:int = items.length;
			var tileWidth:Number = this._useVirtualLayout ? calculatedTypicalItemWidth : 0;
			var tileHeight:Number = this._useVirtualLayout ? calculatedTypicalItemHeight : 0;
			//a virtual layout assumes that all items are the same size as
			//the typical item, so we don't need to measure every item in
			//that case
			if(!this._useVirtualLayout)
			{
				for(var i:int = 0; i < itemCount; i++)
				{
					var item:DisplayObject = items[i];
					if(!item)
					{
						continue;
					}
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					var itemWidth:Number = item.width;
					var itemHeight:Number = item.height;
					if(itemWidth > tileWidth)
					{
						tileWidth = itemWidth;
					}
					if(itemHeight > tileHeight)
					{
						tileHeight = itemHeight;
					}
				}
			}
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}

			var verticalTileCount:int = this.calculateVerticalTileCount(tileHeight,
				explicitHeight, maxHeight, this._paddingTop + this._paddingBottom,
				this._verticalGap, this._requestedRowCount, itemCount);
			if(explicitHeight === explicitHeight) //!isNaN
			{
				var availableHeight:Number = explicitHeight;
			}
			else
			{
				availableHeight = this._paddingTop + this._paddingBottom + ((tileHeight + this._verticalGap) * verticalTileCount) - this._verticalGap;
				if(availableHeight < minHeight)
				{
					availableHeight = minHeight;
				}
				else if(availableHeight > maxHeight)
				{
					availableHeight = maxHeight;
				}
			}
			if(this._distributeHeights)
			{
				//distribute remaining space
				tileHeight = (availableHeight - this._paddingTop - this._paddingBottom - (verticalTileCount * this._verticalGap) + this._verticalGap) / verticalTileCount;
				if(this._useSquareTiles)
				{
					tileWidth = tileHeight;
				}
			}
			var horizontalTileCount:int = this.calculateHorizontalTileCount(tileWidth,
				explicitWidth, maxWidth, this._paddingLeft + this._paddingRight,
				this._horizontalGap, this._requestedColumnCount, itemCount,
				verticalTileCount, this._distributeWidths && !this._useSquareTiles);
			if(explicitWidth === explicitWidth) //!isNaN
			{
				var availableWidth:Number = explicitWidth;
			}
			else
			{
				availableWidth = this._paddingLeft + this._paddingRight + ((tileWidth + this._horizontalGap) * horizontalTileCount) - this._horizontalGap;
				if(availableWidth < minWidth)
				{
					availableWidth = minWidth;
				}
				else if(availableWidth > maxWidth)
				{
					availableWidth = maxWidth;
				}
			}
			if(this._distributeWidths && !this._useSquareTiles)
			{
				//distribute remaining space
				tileWidth = (availableWidth - this._paddingLeft - this._paddingRight - (horizontalTileCount * this._horizontalGap) + this._horizontalGap) / horizontalTileCount;
			}

			var totalPageContentWidth:Number = horizontalTileCount * (tileWidth + this._horizontalGap) - this._horizontalGap + this._paddingLeft + this._paddingRight;
			var totalPageContentHeight:Number = verticalTileCount * (tileHeight + this._verticalGap) - this._verticalGap + this._paddingTop + this._paddingBottom;

			var startX:Number = boundsX + this._paddingLeft;
			var startY:Number = boundsY + this._paddingTop;

			var perPage:int = horizontalTileCount * verticalTileCount;
			var pageIndex:int = 0;
			var nextPageStartIndex:int = perPage;
			var pageStartY:Number = startY;
			var positionX:Number = startX;
			var positionY:Number = startY;
			var itemIndex:int = 0;
			var discoveredItemsCachePushIndex:int = 0;
			for(i = 0; i < itemCount; i++)
			{
				item = items[i];
				if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
				{
					continue;
				}
				if(itemIndex != 0 && i % verticalTileCount == 0)
				{
					positionX += tileWidth + this._horizontalGap;
					positionY = pageStartY;
				}
				if(itemIndex == nextPageStartIndex)
				{
					//we're starting a new page, so handle alignment of the
					//items on the current page and update the positions
					if(this._paging !== Direction.NONE)
					{
						var discoveredItems:Vector.<DisplayObject> = this._useVirtualLayout ? this._discoveredItemsCache : items;
						var discoveredItemsFirstIndex:int = this._useVirtualLayout ? 0 : (itemIndex - perPage);
						var discoveredItemsLastIndex:int = this._useVirtualLayout ? (this._discoveredItemsCache.length - 1) : (itemIndex - 1);
						this.applyHorizontalAlign(discoveredItems, discoveredItemsFirstIndex, discoveredItemsLastIndex, totalPageContentWidth, availableWidth);
						this.applyVerticalAlign(discoveredItems, discoveredItemsFirstIndex, discoveredItemsLastIndex, totalPageContentHeight, availableHeight);
						this._discoveredItemsCache.length = 0;
						discoveredItemsCachePushIndex = 0;
					}
					pageIndex++;
					nextPageStartIndex += perPage;

					//we can use availableWidth and availableHeight here without
					//checking if they're NaN because we will never reach a
					//new page without them already being calculated.
					if(this._paging === Direction.HORIZONTAL)
					{
						positionX = startX + availableWidth * pageIndex;
					}
					else if(this._paging === Direction.VERTICAL)
					{
						positionX = startX;
						positionY = pageStartY = startY + availableHeight * pageIndex;
					}
				}
				if(item)
				{
					switch(this._tileHorizontalAlign)
					{
						case HorizontalAlign.JUSTIFY:
						{
							item.x = item.pivotX + positionX;
							item.width = tileWidth;
							break;
						}
						case HorizontalAlign.LEFT:
						{
							item.x = item.pivotX + positionX;
							break;
						}
						case HorizontalAlign.RIGHT:
						{
							item.x = item.pivotX + positionX + tileWidth - item.width;
							break;
						}
						default: //center or unknown
						{
							item.x = item.pivotX + positionX + Math.round((tileWidth - item.width) / 2);
						}
					}
					switch(this._tileVerticalAlign)
					{
						case VerticalAlign.JUSTIFY:
						{
							item.y = item.pivotY + positionY;
							item.height = tileHeight;
							break;
						}
						case VerticalAlign.TOP:
						{
							item.y = item.pivotY + positionY;
							break;
						}
						case VerticalAlign.BOTTOM:
						{
							item.y = item.pivotY + positionY + tileHeight - item.height;
							break;
						}
						default: //middle or unknown
						{
							item.y = item.pivotY + positionY + Math.round((tileHeight - item.height) / 2);
						}
					}
					if(this._useVirtualLayout)
					{
						this._discoveredItemsCache[discoveredItemsCachePushIndex] = item;
						discoveredItemsCachePushIndex++;
					}
				}
				positionY += tileHeight + this._verticalGap;
				itemIndex++;
			}
			//align the last page
			if(this._paging !== Direction.NONE)
			{
				discoveredItems = this._useVirtualLayout ? this._discoveredItemsCache : items;
				discoveredItemsFirstIndex = this._useVirtualLayout ? 0 : (nextPageStartIndex - perPage);
				discoveredItemsLastIndex = this._useVirtualLayout ? (this._discoveredItemsCache.length - 1) : (i - 1);
				this.applyHorizontalAlign(discoveredItems, discoveredItemsFirstIndex, discoveredItemsLastIndex, totalPageContentWidth, availableWidth);
				this.applyVerticalAlign(discoveredItems, discoveredItemsFirstIndex, discoveredItemsLastIndex, totalPageContentHeight, availableHeight);
			}

			if(this._paging === Direction.VERTICAL)
			{
				var totalWidth:Number = availableWidth;
			}
			else if(this._paging === Direction.HORIZONTAL)
			{
				totalWidth = Math.ceil(itemCount / perPage) * availableWidth;
			}
			else
			{
				totalWidth = positionX + tileWidth + this._paddingRight;
				if(totalWidth < totalPageContentWidth)
				{
					totalWidth = totalPageContentWidth;
				}
			}
			if(this._paging === Direction.VERTICAL)
			{
				var totalHeight:Number = Math.ceil(itemCount / perPage) * availableHeight;
			}
			else
			{
				totalHeight = totalPageContentHeight;
			}

			if(this._paging === Direction.NONE)
			{
				discoveredItems = this._useVirtualLayout ? this._discoveredItemsCache : items;
				discoveredItemsLastIndex = discoveredItems.length - 1;
				this.applyHorizontalAlign(discoveredItems, 0, discoveredItemsLastIndex, totalWidth, availableWidth);
				this.applyVerticalAlign(discoveredItems, 0, discoveredItemsLastIndex, totalHeight, availableHeight);
			}
			this._discoveredItemsCache.length = 0;

			if(!result)
			{
				result = new LayoutBoundsResult();
			}
			result.contentX = 0;
			result.contentY = 0;
			result.contentWidth = totalWidth;
			result.contentHeight = totalHeight;
			result.viewPortWidth = availableWidth;
			result.viewPortHeight = availableHeight;

			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function measureViewPort(itemCount:int, viewPortBounds:ViewPortBounds = null, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("measureViewPort() may be called only if useVirtualLayout is true.");
			}

			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;
			var needsWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			var needsHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			if(!needsWidth && !needsHeight)
			{
				result.x = explicitWidth;
				result.y = explicitHeight;
				return result;
			}
			var boundsX:Number = viewPortBounds ? viewPortBounds.x : 0;
			var boundsY:Number = viewPortBounds ? viewPortBounds.y : 0;
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;

			this.prepareTypicalItem();
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var tileWidth:Number = calculatedTypicalItemWidth;
			var tileHeight:Number = calculatedTypicalItemHeight;
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}

			var verticalTileCount:int = this.calculateVerticalTileCount(tileHeight,
				explicitHeight, maxHeight, this._paddingTop + this._paddingBottom,
				this._verticalGap, this._requestedRowCount, itemCount);
			var horizontalTileCount:int = this.calculateHorizontalTileCount(tileWidth,
				explicitWidth, maxWidth, this._paddingLeft + this._paddingRight,
				this._horizontalGap, this._requestedColumnCount, itemCount,
				verticalTileCount, this._distributeWidths && !this._useSquareTiles);
			if(explicitHeight === explicitHeight) //!isNaN
			{
				var availableHeight:Number = explicitHeight;
			}
			else
			{
				availableHeight = this._paddingTop + this._paddingBottom + ((tileHeight + this._verticalGap) * verticalTileCount) - this._verticalGap;
				if(availableHeight < minHeight)
				{
					availableHeight = minHeight;
				}
				else if(availableHeight > maxHeight)
				{
					availableHeight = maxHeight;
				}
			}
			if(explicitWidth === explicitWidth) //!isNaN
			{
				var availableWidth:Number = explicitWidth;
			}
			else
			{
				availableWidth = this._paddingLeft + this._paddingRight + ((tileWidth + this._horizontalGap) * horizontalTileCount) - this._horizontalGap;
				if(availableWidth < minWidth)
				{
					availableWidth = minWidth;
				}
				else if(availableWidth > maxWidth)
				{
					availableWidth = maxWidth;
				}
			}

			var totalPageContentWidth:Number = horizontalTileCount * (tileWidth + this._horizontalGap) - this._horizontalGap + this._paddingLeft + this._paddingRight;
			var totalPageContentHeight:Number = verticalTileCount * (tileHeight + this._verticalGap) - this._verticalGap + this._paddingTop + this._paddingBottom;

			var startX:Number = boundsX + this._paddingLeft;

			var perPage:int = horizontalTileCount * verticalTileCount;
			var pageIndex:int = 0;
			var nextPageStartIndex:int = perPage;
			var positionX:Number = startX;
			for(var i:int = 0; i < itemCount; i++)
			{
				if(i != 0 && i % verticalTileCount == 0)
				{
					positionX += tileWidth + this._horizontalGap;
				}
				if(i == nextPageStartIndex)
				{
					pageIndex++;
					nextPageStartIndex += perPage;

					//we can use availableWidth and availableHeight here without
					//checking if they're NaN because we will never reach a
					//new page without them already being calculated.
					if(this._paging === Direction.HORIZONTAL)
					{
						positionX = startX + availableWidth * pageIndex;
					}
					else if(this._paging === Direction.VERTICAL)
					{
						positionX = startX;
					}
				}
			}

			if(this._paging === Direction.VERTICAL)
			{
				var totalWidth:Number = availableWidth;
			}
			else if(this._paging === Direction.HORIZONTAL)
			{
				totalWidth = Math.ceil(itemCount / perPage) * availableWidth;
			}
			else //none
			{
				totalWidth = positionX + tileWidth + this._paddingRight;
				if(totalWidth < totalPageContentWidth)
				{
					totalWidth = totalPageContentWidth;
				}
			}
			if(this._paging === Direction.VERTICAL)
			{
				var totalHeight:Number = Math.ceil(itemCount / perPage) * availableHeight;
			}
			else //horizontal or none
			{
				totalHeight = totalPageContentHeight;
			}

			if(needsWidth)
			{
				var resultX:Number = totalWidth;
				if(resultX < minWidth)
				{
					resultX = minWidth;
				}
				else if(resultX > maxWidth)
				{
					resultX = maxWidth;
				}
				result.x = resultX;
			}
			else
			{
				result.x = explicitWidth;
			}
			if(needsHeight)
			{
				var resultY:Number = totalHeight;
				if(resultY < minHeight)
				{
					resultY = minHeight;
				}
				else if(resultY > maxHeight)
				{
					resultY = maxHeight;
				}
				result.y = resultY;
			}
			else
			{
				result.y = explicitHeight;
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getVisibleIndicesAtScrollPosition(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int> = null):Vector.<int>
		{
			if(result)
			{
				result.length = 0;
			}
			else
			{
				result = new <int>[];
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("getVisibleIndicesAtScrollPosition() may be called only if useVirtualLayout is true.");
			}

			if(this._paging === Direction.HORIZONTAL)
			{
				this.getVisibleIndicesAtScrollPositionWithHorizontalPaging(scrollX, scrollY, width, height, itemCount, result);
			}
			else if(this._paging === Direction.VERTICAL)
			{
				this.getVisibleIndicesAtScrollPositionWithVerticalPaging(scrollX, scrollY, width, height, itemCount, result);
			}
			else //none
			{
				this.getVisibleIndicesAtScrollPositionWithoutPaging(scrollX, scrollY, width, height, itemCount, result);
			}

			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function calculateNavigationDestination(items:Vector.<DisplayObject>, index:int, keyCode:uint, bounds:LayoutBoundsResult):int
		{
			var result:int = index;
			if(keyCode == Keyboard.HOME)
			{
				if(items.length > 0)
				{
					result = 0;
				}
			}
			else if(keyCode == Keyboard.END)
			{
				result = items.length - 1;
			}
			else if(keyCode == Keyboard.UP)
			{
				result--;
			}
			else if(keyCode == Keyboard.DOWN)
			{
				result++;
			}
			if(result < 0)
			{
				return 0;
			}
			if(result >= items.length)
			{
				return items.length - 1;
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getNearestScrollPositionForIndex(index:int, scrollX:Number, scrollY:Number, items:Vector.<DisplayObject>,
			x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			return this.calculateScrollPositionForIndex(index, items, x, y, width, height, result, true, scrollX, scrollY);
		}

		/**
		 * @inheritDoc
		 */
		public function getScrollPositionForIndex(index:int, items:Vector.<DisplayObject>,
			x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			return this.calculateScrollPositionForIndex(index, items, x, y, width, height, result, false);
		}

		/**
		 * @inheritDoc
		 */
		public function getDropIndex(x:Number, y:Number, items:Vector.<DisplayObject>,
			boundsX:Number, boundsY:Number, width:Number, height:Number):int
		{
			if(this._useVirtualLayout)
			{
				this.prepareTypicalItem();
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var itemCount:int = items.length;
			var tileWidth:Number = this._useVirtualLayout ? calculatedTypicalItemWidth : 0;
			var tileHeight:Number = this._useVirtualLayout ? calculatedTypicalItemHeight : 0;
			//a virtual layout assumes that all items are the same size as
			//the typical item, so we don't need to measure every item in
			//that case
			if(!this._useVirtualLayout)
			{
				for(var i:int = 0; i < itemCount; i++)
				{
					var item:DisplayObject = items[i];
					if(!item)
					{
						continue;
					}
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					var itemWidth:Number = item.width;
					var itemHeight:Number = item.height;
					if(itemWidth > tileWidth)
					{
						tileWidth = itemWidth;
					}
					if(itemHeight > tileHeight)
					{
						tileHeight = itemHeight;
					}
				}
			}
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}
			var horizontalTileCount:int = (width - this._paddingLeft - this._paddingRight + this._horizontalGap) / (tileWidth + this._horizontalGap);
			if(horizontalTileCount < 1)
			{
				horizontalTileCount = 1;
			}
			else if(this._requestedColumnCount > 0 && horizontalTileCount > this._requestedColumnCount)
			{
				horizontalTileCount = this._requestedColumnCount;
			}
			var verticalTileCount:int = (height - this._paddingTop - this._paddingBottom + this._verticalGap) / (tileHeight + this._verticalGap);
			if(verticalTileCount < 1)
			{
				verticalTileCount = 1;
			}
			else if(this._requestedRowCount > 0 && verticalTileCount > this._requestedRowCount)
			{
				verticalTileCount = this._requestedRowCount;
			}
			var perPage:Number = horizontalTileCount * verticalTileCount;
			var startY:Number = boundsY + this._paddingTop;
			var actualVerticalTileCount:int = verticalTileCount;
			if(actualVerticalTileCount > itemCount)
			{
				actualVerticalTileCount = itemCount;
			}
			if(this._verticalAlign == VerticalAlign.BOTTOM)
			{
				startY = boundsY + this._paddingTop + (height - this._paddingTop - this._paddingBottom) -
					((actualVerticalTileCount * (tileHeight + this._verticalGap)) - this._verticalGap);
			}
			else if(this._verticalAlign == VerticalAlign.MIDDLE)
			{
				startY = boundsY + this._paddingTop + ((height - this._paddingTop - this._paddingBottom) -
					((actualVerticalTileCount * (tileHeight + this._verticalGap)) - this._verticalGap)) / 2;
			}
			var startX:Number = boundsX + this._paddingLeft;
			if(this._paging != Direction.NONE || itemCount <= perPage)
			{
				var actualHorizontalTileCount:int = horizontalTileCount;
				if(itemCount <= perPage)
				{
					actualHorizontalTileCount = Math.ceil(itemCount / actualVerticalTileCount);
				}
				if(this._horizontalAlign == HorizontalAlign.RIGHT)
				{
					startX = boundsX + this._paddingLeft + (width - this._paddingLeft - this._paddingRight) -
						((actualHorizontalTileCount * (tileWidth + this._horizontalGap)) - this._horizontalGap);
				}
				else if(this._horizontalAlign == HorizontalAlign.CENTER)
				{
					startX = boundsX + this._paddingLeft + ((width - this._paddingLeft - this._paddingRight) -
						((actualHorizontalTileCount * (tileWidth + this._horizontalGap)) - this._horizontalGap)) / 2;
				}
			}
			var pageIndex:int = 0;
			var columnIndex:int = 0;
			var lastColumnIndex:int = int((itemCount - 1) / verticalTileCount);
			var nextPageStartIndex:int = perPage;
			var pageStartY:Number = startY;
			var positionX:Number = startX;
			var positionY:Number = startY;
			for(i = 0; i < itemCount; i++)
			{
				item = items[i];
				if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
				{
					continue;
				}
				if(i != 0 && i % verticalTileCount == 0)
				{
					if((y < (pageStartY + height)) && (x < (positionX + tileWidth + (this._horizontalGap / 2))))
					{
						//we're at the end of the previous column (but we also make
						//sure that we're not on the next page)
						return i;
					}
					positionY = pageStartY;
					positionX += tileWidth + this._horizontalGap;
				}
				if(i == nextPageStartIndex)
				{
					pageIndex++;
					nextPageStartIndex += perPage;

					//we can use availableWidth and availableHeight here without
					//checking if they're NaN because we will never reach a
					//new page without them already being calculated.
					if(this._paging === Direction.HORIZONTAL)
					{
						positionX = startX + width * pageIndex;
						positionY = startY;
					}
					else if(this._paging === Direction.VERTICAL)
					{
						positionY = pageStartY = startY + height * pageIndex;
					}
				}
				if((y < (positionY + (tileHeight / 2))) &&
					((x < (positionX + tileWidth + (this._horizontalGap / 2))) || (columnIndex == lastColumnIndex)))
				{
					return i;
				}
				positionY += tileHeight + this._verticalGap;
			}
			return i;
		}

		/**
		 * @inheritDoc
		 */
		public function positionDropIndicator(dropIndicator:DisplayObject, index:int,
			x:Number, y:Number, items:Vector.<DisplayObject>, width:Number, height:Number):void
		{
			if(this._useVirtualLayout)
			{
				this.prepareTypicalItem();
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var itemCount:int = items.length;
			var tileWidth:Number = this._useVirtualLayout ? calculatedTypicalItemWidth : 0;
			var tileHeight:Number = this._useVirtualLayout ? calculatedTypicalItemHeight : 0;
			//a virtual layout assumes that all items are the same size as
			//the typical item, so we don't need to measure every item in
			//that case
			if(!this._useVirtualLayout)
			{
				for(var i:int = 0; i < itemCount; i++)
				{
					var item:DisplayObject = items[i];
					if(!item)
					{
						continue;
					}
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					var itemWidth:Number = item.width;
					var itemHeight:Number = item.height;
					if(itemWidth > tileWidth)
					{
						tileWidth = itemWidth;
					}
					if(itemHeight > tileHeight)
					{
						tileHeight = itemHeight;
					}
				}
			}
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}
			var horizontalTileCount:int = (width - this._paddingLeft - this._paddingRight + this._horizontalGap) / (tileWidth + this._horizontalGap);
			if(horizontalTileCount < 1)
			{
				horizontalTileCount = 1;
			}
			else if(this._requestedColumnCount > 0 && horizontalTileCount > this._requestedColumnCount)
			{
				horizontalTileCount = this._requestedColumnCount;
			}
			var verticalTileCount:int = (height - this._paddingTop - this._paddingBottom + this._verticalGap) / (tileHeight + this._verticalGap);
			if(verticalTileCount < 1)
			{
				verticalTileCount = 1;
			}
			else if(this._requestedRowCount > 0 && verticalTileCount > this._requestedRowCount)
			{
				verticalTileCount = this._requestedRowCount;
			}
			var perPage:Number = horizontalTileCount * verticalTileCount;
			var startY:Number = this._paddingTop;
			var actualVerticalTileCount:int = verticalTileCount;
			if(actualVerticalTileCount > itemCount)
			{
				actualVerticalTileCount = itemCount;
			}
			if(this._verticalAlign == VerticalAlign.BOTTOM)
			{
				startY = this._paddingTop + (height - this._paddingTop - this._paddingBottom) -
					((actualVerticalTileCount * (tileHeight + this._verticalGap)) - this._verticalGap);
			}
			else if(this._verticalAlign == VerticalAlign.MIDDLE)
			{
				startY = this._paddingTop + ((height - this._paddingTop - this._paddingBottom) -
					((actualVerticalTileCount * (tileHeight + this._verticalGap)) - this._verticalGap)) / 2;
			}
			var startX:Number = this._paddingLeft;
			if(this._paging != Direction.NONE || itemCount <= perPage)
			{
				var actualHorizontalTileCount:int = horizontalTileCount;
				if(itemCount <= perPage)
				{
					actualHorizontalTileCount = Math.ceil(itemCount / actualVerticalTileCount);
				}
				if(this._horizontalAlign == HorizontalAlign.RIGHT)
				{
					startX = this._paddingLeft + (width - this._paddingLeft - this._paddingRight) -
						((actualHorizontalTileCount * (tileWidth + this._horizontalGap)) - this._horizontalGap);
				}
				else if(this._horizontalAlign == HorizontalAlign.CENTER)
				{
					startX = this._paddingLeft + ((width - this._paddingLeft - this._paddingRight) -
						((actualHorizontalTileCount * (tileWidth + this._horizontalGap)) - this._horizontalGap)) / 2;
				}
			}
			var pageIndex:int = 0;
			var columnIndex:int = 0;
			var lastColumnIndex:int = int((itemCount - 1) / verticalTileCount);
			var nextPageStartIndex:int = perPage;
			var pageStartY:Number = startY;
			var positionX:Number = startX;
			var positionY:Number = startY;
			var columnItemCount:int = 0;
			for(i = 0; i < itemCount; i++)
			{
				item = items[i];
				if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
				{
					continue;
				}
				if(i != 0 && i % verticalTileCount == 0)
				{
					//start of a new column
					positionX += tileWidth + this._horizontalGap;
					positionY = pageStartY;
					columnItemCount = 0;
					columnIndex++;
				}
				if(i == nextPageStartIndex)
				{
					//start of a new page
					pageIndex++;
					nextPageStartIndex += perPage;
					if(this._paging === Direction.HORIZONTAL)
					{
						positionX = startX + width * pageIndex;
						positionY = startY;
					}
					else if(this._paging === Direction.VERTICAL)
					{
						positionX = startX;
						positionY = pageStartY = startY + height * pageIndex;
					}
				}
				if((y < (positionY + (tileHeight / 2))) &&
					((x < (positionX + tileWidth + (this._horizontalGap / 2))) || (columnIndex == lastColumnIndex)))
				{
					dropIndicator.x = positionX;
					dropIndicator.y = positionY - dropIndicator.height / 2;
					dropIndicator.width = tileWidth;
					return;
				}
				positionY += tileHeight + this._verticalGap;

				if(columnItemCount > 0 &&
					(y < (positionY + (tileHeight / 2))) &&
					(y < (pageStartY + height)) && //not on next page
					(positionY + tileHeight) > (height - this._paddingBottom) &&
					(x < (positionX + tileWidth + (this._horizontalGap / 2))))
				{
					//index on next row, but position drop indicator at the end
					//of the current row
					dropIndicator.x = positionX;
					dropIndicator.y = positionY - this._verticalGap - dropIndicator.height / 2;
					dropIndicator.width = tileWidth;
					return;
				}
				columnItemCount++;
			}
			dropIndicator.x = positionX;
			dropIndicator.y = positionY - dropIndicator.height / 2;
			dropIndicator.width = tileWidth;
		}

		/**
		 * @private
		 */
		protected function applyHorizontalAlign(items:Vector.<DisplayObject>, startIndex:int, endIndex:int, totalItemWidth:Number, availableWidth:Number):void
		{
			if(totalItemWidth >= availableWidth)
			{
				return;
			}
			var horizontalAlignOffsetX:Number = 0;
			if(this._horizontalAlign === HorizontalAlign.RIGHT)
			{
				horizontalAlignOffsetX = availableWidth - totalItemWidth;
			}
			else if(this._horizontalAlign !== HorizontalAlign.LEFT)
			{
				//we're going to default to center if we encounter an
				//unknown value
				horizontalAlignOffsetX = Math.round((availableWidth - totalItemWidth) / 2);
			}
			if(horizontalAlignOffsetX != 0)
			{
				for(var i:int = startIndex; i <= endIndex; i++)
				{
					var item:DisplayObject = items[i];
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					item.x += horizontalAlignOffsetX;
				}
			}
		}

		/**
		 * @private
		 */
		protected function applyVerticalAlign(items:Vector.<DisplayObject>, startIndex:int, endIndex:int, totalItemHeight:Number, availableHeight:Number):void
		{
			if(totalItemHeight >= availableHeight)
			{
				return;
			}
			var verticalAlignOffsetY:Number = 0;
			if(this._verticalAlign === VerticalAlign.BOTTOM)
			{
				verticalAlignOffsetY = availableHeight - totalItemHeight;
			}
			else if(this._verticalAlign === VerticalAlign.MIDDLE)
			{
				verticalAlignOffsetY = Math.round((availableHeight - totalItemHeight) / 2);
			}
			if(verticalAlignOffsetY != 0)
			{
				for(var i:int = startIndex; i <= endIndex; i++)
				{
					var item:DisplayObject = items[i];
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					item.y += verticalAlignOffsetY;
				}
			}
		}

		/**
		 * @private
		 */
		protected function getVisibleIndicesAtScrollPositionWithHorizontalPaging(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int>):void
		{
			this.prepareTypicalItem();
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var tileWidth:Number = calculatedTypicalItemWidth;
			var tileHeight:Number = calculatedTypicalItemHeight;
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}

			var verticalTileCount:int = this.calculateVerticalTileCount(tileHeight,
				height, height, this._paddingTop + this._paddingBottom,
				this._verticalGap, this._requestedRowCount, itemCount);
			if(this._distributeHeights)
			{
				tileHeight = (height - this._paddingTop - this._paddingBottom - (verticalTileCount * this._verticalGap) + this._verticalGap) / verticalTileCount;
				if(this._useSquareTiles)
				{
					tileWidth = tileHeight;
				}
			}
			var horizontalTileCount:int = this.calculateHorizontalTileCount(tileWidth,
				width, width, this._paddingLeft + this._paddingRight,
				this._horizontalGap, this._requestedColumnCount, itemCount,
				verticalTileCount, this._distributeWidths && !this._useSquareTiles);
			if(this._distributeWidths && !this._useSquareTiles)
			{
				tileWidth = (width - this._paddingLeft - this._paddingRight - (horizontalTileCount * this._horizontalGap) + this._horizontalGap) / horizontalTileCount;
			}
			var perPage:int = horizontalTileCount * verticalTileCount;
			var minimumItemCount:int = perPage + 2 * verticalTileCount;
			if(minimumItemCount > itemCount)
			{
				minimumItemCount = itemCount;
			}

			var startPageIndex:int = Math.round(scrollX / width);
			var minimum:int = startPageIndex * perPage;
			var totalRowWidth:Number = horizontalTileCount * (tileWidth + this._horizontalGap) - this._horizontalGap;
			var leftSideOffset:Number = 0;
			var rightSideOffset:Number = 0;
			if(totalRowWidth < width)
			{
				if(this._horizontalAlign === HorizontalAlign.RIGHT)
				{
					leftSideOffset = width - this._paddingLeft - this._paddingRight - totalRowWidth;
					rightSideOffset = 0;
				}
				else if(this._horizontalAlign === HorizontalAlign.CENTER)
				{
					leftSideOffset = rightSideOffset = Math.round((width - this._paddingLeft - this._paddingRight - totalRowWidth) / 2);
				}
				else //left
				{
					leftSideOffset = 0;
					rightSideOffset = width - this._paddingLeft - this._paddingRight - totalRowWidth;
				}
			}
			var columnOffset:int = 0;
			var pageStartPosition:Number = startPageIndex * width;
			var partialPageSize:Number = scrollX - pageStartPosition;
			if(partialPageSize < 0)
			{
				partialPageSize = -partialPageSize - this._paddingRight - rightSideOffset;
				if(partialPageSize < 0)
				{
					partialPageSize = 0;
				}
				columnOffset = -Math.floor(partialPageSize / (tileWidth + this._horizontalGap)) - 1;
				minimum += columnOffset * verticalTileCount;
			}
			else if(partialPageSize > 0)
			{
				partialPageSize = partialPageSize - this._paddingLeft - leftSideOffset;
				if(partialPageSize < 0)
				{
					partialPageSize = 0;
				}
				columnOffset = Math.floor(partialPageSize / (tileWidth + this._horizontalGap));
				minimum += columnOffset * verticalTileCount;
			}
			if(minimum < 0)
			{
				minimum = 0;
				columnOffset = 0;
			}

			var maximum:int = minimum + minimumItemCount;
			if(maximum > itemCount)
			{
				maximum = itemCount;
			}
			minimum = maximum - minimumItemCount;
			var resultPushIndex:int = result.length;
			for(var i:int = minimum; i < maximum; i++)
			{
				result[resultPushIndex] = i;
				resultPushIndex++;
			}
		}

		/**
		 * @private
		 */
		protected function getVisibleIndicesAtScrollPositionWithVerticalPaging(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int>):void
		{
			this.prepareTypicalItem();
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var tileWidth:Number = calculatedTypicalItemWidth;
			var tileHeight:Number = calculatedTypicalItemHeight;
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}
			var verticalTileCount:int = this.calculateVerticalTileCount(tileHeight,
				height, height, this._paddingTop + this._paddingBottom,
				this._verticalGap, this._requestedRowCount, itemCount);
			if(this._distributeHeights)
			{
				tileHeight = (height - this._paddingTop - this._paddingBottom - (verticalTileCount * this._verticalGap) + this._verticalGap) / verticalTileCount;
				if(this._useSquareTiles)
				{
					tileWidth = tileHeight;
				}
			}
			var horizontalTileCount:int = this.calculateHorizontalTileCount(tileWidth,
				width, width, this._paddingLeft + this._paddingRight,
				this._horizontalGap, this._requestedColumnCount, itemCount,
				verticalTileCount, this._distributeWidths && !this._useSquareTiles);
			if(this._distributeWidths && !this._useSquareTiles)
			{
				tileWidth = (width - this._paddingLeft - this._paddingRight - (horizontalTileCount * this._horizontalGap) + this._horizontalGap) / horizontalTileCount;
			}
			var perPage:int = horizontalTileCount * verticalTileCount;
			var minimumItemCount:int = perPage + 2 * verticalTileCount;
			if(minimumItemCount > itemCount)
			{
				minimumItemCount = itemCount;
			}

			var startPageIndex:int = Math.round(scrollY / height);
			var minimum:int = startPageIndex * perPage;
			var totalColumnHeight:Number = verticalTileCount * (tileHeight + this._verticalGap) - this._verticalGap;
			var topSideOffset:Number = 0;
			var bottomSideOffset:Number = 0;
			if(totalColumnHeight < height)
			{
				if(this._verticalAlign === VerticalAlign.BOTTOM)
				{
					topSideOffset = height - this._paddingTop - this._paddingBottom - totalColumnHeight;
					bottomSideOffset = 0;
				}
				else if(this._horizontalAlign === VerticalAlign.MIDDLE)
				{
					topSideOffset = bottomSideOffset = Math.round((height - this._paddingTop - this._paddingBottom - totalColumnHeight) / 2);
				}
				else //top
				{
					topSideOffset = 0;
					bottomSideOffset = height - this._paddingTop - this._paddingBottom - totalColumnHeight;
				}
			}
			var rowOffset:int = 0;
			var pageStartPosition:Number = startPageIndex * height;
			var partialPageSize:Number = scrollY - pageStartPosition;
			if(partialPageSize < 0)
			{
				partialPageSize = -partialPageSize - this._paddingBottom - bottomSideOffset;
				if(partialPageSize < 0)
				{
					partialPageSize = 0;
				}
				rowOffset = -Math.floor(partialPageSize / (tileHeight + this._verticalGap)) - 1;
				minimum += -perPage + verticalTileCount + rowOffset;
			}
			else if(partialPageSize > 0)
			{
				partialPageSize = partialPageSize - this._paddingTop - topSideOffset;
				if(partialPageSize < 0)
				{
					partialPageSize = 0;
				}
				rowOffset = Math.floor(partialPageSize / (tileWidth + this._verticalGap));
				minimum += rowOffset;
			}
			if(minimum < 0)
			{
				minimum = 0;
				rowOffset = 0;
			}

			if(minimum + minimumItemCount >= itemCount)
			{
				//an optimized path when we're on or near the last page
				minimum = itemCount - minimumItemCount;
				var resultPushIndex:int = result.length;
				for(var i:int = minimum; i < itemCount; i++)
				{
					result[resultPushIndex] = i;
					resultPushIndex++;
				}
			}
			else
			{
				var columnIndex:int = 0;
				var rowIndex:int = (verticalTileCount + rowOffset) % verticalTileCount;
				var pageStart:int = int(minimum / perPage) * perPage;
				i = minimum;
				var resultLength:int = 0;
				do
				{
					if(i < itemCount)
					{
						result[resultLength] = i;
						resultLength++;
					}
					columnIndex++;
					if(columnIndex == horizontalTileCount)
					{
						columnIndex = 0;
						rowIndex++;
						if(rowIndex == verticalTileCount)
						{
							rowIndex = 0;
							pageStart += perPage;
						}
						i = pageStart + rowIndex - verticalTileCount;
					}
					i += verticalTileCount;
				}
				while(resultLength < minimumItemCount && pageStart < itemCount);
			}
		}

		/**
		 * @private
		 */
		protected function getVisibleIndicesAtScrollPositionWithoutPaging(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int>):void
		{
			this.prepareTypicalItem();
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var tileWidth:Number = calculatedTypicalItemWidth;
			var tileHeight:Number = calculatedTypicalItemHeight;
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}
			var verticalTileCount:int = this.calculateVerticalTileCount(tileHeight,
				height, height, this._paddingTop + this._paddingBottom,
				this._verticalGap, this._requestedRowCount, itemCount);
			if(this._distributeHeights)
			{
				tileHeight = (height - this._paddingTop - this._paddingBottom - (verticalTileCount * this._verticalGap) + this._verticalGap) / verticalTileCount;
				if(this._useSquareTiles)
				{
					tileWidth = tileHeight;
				}
			}
			if(this._distributeWidths && !this._useSquareTiles)
			{
				var horizontalTileCount:int = this.calculateHorizontalTileCount(tileWidth,
					width, width, this._paddingLeft + this._paddingRight,
					this._horizontalGap, this._requestedColumnCount, itemCount,
					verticalTileCount, this._distributeWidths && !this._useSquareTiles);
				tileWidth = (width - this._paddingLeft - this._paddingRight - (horizontalTileCount * this._horizontalGap) + this._horizontalGap) / horizontalTileCount;
			}
			horizontalTileCount = Math.ceil((width + this._horizontalGap) / (tileWidth + this._horizontalGap)) + 1;
			var minimumItemCount:int = verticalTileCount * horizontalTileCount;
			if(minimumItemCount > itemCount)
			{
				minimumItemCount = itemCount;
			}
			var columnIndexOffset:int = 0;
			var totalColumnWidth:Number = Math.ceil(itemCount / verticalTileCount) * (tileWidth + this._horizontalGap) - this._horizontalGap;
			if(totalColumnWidth < width)
			{
				if(this._verticalAlign === VerticalAlign.BOTTOM)
				{
					columnIndexOffset = Math.ceil((width - totalColumnWidth) / (tileWidth + this._horizontalGap));
				}
				else if(this._verticalAlign === VerticalAlign.MIDDLE)
				{
					columnIndexOffset = Math.ceil((width - totalColumnWidth) / (tileWidth + this._horizontalGap) / 2);
				}
			}
			var columnIndex:int = -columnIndexOffset + Math.floor((scrollX - this._paddingLeft + this._horizontalGap) / (tileWidth + this._horizontalGap));
			var minimum:int = columnIndex * verticalTileCount;
			if(minimum < 0)
			{
				minimum = 0;
			}
			var maximum:int = minimum + minimumItemCount;
			if(maximum > itemCount)
			{
				maximum = itemCount;
			}
			minimum = maximum - minimumItemCount;
			var resultPushIndex:int = result.length;
			for(var i:int = minimum; i < maximum; i++)
			{
				result[resultPushIndex] = i;
				resultPushIndex++;
			}
		}

		/**
		 * @private
		 */
		protected function validateItems(items:Vector.<DisplayObject>):void
		{
			var itemCount:int = items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
				{
					continue;
				}
				if(item is IValidating)
				{
					IValidating(item).validate();
				}
			}
		}

		/**
		 * @private
		 */
		protected function prepareTypicalItem():void
		{
			if(!this._typicalItem)
			{
				return;
			}
			if(this._resetTypicalItemDimensionsOnMeasure)
			{
				this._typicalItem.width = this._typicalItemWidth;
				this._typicalItem.height = this._typicalItemHeight;
			}
			if(this._typicalItem is IValidating)
			{
				IValidating(this._typicalItem).validate();
			}
		}

		/**
		 * @private
		 */
		protected function calculateScrollPositionForIndex(index:int, items:Vector.<DisplayObject>, x:Number, y:Number,
			width:Number, height:Number, result:Point = null, nearest:Boolean = false, scrollX:Number = 0, scrollY:Number = 0):Point
		{
			if(!result)
			{
				result = new Point();
			}
			if(this._useVirtualLayout)
			{
				this.prepareTypicalItem();
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var itemCount:int = items.length;
			var tileWidth:Number = this._useVirtualLayout ? calculatedTypicalItemWidth : 0;
			var tileHeight:Number = this._useVirtualLayout ? calculatedTypicalItemHeight : 0;
			//a virtual layout assumes that all items are the same size as
			//the typical item, so we don't need to measure every item in
			//that case
			if(!this._useVirtualLayout)
			{
				for(var i:int = 0; i < itemCount; i++)
				{
					var item:DisplayObject = items[i];
					if(!item)
					{
						continue;
					}
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					var itemWidth:Number = item.width;
					var itemHeight:Number = item.height;
					if(itemWidth > tileWidth)
					{
						tileWidth = itemWidth;
					}
					if(itemHeight > tileHeight)
					{
						tileHeight = itemHeight;
					}
				}
			}
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}
			var verticalTileCount:int = (height - this._paddingTop - this._paddingBottom + this._verticalGap) / (tileHeight + this._verticalGap);
			if(verticalTileCount < 1)
			{
				verticalTileCount = 1;
			}
			else if(this._requestedRowCount > 0 && verticalTileCount > this._requestedRowCount)
			{
				verticalTileCount = this._requestedRowCount;
			}
			if(this._paging !== Direction.NONE)
			{
				var horizontalTileCount:int = (width - this._paddingLeft - this._paddingRight + this._horizontalGap) / (tileWidth + this._horizontalGap);
				if(horizontalTileCount < 1)
				{
					horizontalTileCount = 1;
				}
				var perPage:Number = horizontalTileCount * verticalTileCount;
				var pageIndex:int = index / perPage;
				if(this._paging === Direction.HORIZONTAL)
				{
					result.x = pageIndex * width;
					result.y = 0;
				}
				else
				{
					result.x = 0;
					result.y = pageIndex * height;
				}
			}
			else
			{
				var resultX:Number = this._paddingLeft + ((tileWidth + this._horizontalGap) * int(index / verticalTileCount));
				if(nearest)
				{
					var rightPosition:Number = resultX - (width - tileWidth);
					if(scrollX >= rightPosition && scrollX <= resultX)
					{
						//keep the current scroll position because the item is already
						//fully visible
						resultX = scrollX;
					}
					else
					{
						var leftDifference:Number = Math.abs(resultX - scrollX);
						var rightDifference:Number = Math.abs(rightPosition - scrollX);
						if(rightDifference < leftDifference)
						{
							resultX = rightPosition;
						}
					}
				}
				else
				{
					resultX -= Math.round((width - tileWidth) / 2);
				}
				result.x = resultX;
				result.y = 0;
			}
			return result;
		}

		/**
		 * @private
		 */
		protected function calculateHorizontalTileCount(tileWidth:Number,
			explicitWidth:Number, maxWidth:Number, paddingLeftAndRight:Number,
			horizontalGap:Number, requestedColumnCount:int, totalItemCount:int,
			verticalTileCount:int, distributeWidths:Boolean):int
		{
			//using the horizontal tile count, calculate how many rows would be
			//required for the total number of items if there were no restrictions.
			var defaultHorizontalTileCount:int = Math.ceil(totalItemCount / verticalTileCount);
			if(distributeWidths)
			{
				if(requestedColumnCount > 0 && defaultHorizontalTileCount > requestedColumnCount)
				{
					return requestedColumnCount;
				}
				return defaultHorizontalTileCount;
			}

			var tileCount:int;
			if(explicitWidth === explicitWidth) //!isNaN
			{
				//in this case, the exact width is known
				tileCount = (explicitWidth - paddingLeftAndRight + horizontalGap) / (tileWidth + horizontalGap);
				if(requestedColumnCount > 0 && tileCount > requestedColumnCount)
				{
					return requestedColumnCount;
				}
				if(tileCount > defaultHorizontalTileCount)
				{
					tileCount = defaultHorizontalTileCount;
				}
				if(tileCount < 1)
				{
					//we must have at least one tile per row
					tileCount = 1;
				}
				return tileCount;
			}

			//in this case, the width is not known, but it may have a maximum
			if(requestedColumnCount > 0)
			{
				tileCount = requestedColumnCount;
			}
			else
			{
				tileCount = defaultHorizontalTileCount;
			}

			var maxTileCount:int = int.MAX_VALUE;
			if(maxWidth === maxWidth && //!isNaN
				maxWidth < Number.POSITIVE_INFINITY)
			{
				maxTileCount = (maxWidth - paddingLeftAndRight + horizontalGap) / (tileWidth + horizontalGap);
				if(maxTileCount < 1)
				{
					//we must have at least one tile per row
					maxTileCount = 1;
				}
			}
			if(tileCount > maxTileCount)
			{
				tileCount = maxTileCount;
			}
			if(tileCount < 1)
			{
				//we must have at least one tile per row
				tileCount = 1;
			}
			return tileCount;
		}

		/**
		 * @private
		 */
		protected function calculateVerticalTileCount(tileHeight:Number,
			explicitHeight:Number, maxHeight:Number, paddingTopAndBottom:Number,
			verticalGap:Number, requestedRowCount:int, totalItemCount:int):int
		{
			if(requestedRowCount > 0 && this._distributeHeights)
			{
				return requestedRowCount;
			}
			var verticalTileCount:int;
			if(explicitHeight === explicitHeight) //!isNaN
			{
				//in this case, the exact height is known
				verticalTileCount = (explicitHeight - paddingTopAndBottom + verticalGap) / (tileHeight + verticalGap);
				if(requestedRowCount > 0 && verticalTileCount > requestedRowCount)
				{
					return requestedRowCount;
				}
				if(verticalTileCount > totalItemCount)
				{
					verticalTileCount = totalItemCount;
				}
				if(verticalTileCount < 1)
				{
					//we must have at least one tile per row
					verticalTileCount = 1;
				}
				return verticalTileCount;
			}

			//in this case, the height is not known, but it may have a maximum
			if(requestedRowCount > 0)
			{
				verticalTileCount = requestedRowCount;
			}
			else
			{
				verticalTileCount = totalItemCount;
			}

			var maxVerticalTileCount:int = int.MAX_VALUE;
			if(maxHeight === maxHeight && //!isNaN
				maxHeight < Number.POSITIVE_INFINITY)
			{
				maxVerticalTileCount = (maxHeight - paddingTopAndBottom + verticalGap) / (tileHeight + verticalGap);
				if(maxVerticalTileCount < 1)
				{
					//we must have at least one tile per row
					maxVerticalTileCount = 1;
				}
			}
			if(verticalTileCount > maxVerticalTileCount)
			{
				verticalTileCount = maxVerticalTileCount;
			}
			if(verticalTileCount < 1)
			{
				//we must have at least one tile per row
				verticalTileCount = 1;
			}
			return verticalTileCount;
		}
	}
}


================================================
FILE: source/feathers/layout/TiledRowsLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import feathers.core.IValidating;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;
	import flash.ui.Keyboard;

	import starling.display.DisplayObject;

	/**
	 * Positions items as tiles (equal width and height) from left to right
	 * in multiple rows. Constrained to the suggested width, the tiled rows
	 * layout will change in height as the number of items increases or
	 * decreases.
	 *
	 * @see ../../../help/tiled-rows-layout.html How to use TiledRowsLayout with Feathers containers
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class TiledRowsLayout extends BaseTiledLayout implements IVirtualLayout, IDragDropLayout
	{
		/**
		 * Constructor.
		 */
		public function TiledRowsLayout()
		{
			super();
		}

		/**
		 * Requests that the layout uses a specific number of columns in a row,
		 * if possible. Set to <code>0</code> to calculate the maximum of
		 * columns that will fit in the available space.
		 *
		 * <p>If the view port's explicit or maximum width is not large enough
		 * to fit the requested number of columns, it will use fewer. If the
		 * view port doesn't have an explicit width and the maximum width is
		 * equal to <code>Number.POSITIVE_INFINITY</code>, the width will be
		 * calculated automatically to fit the exact number of requested
		 * columns.</p>
		 *
		 * <p>If paging is enabled, this value will be used to calculate the
		 * number of columns in a page. If paging isn't enabled, this value will
		 * be used to calculate a minimum number of columns, even if there
		 * aren't enough items to fill each column.</p>
		 *
		 * @default 0
		 */
		override public function get requestedColumnCount():int
		{
			//this is an override so that this class can have its own documentation.
			return this._requestedColumnCount;
		}

		/**
		 * Requests that the layout uses a specific number of rows, if possible.
		 * If the view port's explicit or maximum height is not large enough to
		 * fit the requested number of rows, it will use fewer. Set to <code>0</code>
		 * to calculate the number of rows automatically based on width and
		 * height.
		 *
		 * <p>If paging is enabled, this value will be used to calculate the
		 * number of rows in a page. If paging isn't enabled, this value will
		 * be used to calculate a minimum number of rows, even if there aren't
		 * enough items to fill each row.</p>
		 *
		 * @default 0
		 */
		override public function get requestedRowCount():int
		{
			//this is an override so that this class can have its own documentation.
			return this._requestedRowCount;
		}

		/**
		 * If the total combined height of the rows is larger than the height
		 * of the view port, the layout will be split into pages where each
		 * page is filled with the maximum number of rows that may be displayed
		 * without cutting off any items.
		 *
		 * @default feathers.layout.Direction.NONE
		 *
		 * @see feathers.layout.Direction#NONE
		 * @see feathers.layout.Direction#HORIZONTAL
		 * @see feathers.layout.Direction#VERTICAL
		 */
		override public function get paging():String
		{
			//this is an override so that this class can have its own documentation.
			return this._paging;
		}

		/**
		 * If the total width of the tiles in a row (minus padding and gap)
		 * does not fill the entire row, the remaining space will be distributed
		 * to each tile equally.
		 *
		 * <p>If the container using the layout might resize, setting
		 * <code>requestedColumnCount</code> is recommended because the tiles
		 * will resize too, and their dimensions may not be reset.</p>
		 *
		 * @default false
		 *
		 * @see #requestedColumnCount
		 */
		override public function get distributeWidths():Boolean
		{
			return this._distributeWidths;
		}

		/**
		 * If the total height of the tiles in a column (minus padding and gap)
		 * does not fill the entire column, the remaining space will be
		 * distributed to each tile equally.
		 *
		 * <p>If the container using the layout might resize, setting
		 * <code>requestedRowCount</code> is recommended because the tiles
		 * will resize too, and their dimensions may not be reset.</p>
		 *
		 * <p>Note: If the <code>distributeHeights</code> property is set to
		 * <code>true</code>, the <code>useSquareTiles</code> property will be
		 * automatically changed to <code>false</code>.</p>
		 *
		 * @default false
		 *
		 * @see #requestedRowCount
		 * @see #useSquareTiles
		 */
		override public function get distributeHeights():Boolean
		{
			return this._distributeHeights;
		}

		/**
		 * @private
		 */
		override public function set distributeHeights(value:Boolean):void
		{
			super.distributeHeights = value;
			if(value)
			{
				this.useSquareTiles = false;
			}
		}

		/**
		 * @inheritDoc
		 */
		public function layout(items:Vector.<DisplayObject>, viewPortBounds:ViewPortBounds = null, result:LayoutBoundsResult = null):LayoutBoundsResult
		{
			if(!result)
			{
				result = new LayoutBoundsResult();
			}
			if(items.length == 0)
			{
				result.contentX = 0;
				result.contentY = 0;
				result.contentWidth = this._paddingLeft + this._paddingRight;
				result.contentHeight = this._paddingTop + this._paddingBottom;
				result.viewPortWidth = result.contentWidth;
				result.viewPortHeight = result.contentHeight;
				return result;
			}

			var scrollX:Number = viewPortBounds ? viewPortBounds.scrollX : 0;
			var scrollY:Number = viewPortBounds ? viewPortBounds.scrollY : 0;
			var boundsX:Number = viewPortBounds ? viewPortBounds.x : 0;
			var boundsY:Number = viewPortBounds ? viewPortBounds.y : 0;
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;
			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;

			if(this._useVirtualLayout)
			{
				this.prepareTypicalItem();
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			this.validateItems(items);

			this._discoveredItemsCache.length = 0;
			var itemCount:int = items.length;
			var tileWidth:Number = 0;
			var tileHeight:Number = 0;
			if(this._useVirtualLayout)
			{
				//a virtual layout assumes that all items are the same size as
				//the typical item, so we don't need to measure every item in
				//that case
				tileWidth = calculatedTypicalItemWidth;
				tileHeight = calculatedTypicalItemHeight;
			}
			else
			{
				for(var i:int = 0; i < itemCount; i++)
				{
					var item:DisplayObject = items[i];
					if(!item)
					{
						continue;
					}
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					var itemWidth:Number = item.width;
					var itemHeight:Number = item.height;
					if(itemWidth > tileWidth)
					{
						tileWidth = itemWidth;
					}
					if(itemHeight > tileHeight)
					{
						tileHeight = itemHeight;
					}
				}
			}
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}

			var horizontalTileCount:int = this.calculateHorizontalTileCount(tileWidth,
				explicitWidth, maxWidth, this._paddingLeft + this._paddingRight,
				this._horizontalGap, this._requestedColumnCount, itemCount);
			if(explicitWidth === explicitWidth) //!isNaN
			{
				var availableWidth:Number = explicitWidth;
			}
			else
			{
				availableWidth = this._paddingLeft + this._paddingRight + ((tileWidth + this._horizontalGap) * horizontalTileCount) - this._horizontalGap;
				if(availableWidth < minWidth)
				{
					availableWidth = minWidth;
				}
				else if(availableWidth > maxWidth)
				{
					availableWidth = maxWidth;
				}
			}
			if(this._distributeWidths)
			{
				//distribute remaining space
				tileWidth = (availableWidth - this._paddingLeft - this._paddingRight - (horizontalTileCount * this._horizontalGap) + this._horizontalGap) / horizontalTileCount;
				if(this._useSquareTiles)
				{
					tileHeight = tileWidth;
				}
			}
			var verticalTileCount:int = this.calculateVerticalTileCount(tileHeight,
				explicitHeight, maxHeight, this._paddingTop + this._paddingBottom,
				this._verticalGap, this._requestedRowCount, itemCount,
				horizontalTileCount, this._distributeHeights && !this._useSquareTiles);
			if(explicitHeight === explicitHeight) //!isNaN
			{
				var availableHeight:Number = explicitHeight;
			}
			else
			{
				availableHeight = this._paddingTop + this._paddingBottom + ((tileHeight + this._verticalGap) * verticalTileCount) - this._verticalGap;
				if(availableHeight < minHeight)
				{
					availableHeight = minHeight;
				}
				else if(availableHeight > maxHeight)
				{
					availableHeight = maxHeight;
				}
			}
			if(this._distributeHeights && !this._useSquareTiles)
			{
				//distribute remaining space
				tileHeight = (availableHeight - this._paddingTop - this._paddingBottom - (verticalTileCount * this._verticalGap) + this._verticalGap) / verticalTileCount;
			}

			var totalPageContentWidth:Number = horizontalTileCount * (tileWidth + this._horizontalGap) - this._horizontalGap + this._paddingLeft + this._paddingRight;
			var totalPageContentHeight:Number = verticalTileCount * (tileHeight + this._verticalGap) - this._verticalGap + this._paddingTop + this._paddingBottom;

			var startX:Number = boundsX + this._paddingLeft;
			var startY:Number = boundsY + this._paddingTop;

			var perPage:int = horizontalTileCount * verticalTileCount;
			var pageIndex:int = 0;
			var nextPageStartIndex:int = perPage;
			var pageStartX:Number = startX;
			var positionX:Number = startX;
			var positionY:Number = startY;
			var itemIndex:int = 0;
			var discoveredItemsCachePushIndex:int = 0;
			for(i = 0; i < itemCount; i++)
			{
				item = items[i];
				if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
				{
					continue;
				}
				if(itemIndex != 0 && itemIndex % horizontalTileCount == 0)
				{
					positionX = pageStartX;
					positionY += tileHeight + this._verticalGap;
				}
				if(itemIndex == nextPageStartIndex)
				{
					//we're starting a new page, so handle alignment of the
					//items on the current page and update the positions
					if(this._paging !== Direction.NONE)
					{
						var discoveredItems:Vector.<DisplayObject> = this._useVirtualLayout ? this._discoveredItemsCache : items;
						var discoveredItemsFirstIndex:int = this._useVirtualLayout ? 0 : (itemIndex - perPage);
						var discoveredItemsLastIndex:int = this._useVirtualLayout ? (this._discoveredItemsCache.length - 1) : (itemIndex - 1);
						this.applyHorizontalAlign(discoveredItems, discoveredItemsFirstIndex, discoveredItemsLastIndex, totalPageContentWidth, availableWidth);
						this.applyVerticalAlign(discoveredItems, discoveredItemsFirstIndex, discoveredItemsLastIndex, totalPageContentHeight, availableHeight);
						this._discoveredItemsCache.length = 0;
						discoveredItemsCachePushIndex = 0;
					}
					pageIndex++;
					nextPageStartIndex += perPage;

					//we can use availableWidth and availableHeight here without
					//checking if they're NaN because we will never reach a
					//new page without them already being calculated.
					if(this._paging === Direction.HORIZONTAL)
					{
						positionX = pageStartX = startX + availableWidth * pageIndex;
						positionY = startY;
					}
					else if(this._paging === Direction.VERTICAL)
					{
						positionY = startY + availableHeight * pageIndex;
					}
				}
				if(item)
				{
					switch(this._tileHorizontalAlign)
					{
						case HorizontalAlign.JUSTIFY:
						{
							item.x = item.pivotX + positionX;
							item.width = tileWidth;
							break;
						}
						case HorizontalAlign.LEFT:
						{
							item.x = item.pivotX + positionX;
							break;
						}
						case HorizontalAlign.RIGHT:
						{
							item.x = item.pivotX + positionX + tileWidth - item.width;
							break;
						}
						default: //center or unknown
						{
							item.x = item.pivotX + positionX + Math.round((tileWidth - item.width) / 2);
						}
					}
					switch(this._tileVerticalAlign)
					{
						case VerticalAlign.JUSTIFY:
						{
							item.y = item.pivotY + positionY;
							item.height = tileHeight;
							break;
						}
						case VerticalAlign.TOP:
						{
							item.y = item.pivotY + positionY;
							break;
						}
						case VerticalAlign.BOTTOM:
						{
							item.y = item.pivotY + positionY + tileHeight - item.height;
							break;
						}
						default: //middle or unknown
						{
							item.y = item.pivotY + positionY + Math.round((tileHeight - item.height) / 2);
						}
					}
					if(this._useVirtualLayout)
					{
						this._discoveredItemsCache[discoveredItemsCachePushIndex] = item;
						discoveredItemsCachePushIndex++;
					}
				}
				positionX += tileWidth + this._horizontalGap;
				itemIndex++;
			}
			//align the last page
			if(this._paging !== Direction.NONE)
			{
				discoveredItems = this._useVirtualLayout ? this._discoveredItemsCache : items;
				discoveredItemsFirstIndex = this._useVirtualLayout ? 0 : (nextPageStartIndex - perPage);
				discoveredItemsLastIndex = this._useVirtualLayout ? (discoveredItems.length - 1) : (i - 1);
				this.applyHorizontalAlign(discoveredItems, discoveredItemsFirstIndex, discoveredItemsLastIndex, totalPageContentWidth, availableWidth);
				this.applyVerticalAlign(discoveredItems, discoveredItemsFirstIndex, discoveredItemsLastIndex, totalPageContentHeight, availableHeight);
			}

			if(this._paging === Direction.HORIZONTAL)
			{
				var totalWidth:Number = Math.ceil(itemCount / perPage) * availableWidth;
			}
			else //vertical or none
			{
				totalWidth = totalPageContentWidth;
			}
			if(this._paging === Direction.HORIZONTAL)
			{
				var totalHeight:Number = availableHeight;
			}
			else if(this._paging === Direction.VERTICAL)
			{
				totalHeight = Math.ceil(itemCount / perPage) * availableHeight;
			}
			else //none
			{
				totalHeight = positionY + tileHeight + this._paddingBottom;
				if(totalHeight < totalPageContentHeight)
				{
					totalHeight = totalPageContentHeight;
				}
			}

			if(this._paging === Direction.NONE)
			{
				discoveredItems = this._useVirtualLayout ? this._discoveredItemsCache : items;
				discoveredItemsLastIndex = discoveredItems.length - 1;
				this.applyHorizontalAlign(discoveredItems, 0, discoveredItemsLastIndex, totalWidth, availableWidth);
				this.applyVerticalAlign(discoveredItems, 0, discoveredItemsLastIndex, totalHeight, availableHeight);
			}
			this._discoveredItemsCache.length = 0;

			result.contentX = 0;
			result.contentY = 0;
			result.contentWidth = totalWidth;
			result.contentHeight = totalHeight;
			result.viewPortWidth = availableWidth;
			result.viewPortHeight = availableHeight;

			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function measureViewPort(itemCount:int, viewPortBounds:ViewPortBounds = null, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("measureViewPort() may be called only if useVirtualLayout is true.");
			}

			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;
			var needsWidth:Boolean = explicitWidth !== explicitWidth; //isNaN;
			var needsHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			if(!needsWidth && !needsHeight)
			{
				result.x = explicitWidth;
				result.y = explicitHeight;
				return result;
			}
			var boundsX:Number = viewPortBounds ? viewPortBounds.x : 0;
			var boundsY:Number = viewPortBounds ? viewPortBounds.y : 0;
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;

			this.prepareTypicalItem();
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var tileWidth:Number = calculatedTypicalItemWidth;
			var tileHeight:Number = calculatedTypicalItemHeight;
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}

			var horizontalTileCount:int = this.calculateHorizontalTileCount(tileWidth,
				explicitWidth, maxWidth, this._paddingLeft + this._paddingRight,
				this._horizontalGap, this._requestedColumnCount, itemCount);
			var verticalTileCount:int = this.calculateVerticalTileCount(tileHeight,
				explicitHeight, maxHeight, this._paddingTop + this._paddingBottom,
				this._verticalGap, this._requestedRowCount, itemCount,
				horizontalTileCount, this._distributeHeights && !this._useSquareTiles);
			if(explicitWidth === explicitWidth) //!isNaN
			{
				var availableWidth:Number = explicitWidth;
			}
			else
			{
				availableWidth = this._paddingLeft + this._paddingRight + ((tileWidth + this._horizontalGap) * horizontalTileCount) - this._horizontalGap;
				if(availableWidth < minWidth)
				{
					availableWidth = minWidth;
				}
				else if(availableWidth > maxWidth)
				{
					availableWidth = maxWidth;
				}
			}
			if(explicitHeight === explicitHeight) //!isNaN
			{
				var availableHeight:Number = explicitHeight;
			}
			else
			{
				availableHeight = this._paddingTop + this._paddingBottom + ((tileHeight + this._verticalGap) * verticalTileCount) - this._verticalGap;
				if(availableHeight < minHeight)
				{
					availableHeight = minHeight;
				}
				else if(availableHeight > maxHeight)
				{
					availableHeight = maxHeight;
				}
			}

			var totalPageContentWidth:Number = horizontalTileCount * (tileWidth + this._horizontalGap) - this._horizontalGap + this._paddingLeft + this._paddingRight;
			var totalPageContentHeight:Number = verticalTileCount * (tileHeight + this._verticalGap) - this._verticalGap + this._paddingTop + this._paddingBottom;

			var startX:Number = boundsX + this._paddingLeft;
			var startY:Number = boundsY + this._paddingTop;

			var perPage:int = horizontalTileCount * verticalTileCount;
			var pageIndex:int = 0;
			var nextPageStartIndex:int = perPage;
			var pageStartX:Number = startX;
			var positionX:Number = startX;
			var positionY:Number = startY;
			for(var i:int = 0; i < itemCount; i++)
			{
				if(i != 0 && i % horizontalTileCount == 0)
				{
					positionX = pageStartX;
					positionY += tileHeight + this._verticalGap;
				}
				if(i == nextPageStartIndex)
				{
					pageIndex++;
					nextPageStartIndex += perPage;

					//we can use availableWidth and availableHeight here without
					//checking if they're NaN because we will never reach a
					//new page without them already being calculated.
					if(this._paging === Direction.HORIZONTAL)
					{
						positionX = pageStartX = startX + availableWidth * pageIndex;
						positionY = startY;
					}
					else if(this._paging === Direction.VERTICAL)
					{
						positionY = startY + availableHeight * pageIndex;
					}
				}
			}

			if(this._paging === Direction.HORIZONTAL)
			{
				var totalWidth:Number = Math.ceil(itemCount / perPage) * availableWidth;
			}
			else
			{
				totalWidth = totalPageContentWidth;
			}
			if(this._paging === Direction.HORIZONTAL)
			{
				var totalHeight:Number = availableHeight;
			}
			else if(this._paging === Direction.VERTICAL)
			{
				totalHeight = Math.ceil(itemCount / perPage) * availableHeight;
			}
			else
			{
				totalHeight = positionY + tileHeight + this._paddingBottom;
				if(totalHeight < totalPageContentHeight)
				{
					totalHeight = totalPageContentHeight;
				}
			}

			if(needsWidth)
			{
				var resultX:Number = totalWidth;
				if(resultX < minWidth)
				{
					resultX = minWidth;
				}
				else if(resultX > maxWidth)
				{
					resultX = maxWidth;
				}
				result.x = resultX;
			}
			else
			{
				result.x = explicitWidth;
			}
			if(needsHeight)
			{
				var resultY:Number = totalHeight;
				if(resultY < minHeight)
				{
					resultY = minHeight;
				}
				else if(resultY > maxHeight)
				{
					resultY = maxHeight;
				}
				result.y = resultY;
			}
			else
			{
				result.y = explicitHeight;
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getVisibleIndicesAtScrollPosition(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int> = null):Vector.<int>
		{
			if(result)
			{
				result.length = 0;
			}
			else
			{
				result = new <int>[];
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("getVisibleIndicesAtScrollPosition() may be called only if useVirtualLayout is true.");
			}

			if(this._paging === Direction.HORIZONTAL)
			{
				this.getVisibleIndicesAtScrollPositionWithHorizontalPaging(scrollX, scrollY, width, height, itemCount, result);
			}
			else if(this._paging === Direction.VERTICAL)
			{
				this.getVisibleIndicesAtScrollPositionWithVerticalPaging(scrollX, scrollY, width, height, itemCount, result);
			}
			else //none
			{
				this.getVisibleIndicesAtScrollPositionWithoutPaging(scrollX, scrollY, width, height, itemCount, result);
			}

			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function calculateNavigationDestination(items:Vector.<DisplayObject>, index:int, keyCode:uint, bounds:LayoutBoundsResult):int
		{
			var itemCount:int = items.length;
			if(keyCode == Keyboard.HOME)
			{
				return 0;
			}
			else if(keyCode == Keyboard.END)
			{
				return itemCount - 1;
			}

			if(this._useVirtualLayout)
			{
				this.prepareTypicalItem();
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			this.validateItems(items);

			this._discoveredItemsCache.length = 0;
			var tileWidth:Number = 0;
			var tileHeight:Number = 0;
			if(this._useVirtualLayout)
			{
				//a virtual layout assumes that all items are the same size as
				//the typical item, so we don't need to measure every item in
				//that case
				tileWidth = calculatedTypicalItemWidth;
				tileHeight = calculatedTypicalItemHeight;
			}
			else
			{
				for(var i:int = 0; i < itemCount; i++)
				{
					var item:DisplayObject = items[i];
					if(!item)
					{
						continue;
					}
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					var itemWidth:Number = item.width;
					var itemHeight:Number = item.height;
					if(itemWidth > tileWidth)
					{
						tileWidth = itemWidth;
					}
					if(itemHeight > tileHeight)
					{
						tileHeight = itemHeight;
					}
				}
			}
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}

			var availableWidth:Number = bounds.viewPortWidth;
			var horizontalTileCount:int = this.calculateHorizontalTileCount(tileWidth,
				availableWidth, Number.POSITIVE_INFINITY, this._paddingLeft + this._paddingRight,
				this._horizontalGap, this._requestedColumnCount, itemCount);
			var pageHorizontalTileCount:int = horizontalTileCount;
			var pageVerticalTileCount:int = this.calculateVerticalTileCount(tileHeight,
				bounds.viewPortHeight, Number.POSITIVE_INFINITY, this._paddingTop + this._paddingBottom,
				this._verticalGap, this._requestedRowCount, itemCount,
				pageHorizontalTileCount, this._distributeHeights && !this._useSquareTiles);
			var verticalTileCount:int = Math.ceil(itemCount / horizontalTileCount);
			var rowIndex:int = index / pageHorizontalTileCount;
			var columnIndex:int = index % pageHorizontalTileCount;
			if(this._paging === Direction.HORIZONTAL)
			{
				verticalTileCount = pageVerticalTileCount;
				var perPage:Number = pageHorizontalTileCount * pageVerticalTileCount;
				var pageCount:int = Math.ceil(itemCount / perPage);
				horizontalTileCount *= pageCount;
				while(rowIndex >= verticalTileCount)
				{
					rowIndex -= verticalTileCount;
					columnIndex += pageHorizontalTileCount;
				}
			}

			if(keyCode == Keyboard.PAGE_UP)
			{
				if(this._paging === Direction.HORIZONTAL)
				{
					columnIndex -= pageHorizontalTileCount;
				}
				else
				{
					rowIndex -= pageVerticalTileCount;
				}
			}
			else if(keyCode == Keyboard.PAGE_DOWN)
			{
				if(this._paging === Direction.HORIZONTAL)
				{
					columnIndex += pageHorizontalTileCount;
				}
				else
				{
					rowIndex += pageVerticalTileCount;
				}
			}
			else if(keyCode == Keyboard.UP)
			{
				rowIndex--;
			}
			else if(keyCode == Keyboard.DOWN)
			{
				rowIndex++;
			}
			else if(keyCode == Keyboard.LEFT)
			{
				columnIndex--;
			}
			else if(keyCode == Keyboard.RIGHT)
			{
				columnIndex++;
			}
			if(rowIndex < 0)
			{
				rowIndex = 0;
			}
			else if(rowIndex >= verticalTileCount)
			{
				rowIndex = verticalTileCount - 1;
			}
			if(columnIndex < 0)
			{
				columnIndex = 0;
			}
			else if(columnIndex >= horizontalTileCount)
			{
				columnIndex = horizontalTileCount - 1;
			}
			if(this._paging === Direction.HORIZONTAL)
			{
				while(columnIndex >= pageHorizontalTileCount)
				{
					columnIndex -= pageHorizontalTileCount;
					rowIndex += verticalTileCount;
				}
			}
			var result:int = rowIndex * pageHorizontalTileCount + columnIndex;
			if(result >= itemCount)
			{
				//nothing at this column on the next row
				result = itemCount - 1;
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getNearestScrollPositionForIndex(index:int, scrollX:Number, scrollY:Number, items:Vector.<DisplayObject>,
			x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			return this.calculateScrollPositionForIndex(index, items, x, y, width, height, result, true, scrollX, scrollY);
		}

		/**
		 * @inheritDoc
		 */
		public function getScrollPositionForIndex(index:int, items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			return this.calculateScrollPositionForIndex(index, items, x, y, width, height, result, false);
		}

		/**
		 * @inheritDoc
		 */
		public function getDropIndex(x:Number, y:Number, items:Vector.<DisplayObject>,
			boundsX:Number, boundsY:Number, width:Number, height:Number):int
		{
			if(this._useVirtualLayout)
			{
				this.prepareTypicalItem();
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var itemCount:int = items.length;
			var tileWidth:Number = this._useVirtualLayout ? calculatedTypicalItemWidth : 0;
			var tileHeight:Number = this._useVirtualLayout ? calculatedTypicalItemHeight : 0;
			//a virtual layout assumes that all items are the same size as
			//the typical item, so we don't need to measure every item in
			//that case
			if(!this._useVirtualLayout)
			{
				for(var i:int = 0; i < itemCount; i++)
				{
					var item:DisplayObject = items[i];
					if(!item)
					{
						continue;
					}
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					var itemWidth:Number = item.width;
					var itemHeight:Number = item.height;
					if(itemWidth > tileWidth)
					{
						tileWidth = itemWidth;
					}
					if(itemHeight > tileHeight)
					{
						tileHeight = itemHeight;
					}
				}
			}
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}
			var horizontalTileCount:int = (width - this._paddingLeft - this._paddingRight + this._horizontalGap) / (tileWidth + this._horizontalGap);
			if(horizontalTileCount < 1)
			{
				horizontalTileCount = 1;
			}
			else if(this._requestedColumnCount > 0 && horizontalTileCount > this._requestedColumnCount)
			{
				horizontalTileCount = this._requestedColumnCount;
			}
			var verticalTileCount:int = (height - this._paddingTop - this._paddingBottom + this._verticalGap) / (tileHeight + this._verticalGap);
			if(verticalTileCount < 1)
			{
				verticalTileCount = 1;
			}
			else if(this._requestedRowCount > 0 && verticalTileCount > this._requestedRowCount)
			{
				verticalTileCount = this._requestedRowCount;
			}
			var perPage:Number = horizontalTileCount * verticalTileCount;
			var startX:Number = boundsX + this._paddingLeft;
			var actualHorizontalTileCount:int = horizontalTileCount;
			if(actualHorizontalTileCount > itemCount)
			{
				actualHorizontalTileCount = itemCount;
			}
			if(this._horizontalAlign == HorizontalAlign.RIGHT)
			{
				startX = boundsX + this._paddingLeft + (width - this._paddingLeft - this._paddingRight) -
					((actualHorizontalTileCount * (tileWidth + this._horizontalGap)) - this._horizontalGap);
			}
			else if(this._horizontalAlign == HorizontalAlign.CENTER)
			{
				startX = boundsX + this._paddingLeft + ((width - this._paddingLeft - this._paddingRight) -
					((actualHorizontalTileCount * (tileWidth + this._horizontalGap)) - this._horizontalGap)) / 2;
			}
			var startY:Number = boundsY + this._paddingTop;
			if(this._paging != Direction.NONE || itemCount <= perPage)
			{
				var actualVerticalTileCount:int = verticalTileCount;
				if(itemCount <= perPage)
				{
					actualVerticalTileCount = Math.ceil(itemCount / actualHorizontalTileCount);
				}
				if(this._verticalAlign == VerticalAlign.BOTTOM)
				{
					startY = boundsY + this._paddingTop + (height - this._paddingTop - this._paddingBottom) -
						((actualVerticalTileCount * (tileHeight + this._verticalGap)) - this._verticalGap);
				}
				else if(this._verticalAlign == VerticalAlign.MIDDLE)
				{
					startY = boundsY + this._paddingTop + ((height - this._paddingTop - this._paddingBottom) -
						((actualVerticalTileCount * (tileHeight + this._verticalGap)) - this._verticalGap)) / 2;
				}
			}
			var pageIndex:int = 0;
			var rowIndex:int = 0;
			var lastRowIndex:int = int((itemCount - 1) / horizontalTileCount);
			var nextPageStartIndex:int = perPage;
			var pageStartX:Number = startX;
			var positionX:Number = startX;
			var positionY:Number = startY;
			for(i = 0; i < itemCount; i++)
			{
				item = items[i];
				if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
				{
					continue;
				}
				if(i != 0 && i % horizontalTileCount == 0)
				{
					if((x < (pageStartX + width)) &&
						(y < (positionY + tileHeight + (this._verticalGap / 2))))
					{
						//we're at the end of the previous row (but we also make
						//sure that we're not on the next page)
						return i;
					}
					positionX = pageStartX;
					positionY += tileHeight + this._verticalGap;
					rowIndex++;
				}
				if(i == nextPageStartIndex)
				{
					pageIndex++;
					nextPageStartIndex += perPage;

					//we can use availableWidth and availableHeight here without
					//checking if they're NaN because we will never reach a
					//new page without them already being calculated.
					if(this._paging === Direction.HORIZONTAL)
					{
						positionX = pageStartX = startX + width * pageIndex;
						positionY = startY;
					}
					else if(this._paging === Direction.VERTICAL)
					{
						positionY = startY + height * pageIndex;
					}
				}
				if((x < (positionX + (tileWidth / 2))) &&
					((y < (positionY + tileHeight + (this._verticalGap / 2))) || (rowIndex == lastRowIndex)))
				{
					return i;
				}
				positionX += tileWidth + this._horizontalGap;
			}
			return i;
		}

		/**
		 * @inheritDoc
		 */
		public function positionDropIndicator(dropIndicator:DisplayObject, index:int,
			x:Number, y:Number, items:Vector.<DisplayObject>, width:Number, height:Number):void
		{
			if(this._useVirtualLayout)
			{
				this.prepareTypicalItem();
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var itemCount:int = items.length;
			var tileWidth:Number = this._useVirtualLayout ? calculatedTypicalItemWidth : 0;
			var tileHeight:Number = this._useVirtualLayout ? calculatedTypicalItemHeight : 0;
			//a virtual layout assumes that all items are the same size as
			//the typical item, so we don't need to measure every item in
			//that case
			if(!this._useVirtualLayout)
			{
				for(var i:int = 0; i < itemCount; i++)
				{
					var item:DisplayObject = items[i];
					if(!item)
					{
						continue;
					}
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					var itemWidth:Number = item.width;
					var itemHeight:Number = item.height;
					if(itemWidth > tileWidth)
					{
						tileWidth = itemWidth;
					}
					if(itemHeight > tileHeight)
					{
						tileHeight = itemHeight;
					}
				}
			}
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}
			var horizontalTileCount:int = (width - this._paddingLeft - this._paddingRight + this._horizontalGap) / (tileWidth + this._horizontalGap);
			if(horizontalTileCount < 1)
			{
				horizontalTileCount = 1;
			}
			else if(this._requestedColumnCount > 0 && horizontalTileCount > this._requestedColumnCount)
			{
				horizontalTileCount = this._requestedColumnCount;
			}
			var verticalTileCount:int = (height - this._paddingTop - this._paddingBottom + this._verticalGap) / (tileHeight + this._verticalGap);
			if(verticalTileCount < 1)
			{
				verticalTileCount = 1;
			}
			else if(this._requestedRowCount > 0 && verticalTileCount > this._requestedRowCount)
			{
				verticalTileCount = this._requestedRowCount;
			}
			var perPage:Number = horizontalTileCount * verticalTileCount;
			var startX:Number = this._paddingLeft;
			var actualHorizontalTileCount:int = horizontalTileCount;
			if(actualHorizontalTileCount > itemCount)
			{
				actualHorizontalTileCount = itemCount;
			}
			if(this._horizontalAlign == HorizontalAlign.RIGHT)
			{
				startX = this._paddingLeft + (width - this._paddingLeft - this._paddingRight) -
					((actualHorizontalTileCount * (tileWidth + this._horizontalGap)) - this._horizontalGap);
			}
			else if(this._horizontalAlign == HorizontalAlign.CENTER)
			{
				startX = this._paddingLeft + ((width - this._paddingLeft - this._paddingRight) -
					((actualHorizontalTileCount * (tileWidth + this._horizontalGap)) - this._horizontalGap)) / 2;
			}
			var startY:Number = this._paddingTop;
			if(this._paging != Direction.NONE || itemCount <= perPage)
			{
				var actualVerticalTileCount:int = verticalTileCount;
				if(itemCount <= perPage)
				{
					actualVerticalTileCount = Math.ceil(itemCount / actualHorizontalTileCount);
				}
				if(this._verticalAlign == VerticalAlign.BOTTOM)
				{
					startY = this._paddingTop + (height - this._paddingTop - this._paddingBottom) -
						((actualVerticalTileCount * (tileHeight + this._verticalGap)) - this._verticalGap);
				}
				else if(this._verticalAlign == VerticalAlign.MIDDLE)
				{
					startY = this._paddingTop + ((height - this._paddingTop - this._paddingBottom) -
						((actualVerticalTileCount * (tileHeight + this._verticalGap)) - this._verticalGap)) / 2;
				}
			}
			var pageIndex:int = 0;
			var rowIndex:int = 0;
			var lastRowIndex:int = int((itemCount - 1) / horizontalTileCount);
			var nextPageStartIndex:int = perPage;
			var pageStartX:Number = startX;
			var positionX:Number = startX;
			var positionY:Number = startY;
			var rowItemCount:int = 0;
			for(i = 0; i < itemCount; i++)
			{
				item = items[i];
				if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
				{
					continue;
				}
				if(i != 0 && i % horizontalTileCount == 0)
				{
					//start of a new row
					positionX = pageStartX;
					positionY += tileHeight + this._verticalGap;
					rowItemCount = 0;
					rowIndex++;
				}
				if(i == nextPageStartIndex)
				{
					//start of a new page
					pageIndex++;
					nextPageStartIndex += perPage;
					if(this._paging === Direction.HORIZONTAL)
					{
						positionX = pageStartX = startX + width * pageIndex;
						positionY = startY;
					}
					else if(this._paging === Direction.VERTICAL)
					{
						positionY = startY + height * pageIndex;
					}
				}
				if((x < (positionX + (tileWidth / 2))) &&
					((y < (positionY + tileHeight + (this._verticalGap / 2))) || (rowIndex == lastRowIndex)))
				{
					dropIndicator.x = positionX - dropIndicator.width / 2;
					dropIndicator.y = positionY;
					dropIndicator.height = tileHeight;
					return;
				}
				positionX += tileWidth + this._horizontalGap;

				if(rowItemCount > 0 &&
					(x < (positionX + (tileWidth / 2))) &&
					(x < (pageStartX + width)) && //not on next page
					(positionX + tileWidth) > (width - this._paddingRight) &&
					(y < (positionY + tileHeight + (this._verticalGap / 2))))
				{
					//index on next row, but position drop indicator at the end
					//of the current row
					dropIndicator.x = positionX - this._horizontalGap - dropIndicator.width / 2;
					dropIndicator.y = positionY;
					dropIndicator.height = tileHeight;
					return;
				}
				rowItemCount++;
			}
			dropIndicator.x = positionX - dropIndicator.width / 2;
			dropIndicator.y = positionY;
			dropIndicator.height = tileHeight;
		}

		/**
		 * @private
		 */
		protected function applyHorizontalAlign(items:Vector.<DisplayObject>, startIndex:int, endIndex:int, totalItemWidth:Number, availableWidth:Number):void
		{
			if(totalItemWidth >= availableWidth)
			{
				return;
			}
			var horizontalAlignOffsetX:Number = 0;
			if(this._horizontalAlign === HorizontalAlign.RIGHT)
			{
				horizontalAlignOffsetX = availableWidth - totalItemWidth;
			}
			else if(this._horizontalAlign !== HorizontalAlign.LEFT)
			{
				//we're going to default to center if we encounter an
				//unknown value
				horizontalAlignOffsetX = Math.round((availableWidth - totalItemWidth) / 2);
			}
			if(horizontalAlignOffsetX != 0)
			{
				for(var i:int = startIndex; i <= endIndex; i++)
				{
					var item:DisplayObject = items[i];
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					item.x += horizontalAlignOffsetX;
				}
			}
		}

		/**
		 * @private
		 */
		protected function applyVerticalAlign(items:Vector.<DisplayObject>, startIndex:int, endIndex:int, totalItemHeight:Number, availableHeight:Number):void
		{
			if(totalItemHeight >= availableHeight)
			{
				return;
			}
			var verticalAlignOffsetY:Number = 0;
			if(this._verticalAlign === VerticalAlign.BOTTOM)
			{
				verticalAlignOffsetY = availableHeight - totalItemHeight;
			}
			else if(this._verticalAlign === VerticalAlign.MIDDLE)
			{
				verticalAlignOffsetY = Math.round((availableHeight - totalItemHeight) / 2);
			}
			if(verticalAlignOffsetY != 0)
			{
				for(var i:int = startIndex; i <= endIndex; i++)
				{
					var item:DisplayObject = items[i];
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					item.y += verticalAlignOffsetY;
				}
			}
		}

		/**
		 * @private
		 */
		protected function getVisibleIndicesAtScrollPositionWithHorizontalPaging(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int>):void
		{
			this.prepareTypicalItem();
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var tileWidth:Number = calculatedTypicalItemWidth;
			var tileHeight:Number = calculatedTypicalItemHeight;
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}
			var horizontalTileCount:int = this.calculateHorizontalTileCount(tileWidth,
				width, width, this._paddingLeft + this._paddingRight,
				this._horizontalGap, this._requestedColumnCount, itemCount);
			if(this._distributeWidths)
			{
				tileWidth = (width - this._paddingLeft - this._paddingRight - (horizontalTileCount * this._horizontalGap) + this._horizontalGap) / horizontalTileCount;
				if(this._useSquareTiles)
				{
					tileHeight = tileWidth;
				}
			}
			var verticalTileCount:int = this.calculateVerticalTileCount(tileHeight,
				height, height, this._paddingTop + this._paddingBottom,
				this._verticalGap, this._requestedRowCount, itemCount,
				horizontalTileCount, this._distributeHeights && !this._useSquareTiles);
			if(this._distributeHeights && !this._useSquareTiles)
			{
				tileHeight = (height - this._paddingTop - this._paddingBottom - (verticalTileCount * this._verticalGap) + this._verticalGap) / verticalTileCount;
			}
			var perPage:int = horizontalTileCount * verticalTileCount;
			var minimumItemCount:int = perPage + 2 * verticalTileCount;
			if(minimumItemCount > itemCount)
			{
				minimumItemCount = itemCount;
			}

			var startPageIndex:int = Math.round(scrollX / width);
			var minimum:int = startPageIndex * perPage;
			var totalRowWidth:Number = horizontalTileCount * (tileWidth + this._horizontalGap) - this._horizontalGap;
			var leftSideOffset:Number = 0;
			var rightSideOffset:Number = 0;
			if(totalRowWidth < width)
			{
				if(this._horizontalAlign === HorizontalAlign.RIGHT)
				{
					leftSideOffset = width - this._paddingLeft - this._paddingRight - totalRowWidth;
					rightSideOffset = 0;
				}
				else if(this._horizontalAlign === HorizontalAlign.CENTER)
				{
					leftSideOffset = rightSideOffset = Math.round((width - this._paddingLeft - this._paddingRight - totalRowWidth) / 2);
				}
				else //left
				{
					leftSideOffset = 0;
					rightSideOffset = width - this._paddingLeft - this._paddingRight - totalRowWidth;
				}
			}
			var columnOffset:int = 0;
			var pageStartPosition:Number = startPageIndex * width;
			var partialPageSize:Number = scrollX - pageStartPosition;
			if(partialPageSize < 0)
			{
				partialPageSize = -partialPageSize - this._paddingRight - rightSideOffset;
				if(partialPageSize < 0)
				{
					partialPageSize = 0;
				}
				columnOffset = -Math.floor(partialPageSize / (tileWidth + this._horizontalGap)) - 1;
				minimum += -perPage + horizontalTileCount + columnOffset;
			}
			else if(partialPageSize > 0)
			{
				partialPageSize = partialPageSize - this._paddingLeft - leftSideOffset;
				if(partialPageSize < 0)
				{
					partialPageSize = 0;
				}
				columnOffset = Math.floor(partialPageSize / (tileWidth + this._horizontalGap));
				minimum += columnOffset;
			}
			if(minimum < 0)
			{
				minimum = 0;
				columnOffset = 0;
			}
			if(minimum + minimumItemCount >= itemCount)
			{
				var resultPushIndex:int = result.length;
				//an optimized path when we're on or near the last page
				minimum = itemCount - minimumItemCount;
				for(var i:int = minimum; i < itemCount; i++)
				{
					result[resultPushIndex] = i;
					resultPushIndex++;
				}
			}
			else
			{
				var rowIndex:int = 0;
				var columnIndex:int = (horizontalTileCount + columnOffset) % horizontalTileCount;
				var pageStart:int = int(minimum / perPage) * perPage;
				i = minimum;
				var resultLength:int = 0;
				do
				{
					if(i < itemCount)
					{
						result[resultLength] = i;
						resultLength++;
					}
					rowIndex++;
					if(rowIndex == verticalTileCount)
					{
						rowIndex = 0;
						columnIndex++;
						if(columnIndex == horizontalTileCount)
						{
							columnIndex = 0;
							pageStart += perPage;
						}
						i = pageStart + columnIndex - horizontalTileCount;
					}
					i += horizontalTileCount;
				}
				while(resultLength < minimumItemCount && pageStart < itemCount);
			}
		}

		/**
		 * @private
		 */
		protected function getVisibleIndicesAtScrollPositionWithVerticalPaging(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int>):void
		{
			this.prepareTypicalItem();
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var tileWidth:Number = calculatedTypicalItemWidth;
			var tileHeight:Number = calculatedTypicalItemHeight;
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}
			var horizontalTileCount:int = this.calculateHorizontalTileCount(tileWidth,
				width, width, this._paddingLeft + this._paddingRight,
				this._horizontalGap, this._requestedColumnCount, itemCount);
			if(this._distributeWidths)
			{
				tileWidth = (width - this._paddingLeft - this._paddingRight - (horizontalTileCount * this._horizontalGap) + this._horizontalGap) / horizontalTileCount;
				if(this._useSquareTiles)
				{
					tileHeight = tileWidth;
				}
			}
			var verticalTileCount:int = this.calculateVerticalTileCount(tileHeight,
				height, height, this._paddingTop + this._paddingBottom,
				this._verticalGap, this._requestedRowCount, itemCount,
				horizontalTileCount, this._distributeHeights && !this._useSquareTiles);
			if(this._distributeHeights && !this._useSquareTiles)
			{
				tileHeight = (height - this._paddingTop - this._paddingBottom - (verticalTileCount * this._verticalGap) + this._verticalGap) / verticalTileCount;
			}
			var perPage:int = horizontalTileCount * verticalTileCount;
			var minimumItemCount:int = perPage + 2 * horizontalTileCount;
			if(minimumItemCount > itemCount)
			{
				minimumItemCount = itemCount;
			}

			var startPageIndex:int = Math.round(scrollY / height);
			var minimum:int = startPageIndex * perPage;
			var totalColumnHeight:Number = verticalTileCount * (tileHeight + this._verticalGap) - this._verticalGap;
			var topSideOffset:Number = 0;
			var bottomSideOffset:Number = 0;
			if(totalColumnHeight < height)
			{
				if(this._verticalAlign === VerticalAlign.BOTTOM)
				{
					topSideOffset = height - this._paddingTop - this._paddingBottom - totalColumnHeight;
					bottomSideOffset = 0;
				}
				else if(this._verticalAlign === VerticalAlign.MIDDLE)
				{
					topSideOffset = bottomSideOffset = Math.round((height - this._paddingTop - this._paddingBottom - totalColumnHeight) / 2);
				}
				else //top
				{
					topSideOffset = 0;
					bottomSideOffset = height - this._paddingTop - this._paddingBottom - totalColumnHeight;
				}
			}
			var rowOffset:int = 0;
			var pageStartPosition:Number = startPageIndex * height;
			var partialPageSize:Number = scrollY - pageStartPosition;
			if(partialPageSize < 0)
			{
				partialPageSize = -partialPageSize - this._paddingBottom - bottomSideOffset;
				if(partialPageSize < 0)
				{
					partialPageSize = 0;
				}
				rowOffset = -Math.floor(partialPageSize / (tileHeight + this._verticalGap)) - 1;
				minimum += horizontalTileCount * rowOffset;
			}
			else if(partialPageSize > 0)
			{
				partialPageSize = partialPageSize - this._paddingTop - topSideOffset;
				if(partialPageSize < 0)
				{
					partialPageSize = 0;
				}
				rowOffset = Math.floor(partialPageSize / (tileHeight + this._verticalGap));
				minimum += horizontalTileCount * rowOffset;
			}
			if(minimum < 0)
			{
				minimum = 0;
				rowOffset = 0;
			}

			var maximum:int = minimum + minimumItemCount;
			if(maximum > itemCount)
			{
				maximum = itemCount;
			}
			minimum = maximum - minimumItemCount;
			var resultPushIndex:int = result.length;
			for(var i:int = minimum; i < maximum; i++)
			{
				result[resultPushIndex] = i;
				resultPushIndex++;
			}
		}

		/**
		 * @private
		 */
		protected function getVisibleIndicesAtScrollPositionWithoutPaging(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int>):void
		{
			this.prepareTypicalItem();
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var tileWidth:Number = calculatedTypicalItemWidth;
			var tileHeight:Number = calculatedTypicalItemHeight;
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}
			var horizontalTileCount:int = this.calculateHorizontalTileCount(tileWidth,
				width, width, this._paddingLeft + this._paddingRight,
				this._horizontalGap, this._requestedColumnCount, itemCount);
			if(this._distributeWidths)
			{
				tileWidth = (width - this._paddingLeft - this._paddingRight - (horizontalTileCount * this._horizontalGap) + this._horizontalGap) / horizontalTileCount;
				if(this._useSquareTiles)
				{
					tileHeight = tileWidth;
				}
			}
			if(this._distributeHeights && !this._useSquareTiles)
			{
				var verticalTileCount:int = this.calculateVerticalTileCount(tileHeight,
					height, height, this._paddingTop + this._paddingBottom,
					this._verticalGap, this._requestedRowCount, itemCount,
					horizontalTileCount, this._distributeHeights && !this._useSquareTiles);
				tileHeight = (height - this._paddingTop - this._paddingBottom - (verticalTileCount * this._verticalGap) + this._verticalGap) / verticalTileCount;
			}
			verticalTileCount = Math.ceil((height + this._verticalGap) / (tileHeight + this._verticalGap)) + 1;
			var minimumItemCount:int = verticalTileCount * horizontalTileCount;
			if(minimumItemCount > itemCount)
			{
				minimumItemCount = itemCount;
			}
			var rowIndexOffset:int = 0;
			var totalRowHeight:Number = Math.ceil(itemCount / horizontalTileCount) * (tileHeight + this._verticalGap) - this._verticalGap;
			if(totalRowHeight < height)
			{
				if(this._verticalAlign === VerticalAlign.BOTTOM)
				{
					rowIndexOffset = Math.ceil((height - totalRowHeight) / (tileHeight + this._verticalGap));
				}
				else if(this._verticalAlign === VerticalAlign.MIDDLE)
				{
					rowIndexOffset = Math.ceil((height - totalRowHeight) / (tileHeight + this._verticalGap) / 2);
				}
			}
			var rowIndex:int = -rowIndexOffset + Math.floor((scrollY - this._paddingTop + this._verticalGap) / (tileHeight + this._verticalGap));
			var minimum:int = rowIndex * horizontalTileCount;
			if(minimum < 0)
			{
				minimum = 0;
			}
			var maximum:int = minimum + minimumItemCount;
			if(maximum > itemCount)
			{
				maximum = itemCount;
			}
			minimum = maximum - minimumItemCount;
			var resultPushIndex:int = result.length;
			for(var i:int = minimum; i < maximum; i++)
			{
				result[resultPushIndex] = i;
				resultPushIndex++;
			}
		}

		/**
		 * @private
		 */
		protected function validateItems(items:Vector.<DisplayObject>):void
		{
			var itemCount:int = items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
				{
					continue;
				}
				if(item is IValidating)
				{
					IValidating(item).validate();
				}
			}
		}

		/**
		 * @private
		 */
		protected function prepareTypicalItem():void
		{
			if(!this._typicalItem)
			{
				return;
			}
			if(this._resetTypicalItemDimensionsOnMeasure)
			{
				this._typicalItem.width = this._typicalItemWidth;
				this._typicalItem.height = this._typicalItemHeight;
			}
			if(this._typicalItem is IValidating)
			{
				IValidating(this._typicalItem).validate();
			}
		}

		/**
		 * @inheritDoc
		 */
		public function calculateScrollPositionForIndex(index:int, items:Vector.<DisplayObject>,
			x:Number, y:Number, width:Number, height:Number, result:Point = null,
			nearest:Boolean = false, scrollX:Number = 0, scrollY:Number = 0):Point
		{
			if(!result)
			{
				result = new Point();
			}

			if(this._useVirtualLayout)
			{
				this.prepareTypicalItem();
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var itemCount:int = items.length;
			var tileWidth:Number = this._useVirtualLayout ? calculatedTypicalItemWidth : 0;
			var tileHeight:Number = this._useVirtualLayout ? calculatedTypicalItemHeight : 0;
			//a virtual layout assumes that all items are the same size as
			//the typical item, so we don't need to measure every item in
			//that case
			if(!this._useVirtualLayout)
			{
				for(var i:int = 0; i < itemCount; i++)
				{
					var item:DisplayObject = items[i];
					if(!item)
					{
						continue;
					}
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					var itemWidth:Number = item.width;
					var itemHeight:Number = item.height;
					if(itemWidth > tileWidth)
					{
						tileWidth = itemWidth;
					}
					if(itemHeight > tileHeight)
					{
						tileHeight = itemHeight;
					}
				}
			}
			if(tileWidth < 0)
			{
				tileWidth = 0;
			}
			if(tileHeight < 0)
			{
				tileHeight = 0;
			}
			if(this._useSquareTiles)
			{
				if(tileWidth > tileHeight)
				{
					tileHeight = tileWidth;
				}
				else if(tileHeight > tileWidth)
				{
					tileWidth = tileHeight;
				}
			}
			var horizontalTileCount:int = (width - this._paddingLeft - this._paddingRight + this._horizontalGap) / (tileWidth + this._horizontalGap);
			if(horizontalTileCount < 1)
			{
				horizontalTileCount = 1;
			}
			else if(this._requestedColumnCount > 0 && horizontalTileCount > this._requestedColumnCount)
			{
				horizontalTileCount = this._requestedColumnCount;
			}
			if(this._paging !== Direction.NONE)
			{
				var verticalTileCount:int = (height - this._paddingTop - this._paddingBottom + this._verticalGap) / (tileHeight + this._verticalGap);
				if(verticalTileCount < 1)
				{
					verticalTileCount = 1;
				}
				var perPage:Number = horizontalTileCount * verticalTileCount;
				var pageIndex:int = index / perPage;
				if(this._paging === Direction.HORIZONTAL)
				{
					result.x = pageIndex * width;
					result.y = 0;
				}
				else
				{
					result.x = 0;
					result.y = pageIndex * height;
				}
			}
			else
			{
				var resultY:Number = this._paddingTop + ((tileHeight + this._verticalGap) * int(index / horizontalTileCount));
				if(nearest)
				{
					var bottomPosition:Number = resultY - (height - tileHeight);
					if(scrollY >= bottomPosition && scrollY <= resultY)
					{
						//keep the current scroll position because the item is already
						//fully visible
						resultY = scrollY;
					}
					else
					{
						var topDifference:Number = Math.abs(resultY - scrollY);
						var bottomDifference:Number = Math.abs(bottomPosition - scrollY);
						if(bottomDifference < topDifference)
						{
							resultY = bottomPosition;
						}
					}
				}
				else
				{
					resultY -= Math.round((height - tileHeight) / 2);
				}
				result.x = 0;
				result.y = resultY;
			}
			return result;
		}

		/**
		 * @private
		 */
		protected function calculateHorizontalTileCount(tileWidth:Number,
			explicitWidth:Number, maxWidth:Number, paddingLeftAndRight:Number,
			horizontalGap:Number, requestedColumnCount:int, totalItemCount:int):int
		{
			if(requestedColumnCount > 0 && this._distributeWidths)
			{
				return requestedColumnCount;
			}
			var tileCount:int;
			if(explicitWidth === explicitWidth) //!isNaN
			{
				//in this case, the exact width is known
				tileCount = (explicitWidth - paddingLeftAndRight + horizontalGap) / (tileWidth + horizontalGap);
				if(requestedColumnCount > 0 && tileCount > requestedColumnCount)
				{
					return requestedColumnCount;
				}
				if(tileCount > totalItemCount)
				{
					tileCount = totalItemCount;
				}
				if(tileCount < 1)
				{
					//we must have at least one tile per row
					tileCount = 1;
				}
				return tileCount;
			}

			//in this case, the width is not known, but it may have a maximum
			if(requestedColumnCount > 0)
			{
				tileCount = requestedColumnCount;
			}
			else
			{
				tileCount = totalItemCount;
			}

			var maxTileCount:int = int.MAX_VALUE;
			if(maxWidth === maxWidth && //!isNaN
				maxWidth < Number.POSITIVE_INFINITY)
			{
				maxTileCount = (maxWidth - paddingLeftAndRight + horizontalGap) / (tileWidth + horizontalGap);
				if(maxTileCount < 1)
				{
					//we must have at least one tile per row
					maxTileCount = 1;
				}
			}
			if(tileCount > maxTileCount)
			{
				tileCount = maxTileCount;
			}
			if(tileCount < 1)
			{
				//we must have at least one tile per row
				tileCount = 1;
			}
			return tileCount;
		}

		/**
		 * @private
		 */
		protected function calculateVerticalTileCount(tileHeight:Number,
			explicitHeight:Number, maxHeight:Number, paddingTopAndBottom:Number,
			verticalGap:Number, requestedRowCount:int, totalItemCount:int,
			horizontalTileCount:int, distributeHeights:Boolean):int
		{
			//using the horizontal tile count, calculate how many rows would be
			//required for the total number of items if there were no restrictions.
			var defaultVerticalTileCount:int = Math.ceil(totalItemCount / horizontalTileCount);
			if(distributeHeights)
			{
				if(requestedRowCount > 0 && defaultVerticalTileCount > requestedRowCount)
				{
					return requestedRowCount;
				}
				return defaultVerticalTileCount;
			}

			var verticalTileCount:int;
			if(explicitHeight === explicitHeight) //!isNaN
			{
				//in this case, the exact height is known
				verticalTileCount = (explicitHeight - paddingTopAndBottom + verticalGap) / (tileHeight + verticalGap);
				if(requestedRowCount > 0 && verticalTileCount > requestedRowCount)
				{
					return requestedRowCount;
				}
				if(verticalTileCount > defaultVerticalTileCount)
				{
					verticalTileCount = defaultVerticalTileCount;
				}
				if(verticalTileCount < 1)
				{
					//we must have at least one tile per row
					verticalTileCount = 1;
				}
				return verticalTileCount;
			}

			//in this case, the height is not known, but it may have a maximum
			if(requestedRowCount > 0)
			{
				verticalTileCount = requestedRowCount;
			}
			else
			{
				verticalTileCount = defaultVerticalTileCount;
			}

			var maxVerticalTileCount:int = int.MAX_VALUE;
			if(maxHeight === maxHeight && //!isNaN
				maxHeight < Number.POSITIVE_INFINITY)
			{
				maxVerticalTileCount = (maxHeight - paddingTopAndBottom + verticalGap) / (tileHeight + verticalGap);
				if(maxVerticalTileCount < 1)
				{
					//we must have at least one tile per row
					maxVerticalTileCount = 1;
				}
			}
			if(verticalTileCount > maxVerticalTileCount)
			{
				verticalTileCount = maxVerticalTileCount;
			}
			if(verticalTileCount < 1)
			{
				//we must have at least one tile per row
				verticalTileCount = 1;
			}
			return verticalTileCount;
		}
	}
}


================================================
FILE: source/feathers/layout/VerticalAlign.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	/**
	 * Constants for vertical alignment of items in a layout.
	 *
	 * <p>Note: Some constants may not be valid for certain properties. Please
	 * see the description of the property in the API reference for full
	 * details.</p>
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class VerticalAlign
	{
		/**
		 * The items in the layout will be vertically aligned to the top of the
		 * bounds.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const TOP:String = "top";

		/**
		 * The items in the layout will be vertically aligned to the middle of
		 * the bounds.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const MIDDLE:String = "middle";

		/**
		 * The items in the layout will be vertically aligned to the bottom of
		 * the bounds.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const BOTTOM:String = "bottom";

		/**
		 * The items in the layout will fill the height of the bounds.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const JUSTIFY:String = "justify";
	}
}


================================================
FILE: source/feathers/layout/VerticalLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IValidating;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;
	import flash.ui.Keyboard;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.events.Event;
	import starling.utils.Pool;

	/**
	 * Positions items from top to bottom in a single column.
	 *
	 * @see ../../../help/vertical-layout.html How to use VerticalLayout with Feathers containers
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class VerticalLayout extends BaseLinearLayout implements IVariableVirtualLayout, ITrimmedVirtualLayout, IGroupedLayout, IDragDropLayout
	{
		/**
		 * Constructor.
		 */
		public function VerticalLayout()
		{
			super();
		}

		[Inspectable(type="String",enumeration="left,center,right,justify")]
		/**
		 * The alignment of the items horizontally, on the x-axis.
		 *
		 * <p>If the <code>horizontalAlign</code> property is set to
		 * <code>feathers.layout.HorizontalAlign.JUSTIFY</code>, the
		 * <code>width</code>, <code>minWidth</code>, and <code>maxWidth</code>
		 * properties of the items may be changed, and their original values
		 * ignored by the layout. In this situation, if the width needs to be
		 * constrained, the <code>width</code>, <code>minWidth</code>, or
		 * <code>maxWidth</code> properties should instead be set on the parent
		 * container using the layout.</p>
		 *
		 * @default feathers.layout.HorizontalAlign.LEFT
		 *
		 * @see feathers.layout.HorizontalAlign#LEFT
		 * @see feathers.layout.HorizontalAlign#CENTER
		 * @see feathers.layout.HorizontalAlign#RIGHT
		 * @see feathers.layout.HorizontalAlign#JUSTIFY
		 */
		override public function get horizontalAlign():String
		{
			//this is an override so that this class can have its own documentation.
			return this._horizontalAlign;
		}

		[Inspectable(type="String",enumeration="top,middle,bottom")]
		/**
		 * If the total item height is less than the bounds, the positions of
		 * the items can be aligned vertically, on the y-axis.
		 *
		 * <p><strong>Note:</strong> The <code>VerticalAlign.JUSTIFY</code>
		 * constant is not supported.</p>
		 *
		 * @default feathers.layout.VerticalAlign.TOP
		 *
		 * @see feathers.layout.VerticalAlign#TOP
		 * @see feathers.layout.VerticalAlign#MIDDLE
		 * @see feathers.layout.VerticalAlign#BOTTOM
		 */
		override public function get verticalAlign():String
		{
			//this is an override so that this class can have its own documentation.
			return this._verticalAlign;
		}

		/**
		 * @private
		 */
		protected var _stickyHeader:Boolean = false;

		/**
		 * If a non-null value for the <code>headerIndices</code> property is
		 * provided (by a component like <code>GroupedList</code>), and the
		 * <code>stickyHeader</code> property is set to <code>true</code>, a
		 * header will stick to the top of the view port until the current group
		 * completely scrolls out of the view port.
		 *
		 * @default false
		 */
		public function get stickyHeader():Boolean
		{
			return this._stickyHeader;
		}

		/**
		 * @private
		 */
		public function set stickyHeader(value:Boolean):void
		{
			if(this._stickyHeader == value)
			{
				return;
			}
			this._stickyHeader = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _headerIndices:Vector.<int>;

		/**
		 * @inheritDoc
		 */
		public function get headerIndices():Vector.<int>
		{
			return this._headerIndices;
		}

		/**
		 * @private
		 */
		public function set headerIndices(value:Vector.<int>):void
		{
			if(this._headerIndices == value)
			{
				return;
			}
			this._headerIndices = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _distributeHeights:Boolean = false;

		/**
		 * Distributes the height of the view port equally to each item. If the
		 * view port height needs to be measured, the largest item's height will
		 * be used for all items, subject to any specified minimum and maximum
		 * height values.
		 *
		 * @default false
		 */
		public function get distributeHeights():Boolean
		{
			return this._distributeHeights;
		}

		/**
		 * @private
		 */
		public function set distributeHeights(value:Boolean):void
		{
			if(this._distributeHeights == value)
			{
				return;
			}
			this._distributeHeights = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _requestedRowCount:int = 0;

		/**
		 * Requests that the layout set the view port dimensions to display a
		 * specific number of rows (plus gaps and padding), if possible. If the
		 * explicit height of the view port is set, then this value will be
		 * ignored. If the view port's minimum and/or maximum height are set,
		 * the actual number of visible rows may be adjusted to meet those
		 * requirements. Set this value to <code>0</code> to display as many
		 * rows as possible.
		 *
		 * @default 0
		 *
		 * @see #maxRowCount
		 */
		public function get requestedRowCount():int
		{
			return this._requestedRowCount;
		}

		/**
		 * @private
		 */
		public function set requestedRowCount(value:int):void
		{
			if(value < 0)
			{
				throw RangeError("requestedRowCount requires a value >= 0");
			}
			if(this._requestedRowCount == value)
			{
				return;
			}
			this._requestedRowCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _maxRowCount:int = 0;

		/**
		 * The maximum number of rows to display. If the explicit height of the
		 * view port is set or if <code>requestedRowCount</code> is set, then
		 * this value will be ignored. If the view port's minimum and/or maximum
		 * height are set, the actual number of visible rows may be adjusted to
		 * meet those requirements. Set this value to <code>0</code> to display
		 * as many rows as possible.
		 *
		 * @default 0
		 */
		public function get maxRowCount():int
		{
			return this._maxRowCount;
		}

		/**
		 * @private
		 */
		public function set maxRowCount(value:int):void
		{
			if(value < 0)
			{
				throw RangeError("maxRowCount requires a value >= 0");
			}
			if(this._maxRowCount == value)
			{
				return;
			}
			this._maxRowCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _scrollPositionVerticalAlign:String = VerticalAlign.MIDDLE;

		[Inspectable(type="String",enumeration="top,middle,bottom")]
		/**
		 * When the scroll position is calculated for an item, an attempt will
		 * be made to align the item to this position.
		 *
		 * @default feathers.layout.VerticalAlign.MIDDLE
		 *
		 * @see feathers.layout.VerticalAlign#TOP
		 * @see feathers.layout.VerticalAlign#MIDDLE
		 * @see feathers.layout.VerticalAlign#BOTTOM
		 */
		public function get scrollPositionVerticalAlign():String
		{
			return this._scrollPositionVerticalAlign;
		}

		/**
		 * @private
		 */
		public function set scrollPositionVerticalAlign(value:String):void
		{
			this._scrollPositionVerticalAlign = value;
		}

		/**
		 * @private
		 */
		protected var _headerScrollPositionVerticalAlign:String = VerticalAlign.TOP;

		[Inspectable(type="String",enumeration="top,middle,bottom")]
		/**
		 * When the scroll position is calculated for a header (specified by a
		 * <code>GroupedList</code> or another component with the
		 * <code>headerIndicies</code> property, an attempt will be made to
		 * align the header to this position.
		 *
		 * @default feathers.layout.VerticalAlign.TOP
		 *
		 * @see feathers.layout.VerticalAlign#TOP
		 * @see feathers.layout.VerticalAlign#MIDDLE
		 * @see feathers.layout.VerticalAlign#BOTTOM
		 * @see #headerIndices
		 * @see #scrollPositionVerticalAlign
		 */
		public function get headerScrollPositionVerticalAlign():String
		{
			return this._headerScrollPositionVerticalAlign;
		}

		/**
		 * @private
		 */
		public function set headerScrollPositionVerticalAlign(value:String):void
		{
			this._headerScrollPositionVerticalAlign = value;
		}

		/**
		 * @inheritDoc
		 */
		override public function get requiresLayoutOnScroll():Boolean
		{
			return this._useVirtualLayout ||
				(this._headerIndices && this._stickyHeader); //the header needs to stick!
		}

		/**
		 * @inheritDoc
		 */
		public function layout(items:Vector.<DisplayObject>, viewPortBounds:ViewPortBounds = null, result:LayoutBoundsResult = null):LayoutBoundsResult
		{
			//this function is very long because it may be called every frame,
			//in some situations. testing revealed that splitting this function
			//into separate, smaller functions affected performance.
			//since the SWC compiler cannot inline functions, we can't use that
			//feature either.

			//since viewPortBounds can be null, we may need to provide some defaults
			var scrollX:Number = viewPortBounds ? viewPortBounds.scrollX : 0;
			var scrollY:Number = viewPortBounds ? viewPortBounds.scrollY : 0;
			var boundsX:Number = viewPortBounds ? viewPortBounds.x : 0;
			var boundsY:Number = viewPortBounds ? viewPortBounds.y : 0;
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;
			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;

			if(this._useVirtualLayout)
			{
				//if the layout is virtualized, we'll need the dimensions of the
				//typical item so that we have fallback values when an item is null
				this.prepareTypicalItem(explicitWidth - this._paddingLeft - this._paddingRight);
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var needsExplicitWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			var needsExplicitHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			var distributedHeight:Number;
			if(!needsExplicitHeight && this._distributeHeights)
			{
				//we need to calculate this before validateItems() because it
				//needs to be passed in there.
				distributedHeight = this.calculateDistributedHeight(items, explicitHeight, minHeight, maxHeight, false);
				if(this._useVirtualLayout)
				{
					calculatedTypicalItemHeight = distributedHeight;
				}
			}

			if(!this._useVirtualLayout || this._hasVariableItemDimensions || this._distributeHeights ||
				this._horizontalAlign != HorizontalAlign.JUSTIFY ||
				needsExplicitWidth) //isNaN
			{
				//in some cases, we may need to validate all of the items so
				//that we can use their dimensions below.
				this.validateItems(items, explicitWidth - this._paddingLeft - this._paddingRight,
					minWidth - this._paddingLeft - this._paddingRight,
					maxWidth - this._paddingLeft - this._paddingRight,
					explicitHeight - this._paddingTop - this._paddingBottom,
					minHeight - this._paddingTop - this._paddingBottom,
					maxHeight - this._paddingTop - this._paddingBottom, distributedHeight);
			}

			if(needsExplicitHeight && this._distributeHeights)
			{
				//if we didn't calculate this before, we need to do it now.
				distributedHeight = this.calculateDistributedHeight(items, explicitHeight, minHeight, maxHeight, true);
			}
			var hasDistributedHeight:Boolean = distributedHeight === distributedHeight; //!isNaN

			if(!this._useVirtualLayout)
			{
				//handle the percentHeight property from VerticalLayoutData,
				//if available.
				this.applyPercentHeights(items, explicitHeight, minHeight, maxHeight);
			}

			//this section prepares some variables needed for the following loop
			var hasFirstGap:Boolean = this._firstGap === this._firstGap; //!isNaN
			var hasLastGap:Boolean = this._lastGap === this._lastGap; //!isNaN
			var maxItemWidth:Number = this._useVirtualLayout ? calculatedTypicalItemWidth : 0;
			var startPositionY:Number = boundsY + this._paddingTop;
			var positionY:Number = startPositionY;
			var indexOffset:int = 0;
			var itemCount:int = items.length;
			var totalItemCount:int = itemCount;
			var requestedRowAvailableHeight:Number = 0;
			var maxRowAvailableHeight:Number = Number.POSITIVE_INFINITY;
			if(this._useVirtualLayout && !this._hasVariableItemDimensions)
			{
				//if the layout is virtualized, and the items all have the same
				//height, we can make our loops smaller by skipping some items
				//at the beginning and end. this improves performance.
				totalItemCount += this._beforeVirtualizedItemCount + this._afterVirtualizedItemCount;
				indexOffset = this._beforeVirtualizedItemCount;
				positionY += (this._beforeVirtualizedItemCount * (calculatedTypicalItemHeight + this._gap));
				if(hasFirstGap && this._beforeVirtualizedItemCount > 0)
				{
					positionY = positionY - this._gap + this._firstGap;
				}
			}
			var secondToLastIndex:int = totalItemCount - 2;
			//this cache is used to save non-null items in virtual layouts. by
			//using a smaller array, we can improve performance by spending less
			//time in the upcoming loops.
			this._discoveredItemsCache.length = 0;
			var discoveredItemsCacheLastIndex:int = 0;

			//if there are no items in layout, then we don't want to subtract
			//any gap when calculating the total height, so default to 0.
			var gap:Number = 0;

			var headerIndicesIndex:int = -1;
			var nextHeaderIndex:int = -1;
			var headerCount:int = 0;
			var stickyHeaderMaxY:Number = Number.POSITIVE_INFINITY;
			if(this._headerIndices && this._stickyHeader)
			{
				headerCount = this._headerIndices.length;
				if(headerCount > 0)
				{
					headerIndicesIndex = 0;
					nextHeaderIndex = this._headerIndices[headerIndicesIndex];
				}
			}

			//this first loop sets the y position of items, and it calculates
			//the total height of all items
			for(var i:int = 0; i < itemCount; i++)
			{
				if(!this._useVirtualLayout)
				{
					if(this._maxRowCount > 0 && this._maxRowCount == i)
					{
						maxRowAvailableHeight = positionY;
					}
					if(this._requestedRowCount > 0 && this._requestedRowCount == i)
					{
						requestedRowAvailableHeight = positionY;
					}
				}
				var item:DisplayObject = items[i];
				//if we're trimming some items at the beginning, we need to
				//adjust i to account for the missing items in the array
				var iNormalized:int = i + indexOffset;

				if(nextHeaderIndex == iNormalized)
				{
					//if the sticky header is enabled, we need to find its index
					//we look for the first header that is visible at the top of
					//the view port. the previous one should be sticky.
					if(positionY < scrollY)
					{
						headerIndicesIndex++;
						if(headerIndicesIndex < headerCount)
						{
							nextHeaderIndex = this._headerIndices[headerIndicesIndex];
						}
					}
					else
					{
						headerIndicesIndex--;
						if(headerIndicesIndex >= 0)
						{
							//this is the index of the "sticky" header, but we
							//need to save it for later.
							nextHeaderIndex = this._headerIndices[headerIndicesIndex];
							stickyHeaderMaxY = positionY;
						}
					}
				}

				//pick the gap that will follow this item. the first and second
				//to last items may have different gaps.
				gap = this._gap;
				if(hasFirstGap && iNormalized == 0)
				{
					gap = this._firstGap;
				}
				else if(hasLastGap && iNormalized > 0 && iNormalized == secondToLastIndex)
				{
					gap = this._lastGap;
				}

				if(this._useVirtualLayout && this._hasVariableItemDimensions)
				{
					var cachedHeight:Number = this._virtualCache[iNormalized];
				}
				if(this._useVirtualLayout && !item)
				{
					//the item is null, and the layout is virtualized, so we
					//need to estimate the height of the item.

					if(!this._hasVariableItemDimensions ||
						cachedHeight !== cachedHeight) //isNaN
					{
						//if all items must have the same height, we will
						//use the height of the typical item (calculatedTypicalItemHeight).

						//if items may have different heights, we first check
						//the cache for a height value. if there isn't one, then
						//we'll use calculatedTypicalItemHeight as a fallback.
						positionY += calculatedTypicalItemHeight + gap;
					}
					else
					{
						//if we have variable item heights, we should use a
						//cached height when there's one available. it will be
						//more accurate than the typical item's height.
						positionY += cachedHeight + gap;
					}
				}
				else
				{
					//we get here if the item isn't null. it is never null if
					//the layout isn't virtualized.
					var layoutItem:ILayoutDisplayObject = item as ILayoutDisplayObject;
					if(layoutItem !== null && !layoutItem.includeInLayout)
					{
						continue;
					}
					var pivotY:Number = item.pivotY;
					if(pivotY != 0)
					{
						pivotY *= item.scaleY;
					}
					item.y = pivotY + positionY;
					var itemWidth:Number = item.width;
					var itemHeight:Number;
					if(hasDistributedHeight)
					{
						item.height = itemHeight = distributedHeight;
					}
					else
					{
						itemHeight = item.height;
					}
					if(this._useVirtualLayout)
					{
						if(this._hasVariableItemDimensions)
						{
							if(itemHeight != cachedHeight)
							{
								//update the cache if needed. this will notify
								//the container that the virtualized layout has
								//changed, and it the view port may need to be
								//re-measured.
								this._virtualCache[iNormalized] = itemHeight;

								//attempt to adjust the scroll position so that
								//it looks like we're scrolling smoothly after
								//this item resizes.
								if(positionY < scrollY &&
									cachedHeight !== cachedHeight && //isNaN
									itemHeight != calculatedTypicalItemHeight)
								{
									this.dispatchEventWith(Event.SCROLL, false, new Point(0, itemHeight - calculatedTypicalItemHeight));
								}

								this.dispatchEventWith(Event.CHANGE);
							}
						}
						else if(calculatedTypicalItemHeight >= 0)
						{
							//if all items must have the same height, we will
							//use the height of the typical item (calculatedTypicalItemHeight).
							itemHeight = calculatedTypicalItemHeight;
							if(item !== this._typicalItem || item.height != itemHeight)
							{
								//ensure that the typical item's height is not
								//set explicitly so that it can resize
								item.height = itemHeight;
							}
						}
					}
					positionY += itemHeight + gap;
					//we compare with > instead of Math.max() because the rest
					//arguments on Math.max() cause extra garbage collection and
					//hurt performance
					if(itemWidth > maxItemWidth)
					{
						//we need to know the maximum width of the items in the
						//case where the width of the view port needs to be
						//calculated by the layout.
						maxItemWidth = itemWidth;
					}
					if(this._useVirtualLayout)
					{
						this._discoveredItemsCache[discoveredItemsCacheLastIndex] = item;
						discoveredItemsCacheLastIndex++;
					}
				}
			}
			if(this._useVirtualLayout && !this._hasVariableItemDimensions)
			{
				//finish the final calculation of the y position so that it can
				//be used for the total height of all items
				positionY += (this._afterVirtualizedItemCount * (calculatedTypicalItemHeight + this._gap));
				if(hasLastGap && this._afterVirtualizedItemCount > 0)
				{
					positionY = positionY - this._gap + this._lastGap;
				}
			}
			if(nextHeaderIndex >= 0)
			{
				//position the "sticky" header at the top of the view port.
				//it should not cover the following header.
				var header:DisplayObject = items[nextHeaderIndex];
				this.positionStickyHeader(header, scrollY, stickyHeaderMaxY);
			}
			if(!this._useVirtualLayout && this._requestedRowCount > itemCount)
			{
				if(itemCount > 0)
				{
					requestedRowAvailableHeight = this._requestedRowCount * positionY / itemCount;
				}
				else
				{
					requestedRowAvailableHeight = 0;
				}
			}

			//this array will contain all items that are not null. see the
			//comment above where the discoveredItemsCache is initialized for
			//details about why this is important.
			var discoveredItems:Vector.<DisplayObject> = this._useVirtualLayout ? this._discoveredItemsCache : items;
			var discoveredItemCount:int = discoveredItems.length;

			var totalWidth:Number = maxItemWidth + this._paddingLeft + this._paddingRight;
			//the available width is the width of the viewport. if the explicit
			//width is NaN, we need to calculate the viewport width ourselves
			//based on the total width of all items.
			var availableWidth:Number = explicitWidth;
			if(availableWidth !== availableWidth) //isNaN
			{
				availableWidth = totalWidth;
				if(availableWidth < minWidth)
				{
					availableWidth = minWidth;
				}
				else if(availableWidth > maxWidth)
				{
					availableWidth = maxWidth;
				}
			}

			//this is the total height of all items
			var totalHeight:Number = positionY - gap + this._paddingBottom - boundsY;
			//the available height is the height of the viewport. if the explicit
			//height is NaN, we need to calculate the viewport height ourselves
			//based on the total height of all items.
			var availableHeight:Number = explicitHeight;
			if(availableHeight !== availableHeight) //isNaN
			{
				availableHeight = totalHeight;
				if(this._requestedRowCount > 0)
				{
					if(this._useVirtualLayout)
					{
						availableHeight = this._requestedRowCount * (calculatedTypicalItemHeight + this._gap) - this._gap + this._paddingTop + this._paddingBottom;
					}
					else
					{
						availableHeight = requestedRowAvailableHeight;
					}
				}
				else
				{
					availableHeight = totalHeight;
					if(this._maxRowCount > 0)
					{
						if(this._useVirtualLayout)
						{
							maxRowAvailableHeight = this._maxRowCount * (calculatedTypicalItemHeight + this._gap) - this._gap + this._paddingTop + this._paddingBottom;
						}
						if(maxRowAvailableHeight < availableHeight)
						{
							availableHeight = maxRowAvailableHeight;
						}
					}
				}
				if(availableHeight < minHeight)
				{
					availableHeight = minHeight;
				}
				else if(availableHeight > maxHeight)
				{
					availableHeight = maxHeight;
				}
			}

			//in this section, we handle vertical alignment. items will be
			//aligned vertically if the total height of all items is less than
			//the available height of the view port.
			if(totalHeight < availableHeight)
			{
				var verticalAlignOffsetY:Number = 0;
				if(this._verticalAlign == VerticalAlign.BOTTOM)
				{
					verticalAlignOffsetY = availableHeight - totalHeight;
				}
				else if(this._verticalAlign == VerticalAlign.MIDDLE)
				{
					verticalAlignOffsetY = Math.round((availableHeight - totalHeight) / 2);
				}
				if(verticalAlignOffsetY != 0)
				{
					for(i = 0; i < discoveredItemCount; i++)
					{
						item = discoveredItems[i];
						if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
						{
							continue;
						}
						item.y += verticalAlignOffsetY;
					}
				}
			}

			var availableWidthMinusPadding:Number = availableWidth - this._paddingLeft - this._paddingRight;
			for(i = 0; i < discoveredItemCount; i++)
			{
				item = discoveredItems[i];
				layoutItem = item as ILayoutDisplayObject;
				if(layoutItem !== null && !layoutItem.includeInLayout)
				{
					continue;
				}

				var pivotX:Number = item.pivotX;
				if(pivotX != 0)
				{
					pivotX *= item.scaleX;
				}

				//in this section, we handle horizontal alignment and percent
				//width from VerticalLayoutData
				if(this._horizontalAlign == HorizontalAlign.JUSTIFY)
				{
					//if we justify items horizontally, we can skip percent width
					item.x = pivotX + boundsX + this._paddingLeft;
					item.width = availableWidthMinusPadding;
				}
				else
				{
					if(layoutItem !== null)
					{
						var layoutData:VerticalLayoutData = layoutItem.layoutData as VerticalLayoutData;
						if(layoutData !== null)
						{
							//in this section, we handle percentage width if
							//VerticalLayoutData is available.
							var percentWidth:Number = layoutData.percentWidth;
							if(percentWidth === percentWidth) //!isNaN
							{
								if(percentWidth < 0)
								{
									percentWidth = 0;
								}
								if(percentWidth > 100)
								{
									percentWidth = 100;
								}
								itemWidth = percentWidth * availableWidthMinusPadding / 100;
								if(item is IFeathersControl)
								{
									var feathersItem:IFeathersControl = IFeathersControl(item);
									var itemMinWidth:Number = feathersItem.explicitMinWidth;
									//we try to respect the minWidth, but not
									//when it's larger than 100%
									if(itemMinWidth > availableWidthMinusPadding)
									{
										itemMinWidth = availableWidthMinusPadding;
									}
									if(itemWidth < itemMinWidth)
									{
										itemWidth = itemMinWidth;
									}
									else
									{
										var itemMaxWidth:Number = feathersItem.explicitMaxWidth;
										if(itemWidth > itemMaxWidth)
										{
											itemWidth = itemMaxWidth;
										}
									}
								}
								item.width = itemWidth;
							}
						}
					}
					//handle all other horizontal alignment values (we handled
					//justify already). the x position of all items is set.
					var horizontalAlignWidth:Number = availableWidth;
					if(totalWidth > horizontalAlignWidth)
					{
						horizontalAlignWidth = totalWidth;
					}
					switch(this._horizontalAlign)
					{
						case HorizontalAlign.RIGHT:
						{
							item.x = pivotX + boundsX + horizontalAlignWidth - this._paddingRight - item.width;
							break;
						}
						case HorizontalAlign.CENTER:
						{
							//round to the nearest pixel when dividing by 2 to
							//align in the center
							item.x = pivotX + boundsX + this._paddingLeft + Math.round((horizontalAlignWidth - this._paddingLeft - this._paddingRight - item.width) / 2);
							break;
						}
						default: //left
						{
							item.x = pivotX + boundsX + this._paddingLeft;
						}
					}
				}
			}
			//we don't want to keep a reference to any of the items, so clear
			//this cache
			this._discoveredItemsCache.length = 0;

			//finally, we want to calculate the result so that the container
			//can use it to adjust its viewport and determine the minimum and
			//maximum scroll positions (if needed)
			if(!result)
			{
				result = new LayoutBoundsResult();
			}
			result.contentX = 0;
			result.contentWidth = this._horizontalAlign == HorizontalAlign.JUSTIFY ? availableWidth : totalWidth;
			result.contentY = 0;
			result.contentHeight = totalHeight;
			result.viewPortWidth = availableWidth;
			result.viewPortHeight = availableHeight;
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function measureViewPort(itemCount:int, viewPortBounds:ViewPortBounds = null, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("measureViewPort() may be called only if useVirtualLayout is true.");
			}

			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;
			var needsWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			var needsHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			if(!needsWidth && !needsHeight)
			{
				result.x = explicitWidth;
				result.y = explicitHeight;
				return result;
			}
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;

			this.prepareTypicalItem(explicitWidth - this._paddingLeft - this._paddingRight);
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var hasFirstGap:Boolean = this._firstGap === this._firstGap; //!isNaN
			var hasLastGap:Boolean = this._lastGap === this._lastGap; //!isNaN
			var positionY:Number;
			if(this._distributeHeights)
			{
				positionY = (calculatedTypicalItemHeight + this._gap) * itemCount;
			}
			else
			{
				positionY = 0;
				var maxItemWidth:Number = calculatedTypicalItemWidth;
				if(!this._hasVariableItemDimensions)
				{
					positionY += ((calculatedTypicalItemHeight + this._gap) * itemCount);
				}
				else
				{
					for(var i:int = 0; i < itemCount; i++)
					{
						var cachedHeight:Number = this._virtualCache[i];
						if(cachedHeight !== cachedHeight) //isNaN
						{
							positionY += calculatedTypicalItemHeight + this._gap;
						}
						else
						{
							positionY += cachedHeight + this._gap;
						}
					}
				}
			}
			positionY -= this._gap;
			if(hasFirstGap && itemCount > 1)
			{
				positionY = positionY - this._gap + this._firstGap;
			}
			if(hasLastGap && itemCount > 2)
			{
				positionY = positionY - this._gap + this._lastGap;
			}

			if(needsWidth)
			{
				var resultWidth:Number = maxItemWidth + this._paddingLeft + this._paddingRight;
				if(resultWidth < minWidth)
				{
					resultWidth = minWidth;
				}
				else if(resultWidth > maxWidth)
				{
					resultWidth = maxWidth;
				}
				result.x = resultWidth;
			}
			else
			{
				result.x = explicitWidth;
			}

			if(needsHeight)
			{
				if(this._requestedRowCount > 0)
				{
					var resultHeight:Number = (calculatedTypicalItemHeight + this._gap) * this._requestedRowCount - this._gap;
				}
				else
				{
					resultHeight = positionY;
					if(this._maxRowCount > 0)
					{
						var maxRowResultHeight:Number = (calculatedTypicalItemHeight + this._gap) * this._maxRowCount - this._gap;
						if(maxRowResultHeight < resultHeight)
						{
							resultHeight = maxRowResultHeight;
						}
					}
				}
				resultHeight += this._paddingTop + this._paddingBottom;
				if(resultHeight < minHeight)
				{
					resultHeight = minHeight;
				}
				else if(resultHeight > maxHeight)
				{
					resultHeight = maxHeight;
				}
				result.y = resultHeight;
			}
			else
			{
				result.y = explicitHeight;
			}

			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getVisibleIndicesAtScrollPosition(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int> = null):Vector.<int>
		{
			if(result)
			{
				result.length = 0;
			}
			else
			{
				result = new <int>[];
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("getVisibleIndicesAtScrollPosition() may be called only if useVirtualLayout is true.");
			}

			this.prepareTypicalItem(width - this._paddingLeft - this._paddingRight);
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var hasFirstGap:Boolean = this._firstGap === this._firstGap; //!isNaN
			var hasLastGap:Boolean = this._lastGap === this._lastGap; //!isNaN
			var resultLastIndex:int = 0;
			//we add one extra here because the first item renderer in view may
			//be partially obscured, which would reveal an extra item renderer.
			var maxVisibleTypicalItemCount:int = Math.ceil(height / (calculatedTypicalItemHeight + this._gap)) + 1;
			if(!this._hasVariableItemDimensions)
			{
				//this case can be optimized because we know that every item has
				//the same height
				var totalItemHeight:Number = itemCount * (calculatedTypicalItemHeight + this._gap) - this._gap;
				if(hasFirstGap && itemCount > 1)
				{
					totalItemHeight = totalItemHeight - this._gap + this._firstGap;
				}
				if(hasLastGap && itemCount > 2)
				{
					totalItemHeight = totalItemHeight - this._gap + this._lastGap;
				}
				var indexOffset:int = 0;
				if(totalItemHeight < height)
				{
					if(this._verticalAlign == VerticalAlign.BOTTOM)
					{
						indexOffset = Math.ceil((height - totalItemHeight) / (calculatedTypicalItemHeight + this._gap));
					}
					else if(this._verticalAlign == VerticalAlign.MIDDLE)
					{
						indexOffset = Math.ceil(((height - totalItemHeight) / (calculatedTypicalItemHeight + this._gap)) / 2);
					}
				}
				var minimum:int = (scrollY - this._paddingTop) / (calculatedTypicalItemHeight + this._gap);
				if(minimum < 0)
				{
					minimum = 0;
				}
				minimum -= indexOffset;
				//if we're scrolling beyond the final item, we should keep the
				//indices consistent so that items aren't destroyed and
				//recreated unnecessarily
				var maximum:int = minimum + maxVisibleTypicalItemCount;
				if(maximum >= itemCount)
				{
					maximum = itemCount - 1;
				}
				minimum = maximum - maxVisibleTypicalItemCount;
				if(minimum < 0)
				{
					minimum = 0;
				}
				for(var i:int = minimum; i <= maximum; i++)
				{
					if(i >= 0 && i < itemCount)
					{
						result[resultLastIndex] = i;
					}
					else if(i < 0)
					{
						result[resultLastIndex] = itemCount + i;
					}
					else if(i >= itemCount)
					{
						result[resultLastIndex] = i - itemCount;
					}
					resultLastIndex++;
				}
				return result;
			}

			var headerIndicesIndex:int = -1;
			var nextHeaderIndex:int = -1;
			var headerCount:int = 0;
			if(this._headerIndices && this._stickyHeader)
			{
				headerCount = this._headerIndices.length;
				if(headerCount > 0)
				{
					headerIndicesIndex = 0;
					nextHeaderIndex = this._headerIndices[headerIndicesIndex];
				}
			}

			var secondToLastIndex:int = itemCount - 2;
			var maxPositionY:Number = scrollY + height;
			var startPositionY:Number = this._paddingTop;
			var foundSticky:Boolean = false;
			var positionY:Number = startPositionY;
			for(i = 0; i < itemCount; i++)
			{
				if(nextHeaderIndex == i)
				{
					if(positionY < scrollY)
					{
						headerIndicesIndex++;
						if(headerIndicesIndex < headerCount)
						{
							nextHeaderIndex = this._headerIndices[headerIndicesIndex];
						}
					}
					else
					{
						headerIndicesIndex--;
						if(headerIndicesIndex >= 0)
						{
							//this is the index of the "sticky" header
							nextHeaderIndex = this._headerIndices[headerIndicesIndex];
							foundSticky = true;
						}
					}
				}

				var gap:Number = this._gap;
				if(hasFirstGap && i == 0)
				{
					gap = this._firstGap;
				}
				else if(hasLastGap && i > 0 && i == secondToLastIndex)
				{
					gap = this._lastGap;
				}
				var cachedHeight:Number = this._virtualCache[i];
				if(cachedHeight !== cachedHeight) //isNaN
				{
					var itemHeight:Number = calculatedTypicalItemHeight;
				}
				else
				{
					itemHeight = cachedHeight;
				}
				var oldPositionY:Number = positionY;
				positionY += itemHeight + gap;
				if(positionY > scrollY && oldPositionY < maxPositionY)
				{
					result[resultLastIndex] = i;
					resultLastIndex++;
				}

				if(positionY >= maxPositionY)
				{
					if(!foundSticky)
					{
						headerIndicesIndex--;
						if(headerIndicesIndex >= 0)
						{
							//this is the index of the "sticky" header
							nextHeaderIndex = this._headerIndices[headerIndicesIndex];
						}
					}
					break;
				}
			}
			if(nextHeaderIndex >= 0 && result.indexOf(nextHeaderIndex) < 0)
			{
				var addedStickyHeader:Boolean = false;
				for(i = 0; i < resultLastIndex; i++)
				{
					if(nextHeaderIndex <= result[i])
					{
						result.insertAt(i, nextHeaderIndex);
						addedStickyHeader = true;
						break;
					}
				}
				if(!addedStickyHeader)
				{
					result[resultLastIndex] = nextHeaderIndex;
				}
				resultLastIndex++;
			}

			//similar to above, in order to avoid costly destruction and
			//creation of item renderers, we're going to fill in some extra
			//indices
			var resultLength:int = result.length;
			var visibleItemCountDifference:int = maxVisibleTypicalItemCount - resultLength;
			if(visibleItemCountDifference > 0 && resultLength > 0)
			{
				//add extra items before the first index
				var firstExistingIndex:int = result[0];
				var lastIndexToAdd:int = firstExistingIndex - visibleItemCountDifference;
				if(lastIndexToAdd < 0)
				{
					lastIndexToAdd = 0;
				}
				for(i = firstExistingIndex - 1; i >= lastIndexToAdd; i--)
				{
					if(i == nextHeaderIndex)
					{
						continue;
					}
					result.insertAt(0, i);
				}
			}
			resultLength = result.length;
			visibleItemCountDifference = maxVisibleTypicalItemCount - resultLength;
			resultLastIndex = resultLength;
			if(visibleItemCountDifference > 0)
			{
				//add extra items after the last index
				var startIndex:int = (resultLength > 0) ? (result[resultLength - 1] + 1) : 0;
				var endIndex:int = startIndex + visibleItemCountDifference;
				if(endIndex > itemCount)
				{
					endIndex = itemCount;
				}
				for(i = startIndex; i < endIndex; i++)
				{
					if(i == nextHeaderIndex)
					{
						continue;
					}
					result[resultLastIndex] = i;
					resultLastIndex++;
				}
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getNearestScrollPositionForIndex(index:int, scrollX:Number, scrollY:Number, items:Vector.<DisplayObject>,
			x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			var point:Point = Pool.getPoint();
			this.calculateScrollRangeOfIndex(index, items, x, y, width, height, point);
			var minScrollY:Number = point.x;
			var maxScrollY:Number = point.y;
			var scrollRange:Number = maxScrollY - minScrollY;
			Pool.putPoint(point);

			if(this._useVirtualLayout)
			{
				if(this._hasVariableItemDimensions)
				{
					var itemHeight:Number = this._virtualCache[index];
					if(itemHeight !== itemHeight) //isNaN
					{
						itemHeight = this._typicalItem.height;
					}
				}
				else
				{
					itemHeight = this._typicalItem.height;
				}
			}
			else
			{
				itemHeight = items[index].height;
			}

			if(!result)
			{
				result = new Point();
			}
			result.x = 0;

			var bottomPosition:Number = maxScrollY - (scrollRange - itemHeight);
			if(scrollY >= bottomPosition && scrollY <= maxScrollY)
			{
				//keep the current scroll position because the item is already
				//fully visible
				result.y = scrollY;
			}
			else
			{
				var topDifference:Number = Math.abs(maxScrollY - scrollY);
				var bottomDifference:Number = Math.abs(bottomPosition - scrollY);
				if(bottomDifference < topDifference)
				{
					result.y = bottomPosition;
				}
				else
				{
					result.y = maxScrollY;
				}
			}

			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function calculateNavigationDestination(items:Vector.<DisplayObject>, index:int, keyCode:uint, bounds:LayoutBoundsResult):int
		{
			var itemArrayCount:int = items.length;
			var itemCount:int = itemArrayCount + this._beforeVirtualizedItemCount + this._afterVirtualizedItemCount;
			if(this._useVirtualLayout)
			{
				//if the layout is virtualized, we'll need the dimensions of the
				//typical item so that we have fallback values when an item is null
				this.prepareTypicalItem(bounds.viewPortWidth - this._paddingLeft - this._paddingRight);
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var backwards:Boolean = false;
			var result:int = index;
			if(keyCode == Keyboard.HOME)
			{
				backwards = true;
				if(itemCount > 0)
				{
					result = 0;
				}
			}
			else if(keyCode == Keyboard.END)
			{
				result = itemCount - 1;
			}
			else if(keyCode == Keyboard.PAGE_UP)
			{
				backwards = true;
				var indexOffset:int = 0;
				if(this._useVirtualLayout && this._hasVariableItemDimensions)
				{
					indexOffset = -this._beforeVirtualizedItemCount;
				}
				var yPosition:Number = 0;
				for(var i:int = index; i >= 0; i--)
				{
					var iNormalized:int = i + indexOffset;
					if(this._useVirtualLayout && this._hasVariableItemDimensions)
					{
						var cachedHeight:Number = this._virtualCache[i];
					}
					if(iNormalized < 0 || iNormalized >= itemArrayCount)
					{
						if(cachedHeight === cachedHeight) //!isNaN
						{
							yPosition += cachedHeight;
						}
						else
						{
							yPosition += calculatedTypicalItemHeight;
						}
					}
					else
					{
						var item:DisplayObject = items[iNormalized];
						if(item === null)
						{
							if(cachedHeight === cachedHeight) //!isNaN
							{
								yPosition += cachedHeight;
							}
							else
							{
								yPosition += calculatedTypicalItemHeight;
							}
						}
						else
						{
							yPosition += item.height;
						}
					}
					if(yPosition > bounds.viewPortHeight)
					{
						break;
					}
					yPosition += this._gap;
					result = i;
				}
			}
			else if(keyCode == Keyboard.PAGE_DOWN)
			{
				yPosition = 0;
				indexOffset = 0;
				if(this._useVirtualLayout && this._hasVariableItemDimensions)
				{
					indexOffset = -this._beforeVirtualizedItemCount;
				}
				for(i = index; i < itemCount; i++)
				{
					iNormalized = i + indexOffset;
					if(this._useVirtualLayout && this._hasVariableItemDimensions)
					{
						cachedHeight = this._virtualCache[i];
					}
					if(iNormalized < 0 || iNormalized >= itemArrayCount)
					{
						if(cachedHeight === cachedHeight) //!isNaN
						{
							yPosition += cachedHeight;
						}
						else
						{
							yPosition += calculatedTypicalItemHeight;
						}
					}
					else
					{
						item = items[iNormalized];
						if(item === null)
						{
							if(cachedHeight === cachedHeight) //!isNaN
							{
								yPosition += cachedHeight;
							}
							else
							{
								yPosition += calculatedTypicalItemHeight;
							}
						}
						else
						{
							yPosition += item.height;
						}
					}
					if(yPosition > bounds.viewPortHeight)
					{
						break;
					}
					yPosition += this._gap;
					result = i;
				}
			}
			else if(keyCode == Keyboard.UP)
			{
				backwards = true;
				result--;
			}
			else if(keyCode == Keyboard.DOWN)
			{
				result++;
			}
			if(result < 0)
			{
				result = 0;
			}
			if(result >= itemCount)
			{
				result = itemCount - 1;
			}
			while(this._headerIndices !== null && this._headerIndices.indexOf(result) != -1)
			{
				if(backwards)
				{
					if(result == 0)
					{
						backwards = false;
						result++;
					}
					else
					{
						result--;
					}
				}
				else
				{
					result++;
				}
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getScrollPositionForIndex(index:int, items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			var point:Point = Pool.getPoint();
			this.calculateScrollRangeOfIndex(index, items, x, y, width, height, point);
			var minScrollY:Number = point.x;
			var maxScrollY:Number = point.y;
			var scrollRange:Number = maxScrollY - minScrollY;
			Pool.putPoint(point);

			if(this._useVirtualLayout)
			{
				if(this._hasVariableItemDimensions)
				{
					var itemHeight:Number = this._virtualCache[index];
					if(itemHeight !== itemHeight) //isNaN
					{
						itemHeight = this._typicalItem.height;
					}
				}
				else
				{
					itemHeight = this._typicalItem.height;
				}
			}
			else
			{
				itemHeight = items[index].height;
			}

			if(!result)
			{
				result = new Point();
			}
			result.x = 0;

			var verticalAlign:String = this._scrollPositionVerticalAlign;
			if(this._headerIndices !== null &&
				this._headerIndices.indexOf(index) != -1)
			{
				verticalAlign = this._headerScrollPositionVerticalAlign;
			}
			if(verticalAlign === VerticalAlign.MIDDLE)
			{
				maxScrollY -= Math.round((scrollRange - itemHeight) / 2);
			}
			else if(verticalAlign === VerticalAlign.BOTTOM)
			{
				maxScrollY -= (scrollRange - itemHeight);
			}
			result.y = maxScrollY;

			return result;
		}

		/**
		 * @private
		 */
		public function positionDropIndicator(dropIndicator:DisplayObject, index:int,
			x:Number, y:Number, items:Vector.<DisplayObject>, width:Number, height:Number):void
		{
			var indexOffset:int = 0;
			var itemCount:int = items.length;
			var totalItemCount:int = itemCount;
			if(this._useVirtualLayout && !this._hasVariableItemDimensions)
			{
				//if the layout is virtualized, and the items all have the same
				//height, we can make our loops smaller by skipping some items
				//at the beginning and end. this improves performance.
				totalItemCount += this._beforeVirtualizedItemCount + this._afterVirtualizedItemCount;
				indexOffset = this._beforeVirtualizedItemCount;
			}
			var indexMinusOffset:int = index - indexOffset;

			if(dropIndicator is IValidating)
			{
				IValidating(dropIndicator).validate();
			}

			var yPosition:Number = 0;
			if(index < totalItemCount)
			{
				var item:DisplayObject = items[indexMinusOffset];
				yPosition = item.y - dropIndicator.height / 2;
				dropIndicator.x = item.x;
				dropIndicator.width = item.width;
			}
			else //after the last item
			{
				item = items[indexMinusOffset - 1];
				yPosition = item.y + item.height - dropIndicator.height;
				dropIndicator.x = item.x;
				dropIndicator.width = item.width;
			}
			if(yPosition < 0)
			{
				yPosition = 0;
			}
			dropIndicator.y = yPosition;
		}

		/**
		 * @private
		 */
		public function getDropIndex(x:Number, y:Number, items:Vector.<DisplayObject>,
			boundsX:Number, boundsY:Number, width:Number, height:Number):int
		{
			if(this._useVirtualLayout)
			{
				this.prepareTypicalItem(width - this._paddingLeft - this._paddingRight);
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}
			var hasFirstGap:Boolean = this._firstGap === this._firstGap; //!isNaN
			var hasLastGap:Boolean = this._lastGap === this._lastGap; //!isNaN
			var positionY:Number = boundsY + this._paddingTop;
			var lastHeight:Number = 0;
			var gap:Number = this._gap;
			var indexOffset:int = 0;
			var itemCount:int = items.length;
			var totalItemCount:int = itemCount;
			if(this._useVirtualLayout && !this._hasVariableItemDimensions)
			{
				totalItemCount += this._beforeVirtualizedItemCount + this._afterVirtualizedItemCount;
				indexOffset = this._beforeVirtualizedItemCount;
			}
			var secondToLastIndex:int = totalItemCount - 2;
			for(var i:int = 0; i <= totalItemCount; i++)
			{
				var item:DisplayObject = null;
				var indexMinusOffset:int = i - indexOffset;
				if(indexMinusOffset >= 0 && indexMinusOffset < itemCount)
				{
					item = items[indexMinusOffset];
				}
				if(hasFirstGap && i == 0)
				{
					gap = this._firstGap;
				}
				else if(hasLastGap && i > 0 && i == secondToLastIndex)
				{
					gap = this._lastGap;
				}
				else
				{
					gap = this._gap;
				}
				if(this._useVirtualLayout && this._hasVariableItemDimensions)
				{
					var cachedHeight:Number = this._virtualCache[i];
				}
				if(this._useVirtualLayout && !item)
				{
					if(!this._hasVariableItemDimensions ||
						cachedHeight !== cachedHeight) //isNaN
					{
						lastHeight = calculatedTypicalItemHeight;
					}
					else
					{
						lastHeight = cachedHeight;
					}
				}
				else
				{
					//use the y position of the item to account for vertical
					//alignment, in case the total height of the items is less
					//than the height of the container
					positionY = item.y;
					var itemHeight:Number = item.height;
					if(this._useVirtualLayout)
					{
						if(this._hasVariableItemDimensions)
						{
							if(itemHeight != cachedHeight)
							{
								this._virtualCache[i] = itemHeight;
								this.dispatchEventWith(Event.CHANGE);
							}
						}
						else if(calculatedTypicalItemHeight >= 0)
						{
							itemHeight = calculatedTypicalItemHeight;
						}
					}
					lastHeight = itemHeight;
				}
				if(y < (positionY + (lastHeight / 2)))
				{
					return i;
				}
				positionY += lastHeight + gap;
			}
			return totalItemCount;
		}

		/**
		 * @private
		 */
		protected function validateItems(items:Vector.<DisplayObject>,
			explicitWidth:Number, minWidth:Number, maxWidth:Number,
			explicitHeight:Number, minHeight:Number, maxHeight:Number,
			distributedHeight:Number):void
		{
			var needsHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			var containerHeight:Number = explicitHeight;
			if(needsHeight)
			{
				containerHeight = minHeight;
			}
			//if the alignment is justified, then we want to set the width of
			//each item before validating because setting one dimension may
			//cause the other dimension to change, and that will invalidate the
			//layout if it happens after validation, causing more invalidation
			var isJustified:Boolean = this._horizontalAlign == HorizontalAlign.JUSTIFY;
			var itemCount:int = items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				if(!item || (item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout))
				{
					continue;
				}
				if(isJustified)
				{
					//the alignment is justified, but we don't yet have a width
					//to use, so we need to ensure that we accurately measure
					//the items instead of using an old justified width that may
					//be wrong now!
					item.width = explicitWidth;
					if(item is IFeathersControl)
					{
						var feathersItem:IFeathersControl = IFeathersControl(item);
						feathersItem.minWidth = minWidth;
						feathersItem.maxWidth = maxWidth;
					}
				}
				else if(item is ILayoutDisplayObject)
				{
					var layoutItem:ILayoutDisplayObject = ILayoutDisplayObject(item);
					var layoutData:VerticalLayoutData = layoutItem.layoutData as VerticalLayoutData;
					if(layoutData !== null)
					{
						var percentWidth:Number = layoutData.percentWidth;
						var percentHeight:Number = layoutData.percentHeight;
						if(percentWidth === percentWidth) //!isNaN
						{
							if(percentWidth < 0)
							{
								percentWidth = 0;
							}
							if(percentWidth > 100)
							{
								percentWidth = 100;
							}
							var itemWidth:Number = explicitWidth * percentWidth / 100;
							var measureItem:IMeasureDisplayObject = IMeasureDisplayObject(item);
							//we use the explicitMinWidth to make an accurate
							//measurement, and we'll use the component's
							//measured minWidth later, after we validate it.
							var itemExplicitMinWidth:Number = measureItem.explicitMinWidth;
							if(measureItem.explicitMinWidth === measureItem.explicitMinWidth && //!isNaN
								itemWidth < itemExplicitMinWidth)
							{
								itemWidth = itemExplicitMinWidth;
							}
							if(itemWidth > maxWidth)
							{
								itemWidth = maxWidth;
							}
							//unlike below, where we set maxHeight, we can set
							//the width explicitly here
							//in fact, it's required because we need to make
							//an accurate measurement of the total view port
							//width
							item.width = itemWidth;
							//if itemWidth is NaN, we need to set a maximum
							//width instead. this is important for items where
							//the height becomes larger when their width becomes
							//smaller (such as word-wrapped text)
							if(measureItem.explicitWidth !== measureItem.explicitWidth && //isNaN
								measureItem.maxWidth > maxWidth)
							{
								measureItem.maxWidth = maxWidth;
							}
						}
						if(percentHeight === percentHeight) //!isNaN
						{
							var itemHeight:Number = containerHeight * percentHeight / 100;
							measureItem = IMeasureDisplayObject(item);
							//we use the explicitMinHeight to make an accurate
							//measurement, and we'll use the component's
							//measured minHeight later, after we validate it.
							var itemExplicitMinHeight:Number = measureItem.explicitMinHeight;
							if(measureItem.explicitMinHeight === measureItem.explicitMinHeight && //!isNaN
								itemHeight < itemExplicitMinHeight)
							{
								itemHeight = itemExplicitMinHeight;
							}
							//validating this component may be expensive if we
							//don't limit the height! we want to ensure that a
							//component like a vertical list with many item
							//renderers doesn't completely bypass layout
							//virtualization, so we limit the height to the
							//maximum possible value if it were the only item in
							//the layout.
							//this doesn't need to be perfectly accurate because
							//it's just a maximum
							measureItem.maxHeight = itemHeight;
							//we also need to clear the explicit height because,
							//for many components, it will affect the minHeight
							//which is used in the final calculation
							item.height = NaN;
						}
					}
				}
				if(this._distributeHeights)
				{
					item.height = distributedHeight;
				}
				if(item is IValidating)
				{
					IValidating(item).validate();
				}
			}
		}

		/**
		 * @private
		 */
		protected function prepareTypicalItem(justifyWidth:Number):void
		{
			if(!this._typicalItem)
			{
				return;
			}
			var hasSetWidth:Boolean = false;
			if(this._horizontalAlign == HorizontalAlign.JUSTIFY &&
				justifyWidth === justifyWidth) //!isNaN
			{
				hasSetWidth = true;
				this._typicalItem.width = justifyWidth;
			}
			else if(this._typicalItem is ILayoutDisplayObject)
			{
				var layoutItem:ILayoutDisplayObject = ILayoutDisplayObject(this._typicalItem);
				var layoutData:VerticalLayoutData = layoutItem.layoutData as VerticalLayoutData;
				if(layoutData !== null)
				{
					var percentWidth:Number = layoutData.percentWidth;
					if(percentWidth === percentWidth) //!isNaN
					{
						if(percentWidth < 0)
						{
							percentWidth = 0;
						}
						if(percentWidth > 100)
						{
							percentWidth = 100;
						}
						hasSetWidth = true;
						this._typicalItem.width = justifyWidth * percentWidth / 100;
					}
				}
			}
			if(!hasSetWidth && this._resetTypicalItemDimensionsOnMeasure)
			{
				this._typicalItem.width = this._typicalItemWidth;
			}
			if(this._resetTypicalItemDimensionsOnMeasure)
			{
				this._typicalItem.height = this._typicalItemHeight;
			}
			if(this._typicalItem is IValidating)
			{
				IValidating(this._typicalItem).validate();
			}
		}

		/**
		 * @private
		 */
		protected function calculateDistributedHeight(items:Vector.<DisplayObject>, explicitHeight:Number, minHeight:Number, maxHeight:Number, measureItems:Boolean):Number
		{
			var needsHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			var includedItemCount:int = 0;
			var maxItemHeight:Number = 0;
			var itemCount:int = items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
				{
					continue;
				}
				includedItemCount++;
				var itemHeight:Number = item.height;
				if(itemHeight > maxItemHeight)
				{
					maxItemHeight = itemHeight;
				}
			}
			if(measureItems && needsHeight)
			{
				explicitHeight = maxItemHeight * includedItemCount + this._paddingTop + this._paddingBottom + this._gap * (includedItemCount - 1);
				var needsRecalculation:Boolean = false;
				if(explicitHeight > maxHeight)
				{
					explicitHeight = maxHeight;
					needsRecalculation = true;
				}
				else if(explicitHeight < minHeight)
				{
					explicitHeight = minHeight;
					needsRecalculation = true;
				}
				if(!needsRecalculation)
				{
					return maxItemHeight;
				}
			}
			var availableSpace:Number = explicitHeight;
			if(needsHeight && maxHeight < Number.POSITIVE_INFINITY)
			{
				availableSpace = maxHeight;
			}
			availableSpace = availableSpace - this._paddingTop - this._paddingBottom - this._gap * (includedItemCount - 1);
			if(includedItemCount > 1 && this._firstGap === this._firstGap) //!isNaN
			{
				availableSpace += this._gap - this._firstGap;
			}
			if(includedItemCount > 2 && this._lastGap === this._lastGap) //!isNaN
			{
				availableSpace += this._gap - this._lastGap;
			}
			return availableSpace / includedItemCount;
		}

		/**
		 * @private
		 */
		protected function applyPercentHeights(items:Vector.<DisplayObject>, explicitHeight:Number, minHeight:Number, maxHeight:Number):void
		{
			var remainingHeight:Number = explicitHeight;
			this._discoveredItemsCache.length = 0;
			var totalExplicitHeight:Number = 0;
			var totalMinHeight:Number = 0;
			var totalPercentHeight:Number = 0;
			var itemCount:int = items.length;
			var pushIndex:int = 0;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				if(item is ILayoutDisplayObject)
				{
					var layoutItem:ILayoutDisplayObject = ILayoutDisplayObject(item);
					if(!layoutItem.includeInLayout)
					{
						continue;
					}
					var layoutData:VerticalLayoutData = layoutItem.layoutData as VerticalLayoutData;
					if(layoutData)
					{
						var percentHeight:Number = layoutData.percentHeight;
						if(percentHeight === percentHeight) //!isNaN
						{
							if(percentHeight < 0)
							{
								percentHeight = 0;
							}
							if(layoutItem is IFeathersControl)
							{
								var feathersItem:IFeathersControl = IFeathersControl(layoutItem);
								totalMinHeight += feathersItem.minHeight;
							}
							totalPercentHeight += percentHeight;
							totalExplicitHeight += this._gap;
							this._discoveredItemsCache[pushIndex] = item;
							pushIndex++;
							continue;
						}
					}
				}
				totalExplicitHeight += item.height + this._gap;
			}
			totalExplicitHeight -= this._gap;
			if(this._firstGap === this._firstGap && itemCount > 1)
			{
				totalExplicitHeight += (this._firstGap - this._gap);
			}
			else if(this._lastGap === this._lastGap && itemCount > 2)
			{
				totalExplicitHeight += (this._lastGap - this._gap);
			}
			totalExplicitHeight += this._paddingTop + this._paddingBottom;
			if(totalPercentHeight < 100)
			{
				totalPercentHeight = 100;
			}
			if(remainingHeight !== remainingHeight) //isNaN
			{
				remainingHeight = totalExplicitHeight + totalMinHeight;
				if(remainingHeight < minHeight)
				{
					remainingHeight = minHeight;
				}
				else if(remainingHeight > maxHeight)
				{
					remainingHeight = maxHeight;
				}
			}
			remainingHeight -= totalExplicitHeight;
			if(remainingHeight < 0)
			{
				remainingHeight = 0;
			}
			do
			{
				var needsAnotherPass:Boolean = false;
				var percentToPixels:Number = remainingHeight / totalPercentHeight;
				for(i = 0; i < pushIndex; i++)
				{
					layoutItem = ILayoutDisplayObject(this._discoveredItemsCache[i]);
					if(!layoutItem)
					{
						continue;
					}
					layoutData = VerticalLayoutData(layoutItem.layoutData);
					percentHeight = layoutData.percentHeight;
					if(percentHeight < 0)
					{
						percentHeight = 0;
					}
					var itemHeight:Number = percentToPixels * percentHeight;
					if(layoutItem is IFeathersControl)
					{
						feathersItem = IFeathersControl(layoutItem);
						var itemMinHeight:Number = feathersItem.explicitMinHeight;
						if(itemMinHeight > remainingHeight)
						{
							//we try to respect the item's minimum height, but
							//if it's larger than the remaining space, we need
							//to force it to fit
							itemMinHeight = remainingHeight;
						}
						if(itemHeight < itemMinHeight)
						{
							itemHeight = itemMinHeight;
							remainingHeight -= itemHeight;
							totalPercentHeight -= percentHeight;
							this._discoveredItemsCache[i] = null;
							needsAnotherPass = true;
						}
						//we don't check maxHeight here because it is used in
						//validateItems() for performance optimization, so it
						//isn't a real maximum
					}
					layoutItem.height = itemHeight;
					if(layoutItem is IValidating)
					{
						//changing the height of the item may cause its width
						//to change, so we need to validate. the width is needed
						//for measurement.
						IValidating(layoutItem).validate();
					}
				}
			}
			while(needsAnotherPass);
			this._discoveredItemsCache.length = 0;
		}

		/**
		 * @private
		 */
		protected function calculateScrollRangeOfIndex(index:int, items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point):void
		{
			if(this._useVirtualLayout)
			{
				this.prepareTypicalItem(width - this._paddingLeft - this._paddingRight);
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}
			var headerIndicesIndex:int = -1;
			var nextHeaderIndex:int = -1;
			var headerCount:int = 0;
			var lastHeaderHeight:Number = 0;
			if(this._headerIndices && this._stickyHeader)
			{
				headerCount = this._headerIndices.length;
				if(headerCount > 0)
				{
					headerIndicesIndex = 0;
					nextHeaderIndex = this._headerIndices[headerIndicesIndex];
				}
			}
			var hasFirstGap:Boolean = this._firstGap === this._firstGap; //!isNaN
			var hasLastGap:Boolean = this._lastGap === this._lastGap; //!isNaN
			var positionY:Number = y + this._paddingTop;
			var lastHeight:Number = 0;
			var gap:Number = this._gap;
			var startIndexOffset:int = 0;
			var endIndexOffset:Number = 0;
			var itemCount:int = items.length;
			var totalItemCount:int = itemCount;
			if(this._useVirtualLayout && !this._hasVariableItemDimensions)
			{
				totalItemCount += this._beforeVirtualizedItemCount + this._afterVirtualizedItemCount;
				if(index < this._beforeVirtualizedItemCount)
				{
					//this makes it skip the loop below
					startIndexOffset = index + 1;
					lastHeight = calculatedTypicalItemHeight;
					gap = this._gap;
				}
				else
				{
					startIndexOffset = this._beforeVirtualizedItemCount;
					endIndexOffset = index - items.length - this._beforeVirtualizedItemCount + 1;
					if(endIndexOffset < 0)
					{
						endIndexOffset = 0;
					}
					positionY += (endIndexOffset * (calculatedTypicalItemHeight + this._gap));
				}
				positionY += (startIndexOffset * (calculatedTypicalItemHeight + this._gap));
			}
			index -= (startIndexOffset + endIndexOffset);
			var secondToLastIndex:int = totalItemCount - 2;
			for(var i:int = 0; i <= index; i++)
			{
				var item:DisplayObject = items[i];
				var iNormalized:int = i + startIndexOffset;
				if(hasFirstGap && iNormalized == 0)
				{
					gap = this._firstGap;
				}
				else if(hasLastGap && iNormalized > 0 && iNormalized == secondToLastIndex)
				{
					gap = this._lastGap;
				}
				else
				{
					gap = this._gap;
				}
				if(this._useVirtualLayout && this._hasVariableItemDimensions)
				{
					var cachedHeight:Number = this._virtualCache[iNormalized];
				}
				if(this._useVirtualLayout && !item)
				{
					if(!this._hasVariableItemDimensions ||
						cachedHeight !== cachedHeight) //isNaN
					{
						lastHeight = calculatedTypicalItemHeight;
					}
					else
					{
						lastHeight = cachedHeight;
					}
				}
				else
				{
					var itemHeight:Number = item.height;
					if(this._useVirtualLayout)
					{
						if(this._hasVariableItemDimensions)
						{
							if(itemHeight != cachedHeight)
							{
								this._virtualCache[iNormalized] = itemHeight;
								this.dispatchEventWith(Event.CHANGE);
							}
						}
						else if(calculatedTypicalItemHeight >= 0)
						{
							item.height = itemHeight = calculatedTypicalItemHeight;
						}
					}
					lastHeight = itemHeight;
				}
				positionY += lastHeight + gap;
				if(nextHeaderIndex == iNormalized)
				{
					lastHeaderHeight = lastHeight;
					//if the sticky header is enabled, we need to find its index
					//we look for the first header that is visible at the top of
					//the view port. the previous one should be sticky.
					headerIndicesIndex++;
					if(headerIndicesIndex < headerCount)
					{
						nextHeaderIndex = this._headerIndices[headerIndicesIndex];
					}
				}
			}
			positionY -= (lastHeight + gap);
			result.x = positionY - height;
			if(this._stickyHeader &&
				this._headerIndices !== null &&
				this._headerIndices.indexOf(index) == -1)
			{
				//if the headers are sticky, adjust the scroll range if we're
				//scrolling to an item because the sticky header should not hide
				//the item
				//unlike items, though, headers have a full scroll range
				positionY -= lastHeaderHeight;
			}
			result.y = positionY;
		}

		/**
		 * @private
		 */
		protected function positionStickyHeader(header:DisplayObject, scrollY:Number, maxY:Number):void
		{
			if(!header || header.y >= scrollY)
			{
				return;
			}
			if(header is IValidating)
			{
				IValidating(header).validate();
			}
			maxY -= header.height;
			if(maxY > scrollY)
			{
				maxY = scrollY;
			}
			header.y = maxY;
			//ensure that the sticky header is always on top!
			var headerParent:DisplayObjectContainer = header.parent;
			if(headerParent)
			{
				headerParent.setChildIndex(header, headerParent.numChildren - 1);
			}
		}
	}
}


================================================
FILE: source/feathers/layout/VerticalLayoutData.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * @inheritDoc
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Extra, optional data used by an <code>VerticalLayout</code> instance to
	 * position and size a display object.
	 *
	 * @see VerticalLayout
	 * @see ILayoutDisplayObject
	 *
	 * @productversion Feathers 1.3.0
	 */
	public class VerticalLayoutData extends EventDispatcher implements ILayoutData
	{
		/**
		 * Constructor.
		 */
		public function VerticalLayoutData(percentWidth:Number = NaN, percentHeight:Number = NaN)
		{
			this._percentWidth = percentWidth;
			this._percentHeight = percentHeight;
		}

		/**
		 * @private
		 */
		protected var _percentWidth:Number;

		/**
		 * The width of the layout object, as a percentage of the container's
		 * width.
		 *
		 * <p>A percentage may be specified in the range from <code>0</code>
		 * to <code>100</code>. If the value is set to <code>NaN</code>, this
		 * property is ignored.</p>
		 *
		 * <p>Performance tip: If all items in your layout will have 100% width,
		 * it's better to set the <code>horizontalAlign</code> property of the
		 * <code>VerticalLayout</code> to
		 * <code>HorizontalAlign.JUSTIFY</code>.</p>
		 *
		 * @default NaN
		 *
		 * @see feathers.layout.VerticalLayout#horizontalAlign
		 */
		public function get percentWidth():Number
		{
			return this._percentWidth;
		}

		/**
		 * @private
		 */
		public function set percentWidth(value:Number):void
		{
			if(this._percentWidth == value)
			{
				return;
			}
			this._percentWidth = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _percentHeight:Number;

		/**
		 * The height of the layout object, as a percentage of the container's
		 * height. The container will calculate the sum of all of its children
		 * with explicit pixel heights, and then the remaining space will be
		 * distributed to children with percent heights.
		 *
		 * <p>A percentage may be specified in the range from <code>0</code>
		 * to <code>100</code>. If the value is set to <code>NaN</code>, this
		 * property is ignored. It will also be ignored when the
		 * <code>useVirtualLayout</code> property of the
		 * <code>VerticalLayout</code> is set to <code>false</code>.</p>
		 *
		 * @default NaN
		 */
		public function get percentHeight():Number
		{
			return this._percentHeight;
		}

		/**
		 * @private
		 */
		public function set percentHeight(value:Number):void
		{
			if(this._percentHeight == value)
			{
				return;
			}
			this._percentHeight = value;
			this.dispatchEventWith(Event.CHANGE);
		}
	}
}


================================================
FILE: source/feathers/layout/VerticalSpinnerLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import feathers.core.IFeathersControl;
	import feathers.core.IValidating;
	import feathers.layout.VerticalAlign;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;
	import flash.geom.Rectangle;
	import flash.ui.Keyboard;

	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when a property of the layout changes, indicating that a
	 * redraw is probably needed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * For use with the <code>SpinnerList</code> component, positions items from
	 * top to bottom in a single column and repeats infinitely.
	 *
	 * @see ../../../help/vertical-spinner-layout.html How to use VerticalSpinnerLayout with the Feathers SpinnerList component
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class VerticalSpinnerLayout extends EventDispatcher implements ISpinnerLayout, ITrimmedVirtualLayout
	{
		/**
		 * Constructor.
		 */
		public function VerticalSpinnerLayout()
		{
			super();
		}

		/**
		 * @private
		 */
		protected var _discoveredItemsCache:Vector.<DisplayObject> = new <DisplayObject>[];

		/**
		 * @private
		 */
		protected var _gap:Number = 0;

		/**
		 * The space, in pixels, between items.
		 *
		 * @default 0
		 */
		public function get gap():Number
		{
			return this._gap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			if(this._gap == value)
			{
				return;
			}
			this._gap = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * Quickly sets all padding properties to the same value. The
		 * <code>padding</code> getter always returns the value of
		 * <code>paddingLeft</code>, but the other padding values may be
		 * different.
		 *
		 * @default 0
		 *
		 * @see #paddingRight
		 * @see #paddingLeft
		 */
		public function get padding():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingRight = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * The minimum space, in pixels, above the items, if they
		 * do not repeat. If items repeat, <code>paddingTop</code> will
		 * only be used if <code>verticalAlign</code> is set to
		 * <code>VerticalAlign.TOP</code>. In this case, the first item,
		 * starting from the top, will be offset by the value of
		 * <code>paddingTop</code>.
		 *
		 * @default 0
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * The minimum space, in pixels, to the right of the items.
		 *
		 * @default 0
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * The minimum space, in pixels, below the items, if they
		 * do not repeat. If items repeat, <code>paddingBottom</code> will
		 * only be used if <code>verticalAlign</code> is set to
		 * <code>VerticalAlign.BOTTOM</code>. In this case, the first item,
		 * starting from the bottom, will be offset by the value of
		 * <code>paddingBottom</code>.
		 *
		 * @default 0
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * The minimum space, in pixels, to the left of the items.
		 *
		 * @default 0
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.JUSTIFY;

		[Inspectable(type="String",enumeration="left,center,right,justify")]
		/**
		 * The alignment of the items horizontally, on the x-axis.
		 *
		 * @default feathers.layout.HorizontalAlign.JUSTIFY
		 *
		 * @see feathers.layout.HorizontalAlign#LEFT
		 * @see feathers.layout.HorizontalAlign#CENTER
		 * @see feathers.layout.HorizontalAlign#RIGHT
		 * @see feathers.layout.HorizontalAlign#JUSTIFY
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this._horizontalAlign == value)
			{
				return;
			}
			this._horizontalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _verticalAlign:String = VerticalAlign.MIDDLE;

		[Inspectable(type="String",enumeration="top,middle,bottom")]
		/**
		 * The alignment of the items vertically, on the y-axis.
		 *
		 * <p><strong>Note:</strong> The <code>VerticalAlign.JUSTIFY</code>
		 * constant is not supported.</p>
		 *
		 * @default feathers.layout.VerticalAlign.MIDDLE
		 *
		 * @see feathers.layout.VerticalAlign#TOP
		 * @see feathers.layout.VerticalAlign#MIDDLE
		 * @see feathers.layout.VerticalAlign#BOTTOM
		 */
		public function get verticalAlign():String
		{
			return this._verticalAlign;
		}

		/**
		 * @private
		 */
		public function set verticalAlign(value:String):void
		{
			if(this._verticalAlign == value)
			{
				return;
			}
			this._verticalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _useVirtualLayout:Boolean = true;

		/**
		 * @inheritDoc
		 *
		 * @default true
		 */
		public function get useVirtualLayout():Boolean
		{
			return this._useVirtualLayout;
		}

		/**
		 * @private
		 */
		public function set useVirtualLayout(value:Boolean):void
		{
			if(this._useVirtualLayout == value)
			{
				return;
			}
			this._useVirtualLayout = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _requestedRowCount:int = 0;

		/**
		 * Requests that the layout set the view port dimensions to display a
		 * specific number of rows (plus gaps and padding), if possible. If the
		 * explicit height of the view port is set, then this value will be
		 * ignored. If the view port's minimum and/or maximum height are set,
		 * the actual number of visible rows may be adjusted to meet those
		 * requirements. Set this value to <code>0</code> to display as many
		 * rows as possible.
		 *
		 * @default 0
		 */
		public function get requestedRowCount():int
		{
			return this._requestedRowCount;
		}

		/**
		 * @private
		 */
		public function set requestedRowCount(value:int):void
		{
			if(value < 0)
			{
				throw RangeError("requestedRowCount requires a value >= 0");
			}
			if(this._requestedRowCount == value)
			{
				return;
			}
			this._requestedRowCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _beforeVirtualizedItemCount:int = 0;

		/**
		 * @inheritDoc
		 */
		public function get beforeVirtualizedItemCount():int
		{
			return this._beforeVirtualizedItemCount;
		}

		/**
		 * @private
		 */
		public function set beforeVirtualizedItemCount(value:int):void
		{
			if(this._beforeVirtualizedItemCount == value)
			{
				return;
			}
			this._beforeVirtualizedItemCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _afterVirtualizedItemCount:int = 0;

		/**
		 * @inheritDoc
		 */
		public function get afterVirtualizedItemCount():int
		{
			return this._afterVirtualizedItemCount;
		}

		/**
		 * @private
		 */
		public function set afterVirtualizedItemCount(value:int):void
		{
			if(this._afterVirtualizedItemCount == value)
			{
				return;
			}
			this._afterVirtualizedItemCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _typicalItem:DisplayObject;

		/**
		 * @inheritDoc
		 *
		 * @see #resetTypicalItemDimensionsOnMeasure
		 * @see #typicalItemWidth
		 * @see #typicalItemHeight
		 */
		public function get typicalItem():DisplayObject
		{
			return this._typicalItem;
		}

		/**
		 * @private
		 */
		public function set typicalItem(value:DisplayObject):void
		{
			if(this._typicalItem == value)
			{
				return;
			}
			this._typicalItem = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _resetTypicalItemDimensionsOnMeasure:Boolean = false;

		/**
		 * If set to <code>true</code>, the width and height of the
		 * <code>typicalItem</code> will be reset to <code>typicalItemWidth</code>
		 * and <code>typicalItemHeight</code>, respectively, whenever the
		 * typical item needs to be measured. The measured dimensions of the
		 * typical item are used to fill in the blanks of a virtualized layout
		 * for virtual items that don't have their own display objects to
		 * measure yet.
		 *
		 * @default false
		 *
		 * @see #typicalItemWidth
		 * @see #typicalItemHeight
		 * @see #typicalItem
		 */
		public function get resetTypicalItemDimensionsOnMeasure():Boolean
		{
			return this._resetTypicalItemDimensionsOnMeasure;
		}

		/**
		 * @private
		 */
		public function set resetTypicalItemDimensionsOnMeasure(value:Boolean):void
		{
			if(this._resetTypicalItemDimensionsOnMeasure == value)
			{
				return;
			}
			this._resetTypicalItemDimensionsOnMeasure = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _typicalItemWidth:Number = NaN;

		/**
		 * Used to reset the width, in pixels, of the <code>typicalItem</code>
		 * for measurement. The measured dimensions of the typical item are used
		 * to fill in the blanks of a virtualized layout for virtual items that
		 * don't have their own display objects to measure yet.
		 *
		 * <p>This value is only used when <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>true</code>. If <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>false</code>, this value will be ignored and the
		 * <code>typicalItem</code> dimensions will not be reset before
		 * measurement.</p>
		 *
		 * <p>If <code>typicalItemWidth</code> is set to <code>NaN</code>, the
		 * typical item will auto-size itself to its preferred width. If you
		 * pass a valid <code>Number</code> value, the typical item's width will
		 * be set to a fixed size. May be used in combination with
		 * <code>typicalItemHeight</code>.</p>
		 *
		 * @default NaN
		 *
		 * @see #resetTypicalItemDimensionsOnMeasure
		 * @see #typicalItemHeight
		 * @see #typicalItem
		 */
		public function get typicalItemWidth():Number
		{
			return this._typicalItemWidth;
		}

		/**
		 * @private
		 */
		public function set typicalItemWidth(value:Number):void
		{
			if(this._typicalItemWidth == value)
			{
				return;
			}
			this._typicalItemWidth = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _typicalItemHeight:Number = NaN;

		/**
		 * Used to reset the height, in pixels, of the <code>typicalItem</code>
		 * for measurement. The measured dimensions of the typical item are used
		 * to fill in the blanks of a virtualized layout for virtual items that
		 * don't have their own display objects to measure yet.
		 *
		 * <p>This value is only used when <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>true</code>. If <code>resetTypicalItemDimensionsOnMeasure</code>
		 * is set to <code>false</code>, this value will be ignored and the
		 * <code>typicalItem</code> dimensions will not be reset before
		 * measurement.</p>
		 *
		 * <p>If <code>typicalItemHeight</code> is set to <code>NaN</code>, the
		 * typical item will auto-size itself to its preferred height. If you
		 * pass a valid <code>Number</code> value, the typical item's height will
		 * be set to a fixed size. May be used in combination with
		 * <code>typicalItemWidth</code>.</p>
		 *
		 * @default NaN
		 *
		 * @see #resetTypicalItemDimensionsOnMeasure
		 * @see #typicalItemWidth
		 * @see #typicalItem
		 */
		public function get typicalItemHeight():Number
		{
			return this._typicalItemHeight;
		}

		/**
		 * @private
		 */
		public function set typicalItemHeight(value:Number):void
		{
			if(this._typicalItemHeight == value)
			{
				return;
			}
			this._typicalItemHeight = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _repeatItems:Boolean = true;

		/**
		 * If set to <code>true</code>, the layout will repeat the items
		 * infinitely, if there are enough items to allow this behavior. If the
		 * total height of the items is smaller than the height of the view
		 * port, the items cannot repeat.
		 *
		 * @default true
		 */
		public function get repeatItems():Boolean
		{
			return this._repeatItems;
		}

		/**
		 * @private
		 */
		public function set repeatItems(value:Boolean):void
		{
			if(this._repeatItems == value)
			{
				return;
			}
			this._repeatItems = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @copy feathers.layout.ISpinnerLayout#snapInterval
		 */
		public function get snapInterval():Number
		{
			if(this._typicalItem === null)
			{
				return 0;
			}
			return this._typicalItem.height + this._gap;
		}

		/**
		 * @inheritDoc
		 */
		public function get requiresLayoutOnScroll():Boolean
		{
			return true;
		}

		/**
		 * @private
		 */
		protected var _selectionBounds:Rectangle = new Rectangle();

		/**
		 * @inheritDoc
		 */
		public function get selectionBounds():Rectangle
		{
			return this._selectionBounds;
		}

		/**
		 * @inheritDoc
		 */
		public function layout(items:Vector.<DisplayObject>, viewPortBounds:ViewPortBounds = null, result:LayoutBoundsResult = null):LayoutBoundsResult
		{
			//this function is very long because it may be called every frame,
			//in some situations. testing revealed that splitting this function
			//into separate, smaller functions affected performance.
			//since the SWC compiler cannot inline functions, we can't use that
			//feature either.

			//since viewPortBounds can be null, we may need to provide some defaults
			var scrollX:Number = viewPortBounds ? viewPortBounds.scrollX : 0;
			var scrollY:Number = viewPortBounds ? viewPortBounds.scrollY : 0;
			var boundsX:Number = viewPortBounds ? viewPortBounds.x : 0;
			var boundsY:Number = viewPortBounds ? viewPortBounds.y : 0;
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;
			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;

			if(this._useVirtualLayout)
			{
				//if the layout is virtualized, we'll need the dimensions of the
				//typical item so that we have fallback values when an item is null
				this.prepareTypicalItem(explicitWidth - this._paddingLeft - this._paddingRight);
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			if(!this._useVirtualLayout || this._horizontalAlign != HorizontalAlign.JUSTIFY ||
				explicitWidth !== explicitWidth) //isNaN
			{
				//in some cases, we may need to validate all of the items so
				//that we can use their dimensions below.
				this.validateItems(items, explicitWidth - this._paddingLeft - this._paddingRight, explicitHeight);
			}

			//this section prepares some variables needed for the following loop
			var maxItemWidth:Number = this._useVirtualLayout ? calculatedTypicalItemWidth : 0;
			var positionY:Number = boundsY;
			var gap:Number = this._gap;
			var itemCount:int = items.length;
			var totalItemCount:int = itemCount;
			if(this._useVirtualLayout)
			{
				//if the layout is virtualized, and the items all have the same
				//height, we can make our loops smaller by skipping some items
				//at the beginning and end. this improves performance.

				if(this._beforeVirtualizedItemCount > 0)
				{
					//this value may be negative, which means that we're
					//repeating items. we don't want to include this value in
					//the total count, but we'll use it elsewhere.
					totalItemCount += this._beforeVirtualizedItemCount;
				}
				totalItemCount += this._afterVirtualizedItemCount;
				positionY += (this._beforeVirtualizedItemCount * (calculatedTypicalItemHeight + gap));
			}
			//this cache is used to save non-null items in virtual layouts. by
			//using a smaller array, we can improve performance by spending less
			//time in the upcoming loops.
			this._discoveredItemsCache.length = 0;
			var discoveredItemsCacheLastIndex:int = 0;

			//this first loop sets the y position of items, and it calculates
			//the total height of all items
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				if(item)
				{
					//we get here if the item isn't null. it is never null if
					//the layout isn't virtualized.
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					item.y = item.pivotY + positionY;
					item.height = calculatedTypicalItemHeight;
					var itemWidth:Number = item.width;
					//we compare with > instead of Math.max() because the rest
					//arguments on Math.max() cause extra garbage collection and
					//hurt performance
					if(itemWidth > maxItemWidth)
					{
						//we need to know the maximum width of the items in the
						//case where the width of the view port needs to be
						//calculated by the layout.
						maxItemWidth = itemWidth;
					}
					if(this._useVirtualLayout)
					{
						this._discoveredItemsCache[discoveredItemsCacheLastIndex] = item;
						discoveredItemsCacheLastIndex++;
					}
				}
				positionY += calculatedTypicalItemHeight + gap;
			}
			if(this._useVirtualLayout)
			{
				//finish the final calculation of the y position so that it can
				//be used for the total height of all items
				positionY += (this._afterVirtualizedItemCount * (calculatedTypicalItemHeight + gap));
			}

			//this array will contain all items that are not null. see the
			//comment above where the discoveredItemsCache is initialized for
			//details about why this is important.
			var discoveredItems:Vector.<DisplayObject> = this._useVirtualLayout ? this._discoveredItemsCache : items;
			var discoveredItemCount:int = discoveredItems.length;

			var totalWidth:Number = maxItemWidth + this._paddingLeft + this._paddingRight;
			//the available width is the width of the viewport. if the explicit
			//width is NaN, we need to calculate the viewport width ourselves
			//based on the total width of all items.
			var availableWidth:Number = explicitWidth;
			if(availableWidth !== availableWidth) //isNaN
			{
				availableWidth = totalWidth;
				if(availableWidth < minWidth)
				{
					availableWidth = minWidth;
				}
				else if(availableWidth > maxWidth)
				{
					availableWidth = maxWidth;
				}
			}

			//this is the total height of all items
			var totalHeight:Number = positionY - gap - boundsY;
			if(this._useVirtualLayout && this._beforeVirtualizedItemCount < 0)
			{
				totalHeight -= (this._beforeVirtualizedItemCount * (calculatedTypicalItemHeight + gap));
			}
			//the available height is the height of the viewport. if the explicit
			//height is NaN, we need to calculate the viewport height ourselves
			//based on the total height of all items.
			var availableHeight:Number = explicitHeight;
			if(availableHeight !== availableHeight) //isNaN
			{
				if(this._requestedRowCount > 0)
				{
					availableHeight = this._requestedRowCount * (calculatedTypicalItemHeight + gap) - gap;
				}
				else
				{
					availableHeight = totalHeight;
				}
				if(availableHeight < minHeight)
				{
					availableHeight = minHeight;
				}
				else if(availableHeight > maxHeight)
				{
					availableHeight = maxHeight;
				}
			}

			//we add one extra here because the first item renderer in view may
			//be partially obscured, which would reveal an extra item renderer.
			var maxVisibleTypicalItemCount:int = Math.ceil(availableHeight / (calculatedTypicalItemHeight + gap)) + 1;
			var minTotalHeightForRepeat:Number = maxVisibleTypicalItemCount * (calculatedTypicalItemHeight + gap) - gap;
			var canRepeatItems:Boolean = this._repeatItems && totalHeight >= minTotalHeightForRepeat;
			if(canRepeatItems)
			{
				totalHeight += gap;
			}

			//in this section, we handle vertical alignment
			var verticalAlignOffsetY:Number = this._paddingTop;
			if(this._verticalAlign === VerticalAlign.BOTTOM)
			{
				verticalAlignOffsetY = availableHeight - this._paddingBottom - calculatedTypicalItemHeight;
			}
			else if(this._verticalAlign === VerticalAlign.MIDDLE)
			{
				verticalAlignOffsetY = this._paddingTop + Math.round((availableHeight - this._paddingTop - this._paddingBottom - calculatedTypicalItemHeight) / 2);
			}
			if(!canRepeatItems)
			{
				totalHeight += verticalAlignOffsetY + (availableHeight - calculatedTypicalItemHeight - verticalAlignOffsetY);
			}
			if(verticalAlignOffsetY != 0)
			{
				for(i = 0; i < discoveredItemCount; i++)
				{
					item = discoveredItems[i];
					if(item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout)
					{
						continue;
					}
					item.y += verticalAlignOffsetY;
				}
			}

			for(i = 0; i < discoveredItemCount; i++)
			{
				item = discoveredItems[i];
				var layoutItem:ILayoutDisplayObject = item as ILayoutDisplayObject;
				if(layoutItem && !layoutItem.includeInLayout)
				{
					continue;
				}

				//if we're repeating items, then we may need to adjust the y
				//position of some items so that they appear inside the viewport
				if(canRepeatItems)
				{
					var adjustedScrollY:Number = scrollY - verticalAlignOffsetY;
					if(adjustedScrollY > 0)
					{
						var multiplier:int = int((adjustedScrollY + availableHeight) / totalHeight);
						if(useVirtualLayout && this._beforeVirtualizedItemCount < 0)
						{
							multiplier++;
						}
						item.y += totalHeight * multiplier;
						if(item.y >= (scrollY + availableHeight))
						{
							item.y -= totalHeight;
						}
					}
					else if(adjustedScrollY < 0)
					{
						item.y += totalHeight * (int(adjustedScrollY / totalHeight) - 1);
						if((item.y + item.height) < scrollY)
						{
							item.y += totalHeight;
						}
					}
				}

				//in this section, we handle horizontal alignment
				if(this._horizontalAlign == HorizontalAlign.JUSTIFY)
				{
					//if we justify items horizontally, we can skip percent width
					item.x = item.pivotX + boundsX + this._paddingLeft;
					item.width = availableWidth - this._paddingLeft - this._paddingRight;
				}
				else
				{
					//handle all other horizontal alignment values (we handled
					//justify already). the x position of all items is set.
					var horizontalAlignWidth:Number = availableWidth;
					if(totalWidth > horizontalAlignWidth)
					{
						horizontalAlignWidth = totalWidth;
					}
					switch(this._horizontalAlign)
					{
						case HorizontalAlign.RIGHT:
						{
							item.x = item.pivotX + boundsX + horizontalAlignWidth - this._paddingRight - item.width;
							break;
						}
						case HorizontalAlign.CENTER:
						{
							//round to the nearest pixel when dividing by 2 to
							//align in the center
							item.x = item.pivotX + boundsX + this._paddingLeft + Math.round((horizontalAlignWidth - this._paddingLeft - this._paddingRight - item.width) / 2);
							break;
						}
						default: //left
						{
							item.x = item.pivotX + boundsX + this._paddingLeft;
						}
					}
				}
			}
			//we don't want to keep a reference to any of the items, so clear
			//this cache
			this._discoveredItemsCache.length = 0;

			//calculate the bounds of the selection rectangle
			this._selectionBounds.x = 0;
			this._selectionBounds.y = verticalAlignOffsetY;
			this._selectionBounds.width = availableWidth;
			this._selectionBounds.height = calculatedTypicalItemHeight;

			//finally, we want to calculate the result so that the container
			//can use it to adjust its viewport and determine the minimum and
			//maximum scroll positions (if needed)
			if(!result)
			{
				result = new LayoutBoundsResult();
			}
			result.contentX = 0;
			result.contentWidth = this._horizontalAlign == HorizontalAlign.JUSTIFY ? availableWidth : totalWidth;
			if(canRepeatItems)
			{
				result.contentY = Number.NEGATIVE_INFINITY;
				result.contentHeight = Number.POSITIVE_INFINITY;
			}
			else
			{
				result.contentY = 0;
				result.contentHeight = totalHeight;
			}
			result.viewPortWidth = availableWidth;
			result.viewPortHeight = availableHeight;
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function measureViewPort(itemCount:int, viewPortBounds:ViewPortBounds = null, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("measureViewPort() may be called only if useVirtualLayout is true.");
			}

			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;
			var needsWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			var needsHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			if(!needsWidth && !needsHeight)
			{
				result.x = explicitWidth;
				result.y = explicitHeight;
				return result;
			}
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;

			this.prepareTypicalItem(explicitWidth - this._paddingLeft - this._paddingRight);
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var gap:Number = this._gap;
			var positionY:Number = 0;

			var maxItemWidth:Number = calculatedTypicalItemWidth;
			positionY += ((calculatedTypicalItemHeight + gap) * itemCount);
			positionY -= gap;

			if(needsWidth)
			{
				var resultWidth:Number = maxItemWidth + this._paddingLeft + this._paddingRight;
				if(resultWidth < minWidth)
				{
					resultWidth = minWidth;
				}
				else if(resultWidth > maxWidth)
				{
					resultWidth = maxWidth;
				}
				result.x = resultWidth;
			}
			else
			{
				result.x = explicitWidth;
			}

			if(needsHeight)
			{
				if(this._requestedRowCount > 0)
				{
					var resultHeight:Number = (calculatedTypicalItemHeight + gap) * this._requestedRowCount - gap;
				}
				else
				{
					resultHeight = positionY;
				}
				if(resultHeight < minHeight)
				{
					resultHeight = minHeight;
				}
				else if(resultHeight > maxHeight)
				{
					resultHeight = maxHeight;
				}
				result.y = resultHeight;
			}
			else
			{
				result.y = explicitHeight;
			}

			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getVisibleIndicesAtScrollPosition(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int> = null):Vector.<int>
		{
			if(result)
			{
				result.length = 0;
			}
			else
			{
				result = new <int>[];
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("getVisibleIndicesAtScrollPosition() may be called only if useVirtualLayout is true.");
			}

			this.prepareTypicalItem(width - this._paddingLeft - this._paddingRight);
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			var gap:Number = this._gap;

			var resultLastIndex:int = 0;

			var totalItemHeight:Number = itemCount * (calculatedTypicalItemHeight + gap) - gap;

			//the actual code that figures out which items are visible assumes
			//that alignment is top. to make it work with other alignments, we
			//can simply adjust the scroll position!
			if(this._verticalAlign === VerticalAlign.MIDDLE)
			{
				scrollY -= Math.round(this._paddingTop + (height - calculatedTypicalItemHeight) / 2);
			}
			else if(this._verticalAlign === VerticalAlign.BOTTOM)
			{
				scrollY -= (height - calculatedTypicalItemHeight - this._paddingBottom);
			}
			else //top
			{
				scrollY -= this._paddingTop;
			}

			//we add one extra here because the first item renderer in view may
			//be partially obscured, which would reveal an extra item renderer.
			var maxVisibleTypicalItemCount:int = Math.ceil(height / (calculatedTypicalItemHeight + gap)) + 1;
			var minTotalHeightForRepeat:Number = maxVisibleTypicalItemCount * (calculatedTypicalItemHeight + gap) - gap;
			var canRepeatItems:Boolean = this._repeatItems && totalItemHeight >= minTotalHeightForRepeat;
			if(canRepeatItems)
			{
				//if we're repeating, then there's an extra gap
				totalItemHeight += gap;
				scrollY %= totalItemHeight;
				if(scrollY < 0)
				{
					scrollY += totalItemHeight;
				}
				var minimum:int = scrollY / (calculatedTypicalItemHeight + gap);
				var maximum:int = minimum + maxVisibleTypicalItemCount;
			}
			else
			{
				minimum = scrollY / (calculatedTypicalItemHeight + gap);
				if(minimum < 0)
				{
					minimum = 0;
				}
				//if we're scrolling beyond the final item, we should keep the
				//indices consistent so that items aren't destroyed and
				//recreated unnecessarily
				maximum = minimum + maxVisibleTypicalItemCount;
				if(maximum >= itemCount)
				{
					maximum = itemCount - 1;
				}
				minimum = maximum - maxVisibleTypicalItemCount;
				if(minimum < 0)
				{
					minimum = 0;
				}
			}
			for(var i:int = minimum; i <= maximum; i++)
			{
				if(!canRepeatItems || (i >= 0 && i < itemCount))
				{
					result[resultLastIndex] = i;
				}
				else if(i < 0)
				{
					result[resultLastIndex] = itemCount + i;
				}
				else if(i >= itemCount)
				{
					var loopedI:int = i - itemCount;
					if(loopedI == minimum)
					{
						//we don't want to repeat items!
						break;
					}
					result[resultLastIndex] = loopedI;
				}
				resultLastIndex++;
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function calculateNavigationDestination(items:Vector.<DisplayObject>, index:int, keyCode:uint, bounds:LayoutBoundsResult):int
		{
			var itemArrayCount:int = items.length;
			var itemCount:int = itemArrayCount + this._afterVirtualizedItemCount;
			if(this._beforeVirtualizedItemCount > 0)
			{
				itemCount += this._beforeVirtualizedItemCount;
			}
			var result:int = index;
			if(keyCode == Keyboard.HOME)
			{
				if(itemCount > 0)
				{
					result = 0;
				}
			}
			else if(keyCode == Keyboard.END)
			{
				result = itemCount - 1;
			}
			else if(keyCode == Keyboard.PAGE_UP)
			{
				var yPosition:Number = 0;
				for(var i:int = index; i >= 0; i--)
				{
					yPosition += this.snapInterval;
					if(yPosition > bounds.viewPortHeight)
					{
						break;
					}
					yPosition += this._gap;
					result = i;
				}
			}
			else if(keyCode == Keyboard.PAGE_DOWN)
			{
				yPosition = 0;
				for(i = index; i < itemCount; i++)
				{
					yPosition += this.snapInterval;
					if(yPosition > bounds.viewPortHeight)
					{
						break;
					}
					yPosition += this._gap;
					result = i;
				}
			}
			else if(keyCode == Keyboard.UP)
			{
				result--;
			}
			else if(keyCode == Keyboard.DOWN)
			{
				result++;
			}
			var canRepeatItems:Boolean = this._repeatItems && bounds.contentHeight == Number.POSITIVE_INFINITY;
			if(canRepeatItems)
			{
				while(result < 0)
				{
					result += itemCount;
				}
				while(result >= itemCount)
				{
					result -= itemCount;
				}
			}
			else if(result < 0)
			{
				return 0;
			}
			if(result >= itemCount)
			{
				return itemCount - 1;
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getNearestScrollPositionForIndex(index:int, scrollX:Number, scrollY:Number, items:Vector.<DisplayObject>,
			x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			//normally, this isn't acceptable, but because the selection is
			//based on the scroll position, it must work this way.
			return this.getScrollPositionForIndex(index, items, x, y, width, height, result);
		}

		/**
		 * @inheritDoc
		 */
		public function getScrollPositionForIndex(index:int, items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			this.prepareTypicalItem(width - this._paddingLeft - this._paddingRight);
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			if(!result)
			{
				result = new Point();
			}
			result.x = 0;
			result.y = calculatedTypicalItemHeight * index;

			return result;
		}

		/**
		 * @private
		 */
		protected function validateItems(items:Vector.<DisplayObject>, justifyWidth:Number, distributedHeight:Number):void
		{
			//if the alignment is justified, then we want to set the width of
			//each item before validating because setting one dimension may
			//cause the other dimension to change, and that will invalidate the
			//layout if it happens after validation, causing more invalidation
			var isJustified:Boolean = this._horizontalAlign == HorizontalAlign.JUSTIFY;
			var mustSetJustifyWidth:Boolean = isJustified && justifyWidth === justifyWidth; //!isNaN
			var itemCount:int = items.length;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:DisplayObject = items[i];
				if(!item || (item is ILayoutDisplayObject && !ILayoutDisplayObject(item).includeInLayout))
				{
					continue;
				}
				if(mustSetJustifyWidth)
				{
					item.width = justifyWidth;
				}
				else if(isJustified && item is IFeathersControl)
				{
					//the alignment is justified, but we don't yet have a width
					//to use, so we need to ensure that we accurately measure
					//the items instead of using an old justified width that may
					//be wrong now!
					item.width = NaN;
				}
				if(item is IValidating)
				{
					IValidating(item).validate();
				}
			}
		}

		/**
		 * @private
		 */
		protected function prepareTypicalItem(justifyWidth:Number):void
		{
			if(!this._typicalItem)
			{
				return;
			}
			if(this._horizontalAlign == HorizontalAlign.JUSTIFY &&
				justifyWidth === justifyWidth) //!isNaN
			{
				this._typicalItem.width = justifyWidth;
			}
			else if(this._resetTypicalItemDimensionsOnMeasure)
			{
				this._typicalItem.width = this._typicalItemWidth;
			}
			if(this._resetTypicalItemDimensionsOnMeasure)
			{
				this._typicalItem.height = this._typicalItemHeight;
			}
			if(this._typicalItem is IValidating)
			{
				IValidating(this._typicalItem).validate();
			}
		}
	}
}


================================================
FILE: source/feathers/layout/ViewPortBounds.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	/**
	 * Used by layout algorithms for determining the bounds in which to position
	 * and size items.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class ViewPortBounds
	{
		/**
		 * Constructor.
		 */
		public function ViewPortBounds()
		{

		}

		/**
		 * The x position of the view port, in pixels.
		 */
		public var x:Number = 0;

		/**
		 * The y position of the view port, in pixels.
		 */
		public var y:Number = 0;

		/**
		 * The horizontal scroll position of the view port, in pixels.
		 */
		public var scrollX:Number = 0;

		/**
		 * The vertical scroll position of the view port, in pixels.
		 */
		public var scrollY:Number = 0;

		/**
		 * The explicit width of the view port, in pixels. If <code>NaN</code>,
		 * there is no explicit width value.
		 */
		public var explicitWidth:Number = NaN;

		/**
		 * The explicit height of the view port, in pixels. If <code>NaN</code>,
		 * there is no explicit height value.
		 */
		public var explicitHeight:Number = NaN;

		/**
		 * The minimum width of the view port, in pixels. Should be 0 or
		 * a positive number less than infinity.
		 */
		public var minWidth:Number = 0;

		/**
		 * The minimum width of the view port, in pixels. Should be 0 or
		 * a positive number less than infinity.
		 */
		public var minHeight:Number = 0;

		/**
		 * The maximum width of the view port, in pixels. Should be 0 or
		 * a positive number, including infinity.
		 */
		public var maxWidth:Number = Number.POSITIVE_INFINITY;

		/**
		 * The maximum height of the view port, in pixels. Should be 0 or
		 * a positive number, including infinity.
		 */
		public var maxHeight:Number = Number.POSITIVE_INFINITY;
	}
}


================================================
FILE: source/feathers/layout/WaterfallLayout.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.layout
{
	import feathers.core.IValidating;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;
	import flash.ui.Keyboard;

	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * Dispatched when a property of the layout changes, indicating that a
	 * redraw is probably needed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * A layout with multiple columns of equal width where items may have
	 * variable heights. Items are added to the layout in order, but they may be
	 * added to any of the available columns. The layout selects the column
	 * where the column's height plus the item's height will result in the
	 * smallest possible total height.
	 *
	 * @see ../../../help/waterfall-layout.html How to use WaterfallLayout with Feathers containers
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class WaterfallLayout extends BaseVariableVirtualLayout implements IVariableVirtualLayout
	{
		/**
		 * Constructor.
		 */
		public function WaterfallLayout()
		{
			super();
			this._hasVariableItemDimensions = true;
		}

		/**
		 * Quickly sets both <code>horizontalGap</code> and <code>verticalGap</code>
		 * to the same value. The <code>gap</code> getter always returns the
		 * value of <code>horizontalGap</code>, but the value of
		 * <code>verticalGap</code> may be different.
		 *
		 * @default 0
		 *
		 * @see #horizontalGap
		 * @see #verticalGap
		 */
		public function get gap():Number
		{
			return this._horizontalGap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			this.horizontalGap = value;
			this.verticalGap = value;
		}

		/**
		 * @private
		 */
		protected var _horizontalGap:Number = 0;

		/**
		 * The horizontal space, in pixels, between columns.
		 *
		 * @default 0
		 */
		public function get horizontalGap():Number
		{
			return this._horizontalGap;
		}

		/**
		 * @private
		 */
		public function set horizontalGap(value:Number):void
		{
			if(this._horizontalGap == value)
			{
				return;
			}
			this._horizontalGap = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _verticalGap:Number = 0;

		/**
		 * The vertical space, in pixels, between items in a column.
		 *
		 * @default 0
		 */
		public function get verticalGap():Number
		{
			return this._verticalGap;
		}

		/**
		 * @private
		 */
		public function set verticalGap(value:Number):void
		{
			if(this._verticalGap == value)
			{
				return;
			}
			this._verticalGap = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * Quickly sets all padding properties to the same value. The
		 * <code>padding</code> getter always returns the value of
		 * <code>paddingTop</code>, but the other padding values may be
		 * different.
		 *
		 * @default 0
		 *
		 * @see #paddingTop
		 * @see #paddingRight
		 * @see #paddingBottom
		 * @see #paddingLeft
		 */
		public function get padding():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set padding(value:Number):void
		{
			this.paddingTop = value;
			this.paddingRight = value;
			this.paddingBottom = value;
			this.paddingLeft = value;
		}

		/**
		 * @private
		 */
		protected var _paddingTop:Number = 0;

		/**
		 * The space, in pixels, that appears on top, above the items.
		 *
		 * @default 0
		 */
		public function get paddingTop():Number
		{
			return this._paddingTop;
		}

		/**
		 * @private
		 */
		public function set paddingTop(value:Number):void
		{
			if(this._paddingTop == value)
			{
				return;
			}
			this._paddingTop = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingRight:Number = 0;

		/**
		 * The minimum space, in pixels, to the right of the items.
		 *
		 * @default 0
		 */
		public function get paddingRight():Number
		{
			return this._paddingRight;
		}

		/**
		 * @private
		 */
		public function set paddingRight(value:Number):void
		{
			if(this._paddingRight == value)
			{
				return;
			}
			this._paddingRight = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingBottom:Number = 0;

		/**
		 * The space, in pixels, that appears on the bottom, below the items.
		 *
		 * @default 0
		 */
		public function get paddingBottom():Number
		{
			return this._paddingBottom;
		}

		/**
		 * @private
		 */
		public function set paddingBottom(value:Number):void
		{
			if(this._paddingBottom == value)
			{
				return;
			}
			this._paddingBottom = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _paddingLeft:Number = 0;

		/**
		 * The minimum space, in pixels, to the left of the items.
		 *
		 * @default 0
		 */
		public function get paddingLeft():Number
		{
			return this._paddingLeft;
		}

		/**
		 * @private
		 */
		public function set paddingLeft(value:Number):void
		{
			if(this._paddingLeft == value)
			{
				return;
			}
			this._paddingLeft = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _horizontalAlign:String = HorizontalAlign.CENTER;

		[Inspectable(type="String",enumeration="left,center,right")]
		/**
		 * The alignment of the items horizontally, on the x-axis.
		 *
		 * <p><strong>Note:</strong> The <code>HorizontalAlign.JUSTIFY</code>
		 * constant is not supported.</p>
		 *
		 * @default feathers.layout.HorizontalAlign.CENTER
		 *
		 * @see feathers.layout.HorizontalAlign#LEFT
		 * @see feathers.layout.HorizontalAlign#CENTER
		 * @see feathers.layout.HorizontalAlign#RIGHT
		 */
		public function get horizontalAlign():String
		{
			return this._horizontalAlign;
		}

		/**
		 * @private
		 */
		public function set horizontalAlign(value:String):void
		{
			if(this._horizontalAlign == value)
			{
				return;
			}
			this._horizontalAlign = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _requestedColumnCount:int = 0;

		/**
		 * Requests that the layout uses a specific number of columns, if
		 * possible. Set to <code>0</code> to calculate the maximum of columns
		 * that will fit in the available space.
		 *
		 * <p>If the view port's explicit or maximum width is not large enough
		 * to fit the requested number of columns, it will use fewer. If the
		 * view port doesn't have an explicit width and the maximum width is
		 * equal to <code>Number.POSITIVE_INFINITY</code>, the width will be
		 * calculated automatically to fit the exact number of requested
		 * columns.</p>
		 *
		 * @default 0
		 */
		public function get requestedColumnCount():int
		{
			return this._requestedColumnCount;
		}

		/**
		 * @private
		 */
		public function set requestedColumnCount(value:int):void
		{
			if(value < 0)
			{
				throw RangeError("requestedColumnCount requires a value >= 0");
			}
			if(this._requestedColumnCount == value)
			{
				return;
			}
			this._requestedColumnCount = value;
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _heightCache:Array = [];

		/**
		 * @inheritDoc
		 */
		public function layout(items:Vector.<DisplayObject>, viewPortBounds:ViewPortBounds = null, result:LayoutBoundsResult = null):LayoutBoundsResult
		{
			var boundsX:Number = viewPortBounds ? viewPortBounds.x : 0;
			var boundsY:Number = viewPortBounds ? viewPortBounds.y : 0;
			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;
			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;

			var needsWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			var needsHeight:Boolean = explicitHeight !== explicitHeight; //isNaN

			if(this._useVirtualLayout)
			{
				//if the layout is virtualized, we'll need the dimensions of the
				//typical item so that we have fallback values when an item is null
				if(this._typicalItem is IValidating)
				{
					IValidating(this._typicalItem).validate();
				}
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var columnWidth:Number = 0;
			if(this._useVirtualLayout)
			{
				columnWidth = calculatedTypicalItemWidth;
			}
			else if(items.length > 0)
			{
				var item:DisplayObject = items[0];
				if(item is IValidating)
				{
					IValidating(item).validate();
				}
				columnWidth = item.width;
			}
			var availableWidth:Number = explicitWidth;
			if(needsWidth)
			{
				if(maxWidth < Number.POSITIVE_INFINITY)
				{
					availableWidth = maxWidth;
				}
				else if(this._requestedColumnCount > 0)
				{
					availableWidth = ((columnWidth + this._horizontalGap) * this._requestedColumnCount) - this._horizontalGap;
				}
				else
				{
					availableWidth = columnWidth;
				}
				availableWidth += this._paddingLeft + this._paddingRight;
				if(availableWidth < minWidth)
				{
					availableWidth = minWidth;
				}
				else if(availableWidth > maxWidth)
				{
					availableWidth = maxWidth;
				}
			}
			var columnCount:int = int((availableWidth + this._horizontalGap - this._paddingLeft - this._paddingRight) / (columnWidth + this._horizontalGap));
			if(this._requestedColumnCount > 0 && columnCount > this._requestedColumnCount)
			{
				columnCount = this._requestedColumnCount;
			}
			else if(columnCount < 1)
			{
				columnCount = 1;
			}
			var columnHeights:Vector.<Number> = new <Number>[];
			for(var i:int = 0; i < columnCount; i++)
			{
				columnHeights[i] = this._paddingTop;
			}
			columnHeights.fixed = true;

			var horizontalAlignOffset:Number = 0;
			if(this._horizontalAlign == HorizontalAlign.RIGHT)
			{
				horizontalAlignOffset = (availableWidth - this._paddingLeft - this._paddingRight) - ((columnCount * (columnWidth + this._horizontalGap)) - this._horizontalGap);
			}
			else if(this._horizontalAlign == HorizontalAlign.CENTER)
			{
				horizontalAlignOffset = Math.round(((availableWidth - this._paddingLeft - this._paddingRight) - ((columnCount * (columnWidth + this._horizontalGap)) - this._horizontalGap)) / 2);
			}

			var itemCount:int = items.length;
			var targetColumnIndex:int = 0;
			var targetColumnHeight:Number = columnHeights[targetColumnIndex];
			for(i = 0; i < itemCount; i++)
			{
				item = items[i];
				if(this._useVirtualLayout && this._hasVariableItemDimensions)
				{
					var cachedHeight:Number = this._heightCache[i];
				}
				if(this._useVirtualLayout && !item)
				{
					if(!this._hasVariableItemDimensions ||
						cachedHeight !== cachedHeight) //isNaN
					{
						//if all items must have the same height, we will
						//use the height of the typical item (calculatedTypicalItemHeight).

						//if items may have different heights, we first check
						//the cache for a height value. if there isn't one, then
						//we'll use calculatedTypicalItemHeight as a fallback.
						var itemHeight:Number = calculatedTypicalItemHeight;
					}
					else
					{
						itemHeight = cachedHeight;
					}
				}
				else
				{
					if(item is ILayoutDisplayObject)
					{
						var layoutItem:ILayoutDisplayObject = ILayoutDisplayObject(item);
						if(!layoutItem.includeInLayout)
						{
							continue;
						}
					}
					if(item is IValidating)
					{
						IValidating(item).validate();
					}
					//first, scale the items to fit into the column width
					var scaleFactor:Number = columnWidth / item.width;
					item.width *= scaleFactor;
					if(item is IValidating)
					{
						//if we changed the width, we need to recalculate the
						//height.
						IValidating(item).validate();
					}
					if(this._useVirtualLayout)
					{
						if(this._hasVariableItemDimensions)
						{
							itemHeight = item.height;
							if(itemHeight != cachedHeight)
							{
								//update the cache if needed. this will notify
								//the container that the virtualized layout has
								//changed, and it the view port may need to be
								//re-measured.
								this._heightCache[i] = itemHeight;
								this.dispatchEventWith(Event.CHANGE);
							}
						}
						else
						{
							item.height = itemHeight = calculatedTypicalItemHeight;
						}
					}
					else
					{
						itemHeight = item.height;
					}
				}
				targetColumnHeight += itemHeight;
				for(var j:int = 0; j < columnCount; j++)
				{
					if(j == targetColumnIndex)
					{
						continue;
					}
					var columnHeight:Number = columnHeights[j] + itemHeight;
					if(columnHeight < targetColumnHeight)
					{
						targetColumnIndex = j;
						targetColumnHeight = columnHeight;
					}
				}
				if(item)
				{
					item.x = item.pivotX + boundsX + horizontalAlignOffset + this._paddingLeft + targetColumnIndex * (columnWidth + this._horizontalGap);
					item.y = item.pivotY + boundsY + targetColumnHeight - itemHeight;
				}
				targetColumnHeight += this._verticalGap;
				columnHeights[targetColumnIndex] = targetColumnHeight;
			}
			var totalHeight:Number = columnHeights[0];
			for(i = 1; i < columnCount; i++)
			{
				columnHeight = columnHeights[i];
				if(columnHeight > totalHeight)
				{
					totalHeight = columnHeight;
				}
			}
			totalHeight -= this._verticalGap;
			totalHeight += this._paddingBottom;
			if(totalHeight < 0)
			{
				totalHeight = 0;
			}

			var availableHeight:Number = explicitHeight;
			if(needsHeight)
			{
				availableHeight = totalHeight;
				if(availableHeight < minHeight)
				{
					availableHeight = minHeight;
				}
				else if(availableHeight > maxHeight)
				{
					availableHeight = maxHeight;
				}
			}

			//finally, we want to calculate the result so that the container
			//can use it to adjust its viewport and determine the minimum and
			//maximum scroll positions (if needed)
			if(!result)
			{
				result = new LayoutBoundsResult();
			}
			result.contentX = 0;
			result.contentWidth = availableWidth;
			result.contentY = 0;
			result.contentHeight = totalHeight;
			result.viewPortWidth = availableWidth;
			result.viewPortHeight = availableHeight;
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function measureViewPort(itemCount:int, viewPortBounds:ViewPortBounds = null, result:Point = null):Point
		{
			if(!result)
			{
				result = new Point();
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("measureViewPort() may be called only if useVirtualLayout is true.");
			}

			var explicitWidth:Number = viewPortBounds ? viewPortBounds.explicitWidth : NaN;
			var explicitHeight:Number = viewPortBounds ? viewPortBounds.explicitHeight : NaN;

			var needsWidth:Boolean = explicitWidth !== explicitWidth; //isNaN
			var needsHeight:Boolean = explicitHeight !== explicitHeight; //isNaN
			if(!needsWidth && !needsHeight)
			{
				result.x = explicitWidth;
				result.y = explicitHeight;
				return result;
			}

			var minWidth:Number = viewPortBounds ? viewPortBounds.minWidth : 0;
			var minHeight:Number = viewPortBounds ? viewPortBounds.minHeight : 0;
			var maxWidth:Number = viewPortBounds ? viewPortBounds.maxWidth : Number.POSITIVE_INFINITY;
			var maxHeight:Number = viewPortBounds ? viewPortBounds.maxHeight : Number.POSITIVE_INFINITY;

			if(this._typicalItem is IValidating)
			{
				IValidating(this._typicalItem).validate();
			}
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var columnWidth:Number = calculatedTypicalItemWidth;
			var availableWidth:Number = explicitWidth;
			if(needsWidth)
			{
				if(maxWidth < Number.POSITIVE_INFINITY)
				{
					availableWidth = maxWidth;
				}
				else if(this._requestedColumnCount > 0)
				{
					availableWidth = ((columnWidth + this._horizontalGap) * this._requestedColumnCount) - this._horizontalGap;
				}
				else
				{
					availableWidth = columnWidth;
				}
				availableWidth += this._paddingLeft + this._paddingRight;
				if(availableWidth < minWidth)
				{
					availableWidth = minWidth;
				}
				else if(availableWidth > maxWidth)
				{
					availableWidth = maxWidth;
				}
			}
			var columnCount:int = int((availableWidth + this._horizontalGap - this._paddingLeft - this._paddingRight) / (columnWidth + this._horizontalGap));
			if(this._requestedColumnCount > 0 && columnCount > this._requestedColumnCount)
			{
				columnCount = this._requestedColumnCount;
			}
			else if(columnCount < 1)
			{
				columnCount = 1;
			}

			if(needsWidth)
			{
				result.x = this._paddingLeft + this._paddingRight + (columnCount * (columnWidth + this._horizontalGap)) - this._horizontalGap;
			}
			else
			{
				result.x = explicitWidth;
			}

			if(needsHeight)
			{
				if(this._hasVariableItemDimensions)
				{
					var columnHeights:Vector.<Number> = new <Number>[];
					for(var i:int = 0; i < columnCount; i++)
					{
						columnHeights[i] = this._paddingTop;
					}
					columnHeights.fixed = true;

					var targetColumnIndex:int = 0;
					var targetColumnHeight:Number = columnHeights[targetColumnIndex];
					for(i = 0; i < itemCount; i++)
					{
						if(this._hasVariableItemDimensions)
						{
							var itemHeight:Number = this._heightCache[i];
							if(itemHeight !== itemHeight) //isNaN
							{
								itemHeight = calculatedTypicalItemHeight;
							}
						}
						else
						{
							itemHeight = calculatedTypicalItemHeight;
						}
						targetColumnHeight += itemHeight;
						for(var j:int = 0; j < columnCount; j++)
						{
							if(j == targetColumnIndex)
							{
								continue;
							}
							var columnHeight:Number = columnHeights[j] + itemHeight;
							if(columnHeight < targetColumnHeight)
							{
								targetColumnIndex = j;
								targetColumnHeight = columnHeight;
							}
						}
						targetColumnHeight += this._verticalGap;
						columnHeights[targetColumnIndex] = targetColumnHeight;
					}
					var totalHeight:Number = columnHeights[0];
					for(i = 1; i < columnCount; i++)
					{
						columnHeight = columnHeights[i];
						if(columnHeight > totalHeight)
						{
							totalHeight = columnHeight;
						}
					}
					totalHeight -= this._verticalGap;
					totalHeight += this._paddingBottom;
					if(totalHeight < 0)
					{
						totalHeight = 0;
					}
					if(totalHeight < minHeight)
					{
						totalHeight = minHeight;
					}
					else if(totalHeight > maxHeight)
					{
						totalHeight = maxHeight;
					}
					result.y = totalHeight;
				}
				else
				{
					result.y = this._paddingTop + this._paddingBottom + (Math.ceil(itemCount / columnCount) * (calculatedTypicalItemHeight + this._verticalGap)) - this._verticalGap;
				}
			}
			else
			{
				result.y = explicitHeight;
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getVisibleIndicesAtScrollPosition(scrollX:Number, scrollY:Number, width:Number, height:Number, itemCount:int, result:Vector.<int> = null):Vector.<int>
		{
			if(result)
			{
				result.length = 0;
			}
			else
			{
				result = new <int>[];
			}
			if(!this._useVirtualLayout)
			{
				throw new IllegalOperationError("getVisibleIndicesAtScrollPosition() may be called only if useVirtualLayout is true.");
			}

			if(this._typicalItem is IValidating)
			{
				IValidating(this._typicalItem).validate();
			}
			var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
			var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;

			var columnWidth:Number = calculatedTypicalItemWidth;
			var columnCount:int = int((width + this._horizontalGap - this._paddingLeft - this._paddingRight) / (columnWidth + this._horizontalGap));
			if(this._requestedColumnCount > 0 && columnCount > this._requestedColumnCount)
			{
				columnCount = this._requestedColumnCount;
			}
			else if(columnCount < 1)
			{
				columnCount = 1;
			}
			var resultLastIndex:int = 0;
			if(this._hasVariableItemDimensions)
			{
				var columnHeights:Vector.<Number> = new <Number>[];
				for(var i:int = 0; i < columnCount; i++)
				{
					columnHeights[i] = this._paddingTop;
				}
				columnHeights.fixed = true;

				var maxPositionY:Number = scrollY + height;
				var targetColumnIndex:int = 0;
				var targetColumnHeight:Number = columnHeights[targetColumnIndex];
				for(i = 0; i < itemCount; i++)
				{
					if(this._hasVariableItemDimensions)
					{
						var itemHeight:Number = this._heightCache[i];
						if(itemHeight !== itemHeight) //isNaN
						{
							itemHeight = calculatedTypicalItemHeight;
						}
					}
					else
					{
						itemHeight = calculatedTypicalItemHeight;
					}
					targetColumnHeight += itemHeight;
					for(var j:int = 0; j < columnCount; j++)
					{
						if(j == targetColumnIndex)
						{
							continue;
						}
						var columnHeight:Number = columnHeights[j] + itemHeight;
						if(columnHeight < targetColumnHeight)
						{
							targetColumnIndex = j;
							targetColumnHeight = columnHeight;
						}
					}
					if(targetColumnHeight > scrollY && (targetColumnHeight - itemHeight) < maxPositionY)
					{
						result[resultLastIndex] = i;
						resultLastIndex++;
					}
					targetColumnHeight += this._verticalGap;
					columnHeights[targetColumnIndex] = targetColumnHeight;
				}
				return result;
			}
			//this case can be optimized because we know that every item has
			//the same height

			//we add one extra here because the first item renderer in view may
			//be partially obscured, which would reveal an extra item renderer.
			var maxVisibleTypicalItemCount:int = Math.ceil(height / (calculatedTypicalItemHeight + this._verticalGap)) + 1;
			//we're calculating the minimum and maximum rows
			var minimum:int = (scrollY - this._paddingTop) / (calculatedTypicalItemHeight + this._verticalGap);
			if(minimum < 0)
			{
				minimum = 0;
			}
			//if we're scrolling beyond the final item, we should keep the
			//indices consistent so that items aren't destroyed and
			//recreated unnecessarily
			var maximum:int = minimum + maxVisibleTypicalItemCount;
			if(maximum >= itemCount)
			{
				maximum = itemCount - 1;
			}
			minimum = maximum - maxVisibleTypicalItemCount;
			if(minimum < 0)
			{
				minimum = 0;
			}
			for(i = minimum; i <= maximum; i++)
			{
				for(j = 0; j < columnCount; j++)
				{
					var index:int = (i * columnCount) + j;
					if(index >= 0 && i < itemCount)
					{
						result[resultLastIndex] = index;
					}
					else if(index < 0)
					{
						result[resultLastIndex] = itemCount + index;
					}
					else if(index >= itemCount)
					{
						result[resultLastIndex] = index - itemCount;
					}
					resultLastIndex++;
				}
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getNearestScrollPositionForIndex(index:int, scrollX:Number, scrollY:Number, items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			var maxScrollY:Number = this.calculateMaxScrollYOfIndex(index, items, x, y, width, height);

			if(this._useVirtualLayout)
			{
				if(this._hasVariableItemDimensions)
				{
					var itemHeight:Number = this._heightCache[index];
					if(itemHeight !== itemHeight) //isNaN
					{
						itemHeight = this._typicalItem.height;
					}
				}
				else
				{
					itemHeight = this._typicalItem.height;
				}
			}
			else
			{
				itemHeight = items[index].height;
			}

			if(!result)
			{
				result = new Point();
			}
			result.x = 0;

			var bottomPosition:Number = maxScrollY - (height - itemHeight);
			if(scrollY >= bottomPosition && scrollY <= maxScrollY)
			{
				//keep the current scroll position because the item is already
				//fully visible
				result.y = scrollY;
			}
			else
			{
				var topDifference:Number = Math.abs(maxScrollY - scrollY);
				var bottomDifference:Number = Math.abs(bottomPosition - scrollY);
				if(bottomDifference < topDifference)
				{
					result.y = bottomPosition;
				}
				else
				{
					result.y = maxScrollY;
				}
			}

			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function calculateNavigationDestination(items:Vector.<DisplayObject>, index:int, keyCode:uint, bounds:LayoutBoundsResult):int
		{
			var result:int = index;
			if(keyCode == Keyboard.HOME)
			{
				if(items.length > 0)
				{
					result = 0;
				}
			}
			else if(keyCode == Keyboard.END)
			{
				result = items.length - 1;
			}
			else if(keyCode == Keyboard.UP)
			{
				result--;
			}
			else if(keyCode == Keyboard.DOWN)
			{
				result++;
			}
			if(result < 0)
			{
				return 0;
			}
			if(result >= items.length)
			{
				return items.length - 1;
			}
			return result;
		}

		/**
		 * @inheritDoc
		 */
		public function getScrollPositionForIndex(index:int, items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			var maxScrollY:Number = this.calculateMaxScrollYOfIndex(index, items, x, y, width, height);

			if(this._useVirtualLayout)
			{
				if(this._hasVariableItemDimensions)
				{
					var itemHeight:Number = this._heightCache[index];
					if(itemHeight !== itemHeight) //isNaN
					{
						itemHeight = this._typicalItem.height;
					}
				}
				else
				{
					itemHeight = this._typicalItem.height;
				}
			}
			else
			{
				itemHeight = items[index].height;
			}

			if(!result)
			{
				result = new Point();
			}
			result.x = 0;
			result.y = maxScrollY - Math.round((height - itemHeight) / 2);
			return result;
		}

		/**
		 * @private
		 */
		protected function calculateMaxScrollYOfIndex(index:int, items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number):Number
		{
			if(items.length == 0)
			{
				return 0;
			}

			if(this._useVirtualLayout)
			{
				//if the layout is virtualized, we'll need the dimensions of the
				//typical item so that we have fallback values when an item is null
				if(this._typicalItem is IValidating)
				{
					IValidating(this._typicalItem).validate();
				}
				var calculatedTypicalItemWidth:Number = this._typicalItem ? this._typicalItem.width : 0;
				var calculatedTypicalItemHeight:Number = this._typicalItem ? this._typicalItem.height : 0;
			}

			var columnWidth:Number = 0;
			if(this._useVirtualLayout)
			{
				columnWidth = calculatedTypicalItemWidth;
			}
			else if(items.length > 0)
			{
				var item:DisplayObject = items[0];
				if(item is IValidating)
				{
					IValidating(item).validate();
				}
				columnWidth = item.width;
			}

			var columnCount:int = int((width + this._horizontalGap - this._paddingLeft - this._paddingRight) / (columnWidth + this._horizontalGap));
			if(this._requestedColumnCount > 0 && columnCount > this._requestedColumnCount)
			{
				columnCount = this._requestedColumnCount;
			}
			else if(columnCount < 1)
			{
				columnCount = 1;
			}
			var columnHeights:Vector.<Number> = new <Number>[];
			for(var i:int = 0; i < columnCount; i++)
			{
				columnHeights[i] = this._paddingTop;
			}
			columnHeights.fixed = true;

			var itemCount:int = items.length;
			var targetColumnIndex:int = 0;
			var targetColumnHeight:Number = columnHeights[targetColumnIndex];
			for(i = 0; i < itemCount; i++)
			{
				item = items[i];
				if(this._useVirtualLayout && this._hasVariableItemDimensions)
				{
					var cachedHeight:Number = this._heightCache[i];
				}
				if(this._useVirtualLayout && !item)
				{
					if(!this._hasVariableItemDimensions ||
						cachedHeight !== cachedHeight) //isNaN
					{
						//if all items must have the same height, we will
						//use the height of the typical item (calculatedTypicalItemHeight).

						//if items may have different heights, we first check
						//the cache for a height value. if there isn't one, then
						//we'll use calculatedTypicalItemHeight as a fallback.
						var itemHeight:Number = calculatedTypicalItemHeight;
					}
					else
					{
						itemHeight = cachedHeight;
					}
				}
				else
				{
					if(item is ILayoutDisplayObject)
					{
						var layoutItem:ILayoutDisplayObject = ILayoutDisplayObject(item);
						if(!layoutItem.includeInLayout)
						{
							continue;
						}
					}
					if(item is IValidating)
					{
						IValidating(item).validate();
					}
					//first, scale the items to fit into the column width
					var scaleFactor:Number = columnWidth / item.width;
					item.width *= scaleFactor;
					if(item is IValidating)
					{
						IValidating(item).validate();
					}
					if(this._useVirtualLayout)
					{
						if(this._hasVariableItemDimensions)
						{
							itemHeight = item.height;
							if(itemHeight != cachedHeight)
							{
								this._heightCache[i] = itemHeight;
								this.dispatchEventWith(Event.CHANGE);
							}
						}
						else
						{
							item.height = itemHeight = calculatedTypicalItemHeight;
						}
					}
					else
					{
						itemHeight = item.height;
					}
				}
				targetColumnHeight += itemHeight;
				for(var j:int = 0; j < columnCount; j++)
				{
					if(j == targetColumnIndex)
					{
						continue;
					}
					var columnHeight:Number = columnHeights[j] + itemHeight;
					if(columnHeight < targetColumnHeight)
					{
						targetColumnIndex = j;
						targetColumnHeight = columnHeight;
					}
				}
				if(i == index)
				{
					return targetColumnHeight - itemHeight;
				}
				targetColumnHeight += this._verticalGap;
				columnHeights[targetColumnIndex] = targetColumnHeight;
			}
			var totalHeight:Number = columnHeights[0];
			for(i = 1; i < columnCount; i++)
			{
				columnHeight = columnHeights[i];
				if(columnHeight > totalHeight)
				{
					totalHeight = columnHeight;
				}
			}
			totalHeight -= this._verticalGap;
			totalHeight += this._paddingBottom;
			//subtracting the height gives us the maximum scroll position
			totalHeight -= height;
			if(totalHeight < 0)
			{
				totalHeight = 0;
			}
			return totalHeight;
		}
	}
}


================================================
FILE: source/feathers/media/BaseMediaPlayer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	import feathers.controls.LayoutGroup;
	import feathers.layout.AnchorLayout;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.errors.AbstractClassError;
	import starling.events.Event;

	/**
	 * An abstract superclass for media players that should implement the
	 * <code>feathers.media.IMediaPlayer</code> interface.
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class BaseMediaPlayer extends LayoutGroup implements IMediaPlayer
	{
		/**
		 * Constructor.
		 */
		public function BaseMediaPlayer()
		{
			super();
			if(Object(this).constructor === BaseMediaPlayer)
			{
				throw new AbstractClassError();
			}
			this.addEventListener(Event.ADDED, mediaPlayer_addedHandler);
			this.addEventListener(Event.REMOVED, mediaPlayer_removedHandler);
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(this._layout === null)
			{
				this.ignoreNextStyleRestriction();
				this.layout = new AnchorLayout();
			}
			super.initialize();
		}

		/**
		 * @private
		 */
		protected function handleAddedChild(child:DisplayObject):void
		{
			if(child is IMediaPlayerControl)
			{
				IMediaPlayerControl(child).mediaPlayer = this;
			}
			if(child is DisplayObjectContainer)
			{
				var container:DisplayObjectContainer = DisplayObjectContainer(child);
				var childCount:int = container.numChildren;
				for(var i:int = 0; i < childCount; i++)
				{
					child = container.getChildAt(i);
					this.handleAddedChild(child);
				}
			}
		}

		/**
		 * @private
		 */
		protected function handleRemovedChild(child:DisplayObject):void
		{
			if(child is IMediaPlayerControl)
			{
				IMediaPlayerControl(child).mediaPlayer = null;
			}
			if(child is DisplayObjectContainer)
			{
				var container:DisplayObjectContainer = DisplayObjectContainer(child);
				var childCount:int = container.numChildren;
				for(var i:int = 0; i < childCount; i++)
				{
					child = container.getChildAt(i);
					this.handleRemovedChild(child);
				}
			}
		}

		/**
		 * @private
		 */
		protected function mediaPlayer_addedHandler(event:Event):void
		{
			var addedChild:DisplayObject = DisplayObject(event.target);
			this.handleAddedChild(addedChild);
		}

		/**
		 * @private
		 */
		protected function mediaPlayer_removedHandler(event:Event):void
		{
			var removedChild:DisplayObject = DisplayObject(event.target);
			this.handleRemovedChild(removedChild);
		}
	}
}


================================================
FILE: source/feathers/media/BaseTimedMediaPlayer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	import feathers.events.MediaPlayerEventType;

	import starling.errors.AbstractClassError;

	/**
	 * Dispatched when the media player's total playhead time changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #totalTime
	 *
	 * @eventType feathers.events.MediaPlayerEventType.TOTAL_TIME_CHANGE
	 */
	[Event(name="totalTimeChange",type="starling.events.Event")]

	/**
	 * Dispatched when the media player's current playhead time changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #currentTime
	 *
	 * @eventType feathers.events.MediaPlayerEventType.CURRENT_TIME_CHANGE
	 */
	[Event(name="currentTimeChange",type="starling.events.Event")]

	/**
	 * Dispatched when the media player's playback state changes, such as when
	 * it begins playing or is paused.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #isPlaying
	 *
	 * @eventType feathers.events.MediaPlayerEventType.PLAYBACK_STATE_CHANGE
	 */
	[Event(name="playbackStateChange",type="starling.events.Event")]

	/**
	 * Dispatched when the media completes playback because the current time has
	 * reached the total time.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.COMPLETE
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * An abstract superclass for media players that should implement the
	 * <code>feathers.media.ITimedMediaPlayer</code> interface.
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class BaseTimedMediaPlayer extends BaseMediaPlayer implements ITimedMediaPlayer
	{
		/**
		 * Constructor.
		 */
		public function BaseTimedMediaPlayer()
		{
			super();
			if(Object(this).constructor === BaseTimedMediaPlayer)
			{
				throw new AbstractClassError();
			}
		}

		/**
		 * @private
		 */
		protected var _isPlaying:Boolean = false;

		/**
		 * @inheritDoc
		 *
		 * @see #event:playbackStateChange feathers.events.MediaPlayerEventType.PLAYBACK_STATE_CHANGE
		 */
		public function get isPlaying():Boolean
		{
			return this._isPlaying;
		}

		/**
		 * @private
		 */
		protected var _currentTime:Number = 0;

		/**
		 * @inheritDoc
		 *
		 * @see #event:currentTimeChange feathers.events.MediaPlayerEventType.CURRENT_TIME_CHANGE
		 */
		public function get currentTime():Number
		{
			return this._currentTime;
		}

		/**
		 * @private
		 */
		protected var _totalTime:Number = 0;

		/**
		 * @inheritDoc
		 *
		 * @see #event:totalTimeChange feathers.events.MediaPlayerEventType.TOTAL_TIME_CHANGE
		 */
		public function get totalTime():Number
		{
			return this._totalTime;
		}

		/**
		 * @inheritDoc
		 *
		 * @see #isPlaying
		 * @see #play()
		 * @see #pause()
		 */
		public function togglePlayPause():void
		{
			if(this._isPlaying)
			{
				this.pause();
			}
			else
			{
				this.play();
			}
		}

		/**
		 * @inheritDoc
		 *
		 * @see #isPlaying
		 * @see #pause()
		 * @see #stop()
		 */
		public function play():void
		{
			if(this._isPlaying)
			{
				return;
			}
			this.playMedia();
			this._isPlaying = true;
			this.dispatchEventWith(MediaPlayerEventType.PLAYBACK_STATE_CHANGE);
		}

		/**
		 * @inheritDoc
		 *
		 * @see #isPlaying
		 * @see #play()
		 */
		public function pause():void
		{
			if(!this._isPlaying)
			{
				return;
			}
			this.pauseMedia();
			this._isPlaying = false;
			this.dispatchEventWith(MediaPlayerEventType.PLAYBACK_STATE_CHANGE);
		}

		/**
		 * @inheritDoc
		 *
		 * @see #isPlaying
		 * @see #play()
		 * @see #pause()
		 */
		public function stop():void
		{
			this.pause();
			this.seek(0);
		}

		/**
		 * @inheritDoc
		 */
		public function seek(seconds:Number):void
		{
			this.seekMedia(seconds);
			this.dispatchEventWith(MediaPlayerEventType.CURRENT_TIME_CHANGE);
		}

		/**
		 * Internal function that starts playing the media content. Subclasses
		 * are expected override this function with a custom implementation for
		 * their specific type of media content.
		 */
		protected function playMedia():void
		{

		}

		/**
		 * Internal function that pauses the media content. Subclasses are
		 * expected override this function with a custom implementation for
		 * their specific type of media content.
		 */
		protected function pauseMedia():void
		{

		}

		/**
		 * Internal function that seeks the media content to a specific playhead
		 * time, in seconds. Subclasses are expected override this function with
		 * a custom implementation for their specific type of media content.
		 */
		protected function seekMedia(seconds:Number):void
		{

		}
	}
}


================================================
FILE: source/feathers/media/FullScreenToggleButton.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	import feathers.controls.ToggleButton;
	import feathers.events.MediaPlayerEventType;
	import feathers.skins.IStyleProvider;

	import starling.events.Event;

	/**
	 * A specialized toggle button that controls whether a media player is
	 * displayed normally or in full-screen mode.
	 *
	 * @see ../../../help/video-player.html How to use the Feathers VideoPlayer component
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class FullScreenToggleButton extends ToggleButton implements IMediaPlayerControl
	{
		/**
		 * The default <code>IStyleProvider</code> for all
		 * <code>FullScreenToggleButton</code> components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function FullScreenToggleButton()
		{
			super();
			//we don't actually want this to toggle automatically. instead,
			//we'll update isSelected based on events dispatched by the media
			//player
			this.isToggle = false;
			this.addEventListener(Event.TRIGGERED, fullScreenButton_triggeredHandler);
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return FullScreenToggleButton.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _mediaPlayer:VideoPlayer;

		/**
		 * @inheritDoc
		 */
		public function get mediaPlayer():IMediaPlayer
		{
			return this._mediaPlayer;
		}

		/**
		 * @private
		 */
		public function set mediaPlayer(value:IMediaPlayer):void
		{
			if(this._mediaPlayer == value)
			{
				return;
			}
			if(this._mediaPlayer)
			{
				this._mediaPlayer.removeEventListener(MediaPlayerEventType.DISPLAY_STATE_CHANGE, mediaPlayer_displayStageChangeHandler);
			}
			this._mediaPlayer = value as VideoPlayer;
			if(this._mediaPlayer)
			{
				this.isSelected = this._mediaPlayer.isFullScreen;
				this._mediaPlayer.addEventListener(MediaPlayerEventType.DISPLAY_STATE_CHANGE, mediaPlayer_displayStageChangeHandler);
			}
		}

		/**
		 * @private
		 */
		protected function fullScreenButton_triggeredHandler(event:Event):void
		{
			this._mediaPlayer.toggleFullScreen();
		}

		/**
		 * @private
		 */
		protected function mediaPlayer_displayStageChangeHandler(event:Event):void
		{
			this.isSelected = this._mediaPlayer.isFullScreen;
		}
	}
}


================================================
FILE: source/feathers/media/IAudioPlayer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	import flash.media.SoundTransform;

	/**
	 * Dispatched when the media player's sound transform changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #soundTransform
	 *
	 * @eventType feathers.events.MediaPlayerEventType.SOUND_TRANSFORM_CHANGE
	 */
	[Event(name="soundTransformChange",type="starling.events.Event")]

	/**
	 * An interface for media players that play audio content.
	 *
	 * @productversion Feathers 2.2.0
	 */
	public interface IAudioPlayer extends ITimedMediaPlayer
	{
		/**
		 * Controls properties of the currently playing audio, like volume and
		 * panning.
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/SoundTransform.html flash.media.SoundTransform
		 * @see #event:soundTransformChange feathers.events.MediaPlayerEventType.SOUND_TRANSFORM_CHANGE
		 */
		function get soundTransform():SoundTransform;

		/**
		 * @private
		 */
		function set soundTransform(value:SoundTransform):void;
	}
}


================================================
FILE: source/feathers/media/IMediaPlayer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	import feathers.core.IFeathersEventDispatcher;

	/**
	 * A base interface for all types of media players.
	 *
	 * @productversion Feathers 2.2.0
	 */
	public interface IMediaPlayer extends IFeathersEventDispatcher
	{
	}
}


================================================
FILE: source/feathers/media/IMediaPlayerControl.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	/**
	 * An interface for sub-components added to a media player.
	 *
	 * @see feathers.media.IMediaPlayer
	 * @see feathers.media.IAudioPlayer
	 * @see feathers.media.IVideoPlayer
	 *
	 * @productversion Feathers 2.2.0
	 */
	public interface IMediaPlayerControl
	{
		/**
		 * The media player that this component controls.
		 */
		function get mediaPlayer():IMediaPlayer;

		/**
		 * @private
		 */
		function set mediaPlayer(value:IMediaPlayer):void;
	}
}


================================================
FILE: source/feathers/media/IProgressiveMediaPlayer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	/**
	 * Dispatched periodically when a media player's content is loading to
	 * indicate the current progress. The <code>bytesLoaded</code> and
	 * <code>bytesTotal</code> properties may be accessed to determine the
	 * exact number of bytes loaded.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>A numeric value between <code>0</code>
	 *   and <code>1</code> that indicates how much of the media has loaded so far.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #bytesLoaded
	 * @see #bytesTotal
	 *
	 * @eventType feathers.events.MediaPlayerEventType.LOAD_PROGRESS
	 */
	[Event(name="loadProgress",type="starling.events.Event")]

	/**
	 * A media player that loads its content progressively.
	 *
	 * @productversion Feathers 2.3.0
	 */
	public interface IProgressiveMediaPlayer extends IMediaPlayer
	{
		/**
		 * The number of bytes loaded for the current media.
		 *
		 * @see #bytesTotal
		 * @see #event:loadProgress feathers.events.MediaPlayerEventType.LOAD_PROGRESS
		 */
		function get bytesLoaded():uint;

		/**
		 * The total number of bytes to load for the current media.
		 *
		 * @see #bytesLoaded
		 * @see #event:loadProgress feathers.events.MediaPlayerEventType.LOAD_PROGRESS
		 */
		function get bytesTotal():uint;
	}
}


================================================
FILE: source/feathers/media/ITimedMediaPlayer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	/**
	 * Dispatched when the media player's total playhead time changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #totalTime
	 *
	 * @eventType feathers.events.MediaPlayerEventType.TOTAL_TIME_CHANGE
	 */
	[Event(name="totalTimeChange",type="starling.events.Event")]

	/**
	 * Dispatched when the media player's current playhead time changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #currentTime
	 *
	 * @eventType feathers.events.MediaPlayerEventType.CURRENT_TIME_CHANGE
	 */
	[Event(name="currentTimeChange",type="starling.events.Event")]

	/**
	 * Dispatched when the media player's playback state changes, such as when
	 * it begins playing or is paused.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #isPlaying
	 *
	 * @eventType feathers.events.MediaPlayerEventType.PLAYBACK_STATE_CHANGE
	 */
	[Event(name="playbackStageChange",type="starling.events.Event")]

	/**
	 * Dispatched when the media has played to its end.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.COMPLETE
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * An interface for media players that play timed content.
	 *
	 * @productversion Feathers 2.2.0
	 */
	public interface ITimedMediaPlayer extends IMediaPlayer
	{
		/**
		 * The current position of the playhead, in seconds.
		 *
		 * @see #event:currentTimeChange feathers.events.MediaPlayerEventType.CURRENT_TIME_CHANGE
		 */
		function get currentTime():Number;

		/**
		 * The maximum position of the playhead, in seconds.
		 *
		 * @see #event:totalTimeChange feathers.events.MediaPlayerEventType.TOTAL_TIME_CHANGE
		 */
		function get totalTime():Number;

		/**
		 * Determines if the media content is currently playing.
		 *
		 * @see #event:playbackStateChange feathers.events.MediaPlayerEventType.PLAYBACK_STATE_CHANGE
		 */
		function get isPlaying():Boolean;

		/**
		 * Toggles the media content between playing and paused states.
		 *
		 * @see #isPlaying
		 * @see #play()
		 * @see #pause()
		 */
		function togglePlayPause():void;

		/**
		 * Plays the media content.
		 *
		 * @see #isPlaying
		 * @see #pause()
		 * @see #stop()
		 */
		function play():void;

		/**
		 * Pauses the media content.
		 *
		 * @see #isPlaying
		 * @see #play()
		 */
		function pause():void;

		/**
		 * Stops the media content and returns the playhead to the beginning.
		 *
		 * @see #isPlaying
		 * @see #play()
		 * @see #pause()
		 */
		function stop():void;

		/**
		 * Seeks the media content to a specific position, in seconds.
		 */
		function seek(seconds:Number):void;
	}
}


================================================
FILE: source/feathers/media/IVideoPlayer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	/**
	 * Dispatched when the original, native width or height of the video content
	 * is calculated.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #nativeWidth
	 * @see #nativeHeight
	 *
	 * @eventType feathers.events.MediaPlayerEventType.DIMENSIONS_CHANGE
	 */
	[Event(name="dimensionsChange",type="starling.events.Event")]

	/**
	 * An interface media players that play video content.
	 *
	 * @productversion Feathers 2.2.0
	 */
	public interface IVideoPlayer extends IAudioPlayer
	{
		/**
		 * The original, native width of the loaded video.
		 *
		 * @see #event:dimensionsChange feathers.events.MediaPlayerEventType.DIMENSIONS_CHANGE
		 */
		function get nativeWidth():Number;

		/**
		 * The original, native height of the loaded video.
		 *
		 * @see #event:dimensionsChange feathers.events.MediaPlayerEventType.DIMENSIONS_CHANGE
		 */
		function get nativeHeight():Number;
	}
}


================================================
FILE: source/feathers/media/MediaTimeMode.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	/**
	 * Formats for media playback time.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class MediaTimeMode
	{
		/**
		 * The label displays only the current time of the media content.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const CURRENT_TIME:String = "currentTime";

		/**
		 * The label displays only the total time of the media content.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const TOTAL_TIME:String = "totalTime";

		/**
		 * The label displays only the remaining time of the media content. In
		 * other words, the total time minus the current time.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const REMAINING_TIME:String = "remainingTime";

		/**
		 * The label displays the current time of the media content, followed by
		 * the total time of the media content.
		 *
		 * @productversion Feathers 3.0.0
		 */
		public static const CURRENT_AND_TOTAL_TIMES:String = "currentAndTotalTimes";
	}
}


================================================
FILE: source/feathers/media/MuteToggleButton.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	import feathers.controls.ToggleButton;
	import feathers.controls.popups.DropDownPopUpContentManager;
	import feathers.controls.popups.IPopUpContentManager;
	import feathers.core.PropertyProxy;
	import feathers.events.MediaPlayerEventType;
	import feathers.layout.Direction;
	import feathers.layout.RelativePosition;
	import feathers.skins.IStyleProvider;

	import flash.media.SoundTransform;

	import starling.events.Event;
	import starling.events.EventDispatcher;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	/**
	 * A manager that handles the details of how to display the pop-up
	 * volume slider.
	 *
	 * <p>In the following example, a pop-up content manager is provided:</p>
	 *
	 * <listing version="3.0">
	 * button.popUpContentManager = new CalloutPopUpContentManager();</listing>
	 *
	 * @default null
	 */
	[Style(name="popUpContentManager",type="feathers.controls.popups.IPopUpContentManager")]

	/**
	 * Dispatched when the pop-up volume slider is opened.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.OPEN
	 */
	[Event(name="open",type="starling.events.Event")]

	/**
	 * Dispatched when the pop-up volume slider is closed.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CLOSE
	 */
	[Event(name="close",type="starling.events.Event")]

	/**
	 * A specialized toggle button that controls whether a media player's volume
	 * is muted or not.
	 *
	 * @see ../../../help/sound-player.html How to use the Feathers SoundPlayer component
	 * @see ../../../help/video-player.html How to use the Feathers VideoPlayer component
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class MuteToggleButton extends ToggleButton implements IMediaPlayerControl
	{
		/**
		 * @private
		 */
		protected static const INVALIDATION_FLAG_VOLUME_SLIDER_FACTORY:String = "volumeSliderFactory";

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * pop-up volume slider.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_VOLUME_SLIDER:String = "feathers-volume-toggle-button-volume-slider";

		/**
		 * The default <code>IStyleProvider</code> for all
		 * <code>MuteToggleButton</code> components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static function defaultVolumeSliderFactory():VolumeSlider
		{
			var slider:VolumeSlider = new VolumeSlider();
			slider.direction = Direction.VERTICAL;
			return slider;
		}

		/**
		 * Constructor.
		 */
		public function MuteToggleButton()
		{
			super();
			this.addEventListener(Event.CHANGE, muteToggleButton_changeHandler);
			this.addEventListener(TouchEvent.TOUCH, muteToggleButton_touchHandler);
		}

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * pop-up volume slider. This variable is <code>protected</code> so that
		 * sub-classes can customize the volume slider style name in their
		 * constructors instead of using the default style name defined by
		 * <code>DEFAULT_CHILD_STYLE_NAME_VOLUME_SLIDER</code>.
		 *
		 * <p>To customize the volume slider style name without subclassing, see
		 * <code>customVolumeSliderStyleName</code>.</p>
		 *
		 * @see #style:customVolumeSliderStyleName
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		protected var volumeSliderStyleName:String = DEFAULT_CHILD_STYLE_NAME_VOLUME_SLIDER;

		/**
		 * @private
		 */
		protected var slider:VolumeSlider;

		/**
		 * @private
		 */
		protected var _oldVolume:Number;

		/**
		 * @private
		 */
		protected var _ignoreChanges:Boolean = false;

		/**
		 * @private
		 */
		protected var _touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _popUpTouchPointID:int = -1;

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return MuteToggleButton.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _mediaPlayer:IAudioPlayer;

		/**
		 * @inheritDoc
		 */
		public function get mediaPlayer():IMediaPlayer
		{
			return this._mediaPlayer;
		}

		/**
		 * @private
		 */
		public function set mediaPlayer(value:IMediaPlayer):void
		{
			if(this._mediaPlayer == value)
			{
				return;
			}
			this._mediaPlayer = value as IAudioPlayer;
			this.refreshVolumeFromMediaPlayer();
			if(this._mediaPlayer)
			{
				this._mediaPlayer.addEventListener(MediaPlayerEventType.SOUND_TRANSFORM_CHANGE, mediaPlayer_soundTransformChangeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _popUpContentManager:IPopUpContentManager;

		/**
		 * @private
		 */
		public function get popUpContentManager():IPopUpContentManager
		{
			return this._popUpContentManager;
		}

		/**
		 * @private
		 */
		public function set popUpContentManager(value:IPopUpContentManager):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._popUpContentManager === value)
			{
				return;
			}
			if(this._popUpContentManager is EventDispatcher)
			{
				var dispatcher:EventDispatcher = EventDispatcher(this._popUpContentManager);
				dispatcher.removeEventListener(Event.OPEN, popUpContentManager_openHandler);
				dispatcher.removeEventListener(Event.CLOSE, popUpContentManager_closeHandler);
			}
			this._popUpContentManager = value;
			if(this._popUpContentManager is EventDispatcher)
			{
				dispatcher = EventDispatcher(this._popUpContentManager);
				dispatcher.addEventListener(Event.OPEN, popUpContentManager_openHandler);
				dispatcher.addEventListener(Event.CLOSE, popUpContentManager_closeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _showVolumeSliderOnHover:Boolean = false;

		/**
		 * Determines if a <code>VolumeSlider</code> component is displayed as a
		 * pop-up when hovering over the toggle button. This property is
		 * intended for use on desktop platforms only. On mobile platforms,
		 * Starling does not dispatch events for hover, so the volume slider
		 * will not be shown.
		 *
		 * <p>In the following example, showing the volume slider is enabled:</p>
		 *
		 * <listing version="3.0">
		 * button.showVolumeSliderOnHover = true;</listing>
		 *
		 * @default false
		 *
		 * @see feathers.media.VolumeSlider
		 */
		public function get showVolumeSliderOnHover():Boolean
		{
			return this._showVolumeSliderOnHover;
		}

		/**
		 * @private
		 */
		public function set showVolumeSliderOnHover(value:Boolean):void
		{
			if(this._showVolumeSliderOnHover == value)
			{
				return;
			}
			this._showVolumeSliderOnHover = value;
			this.invalidate(INVALIDATION_FLAG_VOLUME_SLIDER_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _volumeSliderFactory:Function;

		/**
		 * A function used to generate the button's pop-up volume slider
		 * sub-component. The volume slider must be an instance of
		 * <code>VolumeSlider</code>. This factory can be used to change
		 * properties on the volume slider when it is first created. For
		 * instance, if you are skinning Feathers components without a theme,
		 * you might use this factory to set skins and other styles on the
		 * volume slider.
		 *
		 * <p>The function should have the following signature:</p>
		 * <pre>function():VolumeSlider</pre>
		 *
		 * <p>In the following example, a custom volume slider factory is passed
		 * to the button:</p>
		 *
		 * <listing version="3.0">
		 * button.volumeSliderFactory = function():VolumeSlider
		 * {
		 *     var popUpSlider:VolumeSlider = new VolumeSlider();
		 *     popUpSlider.direction = Direction.VERTICAL;
		 *     return popUpSlider;
		 * };</listing>
		 *
		 * @default null
		 *
		 * @see feathers.media.VolumeSlider
		 * @see #showVolumeSliderOnHover
		 */
		public function get volumeSliderFactory():Function
		{
			return this._volumeSliderFactory;
		}

		/**
		 * @private
		 */
		public function set volumeSliderFactory(value:Function):void
		{
			if(this._volumeSliderFactory == value)
			{
				return;
			}
			this._volumeSliderFactory = value;
			this.invalidate(INVALIDATION_FLAG_VOLUME_SLIDER_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _customVolumeSliderStyleName:String;

		/**
		 * A style name to add to the button's volume slider sub-component.
		 * Typically used by a theme to provide different styles to different
		 * buttons.
		 *
		 * <p>In the following example, a custom volume slider style name is
		 * passed to the button:</p>
		 *
		 * <listing version="3.0">
		 * button.customVolumeSliderStyleName = "my-custom-volume-slider";</listing>
		 *
		 * <p>In your theme, you can target this sub-component style name to provide
		 * different styles than the default:</p>
		 *
		 * <listing version="3.0">
		 * getStyleProviderForClass( VolumeSlider ).setFunctionForStyleName( "my-custom-volume-slider", setCustomVolumeSliderStyles );</listing>
		 *
		 * @default null
		 *
		 * @see #showVolumeSliderOnHover
		 * @see #DEFAULT_CHILD_STYLE_NAME_VOLUME_SLIDER
		 * @see feathers.core.FeathersControl#styleNameList
		 * @see #volumeSliderFactory
		 */
		public function get customVolumeSliderStyleName():String
		{
			return this._customVolumeSliderStyleName;
		}

		/**
		 * @private
		 */
		public function set customVolumeSliderStyleName(value:String):void
		{
			if(this._customVolumeSliderStyleName == value)
			{
				return;
			}
			this._customVolumeSliderStyleName = value;
			this.invalidate(INVALIDATION_FLAG_VOLUME_SLIDER_FACTORY);
		}

		/**
		 * @private
		 */
		protected var _volumeSliderProperties:PropertyProxy;

		/**
		 * An object that stores properties for the button's pop-up volume
		 * slider sub-component, and the properties will be passed down to the
		 * volume slider when the button validates. For a list of available
		 * properties, refer to <a href="VolumeSlider.html"><code>feathers.media.VolumeSlider</code></a>.
		 *
		 * <p>If the subcomponent has its own subcomponents, their properties
		 * can be set too, using attribute <code>&#64;</code> notation. For example,
		 * to set the skin on the thumb which is in a <code>SimpleScrollBar</code>,
		 * which is in a <code>List</code>, you can use the following syntax:</p>
		 * <pre>list.verticalScrollBarProperties.&#64;thumbProperties.defaultSkin = new Image(texture);</pre>
		 *
		 * <p>Setting properties in a <code>volumeSliderFactory</code> function
		 * instead of using <code>volumeSliderProperties</code> will result in
		 * better performance.</p>
		 *
		 * <p>In the following example, the volume slider properties are passed
		 * to the button:</p>
		 *
		 * <listing version="3.0">
		 * button.volumeSliderProperties.direction = Direction.VERTICAL;</listing>
		 *
		 * @default null
		 *
		 * @see #showVolumeSliderOnHover
		 * @see #volumeSliderFactory
		 * @see feathers.media.VolumeSlider
		 */
		public function get volumeSliderProperties():Object
		{
			if(!this._volumeSliderProperties)
			{
				this._volumeSliderProperties = new PropertyProxy(childProperties_onChange);
			}
			return this._volumeSliderProperties;
		}

		/**
		 * @private
		 */
		public function set volumeSliderProperties(value:Object):void
		{
			if(this._volumeSliderProperties == value)
			{
				return;
			}
			if(!value)
			{
				value = new PropertyProxy();
			}
			if(!(value is PropertyProxy))
			{
				var newValue:PropertyProxy = new PropertyProxy();
				for(var propertyName:String in value)
				{
					newValue[propertyName] = value[propertyName];
				}
				value = newValue;
			}
			if(this._volumeSliderProperties)
			{
				this._volumeSliderProperties.removeOnChangeCallback(childProperties_onChange);
			}
			this._volumeSliderProperties = PropertyProxy(value);
			if(this._volumeSliderProperties)
			{
				this._volumeSliderProperties.addOnChangeCallback(childProperties_onChange);
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _isOpenPopUpPending:Boolean = false;

		/**
		 * @private
		 */
		protected var _isClosePopUpPending:Boolean = false;

		/**
		 * Opens the pop-up volume slider, if it isn't already open.
		 */
		public function openPopUp():void
		{
			this._isClosePopUpPending = false;
			if(this._popUpContentManager.isOpen)
			{
				return;
			}
			if(!this._isValidating && this.isInvalid())
			{
				this._isOpenPopUpPending = true;
				return;
			}
			this._isOpenPopUpPending = false;
			this._popUpContentManager.open(this.slider, this);
			this.slider.validate();
			this._popUpTouchPointID = -1;
			this.slider.addEventListener(TouchEvent.TOUCH, volumeSlider_touchHandler);
		}

		/**
		 * Closes the pop-up volume slider, if it is open.
		 */
		public function closePopUp():void
		{
			this._isOpenPopUpPending = false;
			if(!this._popUpContentManager.isOpen)
			{
				return;
			}
			if(!this._isValidating && this.isInvalid())
			{
				this._isClosePopUpPending = true;
				return;
			}
			this._isClosePopUpPending = false;
			this.slider.validate();
			//don't clean up anything from openPopUp() in closePopUp(). The
			//pop-up may be closed by removing it from the PopUpManager, which
			//would result in closePopUp() never being called.
			//instead, clean up in the Event.REMOVED_FROM_STAGE listener.
			this._popUpContentManager.close();
		}

		/**
		 * @inheritDoc
		 */
		override public function dispose():void
		{
			if(this.slider)
			{
				this.closePopUp();
				this.slider.mediaPlayer = null;
				this.slider.dispose();
				this.slider = null;
			}
			if(this._popUpContentManager)
			{
				this._popUpContentManager.dispose();
				this._popUpContentManager = null;
			}
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(this._popUpContentManager === null)
			{
				var popUpContentManager:DropDownPopUpContentManager = new DropDownPopUpContentManager();
				popUpContentManager.fitContentMinWidthToOrigin = false;
				popUpContentManager.primaryDirection = RelativePosition.TOP;
				this.ignoreNextStyleRestriction();
				this.popUpContentManager = popUpContentManager;
			}
			super.initialize();
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			var stylesInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_STYLES);
			var volumeSliderFactoryInvalid:Boolean = this.isInvalid(INVALIDATION_FLAG_VOLUME_SLIDER_FACTORY);

			if(volumeSliderFactoryInvalid)
			{
				this.createVolumeSlider();
			}

			if(this.slider && (volumeSliderFactoryInvalid || stylesInvalid))
			{
				this.refreshVolumeSliderProperties();
			}

			super.draw();

			this.handlePendingActions();
		}

		/**
		 * Creates and adds the volume slider sub-component and
		 * removes the old instance, if one exists.
		 *
		 * <p>Meant for internal use, and subclasses may override this function
		 * with a custom implementation.</p>
		 *
		 * @see #volumeSliderFactory
		 * @see #style:customVolumeSliderStyleName
		 */
		protected function createVolumeSlider():void
		{
			if(this.slider)
			{
				this.slider.removeFromParent(false);
				//disposing separately because the slider may not have a parent
				this.slider.dispose();
				this.slider = null;
			}
			if(!this._showVolumeSliderOnHover)
			{
				return;
			}

			var factory:Function = this._volumeSliderFactory != null ? this._volumeSliderFactory : defaultVolumeSliderFactory;
			var volumeSliderStyleName:String = this._customVolumeSliderStyleName != null ? this._customVolumeSliderStyleName : this.volumeSliderStyleName;
			this.slider = VolumeSlider(factory());
			this.slider.focusOwner = this;
			this.slider.styleNameList.add(volumeSliderStyleName);
		}

		/**
		 * @private
		 */
		protected function refreshVolumeSliderProperties():void
		{
			for(var propertyName:String in this._volumeSliderProperties)
			{
				var propertyValue:Object = this._volumeSliderProperties[propertyName];
				this.slider[propertyName] = propertyValue;
			}
			this.slider.mediaPlayer = this._mediaPlayer;
		}

		/**
		 * @private
		 */
		protected function handlePendingActions():void
		{
			if(this._isOpenPopUpPending)
			{
				this.openPopUp();
			}
			if(this._isClosePopUpPending)
			{
				this.closePopUp();
			}
		}

		/**
		 * @private
		 */
		protected function refreshVolumeFromMediaPlayer():void
		{
			var oldIgnoreChanges:Boolean = this._ignoreChanges;
			this._ignoreChanges = true;
			if(this._mediaPlayer)
			{
				this.isSelected = this._mediaPlayer.soundTransform.volume == 0;
			}
			else
			{
				this.isSelected = false;
			}
			this._ignoreChanges = oldIgnoreChanges;
		}

		/**
		 * @private
		 */
		protected function mediaPlayer_soundTransformChangeHandler(event:Event):void
		{
			this.refreshVolumeFromMediaPlayer();
		}

		/**
		 * @private
		 */
		protected function muteToggleButton_changeHandler(event:Event):void
		{
			if(this._ignoreChanges || !this._mediaPlayer)
			{
				return;
			}
			var soundTransform:SoundTransform = this._mediaPlayer.soundTransform;
			if(this._isSelected)
			{
				this._oldVolume = soundTransform.volume;
				if(this._oldVolume == 0)
				{
					this._oldVolume = 1;
				}
				soundTransform.volume = 0;
				this._mediaPlayer.soundTransform = soundTransform;
			}
			else
			{
				var newVolume:Number = this._oldVolume;
				if(newVolume !== newVolume) //isNaN
				{
					//volume was already zero, so we should fall back to some
					//default value
					newVolume = 1;
				}
				soundTransform.volume = newVolume;
				this._mediaPlayer.soundTransform = soundTransform;
			}
		}

		/**
		 * @private
		 */
		protected function muteToggleButton_touchHandler(event:TouchEvent):void
		{
			if(!this.slider)
			{
				this._touchPointID = -1;
				return;
			}
			if(this._touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this, null, this._touchPointID);
				if(touch)
				{
					return;
				}
				this._touchPointID = -1;
				touch = event.getTouch(this.slider);
				if(this._popUpTouchPointID < 0 && !touch)
				{
					this.closePopUp();
				}
			}
			else
			{
				touch = event.getTouch(this, TouchPhase.HOVER);
				if(!touch)
				{
					return;
				}
				this._touchPointID = touch.id;
				this.openPopUp();
			}
		}

		/**
		 * @private
		 */
		protected function volumeSlider_touchHandler(event:TouchEvent):void
		{
			if(this._popUpTouchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this.slider, null, this._popUpTouchPointID);
				if(touch)
				{
					return;
				}
				this._popUpTouchPointID = -1;
				touch = event.getTouch(this);
				if(this._touchPointID < 0 && !touch)
				{
					this.closePopUp();
				}
			}
			else
			{
				touch = event.getTouch(this.slider, TouchPhase.HOVER);
				if(!touch)
				{
					return;
				}
				this._popUpTouchPointID = touch.id;
			}
		}

		/**
		 * @private
		 */
		protected function popUpContentManager_openHandler(event:Event):void
		{
			this.dispatchEventWith(Event.OPEN);
		}

		/**
		 * @private
		 */
		protected function popUpContentManager_closeHandler(event:Event):void
		{
			this.slider.removeEventListener(TouchEvent.TOUCH, volumeSlider_touchHandler);
			this.dispatchEventWith(Event.CLOSE);
		}
	}
}


================================================
FILE: source/feathers/media/PlayPauseToggleButton.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	import feathers.controls.ToggleButton;
	import feathers.events.MediaPlayerEventType;
	import feathers.skins.IStyleProvider;

	import starling.events.Event;

	/**
	 * A specialized toggle button that controls whether a media player is
	 * playing or paused.
	 *
	 * @see ../../../help/sound-player.html How to use the Feathers SoundPlayer component
	 * @see ../../../help/video-player.html How to use the Feathers VideoPlayer component
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class PlayPauseToggleButton extends ToggleButton implements IMediaPlayerControl
	{
		/**
		 * An alternate style name to use with
		 * <code>PlayPauseToggleButton</code> to allow a theme to give it an
		 * appearance of an overlay above video. If a theme does not provide a
		 * style for an overlay play/pause button, the theme will automatically
		 * fall back to using the default play/pause button style.
		 *
		 * <p>An alternate style name should always be added to a component's
		 * <code>styleNameList</code> before the component is initialized. If
		 * the style name is added later, it will be ignored.</p>
		 *
		 * <p>In the following example, the overlay play/pause style is applied
		 * to a button:</p>
		 *
		 * <listing version="3.0">
		 * var overlayButton:PlayPauseButton = new PlayPauseButton();
		 * overlayButton.styleNameList.add( PlayPauseButton.ALTERNATE_STYLE_NAME_OVERLAY_PLAY_PAUSE_TOGGLE_BUTTON );
		 * player.addChild( overlayButton );</listing>
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const ALTERNATE_STYLE_NAME_OVERLAY_PLAY_PAUSE_TOGGLE_BUTTON:String = "feathers-overlay-play-pause-toggle-button";

		/**
		 * The default <code>IStyleProvider</code> for all
		 * <code>PlayPauseToggleButton</code> components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function PlayPauseToggleButton()
		{
			super();
			//we don't actually want this to toggle automatically. instead,
			//we'll update isSelected based on events dispatched by the media
			//player
			this.isToggle = false;
			this.addEventListener(Event.TRIGGERED, playPlayButton_triggeredHandler);
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return PlayPauseToggleButton.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _mediaPlayer:ITimedMediaPlayer;

		/**
		 * @inheritDoc
		 */
		public function get mediaPlayer():IMediaPlayer
		{
			return this._mediaPlayer;
		}

		/**
		 * @private
		 */
		public function set mediaPlayer(value:IMediaPlayer):void
		{
			if(this._mediaPlayer == value)
			{
				return;
			}
			if(this._mediaPlayer)
			{
				this._mediaPlayer.removeEventListener(MediaPlayerEventType.PLAYBACK_STATE_CHANGE, mediaPlayer_playbackStateChangeHandler);
			}
			this._mediaPlayer = value as ITimedMediaPlayer;
			this.refreshState();
			if(this._mediaPlayer)
			{
				this._mediaPlayer.addEventListener(MediaPlayerEventType.PLAYBACK_STATE_CHANGE, mediaPlayer_playbackStateChangeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected var _touchableWhenPlaying:Boolean = true;

		/**
		 * Determines if the button may be touched when the media player is
		 * playing its content. In other words, this button will only work when
		 * the content is paused.
		 *
		 * @default true
		 */
		public function get touchableWhenPlaying():Boolean
		{
			return this._touchableWhenPlaying;
		}

		/**
		 * @private
		 */
		public function set touchableWhenPlaying(value:Boolean):void
		{
			if(this._touchableWhenPlaying == value)
			{
				return;
			}
			this._touchableWhenPlaying = value;
		}

		/**
		 * @private
		 */
		protected function refreshState():void
		{
			if(!this._mediaPlayer)
			{
				this.isSelected = false;
				return;
			}
			this.isSelected = this._mediaPlayer.isPlaying;
			this.touchable = !this._isSelected || this._touchableWhenPlaying;
		}

		/**
		 * @private
		 */
		protected function playPlayButton_triggeredHandler(event:Event):void
		{
			this._mediaPlayer.togglePlayPause();
		}

		/**
		 * @private
		 */
		protected function mediaPlayer_playbackStateChangeHandler(event:Event):void
		{
			this.refreshState();
		}
	}
}


================================================
FILE: source/feathers/media/SeekSlider.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	import feathers.controls.Slider;
	import feathers.core.IValidating;
	import feathers.events.FeathersEventType;
	import feathers.events.MediaPlayerEventType;
	import feathers.layout.Direction;
	import feathers.skins.IStyleProvider;

	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * An optional skin that acts similar to the fill skin of a progress bar
	 * that displays the download progres of the media.
	 *
	 * <p>In the following example, the progress skin is customized:</p>
	 *
	 * <listing version="3.0">
	 * var skin:Image = new Image( texture );
	 * skin.scale9Grid = new Rectangle( 2, 3, 6, 1 );
	 * slider.progressSkin = skin;</listing>
	 *
	 * @default null
	 */
	[Style(name="progressSkin",type="starling.display.DisplayObject")]

	/**
	 * A specialized slider that displays and controls the current position of
	 * the playhead of a media player.
	 *
	 * @see ../../../help/sound-player.html How to use the Feathers SoundPlayer component
	 * @see ../../../help/video-player.html How to use the Feathers VideoPlayer component
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class SeekSlider extends Slider implements IMediaPlayerControl
	{
		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * minimum track.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK:String = "feathers-seek-slider-minimum-track";

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * maximum track.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK:String = "feathers-seek-slider-maximum-track";

		/**
		 * The default value added to the <code>styleNameList</code> of the thumb.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_THUMB:String = "feathers-seek-slider-thumb";

		/**
		 * The default <code>IStyleProvider</code> for all
		 * <code>SeekSlider</code> components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function SeekSlider()
		{
			super();
			this.thumbStyleName = SeekSlider.DEFAULT_CHILD_STYLE_NAME_THUMB;
			this.minimumTrackStyleName = SeekSlider.DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK;
			this.maximumTrackStyleName = SeekSlider.DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK;
			this.addEventListener(Event.CHANGE, seekSlider_changeHandler);
			this.addEventListener(FeathersEventType.END_INTERACTION, seekSlider_endInteractionHandler);
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return SeekSlider.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _mediaPlayer:ITimedMediaPlayer;

		/**
		 * @inheritDoc
		 */
		public function get mediaPlayer():IMediaPlayer
		{
			return this._mediaPlayer;
		}

		/**
		 * @private
		 */
		public function set mediaPlayer(value:IMediaPlayer):void
		{
			if(this._mediaPlayer == value)
			{
				return;
			}
			if(this._mediaPlayer)
			{
				this._mediaPlayer.removeEventListener(MediaPlayerEventType.LOAD_PROGRESS, mediaPlayer_loadProgressHandler);
				this._mediaPlayer.removeEventListener(MediaPlayerEventType.CURRENT_TIME_CHANGE, mediaPlayer_currentTimeChangeHandler);
				this._mediaPlayer.removeEventListener(MediaPlayerEventType.TOTAL_TIME_CHANGE, mediaPlayer_totalTimeChangeHandler);
			}
			this._mediaPlayer = value as ITimedMediaPlayer;
			if(this._mediaPlayer)
			{
				this._mediaPlayer.addEventListener(MediaPlayerEventType.CURRENT_TIME_CHANGE, mediaPlayer_currentTimeChangeHandler);
				this._mediaPlayer.addEventListener(MediaPlayerEventType.TOTAL_TIME_CHANGE, mediaPlayer_totalTimeChangeHandler);
				if(this._mediaPlayer is IProgressiveMediaPlayer)
				{
					var progressivePlayer:IProgressiveMediaPlayer = IProgressiveMediaPlayer(this._mediaPlayer);
					progressivePlayer.addEventListener(MediaPlayerEventType.LOAD_PROGRESS, mediaPlayer_loadProgressHandler);
					if(progressivePlayer.bytesTotal > 0)
					{
						this._progress = progressivePlayer.bytesLoaded / progressivePlayer.bytesTotal;
					}
					else
					{
						this._progress = 0;
					}
				}
				else
				{
					this._progress = 0;
				}
				this.minimum = 0;
				this.maximum = this._mediaPlayer.totalTime;
				this.value = this._mediaPlayer.currentTime;
			}
			else
			{
				this.minimum = 0;
				this.maximum = 0;
				this.value = 0;
			}
		}

		/**
		 * @private
		 */
		protected var _progress:Number = 0;

		/**
		 * @private
		 */
		protected var _progressSkin:DisplayObject;

		/**
		 * @private
		 */
		public function get progressSkin():DisplayObject
		{
			return this._progressSkin;
		}

		/**
		 * @private
		 */
		public function set progressSkin(value:DisplayObject):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				if(value !== null)
				{
					value.dispose();
				}
				return;
			}
			if(this._progressSkin == value)
			{
				return;
			}
			if(this._progressSkin)
			{
				this.removeChild(this._progressSkin);
			}
			this._progressSkin = value;
			if(this._progressSkin)
			{
				if(this._progressSkin.parent != this)
				{
					this._progressSkin.visible = false;
					this.addChild(this._progressSkin);
				}
				this._progressSkin.touchable = false;
			}
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		override protected function layoutChildren():void
		{
			super.layoutChildren();
			this.layoutProgressSkin();
		}

		/**
		 * @private
		 */
		protected function layoutProgressSkin():void
		{
			if(this._progressSkin === null)
			{
				return;
			}

			if(this._minimum == this._maximum)
			{
				var percentage:Number = 1;
			}
			else
			{
				percentage = (this._value - this._minimum) / (this._maximum - this._minimum);
				if(percentage < 0)
				{
					percentage = 0;
				}
				else if(percentage > 1)
				{
					percentage = 1;
				}
			}
			if(this._progress == 0 || this._progress <= percentage)
			{
				this._progressSkin.visible = false;
				return;
			}

			this._progressSkin.visible = true;
			if(this._progressSkin is IValidating)
			{
				IValidating(this._progressSkin).validate();
			}

			if(this._direction === Direction.VERTICAL)
			{
				var trackScrollableHeight:Number = this.actualHeight - this.thumb.height / 2 - this._minimumPadding - this._maximumPadding;
				this._progressSkin.x = Math.round((this.actualWidth - this._progressSkin.width) / 2);
				var progressHeight:Number = Math.round(trackScrollableHeight * this._progress);
				var maxProgressHeight:Number = Math.round(this.thumb.y + this.thumb.height / 2);
				if(progressHeight < 0)
				{
					progressHeight = 0;
				}
				else if(progressHeight > maxProgressHeight)
				{
					progressHeight = maxProgressHeight;
				}
				this._progressSkin.height = progressHeight;
				this._progressSkin.y = maxProgressHeight - progressHeight;
			}
			else //horizontal
			{
				var trackScrollableWidth:Number = this.actualWidth - this._minimumPadding - this._maximumPadding;
				this._progressSkin.x = Math.round(this.thumb.x + this.thumb.width / 2);
				this._progressSkin.y = Math.round((this.actualHeight - this._progressSkin.height) / 2);
				var progressWidth:Number = Math.round((trackScrollableWidth * this._progress) - this._progressSkin.x);
				if(progressWidth < 0)
				{
					progressWidth = 0;
				}
				else
				{
					var maxProgressWidth:Number = Math.round(this.actualWidth - this._progressSkin.x);
					if(progressWidth > maxProgressWidth)
					{
						progressWidth = maxProgressWidth;
					}
				}
				this._progressSkin.width = progressWidth;
			}
		}

		/**
		 * @private
		 */
		protected function updateValueFromMediaPlayerCurrentTime():void
		{
			if(this.isDragging)
			{
				//if we're currently dragging, ignore changes by the player
				return;
			}
			this._value = this._mediaPlayer.currentTime;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function seekSlider_changeHandler(event:Event):void
		{
			if(!this._mediaPlayer)
			{
				return;
			}
			this._mediaPlayer.seek(this._value);
		}

		/**
		 * @private
		 */
		protected function seekSlider_endInteractionHandler(event:Event):void
		{
			//we may have ignored some changes from the media player while we
			//were dragging, so we should update the value if it's out of sync.
			this.updateValueFromMediaPlayerCurrentTime();
		}

		/**
		 * @private
		 */
		protected function mediaPlayer_currentTimeChangeHandler(event:Event):void
		{
			this.updateValueFromMediaPlayerCurrentTime();
		}

		/**
		 * @private
		 */
		protected function mediaPlayer_totalTimeChangeHandler(event:Event):void
		{
			this.maximum = this._mediaPlayer.totalTime;
		}

		/**
		 * @private
		 */
		protected function mediaPlayer_loadProgressHandler(event:Event, progress:Number):void
		{
			if(this._progress == progress)
			{
				return;
			}
			this._progress = progress;
			this.invalidate(INVALIDATION_FLAG_DATA);
		}
	}
}


================================================
FILE: source/feathers/media/SoundChannelPeakVisualizer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	import feathers.core.FeathersControl;
	import feathers.events.MediaPlayerEventType;
	import feathers.skins.IStyleProvider;

	import flash.media.SoundChannel;

	import starling.display.Quad;
	import starling.events.Event;

	/**
	 * The gap, in pixels, between the bars.
	 *
	 * <p>In the following example, the gap is set to 10 pixels:</p>
	 *
	 * <listing version="3.0">
	 * control.gap = 10;</listing>
	 *
	 * @default 0
	 */
	[Style(name="gap",type="Number")]

	/**
	 * A visualization of the left and right peaks of the
	 * <code>flash.media.SoundChannel</code> from a <code>SoundPlayer</code>
	 * component.
	 *
	 * @see ../../../help/sound-player.html How to use the Feathers SoundPlayer component
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class SoundChannelPeakVisualizer extends FeathersControl implements IMediaPlayerControl
	{
		/**
		 * The default <code>IStyleProvider</code> for all
		 * <code>SoundChannelPeakVisualizer</code> components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function SoundChannelPeakVisualizer()
		{
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return SoundChannelPeakVisualizer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var leftPeakBar:Quad;

		/**
		 * @private
		 */
		protected var rightPeakBar:Quad;

		/**
		 * @private
		 */
		protected var _gap:Number = 0;

		/**
		 * @private
		 */
		public function get gap():Number
		{
			return this._gap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._gap == value)
			{
				return;
			}
			this._gap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _mediaPlayer:SoundPlayer;

		/**
		 * @inheritDoc
		 */
		public function get mediaPlayer():IMediaPlayer
		{
			return this._mediaPlayer;
		}

		/**
		 * @private
		 */
		public function set mediaPlayer(value:IMediaPlayer):void
		{
			if(this._mediaPlayer == value)
			{
				return;
			}
			if(this._mediaPlayer)
			{
				this._mediaPlayer.removeEventListener(MediaPlayerEventType.PLAYBACK_STATE_CHANGE, mediaPlayer_playbackStateChange);
			}
			this._mediaPlayer = value as SoundPlayer;
			if(this._mediaPlayer)
			{
				this.handlePlaybackStateChange();
				this._mediaPlayer.addEventListener(MediaPlayerEventType.PLAYBACK_STATE_CHANGE, mediaPlayer_playbackStateChange);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.mediaPlayer = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			if(!this.leftPeakBar)
			{
				this.leftPeakBar = new Quad(1, 1);
				this.addChild(this.leftPeakBar);
			}
			if(!this.rightPeakBar)
			{
				this.rightPeakBar = new Quad(1, 1);
				this.addChild(this.rightPeakBar);
			}
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			this.autoSizeIfNeeded();

			if(this._mediaPlayer && this._mediaPlayer.soundChannel)
			{
				var soundChannel:SoundChannel = this._mediaPlayer.soundChannel;
				var maxHeight:Number = this.actualHeight - 1;
				this.leftPeakBar.height = 1 + maxHeight * soundChannel.leftPeak;
				this.rightPeakBar.height = 1 + maxHeight * soundChannel.rightPeak;
			}
			else
			{
				this.leftPeakBar.height = 1;
				this.rightPeakBar.height = 1;
			}
			var barWidth:Number = (this.actualWidth / 2) - this._gap;
			this.leftPeakBar.y = this.actualHeight - this.leftPeakBar.height;
			this.leftPeakBar.width = barWidth;
			this.rightPeakBar.x = barWidth + this._gap;
			this.rightPeakBar.y = this.actualHeight - this.rightPeakBar.height;
			this.rightPeakBar.width = barWidth;
			super.draw();
		}

		/**
		 * @private
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			if(!needsWidth && !needsHeight)
			{
				return false;
			}
			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				newWidth = 4 + this._gap;
			}
			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				newHeight = 3;
			}
			return this.saveMeasurements(newWidth, newHeight, newWidth, newHeight);
		}

		/**
		 * @private
		 */
		protected function handlePlaybackStateChange():void
		{
			if(this._mediaPlayer.isPlaying)
			{
				this.addEventListener(Event.ENTER_FRAME, peakVisualizer_enterFrameHandler);
			}
			else
			{
				this.removeEventListener(Event.ENTER_FRAME, peakVisualizer_enterFrameHandler);
			}
		}

		/**
		 * @private
		 */
		protected function mediaPlayer_playbackStateChange(event:Event):void
		{
			this.handlePlaybackStateChange();
		}

		/**
		 * @private
		 */
		protected function peakVisualizer_enterFrameHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}
	}
}


================================================
FILE: source/feathers/media/SoundPlayer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	import feathers.events.MediaPlayerEventType;
	import feathers.skins.IStyleProvider;

	import flash.errors.IllegalOperationError;
	import flash.events.ErrorEvent;
	import flash.events.IOErrorEvent;
	import flash.events.ProgressEvent;
	import flash.media.Sound;
	import flash.media.SoundChannel;
	import flash.media.SoundLoaderContext;
	import flash.media.SoundTransform;
	import flash.net.URLRequest;

	import starling.events.Event;

	/**
	 * Dispatched when the MP3 ID3 metadata becomes available on the
	 * <code>Sound</code> instance.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The <code>flash.media.ID3Info</code>
	 *   instance returned by the <code>id3</code> property of the
	 *   <code>Sound</code> instance.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/Sound.html#id3 flash.media.Sound.id3
	 *
	 * @eventType feathers.events.MediaPlayerEventType.METADATA_RECEIVED
	 */
	[Event(name="metadataReceived",type="starling.events.Event")]

	/**
	 * Dispatched periodically when a media player's content is loading to
	 * indicate the current progress. The <code>bytesLoaded</code> and
	 * <code>bytesTotal</code> properties may be accessed to determine the
	 * exact number of bytes loaded.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>A numeric value between <code>0</code>
	 *   and <code>1</code> that indicates how much of the media has loaded so far.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #bytesLoaded
	 * @see #bytesTotal
	 *
	 * @eventType feathers.events.MediaPlayerEventType.LOAD_PROGRESS
	 */
	[Event(name="loadProgress",type="starling.events.Event")]

	/**
	 * Dispatched when a media player's content is fully loaded and it
	 * may be played to completion without buffering.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #isLoaded
	 *
	 * @eventType feathers.events.MediaPlayerEventType.LOAD_COMPLETE
	 */
	[Event(name="loadComplete",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>flash.media.Sound</code> object dispatches
	 * <code>flash.events.IOErrorEvent.IO_ERROR</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The <code>flash.events.IOErrorEvent</code>
	 *   dispatched by the <code>flash.media.Sound</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/Sound.html#event:ioError flash.media.Sound: flash.events.IOErrorEvent.IO_ERROR
	 *
	 * @eventType starling.events.Event.IO_ERROR
	 */
	[Event(name="ioError",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>flash.media.Sound</code> object dispatches
	 * <code>flash.events.SecurityErrorEvent.SECURITY_ERROR</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The <code>flash.events.SecurityErrorEvent</code>
	 *   dispatched by the <code>flash.media.Sound</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/Sound.html#event:securityError flash.media.Sound: flash.events.SecurityErrorEvent.SECURITY_ERROR
	 *
	 * @eventType starling.events.Event.SECURITY_ERROR
	 */
	[Event(name="securityError",type="starling.events.Event")]

	/**
	 * Dispatched when the media player's sound transform changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #soundTransform
	 *
	 * @eventType feathers.events.MediaPlayerEventType.SOUND_TRANSFORM_CHANGE
	 */
	[Event(name="soundTransformChange",type="starling.events.Event")]

	/**
	 * Controls playback of audio with a <code>flash.media.Sound</code> object.
	 *
	 * @see ../../../help/sound-player.html How to use the Feathers SoundPlayer component
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class SoundPlayer extends BaseTimedMediaPlayer implements IAudioPlayer, IProgressiveMediaPlayer
	{
		/**
		 * @private
		 */
		protected static const NO_SOUND_SOURCE_PLAY_ERROR:String = "Cannot play media when soundSource property has not been set.";

		/**
		 * The default <code>IStyleProvider</code> for all
		 * <code>SoundPlayer</code> components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function SoundPlayer()
		{
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return SoundPlayer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _sound:Sound;

		/**
		 * The <code>flash.media.Sound</code> object that has loaded the
		 * content specified by <code>soundSource</code>.
		 *
		 * @see #soundSource
		 */
		public function get sound():Sound
		{
			return this._sound;
		}

		/**
		 * @private
		 */
		protected var _soundChannel:SoundChannel;

		/**
		 * The currently playing <code>flash.media.SoundChannel</code>.
		 */
		public function get soundChannel():SoundChannel
		{
			return this._soundChannel;
		}

		/**
		 * @private
		 */
		protected var _soundSource:Object;

		/**
		 * A URL specified as a <code>String</code> representing a URL, a
		 * <code>flash.net.URLRequest</code>, or a
		 * <code>flash.media.Sound</code> object. In the case of a
		 * <code>String</code> or a <code>URLRequest</code>, a new
		 * <code>flash.media.Sound</code> object will be created internally and
		 * the content will by loaded automatically.
		 *
		 * <p>In the following example, a sound file URL is passed in:</p>
		 *
		 * <listing version="3.0">
		 * soundPlayer.soundSource = "http://example.com/sound.mp3";</listing>
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/net/URLRequest.html flash.net.URLRequest
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/Sound.html flash.media.Sound
		 * @see #soundLoaderContext
		 */
		public function get soundSource():Object
		{
			return this._soundSource;
		}

		/**
		 * @private
		 */
		public function set soundSource(value:Object):void
		{
			if(this._soundSource === value)
			{
				return;
			}
			if(this._isPlaying)
			{
				this.stop();
			}
			this._soundSource = value;
			//reset the current and total time if we were playing a different
			//sound previously
			if(this._currentTime != 0)
			{
				this._currentTime = 0;
				this.dispatchEventWith(MediaPlayerEventType.CURRENT_TIME_CHANGE);
			}
			if(this._totalTime != 0)
			{
				this._totalTime = 0;
				this.dispatchEventWith(MediaPlayerEventType.TOTAL_TIME_CHANGE);
			}
			if(this._sound)
			{
				this.cleanupSound();
			}
			this._isLoaded = false;
			if(this._soundSource is String)
			{
				this.loadSourceFromURL(value as String);
			}
			else if(this._soundSource is URLRequest)
			{
				this.loadSourceFromURLRequest(URLRequest(value));
			}
			else if(this._soundSource is Sound)
			{
				this._sound = Sound(this._soundSource);
				var newTotalTime:Number = this._sound.length / 1000;
				if(this._totalTime != newTotalTime)
				{
					this._totalTime = newTotalTime;
					this.dispatchEventWith(MediaPlayerEventType.TOTAL_TIME_CHANGE);
				}
				if(this._sound.isBuffering)
				{
					this._sound.addEventListener(IOErrorEvent.IO_ERROR, sound_errorHandler);
					this._sound.addEventListener(ProgressEvent.PROGRESS, sound_progressHandler);
					this._sound.addEventListener(flash.events.Event.COMPLETE, sound_completeHandler);
					this._sound.addEventListener(flash.events.Event.ID3, sound_id3Handler);
				}
			}
			else if(this._soundSource === null)
			{
				this._sound = null;
			}
			else
			{
				throw new ArgumentError("Invalid source type for SoundPlayer. Expected a URL as a String, an URLRequest, a Sound object, or null.");
			}
			if(this._autoPlay && this._sound)
			{
				this.play();
			}
		}

		/**
		 * @private
		 */
		protected var _isLoading:Boolean = false;

		/**
		 * Indicates if the <code>flash.media.Sound</code> object is currently
		 * loading its content.
		 */
		public function get isLoading():Boolean
		{
			return this._isLoading;
		}

		/**
		 * @private
		 */
		protected var _isLoaded:Boolean = false;

		/**
		 * Indicates if the <code>flash.media.Sound</code> object has finished
		 * loading its content.
		 *
		 * @see #event:loadProgress feathers.events.MediaPlayerEventType.LOAD_PROGRESS
		 * @see #event:loadComplete feathers.events.MediaPlayerEventType.LOAD_COMPLETE
		 */
		public function get isLoaded():Boolean
		{
			return this._isLoaded;
		}

		/**
		 * @copy feathers.media.IProgressiveMediaPlayer#bytesLoaded
		 *
		 * @see #bytesTotal
		 * @see #event:loadProgress feathers.events.MediaPlayerEventType.LOAD_PROGRESS
		 */
		public function get bytesLoaded():uint
		{
			if(!this._sound)
			{
				return 0;
			}
			return this._sound.bytesLoaded;
		}

		/**
		 * @copy feathers.media.IProgressiveMediaPlayer#bytesTotal
		 *
		 * @see #bytesLoaded
		 * @see #event:loadProgress feathers.events.MediaPlayerEventType.LOAD_PROGRESS
		 */
		public function get bytesTotal():uint
		{
			if(!this._sound)
			{
				return 0;
			}
			return this._sound.bytesTotal;
		}

		/**
		 * @private
		 */
		protected var _soundTransform:SoundTransform;

		/**
		 * @inheritDoc
		 *
		 * <p>In the following example, the audio is muted:</p>
		 *
		 * <listing version="3.0">
		 * soundPlayer.soundTransform = new SoundTransform(0);</listing>
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/SoundTransform.html flash.media.SoundTransform
		 * @see #event:soundTransformChange feathers.events.MediaPlayerEventType.SOUND_TRANSFORM_CHANGE
		 */
		public function get soundTransform():SoundTransform
		{
			if(!this._soundTransform)
			{
				this._soundTransform = new SoundTransform();
			}
			return this._soundTransform;
		}

		/**
		 * @private
		 */
		public function set soundTransform(value:SoundTransform):void
		{
			this._soundTransform = value;
			if(this._soundChannel)
			{
				this._soundChannel.soundTransform = this._soundTransform;
			}
			this.dispatchEventWith(MediaPlayerEventType.SOUND_TRANSFORM_CHANGE);
		}

		/**
		 * @private
		 */
		protected var _autoPlay:Boolean = true;

		/**
		 * Determines if the sound starts playing immediately when the
		 * <code>soundSource</code> property is set.
		 *
		 * <p>In the following example, automatic playback is disabled:</p>
		 *
		 * <listing version="3.0">
		 * soundPlayer.autoPlay = false;</listing>
		 *
		 * @see #soundSource
		 */
		public function get autoPlay():Boolean
		{
			return this._autoPlay;
		}

		/**
		 * @private
		 */
		public function set autoPlay(value:Boolean):void
		{
			this._autoPlay = value;
		}

		/**
		 * @private
		 */
		protected var _loop:Boolean = false;

		/**
		 * Determines if, upon reaching the end of the sound, the playhead
		 * automatically returns to the start of the media and plays again.
		 *
		 * <p>If <code>loop</code> is <code>true</code>, the
		 * <code>autoRewind</code> property will be ignored because looping will
		 * always automatically rewind to the beginning.</p>
		 *
		 * <p>In the following example, looping is enabled:</p>
		 *
		 * <listing version="3.0">
		 * soundPlayer.loop = true;</listing>
		 */
		public function get loop():Boolean
		{
			return this._loop;
		}

		/**
		 * @private
		 */
		public function set loop(value:Boolean):void
		{
			this._loop = value;
		}

		/**
		 * @private
		 */
		protected var _soundLoaderContext:SoundLoaderContext = null;

		/**
		 * If a custom <code>SoundLoaderContext</code> is provided, it will be
		 * passed to the <code>load()</code> method of the
		 * <code>flash.media.Sound</code> when loading a sound from a URL.
		 *
		 * <p>This property must be set before the <code>soundSource</code>
		 * property.</p>
		 *
		 * <p>In the following example, a custom
		 * <code>SoundLoaderContext</code> is used:</p>
		 *
		 * <listing version="3.0">
		 * soundPlayer.soundLoaderContext = new SoundLoaderContext(1000, true);</listing>
		 *
		 * @see #soundSource
		 */
		public function get soundLoaderContext():SoundLoaderContext
		{
			return this._soundLoaderContext;
		}

		/**
		 * @private
		 */
		public function set soundLoaderContext(value:SoundLoaderContext):void
		{
			this._soundLoaderContext = value;
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.soundSource = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override public function play():void
		{
			if(this._sound === null)
			{
				return;
			}
			super.play();
		}

		/**
		 * @private
		 */
		override protected function playMedia():void
		{
			if(!this._soundSource)
			{
				throw new IllegalOperationError(NO_SOUND_SOURCE_PLAY_ERROR);
			}
			if(!this._sound.isBuffering && this._currentTime == this._totalTime)
			{
				//flash.events.Event.SOUND_COMPLETE may not be dispatched (or
				//maybe it is dispatched, but before the listener can be added)
				//if currentTime is equal to totalTime, so we need to do it
				//manually.
				this.handleSoundComplete();
				return;
			}
			if(!this._soundTransform)
			{
				this._soundTransform = new SoundTransform();
			}
			this._soundChannel = this._sound.play(this._currentTime * 1000, 0, this._soundTransform);
			this._soundChannel.addEventListener(flash.events.Event.SOUND_COMPLETE, soundChannel_soundCompleteHandler);
			this.addEventListener(Event.ENTER_FRAME, soundPlayer_enterFrameHandler);
		}

		/**
		 * @private
		 */
		override protected function pauseMedia():void
		{
			if(!this._soundChannel)
			{
				//this could be null when seeking
				return;
			}
			this.removeEventListener(Event.ENTER_FRAME, soundPlayer_enterFrameHandler);
			this._soundChannel.stop();
			this._soundChannel.removeEventListener(flash.events.Event.SOUND_COMPLETE, soundChannel_soundCompleteHandler);
			this._soundChannel = null;
		}

		/**
		 * @private
		 */
		override protected function seekMedia(seconds:Number):void
		{
			this.pauseMedia();
			this._currentTime = seconds;
			if(this._isPlaying)
			{
				this.playMedia();
			}
		}

		/**
		 * @private
		 */
		protected function handleSoundComplete():void
		{
			//return to the beginning
			this.stop();
			this.dispatchEventWith(Event.COMPLETE);
			if(this._loop)
			{
				this.play();
			}
		}

		/**
		 * @private
		 */
		protected function loadSourceFromURL(url:String):void
		{
			this.loadSourceFromURLRequest(new URLRequest(url));
		}

		/**
		 * @private
		 */
		protected function loadSourceFromURLRequest(request:URLRequest):void
		{
			this._isLoading = true;
			if(this._sound)
			{
				this.cleanupSound();
			}
			this._sound = new Sound();
			this._sound.addEventListener(IOErrorEvent.IO_ERROR, sound_errorHandler);
			this._sound.addEventListener(ProgressEvent.PROGRESS, sound_progressHandler);
			this._sound.addEventListener(flash.events.Event.COMPLETE, sound_completeHandler);
			this._sound.addEventListener(flash.events.Event.ID3, sound_id3Handler);
			this._sound.load(request, this._soundLoaderContext);
		}

		/**
		 * @private
		 */
		protected function cleanupSound():void
		{
			if(!this._sound)
			{
				return;
			}
			this._sound.removeEventListener(IOErrorEvent.IO_ERROR, sound_errorHandler);
			this._sound.removeEventListener(ProgressEvent.PROGRESS, sound_progressHandler);
			this._sound.removeEventListener(flash.events.Event.COMPLETE, sound_completeHandler);
			this._sound.removeEventListener(flash.events.Event.ID3, sound_id3Handler);
			this._sound = null;
		}

		/**
		 * @private
		 */
		protected function soundPlayer_enterFrameHandler(event:Event):void
		{
			this._currentTime = this._soundChannel.position / 1000;
			this.dispatchEventWith(MediaPlayerEventType.CURRENT_TIME_CHANGE);
		}

		/**
		 * @private
		 * This isn't when the sound finishes playing. It's when the sound has
		 * finished loading.
		 */
		protected function sound_completeHandler(event:flash.events.Event):void
		{
			this._totalTime = this._sound.length / 1000;
			this.dispatchEventWith(MediaPlayerEventType.TOTAL_TIME_CHANGE);
			this._isLoading = false;
			this._isLoaded = true;
			this.dispatchEventWith(MediaPlayerEventType.LOAD_COMPLETE);
		}

		/**
		 * @private
		 */
		protected function sound_id3Handler(event:flash.events.Event):void
		{
			this.dispatchEventWith(MediaPlayerEventType.METADATA_RECEIVED, false, this._sound.id3);
		}

		/**
		 * @private
		 */
		protected function sound_progressHandler(event:ProgressEvent):void
		{
			var oldTotalTime:Number = this._totalTime;
			this._totalTime = this._sound.length / 1000;
			if(oldTotalTime != this._totalTime)
			{
				this.dispatchEventWith(MediaPlayerEventType.TOTAL_TIME_CHANGE);
			}
			this.dispatchEventWith(MediaPlayerEventType.LOAD_PROGRESS, false, event.bytesLoaded / event.bytesTotal);
		}

		/**
		 * @private
		 */
		protected function sound_errorHandler(event:ErrorEvent):void
		{
			//since it's just a string in both cases, we'll reuse event.type for
			//the Starling event.
			this.dispatchEventWith(event.type, false, event);
		}

		/**
		 * @private
		 */
		protected function soundChannel_soundCompleteHandler(event:flash.events.Event):void
		{
			this.handleSoundComplete();
		}
	}
}


================================================
FILE: source/feathers/media/SpectrumBarGraphVisualizer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	import feathers.core.FeathersControl;
	import feathers.events.MediaPlayerEventType;
	import feathers.skins.IStyleProvider;

	import flash.media.SoundMixer;
	import flash.utils.ByteArray;

	import starling.display.MeshBatch;
	import starling.display.Quad;
	import starling.events.Event;

	/**
	 * The number of bars to display in the graph.
	 *
	 * <p>In the following example, 32 bars are displayed:</p>
	 *
	 * <listing version="3.0">
	 * graph.barCount = 32;</listing>
	 *
	 * @default 16
	 */
	[Style(name="barCount",type="Number")]

	/**
	 * The color of the bars in the graph.
	 *
	 * <p>In the following example, the bar color is customized:</p>
	 *
	 * <listing version="3.0">
	 * graph.color = 0xff0000;</listing>
	 *
	 * @default 0
	 */
	[Style(name="color",type="Number")]

	/**
	 * The gap, in pixels, between the bars in the graph.
	 *
	 * <p>In the following example, the gap is set to 10 pixels:</p>
	 *
	 * <listing version="3.0">
	 * graph.gap = 10;</listing>
	 *
	 * @default 0
	 */
	[Style(name="gap",type="Number")]

	/**
	 * A visualization of the audio spectrum of the runtime's currently playing
	 * audio content.
	 *
	 * @see ../../../help/sound-player.html How to use the Feathers SoundPlayer component
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class SpectrumBarGraphVisualizer extends FeathersControl implements IMediaPlayerControl
	{
		/**
		 * The default <code>IStyleProvider</code> for all
		 * <code>SpectrumBarGraphVisualizer</code> components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static var HELPER_QUAD:Quad = new Quad(1, 1);

		/**
		 * @private
		 */
		protected static const MAX_BAR_COUNT:int = 256;

		/**
		 * Constructor
		 */
		public function SpectrumBarGraphVisualizer()
		{
			this.isQuickHitAreaEnabled = true;
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return SpectrumBarGraphVisualizer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _bars:MeshBatch;

		/**
		 * @private
		 */
		protected var _bytes:ByteArray = new ByteArray();

		/**
		 * @private
		 */
		protected var _barValues:Vector.<Number> = new <Number>[];

		/**
		 * @private
		 */
		protected var _barCount:int = 16;

		/**
		 * @private
		 */
		public function get barCount():int
		{
			return this._barCount;
		}

		/**
		 * @private
		 */
		public function set barCount(value:int):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(value > MAX_BAR_COUNT)
			{
				value = MAX_BAR_COUNT;
			}
			else if(value < 1)
			{
				value = 1;
			}
			if(this._barCount == value)
			{
				return;
			}
			this._barCount = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _gap:Number = 0;

		/**
		 * @private
		 */
		public function get gap():Number
		{
			return this._gap;
		}

		/**
		 * @private
		 */
		public function set gap(value:Number):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._gap == value)
			{
				return;
			}
			this._gap = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _color:uint = 0x000000;

		/**
		 * @private
		 */
		public function get color():uint
		{
			return this._color;
		}

		/**
		 * @private
		 */
		public function set color(value:uint):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._color == value)
			{
				return;
			}
			this._color = value;
			this.invalidate(INVALIDATION_FLAG_STYLES);
		}

		/**
		 * @private
		 */
		protected var _mediaPlayer:ITimedMediaPlayer;

		/**
		 * @inheritDoc
		 */
		public function get mediaPlayer():IMediaPlayer
		{
			return this._mediaPlayer;
		}

		/**
		 * @private
		 */
		public function set mediaPlayer(value:IMediaPlayer):void
		{
			if(this._mediaPlayer == value)
			{
				return;
			}
			if(this._mediaPlayer)
			{
				this._mediaPlayer.removeEventListener(MediaPlayerEventType.PLAYBACK_STATE_CHANGE, mediaPlayer_playbackStateChange);
			}
			this._mediaPlayer = value as ITimedMediaPlayer;
			if(this._mediaPlayer)
			{
				this.handlePlaybackStateChange();
				this._mediaPlayer.addEventListener(MediaPlayerEventType.PLAYBACK_STATE_CHANGE, mediaPlayer_playbackStateChange);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.mediaPlayer = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this._bars = new MeshBatch();
			this.addChild(this._bars);
		}

		/**
		 * @private
		 */
		override protected function draw():void
		{
			this.autoSizeIfNeeded();
			this.layoutBarGraph();
			super.draw();
		}

		/**
		 * @private
		 */
		protected function autoSizeIfNeeded():Boolean
		{
			var needsWidth:Boolean = this._explicitWidth !== this._explicitWidth; //isNaN
			var needsHeight:Boolean = this._explicitHeight !== this._explicitHeight; //isNaN
			if(!needsWidth && !needsHeight)
			{
				return false;
			}
			var newWidth:Number = this._explicitWidth;
			if(needsWidth)
			{
				newWidth = this._barCount * (this._gap + 1) - this._gap;
			}
			var newHeight:Number = this._explicitHeight;
			if(needsHeight)
			{
				newHeight = 10;
			}
			return this.saveMeasurements(newWidth, newHeight, newWidth, newHeight);
		}

		/**
		 * @private
		 */
		protected function layoutBarGraph():void
		{
			this._bars.clear();
			if(!this._mediaPlayer.isPlaying)
			{
				return;
			}
			var barCount:int = this._barCount;
			var barWidth:Number = ((this.actualWidth + this._gap) / barCount) - this._gap;
			if(barWidth < 0 || this.actualHeight <= 0)
			{
				return;
			}

			SoundMixer.computeSpectrum(this._bytes, true, 0);

			this._barValues.length = barCount;
			var valuesPerBar:int = 256 / barCount;
			//read left values
			for(var i:int = 0; i < barCount; i++)
			{
				//reset to zero first
				this._barValues[i] = 0;
				for(var j:int = 0; j < valuesPerBar; j++)
				{
					var float:Number = this._bytes.readFloat();
					if(float > 1)
					{
						float = 1;
					}
					this._barValues[i] += float;
				}
			}
			//read right values
			this._bytes.position = 1024;
			for(i = 0; i < barCount; i++)
			{
				for(j = 0; j < valuesPerBar; j++)
				{
					float = this._bytes.readFloat();
					if(float > 1)
					{
						float = 1;
					}
					this._barValues[i] += float;
				}
				//calculate the average
				this._barValues[i] /= (2 * valuesPerBar);
			}

			var xPosition:Number = 0;
			var maxHeight:Number = this.actualHeight - 1;
			HELPER_QUAD.color = this._color;
			for(i = 0; i < barCount; i++)
			{
				HELPER_QUAD.x = xPosition;
				HELPER_QUAD.width = barWidth;
				HELPER_QUAD.height = Math.floor(maxHeight * this._barValues[i]);
				HELPER_QUAD.y = maxHeight - HELPER_QUAD.height;
				this._bars.addMesh(HELPER_QUAD);
				xPosition += barWidth + this._gap;
			}
		}

		/**
		 * @private
		 */
		protected function handlePlaybackStateChange():void
		{
			if(this._mediaPlayer.isPlaying)
			{
				this.addEventListener(Event.ENTER_FRAME, peakVisualizer_enterFrameHandler);
			}
			else
			{
				this.removeEventListener(Event.ENTER_FRAME, peakVisualizer_enterFrameHandler);
			}
		}

		/**
		 * @private
		 */
		protected function mediaPlayer_playbackStateChange(event:Event):void
		{
			this.handlePlaybackStateChange();
		}

		/**
		 * @private
		 */
		protected function peakVisualizer_enterFrameHandler(event:Event):void
		{
			this.invalidate(INVALIDATION_FLAG_DATA);
		}
	}
}


================================================
FILE: source/feathers/media/TimeLabel.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	import feathers.controls.Label;
	import feathers.events.MediaPlayerEventType;
	import feathers.skins.IStyleProvider;

	import flash.geom.Point;

	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * When the value of <code>displayMode</code> is
	 * <code>MediaTimeMode.CURRENT_AND_TOTAL_TIMES</code>, this text is
	 * inserted between the two times to separate them.
	 *
	 * @default " / "
	 *
	 * @see feathers.media.MediaTimeMode#CURRENT_AND_TOTAL_TIMES
	 */
	[Style(name="delimiter",type="String")]

	/**
	 * Determines how the time is displayed by the label.
	 *
	 * @default feathers.media.MediaTimeMode.CURRENT_AND_TOTAL_TIMES
	 *
	 * @see feathers.media.MediaTimeMode#CURRENT_AND_TOTAL_TIMES
	 * @see feathers.media.MediaTimeMode#CURRENT_TIME
	 * @see feathers.media.MediaTimeMode#TOTAL_TIME
	 * @see feathers.media.MediaTimeMode#REMAINING_TIME
	 */
	[Style(name="displayMode",type="String")]

	/**
	 * If the <code>displayMode</code> property is set to
	 * <code>MediaTimeMode.CURRENT_TIME</code> or
	 * <code>MediaTimeMode.REMAINING_TIME</code>, and this property
	 * is set to <code>true</code>, the label will switch to displaying the
	 * current time and the remaining time, if tapped or clicked. If the
	 * <code>displayMode</code> property is not set to one of the specified
	 * values, this property is ignored.
	 *
	 * @default false
	 *
	 * @see #style:displayMode
	 */
	[Style(name="toggleDisplayMode",type="Boolean")]

	/**
	 * A specialized label that can display the current playhead time, total
	 * time, remaining time, or a combined current and total time for a media
	 * player.
	 *
	 * @see ../../../help/sound-player.html How to use the Feathers SoundPlayer component
	 * @see ../../../help/video-player.html How to use the Feathers VideoPlayer component
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class TimeLabel extends Label implements IMediaPlayerControl
	{
		/**
		 * The default <code>IStyleProvider</code> for all
		 * <code>TimeLabel</code> components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function TimeLabel()
		{
			this.addEventListener(TouchEvent.TOUCH, timeLabel_touchHandler);
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			if(TimeLabel.globalStyleProvider)
			{
				return TimeLabel.globalStyleProvider;
			}
			return Label.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _mediaPlayer:ITimedMediaPlayer;

		/**
		 * @inheritDoc
		 */
		public function get mediaPlayer():IMediaPlayer
		{
			return this._mediaPlayer;
		}

		/**
		 * @private
		 */
		public function set mediaPlayer(value:IMediaPlayer):void
		{
			if(this._mediaPlayer == value)
			{
				return;
			}
			if(this._mediaPlayer)
			{
				this._mediaPlayer.removeEventListener(MediaPlayerEventType.CURRENT_TIME_CHANGE, mediaPlayer_currentTimeChangeHandler);
				this._mediaPlayer.removeEventListener(MediaPlayerEventType.TOTAL_TIME_CHANGE, mediaPlayer_totalTimeChangeHandler);
			}
			this._mediaPlayer = value as ITimedMediaPlayer;
			if(this._mediaPlayer)
			{
				this._mediaPlayer.addEventListener(MediaPlayerEventType.CURRENT_TIME_CHANGE, mediaPlayer_currentTimeChangeHandler);
				this._mediaPlayer.addEventListener(MediaPlayerEventType.TOTAL_TIME_CHANGE, mediaPlayer_totalTimeChangeHandler);
			}
			this.updateText();
		}

		/**
		 * @private
		 */
		protected var _delimiter:String = " / ";

		/**
		 * @private
		 */
		public function get delimiter():String
		{
			return this._delimiter;
		}

		/**
		 * @private
		 */
		public function set delimiter(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._delimiter === value)
			{
				return;
			}
			this._delimiter = value;
			this.updateText();
		}

		/**
		 * @private
		 */
		protected var _displayMode:String = MediaTimeMode.CURRENT_AND_TOTAL_TIMES;

		[Inspectable(type="String",enumeration="currentAndTotalTimes,currentTime,totalTime,remainingTime")]
		/**
		 * @private
		 */
		public function get displayMode():String
		{
			return this._displayMode;
		}

		/**
		 * @private
		 */
		public function set displayMode(value:String):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._displayMode === value)
			{
				return;
			}
			this._displayMode = value;
			//reset this value because it would be unexpected for the label
			//not to change when changing this property.
			this._isToggled = false;
			this.updateText();
		}

		/**
		 * @private
		 */
		protected var _isToggled:Boolean = false;

		/**
		 * @private
		 */
		protected var touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _toggleDisplayMode:Boolean = false;

		/**
		 * @private
		 */
		public function get toggleDisplayMode():Boolean
		{
			return this._toggleDisplayMode;
		}

		/**
		 * @private
		 */
		public function set toggleDisplayMode(value:Boolean):void
		{
			if(this.processStyleRestriction(arguments.callee))
			{
				return;
			}
			if(this._toggleDisplayMode === value)
			{
				return;
			}
			this._toggleDisplayMode = value;
			this._isToggled = false;
		}

		/**
		 * @private
		 */
		protected function updateText():void
		{
			var currentTime:Number = this._mediaPlayer ? this._mediaPlayer.currentTime : 0;
			var totalTime:Number = this._mediaPlayer ? this._mediaPlayer.totalTime : 0;
			var displayMode:String = this._displayMode;
			if(this._isToggled)
			{
				if(displayMode === MediaTimeMode.CURRENT_TIME)
				{
					displayMode = MediaTimeMode.REMAINING_TIME;
				}
				else
				{
					displayMode = MediaTimeMode.CURRENT_TIME;
				}
			}
			switch(displayMode)
			{
				case MediaTimeMode.CURRENT_TIME:
				{
					this.text = this.secondsToTimeString(currentTime);
					break;
				}
				case MediaTimeMode.TOTAL_TIME:
				{
					this.text = this.secondsToTimeString(totalTime);
					break;
				}
				case MediaTimeMode.REMAINING_TIME:
				{
					this.text = this.secondsToTimeString(currentTime - totalTime);
					break;
				}
				default:
				{
					this.text = this.secondsToTimeString(currentTime) + this._delimiter + this.secondsToTimeString(totalTime);
				}
			}
		}

		/**
		 * @private
		 */
		protected function secondsToTimeString(seconds:Number):String
		{
			var isNegative:Boolean = seconds < 0;
			if(isNegative)
			{
				seconds = -seconds;
			}
			var hours:int = int(seconds / 3600);
			seconds = int(seconds - (hours * 3600));
			var minutes:int = int(seconds / 60);
			seconds = int(seconds - (minutes * 60));
			var time:String = minutes + ":" + (seconds < 10 ? "0" : "") + seconds;
			if(hours > 0)
			{
				if(minutes < 10)
				{
					time = "0" + time;
				}
				time = hours + ":" + time;
			}
			if(isNegative)
			{
				time = "-" + time;
			}
			return time;
		}

		/**
		 * @private
		 */
		protected function mediaPlayer_currentTimeChangeHandler(event:Event):void
		{
			this.updateText();
		}

		/**
		 * @private
		 */
		protected function mediaPlayer_totalTimeChangeHandler(event:Event):void
		{
			this.updateText();
		}

		/**
		 * @private
		 */
		protected function timeLabel_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled || !this._toggleDisplayMode ||
				!(this._displayMode === MediaTimeMode.CURRENT_TIME || this._displayMode === MediaTimeMode.CURRENT_TIME))
			{
				this.touchPointID = -1;
				return;
			}

			if(this.touchPointID >= 0)
			{
				var touch:Touch = event.getTouch(this, null, this.touchPointID);
				if(!touch)
				{
					//this should never happen
					return;
				}

				if(touch.phase === TouchPhase.ENDED)
				{
					var point:Point = Pool.getPoint();
					touch.getLocation(this.stage, point);
					var isInBounds:Boolean = this.contains(this.stage.hitTest(point));
					Pool.putPoint(point);
					if(isInBounds)
					{
						this._isToggled = !this._isToggled;
						this.updateText();
					}
				}
				return;
			}
			else //if we get here, we don't have a saved touch ID yet
			{
				touch = event.getTouch(this, TouchPhase.BEGAN);
				if(touch)
				{
					this.touchPointID = touch.id;
					return;
				}
			}
		}
	}
}


================================================
FILE: source/feathers/media/VideoPlayer.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	import feathers.controls.AutoSizeMode;
	import feathers.controls.LayoutGroup;
	import feathers.core.PopUpManager;
	import feathers.events.FeathersEventType;
	import feathers.events.MediaPlayerEventType;
	import feathers.skins.IStyleProvider;

	import flash.display.Stage;
	import flash.display.StageDisplayState;
	import flash.errors.IllegalOperationError;
	import flash.events.FullScreenEvent;
	import flash.events.IOErrorEvent;
	import flash.events.NetStatusEvent;
	import flash.media.SoundTransform;
	import flash.net.NetConnection;
	import flash.net.NetStream;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.rendering.Painter;
	import starling.textures.Texture;

	/**
	 * Dispatched when the original native width or height of the video content
	 * is calculated.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #nativeWidth
	 * @see #nativeHeight
	 *
	 * @eventType feathers.events.MediaPlayerEventType.DIMENSIONS_CHANGE
	 */
	[Event(name="dimensionsChange",type="starling.events.Event")]

	/**
	 * Dispatched when the media player changes to the full-screen display mode
	 * or back to the normal display mode. The value of the
	 * <code>isFullScreen</code> property indicates if the media player is
	 * displayed in full screen mode or normally.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #isFullScreen
	 * @see #toggleFullScreen()
	 *
	 * @eventType feathers.events.MediaPlayerEventType.DISPLAY_STATE_CHANGE
	 */
	[Event(name="displayStateChange",type="starling.events.Event")]

	/**
	 * Dispatched when the media player's sound transform changes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #soundTransform
	 *
	 * @eventType feathers.events.MediaPlayerEventType.SOUND_TRANSFORM_CHANGE
	 */
	[Event(name="soundTransformChange",type="starling.events.Event")]

	/**
	 * Dispatched when the video metadata becomes available with the
	 * <code>onMetaData</code> callback from the <code>NetStream</code> instance.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The metadata object passed with the
	 *   <code>onMetaData</code> callback from the <code>NetStream</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/net/NetStream.html#event:onMetaData flash.net.NetStream onMetaData callback
	 *
	 * @eventType feathers.events.MediaPlayerEventType.METADATA_RECEIVED
	 */
	[Event(name="metadataReceived",type="starling.events.Event")]

	/**
	 * Dispatched when a cue point is reached with the <code>onCuePoint</code>
	 * callback from the <code>NetStream</code> instance.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The cue point object passed with the
	 *   <code>onCuePoint</code> callback from the <code>NetStream</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/net/NetStream.html#event:onCuePoint flash.net.NetStream onCuePoint callback
	 *
	 * @eventType feathers.events.MediaPlayerEventType.CUE_POINT
	 */
	[Event(name="metadataReceived",type="starling.events.Event")]

	/**
	 * Dispatched when the video texture is ready to be rendered. Indicates that
	 * the <code>texture</code> property will return a
	 * <code>starling.textures.Texture</code> that may be displayed in an
	 * <code>ImageLoader</code> or another component.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #texture
	 *
	 * @eventType starling.events.Event.READY
	 */
	[Event(name="ready",type="starling.events.Event")]

	/**
	 * Dispatched when the video texture is no longer valid. Indicates that
	 * the <code>texture</code> property will return a <code>null</code> value,
	 * and that that the previous texture has been disposed and should not be
	 * rendered any more.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #texture
	 *
	 * @eventType feathers.events.FeathersEventType.CLEAR
	 */
	[Event(name="clear",type="starling.events.Event")]

	/**
	 * Dispatched periodically when a media player's content is loading to
	 * indicate the current progress. The <code>bytesLoaded</code> and
	 * <code>bytesTotal</code> properties may be accessed to determine the
	 * exact number of bytes loaded.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>A numeric value between <code>0</code>
	 *   and <code>1</code> that indicates how much of the media has loaded so far.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #bytesLoaded
	 * @see #bytesTotal
	 *
	 * @eventType feathers.events.MediaPlayerEventType.LOAD_PROGRESS
	 */
	[Event(name="loadProgress",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>flash.net.NetStream</code> object dispatches
	 * <code>flash.events.IOErrorEvent.IO_ERROR</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The <code>flash.events.IOErrorEvent</code>
	 *   dispatched by the <code>flash.net.NetStream</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/net/NetStream.html#event:ioError flash.net.NetStream: flash.events.IOErrorEvent.IO_ERROR
	 *
	 * @eventType starling.events.Event.IO_ERROR
	 */
	[Event(name="ioError",type="starling.events.Event")]

	/**
	 * Dispatched when the <code>flash.net.NetStream</code> object dispatches
	 * <code>flash.events.NetStatusEvent.NET_STATUS</code> with certain error
	 * codes.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The code from the event.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.ERROR
	 */
	[Event(name="error",type="starling.events.Event")]

	/**
	 * Controls playback of video with a <code>flash.net.NetStream</code> object.
	 *
	 * @see ../../../help/video-player.html How to use the Feathers VideoPlayer component
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class VideoPlayer extends BaseTimedMediaPlayer implements IVideoPlayer, IProgressiveMediaPlayer
	{
		/**
		 * @private
		 */
		protected static const NET_STATUS_CODE_NETCONNECTION_CONNECT_SUCCESS:String = "NetConnection.Connect.Success";

		/**
		 * @private
		 */
		protected static const NET_STATUS_CODE_NETSTREAM_PLAY_START:String = "NetStream.Play.Start";

		/**
		 * @private
		 */
		protected static const NET_STATUS_CODE_NETSTREAM_PLAY_STOP:String = "NetStream.Play.Stop";

		/**
		 * @private
		 */
		protected static const NET_STATUS_CODE_NETSTREAM_PLAY_STREAMNOTFOUND:String = "NetStream.Play.StreamNotFound";

		/**
		 * @private
		 */
		protected static const NET_STATUS_CODE_NETSTREAM_PLAY_NOSUPPORTEDTRACKFOUND:String = "NetStream.Play.NoSupportedTrackFound";

		/**
		 * @private
		 */
		protected static const NO_VIDEO_SOURCE_PLAY_ERROR:String = "Cannot play media when videoSource property has not been set.";

		/**
		 * @private
		 */
		protected static const NO_VIDEO_SOURCE_PAUSE_ERROR:String = "Cannot pause media when videoSource property has not been set.";

		/**
		 * @private
		 */
		protected static const NO_VIDEO_SOURCE_SEEK_ERROR:String = "Cannot seek media when videoSource property has not been set.";

		/**
		 * The default <code>IStyleProvider</code> for all
		 * <code>VideoPlayer</code> components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * @private
		 */
		protected static function defaultNetConnectionFactory():NetConnection
		{
			var connection:NetConnection = new NetConnection();
			connection.connect(null);
			return connection;
		}

		/**
		 * @private
		 */
		protected static function defaultNetStreamFactory(netConnection:NetConnection):NetStream
		{
			return new NetStream(netConnection);
		}

		/**
		 * Constructor.
		 */
		public function VideoPlayer()
		{
			super();
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return VideoPlayer.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _fullScreenContainer:LayoutGroup;

		/**
		 * @private
		 */
		protected var _ignoreDisplayListEvents:Boolean = false;

		/**
		 * @private
		 */
		protected var _soundTransform:SoundTransform;

		/**
		 * @inheritDoc
		 *
		 * <p>In the following example, the audio is muted:</p>
		 *
		 * <listing version="3.0">
		 * videoPlayer.soundTransform = new SoundTransform(0);</listing>
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/media/SoundTransform.html flash.media.SoundTransform
		 * @see #event:soundTransformChange feathers.events.MediaPlayerEventType.SOUND_TRANSFORM_CHANGE
		 */
		public function get soundTransform():SoundTransform
		{
			if(!this._soundTransform)
			{
				this._soundTransform = new SoundTransform();
			}
			return this._soundTransform;
		}

		/**
		 * @private
		 */
		public function set soundTransform(value:SoundTransform):void
		{
			this._soundTransform = value;
			if(this._netStream)
			{
				this._netStream.soundTransform = this._soundTransform;
			}
			this.dispatchEventWith(MediaPlayerEventType.SOUND_TRANSFORM_CHANGE);
		}

		/**
		 * @private
		 */
		protected var _isWaitingForTextureReady:Boolean = false;

		/**
		 * @private
		 */
		protected var _texture:Texture;

		/**
		 * The texture used to display the video. This texture is not
		 * automatically rendered by the <code>VideoPlayer</code> component. A
		 * component like an <code>ImageLoader</code> should be added as a child
		 * of the <code>VideoPlayer</code> to display the texture when it is
		 * ready.
		 *
		 * <p>The <code>texture</code> property will initially return
		 * <code>null</code>. Listen for <code>Event.READY</code> to know when
		 * a valid texture is available to render.</p>
		 *
		 * <p>In the following example, a listener is added for
		 * <code>Event.READY</code>, and the texture is displayed by an
		 * <code>ImageLoader</code> component:</p>
		 *
		 * <listing version="3.0">
		 * function videoPlayer_readyHandler( event:Event ):void
		 * {
		 *     var view:ImageLoader = new ImageLoader();
		 *     view.source = videoPlayer.texture;
		 *     videoPlayer.addChildAt(view, 0);
		 * }
		 * 
		 * videoPlayer.addEventListener( Event.READY, videoPlayer_readyHandler );</listing>
		 *
		 * @see #event:ready starling.events.Event.READY
		 * @see feathers.controls.ImageLoader
		 */
		public function get texture():Texture
		{
			//there can be runtime errors if the texture is rendered before it
			//is ready, so we must return null until we're sure it's safe
			if(this._isWaitingForTextureReady)
			{
				return null;
			}
			return this._texture;
		}

		/**
		 * @inheritDoc
		 *
		 * @see #event:dimensionsChange feathers.events.MediaPlayerEventType.DIMENSIONS_CHANGE
		 */
		public function get nativeWidth():Number
		{
			if(this._texture)
			{
				return this._texture.nativeWidth;
			}
			return 0;
		}

		/**
		 * @inheritDoc
		 *
		 * @see #event:dimensionsChange feathers.events.MediaPlayerEventType.DIMENSIONS_CHANGE
		 */
		public function get nativeHeight():Number
		{
			if(this._texture)
			{
				return this._texture.nativeHeight;
			}
			return 0;
		}

		/**
		 * @private
		 */
		protected var _netConnection:NetConnection;

		/**
		 * @private
		 */
		protected var _netStream:NetStream;

		/**
		 * The <code>flash.net.NetStream</code> object used to play the video.
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/net/NetStream.html flash.net.NetStream
		 */
		public function get netStream():NetStream
		{
			return this._netStream;
		}

		/**
		 * @private
		 */
		protected var _hasPlayedToEnd:Boolean = false;

		/**
		 * @private
		 */
		protected var _videoSource:String;

		/**
		 * A string representing the video URL or any other accepted value that
		 * may be passed to the <code>play()</code> function of a
		 * <code>NetStream</code> object.
		 *
		 * <p>In the following example, a video file URL is passed in:</p>
		 *
		 * <listing version="3.0">
		 * videoPlayer.videoSource = "http://example.com/video.m4v";</listing>
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/net/NetStream.html#play() Full description of flash.net.NetStream.play() in Adobe's Flash Platform API Reference
		 */
		public function get videoSource():String
		{
			return this._videoSource;
		}

		/**
		 * @private
		 */
		public function set videoSource(value:String):void
		{
			if(this._videoSource === value)
			{
				return;
			}
			if(this._isPlaying)
			{
				this.stop();
			}
			this.disposeNetStream();
			if(!value)
			{
				this.disposeNetConnection();
			}
			if(this._texture !== null)
			{
				this._texture.dispose();
				this._texture = null;
				this.dispatchEventWith(FeathersEventType.CLEAR);
			}
			this._videoSource = value;
			//reset the current and total time if we were playing a different
			//video previously
			if(this._currentTime != 0)
			{
				this._currentTime = 0;
				this.dispatchEventWith(MediaPlayerEventType.CURRENT_TIME_CHANGE);
			}
			if(this._totalTime != 0)
			{
				this._totalTime = 0;
				this.dispatchEventWith(MediaPlayerEventType.TOTAL_TIME_CHANGE);
			}
			//same with the bytes loaded and total
			this._bytesLoaded = 0;
			this._bytesTotal = 0;
			if(this._autoPlay && this._videoSource)
			{
				this.play();
			}
		}

		/**
		 * @private
		 */
		protected var _autoPlay:Boolean = true;

		/**
		 * Determines if the video starts playing immediately when the
		 * <code>videoSource</code> property is set.
		 *
		 * <p>In the following example, automatic playback is disabled:</p>
		 *
		 * <listing version="3.0">
		 * videoPlayer.autoPlay = false;</listing>
		 *
		 * @see #videoSource
		 */
		public function get autoPlay():Boolean
		{
			return this._autoPlay;
		}

		/**
		 * @private
		 */
		public function set autoPlay(value:Boolean):void
		{
			this._autoPlay = value;
		}

		/**
		 * @private
		 */
		protected var _isFullScreen:Boolean = false;

		/**
		 * Indicates if the video player is currently full screen or not. When
		 * the player is full screen, it will be displayed as a modal pop-up
		 * that fills the entire Starling stage. Depending on the value of
		 * <code>fullScreenDisplayState</code>, it may also change the value of
		 * the native stage's <code>displayState</code> property.
		 *
		 * @see #toggleFullScreen()
		 * @see #event:displayStateChange feathers.events.MediaPlayerEventType.DISPLAY_STATE_CHANGE
		 */
		public function get isFullScreen():Boolean
		{
			return this._isFullScreen;
		}

		/**
		 * @private
		 */
		protected var _normalDisplayState:String = StageDisplayState.NORMAL;

		[Inspectable(type="String",enumeration="fullScreenInteractive,fullScreen,normal")]
		/**
		 * When the video player is displayed normally (in other words, when it
		 * isn't full-screen), determines the value of the native stage's
		 * <code>displayState</code> property.
		 *
		 * <p>Using this property, it is possible to set the native stage's
		 * <code>displayState</code> property to
		 * <code>StageDisplayState.FULL_SCREEN_INTERACTIVE</code> or
		 * <code>StageDisplayState.FULL_SCREEN</code> when the video player
		 * is not in full screen mode. This might be useful for mobile apps that
		 * should always display in full screen, while allowing a video player
		 * to toggle between filling the entire stage and displaying at a
		 * smaller size within its parent's layout.</p>
		 *
		 * <p>In the following example, the display state for normal mode
		 * is changed:</p>
		 *
		 * <listing version="3.0">
		 * videoPlayer.fullScreenDisplayState = StageDisplayState.FULL_SCREEN_INTERACTIVE;</listing>
		 *
		 * @default StageDisplayState.NORMAL
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/display/StageDisplayState.html#FULL_SCREEN_INTERACTIVE StageDisplayState.FULL_SCREEN_INTERACTIVE
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/display/StageDisplayState.html#FULL_SCREEN StageDisplayState.FULL_SCREEN
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/display/StageDisplayState.html#NORMAL StageDisplayState.NORMAL
		 * @see #fullScreenDisplayState
		 */
		public function get normalDisplayState():String
		{
			return this._normalDisplayState;
		}

		/**
		 * @private
		 */
		public function set normalDisplayState(value:String):void
		{
			if(this._normalDisplayState == value)
			{
				return;
			}
			this._normalDisplayState = value;
			if(!this._isFullScreen && this.stage)
			{
				var starling:Starling = this.stage.starling;
				var nativeStage:Stage = starling.nativeStage;
				nativeStage.displayState = this._normalDisplayState;
			}
		}

		/**
		 * @private
		 */
		protected var _fullScreenDisplayState:String = StageDisplayState.FULL_SCREEN_INTERACTIVE;

		[Inspectable(type="String",enumeration="fullScreenInteractive,fullScreen,normal")]
		/**
		 * When the video player is displayed full-screen, determines the value
		 * of the native stage's <code>displayState</code> property.
		 *
		 * <p>Using this property, it is possible to set the native stage's
		 * <code>displayState</code> property to
		 * <code>StageDisplayState.NORMAL</code> when the video player is in
		 * full screen mode. The video player will still be displayed as a modal
		 * pop-up that fills the entire Starling stage, in this situation.</p>
		 *
		 * <p>In the following example, the display state for full-screen mode
		 * is changed:</p>
		 *
		 * <listing version="3.0">
		 * videoPlayer.fullScreenDisplayState = StageDisplayState.FULL_SCREEN;</listing>
		 *
		 * @default StageDisplayState.FULL_SCREEN_INTERACTIVE
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/display/StageDisplayState.html#FULL_SCREEN_INTERACTIVE StageDisplayState.FULL_SCREEN_INTERACTIVE
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/display/StageDisplayState.html#FULL_SCREEN StageDisplayState.FULL_SCREEN
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/display/StageDisplayState.html#NORMAL StageDisplayState.NORMAL
		 * @see #normalDisplayState
		 */
		public function get fullScreenDisplayState():String
		{
			return this._fullScreenDisplayState;
		}

		/**
		 * @private
		 */
		public function set fullScreenDisplayState(value:String):void
		{
			if(this._fullScreenDisplayState == value)
			{
				return;
			}
			this._fullScreenDisplayState = value;
			if(this._isFullScreen && this.stage)
			{
				var starling:Starling = this.stage.starling;
				var nativeStage:Stage = starling.nativeStage;
				nativeStage.displayState = this._fullScreenDisplayState;
			}
		}

		/**
		 * @private
		 */
		protected var _hideRootWhenFullScreen:Boolean = true;

		/**
		 * Determines if the Starling root display object is hidden when the
		 * video player switches to full screen mode. By hiding the root display
		 * object, rendering performance is optimized because Starling skips a
		 * portion of the display list that is obscured by the video player.
		 *
		 * <p>In the following example, the root display object isn't hidden
		 * when the video player is displayed in full screen:</p>
		 *
		 * <listing version="3.0">
		 * videoPlayer.hideRootWhenFullScreen = false;</listing>
		 *
		 * @default true
		 */
		public function get hideRootWhenFullScreen():Boolean
		{
			return this._hideRootWhenFullScreen;
		}

		/**
		 * @private
		 */
		public function set hideRootWhenFullScreen(value:Boolean):void
		{
			this._hideRootWhenFullScreen = value;
		}

		/**
		 * @private
		 */
		protected var _netConnectionFactory:Function = defaultNetConnectionFactory;

		/**
		 * Creates the <code>flash.net.NetConnection</code> object used to play
		 * the video, and calls the <code>connect()</code> method. By default, a
		 * value of <code>null</code> is passed to the <code>connect()</code>
		 * method. To pass different parameters, you may use a custom
		 * <code>netConnectionFactory</code>.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function():NetConnection</pre>
		 *
		 * <p>In the following example, a custom factory for the
		 * <code>NetConnection</code> is passed to the video player:</p>
		 *
		 * <listing version="3.0">
		 * videoPlayer.netConnectionFactory = function():NetConnection
		 * {
		 *     var connection:NetConnection = new NetConnection();
		 *     connection.connect( command );
		 *     return connection;
		 * };</listing>
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/net/NetConnection.html flash.net.NetConnection
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/net/NetConnection.html#connect() flash.net.NetConnection.connect()
		 */
		public function get netConnectionFactory():Function
		{
			return this._netConnectionFactory;
		}

		/**
		 * @private
		 */
		public function set netConnectionFactory(value:Function):void
		{
			if(this._netConnectionFactory === value)
			{
				return;
			}
			this._netConnectionFactory = value;
			this.stop();
			this.disposeNetStream();
			this.disposeNetConnection();
		}

		/**
		 * @private
		 */
		protected var _netStreamFactory:Function = defaultNetStreamFactory;

		/**
		 * Creates the <code>flash.net.NetStream</code> object used to play
		 * the video.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function(netConnection:NetConnection):NetStream</pre>
		 *
		 * <p>In the following example, a custom factory for the
		 * <code>NetStream</code> is passed to the video player:</p>
		 *
		 * <listing version="3.0">
		 * videoPlayer.netConnectionFactory = function(netConnection:NetConnection):NetStream
		 * {
		 *     var stream:NetStream = new NetStream(netConnection);
		 *     //change properties here
		 *     return stream;
		 * };</listing>
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/net/NetStream.html flash.net.NetStream
		 */
		public function get netStreamFactory():Function
		{
			return this._netStreamFactory;
		}

		/**
		 * @private
		 */
		public function set netStreamFactory(value:Function):void
		{
			if(this._netStreamFactory === value)
			{
				return;
			}
			this._netStreamFactory = value;
			this.stop();
			this.disposeNetStream();
			this.disposeNetConnection();
		}

		/**
		 * @private
		 */
		protected var _bytesLoaded:uint = 0;

		/**
		 * @copy feathers.media.IProgressiveMediaPlayer#bytesLoaded
		 *
		 * @see #bytesTotal
		 * @see #event:loadProgress feathers.events.MediaPlayerEventType.LOAD_PROGRESS
		 */
		public function get bytesLoaded():uint
		{
			return this._bytesLoaded;
		}

		/**
		 * @private
		 */
		protected var _bytesTotal:uint = 0;

		/**
		 * @copy feathers.media.IProgressiveMediaPlayer#bytesTotal
		 *
		 * @see #bytesLoaded
		 * @see #event:loadProgress feathers.events.MediaPlayerEventType.LOAD_PROGRESS
		 */
		public function get bytesTotal():uint
		{
			return this._bytesTotal;
		}

		/**
		 * @private
		 */
		override public function dispose():void
		{
			this.videoSource = null;
			super.dispose();
		}

		/**
		 * @private
		 */
		override public function play():void
		{
			if(this._videoSource === null)
			{
				return;
			}
			super.play();
		}

		/**
		 * @private
		 */
		override public function stop():void
		{
			if(this._videoSource === null)
			{
				return;
			}
			super.stop();
		}

		/**
		 * @private
		 */
		override public function render(painter:Painter):void
		{
			if(this._isFullScreen)
			{
				return;
			}
			super.render(painter);
		}

		/**
		 * Goes to full screen or returns to normal display.
		 *
		 * <p> When the player is full screen, it will be displayed as a modal
		 * pop-up that fills the entire Starling stage. Depending on the value
		 * of <code>fullScreenDisplayState</code>, it may also change the value
		 * of the native stage's <code>displayState</code> property.</p>
		 *
		 * <p>When the player is displaying normally (in other words, when it is
		 * not full screen), it will be displayed in its parent's layout like
		 * any other Feathers component.</p>
		 *
		 * @see #isFullScreen
		 * @see #fullScreenDisplayState
		 * @see #normalDisplayState
		 * @see #event:displayStateChange feathers.events.MediaPlayerEventType.DISPLAY_STATE_CHANGE
		 */
		public function toggleFullScreen():void
		{
			if(!this.stage)
			{
				throw new IllegalOperationError("Cannot enter full screen mode if the video player does not have access to the Starling stage.");
			}
			var starling:Starling = this.stage.starling;
			var nativeStage:Stage = starling.nativeStage;
			var oldIgnoreDisplayListEvents:Boolean = this._ignoreDisplayListEvents;
			this._ignoreDisplayListEvents = true;
			if(this._isFullScreen)
			{
				this.root.visible = true;
				PopUpManager.removePopUp(this._fullScreenContainer, false);
				var childCount:int = this._fullScreenContainer.numChildren;
				for(var i:int = 0; i < childCount; i++)
				{
					var child:DisplayObject = this._fullScreenContainer.getChildAt(0);
					this.addChild(child);
				}
				nativeStage.removeEventListener(FullScreenEvent.FULL_SCREEN, nativeStage_fullScreenHandler);
				nativeStage.displayState = this._normalDisplayState;
			}
			else
			{
				if(this._hideRootWhenFullScreen)
				{
					this.root.visible = false;
				}
				nativeStage.displayState = this._fullScreenDisplayState;
				if(!this._fullScreenContainer)
				{
					this._fullScreenContainer = new LayoutGroup();
					this._fullScreenContainer.autoSizeMode = AutoSizeMode.STAGE;
				}
				this._fullScreenContainer.layout = this._layout;
				childCount = this.numChildren;
				for(i = 0; i < childCount; i++)
				{
					child = this.getChildAt(0);
					this._fullScreenContainer.addChild(child);
				}
				PopUpManager.addPopUp(this._fullScreenContainer, true, false);
				nativeStage.addEventListener(FullScreenEvent.FULL_SCREEN, nativeStage_fullScreenHandler, false, 0, true);
			}
			this._ignoreDisplayListEvents = oldIgnoreDisplayListEvents;
			this._isFullScreen = !this._isFullScreen;
			this.dispatchEventWith(MediaPlayerEventType.DISPLAY_STATE_CHANGE);
		}

		/**
		 * @private
		 */
		override protected function playMedia():void
		{
			if(!this._videoSource)
			{
				throw new IllegalOperationError(NO_VIDEO_SOURCE_PLAY_ERROR);
			}
			if(this._netConnection === null)
			{
				var netConnectionFactory:Function = this._netConnectionFactory !== null ? this._netConnectionFactory : defaultNetConnectionFactory;
				this._netConnection = NetConnection(netConnectionFactory());
			}
			if(this._netStream === null)
			{
				if(!this._netConnection.connected)
				{
					//wait for the NetConnection to connect before trying to
					//create the NetStream. we'll call playMedia later.
					this._netConnection.addEventListener(NetStatusEvent.NET_STATUS, netConnection_netStatusHandler);
					return;
				}
				var netStreamFactory:Function = this._netStreamFactory !== null ? this._netStreamFactory : defaultNetStreamFactory;
				this._netStream = NetStream(netStreamFactory(this._netConnection));
				this._netStream.client = new VideoPlayerNetStreamClient(
					this.netStream_onMetaData, this.netStream_onCuePoint,
					this.netStream_onXMPData);
				this._netStream.addEventListener(NetStatusEvent.NET_STATUS, netStream_netStatusHandler);
				this._netStream.addEventListener(IOErrorEvent.IO_ERROR, netStream_ioErrorHandler);
			}
			if(this._soundTransform === null)
			{
				this._soundTransform = new SoundTransform();
			}
			this._netStream.soundTransform = this._soundTransform;
			var onCompleteCallback:Function = videoTexture_onComplete;
			if(this._texture !== null)
			{
				if(this._hasPlayedToEnd)
				{
					//after playing the media until the end, if we restart from the
					//beginning, the audio plays, but we cannot see the video.
					//however, we can ask the NetStream to play the video source
					//again from the beginning, and the video displays. if we need
					//to restore the time, we can do it after the NetStream
					//dispatches NetStream.Play.Start
					this._netStream.play(this._videoSource);
				}
				else
				{
					//this case happens if the video is paused and resumed without
					//reaching the end.
					//NetStream.Play.Start will not be dispatched after calling
					//resume(), so we need to manually add the ENTER_FRAME listener.
					//there's no need to seek. we're resuming from where the video
					//was paused.
					this.addEventListener(Event.ENTER_FRAME, videoPlayer_enterFrameHandler);
					this._netStream.resume();
				}
			}
			else
			{
				//in the final case, the texture hasn't been created yet.
				this._isWaitingForTextureReady = true;
				var starling:Starling = this.stage !== null ? this.stage.starling : Starling.current;
				this._texture = Texture.fromNetStream(this._netStream, starling.contentScaleFactor, onCompleteCallback);
				this._texture.root.onRestore = videoTexture_onRestore;
				//don't call play() until after Texture.fromNetStream() because
				//the texture needs to be created first.
				//however, we need to call play() even though a video texture
				//isn't ready to be rendered yet.
				this._netStream.play(this._videoSource);
			}
			this._hasPlayedToEnd = false;
		}

		/**
		 * @private
		 */
		override protected function pauseMedia():void
		{
			if(!this._videoSource)
			{
				throw new IllegalOperationError(NO_VIDEO_SOURCE_PAUSE_ERROR);
			}
			this.removeEventListener(Event.ENTER_FRAME, videoPlayer_enterFrameHandler);
			this._netStream.pause();
		}

		/**
		 * @private
		 */
		override protected function seekMedia(seconds:Number):void
		{
			if(!this._videoSource)
			{
				throw new IllegalOperationError(NO_VIDEO_SOURCE_SEEK_ERROR);
			}
			this._currentTime = seconds;
			if(this._hasPlayedToEnd)
			{
				//the video played until the end, which means that the current
				//texture cannot seek properly without reloading the media.
				this.playMedia();
				return;
			}
			this._netStream.seek(seconds);
		}

		/**
		 * @private
		 */
		protected function disposeNetConnection():void
		{
			if(this._netConnection === null)
			{
				return;
			}
			this._netConnection.removeEventListener(NetStatusEvent.NET_STATUS, netConnection_netStatusHandler);
			this._netConnection.close();
			this._netConnection = null;
		}

		/**
		 * @private
		 */
		protected function disposeNetStream():void
		{
			if(this._netStream === null)
			{
				return;
			}

			this.removeEventListener(Event.ENTER_FRAME, videoPlayer_progress_enterFrameHandler);

			this._netStream.removeEventListener(NetStatusEvent.NET_STATUS, netStream_netStatusHandler);
			this._netStream.removeEventListener(IOErrorEvent.IO_ERROR, netStream_ioErrorHandler);
			this._netStream.close();
			this._netStream = null;
		}

		/**
		 * @private
		 */
		protected function videoPlayer_enterFrameHandler(event:Event):void
		{
			this.setRequiresRedraw();
			this._currentTime = this._netStream.time;
			this.dispatchEventWith(MediaPlayerEventType.CURRENT_TIME_CHANGE);
		}

		/**
		 * @private
		 */
		protected function videoPlayer_progress_enterFrameHandler(event:Event):void
		{
			var newBytesTotal:Number = this._netStream.bytesTotal;
			if(newBytesTotal > 0)
			{
				var needsDispatch:Boolean = false;
				var newBytesLoaded:Number = this._netStream.bytesLoaded;
				if(this._bytesTotal != newBytesTotal)
				{
					this._bytesTotal = newBytesTotal;
					needsDispatch = true;
				}
				if(this._bytesLoaded != newBytesLoaded)
				{
					this._bytesLoaded = newBytesLoaded;
					needsDispatch = true;
				}
				if(needsDispatch)
				{
					this.dispatchEventWith(MediaPlayerEventType.LOAD_PROGRESS, false, newBytesLoaded / newBytesTotal);
				}
				if(newBytesLoaded == newBytesTotal)
				{
					this.removeEventListener(Event.ENTER_FRAME, videoPlayer_progress_enterFrameHandler);
				}
			}
		}

		/**
		 * @private
		 */
		protected function videoTexture_onRestore():void
		{
			this.pauseMedia();
			this._isWaitingForTextureReady = true;
			this._texture.root.attachNetStream(this._netStream, videoTexture_onComplete);
			//this will start playback from the beginning again, but we can seek
			//back to the current time once the video texture is ready.
			this._netStream.play(this._videoSource);
		}

		/**
		 * @private
		 */
		protected function videoTexture_onComplete():void
		{
			this._isWaitingForTextureReady = false;
			//the texture is ready to be displayed
			this.dispatchEventWith(Event.READY);
			//in many cases, the layout will be affected by the new texture
			//dimensions, so invalidate immediately
			this.invalidate(INVALIDATION_FLAG_LAYOUT);
			var bytesTotal:Number = this._netStream.bytesTotal;
			if(this._bytesTotal == 0 && bytesTotal > 0)
			{
				this._bytesLoaded = this._netStream.bytesLoaded;
				this._bytesTotal = bytesTotal;
				this.dispatchEventWith(MediaPlayerEventType.LOAD_PROGRESS, false, this._bytesLoaded / bytesTotal);
				if(this._bytesLoaded != this._bytesTotal)
				{
					this.addEventListener(Event.ENTER_FRAME, videoPlayer_progress_enterFrameHandler);
				}
			}
		}

		/**
		 * @private
		 */
		protected function netConnection_netStatusHandler(event:NetStatusEvent):void
		{
			var code:String = event.info.code;
			switch(code)
			{
				case NET_STATUS_CODE_NETCONNECTION_CONNECT_SUCCESS:
				{
					this.playMedia();
					break;
				}
			}
		}

		/**
		 * @private
		 */
		protected function netStream_onMetaData(metadata:Object):void
		{
			this.dispatchEventWith(MediaPlayerEventType.DIMENSIONS_CHANGE);
			this._totalTime = metadata.duration;
			this.dispatchEventWith(MediaPlayerEventType.TOTAL_TIME_CHANGE);
			this.dispatchEventWith(MediaPlayerEventType.METADATA_RECEIVED, false, metadata);
		}

		/**
		 * @private
		 */
		protected function netStream_onCuePoint(cuePoint:Object):void
		{
			this.dispatchEventWith(MediaPlayerEventType.CUE_POINT, false, cuePoint);
		}

		/**
		 * @private
		 */
		protected function netStream_onXMPData(xmpData:Object):void
		{
			this.dispatchEventWith(MediaPlayerEventType.XMP_DATA, false, xmpData);
		}

		/**
		 * @private
		 */
		protected function netStream_ioErrorHandler(event:IOErrorEvent):void
		{
			this.dispatchEventWith(event.type, false, event);
		}

		/**
		 * @private
		 */
		protected function netStream_netStatusHandler(event:NetStatusEvent):void
		{
			var code:String = event.info.code;
			switch(code)
			{
				case NET_STATUS_CODE_NETSTREAM_PLAY_STREAMNOTFOUND:
				{
					this.dispatchEventWith(FeathersEventType.ERROR, false, code);
					break;
				}
				case NET_STATUS_CODE_NETSTREAM_PLAY_NOSUPPORTEDTRACKFOUND:
				{
					this.dispatchEventWith(FeathersEventType.ERROR, false, code);
					break;
				}
				case NET_STATUS_CODE_NETSTREAM_PLAY_START:
				{
					if(this._netStream.time != this._currentTime)
					{
						//if we're restoring from a lost context, or we've
						//restarted the video after it had reached the end, the
						//NetStream may have restarted from the beginning. in
						//that case, we can manually seek to the last known good
						//position.
						this._netStream.seek(this._currentTime);
					}
					if(this._isPlaying)
					{
						//only add the listener if a video is playing. it may be
						//paused when restoring lost context, but we need to
						//temporarily start playing the NetStream in order to
						//restore the video texture.
						this.addEventListener(Event.ENTER_FRAME, videoPlayer_enterFrameHandler);
					}
					else
					{
						//the only way to prepare the video texture is to start
						//playing the NetStream. the media player is not in a
						//playing state, though, so we should pause the
						//NetStream now.
						this.pauseMedia();
					}
					break;
				}
				case NET_STATUS_CODE_NETSTREAM_PLAY_STOP:
				{
					if(this._hasPlayedToEnd)
					{
						//we haven't cleared this flag yet after calling play()
						//on the NetStream. it is safe to ignore this case.
						return;
					}

					//any time that the NetStream stops, we want to remove the
					//Event.ENTER_FRAME listener. in most cases, we don't want
					//a listener being called every frame for no reason. on iOS,
					//context loss resets the NetStream time to 0, and we need
					//to keep the current time so that we can seek back.
					this.removeEventListener(Event.ENTER_FRAME, videoPlayer_enterFrameHandler);

					//on iOS, when context is lost, the NetStream will stop
					//automatically, and the time property will be reset to 0.
					//on other platforms, the NetStream will continue playing on
					//context loss, and the time will be correct.
					//we need to check if the context is lost or not to decide
					//if we've reached the end of the video or not.
					if(Starling.context.driverInfo !== "Disposed")
					{
						this.stop();

						//set this flag after calling stop() because stopping
						//will seek to the beginning and may check for the flag.
						this._hasPlayedToEnd = true;
						this.dispatchEventWith(Event.COMPLETE);
					}
					break;
				}
			}
		}

		/**
		 * @private
		 */
		override protected function mediaPlayer_addedHandler(event:Event):void
		{
			if(this._ignoreDisplayListEvents)
			{
				return;
			}
			super.mediaPlayer_addedHandler(event);
		}

		/**
		 * @private
		 */
		override protected function mediaPlayer_removedHandler(event:Event):void
		{
			if(this._ignoreDisplayListEvents)
			{
				return;
			}
			super.mediaPlayer_removedHandler(event);
		}

		/**
		 * @private
		 */
		protected function nativeStage_fullScreenHandler(event:FullScreenEvent):void
		{
			this.toggleFullScreen();
		}
	}
}

dynamic class VideoPlayerNetStreamClient
{
	public function VideoPlayerNetStreamClient(onMetaDataCallback:Function,
		onCuePointCallback:Function, onXMPDataCallback:Function)
	{
		this.onMetaDataCallback = onMetaDataCallback;
		this.onCuePointCallback = onCuePointCallback;
		this.onXMPDataCallback = onXMPDataCallback;
	}

	public var onMetaDataCallback:Function;

	public var onCuePointCallback:Function;

	public function onMetaData(metadata:Object):void
	{
		this.onMetaDataCallback(metadata);
	}

	public function onCuePoint(cuePoint:Object):void
	{
		this.onCuePointCallback(cuePoint);
	}

	public function onXMPData(xmpData:Object):void
	{
		this.onXMPDataCallback(xmpData);
	}
}

================================================
FILE: source/feathers/media/VolumeSlider.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.media
{
	import feathers.controls.Slider;
	import feathers.events.MediaPlayerEventType;
	import feathers.skins.IStyleProvider;

	import flash.media.SoundTransform;

	import starling.events.Event;

	/**
	 * A specialized slider that controls the volume of a media player that
	 * plays audio content.
	 *
	 * @see ../../../help/sound-player.html How to use the Feathers SoundPlayer component
	 * @see ../../../help/video-player.html How to use the Feathers VideoPlayer component
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class VolumeSlider extends Slider implements IMediaPlayerControl
	{
		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * minimum track.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK:String = "feathers-volume-slider-minimum-track";

		/**
		 * The default value added to the <code>styleNameList</code> of the
		 * maximum track.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK:String = "feathers-volume-slider-maximum-track";

		/**
		 * The default value added to the <code>styleNameList</code> of the thumb.
		 *
		 * @see feathers.core.FeathersControl#styleNameList
		 */
		public static const DEFAULT_CHILD_STYLE_NAME_THUMB:String = "feathers-volume-slider-thumb";

		/**
		 * The default <code>IStyleProvider</code> for all
		 * <code>VolumeSlider</code> components.
		 *
		 * @default null
		 * @see feathers.core.FeathersControl#styleProvider
		 */
		public static var globalStyleProvider:IStyleProvider;

		/**
		 * Constructor.
		 */
		public function VolumeSlider()
		{
			super();
			this.thumbStyleName = VolumeSlider.DEFAULT_CHILD_STYLE_NAME_THUMB;
			this.minimumTrackStyleName = VolumeSlider.DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK;
			this.maximumTrackStyleName = VolumeSlider.DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK;
			this.minimum = 0;
			this.maximum = 1;
			this.addEventListener(Event.CHANGE, volumeSlider_changeHandler);
		}

		/**
		 * @private
		 */
		override protected function get defaultStyleProvider():IStyleProvider
		{
			return VolumeSlider.globalStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _ignoreChanges:Boolean = false;

		/**
		 * @private
		 */
		protected var _mediaPlayer:IAudioPlayer;

		/**
		 * @inheritDoc
		 */
		public function get mediaPlayer():IMediaPlayer
		{
			return this._mediaPlayer;
		}

		/**
		 * @private
		 */
		public function set mediaPlayer(value:IMediaPlayer):void
		{
			if(this._mediaPlayer == value)
			{
				return;
			}
			this._mediaPlayer = value as IAudioPlayer;
			this.refreshVolumeFromMediaPlayer();
			if(this._mediaPlayer)
			{
				this._mediaPlayer.addEventListener(MediaPlayerEventType.SOUND_TRANSFORM_CHANGE, mediaPlayer_soundTransformChangeHandler);
			}
			this.invalidate(INVALIDATION_FLAG_DATA);
		}

		/**
		 * @private
		 */
		protected function refreshVolumeFromMediaPlayer():void
		{
			var oldIgnoreChanges:Boolean = this._ignoreChanges;
			this._ignoreChanges = true;
			if(this._mediaPlayer)
			{
				this.value = this._mediaPlayer.soundTransform.volume;
			}
			else
			{
				this.value = 0;
			}
			this._ignoreChanges = oldIgnoreChanges;
		}

		/**
		 * @private
		 */
		protected function mediaPlayer_soundTransformChangeHandler(event:Event):void
		{
			this.refreshVolumeFromMediaPlayer();
		}

		/**
		 * @private
		 */
		protected function volumeSlider_changeHandler(event:Event):void
		{
			if(!this._mediaPlayer || this._ignoreChanges)
			{
				return;
			}
			var soundTransform:SoundTransform = this._mediaPlayer.soundTransform;
			soundTransform.volume = this._value;
			this._mediaPlayer.soundTransform = soundTransform;
		}
	}
}


================================================
FILE: source/feathers/motion/ColorFade.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion
{
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.motion.effectClasses.TweenEffectContext;

	import starling.animation.Transitions;
	import starling.core.Starling;
	import starling.display.DisplayObject;

	[Exclude(name="createBlackFadeToBlackTransition",kind="method")]

	/**
	 * Creates animated transitions for screen navigators that fade a display
	 * object to a solid color.
	 *
	 * @see ../../../help/transitions.html#colorfade Transitions for Feathers screen navigators: ColorFade
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class ColorFade
	{
		/**
		 * @private
		 */
		protected static const SCREEN_REQUIRED_ERROR:String = "Cannot transition if both old screen and new screen are null.";

		/**
		 * @private
		 * This was accidentally named wrong. It is included for temporary
		 * backward compatibility.
		 */
		public static function createBlackFadeToBlackTransition(duration:Number = 0.75, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return createBlackFadeTransition(duration, ease, tweenProperties);
		}

		/**
		 * Creates a transition function for a screen navigator that hides the
		 * old screen as a solid black color fades in over it. Then, the solid
		 * black color fades back out to show that the new screen has replaced
		 * the old screen.
		 *
		 * @see ../../../help/transitions.html#colorfade Transitions for Feathers screen navigators: ColorFade
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createBlackFadeTransition(duration:Number = 0.75, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return createColorFadeTransition(0x000000, duration, ease, tweenProperties);
		}

		/**
		 * Creates a transition function for a screen navigator that hides the old screen as a solid
		 * white color fades in over it. Then, the solid white color fades back
		 * out to show that the new screen has replaced the old screen.
		 *
		 * @see ../../../help/transitions.html#colorfade Transitions for Feathers screen navigators: ColorFade
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createWhiteFadeTransition(duration:Number = 0.75, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return createColorFadeTransition(0xffffff, duration, ease, tweenProperties);
		}

		/**
		 * Creates a transition function for a screen navigator that hides the
		 * old screen as a customizable solid color fades in over it. Then, the
		 * solid color fades back out to show that the new screen has replaced
		 * the old screen.
		 *
		 * @see ../../../help/transitions.html#colorfade Transitions for Feathers screen navigators: ColorFade
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createColorFadeTransition(color:uint, duration:Number = 0.75, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(newScreen)
				{
					newScreen.alpha = 0;
					if(oldScreen) //oldScreen can be null, that's okay
					{
						oldScreen.alpha = 1;
					}
					var tween:ColorFadeTween = new ColorFadeTween(newScreen, oldScreen, color, duration, ease, onComplete, tweenProperties);
				}
				else //we only have the old screen
				{
					oldScreen.alpha = 1;
					tween = new ColorFadeTween(oldScreen, null, color, duration, ease, onComplete, tweenProperties);
				}
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}
	}
}

import starling.animation.Tween;
import starling.core.Starling;
import starling.display.DisplayObject;
import starling.display.DisplayObjectContainer;
import starling.display.Quad;

class ColorFadeTween extends Tween
{
	public function ColorFadeTween(target:DisplayObject, otherTarget:DisplayObject,
		color:uint, duration:Number, ease:Object, onCompleteCallback:Function,
		tweenProperties:Object)
	{
		super(target, duration, ease);
		if(target.alpha == 0)
		{
			this.fadeTo(1);
		}
		else
		{
			this.fadeTo(0);
		}
		if(tweenProperties)
		{
			for(var propertyName:String in tweenProperties)
			{
				this[propertyName] = tweenProperties[propertyName];
			}
		}
		if(otherTarget)
		{
			this._otherTarget = otherTarget;
			target.visible = false;
		}
		this.onUpdate = this.updateOverlay;
		this._onCompleteCallback = onCompleteCallback;
		this.onComplete = this.cleanupTween;

		var navigator:DisplayObjectContainer = target.parent;
		this._overlay = new Quad(1, 1, color);
		this._overlay.width = navigator.width;
		this._overlay.height = navigator.height;
		this._overlay.alpha = 0;
		this._overlay.touchable = false;
		navigator.addChild(this._overlay);
	}

	private var _otherTarget:DisplayObject;
	private var _overlay:Quad;
	private var _onCompleteCallback:Function;

	private function updateOverlay():void
	{
		var progress:Number = this.progress;
		if(progress < 0.5)
		{
			target.visible = false;
			if(this._otherTarget)
			{
				this._otherTarget.visible = true;
			}
			this._overlay.alpha = progress * 2;
		}
		else
		{
			target.visible = true;
			if(this._otherTarget)
			{
				this._otherTarget.visible = false;
			}
			this._overlay.alpha = (1 - progress) * 2;
		}
	}

	private function cleanupTween():void
	{
		this._overlay.removeFromParent(true);
		this.target.visible = true;
		if(this._otherTarget)
		{
			this._otherTarget.visible = true;
		}
		if(this._onCompleteCallback !== null)
		{
			this._onCompleteCallback();
		}
	}
}

================================================
FILE: source/feathers/motion/Cover.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion
{
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.motion.effectClasses.TweenEffectContext;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.DisplayObject;

	/**
	 * Creates animated transitions for screen navigators that slide a new
	 * display object into view by animating the <code>x</code> and
	 * <code>y</code> properties, while covering an existing display object that
	 * remains stationary below. The display object may slide up, right,
	 * down, or left.
	 *
	 * @see ../../../help/transitions.html#cover Transitions for Feathers screen navigators: Cover
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class Cover
	{
		/**
		 * @private
		 */
		protected static const SCREEN_REQUIRED_ERROR:String = "Cannot transition if both old screen and new screen are null.";

		/**
		 * Creates a transition function for a screen navigator that slides the
		 * new screen into view to the left, animating the <code>x</code>
		 * property, to cover up the old screen, which remains stationary.
		 *
		 * @see ../../../help/transitions.html#cover Transitions for Feathers screen navigators: Cover
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createCoverLeftTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(newScreen)
				{
					newScreen.x = newScreen.width;
					newScreen.y = 0;
				}
				if(oldScreen)
				{
					oldScreen.x = 0;
					oldScreen.y = 0;
					var tween:CoverTween = new CoverTween(newScreen, oldScreen, -oldScreen.width, 0, duration, ease, managed ? null : onComplete, tweenProperties);
					if(managed)
					{
						return new TweenEffectContext(null, tween);
					}
					Starling.juggler.add(tween);
					return null;
				}
				//we only have the new screen
				return slideInNewScreen(newScreen, duration, ease, tweenProperties, onComplete, managed);
			};
		}

		/**
		 * Creates a transition function for a screen navigator that slides the
		 * new screen into view to the right, animating the <code>x</code>
		 * property, to cover up the old screen, which remains stationary.
		 *
		 * @see ../../../help/transitions.html#cover Transitions for Feathers screen navigators: Cover
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createCoverRightTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(newScreen)
				{
					newScreen.x = -newScreen.width;
					newScreen.y = 0;
				}
				if(oldScreen)
				{
					oldScreen.x = 0;
					oldScreen.y = 0;
					var tween:CoverTween = new CoverTween(newScreen, oldScreen, oldScreen.width, 0, duration, ease, managed ? null : onComplete, tweenProperties);
					if(managed)
					{
						return new TweenEffectContext(null, tween);
					}
					Starling.juggler.add(tween);
					return null;
				}
				//we only have the new screen
				return slideInNewScreen(newScreen, duration, ease, tweenProperties, onComplete, managed);
			};
		}

		/**
		 * Creates a transition function for a screen navigator that slides the
		 * new screen up into view, animating the <code>y</code> property, to
		 * cover up the old screen, which remains stationary.
		 *
		 * @see ../../../help/transitions.html#cover Transitions for Feathers screen navigators: Cover
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createCoverUpTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(newScreen)
				{
					newScreen.x = 0;
					newScreen.y = newScreen.height;
				}
				if(oldScreen)
				{
					oldScreen.x = 0;
					oldScreen.y = 0;
					var tween:CoverTween = new CoverTween(newScreen, oldScreen, 0, -oldScreen.height, duration, ease, managed ? null : onComplete, tweenProperties);
					if(managed)
					{
						return new TweenEffectContext(null, tween);
					}
					Starling.juggler.add(tween);
					return null;
				}
				//we only have the new screen
				return slideInNewScreen(newScreen, duration, ease, tweenProperties, onComplete, managed);
			};
		}

		/**
		 * Creates a transition function for a screen navigator that slides the
		 * new screen down into view, animating the <code>y</code> property, to
		 * cover up the old screen, which remains stationary.
		 *
		 * @see ../../../help/transitions.html#cover Transitions for Feathers screen navigators: Cover
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createCoverDownTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(newScreen)
				{
					newScreen.x = 0;
					newScreen.y = -newScreen.height;
				}
				if(oldScreen)
				{
					oldScreen.x = 0;
					oldScreen.y = 0;
					var tween:CoverTween = new CoverTween(newScreen, oldScreen, 0, oldScreen.height, duration, ease, managed ? null : onComplete, tweenProperties);
					if(managed)
					{
						return new TweenEffectContext(null, tween);
					}
					Starling.juggler.add(tween);
					return null;
				}
				//we only have the new screen
				return slideInNewScreen(newScreen, duration, ease, tweenProperties, onComplete, managed);
			};
		}

		/**
		 * @private
		 */
		private static function slideInNewScreen(newScreen:DisplayObject,
			duration:Number, ease:Object, tweenProperties:Object, onComplete:Function, managed:Boolean):IEffectContext
		{
			var tween:Tween = new Tween(newScreen, duration, ease);
			if(newScreen.x != 0)
			{
				tween.animate("x", 0);
			}
			if(newScreen.y != 0)
			{
				tween.animate("y", 0);
			}
			if(tweenProperties)
			{
				for(var propertyName:String in tweenProperties)
				{
					tween[propertyName] = tweenProperties[propertyName];
				}
			}
			tween.onComplete = onComplete;
			if(managed)
			{
				return new TweenEffectContext(null, tween);
			}
			Starling.juggler.add(tween);
			return null;
		}
	}
}

import feathers.display.RenderDelegate;

import starling.animation.Tween;
import starling.core.Starling;
import starling.display.DisplayObject;
import starling.display.Quad;
import starling.display.Sprite;

class CoverTween extends Tween
{
	public function CoverTween(newScreen:DisplayObject, oldScreen:DisplayObject,
		xOffset:Number, yOffset:Number, duration:Number, ease:Object, onCompleteCallback:Function,
		tweenProperties:Object)
	{
		var mask:Quad = new Quad(1, 1, 0xff00ff);
		//the initial dimensions cannot be 0 or there's a runtime error,
		//and these values might be 0
		mask.width = oldScreen.width;
		mask.height = oldScreen.height;
		this._temporaryParent = new Sprite();
		this._temporaryParent.mask = mask;
		oldScreen.parent.addChild(this._temporaryParent);
		var delegate:RenderDelegate = new RenderDelegate(oldScreen);
		delegate.alpha = oldScreen.alpha;
		delegate.blendMode = oldScreen.blendMode;
		delegate.rotation = oldScreen.rotation;
		delegate.scaleX = oldScreen.scaleX;
		delegate.scaleY = oldScreen.scaleY;
		this._temporaryParent.addChild(delegate);
		oldScreen.visible = false;
		this._savedOldScreen = oldScreen;

		super(this._temporaryParent.mask, duration, ease);

		if(xOffset < 0)
		{
			this.animate("width", 0);
		}
		else if(xOffset > 0)
		{
			this.animate("x", xOffset);
			this.animate("width", 0);
		}
		if(yOffset < 0)
		{
			this.animate("height", 0);
		}
		else if(yOffset > 0)
		{
			this.animate("y", yOffset);
			this.animate("height", 0);
		}
		if(tweenProperties)
		{
			for(var propertyName:String in tweenProperties)
			{
				this[propertyName] = tweenProperties[propertyName];
			}
		}
		this._onCompleteCallback = onCompleteCallback;
		if(newScreen)
		{
			this._savedNewScreen = newScreen;
			this._savedXOffset = xOffset;
			this._savedYOffset = yOffset;
			this.onUpdate = this.updateNewScreen;
		}
		this.onComplete = this.cleanupTween;
	}

	private var _savedXOffset:Number;
	private var _savedYOffset:Number;
	private var _savedOldScreen:DisplayObject;
	private var _savedNewScreen:DisplayObject;
	private var _temporaryParent:Sprite;
	private var _onCompleteCallback:Function;

	private function updateNewScreen():void
	{
		var mask:Quad = Quad(this.target);
		if(this._savedXOffset < 0)
		{
			this._savedNewScreen.x = mask.width;
		}
		else if(this._savedXOffset > 0)
		{
			this._savedNewScreen.x = -mask.width;
		}
		if(this._savedYOffset < 0)
		{
			this._savedNewScreen.y = mask.height;
		}
		else if(this._savedYOffset > 0)
		{
			this._savedNewScreen.y = -mask.height;
		}
	}

	private function cleanupTween():void
	{
		this._temporaryParent.removeFromParent(true);
		this._temporaryParent = null;
		this._savedOldScreen.visible = true;
		this._savedNewScreen = null;
		this._savedOldScreen = null;
		if(this._onCompleteCallback !== null)
		{
			this._onCompleteCallback();
		}
	}

}

================================================
FILE: source/feathers/motion/Cube.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion
{
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.motion.effectClasses.TweenEffectContext;

	import starling.animation.Transitions;
	import starling.core.Starling;
	import starling.display.DisplayObject;

	/**
	 * Creates animated transitions for screen navigators that position a
	 * display object in 3D space as if it is on a side of a cube, and the cube
	 * may rotate up or down around the x-axis, or it may rotate left or right
	 * around the y-axis.
	 *
	 * <p>Warning: <code>Cube</code> and other transitions with 3D effects may
	 * not be compatible with masks.</p>
	 *
	 * @see ../../../help/transitions.html#cube Transitions for Feathers screen navigators: Cube
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class Cube
	{
		/**
		 * @private
		 */
		protected static const SCREEN_REQUIRED_ERROR:String = "Cannot transition if both old screen and new screen are null.";

		/**
		 * Creates a transition function for a screen navigator that positions
		 * the screens in 3D space as if they are on two adjacent sides of a
		 * cube, and the cube rotates left around the y-axis.
		 *
		 * @see ../../../help/transitions.html#cube Transitions for Feathers screen navigators: Cube
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createCubeLeftTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				var tween:CubeTween = new CubeTween(newScreen, oldScreen, Math.PI / 2, 0, duration, ease, managed ? null : onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that positions
		 * the screens in 3D space as if they are on two adjacent sides of a
		 * cube, and the cube rotates right around the y-axis.
		 *
		 * @see ../../../help/transitions.html#cube Transitions for Feathers screen navigators: Cube
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createCubeRightTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				var tween:CubeTween = new CubeTween(newScreen, oldScreen, -Math.PI / 2, 0, duration, ease, managed ? null : onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that positions
		 * the screens in 3D space as if they are on two adjacent sides of a
		 * cube, and the cube rotates up around the x-axis.
		 *
		 * @see ../../../help/transitions.html#cube Transitions for Feathers screen navigators: Cube
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createCubeUpTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				var tween:CubeTween = new CubeTween(newScreen, oldScreen, 0, -Math.PI / 2, duration, ease, managed ? null : onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that positions
		 * the screens in 3D space as if they are on two adjacent sides of a
		 * cube, and the cube rotates down around the y-axis.
		 *
		 * @see ../../../help/transitions.html#cube Transitions for Feathers screen navigators: Cube
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createCubeDownTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				var tween:CubeTween = new CubeTween(newScreen, oldScreen, 0, Math.PI / 2, duration, ease, managed ? null : onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}
	}
}

import feathers.display.RenderDelegate;

import flash.display3D.Context3DTriangleFace;

import starling.animation.Tween;
import starling.core.Starling;
import starling.display.DisplayObject;
import starling.display.DisplayObjectContainer;
import starling.display.Sprite3D;
import starling.rendering.Painter;

class CubeTween extends Tween
{
	public function CubeTween(newScreen:DisplayObject, oldScreen:DisplayObject,
		rotationYOffset:Number, rotationXOffset:Number,
		duration:Number, ease:Object, onCompleteCallback:Function,
		tweenProperties:Object)
	{
		var cube:CulledSprite3D = new CulledSprite3D();
		if(newScreen)
		{
			this._navigator = newScreen.parent;
			this._newScreenParent = new Sprite3D();
			if(rotationYOffset < 0)
			{
				this._newScreenParent.z = this._navigator.width;
				this._newScreenParent.rotationY = rotationYOffset + Math.PI;
			}
			else if(rotationYOffset > 0)
			{
				this._newScreenParent.x = this._navigator.width;
				this._newScreenParent.rotationY = -rotationYOffset;
			}
			if(rotationXOffset < 0)
			{
				this._newScreenParent.y = this._navigator.height;
				this._newScreenParent.rotationX = rotationXOffset + Math.PI;
			}
			else if(rotationXOffset > 0)
			{
				this._newScreenParent.z = this._navigator.height;
				this._newScreenParent.rotationX = -rotationXOffset;
			}
			var delegate:RenderDelegate = new RenderDelegate(newScreen);
			delegate.alpha = newScreen.alpha;
			delegate.blendMode = newScreen.blendMode;
			delegate.rotation = newScreen.rotation;
			delegate.scaleX = newScreen.scaleX;
			delegate.scaleY = newScreen.scaleY;
			this._newScreenParent.addChild(delegate);
			newScreen.visible = false;
			this._savedNewScreen = newScreen;
			cube.addChild(this._newScreenParent);
		}
		if(oldScreen)
		{
			if(!this._navigator)
			{
				this._navigator = oldScreen.parent;
			}
			delegate = new RenderDelegate(oldScreen);
			delegate.alpha = oldScreen.alpha;
			delegate.blendMode = oldScreen.blendMode;
			delegate.rotation = oldScreen.rotation;
			delegate.scaleX = oldScreen.scaleX;
			delegate.scaleY = oldScreen.scaleY;
			cube.addChildAt(delegate, 0);
			oldScreen.visible = false;
			this._savedOldScreen = oldScreen;
		}
		this._navigator.addChild(cube);

		super(cube, duration, ease);

		if(rotationYOffset < 0)
		{
			this.animate("x", this._navigator.width);
			this.animate("rotationY", rotationYOffset);
		}
		else if(rotationYOffset > 0)
		{
			this.animate("z", this._navigator.width);
			this.animate("rotationY", rotationYOffset);
		}
		if(rotationXOffset < 0)
		{
			this.animate("z", this._navigator.height);
			this.animate("rotationX", rotationXOffset);
		}
		else if(rotationXOffset > 0)
		{
			this.animate("y", this._navigator.height);
			this.animate("rotationX", rotationXOffset);
		}
		if(tweenProperties)
		{
			for(var propertyName:String in tweenProperties)
			{
				this[propertyName] = tweenProperties[propertyName];
			}
		}

		this._onCompleteCallback = onCompleteCallback;
		this.onComplete = this.cleanupTween;
	}

	private var _navigator:DisplayObjectContainer;
	private var _newScreenParent:Sprite3D;
	private var _onCompleteCallback:Function;
	private var _savedNewScreen:DisplayObject;
	private var _savedOldScreen:DisplayObject;

	private function cleanupTween():void
	{
		var cube:Sprite3D = Sprite3D(this.target);
		cube.removeFromParent(true);
		if(this._savedNewScreen)
		{
			this._savedNewScreen.visible = true;
			this._savedNewScreen = null;
		}
		if(this._savedOldScreen)
		{
			this._savedOldScreen.visible = true;
			this._savedOldScreen = null;
		}
		if(this._onCompleteCallback !== null)
		{
			this._onCompleteCallback();
		}
	}
}

class CulledSprite3D extends Sprite3D
{
	override public function render(painter:Painter):void
	{
		//this will be cleared later when the state is popped
		painter.state.culling = Context3DTriangleFace.BACK;
		super.render(painter);
	}
}

================================================
FILE: source/feathers/motion/EffectInterruptBehavior.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion
{
	/**
	 * Constants for determining how an effect behaves when it is interrupted.
	 *
	 * @see feathers.motion.effectClasses.IEffectContext#interrupt()
	 * @see ../../../help/effects.html Effects and animation for Feathers components
	 *
	 * @productversion Feathers 3.5.0
	 */
	public class EffectInterruptBehavior
	{
		/**
		 * When the effect is interrupted, it stops at its current position.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static const STOP:String = "stop";

		/**
		 * When the effect is interrupted, it immediately advances to the end.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static const END:String = "end";
	}
}

================================================
FILE: source/feathers/motion/Fade.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion
{
	import feathers.core.IFeathersControl;
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.motion.effectClasses.TweenEffectContext;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;

	/**
	 * Creates effects for Feathers components and transitions for screen
	 * navigators, that animate the <code>alpha</code> property of a display
	 * object to make it fade in or out.
	 *
	 * @see ../../../help/effects.html Effects and animation for Feathers components
	 * @see ../../../help/transitions.html#fade Transitions for Feathers screen navigators: Fade
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class Fade
	{
		/**
		 * @private
		 */
		protected static const SCREEN_REQUIRED_ERROR:String = "Cannot transition if both old screen and new screen are null.";

		/**
		 * Creates an effect function that fades in the target component by
		 * animating the <code>alpha</code> property from <code>0.0</code> to
		 * <code>1.0</code>.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 * @see #createFadeOutEffect()
		 * @see #createFadeBetweenEffect()
		 */
		public static function createFadeInEffect(duration:Number = 0.25, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return createFadeBetweenEffect(0.0, 1.0, duration, ease, interruptBehavior);
		}

		/**
		 * Creates an effect function that fades out the target component by
		 * animating the <code>alpha</code> property from <code>1.0</code> to
		 * <code>0.0</code>.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 * @see #createFadeInEffect()
		 * @see #createFadeBetweenEffect()
		 */
		public static function createFadeOutEffect(duration:Number = 0.25, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return createFadeBetweenEffect(1.0, 0.0, duration, ease, interruptBehavior);
		}

		/**
		 * Creates an effect function that fades the target component by
		 * animating the <code>alpha</code> property from its current value to a
		 * new value.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 * @see #createFadeFromEffect()
		 * @see #createFadeBetweenEffect()
		 */
		public static function createFadeToEffect(endAlpha:Number, duration:Number = 0.25, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				tween.fadeTo(endAlpha);
				var context:TweenEffectContext = new TweenEffectContext(target, tween);
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function that fades the target component by
		 * animating the <code>alpha</code> property from a start value to its
		 * current value.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 * @see #createFadeToEffect()
		 * @see #createFadeBetweenEffect()
		 */
		public static function createFadeFromEffect(startAlpha:Number, duration:Number = 0.25, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var endAlpha:Number = target.alpha;
				if(target is IFeathersControl)
				{
					IFeathersControl(target).suspendEffects();
				}
				target.alpha = startAlpha;
				if(target is IFeathersControl)
				{
					IFeathersControl(target).resumeEffects();
				}
				var tween:Tween = new Tween(target, duration, ease);
				tween.fadeTo(endAlpha);
				var context:TweenEffectContext = new TweenEffectContext(target, tween);
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function that fades the target component by
		 * animating the <code>alpha</code> property between a start value and
		 * an ending value.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 */
		public static function createFadeBetweenEffect(startAlpha:Number, endAlpha:Number, duration:Number = 0.25, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				if(target is IFeathersControl)
				{
					IFeathersControl(target).suspendEffects();
				}
				target.alpha = startAlpha;
				if(target is IFeathersControl)
				{
					IFeathersControl(target).resumeEffects();
				}
				var tween:Tween = new Tween(target, duration, ease);
				tween.fadeTo(endAlpha);
				var context:TweenEffectContext = new TweenEffectContext(target, tween);
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that fades in
		 * the new screen by animating the <code>alpha</code> property from
		 * <code>0.0</code> to <code>1.0</code>, while the old screen remains
		 * fully opaque at a lower depth.
		 *
		 * @see ../../../help/transitions.html#fade Transitions for Feathers screen navigators: Fade
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createFadeInTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(newScreen)
				{
					newScreen.alpha = 0;
					//make sure the new screen is on top
					var parent:DisplayObjectContainer = newScreen.parent;
					parent.setChildIndex(newScreen, parent.numChildren - 1);
					if(oldScreen) //oldScreen can be null, that's okay
					{
						oldScreen.alpha = 1;
					}
					var tween:FadeTween = new FadeTween(newScreen, null, duration, ease, onComplete, tweenProperties);
				}
				else
				{
					//there's no new screen to fade in, but we still want some
					//kind of animation, so we'll just fade out the old screen
					//in order to have some animation, we're going to fade out
					oldScreen.alpha = 1;
					tween = new FadeTween(oldScreen, null, duration, ease, onComplete, tweenProperties);
				}
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that fades out
		 * the old screen by animating the <code>alpha</code> property from
		 * <code>1.0</code> to <code>0.0</code>, while the new screen remains
		 * fully opaque at a lower depth.
		 *
		 * @see ../../../help/transitions.html#fade Transitions for Feathers screen navigators: Fade
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createFadeOutTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(oldScreen)
				{
					//make sure the old screen is on top
					var parent:DisplayObjectContainer = oldScreen.parent;
					parent.setChildIndex(oldScreen, parent.numChildren - 1);
					oldScreen.alpha = 1;
					if(newScreen) //newScreen can be null, that's okay
					{
						newScreen.alpha = 1;
					}
					var tween:FadeTween = new FadeTween(oldScreen, null, duration, ease, onComplete, tweenProperties);
				}
				else
				{
					//there's no old screen to fade out, but we still want some
					//kind of animation, so we'll just fade in the new screen
					//in order to have some animation, we're going to fade out
					newScreen.alpha = 0;
					tween = new FadeTween(newScreen, null, duration, ease, onComplete, tweenProperties);
				}
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that crossfades
		 * the screens. In other words, the old screen fades out, animating the
		 * <code>alpha</code> property from <code>1.0</code> to
		 * <code>0.0</code>. Simultaneously, the new screen fades in, animating
		 * its <code>alpha</code> property from <code>0.0</code> to <code>1.0</code>.
		 *
		 * @see ../../../help/transitions.html#fade Transitions for Feathers screen navigators: Fade
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createCrossfadeTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(newScreen)
				{
					newScreen.alpha = 0;
					if(oldScreen) //oldScreen can be null, that's okay
					{
						oldScreen.alpha = 1;
					}
					var tween:FadeTween = new FadeTween(newScreen, oldScreen, duration, ease, onComplete, tweenProperties);
				}
				else //we only have the old screen
				{
					oldScreen.alpha = 1;
					tween = new FadeTween(oldScreen, null, duration, ease, onComplete, tweenProperties);
				}
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}
	}
}

import starling.animation.Tween;
import starling.core.Starling;
import starling.display.DisplayObject;

class FadeTween extends Tween
{
	public function FadeTween(target:DisplayObject, otherTarget:DisplayObject,
		duration:Number, ease:Object, onCompleteCallback:Function,
		tweenProperties:Object)
	{
		super(target, duration, ease);
		if(target.alpha == 0)
		{
			this.fadeTo(1);
		}
		else
		{
			this.fadeTo(0);
		}
		if(tweenProperties)
		{
			for(var propertyName:String in tweenProperties)
			{
				this[propertyName] = tweenProperties[propertyName];
			}
		}
		if(otherTarget)
		{
			this._otherTarget = otherTarget;
			this.onUpdate = this.updateOtherTarget;
		}
		this._onCompleteCallback = onCompleteCallback;
		this.onComplete = this.cleanupTween;
	}

	private var _otherTarget:DisplayObject;
	private var _onCompleteCallback:Function;

	private function updateOtherTarget():void
	{
		var newScreen:DisplayObject = DisplayObject(this.target);
		this._otherTarget.alpha = 1 - newScreen.alpha;
	}

	private function cleanupTween():void
	{
		this.target.alpha = 1;
		if(this._otherTarget)
		{
			this._otherTarget.alpha = 1;
		}
		if(this._onCompleteCallback !== null)
		{
			this._onCompleteCallback();
		}
	}
}


================================================
FILE: source/feathers/motion/Flip.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion
{
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.motion.effectClasses.TweenEffectContext;

	import starling.animation.Transitions;
	import starling.core.Starling;
	import starling.display.DisplayObject;

	/**
	 * Creates animated transitions for screen navigators that position display
	 * objects in 3D space is if they are printed on opposite sides of a
	 * postcard. A display object may appear on the front or back side, and the
	 * card rotates around its center to reveal the other side. The card may
	 * rotate up or down around the x-axis, or they may rotate left or right
	 * around the y-axis.
	 *
	 * <p>Warning: <code>Flip</code> and other transitions with 3D effects may
	 * not be compatible with masks.</p>
	 *
	 * @see ../../../help/transitions.html#flip Transitions for Feathers screen navigators: Flip
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class Flip
	{
		/**
		 * @private
		 */
		protected static const SCREEN_REQUIRED_ERROR:String = "Cannot transition if both old screen and new screen are null.";

		/**
		 * Creates a transition function for a screen navigator that positions
		 * the screens in 3D space is if they are printed on opposite sides of a
		 * postcard, and the card rotates left, around its y-axis, to reveal the
		 * new screen on the back side.
		 *
		 * @see ../../../help/transitions.html#flip Transitions for Feathers screen navigators: Flip
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createFlipLeftTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				var tween:FlipTween = new FlipTween(newScreen, oldScreen, Math.PI, 0, duration, ease, onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that positions
		 * the screens in 3D space is if they are printed on opposite sides of a
		 * postcard, and the card rotates right, around its y-axis, to reveal
		 * the new screen on the back side.
		 *
		 * @see ../../../help/transitions.html#flip Transitions for Feathers screen navigators: Flip
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createFlipRightTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				var tween:FlipTween = new FlipTween(newScreen, oldScreen, -Math.PI, 0, duration, ease, onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that positions
		 * the screens in 3D space is if they are printed on opposite sides of a
		 * postcard, and the card rotates up, around its x-axis, to reveal the
		 * new screen on the back side.
		 *
		 * @see ../../../help/transitions.html#flip Transitions for Feathers screen navigators: Flip
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createFlipUpTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				var tween:FlipTween = new FlipTween(newScreen, oldScreen, 0, -Math.PI, duration, ease, onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that positions
		 * the screens in 3D space is if they are printed on opposite sides of a
		 * postcard, and the card rotates down, around its x-axis, to reveal the
		 * new screen on the back side.
		 *
		 * @see ../../../help/transitions.html#flip Transitions for Feathers screen navigators: Flip
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createFlipDownTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				var tween:FlipTween = new FlipTween(newScreen, oldScreen, 0, Math.PI, duration, ease, onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}
	}
}

import feathers.display.RenderDelegate;

import starling.animation.Tween;
import starling.core.Starling;
import starling.display.DisplayObject;
import starling.display.DisplayObjectContainer;
import starling.display.Sprite3D;

class FlipTween extends Tween
{
	public function FlipTween(newScreen:DisplayObject, oldScreen:DisplayObject,
		rotationYOffset:Number, rotationXOffset:Number,
		duration:Number, ease:Object, onCompleteCallback:Function,
		tweenProperties:Object)
	{

		if(newScreen)
		{
			this._navigator = newScreen.parent;
			var newScreenParent:Sprite3D = new Sprite3D();
			var delegate:RenderDelegate = new RenderDelegate(newScreen);
			delegate.alpha = newScreen.alpha;
			delegate.blendMode = newScreen.blendMode;
			delegate.rotation = newScreen.rotation;
			delegate.scaleX = newScreen.scaleX;
			delegate.scaleY = newScreen.scaleY;
			if(rotationYOffset != 0)
			{
				delegate.x = -newScreen.width / 2;
				newScreenParent.x = newScreen.width / 2;
				newScreenParent.rotationY = -rotationYOffset;
			}
			if(rotationXOffset != 0)
			{
				delegate.y = -newScreen.height / 2;
				newScreenParent.y = newScreen.height / 2;
				newScreenParent.rotationX = -rotationXOffset;
			}
			this._navigator.addChild(newScreenParent);
			newScreenParent.addChild(delegate);
			newScreen.visible = false;
			this._savedNewScreen = newScreen;
			targetParent = newScreenParent;
		}
		if(oldScreen)
		{
			var oldScreenParent:Sprite3D = new Sprite3D();
			delegate = new RenderDelegate(oldScreen);
			delegate.alpha = oldScreen.alpha;
			delegate.blendMode = oldScreen.blendMode;
			delegate.rotation = oldScreen.rotation;
			delegate.scaleX = oldScreen.scaleX;
			delegate.scaleY = oldScreen.scaleY;
			if(rotationYOffset != 0)
			{
				delegate.x = -oldScreen.width / 2;
				oldScreenParent.x = oldScreen.width / 2;
			}
			if(rotationXOffset != 0)
			{
				delegate.y = -oldScreen.height / 2;
				oldScreenParent.y = oldScreen.height / 2;
			}
			oldScreenParent.rotationY = 0;
			oldScreenParent.rotationX = 0;
			if(!targetParent)
			{
				this._navigator = oldScreen.parent;
				duration = duration / 2;
				targetParent = oldScreenParent;
			}
			else
			{
				newScreenParent.visible = false;
				this._otherTarget = oldScreenParent;
			}
			this._navigator.addChild(oldScreenParent);
			oldScreenParent.addChild(delegate);
			oldScreen.visible = false;
			this._savedOldScreen = oldScreen;
		}
		else
		{
			newScreenParent.rotationY /= 2;
			newScreenParent.rotationX /= 2;
			duration = duration / 2;
		}

		super(targetParent, duration, ease);

		var targetParent:Sprite3D;
		if(newScreenParent)
		{
			if(rotationYOffset != 0)
			{
				this.animate("rotationY", 0);
			}
			if(rotationXOffset != 0)
			{
				this.animate("rotationX", 0);
			}
		}
		else //we only have the old screen
		{
			if(rotationYOffset != 0)
			{
				this.animate("rotationY", rotationYOffset / 2);
			}
			if(rotationXOffset != 0)
			{
				this.animate("rotationX", rotationXOffset / 2);
			}
		}
		this._rotationYOffset = rotationYOffset;
		this._rotationXOffset = rotationXOffset;
		if(tweenProperties)
		{
			for(var propertyName:String in tweenProperties)
			{
				this[propertyName] = tweenProperties[propertyName];
			}
		}

		if(this._otherTarget)
		{
			this.onUpdate = this.updateOtherTarget;
		}
		this._onCompleteCallback = onCompleteCallback;
		this.onComplete = this.cleanupTween;
	}

	private var _navigator:DisplayObjectContainer;
	private var _otherTarget:Sprite3D;
	private var _onCompleteCallback:Function;
	private var _rotationYOffset:Number = 0;
	private var _rotationXOffset:Number = 0;
	private var _savedNewScreen:DisplayObject;
	private var _savedOldScreen:DisplayObject;

	private function updateOtherTarget():void
	{
		var targetParent:Sprite3D = Sprite3D(this.target);
		if(this.progress >= 0.5 && this._otherTarget.visible)
		{
			targetParent.visible = true;
			this._otherTarget.visible = false;
		}
		else if(this.progress < 0.5 && !this._otherTarget.visible)
		{
			targetParent.visible = false;
			this._otherTarget.visible = true;
		}
		if(this._rotationYOffset < 0)
		{
			this._otherTarget.rotationY = targetParent.rotationY + Math.PI;
		}
		else if(this._rotationYOffset > 0)
		{
			this._otherTarget.rotationY = targetParent.rotationY - Math.PI;
		}
		if(this._rotationXOffset < 0)
		{
			this._otherTarget.rotationX = targetParent.rotationX + Math.PI;
		}
		else if(this._rotationXOffset > 0)
		{
			this._otherTarget.rotationX = targetParent.rotationX - Math.PI;
		}
	}

	private function cleanupTween():void
	{
		var targetParent:Sprite3D = Sprite3D(this.target);
		targetParent.removeFromParent(true);
		if(this._otherTarget)
		{
			this._otherTarget.removeFromParent(true);
		}
		if(this._savedNewScreen)
		{
			this._savedNewScreen.visible = true;
			this._savedNewScreen = null;
		}
		if(this._savedOldScreen)
		{
			this._savedOldScreen.visible = true;
			this._savedOldScreen = null;
		}
		if(this._onCompleteCallback !== null)
		{
			this._onCompleteCallback();
		}
	}
}

================================================
FILE: source/feathers/motion/Iris.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion
{
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.motion.effectClasses.TweenEffectContext;

	import flash.geom.Point;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.Canvas;
	import starling.display.DisplayObject;
	import starling.events.Event;
	import starling.utils.Pool;

	/**
	 * Creates effects for Feathers components and transitions for screen
	 * navigators that show or hide a display object masked by a growing or
	 * shrinking circle. In a transition, both display objects remain stationary
	 * while a stencil mask is animated.
	 *
	 * <p>Note: This effect is not supported with display objects that have
	 * transparent backgrounds due to limitations in stencil masks. Display
	 * objects should be fully opaque.</p>
	 *
	 * @see ../../../help/effects.html Effects and animation for Feathers components
	 * @see ../../../help/transitions.html#iris Transitions for Feathers screen navigators: Iris
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class Iris
	{
		/**
		 * @private
		 */
		protected static const IRIS_MASK_NAME:String = "feathers-iris-effect-mask";

		/**
		 * @private
		 */
		protected static const SCREEN_REQUIRED_ERROR:String = "Cannot transition if both old screen and new screen are null.";

		/**
		 * Creates an effect function for the target component that shows the
		 * component by masking it with a growing circle in the center.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createIrisOpenEffect(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return createIrisOpenEffectAtRatio(0.5, 0.5, duration, ease, interruptBehavior);
		}

		/**
		 * Creates an effect function for the target component that shows the
		 * component by masking it with a growing circle at a specific position
		 * in the range from 0.0 to 1.0.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createIrisOpenEffectAtRatio(ratioX:Number, ratioY:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var maskWidth:Number = target.width;
				var maskHeight:Number = target.height;
				if(maskWidth < 0)
				{
					maskWidth = 1;
				}
				if(maskHeight < 0)
				{
					maskHeight = 1;
				}
				return createIrisOpenEffectContextAtXY(target, maskWidth * ratioX, maskHeight * ratioY, duration, ease, interruptBehavior);
			};
		}

		/**
		 * Creates an effect function for the target component that shows the
		 * component by masking it with a growing circle at a specific position.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createIrisOpenEffectAtXY(x:Number, y:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				return createIrisOpenEffectContextAtXY(target, x, y, duration, ease, interruptBehavior);
			};
		}

		/**
		 * @private
		 */
		protected static function createIrisOpenEffectContextAtXY(target:DisplayObject, originX:Number, originY:Number, duration:Number, ease:Object, interruptBehavior:String):IEffectContext
		{
			var mask:Canvas = null;
			var oldMask:DisplayObject = target.mask;
			if(oldMask is Canvas && oldMask.name === IRIS_MASK_NAME)
			{
				mask = Canvas(oldMask);
			}
			var maskWidth:Number = target.width;
			var maskHeight:Number = target.height;
			if(maskWidth < 0)
			{
				maskWidth = 1;
			}
			if(maskHeight < 0)
			{
				maskHeight = 1;
			}
			var halfWidth:Number = maskWidth / 2;
			var halfHeight:Number = maskHeight / 2;
			var p1:Point = Pool.getPoint(halfWidth, halfHeight);
			var p2:Point = Pool.getPoint(originX, originY);
			var radiusFromCenter:Number = p1.length;
			if(p1.equals(p2))
			{
				var radius:Number = radiusFromCenter;
			}
			else
			{
				var distanceFromCenterToOrigin:Number = Point.distance(p1, p2);
				radius = radiusFromCenter + distanceFromCenterToOrigin;
			}
			Pool.putPoint(p1);
			Pool.putPoint(p2);
			if(mask === null)
			{
				mask = new Canvas();
				mask.name = IRIS_MASK_NAME;
				mask.x = originX;
				mask.y = originY;
				mask.beginFill(0xff00ff);
				mask.drawCircle(0, 0, radius);
				mask.endFill();
				mask.scale = 0;
				target.mask = mask;
			}
			else
			{
				mask.clear();
				mask.beginFill(0xff00ff);
				//the radius may have changed
				mask.drawCircle(0, 0, radius);
				mask.endFill();
			}
			var tween:Tween = new Tween(mask, duration, ease);
			tween.animate("scale", 1);
			if(mask === oldMask)
			{
				//the x and y position may have changed
				if(mask.x != originX)
				{
					tween.animate("x", originX);
				}
				if(mask.y != originY)
				{
					tween.animate("y", originY);
				}
			}
			var context:TweenEffectContext = new TweenEffectContext(target, tween);
			context.interruptBehavior = interruptBehavior;
			context.addEventListener(Event.COMPLETE, function(event:Event, stopped:Boolean):void
			{
				if(stopped)
				{
					return;
				}
				mask.removeFromParent(true);
				if(mask === oldMask)
				{
					target.mask = null;
				}
				else
				{
					target.mask = oldMask;
				}
			});
			return context;
		}

		/**
		 * Creates an effect function for the target component that hides the
		 * component by masking it with a shrinking circle in the center.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createIrisCloseEffect(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return createIrisCloseEffectAtRatio(0.5, 0.5, duration, ease, interruptBehavior);
		}

		/**
		 * Creates an effect function for the target component that hides the
		 * component by masking it with a shrinking circle at a specific position
		 * in the range 0.0 to 1.0.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createIrisCloseEffectAtRatio(ratioX:Number, ratioY:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var maskWidth:Number = target.width;
				var maskHeight:Number = target.height;
				if(maskWidth < 0)
				{
					maskWidth = 1;
				}
				if(maskHeight < 0)
				{
					maskHeight = 1;
				}
				return createIrisCloseEffectContextAtXY(target, maskWidth * ratioX, maskHeight * ratioY, duration, ease, interruptBehavior);
			};
		}

		/**
		 * Creates an effect function for the target component that hides the
		 * component by masking it with a shrinking circle at a specific position.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createIrisCloseEffectAtXY(x:Number, y:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				return createIrisCloseEffectContextAtXY(target, x, y, duration, ease, interruptBehavior);
			};
		}

		/**
		 * @private
		 */
		protected static function createIrisCloseEffectContextAtXY(target:DisplayObject, originX:Number, originY:Number, duration:Number, ease:Object, interruptBehavior:String):IEffectContext
		{
			var mask:Canvas = null;
			var oldMask:DisplayObject = target.mask;
			if(oldMask is Canvas && oldMask.name === IRIS_MASK_NAME)
			{
				mask = Canvas(oldMask);
			}
			var maskWidth:Number = target.width;
			var maskHeight:Number = target.height;
			if(maskWidth < 0)
			{
				maskWidth = 1;
			}
			if(maskHeight < 0)
			{
				maskHeight = 1;
			}
			var halfWidth:Number = maskWidth / 2;
			var halfHeight:Number = maskHeight / 2;
			var p1:Point = Pool.getPoint(halfWidth, halfHeight);
			var p2:Point = Pool.getPoint(originX, originY);
			var radiusFromCenter:Number = p1.length;
			if(p1.equals(p2))
			{
				var radius:Number = radiusFromCenter;
			}
			else
			{
				var distanceFromCenterToOrigin:Number = Point.distance(p1, p2);
				radius = radiusFromCenter + distanceFromCenterToOrigin;
			}
			Pool.putPoint(p1);
			Pool.putPoint(p2);
			if(mask === null)
			{
				mask = new Canvas();
				mask.name = IRIS_MASK_NAME;
				mask.x = originX;
				mask.y = originY;
				mask.beginFill(0xff00ff);
				mask.drawCircle(0, 0, radius);
				mask.endFill();
				target.mask = mask;
			}
			else
			{
				mask.clear();
				mask.beginFill(0xff00ff);
				//the radius may have changed
				mask.drawCircle(0, 0, radius);
				mask.endFill();
			}
			var tween:Tween = new Tween(mask, duration, ease);
			tween.animate("scale", 0);
			if(mask === oldMask)
			{
				//the x and y position may have changed
				if(mask.x != originX)
				{
					tween.animate("x", originX);
				}
				if(mask.y != originY)
				{
					tween.animate("y", originY);
				}
			}
			var context:TweenEffectContext = new TweenEffectContext(target, tween);
			context.interruptBehavior = interruptBehavior;
			context.addEventListener(Event.COMPLETE, function(event:Event, stopped:Boolean):void
			{
				if(stopped)
				{
					return;
				}
				mask.removeFromParent(true);
				if(mask === oldMask)
				{
					target.mask = null;
				}
				else
				{
					target.mask = oldMask;
				}
			});
			return context;
		}

		/**
		 * Creates a transition function for a screen navigator that shows a
		 * screen by masking it with a growing circle in the center.
		 *
		 * @see ../../../help/transitions.html#iris Transitions for Feathers screen navigators: Iris
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createIrisOpenTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(oldScreen)
				{
					var originX:Number = oldScreen.width / 2;
					var originY:Number = oldScreen.height / 2;
				}
				else
				{
					originX = newScreen.width / 2;
					originY = newScreen.height / 2;
				}
				var tween:IrisTween = new IrisTween(newScreen, oldScreen, originX, originY, true, duration, ease, onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that shows a
		 * screen by masking it with a growing circle at a specific position.
		 *
		 * @see ../../../help/transitions.html#iris Transitions for Feathers screen navigators: Iris
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createIrisOpenTransitionAt(x:Number, y:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				var tween:IrisTween = new IrisTween(newScreen, oldScreen, x, y, true, duration, ease, onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that hides a
		 * screen by masking it with a shrinking circle in the center.
		 *
		 * @see ../../../help/transitions.html#iris Transitions for Feathers screen navigators: Iris
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createIrisCloseTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(oldScreen)
				{
					var originX:Number = oldScreen.width / 2;
					var originY:Number = oldScreen.height / 2;
				}
				else
				{
					originX = newScreen.width / 2;
					originY = newScreen.height / 2;
				}
				var tween:IrisTween = new IrisTween(newScreen, oldScreen, originX, originY, false, duration, ease, onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that hides a
		 * screen by masking it with a shrinking circle at a specific position.
		 *
		 * @see ../../../help/transitions.html#iris Transitions for Feathers screen navigators: Iris
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createIrisCloseTransitionAt(x:Number, y:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				var tween:IrisTween = new IrisTween(newScreen, oldScreen, x, y, false, duration, ease, onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}
	}
}

import feathers.display.RenderDelegate;

import flash.geom.Point;

import starling.animation.Tween;
import starling.core.Starling;
import starling.display.Canvas;
import starling.display.DisplayObject;
import starling.events.Event;

class IrisTween extends Tween
{
	public function IrisTween(newScreen:DisplayObject, oldScreen:DisplayObject,
		originX:Number, originY:Number, openIris:Boolean, duration:Number, ease:Object,
		onCompleteCallback:Function, tweenProperties:Object)
	{
		if(newScreen)
		{
			var width:Number = newScreen.width;
			var height:Number = newScreen.height;
		}
		else
		{
			width = oldScreen.width;
			height = oldScreen.height;
		}
		var halfWidth:Number = width / 2;
		var halfHeight:Number = height / 2;
		var p1:Point = new Point(halfWidth, halfHeight);
		var p2:Point = new Point(originX, originY);
		var radiusFromCenter:Number = p1.length;
		if(p1.equals(p2))
		{
			var radius:Number = radiusFromCenter;
		}
		else
		{
			var distanceFromCenterToOrigin:Number = Point.distance(p1, p2);
			radius = radiusFromCenter + distanceFromCenterToOrigin;
		}
		var maskTarget:Canvas;
		if(newScreen && openIris)
		{
			this._newScreenDelegate = new RenderDelegate(newScreen);
			this._newScreenDelegate.alpha = newScreen.alpha;
			this._newScreenDelegate.blendMode = newScreen.blendMode;
			this._newScreenDelegate.rotation = newScreen.rotation;
			this._newScreenDelegate.scaleX = newScreen.scaleX;
			this._newScreenDelegate.scaleY = newScreen.scaleY;
			newScreen.parent.addChild(this._newScreenDelegate);
			newScreen.visible = false;
			this._savedNewScreen = newScreen;

			var mask:Canvas = new Canvas();
			mask.x = originX;
			mask.y = originY;
			mask.beginFill(0xff00ff);
			mask.drawCircle(0, 0, radius);
			mask.endFill();
			if(openIris)
			{
				mask.scaleX = 0;
				mask.scaleY = 0;
			}
			if(openIris)
			{
				this._newScreenDelegate.mask = mask;
			}
			newScreen.parent.addChild(mask);
			maskTarget = mask;
		}
		if(oldScreen && !openIris)
		{
			this._oldScreenDelegate = new RenderDelegate(oldScreen);
			this._oldScreenDelegate.alpha = oldScreen.alpha;
			this._oldScreenDelegate.blendMode = oldScreen.blendMode;
			this._oldScreenDelegate.rotation = oldScreen.rotation;
			this._oldScreenDelegate.scaleX = oldScreen.scaleX;
			this._oldScreenDelegate.scaleY = oldScreen.scaleY;
			oldScreen.parent.addChild(this._oldScreenDelegate);
			oldScreen.visible = false;
			this._savedOldScreen = oldScreen;

			mask = new Canvas();
			mask.x = originX;
			mask.y = originY;
			mask.beginFill(0xff00ff);
			mask.drawCircle(0, 0, radius);
			mask.endFill();
			if(!openIris)
			{
				this._oldScreenDelegate.mask = mask;
			}
			oldScreen.parent.addChild(mask);
			maskTarget = mask;
		}

		super(maskTarget, duration, ease);

		if(openIris)
		{
			this.animate("scaleX", 1);
			this.animate("scaleY", 1);
		}
		else
		{
			this.animate("scaleX", 0);
			this.animate("scaleY", 0);
		}

		if(tweenProperties)
		{
			for(var propertyName:String in tweenProperties)
			{
				this[propertyName] = tweenProperties[propertyName];
			}
		}
		this._savedWidth = width;
		this._savedHeight = height;
		this._onCompleteCallback = onCompleteCallback;
		this.onComplete = this.cleanupTween;
	}

	private var _newScreenDelegate:RenderDelegate;
	private var _oldScreenDelegate:RenderDelegate;
	private var _savedOldScreen:DisplayObject;
	private var _savedNewScreen:DisplayObject;
	private var _onCompleteCallback:Function;
	private var _savedWidth:Number;
	private var _savedHeight:Number;

	private function cleanupTween():void
	{
		if(this._newScreenDelegate)
		{
			this._newScreenDelegate.mask.removeFromParent(true);
			this._newScreenDelegate.removeFromParent(true);
			this._newScreenDelegate = null;
		}
		if(this._oldScreenDelegate)
		{
			this._oldScreenDelegate.mask.removeFromParent(true);
			this._oldScreenDelegate.removeFromParent(true);
			this._oldScreenDelegate = null;
		}
		if(this._savedNewScreen)
		{
			this._savedNewScreen.visible = true;
			this._savedNewScreen = null;
		}
		if(this._savedOldScreen)
		{
			this._savedOldScreen.visible = true;
			this._savedOldScreen = null;
		}
		if(this._onCompleteCallback !== null)
		{
			this._onCompleteCallback();
		}
	}

}

================================================
FILE: source/feathers/motion/Move.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion
{
	import feathers.motion.effectClasses.IMoveEffectContext;
	import feathers.motion.effectClasses.TweenMoveEffectContext;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.display.DisplayObject;

	/**
	 * An effect that animates a component's <code>x</code> and <code>y</code>
	 * position.
	 *
	 * @see ../../../help/effects.html Effects and animation for Feathers components
	 *
	 * @productversion Feathers 3.5.0
	 */
	public class Move
	{
		/**
		 * Creates an effect function for the target component that animates
		 * its x and y position when they are changed. Must be used with
		 * the <code>moveEffect</code> property.
		 *
		 * @see feathers.core.FeathersControl#moveEffect
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createMoveEffect(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.STOP):Function
		{
			return function(target:DisplayObject):IMoveEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				var context:TweenMoveEffectContext = new TweenMoveEffectContext(target, tween);
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its position from its current location to a new
		 * location.
		 *
		 * @productversion Feathers 3.5.0
		 *
		 * @see #createMoveXToEffect()
		 * @see #createMoveYToEffect()
		 */
		public static function createMoveToEffect(toX:Number, toY:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IMoveEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				var context:TweenMoveEffectContext = new TweenMoveEffectContext(target, tween);
				context.oldX = target.x;
				context.oldY = target.y;
				context.newX = toX;
				context.newY = toY;
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its <strong>x</strong> position from its current location to
		 * a new location.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createMoveXToEffect(toX:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IMoveEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				var context:TweenMoveEffectContext = new TweenMoveEffectContext(target, tween);
				context.oldX = target.x;
				context.oldY = target.y;
				context.newX = toX;
				context.newY = target.y;
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its <strong>y</strong> position from its current location to
		 * a new location.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createMoveYToEffect(toY:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IMoveEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				var context:TweenMoveEffectContext = new TweenMoveEffectContext(target, tween);
				context.oldX = target.x;
				context.oldY = target.y;
				context.newX = target.x;
				context.newY = toY;
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its position from a specific location to its
		 * current location.
		 *
		 * @productversion Feathers 3.5.0
		 *
		 * @see #createMoveXFromEffect()
		 * @see #createMoveYFromEffect()
		 */
		public static function createMoveFromEffect(fromX:Number, fromY:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IMoveEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				var context:TweenMoveEffectContext = new TweenMoveEffectContext(target, tween);
				context.oldX = fromX;
				context.oldY = fromY;
				context.newX = target.x;
				context.newY = target.y;
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its <strong>x</strong> position from a specific location to
		 * its current location.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createMoveXFromEffect(fromX:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IMoveEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				var context:TweenMoveEffectContext = new TweenMoveEffectContext(target, tween);
				context.oldX = fromX;
				context.oldY = target.y;
				context.newX = target.x;
				context.newY = target.y;
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its <strong>y</strong> position from a specific location to
		 * its current location.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createMoveYFromEffect(fromY:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IMoveEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				var context:TweenMoveEffectContext = new TweenMoveEffectContext(target, tween);
				context.oldX = target.x;
				context.oldY = fromY;
				context.newX = target.x;
				context.newY = target.y;
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its position from its current location to a new
		 * location calculated by an offset.
		 *
		 * @productversion Feathers 3.5.0
		 *
		 * @see #createMoveXByEffect()
		 * @see #createMoveYByEffect()
		 */
		public static function createMoveByEffect(xBy:Number, yBy:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IMoveEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				var context:TweenMoveEffectContext = new TweenMoveEffectContext(target, tween);
				context.oldX = target.x;
				context.oldY = target.y;
				context.newX = target.x + xBy;
				context.newY = target.y + yBy;
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its <strong>x</strong> position from its current location to
		 * a new location calculated by an offset.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createMoveXByEffect(xBy:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IMoveEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				var context:TweenMoveEffectContext = new TweenMoveEffectContext(target, tween);
				context.oldX = target.x;
				context.oldY = target.y;
				context.newX = target.x + xBy;
				context.newY = target.y;
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its <strong>y</strong> position from its current location to
		 * a new location calculated by an offset.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createMoveYByEffect(yBy:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IMoveEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				var context:TweenMoveEffectContext = new TweenMoveEffectContext(target, tween);
				context.oldX = target.x;
				context.oldY = target.y;
				context.newX = target.x;
				context.newY = target.y + yBy;
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}
	}
}

================================================
FILE: source/feathers/motion/Parallel.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion
{
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.motion.effectClasses.ParallelEffectContext;

	import starling.display.DisplayObject;

	/**
	 * Combines multiple effects that play at the same time, in parallel.
	 *
	 * @see ../../../help/effects.html Effects and animation for Feathers components
	 *
	 * @productversion Feathers 3.5.0
	 */
	public class Parallel
	{
		/**
		 * Creates an effect function that combines multiple effect functions
		 * that will play at the same time, in parallel.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createParallelEffect(effect1:Function, effect2:Function, ...rest:Array):Function
		{
			//the order doesn't matter, so just add them at the end
			rest[rest.length] = effect1;
			rest[rest.length] = effect2;
			return function(target:DisplayObject):IEffectContext
			{
				return new ParallelEffectContext(target, rest);
			};
		}
	}
}

================================================
FILE: source/feathers/motion/Resize.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion
{
	import feathers.core.IFeathersControl;
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.motion.effectClasses.IResizeEffectContext;
	import feathers.motion.effectClasses.TweenEffectContext;
	import feathers.motion.effectClasses.TweenResizeEffectContext;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.display.DisplayObject;

	/**
	 * An effect that animates a component's <code>width</code> and
	 * <code>height</code> dimensions.
	 *
	 * @see ../../../help/effects.html Effects and animation for Feathers components
	 *
	 * @productversion Feathers 3.5.0
	 */
	public class Resize
	{
		/**
		 * Creates an effect function for the target component that animates
		 * its dimensions when they are changed. Must be used with the
		 * <code>resizeEffect</code> property.
		 *
		 * @see feathers.core.FeathersControl#resizeEffect
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createResizeEffect(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.STOP):Function
		{
			return function(target:DisplayObject):IResizeEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				var context:TweenResizeEffectContext = new TweenResizeEffectContext(target, tween);
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its dimensions from their current values to new values.
		 *
		 * @productversion Feathers 3.5.0
		 *
		 * @see #createResizeWidthToEffect()
		 * @see #createResizeHeightToEffect()
		 */
		public static function createResizeToEffect(toWidth:Number, toHeight:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				tween.animate("width", toWidth);
				tween.animate("height", toHeight);
				var context:TweenEffectContext = new TweenEffectContext(target, tween);
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its <strong>width</strong> from its current value to a new
		 * value.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createResizeWidthToEffect(toWidth:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				tween.animate("width", toWidth);
				var context:TweenEffectContext = new TweenEffectContext(target, tween);
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its <strong>height</strong> from its current value to a new
		 * value.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createResizeHeightToEffect(toHeight:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				tween.animate("height", toHeight);
				var context:TweenEffectContext = new TweenEffectContext(target, tween);
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its dimensions from specific values to its
		 * current values.
		 *
		 * @productversion Feathers 3.5.0
		 *
		 * @see #createResizeWidthFromEffect()
		 * @see createResizeHeightFromEffect()
		 */
		public static function createResizeFromEffect(fromWidth:Number, fromHeight:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var oldWidth:Number = target.width;
				var oldHeight:Number = target.height;
				if(target is IFeathersControl)
				{
					var oldExplicitWidth:Number = IFeathersControl(target).explicitWidth;
					var oldExplicitHeight:Number = IFeathersControl(target).explicitHeight;
					if(oldExplicitWidth === oldExplicitWidth || //!isNaN
						oldExplicitHeight === oldExplicitHeight) //!isNaN
					{
						tween.onComplete = function():void
						{
							//restore the original explicit height
							target.width = oldExplicitWidth;
							target.height = oldExplicitHeight;
						};
					}
					IFeathersControl(target).suspendEffects();
				}
				target.width = fromWidth;
				target.height = fromHeight;
				if(target is IFeathersControl)
				{
					IFeathersControl(target).resumeEffects();
				}
				var tween:Tween = new Tween(target, duration, ease);
				tween.animate("width", oldWidth);
				tween.animate("height", oldHeight);
				var context:TweenEffectContext = new TweenEffectContext(target, tween);
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its <strong>width</strong> from a specific value to its
		 * current value.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createResizeWidthFromEffect(fromWidth:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var oldWidth:Number = target.width;
				if(target is IFeathersControl)
				{
					var oldExplicitWidth:Number = IFeathersControl(target).explicitWidth;
					if(oldExplicitWidth === oldExplicitWidth) //!isNaN
					{
						tween.onComplete = function():void
						{
							//restore the original explicit width
							target.width = oldExplicitWidth;
						};
					}
					IFeathersControl(target).suspendEffects();
				}
				target.width = fromWidth;
				if(target is IFeathersControl)
				{
					IFeathersControl(target).resumeEffects();
				}
				var tween:Tween = new Tween(target, duration, ease);
				tween.animate("width", oldWidth);
				var context:TweenEffectContext = new TweenEffectContext(target, tween);
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its <strong>height</strong> from a specific value to its
		 * current value.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createResizeHeightFromEffect(fromHeight:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var oldHeight:Number = target.height;
				if(target is IFeathersControl)
				{
					var oldExplicitHeight:Number = IFeathersControl(target).explicitHeight;
					if(oldExplicitHeight === oldExplicitHeight) //!isNaN
					{
						tween.onComplete = function():void
						{
							//restore the original explicit height
							target.height = oldExplicitHeight;
						};
					}
					IFeathersControl(target).suspendEffects();
				}
				target.height = fromHeight;
				if(target is IFeathersControl)
				{
					IFeathersControl(target).resumeEffects();
				}
				var tween:Tween = new Tween(target, duration, ease);
				tween.animate("height", oldHeight);
				var context:TweenEffectContext = new TweenEffectContext(target, tween);
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its dimensions from its current values to new values
		 * calculated by an offset.
		 *
		 * @productversion Feathers 3.5.0
		 *
		 * @see #createResizeWidthByEffect()
		 * @see #createResizeHeightByEffect()
		 */
		public static function createResizeByEffect(widthBy:Number, heightBy:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				tween.animate("width", target.width + widthBy);
				tween.animate("height", target.height + heightBy);
				var context:TweenEffectContext = new TweenEffectContext(target, tween);
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its <strong>width</strong> from its current value to a new
		 * value calculated by an offset.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createResizeWidthByEffect(widthBy:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				tween.animate("width", target.width + widthBy);
				var context:TweenEffectContext = new TweenEffectContext(target, tween);
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}

		/**
		 * Creates an effect function for the target component that
		 * animates its <strong>height</strong> from its current value to a new
		 * value calculated by an offset.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createResizeHeightByEffect(heightBy:Number, duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, interruptBehavior:String = EffectInterruptBehavior.END):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var tween:Tween = new Tween(target, duration, ease);
				tween.animate("height", target.height + heightBy);
				var context:TweenEffectContext = new TweenEffectContext(target, tween);
				context.interruptBehavior = interruptBehavior;
				return context;
			};
		}
	}
}

================================================
FILE: source/feathers/motion/Reveal.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion
{
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.motion.effectClasses.TweenEffectContext;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.DisplayObject;

	/**
	 * Creates animated transitions for screen navigators that slide a display
	 * object out of view, by animating the <code>x</code> or <code>y</code>
	 * property, while revealing an existing display object that
	 * remains stationary below. The display object may slide up, right,
	 * down, or left.
	 *
	 * @see ../../../help/transitions.html#reveal Transitions for Feathers screen navigators: Reveal
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class Reveal
	{
		/**
		 * @private
		 */
		protected static const SCREEN_REQUIRED_ERROR:String = "Cannot transition if both old screen and new screen are null.";

		/**
		 * Creates a transition function for a screen navigator that slides the
		 * old screen out of view to the left, animating the <code>x</code>
		 * property, to reveal the new screen under it. The new screen remains
		 * stationary.
		 *
		 * @see ../../../help/transitions.html#reveal Transitions for Feathers screen navigators: Reveal
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createRevealLeftTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(oldScreen)
				{
					oldScreen.x = 0;
					oldScreen.y = 0;
				}
				if(newScreen)
				{
					newScreen.x = 0;
					newScreen.y = 0;
					var tween:RevealTween = new RevealTween(oldScreen, newScreen, -newScreen.width, 0, duration, ease, onComplete, tweenProperties);
					if(managed)
					{
						return new TweenEffectContext(null, tween);
					}
					Starling.juggler.add(tween);
					return null;
				}
				//we only have the old screen
				return slideOutOldScreen(oldScreen, -oldScreen.width, 0, duration, ease, tweenProperties, onComplete, managed);
			};
		}

		/**
		 * Creates a transition function for a screen navigator that slides the
		 * old screen out of view to the right, animating the <code>x</code>
		 * property, to reveal the new screen under it. The new screen remains
		 * stationary.
		 *
		 * @see ../../../help/transitions.html#reveal Transitions for Feathers screen navigators: Reveal
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createRevealRightTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(oldScreen)
				{
					oldScreen.x = 0;
					oldScreen.y = 0;
				}
				if(newScreen)
				{
					newScreen.x = 0;
					newScreen.y = 0;
					var tween:RevealTween = new RevealTween(oldScreen, newScreen, newScreen.width, 0, duration, ease, onComplete, tweenProperties);
					if(managed)
					{
						return new TweenEffectContext(null, tween);
					}
					Starling.juggler.add(tween);
					return null;
				}
				//we only have the old screen
				return slideOutOldScreen(oldScreen, oldScreen.width, 0, duration, ease, tweenProperties, onComplete, managed);
			};
		}

		/**
		 * Creates a transition function for a screen navigator that slides the
		 * old screen up out of view, animating the <code>y</code> property, to
		 * reveal the new screen under it. The new screen remains stationary.
		 *
		 * @see ../../../help/transitions.html#reveal Transitions for Feathers screen navigators: Reveal
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createRevealUpTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(oldScreen)
				{
					oldScreen.x = 0;
					oldScreen.y = 0;
				}
				if(newScreen)
				{
					newScreen.x = 0;
					newScreen.y = 0;
					var tween:RevealTween = new RevealTween(oldScreen, newScreen, 0, -newScreen.height, duration, ease, onComplete, tweenProperties);
					if(managed)
					{
						return new TweenEffectContext(null, tween);
					}
					Starling.juggler.add(tween);
					return null;
				}
				//we only have the old screen
				return slideOutOldScreen(oldScreen, 0, -oldScreen.height, duration, ease, tweenProperties, onComplete, managed);
			};
		}

		/**
		 * Creates a transition function for a screen navigator that slides the
		 * old screen down out of view, animating the <code>y</code> property,
		 * to reveal the new screen under it. The new screen remains stationary.
		 *
		 * @see ../../../help/transitions.html#reveal Transitions for Feathers screen navigators: Reveal
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createRevealDownTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(oldScreen)
				{
					oldScreen.x = 0;
					oldScreen.y = 0;
				}
				if(newScreen)
				{
					newScreen.x = 0;
					newScreen.y = 0;
					var tween:RevealTween = new RevealTween(oldScreen, newScreen, 0, newScreen.height, duration, ease, onComplete, tweenProperties);
					if(managed)
					{
						return new TweenEffectContext(null, tween);
					}
					Starling.juggler.add(tween);
					return null;
				}
				//we only have the old screen
				return slideOutOldScreen(oldScreen, 0, oldScreen.height, duration, ease, tweenProperties, onComplete, managed);
			};
		}

		/**
		 * @private
		 */
		private static function slideOutOldScreen(oldScreen:DisplayObject,
			xOffset:Number, yOffset:Number, duration:Number, ease:Object,
			tweenProperties:Object, onComplete:Function, managed:Boolean):IEffectContext
		{
			var tween:Tween = new Tween(oldScreen, duration, ease);
			if(xOffset != 0)
			{
				tween.animate("x", xOffset);
			}
			if(yOffset != 0)
			{
				tween.animate("y", yOffset);
			}
			if(tweenProperties)
			{
				for(var propertyName:String in tweenProperties)
				{
					tween[propertyName] = tweenProperties[propertyName];
				}
			}
			tween.onComplete = onComplete;
			if(managed)
			{
				return new TweenEffectContext(null, tween);
			}
			Starling.juggler.add(tween);
			return null;
		}
	}
}

import feathers.display.RenderDelegate;

import starling.animation.Tween;
import starling.core.Starling;
import starling.display.DisplayObject;
import starling.display.Quad;
import starling.display.Sprite;

class RevealTween extends Tween
{
	public function RevealTween(oldScreen:DisplayObject, newScreen:DisplayObject,
		xOffset:Number, yOffset:Number, duration:Number, ease:Object, onCompleteCallback:Function,
		tweenProperties:Object)
	{
		var mask:Quad = new Quad(1, 1, 0xff00ff);
		//the initial dimensions cannot be 0 or there's a runtime error
		mask.width = oldScreen.width;
		mask.height = oldScreen.height;
		mask.width = 0;
		mask.height = 0;
		if(xOffset == 0)
		{
			mask.width = newScreen.width;
		}
		else if(xOffset < 0)
		{
			mask.x = -xOffset;
		}
		if(yOffset == 0)
		{
			mask.height = newScreen.height;
		}
		else if(yOffset < 0)
		{
			mask.y = -yOffset;
		}
		this._temporaryParent = new Sprite();
		this._temporaryParent.mask = mask;
		newScreen.parent.addChild(this._temporaryParent);
		var delegate:RenderDelegate = new RenderDelegate(newScreen);
		delegate.alpha = newScreen.alpha;
		delegate.blendMode = newScreen.blendMode;
		delegate.rotation = newScreen.rotation;
		delegate.scaleX = newScreen.scaleX;
		delegate.scaleY = newScreen.scaleY;
		this._temporaryParent.addChild(delegate);
		newScreen.visible = false;
		this._savedNewScreen = newScreen;

		super(this._temporaryParent.mask, duration, ease);

		if(xOffset < 0)
		{
			this.animate("x", mask.x + xOffset);
			this.animate("width", -xOffset);
		}
		else if(xOffset > 0)
		{
			this.animate("width", xOffset);
		}
		if(yOffset < 0)
		{
			this.animate("y", mask.y + yOffset);
			this.animate("height", -yOffset);
		}
		else if(yOffset > 0)
		{
			this.animate("height", yOffset);
		}

		if(tweenProperties)
		{
			for(var propertyName:String in tweenProperties)
			{
				this[propertyName] = tweenProperties[propertyName];
			}
		}
		this._onCompleteCallback = onCompleteCallback;
		if(oldScreen)
		{
			this._savedOldScreen = oldScreen;
			this._savedXOffset = xOffset;
			this._savedYOffset = yOffset;
			this.onUpdate = this.updateOldScreen;
		}
		this.onComplete = this.cleanupTween;
	}

	private var _savedXOffset:Number;
	private var _savedYOffset:Number;
	private var _savedNewScreen:DisplayObject;
	private var _savedOldScreen:DisplayObject;
	private var _temporaryParent:Sprite;
	private var _onCompleteCallback:Function;

	private function updateOldScreen():void
	{
		var mask:Quad = Quad(this.target);
		if(this._savedXOffset < 0)
		{
			this._savedOldScreen.x = -mask.width;
		}
		else if(this._savedXOffset > 0)
		{
			this._savedOldScreen.x = mask.width;
		}
		if(this._savedYOffset < 0)
		{
			this._savedOldScreen.y = -mask.height;
		}
		else if(this._savedYOffset > 0)
		{
			this._savedOldScreen.y = mask.height;
		}
	}

	private function cleanupTween():void
	{
		this._temporaryParent.removeFromParent(true);
		this._temporaryParent = null;
		this._savedNewScreen.visible = true;
		this._savedNewScreen = null;
		if(this._savedOldScreen)
		{
			this._savedOldScreen.x = 0;
			this._savedOldScreen.y = 0;
			this._savedOldScreen = null;
		}
		if(this._onCompleteCallback !== null)
		{
			this._onCompleteCallback();
		}
	}

}

================================================
FILE: source/feathers/motion/Sequence.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion
{
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.motion.effectClasses.SequenceEffectContext;

	import starling.display.DisplayObject;

	/**
	 * Combines multiple effects that play one after another in sequence.
	 *
	 * @see ../../../help/effects.html Effects and animation for Feathers components
	 *
	 * @productversion Feathers 3.5.0
	 */
	public class Sequence
	{
		/**
		 * Creates an effect function that combines multiple effect functions
		 * that will play one after another, in sequence.
		 *
		 * @productversion Feathers 3.5.0
		 */
		public static function createSequenceEffect(effect1:Function, effect2:Function, ...rest:Array):Function
		{
			rest.unshift(effect2);
			rest.unshift(effect1);
			return function(target:DisplayObject):IEffectContext
			{
				return new SequenceEffectContext(target, rest);
			};
		}
	}
}

================================================
FILE: source/feathers/motion/Slide.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion
{
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.motion.effectClasses.TweenEffectContext;

	import starling.animation.Transitions;
	import starling.core.Starling;
	import starling.display.DisplayObject;

	/**
	 * Creates animated transitions for screen navigators that slides two
	 * display objects in the same direction (replacing one with the other) like
	 * a classic slide carousel. Animates the <code>x</code> and <code>y</code>
	 * properties of the display objects. The display objects may slide up,
	 * right, down, or left.
	 *
	 * @see ../../../help/transitions.html#slide Transitions for Feathers screen navigators: Slide
	 *
	 * @productversion Feathers 2.1.0
	 */
	public class Slide
	{
		/**
		 * @private
		 */
		protected static const SCREEN_REQUIRED_ERROR:String = "Cannot transition if both old screen and new screen are null.";

		/**
		 * Creates a transition function for a screen navigator that slides the
		 * new screen to the left from off-stage, pushing the old screen in the
		 * same direction.
		 *
		 * @see ../../../help/transitions.html#slide Transitions for Feathers screen navigators: Slide
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createSlideLeftTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(newScreen)
				{
					if(oldScreen)
					{
						oldScreen.x = 0;
						oldScreen.y = 0;
					}
					newScreen.x = newScreen.width;
					newScreen.y = 0;
					var tween:SlideTween = new SlideTween(newScreen, oldScreen, -newScreen.width, 0, duration, ease, onComplete, tweenProperties);
				}
				else //we only have the old screen
				{
					oldScreen.x = 0;
					oldScreen.y = 0;
					tween = new SlideTween(oldScreen, null, -oldScreen.width, 0, duration, ease, onComplete, tweenProperties);
				}
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that that slides
		 * the new screen to the right from off-stage, pushing the old screen in
		 * the same direction.
		 *
		 * @see ../../../help/transitions.html#slide Transitions for Feathers screen navigators: Slide
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createSlideRightTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(newScreen)
				{
					if(oldScreen)
					{
						oldScreen.x = 0;
						oldScreen.y = 0;
					}
					newScreen.x = -newScreen.width;
					newScreen.y = 0;
					var tween:SlideTween = new SlideTween(newScreen, oldScreen, newScreen.width, 0, duration, ease, onComplete, tweenProperties);
				}
				else //we only have the old screen
				{
					oldScreen.x = 0;
					oldScreen.y = 0;
					tween = new SlideTween(oldScreen, null, oldScreen.width, 0, duration, ease, onComplete, tweenProperties);
				}
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that that slides
		 * the new screen up from off-stage, pushing the old screen in the same
		 * direction.
		 *
		 * @see ../../../help/transitions.html#slide Transitions for Feathers screen navigators: Slide
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createSlideUpTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(newScreen)
				{
					if(oldScreen)
					{
						oldScreen.x = 0;
						oldScreen.y = 0;
					}
					newScreen.x = 0;
					newScreen.y = newScreen.height;
					var tween:SlideTween = new SlideTween(newScreen, oldScreen, 0, -newScreen.height, duration, ease, onComplete, tweenProperties);
				}
				else //we only have the old screen
				{
					oldScreen.x = 0;
					oldScreen.y = 0;
					tween = new SlideTween(oldScreen, null, 0, -oldScreen.height, duration, ease, onComplete, tweenProperties);
				}
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that that slides
		 * the new screen down from off-stage, pushing the old screen in the
		 * same direction.
		 *
		 * @see ../../../help/transitions.html#slide Transitions for Feathers screen navigators: Slide
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createSlideDownTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				if(newScreen)
				{
					if(oldScreen)
					{
						oldScreen.x = 0;
						oldScreen.y = 0;
					}
					newScreen.x = 0;
					newScreen.y = -newScreen.height;
					var tween:SlideTween = new SlideTween(newScreen, oldScreen, 0, newScreen.height, duration, ease, onComplete, tweenProperties);
				}
				else //we only have the old screen
				{
					oldScreen.x = 0;
					oldScreen.y = 0;
					tween = new SlideTween(oldScreen, null, 0, oldScreen.height, duration, ease, onComplete, tweenProperties);
				}
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}
	}
}

import starling.animation.Tween;
import starling.core.Starling;
import starling.display.DisplayObject;

class SlideTween extends Tween
{
	public function SlideTween(target:DisplayObject, otherTarget:DisplayObject,
		xOffset:Number, yOffset:Number, duration:Number, ease:Object,
		onCompleteCallback:Function, tweenProperties:Object)
	{
		super(target, duration, ease);
		if(xOffset != 0)
		{
			this._xOffset = xOffset;
			this.animate("x", target.x + xOffset);
		}
		if(yOffset != 0)
		{
			this._yOffset = yOffset;
			this.animate("y", target.y + yOffset);
		}
		if(tweenProperties)
		{
			for(var propertyName:String in tweenProperties)
			{
				this[propertyName] = tweenProperties[propertyName];
			}
		}
		this._navigator = target.parent;
		if(otherTarget)
		{
			this._otherTarget = otherTarget;
			this.onUpdate = this.updateOtherTarget;
		}
		this._onCompleteCallback = onCompleteCallback;
		this.onComplete = this.cleanupTween;
	}

	private var _navigator:DisplayObject;
	private var _otherTarget:DisplayObject;
	private var _onCompleteCallback:Function;
	private var _xOffset:Number = 0;
	private var _yOffset:Number = 0;

	private function updateOtherTarget():void
	{
		var newScreen:DisplayObject = DisplayObject(this.target);
		if(this._xOffset < 0)
		{
			this._otherTarget.x = newScreen.x - this._navigator.width;
		}
		else if(this._xOffset > 0)
		{
			this._otherTarget.x = newScreen.x + newScreen.width;
		}
		if(this._yOffset < 0)
		{
			this._otherTarget.y = newScreen.y - this._navigator.height;
		}
		else if(this._yOffset > 0)
		{
			this._otherTarget.y = newScreen.y + newScreen.height;
		}
	}

	private function cleanupTween():void
	{
		this.target.x = 0;
		this.target.y = 0;
		if(this._otherTarget)
		{
			this._otherTarget.x = 0;
			this._otherTarget.y = 0;
		}
		if(this._onCompleteCallback !== null)
		{
			this._onCompleteCallback();
		}
	}
}

================================================
FILE: source/feathers/motion/Wipe.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion
{
	import feathers.motion.effectClasses.IEffectContext;
	import feathers.motion.effectClasses.TweenEffectContext;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Quad;

	/**
	 * Creates effects for Feathers components and transitions for screen
	 * navigators that wipe a display object out of view, revealing another
	 * display object under the first. Both display objects remain stationary
	 * while the effect animates clipping rectangles. The clipping rectangles
	 * may be animated up, right, down, or left.
	 *
	 * @see ../../../help/effects.html Effects and animation for Feathers components
	 * @see ../../../help/transitions.html#wipe Transitions for Feathers screen navigators: Wipe
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class Wipe
	{
		/**
		 * @private
		 */
		protected static const SCREEN_REQUIRED_ERROR:String = "Cannot transition if both old screen and new screen are null.";

		/**
		 * Creates an effect function for the target component that wipes the
		 * target component into view from right to left, animating the
		 * <code>width</code> and <code>x</code> properties of a temporary mask.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 */
		public static function createWipeInLeftEffect(duration:Number = 0.25, ease:Object = Transitions.EASE_OUT):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var oldMask:DisplayObject = target.mask;
				var maskWidth:Number = target.width;
				var maskHeight:Number = target.height;
				if(maskWidth < 0)
				{
					maskWidth = 1;
				}
				if(maskHeight < 0)
				{
					maskHeight = 1;
				}
				var mask:Quad = new Quad(maskWidth, maskHeight, 0xff00ff);
				mask.width = 0;
				mask.x = maskWidth;
				target.mask = mask;
				var tween:Tween = new Tween(mask, duration, ease);
				tween.animate("width", maskWidth);
				tween.animate("x", 0);
				tween.onComplete = function():void
				{
					target.mask = oldMask;
					mask.removeFromParent(true);
				};
				return new TweenEffectContext(target, tween);
			};
		}

		/**
		 * Creates an effect function for the target component that wipes the
		 * target component into view from left to right, animating the
		 * <code>width</code> property of a temporary mask.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 */
		public static function createWipeInRightEffect(duration:Number = 0.25, ease:Object = Transitions.EASE_OUT):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var oldMask:DisplayObject = target.mask;
				var maskWidth:Number = target.width;
				var maskHeight:Number = target.height;
				if(maskWidth < 0)
				{
					maskWidth = 1;
				}
				if(maskHeight < 0)
				{
					maskHeight = 1;
				}
				var mask:Quad = new Quad(maskWidth, maskHeight, 0xff00ff);
				mask.width = 0;
				target.mask = mask;
				var tween:Tween = new Tween(mask, duration, ease);
				tween.animate("width", maskWidth);
				tween.onComplete = function():void
				{
					target.mask = oldMask;
					mask.dispose();
				};
				return new TweenEffectContext(target, tween);
			};
		}

		/**
		 * Creates an effect function for the target component that wipes the
		 * target component into view from bottom to top, animating the
		 * <code>height</code> and <code>y</code> properties of a temporary mask.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 */
		public static function createWipeInUpEffect(duration:Number = 0.25, ease:Object = Transitions.EASE_OUT):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var oldMask:DisplayObject = target.mask;
				var maskWidth:Number = target.width;
				var maskHeight:Number = target.height;
				if(maskWidth < 0)
				{
					maskWidth = 1;
				}
				if(maskHeight < 0)
				{
					maskHeight = 1;
				}
				var mask:Quad = new Quad(maskWidth, maskHeight, 0xff00ff);
				mask.height = 0;
				mask.y = maskHeight;
				target.mask = mask;
				var tween:Tween = new Tween(mask, duration, ease);
				tween.animate("height", maskHeight);
				tween.animate("y", 0);
				tween.onComplete = function():void
				{
					target.mask = oldMask;
					mask.dispose();
				};
				return new TweenEffectContext(target, tween);
			};
		}

		/**
		 * Creates an effect function for the target component that wipes the
		 * target component into view from top to bottom, animating the
		 * <code>height</code> property of a temporary mask.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 */
		public static function createWipeInDownEffect(duration:Number = 0.25, ease:Object = Transitions.EASE_OUT):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var oldMask:DisplayObject = target.mask;
				var maskWidth:Number = target.width;
				var maskHeight:Number = target.height;
				if(maskWidth < 0)
				{
					maskWidth = 1;
				}
				if(maskHeight < 0)
				{
					maskHeight = 1;
				}
				var mask:Quad = new Quad(maskWidth, maskHeight, 0xff00ff);
				mask.height = 0;
				target.mask = mask;
				var tween:Tween = new Tween(mask, duration, ease);
				tween.animate("height", maskHeight);
				tween.onComplete = function():void
				{
					target.mask = oldMask;
					mask.removeFromParent(true);
				};
				return new TweenEffectContext(target, tween);
			};
		}

		/**
		 * Creates an effect function for the target component that wipes the
		 * target component out of view from right to left, animating the
		 * <code>width</code> property of a temporary mask.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 */
		public static function createWipeOutLeftEffect(duration:Number = 0.25, ease:Object = Transitions.EASE_OUT):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var oldMask:DisplayObject = target.mask;
				var maskWidth:Number = target.width;
				var maskHeight:Number = target.height;
				if(maskWidth < 0)
				{
					maskWidth = 1;
				}
				if(maskHeight < 0)
				{
					maskHeight = 1;
				}
				var mask:Quad = new Quad(maskWidth, maskHeight, 0xff00ff);
				target.mask = mask;
				var tween:Tween = new Tween(mask, duration, ease);
				tween.animate("width", 0);
				tween.onComplete = function():void
				{
					target.mask = oldMask;
					mask.dispose();
				};
				return new TweenEffectContext(target, tween);
			};
		}

		/**
		 * Creates an effect function for the target component that wipes the
		 * target component out of view from left to right, animating the
		 * <code>width</code> and <code>x</code> properties of a temporary mask.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 */
		public static function createWipeOutRightEffect(duration:Number = 0.25, ease:Object = Transitions.EASE_OUT):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var oldMask:DisplayObject = target.mask;
				var maskWidth:Number = target.width;
				var maskHeight:Number = target.height;
				if(maskWidth < 0)
				{
					maskWidth = 1;
				}
				if(maskHeight < 0)
				{
					maskHeight = 1;
				}
				var mask:Quad = new Quad(maskWidth, maskHeight, 0xff00ff);
				target.mask = mask;
				var tween:Tween = new Tween(mask, duration, ease);
				tween.animate("width", 0);
				tween.animate("x", maskWidth);
				tween.onComplete = function():void
				{
					target.mask = oldMask;
					mask.removeFromParent(true);
				};
				return new TweenEffectContext(target, tween);
			};
		}

		/**
		 * Creates an effect function for the target component that wipes the
		 * target component out of view from bottom to top, animating the
		 * <code>height</code> property of a temporary mask.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 */
		public static function createWipeOutUpEffect(duration:Number = 0.25, ease:Object = Transitions.EASE_OUT):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var oldMask:DisplayObject = target.mask;
				var maskWidth:Number = target.width;
				var maskHeight:Number = target.height;
				if(maskWidth < 0)
				{
					maskWidth = 1;
				}
				if(maskHeight < 0)
				{
					maskHeight = 1;
				}
				var mask:Quad = new Quad(maskWidth, maskHeight, 0xff00ff);
				target.mask = mask;
				var tween:Tween = new Tween(mask, duration, ease);
				tween.animate("height", 0);
				tween.onComplete = function():void
				{
					target.mask = oldMask;
					mask.dispose();
				};
				return new TweenEffectContext(target, tween);
			};
		}

		/**
		 * Creates an effect function for the target component that wipes the
		 * target component out of view from top to bottom, animating the
		 * <code>height</code> and <code>y</code> properties of a temporary mask.
		 *
		 * @see ../../../help/effects.html Effects and animation for Feathers components
		 */
		public static function createWipeOutDownEffect(duration:Number = 0.25, ease:Object = Transitions.EASE_OUT):Function
		{
			return function(target:DisplayObject):IEffectContext
			{
				var oldMask:DisplayObject = target.mask;
				var maskWidth:Number = target.width;
				var maskHeight:Number = target.height;
				if(maskWidth < 0)
				{
					maskWidth = 1;
				}
				if(maskHeight < 0)
				{
					maskHeight = 1;
				}
				var mask:Quad = new Quad(maskWidth, maskHeight, 0xff00ff);
				target.mask = mask;
				var tween:Tween = new Tween(mask, duration, ease);
				tween.animate("height", 0);
				tween.animate("y", maskHeight);
				tween.onComplete = function():void
				{
					target.mask = oldMask;
					mask.removeFromParent(true);
				};
				return new TweenEffectContext(target, tween);
			};
		}

		/**
		 * Creates a transition function for a screen navigator that wipes the
		 * old screen out of view to the left, animating the <code>width</code>
		 * property of a <code>clipRect</code>, to reveal the new screen under
		 * it. The new screen remains stationary.
		 *
		 * @see ../../../help/transitions.html#wipe Transitions for Feathers screen navigators: Wipe
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createWipeLeftTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				var xOffset:Number = oldScreen ? -oldScreen.width : -newScreen.width;
				var tween:WipeTween = new WipeTween(newScreen, oldScreen, xOffset, 0, duration, ease, onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that wipes the
		 * old screen out of view to the right, animating the <code>x</code>
		 * and <code>width</code> properties of a <code>clipRect</code>, to
		 * reveal the new screen under it. The new screen remains stationary.
		 *
		 * @see ../../../help/transitions.html#wipe Transitions for Feathers screen navigators: Wipe
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createWipeRightTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				var xOffset:Number = oldScreen ? oldScreen.width : newScreen.width;
				var tween:WipeTween = new WipeTween(newScreen, oldScreen, xOffset, 0, duration, ease, onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that wipes the
		 * old screen up, animating the <code>height</code> property of a
		 * <code>clipRect</code>, to reveal the new screen under it. The new
		 * screen remains stationary.
		 *
		 * @see ../../../help/transitions.html#wipe Transitions for Feathers screen navigators: Wipe
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createWipeUpTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				var yOffset:Number = oldScreen ? -oldScreen.height : -newScreen.height;
				var tween:WipeTween = new WipeTween(newScreen, oldScreen, 0, yOffset, duration, ease, onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}

		/**
		 * Creates a transition function for a screen navigator that wipes the
		 * old screen down, animating the <code>y</code> and <code>height</code>
		 * properties of a <code>clipRect</code>, to reveal the new screen under
		 * it. The new screen remains stationary.
		 *
		 * @see ../../../help/transitions.html#wipe Transitions for Feathers screen navigators: Wipe
		 * @see feathers.controls.StackScreenNavigator#pushTransition
		 * @see feathers.controls.StackScreenNavigator#popTransition
		 * @see feathers.controls.ScreenNavigator#transition
		 */
		public static function createWipeDownTransition(duration:Number = 0.5, ease:Object = Transitions.EASE_OUT, tweenProperties:Object = null):Function
		{
			return function(oldScreen:DisplayObject, newScreen:DisplayObject, onComplete:Function, managed:Boolean = false):IEffectContext
			{
				if(!oldScreen && !newScreen)
				{
					throw new ArgumentError(SCREEN_REQUIRED_ERROR);
				}
				var yOffset:Number = oldScreen ? oldScreen.height : newScreen.height;
				var tween:WipeTween = new WipeTween(newScreen, oldScreen, 0, yOffset, duration, ease, onComplete, tweenProperties);
				if(managed)
				{
					return new TweenEffectContext(null, tween);
				}
				Starling.juggler.add(tween);
				return null;
			};
		}
	}
}

import feathers.display.RenderDelegate;

import starling.animation.Tween;
import starling.core.Starling;
import starling.display.DisplayObject;
import starling.display.Quad;

class WipeTween extends Tween
{
	public function WipeTween(newScreen:DisplayObject, oldScreen:DisplayObject,
		xOffset:Number, yOffset:Number, duration:Number, ease:Object, onCompleteCallback:Function,
		tweenProperties:Object)
	{
		var mask:Quad;
		if(newScreen)
		{
			mask = new Quad(1, 1, 0xff00ff);
			//the initial dimensions cannot be 0 or there's a runtime error,
			mask.width = 0;
			mask.height = 0;
			if(xOffset != 0)
			{
				if(xOffset < 0)
				{
					mask.x = newScreen.width;
				}
				mask.height = newScreen.height;
			}
			if(yOffset != 0)
			{
				if(yOffset < 0)
				{
					mask.y = newScreen.height;
				}
				mask.width = newScreen.width;
			}
			this._newScreenDelegate = new RenderDelegate(newScreen);
			this._newScreenDelegate.alpha = newScreen.alpha;
			this._newScreenDelegate.blendMode = newScreen.blendMode;
			this._newScreenDelegate.rotation = newScreen.rotation;
			this._newScreenDelegate.scaleX = newScreen.scaleX;
			this._newScreenDelegate.scaleY = newScreen.scaleY;
			this._newScreenDelegate.mask = mask;
			this._newScreenClipRect = mask;
			newScreen.parent.addChild(this._newScreenDelegate);
			newScreen.parent.addChild(mask);
			newScreen.visible = false;
			this._savedNewScreen = newScreen;
		}
		if(oldScreen)
		{
			mask = new Quad(1, 1, 0xff00ff);
			//the initial dimensions cannot be 0 or there's a runtime error,
			//and these values might be 0
			mask.width = oldScreen.width;
			mask.height = oldScreen.height;
			this._oldScreenDelegate = new RenderDelegate(oldScreen);
			this._oldScreenDelegate.alpha = oldScreen.alpha;
			this._oldScreenDelegate.blendMode = oldScreen.blendMode;
			this._oldScreenDelegate.rotation = oldScreen.rotation;
			this._oldScreenDelegate.scaleX = oldScreen.scaleX;
			this._oldScreenDelegate.scaleY = oldScreen.scaleY;
			this._oldScreenDelegate.mask = mask;
			oldScreen.parent.addChild(this._oldScreenDelegate);
			oldScreen.parent.addChild(mask);
			oldScreen.visible = false;
			this._savedOldScreen = oldScreen;
		}

		super(mask, duration, ease);

		if(oldScreen)
		{
			if(xOffset < 0)
			{
				this.animate("width", oldScreen.width + xOffset);
			}
			else if(xOffset > 0)
			{
				this.animate("x", xOffset);
				this.animate("width", oldScreen.width - xOffset);
			}
			if(yOffset < 0)
			{
				this.animate("height", oldScreen.height + yOffset);
			}
			else if(yOffset > 0)
			{
				this.animate("y", yOffset);
				this.animate("height", oldScreen.height - yOffset);
			}
			if(this._newScreenDelegate)
			{
				this.onUpdate = this.updateNewScreen;
			}
		}
		else //new screen only
		{
			if(xOffset < 0)
			{
				this.animate("x", newScreen.width + xOffset);
				this.animate("width", -xOffset);
			}
			else if(xOffset > 0)
			{
				this.animate("width", xOffset);
			}
			if(yOffset < 0)
			{
				this.animate("y", newScreen.height + yOffset);
				this.animate("height", -yOffset);
			}
			else if(yOffset > 0)
			{
				this.animate("height", yOffset);
			}
		}
		if(tweenProperties)
		{
			for(var propertyName:String in tweenProperties)
			{
				this[propertyName] = tweenProperties[propertyName];
			}
		}
		this._savedXOffset = xOffset;
		this._savedYOffset = yOffset;
		this._onCompleteCallback = onCompleteCallback;
		this.onComplete = this.cleanupTween;
	}

	private var _oldScreenDelegate:RenderDelegate;
	private var _newScreenDelegate:RenderDelegate;
	private var _newScreenClipRect:Quad;
	private var _savedOldScreen:DisplayObject;
	private var _savedNewScreen:DisplayObject;
	private var _savedXOffset:Number;
	private var _savedYOffset:Number;
	private var _onCompleteCallback:Function;

	private function updateNewScreen():void
	{
		var oldScreenClipRect:Quad = Quad(this.target);
		if(this._savedXOffset < 0)
		{
			this._newScreenClipRect.x = oldScreenClipRect.width;
			this._newScreenClipRect.width = this._savedNewScreen.width - this._newScreenClipRect.x;
		}
		else if(this._savedXOffset > 0)
		{
			this._newScreenClipRect.width = oldScreenClipRect.x;
		}
		if(this._savedYOffset < 0)
		{
			this._newScreenClipRect.y = oldScreenClipRect.height;
			this._newScreenClipRect.height = this._savedNewScreen.height - this._newScreenClipRect.y;
		}
		else if(this._savedYOffset > 0)
		{
			this._newScreenClipRect.height = oldScreenClipRect.y;
		}
	}

	private function cleanupTween():void
	{
		if(this._oldScreenDelegate)
		{
			Quad(this.target).removeFromParent(true);
			this._oldScreenDelegate.removeFromParent(true);
			this._oldScreenDelegate = null;
		}
		if(this._newScreenDelegate)
		{
			this._newScreenClipRect.removeFromParent(true);
			this._newScreenClipRect = null;
			this._newScreenDelegate.removeFromParent(true);
			this._newScreenDelegate = null;
		}
		if(this._savedOldScreen)
		{
			this._savedOldScreen.visible = true;
			this._savedOldScreen = null;
		}
		if(this._savedNewScreen)
		{
			this._savedNewScreen.visible = true;
			this._savedNewScreen = null;
		}
		if(this._onCompleteCallback !== null)
		{
			this._onCompleteCallback();
		}
	}

}



================================================
FILE: source/feathers/motion/effectClasses/BaseEffectContext.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion.effectClasses
{
	import starling.animation.Juggler;
	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.errors.AbstractClassError;
	import starling.events.Event;
	import starling.events.EventDispatcher;

	/**
	 * Dispatched when the effect completes or is interrupted. If the effect was
	 * stopped instead of advancing to the end, the value of the event's
	 * <code>data</code> property will be <code>true</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>If the effect was stopped without
	 *   reaching the end, this value will be <code>true</code>. Otherwise,
	 *   <code>false</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.COMPLETE
	 *
	 * @see #toEnd()
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * An abstract base class for <code>IEffectContext</code> implementations.
	 *
	 * @see ../../../help/effects.html Effects and animation for Feathers components
	 */
	public class BaseEffectContext extends EventDispatcher implements IEffectContext
	{
		/**
		 * @private
		 */
		private static const MAX_POSITION:Number = 0.99999;

		/**
		 * Constructor.
		 */
		public function BaseEffectContext(target:DisplayObject, duration:Number, transition:Object = null)
		{
			super();
			if(Object(this).constructor === BaseEffectContext)
			{
				throw new AbstractClassError();
			}
			this._target = target;
			this._duration = duration;
			if(transition === null)
			{
				transition = Transitions.LINEAR;
			}
			this._transition = transition;
			this.prepareEffect();
		}

		/**
		 * @private
		 */
		protected var _target:DisplayObject;

		/**
		 * The target of the effect.
		 */
		public function get target():DisplayObject
		{
			return this._target;
		}

		/**
		 * @private
		 */
		protected var _playTween:Tween = null;

		/**
		 * @private
		 */
		protected var _duration:Number;

		/**
		 * The duration of the effect, in seconds.
		 */
		public function get duration():Number
		{
			return this._duration;
		}

		/**
		 * @private
		 */
		protected var _transition:Object = null;

		/**
		 * The transition, or easing function, used for the effect.
		 *
		 * @see http://doc.starling-framework.org/core/starling/animation/Transitions.html starling.animation.Transitions
		 */
		public function get transition():Object
		{
			return this._transition;
		}

		/**
		 * @private
		 */
		protected var _position:Number = 0;

		/**
		 * @private
		 */
		protected var _playing:Boolean = false;

		/**
		 * @private
		 */
		protected var _reversed:Boolean = false;

		/**
		 * @private
		 */
		protected var _juggler:Juggler = null;

		/**
		 * The <code>Juggler</code> used to update the effect when it is
		 * playing. If <code>null</code>, uses <code>Starling.juggler</code>.
		 *
		 * @see http://doc.starling-framework.org/core/starling/animation/Juggler.html starling.animation.Juggler
		 */
		public function get juggler():Juggler
		{
			return this._juggler;
		}

		/**
		 * @private
		 */
		public function set juggler(value:Juggler):void
		{
			if(this._juggler === value)
			{
				return;
			}
			var oldJuggler:Juggler = this._juggler;
			if(oldJuggler === null)
			{
				oldJuggler = Starling.juggler;
			}
			this._juggler = value;
			if(this._playing && this._juggler !== oldJuggler)
			{
				oldJuggler.remove(this._playTween);
				if(this._juggler !== null)
				{
					this._juggler.add(this._playTween);
				}
				else
				{
					this._playing = false;
				}
			}
		}

		/**
		 * Sets the position of the effect using a value between <code>0</code>
		 * and <code>1</code>.
		 *
		 * @see #duration
		 */
		public function get position():Number
		{
			return this._position;
		}

		/**
		 * @private
		 */
		public function set position(value:Number):void
		{
			// there are some quirks with Starling tweens where we want to avoid
			// going all of the way to the end, unless the tween is currently
			// playing
			if(!this._playing && value > MAX_POSITION)
			{
				value = MAX_POSITION;
			}
			this._position = value;
			this.updateEffect();
		}

		/**
		 * @inheritDoc
		 */
		public function play():void
		{
			if(this._playing && !this._reversed)
			{
				//already playing in the correct direction
				return;
			}
			if(this._playTween !== null)
			{
				this._playTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
				this._playTween = null;
			}
			this._playing = true;
			this._reversed = false;

			var duration:Number = this._duration * (1 - this._position);
			this._playTween = new Tween(this, duration, this._transition);
			this._playTween.animate("position", 1);
			this._playTween.onComplete = this.playTween_onComplete;

			var juggler:Juggler = this._juggler;
			if(juggler === null)
			{
				juggler = Starling.juggler;
			}
			juggler.add(this._playTween);
		}

		/**
		 * @inheritDoc
		 */
		public function playReverse():void
		{
			if(this._playing && this._reversed)
			{
				//already playing in the correct direction
				return;
			}
			if(this._playTween !== null)
			{
				this._playTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
				this._playTween = null;
			}
			this._playing = true;
			this._reversed = true;

			var duration:Number = this._duration * this._position;
			this._playTween = new Tween(this, duration, this._transition);
			this._playTween.animate("position", 0);
			this._playTween.onComplete = this.playTween_onComplete;

			var juggler:Juggler = this._juggler;
			if(juggler === null)
			{
				juggler = Starling.juggler;
			}
			juggler.add(this._playTween);
		}

		/**
		 * @inheritDoc
		 */
		public function pause():void
		{
			if(!this._playing)
			{
				return;
			}
			if(this._playTween !== null)
			{
				this._playTween.dispatchEventWith(Event.REMOVE_FROM_JUGGLER);
				this._playTween = null;
			}
			this._playing = false;
		}

		/**
		 * @inheritDoc
		 */
		public function stop():void
		{
			this.pause();
			this.cleanupEffect();
			this.dispatchEventWith(Event.COMPLETE, false, true);
		}

		/**
		 * @inheritDoc
		 */
		public function toEnd():void
		{
			if(this._playing)
			{
				this._position = 1;
				this._playTween.advanceTime(this._playTween.totalTime);
				return;
			}
			this.position = 1;
			this.cleanupEffect();
			this.dispatchEventWith(Event.COMPLETE, false, false);
		}

		/**
		 * @inheritDoc
		 */
		public function interrupt():void
		{
			//by default, go to the end. subclasses may override this method
			//to customize the behavior, if needed.
			this.toEnd();
		}

		/**
		 * Called when the effect is initialized. Subclasses may
		 * override this method to customize the effect's behavior.
		 */
		protected function prepareEffect():void
		{

		}

		/**
		 * Called when the effect's position is updated. Subclasses may
		 * override this method to customize the effect's behavior.
		 */
		protected function updateEffect():void
		{

		}

		/**
		 * Called when the effect completes or is interrupted. Subclasses may
		 * override this method to customize the effect's behavior.
		 */
		protected function cleanupEffect():void
		{

		}

		/**
		 * @private
		 */
		protected function playTween_onComplete():void
		{
			this._playTween = null;
			this._playing = false;
			this.cleanupEffect();
			this.dispatchEventWith(Event.COMPLETE, false, false);
		}

	}
}

================================================
FILE: source/feathers/motion/effectClasses/IEffectContext.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion.effectClasses
{
	import feathers.core.IFeathersEventDispatcher;

	import starling.display.DisplayObject;

	/**
	 * Dispatched when the effect completes or is interrupted. If the effect was
	 * stopped instead of advancing to the end, the value of the event's
	 * <code>data</code> property will be <code>true</code>.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>If the effect was stopped without
	 *   reaching the end, this value will be <code>true</code>. Otherwise,
	 *   <code>false</code>.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.COMPLETE
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * Gives a component the ability to control an effect.
	 *
	 * @see ../../../help/effects.html Effects and animation for Feathers components
	 *
	 * @productversion Feathers 3.5.0
	 */
	public interface IEffectContext extends IFeathersEventDispatcher
	{
		/**
		 * The target of the effect.
		 */
		function get target():DisplayObject;

		/**
		 * The duration of the effect, in seconds.
		 */
		function get duration():Number;

		/**
		 * The position of the effect, from <code>0</code> to <code>1</code>.
		 *
		 * @see #duration
		 */
		function get position():Number;

		/**
		 * @private
		 */
		function set position(value:Number):void;

		/**
		 * Starts playing the effect from its current position to the end.
		 *
		 * @see #pause()
		 */
		function play():void;

		/**
		 * Starts playing the effect from its current position back to the
		 * beginning (completing at a position of <code>0</code>).
		 */
		function playReverse():void;

		/**
		 * Pauses an effect that is currently playing.
		 */
		function pause():void;

		/**
		 * Stops the effect at its current position and forces
		 * <code>Event.COMPLETE</code> to dispatch. The <code>data</code>
		 * property of the event will be <code>true</code>.
		 *
		 * @see #toEnd()
		 * @see #event:complete starling.events.Event.COMPLETE
		 */
		function stop():void;

		/**
		 * Advances the effect to the end and forces
		 * <code>Event.COMPLETE</code> to dispatch. The <code>data</code>
		 * property of the event will be <code>false</code>.
		 *
		 * @see #stop()
		 * @see #event:complete starling.events.Event.COMPLETE
		 */
		function toEnd():void;

		/**
		 * Interrupts the playing effect, but the effect context will be allowed
		 * to determine on its own if it should call <code>stop()</code> or
		 * <code>toEnd()</code>.
		 *
		 * @see #toEnd()
		 * @see #stop()
		 */
		function interrupt():void;
	}
}

================================================
FILE: source/feathers/motion/effectClasses/IMoveEffectContext.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion.effectClasses
{
	/**
	 * Gives a component the ability to control a move effect.
	 *
	 * @see ../../../help/effects.html Effects and animation for Feathers components
	 */
	public interface IMoveEffectContext extends IEffectContext
	{
		/**
		 * The old x position of the target.
		 */
		function get oldX():Number;

		/**
		 * @private
		 */
		function set oldX(value:Number):void;

		/**
		 * The old y position of the target.
		 */
		function get oldY():Number;

		/**
		 * @private
		 */
		function set oldY(value:Number):void;

		/**
		 * The new x position of the target.
		 */
		function get newX():Number;

		/**
		 * @private
		 */
		function set newX(value:Number):void;

		/**
		 * The new y position of the target.
		 */
		function get newY():Number;

		/**
		 * @private
		 */
		function set newY(value:Number):void;
	}
}

================================================
FILE: source/feathers/motion/effectClasses/IResizeEffectContext.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion.effectClasses
{
	/**
	 * Gives a component the ability to control a resize effect.
	 *
	 * @see ../../../help/effects.html Effects and animation for Feathers components
	 */
	public interface IResizeEffectContext extends IEffectContext
	{
		/**
		 * The old width of the target.
		 */
		function get oldWidth():Number;

		/**
		 * @private
		 */
		function set oldWidth(value:Number):void;

		/**
		 * The old height of the target.
		 */
		function get oldHeight():Number;

		/**
		 * @private
		 */
		function set oldHeight(value:Number):void;

		/**
		 * The new width of the target.
		 */
		function get newWidth():Number;

		/**
		 * @private
		 */
		function set newWidth(value:Number):void;

		/**
		 * The new height of the target.
		 */
		function get newHeight():Number;

		/**
		 * @private
		 */
		function set newHeight(value:Number):void;
	}
}

================================================
FILE: source/feathers/motion/effectClasses/ParallelEffectContext.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion.effectClasses
{
	import starling.display.DisplayObject;

	/**
	 * An effect context for running multiple effects in parallel.
	 *
	 * @productversion Feathers 3.5.0
	 *
	 * @see feathers.motion.Parallel
	 */
	public class ParallelEffectContext extends BaseEffectContext implements IEffectContext
	{
		/**
		 * Constructor.
		 */
		public function ParallelEffectContext(target:DisplayObject, functions:Array)
		{
			var duration:Number = 0;
			var count:int = functions.length;
			for(var i:int = 0; i < count; i++)
			{
				var func:Function = functions[i] as Function;
				var context:IEffectContext = IEffectContext(func(target));
				this._contexts[i] = context;
				var contextDuration:Number = context.duration;
				if(contextDuration > duration)
				{
					duration = contextDuration;
				}
			}
			super(target, duration);
		}

		/**
		 * @private
		 */
		protected var _contexts:Vector.<IEffectContext> = new <IEffectContext>[];

		/**
		 * @private
		 */
		override protected function updateEffect():void
		{
			var ratio:Number = this._position * this._duration;
			var contextCount:int = this._contexts.length;
			for(var i:int = 0; i < contextCount; i++)
			{
				var context:IEffectContext = this._contexts[i] as IEffectContext;
				context.position = ratio / context.duration;
			}
		}
	}
}

================================================
FILE: source/feathers/motion/effectClasses/SequenceEffectContext.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion.effectClasses
{
	import starling.display.DisplayObject;

	/**
	 * An effect context for running multiple effects one after another, in
	 * sequence.
	 *
	 * @productversion Feathers 3.5.0
	 *
	 * @see feathers.motion.Sequence
	 */
	public class SequenceEffectContext extends BaseEffectContext implements IEffectContext
	{
		/**
		 * Constructor.
		 */
		public function SequenceEffectContext(target:DisplayObject, functions:Array)
		{
			var duration:Number = 0;
			var count:int = functions.length;
			for(var i:int = 0; i < count; i++)
			{
				var func:Function = functions[i] as Function;
				var context:IEffectContext = IEffectContext(func(target));
				this._contexts[i] = context;
				duration += context.duration;
			}
			super(target, duration);
		}

		/**
		 * @private
		 */
		protected var _contexts:Vector.<IEffectContext> = new <IEffectContext>[];

		/**
		 * @private
		 */
		override protected function updateEffect():void
		{
			var totalTime:Number = 0;
			var currentTime:Number = this._position * this._duration;
			var contextCount:int = this._contexts.length;
			for(var i:int = 0; i < contextCount; i++)
			{
				var context:IEffectContext = this._contexts[i] as IEffectContext;
				var contextDuration:Number = context.duration;
				if(totalTime > currentTime)
				{
					context.position = 0;
				}
				else
				{
					context.position = (currentTime - totalTime) / contextDuration;
				}
				totalTime += contextDuration;
			}
		}
	}
}

================================================
FILE: source/feathers/motion/effectClasses/TweenEffectContext.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion.effectClasses
{
	import feathers.core.IFeathersControl;
	import feathers.motion.EffectInterruptBehavior;

	import starling.animation.Transitions;
	import starling.animation.Tween;
	import starling.display.DisplayObject;

	/**
	 * An effect context for a <code>starling.animation.Tween</code>.
	 *
	 * @see ../../../help/effects.html Effects and animation for Feathers components
	 * @see http://doc.starling-framework.org/core/starling/animation/Tween.html starling.animation.Tween
	 *
	 * @productversion Feathers 3.5.0
	 */
	public class TweenEffectContext extends BaseEffectContext implements IEffectContext
	{
		/**
		 * Constructor.
		 */
		public function TweenEffectContext(target:DisplayObject, tween:Tween, interruptBehavior:String = EffectInterruptBehavior.END)
		{
			this._tween = tween;
			this._interruptBehavior = interruptBehavior;
			var linearTransitionFunc:Function = Transitions.getTransition(Transitions.LINEAR);
			var transitionFunc:Function = this._tween.transitionFunc;
			//we want setting the position property to be linear, but when
			//play() or playReverse() is called, we'll use the saved transition
			this._tween.transitionFunc = linearTransitionFunc;

			//we'll take over for onStart and onComplete because we don't them
			//being called by the Tween, since we're taking over control
			this._onStart = this._tween.onStart;
			this._onComplete = this._tween.onComplete;
			this._tween.onStart = null;
			this._tween.onComplete = null;

			if(target === null)
			{
				target = tween.target as DisplayObject;
			}

			//the delay does not affect the totalTime, so we need to add them
			//to calculate the full duration of the effect
			super(target, this._tween.totalTime + this._tween.delay, transitionFunc);
		}

		/**
		 * @private
		 */
		protected var _tween:Tween = null;

		/**
		 * The tween that is controlled by the effect.
		 */
		public function get tween():Tween
		{
			return this._tween;
		}

		/**
		 * @private
		 */
		protected var _interruptBehavior:String = null;

		[Inspectable(type="String",enumeration="end,stop")]
		/**
		 * Indicates how the effect behaves when it is interrupted. Interrupted
		 * effects can either advance directly to the end or stop at the current
		 * position.
		 *
		 * @default feathers.motion.EffectInterruptBehavior.END
		 *
		 * @see feathers.motion.EffectInterruptBehavior#END
		 * @see feathers.motion.EffectInterruptBehavior#STOP
		 * @see #interrupt()
		 */
		public function get interruptBehavior():String
		{
			return this._interruptBehavior;
		}

		/**
		 * @private
		 */
		public function set interruptBehavior(value:String):void
		{
			this._interruptBehavior = value;
		}

		/**
		 * @private
		 */
		protected var _onStart:Function = null;

		/**
		 * @private
		 */
		protected var _onComplete:Function = null;

		/**
		 * @private
		 *
		 * @see #interruptBehavior
		 */
		override public function interrupt():void
		{
			if(this._interruptBehavior === EffectInterruptBehavior.STOP)
			{
				this.stop();
				return;
			}
			this.toEnd();
		}

		/**
		 * @private
		 */
		override protected function prepareEffect():void
		{
			if(this._onStart !== null)
			{
				this._onStart.apply(null, this._tween.onStartArgs);
			}
		}

		/**
		 * @private
		 */
		override protected function updateEffect():void
		{
			if(this._target is IFeathersControl)
			{
				IFeathersControl(this._target).suspendEffects();
			}
			var duration:Number = this._tween.totalTime + this._tween.delay;
			var newCurrentTime:Number = (this._position * duration) - this._tween.delay;
			this._tween.advanceTime(newCurrentTime - this._tween.currentTime);
			if(this._target is IFeathersControl)
			{
				IFeathersControl(this._target).resumeEffects();
			}
		}

		/**
		 * @private
		 */
		override protected function cleanupEffect():void
		{
			if(this._onComplete !== null)
			{
				this._onComplete.apply(null, this._tween.onCompleteArgs);
			}
		}
	}
}

================================================
FILE: source/feathers/motion/effectClasses/TweenMoveEffectContext.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion.effectClasses
{
	import feathers.core.IFeathersControl;

	import starling.animation.Tween;
	import starling.display.DisplayObject;

	/**
	 * A move effect context for a <code>starling.animation.Tween</code>.
	 *
	 * @see ../../../help/effects.html Effects and animation for Feathers components
	 * @see http://doc.starling-framework.org/core/starling/animation/Tween.html starling.animation.Tween
	 * @see feathers.core.FeathersControl#moveEffect
	 *
	 * @productversion Feathers 3.5.0
	 */
	public class TweenMoveEffectContext extends TweenEffectContext implements IMoveEffectContext
	{
		/**
		 * Constructor.
		 */
		public function TweenMoveEffectContext(target:DisplayObject, tween:Tween)
		{
			super(target, tween);
			this._oldX = this._target.x;
			this._oldY = this._target.y;
			this._newX = this._target.x;
			this._tween.animate("x", this._newX);
			this._newY = this._target.y;
			this._tween.animate("y", this._newY);
		}

		/**
		 * @private
		 */
		protected var _oldX:Number;

		/**
		 * @inheritDoc
		 */
		public function get oldX():Number
		{
			return this._oldX;
		}

		/**
		 * @private
		 */
		public function set oldX(value:Number):void
		{
			this._oldX = value;
		}

		/**
		 * @private
		 */
		protected var _oldY:Number;

		/**
		 * @inheritDoc
		 */
		public function get oldY():Number
		{
			return this._oldY;
		}

		/**
		 * @private
		 */
		public function set oldY(value:Number):void
		{
			this._oldY = value;
		}

		/**
		 * @private
		 */
		protected var _newX:Number;

		/**
		 * @inheritDoc
		 */
		public function get newX():Number
		{
			return this._newX;
		}

		/**
		 * @private
		 */
		public function set newX(value:Number):void
		{
			if(this._newX == value)
			{
				return;
			}
			this._newX = value;
			this._tween.animate("x", value);
		}

		/**
		 * @private
		 */
		protected var _newY:Number;

		/**
		 * @inheritDoc
		 */
		public function get newY():Number
		{
			return this._newY;
		}

		/**
		 * @private
		 */
		public function set newY(value:Number):void
		{
			if(this._newY == value)
			{
				return;
			}
			this._newY = value;
			this._tween.animate("y", value);
		}

		/**
		 * @private
		 */
		override public function play():void
		{
			if(this._target is IFeathersControl)
			{
				IFeathersControl(this._target).suspendEffects();
			}
			this._target.x = this._oldX;
			this._target.y = this._oldY;
			if(this._target is IFeathersControl)
			{
				IFeathersControl(this._target).resumeEffects();
			}
			super.play();
		}
	}
}

================================================
FILE: source/feathers/motion/effectClasses/TweenResizeEffectContext.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.motion.effectClasses
{
	import feathers.core.IFeathersControl;

	import starling.animation.Tween;
	import starling.display.DisplayObject;

	/**
	 * A resize effect context for a <code>starling.animation.Tween</code>.
	 *
	 * @see ../../../help/effects.html Effects and animation for Feathers components
	 * @see http://doc.starling-framework.org/core/starling/animation/Tween.html starling.animation.Tween
	 * @see feathers.core.FeathersControl#resizeEffect
	 *
	 * @productversion Feathers 3.5.0
	 */
	public class TweenResizeEffectContext extends TweenEffectContext implements IResizeEffectContext
	{
		/**
		 * Constructor.
		 */
		public function TweenResizeEffectContext(target:DisplayObject, tween:Tween)
		{
			super(target, tween);
			this._oldWidth = this._target.width;
			this._oldHeight = this._target.height;
			this._newWidth = this._target.width;
			this._newHeight = this._target.height;
		}

		/**
		 * @private
		 */
		protected var _oldWidth:Number;

		/**
		 * @inheritDoc
		 */
		public function get oldWidth():Number
		{
			return this._oldWidth;
		}

		/**
		 * @private
		 */
		public function set oldWidth(value:Number):void
		{
			this._oldWidth = value;
		}

		/**
		 * @private
		 */
		protected var _oldHeight:Number;

		/**
		 * @inheritDoc
		 */
		public function get oldHeight():Number
		{
			return this._oldHeight;
		}

		/**
		 * @private
		 */
		public function set oldHeight(value:Number):void
		{
			this._oldHeight = value;
		}

		/**
		 * @private
		 */
		protected var _newWidth:Number;

		/**
		 * @inheritDoc
		 */
		public function get newWidth():Number
		{
			return this._newWidth;
		}

		/**
		 * @private
		 */
		public function set newWidth(value:Number):void
		{
			if(this._newWidth == value)
			{
				return;
			}
			this._newWidth = value;
			this._tween.animate("width", value);
		}

		/**
		 * @private
		 */
		protected var _newHeight:Number;

		/**
		 * @inheritDoc
		 */
		public function get newHeight():Number
		{
			return this._newHeight;
		}

		/**
		 * @private
		 */
		public function set newHeight(value:Number):void
		{
			if(this._newHeight == value)
			{
				return;
			}
			this._newHeight = value;
			this._tween.animate("height", value);
		}

		/**
		 * @private
		 */
		override public function play():void
		{
			if(this._target is IFeathersControl)
			{
				IFeathersControl(this._target).suspendEffects();
			}
			this._target.width = this._oldWidth;
			this._target.height = this._oldHeight;
			if(this._target is IFeathersControl)
			{
				IFeathersControl(this._target).resumeEffects();
			}
			super.play();
		}
	}
}

================================================
FILE: source/feathers/skins/AddOnFunctionStyleProvider.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.skins
{
	import feathers.core.IFeathersControl;

	/**
	 * Wraps an existing style provider to call an additional function before or
	 * after the existing style provider applies its styles.
	 *
	 * <p>Starting with Feathers 3.1, "style" properties that are set outside a
	 * style provider won't be replaced by the style provider, so
	 * <code>AddOnFunctionStyleProvider</code> may only be useful in rare
	 * cases.</p>
	 *
	 * <p>Expected usage is to replace a component's existing style provider:</p>
	 * <listing version="3.0">
	 * var button:Button = new Button();
	 * button.label = "Click Me";
	 * function setExtraStyles( target:Button ):void
	 * {
	 *     target.defaultIcon = new Image( texture );
	 *     // set other styles, if desired...
	 * }
	 * button.styleProvider = new AddOnFunctionStyleProvider( button.styleProvider, setExtraStyles );
	 * this.addChild( button );</listing>
	 *
	 * @productversion Feathers 2.0.0
	 */
	public class AddOnFunctionStyleProvider implements IStyleProvider
	{
		/**
		 * Constructor.
		 */
		public function AddOnFunctionStyleProvider(originalStyleProvider:IStyleProvider = null, addOnFunction:Function = null)
		{
			this._originalStyleProvider = originalStyleProvider;
			this._addOnFunction = addOnFunction;
		}

		/**
		 * @private
		 */
		protected var _originalStyleProvider:IStyleProvider;

		/**
		 * The <code>addOnFunction</code> will be called after the original
		 * style provider applies its styles.
		 */
		public function get originalStyleProvider():IStyleProvider
		{
			return this._originalStyleProvider;
		}

		/**
		 * @private
		 */
		public function set originalStyleProvider(value:IStyleProvider):void
		{
			this._originalStyleProvider = value;
		}

		/**
		 * @private
		 */
		protected var _addOnFunction:Function;

		/**
		 * A function to call after applying the original style provider's
		 * styles.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:IFeathersControl ):void</pre>
		 */
		public function get addOnFunction():Function
		{
			return this._addOnFunction;
		}

		/**
		 * @private
		 */
		public function set addOnFunction(value:Function):void
		{
			this._addOnFunction = value;
		}

		/**
		 * @private
		 */
		protected var _callBeforeOriginalStyleProvider:Boolean = false;

		/**
		 * Determines if the add on function should be called before the
		 * original style provider is applied, or after.
		 *
		 * @default false
		 */
		public function get callBeforeOriginalStyleProvider():Boolean
		{
			return this._callBeforeOriginalStyleProvider;
		}

		/**
		 * @private
		 */
		public function set callBeforeOriginalStyleProvider(value:Boolean):void
		{
			this._callBeforeOriginalStyleProvider = value;
		}

		/**
		 * @inheritDoc
		 */
		public function applyStyles(target:IFeathersControl):void
		{
			if(this._callBeforeOriginalStyleProvider && this._addOnFunction !== null)
			{
				this._addOnFunction(target);
			}
			if(this._originalStyleProvider)
			{
				this._originalStyleProvider.applyStyles(target);
			}
			if(!this._callBeforeOriginalStyleProvider && this._addOnFunction !== null)
			{
				this._addOnFunction(target);
			}
		}

	}
}


================================================
FILE: source/feathers/skins/ConditionalStyleProvider.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.skins
{
	import feathers.core.IFeathersControl;

	/**
	 * A style provider that chooses between two different style providers.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class ConditionalStyleProvider implements IStyleProvider
	{
		/**
		 * Constructor.
		 */
		public function ConditionalStyleProvider(conditionalFunction:Function,
			trueStyleProvider:IStyleProvider = null, falseStyleProvider:IStyleProvider = null)
		{
			this._conditionalFunction = conditionalFunction;
			this._trueStyleProvider = trueStyleProvider;
			this._falseStyleProvider = falseStyleProvider;
		}

		/**
		 * @private
		 */
		protected var _trueStyleProvider:IStyleProvider;

		/**
		 * A call to <code>applyStyles()</code> is passed to this style provider
		 * when the <code>conditionalFunction</code> returns <code>true</code>.
		 */
		public function get trueStyleProvider():IStyleProvider
		{
			return this._trueStyleProvider;
		}

		/**
		 * @private
		 */
		public function set trueStyleProvider(value:IStyleProvider):void
		{
			this._trueStyleProvider = value;
		}

		/**
		 * @private
		 */
		protected var _falseStyleProvider:IStyleProvider;

		/**
		 * A call to <code>applyStyles()</code> is passed to this style provider
		 * when the <code>conditionalFunction</code> returns <code>false</code>.
		 */
		public function get falseStyleProvider():IStyleProvider
		{
			return this._falseStyleProvider;
		}

		/**
		 * @private
		 */
		public function set falseStyleProvider(value:IStyleProvider):void
		{
			this._falseStyleProvider = value;
		}

		/**
		 * @private
		 */
		protected var _conditionalFunction:Function;

		/**
		 * When <code>applyStyles()</code> is called, the target is passed to
		 * this function to determine which style provider should be called.
		 *
		 * <pre>function(target:IFeathersControl):Boolean</pre>
		 */
		public function get conditionalFunction():Function
		{
			return this._conditionalFunction;
		}

		/**
		 * @private
		 */
		public function set conditionalFunction(value:Function):void
		{
			this._conditionalFunction = value;
		}

		/**
		 * @private
		 */
		public function applyStyles(target:IFeathersControl):void
		{
			var result:Boolean = false;
			if(this._conditionalFunction !== null)
			{
				result = this._conditionalFunction(target) as Boolean;
			}
			if(result === true)
			{
				if(this._trueStyleProvider !== null)
				{
					this._trueStyleProvider.applyStyles(target);
				}
			}
			else if(this._falseStyleProvider !== null)
			{
				this._falseStyleProvider.applyStyles(target);
			}
		}
	}
}


================================================
FILE: source/feathers/skins/FunctionStyleProvider.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.skins
{
	import feathers.core.IFeathersControl;

	/**
	 * Sets styles on a Feathers UI component by passing the component to a
	 * function when the style provider's <code>applyStyles()</code> is called.
	 *
	 * <p>In the following example, a <code>FunctionStyleProvider</code> is
	 * created:</p>
	 * <listing version="3.0">
	 * var button:Button = new Button();
	 * button.label = "Click Me";
	 * button.styleProvider = new FunctionStyleProvider( function( target:Button ):void
	 * {
	 *     target.defaultSkin = new Image( texture );
	 *     // set other styles...
	 * });
	 * this.addChild( button );</listing>
	 *
	 * @see ../../../help/skinning.html Skinning Feathers components
	 *
	 * @productversion Feathers 2.0.0
	 */
	public class FunctionStyleProvider implements IStyleProvider
	{
		/**
		 * Constructor.
		 */
		public function FunctionStyleProvider(skinFunction:Function)
		{
			this._styleFunction = skinFunction;
		}

		/**
		 * @private
		 */
		protected var _styleFunction:Function;

		/**
		 * The target Feathers UI component is passed to this function when
		 * <code>applyStyles()</code> is called.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:IFeathersControl ):void</pre>
		 */
		public function get styleFunction():Function
		{
			return this._styleFunction;
		}

		/**
		 * @private
		 */
		public function set styleFunction(value:Function):void
		{
			this._styleFunction = value;
		}

		/**
		 * @inheritDoc
		 */
		public function applyStyles(target:IFeathersControl):void
		{
			if(this._styleFunction == null)
			{
				return;
			}
			this._styleFunction(target);
		}
	}
}


================================================
FILE: source/feathers/skins/IStyleProvider.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.skins
{
	import feathers.core.IFeathersControl;

	/**
	 * Sets skin and style properties on a Feathers UI component.
	 *
	 * @productversion Feathers 2.0.0
	 */
	public interface IStyleProvider
	{
		/**
		 * Applies styles to a specific Feathers UI component, unless that
		 * component has been excluded.
		 *
		 * @see #exclude()
		 */
		function applyStyles(target:IFeathersControl):void;
	}
}


================================================
FILE: source/feathers/skins/ImageSkin.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.skins
{
	import feathers.core.IFeathersControl;
	import feathers.core.IMeasureDisplayObject;
	import feathers.core.IStateContext;
	import feathers.core.IStateObserver;
	import feathers.core.IToggle;
	import feathers.events.FeathersEventType;

	import flash.errors.IllegalOperationError;
	import flash.geom.Point;
	import flash.geom.Rectangle;

	import starling.display.DisplayObject;
	import starling.display.Image;
	import starling.events.Event;
	import starling.textures.Texture;
	import starling.utils.Pool;

	[Exclude(name="color",kind="property")]

	/**
	 * A skin for Feathers components that displays a texture. Has the ability
	 * to change its texture based on the current state of the Feathers
	 * component that is being skinned.
	 *
	 * <listing version="3.0">
	 * var skin:ImageSkin = new ImageSkin( upTexture );
	 * skin.setTextureForState( ButtonState.DOWN, downTexture );
	 * skin.setTextureForState( ButtonState.HOVER, hoverTexture );
	 * 
	 * var button:Button = new Button();
	 * button.label = "Click Me";
	 * button.defaultSkin = skin;
	 * this.addChild( button );</listing>
	 *
	 * @see starling.display.Image
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class ImageSkin extends Image implements IMeasureDisplayObject, IStateObserver
	{
		/**
		 * Constructor.
		 */
		public function ImageSkin(defaultTexture:Texture = null)
		{
			super(defaultTexture);
			//the super constructor sets the color property, so we need to wait
			//before restricting it
			this._restrictColor = true;
			this.defaultTexture = defaultTexture;
		}

		/**
		 * @private
		 */
		protected var _restrictColor:Boolean = false;

		/**
		 * @private
		 */
		protected var _defaultTexture:Texture;

		/**
		 * The default texture that the skin will display. If the component
		 * being skinned supports states, the texture for a specific state may
		 * be specified using the <code>setTextureForState()</code> method. If
		 * no texture has been specified for the current state, the default
		 * texture will be used.
		 *
		 * <p>In the following example, the default texture is specified in the
		 * constructor:</p>
		 *
		 * <listing version="3.0">
		 * var skin:ImageSkin = new ImageSkin( texture );</listing>
		 *
		 * <p>In the following example, the default texture is specified by
		 * setting the property:</p>
		 *
		 * <listing version="3.0">
		 * var skin:ImageSkin = new ImageSkin();
		 * skin.defaultTexture = texture;</listing>
		 *
		 * @default null
		 *
		 * @see #disabledTexture
		 * @see #selectedTexture
		 * @see #setTextureForState()
		 * @see http://doc.starling-framework.org/current/starling/textures/Texture.html starling.textures.Texture
		 */
		public function get defaultTexture():Texture
		{
			return this._defaultTexture;
		}

		/**
		 * @private
		 */
		public function set defaultTexture(value:Texture):void
		{
			if(this._defaultTexture === value)
			{
				return;
			}
			this._defaultTexture = value;
			this.updateTextureFromContext();
		}

		/**
		 * @private
		 */
		protected var _disabledTexture:Texture;

		/**
		 * The texture to display when the <code>stateContext</code> is
		 * an <code>IFeathersControl</code> and its <code>isEnabled</code>
		 * property is <code>false</code>. If a texture has been specified for
		 * the context's current state with <code>setTextureForState()</code>,
		 * it will take precedence over the <code>disabledTexture</code>.
		 *
		 * <p>In the following example, the disabled texture is changed:</p>
		 *
		 * <listing version="3.0">
		 * var skin:ImageSkin = new ImageSkin( upTexture );
		 * skin.disabledTexture = disabledTexture;
		 * 
		 * var button:Button = new Button();
		 * button.defaultSkin = skin;
		 * button.isEnabled = false;</listing>
		 *
		 * @default null
		 *
		 * @see #defaultTexture
		 * @see #selectedTexture
		 * @see #setTextureForState()
		 * @see http://doc.starling-framework.org/current/starling/textures/Texture.html starling.textures.Texture
		 */
		public function get disabledTexture():Texture
		{
			return this._disabledTexture;
		}

		/**
		 * @private
		 */
		public function set disabledTexture(value:Texture):void
		{
			if(this._disabledTexture === value)
			{
				return;
			}
			this._disabledTexture = value;
			this.updateTextureFromContext();
		}

		/**
		 * @private
		 */
		protected var _selectedTexture:Texture;

		/**
		 * The texture to display when the <code>stateContext</code> is
		 * an <code>IToggle</code> instance and its <code>isSelected</code>
		 * property is <code>true</code>. If a texture has been specified for
		 * the context's current state with <code>setTextureForState()</code>,
		 * it will take precedence over the <code>selectedTexture</code>.
		 *
		 * <p>In the following example, the selected texture is changed:</p>
		 *
		 * <listing version="3.0">
		 * var skin:ImageSkin = new ImageSkin( upTexture );
		 * skin.selectedTexture = selectedTexture;
		 * 
		 * var toggleButton:ToggleButton = new ToggleButton();
		 * toggleButton.defaultSkin = skin;
		 * toggleButton.isSelected = true;</listing>
		 *
		 * @default null
		 *
		 * @see #defaultTexture
		 * @see #disabledTexture
		 * @see #setTextureForState()
		 * @see http://doc.starling-framework.org/current/starling/textures/Texture.html starling.textures.Texture
		 */
		public function get selectedTexture():Texture
		{
			return this._selectedTexture;
		}

		/**
		 * @private
		 */
		public function set selectedTexture(value:Texture):void
		{
			if(this._selectedTexture === value)
			{
				return;
			}
			this._selectedTexture = value;
			this.updateTextureFromContext();
		}

		/**
		 * @private
		 */
		override public function set color(value:uint):void
		{
			if(this._restrictColor)
			{
				throw new IllegalOperationError("To set the color of an ImageSkin, use defaultColor or setColorForState().");
			}
			this.$color = value;
		}

		/**
		 * @private
		 * Subclasses may use this setter to change the color.
		 */
		protected function set $color(value:uint):void
		{
			super.color = value;
		}

		/**
		 * @private
		 */
		protected var _defaultColor:uint = 0xffffff;

		/**
		 * The default color to use to tint the skin. If the component
		 * being skinned supports states, the color for a specific state may
		 * be specified using the <code>setColorForState()</code> method. If
		 * no color has been specified for the current state, the default
		 * color will be used.
		 *
		 * <p>To set the color of an <code>ImageSkin</code>, the
		 * <code>defaultColor</code> property should be preferred over the
		 * <code>color</code> property defined on
		 * <code>starling.display.Mesh</code>. The <code>ImageSkin</code>
		 * will manage the <code>color</code> property internally.</p>
		 *
		 * <p>A value of <code>uint.MAX_VALUE</code> means that the
		 * <code>color</code> property will not be changed when the context's
		 * state changes.</p>
		 *
		 * <p>In the following example, the default color is specified:</p>
		 *
		 * <listing version="3.0">
		 * var skin:ImageSkin = new ImageSkin();
		 * skin.defaultColor = 0x9f0000;</listing>
		 *
		 * @default 0xffffff
		 *
		 * @see #disabledColor
		 * @see #selectedColor
		 * @see #setColorForState()
		 */
		public function get defaultColor():uint
		{
			return this._defaultColor;
		}

		/**
		 * @private
		 */
		public function set defaultColor(value:uint):void
		{
			if(this._defaultColor == value)
			{
				return;
			}
			this._defaultColor = value;
			this.updateColorFromContext();
		}

		/**
		 * @private
		 */
		protected var _disabledColor:uint = uint.MAX_VALUE;

		/**
		 * The color to tint the skin when the <code>stateContext</code> is
		 * an <code>IFeathersControl</code> and its <code>isEnabled</code>
		 * property is <code>false</code>. If a color has been specified for
		 * the context's current state with <code>setColorForState()</code>,
		 * it will take precedence over the <code>disabledColor</code>.
		 *
		 * <p>A value of <code>uint.MAX_VALUE</code> means that the
		 * <code>disabledColor</code> property cannot affect the tint when the
		 * context's state changes.</p>
		 *
		 * <p>In the following example, the disabled color is changed:</p>
		 *
		 * <listing version="3.0">
		 * var skin:ImageSkin = new ImageSkin();
		 * skin.defaultColor = 0xffffff;
		 * skin.disabledColor = 0x999999;
		 * 
		 * var button:Button = new Button();
		 * button.defaultSkin = skin;
		 * button.isEnabled = false;</listing>
		 *
		 * @default uint.MAX_VALUE
		 *
		 * @see #defaultColor
		 * @see #selectedColor
		 * @see #setColorForState()
		 */
		public function get disabledColor():uint
		{
			return this._disabledColor;
		}

		/**
		 * @private
		 */
		public function set disabledColor(value:uint):void
		{
			if(this._disabledColor == value)
			{
				return;
			}
			this._disabledColor = value;
			this.updateColorFromContext();
		}

		/**
		 * @private
		 */
		protected var _selectedColor:uint = uint.MAX_VALUE;

		/**
		 * The color to tint the skin when the <code>stateContext</code> is
		 * an <code>IToggle</code> instance and its <code>isSelected</code>
		 * property is <code>true</code>. If a color has been specified for
		 * the context's current state with <code>setColorForState()</code>,
		 * it will take precedence over the <code>selectedColor</code>.
		 *
		 * <p>In the following example, the selected color is changed:</p>
		 *
		 * <listing version="3.0">
		 * var skin:ImageSkin = new ImageSkin();
		 * skin.defaultColor = 0xffffff;
		 * skin.selectedColor = 0xffcc00;
		 * 
		 * var toggleButton:ToggleButton = new ToggleButton();
		 * toggleButton.defaultSkin = skin;
		 * toggleButton.isSelected = true;</listing>
		 *
		 * @default uint.MAX_VALUE
		 *
		 * @see #defaultColor
		 * @see #disabledColor
		 * @see #setColorForState()
		 */
		public function get selectedColor():uint
		{
			return this._selectedColor;
		}

		/**
		 * @private
		 */
		public function set selectedColor(value:uint):void
		{
			if(this._selectedColor == value)
			{
				return;
			}
			this._selectedColor = value;
			this.updateColorFromContext();
		}

		/**
		 * @private
		 */
		protected var _stateContext:IStateContext;

		/**
		 * When the skin observes a state context, the skin may change its
		 * <code>Texture</code> based on the current state of that context.
		 * Typically, a relevant component will automatically assign itself as
		 * the state context of its skin, so this property is considered to be
		 * for internal use only.
		 *
		 * @default null
		 *
		 * @see #setTextureForState()
		 */
		public function get stateContext():IStateContext
		{
			return this._stateContext;
		}

		/**
		 * @private
		 */
		public function set stateContext(value:IStateContext):void
		{
			if(this._stateContext === value)
			{
				return;
			}
			if(this._stateContext)
			{
				this._stateContext.removeEventListener(FeathersEventType.STATE_CHANGE, stateContext_stageChangeHandler);
			}
			this._stateContext = value;
			if(this._stateContext)
			{
				this._stateContext.addEventListener(FeathersEventType.STATE_CHANGE, stateContext_stageChangeHandler);
			}
			this.updateTextureFromContext();
			this.updateColorFromContext();
		}

		/**
		 * @private
		 */
		protected var _explicitWidth:Number = NaN;

		/**
		 * The value passed to the <code>width</code> property setter. If the
		 * <code>width</code> property has not be set, returns <code>NaN</code>.
		 *
		 * @see #width
		 */
		public function get explicitWidth():Number
		{
			return this._explicitWidth;
		}

		/**
		 * @private
		 */
		override public function set width(value:Number):void
		{
			if(this._explicitWidth == value)
			{
				return;
			}
			if(value !== value && this._explicitWidth !== this._explicitWidth) //isNaN
			{
				return;
			}
			this._explicitWidth = value;
			if(value === value) //!isNaN
			{
				super.width = value;
			}
			else if(this.texture !== null)
			{
				//return to the original width of the texture
				this.scaleX = 1;
				this.readjustSize(this.texture.frameWidth);
			}
			else
			{
				this.readjustSize();
			}
			this.dispatchEventWith(Event.RESIZE);
		}

		/**
		 * @private
		 */
		protected var _explicitHeight:Number = NaN;

		/**
		 * The value passed to the <code>height</code> property setter. If the
		 * <code>height</code> property has not be set, returns
		 * <code>NaN</code>.
		 *
		 * @see #height
		 */
		public function get explicitHeight():Number
		{
			return this._explicitHeight;
		}

		/**
		 * @private
		 */
		override public function set height(value:Number):void
		{
			if(this._explicitHeight == value)
			{
				return;
			}
			if(value !== value && this._explicitHeight !== this._explicitHeight) //isNaN
			{
				return;
			}
			this._explicitHeight = value;
			if(value === value) //!isNaN
			{
				super.height = value;
			}
			else if(this.texture !== null)
			{
				//return to the original height of the texture
				this.scaleY = 1;
				this.readjustSize(-1, this.texture.frameHeight);
			}
			else
			{
				this.readjustSize();
			}
			this.dispatchEventWith(Event.RESIZE);
		}

		/**
		 * @private
		 */
		protected var _explicitMinWidth:Number = NaN;

		/**
		 * The value passed to the <code>minWidth</code> property setter. If the
		 * <code>minWidth</code> property has not be set, returns
		 * <code>NaN</code>.
		 *
		 * @see #minWidth
		 */
		public function get explicitMinWidth():Number
		{
			return this._explicitMinWidth;
		}

		/**
		 * The minimum width of the component.
		 */
		public function get minWidth():Number
		{
			if(this._explicitMinWidth === this._explicitMinWidth) //!isNaN
			{
				return this._explicitMinWidth;
			}
			return 0;
		}

		/**
		 * @private
		 */
		public function set minWidth(value:Number):void
		{
			if(this._explicitMinWidth == value)
			{
				return;
			}
			if(value !== value && this._explicitMinWidth !== this._explicitMinWidth) //isNaN
			{
				return;
			}
			this._explicitMinWidth = value;
			this.dispatchEventWith(Event.RESIZE);
		}

		/**
		 * @private
		 */
		protected var _explicitMaxWidth:Number = Number.POSITIVE_INFINITY;

		/**
		 * The value passed to the <code>maxWidth</code> property setter. If the
		 * <code>maxWidth</code> property has not be set, returns
		 * <code>NaN</code>.
		 *
		 * @see #maxWidth
		 */
		public function get explicitMaxWidth():Number
		{
			return this._explicitMaxWidth;
		}

		/**
		 * The maximum width of the component.
		 */
		public function get maxWidth():Number
		{
			return this._explicitMaxWidth;
		}

		/**
		 * @private
		 */
		public function set maxWidth(value:Number):void
		{
			if(this._explicitMaxWidth == value)
			{
				return;
			}
			if(value !== value && this._explicitMaxWidth !== this._explicitMaxWidth) //isNaN
			{
				return;
			}
			this._explicitMaxWidth = value;
			this.dispatchEventWith(Event.RESIZE);
		}

		/**
		 * @private
		 */
		protected var _explicitMinHeight:Number = NaN;

		/**
		 * The value passed to the <code>minHeight</code> property setter. If
		 * the <code>minHeight</code> property has not be set, returns
		 * <code>NaN</code>.
		 *
		 * @see #minHeight
		 */
		public function get explicitMinHeight():Number
		{
			return this._explicitMinHeight;
		}

		/**
		 * The minimum height of the component.
		 */
		public function get minHeight():Number
		{
			if(this._explicitMinHeight === this._explicitMinHeight) //!isNaN
			{
				return this._explicitMinHeight;
			}
			return 0;
		}

		/**
		 * @private
		 */
		public function set minHeight(value:Number):void
		{
			if(this._explicitMinHeight == value)
			{
				return;
			}
			if(value !== value && this._explicitMinHeight !== this._explicitMinHeight) //isNaN
			{
				return;
			}
			this._explicitMinHeight = value;
			this.dispatchEventWith(Event.RESIZE);
		}

		/**
		 * @private
		 */
		protected var _explicitMaxHeight:Number = Number.POSITIVE_INFINITY;

		/**
		 * The value passed to the <code>maxHeight</code> property setter. If
		 * the <code>maxHeight</code> property has not be set, returns
		 * <code>NaN</code>.
		 *
		 * @see #maxHeight
		 */
		public function get explicitMaxHeight():Number
		{
			return this._explicitMaxHeight;
		}

		/**
		 * The maximum height of the component.
		 */
		public function get maxHeight():Number
		{
			return this._explicitMaxHeight;
		}

		/**
		 * @private
		 */
		public function set maxHeight(value:Number):void
		{
			if(this._explicitMaxHeight == value)
			{
				return;
			}
			if(value !== value && this._explicitMaxHeight !== this._explicitMaxHeight) //isNaN
			{
				return;
			}
			this._explicitMaxHeight = value;
			this.dispatchEventWith(Event.RESIZE);
		}

		/**
		 * @private
		 */
		protected var _minTouchWidth:Number = 0;

		/**
		 * If the skin's width is smaller than this value, the hit area will be expanded.
		 *
		 * <p>In the following example, the minimum width of the hit area is
		 * set to 120 pixels:</p>
		 *
		 * <listing version="3.0">
		 * skin.minTouchWidth = 120;</listing>
		 *
		 * @default 0
		 */
		public function get minTouchWidth():Number
		{
			return this._minTouchWidth;
		}

		/**
		 * @private
		 */
		public function set minTouchWidth(value:Number):void
		{
			this._minTouchWidth = value;
		}

		/**
		 * @private
		 */
		protected var _minTouchHeight:Number = 0;

		/**
		 * If the skin's height is smaller than this value, the hit area will be expanded.
		 *
		 * <p>In the following example, the minimum height of the hit area is
		 * set to 120 pixels:</p>
		 *
		 * <listing version="3.0">
		 * skin.minTouchHeight = 120;</listing>
		 *
		 * @default 0
		 */
		public function get minTouchHeight():Number
		{
			return this._minTouchHeight;
		}

		/**
		 * @private
		 */
		public function set minTouchHeight(value:Number):void
		{
			this._minTouchHeight = value;
		}

		/**
		 * @private
		 */
		protected var _stateToTexture:Object = {};

		/**
		 * @private
		 */
		protected var _stateToColor:Object = {};

		/**
		 * Gets the texture to be used by the skin when the context's
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If a texture is not defined for a specific state, returns
		 * <code>null</code>.</p>
		 *
		 * @see #setTextureForState()
		 */
		public function getTextureForState(state:String):Texture
		{
			return this._stateToTexture[state] as Texture;
		}

		/**
		 * Sets the texture to be used by the skin when the context's
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If a texture is not defined for a specific state, the value of the
		 * <code>defaultTexture</code> property will be used instead.</p>
		 *
		 * @see #defaultTexture
		 * @see #getTextureForState()
		 */
		public function setTextureForState(state:String, texture:Texture):void
		{
			if(texture !== null)
			{
				this._stateToTexture[state] = texture;
			}
			else
			{
				delete this._stateToTexture[state];
			}
			this.updateTextureFromContext();
		}

		/**
		 * Gets the color to be used by the skin when the context's
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If a color is not defined for a specific state, returns
		 * <code>uint.MAX_VALUE</code>.</p>
		 *
		 * @see #setColorForState()
		 */
		public function getColorForState(state:String):uint
		{
			if(state in this._stateToColor)
			{
				return this._stateToColor[state] as uint;
			}
			return uint.MAX_VALUE;
		}

		/**
		 * Sets the color to be used by the skin when the context's
		 * <code>currentState</code> property matches the specified state value.
		 *
		 * <p>If a color is not defined for a specific state, the value of the
		 * <code>defaultTexture</code> property will be used instead.</p>
		 *
		 * <p>To clear a state's color, pass in <code>uint.MAX_VALUE</code>.</p>
		 *
		 * @see #defaultColor
		 * @see #getColorForState()
		 */
		public function setColorForState(state:String, color:uint):void
		{
			if(color != uint.MAX_VALUE)
			{
				this._stateToColor[state] = color;
			}
			else
			{
				delete this._stateToColor[state];
			}
			this.updateColorFromContext();
		}

		/**
		 * @private
		 */
		override public function readjustSize(width:Number = -1, height:Number = -1):void
		{
			super.readjustSize(width, height);
			if(this._explicitWidth === this._explicitWidth) //!isNaN
			{
				super.width = this._explicitWidth;
			}
			if(this._explicitHeight === this._explicitHeight) //!isNaN
			{
				super.height = this._explicitHeight;
			}
		}

		/**
		 * @private
		 */
		override public function hitTest(localPoint:Point):DisplayObject
		{
			if(this._minTouchWidth > 0 || this._minTouchHeight > 0)
			{
				if(!this.visible || !this.touchable)
				{
					return null;
				}
				if(this.mask && !this.hitTestMask(localPoint))
				{
					return null;
				}
				var rect:Rectangle = Pool.getRectangle();
				this.getBounds(this, rect);
				if(rect.width < this._minTouchWidth)
				{
					var difference:Number = this._minTouchWidth - rect.width;
					rect.width += difference;
					rect.x -= difference / 2;
				}
				if(rect.height < this._minTouchHeight)
				{
					difference = this._minTouchHeight - rect.height;
					rect.height += difference;
					rect.y -= difference / 2;
				}
				var result:Boolean = rect.containsPoint(localPoint);
				Pool.putRectangle(rect);
				return result ? this : null;
			}
			return super.hitTest(localPoint);
		}

		/**
		 * @private
		 */
		protected function updateTextureFromContext():void
		{
			var texture:Texture = null;
			if(this._stateContext === null)
			{
				texture = this._defaultTexture;
			}
			else
			{
				texture = this._stateToTexture[this._stateContext.currentState] as Texture;
				if(texture === null &&
					this._disabledTexture !== null &&
					this._stateContext is IFeathersControl && !IFeathersControl(this._stateContext).isEnabled)
				{
					texture = this._disabledTexture;
				}
				if(texture === null &&
					this._selectedTexture !== null &&
					this._stateContext is IToggle &&
					IToggle(this._stateContext).isSelected)
				{
					texture = this._selectedTexture;
				}
				if(texture === null)
				{
					texture = this._defaultTexture;
				}
			}
			this.texture = texture;
		}

		/**
		 * @private
		 */
		protected function updateColorFromContext():void
		{
			if(this._stateContext === null)
			{
				if(this._defaultColor != uint.MAX_VALUE)
				{
					this.$color = this._defaultColor;
				}
				return;
			}
			var color:uint = uint.MAX_VALUE;
			var currentState:String = this._stateContext.currentState;
			if(currentState in this._stateToColor)
			{
				color = this._stateToColor[currentState] as uint;
			}
			if(color == uint.MAX_VALUE &&
				this._disabledColor != uint.MAX_VALUE &&
				this._stateContext is IFeathersControl && !IFeathersControl(this._stateContext).isEnabled)
			{
				color = this._disabledColor;
			}
			if(color == uint.MAX_VALUE &&
				this._selectedColor != uint.MAX_VALUE &&
				this._stateContext is IToggle &&
				IToggle(this._stateContext).isSelected)
			{
				color = this._selectedColor;
			}
			if(color == uint.MAX_VALUE)
			{
				color = this._defaultColor;
			}
			if(color != uint.MAX_VALUE)
			{
				this.$color = color;
			}
		}

		/**
		 * @private
		 */
		protected function stateContext_stageChangeHandler(event:Event):void
		{
			this.updateTextureFromContext();
			this.updateColorFromContext();
		}
	}
}


================================================
FILE: source/feathers/skins/StyleNameFunctionStyleProvider.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.skins
{
	import feathers.core.IFeathersControl;
	import feathers.core.TokenList;

	/**
	 * Similar to <code>FunctionStyleProvider</code>, sets styles on a Feathers
	 * UI component by passing it to a function, but also provides a way to
	 * define alternate functions that may be called based on the contents of
	 * the component's <code>styleNameList</code>.
	 *
	 * <p>Alternate functions may be registered with the style provider by
	 * calling <code>setFunctionForStyleName()</code> and passing in a style
	 * name and a function. For each style name in the component's
	 * <code>styleNameList</code>, the style provider will search its registered
	 * style names to see if a function should be called. If none of a
	 * component's style names have been registered with the style provider (or
	 * if the component has no style names), then the default style function
	 * will be called.</p>
	 *
	 * <p>If a component's <code>styleNameList</code> contains multiple values,
	 * each of those values is eligible to trigger a call to a function
	 * registered with the style provider. In other words, adding multiple
	 * values to a component's <code>styleNameList</code> may be used to call
	 * multiple functions.</p>
	 *
	 * <p>In the following example, a <code>StyleNameFunctionStyleProvider</code> is
	 * created with a default style function (passed to the constructor) and
	 * an alternate style function:</p>
	 * <listing version="3.0">
	 * var styleProvider:StyleNameFunctionStyleProvider = new StyleNameFunctionStyleProvider( function( target:Button ):void
	 * {
	 *     target.defaultSkin = new Image( defaultTexture );
	 *     // set other styles...
	 * });
	 * styleProvider.setFunctionForStyleName( "alternate-button", function( target:Button ):void
	 * {
	 *     target.defaultSkin = new Image( alternateTexture );
	 *     // set other styles...
	 * });
	 * 
	 * var button:Button = new Button();
	 * button.label = "Click Me";
	 * button.styleProvider = styleProvider;
	 * this.addChild(button);
	 * 
	 * var alternateButton:Button = new Button()
	 * button.label = "No, click me!";
	 * alternateButton.styleProvider = styleProvider;
	 * alternateButton.styleNameList.add( "alternate-button" );
	 * this.addChild( alternateButton );</listing>
	 *
	 * @see ../../../help/skinning.html Skinning Feathers components
	 *
	 * @productversion Feathers 2.0.0
	 */
	public class StyleNameFunctionStyleProvider implements IStyleProvider
	{
		/**
		 * Constructor.
		 */
		public function StyleNameFunctionStyleProvider(styleFunction:Function = null)
		{
			this._defaultStyleFunction = styleFunction;
		}

		/**
		 * @private
		 */
		protected var _defaultStyleFunction:Function;

		/**
		 * The target Feathers UI component is passed to this function when
		 * <code>applyStyles()</code> is called and the component's
		 * <code>styleNameList</code> doesn't contain any style names that are
		 * set with <code>setFunctionForStyleName()</code>.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:IFeathersControl ):void</pre>
		 *
		 * @see #setFunctionForStyleName()
		 */
		public function get defaultStyleFunction():Function
		{
			return this._defaultStyleFunction;
		}

		/**
		 * @private
		 */
		public function set defaultStyleFunction(value:Function):void
		{
			this._defaultStyleFunction = value;
		}

		/**
		 * @private
		 */
		protected var _styleNameMap:Object;

		/**
		 * The target Feathers UI component is passed to this function when
		 * <code>applyStyles()</code> is called and the component's
		 * <code>styleNameList</code> contains the specified style name.
		 *
		 * <p>The function is expected to have the following signature:</p>
		 * <pre>function( item:IFeathersControl ):void</pre>
		 *
		 * @see #defaultStyleFunction
		 */
		public function setFunctionForStyleName(styleName:String, styleFunction:Function):void
		{
			if(!this._styleNameMap)
			{
				this._styleNameMap = {};
			}
			this._styleNameMap[styleName] = styleFunction;
		}

		/**
		 * @inheritDoc
		 */
		public function applyStyles(target:IFeathersControl):void
		{
			if(this._styleNameMap)
			{
				var hasNameInitializers:Boolean = false;
				var styleNameList:TokenList = target.styleNameList;
				var styleNameCount:int = styleNameList.length;
				for(var i:int = 0; i < styleNameCount; i++)
				{
					var name:String = styleNameList.item(i);
					var initializer:Function = this._styleNameMap[name] as Function;
					if(initializer != null)
					{
						hasNameInitializers = true;
						initializer(target);
					}
				}
				if(hasNameInitializers)
				{
					return;
				}
			}
			if(this._defaultStyleFunction != null)
			{
				this._defaultStyleFunction(target);
			}
		}
	}
}


================================================
FILE: source/feathers/skins/StyleProviderRegistry.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.skins
{
	import flash.utils.Dictionary;

	/**
	 * Used by themes to create and manage style providers for component classes.
	 *
	 * @productversion Feathers 2.0.0
	 */
	public class StyleProviderRegistry
	{
		/**
		 * @private
		 */
		protected static const GLOBAL_STYLE_PROVIDER_PROPERTY_NAME:String = "globalStyleProvider";

		/**
		 * @private
		 */
		protected static function defaultStyleProviderFactory():IStyleProvider
		{
			return new StyleNameFunctionStyleProvider();
		}

		/**
		 * Constructor.
		 *
		 * <p>If style providers are to be registered globally, they will be
		 * passed to the static <code>globalStyleProvider</code> property of the
		 * specified class. If the class does not define a
		 * <code>globalStyleProvider</code> property, an error will be thrown.</p>
		 *
		 * <p>The style provider factory function is expected to have the following
		 * signature:</p>
		 * <pre>function():IStyleProvider</pre>
		 *
		 * @param registerGlobally			Determines if the registry sets the static <code>globalStyleProvider</code> property.
		 * @param styleProviderFactory		An optional function that creates a new style provider. If <code>null</code>, a <code>StyleNameFunctionStyleProvider</code> will be created.
		 */
		public function StyleProviderRegistry(registerGlobally:Boolean = true, styleProviderFactory:Function = null)
		{
			this._registerGlobally = registerGlobally;
			if(styleProviderFactory === null)
			{
				this._styleProviderFactory = defaultStyleProviderFactory;
			}
			else
			{
				this._styleProviderFactory = styleProviderFactory;
			}

		}

		/**
		 * @private
		 */
		protected var _registerGlobally:Boolean;

		/**
		 * @private
		 */
		protected var _styleProviderFactory:Function;

		/**
		 * @private
		 */
		protected var _classToStyleProvider:Dictionary = new Dictionary(true);

		/**
		 * Disposes the theme.
		 */
		public function dispose():void
		{
			//clear the global style providers, but only if they still match the
			//ones that the theme created. a developer could replace the global
			//style providers with different ones.
			for(var untypedType:Object in this._classToStyleProvider)
			{
				var type:Class = Class(untypedType);
				this.clearStyleProvider(type);
			}
			this._classToStyleProvider = null;
		}

		/**
		 * Determines if an <code>IStyleProvider</code> for the specified
		 * component class has been created.
		 *
		 * @param forClass					The class that may have a style provider.
		 */
		public function hasStyleProvider(forClass:Class):Boolean
		{
			if(this._classToStyleProvider === null)
			{
				return false;
			}
			return forClass in this._classToStyleProvider;
		}

		/**
		 * Returns all classes that have been registered with a style provider.
		 */
		public function getRegisteredClasses(result:Vector.<Class> = null):Vector.<Class>
		{
			if(result !== null)
			{
				result.length = 0;
			}
			else
			{
				result = new <Class>[];
			}
			var index:int = 0;
			for(var forClass:Object in this._classToStyleProvider)
			{
				result[index] = forClass as Class;
				index++;
			}
			return result;
		}

		/**
		 * Creates an <code>IStyleProvider</code> for the specified component
		 * class, or if it was already created, returns the existing registered
		 * style provider. If the registry is global, a newly created style
		 * provider will be passed to the static <code>globalStyleProvider</code>
		 * property of the specified class.
		 *
		 * @param forClass					The style provider is registered for this class.
		 * @param styleProviderFactory		A factory used to create the style provider.
		 */
		public function getStyleProvider(forClass:Class):IStyleProvider
		{
			this.validateComponentClass(forClass);
			var styleProvider:IStyleProvider = IStyleProvider(this._classToStyleProvider[forClass]);
			if(!styleProvider)
			{
				styleProvider = this._styleProviderFactory();
				this._classToStyleProvider[forClass] = styleProvider;
				if(this._registerGlobally)
				{
					forClass[GLOBAL_STYLE_PROVIDER_PROPERTY_NAME] = styleProvider;
				}
			}
			return styleProvider;
		}

		/**
		 * Removes the style provider for the specified component class. If the
		 * registry is global, and the static <code>globalStyleProvider</code>
		 * property contains the same value, it will be set to <code>null</code>.
		 * If it contains a different value, then it will be left unchanged to
		 * avoid conflicts with other registries or code.
		 *
		 * @param forClass		The style provider is registered for this class.
		 */
		public function clearStyleProvider(forClass:Class):IStyleProvider
		{
			this.validateComponentClass(forClass);
			if(forClass in this._classToStyleProvider)
			{
				var styleProvider:IStyleProvider = IStyleProvider(this._classToStyleProvider[forClass]);
				delete this._classToStyleProvider[forClass];
				if(this._registerGlobally &&
					forClass[GLOBAL_STYLE_PROVIDER_PROPERTY_NAME] === styleProvider)
				{
					//something else may have changed the global style provider
					//after this registry set it, so we check if it's equal
					//before setting to null.
					forClass[GLOBAL_STYLE_PROVIDER_PROPERTY_NAME] = null;
				}
				return styleProvider;
			}
			return null;
		}

		/**
		 * @private
		 */
		protected function validateComponentClass(type:Class):void
		{
			if(!this._registerGlobally || Object(type).hasOwnProperty(GLOBAL_STYLE_PROVIDER_PROPERTY_NAME))
			{
				return;
			}
			throw ArgumentError("Class " + type + " must have a " + GLOBAL_STYLE_PROVIDER_PROPERTY_NAME + " static property to support themes.");
		}
	}
}


================================================
FILE: source/feathers/system/DeviceCapabilities.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.system
{
	import flash.display.Stage;
	import flash.system.Capabilities;

	import starling.core.Starling;

	/**
	 * Using values from the Stage and Capabilities classes, makes educated
	 * guesses about the physical size of the device this code is running on.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class DeviceCapabilities
	{
		/**
		 * Indicates if the arrow and enter keys on a standard keyboard are
		 * treated the same as a d-pad. If <code>true</code>, focus and other
		 * behaviors may be controlled with a standard keyboard.
		 *
		 * <p>In the following example, the D-Pad is simulated:</p>
		 *
		 * <listing version="3.0">
		 * DeviceCapabilities.simulateDPad = true;</listing>
		 *
		 * @default false
		 *
		 * @productversion Feathers 3.4.0
		 */
		public static var simulateDPad:Boolean = false;

		//early Android tablets were frequently 600x1024 170 DPI, which results
		//in a portrait width slightly larger than 3.5 inches
		/**
		 * The minimum physical width, in inches, of the device when in
		 * portrait orientation to be considered a tablet.
		 *
		 * <p>When calling <code>isTablet()</code>, a device must meet the
		 * requirements of both the minimum portrait width and the minimum
		 * landscape width.</p>
		 *
		 * @default 3.5
		 *
		 * @see #tabletScreenLandscapeWidthMinimumInches
		 * @see #isTablet()
		 */
		public static var tabletScreenPortraitWidthMinimumInches:Number = 3.5;

		/**
		 * The minimum physical size, in inches, of the device's larger side to
		 * be considered a tablet.
		 *
		 * <p>When calling <code>isTablet()</code>, a device must meet the
		 * requirements of both the minimum portrait width and the minimum
		 * landscape width.</p>
		 *
		 * @default 5
		 *
		 * @see #tabletScreenPortraitWidthMinimumInches
		 * @see #isTablet()
		 */
		public static var tabletScreenLandscapeWidthMinimumInches:Number = 5;

		//the iPhone X is 1125x2436 458 DPI, which results in a portrait width
		//of ~2.45 inches. This device should be treated as a small phone.
		//the Pixel XL is 1440x2560 534 DPI, which results in a portrait width
		//of ~2.69 inches. This device should be treated as a large phone.
		/**
		 * The minimum physical width, in inches, of the device when in
		 * portrait orientation to be considered a large phone (sometimes
		 * called a phablet).
		 *
		 * <p>When calling <code>isLargePhone()</code>, a device must meet the
		 * requirements of both the minimum portrait width and the minimum
		 * landscape width.</p>
		 *
		 * @default 2.5
		 *
		 * @see #largePhoneScreenLandscapeWidthMinimumInches
		 * @see #isLargePhone()
		 */
		public static var largePhoneScreenPortraitWidthMinimumInches:Number = 2.5;

		/**
		 * The minimum physical size, in inches, of the device's larger side to
		 * be considered a large phone (sometimes called a phablet).
		 *
		 * <p>When calling <code>isLargePhone()</code>, a device must meet the
		 * requirements of both the minimum portrait width and the minimum
		 * landscape width.</p>
		 *
		 * @default 4.5
		 *
		 * @see #largePhoneScreenPortraitWidthMinimumInches
		 * @see #isLargePhone()
		 */
		public static var largePhoneScreenLandscapeWidthMinimumInches:Number = 4.5;

		/**
		 * A custom width, in pixels, to use for calculations of the device's
		 * physical screen size. Set to NaN to use the actual width.
		 *
		 * @default flash.display.Stage.fullScreenWidth
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/display/Stage.html#fullScreenWidth Full description of flash.display.Stage.fullScreenWidth in Adobe's Flash Platform API Reference
		 */
		public static var screenPixelWidth:Number = NaN;

		/**
		 * A custom height, in pixels, to use for calculations of the device's
		 * physical screen size. Set to NaN to use the actual height.
		 *
		 * @default flash.display.Stage.fullScreenHeight
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/display/Stage.html#fullScreenWidth Full description of flash.display.Stage.fullScreenWidth in Adobe's Flash Platform API Reference
		 */
		public static var screenPixelHeight:Number = NaN;

		/**
		 * The screen density to be used by Feathers. Defaults to the value of
		 * <code>flash.system.Capabilities.screenDPI</code>, but may be
		 * overridden. For example, if one wishes to demo a mobile app in a
		 * desktop browser, a custom screen density will override the real
		 * density of the desktop screen.
		 *
		 * <p><strong>Warning:</strong> You should avoid changing this value on
		 * a mobile device because it may result in unexpected side effects. In
		 * addition to being used to scale components in the example themes, the
		 * screen density is used by components such as <code>Scroller</code>
		 * (and its subclasses like <code>List</code> and
		 * <code>ScrollContainer</code>) to optimize the scrolling behavior.
		 * Reporting a different screen density may cause some components to
		 * appear poorly responsive (or overly sensitive) to touches.</p>
		 *
		 * @default flash.system.Capabilities.screenDPI
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/system/Capabilities.html#screenDPI Full description of flash.system.Capabilities.screenDPI in Adobe's Flash Platform API Reference
		 */
		public static var dpi:int = Capabilities.screenDPI;

		/**
		 * Determines if this device is probably a tablet, based on the physical
		 * width and height, in inches, calculated using the full-screen
		 * dimensions and the screen density.
		 *
		 * @see #tabletScreenPortraitWidthMinimumInches
		 * @see #tabletScreenLandscapeWidthMinimumInches
		 * @see #isPhone()
		 */
		public static function isTablet(stage:Stage = null):Boolean
		{
			var portraitWidth:Number = screenInchesX(stage);
			var landscapeWidth:Number = screenInchesY(stage);
			if(portraitWidth > landscapeWidth)
			{
				//make sure the longer side is used for landscape comparison
				var temp:Number = landscapeWidth;
				landscapeWidth = portraitWidth;
				portraitWidth = temp;
			}
			return portraitWidth >= tabletScreenPortraitWidthMinimumInches &&
				landscapeWidth >= tabletScreenLandscapeWidthMinimumInches;
		}

		/**
		 * Determines if this device is probably a large phone (sometimes
		 * called a phablet), based on the physical width and height, in
		 * inches, calculated using the full-screen dimensions and the screen
		 * density.
		 *
		 * @see #largePhoneScreenLandscapeWidthMinimumInches
		 * @see #largePhoneScreenPortraitWidthMinimumInches
		 * @see #isPhone()
		 * @see #isTablet()
		 */
		public static function isLargePhone(stage:Stage = null):Boolean
		{
			var portraitWidth:Number = screenInchesX(stage);
			var landscapeWidth:Number = screenInchesY(stage);
			if(portraitWidth > landscapeWidth)
			{
				//make sure the longer side is used for landscape comparison
				var temp:Number = landscapeWidth;
				landscapeWidth = portraitWidth;
				portraitWidth = temp;
			}
			return portraitWidth >= largePhoneScreenPortraitWidthMinimumInches &&
				landscapeWidth >= largePhoneScreenLandscapeWidthMinimumInches &&
				!isTablet(stage);
		}

		/**
		 * Determines if this device is probably a phone, based on the physical
		 * width and height, in inches, calculated using the full-screen
		 * dimensions and the screen density.
		 *
		 * <p>Returns <code>true</code> if the device is smaller than the
		 * minimum dimensions of a tablet. Larger phones (sometimes called
		 * phablets) are classified as phones when calling
		 * <code>isPhone()</code>. If <code>isPhone()</code> returns
		 * <code>true</code>, use <code>isLargePhone()</code> to determine the
		 * size of the phone, if necessary.</p>
		 *
		 * @see #isTablet()
		 * @see #isLargePhone()
		 */
		public static function isPhone(stage:Stage = null):Boolean
		{
			return !isTablet(stage);
		}

		/**
		 * The physical width of the device, in inches. Calculated using the
		 * full-screen width and the screen density.
		 *
		 * @see #screenPixelWidth
		 * @see #dpi
		 */
		public static function screenInchesX(stage:Stage = null):Number
		{
			if(stage === null)
			{
				stage = Starling.current.nativeStage;
			}
			var screenWidth:Number = screenPixelWidth;
			if(screenWidth !== screenWidth) //isNaN
			{
				screenWidth = stage.fullScreenWidth;
			}
			return screenWidth / dpi;
		}

		/**
		 * The physical height of the device, in inches. Calculated using the
		 * full-screen height and the screen density.
		 *
		 * @see #screenPixelHeight
		 * @see #dpi
		 */
		public static function screenInchesY(stage:Stage = null):Number
		{
			if(stage === null)
			{
				stage = Starling.current.nativeStage;
			}
			var screenHeight:Number = screenPixelHeight;
			if(screenHeight !== screenHeight) //isNaN
			{
				screenHeight = stage.fullScreenHeight;
			}
			return screenHeight / dpi;
		}
	}
}


================================================
FILE: source/feathers/text/BitmapFontTextFormat.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.text
{
	import flash.text.TextFormatAlign;

	import starling.text.BitmapFont;
	import starling.text.TextField;

	/**
	 * Customizes a bitmap font for use by a <code>BitmapFontTextRenderer</code>.
	 *
	 * @see feathers.controls.text.BitmapFontTextRenderer
	 *
	 * @productversion Feathers 1.0.0
	 */
	public class BitmapFontTextFormat
	{
		/**
		 * Constructor.
		 */
		public function BitmapFontTextFormat(font:Object, size:Number = NaN, color:uint = 0xffffff, align:String = TextFormatAlign.LEFT, leading:Number = 0)
		{
			if(font is String)
			{
				font = TextField.getBitmapFont(font as String);
			}
			if(!(font is BitmapFont))
			{
				throw new ArgumentError("BitmapFontTextFormat font must be a BitmapFont instance or a String representing the name of a registered bitmap font.");
			}
			this.font = BitmapFont(font);
			this.size = size;
			this.color = color;
			this.align = align;
			this.leading = leading;
		}

		/**
		 * The name of the font.
		 */
		public function get fontName():String
		{
			return this.font ? this.font.name : null;
		}

		/**
		 * The BitmapFont instance to use.
		 */
		public var font:BitmapFont;

		/**
		 * The color used to tint the bitmap font's texture when rendered.
		 * Tinting works like the "multiply" blend mode. In other words, the
		 * <code>color</code> property can only make the text render with a
		 * darker color. With that in mind, if the characters in the original
		 * texture are black, then you cannot change their color at all. To be
		 * able to render the text using any color, the characters in the
		 * original texture should be white.
		 *
		 * @default 0xffffff
		 *
		 * @see http://doc.starling-framework.org/core/starling/display/BlendMode.html#MULTIPLY starling.display.BlendMode.MULTIPLY
		 */
		public var color:uint;

		/**
		 * The size at which to display the bitmap font. Set to <code>NaN</code>
		 * to use the default size in the BitmapFont instance.
		 *
		 * @default NaN
		 */
		public var size:Number;

		/**
		 * The number of extra pixels between characters. May be positive or
		 * negative.
		 *
		 * @default 0
		 */
		public var letterSpacing:Number = 0;

		[Inspectable(type="String",enumeration="left,center,right")]
		/**
		 * Determines the alignment of the text, either left, center, or right.
		 *
		 * @default flash.text.TextFormatAlign.LEFT
		 */
		public var align:String = TextFormatAlign.LEFT;

		/**
		 * A number representing the amount of vertical space (called leading)
		 * between lines. The total vertical distance between lines is this
		 * value added to the BitmapFont instance's lineHeight property.
		 *
		 * @default 0
		 */
		public var leading:Number;

		/**
		 * Determines if the kerning values defined in the BitmapFont instance
		 * will be used for layout.
		 *
		 * @default true
		 */
		public var isKerningEnabled:Boolean = true;
	}
}

================================================
FILE: source/feathers/text/FontStylesSet.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.text
{
	import feathers.core.IFeathersControl;
	import feathers.core.IStateContext;
	import feathers.core.IStateObserver;
	import feathers.core.IToggle;

	import starling.events.Event;
	import starling.events.EventDispatcher;
	import starling.text.TextFormat;

	/**
	 * Dispatched when a new <code>starling.text.TextFormat</code> is passed in
	 * or when one of the existing <code>TextFormat</code> objects is modified.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>null</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType starling.events.Event.CHANGE
	 */
	[Event(name="change",type="starling.events.Event")]

	/**
	 * Used internally by <code>ITextRenderer</code> implementations to pass
	 * around sets of <code>TextFormat</code> objects for a component's
	 * different states.
	 *
	 * <p>A custom component that uses one or more text renderers is expected to
	 * provide user-facing APIs to set its font styles using
	 * separate <code>TextFormat</code> instances. The combined set of these
	 * formats should be stored in a <code>FontStylesSet</code> that can be
	 * passed into the text renderer.</p>
	 *
	 * @see feathers.core.ITextRenderer
	 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
	 *
	 * @productversion Feathers 3.1.0
	 */
	public class FontStylesSet extends EventDispatcher
	{
		/**
		 * Constructor.
		 */
		public function FontStylesSet()
		{
			super();
		}

		/**
		 * @private
		 * Stores formats for specific state. The key is the state constant,
		 * and the value is a TextFormat.
		 */
		protected var _stateToFormat:Object = null;

		/**
		 * @private
		 */
		protected var _format:TextFormat;

		/**
		 * The default font format used to display the text.
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 */
		public function get format():TextFormat
		{
			return this._format;
		}

		/**
		 * @private
		 */
		public function set format(value:TextFormat):void
		{
			if(this._format === value)
			{
				return;
			}
			if(this._format !== null)
			{
				this._format.removeEventListener(Event.CHANGE, format_changeHandler);
			}
			this._format = value;
			if(this._format !== null)
			{
				this._format.addEventListener(Event.CHANGE, format_changeHandler);
			}
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _disabledFormat:TextFormat;

		/**
		 * The font styles used to display the text when the component is
		 * disabled. If <code>null</code>, the value of the <code>format</code>
		 * property will typically be used.
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 */
		public function get disabledFormat():TextFormat
		{
			return this._disabledFormat;
		}

		/**
		 * @private
		 */
		public function set disabledFormat(value:TextFormat):void
		{
			if(this._disabledFormat === value)
			{
				return;
			}
			if(this._disabledFormat !== null)
			{
				this._disabledFormat.removeEventListener(Event.CHANGE, format_changeHandler);
			}
			this._disabledFormat = value;
			if(this._disabledFormat !== null)
			{
				this._disabledFormat.addEventListener(Event.CHANGE, format_changeHandler);
			}
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * @private
		 */
		protected var _selectedFormat:TextFormat;

		/**
		 * The font styles used to display the text when the component is
		 * selected. If <code>null</code>, the value of the <code>format</code>
		 * property will typically be used.
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 */
		public function get selectedFormat():TextFormat
		{
			return this._selectedFormat;
		}

		/**
		 * @private
		 */
		public function set selectedFormat(value:TextFormat):void
		{
			if(this._selectedFormat === value)
			{
				return;
			}
			if(this._selectedFormat !== null)
			{
				this._selectedFormat.removeEventListener(Event.CHANGE, format_changeHandler);
			}
			this._selectedFormat = value;
			if(this._selectedFormat !== null)
			{
				this._selectedFormat.addEventListener(Event.CHANGE, format_changeHandler);
			}
			this.dispatchEventWith(Event.CHANGE);
		}

		/**
		 * Cleans up all TextFormat objects.
		 */
		public function dispose():void
		{
			this.format = null;
			this.disabledFormat = null;
			this.selectedFormat = null;
			for(var state:String in this._stateToFormat)
			{
				this.setFormatForState(state, null);
			}
		}

		/**
		 * Returns the <code>TextFormat</code> for a specific state, or
		 * <code>null</code> if the <code>TextFormat</code> has not been set
		 * for that state.
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 */
		public function getFormatForState(state:String):TextFormat
		{
			if(this._stateToFormat === null)
			{
				return null;
			}
			return TextFormat(this._stateToFormat[state]);
		}

		/**
		 * Sets the <code>TextFormat</code> for a specific state.
		 *
		 * <p>Pass in <code>null</code> to clear the format for the state.</p>
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 */
		public function setFormatForState(state:String, value:TextFormat):void
		{
			var oldFormat:TextFormat = null;
			if(value !== null)
			{
				if(this._stateToFormat === null)
				{
					this._stateToFormat = {};
				}
				else
				{
					oldFormat = TextFormat(this._stateToFormat[state]);
				}
				if(oldFormat !== null)
				{
					oldFormat.removeEventListener(Event.CHANGE, format_changeHandler);
				}
				this._stateToFormat[state] = value;
				value.addEventListener(Event.CHANGE, format_changeHandler);
			}
			else if(this._stateToFormat !== null)
			{
				oldFormat = TextFormat(this._stateToFormat[state]);
				if(oldFormat !== null)
				{
					oldFormat.removeEventListener(Event.CHANGE, format_changeHandler);
					delete this._stateToFormat[state];
				}
			}
		}

		/**
		 * Chooses the appropriate <code>TextFormat</code> to use based on the
		 * state of the text renderer passed in. If the text renderer has a
		 * <code>stateContext</code>, the state of the <code>stateContext</code>
		 * takes precedent.
		 *
		 * @see http://doc.starling-framework.org/current/starling/text/TextFormat.html starling.text.TextFormat
		 */
		public function getTextFormatForTarget(target:IFeathersControl):TextFormat
		{
			var textFormat:TextFormat;
			var stateContext:IStateContext;
			if(target is IStateObserver)
			{
				stateContext = IStateObserver(target).stateContext;
			}
			if(stateContext !== null)
			{
				//first, look for a format defined for a specific state
				if(this._stateToFormat !== null)
				{
					var currentState:String = stateContext.currentState;
					if(currentState in this._stateToFormat)
					{
						textFormat = TextFormat(this._stateToFormat[currentState]);
					}
				}
				//the disabled format is a convenience that can cover multiple
				//disabled states
				if(textFormat === null && this._disabledFormat !== null &&
					stateContext is IFeathersControl && !IFeathersControl(stateContext).isEnabled)
				{
					textFormat = this._disabledFormat;
				}
				//similar with the selected format that can cover multiple
				//selected states
				if(textFormat === null && this._selectedFormat !== null &&
					stateContext is IToggle && IToggle(stateContext).isSelected)
				{
					textFormat = this._selectedFormat;
				}
			}
			else //no state context, so only text renderer can be used
			{
				if(this._disabledFormat !== null && !target.isEnabled)
				{
					textFormat = this._disabledFormat;
				}
			}
			if(textFormat === null)
			{
				//finally, fall back to the default format, if needed
				//(it may still be null, though)
				textFormat = this._format;
			}
			return textFormat;
		}

		/**
		 * @private
		 */
		protected function format_changeHandler(event:Event):void
		{
			this.dispatchEventWith(Event.CHANGE);
		}
	}
}


================================================
FILE: source/feathers/text/StageTextField.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.text
{
	import flash.display.BitmapData;
	import flash.display.Stage;
	import flash.events.Event;
	import flash.events.EventDispatcher;
	import flash.events.FocusEvent;
	import flash.events.KeyboardEvent;
	import flash.geom.Rectangle;
	import flash.text.TextField;
	import flash.text.TextFieldType;
	import flash.text.TextFormat;
	import flash.text.TextFormatAlign;
	import flash.text.engine.FontPosture;
	import flash.text.engine.FontWeight;

	/**
	 * A StageText replacement for Flash Player with matching properties, since
	 * StageText is only available in AIR.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public final class StageTextField extends EventDispatcher
	{
		/**
		 * Constructor.
		 */
		public function StageTextField(initOptions:Object = null)
		{
			this.initialize(initOptions);
		}

		private var _textField:TextField;
		private var _textFormat:TextFormat;
		private var _isComplete:Boolean = false;

		private var _autoCapitalize:String = "none";

		public function get autoCapitalize():String
		{
			return this._autoCapitalize;
		}

		public function set autoCapitalize(value:String):void
		{
			this._autoCapitalize = value;
		}

		private var _autoCorrect:Boolean = false;

		public function get autoCorrect():Boolean
		{
			return this._autoCorrect;
		}

		public function set autoCorrect(value:Boolean):void
		{
			this._autoCorrect = value;
		}

		private var _color:uint = 0x000000;

		public function get color():uint
		{
			return this._textFormat.color as uint;
		}

		public function set color(value:uint):void
		{
			if(this._textFormat.color == value)
			{
				return;
			}
			this._textFormat.color = value;
			this._textField.defaultTextFormat = this._textFormat;
			this._textField.setTextFormat(this._textFormat);
		}

		public function get displayAsPassword():Boolean
		{
			return this._textField.displayAsPassword;
		}

		public function set displayAsPassword(value:Boolean):void
		{
			this._textField.displayAsPassword = value;
		}

		public function get editable():Boolean
		{
			return this._textField.type == TextFieldType.INPUT;
		}

		public function set editable(value:Boolean):void
		{
			this._textField.type = value ? TextFieldType.INPUT : TextFieldType.DYNAMIC;
		}

		private var _fontFamily:String = null;

		public function get fontFamily():String
		{
			return this._textFormat.font;
		}

		public function set fontFamily(value:String):void
		{
			if(this._textFormat.font == value)
			{
				return;
			}
			this._textFormat.font = value;
			this._textField.defaultTextFormat = this._textFormat;
			this._textField.setTextFormat(this._textFormat);
		}

		public function get fontPosture():String
		{
			return this._textFormat.italic ? FontPosture.ITALIC : FontPosture.NORMAL;
		}

		public function set fontPosture(value:String):void
		{
			if(this.fontPosture == value)
			{
				return;
			}
			this._textFormat.italic = value == FontPosture.ITALIC;
			this._textField.defaultTextFormat = this._textFormat;
			this._textField.setTextFormat(this._textFormat);
		}

		public function get fontSize():int
		{
			return this._textFormat.size as int;
		}

		public function set fontSize(value:int):void
		{
			if(this._textFormat.size == value)
			{
				return;
			}
			this._textFormat.size = value;
			this._textField.defaultTextFormat = this._textFormat;
			this._textField.setTextFormat(this._textFormat);
		}

		public function get fontWeight():String
		{
			return this._textFormat.bold ? FontWeight.BOLD : FontWeight.NORMAL;
		}

		public function set fontWeight(value:String):void
		{
			if(this.fontWeight == value)
			{
				return;
			}
			this._textFormat.bold = value == FontWeight.BOLD;
			this._textField.defaultTextFormat = this._textFormat;
			this._textField.setTextFormat(this._textFormat);
		}

		private var _locale:String = "en";

		public function get locale():String
		{
			return this._locale;
		}

		public function set locale(value:String):void
		{
			this._locale = value;
		}

		public function get maxChars():int
		{
			return this._textField.maxChars;
		}

		public function set maxChars(value:int):void
		{
			this._textField.maxChars = value;
		}

		public function get multiline():Boolean
		{
			return this._textField.multiline;
		}

		public function get restrict():String
		{
			return this._textField.restrict;
		}

		public function set restrict(value:String):void
		{
			this._textField.restrict = value;
		}

		private var _returnKeyLabel:String = "default";

		public function get returnKeyLabel():String
		{
			return this._returnKeyLabel;
		}

		public function set returnKeyLabel(value:String):void
		{
			this._returnKeyLabel = value;
		}

		public function get selectionActiveIndex():int
		{
			return this._textField.selectionBeginIndex;
		}

		public function get selectionAnchorIndex():int
		{
			return this._textField.selectionEndIndex;
		}

		private var _softKeyboardType:String = "default";

		public function get softKeyboardType():String
		{
			return this._softKeyboardType;
		}

		public function set softKeyboardType(value:String):void
		{
			this._softKeyboardType = value;
		}

		public function get stage():Stage
		{
			return this._textField.stage;
		}

		public function set stage(value:Stage):void
		{
			if(this._textField.stage == value)
			{
				return;
			}
			if(this._textField.stage)
			{
				this._textField.parent.removeChild(this._textField);
			}
			if(value)
			{
				value.addChild(this._textField);
				this.dispatchCompleteIfPossible();
			}
		}

		public function get text():String
		{
			return this._textField.text;
		}

		public function set text(value:String):void
		{
			this._textField.text = value;
		}

		private var _textAlign:String = TextFormatAlign.START;

		public function get textAlign():String
		{
			return this._textAlign;
		}

		public function set textAlign(value:String):void
		{
			if(this._textAlign == value)
			{
				return;
			}
			this._textAlign = value;
			if(value == TextFormatAlign.START)
			{
				value = TextFormatAlign.LEFT;
			}
			else if(value == TextFormatAlign.END)
			{
				value = TextFormatAlign.RIGHT;
			}
			this._textFormat.align = value;
			this._textField.defaultTextFormat = this._textFormat;
			this._textField.setTextFormat(this._textFormat);
		}

		private var _viewPort:Rectangle = new Rectangle();

		public function get viewPort():Rectangle
		{
			return this._viewPort;
		}

		public function set viewPort(value:Rectangle):void
		{
			if(!value || value.width < 0 || value.height < 0)
			{
				throw new RangeError("The Rectangle value is not valid.");
			}
			this._viewPort = value;
			this._textField.x = this._viewPort.x;
			this._textField.y = this._viewPort.y;
			this._textField.width = this._viewPort.width;
			this._textField.height = this._viewPort.height;

			this.dispatchCompleteIfPossible();
		}

		public function get visible():Boolean
		{
			return this._textField.visible;
		}

		public function set visible(value:Boolean):void
		{
			this._textField.visible = value;
		}

		public function assignFocus():void
		{
			if(!this._textField.parent)
			{
				return;
			}
			this._textField.stage.focus = this._textField;
		}

		public function dispose():void
		{
			this.stage = null;
			this._textField = null;
			this._textFormat = null;
		}

		public function drawViewPortToBitmapData(bitmap:BitmapData):void
		{
			if(!bitmap)
			{
				throw new Error("The bitmap is null.");
			}
			if(bitmap.width != this._viewPort.width || bitmap.height != this._viewPort.height)
			{
				throw new ArgumentError("The bitmap's width or height is different from view port's width or height.");
			}
			bitmap.draw(this._textField);
		}

		public function selectRange(anchorIndex:int, activeIndex:int):void
		{
			this._textField.setSelection(anchorIndex, activeIndex);
		}

		private function dispatchCompleteIfPossible():void
		{
			if(!this._textField.stage || this._viewPort.isEmpty())
			{
				this._isComplete = false;
			}
			if(this._textField.stage && !this._viewPort.isEmpty())
			{
				this._isComplete = true;
				this.dispatchEvent(new Event(Event.COMPLETE));
			}
		}

		private function initialize(initOptions:Object):void
		{
			this._textField = new TextField();
			this._textField.type = TextFieldType.INPUT;
			var isMultiline:Boolean = initOptions && initOptions.hasOwnProperty("multiline") && initOptions.multiline;
			this._textField.multiline = isMultiline;
			this._textField.wordWrap = isMultiline;
			this._textField.addEventListener(Event.CHANGE, textField_eventHandler);
			this._textField.addEventListener(FocusEvent.FOCUS_IN, textField_eventHandler);
			this._textField.addEventListener(FocusEvent.FOCUS_OUT, textField_eventHandler);
			this._textField.addEventListener(KeyboardEvent.KEY_DOWN, textField_eventHandler);
			this._textField.addEventListener(KeyboardEvent.KEY_UP, textField_eventHandler);
			this._textField.addEventListener(FocusEvent.KEY_FOCUS_CHANGE, textField_keyFocusChangeHandler);
			this._textFormat = new TextFormat(null, 11, 0x000000, false, false, false);
			this._textField.defaultTextFormat = this._textFormat;
		}

		private function textField_eventHandler(event:Event):void
		{
			this.dispatchEvent(event);
		}

		private function textField_keyFocusChangeHandler(event:FocusEvent):void
		{
			//StageText doesn't dispatch this event, so we shouldn't either
			event.preventDefault();
			event.stopImmediatePropagation();
			event.stopPropagation();
		}
	}
}


================================================
FILE: source/feathers/themes/IAsyncTheme.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.themes
{
	import feathers.core.IFeathersEventDispatcher;

	import starling.core.Starling;

	/**
	 * Dispatched when the theme's assets are loaded, and the theme has
	 * initialized. Feathers component cannot be skinned automatically by the
	 * theme until this event is dispatched.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The <code>Starling</code> instance that
	 *   is associated with the assets that have finished loading.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @see #isCompleteForStarling()
	 *
	 * @eventType starling.events.Event.COMPLETE
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * A theme that uses an asynchronous loading mechanism (such as the Starling
	 * <code>AssetManager</code>), during initialization to load textures and
	 * other assets. This type of theme may not be ready to style components
	 * immediately, and it will dispatch <code>Event.COMPLETE</code> once the
	 * it has fully initialized. Attempting to create Feathers components before
	 * the theme has dispatched <code>Event.COMPLETE</code> may result in no
	 * skins or even runtime errors.
	 *
	 * @productversion Feathers 2.3.0
	 */
	public interface IAsyncTheme extends IFeathersEventDispatcher
	{
		/**
		 * Indicates if the assets have been loaded and the theme has been
		 * initialized for a specific Starling instance.
		 *
		 * @see #event:complete starling.events.Event.COMPLETE
		 */
		function isCompleteForStarling(starling:Starling):Boolean;
	}
}


================================================
FILE: source/feathers/themes/StyleNameFunctionTheme.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.themes
{
	import feathers.core.IFeathersControl;
	import feathers.skins.ConditionalStyleProvider;
	import feathers.skins.IStyleProvider;
	import feathers.skins.StyleNameFunctionStyleProvider;
	import feathers.skins.StyleProviderRegistry;

	import starling.core.Starling;
	import starling.events.EventDispatcher;

	/**
	 * Base class for themes that pass a <code>StyleNameFunctionStyleProvider</code>
	 * to each component class.
	 *
	 * @see feathers.skins.StyleNameFunctionStyleProvider
	 * @see ../../../help/skinning.html Skinning Feathers components
	 * @see ../../../help/custom-themes.html Creating custom Feathers themes
	 *
	 * @productversion Feathers 2.0.0
	 */
	public class StyleNameFunctionTheme extends EventDispatcher
	{
		/**
		 * @private
		 */
		protected static const GLOBAL_STYLE_PROVIDER_PROPERTY_NAME:String = "globalStyleProvider";

		/**
		 * Constructor.
		 */
		public function StyleNameFunctionTheme()
		{
			if(this.starling === null)
			{
				this.starling = Starling.current;
			}
			this.createRegistry();
			this._conditionalRegistry = new StyleProviderRegistry(true, createConditionalStyleProvider);
		}

		/**
		 * The Starling instance associated with this theme.
		 */
		protected var starling:Starling;

		/**
		 * @private
		 */
		protected var _registry:StyleProviderRegistry;

		/**
		 * @private
		 */
		protected var _conditionalRegistry:StyleProviderRegistry;

		/**
		 * Disposes the theme.
		 */
		public function dispose():void
		{
			if(this._registry !== null)
			{
				this._registry.dispose();
				this._registry = null;
			}
			if(this._conditionalRegistry !== null)
			{
				this.disposeConditionalRegistry();
			}
		}

		/**
		 * Returns a <code>StyleNameFunctionStyleProvider</code> to be passed to
		 * the specified class.
		 */
		public function getStyleProviderForClass(type:Class):StyleNameFunctionStyleProvider
		{
			var existingGlobalStyleProvider:IStyleProvider = IStyleProvider(type[GLOBAL_STYLE_PROVIDER_PROPERTY_NAME]);
			var conditional:ConditionalStyleProvider = ConditionalStyleProvider(this._conditionalRegistry.getStyleProvider(type));
			if(conditional.trueStyleProvider === null)
			{
				var styleProvider:StyleNameFunctionStyleProvider = StyleNameFunctionStyleProvider(this._registry.getStyleProvider(type));
				conditional.trueStyleProvider = styleProvider;
				conditional.falseStyleProvider = existingGlobalStyleProvider;
			}
			return StyleNameFunctionStyleProvider(conditional.trueStyleProvider);
		}

		/**
		 * @private
		 */
		protected function createRegistry():void
		{
			this._registry = new StyleProviderRegistry(false);
		}

		/**
		 * @private
		 */
		protected function starlingConditional(target:IFeathersControl):Boolean
		{
			var starling:Starling = target.stage !== null ? target.stage.starling : Starling.current;
			return starling === this.starling;
		}

		/**
		 * @private
		 */
		protected function createConditionalStyleProvider():ConditionalStyleProvider
		{
			return new ConditionalStyleProvider(starlingConditional);
		}

		/**
		 * @private
		 */
		protected function disposeConditionalRegistry():void
		{
			var classes:Vector.<Class> = this._conditionalRegistry.getRegisteredClasses();
			var classCount:int = classes.length;
			for(var i:int = 0; i < classCount; i++)
			{
				var forClass:Class = classes[i];
				var globalStyleProvider:IStyleProvider = IStyleProvider(forClass[GLOBAL_STYLE_PROVIDER_PROPERTY_NAME]);
				var styleProviderInRegistry:ConditionalStyleProvider = ConditionalStyleProvider(this._conditionalRegistry.clearStyleProvider(forClass));

				var currentStyleProvider:ConditionalStyleProvider = globalStyleProvider as ConditionalStyleProvider;
				var previousStyleProvider:ConditionalStyleProvider = null;
				do
				{
					if(currentStyleProvider === null)
					{
						//worse case scenario is that we don't know how to
						//remove this style provider from the chain, so we leave
						//it in but always pass to the falseStyleProvider.
						styleProviderInRegistry.conditionalFunction = null;
						styleProviderInRegistry.trueStyleProvider = null;
						break;
					}
					var nextStyleProvider:IStyleProvider = currentStyleProvider.falseStyleProvider;
					if(currentStyleProvider === styleProviderInRegistry)
					{
						if(previousStyleProvider !== null)
						{
							previousStyleProvider.falseStyleProvider = nextStyleProvider;
						}
						else //currentStyleProvider === globalStyleProvider
						{
							forClass[GLOBAL_STYLE_PROVIDER_PROPERTY_NAME] = nextStyleProvider;
						}
						break;
					}
					previousStyleProvider = currentStyleProvider;
					currentStyleProvider = nextStyleProvider as ConditionalStyleProvider;
				}
				while(true);
			}
			this._conditionalRegistry = null;
		}
	}
}

================================================
FILE: source/feathers/utils/ScreenDensityScaleFactorManager.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils
{
	import feathers.system.DeviceCapabilities;
	import feathers.utils.display.ScreenDensityScaleCalculator;
	import feathers.utils.math.roundDownToNearest;

	import flash.display.Stage;
	import flash.events.Event;
	import flash.geom.Rectangle;
	import flash.system.Capabilities;

	import starling.core.Starling;
	import starling.utils.SystemUtil;

	/**
	 * Automatically manages the Starling view port and stage dimensions to
	 * create an appropriate <code>contentScaleFactor</code> value for the
	 * current mobile device while filling the whole screen without letterboxing
	 * (no black bars!). Additionally, if the mobile device changes orientation,
	 * or if the desktop native window resizes,
	 * <code>ScreenDensityScaleFactorManager</code> will automatically resize
	 * Starling based on the new dimensions.
	 *
	 * <p>When using <code>ScreenDensityScaleFactorManager</code>, the Starling
	 * stage dimensions will not be exactly the same on all devices. When
	 * comparing two different phones, the stage dimensions will be similar, but
	 * may not be perfectly equal. For example, the stage dimensions on an
	 * Apple iPhone 5 in portrait orientation will be 320x568, but the stage
	 * dimensions on a Google Nexus 5 will be 360x640. With this in mind, be
	 * sure to use "fluid" layouts to account for the differences.</p>
	 *
	 * <p>It's also important to understand that tablets will have much larger
	 * Starling stage dimensions than phones.
	 * <code>ScreenDensityScaleFactorManager</code> is designed to behave more
	 * like native apps where tablets often display extra navigation or data
	 * that wouldn't be able to fit on a smaller phone screen. For example, on
	 * an Apple iPad, the stage dimensions will be 768x1024. This is much larger
	 * than the two phones we compared previously.</p>
	 *
	 * <p>The following example demonstrates how to instantiate
	 * <code>ScreenDensityScaleFactorManager</code>:</p>
	 *
	 * <listing version="3.0">
	 * this._starling = new Starling( RootClass, this.stage, null, null, Context3DRenderMode.AUTO, Context3DProfile.BASELINE );
	 * this._scaler = new ScreenDensityScaleFactorManager(this._starling);</listing>
	 *
	 * <strong>How <code>contentScaleFactor</code> is calculated</strong>
	 *
	 * <p>The device's screen density (sometimes referred to as DPI or PPI) is
	 * used to calculate an appropriate <code>contentScaleFactor</code> value.
	 * The calculation is inspired by native apps on Google's Android operating
	 * system where "density-independent pixels" are used for layout. You might
	 * consider this an advanced form of the techniques described in
	 * <a href="http://wiki.starling-framework.org/manual/multi-resolution_development">Starling Multi-Resolution Development</a>.</p>
	 *
	 * <p>The following chart shows how different screen densities map to
	 * different <code>contentScaleFactor</code> values on both iOS and Android:</p>
	 *
	 * <table class="innertable">
	 * <tr><th>Android</th><th>iOS</th><th>Density</th><th>Scale Factor</th></tr>
	 * <tr><td>ldpi</td><td></td><td>120</td><td>0.75</td></tr>
	 * <tr><td>mdpi</td><td>non-Retina (&#64;1x)</td><td>160</td><td>1</td></tr>
	 * <tr><td>hdpi</td><td></td><td>240</td><td>1.5</td></tr>
	 * <tr><td>xhdpi</td><td>Retina (&#64;2x)</td><td>320</td><td>2</td></tr>
	 * <tr><td>xxhdpi</td><td>Retina HD (&#64;3x)</td><td>480</td><td>3</td></tr>
	 * <tr><td>xxxhdpi</td><td></td><td>640</td><td>4</td></tr>
	 * </table>
	 *
	 * <p>The density values in the table above are approximate. The screen
	 * density of an iPhone 5 is 326, so it uses the scale factor from the
	 * "xhdpi" bucket because 326 is closer to 320 than it is to 480.</p>
	 *
	 * <p>Note: Special behavior has been implemented for iPads to give them
	 * scale factors of <code>1</code> and <code>2</code>, just like native
	 * apps. Using Android's rules for DPI buckets, non-Retina iPads would have
	 * been "ldpi" devices (scale factor <code>0.75</code>) and Retina iPads
	 * would have been "hdpi" devices (scale factor <code>1.5</code>). However,
	 * because it makes more sense for Starling to use the same scale factor as
	 * native apps on iPad, this class makes a special exception just for
	 * them.</p>
	 *
	 * <strong>Loading Assets</strong>
	 *
	 * <p>After creating <code>ScreenDensityScaleFactorManager</code>, you can
	 * use Starling's <code>contentScaleFactor</code> property to determine
	 * which set of assets to load:</p>
	 *
	 * <listing version="3.0">
	 * if( Starling.current.contentScaleFactor > 1 )
	 * {
	 *     assetManager.scaleFactor = 2;
	 *     var assets2x:File = File.applicationDirectory.resolvePath( "assets/2x" );
	 *     assetManager.enqueue( assets2x );
	 * }
	 * else
	 * {
	 *     assetManager.scaleFactor = 1;
	 *     var assets1x:File = File.applicationDirectory.resolvePath( "assets/1x" );
	 *     assetManager.enqueue( assets1x );
	 * }</listing>
	 *
	 * <p>Providing assets for every scale factor is optional because Starling
	 * will automatically resize any textures that have been given a different
	 * <code>scale</code> than the current <code>contentScaleFactor</code> when
	 * they are rendered to the screen.</p>
	 *
	 * <p>For example, since "ldpi" devices with a low screen density typically
	 * aren't manufactured anymore, it might not be worth spending time
	 * designing a set of assets specifically for scale factor 0.75. Instead,
	 * you can probably load the higher quality "mdpi" textures when a legacy
	 * device is encountered where <code>ScreenDensityScaleFactorManager</code>
	 * chooses a <code>contentScaleFactor</code> of 0.75. As long as the "mdpi"
	 * textures are given a scale of 1 when they are created, Starling will know
	 * how to automatically resize them on a device where the calculated
	 * <code>contentScaleFactor</code> is lower than 1. Larger textures will
	 * be automatically scaled down, and the app will look the same as it would
	 * if you were using lower resolution textures. Your app will end up using a
	 * bit more memory at runtime than strictly necessary on these devices, but
	 * you won't need to include as many image files with your app, so its
	 * download size will be smaller.</p>
	 *
	 * <p>Similarly, lower resolution textures can be scaled up on devices with
	 * a higher <code>contentScaleFactor</code>. It is said that the human eye
	 * starts to have difficulty perceiving every individual pixel when a
	 * device's screen density is higher than 300 DPI. Depending on your app's
	 * requirements, assets for scale factor 4 (and often, also scale factor 3)
	 * may not be strictly necessary. You can often load assets for scale factor
	 * 2 on these higher-density devices because the difference is so difficult
	 * to see with the naked eye.</p>
	 *
	 * @see http://wiki.starling-framework.org/manual/multi-resolution_development Starling Multi-Resolution Development
	 *
	 * @productversion Feathers 2.2.0
	 */
	public class ScreenDensityScaleFactorManager
	{
		/**
		 * @private
		 */
		protected static const IOS_TABLET_DENSITY_SCALE_FACTOR:Number = 1.23484848484848;

		/**
		 * Constructor.
		 */
		public function ScreenDensityScaleFactorManager(starling:Starling)
		{
			this._scaleSelector = new ScreenDensityScaleCalculator();
			this._scaleSelector.addScaleForDensity(120, 0.75);	//ldpi
			this._scaleSelector.addScaleForDensity(160, 1);		//mdpi
			this._scaleSelector.addScaleForDensity(240, 1.5);	//hdpi
			this._scaleSelector.addScaleForDensity(320, 2);		//xhdpi
			this._scaleSelector.addScaleForDensity(480, 3);		//xxhdpi
			this._scaleSelector.addScaleForDensity(640, 4);		//xxxhpi

			var nativeStage:Stage = starling.nativeStage;
			this._starling = starling;
			this._calculatedScaleFactor = this.calculateScaleFactor();
			this.updateStarlingStageDimensions();
			//this needs top priority because we don't want Starling's listener
			//to get this event first use have bad dimensions.
			nativeStage.addEventListener(Event.RESIZE, nativeStage_resizeHandler, false, int.MAX_VALUE, true);
		}

		/**
		 * @private
		 */
		protected var _starling:Starling;

		/**
		 * @private
		 */
		protected var _calculatedScaleFactor:Number;

		/**
		 * @private
		 */
		protected var _scaleSelector:ScreenDensityScaleCalculator;

		/**
		 * @private
		 */
		protected function calculateScaleFactor():Number
		{
			//if DeviceCapabilities.dpi has been customized, we assume that a
			//mobile device is being simulated. since Animate CC doesn't let you
			//customize Capabilities.screenDPI, and SystemUtil.isDesktop
			//incorrectly returns true when testing in Animate CC, this is a
			//hacky way to make it work for those who prefer to use Animate CC.
			if(SystemUtil.isDesktop && DeviceCapabilities.dpi == Capabilities.screenDPI)
			{
				//Starling will handle nativeStage.contentsScaleFactor
				return 1;
			}
			var nativeStage:Stage = this._starling.nativeStage;
			var screenDensity:Number = DeviceCapabilities.dpi;
			if(Capabilities.os.indexOf("tvOS") != -1)
			{
				//tvOS devices report a lower DPI than Android TV devices
				//for the same resolution
				screenDensity *= 2;
			}
			else if(Capabilities.version.indexOf("IOS") != -1 &&
				DeviceCapabilities.isTablet(nativeStage))
			{
				//workaround because these rules derived from Android's behavior
				//would "incorrectly" give iPads a lower scale factor than iPhones
				//when both devices have the same scale factor natively.
				screenDensity *= IOS_TABLET_DENSITY_SCALE_FACTOR;
			}
			return this._scaleSelector.getScale(screenDensity);
		}

		/**
		 * @private
		 */
		protected function updateStarlingStageDimensions():void
		{
			var nativeStage:Stage = this._starling.nativeStage;
			var needsToBeDivisibleByTwo:Boolean = int(this._calculatedScaleFactor) != this._calculatedScaleFactor;
			var starlingStageWidth:Number = int(nativeStage.stageWidth / this._calculatedScaleFactor);
			if(needsToBeDivisibleByTwo)
			{
				starlingStageWidth = roundDownToNearest(starlingStageWidth, 2);
			}
			this._starling.stage.stageWidth = starlingStageWidth;
			var starlingStageHeight:Number = int(nativeStage.stageHeight / this._calculatedScaleFactor);
			if(needsToBeDivisibleByTwo)
			{
				starlingStageHeight = roundDownToNearest(starlingStageHeight, 2);
			}
			this._starling.stage.stageHeight = starlingStageHeight;

			var viewPort:Rectangle = this._starling.viewPort;
			viewPort.width = starlingStageWidth * this._calculatedScaleFactor;
			viewPort.height = starlingStageHeight * this._calculatedScaleFactor;
			try
			{
				this._starling.viewPort = viewPort;
			}
			catch(error:Error) {}
		}

		/**
		 * @private
		 */
		protected function nativeStage_resizeHandler(event:Event):void
		{
			this.updateStarlingStageDimensions();
		}
	}
}

================================================
FILE: source/feathers/utils/display/ScreenDensityScaleCalculator.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.display
{
	import flash.errors.IllegalOperationError;

	/**
	 * Selects a value for <code>contentScaleFactor</code> based on the screen
	 * density (sometimes called DPI or PPI).
	 *
	 * @productversion Feathers 3.1.0
	 */
	public class ScreenDensityScaleCalculator
	{
		/**
		 * Constructor.
		 */
		public function ScreenDensityScaleCalculator()
		{
		}

		/**
		 * @private
		 */
		protected var _buckets:Vector.<ScreenDensityBucket> = new <ScreenDensityBucket>[];

		/**
		 * Adds a new scale for the specified density.
		 *
		 * <listing version="3.0">
		 * selector.addScaleForDensity( 160, 1 );
		 * selector.addScaleForDensity( 240, 1.5 );
		 * selector.addScaleForDensity( 320, 2 );
		 * selector.addScaleForDensity( 480, 3 );</listing>
		 */
		public function addScaleForDensity(density:int, scale:Number):void
		{
			var bucketCount:int = this._buckets.length;
			for(var i:int = 0; i < bucketCount; i++)
			{
				var bucket:ScreenDensityBucket = this._buckets[i];
				if(bucket.density > density)
				{
					break;
				}
				if(bucket.density == density)
				{
					throw new ArgumentError("Screen density cannot be added more than once: " + density);
				}
			}
			this._buckets.insertAt(i, new ScreenDensityBucket(density, scale));
		}

		/**
		 * Removes a scale that was added with
		 * <code>addScaleForDensity()</code>.
		 *
		 * <listing version="3.0">
		 * selector.addScaleForDensity( 320, 2 );
		 * selector.removeScaleForDensity( 320 );</listing>
		 */
		public function removeScaleForDensity(density:int):void
		{
			var bucketCount:int = this._buckets.length;
			for(var i:int = 0; i < bucketCount; i++)
			{
				var bucket:ScreenDensityBucket = this._buckets[i];
				if(bucket.density == density)
				{
					this._buckets.removeAt(i);
					return;
				}
			}
		}

		/**
		 * Returns the ideal <code>contentScaleFactor</code> value for the
		 * specified density.
		 */
		public function getScale(density:int):Number
		{
			if(this._buckets.length == 0)
			{
				throw new IllegalOperationError("Cannot choose scale because none have been added");
			}
			var bucket:ScreenDensityBucket = this._buckets[0];
			if(density <= bucket.density)
			{
				return bucket.scale;
			}
			var previousBucket:ScreenDensityBucket = bucket;
			var bucketCount:int = this._buckets.length;
			for(var i:int = 1; i < bucketCount; i++)
			{
				bucket = this._buckets[i];
				if(density > bucket.density)
				{
					previousBucket = bucket;
					continue;
				}
				var midDPI:Number = (bucket.density + previousBucket.density) / 2;
				if(density < midDPI)
				{
					return previousBucket.scale;
				}
				return bucket.scale;
			}
			return bucket.scale;
		}
	}
}

class ScreenDensityBucket
{
	public function ScreenDensityBucket(dpi:Number, scale:Number)
	{
		this.density = dpi;
		this.scale = scale;
	}

	public var density:Number;
	public var scale:Number;
}

================================================
FILE: source/feathers/utils/display/calculateScaleRatioToFill.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.display
{
	/**
	 * Calculates a scale value to maintain aspect ratio and fill the required
	 * bounds (with the possibility of cutting of the edges a bit).
	 *
	 * @productversion Feathers 1.0.0
	 */
	public function calculateScaleRatioToFill(originalWidth:Number, originalHeight:Number, targetWidth:Number, targetHeight:Number):Number
	{
		var widthRatio:Number = targetWidth / originalWidth;
		var heightRatio:Number = targetHeight / originalHeight;
		if(widthRatio > heightRatio)
		{
			return widthRatio;
		}
		return heightRatio;
	}
}

================================================
FILE: source/feathers/utils/display/calculateScaleRatioToFit.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.display
{
	/**
	 * Calculates a scale value to maintain aspect ratio and fit inside the
	 * required bounds (with the possibility of a bit of empty space on the
	 * edges).
	 *
	 * @productversion Feathers 1.0.0
	 */
	public function calculateScaleRatioToFit(originalWidth:Number, originalHeight:Number, targetWidth:Number, targetHeight:Number):Number
	{
		var widthRatio:Number = targetWidth / originalWidth;
		var heightRatio:Number = targetHeight / originalHeight;
		if(widthRatio < heightRatio)
		{
			return widthRatio;
		}
		return heightRatio;
	}
}

================================================
FILE: source/feathers/utils/display/getDisplayObjectDepthFromStage.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.display
{
	import starling.display.DisplayObject;

	/**
	 * Calculates how many levels deep the target object is on the display list,
	 * starting from the Starling stage. If the target object is the stage, the
	 * depth will be <code>0</code>. A direct child of the stage will have a
	 * depth of <code>1</code>, and it increases with each new level. If the
	 * object does not have a reference to the stage, the depth will always be
	 * <code>-1</code>, even if the object has a parent.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public function getDisplayObjectDepthFromStage(target:DisplayObject):int
	{
		if(!target.stage)
		{
			return -1;
		}
		var count:int = 0;
		while(target.parent !== null)
		{
			target = target.parent;
			count++;
		}
		return count;
	}
}


================================================
FILE: source/feathers/utils/display/nativeToGlobal.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.display
{
	import flash.geom.Point;
	import flash.geom.Rectangle;

	import starling.core.Starling;

	/**
	 * Converts from native coordinates to Starling global coordinates.
	 *
	 * @productversion Feathers 3.5.0
	 */
	public function nativeToGlobal(nativePosition:Point, starling:Starling = null, result:Point = null):Point
	{
		if(starling === null)
		{
			starling = Starling.current;
		}

		var nativeScaleFactor:Number = 1;
		if(starling.supportHighResolutions)
		{
			nativeScaleFactor = starling.nativeStage.contentsScaleFactor;
		}
		var scaleFactor:Number = starling.contentScaleFactor / nativeScaleFactor;

		var viewPort:Rectangle = starling.viewPort;
		var resultX:Number = (nativePosition.x - viewPort.x) / scaleFactor;
		var resultY:Number = (nativePosition.y - viewPort.y) / scaleFactor;

		if(result === null)
		{
			result = new Point(resultX, resultY);
		}
		else
		{
			result.setTo(resultX, resultY);
		}
		return result;
	}
}


================================================
FILE: source/feathers/utils/display/stageToStarling.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.display
{
	import starling.core.Starling;
	import starling.display.Stage;

	/**
	 * Finds the Starling instance that controls a particular
	 * <code>starling.display.Stage</code>.
	 *
	 * @productversion Feathers 2.2.0
	 */
	public function stageToStarling(stage:Stage):Starling
	{
		for each(var starling:Starling in Starling.all)
		{
			if(starling.stage === stage)
			{
				return starling;
			}
		}
		return null;
	}
}


================================================
FILE: source/feathers/utils/focus/isBetterFocusForRelativePosition.as
================================================
/*
 * Copyright (C) 2007 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package feathers.utils.focus
{
	import feathers.core.IFocusDisplayObject;
	import feathers.layout.RelativePosition;

	import flash.geom.Rectangle;

	import starling.utils.Pool;

	/**
	 * Determines if <code>object1</code> is a better choice than
	 * <code>object2</code> when changing focus to the specified position
	 * relative to the current focus.
	 *
	 * <p>Note: it's acceptable pass in <code>null</code> for
	 * <code>object2</code> to check if an item is at the relative position to
	 * the focused rectangle.</p>
	 *
	 * @see feathers.layout.RelativePosition
	 */
	public function isBetterFocusForRelativePosition(object1:IFocusDisplayObject, object2:IFocusDisplayObject, focusedRect:Rectangle, relativePosition:String):Boolean
	{
		var rect:Rectangle = object1.getBounds(object1.stage, Pool.getRectangle());

		var minPrimaryDistance1:Number = calculateMinPrimaryAxisDistanceForRelativePosition(focusedRect, rect, relativePosition);
		if(minPrimaryDistance1 == Number.POSITIVE_INFINITY)
		{
			return false;
		}
		var maxPrimaryDistance1:Number = calculateMaxPrimaryAxisDistanceForRelativePosition(focusedRect, rect, relativePosition);
		var secondaryDistance1:Number = calculateSecondaryAxisDistanceForRelativePosition(focusedRect, rect, relativePosition);
		var onSameAxis1:Boolean = itemsAreOnSameAxis(focusedRect, rect, relativePosition);

		if(object2 === null)
		{
			var minPrimaryDistance2:Number = Number.POSITIVE_INFINITY;
			var maxPrimaryDistance2:Number = Number.POSITIVE_INFINITY;
			var secondaryDistance2:Number = Number.POSITIVE_INFINITY;
			var onSameAxis2:Boolean = false;
		}
		else
		{
			object2.getBounds(object2.stage, rect);
			minPrimaryDistance2 = calculateMinPrimaryAxisDistanceForRelativePosition(focusedRect, rect, relativePosition);
			maxPrimaryDistance2 = calculateMaxPrimaryAxisDistanceForRelativePosition(focusedRect, rect, relativePosition);
			secondaryDistance2 = calculateSecondaryAxisDistanceForRelativePosition(focusedRect, rect, relativePosition);
			onSameAxis2 = itemsAreOnSameAxis(focusedRect, rect, relativePosition);
		}

		Pool.putRectangle(rect);

		if(onSameAxis1 && onSameAxis2)
		{
			//if they're both on the same axis as the current focus,
			//choose the closer object (using minimum distances)
			return minPrimaryDistance1 > 0 && minPrimaryDistance1 < minPrimaryDistance2;
		}
		var isVertical:Boolean = relativePosition === RelativePosition.TOP || relativePosition === RelativePosition.BOTTOM;
		if(onSameAxis1)
		{
			if(isVertical)
			{
				if(minPrimaryDistance1 > 0 && minPrimaryDistance1 < maxPrimaryDistance2)
				{
					//as long as the min distance of 1 is closer than the
					//max distance of 2, it is a better focus
					return true;
				}
				//however, we may prefer items that aren't on the same axis
				//to become focus, if they are close enough on the opposite
				//axis instead. only vertically, though.
			}
			else //horizontal
			{
				//since we read text horizontally before vertically, being
				//on the same axis horizontally always takes precedence.
				return true;
			}
		}
		else if(onSameAxis2)
		{
			//see comments in previous condition above for details
			if(isVertical)
			{
				if(minPrimaryDistance2 > 0 && minPrimaryDistance2 < maxPrimaryDistance1)
				{
					return false;
				}
			}
			else //horizontal
			{
				return false;
			}
		}
		//neither is on the same axis as the current focus
		//(or one may be on the same axis vertically, but isn't closer than the other)

		//this is how android makes a best guess
		var weightedDistance1:Number = 13 * minPrimaryDistance1 * minPrimaryDistance1 +
			secondaryDistance1 * secondaryDistance1;
		var weightedDistance2:Number = 13 * minPrimaryDistance2 * minPrimaryDistance2 +
			secondaryDistance2 * secondaryDistance2;
		return weightedDistance1 < weightedDistance2;
	}
}

import feathers.layout.RelativePosition;

import flash.geom.Rectangle;

function calculateSecondaryAxisDistanceForRelativePosition(globalRect1:Rectangle, globalRect2:Rectangle, position:String):Number
{
	if(position === RelativePosition.TOP || position === RelativePosition.BOTTOM)
	{
		return Math.abs((globalRect1.x + globalRect1.width / 2) - (globalRect2.x + globalRect2.width / 2));
	}
	//left or right
	return Math.abs((globalRect1.y + globalRect1.height / 2) - (globalRect2.y + globalRect2.height / 2));
}

function calculateMaxPrimaryAxisDistanceForRelativePosition(globalRect1:Rectangle, globalRect2:Rectangle, position:String):Number
{
	switch(position)
	{
		case RelativePosition.TOP:
		{
			if(globalRect1.bottom > globalRect2.bottom || globalRect1.y >= globalRect2.bottom)
			{
				var result:Number = globalRect1.bottom - globalRect2.y;
				if(result > 0)
				{
					return result;
				}
			}
			break;
		}
		case RelativePosition.RIGHT:
		{
			if(globalRect1.x < globalRect2.x || globalRect1.right <= globalRect2.x)
			{
				result = globalRect2.right - globalRect1.x;
				if(result > 0)
				{
					return result;
				}
			}
			break;
		}
		case RelativePosition.BOTTOM:
		{
			if(globalRect1.y < globalRect2.y || globalRect1.bottom <= globalRect2.y)
			{
				result = globalRect2.bottom - globalRect1.y;
				if(result > 0)
				{
					return result;
				}
			}
			break;
		}
		case RelativePosition.LEFT:
		{
			if(globalRect1.right > globalRect2.right || globalRect1.x >= globalRect2.right)
			{
				result = globalRect1.right - globalRect2.x;
				if(result > 0)
				{
					return result;
				}
			}
			break;
		}
	}
	return Number.POSITIVE_INFINITY;
}

function calculateMinPrimaryAxisDistanceForRelativePosition(globalRect1:Rectangle, globalRect2:Rectangle, position:String):Number
{
	switch(position)
	{
		case RelativePosition.TOP:
		{
			if(globalRect1.bottom > globalRect2.bottom || globalRect1.y >= globalRect2.bottom)
			{
				var result:Number = globalRect1.bottom - globalRect2.bottom;
				if(result > 0)
				{
					return result;
				}
			}
			break;
		}
		case RelativePosition.RIGHT:
		{
			if(globalRect1.x < globalRect2.x || globalRect1.right <= globalRect2.x)
			{
				result = globalRect2.x - globalRect1.x;
				if(result > 0)
				{
					return result;
				}
			}
			break;
		}
		case RelativePosition.BOTTOM:
		{
			if(globalRect1.y < globalRect2.y || globalRect1.bottom <= globalRect2.y)
			{
				result = globalRect2.y - globalRect1.y;
				if(result > 0)
				{
					return result;
				}
			}
			break;
		}
		case RelativePosition.LEFT:
		{
			if(globalRect1.right > globalRect2.right || globalRect1.x >= globalRect2.right)
			{
				result = globalRect1.right - globalRect2.right;
				if(result > 0)
				{
					return result;
				}
			}
			break;
		}
	}
	return Number.POSITIVE_INFINITY;
}

function itemsAreOnSameAxis(globalRect1:Rectangle, globalRect2:Rectangle, position:String):Boolean
{
	if(position === RelativePosition.TOP || position === RelativePosition.BOTTOM)
	{
		return globalRect1.x <= globalRect2.right && globalRect2.x <= globalRect1.right;
	}
	//left or right
	return globalRect1.y <= globalRect2.bottom && globalRect2.y <= globalRect1.bottom;
}

================================================
FILE: source/feathers/utils/focus/isBetterFocusForRelativePosition_LICENSE
================================================
                                 Apache License
                           Version 2.0, January 2004
                        http://www.apache.org/licenses/

   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION

   1. Definitions.

      "License" shall mean the terms and conditions for use, reproduction,
      and distribution as defined by Sections 1 through 9 of this document.

      "Licensor" shall mean the copyright owner or entity authorized by
      the copyright owner that is granting the License.

      "Legal Entity" shall mean the union of the acting entity and all
      other entities that control, are controlled by, or are under common
      control with that entity. For the purposes of this definition,
      "control" means (i) the power, direct or indirect, to cause the
      direction or management of such entity, whether by contract or
      otherwise, or (ii) ownership of fifty percent (50%) or more of the
      outstanding shares, or (iii) beneficial ownership of such entity.

      "You" (or "Your") shall mean an individual or Legal Entity
      exercising permissions granted by this License.

      "Source" form shall mean the preferred form for making modifications,
      including but not limited to software source code, documentation
      source, and configuration files.

      "Object" form shall mean any form resulting from mechanical
      transformation or translation of a Source form, including but
      not limited to compiled object code, generated documentation,
      and conversions to other media types.

      "Work" shall mean the work of authorship, whether in Source or
      Object form, made available under the License, as indicated by a
      copyright notice that is included in or attached to the work
      (an example is provided in the Appendix below).

      "Derivative Works" shall mean any work, whether in Source or Object
      form, that is based on (or derived from) the Work and for which the
      editorial revisions, annotations, elaborations, or other modifications
      represent, as a whole, an original work of authorship. For the purposes
      of this License, Derivative Works shall not include works that remain
      separable from, or merely link (or bind by name) to the interfaces of,
      the Work and Derivative Works thereof.

      "Contribution" shall mean any work of authorship, including
      the original version of the Work and any modifications or additions
      to that Work or Derivative Works thereof, that is intentionally
      submitted to Licensor for inclusion in the Work by the copyright owner
      or by an individual or Legal Entity authorized to submit on behalf of
      the copyright owner. For the purposes of this definition, "submitted"
      means any form of electronic, verbal, or written communication sent
      to the Licensor or its representatives, including but not limited to
      communication on electronic mailing lists, source code control systems,
      and issue tracking systems that are managed by, or on behalf of, the
      Licensor for the purpose of discussing and improving the Work, but
      excluding communication that is conspicuously marked or otherwise
      designated in writing by the copyright owner as "Not a Contribution."

      "Contributor" shall mean Licensor and any individual or Legal Entity
      on behalf of whom a Contribution has been received by Licensor and
      subsequently incorporated within the Work.

   2. Grant of Copyright License. Subject to the terms and conditions of
      this License, each Contributor hereby grants to You a perpetual,
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
      copyright license to reproduce, prepare Derivative Works of,
      publicly display, publicly perform, sublicense, and distribute the
      Work and such Derivative Works in Source or Object form.

   3. Grant of Patent License. Subject to the terms and conditions of
      this License, each Contributor hereby grants to You a perpetual,
      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
      (except as stated in this section) patent license to make, have made,
      use, offer to sell, sell, import, and otherwise transfer the Work,
      where such license applies only to those patent claims licensable
      by such Contributor that are necessarily infringed by their
      Contribution(s) alone or by combination of their Contribution(s)
      with the Work to which such Contribution(s) was submitted. If You
      institute patent litigation against any entity (including a
      cross-claim or counterclaim in a lawsuit) alleging that the Work
      or a Contribution incorporated within the Work constitutes direct
      or contributory patent infringement, then any patent licenses
      granted to You under this License for that Work shall terminate
      as of the date such litigation is filed.

   4. Redistribution. You may reproduce and distribute copies of the
      Work or Derivative Works thereof in any medium, with or without
      modifications, and in Source or Object form, provided that You
      meet the following conditions:

      (a) You must give any other recipients of the Work or
          Derivative Works a copy of this License; and

      (b) You must cause any modified files to carry prominent notices
          stating that You changed the files; and

      (c) You must retain, in the Source form of any Derivative Works
          that You distribute, all copyright, patent, trademark, and
          attribution notices from the Source form of the Work,
          excluding those notices that do not pertain to any part of
          the Derivative Works; and

      (d) If the Work includes a "NOTICE" text file as part of its
          distribution, then any Derivative Works that You distribute must
          include a readable copy of the attribution notices contained
          within such NOTICE file, excluding those notices that do not
          pertain to any part of the Derivative Works, in at least one
          of the following places: within a NOTICE text file distributed
          as part of the Derivative Works; within the Source form or
          documentation, if provided along with the Derivative Works; or,
          within a display generated by the Derivative Works, if and
          wherever such third-party notices normally appear. The contents
          of the NOTICE file are for informational purposes only and
          do not modify the License. You may add Your own attribution
          notices within Derivative Works that You distribute, alongside
          or as an addendum to the NOTICE text from the Work, provided
          that such additional attribution notices cannot be construed
          as modifying the License.

      You may add Your own copyright statement to Your modifications and
      may provide additional or different license terms and conditions
      for use, reproduction, or distribution of Your modifications, or
      for any such Derivative Works as a whole, provided Your use,
      reproduction, and distribution of the Work otherwise complies with
      the conditions stated in this License.

   5. Submission of Contributions. Unless You explicitly state otherwise,
      any Contribution intentionally submitted for inclusion in the Work
      by You to the Licensor shall be under the terms and conditions of
      this License, without any additional terms or conditions.
      Notwithstanding the above, nothing herein shall supersede or modify
      the terms of any separate license agreement you may have executed
      with Licensor regarding such Contributions.

   6. Trademarks. This License does not grant permission to use the trade
      names, trademarks, service marks, or product names of the Licensor,
      except as required for reasonable and customary use in describing the
      origin of the Work and reproducing the content of the NOTICE file.

   7. Disclaimer of Warranty. Unless required by applicable law or
      agreed to in writing, Licensor provides the Work (and each
      Contributor provides its Contributions) on an "AS IS" BASIS,
      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
      implied, including, without limitation, any warranties or conditions
      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
      PARTICULAR PURPOSE. You are solely responsible for determining the
      appropriateness of using or redistributing the Work and assume any
      risks associated with Your exercise of permissions under this License.

   8. Limitation of Liability. In no event and under no legal theory,
      whether in tort (including negligence), contract, or otherwise,
      unless required by applicable law (such as deliberate and grossly
      negligent acts) or agreed to in writing, shall any Contributor be
      liable to You for damages, including any direct, indirect, special,
      incidental, or consequential damages of any character arising as a
      result of this License or out of the use or inability to use the
      Work (including but not limited to damages for loss of goodwill,
      work stoppage, computer failure or malfunction, or any and all
      other commercial damages or losses), even if such Contributor
      has been advised of the possibility of such damages.

   9. Accepting Warranty or Additional Liability. While redistributing
      the Work or Derivative Works thereof, You may choose to offer,
      and charge a fee for, acceptance of support, warranty, indemnity,
      or other liability obligations and/or rights consistent with this
      License. However, in accepting such obligations, You may act only
      on Your own behalf and on Your sole responsibility, not on behalf
      of any other Contributor, and only if You agree to indemnify,
      defend, and hold each Contributor harmless for any liability
      incurred by, or claims asserted against, such Contributor by reason
      of your accepting any such warranty or additional liability.

   END OF TERMS AND CONDITIONS

   APPENDIX: How to apply the Apache License to your work.

      To apply the Apache License to your work, attach the following
      boilerplate notice, with the fields enclosed by brackets "{}"
      replaced with your own identifying information. (Don't include
      the brackets!)  The text should be enclosed in the appropriate
      comment syntax for the file format. We also recommend that a
      file or class name and description of purpose be included on the
      same "printed page" as the copyright notice for easier
      identification within third-party archives.

   Copyright {yyyy} {name of copyright owner}

   Licensed under the Apache License, Version 2.0 (the "License");
   you may not use this file except in compliance with the License.
   You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

   Unless required by applicable law or agreed to in writing, software
   distributed under the License is distributed on an "AS IS" BASIS,
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.

================================================
FILE: source/feathers/utils/geom/matrixToRotation.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.geom
{
	import flash.geom.Matrix;

	/**
	 * Extracts the rotation value (in radians) from a <code>flash.geom.Matrix</code>
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/geom/Matrix.html flash.geom.Matrix
	 *
	 * @productversion Feathers 1.2.0
	 */
	public function matrixToRotation(matrix:Matrix):Number
	{
		var c:Number = matrix.c;
		var d:Number = matrix.d;
		return -Math.atan(c / d);
	}
}


================================================
FILE: source/feathers/utils/geom/matrixToScaleX.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.geom
{
	import flash.geom.Matrix;

	/**
	 * Extracts the x scale value from a <code>flash.geom.Matrix</code>
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/geom/Matrix.html flash.geom.Matrix
	 *
	 * @productversion Feathers 1.2.0
	 */
	public function matrixToScaleX(matrix:Matrix):Number
	{
		var a:Number = matrix.a;
		var b:Number = matrix.b;
		return Math.sqrt(a * a + b * b);
	}
}


================================================
FILE: source/feathers/utils/geom/matrixToScaleY.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.geom
{
	import flash.geom.Matrix;

	/**
	 * Extracts the y scale value from a <code>flash.geom.Matrix</code>
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/geom/Matrix.html flash.geom.Matrix
	 *
	 * @productversion Feathers 1.2.0
	 */
	public function matrixToScaleY(matrix:Matrix):Number
	{
		var c:Number = matrix.c;
		var d:Number = matrix.d;
		return Math.sqrt(c * c + d * d);
	}
}


================================================
FILE: source/feathers/utils/keyboard/KeyToEvent.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.keyboard
{
	import feathers.core.DefaultFocusManager;
	import feathers.core.IFocusDisplayObject;
	import feathers.events.FeathersEventType;
	import feathers.system.DeviceCapabilities;

	import flash.ui.Keyboard;

	import starling.display.Stage;
	import starling.events.Event;
	import starling.events.KeyboardEvent;

	/**
	 * Dispatches an event from the target when a key is pressed and released
	 * and the target has focus. Conveniently handles all
	 * <code>KeyboardEvent</code> listeners automatically.
	 *
	 * <p>In the following example, a custom item renderer will be triggered
	 * when a key is pressed and released:</p>
	 *
	 * <listing version="3.0">
	 * public class CustomComponent extends FeathersControl implements IFocusDisplayObject
	 * {
	 *     public function CustomComponent()
	 *     {
	 *         super();
	 *         this._keyToEvent = new KeyToEvent(this, Event.TRIGGERED);
	 *         this._keyToEvent.keyCode = Keyboard.SPACE;
	 *     }
	 * 
	 *     private var _keyToEvent:KeyToEvent;
	 * // ...</listing>
	 *
	 * @see feathers.utils.keyboard.KeyToTrigger
	 * @see feathers.utils.keyboard.KeyToSelect
	 *
	 * @productversion Feathers 3.4.0
	 */
	public class KeyToEvent
	{
		/**
		 * Constructor.
		 */
		public function KeyToEvent(target:IFocusDisplayObject = null, keyCode:uint = Keyboard.SPACE, eventType:String = null)
		{
			this.target = target;
			this.keyCode = keyCode;
			this.eventType = eventType;
		}

		/**
		 * @private
		 */
		protected var _stage:Stage;

		/**
		 * @private
		 */
		protected var _target:IFocusDisplayObject;

		/**
		 * The target component that should be selected when a key is pressed.
		 */
		public function get target():IFocusDisplayObject
		{
			return this._target;
		}

		/**
		 * @private
		 */
		public function set target(value:IFocusDisplayObject):void
		{
			if(this._target === value)
			{
				return;
			}
			if(this._stage !== null)
			{
				//if the target changes while the old target has focus, remove
				//the listeners to avoid possible errors
				this._stage.removeEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
				this._stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
				this._stage = null;
			}
			if(this._target !== null)
			{
				this._target.removeEventListener(FeathersEventType.FOCUS_IN, target_focusInHandler);
				this._target.removeEventListener(FeathersEventType.FOCUS_OUT, target_focusOutHandler);
				this._target.removeEventListener(Event.REMOVED_FROM_STAGE, target_removedFromStageHandler);
			}
			this._target = value;
			if(this._target !== null)
			{
				this._target.addEventListener(FeathersEventType.FOCUS_IN, target_focusInHandler);
				this._target.addEventListener(FeathersEventType.FOCUS_OUT, target_focusOutHandler);
				this._target.addEventListener(Event.REMOVED_FROM_STAGE, target_removedFromStageHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _keyCode:uint = Keyboard.SPACE;

		/**
		 * The key that will dispatch the event, when pressed.
		 *
		 * @default flash.ui.Keyboard.SPACE
		 */
		public function get keyCode():uint
		{
			return this._keyCode;
		}

		/**
		 * @private
		 */
		public function set keyCode(value:uint):void
		{
			this._keyCode = value;
		}

		/**
		 * @private
		 */
		protected var _cancelKeyCode:uint = Keyboard.ESCAPE;

		/**
		 * The key that will cancel the event if the key is down.
		 *
		 * @default flash.ui.Keyboard.ESCAPE
		 */
		public function get cancelKeyCode():uint
		{
			return this._cancelKeyCode;
		}

		/**
		 * @private
		 */
		public function set cancelKeyCode(value:uint):void
		{
			this._cancelKeyCode = value;
		}

		/**
		 * @private
		 */
		protected var _keyLocation:uint = uint.MAX_VALUE;

		/**
		 * The location of the key that will dispatch the event, when pressed.
		 * If <code>uint.MAX_VALUE</code>, then any key location is allowed.
		 *
		 * @default uint.MAX_VALUE
		 *
		 * @see flash.ui.KeyLocation
		 */
		public function get keyLocation():uint
		{
			return this._keyLocation;
		}

		/**
		 * @private
		 */
		public function set keyLocation(value:uint):void
		{
			this._keyLocation = value;
		}

		/**
		 * @private
		 */
		protected var _eventType:String = null;

		/**
		 * The event type that will be dispatched when pressed.
		 */
		public function get eventType():String
		{
			return this._eventType;
		}

		/**
		 * @private
		 */
		public function set eventType(value:String):void
		{
			this._eventType = value;
		}

		/**
		 * @private
		 */
		protected var _isEnabled:Boolean = true;

		/**
		 * May be set to <code>false</code> to disable event dispatching
		 * temporarily until set back to <code>true</code>.
		 */
		public function get isEnabled():Boolean
		{
			return this._isEnabled;
		}

		/**
		 * @private
		 */
		public function set isEnabled(value:Boolean):void
		{
			this._isEnabled = value;
		}

		/**
		 * @private
		 */
		protected function target_focusInHandler(event:Event):void
		{
			var focusManager:DefaultFocusManager = this._target.focusManager as DefaultFocusManager;
			this._stage = this._target.stage;
			this._stage.addEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
		}

		/**
		 * @private
		 */
		protected function target_focusOutHandler(event:Event):void
		{
			if(this._stage !== null)
			{
				this._stage.removeEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
				this._stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
				this._stage = null;
			}
		}

		/**
		 * @private
		 */
		protected function target_removedFromStageHandler(event:Event):void
		{
			if(this._stage !== null)
			{
				this._stage.removeEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
				this._stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
				this._stage = null;
			}
		}

		/**
		 * @private
		 */
		protected function stage_keyDownHandler(event:KeyboardEvent):void
		{
			if(!this._isEnabled)
			{
				return;
			}
			if(event.currentTarget !== this._stage)
			{
				//Github issue #1762: the stage may have been set to null in a
				//previous KeyboardEvent.KEY_DOWN listener
				return;
			}
			if(event.keyCode == this._cancelKeyCode)
			{
				this._stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
				return;
			}
			if(event.keyCode != this._keyCode)
			{
				return;
			}
			if(this._keyLocation != uint.MAX_VALUE &&
				!((event.keyLocation == this._keyLocation) || (this._keyLocation == 4 && DeviceCapabilities.simulateDPad)))
			{
				return;
			}
			this._stage.addEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
		}

		/**
		 * @private
		 */
		protected function stage_keyUpHandler(event:KeyboardEvent):void
		{
			if(!this._isEnabled)
			{
				return;
			}
			if(event.keyCode != this._keyCode)
			{
				return;
			}
			if(this._keyLocation != uint.MAX_VALUE &&
				!((event.keyLocation == this._keyLocation) || (this._keyLocation == 4 && DeviceCapabilities.simulateDPad)))
			{
				return;
			}
			var stage:Stage = Stage(event.currentTarget);
			stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
			if(this._stage !== stage)
			{
				return;
			}
			this._target.dispatchEventWith(this._eventType);
		}
	}
}


================================================
FILE: source/feathers/utils/keyboard/KeyToSelect.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.keyboard
{
	import feathers.core.IFocusDisplayObject;
	import feathers.core.IToggle;
	import feathers.events.FeathersEventType;
	import feathers.system.DeviceCapabilities;

	import flash.ui.Keyboard;

	import starling.display.Stage;
	import starling.events.Event;
	import starling.events.KeyboardEvent;

	/**
	 * Changes the <code>isSelected</code> property of the target when a key is
	 * pressed and released while the target has focus. The target will
	 * dispatch <code>Event.CHANGE</code>. Conveniently handles all
	 * <code>KeyboardEvent</code> listeners automatically.
	 *
	 * <p>In the following example, a custom component will be selected when a
	 * key is pressed and released:</p>
	 *
	 * <listing version="3.0">
	 * public class CustomComponent extends FeathersControl implements IFocusDisplayObject
	 * {
	 *     public function CustomComponent()
	 *     {
	 *         super();
	 *         this._keyToSelect = new KeyToSelect(this);
	 *         this._keyToSelect.keyCode = Keyboard.SPACE;
	 *     }
	 * 
	 *     private var _keyToSelect:KeyToSelect;
	 * // ...</listing>
	 *
	 * <p>Note: When combined with a <code>KeyToTrigger</code> instance, the
	 * <code>KeyToSelect</code> instance should be created second because
	 * <code>Event.TRIGGERED</code> should be dispatched before
	 * <code>Event.CHANGE</code>.</p>
	 *
	 * @see feathers.utils.keyboard.KeyToTrigger
	 * @see feathers.utils.touch.TapToSelect
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class KeyToSelect
	{
		/**
		 * Constructor.
		 */
		public function KeyToSelect(target:IToggle = null, keyCode:uint = Keyboard.SPACE)
		{
			this.target = target;
			this.keyCode = keyCode;
		}

		/**
		 * @private
		 */
		protected var _stage:Stage;

		/**
		 * @private
		 */
		protected var _target:IToggle;

		/**
		 * The target component that should be selected when a key is pressed.
		 */
		public function get target():IToggle
		{
			return this._target;
		}

		/**
		 * @private
		 */
		public function set target(value:IToggle):void
		{
			if(this._target === value)
			{
				return;
			}
			if(value !== null && !(value is IFocusDisplayObject))
			{
				throw new ArgumentError("Target of KeyToSelect must implement IFocusDisplayObject");
			}
			if(this._stage !== null)
			{
				//if the target changes while the old target has focus, remove
				//the listeners to avoid possible errors
				this._stage.removeEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
				this._stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
				this._stage = null;
			}
			if(this._target !== null)
			{
				this._target.removeEventListener(FeathersEventType.FOCUS_IN, target_focusInHandler);
				this._target.removeEventListener(FeathersEventType.FOCUS_OUT, target_focusOutHandler);
				this._target.removeEventListener(Event.REMOVED_FROM_STAGE, target_removedFromStageHandler);
			}
			this._target = value;
			if(this._target !== null)
			{
				this._target.addEventListener(FeathersEventType.FOCUS_IN, target_focusInHandler);
				this._target.addEventListener(FeathersEventType.FOCUS_OUT, target_focusOutHandler);
				this._target.addEventListener(Event.REMOVED_FROM_STAGE, target_removedFromStageHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _keyCode:uint = Keyboard.SPACE;

		/**
		 * The key that will select the target, when pressed.
		 *
		 * @default flash.ui.Keyboard.SPACE
		 */
		public function get keyCode():uint
		{
			return this._keyCode;
		}

		/**
		 * @private
		 */
		public function set keyCode(value:uint):void
		{
			this._keyCode = value;
		}

		/**
		 * @private
		 */
		protected var _cancelKeyCode:uint = Keyboard.ESCAPE;

		/**
		 * The key that will cancel the selection if the key is down.
		 *
		 * @default flash.ui.Keyboard.ESCAPE
		 */
		public function get cancelKeyCode():uint
		{
			return this._cancelKeyCode;
		}

		/**
		 * @private
		 */
		public function set cancelKeyCode(value:uint):void
		{
			this._cancelKeyCode = value;
		}

		/**
		 * @private
		 */
		protected var _keyToDeselect:Boolean = false;

		/**
		 * May be set to <code>true</code> to allow the target to be deselected
		 * when the key is pressed.
		 *
		 * @default false
		 */
		public function get keyToDeselect():Boolean
		{
			return this._keyToDeselect;
		}

		/**
		 * @private
		 */
		public function set keyToDeselect(value:Boolean):void
		{
			this._keyToDeselect = value;
		}

		/**
		 * @private
		 */
		protected var _keyLocation:uint = uint.MAX_VALUE;

		/**
		 * The location of the key that will select the target, when pressed.
		 * If <code>uint.MAX_VALUE</code>, then any key location is allowed.
		 *
		 * @default uint.MAX_VALUE
		 *
		 * @see flash.ui.KeyLocation
		 */
		public function get keyLocation():uint
		{
			return this._keyLocation;
		}

		/**
		 * @private
		 */
		public function set keyLocation(value:uint):void
		{
			this._keyLocation = value;
		}

		/**
		 * @private
		 */
		protected var _isEnabled:Boolean = true;

		/**
		 * May be set to <code>false</code> to disable selection temporarily
		 * until set back to <code>true</code>.
		 */
		public function get isEnabled():Boolean
		{
			return this._isEnabled;
		}

		/**
		 * @private
		 */
		public function set isEnabled(value:Boolean):void
		{
			this._isEnabled = value;
		}

		/**
		 * @private
		 */
		protected function target_focusInHandler(event:Event):void
		{
			this._stage = this._target.stage;
			this._stage.addEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
		}

		/**
		 * @private
		 */
		protected function target_focusOutHandler(event:Event):void
		{
			if(this._stage !== null)
			{
				this._stage.removeEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
				this._stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
				this._stage = null;
			}
		}

		/**
		 * @private
		 */
		protected function target_removedFromStageHandler(event:Event):void
		{
			if(this._stage !== null)
			{
				this._stage.removeEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
				this._stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
				this._stage = null;
			}
		}

		/**
		 * @private
		 */
		protected function stage_keyDownHandler(event:KeyboardEvent):void
		{
			if(!this._isEnabled)
			{
				return;
			}
			if(event.currentTarget !== this._stage)
			{
				//Github issue #1762: the stage may have been set to null in a
				//previous KeyboardEvent.KEY_DOWN listener
				return;
			}
			if(event.keyCode == this._cancelKeyCode)
			{
				this._stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
				return;
			}
			if(event.keyCode != this._keyCode)
			{
				return;
			}
			if(this._keyLocation != uint.MAX_VALUE &&
				!((event.keyLocation == this._keyLocation) || (this._keyLocation == 4 && DeviceCapabilities.simulateDPad)))
			{
				return;
			}
			this._stage.addEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
		}

		/**
		 * @private
		 */
		protected function stage_keyUpHandler(event:KeyboardEvent):void
		{
			if(!this._isEnabled)
			{
				return;
			}
			if(event.keyCode != this._keyCode)
			{
				return;
			}
			if(this._keyLocation != uint.MAX_VALUE &&
				!((event.keyLocation == this._keyLocation) || (this._keyLocation == 4 && DeviceCapabilities.simulateDPad)))
			{
				return;
			}
			var stage:Stage = Stage(event.currentTarget);
			stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
			if(this._stage !== stage)
			{
				return;
			}
			if(this._keyToDeselect)
			{
				this._target.isSelected = !this._target.isSelected;
			}
			else
			{
				this._target.isSelected = true;
			}
		}
	}
}


================================================
FILE: source/feathers/utils/keyboard/KeyToState.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.keyboard
{
	import feathers.controls.ButtonState;
	import feathers.core.IFocusDisplayObject;
	import feathers.core.IStateContext;
	import feathers.events.FeathersEventType;
	import feathers.system.DeviceCapabilities;

	import flash.ui.Keyboard;

	import starling.display.Stage;
	import starling.events.Event;
	import starling.events.KeyboardEvent;

	/**
	 * Changes a target's state when a key is pressed or released on the
	 * keyboard. Conveniently handles all <code>KeyboardEvent</code> listeners
	 * automatically.
	 *
	 * @see feathers.utils.touch.TouchToState
	 *
	 * @productversion Feathers 3.2.0
	 */
	public class KeyToState
	{
		/**
		 * Constructor.
		 */
		public function KeyToState(target:IFocusDisplayObject = null, callback:Function = null)
		{
			this.target = target;
			this.callback = callback;
		}

		/**
		 * @private
		 */
		protected var _stage:Stage;

		/**
		 * @private
		 */
		protected var _hasFocus:Boolean = false;

		/**
		 * @private
		 */
		protected var _target:IFocusDisplayObject;

		/**
		 * The target component that should change state when a key is pressed
		 * or released.
		 */
		public function get target():IFocusDisplayObject
		{
			return this._target;
		}

		/**
		 * @private
		 */
		public function set target(value:IFocusDisplayObject):void
		{
			if(this._target === value)
			{
				return;
			}
			if(value !== null && !(value is IFocusDisplayObject))
			{
				throw new ArgumentError("Target of KeyToState must implement IFocusDisplayObject");
			}
			if(this._stage !== null)
			{
				//if the target changes while the old target has focus, remove
				//the listeners to avoid possible errors
				this._stage.removeEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
				this._stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
				this._stage = null;
			}
			if(this._target !== null)
			{
				this._target.removeEventListener(FeathersEventType.FOCUS_IN, target_focusInHandler);
				this._target.removeEventListener(FeathersEventType.FOCUS_OUT, target_focusOutHandler);
				this._target.removeEventListener(Event.REMOVED_FROM_STAGE, target_removedFromStageHandler);
			}
			this._target = value;
			if(this._target !== null)
			{
				this._currentState = this._upState;
				this._target.addEventListener(FeathersEventType.FOCUS_IN, target_focusInHandler);
				this._target.addEventListener(FeathersEventType.FOCUS_OUT, target_focusOutHandler);
				this._target.addEventListener(Event.REMOVED_FROM_STAGE, target_removedFromStageHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _callback:Function;

		/**
		 * The function to call when the state is changed.
		 *
		 * <p>The callback is expected to have the following signature:</p>
		 * <pre>function(currentState:String):void</pre>
		 */
		public function get callback():Function
		{
			return this._callback;
		}

		/**
		 * @private
		 */
		public function set callback(value:Function):void
		{
			if(this._callback === value)
			{
				return;
			}
			this._callback = value;
			if(this._callback !== null)
			{
				this._callback(this._currentState);
			}
		}

		/**
		 * @private
		 */
		protected var _keyCode:uint = Keyboard.SPACE;

		/**
		 * The key that will change the state of the target, when pressed.
		 *
		 * @default flash.ui.Keyboard.SPACE
		 */
		public function get keyCode():uint
		{
			return this._keyCode;
		}

		/**
		 * @private
		 */
		public function set keyCode(value:uint):void
		{
			this._keyCode = value;
		}

		/**
		 * @private
		 */
		protected var _cancelKeyCode:uint = Keyboard.ESCAPE;

		/**
		 * The key that will cancel the state change if the key is down.
		 *
		 * @default flash.ui.Keyboard.ESCAPE
		 */
		public function get cancelKeyCode():uint
		{
			return this._cancelKeyCode;
		}

		/**
		 * @private
		 */
		public function set cancelKeyCode(value:uint):void
		{
			this._cancelKeyCode = value;
		}

		/**
		 * @private
		 */
		protected var _keyLocation:uint = uint.MAX_VALUE;

		/**
		 * The location of the key that will change the state, when pressed.
		 * If <code>uint.MAX_VALUE</code>, then any key location is allowed.
		 *
		 * @default uint.MAX_VALUE
		 *
		 * @see flash.ui.KeyLocation
		 */
		public function get keyLocation():uint
		{
			return this._keyLocation;
		}

		/**
		 * @private
		 */
		public function set keyLocation(value:uint):void
		{
			this._keyLocation = value;
		}

		/**
		 * @private
		 */
		protected var _isEnabled:Boolean = true;

		/**
		 * May be set to <code>false</code> to disable state changes temporarily
		 * until set back to <code>true</code>.
		 */
		public function get isEnabled():Boolean
		{
			return this._isEnabled;
		}

		/**
		 * @private
		 */
		public function set isEnabled(value:Boolean):void
		{
			this._isEnabled = value;
		}

		/**
		 * @private
		 */
		protected var _currentState:String = ButtonState.UP;

		/**
		 * The current state of the utility. May be different than the state
		 * of the target.
		 */
		public function get currentState():String
		{
			return this._currentState;
		}

		/**
		 * @private
		 */
		protected var _upState:String = ButtonState.UP;

		/**
		 * The value for the "up" state.
		 *
		 * @default feathers.controls.ButtonState.UP
		 */
		public function get upState():String
		{
			return this._upState;
		}

		/**
		 * @private
		 */
		public function set upState(value:String):void
		{
			this._upState = value;
		}

		/**
		 * @private
		 */
		protected var _downState:String = ButtonState.DOWN;

		/**
		 * The value for the "down" state.
		 *
		 * @default feathers.controls.ButtonState.DOWN
		 */
		public function get downState():String
		{
			return this._downState;
		}

		/**
		 * @private
		 */
		public function set downState(value:String):void
		{
			this._downState = value;
		}

		/**
		 * @private
		 */
		protected function changeState(value:String):void
		{
			var oldState:String = this._currentState;
			if(this._target is IStateContext)
			{
				oldState = IStateContext(this._target).currentState;
			}
			this._currentState = value;
			if(oldState === value)
			{
				return;
			}
			if(this._callback !== null)
			{
				this._callback(value);
			}
		}

		/**
		 * @private
		 */
		protected function focusOut():void
		{
			this._hasFocus = false;
			if(this._stage !== null)
			{
				this._stage.removeEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);
				this._stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
				this._stage = null;
			}
			this.changeState(this._upState);
		}

		/**
		 * @private
		 */
		protected function target_focusInHandler(event:Event):void
		{
			this._hasFocus = true;
			this._stage = this._target.stage;
			this._stage.addEventListener(KeyboardEvent.KEY_DOWN, stage_keyDownHandler);

			//don't change the state on focus in because the state may be
			//managed by another utility
		}

		/**
		 * @private
		 */
		protected function target_focusOutHandler(event:Event):void
		{
			this.focusOut();
		}

		/**
		 * @private
		 */
		protected function target_removedFromStageHandler(event:Event):void
		{
			this.focusOut();
		}

		/**
		 * @private
		 */
		protected function stage_keyDownHandler(event:KeyboardEvent):void
		{
			if(!this._isEnabled)
			{
				return;
			}
			if(event.currentTarget !== this._stage)
			{
				//Github issue #1762: the stage may have been set to null in a
				//previous KeyboardEvent.KEY_DOWN listener
				return;
			}
			if(event.keyCode == this._cancelKeyCode)
			{
				this._stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
				this.changeState(this._upState);
				return;
			}
			if(event.keyCode != this._keyCode)
			{
				return;
			}
			if(this._keyLocation != uint.MAX_VALUE &&
				!((event.keyLocation == this._keyLocation) || (this._keyLocation == 4 && DeviceCapabilities.simulateDPad)))
			{
				return;
			}
			this._stage.addEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
			this.changeState(this._downState);
		}

		/**
		 * @private
		 */
		protected function stage_keyUpHandler(event:KeyboardEvent):void
		{
			if(!this._isEnabled)
			{
				return;
			}
			if(event.keyCode != this._keyCode)
			{
				return;
			}
			if(this._keyLocation != uint.MAX_VALUE &&
				!((event.keyLocation == this._keyLocation) || (this._keyLocation == 4 && DeviceCapabilities.simulateDPad)))
			{
				return;
			}
			var stage:Stage = Stage(event.currentTarget);
			stage.removeEventListener(KeyboardEvent.KEY_UP, stage_keyUpHandler);
			if(this._stage !== stage)
			{
				return;
			}
			this.changeState(this._upState);
		}
	}
}


================================================
FILE: source/feathers/utils/keyboard/KeyToTrigger.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.keyboard
{
	import feathers.core.IFocusDisplayObject;

	import flash.ui.Keyboard;

	import starling.events.Event;

	/**
	 * Dispatches <code>Event.TRIGGERED</code> from the target when a key is
	 * pressed and released and the target has focus. Conveniently handles all
	 * <code>KeyboardEvent</code> listeners automatically.
	 *
	 * <p>In the following example, a custom item renderer will be triggered
	 * when a key is pressed and released:</p>
	 *
	 * <listing version="3.0">
	 * public class CustomComponent extends FeathersControl implements IFocusDisplayObject
	 * {
	 *     public function CustomComponent()
	 *     {
	 *         super();
	 *         this._keyToTrigger = new KeyToTrigger(this);
	 *         this._keyToTrigger.keyCode = Keyboard.ENTER;
	 *     }
	 * 
	 *     private var _keyToTrigger:KeyToTrigger;
	 * // ...</listing>
	 *
	 * <p>Note: When combined with a <code>KeyToSelect</code> instance, the
	 * <code>KeyToTrigger</code> instance should be created first because
	 * <code>Event.TRIGGERED</code> should be dispatched before
	 * <code>Event.CHANGE</code>.</p>
	 *
	 * @see http://doc.starling-framework.org/current/starling/events/Event.html#TRIGGERED starling.events.Event.TRIGGERED
	 * @see feathers.utils.keyboard.KeyToSelect
	 * @see feathers.utils.touch.TapToTrigger
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class KeyToTrigger extends KeyToEvent
	{
		/**
		 * Constructor.
		 */
		public function KeyToTrigger(target:IFocusDisplayObject = null, keyCode:uint = Keyboard.SPACE)
		{
			super(target, keyCode, Event.TRIGGERED);
		}
	}
}


================================================
FILE: source/feathers/utils/math/clamp.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.math
{
	/**
	 * Forces a numeric value into a specified range.
	 *
	 * @param value		The value to force into the range.
	 * @param minimum	The minimum bound of the range.
	 * @param maximum	The maximum bound of the range.
	 * @return			A value within the specified range.
	 *
	 * @productversion Feathers 1.0.0
	 */
	public function clamp(value:Number, minimum:Number, maximum:Number):Number
	{
		if(minimum > maximum)
		{
			throw new ArgumentError("minimum should be smaller than maximum.");
		}
		if(value < minimum)
		{
			value = minimum;
		}
		else if(value > maximum)
		{
			value = maximum;
		}
		return value;
	}
}

================================================
FILE: source/feathers/utils/math/roundDownToNearest.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.math
{
	/**
	 * Rounds a Number <em>down</em> to the nearest multiple of an input. For example, by rounding
	 * 16 down to the nearest 10, you will receive 10. Similar to the built-in function Math.floor().
	 *
	 * @param	numberToRound		the number to round down
	 * @param	nearest				the number whose mutiple must be found
	 * @return	the rounded number
	 *
	 * @see Math#floor
	 *
	 * @productversion Feathers 1.0.0
	 */
	public function roundDownToNearest(number:Number, nearest:Number = 1):Number
	{
		if(nearest == 0)
		{
			return number;
		}
		return Math.floor(roundToPrecision(number / nearest, 10)) * nearest;
	}
}

================================================
FILE: source/feathers/utils/math/roundToNearest.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.math
{
	/**
	 * Rounds a Number to the nearest multiple of an input. For example, by rounding
	 * 16 to the nearest 10, you will receive 20. Similar to the built-in function Math.round().
	 *
	 * @param	numberToRound		the number to round
	 * @param	nearest				the number whose mutiple must be found
	 * @return	the rounded number
	 *
	 * @see Math#round
	 *
	 * @productversion Feathers 1.0.0
	 */
	public function roundToNearest(number:Number, nearest:Number = 1):Number
	{
		if(nearest == 0)
		{
			return number;
		}
		var roundedNumber:Number = Math.round(roundToPrecision(number / nearest, 10)) * nearest;
		return roundToPrecision(roundedNumber, 10);
	}
}

================================================
FILE: source/feathers/utils/math/roundToPrecision.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.math
{
	/**
	 * Rounds a number to a certain level of precision. Useful for limiting the number of
	 * decimal places on a fractional number.
	 *
	 * @param		number		the input number to round.
	 * @param		precision	the number of decimal digits to keep
	 * @return		the rounded number, or the original input if no rounding is needed
	 *
	 * @see Math#round
	 *
	 * @productversion Feathers 1.0.0
	 */
	public function roundToPrecision(number:Number, precision:int = 0):Number
	{
		var decimalPlaces:Number = Math.pow(10, precision);
		return Math.round(decimalPlaces * number) / decimalPlaces;
	}
}

================================================
FILE: source/feathers/utils/math/roundUpToNearest.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.math
{
	/**
	 * Rounds a Number <em>up</em> to the nearest multiple of an input. For example, by rounding
	 * 16 up to the nearest 10, you will receive 20. Similar to the built-in function Math.ceil().
	 *
	 * @param	numberToRound		the number to round up
	 * @param	nearest				the number whose mutiple must be found
	 * @return	the rounded number
	 *
	 * @see Math#ceil
	 *
	 * @productversion Feathers 1.0.0
	 */
	public function roundUpToNearest(number:Number, nearest:Number = 1):Number
	{
		if(nearest == 0)
		{
			return number;
		}
		return Math.ceil(roundToPrecision(number / nearest, 10)) * nearest;
	}
}

================================================
FILE: source/feathers/utils/skins/resetFluidChildDimensionsForMeasurement.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.skins
{
	import feathers.core.IMeasureDisplayObject;

	import starling.display.DisplayObject;

	/**
	 * Updates the dimensions of a component's for measurement if the child
	 * should fill the entire width and height of its parent.
	 *
	 * @productversion Feathers 3.0.0
	 */
	public function resetFluidChildDimensionsForMeasurement(child:DisplayObject,
		parentExplicitWidth:Number, parentExplicitHeight:Number,
		parentExplicitMinWidth:Number, parentExplicitMinHeight:Number,
		parentExplicitMaxWidth:Number, parentExplicitMaxHeight:Number,
		childExplicitWidth:Number, childExplicitHeight:Number,
		childExplicitMinWidth:Number, childExplicitMinHeight:Number,
		childExplicitMaxWidth:Number, childExplicitMaxHeight:Number):void
	{
		if(child === null)
		{
			return;
		}
		var needsWidth:Boolean = parentExplicitWidth !== parentExplicitWidth; //isNaN
		var needsHeight:Boolean = parentExplicitHeight !== parentExplicitHeight; //isNaN
		if(needsWidth)
		{
			child.width = childExplicitWidth;
		}
		else
		{
			child.width = parentExplicitWidth;
		}
		if(needsHeight)
		{
			child.height = childExplicitHeight;
		}
		else
		{
			child.height = parentExplicitHeight;
		}
		var measureChild:IMeasureDisplayObject = child as IMeasureDisplayObject;
		if(measureChild !== null)
		{
			var childMinWidth:Number = parentExplicitMinWidth;
			//for some reason, if we do the !== check on a local variable right
			//here, compiling with the flex 4.6 SDK will throw a VerifyError
			//for a stack overflow.
			//we could change the !== check back to isNaN() instead, but
			//isNaN() can allocate an object that needs garbage collection.
			compilerWorkaround = childMinWidth;
			if(childMinWidth !== childMinWidth || //isNaN
				childExplicitMinWidth > childMinWidth)
			{
				childMinWidth = childExplicitMinWidth;
			}
			measureChild.minWidth = childMinWidth;
			var childMinHeight:Number = parentExplicitMinHeight;
			compilerWorkaround = childMinHeight;
			if(childMinHeight !== childMinHeight || //isNaN
				childExplicitMinHeight > childMinHeight)
			{
				childMinHeight = childExplicitMinHeight;
			}
			measureChild.minHeight = childMinHeight;

			var childMaxWidth:Number = parentExplicitMaxWidth;
			compilerWorkaround = childMaxWidth;
			if(childMaxWidth !== childMaxWidth || //isNaN
				childExplicitMaxWidth < childMaxWidth)
			{
				childMaxWidth = childExplicitMaxWidth;
			}
			measureChild.maxWidth = childMaxWidth;
			var childMaxHeight:Number = parentExplicitMaxHeight;
			compilerWorkaround = childMaxHeight;
			if(childMaxHeight !== childMaxHeight || //isNaN
				childExplicitMaxHeight < childMaxHeight)
			{
				childMaxHeight = childExplicitMaxHeight;
			}
			measureChild.maxHeight = childMaxHeight;
		}
	}
}

var compilerWorkaround:Object;

================================================
FILE: source/feathers/utils/text/TextEditorIMEClient.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.text
{
	import feathers.core.IIMETextEditor;

	import flash.display.Sprite;
	import flash.events.IMEEvent;
	import flash.geom.Rectangle;
	import flash.text.ime.CompositionAttributeRange;
	import flash.text.ime.IIMEClient;

	import starling.core.Starling;
	import starling.display.Stage;

	/**
	 * @private
	 *
	 * @productversion Feathers 3.0.0
	 */
	public class TextEditorIMEClient extends Sprite implements IIMEClient
	{
		/**
		 * Constructor.
		 */
		public function TextEditorIMEClient(textEditor:IIMETextEditor, startCallback:Function,
			updateCallback:Function, confirmCallback:Function)
		{
			super();
			this._textEditor = textEditor;
			this._startCallback = startCallback;
			this._updateCallback = updateCallback;
			this._confirmCallback = confirmCallback;
			this.addEventListener(IMEEvent.IME_START_COMPOSITION, imeStartCompositionHandler);
		}

		/**
		 * @private
		 */
		protected var _textEditor:IIMETextEditor;

		/**
		 * @private
		 */
		protected var _startCallback:Function;

		/**
		 * @private
		 */
		protected var _updateCallback:Function;

		/**
		 * @private
		 */
		protected var _confirmCallback:Function;

		/**
		 * @private
		 */
		protected var _compositionStartIndex:int = -1;

		/**
		 * @private
		 */
		protected var _compositionEndIndex:int = -1;

		/**
		 * @private
		 */
		public function get verticalTextLayout():Boolean
		{
			return false;
		}

		/**
		 * @private
		 */
		public function get compositionStartIndex():int
		{
			return this._compositionStartIndex;
		}

		/**
		 * @private
		 */
		public function get compositionEndIndex():int
		{
			return this._compositionEndIndex;
		}

		/**
		 * @private
		 */
		public function get selectionAnchorIndex():int
		{
			return this._textEditor.selectionAnchorIndex;
		}

		/**
		 * @private
		 */
		public function get selectionActiveIndex():int
		{
			return this._textEditor.selectionActiveIndex;
		}

		/**
		 * @private
		 */
		public function getTextBounds(startIndex:int, endIndex:int):Rectangle
		{
			var stage:Stage = this._textEditor.stage;
			if(stage === null)
			{
				return new Rectangle();
			}
			var result:Rectangle = this._textEditor.getBounds(stage);
			var starling:Starling = this._textEditor.stage !== null ? this._textEditor.stage.starling : Starling.current;
			var nativeScaleFactor:Number = 1;
			if(starling.supportHighResolutions)
			{
				nativeScaleFactor = starling.nativeStage.contentsScaleFactor;
			}
			var scaleFactor:Number = starling.contentScaleFactor / nativeScaleFactor;
			result.x *= scaleFactor;
			result.y *= scaleFactor;
			result.width *= scaleFactor;
			result.height *= scaleFactor;
			var viewPort:Rectangle = starling.viewPort;
			result.x += viewPort.x;
			result.y += viewPort.y;
			return result;
		}

		/**
		 * @private
		 */
		public function confirmComposition(text:String = null, preserveSelection:Boolean = false):void
		{
			this._confirmCallback(text, preserveSelection);
		}

		/**
		 * @private
		 */
		public function updateComposition(text:String, attributes:Vector.<CompositionAttributeRange>, compositionStartIndex:int, compositionEndIndex:int):void
		{
			this._compositionStartIndex = compositionStartIndex;
			this._compositionEndIndex = compositionEndIndex;
			this._updateCallback(text, attributes, compositionStartIndex, compositionEndIndex);
		}

		/**
		 * @private
		 */
		public function selectRange(startIndex:int, endIndex:int):void
		{
			this._textEditor.selectRange(startIndex, endIndex);
		}

		/**
		 * @private
		 */
		public function getTextInRange(startIndex:int, endIndex:int):String
		{
			return this._textEditor.text.substring(startIndex, endIndex);
		}

		/**
		 * @private
		 */
		protected function imeStartCompositionHandler(event:IMEEvent):void
		{
			event.imeClient = this;
			this._startCallback();
		}
	}
}


================================================
FILE: source/feathers/utils/text/TextInputNavigation.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.text
{
	/**
	 * Functions for navigating text inputs with the keyboard.
	 *
	 * @productversion Feathers 2.0.0
	 */
	public class TextInputNavigation
	{
		/**
		 * @private
		 */
		protected static const IS_WORD:RegExp = /\w/;

		/**
		 * @private
		 */
		protected static const IS_WHITESPACE:RegExp = /\s/;

		/**
		 * Finds the start index of the word that starts before the selection.
		 */
		public static function findPreviousWordStartIndex(text:String, selectionStartIndex:int):int
		{
			if(selectionStartIndex <= 0)
			{
				return 0;
			}
			var nextCharIsWord:Boolean = IS_WORD.test(text.charAt(selectionStartIndex - 1));
			for(var i:int = selectionStartIndex - 2; i >= 0; i--)
			{
				var charIsWord:Boolean = IS_WORD.test(text.charAt(i));
				if(!charIsWord && nextCharIsWord)
				{
					return i + 1;
				}
				nextCharIsWord = charIsWord;
			}
			return 0;
		}

		/**
		 * Finds the start index of the word that starts with the current
		 * selection. If the current selection is in the whitespace between
		 * words, returns the start index of the previous word.
		 */
		public static function findCurrentWordStartIndex(text:String, selectionStartIndex:int):int
		{
			if(selectionStartIndex <= 0)
			{
				return 0;
			}
			var nextCharIsWord:Boolean = IS_WORD.test(text.charAt(selectionStartIndex + 1));
			for(var i:int = selectionStartIndex; i >= 0; i--)
			{
				var charIsWord:Boolean = IS_WORD.test(text.charAt(i));
				if(!charIsWord && i == selectionStartIndex)
				{
					//this is whitespace between words
					return findPreviousWordStartIndex(text, selectionStartIndex);
				}
				if(!charIsWord && nextCharIsWord)
				{
					return i + 1;
				}
				nextCharIsWord = charIsWord;
			}
			return 0;
		}

		/**
		 * Finds the end index of the word that starts with the current
		 * selection. If the current selection is in the whitespace between
		 * words, returns the end index of the next word.
		 */
		public static function findCurrentWordEndIndex(text:String, selectionEndIndex:int):int
		{
			var textLength:int = text.length;
			if(selectionEndIndex >= textLength - 1)
			{
				return textLength;
			}
			for(var i:int = selectionEndIndex; i < textLength; i++)
			{
				var charIsWord:Boolean = IS_WORD.test(text.charAt(i));
				if(!charIsWord && i == selectionEndIndex)
				{
					//this is whitespace between words
					var nextStart:int = findNextWordStartIndex(text, selectionEndIndex);
					return findCurrentWordEndIndex(text, nextStart);
				}
				if(!charIsWord)
				{
					return i;
				}
			}
			return textLength;
		}

		/**
		 * Finds the start index of the next word that starts after the
		 * selection.
		 */
		public static function findNextWordStartIndex(text:String, selectionEndIndex:int):int
		{
			var textLength:int = text.length;
			if(selectionEndIndex >= textLength - 1)
			{
				return textLength;
			}
			//the first character is a special case. any non-whitespace is
			//considered part of the word.
			var prevCharIsWord:Boolean = !IS_WHITESPACE.test(text.charAt(selectionEndIndex));
			for(var i:int = selectionEndIndex + 1; i < textLength; i++)
			{
				var charIsWord:Boolean = IS_WORD.test(text.charAt(i));
				if(charIsWord && !prevCharIsWord)
				{
					return i;
				}
				prevCharIsWord = charIsWord;
			}
			return textLength;
		}
	}
}


================================================
FILE: source/feathers/utils/text/TextInputRestrict.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.text
{
	import flash.utils.Dictionary;

	/**
	 * Duplicates the functionality of the <code>restrict</code> property on
	 * <code>flash.text.TextField</code>.
	 *
	 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#restrict Full description of flash.text.TextField.restrict in Adobe's Flash Platform API Reference
	 */
	public class TextInputRestrict
	{
		/**
		 * @private
		 */
		protected static const REQUIRES_ESCAPE:Dictionary = new Dictionary();
		REQUIRES_ESCAPE[/\[/g] = "\\[";
		REQUIRES_ESCAPE[/\]/g] = "\\]";
		REQUIRES_ESCAPE[/\{/g] = "\\{";
		REQUIRES_ESCAPE[/\}/g] = "\\}";
		REQUIRES_ESCAPE[/\(/g] = "\\(";
		REQUIRES_ESCAPE[/\)/g] = "\\)";
		REQUIRES_ESCAPE[/\|/g] = "\\|";
		REQUIRES_ESCAPE[/\//g] = "\\/";
		REQUIRES_ESCAPE[/\./g] = "\\.";
		REQUIRES_ESCAPE[/\+/g] = "\\+";
		REQUIRES_ESCAPE[/\*/g] = "\\*";
		REQUIRES_ESCAPE[/\?/g] = "\\?";
		REQUIRES_ESCAPE[/\$/g] = "\\$";

		/**
		 * Constructor.
		 */
		public function TextInputRestrict(restrict:String = null)
		{
			this.restrict = restrict;
		}

		/**
		 * @private
		 */
		protected var _restrictStartsWithExclude:Boolean = false;

		/**
		 * @private
		 */
		protected var _restricts:Vector.<RegExp>;

		/**
		 * @private
		 */
		private var _restrict:String;

		/**
		 * Indicates the set of characters that a user can input.
		 *
		 * <p>In the following example, the text is restricted to numbers:</p>
		 *
		 * <listing version="3.0">
		 * object.restrict = "0-9";</listing>
		 *
		 * @default null
		 *
		 * @see http://help.adobe.com/en_US/FlashPlatform/reference/actionscript/3/flash/text/TextField.html#restrict Full description of flash.text.TextField.restrict in Adobe's Flash Platform API Reference
		 */
		public function get restrict():String
		{
			return this._restrict;
		}

		/**
		 * @private
		 */
		public function set restrict(value:String):void
		{
			if(this._restrict === value)
			{
				return;
			}
			this._restrict = value;
			if(value)
			{
				if(this._restricts)
				{
					this._restricts.length = 0;
				}
				else
				{
					this._restricts = new <RegExp>[];
				}
				if(this._restrict === "")
				{
					this._restricts.push(/^$/);
				}
				else if(this._restrict)
				{
					var startIndex:int = 0;
					var isExcluding:Boolean = value.indexOf("^") == 0;
					this._restrictStartsWithExclude = isExcluding;
					do
					{
						var nextStartIndex:int = value.indexOf("^", startIndex + 1);
						while(nextStartIndex != -1 && value.charAt(nextStartIndex - 1) === "\\")
						{
							//this is an escaped caret, so skip it
							nextStartIndex = value.indexOf("^", nextStartIndex + 1);
						}
						if(nextStartIndex >= 0)
						{
							var partialRestrict:String = value.substr(startIndex, nextStartIndex - startIndex);
							this._restricts.push(this.createRestrictRegExp(partialRestrict, isExcluding));
						}
						else
						{
							partialRestrict = value.substr(startIndex);
							this._restricts.push(this.createRestrictRegExp(partialRestrict, isExcluding));
							break;
						}
						startIndex = nextStartIndex;
						isExcluding = !isExcluding;
					}
					while(true);
				}
			}
			else
			{
				this._restricts = null;
			}
		}

		/**
		 * Accepts a character code and determines if it is allowed or not.
		 */
		public function isCharacterAllowed(charCode:int):Boolean
		{
			if(!this._restricts)
			{
				return true;
			}
			var character:String = String.fromCharCode(charCode);
			var isExcluding:Boolean = this._restrictStartsWithExclude;
			var isIncluded:Boolean = isExcluding;
			var restrictCount:int = this._restricts.length;
			for(var i:int = 0; i < restrictCount; i++)
			{
				var restrict:RegExp = this._restricts[i];
				if(isExcluding)
				{
					isIncluded = isIncluded && restrict.test(character);
				}
				else
				{
					isIncluded = isIncluded || restrict.test(character);
				}
				isExcluding = !isExcluding;
			}
			return isIncluded;
		}

		/**
		 * Accepts a string of characters and filters out characters that are
		 * not allowed.
		 */
		public function filterText(value:String):String
		{
			if(!this._restricts)
			{
				return value;
			}
			var textLength:int = value.length;
			var restrictCount:int = this._restricts.length;
			for(var i:int = 0; i < textLength; i++)
			{
				var character:String = value.charAt(i);
				var isExcluding:Boolean = this._restrictStartsWithExclude;
				var isIncluded:Boolean = isExcluding;
				for(var j:int = 0; j < restrictCount; j++)
				{
					var restrict:RegExp = this._restricts[j];
					if(isExcluding)
					{
						isIncluded = isIncluded && restrict.test(character);
					}
					else
					{
						isIncluded = isIncluded || restrict.test(character);
					}
					isExcluding = !isExcluding;
				}
				if(!isIncluded)
				{
					value = value.substr(0, i) + value.substr(i + 1);
					i--;
					textLength--;
				}
			}
			return value;
		}

		/**
		 * @private
		 */
		protected function createRestrictRegExp(restrict:String, isExcluding:Boolean):RegExp
		{
			if(!isExcluding && restrict.indexOf("^") == 0)
			{
				//unlike regular expressions, which always treat ^ as excluding,
				//restrict uses ^ to swap between excluding and including.
				//if we're including, we need to remove ^ for the regexp
				restrict = restrict.substr(1);
			}
			//we need to do backslash first. otherwise, we'll get duplicates.
			//however, skip backslashes that are escaping -, ^, and \.
			restrict = restrict.replace(/\\(?=[^\-\^\\])/g, "\\\\");
			for(var key:Object in REQUIRES_ESCAPE)
			{
				var keyRegExp:RegExp = key as RegExp;
				var value:String = REQUIRES_ESCAPE[keyRegExp] as String;
				restrict = restrict.replace(keyRegExp, value);
			}
			return new RegExp("[" + restrict + "]");
		}
	}
}


================================================
FILE: source/feathers/utils/textures/TextureCache.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.textures
{
	import flash.errors.IllegalOperationError;

	import starling.textures.Texture;

	/**
	 * Caches textures in memory. Each texture may be saved with its own key,
	 * such as the URL where the original image file is located.
	 *
	 * <p><strong>Note:</strong> Most developers will only need to create a
	 * <code>TextureCache</code>, pass it to multiple <code>ImageLoader</code>
	 * components, and dispose the cache when finished. APIs to retain and
	 * release textures are meant to be used by <code>ImageLoader</code>.</p>
	 *
	 * <p>A single <code>TextureCache</code> may be passed to multiple
	 * <code>ImageLoader</code> components using the <code>textureCache</code>
	 * property:</p>
	 *
	 * <listing version="3.0">
	 * var cache:TextureCache = new TextureCache();
	 * loader1.textureCache = cache;
	 * loader2.textureCache = cache;</listing>
	 *
	 * <p>Don't forget to dispose the <code>TextureCache</code> when it is no
	 * longer needed -- to avoid memory leaks:</p>
	 *
	 * <listing version="3.0">
	 * cache.dispose();</listing>
	 *
	 * <p>To use a TextureCache in a <code>List</code> or
	 * <code>GroupedList</code> with the default item renderer, pass the cache
	 * to the <code>ImageLoader</code> components using the
	 * <code>iconLoaderFactory</code> or
	 * <code>accessoryLoaderFactory</code>:</p>
	 *
	 * <listing version="3.0">
	 * var cache:TextureCache = new TextureCache();
	 * list.itemRendererFactory = function():IListItemRenderer
	 * {
	 *     var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
	 *     itemRenderer.iconLoaderFactory = function():ImageLoader
	 *     {
	 *         var loader:ImageLoader = new ImageLoader();
	 *         loader.textureCache = cache;
	 *         return loader;
	 *     };
	 *     return itemRenderer;
	 * };</listing>
	 *
	 * @see feathers.controls.ImageLoader#textureCache
	 *
	 * @productversion Feathers 2.3.0
	 */
	public class TextureCache
	{
		/**
		 * Constructor.
		 */
		public function TextureCache(maxUnretainedTextures:int = int.MAX_VALUE)
		{
			this._maxUnretainedTextures = maxUnretainedTextures;
		}

		/**
		 * @private
		 */
		protected var _unretainedKeys:Vector.<String> = new <String>[];

		/**
		 * @private
		 */
		protected var _unretainedTextures:Object = {};

		/**
		 * @private
		 */
		protected var _retainedTextures:Object = {};

		/**
		 * @private
		 */
		protected var _retainCounts:Object = {};

		/**
		 * @private
		 */
		protected var _maxUnretainedTextures:int;

		/**
		 * Limits the number of unretained textures that may be stored in
		 * memory. The textures retained least recently will be disposed if
		 * there are too many.
		 */
		public function get maxUnretainedTextures():int
		{
			return this._maxUnretainedTextures;
		}

		/**
		 * @private
		 */
		public function set maxUnretainedTextures(value:int):void
		{
			if(this._maxUnretainedTextures == value)
			{
				return;
			}
			this._maxUnretainedTextures = value;
			if(this._unretainedKeys.length > value)
			{
				this.trimCache();
			}
		}

		/**
		 * Disposes the texture cache, including all textures (even if they are
		 * retained).
		 */
		public function dispose():void
		{
			for each(var texture:Texture in this._unretainedTextures)
			{
				texture.dispose();
			}
			for each(texture in this._retainedTextures)
			{
				texture.dispose();
			}
			this._retainedTextures = null;
			this._unretainedTextures = null;
			this._retainCounts = null;
		}

		/**
		 * Saves a texture, and associates it with a specific key.
		 *
		 * @see #removeTexture()
		 * @see #hasTexture()
		 */
		public function addTexture(key:String, texture:Texture, retainTexture:Boolean = true):void
		{
			if(!this._retainedTextures)
			{
				throw new IllegalOperationError("Cannot add a texture after the cache has been disposed.");
			}
			if(key in this._unretainedTextures || key in this._retainedTextures)
			{
				throw new ArgumentError("Key \"" + key + "\" already exists in the cache.");
			}
			if(retainTexture)
			{
				this._retainedTextures[key] = texture;
				this._retainCounts[key] = 1 as int;
				return;
			}
			this._unretainedTextures[key] = texture;
			this._unretainedKeys[this._unretainedKeys.length] = key;
			if(this._unretainedKeys.length > this._maxUnretainedTextures)
			{
				this.trimCache();
			}
		}

		/**
		 * Removes a specific key from the cache, and optionally disposes the
		 * texture associated with the key.
		 *
		 * @see #addTexture()
		 */
		public function removeTexture(key:String, dispose:Boolean = false):void
		{
			if(!this._unretainedTextures)
			{
				return;
			}
			var texture:Texture = this._unretainedTextures[key] as Texture;
			if(texture)
			{
				this.removeUnretainedKey(key);
			}
			else
			{
				texture = this._retainedTextures[key] as Texture;
				delete this._retainedTextures[key];
				delete this._retainCounts[key];
			}
			if(dispose && texture)
			{
				texture.dispose();
			}
		}

		/**
		 * Indicates if a texture is associated with the specified key.
		 */
		public function hasTexture(key:String):Boolean
		{
			if(!this._retainedTextures)
			{
				return false;
			}
			return key in this._retainedTextures || key in this._unretainedTextures;
		}

		/**
		 * Returns how many times the texture associated with the specified key
		 * has currently been retained.
		 */
		public function getRetainCount(key:String):int
		{
			if(this._retainCounts && (key in this._retainCounts))
			{
				return this._retainCounts[key] as int;
			}
			return 0;
		}

		/**
		 * Gets the texture associated with the specified key, and increments
		 * the retain count for the texture. Always remember to call
		 * <code>releaseTexture()</code> when finished with a retained texture.
		 *
		 * @see #releaseTexture()
		 */
		public function retainTexture(key:String):Texture
		{
			if(!this._retainedTextures)
			{
				throw new IllegalOperationError("Cannot retain a texture after the cache has been disposed.");
			}
			if(key in this._retainedTextures)
			{
				var count:int = this._retainCounts[key] as int;
				count++;
				this._retainCounts[key] = count;
				return Texture(this._retainedTextures[key]);
			}

			if(!(key in this._unretainedTextures))
			{
				throw new ArgumentError("Texture with key \"" + key + "\" cannot be retained because it has not been added to the cache.");
			}
			var texture:Texture = Texture(this._unretainedTextures[key]);
			this.removeUnretainedKey(key);
			this._retainedTextures[key] = texture;
			this._retainCounts[key] = 1 as int;
			return texture;
		}

		/**
		 * Releases a retained texture.
		 *
		 * @see #retainTexture()
		 */
		public function releaseTexture(key:String):void
		{
			if(!this._retainedTextures || !(key in this._retainedTextures))
			{
				return;
			}
			var count:int = this._retainCounts[key] as int;
			count--;
			if(count == 0)
			{
				//get the existing texture
				var texture:Texture = Texture(this._retainedTextures[key]);

				//remove from retained
				delete this._retainCounts[key];
				delete this._retainedTextures[key];

				this._unretainedTextures[key] = texture;
				this._unretainedKeys[this._unretainedKeys.length] = key;
				if(this._unretainedKeys.length > this._maxUnretainedTextures)
				{
					this.trimCache();
				}
			}
			else
			{
				this._retainCounts[key] = count;
			}
		}

		/**
		 * @private
		 */
		protected function removeUnretainedKey(key:String):void
		{
			var index:int = this._unretainedKeys.indexOf(key);
			if(index < 0)
			{
				return;
			}
			this._unretainedKeys.removeAt(index);
			delete this._unretainedTextures[key];
		}

		/**
		 * @private
		 */
		protected function trimCache():void
		{
			var currentCount:int = this._unretainedKeys.length;
			var maxCount:int = this._maxUnretainedTextures;
			while(currentCount > maxCount)
			{
				var key:String = this._unretainedKeys.shift();
				var texture:Texture = Texture(this._unretainedTextures[key]);
				texture.dispose();
				delete this._unretainedTextures[key];
				currentCount--;
			}
		}
	}
}


================================================
FILE: source/feathers/utils/textures/calculateSnapshotTextureDimensions.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.textures
{
	import flash.geom.Point;

	import starling.utils.MathUtil;

	/**
	 * Calculates the dimensions of the texture needed to display an item with
	 * the specified width and height, accepting a maximum where the snapshot
	 * must be split into multiple textures. If Starling's profile is
	 * <code>Context3DProfile.BASELINE_CONSTRAINED</code>, will calculate
	 * power-of-two dimensions for the texture.
	 *
	 * @productversion Feathers 3.1.0
	 */
	public function calculateSnapshotTextureDimensions(width:Number, height:Number, maximum:Number, supportsRectangleTexture:Boolean, result:Point = null):Point
	{
		var snapshotWidth:Number = width;
		var snapshotHeight:Number = height;
		if(!supportsRectangleTexture)
		{
			if(snapshotWidth > maximum)
			{
				snapshotWidth = int(snapshotWidth / maximum) * maximum + MathUtil.getNextPowerOfTwo(snapshotWidth % maximum);
			}
			else
			{
				snapshotWidth = MathUtil.getNextPowerOfTwo(snapshotWidth);
			}
		}
		else if(snapshotWidth > maximum)
		{
			snapshotWidth = int(snapshotWidth / maximum) * maximum + (snapshotWidth % maximum);
		}
		if(!supportsRectangleTexture)
		{
			if(snapshotHeight > maximum)
			{
				snapshotHeight = int(snapshotHeight / maximum) * maximum + MathUtil.getNextPowerOfTwo(snapshotHeight % maximum);
			}
			else
			{
				snapshotHeight = MathUtil.getNextPowerOfTwo(snapshotHeight);
			}
		}
		else if(snapshotHeight > maximum)
		{
			snapshotHeight = int(snapshotHeight / maximum) * maximum + (snapshotHeight % maximum);
		}
		if(result === null)
		{
			result = new Point(snapshotWidth, snapshotHeight);
		}
		else
		{
			result.setTo(snapshotWidth, snapshotHeight);
		}
		return result;
	}
}


================================================
FILE: source/feathers/utils/touch/DelayedDownTouchToState.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.touch
{
	import feathers.controls.ButtonState;

	import flash.events.TimerEvent;
	import flash.utils.Timer;

	import starling.display.DisplayObject;

	/**
	 * Similar to <code>TouchToState</code>, but delays the "down" state by a
	 * specified number of seconds. Useful for delayed state changes in
	 * scrolling containers.
	 *
	 * @productversion Feathers 3.2.0
	 */
	public class DelayedDownTouchToState extends TouchToState
	{
		/**
		 * Constructor.
		 */
		public function DelayedDownTouchToState(target:DisplayObject = null, callback:Function = null)
		{
			super(target, callback);
		}

		/**
		 * @private
		 */
		override public function set target(value:DisplayObject):void
		{
			super.target = value;
			if(this._target === null && this._stateDelayTimer !== null)
			{
				if(this._stateDelayTimer.running)
				{
					this._stateDelayTimer.stop();
				}
				this._stateDelayTimer.removeEventListener(TimerEvent.TIMER_COMPLETE, stateDelayTimer_timerCompleteHandler);
				this._stateDelayTimer = null;
			}
		}

		/**
		 * @private
		 */
		protected var _delayedCurrentState:String;

		/**
		 * @private
		 */
		protected var _stateDelayTimer:Timer;

		/**
		 * @private
		 */
		protected var _delay:Number = 0.25;

		/**
		 * The time, in seconds, to delay the state.
		 *
		 * @default 0.25
		 */
		public function get delay():Number
		{
			return this._delay;
		}

		/**
		 * @private
		 */
		public function set delay(value:Number):void
		{
			this._delay = value;
		}

		/**
		 * @private
		 */
		override protected function changeState(value:String):void
		{
			if(this._stateDelayTimer && this._stateDelayTimer.running)
			{
				this._delayedCurrentState = value;
				return;
			}

			if(value === ButtonState.DOWN)
			{
				if(this._currentState === value)
				{
					return;
				}
				this._delayedCurrentState = value;
				if(this._stateDelayTimer)
				{
					this._stateDelayTimer.reset();
				}
				else
				{
					this._stateDelayTimer = new Timer(this._delay * 1000, 1);
					this._stateDelayTimer.addEventListener(TimerEvent.TIMER_COMPLETE, stateDelayTimer_timerCompleteHandler);
				}
				this._stateDelayTimer.start();
				return;
			}
			super.changeState(value);
		}

		/**
		 * @private
		 */
		protected function stateDelayTimer_timerCompleteHandler(event:TimerEvent):void
		{
			super.changeState(this._delayedCurrentState);
			this._delayedCurrentState = null;
		}
	}
}


================================================
FILE: source/feathers/utils/touch/LongPress.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.touch
{
	import feathers.events.FeathersEventType;

	import flash.geom.Point;
	import flash.utils.getTimer;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Stage;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * Dispatches <code>FeathersEventType.LONG_PRESS</code> from the target when
	 * the target is long-pressed. Conveniently handles all
	 * <code>TouchEvent</code> listeners automatically. Useful for custom item
	 * renderers that should dispatch a long press event.
	 *
	 * <p>In the following example, a custom item renderer will dispatch
	 * a long press event when tapped:</p>
	 *
	 * <listing version="3.0">
	 * public class CustomItemRenderer extends LayoutGroupListItemRenderer
	 * {
	 *     public function CustomItemRenderer()
	 *     {
	 *         super();
	 *         this._longPress = new LongPress(this);
	 *     }
	 * 
	 *     private var _longPress:LongPress;
	 * }</listing>
	 *
	 * <p>Note: When combined with <code>TapToSelect</code> or
	 * <code>TapToTrigger</code>, the <code>LongPress</code> instance should be
	 * created first because it needs a higher priority for the
	 * <code>TouchEvent.TOUCH</code> event so that it can disable the other
	 * events.</p>
	 *
	 * @see feathers.events.FeathersEventType.LONG_PRESS
	 * @see feathers.utils.touch.TapToTrigger
	 * @see feathers.utils.touch.TapToSelect
	 *
	 * @productversion Feathers 2.3.0
	 */
	public class LongPress
	{
		/**
		 * Constructor.
		 */
		public function LongPress(target:DisplayObject = null)
		{
			this.target = target;
		}

		/**
		 * @private
		 */
		protected var _target:DisplayObject;

		/**
		 * The target component that should dispatch
		 * <code>FeathersEventType.LONG_PRESS</code> when tapped.
		 */
		public function get target():DisplayObject
		{
			return this._target;
		}

		/**
		 * @private
		 */
		public function set target(value:DisplayObject):void
		{
			if(this._target == value)
			{
				return;
			}
			if(this._target)
			{
				this._target.removeEventListener(TouchEvent.TOUCH, target_touchHandler);
				this._target.removeEventListener(Event.ENTER_FRAME, target_enterFrameHandler);
			}
			this._target = value;
			if(this._target)
			{
				//if we're changing targets, and a touch is active, we want to
				//clear it.
				this._touchPointID = -1;
				this._target.addEventListener(TouchEvent.TOUCH, target_touchHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _longPressDuration:Number = 0.5;

		/**
		 * The duration, in seconds, of a long press.
		 *
		 * <p>The following example changes the long press duration to one full second:</p>
		 *
		 * <listing version="3.0">
		 * longPress.longPressDuration = 1.0;</listing>
		 *
		 * @default 0.5
		 */
		public function get longPressDuration():Number
		{
			return this._longPressDuration;
		}

		/**
		 * @private
		 */
		public function set longPressDuration(value:Number):void
		{
			this._longPressDuration = value;
		}

		/**
		 * @private
		 */
		protected var _touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _touchLastGlobalPosition:Point = new Point();

		/**
		 * @private
		 */
		protected var _touchBeginTime:int;

		/**
		 * @private
		 */
		protected var _isEnabled:Boolean = true;

		/**
		 * May be set to <code>false</code> to disable the triggered event
		 * temporarily until set back to <code>true</code>.
		 */
		public function get isEnabled():Boolean
		{
			return this._isEnabled;
		}

		/**
		 * @private
		 */
		public function set isEnabled(value:Boolean):void
		{
			if(this._isEnabled === value)
			{
				return;
			}
			this._isEnabled = value;
			if(!value)
			{
				this._touchPointID = -1;
			}
		}

		/**
		 * @private
		 */
		protected var _tapToTrigger:TapToTrigger;

		/**
		 * If the target can be triggered by tapping, the
		 * <code>TapToTrigger</code> instance should be passed in so that it can
		 * be temporarily disabled when a long press is detected.
		 */
		public function get tapToTrigger():TapToTrigger
		{
			return this._tapToTrigger;
		}

		/**
		 * @private
		 */
		public function set tapToTrigger(value:TapToTrigger):void
		{
			this._tapToTrigger = value;
		}

		/**
		 * @private
		 */
		protected var _tapToSelect:TapToSelect;

		/**
		 * If the target can be selected by tapping, the
		 * <code>TapToSelect</code> instance should be passed in so that it can
		 * be temporarily disabled when a long press is detected.
		 */
		public function get tapToSelect():TapToSelect
		{
			return this._tapToSelect;
		}

		/**
		 * @private
		 */
		public function set tapToSelect(value:TapToSelect):void
		{
			this._tapToSelect = value;
		}

		/**
		 * @private
		 */
		protected var _customHitTest:Function;

		/**
		 * In addition to a normal call to <code>hitTest()</code>, a custom
		 * function may impose additional rules that determine if the target
		 * should be long pressed. Called on <code>TouchPhase.BEGAN</code>.
		 *
		 * <p>The function must have the following signature:</p>
		 *
		 * <pre>function(localPosition:Point):Boolean;</pre>
		 *
		 * <p>The function should return <code>true</code> if the target should
		 * be long pressed, and <code>false</code> if it should not be
		 * long pressed.</p>
		 */
		public function get customHitTest():Function
		{
			return this._customHitTest;
		}

		/**
		 * @private
		 */
		public function set customHitTest(value:Function):void
		{
			this._customHitTest = value;
		}

		/**
		 * @private
		 */
		protected function target_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._touchPointID = -1;
				return;
			}

			if(this._touchPointID >= 0)
			{
				//a touch has begun, so we'll ignore all other touches.
				var touch:Touch = event.getTouch(this._target, null, this._touchPointID);
				if(!touch)
				{
					//this should not happen.
					return;
				}

				if(touch.phase == TouchPhase.MOVED)
				{
					this._touchLastGlobalPosition.x = touch.globalX;
					this._touchLastGlobalPosition.y = touch.globalY;
				}
				else if(touch.phase == TouchPhase.ENDED)
				{
					this._target.removeEventListener(Event.ENTER_FRAME, target_enterFrameHandler);

					//re-enable the other events
					if(this._tapToTrigger)
					{
						this._tapToTrigger.isEnabled = true;
					}
					if(this._tapToSelect)
					{
						this._tapToSelect.isEnabled = true;
					}

					//the touch has ended, so now we can start watching for a
					//new one.
					this._touchPointID = -1;
				}
				return;
			}
			else
			{
				//we aren't tracking another touch, so let's look for a new one.
				touch = event.getTouch(DisplayObject(this._target), TouchPhase.BEGAN);
				if(!touch)
				{
					//we only care about the began phase. ignore all other
					//phases when we don't have a saved touch ID.
					return;
				}
				if(this._customHitTest !== null)
				{
					var point:Point = Pool.getPoint();
					touch.getLocation(DisplayObject(this._target), point);
					var isInBounds:Boolean = this._customHitTest(point);
					Pool.putPoint(point);
					if(!isInBounds)
					{
						return;
					}
				}

				//save the touch ID so that we can track this touch's phases.
				this._touchPointID = touch.id;

				//save the position so that we can do a final hit test
				this._touchLastGlobalPosition.x = touch.globalX;
				this._touchLastGlobalPosition.y = touch.globalY;

				this._touchBeginTime = getTimer();
				this._target.addEventListener(Event.ENTER_FRAME, target_enterFrameHandler);
			}
		}

		/**
		 * @private
		 */
		protected function target_enterFrameHandler(event:Event):void
		{
			var accumulatedTime:Number = (getTimer() - this._touchBeginTime) / 1000;
			if(accumulatedTime >= this._longPressDuration)
			{
				this._target.removeEventListener(Event.ENTER_FRAME, target_enterFrameHandler);

				var stage:Stage = this._target.stage;
				if(this._target is DisplayObjectContainer)
				{
					var isInBounds:Boolean = DisplayObjectContainer(this._target).contains(stage.hitTest(this._touchLastGlobalPosition));
				}
				else
				{
					isInBounds = this._target === stage.hitTest(this._touchLastGlobalPosition);
				}
				if(isInBounds)
				{
					//disable the other events
					if(this._tapToTrigger)
					{
						this._tapToTrigger.isEnabled = false;
					}
					if(this._tapToSelect)
					{
						this._tapToSelect.isEnabled = false;
					}

					this._target.dispatchEventWith(FeathersEventType.LONG_PRESS);
				}
			}
		}
	}
}


================================================
FILE: source/feathers/utils/touch/TapToEvent.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.touch
{
	import flash.geom.Point;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Stage;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * Dispatches an event from the target when the target is tapped/clicked.
	 * Conveniently handles all <code>TouchEvent</code> listeners
	 * automatically.
	 *
	 * <p>In the following example, a custom item renderer will be triggered
	 * when tapped:</p>
	 *
	 * <listing version="3.0">
	 * public class CustomItemRenderer extends LayoutGroupListItemRenderer
	 * {
	 *     public function CustomItemRenderer()
	 *     {
	 *         super();
	 *         this._tapToEvent = new TapToEvent(this, Event.TRIGGERED);
	 *     }
	 * 
	 *     private var _tapToEvent:TapToEvent;
	 * }</listing>
	 *
	 * @see feathers.utils.touch.TapToTrigger
	 * @see feathers.utils.touch.TapToSelect
	 * @see feathers.utils.touch.LongPress
	 *
	 * @productversion Feathers 3.4.0
	 */
	public class TapToEvent
	{
		/**
		 * Constructor.
		 */
		public function TapToEvent(target:DisplayObject = null, eventType:String = null)
		{
			this.target = target;
			this.eventType = eventType;
		}

		/**
		 * @private
		 */
		protected var _target:DisplayObject;

		/**
		 * The target component that should dispatch the <code>eventType</code>
		 * when tapped.
		 */
		public function get target():DisplayObject
		{
			return this._target;
		}

		/**
		 * @private
		 */
		public function set target(value:DisplayObject):void
		{
			if(this._target == value)
			{
				return;
			}
			if(this._target)
			{
				this._target.removeEventListener(TouchEvent.TOUCH, target_touchHandler);
			}
			this._target = value;
			if(this._target)
			{
				//if we're changing targets, and a touch is active, we want to
				//clear it.
				this._touchPointID = -1;
				this._target.addEventListener(TouchEvent.TOUCH, target_touchHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _eventType:String = null;

		/**
		 * The event type that will be dispatched when tapped.
		 */
		public function get eventType():String
		{
			return this._eventType;
		}

		/**
		 * @private
		 */
		public function set eventType(value:String):void
		{
			this._eventType = value;
		}

		/**
		 * @private
		 */
		protected var _touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _isEnabled:Boolean = true;

		/**
		 * May be set to <code>false</code> to disable the event dispatching
		 * temporarily until set back to <code>true</code>.
		 */
		public function get isEnabled():Boolean
		{
			return this._isEnabled;
		}

		/**
		 * @private
		 */
		public function set isEnabled(value:Boolean):void
		{
			if(this._isEnabled === value)
			{
				return;
			}
			this._isEnabled = value;
			if(!value)
			{
				this._touchPointID = -1;
			}
		}

		/**
		 * @private
		 */
		protected var _tapCount:int = -1;

		/**
		 * The number of times a component must be tapped before the event will
		 * be dispatched. If the value of <code>tapCount</code> is <code>-1</code>,
		 * the event will be dispatched for every tap.
		 */
		public function get tapCount():int
		{
			return this._tapCount;
		}

		/**
		 * @private
		 */
		public function set tapCount(value:int):void
		{
			this._tapCount = value;
		}

		/**
		 * @private
		 */
		protected var _customHitTest:Function;

		/**
		 * In addition to a normal call to <code>hitTest()</code>, a custom
		 * function may impose additional rules that determine if the target
		 * should be dispatch an event. Called on <code>TouchPhase.BEGAN</code>.
		 *
		 * <p>The function must have the following signature:</p>
		 *
		 * <pre>function(localPosition:Point):Boolean;</pre>
		 *
		 * <p>The function should return <code>true</code> if the target should
		 * dispatch an event, and <code>false</code> if it should not dispatch.</p>
		 */
		public function get customHitTest():Function
		{
			return this._customHitTest;
		}

		/**
		 * @private
		 */
		public function set customHitTest(value:Function):void
		{
			this._customHitTest = value;
		}

		/**
		 * @private
		 */
		protected function target_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._touchPointID = -1;
				return;
			}

			if(this._touchPointID >= 0)
			{
				//a touch has begun, so we'll ignore all other touches.
				var touch:Touch = event.getTouch(this._target, null, this._touchPointID);
				if(!touch)
				{
					//this should not happen.
					return;
				}

				if(touch.phase == TouchPhase.ENDED)
				{
					var stage:Stage = this._target.stage;
					if(stage !== null)
					{
						var point:Point = Pool.getPoint();
						touch.getLocation(stage, point);
						if(this._target is DisplayObjectContainer)
						{
							var isInBounds:Boolean = DisplayObjectContainer(this._target).contains(stage.hitTest(point));
						}
						else
						{
							isInBounds = this._target === stage.hitTest(point);
						}
						Pool.putPoint(point);
						if(isInBounds && (this._tapCount == -1 || this._tapCount == touch.tapCount))
						{
							this._target.dispatchEventWith(this._eventType);
						}
					}

					//the touch has ended, so now we can start watching for a
					//new one.
					this._touchPointID = -1;
				}
				return;
			}
			else
			{
				//we aren't tracking another touch, so let's look for a new one.
				touch = event.getTouch(DisplayObject(this._target), TouchPhase.BEGAN);
				if(!touch)
				{
					//we only care about the began phase. ignore all other
					//phases when we don't have a saved touch ID.
					return;
				}
				if(this._customHitTest !== null)
				{
					point = Pool.getPoint();
					touch.getLocation(DisplayObject(this._target), point);
					isInBounds = this._customHitTest(point);
					Pool.putPoint(point);
					if(!isInBounds)
					{
						return;
					}
				}

				//save the touch ID so that we can track this touch's phases.
				this._touchPointID = touch.id;
			}
		}
	}
}

================================================
FILE: source/feathers/utils/touch/TapToSelect.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.touch
{
	import feathers.core.IToggle;

	import flash.geom.Point;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Stage;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * Changes the <code>isSelected</code> property of the target when the
	 * target is tapped (which will dispatch <code>Event.CHANGE</code>).
	 * Conveniently handles all <code>TouchEvent</code> listeners automatically.
	 * Useful for custom item renderers that should be selected when tapped.
	 *
	 * <p>In the following example, a custom item renderer will be selected when
	 * tapped:</p>
	 *
	 * <listing version="3.0">
	 * public class CustomItemRenderer extends LayoutGroupListItemRenderer
	 * {
	 *     public function CustomItemRenderer()
	 *     {
	 *         super();
	 *         this._tapToSelect = new TapToSelect(this);
	 *     }
	 * 
	 *     private var _tapToSelect:TapToSelect;
	 * }</listing>
	 *
	 * <p>Note: When combined with a <code>TapToTrigger</code> instance, the
	 * <code>TapToSelect</code> instance should be created second because
	 * <code>Event.TRIGGERED</code> should be dispatched before
	 * <code>Event.CHANGE</code>.</p>
	 *
	 * @see feathers.utils.touch.TapToTrigger
	 * @see feathers.utils.touch.LongPress
	 *
	 * @productversion Feathers 2.3.0
	 */
	public class TapToSelect
	{
		/**
		 * Constructor.
		 */
		public function TapToSelect(target:IToggle = null)
		{
			this.target = target;
		}

		/**
		 * @private
		 */
		protected var _target:IToggle;

		/**
		 * The target component that should be selected when tapped.
		 */
		public function get target():IToggle
		{
			return this._target;
		}

		/**
		 * @private
		 */
		public function set target(value:IToggle):void
		{
			if(this._target == value)
			{
				return;
			}
			if(this._target)
			{
				this._target.removeEventListener(TouchEvent.TOUCH, target_touchHandler);
			}
			this._target = value;
			if(this._target)
			{
				//if we're changing targets, and a touch is active, we want to
				//clear it.
				this._touchPointID = -1;
				this._target.addEventListener(TouchEvent.TOUCH, target_touchHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _isEnabled:Boolean = true;

		/**
		 * May be set to <code>false</code> to disable selection temporarily
		 * until set back to <code>true</code>.
		 */
		public function get isEnabled():Boolean
		{
			return this._isEnabled;
		}

		/**
		 * @private
		 */
		public function set isEnabled(value:Boolean):void
		{
			if(this._isEnabled === value)
			{
				return;
			}
			this._isEnabled = value;
			if(!value)
			{
				this._touchPointID = -1;
			}
		}

		/**
		 * @private
		 */
		protected var _tapToDeselect:Boolean = false;

		/**
		 * May be set to <code>true</code> to allow the target to be deselected
		 * when tapped.
		 */
		public function get tapToDeselect():Boolean
		{
			return this._tapToDeselect;
		}

		/**
		 * @private
		 */
		public function set tapToDeselect(value:Boolean):void
		{
			this._tapToDeselect = value;
		}

		/**
		 * @private
		 */
		protected var _customHitTest:Function;

		/**
		 * In addition to a normal call to <code>hitTest()</code>, a custom
		 * function may impose additional rules that determine if the target
		 * should be selected. Called on <code>TouchPhase.BEGAN</code>.
		 *
		 * <p>The function must have the following signature:</p>
		 *
		 * <pre>function(localPosition:Point):Boolean;</pre>
		 *
		 * <p>The function should return <code>true</code> if the target should
		 * be selected, and <code>false</code> if it should not be selected.</p>
		 */
		public function get customHitTest():Function
		{
			return this._customHitTest;
		}

		/**
		 * @private
		 */
		public function set customHitTest(value:Function):void
		{
			this._customHitTest = value;
		}

		/**
		 * @private
		 */
		protected function target_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._touchPointID = -1;
				return;
			}

			if(this._touchPointID >= 0)
			{
				//a touch has begun, so we'll ignore all other touches.
				var touch:Touch = event.getTouch(DisplayObject(this._target), null, this._touchPointID);
				if(!touch)
				{
					//this should not happen.
					return;
				}

				if(touch.phase == TouchPhase.ENDED)
				{
					var stage:Stage = this._target.stage;
					if(stage !== null)
					{
						var point:Point = Pool.getPoint();
						touch.getLocation(stage, point);
						if(this._target is DisplayObjectContainer)
						{
							var isInBounds:Boolean = DisplayObjectContainer(this._target).contains(stage.hitTest(point));
						}
						else
						{
							isInBounds = this._target === stage.hitTest(point);
						}
						Pool.putPoint(point);
						if(isInBounds)
						{
							if(this._tapToDeselect)
							{
								this._target.isSelected = !this._target.isSelected;
							}
							else
							{
								this._target.isSelected = true;
							}
						}
					}

					//the touch has ended, so now we can start watching for a
					//new one.
					this._touchPointID = -1;
				}
				return;
			}
			else
			{
				//we aren't tracking another touch, so let's look for a new one.
				touch = event.getTouch(DisplayObject(this._target), TouchPhase.BEGAN);
				if(!touch)
				{
					//we only care about the began phase. ignore all other
					//phases when we don't have a saved touch ID.
					return;
				}
				if(this._customHitTest !== null)
				{
					point = Pool.getPoint();
					touch.getLocation(DisplayObject(this._target), point);
					isInBounds = this._customHitTest(point);
					Pool.putPoint(point);
					if(!isInBounds)
					{
						return;
					}
				}

				//save the touch ID so that we can track this touch's phases.
				this._touchPointID = touch.id;
			}
		}
	}
}

================================================
FILE: source/feathers/utils/touch/TapToTrigger.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.touch
{
	import starling.display.DisplayObject;
	import starling.events.Event;

	/**
	 * Dispatches <code>Event.TRIGGERED</code> from the target when the target
	 * is tapped. Conveniently handles all <code>TouchEvent</code> listeners
	 * automatically. Useful for custom item renderers that should be triggered
	 * when tapped.
	 *
	 * <p>In the following example, a custom item renderer will be triggered
	 * when tapped:</p>
	 *
	 * <listing version="3.0">
	 * public class CustomItemRenderer extends LayoutGroupListItemRenderer
	 * {
	 *     public function CustomItemRenderer()
	 *     {
	 *         super();
	 *         this._tapToTrigger = new TapToTrigger(this);
	 *     }
	 * 
	 *     private var _tapToTrigger:TapToTrigger;
	 * }</listing>
	 *
	 * <p>Note: When combined with a <code>TapToSelect</code> instance, the
	 * <code>TapToTrigger</code> instance should be created first because
	 * <code>Event.TRIGGERED</code> should be dispatched before
	 * <code>Event.CHANGE</code>.</p>
	 *
	 * @see http://doc.starling-framework.org/current/starling/events/Event.html#TRIGGERED starling.events.Event.TRIGGERED
	 * @see feathers.utils.touch.TapToSelect
	 * @see feathers.utils.touch.LongPress
	 *
	 * @productversion Feathers 2.3.0
	 */
	public class TapToTrigger extends TapToEvent
	{
		/**
		 * Constructor.
		 */
		public function TapToTrigger(target:DisplayObject = null)
		{
			super(target, Event.TRIGGERED);
		}
	}
}

================================================
FILE: source/feathers/utils/touch/TouchToState.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.touch
{
	import feathers.controls.ButtonState;
	import feathers.core.IStateContext;

	import flash.geom.Point;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Stage;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.utils.Pool;

	/**
	 * Changes a target's state based on the <code>TouchPhase</code> when the
	 * target is touched. Conveniently handles all <code>TouchEvent</code> listeners
	 * automatically. Useful for custom item renderers that should be change
	 * state based on touch.
	 *
	 * @see feathers.utils.keyboard.KeyToState
	 *
	 * @productversion Feathers 3.2.0
	 */
	public class TouchToState
	{
		/**
		 * Constructor.
		 */
		public function TouchToState(target:DisplayObject = null, callback:Function = null)
		{
			this.target = target;
			this.callback = callback;
		}

		/**
		 * @private
		 */
		protected var _target:DisplayObject;

		/**
		 * The target component that should change state based on touch phases.
		 */
		public function get target():DisplayObject
		{
			return this._target;
		}

		/**
		 * @private
		 */
		public function set target(value:DisplayObject):void
		{
			if(this._target == value)
			{
				return;
			}
			if(this._target !== null)
			{
				this._target.removeEventListener(TouchEvent.TOUCH, target_touchHandler);
				this._target.removeEventListener(Event.REMOVED_FROM_STAGE, target_removedFromStageHandler);
			}
			this._target = value;
			if(this._target !== null)
			{
				//if we're changing targets, and a touch is active, we want to
				//clear it.
				this._touchPointID = -1;
				//then restore to the default state
				this._currentState = this._upState;
				this._target.addEventListener(TouchEvent.TOUCH, target_touchHandler);
				this._target.addEventListener(Event.REMOVED_FROM_STAGE, target_removedFromStageHandler);
			}
		}

		/**
		 * @private
		 */
		protected var _callback:Function;

		/**
		 * The function to call when the state is changed.
		 *
		 * <p>The callback is expected to have the following signature:</p>
		 * <pre>function(currentState:String):void</pre>
		 */
		public function get callback():Function
		{
			return this._callback;
		}

		/**
		 * @private
		 */
		public function set callback(value:Function):void
		{
			if(this._callback === value)
			{
				return;
			}
			this._callback = value;
			if(this._callback !== null)
			{
				this._callback(this._currentState);
			}
		}

		/**
		 * @private
		 */
		protected var _currentState:String = ButtonState.UP;

		/**
		 * The current state of the utility. May be different than the state
		 * of the target.
		 */
		public function get currentState():String
		{
			return this._currentState;
		}

		/**
		 * @private
		 */
		protected var _upState:String = ButtonState.UP;

		/**
		 * The value for the "up" state.
		 *
		 * @default feathers.controls.ButtonState.UP
		 */
		public function get upState():String
		{
			return this._upState;
		}

		/**
		 * @private
		 */
		public function set upState(value:String):void
		{
			this._upState = value;
		}

		/**
		 * @private
		 */
		protected var _downState:String = ButtonState.DOWN;

		/**
		 * The value for the "down" state.
		 *
		 * @default feathers.controls.ButtonState.DOWN
		 */
		public function get downState():String
		{
			return this._downState;
		}

		/**
		 * @private
		 */
		public function set downState(value:String):void
		{
			this._downState = value;
		}

		/**
		 * @private
		 */
		protected var _hoverState:String = ButtonState.HOVER;

		/**
		 * The value for the "hover" state.
		 *
		 * @default feathers.controls.ButtonState.HOVER
		 */
		public function get hoverState():String
		{
			return this._hoverState;
		}

		/**
		 * @private
		 */
		public function set hoverState(value:String):void
		{
			this._hoverState = value;
		}

		/**
		 * @private
		 */
		protected var _touchPointID:int = -1;

		/**
		 * @private
		 */
		protected var _isEnabled:Boolean = true;

		/**
		 * May be set to <code>false</code> to disable the state changes
		 * temporarily until set back to <code>true</code>.
		 */
		public function get isEnabled():Boolean
		{
			return this._isEnabled;
		}

		/**
		 * @private
		 */
		public function set isEnabled(value:Boolean):void
		{
			if(this._isEnabled === value)
			{
				return;
			}
			this._isEnabled = value;
			if(!value)
			{
				this._touchPointID = -1;
			}
		}

		/**
		 * @private
		 */
		protected var _customHitTest:Function;

		/**
		 * In addition to a normal call to <code>hitTest()</code>, a custom
		 * function may impose additional rules that determine if the target
		 * should change state. Called on <code>TouchPhase.BEGAN</code>.
		 *
		 * <p>The function must have the following signature:</p>
		 *
		 * <pre>function(localPosition:Point):Boolean;</pre>
		 *
		 * <p>The function should return <code>true</code> if the target should
		 * be triggered, and <code>false</code> if it should not be
		 * triggered.</p>
		 */
		public function get customHitTest():Function
		{
			return this._customHitTest;
		}

		/**
		 * @private
		 */
		public function set customHitTest(value:Function):void
		{
			this._customHitTest = value;
		}

		/**
		 * @private
		 */
		protected var _hoverBeforeBegan:Boolean = false;

		/**
		 * @private
		 */
		protected var _keepDownStateOnRollOut:Boolean = false;

		/**
		 * If <code>true</code>, the button state will remain as
		 * <code>downState</code> until <code>TouchPhase.ENDED</code>. If
		 * <code>false</code>, and the touch leaves the bounds of the button
		 * after <code>TouchPhase.BEGAN</code>, the button state will change to
		 * <code>upState</code>.
		 *
		 * @default false
		 */
		public function get keepDownStateOnRollOut():Boolean
		{
			return this._keepDownStateOnRollOut;
		}

		/**
		 * @private
		 */
		public function set keepDownStateOnRollOut(value:Boolean):void
		{
			this._keepDownStateOnRollOut = value;
		}

		/**
		 * @private
		 */
		protected function handleCustomHitTest(touch:Touch):Boolean
		{
			if(this._customHitTest === null)
			{
				return true;
			}
			var point:Point = Pool.getPoint();
			touch.getLocation(DisplayObject(this._target), point);
			var isInBounds:Boolean = this._customHitTest(point);
			Pool.putPoint(point);
			return isInBounds;
		}

		/**
		 * @private
		 */
		protected function changeState(value:String):void
		{
			var oldState:String = this._currentState;
			if(this._target is IStateContext)
			{
				oldState = IStateContext(this._target).currentState;
			}
			this._currentState = value;
			if(oldState === value)
			{
				return;
			}
			if(this._callback !== null)
			{
				this._callback(value);
			}
		}

		/**
		 * @private
		 */
		protected function resetTouchState():void
		{
			this._hoverBeforeBegan = false;
			this._touchPointID = -1;
			this.changeState(this._upState);
		}

		/**
		 * @private
		 */
		protected function target_removedFromStageHandler(event:Event):void
		{
			this.resetTouchState();
		}

		/**
		 * @private
		 */
		protected function target_touchHandler(event:TouchEvent):void
		{
			if(!this._isEnabled)
			{
				this._touchPointID = -1;
				return;
			}

			if(this._touchPointID >= 0)
			{
				//a touch has begun, so we'll ignore all other touches.
				var touch:Touch = event.getTouch(this._target, null, this._touchPointID);
				if(!touch)
				{
					return;
				}

				var stage:Stage = this._target.stage;
				if(stage !== null)
				{
					var point:Point = Pool.getPoint();
					touch.getLocation(stage, point);
					if(this._target is DisplayObjectContainer)
					{
						var isInBounds:Boolean = DisplayObjectContainer(this._target).contains(stage.hitTest(point));
					}
					else
					{
						isInBounds = this._target === stage.hitTest(point);
					}
					isInBounds &&= this.handleCustomHitTest(touch);
					Pool.putPoint(point);
					if(touch.phase === TouchPhase.MOVED)
					{
						if(this._keepDownStateOnRollOut)
						{
							//nothing to change!
							return;
						}
						if(isInBounds)
						{
							this.changeState(this._downState);
							return;
						}
						else
						{
							this.changeState(this._upState);
							return;
						}
					}
					else if(touch.phase === TouchPhase.ENDED)
					{
						if(isInBounds && this._hoverBeforeBegan)
						{
							//if the mouse is over the target on ended, return
							//to the hover state, but only if there was a hover
							//state before began.
							//this ensures that the hover state is not
							//unexpectedly entered on a touch screen.
							this._touchPointID = -1;
							this.changeState(this._hoverState);
						}
						else
						{
							this.resetTouchState();
						}
						return;
					}
				}
			}
			else
			{
				//we aren't tracking another touch, so let's look for a new one.
				touch = event.getTouch(this._target, TouchPhase.BEGAN);
				if(touch !== null && this.handleCustomHitTest(touch))
				{
					this.changeState(this._downState);
					this._touchPointID = touch.id;
					return;
				}
				touch = event.getTouch(this._target, TouchPhase.HOVER);
				if(touch !== null && this.handleCustomHitTest(touch))
				{
					this._hoverBeforeBegan = true;
					this.changeState(this._hoverState);
					return;
				}

				//end of hover
				this.changeState(this._upState);
			}
		}
	}
}

================================================
FILE: source/feathers/utils/xml/xmlListInsertAt.as
================================================
/*
Feathers
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

This program is free software. You can redistribute and/or modify it in
accordance with the terms of the accompanying license agreement.
*/
package feathers.utils.xml
{
	/**
	 * Adds an XML value to an XMLList at a specific index.
	 *
	 * @productversion Feathers 3.3.0
	 */
	public function xmlListInsertAt(xmlList:XMLList, index:int, xmlToInsert:XML):XMLList
	{
		var listLength:int = xmlList.length();
		//we can't use insertChildAfter() or insertChildAfter() directly on
		//the XMLList, so we add it to an XML and insert there instead
		var wrapper:XML = <wrapper/>;
		wrapper.appendChild(xmlList);
		if(index == listLength)
		{
			var lastItem:XML = xmlList[index - 1];
			wrapper.insertChildAfter(lastItem, xmlToInsert);
		}
		else
		{
			var currentItem:XML = xmlList[index];
			wrapper.insertChildBefore(currentItem, xmlToInsert);
		}
		return wrapper.elements();
	}
}

================================================
FILE: test/source/TestFeathers-app.xml
================================================
<?xml version="1.0" encoding="utf-8" standalone="no"?>
<application xmlns="http://ns.adobe.com/air/application/32.0">
	<id>com.feathersui.TestFeathers</id>
	<filename>TestFeathers</filename>
	<name>TestFeathers</name>
	<versionNumber>1.0.0</versionNumber>
	<description>Test runner for Feathers UI controls for Starling</description>
	<copyright>2021 Bowler Hat LLC</copyright>

	<initialWindow>
		<content>TestFeathers.swf</content>
		<autoOrients>true</autoOrients>
		<fullScreen>false</fullScreen>
		<visible>true</visible>
		<renderMode>direct</renderMode>
	</initialWindow>

	<supportedLanguages>en</supportedLanguages>
</application>

================================================
FILE: test/source/TestFeathers.as
================================================
package
{
	import feathers.tests.AddOnFunctionStyleProviderTests;
	import feathers.tests.AlertMeasurementTests;
	import feathers.tests.AnchorLayoutTests;
	import feathers.tests.ArrayCollectionTests;
	import feathers.tests.ArrayHierarchicalCollectionTests;
	import feathers.tests.BasicButtonInternalStateTests;
	import feathers.tests.BasicButtonMeasurementTests;
	import feathers.tests.BasicButtonTests;
	import feathers.tests.BitmapFontTextEditorFocusTests;
	import feathers.tests.BitmapFontTextRendererTests;
	import feathers.tests.BottomDrawerPopUpContentManagerTests;
	import feathers.tests.ButtonFocusTests;
	import feathers.tests.ButtonGroupDataProviderEventsTests;
	import feathers.tests.ButtonGroupMeasurementTests;
	import feathers.tests.ButtonGroupTests;
	import feathers.tests.ButtonInternalStateTests;
	import feathers.tests.ButtonMeasurementTests;
	import feathers.tests.ButtonTests;
	import feathers.tests.CalloutMeasurementTests;
	import feathers.tests.CalloutPopUpContentManagerTests;
	import feathers.tests.CalloutTests;
	import feathers.tests.ComponentLifecycleTests;
	import feathers.tests.ConditionalStyleProviderTests;
	import feathers.tests.DateTimeSpinnerTests;
	import feathers.tests.DefaultGroupedListHeaderOrFooterRendererMeasurementTests;
	import feathers.tests.DefaultListItemRendererInternalStateTests;
	import feathers.tests.DefaultListItemRendererMeasurementTests;
	import feathers.tests.DrawersMeasurementTests;
	import feathers.tests.DrawersTests;
	import feathers.tests.DropDownPopUpContentManagerTests;
	import feathers.tests.FlowLayoutTests;
	import feathers.tests.FocusIndicatorTests;
	import feathers.tests.FocusManagerEnabledTests;
	import feathers.tests.FocusManagerTests;
	import feathers.tests.FontStylesSetTests;
	import feathers.tests.FunctionStyleProviderTests;
	import feathers.tests.GroupedListDataProviderTests;
	import feathers.tests.GroupedListFactoryIDFunctionTests;
	import feathers.tests.GroupedListFocusTests;
	import feathers.tests.GroupedListRendererAddRemoveTests;
	import feathers.tests.GroupedListTests;
	import feathers.tests.HeaderInternalStateTests;
	import feathers.tests.HeaderMeasurementTests;
	import feathers.tests.HeaderTests;
	import feathers.tests.HierarchicalCollectionTests;
	import feathers.tests.HorizontalLayoutTests;
	import feathers.tests.HorizontalSpinnerLayoutTests;
	import feathers.tests.ImageLoaderInternalStateTests;
	import feathers.tests.ImageLoaderTests;
	import feathers.tests.ImageSkinTests;
	import feathers.tests.InvalidateTests;
	import feathers.tests.KeyToSelectTests;
	import feathers.tests.KeyToTriggerTests;
	import feathers.tests.LabelMeasurementTests;
	import feathers.tests.LabelTests;
	import feathers.tests.LayoutGroupHorizontalLayoutTests;
	import feathers.tests.LayoutGroupInternalStateTests;
	import feathers.tests.LayoutGroupMeasurementTests;
	import feathers.tests.LayoutGroupTests;
	import feathers.tests.LayoutGroupValidationTests;
	import feathers.tests.LayoutGroupVerticalLayoutTests;
	import feathers.tests.ListCollectionFilterTests;
	import feathers.tests.ListCollectionWithArrayTests;
	import feathers.tests.ListFactoryIDFunctionTests;
	import feathers.tests.ListFocusTests;
	import feathers.tests.ListRendererAddRemoveTests;
	import feathers.tests.ListTests;
	import feathers.tests.LongPressTests;
	import feathers.tests.MinAndMaxDimensionsTests;
	import feathers.tests.NumericStepperMeasurementTests;
	import feathers.tests.PageIndicatorMeasurementTests;
	import feathers.tests.PanelMeasurementTests;
	import feathers.tests.PickerListMeasurementTests;
	import feathers.tests.PickerListTests;
	import feathers.tests.PopUpManagerFocusManagerTests;
	import feathers.tests.PopUpManagerTests;
	import feathers.tests.ProgressBarMeasurementTests;
	import feathers.tests.ProgressBarTests;
	import feathers.tests.RadioTests;
	import feathers.tests.RestrictedStyleTests;
	import feathers.tests.ScaleTests;
	import feathers.tests.ScreenNavigatorMeasurementTests;
	import feathers.tests.ScreenNavigatorTests;
	import feathers.tests.ScrollBarHorizontalMeasurementTests;
	import feathers.tests.ScrollBarHorizontalTests;
	import feathers.tests.ScrollBarVerticalMeasurementTests;
	import feathers.tests.ScrollContainerMeasurementTests;
	import feathers.tests.ScrollContainerTests;
	import feathers.tests.ScrollContainerValidationTests;
	import feathers.tests.ScrollerMeasurementTests;
	import feathers.tests.ScrollerTests;
	import feathers.tests.SimpleScrollBarHorizontalTests;
	import feathers.tests.SimpleScrollBarMeasurementTests;
	import feathers.tests.SlideShowLayoutTests;
	import feathers.tests.SliderHorizontalMeasurementTests;
	import feathers.tests.SliderHorizontalTests;
	import feathers.tests.SliderVerticalMeasurementTests;
	import feathers.tests.SpinnerListTests;
	import feathers.tests.StackScreenNavigatorMeasurementTests;
	import feathers.tests.StackScreenNavigatorTests;
	import feathers.tests.StageTextTextEditorFocusTests;
	import feathers.tests.StyleNameFunctionStyleProviderTests;
	import feathers.tests.StyleProviderRegistryTests;
	import feathers.tests.StyleTests;
	import feathers.tests.TabBarEmptyDataProviderTests;
	import feathers.tests.TabBarMeasurementTests;
	import feathers.tests.TabBarTests;
	import feathers.tests.TabNavigatorTests;
	import feathers.tests.TapToSelectTests;
	import feathers.tests.TapToTriggerTests;
	import feathers.tests.TextAreaFocusTests;
	import feathers.tests.TextAreaInternalStateTests;
	import feathers.tests.TextAreaTests;
	import feathers.tests.TextBlockTextEditorFocusTests;
	import feathers.tests.TextBlockTextRendererTests;
	import feathers.tests.TextFieldTextEditorFocusTests;
	import feathers.tests.TextFieldTextEditorTests;
	import feathers.tests.TextFieldTextRendererTests;
	import feathers.tests.TextInputFocusTests;
	import feathers.tests.TextInputInternalStateTests;
	import feathers.tests.TextInputMeasurementTests;
	import feathers.tests.TextInputRestrictTests;
	import feathers.tests.TextInputTests;
	import feathers.tests.TextureCacheTests;
	import feathers.tests.TiledColumnsLayoutTests;
	import feathers.tests.TiledRowsLayoutTests;
	import feathers.tests.TimeLabelTests;
	import feathers.tests.ToggleButtonFocusTests;
	import feathers.tests.ToggleButtonInternalStateTests;
	import feathers.tests.ToggleButtonTests;
	import feathers.tests.ToggleGroupTests;
	import feathers.tests.ToggleSwitchMeasurementTests;
	import feathers.tests.ToggleSwitchTests;
	import feathers.tests.TokenListTests;
	import feathers.tests.TouchToStateTests;
	import feathers.tests.TreeFocusTests;
	import feathers.tests.TreeTests;
	import feathers.tests.VectorCollectionTests;
	import feathers.tests.VectorHierarchicalCollectionTests;
	import feathers.tests.VerticalCenteredPopUpContentManagerTests;
	import feathers.tests.VerticalLayoutTests;
	import feathers.tests.VerticalSpinnerLayoutTests;
	import feathers.tests.XMLListCollectionTests;
	import feathers.tests.XMLListHierarchicalCollectionTests;
	import feathers.tests.XMLListInsertAtTests;

	import flash.display.Sprite;
	import flash.display.StageAlign;
	import flash.display.StageScaleMode;
	import flash.events.Event;
	import flash.system.Capabilities;
	import flash.system.fscommand;
	import flash.utils.getDefinitionByName;

	import org.flexunit.internals.TraceListener;
	import org.flexunit.listeners.CIListener;
	import org.flexunit.runner.FlexUnitCore;

	import starling.core.Starling;
	import starling.display.Sprite;
	import starling.events.Event;

	[SWF(width="960",height="640",frameRate="60",backgroundColor="#4a4137")]
	public class TestFeathers extends flash.display.Sprite
	{
		public static var starlingRoot:starling.display.Sprite;

		public function TestFeathers()
		{
			if(this.stage)
			{
				this.stage.align = StageAlign.TOP_LEFT;
				this.stage.scaleMode = StageScaleMode.NO_SCALE;
			}

			this.loaderInfo.addEventListener(flash.events.Event.COMPLETE, loaderInfo_completeHandler);
		}

		private var _starling:Starling;
		private var _flexunit:FlexUnitCore;

		private function loaderInfo_completeHandler(event:flash.events.Event):void
		{
			Starling.multitouchEnabled = true;
			this._starling = new Starling(starling.display.Sprite, this.stage);
			this._starling.addEventListener(starling.events.Event.ROOT_CREATED, starling_rootCreatedHandler);
			this._starling.start();
		}

		private function starling_rootCreatedHandler(event:starling.events.Event):void
		{
			starlingRoot = starling.display.Sprite(this._starling.root);
			this._flexunit = new FlexUnitCore();
			this._flexunit.addListener(new TraceListener());
			this._flexunit.addListener(new CIListener());
			this._flexunit.addEventListener(FlexUnitCore.TESTS_COMPLETE, flexunit_testsCompleteHandler);
			this._flexunit.run(
			[
				//general component tests
				InvalidateTests,
				MinAndMaxDimensionsTests,
				ComponentLifecycleTests,
				ScaleTests,
				StyleTests,
				RestrictedStyleTests,
				FocusIndicatorTests,

				//individual component tests
				AlertMeasurementTests,
				BasicButtonTests,
				BasicButtonMeasurementTests,
				BasicButtonInternalStateTests,
				ButtonTests,
				ButtonInternalStateTests,
				ButtonFocusTests,
				ButtonMeasurementTests,
				ButtonGroupTests,
				ButtonGroupMeasurementTests,
				ButtonGroupDataProviderEventsTests,
				CalloutTests,
				CalloutMeasurementTests,
				DateTimeSpinnerTests,
				DefaultGroupedListHeaderOrFooterRendererMeasurementTests,
				DefaultListItemRendererMeasurementTests,
				DefaultListItemRendererInternalStateTests,
				DrawersTests,
				DrawersMeasurementTests,
				GroupedListTests,
				GroupedListFocusTests,
				GroupedListDataProviderTests,
				GroupedListFactoryIDFunctionTests,
				GroupedListRendererAddRemoveTests,
				HeaderTests,
				HeaderMeasurementTests,
				HeaderInternalStateTests,
				ImageLoaderTests,
				ImageLoaderInternalStateTests,
				LabelTests,
				LabelMeasurementTests,
				LayoutGroupTests,
				LayoutGroupInternalStateTests,
				LayoutGroupMeasurementTests,
				LayoutGroupValidationTests,
				ListTests,
				ListFocusTests,
				ListFactoryIDFunctionTests,
				ListRendererAddRemoveTests,
				NumericStepperMeasurementTests,
				PageIndicatorMeasurementTests,
				PanelMeasurementTests,
				PickerListTests,
				PickerListMeasurementTests,
				ProgressBarTests,
				ProgressBarMeasurementTests,
				RadioTests,
				SimpleScrollBarHorizontalTests,
				SimpleScrollBarMeasurementTests,
				ScreenNavigatorTests,
				ScreenNavigatorMeasurementTests,
				ScrollBarHorizontalTests,
				ScrollBarHorizontalMeasurementTests,
				ScrollBarVerticalMeasurementTests,
				ScrollContainerTests,
				ScrollContainerMeasurementTests,
				ScrollContainerValidationTests,
				ScrollerTests,
				ScrollerMeasurementTests,
				SliderHorizontalTests,
				SliderHorizontalMeasurementTests,
				SliderVerticalMeasurementTests,
				SpinnerListTests,
				StackScreenNavigatorTests,
				StackScreenNavigatorMeasurementTests,
				TabBarTests,
				TabBarMeasurementTests,
				TabBarEmptyDataProviderTests,
				TabNavigatorTests,
				TextAreaTests,
				TextAreaInternalStateTests,
				TextInputTests,
				TextInputMeasurementTests,
				TextInputInternalStateTests,
				ToggleButtonTests,
				ToggleButtonInternalStateTests,
				ToggleButtonFocusTests,
				ToggleGroupTests,
				ToggleSwitchTests,
				ToggleSwitchMeasurementTests,
				TreeTests,
				TreeFocusTests,

				//media tests
				TimeLabelTests,

				//layout tests
				AnchorLayoutTests,
				FlowLayoutTests,
				LayoutGroupHorizontalLayoutTests,
				LayoutGroupVerticalLayoutTests,
				TiledRowsLayoutTests,
				TiledColumnsLayoutTests,
				HorizontalLayoutTests,
				VerticalLayoutTests,
				HorizontalSpinnerLayoutTests,
				VerticalSpinnerLayoutTests,
				SlideShowLayoutTests,

				//collections tests
				ListCollectionWithArrayTests,
				ListCollectionFilterTests,
				ArrayCollectionTests,
				VectorCollectionTests,
				XMLListCollectionTests,
				HierarchicalCollectionTests,
				ArrayHierarchicalCollectionTests,
				VectorHierarchicalCollectionTests,
				XMLListHierarchicalCollectionTests,

				//text renderers
				BitmapFontTextRendererTests,
				TextBlockTextRendererTests,
				TextFieldTextRendererTests,

				//text editors
				TextFieldTextEditorTests,

				//focus tests
				FocusManagerEnabledTests,
				FocusManagerTests,
				PopUpManagerFocusManagerTests,
				TextInputFocusTests,
				TextAreaFocusTests,
				StageTextTextEditorFocusTests,
				TextFieldTextEditorFocusTests,
				BitmapFontTextEditorFocusTests,
				TextBlockTextEditorFocusTests,

				//style providers and themes
				ConditionalStyleProviderTests,
				FunctionStyleProviderTests,
				StyleNameFunctionStyleProviderTests,
				AddOnFunctionStyleProviderTests,
				StyleProviderRegistryTests,

				//misc
				PopUpManagerTests,
				TextureCacheTests,
				TapToTriggerTests,
				TapToSelectTests,
				LongPressTests,
				TouchToStateTests,
				KeyToSelectTests,
				KeyToTriggerTests,
				TokenListTests,
				ImageSkinTests,
				DropDownPopUpContentManagerTests,
				BottomDrawerPopUpContentManagerTests,
				VerticalCenteredPopUpContentManagerTests,
				CalloutPopUpContentManagerTests,
				XMLListInsertAtTests,
				FontStylesSetTests,
				TextInputRestrictTests,
			]);
		}

		private function flexunit_testsCompleteHandler(event:flash.events.Event):void
		{
			if(Capabilities.playerType == "Desktop")
			{
				var NativeApplication:Class = Class(getDefinitionByName("flash.desktop.NativeApplication"));
				if(NativeApplication)
				{
					NativeApplication.nativeApplication.exit();
				}
			}
			else
			{
				fscommand("quit");
			}
		}

	}
}

================================================
FILE: test/source/feathers/tests/AddOnFunctionStyleProviderTests.as
================================================
package feathers.tests
{
	import feathers.controls.BasicButton;
	import feathers.core.IFeathersControl;
	import feathers.skins.AddOnFunctionStyleProvider;
	import feathers.tests.supportClasses.CustomStyleProvider;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class AddOnFunctionStyleProviderTests
	{
		private var _target:BasicButton;
		private var _styleProvider:AddOnFunctionStyleProvider;
		private var _otherStyleProvider:CustomStyleProvider;
		private var _afterFunctionCalled:Boolean;
		private var _beforeFunctionCalled:Boolean;

		[Before]
		public function prepare():void
		{
			this._afterFunctionCalled = false;
			this._beforeFunctionCalled = false;

			this._otherStyleProvider = new CustomStyleProvider();

			this._target = new BasicButton();
			this._target.defaultSkin = new Quad(200, 200, 0xff00ff);
		}

		[After]
		public function cleanup():void
		{
			this._target.removeFromParent(true);
			this._target = null;

			this._styleProvider = null;
			this._otherStyleProvider = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function afterFunction(target:IFeathersControl):void
		{
			this._afterFunctionCalled = true;
			if(this._styleProvider.originalStyleProvider !== null)
			{
				Assert.assertTrue("AddOnFunctionStyleProvider did not call originalStyleProvider.applyStyles() before addon function.", this._otherStyleProvider.appliedStyles);
			}
		}

		private function beforeFunction(target:IFeathersControl):void
		{
			this._beforeFunctionCalled = true;
			if(this._styleProvider.originalStyleProvider !== null)
			{
				Assert.assertFalse("AddOnFunctionStyleProvider called originalStyleProvider.applyStyles() before addon function.", this._otherStyleProvider.appliedStyles);
			}
		}

		[Test]
		public function testNullOriginalStyleProviderAndAfterFunction():void
		{
			this._styleProvider = new AddOnFunctionStyleProvider(null, afterFunction);
			this._styleProvider.callBeforeOriginalStyleProvider = false;
			this._styleProvider.applyStyles(this._target);
			Assert.assertFalse("AddOnFunctionStyleProvider incorrectly called originalStyleProvider.applyStyles()", this._otherStyleProvider.appliedStyles);
			Assert.assertTrue("AddOnFunctionStyleProvider did not call the after function after null originalStyleProvider", this._afterFunctionCalled);
		}

		[Test]
		public function testNullOriginalStyleProviderAndBeforeFunction():void
		{
			this._styleProvider = new AddOnFunctionStyleProvider(null, beforeFunction);
			this._styleProvider.callBeforeOriginalStyleProvider = true;
			this._styleProvider.applyStyles(this._target);
			Assert.assertFalse("AddOnFunctionStyleProvider incorrectly called originalStyleProvider.applyStyles()", this._otherStyleProvider.appliedStyles);
			Assert.assertTrue("AddOnFunctionStyleProvider did not call the before function after null originalStyleProvider", this._beforeFunctionCalled);
		}

		[Test]
		public function testBeforeFunctionCalled():void
		{
			this._styleProvider = new AddOnFunctionStyleProvider(this._otherStyleProvider, beforeFunction);
			this._styleProvider.callBeforeOriginalStyleProvider = true;
			this._styleProvider.applyStyles(this._target);
			Assert.assertTrue("AddOnFunctionStyleProvider must call originalStyleProvider.applyStyles()", this._otherStyleProvider.appliedStyles);
			Assert.assertTrue("AddOnFunctionStyleProvider must call the function", this._beforeFunctionCalled);
		}

		[Test]
		public function testAfterFunctionCalled():void
		{
			this._styleProvider = new AddOnFunctionStyleProvider(this._otherStyleProvider, afterFunction);
			this._styleProvider.callBeforeOriginalStyleProvider = false;
			this._styleProvider.applyStyles(this._target);
			Assert.assertTrue("AddOnFunctionStyleProvider must call originalStyleProvider.applyStyles()", this._otherStyleProvider.appliedStyles);
			Assert.assertTrue("AddOnFunctionStyleProvider must call the after function", this._afterFunctionCalled);
		}
	}
}


================================================
FILE: test/source/feathers/tests/AlertMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.Alert;
	import feathers.controls.Button;
	import feathers.controls.ButtonGroup;
	import feathers.controls.Header;
	import feathers.controls.LayoutGroup;
	import feathers.controls.text.BitmapFontTextRenderer;
	import feathers.data.ListCollection;
	import feathers.layout.Direction;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class AlertMeasurementTests
	{
		private static const BACKGROUND_WIDTH:Number = 200;
		private static const BACKGROUND_HEIGHT:Number = 250;

		private static const COMPLEX_BACKGROUND_WIDTH:Number = 340;
		private static const COMPLEX_BACKGROUND_HEIGHT:Number = 350;
		private static const COMPLEX_BACKGROUND_MIN_WIDTH:Number = 280;
		private static const COMPLEX_BACKGROUND_MIN_HEIGHT:Number = 290;

		private static const PADDING_TOP:Number = 50;
		private static const PADDING_RIGHT:Number = 54;
		private static const PADDING_BOTTOM:Number = 59;
		private static const PADDING_LEFT:Number = 60;

		private static const OUTER_PADDING_TOP:Number = 40;
		private static const OUTER_PADDING_RIGHT:Number = 64;
		private static const OUTER_PADDING_BOTTOM:Number = 69;
		private static const OUTER_PADDING_LEFT:Number = 50;

		private static const HEADER_WIDTH:Number = 150;
		private static const HEADER_HEIGHT:Number = 40;

		private static const LARGE_HEADER_WIDTH:Number = 550;

		private static const ICON_WIDTH:Number = 120;
		private static const ICON_HEIGHT:Number = 110;

		private static const BUTTON_WIDTH:Number = 160;
		private static const BUTTON_HEIGHT:Number = 30;
		
		private static const GAP:Number = 4;

		private var _alert:Alert;
		private var _textRenderer:BitmapFontTextRenderer;

		[Before]
		public function prepare():void
		{
			this._alert = new Alert();
			this._alert.footerFactory = function():ButtonGroup
			{
				var footer:ButtonGroup = new ButtonGroup();
				footer.direction = Direction.HORIZONTAL;
				footer.buttonFactory = function():Button
				{
					var button:Button = new Button();
					button.defaultSkin = new Quad(BUTTON_WIDTH, BUTTON_HEIGHT, 0x00ff00);
					return button;
				};
				return footer;
			};
			TestFeathers.starlingRoot.addChild(this._alert);
			
			this._textRenderer = new BitmapFontTextRenderer();
			TestFeathers.starlingRoot.addChild(this._textRenderer);
		}

		[After]
		public function cleanup():void
		{
			this._alert.removeFromParent(true);
			this._alert = null;
			
			this._textRenderer.removeFromParent(true);
			this._textRenderer = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function addSimpleBackground():void
		{
			this._alert.backgroundSkin = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT, 0xff00ff);
		}

		private function addComplexBackground():void
		{
			var backgroundSkin:LayoutGroup = new LayoutGroup();
			backgroundSkin.width = COMPLEX_BACKGROUND_WIDTH;
			backgroundSkin.height = COMPLEX_BACKGROUND_HEIGHT;
			backgroundSkin.minWidth = COMPLEX_BACKGROUND_MIN_WIDTH;
			backgroundSkin.minHeight = COMPLEX_BACKGROUND_MIN_HEIGHT;
			this._alert.backgroundSkin = backgroundSkin;
		}

		private function addHeader():void
		{
			this._alert.headerFactory = function():Header
			{
				var header:Header = new Header();
				header.backgroundSkin = new Quad(HEADER_WIDTH, HEADER_HEIGHT, 0xff00ff);
				return header;
			};
		}

		private function addWideHeader():void
		{
			this._alert.headerFactory = function():Header
			{
				var header:Header = new Header();
				header.backgroundSkin = new Quad(LARGE_HEADER_WIDTH, HEADER_HEIGHT, 0xff00ff);
				return header;
			};
		}

		[Test]
		public function testAutoSizeWithHeader():void
		{
			this.addHeader();
			this._alert.validate();
			Assert.assertStrictlyEquals("The width of the Alert was not calculated correctly with a header.",
				HEADER_WIDTH, this._alert.width);
			Assert.assertStrictlyEquals("The height of the Alert was not calculated correctly with a header.",
				HEADER_HEIGHT, this._alert.height);
			Assert.assertStrictlyEquals("The minWidth of the Alert was not calculated correctly with a header.",
				HEADER_WIDTH, this._alert.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Alert was not calculated correctly with a header.",
				HEADER_HEIGHT, this._alert.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderAndPadding():void
		{
			this.addHeader();
			this._alert.paddingTop = PADDING_TOP;
			this._alert.paddingRight = PADDING_RIGHT;
			this._alert.paddingBottom = PADDING_BOTTOM;
			this._alert.paddingLeft = PADDING_LEFT;
			this._alert.validate();

			Assert.assertStrictlyEquals("The width of the Alert was not calculated correctly based on the header and left and right padding.",
				HEADER_WIDTH, this._alert.width);
			Assert.assertStrictlyEquals("The height of the Alert was not calculated correctly based on the header and top and bottom padding.",
				HEADER_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._alert.height);
			Assert.assertStrictlyEquals("The minWidth of the Alert was not calculated correctly based on the header and left and right padding.",
				HEADER_WIDTH, this._alert.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Alert was not calculated correctly based on the header and top and bottom padding.",
				HEADER_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._alert.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderAndOuterPadding():void
		{
			this.addWideHeader();
			this._alert.outerPaddingTop = OUTER_PADDING_TOP;
			this._alert.outerPaddingRight = OUTER_PADDING_RIGHT;
			this._alert.outerPaddingBottom = OUTER_PADDING_BOTTOM;
			this._alert.outerPaddingLeft = OUTER_PADDING_LEFT;
			this._alert.validate();

			Assert.assertStrictlyEquals("The width of the Alert was not calculated correctly based on the header and left and right outer padding.",
				LARGE_HEADER_WIDTH + OUTER_PADDING_LEFT + OUTER_PADDING_RIGHT, this._alert.width);
			Assert.assertStrictlyEquals("The height of the Alert was not calculated correctly based on the header and top and bottom outer padding.",
				HEADER_HEIGHT + OUTER_PADDING_TOP + OUTER_PADDING_BOTTOM, this._alert.height);
			Assert.assertStrictlyEquals("The minWidth of the Alert was not calculated correctly based on the header and left and right outer padding.",
				LARGE_HEADER_WIDTH + OUTER_PADDING_LEFT + OUTER_PADDING_RIGHT, this._alert.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Alert was not calculated correctly based on the header and top and bottom outer padding.",
				HEADER_HEIGHT + OUTER_PADDING_TOP + OUTER_PADDING_BOTTOM, this._alert.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderAndSimpleBackgroundSkin():void
		{
			this.addHeader();
			this.addSimpleBackground();
			this._alert.validate();

			Assert.assertStrictlyEquals("The width of the Alert was not calculated correctly based on the background width larger than the header width.",
				BACKGROUND_WIDTH, this._alert.width);
			Assert.assertStrictlyEquals("The height of the Alert was not calculated correctly based on the background height.",
				BACKGROUND_HEIGHT, this._alert.height);
			Assert.assertStrictlyEquals("The minWidth of the Alert was not calculated correctly based on the background width larger than the header width.",
				BACKGROUND_WIDTH, this._alert.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Alert was not calculated correctly based on the background height.",
				BACKGROUND_HEIGHT, this._alert.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderAndComplexBackground():void
		{
			this.addHeader();
			this.addComplexBackground();
			this._alert.validate();

			Assert.assertStrictlyEquals("The width of the Alert was not calculated correctly based on the complex background width.",
				COMPLEX_BACKGROUND_WIDTH, this._alert.width);
			Assert.assertStrictlyEquals("The height of the Alert was not calculated correctly based on the complex background height.",
				COMPLEX_BACKGROUND_HEIGHT, this._alert.height);
			Assert.assertStrictlyEquals("The minWidth of the Alert was not calculated correctly based on the complex background minWidth.",
				COMPLEX_BACKGROUND_MIN_WIDTH, this._alert.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Alert was not calculated correctly based on the complex background minHeight.",
				COMPLEX_BACKGROUND_MIN_HEIGHT, this._alert.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderAndFooter():void
		{
			this.addHeader();
			this._alert.buttonsDataProvider = new ListCollection(
			[
				{},
				{},
				{},
			]);
			this._alert.validate();
			Assert.assertStrictlyEquals("The width of the Alert was not calculated correctly with header and footer.",
				BUTTON_WIDTH * 3, this._alert.width);
			Assert.assertStrictlyEquals("The height of the Alert was not calculated correctly with header and footer.",
				HEADER_HEIGHT + BUTTON_HEIGHT, this._alert.height);
			Assert.assertStrictlyEquals("The minWidth of the Alert was not calculated correctly with header and footer.",
				BUTTON_WIDTH * 3, this._alert.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Alert was not calculated correctly with header and footer.",
				HEADER_HEIGHT + BUTTON_HEIGHT, this._alert.minHeight);
		}

		[Test]
		public function testAutoSizeWidthWithHeaderAndSmallerFooter():void
		{
			this.addWideHeader();
			this._alert.buttonsDataProvider = new ListCollection(
			[
				{},
			]);
			this._alert.validate();
			Assert.assertStrictlyEquals("The width of the Alert was not calculated correctly with header and footer.",
				LARGE_HEADER_WIDTH, this._alert.width);
			Assert.assertStrictlyEquals("The minWidth of the Alert was not calculated correctly with header and footer.",
				LARGE_HEADER_WIDTH, this._alert.minWidth);
		}

		[Test]
		public function testAutoSizeWithHeaderFooterAndPadding():void
		{
			this.addHeader();
			this._alert.buttonsDataProvider = new ListCollection(
			[
				{},
				{},
				{},
			]);
			this._alert.paddingTop = PADDING_TOP;
			this._alert.paddingRight = PADDING_RIGHT;
			this._alert.paddingBottom = PADDING_BOTTOM;
			this._alert.paddingLeft = PADDING_LEFT;
			this._alert.validate();

			Assert.assertStrictlyEquals("The width of the Alert was not calculated correctly based on the header, footer, and left and right padding.",
				BUTTON_WIDTH * 3, this._alert.width);
			Assert.assertStrictlyEquals("The height of the Alert was not calculated correctly based on the header, footer, and top and bottom padding.",
				HEADER_HEIGHT + BUTTON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._alert.height);
			Assert.assertStrictlyEquals("The minWidth of the Alert was not calculated correctly based on the header, footer, and left and right padding.",
				BUTTON_WIDTH * 3, this._alert.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Alert was not calculated correctly based on the header, footer, and top and bottom padding.",
				HEADER_HEIGHT + BUTTON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._alert.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderFooterAndLargerSimpleBackgroundSkin():void
		{
			this.addHeader();
			this._alert.buttonsDataProvider = new ListCollection(
			[
				{},
			]);
			this.addSimpleBackground();
			this._alert.validate();

			Assert.assertStrictlyEquals("The width of the Alert was not calculated correctly based on the background width with a smaller header and footer.",
				BACKGROUND_WIDTH, this._alert.width);
			Assert.assertStrictlyEquals("The height of the Alert was not calculated correctly based on the background width with a smaller header and footer.",
				BACKGROUND_HEIGHT, this._alert.height);
			Assert.assertStrictlyEquals("The minWidth of the Alert was not calculated correctly based on the background height with a smaller header and footer.",
				BACKGROUND_WIDTH, this._alert.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Alert was not calculated correctly based on the background width with a smaller header and footer.",
				BACKGROUND_HEIGHT, this._alert.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderFooterAndLargerComplexBackground():void
		{
			this.addHeader();
			this._alert.buttonsDataProvider = new ListCollection(
			[
				{},
			]);
			this.addComplexBackground();
			this._alert.validate();

			Assert.assertStrictlyEquals("The width of the Alert was not calculated correctly based on the complex background width with a smaller header and footer.",
				COMPLEX_BACKGROUND_WIDTH, this._alert.width);
			Assert.assertStrictlyEquals("The height of the Alert was not calculated correctly based on the complex background height with a smaller header and footer.",
				COMPLEX_BACKGROUND_HEIGHT, this._alert.height);
			Assert.assertStrictlyEquals("The minWidth of the Alert was not calculated correctly based on the complex background minWidth with a smaller header and footer.",
				COMPLEX_BACKGROUND_MIN_WIDTH, this._alert.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Alert was not calculated correctly based on the complex background minHeight with a smaller header and footer.",
				COMPLEX_BACKGROUND_MIN_HEIGHT, this._alert.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderAndShortMessage():void
		{
			var message:String = "Hello";
			this.addHeader();
			this._alert.message = message;
			this._alert.validate();

			this._textRenderer.text = message;
			this._textRenderer.validate();
			
			Assert.assertStrictlyEquals("The width of the Alert was not calculated correctly with a header and short message.",
				HEADER_WIDTH, this._alert.width);
			Assert.assertStrictlyEquals("The height of the Alert was not calculated correctly with a header and short message.",
				HEADER_HEIGHT + this._textRenderer.height, this._alert.height);
			Assert.assertStrictlyEquals("The minWidth of the Alert was not calculated correctly with a header and short message.",
				HEADER_WIDTH, this._alert.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Alert was not calculated correctly with a header and short message.",
				HEADER_HEIGHT + this._textRenderer.minHeight, this._alert.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderAndLongMessage():void
		{
			var message:String = "I am the very model of a modern major general";
			this.addHeader();
			this._alert.message = message;
			this._alert.validate();

			this._textRenderer.text = message;
			this._textRenderer.validate();
			
			Assert.assertStrictlyEquals("The width of the Alert was not calculated correctly with a header and long message.",
				this._textRenderer.width, this._alert.width);
			Assert.assertStrictlyEquals("The height of the Alert was not calculated correctly with a header and long message.",
				HEADER_HEIGHT + this._textRenderer.height, this._alert.height);
			Assert.assertStrictlyEquals("The minWidth of the Alert was not calculated correctly with a header and long message.",
				this._textRenderer.minWidth, this._alert.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Alert was not calculated correctly with a header and long message.",
				HEADER_HEIGHT + this._textRenderer.minHeight, this._alert.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderIconAndLongMessage():void
		{
			var message:String = "I am the very model of a modern major general";
			this.addHeader();
			this._alert.message = message;
			this._alert.icon = new Quad(ICON_WIDTH, ICON_HEIGHT);
			this._alert.validate();

			this._textRenderer.text = message;
			this._textRenderer.validate();

			Assert.assertStrictlyEquals("The width of the Alert was not calculated correctly with a header, icon, and long message.",
				ICON_WIDTH + this._textRenderer.width, this._alert.width);
			Assert.assertStrictlyEquals("The height of the Alert was not calculated correctly with a header, icon, and long message.",
				HEADER_HEIGHT + ICON_HEIGHT, this._alert.height);
			Assert.assertStrictlyEquals("The minWidth of the Alert was not calculated correctly with a header, icon, and long message.",
				ICON_WIDTH + this._textRenderer.width, this._alert.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Alert was not calculated correctly with a header, icon, and long message.",
				HEADER_HEIGHT + ICON_HEIGHT, this._alert.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderIconGapAndLongMessage():void
		{
			var message:String = "I am the very model of a modern major general";
			this.addHeader();
			this._alert.message = message;
			this._alert.gap = GAP;
			this._alert.icon = new Quad(ICON_WIDTH, ICON_HEIGHT);
			this._alert.validate();

			this._textRenderer.text = message;
			this._textRenderer.validate();

			Assert.assertStrictlyEquals("The width of the Alert was not calculated correctly with a header, icon, gap, and long message.",
				ICON_WIDTH + GAP + this._textRenderer.width, this._alert.width);
			Assert.assertStrictlyEquals("The height of the Alert was not calculated correctly with a header, icon, gap, and long message.",
				HEADER_HEIGHT + ICON_HEIGHT, this._alert.height);
			Assert.assertStrictlyEquals("The minWidth of the Alert was not calculated correctly with a header, icon, gap, and long message.",
				ICON_WIDTH + GAP + this._textRenderer.width, this._alert.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Alert was not calculated correctly with a header, icon, gap, and long message.",
				HEADER_HEIGHT + ICON_HEIGHT, this._alert.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderMessageAndMeasureViewPortSetToFalse():void
		{
			var message:String = "I am the very model of a modern major general";
			this.addHeader();
			this._alert.message = message;
			this._alert.measureViewPort = false;
			this._alert.validate();

			this._textRenderer.text = message;
			this._textRenderer.validate();
			
			Assert.assertStrictlyEquals("The width of the Alert was not calculated correctly with a header.",
				HEADER_WIDTH, this._alert.width);
			Assert.assertStrictlyEquals("The height of the Alert was not calculated correctly with a header.",
				HEADER_HEIGHT, this._alert.height);
			Assert.assertStrictlyEquals("The minWidth of the Alert was not calculated correctly with a header.",
				HEADER_WIDTH, this._alert.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Alert was not calculated correctly with a header.",
				HEADER_HEIGHT, this._alert.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/AnchorLayoutTests.as
================================================
package feathers.tests
{
	import feathers.controls.Label;
	import feathers.controls.LayoutGroup;
	import feathers.layout.AnchorLayout;
	import feathers.layout.AnchorLayoutData;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.ViewPortBounds;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;

	public class AnchorLayoutTests
	{
		private var _layout:AnchorLayout;

		[Before]
		public function prepare():void
		{
			this._layout = new AnchorLayout();
		}

		[After]
		public function cleanup():void
		{
			this._layout = null;
		}

		[Test]
		public function testPercentWidth():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentWidth = 50;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayoutData with percentWidth results in incorrect item width", viewPortWidth / 2, item1.width);
		}

		[Test]
		public function testPercentWidthGreaterThan100():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentWidth = 150;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayoutData with percentWidth > 100 does not clamp to 100", viewPortWidth, item1.width);
		}

		[Test]
		public function testPercentWidthLessThan0():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentWidth = -50;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayoutData with percentWidth < 0 does not clamp to 0", 0, item1.width);
		}

		[Test]
		public function testPercentHeight():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentHeight = 50;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayoutData with percentHeight results in incorrect item height", viewPortHeight / 2, item1.height);
		}

		[Test]
		public function testPercentHeightGreaterThan100():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentHeight = 150;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayoutData with percentHeight > 100 does not clamp to 100", viewPortHeight, item1.height);
		}

		[Test]
		public function testPercentHeightLessThan0():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentHeight = -50;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayoutData with percentHeight < 0 does not clamp to 0", 0, item1.height);
		}

		[Test]
		public function testPercentWidthWithExplicitMinWidth():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			item1.minWidth = 400;
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentWidth = 50;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayoutData with percentWidth and larger item explicitMinWidth results in incorrect item width",
				400, item1.width);
		}

		[Test]
		public function testPercentHeightWithExplicitMinHeight():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			item1.minHeight = 400;
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentHeight = 50;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayoutData with percentHeight and larger item explicitMinHeight results in incorrect item height",
				400, item1.height);
		}

		[Test]
		public function testPercentWidthWithExplicitMaxWidth():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			item1.maxWidth = 250;
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentWidth = 50;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayoutData with percentWidth and smaller item explicitMaxWidth results in incorrect item width",
				250, item1.width);
		}

		[Test]
		public function testPercentHeightWithExplicitMaxHeight():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			item1.maxHeight = 250;
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentHeight = 50;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayoutData with percentHeight and larger item explicitMaxHeight results in incorrect item height",
				250, item1.height);
		}

		[Test]
		public function testPercentWidthWithWrappingLabelAndMaxWidth():void
		{
			var viewPortMaxWidth:Number = 100;
			var item1:Label = new Label();
			item1.text = "I am the very model of a modern Major General";
			item1.wordWrap = true;
			item1.validate();
			var unwrappedHeight:Number = item1.height;
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentWidth = 100;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = viewPortMaxWidth;
			this._layout.layout(items, bounds);
			//since we're setting maxWidth, the width may actually be smaller
			Assert.assertTrue("AnchorLayoutData with percentWidth with a wrapping Label results in incorrect width",
				viewPortMaxWidth >= item1.width);
			//we're only checking that it has more than one line
			Assert.assertTrue("AnchorLayoutData with percentWidth on a wrapping Label results in height that is too small",
				unwrappedHeight < item1.height);
		}

		[Test]
		public function testLeftAndRightWithExplicitMaxWidth():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			item1.maxWidth = 250;
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.left = 10;
			layoutData1.right = 10;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 320;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayoutData with left and right and smaller item explicitMaxWidth results in incorrect item width",
				250, item1.width);
		}

		[Test]
		public function testTopAndBottomWithExplicitMaxHeight():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			item1.maxHeight = 250;
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.top = 10;
			layoutData1.bottom = 10;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 320;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayoutData with top and bottom and smaller item explicitMaxHeight results in incorrect item height",
				250, item1.height);
		}

		[Test]
		public function testLeftAndRightWithWrappingLabelAndMaxWidth():void
		{
			var viewPortMaxWidth:Number = 100;
			var left:Number = 10;
			var right:Number = 15;
			var item1:Label = new Label();
			item1.text = "I am the very model of a modern Major General";
			item1.wordWrap = true;
			item1.validate();
			var unwrappedHeight:Number = item1.height;
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.left = left;
			layoutData1.right = right;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = viewPortMaxWidth;
			this._layout.layout(items, bounds);
			//since we're setting maxWidth, the width may actually be smaller
			Assert.assertTrue("AnchorLayoutData with left and right on a wrapping Label results in incorrect width",
				viewPortMaxWidth - left - right >= item1.width);
			//we're only checking that it has more than one line
			Assert.assertTrue("AnchorLayoutData with left and right on a wrapping Label results in height that is too small",
				unwrappedHeight < item1.height);
		}

		[Test]
		public function testChildWithCalculatedMinDimensionsAndPercentDimensions():void
		{
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentWidth = 100;
			layoutData1.percentHeight = 100;
			item1.layoutData = layoutData1;
			var child:Quad = new Quad(100, 150, 0xff00ff);
			item1.addChild(child);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayout without explicit view port width and child with percentWidth and calculated minWidth results in wrong view port width",
				100, result.viewPortWidth);
			Assert.assertStrictlyEquals("AnchorLayout without explicit view port height and child with percentHeight and calculated minHeight results in wrong view port height",
				150, result.viewPortHeight);
		}

		[Test]
		public function testChildWithExplicitMinWidthAndPercentWidth():void
		{
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentWidth = 100;
			layoutData1.percentHeight = 100;
			item1.layoutData = layoutData1;
			var child:Quad = new Quad(100, 100, 0xff00ff);
			item1.minWidth = 200;
			item1.minHeight = 250;
			item1.addChild(child);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayout without explicit view port width and child with percentWidth and explicit minWidth results in wrong view port width",
				200, result.viewPortWidth);
			Assert.assertStrictlyEquals("AnchorLayout without explicit view port width and child with percentWidth and explicit minWidth results in wrong child width",
				200, item1.width);
			Assert.assertStrictlyEquals("AnchorLayout without explicit view port height and child with percentHeight and explicit minHeight results in wrong view port height",
				250, result.viewPortHeight);
			Assert.assertStrictlyEquals("AnchorLayout without explicit view port height and child with percentHeight and explicit minHeight results in wrong child height",
				250, item1.height);
		}

		[Test]
		public function testChildWithCalculatedMinWidthAndPercentWidthWithExplicitWidth():void
		{
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentWidth = 100;
			layoutData1.percentHeight = 100;
			item1.layoutData = layoutData1;
			var child:Quad = new Quad(100, 100, 0xff00ff);
			item1.addChild(child);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 50;
			bounds.explicitHeight = 75;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayout with explicit view port width and child with percentWidth and calculated minWidth results in wrong view port width",
				50, result.viewPortWidth);
			Assert.assertStrictlyEquals("AnchorLayout with explicit view port width and child with percentWidth and calculated minWidth results in wrong child width",
				50, item1.width);
			Assert.assertStrictlyEquals("AnchorLayout with explicit view port height and child with percentHeight and calculated minHeight results in wrong view port height",
				75, result.viewPortHeight);
			Assert.assertStrictlyEquals("AnchorLayout with explicit view port height and child with percentHeight and calculated minHeight results in wrong child height",
				75, item1.height);
		}


		[Test]
		public function testChildWithCalculatedMinWidthAndPercentWidthWithViewPortMinWidth():void
		{
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentWidth = 100;
			layoutData1.percentHeight = 100;
			item1.layoutData = layoutData1;
			var child:Quad = new Quad(100, 150, 0xff00ff);
			item1.addChild(child);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.minWidth = 10;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayout with explicit view port minWidth and child with percentWidth and calculated minWidth results in wrong view port width",
				100, result.viewPortWidth);
			Assert.assertStrictlyEquals("AnchorLayout with explicit view port minWidth and child with percentWidth and calculated minWidth results in wrong child width",
				100, item1.width);
			Assert.assertStrictlyEquals("AnchorLayout with explicit view port minWidth and child with percentHeight and calculated minHeight results in wrong view port height",
				150, result.viewPortHeight);
			Assert.assertStrictlyEquals("AnchorLayout with explicit view port minWidth and child with percentHeight and calculated minHeight results in wrong child height",
				150, item1.height);
		}

		[Test]
		public function testChildWithCalculatedWidthAndSmallerCalculatedMinWidthAndPercentWidth():void
		{
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.percentWidth = 100;
			layoutData1.percentHeight = 100;
			item1.layoutData = layoutData1;
			var child:LayoutGroup = new LayoutGroup();
			child.width = 100;
			child.height = 150;
			child.minWidth = 50;
			child.minHeight = 50;
			item1.backgroundSkin = child;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("AnchorLayout without explicit view port width and child with percentWidth, calculated width, and calculated minWidth results in wrong view port width",
				100, result.viewPortWidth);
			Assert.assertStrictlyEquals("AnchorLayout without explicit view port width and child with percentWidth, calculated width, and calculated minWidth results in wrong child width",
				100, item1.width);
			Assert.assertStrictlyEquals("AnchorLayout without explicit view port height and child with percentHeight, calculated height, and calculated minHeight results in wrong view port height",
				150, result.viewPortHeight);
			Assert.assertStrictlyEquals("AnchorLayout without explicit view port height and child with percentHeight, calculated height, and calculated minHeight results in wrong child height",
				150, item1.height);
		}

		[Test]
		public function testLeftAndTop():void
		{
			var left:Number = 10;
			var top:Number = 15;
			var width:Number = 100;
			var height:Number = 150;
			var item1:LayoutGroup = new LayoutGroup();
			item1.backgroundSkin = new Quad(width, height, 0xff00ff);
			item1.validate();
			var layoutData1:AnchorLayoutData = new AnchorLayoutData();
			layoutData1.left = left;
			layoutData1.top = top;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertTrue("AnchorLayoutData with left and top results in incorrect view port width",
				width + left, result.viewPortWidth);
			Assert.assertTrue("AnchorLayoutData with left and top results in incorrect view port height",
				height + top, result.viewPortHeight);
			Assert.assertTrue("AnchorLayoutData with left and top results in incorrect content width",
				width + left, result.contentWidth);
			Assert.assertTrue("AnchorLayoutData with left and top results in incorrect content height",
				height + top, result.contentHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ArrayCollectionTests.as
================================================
package feathers.tests
{
	import feathers.data.ArrayCollection;
	import feathers.data.ListCollection;
	import feathers.events.CollectionEventType;

	import org.flexunit.Assert;

	import starling.events.Event;

	public class ArrayCollectionTests
	{
		private var _collection:ArrayCollection;
		private var _a:Object;
		private var _b:Object;
		private var _c:Object;
		private var _d:Object;

		[Before]
		public function prepare():void
		{
			this._a = { label: "One", value: 0 };
			this._b = { label: "Two", value: 2 };
			this._c = { label: "Three", value: 3 };
			this._d = { label: "Four", value: 1 };
			this._collection = new ArrayCollection(
			[
				this._a,
				this._b,
				this._c,
				this._d,
			]);
		}

		[After]
		public function cleanup():void
		{
			this._collection = null;
		}

		private function filterFunction(item:Object):Boolean
		{
			if(item === this._a || item === this._c)
			{
				return false;
			}
			return true;
		}

		private function sortCompareFunction(a:Object, b:Object):int
		{
			var valueA:Number = a.value as Number;
			var valueB:Number = b.value as Number;
			if(valueA < valueB)
			{
				return -1;
			}
			if(valueA > valueB)
			{
				return 1;
			}
			return 0;
		}

		[Test]
		public function testRemoveAll():void
		{
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedAll:Boolean = false;
			this._collection.addEventListener(CollectionEventType.REMOVE_ALL, function(event:Event):void
			{
				hasRemovedAll = true;
			});
			var hasReset:Boolean = false;
			this._collection.addEventListener(CollectionEventType.RESET, function(event:Event):void
			{
				hasReset = true;
			});
			this._collection.removeAll();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			//reset used to be dispatched, but REMOVE_ALL is better
			Assert.assertFalse("CollectionEventType.RESET was incorrectly dispatched", hasReset);
			Assert.assertTrue("CollectionEventType.REMOVE_ALL was not dispatched", hasRemovedAll);
			Assert.assertStrictlyEquals("The length property was not changed to 0",
				0, this._collection.length);
		}

		[Test]
		public function testRemoveItemAt():void
		{
			var itemToRemove:Object = this._collection.getItemAt(1);
			var originalLength:int = this._collection.length;
			var expectedIndex:int = 1;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				hasRemovedItem = true;
				indexFromEvent = index;
			});
			this._collection.removeItemAt(expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength - 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not removed",
				-1, this._collection.getItemIndex(itemToRemove));
			Assert.assertStrictlyEquals("The CollectionEventType.REMOVE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testRemoveItem():void
		{
			var expectedIndex:int = 1;
			var itemToRemove:Object = this._collection.getItemAt(expectedIndex);
			var originalLength:int = this._collection.length;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				hasRemovedItem = true;
				indexFromEvent = index;
			});
			this._collection.removeItem(itemToRemove);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength - 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not removed",
				-1, this._collection.getItemIndex(itemToRemove));
			Assert.assertStrictlyEquals("The CollectionEventType.REMOVE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testShift():void
		{
			var itemToRemove:Object = this._collection.getItemAt(0);
			var originalLength:int = this._collection.length;
			var expectedIndex:int = 0;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				hasRemovedItem = true;
				indexFromEvent = index;
			});
			this._collection.shift();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength - 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not removed",
				-1, this._collection.getItemIndex(itemToRemove));
			Assert.assertStrictlyEquals("The CollectionEventType.REMOVE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testPop():void
		{
			var originalLength:int = this._collection.length;
			var itemToRemove:Object = this._collection.getItemAt(originalLength - 1);
			var expectedIndex:int = originalLength - 1;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				hasRemovedItem = true;
				indexFromEvent = index;
			});
			this._collection.pop();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength - 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not removed",
				-1, this._collection.getItemIndex(itemToRemove));
			Assert.assertStrictlyEquals("The CollectionEventType.REMOVE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testAddItem():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var originalLength:int = this._collection.length;
			var expectedIndex:int = originalLength;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.addItem(itemToAdd);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength + 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.ADD_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testAddItemAt():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.length;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.addItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength + 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.ADD_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testUnshift():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var expectedIndex:int = 0;
			var originalLength:int = this._collection.length;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.unshift(itemToAdd);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength + 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.ADD_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testPush():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var originalLength:int = this._collection.length;
			var expectedIndex:int = originalLength;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.push(itemToAdd);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength + 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.ADD_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testSetItemAt():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.length;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.setItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalLength, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.REPLACE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testContainsWithItemInCollection():void
		{
			var item:Object = this._collection.getItemAt(1);
			Assert.assertStrictlyEquals("contains() incorrectly returned false",
				true, this._collection.contains(item));
		}

		[Test]
		public function testContainsWithItemNotInCollection():void
		{
			var item:Object = {};
			Assert.assertStrictlyEquals("contains() incorrectly returned true",
				false, this._collection.contains(item));
		}

		[Test]
		public function testGetItemIndexWithItemInCollection():void
		{
			var expectedIndex:int = 1;
			var item:Object = this._collection.getItemAt(expectedIndex);
			Assert.assertStrictlyEquals("getItemIndex() returned the incorrect value",
				expectedIndex, this._collection.getItemIndex(item));
		}

		[Test]
		public function testGetItemIndexWithItemNotInCollection():void
		{
			var item:Object = {};
			Assert.assertStrictlyEquals("getItemIndex() returned the incorrect value",
				-1, this._collection.getItemIndex(item));
		}

		[Test]
		public function testDispose():void
		{
			var itemCount:int = this._collection.length;
			var disposedCount:int = 0;
			this._collection.dispose(function(item:Object):void
			{
				item.isDisposed = true;
				disposedCount++;
			});
			Assert.assertStrictlyEquals("Incorrect number of items disposed when calling dispose() on ArrayCollection",
				itemCount, disposedCount);
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = this._collection.getItemAt(i);
				Assert.assertTrue("Item was not included when calling dispose() on ArrayCollection", item.isDisposed);
			}
		}

		[Test]
		public function testDisposeWithFilterFunction():void
		{
			var itemCount:int = this._collection.length;
			this._collection.filterFunction = function(item:Object):Boolean
			{
				return item.label.charAt(0) === "O";
			};
			var filteredCount:int = this._collection.length;
			Assert.assertFalse("Filtered collection length must change", itemCount === filteredCount);
			var disposedCount:int = 0;
			this._collection.dispose(function(item:Object):void
			{
				item.isDisposed = true;
				disposedCount++;
			});
			Assert.assertStrictlyEquals("Incorrect number of items disposed when calling dispose() on ArrayCollection",
				itemCount, disposedCount);
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = this._collection.getItemAt(i);
				Assert.assertTrue("Item was not included when calling dispose() on ArrayCollection", item.isDisposed);
			}
		}

		[Test]
		public function testSortCompareFunction():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			Assert.assertStrictlyEquals("ArrayCollection: sortCompareFunction order is incorrect.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("ArrayCollection: sortCompareFunction order is incorrect.",
				this._d, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("ArrayCollection: sortCompareFunction order is incorrect.",
				this._b, this._collection.getItemAt(2));
			Assert.assertStrictlyEquals("ArrayCollection: sortCompareFunction order is incorrect.",
				this._c, this._collection.getItemAt(3));
		}

		[Test]
		public function testSortCompareFunctionAndFilterFunction():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.filterFunction = this.filterFunction;
			Assert.assertStrictlyEquals("ArrayCollection: sortCompareFunction and filterFunction length is incorrect.",
				2, this._collection.length);
			Assert.assertStrictlyEquals("ArrayCollection: sortCompareFunction order is incorrect with filterFunction.",
				this._d, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("ArrayCollection: sortCompareFunction order is incorrect with filterFunction.",
				this._b, this._collection.getItemAt(1));
		}

		[Test]
		public function testSetSortCompareFunctionToNull():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			//get an item so that we know the sorting was applied
			Assert.assertStrictlyEquals("ArrayCollection: sortCompareFunction order is incorrect.",
				this._c, this._collection.getItemAt(3));

			this._collection.sortCompareFunction = null;
			Assert.assertStrictlyEquals("ArrayCollection: set sortCompareFunction to null order is incorrect.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("ArrayCollection: set sortCompareFunction to null order is incorrect.",
				this._b, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("ArrayCollection: set sortCompareFunction to null order is incorrect.",
				this._c, this._collection.getItemAt(2));
			Assert.assertStrictlyEquals("ArrayCollection: set sortCompareFunction to null order is incorrect.",
				this._d, this._collection.getItemAt(3));
		}

		[Test]
		public function testSortCompareFunctionWithAddItem():void
		{
			var newItem:Object = { label: "New Item", value: 1.5 };
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.addItem(newItem);

			Assert.assertStrictlyEquals("ArrayCollection: addItem() with sortCompareFunction does not add at correct sorted index.",
				newItem, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			Assert.assertStrictlyEquals("ArrayCollection: addItem() with sortCompareFunction does not add at correct unsorted index.",
				newItem, this._collection.getItemAt(4));
		}

		[Test]
		public function testSortCompareFunctionWithAddItemAt():void
		{
			var newItem:Object = { label: "New Item", value: 1.5 };
			var newIndex:int = 1;
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.addItemAt(newItem, newIndex);

			//the index we passed in isn't necessarily the same while sorted
			Assert.assertStrictlyEquals("ArrayCollection: addItemAt() with sortCompareFunction does not add at correct sorted index.",
				newItem, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			//and it might not even be the same while unsorted!
			//that's because, in the unsorted data, it will be placed relative
			//to the item in the sorted data that was at the index passed to
			//addItemAt(). confusing, but it's consistent with setItemAt() and
			//filtered collections
			Assert.assertStrictlyEquals("ArrayCollection: addItemAt() with sortCompareFunction does not add at correct unsorted index.",
				newItem, this._collection.getItemAt(3));
		}

		[Test]
		public function testSortCompareFunctionWithRemoveItemAt():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.removeItemAt(2);

			Assert.assertStrictlyEquals("ArrayCollection: removeItemAt() with sortCompareFunction removed incorrect item in sorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("ArrayCollection: removeItemAt() with sortCompareFunction removed incorrect item in sorted data.",
				this._d, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("ArrayCollection: removeItemAt() with sortCompareFunction removed incorrect item in sorted data.",
				this._c, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			Assert.assertStrictlyEquals("ArrayCollection: removeItemAt() with sortCompareFunction removed incorrect item in unsorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("ArrayCollection: removeItemAt() with sortCompareFunction removed incorrect item in unsorted data.",
				this._c, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("ArrayCollection: removeItemAt() with sortCompareFunction removed incorrect item in unsorted data.",
				this._d, this._collection.getItemAt(2));
		}

		[Test]
		public function testSortCompareFunctionWithRemoveItem():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.removeItem(this._b);

			Assert.assertStrictlyEquals("ArrayCollection: removeItem() with sortCompareFunction removed incorrect item in sorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("ArrayCollection: removeItem() with sortCompareFunction removed incorrect item in sorted data.",
				this._d, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("ArrayCollection: removeItem() with sortCompareFunction removed incorrect item in sorted data.",
				this._c, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			Assert.assertStrictlyEquals("ArrayCollection: removeItem() with sortCompareFunction removed incorrect item in unsorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("ArrayCollection: removeItem() with sortCompareFunction removed incorrect item in unsorted data.",
				this._c, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("ArrayCollection: removeItem() with sortCompareFunction removed incorrect item in unsorted data.",
				this._d, this._collection.getItemAt(2));
		}

		[Test]
		public function testSortCompareFunctionWithSetItemAt():void
		{
			var newItem:Object = { label: "New Item", value: 1.5 };
			var newIndex:int = 0;
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.setItemAt(newItem, newIndex);

			//the index we passed in isn't necessarily the same while sorted
			Assert.assertStrictlyEquals("ArrayCollection: setItemAt() with sortCompareFunction does not add at correct sorted index.",
				newItem, this._collection.getItemAt(1));
			Assert.assertFalse("ArrayCollection: setItemAt() with sortCompareFunction does not replace correct item.",
				this._collection.contains(this._a));

			this._collection.sortCompareFunction = null;

			//however, that index should be the same when the collection is unsorted
			Assert.assertStrictlyEquals("ArrayCollection: setItemAt() with sortCompareFunction does not add at correct unsorted index.",
				newItem, this._collection.getItemAt(newIndex));
		}
	}
}


================================================
FILE: test/source/feathers/tests/ArrayHierarchicalCollectionTests.as
================================================
package feathers.tests
{
	import feathers.data.ArrayHierarchicalCollection;
	import feathers.events.CollectionEventType;

	import org.flexunit.Assert;

	import starling.events.Event;

	public class ArrayHierarchicalCollectionTests
	{
		private var _collection:ArrayHierarchicalCollection;

		[Before]
		public function prepare():void
		{
			this._collection = new ArrayHierarchicalCollection(
			[
				{
					label: "1",
					children:
					[
						{label: "1-A"},
						{
							label: "1-B",
							children:
							[
								{label: "1-B-I"},
							]
						},
						{label: "1-C"},
					]
				},
				{
					label: "2",
					children:
					[
						{label: "2-A"},
					]
				},
				{ label: "3" },
				{
					label: "4",
					children:
					[
						{label: "4-A"},
						{label: "4-B"},
					]
				},
			]);
		}

		[After]
		public function cleanup():void
		{
			this._collection = null;
		}

		[Test]
		public function testGetLength():void
		{
			var length:int = this._collection.getLength();
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: getLengthAtLocation() returned incorrect length",
				4, length);
		}

		[Test]
		public function testGetLengthNested():void
		{
			var length:int = this._collection.getLength(3);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: getLengthAtLocation() returned incorrect length",
				2, length);
		}

		[Test]
		public function testGetLengthAtLocationWithNull():void
		{
			var length:int = this._collection.getLengthAtLocation();
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: getLengthAtLocation() returned incorrect length",
				4, length);
		}

		[Test]
		public function testGetItemAt():void
		{
			var item:Object = this._collection.getItemAt(1);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: getItemAt() returned incorrect item",
				this._collection.arrayData[1], item);
		}

		[Test]
		public function testGetItemAtNested():void
		{
			var item:Object = this._collection.getItemAt(0, 1);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: getItemAt() returned incorrect item",
				this._collection.arrayData[0].children[1], item);
		}

		[Test]
		public function testGetItemAtLocation():void
		{
			var indices:Vector.<int> = new <int>[1];
			var item:Object = this._collection.getItemAtLocation(indices);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: getItemAtLocation() returned incorrect item",
				this._collection.arrayData[1], item);
		}

		[Test]
		public function testGetItemAtNestedLocation():void
		{
			var indices:Vector.<int> = new <int>[0, 1];
			var item:Object = this._collection.getItemAtLocation(indices);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: getItemAtLocation() returned incorrect item",
				this._collection.arrayData[0].children[1], item);
		}

		[Test]
		public function testGetItemAtNullLocation():void
		{
			var item:Object = this._collection.getItemAtLocation(null);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: getItemAtLocation() returned incorrect item",
				null, item);
		}

		[Test]
		public function testGetItemAtEmptyLocation():void
		{
			var indices:Vector.<int> = new <int>[];
			var item:Object = this._collection.getItemAtLocation(indices);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: getItemAtLocation() returned incorrect item",
				null, item);
		}

		[Test]
		public function testRemoveAll():void
		{
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedAll:Boolean = false;
			this._collection.addEventListener(CollectionEventType.REMOVE_ALL, function(event:Event):void
			{
				hasRemovedAll = true;
			});
			var hasReset:Boolean = false;
			this._collection.addEventListener(CollectionEventType.RESET, function(event:Event):void
			{
				hasReset = true;
			});
			this._collection.removeAll();
			Assert.assertTrue("ArrayHierarchicalCollection: Event.CHANGE was not dispatched after removeAll()", hasChanged);
			Assert.assertFalse("ArrayHierarchicalCollection: CollectionEventType.RESET was incorrectly dispatched after removeAll()", hasReset);
			Assert.assertTrue("ArrayHierarchicalCollection: CollectionEventType.REMOVE_ALL was not dispatched after removeAll()", hasRemovedAll);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: the getLength() value was not changed to 0 after removeAll()",
				0, this._collection.getLength());
		}

		[Test]
		public function testRemoveItemAtLocation():void
		{
			var indicesToRemove:Vector.<int> = new <int>[1];
			var itemToRemove:Object = this._collection.getItemAtLocation(indicesToRemove);
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItemAtLocation(indicesToRemove);
			Assert.assertTrue("ArrayHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("ArrayHierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The getLength() value was not changed",
				originalLength - 1, this._collection.getLength());
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("ArrayHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				indicesToRemove[0], indicesFromEvent[0]);
		}

		[Test]
		public function testRemoveItemAtNestedLocation():void
		{
			var indicesToRemove:Vector.<int> = new <int>[0, 1];
			var itemToRemove:Object = this._collection.getItemAtLocation(indicesToRemove);
			var originalParentLength:int = this._collection.getLength(indicesToRemove[0]);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItemAtLocation(indicesToRemove);
			Assert.assertTrue("ArrayHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("ArrayHierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The getLength() value was not changed",
				originalParentLength - 1, this._collection.getLength(indicesToRemove[0]));
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("ArrayHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				indicesToRemove[0], indicesFromEvent[0]);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				indicesToRemove[1], indicesFromEvent[1]);
		}

		[Test(expects="RangeError")]
		public function testRemoveItemAtNullLocation():void
		{
			this._collection.removeItemAtLocation(null);
		}

		[Test(expects="RangeError")]
		public function testRemoveItemAtEmptyLocation():void
		{
			var indices:Vector.<int> = new <int>[];
			this._collection.removeItemAtLocation(indices);
		}

		[Test]
		public function testRemoveItemAt():void
		{
			var itemToRemove:Object = this._collection.getItemAt(1);
			var originalLength:int = this._collection.getLength();
			var expectedIndex:int = 1;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItemAt(expectedIndex);
			Assert.assertTrue("ArrayHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("ArrayHierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The getLength() value was not changed",
				originalLength - 1, this._collection.getLength());
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("ArrayHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testRemoveItem():void
		{
			var expectedIndex:int = 1;
			var itemToRemove:Object = this._collection.getItemAt(expectedIndex);
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItem(itemToRemove);
			Assert.assertTrue("ArrayHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("ArrayHierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The getLength() value was not changed",
				originalLength - 1, this._collection.getLength());
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("ArrayHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testAddItemAtLocation():void
		{
			var location:Vector.<int> = new <int>[1];
			var itemToAdd:Object = { label: "New Item" };
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAtLocation(itemToAdd, location);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The getLength() value was not changed",
				originalLength + 1, this._collection.getLength());
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not added",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not added at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("ArrayHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
		}

		[Test]
		public function testAddItemAtNestedLocation():void
		{
			var location:Vector.<int> = new <int>[0, 1];
			var itemToAdd:Object = { label: "New Item" };
			var originalParentLength:int = this._collection.getLength(location[0]);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAtLocation(itemToAdd, location);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The getLength() value was not changed",
				originalParentLength + 1, this._collection.getLength(location[0]));
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not added",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not added at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not added at the correct index",
				location[1], this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("ArrayHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				location[1], indicesFromEvent[1]);
		}

		[Test(expects="RangeError")]
		public function testAddItemAtNullLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			this._collection.addItemAtLocation(itemToAdd, null);
		}

		[Test(expects="RangeError")]
		public function testAddItemAtEmptyLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var indices:Vector.<int> = new <int>[];
			this._collection.addItemAtLocation(itemToAdd, indices);
		}

		[Test]
		public function testAddItemAt():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The getLength() value was not changed",
				originalLength + 1, this._collection.getLength());
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not added",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not added at the correct index",
				expectedIndex, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("ArrayHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testAddItemAtNested():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var originalParentLength:int = this._collection.getLength(0);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAt(itemToAdd, 0, 1);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The getLength() value was not changed",
				originalParentLength + 1, this._collection.getLength(0));
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not added",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not added at the correct index",
				0, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not added at the correct index",
				1, this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("ArrayHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				0, indicesFromEvent[0]);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[1]);
		}

		[Test]
		public function testSetItemAt():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalLength, this._collection.getLength());
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not replaced",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not replaced at the correct index",
				expectedIndex, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("ArrayHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testSetItemAtNested():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var originalParentLength:int = this._collection.getLength(0);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAt(itemToAdd, 0, 1);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalParentLength, this._collection.getLength(0));
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not replaced",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not replaced at the correct index",
				0, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not replaced at the correct index",
				1, this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("ArrayHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				0, indicesFromEvent[0]);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[1]);
		}

		[Test]
		public function testSetItemAtLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var location:Vector.<int> = new <int>[1];
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAtLocation(itemToAdd, location);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalLength, this._collection.getLength());
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not replaced",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not replaced at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("ArrayHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
		}

		[Test]
		public function testSetItemAtNestedLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var location:Vector.<int> = new <int>[0, 1];
			var originalParentLength:int = this._collection.getLength(location[0]);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAtLocation(itemToAdd, location);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalParentLength, this._collection.getLength(location[0]));
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not replaced",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not replaced at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The item was not replaced at the correct index",
				location[1], this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("ArrayHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				location[1], indicesFromEvent[1]);
		}

		[Test(expects="RangeError")]
		public function testSetItemAtNullLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			this._collection.setItemAtLocation(itemToAdd, null);
		}

		[Test(expects="RangeError")]
		public function testSetItemAtEmptyLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var indices:Vector.<int> = new <int>[];
			this._collection.setItemAtLocation(itemToAdd, indices);
		}

		[Test]
		public function testGetItemLocationWithItemInCollection():void
		{
			var expectedIndex:int = 1;
			var item:Object = this._collection.getItemAt(expectedIndex);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: getItemLocation() returned the incorrect location (length)",
				1, this._collection.getItemLocation(item).length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: getItemLocation() returned the incorrect location (value)",
				expectedIndex, this._collection.getItemLocation(item)[0]);
		}

		[Test]
		public function testGetItemLocationNestedWithItemInCollection():void
		{
			var location:Vector.<int> = new <int>[0, 1];
			var item:Object = this._collection.getItemAtLocation(location);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: getItemLocation() returned the incorrect location (length)",
				location.length, this._collection.getItemLocation(item).length);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: getItemLocation() returned the incorrect location (value)",
				location[0], this._collection.getItemLocation(item)[0]);
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: getItemLocation() returned the incorrect location (value)",
				location[1], this._collection.getItemLocation(item)[1]);
		}

		[Test]
		public function testGetItemLocationWithItemNotInCollection():void
		{
			var item:Object = {};
			Assert.assertStrictlyEquals("ArrayHierarchicalCollection: getItemLocation() returned the incorrect location (length)",
				0, this._collection.getItemLocation(item).length);
		}
	}
}

================================================
FILE: test/source/feathers/tests/BasicButtonInternalStateTests.as
================================================
package feathers.tests
{
	import feathers.controls.ButtonState;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class BasicButtonInternalStateTests
	{
		private var _button:ButtonWithInternalState;

		[Before]
		public function prepare():void
		{
			this._button = new ButtonWithInternalState();
			TestFeathers.starlingRoot.addChild(this._button);
		}

		[After]
		public function cleanup():void
		{
			this._button.removeFromParent(true);
			this._button = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testGetSkinForStateWithoutSetSkinForState():void
		{
			Assert.assertNull("BasicButton getSkinForState(ButtonState.UP) must be null when setSkinForState() is not called", this._button.getSkinForState(ButtonState.UP));
			Assert.assertNull("BasicButton getSkinForState(ButtonState.HOVER) must be null when setSkinForState() is not called", this._button.getSkinForState(ButtonState.HOVER));
			Assert.assertNull("BasicButton getSkinForState(ButtonState.DOWN) must be null when setSkinForState() is not called", this._button.getSkinForState(ButtonState.DOWN));
			Assert.assertNull("BasicButton getSkinForState(ButtonState.DISABLED) must be null when setSkinForState() is not called", this._button.getSkinForState(ButtonState.DISABLED));
		}

		[Test]
		public function testGetSkinForState():void
		{
			var defaultSkin:Quad = new Quad(200, 200);
			this._button.defaultSkin = defaultSkin;

			var upSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.UP, upSkin);

			var hoverSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.HOVER, hoverSkin);

			var downSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.DOWN, downSkin);

			var disabledSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.DISABLED, disabledSkin);
			
			Assert.assertStrictlyEquals("BasicButton getSkinForState(ButtonState.UP) does not match value passed to setSkinForState()", upSkin, this._button.getSkinForState(ButtonState.UP));
			Assert.assertStrictlyEquals("BasicButton getSkinForState(ButtonState.HOVER) does not match value passed to setSkinForState()", hoverSkin, this._button.getSkinForState(ButtonState.HOVER));
			Assert.assertStrictlyEquals("BasicButton getSkinForState(ButtonState.DOWN) does not match value passed to setSkinForState()", downSkin, this._button.getSkinForState(ButtonState.DOWN));
			Assert.assertStrictlyEquals("BasicButton getSkinForState(ButtonState.DISABLED) does not match value passed to setSkinForState()", disabledSkin, this._button.getSkinForState(ButtonState.DISABLED));
		}
		
		[Test]
		public function testDefaultCurrentSkin():void
		{
			var defaultSkin:Quad = new Quad(200, 200);
			this._button.defaultSkin = defaultSkin;
			
			this._button.validate();
			Assert.assertStrictlyEquals("BasicButton state is not ButtonState.UP with no touch", ButtonState.UP, this._button.currentState);
			Assert.assertStrictlyEquals("BasicButton skin is not defaultSkin when currentState is ButtonState.UP and skin not provided for this state", defaultSkin, this._button.currentSkinInternal);

			this._button.isEnabled = false;
			this._button.validate();
			Assert.assertStrictlyEquals("BasicButton state is not ButtonState.DISABLED when isEnabled is false", ButtonState.DISABLED, this._button.currentState);
			Assert.assertStrictlyEquals("BasicButton skin is not defaultSkin when currentState is ButtonState.DISABLED and skin not provided for this state", defaultSkin, this._button.currentSkinInternal);

			this._button.isEnabled = true;
			
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be button", this._button, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("BasicButton state is not ButtonState.HOVER on TouchPhase.HOVER", ButtonState.HOVER, this._button.currentState);
			Assert.assertStrictlyEquals("BasicButton skin is not defaultSkin when currentState is ButtonState.HOVER and skin not provided for this state", defaultSkin, this._button.currentSkinInternal);
			
			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("BasicButton state is not ButtonState.DOWN on TouchPhase.BEGAN", ButtonState.DOWN, this._button.currentState);
			Assert.assertStrictlyEquals("BasicButton skin is not defaultSkin when currentState is ButtonState.DOWN and skin not provided for this state", defaultSkin, this._button.currentSkinInternal);
		}

		[Test]
		public function testCurrentSkinWithSetSkinForState():void
		{
			var defaultSkin:Quad = new Quad(200, 200);
			this._button.defaultSkin = defaultSkin;

			var upSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.UP, upSkin);

			var hoverSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.HOVER, hoverSkin);

			var downSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.DOWN, downSkin);

			var disabledSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.DISABLED, disabledSkin);

			this._button.validate();
			Assert.assertStrictlyEquals("BasicButton state is not ButtonState.UP with no touch", ButtonState.UP, this._button.currentState);
			Assert.assertStrictlyEquals("BasicButton skin does not match skin set with setSkinForState() when currentState is ButtonState.UP", upSkin, this._button.currentSkinInternal);
			
			this._button.isEnabled = false;
			this._button.validate();
			Assert.assertStrictlyEquals("BasicButton state is not ButtonState.DISABLED when isEnabled is false", ButtonState.DISABLED, this._button.currentState);
			Assert.assertStrictlyEquals("BasicButton skin does not match skin set with setSkinForState() when currentState is ButtonState.DISABLED", disabledSkin, this._button.currentSkinInternal);

			this._button.isEnabled = true;
			
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be button", this._button, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("BasicButton state is not ButtonState.HOVER on TouchPhase.HOVER", ButtonState.HOVER, this._button.currentState);
			Assert.assertStrictlyEquals("BasicButton skin does not match skin set with setSkinForState() when currentState is ButtonState.HOVER and skin not provided for this state", hoverSkin, this._button.currentSkinInternal);

			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("BasicButton state is not ButtonState.DOWN on TouchPhase.BEGAN", ButtonState.DOWN, this._button.currentState);
			Assert.assertStrictlyEquals("BasicButton skin does not match skin set with setSkinForState() when currentState is ButtonState.DOWN and skin not provided for this state", downSkin, this._button.currentSkinInternal);
		}
	}
}

import feathers.controls.BasicButton;

import starling.display.DisplayObject;

class ButtonWithInternalState extends BasicButton
{
	public function ButtonWithInternalState()
	{
		super();
	}
	
	public function get currentSkinInternal():DisplayObject
	{
		return this.currentSkin;
	}
}

================================================
FILE: test/source/feathers/tests/BasicButtonMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.BasicButton;
	import feathers.controls.LayoutGroup;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class BasicButtonMeasurementTests
	{
		private static const BACKGROUND_WIDTH:Number = 10;
		private static const BACKGROUND_HEIGHT:Number = 12;
		private static const COMPLEX_BACKGROUND_WIDTH:Number = 54;
		private static const COMPLEX_BACKGROUND_HEIGHT:Number = 55;
		private static const COMPLEX_BACKGROUND_MIN_WIDTH:Number = 38;
		private static const COMPLEX_BACKGROUND_MIN_HEIGHT:Number = 39;

		private var _button:BasicButton;

		[Before]
		public function prepare():void
		{
			this._button = new BasicButton();
			TestFeathers.starlingRoot.addChild(this._button);
		}

		[After]
		public function cleanup():void
		{
			this._button.removeFromParent(true);
			this._button = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function addSimpleBackground():void
		{
			this._button.defaultSkin = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT, 0xff00ff);
		}

		private function addComplexBackground():void
		{
			var backgroundSkin:LayoutGroup = new LayoutGroup();
			backgroundSkin.width = COMPLEX_BACKGROUND_WIDTH;
			backgroundSkin.height = COMPLEX_BACKGROUND_HEIGHT;
			backgroundSkin.minWidth = COMPLEX_BACKGROUND_MIN_WIDTH;
			backgroundSkin.minHeight = COMPLEX_BACKGROUND_MIN_HEIGHT;
			this._button.defaultSkin = backgroundSkin;
		}

		[Test]
		public function testAutoSizeWithSimpleBackgroundSkin():void
		{
			this.addSimpleBackground();
			this._button.validate();

			Assert.assertStrictlyEquals("The width of the BasicButton was not calculated correctly based on the background width.",
				BACKGROUND_WIDTH, this._button.width);
			Assert.assertStrictlyEquals("The height of the BasicButton was not calculated correctly based on the background height.",
				BACKGROUND_HEIGHT, this._button.height);
			Assert.assertStrictlyEquals("The minWidth of the BasicButton was not calculated correctly based on the background width.",
				BACKGROUND_WIDTH, this._button.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the BasicButton was not calculated correctly based on the background height.",
				BACKGROUND_HEIGHT, this._button.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexBackground():void
		{
			this.addComplexBackground();
			this._button.validate();

			Assert.assertStrictlyEquals("The width of the BasicButton was not calculated correctly based on the complex background width.",
				COMPLEX_BACKGROUND_WIDTH, this._button.width);
			Assert.assertStrictlyEquals("The height of the BasicButton was not calculated correctly based on the complex background height.",
				COMPLEX_BACKGROUND_HEIGHT, this._button.height);
			Assert.assertStrictlyEquals("The minWidth of the BasicButton was not calculated correctly based on the complex background minWidth.",
				COMPLEX_BACKGROUND_MIN_WIDTH, this._button.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the BasicButton was not calculated correctly based on the complex background minHeight.",
				COMPLEX_BACKGROUND_MIN_HEIGHT, this._button.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/BasicButtonTests.as
================================================
package feathers.tests
{
	import feathers.controls.BasicButton;
	import feathers.controls.ButtonState;
	import feathers.events.FeathersEventType;
	import feathers.tests.supportClasses.DisposeFlagQuad;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class BasicButtonTests
	{
		private var _button:BasicButton;
		private var _blocker:Quad;

		[Before]
		public function prepare():void
		{
			this._button = new BasicButton();
			this._button.defaultSkin = new Quad(200, 200, 0xff00ff);
			TestFeathers.starlingRoot.addChild(this._button);
			this._button.validate();
		}

		[After]
		public function cleanup():void
		{
			this._button.removeFromParent(true);
			this._button = null;

			if(this._blocker)
			{
				this._blocker.removeFromParent(true);
				this._blocker = null;
			}

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testTriggeredEvent():void
		{
			var hasTriggered:Boolean = false;
			this._button.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.TRIGGERED was not dispatched", hasTriggered);
		}

		[Test]
		public function testRemovedBeforeTriggered():void
		{
			var hasTriggered:Boolean = false;
			this._button.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.removeFromParent(false)
			Assert.assertFalse("Event.TRIGGERED must not be dispatched after removed from stage", hasTriggered);
		}

		[Test]
		public function testTouchMoveOutsideBeforeTriggeredEvent():void
		{
			var hasTriggered:Boolean = false;
			this._button.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.globalX = 1000; //move the touch way outside the bounds of the button
			touch.phase = TouchPhase.MOVED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertFalse("Event.TRIGGERED was incorrectly dispatched", hasTriggered);
		}

		[Test]
		public function testOtherDisplayObjectBlockingTriggeredEvent():void
		{
			var hasTriggered:Boolean = false;
			this._button.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			this._blocker = new Quad(200, 200, 0xff0000);
			TestFeathers.starlingRoot.addChild(this._blocker);

			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertFalse("Event.TRIGGERED was incorrectly dispatched", hasTriggered);
		}

		[Test]
		public function testButtonDefaultsToButtonStateUp():void
		{
			Assert.assertStrictlyEquals("Button currentState does not default to ButtonState.UP", ButtonState.UP, this._button.currentState);
		}

		[Test]
		public function testButtonDefaultsToButtonStateDisabledWhenIsEnabledIsFalse():void
		{
			this._button.isEnabled = false;
			Assert.assertStrictlyEquals("Button currentState does not default to ButtonState.DISABLED when isEnabled is false", ButtonState.DISABLED, this._button.currentState);
		}

		[Test]
		public function testButtonStateHoverOnTouchPhaseHover():void
		{
			var hasDispatchedStateChange:Boolean = false;
			this._button.addEventListener(FeathersEventType.STATE_CHANGE, function(event:Event):void
			{
				var button:BasicButton = BasicButton(event.currentTarget);
				if(button.currentState === ButtonState.HOVER)
				{
					hasDispatchedStateChange = true;
				}
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertStrictlyEquals("Button currentState was not changed to ButtonState.HOVER on TouchPhase.HOVER",
				ButtonState.HOVER, this._button.currentState);
			Assert.assertTrue("Button must dispatch FeathersEventType.STATE_CHANGE when state is changed to ButtonState.HOVER",
				hasDispatchedStateChange);
		}

		[Test]
		public function testButtonStateUpAfterHoverOut():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			var hasDispatchedStateChange:Boolean = false;
			this._button.addEventListener(FeathersEventType.STATE_CHANGE, function(event:Event):void
			{
				var button:BasicButton = BasicButton(event.currentTarget);
				if(button.currentState === ButtonState.UP)
				{
					hasDispatchedStateChange = true;
				}
			});
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, new <Touch>[]));
			Assert.assertStrictlyEquals("Button currentState was not changed to ButtonState.UP when TouchPhase.HOVER ends",
				ButtonState.UP, this._button.currentState);
			Assert.assertTrue("Button must dispatch FeathersEventType.STATE_CHANGE when state is changed to ButtonState.UP",
				hasDispatchedStateChange);
		}

		[Test]
		public function testButtonStateDownOnTouchPhaseBegan():void
		{
			var hasDispatchedStateChange:Boolean = false;
			this._button.addEventListener(FeathersEventType.STATE_CHANGE, function(event:Event):void
			{
				var button:BasicButton = BasicButton(event.currentTarget);
				if(button.currentState === ButtonState.DOWN)
				{
					hasDispatchedStateChange = true;
				}
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertStrictlyEquals("Button currentState was not changed to ButtonState.DOWN on TouchPhase.BEGAN",
				ButtonState.DOWN, this._button.currentState);
			Assert.assertTrue("Button must dispatch FeathersEventType.STATE_CHANGE when state is changed to ButtonState.DOWN",
				hasDispatchedStateChange);
		}

		[Test]
		public function testButtonStateUpOnRemovedFromStage():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			var hasDispatchedStateChange:Boolean = false;
			this._button.addEventListener(FeathersEventType.STATE_CHANGE, function(event:Event):void
			{
				var button:BasicButton = BasicButton(event.currentTarget);
				if(button.currentState === ButtonState.UP)
				{
					hasDispatchedStateChange = true;
				}
			});
			this._button.removeFromParent(false);
			Assert.assertStrictlyEquals("Button currentState was not changed to ButtonState.UP on removed from stage",
				ButtonState.UP, this._button.currentState);
			Assert.assertTrue("Button must dispatch FeathersEventType.STATE_CHANGE when state is changed to ButtonState.UP",
				hasDispatchedStateChange);
		}

		[Test]
		public function testButtonStateDisabledOnTouchWhenIsEnabledIsFalse():void
		{
			this._button.isEnabled = false;
			var hasDispatchedStateChange:Boolean = false;
			this._button.addEventListener(FeathersEventType.STATE_CHANGE, function(event:Event):void
			{
				hasDispatchedStateChange = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.removeFromParent(false);
			Assert.assertStrictlyEquals("Button currentState must not change from ButtonState.DISABLED when touch occurs and isEnabled is false",
				ButtonState.DISABLED, this._button.currentState);
			Assert.assertFalse("Button must not dispatch FeathersEventType.STATE_CHANGE when state is isEnabled and touch occurs",
				hasDispatchedStateChange);
		}

		[Test]
		public function testButtonStateUpOnTouchPhaseMoveOutside():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			var hasDispatchedStateChange:Boolean = false;
			this._button.addEventListener(FeathersEventType.STATE_CHANGE, function(event:Event):void
			{
				var button:BasicButton = BasicButton(event.currentTarget);
				if(button.currentState === ButtonState.UP)
				{
					hasDispatchedStateChange = true;
				}
			});
			touch.phase = TouchPhase.MOVED;
			touch.globalX = 1000;
			touch.globalY = position.y;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertStrictlyEquals("Button currentState was not changed to ButtonState.UP on TouchPhase.MOVED when position is outside button",
				ButtonState.UP, this._button.currentState);
			Assert.assertTrue("Button must dispatch FeathersEventType.STATE_CHANGE when state is changed to ButtonState.UP",
				hasDispatchedStateChange);
		}

		[Test]
		public function testButtonStateDownOnTouchPhaseMoveOutsideAndBackInside():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.MOVED;
			touch.globalX = 1000;
			touch.globalY = position.y;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			var hasDispatchedStateChange:Boolean = false;
			this._button.addEventListener(FeathersEventType.STATE_CHANGE, function(event:Event):void
			{
				var button:BasicButton = BasicButton(event.currentTarget);
				if(button.currentState === ButtonState.DOWN)
				{
					hasDispatchedStateChange = true;
				}
			});
			touch.globalX = 10;
			touch.globalY = position.y;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertStrictlyEquals("Button currentState was not changed to ButtonState.DOWN on TouchPhase.MOVED when position moves outside button then back inside",
				ButtonState.DOWN, this._button.currentState);
			Assert.assertTrue("Button must dispatch FeathersEventType.STATE_CHANGE when state is changed to ButtonState.DOWN",
				hasDispatchedStateChange);
		}

		[Test]
		public function testButtonStateUpOnTouchPhaseMoveOutsideAndKeepDownStateOnRollOutIsTrue():void
		{
			this._button.keepDownStateOnRollOut = true;
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			var hasDispatchedStateChange:Boolean = false;
			this._button.addEventListener(FeathersEventType.STATE_CHANGE, function(event:Event):void
			{
				hasDispatchedStateChange = true;
			});
			touch.phase = TouchPhase.MOVED;
			touch.globalX = 1000;
			touch.globalY = position.y;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertStrictlyEquals("Button currentState was incorrectly changed from ButtonState.DOWN on TouchPhase.MOVED when position is outside button and keepDownStateOnRollOut is true",
				ButtonState.DOWN, this._button.currentState);
			Assert.assertFalse("Button must not dispatch FeathersEventType.STATE_CHANGE when keepDownStateOnRollOut is true and state does not changed on roll out",
				hasDispatchedStateChange);
		}

		[Test]
		public function testButtonStateUpOnTouchPhaseEnded():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			var hasDispatchedStateChange:Boolean = false;
			this._button.addEventListener(FeathersEventType.STATE_CHANGE, function(event:Event):void
			{
				var button:BasicButton = BasicButton(event.currentTarget);
				if(button.currentState === ButtonState.UP)
				{
					hasDispatchedStateChange = true;
				}
			});
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertStrictlyEquals("Button currentState was not changed to ButtonState.UP on TouchPhase.ENDED",
				ButtonState.UP, this._button.currentState);
			Assert.assertTrue("Button must dispatch FeathersEventType.STATE_CHANGE when state is changed to ButtonState.UP",
				hasDispatchedStateChange);
		}

		[Test]
		public function testSkinsDisposed():void
		{
			var defaultSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.defaultSkin = defaultSkin;
			var upSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.UP, upSkin);
			var downSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.DOWN, downSkin);
			var hoverSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.HOVER, hoverSkin);
			var disabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.DISABLED, disabledSkin);
			this._button.validate();
			this._button.dispose();
			Assert.assertTrue("defaultSkin not disposed when Button disposed.", defaultSkin.isDisposed);
			Assert.assertTrue("upSkin not disposed when Button disposed.", upSkin.isDisposed);
			Assert.assertTrue("downSkin not disposed when Button disposed.", downSkin.isDisposed);
			Assert.assertTrue("hoverSkin not disposed when Button disposed.", hoverSkin.isDisposed);
			Assert.assertTrue("disabledSkin not disposed when Button disposed.", disabledSkin.isDisposed);
		}

		[Test]
		public function testSkinsRemovedWhenSetToNull():void
		{
			var defaultSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.defaultSkin = defaultSkin;
			var upSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.UP, upSkin);
			var downSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.DOWN, downSkin);
			var hoverSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.HOVER, hoverSkin);
			var disabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.DISABLED, disabledSkin);
			this._button.validate();
			this._button.defaultSkin = null;
			this._button.setSkinForState(ButtonState.UP, null);
			this._button.setSkinForState(ButtonState.DOWN, null);
			this._button.setSkinForState(ButtonState.HOVER, null);
			this._button.setSkinForState(ButtonState.DISABLED, null);
			//should not need to validate here
			this._button.dispose();
			Assert.assertFalse("Removed defaultSkin incorrectly disposed when Button disposed.", defaultSkin.isDisposed);
			Assert.assertFalse("Removed upSkin incorrectly disposed when Button disposed.", upSkin.isDisposed);
			Assert.assertFalse("Removed downSkin incorrectly disposed when Button disposed.", downSkin.isDisposed);
			Assert.assertFalse("Removed hoverSkin incorrectly disposed when Button disposed.", hoverSkin.isDisposed);
			Assert.assertFalse("Removed disabledSkin incorrectly disposed when Button disposed.", disabledSkin.isDisposed);
			Assert.assertNull("defaultSkin parent must be null when removed from Button.", defaultSkin.parent);
			Assert.assertNull("upSkin parent must be null when removed from Button.", upSkin.parent);
			Assert.assertNull("downSkin parent must be null when removed from Button.", downSkin.parent);
			Assert.assertNull("hoverSkin parent must be null when removed from Button.", hoverSkin.parent);
			Assert.assertNull("disabledSkin parent must be null when removed from Button.", disabledSkin.parent);
			defaultSkin.dispose();
			upSkin.dispose();
			downSkin.dispose();
			hoverSkin.dispose();
			disabledSkin.dispose();
		}
	}
}


================================================
FILE: test/source/feathers/tests/BitmapFontTextEditorFocusTests.as
================================================
package feathers.tests
{
	import feathers.controls.TextInput;
	import feathers.controls.TextInputState;
	import feathers.controls.text.BitmapFontTextEditor;
	import feathers.core.FocusManager;
	import feathers.events.FeathersEventType;

	import flash.events.KeyboardEvent;
	import flash.events.TextEvent;
	import flash.geom.Point;
	import flash.ui.Keyboard;

	import org.flexunit.Assert;
	import org.flexunit.async.Async;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class BitmapFontTextEditorFocusTests
	{
		private static const CURSOR_SKIN_NAME:String = "test-cursor-skin";
		private static const SELECTION_SKIN_NAME:String = "test-selection-skin";

		private var _textInput:TextInput;
		private var _textEditor:BitmapFontTextEditor;

		[Before]
		public function prepare():void
		{
			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, true);

			this._textInput = new TextInput();
			this._textInput.backgroundSkin = new Quad(200, 200);
			this._textInput.textEditorFactory = textEditorFactory;
			TestFeathers.starlingRoot.addChild(this._textInput);
			this._textInput.validate();
		}

		private function textEditorFactory():BitmapFontTextEditor
		{
			this._textEditor = new BitmapFontTextEditor();
			var cursorSkin:Quad = new Quad(1, 1, 0xff00ff);
			cursorSkin.name = CURSOR_SKIN_NAME;
			this._textEditor.cursorSkin = cursorSkin;
			var selectionSkin:Quad = new Quad(1, 1, 0xff00ff);
			selectionSkin.name = SELECTION_SKIN_NAME;
			this._textEditor.selectionSkin = selectionSkin;
			return this._textEditor;
		}

		[After]
		public function cleanup():void
		{
			//one of the tests sets the parent's visible property to false, so
			//it needs to be reset.
			this._textInput.parent.visible = true;

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);
			this._textInput.removeFromParent(true);
			this._textInput = null;

			this._textEditor = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testFocusInEventAfterSetFocus():void
		{
			var hasDispatchedFocusIn:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_IN, function(event:Event):void
			{
				hasDispatchedFocusIn = true;
			});
			this._textInput.setFocus();
			Assert.assertTrue("BitmapFontTextEditor: FeathersEventType.FOCUS_IN was not dispatched after calling setFocus() on TextInput",
				hasDispatchedFocusIn);
		}

		[Test]
		public function testFocusInEventAfterTouch():void
		{
			var hasDispatchedFocusIn:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_IN, function(event:Event):void
			{
				hasDispatchedFocusIn = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._textInput.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("BitmapFontTextEditor: FeathersEventType.FOCUS_IN was not dispatched after TouchEvent.TOUCH on TextInput",
				hasDispatchedFocusIn);
		}

		[Test]
		public function testFocusOutEventAfterSetFocusThenClearFocus():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_OUT, function(event:Event):void
			{
				hasDispatchedFocusOut = true;
			});
			this._textInput.setFocus();
			this._textInput.clearFocus();
			Assert.assertTrue("BitmapFontTextEditor: FeathersEventType.FOCUS_OUT was not dispatched after calling clearFocus() on TextInput",
				hasDispatchedFocusOut);
		}

		[Test]
		public function testFocusOutEventAfterTouchInsideThenTouchOutside():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_OUT, function(event:Event):void
			{
				hasDispatchedFocusOut = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._textInput.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.target = target.stage;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 1000;
			touch.globalY = 1000;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("BitmapFontTextEditor: FeathersEventType.FOCUS_OUT was not dispatched after TouchEvent.TOUCH inside TextInput followed by TouchEvent.TOUCH outside TextInput",
				hasDispatchedFocusOut);
		}

		[Test]
		public function testFocusOutEventAfterSetFocusThenTouchOutside():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_OUT, function(event:Event):void
			{
				hasDispatchedFocusOut = true;
			});
			this._textInput.setFocus();
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._textInput.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = this._textInput.stage;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 1000;
			touch.globalY = 1000;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("BitmapFontTextEditor: FeathersEventType.FOCUS_OUT was not dispatched after calling setFocus() on TextInput followed by TouchEvent.TOUCH outside TextInput",
				hasDispatchedFocusOut);
		}

		[Test]
		public function testFocusOutEventAfterTouchInsideThenClearFocus():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_OUT, function(event:Event):void
			{
				hasDispatchedFocusOut = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._textInput.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._textInput.clearFocus();
			Assert.assertTrue("BitmapFontTextEditor: FeathersEventType.FOCUS_OUT was not dispatched after TouchEvent.TOUCH inside TextInput followed by calling clearFocus() on TextInput",
				hasDispatchedFocusOut);
		}

		[Test(async)]
		public function testFocusOutEventAfterSetTextInputParentVisibleToFalse():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_OUT, function(event:Event):void
			{
				hasDispatchedFocusOut = true;
			});
			this._textInput.setFocus();
			this._textInput.parent.visible = false;
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("FeathersEventType.FOCUS_OUT was not dispatched after setting TextInput parent's visible property to false when using BitmapFontTextEditor", hasDispatchedFocusOut);
			}, 100);
		}

		[Test]
		public function testSelectionChangeAfterSelectAllEvent():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			//clear the automatic selection caused by giving it focus
			this._textInput.selectRange(0, 0);
			//and validate the commit this change
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new flash.events.Event(flash.events.Event.SELECT_ALL, true));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed after Ctrl/Cmd+A to select all",
				0, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed after Ctrl/Cmd+A to select all",
				this._textInput.text.length, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSelectionChangeAfterSelectAllEventAndKeyboardShiftLeft():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			//clear the automatic selection caused by giving it focus
			this._textInput.selectRange(0, 0);
			//and validate the commit this change
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new flash.events.Event(flash.events.Event.SELECT_ALL, true));
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.LEFT, 0, false, false, true));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after Ctrl/Cmd+A to select all and pressing Keyboard.LEFT and shift key",
				0, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after Ctrl/Cmd+A to select all and pressing Keyboard.LEFT and shift key",
				this._textInput.text.length - 1, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSelectionChangeAfterSelectAllEventAndKeyboardLeft():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			//clear the automatic selection caused by giving it focus
			this._textInput.selectRange(0, 0);
			//and validate the commit this change
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new flash.events.Event(flash.events.Event.SELECT_ALL, true));
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.LEFT, 0, false, false, false));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after Ctrl/Cmd+A to select all and pressing Keyboard.LEFT",
				0, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after Ctrl/Cmd+A to select all and pressing Keyboard.LEFT",
				0, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSelectionChangeAfterSelectAllEventAndKeyboardRight():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			//clear the automatic selection caused by giving it focus
			this._textInput.selectRange(0, 0);
			//and validate the commit this change
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new flash.events.Event(flash.events.Event.SELECT_ALL, true));
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.RIGHT, 0, false, false, false));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after Ctrl/Cmd+A to select all and pressing Keyboard.RIGHT",
				this._textInput.text.length, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after Ctrl/Cmd+A to select all and pressing Keyboard.RIGHT",
				this._textInput.text.length, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSelectionChangeAfterSelectRange():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 8;
			this._textInput.selectRange(rangeStart, rangeEnd);
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.LEFT",
				rangeStart, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.LEFT",
				rangeEnd, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSelectionChangeAfterSelectRangeAndKeyboardLeft():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 8;
			this._textInput.selectRange(rangeStart, rangeEnd);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.LEFT, 0, false, false, false));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.LEFT",
				rangeStart, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.LEFT",
				rangeStart, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSelectionChangeAfterSelectRangeAndKeyboardRight():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 8;
			this._textInput.selectRange(rangeStart, rangeEnd);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.RIGHT, 0, false, false, false));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.RIGHT",
				rangeEnd, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.RIGHT",
				rangeEnd, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSelectRangeAndKeyboardDelete():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 8;
			this._textInput.selectRange(rangeStart, rangeEnd);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.DELETE, 0, false, false, false));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.DELETE",
				rangeStart, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.DELETE",
				rangeStart, this._textInput.selectionEndIndex);
			Assert.assertStrictlyEquals("text not changed correctly after selectRange() and pressing Keyboard.DELETE",
				"Herld", this._textInput.text);
		}

		[Test]
		public function testSelectRangeAndKeyboardBackspace():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 8;
			this._textInput.selectRange(rangeStart, rangeEnd);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.BACKSPACE, 0, false, false, false));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.BACKSPACE",
				rangeStart, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.BACKSPACE",
				rangeStart, this._textInput.selectionEndIndex);
			Assert.assertStrictlyEquals("text not changed correctly after selectRange() and pressing Keyboard.BACKSPACE",
				"Herld", this._textInput.text);
		}

		[Test]
		public function testSelectRangeAndTyping():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 8;
			var textToType:String = "test";
			this._textInput.selectRange(rangeStart, rangeEnd);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new TextEvent(TextEvent.TEXT_INPUT, false, false, textToType));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and typing some text",
				rangeStart + textToType.length, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and typing some text",
				rangeStart + textToType.length, this._textInput.selectionEndIndex);
			Assert.assertStrictlyEquals("text not changed correctly after selectRange() and typing some text",
				"He" + textToType + "rld", this._textInput.text);
		}

		[Test]
		public function testSetCursorAndKeyboardDelete():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var cursorIndex:int = 2;
			this._textInput.selectRange(cursorIndex, cursorIndex);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.DELETE, 0, false, false, false));
			Assert.assertStrictlyEquals("selectionBeginIndex incorrectly changed after selectRange() and pressing Keyboard.DELETE",
				cursorIndex, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex incorrectly changed after selectRange() and pressing Keyboard.DELETE",
				cursorIndex, this._textInput.selectionEndIndex);
			Assert.assertStrictlyEquals("text not changed correctly after selectRange() and pressing Keyboard.DELETE",
				"Helo World", this._textInput.text);
		}

		[Test]
		public function testSetCursorAndKeyboardBackspace():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var cursorIndex:int = 2;
			this._textInput.selectRange(cursorIndex, cursorIndex);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.BACKSPACE, 0, false, false, false));
			cursorIndex--;
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.BACKSPACE",
				cursorIndex, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.BACKSPACE",
				cursorIndex, this._textInput.selectionEndIndex);
			Assert.assertStrictlyEquals("text not changed correctly after selectRange() and pressing Keyboard.BACKSPACE",
				"Hllo World", this._textInput.text);
		}

		[Test]
		public function testSetCursorAndKeyboardUp():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var cursorIndex:int = 2;
			this._textInput.selectRange(cursorIndex, cursorIndex);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.UP, 0, false, false, false));
			cursorIndex = 0;
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.UP",
				cursorIndex, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.UP",
				cursorIndex, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSetCursorAndKeyboardDown():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var cursorIndex:int = 2;
			this._textInput.selectRange(cursorIndex, cursorIndex);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.DOWN, 0, false, false, false));
			cursorIndex = this._textInput.text.length;
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.DOWN",
				cursorIndex, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.DOWN",
				cursorIndex, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSetCursorAndKeyboardLeft():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var cursorIndex:int = 2;
			this._textInput.selectRange(cursorIndex, cursorIndex);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.LEFT, 0, false, false, false));
			cursorIndex--;
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.LEFT",
				cursorIndex, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.LEFT",
				cursorIndex, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSetCursorAndKeyboardRight():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var cursorIndex:int = 2;
			this._textInput.selectRange(cursorIndex, cursorIndex);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.RIGHT, 0, false, false, false));
			cursorIndex++;
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.RIGHT",
				cursorIndex, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.RIGHT",
				cursorIndex, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSetCursorAndKeyboardShiftLeft():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 2;
			this._textInput.selectRange(rangeStart, rangeEnd);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.LEFT, 0, false, false, true));
			rangeStart--;
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.LEFT and shift key",
				rangeStart, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.LEFT and shift key",
				rangeEnd, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSetCursorAndKeyboardShiftRight():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 2;
			this._textInput.selectRange(rangeStart, rangeEnd);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.RIGHT, 0, false, false, true));
			rangeEnd++;
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.RIGHT and shift key",
				rangeStart, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.RIGHT and shift key",
				rangeEnd, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSetCursorAndTyping():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var cursorIndex:int = 2;
			var textToType:String = "test";
			this._textInput.selectRange(cursorIndex, cursorIndex);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new TextEvent(TextEvent.TEXT_INPUT, false, false, textToType));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and typing some text",
				cursorIndex + textToType.length, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and typing some text",
				cursorIndex + textToType.length, this._textInput.selectionEndIndex);
			Assert.assertStrictlyEquals("text not changed correctly after selectRange() and typing some text",
				"He" + textToType + "llo World", this._textInput.text);
		}

		[Test]
		public function testSetFocusWhenFocusEnabledFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isFocusEnabled = false;
			this._textInput.validate();
			Assert.assertNotNull("BitmapFontTextEditor nativeFocus must not be null when isFocusEnabled is false",
				this._textInput.nativeFocus);
			Assert.assertTrue("BitmapFontTextEditor nativeFocus must not receive nativeStage focus when isFocusEnabled is false",
				Starling.current.nativeStage.focus !== this._textInput.nativeFocus);
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertTrue("TextInput must not receive FocusManager focus when using BitmapFontTextEditor and isFocusEnabled is false",
				this._textInput.focusManager.focus !== this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.ENABLED after attempt to receive FocusManager focus when using BitmapFontTextEditor and isFocusEnabled is false",
				TextInputState.ENABLED, this._textInput.currentState);
		}

		[Test]
		public function testReceiveFocusWhenEditableFalseAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = false;
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			this._textInput.validate();
			Assert.assertStrictlyEquals("BitmapFontTextEditor nativeFocus must receive nativeStage focus when isEditable is false and isSelectable is false",
				Starling.current.nativeStage.focus, this._textInput.nativeFocus);
			Assert.assertStrictlyEquals("TextInput must receive FocusManager focus when using BitmapFontTextEditor and isEditable is false and isSelectable is false",
				this._textInput.focusManager.focus, this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.FOCUSED after receive FocusManager focus when using BitmapFontTextEditor and isEditable is false and isSelectable is false",
				TextInputState.FOCUSED, this._textInput.currentState);
		}

		[Test]
		public function testSetFocusWhenEditableTrueAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = true;
			this._textInput.isSelectable = false;
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertStrictlyEquals("BitmapFontTextEditor nativeFocus must receive nativeStage focus when isEditable is true and isSelectable is false",
				Starling.current.nativeStage.focus, this._textInput.nativeFocus);
			Assert.assertStrictlyEquals("TextInput must receive FocusManager focus when using BitmapFontTextEditor and isEditable is true and isSelectable is false",
				this._textInput.focusManager.focus, this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.FOCUSED after receive FocusManager focus when using BitmapFontTextEditor and isEditable is true and isSelectable is false",
				TextInputState.FOCUSED, this._textInput.currentState);
		}

		[Test]
		public function testSetFocusWhenEditableFalseAndSelectableTrue():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = true;
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertStrictlyEquals("BitmapFontTextEditor nativeFocus must receive nativeStage focus when isEditable is false and isSelectable is true",
				Starling.current.nativeStage.focus, this._textInput.nativeFocus);
			Assert.assertStrictlyEquals("TextInput must receive FocusManager focus when using BitmapFontTextEditor and isEditable is false and isSelectable is true",
				this._textInput.focusManager.focus, this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.FOCUSED after receive FocusManager focus when using BitmapFontTextEditor and isEditable is false and isSelectable is true",
				TextInputState.FOCUSED, this._textInput.currentState);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithNoCharactersSelected():void
		{
			this._textInput.text = "Hello World";
			this._textInput.selectRange(1, 1);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertTrue("BitmapFontTextEditor cursorSkin must be visible when no characters selected",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertFalse("BitmapFontTextEditor selectionSkin must not be visible when no characters selected",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithMultipleCharactersSelected():void
		{
			this._textInput.text = "Hello World";
			this._textInput.selectRange(1, 3);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertFalse("BitmapFontTextEditor cursorSkin must not be visible when multiple characters selected",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertTrue("BitmapFontTextEditor selectionSkin must be visible when multiple characters selected",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithNoCharactersSelectedEditableFalseAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = false;
			this._textInput.selectRange(1, 1);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertFalse("BitmapFontTextEditor cursorSkin must not be visible when no characters selected, isEditable is false, and isSelectable is false",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertFalse("BitmapFontTextEditor selectionSkin must not be visible when no characters selected, isEditable is false, and isSelectable is false",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithMultipleCharactersSelectedEditableFalseAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = false;
			this._textInput.selectRange(1, 3);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertFalse("BitmapFontTextEditor cursorSkin must not be visible when multiple characters selected, isEditable is false, and isSelectable is false",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertFalse("BitmapFontTextEditor selectionSkin must not be visible when multiple characters selected, isEditable is false, and isSelectable is false",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithNoCharactersSelectedEditableTrueAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = true;
			this._textInput.isSelectable = false;
			this._textInput.selectRange(1, 1);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertTrue("BitmapFontTextEditor cursorSkin must be visible when no characters selected, isEditable is true, and isSelectable is false",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertFalse("BitmapFontTextEditor selectionSkin must not be visible when no characters selected, isEditable is true, and isSelectable is false",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithMultipleCharactersSelectedEditableTrueAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = true;
			this._textInput.isSelectable = false;
			this._textInput.selectRange(1, 3);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertFalse("BitmapFontTextEditor cursorSkin must not be visible when multiple characters selected, isEditable is true, and isSelectable is false",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertTrue("BitmapFontTextEditor selectionSkin must be visible when multiple characters selected, isEditable is true, and isSelectable is false",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithNoCharactersSelectedEditableFalseAndSelectableTrue():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = true;
			this._textInput.selectRange(1, 1);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertFalse("BitmapFontTextEditor cursorSkin must not be visible when no characters selected, isEditable is false, and isSelectable is true",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertFalse("BitmapFontTextEditor selectionSkin must not be visible when no characters selected, isEditable is false, and isSelectable is true",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithMultipleCharactersSelectedEditableFalseAndSelectableTrue():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = true;
			this._textInput.selectRange(1, 3);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertFalse("BitmapFontTextEditor cursorSkin must not be visible when multiple characters selected, isEditable is false, and isSelectable is true",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertTrue("BitmapFontTextEditor selectionSkin must be visible when multiple characters selected, isEditable is false, and isSelectable is true",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}
	}
}


================================================
FILE: test/source/feathers/tests/BitmapFontTextRendererTests.as
================================================
package feathers.tests
{
	import feathers.controls.text.BitmapFontTextRenderer;
	import feathers.tests.supportClasses.CustomStateContext;
	import feathers.text.BitmapFontTextFormat;
	import feathers.text.FontStylesSet;

	import org.flexunit.Assert;

	import starling.text.BitmapFont;
	import starling.text.TextField;
	import starling.text.TextFormat;

	public class BitmapFontTextRendererTests
	{
		private static const STATE_DISABLED:String = "disabled";

		private static const DEFAULT_FONT_NAME:String = "DefaultFont";
		private static const DEFAULT_FONT_SIZE:Number = 16;
		private static const DEFAULT_COLOR:uint = 0xff00ff;
		private static const DISABLED_FONT_NAME:String = "DisabledFont";
		private static const DISABLED_FONT_SIZE:Number = 15;
		private static const DISABLED_COLOR:uint = 0x999999;
		private static const SELECTED_FONT_NAME:String = "SelectedFont";
		private static const SELECTED_FONT_SIZE:Number = 17;
		private static const SELECTED_COLOR:uint = 0xff0000;
		private static const STATE_FONT_NAME:String = "StateFont";
		private static const STATE_FONT_SIZE:Number = 18;
		private static const STATE_COLOR:uint = 0xffffff;

		private var _textRenderer:BitmapFontTextRenderer;

		[Before]
		public function prepare():void
		{
			TextField.registerCompositor(new BitmapFont(), DEFAULT_FONT_NAME);
			TextField.registerCompositor(new BitmapFont(), DISABLED_FONT_NAME);
			TextField.registerCompositor(new BitmapFont(), SELECTED_FONT_NAME);
			TextField.registerCompositor(new BitmapFont(), STATE_FONT_NAME);

			this._textRenderer = new BitmapFontTextRenderer();
			TestFeathers.starlingRoot.addChild(this._textRenderer);
		}

		[After]
		public function cleanup():void
		{
			this._textRenderer.removeFromParent(true);
			this._textRenderer = null;

			TextField.unregisterCompositor(DEFAULT_FONT_NAME);
			TextField.unregisterCompositor(DISABLED_FONT_NAME);
			TextField.unregisterCompositor(SELECTED_FONT_NAME);
			TextField.unregisterCompositor(STATE_FONT_NAME);

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testMaxWidth0WithWordWrap():void
		{
			this._textRenderer.text = "Test";
			this._textRenderer.wordWrap = true;
			this._textRenderer.maxWidth = 0;
			this._textRenderer.validate();
		}

		[Test]
		public function testOneLineWithEmptyString():void
		{
			this._textRenderer.text = "";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer numLines must be 1 with empty string", 1, this._textRenderer.numLines);
		}

		[Test]
		public function testOneLine():void
		{
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer numLines must be 1", 1, this._textRenderer.numLines);
		}

		[Test]
		public function testNumLinesWithLineBreak():void
		{
			this._textRenderer.text = "Hello\nWorld";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer numLines must be 2 when line break is in text", 2, this._textRenderer.numLines);
		}

		[Test]
		public function testNumLinesWithCarriageReturn():void
		{
			this._textRenderer.text = "Hello\rWorld";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer numLines must be 2 when carriage return is in text", 2, this._textRenderer.numLines);
		}

		[Test]
		public function testGetTextFormatForStateWithoutSetTextFormatForState():void
		{
			Assert.assertNull("BitmapFontTextRenderer getTextFormatForState() must return null if BitmapFontTextFormat not provided with setTextFormatForState()",
				this._textRenderer.getTextFormatForState(STATE_DISABLED));
		}

		[Test]
		public function testGetTextFormatForStateAfterSetTextFormatForState():void
		{
			var textFormat:BitmapFontTextFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.setTextFormatForState(STATE_DISABLED, textFormat);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer getTextFormatForState() must return value passed to setTextFormatForState() with same state",
				textFormat, this._textRenderer.getTextFormatForState(STATE_DISABLED));
		}

		[Test]
		public function testCurrentTextFormatWithTextFormat():void
		{
			this._textRenderer.textFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat must be equal to textFormat when no other text formats are specified",
				this._textRenderer.textFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithTextFormatAndDisabled():void
		{
			this._textRenderer.textFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.text = "Hello World";
			this._textRenderer.isEnabled = false;
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat must be equal to textFormat when isEnabled is false, but no other text formats are specified",
				this._textRenderer.textFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithDisabledTextFormatAndDisabled():void
		{
			this._textRenderer.textFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.disabledTextFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.text = "Hello World";
			this._textRenderer.isEnabled = false;
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat must be equal to disabledTextFormat when isEnabled is false and disabledTextFormat is not null",
				this._textRenderer.disabledTextFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithTextFormatAndStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			this._textRenderer.textFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat must be equal to textFormat when stateContext isEnabled is false, but no other text formats are specified",
				this._textRenderer.textFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithDisabledTextFormatAndStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			this._textRenderer.textFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.disabledTextFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat must be equal to disabledTextFormat when isEnabled is false and disabledTextFormat is not null",
				this._textRenderer.disabledTextFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithTextFormatAndStateContextSelected():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			this._textRenderer.stateContext = stateContext;
			this._textRenderer.textFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat must be equal to textFormat when stateContext isSelected is true, but no other text formats are specified",
				this._textRenderer.textFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithSelectedTextFormatAndStateContextSelected():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			this._textRenderer.stateContext = stateContext;
			this._textRenderer.textFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.selectedTextFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat must be equal to selectedTextFormat when isSelected is true and selectedTextFormat is not null",
				this._textRenderer.selectedTextFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithSelectedAndDisabledTextFormatAndStateContextSelectedAndDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			this._textRenderer.textFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.disabledTextFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.selectedTextFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			//disabled should get priority over selected
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat must be equal to disabledTextFormat when isSelected is true and isEnabled is false and both selectedTextFormat and disabledTextFormat are not null",
				this._textRenderer.disabledTextFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithOnlyTextFormatAndStateContextCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.currentState = STATE_DISABLED;
			this._textRenderer.stateContext = stateContext;
			this._textRenderer.textFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat must be equal to textFormat when no other text formats are specified",
				this._textRenderer.textFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithDisabledTextFormatAndStateTextFormatWithStateContextDisabledAndCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			stateContext.isSelected = true;
			stateContext.currentState = STATE_DISABLED;
			this._textRenderer.stateContext = stateContext;
			this._textRenderer.textFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.disabledTextFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.selectedTextFormat = new BitmapFontTextFormat(new BitmapFont());
			var disabledStateTextFormat:BitmapFontTextFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.setTextFormatForState(STATE_DISABLED, disabledStateTextFormat);
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			//exact states always get priority over default/disabled/selected
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat must be equal to BitmapFontTextFormat passed into setTextFormatForState() when isEnabled is false and disabledTextFormat are not null",
				disabledStateTextFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testFontStylesIgnoredIfAdvancedBitmapFontTextFormatExists():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat();
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.textFormat = new BitmapFontTextFormat(new BitmapFont());
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat must be equal to elementFormat and not a format from font styles",
				this._textRenderer.textFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithFontStyles():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.fontName must be equal to starling.text.TextFormat font",
				TextField.getBitmapFont(DEFAULT_FONT_NAME), this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatFallBackToDefaultFontStylesWhenDisabled():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.isEnabled = false;
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.fontName must be equal to starling.text.TextFormat font",
				TextField.getBitmapFont(DEFAULT_FONT_NAME), this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatUseDisabledFontStylesWhenDisabled():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.disabledFormat = new TextFormat(DISABLED_FONT_NAME, DISABLED_FONT_SIZE, DISABLED_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.isEnabled = false;
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.fontName must be equal to starling.text.TextFormat font",
				TextField.getBitmapFont(DISABLED_FONT_NAME), this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DISABLED_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DISABLED_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatFallBackToDefaultFontStylesWithStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.fontName must be equal to starling.text.TextFormat font",
				TextField.getBitmapFont(DEFAULT_FONT_NAME), this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatUseDisabledFontStylesWithStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.disabledFormat = new TextFormat(DISABLED_FONT_NAME, DISABLED_FONT_SIZE, DISABLED_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.fontName must be equal to starling.text.TextFormat font",
				TextField.getBitmapFont(DISABLED_FONT_NAME), this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DISABLED_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DISABLED_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatFallBackToDefaultFontStylesWithStateContextSelected():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.fontName must be equal to starling.text.TextFormat font",
				TextField.getBitmapFont(DEFAULT_FONT_NAME), this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatUseSelectedFontStylesWithStateContextSelected():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.selectedFormat = new TextFormat(SELECTED_FONT_NAME, SELECTED_FONT_SIZE, SELECTED_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.fontName must be equal to starling.text.TextFormat font",
				TextField.getBitmapFont(SELECTED_FONT_NAME), this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				SELECTED_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				SELECTED_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatUseDisabledFontStylesWithStateContextSelectedAndDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.selectedFormat = new TextFormat(SELECTED_FONT_NAME, SELECTED_FONT_SIZE, SELECTED_COLOR);
			fontStyles.disabledFormat = new TextFormat(DISABLED_FONT_NAME, DISABLED_FONT_SIZE, DISABLED_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			//disabled should get priority over selected
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.fontName must be equal to starling.text.TextFormat font",
				TextField.getBitmapFont(DISABLED_FONT_NAME), this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DISABLED_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DISABLED_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatFallBackToDefaultFontStylesWithStateContextCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.currentState = STATE_DISABLED;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.fontName must be equal to starling.text.TextFormat font",
				TextField.getBitmapFont(DEFAULT_FONT_NAME), this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatUseStateFontStylesWithStateContextCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.currentState = STATE_DISABLED;
			stateContext.isSelected = true;
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.selectedFormat = new TextFormat(SELECTED_FONT_NAME, SELECTED_FONT_SIZE, SELECTED_COLOR);
			fontStyles.disabledFormat = new TextFormat(DISABLED_FONT_NAME, DISABLED_FONT_SIZE, DISABLED_COLOR);
			fontStyles.setFormatForState(STATE_DISABLED, new TextFormat(STATE_FONT_NAME, STATE_FONT_SIZE, STATE_COLOR));
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			//exact states always get priority over default/disabled/selected
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.fontName must be equal to starling.text.TextFormat font",
				TextField.getBitmapFont(STATE_FONT_NAME), this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				STATE_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("BitmapFontTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				STATE_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testInvalidAfterChangePropertyOfFontStyles():void
		{
			var format:TextFormat = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = format
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			format.color = SELECTED_COLOR;
			Assert.assertTrue("BitmapFontTextRenderer: must be invalid after changing property of font styles.",
				this._textRenderer.isInvalid());
		}
	}
}


================================================
FILE: test/source/feathers/tests/BottomDrawerPopUpContentManagerTests.as
================================================
package feathers.tests
{
	import feathers.controls.popups.BottomDrawerPopUpContentManager;
	import feathers.core.PopUpManager;

	import org.flexunit.Assert;
	import org.flexunit.async.Async;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.display.Sprite;
	import starling.events.Event;

	public class BottomDrawerPopUpContentManagerTests
	{
		private static const OVERLAY_NAME:String = "BottomDrawerPopUpContentManagerOverlay";
		
		private var _popUp:DisplayObject;
		private var _customRoot:Sprite;
		private var _source:Quad;
		private var _popUpContentManager:BottomDrawerPopUpContentManager;

		[Before]
		public function prepare():void
		{
			this._source = new Quad(200, 180, 0x00ff00);
			TestFeathers.starlingRoot.addChild(this._source);

			this._customRoot = new Sprite();
			TestFeathers.starlingRoot.addChild(this._customRoot);
			PopUpManager.root = this._customRoot;
			
			this._popUpContentManager = new BottomDrawerPopUpContentManager();
		}

		[After]
		public function cleanup():void
		{
			this._source.removeFromParent(true);
			this._source = null;

			this._customRoot.removeFromParent(true);
			this._customRoot = null;

			if(this._popUp)
			{
				this._popUp.removeFromParent(true);
				this._popUp = null;
			}

			PopUpManager.root = TestFeathers.starlingRoot.stage;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}
		
		private function createSimplePopUp():DisplayObject
		{
			var simplePopUp:Quad = new Quad(100, 150, 0xff00ff);
			return simplePopUp;
		}

		private function createOverlay():DisplayObject
		{
			var overlay:Quad = new Quad(1, 1, 0x000000);
			overlay.alpha = 0.5;
			overlay.name = OVERLAY_NAME;
			return overlay;
		}
		
		[Test(async)]
		public function testOpen():void
		{
			this._popUp = this.createSimplePopUp();
			var openDispatched:Boolean = false;
			this._popUpContentManager.addEventListener(Event.OPEN, function(event:Event):void
			{
				openDispatched = true;
			});
			this._popUpContentManager.openOrCloseDuration = 0.2;
			this._popUpContentManager.open(this._popUp, this._source);
			Async.delayCall(this, function():void
			{
				Assert.assertNotNull("BottomDrawerPopUpContentManager content parent should not be null.", _popUp.parent);
				Assert.assertTrue("BottomDrawerPopUpContentManager did not dispatch Event.OPEN.", openDispatched);
			}, 400);
		}

		[Test(async)]
		public function testClose():void
		{
			this._popUp = this.createSimplePopUp();
			var closeDispatched:Boolean = false;
			this._popUpContentManager.addEventListener(Event.CLOSE, function(event:Event):void
			{
				closeDispatched = true;
			});
			this._popUpContentManager.openOrCloseDuration = 0.2;
			this._popUpContentManager.open(this._popUp, this._source);
			this._popUpContentManager.close();
			Async.delayCall(this, function():void
			{
				Assert.assertNull("BottomDrawerPopUpContentManager content parent should be null.", _popUp.parent);
				Assert.assertTrue("BottomDrawerPopUpContentManager did not dispatch Event.CLOSE.", closeDispatched);
			}, 400);
		}

		[Test]
		public function testOverlayFactory():void
		{
			this._popUp = this.createSimplePopUp();
			this._popUpContentManager.overlayFactory = this.createOverlay;
			this._popUpContentManager.open(this._popUp, this._source);
			var overlay:DisplayObject = this._customRoot.getChildByName(OVERLAY_NAME);
			Assert.assertNotNull("DropDownPopUpContentManager overlayFactory result not found.", overlay);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ButtonFocusTests.as
================================================
package feathers.tests
{
	import feathers.controls.Button;
	import feathers.core.FocusManager;
	import feathers.events.FeathersEventType;

	import flash.ui.Keyboard;

	import org.flexunit.Assert;

	import starling.display.ButtonState;

	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.KeyboardEvent;

	public class ButtonFocusTests
	{
		private var _target:Button;

		[Before]
		public function prepare():void
		{
			this._target = new Button();
			this._target.defaultSkin = new Quad(200, 200, 0xff00ff);
			TestFeathers.starlingRoot.addChild(this._target);

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, true);
		}

		[After]
		public function cleanup():void
		{
			this._target.removeFromParent(true);
			this._target = null;

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
			Assert.assertFalse("FocusManager not disabled on cleanup.", FocusManager.isEnabledForStage(TestFeathers.starlingRoot.stage));
		}

		[Test]
		public function testDownStateOnKeyDown():void
		{
			FocusManager.focus = this._target;
			var hasChangedState:Boolean = false;
			this._target.addEventListener(FeathersEventType.STATE_CHANGE, function(event:Event):void
			{
				hasChangedState = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertTrue("FeathersEventType.STATE_CHANGE was not dispatched",
				hasChangedState);
			Assert.assertTrue("Button currentState must be ButtonState.DOWN",
				ButtonState.DOWN, this._target.currentState);
		}

		[Test]
		public function testUpStateOnKeyUp():void
		{
			FocusManager.focus = this._target;
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			var hasChangedState:Boolean = false;
			this._target.addEventListener(FeathersEventType.STATE_CHANGE, function(event:Event):void
			{
				hasChangedState = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertTrue("FeathersEventType.STATE_CHANGE was not dispatched",
				hasChangedState);
			Assert.assertTrue("Button currentState must be ButtonState.UP",
				ButtonState.UP, this._target.currentState);
		}

		[Test]
		public function testUpStateOnCancelKey():void
		{
			FocusManager.focus = this._target;
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			var hasChangedState:Boolean = false;
			this._target.addEventListener(FeathersEventType.STATE_CHANGE, function(event:Event):void
			{
				hasChangedState = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.ESCAPE));
			Assert.assertTrue("FeathersEventType.STATE_CHANGE was not dispatched",
				hasChangedState);
			Assert.assertTrue("Button currentState must be ButtonState.UP",
				ButtonState.UP, this._target.currentState);
		}

		[Test]
		public function testTriggeredEvent():void
		{
			FocusManager.focus = this._target;
			var hasTriggered:Boolean = false;
			this._target.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertTrue("Event.TRIGGERED was not dispatched", hasTriggered);
		}

		[Test]
		public function testDisabled():void
		{
			this._target.isEnabled = false;
			this._target.validate();
			FocusManager.focus = this._target;

			var hasTriggered:Boolean = false;
			this._target.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertFalse("Event.TRIGGERED was incorrectly dispatched when disabled", hasTriggered);
		}

		[Test]
		public function testCancelKeyBeforeTriggeredEvent():void
		{
			FocusManager.focus = this._target;
			var hasTriggered:Boolean = false;
			this._target.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.ESCAPE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.ESCAPE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertFalse("Event.TRIGGERED was incorrectly dispatched when touch moved out of bounds", hasTriggered);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ButtonGroupDataProviderEventsTests.as
================================================
package feathers.tests
{
	import feathers.controls.Button;
	import feathers.controls.ButtonGroup;
	import feathers.controls.ToggleButton;
	import feathers.data.ListCollection;
	import feathers.layout.Direction;

	import flash.geom.Point;

	import org.flexunit.Assert;
	import org.flexunit.async.Async;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class ButtonGroupDataProviderEventsTests
	{
		private var _group:ButtonGroup;

		[Before]
		public function prepare():void
		{
			this._group = new ButtonGroup();
			this._group.direction = Direction.VERTICAL;
			TestFeathers.starlingRoot.addChild(this._group);
		}

		[After]
		public function cleanup():void
		{
			this._group.removeFromParent(true);
			this._group = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testTriggeredEventInDataProvider():void
		{
			var triggeredItem:Object;
			var hasTriggered:Boolean = false;
			function triggeredListener(event:Event, data:Object, item:Object):void
			{
				hasTriggered = true;
				triggeredItem = item;
			}
			
			this._group.dataProvider = new ListCollection(
			[
				{ label: "One" },
				{ label: "Two", triggered: triggeredListener },
				{ label: "Three" },
			]);
			this._group.buttonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(200, 200);
				return button;
			}
			this._group.validate();
			
			var position:Point = new Point(10, 210);
			var target:DisplayObject = this._group.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.TRIGGERED was not dispatched to listener in data provider", hasTriggered);
			Assert.assertStrictlyEquals("Event.TRIGGERED was not dispatched with correct item to listener in data provider", this._group.dataProvider.getItemAt(1), triggeredItem);
		}

		[Test]
		public function testChangeEventInDataProvider():void
		{
			var changedItem:Object;
			var hasChanged:Boolean = false;
			function changeListener(event:Event, data:Object, item:Object):void
			{
				hasChanged = true;
				changedItem = item;
			}

			this._group.dataProvider = new ListCollection(
			[
				{ label: "One" },
				{ label: "Two", change: changeListener },
				{ label: "Three" },
			]);
			this._group.buttonFactory = function():ToggleButton
			{
				var button:ToggleButton = new ToggleButton();
				button.defaultSkin = new Quad(200, 200);
				return button;
			}
			this._group.validate();
			
			var position:Point = new Point(10, 210);
			var target:DisplayObject = this._group.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.CHANGE was not dispatched to listener in data provider", hasChanged);
			Assert.assertStrictlyEquals("Event.CHANGE was not dispatched with correct item to listener in data provider", this._group.dataProvider.getItemAt(1), changedItem);
		}

		[Test(async)]
		public function testLongPressEventInDataProvider():void
		{
			var longPressItem:Object;
			var hasLongPressed:Boolean = false;
			function longPressListener(event:Event, data:Object, item:Object):void
			{
				hasLongPressed = true;
				longPressItem = item;
			}

			this._group.dataProvider = new ListCollection(
			[
				{ label: "One" },
				{ label: "Two", isLongPressEnabled: true, longPress: longPressListener },
				{ label: "Three" },
			]);
			this._group.buttonFactory = function():ToggleButton
			{
				var button:ToggleButton = new ToggleButton();
				button.defaultSkin = new Quad(200, 200);
				return button;
			}
			this._group.validate();

			var position:Point = new Point(10, 210);
			var target:DisplayObject = this._group.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 10;
			touch.globalY = 210;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("FeathersEventType.LONG_PRESS was not dispatched to listener in data provider", hasLongPressed);
				Assert.assertStrictlyEquals("Event.CHANGE was not dispatched with correct item to listener in data provider", _group.dataProvider.getItemAt(1), longPressItem);
			}, 600);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ButtonGroupMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.Button;
	import feathers.controls.ButtonGroup;
	import feathers.data.ListCollection;
	import feathers.layout.Direction;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class ButtonGroupMeasurementTests
	{
		private static const PADDING_TOP:Number = 6;
		private static const PADDING_RIGHT:Number = 8;
		private static const PADDING_BOTTOM:Number = 2;
		private static const PADDING_LEFT:Number = 10;
		private static const GAP:Number = 5;
		private static const FIRST_GAP:Number = 7;
		private static const LAST_GAP:Number = 6;
		private static const BUTTON_WIDTH:Number = 200;
		private static const BUTTON_HEIGHT:Number = 100;
		
		private var _group:ButtonGroup;

		[Before]
		public function prepare():void
		{
			this._group = new ButtonGroup();
			this._group.buttonFactory = function():Button
			{
				var button:Button = new Button();
				button.hasLabelTextRenderer = false;
				button.defaultSkin = new Quad(BUTTON_WIDTH, BUTTON_HEIGHT, 0xff00ff);
				return button;
			};
			TestFeathers.starlingRoot.addChild(this._group);
		}

		[After]
		public function cleanup():void
		{
			this._group.removeFromParent(true);
			this._group = null;
			
			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testVerticalDimensionsWithNoItems():void
		{
			this._group.direction = Direction.VERTICAL;
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to 0 with empty data provider.",
				0, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup height not equal to 0 with empty data provider.",
				0, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to 0 with empty data provider.",
				0, this._group.minWidth);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to 0 with empty data provider.",
				0, this._group.minHeight);
		}

		[Test]
		public function testVerticalDimensionsWithPaddingGapAndNoItems():void
		{
			this._group.direction = Direction.VERTICAL;
			this._group.paddingTop = PADDING_TOP;
			this._group.paddingRight = PADDING_RIGHT;
			this._group.paddingBottom = PADDING_BOTTOM;
			this._group.paddingLeft = PADDING_LEFT;
			this._group.gap = GAP;
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to sum of left and right padding with empty data provider.", PADDING_LEFT + PADDING_RIGHT, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup height not equal to sum of top and bottom padding with empty data provider.", PADDING_TOP + PADDING_BOTTOM, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to sum of left and right padding with empty data provider.", PADDING_LEFT + PADDING_RIGHT, this._group.minWidth);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to sum of top and bottom padding with empty data provider.", PADDING_TOP + PADDING_BOTTOM, this._group.minHeight);
		}

		[Test]
		public function testVerticalDimensionsWithOneChild():void
		{
			this._group.direction = Direction.VERTICAL;
			this._group.dataProvider = new ListCollection(
			[
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to one button width.", BUTTON_WIDTH, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup height not equal to one button height.", BUTTON_HEIGHT, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to one button width.", BUTTON_WIDTH, this._group.minWidth);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to one button height.", BUTTON_HEIGHT, this._group.minHeight);
		}

		[Test]
		public function testVerticalDimensionsWithPaddingGapAndOneChild():void
		{
			this._group.direction = Direction.VERTICAL;
			this._group.paddingTop = PADDING_TOP;
			this._group.paddingRight = PADDING_RIGHT;
			this._group.paddingBottom = PADDING_BOTTOM;
			this._group.paddingLeft = PADDING_LEFT;
			this._group.gap = GAP;
			this._group.dataProvider = new ListCollection(
			[
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to sum of left and right padding and width of button.", BUTTON_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup height not equal to sum of top and bottom padding and height of button.", BUTTON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to sum of left and right padding and width of button.", BUTTON_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._group.minWidth);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to sum of top and bottom padding and height of button.", BUTTON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._group.minHeight);
		}

		[Test]
		public function testVerticalDimensionsWithTwoChildren():void
		{
			this._group.direction = Direction.VERTICAL;
			this._group.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to max width of buttons.", BUTTON_WIDTH, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup height not equal to sum of button heights.", BUTTON_HEIGHT * 2, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to max width of buttons.", BUTTON_WIDTH, this._group.minWidth);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to sum of button heights.", BUTTON_HEIGHT * 2, this._group.minHeight);
		}

		[Test]
		public function testVerticalDimensionsWithPaddingGapAndTwoChildren():void
		{
			this._group.direction = Direction.VERTICAL;
			this._group.paddingTop = PADDING_TOP;
			this._group.paddingRight = PADDING_RIGHT;
			this._group.paddingBottom = PADDING_BOTTOM;
			this._group.paddingLeft = PADDING_LEFT;
			this._group.gap = GAP;
			this._group.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to sum of left and right padding and max width of buttons.", BUTTON_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup height not equal to sum of top and bottom padding, gap, and sum of button heights.", BUTTON_HEIGHT * 2 + GAP + PADDING_TOP + PADDING_BOTTOM, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to sum of left and right padding and max width of buttons.", BUTTON_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._group.minWidth);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to sum of top and bottom padding, gap, and sum of button heights.", BUTTON_HEIGHT * 2 + GAP + PADDING_TOP + PADDING_BOTTOM, this._group.minHeight);
		}

		[Test]
		public function testVerticalHeightWithFirstGapAndTwoChildren():void
		{
			this._group.direction = Direction.VERTICAL;
			this._group.gap = GAP;
			this._group.firstGap = FIRST_GAP;
			this._group.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup height not equal to first gap plus sum of button heights.", BUTTON_HEIGHT * 2 + FIRST_GAP, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to first gap plus sum of button heights.", BUTTON_HEIGHT * 2 + FIRST_GAP, this._group.minHeight);
		}

		[Test]
		public function testVerticalHeightWithLastGapAndTwoChildren():void
		{
			this._group.direction = Direction.VERTICAL;
			this._group.gap = GAP;
			this._group.lastGap = LAST_GAP;
			this._group.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup height not equal to gap plus sum of button heights when using last gap with two buttons.", BUTTON_HEIGHT * 2 + GAP, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to gap plus sum of button heights when using last gap with two buttons.", BUTTON_HEIGHT * 2 + GAP, this._group.minHeight);
		}

		[Test]
		public function testVerticalHeightWithFirstGapAndThreeChildren():void
		{
			this._group.direction = Direction.VERTICAL;
			this._group.gap = GAP;
			this._group.firstGap = FIRST_GAP;
			this._group.dataProvider = new ListCollection(
			[
				{},
				{},
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup height not equal to sum of button heights, plus first gap, plus gap, with three buttons.", BUTTON_HEIGHT * 3 + GAP + FIRST_GAP, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to sum of button heights, plus first gap, plus gap, with three buttons.", BUTTON_HEIGHT * 3 + GAP + FIRST_GAP, this._group.minHeight);
		}

		[Test]
		public function testVerticalHeightWithLastGapAndThreeChildren():void
		{
			this._group.direction = Direction.VERTICAL;
			this._group.gap = GAP;
			this._group.lastGap = LAST_GAP;
			this._group.dataProvider = new ListCollection(
			[
				{},
				{},
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup height not equal to sum of button heights, plus gap, plus last gap, with three buttons.", BUTTON_HEIGHT * 3 + GAP + LAST_GAP, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to sum of button heights, plus gap, plus last gap, with three buttons.", BUTTON_HEIGHT * 3 + GAP + LAST_GAP, this._group.minHeight);
		}

		[Test]
		public function testVerticalHeightWithFirstAndLastGapAndFourChildren():void
		{
			this._group.direction = Direction.VERTICAL;
			this._group.gap = GAP;
			this._group.firstGap = FIRST_GAP;
			this._group.lastGap = LAST_GAP;
			this._group.dataProvider = new ListCollection(
			[
				{},
				{},
				{},
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup height not equal to sum of button heights, plus first gap, plus gap, plus last gap, with four buttons.", BUTTON_HEIGHT * 4 + FIRST_GAP + GAP + LAST_GAP, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to sum of button heights, plus first gap, plus gap, plus last gap, with four buttons.", BUTTON_HEIGHT * 4 + FIRST_GAP + GAP + LAST_GAP, this._group.minHeight);
		}

		[Test]
		public function testHorizontalDimensionsWithNoChildren():void
		{
			this._group.direction = Direction.HORIZONTAL;
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to 0 with no buttons.", 0, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup height not equal to 0 with no buttons.", 0, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to 0 with no buttons.", 0, this._group.minWidth);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to 0 with no buttons.", 0, this._group.minHeight);
		}

		[Test]
		public function testHorizontalDimensionsWithPaddingGapAndNoChildren():void
		{
			this._group.direction = Direction.HORIZONTAL;
			this._group.paddingTop = PADDING_TOP;
			this._group.paddingRight = PADDING_RIGHT;
			this._group.paddingBottom = PADDING_BOTTOM;
			this._group.paddingLeft = PADDING_LEFT;
			this._group.gap = GAP;
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to sum of left and right padding with no buttons.", PADDING_LEFT + PADDING_RIGHT, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup height not equal to sum of top and bottom padding with no buttons.", PADDING_TOP + PADDING_BOTTOM, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to sum of left and right padding with no buttons.", PADDING_LEFT + PADDING_RIGHT, this._group.minWidth);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to sum of top and bottom padding with no buttons.", PADDING_TOP + PADDING_BOTTOM, this._group.minHeight);
		}

		[Test]
		public function testHorizontalDimensionsWithOneChild():void
		{
			this._group.direction = Direction.HORIZONTAL;
			this._group.dataProvider = new ListCollection(
			[
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to button width.", BUTTON_WIDTH, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup height not equal to button height.", BUTTON_HEIGHT, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to button width.", BUTTON_WIDTH, this._group.minWidth);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to button height.", BUTTON_HEIGHT, this._group.minHeight);
		}

		[Test]
		public function testHorizontalDimensionsWithPaddingGapAndOneChild():void
		{
			this._group.direction = Direction.HORIZONTAL;
			this._group.paddingTop = PADDING_TOP;
			this._group.paddingRight = PADDING_RIGHT;
			this._group.paddingBottom = PADDING_BOTTOM;
			this._group.paddingLeft = PADDING_LEFT;
			this._group.gap = GAP;
			this._group.dataProvider = new ListCollection(
			[
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to sum of left and right padding and width of button.", BUTTON_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup height not equal to sum of top and bottom padding and height of button.", BUTTON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to sum of left and right padding and width of button.", BUTTON_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._group.minWidth);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to sum of top and bottom padding and height of button.", BUTTON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._group.minHeight);
		}

		[Test]
		public function testHorizontalDimensionsWithTwoChildren():void
		{
			this._group.direction = Direction.HORIZONTAL;
			this._group.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to sum of button widths.", BUTTON_WIDTH * 2, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup height not equal to max height of buttons.", BUTTON_HEIGHT, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to sum of button widths.", BUTTON_WIDTH * 2, this._group.minWidth);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to max height of buttons.", BUTTON_HEIGHT, this._group.minHeight);
		}

		[Test]
		public function testHorizontalDimensionsWithPaddingGapAndTwoChildren():void
		{
			this._group.direction = Direction.HORIZONTAL;
			this._group.paddingTop = PADDING_TOP;
			this._group.paddingRight = PADDING_RIGHT;
			this._group.paddingBottom = PADDING_BOTTOM;
			this._group.paddingLeft = PADDING_LEFT;
			this._group.gap = GAP;
			this._group.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to sum of left and right padding, gap, and sum of button widths.", BUTTON_WIDTH * 2 + GAP + PADDING_LEFT + PADDING_RIGHT, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup height not equal to sum of top and bottom padding and max height of buttons.", BUTTON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._group.height);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to sum of left and right padding, gap, and sum of button widths.", BUTTON_WIDTH * 2 + GAP + PADDING_LEFT + PADDING_RIGHT, this._group.minWidth);
			Assert.assertStrictlyEquals("ButtonGroup minHeight not equal to sum of top and bottom padding and max height of buttons.", BUTTON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._group.minHeight);
		}

		[Test]
		public function testHorizontalWidthWithGapAndTwoChildren():void
		{
			this._group.direction = Direction.HORIZONTAL;
			this._group.gap = GAP;
			this._group.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to gap plus sum of button widths.", BUTTON_WIDTH * 2 + GAP, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to gap plus sum of button widths.", BUTTON_WIDTH * 2 + GAP, this._group.minWidth);
		}

		[Test]
		public function testHorizontalWidthWithFirstGapAndTwoChildren():void
		{
			this._group.direction = Direction.HORIZONTAL;
			this._group.gap = GAP;
			this._group.firstGap = FIRST_GAP;
			this._group.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to gap plus sum of button widths.", BUTTON_WIDTH * 2 + FIRST_GAP, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to gap plus sum of button widths.", BUTTON_WIDTH * 2 + FIRST_GAP, this._group.minWidth);
		}

		[Test]
		public function testHorizontalWidthWithLastGapAndTwoChildren():void
		{
			this._group.direction = Direction.HORIZONTAL;
			this._group.gap = GAP;
			this._group.lastGap = LAST_GAP;
			this._group.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to gap plus sum of button widths when using last gap with two buttons.", BUTTON_WIDTH * 2 + GAP, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to gap plus sum of button widths when using last gap with two buttons.", BUTTON_WIDTH * 2 + GAP, this._group.minWidth);
		}

		[Test]
		public function testHorizontalWidthWithFirstGapAndThreeChildren():void
		{
			this._group.direction = Direction.HORIZONTAL;
			this._group.gap = GAP;
			this._group.firstGap = FIRST_GAP;
			this._group.dataProvider = new ListCollection(
			[
				{},
				{},
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to sum of button widths, plus first gap, plus gap, with three buttons.", BUTTON_WIDTH * 3 + GAP + FIRST_GAP, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to sum of button widths, plus first gap, plus gap, with three buttons.", BUTTON_WIDTH * 3 + GAP + FIRST_GAP, this._group.minWidth);
		}

		[Test]
		public function testHorizontalWidthWithLastGapAndThreeChildren():void
		{
			this._group.direction = Direction.HORIZONTAL;
			this._group.gap = GAP;
			this._group.lastGap = LAST_GAP;
			this._group.dataProvider = new ListCollection(
			[
				{},
				{},
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to sum of button widths, plus gap, plus last gap, with three buttons.", BUTTON_WIDTH * 3 + GAP + LAST_GAP, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to sum of button widths, plus gap, plus last gap, with three buttons.", BUTTON_WIDTH * 3 + GAP + LAST_GAP, this._group.minWidth);
		}

		[Test]
		public function testHorizontalWidthWithFirstAndLastGapAndFourChildren():void
		{
			this._group.direction = Direction.HORIZONTAL;
			this._group.gap = GAP;
			this._group.firstGap = FIRST_GAP;
			this._group.lastGap = LAST_GAP;
			this._group.dataProvider = new ListCollection(
			[
				{},
				{},
				{},
				{},
			]);
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup width not equal to sum of button widths, plus first gap, plus gap, plus last gap, with four buttons.", BUTTON_WIDTH * 4 + FIRST_GAP + GAP + LAST_GAP, this._group.width);
			Assert.assertStrictlyEquals("ButtonGroup minWidth not equal to sum of button widths, plus first gap, plus gap, plus last gap, with four buttons.", BUTTON_WIDTH * 4 + FIRST_GAP + GAP + LAST_GAP, this._group.minWidth);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ButtonGroupTests.as
================================================
package feathers.tests
{
	import feathers.controls.Button;
	import feathers.controls.ButtonGroup;
	import feathers.data.ListCollection;
	import feathers.layout.Direction;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class ButtonGroupTests
	{
		private var _group:ButtonGroup;

		[Before]
		public function prepare():void
		{
			this._group = new ButtonGroup();
			this._group.dataProvider = new ListCollection(
			[
				{ label: "One", name: "one" },
				{ label: "Two", name: "two" },
				{ label: "Three", isEnabled: true, name: "three" },
				{ label: "Four", isEnabled: false, name: "four" },
			]);
			this._group.buttonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(200, 200);
				return button;
			}
			this._group.direction = Direction.VERTICAL;
			TestFeathers.starlingRoot.addChild(this._group);
			this._group.validate();
		}

		[After]
		public function cleanup():void
		{
			this._group.removeFromParent(true);
			this._group = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testTriggeredEvent():void
		{
			var triggeredItem:Object;
			var hasTriggered:Boolean = false;
			this._group.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
				triggeredItem = event.data;
			});
			var position:Point = new Point(10, 210);
			var target:DisplayObject = this._group.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.TRIGGERED was not dispatched", hasTriggered);
			Assert.assertStrictlyEquals("Event.TRIGGERED was not dispatched with correct data", this._group.dataProvider.getItemAt(1), triggeredItem);
		}

		[Test]
		public function testDirectionSetToVerticalAndDistributeButtonSizesSetToTrueWithLargerHeight():void
		{
			this._group.direction = Direction.VERTICAL;
			this._group.distributeButtonSizes = true;
			this._group.height = 1600;
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup button height not changed with vertical direction, larger explicit height, and distributeButtonSizes set to true", 400, this._group.getChildByName("one").height);
		}

		[Test]
		public function testDirectionSetToVerticalAndDistributeButtonSizesSetToTrueWithSmallerHeight():void
		{
			this._group.direction = Direction.VERTICAL;
			this._group.distributeButtonSizes = true;
			this._group.height = 400;
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup button height not changed with vertical direction, smaller explicit height, and distributeButtonSizes set to true", 100, this._group.getChildByName("one").height);
		}

		[Test]
		public function testDirectionSetToVerticalAndDistributeButtonSizesSetToFalseWithLargerHeight():void
		{
			var originalButtonHeight:Number = this._group.getChildByName("one").height;
			this._group.direction = Direction.VERTICAL;
			this._group.distributeButtonSizes = false;
			this._group.height = 1600;
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup button height not changed with vertical direction, larger explicit height, and distributeButtonSizes set to true", originalButtonHeight, this._group.getChildByName("one").height);
		}

		[Test]
		public function testDirectionSetToVerticalAndDistributeButtonSizesSetToFalseWithSmallerHeight():void
		{
			var originalButtonHeight:Number = this._group.getChildByName("one").height;
			this._group.direction = Direction.VERTICAL;
			this._group.distributeButtonSizes = false;
			this._group.height = 300;
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup button height not changed with vertical direction, smaller explicit height, and distributeButtonSizes set to true", originalButtonHeight, this._group.getChildByName("one").height);
		}

		[Test]
		public function testDirectionSetToHorizontalAndDistributeButtonSizesSetToTrueWithLargerWidth():void
		{
			this._group.direction = Direction.HORIZONTAL;
			this._group.distributeButtonSizes = true;
			this._group.width = 1600;
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup button width not changed with horizontal direction, larger explicit width, and distributeButtonSizes set to true", 400, this._group.getChildByName("one").width);
		}

		[Test]
		public function testDirectionSetToHorizontalAndDistributeButtonSizesSetToTrueWithSmallerWidth():void
		{
			this._group.direction = Direction.HORIZONTAL;
			this._group.distributeButtonSizes = true;
			this._group.width = 400;
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup button width not changed with horizontal direction, smaller explicit width, and distributeButtonSizes set to true", 100, this._group.getChildByName("one").width);
		}

		[Test]
		public function testDirectionSetToHorizontalAndDistributeButtonSizesSetToFalseWithLargerWidth():void
		{
			var originalButtonWidth:Number = this._group.getChildByName("one").width;
			this._group.direction = Direction.HORIZONTAL;
			this._group.distributeButtonSizes = false;
			this._group.width = 1600;
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup button width not changed with horizontal direction, larger explicit width, and distributeButtonSizes set to false", originalButtonWidth, this._group.getChildByName("one").width);
		}

		[Test]
		public function testButtonWidthAfterDirectionSetToHorizontalAndDistributeButtonSizesSetToFalseWithSmallerWidth():void
		{
			var button:DisplayObject = this._group.getChildByName("one");
			var originalButtonWidth:Number = button.width;
			var originalButtonHeight:Number = button.height;
			this._group.direction = Direction.HORIZONTAL;
			this._group.distributeButtonSizes = false;
			this._group.width = 300;
			this._group.validate();
			Assert.assertStrictlyEquals("ButtonGroup button width not changed with horizontal direction, smaller explicit width, and distributeButtonSizes set to false", originalButtonWidth, this._group.getChildByName("one").width);
			Assert.assertStrictlyEquals("ButtonGroup button not on new row with flow layout and small explicit width", originalButtonHeight, this._group.getChildByName("two").y);
		}

		[Test]
		public function testDisableAndReenable():void
		{
			this._group.isEnabled = false;
			this._group.validate();
			this._group.isEnabled = true;
			this._group.validate();
			var button1:Button = Button(this._group.getChildByName("one"));
			var button3:Button = Button(this._group.getChildByName("three"));
			var button4:Button = Button(this._group.getChildByName("four"));
			Assert.assertTrue("Button without isEnabled value in data provider is not enabled when ButtonGroup is disabled and then re-enabled", button1.isEnabled);
			Assert.assertTrue("Button with isEnabled value set to true in data provider is not enabled when ButtonGroup is disabled and then re-enabled", button3.isEnabled);
			Assert.assertFalse("Button with isEnabled value set to false in data provider is not disabled when ButtonGroup is disabled and then re-enabled", button4.isEnabled);
		}

		[Test]
		public function testDisable():void
		{
			this._group.isEnabled = false;
			this._group.validate();
			var button1:Button = Button(this._group.getChildByName("one"));
			var button3:Button = Button(this._group.getChildByName("three"));
			var button4:Button = Button(this._group.getChildByName("four"));
			Assert.assertFalse("Button without isEnabled value in data provider is incorrectly enabled when ButtonGroup is disabled", button1.isEnabled);
			Assert.assertFalse("Button with isEnabled value set to true in data provider is incorrectly enabled when ButtonGroup is disabled", button3.isEnabled);
			Assert.assertFalse("Button with isEnabled value set to false in data provider is incorrectly enabled when ButtonGroup is disabled", button4.isEnabled);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ButtonInternalStateTests.as
================================================
package feathers.tests
{
	import feathers.controls.ButtonState;
	import feathers.controls.text.BitmapFontTextRenderer;
	import feathers.text.BitmapFontTextFormat;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.text.BitmapFont;

	public class ButtonInternalStateTests
	{
		private var _button:ButtonWithInternalState;

		[Before]
		public function prepare():void
		{
			this._button = new ButtonWithInternalState();
			TestFeathers.starlingRoot.addChild(this._button);
		}

		[After]
		public function cleanup():void
		{
			this._button.removeFromParent(true);
			this._button = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testGetIconForStateWithoutSetIconForState():void
		{
			Assert.assertNull("Button getIconForState(ButtonState.UP) must be null when setIconForState() is not called", this._button.getIconForState(ButtonState.UP));
			Assert.assertNull("Button getIconForState(ButtonState.HOVER) must be null when setIconForState() is not called", this._button.getIconForState(ButtonState.HOVER));
			Assert.assertNull("Button getIconForState(ButtonState.DOWN) must be null when setIconForState() is not called", this._button.getIconForState(ButtonState.DOWN));
			Assert.assertNull("Button getIconForState(ButtonState.DISABLED) must be null when setIconForState() is not called", this._button.getIconForState(ButtonState.DISABLED));
		}

		[Test]
		public function testGetIconForState():void
		{
			var defaultIcon:Quad = new Quad(200, 200);
			this._button.defaultIcon = defaultIcon;

			var upIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.UP, upIcon);

			var hoverIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.HOVER, hoverIcon);

			var downIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.DOWN, downIcon);

			var disabledIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.DISABLED, disabledIcon);

			Assert.assertStrictlyEquals("Button getIconForState(ButtonState.UP) does not match value passed to setIconForState()", upIcon, this._button.getIconForState(ButtonState.UP));
			Assert.assertStrictlyEquals("Button getIconForState(ButtonState.HOVER) does not match value passed to setIconForState()", hoverIcon, this._button.getIconForState(ButtonState.HOVER));
			Assert.assertStrictlyEquals("Button getIconForState(ButtonState.DOWN) does not match value passed to setIconForState()", downIcon, this._button.getIconForState(ButtonState.DOWN));
			Assert.assertStrictlyEquals("Button getIconForState(ButtonState.DISABLED) does not match value passed to setIconForState()", disabledIcon, this._button.getIconForState(ButtonState.DISABLED));
		}

		[Test]
		public function testDefaultCurrentIcon():void
		{
			var defaultIcon:Quad = new Quad(200, 200);
			this._button.defaultIcon = defaultIcon;

			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.UP with no touch", ButtonState.UP, this._button.currentState);
			Assert.assertStrictlyEquals("Button icon is not defaultIcon when currentState is ButtonState.UP and icon not provided for this state", defaultIcon, this._button.currentIconInternal);

			this._button.isEnabled = false;
			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.DISABLED when isEnabled is false", ButtonState.DISABLED, this._button.currentState);
			Assert.assertStrictlyEquals("Button icon is not defaultIcon when currentState is ButtonState.DISABLED and icon not provided for this state", defaultIcon, this._button.currentIconInternal);

			this._button.isEnabled = true;

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be button", this._button, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.HOVER on TouchPhase.HOVER", ButtonState.HOVER, this._button.currentState);
			Assert.assertStrictlyEquals("Button icon is not defaultIcon when currentState is ButtonState.HOVER and icon not provided for this state", defaultIcon, this._button.currentIconInternal);

			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.DOWN on TouchPhase.BEGAN", ButtonState.DOWN, this._button.currentState);
			Assert.assertStrictlyEquals("Button icon is not defaultIcon when currentState is ButtonState.DOWN and icon not provided for this state", defaultIcon, this._button.currentIconInternal);
		}

		[Test]
		public function testCurrentIconWithSetIconForState():void
		{
			var defaultIcon:Quad = new Quad(200, 200);
			this._button.defaultIcon = defaultIcon;

			var upIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.UP, upIcon);

			var hoverIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.HOVER, hoverIcon);

			var downIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.DOWN, downIcon);

			var disabledIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.DISABLED, disabledIcon);

			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.UP with no touch", ButtonState.UP, this._button.currentState);
			Assert.assertStrictlyEquals("Button icon does not match icon set with setIconForState() when currentState is ButtonState.UP", upIcon, this._button.currentIconInternal);

			this._button.isEnabled = false;
			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.DISABLED when isEnabled is false", ButtonState.DISABLED, this._button.currentState);
			Assert.assertStrictlyEquals("Button icon does not match icon set with setIconForState() when currentState is ButtonState.DISABLED", disabledIcon, this._button.currentIconInternal);

			this._button.isEnabled = true;

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be button", this._button, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.HOVER on TouchPhase.HOVER", ButtonState.HOVER, this._button.currentState);
			Assert.assertStrictlyEquals("Button icon does not match icon set with setIconForState() when currentState is ButtonState.HOVER and icon not provided for this state", hoverIcon, this._button.currentIconInternal);

			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.DOWN on TouchPhase.BEGAN", ButtonState.DOWN, this._button.currentState);
			Assert.assertStrictlyEquals("Button icon does not match icon set with setIconForState() when currentState is ButtonState.DOWN and icon not provided for this state", downIcon, this._button.currentIconInternal);
		}

		[Test]
		public function testDefaultLabelProperties():void
		{
			this._button.defaultSkin = new Quad(200, 200);
			
			var defaultFontSize:Number = 10;

			this._button.defaultLabelProperties.textFormat = new BitmapFontTextFormat(new BitmapFont(), defaultFontSize);

			this._button.validate();
			var textRenderer:BitmapFontTextRenderer = BitmapFontTextRenderer(this._button.labelTextRendererInternal);

			Assert.assertStrictlyEquals("Button state is not ButtonState.UP with no touch", ButtonState.UP, this._button.currentState);
			Assert.assertStrictlyEquals("Button label font size does not match format set with defaultLabelProperties", defaultFontSize, textRenderer.textFormat.size);

			this._button.isEnabled = false;
			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.DISABLED when isEnabled is false", ButtonState.DISABLED, this._button.currentState);
			Assert.assertStrictlyEquals("Button label font size does not match format set with defaultLabelProperties", defaultFontSize, textRenderer.textFormat.size);

			this._button.isEnabled = true;

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be button", this._button, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.HOVER on TouchPhase.HOVER", ButtonState.HOVER, this._button.currentState);
			Assert.assertStrictlyEquals("Button label font size does not match format set with defaultLabelProperties", defaultFontSize, textRenderer.textFormat.size);

			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.DOWN on TouchPhase.BEGAN", ButtonState.DOWN, this._button.currentState);
			Assert.assertStrictlyEquals("Button label font size does not match format set with defaultLabelProperties", defaultFontSize, textRenderer.textFormat.size);
		}

		[Test]
		public function testGetScaleForStateWithoutSetSkinForState():void
		{
			Assert.assertTrue("Button getScaleForState(ButtonState.UP) must be NaN when setScaleForState() is not called",
				isNaN(this._button.getScaleForState(ButtonState.UP)));
			Assert.assertTrue("Button getScaleForState(ButtonState.HOVER) must be NaN when setScaleForState() is not called",
				isNaN(this._button.getScaleForState(ButtonState.HOVER)));
			Assert.assertTrue("Button getScaleForState(ButtonState.DOWN) must be NaN when setScaleForState() is not called",
				isNaN(this._button.getScaleForState(ButtonState.DOWN)));
			Assert.assertTrue("Button getScaleForState(ButtonState.DISABLED) must be NaN when setScaleForState() is not called",
				isNaN(this._button.getScaleForState(ButtonState.DISABLED)));
		}

		[Test]
		public function testGetScaleForState():void
		{
			var upScale:Number = 1.1;
			this._button.setScaleForState(ButtonState.UP, upScale);

			var hoverScale:Number = 1.2;
			this._button.setScaleForState(ButtonState.HOVER, hoverScale);

			var downScale:Number = 1.3;
			this._button.setScaleForState(ButtonState.DOWN, downScale);

			var disabledScale:Number = 1.4;
			this._button.setScaleForState(ButtonState.DISABLED, disabledScale);

			Assert.assertStrictlyEquals("Button getScaleForState(ButtonState.UP) does not match value passed to setScaleForState()", upScale, this._button.getScaleForState(ButtonState.UP));
			Assert.assertStrictlyEquals("Button getScaleForState(ButtonState.HOVER) does not match value passed to setScaleForState()", hoverScale, this._button.getScaleForState(ButtonState.HOVER));
			Assert.assertStrictlyEquals("Button getScaleForState(ButtonState.DOWN) does not match value passed to setScaleForState()", downScale, this._button.getScaleForState(ButtonState.DOWN));
			Assert.assertStrictlyEquals("Button getScaleForState(ButtonState.DISABLED) does not match value passed to setScaleForState()", disabledScale, this._button.getScaleForState(ButtonState.DISABLED));
		}

		[Test]
		public function testDefaultCurrentScale():void
		{
			this._button.defaultSkin = new Quad(200, 200);

			this._button.isEnabled = false;
			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.DISABLED when isEnabled is false",
				ButtonState.DISABLED, this._button.currentState);
			Assert.assertStrictlyEquals("Button scale is not 1 when currentState is ButtonState.DISABLED and scale not provided for this state",
				1, this._button.currentScaleInternal);

			this._button.isEnabled = true;

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be button", this._button, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.HOVER on TouchPhase.HOVER",
				ButtonState.HOVER, this._button.currentState);
			Assert.assertStrictlyEquals("Button scale is not 1 when currentState is ButtonState.HOVER and scale not provided for this state",
				1, this._button.currentScaleInternal);

			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.DOWN on TouchPhase.BEGAN",
				ButtonState.DOWN, this._button.currentState);
			Assert.assertStrictlyEquals("Button scale is not 1 when currentState is ButtonState.DOWN and scale not provided for this state",
				1, this._button.currentScaleInternal);
		}

		[Test]
		public function testCurrentScaleWithSetScaleForState():void
		{
			this._button.defaultSkin = new Quad(200, 200);

			var upScale:Number = 1.1;
			this._button.setScaleForState(ButtonState.UP, upScale);

			var hoverScale:Number = 1.2;
			this._button.setScaleForState(ButtonState.HOVER, hoverScale);

			var downScale:Number = 1.3;
			this._button.setScaleForState(ButtonState.DOWN, downScale);

			var disabledScale:Number = 1.4;
			this._button.setScaleForState(ButtonState.DISABLED, disabledScale);

			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.UP with no touch",
				ButtonState.UP, this._button.currentState);
			Assert.assertStrictlyEquals("Button scale does not match scale set with setScaleForState() when currentState is ButtonState.UP",
				upScale, this._button.currentScaleInternal);

			this._button.isEnabled = false;
			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.DISABLED when isEnabled is false",
				ButtonState.DISABLED, this._button.currentState);
			Assert.assertStrictlyEquals("Button scale does not match scale set with setScaleForState() when currentState is ButtonState.DISABLED",
				disabledScale, this._button.currentScaleInternal);

			this._button.isEnabled = true;

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be button", this._button, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.HOVER on TouchPhase.HOVER",
				ButtonState.HOVER, this._button.currentState);
			Assert.assertStrictlyEquals("Button scale does not match scale set with setScaleForState() when currentState is ButtonState.HOVER and scale not provided for this state",
				hoverScale, this._button.currentScaleInternal);

			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("Button state is not ButtonState.DOWN on TouchPhase.BEGAN",
				ButtonState.DOWN, this._button.currentState);
			Assert.assertStrictlyEquals("Button scale does not match scale set with setScaleForState() when currentState is ButtonState.DOWN and scale not provided for this state",
				downScale, this._button.currentScaleInternal);
		}
	}
}

import feathers.controls.Button;
import feathers.core.ITextRenderer;

import starling.display.DisplayObject;

class ButtonWithInternalState extends Button
{
	public function ButtonWithInternalState()
	{
		super();
	}

	public function get labelTextRendererInternal():ITextRenderer
	{
		return this.labelTextRenderer;
	}

	public function get currentIconInternal():DisplayObject
	{
		return this.currentIcon;
	}

	public function get currentScaleInternal():Number
	{
		return this.getScaleForCurrentState();
	}
}

================================================
FILE: test/source/feathers/tests/ButtonMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.Button;
	import feathers.controls.LayoutGroup;
	import feathers.controls.text.BitmapFontTextRenderer;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class ButtonMeasurementTests
	{
		private static const SMALL_BACKGROUND_WIDTH:Number = 10;
		private static const SMALL_BACKGROUND_HEIGHT:Number = 12;
		private static const LARGE_BACKGROUND_WIDTH:Number = 200;
		private static const LARGE_BACKGROUND_HEIGHT:Number = 210;
		private static const COMPLEX_BACKGROUND_WIDTH:Number = 54;
		private static const COMPLEX_BACKGROUND_HEIGHT:Number = 55;
		private static const COMPLEX_BACKGROUND_MIN_WIDTH:Number = 38;
		private static const COMPLEX_BACKGROUND_MIN_HEIGHT:Number = 39;
		
		private static const SMALL_ICON_WIDTH:Number = 13;
		private static const SMALL_ICON_HEIGHT:Number = 11;
		private static const LARGE_ICON_WIDTH:Number = 105;
		private static const LARGE_ICON_HEIGHT:Number = 115;
		private static const COMPLEX_ICON_WIDTH:Number = 23;
		private static const COMPLEX_ICON_HEIGHT:Number = 25;
		private static const COMPLEX_ICON_MIN_WIDTH:Number = 18;
		private static const COMPLEX_ICON_MIN_HEIGHT:Number = 19;
		
		private static const PADDING_TOP:Number = 50;
		private static const PADDING_RIGHT:Number = 54;
		private static const PADDING_BOTTOM:Number = 59;
		private static const PADDING_LEFT:Number = 60;
		private static const GAP:Number = 6;
		
		private var _button:Button;
		
		private var _textRenderer:BitmapFontTextRenderer;

		[Before]
		public function prepare():void
		{
			this._button = new Button();
			this._button.labelFactory = function():BitmapFontTextRenderer
			{
				return new BitmapFontTextRenderer();
			}
			TestFeathers.starlingRoot.addChild(this._button);

			this._textRenderer = new BitmapFontTextRenderer();
			TestFeathers.starlingRoot.addChild(this._textRenderer);
		}

		[After]
		public function cleanup():void
		{
			this._button.removeFromParent(true);
			this._button = null;
			
			this._textRenderer.removeFromParent(true);
			this._textRenderer = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}
		
		private function addSmallSimpleIcon():void
		{
			this._button.defaultIcon = new Quad(SMALL_ICON_WIDTH, SMALL_ICON_HEIGHT, 0xff00ff);
		}

		private function addLargeSimpleIcon():void
		{
			this._button.defaultIcon = new Quad(LARGE_ICON_WIDTH, LARGE_ICON_HEIGHT, 0xff00ff);
		}

		private function addComplexIcon():void
		{
			var icon:LayoutGroup = new LayoutGroup();
			icon.width = COMPLEX_ICON_WIDTH;
			icon.height = COMPLEX_ICON_HEIGHT;
			icon.minWidth = COMPLEX_ICON_MIN_WIDTH;
			icon.minHeight = COMPLEX_ICON_MIN_HEIGHT;
			this._button.defaultIcon = icon;
		}

		private function addSmallSimpleBackground():void
		{
			this._button.defaultSkin = new Quad(SMALL_BACKGROUND_WIDTH, SMALL_BACKGROUND_HEIGHT, 0xff00ff);
		}

		private function addLargeSimpleBackground():void
		{
			this._button.defaultSkin = new Quad(LARGE_BACKGROUND_WIDTH, LARGE_BACKGROUND_HEIGHT, 0xff00ff);
		}

		private function addComplexBackground():void
		{
			var backgroundSkin:LayoutGroup = new LayoutGroup();
			backgroundSkin.width = COMPLEX_BACKGROUND_WIDTH;
			backgroundSkin.height = COMPLEX_BACKGROUND_HEIGHT;
			backgroundSkin.minWidth = COMPLEX_BACKGROUND_MIN_WIDTH;
			backgroundSkin.minHeight = COMPLEX_BACKGROUND_MIN_HEIGHT;
			this._button.defaultSkin = backgroundSkin;
		}

		[Test]
		public function testAutoSizeWithPadding():void
		{
			this._button.paddingTop = PADDING_TOP;
			this._button.paddingRight = PADDING_RIGHT;
			this._button.paddingBottom = PADDING_BOTTOM;
			this._button.paddingLeft = PADDING_LEFT;
			this._button.validate();

			Assert.assertStrictlyEquals("The width of the Button was not calculated correctly based on the left and right padding.",
				PADDING_LEFT + PADDING_RIGHT, this._button.width);
			Assert.assertStrictlyEquals("The height of the Button was not calculated correctly based on the top and bottom padding.",
				PADDING_TOP + PADDING_BOTTOM, this._button.height);
			Assert.assertStrictlyEquals("The minWidth of the Button was not calculated correctly based on the left and right padding.",
				PADDING_LEFT + PADDING_RIGHT, this._button.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Button was not calculated correctly based on the top and bottom padding.",
				PADDING_TOP + PADDING_BOTTOM, this._button.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabel():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this._button.label = labelText;
			this._button.validate();

			Assert.assertTrue("The width of the Button was not greater than 0 when using a label.",
				this._button.width > 0);
			Assert.assertTrue("The height of the Button was not greater than 0 when using a label.",
				this._button.height > 0);
			Assert.assertTrue("The minWidth of the Button was not greater than 0 when using a label.",
				this._button.minWidth > 0);
			Assert.assertTrue("The minHeight of the Button was not greater than 0 when using a label.",
				this._button.minHeight > 0);
			Assert.assertStrictlyEquals("The width of the Button was not calculated correctly based on the label.",
				this._textRenderer.width, this._button.width);
			Assert.assertStrictlyEquals("The height of the Button was not calculated correctly based on the label.",
				this._textRenderer.height, this._button.height);
			Assert.assertStrictlyEquals("The minWidth of the Button was not calculated correctly based on the label.",
				this._textRenderer.width, this._button.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Button was not calculated correctly based on the label.",
				this._textRenderer.height, this._button.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabelAndPadding():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this._button.label = labelText;
			this._button.paddingTop = PADDING_TOP;
			this._button.paddingRight = PADDING_RIGHT;
			this._button.paddingBottom = PADDING_BOTTOM;
			this._button.paddingLeft = PADDING_LEFT;
			this._button.validate();

			Assert.assertStrictlyEquals("The width of the Button was not calculated correctly based on the label and left and right padding.",
				this._textRenderer.width + PADDING_LEFT + PADDING_RIGHT, this._button.width);
			Assert.assertStrictlyEquals("The height of the Button was not calculated correctly based on the label and top and bottom padding.",
				this._textRenderer.height + PADDING_TOP + PADDING_BOTTOM, this._button.height);
			Assert.assertStrictlyEquals("The minWidth of the Button was not calculated correctly based on the label and left and right padding.",
				this._textRenderer.width + PADDING_LEFT + PADDING_RIGHT, this._button.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Button was not calculated correctly based on the label and top and bottom padding.",
				this._textRenderer.height + PADDING_TOP + PADDING_BOTTOM, this._button.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabelAndSimpleIcon():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this.addLargeSimpleIcon();
			this._button.label = labelText;
			this._button.validate();

			Assert.assertStrictlyEquals("The width of the Button was not calculated correctly based on the label and icon.",
				this._textRenderer.width + LARGE_ICON_WIDTH, this._button.width);
			Assert.assertStrictlyEquals("The height of the Button was not calculated correctly based on the label and icon.",
				LARGE_ICON_HEIGHT, this._button.height);
			Assert.assertStrictlyEquals("The minWidth of the Button was not calculated correctly based on the label and icon.",
				this._textRenderer.width + LARGE_ICON_WIDTH, this._button.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Button was not calculated correctly based on the label and icon.",
				LARGE_ICON_HEIGHT, this._button.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabelGapAndSimpleIcon():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this.addLargeSimpleIcon();
			this._button.label = labelText;
			this._button.gap = GAP;
			this._button.validate();

			Assert.assertStrictlyEquals("The width of the Button was not calculated correctly based on the label, gap, and icon.",
				this._textRenderer.width + GAP + LARGE_ICON_WIDTH, this._button.width);
			Assert.assertStrictlyEquals("The height of the Button was not calculated correctly based on the label, gap, and icon.",
				LARGE_ICON_HEIGHT, this._button.height);
			Assert.assertStrictlyEquals("The minWidth of the Button was not calculated correctly based on the label, gap, and icon.",
				this._textRenderer.width + GAP + LARGE_ICON_WIDTH, this._button.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Button was not calculated correctly based on the label, and icon.",
				LARGE_ICON_HEIGHT, this._button.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabelGapPaddingAndSimpleIcon():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this.addLargeSimpleIcon();
			this._button.label = labelText;
			this._button.paddingTop = PADDING_TOP;
			this._button.paddingRight = PADDING_RIGHT;
			this._button.paddingBottom = PADDING_BOTTOM;
			this._button.paddingLeft = PADDING_LEFT;
			this._button.gap = GAP;
			this._button.validate();

			Assert.assertStrictlyEquals("The width of the Button was not calculated correctly based on the label, gap, left and right padding, and icon.",
				this._textRenderer.width + GAP + LARGE_ICON_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._button.width);
			Assert.assertStrictlyEquals("The height of the Button was not calculated correctly based on the label, gap, top and bottom padding, and icon.",
				LARGE_ICON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._button.height);
			Assert.assertStrictlyEquals("The minWidth of the Button was not calculated correctly based on the label, gap, left and right padding, and icon.",
				this._textRenderer.width + GAP + LARGE_ICON_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._button.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Button was not calculated correctly based on the label, gap, top and bottom padding, and icon.",
				LARGE_ICON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._button.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleIcon():void
		{
			this.addLargeSimpleIcon();
			this._button.validate();

			Assert.assertStrictlyEquals("The width of the Button was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this._button.width);
			Assert.assertStrictlyEquals("The height of the Button was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this._button.height);
			Assert.assertStrictlyEquals("The minWidth of the Button was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this._button.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Button was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this._button.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexIcon():void
		{
			this.addComplexIcon();
			this._button.validate();

			Assert.assertStrictlyEquals("The width of the Button was not calculated correctly based on the complex icon width.",
				COMPLEX_ICON_WIDTH, this._button.width);
			Assert.assertStrictlyEquals("The height of the Button was not calculated correctly based on the complex icon height.",
				COMPLEX_ICON_HEIGHT, this._button.height);
			Assert.assertStrictlyEquals("The minWidth of the Button was not calculated correctly based on the complex icon minWidth.",
				COMPLEX_ICON_MIN_WIDTH, this._button.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Button was not calculated correctly based on the complex icon minHeight.",
				COMPLEX_ICON_MIN_HEIGHT, this._button.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleBackgroundSkin():void
		{
			this.addSmallSimpleBackground();
			this._button.validate();

			Assert.assertStrictlyEquals("The width of the Button was not calculated correctly based on the background width.",
				SMALL_BACKGROUND_WIDTH, this._button.width);
			Assert.assertStrictlyEquals("The height of the Button was not calculated correctly based on the background height.",
				SMALL_BACKGROUND_HEIGHT, this._button.height);
			Assert.assertStrictlyEquals("The minWidth of the Button was not calculated correctly based on the background width.",
				SMALL_BACKGROUND_WIDTH, this._button.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Button was not calculated correctly based on the background height.",
				SMALL_BACKGROUND_HEIGHT, this._button.minHeight);
		}

		[Test]
		public function testAutoSizeWithSmallSimpleBackgroundSkinAndLargeSimpleIcon():void
		{
			this.addSmallSimpleBackground();
			this.addLargeSimpleIcon();
			this._button.validate();

			Assert.assertStrictlyEquals("The width of the Button was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this._button.width);
			Assert.assertStrictlyEquals("The height of the Button was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this._button.height);
			Assert.assertStrictlyEquals("The minWidth of the Button was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this._button.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Button was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this._button.minHeight);
		}

		[Test]
		public function testAutoSizeWithLargeSimpleBackgroundSkinAndSmallSimpleIcon():void
		{
			this.addLargeSimpleBackground();
			this.addSmallSimpleIcon();
			this._button.validate();

			Assert.assertStrictlyEquals("The width of the Button was not calculated correctly based on the background width.",
				LARGE_BACKGROUND_WIDTH, this._button.width);
			Assert.assertStrictlyEquals("The height of the Button was not calculated correctly based on the background height.",
				LARGE_BACKGROUND_HEIGHT, this._button.height);
			Assert.assertStrictlyEquals("The minWidth of the Button was not calculated correctly based on the background width.",
				LARGE_BACKGROUND_WIDTH, this._button.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Button was not calculated correctly based on the background height.",
				LARGE_BACKGROUND_HEIGHT, this._button.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexBackground():void
		{
			this.addComplexBackground();
			this._button.validate();

			Assert.assertStrictlyEquals("The width of the Button was not calculated correctly based on the complex background width.",
				COMPLEX_BACKGROUND_WIDTH, this._button.width);
			Assert.assertStrictlyEquals("The height of the Button was not calculated correctly based on the complex background height.",
				COMPLEX_BACKGROUND_HEIGHT, this._button.height);
			Assert.assertStrictlyEquals("The minWidth of the Button was not calculated correctly based on the complex background minWidth.",
				COMPLEX_BACKGROUND_MIN_WIDTH, this._button.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Button was not calculated correctly based on the complex background minHeight.",
				COMPLEX_BACKGROUND_MIN_HEIGHT, this._button.minHeight);
		}

		[Test]
		public function testAutoSizeWithLargeSimpleBackgroundPaddingAndGap():void
		{
			this._button.paddingTop = PADDING_TOP;
			this._button.paddingRight = PADDING_RIGHT;
			this._button.paddingBottom = PADDING_BOTTOM;
			this._button.paddingLeft = PADDING_LEFT;
			this._button.gap = GAP;
			this.addLargeSimpleBackground();
			this._button.validate();
			Assert.assertStrictlyEquals("The width of the Button was not calculated correctly with background skin, padding, and gap.",
				LARGE_BACKGROUND_WIDTH, this._button.width);
			Assert.assertStrictlyEquals("The height of the Button was not calculated correctly with background skin, padding, and gap.",
				LARGE_BACKGROUND_HEIGHT, this._button.height);
			Assert.assertStrictlyEquals("The minWidth of the Button was not calculated correctly with background skin, padding, and gap.",
				LARGE_BACKGROUND_WIDTH, this._button.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Button was not calculated correctly with background skin, padding, and gap.",
				LARGE_BACKGROUND_HEIGHT, this._button.minHeight);
		}

		[Test]
		public function testChangeTextToResizeSkin():void
		{
			this._button.label = "I am the very model of a modern major general";
			this.addSmallSimpleBackground();
			this._button.disabledSkin = new Quad(SMALL_BACKGROUND_WIDTH, SMALL_BACKGROUND_HEIGHT, 0xff00ff);
			this._button.validate();
			//the text's dimensions were large enough to make button bigger than
			//the skin's dimensions
			this._button.label = "";
			//switch to a different skin before validation
			this._button.isEnabled = false;
			this._button.validate();
			//now switch back to the original skin, and the dimensions could
			//be wrong if they weren't restored
			this._button.isEnabled = true;
			this._button.validate();
			Assert.assertStrictlyEquals("The width of the Button was not calculated correctly after changing to a different skin and changing label dimensions.",
				SMALL_BACKGROUND_WIDTH, this._button.width);
			Assert.assertStrictlyEquals("The height of the Button was not calculated correctly after changing to a different skin and changing label dimensions",
				SMALL_BACKGROUND_HEIGHT, this._button.height);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ButtonTests.as
================================================
package feathers.tests
{
	import feathers.controls.Button;
	import feathers.controls.ButtonState;
	import feathers.events.FeathersEventType;
	import feathers.tests.supportClasses.DisposeFlagQuad;

	import flash.geom.Point;

	import org.flexunit.Assert;
	import org.flexunit.async.Async;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class ButtonTests
	{
		private var _button:Button;
		private var _blocker:Quad;

		[Before]
		public function prepare():void
		{
			this._button = new Button();
			this._button.label = "Click Me";
			this._button.defaultSkin = new Quad(200, 200);
			TestFeathers.starlingRoot.addChild(this._button);
			this._button.validate();
		}

		[After]
		public function cleanup():void
		{
			this._button.removeFromParent(true);
			this._button = null;
			
			if(this._blocker)
			{
				this._blocker.removeFromParent(true);
				this._blocker = null;
			}

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testTriggeredEvent():void
		{
			var hasTriggered:Boolean = false;
			this._button.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.TRIGGERED was not dispatched", hasTriggered);
		}

		[Test]
		public function testTouchMoveOutsideBeforeTriggeredEvent():void
		{
			var hasTriggered:Boolean = false;
			this._button.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.globalX = 1000; //move the touch way outside the bounds of the button
			touch.phase = TouchPhase.MOVED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertFalse("Event.TRIGGERED was incorrectly dispatched", hasTriggered);
		}

		[Test]
		public function testOtherDisplayObjectBlockingTriggeredEvent():void
		{
			var hasTriggered:Boolean = false;
			this._button.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			this._blocker = new Quad(200, 200, 0xff0000);
			TestFeathers.starlingRoot.addChild(this._blocker);

			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertFalse("Event.TRIGGERED was incorrectly dispatched", hasTriggered);
		}

		[Test(async)]
		public function testLongPressEvent():void
		{
			var hasLongPressed:Boolean = false;
			this._button.isLongPressEnabled = true;
			this._button.validate();
			this._button.addEventListener(FeathersEventType.LONG_PRESS, function():void
			{
				hasLongPressed = true;
			});
			var touch:Touch = new Touch(0);
			touch.target = this._button;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 10;
			touch.globalY = 10;
			var touches:Vector.<Touch> = new <Touch>[touch];
			this._button.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("FeathersEventType.LONG_PRESS was not dispatched", hasLongPressed);
			}, 600);
		}

		[Test(async)]
		public function testTouchMoveOutsideBeforeLongPressEvent():void
		{
			var hasLongPressed:Boolean = false;
			this._button.addEventListener(FeathersEventType.LONG_PRESS, function():void
			{
				hasLongPressed = true;
			});
			var touch:Touch = new Touch(0);
			touch.target = this._button;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 10;
			touch.globalY = 10;
			var touches:Vector.<Touch> = new <Touch>[touch];
			this._button.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.globalX = 1000; //move the touch way outside the bounds of the button
			touch.phase = TouchPhase.MOVED;
			this._button.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Async.delayCall(this, function():void
			{
				Assert.assertFalse("FeathersEventType.LONG_PRESS was incorrectly dispatched after touch moved out of bounds", hasLongPressed);
			}, 600);
		}

		[Test(async)]
		public function testOtherDisplayObjectBlockingLongPressEvent():void
		{
			var hasLongPressed:Boolean = false;
			this._button.isLongPressEnabled = true;
			this._button.validate();
			this._button.addEventListener(FeathersEventType.LONG_PRESS, function():void
			{
				hasLongPressed = true;
			});
			var touch:Touch = new Touch(0);
			touch.target = this._button;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 10;
			touch.globalY = 10;
			var touches:Vector.<Touch> = new <Touch>[touch];
			this._button.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			
			this._blocker = new Quad(200, 200, 0xff0000);
			TestFeathers.starlingRoot.addChild(this._blocker);
			
			Async.delayCall(this, function():void
			{
				Assert.assertFalse("FeathersEventType.LONG_PRESS was incorrectly dispatched", hasLongPressed);
			}, 600);
		}

		[Test]
		public function testSkinsDisposed():void
		{
			var defaultSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.defaultSkin = defaultSkin;
			var upSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.upSkin = upSkin;
			var downSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.downSkin = downSkin;
			var hoverSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.hoverSkin = hoverSkin;
			var disabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.disabledSkin = disabledSkin;
			this._button.validate();
			this._button.dispose();
			Assert.assertTrue("defaultSkin not disposed when Button disposed.", defaultSkin.isDisposed);
			Assert.assertTrue("upSkin not disposed when Button disposed.", upSkin.isDisposed);
			Assert.assertTrue("downSkin not disposed when Button disposed.", downSkin.isDisposed);
			Assert.assertTrue("hoverSkin not disposed when Button disposed.", hoverSkin.isDisposed);
			Assert.assertTrue("disabledSkin not disposed when Button disposed.", disabledSkin.isDisposed);
		}

		[Test]
		public function testIconsDisposed():void
		{
			var defaultIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.defaultIcon = defaultIcon;
			var upIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.upIcon = upIcon;
			var downIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.downSkin = downIcon;
			var hoverIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.hoverIcon = hoverIcon;
			var disabledIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.disabledIcon = disabledIcon;
			this._button.validate();
			this._button.dispose();
			Assert.assertTrue("defaultIcon not disposed when Button disposed.", defaultIcon.isDisposed);
			Assert.assertTrue("upIcon not disposed when Button disposed.", upIcon.isDisposed);
			Assert.assertTrue("downIcon not disposed when Button disposed.", downIcon.isDisposed);
			Assert.assertTrue("hoverIcon not disposed when Button disposed.", hoverIcon.isDisposed);
			Assert.assertTrue("disabledIcon not disposed when Button disposed.", disabledIcon.isDisposed);
		}

		[Test]
		public function testIconsRemovedWhenSetToNull():void
		{
			var defaultIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.defaultIcon = defaultIcon;
			var upIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setIconForState(ButtonState.UP, upIcon);
			var downIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setIconForState(ButtonState.DOWN, downIcon);
			var hoverIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setIconForState(ButtonState.HOVER, hoverIcon);
			var disabledIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setIconForState(ButtonState.DISABLED, disabledIcon);
			this._button.validate();
			this._button.defaultIcon = null;
			this._button.setIconForState(ButtonState.UP, null);
			this._button.setIconForState(ButtonState.DOWN, null);
			this._button.setIconForState(ButtonState.HOVER, null);
			this._button.setIconForState(ButtonState.DISABLED, null);
			//should not need to validate here
			this._button.dispose();
			Assert.assertFalse("Removed defaultIcon incorrectly disposed when Button disposed.", defaultIcon.isDisposed);
			Assert.assertFalse("Removed upIcon incorrectly disposed when Button disposed.", upIcon.isDisposed);
			Assert.assertFalse("Removed downIcon incorrectly disposed when Button disposed.", downIcon.isDisposed);
			Assert.assertFalse("Removed hoverIcon incorrectly disposed when Button disposed.", hoverIcon.isDisposed);
			Assert.assertFalse("Removed disabledIcon incorrectly disposed when Button disposed.", disabledIcon.isDisposed);
			Assert.assertNull("defaultIcon parent must be null when removed from Button.", defaultIcon.parent);
			Assert.assertNull("upIcon parent must be null when removed from Button.", upIcon.parent);
			Assert.assertNull("downIcon parent must be null when removed from Button.", downIcon.parent);
			Assert.assertNull("hoverIcon parent must be null when removed from Button.", hoverIcon.parent);
			Assert.assertNull("disabledIcon parent must be null when removed from Button.", disabledIcon.parent);
			defaultIcon.dispose();
			upIcon.dispose();
			downIcon.dispose();
			hoverIcon.dispose();
			disabledIcon.dispose();
		}

	}
}


================================================
FILE: test/source/feathers/tests/CalloutMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.Callout;
	import feathers.controls.Label;
	import feathers.controls.LayoutGroup;
	import feathers.layout.RelativePosition;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;

	public class CalloutMeasurementTests
	{
		//note: the background width is purposefully smaller than the item width
		private static const BACKGROUND_WIDTH:Number = 200;
		//note: the background height is purposefully larger than the item height
		private static const BACKGROUND_HEIGHT:Number = 250;
		private static const BACKGROUND_MIN_WIDTH:Number = 180;
		private static const BACKGROUND_MIN_HEIGHT:Number = 140;

		//note: the content width is purposefully larger than the background width
		private static const CONTENT_WIDTH:Number = 210;
		//note: the content height is purposefully smaller than the background height
		private static const CONTENT_HEIGHT:Number = 160;
		private static const SMALL_CONTENT_WIDTH:Number = 50;
		private static const SMALL_CONTENT_HEIGHT:Number = 60;
		private static const CONTENT_MIN_WIDTH:Number = 160;
		private static const CONTENT_MIN_HEIGHT:Number = 150;
		
		private static const TOP_ARROW_WIDTH:Number = 20;
		private static const TOP_ARROW_HEIGHT:Number = 8;
		private static const RIGHT_ARROW_WIDTH:Number = 14;
		private static const RIGHT_ARROW_HEIGHT:Number = 22;
		private static const BOTTOM_ARROW_WIDTH:Number = 19;
		private static const BOTTOM_ARROW_HEIGHT:Number = 12;
		private static const LEFT_ARROW_WIDTH:Number = 23;
		private static const LEFT_ARROW_HEIGHT:Number = 16;

		private static const ORIGIN_WIDTH:Number = 44;
		private static const ORIGIN_HEIGHT:Number = 42;
		
		private var _callout:Callout;
		private var _origin:DisplayObject;

		[Before]
		public function prepare():void
		{
			this._callout = new Callout();
			this._callout.disposeContent = true;
			TestFeathers.starlingRoot.addChild(this._callout);
		}

		[After]
		public function cleanup():void
		{
			this._callout.removeFromParent(true);
			this._callout = null;

			if(this._origin)
			{
				this._origin.removeFromParent(true);
				this._origin = null;
			}

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function addArrows():void
		{
			this._callout.topArrowSkin = new Quad(TOP_ARROW_WIDTH, TOP_ARROW_HEIGHT);
			this._callout.rightArrowSkin = new Quad(RIGHT_ARROW_WIDTH, RIGHT_ARROW_HEIGHT);
			this._callout.bottomArrowSkin = new Quad(BOTTOM_ARROW_WIDTH, BOTTOM_ARROW_HEIGHT);
			this._callout.leftArrowSkin = new Quad(LEFT_ARROW_WIDTH, LEFT_ARROW_HEIGHT);
		}

		private function addSimpleBackground():void
		{
			this._callout.backgroundSkin = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT);
		}

		private function addComplexBackground():void
		{
			var backgroundSkin:LayoutGroup = new LayoutGroup();
			backgroundSkin.setSize(BACKGROUND_WIDTH, BACKGROUND_HEIGHT);
			backgroundSkin.minWidth = BACKGROUND_MIN_WIDTH;
			backgroundSkin.minHeight = BACKGROUND_MIN_HEIGHT;
			this._callout.backgroundSkin = backgroundSkin;
		}
		
		private function addSimpleContent():void
		{
			this._callout.content = new Quad(CONTENT_WIDTH, CONTENT_HEIGHT);
		}
		
		private function addSmallAutoSizeContent():void
		{
			var content:LayoutGroup = new LayoutGroup();
			content.backgroundSkin = new Quad(SMALL_CONTENT_WIDTH, SMALL_CONTENT_HEIGHT);
			this._callout.content = content;
		}

		private function addComplexContent():void
		{
			var content:LayoutGroup = new LayoutGroup();
			content.setSize(CONTENT_WIDTH, CONTENT_HEIGHT);
			content.minWidth = CONTENT_MIN_WIDTH;
			content.minHeight = CONTENT_MIN_HEIGHT;
			this._callout.content = content;
		}
		
		private function addOrigin():void
		{
			this._origin = new Quad(ORIGIN_WIDTH, ORIGIN_HEIGHT);
			TestFeathers.starlingRoot.addChild(this._origin);
			this._callout.origin = this._origin;
		}

		[Test]
		public function testAutoSizeNoContentNoBackground():void
		{
			this._callout.validate();
			Assert.assertStrictlyEquals("The width of the Callout was not calculated correctly when empty.",
				0, this._callout.width);
			Assert.assertStrictlyEquals("The height of the Callout was not calculated correctly when empty.",
				0, this._callout.height);
			Assert.assertStrictlyEquals("The minWidth of the Callout was not calculated correctly when empty.",
				0, this._callout.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Callout was not calculated correctly when empty.",
				0, this._callout.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleBackgroundAndNoContent():void
		{
			this.addSimpleBackground();
			this._callout.validate();
			Assert.assertStrictlyEquals("The width of the Callout was not calculated correctly with background skin and no content.",
				BACKGROUND_WIDTH, this._callout.width);
			Assert.assertStrictlyEquals("The height of the Callout was not calculated correctly with background skin and no content.",
				BACKGROUND_HEIGHT, this._callout.height);
			Assert.assertStrictlyEquals("The minWidth of the Callout was not calculated correctly with background skin and no content.",
				BACKGROUND_WIDTH, this._callout.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Callout was not calculated correctly with background skin and no content.",
				BACKGROUND_HEIGHT, this._callout.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexBackgroundAndNoContent():void
		{
			this.addComplexBackground();
			this._callout.validate();
			Assert.assertStrictlyEquals("The width of the Callout was not calculated correctly with complex background skin and no content.",
				BACKGROUND_WIDTH, this._callout.width);
			Assert.assertStrictlyEquals("The height of the Callout was not calculated correctly with complex background skin and no content.",
				BACKGROUND_HEIGHT, this._callout.height);
			Assert.assertStrictlyEquals("The minWidth of the Callout was not calculated correctly with complex background skin and no content.",
				BACKGROUND_MIN_WIDTH, this._callout.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Callout was not calculated correctly with complex background skin and no content.",
				BACKGROUND_MIN_HEIGHT, this._callout.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleContent():void
		{
			this.addSimpleContent();
			this._callout.validate();
			Assert.assertStrictlyEquals("The width of the Callout was not calculated correctly.",
				CONTENT_WIDTH, this._callout.width);
			Assert.assertStrictlyEquals("The height of the Callout was not calculated correctly.",
				CONTENT_HEIGHT, this._callout.height);
			Assert.assertStrictlyEquals("The minWidth of the Callout was not calculated correctly.",
				CONTENT_WIDTH, this._callout.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Callout was not calculated correctly.",
				CONTENT_HEIGHT, this._callout.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexContent():void
		{
			this.addComplexContent();
			this._callout.validate();
			Assert.assertStrictlyEquals("The width of the Callout was not calculated correctly.",
				CONTENT_WIDTH, this._callout.width);
			Assert.assertStrictlyEquals("The height of the Callout was not calculated correctly.",
				CONTENT_HEIGHT, this._callout.height);
			Assert.assertStrictlyEquals("The minWidth of the Callout was not calculated correctly.",
				CONTENT_MIN_WIDTH, this._callout.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Callout was not calculated correctly.",
				CONTENT_MIN_HEIGHT, this._callout.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleContentAndBackground():void
		{
			this.addSimpleBackground();
			this.addSimpleContent();
			this._callout.validate();
			Assert.assertStrictlyEquals("The width of the Callout was not calculated correctly.",
				CONTENT_WIDTH, this._callout.width);
			Assert.assertStrictlyEquals("The height of the Callout was not calculated correctly.",
				BACKGROUND_HEIGHT, this._callout.height);
			Assert.assertStrictlyEquals("The minWidth of the Callout was not calculated correctly.",
				CONTENT_WIDTH, this._callout.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Callout was not calculated correctly.",
				BACKGROUND_HEIGHT, this._callout.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexContentAndBackground():void
		{
			this.addComplexBackground();
			this.addComplexContent();
			this._callout.validate();
			Assert.assertStrictlyEquals("The width of the Callout was not calculated correctly.",
				CONTENT_WIDTH, this._callout.width);
			Assert.assertStrictlyEquals("The height of the Callout was not calculated correctly.",
				BACKGROUND_HEIGHT, this._callout.height);
			Assert.assertStrictlyEquals("The minWidth of the Callout was not calculated correctly.",
				BACKGROUND_MIN_WIDTH, this._callout.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Callout was not calculated correctly.",
				CONTENT_MIN_HEIGHT, this._callout.minHeight);
		}

		[Test]
		public function testAutoSizeWithTopArrow():void
		{
			this.addSimpleBackground();
			this.addArrows();
			this._callout.arrowPosition = RelativePosition.TOP;
			this._callout.validate();
			Assert.assertStrictlyEquals("The width of the Callout was not calculated correctly.",
				BACKGROUND_WIDTH, this._callout.width);
			Assert.assertStrictlyEquals("The height of the Callout was not calculated correctly.",
				BACKGROUND_HEIGHT + TOP_ARROW_HEIGHT, this._callout.height);
			Assert.assertStrictlyEquals("The minWidth of the Callout was not calculated correctly.",
				BACKGROUND_WIDTH, this._callout.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Callout was not calculated correctly.",
				BACKGROUND_HEIGHT + TOP_ARROW_HEIGHT, this._callout.minHeight);
		}

		[Test]
		public function testAutoSizeWithRightArrow():void
		{
			this.addSimpleBackground();
			this.addArrows();
			this._callout.arrowPosition = RelativePosition.RIGHT;
			this._callout.validate();
			Assert.assertStrictlyEquals("The width of the Callout was not calculated correctly.",
				BACKGROUND_WIDTH + RIGHT_ARROW_WIDTH, this._callout.width);
			Assert.assertStrictlyEquals("The height of the Callout was not calculated correctly.",
				BACKGROUND_HEIGHT, this._callout.height);
			Assert.assertStrictlyEquals("The minWidth of the Callout was not calculated correctly.",
				BACKGROUND_WIDTH + RIGHT_ARROW_WIDTH, this._callout.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Callout was not calculated correctly.",
				BACKGROUND_HEIGHT, this._callout.minHeight);
		}

		[Test]
		public function testAutoSizeWithBottomArrow():void
		{
			this.addSimpleBackground();
			this.addArrows();
			this._callout.arrowPosition = RelativePosition.BOTTOM;
			this._callout.validate();
			Assert.assertStrictlyEquals("The width of the Callout was not calculated correctly.",
				BACKGROUND_WIDTH, this._callout.width);
			Assert.assertStrictlyEquals("The height of the Callout was not calculated correctly.",
				BACKGROUND_HEIGHT + BOTTOM_ARROW_HEIGHT, this._callout.height);
			Assert.assertStrictlyEquals("The minWidth of the Callout was not calculated correctly.",
				BACKGROUND_WIDTH, this._callout.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Callout was not calculated correctly.",
				BACKGROUND_HEIGHT + BOTTOM_ARROW_HEIGHT, this._callout.minHeight);
		}

		[Test]
		public function testAutoSizeWithLeftArrow():void
		{
			this.addSimpleBackground();
			this.addArrows();
			this._callout.arrowPosition = RelativePosition.LEFT;
			this._callout.validate();
			Assert.assertStrictlyEquals("The width of the Callout was not calculated correctly.",
				BACKGROUND_WIDTH + LEFT_ARROW_WIDTH, this._callout.width);
			Assert.assertStrictlyEquals("The height of the Callout was not calculated correctly.",
				BACKGROUND_HEIGHT, this._callout.height);
			Assert.assertStrictlyEquals("The minWidth of the Callout was not calculated correctly.",
				BACKGROUND_WIDTH + LEFT_ARROW_WIDTH, this._callout.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Callout was not calculated correctly.",
				BACKGROUND_HEIGHT, this._callout.minHeight);
		}

		[Test]
		public function testWrappingLabel():void
		{
			var label:Label = new Label();
			label.text = "Lorem ipsum dolor sit amet, consectetur adipiscing 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.";
			label.wordWrap = true;

			var label2:Label = new Label();
			label2.text = "Lorem ipsum dolor sit amet, consectetur adipiscing 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.";
			label2.validate();
			label2.dispose();

			this._callout.content = label;
			this._callout.validate();

			Assert.assertTrue("Callout: when content is set to Label with wordWrap true, the numLines should be greater than 1",
				label.numLines > 1);
			Assert.assertTrue("Callout: when content is set to Label with wordWrap true, the height should be greater than the height for 1 line",
				label.height > label2.height);
		}

		[Test]
		/**
		 * issue #1573
		 */
		public function testMoveOriginAndBackgroundLargerThanContent():void
		{
			this.addSimpleBackground();
			this.addSmallAutoSizeContent();
			this.addOrigin();
			this._callout.supportedPositions = new <String>[RelativePosition.RIGHT];
			this._callout.validate();
			//make sure that the position of the arrow does not change when
			//moving the origin, or this test won't be able to catch the bug
			//that it's trying to catch. the callout cannot invalidate!
			this._origin.x += 50;
			this._origin.stage.starling.nextFrame();
			Assert.assertFalse("Callout: must not be invalid.",
				this._callout.isInvalid());
			Assert.assertStrictlyEquals("Callout: content width must be changed if background width is larger",
				BACKGROUND_WIDTH, this._callout.content.width);
			Assert.assertStrictlyEquals("Callout: content height must be changed if background height is larger",
				BACKGROUND_HEIGHT, this._callout.content.height);
		}
	}
}


================================================
FILE: test/source/feathers/tests/CalloutPopUpContentManagerTests.as
================================================
package feathers.tests
{
	import feathers.controls.popups.CalloutPopUpContentManager;
	import feathers.core.PopUpManager;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.display.Sprite;
	import starling.events.Event;

	public class CalloutPopUpContentManagerTests
	{
		private static const OVERLAY_NAME:String = "CalloutPopUpContentManagerOverlay";
		
		private var _popUp:DisplayObject;
		private var _customRoot:Sprite;
		private var _source:Quad;
		private var _popUpContentManager:CalloutPopUpContentManager;

		[Before]
		public function prepare():void
		{
			this._source = new Quad(200, 180, 0x00ff00);
			TestFeathers.starlingRoot.addChild(this._source);

			this._customRoot = new Sprite();
			TestFeathers.starlingRoot.addChild(this._customRoot);
			PopUpManager.root = this._customRoot;

			this._popUpContentManager = new CalloutPopUpContentManager();
		}

		[After]
		public function cleanup():void
		{
			this._source.removeFromParent(true);
			this._source = null;
			
			this._customRoot.removeFromParent(true);
			this._customRoot = null;

			if(this._popUp)
			{
				this._popUp.removeFromParent(true);
				this._popUp = null;
			}
			
			PopUpManager.root = TestFeathers.starlingRoot.stage;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function createSimplePopUp():DisplayObject
		{
			var simplePopUp:Quad = new Quad(100, 150, 0xff00ff);
			return simplePopUp;
		}

		private function createOverlay():DisplayObject
		{
			var overlay:Quad = new Quad(1, 1, 0x000000);
			overlay.alpha = 0.5;
			overlay.name = OVERLAY_NAME;
			return overlay;
		}

		[Test]
		public function testOpen():void
		{
			this._popUp = this.createSimplePopUp();
			var openDispatched:Boolean = false;
			this._popUpContentManager.addEventListener(Event.OPEN, function(event:Event):void
			{
				openDispatched = true;
			});
			this._popUpContentManager.open(this._popUp, this._source);
			Assert.assertNotNull("CalloutPopUpContentManager content parent should not be null.", this._popUp.parent);
			Assert.assertTrue("CalloutPopUpContentManager did not dispatch Event.OPEN.", openDispatched);
		}

		[Test]
		public function testClose():void
		{
			this._popUp = this.createSimplePopUp();
			var closeDispatched:Boolean = false;
			this._popUpContentManager.addEventListener(Event.CLOSE, function(event:Event):void
			{
				closeDispatched = true;
			});
			this._popUpContentManager.open(this._popUp, this._source);
			this._popUpContentManager.close();
			Assert.assertNull("CalloutPopUpContentManager content parent should be null.", this._popUp.parent);
			Assert.assertTrue("CalloutPopUpContentManager did not dispatch Event.CLOSE.", closeDispatched);
		}

		[Test]
		public function testOverlayFactory():void
		{
			this._popUp = this.createSimplePopUp();
			this._popUpContentManager.isModal = true;
			this._popUpContentManager.overlayFactory = this.createOverlay;
			this._popUpContentManager.open(this._popUp, this._source);
			var overlay:DisplayObject = this._customRoot.getChildByName(OVERLAY_NAME);
			Assert.assertNotNull("DropDownPopUpContentManager overlayFactory result not found.", overlay);
		}
	}
}



================================================
FILE: test/source/feathers/tests/CalloutTests.as
================================================
package feathers.tests
{
	import feathers.controls.Callout;
	import feathers.tests.supportClasses.DisposeFlagQuad;

	import flash.geom.Point;

	import org.flexunit.Assert;
	import org.flexunit.async.Async;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.display.Stage;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class CalloutTests
	{
		private var _callout:Callout;
		private var _origin:Quad;

		[Before]
		public function prepare():void
		{
			this._origin = new Quad(100, 100, 0xff00ff);
			this._origin.x = 100;
			this._origin.y = 100;
			TestFeathers.starlingRoot.addChild(this._origin);
		}

		[After]
		public function cleanup():void
		{
			this._callout.removeFromParent(true);
			if(this._callout.content)
			{
				this._callout.content.dispose();
			}
			this._callout = null;
			
			this._origin.removeFromParent(true);
			this._origin = null;
			
			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
			Assert.assertStrictlyEquals("Child not removed from Starling stage on cleanup.", 1, TestFeathers.starlingRoot.stage.numChildren);
		}

		[Test(async)]
		public function testCloseOnTouchBeganOutside():void
		{
			this._callout = Callout.show(new Quad(100, 100, 0xffff00), this._origin);
			this._callout.closeOnTouchBeganOutside = true;
			var stage:Stage = this._callout.stage;
			Async.delayCall(this, function():void
			{
				var position:Point = new Point(stage.stageWidth - 1, stage.stageHeight - 1);
				var target:DisplayObject = stage.hitTest(position);
				var touch:Touch = new Touch(0);
				touch.target = target;
				touch.phase = TouchPhase.BEGAN;
				touch.globalX = position.x;
				touch.globalY = position.y;
				var touches:Vector.<Touch> = new <Touch>[touch];
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
				
				Assert.assertNull("Callout not removed from parent on TouchPhase.BEGAN", _callout.parent);
			}, 1);
		}

		[Test(async)]
		public function testCloseOnTouchEndedOutside():void
		{
			this._callout = Callout.show(new Quad(100, 100, 0xff00ff), this._origin);
			//this._callout.closeOnTouchBeganOutside = false;
			this._callout.closeOnTouchEndedOutside = true;
			var stage:Stage = this._callout.stage;
			Async.delayCall(this, function():void
			{
				var position:Point = new Point(stage.stageWidth - 1, stage.stageHeight - 1);
				var target:DisplayObject = stage.hitTest(position);
				var touch:Touch = new Touch(0);
				touch.target = target;
				touch.phase = TouchPhase.BEGAN;
				touch.globalX = position.x;
				touch.globalY = position.y;
				var touches:Vector.<Touch> = new <Touch>[touch];
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
				touch.phase = TouchPhase.ENDED;
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
				Assert.assertNull("Callout not removed from parent on TouchPhase.ENDED", _callout.parent);
			}, 1);
		}

		[Test]
		public function testDisposeContentSetToTrue():void
		{
			var content:DisposeFlagQuad = new DisposeFlagQuad();
			this._callout = Callout.show(content, this._origin);
			this._callout.disposeContent = true;
			this._callout.removeFromParent(true);
			Assert.assertTrue("Callout content not disposed when disposeContent is true", content.isDisposed);
		}

		[Test]
		public function testDisposeContentSetToFalse():void
		{
			var content:DisposeFlagQuad = new DisposeFlagQuad();
			this._callout = Callout.show(content, this._origin);
			this._callout.disposeContent = false;
			this._callout.removeFromParent(true);
			Assert.assertFalse("Callout content incorrectly disposed when disposeContent is false", content.isDisposed);
		}

		[Test(async)]
		public function testDisposeOnSelfCloseSetToTrue():void
		{
			var content:DisposeFlagQuad = new DisposeFlagQuad();
			this._callout = Callout.show(content, this._origin);
			this._callout.disposeContent = true;
			this._callout.disposeOnSelfClose = true;
			this._callout.closeOnTouchBeganOutside = true;
			var stage:Stage = this._callout.stage;
			Async.delayCall(this, function():void
			{
				var position:Point = new Point(stage.stageWidth - 1, stage.stageHeight - 1);
				var target:DisplayObject = stage.hitTest(position);
				var touch:Touch = new Touch(0);
				touch.target = target;
				touch.phase = TouchPhase.BEGAN;
				touch.globalX = position.x;
				touch.globalY = position.y;
				var touches:Vector.<Touch> = new <Touch>[touch];
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
				
				Assert.assertTrue("Callout content not disposed when closed and disposeOnSelfClose is true", content.isDisposed);
			}, 1);
		}

		[Test(async)]
		public function testDisposeOnSelfCloseSetToFalse():void
		{
			var content:DisposeFlagQuad = new DisposeFlagQuad();
			this._callout = Callout.show(content, this._origin);
			this._callout.disposeContent = true;
			this._callout.disposeOnSelfClose = false;
			this._callout.closeOnTouchBeganOutside = true;
			var stage:Stage = this._callout.stage;
			Async.delayCall(this, function():void
			{
				var position:Point = new Point(stage.stageWidth - 1, stage.stageHeight - 1);
				var target:DisplayObject = stage.hitTest(position);
				var touch:Touch = new Touch(0);
				touch.target = target;
				touch.phase = TouchPhase.BEGAN;
				touch.globalX = position.x;
				touch.globalY = position.y;
				var touches:Vector.<Touch> = new <Touch>[touch];
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
				
				Assert.assertFalse("Callout content not disposed when closed and disposeOnSelfClose is true", content.isDisposed);
			}, 1);
		}
	}
}

================================================
FILE: test/source/feathers/tests/ComponentLifecycleTests.as
================================================
package feathers.tests
{
	import feathers.controls.LayoutGroup;
	import feathers.events.FeathersEventType;

	import org.flexunit.Assert;

	import starling.events.Event;

	public class ComponentLifecycleTests
	{
		private var _control:LayoutGroup;

		[Before]
		public function prepare():void
		{
			this._control = new LayoutGroup();
		}

		[After]
		public function cleanup():void
		{
			this._control.removeFromParent(true);
			this._control = null;
			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testInitializeEventAfterAddedToStage():void
		{
			var hasInitialized:Boolean = false;
			this._control.addEventListener(FeathersEventType.INITIALIZE, function(event:Event):void
			{
				hasInitialized = true;
			});
			TestFeathers.starlingRoot.addChild(this._control);
			Assert.assertTrue("FeathersEventType.INITIALIZE was not dispatched after added to stage", hasInitialized);
		}

		[Test]
		public function testInitializeEventAfterValidateOffStage():void
		{
			var hasInitialized:Boolean = false;
			this._control.addEventListener(FeathersEventType.INITIALIZE, function(event:Event):void
			{
				hasInitialized = true;
			});
			this._control.validate();
			Assert.assertTrue("FeathersEventType.INITIALIZE was not dispatched after validate()", hasInitialized);
		}

		[Test]
		public function testIsInitializedProperty():void
		{
			Assert.assertFalse("isInitialized is not false before after added to stage", this._control.isInitialized);
			TestFeathers.starlingRoot.addChild(this._control);
			Assert.assertTrue("isInitialized was not changed to true after added to stage", this._control.isInitialized);
		}

		[Test]
		public function testCreationCompleteEventAfterValidate():void
		{
			var isCreated:Boolean = false;
			this._control.addEventListener(FeathersEventType.CREATION_COMPLETE, function(event:Event):void
			{
				isCreated = true;
			});
			this._control.validate();
			Assert.assertTrue("FeathersEventType.CREATION_COMPLETE was not dispatched after validate()", isCreated);
		}

		[Test]
		public function testIsCreatedProperty():void
		{
			Assert.assertFalse("isCreated is not false before validate()", this._control.isCreated);
			this._control.validate();
			Assert.assertTrue("isCreated was not changed to true after validate()", this._control.isCreated);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ConditionalStyleProviderTests.as
================================================
package feathers.tests
{
	import feathers.controls.BasicButton;
	import feathers.core.IFeathersControl;
	import feathers.skins.ConditionalStyleProvider;
	import feathers.tests.supportClasses.CustomStyleProvider;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class ConditionalStyleProviderTests
	{
		private var _target:BasicButton;
		private var _styleProvider:ConditionalStyleProvider;
		private var _falseStyleProvider:CustomStyleProvider;
		private var _trueStyleProvider:CustomStyleProvider;

		[Before]
		public function prepare():void
		{
			this._target = new BasicButton();
			this._target.defaultSkin = new Quad(200, 200, 0xff00ff);

			this._falseStyleProvider = new CustomStyleProvider();
			this._trueStyleProvider = new CustomStyleProvider();
		}

		[After]
		public function cleanup():void
		{
			this._target.removeFromParent(true);
			this._target = null;

			this._styleProvider = null;
			this._falseStyleProvider = null;
			this._trueStyleProvider = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function falseConditionalFunction(target:IFeathersControl):Boolean
		{
			return false;
		}

		private function trueConditionalFunction(target:IFeathersControl):Boolean
		{
			return true;
		}

		[Test]
		public function testNoErrorWithNullConditionalFunction():void
		{
			this._styleProvider = new ConditionalStyleProvider(null);
			this._styleProvider.applyStyles(this._target);
		}

		[Test]
		public function testNoErrorWithNullStyleProviders():void
		{
			this._styleProvider = new ConditionalStyleProvider(falseConditionalFunction);
			this._styleProvider.applyStyles(this._target);
		}

		[Test]
		public function testNoErrorWithNullFalseStyleProvider():void
		{
			this._styleProvider = new ConditionalStyleProvider(falseConditionalFunction,
				this._trueStyleProvider, null);
			this._styleProvider.applyStyles(this._target);
		}

		[Test]
		public function testNoErrorWithNullTrueStyleProvider():void
		{
			this._styleProvider = new ConditionalStyleProvider(trueConditionalFunction,
				null, this._falseStyleProvider);
			this._styleProvider.applyStyles(this._target);
		}

		[Test]
		public function testFalseStyleProvider():void
		{
			this._styleProvider = new ConditionalStyleProvider(falseConditionalFunction,
				this._trueStyleProvider, this._falseStyleProvider);
			this._styleProvider.applyStyles(this._target);
			Assert.assertTrue("When ConditionalStyleProvider condition is false, falseStyleProvider.applyStyles() must be called.",
				this._falseStyleProvider.appliedStyles);
			Assert.assertFalse("When ConditionalStyleProvider condition is false, trueStyleProvider.applyStyles() must not be called.",
				this._trueStyleProvider.appliedStyles);
		}

		[Test]
		public function testTrueStyleProvider():void
		{
			this._styleProvider = new ConditionalStyleProvider(trueConditionalFunction,
				this._trueStyleProvider, this._falseStyleProvider);
			this._styleProvider.applyStyles(this._target);
			Assert.assertTrue("When ConditionalStyleProvider condition is true, trueStyleProvider.applyStyles() must be called.",
				this._trueStyleProvider.appliedStyles);
			Assert.assertFalse("When ConditionalStyleProvider condition is true, falseStyleProvider.applyStyles() must not be called.",
				this._falseStyleProvider.appliedStyles);
		}
	}
}


================================================
FILE: test/source/feathers/tests/DateTimeSpinnerTests.as
================================================
package feathers.tests
{
	import feathers.controls.DateTimeMode;
	import feathers.controls.DateTimeSpinner;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.tests.supportClasses.DisposeFlagQuad;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class DateTimeSpinnerTests
	{
		private static const BACKGROUND_WIDTH:Number = 4000;
		private static const BACKGROUND_HEIGHT:Number = 4100;

		private static const PADDING_TOP:Number = 4000;
		private static const PADDING_RIGHT:Number = 1000;
		private static const PADDING_BOTTOM:Number = 3000;
		private static const PADDING_LEFT:Number = 900;

		private var _spinner:DateTimeSpinner;

		[Before]
		public function prepare():void
		{
			this._spinner = new DateTimeSpinner();
			this._spinner.itemRendererFactory = function():DefaultListItemRenderer
			{
				var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
				itemRenderer.defaultSkin = new Quad(200, 88, 0xffffff);
				return itemRenderer;
			};
			TestFeathers.starlingRoot.addChild(this._spinner);
		}

		[After]
		public function cleanup():void
		{
			this._spinner.removeFromParent(true);
			this._spinner = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testSetValueProgramaticallyWithoutMinimumOrMaximumWithoutRuntimeError():void
		{
			this._spinner.value = new Date();
		}

		[Test]
		public function testSetValueProgramaticallyNotEqual():void
		{
			var value:Date = new Date();
			this._spinner.value = value;
			Assert.assertFalse("Incorrectly uses same Date object when setting value property.", value === this._spinner.value);
		}

		[Test]
		public function testSetValueProgramaticallyWithMinimum():void
		{
			this._spinner.minimum = new Date(2015, 6, 15);
			this._spinner.value = new Date(2015, 6, 14);
			Assert.assertEquals("Setting value smaller than minimum not changed to minimum.", this._spinner.minimum.valueOf(), this._spinner.value.valueOf());
		}

		[Test]
		public function testSetValueProgramaticallyWithMaximum():void
		{
			this._spinner.maximum = new Date(2015, 6, 15);
			this._spinner.value = new Date(2015, 6, 16);
			Assert.assertEquals("Setting value larger than maximum not changed to maximum.", this._spinner.maximum.valueOf(), this._spinner.value.valueOf());
		}

		[Test]
		public function testDateEditingModeAndSetMinimumToDateThenToNull():void
		{
			//this test catches a potential runtime error with the internal year
			//list not having a data descriptor

			this._spinner.editingMode = DateTimeMode.DATE;
			var value:Date = new Date(2016, 2, 24);
			this._spinner.minimum = new Date(1960, 0, 1);
			this._spinner.maximum = new Date(value.fullYear + 5, 0, 1);
			this._spinner.value = value;
			this._spinner.validate();
			this._spinner.minimum = null;
			this._spinner.validate();
		}

		[Test]
		public function testTimeEditingModeAndChangeLocaleWithDifferentMeridiem():void
		{
			//this test catches some runtime errors with the internal meridiem
			//and hours lists not having data descriptors

			this._spinner.editingMode = DateTimeMode.TIME;
			this._spinner.locale = "fr_FR";
			this._spinner.value = new Date(2016, 2, 24, 2);
			this._spinner.validate();
			this._spinner.locale = "en_US";
			this._spinner.validate();
		}

		[Test]
		public function testBackgroundSkinMeasurement():void
		{
			var backgroundSkin:Quad = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT);
			this._spinner.backgroundSkin = backgroundSkin;
			this._spinner.validate();
			Assert.assertStrictlyEquals("DateTimeSpinner: backgroundSkin width not used for measurement.",
				BACKGROUND_WIDTH, this._spinner.width);
			Assert.assertStrictlyEquals("DateTimeSpinner: backgroundSkin height not used for measurement.",
				BACKGROUND_HEIGHT, this._spinner.height);
		}

		[Test]
		public function testPaddingMeasurement():void
		{
			this._spinner.paddingTop = PADDING_TOP;
			this._spinner.paddingRight = PADDING_RIGHT;
			this._spinner.paddingBottom = PADDING_BOTTOM;
			this._spinner.paddingLeft = PADDING_LEFT;
			this._spinner.validate();
			Assert.assertTrue("DateTimeSpinner: padding left/right not used for width measurement.",
				(PADDING_LEFT + PADDING_RIGHT) < this._spinner.width);
			Assert.assertTrue("DateTimeSpinner:  padding top/bottom not used for height measurement.",
				(PADDING_TOP + PADDING_BOTTOM) < this._spinner.height);
		}

		[Test]
		public function testSkinsDisposed():void
		{
			var backgroundSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._spinner.backgroundSkin = backgroundSkin;
			var backgroundDisabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._spinner.backgroundDisabledSkin = backgroundDisabledSkin;
			this._spinner.validate();
			this._spinner.dispose();
			Assert.assertTrue("backgroundSkin not disposed when LayoutGroup disposed.", backgroundSkin.isDisposed);
			Assert.assertTrue("backgroundDisabledSkin not disposed when LayoutGroup disposed.", backgroundDisabledSkin.isDisposed);
		}
	}
}


================================================
FILE: test/source/feathers/tests/DefaultGroupedListHeaderOrFooterRendererMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.GroupedList;
	import feathers.controls.LayoutGroup;
	import feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer;
	import feathers.controls.text.BitmapFontTextRenderer;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class DefaultGroupedListHeaderOrFooterRendererMeasurementTests
	{
		private static const SMALL_BACKGROUND_WIDTH:Number = 10;
		private static const SMALL_BACKGROUND_HEIGHT:Number = 12;
		private static const LARGE_BACKGROUND_WIDTH:Number = 100;
		private static const LARGE_BACKGROUND_HEIGHT:Number = 110;
		private static const COMPLEX_BACKGROUND_WIDTH:Number = 54;
		private static const COMPLEX_BACKGROUND_HEIGHT:Number = 55;
		private static const COMPLEX_BACKGROUND_MIN_WIDTH:Number = 38;
		private static const COMPLEX_BACKGROUND_MIN_HEIGHT:Number = 39;

		private static const SMALL_CONTENT_WIDTH:Number = 13;
		private static const SMALL_CONTENT_HEIGHT:Number = 11;
		private static const LARGE_CONTENT_WIDTH:Number = 105;
		private static const LARGE_CONTENT_HEIGHT:Number = 115;
		private static const COMPLEX_CONTENT_WIDTH:Number = 23;
		private static const COMPLEX_CONTENT_HEIGHT:Number = 25;
		private static const COMPLEX_CONTENT_MIN_WIDTH:Number = 18;
		private static const COMPLEX_CONTENT_MIN_HEIGHT:Number = 19;

		private static const PADDING_TOP:Number = 50;
		private static const PADDING_RIGHT:Number = 54;
		private static const PADDING_BOTTOM:Number = 59;
		private static const PADDING_LEFT:Number = 60;

		private var _headerOrFooterRenderer:DefaultGroupedListHeaderOrFooterRenderer;
		private var _textRenderer:BitmapFontTextRenderer;
		private var _list:GroupedList;

		[Before]
		public function prepare():void
		{
			this._list = new GroupedList();

			this._headerOrFooterRenderer = new DefaultGroupedListHeaderOrFooterRenderer();
			this._headerOrFooterRenderer.owner = this._list;
			this._headerOrFooterRenderer.groupIndex = 0;
			this._headerOrFooterRenderer.data = { label: null };
			this._headerOrFooterRenderer.contentLabelFactory = function():BitmapFontTextRenderer
			{
				return new BitmapFontTextRenderer();
			};
			TestFeathers.starlingRoot.addChild(this._headerOrFooterRenderer);

			this._textRenderer = new BitmapFontTextRenderer();
			TestFeathers.starlingRoot.addChild(this._textRenderer);
		}

		[After]
		public function cleanup():void
		{
			this._headerOrFooterRenderer.removeFromParent(true);
			this._headerOrFooterRenderer = null;

			this._list.dispose();
			this._list = null;

			this._textRenderer.removeFromParent(true);
			this._textRenderer = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}
		
		private function addSmallSimpleBackground():void
		{
			this._headerOrFooterRenderer.backgroundSkin = new Quad(SMALL_BACKGROUND_WIDTH, SMALL_BACKGROUND_HEIGHT, 0xff00ff);
		}

		private function addLargeSimpleBackground():void
		{
			this._headerOrFooterRenderer.backgroundSkin = new Quad(LARGE_BACKGROUND_WIDTH, LARGE_BACKGROUND_HEIGHT, 0xff00ff);
		}

		private function addComplexBackground():void
		{
			var backgroundSkin:LayoutGroup = new LayoutGroup();
			backgroundSkin.width = COMPLEX_BACKGROUND_WIDTH;
			backgroundSkin.height = COMPLEX_BACKGROUND_HEIGHT;
			backgroundSkin.minWidth = COMPLEX_BACKGROUND_MIN_WIDTH;
			backgroundSkin.minHeight = COMPLEX_BACKGROUND_MIN_HEIGHT;
			this._headerOrFooterRenderer.backgroundSkin = backgroundSkin;
		}

		[Test]
		public function testAutoSizeWithPadding():void
		{
			this._headerOrFooterRenderer.paddingTop = PADDING_TOP;
			this._headerOrFooterRenderer.paddingRight = PADDING_RIGHT;
			this._headerOrFooterRenderer.paddingBottom = PADDING_BOTTOM;
			this._headerOrFooterRenderer.paddingLeft = PADDING_LEFT;
			this._headerOrFooterRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the left and right padding.",
				PADDING_LEFT + PADDING_RIGHT, this._headerOrFooterRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the top and bottom padding.",
				PADDING_TOP + PADDING_BOTTOM, this._headerOrFooterRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the left and right padding.",
				PADDING_LEFT + PADDING_RIGHT, this._headerOrFooterRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the top and bottom padding.",
				PADDING_TOP + PADDING_BOTTOM, this._headerOrFooterRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabel():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this._headerOrFooterRenderer.data = { label: labelText };
			this._headerOrFooterRenderer.validate();

			Assert.assertTrue("The width of the DefaultGroupedListHeaderOrFooterRenderer was not greater than 0 when using a label.",
				this._headerOrFooterRenderer.width > 0);
			Assert.assertTrue("The height of the DefaultGroupedListHeaderOrFooterRenderer was not greater than 0 when using a label.",
				this._headerOrFooterRenderer.height > 0);
			Assert.assertTrue("The minWidth of the DefaultGroupedListHeaderOrFooterRenderer was not greater than 0 when using a label.",
				this._headerOrFooterRenderer.minWidth > 0);
			Assert.assertTrue("The minHeight of the DefaultGroupedListHeaderOrFooterRenderer was not greater than 0 when using a label.",
				this._headerOrFooterRenderer.minHeight > 0);
			Assert.assertStrictlyEquals("The width of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the label.",
				this._textRenderer.width, this._headerOrFooterRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the label.",
				this._textRenderer.height, this._headerOrFooterRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the label.",
				this._textRenderer.width, this._headerOrFooterRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the label.",
				this._textRenderer.height, this._headerOrFooterRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabelAndPadding():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this._headerOrFooterRenderer.data = { label: labelText };
			this._headerOrFooterRenderer.paddingTop = PADDING_TOP;
			this._headerOrFooterRenderer.paddingRight = PADDING_RIGHT;
			this._headerOrFooterRenderer.paddingBottom = PADDING_BOTTOM;
			this._headerOrFooterRenderer.paddingLeft = PADDING_LEFT;
			this._headerOrFooterRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the label and left and right padding.",
				this._textRenderer.width + PADDING_LEFT + PADDING_RIGHT, this._headerOrFooterRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the label and top and bottom padding.",
				this._textRenderer.height + PADDING_TOP + PADDING_BOTTOM, this._headerOrFooterRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the label and left and right padding.",
				this._textRenderer.width + PADDING_LEFT + PADDING_RIGHT, this._headerOrFooterRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the label and top and bottom padding.",
				this._textRenderer.height + PADDING_TOP + PADDING_BOTTOM, this._headerOrFooterRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleContent():void
		{
			var content:Quad = new Quad(SMALL_CONTENT_WIDTH, SMALL_CONTENT_HEIGHT, 0xff00ff);
			this._headerOrFooterRenderer.data = { content: content };
			this._headerOrFooterRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content width.",
				SMALL_CONTENT_WIDTH, this._headerOrFooterRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content height.",
				SMALL_CONTENT_HEIGHT, this._headerOrFooterRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content width.",
				SMALL_CONTENT_WIDTH, this._headerOrFooterRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content height.",
				SMALL_CONTENT_HEIGHT, this._headerOrFooterRenderer.minHeight);

			content.dispose();
		}

		[Test]
		public function testAutoSizeWithSimpleContentAndPadding():void
		{
			var content:Quad = new Quad(SMALL_CONTENT_WIDTH, SMALL_CONTENT_HEIGHT, 0xff00ff);
			this._headerOrFooterRenderer.data = { content: content };
			this._headerOrFooterRenderer.paddingTop = PADDING_TOP;
			this._headerOrFooterRenderer.paddingRight = PADDING_RIGHT;
			this._headerOrFooterRenderer.paddingBottom = PADDING_BOTTOM;
			this._headerOrFooterRenderer.paddingLeft = PADDING_LEFT;
			this._headerOrFooterRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content width and left and right padding.",
				SMALL_CONTENT_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._headerOrFooterRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content height and top and bottom padding.",
				SMALL_CONTENT_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._headerOrFooterRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content width and left and right padding.",
				SMALL_CONTENT_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._headerOrFooterRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content height and top and bottom padding.",
				SMALL_CONTENT_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._headerOrFooterRenderer.minHeight);

			content.dispose();
		}

		[Test]
		public function testAutoSizeWithComplexContent():void
		{
			var content:LayoutGroup = new LayoutGroup();
			content.setSize(COMPLEX_CONTENT_WIDTH, COMPLEX_CONTENT_HEIGHT);
			content.minWidth = COMPLEX_CONTENT_MIN_WIDTH;
			content.minHeight = COMPLEX_CONTENT_MIN_HEIGHT;
			this._headerOrFooterRenderer.data = { content: content };
			this._headerOrFooterRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content width.",
				COMPLEX_CONTENT_WIDTH, this._headerOrFooterRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content height.",
				COMPLEX_CONTENT_HEIGHT, this._headerOrFooterRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content width.",
				COMPLEX_CONTENT_MIN_WIDTH, this._headerOrFooterRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content height.",
				COMPLEX_CONTENT_MIN_HEIGHT, this._headerOrFooterRenderer.minHeight);

			content.dispose();
		}

		[Test]
		public function testAutoSizeWithComplexContentAndPadding():void
		{
			var content:LayoutGroup = new LayoutGroup();
			content.setSize(COMPLEX_CONTENT_WIDTH, COMPLEX_CONTENT_HEIGHT);
			content.minWidth = COMPLEX_CONTENT_MIN_WIDTH;
			content.minHeight = COMPLEX_CONTENT_MIN_HEIGHT;
			this._headerOrFooterRenderer.data = { content: content };
			this._headerOrFooterRenderer.paddingTop = PADDING_TOP;
			this._headerOrFooterRenderer.paddingRight = PADDING_RIGHT;
			this._headerOrFooterRenderer.paddingBottom = PADDING_BOTTOM;
			this._headerOrFooterRenderer.paddingLeft = PADDING_LEFT;
			this._headerOrFooterRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content width and left and right padding.",
				COMPLEX_CONTENT_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._headerOrFooterRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content height and top and bottom padding.",
				COMPLEX_CONTENT_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._headerOrFooterRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content width and left and right padding.",
				COMPLEX_CONTENT_MIN_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._headerOrFooterRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content height and top and bottom padding.",
				COMPLEX_CONTENT_MIN_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._headerOrFooterRenderer.minHeight);

			content.dispose();
		}

		[Test]
		public function testAutoSizeWithSimpleBackgroundSkin():void
		{
			this.addSmallSimpleBackground();
			this._headerOrFooterRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the background width.",
				SMALL_BACKGROUND_WIDTH, this._headerOrFooterRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the background height.",
				SMALL_BACKGROUND_HEIGHT, this._headerOrFooterRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the background width.",
				SMALL_BACKGROUND_WIDTH, this._headerOrFooterRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the background height.",
				SMALL_BACKGROUND_HEIGHT, this._headerOrFooterRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithSmallSimpleBackgroundSkinAndLargeSimpleContent():void
		{
			this.addSmallSimpleBackground();
			var content:Quad = new Quad(LARGE_CONTENT_WIDTH, LARGE_CONTENT_HEIGHT, 0xff00ff);
			this._headerOrFooterRenderer.data = { content: content };
			this._headerOrFooterRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content width.",
				LARGE_CONTENT_WIDTH, this._headerOrFooterRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content height.",
				LARGE_CONTENT_HEIGHT, this._headerOrFooterRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content width.",
				LARGE_CONTENT_WIDTH, this._headerOrFooterRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the content height.",
				LARGE_CONTENT_HEIGHT, this._headerOrFooterRenderer.minHeight);

			content.dispose();
		}

		[Test]
		public function testAutoSizeWithLargeSimpleBackgroundSkinAndSmallSimpleContent():void
		{
			this.addLargeSimpleBackground();
			var content:Quad = new Quad(SMALL_CONTENT_WIDTH, SMALL_CONTENT_HEIGHT, 0xff00ff);
			this._headerOrFooterRenderer.data = { content: content };
			this._headerOrFooterRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the background width.",
				LARGE_BACKGROUND_WIDTH, this._headerOrFooterRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the background height.",
				LARGE_BACKGROUND_HEIGHT, this._headerOrFooterRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the background width.",
				LARGE_BACKGROUND_WIDTH, this._headerOrFooterRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the background height.",
				LARGE_BACKGROUND_HEIGHT, this._headerOrFooterRenderer.minHeight);
			
			content.dispose();
		}

		[Test]
		public function testAutoSizeWithComplexBackground():void
		{
			this.addComplexBackground();
			this._headerOrFooterRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the complex background width.",
				COMPLEX_BACKGROUND_WIDTH, this._headerOrFooterRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the complex background height.",
				COMPLEX_BACKGROUND_HEIGHT, this._headerOrFooterRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the complex background minWidth.",
				COMPLEX_BACKGROUND_MIN_WIDTH, this._headerOrFooterRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultGroupedListHeaderOrFooterRenderer was not calculated correctly based on the complex background minHeight.",
				COMPLEX_BACKGROUND_MIN_HEIGHT, this._headerOrFooterRenderer.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/DefaultListItemRendererInternalStateTests.as
================================================
package feathers.tests
{
	import feathers.controls.ButtonState;
	import feathers.controls.ImageLoader;
	import feathers.controls.LayoutGroup;
	import feathers.controls.List;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import starling.textures.Texture;

	public class DefaultListItemRendererInternalStateTests
	{
		private var _itemRenderer:DefaultListItemRendererWithInternalState;
		private var _list:List;

		[Before]
		public function prepare():void
		{
			this._list = new List();
			
			this._itemRenderer = new DefaultListItemRendererWithInternalState();
			this._itemRenderer.owner = this._list;
			this._itemRenderer.index = 0;
			this._itemRenderer.data = {};
			this._itemRenderer.useStateDelayTimer = false;
			TestFeathers.starlingRoot.addChild(this._itemRenderer);
		}

		[After]
		public function cleanup():void
		{
			this._itemRenderer.removeFromParent(true);
			this._itemRenderer = null;
			
			this._list.dispose();
			this._list = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testGetAccessoryForStateWithoutSetAccessoryForState():void
		{
			Assert.assertNull("DefaultListItemRenderer getAccessoryForState(ButtonState.UP) must be null when setAccessoryForState() is not called", this._itemRenderer.getAccessoryForState(ButtonState.UP));
			Assert.assertNull("DefaultListItemRenderer getAccessoryForState(ButtonState.HOVER) must be null when setAccessoryForState() is not called", this._itemRenderer.getAccessoryForState(ButtonState.HOVER));
			Assert.assertNull("DefaultListItemRenderer getAccessoryForState(ButtonState.DOWN) must be null when setAccessoryForState() is not called", this._itemRenderer.getAccessoryForState(ButtonState.DOWN));
			Assert.assertNull("DefaultListItemRenderer getAccessoryForState(ButtonState.DISABLED) must be null when setAccessoryForState() is not called", this._itemRenderer.getAccessoryForState(ButtonState.DISABLED));
		}

		[Test]
		public function testGetAccessoryForState():void
		{
			this._itemRenderer.isQuickHitAreaEnabled = true;
			this._itemRenderer.itemHasAccessory = false;

			var defaultAccessory:Quad = new Quad(200, 200);
			this._itemRenderer.defaultAccessory = defaultAccessory;

			var upAccessory:Quad = new Quad(200, 200);
			this._itemRenderer.setAccessoryForState(ButtonState.UP, upAccessory);

			var hoverAccessory:Quad = new Quad(200, 200);
			this._itemRenderer.setAccessoryForState(ButtonState.HOVER, hoverAccessory);

			var downAccessory:Quad = new Quad(200, 200);
			this._itemRenderer.setAccessoryForState(ButtonState.DOWN, downAccessory);

			var disabledAccessory:Quad = new Quad(200, 200);
			this._itemRenderer.setAccessoryForState(ButtonState.DISABLED, disabledAccessory);

			Assert.assertStrictlyEquals("Item Renderer getAccessoryForState(ButtonState.UP) does not match value passed to setAccessoryForState()", upAccessory, this._itemRenderer.getAccessoryForState(ButtonState.UP));
			Assert.assertStrictlyEquals("Item Renderer getAccessoryForState(ButtonState.HOVER) does not match value passed to setAccessoryForState()", hoverAccessory, this._itemRenderer.getAccessoryForState(ButtonState.HOVER));
			Assert.assertStrictlyEquals("Item Renderer getAccessoryForState(ButtonState.DOWN) does not match value passed to setAccessoryForState()", downAccessory, this._itemRenderer.getAccessoryForState(ButtonState.DOWN));
			Assert.assertStrictlyEquals("Item Renderer getAccessoryForState(ButtonState.DISABLED) does not match value passed to setAccessoryForState()", disabledAccessory, this._itemRenderer.getAccessoryForState(ButtonState.DISABLED));
		}

		[Test]
		public function testDefaultCurrentAccessory():void
		{
			this._itemRenderer.isQuickHitAreaEnabled = true;
			this._itemRenderer.itemHasAccessory = false;

			var defaultAccessory:Quad = new Quad(200, 200);
			this._itemRenderer.defaultAccessory = defaultAccessory;

			this._itemRenderer.validate();
			Assert.assertStrictlyEquals("Item Renderer state is not ButtonState.UP with no touch", ButtonState.UP, this._itemRenderer.currentState);
			Assert.assertStrictlyEquals("Item Renderer accessory is not defaultAccessory when currentState is ButtonState.UP and accessory not provided for this state", defaultAccessory, this._itemRenderer.currentAccessoryInternal);
			
			this._itemRenderer.isEnabled = false;
			this._itemRenderer.validate();
			Assert.assertStrictlyEquals("Item Renderer state is not ButtonState.DISABLED when isEnabled is false", ButtonState.DISABLED, this._itemRenderer.currentState);
			Assert.assertStrictlyEquals("Item Renderer accessory is not defaultAccessory when currentState is ButtonState.DISABLED and accessory not provided for this state", defaultAccessory, this._itemRenderer.currentAccessoryInternal);

			this._itemRenderer.isEnabled = true;

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._itemRenderer.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be item renderer", this._itemRenderer, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._itemRenderer.validate();
			Assert.assertStrictlyEquals("Item Renderer state is not ButtonState.HOVER on TouchPhase.HOVER", ButtonState.HOVER, this._itemRenderer.currentState);
			Assert.assertStrictlyEquals("Item Renderer accessory is not defaultAccessory when currentState is ButtonState.HOVER and accessory not provided for this state", defaultAccessory, this._itemRenderer.currentAccessoryInternal);

			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._itemRenderer.validate();
			Assert.assertStrictlyEquals("Item Renderer state is not ButtonState.DOWN on TouchPhase.BEGAN", ButtonState.DOWN, this._itemRenderer.currentState);
			Assert.assertStrictlyEquals("Item Renderer accessory is not defaultAccessory when currentState is ButtonState.DOWN and accessory not provided for this state", defaultAccessory, this._itemRenderer.currentAccessoryInternal);
		}

		[Test]
		public function testCurrentAccessoryWithSetAccessoryForState():void
		{
			this._itemRenderer.isQuickHitAreaEnabled = true;
			this._itemRenderer.itemHasAccessory = false;
			
			var defaultAccessory:Quad = new Quad(200, 200);
			this._itemRenderer.defaultAccessory = defaultAccessory;

			var upAccessory:Quad = new Quad(200, 200);
			this._itemRenderer.setAccessoryForState(ButtonState.UP, upAccessory);

			var hoverAccessory:Quad = new Quad(200, 200);
			this._itemRenderer.setAccessoryForState(ButtonState.HOVER, hoverAccessory);

			var downAccessory:Quad = new Quad(200, 200);
			this._itemRenderer.setAccessoryForState(ButtonState.DOWN, downAccessory);

			var disabledAccessory:Quad = new Quad(200, 200);
			this._itemRenderer.setAccessoryForState(ButtonState.DISABLED, disabledAccessory);

			this._itemRenderer.validate();
			Assert.assertStrictlyEquals("Item Renderer state is not ButtonState.UP with no touch", ButtonState.UP, this._itemRenderer.currentState);
			Assert.assertStrictlyEquals("Item Renderer accessory does not match accessory set with setAccessoryForState() when currentState is ButtonState.UP", upAccessory, this._itemRenderer.currentAccessoryInternal);

			this._itemRenderer.isEnabled = false;
			this._itemRenderer.validate();
			Assert.assertStrictlyEquals("Item Renderer state is not ButtonState.DISABLED when isEnabled is false", ButtonState.DISABLED, this._itemRenderer.currentState);
			Assert.assertStrictlyEquals("Item Renderer accessory does not match accessory set with setAccessoryForState() when currentState is ButtonState.DISABLED", disabledAccessory, this._itemRenderer.currentAccessoryInternal);

			this._itemRenderer.isEnabled = true;

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._itemRenderer.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be item renderer", this._itemRenderer, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._itemRenderer.validate();
			Assert.assertStrictlyEquals("Item Renderer state is not ButtonState.HOVER on TouchPhase.HOVER",
				ButtonState.HOVER, this._itemRenderer.currentState);
			Assert.assertStrictlyEquals("Item Renderer accessory does not match accessory set with setAccessoryForState() when currentState is ButtonState.HOVER and accessory not provided for this state",
				hoverAccessory, this._itemRenderer.currentAccessoryInternal);

			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._itemRenderer.validate();
			Assert.assertStrictlyEquals("Item Renderer state is not ButtonState.DOWN on TouchPhase.BEGAN", ButtonState.DOWN, this._itemRenderer.currentState);
			Assert.assertStrictlyEquals("Item Renderer accessory does not match accessory set with setAccessoryForState() when currentState is ButtonState.DOWN and accessory not provided for this state", downAccessory, this._itemRenderer.currentAccessoryInternal);
		}

		[Test]
		public function testTapToSelectIsEnabledWhenIsSelectableOnAccessoryTouchIsFalseWithAccessorySourceFunction():void
		{
			var accessory:ImageLoader;
			var texture:Texture;
			this._itemRenderer.itemHasAccessory = true;
			this._itemRenderer.accessoryLoaderFactory = function():ImageLoader
			{
				accessory = new ImageLoader();
				return accessory;
			}
			this._itemRenderer.accessorySourceFunction = function():Texture
			{
				if(texture)
				{
					texture.dispose();
				}
				texture = Texture.fromColor(200, 200, 0xff00ff);
				return texture;
			}
			this._itemRenderer.isSelectableOnAccessoryTouch = false;
			this._itemRenderer.hasLabelTextRenderer = false;
			this._itemRenderer.validate();

			var position:Point = new Point(20, 20);
			var target:DisplayObject = this._itemRenderer.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be item renderer accessory", accessory, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._itemRenderer.validate();
			Assert.assertTrue("Item Renderer TapToSelect is incorrectly disabled when isSelectableOnAccessoryTouch is false on TouchPhase.BEGAN", this._itemRenderer.tapToSelectInternal.isEnabled);

			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._itemRenderer.validate();
			Assert.assertTrue("Item Renderer TapToSelect is incorrectly disabled when isSelectableOnAccessoryTouch is false on TouchPhase.ENDED", this._itemRenderer.tapToSelectInternal.isEnabled);

			texture.dispose();
		}

		[Test]
		public function testTapToSelectIsEnabledWhenIsSelectableOnAccessoryTouchIsTrueWithAccessorySourceFunction():void
		{
			var accessory:ImageLoader;
			var texture:Texture;
			this._itemRenderer.itemHasAccessory = true;
			this._itemRenderer.accessoryLoaderFactory = function():ImageLoader
			{
				accessory = new ImageLoader();
				return accessory;
			}
			this._itemRenderer.accessorySourceFunction = function():Texture
			{
				if(texture)
				{
					texture.dispose();
				}
				texture = Texture.fromColor(200, 200, 0xff00ff);
				return texture;
			}
			this._itemRenderer.isSelectableOnAccessoryTouch = true;
			this._itemRenderer.hasLabelTextRenderer = false;
			this._itemRenderer.validate();

			var position:Point = new Point(20, 20);
			var target:DisplayObject = this._itemRenderer.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be item renderer accessory", accessory, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._itemRenderer.validate();
			Assert.assertTrue("Item Renderer TapToSelect is incorrectly disabled when isSelectableOnAccessoryTouch is true on TouchPhase.BEGAN", this._itemRenderer.tapToSelectInternal.isEnabled);

			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._itemRenderer.validate();
			Assert.assertTrue("Item Renderer TapToSelect is incorrectly disabled when isSelectableOnAccessoryTouch is true on TouchPhase.ENDED", this._itemRenderer.tapToSelectInternal.isEnabled);

			texture.dispose();
		}

		[Test]
		public function testTapToSelectIsEnabledWhenIsSelectableOnAccessoryTouchIsFalseWithDefaultAccessory():void
		{
			this._itemRenderer.itemHasAccessory = false;
			var defaultAccessory:LayoutGroup = new LayoutGroup();
			defaultAccessory.backgroundSkin = new Quad(200, 200);
			this._itemRenderer.defaultAccessory = defaultAccessory;
			this._itemRenderer.isSelectableOnAccessoryTouch = false;
			this._itemRenderer.hasLabelTextRenderer = false;
			this._itemRenderer.validate();

			var position:Point = new Point(20, 20);
			var target:DisplayObject = this._itemRenderer.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be item renderer accessory", defaultAccessory, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._itemRenderer.validate();
			Assert.assertFalse("Item Renderer TapToSelect is incorrectly enabled when isSelectableOnAccessoryTouch is false on TouchPhase.BEGAN", this._itemRenderer.tapToSelectInternal.isEnabled);

			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._itemRenderer.validate();
			Assert.assertTrue("Item Renderer TapToSelect is incorrectly disabled when isSelectableOnAccessoryTouch is false on TouchPhase.ENDED", this._itemRenderer.tapToSelectInternal.isEnabled);
		}

		[Test]
		public function testTapToSelectIsEnabledWhenIsSelectableOnAccessoryTouchIsTrueWithDefaultAccessory():void
		{
			this._itemRenderer.itemHasAccessory = false;
			var defaultAccessory:LayoutGroup = new LayoutGroup();
			defaultAccessory.backgroundSkin = new Quad(200, 200);
			this._itemRenderer.defaultAccessory = defaultAccessory;
			this._itemRenderer.isSelectableOnAccessoryTouch = true;
			this._itemRenderer.hasLabelTextRenderer = false;
			this._itemRenderer.validate();

			var position:Point = new Point(20, 20);
			var target:DisplayObject = this._itemRenderer.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be item renderer accessory", defaultAccessory, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._itemRenderer.validate();
			Assert.assertTrue("Item Renderer TapToSelect is incorrectly disabled when isSelectableOnAccessoryTouch is true on TouchPhase.BEGAN", this._itemRenderer.tapToSelectInternal.isEnabled);

			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._itemRenderer.validate();
			Assert.assertTrue("Item Renderer TapToSelect is incorrectly disabled when isSelectableOnAccessoryTouch is true on TouchPhase.ENDED", this._itemRenderer.tapToSelectInternal.isEnabled);
		}
	}
}

import feathers.controls.renderers.DefaultListItemRenderer;
import feathers.utils.touch.TapToSelect;

import starling.display.DisplayObject;

class DefaultListItemRendererWithInternalState extends DefaultListItemRenderer
{
	public function DefaultListItemRendererWithInternalState()
	{
		super();
	}

	public function get tapToSelectInternal():TapToSelect
	{
		return this.tapToSelect;
	}

	public function get currentAccessoryInternal():DisplayObject
	{
		return this.currentAccessory;
	}
}

================================================
FILE: test/source/feathers/tests/DefaultListItemRendererMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.LayoutGroup;
	import feathers.controls.List;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.text.BitmapFontTextRenderer;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class DefaultListItemRendererMeasurementTests
	{
		private static const SMALL_BACKGROUND_WIDTH:Number = 10;
		private static const SMALL_BACKGROUND_HEIGHT:Number = 12;
		private static const LARGE_BACKGROUND_WIDTH:Number = 100;
		private static const LARGE_BACKGROUND_HEIGHT:Number = 110;
		private static const COMPLEX_BACKGROUND_WIDTH:Number = 54;
		private static const COMPLEX_BACKGROUND_HEIGHT:Number = 55;
		private static const COMPLEX_BACKGROUND_MIN_WIDTH:Number = 38;
		private static const COMPLEX_BACKGROUND_MIN_HEIGHT:Number = 39;

		private static const SMALL_ICON_WIDTH:Number = 13;
		private static const SMALL_ICON_HEIGHT:Number = 11;
		private static const LARGE_ICON_WIDTH:Number = 105;
		private static const LARGE_ICON_HEIGHT:Number = 115;
		private static const COMPLEX_ICON_WIDTH:Number = 23;
		private static const COMPLEX_ICON_HEIGHT:Number = 25;
		private static const COMPLEX_ICON_MIN_WIDTH:Number = 18;
		private static const COMPLEX_ICON_MIN_HEIGHT:Number = 19;

		private static const SMALL_ACCESSORY_WIDTH:Number = 14;
		private static const SMALL_ACCESSORY_HEIGHT:Number = 12;
		private static const LARGE_ACCESSORY_WIDTH:Number = 106;
		private static const LARGE_ACCESSORY_HEIGHT:Number = 116;
		private static const COMPLEX_ACCESSORY_WIDTH:Number = 24;
		private static const COMPLEX_ACCESSORY_HEIGHT:Number = 26;
		private static const COMPLEX_ACCESSORY_MIN_WIDTH:Number = 19;
		private static const COMPLEX_ACCESSORY_MIN_HEIGHT:Number = 20;

		private static const PADDING_TOP:Number = 50;
		private static const PADDING_RIGHT:Number = 54;
		private static const PADDING_BOTTOM:Number = 59;
		private static const PADDING_LEFT:Number = 60;
		private static const GAP:Number = 6;
		
		private var _itemRenderer:DefaultListItemRenderer;
		private var _textRenderer:BitmapFontTextRenderer;
		private var _list:List;

		[Before]
		public function prepare():void
		{
			this._list = new List();

			this._itemRenderer = new DefaultListItemRenderer();
			this._itemRenderer.owner = this._list;
			this._itemRenderer.index = 0;
			this._itemRenderer.data = {};
			this._itemRenderer.useStateDelayTimer = false;
			this._itemRenderer.labelFactory = function():BitmapFontTextRenderer
			{
				return new BitmapFontTextRenderer();
			};
			TestFeathers.starlingRoot.addChild(this._itemRenderer);

			this._textRenderer = new BitmapFontTextRenderer();
			TestFeathers.starlingRoot.addChild(this._textRenderer);
		}

		[After]
		public function cleanup():void
		{
			this._itemRenderer.removeFromParent(true);
			this._itemRenderer = null;

			this._list.dispose();
			this._list = null;

			this._textRenderer.removeFromParent(true);
			this._textRenderer = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function addSmallSimpleAccessory():void
		{
			this._itemRenderer.itemHasAccessory = false;
			this._itemRenderer.defaultAccessory = new Quad(SMALL_ACCESSORY_WIDTH, SMALL_ACCESSORY_HEIGHT, 0xff00ff);
		}

		private function addLargeSimpleAccessory():void
		{
			this._itemRenderer.itemHasAccessory = false;
			this._itemRenderer.defaultAccessory = new Quad(LARGE_ACCESSORY_WIDTH, LARGE_ACCESSORY_HEIGHT, 0xff00ff);
		}

		private function addComplexAccessory():void
		{
			this._itemRenderer.itemHasAccessory = false;
			var icon:LayoutGroup = new LayoutGroup();
			icon.width = COMPLEX_ACCESSORY_WIDTH;
			icon.height = COMPLEX_ACCESSORY_HEIGHT;
			icon.minWidth = COMPLEX_ACCESSORY_MIN_WIDTH;
			icon.minHeight = COMPLEX_ACCESSORY_MIN_HEIGHT;
			this._itemRenderer.defaultAccessory = icon;
		}

		private function addComplexAutoSizingAccessory():void
		{
			this._itemRenderer.itemHasAccessory = false;
			var icon:LayoutGroup = new LayoutGroup();
			icon.backgroundSkin = new Quad(COMPLEX_ACCESSORY_WIDTH, COMPLEX_ACCESSORY_HEIGHT);
			this._itemRenderer.defaultAccessory = icon;
		}

		private function addSmallSimpleIcon():void
		{
			this._itemRenderer.itemHasIcon = false;
			this._itemRenderer.defaultIcon = new Quad(SMALL_ICON_WIDTH, SMALL_ICON_HEIGHT, 0xff00ff);
		}

		private function addLargeSimpleIcon():void
		{
			this._itemRenderer.itemHasIcon = false;
			this._itemRenderer.defaultIcon = new Quad(LARGE_ICON_WIDTH, LARGE_ICON_HEIGHT, 0xff00ff);
		}

		private function addComplexIcon():void
		{
			this._itemRenderer.itemHasIcon = false;
			var icon:LayoutGroup = new LayoutGroup();
			icon.width = COMPLEX_ICON_WIDTH;
			icon.height = COMPLEX_ICON_HEIGHT;
			icon.minWidth = COMPLEX_ICON_MIN_WIDTH;
			icon.minHeight = COMPLEX_ICON_MIN_HEIGHT;
			this._itemRenderer.defaultIcon = icon;
		}

		private function addComplexAutoSizingIcon():void
		{
			this._itemRenderer.itemHasIcon = false;
			var icon:LayoutGroup = new LayoutGroup();
			icon.backgroundSkin = new Quad(COMPLEX_ICON_WIDTH, COMPLEX_ICON_HEIGHT);
			this._itemRenderer.defaultIcon = icon;
		}

		private function addSmallSimpleBackground():void
		{
			this._itemRenderer.itemHasSkin = false;
			this._itemRenderer.defaultSkin = new Quad(SMALL_BACKGROUND_WIDTH, SMALL_BACKGROUND_HEIGHT, 0xff00ff);
		}

		private function addLargeSimpleBackground():void
		{
			this._itemRenderer.itemHasSkin = false;
			this._itemRenderer.defaultSkin = new Quad(LARGE_BACKGROUND_WIDTH, LARGE_BACKGROUND_HEIGHT, 0xff00ff);
		}

		private function addComplexBackground():void
		{
			this._itemRenderer.itemHasSkin = false;
			var backgroundSkin:LayoutGroup = new LayoutGroup();
			backgroundSkin.width = COMPLEX_BACKGROUND_WIDTH;
			backgroundSkin.height = COMPLEX_BACKGROUND_HEIGHT;
			backgroundSkin.minWidth = COMPLEX_BACKGROUND_MIN_WIDTH;
			backgroundSkin.minHeight = COMPLEX_BACKGROUND_MIN_HEIGHT;
			this._itemRenderer.defaultSkin = backgroundSkin;
		}

		[Test]
		public function testAutoSizeWithPadding():void
		{
			this._itemRenderer.hasLabelTextRenderer = false;
			this._itemRenderer.paddingTop = PADDING_TOP;
			this._itemRenderer.paddingRight = PADDING_RIGHT;
			this._itemRenderer.paddingBottom = PADDING_BOTTOM;
			this._itemRenderer.paddingLeft = PADDING_LEFT;
			this._itemRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the left and right padding.",
				PADDING_LEFT + PADDING_RIGHT, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the top and bottom padding.",
				PADDING_TOP + PADDING_BOTTOM, this._itemRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the left and right padding.",
				PADDING_LEFT + PADDING_RIGHT, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the top and bottom padding.",
				PADDING_TOP + PADDING_BOTTOM, this._itemRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabel():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this._itemRenderer.data = { label: labelText };
			this._itemRenderer.validate();

			Assert.assertTrue("The width of the DefaultListItemRenderer was not greater than 0 when using a label.",
				this._itemRenderer.width > 0);
			Assert.assertTrue("The height of the DefaultListItemRenderer was not greater than 0 when using a label.",
				this._itemRenderer.height > 0);
			Assert.assertTrue("The minWidth of the DefaultListItemRenderer was not greater than 0 when using a label.",
				this._itemRenderer.minWidth > 0);
			Assert.assertTrue("The minHeight of the DefaultListItemRenderer was not greater than 0 when using a label.",
				this._itemRenderer.minHeight > 0);
			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the label.",
				this._textRenderer.width, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the label.",
				this._textRenderer.height, this._itemRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the label.",
				this._textRenderer.width, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the label.",
				this._textRenderer.height, this._itemRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabelAndPadding():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this._itemRenderer.data = { label: labelText };
			this._itemRenderer.paddingTop = PADDING_TOP;
			this._itemRenderer.paddingRight = PADDING_RIGHT;
			this._itemRenderer.paddingBottom = PADDING_BOTTOM;
			this._itemRenderer.paddingLeft = PADDING_LEFT;
			this._itemRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the label and left and right padding.",
				this._textRenderer.width + PADDING_LEFT + PADDING_RIGHT, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the label and top and bottom padding.",
				this._textRenderer.height + PADDING_TOP + PADDING_BOTTOM, this._itemRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the label and left and right padding.",
				this._textRenderer.width + PADDING_LEFT + PADDING_RIGHT, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the label and top and bottom padding.",
				this._textRenderer.height + PADDING_TOP + PADDING_BOTTOM, this._itemRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabelAndSimpleIcon():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this.addLargeSimpleIcon();
			this._itemRenderer.data = { label: labelText };
			this._itemRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the label and icon.",
				this._textRenderer.width + LARGE_ICON_WIDTH, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the label and icon.",
				LARGE_ICON_HEIGHT, this._itemRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the label and icon.",
				this._textRenderer.width + LARGE_ICON_WIDTH, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the label and icon.",
				LARGE_ICON_HEIGHT, this._itemRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabelGapAndSimpleIcon():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this.addLargeSimpleIcon();
			this._itemRenderer.data = { label: labelText };
			this._itemRenderer.gap = GAP;
			this._itemRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the label, gap, and icon.",
				this._textRenderer.width + GAP + LARGE_ICON_WIDTH, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the label, gap, and icon.",
				LARGE_ICON_HEIGHT, this._itemRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the label, gap, and icon.",
				this._textRenderer.width + GAP + LARGE_ICON_WIDTH, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the label, and icon.",
				LARGE_ICON_HEIGHT, this._itemRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabelGapPaddingAndSimpleIcon():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this.addLargeSimpleIcon();
			this._itemRenderer.data = { label: labelText };
			this._itemRenderer.paddingTop = PADDING_TOP;
			this._itemRenderer.paddingRight = PADDING_RIGHT;
			this._itemRenderer.paddingBottom = PADDING_BOTTOM;
			this._itemRenderer.paddingLeft = PADDING_LEFT;
			this._itemRenderer.gap = GAP;
			this._itemRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the label, gap, left and right padding, and icon.",
				this._textRenderer.width + GAP + LARGE_ICON_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the label, gap, top and bottom padding, and icon.",
				LARGE_ICON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._itemRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the label, gap, left and right padding, and icon.",
				this._textRenderer.width + GAP + LARGE_ICON_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the label, gap, top and bottom padding, and icon.",
				LARGE_ICON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._itemRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleIcon():void
		{
			this.addLargeSimpleIcon();
			this._itemRenderer.hasLabelTextRenderer = false;
			this._itemRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this._itemRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this._itemRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexIcon():void
		{
			this.addComplexIcon();
			this._itemRenderer.hasLabelTextRenderer = false;
			this._itemRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the complex icon width.",
				COMPLEX_ICON_WIDTH, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the complex icon height.",
				COMPLEX_ICON_HEIGHT, this._itemRenderer.height);

			//the item renderer never resizes the icon, so we ignore its minimum
			//dimensions
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the complex icon minWidth.",
				COMPLEX_ICON_WIDTH, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the complex icon minHeight.",
				COMPLEX_ICON_HEIGHT, this._itemRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexAutoSizingIcon():void
		{
			this.addComplexAutoSizingIcon();
			this._itemRenderer.hasLabelTextRenderer = false;
			this._itemRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the complex icon width.",
				COMPLEX_ICON_WIDTH, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the complex icon height.",
				COMPLEX_ICON_HEIGHT, this._itemRenderer.height);
			
			//the item renderer never resizes the icon, so we ignore its
			//minimum dimensions
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the complex icon minWidth.",
				COMPLEX_ICON_WIDTH, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the complex icon minHeight.",
				COMPLEX_ICON_HEIGHT, this._itemRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleAccessory():void
		{
			this.addLargeSimpleAccessory();
			this._itemRenderer.hasLabelTextRenderer = false;
			this._itemRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the accessory width.",
				LARGE_ACCESSORY_WIDTH, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the accessory height.",
				LARGE_ACCESSORY_HEIGHT, this._itemRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the accessory width.",
				LARGE_ACCESSORY_WIDTH, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the accessory height.",
				LARGE_ACCESSORY_HEIGHT, this._itemRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexAccessory():void
		{
			this.addComplexAccessory();
			this._itemRenderer.hasLabelTextRenderer = false;
			this._itemRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the complex accessory width.",
				COMPLEX_ACCESSORY_WIDTH, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the complex accessory height.",
				COMPLEX_ACCESSORY_HEIGHT, this._itemRenderer.height);
			
			//the item renderer never resizes the accessory, so we ignore its
			//minimum dimensions
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the complex accessory minWidth.",
				COMPLEX_ACCESSORY_WIDTH, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the complex accessory minHeight.",
				COMPLEX_ACCESSORY_HEIGHT, this._itemRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexAutoSizingAccessory():void
		{
			this.addComplexAutoSizingAccessory();
			this._itemRenderer.hasLabelTextRenderer = false;
			this._itemRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the complex accessory width.",
				COMPLEX_ACCESSORY_WIDTH, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the complex accessory height.",
				COMPLEX_ACCESSORY_HEIGHT, this._itemRenderer.height);
			
			//the item renderer never resizes the accessory, so we ignore its
			//minimum dimensions
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the complex accessory minWidth.",
				COMPLEX_ACCESSORY_WIDTH, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the complex accessory minHeight.",
				COMPLEX_ACCESSORY_HEIGHT, this._itemRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleBackgroundSkin():void
		{
			this.addSmallSimpleBackground();
			this._itemRenderer.hasLabelTextRenderer = false;
			this._itemRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the background width.",
				SMALL_BACKGROUND_WIDTH, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the background height.",
				SMALL_BACKGROUND_HEIGHT, this._itemRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the background width.",
				SMALL_BACKGROUND_WIDTH, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the background height.",
				SMALL_BACKGROUND_HEIGHT, this._itemRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithSmallSimpleBackgroundSkinAndLargeSimpleIcon():void
		{
			this.addSmallSimpleBackground();
			this.addLargeSimpleIcon();
			this._itemRenderer.hasLabelTextRenderer = false;
			this._itemRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this._itemRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this._itemRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithLargeSimpleBackgroundSkinAndSmallSimpleIcon():void
		{
			this.addLargeSimpleBackground();
			this.addSmallSimpleIcon();
			this._itemRenderer.hasLabelTextRenderer = false;
			this._itemRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the background width.",
				LARGE_BACKGROUND_WIDTH, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the background height.",
				LARGE_BACKGROUND_HEIGHT, this._itemRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the background width.",
				LARGE_BACKGROUND_WIDTH, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the background height.",
				LARGE_BACKGROUND_HEIGHT, this._itemRenderer.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexBackground():void
		{
			this.addComplexBackground();
			this._itemRenderer.hasLabelTextRenderer = false;
			this._itemRenderer.validate();

			Assert.assertStrictlyEquals("The width of the DefaultListItemRenderer was not calculated correctly based on the complex background width.",
				COMPLEX_BACKGROUND_WIDTH, this._itemRenderer.width);
			Assert.assertStrictlyEquals("The height of the DefaultListItemRenderer was not calculated correctly based on the complex background height.",
				COMPLEX_BACKGROUND_HEIGHT, this._itemRenderer.height);
			Assert.assertStrictlyEquals("The minWidth of the DefaultListItemRenderer was not calculated correctly based on the complex background minWidth.",
				COMPLEX_BACKGROUND_MIN_WIDTH, this._itemRenderer.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the DefaultListItemRenderer was not calculated correctly based on the complex background minHeight.",
				COMPLEX_BACKGROUND_MIN_HEIGHT, this._itemRenderer.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/DrawersMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.AutoSizeMode;
	import feathers.controls.Drawers;
	import feathers.controls.LayoutGroup;
	import feathers.layout.Orientation;

	import org.flexunit.Assert;

	public class DrawersMeasurementTests
	{
		private static const CONTENT_WIDTH:Number = 300;
		private static const CONTENT_HEIGHT:Number = 250;
		private static const CONTENT_MIN_WIDTH:Number = 125;
		private static const CONTENT_MIN_HEIGHT:Number = 75;
		
		private static const LEFT_DRAWER_WIDTH:Number = 30;
		private static const LEFT_DRAWER_HEIGHT:Number = 325;
		private static const LEFT_DRAWER_MIN_WIDTH:Number = 12;
		private static const LEFT_DRAWER_MIN_HEIGHT:Number = 100;

		private static const RIGHT_DRAWER_WIDTH:Number = 11;
		private static const RIGHT_DRAWER_HEIGHT:Number = 316;
		private static const RIGHT_DRAWER_MIN_WIDTH:Number = 15;
		private static const RIGHT_DRAWER_MIN_HEIGHT:Number = 110;

		private static const TOP_DRAWER_WIDTH:Number = 350;
		private static const TOP_DRAWER_HEIGHT:Number = 23;
		private static const TOP_DRAWER_MIN_WIDTH:Number = 315;
		private static const TOP_DRAWER_MIN_HEIGHT:Number = 21;

		private static const BOTTOM_DRAWER_WIDTH:Number = 330;
		private static const BOTTOM_DRAWER_HEIGHT:Number = 37;
		private static const BOTTOM_DRAWER_MIN_WIDTH:Number = 325;
		private static const BOTTOM_DRAWER_MIN_HEIGHT:Number = 31;

		private var _drawers:Drawers;

		[Before]
		public function prepare():void
		{
			this._drawers = new Drawers();
			TestFeathers.starlingRoot.addChild(this._drawers);
		}

		[After]
		public function cleanup():void
		{
			this._drawers.removeFromParent(true);
			this._drawers = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function addContent():void
		{
			var content:LayoutGroup = new LayoutGroup();
			content.width = CONTENT_WIDTH;
			content.height = CONTENT_HEIGHT;
			content.minWidth = CONTENT_MIN_WIDTH;
			content.minHeight = CONTENT_MIN_HEIGHT;
			this._drawers.content = content;
		}

		private function addLeftDrawer():void
		{
			var leftDrawer:LayoutGroup = new LayoutGroup();
			leftDrawer.width = LEFT_DRAWER_WIDTH;
			leftDrawer.height = LEFT_DRAWER_HEIGHT;
			leftDrawer.minWidth = LEFT_DRAWER_MIN_WIDTH;
			leftDrawer.minHeight = LEFT_DRAWER_MIN_HEIGHT;
			this._drawers.leftDrawer = leftDrawer;
		}

		private function addRightDrawer():void
		{
			var rightDrawer:LayoutGroup = new LayoutGroup();
			rightDrawer.width = RIGHT_DRAWER_WIDTH;
			rightDrawer.height = RIGHT_DRAWER_HEIGHT;
			rightDrawer.minWidth = RIGHT_DRAWER_MIN_WIDTH;
			rightDrawer.minHeight = RIGHT_DRAWER_MIN_HEIGHT;
			this._drawers.rightDrawer = rightDrawer;
		}

		private function addTopDrawer():void
		{
			var topDrawer:LayoutGroup = new LayoutGroup();
			topDrawer.width = TOP_DRAWER_WIDTH;
			topDrawer.height = TOP_DRAWER_HEIGHT;
			topDrawer.minWidth = TOP_DRAWER_MIN_WIDTH;
			topDrawer.minHeight = TOP_DRAWER_MIN_HEIGHT;
			this._drawers.topDrawer = topDrawer;
		}

		private function addBottomDrawer():void
		{
			var bottomDrawer:LayoutGroup = new LayoutGroup();
			bottomDrawer.width = BOTTOM_DRAWER_WIDTH;
			bottomDrawer.height = BOTTOM_DRAWER_HEIGHT;
			bottomDrawer.minWidth = BOTTOM_DRAWER_MIN_WIDTH;
			bottomDrawer.minHeight = BOTTOM_DRAWER_MIN_HEIGHT;
			this._drawers.bottomDrawer = bottomDrawer;
		}

		[Test]
		public function testAutoSizeStage():void
		{
			this.addContent();
			this._drawers.autoSizeMode = AutoSizeMode.STAGE;
			this._drawers.validate();

			Assert.assertStrictlyEquals("The width of the Drawers was not calculated correctly based on the stage width.",
				this._drawers.stage.stageWidth, this._drawers.width);
			Assert.assertStrictlyEquals("The height of the Drawers was not calculated correctly based on the stage height.",
				this._drawers.stage.stageHeight, this._drawers.height);
			Assert.assertStrictlyEquals("The minWidth of the Drawers was not calculated correctly based on the stage width.",
				this._drawers.stage.stageWidth, this._drawers.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Drawers was not calculated correctly based on the stage height.",
				this._drawers.stage.stageHeight, this._drawers.minHeight);
		}

		[Test]
		public function testAutoSizeContentWithoutContent():void
		{
			this._drawers.autoSizeMode = AutoSizeMode.CONTENT;
			this._drawers.validate();

			Assert.assertStrictlyEquals("The width of the Drawers was not calculated correctly based on empty content.",
				0, this._drawers.width);
			Assert.assertStrictlyEquals("The height of the Drawers was not calculated correctly based on empty content.",
				0, this._drawers.height);
			Assert.assertStrictlyEquals("The minWidth of the Drawers was not calculated correctly based on empty content.",
				0, this._drawers.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Drawers was not calculated correctly based on empty content.",
				0, this._drawers.minHeight);
		}

		[Test]
		public function testAutoSizeContent():void
		{
			this.addContent();
			this._drawers.autoSizeMode = AutoSizeMode.CONTENT;
			this._drawers.validate();

			Assert.assertStrictlyEquals("The width of the Drawers was not calculated correctly based on the content width.",
				CONTENT_WIDTH, this._drawers.width);
			Assert.assertStrictlyEquals("The height of the Drawers was not calculated correctly based on the content height.",
				CONTENT_HEIGHT, this._drawers.height);
			Assert.assertStrictlyEquals("The minWidth of the Drawers was not calculated correctly based on the content minWidth.",
				CONTENT_MIN_WIDTH, this._drawers.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Drawers was not calculated correctly based on the content minHeight.",
				CONTENT_MIN_HEIGHT, this._drawers.minHeight);
		}

		[Test]
		public function testAutoSizeContentWithDrawersThatAreNotDocked():void
		{
			this.addContent();
			this.addTopDrawer();
			this.addRightDrawer();
			this.addBottomDrawer();
			this.addLeftDrawer();
			this._drawers.topDrawerDockMode = Orientation.NONE;
			this._drawers.rightDrawerDockMode = Orientation.NONE;
			this._drawers.bottomDrawerDockMode = Orientation.NONE;
			this._drawers.leftDrawerDockMode = Orientation.NONE;
			this._drawers.autoSizeMode = AutoSizeMode.CONTENT;
			this._drawers.validate();

			Assert.assertStrictlyEquals("The width of the Drawers was not calculated correctly based on the content width.",
				CONTENT_WIDTH, this._drawers.width);
			Assert.assertStrictlyEquals("The height of the Drawers was not calculated correctly based on the content height.",
				CONTENT_HEIGHT, this._drawers.height);
			Assert.assertStrictlyEquals("The minWidth of the Drawers was not calculated correctly based on the content width.",
				CONTENT_MIN_WIDTH, this._drawers.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Drawers was not calculated correctly based on the content height.",
				CONTENT_MIN_HEIGHT, this._drawers.minHeight);
		}

		[Test]
		public function testAutoSizeContentWithDockedLeftDrawer():void
		{
			this.addContent();
			this.addLeftDrawer();
			this._drawers.leftDrawerDockMode = Orientation.BOTH;
			this._drawers.autoSizeMode = AutoSizeMode.CONTENT;
			this._drawers.validate();

			Assert.assertStrictlyEquals("The width of the Drawers was not calculated correctly based on the content width plus docked left drawer width.",
				CONTENT_WIDTH + LEFT_DRAWER_WIDTH, this._drawers.width);
			Assert.assertStrictlyEquals("The height of the Drawers was not calculated correctly based on the maximum of content height and docked left drawer height.",
				LEFT_DRAWER_HEIGHT, this._drawers.height);
			Assert.assertStrictlyEquals("The minWidth of the Drawers was not calculated correctly based on the content minWidth plus docked left drawer minWidth.",
				CONTENT_MIN_WIDTH + LEFT_DRAWER_MIN_WIDTH, this._drawers.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Drawers was not calculated correctly based on the maximum of content minHeight and docked left drawer minHeight.",
				LEFT_DRAWER_MIN_HEIGHT, this._drawers.minHeight);
		}

		[Test]
		public function testAutoSizeContentWithDockedRightDrawer():void
		{
			this.addContent();
			this.addRightDrawer();
			this._drawers.rightDrawerDockMode = Orientation.BOTH;
			this._drawers.autoSizeMode = AutoSizeMode.CONTENT;
			this._drawers.validate();

			Assert.assertStrictlyEquals("The width of the Drawers was not calculated correctly based on the content width plus docked right drawer width.",
				CONTENT_WIDTH + RIGHT_DRAWER_WIDTH, this._drawers.width);
			Assert.assertStrictlyEquals("The height of the Drawers was not calculated correctly based on the maximum of content height and docked right drawer height.",
				RIGHT_DRAWER_HEIGHT, this._drawers.height);
			Assert.assertStrictlyEquals("The minWidth of the Drawers was not calculated correctly based on the content minWidth plus docked right drawer minWidth.",
				CONTENT_MIN_WIDTH + RIGHT_DRAWER_MIN_WIDTH, this._drawers.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Drawers was not calculated correctly based on the maximum of content minHeight and docked right drawer minHeight.",
				RIGHT_DRAWER_MIN_HEIGHT, this._drawers.minHeight);
		}

		[Test]
		public function testAutoSizeContentWithDockedTopDrawer():void
		{
			this.addContent();
			this.addTopDrawer();
			this._drawers.topDrawerDockMode = Orientation.BOTH;
			this._drawers.autoSizeMode = AutoSizeMode.CONTENT;
			this._drawers.validate();

			Assert.assertStrictlyEquals("The width of the Drawers was not calculated correctly based on the maximum of content width and docked top drawer width.",
				TOP_DRAWER_WIDTH, this._drawers.width);
			Assert.assertStrictlyEquals("The height of the Drawers was not calculated correctly based on the content height plus docked top drawer height.",
				CONTENT_HEIGHT + TOP_DRAWER_HEIGHT, this._drawers.height);
			Assert.assertStrictlyEquals("The minWidth of the Drawers was not calculated correctly based on the maximum of content minWidth and docked top drawer minWidth.",
				TOP_DRAWER_MIN_WIDTH, this._drawers.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Drawers was not calculated correctly based on the content minHeight plus docked top drawer minHeight.",
				CONTENT_MIN_HEIGHT + TOP_DRAWER_MIN_HEIGHT, this._drawers.minHeight);
		}

		[Test]
		public function testAutoSizeContentWithDockedBottomDrawer():void
		{
			this.addContent();
			this.addBottomDrawer();
			this._drawers.bottomDrawerDockMode = Orientation.BOTH;
			this._drawers.autoSizeMode = AutoSizeMode.CONTENT;
			this._drawers.validate();

			Assert.assertStrictlyEquals("The width of the Drawers was not calculated correctly based on the maximum of content width and docked bottom drawer width.",
				BOTTOM_DRAWER_WIDTH, this._drawers.width);
			Assert.assertStrictlyEquals("The height of the Drawers was not calculated correctly based on the content height plus docked bottom drawer height.",
				CONTENT_HEIGHT + BOTTOM_DRAWER_HEIGHT, this._drawers.height);
			Assert.assertStrictlyEquals("The minWidth of the Drawers was not calculated correctly based on the maximum of content minWidth and docked bottom drawer minWidth.",
				BOTTOM_DRAWER_MIN_WIDTH, this._drawers.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Drawers was not calculated correctly based on the content minHeight plus docked bottom drawer minHeight.",
				CONTENT_MIN_HEIGHT + BOTTOM_DRAWER_MIN_HEIGHT, this._drawers.minHeight);
		}

		[Test]
		public function testAutoSizeContentWithDockedTopAndBottomDrawer():void
		{
			this.addContent();
			this.addTopDrawer();
			this.addBottomDrawer();
			this._drawers.topDrawerDockMode = Orientation.BOTH;
			this._drawers.bottomDrawerDockMode = Orientation.BOTH;
			this._drawers.autoSizeMode = AutoSizeMode.CONTENT;
			this._drawers.validate();

			Assert.assertStrictlyEquals("The width of the Drawers was not calculated correctly based on the maximum of content width, docked top drawer width, and docked bottom drawer width.",
				TOP_DRAWER_WIDTH, this._drawers.width);
			Assert.assertStrictlyEquals("The height of the Drawers was not calculated correctly based on the content height plus docked top drawer height plus docked bottom drawer height.",
				CONTENT_HEIGHT + TOP_DRAWER_HEIGHT + BOTTOM_DRAWER_HEIGHT, this._drawers.height);
			Assert.assertStrictlyEquals("The minWidth of the Drawers was not calculated correctly based on the maximum of content minWidth, docked top drawer minWidth, and docked bottom drawer minWidth.",
				BOTTOM_DRAWER_MIN_WIDTH, this._drawers.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Drawers was not calculated correctly based on the content minHeight plus docked top drawer height plus docked bottom drawer minHeight.",
				CONTENT_MIN_HEIGHT + TOP_DRAWER_MIN_HEIGHT +BOTTOM_DRAWER_MIN_HEIGHT, this._drawers.minHeight);
		}

		[Test]
		public function testAutoSizeContentWithDockedLeftAndRightDrawer():void
		{
			this.addContent();
			this.addRightDrawer();
			this.addLeftDrawer();
			this._drawers.rightDrawerDockMode = Orientation.BOTH;
			this._drawers.leftDrawerDockMode = Orientation.BOTH;
			this._drawers.autoSizeMode = AutoSizeMode.CONTENT;
			this._drawers.validate();

			Assert.assertStrictlyEquals("The width of the Drawers was not calculated correctly based on the content width, plus docked left drawer width, plus docked right drawer width.",
				CONTENT_WIDTH + LEFT_DRAWER_WIDTH + RIGHT_DRAWER_WIDTH, this._drawers.width);
			Assert.assertStrictlyEquals("The height of the Drawers was not calculated correctly based on the maximum of content height, docked left drawer height, and docked right drawer height.",
				LEFT_DRAWER_HEIGHT, this._drawers.height);
			Assert.assertStrictlyEquals("The minWidth of the Drawers was not calculated correctly based on the content minWidth, plus docked left drawer minWidth, plus docked right drawer minWidth.",
				CONTENT_MIN_WIDTH + LEFT_DRAWER_MIN_WIDTH + RIGHT_DRAWER_MIN_WIDTH, this._drawers.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Drawers was not calculated correctly based on the maximum of content minHeight, docked left drawer height, and docked right drawer minHeight.",
				RIGHT_DRAWER_MIN_HEIGHT, this._drawers.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/DrawersTests.as
================================================
package feathers.tests
{
	import feathers.controls.Drawers;
	import feathers.controls.LayoutGroup;

	import org.flexunit.Assert;
	import org.flexunit.async.Async;

	import starling.display.Quad;
	import starling.events.Event;

	public class DrawersTests
	{
		private static const OVERLAY_ALPHA:Number = 0.45;
		
		private var _drawers:Drawers;
		private var _overlay:Quad;
		private var _content:LayoutGroup;
		private var _drawer1:LayoutGroup;
		private var _drawer2:LayoutGroup;

		[Before]
		public function prepare():void
		{
			this._content = new LayoutGroup();
			this._content.backgroundSkin = new Quad(200, 150, 0xff00ff);
			
			this._overlay = new Quad(1, 1, 0x000000);
			this._overlay.alpha = OVERLAY_ALPHA;
			
			this._drawer1 = new LayoutGroup();
			this._drawer1.backgroundSkin = new Quad(125, 100, 0xff0000);

			this._drawer2 = new LayoutGroup();
			this._drawer2.backgroundSkin = new Quad(90, 130, 0x00ff00);
			
			this._drawers = new Drawers(this._content);
			this._drawers.overlaySkin = this._overlay;
			TestFeathers.starlingRoot.addChild(this._drawers);
			this._drawers.validate();
		}

		[After]
		public function cleanup():void
		{
			this._drawers.removeFromParent(true);
			this._drawers = null;
			
			this._overlay = null;
			this._content = null;
			this._drawer1 = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testTopDrawerOpen():void
		{
			this._drawers.topDrawer = this._drawer1;
			this._drawers.isTopDrawerOpen = true;
			this._drawers.validate();

			Assert.assertNotNull("Drawers topDrawer.parent is incorrectly null when isTopDrawerOpen set to true", this._drawer1.parent);
			Assert.assertTrue("Drawers topDrawer.visible is incorrectly false when isTopDrawerOpen set to true", this._drawer1.visible);
			Assert.assertNotNull("Drawers overlaySkin.parent is incorrectly null when isTopDrawerOpen set to true", this._overlay.parent);
			Assert.assertTrue("Drawers overlaySkin.visible is incorrectly false when isTopDrawerOpen set to true", this._overlay.visible);
			Assert.assertStrictlyEquals("Drawers overlaySkin.alpha has incorrect value when isTopDrawerOpen set to true",
				OVERLAY_ALPHA, this._overlay.alpha);
		}

		[Test]
		public function testRightDrawerOpenShowsOverlay():void
		{
			this._drawers.rightDrawer = this._drawer1;
			this._drawers.isRightDrawerOpen = true;
			this._drawers.validate();

			Assert.assertNotNull("Drawers rightDrawer.parent is incorrectly null when isRightDrawerOpen set to true", this._drawer1.parent);
			Assert.assertTrue("Drawers rightDrawer.visible is incorrectly false when isRightDrawerOpen set to true", this._drawer1.visible);
			Assert.assertNotNull("Drawers overlaySkin.parent is incorrectly null when isRightDrawerOpen set to true", this._overlay.parent);
			Assert.assertTrue("Drawers overlaySkin.visible is incorrectly false when isRightDrawerOpen set to true", this._overlay.visible);
			Assert.assertStrictlyEquals("Drawers overlaySkin.alpha has incorrect value when isRightDrawerOpen set to true",
				OVERLAY_ALPHA, this._overlay.alpha);
		}

		[Test]
		public function testBottomDrawerOpen():void
		{
			this._drawers.bottomDrawer = this._drawer1;
			this._drawers.isBottomDrawerOpen = true;
			this._drawers.validate();

			Assert.assertNotNull("Drawers bottomDrawer.parent is incorrectly null when isBottomDrawerOpen set to true", this._drawer1.parent);
			Assert.assertTrue("Drawers bottomDrawer.visible is incorrectly false when isBottomDrawerOpen set to true", this._drawer1.visible);
			Assert.assertNotNull("Drawers overlaySkin.parent is incorrectly null when isBottomDrawerOpen set to true", this._overlay.parent);
			Assert.assertTrue("Drawers overlaySkin.visible is incorrectly false when isBottomDrawerOpen set to true", this._overlay.visible);
			Assert.assertStrictlyEquals("Drawers overlaySkin.alpha has incorrect value when isBottomDrawerOpen set to true",
				OVERLAY_ALPHA, this._overlay.alpha);
		}

		[Test]
		public function testLeftDrawerOpen():void
		{
			this._drawers.leftDrawer = this._drawer1;
			this._drawers.isLeftDrawerOpen = true;
			this._drawers.validate();

			Assert.assertNotNull("Drawers leftDrawer.parent is incorrectly null when isLeftDrawerOpen set to true", this._drawer1.parent);
			Assert.assertTrue("Drawers leftDrawer.visible is incorrectly false when isLeftDrawerOpen set to true", this._drawer1.visible);
			Assert.assertNotNull("Drawers overlaySkin.parent is incorrectly null when isLeftDrawerOpen set to true", this._overlay.parent);
			Assert.assertTrue("Drawers overlaySkin.visible is incorrectly false when isLeftDrawerOpen set to true", this._overlay.visible);
			Assert.assertStrictlyEquals("Drawers overlaySkin.alpha has incorrect value when isLeftDrawerOpen set to true",
				OVERLAY_ALPHA, this._overlay.alpha);
		}

		[Test]
		public function testSetTopDrawerToNullWhileOpen():void
		{
			this._drawers.topDrawer = this._drawer1;
			this._drawers.isTopDrawerOpen = true;
			this._drawers.validate();
			this._drawers.topDrawer = null;
			this._drawers.validate();

			Assert.assertNull("Drawers topDrawer.parent is incorrectly non-null when topDrawer is set to null", this._drawer1.parent);
			Assert.assertFalse("Drawers overlaySkin.visible is incorrectly true when topDrawer set to null while open", this._overlay.visible);
		}

		[Test]
		public function testSetRightDrawerToNullWhileOpen():void
		{
			this._drawers.rightDrawer = this._drawer1;
			this._drawers.isRightDrawerOpen = true;
			this._drawers.validate();
			this._drawers.rightDrawer = null;
			this._drawers.validate();

			Assert.assertNull("Drawers rightDrawer.parent is incorrectly non-null when rightDrawer is set to null", this._drawer1.parent);
			Assert.assertFalse("Drawers overlaySkin.visible is incorrectly true when rightDrawer set to null while open", this._overlay.visible);
		}

		[Test]
		public function testSetBottomDrawerToNullWhileOpen():void
		{
			this._drawers.bottomDrawer = this._drawer1;
			this._drawers.isBottomDrawerOpen = true;
			this._drawers.validate();
			this._drawers.bottomDrawer = null;
			this._drawers.validate();

			Assert.assertNull("Drawers bottomDrawer.parent is incorrectly non-null when bottomDrawer is set to null", this._drawer1.parent);
			Assert.assertFalse("Drawers overlaySkin.visible is incorrectly true when bottomDrawer set to null while open", this._overlay.visible);
		}

		[Test]
		public function testSetLeftDrawerToNullWhileOpen():void
		{
			this._drawers.leftDrawer = this._drawer1;
			this._drawers.isLeftDrawerOpen = true;
			this._drawers.validate();
			this._drawers.leftDrawer = null;
			this._drawers.validate();

			Assert.assertNull("Drawers leftDrawer.parent is incorrectly non-null when leftDrawer is set to null", this._drawer1.parent);
			Assert.assertFalse("Drawers overlaySkin.visible is incorrectly true when leftDrawer set to null while open", this._overlay.visible);
		}

		[Test(async)]
		public function testToggleTopDrawerOpen():void
		{
			var hasDispatchedOpenEvent:Boolean = false;
			this._drawers.topDrawer = this._drawer1;
			this._drawers.addEventListener(Event.OPEN, function(event:Event):void
			{
				hasDispatchedOpenEvent = true;
			});
			this._drawers.toggleTopDrawer(0.2);
			this._drawers.validate();
			Assert.assertFalse("Drawers Event.OPEN was incorrectly dispatched before the animation completed", hasDispatchedOpenEvent);
			var drawers:Drawers = this._drawers;
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("Drawers Event.OPEN was not dispatched after toggleTopDrawer()", hasDispatchedOpenEvent);
				Assert.assertTrue("Drawers isTopDrawerOpen is incorrectly false after toggleTopDrawer()", drawers.isTopDrawerOpen);
			}, 300);
		}

		[Test(async)]
		public function testToggleTopDrawerClose():void
		{
			var hasDispatchedCloseEvent:Boolean = false;
			this._drawers.topDrawer = this._drawer1;
			this._drawers.addEventListener(Event.CLOSE, function(event:Event):void
			{
				hasDispatchedCloseEvent = true;
			});
			this._drawers.isTopDrawerOpen = true;
			this._drawers.validate();
			this._drawers.toggleTopDrawer(0.2);
			this._drawers.validate();
			Assert.assertFalse("Drawers Event.CLOSE was incorrectly dispatched before the animation completed", hasDispatchedCloseEvent);
			var drawers:Drawers = this._drawers;
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("Drawers Event.CLOSE was not dispatched after toggleTopDrawer()", hasDispatchedCloseEvent);
				Assert.assertFalse("Drawers isTopDrawerOpen is incorrectly true after toggleTopDrawer()", drawers.isTopDrawerOpen);
			}, 300);
		}

		[Test(async)]
		public function testToggleRightDrawerOpen():void
		{
			var hasDispatchedOpenEvent:Boolean = false;
			this._drawers.rightDrawer = this._drawer1;
			this._drawers.addEventListener(Event.OPEN, function(event:Event):void
			{
				hasDispatchedOpenEvent = true;
			});
			this._drawers.toggleRightDrawer(0.2);
			this._drawers.validate();
			Assert.assertFalse("Drawers Event.OPEN was incorrectly dispatched before the animation completed", hasDispatchedOpenEvent);
			var drawers:Drawers = this._drawers;
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("Drawers Event.OPEN was not dispatched after toggleRightDrawer()", hasDispatchedOpenEvent);
				Assert.assertTrue("Drawers isRightDrawerOpen is incorrectly false after toggleRightDrawer()", drawers.isRightDrawerOpen);
			}, 300);
		}

		[Test(async)]
		public function testToggleRightDrawerClose():void
		{
			var hasDispatchedCloseEvent:Boolean = false;
			this._drawers.rightDrawer = this._drawer1;
			this._drawers.addEventListener(Event.CLOSE, function(event:Event):void
			{
				hasDispatchedCloseEvent = true;
			});
			this._drawers.isRightDrawerOpen = true;
			this._drawers.validate();
			this._drawers.toggleRightDrawer(0.2);
			this._drawers.validate();
			Assert.assertFalse("Drawers Event.CLOSE was incorrectly dispatched before the animation completed", hasDispatchedCloseEvent);
			var drawers:Drawers = this._drawers;
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("Drawers Event.CLOSE was not dispatched after toggleRightDrawer()", hasDispatchedCloseEvent);
				Assert.assertFalse("Drawers isRightDrawerOpen is incorrectly true after toggleRightDrawer()", drawers.isRightDrawerOpen);
			}, 300);
		}

		[Test(async)]
		public function testToggleBottomDrawerOpen():void
		{
			var hasDispatchedOpenEvent:Boolean = false;
			this._drawers.bottomDrawer = this._drawer1;
			this._drawers.addEventListener(Event.OPEN, function(event:Event):void
			{
				hasDispatchedOpenEvent = true;
			});
			this._drawers.toggleBottomDrawer(0.2);
			this._drawers.validate();
			Assert.assertFalse("Drawers Event.OPEN was incorrectly dispatched before the animation completed", hasDispatchedOpenEvent);
			var drawers:Drawers = this._drawers;
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("Drawers Event.OPEN was not dispatched after toggleBottomDrawer()", hasDispatchedOpenEvent);
				Assert.assertTrue("Drawers isBottomDrawerOpen is incorrectly false after toggleBottomDrawer()", drawers.isBottomDrawerOpen);
			}, 300);
		}

		[Test(async)]
		public function testToggleBottomDrawerClose():void
		{
			var hasDispatchedCloseEvent:Boolean = false;
			this._drawers.bottomDrawer = this._drawer1;
			this._drawers.addEventListener(Event.CLOSE, function(event:Event):void
			{
				hasDispatchedCloseEvent = true;
			});
			this._drawers.isBottomDrawerOpen = true;
			this._drawers.validate();
			this._drawers.toggleBottomDrawer(0.2);
			this._drawers.validate();
			Assert.assertFalse("Drawers Event.CLOSE was incorrectly dispatched before the animation completed", hasDispatchedCloseEvent);
			var drawers:Drawers = this._drawers;
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("Drawers Event.CLOSE was not dispatched after toggleBottomDrawer()", hasDispatchedCloseEvent);
				Assert.assertFalse("Drawers isBottomDrawerOpen is incorrectly true after toggleBottomDrawer()", drawers.isBottomDrawerOpen);
			}, 300);
		}

		[Test(async)]
		public function testToggleLeftDrawerOpen():void
		{
			var hasDispatchedOpenEvent:Boolean = false;
			this._drawers.leftDrawer = this._drawer1;
			this._drawers.addEventListener(Event.OPEN, function(event:Event):void
			{
				hasDispatchedOpenEvent = true;
			});
			this._drawers.toggleLeftDrawer(0.2);
			this._drawers.validate();
			Assert.assertFalse("Drawers Event.OPEN was incorrectly dispatched before the animation completed", hasDispatchedOpenEvent);
			var drawers:Drawers = this._drawers;
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("Drawers Event.OPEN was not dispatched after toggleLeftDrawer()", hasDispatchedOpenEvent);
				Assert.assertTrue("Drawers isLeftDrawerOpen is incorrectly false after toggleLeftDrawer()", drawers.isLeftDrawerOpen);
			}, 300);
		}

		[Test(async)]
		public function testToggleLeftDrawerClose():void
		{
			var hasDispatchedCloseEvent:Boolean = false;
			this._drawers.leftDrawer = this._drawer1;
			this._drawers.addEventListener(Event.CLOSE, function(event:Event):void
			{
				hasDispatchedCloseEvent = true;
			});
			this._drawers.isLeftDrawerOpen = true;
			this._drawers.validate();
			this._drawers.toggleLeftDrawer(0.2);
			this._drawers.validate();
			Assert.assertFalse("Drawers Event.CLOSE was incorrectly dispatched before the animation completed", hasDispatchedCloseEvent);
			var drawers:Drawers = this._drawers;
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("Drawers Event.CLOSE was not dispatched after toggleLeftDrawer()", hasDispatchedCloseEvent);
				Assert.assertFalse("Drawers isLeftDrawerOpen is incorrectly true after toggleLeftDrawer()", drawers.isLeftDrawerOpen);
			}, 300);
		}

		[Test]
		public function testOpenTopDrawerClosesOtherDrawers():void
		{
			this._drawers.leftDrawer = this._drawer1;
			this._drawers.topDrawer = this._drawer2;
			this._drawers.isLeftDrawerOpen = true;
			this._drawers.validate();
			this._drawers.isTopDrawerOpen = true;
			Assert.assertFalse("Drawers isLeftDrawerOpen should be false after isTopDrawerOpen is set to true", this._drawers.isLeftDrawerOpen);
		}

		[Test]
		public function testOpenRightDrawerClosesOtherDrawers():void
		{
			this._drawers.leftDrawer = this._drawer1;
			this._drawers.rightDrawer = this._drawer2;
			this._drawers.isLeftDrawerOpen = true;
			this._drawers.validate();
			this._drawers.isRightDrawerOpen = true;
			Assert.assertFalse("Drawers isLeftDrawerOpen should be false after isRightDrawerOpen is set to true", this._drawers.isLeftDrawerOpen);
		}

		[Test]
		public function testOpenBottomDrawerClosesOtherDrawers():void
		{
			this._drawers.leftDrawer = this._drawer1;
			this._drawers.bottomDrawer = this._drawer2;
			this._drawers.isLeftDrawerOpen = true;
			this._drawers.validate();
			this._drawers.isBottomDrawerOpen = true;
			Assert.assertFalse("Drawers isLeftDrawerOpen should be false after isBottomDrawerOpen is set to true", this._drawers.isLeftDrawerOpen);
		}

		[Test]
		public function testOpenLeftDrawerClosesOtherDrawers():void
		{
			this._drawers.leftDrawer = this._drawer1;
			this._drawers.topDrawer = this._drawer2;
			this._drawers.isTopDrawerOpen = true;
			this._drawers.validate();
			this._drawers.isLeftDrawerOpen = true;
			Assert.assertFalse("Drawers isTopDrawerOpen should be false after isLeftDrawerOpen is set to true", this._drawers.isTopDrawerOpen);
		}

		[Test]
		public function testToggleTopDrawerClosesOtherDrawers():void
		{
			this._drawers.leftDrawer = this._drawer1;
			this._drawers.topDrawer = this._drawer2;
			this._drawers.isLeftDrawerOpen = true;
			this._drawers.validate();
			this._drawers.toggleTopDrawer();
			Assert.assertFalse("Drawers isLeftDrawerOpen should be false after toggleTopDrawer() opens the drawer", this._drawers.isLeftDrawerOpen);
		}

		[Test]
		public function testToggleRightDrawerClosesOtherDrawers():void
		{
			this._drawers.leftDrawer = this._drawer1;
			this._drawers.rightDrawer = this._drawer2;
			this._drawers.isLeftDrawerOpen = true;
			this._drawers.validate();
			this._drawers.toggleRightDrawer();
			Assert.assertFalse("Drawers isLeftDrawerOpen should be false after toggleRightDrawer() opens the drawer", this._drawers.isLeftDrawerOpen);
		}

		[Test]
		public function testToggleBottomDrawerClosesOtherDrawers():void
		{
			this._drawers.leftDrawer = this._drawer1;
			this._drawers.bottomDrawer = this._drawer2;
			this._drawers.isLeftDrawerOpen = true;
			this._drawers.validate();
			this._drawers.toggleBottomDrawer();
			Assert.assertFalse("Drawers isLeftDrawerOpen should be false after toggleBottomDrawer() opens the drawer", this._drawers.isLeftDrawerOpen);
		}

		[Test]
		public function testToggleLeftDrawerClosesOtherDrawers():void
		{
			this._drawers.leftDrawer = this._drawer1;
			this._drawers.topDrawer = this._drawer2;
			this._drawers.isTopDrawerOpen = true;
			this._drawers.validate();
			this._drawers.toggleLeftDrawer();
			Assert.assertFalse("Drawers isTopDrawerOpen should be false after toggleLeftDrawer() opens the drawer", this._drawers.isTopDrawerOpen);
		}
	}
}


================================================
FILE: test/source/feathers/tests/DropDownPopUpContentManagerTests.as
================================================
package feathers.tests
{
	import feathers.controls.popups.DropDownPopUpContentManager;
	import feathers.core.PopUpManager;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.display.Sprite;
	import starling.events.Event;

	public class DropDownPopUpContentManagerTests
	{
		private static const OVERLAY_NAME:String = "DropDownPopUpContentManagerOverlay";
		
		private var _popUp:DisplayObject;
		private var _customRoot:Sprite;
		private var _source:Quad;
		private var _popUpContentManager:DropDownPopUpContentManager;

		[Before]
		public function prepare():void
		{
			this._source = new Quad(200, 180, 0x00ff00);
			TestFeathers.starlingRoot.addChild(this._source);

			this._customRoot = new Sprite();
			TestFeathers.starlingRoot.addChild(this._customRoot);
			PopUpManager.root = this._customRoot;

			this._popUpContentManager = new DropDownPopUpContentManager();
			this._popUpContentManager.openCloseDuration = 0;
		}

		[After]
		public function cleanup():void
		{
			this._source.removeFromParent(true);
			this._source = null;

			this._customRoot.removeFromParent(true);
			this._customRoot = null;

			if(this._popUp)
			{
				this._popUp.removeFromParent(true);
				this._popUp = null;
			}

			PopUpManager.root = TestFeathers.starlingRoot.stage;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function createSimplePopUp():DisplayObject
		{
			var simplePopUp:Quad = new Quad(100, 150, 0xff00ff);
			return simplePopUp;
		}

		private function createOverlay():DisplayObject
		{
			var overlay:Quad = new Quad(1, 1, 0x000000);
			overlay.alpha = 0.5;
			overlay.name = OVERLAY_NAME;
			return overlay;
		}

		[Test]
		public function testOpen():void
		{
			this._popUp = this.createSimplePopUp();
			var openDispatched:Boolean = false;
			this._popUpContentManager.addEventListener(Event.OPEN, function(event:Event):void
			{
				openDispatched = true;
			});
			this._popUpContentManager.open(this._popUp, this._source);
			Assert.assertNotNull("DropDownPopUpContentManager content parent should not be null.", this._popUp.parent);
			Assert.assertTrue("DropDownPopUpContentManager did not dispatch Event.OPEN.", openDispatched);
		}

		[Test]
		public function testClose():void
		{
			this._popUp = this.createSimplePopUp();
			var closeDispatched:Boolean = false;
			this._popUpContentManager.addEventListener(Event.CLOSE, function(event:Event):void
			{
				closeDispatched = true;
			});
			this._popUpContentManager.open(this._popUp, this._source);
			this._popUpContentManager.close();
			Assert.assertNull("DropDownPopUpContentManager content parent should be null.", this._popUp.parent);
			Assert.assertTrue("DropDownPopUpContentManager did not dispatch Event.CLOSE.", closeDispatched);
		}

		[Test]
		public function testOverlayFactory():void
		{
			this._popUp = this.createSimplePopUp();
			this._popUpContentManager.isModal = true;
			this._popUpContentManager.overlayFactory = this.createOverlay;
			this._popUpContentManager.open(this._popUp, this._source);
			var overlay:DisplayObject = this._customRoot.getChildByName(OVERLAY_NAME);
			Assert.assertNotNull("DropDownPopUpContentManager overlayFactory result not found.", overlay);
		}
	}
}


================================================
FILE: test/source/feathers/tests/FlowLayoutTests.as
================================================
package feathers.tests
{
	import feathers.layout.FlowLayout;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.ViewPortBounds;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;

	public class FlowLayoutTests
	{
		private static const PADDING_TOP:Number = 6;
		private static const PADDING_RIGHT:Number = 8;
		private static const PADDING_BOTTOM:Number = 2;
		private static const PADDING_LEFT:Number = 10;
		private static const GAP:Number = 5;
		private static const CHILD1_WIDTH:Number = 200;
		private static const CHILD1_HEIGHT:Number = 100;
		private static const CHILD2_WIDTH:Number = 150;
		private static const CHILD2_HEIGHT:Number = 75;
		
		private var _layout:FlowLayout;

		[Before]
		public function prepare():void
		{
			this._layout = new FlowLayout();
			this._layout.useVirtualLayout = false;
		}

		[After]
		public function cleanup():void
		{
			this._layout = null;
		}

		[Test]
		public function testLayoutResultWithNoItems():void
		{
			var items:Vector.<DisplayObject> = new <DisplayObject>[];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult viewPortWidth not equal to 0 with no items.", 0, result.viewPortWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult viewPortHeight not equal to 0 with no items.", 0, result.viewPortHeight);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentWidth not equal to 0 with no items.", 0, result.contentWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentHeight not equal to 0 with no items.", 0, result.contentHeight);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentX not equal to 0 with no items.", 0, result.contentX);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentY not equal to 0 with no items.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithNoItems():void
		{
			this._layout.useVirtualLayout = true;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(0, bounds);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort width not equal to 0 with no items.", 0, result.x);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort height not equal to 0 with no items.", 0, result.y);
		}

		[Test]
		public function testLayoutResultWithPaddingGapAndNoItems():void
		{
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			var items:Vector.<DisplayObject> = new <DisplayObject>[];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult viewPortWidth not equal to sum of left and right padding with no items.", PADDING_LEFT + PADDING_RIGHT, result.viewPortWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult viewPortHeight not equal to sum of top and bottom padding with no items.", PADDING_TOP + PADDING_BOTTOM, result.viewPortHeight);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentWidth not equal to sum of left and right padding with no items.", PADDING_LEFT + PADDING_RIGHT, result.contentWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentHeight not equal to sum of top and bottom padding with no items.", PADDING_TOP + PADDING_BOTTOM, result.contentHeight);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentX not equal to 0 with padding and no items.", 0, result.contentX);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentY not equal to 0 with padding and no items.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithPaddingGapAndNoItems():void
		{
			this._layout.useVirtualLayout = true;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(0, bounds);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort x not equal to sum of left and right padding with no items.", PADDING_LEFT + PADDING_RIGHT, result.x);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort y not equal to sum of top and bottom padding with no items.", PADDING_TOP + PADDING_BOTTOM, result.y);
		}

		[Test]
		public function testLayoutResultWithOneChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult viewPortWidth not equal to child width with one item.", CHILD1_WIDTH, result.viewPortWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult viewPortHeight not equal to child height with one item.", CHILD1_HEIGHT, result.viewPortHeight);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentWidth not equal to child width with one item.", CHILD1_WIDTH, result.contentWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentHeight not equal to child height with one item.", CHILD1_HEIGHT, result.contentHeight);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentX not equal to 0 with one item.", 0, result.contentX);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentY not equal to 0 with one item.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithOneChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort x not equal to child width with one item.", CHILD1_WIDTH, result.x);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort y not equal to child height with and one item.", CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testLayoutResultWithPaddingGapAndOneChild():void
		{
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult viewPortWidth not equal to sum of left and right padding and width of child.", CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT, result.viewPortWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult viewPortHeight not equal to sum of top and bottom padding and height of child.", CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, result.viewPortHeight);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentWidth not equal to sum of left and right padding and width of child.", CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT, result.contentWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentHeight not equal to sum of top and bottom padding and height of child.", CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, result.contentHeight);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentX not equal to 0 with one item and padding.", 0, result.contentX);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentY not equal to 0 with one item and padding.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithPaddingGapAndOneChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort x not equal to sum of left and right padding and width of child.", CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT, result.x);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort y not equal to sum of top and bottom padding and height of child.", CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, result.y);
		}

		[Test]
		public function testLayoutResultWithTwoChildren():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			var maxChildHeight:Number = Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult viewPortWidth not equal to sum of item widths.", CHILD1_WIDTH + CHILD2_WIDTH, result.viewPortWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult viewPortHeight not equal to max height of items.", maxChildHeight, result.viewPortHeight);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentWidth not equal to sum of item widths.", CHILD1_WIDTH + CHILD2_WIDTH, result.contentWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentHeight not equal to max height of items.", maxChildHeight, result.contentHeight);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentX not equal to 0 with padding and two items.", 0, result.contentX);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentY not equal to 0 with padding and two items.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithTwoChildren():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(2, bounds);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort x not equal to typical item width multiplied by the number of items.", 2 * CHILD1_WIDTH, result.x);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort y not equal to height of typical item.", CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testLayoutResultWithPaddingGapAndTwoChildren():void
		{
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			var maxChildHeight:Number = Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult viewPortWidth not equal to sum of item widths plus left and right padding and gap.", CHILD1_WIDTH + CHILD2_WIDTH + PADDING_LEFT + PADDING_RIGHT + GAP, result.viewPortWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult viewPortHeight not equal to max height of items plus top and bottom padding.", maxChildHeight + PADDING_TOP + PADDING_BOTTOM, result.viewPortHeight);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentWidth not equal to sum of item widths plus left and right padding and gap.", CHILD1_WIDTH + CHILD2_WIDTH + PADDING_LEFT + PADDING_RIGHT + GAP, result.contentWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentHeight not equal to max height of items plus top and bottom padding.", maxChildHeight + PADDING_TOP + PADDING_BOTTOM, result.contentHeight);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentX not equal to 0 with two items plus padding and gap.", 0, result.contentX);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutBoundsResult contentY not equal to 0 with two items plus padding and gap.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithPaddingGapAndTwoChildren():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(2, bounds);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort x not equal to typical item width multiplied by item count plus left and right padding and gap.", 2 * CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT + GAP, result.x);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort y not equal to max height of items plus top and bottom padding.", CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, result.y);
		}

		[Test]
		public function testLayoutResultWithMaxWidthLargerThanItems():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = CHILD1_WIDTH + (CHILD2_WIDTH / 2);
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			var maxChildWidth:Number = Math.max(CHILD1_WIDTH, CHILD2_WIDTH);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutResult viewPortWidth not equal to max child width when flow to second row.", maxChildWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutResult viewPortHeight not equal to sum of child heights when flow to second row.", CHILD1_HEIGHT + CHILD2_HEIGHT, result.viewPortHeight);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutResult contentWidth not equal to max child width when flow to second row.", maxChildWidth, result.contentWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutResult contentHeight not equal to sum of child heights when flow to second row.", CHILD1_HEIGHT + CHILD2_HEIGHT, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxWidthLargerThanItems():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = CHILD1_WIDTH + (CHILD2_WIDTH / 2);
			var result:Point = this._layout.measureViewPort(2, bounds);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort x not equal to typical item width when flow to second row.", CHILD1_WIDTH, result.x);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort y not equal to typical item height multiplied by item count when flow to second row.", 2 * CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testLayoutResultWithMaxWidthSmallerThanItems():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = Math.min(CHILD1_WIDTH, CHILD2_WIDTH) / 2;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			var maxChildWidth:Number = Math.max(CHILD1_WIDTH, CHILD2_WIDTH);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutResult viewPortWidth not equal to maxWidth with larger children.", bounds.maxWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutResult viewPortHeight not equal to sum of child heights when flow to second row.", CHILD1_HEIGHT + CHILD2_HEIGHT, result.viewPortHeight);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutResult contentWidth not equal to maximum child width with larger children.", maxChildWidth, result.contentWidth);
			Assert.assertStrictlyEquals("FlowLayout layout LayoutResult contentHeight not equal to sum of child heights when flow to second row.", CHILD1_HEIGHT + CHILD2_HEIGHT, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxWidthSmallerThanItems():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = Math.min(CHILD1_WIDTH, CHILD2_WIDTH) / 2;
			var result:Point = this._layout.measureViewPort(2, bounds);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort x not equal to maxWidth with larger children.", bounds.maxWidth, result.x);
			Assert.assertStrictlyEquals("FlowLayout measureViewPort y not equal to typical item height multiplied by item count when flow to second row.", 2 * CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testCenterAlignmentWithExplicitWidthLargerThanSumOfItems():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 2 * CHILD1_WIDTH + CHILD2_WIDTH;
			this._layout.horizontalAlign = HorizontalAlign.CENTER;
			this._layout.layout(items, bounds);
			var totalChildWidth:Number = CHILD1_WIDTH + CHILD2_WIDTH;
			Assert.assertStrictlyEquals("FlowLayout with HorizontalAlign.CENTER set first child.x incorrectly", Math.round((bounds.explicitWidth - totalChildWidth) / 2), item1.x);
			Assert.assertStrictlyEquals("FlowLayout with HorizontalAlign.CENTER set second child.x incorrectly", Math.round((bounds.explicitWidth - totalChildWidth) / 2) + CHILD1_WIDTH, item2.x);
		}

		[Test]
		public function testCenterAlignmentWithMaxWidthLargerThanItems():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = CHILD1_WIDTH + (CHILD2_WIDTH / 2);
			this._layout.horizontalAlign = HorizontalAlign.CENTER;
			this._layout.layout(items, bounds);
			var maxChildWidth:Number = Math.max(CHILD1_WIDTH, CHILD2_WIDTH);
			Assert.assertStrictlyEquals("FlowLayout with HorizontalAlign.CENTER set first child.x incorrectly", Math.round((maxChildWidth - CHILD1_WIDTH) / 2), item1.x);
			Assert.assertStrictlyEquals("FlowLayout with HorizontalAlign.CENTER set second child.x incorrectly", Math.round((maxChildWidth - CHILD2_WIDTH) / 2), item2.x);
		}

		[Test]
		public function testRightAlignmentWithMaxWidthLargerThanItems():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = CHILD1_WIDTH + (CHILD2_WIDTH / 2);
			this._layout.horizontalAlign = HorizontalAlign.RIGHT;
			this._layout.layout(items, bounds);
			var maxChildWidth:Number = Math.max(CHILD1_WIDTH, CHILD2_WIDTH);
			Assert.assertStrictlyEquals("FlowLayout with HorizontalAlign.RIGHT set first child.x incorrectly", maxChildWidth - CHILD1_WIDTH, item1.x);
			Assert.assertStrictlyEquals("FlowLayout with HorizontalAlign.RIGHT set second child.x incorrectly", maxChildWidth - CHILD2_WIDTH, item2.x);
		}

		[Test]
		public function testRightAlignmentWithMinAndMaxWidthLargerThanItems():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.minWidth = CHILD1_WIDTH + (CHILD2_WIDTH / 4);
			bounds.maxWidth = CHILD1_WIDTH + (CHILD2_WIDTH / 2);
			this._layout.horizontalAlign = HorizontalAlign.RIGHT;
			this._layout.layout(items, bounds);
			var maxChildWidth:Number = Math.max(CHILD1_WIDTH, CHILD2_WIDTH);
			Assert.assertStrictlyEquals("FlowLayout with HorizontalAlign.RIGHT set first child.x incorrectly", bounds.minWidth - CHILD1_WIDTH, item1.x);
			Assert.assertStrictlyEquals("FlowLayout with HorizontalAlign.RIGHT set second child.x incorrectly", bounds.minWidth - CHILD2_WIDTH, item2.x);
		}

		[Test]
		public function testRightAlignmentWithExplicitWidthInBetweenItemWidths():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var explicitWidth:Number = (CHILD1_WIDTH + CHILD2_WIDTH) / 2;
			bounds.explicitWidth = explicitWidth;
			this._layout.horizontalAlign = HorizontalAlign.RIGHT;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("FlowLayout with HorizontalAlign.RIGHT and larger child than explicitWidth calculated contentWidth incorrectly",
				CHILD1_WIDTH, result.contentWidth);
			Assert.assertStrictlyEquals("FlowLayout with HorizontalAlign.RIGHT and larger child than explicitWidth calculated viewPortWidth incorrectly",
				explicitWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("FlowLayout with HorizontalAlign.RIGHT and larger child than explicitWidth calculated larger child x incorrectly",
				0, item1.x);
			Assert.assertStrictlyEquals("FlowLayout with HorizontalAlign.RIGHT and larger child than explicitWidth calculated smaller child x incorrectly",
				CHILD1_WIDTH - item2.width, item2.x);
		}

		[Test]
		public function testRightAlignmentWithExplicitWidthLargerThanSumOfItems():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 2 * CHILD1_WIDTH + CHILD2_WIDTH;
			this._layout.horizontalAlign = HorizontalAlign.RIGHT;
			this._layout.layout(items, bounds);
			var totalChildWidth:Number = CHILD1_WIDTH + CHILD2_WIDTH;
			Assert.assertStrictlyEquals("FlowLayout with HorizontalAlign.RIGHT set first child.x incorrectly", bounds.explicitWidth - totalChildWidth, item1.x);
			Assert.assertStrictlyEquals("FlowLayout with HorizontalAlign.RIGHT set second child.x incorrectly", bounds.explicitWidth - totalChildWidth + CHILD1_WIDTH, item2.x);
		}
	}
}


================================================
FILE: test/source/feathers/tests/FocusIndicatorTests.as
================================================
package feathers.tests
{
	import feathers.controls.BasicButton;
	import feathers.controls.ButtonState;
	import feathers.events.FeathersEventType;
	import feathers.tests.supportClasses.DisposeFlagQuad;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;
	import feathers.core.FeathersControl;

	public class FocusIndicatorTests
	{
		private var _control:CustomFocusControl;

		[Before]
		public function prepare():void
		{
			this._control = new CustomFocusControl();
			TestFeathers.starlingRoot.addChild(this._control);
		}

		[After]
		public function cleanup():void
		{
			this._control.removeFromParent(true);
			this._control = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testSkinsDisposed():void
		{
			var focusIndicatorSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._control.focusIndicatorSkin = focusIndicatorSkin;
			this._control.validate();
			this._control.dispose();
			Assert.assertTrue("focusIndicatorSkin not disposed when IFocusDisplayObject disposed.", focusIndicatorSkin.isDisposed);
		}

		[Test]
		public function testSkinsRemovedWhenSetToNull():void
		{
			var focusIndicatorSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._control.focusIndicatorSkin = focusIndicatorSkin;
			this._control.validate();
			this._control.focusIndicatorSkin = null;
			//should not need to validate here
			this._control.dispose();
			Assert.assertFalse("Removed focusIndicatorSkin incorrectly disposed when Button disposed.", focusIndicatorSkin.isDisposed);
			focusIndicatorSkin.dispose();
		}
	}
}

import feathers.core.IFocusDisplayObject;
import feathers.core.FeathersControl;

class CustomFocusControl extends FeathersControl implements IFocusDisplayObject
{
	public function CustomFocusControl()
	{

	}
}

================================================
FILE: test/source/feathers/tests/FocusManagerEnabledTests.as
================================================
package feathers.tests
{
	import feathers.core.FocusManager;

	import org.flexunit.Assert;

	import starling.display.Stage;

	public class FocusManagerEnabledTests
	{
		[After]
		public function cleanup():void
		{
			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);
		}

		[Test]
		public function testIsEnabledForStageWhenNotEnabled():void
		{
			var stage:Stage = TestFeathers.starlingRoot.stage;
			Assert.assertFalse("FocusManager incorrectly enabled for stage", FocusManager.isEnabledForStage(stage));
		}

		[Test]
		public function testIsEnabledForStageWhenEnabled():void
		{
			var stage:Stage = TestFeathers.starlingRoot.stage;
			FocusManager.setEnabledForStage(stage, true);
			Assert.assertTrue("FocusManager incorrectly disabled for stage", FocusManager.isEnabledForStage(stage));
		}

		[Test]
		public function testNotNullWhenEnabled():void
		{
			var stage:Stage = TestFeathers.starlingRoot.stage;
			FocusManager.setEnabledForStage(stage, true);
			Assert.assertNotNull("getFocusManagerForStage() incorrectly returns null when enabled", FocusManager.getFocusManagerForStage(stage));
		}
	}
}


================================================
FILE: test/source/feathers/tests/FocusManagerTests.as
================================================
package feathers.tests
{
	import feathers.controls.Button;
	import feathers.core.FocusManager;
	import feathers.events.FeathersEventType;

	import flash.events.FocusEvent;
	import flash.ui.Keyboard;

	import org.flexunit.Assert;

	import starling.core.Starling;
	import starling.display.Quad;
	import starling.events.Event;

	public class FocusManagerTests
	{
		private var _button:Button;
		private var _button2:Button;
		
		[Before]
		public function prepare():void
		{
			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, true);
			
			this._button = new Button();
			this._button.label = "Click Me";
			this._button.defaultSkin = new Quad(200, 200);
			TestFeathers.starlingRoot.addChild(this._button);

			this._button2 = new Button();
			this._button2.label = "Click Me Too";
			this._button2.defaultSkin = new Quad(200, 200);
			this._button2.y = 210;
			TestFeathers.starlingRoot.addChild(this._button2);
		}
		
		[After]
		public function cleanup():void
		{
			this._button.removeFromParent(true);
			this._button = null;
			this._button2.removeFromParent(true);
			this._button2 = null;
			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testInjectFocusManager():void
		{
			Assert.assertFalse("focusManager property incorrectly returns null", this._button.focusManager === null);
			Assert.assertStrictlyEquals("focusManager property does not match getFocusManagerForStage()", this._button.focusManager, FocusManager.getFocusManagerForStage(this._button.stage));
		}

		[Test]
		public function testChangeFocus():void
		{
			this._button.focusManager.focus = this._button;
			Assert.assertStrictlyEquals("Wrong value returned by focus property of FocusManager", this._button.focusManager.focus, this._button);
		}

		[Test]
		public function testDispatchFocusInEvent():void
		{
			var hasDispatchedFocusIn:Boolean = false;
			this._button.addEventListener(FeathersEventType.FOCUS_IN, function(event:Event):void
			{
				hasDispatchedFocusIn = true;
			});
			this._button.focusManager.focus = this._button;
			Assert.assertTrue("FeathersEventType.FOCUS_IN was not dispatched after setting focus property of FocusManager", hasDispatchedFocusIn);
		}

		[Test]
		public function testDispatchFocusOutEvent():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._button.addEventListener(FeathersEventType.FOCUS_OUT, function(event:Event):void
			{
				hasDispatchedFocusOut = true;
			});
			this._button.focusManager.focus = this._button;
			this._button.focusManager.focus = null;
			Assert.assertTrue("FeathersEventType.FOCUS_OUT was not dispatched after setting focus property of FocusManager", hasDispatchedFocusOut);
		}

		[Test]
		public function testFocusPropertyInFocusInEventListener():void
		{
			var hasCorrectFocus:Boolean = false;
			this._button.addEventListener(FeathersEventType.FOCUS_IN, function(event:Event):void
			{
				var button:Button = Button(event.currentTarget);
				hasCorrectFocus = button.focusManager.focus === button;
			});
			this._button.focusManager.focus = this._button;
			Assert.assertTrue("The focus property of the FocusManager is not updated before calling listener for FeathersEventType.FOCUS_IN event", hasCorrectFocus);
		}

		[Test]
		public function testFocusPropertyInFocusOutEventListener():void
		{
			var hasDifferentFocus:Boolean = false;
			this._button.addEventListener(FeathersEventType.FOCUS_OUT, function(event:Event):void
			{
				var button:Button = Button(event.currentTarget);
				hasDifferentFocus = button.focusManager.focus !== button;
			});
			this._button.focusManager.focus = this._button;
			this._button.focusManager.focus = null;
			Assert.assertTrue("The focus property of the FocusManager is not updated before calling listener for FeathersEventType.FOCUS_OUT event", hasDifferentFocus);
		}

		[Test]
		public function testFocusChangeOnTabKey():void
		{
			this._button.focusManager.focus = this._button;
			Starling.current.nativeStage.dispatchEvent(new FocusEvent(FocusEvent.KEY_FOCUS_CHANGE, true, false, null, false, Keyboard.TAB));
			Assert.assertStrictlyEquals("The FocusManager did not change focus when pressing Keyboard.TAB", this._button.focusManager.focus, this._button2);
		}

		[Test]
		public function testFocusChangeOnShiftPlusTabKey():void
		{
			this._button.focusManager.focus = this._button2;
			Starling.current.nativeStage.dispatchEvent(new FocusEvent(FocusEvent.KEY_FOCUS_CHANGE, true, false, null, true, Keyboard.TAB));
			Assert.assertStrictlyEquals("The FocusManager did not change focus when pressing Keyboard.TAB", this._button.focusManager.focus, this._button);
		}
	}
}


================================================
FILE: test/source/feathers/tests/FontStylesSetTests.as
================================================
package feathers.tests
{
	import feathers.text.FontStylesSet;
	import starling.text.TextFormat;
	import org.flexunit.Assert;
	import starling.events.Event;

	public class FontStylesSetTests
	{
		private static const SAMPLE_STATE:String = "sample";
		private static const UNDEFINED_STATE:String = "noState";

		private var _fontStyles:FontStylesSet;

		[Before]
		public function prepare():void
		{
			this._fontStyles = new FontStylesSet();
		}

		[After]
		public function cleanup():void
		{
			this._fontStyles.dispose();
			this._fontStyles = null;
		}

		[Test]
		public function testSetFormatForState():void
		{
			var format:TextFormat = new TextFormat();
			this._fontStyles.setFormatForState(SAMPLE_STATE, format);
			var otherFormat:TextFormat = this._fontStyles.getFormatForState(SAMPLE_STATE);
			Assert.assertStrictlyEquals("FontStylesSet: getFormatForState() must return same value passed to setFormatForState().",
				format, otherFormat);
			otherFormat = this._fontStyles.getFormatForState(UNDEFINED_STATE);
			Assert.assertStrictlyEquals("FontStylesSet: getFormatForState() must return null for state that is undefined.",
				null, otherFormat);
		}

		[Test]
		public function testFormatAddAndRemoveEvents():void
		{
			var format:TextFormat = new TextFormat();
			this._fontStyles.format = format;
			Assert.assertTrue("FontStylesSet: TextFormat add have Event.CHANGE listener.",
				format.hasEventListener(Event.CHANGE));
			this._fontStyles.dispose();
			Assert.assertFalse("FontStylesSet: TextFormat must remove Event.CHANGE listener.",
				format.hasEventListener(Event.CHANGE));
		}

		[Test]
		public function testFormatDispatchEvents():void
		{
			var format:TextFormat = new TextFormat();
			this._fontStyles.format = format;
			var hasChanged:Boolean = false;
			this._fontStyles.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			format.bold = true;
			Assert.assertTrue("FontStylesSet: Must dispatch Event.CHANGE when TextFormat changes.",
				hasChanged);
		}

		[Test]
		public function testDisabledFormatAddAndRemoveEvents():void
		{
			var format:TextFormat = new TextFormat();
			this._fontStyles.disabledFormat = format;
			Assert.assertTrue("FontStylesSet: TextFormat must add Event.CHANGE listener.",
				format.hasEventListener(Event.CHANGE));
			this._fontStyles.dispose();
			Assert.assertFalse("FontStylesSet: TextFormat must remove Event.CHANGE listener.",
				format.hasEventListener(Event.CHANGE));
		}

		[Test]
		public function testDisabledFormatDispatchEvents():void
		{
			var format:TextFormat = new TextFormat();
			this._fontStyles.disabledFormat = format;
			var hasChanged:Boolean = false;
			this._fontStyles.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			format.bold = true;
			Assert.assertTrue("FontStylesSet: Must dispatch Event.CHANGE when TextFormat changes.",
				hasChanged);
		}

		[Test]
		public function testSelectedFormatAddAndRemoveEvents():void
		{
			var format:TextFormat = new TextFormat();
			this._fontStyles.selectedFormat = format;
			Assert.assertTrue("FontStylesSet: TextFormat must add Event.CHANGE listener.",
				format.hasEventListener(Event.CHANGE));
			this._fontStyles.dispose();
			Assert.assertFalse("FontStylesSet: TextFormat must remove Event.CHANGE listener.",
				format.hasEventListener(Event.CHANGE));
		}

		[Test]
		public function testSelectedFormatDispatchEvents():void
		{
			var format:TextFormat = new TextFormat();
			this._fontStyles.selectedFormat = format;
			var hasChanged:Boolean = false;
			this._fontStyles.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			format.bold = true;
			Assert.assertTrue("FontStylesSet: Must dispatch Event.CHANGE when TextFormat changes.",
				hasChanged);
		}

		[Test]
		public function testSetFormatForStateAddAndRemoveEvents():void
		{
			var format:TextFormat = new TextFormat();
			this._fontStyles.setFormatForState(SAMPLE_STATE, format);
			Assert.assertTrue("FontStylesSet: TextFormat must add Event.CHANGE listener.",
				format.hasEventListener(Event.CHANGE));
			this._fontStyles.dispose();
			Assert.assertFalse("FontStylesSet: TextFormat must remove Event.CHANGE listener.",
				format.hasEventListener(Event.CHANGE));
		}

		[Test]
		public function testSetFormatForStateDispatchEvents():void
		{
			var format:TextFormat = new TextFormat();
			this._fontStyles.setFormatForState(SAMPLE_STATE, format);
			var hasChanged:Boolean = false;
			this._fontStyles.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			format.bold = true;
			Assert.assertTrue("FontStylesSet: Must dispatch Event.CHANGE when TextFormat changes.",
				hasChanged);
		}
	}	
}

================================================
FILE: test/source/feathers/tests/FunctionStyleProviderTests.as
================================================
package feathers.tests
{
	import feathers.controls.BasicButton;
	import feathers.core.IFeathersControl;
	import feathers.skins.FunctionStyleProvider;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class FunctionStyleProviderTests
	{
		private var _target:BasicButton;
		private var _styleProvider:FunctionStyleProvider;
		private var _functionCalled:Boolean;

		[Before]
		public function prepare():void
		{
			this._functionCalled = false;

			this._target = new BasicButton();
			this._target.defaultSkin = new Quad(200, 200, 0xff00ff);
		}

		[After]
		public function cleanup():void
		{
			this._target.removeFromParent(true);
			this._target = null;

			this._styleProvider = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}
		
		private function setStyles(target:IFeathersControl):void
		{
			this._functionCalled = true;
		}

		[Test]
		public function testNoErrorWithNullFunction():void
		{
			this._styleProvider = new FunctionStyleProvider(null);
			this._styleProvider.applyStyles(this._target);
			Assert.assertFalse("FunctionStyleProvider incorrectly called the function", this._functionCalled);
		}

		[Test]
		public function testFunctionCalled():void
		{
			this._styleProvider = new FunctionStyleProvider(setStyles);
			this._styleProvider.applyStyles(this._target);
			Assert.assertTrue("FunctionStyleProvider must call the function", this._functionCalled);
		}
	}
}


================================================
FILE: test/source/feathers/tests/GroupedListDataProviderTests.as
================================================
package feathers.tests
{
	import feathers.controls.GroupedList;
	import feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer;
	import feathers.controls.renderers.DefaultGroupedListItemRenderer;
	import feathers.data.HierarchicalCollection;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class GroupedListDataProviderTests
	{
		private var _list:GroupedList;

		[Before]
		public function prepare():void
		{
			this._list = new GroupedList();
			this._list.itemRendererFactory = function():DefaultGroupedListItemRenderer
			{
				var itemRenderer:DefaultGroupedListItemRenderer = new DefaultGroupedListItemRenderer();
				itemRenderer.defaultSkin = new Quad(200, 200);
				return itemRenderer;
			};
			this._list.headerRendererFactory = function():DefaultGroupedListHeaderOrFooterRenderer
			{
				var headerRenderer:DefaultGroupedListHeaderOrFooterRenderer = new DefaultGroupedListHeaderOrFooterRenderer();
				headerRenderer.backgroundSkin = new Quad(200, 200);
				return headerRenderer;
			};
			TestFeathers.starlingRoot.addChild(this._list);
		}

		[After]
		public function cleanup():void
		{
			this._list.removeFromParent(true);
			this._list = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testValidateWithNullDataProvider():void
		{
			this._list.validate();
		}

		[Test]
		public function testValidateWithNullDataProviderAndTypicalItem():void
		{
			this._list.typicalItem = { label: "Typical Item" };
			this._list.validate();
		}

		[Test]
		public function testNoErrorOnDataProviderWithoutGroups():void
		{
			this._list.dataProvider = new HierarchicalCollection([]);
			this._list.validate();
		}

		[Test]
		public function testNoErrorOnDataProviderWithOneEmptyGroup():void
		{
			this._list.dataProvider = new HierarchicalCollection(
			[
				{ children: [] }
			]);
			this._list.validate();
		}

		[Test]
		public function testNoErrorOnDataProviderWithoutGroupsAndWithTypicalItem():void
		{
			this._list.typicalItem = { label: "Typical Item" };
			this._list.dataProvider = new HierarchicalCollection([]);
			this._list.validate();
		}

		[Test]
		public function testNoErrorOnDataProviderWithOneEmptyGroupAndTypicalItem():void
		{
			this._list.typicalItem = { label: "Typical Item" };
			this._list.dataProvider = new HierarchicalCollection(
			[
				{ children: [] }
			]);
			this._list.validate();
		}

		[Test(expects="TypeError")]
		public function testErrorOnGroupWithNoChildrenField():void
		{
			this._list.dataProvider = new HierarchicalCollection(
			[
				{}
			]);
			this._list.validate();
		}
	}
}


================================================
FILE: test/source/feathers/tests/GroupedListFactoryIDFunctionTests.as
================================================
package feathers.tests
{
	import feathers.controls.GroupedList;
	import feathers.controls.renderers.DefaultGroupedListItemRenderer;
	import feathers.controls.renderers.IGroupedListHeaderRenderer;
	import feathers.controls.renderers.IGroupedListItemRenderer;
	import feathers.core.IFeathersControl;
	import feathers.data.ArrayHierarchicalCollection;
	import feathers.events.FeathersEventType;

	import flash.utils.Dictionary;

	import org.flexunit.Assert;

	import starling.display.Quad;
	import starling.events.Event;

	public class GroupedListFactoryIDFunctionTests
	{
		private static const FACTORY_ONE:String = "custom-factory1";
		private static const CUSTOM_STYLE_NAME:String = "custom-style-name";

		private var _list:GroupedList;

		private var _itemRendererMap:Dictionary;

		[Before]
		public function prepare():void
		{
			this._itemRendererMap = new Dictionary(true);

			this._list = new GroupedList();
			this._list.dataProvider = new ArrayHierarchicalCollection(
			[	
				{
					header: { label: "Group A" },
					children:
					[
						{ label: "One", factory: 0 },
						{ label: "Two", factory: 0 },
						{ label: "Three", factory: 1 },
					]
				},
				{
					header: { label: "Group B" },
					children:
					[
						{ label: "Four", factory: 0 }
					]
				},
				{
					header: { label: "Group C" },
					children:
					[
						{ label: "Five", factory: 0 },
						{ label: "Six", factory: 0 }
					]
				},
			]);
			this._list.itemRendererFactory = function():DefaultGroupedListItemRenderer
			{
				var itemRenderer:DefaultGroupedListItemRenderer = new DefaultGroupedListItemRenderer();
				itemRenderer.defaultSkin = new Quad(200, 200);
				return itemRenderer;
			};
			this._list.setItemRendererFactoryWithID(FACTORY_ONE, function():DefaultGroupedListItemRenderer
			{
				var itemRenderer:DefaultGroupedListItemRenderer = new DefaultGroupedListItemRenderer();
				itemRenderer.styleNameList.add(CUSTOM_STYLE_NAME);
				itemRenderer.defaultSkin = new Quad(200, 200);
				return itemRenderer;
			});
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, list_rendererAddHandler);
			this._list.addEventListener(FeathersEventType.RENDERER_REMOVE, list_rendererRemoveHandler);
			TestFeathers.starlingRoot.addChild(this._list);
			this._list.validate();
		}

		[After]
		public function cleanup():void
		{
			this._list.removeFromParent(true);
			this._list = null;

			this._itemRendererMap = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testNoFactoryIDFunction():void
		{
			Assert.assertNull("Item renderer factoryID should be null if factoryIDFunction is null.", this.getItemRendererAt(0, 0).factoryID);
			Assert.assertNull("Item renderer factoryID should be null if factoryIDFunction is null.", this.getItemRendererAt(0, 1).factoryID);
			Assert.assertNull("Item renderer factoryID should be null if factoryIDFunction is null.", this.getItemRendererAt(0, 2).factoryID);
		}

		[Test]
		public function testOneArgumentFactoryIDFunction():void
		{
			this._list.factoryIDFunction = oneArgumentFactoryIDFunction;
			this._list.validate();
		}

		[Test]
		public function testThreeArgumentFactoryIDFunction():void
		{
			this._list.factoryIDFunction = threeArgumentFactoryIDFunction;
			this._list.validate();
		}

		[Test]
		public function testFactoryIDFunction():void
		{
			this._list.factoryIDFunction = factoryIDFunction;
			this._list.validate();
			Assert.assertNull("Item renderer factoryID not set to result of factoryIDFunction.", this.getItemRendererAt(0, 0).factoryID);
			Assert.assertNull("Item renderer factoryID not set to result of factoryIDFunction.", this.getItemRendererAt(0, 1).factoryID);
			var itemRenderer2:IGroupedListItemRenderer = this.getItemRendererAt(0, 2);
			Assert.assertStrictlyEquals("Item renderer factoryID not set to result of factoryIDFunction.", FACTORY_ONE, itemRenderer2.factoryID);
			Assert.assertTrue("Incorrect factory called to create item renderer.", itemRenderer2.styleNameList.contains(CUSTOM_STYLE_NAME));
		}

		[Test]
		public function testSetItemAtWithDifferentFactoryID():void
		{
			var itemToSet:Object = { label: "New", factory: 1 };
			this._list.factoryIDFunction = factoryIDFunction;
			this._list.validate();
			this._list.dataProvider.setItemAt(itemToSet, 0, 1);
			this._list.validate();
			var itemRenderer:IGroupedListItemRenderer = this.getItemRendererAt(0, 1);
			Assert.assertStrictlyEquals("Item renderer factoryID not changed to new result of factoryIDFunction after calling setItemAt().", FACTORY_ONE, itemRenderer.factoryID);
			Assert.assertStrictlyEquals("Item renderer data not changed with new result of factoryIDFunction after calling setItemAt().", itemToSet, itemRenderer.data);
		}

		[Test]
		public function testSetTypicalItemAtWithDifferentFactoryID():void
		{
			this._list.typicalItem = this._list.dataProvider.getItemAt(0);
			var itemToSet:Object = { label: "Replacement Item", factory: 1 };
			this._list.factoryIDFunction = factoryIDFunction;
			this._list.validate();
			this._list.dataProvider.setItemAt(itemToSet, 0, 0);
			this._list.validate();
			var itemRenderer:IGroupedListItemRenderer = this.getItemRendererAt(0, 0);
			Assert.assertStrictlyEquals("Typical item renderer factoryID not changed to new result of factoryIDFunction after calling setItemAt().", FACTORY_ONE, itemRenderer.factoryID);
			Assert.assertStrictlyEquals("Typical item renderer data not changed with new result of factoryIDFunction after calling setItemAt().", itemToSet, itemRenderer.data);
		}

		[Test]
		public function testSetItemAtWithDifferentFactoryIDAndRemoveItemBefore():void
		{
			var itemToSet:Object = { label: "Replacement Item", factory: 1 };
			this._list.factoryIDFunction = factoryIDFunction;
			this._list.validate();
			this._list.dataProvider.setItemAt(itemToSet, 0, 1);
			this._list.dataProvider.removeItemAt(0, 0);
			this._list.validate();
			var itemRenderer:IGroupedListItemRenderer = this.getItemRendererAt(0, 0);
			Assert.assertStrictlyEquals("Item renderer factoryID not changed to new result of factoryIDFunction after calling setItemAt() and removeItemAt() for previous item.", FACTORY_ONE, itemRenderer.factoryID);
			Assert.assertStrictlyEquals("Item renderer data not changed with new result of factoryIDFunction after calling setItemAt() and removeItemAt() for previous item.", itemToSet, itemRenderer.data);
		}

		[Test]
		public function testSetItemAtWithDifferentFactoryIDAndAddItemBefore():void
		{
			var itemToAdd:Object = { label: "Added Item", factory: 1 };
			var itemToSet:Object = { label: "Replacement Item", factory: 1 };
			this._list.factoryIDFunction = factoryIDFunction;
			this._list.validate();
			this._list.dataProvider.setItemAt(itemToSet, 0, 0);
			this._list.dataProvider.addItemAt(itemToAdd, 0, 0);
			this._list.validate();
			Assert.assertStrictlyEquals("factoryID of changed typical item not changed to result of factoryIDFunction.", FACTORY_ONE, this.getItemRendererAt(0, 0).factoryID);
			var itemRenderer1:IGroupedListItemRenderer = this.getItemRendererAt(0, 1);
			Assert.assertStrictlyEquals("Item renderer factoryID not changed to new result of factoryIDFunction after calling setItemAt() and addItemAt() for previous item.", FACTORY_ONE, itemRenderer1.factoryID);
			Assert.assertStrictlyEquals("Item renderer data not changed with new result of factoryIDFunction after calling setItemAt() and addItemAt() for previous item.", itemToSet, itemRenderer1.data);
		}

		[Test]
		public function testNewTypicalItemWithDifferentFactoryAndRemoveTypicalItemAfterDispose():void
		{
			var itemToSet:Object = { label: "Replacement Item", factory: 1 };
			this._list.factoryIDFunction = factoryIDFunction;
			this._list.validate();
			this._list.dataProvider.setItemAt(itemToSet, 0, 1);
			this._list.dataProvider.removeItemAt(0, 0);
			this._list.validate();

			var expectedItemRendererCount:int = 0;
			var groupCount:int = this._list.dataProvider.getLength();
			for(var i:int = 0; i < groupCount; i++)
			{
				expectedItemRendererCount += this._list.dataProvider.getLength(i);
			}

			var headerRendererCount:int = 0;
			var itemRendererCount:int = 0;
			this._list.addEventListener(FeathersEventType.RENDERER_REMOVE, function(event:Event, renderer:IFeathersControl):void
			{
				if(renderer is IGroupedListHeaderRenderer)
				{
					var headerRenderer:IGroupedListHeaderRenderer = IGroupedListHeaderRenderer(renderer);
					Assert.assertNotNull("Header renderer incorrectly has null owner during dispose().", headerRenderer.owner);
					Assert.assertNotNull("Header renderer incorrectly has null data during dispose().", headerRenderer.data);
					Assert.assertTrue("Header renderer incorrectly has negative group index during dispose().", headerRenderer.groupIndex >= 0);
					headerRendererCount++;
				}
				else if(renderer is IGroupedListItemRenderer)
				{
					var itemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(renderer);
					Assert.assertNotNull("Item renderer incorrectly has null owner during dispose().", itemRenderer.owner);
					Assert.assertNotNull("Item renderer incorrectly has null data during dispose().", itemRenderer.data);
					Assert.assertTrue("Item renderer incorrectly has negative group index during dispose().", itemRenderer.groupIndex >= 0);
					Assert.assertTrue("Item renderer incorrectly has negative item index during dispose().", itemRenderer.itemIndex >= 0);
					itemRendererCount++;
				}
			});
			this._list.dispose();
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_REMOVE not dispatched for all header renderers after dispose().", groupCount, headerRendererCount);
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_REMOVE not dispatched for all item renderers after dispose().", expectedItemRendererCount, itemRendererCount);
		}

		[Test]
		public function testFirstItemRendererFactoryWithFactoryIDFunction():void
		{
			this._list.firstItemRendererFactory = function():IGroupedListItemRenderer
			{
				return new DefaultGroupedListItemRenderer();
			};
			this._list.factoryIDFunction = factoryIDFunction;
			this._list.validate();

			var itemRenderer:IGroupedListItemRenderer = this.getItemRendererAt(0, 0);
			Assert.assertFalse("First item renderer factoryID incorrect when using factoryIDFunction and firstItemRendererFactory.",
				itemRenderer.factoryID === null);
		}

		[Test]
		public function testLastItemRendererFactoryWithFactoryIDFunction():void
		{
			this._list.lastItemRendererFactory = function():IGroupedListItemRenderer
			{
				return new DefaultGroupedListItemRenderer();
			};
			this._list.factoryIDFunction = factoryIDFunction;
			this._list.validate();

			//this one should have the ID for the lastItemRendererFactory
			var itemRenderer:IGroupedListItemRenderer = this.getItemRendererAt(2, 1);
			Assert.assertFalse("Last item renderer factoryID incorrect when using factoryIDFunction and lastItemRendererFactory (1).",
				itemRenderer.factoryID === null);

			//a non-null result from factoryIDFunction takes precedence, so
			//this one should not be from lastItemRendererFactory
			itemRenderer = this.getItemRendererAt(0, 2);
			Assert.assertStrictlyEquals("Last item renderer factoryID incorrect when using factoryIDFunction and lastItemRendererFactory (2).",
				FACTORY_ONE, itemRenderer.factoryID);
		}

		[Test]
		public function testSingleItemRendererFactoryWithFactoryIDFunction():void
		{
			this._list.singleItemRendererFactory = function():IGroupedListItemRenderer
			{
				return new DefaultGroupedListItemRenderer();
			};
			this._list.factoryIDFunction = factoryIDFunction;
			this._list.validate();

			var itemRenderer:IGroupedListItemRenderer = this.getItemRendererAt(1, 0);
			Assert.assertFalse("Single item renderer factoryID incorrect when using factoryIDFunction and singleItemRendererFactory.",
				itemRenderer.factoryID === null);
		}

		private function getItemRendererAt(groupIndex:int, itemIndex:int):IGroupedListItemRenderer
		{
			for(var item:Object in this._itemRendererMap)
			{
				var renderer:Object = this._itemRendererMap[item];
				if(renderer is IGroupedListItemRenderer)
				{
					var itemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(renderer);
					if(itemRenderer.groupIndex === groupIndex &&
							itemRenderer.itemIndex === itemIndex)
					{
						return itemRenderer;
					}
				}
			}
			return null;
		}

		private function list_rendererAddHandler(event:Event, renderer:Object):void
		{
			if(renderer is IGroupedListItemRenderer)
			{
				var itemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(renderer);
				this._itemRendererMap[itemRenderer.data] = itemRenderer;
			}
		}

		private function list_rendererRemoveHandler(event:Event, renderer:Object):void
		{
			if(renderer is IGroupedListItemRenderer)
			{
				var itemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(renderer);
				delete this._itemRendererMap[itemRenderer.data];
			}
		}

		private function factoryIDFunction(item:Object):String
		{
			if(item.factory === 1)
			{
				return FACTORY_ONE;
			}
			return null;
		}

		private function oneArgumentFactoryIDFunction(item:Object):String
		{
			Assert.assertNotNull("Item passed to factoryIDFunction should not be null.", item);
			return null;
		}

		private function threeArgumentFactoryIDFunction(item:Object, groupIndex:int, itemIndex:int):String
		{
			Assert.assertNotNull("Item passed to factoryIDFunction should not be null.", item);
			Assert.assertTrue("Group index passed to factoryIDFunction is out of range.", groupIndex >= 0 && groupIndex < this._list.dataProvider.getLength());
			Assert.assertTrue("Item index passed to factoryIDFunction is out of range.", itemIndex >= 0 && itemIndex < this._list.dataProvider.getLength(groupIndex));
			return null;
		}
	}
}


================================================
FILE: test/source/feathers/tests/GroupedListFocusTests.as
================================================
package feathers.tests
{
	import feathers.controls.GroupedList;
	import feathers.controls.renderers.DefaultGroupedListItemRenderer;
	import feathers.core.FocusManager;
	import feathers.data.HierarchicalCollection;

	import flash.events.KeyboardEvent;
	import flash.ui.KeyLocation;
	import flash.ui.Keyboard;

	import org.flexunit.Assert;

	import starling.display.Quad;
	import starling.events.Event;

	public class GroupedListFocusTests
	{
		private var _list:GroupedList;

		[Before]
		public function prepare():void
		{
			this._list = new GroupedList();
			this._list.dataProvider = new HierarchicalCollection(
			[
				{
					header: { label: "A" },
					children:
					[
						{label: "One"},
						{label: "Two"},
						{label: "Three"},
					]
				},
				{
					header: { label: "B" },
					children:
					[
						{label: "Four"},
						{label: "Five"},
						{label: "Six"},
					]
				},
				{
					header: { label: "C" },
					children:
					[
						{label: "Seven"},
					]
				}
			]);
			this._list.itemRendererFactory = function():DefaultGroupedListItemRenderer
			{
				var itemRenderer:DefaultGroupedListItemRenderer = new DefaultGroupedListItemRenderer();
				itemRenderer.defaultSkin = new Quad(200, 200);
				return itemRenderer;
			};
			TestFeathers.starlingRoot.addChild(this._list);
			this._list.validate();

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, true);
		}

		[After]
		public function cleanup():void
		{
			this._list.removeFromParent(true);
			this._list = null;

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
			Assert.assertFalse("FocusManager not disabled on cleanup.", FocusManager.isEnabledForStage(TestFeathers.starlingRoot.stage));
		}

		[Test]
		public function testNoTriggerWhenNoSelectedItem():void
		{
			FocusManager.focus = this._list;
			var hasTriggered:Boolean = false;
			var triggeredItem:Object = null;
			this._list.addEventListener(Event.TRIGGERED, function(event:Event, item:Object):void
			{
				hasTriggered = true;
				triggeredItem = item;
			});
			this._list.stage.starling.nativeStage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 32, Keyboard.SPACE, KeyLocation.STANDARD, false, false, false));
			this._list.stage.starling.nativeStage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, true, false, 32, Keyboard.SPACE, KeyLocation.STANDARD, false, false, false));
			Assert.assertFalse("Event.TRIGGERED incorrectly dispatched when no item is selected",
				hasTriggered);
		}

		[Test]
		public function testTriggered():void
		{
			this._list.setSelectedLocation(0, 1);
			FocusManager.focus = this._list;
			var hasTriggered:Boolean = false;
			var triggeredItem:Object = null;
			this._list.addEventListener(Event.TRIGGERED, function(event:Event, item:Object):void
			{
				hasTriggered = true;
				triggeredItem = item;
			});
			this._list.stage.starling.nativeStage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 32, Keyboard.SPACE, KeyLocation.STANDARD, false, false, false));
			this._list.stage.starling.nativeStage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, true, false, 32, Keyboard.SPACE, KeyLocation.STANDARD, false, false, false));
			Assert.assertTrue("Event.TRIGGERED must be dispatched on KeyboardEvent.KEY_DOWN with Keyboard.SPACE key code",
				hasTriggered);
			Assert.assertStrictlyEquals("Incorrect item passed to Event.TRIGGERED listener",
				this._list.dataProvider.getItemAt(0, 1), triggeredItem);
		}
	}
}

================================================
FILE: test/source/feathers/tests/GroupedListRendererAddRemoveTests.as
================================================
package feathers.tests
{
	import feathers.controls.GroupedList;
	import feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer;
	import feathers.controls.renderers.DefaultGroupedListItemRenderer;
	import feathers.controls.renderers.IGroupedListHeaderRenderer;
	import feathers.controls.renderers.IGroupedListItemRenderer;
	import feathers.core.IFeathersControl;
	import feathers.data.HierarchicalCollection;
	import feathers.events.FeathersEventType;

	import flexunit.framework.Assert;

	import starling.display.Quad;
	import starling.events.Event;

	public class GroupedListRendererAddRemoveTests
	{
		private var _list:GroupedList;

		[Before]
		public function prepare():void
		{
			this._list = new GroupedList();
			this._list.dataProvider = new HierarchicalCollection(
			[
				{
					header: { label: "A" },
					children:
					[
						{label: "One"},
						{label: "Two"},
						{label: "Three"},
					]
				},
				{
					header: { label: "B" },
					children:
					[
						{label: "Four"},
						{label: "Five"},
						{label: "Six"},
					]
				}
			]);
			this._list.itemRendererFactory = function():DefaultGroupedListItemRenderer
			{
				var itemRenderer:DefaultGroupedListItemRenderer = new DefaultGroupedListItemRenderer();
				itemRenderer.defaultSkin = new Quad(200, 200);
				return itemRenderer;
			};
			this._list.headerRendererFactory = function():DefaultGroupedListHeaderOrFooterRenderer
			{
				var headerRenderer:DefaultGroupedListHeaderOrFooterRenderer = new DefaultGroupedListHeaderOrFooterRenderer();
				headerRenderer.backgroundSkin = new Quad(200, 200);
				return headerRenderer;
			};
			TestFeathers.starlingRoot.addChild(this._list);
		}

		[After]
		public function cleanup():void
		{
			this._list.removeFromParent(true);
			this._list = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testRendererAddEventWithDataProvider():void
		{
			var headerRendererCount:int = 0;
			var itemRendererCount:int = 0;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event, renderer:IFeathersControl):void
			{
				if(renderer is IGroupedListHeaderRenderer)
				{
					headerRendererCount++;
				}
				else if(renderer is IGroupedListItemRenderer)
				{
					itemRendererCount++;
				}
			});
			this._list.validate();
			
			var expectedItemRendererCount:int = 0;
			var groupCount:int = this._list.dataProvider.getLength();
			for(var i:int = 0; i < groupCount; i++)
			{
				expectedItemRendererCount += this._list.dataProvider.getLength(i);
			}

			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_ADD not dispatched for all visible headers.", groupCount, headerRendererCount);
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_ADD not dispatched for all visible headers.", expectedItemRendererCount, itemRendererCount);
		}

		[Test]
		public function testRendererAddEventAfterAddItem():void
		{
			var groupIndex:int = 1;
			var itemIndex:int = 1;
			this._list.validate();
			var addedRenderer:Boolean = false;
			var addedGroupIndex:int = -1;
			var addedItemIndex:int = -1;
			function rendererAddListener(event:Event, itemRenderer:IGroupedListItemRenderer):void
			{
				addedRenderer = true;
				addedGroupIndex = itemRenderer.groupIndex;
				addedItemIndex = itemRenderer.itemIndex;
			}
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, rendererAddListener);
			this._list.dataProvider.addItemAt({label: "New Item"}, groupIndex, itemIndex);
			this._list.validate();
			this._list.removeEventListener(FeathersEventType.RENDERER_ADD, rendererAddListener);
			Assert.assertTrue("FeathersEventType.RENDERER_ADD not dispatched after addItemAt().", addedRenderer);
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_ADD not dispatched with correct item renderer after addItemAt().", groupIndex, addedGroupIndex);
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_ADD not dispatched with correct item renderer after addItemAt().", itemIndex, addedItemIndex);
		}

		[Test]
		public function testRendererRemoveEventAfterRemoveItemAt():void
		{
			var groupIndex:int = 1;
			var itemIndex:int = 1;
			this._list.validate();
			var removedRenderer:Boolean = false;
			var removedGroupIndex:int = -1;
			var removedItemIndex:int = -1;
			function rendererRemoveListener(event:Event, itemRenderer:IGroupedListItemRenderer):void
			{
				removedRenderer = true;
				removedGroupIndex = itemRenderer.groupIndex;
				removedItemIndex = itemRenderer.itemIndex;
			}
			this._list.addEventListener(FeathersEventType.RENDERER_REMOVE, rendererRemoveListener);
			this._list.dataProvider.removeItemAt(groupIndex, itemIndex);
			this._list.validate();
			this._list.removeEventListener(FeathersEventType.RENDERER_REMOVE, rendererRemoveListener);
			Assert.assertTrue("FeathersEventType.RENDERER_REMOVE not dispatched after removeItemAt().", removedRenderer);
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_REMOVE not dispatched with correct item renderer after removeItemAt().", groupIndex, removedGroupIndex);
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_REMOVE not dispatched with correct item renderer after removeItemAt().", itemIndex, removedItemIndex);
		}

		[Test]
		public function testRendererAddAndRemoveEventsAfterSetItemAt():void
		{
			var groupIndex:int = 1;
			var itemIndex:int = 1;
			this._list.validate();
			var addedRenderer:Boolean = false;
			var addedGroupIndex:int = -1;
			var addedItemIndex:int = -1;
			function rendererAddListener(event:Event, itemRenderer:IGroupedListItemRenderer):void
			{
				Assert.assertTrue("FeathersEventType.RENDERER_REMOVE not dispatched before FeathersEventType.RENDERER_ADD when calling setItemAt().", removedRenderer);
				addedRenderer = true;
				addedGroupIndex = itemRenderer.groupIndex;
				addedItemIndex = itemRenderer.itemIndex;
			}
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, rendererAddListener);
			var removedRenderer:Boolean = false;
			var removedGroupIndex:int = -1;
			var removedItemIndex:int = -1;
			function rendererRemoveListener(event:Event, itemRenderer:IGroupedListItemRenderer):void
			{
				removedRenderer = true;
				removedGroupIndex = itemRenderer.groupIndex;
				removedItemIndex = itemRenderer.itemIndex;
			}
			this._list.addEventListener(FeathersEventType.RENDERER_REMOVE, rendererRemoveListener);
			this._list.dataProvider.setItemAt({label: "New Item"}, groupIndex, itemIndex);
			this._list.validate();
			this._list.removeEventListener(FeathersEventType.RENDERER_ADD, rendererAddListener);
			this._list.removeEventListener(FeathersEventType.RENDERER_REMOVE, rendererRemoveListener);
			Assert.assertTrue("FeathersEventType.RENDERER_REMOVE not dispatched after setItemAt().", removedRenderer);
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_REMOVE not dispatched with correct item renderer after setItemAt().", groupIndex, removedGroupIndex);
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_REMOVE not dispatched with correct item renderer after setItemAt().", itemIndex, removedItemIndex);
			Assert.assertTrue("FeathersEventType.RENDERER_ADD not dispatched after setItemAt().", addedRenderer);
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_ADD not dispatched with correct item renderer after setItemAt().", groupIndex, addedGroupIndex);
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_ADD not dispatched with correct item renderer after setItemAt().", itemIndex, addedItemIndex);
		}

		[Test]
		public function testRendererAddAndRemoveEventAfterChangeTypicalItemFromDefaultToCustom():void
		{
			this._list.validate();
			this._list.typicalItem = { label: "Typical Item" };
			var addedRenderer:Boolean = false;
			function rendererAddListener(event:Event, itemRenderer:Object):void
			{
				addedRenderer = true;
			}
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, rendererAddListener);
			var removedRenderer:Boolean = false;
			function rendererRemoveListener(event:Event, itemRenderer:Object):void
			{
				removedRenderer = true;
			}
			this._list.addEventListener(FeathersEventType.RENDERER_REMOVE, rendererRemoveListener);
			this._list.validate();
			Assert.assertFalse("FeathersEventType.RENDERER_REMOVE incorrectly dispatched after change typicalItem from default to custom.", removedRenderer);
			Assert.assertFalse("FeathersEventType.RENDERER_ADD incorrectly dispatched after change typicalItem from default to custom.", addedRenderer);
		}

		[Test]
		public function testRendererRemoveEventsAfterDispose():void
		{
			this._list.validate();

			var expectedItemRendererCount:int = 0;
			var groupCount:int = this._list.dataProvider.getLength();
			for(var i:int = 0; i < groupCount; i++)
			{
				expectedItemRendererCount += this._list.dataProvider.getLength(i);
			}
			
			var headerRendererCount:int = 0;
			var itemRendererCount:int = 0;
			this._list.addEventListener(FeathersEventType.RENDERER_REMOVE, function(event:Event, renderer:IFeathersControl):void
			{
				if(renderer is IGroupedListHeaderRenderer)
				{
					var headerRenderer:IGroupedListHeaderRenderer = IGroupedListHeaderRenderer(renderer);
					Assert.assertNotNull("Header renderer incorrectly has null owner during dispose().", headerRenderer.owner);
					Assert.assertNotNull("Header renderer incorrectly has null data during dispose().", headerRenderer.data);
					Assert.assertTrue("Header renderer incorrectly has negative group index during dispose().", headerRenderer.groupIndex >= 0);
					headerRendererCount++;
				}
				else if(renderer is IGroupedListItemRenderer)
				{
					var itemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(renderer);
					Assert.assertNotNull("Item renderer incorrectly has null owner during dispose().", itemRenderer.owner);
					Assert.assertNotNull("Item renderer incorrectly has null data during dispose().", itemRenderer.data);
					Assert.assertTrue("Item renderer incorrectly has negative group index during dispose().", itemRenderer.groupIndex >= 0);
					Assert.assertTrue("Item renderer incorrectly has negative item index during dispose().", itemRenderer.itemIndex >= 0);
					itemRendererCount++;
				}
			});
			this._list.dispose();
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_REMOVE not dispatched for all header renderers after dispose().", groupCount, headerRendererCount);
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_REMOVE not dispatched for all item renderers after dispose().", expectedItemRendererCount, itemRendererCount);
		}
	}
}


================================================
FILE: test/source/feathers/tests/GroupedListTests.as
================================================
package feathers.tests
{
	import feathers.controls.GroupedList;
	import feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer;
	import feathers.controls.renderers.DefaultGroupedListItemRenderer;
	import feathers.controls.renderers.IGroupedListHeaderRenderer;
	import feathers.controls.renderers.IGroupedListItemRenderer;
	import feathers.data.ArrayHierarchicalCollection;
	import feathers.events.FeathersEventType;
	import feathers.tests.supportClasses.AssertViewPortBoundsLayout;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class GroupedListTests
	{
		private var _list:GroupedList;

		[Before]
		public function prepare():void
		{
			this._list = new GroupedList();
			this._list.dataProvider = new ArrayHierarchicalCollection(
			[
				{
					header: { label: "A" },
					children:
					[
						{label: "One"},
						{label: "Two"},
						{label: "Three"},
					]
				},
				{
					header: { label: "B" },
					children:
					[
						{label: "Four"},
						{label: "Five"},
						{label: "Six"},
					]
				},
				{
					header: { label: "C" },
					children:
					[
						{label: "Seven"},
					]
				}
			]);
			this._list.itemRendererFactory = function():DefaultGroupedListItemRenderer
			{
				var itemRenderer:DefaultGroupedListItemRenderer = new DefaultGroupedListItemRenderer();
				itemRenderer.defaultSkin = new Quad(200, 200);
				return itemRenderer;
			};
			this._list.headerRendererFactory = function():DefaultGroupedListHeaderOrFooterRenderer
			{
				var headerRenderer:DefaultGroupedListHeaderOrFooterRenderer = new DefaultGroupedListHeaderOrFooterRenderer();
				headerRenderer.backgroundSkin = new Quad(200, 200);
				return headerRenderer;
			};
			TestFeathers.starlingRoot.addChild(this._list);
			this._list.validate();
		}

		[After]
		public function cleanup():void
		{
			this._list.removeFromParent(true);
			this._list = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testNullDataProvider():void
		{
			this._list.dataProvider = null;
			this._list.validate();
		}

		[Test]
		public function testNullDataProviderWithTypicalItem():void
		{
			this._list.dataProvider = null;
			this._list.typicalItem = { label: "Typical Item" };
			this._list.validate();
		}

		[Test]
		public function testProgrammaticSelectionChange():void
		{
			var beforeSelectedGroupIndex:int = this._list.selectedGroupIndex;
			var beforeSelectedItemIndex:int = this._list.selectedItemIndex;
			var beforeSelectedItem:Object = this._list.selectedItem;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.setSelectedLocation(0, 1);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The selectedGroupIndex property was not changed",
				beforeSelectedGroupIndex === this._list.selectedGroupIndex);
			Assert.assertFalse("The selectedItemIndex property was not changed",
				beforeSelectedItemIndex === this._list.selectedItemIndex);
			Assert.assertFalse("The selectedItem property was not changed",
				beforeSelectedItem === this._list.selectedItem);
		}

		[Test]
		public function testInteractiveSelectionChange():void
		{
			var beforeSelectedGroupIndex:int = this._list.selectedGroupIndex;
			var beforeSelectedItemIndex:int = this._list.selectedItemIndex;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(10, 410);
			var target:DisplayObject = this._list.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The selectedGroupIndex property was not changed",
				beforeSelectedGroupIndex === this._list.selectedGroupIndex);
			Assert.assertFalse("The selectedItemIndex property was not changed",
				beforeSelectedItemIndex === this._list.selectedItemIndex);
		}

		[Test]
		public function testRemoveItemBeforeSelectedItemIndex():void
		{
			this._list.setSelectedLocation(1, 1);
			var beforeSelectedGroupIndex:int = this._list.selectedGroupIndex;
			var beforeSelectedItemIndex:int = this._list.selectedItemIndex;
			var beforeSelectedItem:Object = this._list.selectedItem;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.removeItemAt(1, 0);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedGroupIndex property was incorrectly changed",
				beforeSelectedGroupIndex, this._list.selectedGroupIndex);
			Assert.assertStrictlyEquals("The selectedItemIndex property was not changed",
				beforeSelectedItemIndex - 1, this._list.selectedItemIndex);
			Assert.assertStrictlyEquals("The selectedItem property was incorrectly changed",
				beforeSelectedItem, this._list.selectedItem);
		}

		[Test]
		public function testRemoveItemAfterSelectedItemIndex():void
		{
			this._list.setSelectedLocation(1, 1);
			var beforeSelectedGroupIndex:int = this._list.selectedGroupIndex;
			var beforeSelectedItemIndex:int = this._list.selectedItemIndex;
			var beforeSelectedItem:Object = this._list.selectedItem;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.removeItemAt(1, 2);
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedGroupIndex property was incorrectly changed",
				beforeSelectedGroupIndex, this._list.selectedGroupIndex);
			Assert.assertStrictlyEquals("The selectedItemIndex property was incorrectly changed",
				beforeSelectedItemIndex, this._list.selectedItemIndex);
			Assert.assertStrictlyEquals("The selectedItem property was incorrectly changed",
				beforeSelectedItem, this._list.selectedItem);
		}

		[Test]
		public function testRemoveSelectedItemIndex():void
		{
			this._list.setSelectedLocation(1, 1);
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.removeItemAt(1, 1);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed to -1",
				-1, this._list.selectedGroupIndex);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed to -1",
				-1, this._list.selectedItemIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not changed to null",
				null, this._list.selectedItem);
		}

		[Test]
		public function testReplaceItemAtSelectedItemIndex():void
		{
			this._list.setSelectedLocation(1, 1);
			var beforeSelectedGroupIndex:int = this._list.selectedGroupIndex;
			var beforeSelectedItemIndex:int = this._list.selectedItemIndex;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.setItemAt({ label: "New Item" }, beforeSelectedGroupIndex, beforeSelectedItemIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedGroupIndex property was not changed to -1",
				-1, this._list.selectedGroupIndex);
			Assert.assertStrictlyEquals("The selectedItemIndex property was not changed to -1",
				-1, this._list.selectedItemIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not changed to null",
				null, this._list.selectedItem);
		}

		[Test]
		public function testDeselectAllOnNullDataProvider():void
		{
			this._list.setSelectedLocation(1, 1);
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider = null;
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedGroupIndex property was not set to -1",
				-1, this._list.selectedGroupIndex);
			Assert.assertStrictlyEquals("The selectedItemIndex property was not set to -1",
				-1, this._list.selectedItemIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not set to null",
				null, this._list.selectedItem);
		}

		[Test]
		public function testDeselectAllOnDataProviderRemoveAll():void
		{
			this._list.setSelectedLocation(1, 1);
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.removeAll();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedGroupIndex property was not set to -1",
				-1, this._list.selectedGroupIndex);
			Assert.assertStrictlyEquals("The selectedItemIndex property was not set to -1",
				-1, this._list.selectedItemIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not set to null",
				null, this._list.selectedItem);
		}

		[Test]
		public function testAddItemBeforeSelectedItemIndex():void
		{
			this._list.setSelectedLocation(1, 1);
			var hasChanged:Boolean = false;
			var beforeSelectedGroupIndex:int = this._list.selectedGroupIndex;
			var beforeSelectedItemIndex:int = this._list.selectedItemIndex;
			var beforeSelectedItem:Object = this._list.selectedItem;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.addItemAt({label: "New Item"}, 1, 0);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedGroupIndex property was incorrectly changed",
				beforeSelectedGroupIndex, this._list.selectedGroupIndex);
			Assert.assertStrictlyEquals("The selectedItemIndex property was not changed",
				beforeSelectedItemIndex + 1, this._list.selectedItemIndex);
			Assert.assertStrictlyEquals("The selectedItem property was incorrectly changed",
				beforeSelectedItem, this._list.selectedItem);
		}

		[Test]
		public function testAddGroupBeforeSelectedGroupIndex():void
		{
			this._list.setSelectedLocation(1, 1);
			var hasChanged:Boolean = false;
			var beforeSelectedGroupIndex:int = this._list.selectedGroupIndex;
			var beforeSelectedItemIndex:int = this._list.selectedItemIndex;
			var beforeSelectedItem:Object = this._list.selectedItem;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.addItemAt(
			{
				header: "New Group",
				children:
				[
					{ label: "New Item 1" },
					{ label: "New Item 2" },
				]
			}, 0);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The selectedGroupIndex property was not changed",
				beforeSelectedGroupIndex === this._list.selectedGroupIndex);
			Assert.assertStrictlyEquals("The selectedItemIndex property was incorrectly changed",
				beforeSelectedItemIndex, this._list.selectedItemIndex);
			Assert.assertStrictlyEquals("The selectedItem property was incorrectly changed",
				beforeSelectedItem, this._list.selectedItem);
		}

		[Test]
		public function testRemoveGroupBeforeSelectedGroupIndex():void
		{
			this._list.setSelectedLocation(1, 1);
			var beforeSelectedGroupIndex:int = this._list.selectedGroupIndex;
			var beforeSelectedItemIndex:int = this._list.selectedItemIndex;
			var beforeSelectedItem:Object = this._list.selectedItem;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.removeItemAt(0);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The selectedGroupIndex property was not changed",
				beforeSelectedGroupIndex === this._list.selectedGroupIndex);
			Assert.assertStrictlyEquals("The selectedItemIndex property was incorrectly changed",
				beforeSelectedItemIndex, this._list.selectedItemIndex);
			Assert.assertStrictlyEquals("The selectedItem property was incorrectly changed",
				beforeSelectedItem, this._list.selectedItem);
		}

		[Test]
		public function testRemoveGroupAfterSelectedGroupIndex():void
		{
			this._list.setSelectedLocation(1, 1);
			var beforeSelectedGroupIndex:int = this._list.selectedGroupIndex;
			var beforeSelectedItemIndex:int = this._list.selectedItemIndex;
			var beforeSelectedItem:Object = this._list.selectedItem;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.removeItemAt(2);
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedGroupIndex property was incorrectly changed",
				beforeSelectedGroupIndex, this._list.selectedGroupIndex);
			Assert.assertStrictlyEquals("The selectedItemIndex property was incorrectly changed",
				beforeSelectedItemIndex, this._list.selectedItemIndex);
			Assert.assertStrictlyEquals("The selectedItem property was incorrectly changed",
				beforeSelectedItem, this._list.selectedItem);
		}

		[Test]
		public function testRemoveGroupAtSelectedGroupIndex():void
		{
			this._list.setSelectedLocation(1, 1);
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.removeItemAt(1);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed to -1",
				-1, this._list.selectedGroupIndex);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed to -1",
				-1, this._list.selectedItemIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not changed to null",
				null, this._list.selectedItem);
		}

		[Test]
		public function testReplaceGroupAtSelectedGroupIndex():void
		{
			this._list.setSelectedLocation(1, 1);
			var beforeSelectedGroupIndex:int = this._list.selectedGroupIndex;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.setItemAt(
			{
				header: "New Group",
				children:
				[
					{ label: "New Item 1" },
					{ label: "New Item 2" },
				]
			}, beforeSelectedGroupIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedGroupIndex property was not changed to -1",
				-1, this._list.selectedGroupIndex);
			Assert.assertStrictlyEquals("The selectedItemIndex property was not changed to -1",
				-1, this._list.selectedItemIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not changed to null",
				null, this._list.selectedItem);
		}

		[Test]
		public function testDisposeWithoutChangeEvent():void
		{
			this._list.setSelectedLocation(1, 1);
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dispose();
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched", hasChanged);
		}

		[Test]
		public function testFirstItemRendererFactoryWithMultipleItemsInGroup():void
		{
			var firstItemName:String = "first-item";
			this._list.firstItemRendererFactory = function():DefaultGroupedListItemRenderer
			{
				var itemRenderer:DefaultGroupedListItemRenderer = _list.itemRendererFactory();
				itemRenderer.name = firstItemName;
				return itemRenderer;
			};
			var usedFirstItemRendererFactory:Boolean = false;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event):void
			{
				if(!(event.data is IGroupedListItemRenderer))
				{
					return;
				}
				var itemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(event.data);
				if(itemRenderer.groupIndex == 1 && itemRenderer.itemIndex == 0 &&
					itemRenderer.name === firstItemName)
				{
					usedFirstItemRendererFactory = true;
				}
			})
			this._list.validate();
			Assert.assertTrue("firstItemRendererFactory not used when data provider has multiple items in group", usedFirstItemRendererFactory);
		}

		[Test]
		public function testCustomFirstItemRendererStyleNameWithMultipleItemsInGroup():void
		{
			var firstStyleName:String = "custom-first-item";
			this._list.customFirstItemRendererStyleName = firstStyleName;
			var containsFirstItemRendererStyleName:Boolean = false;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event):void
			{
				if(!(event.data is IGroupedListItemRenderer))
				{
					return;
				}
				var itemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(event.data);
				if(itemRenderer.groupIndex == 1 && itemRenderer.itemIndex == 0 &&
					itemRenderer.styleNameList.contains(firstStyleName))
				{
					containsFirstItemRendererStyleName = true;
				}
			})
			this._list.validate();
			Assert.assertTrue("customFirstItemRendererStyleName not used when data provider has multiple items in group", containsFirstItemRendererStyleName);
		}

		[Test]
		public function testLastItemRendererFactoryWithMultipleItemsInGroup():void
		{
			var lastItemName:String = "last-item";
			this._list.lastItemRendererFactory = function():DefaultGroupedListItemRenderer
			{
				var itemRenderer:DefaultGroupedListItemRenderer = _list.itemRendererFactory();
				itemRenderer.name = lastItemName;
				return itemRenderer;
			};
			var usedLastItemRendererFactory:Boolean = false;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event):void
			{
				if(!(event.data is IGroupedListItemRenderer))
				{
					return;
				}
				var itemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(event.data);
				if(itemRenderer.groupIndex === 1 && itemRenderer.itemIndex === 2 &&
					itemRenderer.name === lastItemName)
				{
					usedLastItemRendererFactory = true;
				}
			})
			this._list.validate();
			Assert.assertTrue("lastItemRendererFactory not used when data provider has multiple items in group", usedLastItemRendererFactory);
		}

		[Test]
		public function testCustomLastItemRendererStyleNameWithMultipleItemsInGroup():void
		{
			var lastStyleName:String = "custom-last-item";
			this._list.customLastItemRendererStyleName = lastStyleName;
			var containsLastItemRendererStyleName:Boolean = false;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event):void
			{
				if(!(event.data is IGroupedListItemRenderer))
				{
					return;
				}
				var itemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(event.data);
				if(itemRenderer.groupIndex === 1 && itemRenderer.itemIndex === 2 &&
					itemRenderer.styleNameList.contains(lastStyleName))
				{
					containsLastItemRendererStyleName = true;
				}
			})
			this._list.validate();
			Assert.assertTrue("customLastItemRendererStyleName not used when data provider has multiple items in group", containsLastItemRendererStyleName);
		}

		[Test]
		public function testFirstItemRendererFactoryWithOneItemAndCustomLastItemRendererFactory():void
		{
			var firstItemName:String = "first-item";
			var lastItemName:String = "last-item";
			this._list.firstItemRendererFactory = function():DefaultGroupedListItemRenderer
			{
				var itemRenderer:DefaultGroupedListItemRenderer = _list.itemRendererFactory();
				itemRenderer.name = firstItemName;
				return itemRenderer;
			};
			this._list.lastItemRendererFactory = function():DefaultGroupedListItemRenderer
			{
				var itemRenderer:DefaultGroupedListItemRenderer = _list.itemRendererFactory();
				itemRenderer.name = lastItemName;
				return itemRenderer;
			};
			var usedFirstItemRendererFactory:Boolean = false;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event):void
			{
				if(!(event.data is IGroupedListItemRenderer))
				{
					return;
				}
				var itemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(event.data);
				if(itemRenderer.groupIndex == 2 && itemRenderer.itemIndex == 0 &&
					itemRenderer.name === firstItemName)
				{
					usedFirstItemRendererFactory = true;
				}
			})
			this._list.validate();
			Assert.assertTrue("firstItemRendererFactory not used when data provider has only one item in group and lastItemRendererFactory is defined", usedFirstItemRendererFactory);
		}

		[Test]
		public function testCustomFirstItemRendererStyleNameWithOneItemAndCustomLastItemRendererStyleName():void
		{
			var firstStyleName:String = "custom-first-item";
			var lastStyleName:String = "custom-last-item";
			this._list.customFirstItemRendererStyleName = firstStyleName;
			this._list.customLastItemRendererStyleName = lastStyleName;
			var containsFirstItemRendererStyleName:Boolean = false;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event):void
			{
				if(!(event.data is IGroupedListItemRenderer))
				{
					return;
				}
				var itemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(event.data);
				if(itemRenderer.groupIndex == 2 && itemRenderer.itemIndex == 0 &&
					itemRenderer.styleNameList.contains(firstStyleName))
				{
					containsFirstItemRendererStyleName = true;
				}
			})
			this._list.validate();
			Assert.assertTrue("customFirstItemRendererStyleName not used when data provider has only one item in group and customLastItemRendererStyleName is defined", containsFirstItemRendererStyleName);
		}

		[Test]
		public function testSingleItemRendererFactoryWithOneItemAndOtherFactories():void
		{
			var firstItemName:String = "first-item";
			var lastItemName:String = "last-item";
			var singleItemName:String = "single-item";
			this._list.firstItemRendererFactory = function():DefaultGroupedListItemRenderer
			{
				var itemRenderer:DefaultGroupedListItemRenderer = _list.itemRendererFactory();
				itemRenderer.name = firstItemName;
				return itemRenderer;
			};
			this._list.lastItemRendererFactory = function():DefaultGroupedListItemRenderer
			{
				var itemRenderer:DefaultGroupedListItemRenderer = _list.itemRendererFactory();
				itemRenderer.name = lastItemName;
				return itemRenderer;
			};
			this._list.singleItemRendererFactory = function():DefaultGroupedListItemRenderer
			{
				var itemRenderer:DefaultGroupedListItemRenderer = _list.itemRendererFactory();
				itemRenderer.name = singleItemName;
				return itemRenderer;
			};
			var usedSingleItemRendererFactory:Boolean = false;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event):void
			{
				if(!(event.data is IGroupedListItemRenderer))
				{
					return;
				}
				var itemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(event.data);
				if(itemRenderer.groupIndex == 2 && itemRenderer.itemIndex == 0 &&
					itemRenderer.name === singleItemName)
				{
					usedSingleItemRendererFactory = true;
				}
			})
			this._list.validate();
			Assert.assertTrue("singleItemRendererFactory not used when data provider has only one item in group and firstItemRendererFactory and lastItemRendererFactory are defined", singleItemName);
		}

		[Test]
		public function testCustomSingleItemRendererStyleNameWithOneItemAndOtherStyleNames():void
		{
			var firstStyleName:String = "custom-first-item";
			var lastStyleName:String = "custom-last-item";
			var singleStyleName:String = "custom-single-item";
			this._list.customFirstItemRendererStyleName = firstStyleName;
			this._list.customLastItemRendererStyleName = lastStyleName;
			this._list.customSingleItemRendererStyleName = singleStyleName;
			var containsSingleItemRendererStyleName:Boolean = false;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event):void
			{
				if(!(event.data is IGroupedListItemRenderer))
				{
					return;
				}
				var itemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(event.data);
				if(itemRenderer.groupIndex == 2 && itemRenderer.itemIndex == 0 &&
					itemRenderer.styleNameList.contains(singleStyleName))
				{
					containsSingleItemRendererStyleName = true;
				}
			})
			this._list.validate();
			Assert.assertTrue("containsSingleItemRendererStyleName not used when data provider has only one item in group and customFirstItemRendererStyleName or customLastItemRendererStyleName are defined", containsSingleItemRendererStyleName);
		}

		[Test]
		public function testLastItemRendererFactoryWithOneItem():void
		{
			var componentName:String = "last-item";
			this._list.lastItemRendererFactory = function():DefaultGroupedListItemRenderer
			{
				var itemRenderer:DefaultGroupedListItemRenderer = _list.itemRendererFactory();
				itemRenderer.name = componentName;
				return itemRenderer;
			};
			var usedLastItemRendererFactory:Boolean = false;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event):void
			{
				if(!(event.data is IGroupedListItemRenderer))
				{
					return;
				}
				var itemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(event.data);
				if(itemRenderer.groupIndex == 2 && itemRenderer.itemIndex == 0 &&
					itemRenderer.name === componentName)
				{
					usedLastItemRendererFactory = true;
				}
			})
			this._list.validate();
			Assert.assertTrue("lastItemRendererFactory not used when data provider has only one item in group and neither firstItemRendererFactory or singleItemRendererFactory are defined", usedLastItemRendererFactory);
		}

		[Test]
		public function testCustomLastItemRendererStyleNameWithOneItem():void
		{
			var styleName:String = "custom-last-item";
			this._list.customLastItemRendererStyleName = styleName;
			var containsLastItemRendererStyleName:Boolean = false;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event):void
			{
				if(!(event.data is IGroupedListItemRenderer))
				{
					return;
				}
				var itemRenderer:IGroupedListItemRenderer = IGroupedListItemRenderer(event.data);
				if(itemRenderer.groupIndex == 2 && itemRenderer.itemIndex == 0 &&
					itemRenderer.styleNameList.contains(styleName))
				{
					containsLastItemRendererStyleName = true;
				}
			})
			this._list.validate();
			Assert.assertTrue("customLastItemRendererStyleName not used when data provider has only one item in group and neither customFirstItemRendererStyleName or customSingleItemRendererStyleName are defined", containsLastItemRendererStyleName);
		}

		[Test]
		public function testItemToItemRenderer():void
		{
			this._list.height = 220;
			this._list.validate();
			var item00:Object = this._list.dataProvider.getItemAt(0, 0);
			var itemRenderer00:IGroupedListItemRenderer = this._list.itemToItemRenderer(item00);
			var item01:Object = this._list.dataProvider.getItemAt(0, 1);
			var itemRenderer01:IGroupedListItemRenderer = this._list.itemToItemRenderer(item01);
			var item20:Object = this._list.dataProvider.getItemAt(2, 0);
			var itemRenderer20:IGroupedListItemRenderer = this._list.itemToItemRenderer(item20);
			Assert.assertNotNull("itemToItemRenderer() incorrectly returned null for item at index 0,0 that should have an item renderer", itemRenderer00);
			Assert.assertStrictlyEquals("Item renderer returned by itemToItemRenderer() has incorrect data", item00, itemRenderer00.data);
			Assert.assertStrictlyEquals("Item renderer returned by itemToItemRenderer() has incorrect group index", 0, itemRenderer00.groupIndex);
			Assert.assertStrictlyEquals("Item renderer returned by itemToItemRenderer() has incorrect item index", 0, itemRenderer00.itemIndex);
			Assert.assertNotNull("itemToItemRenderer() incorrectly returned null for item at index 0,1 that should have an item renderer", itemRenderer01);
			Assert.assertStrictlyEquals("Item renderer returned by itemToItemRenderer() has incorrect data", item01, itemRenderer01.data);
			Assert.assertStrictlyEquals("Item renderer returned by itemToItemRenderer() has incorrect group index", 0, itemRenderer01.groupIndex);
			Assert.assertStrictlyEquals("Item renderer returned by itemToItemRenderer() has incorrect item index", 1, itemRenderer01.itemIndex);
			Assert.assertNull("itemToItemRenderer() incorrectly returned item renderer for item that should not have one", itemRenderer20);
		}

		[Test]
		public function testHeaderDataToHeaderRenderer():void
		{
			this._list.height = 20;
			this._list.validate();
			var group0:Object = this._list.dataProvider.getItemAt(0);
			var header0:Object = this._list.groupToHeaderData(group0);
			var headerRenderer0:IGroupedListHeaderRenderer = this._list.headerDataToHeaderRenderer(header0);
			var group1:Object = this._list.dataProvider.getItemAt(1);
			var header1:Object = this._list.groupToHeaderData(group1);
			var headerRenderer1:IGroupedListHeaderRenderer = this._list.headerDataToHeaderRenderer(header1);
			Assert.assertNotNull("headerDataToHeaderRenderer() incorrectly returned null for header at group index 0", headerRenderer0);
			Assert.assertStrictlyEquals("Header renderer returned by headerDataToHeaderRenderer() has incorrect header data", header0, headerRenderer0.data);
			Assert.assertStrictlyEquals("Header renderer returned by headerDataToHeaderRenderer() has incorrect group index", 0, headerRenderer0.groupIndex);
			Assert.assertNull("headerDataToHeaderRenderer() incorrectly returned header renderer for header data that should not have one", headerRenderer1);
		}

		[Test]
		public function testGroupToHeaderData():void
		{
			var rawData:Array = ArrayHierarchicalCollection(this._list.dataProvider).arrayData;
			var group0:Object = this._list.dataProvider.getItemAt(0);
			var header0:Object = this._list.groupToHeaderData(group0);
			var group1:Object = this._list.dataProvider.getItemAt(1);
			var header1:Object = this._list.groupToHeaderData(group1);
			Assert.assertStrictlyEquals("groupToHeaderData() incorrectly returned wrong header data for index 0", header0, rawData[0].header);
			Assert.assertStrictlyEquals("groupToHeaderData() incorrectly returned wrong header data for index 1", header1, rawData[1].header);
		}

		[Test]
		public function testNoErrorOnRemoveItemWithFirstItemRendererFactory():void
		{
			this._list.firstItemRendererFactory = function():DefaultGroupedListItemRenderer
			{
				return _list.itemRendererFactory();
			};
			this._list.validate();
			this._list.dataProvider.removeItemAt(1, 0);
			this._list.validate();
		}

		[Test]
		public function testNoErrorOnRemoveItemWithLastItemRendererFactory():void
		{
			this._list.lastItemRendererFactory = function():DefaultGroupedListItemRenderer
			{
				return _list.itemRendererFactory();
			};
			this._list.validate();
			this._list.dataProvider.removeItemAt(0, 2);
			this._list.validate();
		}

		[Test]
		public function testCustomFirstItemRendererStyleNameWithoutFirstItemRendererFactory():void
		{
			var firstStyleName:String = "custom-first-item";
			this._list.customFirstItemRendererStyleName = firstStyleName;
			var usedDefaultItemRendererFactory:Boolean = false;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event):void
			{
				if(!(event.data is IGroupedListItemRenderer))
				{
					return;
				}
				var itemRenderer:DefaultGroupedListItemRenderer = DefaultGroupedListItemRenderer(event.data);
				if(itemRenderer.groupIndex == 1 && itemRenderer.itemIndex == 0 &&
					itemRenderer.styleNameList.contains(firstStyleName) &&
					itemRenderer.defaultSkin !== null)
				{
					usedDefaultItemRendererFactory = true;
				}
			})
			this._list.validate();
			Assert.assertTrue("itemRendererFactory not used when customFirstItemRendererStyleName defined, but firstItemRendererFactory is null", usedDefaultItemRendererFactory);
		}

		[Test]
		public function testCustomLastItemRendererStyleNameWithoutLastItemRendererFactory():void
		{
			var lastStyleName:String = "custom-last-item";
			this._list.customLastItemRendererStyleName = lastStyleName;
			var usedDefaultItemRendererFactory:Boolean = false;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event):void
			{
				if(!(event.data is IGroupedListItemRenderer))
				{
					return;
				}
				var itemRenderer:DefaultGroupedListItemRenderer = DefaultGroupedListItemRenderer(event.data);
				if(itemRenderer.groupIndex === 1 && itemRenderer.itemIndex === 2 &&
					itemRenderer.styleNameList.contains(lastStyleName) &&
					itemRenderer.defaultSkin !== null)
				{
					usedDefaultItemRendererFactory = true;
				}
			})
			this._list.validate();
			Assert.assertTrue("itemRendererFactory not used when customLastItemRendererStyleName defined, but lastItemRendererFactory is null", usedDefaultItemRendererFactory);
		}

		[Test]
		public function testCustomSingleItemRendererStyleNameWithoutSingleItemRendererFactory():void
		{
			var singleStyleName:String = "custom-single-item";
			this._list.customSingleItemRendererStyleName = singleStyleName;
			var usedDefaultItemRendererFactory:Boolean = false;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event):void
			{
				if(!(event.data is IGroupedListItemRenderer))
				{
					return;
				}
				var itemRenderer:DefaultGroupedListItemRenderer = DefaultGroupedListItemRenderer(event.data);
				if(itemRenderer.groupIndex == 2 && itemRenderer.itemIndex == 0 &&
					itemRenderer.styleNameList.contains(singleStyleName) &&
					itemRenderer.defaultSkin !== null)
				{
					usedDefaultItemRendererFactory = true;
				}
			})
			this._list.validate();
			Assert.assertTrue("itemRendererFactory not used when customSingleItemRendererStyleName defined, but singleItemRendererFactory is null", usedDefaultItemRendererFactory);
		}

		[Test]
		public function testResizeOnUpdateItemAtWithLongerText():void
		{
			this._list.dataProvider.getItemAt(0, 1).label = "I am the very model of a modern major general. I've information vegetable, animal, and mineral.";
			this._list.dataProvider.updateItemAt(0, 1);
			var hasResized:Boolean = false;
			this._list.addEventListener(Event.RESIZE, function(event:Event):void
			{
				hasResized = true;
			});
			this._list.validate();
			Assert.assertTrue("GroupedList Event.RESIZE was not dispatched when item was updated with longer text and width was not explicit", hasResized);
		}

		[Test]
		public function testViewPortBoundsValues():void
		{
			this._list.layout = new AssertViewPortBoundsLayout();
			this._list.validate();
		}

		[Test]
		public function testScrollToDisplayIndexAndSetDataProviderToNull():void
		{
			this._list.scrollToDisplayIndex(1, 1, 2);
			this._list.dataProvider = null;
			this._list.validate();
		}

		[Test]
		public function testScrollToDisplayIndex():void
		{
			var hasDispatchedScrollStart:Boolean = false;
			this._list.addEventListener(FeathersEventType.SCROLL_START, function(event:Event):void
			{
				hasDispatchedScrollStart = true;
			});
			var hasDispatchedScrollComplete:Boolean = false;
			this._list.addEventListener(FeathersEventType.SCROLL_COMPLETE, function(event:Event):void
			{
				hasDispatchedScrollComplete = true;
			});
			this._list.height = 200;
			this._list.scrollToDisplayIndex(1, 1);
			this._list.validate();
			Assert.assertTrue("GroupedList: scrollToDisplayIndex() set incorrect verticalScrollPosition", this._list.verticalScrollPosition > 0);
			Assert.assertTrue("GroupedList: scrollToDisplayIndex() with duration 0 did not dispatch FeathersEventType.SCROLL_START",
				hasDispatchedScrollStart);
			Assert.assertTrue("GroupedList: scrollToDisplayIndex() with duration 0 did not dispatch FeathersEventType.SCROLL_COMPLETE",
				hasDispatchedScrollComplete);
		}

		[Test]
		public function testTriggeredByTap():void
		{
			var hasTriggered:Boolean = false;
			var triggeredItem:Object = null;
			this._list.addEventListener(Event.TRIGGERED, function(event:Event, item:Object):void
			{
				hasTriggered = true;
				triggeredItem = item;
			});
			var position:Point = new Point(10, 410);
			var target:DisplayObject = this._list.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.TRIGGERED was not dispatched", hasTriggered);
			Assert.assertStrictlyEquals("Incorrect item passed to Event.TRIGGERED listener",
				this._list.dataProvider.getItemAt(0, 1), triggeredItem);
		}
	}
}


================================================
FILE: test/source/feathers/tests/HeaderInternalStateTests.as
================================================
package feathers.tests
{
	import feathers.controls.Header;
	import feathers.controls.text.BitmapFontTextRenderer;
	import feathers.core.ITextRenderer;
	import feathers.layout.HorizontalAlign;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;

	public class HeaderInternalStateTests
	{
		private static const LEFT_ITEM_WIDTH:Number = 12;
		private static const LEFT_ITEM_HEIGHT:Number = 16;
		
		private var _header:Header;
		private var _textRenderer:BitmapFontTextRenderer;

		[Before]
		public function prepare():void
		{
			this._header = new Header();
			this._header.titleFactory = function():ITextRenderer
			{
				var textRenderer:BitmapFontTextRenderer = new BitmapFontTextRenderer();
				textRenderer.name = "title";
				return textRenderer;
			};
			TestFeathers.starlingRoot.addChild(this._header);

			this._textRenderer = new BitmapFontTextRenderer();
			TestFeathers.starlingRoot.addChild(this._textRenderer);
		}

		[After]
		public function cleanup():void
		{
			this._header.removeFromParent(true);
			this._header = null;

			this._textRenderer.removeFromParent(true);
			this._textRenderer = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testBackgroundSkinResizeWhenItemsChangeButDimensionsDoNot():void
		{
			var quad:Quad = new Quad(LEFT_ITEM_WIDTH, LEFT_ITEM_HEIGHT, 0x00ff00);
			var backgroundSkin:Quad = new Quad(1, 1, 0xff00ff);
			this._header.backgroundSkin = backgroundSkin;
			this._header.leftItems = new <DisplayObject>[quad];
			this._header.validate();
			this._header.leftItems = new <DisplayObject>[quad];
			this._header.validate();
			Assert.assertStrictlyEquals("The Header backgroundSkin width was not resized correctly when changing the items",
				LEFT_ITEM_WIDTH, backgroundSkin.width);
			Assert.assertStrictlyEquals("The Header backgroundSkin height was not resized correctly when changing the items",
				LEFT_ITEM_HEIGHT, backgroundSkin.height);
			quad.dispose();
		}

		[Test]
		public function testBackgroundSkinResizeWhenExplicitDimensionsChange():void
		{
			var backgroundSkin:Quad = new Quad(1, 1, 0xff00ff);
			this._header.backgroundSkin = backgroundSkin;
			this._header.validate();
			this._header.setSize(LEFT_ITEM_WIDTH, LEFT_ITEM_HEIGHT);
			this._header.validate();
			Assert.assertStrictlyEquals("The Header backgroundSkin width was not resized correctly when setting dimensions explicitly",
				LEFT_ITEM_WIDTH, backgroundSkin.width);
			Assert.assertStrictlyEquals("The Header backgroundSkin height was not resized correctly when setting dimensions explicitly",
				LEFT_ITEM_HEIGHT, backgroundSkin.height);

			this._header.width = NaN;
			this._header.height = NaN;
			this._header.validate();
			Assert.assertStrictlyEquals("The Header backgroundSkin width was not resized correctly after reset dimensions to auto-size",
				1, backgroundSkin.width);
			Assert.assertStrictlyEquals("The Header backgroundSkin height was not resized correctly when reset dimensions to auto-size",
				1, backgroundSkin.height);
		}

		[Test]
		public function testBackgroundSkinResizeWhenTitleChanges():void
		{
			var title:String = "I am the very model of a modern major general";

			this._textRenderer.text = title;
			this._textRenderer.validate();
			
			var backgroundSkin:Quad = new Quad(1, 1, 0xff00ff);
			this._header.backgroundSkin = backgroundSkin;
			this._header.validate();
			this._header.title = title;
			this._header.validate();
			Assert.assertStrictlyEquals("The Header backgroundSkin width was not resized correctly when changing to larger title",
				this._textRenderer.width, backgroundSkin.width);
			Assert.assertStrictlyEquals("The Header backgroundSkin height was not resized correctly when changing to larger title",
				this._textRenderer.height, backgroundSkin.height);
			
			title = "I am the very model";
			this._textRenderer.text = title;
			this._textRenderer.validate();
			this._header.title = title;
			this._header.validate();
			Assert.assertStrictlyEquals("The Header backgroundSkin width was not resized correctly when changing to smaller title",
				this._textRenderer.width, backgroundSkin.width);
			Assert.assertStrictlyEquals("The Header backgroundSkin height was not resized correctly when changing to smaller title",
				this._textRenderer.height, backgroundSkin.height);
		}

		[Test]
		public function testTitleHiddenWithTitleAlignCenterAndCenterItemsNotEmpty():void
		{
			var centerItem:Quad = new Quad(10, 10, 0xff00ff);
			this._header.title = "Header";
			this._header.titleAlign = HorizontalAlign.CENTER;
			this._header.centerItems = new <DisplayObject>[centerItem];
			this._header.validate();
			Assert.assertFalse("Header title not hidden when titleAlign is HorizontalAlign.CENTER and centerItems is not empty.",
				this._header.getChildByName("title").visible);
			centerItem.dispose();
		}

		[Test]
		public function testTitleHiddenWithTitleAlignLeftAndLeftItemNotEmptyAndCenterItemsNotEmpty():void
		{
			var leftItem:Quad = new Quad(10, 10, 0xff00ff);
			var centerItem:Quad = new Quad(10, 10, 0xff00ff);
			this._header.title = "Header";
			this._header.titleAlign = HorizontalAlign.LEFT;
			this._header.leftItems = new <DisplayObject>[leftItem];
			this._header.centerItems = new <DisplayObject>[centerItem];
			this._header.validate();
			Assert.assertFalse("Header title not hidden when titleAlign is HorizontalAlign.LEFT and both leftItems and centerItems are not empty.",
				this._header.getChildByName("title").visible);
			leftItem.dispose();
			centerItem.dispose();
		}

		[Test]
		public function testTitleHiddenWithTitleAlignRightAndRightItemsNotEmptyAndCenterItemsNotEmpty():void
		{
			var rightItem:Quad = new Quad(10, 10, 0xff00ff);
			var centerItem:Quad = new Quad(10, 10, 0xff00ff);
			this._header.title = "Header";
			this._header.titleAlign = HorizontalAlign.RIGHT;
			this._header.rightItems = new <DisplayObject>[rightItem];
			this._header.centerItems = new <DisplayObject>[centerItem];
			this._header.validate();
			Assert.assertFalse("Header title not hidden when titleAlign is HorizontalAlign.RIGHT and both rightItems and centerItems are not empty.",
				this._header.getChildByName("title").visible);
			rightItem.dispose();
			centerItem.dispose();
		}

		[Test]
		public function testTitleNotHiddenWithTitleAlignRightAndRightItemsNotEmptyButCenterItemsIsEmpty():void
		{
			var rightItem:Quad = new Quad(10, 10, 0xff00ff);
			var centerItem:Quad = new Quad(10, 10, 0xff00ff);
			this._header.title = "Header";
			this._header.titleAlign = HorizontalAlign.RIGHT;
			this._header.rightItems = new <DisplayObject>[rightItem];
			this._header.validate();
			Assert.assertTrue("Header title incorrectly hidden when titleAlign is HorizontalAlign.RIGHT and rightItems is not empty but centerItems is empty.",
				this._header.getChildByName("title").visible);
			rightItem.dispose();
			centerItem.dispose();
		}

		[Test]
		public function testTitleNotHiddenWithTitleAlignLeftAndLeftItemsNotEmptyButCenterItemsIsEmpty():void
		{
			var leftItem:Quad = new Quad(10, 10, 0xff00ff);
			var centerItem:Quad = new Quad(10, 10, 0xff00ff);
			this._header.title = "Header";
			this._header.titleAlign = HorizontalAlign.LEFT;
			this._header.leftItems = new <DisplayObject>[leftItem];
			this._header.validate();
			Assert.assertTrue("Header title incorrectly hidden when titleAlign is HorizontalAlign.LEFT and leftItems is not empty but centerItems is empty.",
				this._header.getChildByName("title").visible);
			leftItem.dispose();
			centerItem.dispose();
		}
	}
}


================================================
FILE: test/source/feathers/tests/HeaderMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.Header;
	import feathers.controls.LayoutGroup;
	import feathers.controls.text.BitmapFontTextRenderer;
	import feathers.core.ITextRenderer;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;

	public class HeaderMeasurementTests
	{
		private static const BACKGROUND_WIDTH:Number = 200;
		private static const BACKGROUND_HEIGHT:Number = 250;

		private static const COMPLEX_BACKGROUND_WIDTH:Number = 340;
		private static const COMPLEX_BACKGROUND_HEIGHT:Number = 350;
		private static const COMPLEX_BACKGROUND_MIN_WIDTH:Number = 280;
		private static const COMPLEX_BACKGROUND_MIN_HEIGHT:Number = 290;

		private static const PADDING_TOP:Number = 50;
		private static const PADDING_RIGHT:Number = 54;
		private static const PADDING_BOTTOM:Number = 59;
		private static const PADDING_LEFT:Number = 60;
		
		private static const GAP:Number = 5;
		private static const TITLE_GAP:Number = 7;

		private static const LEFT_ITEM_WIDTH:Number = 12;
		private static const LEFT_ITEM_HEIGHT:Number = 16;

		private static const RIGHT_ITEM_WIDTH:Number = 17;
		private static const RIGHT_ITEM_HEIGHT:Number = 31;

		private static const CENTER_ITEM_WIDTH:Number = 14;
		private static const CENTER_ITEM_HEIGHT:Number = 37;

		private var _header:Header;
		private var _textRenderer:BitmapFontTextRenderer;

		[Before]
		public function prepare():void
		{
			this._header = new Header();
			this._header.titleFactory = function():ITextRenderer
			{
				return new BitmapFontTextRenderer();
			};
			TestFeathers.starlingRoot.addChild(this._header);
			
			this._textRenderer = new BitmapFontTextRenderer();
			TestFeathers.starlingRoot.addChild(this._textRenderer);
		}

		[After]
		public function cleanup():void
		{
			this._header.removeFromParent(true);
			this._header = null;
			
			this._textRenderer.removeFromParent(true);
			this._textRenderer = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function addSimpleBackground():void
		{
			this._header.backgroundSkin = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT, 0xff00ff);
		}

		private function addComplexBackground():void
		{
			var backgroundSkin:LayoutGroup = new LayoutGroup();
			backgroundSkin.width = COMPLEX_BACKGROUND_WIDTH;
			backgroundSkin.height = COMPLEX_BACKGROUND_HEIGHT;
			backgroundSkin.minWidth = COMPLEX_BACKGROUND_MIN_WIDTH;
			backgroundSkin.minHeight = COMPLEX_BACKGROUND_MIN_HEIGHT;
			this._header.backgroundSkin = backgroundSkin;
		}

		[Test]
		public function testAutoSizeNoBackgroundAndNoItems():void
		{
			this._header.validate();
			Assert.assertStrictlyEquals("The width of the Header was not calculated correctly when empty.",
				0, this._header.width);
			Assert.assertStrictlyEquals("The height of the Header was not calculated correctly when empty.",
				0, this._header.height);
			Assert.assertStrictlyEquals("The minWidth of the Header was not calculated correctly when empty.",
				0, this._header.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Header was not calculated correctly when empty.",
				0, this._header.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleBackgroundAndNoChildren():void
		{
			this.addSimpleBackground();
			this._header.validate();
			Assert.assertStrictlyEquals("The width of the Header was not calculated correctly with background skin and no children.",
				BACKGROUND_WIDTH, this._header.width);
			Assert.assertStrictlyEquals("The height of the Header was not calculated correctly with background skin and no children.",
				BACKGROUND_HEIGHT, this._header.height);
			Assert.assertStrictlyEquals("The minWidth of the Header was not calculated correctly with background skin and no children.",
				BACKGROUND_WIDTH, this._header.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Header was not calculated correctly with background skin and no children.",
				BACKGROUND_HEIGHT, this._header.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexBackgroundAndNoChildren():void
		{
			this.addComplexBackground();
			this._header.validate();
			Assert.assertStrictlyEquals("The width of the Header was not calculated correctly with complex background skin and no children.",
				COMPLEX_BACKGROUND_WIDTH, this._header.width);
			Assert.assertStrictlyEquals("The height of the Header was not calculated correctly with complex background skin and no children.",
				COMPLEX_BACKGROUND_HEIGHT, this._header.height);
			Assert.assertStrictlyEquals("The minWidth of the Header was not calculated correctly with complex background skin and no children.",
				COMPLEX_BACKGROUND_MIN_WIDTH, this._header.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Header was not calculated correctly with complex background skin and no children.",
				COMPLEX_BACKGROUND_MIN_HEIGHT, this._header.minHeight);
		}

		[Test]
		public function testDimensionsWithPaddingGapTitleGapNoChildren():void
		{
			this._header.paddingTop = PADDING_TOP;
			this._header.paddingRight = PADDING_RIGHT;
			this._header.paddingBottom = PADDING_BOTTOM;
			this._header.paddingLeft = PADDING_LEFT;
			this._header.gap = GAP;
			this._header.titleGap = TITLE_GAP;
			this._header.validate();
			Assert.assertStrictlyEquals("The width of the Header was not calculated correctly with left and right padding.",
				PADDING_LEFT + PADDING_RIGHT, this._header.width);
			Assert.assertStrictlyEquals("The height of the Header was not calculated correctly with top and bottom padding.",
				PADDING_TOP + PADDING_BOTTOM, this._header.height);
			Assert.assertStrictlyEquals("The minWidth of the Header was not calculated correctly with left and right padding.",
				PADDING_LEFT + PADDING_RIGHT, this._header.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Header was not calculated correctly with top and bottom padding.",
				PADDING_TOP + PADDING_BOTTOM, this._header.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleBackgroundPaddingAndGap():void
		{
			this._header.paddingTop = PADDING_TOP;
			this._header.paddingRight = PADDING_RIGHT;
			this._header.paddingBottom = PADDING_BOTTOM;
			this._header.paddingLeft = PADDING_LEFT;
			this._header.gap = GAP;
			this._header.titleGap = TITLE_GAP;
			this.addSimpleBackground();
			this._header.validate();
			Assert.assertStrictlyEquals("The width of the Header was not calculated correctly with background skin, padding, and gap.",
				BACKGROUND_WIDTH, this._header.width);
			Assert.assertStrictlyEquals("The height of the Header was not calculated correctly with background skin, padding, and gap.",
				BACKGROUND_HEIGHT, this._header.height);
			Assert.assertStrictlyEquals("The minWidth of the Header was not calculated correctly with background skin, padding, and gap.",
				BACKGROUND_WIDTH, this._header.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Header was not calculated correctly with background skin, padding, and gap.",
				BACKGROUND_HEIGHT, this._header.minHeight);
		}

		[Test]
		public function testDimensionsWithTitle():void
		{
			var title:String = "I am the very model of a modern major general";
			
			this._header.title = title;
			this._header.validate();

			this._textRenderer.text = title;
			this._textRenderer.validate();
			
			Assert.assertStrictlyEquals("The width of the Header was not calculated correctly with title.",
				this._textRenderer.width, this._header.width);
			Assert.assertStrictlyEquals("The height of the Header was not calculated correctly with title.",
				this._textRenderer.height, this._header.height);
			Assert.assertStrictlyEquals("The minWidth of the Header was not calculated correctly with title.",
				this._textRenderer.minWidth, this._header.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Header was not calculated correctly with title.",
				this._textRenderer.minHeight, this._header.minHeight);
		}

		[Test]
		public function testDimensionsWithTitleAndSimpleBackground():void
		{
			var title:String = "I am the very model of a modern major general";

			this.addSimpleBackground();
			this._header.title = title;
			this._header.validate();

			this._textRenderer.text = title;
			this._textRenderer.validate();

			Assert.assertStrictlyEquals("The width of the Header was not calculated correctly with title.",
				this._textRenderer.width, this._header.width);
			Assert.assertStrictlyEquals("The height of the Header was not calculated correctly with title.", 
				BACKGROUND_HEIGHT, this._header.height);
			Assert.assertStrictlyEquals("The minWidth of the Header was not calculated correctly with title.",
				this._textRenderer.minWidth, this._header.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Header was not calculated correctly with title.",
				BACKGROUND_HEIGHT, this._header.minHeight);
		}

		[Test]
		public function testDimensionsWithTitlePaddingGapAndTitleGap():void
		{
			var title:String = "I am the very model of a modern major general";

			this._header.title = title;
			this._header.paddingTop = PADDING_TOP;
			this._header.paddingRight = PADDING_RIGHT;
			this._header.paddingBottom = PADDING_BOTTOM;
			this._header.paddingLeft = PADDING_LEFT;
			this._header.gap = GAP;
			this._header.titleGap = TITLE_GAP;
			this._header.validate();

			this._textRenderer.text = title;
			this._textRenderer.validate();

			Assert.assertStrictlyEquals("The width of the Header was not calculated correctly with title and left and right padding.",
				this._textRenderer.width + PADDING_LEFT + PADDING_RIGHT, this._header.width);
			Assert.assertStrictlyEquals("The height of the Header was not calculated correctly with title and top and bottom padding.",
				this._textRenderer.height + PADDING_TOP + PADDING_BOTTOM, this._header.height);
			Assert.assertStrictlyEquals("The minWidth of the Header was not calculated correctly with title and left and right padding.",
				this._textRenderer.minWidth + PADDING_LEFT + PADDING_RIGHT, this._header.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Header was not calculated correctly with title and top and bottom padding.",
				this._textRenderer.minHeight + PADDING_TOP + PADDING_BOTTOM, this._header.minHeight);
		}

		[Test]
		public function testDimensionsWithTitleOneLeftItemPaddingGapAndTitleGap():void
		{
			var title:String = "I am the very model of a modern major general";

			this._header.title = title;
			this._header.paddingTop = PADDING_TOP;
			this._header.paddingRight = PADDING_RIGHT;
			this._header.paddingBottom = PADDING_BOTTOM;
			this._header.paddingLeft = PADDING_LEFT;
			this._header.gap = GAP;
			this._header.titleGap = TITLE_GAP;
			this._header.leftItems = new <DisplayObject>[new Quad(LEFT_ITEM_WIDTH, LEFT_ITEM_HEIGHT, 0x0000ff)];
			this._header.validate();

			this._textRenderer.text = title;
			this._textRenderer.validate();

			Assert.assertStrictlyEquals("The width of the Header was not calculated correctly with title, one left item, and left and right padding, gap, and title gap.",
				this._textRenderer.width + LEFT_ITEM_WIDTH + TITLE_GAP + PADDING_LEFT + PADDING_RIGHT, this._header.width);
			Assert.assertStrictlyEquals("The height of the Header was not calculated correctly with title, one left item, and top and bottom padding.",
				LEFT_ITEM_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._header.height);
			Assert.assertStrictlyEquals("The minWidth of the Header was not calculated correctly with title, one left item, and left and right padding, gap, and title gap.",
				this._textRenderer.minWidth + LEFT_ITEM_WIDTH + TITLE_GAP + PADDING_LEFT + PADDING_RIGHT, this._header.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Header was not calculated correctly with title, one left item, and top and bottom padding.",
				LEFT_ITEM_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._header.minHeight);
		}

		[Test]
		public function testDimensionsWithTitleOneRightItemGapAndTitleGap():void
		{
			var title:String = "I am the very model of a modern major general";

			this._header.title = title;
			this._header.gap = GAP;
			this._header.titleGap = TITLE_GAP;
			this._header.rightItems = new <DisplayObject>[new Quad(RIGHT_ITEM_WIDTH, RIGHT_ITEM_HEIGHT, 0x0000ff)];
			this._header.validate();

			this._textRenderer.text = title;
			this._textRenderer.validate();

			Assert.assertStrictlyEquals("The width of the Header was not calculated correctly with title, one right item, gap, and title gap.",
				this._textRenderer.width + RIGHT_ITEM_WIDTH + TITLE_GAP, this._header.width);
			Assert.assertStrictlyEquals("The height of the Header was not calculated correctly with title and one right item.",
				RIGHT_ITEM_HEIGHT, this._header.height);
			Assert.assertStrictlyEquals("The minWidth of the Header was not calculated correctly with title, one right item, gap, and title gap.",
				this._textRenderer.minWidth + RIGHT_ITEM_WIDTH + TITLE_GAP, this._header.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Header was not calculated correctly with title and one right item.",
				RIGHT_ITEM_HEIGHT, this._header.minHeight);
		}

		[Test]
		public function testDimensionsWithTitleTwoLeftItemsPaddingGapAndTitleGap():void
		{
			var title:String = "I am the very model of a modern major general";

			this._header.title = title;
			this._header.paddingTop = PADDING_TOP;
			this._header.paddingRight = PADDING_RIGHT;
			this._header.paddingBottom = PADDING_BOTTOM;
			this._header.paddingLeft = PADDING_LEFT;
			this._header.gap = GAP;
			this._header.titleGap = TITLE_GAP;
			this._header.leftItems = new <DisplayObject>
			[
				new Quad(LEFT_ITEM_WIDTH, LEFT_ITEM_HEIGHT, 0x0000ff),
				new Quad(LEFT_ITEM_WIDTH, LEFT_ITEM_HEIGHT, 0x00ffff),
			];
			this._header.validate();

			this._textRenderer.text = title;
			this._textRenderer.validate();

			Assert.assertStrictlyEquals("The width of the Header was not calculated correctly with title, two left items, and left and right padding, gap, and title gap.",
				this._textRenderer.width + 2 * LEFT_ITEM_WIDTH + GAP + TITLE_GAP + PADDING_LEFT + PADDING_RIGHT, this._header.width);
			Assert.assertStrictlyEquals("The height of the Header was not calculated correctly with title, two left items, and top and bottom padding.",
				LEFT_ITEM_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._header.height);
			Assert.assertStrictlyEquals("The minWidth of the Header was not calculated correctly with title, two left items, and left and right padding, gap, and title gap.",
				this._textRenderer.minWidth + 2 * LEFT_ITEM_WIDTH + GAP + TITLE_GAP + PADDING_LEFT + PADDING_RIGHT, this._header.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Header was not calculated correctly with title, two left items, and top and bottom padding.",
				LEFT_ITEM_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._header.minHeight);
		}

		[Test]
		public function testDimensionsWithTitleTwoLeftItemsOneRightItemPaddingGapAndTitleGap():void
		{
			var title:String = "I am the very model of a modern major general";

			this._header.title = title;
			this._header.paddingTop = PADDING_TOP;
			this._header.paddingRight = PADDING_RIGHT;
			this._header.paddingBottom = PADDING_BOTTOM;
			this._header.paddingLeft = PADDING_LEFT;
			this._header.gap = GAP;
			this._header.titleGap = TITLE_GAP;
			this._header.leftItems = new <DisplayObject>
			[
				new Quad(LEFT_ITEM_WIDTH, LEFT_ITEM_HEIGHT, 0x0000ff),
				new Quad(LEFT_ITEM_WIDTH, LEFT_ITEM_HEIGHT, 0x00ffff),
			];
			this._header.rightItems = new <DisplayObject>
			[
				new Quad(RIGHT_ITEM_WIDTH, RIGHT_ITEM_HEIGHT, 0x0000ff),
			];
			this._header.validate();

			this._textRenderer.text = title;
			this._textRenderer.validate();

			Assert.assertStrictlyEquals("The width of the Header was not calculated correctly with title, two left items, one right item, and left and right padding, gap, and title gap.",
				this._textRenderer.width + 2 * LEFT_ITEM_WIDTH + RIGHT_ITEM_WIDTH + GAP + 2 * TITLE_GAP + PADDING_LEFT + PADDING_RIGHT, this._header.width);
			Assert.assertStrictlyEquals("The height of the Header was not calculated correctly with title, two left items, one right item, and top and bottom padding.",
				RIGHT_ITEM_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._header.height);
			Assert.assertStrictlyEquals("The minWidth of the Header was not calculated correctly with title, two left items, one right item, and left and right padding, gap, and title gap.",
				this._textRenderer.minWidth + 2 * LEFT_ITEM_WIDTH + RIGHT_ITEM_WIDTH + GAP + 2 * TITLE_GAP + PADDING_LEFT + PADDING_RIGHT, this._header.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Header was not calculated correctly with title, two left items, one right item, and top and bottom padding.",
				RIGHT_ITEM_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._header.minHeight);
		}

		[Test]
		public function testDimensionsWithTitleTwoLeftItemsOneRightItemThreeCenterItemsPaddingGapAndTitleGap():void
		{
			var title:String = "I am the very model of a modern major general";

			this._header.title = title;
			this._header.paddingTop = PADDING_TOP;
			this._header.paddingRight = PADDING_RIGHT;
			this._header.paddingBottom = PADDING_BOTTOM;
			this._header.paddingLeft = PADDING_LEFT;
			this._header.gap = GAP;
			this._header.titleGap = TITLE_GAP;
			this._header.leftItems = new <DisplayObject>
			[
				new Quad(LEFT_ITEM_WIDTH, LEFT_ITEM_HEIGHT, 0x0000ff),
				new Quad(LEFT_ITEM_WIDTH, LEFT_ITEM_HEIGHT, 0x00ffff),
			];
			this._header.rightItems = new <DisplayObject>
			[
				new Quad(RIGHT_ITEM_WIDTH, RIGHT_ITEM_HEIGHT, 0x0000ff),
			];
			this._header.centerItems = new <DisplayObject>
			[
				new Quad(CENTER_ITEM_WIDTH, CENTER_ITEM_HEIGHT, 0x0000ff),
				new Quad(CENTER_ITEM_WIDTH, CENTER_ITEM_HEIGHT, 0x0000ff),
				new Quad(CENTER_ITEM_WIDTH, CENTER_ITEM_HEIGHT, 0x0000ff),
			];
			this._header.validate();

			Assert.assertStrictlyEquals("The width of the Header was not calculated correctly with title, two left items, one right item, three center items, and left and right padding, gap, and title gap.",
				2 * LEFT_ITEM_WIDTH + RIGHT_ITEM_WIDTH + 3 * CENTER_ITEM_WIDTH + 5 * GAP + PADDING_LEFT + PADDING_RIGHT, this._header.width);
			Assert.assertStrictlyEquals("The height of the Header was not calculated correctly with title, two left items, one right item, three center items, and top and bottom padding.",
				CENTER_ITEM_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._header.height);
			Assert.assertStrictlyEquals("The minWidth of the Header was not calculated correctly with title, two left items, one right item, three center items, and left and right padding, gap, and title gap.",
				2 * LEFT_ITEM_WIDTH + RIGHT_ITEM_WIDTH + 3 * CENTER_ITEM_WIDTH + 5 * GAP + PADDING_LEFT + PADDING_RIGHT, this._header.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Header was not calculated correctly with title, two left items, one right item, three center items, and top and bottom padding.",
				CENTER_ITEM_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._header.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/HeaderTests.as
================================================
package feathers.tests
{
	import feathers.controls.Header;
	import feathers.controls.Label;
	import feathers.tests.supportClasses.DisposeFlagQuad;

	import org.flexunit.Assert;

	public class HeaderTests
	{
		protected var header:Header;

		[Before]
		public function prepare():void
		{
			this.header = new Header();
			TestFeathers.starlingRoot.addChild(this.header);
		}

		[After]
		public function cleanup():void
		{
			this.header.removeFromParent(true);
			this.header = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testSkinsDisposed():void
		{
			var backgroundSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this.header.backgroundSkin = backgroundSkin;
			var backgroundDisabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this.header.backgroundDisabledSkin = backgroundDisabledSkin;
			this.header.validate();
			this.header.dispose();
			Assert.assertTrue("backgroundSkin not disposed when Header disposed.", backgroundSkin.isDisposed);
			Assert.assertTrue("backgroundDisabledSkin not disposed when Header disposed.", backgroundDisabledSkin.isDisposed);
		}
	}
}


================================================
FILE: test/source/feathers/tests/HierarchicalCollectionTests.as
================================================
package feathers.tests
{
	import feathers.data.HierarchicalCollection;
	import feathers.events.CollectionEventType;

	import org.flexunit.Assert;

	import starling.events.Event;

	public class HierarchicalCollectionTests
	{
		private var _collection:HierarchicalCollection;

		[Before]
		public function prepare():void
		{
			this._collection = new HierarchicalCollection(
			[
				{
					label: "1",
					children:
					[
						{label: "1-A"},
						{
							label: "1-B",
							children:
							[
								{label: "1-B-I"},
							]
						},
						{label: "1-C"},
					]
				},
				{
					label: "2",
					children:
					[
						{label: "2-A"},
					]
				},
				{ label: "3" },
				{
					label: "4",
					children:
					[
						{label: "4-A"},
						{label: "4-B"},
					]
				},
			]);
		}

		[After]
		public function cleanup():void
		{
			this._collection = null;
		}

		[Test]
		public function testGetLength():void
		{
			var length:int = this._collection.getLength();
			Assert.assertStrictlyEquals("HierarchicalCollection: getLengthAtLocation() returned incorrect length",
				4, length);
		}

		[Test]
		public function testGetLengthNested():void
		{
			var length:int = this._collection.getLength(3);
			Assert.assertStrictlyEquals("HierarchicalCollection: getLengthAtLocation() returned incorrect length",
				2, length);
		}

		[Test]
		public function testGetLengthAtLocationWithNull():void
		{
			var length:int = this._collection.getLengthAtLocation();
			Assert.assertStrictlyEquals("HierarchicalCollection: getLengthAtLocation() returned incorrect length",
				4, length);
		}

		[Test]
		public function testGetItemAt():void
		{
			var item:Object = this._collection.getItemAt(1);
			Assert.assertStrictlyEquals("HierarchicalCollection: getItemAt() returned incorrect item",
				this._collection.data[1], item);
		}

		[Test]
		public function testGetItemAtNested():void
		{
			var item:Object = this._collection.getItemAt(0, 1);
			Assert.assertStrictlyEquals("HierarchicalCollection: getItemAt() returned incorrect item",
				this._collection.data[0].children[1], item);
		}

		[Test]
		public function testGetItemAtLocation():void
		{
			var indices:Vector.<int> = new <int>[1];
			var item:Object = this._collection.getItemAtLocation(indices);
			Assert.assertStrictlyEquals("HierarchicalCollection: getItemAtLocation() returned incorrect item",
				this._collection.data[1], item);
		}

		[Test]
		public function testGetItemAtNestedLocation():void
		{
			var indices:Vector.<int> = new <int>[0, 1];
			var item:Object = this._collection.getItemAtLocation(indices);
			Assert.assertStrictlyEquals("HierarchicalCollection: getItemAtLocation() returned incorrect item",
				this._collection.data[0].children[1], item);
		}

		[Test]
		public function testGetItemAtNullLocation():void
		{
			var item:Object = this._collection.getItemAtLocation(null);
			Assert.assertStrictlyEquals("HierarchicalCollection: getItemAtLocation() returned incorrect item",
				null, item);
		}

		[Test]
		public function testGetItemAtEmptyLocation():void
		{
			var indices:Vector.<int> = new <int>[];
			var item:Object = this._collection.getItemAtLocation(indices);
			Assert.assertStrictlyEquals("HierarchicalCollection: getItemAtLocation() returned incorrect item",
				null, item);
		}

		[Test]
		public function testRemoveAll():void
		{
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedAll:Boolean = false;
			this._collection.addEventListener(CollectionEventType.REMOVE_ALL, function(event:Event):void
			{
				hasRemovedAll = true;
			});
			var hasReset:Boolean = false;
			this._collection.addEventListener(CollectionEventType.RESET, function(event:Event):void
			{
				hasReset = true;
			});
			this._collection.removeAll();
			Assert.assertTrue("HierarchicalCollection: Event.CHANGE was not dispatched after removeAll()", hasChanged);
			Assert.assertFalse("HierarchicalCollection: CollectionEventType.RESET was incorrectly dispatched after removeAll()", hasReset);
			Assert.assertTrue("HierarchicalCollection: CollectionEventType.REMOVE_ALL was not dispatched after removeAll()", hasRemovedAll);
			Assert.assertStrictlyEquals("HierarchicalCollection: the getLength() value was not changed to 0 after removeAll()",
				0, this._collection.getLength());
		}

		[Test]
		public function testRemoveItemAtLocation():void
		{
			var indicesToRemove:Vector.<int> = new <int>[1];
			var itemToRemove:Object = this._collection.getItemAtLocation(indicesToRemove);
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItemAtLocation(indicesToRemove);
			Assert.assertTrue("HierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("HierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("HierarchicalCollection: The getLength() value was not changed",
				originalLength - 1, this._collection.getLength());
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("HierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				indicesToRemove[0], indicesFromEvent[0]);
		}

		[Test]
		public function testRemoveItemAtNestedLocation():void
		{
			var indicesToRemove:Vector.<int> = new <int>[0, 1];
			var itemToRemove:Object = this._collection.getItemAtLocation(indicesToRemove);
			var originalParentLength:int = this._collection.getLength(indicesToRemove[0]);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItemAtLocation(indicesToRemove);
			Assert.assertTrue("HierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("HierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("HierarchicalCollection: The getLength() value was not changed",
				originalParentLength - 1, this._collection.getLength(indicesToRemove[0]));
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("HierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				indicesToRemove[0], indicesFromEvent[0]);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				indicesToRemove[1], indicesFromEvent[1]);
		}

		[Test(expects="RangeError")]
		public function testRemoveItemAtNullLocation():void
		{
			this._collection.removeItemAtLocation(null);
		}

		[Test(expects="RangeError")]
		public function testRemoveItemAtEmptyLocation():void
		{
			var indices:Vector.<int> = new <int>[];
			this._collection.removeItemAtLocation(indices);
		}

		[Test]
		public function testRemoveItemAt():void
		{
			var itemToRemove:Object = this._collection.getItemAt(1);
			var originalLength:int = this._collection.getLength();
			var expectedIndex:int = 1;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItemAt(expectedIndex);
			Assert.assertTrue("HierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("HierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("HierarchicalCollection: The getLength() value was not changed",
				originalLength - 1, this._collection.getLength());
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("HierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testRemoveItem():void
		{
			var expectedIndex:int = 1;
			var itemToRemove:Object = this._collection.getItemAt(expectedIndex);
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItem(itemToRemove);
			Assert.assertTrue("HierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("HierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("HierarchicalCollection: The getLength() value was not changed",
				originalLength - 1, this._collection.getLength());
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("HierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testAddItemAtLocation():void
		{
			var location:Vector.<int> = new <int>[1];
			var itemToAdd:Object = { label: "New Item" };
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAtLocation(itemToAdd, location);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The getLength() value was not changed",
				originalLength + 1, this._collection.getLength());
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not added",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not added at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("HierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
		}

		[Test]
		public function testAddItemAtNestedLocation():void
		{
			var location:Vector.<int> = new <int>[0, 1];
			var itemToAdd:Object = { label: "New Item" };
			var originalParentLength:int = this._collection.getLength(location[0]);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAtLocation(itemToAdd, location);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The getLength() value was not changed",
				originalParentLength + 1, this._collection.getLength(location[0]));
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not added",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not added at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not added at the correct index",
				location[1], this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("HierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				location[1], indicesFromEvent[1]);
		}

		[Test(expects="RangeError")]
		public function testAddItemAtNullLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			this._collection.addItemAtLocation(itemToAdd, null);
		}

		[Test(expects="RangeError")]
		public function testAddItemAtEmptyLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var indices:Vector.<int> = new <int>[];
			this._collection.addItemAtLocation(itemToAdd, indices);
		}

		[Test]
		public function testAddItemAt():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The getLength() value was not changed",
				originalLength + 1, this._collection.getLength());
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not added",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not added at the correct index",
				expectedIndex, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("HierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testAddItemAtNested():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var originalParentLength:int = this._collection.getLength(0);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAt(itemToAdd, 0, 1);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The getLength() value was not changed",
				originalParentLength + 1, this._collection.getLength(0));
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not added",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not added at the correct index",
				0, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not added at the correct index",
				1, this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("HierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				0, indicesFromEvent[0]);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[1]);
		}

		[Test]
		public function testSetItemAt():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalLength, this._collection.getLength());
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not replaced",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not replaced at the correct index",
				expectedIndex, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("HierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testSetItemAtNested():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var originalParentLength:int = this._collection.getLength(0);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAt(itemToAdd, 0, 1);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalParentLength, this._collection.getLength(0));
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not replaced",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not replaced at the correct index",
				0, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not replaced at the correct index",
				1, this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("HierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				0, indicesFromEvent[0]);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[1]);
		}

		[Test]
		public function testSetItemAtLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var location:Vector.<int> = new <int>[1];
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAtLocation(itemToAdd, location);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalLength, this._collection.getLength());
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not replaced",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not replaced at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("HierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
		}

		[Test]
		public function testSetItemAtNestedLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var location:Vector.<int> = new <int>[0, 1];
			var originalParentLength:int = this._collection.getLength(location[0]);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAtLocation(itemToAdd, location);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalParentLength, this._collection.getLength(location[0]));
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not replaced",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not replaced at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("HierarchicalCollection: The item was not replaced at the correct index",
				location[1], this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("HierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
			Assert.assertStrictlyEquals("HierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				location[1], indicesFromEvent[1]);
		}

		[Test(expects="RangeError")]
		public function testSetItemAtNullLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			this._collection.setItemAtLocation(itemToAdd, null);
		}

		[Test(expects="RangeError")]
		public function testSetItemAtEmptyLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var indices:Vector.<int> = new <int>[];
			this._collection.setItemAtLocation(itemToAdd, indices);
		}

		[Test]
		public function testGetItemLocationWithItemInCollection():void
		{
			var expectedIndex:int = 1;
			var item:Object = this._collection.getItemAt(expectedIndex);
			Assert.assertStrictlyEquals("HierarchicalCollection: getItemLocation() returned the incorrect location (length)",
				1, this._collection.getItemLocation(item).length);
			Assert.assertStrictlyEquals("HierarchicalCollection: getItemLocation() returned the incorrect location (value)",
				expectedIndex, this._collection.getItemLocation(item)[0]);
		}

		[Test]
		public function testGetItemLocationNestedWithItemInCollection():void
		{
			var location:Vector.<int> = new <int>[0, 1];
			var item:Object = this._collection.getItemAtLocation(location);
			Assert.assertStrictlyEquals("HierarchicalCollection: getItemLocation() returned the incorrect location (length)",
				location.length, this._collection.getItemLocation(item).length);
			Assert.assertStrictlyEquals("HierarchicalCollection: getItemLocation() returned the incorrect location (value)",
				location[0], this._collection.getItemLocation(item)[0]);
			Assert.assertStrictlyEquals("HierarchicalCollection: getItemLocation() returned the incorrect location (value)",
				location[1], this._collection.getItemLocation(item)[1]);
		}

		[Test]
		public function testGetItemLocationWithItemNotInCollection():void
		{
			var item:Object = {};
			Assert.assertStrictlyEquals("HierarchicalCollection: getItemLocation() returned the incorrect location (length)",
				0, this._collection.getItemLocation(item).length);
		}
	}
}

================================================
FILE: test/source/feathers/tests/HorizontalLayoutTests.as
================================================
package feathers.tests
{
	import feathers.controls.LayoutGroup;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.HorizontalLayoutData;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.ViewPortBounds;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;

	public class HorizontalLayoutTests
	{
		private var _layout:HorizontalLayout;

		[Before]
		public function prepare():void
		{
			this._layout = new HorizontalLayout();
			this._layout.useVirtualLayout = false;
		}

		[After]
		public function cleanup():void
		{
			this._layout = null;
		}

		[Test]
		public function testPercentWidthWithOneItem():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:HorizontalLayoutData = new HorizontalLayoutData(50);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayoutData with percentWidth results in incorrect item width", viewPortWidth / 2, item1.width);
		}

		[Test]
		public function testPercentWidthGreaterThan100WithOneItem():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:HorizontalLayoutData = new HorizontalLayoutData(200);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayoutData with percentWidth > 100 not clamped to 100", viewPortWidth, item1.width);
		}

		[Test]
		public function testPercentWidthLessThan0WithOneItem():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:HorizontalLayoutData = new HorizontalLayoutData(-50);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayoutData with percentWidth < 0 not clamped to 0", 0, item1.width);
		}

		[Test]
		public function testPercentWidthWithTwoItems():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var item1Percent:Number = 50;
			var layoutData1:HorizontalLayoutData = new HorizontalLayoutData(item1Percent);
			item1.layoutData = layoutData1;
			var item2:LayoutGroup = new LayoutGroup();
			var item2Percent:Number = 25;
			var layoutData2:HorizontalLayoutData = new HorizontalLayoutData(item2Percent);
			item2.layoutData = layoutData2;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayoutData with percentWidth results in incorrect item width for first item (of 2)", viewPortWidth / (100 / item1Percent), item1.width);
			Assert.assertStrictlyEquals("HorizontalLayoutData with percentWidth results in incorrect item width for second item (of 2)", viewPortWidth / (100 / item2Percent), item2.width);
		}

		[Test]
		public function testPercentWidthGreaterThan100WithTwoItems():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var item1Percent:Number = 100;
			var layoutData1:HorizontalLayoutData = new HorizontalLayoutData(item1Percent);
			item1.layoutData = layoutData1;
			var item2:LayoutGroup = new LayoutGroup();
			var item2Percent:Number = 150;
			var layoutData2:HorizontalLayoutData = new HorizontalLayoutData(item2Percent);
			item2.layoutData = layoutData2;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			var totalPercent:Number = item1Percent + item2Percent;
			Assert.assertStrictlyEquals("HorizontalLayoutData with percentWidth > 100 results in incorrect item width for first item (of 2)", viewPortWidth / (totalPercent / item1Percent), item1.width);
			Assert.assertStrictlyEquals("HorizontalLayoutData with percentWidth > 100 results in incorrect item width for second item (of 2)", viewPortWidth / (totalPercent / item2Percent), item2.width);
		}

		[Test]
		public function testPercentHeight():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:HorizontalLayoutData = new HorizontalLayoutData(NaN, 50);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayoutData with percentHeight results in incorrect item height", viewPortHeight / 2, item1.height);
		}

		[Test]
		public function testPercentHeightGreaterThan100():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:HorizontalLayoutData = new HorizontalLayoutData(NaN, 150);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayoutData with percentHeight > 100 does not clamp to 100", viewPortHeight, item1.height);
		}

		[Test]
		public function testPercentHeightLessThan0():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:HorizontalLayoutData = new HorizontalLayoutData(NaN, -50);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayoutData with percentHeight < 0 does not clamp to 0", 0, item1.height);
		}

		[Test]
		public function testPercentWidthWithExplicitMinWidth():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			item1.minWidth = 400;
			var layoutData1:HorizontalLayoutData = new HorizontalLayoutData(50, NaN);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayoutData with percentWidth and larger item explicitMinWidth results in incorrect item width",
				400, item1.width);
		}

		[Test]
		public function testPercentHeightWithExplicitMinHeight():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			item1.minHeight = 400;
			var layoutData1:HorizontalLayoutData = new HorizontalLayoutData(NaN, 50);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayoutData with percentHeight and larger item explicitMinHeight results in incorrect item height",
				400, item1.height);
		}

		[Test]
		public function testPercentHeightWithExplicitMaxHeight():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			item1.maxHeight = 250;
			var layoutData1:HorizontalLayoutData = new HorizontalLayoutData(NaN, 50);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayoutData with percentHeight and larger item explicitMaxHeight results in incorrect item height",
				250, item1.height);
		}

		[Test]
		public function testDistributeWidths():void
		{
			this._layout.distributeWidths = true;
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var item2:LayoutGroup = new LayoutGroup();
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			var itemWidth:Number = viewPortWidth / items.length;
			Assert.assertStrictlyEquals("HorizontalLayout with distributeWidths results in wrong item width",
				itemWidth, item1.width);
			Assert.assertStrictlyEquals("HorizontalLayout with distributeWidths results in wrong item width",
				itemWidth, item2.width);
		}

		[Test]
		public function testDistributeWidthsWithIncludeInLayoutFalse():void
		{
			this._layout.distributeWidths = true;
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var item2:LayoutGroup = new LayoutGroup();
			var item3:LayoutGroup = new LayoutGroup();
			item2.includeInLayout = false;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			var itemWidth:Number = viewPortWidth / (items.length - 1);
			Assert.assertStrictlyEquals("HorizontalLayout with distributeWidths and an item with includeInLayout set to false results in wrong item width",
				itemWidth, item1.width);
			Assert.assertStrictlyEquals("HorizontalLayout with distributeWidths and an item with includeInLayout set to false results in wrong item width",
				0, item2.width);
			Assert.assertStrictlyEquals("HorizontalLayout with distributeWidths and an item with includeInLayout set to false results in wrong item width",
				itemWidth, item3.width);
		}

		[Test]
		public function testDistributeWidthsWithLargerItemWidths():void
		{
			this._layout.distributeWidths = true;
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			item1.width = 720;
			var item2:LayoutGroup = new LayoutGroup();
			item2.width = 820;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			var itemWidth:Number = viewPortWidth / items.length;
			Assert.assertStrictlyEquals("HorizontalLayout with distributeWidths and larger item width results in wrong item width",
				itemWidth, item1.width);
			Assert.assertStrictlyEquals("HorizontalLayout with distributeWidths and larger item width results in wrong item width",
				itemWidth, item2.width);
		}

		[Test]
		public function testDistributeWidthsWithoutExplicitWidth():void
		{
			this._layout.distributeWidths = true;
			var item1:LayoutGroup = new LayoutGroup();
			item1.width = 480;
			var item2:LayoutGroup = new LayoutGroup();
			item2.width = 640;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			this._layout.layout(items, new ViewPortBounds());
			var largerWidth:Number = Math.max(item1.width, item2.width);
			var itemWidth:Number = largerWidth * items.length;
			Assert.assertStrictlyEquals("HorizontalLayout with distributeWidths and no explicit width results in wrong item width",
				itemWidth, item1.width);
			Assert.assertStrictlyEquals("HorizontalLayout with distributeWidths and no explicit width results in wrong item width",
				itemWidth, item2.width);
		}

		[Test]
		public function testDistributeWidthsWithUseVirtualLayout():void
		{
			this._layout.distributeWidths = true;
			this._layout.useVirtualLayout = true;
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var item2:LayoutGroup = new LayoutGroup();
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			var itemWidth:Number = viewPortWidth / items.length;
			Assert.assertStrictlyEquals("HorizontalLayout with distributeWidths and useVirtualLayout results in wrong item width",
				itemWidth, item1.width);
			Assert.assertStrictlyEquals("HorizontalLayout with distributeWidths and useVirtualLayout results in wrong item width",
				itemWidth, item2.width);
		}

		[Test]
		public function testSmallerMaxColumnCount():void
		{
			this._layout.maxColumnCount = 2;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayout with smaller maxColumnCount results in wrong view port width",
				200, result.viewPortWidth);
			Assert.assertStrictlyEquals("HorizontalLayout with smaller maxColumnCount results in wrong content width",
				300, result.contentWidth);
		}

		[Test]
		public function testSmallerMaxColumnCountAndUseVirtualLayout():void
		{
			this._layout.maxColumnCount = 2;
			this._layout.useVirtualLayout = true;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			this._layout.typicalItem = item1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayout with smaller maxColumnCount and useVirtualLayout results in wrong view port width",
				200, result.viewPortWidth);
			Assert.assertStrictlyEquals("HorizontalLayout with smaller maxColumnCount and useVirtualLayout results in wrong content width",
				300, result.contentWidth);
		}

		[Test]
		public function testLargerMaxColumnCount():void
		{
			this._layout.maxColumnCount = 4;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayout with larger maxColumnCount results in wrong view port width",
				300, result.viewPortWidth);
			Assert.assertStrictlyEquals("HorizontalLayout with larger maxColumnCount results in wrong content width",
				300, result.contentWidth);
		}

		[Test]
		public function testLargerMaxColumnCountAndUseVirtualLayout():void
		{
			this._layout.maxColumnCount = 4;
			this._layout.useVirtualLayout = true;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			this._layout.typicalItem = item1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayout with larger maxColumnCount and useVirtualLayout results in wrong view port width",
				300, result.viewPortWidth);
			Assert.assertStrictlyEquals("HorizontalLayout with larger maxColumnCount and useVirtualLayout results in wrong content width",
				300, result.contentWidth);
		}

		[Test]
		public function testRequestedColumnCountWithZeroItems():void
		{
			this._layout.requestedColumnCount = 3;
			var items:Vector.<DisplayObject> = new <DisplayObject>[];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayout with requestedColumnCount and zero items results in wrong view port width",
				0, result.viewPortWidth);
			Assert.assertStrictlyEquals("HorizontalLayout with requestedColumnCount and zero items results in wrong content width",
				0, result.contentWidth);
		}

		[Test]
		public function testSmallerRequestedColumnCount():void
		{
			this._layout.requestedColumnCount = 2;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayout with smaller requestedColumnCount results in wrong view port width",
				200, result.viewPortWidth);
			Assert.assertStrictlyEquals("HorizontalLayout with smaller requestedColumnCount results in wrong content width",
				300, result.contentWidth);
		}

		[Test]
		public function testSmallerRequestedColumnCountAndUseVirtualLayout():void
		{
			this._layout.requestedColumnCount = 2;
			this._layout.useVirtualLayout = true;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			this._layout.typicalItem = item1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayout with smaller requestedColumnCount and useVirtualLayout results in wrong view port width",
				200, result.viewPortWidth);
			Assert.assertStrictlyEquals("HorizontalLayout with smaller requestedColumnCount and useVirtualLayout results in wrong content width",
				300, result.contentWidth);
		}

		[Test]
		public function testLargerRequestedColumnCount():void
		{
			this._layout.requestedColumnCount = 4;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayout with larger requestedColumnCount results in wrong view port width",
				400, result.viewPortWidth);
			Assert.assertStrictlyEquals("HorizontalLayout with larger requestedColumnCount results in wrong content width",
				300, result.contentWidth);
		}

		[Test]
		public function testLargerRequestedColumnCountAndUseVirtualLayout():void
		{
			this._layout.requestedColumnCount = 4;
			this._layout.useVirtualLayout = true;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			this._layout.typicalItem = item1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayout with larger requestedColumnCount and useVirtualLayout results in wrong view port width",
				400, result.viewPortWidth);
			Assert.assertStrictlyEquals("HorizontalLayout with larger requestedColumnCount and useVirtualLayout results in wrong content width",
				300, result.contentWidth);
		}

		[Test]
		public function testChildWithCalculatedMinHeightAndPercentHeight():void
		{
			var item1:LayoutGroup = new LayoutGroup();
			item1.layoutData = new HorizontalLayoutData(100, 100);
			var child:Quad = new Quad(100, 100, 0xff00ff);
			item1.addChild(child);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayout without explicit view port height and child with percentHeight and calculated minHeight results in wrong view port height",
				100, result.viewPortHeight);
		}

		[Test]
		public function testChildWithExplicitMinHeightAndPercentHeight():void
		{
			var item1:LayoutGroup = new LayoutGroup();
			item1.layoutData = new HorizontalLayoutData(100, 100);
			var child:Quad = new Quad(100, 100, 0xff00ff);
			item1.minHeight = 200;
			item1.addChild(child);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayout without explicit view port height and child with percentHeight and explicit minHeight results in wrong view port height",
				200, result.viewPortHeight);
			Assert.assertStrictlyEquals("HorizontalLayout without explicit view port height and child with percentHeight and explicit minHeight results in wrong child height",
				200, item1.height);
		}

		[Test]
		public function testChildWithCalculatedMinHeightAndPercentHeightWithExplicitHeight():void
		{
			var item1:LayoutGroup = new LayoutGroup();
			item1.layoutData = new HorizontalLayoutData(100, 100);
			var child:Quad = new Quad(100, 100, 0xff00ff);
			item1.addChild(child);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitHeight = 50;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayout with explicit view port height and child with percentHeight and calculated minHeight results in wrong view port height",
				50, result.viewPortHeight);
			Assert.assertStrictlyEquals("HorizontalLayout with explicit view port height and child with percentHeight and calculated minHeight results in wrong child height",
				50, item1.height);
		}


		[Test]
		public function testChildWithCalculatedMinHeightAndPercentHeightWithViewPortMinHeight():void
		{
			var item1:LayoutGroup = new LayoutGroup();
			item1.layoutData = new HorizontalLayoutData(100, 100);
			var child:Quad = new Quad(100, 100, 0xff00ff);
			item1.addChild(child);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.minHeight = 10;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayout with explicit view port minHeight and child with percentHeight and calculated minHeight results in wrong view port height",
				100, result.viewPortHeight);
			Assert.assertStrictlyEquals("HorizontalLayout with explicit view port minHeight and child with percentHeight and calculated minHeight results in wrong child height",
				100, item1.height);
		}

		[Test]
		public function testChildWithCalculatedHeightAndSmallerCalculatedMinHeightAndPercentHeight():void
		{
			var item1:LayoutGroup = new LayoutGroup();
			item1.layoutData = new HorizontalLayoutData(100, 100);
			var child:LayoutGroup = new LayoutGroup();
			child.width = 100;
			child.height = 100;
			child.minWidth = 50;
			child.minHeight = 50;
			item1.backgroundSkin = child;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalLayout without explicit view port height and child with percentHeight, calculated height, and calculated minHeight results in wrong view port height",
				100, result.viewPortHeight);
			Assert.assertStrictlyEquals("HorizontalLayout without explicit view port height and child with percentHeight, calculated height, and calculated minHeight results in wrong child height",
				100, item1.height);
		}

		[Test]
		public function testTypicalItemExplicitWidthWithoutHasVariableItemDimensions():void
		{
			this._layout.useVirtualLayout = true;
			this._layout.hasVariableItemDimensions = false;

			var item1:LayoutGroup = new LayoutGroup();
			item1.backgroundSkin = new Quad(100, 200);

			var item2:LayoutGroup = new LayoutGroup();
			item2.backgroundSkin = new Quad(150, 50);

			this._layout.typicalItem = item1;

			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertTrue("HorizontalLayout: typicalItem explicitWidth must be NaN when useVirtualLayout is true and hasVariableItemDimensions is false so that it can resize later",
				isNaN(item1.explicitWidth));
			Assert.assertStrictlyEquals("HorizontalLayout: item explicitWidth must be equal to typicalItem width when useVirtualLayout is true and hasVariableItemDimensions is false",
				item1.width, item2.explicitWidth);
		}
	}
}


================================================
FILE: test/source/feathers/tests/HorizontalSpinnerLayoutTests.as
================================================
package feathers.tests
{
	import feathers.layout.HorizontalSpinnerLayout;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.ViewPortBounds;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;

	public class HorizontalSpinnerLayoutTests
	{
		private var _layout:HorizontalSpinnerLayout;

		[Before]
		public function prepare():void
		{
			this._layout = new HorizontalSpinnerLayout();
		}

		[After]
		public function cleanup():void
		{
			this._layout = null;
		}

		[Test]
		public function testMinimumAndMaximumScrollPositionsWhenRepeatItemsIsTrue():void
		{
			this._layout.repeatItems = true;
			var item1:Quad = new Quad(200, 200);
			var item2:Quad = new Quad(200, 200);
			var item3:Quad = new Quad(200, 200);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 200;
			this._layout.typicalItem = item1;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalSpinnerLayout layout() LayoutBoundsResult contentX not equal to Number.NEGATIVE_INFINITY when repeatItems is true and the total item width is larger than the view port width", Number.NEGATIVE_INFINITY, result.contentX);
			Assert.assertStrictlyEquals("HorizontalSpinnerLayout layout() LayoutBoundsResult contentWidth not equal to Number.POSITIVE_INFINITY when repeatItems is true and the total item width is larger than the view port width", Number.POSITIVE_INFINITY, result.contentWidth);
		}

		[Test]
		public function testMinimumAndMaximumScrollPositionsWhenRepeatItemsIsFalse():void
		{
			var itemSize:Number = 200;
			this._layout.repeatItems = false;
			var item1:Quad = new Quad(itemSize, itemSize);
			var item2:Quad = new Quad(itemSize, itemSize);
			var item3:Quad = new Quad(itemSize, itemSize);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 200;
			this._layout.typicalItem = item1;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("HorizontalSpinnerLayout layout() LayoutBoundsResult contentX not equal to 0 when repeatItems is false and the total item width is larger than the view port width", 0, result.contentX);
			Assert.assertStrictlyEquals("HorizontalSpinnerLayout layout() LayoutBoundsResult contentWidth not equal to total width of items minus view port width when repeatItems is false and the total item width is larger than the view port width", items.length * itemSize, result.contentWidth);
		}

		[Test]
		public function testVisibleIndicesWithOneItemVisibleAndRepeatingWithGap():void
		{
			//Github issue #1257
			var itemSize:Number = 256;
			var gap:Number = 64;
			this._layout.useVirtualLayout = true;
			this._layout.gap = gap;
			this._layout.requestedColumnCount = 1;
			var item1:Quad = new Quad(itemSize, itemSize);
			this._layout.typicalItem = item1;
			var result:Vector.<int> = this._layout.getVisibleIndicesAtScrollPosition((itemSize + gap) * 9.8, 0, 320, 320, 5);
			Assert.assertTrue("HorizontalSpinnerLayout getVisibleIndicesAtScrollPosition() does not contain and index that should be visible", result.indexOf(4) >= 0)
		}
	}
}


================================================
FILE: test/source/feathers/tests/ImageLoaderInternalStateTests.as
================================================
package feathers.tests
{
	import org.flexunit.Assert;
	import org.flexunit.async.Async;

	import starling.events.Event;

	public class ImageLoaderInternalStateTests
	{
		private var _loader:ImageLoaderDisposeWatcher;

		[Before]
		public function prepare():void
		{
			this._loader = new ImageLoaderDisposeWatcher();
			TestFeathers.starlingRoot.addChild(this._loader);
		}

		[After]
		public function cleanup():void
		{
			this._loader.removeFromParent(true);
			this._loader = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test(async)]
		public function testDisposeTextureAfterSetSourceToNull():void
		{
			var loader:ImageLoaderDisposeWatcher = this._loader;
			loader.addEventListener(Event.COMPLETE, function():void
			{
				loader.source = null;
			});
			loader.source = "fixtures/red100x100.png";
			loader.validate();
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("Texture not disposed after setting ImageLoader source to null.", loader.hasDisposedTexture);
			}, 200);
		}

		[Test(async,timeout="600")]
		public function testKeepTextureAfterLoadNewImageWithSameDimensions():void
		{
			var isSecondImageLoaded:Boolean = false;
			var loader:ImageLoaderDisposeWatcher = this._loader;
			loader.asyncTextureUpload = false;
			loader.addEventListener(Event.COMPLETE, function():void
			{
				loader.removeEventListener(Event.COMPLETE, arguments.callee);
				loader.source = "fixtures/blue100x100.png";
				loader.validate();
				loader.addEventListener(Event.COMPLETE, function():void
				{
					isSecondImageLoaded = true;
				});
			});
			loader.source = "fixtures/red100x100.png";
			loader.validate();
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("Second image did not complete loading.", isSecondImageLoaded);
				Assert.assertFalse("Texture incorrectly disposed after setting ImageLoader source to image with same dimensions.", loader.hasDisposedTexture);
			}, 400);
		}

		[Test(async,timeout="600")]
		public function testDisposeTextureAfterLoadNewImageWithDifferentDimensions():void
		{
			var isSecondImageLoaded:Boolean = false;
			var loader:ImageLoaderDisposeWatcher = this._loader;
			loader.addEventListener(Event.COMPLETE, function():void
			{
				loader.removeEventListener(Event.COMPLETE, arguments.callee);
				loader.source = "fixtures/green200x200.png";
				loader.validate();
				loader.addEventListener(Event.COMPLETE, function():void
				{
					isSecondImageLoaded = true;
				});
			});
			loader.source = "fixtures/red100x100.png";
			loader.validate();
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("Second image did not complete loading.", isSecondImageLoaded);
				Assert.assertTrue("Texture not disposed after setting ImageLoader source to image with different dimensions.", loader.hasDisposedTexture);
			}, 400);
		}
	}
}

import feathers.controls.ImageLoader;

class ImageLoaderDisposeWatcher extends ImageLoader
{
	override protected function cleanupTexture():void
	{
		if(this._texture && this._isTextureOwner)
		{
			this.hasDisposedTexture = true;
		}
		super.cleanupTexture();
	}
	
	public var hasDisposedTexture:Boolean = false;
}

================================================
FILE: test/source/feathers/tests/ImageLoaderTests.as
================================================
package feathers.tests
{
	import feathers.controls.ImageLoader;
	import feathers.utils.textures.TextureCache;

	import flash.geom.Rectangle;

	import org.flexunit.Assert;
	import org.flexunit.async.Async;

	import starling.events.Event;
	import starling.textures.Texture;
	import starling.utils.ScaleMode;

	public class ImageLoaderTests
	{
		private var _loader:ImageLoader;
		private var _texture:Texture;

		[Before]
		public function prepare():void
		{
			this._loader = new ImageLoader();
			TestFeathers.starlingRoot.addChild(this._loader);
			this._loader.validate();
		}

		[After]
		public function cleanup():void
		{
			this._loader.removeFromParent(true);
			this._loader = null;
			
			if(this._texture !== null)
			{
				this._texture.dispose();
				this._texture = null;
			}

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test(async)]
		public function testCompleteEvent():void
		{
			var completeDispatched:Boolean = false;
			this._loader.addEventListener(Event.COMPLETE, function():void
			{
				completeDispatched = true;
			});
			this._loader.source = "fixtures/red100x100.png";
			this._loader.validate();
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("Event.COMPLETE not dispatched by ImageLoader after loading valid URL.", completeDispatched);
			}, 200);
		}

		[Test(async)]
		public function testIOErrorEvent():void
		{
			var ioErrorDispatched:Boolean = false;
			this._loader.addEventListener(Event.IO_ERROR, function():void
			{
				ioErrorDispatched = true;
			});
			this._loader.source = "fixtures/fake.png";
			this._loader.validate();
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("Event.IO_ERROR not dispatched by ImageLoader after loading invalid URL.", ioErrorDispatched);
			}, 200);
		}

		[Test(async)]
		public function testResize():void
		{
			var resizeDispatched:Boolean = false;
			var loader:ImageLoader = this._loader;
			loader.addEventListener(Event.RESIZE, function():void
			{
				resizeDispatched = true;
			});
			loader.source = "fixtures/red100x100.png";
			loader.validate();
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("Event.RESIZE not dispatched by ImageLoader after loading URL.", resizeDispatched);
				Assert.assertStrictlyEquals("ImageLoader width property not changed after loading URL.", 100, loader.width);
				Assert.assertStrictlyEquals("ImageLoader height property not changed after loading URL.", 100, loader.height);
				Assert.assertStrictlyEquals("ImageLoader minWidth property not changed after loading URL.", 100, loader.minWidth);
				Assert.assertStrictlyEquals("ImageLoader minHeight property not changed after loading URL.", 100, loader.minHeight);
			}, 200);
		}

		[Test(async,timeout="600")]
		public function testResizeWithNewSource():void
		{
			var loader:ImageLoader = this._loader;
			loader.addEventListener(Event.COMPLETE, function():void
			{
				loader.removeEventListener(Event.COMPLETE, arguments.callee);
				loader.source = "fixtures/green200x200.png";
				loader.validate();
			});
			loader.source = "fixtures/red100x100.png";
			loader.validate();
			Async.delayCall(this, function():void
			{
				Assert.assertStrictlyEquals("ImageLoader width property not changed after loading second URL.", 200, loader.width);
				Assert.assertStrictlyEquals("ImageLoader height property not changed after loading second URL.", 200, loader.height);
				Assert.assertStrictlyEquals("ImageLoader minWidth property not changed after loading second URL.", 200, loader.minWidth);
				Assert.assertStrictlyEquals("ImageLoader minHeight property not changed after loading second URL.", 200, loader.minHeight);
			}, 400);
		}

		[Test(async)]
		public function testOriginalSourceDimensionsInCompleteEvent():void
		{
			var completeDispatched:Boolean = false;
			var loader:ImageLoader = this._loader;
			loader.addEventListener(Event.COMPLETE, function():void
			{
				Assert.assertStrictlyEquals("ImageLoader originalSourceWidth property not changed after loading URL.", 100, loader.originalSourceWidth);
				Assert.assertStrictlyEquals("ImageLoader originalSourceHeight property not changed after loading URL.", 100, loader.originalSourceHeight);
				completeDispatched = true;
			});
			loader.source = "fixtures/red100x100.png";
			loader.validate();
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("Event.COMPLETE not dispatched by ImageLoader after loading valid URL.", completeDispatched);
			}, 200);
		}

		[Test(async)]
		public function testScaleFactor():void
		{
			var loader:ImageLoader = this._loader;
			loader.scaleFactor = 2;
			loader.source = "fixtures/green200x200.png";
			loader.validate();
			Async.delayCall(this, function():void
			{
				Assert.assertStrictlyEquals("ImageLoader originalSourceWidth property not changed after loading URL.", 200, loader.originalSourceWidth);
				Assert.assertStrictlyEquals("ImageLoader originalSourceHeight property not changed after loading URL.", 200, loader.originalSourceHeight);
				Assert.assertStrictlyEquals("ImageLoader width property not changed after loading URL.", 100, loader.width);
				Assert.assertStrictlyEquals("ImageLoader height property not changed after loading URL.", 100, loader.height);
				Assert.assertStrictlyEquals("ImageLoader minWidth property not changed after loading URL.", 100, loader.minWidth);
				Assert.assertStrictlyEquals("ImageLoader minHeight property not changed after loading URL.", 100, loader.minHeight);
			}, 200);
		}

		[Test(async)]
		public function testCacheRetainCountOnComplete():void
		{
			var textureCache:TextureCache = new TextureCache(2);
			var source:String = "fixtures/green200x200.png";
			var loader:ImageLoader = this._loader;
			loader.source = source;
			loader.textureCache = textureCache;
			var retainCount:int = 0;
			loader.addEventListener(Event.COMPLETE, function():void
			{
				retainCount = textureCache.getRetainCount(source);
			});
			loader.validate();
			Async.delayCall(this, function():void
			{
				textureCache.dispose();
				Assert.assertStrictlyEquals("ImageLoader textureCache retain count incorrect after load complete.", 1, retainCount);
			}, 200);
		}

		[Test(async)]
		public function testReleaseTextureFromCacheAfterSetSourceToNull():void
		{
			var textureCache:TextureCache = new TextureCache(2);
			var source:String = "fixtures/green200x200.png";
			var loader:ImageLoader = this._loader;
			loader.source = source;
			loader.textureCache = textureCache;
			loader.validate();
			Async.delayCall(this, function():void
			{
				loader.source = null;
				var retainCount:int = textureCache.getRetainCount(source);
				textureCache.dispose();
				Assert.assertStrictlyEquals("ImageLoader textureCache retain count incorrect after set source to null.", 0, retainCount);
			}, 200);
		}

		[Test]
		public function testAutoSizeWidthScaleModeNone():void
		{
			var textureSize:Number = 20;
			var loaderHeight:Number = 200;
			this._texture = Texture.fromColor(textureSize, textureSize);
			this._loader.source = this._texture;
			this._loader.height = loaderHeight;
			this._loader.scaleMode = ScaleMode.NONE;
			this._loader.validate();

			Assert.assertStrictlyEquals("ImageLoader calculates incorrect width when using ScaleMode.NONE and setting larger explicit height.",
				textureSize, this._loader.width);
			Assert.assertStrictlyEquals("ImageLoader calculates incorrect minWidth when using ScaleMode.NONE and setting larger explicit height.",
				textureSize, this._loader.minWidth);
		}

		[Test]
		public function testAutoSizeHeightScaleModeNone():void
		{
			var textureSize:Number = 20;
			var loaderWidth:Number = 200;
			this._texture = Texture.fromColor(textureSize, textureSize);
			this._loader.source = this._texture;
			this._loader.width = loaderWidth;
			this._loader.scaleMode = ScaleMode.NONE;
			this._loader.validate();

			Assert.assertStrictlyEquals("ImageLoader calculates incorrect height when using ScaleMode.NONE and setting larger explicit width.",
				textureSize, this._loader.height);
			Assert.assertStrictlyEquals("ImageLoader calculates incorrect minHeight when using ScaleMode.NONE and setting larger explicit width.",
				textureSize, this._loader.minHeight);
		}

		[Test]
		public function testAutoSizeWidthAfterSettingHeightLarger():void
		{
			var textureWidth:Number = 20;
			var textureHeight:Number = 15;
			var expectedWidth:Number = 200;
			var updatedHeight:Number = 150;
			this._texture = Texture.fromColor(textureWidth, textureHeight);
			this._loader.source = this._texture;
			this._loader.height = updatedHeight;
			this._loader.scaleMode = ScaleMode.SHOW_ALL;
			this._loader.validate();

			Assert.assertStrictlyEquals("ImageLoader calculates incorrect width when setting explicit height larger than texture height.",
				expectedWidth, this._loader.width);
			Assert.assertStrictlyEquals("ImageLoader calculates incorrect minWidth when setting explicit height larger than texture height.",
				expectedWidth, this._loader.minWidth);
		}

		[Test]
		public function testAutoSizeHeightAfterSettingWidthLarger():void
		{
			var textureWidth:Number = 20;
			var textureHeight:Number = 15;
			var updatedWidth:Number = 200;
			var expectedHeight:Number = 150;
			this._texture = Texture.fromColor(textureWidth, textureHeight);
			this._loader.source = this._texture;
			this._loader.width = updatedWidth;
			this._loader.scaleMode = ScaleMode.SHOW_ALL;
			this._loader.validate();

			Assert.assertStrictlyEquals("ImageLoader calculates incorrect height when setting explicit width larger than texture width.",
				expectedHeight, this._loader.height);
			Assert.assertStrictlyEquals("ImageLoader calculates incorrect minHeight when setting explicit width larger than texture width.",
				expectedHeight, this._loader.minHeight);
		}

		[Test]
		public function testIgnoreMaintainAspectRationWithScale9Grid():void
		{
			var textureWidth:Number = 20;
			var textureHeight:Number = 15;
			var updatedWidth:Number = 200;
			this._texture = Texture.fromColor(textureWidth, textureHeight);
			this._loader.source = this._texture;
			this._loader.scale9Grid = new Rectangle(2, 2, 18, 11);
			this._loader.width = updatedWidth;
			this._loader.scaleMode = ScaleMode.SHOW_ALL;
			this._loader.validate();

			Assert.assertStrictlyEquals("ImageLoader calculates incorrect height when setting explicit width larger than texture width and using scale9Grid.",
				textureHeight, this._loader.height);
		}

		[Test]
		public function testExplicitMaxWidthWithLargerMinWidth():void
		{
			var textureWidth:Number = 20;
			var textureHeight:Number = 15;
			var maxWidth:Number = 10;
			var maxHeight:Number = 5;
			this._texture = Texture.fromColor(textureWidth, textureHeight);
			this._loader.source = this._texture;
			this._loader.maxWidth = maxWidth;
			this._loader.maxHeight = maxHeight;
			this._loader.validate();

			Assert.assertStrictlyEquals("ImageLoader calculates incorrect width when setting explicit max width smaller than measured min width.",
				maxWidth, this._loader.width);
			Assert.assertStrictlyEquals("ImageLoader calculates incorrect height when setting explicit max height smaller than measured min height.",
				maxHeight, this._loader.height);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ImageSkinTests.as
================================================
package feathers.tests
{
	import feathers.skins.ImageSkin;

	import org.flexunit.Assert;

	import starling.textures.Texture;

	public class ImageSkinTests
	{
		private static const STATE_ONE:String = "one";
		private static const STATE_TWO:String = "two";

		private static const DEFAULT_COLOR:uint = 0xcccccc;
		private static const COLOR_ONE:uint = 0x999999;
		private static const COLOR_TWO:uint = 0x666666;

		private var _skin:ImageSkin;
		private var _context:StateContext;

		private var _texture1:Texture;
		private var _texture2:Texture;
		private var _texture3:Texture;

		[Before]
		public function prepare():void
		{
			this._context = new StateContext();
			this._context.currentState = STATE_ONE;
			TestFeathers.starlingRoot.addChild(this._context);

			this._skin = new ImageSkin(null);
			this._context.addChild(this._skin);
			this._skin.stateContext = this._context;
		}

		[After]
		public function cleanup():void
		{
			this._context.removeFromParent(true);
			this._context = null;
			this._skin = null;

			if(this._texture1 !== null)
			{
				this._texture1.dispose();
				this._texture1 = null;
			}

			if(this._texture2 !== null)
			{
				this._texture2.dispose();
				this._texture2 = null;
			}

			if(this._texture3 !== null)
			{
				this._texture3.dispose();
				this._texture3 = null;
			}

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testGetTextureForStateWithoutSetTextureForState():void
		{
			Assert.assertNull("ImageSkin getTextureForState(STATE_ONE) must be null when setTextureForState() is not called", this._skin.getTextureForState(STATE_ONE));
			Assert.assertNull("ImageSkin getTextureForState(STATE_TWO) must be null when setTextureForState() is not called", this._skin.getTextureForState(STATE_TWO));
		}

		[Test]
		public function testDefaultTextureWithNoStateTextures():void
		{
			Assert.assertStrictlyEquals("ImageSkin texture must be null when defaultTexture and setTextureForState() are not used", null, this._skin.texture);
		}

		[Test]
		public function testGetTextureForState():void
		{
			this._texture1 = Texture.fromColor(10, 10, 0xff00ff);
			this._skin.defaultTexture = this._texture1;
			this._texture2 = Texture.fromColor(10, 10, 0xff0000);
			this._skin.setTextureForState(STATE_ONE, this._texture2);
			this._texture3 = Texture.fromColor(10, 10, 0x00ff00);
			this._skin.setTextureForState(STATE_TWO, this._texture3);

			Assert.assertStrictlyEquals("ImageSkin getTextureForState(STATE_ONE) does not match value passed to setTextureForState()", this._texture2, this._skin.getTextureForState(STATE_ONE));
			Assert.assertStrictlyEquals("ImageSkin getTextureForState(STATE_TWO) does not match value passed to setTextureForState()", this._texture3, this._skin.getTextureForState(STATE_TWO));
		}

		[Test]
		public function testDefaultTexture():void
		{
			this._texture1 = Texture.fromColor(10, 10, 0xff00ff);
			this._skin.defaultTexture = this._texture1;

			Assert.assertStrictlyEquals("ImageSkin texture is not defaultTexture when texture not provided for current state", this._texture1, this._skin.texture);

			this._context.isEnabled = false;
			Assert.assertStrictlyEquals("ImageSkin texture is not defaultTexture when disabled texture not provided", this._texture1, this._skin.texture);

			this._context.isEnabled = true;

			this._context.currentState = STATE_ONE;
			Assert.assertStrictlyEquals("ImageSkin texture is not defaultTexture when texture not provided for specific state", this._texture1, this._skin.texture);

			this._context.currentState = STATE_TWO;
			Assert.assertStrictlyEquals("ImageSkin texture is not defaultTexture when texture not provided for specific state", this._texture1, this._skin.texture);
		}

		[Test]
		public function testCurrentTextureWithSetTextureForState():void
		{
			this._texture1 = Texture.fromColor(10, 10, 0xff00ff);
			this._skin.defaultTexture = this._texture1;
			this._texture2 = Texture.fromColor(10, 10, 0xff0000);
			this._skin.setTextureForState(STATE_ONE, this._texture2);
			this._texture3 = Texture.fromColor(10, 10, 0x00ff00);
			this._skin.setTextureForState(STATE_TWO, this._texture3);

			this._context.currentState = STATE_ONE;
			Assert.assertStrictlyEquals("ImageSkin texture is does not match texture passed to setTextureForState() for current state", this._texture2, this._skin.texture);

			this._context.currentState = STATE_TWO;
			Assert.assertStrictlyEquals("ImageSkin texture is does not match texture passed to setTextureForState() for current state", this._texture3, this._skin.texture);
		}

		[Test]
		public function testGetColorForStateWithoutSetColorForState():void
		{
			Assert.assertStrictlyEquals("ImageSkin getColorForState(STATE_ONE) must be uint.MAX_VALUE when setColorForState() is not called", uint.MAX_VALUE, this._skin.getColorForState(STATE_ONE));
			Assert.assertStrictlyEquals("ImageSkin getColorForState(STATE_TWO) must be uint.MAX_VALUE when setColorForState() is not called", uint.MAX_VALUE, this._skin.getColorForState(STATE_TWO));
		}

		[Test]
		public function testDefaultColorWithNoStateColors():void
		{
			Assert.assertStrictlyEquals("ImageSkin color must be 0xffffff when defaultColor and setColorForState() are not used", 0xffffff, this._skin.color);
		}

		[Test]
		public function testGetColorForState():void
		{
			this._skin.defaultColor = DEFAULT_COLOR;
			this._skin.setColorForState(STATE_ONE, COLOR_ONE);
			this._skin.setColorForState(STATE_TWO, COLOR_TWO);

			Assert.assertStrictlyEquals("ImageSkin getColorForState(STATE_ONE) does not match value passed to setColorForState()", COLOR_ONE, this._skin.getColorForState(STATE_ONE));
			Assert.assertStrictlyEquals("ImageSkin getColorForState(STATE_TWO) does not match value passed to setColorForState()", COLOR_TWO, this._skin.getColorForState(STATE_TWO));
		}

		[Test]
		public function testDefaultColor():void
		{
			this._skin.defaultColor = DEFAULT_COLOR;

			Assert.assertStrictlyEquals("ImageSkin color is not defaultColor when color not provided for current state", DEFAULT_COLOR, this._skin.color);

			this._context.isEnabled = false;
			Assert.assertStrictlyEquals("ImageSkin color is not defaultColor when disabled color not provided", DEFAULT_COLOR, this._skin.color);

			this._context.isEnabled = true;

			this._context.currentState = STATE_ONE;
			Assert.assertStrictlyEquals("ImageSkin color is not defaultColor when color not provided for specific state", DEFAULT_COLOR, this._skin.color);

			this._context.currentState = STATE_TWO;
			Assert.assertStrictlyEquals("ImageSkin color is not defaultColor when color not provided for specific state", DEFAULT_COLOR, this._skin.color);
		}

		[Test]
		public function testCurrentColorWithSetColorForState():void
		{
			this._skin.defaultColor = DEFAULT_COLOR;
			this._skin.setColorForState(STATE_ONE, COLOR_ONE);
			this._skin.setColorForState(STATE_TWO, COLOR_TWO);

			this._context.currentState = STATE_ONE;
			Assert.assertStrictlyEquals("ImageSkin color is does not match color passed to setColorForState() for current state", COLOR_ONE, this._skin.color);

			this._context.currentState = STATE_TWO;
			Assert.assertStrictlyEquals("ImageSkin color is does not match color passed to setColorForState() for current state", COLOR_TWO, this._skin.color);
		}

		[Test]
		public function testClearExplicitDimensions():void
		{
			var textureWidth:Number = 150;
			var textureHeight:Number = 200;
			var explicitWidth:Number = 250;
			var explicitHeight:Number = 300;
			this._texture1 = Texture.fromColor(textureWidth, textureHeight, 0xff00ff);
			this._skin.defaultTexture = this._texture1;
			this._skin.width = explicitWidth;
			this._skin.height = explicitHeight;

			Assert.assertStrictlyEquals("ImageSkin width is does not match explicit width",
				explicitWidth, this._skin.width);
			Assert.assertStrictlyEquals("ImageSkin width is does not match explicit height",
				explicitHeight, this._skin.height);

			this._skin.width = NaN;
			this._skin.height = NaN;

			Assert.assertStrictlyEquals("ImageSkin width is does not match texture width",
				textureWidth, this._skin.width);
			Assert.assertStrictlyEquals("ImageSkin width is does not match texture height",
				textureHeight, this._skin.height);
		}
	}
}

import feathers.core.FeathersControl;
import feathers.core.IStateContext;
import feathers.events.FeathersEventType;

class StateContext extends FeathersControl implements IStateContext
{
	public function StateContext()
	{
		super();
	}
	
	protected var _currentState:String;
	
	public function get currentState():String
	{
		return this._currentState;
	}

	public function set currentState(value:String):void
	{
		if(this._currentState === value)
		{
			return;
		}
		this._currentState = value;
		this.dispatchEventWith(FeathersEventType.STATE_CHANGE);
	}
}

================================================
FILE: test/source/feathers/tests/InvalidateTests.as
================================================
package feathers.tests
{
	import feathers.controls.LayoutGroup;
	import feathers.core.FeathersControl;
	import feathers.core.ValidationQueue;

	import org.flexunit.Assert;

	public class InvalidateTests
	{
		private var _control:LayoutGroup;
		private var _control2:InvalidationControl;

		[Before]
		public function prepare():void
		{
			this._control = new LayoutGroup();
			TestFeathers.starlingRoot.addChild(this._control);
		}

		[After]
		public function cleanup():void
		{
			this._control.removeFromParent(true);
			this._control = null;

			if(this._control2)
			{
				this._control2.removeFromParent(true);
				this._control2 = null;
			}
			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testIsInvalidAfterInitialize():void
		{
			Assert.assertTrue("Control must be invalid after initialize", this._control.isInvalid());
			Assert.assertTrue("Control must be invalid with flag after initialize", this._control.isInvalid(FeathersControl.INVALIDATION_FLAG_DATA));
		}

		[Test]
		public function testNotInvalidAfterValidate():void
		{
			this._control.validate();
			Assert.assertFalse("Control must not be invalid after validate", this._control.isInvalid());
			Assert.assertFalse("Control must not be invalid with flag after initialize", this._control.isInvalid(FeathersControl.INVALIDATION_FLAG_DATA));
		}

		[Test]
		public function testInvalidateWithNoFlags():void
		{
			this._control.validate();
			this._control.invalidate();
			Assert.assertTrue("Control must be invalid after invalidate()", this._control.isInvalid());
			Assert.assertTrue("Control must be invalid with flag after invalidate()", this._control.isInvalid(FeathersControl.INVALIDATION_FLAG_DATA));
		}

		[Test]
		public function testInvalidateWithFlag():void
		{
			this._control.validate();
			this._control.invalidate(FeathersControl.INVALIDATION_FLAG_DATA);
			Assert.assertTrue("Control must be invalid after invalidate() with flag", this._control.isInvalid());
			Assert.assertTrue("Control must be invalid with flag after invalidate() with same flag", this._control.isInvalid(FeathersControl.INVALIDATION_FLAG_DATA));
			Assert.assertFalse("Control must not be invalid with flag after invalidate() with different flag", this._control.isInvalid(FeathersControl.INVALIDATION_FLAG_STYLES));
		}

		[Test(expects="Error")]
		public function testInfiniteInvalidateDuringValidation():void
		{
			this._control2 = new InvalidationControl();
			TestFeathers.starlingRoot.addChild(this._control2);
			//run the full queue, forcing the control to repeatedly validate
			//which will throw an error
			ValidationQueue.forStarling(TestFeathers.starlingRoot.stage.starling).advanceTime(0);
		}
	}
}

import feathers.controls.LayoutGroup;

class InvalidationControl extends LayoutGroup
{
	public function InvalidationControl()
	{
		super();
	}

	override protected function draw():void
	{
		super.draw();
		this.invalidate();
	}
}

================================================
FILE: test/source/feathers/tests/KeyToSelectTests.as
================================================
package feathers.tests
{
	import feathers.core.FocusManager;
	import feathers.tests.supportClasses.CustomToggle;
	import feathers.utils.keyboard.KeyToSelect;

	import flash.ui.Keyboard;

	import org.flexunit.Assert;

	import starling.display.Stage;
	import starling.events.Event;
	import starling.events.KeyboardEvent;

	public class KeyToSelectTests
	{
		private var _target:CustomToggle;
		private var _keyToSelect:KeyToSelect;

		[Before]
		public function prepare():void
		{
			this._target = new CustomToggle();
			TestFeathers.starlingRoot.addChild(this._target);
			this._target.validate();
			
			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, true);

			this._keyToSelect = new KeyToSelect(this._target);
		}

		[After]
		public function cleanup():void
		{
			this._target.removeFromParent(true);
			this._target = null;

			this._keyToSelect = null;

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
			Assert.assertFalse("FocusManager not disabled on cleanup.", FocusManager.isEnabledForStage(TestFeathers.starlingRoot.stage));
		}

		[Test]
		public function testIgnoreKeyAfterFocusOut():void
		{
			this._target.isSelected = false;
			FocusManager.focus = this._target;
			FocusManager.focus = null;

			var hasChanged:Boolean = false;
			this._target.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched", hasChanged);
			Assert.assertFalse("isSelected was incorrectly changed to true after key to select when not in focus", this._target.isSelected);
		}

		[Test]
		public function testChangeEvent():void
		{
			this._target.isSelected = false;
			FocusManager.focus = this._target;

			var hasChanged:Boolean = false;
			this._target.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("isSelected was not changed to true after key to select", this._target.isSelected);
		}

		[Test]
		public function testDisabled():void
		{
			this._target.isSelected = false;
			this._keyToSelect.isEnabled = false;
			FocusManager.focus = this._target;

			var hasChanged:Boolean = false;
			this._target.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched when disabled", hasChanged);
			Assert.assertFalse("isSelected was incorrectly changed to true after key to select when disabled", this._target.isSelected);
		}

		[Test]
		public function testNoErrorWhenDisabledAfterRemove():void
		{
			this._target.removeFromParent(false);
			this._keyToSelect.isEnabled = false;
		}

		[Test]
		public function testCancelKeyBeforeChangeEvent():void
		{
			this._target.isSelected = false;
			FocusManager.focus = this._target;

			var hasChanged:Boolean = false;
			this._target.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.ESCAPE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.ESCAPE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched after cancel key", hasChanged);
			Assert.assertFalse("isSelected was incorrectly changed to true after cancel key", this._target.isSelected);
		}

		[Test]
		public function testDeselect():void
		{
			this._keyToSelect.keyToDeselect = true;
			this._target.isSelected = true;
			FocusManager.focus = this._target;
			
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertFalse("isSelected was not changed to false when keyToDeselect set to true", this._target.isSelected);
		}

		[Test]
		public function testDisabledDeselect():void
		{
			this._keyToSelect.keyToDeselect = false;
			this._target.isSelected = true;
			FocusManager.focus = this._target;
			
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertTrue("isSelected was incorrectly changed to false when keyToDeselect set to false", this._target.isSelected);
		}

		[Test]
		public function testRemovedBeforeTriggeredEvent():void
		{
			this._target.isSelected = false;

			var hasChanged:Boolean = false;
			this._target.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});

			var stage:Stage = this._target.stage;
			stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));

			this._target.removeFromParent(false);

			stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));

			//while it's good to check that Event.CHANGE isn't dispatched,
			//this test also ensures that no runtime errors are thrown after the
			//target is removed (its stage property is null, and that is used
			//by KeyToSelect)

			Assert.assertFalse("Event.CHANGE was incorrectly dispatched when target was removed", hasChanged);
			Assert.assertFalse("isSelected was incorrectly changed to true when target was removed", this._target.isSelected);
		}
	}
}


================================================
FILE: test/source/feathers/tests/KeyToTriggerTests.as
================================================
package feathers.tests
{
	import feathers.core.FocusManager;
	import feathers.tests.supportClasses.CustomToggle;
	import feathers.utils.keyboard.KeyToTrigger;

	import flash.ui.Keyboard;

	import org.flexunit.Assert;

	import starling.display.Stage;
	import starling.events.Event;
	import starling.events.KeyboardEvent;

	public class KeyToTriggerTests
	{
		private var _target:CustomToggle;
		private var _keyToTrigger:KeyToTrigger;

		[Before]
		public function prepare():void
		{
			this._target = new CustomToggle();
			this._target.setSize(200, 200);
			TestFeathers.starlingRoot.addChild(this._target);

			this._keyToTrigger = new KeyToTrigger(this._target);

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, true);
		}

		[After]
		public function cleanup():void
		{
			this._target.removeFromParent(true);
			this._target = null;

			this._keyToTrigger = null;

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
			Assert.assertFalse("FocusManager not disabled on cleanup.", FocusManager.isEnabledForStage(TestFeathers.starlingRoot.stage));
		}

		[Test]
		public function testTriggeredEvent():void
		{
			FocusManager.focus = this._target;
			var hasTriggered:Boolean = false;
			this._target.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertTrue("Event.TRIGGERED was not dispatched", hasTriggered);
		}

		[Test]
		public function testDisabled():void
		{
			this._keyToTrigger.isEnabled = false;
			FocusManager.focus = this._target;

			var hasTriggered:Boolean = false;
			this._target.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertFalse("Event.TRIGGERED was incorrectly dispatched when disabled", hasTriggered);
		}

		[Test]
		public function testNoErrorWhenDisabledAfterRemove():void
		{
			this._target.removeFromParent(false);
			this._keyToTrigger.isEnabled = false;
		}

		[Test]
		public function testCancelKeyBeforeTriggeredEvent():void
		{
			FocusManager.focus = this._target;
			var hasTriggered:Boolean = false;
			this._target.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.ESCAPE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.ESCAPE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertFalse("Event.TRIGGERED was incorrectly dispatched when touch moved out of bounds", hasTriggered);
		}

		[Test]
		public function testRemovedBeforeTriggeredEvent():void
		{
			var hasTriggered:Boolean = false;
			this._target.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});

			var stage:Stage = this._target.stage;
			stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));

			this._target.removeFromParent(false);

			stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));

			//while it's good to check that Event.TRIGGERED isn't dispatched,
			//this test also ensures that no runtime errors are thrown after the
			//target is removed (its stage property is null, and that may be
			//used by KeyToTrigger)
			Assert.assertFalse("Event.TRIGGERED was incorrectly dispatched when target was removed", hasTriggered);
		}
	}
}


================================================
FILE: test/source/feathers/tests/LabelMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.Label;
	import feathers.controls.LayoutGroup;
	import feathers.controls.text.BitmapFontTextRenderer;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class LabelMeasurementTests
	{
		private static const SIMPLE_TEXT:String = "Huge Mayo";
		
		private static const BACKGROUND_WIDTH:Number = 200;
		private static const BACKGROUND_HEIGHT:Number = 250;
		private static const BACKGROUND_WIDTH2:Number = 125;
		private static const BACKGROUND_HEIGHT2:Number = 100;
		private static const BACKGROUND_WIDTH3:Number = 150;
		private static const BACKGROUND_HEIGHT3:Number = 175;
		
		private static const PADDING_TOP:Number = 4;
		private static const PADDING_RIGHT:Number = 10;
		private static const PADDING_BOTTOM:Number = 3;
		private static const PADDING_LEFT:Number = 16;
		
		protected var textRenderer:BitmapFontTextRenderer;
		protected var label:Label;

		[Before]
		public function prepare():void
		{
			this.label = new Label();
			TestFeathers.starlingRoot.addChild(this.label);

			this.textRenderer = new BitmapFontTextRenderer();
			TestFeathers.starlingRoot.addChild(this.textRenderer);
		}

		[After]
		public function cleanup():void
		{
			this.textRenderer.removeFromParent(true);
			this.textRenderer = null;

			this.label.removeFromParent(true);
			this.label = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		protected function addSimpleBackgroundSkin():void
		{
			this.label.backgroundSkin = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT);
		}

		protected function addComplexBackgroundSkin():void
		{
			var backgroundSkin:LayoutGroup = new LayoutGroup();
			backgroundSkin.minWidth = BACKGROUND_WIDTH2;
			backgroundSkin.minHeight = BACKGROUND_HEIGHT2;
			backgroundSkin.width = BACKGROUND_WIDTH3;
			backgroundSkin.height = BACKGROUND_HEIGHT3;
			this.label.backgroundSkin = backgroundSkin;
		}

		[Test]
		public function testAutoSize():void
		{
			this.textRenderer.text = SIMPLE_TEXT;
			this.textRenderer.validate();
			
			this.label.text = SIMPLE_TEXT;
			this.label.validate();

			Assert.assertStrictlyEquals("Label width not equal to text renderer width", this.textRenderer.width, this.label.width);
			Assert.assertStrictlyEquals("Label height not equal to text renderer height", this.textRenderer.height, this.label.height);
			Assert.assertStrictlyEquals("Label minWidth not equal to 0 when explicitWidth not set", 0, this.label.minWidth);
			Assert.assertStrictlyEquals("Label minHeight not equal to text renderer height", this.textRenderer.height, this.label.minHeight);
		}

		[Test]
		public function testAutoSizeWithPadding():void
		{
			this.textRenderer.text = SIMPLE_TEXT;
			this.textRenderer.validate();

			this.label.paddingTop = PADDING_TOP;
			this.label.paddingRight = PADDING_RIGHT;
			this.label.paddingBottom = PADDING_BOTTOM;
			this.label.paddingLeft = PADDING_LEFT;
			this.label.text = SIMPLE_TEXT;
			this.label.validate();

			Assert.assertStrictlyEquals("Label width not equal to text renderer width plus padding left and padding right", this.textRenderer.width + PADDING_LEFT + PADDING_RIGHT, this.label.width);
			Assert.assertStrictlyEquals("Label height not equal to text renderer height plus padding top and padding bottom", this.textRenderer.height + PADDING_TOP + PADDING_BOTTOM, this.label.height);
			Assert.assertStrictlyEquals("Label minWidth not equal padding left and padding right", PADDING_LEFT + PADDING_RIGHT, this.label.minWidth);
			Assert.assertStrictlyEquals("Label minHeight not equal to text renderer height plus padding top and padding bottom", this.textRenderer.height + PADDING_TOP + PADDING_BOTTOM, this.label.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleBackground():void
		{
			this.addSimpleBackgroundSkin();
			this.label.text = SIMPLE_TEXT;
			this.label.validate();

			Assert.assertStrictlyEquals("Label width not equal to simple background width", BACKGROUND_WIDTH, this.label.width);
			Assert.assertStrictlyEquals("Label height not equal to simple background height", BACKGROUND_HEIGHT, this.label.height);
			Assert.assertStrictlyEquals("Label minWidth not equal to simple background width", BACKGROUND_WIDTH, this.label.minWidth);
			Assert.assertStrictlyEquals("Label minHeight not equal to simple background height", BACKGROUND_HEIGHT, this.label.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleBackgroundAndPadding():void
		{
			this.textRenderer.text = SIMPLE_TEXT;
			this.textRenderer.validate();

			this.addSimpleBackgroundSkin();
			this.label.paddingTop = PADDING_TOP;
			this.label.paddingRight = PADDING_RIGHT;
			this.label.paddingBottom = PADDING_BOTTOM;
			this.label.paddingLeft = PADDING_LEFT;
			this.label.text = SIMPLE_TEXT;
			this.label.validate();

			Assert.assertStrictlyEquals("Label width not equal to simple background width", BACKGROUND_WIDTH, this.label.width);
			Assert.assertStrictlyEquals("Label height not equal to simple background height", BACKGROUND_HEIGHT, this.label.height);
			Assert.assertStrictlyEquals("Label minWidth not equal to simple background width", BACKGROUND_WIDTH, this.label.minWidth);
			Assert.assertStrictlyEquals("Label minHeight not equal to simple background height", BACKGROUND_HEIGHT, this.label.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexBackground():void
		{
			this.addComplexBackgroundSkin();
			this.label.text = SIMPLE_TEXT;
			this.label.validate();

			Assert.assertStrictlyEquals("Label width not equal to simple background width", BACKGROUND_WIDTH3, this.label.width);
			Assert.assertStrictlyEquals("Label height not equal to simple background height", BACKGROUND_HEIGHT3, this.label.height);
			Assert.assertStrictlyEquals("Label minWidth not equal to simple background width", BACKGROUND_WIDTH2, this.label.minWidth);
			Assert.assertStrictlyEquals("Label minHeight not equal to simple background height", BACKGROUND_HEIGHT2, this.label.minHeight);
		}

		[Test]
		public function testChangeTextToResizeSkin():void
		{
			this.label.text = "I am the very model of a modern major general";
			this.label.backgroundSkin = new Quad(10, 10, 0xff00ff);
			this.label.backgroundDisabledSkin = new Quad(10, 10, 0xff00ff);
			this.label.validate();
			//the text's dimensions were large enough to make label bigger than
			//the skin's dimensions
			this.label.text = "";
			//switch to a different skin before validation
			this.label.isEnabled = false;
			this.label.validate();
			//now switch back to the original skin, and the dimensions could
			//be wrong if they weren't restored
			this.label.isEnabled = true;
			this.label.validate();
			Assert.assertStrictlyEquals("The width of the Label was not calculated correctly after changing to a different skin and changing text dimensions.",
				10, this.label.width);
			Assert.assertStrictlyEquals("The height of the Label was not calculated correctly after changing to a different skin and changing text dimensions",
				10, this.label.height);
		}
	}
}


================================================
FILE: test/source/feathers/tests/LabelTests.as
================================================
package feathers.tests
{
	import feathers.controls.Label;
	import feathers.tests.supportClasses.DisposeFlagQuad;

	import org.flexunit.Assert;

	public class LabelTests
	{
		protected var label:Label;

		[Before]
		public function prepare():void
		{
			this.label = new Label();
			TestFeathers.starlingRoot.addChild(this.label);
		}

		[After]
		public function cleanup():void
		{
			this.label.removeFromParent(true);
			this.label = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testSkinsDisposed():void
		{
			var backgroundSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this.label.backgroundSkin = backgroundSkin;
			var backgroundDisabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this.label.backgroundDisabledSkin = backgroundDisabledSkin;
			this.label.validate();
			this.label.dispose();
			Assert.assertTrue("backgroundSkin not disposed when Label disposed.", backgroundSkin.isDisposed);
			Assert.assertTrue("backgroundDisabledSkin not disposed when Label disposed.", backgroundDisabledSkin.isDisposed);
		}
	}
}


================================================
FILE: test/source/feathers/tests/LayoutGroupHorizontalLayoutTests.as
================================================
package feathers.tests
{
	import feathers.controls.LayoutGroup;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.VerticalAlign;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class LayoutGroupHorizontalLayoutTests
	{
		private static const PADDING_TOP:Number = 6;
		private static const PADDING_RIGHT:Number = 8;
		private static const PADDING_BOTTOM:Number = 2;
		private static const PADDING_LEFT:Number = 10;
		private static const GAP:Number = 5;
		private static const FIRST_GAP:Number = 7;
		private static const LAST_GAP:Number = 6;
		private static const CHILD1_WIDTH:Number = 200;
		private static const CHILD1_HEIGHT:Number = 100;
		private static const CHILD2_WIDTH:Number = 150;
		private static const CHILD2_HEIGHT:Number = 75;
		private static const CHILD3_WIDTH:Number = 75;
		private static const CHILD3_HEIGHT:Number = 50;
		private static const CHILD4_WIDTH:Number = 10;
		private static const CHILD4_HEIGHT:Number = 20;
		
		private var _group:LayoutGroup;
		private var _layout:HorizontalLayout;

		[Before]
		public function prepare():void
		{
			this._group = new LayoutGroup();
			this._layout = new HorizontalLayout();
			this._group.layout = this._layout;
			TestFeathers.starlingRoot.addChild(this._group);
		}

		[After]
		public function cleanup():void
		{
			this._group.removeFromParent(true);
			this._group = null;
			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testDimensionsWithNoChildren():void
		{
			this._group.validate();
			Assert.assertStrictlyEquals("HorizontalLayout width not equal to 0 with no children.", 0, this._group.width);
			Assert.assertStrictlyEquals("HorizontalLayout height not equal to 0 with no children.", 0, this._group.height);
		}

		[Test]
		public function testDimensionsWithPaddingGapAndNoChildren():void
		{
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			this._group.validate();
			Assert.assertStrictlyEquals("HorizontalLayout width not equal to sum of left and right padding with no children.", PADDING_LEFT + PADDING_RIGHT, this._group.width);
			Assert.assertStrictlyEquals("HorizontalLayout height not equal to sum of top and bottom padding with no children.", PADDING_TOP + PADDING_BOTTOM, this._group.height);
		}

		[Test]
		public function testDimensionsWithOneChild():void
		{
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("HorizontalLayout width not equal to child width.", CHILD1_WIDTH, this._group.width);
			Assert.assertStrictlyEquals("HorizontalLayout height not equal to child height.", CHILD1_HEIGHT, this._group.height);
		}

		[Test]
		public function testDimensionsWithPaddingGapAndOneChild():void
		{
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("HorizontalLayout width not equal to sum of left and right padding and width of child.", CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._group.width);
			Assert.assertStrictlyEquals("HorizontalLayout height not equal to sum of top and bottom padding and height of child.", CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._group.height);
		}

		[Test]
		public function testDimensionsWithTwoChildren():void
		{
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.validate();
			var maxChildHeight:Number = Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT);
			Assert.assertStrictlyEquals("HorizontalLayout width not equal to sum of child widths.", CHILD1_WIDTH + CHILD2_WIDTH, this._group.width);
			Assert.assertStrictlyEquals("HorizontalLayout height not equal to max height of children.", maxChildHeight, this._group.height);
		}

		[Test]
		public function testDimensionsWithPaddingGapAndTwoChildren():void
		{
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.validate();
			var maxChildHeight:Number = Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT);
			Assert.assertStrictlyEquals("HorizontalLayout width not equal to sum of left and right padding, gap, and sum of child widths.", CHILD1_WIDTH + CHILD2_WIDTH + GAP + PADDING_LEFT + PADDING_RIGHT, this._group.width);
			Assert.assertStrictlyEquals("HorizontalLayout height not equal to sum of top and bottom padding and max height of children.", maxChildHeight + PADDING_TOP + PADDING_BOTTOM, this._group.height);
		}

		[Test]
		public function testHeightWithMaxHeightLargerThanChild():void
		{
			this._group.maxHeight = CHILD1_HEIGHT + 100;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("HorizontalLayout height not equal to child height when maxHeight is larger than child height.", CHILD1_HEIGHT, this._group.height);
		}

		[Test]
		public function testHeightWithMaxHeightSmallerThanChild():void
		{
			this._group.maxHeight = CHILD1_HEIGHT / 2;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("HorizontalLayout height not equal to maxHeight when maxHeight is smaller than child height.", this._group.maxHeight, this._group.height);
		}

		[Test]
		public function testWidthWithGapAndTwoChildren():void
		{
			this._layout.gap = GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("HorizontalLayout width not equal to gap plus sum of child widths.", CHILD1_WIDTH + CHILD2_WIDTH + GAP, this._group.width);
		}

		[Test]
		public function testWidthWithMaxWidthLargerThanChild():void
		{
			this._group.maxWidth = CHILD1_WIDTH + 100;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("HorizontalLayout width not equal to child width when maxWidth is larger than child width.", CHILD1_WIDTH, this._group.width);
		}

		[Test]
		public function testWidthWithMaxWidthSmallerThanChild():void
		{
			this._group.maxWidth = CHILD1_WIDTH / 2;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("HorizontalLayout width not equal to maxWidth when maxWidth is smaller than child width.", this._group.maxWidth, this._group.width);
		}

		[Test]
		public function testWidthWithFirstGapAndTwoChildren():void
		{
			this._layout.gap = GAP;
			this._layout.firstGap = FIRST_GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("HorizontalLayout width not equal to gap plus sum of child widths.", CHILD1_WIDTH + CHILD2_WIDTH + FIRST_GAP, this._group.width);
		}

		[Test]
		public function testWidthWithLastGapAndTwoChildren():void
		{
			this._layout.gap = GAP;
			this._layout.lastGap = LAST_GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("HorizontalLayout width not equal to gap plus sum of child widths when using last gap with two children.", CHILD1_WIDTH + CHILD2_WIDTH + GAP, this._group.width);
		}

		[Test]
		public function testWidthWithFirstGapAndThreeChildren():void
		{
			this._layout.gap = GAP;
			this._layout.firstGap = FIRST_GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD3_WIDTH, CHILD3_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("HorizontalLayout width not equal to sum of child widths, plus first gap, plus gap, with three children.", CHILD1_WIDTH + CHILD2_WIDTH + CHILD3_WIDTH + GAP + FIRST_GAP, this._group.width);
		}

		[Test]
		public function testWidthWithLastGapAndThreeChildren():void
		{
			this._layout.gap = GAP;
			this._layout.lastGap = LAST_GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD3_WIDTH, CHILD3_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("HorizontalLayout width not equal to sum of child widths, plus gap, plus last gap, with three children.", CHILD1_WIDTH + CHILD2_WIDTH + CHILD3_WIDTH + GAP + LAST_GAP, this._group.width);
		}

		[Test]
		public function testWidthWithFirstAndLastGapAndFourChildren():void
		{
			this._layout.gap = GAP;
			this._layout.firstGap = FIRST_GAP;
			this._layout.lastGap = LAST_GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD3_WIDTH, CHILD3_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD4_WIDTH, CHILD4_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("HorizontalLayout width not equal to sum of child widths, plus first gap, plus gap, plus last gap, with four children.", CHILD1_WIDTH + CHILD2_WIDTH + CHILD3_WIDTH + CHILD4_WIDTH + FIRST_GAP + GAP + LAST_GAP, this._group.width);
		}

		[Test]
		public function testChildXWithHorizontalAlignCenterAndMaxWidthSmallerThanChild():void
		{
			this._layout.horizontalAlign = HorizontalAlign.CENTER;
			var child:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._group.maxWidth = child.width / 2;
			this._group.addChild(child);
			this._group.validate();
			Assert.assertStrictlyEquals("Child x position incorrectly set to value less than zero with HorizontalAlign.CENTER", 0, child.x);
		}

		[Test]
		public function testChildYWithVerticalAlignMiddleAndMaxHeightSmallerThanChild():void
		{
			this._layout.verticalAlign = VerticalAlign.MIDDLE;
			var child:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._group.maxHeight = child.height / 2;
			this._group.addChild(child);
			this._group.validate();
			Assert.assertStrictlyEquals("Child y position incorrectly set to value less than zero with VerticalAlign.MIDDLE", 0, child.y);
		}

		[Test]
		public function testChildXIsIntegerWithHorizontalAlignCenter():void
		{
			this._layout.horizontalAlign = HorizontalAlign.CENTER;
			var child:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._group.width = child.width + 111;
			this._group.addChild(child);
			this._group.validate();
			Assert.assertStrictlyEquals("Child x position incorrectly set to non-integer with HorizontalAlign.CENTER", Math.round(child.x), child.x);
		}

		[Test]
		public function testChildYIsIntegerWithVerticalAlignMiddle():void
		{
			this._layout.verticalAlign = VerticalAlign.MIDDLE;
			var child:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._group.height = child.height + 111;
			this._group.addChild(child);
			this._group.validate();
			Assert.assertStrictlyEquals("Child y position incorrectly set to non-integer with VerticalAlign.MIDDLE", Math.round(child.y), child.y);
		}
	}
}


================================================
FILE: test/source/feathers/tests/LayoutGroupInternalStateTests.as
================================================
package feathers.tests
{
	import org.flexunit.Assert;

	import starling.display.Quad;
	import starling.events.Event;

	public class LayoutGroupInternalStateTests
	{

		private var _group:ExposedLayoutGroup;

		[Before]
		public function prepare():void
		{
			this._group = new ExposedLayoutGroup();
			TestFeathers.starlingRoot.addChild(this._group);
			this._group.validate();
		}

		[After]
		public function cleanup():void
		{
			this._group.removeFromParent(true);
			this._group = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testItemsLengthAfterAdd():void
		{
			var child:Quad = new Quad(100, 100, 0xff00ff);
			this._group.addChild(child);
			Assert.assertStrictlyEquals("LayoutGroup items not properly updated after adding child.", 1, this._group.internalItems.length);
		}

		[Test]
		public function testItemsLengthAfterRemove():void
		{
			var child:Quad = new Quad(100, 100, 0xff00ff);
			this._group.addChild(child);
			this._group.removeChild(child);
			Assert.assertStrictlyEquals("LayoutGroup items not properly updated after removing child.", 0, this._group.internalItems.length);
		}

		[Test]
		public function testItemsLengthAfterRemoveInRemovedFromStage():void
		{
			var child1:Quad = new Quad(100, 100, 0xff00ff);
			this._group.addChild(child1);
			var child2:Quad = new Quad(100, 100, 0xffff00);
			this._group.addChild(child2);
			child2.addEventListener(Event.REMOVED_FROM_STAGE, function():void
			{
				child1.removeFromParent(true);
			});
			child2.removeFromParent(true);
			Assert.assertStrictlyEquals("LayoutGroup items not properly updated after removing child in Event.REMOVED_FROM_STAGE listener for other child.", 0, this._group.internalItems.length);
		}
	}
}

import feathers.controls.LayoutGroup;

import starling.display.DisplayObject;

class ExposedLayoutGroup extends LayoutGroup
{
	public function get internalItems():Vector.<DisplayObject>
	{
		return this.items;
	}
}

================================================
FILE: test/source/feathers/tests/LayoutGroupMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.AutoSizeMode;
	import feathers.controls.LayoutGroup;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class LayoutGroupMeasurementTests
	{
		//note: the background width is purposefully smaller than the item width
		private static const BACKGROUND_WIDTH:Number = 200;
		//note: the background height is purposefully larger than the item height
		private static const BACKGROUND_HEIGHT:Number = 250;
		private static const BACKGROUND_MIN_WIDTH:Number = 180;
		private static const BACKGROUND_MIN_HEIGHT:Number = 190;

		//note: the item width is purposefully larger than the background width
		private static const ITEM_WIDTH:Number = 210;
		//note: the item height is purposefully smaller than the background height
		private static const ITEM_HEIGHT:Number = 160;

		private static const ITEM_WIDTH2:Number = 190;
		private static const ITEM_HEIGHT2:Number = 170;

		private static const ITEM_PIVOTX:Number = 105;
		private static const ITEM_PIVOTY:Number = 80;

		private var _group:LayoutGroup;
		private var _group2:LayoutGroup;

		[Before]
		public function prepare():void
		{
			this._group = new LayoutGroup();
			TestFeathers.starlingRoot.addChild(this._group);
			this._group.validate();
		}

		[After]
		public function cleanup():void
		{
			this._group.removeFromParent(true);
			this._group = null;
			
			if(this._group2)
			{
				this._group2.removeFromParent(true);
				this._group2 = null;
			}

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}
		
		private function addSimpleBackground():void
		{
			this._group.backgroundSkin = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT);
		}

		private function addComplexBackground():void
		{
			var backgroundSkin:LayoutGroup = new LayoutGroup();
			backgroundSkin.setSize(BACKGROUND_WIDTH, BACKGROUND_HEIGHT);
			backgroundSkin.minWidth = BACKGROUND_MIN_WIDTH;
			backgroundSkin.minHeight = BACKGROUND_MIN_HEIGHT;
			this._group.backgroundSkin = backgroundSkin;
		}

		[Test]
		public function testAutoSizeNoChildrenNoBackgroundAndNoLayout():void
		{
			this._group.validate();
			Assert.assertStrictlyEquals("The width of the layout group was not calculated correctly when empty.",
				0, this._group.width);
			Assert.assertStrictlyEquals("The height of the layout group was not calculated correctly when empty.",
				0, this._group.height);
			Assert.assertStrictlyEquals("The minWidth of the layout group was not calculated correctly when empty.",
				0, this._group.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the layout group was not calculated correctly when empty.",
				0, this._group.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleBackgroundAndNoChildren():void
		{
			this.addSimpleBackground();
			this._group.validate();
			Assert.assertStrictlyEquals("The width of the layout group was not calculated correctly with background skin and no children.",
				BACKGROUND_WIDTH, this._group.width);
			Assert.assertStrictlyEquals("The height of the layout group was not calculated correctly with background skin and no children.",
				BACKGROUND_HEIGHT, this._group.height);
			Assert.assertStrictlyEquals("The minWidth of the layout group was not calculated correctly with background skin and no children.",
				BACKGROUND_WIDTH, this._group.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the layout group was not calculated correctly with background skin and no children.",
				BACKGROUND_HEIGHT, this._group.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexBackgroundAndNoChildren():void
		{
			this.addComplexBackground();
			this._group.validate();
			Assert.assertStrictlyEquals("The width of the layout group was not calculated correctly with complex background skin and no children.",
				BACKGROUND_WIDTH, this._group.width);
			Assert.assertStrictlyEquals("The height of the layout group was not calculated correctly with complex background skin and no children.",
				BACKGROUND_HEIGHT, this._group.height);
			
			//this is a little different than other components. the layout needs
			//to account for the full background dimensions, so the minimum
			//dimensions cannot be passed to the layout. to use minimum
			//dimensions with a LayoutGroup, they need to be set on the
			//LayoutGroup directly!
			Assert.assertStrictlyEquals("The minWidth of the layout group was not calculated correctly with complex background skin and no children.",
				BACKGROUND_WIDTH, this._group.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the layout group was not calculated correctly with complex background skin and no children.",
				BACKGROUND_HEIGHT, this._group.minHeight);
		}

		[Test]
		public function testAutoSizeModeStage():void
		{
			this._group.autoSizeMode = AutoSizeMode.STAGE;
			this._group.validate();
			Assert.assertStrictlyEquals("The width of the layout group was not calculated correctly with autoSizeMode set to AutoSizeMode.STAGE.",
				this._group.stage.stageWidth, this._group.width);
			Assert.assertStrictlyEquals("The height of the layout group was not calculated correctly with autoSizeMode set to AutoSizeMode.STAGE.",
				this._group.stage.stageHeight, this._group.height);
			Assert.assertStrictlyEquals("The minWidth of the layout group was not calculated correctly with autoSizeMode set to AutoSizeMode.STAGE.",
				this._group.stage.stageWidth, this._group.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the layout group was not calculated correctly with autoSizeMode set to AutoSizeMode.STAGE.",
				this._group.stage.stageHeight, this._group.minHeight);
		}

		[Test]
		public function testAutoSizeModeStageWithoutParent():void
		{
			this._group2 = new LayoutGroup();
			this._group2.autoSizeMode = AutoSizeMode.STAGE;
			this._group2.validate();
			Assert.assertStrictlyEquals("The width of the LayoutGroup was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._group2.width);
			Assert.assertStrictlyEquals("The height of the LayoutGroup was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._group2.height);
			Assert.assertStrictlyEquals("The minWidth of the LayoutGroup was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._group2.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the LayoutGroup was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._group2.minHeight);
		}

		[Test]
		public function testAutoSizeModeStageWithValidateBeforeAdd():void
		{
			this._group2 = new LayoutGroup();
			this._group2.autoSizeMode = AutoSizeMode.STAGE;
			this._group2.validate();
			TestFeathers.starlingRoot.addChild(this._group2);
			this._group2.validate();
			Assert.assertStrictlyEquals("The width of the LayoutGroup was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._group2.width);
			Assert.assertStrictlyEquals("The height of the LayoutGroup was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._group2.height);
			Assert.assertStrictlyEquals("The minWidth of the LayoutGroup was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._group2.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the LayoutGroup was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._group2.minHeight);
		}

		[Test]
		public function testAutoSizeModeStageWithChildBeyondStageEdges():void
		{
			this._group.autoSizeMode = AutoSizeMode.STAGE;
			var child:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			child.x = this._group.stage.stageWidth + 100;
			child.y = this._group.stage.stageHeight + 100;
			this._group.addChild(child);
			this._group.validate();
			Assert.assertStrictlyEquals("The width of the layout group was not calculated correctly with autoSizeMode set to AutoSizeMode.STAGE.",
				this._group.stage.stageWidth, this._group.width);
			Assert.assertStrictlyEquals("The height of the layout group was not calculated correctly with autoSizeMode set to AutoSizeMode.STAGE.",
				this._group.stage.stageHeight, this._group.height);
			Assert.assertStrictlyEquals("The minWidth of the layout group was not calculated correctly with autoSizeMode set to AutoSizeMode.STAGE.",
				this._group.stage.stageWidth, this._group.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the layout group was not calculated correctly with autoSizeMode set to AutoSizeMode.STAGE.",
				this._group.stage.stageHeight, this._group.minHeight);
		}

		[Test]
		public function testAutoSizeWithChildAtOrigin():void
		{
			this._group.addChild(new Quad(ITEM_WIDTH, ITEM_HEIGHT));
			this._group.validate();
			Assert.assertStrictlyEquals("The width of the layout group was not calculated correctly.",
				ITEM_WIDTH, this._group.width);
			Assert.assertStrictlyEquals("The height of the layout group was not calculated correctly.",
				ITEM_HEIGHT, this._group.height);
			Assert.assertStrictlyEquals("The minWidth of the layout group was not calculated correctly.",
				ITEM_WIDTH, this._group.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the layout group was not calculated correctly.",
				ITEM_HEIGHT, this._group.minHeight);
		}

		[Test]
		public function testAutoSizeWithChild():void
		{
			var child:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			child.x = 120;
			child.y = 130;
			this._group.addChild(child);
			this._group.validate();
			Assert.assertStrictlyEquals("The width of the layout group was not calculated correctly.",
				child.x + ITEM_WIDTH, this._group.width);
			Assert.assertStrictlyEquals("The height of the layout group was not calculated correctly.",
				child.y + ITEM_HEIGHT, this._group.height);
			Assert.assertStrictlyEquals("The minWidth of the layout group was not calculated correctly.",
				child.x + ITEM_WIDTH, this._group.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the layout group was not calculated correctly.",
				child.y + ITEM_HEIGHT, this._group.minHeight);
		}

		[Test]
		public function testAutoSizeWithChildPositionedWithBoundsFullyInNegative():void
		{
			var child:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			child.x = -420;
			child.y = -430;
			this._group.addChild(child);
			this._group.validate();
			Assert.assertStrictlyEquals("The width of the layout group was not calculated correctly.",
				0, this._group.width);
			Assert.assertStrictlyEquals("The height of the layout group was not calculated correctly.",
				0, this._group.height);
			Assert.assertStrictlyEquals("The minWidth of the layout group was not calculated correctly.",
				0, this._group.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the layout group was not calculated correctly.",
				0, this._group.minHeight);
		}

		[Test]
		public function testAutoSizeWithChildPositionedWithBoundsInBothPositiveAndNegative():void
		{
			var child:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			child.x = -Math.round(ITEM_WIDTH / 4);
			child.y = -Math.round(ITEM_HEIGHT / 3);
			this._group.addChild(child);
			this._group.validate();
			Assert.assertStrictlyEquals("The width of the layout group was not calculated correctly.",
				child.x + ITEM_WIDTH, this._group.width);
			Assert.assertStrictlyEquals("The height of the layout group was not calculated correctly.",
				child.y + ITEM_HEIGHT, this._group.height);
			Assert.assertStrictlyEquals("The minWidth of the layout group was not calculated correctly.",
				child.x + ITEM_WIDTH, this._group.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the layout group was not calculated correctly.",
				child.y + ITEM_HEIGHT, this._group.minHeight);
		}

		[Test]
		public function testAutoSizeWithMultipleChildren():void
		{
			var child1:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			child1.x = 0;
			child1.y = 130;
			this._group.addChild(child1);
			var child2:Quad = new Quad(ITEM_WIDTH2, ITEM_HEIGHT2);
			child2.x = 120;
			child2.y = 0;
			this._group.addChild(child2);
			this._group.validate();
			Assert.assertStrictlyEquals("The width of the layout group was not calculated correctly.",
				child2.x + ITEM_WIDTH2, this._group.width);
			Assert.assertStrictlyEquals("The height of the layout group was not calculated correctly.",
				child1.y + ITEM_HEIGHT, this._group.height);
			Assert.assertStrictlyEquals("The minWidth of the layout group was not calculated correctly.",
				child2.x + ITEM_WIDTH2, this._group.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the layout group was not calculated correctly.",
				child1.y + ITEM_HEIGHT, this._group.minHeight);
		}

		[Test]
		public function testAutoSizeChildAndSimpleBackground():void
		{
			this._group.addChild(new Quad(ITEM_WIDTH, ITEM_HEIGHT));
			this.addSimpleBackground();
			this._group.validate();
			Assert.assertStrictlyEquals("The width of the layout group was not calculated correctly.",
				ITEM_WIDTH, this._group.width);
			Assert.assertStrictlyEquals("The height of the layout group was not calculated correctly.",
				BACKGROUND_HEIGHT, this._group.height);
			Assert.assertStrictlyEquals("The minWidth of the layout group was not calculated correctly.",
				ITEM_WIDTH, this._group.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the layout group was not calculated correctly.",
				BACKGROUND_HEIGHT, this._group.minHeight);
		}

		[Test]
		public function testAutoSizeChildWithPivots():void
		{
			var child:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			child.pivotX = ITEM_PIVOTX;
			child.pivotY = ITEM_PIVOTY;
			child.x = 120;
			child.y = 130;
			this._group.addChild(child);
			this._group.validate();
			var groupWidth:Number = child.x - ITEM_PIVOTX + ITEM_WIDTH;
			var groupHeight:Number = child.y - ITEM_PIVOTY + ITEM_HEIGHT;
			Assert.assertStrictlyEquals("The width of the layout group was not calculated correctly.",
				groupWidth, this._group.width);
			Assert.assertStrictlyEquals("The height of the layout group was not calculated correctly.",
				groupHeight, this._group.height);
			Assert.assertStrictlyEquals("The minWidth of the layout group was not calculated correctly.",
				groupWidth, this._group.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the layout group was not calculated correctly.",
				groupHeight, this._group.minHeight);
		}

		[Test]
		public function testRemoveChildToResizeSkin():void
		{
			var child:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			this._group.addChild(child);
			this._group.backgroundSkin = new Quad(10, 10, 0xff00ff);
			this._group.backgroundDisabledSkin = new Quad(10, 10, 0xff00ff);
			this._group.validate();
			//the child's dimensions were large enough to make group bigger
			//than the skin's dimensions
			this._group.removeChild(child);
			//switch to a different skin before validation
			this._group.isEnabled = false;
			this._group.validate();
			//now switch back to the original skin, and the dimensions could
			//be wrong if they weren't restored
			this._group.isEnabled = true;
			this._group.validate();
			Assert.assertStrictlyEquals("The width of the LayoutGroup was not calculated correctly after changing to a different skin and removing larger child.",
				10, this._group.width);
			Assert.assertStrictlyEquals("The height of the LayoutGroup was not calculated correctly after changing to a different skin and removing larger child.",
				10, this._group.height);
		}
	}
}


================================================
FILE: test/source/feathers/tests/LayoutGroupTests.as
================================================
package feathers.tests
{
	import feathers.controls.AutoSizeMode;
	import feathers.controls.Button;
	import feathers.controls.LayoutGroup;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.tests.supportClasses.AssertViewPortBoundsLayout;
	import feathers.tests.supportClasses.DisposeFlagQuad;

	import org.flexunit.Assert;

	import starling.display.Quad;
	import starling.events.Event;

	public class LayoutGroupTests
	{
		//note: the background width is purposefully smaller than the item width
		private static const BACKGROUND_WIDTH:Number = 200;
		//note: the background height is purposefully larger than the item height
		private static const BACKGROUND_HEIGHT:Number = 250;
		
		private static const LARGE_BACKGROUND_WIDTH:Number = 400;
		private static const LARGE_BACKGROUND_HEIGHT:Number = 400;

		//note: the item width is purposefully larger than the background width
		private static const ITEM_WIDTH:Number = 210;
		//note: the item height is purposefully smaller than the background height
		private static const ITEM_HEIGHT:Number = 160;

		private var _group:LayoutGroup;

		[Before]
		public function prepare():void
		{
			this._group = new LayoutGroup();
			TestFeathers.starlingRoot.addChild(this._group);
			this._group.validate();
		}

		[After]
		public function cleanup():void
		{
			this._group.removeFromParent(true);
			this._group = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testResizeBackgroundWithSmallerMaxDimensions():void
		{
			this._group.maxWidth = BACKGROUND_WIDTH / 3;
			this._group.maxHeight = BACKGROUND_HEIGHT / 3;
			var backgroundSkin:Quad = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT);
			this._group.backgroundSkin = backgroundSkin;
			this._group.validate();
			Assert.assertStrictlyEquals("The LayoutGroup with smaller maxWidth did not set the width of the background skin.",
				this._group.maxWidth, backgroundSkin.width);
			Assert.assertStrictlyEquals("The LayoutGroup with smaller maxHeight did not set the height of the background skin.",
				this._group.maxHeight, backgroundSkin.height);
		}

		[Test]
		public function testResizeBackgroundWithLargerMinDimensions():void
		{
			this._group.minWidth = 3 * BACKGROUND_WIDTH;
			this._group.minHeight = 3 * BACKGROUND_HEIGHT;
			var backgroundSkin:Quad = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT);
			this._group.backgroundSkin = backgroundSkin;
			this._group.validate();
			Assert.assertStrictlyEquals("The LayoutGroup with larger minWidth did not set the width of the background skin.",
				this._group.minWidth, backgroundSkin.width);
			Assert.assertStrictlyEquals("The LayoutGroup with larger minHeight did not set the height of the background skin.",
				this._group.minHeight, backgroundSkin.height);
		}

		[Test]
		public function testNoErrorValidatingWithoutStage():void
		{
			var group:LayoutGroup = new LayoutGroup();
			group.validate();
			group.dispose();
		}

		[Test]
		public function testDefaultAutoSizeMode():void
		{
			this._group.validate();
			Assert.assertStrictlyEquals("The default value of LayoutGroup autoSizeMode must be AutoSizeMode.CONTENT, if not root.", AutoSizeMode.CONTENT, this._group.autoSizeMode);
		}

		[Test]
		public function testChildPositionWithLargerBackground():void
		{
			var child:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			this._group.addChild(child);
			this._group.backgroundSkin = new Quad(LARGE_BACKGROUND_WIDTH, LARGE_BACKGROUND_HEIGHT);
			var layout:VerticalLayout = new VerticalLayout();
			layout.horizontalAlign = HorizontalAlign.CENTER;
			layout.verticalAlign = VerticalAlign.MIDDLE;
			this._group.layout = layout;
			this._group.validate();
			Assert.assertTrue("The layout group does not account for the background skin width when passing bounds to the layout.",
				child.x > 0);
			Assert.assertTrue("The layout group does not account for the background skin width when passing bounds to the layout.",
				child.y > 0);
		}

		[Test]
		public function testResizeWhenAddingChild():void
		{
			var originalWidth:Number = this._group.width;
			var originalHeight:Number = this._group.height;
			var hasResized:Boolean = false;
			this._group.addEventListener(Event.RESIZE, function(event:Event):void
			{
				hasResized = true;
			});
			this._group.addChild(new Quad(ITEM_WIDTH, ITEM_HEIGHT));
			this._group.validate();
			Assert.assertTrue("Event.RESIZE was not dispatched", hasResized);
			Assert.assertFalse("The width of the layout group was not changed.",
				originalWidth === this._group.width);
			Assert.assertFalse("The height of the layout group was not changed.",
				originalHeight === this._group.height);
		}

		[Test]
		public function testResizeWhenRemovingChild():void
		{
			var child:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			this._group.addChild(child);
			this._group.validate();
			var originalWidth:Number = this._group.width;
			var originalHeight:Number = this._group.height;

			var hasResized:Boolean = false;
			this._group.addEventListener(Event.RESIZE, function(event:Event):void
			{
				hasResized = true;
			});
			this._group.removeChild(child);
			this._group.validate();
			Assert.assertTrue("Event.RESIZE was not dispatched", hasResized);
			Assert.assertFalse("The width of the layout group was not changed.",
				originalWidth === this._group.width);
			Assert.assertFalse("The height of the layout group was not changed.",
				originalHeight === this._group.height);
		}

		[Test]
		public function testResizeWhenResizingFeathersControlChild():void
		{
			var child:Button = new Button();
			child.defaultSkin = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			this._group.addChild(child);
			this._group.validate();

			var originalWidth:Number = this._group.width;
			var originalHeight:Number = this._group.height;
			var hasResized:Boolean = false;
			this._group.addEventListener(Event.RESIZE, function(event:Event):void
			{
				hasResized = true;
			});
			child.width = ITEM_WIDTH * 2;
			child.height = ITEM_HEIGHT * 2;
			this._group.validate();
			Assert.assertTrue("Event.RESIZE was not dispatched", hasResized);
			Assert.assertFalse("The width of the layout group was not changed.",
				originalWidth === this._group.width);
			Assert.assertFalse("The height of the layout group was not changed.",
				originalHeight === this._group.height);
		}

		[Test]
		public function testSkinsDisposed():void
		{
			var backgroundSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._group.backgroundSkin = backgroundSkin;
			var backgroundDisabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._group.backgroundDisabledSkin = backgroundDisabledSkin;
			this._group.validate();
			this._group.dispose();
			Assert.assertTrue("backgroundSkin not disposed when LayoutGroup disposed.", backgroundSkin.isDisposed);
			Assert.assertTrue("backgroundDisabledSkin not disposed when LayoutGroup disposed.", backgroundDisabledSkin.isDisposed);
		}

		[Test]
		public function testViewPortBoundsValues():void
		{
			this._group.layout = new AssertViewPortBoundsLayout();
			this._group.validate();
		}
	}
}

================================================
FILE: test/source/feathers/tests/LayoutGroupValidationTests.as
================================================
package feathers.tests
{
	import org.flexunit.Assert;

	public class LayoutGroupValidationTests
	{
		private var _group:CustomGroup;

		[Before]
		public function prepare():void
		{
			this._group = new CustomGroup();
			TestFeathers.starlingRoot.addChild(this._group);
		}

		[After]
		public function cleanup():void
		{
			this._group.removeFromParent(true);
			this._group = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testResizeChildBeforeLayout():void
		{
			this._group.updateChildBeforeLayout = true;
			this._group.validate();
			Assert.assertFalse("LayoutGroup: must not be invalid if child resizes before layout is applied.",
				this._group.isInvalid());
		}

		[Test]
		public function testResizeChildAfterLayout():void
		{
			this._group.updateChildBeforeLayout = false;
			this._group.validate();
			Assert.assertTrue("LayoutGroup: must be invalid if child resizes after layout is applied.",
				this._group.isInvalid());
		}
	}
}

import feathers.controls.LayoutGroup;
import feathers.controls.Button;

class CustomGroup extends LayoutGroup
{
	private var _child:Button;

	public var updateChildBeforeLayout:Boolean = true;

	override protected function initialize():void
	{
		super.initialize();

		this._child = new Button();
		this._child.label = "Click Me";
		this.addChild(this._child);
	}

	override protected function draw():void
	{
		if(this.updateChildBeforeLayout)
		{
			this.updateChild();
		}
		super.draw();
		if(!this.updateChildBeforeLayout)
		{
			this.updateChild();
		}
	}

	private function updateChild():void
	{
		this._child.width = Math.random() * 100;
		this._child.width = 150;
	}
}

================================================
FILE: test/source/feathers/tests/LayoutGroupVerticalLayoutTests.as
================================================
package feathers.tests
{
	import feathers.controls.LayoutGroup;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.layout.ViewPortBounds;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;

	public class LayoutGroupVerticalLayoutTests
	{
		private static const PADDING_TOP:Number = 6;
		private static const PADDING_RIGHT:Number = 8;
		private static const PADDING_BOTTOM:Number = 2;
		private static const PADDING_LEFT:Number = 10;
		private static const GAP:Number = 5;
		private static const FIRST_GAP:Number = 7;
		private static const LAST_GAP:Number = 6;
		private static const CHILD1_WIDTH:Number = 200;
		private static const CHILD1_HEIGHT:Number = 100;
		private static const CHILD2_WIDTH:Number = 150;
		private static const CHILD2_HEIGHT:Number = 75;
		private static const CHILD3_WIDTH:Number = 75;
		private static const CHILD3_HEIGHT:Number = 50;
		private static const CHILD4_WIDTH:Number = 10;
		private static const CHILD4_HEIGHT:Number = 20;
		
		private var _group:LayoutGroup;
		private var _layout:VerticalLayout;

		[Before]
		public function prepare():void
		{
			this._group = new LayoutGroup();
			this._layout = new VerticalLayout();
			this._group.layout = this._layout;
			TestFeathers.starlingRoot.addChild(this._group);
		}

		[After]
		public function cleanup():void
		{
			this._group.removeFromParent(true);
			this._group = null;
			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testDimensionsWithNoChildren():void
		{
			this._group.validate();
			Assert.assertStrictlyEquals("VerticalLayout width not equal to 0 with no children.", 0, this._group.width);
			Assert.assertStrictlyEquals("VerticalLayout height not equal to 0 with no children.", 0, this._group.height);
		}

		[Test]
		public function testDimensionsWithPaddingGapAndNoChildren():void
		{
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			this._group.validate();
			Assert.assertStrictlyEquals("VerticalLayout width not equal to sum of left and right padding with no children.", PADDING_LEFT + PADDING_RIGHT, this._group.width);
			Assert.assertStrictlyEquals("VerticalLayout height not equal to sum of top and bottom padding with no children.", PADDING_TOP + PADDING_BOTTOM, this._group.height);
		}

		[Test]
		public function testDimensionsWithOneChild():void
		{
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("VerticalLayout width not equal to child width.", CHILD1_WIDTH, this._group.width);
			Assert.assertStrictlyEquals("VerticalLayout height not equal to child height.", CHILD1_HEIGHT, this._group.height);
		}

		[Test]
		public function testDimensionsWithPaddingGapAndOneChild():void
		{
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("VerticalLayout width not equal to sum of left and right padding and width of child.", CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._group.width);
			Assert.assertStrictlyEquals("VerticalLayout height not equal to sum of top and bottom padding and height of child.", CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._group.height);
		}

		[Test]
		public function testDimensionsWithTwoChildren():void
		{
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.validate();
			var maxChildWidth:Number = Math.max(CHILD1_WIDTH, CHILD2_WIDTH);
			Assert.assertStrictlyEquals("VerticalLayout width not equal to max width of children.", maxChildWidth, this._group.width);
			Assert.assertStrictlyEquals("VerticalLayout height not equal to sum of child heights.", CHILD1_HEIGHT + CHILD2_HEIGHT, this._group.height);
		}

		[Test]
		public function testDimensionsWithPaddingGapAndTwoChildren():void
		{
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.validate();
			var maxChildWidth:Number = Math.max(CHILD1_WIDTH, CHILD2_WIDTH);
			Assert.assertStrictlyEquals("VerticalLayout width not equal to sum of left and right padding and max width of children.", maxChildWidth + PADDING_LEFT + PADDING_RIGHT, this._group.width);
			Assert.assertStrictlyEquals("VerticalLayout height not equal to sum of top and bottom padding, gap, and sum of child heights.", CHILD1_HEIGHT + CHILD2_HEIGHT + GAP + PADDING_TOP + PADDING_BOTTOM, this._group.height);
		}

		[Test]
		public function testWidthWithMaxWidthLargerThanChild():void
		{
			this._group.maxWidth = CHILD1_WIDTH + 100;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("VerticalLayout width not equal to child width when maxWidth is larger than child width.", CHILD1_WIDTH, this._group.width);
		}

		[Test]
		public function testWidthWithMaxWidthSmallerThanChild():void
		{
			this._group.maxWidth = CHILD1_WIDTH / 2;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("VerticalLayout width not equal to maxWidth when maxWidth is smaller than child width.", this._group.maxWidth, this._group.width);
		}

		[Test]
		public function testHeightWithGapAndTwoChildren():void
		{
			this._layout.gap = GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("VerticalLayout height not equal to gap plus sum of child heights.", CHILD1_HEIGHT + CHILD2_HEIGHT + GAP, this._group.height);
		}

		[Test]
		public function testHeightWithMaxHeightLargerThanChild():void
		{
			this._group.maxHeight = CHILD1_HEIGHT + 100;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("VerticalLayout height not equal to child height when maxHeight is larger than child width.", CHILD1_HEIGHT, this._group.height);
		}

		[Test]
		public function testHeightWithMaxHeightSmallerThanChild():void
		{
			this._group.maxHeight = CHILD1_HEIGHT / 2;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("VerticalLayout height not equal to maxHeight when maxHeight is smaller than child height.", this._group.maxHeight, this._group.height);
		}

		[Test]
		public function testHeightWithFirstGapAndTwoChildren():void
		{
			this._layout.gap = GAP;
			this._layout.firstGap = FIRST_GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("VerticalLayout height not equal to first gap plus sum of child heights.", CHILD1_HEIGHT + CHILD2_HEIGHT + FIRST_GAP, this._group.height);
		}

		[Test]
		public function testHeightWithLastGapAndTwoChildren():void
		{
			this._layout.gap = GAP;
			this._layout.lastGap = LAST_GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("VerticalLayout height not equal to gap plus sum of child heights when using last gap with two children.", CHILD1_HEIGHT + CHILD2_HEIGHT + GAP, this._group.height);
		}

		[Test]
		public function testHeightWithFirstGapAndThreeChildren():void
		{
			this._layout.gap = GAP;
			this._layout.firstGap = FIRST_GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD3_WIDTH, CHILD3_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("VerticalLayout height not equal to sum of child heights, plus first gap, plus gap, with three children.", CHILD1_HEIGHT + CHILD2_HEIGHT + CHILD3_HEIGHT + GAP + FIRST_GAP, this._group.height);
		}

		[Test]
		public function testHeightWithLastGapAndThreeChildren():void
		{
			this._layout.gap = GAP;
			this._layout.lastGap = LAST_GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD3_WIDTH, CHILD3_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("VerticalLayout height not equal to sum of child heights, plus gap, plus last gap, with three children.", CHILD1_HEIGHT + CHILD2_HEIGHT + CHILD3_HEIGHT + GAP + LAST_GAP, this._group.height);
		}

		[Test]
		public function testHeightWithFirstAndLastGapAndFourChildren():void
		{
			this._layout.gap = GAP;
			this._layout.firstGap = FIRST_GAP;
			this._layout.lastGap = LAST_GAP;
			this._group.addChild(new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD3_WIDTH, CHILD3_HEIGHT, 0xff00ff));
			this._group.addChild(new Quad(CHILD4_WIDTH, CHILD4_HEIGHT, 0xff00ff));
			this._group.validate();
			Assert.assertStrictlyEquals("VerticalLayout height not equal to sum of child heights, plus first gap, plus gap, plus last gap, with four children.", CHILD1_HEIGHT + CHILD2_HEIGHT + CHILD3_HEIGHT + CHILD4_HEIGHT + FIRST_GAP + GAP + LAST_GAP, this._group.height);
		}

		[Test]
		public function testChildXWithHorizontalAlignCenterAndMaxWidthSmallerThanChild():void
		{
			this._layout.horizontalAlign = HorizontalAlign.CENTER;
			var child:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._group.maxWidth = child.width / 2;
			this._group.addChild(child);
			this._group.validate();
			Assert.assertStrictlyEquals("Child x position incorrectly set to value less than zero with HorizontalAlign.CENTER", 0, child.x);
		}

		[Test]
		public function testChildYWithVerticalAlignMiddleAndMaxHeightSmallerThanChild():void
		{
			this._layout.verticalAlign = VerticalAlign.MIDDLE;
			var child:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._group.maxHeight = child.height / 2;
			this._group.addChild(child);
			this._group.validate();
			Assert.assertStrictlyEquals("Child y position incorrectly set to value less than zero with VerticalAlign.MIDDLE", 0, child.y);
		}

		[Test]
		public function testChildXIsIntegerWithHorizontalAlignCenter():void
		{
			this._layout.horizontalAlign = HorizontalAlign.CENTER;
			var child:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._group.width = child.width + 111;
			this._group.addChild(child);
			this._group.validate();
			Assert.assertStrictlyEquals("Child x position incorrectly set to non-integer with HorizontalAlign.CENTER", Math.round(child.x), child.x);
		}

		[Test]
		public function testChildYIsIntegerWithVerticalAlignMiddle():void
		{
			this._layout.verticalAlign = VerticalAlign.MIDDLE;
			var child:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._group.height = child.height + 111;
			this._group.addChild(child);
			this._group.validate();
			Assert.assertStrictlyEquals("Child y position incorrectly set to non-integer with VerticalAlign.MIDDLE", Math.round(child.y), child.y);
		}

		[Test]
		public function testNoErrorNoChildrenStickyHeader():void
		{
			var items:Vector.<DisplayObject> = new <DisplayObject>[];
			this._layout.headerIndices = new <int>[];
			this._layout.stickyHeader = true;
			var bounds:ViewPortBounds = new ViewPortBounds();
			this._layout.layout(items, bounds);

			this._layout.useVirtualLayout = true;
			this._layout.measureViewPort(0, bounds);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ListCollectionFilterTests.as
================================================
package feathers.tests
{
	import feathers.data.ListCollection;
	import feathers.events.CollectionEventType;

	import org.flexunit.Assert;

	import starling.events.Event;

	public class ListCollectionFilterTests
	{
		private var _collection:ListCollection;

		private var _includedItem:Object;
		private var _excludedItem:Object;
		private var _addedIncludedItem:Object;
		private var _addedExcludedItem:Object;

		[Before]
		public function prepare():void
		{
			this._includedItem = { label: "Included" };
			this._excludedItem = { label: "Excluded" };
			this._addedIncludedItem = { label: "Added and Included" };
			this._addedExcludedItem = { label: "Added and Excluded" };
			this._collection = new ListCollection(
			[
				this._includedItem,
				this._excludedItem,
			]);
			this._collection.filterFunction = this.filterFunction;
		}

		[After]
		public function cleanup():void
		{
			this._collection = null;
		}

		private function filterFunction(item:Object):Boolean
		{
			if(this._addedExcludedItem !== null && item === this._addedExcludedItem)
			{
				return false;
			}
			if(this._addedIncludedItem !== null && item === this._addedIncludedItem)
			{
				return true;
			}
			if(this._excludedItem !== null && item === this._excludedItem)
			{
				return false;
			}
			if(this._includedItem !== null && item === this._includedItem)
			{
				return true;
			}
			throw new Error("This should not happen");
		}

	//-- length

		[Test]
		public function testLengthWithFilterFunction():void
		{
			Assert.assertStrictlyEquals("ListCollection filterFunction must update length if items are excluded.",
				1, this._collection.length);
		}

		[Test]
		public function testLengthWithFilterFunctionAndSetFilterFunctionToNull():void
		{
			//ensure that the filter is processed once before setting to null
			this._collection.getItemAt(0);
			this._collection.filterFunction = null;
			Assert.assertStrictlyEquals("ListCollection must update length if filterFunction is set to null.",
				2, this._collection.length);
		}

	//-- contains()

		[Test]
		public function testContainsWithFilterFunction():void
		{
			Assert.assertTrue("ListCollection contains() must return true if filterFunction is set to function, and item is included.",
				this._collection.contains(this._includedItem));
			Assert.assertFalse("ListCollection contains() must return false if filterFunction is set to function, and item is excluded.",
				this._collection.contains(this._excludedItem));
		}

		[Test]
		public function testContainsWithFilterFunctionAndSetFilterFunctionToNull():void
		{
			this._collection.filterFunction = null;
			Assert.assertTrue("ListCollection contains() must return true for included item if filterFunction is set to null.",
				this._collection.contains(this._includedItem));
			Assert.assertTrue("ListCollection contains() must return true for excluded item if filterFunction is set to null.",
				this._collection.contains(this._excludedItem));
		}

	//-- addItem

		[Test]
		public function testAddItemWithFilterFunctionIncludedItem():void
		{
			var addItemDispatched:Boolean = false;
			var addItemIndex:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				addItemDispatched = true;
				addItemIndex = index;
			});
			this._collection.addItem(this._addedIncludedItem);
			Assert.assertStrictlyEquals("ListCollection filterFunction must increase length if item passed to addItem() is included.",
				2, this._collection.length);
			Assert.assertStrictlyEquals("ListCollection getItemAt() returns incorrect item with filterFunction after item passed to addItem() is included.",
				this._collection.getItemAt(1), this._addedIncludedItem);
			Assert.assertTrue("ListCollection contains() must return true with filterFunction if item passed to addItem() is included.",
				this._collection.contains(this._addedIncludedItem));
			Assert.assertStrictlyEquals("ListCollection getItemIndex() must return correct index with filterFunction if item passed to addItem() is included.",
				1, this._collection.getItemIndex(this._addedIncludedItem));
			Assert.assertTrue("ListCollection must dispatch CollectionEventType.ADD_ITEM with filterFunction if item passed to addItem() is included.",
				addItemDispatched);
			Assert.assertStrictlyEquals("ListCollection must include correct index with CollectionEventType.ADD_ITEM with filterFunction if item passed to addItem() is included.",
				1, addItemIndex);
		}

		[Test]
		public function testAddItemWithFilterFunctionExcludedItem():void
		{
			var addItemDispatched:Boolean = false;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event):void
			{
				addItemDispatched = true;
			});
			this._collection.addItem(this._addedExcludedItem);
			Assert.assertStrictlyEquals("ListCollection filterFunction must not change length if item passed to addItem() is excluded.",
				1, this._collection.length);
			Assert.assertFalse("ListCollection contains() must return false with filterFunction if item passed to addItem() is excluded.",
				this._collection.contains(this._addedExcludedItem));
			Assert.assertStrictlyEquals("ListCollection getItemIndex() must return -1 with filterFunction if item passed to addItem() is excluded.",
				-1, this._collection.getItemIndex(this._addedExcludedItem));
			Assert.assertFalse("ListCollection must not dispatch CollectionEventType.ADD_ITEM with filterFunction if item passed to addItem() is excluded.",
				addItemDispatched);
		}

		[Test]
		public function testAddItemWithFilterFunctionExcludedItemAndSetFilterFunctionToNull():void
		{
			this._collection.addItem(this._addedExcludedItem);
			this._collection.filterFunction = null;
			Assert.assertStrictlyEquals("ListCollection filterFunction must restore length after filterFunction is set to null.",
				3, this._collection.length);
			Assert.assertTrue("ListCollection contains() must return true for excluded item after filterFunction is set to null.",
				this._collection.contains(this._addedExcludedItem));
			Assert.assertStrictlyEquals("ListCollection getItemIndex() must return correct index for excluded item after filterFunction is set to null.",
				2, this._collection.getItemIndex(this._addedExcludedItem));
		}

	//-- addItemAt

		[Test]
		public function testAddItemAtWithFilterFunctionIncludedItem():void
		{
			var addItemDispatched:Boolean = false;
			var addItemIndex:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				addItemDispatched = true;
				addItemIndex = index;
			});
			this._collection.addItemAt(this._addedIncludedItem, 0);
			Assert.assertStrictlyEquals("ListCollection filterFunction must increase length if item passed to addItem() is included.",
				2, this._collection.length);
			Assert.assertStrictlyEquals("ListCollection getItemAt() returns incorrect item with filterFunction after item passed to addItem() is included.",
				this._collection.getItemAt(0), this._addedIncludedItem);
			Assert.assertTrue("ListCollection contains() must return true with filterFunction if item passed to addItem() is included.",
				this._collection.contains(this._addedIncludedItem));
			Assert.assertStrictlyEquals("ListCollection getItemIndex() must return correct index with filterFunction if item passed to addItem() is included.",
				0, this._collection.getItemIndex(this._addedIncludedItem));
			Assert.assertTrue("ListCollection must dispatch CollectionEventType.ADD_ITEM with filterFunction if item passed to addItem() is included.",
				addItemDispatched);
			Assert.assertStrictlyEquals("ListCollection must include correct index with CollectionEventType.ADD_ITEM with filterFunction if item passed to addItem() is included.",
				0, addItemIndex);
		}

		[Test]
		public function testAddItemAtWithFilterFunctionExcludedItem():void
		{
			var addItemDispatched:Boolean = false;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event):void
			{
				addItemDispatched = true;
			});
			this._collection.addItemAt(this._addedExcludedItem, 0);
			Assert.assertStrictlyEquals("ListCollection filterFunction must not change length if item passed to addItem() is excluded.",
				1, this._collection.length);
			Assert.assertFalse("ListCollection contains() must return false with filterFunction if item passed to addItem() is excluded.",
				this._collection.contains(this._addedExcludedItem));
			Assert.assertStrictlyEquals("ListCollection getItemIndex() must return -1 with filterFunction if item passed to addItem() is excluded.",
				-1, this._collection.getItemIndex(this._addedExcludedItem));
			Assert.assertFalse("ListCollection must not dispatch CollectionEventType.ADD_ITEM with filterFunction if item passed to addItem() is excluded.",
				addItemDispatched);
		}

		[Test]
		public function testAddItemAtWithFilterFunctionExcludedItemAndSetFilterFunctionToNull():void
		{
			this._collection.addItemAt(this._addedExcludedItem, 0);
			this._collection.filterFunction = null;
			Assert.assertStrictlyEquals("ListCollection filterFunction must restore length after filterFunction is set to null.",
				3, this._collection.length);
			Assert.assertTrue("ListCollection contains() must return true for excluded item after filterFunction is set to null.",
				this._collection.contains(this._addedExcludedItem));
			Assert.assertStrictlyEquals("ListCollection getItemIndex() must return correct index for excluded item after filterFunction is set to null.",
				0, this._collection.getItemIndex(this._addedExcludedItem));
		}

		[Test]
		public function testAddItemAtWithFilterFunctionExcludedItemThenAddItemAtWithIncludedItemAndSetFilterFunctionToNull():void
		{
			//the included item is added to index 0 after the excluded item, but
			//because the collection is filtered, the included item is relative
			//to another included item, which isn't at index 0 in the unfiltered
			//collection.
			this._collection.addItemAt(this._addedExcludedItem, 0);
			this._collection.addItemAt(this._addedIncludedItem, 0);
			this._collection.filterFunction = null;
			Assert.assertStrictlyEquals("ListCollection getItemIndex() must return correct index for excluded item after filterFunction is set to null.",
				0, this._collection.getItemIndex(this._addedExcludedItem));
			Assert.assertStrictlyEquals("ListCollection getItemIndex() must return correct index for included item after filterFunction is set to null.",
				1, this._collection.getItemIndex(this._addedIncludedItem));
		}

	//-- removeItem

		[Test]
		public function testRemoveItemWithFilterFunctionIncludedItem():void
		{
			var removeItemDispatched:Boolean = false;
			var removeItemIndex:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				removeItemDispatched = true;
				removeItemIndex = index;
			});
			this._collection.removeItem(this._includedItem);
			Assert.assertStrictlyEquals("ListCollection filterFunction must decrease length if item passed to removeItem() is included.",
				0, this._collection.length);
			Assert.assertFalse("ListCollection contains() must return false with filterFunction if item passed to removeItem() is included.",
				this._collection.contains(this._addedIncludedItem));
			Assert.assertStrictlyEquals("ListCollection getItemIndex() must return -1 with filterFunction if item passed to removeItem() is included.",
				-1, this._collection.getItemIndex(this._addedIncludedItem));
			Assert.assertTrue("ListCollection must dispatch CollectionEventType.REMOVE_ITEM with filterFunction if item passed to removeItem() is included.",
				removeItemDispatched);
			Assert.assertStrictlyEquals("ListCollection must include correct index with CollectionEventType.REMOVE_ITEM with filterFunction if item passed to removeItem() is included.",
				0, removeItemIndex);
		}

		[Test]
		public function testRemoveItemWithFilterFunctionExcludedItem():void
		{
			var removeItemDispatched:Boolean = false;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				removeItemDispatched = true;
			});
			this._collection.removeItem(this._excludedItem);
			Assert.assertStrictlyEquals("ListCollection filterFunction must not change length if item passed to removeItem() is excluded.",
				1, this._collection.length);
			Assert.assertFalse("ListCollection must not dispatch CollectionEventType.REMOVE_ITEM with filterFunction if item passed to removeItem() is excluded.",
				removeItemDispatched);
		}

		[Test]
		public function testRemoveItemWithFilterFunctionIncludedItemAndSetFilterFunctionToNull():void
		{
			this._collection.removeItem(this._includedItem);
			this._collection.filterFunction = null;
			Assert.assertStrictlyEquals("ListCollection filterFunction must restore length after filterFunction is set to null.",
				1, this._collection.length);
			Assert.assertFalse("ListCollection contains() must return false for included item after filterFunction is set to null.",
				this._collection.contains(this._includedItem));
			Assert.assertStrictlyEquals("ListCollection getItemIndex() must return -1 for included item that was removed after filterFunction is set to null.",
				-1, this._collection.getItemIndex(this._includedItem));
		}

		[Test]
		public function testRemoveItemWithFilterFunctionExcludedItemAndSetFilterFunctionToNull():void
		{
			this._collection.removeItem(this._excludedItem);
			this._collection.filterFunction = null;
			Assert.assertStrictlyEquals("ListCollection filterFunction must restore length after filterFunction is set to null.",
				2, this._collection.length);
			Assert.assertTrue("ListCollection contains() must return true for excluded item after filterFunction is set to null.",
				this._collection.contains(this._excludedItem));
			Assert.assertStrictlyEquals("ListCollection getItemIndex() must return correct index for excluded item after filterFunction is set to null.",
				1, this._collection.getItemIndex(this._excludedItem));
		}

	//-- setItemAt

		[Test]
		public function testSetItemAtWithFilterFunctionIncludedItem():void
		{
			var replaceItemDispatched:Boolean = false;
			var replaceItemIndex:int = -1;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, index:int):void
			{
				replaceItemDispatched = true;
				replaceItemIndex = index;
			});
			this._collection.setItemAt(this._addedIncludedItem, 0);
			Assert.assertStrictlyEquals("ListCollection filterFunction must maintain length if item passed to setItemAt() is included.",
				1, this._collection.length);
			Assert.assertTrue("ListCollection contains() must return true with filterFunction if item passed to setItemAt() is included.",
				this._collection.contains(this._addedIncludedItem));
			Assert.assertStrictlyEquals("ListCollection getItemIndex() must return correct index with filterFunction if item passed to setItemAt() is included.",
				0, this._collection.getItemIndex(this._addedIncludedItem));
			Assert.assertTrue("ListCollection must dispatch CollectionEventType.REPLACE_ITEM with filterFunction if item passed to setItemAt() is included.",
				replaceItemDispatched);
			Assert.assertStrictlyEquals("ListCollection must include correct index with CollectionEventType.REPLACE_ITEM with filterFunction if item passed to setItemAt() is included.",
				0, replaceItemIndex);
		}

		[Test]
		public function testSetItemAtWithFilterFunctionExcludedItem():void
		{
			var replaceItemDispatched:Boolean = false;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event):void
			{
				replaceItemDispatched = true;
			});
			var removeItemDispatched:Boolean = false;
			var removeItemIndex:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				removeItemDispatched = true;
				removeItemIndex = index;
			});
			this._collection.setItemAt(this._addedExcludedItem, 0);
			Assert.assertStrictlyEquals("ListCollection filterFunction must reduce length if item passed to setItemAt() is excluded and old item was included.",
				0, this._collection.length);
			Assert.assertFalse("ListCollection contains() must return true with filterFunction if item passed to setItemAt() is excluded.",
				this._collection.contains(this._addedExcludedItem));
			Assert.assertStrictlyEquals("ListCollection getItemIndex() must return -1 with filterFunction if item passed to setItemAt() is excluded.",
				-1, this._collection.getItemIndex(this._addedExcludedItem));
			Assert.assertFalse("ListCollection must not dispatch CollectionEventType.REPLACE_ITEM with filterFunction if item passed to setItemAt() is excluded.",
				replaceItemDispatched);
			Assert.assertTrue("ListCollection must dispatch CollectionEventType.REMOVE_ITEM with filterFunction if item passed to setItemAt() is excluded.",
				removeItemDispatched);
			Assert.assertStrictlyEquals("ListCollection must include correct index with CollectionEventType.REMOVE_ITEM with filterFunction if item passed to setItemAt() is excluded.",
				0, removeItemIndex);
		}

		[Test]
		public function testSetItemAtWithFilterFunctionIncludedItemAndSetFilterFunctionToNull():void
		{
			this._collection.setItemAt(this._addedIncludedItem, 0);
			this._collection.filterFunction = null;
			Assert.assertStrictlyEquals("ListCollection filterFunction must maintain length if item passed to setItemAt() is included.",
				2, this._collection.length);
			Assert.assertTrue("ListCollection contains() must return true with filterFunction if item passed to setItemAt() is included.",
				this._collection.contains(this._addedIncludedItem));
			Assert.assertStrictlyEquals("ListCollection getItemIndex() must return correct index with filterFunction if item passed to setItemAt() is included.",
				0, this._collection.getItemIndex(this._addedIncludedItem));
		}

		[Test]
		public function testSetItemAtWithFilterFunctionExcludedItemAndSetFilterFunctionToNull():void
		{
			this._collection.setItemAt(this._addedExcludedItem, 0);
			this._collection.filterFunction = null;
			Assert.assertStrictlyEquals("ListCollection filterFunction must maintain length if item passed to setItemAt() is excluded after filterFunction is set to null.",
				2, this._collection.length);
			Assert.assertTrue("ListCollection contains() must return true with filterFunction if item passed to setItemAt() is excluded after filterFunction is set to null.",
				this._collection.contains(this._addedExcludedItem));
			Assert.assertStrictlyEquals("ListCollection getItemIndex() must return correct index with filterFunction if item passed to setItemAt() is excluded after filterFunction is set to null.",
				0, this._collection.getItemIndex(this._addedExcludedItem));
		}

	//-- refresh()

		[Test]
		public function testRefresh():void
		{
			var searchText:String = "Included";
			this._collection.filterFunction = function(item:Object):Boolean
			{
				return item.label.indexOf(searchText) >= 0;
			};
			//ensure that the filter is processed once before changing the text
			this._collection.getItemAt(0);
			//change this variable, but the collection doesn't know about it yet
			searchText = "Excluded";
			Assert.assertStrictlyEquals("ListCollection incorrectly updated before calling refresh().",
				this._includedItem, this._collection.getItemAt(0));
			this._collection.refresh();
			Assert.assertStrictlyEquals("ListCollection failed to update after calling refresh().",
				this._excludedItem, this._collection.getItemAt(0));
		}

		[Test]
		public function testRefreshFilterWithNoFilterFunction():void
		{
			this._collection.filterFunction = null;
			this._collection.refresh();
			Assert.assertStrictlyEquals("ListCollection refresh() should not filter items if filterFunction is null.",
				2, this._collection.length);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ListCollectionWithArrayTests.as
================================================
package feathers.tests
{
	import feathers.data.ListCollection;
	import feathers.events.CollectionEventType;

	import org.flexunit.Assert;

	import starling.events.Event;

	public class ListCollectionWithArrayTests
	{
		private var _collection:ListCollection;
		private var _a:Object;
		private var _b:Object;
		private var _c:Object;
		private var _d:Object;

		[Before]
		public function prepare():void
		{
			this._a = { label: "One", value: 0 };
			this._b = { label: "Two", value: 2 };
			this._c = { label: "Three", value: 3 };
			this._d = { label: "Four", value: 1 };
			this._collection = new ListCollection(
			[
				this._a,
				this._b,
				this._c,
				this._d,
			]);
		}

		[After]
		public function cleanup():void
		{
			this._collection = null;
		}

		private function filterFunction(item:Object):Boolean
		{
			if(item === this._a || item === this._c)
			{
				return false;
			}
			return true;
		}

		private function sortCompareFunction(a:Object, b:Object):int
		{
			var valueA:Number = a.value as Number;
			var valueB:Number = b.value as Number;
			if(valueA < valueB)
			{
				return -1;
			}
			if(valueA > valueB)
			{
				return 1;
			}
			return 0;
		}

		[Test]
		public function testRemoveAll():void
		{
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedAll:Boolean = false;
			this._collection.addEventListener(CollectionEventType.REMOVE_ALL, function(event:Event):void
			{
				hasRemovedAll = true;
			});
			var hasReset:Boolean = false;
			this._collection.addEventListener(CollectionEventType.RESET, function(event:Event):void
			{
				hasReset = true;
			});
			this._collection.removeAll();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			//reset used to be dispatched, but REMOVE_ALL is better
			Assert.assertFalse("CollectionEventType.RESET was incorrectly dispatched", hasReset);
			Assert.assertTrue("CollectionEventType.REMOVE_ALL was not dispatched", hasRemovedAll);
			Assert.assertStrictlyEquals("The length property was not changed to 0",
				0, this._collection.length);
		}

		[Test]
		public function testRemoveItemAt():void
		{
			var itemToRemove:Object = this._collection.getItemAt(1);
			var originalLength:int = this._collection.length;
			var expectedIndex:int = 1;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				hasRemovedItem = true;
				indexFromEvent = index;
			});
			this._collection.removeItemAt(expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength - 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not removed",
				-1, this._collection.getItemIndex(itemToRemove));
			Assert.assertStrictlyEquals("The CollectionEventType.REMOVE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testRemoveItem():void
		{
			var expectedIndex:int = 1;
			var itemToRemove:Object = this._collection.getItemAt(expectedIndex);
			var originalLength:int = this._collection.length;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				hasRemovedItem = true;
				indexFromEvent = index;
			});
			this._collection.removeItem(itemToRemove);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength - 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not removed",
				-1, this._collection.getItemIndex(itemToRemove));
			Assert.assertStrictlyEquals("The CollectionEventType.REMOVE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testAddItem():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var originalLength:int = this._collection.length;
			var expectedIndex:int = originalLength;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.addItem(itemToAdd);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength + 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.ADD_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testAddItemAt():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.length;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.addItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength + 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.ADD_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testSetItemAt():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.length;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.setItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalLength, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.REPLACE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testContainsWithItemInCollection():void
		{
			var item:Object = this._collection.getItemAt(1);
			Assert.assertStrictlyEquals("contains() incorrectly returned false",
				true, this._collection.contains(item));
		}

		[Test]
		public function testContainsWithItemNotInCollection():void
		{
			var item:Object = {};
			Assert.assertStrictlyEquals("contains() incorrectly returned true",
				false, this._collection.contains(item));
		}

		[Test]
		public function testGetItemIndexWithItemInCollection():void
		{
			var expectedIndex:int = 1;
			var item:Object = this._collection.getItemAt(expectedIndex);
			Assert.assertStrictlyEquals("getItemIndex() returned the incorrect value",
				expectedIndex, this._collection.getItemIndex(item));
		}

		[Test]
		public function testGetItemIndexWithItemNotInCollection():void
		{
			var item:Object = {};
			Assert.assertStrictlyEquals("getItemIndex() returned the incorrect value",
				-1, this._collection.getItemIndex(item));
		}

		[Test]
		public function testDispose():void
		{
			var itemCount:int = this._collection.length;
			var disposedCount:int = 0;
			this._collection.dispose(function(item:Object):void
			{
				item.isDisposed = true;
				disposedCount++;
			});
			Assert.assertStrictlyEquals("Incorrect number of items disposed when calling dispose() on ListCollection",
				itemCount, disposedCount);
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = this._collection.getItemAt(i);
				Assert.assertTrue("Item was not included when calling dispose() on ListCollection", item.isDisposed);
			}
		}

		[Test]
		public function testDisposeWithFilterFunction():void
		{
			var itemCount:int = this._collection.length;
			this._collection.filterFunction = function(item:Object):Boolean
			{
				return item.label.charAt(0) === "O";
			};
			var filteredCount:int = this._collection.length;
			Assert.assertFalse("Filtered collection length must change", itemCount === filteredCount);
			var disposedCount:int = 0;
			this._collection.dispose(function(item:Object):void
			{
				item.isDisposed = true;
				disposedCount++;
			});
			Assert.assertStrictlyEquals("Incorrect number of items disposed when calling dispose() on ListCollection",
				itemCount, disposedCount);
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = this._collection.getItemAt(i);
				Assert.assertTrue("Item was not included when calling dispose() on ListCollection", item.isDisposed);
			}
		}

		[Test]
		public function testSortCompareFunction():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			Assert.assertStrictlyEquals("ListCollection: sortCompareFunction order is incorrect.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("ListCollection: sortCompareFunction order is incorrect.",
				this._d, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("ListCollection: sortCompareFunction order is incorrect.",
				this._b, this._collection.getItemAt(2));
			Assert.assertStrictlyEquals("ListCollection: sortCompareFunction order is incorrect.",
				this._c, this._collection.getItemAt(3));
		}

		[Test]
		public function testSortCompareFunctionAndFilterFunction():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.filterFunction = this.filterFunction;
			Assert.assertStrictlyEquals("ListCollection: sortCompareFunction and filterFunction length is incorrect.",
				2, this._collection.length);
			Assert.assertStrictlyEquals("ListCollection: sortCompareFunction order is incorrect with filterFunction.",
				this._d, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("ListCollection: sortCompareFunction order is incorrect with filterFunction.",
				this._b, this._collection.getItemAt(1));
		}

		[Test]
		public function testSetSortCompareFunctionToNull():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			//get an item so that we know the sorting was applied
			Assert.assertStrictlyEquals("ListCollection: sortCompareFunction order is incorrect.",
				this._c, this._collection.getItemAt(3));

			this._collection.sortCompareFunction = null;
			Assert.assertStrictlyEquals("ListCollection: set sortCompareFunction to null order is incorrect.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("ListCollection: set sortCompareFunction to null order is incorrect.",
				this._b, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("ListCollection: set sortCompareFunction to null order is incorrect.",
				this._c, this._collection.getItemAt(2));
			Assert.assertStrictlyEquals("ListCollection: set sortCompareFunction to null order is incorrect.",
				this._d, this._collection.getItemAt(3));
		}

		[Test]
		public function testSortCompareFunctionWithAddItem():void
		{
			var newItem:Object = { label: "New Item", value: 1.5 };
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.addItem(newItem);

			Assert.assertStrictlyEquals("ListCollection: addItem() with sortCompareFunction does not add at correct sorted index.",
				newItem, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			Assert.assertStrictlyEquals("ListCollection: addItem() with sortCompareFunction does not add at correct unsorted index.",
				newItem, this._collection.getItemAt(4));
		}

		[Test]
		public function testSortCompareFunctionWithAddItemAt():void
		{
			var newItem:Object = { label: "New Item", value: 1.5 };
			var newIndex:int = 1;
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.addItemAt(newItem, newIndex);

			//the index we passed in isn't necessarily the same while sorted
			Assert.assertStrictlyEquals("ListCollection: addItemAt() with sortCompareFunction does not add at correct sorted index.",
				newItem, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			//and it might not even be the same while unsorted!
			//that's because, in the unsorted data, it will be placed relative
			//to the item in the sorted data that was at the index passed to
			//addItemAt(). confusing, but it's consistent with setItemAt() and
			//filtered collections
			Assert.assertStrictlyEquals("ListCollection: addItemAt() with sortCompareFunction does not add at correct unsorted index.",
				newItem, this._collection.getItemAt(3));
		}

		[Test]
		public function testSortCompareFunctionWithRemoveItemAt():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.removeItemAt(2);

			Assert.assertStrictlyEquals("ListCollection: removeItemAt() with sortCompareFunction removed incorrect item in sorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("ListCollection: removeItemAt() with sortCompareFunction removed incorrect item in sorted data.",
				this._d, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("ListCollection: removeItemAt() with sortCompareFunction removed incorrect item in sorted data.",
				this._c, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			Assert.assertStrictlyEquals("ListCollection: removeItemAt() with sortCompareFunction removed incorrect item in unsorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("ListCollection: removeItemAt() with sortCompareFunction removed incorrect item in unsorted data.",
				this._c, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("ListCollection: removeItemAt() with sortCompareFunction removed incorrect item in unsorted data.",
				this._d, this._collection.getItemAt(2));
		}

		[Test]
		public function testSortCompareFunctionWithRemoveItem():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.removeItem(this._b);

			Assert.assertStrictlyEquals("ListCollection: removeItem() with sortCompareFunction removed incorrect item in sorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("ListCollection: removeItem() with sortCompareFunction removed incorrect item in sorted data.",
				this._d, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("ListCollection: removeItem() with sortCompareFunction removed incorrect item in sorted data.",
				this._c, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			Assert.assertStrictlyEquals("ListCollection: removeItem() with sortCompareFunction removed incorrect item in unsorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("ListCollection: removeItem() with sortCompareFunction removed incorrect item in unsorted data.",
				this._c, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("ListCollection: removeItem() with sortCompareFunction removed incorrect item in unsorted data.",
				this._d, this._collection.getItemAt(2));
		}

		[Test]
		public function testSortCompareFunctionWithSetItemAt():void
		{
			var newItem:Object = { label: "New Item", value: 1.5 };
			var newIndex:int = 0;
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.setItemAt(newItem, newIndex);

			//the index we passed in isn't necessarily the same while sorted
			Assert.assertStrictlyEquals("ListCollection: setItemAt() with sortCompareFunction does not add at correct sorted index.",
				newItem, this._collection.getItemAt(1));
			Assert.assertFalse("ListCollection: setItemAt() with sortCompareFunction does not replace correct item.",
				this._collection.contains(this._a));

			this._collection.sortCompareFunction = null;

			//however, that index should be the same when the collection is unsorted
			Assert.assertStrictlyEquals("ListCollection: setItemAt() with sortCompareFunction does not add at correct unsorted index.",
				newItem, this._collection.getItemAt(newIndex));
		}
	}
}


================================================
FILE: test/source/feathers/tests/ListFactoryIDFunctionTests.as
================================================
package feathers.tests
{
	import feathers.controls.List;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ListCollection;
	import feathers.events.FeathersEventType;

	import flash.utils.Dictionary;

	import org.flexunit.Assert;

	import starling.display.Quad;
	import starling.events.Event;

	public class ListFactoryIDFunctionTests
	{
		private static const FACTORY_ONE:String = "custom-factory1";
		private static const CUSTOM_STYLE_NAME:String = "custom-style-name";
		
		private var _list:List;
		
		private var _itemRendererMap:Dictionary;

		[Before]
		public function prepare():void
		{
			this._itemRendererMap = new Dictionary(true);
			
			this._list = new List();
			this._list.dataProvider = new ListCollection(
			[
				{ label: "One", factory: 0 },
				{ label: "Two", factory: 0 },
				{ label: "Three", factory: 1 },
			]);
			this._list.itemRendererFactory = function():DefaultListItemRenderer
			{
				var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
				itemRenderer.defaultSkin = new Quad(200, 200);
				return itemRenderer;
			};
			this._list.setItemRendererFactoryWithID(FACTORY_ONE, function():DefaultListItemRenderer
			{
				var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
				itemRenderer.styleNameList.add(CUSTOM_STYLE_NAME);
				itemRenderer.defaultSkin = new Quad(200, 200);
				return itemRenderer;
			});
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, list_rendererAddHandler);
			this._list.addEventListener(FeathersEventType.RENDERER_REMOVE, list_rendererRemoveHandler);
			TestFeathers.starlingRoot.addChild(this._list);
			this._list.validate();
		}

		[After]
		public function cleanup():void
		{
			this._list.removeFromParent(true);
			this._list = null;
			
			this._itemRendererMap = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testNoFactoryIDFunction():void
		{
			Assert.assertNull("Item renderer factoryID should be null if factoryIDFunction is null.", this.getItemRendererAt(0).factoryID);
			Assert.assertNull("Item renderer factoryID should be null if factoryIDFunction is null.", this.getItemRendererAt(1).factoryID);
			Assert.assertNull("Item renderer factoryID should be null if factoryIDFunction is null.", this.getItemRendererAt(2).factoryID);
		}

		[Test]
		public function testOneArgumentFactoryIDFunction():void
		{
			this._list.factoryIDFunction = oneArgumentFactoryIDFunction;
			this._list.validate();
		}

		[Test]
		public function testTwoArgumentFactoryIDFunction():void
		{
			this._list.factoryIDFunction = twoArgumentFactoryIDFunction;
			this._list.validate();
		}

		[Test]
		public function testFactoryIDFunction():void
		{
			this._list.factoryIDFunction = factoryIDFunction;
			this._list.validate();
			Assert.assertNull("Item renderer factoryID not set to result of factoryIDFunction.", this.getItemRendererAt(0).factoryID);
			Assert.assertNull("Item renderer factoryID not set to result of factoryIDFunction.", this.getItemRendererAt(1).factoryID);
			var itemRenderer2:IListItemRenderer = this.getItemRendererAt(2);
			Assert.assertStrictlyEquals("Item renderer factoryID not set to result of factoryIDFunction.", FACTORY_ONE, itemRenderer2.factoryID);
			Assert.assertTrue("Incorrect factory called to create item renderer.", itemRenderer2.styleNameList.contains(CUSTOM_STYLE_NAME));
		}

		[Test]
		public function testSetItemAtWithDifferentFactoryID():void
		{
			var itemToSet:Object = { label: "New", factory: 1 };
			this._list.factoryIDFunction = factoryIDFunction;
			this._list.validate();
			this._list.dataProvider.setItemAt(itemToSet, 1);
			this._list.validate();
			var itemRenderer:IListItemRenderer = this.getItemRendererAt(1);
			Assert.assertStrictlyEquals("Item renderer factoryID not changed to new result of factoryIDFunction after calling setItemAt().", FACTORY_ONE, itemRenderer.factoryID);
			Assert.assertStrictlyEquals("Item renderer data not changed with new result of factoryIDFunction after calling setItemAt().", itemToSet, itemRenderer.data);
		}

		[Test]
		public function testSetTypicalItemAtWithDifferentFactoryID():void
		{
			var index:int = 0;
			this._list.typicalItem = this._list.dataProvider.getItemAt(index);
			var itemToSet:Object = { label: "Replacement Item", factory: 1 };
			this._list.factoryIDFunction = factoryIDFunction;
			this._list.validate();
			this._list.dataProvider.setItemAt(itemToSet, index);
			this._list.validate();
			var itemRenderer:IListItemRenderer = this.getItemRendererAt(index);
			Assert.assertStrictlyEquals("Typical item renderer factoryID not changed to new result of factoryIDFunction after calling setItemAt().", FACTORY_ONE, itemRenderer.factoryID);
			Assert.assertStrictlyEquals("Typical item renderer data not changed with new result of factoryIDFunction after calling setItemAt().", itemToSet, itemRenderer.data);
		}

		[Test]
		public function testSetItemAtWithDifferentFactoryIDAndRemoveItemBefore():void
		{
			var itemToSet:Object = { label: "Replacement Item", factory: 1 };
			this._list.factoryIDFunction = factoryIDFunction;
			this._list.validate();
			this._list.dataProvider.setItemAt(itemToSet, 1);
			this._list.dataProvider.removeItemAt(0);
			this._list.validate();
			var itemRenderer:IListItemRenderer = this.getItemRendererAt(0);
			Assert.assertStrictlyEquals("Item renderer factoryID not changed to new result of factoryIDFunction after calling setItemAt() and removeItemAt() for previous item.", FACTORY_ONE, itemRenderer.factoryID);
			Assert.assertStrictlyEquals("Item renderer data not changed with new result of factoryIDFunction after calling setItemAt() and removeItemAt() for previous item.", itemToSet, itemRenderer.data);
		}

		[Test]
		public function testSetItemAtWithDifferentFactoryIDAndAddItemBefore():void
		{
			var itemToAdd:Object = { label: "Added Item", factory: 1 };
			var itemToSet:Object = { label: "Replacement Item", factory: 1 };
			this._list.factoryIDFunction = factoryIDFunction;
			this._list.validate();
			this._list.dataProvider.setItemAt(itemToSet, 0);
			this._list.dataProvider.addItemAt(itemToAdd, 0);
			this._list.validate();
			Assert.assertStrictlyEquals("factoryID of changed typical item not changed to result of factoryIDFunction.", FACTORY_ONE, this.getItemRendererAt(0).factoryID);
			var itemRenderer1:IListItemRenderer = this.getItemRendererAt(1);
			Assert.assertStrictlyEquals("Item renderer factoryID not changed to new result of factoryIDFunction after calling setItemAt() and addItemAt() for previous item.", FACTORY_ONE, itemRenderer1.factoryID);
			Assert.assertStrictlyEquals("Item renderer data not changed with new result of factoryIDFunction after calling setItemAt() and addItemAt() for previous item.", itemToSet, itemRenderer1.data);
		}

		[Test]
		public function testNewTypicalItemWithDifferentFactoryAndRemoveTypicalItemAfterDispose():void
		{
			var itemToSet:Object = { label: "Replacement Item", factory: 1 };
			this._list.factoryIDFunction = factoryIDFunction;
			this._list.validate();
			this._list.dataProvider.setItemAt(itemToSet, 1);
			this._list.dataProvider.removeItemAt(0);
			this._list.validate();
			var itemRendererCount:int = this._list.dataProvider.length;
			var removedRendererCount:int = 0;
			this._list.addEventListener(FeathersEventType.RENDERER_REMOVE, function(event:Event, itemRenderer:IListItemRenderer):void
			{
				removedRendererCount++;
				Assert.assertNotNull("Item renderer incorrectly has null owner during dispose().", itemRenderer.owner);
				Assert.assertNotNull("Item renderer incorrectly has null data during dispose().", itemRenderer.data);
				Assert.assertTrue("Item renderer incorrectly has negative index during dispose().", itemRenderer.index >= 0);
			});
			this._list.dispose();
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_REMOVE not dispatched for all item renderers after dispose().", itemRendererCount, removedRendererCount);
		}
		
		private function getItemRendererAt(index:int):IListItemRenderer
		{
			for(var item:Object in this._itemRendererMap)
			{
				var itemRenderer:IListItemRenderer = IListItemRenderer(this._itemRendererMap[item]);
				if(itemRenderer.index === index)
				{
					return itemRenderer;
				}
			}
			return null;
		}
		
		private function list_rendererAddHandler(event:Event, itemRenderer:IListItemRenderer):void
		{
			this._itemRendererMap[itemRenderer.data] = itemRenderer;
		}

		private function list_rendererRemoveHandler(event:Event, itemRenderer:IListItemRenderer):void
		{
			delete this._itemRendererMap[itemRenderer.data];
		}

		private function factoryIDFunction(item:Object):String
		{
			if(item.factory === 1)
			{
				return FACTORY_ONE;
			}
			return null;
		}
		
		private function oneArgumentFactoryIDFunction(item:Object):String
		{
			Assert.assertNotNull("Item passed to factoryIDFunction should not be null.", item);
			return null;
		}

		private function twoArgumentFactoryIDFunction(item:Object, index:int):String
		{
			Assert.assertNotNull("Item passed to factoryIDFunction should not be null.", item);
			Assert.assertTrue("Index passed to factoryIDFunction is out of range.", index >= 0 && index < this._list.dataProvider.length);
			return null;
		}
	}
}


================================================
FILE: test/source/feathers/tests/ListFocusTests.as
================================================
package feathers.tests
{
	import feathers.controls.List;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.core.FocusManager;
	import feathers.data.ListCollection;

	import flash.events.KeyboardEvent;
	import flash.ui.Keyboard;

	import org.flexunit.Assert;

	import starling.display.Quad;
	import starling.events.Event;
	import flash.ui.KeyLocation;

	public class ListFocusTests
	{
		private var _list:List;

		[Before]
		public function prepare():void
		{
			this._list = new List();
			this._list.dataProvider = new ListCollection(
			[
				{ label: "One" },
				{ label: "Two" },
				{ label: "Three" },
				{ label: "Four" },
			]);
			this._list.itemRendererFactory = function():DefaultListItemRenderer
			{
				var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
				itemRenderer.defaultSkin = new Quad(200, 200);
				return itemRenderer;
			};
			TestFeathers.starlingRoot.addChild(this._list);
			this._list.validate();

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, true);
		}

		[After]
		public function cleanup():void
		{
			this._list.removeFromParent(true);
			this._list = null;

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
			Assert.assertFalse("FocusManager not disabled on cleanup.", FocusManager.isEnabledForStage(TestFeathers.starlingRoot.stage));
		}

		[Test]
		public function testNoTriggerWhenNoSelectedItem():void
		{
			FocusManager.focus = this._list;
			var hasTriggered:Boolean = false;
			var triggeredItem:Object = null;
			this._list.addEventListener(Event.TRIGGERED, function(event:Event, item:Object):void
			{
				hasTriggered = true;
				triggeredItem = item;
			});
			this._list.stage.starling.nativeStage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 32, Keyboard.SPACE, KeyLocation.STANDARD, false, false, false));
			this._list.stage.starling.nativeStage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, true, false, 32, Keyboard.SPACE, KeyLocation.STANDARD, false, false, false));
			Assert.assertFalse("Event.TRIGGERED incorrectly dispatched when no item is selected",
				hasTriggered);
		}

		[Test]
		public function testTriggered():void
		{
			this._list.selectedIndex = 1;
			FocusManager.focus = this._list;
			var hasTriggered:Boolean = false;
			var triggeredItem:Object = null;
			this._list.addEventListener(Event.TRIGGERED, function(event:Event, item:Object):void
			{
				hasTriggered = true;
				triggeredItem = item;
			});
			this._list.stage.starling.nativeStage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 32, Keyboard.SPACE, KeyLocation.STANDARD, false, false, false));
			this._list.stage.starling.nativeStage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, true, false, 32, Keyboard.SPACE, KeyLocation.STANDARD, false, false, false));
			Assert.assertTrue("Event.TRIGGERED must be dispatched on KeyboardEvent.KEY_DOWN with Keyboard.SPACE key code",
				hasTriggered);
			Assert.assertStrictlyEquals("Incorrect item passed to Event.TRIGGERED listener",
				this._list.dataProvider.getItemAt(1), triggeredItem);
		}
	}
}

================================================
FILE: test/source/feathers/tests/ListRendererAddRemoveTests.as
================================================
package feathers.tests
{
	import feathers.controls.List;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ListCollection;
	import feathers.events.FeathersEventType;

	import org.flexunit.Assert;

	import starling.display.Quad;
	import starling.events.Event;

	public class ListRendererAddRemoveTests
	{
		private var _list:List;

		[Before]
		public function prepare():void
		{
			this._list = new List();
			this._list.dataProvider = new ListCollection(
			[
				{ label: "One" },
				{ label: "Two" },
				{ label: "Three" },
			]);
			this._list.itemRendererFactory = function():DefaultListItemRenderer
			{
				var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
				itemRenderer.defaultSkin = new Quad(200, 200);
				return itemRenderer;
			};
			TestFeathers.starlingRoot.addChild(this._list);
		}

		[After]
		public function cleanup():void
		{
			this._list.removeFromParent(true);
			this._list = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testRendererAddEventWithDataProvider():void
		{
			var itemRendererCount:int = 0;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event):void
			{
				itemRendererCount++;
			});
			this._list.validate();

			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_ADD not dispatched for all visible items.", this._list.dataProvider.length, itemRendererCount);
		}

		[Test]
		public function testRendererAddEventAfterAddItem():void
		{
			this._list.validate();
			var addedRenderer:Boolean = false;
			var addedItemIndex:int = -1;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event, itemRenderer:IListItemRenderer):void
			{
				addedRenderer = true;
				addedItemIndex = itemRenderer.index;
			});
			this._list.dataProvider.addItem({label: "New Item"});
			this._list.validate();
			Assert.assertTrue("FeathersEventType.RENDERER_ADD not dispatched after addItem().", addedRenderer);
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_ADD not dispatched with correct item renderer after addItem().", this._list.dataProvider.length - 1, addedItemIndex);
		}

		[Test]
		public function testRendererRemoveEventAfterRemoveItemAt():void
		{
			var index:int = 1;
			this._list.validate();
			var removedRenderer:Boolean = false;
			var removedItemIndex:int = -1;
			this._list.addEventListener(FeathersEventType.RENDERER_REMOVE, function(event:Event, itemRenderer:IListItemRenderer):void
			{
				removedRenderer = true;
				removedItemIndex = itemRenderer.index;
			});
			this._list.dataProvider.removeItemAt(index);
			this._list.validate();
			Assert.assertTrue("FeathersEventType.RENDERER_REMOVE not dispatched after removeItemAt().", removedRenderer);
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_REMOVE not dispatched with correct item renderer after removeItemAt().", index, removedItemIndex);
		}

		[Test]
		public function testRendererAddAndRemoveEventsAfterSetItemAt():void
		{
			var index:int = 1;
			this._list.validate();
			var addedRenderer:Boolean = false;
			var addedItemIndex:int = -1;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event, itemRenderer:IListItemRenderer):void
			{
				Assert.assertTrue("FeathersEventType.RENDERER_REMOVE not dispatched before FeathersEventType.RENDERER_ADD when calling setItemAt().", removedRenderer);
				addedRenderer = true;
				addedItemIndex = itemRenderer.index;
			});
			var removedRenderer:Boolean = false;
			var removedItemIndex:int = -1;
			this._list.addEventListener(FeathersEventType.RENDERER_REMOVE, function(event:Event, itemRenderer:IListItemRenderer):void
			{
				removedRenderer = true;
				removedItemIndex = itemRenderer.index;
			});
			this._list.dataProvider.setItemAt({label: "New Item"}, index);
			this._list.validate();
			Assert.assertTrue("FeathersEventType.RENDERER_REMOVE not dispatched after setItemAt().", removedRenderer);
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_REMOVE not dispatched with correct item renderer after setItemAt().", index, removedItemIndex);
			Assert.assertTrue("FeathersEventType.RENDERER_ADD not dispatched after setItemAt().", addedRenderer);
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_ADD not dispatched with correct item renderer after setItemAt().", index, addedItemIndex);
		}

		[Test]
		public function testRendererAddAndRemoveEventAfterChangeTypicalItemFromDefaultToCustom():void
		{
			this._list.validate();
			this._list.typicalItem = { label: "Typical Item" };
			var addedRenderer:Boolean = false;
			this._list.addEventListener(FeathersEventType.RENDERER_ADD, function(event:Event, itemRenderer:IListItemRenderer):void
			{
				addedRenderer = true;
			});
			var removedRenderer:Boolean = false;
			this._list.addEventListener(FeathersEventType.RENDERER_REMOVE, function(event:Event, itemRenderer:IListItemRenderer):void
			{
				removedRenderer = true;
			});
			this._list.validate();
			Assert.assertFalse("FeathersEventType.RENDERER_REMOVE incorrectly dispatched after change typicalItem from default to custom.", removedRenderer);
			Assert.assertFalse("FeathersEventType.RENDERER_ADD incorrectly dispatched after change typicalItem from default to custom.", addedRenderer);
		}

		[Test]
		public function testRendererRemoveEventsAfterDispose():void
		{
			this._list.validate();
			var itemRendererCount:int = this._list.dataProvider.length;
			var removedRendererCount:int = 0;
			this._list.addEventListener(FeathersEventType.RENDERER_REMOVE, function(event:Event, itemRenderer:IListItemRenderer):void
			{
				Assert.assertNotNull("Item renderer incorrectly has null owner during dispose().", itemRenderer.owner);
				Assert.assertNotNull("Item renderer incorrectly has null data during dispose().", itemRenderer.data);
				Assert.assertTrue("Item renderer incorrectly has negative index during dispose().", itemRenderer.index >= 0);
				removedRendererCount++;
			});
			this._list.dispose();
			Assert.assertStrictlyEquals("FeathersEventType.RENDERER_REMOVE not dispatched for all item renderers after dispose().", itemRendererCount, removedRendererCount);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ListTests.as
================================================
package feathers.tests
{
	import feathers.controls.List;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.IListItemRenderer;
	import feathers.data.ListCollection;
	import feathers.events.FeathersEventType;
	import feathers.tests.supportClasses.AssertViewPortBoundsLayout;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class ListTests
	{
		private var _list:List;

		[Before]
		public function prepare():void
		{
			this._list = new List();
			this._list.dataProvider = new ListCollection(
			[
				{ label: "One" },
				{ label: "Two" },
				{ label: "Three" },
				{ label: "Four" },
			]);
			this._list.itemRendererFactory = function():DefaultListItemRenderer
			{
				var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
				itemRenderer.defaultSkin = new Quad(200, 200);
				return itemRenderer;
			};
			TestFeathers.starlingRoot.addChild(this._list);
			this._list.validate();
		}

		[After]
		public function cleanup():void
		{
			this._list.removeFromParent(true);
			this._list = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testNullDataProvider():void
		{
			this._list.dataProvider = null;
			this._list.validate();
		}

		[Test]
		public function testNullDataProviderWithTypicalItem():void
		{
			this._list.dataProvider = null;
			this._list.typicalItem = { label: "Typical Item" };
			this._list.validate();
		}

		[Test]
		public function testProgrammaticSelectionChange():void
		{
			var beforeSelectedIndex:int = this._list.selectedIndex;
			var beforeSelectedItem:Object = this._list.selectedItem;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.selectedIndex = 1;
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The selectedIndex property was not changed",
				beforeSelectedIndex === this._list.selectedIndex);
			Assert.assertFalse("The selectedItem property was not changed",
				beforeSelectedItem === this._list.selectedItem);
		}

		[Test]
		public function testInteractiveSelectionChange():void
		{
			var beforeSelectedIndex:int = this._list.selectedIndex;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(10, 210);
			var target:DisplayObject = this._list.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The selectedIndex property was not changed",
				beforeSelectedIndex === this._list.selectedIndex);
		}

		[Test]
		public function testRemoveItemBeforeSelectedIndex():void
		{
			this._list.selectedIndex = 1;
			var beforeSelectedIndex:int = this._list.selectedIndex;
			var beforeSelectedItem:Object = this._list.selectedItem;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.removeItemAt(0);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed",
				beforeSelectedIndex - 1, this._list.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was incorrectly changed",
				beforeSelectedItem, this._list.selectedItem);
		}

		[Test]
		public function testRemoveItemAfterSelectedIndex():void
		{
			this._list.selectedIndex = 1;
			var beforeSelectedIndex:int = this._list.selectedIndex;
			var beforeSelectedItem:Object = this._list.selectedItem;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.removeItemAt(2);
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was incorrectly changed",
				beforeSelectedIndex, this._list.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was incorrectly changed",
				beforeSelectedItem, this._list.selectedItem);
		}

		[Test]
		public function testRemoveSelectedIndex():void
		{
			this._list.selectedIndex = 1;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.removeItemAt(1);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed to -1",
				-1, this._list.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not changed to null",
				null, this._list.selectedItem);
		}

		[Test]
		public function testReplaceItemAtSelectedIndex():void
		{
			this._list.selectedIndex = 1;
			var beforeSelectedIndex:int = this._list.selectedIndex;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.setItemAt({ label: "New Item" }, beforeSelectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed to -1",
				-1, this._list.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not changed to null",
				null, this._list.selectedItem);
		}

		[Test]
		public function testDeselectAllOnNullDataProvider():void
		{
			this._list.selectedIndex = 1;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider = null;
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not set to -1",
				-1, this._list.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not set to null",
				null, this._list.selectedItem);
		}

		[Test]
		public function testDeselectAllOnDataProviderRemoveAll():void
		{
			this._list.selectedIndex = 1;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.removeAll();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not set to -1",
				-1, this._list.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not set to null",
				null, this._list.selectedItem);
		}

		[Test]
		public function testAddItemBeforeSelectedIndex():void
		{
			this._list.selectedIndex = 1;
			var hasChanged:Boolean = false;
			var beforeSelectedIndex:int = this._list.selectedIndex;
			var beforeSelectedItem:Object = this._list.selectedItem;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.addItemAt({label: "New Item"}, 0);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed",
				beforeSelectedIndex + 1, this._list.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was incorrectly changed",
				beforeSelectedItem, this._list.selectedItem);
		}

		[Test]
		public function testFilterSelectedIndex():void
		{
			this._list.selectedIndex = 1;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var selectedItem:Object = this._list.dataProvider.getItemAt(1);
			this._list.dataProvider.filterFunction = function(item:Object):Boolean
			{
				return item !== selectedItem;
			};
			Assert.assertTrue("Event.CHANGE must be dispatched when item is filtered", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed to -1 when selected item is filtered",
				-1, this._list.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not changed to null when selected item is filtered",
				null, this._list.selectedItem);
		}

		[Test]
		public function testDisposeWithoutChangeEvent():void
		{
			this._list.selectedIndex = 1;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dispose();
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched", hasChanged);
		}

		[Test]
		public function testItemToItemRenderer():void
		{
			this._list.height = 20;
			this._list.validate();
			var item0:Object = this._list.dataProvider.getItemAt(0);
			var itemRenderer0:IListItemRenderer = this._list.itemToItemRenderer(item0);
			var item1:Object = this._list.dataProvider.getItemAt(1);
			var itemRenderer1:IListItemRenderer = this._list.itemToItemRenderer(item1);
			var item3:Object = this._list.dataProvider.getItemAt(3);
			var itemRenderer3:IListItemRenderer = this._list.itemToItemRenderer(item3);
			Assert.assertNotNull("itemToItemRenderer() incorrectly returned null for item that should have an item renderer", itemRenderer0);
			Assert.assertStrictlyEquals("Item renderer returned by itemToItemRenderer() has incorrect data", item0, itemRenderer0.data);
			Assert.assertStrictlyEquals("Item renderer returned by itemToItemRenderer() has incorrect index", 0, itemRenderer0.index);
			Assert.assertNotNull("itemToItemRenderer() incorrectly returned null for item that should have an item renderer", itemRenderer1);
			Assert.assertStrictlyEquals("Item renderer returned by itemToItemRenderer() has incorrect data", item1, itemRenderer1.data);
			Assert.assertStrictlyEquals("Item renderer returned by itemToItemRenderer() has incorrect index", 1, itemRenderer1.index);
			Assert.assertNull("itemToItemRenderer() incorrectly returned item renderer for item that should not have one", itemRenderer3);
		}

		[Test]
		public function testResizeOnUpdateItemAtWithLongerText():void
		{
			this._list.dataProvider.getItemAt(1).label = "I am the very model of a modern major general. I've information vegetable, animal, and mineral.";
			this._list.dataProvider.updateItemAt(1);
			var hasResized:Boolean = false;
			this._list.addEventListener(Event.RESIZE, function(event:Event):void
			{
				hasResized = true;
			});
			this._list.validate();
			Assert.assertTrue("List Event.RESIZE was not dispatched when item was updated with longer text and width was not explicit", hasResized);
		}

		[Test]
		public function testNewMaskDimensionsOnAddItemToDataProvider():void
		{
			var mask:DisplayObject = this._list.viewPort.mask;
			var oldMaskHeight:Number = mask.height;
			this._list.dataProvider.addItem({ label: "New Item" });
			this._list.validate();
			Assert.assertTrue("List with VerticalLayout must resize mask when item is added to data provider and height is not explicit", mask.height > oldMaskHeight);
		}

		[Test]
		public function testViewPortBoundsValues():void
		{
			this._list.layout = new AssertViewPortBoundsLayout();
			this._list.validate();
		}

		[Test]
		public function testScrollToDisplayIndexAndSetDataProviderToNull():void
		{
			this._list.scrollToDisplayIndex(1, 2);
			this._list.dataProvider = null;
			this._list.validate();
		}

		[Test]
		public function testScrollToDisplayIndex():void
		{
			var hasDispatchedScrollStart:Boolean = false;
			this._list.addEventListener(FeathersEventType.SCROLL_START, function(event:Event):void
			{
				hasDispatchedScrollStart = true;
			});
			var hasDispatchedScrollComplete:Boolean = false;
			this._list.addEventListener(FeathersEventType.SCROLL_COMPLETE, function(event:Event):void
			{
				hasDispatchedScrollComplete = true;
			});
			this._list.height = 200;
			this._list.scrollToDisplayIndex(1);
			this._list.validate();
			Assert.assertTrue("List: scrollToDisplayIndex() set incorrect verticalScrollPosition", this._list.verticalScrollPosition > 0);
			Assert.assertTrue("List: scrollToDisplayIndex() with duration 0 did not dispatch FeathersEventType.SCROLL_START",
				hasDispatchedScrollStart);
			Assert.assertTrue("List: scrollToDisplayIndex() with duration 0 did not dispatch FeathersEventType.SCROLL_COMPLETE",
				hasDispatchedScrollComplete);
		}

		[Test]
		public function testTriggeredByTap():void
		{
			var hasTriggered:Boolean = false;
			var triggeredItem:Object = null;
			this._list.addEventListener(Event.TRIGGERED, function(event:Event, item:Object):void
			{
				hasTriggered = true;
				triggeredItem = item;
			});
			var position:Point = new Point(10, 210);
			var target:DisplayObject = this._list.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.TRIGGERED was not dispatched", hasTriggered);
			Assert.assertStrictlyEquals("Incorrect item passed to Event.TRIGGERED listener",
				this._list.dataProvider.getItemAt(1), triggeredItem);
		}

		[Test]
		public function testSelectionChangeOnSortChange():void
		{
			this._list.selectedIndex = this._list.dataProvider.length - 1;
			var oldSelectedItem:Object = this._list.dataProvider.getItemAt(this._list.dataProvider.length - 1);
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.sortCompareFunction = function(a:Object, b:Object):int
			{
				var aIndex:int = _list.dataProvider.getItemIndex(a);
				var bIndex:int = _list.dataProvider.getItemIndex(b);
				if(aIndex < bIndex)
				{
					return 1;
				}
				else if(aIndex > bIndex)
				{
					return -1;
				}
				return 0;
			}
			this._list.dataProvider.refresh();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("Incorrect selectedIndex after sort change",
				0, this._list.selectedIndex);
			Assert.assertStrictlyEquals("Incorrect selectedItem after sort change",
				oldSelectedItem, this._list.selectedItem);
		}
	}
}


================================================
FILE: test/source/feathers/tests/LongPressTests.as
================================================
package feathers.tests
{
	import feathers.events.FeathersEventType;
	import feathers.utils.touch.LongPress;

	import flash.geom.Point;

	import flexunit.framework.Assert;

	import org.flexunit.async.Async;

	import starling.display.Quad;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class LongPressTests
	{
		private var _target:Quad;
		private var _blocker:Quad;
		private var _longPress:LongPress;

		[Before]
		public function prepare():void
		{
			this._target = new Quad(200, 200, 0xff00ff);
			TestFeathers.starlingRoot.addChild(this._target);
			
			this._longPress = new LongPress(this._target);
		}

		[After]
		public function cleanup():void
		{
			this._target.removeFromParent(true);
			this._target = null;
			
			if(this._blocker)
			{
				this._blocker.removeFromParent(true);
				this._blocker = null;
			}

			this._longPress = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test(async)]
		public function testLongPressEvent():void
		{
			var hasLongPressed:Boolean = false;
			this._target.addEventListener(FeathersEventType.LONG_PRESS, function():void
			{
				hasLongPressed = true;
			});
			var touch:Touch = new Touch(0);
			touch.target = this._target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 10;
			touch.globalY = 10;
			var touches:Vector.<Touch> = new <Touch>[touch];
			this._target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("FeathersEventType.LONG_PRESS was not dispatched", hasLongPressed);
			}, 600);
		}

		[Test(async)]
		public function testTouchMoveOutsideBeforeLongPressEvent():void
		{
			var hasLongPressed:Boolean = false;
			this._target.addEventListener(FeathersEventType.LONG_PRESS, function():void
			{
				hasLongPressed = true;
			});
			var touch:Touch = new Touch(0);
			touch.target = this._target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 10;
			touch.globalY = 10;
			var touches:Vector.<Touch> = new <Touch>[touch];
			this._target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.globalX = 1000; //move the touch way outside the bounds of the button
			touch.phase = TouchPhase.MOVED;
			this._target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Async.delayCall(this, function():void
			{
				Assert.assertFalse("FeathersEventType.LONG_PRESS was incorrectly dispatched after touch moved out of bounds", hasLongPressed);
			}, 600);
		}

		[Test(async)]
		public function testOtherDisplayObjectBlockingLongPressEvent():void
		{
			var hasLongPressed:Boolean = false;
			this._target.addEventListener(FeathersEventType.LONG_PRESS, function():void
			{
				hasLongPressed = true;
			});
			var touch:Touch = new Touch(0);
			touch.target = this._target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 10;
			touch.globalY = 10;
			var touches:Vector.<Touch> = new <Touch>[touch];
			this._target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			
			this._blocker = new Quad(200, 200, 0xff0000);
			TestFeathers.starlingRoot.addChild(this._blocker);
			
			Async.delayCall(this, function():void
			{
				Assert.assertFalse("FeathersEventType.LONG_PRESS was incorrectly dispatched when another display object blocked the touch", hasLongPressed);
			}, 600);
		}

		[Test(async)]
		public function testRemovedBeforeLongPressEvent():void
		{
			var hasLongPressed:Boolean = false;
			this._target.addEventListener(FeathersEventType.LONG_PRESS, function():void
			{
				hasLongPressed = true;
			});
			var touch:Touch = new Touch(0);
			touch.target = this._target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 10;
			touch.globalY = 10;
			var touches:Vector.<Touch> = new <Touch>[touch];
			this._target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			this._target.removeFromParent(false);

			Async.delayCall(this, function():void
			{
				Assert.assertFalse("FeathersEventType.LONG_PRESS was incorrectly dispatched when target was removed", hasLongPressed);
			}, 600);
		}

		[Test(async)]
		public function testDisabled():void
		{
			this._longPress.isEnabled = false;

			var hasLongPressed:Boolean = false;
			this._target.addEventListener(FeathersEventType.LONG_PRESS, function():void
			{
				hasLongPressed = true;
			});
			var touch:Touch = new Touch(0);
			touch.target = this._target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 10;
			touch.globalY = 10;
			var touches:Vector.<Touch> = new <Touch>[touch];
			this._target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Async.delayCall(this, function():void
			{
				Assert.assertFalse("FeathersEventType.LONG_PRESS was incorrectly dispatched when disabled", hasLongPressed);
			}, 600);
		}

		[Test(async)]
		public function testCustomHitTestReturnTrue():void
		{
			this._longPress.customHitTest = function customHitTest(localPosition:Point):Boolean
			{
				return localPosition.x <= 100;
			};
			var hasLongPressed:Boolean = false;
			this._target.addEventListener(FeathersEventType.LONG_PRESS, function ():void
			{
				hasLongPressed = true;
			});
			var touch:Touch = new Touch(0);
			touch.target = this._target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 10;
			touch.globalY = 10;
			var touches:Vector.<Touch> = new <Touch>[touch];
			Async.delayCall(this, function ():void
			{
				Assert.assertFalse("FeathersEventType.LONG_PRESS was not dispatched when customHitTest returned true", hasLongPressed);
			}, 600);
		}

		[Test(async)]
		public function testCustomHitTestReturnFalse():void
		{
			this._longPress.customHitTest = function customHitTest(localPosition:Point):Boolean
			{
				return localPosition.x <= 100;
			};
			var hasLongPressed:Boolean = false;
			this._target.addEventListener(FeathersEventType.LONG_PRESS, function ():void
			{
				hasLongPressed = true;
			});
			var touch:Touch = new Touch(0);
			touch.target = this._target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 150;
			touch.globalY = 10;
			var touches:Vector.<Touch> = new <Touch>[touch];
			Async.delayCall(this, function ():void
			{
				Assert.assertFalse("FeathersEventType.LONG_PRESS was incorrect dispatched when customHitTest returned false", hasLongPressed);
			}, 600);
		}
	}
}


================================================
FILE: test/source/feathers/tests/MinAndMaxDimensionsTests.as
================================================
package feathers.tests
{
	import feathers.controls.LayoutGroup;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class MinAndMaxDimensionsTests
	{
		private static const MIN_SIZE:Number = 100;
		private static const EXPLICIT_SIZE_SMALLER_THAN_MIN_SIZE:Number = 50;
		private static const MAX_SIZE:Number = 100;
		private static const EXPLICIT_SIZE_LARGER_THAN_MAX_SIZE:Number = 150;
		
		private var _control:LayoutGroup;

		[Before]
		public function prepare():void
		{
			this._control = new LayoutGroup();
			TestFeathers.starlingRoot.addChild(this._control);
		}

		[After]
		public function cleanup():void
		{
			this._control.removeFromParent(true);
			this._control = null;
			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testMinWidth():void
		{
			this._control.minWidth = MIN_SIZE;
			this._control.validate();
			Assert.assertStrictlyEquals("The width of the component was not calculated correctly because it is smaller than the minWidth", this._control.width, MIN_SIZE);
		}

		[Test]
		public function testExplicitWidthWithMinWidth():void
		{
			this._control.minWidth = MIN_SIZE;
			this._control.width = EXPLICIT_SIZE_SMALLER_THAN_MIN_SIZE;
			this._control.validate();
			Assert.assertStrictlyEquals("The minWidth was incorrectly used to calculate the component's width when the width was set explicitly", this._control.width, EXPLICIT_SIZE_SMALLER_THAN_MIN_SIZE);
		}

		[Test]
		public function testMinHeight():void
		{
			this._control.minHeight = MIN_SIZE;
			this._control.validate();
			Assert.assertStrictlyEquals("The height of the component was not calculated correctly because it is smaller than the minHeight", this._control.height, MIN_SIZE);
		}

		[Test]
		public function testExplicitHeightWithMinHeight():void
		{
			this._control.minHeight = MIN_SIZE;
			this._control.height = EXPLICIT_SIZE_SMALLER_THAN_MIN_SIZE;
			this._control.validate();
			Assert.assertStrictlyEquals("The minHeight was incorrectly used to calculate the component's height when the height was set explicitly", this._control.height, EXPLICIT_SIZE_SMALLER_THAN_MIN_SIZE);
		}

		[Test]
		public function testMaxWidth():void
		{
			this._control.addChild(new Quad(EXPLICIT_SIZE_LARGER_THAN_MAX_SIZE, EXPLICIT_SIZE_LARGER_THAN_MAX_SIZE, 0xff00ff));
			this._control.maxWidth = MAX_SIZE;
			this._control.validate();
			Assert.assertStrictlyEquals("The width of the component was not calculated correctly because it is larger than the maxWidth", this._control.width, MAX_SIZE);
		}

		[Test]
		public function testExplicitWidthWithMaxWidth():void
		{
			this._control.maxWidth = MAX_SIZE;
			this._control.width = EXPLICIT_SIZE_LARGER_THAN_MAX_SIZE;
			this._control.validate();
			Assert.assertStrictlyEquals("The maxWidth was incorrectly used to calculate the component's width when the width was set explicitly", this._control.width, EXPLICIT_SIZE_LARGER_THAN_MAX_SIZE);
		}

		[Test]
		public function testMaxHeight():void
		{
			this._control.addChild(new Quad(EXPLICIT_SIZE_LARGER_THAN_MAX_SIZE, EXPLICIT_SIZE_LARGER_THAN_MAX_SIZE, 0xff00ff));
			this._control.maxHeight = MAX_SIZE;
			this._control.validate();
			Assert.assertStrictlyEquals("The height was set explicitly, but the value after validation is different when using maxHeight", this._control.height, MAX_SIZE);
		}

		[Test]
		public function testExplicitHeightWithMaxHeight():void
		{
			this._control.maxHeight = MAX_SIZE;
			this._control.height = EXPLICIT_SIZE_LARGER_THAN_MAX_SIZE;
			this._control.validate();
			Assert.assertStrictlyEquals("The maxHeight was incorrectly used to calculate the component's height when the height was set explicitly", this._control.height, EXPLICIT_SIZE_LARGER_THAN_MAX_SIZE);
		}

		[Test]
		public function testNoInvalidationWhenSettingMinWidthWithExplicitWidth():void
		{
			this._control.width = EXPLICIT_SIZE_SMALLER_THAN_MIN_SIZE;
			this._control.validate();
			this._control.minWidth = MIN_SIZE;
			Assert.assertFalse("The component incorrectly invalidated when setting minWidth, but component has explicitWidth", this._control.isInvalid());
		}

		[Test]
		public function testNoInvalidationWhenSettingMinHeightWithExplicitHeight():void
		{
			this._control.height = EXPLICIT_SIZE_SMALLER_THAN_MIN_SIZE;
			this._control.validate();
			this._control.minHeight = MIN_SIZE;
			Assert.assertFalse("The component incorrectly invalidated when setting minHeight, but component has explicitHeight", this._control.isInvalid());
		}

		[Test]
		public function testNoInvalidationWhenSettingMinWidthWithLargerActualWidth():void
		{
			this._control.addChild(new Quad(EXPLICIT_SIZE_LARGER_THAN_MAX_SIZE, EXPLICIT_SIZE_LARGER_THAN_MAX_SIZE, 0xff00ff));
			this._control.validate();
			this._control.minWidth = MIN_SIZE;
			Assert.assertFalse("The component incorrectly invalidated when setting minWidth, but component actualWidth is currently larger", this._control.isInvalid());
		}

		[Test]
		public function testNoInvalidationWhenSettingMinHeightWithLargerActualHeight():void
		{
			this._control.addChild(new Quad(EXPLICIT_SIZE_LARGER_THAN_MAX_SIZE, EXPLICIT_SIZE_LARGER_THAN_MAX_SIZE, 0xff00ff));
			this._control.validate();
			this._control.minHeight = MIN_SIZE;
			Assert.assertFalse("The component incorrectly invalidated when setting minHeight, but component actualHeight is currently larger", this._control.isInvalid());
		}

		[Test]
		public function testNoInvalidationWhenSettingMinWidthEqualToActualWidth():void
		{
			this._control.addChild(new Quad(MIN_SIZE, MIN_SIZE, 0xff00ff));
			this._control.validate();
			this._control.minWidth = MIN_SIZE;
			Assert.assertFalse("The component incorrectly invalidated when setting minWidth, but component actualWidth is equal", this._control.isInvalid());
		}

		[Test]
		public function testNoInvalidationWhenSettingMinHeightEqualToActualHeight():void
		{
			this._control.addChild(new Quad(MIN_SIZE, MIN_SIZE, 0xff00ff));
			this._control.validate();
			this._control.minHeight = MIN_SIZE;
			Assert.assertFalse("The component incorrectly invalidated when setting minHeight, but component actualHeight is equal", this._control.isInvalid());
		}

		[Test]
		public function testNoInvalidationWhenSettingMaxWidthWithExplicitWidth():void
		{
			this._control.width = EXPLICIT_SIZE_LARGER_THAN_MAX_SIZE;
			this._control.validate();
			this._control.maxWidth = MAX_SIZE;
			Assert.assertFalse("The component incorrectly invalidated when setting maxWidth, but component has explicitWidth", this._control.isInvalid());
		}

		[Test]
		public function testNoInvalidationWhenSettingMaxHeightWithExplicitHeight():void
		{
			this._control.height = EXPLICIT_SIZE_LARGER_THAN_MAX_SIZE;
			this._control.validate();
			this._control.maxHeight = MAX_SIZE;
			Assert.assertFalse("The component incorrectly invalidated when setting maxHeight, but component has explicitHeight", this._control.isInvalid());
		}

		[Test]
		public function testNoInvalidationWhenSettingMaxWidthWithSmallerActualWidth():void
		{
			this._control.addChild(new Quad(EXPLICIT_SIZE_SMALLER_THAN_MIN_SIZE, EXPLICIT_SIZE_SMALLER_THAN_MIN_SIZE, 0xff00ff));
			this._control.validate();
			this._control.maxWidth = MAX_SIZE;
			Assert.assertFalse("The component incorrectly invalidated when setting maxWidth, but component actualWidth is currently smaller", this._control.isInvalid());
		}

		[Test]
		public function testNoInvalidationWhenSettingMaxHeightWithSmallerActualHeight():void
		{
			this._control.addChild(new Quad(EXPLICIT_SIZE_SMALLER_THAN_MIN_SIZE, EXPLICIT_SIZE_SMALLER_THAN_MIN_SIZE, 0xff00ff));
			this._control.validate();
			this._control.maxHeight = MAX_SIZE;
			Assert.assertFalse("The component incorrectly invalidated when setting maxHeight, but component actualHeight is currently smaller", this._control.isInvalid());
		}

		[Test]
		public function testNoInvalidationWhenSettingMaxWidthEqualToActualWidth():void
		{
			this._control.addChild(new Quad(MAX_SIZE, MAX_SIZE, 0xff00ff));
			this._control.validate();
			this._control.maxWidth = MAX_SIZE;
			Assert.assertFalse("The component incorrectly invalidated when setting maxWidth, but component actualWidth is equal", this._control.isInvalid());
		}

		[Test]
		public function testNoInvalidationWhenSettingMaxHeightEqualToActualHeight():void
		{
			this._control.addChild(new Quad(MAX_SIZE, MAX_SIZE, 0xff00ff));
			this._control.validate();
			this._control.maxHeight = MAX_SIZE;
			Assert.assertFalse("The component incorrectly invalidated when setting maxHeight, but component actualHeight is equal", this._control.isInvalid());
		}

		[Test]
		public function testInvalidAfterSettingMinWidthLargerThanActualWidth():void
		{
			this._control.backgroundSkin = new Quad(40, 50);
			this._control.validate();
			this._control.minWidth = 183;
			Assert.assertTrue("The component failed to set invalidate flag after setting minWidth larger than actualWidth",
				this._control.isInvalid());
		}

		[Test]
		public function testInvalidAfterSettingMinHeightLargerThanActualHeight():void
		{
			this._control.backgroundSkin = new Quad(40, 50);
			this._control.validate();
			this._control.minHeight = 183;
			Assert.assertTrue("The component failed to set invalidate flag after setting minHeight larger than actualHeight",
				this._control.isInvalid());
		}
	}
}


================================================
FILE: test/source/feathers/tests/NumericStepperMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.Button;
	import feathers.controls.NumericStepper;
	import feathers.controls.StepperButtonLayoutMode;
	import feathers.controls.TextInput;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class NumericStepperMeasurementTests
	{
		private static const TEXT_INPUT_GAP:Number = 8;
		private static const BUTTON_GAP:Number = 3;
		private static const LARGER_SIZE:Number = 300;
		private static const LARGER_SIZE2:Number = 250;
		private static const SMALLER_SIZE:Number = 100;
		private static const SMALLER_SIZE2:Number = 90;
		
		private var _stepper:NumericStepper;

		[Before]
		public function prepare():void
		{
			this._stepper = new NumericStepper();
			TestFeathers.starlingRoot.addChild(this._stepper);
		}

		[After]
		public function cleanup():void
		{
			this._stepper.removeFromParent(true);
			this._stepper = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testAutoSizeWidthWithButtonLayoutModeRightSideVertical():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.RIGHT_SIDE_VERTICAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.buttonGap = BUTTON_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(LARGER_SIZE, 1, 0xff00ff);
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(SMALLER_SIZE, 1, 0xffff00);
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(SMALLER_SIZE2, 1, 0x00ffff);
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The width of the NumericStepper was not calculated correctly with buttonLayoutMode set to right side vertical.",
				LARGER_SIZE + SMALLER_SIZE + TEXT_INPUT_GAP, this._stepper.width);
		}

		[Test]
		public function testAutoSizeHeightWithButtonLayoutModeRightSideVerticalAndLargerTextInput():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.RIGHT_SIDE_VERTICAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.buttonGap = BUTTON_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(1, LARGER_SIZE, 0xff00ff);
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, SMALLER_SIZE, 0xffff00);
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, SMALLER_SIZE2, 0x00ffff);
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The height of the NumericStepper was not calculated correctly with buttonLayoutMode set to right side vertical and a larger text input.",
				LARGER_SIZE, this._stepper.height);
		}

		[Test]
		public function testAutoSizeHeightWithButtonLayoutModeRightSideVerticalAndSmallerTextInput():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.RIGHT_SIDE_VERTICAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.buttonGap = BUTTON_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(1, SMALLER_SIZE, 0xff00ff);
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, LARGER_SIZE, 0xffff00);
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, SMALLER_SIZE2, 0x00ffff);
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The height of the NumericStepper was not calculated correctly with buttonLayoutMode set to right side vertical and a smaller text input.",
				LARGER_SIZE + SMALLER_SIZE2 + BUTTON_GAP, this._stepper.height);
		}

		[Test]
		public function testAutoSizeMinWidthWithButtonLayoutModeRightSideVertical():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.RIGHT_SIDE_VERTICAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.buttonGap = BUTTON_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(1, 1, 0xff00ff);
				input.minWidth = LARGER_SIZE;
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0xffff00);
				button.minWidth = SMALLER_SIZE;
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0x00ffff);
				button.minWidth = SMALLER_SIZE2;
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The minWidth of the NumericStepper was not calculated correctly with buttonLayoutMode set to right side vertical.",
				LARGER_SIZE + SMALLER_SIZE + TEXT_INPUT_GAP, this._stepper.minWidth);
		}

		[Test]
		public function testAutoSizeMinHeightWithButtonLayoutModeRightSideVerticalAndLargerTextInput():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.RIGHT_SIDE_VERTICAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.buttonGap = BUTTON_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(1, 1, 0xff00ff);
				input.minHeight = LARGER_SIZE;
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0xffff00);
				button.minHeight = SMALLER_SIZE;
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0x00ffff);
				button.minHeight = SMALLER_SIZE2;
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The minHeight of the NumericStepper was not calculated correctly with buttonLayoutMode set to right side vertical and a larger text input.",
				LARGER_SIZE, this._stepper.minHeight);
		}

		[Test]
		public function testAutoSizeMinHeightWithButtonLayoutModeRightSideVerticalAndSmallerTextInput():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.RIGHT_SIDE_VERTICAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.buttonGap = BUTTON_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(1, 1, 0xff00ff);
				input.minHeight = SMALLER_SIZE;
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0xffff00);
				button.minHeight = LARGER_SIZE;
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0x00ffff);
				button.minHeight = SMALLER_SIZE2;
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The minWidth of the NumericStepper was not calculated correctly with buttonLayoutMode set to right side vertical and a smaller text input.",
				LARGER_SIZE + SMALLER_SIZE2 + BUTTON_GAP, this._stepper.minHeight);
		}

		[Test]
		public function testAutoSizeWidthWithButtonLayoutModeSplitVerticalAndLargerTextInput():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_VERTICAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(LARGER_SIZE, 1, 0xff00ff);
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(SMALLER_SIZE, 1, 0xffff00);
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(SMALLER_SIZE2, 1, 0x00ffff);
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The width of the NumericStepper was not calculated correctly with buttonLayoutMode set to split vertical and a larger text input.",
				LARGER_SIZE, this._stepper.width);
		}

		[Test]
		public function testAutoSizeWidthWithButtonLayoutModeSplitVerticalAndSmallerTextInput():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_VERTICAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(SMALLER_SIZE, 1, 0xff00ff);
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(LARGER_SIZE, 1, 0xffff00);
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(LARGER_SIZE2, 1, 0x00ffff);
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The width of the NumericStepper was not calculated correctly with buttonLayoutMode set to split vertical and a smaller text input.",
				LARGER_SIZE, this._stepper.width);
		}

		[Test]
		public function testAutoSizeHeightWithButtonLayoutModeSplitVertical():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_VERTICAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(1, LARGER_SIZE, 0xff00ff);
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, SMALLER_SIZE, 0xffff00);
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, SMALLER_SIZE2, 0x00ffff);
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The height of the NumericStepper was not calculated correctly with buttonLayoutMode set to split vertical.",
				SMALLER_SIZE + SMALLER_SIZE2 + LARGER_SIZE + TEXT_INPUT_GAP * 2, this._stepper.height);
		}

		[Test]
		public function testAutoSizeMinWidthWithButtonLayoutModeSplitVerticalAndLargerTextInput():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_VERTICAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(1, 1, 0xff00ff);
				input.minWidth = LARGER_SIZE;
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0xffff00);
				button.minWidth = SMALLER_SIZE;
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0x00ffff);
				button.minWidth = SMALLER_SIZE2;
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The minWidth of the NumericStepper was not calculated correctly with buttonLayoutMode set to split vertical and a larger text input.",
				LARGER_SIZE, this._stepper.minWidth);
		}

		[Test]
		public function testAutoSizeMinWidthWithButtonLayoutModeSplitVerticalAndSmallerTextInput():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_VERTICAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(1, 1, 0xff00ff);
				input.minWidth = SMALLER_SIZE;
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0xffff00);
				button.minWidth = LARGER_SIZE;
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0x00ffff);
				button.minWidth = LARGER_SIZE;
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The minWidth of the NumericStepper was not calculated correctly with buttonLayoutMode set to split vertical and a smaller text input.",
				LARGER_SIZE, this._stepper.minWidth);
		}

		[Test]
		public function testAutoSizeMinHeightWithButtonLayoutModeSplitVertical():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_VERTICAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(1, 1, 0xff00ff);
				input.minHeight = LARGER_SIZE;
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0xffff00);
				button.minHeight = SMALLER_SIZE;
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0x00ffff);
				button.minHeight = SMALLER_SIZE2;
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The minHeight of the NumericStepper was not calculated correctly with buttonLayoutMode set to split vertical.",
				SMALLER_SIZE + SMALLER_SIZE2 + LARGER_SIZE + TEXT_INPUT_GAP * 2, this._stepper.minHeight);
		}

		[Test]
		public function testAutoSizeWidthWithButtonLayoutModeSplitHorizontal():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_HORIZONTAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(LARGER_SIZE, 1, 0xff00ff);
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(SMALLER_SIZE, 1, 0xffff00);
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(SMALLER_SIZE2, 1, 0x00ffff);
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The width of the NumericStepper was not calculated correctly with buttonLayoutMode set to split horizontal.",
				SMALLER_SIZE + SMALLER_SIZE2 + LARGER_SIZE + TEXT_INPUT_GAP * 2, this._stepper.width);
		}

		[Test]
		public function testAutoSizeHeightWithButtonLayoutModeSplitHorizontalAndLargerTextInput():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_HORIZONTAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(1, LARGER_SIZE, 0xff00ff);
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, SMALLER_SIZE, 0xffff00);
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, SMALLER_SIZE2, 0x00ffff);
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The height of the NumericStepper was not calculated correctly with buttonLayoutMode set to split horizontal and a larger text input.",
				LARGER_SIZE, this._stepper.height);
		}

		[Test]
		public function testAutoSizeHeightWithButtonLayoutModeSplitHorizontalAndSmallerTextInput():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_HORIZONTAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(1, SMALLER_SIZE, 0xff00ff);
				input.minHeight = SMALLER_SIZE;
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, LARGER_SIZE, 0xffff00);
				button.minHeight = LARGER_SIZE;
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, LARGER_SIZE2, 0x00ffff);
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The height of the NumericStepper was not calculated correctly with buttonLayoutMode set to split horizontal and a smaller text input.",
				LARGER_SIZE, this._stepper.height);
		}

		[Test]
		public function testAutoSizeMinWidthWithButtonLayoutModeSplitHorizontal():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_HORIZONTAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(1, 1, 0xff00ff);
				input.minWidth = LARGER_SIZE;
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0xffff00);
				button.minWidth = SMALLER_SIZE;
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0x00ffff);
				button.minWidth = SMALLER_SIZE2;
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The minWidth of the NumericStepper was not calculated correctly with buttonLayoutMode set to split horizontal.",
				SMALLER_SIZE + SMALLER_SIZE2 + LARGER_SIZE + TEXT_INPUT_GAP * 2, this._stepper.minWidth);
		}

		[Test]
		public function testAutoSizeMinHeightWithButtonLayoutModeSplitHorizontalAndLargerTextInput():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_HORIZONTAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(1, 1, 0xff00ff);
				input.minHeight = LARGER_SIZE;
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0xffff00);
				button.minHeight = SMALLER_SIZE;
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0x00ffff);
				button.minHeight = SMALLER_SIZE2;
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The minHeight of the NumericStepper was not calculated correctly with buttonLayoutMode set to split horizontal and a larger text input.",
				LARGER_SIZE, this._stepper.minHeight);
		}

		[Test]
		public function testAutoSizeMinHeightWithButtonLayoutModeSplitHorizontalAndSmallerTextInput():void
		{
			this._stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_HORIZONTAL;
			this._stepper.textInputGap = TEXT_INPUT_GAP;
			this._stepper.textInputFactory = function():TextInput
			{
				var input:TextInput = new TextInput();
				input.backgroundSkin = new Quad(1, 1, 0xff00ff);
				input.minHeight = SMALLER_SIZE;
				return input;
			};
			this._stepper.incrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0xffff00);
				button.minHeight = LARGER_SIZE;
				return button;
			};
			this._stepper.decrementButtonFactory = function():Button
			{
				var button:Button = new Button();
				button.defaultSkin = new Quad(1, 1, 0x00ffff);
				button.minHeight = LARGER_SIZE2;
				return button;
			};
			this._stepper.validate();
			Assert.assertStrictlyEquals("The minHeight of the NumericStepper was not calculated correctly with buttonLayoutMode set to split horizontal and a smaller text input.",
				LARGER_SIZE, this._stepper.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/PageIndicatorMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.PageIndicator;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class PageIndicatorMeasurementTests
	{
		private static const SYMBOL_WIDTH:Number = 20;
		private static const SYMBOL_HEIGHT:Number = 16;
		private static const GAP:Number = 4;

		private static const PADDING_TOP:Number = 4;
		private static const PADDING_RIGHT:Number = 10;
		private static const PADDING_BOTTOM:Number = 3;
		private static const PADDING_LEFT:Number = 16;
		
		private var _pages:PageIndicator;

		[Before]
		public function prepare():void
		{
			this._pages = new PageIndicator();
			this._pages.normalSymbolFactory = function():Quad
			{
				return new Quad(SYMBOL_WIDTH, SYMBOL_HEIGHT, 0xff00ff);
			};
			this._pages.selectedSymbolFactory = function():Quad
			{
				return new Quad(SYMBOL_WIDTH, SYMBOL_HEIGHT, 0xff00ff);
			};
			TestFeathers.starlingRoot.addChild(this._pages);
		}

		[After]
		public function cleanup():void
		{
			this._pages.removeFromParent(true);
			this._pages = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testAutoSize():void
		{
			this._pages.pageCount = 5;
			this._pages.validate();

			Assert.assertStrictlyEquals("The width of the page indicator was not calculated correctly based on the width of the symbols.",
				SYMBOL_WIDTH * this._pages.pageCount, this._pages.width);
			Assert.assertStrictlyEquals("The height of the progress bar was not calculated correctly based on the height of the symbols.",
				SYMBOL_HEIGHT, this._pages.height);
			Assert.assertStrictlyEquals("The minWidth of the progress bar was not calculated correctly based on the width of the symbols.",
				SYMBOL_WIDTH * this._pages.pageCount, this._pages.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the progress bar was not calculated correctly based on the height of the symbols.",
				SYMBOL_HEIGHT, this._pages.minHeight);
		}

		[Test]
		public function testAutoSizeWithGap():void
		{
			this._pages.pageCount = 5;
			this._pages.gap = GAP;
			this._pages.validate();

			Assert.assertStrictlyEquals("The width of the page indicator was not calculated correctly based on the width of the symbols and the gap.",
				(SYMBOL_WIDTH + GAP) * this._pages.pageCount - GAP, this._pages.width);
			Assert.assertStrictlyEquals("The height of the progress bar was not calculated correctly based on the height of the symbols.",
				SYMBOL_HEIGHT, this._pages.height);
			Assert.assertStrictlyEquals("The minWidth of the progress bar was not calculated correctly based on the width of the symbols and the gap.",
				(SYMBOL_WIDTH + GAP) * this._pages.pageCount - GAP, this._pages.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the progress bar was not calculated correctly based on the height of the symbols.",
				SYMBOL_HEIGHT, this._pages.minHeight);
		}

		[Test]
		public function testAutoSizeWithPadding():void
		{
			this._pages.pageCount = 5;
			this._pages.paddingTop = PADDING_TOP;
			this._pages.paddingRight = PADDING_RIGHT;
			this._pages.paddingBottom = PADDING_BOTTOM;
			this._pages.paddingLeft = PADDING_LEFT;
			this._pages.validate();

			Assert.assertStrictlyEquals("The width of the page indicator was not calculated correctly based on the width of the symbols plus padding left and padding right.",
				SYMBOL_WIDTH * this._pages.pageCount + PADDING_LEFT + PADDING_RIGHT, this._pages.width);
			Assert.assertStrictlyEquals("The height of the progress bar was not calculated correctly based on the height of the symbols plus padding top and padding bottom.",
				SYMBOL_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._pages.height);
			Assert.assertStrictlyEquals("The minWidth of the progress bar was not calculated correctly based on the width of the symbols plus padding left and padding right.",
				SYMBOL_WIDTH * this._pages.pageCount + PADDING_LEFT + PADDING_RIGHT, this._pages.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the progress bar was not calculated correctly based on the height of the symbols plus padding top and padding bottom.",
				SYMBOL_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._pages.minHeight);
		}

		[Test]
		public function testAutoSizeWithGapAndPadding():void
		{
			this._pages.pageCount = 5;
			this._pages.gap = GAP;
			this._pages.paddingTop = PADDING_TOP;
			this._pages.paddingRight = PADDING_RIGHT;
			this._pages.paddingBottom = PADDING_BOTTOM;
			this._pages.paddingLeft = PADDING_LEFT;
			this._pages.validate();

			Assert.assertStrictlyEquals("The width of the page indicator was not calculated correctly based on the width of the symbols plus the gap plus padding left and padding right.",
				(SYMBOL_WIDTH + GAP) * this._pages.pageCount - GAP + PADDING_LEFT + PADDING_RIGHT, this._pages.width);
			Assert.assertStrictlyEquals("The height of the progress bar was not calculated correctly based on the height of the symbols plus padding top and padding bottom.",
				SYMBOL_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._pages.height);
			Assert.assertStrictlyEquals("The minWidth of the progress bar was not calculated correctly based on the width of the symbols plus the gap plus padding left and padding right.",
				(SYMBOL_WIDTH + GAP) * this._pages.pageCount - GAP + PADDING_LEFT + PADDING_RIGHT, this._pages.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the progress bar was not calculated correctly based on the height of the symbols plus padding top and padding bottom.",
				SYMBOL_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._pages.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/PanelMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.LayoutGroup;
	import feathers.controls.Panel;
	import feathers.core.IFeathersControl;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class PanelMeasurementTests
	{
		private static const BACKGROUND_WIDTH:Number = 200;
		private static const BACKGROUND_HEIGHT:Number = 250;

		private static const COMPLEX_BACKGROUND_WIDTH:Number = 340;
		private static const COMPLEX_BACKGROUND_HEIGHT:Number = 350;
		private static const COMPLEX_BACKGROUND_MIN_WIDTH:Number = 280;
		private static const COMPLEX_BACKGROUND_MIN_HEIGHT:Number = 290;

		private static const PADDING_TOP:Number = 50;
		private static const PADDING_RIGHT:Number = 54;
		private static const PADDING_BOTTOM:Number = 59;
		private static const PADDING_LEFT:Number = 60;

		private static const OUTER_PADDING_TOP:Number = 40;
		private static const OUTER_PADDING_RIGHT:Number = 64;
		private static const OUTER_PADDING_BOTTOM:Number = 69;
		private static const OUTER_PADDING_LEFT:Number = 50;
		
		private static const HEADER_WIDTH:Number = 150;
		private static const HEADER_HEIGHT:Number = 40;

		private static const FOOTER_WIDTH:Number = 160;
		private static const FOOTER_HEIGHT:Number = 30;

		private static const SMALL_ITEM_WIDTH:Number = 120;
		private static const LARGE_ITEM_WIDTH:Number = 180;
		private static const ITEM_HEIGHT:Number = 60;

		private static const LARGE_HEADER_WIDTH:Number = 550;

		private var _panel:Panel;

		[Before]
		public function prepare():void
		{
			this._panel = new Panel();
			TestFeathers.starlingRoot.addChild(this._panel);
		}

		[After]
		public function cleanup():void
		{
			this._panel.removeFromParent(true);
			this._panel = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function addSimpleBackground():void
		{
			this._panel.backgroundSkin = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT, 0xff00ff);
		}

		private function addComplexBackground():void
		{
			var backgroundSkin:LayoutGroup = new LayoutGroup();
			backgroundSkin.width = COMPLEX_BACKGROUND_WIDTH;
			backgroundSkin.height = COMPLEX_BACKGROUND_HEIGHT;
			backgroundSkin.minWidth = COMPLEX_BACKGROUND_MIN_WIDTH;
			backgroundSkin.minHeight = COMPLEX_BACKGROUND_MIN_HEIGHT;
			this._panel.backgroundSkin = backgroundSkin;
		}

		private function addHeader():void
		{
			this._panel.headerFactory = function():IFeathersControl
			{
				var header:LayoutGroup = new LayoutGroup();
				header.backgroundSkin = new Quad(HEADER_WIDTH, HEADER_HEIGHT, 0xff00ff);
				return header;
			};
		}

		private function addWideHeader():void
		{
			this._panel.headerFactory = function():IFeathersControl
			{
				var header:LayoutGroup = new LayoutGroup();
				header.backgroundSkin = new Quad(LARGE_HEADER_WIDTH, HEADER_HEIGHT, 0xff00ff);
				return header;
			};
		}

		private function addFooter():void
		{
			this._panel.footerFactory = function():IFeathersControl
			{
				var footer:LayoutGroup = new LayoutGroup();
				footer.backgroundSkin = new Quad(FOOTER_WIDTH, FOOTER_HEIGHT, 0x00ff00);
				return footer;
			};
		}

		[Test]
		public function testAutoSizeWithHeader():void
		{
			this.addHeader();
			this._panel.validate();
			Assert.assertStrictlyEquals("The width of the Panel was not calculated correctly with a header.",
				HEADER_WIDTH, this._panel.width);
			Assert.assertStrictlyEquals("The height of the Panel was not calculated correctly with a header.",
				HEADER_HEIGHT, this._panel.height);
			Assert.assertStrictlyEquals("The minWidth of the Panel was not calculated correctly with a header.",
				HEADER_WIDTH, this._panel.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Panel was not calculated correctly with a header.",
				HEADER_HEIGHT, this._panel.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderAndPadding():void
		{
			this.addHeader();
			this._panel.paddingTop = PADDING_TOP;
			this._panel.paddingRight = PADDING_RIGHT;
			this._panel.paddingBottom = PADDING_BOTTOM;
			this._panel.paddingLeft = PADDING_LEFT;
			this._panel.validate();

			Assert.assertStrictlyEquals("The width of the Panel was not calculated correctly based on the header and left and right padding.",
				HEADER_WIDTH, this._panel.width);
			Assert.assertStrictlyEquals("The height of the Panel was not calculated correctly based on the header and top and bottom padding.",
				HEADER_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._panel.height);
			Assert.assertStrictlyEquals("The minWidth of the Panel was not calculated correctly based on the header and left and right padding.",
				HEADER_WIDTH, this._panel.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Panel was not calculated correctly based on the header and top and bottom padding.",
				HEADER_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._panel.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderAndOuterPadding():void
		{
			this.addHeader();
			this._panel.outerPaddingTop = OUTER_PADDING_TOP;
			this._panel.outerPaddingRight = OUTER_PADDING_RIGHT;
			this._panel.outerPaddingBottom = OUTER_PADDING_BOTTOM;
			this._panel.outerPaddingLeft = OUTER_PADDING_LEFT;
			this._panel.validate();

			Assert.assertStrictlyEquals("The width of the Panel was not calculated correctly based on the header and left and right outer padding.",
				HEADER_WIDTH + OUTER_PADDING_LEFT + OUTER_PADDING_RIGHT, this._panel.width);
			Assert.assertStrictlyEquals("The height of the Panel was not calculated correctly based on the header and top and bottom outer padding.",
				HEADER_HEIGHT + OUTER_PADDING_TOP + OUTER_PADDING_BOTTOM, this._panel.height);
			Assert.assertStrictlyEquals("The minWidth of the Panel was not calculated correctly based on the header and left and right outer padding.",
				HEADER_WIDTH + OUTER_PADDING_LEFT + OUTER_PADDING_RIGHT, this._panel.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Panel was not calculated correctly based on the header and top and bottom outer padding.",
				HEADER_HEIGHT + OUTER_PADDING_TOP + OUTER_PADDING_BOTTOM, this._panel.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderAndSimpleBackgroundSkin():void
		{
			this.addHeader();
			this.addSimpleBackground();
			this._panel.validate();

			Assert.assertStrictlyEquals("The width of the Panel was not calculated correctly based on the background width larger than the header width.",
				BACKGROUND_WIDTH, this._panel.width);
			Assert.assertStrictlyEquals("The height of the Panel was not calculated correctly based on the background height.",
				BACKGROUND_HEIGHT, this._panel.height);
			Assert.assertStrictlyEquals("The minWidth of the Panel was not calculated correctly based on the background width larger than the header width.",
				BACKGROUND_WIDTH, this._panel.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Panel was not calculated correctly based on the background height.",
				BACKGROUND_HEIGHT, this._panel.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderAndComplexBackground():void
		{
			this.addHeader();
			this.addComplexBackground();
			this._panel.validate();

			Assert.assertStrictlyEquals("The width of the Panel was not calculated correctly based on the complex background width.",
				COMPLEX_BACKGROUND_WIDTH, this._panel.width);
			Assert.assertStrictlyEquals("The height of the Panel was not calculated correctly based on the complex background height.",
				COMPLEX_BACKGROUND_HEIGHT, this._panel.height);
			Assert.assertStrictlyEquals("The minWidth of the Panel was not calculated correctly based on the complex background minWidth.",
				COMPLEX_BACKGROUND_MIN_WIDTH, this._panel.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Panel was not calculated correctly based on the complex background minHeight.",
				COMPLEX_BACKGROUND_MIN_HEIGHT, this._panel.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderAndFooter():void
		{
			this.addHeader();
			this.addFooter();
			this._panel.validate();
			Assert.assertStrictlyEquals("The width of the Panel was not calculated correctly with header and footer.",
				FOOTER_WIDTH, this._panel.width);
			Assert.assertStrictlyEquals("The height of the Panel was not calculated correctly with header and footer.",
				HEADER_HEIGHT + FOOTER_HEIGHT, this._panel.height);
			Assert.assertStrictlyEquals("The minWidth of the Panel was not calculated correctly with header and footer.",
				FOOTER_WIDTH, this._panel.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Panel was not calculated correctly with header and footer.",
				HEADER_HEIGHT + FOOTER_HEIGHT, this._panel.minHeight);
		}

		[Test]
		public function testAutoSizeWidthWithHeaderAndSmallerFooter():void
		{
			this.addWideHeader();
			this.addFooter();
			this._panel.validate();
			Assert.assertStrictlyEquals("The width of the Panel was not calculated correctly with header and footer.",
				LARGE_HEADER_WIDTH, this._panel.width);
			Assert.assertStrictlyEquals("The minWidth of the Panel was not calculated correctly with header and footer.",
				LARGE_HEADER_WIDTH, this._panel.minWidth);
		}

		[Test]
		public function testAutoSizeWithHeaderFooterAndPadding():void
		{
			this.addHeader();
			this.addFooter();
			this._panel.paddingTop = PADDING_TOP;
			this._panel.paddingRight = PADDING_RIGHT;
			this._panel.paddingBottom = PADDING_BOTTOM;
			this._panel.paddingLeft = PADDING_LEFT;
			this._panel.validate();

			Assert.assertStrictlyEquals("The width of the Panel was not calculated correctly based on the header, footer, and left and right padding.",
				FOOTER_WIDTH, this._panel.width);
			Assert.assertStrictlyEquals("The height of the Panel was not calculated correctly based on the header, footer, and top and bottom padding.",
				HEADER_HEIGHT + FOOTER_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._panel.height);
			Assert.assertStrictlyEquals("The minWidth of the Panel was not calculated correctly based on the header, footer, and left and right padding.",
				FOOTER_WIDTH, this._panel.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Panel was not calculated correctly based on the header, footer, and top and bottom padding.",
				HEADER_HEIGHT + FOOTER_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._panel.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderFooterAndLargerSimpleBackgroundSkin():void
		{
			this.addHeader();
			this.addFooter();
			this.addSimpleBackground();
			this._panel.validate();

			Assert.assertStrictlyEquals("The width of the Panel was not calculated correctly based on the background width with a smaller header and footer.",
				BACKGROUND_WIDTH, this._panel.width);
			Assert.assertStrictlyEquals("The height of the Panel was not calculated correctly based on the background width with a smaller header and footer.",
				BACKGROUND_HEIGHT, this._panel.height);
			Assert.assertStrictlyEquals("The minWidth of the Panel was not calculated correctly based on the background height with a smaller header and footer.",
				BACKGROUND_WIDTH, this._panel.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Panel was not calculated correctly based on the background width with a smaller header and footer.",
				BACKGROUND_HEIGHT, this._panel.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderFooterAndLargerComplexBackground():void
		{
			this.addHeader();
			this.addFooter();
			this.addComplexBackground();
			this._panel.validate();

			Assert.assertStrictlyEquals("The width of the Panel was not calculated correctly based on the complex background width with a smaller header and footer.",
				COMPLEX_BACKGROUND_WIDTH, this._panel.width);
			Assert.assertStrictlyEquals("The height of the Panel was not calculated correctly based on the complex background height with a smaller header and footer.",
				COMPLEX_BACKGROUND_HEIGHT, this._panel.height);
			Assert.assertStrictlyEquals("The minWidth of the Panel was not calculated correctly based on the complex background minWidth with a smaller header and footer.",
				COMPLEX_BACKGROUND_MIN_WIDTH, this._panel.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Panel was not calculated correctly based on the complex background minHeight with a smaller header and footer.",
				COMPLEX_BACKGROUND_MIN_HEIGHT, this._panel.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderAndNarrowChild():void
		{
			this.addHeader();
			this._panel.addChild(new Quad(SMALL_ITEM_WIDTH, ITEM_HEIGHT, 0xff00ff));
			this._panel.validate();
			Assert.assertStrictlyEquals("The width of the Panel was not calculated correctly with a header.",
				HEADER_WIDTH, this._panel.width);
			Assert.assertStrictlyEquals("The height of the Panel was not calculated correctly with a header.",
				HEADER_HEIGHT + ITEM_HEIGHT, this._panel.height);
			Assert.assertStrictlyEquals("The minWidth of the Panel was not calculated correctly with a header.",
				HEADER_WIDTH, this._panel.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Panel was not calculated correctly with a header.",
				HEADER_HEIGHT + ITEM_HEIGHT, this._panel.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderAndWideChild():void
		{
			this.addHeader();
			this._panel.addChild(new Quad(LARGE_ITEM_WIDTH, ITEM_HEIGHT, 0xff00ff));
			this._panel.validate();
			Assert.assertStrictlyEquals("The width of the Panel was not calculated correctly with a header.",
				LARGE_ITEM_WIDTH, this._panel.width);
			Assert.assertStrictlyEquals("The height of the Panel was not calculated correctly with a header.",
				HEADER_HEIGHT + ITEM_HEIGHT, this._panel.height);
			Assert.assertStrictlyEquals("The minWidth of the Panel was not calculated correctly with a header.",
				LARGE_ITEM_WIDTH, this._panel.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Panel was not calculated correctly with a header.",
				HEADER_HEIGHT + ITEM_HEIGHT, this._panel.minHeight);
		}

		[Test]
		public function testAutoSizeWithHeaderChildAndMeasureViewPortSetToFalse():void
		{
			this.addHeader();
			this._panel.addChild(new Quad(SMALL_ITEM_WIDTH, ITEM_HEIGHT, 0xff00ff));
			this._panel.measureViewPort = false;
			this._panel.validate();
			Assert.assertStrictlyEquals("The width of the Panel was not calculated correctly with a header.",
				HEADER_WIDTH, this._panel.width);
			Assert.assertStrictlyEquals("The height of the Panel was not calculated correctly with a header.",
				HEADER_HEIGHT, this._panel.height);
			Assert.assertStrictlyEquals("The minWidth of the Panel was not calculated correctly with a header.",
				HEADER_WIDTH, this._panel.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Panel was not calculated correctly with a header.",
				HEADER_HEIGHT, this._panel.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/PickerListMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.Button;
	import feathers.controls.LayoutGroup;
	import feathers.controls.PickerList;
	import feathers.controls.text.BitmapFontTextRenderer;
	import feathers.data.ListCollection;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class PickerListMeasurementTests
	{
		private static const SMALL_BACKGROUND_WIDTH:Number = 10;
		private static const SMALL_BACKGROUND_HEIGHT:Number = 12;
		private static const LARGE_BACKGROUND_WIDTH:Number = 100;
		private static const LARGE_BACKGROUND_HEIGHT:Number = 110;
		private static const COMPLEX_BACKGROUND_WIDTH:Number = 54;
		private static const COMPLEX_BACKGROUND_HEIGHT:Number = 55;
		private static const COMPLEX_BACKGROUND_MIN_WIDTH:Number = 38;
		private static const COMPLEX_BACKGROUND_MIN_HEIGHT:Number = 39;

		private static const MIN_WIDTH:Number = 60;
		private static const MIN_HEIGHT:Number = 62;

		private static const SMALL_ICON_WIDTH:Number = 13;
		private static const SMALL_ICON_HEIGHT:Number = 11;
		private static const LARGE_ICON_WIDTH:Number = 105;
		private static const LARGE_ICON_HEIGHT:Number = 115;
		private static const COMPLEX_ICON_WIDTH:Number = 23;
		private static const COMPLEX_ICON_HEIGHT:Number = 25;
		private static const COMPLEX_ICON_MIN_WIDTH:Number = 18;
		private static const COMPLEX_ICON_MIN_HEIGHT:Number = 19;

		private static const PADDING_TOP:Number = 50;
		private static const PADDING_RIGHT:Number = 54;
		private static const PADDING_BOTTOM:Number = 59;
		private static const PADDING_LEFT:Number = 60;
		private static const GAP:Number = 6;
		
		private var _list:PickerList;
		private var _textRenderer:BitmapFontTextRenderer;

		[Before]
		public function prepare():void
		{
			this._list = new PickerList();
			this._list.buttonFactory = function():Button
			{
				var button:Button = new Button();
				button.labelFactory = function():BitmapFontTextRenderer
				{
					return new BitmapFontTextRenderer();
				}
				return button;
			}
			TestFeathers.starlingRoot.addChild(this._list);

			this._textRenderer = new BitmapFontTextRenderer();
			TestFeathers.starlingRoot.addChild(this._textRenderer);
		}

		[After]
		public function cleanup():void
		{
			this._list.removeFromParent(true);
			this._list = null;

			this._textRenderer.removeFromParent(true);
			this._textRenderer = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function addSmallSimpleIcon():void
		{
			var factory:Function = this._list.buttonFactory;
			this._list.buttonFactory = function():Button
			{
				var button:Button = Button(factory());
				button.defaultIcon = new Quad(SMALL_ICON_WIDTH, SMALL_ICON_HEIGHT, 0xff00ff);
				return button;
			};
		}

		private function addLargeSimpleIcon():void
		{
			var factory:Function = this._list.buttonFactory;
			this._list.buttonFactory = function():Button
			{
				var button:Button = Button(factory());
				button.defaultIcon = new Quad(LARGE_ICON_WIDTH, LARGE_ICON_HEIGHT, 0xff00ff);
				return button;
			};
		}

		private function addComplexIcon():void
		{
			var factory:Function = this._list.buttonFactory;
			this._list.buttonFactory = function():Button
			{
				var button:Button = Button(factory());
				var icon:LayoutGroup = new LayoutGroup();
				icon.width = COMPLEX_ICON_WIDTH;
				icon.height = COMPLEX_ICON_HEIGHT;
				icon.minWidth = COMPLEX_ICON_MIN_WIDTH;
				icon.minHeight = COMPLEX_ICON_MIN_HEIGHT;
				button.defaultIcon = icon;
				return button;
			};
		}

		private function addSmallSimpleBackground():void
		{
			var factory:Function = this._list.buttonFactory;
			this._list.buttonFactory = function():Button
			{
				var button:Button = Button(factory());
				button.defaultSkin = new Quad(SMALL_BACKGROUND_WIDTH, SMALL_BACKGROUND_HEIGHT, 0xff00ff);
				return button;
			};
		}

		private function addLargeSimpleBackground():void
		{
			var factory:Function = this._list.buttonFactory;
			this._list.buttonFactory = function():Button
			{
				var button:Button = Button(factory());
				button.defaultSkin = new Quad(LARGE_BACKGROUND_WIDTH, LARGE_BACKGROUND_HEIGHT, 0xff00ff);
				return button;
			};
		}

		private function addComplexBackground():void
		{
			var factory:Function = this._list.buttonFactory;
			this._list.buttonFactory = function():Button
			{
				var button:Button = Button(factory());
				var backgroundSkin:LayoutGroup = new LayoutGroup();
				backgroundSkin.width = COMPLEX_BACKGROUND_WIDTH;
				backgroundSkin.height = COMPLEX_BACKGROUND_HEIGHT;
				backgroundSkin.minWidth = COMPLEX_BACKGROUND_MIN_WIDTH;
				backgroundSkin.minHeight = COMPLEX_BACKGROUND_MIN_HEIGHT;
				button.defaultSkin = backgroundSkin;
				return button;
			};
		}

		private function addPadding():void
		{
			var factory:Function = this._list.buttonFactory;
			this._list.buttonFactory = function():Button
			{
				var button:Button = Button(factory());
				button.paddingTop = PADDING_TOP;
				button.paddingRight = PADDING_RIGHT;
				button.paddingBottom = PADDING_BOTTOM;
				button.paddingLeft = PADDING_LEFT;
				return button;
			};
		}

		private function addGap():void
		{
			var factory:Function = this._list.buttonFactory;
			this._list.buttonFactory = function():Button
			{
				var button:Button = Button(factory());
				button.gap = GAP;
				return button;
			};
		}

		[Test]
		public function testAutoSizeWithPadding():void
		{
			this.addPadding();
			this._list.validate();

			Assert.assertStrictlyEquals("The width of the PickerList was not calculated correctly based on the left and right padding.",
				PADDING_LEFT + PADDING_RIGHT, this._list.width);
			Assert.assertStrictlyEquals("The height of the PickerList was not calculated correctly based on the top and bottom padding.",
				PADDING_TOP + PADDING_BOTTOM, this._list.height);
			Assert.assertStrictlyEquals("The minWidth of the PickerList was not calculated correctly based on the left and right padding.",
				PADDING_LEFT + PADDING_RIGHT, this._list.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the PickerList was not calculated correctly based on the top and bottom padding.",
				PADDING_TOP + PADDING_BOTTOM, this._list.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabel():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this._list.dataProvider = new ListCollection(
			[
				{ label: labelText }
			]);
			this._list.validate();

			Assert.assertTrue("The width of the PickerList was not greater than 0 when using a label.",
				this._list.width > 0);
			Assert.assertTrue("The height of the PickerList was not greater than 0 when using a label.",
				this._list.height > 0);
			Assert.assertTrue("The minWidth of the PickerList was not greater than 0 when using a label.",
				this._list.minWidth > 0);
			Assert.assertTrue("The minHeight of the PickerList was not greater than 0 when using a label.",
				this._list.minHeight > 0);
			Assert.assertStrictlyEquals("The width of the PickerList was not calculated correctly based on the label.",
				this._textRenderer.width, this._list.width);
			Assert.assertStrictlyEquals("The height of the PickerList was not calculated correctly based on the label.",
				this._textRenderer.height, this._list.height);
			Assert.assertStrictlyEquals("The minWidth of the PickerList was not calculated correctly based on the label.",
				this._textRenderer.width, this._list.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the PickerList was not calculated correctly based on the label.",
				this._textRenderer.height, this._list.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabelAndPadding():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this.addPadding();
			this._list.dataProvider = new ListCollection(
			[
				{ label: labelText }
			]);
			this._list.validate();

			Assert.assertStrictlyEquals("The width of the PickerList was not calculated correctly based on the label and left and right padding.",
				this._textRenderer.width + PADDING_LEFT + PADDING_RIGHT, this._list.width);
			Assert.assertStrictlyEquals("The height of the PickerList was not calculated correctly based on the label and top and bottom padding.",
				this._textRenderer.height + PADDING_TOP + PADDING_BOTTOM, this._list.height);
			Assert.assertStrictlyEquals("The minWidth of the PickerList was not calculated correctly based on the label and left and right padding.",
				this._textRenderer.width + PADDING_LEFT + PADDING_RIGHT, this._list.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the PickerList was not calculated correctly based on the label and top and bottom padding.",
				this._textRenderer.height + PADDING_TOP + PADDING_BOTTOM, this._list.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabelAndSimpleIcon():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this.addLargeSimpleIcon();
			this._list.dataProvider = new ListCollection(
			[
				{ label: labelText }
			]);
			this._list.validate();

			Assert.assertStrictlyEquals("The width of the PickerList was not calculated correctly based on the label and icon.",
				this._textRenderer.width + LARGE_ICON_WIDTH, this._list.width);
			Assert.assertStrictlyEquals("The height of the PickerList was not calculated correctly based on the label and icon.",
				LARGE_ICON_HEIGHT, this._list.height);
			Assert.assertStrictlyEquals("The minWidth of the PickerList was not calculated correctly based on the label and icon.",
				this._textRenderer.width + LARGE_ICON_WIDTH, this._list.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the PickerList was not calculated correctly based on the label and icon.",
				LARGE_ICON_HEIGHT, this._list.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabelGapAndSimpleIcon():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this.addLargeSimpleIcon();
			this.addGap();
			this._list.dataProvider = new ListCollection(
			[
				{ label: labelText }
			]);
			this._list.validate();

			Assert.assertStrictlyEquals("The width of the PickerList was not calculated correctly based on the label, gap, and icon.",
				this._textRenderer.width + GAP + LARGE_ICON_WIDTH, this._list.width);
			Assert.assertStrictlyEquals("The height of the PickerList was not calculated correctly based on the label, gap, and icon.",
				LARGE_ICON_HEIGHT, this._list.height);
			Assert.assertStrictlyEquals("The minWidth of the PickerList was not calculated correctly based on the label, gap, and icon.",
				this._textRenderer.width + GAP + LARGE_ICON_WIDTH, this._list.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the PickerList was not calculated correctly based on the label, and icon.",
				LARGE_ICON_HEIGHT, this._list.minHeight);
		}

		[Test]
		public function testAutoSizeWithLabelGapPaddingAndSimpleIcon():void
		{
			var labelText:String = "I am the very model of a modern major general";
			this._textRenderer.text = labelText;
			this._textRenderer.validate();

			this.addLargeSimpleIcon();
			this.addPadding();
			this.addGap();
			this._list.dataProvider = new ListCollection(
			[
				{ label: labelText }
			]);
			this._list.validate();

			Assert.assertStrictlyEquals("The width of the PickerList was not calculated correctly based on the label, gap, left and right padding, and icon.",
				this._textRenderer.width + GAP + LARGE_ICON_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._list.width);
			Assert.assertStrictlyEquals("The height of the PickerList was not calculated correctly based on the label, gap, top and bottom padding, and icon.",
				LARGE_ICON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._list.height);
			Assert.assertStrictlyEquals("The minWidth of the PickerList was not calculated correctly based on the label, gap, left and right padding, and icon.",
				this._textRenderer.width + GAP + LARGE_ICON_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._list.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the PickerList was not calculated correctly based on the label, gap, top and bottom padding, and icon.",
				LARGE_ICON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._list.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleIcon():void
		{
			this.addLargeSimpleIcon();
			this._list.validate();

			Assert.assertStrictlyEquals("The width of the PickerList was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this._list.width);
			Assert.assertStrictlyEquals("The height of the PickerList was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this._list.height);
			Assert.assertStrictlyEquals("The minWidth of the PickerList was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this._list.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the PickerList was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this._list.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexIcon():void
		{
			this.addComplexIcon();
			this._list.validate();

			Assert.assertStrictlyEquals("The width of the PickerList was not calculated correctly based on the complex icon width.",
				COMPLEX_ICON_WIDTH, this._list.width);
			Assert.assertStrictlyEquals("The height of the PickerList was not calculated correctly based on the complex icon height.",
				COMPLEX_ICON_HEIGHT, this._list.height);
			Assert.assertStrictlyEquals("The minWidth of the PickerList was not calculated correctly based on the complex icon minWidth.",
				COMPLEX_ICON_MIN_WIDTH, this._list.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the PickerList was not calculated correctly based on the complex icon minHeight.",
				COMPLEX_ICON_MIN_HEIGHT, this._list.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleBackgroundSkin():void
		{
			this.addSmallSimpleBackground();
			this._list.validate();

			Assert.assertStrictlyEquals("The width of the PickerList was not calculated correctly based on the background width.",
				SMALL_BACKGROUND_WIDTH, this._list.width);
			Assert.assertStrictlyEquals("The height of the PickerList was not calculated correctly based on the background height.",
				SMALL_BACKGROUND_HEIGHT, this._list.height);
			Assert.assertStrictlyEquals("The minWidth of the PickerList was not calculated correctly based on the background width.",
				SMALL_BACKGROUND_WIDTH, this._list.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the PickerList was not calculated correctly based on the background height.",
				SMALL_BACKGROUND_HEIGHT, this._list.minHeight);
		}

		[Test]
		public function testAutoSizeWithSmallSimpleBackgroundSkinAndLargeSimpleIcon():void
		{
			this.addSmallSimpleBackground();
			this.addLargeSimpleIcon();
			this._list.validate();

			Assert.assertStrictlyEquals("The width of the PickerList was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this._list.width);
			Assert.assertStrictlyEquals("The height of the PickerList was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this._list.height);
			Assert.assertStrictlyEquals("The minWidth of the PickerList was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this._list.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the PickerList was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this._list.minHeight);
		}

		[Test]
		public function testAutoSizeWithLargeSimpleBackgroundSkinAndSmallSimpleIcon():void
		{
			this.addLargeSimpleBackground();
			this.addSmallSimpleIcon();
			this._list.validate();

			Assert.assertStrictlyEquals("The width of the PickerList was not calculated correctly based on the background width.",
				LARGE_BACKGROUND_WIDTH, this._list.width);
			Assert.assertStrictlyEquals("The height of the PickerList was not calculated correctly based on the background height.",
				LARGE_BACKGROUND_HEIGHT, this._list.height);
			Assert.assertStrictlyEquals("The minWidth of the PickerList was not calculated correctly based on the background width.",
				LARGE_BACKGROUND_WIDTH, this._list.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the PickerList was not calculated correctly based on the background height.",
				LARGE_BACKGROUND_HEIGHT, this._list.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexBackground():void
		{
			this.addComplexBackground();
			this._list.validate();

			Assert.assertStrictlyEquals("The width of the PickerList was not calculated correctly based on the complex background width.",
				COMPLEX_BACKGROUND_WIDTH, this._list.width);
			Assert.assertStrictlyEquals("The height of the PickerList was not calculated correctly based on the complex background height.",
				COMPLEX_BACKGROUND_HEIGHT, this._list.height);
			Assert.assertStrictlyEquals("The minWidth of the PickerList was not calculated correctly based on the complex background minWidth.",
				COMPLEX_BACKGROUND_MIN_WIDTH, this._list.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the PickerList was not calculated correctly based on the complex background minHeight.",
				COMPLEX_BACKGROUND_MIN_HEIGHT, this._list.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexBackgroundAndMinDimensions():void
		{
			this.addComplexBackground();
			this._list.minWidth = MIN_WIDTH;
			this._list.minHeight = MIN_HEIGHT;
			this._list.validate();

			Assert.assertStrictlyEquals("The minWidth of the PickerList was not calculated correctly based on the minWidth.",
				MIN_WIDTH, this._list.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the PickerList was not calculated correctly based on the minHeight.",
				MIN_HEIGHT, this._list.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/PickerListTests.as
================================================
package feathers.tests
{
	import feathers.controls.Button;
	import feathers.controls.List;
	import feathers.controls.PickerList;
	import feathers.controls.popups.DropDownPopUpContentManager;
	import feathers.core.PopUpManager;
	import feathers.data.ListCollection;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class PickerListTests
	{
		private static const BUTTON_NAME:String = "button";
		private static const LIST_NAME:String = "list";

		private var _list:PickerList;

		[Before]
		public function prepare():void
		{
			this._list = new PickerList();
			this._list.dataProvider = new ListCollection(
			[
				{ label: "One" },
				{ label: "Two" },
				{ label: "Three" },
			]);
			var popUpContentManager:DropDownPopUpContentManager = new DropDownPopUpContentManager();
			popUpContentManager.openCloseDuration = 0;
			this._list.popUpContentManager = popUpContentManager;
			this._list.buttonFactory = function():Button
			{
				var button:Button = new Button();
				button.name = BUTTON_NAME;
				button.defaultSkin = new Quad(200, 200);
				return button;
			};
			this._list.listFactory = function():List
			{
				var list:List = new List();
				list.name = LIST_NAME;
				return list;
			};
			TestFeathers.starlingRoot.addChild(this._list);
			this._list.validate();
		}

		[After]
		public function cleanup():void
		{
			this._list.removeFromParent(true);
			this._list = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testProgrammaticOpenAndCloseEvents():void
		{
			var hasOpened:Boolean = false;
			this._list.addEventListener(Event.OPEN, function(event:Event):void
			{
				hasOpened = true;
			});
			var hasClosed:Boolean = false;
			this._list.addEventListener(Event.CLOSE, function(event:Event):void
			{
				hasClosed = true;
			});

			this._list.openList();
			//the picker list may require validation before opening or closing
			this._list.validate();

			Assert.assertTrue("Event.OPEN was not dispatched", hasOpened);
			Assert.assertNotNull("The pop-up list was not added to the PopUpManager",
				PopUpManager.root.getChildByName(LIST_NAME));

			this._list.closeList();
			this._list.validate();

			Assert.assertTrue("Event.CLOSE was not dispatched", hasClosed);
			Assert.assertNull("The list's parent property is not null",
				PopUpManager.root.getChildByName(LIST_NAME));
		}

		[Test]
		public function testCloseOnDispose():void
		{
			var hasClosed:Boolean = false;
			this._list.addEventListener(Event.CLOSE, function(event:Event):void
			{
				hasClosed = true;
			});

			this._list.openList();
			this._list.validate();

			this._list.dispose();

			Assert.assertTrue("Event.CLOSE was not dispatched", hasClosed);
		}

		[Test]
		public function testInteractiveOpenEvent():void
		{
			var hasOpened:Boolean = false;
			this._list.addEventListener(Event.OPEN, function(event:Event):void
			{
				hasOpened = true;
			});
			var hasClosed:Boolean = false;
			this._list.addEventListener(Event.CLOSE, function(event:Event):void
			{
				hasClosed = true;
			});

			var position:Point = new Point(100, 100);
			var target:DisplayObject = this._list.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			//the picker list may require validation before opening or closing
			this._list.validate();

			Assert.assertTrue("Event.OPEN was not dispatched", hasOpened);
			Assert.assertNotNull("The pop-up list was not added to the PopUpManager",
				PopUpManager.root.getChildByName(LIST_NAME));
		}

		[Test]
		public function testSetPopUpListDataProvider():void
		{
			this._list.openList();
			//the picker list may require validation before opening or closing
			this._list.validate();

			var popUpList:List = PopUpManager.root.getChildByName(LIST_NAME) as List;

			Assert.assertStrictlyEquals("The pop-up list data provider was not set",
				this._list.dataProvider, popUpList.dataProvider);
		}

		[Test]
		public function testProgrammaticSelectionChange():void
		{
			var beforeSelectedIndex:int = this._list.selectedIndex;
			var beforeSelectedItem:Object = this._list.selectedItem;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.selectedIndex = 1;
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The selectedIndex property was not changed",
				beforeSelectedIndex === this._list.selectedIndex);
			Assert.assertFalse("The selectedItem property was not changed",
				beforeSelectedItem === this._list.selectedItem);
		}

		[Test]
		public function testRemoveItemBeforeSelectedIndex():void
		{
			this._list.selectedIndex = 1;
			var beforeSelectedIndex:int = this._list.selectedIndex;
			var beforeSelectedItem:Object = this._list.selectedItem;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.removeItemAt(0);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed",
				beforeSelectedIndex - 1, this._list.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was incorrectly changed",
				beforeSelectedItem, this._list.selectedItem);
		}

		[Test]
		public function testRemoveItemAfterSelectedIndex():void
		{
			this._list.selectedIndex = 1;
			var beforeSelectedIndex:int = this._list.selectedIndex;
			var beforeSelectedItem:Object = this._list.selectedItem;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.removeItemAt(2);
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was incorrectly changed",
				beforeSelectedIndex, this._list.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was incorrectly changed",
				beforeSelectedItem, this._list.selectedItem);
		}

		[Test]
		public function testRemoveSelectedIndex():void
		{
			this._list.selectedIndex = 1;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.removeItemAt(1);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed to -1",
				-1, this._list.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not changed to null",
				null, this._list.selectedItem);
		}

		[Test]
		public function testReplaceItemAtSelectedIndex():void
		{
			this._list.selectedIndex = 1;
			var beforeSelectedIndex:int = this._list.selectedIndex;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.setItemAt({ label: "New Item" }, beforeSelectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed to -1",
				-1, this._list.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not changed to null",
				null, this._list.selectedItem);
		}

		[Test]
		public function testDeselectAllOnNullDataProvider():void
		{
			this._list.selectedIndex = 1;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider = null;
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not set to -1",
				-1, this._list.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not set to null",
				null, this._list.selectedItem);
		}

		[Test]
		public function testDeselectAllOnDataProviderRemoveAll():void
		{
			this._list.selectedIndex = 1;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.removeAll();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not set to -1",
				-1, this._list.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not set to null",
				null, this._list.selectedItem);
		}

		[Test]
		public function testAddItemBeforeSelectedIndex():void
		{
			this._list.selectedIndex = 1;
			var hasChanged:Boolean = false;
			var beforeSelectedIndex:int = this._list.selectedIndex;
			var beforeSelectedItem:Object = this._list.selectedItem;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dataProvider.addItemAt({label: "New Item"}, 0);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed",
				beforeSelectedIndex + 1, this._list.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was incorrectly changed",
				beforeSelectedItem, this._list.selectedItem);
		}

		[Test]
		public function testDisposeWithoutChangeEvent():void
		{
			this._list.selectedIndex = 1;
			var hasChanged:Boolean = false;
			this._list.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._list.dispose();
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched", hasChanged);
		}

		[Test]
		public function testUpdateItemAt():void
		{
			var newLabel:String = "New Item";
			this._list.selectedIndex = 1;
			this._list.validate();
			var item:Object = this._list.dataProvider.getItemAt(1);
			item.label = newLabel;
			this._list.dataProvider.updateItemAt(1);
			this._list.validate();
			var button:Button = Button(this._list.getChildByName(BUTTON_NAME)); 
			Assert.assertStrictlyEquals("PickerList updateItemAt() on selectedItem did not update button label", newLabel, button.label);
		}
	}
}


================================================
FILE: test/source/feathers/tests/PopUpManagerFocusManagerTests.as
================================================
package feathers.tests
{
	import feathers.controls.Button;
	import feathers.core.FocusManager;
	import feathers.core.PopUpManager;

	import flexunit.framework.Assert;

	import starling.display.Quad;

	public class PopUpManagerFocusManagerTests
	{
		private var _button1:Button;
		private var _button2:Button;

		[Before]
		public function prepare():void
		{
			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, true);
		}

		[After]
		public function cleanup():void
		{
			if(this._button1)
			{
				this._button1.removeFromParent(true);
				this._button1 = null;
			}
			if(this._button2)
			{
				this._button2.removeFromParent(true);
				this._button2 = null;
			}
			
			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testPopUpHasNonNullFocusManager():void
		{
			this.createButton1();
			PopUpManager.addPopUp(this._button1, true);

			Assert.assertNotNull("Modal pop-up must have focus manager.", this._button1.focusManager);
		}

		[Test]
		public function testPopUpHasDifferentFocusManager():void
		{
			this.createButton1();
			TestFeathers.starlingRoot.addChild(this._button1);

			this.createButton2();
			PopUpManager.addPopUp(this._button2, true);
			
			Assert.assertFalse("Modal pop-up must have different focus manager.", this._button1.focusManager === this._button2.focusManager);
		}

		[Test]
		public function testHasFocusManagerOnChildAddedUnderPopUp():void
		{
			this.createButton1();
			PopUpManager.addPopUp(this._button1, true);
			
			this.createButton2();
			TestFeathers.starlingRoot.addChild(this._button2);
			
			this._button1.removeFromParent(true);
			this._button1 = null;

			Assert.assertNotNull("Component added under modal pop-up must have focus manager after removing pop-up.", this._button2.focusManager);
		}
		
		private function createButton1():void
		{
			this._button1 = new Button();
			this._button1.label = "Click Me";
			this._button1.defaultSkin = new Quad(200, 200);
		}

		private function createButton2():void
		{
			this._button2 = new Button();
			this._button2.label = "Click Me Too";
			this._button2.defaultSkin = new Quad(200, 200);
			this._button2.y = 210;
		}
	}
}


================================================
FILE: test/source/feathers/tests/PopUpManagerTests.as
================================================
package feathers.tests
{
	import feathers.controls.AutoSizeMode;
	import feathers.controls.LayoutGroup;
	import feathers.controls.ScrollContainer;
	import feathers.core.IFeathersControl;
	import feathers.core.PopUpManager;
	import feathers.tests.supportClasses.DisposeFlagQuad;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.display.Sprite;
	import starling.events.Event;

	public class PopUpManagerTests
	{
		private static const OVERLAY_NAME:String = "PopUpManagerOverlay";

		private var _popUp1:Quad;
		private var _popUp2:Quad;
		private var _feathersPopUp:IFeathersControl;
		private var _customRoot:Sprite;

		[After]
		public function cleanup():void
		{
			if(this._customRoot)
			{
				this._customRoot.removeFromParent(true);
				this._customRoot = null;
			}
			if(this._popUp1)
			{
				this._popUp1.removeFromParent(true);
				this._popUp1 = null;
			}
			if(this._popUp2)
			{
				this._popUp2.removeFromParent(true);
				this._popUp2 = null;
			}
			if(this._feathersPopUp)
			{
				this._feathersPopUp.removeFromParent(true);
				this._feathersPopUp = null;
			}

			PopUpManager.root = TestFeathers.starlingRoot.stage;

			PopUpManager.overlayFactory = PopUpManager.defaultOverlayFactory;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function createOverlay():DisplayObject
		{
			var overlay:Quad = new Quad(1, 1, 0xff00ff);
			overlay.alpha = 0.5;
			overlay.name = OVERLAY_NAME;
			return overlay;
		}

		[Test]
		public function testCustomRoot():void
		{
			this._customRoot = new Sprite();
			TestFeathers.starlingRoot.addChild(this._customRoot);
			PopUpManager.root = this._customRoot;
			Assert.assertFalse("PopUpManager.root property incorrectly returns stage", PopUpManager.root === TestFeathers.starlingRoot.stage);

			this._popUp1 = new Quad(200, 200, 0xff00ff);
			PopUpManager.addPopUp(this._popUp1);

			Assert.assertStrictlyEquals("Pop-up added to wrong parent when a custom PopUpManager.root is set", this._customRoot, this._popUp1.parent);
		}

		[Test]
		public function testOverlayFactory():void
		{
			PopUpManager.overlayFactory = this.createOverlay;

			this._popUp1 = new Quad(200, 200, 0xff00ff);
			PopUpManager.addPopUp(this._popUp1, true);

			var overlay:DisplayObject = PopUpManager.root.getChildByName(OVERLAY_NAME);
			Assert.assertNotNull("PopUpManager.overlayFactory failed to create overlay", overlay);
		}

		[Test]
		public function testIsPopUp():void
		{
			PopUpManager.overlayFactory = this.createOverlay;

			this._popUp1 = new Quad(200, 200, 0xff00ff);
			PopUpManager.addPopUp(this._popUp1, true);

			this._popUp2 = new Quad(200, 200, 0x00ff00);
			TestFeathers.starlingRoot.addChild(this._popUp2);

			Assert.assertTrue("PopUpManager.isPopUp() failed to identify a pop-up", PopUpManager.isPopUp(this._popUp1));
			Assert.assertFalse("PopUpManager.isPopUp() incorrectly identified a display object that is not a pop-up", PopUpManager.isPopUp(this._popUp2));
		}

		[Test]
		public function testIsTopLevelPopUpWithModal():void
		{
			this._popUp1 = new Quad(200, 200, 0xff00ff);
			PopUpManager.addPopUp(this._popUp1, true);

			Assert.assertTrue("PopUpManager.isTopLevelPopUp() failed to identify a top-level pop-up",
				PopUpManager.isTopLevelPopUp(this._popUp1));

			this._popUp2 = new Quad(200, 200, 0x00ff00);
			PopUpManager.addPopUp(this._popUp2, true);

			Assert.assertTrue("PopUpManager.isTopLevelPopUp() failed to identify a top-level pop-up",
				PopUpManager.isTopLevelPopUp(this._popUp2));

			Assert.assertFalse("PopUpManager.isTopLevelPopUp() incorrectly identified a top-level pop-up",
				PopUpManager.isTopLevelPopUp(this._popUp1));
		}

		[Test]
		public function testIsTopLevelPopUpWithoutModal():void
		{
			this._popUp1 = new Quad(200, 200, 0xff00ff);
			PopUpManager.addPopUp(this._popUp1, false);

			Assert.assertTrue("PopUpManager.isTopLevelPopUp() failed to identify a top-level pop-up",
				PopUpManager.isTopLevelPopUp(this._popUp1));
		}

		[Test]
		public function testIsTopLevelPopUpWithoutModalAfterModal():void
		{
			this._popUp1 = new Quad(200, 200, 0xff00ff);
			PopUpManager.addPopUp(this._popUp1, true);

			this._popUp2 = new Quad(200, 200, 0x00ff00);
			PopUpManager.addPopUp(this._popUp2, false);

			Assert.assertTrue("PopUpManager.isTopLevelPopUp() failed to identify a top-level pop-up",
				PopUpManager.isTopLevelPopUp(this._popUp1));

			Assert.assertTrue("PopUpManager.isTopLevelPopUp() failed to identify a top-level pop-up",
				PopUpManager.isTopLevelPopUp(this._popUp2));
		}

		[Test]
		public function testPopUpCount():void
		{
			Assert.assertStrictlyEquals("PopUpManager.popUpCount returned wrong value with no pop-ups",
				0, PopUpManager.popUpCount);

			this._popUp1 = new Quad(200, 200, 0xff00ff);
			PopUpManager.addPopUp(this._popUp1, true);

			Assert.assertStrictlyEquals("PopUpManager.popUpCount returned wrong value after adding first pop-up",
				1, PopUpManager.popUpCount);

			this._popUp2 = new Quad(200, 200, 0x00ff00);
			TestFeathers.starlingRoot.addChild(this._popUp2);

			Assert.assertStrictlyEquals("PopUpManager.popUpCount incorrectly identified a display object that is not a pop-up and returned wrong value",
				1, PopUpManager.popUpCount);

			this._feathersPopUp = new LayoutGroup();
			PopUpManager.addPopUp(DisplayObject(this._feathersPopUp));

			Assert.assertStrictlyEquals("PopUpManager.popUpCount returned wrong value after adding second pop-up",
				2, PopUpManager.popUpCount);

			PopUpManager.removePopUp(this._popUp1);

			Assert.assertStrictlyEquals("PopUpManager.popUpCount returned wrong value after removing pop-up",
				1, PopUpManager.popUpCount);
		}

		[Test]
		public function testRemoveAllPopUps():void
		{
			this._popUp1 = new DisposeFlagQuad();
			PopUpManager.addPopUp(this._popUp1, true);

			this._popUp2 = new DisposeFlagQuad();
			PopUpManager.addPopUp(this._popUp2, true);

			PopUpManager.removeAllPopUps(true);

			Assert.assertStrictlyEquals("PopUpManager.popUpCount incorrect after removeAllPopUps()",
				0, PopUpManager.popUpCount);

			Assert.assertTrue("Pop up not disposed after removeAllPopUps(true)",
				DisposeFlagQuad(this._popUp1).isDisposed);
			Assert.assertNull("Pop up parent not null after removeAllPopUps()",
				this._popUp1.parent);

			Assert.assertTrue("Pop up not disposed after removeAllPopUps(true)",
				DisposeFlagQuad(this._popUp2).isDisposed);
			Assert.assertNull("Pop up parent not null after removeAllPopUps()",
				this._popUp2.parent);
		}

		[Test]
		public function testRemovePopUpWithoutDispose():void
		{
			this._popUp1 = new DisposeFlagQuad();
			PopUpManager.addPopUp(this._popUp1, true);

			PopUpManager.removePopUp(this._popUp1, false);

			Assert.assertFalse("Pop up not disposed after removePopUp(false)",
				DisposeFlagQuad(this._popUp1).isDisposed);
			Assert.assertNull("Pop up parent not null after removePopUp(false)",
				this._popUp1.parent);
		}

		[Test]
		public function testRemovePopUpWithDispose():void
		{
			this._popUp1 = new DisposeFlagQuad();
			PopUpManager.addPopUp(this._popUp1, true);

			PopUpManager.removePopUp(this._popUp1, true);

			Assert.assertTrue("Pop up not disposed after removePopUp(true)",
				DisposeFlagQuad(this._popUp1).isDisposed);
			Assert.assertNull("Pop up parent not null after removePopUp(true)",
				this._popUp1.parent);
		}

		[Test]
		public function testCenterPopUp():void
		{
			var popUpWidth:Number = 200;
			var popUpHeight:Number = 150;
			this._popUp1 = new Quad(popUpWidth, popUpHeight, 0xff00ff);
			PopUpManager.addPopUp(this._popUp1, true, true);

			Assert.assertStrictlyEquals("PopUpManager failed to center pop-up horizontally",
				(TestFeathers.starlingRoot.stage.stageWidth - popUpWidth) / 2, this._popUp1.x);
			Assert.assertStrictlyEquals("PopUpManager failed to center pop-up vertically",
				(TestFeathers.starlingRoot.stage.stageHeight - popUpHeight) / 2, this._popUp1.y);
		}

		[Test]
		public function testCenterPopUpWithPivots():void
		{
			var popUpWidth:Number = 200;
			var popUpHeight:Number = 150;
			this._popUp1 = new Quad(popUpWidth, popUpHeight, 0xff00ff);
			this._popUp1.pivotX = popUpWidth / 2;
			this._popUp1.pivotY = popUpHeight / 2;
			PopUpManager.addPopUp(this._popUp1, true, true);

			Assert.assertStrictlyEquals("PopUpManager failed to center pop-up with pivot horizontally",
				TestFeathers.starlingRoot.stage.stageWidth / 2, this._popUp1.x);
			Assert.assertStrictlyEquals("PopUpManager failed to center pop-up with pivot vertically",
				TestFeathers.starlingRoot.stage.stageHeight / 2, this._popUp1.y);
		}

		[Test]
		public function testLayoutGroupAutoSizeModeStage():void
		{
			var group:LayoutGroup = new LayoutGroup();
			this._feathersPopUp = group;
			PopUpManager.addPopUp(group);
			Assert.assertStrictlyEquals("LayoutGroup added to PopUpManager should default to autoSizeMode === AutoSizeMode.CONTENT", AutoSizeMode.CONTENT, group.autoSizeMode);
		}

		[Test]
		public function testScrollContainerAutoSizeModeStage():void
		{
			var container:ScrollContainer = new ScrollContainer();
			this._feathersPopUp = container;
			PopUpManager.addPopUp(container);
			Assert.assertStrictlyEquals("ScrollContainer added to PopUpManager should default to autoSizeMode === AutoSizeMode.CONTENT", AutoSizeMode.CONTENT, container.autoSizeMode);
		}

		//Github issue #1685
		[Test]
		public function testRemovePopUpFromRemovedEventForOtherPopUp():void
		{
			this._popUp1 = new DisposeFlagQuad();
			PopUpManager.addPopUp(this._popUp1);
			this._popUp2 = new DisposeFlagQuad();
			PopUpManager.addPopUp(this._popUp2);
			this._popUp1.addEventListener(Event.REMOVED, function():void
			{
				_popUp2.removeFromParent(true);
			});
			PopUpManager.removeAllPopUps();
			Assert.assertStrictlyEquals("PopUpManager: Failed to remove all pop ups.",
				0, PopUpManager.popUpCount);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ProgressBarMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.LayoutGroup;
	import feathers.controls.ProgressBar;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class ProgressBarMeasurementTests
	{
		private static const BACKGROUND_WIDTH:Number = 200;
		private static const BACKGROUND_HEIGHT:Number = 20;
		private static const FILL_WIDTH:Number = 18;
		private static const FILL_HEIGHT:Number = 14;
		private static const BACKGROUND_WIDTH2:Number = 125;
		private static const BACKGROUND_HEIGHT2:Number = 20;
		private static const BACKGROUND_WIDTH3:Number = 150;
		private static const BACKGROUND_HEIGHT3:Number = 30;

		private static const PADDING_TOP:Number = 4;
		private static const PADDING_RIGHT:Number = 100;
		private static const PADDING_BOTTOM:Number = 3;
		private static const PADDING_LEFT:Number = 90;
		
		private var _progress:ProgressBar;

		[Before]
		public function prepare():void
		{
			this._progress = new ProgressBar();
			this._progress.minimum = 0;
			this._progress.maximum = 10;
			this._progress.value = 5;
			TestFeathers.starlingRoot.addChild(this._progress);
		}

		[After]
		public function cleanup():void
		{
			this._progress.removeFromParent(true);
			this._progress = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}
		
		protected function addSimpleBackgroundSkin():void
		{
			this._progress.backgroundSkin = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT);
		}

		protected function addSimpleFillSkin():void
		{
			this._progress.fillSkin = new Quad(FILL_WIDTH, FILL_HEIGHT);
		}

		[Test]
		public function testAutoSize():void
		{
			this.addSimpleBackgroundSkin();
			this.addSimpleFillSkin();
			this._progress.validate();
			
			Assert.assertStrictlyEquals("The width of the progress bar was not calculated correctly based on the original background width.",
			BACKGROUND_WIDTH, this._progress.width);
			Assert.assertStrictlyEquals("The height of the progress bar was not calculated correctly based on the original background height.",
			BACKGROUND_HEIGHT, this._progress.height);
			Assert.assertStrictlyEquals("The minWidth of the progress bar was not calculated correctly based on the original background width.",
			BACKGROUND_WIDTH, this._progress.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the progress bar was not calculated correctly based on the original background height.",
			BACKGROUND_HEIGHT, this._progress.minHeight);
		}

		[Test]
		public function testAutoSizeWhereFillAndPaddingIsLargerThanBackground():void
		{
			this.addSimpleBackgroundSkin();
			this.addSimpleFillSkin();
			this._progress.paddingTop = PADDING_TOP;
			this._progress.paddingRight = PADDING_RIGHT;
			this._progress.paddingBottom = PADDING_BOTTOM;
			this._progress.paddingLeft = PADDING_LEFT;
			this._progress.validate();

			Assert.assertStrictlyEquals("The width of the progress bar was not calculated correctly based on the original fill width plus padding left and right.",
			FILL_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._progress.width);
			Assert.assertStrictlyEquals("The height of the progress bar was not calculated correctly based on the original fill height plus padding top and bottom.",
			FILL_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._progress.height);
			Assert.assertStrictlyEquals("The minWidth of the progress bar was not calculated correctly based on the original fill width plus padding left and right.",
			FILL_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._progress.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the progress bar was not calculated correctly based on the original fill height plus padding top and bottom.",
			FILL_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._progress.minHeight);
		}

		[Test]
		public function testAutoSizeWithFeathersControlWithMinDimensions():void
		{
			var backgroundSkin:LayoutGroup = new LayoutGroup();
			backgroundSkin.minWidth = BACKGROUND_WIDTH2;
			backgroundSkin.minHeight = BACKGROUND_HEIGHT2;
			backgroundSkin.width = BACKGROUND_WIDTH3;
			backgroundSkin.height = BACKGROUND_HEIGHT3;
			this._progress.backgroundSkin = backgroundSkin;
			this.addSimpleFillSkin();
			this._progress.validate();

			Assert.assertStrictlyEquals("The width of the progress bar was not calculated correctly based on an IFeathersControl background skin width.",
			BACKGROUND_WIDTH3, this._progress.width);
			Assert.assertStrictlyEquals("The height of the progress bar was not calculated correctly based on an IFeathersControl background skin height.",
			BACKGROUND_HEIGHT3, this._progress.height);
			Assert.assertStrictlyEquals("The minWidth of the progress bar was not calculated correctly based on an IFeathersControl background skin minWidth.",
			BACKGROUND_WIDTH2, this._progress.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the progress bar was not calculated correctly based on an IFeathersControl background skin minHeight.",
			BACKGROUND_HEIGHT2, this._progress.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ProgressBarTests.as
================================================
package feathers.tests
{
	import feathers.controls.ProgressBar;
	import feathers.tests.supportClasses.DisposeFlagQuad;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class ProgressBarTests
	{
		private static const BACKGROUND_WIDTH:Number = 200;
		private static const BACKGROUND_HEIGHT:Number = 20;
		private static const FILL_WIDTH:Number = 18;
		private static const FILL_HEIGHT:Number = 14;
		
		private var _progress:ProgressBar;

		[Before]
		public function prepare():void
		{
			this._progress = new ProgressBar();
			this._progress.minimum = 0;
			this._progress.maximum = 10;
			this._progress.value = 5;
			this._progress.backgroundSkin = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT);
			this._progress.fillSkin = new Quad(FILL_WIDTH, FILL_HEIGHT);
			TestFeathers.starlingRoot.addChild(this._progress);
			this._progress.validate();
		}

		[After]
		public function cleanup():void
		{
			this._progress.removeFromParent(true);
			this._progress = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testSetValueProgramaticallyWithMinimum():void
		{
			this._progress.minimum = 5;
			this._progress.maximum = 10;
			this._progress.value = 2;
			Assert.assertEquals("Setting value smaller than minimum not changed to minimum.", this._progress.minimum, this._progress.value);
		}

		[Test]
		public function testSetValueProgramaticallyWithMaximum():void
		{
			this._progress.minimum = 5;
			this._progress.maximum = 10;
			this._progress.value = 12;
			Assert.assertEquals("Setting value larger than maximum not changed to maximum.", this._progress.maximum, this._progress.value);
		}

		[Test]
		public function testSkinsDisposed():void
		{
			var backgroundSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._progress.backgroundSkin = backgroundSkin;
			var backgroundDisabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._progress.backgroundDisabledSkin = backgroundDisabledSkin;
			var fillSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._progress.fillSkin = fillSkin;
			var fillDisabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._progress.fillDisabledSkin = fillDisabledSkin;
			this._progress.validate();
			this._progress.dispose();
			Assert.assertTrue("backgroundSkin not disposed when ProgressBar disposed.", backgroundSkin.isDisposed);
			Assert.assertTrue("backgroundDisabledSkin not disposed when ProgressBar disposed.", backgroundDisabledSkin.isDisposed);
			Assert.assertTrue("fillSkin not disposed when ProgressBar disposed.", backgroundSkin.isDisposed);
			Assert.assertTrue("fillDisabledSkin not disposed when ProgressBar disposed.", backgroundDisabledSkin.isDisposed);
		}
	}
}


================================================
FILE: test/source/feathers/tests/RadioTests.as
================================================
package feathers.tests
{
	import feathers.controls.Radio;
	import feathers.core.ToggleGroup;

	import flexunit.framework.Assert;

	import starling.display.Quad;

	public class RadioTests
	{
		private var _radio:Radio;

		[Before]
		public function prepare():void
		{
			this._radio = new Radio();
			this._radio.isSelected = true;
			this._radio.label = "Click Me";
			this._radio.defaultSkin = new Quad(200, 200);
			TestFeathers.starlingRoot.addChild(this._radio);
			this._radio.validate();
		}

		[After]
		public function cleanup():void
		{
			this._radio.removeFromParent(true);
			this._radio = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testDefaultToggleGroup():void
		{
			Assert.assertStrictlyEquals("toggleGroup property must be equal to Radio.defaultRadioGroup if not added to another group.", Radio.defaultRadioGroup, this._radio.toggleGroup);
		}

		[Test]
		public function testToggleGroupPropertyAfterAddingExternally():void
		{
			var group:ToggleGroup = new ToggleGroup();
			group.addItem(this._radio);
			Assert.assertStrictlyEquals("toggleGroup property must be equal to ToggleGroup after adding to that group.", group, this._radio.toggleGroup);
		}

		[Test]
		public function testToggleGroupPropertyAfterRemovingExternally():void
		{
			var group:ToggleGroup = new ToggleGroup();
			group.addItem(this._radio);
			group.removeItem(this._radio);
			Assert.assertStrictlyEquals("toggleGroup property must be equal to Radio.defaultRadioGroup after removing a ToggleButton from another ToggleGroup.", Radio.defaultRadioGroup, this._radio.toggleGroup);
		}
	}
}


================================================
FILE: test/source/feathers/tests/RestrictedStyleTests.as
================================================
package feathers.tests
{
	import feathers.skins.FunctionStyleProvider;

	import org.flexunit.Assert;

	public class RestrictedStyleTests
	{
		private static const STYLE_PROVIDER_VALUE:Number = 2;
		private static const STYLE_PROVIDER_VALUE2:Number = 5;
		private static const CUSTOM_VALUE:Number = 3;
		private static const CUSTOM_VALUE2:Number = 4;

		private var _control:CustomControl;

		[Before]
		public function prepare():void
		{
			this._control = new CustomControl();
		}

		[After]
		public function cleanup():void
		{
			this._control.dispose();
			this._control = null;
		}

		private function setControlStyles(control:CustomControl):void
		{
			this._control.style = STYLE_PROVIDER_VALUE;
		}

		private function setControlStyles2(control:CustomControl):void
		{
			this._control.style = STYLE_PROVIDER_VALUE2;
		}

		[Test]
		public function testStyleProviderStyle():void
		{
			this._control.styleProvider = new FunctionStyleProvider(setControlStyles);
			this._control.validate();
			Assert.assertStrictlyEquals("Unrestricted style incorrectly rejects value from style provider.",
				STYLE_PROVIDER_VALUE, this._control.style);
		}

		[Test]
		public function testRestrictedStyle():void
		{
			this._control.styleProvider = new FunctionStyleProvider(setControlStyles);
			this._control.style = CUSTOM_VALUE;
			this._control.validate();
			Assert.assertStrictlyEquals("Custom value outside of style provider must restrict style.",
				CUSTOM_VALUE, this._control.style);
		}

		[Test]
		public function testReplaceStyleProvider():void
		{
			this._control.styleProvider = new FunctionStyleProvider(setControlStyles);
			this._control.validate();
			this._control.styleProvider = new FunctionStyleProvider(setControlStyles2);
			this._control.validate();
			Assert.assertStrictlyEquals("Unrestricted style incorrectly rejects value from new style provider.",
				STYLE_PROVIDER_VALUE2, this._control.style);
		}

		[Test]
		public function testReplaceRestrictedStyle():void
		{
			this._control.styleProvider = new FunctionStyleProvider(setControlStyles);
			this._control.style = CUSTOM_VALUE;
			this._control.validate();
			this._control.style = CUSTOM_VALUE2;
			this._control.validate();
			Assert.assertStrictlyEquals("Restricted style incorrectly rejects replacement value from outside style provider.",
				CUSTOM_VALUE2, this._control.style);
		}
	}
}

import feathers.core.FeathersControl;

class CustomControl extends FeathersControl
{
	public function CustomControl()
	{
		super();
	}

	private var _style:Number = -1;

	public function get style():Number
	{
		return this._style;
	}

	public function set style(value:Number):void
	{
		if(this.processStyleRestriction(arguments.callee))
		{
			return;
		}
		this._style = value;
	}
}

================================================
FILE: test/source/feathers/tests/ScaleTests.as
================================================
package feathers.tests
{
	import feathers.controls.LayoutGroup;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class ScaleTests
	{
		private static const BASE_WIDTH:Number = 100;
		private static const BASE_HEIGHT:Number = 140;

		private static const LARGER_WIDTH:Number = 280;
		private static const LARGER_HEIGHT:Number = 300;
		private static const LARGER_MIN_WIDTH:Number = 270;
		private static const LARGER_MIN_HEIGHT:Number = 290;
		
		private static const LARGER_SCALEX:Number = 2;
		private static const SMALLER_SCALEY:Number = 0.25;
		private static const SMALLER_SCALE:Number = 0.5;
		
		private var _control:LayoutGroup;

		[Before]
		public function prepare():void
		{
			this._control = new LayoutGroup();
			this._control.backgroundSkin = new Quad(BASE_WIDTH, BASE_HEIGHT, 0xff00ff);
			TestFeathers.starlingRoot.addChild(this._control);
		}

		[After]
		public function cleanup():void
		{
			this._control.removeFromParent(true);
			this._control = null;
			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testInitialDimensions():void
		{
			this._control.validate();
			Assert.assertStrictlyEquals("Component initial width incorrect.", BASE_WIDTH, this._control.width);
			Assert.assertStrictlyEquals("Component initial height incorrect.", BASE_HEIGHT, this._control.height);
			Assert.assertStrictlyEquals("Component initial minWidth incorrect.", BASE_WIDTH, this._control.minWidth);
			Assert.assertStrictlyEquals("Component initial minHeight incorrect.", BASE_HEIGHT, this._control.minHeight);
		}

		[Test]
		public function testSetScaleXAndScaleY():void
		{
			this._control.scaleX = LARGER_SCALEX;
			this._control.scaleY = SMALLER_SCALEY;
			this._control.validate();
			Assert.assertStrictlyEquals("Component calculated width incorrect after setting scaleX.", BASE_WIDTH * LARGER_SCALEX, this._control.width);
			Assert.assertStrictlyEquals("Component calculated height incorrect after setting scaleY.", BASE_HEIGHT * SMALLER_SCALEY, this._control.height);
			Assert.assertStrictlyEquals("Component calculated minWidth incorrect after setting scaleX.", BASE_WIDTH * LARGER_SCALEX, this._control.minWidth);
			Assert.assertStrictlyEquals("Component calculated minHeight incorrect after setting scaleY.", BASE_HEIGHT * SMALLER_SCALEY, this._control.minHeight);
		}

		[Test]
		public function testSetScale():void
		{
			this._control.scale = SMALLER_SCALE;
			this._control.validate();
			Assert.assertStrictlyEquals("Component calculated width incorrect after setting scale.", BASE_WIDTH * SMALLER_SCALE, this._control.width);
			Assert.assertStrictlyEquals("Component calculated height incorrect after setting scale.", BASE_HEIGHT * SMALLER_SCALE, this._control.height);
			Assert.assertStrictlyEquals("Component calculated minWidth incorrect after setting scale.", BASE_WIDTH * SMALLER_SCALE, this._control.minWidth);
			Assert.assertStrictlyEquals("Component calculated minHeight incorrect after setting scale.", BASE_HEIGHT * SMALLER_SCALE, this._control.minHeight);
		}

		[Test]
		public function testSetScaleXAndScaleYThenWidthAndHeight():void
		{
			this._control.scaleX = LARGER_SCALEX;
			this._control.scaleY = SMALLER_SCALEY;
			this._control.width = LARGER_WIDTH;
			this._control.height = LARGER_HEIGHT;
			this._control.minWidth = LARGER_MIN_WIDTH;
			this._control.minHeight = LARGER_MIN_HEIGHT;
			this._control.validate();
			Assert.assertStrictlyEquals("Component width incorrect after setting scaleX then width.", LARGER_WIDTH, this._control.width);
			Assert.assertStrictlyEquals("Component height incorrect after setting scaleY then height.", LARGER_HEIGHT, this._control.height);
			Assert.assertStrictlyEquals("Component minWidth incorrect after setting scaleX then minWidth.", LARGER_MIN_WIDTH, this._control.minWidth);
			Assert.assertStrictlyEquals("Component minHeight incorrect after setting scaleY then minHeight.", LARGER_MIN_HEIGHT, this._control.minHeight);
		}

		[Test]
		public function testSetWidthAndHeightThenScaleXAndScaleY():void
		{
			this._control.width = LARGER_WIDTH;
			this._control.height = LARGER_HEIGHT;
			this._control.minWidth = LARGER_MIN_WIDTH;
			this._control.minHeight = LARGER_MIN_HEIGHT;
			this._control.scaleX = LARGER_SCALEX;
			this._control.scaleY = SMALLER_SCALEY;
			this._control.validate();
			Assert.assertStrictlyEquals("Component width incorrect after setting width then scaleX.", LARGER_WIDTH * LARGER_SCALEX, this._control.width);
			Assert.assertStrictlyEquals("Component height incorrect after setting height then scaleY.", LARGER_HEIGHT * SMALLER_SCALEY, this._control.height);
			Assert.assertStrictlyEquals("Component minWidth incorrect after setting minWidth then scaleX.", LARGER_MIN_WIDTH * LARGER_SCALEX, this._control.minWidth);
			Assert.assertStrictlyEquals("Component minHeight incorrect after setting minHeight then scaleY.", LARGER_MIN_HEIGHT * SMALLER_SCALEY, this._control.minHeight);
		}

		[Test]
		public function testSetWidthAndHeightThenScaleXAndScaleYThenWidthAndHeightBackToOriginal():void
		{
			this._control.width = LARGER_WIDTH;
			this._control.height = LARGER_HEIGHT;
			this._control.minWidth = LARGER_MIN_WIDTH;
			this._control.minHeight = LARGER_MIN_HEIGHT;
			this._control.scaleX = LARGER_SCALEX;
			this._control.scaleY = SMALLER_SCALEY;
			this._control.width = LARGER_WIDTH;
			this._control.height = LARGER_HEIGHT;
			this._control.minWidth = LARGER_MIN_WIDTH;
			this._control.minHeight = LARGER_MIN_HEIGHT;
			this._control.validate();
			Assert.assertStrictlyEquals("Component width incorrect after setting width then scaleX then width back to original.", LARGER_WIDTH, this._control.width);
			Assert.assertStrictlyEquals("Component height incorrect after setting height then scaleY then height back to original.", LARGER_HEIGHT, this._control.height);
			Assert.assertStrictlyEquals("Component minWidth incorrect after setting minWidth then scaleX then minWidth back to original.", LARGER_MIN_WIDTH, this._control.minWidth);
			Assert.assertStrictlyEquals("Component minHeight incorrect after setting minHeight then scaleY then minHeight back to original.", LARGER_MIN_HEIGHT, this._control.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ScreenNavigatorMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.AutoSizeMode;
	import feathers.controls.LayoutGroup;
	import feathers.controls.ScreenNavigator;
	import feathers.controls.ScreenNavigatorItem;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class ScreenNavigatorMeasurementTests
	{
		private static const SCREEN_ID_ONE:String = "one";
		private static const SCREEN_ONE_WIDTH:Number = 100;
		private static const SCREEN_ONE_HEIGHT:Number = 150;

		private static const SCREEN_ID_TWO:String = "two";
		private static const SCREEN_TWO_WIDTH:Number = 200;
		private static const SCREEN_TWO_HEIGHT:Number = 180;
		private static const SCREEN_TWO_MIN_WIDTH:Number = 110;
		private static const SCREEN_TWO_MIN_HEIGHT:Number = 120;

		private var _navigator:ScreenNavigator;
		private var _navigator2:ScreenNavigator;
		private var _screenOne:Quad;
		private var _screenTwo:LayoutGroup;

		[Before]
		public function prepare():void
		{
			this._screenOne = new Quad(SCREEN_ONE_WIDTH, SCREEN_ONE_HEIGHT, 0xff0000);

			var screenTwoBackground:Quad = new Quad(SCREEN_TWO_WIDTH, SCREEN_TWO_HEIGHT, 0x0000ff);
			this._screenTwo = new LayoutGroup();
			this._screenTwo.minWidth = SCREEN_TWO_MIN_WIDTH;
			this._screenTwo.minHeight = SCREEN_TWO_MIN_HEIGHT;
			this._screenTwo.backgroundSkin = screenTwoBackground;

			this._navigator = new ScreenNavigator();
			this._navigator.addScreen(SCREEN_ID_ONE, new ScreenNavigatorItem(this._screenOne));
			this._navigator.addScreen(SCREEN_ID_TWO, new ScreenNavigatorItem(this._screenTwo));
			TestFeathers.starlingRoot.addChild(this._navigator);
		}

		[After]
		public function cleanup():void
		{
			this._navigator.removeFromParent(true);
			this._navigator = null;

			if(this._navigator2)
			{
				this._navigator2.removeFromParent(true);
				this._navigator2 = null;
			}

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testAutoSizeModeStage():void
		{
			this._navigator.autoSizeMode = AutoSizeMode.STAGE;
			this._navigator.validate();
			Assert.assertStrictlyEquals("The width of the ScreenNavigator was not calculated correctly when empty with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._navigator.width);
			Assert.assertStrictlyEquals("The height of the ScreenNavigator was not calculated correctly when empty with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._navigator.height);
			Assert.assertStrictlyEquals("The minWidth of the ScreenNavigator was not calculated correctly when empty with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._navigator.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the ScreenNavigator was not calculated correctly when empty with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._navigator.minHeight);
		}

		[Test]
		public function testAutoSizeModeStageWithoutParent():void
		{
			this._navigator2 = new ScreenNavigator();
			this._navigator2.autoSizeMode = AutoSizeMode.STAGE;
			this._navigator2.validate();
			Assert.assertStrictlyEquals("The width of the ScreenNavigator was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._navigator2.width);
			Assert.assertStrictlyEquals("The height of the ScreenNavigator was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._navigator2.height);
			Assert.assertStrictlyEquals("The minWidth of the ScreenNavigator was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._navigator2.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the ScreenNavigator was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._navigator2.minHeight);
		}

		[Test]
		public function testAutoSizeModeStageWithValidateBeforeAdd():void
		{
			this._navigator2 = new ScreenNavigator();
			this._navigator2.autoSizeMode = AutoSizeMode.STAGE;
			this._navigator2.validate();
			TestFeathers.starlingRoot.addChild(this._navigator2);
			this._navigator2.validate();
			Assert.assertStrictlyEquals("The width of the ScreenNavigator was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._navigator2.width);
			Assert.assertStrictlyEquals("The height of the ScreenNavigator was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._navigator2.height);
			Assert.assertStrictlyEquals("The minWidth of the ScreenNavigator was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._navigator2.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the ScreenNavigator was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._navigator2.minHeight);
		}

		[Test]
		public function testAutoSizeModeContentWithNoActiveScreen():void
		{
			this._navigator.autoSizeMode = AutoSizeMode.CONTENT;
			this._navigator.validate();
			Assert.assertStrictlyEquals("The width of the ScreenNavigator was not calculated correctly when empty with AutoSizeMode.CONTENT.",
				0, this._navigator.width);
			Assert.assertStrictlyEquals("The height of the ScreenNavigator was not calculated correctly when empty with AutoSizeMode.CONTENT.",
				0, this._navigator.height);
			Assert.assertStrictlyEquals("The minWidth of the ScreenNavigator was not calculated correctly when empty with AutoSizeMode.CONTENT.",
				0, this._navigator.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the ScreenNavigator was not calculated correctly when empty with AutoSizeMode.CONTENT.",
				0, this._navigator.minHeight);
		}

		[Test]
		public function testAutoSizeModeStageWithSimpleScreen():void
		{
			this._navigator.autoSizeMode = AutoSizeMode.STAGE;
			this._navigator.showScreen(SCREEN_ID_ONE);
			this._navigator.validate();
			Assert.assertStrictlyEquals("The width of the ScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._navigator.width);
			Assert.assertStrictlyEquals("The height of the ScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._navigator.height);
			Assert.assertStrictlyEquals("The minWidth of the ScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._navigator.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the ScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._navigator.minHeight);
		}

		[Test]
		public function testAutoSizeModeContentWithSimpleScreen():void
		{
			this._navigator.autoSizeMode = AutoSizeMode.CONTENT;
			this._navigator.showScreen(SCREEN_ID_ONE);
			this._navigator.validate();
			Assert.assertStrictlyEquals("The width of the ScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.CONTENT.",
				SCREEN_ONE_WIDTH, this._navigator.width);
			Assert.assertStrictlyEquals("The height of the ScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.CONTENT.",
				SCREEN_ONE_HEIGHT, this._navigator.height);
			Assert.assertStrictlyEquals("The minWidth of the ScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.CONTENT.",
				SCREEN_ONE_WIDTH, this._navigator.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the ScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.CONTENT.",
				SCREEN_ONE_HEIGHT, this._navigator.minHeight);
		}

		[Test]
		public function testAutoSizeModeContentWithComplexScreen():void
		{
			this._navigator.autoSizeMode = AutoSizeMode.CONTENT;
			this._navigator.showScreen(SCREEN_ID_TWO);
			this._navigator.validate();
			Assert.assertStrictlyEquals("The width of the ScreenNavigator was not calculated correctly with complex screen and AutoSizeMode.CONTENT.",
				SCREEN_TWO_WIDTH, this._navigator.width);
			Assert.assertStrictlyEquals("The height of the ScreenNavigator was not calculated correctly with complex screen and AutoSizeMode.CONTENT.",
				SCREEN_TWO_HEIGHT, this._navigator.height);
			Assert.assertStrictlyEquals("The minWidth of the ScreenNavigator was not calculated correctly with complex screen and AutoSizeMode.CONTENT.",
				SCREEN_TWO_MIN_WIDTH, this._navigator.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the ScreenNavigator was not calculated correctly with complex screen and AutoSizeMode.CONTENT.",
				SCREEN_TWO_MIN_HEIGHT, this._navigator.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ScreenNavigatorTests.as
================================================
package feathers.tests
{
	import feathers.controls.ScreenNavigator;
	import feathers.controls.ScreenNavigatorItem;
	import feathers.events.FeathersEventType;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class ScreenNavigatorTests
	{
		private static const SCREEN_A_ID:String = "a";
		private static const SCREEN_B_ID:String = "b";
		
		private static const EVENT_SHOW_SCREEN_B:String = "showScreenB";
		private static const EVENT_CALL_FUNCTION:String = "callFunction";
		
		private var _navigator:ScreenNavigator;
		
		private var _functionWasCalled:Boolean = false;

		[Before]
		public function prepare():void
		{
			this._navigator = new ScreenNavigator();
			TestFeathers.starlingRoot.addChild(this._navigator);
			this._navigator.validate();
			
			this._functionWasCalled = false;
		}

		[After]
		public function cleanup():void
		{
			this._navigator.removeFromParent(true);
			this._navigator = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testHasScreenWhenNotAdded():void
		{
			Assert.assertFalse("hasScreen() incorrectly returned true for a screen that was not added", this._navigator.hasScreen(SCREEN_A_ID));
		}

		[Test]
		public function testHasScreen():void
		{
			this.addScreenA();
			Assert.assertTrue("hasScreen() incorrectly returned false for a screen that was added", this._navigator.hasScreen(SCREEN_A_ID));
		}

		[Test]
		public function testStateWithEmptyStack():void
		{
			Assert.assertNull("activeScreen returned incorrect value for empty ScreenNavigator", this._navigator.activeScreen);
			Assert.assertNull("activeScreenID returned incorrect value for empty ScreenNavigator", this._navigator.activeScreenID);
		}

		[Test]
		public function testShowScreen():void
		{
			this.addScreenA();
			this.addScreenB();
			this._navigator.showScreen(SCREEN_A_ID);
			Assert.assertStrictlyEquals("activeScreen returned incorrect value after showScreen()", this._navigator.getScreen(SCREEN_A_ID).screen, this._navigator.activeScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value for after showScreen()", SCREEN_A_ID, this._navigator.activeScreenID);
		}

		[Test]
		public function testShowAnotherScreen():void
		{
			this.addScreenA();
			this.addScreenB();
			this._navigator.showScreen(SCREEN_A_ID);
			this._navigator.showScreen(SCREEN_B_ID);
			Assert.assertStrictlyEquals("activeScreen returned incorrect value after two calls to showScreen()", this._navigator.getScreen(SCREEN_B_ID).screen, this._navigator.activeScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value after two calls to showScreen()", SCREEN_B_ID, this._navigator.activeScreenID);
		}

		[Test]
		public function testClearScreen():void
		{
			this.addScreenA();
			this._navigator.showScreen(SCREEN_A_ID);
			this._navigator.clearScreen();
			Assert.assertNull("activeScreen returned incorrect value for stack after clearScreen()", this._navigator.activeScreen);
			Assert.assertNull("activeScreenID returned incorrect value for stack after clearScreen()", this._navigator.activeScreenID);
		}

		[Test]
		public function testShowScreenWithEvent():void
		{
			this.addScreenA();
			this.addScreenB();
			this._navigator.showScreen(SCREEN_A_ID);
			this._navigator.activeScreen.dispatchEventWith(EVENT_SHOW_SCREEN_B);
			Assert.assertStrictlyEquals("activeScreen returned incorrect value after show screen with event", this._navigator.getScreen(SCREEN_B_ID).screen, this._navigator.activeScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value after show screen with event", SCREEN_B_ID, this._navigator.activeScreenID);
		}

		[Test]
		public function testCallFunctionWithEvent():void
		{
			this.addScreenA();
			this.addScreenB();
			this._navigator.showScreen(SCREEN_A_ID);
			this._navigator.activeScreen.dispatchEventWith(EVENT_CALL_FUNCTION);
			Assert.assertTrue("Function passed to setFunctionForEvent() was not called after dispatching the event.", this._functionWasCalled);
		}

		[Test]
		public function testRemoveScreenOnTransitionCompleteEvent():void
		{
			this.addScreenA();
			this.addScreenB();
			this._navigator.showScreen(SCREEN_A_ID);
			this._navigator.addEventListener(FeathersEventType.TRANSITION_COMPLETE, removeScreenA);
			this._navigator.clearScreen();
			Assert.assertFalse(this._navigator.hasScreen(SCREEN_A_ID));
		}

		[Test]
		public function testRemoveAllScreensOnTransitionCompleteEvent():void
		{
			this.addScreenA();
			this.addScreenB();
			this._navigator.showScreen(SCREEN_A_ID);
			this._navigator.addEventListener(FeathersEventType.TRANSITION_COMPLETE, removeAllScreens);
			this._navigator.clearScreen();
			Assert.assertFalse(this._navigator.hasScreen(SCREEN_A_ID));
		}

		[Test]
		public function testScreenWithEventAndMethodWithSameName():void
		{
			var item:ScreenNavigatorItem = new ScreenNavigatorItem(ScreenWithEventAndMethodWithSameName);
			item.setScreenIDForEvent(EVENT_SHOW_SCREEN_B, SCREEN_B_ID);
			this._navigator.addScreen(SCREEN_A_ID, item);
			this._navigator.showScreen(SCREEN_A_ID);
		}

		private function addScreenA():void
		{
			var screen:Quad = new Quad(10, 10, 0xff00ff);
			var item:ScreenNavigatorItem = new ScreenNavigatorItem(screen);
			item.setScreenIDForEvent(EVENT_SHOW_SCREEN_B, SCREEN_B_ID);
			item.setFunctionForEvent(EVENT_CALL_FUNCTION, eventFunction);
			this._navigator.addScreen(SCREEN_A_ID, item);
		}

		private function addScreenB():void
		{
			var screen:Quad = new Quad(10, 10, 0xffff00);
			var item:ScreenNavigatorItem = new ScreenNavigatorItem(screen);
			this._navigator.addScreen(SCREEN_B_ID, item);
		}

		private function eventFunction():void
		{
			this._functionWasCalled = true;
		}

		private function removeScreenA():void
		{
			this._navigator.removeScreen(SCREEN_A_ID);
		}

		private function removeAllScreens():void
		{
			this._navigator.removeAllScreens();
		}
	}
}

import starling.display.Quad;

class ScreenWithEventAndMethodWithSameName extends Quad
{
	public function ScreenWithEventAndMethodWithSameName()
	{
		super(10, 10, 0xff00ff);
	}
	
	public function showScreenB():void {}
}

================================================
FILE: test/source/feathers/tests/ScrollBarHorizontalMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.BasicButton;
	import feathers.controls.ScrollBar;
	import feathers.controls.TrackLayoutMode;
	import feathers.layout.Direction;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class ScrollBarHorizontalMeasurementTests
	{
		private static const SINGLE_TRACK_WIDTH:Number = 200;
		private static const SINGLE_TRACK_HEIGHT:Number = 50;
		private static const SINGLE_TRACK_MIN_WIDTH:Number = 150;
		private static const SINGLE_TRACK_MIN_HEIGHT:Number = 30;

		private static const MINIMUM_TRACK_WIDTH:Number = 100;
		private static const MINIMUM_TRACK_HEIGHT:Number = 50;
		private static const MINIMUM_TRACK_MIN_WIDTH:Number = 80;
		private static const MINIMUM_TRACK_MIN_HEIGHT:Number = 20;

		private static const MAXIMUM_TRACK_WIDTH:Number = 110;
		private static const MAXIMUM_TRACK_HEIGHT:Number = 55;
		private static const MAXIMUM_TRACK_MIN_WIDTH:Number = 90;
		private static const MAXIMUM_TRACK_MIN_HEIGHT:Number = 25;

		private static const THUMB_WIDTH:Number = 30;
		private static const SMALL_THUMB_HEIGHT:Number = 40;
		private static const LARGE_THUMB_HEIGHT:Number = 60;

		private static const THUMB_MIN_WIDTH:Number = 18;
		private static const SMALL_THUMB_MIN_HEIGHT:Number = 20;
		private static const LARGE_THUMB_MIN_HEIGHT:Number = 40;

		private static const DECREMENT_BUTTON_WIDTH:Number = 28;
		private static const SMALL_DECREMENT_BUTTON_HEIGHT:Number = 38;
		private static const LARGE_DECREMENT_BUTTON_HEIGHT:Number = 62;

		private static const DECREMENT_BUTTON_MIN_WIDTH:Number = 20;
		private static const SMALL_DECREMENT_BUTTON_MIN_HEIGHT:Number = 18;
		private static const LARGE_DECREMENT_BUTTON_MIN_HEIGHT:Number = 50;

		private static const INCREMENT_BUTTON_WIDTH:Number = 26;
		private static const SMALL_INCREMENT_BUTTON_HEIGHT:Number = 36;
		private static const LARGE_INCREMENT_BUTTON_HEIGHT:Number = 64;

		private static const INCREMENT_BUTTON_MIN_WIDTH:Number = 24;
		private static const SMALL_INCREMENT_BUTTON_MIN_HEIGHT:Number = 14;
		private static const LARGE_INCREMENT_BUTTON_MIN_HEIGHT:Number = 62;

		private var _scrollBar:ScrollBar;

		[Before]
		public function prepare():void
		{
			this._scrollBar = new ScrollBar();
			this._scrollBar.direction = Direction.HORIZONTAL;
			TestFeathers.starlingRoot.addChild(this._scrollBar);
		}

		[After]
		public function cleanup():void
		{
			this._scrollBar.removeFromParent(true);
			this._scrollBar = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSingle():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, SMALL_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, SMALL_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The width of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_WIDTH + DECREMENT_BUTTON_WIDTH + INCREMENT_BUTTON_WIDTH, this._scrollBar.width);
			Assert.assertStrictlyEquals("The minWidth of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_WIDTH + DECREMENT_BUTTON_WIDTH + INCREMENT_BUTTON_WIDTH, this._scrollBar.minWidth);
			Assert.assertStrictlyEquals("The height of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_HEIGHT, this._scrollBar.height);
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeHeightWithTrackLayoutModeSingleAndLargerThumb():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, LARGE_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, SMALL_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, SMALL_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The height of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger thumb.",
				LARGE_THUMB_HEIGHT, this._scrollBar.height);
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger thumb.",
				LARGE_THUMB_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeHeightWithTrackLayoutModeSingleAndLargerDecrementButton():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, LARGE_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, SMALL_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The height of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger decrement button.",
				LARGE_DECREMENT_BUTTON_HEIGHT, this._scrollBar.height);
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger decrement button.",
				LARGE_DECREMENT_BUTTON_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeHeightWithTrackLayoutModeSingleAndLargerIncrementButton():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, SMALL_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, LARGE_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The height of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger increment button.",
				LARGE_INCREMENT_BUTTON_HEIGHT, this._scrollBar.height);
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger increment button.",
				LARGE_INCREMENT_BUTTON_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSingleAndMinDimensions():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = SMALL_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				button.minWidth = SINGLE_TRACK_MIN_WIDTH;
				button.minHeight = SINGLE_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, SMALL_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				button.minWidth = DECREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = SMALL_DECREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, SMALL_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				button.minWidth = INCREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = SMALL_INCREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minWidth of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and the track's minWidth is set.",
				SINGLE_TRACK_MIN_WIDTH + DECREMENT_BUTTON_MIN_WIDTH + INCREMENT_BUTTON_MIN_WIDTH, this._scrollBar.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and the track's minHeight is set.",
				SINGLE_TRACK_MIN_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeMinHeightWithTrackLayoutModeSingleAndLargerThumb():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, LARGE_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = LARGE_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				button.minWidth = SINGLE_TRACK_MIN_WIDTH;
				button.minHeight = SINGLE_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, SMALL_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				button.minWidth = DECREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = SMALL_DECREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, SMALL_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				button.minWidth = INCREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = SMALL_INCREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger thumb minHeight.",
				LARGE_THUMB_MIN_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeMinHeightWithTrackLayoutModeSingleAndLargerDecrementButton():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = LARGE_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				button.minWidth = SINGLE_TRACK_MIN_WIDTH;
				button.minHeight = SINGLE_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, LARGE_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				button.minWidth = DECREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = LARGE_DECREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, SMALL_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				button.minWidth = INCREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = SMALL_INCREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger decrement button minHeight.",
				LARGE_DECREMENT_BUTTON_MIN_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeMinHeightWithTrackLayoutModeSingleAndLargerIncrementButton():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = LARGE_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				button.minWidth = SINGLE_TRACK_MIN_WIDTH;
				button.minHeight = SINGLE_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, SMALL_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				button.minWidth = DECREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = SMALL_DECREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, LARGE_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				button.minWidth = INCREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = LARGE_INCREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger increment button minHeight.",
				LARGE_INCREMENT_BUTTON_MIN_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSplit():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._scrollBar.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, SMALL_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, SMALL_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The width of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MINIMUM_TRACK_WIDTH + MAXIMUM_TRACK_WIDTH + DECREMENT_BUTTON_WIDTH + INCREMENT_BUTTON_WIDTH, this._scrollBar.width);
			Assert.assertStrictlyEquals("The minWidth of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MINIMUM_TRACK_WIDTH + MAXIMUM_TRACK_WIDTH + DECREMENT_BUTTON_WIDTH + INCREMENT_BUTTON_WIDTH, this._scrollBar.minWidth);
			Assert.assertStrictlyEquals("The height of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MAXIMUM_TRACK_HEIGHT, this._scrollBar.height);
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MAXIMUM_TRACK_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeHeightWithTrackLayoutModeSplitAndLargerThumb():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, LARGE_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._scrollBar.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, SMALL_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, SMALL_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The height of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger thumb.",
				LARGE_THUMB_HEIGHT, this._scrollBar.height);
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger thumb.",
				LARGE_THUMB_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeHeightWithTrackLayoutModeSplitAndLargerDecrementButton():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._scrollBar.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, LARGE_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, SMALL_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The height of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger decrement button.",
				LARGE_DECREMENT_BUTTON_HEIGHT, this._scrollBar.height);
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger decrement button.",
				LARGE_DECREMENT_BUTTON_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeHeightWithTrackLayoutModeSplitAndLargerIncrementButton():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._scrollBar.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, SMALL_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, LARGE_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The height of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger increment button.",
				LARGE_INCREMENT_BUTTON_HEIGHT, this._scrollBar.height);
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger increment button.",
				LARGE_INCREMENT_BUTTON_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSplitAndMinDimensions():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = SMALL_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				button.minWidth = MINIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MINIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				button.minWidth = MAXIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MAXIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, SMALL_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				button.minWidth = DECREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = SMALL_DECREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, SMALL_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				button.minWidth = INCREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = SMALL_INCREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minWidth of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT when the track's minWidth is set.",
				MINIMUM_TRACK_MIN_WIDTH + MAXIMUM_TRACK_MIN_WIDTH + DECREMENT_BUTTON_MIN_WIDTH + INCREMENT_BUTTON_MIN_WIDTH, this._scrollBar.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT when the track's minHeight is set.",
				MAXIMUM_TRACK_MIN_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeMinHeightWithTrackLayoutModeSplitAndLargerThumb():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, LARGE_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = LARGE_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				button.minWidth = MINIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MINIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				button.minWidth = MAXIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MAXIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, SMALL_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				button.minWidth = DECREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = SMALL_DECREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, SMALL_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				button.minWidth = INCREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = SMALL_INCREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger thumb minHeight.",
				LARGE_THUMB_MIN_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeMinHeightWithTrackLayoutModeSplitAndLargerDecrementButton():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = SMALL_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				button.minWidth = MINIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MINIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				button.minWidth = MAXIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MAXIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, LARGE_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				button.minWidth = DECREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = LARGE_DECREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, SMALL_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				button.minWidth = INCREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = SMALL_INCREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger decrement button minHeight.",
				LARGE_DECREMENT_BUTTON_MIN_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeMinHeightWithTrackLayoutModeSplitAndLargerIncrementButton():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = SMALL_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				button.minWidth = MINIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MINIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				button.minWidth = MAXIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MAXIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, SMALL_DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				button.minWidth = DECREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = SMALL_DECREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, LARGE_INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				button.minWidth = INCREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = LARGE_INCREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minHeight of the horizontal ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger increment button minHeight.",
				LARGE_INCREMENT_BUTTON_MIN_HEIGHT, this._scrollBar.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ScrollBarHorizontalTests.as
================================================
package feathers.tests
{
	import feathers.controls.Button;
	import feathers.controls.ScrollBar;
	import feathers.controls.TrackLayoutMode;
	import feathers.layout.Direction;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class ScrollBarHorizontalTests
	{
		private static const DECREMENT_BUTTON_NAME:String = "decrement-button";
		private static const INCREMENT_BUTTON_NAME:String = "increment-button";
		private static const THUMB_NAME:String = "thumb";
		private static const TRACK_NAME:String = "track";
		private static const TRACK_WIDTH:Number = 200;
		private static const TRACK_HEIGHT:Number = 20;
		private static const THUMB_WIDTH:Number = 20;
		private static const THUMB_HEIGHT:Number = 20;
		private static const DECREMENT_BUTTON_WIDTH:Number = 30;
		private static const DECREMENT_BUTTON_HEIGHT:Number = 20;
		private static const INCREMENT_BUTTON_WIDTH:Number = 30;
		private static const INCREMENT_BUTTON_HEIGHT:Number = 20;

		private var _scrollBar:ScrollBar;

		[Before]
		public function prepare():void
		{
			this._scrollBar = new ScrollBar();
			this._scrollBar.direction = Direction.HORIZONTAL;
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.decrementButtonFactory = function():Button
			{
				var decrementButton:Button = new Button();
				decrementButton.name = DECREMENT_BUTTON_NAME;
				decrementButton.defaultSkin = new Quad(DECREMENT_BUTTON_WIDTH, DECREMENT_BUTTON_HEIGHT);
				return decrementButton;
			};
			this._scrollBar.incrementButtonFactory = function():Button
			{
				var incrementButton:Button = new Button();
				incrementButton.name = INCREMENT_BUTTON_NAME;
				incrementButton.defaultSkin = new Quad(INCREMENT_BUTTON_WIDTH, INCREMENT_BUTTON_HEIGHT);
				return incrementButton;
			};
			this._scrollBar.minimumTrackFactory = function():Button
			{
				var track:Button = new Button();
				track.name = TRACK_NAME;
				track.defaultSkin = new Quad(TRACK_WIDTH, TRACK_HEIGHT);
				return track;
			};
			this._scrollBar.thumbFactory = function():Button
			{
				var thumb:Button = new Button();
				thumb.name = THUMB_NAME;
				thumb.defaultSkin = new Quad(THUMB_WIDTH, THUMB_HEIGHT);
				return thumb;
			};
			TestFeathers.starlingRoot.addChild(this._scrollBar);
			this._scrollBar.validate();
		}

		[After]
		public function cleanup():void
		{
			this._scrollBar.removeFromParent(true);
			this._scrollBar = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testSingleTrackAutoSize():void
		{
			Assert.assertStrictlyEquals("The width of the scroll bar was not calculated correctly.",
				TRACK_WIDTH + INCREMENT_BUTTON_WIDTH + DECREMENT_BUTTON_WIDTH, this._scrollBar.width);
			Assert.assertStrictlyEquals("The height of the scroll bar was not calculated correctly.",
				TRACK_HEIGHT, this._scrollBar.height);
		}

		[Test]
		public function testSetValueProgramaticallyWithMinimum():void
		{
			this._scrollBar.minimum = 5;
			this._scrollBar.maximum = 10;
			this._scrollBar.value = 2;
			Assert.assertEquals("Setting value smaller than minimum not changed to minimum.", this._scrollBar.minimum, this._scrollBar.value);
		}

		[Test]
		public function testSetValueProgramaticallyWithMaximum():void
		{
			this._scrollBar.minimum = 5;
			this._scrollBar.maximum = 10;
			this._scrollBar.value = 12;
			Assert.assertEquals("Setting value larger than maximum not changed to maximum.", this._scrollBar.maximum, this._scrollBar.value);
		}

		[Test]
		public function testProgrammaticSelectionChange():void
		{
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = 1;
			this._scrollBar.page = 2;
			this._scrollBar.value = 5;
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._scrollBar.value = 6;
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
		}

		[Test]
		public function testInteractiveSelectionChangeWithDraggingThumb():void
		{
			var beforeValue:Number = 5;
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = 1;
			this._scrollBar.page = 2;
			this._scrollBar.value = beforeValue;
			//validate to position the thumb correctly.
			this._scrollBar.validate();
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(DECREMENT_BUTTON_WIDTH + TRACK_WIDTH / 2, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._scrollBar.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the scroll bar's thumb",
				this._scrollBar.getChildByName(THUMB_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.MOVED;
			touch.globalX = position.x + THUMB_WIDTH * 2;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("The value property was not changed to a greater value",
				beforeValue < this._scrollBar.value);
		}

		[Test]
		public function testInteractiveSelectionChangeWithDraggingThumbBeyondRightEdgeOfTrack():void
		{
			var beforeValue:Number = 5;
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = 1;
			this._scrollBar.page = 2;
			this._scrollBar.value = beforeValue;
			//validate to position the thumb correctly.
			this._scrollBar.validate();
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(INCREMENT_BUTTON_WIDTH + TRACK_WIDTH / 2, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._scrollBar.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the scroll bar's thumb",
				this._scrollBar.getChildByName(THUMB_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.MOVED;
			touch.globalX = position.x + TRACK_WIDTH + INCREMENT_BUTTON_WIDTH;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The value property was not equal to the maximum value",
				this._scrollBar.maximum, this._scrollBar.value);
		}

		[Test]
		public function testInteractiveSelectionChangeWithDraggingThumbBeyondLeftEdgeOfTrack():void
		{
			var beforeValue:Number = 5;
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = 1;
			this._scrollBar.page = 2;
			this._scrollBar.value = beforeValue;
			//validate to position the thumb correctly.
			this._scrollBar.validate();
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(DECREMENT_BUTTON_WIDTH + TRACK_WIDTH / 2, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._scrollBar.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the scroll bar's thumb",
				this._scrollBar.getChildByName(THUMB_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.MOVED;
			touch.globalX = position.x - TRACK_WIDTH - DECREMENT_BUTTON_WIDTH;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The value property was not equal to the minimum value",
				this._scrollBar.minimum, this._scrollBar.value);
		}

		[Test]
		public function testInteractiveSelectionChangeWithTouchToLeftOfThumb():void
		{
			var beforeValue:Number = 5;
			var page:Number = 2;
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = 1;
			this._scrollBar.page = page;
			this._scrollBar.value = beforeValue;
			//validate to position the thumb correctly.
			this._scrollBar.validate();
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var thumbWidth:Number = this._scrollBar.getChildByName(THUMB_NAME).width;
			var position:Point = new Point(DECREMENT_BUTTON_WIDTH + (TRACK_WIDTH - thumbWidth) / 4, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._scrollBar.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the scroll bar's track",
				this._scrollBar.getChildByName(TRACK_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The value property was not less than the previous value minus the page",
				beforeValue - page, this._scrollBar.value);
		}

		[Test]
		public function testInteractiveSelectionChangeWithTouchToRightOfThumb():void
		{
			var beforeValue:Number = 5;
			var page:Number = 2;
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = 1;
			this._scrollBar.page = page;
			this._scrollBar.value = beforeValue;
			//validate to position the thumb correctly.
			this._scrollBar.validate();
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var thumbWidth:Number = this._scrollBar.getChildByName(THUMB_NAME).width;
			var position:Point = new Point(DECREMENT_BUTTON_WIDTH + 3 * (TRACK_WIDTH - thumbWidth) / 4, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._scrollBar.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the scroll bar's track",
				this._scrollBar.getChildByName(TRACK_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The value property was not the previous value plus the page",
				beforeValue + page, this._scrollBar.value);
		}

		[Test]
		public function testInteractiveSelectionChangeByTappingDecrementButton():void
		{
			var beforeValue:Number = 5;
			var step:Number = 1;
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = step;
			this._scrollBar.page = 2;
			this._scrollBar.value = beforeValue;
			//validate to position the thumb correctly.
			this._scrollBar.validate();
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(DECREMENT_BUTTON_WIDTH / 2, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._scrollBar.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the scroll bar's decrement button",
				this._scrollBar.getChildByName(DECREMENT_BUTTON_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The value property was not equal to the previous value minus the step",
				beforeValue - step, this._scrollBar.value);
		}

		[Test]
		public function testInteractiveSelectionChangeByTappingIncrementButton():void
		{
			var beforeValue:Number = 5;
			var step:Number = 1;
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = step;
			this._scrollBar.page = 2;
			this._scrollBar.value = beforeValue;
			//validate to position the thumb correctly.
			this._scrollBar.validate();
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(this._scrollBar.width - INCREMENT_BUTTON_WIDTH / 2, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._scrollBar.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the scroll bar's increment button",
				this._scrollBar.getChildByName(INCREMENT_BUTTON_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The value property was not equal to the previous value plus the step",
				beforeValue + step, this._scrollBar.value);
		}

		[Test]
		public function testFallBackToStepWhenPageIsZero():void
		{
			var beforeValue:Number = 5;
			var step:Number = 1;
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = step;
			this._scrollBar.page = 0;
			this._scrollBar.value = beforeValue;
			//validate to position the thumb correctly.
			this._scrollBar.validate();
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var thumbWidth:Number = this._scrollBar.getChildByName(THUMB_NAME).width;
			var position:Point = new Point(DECREMENT_BUTTON_WIDTH + (TRACK_WIDTH - thumbWidth) / 4, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._scrollBar.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the scroll bar's track",
				this._scrollBar.getChildByName(TRACK_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertStrictlyEquals("The value property was not equal to the the previous value minus the step value",
				beforeValue - step, this._scrollBar.value);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ScrollBarVerticalMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.BasicButton;
	import feathers.controls.ScrollBar;
	import feathers.controls.TrackLayoutMode;
	import feathers.layout.Direction;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class ScrollBarVerticalMeasurementTests
	{
		private static const SINGLE_TRACK_WIDTH:Number = 50;
		private static const SINGLE_TRACK_HEIGHT:Number = 200;
		private static const SINGLE_TRACK_MIN_WIDTH:Number = 30;
		private static const SINGLE_TRACK_MIN_HEIGHT:Number = 150;

		private static const MINIMUM_TRACK_WIDTH:Number = 50;
		private static const MINIMUM_TRACK_HEIGHT:Number = 100;
		private static const MINIMUM_TRACK_MIN_WIDTH:Number = 20;
		private static const MINIMUM_TRACK_MIN_HEIGHT:Number = 80;

		private static const MAXIMUM_TRACK_WIDTH:Number = 55;
		private static const MAXIMUM_TRACK_HEIGHT:Number = 110;
		private static const MAXIMUM_TRACK_MIN_WIDTH:Number = 25;
		private static const MAXIMUM_TRACK_MIN_HEIGHT:Number = 90;

		private static const SMALL_THUMB_WIDTH:Number = 40;
		private static const LARGE_THUMB_WIDTH:Number = 60;
		private static const THUMB_HEIGHT:Number = 30;

		private static const SMALL_THUMB_MIN_WIDTH:Number = 20;
		private static const LARGE_THUMB_MIN_WIDTH:Number = 40;
		private static const THUMB_MIN_HEIGHT:Number = 18;

		private static const SMALL_DECREMENT_BUTTON_WIDTH:Number = 38;
		private static const LARGE_DECREMENT_BUTTON_WIDTH:Number = 62;
		private static const DECREMENT_BUTTON_HEIGHT:Number = 28;

		private static const SMALL_DECREMENT_BUTTON_MIN_WIDTH:Number = 18;
		private static const LARGE_DECREMENT_BUTTON_MIN_WIDTH:Number = 50;
		private static const DECREMENT_BUTTON_MIN_HEIGHT:Number = 20;

		private static const SMALL_INCREMENT_BUTTON_WIDTH:Number = 36;
		private static const LARGE_INCREMENT_BUTTON_WIDTH:Number = 64;
		private static const INCREMENT_BUTTON_HEIGHT:Number = 26;

		private static const SMALL_INCREMENT_BUTTON_MIN_WIDTH:Number = 14;
		private static const LARGE_INCREMENT_BUTTON_MIN_WIDTH:Number = 62;
		private static const INCREMENT_BUTTON_MIN_HEIGHT:Number = 24;

		private var _scrollBar:ScrollBar;

		[Before]
		public function prepare():void
		{
			this._scrollBar = new ScrollBar();
			this._scrollBar.direction = Direction.VERTICAL;
			TestFeathers.starlingRoot.addChild(this._scrollBar);
		}

		[After]
		public function cleanup():void
		{
			this._scrollBar.removeFromParent(true);
			this._scrollBar = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSingle():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(SMALL_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_DECREMENT_BUTTON_WIDTH, DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_INCREMENT_BUTTON_WIDTH, INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The width of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_WIDTH, this._scrollBar.width);
			Assert.assertStrictlyEquals("The minWidth of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_WIDTH, this._scrollBar.minWidth);
			Assert.assertStrictlyEquals("The height of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_HEIGHT + DECREMENT_BUTTON_HEIGHT + INCREMENT_BUTTON_HEIGHT, this._scrollBar.height);
			Assert.assertStrictlyEquals("The minHeight of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_HEIGHT + DECREMENT_BUTTON_HEIGHT + INCREMENT_BUTTON_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeWidthWithTrackLayoutModeSingleAndLargerThumb():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(LARGE_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_DECREMENT_BUTTON_WIDTH, DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_INCREMENT_BUTTON_WIDTH, INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The width of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger thumb.",
				LARGE_THUMB_WIDTH, this._scrollBar.width);
			Assert.assertStrictlyEquals("The minWidth of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger thumb.",
				LARGE_THUMB_WIDTH, this._scrollBar.minWidth);
		}

		[Test]
		public function testAutoSizeWidthWithTrackLayoutModeSingleAndLargerDecrementButton():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(SMALL_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(LARGE_DECREMENT_BUTTON_WIDTH, DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_INCREMENT_BUTTON_WIDTH, INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The width of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger decrement button.",
				LARGE_DECREMENT_BUTTON_WIDTH, this._scrollBar.width);
			Assert.assertStrictlyEquals("The minWidth of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger decrement button.",
				LARGE_DECREMENT_BUTTON_WIDTH, this._scrollBar.minWidth);
		}

		[Test]
		public function testAutoSizeWidthWithTrackLayoutModeSingleAndLargerIncrementButton():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(SMALL_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_DECREMENT_BUTTON_WIDTH, DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(LARGE_INCREMENT_BUTTON_WIDTH, INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The width of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger increment button.",
				LARGE_INCREMENT_BUTTON_WIDTH, this._scrollBar.width);
			Assert.assertStrictlyEquals("The minWidth of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger increment button.",
				LARGE_INCREMENT_BUTTON_WIDTH, this._scrollBar.minWidth);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSingleAndMinDimensions():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(SMALL_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = SMALL_THUMB_MIN_WIDTH;
				thumb.minHeight = THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				button.minWidth = SINGLE_TRACK_MIN_WIDTH;
				button.minHeight = SINGLE_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_DECREMENT_BUTTON_WIDTH, DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				button.minWidth = SMALL_DECREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = DECREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_INCREMENT_BUTTON_WIDTH, INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				button.minWidth = SMALL_INCREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = INCREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minWidth of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and the track's minWidth is set.",
				SINGLE_TRACK_MIN_WIDTH, this._scrollBar.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and the track's minHeight is set.",
				SINGLE_TRACK_MIN_HEIGHT + DECREMENT_BUTTON_MIN_HEIGHT + INCREMENT_BUTTON_MIN_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeMinWidthWithTrackLayoutModeSingleAndLargerThumb():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(SMALL_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = LARGE_THUMB_MIN_WIDTH;
				thumb.minHeight = THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				button.minWidth = SINGLE_TRACK_MIN_WIDTH;
				button.minHeight = SINGLE_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_DECREMENT_BUTTON_WIDTH, DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				button.minWidth = SMALL_DECREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = DECREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_INCREMENT_BUTTON_WIDTH, INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				button.minWidth = SMALL_INCREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = INCREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minWidth of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger thumb minHeight.",
				LARGE_THUMB_MIN_WIDTH, this._scrollBar.minWidth);
		}

		[Test]
		public function testAutoSizeMinWidthWithTrackLayoutModeSingleAndLargerDecrementButton():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(SMALL_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = SMALL_THUMB_MIN_WIDTH;
				thumb.minHeight = THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				button.minWidth = SINGLE_TRACK_MIN_WIDTH;
				button.minHeight = SINGLE_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(LARGE_DECREMENT_BUTTON_WIDTH, DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				button.minWidth = LARGE_DECREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = DECREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_INCREMENT_BUTTON_WIDTH, INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				button.minWidth = SMALL_INCREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = INCREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minWidth of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger decrement button minHeight.",
				LARGE_DECREMENT_BUTTON_MIN_WIDTH, this._scrollBar.minWidth);
		}

		[Test]
		public function testAutoSizeMinWidthWithTrackLayoutModeSingleAndLargerIncrementButton():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(SMALL_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = SMALL_THUMB_MIN_WIDTH;
				thumb.minHeight = THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				button.minWidth = SINGLE_TRACK_MIN_WIDTH;
				button.minHeight = SINGLE_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_DECREMENT_BUTTON_WIDTH, DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				button.minWidth = SMALL_DECREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = DECREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(LARGE_INCREMENT_BUTTON_WIDTH, INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				button.minWidth = LARGE_INCREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = INCREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minWidth of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger increment button minHeight.",
				LARGE_INCREMENT_BUTTON_MIN_WIDTH, this._scrollBar.minWidth);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSplit():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(SMALL_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._scrollBar.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_DECREMENT_BUTTON_WIDTH, DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_INCREMENT_BUTTON_WIDTH, INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The width of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MAXIMUM_TRACK_WIDTH, this._scrollBar.width);
			Assert.assertStrictlyEquals("The minWidth of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MAXIMUM_TRACK_WIDTH, this._scrollBar.minWidth);
			Assert.assertStrictlyEquals("The height of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MINIMUM_TRACK_HEIGHT + MAXIMUM_TRACK_HEIGHT + DECREMENT_BUTTON_HEIGHT + INCREMENT_BUTTON_HEIGHT, this._scrollBar.height);
			Assert.assertStrictlyEquals("The minHeight of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MINIMUM_TRACK_HEIGHT + MAXIMUM_TRACK_HEIGHT + DECREMENT_BUTTON_HEIGHT + INCREMENT_BUTTON_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeWidthWithTrackLayoutModeSplitAndLargerThumb():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(LARGE_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._scrollBar.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_DECREMENT_BUTTON_WIDTH, DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_INCREMENT_BUTTON_WIDTH, INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The width of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger thumb.",
				LARGE_THUMB_WIDTH, this._scrollBar.width);
			Assert.assertStrictlyEquals("The minWidth of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger thumb.",
				LARGE_THUMB_WIDTH, this._scrollBar.minWidth);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSplitAndMinDimensions():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(SMALL_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = SMALL_THUMB_MIN_WIDTH;
				thumb.minHeight = THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				button.minWidth = MINIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MINIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				button.minWidth = MAXIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MAXIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_DECREMENT_BUTTON_WIDTH, DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				button.minWidth = SMALL_DECREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = DECREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_INCREMENT_BUTTON_WIDTH, INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				button.minWidth = SMALL_INCREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = INCREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minWidth of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT when the track's minWidth is set.",
				MAXIMUM_TRACK_MIN_WIDTH, this._scrollBar.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT when the track's minHeight is set.",
				MINIMUM_TRACK_MIN_HEIGHT + MAXIMUM_TRACK_MIN_HEIGHT + DECREMENT_BUTTON_MIN_HEIGHT + INCREMENT_BUTTON_MIN_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeMinWidthtWithTrackLayoutModeSplitAndLargerThumb():void
		{
			this._scrollBar.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(LARGE_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = LARGE_THUMB_MIN_WIDTH;
				thumb.minHeight = THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				button.minWidth = MINIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MINIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				button.minWidth = MAXIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MAXIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.decrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_DECREMENT_BUTTON_WIDTH, DECREMENT_BUTTON_HEIGHT, 0x00ff00);
				button.minWidth = SMALL_DECREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = DECREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.incrementButtonFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SMALL_INCREMENT_BUTTON_WIDTH, INCREMENT_BUTTON_HEIGHT, 0x00ffff);
				button.minWidth = SMALL_INCREMENT_BUTTON_MIN_WIDTH;
				button.minHeight = INCREMENT_BUTTON_MIN_HEIGHT;
				return button;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minWidth of the vertical ScrollBar was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger thumb minHeight.",
				LARGE_THUMB_MIN_WIDTH, this._scrollBar.minWidth);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ScrollContainerMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.AutoSizeMode;
	import feathers.controls.ScrollContainer;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class ScrollContainerMeasurementTests
	{
		//note: the background width is purposefully smaller than the item width
		private static const BACKGROUND_WIDTH:Number = 200;
		//note: the background height is purposefully larger than the item height
		private static const BACKGROUND_HEIGHT:Number = 250;

		//note: the item width is purposefully larger than the background width
		private static const ITEM_WIDTH:Number = 210;
		//note: the item height is purposefully smaller than the background height
		private static const ITEM_HEIGHT:Number = 160;

		private static const ITEM_PIVOTX:Number = 105;
		private static const ITEM_PIVOTY:Number = 80;

		private var _container:ScrollContainer;
		private var _container2:ScrollContainer;

		[Before]
		public function prepare():void
		{
			this._container = new ScrollContainer();
			TestFeathers.starlingRoot.addChild(this._container);
			this._container.validate();
		}

		[After]
		public function cleanup():void
		{
			this._container.removeFromParent(true);
			this._container = null;
			
			if(this._container2)
			{
				this._container2.removeFromParent(true);
				this._container2 = null;
			}

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testAutoSizeWithNoBackgroundAndNoChildren():void
		{
			this._container.validate();
			Assert.assertStrictlyEquals("The width of the scroll container was not calculated correctly.",
				0, this._container.width);
			Assert.assertStrictlyEquals("The height of the scroll container was not calculated correctly.",
				0, this._container.height);
			Assert.assertStrictlyEquals("The minWidth of the scroll container was not calculated correctly.",
				0, this._container.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the scroll container was not calculated correctly.",
				0, this._container.minHeight);
		}

		[Test]
		public function testAutoSizeWithBackgroundAndNoChildren():void
		{
			this._container.backgroundSkin = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT);
			this._container.validate();
			Assert.assertStrictlyEquals("The width of the scroll container was not calculated correctly.",
				BACKGROUND_WIDTH, this._container.width);
			Assert.assertStrictlyEquals("The height of the scroll container was not calculated correctly.",
				BACKGROUND_HEIGHT, this._container.height);
			Assert.assertStrictlyEquals("The minWidth of the scroll container was not calculated correctly.",
				BACKGROUND_WIDTH, this._container.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the scroll container was not calculated correctly.",
				BACKGROUND_HEIGHT, this._container.minHeight);
		}

		[Test]
		public function testAutoSizeModeStage():void
		{
			this._container.autoSizeMode = AutoSizeMode.STAGE;
			this._container.validate();
			Assert.assertStrictlyEquals("The width of the scroll container was not calculated correctly with autoSizeMode set to AutoSizeMode.STAGE.",
				this._container.stage.stageWidth, this._container.width);
			Assert.assertStrictlyEquals("The height of the scroll container was not calculated correctly with autoSizeMode set to AutoSizeMode.STAGE.",
				this._container.stage.stageHeight, this._container.height);
			Assert.assertStrictlyEquals("The minWidth of the scroll container was not calculated correctly with autoSizeMode set to AutoSizeMode.STAGE.",
				this._container.stage.stageWidth, this._container.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the scroll container was not calculated correctly with autoSizeMode set to AutoSizeMode.STAGE.",
				this._container.stage.stageHeight, this._container.minHeight);
		}

		[Test]
		public function testAutoSizeModeStageWithoutParent():void
		{
			this._container2 = new ScrollContainer();
			this._container2.autoSizeMode = AutoSizeMode.STAGE;
			this._container2.validate();
			Assert.assertStrictlyEquals("The width of the ScrollContainer was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._container2.width);
			Assert.assertStrictlyEquals("The height of the ScrollContainer was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._container2.height);
			Assert.assertStrictlyEquals("The minWidth of the ScrollContainer was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._container2.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the ScrollContainer was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._container2.minHeight);
		}

		[Test]
		public function testAutoSizeModeStageWithValidateBeforeAdd():void
		{
			this._container2 = new ScrollContainer();
			this._container2.autoSizeMode = AutoSizeMode.STAGE;
			this._container2.validate();
			TestFeathers.starlingRoot.addChild(this._container2);
			this._container2.validate();
			Assert.assertStrictlyEquals("The width of the ScrollContainer was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._container2.width);
			Assert.assertStrictlyEquals("The height of the ScrollContainer was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._container2.height);
			Assert.assertStrictlyEquals("The minWidth of the ScrollContainer was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._container2.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the ScrollContainer was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._container2.minHeight);
		}

		[Test]
		public function testAutoSizeWithChildAtOrigin():void
		{
			this._container.addChild(new Quad(ITEM_WIDTH, ITEM_HEIGHT));
			this._container.validate();
			Assert.assertStrictlyEquals("The width of the scroll container was not calculated correctly.",
				ITEM_WIDTH, this._container.width);
			Assert.assertStrictlyEquals("The height of the scroll container was not calculated correctly.",
				ITEM_HEIGHT, this._container.height);
			Assert.assertStrictlyEquals("The minWidth of the scroll container was not calculated correctly.",
				ITEM_WIDTH, this._container.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the scroll container was not calculated correctly.",
				ITEM_HEIGHT, this._container.minHeight);
		}

		[Test]
		public function testAutoSizeWithChildAtOriginAndMeasureViewPortSetToFalse():void
		{
			this._container.addChild(new Quad(ITEM_WIDTH, ITEM_HEIGHT));
			this._container.measureViewPort = false;
			this._container.validate();
			Assert.assertStrictlyEquals("The width of the scroll container was not calculated correctly.",
				0, this._container.width);
			Assert.assertStrictlyEquals("The height of the scroll container was not calculated correctly.",
				0, this._container.height);
			Assert.assertStrictlyEquals("The minWidth of the scroll container was not calculated correctly.",
				0, this._container.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the scroll container was not calculated correctly.",
				0, this._container.minHeight);
		}

		[Test]
		public function testAutoSizeWithChildAtPositiveXAndY():void
		{
			var child:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			child.x = 120;
			child.y = 130;
			this._container.addChild(child);
			this._container.validate();
			Assert.assertStrictlyEquals("The width of the scroll container was not calculated correctly.",
				child.x + ITEM_WIDTH, this._container.width);
			Assert.assertStrictlyEquals("The height of the scroll container was not calculated correctly.",
				child.y + ITEM_HEIGHT, this._container.height);
			Assert.assertStrictlyEquals("The minWidth of the scroll container was not calculated correctly.",
				child.x + ITEM_WIDTH, this._container.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the scroll container was not calculated correctly.",
				child.y + ITEM_HEIGHT, this._container.minHeight);
		}

		[Test]
		public function testAutoSizeWithMultipleChildren():void
		{
			var child1:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			child1.x = 0;
			child1.y = 130;
			this._container.addChild(child1);
			var child2:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			child2.x = 120;
			child2.y = 0;
			this._container.addChild(child2);
			this._container.validate();
			Assert.assertStrictlyEquals("The width of the scroll container was not calculated correctly.",
				child2.x + ITEM_WIDTH, this._container.width);
			Assert.assertStrictlyEquals("The height of the scroll container was not calculated correctly.",
				child1.y + ITEM_HEIGHT, this._container.height);
			Assert.assertStrictlyEquals("The minWidth of the scroll container was not calculated correctly.",
				child2.x + ITEM_WIDTH, this._container.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the scroll container was not calculated correctly.",
				child1.y + ITEM_HEIGHT, this._container.minHeight);
		}

		[Test]
		public function testAutoSizeChildAndBackground():void
		{
			this._container.addChild(new Quad(ITEM_WIDTH, ITEM_HEIGHT));
			this._container.backgroundSkin = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT);
			this._container.validate();
			Assert.assertStrictlyEquals("The width of the scroll container was not calculated correctly.",
				ITEM_WIDTH, this._container.width);
			Assert.assertStrictlyEquals("The height of the scroll container was not calculated correctly.",
				BACKGROUND_HEIGHT, this._container.height);
			Assert.assertStrictlyEquals("The minWidth of the scroll container was not calculated correctly.",
				ITEM_WIDTH, this._container.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the scroll container was not calculated correctly.",
				BACKGROUND_HEIGHT, this._container.minHeight);
		}

		[Test]
		public function testAutoSizeChildWithPivots():void
		{
			var child:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			child.pivotX = ITEM_PIVOTX;
			child.pivotY = ITEM_PIVOTY;
			child.x = 120;
			child.y = 130;
			this._container.addChild(child);
			this._container.validate();
			var containerWidth:Number = child.x - ITEM_PIVOTX + ITEM_WIDTH;
			var containerHeight:Number = child.y - ITEM_PIVOTY + ITEM_HEIGHT;
			Assert.assertStrictlyEquals("The width of the scroll container was not calculated correctly.",
				containerWidth, this._container.width);
			Assert.assertStrictlyEquals("The height of the scroll container was not calculated correctly.",
				containerHeight, this._container.height);
			Assert.assertStrictlyEquals("The minWidth of the scroll container was not calculated correctly.",
				containerWidth, this._container.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the scroll container was not calculated correctly.",
				containerHeight, this._container.minHeight);
		}

		[Test]
		public function testRemoveChildToResizeSkin():void
		{
			var child:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			this._container.addChild(child);
			this._container.backgroundSkin = new Quad(10, 10, 0xff00ff);
			this._container.backgroundDisabledSkin = new Quad(10, 10, 0xff00ff);
			this._container.validate();
			//the child's dimensions were large enough to make container bigger
			//than the skin's dimensions
			this._container.removeChild(child);
			//switch to a different skin before validation
			this._container.isEnabled = false;
			this._container.validate();
			//now switch back to the original skin, and the dimensions could
			//be wrong if they weren't restored
			this._container.isEnabled = true;
			this._container.validate();
			Assert.assertStrictlyEquals("The width of the ScrollContainer was not calculated correctly after changing to a different skin and removing larger child.",
				10, this._container.width);
			Assert.assertStrictlyEquals("The height of the ScrollContainer was not calculated correctly after changing to a different skin and removing larger child.",
				10, this._container.height);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ScrollContainerTests.as
================================================
package feathers.tests
{
	import feathers.controls.AutoSizeMode;
	import feathers.controls.Button;
	import feathers.controls.ScrollContainer;
	import feathers.tests.supportClasses.AssertViewPortBoundsLayout;

	import org.flexunit.Assert;

	import starling.display.Quad;
	import starling.events.Event;

	public class ScrollContainerTests
	{
		private static const ITEM_WIDTH:Number = 210;
		private static const ITEM_HEIGHT:Number = 160;

		private var _container:ScrollContainer;

		[Before]
		public function prepare():void
		{
			this._container = new ScrollContainer();
			TestFeathers.starlingRoot.addChild(this._container);
			this._container.validate();
		}

		[After]
		public function cleanup():void
		{
			this._container.removeFromParent(true);
			this._container = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testDefaultAutoSizeMode():void
		{
			this._container.validate();
			Assert.assertStrictlyEquals("The default value of LayoutGroup autoSizeMode must be AutoSizeMode.CONTENT, if not root.", AutoSizeMode.CONTENT, this._container.autoSizeMode);
		}

		[Test]
		public function testNoErrorValidatingWithoutStage():void
		{
			var container:ScrollContainer = new ScrollContainer();
			container.validate();
			container.dispose();
		}

		[Test]
		public function testResizeWhenAddingChild():void
		{
			var originalWidth:Number = this._container.width;
			var originalHeight:Number = this._container.height;
			var hasResized:Boolean = false;
			this._container.addEventListener(Event.RESIZE, function(event:Event):void
			{
				hasResized = true;
			});
			this._container.addChild(new Quad(ITEM_WIDTH, ITEM_HEIGHT));
			this._container.validate();
			Assert.assertTrue("Event.RESIZE was not dispatched", hasResized);
			Assert.assertFalse("The width of the layout group was not changed.",
				originalWidth === this._container.width);
			Assert.assertFalse("The height of the layout group was not changed.",
				originalHeight === this._container.height);
		}

		[Test]
		public function testResizeWhenRemovingChild():void
		{
			var child:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			this._container.addChild(child);
			this._container.validate();
			var originalWidth:Number = this._container.width;
			var originalHeight:Number = this._container.height;

			var hasResized:Boolean = false;
			this._container.addEventListener(Event.RESIZE, function(event:Event):void
			{
				hasResized = true;
			});
			this._container.removeChild(child);
			this._container.validate();
			Assert.assertTrue("Event.RESIZE was not dispatched", hasResized);
			Assert.assertFalse("The width of the layout group was not changed.",
				originalWidth === this._container.width);
			Assert.assertFalse("The height of the layout group was not changed.",
				originalHeight === this._container.height);
		}

		[Test]
		public function testResizeWhenResizingFeathersControlChild():void
		{
			var child:Button = new Button();
			child.defaultSkin = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			this._container.addChild(child);
			this._container.validate();

			var originalWidth:Number = this._container.width;
			var originalHeight:Number = this._container.height;
			var hasResized:Boolean = false;
			this._container.addEventListener(Event.RESIZE, function(event:Event):void
			{
				hasResized = true;
			});
			child.width = ITEM_WIDTH * 2;
			child.height = ITEM_HEIGHT * 2;
			this._container.validate();
			Assert.assertTrue("Event.RESIZE was not dispatched", hasResized);
			Assert.assertFalse("The width of the layout group was not changed.",
				originalWidth === this._container.width);
			Assert.assertFalse("The height of the layout group was not changed.",
				originalHeight === this._container.height);
		}

		[Test]
		public function testMaxScrollPositionWithOneChildAndSameDimensions():void
		{
			var child:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			this._container.addChild(child);
			this._container.validate();
			Assert.assertStrictlyEquals("The maxHorizontalScrollPosition of the scroll container was not calculated correctly.",
				0, this._container.maxHorizontalScrollPosition);
			Assert.assertStrictlyEquals("The maxVerticalScrollPosition of the scroll container was not calculated correctly.",
				0, this._container.maxVerticalScrollPosition);
		}

		[Test]
		public function testMaxScrollPositionWithSmallerChild():void
		{
			var child:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			this._container.addChild(child);
			this._container.setSize(ITEM_WIDTH * 3, ITEM_HEIGHT * 3);
			this._container.validate();
			Assert.assertStrictlyEquals("The maxHorizontalScrollPosition of the scroll container was not calculated correctly.",
				0, this._container.maxHorizontalScrollPosition);
			Assert.assertStrictlyEquals("The maxVerticalScrollPosition of the scroll container was not calculated correctly.",
				0, this._container.maxVerticalScrollPosition);
		}

		[Test]
		public function testMaxScrollPositionWithLargerChild():void
		{
			var child:Quad = new Quad(ITEM_WIDTH, ITEM_HEIGHT);
			this._container.addChild(child);
			this._container.setSize(ITEM_WIDTH - 10, ITEM_HEIGHT - 10);
			this._container.validate();
			Assert.assertStrictlyEquals("The maxHorizontalScrollPosition of the scroll container was not calculated correctly when scrolling is required.",
				child.width - this._container.width, this._container.maxHorizontalScrollPosition);
			Assert.assertStrictlyEquals("The maxVerticalScrollPosition of the scroll container was not calculated correctly when scrolling is required.",
				child.height - this._container.height, this._container.maxVerticalScrollPosition);
		}

		[Test]
		public function testViewPortBoundsValues():void
		{
			this._container.layout = new AssertViewPortBoundsLayout();
			this._container.validate();
		}
	}
}


================================================
FILE: test/source/feathers/tests/ScrollContainerValidationTests.as
================================================
package feathers.tests
{
	import org.flexunit.Assert;

	public class ScrollContainerValidationTests
	{
		private var _container:CustomContainer;

		[Before]
		public function prepare():void
		{
			this._container = new CustomContainer();
			TestFeathers.starlingRoot.addChild(this._container);
		}

		[After]
		public function cleanup():void
		{
			this._container.removeFromParent(true);
			this._container = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testResizeChildBeforeLayout():void
		{
			this._container.updateChildBeforeLayout = true;
			this._container.validate();
			Assert.assertFalse("ScrollContainer: must not be invalid if child resizes before layout is applied.",
				this._container.isInvalid());
		}

		[Test]
		public function testResizeChildAfterLayout():void
		{
			this._container.updateChildBeforeLayout = false;
			this._container.validate();
			Assert.assertTrue("ScrollContainer: must be invalid if child resizes after layout is applied.",
				this._container.isInvalid());
		}
	}
}

import feathers.controls.Button;
import feathers.controls.ScrollContainer;

class CustomContainer extends ScrollContainer
{
	private var _child:Button;

	public var updateChildBeforeLayout:Boolean = true;

	override protected function initialize():void
	{
		super.initialize();

		this._child = new Button();
		this._child.label = "Click Me";
		this.addChild(this._child);
	}

	override protected function draw():void
	{
		if(this.updateChildBeforeLayout)
		{
			this.updateChild();
		}
		super.draw();
		if(!this.updateChildBeforeLayout)
		{
			this.updateChild();
		}
	}

	private function updateChild():void
	{
		this._child.width = Math.random() * 100;
		this._child.width = 150;
	}
}

================================================
FILE: test/source/feathers/tests/ScrollerMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.LayoutGroup;
	import feathers.controls.Scroller;
	import feathers.tests.supportClasses.ScrollerViewPort;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class ScrollerMeasurementTests
	{
		private static const BACKGROUND_WIDTH:Number = 200;
		private static const BACKGROUND_HEIGHT:Number = 250;
		
		private static const COMPLEX_BACKGROUND_WIDTH:Number = 540;
		private static const COMPLEX_BACKGROUND_HEIGHT:Number = 550;
		private static const COMPLEX_BACKGROUND_MIN_WIDTH:Number = 380;
		private static const COMPLEX_BACKGROUND_MIN_HEIGHT:Number = 390;
		
		private static const VIEW_PORT_WIDTH:Number = 230;
		private static const VIEW_PORT_HEIGHT:Number = 270;
		private static const VIEW_PORT_MIN_WIDTH:Number = 210;
		private static const VIEW_PORT_MIN_HEIGHT:Number = 260;

		private static const PADDING_TOP:Number = 50;
		private static const PADDING_RIGHT:Number = 54;
		private static const PADDING_BOTTOM:Number = 59;
		private static const PADDING_LEFT:Number = 60;

		private var _scroller:Scroller;
		private var _viewPort:ScrollerViewPort;

		[Before]
		public function prepare():void
		{
			this._viewPort = new ScrollerViewPort();

			this._scroller = new Scroller();
			this._scroller.viewPort = this._viewPort;
			TestFeathers.starlingRoot.addChild(this._scroller);
		}

		[After]
		public function cleanup():void
		{
			this._scroller.removeFromParent(true);
			this._scroller = null;

			this._viewPort = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function addSimpleBackground():void
		{
			this._scroller.backgroundSkin = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT, 0xff00ff);
		}

		private function addComplexBackground():void
		{
			var backgroundSkin:LayoutGroup = new LayoutGroup();
			backgroundSkin.width = COMPLEX_BACKGROUND_WIDTH;
			backgroundSkin.height = COMPLEX_BACKGROUND_HEIGHT;
			backgroundSkin.minWidth = COMPLEX_BACKGROUND_MIN_WIDTH;
			backgroundSkin.minHeight = COMPLEX_BACKGROUND_MIN_HEIGHT;
			this._scroller.backgroundSkin = backgroundSkin;
		}

		[Test]
		public function testAutoSizeWithNoBackgroundSkin():void
		{
			this._scroller.validate();
			Assert.assertStrictlyEquals("The width of the Scroller was not calculated correctly when empty.",
				0, this._scroller.width);
			Assert.assertStrictlyEquals("The height of the Scroller was not calculated correctly when empty.",
				0, this._scroller.height);
			Assert.assertStrictlyEquals("The minWidth of the Scroller was not calculated correctly when empty.",
				0, this._scroller.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Scroller was not calculated correctly when empty.",
				0, this._scroller.minHeight);
		}

		[Test]
		public function testAutoSizeWithPadding():void
		{
			this._scroller.paddingTop = PADDING_TOP;
			this._scroller.paddingRight = PADDING_RIGHT;
			this._scroller.paddingBottom = PADDING_BOTTOM;
			this._scroller.paddingLeft = PADDING_LEFT;
			this._scroller.validate();

			Assert.assertStrictlyEquals("The width of the Scroller was not calculated correctly based on the left and right padding.",
				PADDING_LEFT + PADDING_RIGHT, this._scroller.width);
			Assert.assertStrictlyEquals("The height of the Scroller was not calculated correctly based on the top and bottom padding.",
				PADDING_TOP + PADDING_BOTTOM, this._scroller.height);
			Assert.assertStrictlyEquals("The minWidth of the Scroller was not calculated correctly based on the left and right padding.",
				PADDING_LEFT + PADDING_RIGHT, this._scroller.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Scroller was not calculated correctly based on the top and bottom padding.",
				PADDING_TOP + PADDING_BOTTOM, this._scroller.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleBackgroundSkin():void
		{
			this.addSimpleBackground();
			this._scroller.validate();
			
			Assert.assertStrictlyEquals("The width of the Scroller was not calculated correctly based on the background width.",
				BACKGROUND_WIDTH, this._scroller.width);
			Assert.assertStrictlyEquals("The height of the Scroller was not calculated correctly based on the background width.",
				BACKGROUND_HEIGHT, this._scroller.height);
			Assert.assertStrictlyEquals("The minWidth of the Scroller was not calculated correctly based on the background height.",
				BACKGROUND_WIDTH, this._scroller.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Scroller was not calculated correctly based on the background width.",
				BACKGROUND_HEIGHT, this._scroller.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexBackground():void
		{
			this.addComplexBackground();
			this._scroller.validate();

			Assert.assertStrictlyEquals("The width of the Scroller was not calculated correctly based on the complex background width.",
				COMPLEX_BACKGROUND_WIDTH, this._scroller.width);
			Assert.assertStrictlyEquals("The height of the Scroller was not calculated correctly based on the complex background height.",
				COMPLEX_BACKGROUND_HEIGHT, this._scroller.height);
			Assert.assertStrictlyEquals("The minWidth of the Scroller was not calculated correctly based on the complex background minWidth.",
				COMPLEX_BACKGROUND_MIN_WIDTH, this._scroller.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Scroller was not calculated correctly based on the complex background minHeight.",
				COMPLEX_BACKGROUND_MIN_HEIGHT, this._scroller.minHeight);
		}

		[Test]
		public function testAutoSizeWithViewPort():void
		{
			//the explicit dimensions of the view port are saved when the
			//viewPort property is set, so let's be sure they get saved.
			this._scroller.viewPort = null;
			this._viewPort.width = VIEW_PORT_WIDTH;
			this._viewPort.height = VIEW_PORT_HEIGHT;
			this._viewPort.minWidth = VIEW_PORT_MIN_WIDTH;
			this._viewPort.minHeight = VIEW_PORT_MIN_HEIGHT;
			this._scroller.viewPort = this._viewPort;
			this._scroller.validate();

			Assert.assertStrictlyEquals("The width of the Scroller was not calculated correctly based on the view port width.",
				VIEW_PORT_WIDTH, this._scroller.width);
			Assert.assertStrictlyEquals("The height of the Scroller was not calculated correctly based on the view port height.",
				VIEW_PORT_HEIGHT, this._scroller.height);
			Assert.assertStrictlyEquals("The minWidth of the Scroller was not calculated correctly based on the view port minWidth.",
				VIEW_PORT_MIN_WIDTH, this._scroller.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Scroller was not calculated correctly based on the view port minHeight.",
				VIEW_PORT_MIN_HEIGHT, this._scroller.minHeight);
		}

		[Test]
		public function testAutoSizeWithViewPortWhenMeasureViewPortIsFalse():void
		{
			this._scroller.measureViewPort = false;
			//the explicit dimensions of the view port are saved when the
			//viewPort property is set, so let's be sure they get saved.
			this._scroller.viewPort = null;
			this._viewPort.width = VIEW_PORT_WIDTH;
			this._viewPort.height = VIEW_PORT_HEIGHT;
			this._viewPort.height = VIEW_PORT_HEIGHT;
			this._viewPort.minWidth = VIEW_PORT_MIN_WIDTH;
			this._viewPort.minHeight = VIEW_PORT_MIN_HEIGHT;
			this._scroller.viewPort = this._viewPort;
			this._scroller.validate();

			Assert.assertStrictlyEquals("The width of the Scroller was not calculated correctly when measureViewPort is false.",
				0, this._scroller.width);
			Assert.assertStrictlyEquals("The height of the Scroller was not calculated correctly when measureViewPort is false.",
				0, this._scroller.height);
			Assert.assertStrictlyEquals("The minWidth of the Scroller was not calculated correctly when measureViewPort is false.",
				0, this._scroller.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the Scroller was not calculated correctly when measureViewPort is false.",
				0, this._scroller.minHeight);
		}

		[Test]
		public function testMaxScrollPositionChangeWhenViewPortResizesOnScroll():void
		{
			//the explicit dimensions of the view port are saved when the
			//viewPort property is set, so let's be sure they get saved.
			this._scroller.viewPort = null;
			this._viewPort.width = VIEW_PORT_WIDTH;
			this._viewPort.height = VIEW_PORT_HEIGHT;
			this._viewPort.height = VIEW_PORT_HEIGHT;
			this._viewPort.minWidth = VIEW_PORT_MIN_WIDTH;
			this._viewPort.minHeight = VIEW_PORT_MIN_HEIGHT;
			this._scroller.viewPort = this._viewPort;
			this._scroller.validate();
			var oldMaxHSP:Number = this._scroller.maxHorizontalScrollPosition;
			var oldMaxVSP:Number = this._scroller.maxVerticalScrollPosition;
			this._viewPort.resizeOnScroll = true;
			this._scroller.verticalScrollPosition++;
			this._scroller.validate();

			Assert.assertTrue("The maxHorizontalScrollPosition of the Scroller did not change correctly when view port width changed during scrolling.",
				oldMaxHSP !== this._scroller.maxHorizontalScrollPosition);
			Assert.assertTrue("The maxVerticalScrollPosition of the Scroller did not change correctly when view port height changed during scrolling.",
				oldMaxVSP !== this._scroller.maxVerticalScrollPosition);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ScrollerTests.as
================================================
package feathers.tests
{
	import feathers.controls.Scroller;
	import feathers.events.FeathersEventType;
	import feathers.tests.supportClasses.DisposeFlagQuad;
	import feathers.tests.supportClasses.ScrollerViewPort;

	import flash.geom.Point;

	import org.flexunit.Assert;
	import org.flexunit.async.Async;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class ScrollerTests
	{
		private static const BACKGROUND_WIDTH:Number = 200;
		private static const BACKGROUND_HEIGHT:Number = 250;
		
		private static const LARGE_VIEW_PORT_WIDTH:Number = 1000;
		private static const LARGE_VIEW_PORT_HEIGHT:Number = 1100;

		private static const SMALL_VIEW_PORT_WIDTH:Number = 100;
		private static const SMALL_VIEW_PORT_HEIGHT:Number = 105;

		private static const NEGATIVE_CONTENT_X:Number = -10;
		private static const NEGATIVE_CONTENT_Y:Number = -12;

		private static const VERTICAL_DRAG_OFFSET:Number = 100;
		private static const HORIZONTAL_DRAG_OFFSET:Number = 90;
		
		private var _scroller:Scroller;
		private var _viewPort:ScrollerViewPort;

		[Before]
		public function prepare():void
		{
			this._viewPort = new ScrollerViewPort();
			
			this._scroller = new Scroller();
			this._scroller.viewPort = this._viewPort;
			TestFeathers.starlingRoot.addChild(this._scroller);
		}

		[After]
		public function cleanup():void
		{
			this._scroller.removeFromParent(true);
			this._scroller = null;

			this._viewPort = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testSkinsDisposed():void
		{
			var backgroundSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._scroller.backgroundSkin = backgroundSkin;
			var backgroundDisabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._scroller.backgroundDisabledSkin = backgroundDisabledSkin;
			this._scroller.validate();
			this._scroller.dispose();
			Assert.assertTrue("backgroundSkin not disposed when Scroller disposed.", backgroundSkin.isDisposed);
			Assert.assertTrue("backgroundDisabledSkin not disposed when Scroller disposed.", backgroundDisabledSkin.isDisposed);
		}

		[Test]
		public function testResizeBackgroundWithSmallerMaxDimensions():void
		{
			this._scroller.maxWidth = BACKGROUND_WIDTH / 3;
			this._scroller.maxHeight = BACKGROUND_HEIGHT / 3;
			var backgroundSkin:Quad = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT);
			this._scroller.backgroundSkin = backgroundSkin;
			this._scroller.validate();
			Assert.assertStrictlyEquals("The Scroller with smaller maxWidth did not set the width of the background skin.",
				this._scroller.maxWidth, backgroundSkin.width);
			Assert.assertStrictlyEquals("The Scroller with smaller maxHeight did not set the height of the background skin.",
				this._scroller.maxHeight, backgroundSkin.height);
		}

		[Test]
		public function testResizeBackgroundWithLargerMinDimensions():void
		{
			this._scroller.minWidth = 3 * BACKGROUND_WIDTH;
			this._scroller.minHeight = 3 * BACKGROUND_HEIGHT;
			var backgroundSkin:Quad = new Quad(BACKGROUND_WIDTH, BACKGROUND_HEIGHT);
			this._scroller.backgroundSkin = backgroundSkin;
			this._scroller.validate();
			Assert.assertStrictlyEquals("The Scroller with larger minWidth did not set the width of the background skin.",
				this._scroller.minWidth, backgroundSkin.width);
			Assert.assertStrictlyEquals("The Scroller with larger minHeight did not set the height of the background skin.",
				this._scroller.minHeight, backgroundSkin.height);
		}

		[Test]
		public function testMaxVerticalScrollPositionWithLargerViewPortHeight():void
		{
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.height = LARGE_VIEW_PORT_HEIGHT;
			this._scroller.validate();
			Assert.assertStrictlyEquals("The maxVerticalScrollPosition of the scroller was not calculated correctly with a larger view port height.",
				LARGE_VIEW_PORT_HEIGHT - BACKGROUND_HEIGHT, this._scroller.maxVerticalScrollPosition);
		}

		[Test]
		public function testMaxHorizontalScrollPositionWithLargerViewPortWidth():void
		{
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = LARGE_VIEW_PORT_WIDTH;
			this._scroller.validate();
			Assert.assertStrictlyEquals("The maxHorizontalScrollPosition of the scroller was not calculated correctly with a larger view port width.",
				LARGE_VIEW_PORT_WIDTH - BACKGROUND_WIDTH, this._scroller.maxHorizontalScrollPosition);
		}

		[Test]
		public function testMaxVerticalScrollPositionWithSmallerViewPortHeight():void
		{
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.height = SMALL_VIEW_PORT_HEIGHT;
			this._scroller.validate();
			Assert.assertStrictlyEquals("The maxVerticalScrollPosition of the scroller was not calculated correctly with a smaller view port height.",
				0, this._scroller.maxVerticalScrollPosition);
		}

		[Test]
		public function testMaxHorizontalScrollPositionWithSmallerViewPortWidth():void
		{
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = SMALL_VIEW_PORT_WIDTH;
			this._scroller.validate();
			Assert.assertStrictlyEquals("The maxHorizontalScrollPosition of the scroller was not calculated correctly with a smaller view port width.",
				0, this._scroller.maxHorizontalScrollPosition);
		}

		[Test]
		public function testDefaultMinVerticalScrollPosition():void
		{
			this._scroller.validate();
			Assert.assertStrictlyEquals("The default minVerticalScrollPosition of the scroller was not calculated correctly.",
				0, this._scroller.minVerticalScrollPosition);
		}

		[Test]
		public function testDefaultMinHorizontalScrollPosition():void
		{
			this._scroller.validate();
			Assert.assertStrictlyEquals("The default minHorizontalScrollPosition of the scroller was not calculated correctly.",
				0, this._scroller.minHorizontalScrollPosition);
		}

		[Test]
		public function testMinVerticalScrollPositionWithNegativeContentY():void
		{
			this._viewPort.contentY = NEGATIVE_CONTENT_Y;
			this._scroller.validate();
			Assert.assertStrictlyEquals("The minVerticalScrollPosition of the scroller was not calculated correctly with contentY < 0.",
				NEGATIVE_CONTENT_Y, this._scroller.minVerticalScrollPosition);
		}

		[Test]
		public function testMinHorizontalScrollPositionWithNegativeContentX():void
		{
			this._viewPort.contentX = NEGATIVE_CONTENT_X;
			this._scroller.validate();
			Assert.assertStrictlyEquals("The minHorizontalScrollPosition of the scroller was not calculated correctly with contentX < 0.",
				NEGATIVE_CONTENT_X, this._scroller.minHorizontalScrollPosition);
		}

		[Test(async)]
		public function testDragVerticallyToScroll():void
		{
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = BACKGROUND_WIDTH;
			this._viewPort.height = LARGE_VIEW_PORT_HEIGHT;
			this._scroller.validate();

			var hasDispatchedScrollStart:Boolean = false;
			this._scroller.addEventListener(FeathersEventType.SCROLL_START, function(event:Event):void
			{
				hasDispatchedScrollStart = true;
			});
			
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._scroller.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			var self:Object = this;
			var scroller:Scroller = this._scroller;
			Async.delayCall(self, function():void
			{
				//move the touch a bit to start scrolling
				//it won't have changed the scroll position yet, though
				touch.globalY = -VERTICAL_DRAG_OFFSET;
				touch.phase = TouchPhase.MOVED;
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
				Async.delayCall(self, function():void
				{
					Assert.assertTrue("Scroller FeathersEventType.SCROLL_START was not dispatched when dragging", hasDispatchedScrollStart);
					Assert.assertTrue("Scroller isScrolling was not set to true when dragging", scroller.isScrolling);

					//move the touch a bit more to drag
					touch.globalY = 2 * -VERTICAL_DRAG_OFFSET;
					touch.phase = TouchPhase.MOVED;
					target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
				
					Async.delayCall(self, function():void
					{
						touch.phase = TouchPhase.ENDED;
						target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
						
						Assert.assertTrue("Scroller verticalScrollPosition must change when dragged vertically:",
							scroller.verticalScrollPosition > 0);
					}, 25);
				}, 25);
			}, 25);
		}

		[Test(async)]
		public function testDragHorizontallyToScroll():void
		{
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = LARGE_VIEW_PORT_WIDTH;
			this._viewPort.height = BACKGROUND_HEIGHT;
			this._scroller.validate();

			var hasDispatchedScrollStart:Boolean = false;
			this._scroller.addEventListener(FeathersEventType.SCROLL_START, function(event:Event):void
			{
				hasDispatchedScrollStart = true;
			});

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._scroller.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			var self:Object = this;
			var scroller:Scroller = this._scroller;
			Async.delayCall(self, function():void
			{
				//move the touch a bit to start scrolling
				//it won't have changed the scroll position yet, though
				touch.globalX = -HORIZONTAL_DRAG_OFFSET;
				touch.phase = TouchPhase.MOVED;
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
				Async.delayCall(self, function():void
				{
					Assert.assertTrue("Scroller FeathersEventType.SCROLL_START was not dispatched when dragging", hasDispatchedScrollStart);
					Assert.assertTrue("Scroller isScrolling was not set to true when dragging", scroller.isScrolling);

					//move the touch a bit more to drag
					touch.globalX = 2 * -HORIZONTAL_DRAG_OFFSET;
					touch.phase = TouchPhase.MOVED;
					target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

					Async.delayCall(self, function():void
					{
						touch.phase = TouchPhase.ENDED;
						target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

						Assert.assertTrue("Scroller horizontalScrollPosition must change when dragged horizontally:",
							scroller.horizontalScrollPosition > 0);
					}, 25);
				}, 25);
			}, 25);
		}

		[Test(async)]
		public function testDragVerticallyBeyondMaxWithElasticEdges():void
		{
			this._scroller.hasElasticEdges = true;
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = BACKGROUND_WIDTH;
			this._viewPort.height = LARGE_VIEW_PORT_HEIGHT;
			this._scroller.validate();

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._scroller.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			var self:Object = this;
			var scroller:Scroller = this._scroller;
			Async.delayCall(self, function():void
			{
				//move the touch a bit to start scrolling
				//it won't have changed the scroll position yet, though
				touch.globalY = -VERTICAL_DRAG_OFFSET;
				touch.phase = TouchPhase.MOVED;
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

				Async.delayCall(self, function():void
				{
					//move the touch well beyond the maximum edge
					touch.globalY = 2 * -LARGE_VIEW_PORT_HEIGHT;
					touch.phase = TouchPhase.MOVED;
					target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

					Async.delayCall(self, function():void
					{
						touch.phase = TouchPhase.ENDED;
						target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
						Assert.assertTrue("Scroller: verticalScrollPosition must be able to be larger than maxVerticalScrollPosition when dragging with elastic edges",
							scroller.verticalScrollPosition > scroller.maxVerticalScrollPosition);
					}, 25);
				}, 25);
			}, 25);
		}

		[Test(async)]
		public function testDragVerticallyBeyondMaxWithoutElasticEdges():void
		{
			this._scroller.hasElasticEdges = false;
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = BACKGROUND_WIDTH;
			this._viewPort.height = LARGE_VIEW_PORT_HEIGHT;
			this._scroller.validate();

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._scroller.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			var self:Object = this;
			var scroller:Scroller = this._scroller;
			Async.delayCall(self, function():void
			{
				//move the touch a bit to start scrolling
				//it won't have changed the scroll position yet, though
				touch.globalY = -VERTICAL_DRAG_OFFSET;
				touch.phase = TouchPhase.MOVED;
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

				Async.delayCall(self, function():void
				{
					//move the touch well beyond the maximum edge
					touch.globalY = 2 * -LARGE_VIEW_PORT_HEIGHT;
					touch.phase = TouchPhase.MOVED;
					target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

					Async.delayCall(self, function():void
					{
						touch.phase = TouchPhase.ENDED;
						target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
						Assert.assertStrictlyEquals("Scroller: verticalScrollPosition must be equal to maxVerticalScrollPosition when dragging without elastic edges",
							scroller.maxVerticalScrollPosition, scroller.verticalScrollPosition);
					}, 25);
				}, 25);
			}, 25);
		}

		[Test(async)]
		public function testDragVerticallyBeyondMinWithElasticEdges():void
		{
			this._scroller.hasElasticEdges = true;
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = BACKGROUND_WIDTH;
			this._viewPort.height = LARGE_VIEW_PORT_HEIGHT;
			this._scroller.validate();

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._scroller.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			var self:Object = this;
			var scroller:Scroller = this._scroller;
			Async.delayCall(self, function():void
			{
				//move the touch a bit to start scrolling
				//it won't have changed the scroll position yet, though
				touch.globalY = VERTICAL_DRAG_OFFSET;
				touch.phase = TouchPhase.MOVED;
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

				Async.delayCall(self, function():void
				{
					//move the touch well beyond the maximum edge
					touch.globalY = 2 * LARGE_VIEW_PORT_HEIGHT;
					touch.phase = TouchPhase.MOVED;
					target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

					Async.delayCall(self, function():void
					{
						touch.phase = TouchPhase.ENDED;
						target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
						Assert.assertTrue("Scroller: verticalScrollPosition must be able to be smaller than minVerticalScrollPosition when dragging with elastic edges",
							scroller.verticalScrollPosition < scroller.minVerticalScrollPosition);
					}, 25);
				}, 25);
			}, 25);
		}

		[Test(async)]
		public function testDragVerticallyBeyondMinWithoutElasticEdges():void
		{
			this._scroller.hasElasticEdges = false;
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = BACKGROUND_WIDTH;
			this._viewPort.height = LARGE_VIEW_PORT_HEIGHT;
			this._scroller.validate();

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._scroller.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			var self:Object = this;
			var scroller:Scroller = this._scroller;
			Async.delayCall(self, function():void
			{
				//move the touch a bit to start scrolling
				//it won't have changed the scroll position yet, though
				touch.globalY = VERTICAL_DRAG_OFFSET;
				touch.phase = TouchPhase.MOVED;
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

				Async.delayCall(self, function():void
				{
					//move the touch well beyond the maximum edge
					touch.globalY = 2 * LARGE_VIEW_PORT_HEIGHT;
					touch.phase = TouchPhase.MOVED;
					target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

					Async.delayCall(self, function():void
					{
						touch.phase = TouchPhase.ENDED;
						target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
						Assert.assertStrictlyEquals("Scroller: verticalScrollPosition must be equal to minVerticalScrollPosition when dragging without elastic edges",
							scroller.minVerticalScrollPosition, scroller.verticalScrollPosition);
					}, 25);
				}, 25);
			}, 25);
		}

		[Test(async)]
		public function testDragHorizontallyBeyondMaxWithElasticEdges():void
		{
			this._scroller.hasElasticEdges = true;
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = LARGE_VIEW_PORT_WIDTH;
			this._viewPort.height = BACKGROUND_HEIGHT;
			this._scroller.validate();

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._scroller.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			var self:Object = this;
			var scroller:Scroller = this._scroller;
			Async.delayCall(self, function():void
			{
				//move the touch a bit to start scrolling
				//it won't have changed the scroll position yet, though
				touch.globalX = -HORIZONTAL_DRAG_OFFSET;
				touch.phase = TouchPhase.MOVED;
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

				Async.delayCall(self, function():void
				{
					//move the touch well beyond the maximum edge
					touch.globalX = 2 * -LARGE_VIEW_PORT_WIDTH;
					touch.phase = TouchPhase.MOVED;
					target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

					Async.delayCall(self, function():void
					{
						touch.phase = TouchPhase.ENDED;
						target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
						Assert.assertTrue("Scroller: horizontalScrollPosition must be able to be larger than maxHorizontalScrollPosition when dragging with elastic edges",
							scroller.horizontalScrollPosition > scroller.maxHorizontalScrollPosition);
					}, 25);
				}, 25);
			}, 25);
		}

		[Test(async)]
		public function testDragHorizontallyBeyondMaxWithoutElasticEdges():void
		{
			this._scroller.hasElasticEdges = false;
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = LARGE_VIEW_PORT_WIDTH;
			this._viewPort.height = BACKGROUND_HEIGHT;
			this._scroller.validate();

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._scroller.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			var self:Object = this;
			var scroller:Scroller = this._scroller;
			Async.delayCall(self, function():void
			{
				//move the touch a bit to start scrolling
				//it won't have changed the scroll position yet, though
				touch.globalX = -HORIZONTAL_DRAG_OFFSET;
				touch.phase = TouchPhase.MOVED;
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

				Async.delayCall(self, function():void
				{
					//move the touch well beyond the maximum edge
					touch.globalX = 2 * -LARGE_VIEW_PORT_WIDTH;
					touch.phase = TouchPhase.MOVED;
					target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

					Async.delayCall(self, function():void
					{
						touch.phase = TouchPhase.ENDED;
						target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
						Assert.assertStrictlyEquals("Scroller: horizontalScrollPosition must be equal to maxHorizontalScrollPosition when dragging with elastic edges",
							scroller.maxHorizontalScrollPosition, scroller.horizontalScrollPosition);
					}, 25);
				}, 25);
			}, 25);
		}

		[Test(async)]
		public function testDragHorizontallyBeyondMinWithElasticEdges():void
		{
			this._scroller.hasElasticEdges = true;
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = LARGE_VIEW_PORT_WIDTH;
			this._viewPort.height = BACKGROUND_HEIGHT;
			this._scroller.validate();

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._scroller.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			var self:Object = this;
			var scroller:Scroller = this._scroller;
			Async.delayCall(self, function():void
			{
				//move the touch a bit to start scrolling
				//it won't have changed the scroll position yet, though
				touch.globalX = HORIZONTAL_DRAG_OFFSET;
				touch.phase = TouchPhase.MOVED;
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

				Async.delayCall(self, function():void
				{
					//move the touch well beyond the maximum edge
					touch.globalX = 2 * LARGE_VIEW_PORT_WIDTH;
					touch.phase = TouchPhase.MOVED;
					target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

					Async.delayCall(self, function():void
					{
						touch.phase = TouchPhase.ENDED;
						target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
						Assert.assertTrue("Scroller: horizontalScrollPosition must be able to be smaller than minHorizontalScrollPosition when dragging with elastic edges",
							scroller.horizontalScrollPosition < scroller.minHorizontalScrollPosition);
					}, 25);
				}, 25);
			}, 25);
		}

		[Test(async)]
		public function testDragHorizontallyBeyondMinWithoutElasticEdges():void
		{
			this._scroller.hasElasticEdges = false;
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = LARGE_VIEW_PORT_WIDTH;
			this._viewPort.height = BACKGROUND_HEIGHT;
			this._scroller.validate();

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._scroller.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			var self:Object = this;
			var scroller:Scroller = this._scroller;
			Async.delayCall(self, function():void
			{
				//move the touch a bit to start scrolling
				//it won't have changed the scroll position yet, though
				touch.globalX = HORIZONTAL_DRAG_OFFSET;
				touch.phase = TouchPhase.MOVED;
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

				Async.delayCall(self, function():void
				{
					//move the touch well beyond the maximum edge
					touch.globalX = 2 * LARGE_VIEW_PORT_WIDTH;
					touch.phase = TouchPhase.MOVED;
					target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

					Async.delayCall(self, function():void
					{
						touch.phase = TouchPhase.ENDED;
						target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
						Assert.assertStrictlyEquals("Scroller: horizontalScrollPosition must be equal to minHorizontalScrollPosition when dragging with elastic edges",
							scroller.minHorizontalScrollPosition, scroller.horizontalScrollPosition);
					}, 25);
				}, 25);
			}, 25);
		}

		[Test(async)]
		public function testScrollCompleteEventOnRemovedFromStage():void
		{
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = LARGE_VIEW_PORT_WIDTH;
			this._viewPort.height = BACKGROUND_HEIGHT;
			this._scroller.validate();

			var hasDispatchedScrollComplete:Boolean = false;
			this._scroller.addEventListener(FeathersEventType.SCROLL_COMPLETE, function(event:Event):void
			{
				hasDispatchedScrollComplete = true;
			});

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._scroller.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			var self:Object = this;
			var scroller:Scroller = this._scroller;
			Async.delayCall(this, function():void
			{
				touch.globalX = HORIZONTAL_DRAG_OFFSET; //move the touch a bit to drag
				touch.phase = TouchPhase.MOVED;
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

				Async.delayCall(self, function():void
				{
					touch.phase = TouchPhase.ENDED;
					target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
					
					scroller.removeFromParent();

					Assert.assertTrue("Scroller FeathersEventType.SCROLL_COMPLETE was not dispatched when removed from stage", hasDispatchedScrollComplete);
				}, 25);
			}, 25);
		}

		[Test]
		public function testNewMaskXPositionOnHorizontalScroll():void
		{
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = LARGE_VIEW_PORT_WIDTH;
			this._scroller.validate();
			this._scroller.horizontalScrollPosition = this._scroller.maxHorizontalScrollPosition / 2;
			this._scroller.validate();
			Assert.assertStrictlyEquals("The mask x position of the scroller's view port was not calculated correctly with horizontalScrollPosition > 0.",
				this._scroller.maxHorizontalScrollPosition / 2, this._viewPort.mask.x);
		}

		[Test]
		public function testNewMaskYPositionOnVerticalScroll():void
		{
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.height = LARGE_VIEW_PORT_HEIGHT;
			this._scroller.validate();
			this._scroller.verticalScrollPosition = this._scroller.maxVerticalScrollPosition / 2;
			this._scroller.validate();
			Assert.assertStrictlyEquals("The mask y position of the scroller's view port was not calculated correctly with verticalScrollPosition > 0.",
				this._scroller.maxVerticalScrollPosition / 2, this._viewPort.mask.y);
		}

		[Test]
		public function testAutoHideBackgroundWithoutScrolling():void
		{
			this._scroller.backgroundSkin = new Quad(1, 1, 0xff00ff);
			this._scroller.autoHideBackground = true;
			this._scroller.validate();
			Assert.assertTrue("Background is incorrectly hidden.", this._scroller.backgroundSkin.visible);
		}

		[Test]
		public function testScrollToPositionWithZeroDuration():void
		{
			var hasDispatchedScrollStart:Boolean = false;
			this._scroller.addEventListener(FeathersEventType.SCROLL_START, function(event:Event):void
			{
				hasDispatchedScrollStart = true;
			});
			var hasDispatchedScrollComplete:Boolean = false;
			this._scroller.addEventListener(FeathersEventType.SCROLL_COMPLETE, function(event:Event):void
			{
				hasDispatchedScrollComplete = true;
			});
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = LARGE_VIEW_PORT_WIDTH;
			this._viewPort.height = BACKGROUND_HEIGHT;
			this._scroller.validate();
			var targetPosition:Number = LARGE_VIEW_PORT_WIDTH - BACKGROUND_WIDTH;
			this._scroller.scrollToPosition(targetPosition, 0, 0);
			this._scroller.validate();
			Assert.assertStrictlyEquals("Scroller: scrollToPosition() did not scroll to correct position",
				targetPosition, this._scroller.horizontalScrollPosition);
			Assert.assertTrue("Scroller: scrollToPosition() with duration 0 did not dispatch FeathersEventType.SCROLL_START",
				hasDispatchedScrollStart);
			Assert.assertTrue("Scroller: scrollToPosition() with duration 0 did not dispatch FeathersEventType.SCROLL_COMPLETE",
				hasDispatchedScrollComplete);
		}

		[Test]
		public function testScrollToPageIndexWithZeroDuration():void
		{
			var hasDispatchedScrollStart:Boolean = false;
			this._scroller.addEventListener(FeathersEventType.SCROLL_START, function(event:Event):void
			{
				hasDispatchedScrollStart = true;
			});
			var hasDispatchedScrollComplete:Boolean = false;
			this._scroller.addEventListener(FeathersEventType.SCROLL_COMPLETE, function(event:Event):void
			{
				hasDispatchedScrollComplete = true;
			});
			this._scroller.snapToPages = true;
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = LARGE_VIEW_PORT_WIDTH;
			this._viewPort.height = BACKGROUND_HEIGHT;
			this._scroller.validate();
			this._scroller.scrollToPageIndex(2, 0, 0);
			this._scroller.validate();
			Assert.assertStrictlyEquals("Scroller: scrollToPageIndex() did not scroll to correct page",
				2, this._scroller.horizontalPageIndex);
			Assert.assertTrue("Scroller: scrollToPageIndex() with duration 0 did not dispatch FeathersEventType.SCROLL_START",
				hasDispatchedScrollStart);
			Assert.assertTrue("Scroller: scrollToPageIndex() with duration 0 did not dispatch FeathersEventType.SCROLL_COMPLETE",
				hasDispatchedScrollComplete);
		}

		[Test(async,timeout="1500")]
		public function testStopScrollingOnThrow():void
		{
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = LARGE_VIEW_PORT_WIDTH;
			this._viewPort.height = BACKGROUND_HEIGHT;
			this._scroller.validate();
			this._scroller.scrollToPosition(LARGE_VIEW_PORT_WIDTH - BACKGROUND_WIDTH, 0, 1.0);
			this._scroller.validate();
			var stopScrollPosition:Number = 0;
			var scroller:Scroller = this._scroller;
			Async.delayCall(this, function():void
			{
				stopScrollPosition = _scroller.horizontalScrollPosition;
				scroller.stopScrolling();
			}, 500);
			Async.delayCall(this, function():void
			{
				Assert.assertStrictlyEquals("After scrollToPosition(), stopScrolling() did not stop scrolling before duration complete. Scroll position does not match.",
					stopScrollPosition, scroller.horizontalScrollPosition);
			}, 1000);
		}

		[Test(async)]
		public function testStopScrollingOnDrag():void
		{
			this._scroller.width = BACKGROUND_WIDTH;
			this._scroller.height = BACKGROUND_HEIGHT;
			this._viewPort.width = LARGE_VIEW_PORT_WIDTH;
			this._viewPort.height = BACKGROUND_HEIGHT;
			this._scroller.validate();

			var stopScrollPosition:Number = 0;

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._scroller.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			var self:Object = this;
			var scroller:Scroller = this._scroller;
			Async.delayCall(this, function():void
			{
				touch.globalX = HORIZONTAL_DRAG_OFFSET; //move the touch a bit to drag
				touch.phase = TouchPhase.MOVED;
				target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
				scroller.stopScrolling();
				stopScrollPosition = scroller.horizontalScrollPosition;

				Async.delayCall(self, function():void
				{
					touch.globalX = 2 * HORIZONTAL_DRAG_OFFSET; //drag more
					touch.phase = TouchPhase.MOVED;
					target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

					touch.phase = TouchPhase.ENDED;
					target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

					Assert.assertStrictlyEquals("After touch drag, stopScrolling() did not stop scrolling if dragged further. Scroll position does not match.",
						stopScrollPosition, scroller.horizontalScrollPosition);
				}, 25);
			}, 25);
		}
	}
}


================================================
FILE: test/source/feathers/tests/SimpleScrollBarHorizontalTests.as
================================================
package feathers.tests
{
	import feathers.controls.Button;
	import feathers.controls.SimpleScrollBar;
	import feathers.layout.Direction;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class SimpleScrollBarHorizontalTests
	{
		private static const THUMB_NAME:String = "thumb";
		private static const THUMB_WIDTH:Number = 20;
		private static const THUMB_HEIGHT:Number = 20;
		private static const SCROLL_BAR_WIDTH:Number = 200;

		private var _scrollBar:SimpleScrollBar;

		[Before]
		public function prepare():void
		{
			this._scrollBar = new SimpleScrollBar();
			this._scrollBar.direction = Direction.HORIZONTAL;
			this._scrollBar.thumbFactory = function():Button
			{
				var thumb:Button = new Button();
				thumb.name = THUMB_NAME;
				thumb.defaultSkin = new Quad(THUMB_WIDTH, THUMB_HEIGHT);
				return thumb;
			};
			this._scrollBar.width = SCROLL_BAR_WIDTH;
			TestFeathers.starlingRoot.addChild(this._scrollBar);
			this._scrollBar.validate();
		}

		[After]
		public function cleanup():void
		{
			this._scrollBar.removeFromParent(true);
			this._scrollBar = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testSingleTrackAutoSize():void
		{
			Assert.assertStrictlyEquals("The height of the scroll bar was not calculated correctly.",
				THUMB_HEIGHT, this._scrollBar.height);
		}

		[Test]
		public function testSetValueProgramaticallyWithMinimum():void
		{
			this._scrollBar.clampToRange = true;
			this._scrollBar.minimum = 5;
			this._scrollBar.maximum = 10;
			this._scrollBar.value = 2;
			Assert.assertEquals("Setting value smaller than minimum not changed to minimum.", this._scrollBar.minimum, this._scrollBar.value);
		}

		[Test]
		public function testSetValueProgramaticallyWithMaximum():void
		{
			this._scrollBar.clampToRange = true;
			this._scrollBar.minimum = 5;
			this._scrollBar.maximum = 10;
			this._scrollBar.value = 12;
			Assert.assertEquals("Setting value larger than maximum not changed to maximum.", this._scrollBar.maximum, this._scrollBar.value);
		}

		[Test]
		public function testProgrammaticSelectionChange():void
		{
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = 1;
			this._scrollBar.page = 2;
			this._scrollBar.value = 5;
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._scrollBar.value = 6;
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
		}

		[Test]
		public function testInteractiveSelectionChangeWithDraggingThumb():void
		{
			var beforeValue:Number = 5;
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = 1;
			this._scrollBar.page = 2;
			this._scrollBar.value = beforeValue;
			//validate to position the thumb correctly.
			this._scrollBar.validate();
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(SCROLL_BAR_WIDTH / 2, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._scrollBar.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the scroll bar's thumb",
				this._scrollBar.getChildByName(THUMB_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.MOVED;
			touch.globalX = position.x + THUMB_WIDTH * 2;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("The value property was not changed to a greater value",
				beforeValue < this._scrollBar.value);
		}

		[Test]
		public function testInteractiveSelectionChangeWithDraggingThumbBeyondRightEdgeOfTrack():void
		{
			var beforeValue:Number = 5;
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = 1;
			this._scrollBar.page = 2;
			this._scrollBar.value = beforeValue;
			//validate to position the thumb correctly.
			this._scrollBar.validate();
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(SCROLL_BAR_WIDTH / 2, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._scrollBar.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the scroll bar's thumb",
				this._scrollBar.getChildByName(THUMB_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.MOVED;
			touch.globalX = position.x + SCROLL_BAR_WIDTH;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The value property was not equal to the maximum value",
				this._scrollBar.maximum, this._scrollBar.value);
		}

		[Test]
		public function testInteractiveSelectionChangeWithDraggingThumbBeyondLeftEdgeOfTrack():void
		{
			var beforeValue:Number = 5;
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = 1;
			this._scrollBar.page = 2;
			this._scrollBar.value = beforeValue;
			//validate to position the thumb correctly.
			this._scrollBar.validate();
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(SCROLL_BAR_WIDTH / 2, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._scrollBar.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the scroll bar's thumb",
				this._scrollBar.getChildByName(THUMB_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.MOVED;
			touch.globalX = position.x - SCROLL_BAR_WIDTH;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The value property was not equal to the minimum value",
				this._scrollBar.minimum, this._scrollBar.value);
		}

		[Test]
		public function testInteractiveSelectionChangeWithTouchToLeftOfThumb():void
		{
			var beforeValue:Number = 5;
			var page:Number = 2;
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = 1;
			this._scrollBar.page = page;
			this._scrollBar.value = beforeValue;
			//validate to position the thumb correctly.
			this._scrollBar.validate();
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(SCROLL_BAR_WIDTH / 4, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._scrollBar.stage.hitTest(position);
			
			Assert.assertTrue("The hit test did not return a display object contained by the scroll bar",
				this._scrollBar.contains(target));
			Assert.assertFalse("The hit test incorrectly returned the scroll bar's thumb",
				this._scrollBar.getChildByName(THUMB_NAME).name === target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The value property was not equal to the previous value minus the page",
				beforeValue - page, this._scrollBar.value);
		}

		[Test]
		public function testInteractiveSelectionChangeWithTouchToRightOfThumb():void
		{
			var beforeValue:Number = 5;
			var page:Number = 2;
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = 1;
			this._scrollBar.page = page;
			this._scrollBar.value = beforeValue;
			//validate to position the thumb correctly.
			this._scrollBar.validate();
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(3 * SCROLL_BAR_WIDTH / 4, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._scrollBar.stage.hitTest(position);

			Assert.assertTrue("The hit test did not return a display object contained by the scroll bar",
				this._scrollBar.contains(target));
			Assert.assertFalse("The hit test incorrectly returned the scroll bar's thumb",
				this._scrollBar.getChildByName(THUMB_NAME).name === target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The value property was not equal to the previous value plus the page",
				beforeValue + page, this._scrollBar.value);
		}

		[Test]
		public function testFallBackToStepWhenPageIsZero():void
		{
			var beforeValue:Number = 5;
			var step:Number = 1;
			this._scrollBar.minimum = 0;
			this._scrollBar.maximum = 10;
			this._scrollBar.step = step;
			this._scrollBar.page = 0;
			this._scrollBar.value = beforeValue;
			//validate to position the thumb correctly.
			this._scrollBar.validate();
			var hasChanged:Boolean = false;
			this._scrollBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(SCROLL_BAR_WIDTH / 3, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._scrollBar.stage.hitTest(position);

			Assert.assertTrue("The hit test did not return a display object contained by the scroll bar",
				this._scrollBar.contains(target));
			Assert.assertFalse("The hit test incorrectly returned the scroll bar's thumb",
				this._scrollBar.getChildByName(THUMB_NAME).name === target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertStrictlyEquals("The value property was not equal to the the previous value minus the step value",
				beforeValue - step, this._scrollBar.value);
		}
	}
}


================================================
FILE: test/source/feathers/tests/SimpleScrollBarMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.BasicButton;
	import feathers.controls.SimpleScrollBar;
	import feathers.layout.Direction;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class SimpleScrollBarMeasurementTests
	{
		private static const HORIZONTAL_THUMB_WIDTH:Number = 25;
		private static const HORIZONTAL_THUMB_HEIGHT:Number = 20;
		private static const HORIZONTAL_THUMB_MIN_WIDTH:Number = 16;
		private static const HORIZONTAL_THUMB_MIN_HEIGHT:Number = 14;

		private static const VERTICAL_THUMB_WIDTH:Number = 15;
		private static const VERTICAL_THUMB_HEIGHT:Number = 18;
		private static const VERTICAL_THUMB_MIN_WIDTH:Number = 10;
		private static const VERTICAL_THUMB_MIN_HEIGHT:Number = 12;
		
		private static const MINIMUM:Number = 0;
		private static const MAXIMUM:Number = 100;
		private static const STEP:Number = 1;
		private static const PAGE:Number = 10;
		
		private var _scrollBar:SimpleScrollBar;

		[Before]
		public function prepare():void
		{
			this._scrollBar = new SimpleScrollBar();
			TestFeathers.starlingRoot.addChild(this._scrollBar);
		}

		[After]
		public function cleanup():void
		{
			this._scrollBar.removeFromParent(true);
			this._scrollBar = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testAutoSizeHorizontal():void
		{
			this._scrollBar.direction = Direction.HORIZONTAL;
			this._scrollBar.minimum = MINIMUM;
			this._scrollBar.maximum = MAXIMUM;
			this._scrollBar.step = STEP;
			this._scrollBar.page = PAGE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(HORIZONTAL_THUMB_WIDTH, HORIZONTAL_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.validate();

			Assert.assertStrictlyEquals("The width of the horizontal SimpleScrollBar was not calculated correctly.",
				HORIZONTAL_THUMB_WIDTH * (MAXIMUM - MINIMUM) / PAGE, this._scrollBar.width);
			Assert.assertStrictlyEquals("The minWidth of the horizontal SimpleScrollBar was not calculated correctly.",
				HORIZONTAL_THUMB_WIDTH * (MAXIMUM - MINIMUM) / PAGE, this._scrollBar.minWidth);
			Assert.assertStrictlyEquals("The height of the horizontal SimpleScrollBar was not calculated correctly.",
				HORIZONTAL_THUMB_HEIGHT, this._scrollBar.height);
			Assert.assertStrictlyEquals("The minHeight of the horizontal SimpleScrollBar was not calculated correctly.",
				HORIZONTAL_THUMB_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeVertical():void
		{
			this._scrollBar.direction = Direction.VERTICAL;
			this._scrollBar.minimum = MINIMUM;
			this._scrollBar.maximum = MAXIMUM;
			this._scrollBar.step = STEP;
			this._scrollBar.page = PAGE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(VERTICAL_THUMB_WIDTH, VERTICAL_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The width of the vertical SimpleScrollBar was not calculated correctly.",
				VERTICAL_THUMB_WIDTH, this._scrollBar.width);
			Assert.assertStrictlyEquals("The minWidth of the vertical SimpleScrollBar was not calculated correctly.",
				VERTICAL_THUMB_WIDTH, this._scrollBar.minWidth);
			Assert.assertStrictlyEquals("The height of the horizontal SimpleScrollBar was not calculated correctly.",
				VERTICAL_THUMB_HEIGHT * (MAXIMUM - MINIMUM) / PAGE, this._scrollBar.height);
			Assert.assertStrictlyEquals("The minHeight of the horizontal SimpleScrollBar was not calculated correctly.",
				VERTICAL_THUMB_HEIGHT * (MAXIMUM - MINIMUM) / PAGE, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeHorizontalWithMinDimensions():void
		{
			this._scrollBar.direction = Direction.HORIZONTAL;
			this._scrollBar.minimum = MINIMUM;
			this._scrollBar.maximum = MAXIMUM;
			this._scrollBar.step = STEP;
			this._scrollBar.page = PAGE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(HORIZONTAL_THUMB_WIDTH, HORIZONTAL_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = HORIZONTAL_THUMB_MIN_WIDTH;
				thumb.minHeight = HORIZONTAL_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minWidth of the horizontal SimpleScrollBar was not calculated correctly when thumb has minWidth.",
				HORIZONTAL_THUMB_MIN_WIDTH * (MAXIMUM - MINIMUM) / PAGE, this._scrollBar.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the horizontal SimpleScrollBar was not calculated correctly when thumb has minHeight.",
				HORIZONTAL_THUMB_MIN_HEIGHT, this._scrollBar.minHeight);
		}

		[Test]
		public function testAutoSizeVerticalWithMinDimensions():void
		{
			this._scrollBar.direction = Direction.VERTICAL;
			this._scrollBar.minimum = MINIMUM;
			this._scrollBar.maximum = MAXIMUM;
			this._scrollBar.step = STEP;
			this._scrollBar.page = PAGE;
			this._scrollBar.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(VERTICAL_THUMB_WIDTH, VERTICAL_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = VERTICAL_THUMB_MIN_WIDTH;
				thumb.minHeight = VERTICAL_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._scrollBar.validate();
			Assert.assertStrictlyEquals("The minWidth of the vertical SimpleScrollBar was not calculated correctly when thumb has minWidth.",
				VERTICAL_THUMB_MIN_WIDTH, this._scrollBar.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the horizontal SimpleScrollBar was not calculated correctly when thumb has minHeight.",
				VERTICAL_THUMB_MIN_HEIGHT * (MAXIMUM - MINIMUM) / PAGE, this._scrollBar.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/SlideShowLayoutTests.as
================================================
package feathers.tests
{
	import feathers.controls.Label;
	import feathers.controls.LayoutGroup;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.SlideShowLayout;
	import feathers.layout.ViewPortBounds;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import flash.geom.Point;
	import feathers.layout.Direction;

	public class SlideShowLayoutTests
	{
		private static const PADDING_TOP:Number = 6;
		private static const PADDING_RIGHT:Number = 8;
		private static const PADDING_BOTTOM:Number = 2;
		private static const PADDING_LEFT:Number = 10;
		private static const CHILD1_WIDTH:Number = 200;
		private static const CHILD1_HEIGHT:Number = 100;
		private static const CHILD2_WIDTH:Number = 150;
		private static const CHILD2_HEIGHT:Number = 75;
		private static const CHILD3_WIDTH:Number = 75;
		private static const CHILD3_HEIGHT:Number = 50;
		private static const CHILD4_WIDTH:Number = 10;
		private static const CHILD4_HEIGHT:Number = 20;

		private var _layout:SlideShowLayout;
		private var _child1:DisplayObject;
		private var _child2:DisplayObject;

		[Before]
		public function prepare():void
		{
			this._layout = new SlideShowLayout();
		}

		[After]
		public function cleanup():void
		{
			this._layout = null;
			if(this._child1 !== null)
			{
				this._child1.dispose();
				this._child1 = null;
			}
			if(this._child2 !== null)
			{
				this._child2.dispose();
				this._child2 = null;
			}
		}

		[Test]
		public function testLayoutResultWithNoItems():void
		{
			this._layout.useVirtualLayout = false;
			var result:LayoutBoundsResult = this._layout.layout(new <DisplayObject>[]);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortWidth not equal to 0 with no children.",
				0, result.viewPortWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortHeight not equal to 0 with no children.",
				0, result.viewPortHeight);
			Assert.assertStrictlyEquals("SlideShowLayout: contentWidth not equal to 0 with no children.",
				0, result.contentWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: contentHeight not equal to 0 with no children.",
				0, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithNoItems():void
		{
			this._layout.useVirtualLayout = true;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(0, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort x not equal to 0 with no children.",
				0, result.x);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort y not equal to 0 with no children.",
				0, result.y);
		}

		[Test]
		public function testLayoutResultWithPaddingAndNoChildren():void
		{
			this._layout.useVirtualLayout = false;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			var result:LayoutBoundsResult = this._layout.layout(new <DisplayObject>[]);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortWidth not equal to sum of left and right padding with no children.",
				PADDING_LEFT + PADDING_RIGHT, result.viewPortWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortHeight not equal to sum of top and bottom padding with no children.",
				PADDING_TOP + PADDING_BOTTOM, result.viewPortHeight);
			Assert.assertStrictlyEquals("SlideShowLayout: contentWidth not equal to sum of left and right padding with no children.",
				PADDING_LEFT + PADDING_RIGHT, result.contentWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: contentHeight not equal to sum of top and bottom padding with no children.",
				PADDING_TOP + PADDING_BOTTOM, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithPaddingAndNoChildren():void
		{
			this._layout.useVirtualLayout = true;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(0, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort x not equal to sum of left and right padding with no children.",
				PADDING_LEFT + PADDING_RIGHT, result.x);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort y not equal to sum of top and bottom padding with no children.",
				PADDING_TOP + PADDING_BOTTOM, result.y);
		}

		[Test]
		public function testLayoutResultWithOneChild():void
		{
			this._layout.useVirtualLayout = false;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var result:LayoutBoundsResult = this._layout.layout(new <DisplayObject>[this._child1]);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortWidth not equal to child width.",
				CHILD1_WIDTH, result.viewPortWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortHeight not equal to child height.",
				CHILD1_HEIGHT, result.viewPortHeight);
			Assert.assertStrictlyEquals("SlideShowLayout: contentWidth not equal to child width.",
				CHILD1_WIDTH, result.contentWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: contentHeight not equal to child height.",
				CHILD1_HEIGHT, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithOneChild():void
		{
			this._layout.useVirtualLayout = true;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.typicalItem = this._child1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort x not equal to child width.",
				CHILD1_WIDTH, result.x);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort y not equal to child height.",
				CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testLayoutResultWithPaddingAndOneChild():void
		{
			this._layout.useVirtualLayout = false;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[this._child1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortWidth not equal to child width plus left and right padding.",
				CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT, result.viewPortWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortHeight not equal to child height plus top and bottom padding.",
				CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, result.viewPortHeight);
			Assert.assertStrictlyEquals("SlideShowLayout: contentWidth not equal to child width plus left and right padding.",
				CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT, result.contentWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: contentHeight not equal to child height plus top and bottom padding.",
				CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithPaddingAndOneChild():void
		{
			this._layout.useVirtualLayout = true;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.typicalItem = this._child1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort x not equal to child width plus left and right padding.",
				CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT, result.x);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort y not equal to child height plus top and bottom padding.",
				CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, result.y);
		}

		[Test]
		public function testLayoutResultWithTwoChildrenPositionedHorizontally():void
		{
			this._layout.direction = Direction.HORIZONTAL;
			this._layout.useVirtualLayout = false;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._child2 = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[this._child1, this._child2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortWidth not equal to max child width.",
				Math.max(CHILD1_WIDTH, CHILD2_WIDTH), result.viewPortWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortHeight not equal to max child height.",
				Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT), result.viewPortHeight);
			Assert.assertStrictlyEquals("SlideShowLayout: contentWidth not equal to max child width multiplied by number of items.",
				2 * Math.max(CHILD1_WIDTH, CHILD2_WIDTH), result.contentWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: contentHeight not equal to max child height.",
				Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT), result.contentHeight);
		}

		[Test]
		public function testLayoutResultWithTwoChildrenPositionedVertically():void
		{
			this._layout.direction = Direction.VERTICAL;
			this._layout.useVirtualLayout = false;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._child2 = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[this._child1, this._child2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortWidth not equal to max child width.",
				Math.max(CHILD1_WIDTH, CHILD2_WIDTH), result.viewPortWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortHeight not equal to max child height.",
				Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT), result.viewPortHeight);
			Assert.assertStrictlyEquals("SlideShowLayout: contentWidth not equal to max child width.",
				Math.max(CHILD1_WIDTH, CHILD2_WIDTH), result.contentWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: contentHeight not equal to max child height multiplied by number of items.",
				2 * Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT), result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithTwoChildrenPositionedHorizontally():void
		{
			this._layout.direction = Direction.HORIZONTAL;
			this._layout.useVirtualLayout = true;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.typicalItem = this._child1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(2, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortWidth not equal to max child width.",
				Math.max(CHILD1_WIDTH, CHILD2_WIDTH), result.x);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortHeight not equal to max child height.",
				Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT), result.y);
		}

		[Test]
		public function testMeasureViewPortResultWithTwoChildrenPositionedVertically():void
		{
			this._layout.direction = Direction.VERTICAL;
			this._layout.useVirtualLayout = true;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.typicalItem = this._child1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(2, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort x not equal to max child width.",
				Math.max(CHILD1_WIDTH, CHILD2_WIDTH), result.x);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort y not equal to max child height.",
				Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT), result.y);
		}

		[Test]
		public function testLayoutResultWithExplicitWidthSmallerThanChild():void
		{
			this._layout.useVirtualLayout = false;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[this._child1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = CHILD1_WIDTH / 3;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortWidth not equal to explicitWidth when explicitWidth is smaller than item width.",
				bounds.explicitWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: contentWidth not equal to explicitWidth when explicitWidth is smaller than item width.",
				bounds.explicitWidth, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithExplicitWidthSmallerThanChild():void
		{
			this._layout.useVirtualLayout = true;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.typicalItem = this._child1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = CHILD1_WIDTH / 3;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort x not equal to explicitWidth when explicitWidth is smaller than item width.",
				bounds.explicitWidth, result.x);
		}

		[Test]
		public function testLayoutResultWithExplicitWidthLargerThanChild():void
		{
			this._layout.useVirtualLayout = false;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[this._child1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 3 * CHILD1_WIDTH;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortWidth not equal to explicitWidth when explicitWidth is larger than item width.",
				bounds.explicitWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: contentWidth not equal to explicitWidth when explicitWidth is larger than item width.",
				bounds.explicitWidth, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithExplicitWidthLargerThanChild():void
		{
			this._layout.useVirtualLayout = true;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.typicalItem = this._child1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 3 * CHILD1_WIDTH;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort x not equal to explicitWidth when explicitWidth is larger than item width.",
				bounds.explicitWidth, result.x);
		}

		[Test]
		public function testLayoutResultWithMaxWidthSmallerThanChild():void
		{
			this._layout.useVirtualLayout = false;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[this._child1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = CHILD1_WIDTH / 3;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortWidth not equal to maxWidth when maxWidth is smaller than item width.",
				bounds.maxWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: contentWidth not equal to maxWidth when maxWidth is smaller than item width.",
				bounds.maxWidth, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxWidthSmallerThanChild():void
		{
			this._layout.useVirtualLayout = true;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.typicalItem = this._child1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = CHILD1_WIDTH / 3;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort x not equal to maxWidth when maxWidth is smaller than item width.",
				bounds.maxWidth, result.x);
		}

		[Test]
		public function testLayoutResultWithMinWidthLargerThanChild():void
		{
			this._layout.useVirtualLayout = false;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[this._child1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.minWidth = 3 * CHILD1_WIDTH;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortWidth not equal to minWidth when minWidth is larger than item width.",
				bounds.minWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: contentWidth not equal to minWidth when minWidth is larger than item width.",
				bounds.minWidth, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithMinWidthLargerThanChild():void
		{
			this._layout.useVirtualLayout = true;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.typicalItem = this._child1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.minWidth = 3 * CHILD1_WIDTH;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort x not equal to minWidth when minWidth is larger than item width.",
				bounds.minWidth, result.x);
		}

		[Test]
		public function testLayoutResultWithMaxWidthLargerThanChild():void
		{
			this._layout.useVirtualLayout = false;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[this._child1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			//needs to be enough to require more than one tile
			bounds.maxWidth = 3 * CHILD1_WIDTH;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortWidth not equal to item width when maxWidth is larger than item width.",
				CHILD1_WIDTH, result.viewPortWidth);
			Assert.assertStrictlyEquals("SlideShowLayout: contentWidth not equal to item width when maxWidth is larger than item width.",
				CHILD1_WIDTH, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxWidthLargerThanChild():void
		{
			this._layout.useVirtualLayout = true;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.typicalItem = this._child1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			//needs to be enough to require more than one tile
			bounds.maxWidth = 3 * CHILD1_WIDTH;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort x not equal to item width when maxWidth is larger than item width.",
				CHILD1_WIDTH, result.x);
		}

		[Test]
		public function testLayoutResultWithExplicitHeightSmallerThanChild():void
		{
			this._layout.useVirtualLayout = false;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[this._child1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitHeight = CHILD1_HEIGHT / 3;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortHeight not equal to explicitHeight when explicitHeight is smaller than item height.",
				bounds.explicitHeight, result.viewPortHeight);
			Assert.assertStrictlyEquals("SlideShowLayout: contentHeight not equal to explicitHeight when explicitHeight is smaller than item height.",
				bounds.explicitHeight, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithExplicitHeightSmallerThanChild():void
		{
			this._layout.useVirtualLayout = true;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.typicalItem = this._child1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitHeight = CHILD1_HEIGHT / 3;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort y not equal to explicitHeight when explicitHeight is smaller than item height.",
				bounds.explicitHeight, result.y);
		}

		[Test]
		public function testLayoutResultWithExplicitHeightLargerThanChild():void
		{
			this._layout.useVirtualLayout = false;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[this._child1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitHeight = 3 * CHILD1_HEIGHT;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortHeight not equal to explicitHeight when explicitHeight is larger than item height.",
				bounds.explicitHeight, result.viewPortHeight);
			Assert.assertStrictlyEquals("SlideShowLayout: contentHeight not equal to explicitHeight when explicitHeight is larger than item height.",
				bounds.explicitHeight, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithExplicitHeightLargerThanChild():void
		{
			this._layout.useVirtualLayout = true;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.typicalItem = this._child1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitHeight = 3 * CHILD1_HEIGHT;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort y not equal to explicitHeight when explicitHeight is larger than item height.",
				bounds.explicitHeight, result.y);
		}

		[Test]
		public function testLayoutResultWithMaxHeightSmallerThanChild():void
		{
			this._layout.useVirtualLayout = false;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[this._child1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxHeight = CHILD1_HEIGHT / 3;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortHeight not equal to maxHeight when maxHeight is smaller than item height.",
				bounds.maxHeight, result.viewPortHeight);
			Assert.assertStrictlyEquals("SlideShowLayout: contentHeight not equal to maxHeight when maxHeight is smaller than item height.",
				bounds.maxHeight, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxHeightSmallerThanChild():void
		{
			this._layout.useVirtualLayout = true;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.typicalItem = this._child1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxHeight = CHILD1_HEIGHT / 3;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort y not equal to maxHeight when maxHeight is smaller than item height.",
				bounds.maxHeight, result.y);
		}

		[Test]
		public function testLayoutResultWithMinHeightLargerThanChild():void
		{
			this._layout.useVirtualLayout = false;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[this._child1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.minHeight = 3 * CHILD1_HEIGHT;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortHeight not equal to minHeight when minHeight is larger than item height.",
				bounds.minHeight, result.viewPortHeight);
			Assert.assertStrictlyEquals("SlideShowLayout: contentHeight not equal to minHeight when minHeight is larger than item height.",
				bounds.minHeight, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithMinHeightLargerThanChild():void
		{
			this._layout.useVirtualLayout = true;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.typicalItem = this._child1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.minHeight = 3 * CHILD1_HEIGHT;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort y not equal to minHeight when minHeight is larger than item height.",
				bounds.minHeight, result.y);
		}

		[Test]
		public function testLayoutResultWithMaxHeightLargerThanChild():void
		{
			this._layout.useVirtualLayout = false;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[this._child1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			//needs to be enough to require more than one tile
			bounds.maxHeight = 3 * CHILD1_HEIGHT;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: viewPortHeight not equal to item height when maxHeight is larger than item height.",
				CHILD1_HEIGHT, result.viewPortHeight);
			Assert.assertStrictlyEquals("SlideShowLayout: contentHeight not equal to item height when maxHeight is larger than item height.",
				CHILD1_HEIGHT, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxHeightLargerThanChild():void
		{
			this._layout.useVirtualLayout = true;
			this._child1 = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.typicalItem = this._child1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			//needs to be enough to require more than one tile
			bounds.maxHeight = 3 * CHILD1_HEIGHT;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("SlideShowLayout: measureViewPort y not equal to item height when maxHeight is larger than item height.",
				CHILD1_HEIGHT, result.y);
		}
	}
}


================================================
FILE: test/source/feathers/tests/SliderHorizontalMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.BasicButton;
	import feathers.controls.Slider;
	import feathers.controls.TrackLayoutMode;
	import feathers.layout.Direction;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class SliderHorizontalMeasurementTests
	{
		private static const SINGLE_TRACK_WIDTH:Number = 200;
		private static const SINGLE_TRACK_HEIGHT:Number = 50;
		private static const SINGLE_TRACK_MIN_WIDTH:Number = 150;
		private static const SINGLE_TRACK_MIN_HEIGHT:Number = 30;

		private static const MINIMUM_TRACK_WIDTH:Number = 100;
		private static const MINIMUM_TRACK_HEIGHT:Number = 50;
		private static const MINIMUM_TRACK_MIN_WIDTH:Number = 80;
		private static const MINIMUM_TRACK_MIN_HEIGHT:Number = 20;

		private static const MAXIMUM_TRACK_WIDTH:Number = 110;
		private static const MAXIMUM_TRACK_HEIGHT:Number = 55;
		private static const MAXIMUM_TRACK_MIN_WIDTH:Number = 90;
		private static const MAXIMUM_TRACK_MIN_HEIGHT:Number = 25;

		private static const THUMB_WIDTH:Number = 30;
		private static const SMALL_THUMB_HEIGHT:Number = 40;
		private static const LARGE_THUMB_HEIGHT:Number = 60;

		private static const THUMB_MIN_WIDTH:Number = 18;
		private static const SMALL_THUMB_MIN_HEIGHT:Number = 20;
		private static const LARGE_THUMB_MIN_HEIGHT:Number = 40;

		private var _slider:Slider;

		[Before]
		public function prepare():void
		{
			this._slider = new Slider();
			this._slider.direction = Direction.HORIZONTAL;
			TestFeathers.starlingRoot.addChild(this._slider);
		}

		[After]
		public function cleanup():void
		{
			this._slider.removeFromParent(true);
			this._slider = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSingle():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The width of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_WIDTH, this._slider.width);
			Assert.assertStrictlyEquals("The minWidth of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_WIDTH, this._slider.minWidth);
			Assert.assertStrictlyEquals("The height of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_HEIGHT, this._slider.height);
			Assert.assertStrictlyEquals("The minHeight of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_HEIGHT, this._slider.minHeight);
		}

		[Test]
		public function testAutoSizeHeightWithTrackLayoutModeSingleAndLargerThumb():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, LARGE_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The height of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger thumb.",
				LARGE_THUMB_HEIGHT, this._slider.height);
			Assert.assertStrictlyEquals("The minHeight of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger thumb.",
				LARGE_THUMB_HEIGHT, this._slider.minHeight);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSingleAndMinDimensions():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = SMALL_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				button.minWidth = SINGLE_TRACK_MIN_WIDTH;
				button.minHeight = SINGLE_TRACK_MIN_HEIGHT;
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The minWidth of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and the track's minWidth is set.",
				SINGLE_TRACK_MIN_WIDTH, this._slider.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and the track's minHeight is set.",
				SINGLE_TRACK_MIN_HEIGHT, this._slider.minHeight);
		}

		[Test]
		public function testAutoSizeMinHeightWithTrackLayoutModeSingleAndLargerThumb():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, LARGE_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = LARGE_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				button.minWidth = SINGLE_TRACK_MIN_WIDTH;
				button.minHeight = SINGLE_TRACK_MIN_HEIGHT;
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The minHeight of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger thumb minHeight.",
				LARGE_THUMB_MIN_HEIGHT, this._slider.minHeight);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSplit():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._slider.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The width of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MAXIMUM_TRACK_WIDTH + THUMB_WIDTH / 2, this._slider.width);
			Assert.assertStrictlyEquals("The minWidth of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MAXIMUM_TRACK_WIDTH + THUMB_WIDTH / 2, this._slider.minWidth);
			Assert.assertStrictlyEquals("The height of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MAXIMUM_TRACK_HEIGHT, this._slider.height);
			Assert.assertStrictlyEquals("The minHeight of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MAXIMUM_TRACK_HEIGHT, this._slider.minHeight);
		}

		[Test]
		public function testAutoSizeHeightWithTrackLayoutModeSplitAndLargerThumb():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, LARGE_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._slider.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The height of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger thumb.",
				LARGE_THUMB_HEIGHT, this._slider.height);
			Assert.assertStrictlyEquals("The minHeight of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger thumb.",
				LARGE_THUMB_HEIGHT, this._slider.minHeight);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSplitAndMinDimensions():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = SMALL_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				button.minWidth = MINIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MINIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._slider.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				button.minWidth = MAXIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MAXIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The minWidth of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT when the track's minWidth is set.",
				MAXIMUM_TRACK_MIN_WIDTH + THUMB_MIN_WIDTH / 2, this._slider.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT when the track's minHeight is set.",
				MAXIMUM_TRACK_MIN_HEIGHT, this._slider.minHeight);
		}

		[Test]
		public function testAutoSizeMinHeightWithTrackLayoutModeSplitAndLargerThumb():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, LARGE_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = LARGE_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				button.minWidth = MINIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MINIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._slider.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				button.minWidth = MAXIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MAXIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The minHeight of the horizontal Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger thumb minHeight.",
				LARGE_THUMB_MIN_HEIGHT, this._slider.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/SliderHorizontalTests.as
================================================
package feathers.tests
{
	import feathers.controls.Button;
	import feathers.controls.Slider;
	import feathers.controls.TrackInteractionMode;
	import feathers.controls.TrackLayoutMode;
	import feathers.layout.Direction;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class SliderHorizontalTests
	{
		private static const THUMB_NAME:String = "thumb";
		private static const TRACK_NAME:String = "track";
		private static const TRACK_WIDTH:Number = 200;
		private static const TRACK_HEIGHT:Number = 20;
		private static const THUMB_WIDTH:Number = 20;
		private static const THUMB_HEIGHT:Number = 20;

		private var _slider:Slider;

		[Before]
		public function prepare():void
		{
			this._slider = new Slider();
			this._slider.direction = Direction.HORIZONTAL;
			this._slider.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._slider.minimumTrackFactory = function():Button
			{
				var track:Button = new Button();
				track.name = TRACK_NAME;
				track.defaultSkin = new Quad(TRACK_WIDTH, TRACK_HEIGHT);
				return track;
			};
			this._slider.thumbFactory = function():Button
			{
				var thumb:Button = new Button();
				thumb.name = THUMB_NAME;
				thumb.defaultSkin = new Quad(THUMB_WIDTH, THUMB_HEIGHT);
				return thumb;
			};
			TestFeathers.starlingRoot.addChild(this._slider);
			this._slider.validate();
		}

		[After]
		public function cleanup():void
		{
			this._slider.removeFromParent(true);
			this._slider = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testSetValueProgramaticallyWithMinimum():void
		{
			this._slider.minimum = 5;
			this._slider.maximum = 10;
			this._slider.value = 2;
			Assert.assertEquals("Setting value smaller than minimum not changed to minimum.", this._slider.minimum, this._slider.value);
		}

		[Test]
		public function testSetValueProgramaticallyWithMaximum():void
		{
			this._slider.minimum = 5;
			this._slider.maximum = 10;
			this._slider.value = 12;
			Assert.assertEquals("Setting value larger than maximum not changed to maximum.", this._slider.maximum, this._slider.value);
		}

		[Test]
		public function testProgrammaticSelectionChange():void
		{
			this._slider.minimum = 0;
			this._slider.maximum = 10;
			this._slider.value = 5;
			var hasChanged:Boolean = false;
			this._slider.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._slider.value = 6;
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
		}

		[Test]
		public function testInteractiveSelectionChangeWithDraggingThumb():void
		{
			var beforeValue:Number = 5;
			this._slider.minimum = 0;
			this._slider.maximum = 10;
			this._slider.value = beforeValue;
			//validate to position the thumb correctly.
			this._slider.validate();
			var hasChanged:Boolean = false;
			this._slider.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(TRACK_WIDTH / 2, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._slider.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the slider's thumb",
				this._slider.getChildByName(THUMB_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.MOVED;
			touch.globalX = position.x + THUMB_WIDTH * 2;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("The value property was not changed to a greater value",
				beforeValue < this._slider.value);
		}

		[Test]
		public function testInteractiveSelectionChangeWithDraggingThumbBeyondRightEdgeOfTrack():void
		{
			var beforeValue:Number = 5;
			this._slider.minimum = 0;
			this._slider.maximum = 10;
			this._slider.value = beforeValue;
			//validate to position the thumb correctly.
			this._slider.validate();
			var hasChanged:Boolean = false;
			this._slider.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(TRACK_WIDTH / 2, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._slider.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the slider's thumb",
				this._slider.getChildByName(THUMB_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.MOVED;
			touch.globalX = position.x + TRACK_WIDTH;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The value property was not equal to the maximum value",
				this._slider.maximum, this._slider.value);
		}

		[Test]
		public function testInteractiveSelectionChangeWithDraggingThumbBeyondLeftEdgeOfTrack():void
		{
			var beforeValue:Number = 5;
			this._slider.minimum = 0;
			this._slider.maximum = 10;
			this._slider.value = beforeValue;
			//validate to position the thumb correctly.
			this._slider.validate();
			var hasChanged:Boolean = false;
			this._slider.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(TRACK_WIDTH / 2, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._slider.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the slider's thumb",
				this._slider.getChildByName(THUMB_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.MOVED;
			touch.globalX = position.x - TRACK_WIDTH;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The value property was not equal to the minimum value",
				this._slider.minimum, this._slider.value);
		}

		[Test]
		public function testInteractiveSelectionChangeWithTouchToLeftOfThumb():void
		{
			var beforeValue:Number = 5;
			this._slider.minimum = 0;
			this._slider.maximum = 10;
			this._slider.value = beforeValue;
			this._slider.trackInteractionMode = TrackInteractionMode.TO_VALUE;
			//validate to position the thumb correctly.
			this._slider.validate();
			var hasChanged:Boolean = false;
			this._slider.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(TRACK_WIDTH / 3, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._slider.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the slider's thumb",
				this._slider.getChildByName(THUMB_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("The value property was not less than the previous value",
				beforeValue > this._slider.value);
		}

		[Test]
		public function testInteractiveSelectionChangeWithTouchToRightOfThumb():void
		{
			var beforeValue:Number = 5;
			this._slider.minimum = 0;
			this._slider.maximum = 10;
			this._slider.value = beforeValue;
			this._slider.trackInteractionMode = TrackInteractionMode.TO_VALUE;
			//validate to position the thumb correctly.
			this._slider.validate();
			var hasChanged:Boolean = false;
			this._slider.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(2 * TRACK_WIDTH / 3, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._slider.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the slider's thumb",
				this._slider.getChildByName(THUMB_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("The value property was not greater than the previous value",
				beforeValue < this._slider.value);
		}
	}
}


================================================
FILE: test/source/feathers/tests/SliderVerticalMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.BasicButton;
	import feathers.controls.Slider;
	import feathers.controls.TrackLayoutMode;
	import feathers.layout.Direction;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class SliderVerticalMeasurementTests
	{
		private static const SINGLE_TRACK_WIDTH:Number = 50;
		private static const SINGLE_TRACK_HEIGHT:Number = 200;
		private static const SINGLE_TRACK_MIN_WIDTH:Number = 30;
		private static const SINGLE_TRACK_MIN_HEIGHT:Number = 150;

		private static const MINIMUM_TRACK_WIDTH:Number = 50;
		private static const MINIMUM_TRACK_HEIGHT:Number = 100;
		private static const MINIMUM_TRACK_MIN_WIDTH:Number = 20;
		private static const MINIMUM_TRACK_MIN_HEIGHT:Number = 80;

		private static const MAXIMUM_TRACK_WIDTH:Number = 55;
		private static const MAXIMUM_TRACK_HEIGHT:Number = 110;
		private static const MAXIMUM_TRACK_MIN_WIDTH:Number = 25;
		private static const MAXIMUM_TRACK_MIN_HEIGHT:Number = 90;

		private static const SMALL_THUMB_WIDTH:Number = 40;
		private static const LARGE_THUMB_WIDTH:Number = 60;
		private static const THUMB_HEIGHT:Number = 30;

		private static const SMALL_THUMB_MIN_WIDTH:Number = 20;
		private static const LARGE_THUMB_MIN_WIDTH:Number = 40;
		private static const THUMB_MIN_HEIGHT:Number = 18;

		private var _slider:Slider;

		[Before]
		public function prepare():void
		{
			this._slider = new Slider();
			this._slider.direction = Direction.VERTICAL;
			TestFeathers.starlingRoot.addChild(this._slider);
		}

		[After]
		public function cleanup():void
		{
			this._slider.removeFromParent(true);
			this._slider = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSingle():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(SMALL_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The width of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_WIDTH, this._slider.width);
			Assert.assertStrictlyEquals("The minWidth of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_WIDTH, this._slider.minWidth);
			Assert.assertStrictlyEquals("The height of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_HEIGHT, this._slider.height);
			Assert.assertStrictlyEquals("The minHeight of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_HEIGHT, this._slider.minHeight);
		}

		[Test]
		public function testAutoSizeWidthWithTrackLayoutModeSingleAndLargerThumb():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(LARGE_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The width of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger thumb.",
				LARGE_THUMB_WIDTH, this._slider.width);
			Assert.assertStrictlyEquals("The minWidth of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger thumb.",
				LARGE_THUMB_WIDTH, this._slider.minWidth);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSingleAndMinDimensions():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(SMALL_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = SMALL_THUMB_MIN_WIDTH;
				thumb.minHeight = THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				button.minWidth = SINGLE_TRACK_MIN_WIDTH;
				button.minHeight = SINGLE_TRACK_MIN_HEIGHT;
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The minWidth of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and the track's minWidth is set.",
				SINGLE_TRACK_MIN_WIDTH, this._slider.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and the track's minHeight is set.",
				SINGLE_TRACK_MIN_HEIGHT, this._slider.minHeight);
		}

		[Test]
		public function testAutoSizeMinWidthWithTrackLayoutModeSingleAndLargerThumb():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(SMALL_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = LARGE_THUMB_MIN_WIDTH;
				thumb.minHeight = THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				button.minWidth = SINGLE_TRACK_MIN_WIDTH;
				button.minHeight = SINGLE_TRACK_MIN_HEIGHT;
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The minWidth of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger thumb minHeight.",
				LARGE_THUMB_MIN_WIDTH, this._slider.minWidth);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSplit():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(SMALL_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._slider.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The width of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MAXIMUM_TRACK_WIDTH, this._slider.width);
			Assert.assertStrictlyEquals("The minWidth of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MAXIMUM_TRACK_WIDTH, this._slider.minWidth);
			Assert.assertStrictlyEquals("The height of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MAXIMUM_TRACK_HEIGHT + THUMB_HEIGHT / 2, this._slider.height);
			Assert.assertStrictlyEquals("The minHeight of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				MAXIMUM_TRACK_HEIGHT + THUMB_HEIGHT / 2, this._slider.minHeight);
		}

		[Test]
		public function testAutoSizeWidthWithTrackLayoutModeSplitAndLargerThumb():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(LARGE_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._slider.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The width of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger thumb.",
				LARGE_THUMB_WIDTH, this._slider.width);
			Assert.assertStrictlyEquals("The minWidth of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger thumb.",
				LARGE_THUMB_WIDTH, this._slider.minWidth);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSplitAndMinDimensions():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(SMALL_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = SMALL_THUMB_MIN_WIDTH;
				thumb.minHeight = THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				button.minWidth = MINIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MINIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._slider.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				button.minWidth = MAXIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MAXIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The minWidth of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT when the track's minWidth is set.",
				MAXIMUM_TRACK_MIN_WIDTH, this._slider.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT when the track's minHeight is set.",
				MAXIMUM_TRACK_MIN_HEIGHT + THUMB_MIN_HEIGHT / 2, this._slider.minHeight);
		}

		[Test]
		public function testAutoSizeMinWidthtWithTrackLayoutModeSplitAndLargerThumb():void
		{
			this._slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._slider.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(LARGE_THUMB_WIDTH, THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = LARGE_THUMB_MIN_WIDTH;
				thumb.minHeight = THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._slider.minimumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MINIMUM_TRACK_WIDTH, MINIMUM_TRACK_HEIGHT, 0xffff00);
				button.minWidth = MINIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MINIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._slider.maximumTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(MAXIMUM_TRACK_WIDTH, MAXIMUM_TRACK_HEIGHT, 0x00ffff);
				button.minWidth = MAXIMUM_TRACK_MIN_WIDTH;
				button.minHeight = MAXIMUM_TRACK_MIN_HEIGHT;
				return button;
			};
			this._slider.validate();
			Assert.assertStrictlyEquals("The minWidth of the vertical Slider was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger thumb minHeight.",
				LARGE_THUMB_MIN_WIDTH, this._slider.minWidth);
		}
	}
}


================================================
FILE: test/source/feathers/tests/SpinnerListTests.as
================================================
package feathers.tests
{
	import feathers.controls.SpinnerList;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.data.ListCollection;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class SpinnerListTests
	{
		private var _list:SpinnerList;

		[Before]
		public function prepare():void
		{
			this._list = new SpinnerList();
			this._list.itemRendererFactory = function():DefaultListItemRenderer
			{
				var itemRenderer:DefaultListItemRenderer = new DefaultListItemRenderer();
				itemRenderer.defaultSkin = new Quad(200, 200);
				return itemRenderer;
			};
			this._list.selectionOverlaySkin = new Quad(200, 200);
			this._list.height = 200;
			TestFeathers.starlingRoot.addChild(this._list);
			this._list.validate();
		}

		[After]
		public function cleanup():void
		{
			this._list.removeFromParent(true);
			this._list = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function setDataProvider():void
		{
			this._list.dataProvider = new ListCollection(
			[
				{ label: "One" },
				{ label: "Two" },
				{ label: "Three" },
				{ label: "Four" },
				{ label: "Five" },
			]);
		}

		[Test]
		public function testDefaultSelectionWithoutDataProvider():void
		{
			Assert.assertStrictlyEquals("SpinnerList selectedIndex must default to 0 when no data provider is available", -1, this._list.selectedIndex);
			Assert.assertNull("SpinnerList selectedItem must default to null when no data provider is available", this._list.selectedItem);
		}

		[Test]
		public function testDefaultSelectionWithDataProvider():void
		{
			this.setDataProvider();
			Assert.assertStrictlyEquals("SpinnerList selectedIndex must default to 0 with a data provider", 0, this._list.selectedIndex);
			Assert.assertStrictlyEquals("SpinnerList selectedItem must default to the item at index 0", this._list.dataProvider.getItemAt(0), this._list.selectedItem);
		}

		[Test]
		public function testSetSelectedIndexToNegativeOneWithDataProvider():void
		{
			var index:int = 2;
			this.setDataProvider();
			this._list.selectedIndex = index;
			this._list.selectedIndex = -1;
			Assert.assertStrictlyEquals("SpinnerList selectedIndex cannot be changed to -1 with a non-empty data provider", index, this._list.selectedIndex);
		}

		[Test]
		public function testSetSelectedItemToNonItemWithDataProvider():void
		{
			var index:int = 2;
			this.setDataProvider();
			this._list.selectedIndex = index;
			this._list.selectedItem = {};
			Assert.assertStrictlyEquals("SpinnerList selectedItem cannot be changed to non-item with a non-empty data provider", index, this._list.selectedIndex);
		}

		[Test]
		public function testSetSelectedIndexChangesPageIndex():void
		{
			var index:int = 2;
			this.setDataProvider();
			this._list.selectedIndex = index;
			this._list.validate(); //uses scrollToDisplayIndex();
			Assert.assertStrictlyEquals("SpinnerList verticalPageIndex must change when selectedIndex changes",
				index, this._list.verticalPageIndex);
		}

		[Test]
		public function testRemoveItemBeforeSelectedIndexChangesPageIndex():void
		{
			var index:int = 2;
			this.setDataProvider();
			this._list.selectedIndex = index;
			//validating here probably shouldn't be required, but SpinnerList
			//doesn't know which direction it will scroll yet
			this._list.validate();
			this._list.dataProvider.removeItemAt(index - 1);
			this._list.validate(); //uses scrollToDisplayIndex();
			Assert.assertStrictlyEquals("SpinnerList verticalPageIndex must change when removeItemAt() before selectedIndex",
				index - 1, this._list.verticalPageIndex);
		}

		[Test]
		public function testAddItemAtSelectedIndexChangesPageIndex():void
		{
			var index:int = 2;
			this.setDataProvider();
			this._list.selectedIndex = index;
			//validating here probably shouldn't be required, but SpinnerList
			//doesn't know which direction it will scroll yet
			this._list.validate();
			this._list.dataProvider.addItemAt({ label: "New" }, index);
			this._list.validate(); //uses scrollToDisplayIndex();
			Assert.assertStrictlyEquals("SpinnerList verticalPageIndex must change when addItemAt() before selectedIndex",
				index + 1, this._list.verticalPageIndex);
		}
	}
}


================================================
FILE: test/source/feathers/tests/StackScreenNavigatorMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.AutoSizeMode;
	import feathers.controls.LayoutGroup;
	import feathers.controls.StackScreenNavigator;
	import feathers.controls.StackScreenNavigatorItem;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class StackScreenNavigatorMeasurementTests
	{
		private static const SCREEN_ID_ONE:String = "one";
		private static const SCREEN_ONE_WIDTH:Number = 100;
		private static const SCREEN_ONE_HEIGHT:Number = 150;
		
		private static const SCREEN_ID_TWO:String = "two";
		private static const SCREEN_TWO_WIDTH:Number = 200;
		private static const SCREEN_TWO_HEIGHT:Number = 180;
		private static const SCREEN_TWO_MIN_WIDTH:Number = 110;
		private static const SCREEN_TWO_MIN_HEIGHT:Number = 120;

		private var _navigator:StackScreenNavigator;
		private var _screenOne:Quad;
		private var _screenTwo:LayoutGroup;
		private var _navigator2:StackScreenNavigator;

		[Before]
		public function prepare():void
		{
			this._screenOne = new Quad(SCREEN_ONE_WIDTH, SCREEN_ONE_HEIGHT, 0xff0000);
			
			var screenTwoBackground:Quad = new Quad(SCREEN_TWO_WIDTH, SCREEN_TWO_HEIGHT, 0x0000ff);
			this._screenTwo = new LayoutGroup();
			this._screenTwo.minWidth = SCREEN_TWO_MIN_WIDTH;
			this._screenTwo.minHeight = SCREEN_TWO_MIN_HEIGHT;
			this._screenTwo.backgroundSkin = screenTwoBackground;
			
			this._navigator = new StackScreenNavigator();
			this._navigator.addScreen(SCREEN_ID_ONE, new StackScreenNavigatorItem(this._screenOne));
			this._navigator.addScreen(SCREEN_ID_TWO, new StackScreenNavigatorItem(this._screenTwo));
			TestFeathers.starlingRoot.addChild(this._navigator);
		}

		[After]
		public function cleanup():void
		{
			this._navigator.removeFromParent(true);
			this._navigator = null;

			if(this._navigator2)
			{
				this._navigator2.removeFromParent(true);
				this._navigator2 = null;
			}

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testAutoSizeModeStage():void
		{
			this._navigator.autoSizeMode = AutoSizeMode.STAGE;
			this._navigator.validate();
			Assert.assertStrictlyEquals("The width of the StackScreenNavigator was not calculated correctly when empty with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._navigator.width);
			Assert.assertStrictlyEquals("The height of the StackScreenNavigator was not calculated correctly when empty with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._navigator.height);
			Assert.assertStrictlyEquals("The minWidth of the StackScreenNavigator was not calculated correctly when empty with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._navigator.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the StackScreenNavigator was not calculated correctly when empty with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._navigator.minHeight);
		}

		[Test]
		public function testAutoSizeModeStageWithoutParent():void
		{
			this._navigator2 = new StackScreenNavigator();
			this._navigator2.autoSizeMode = AutoSizeMode.STAGE;
			this._navigator2.validate();
			Assert.assertStrictlyEquals("The width of the ScreenNavigator was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._navigator2.width);
			Assert.assertStrictlyEquals("The height of the ScreenNavigator was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._navigator2.height);
			Assert.assertStrictlyEquals("The minWidth of the ScreenNavigator was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._navigator2.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the ScreenNavigator was not calculated correctly with no parent and AutoSizeMode.STAGE.",
				0, this._navigator2.minHeight);
		}

		[Test]
		public function testAutoSizeModeStageWithValidateBeforeAdd():void
		{
			this._navigator2 = new StackScreenNavigator();
			this._navigator2.autoSizeMode = AutoSizeMode.STAGE;
			this._navigator2.validate();
			TestFeathers.starlingRoot.addChild(this._navigator2);
			this._navigator2.validate();
			Assert.assertStrictlyEquals("The width of the ScreenNavigator was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._navigator2.width);
			Assert.assertStrictlyEquals("The height of the ScreenNavigator was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._navigator2.height);
			Assert.assertStrictlyEquals("The minWidth of the ScreenNavigator was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._navigator2.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the ScreenNavigator was not calculated correctly after addChild() when validated before with AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._navigator2.minHeight);
		}

		[Test]
		public function testAutoSizeModeContentWithNoActiveScreen():void
		{
			this._navigator.autoSizeMode = AutoSizeMode.CONTENT;
			this._navigator.validate();
			Assert.assertStrictlyEquals("The width of the StackScreenNavigator was not calculated correctly when empty with AutoSizeMode.CONTENT.",
				0, this._navigator.width);
			Assert.assertStrictlyEquals("The height of the StackScreenNavigator was not calculated correctly when empty with AutoSizeMode.CONTENT.",
				0, this._navigator.height);
			Assert.assertStrictlyEquals("The minWidth of the StackScreenNavigator was not calculated correctly when empty with AutoSizeMode.CONTENT.",
				0, this._navigator.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the StackScreenNavigator was not calculated correctly when empty with AutoSizeMode.CONTENT.",
				0, this._navigator.minHeight);
		}

		[Test]
		public function testAutoSizeModeStageWithSimpleScreen():void
		{
			this._navigator.autoSizeMode = AutoSizeMode.STAGE;
			this._navigator.rootScreenID = SCREEN_ID_ONE;
			this._navigator.validate();
			Assert.assertStrictlyEquals("The width of the StackScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._navigator.width);
			Assert.assertStrictlyEquals("The height of the StackScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._navigator.height);
			Assert.assertStrictlyEquals("The minWidth of the StackScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageWidth, this._navigator.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the StackScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.STAGE.",
				TestFeathers.starlingRoot.stage.stageHeight, this._navigator.minHeight);
		}

		[Test]
		public function testAutoSizeModeContentWithSimpleScreen():void
		{
			this._navigator.autoSizeMode = AutoSizeMode.CONTENT;
			this._navigator.rootScreenID = SCREEN_ID_ONE;
			this._navigator.validate();
			Assert.assertStrictlyEquals("The width of the StackScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.CONTENT.",
				SCREEN_ONE_WIDTH, this._navigator.width);
			Assert.assertStrictlyEquals("The height of the StackScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.CONTENT.",
				SCREEN_ONE_HEIGHT, this._navigator.height);
			Assert.assertStrictlyEquals("The minWidth of the StackScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.CONTENT.",
				SCREEN_ONE_WIDTH, this._navigator.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the StackScreenNavigator was not calculated correctly with simple screen and AutoSizeMode.CONTENT.",
				SCREEN_ONE_HEIGHT, this._navigator.minHeight);
		}

		[Test]
		public function testAutoSizeModeContentWithComplexScreen():void
		{
			this._navigator.autoSizeMode = AutoSizeMode.CONTENT;
			this._navigator.rootScreenID = SCREEN_ID_TWO;
			this._navigator.validate();
			Assert.assertStrictlyEquals("The width of the StackScreenNavigator was not calculated correctly with complex screen and AutoSizeMode.CONTENT.",
				SCREEN_TWO_WIDTH, this._navigator.width);
			Assert.assertStrictlyEquals("The height of the StackScreenNavigator was not calculated correctly with complex screen and AutoSizeMode.CONTENT.",
				SCREEN_TWO_HEIGHT, this._navigator.height);
			Assert.assertStrictlyEquals("The minWidth of the StackScreenNavigator was not calculated correctly with complex screen and AutoSizeMode.CONTENT.",
				SCREEN_TWO_MIN_WIDTH, this._navigator.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the StackScreenNavigator was not calculated correctly with complex screen and AutoSizeMode.CONTENT.",
				SCREEN_TWO_MIN_HEIGHT, this._navigator.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/StackScreenNavigatorTests.as
================================================
package feathers.tests
{
	import feathers.controls.StackScreenNavigator;
	import feathers.controls.StackScreenNavigatorItem;
	import feathers.events.FeathersEventType;

	import flexunit.framework.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import flash.geom.Point;
	import starling.events.Touch;
	import starling.events.TouchPhase;
	import starling.events.TouchEvent;
	import starling.events.Event;
	import feathers.motion.Slide;
	import org.flexunit.async.Async;

	public class StackScreenNavigatorTests
	{
		public static const SCREEN_A_ID:String = "a";
		public static const SCREEN_B_ID:String = "b";
		public static const SCREEN_C_ID:String = "c";
		public static const SCREEN_D_ID:String = "d";
		public static const SCREEN_E_ID:String = "e";

		private static const EVENT_PUSH_SCREEN_B:String = "pushScreenB";
		private static const EVENT_PUSH_SCREEN_C:String = "pushScreenC";
		private static const EVENT_REPLACE_WITH_SCREEN_C:String = "replaceWithScreenC";
		private static const EVENT_POP_SCREEN:String = "popScreen";
		private static const EVENT_POP_TO_ROOT_SCREEN:String = "popToRootScreen";
		private static const EVENT_CALL_FUNCTION:String = "callFunction";

		private static const NAVIGATOR_WIDTH:Number = 250;
		private static const NAVIGATOR_HEIGHT:Number = 200;

		private var _navigator:StackScreenNavigator;
		private var _functionWasCalled:Boolean = false;

		[Before]
		public function prepare():void
		{
			this._navigator = new StackScreenNavigator();
			this._navigator.setSize(NAVIGATOR_WIDTH, NAVIGATOR_HEIGHT);
			TestFeathers.starlingRoot.addChild(this._navigator);
			this._navigator.validate();

			this._functionWasCalled = false;
		}

		[After]
		public function cleanup():void
		{
			this._navigator.removeFromParent(true);
			this._navigator = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testHasScreenWhenNotAdded():void
		{
			Assert.assertFalse("hasScreen() incorrectly returned true for a screen that was not added", this._navigator.hasScreen(SCREEN_A_ID));
		}

		[Test]
		public function testHasScreen():void
		{
			this.addScreenA();
			Assert.assertTrue("hasScreen() incorrectly returned false for a screen that was added", this._navigator.hasScreen(SCREEN_A_ID));
		}

		[Test]
		public function testStateWithEmptyStack():void
		{
			Assert.assertNull("activeScreen returned incorrect value for empty stack", this._navigator.activeScreen);
			Assert.assertNull("activeScreenID returned incorrect value for empty stack", this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("stackCount returned incorrect value for empty stack", 0, this._navigator.stackCount);
		}

		[Test]
		public function testSetRootScreenID():void
		{
			this.addScreenA();
			this._navigator.rootScreenID = SCREEN_A_ID;
			Assert.assertStrictlyEquals("activeScreen returned incorrect value for stack with only root screen", this._navigator.getScreen(SCREEN_A_ID).screen, this._navigator.activeScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value for stack with only root screen", SCREEN_A_ID, this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("stackCount returned incorrect value for stack with only root screen", 1, this._navigator.stackCount);
		}

		[Test]
		public function testPushScreen():void
		{
			this.addScreenA();
			this.addScreenB();
			this._navigator.rootScreenID = SCREEN_A_ID;
			this._navigator.pushScreen(SCREEN_B_ID);
			Assert.assertStrictlyEquals("activeScreen returned incorrect value for stack after pushScreen()", this._navigator.getScreen(SCREEN_B_ID).screen, this._navigator.activeScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value for stack after pushScreen()", SCREEN_B_ID, this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("stackCount returned incorrect value for stack after pushScreen()", 2, this._navigator.stackCount);
		}

		[Test]
		public function testReplaceScreen():void
		{
			this.addScreenA();
			this.addScreenB();
			this.addScreenC();
			this._navigator.rootScreenID = SCREEN_A_ID;
			this._navigator.pushScreen(SCREEN_B_ID);
			this._navigator.replaceScreen(SCREEN_C_ID);
			Assert.assertStrictlyEquals("activeScreen returned incorrect value for stack after replaceScreen()", this._navigator.getScreen(SCREEN_C_ID).screen, this._navigator.activeScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value for stack after replaceScreen()", SCREEN_C_ID, this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("stackCount returned incorrect value for stack after replaceScreen()", 2, this._navigator.stackCount);
		}

		[Test]
		public function testPopScreen():void
		{
			this.addScreenA();
			this.addScreenB();
			this._navigator.rootScreenID = SCREEN_A_ID;
			this._navigator.pushScreen(SCREEN_B_ID);
			this._navigator.popScreen();
			Assert.assertStrictlyEquals("activeScreen returned incorrect value for stack after popScreen()", this._navigator.getScreen(SCREEN_A_ID).screen, this._navigator.activeScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value for stack after popScreen()", SCREEN_A_ID, this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("stackCount returned incorrect value for stack after popScreen()", 1, this._navigator.stackCount);
		}

		[Test]
		public function testPopToRootScreen():void
		{
			this.addScreenA();
			this.addScreenB();
			this.addScreenC();
			this._navigator.rootScreenID = SCREEN_A_ID;
			this._navigator.pushScreen(SCREEN_B_ID);
			this._navigator.pushScreen(SCREEN_C_ID);
			this._navigator.popToRootScreen();
			Assert.assertStrictlyEquals("activeScreen returned incorrect value for stack after popToRootScreen()", this._navigator.getScreen(SCREEN_A_ID).screen, this._navigator.activeScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value for stack after popToRootScreen()", SCREEN_A_ID, this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("stackCount returned incorrect value for stack after popToRootScreen()", 1, this._navigator.stackCount);
		}

		[Test]
		public function testPopToRootScreenOnRootScreen():void
		{
			this.addScreenA();
			this._navigator.rootScreenID = SCREEN_A_ID;
			this._navigator.popToRootScreen();
			Assert.assertStrictlyEquals("activeScreen returned incorrect value for stack after popToRootScreen() when already on root screen", this._navigator.getScreen(SCREEN_A_ID).screen, this._navigator.activeScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value for stack after popToRootScreen() when already on root screen", SCREEN_A_ID, this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("stackCount returned incorrect value for stack after popToRootScreen() when already on root screen", 1, this._navigator.stackCount);
		}

		[Test]
		public function testPopAll():void
		{
			this.addScreenA();
			this.addScreenB();
			this.addScreenC();
			this._navigator.rootScreenID = SCREEN_A_ID;
			this._navigator.pushScreen(SCREEN_B_ID);
			this._navigator.pushScreen(SCREEN_C_ID);
			this._navigator.popAll();
			Assert.assertNull("activeScreen returned incorrect value for stack after popAll()", this._navigator.activeScreen);
			Assert.assertNull("activeScreenID returned incorrect value for stack after popAll()", this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("stackCount returned incorrect value for stack after popAll()", 0, this._navigator.stackCount);
		}

		[Test]
		public function testPopAllWithOnRootScreen():void
		{
			this.addScreenA();
			this._navigator.rootScreenID = SCREEN_A_ID;
			this._navigator.popAll();
			Assert.assertNull("activeScreen returned incorrect value for stack after popAll() when on root screen", this._navigator.activeScreen);
			Assert.assertNull("activeScreenID returned incorrect value for stack after popAll() when on root screen", this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("stackCount returned incorrect value for stack after popAll() when on root screen", 0, this._navigator.stackCount);
		}

		[Test]
		public function testPopAllWithNoRootScreen():void
		{
			this._navigator.popAll();
			Assert.assertNull("activeScreen returned incorrect value for stack after popAll() with empty stack", this._navigator.activeScreen);
			Assert.assertNull("activeScreenID returned incorrect value for stack after popAll() with empty stack", this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("stackCount returned incorrect value for stack after popAll() with empty stack", 0, this._navigator.stackCount);
		}

		[Test]
		public function testPushScreenWithEvent():void
		{
			this.addScreenA();
			this.addScreenB();
			this._navigator.rootScreenID = SCREEN_A_ID;
			this._navigator.activeScreen.dispatchEventWith(EVENT_PUSH_SCREEN_B);
			Assert.assertStrictlyEquals("activeScreen returned incorrect value for stack after push screen with event", this._navigator.getScreen(SCREEN_B_ID).screen, this._navigator.activeScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value for stack after push screen with event", SCREEN_B_ID, this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("stackCount returned incorrect value for stack with after push screen with event", 2, this._navigator.stackCount);
		}

		[Test]
		public function testReplaceScreenWithEvent():void
		{
			this.addScreenA();
			this.addScreenB();
			this.addScreenC();
			this._navigator.rootScreenID = SCREEN_A_ID;
			this._navigator.activeScreen.dispatchEventWith(EVENT_PUSH_SCREEN_B);
			this._navigator.activeScreen.dispatchEventWith(EVENT_REPLACE_WITH_SCREEN_C);
			Assert.assertStrictlyEquals("activeScreen returned incorrect value for stack after replace screen with event", this._navigator.getScreen(SCREEN_C_ID).screen, this._navigator.activeScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value for stack after replace screen with event", SCREEN_C_ID, this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("stackCount returned incorrect value for stack after replace screen with event", 2, this._navigator.stackCount);
		}

		[Test]
		public function testPopScreenWithEvent():void
		{
			this.addScreenA();
			this.addScreenB();
			this._navigator.rootScreenID = SCREEN_A_ID;
			this._navigator.activeScreen.dispatchEventWith(EVENT_PUSH_SCREEN_B);
			this._navigator.activeScreen.dispatchEventWith(EVENT_POP_SCREEN);
			Assert.assertStrictlyEquals("activeScreen returned incorrect value for stack after pop screen with event", this._navigator.getScreen(SCREEN_A_ID).screen, this._navigator.activeScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value for stack after pop screen with event", SCREEN_A_ID, this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("stackCount returned incorrect value for stack after pop screen with event", 1, this._navigator.stackCount);
		}

		[Test]
		public function testPopToRootScreenWithEvent():void
		{
			this.addScreenA();
			this.addScreenB();
			this.addScreenC();
			this._navigator.rootScreenID = SCREEN_A_ID;
			this._navigator.activeScreen.dispatchEventWith(EVENT_PUSH_SCREEN_B);
			this._navigator.activeScreen.dispatchEventWith(EVENT_PUSH_SCREEN_C);
			this._navigator.activeScreen.dispatchEventWith(EVENT_POP_TO_ROOT_SCREEN);
			Assert.assertStrictlyEquals("activeScreen returned incorrect value for stack after pop to root with event", this._navigator.getScreen(SCREEN_A_ID).screen, this._navigator.activeScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value for stack after pop to root with event", SCREEN_A_ID, this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("stackCount returned incorrect value for stack after pop to root with event", 1, this._navigator.stackCount);
		}

		[Test]
		public function testScreenWithEventAndMethodWithSameName():void
		{
			var item:StackScreenNavigatorItem = new StackScreenNavigatorItem(ScreenWithEventAndMethodWithSameName);
			item.setScreenIDForPushEvent(EVENT_PUSH_SCREEN_B, SCREEN_B_ID);
			item.setScreenIDForReplaceEvent(EVENT_REPLACE_WITH_SCREEN_C, SCREEN_C_ID);
			item.addPopEvent(EVENT_POP_SCREEN);
			item.addPopToRootEvent(EVENT_POP_TO_ROOT_SCREEN);
			this._navigator.addScreen(SCREEN_A_ID, item);
			this._navigator.rootScreenID = SCREEN_A_ID;
		}

		[Test]
		public function testPushSameScreenInstance():void
		{
			this.addScreenA();
			this._navigator.rootScreenID = SCREEN_A_ID;
			this._navigator.pushScreen(SCREEN_A_ID);
			//ensures that this test isn't broken by changing addScreenA()
			Assert.assertTrue("StackScreenNavigatorTests expected StackScreenNavigatorItem screen to be display object", this._navigator.getScreen(SCREEN_A_ID).screen is DisplayObject);
			Assert.assertNotNull("StackScreenNavigator activeScreen.parent must not be null after pushing multiple times", this._navigator.activeScreen.parent);
		}

		[Test]
		public function testPushScreenOnInitialize():void
		{
			this.addScreenD();
			this.addScreenE();
			this._navigator.rootScreenID = SCREEN_D_ID;
		}

		[Test]
		public function testRemoveScreenOnTransitionCompleteEvent():void
		{
			this.addScreenA();
			this.addScreenB();
			this._navigator.pushScreen(SCREEN_A_ID);
			this._navigator.addEventListener(FeathersEventType.TRANSITION_COMPLETE, removeScreenA);
			this._navigator.rootScreenID = null;
			Assert.assertFalse(this._navigator.hasScreen(SCREEN_A_ID));
		}

		[Test]
		public function testRemoveAllScreensOnTransitionCompleteEvent():void
		{
			this.addScreenA();
			this.addScreenB();
			this._navigator.pushScreen(SCREEN_A_ID);
			this._navigator.addEventListener(FeathersEventType.TRANSITION_COMPLETE, removeAllScreens);
			this._navigator.rootScreenID = null;
			Assert.assertFalse(this._navigator.hasScreen(SCREEN_A_ID));
		}

		[Test(async)]
		public function testSwipeToPopChange():void
		{
			this.addScreenA();
			this.addScreenB();
			this._navigator.popTransition = Slide.createSlideRightTransition();
			this._navigator.rootScreenID = SCREEN_A_ID;
			this._navigator.pushScreen(SCREEN_B_ID);
			this._navigator.isSwipeToPopEnabled = true;
			var changedTo:String = null;
			this._navigator.addEventListener(Event.CHANGE, function(event:Event):void
			{
				changedTo = _navigator.activeScreenID;
			});

			var position:Point = new Point(1, 1);
			var target:DisplayObject = this._navigator.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			touch.phase = TouchPhase.MOVED;
			touch.globalX = NAVIGATOR_WIDTH * 2 / 3;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertStrictlyEquals("StackScreenNavigator: activeScreenID incorrect after starting swipe to pop gesture",
				SCREEN_A_ID, changedTo);
			Async.delayCall(this, function():void
			{
				Assert.assertStrictlyEquals("StackScreenNavigator: activeScreenID incorrect after completing swipe to pop gesture",
					SCREEN_B_ID, changedTo);
			}, 600);
		}

		[Test(async)]
		public function testSwipeToPopCancelChange():void
		{
			this.addScreenA();
			this.addScreenB();
			this._navigator.popTransition = Slide.createSlideRightTransition(0.5);
			this._navigator.rootScreenID = SCREEN_A_ID;
			this._navigator.pushScreen(SCREEN_B_ID);
			this._navigator.isSwipeToPopEnabled = true;
			var changedTo1:String = null;
			var changedTo2:String = null;
			function onChange1(event:Event):void
			{
				_navigator.removeEventListener(Event.CHANGE, onChange1);
				_navigator.addEventListener(Event.CHANGE, onChange2);
				changedTo1 = _navigator.activeScreenID;
			}
			function onChange2(event:Event):void
			{
				changedTo2 = _navigator.activeScreenID;
			}
			this._navigator.addEventListener(Event.CHANGE, onChange1);

			var position:Point = new Point(1, 1);
			var target:DisplayObject = this._navigator.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			touch.phase = TouchPhase.MOVED;
			touch.globalX = NAVIGATOR_WIDTH * 2 / 3;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertStrictlyEquals("StackScreenNavigator: activeScreenID incorrect after starting swipe to pop gesture",
				SCREEN_A_ID, changedTo1);
			Async.delayCall(this, function():void
			{
				Assert.assertStrictlyEquals("StackScreenNavigator: activeScreenID incorrect after cancelling swipe to pop gesture",
					SCREEN_B_ID, changedTo2);
			}, 600);
		}

		private function addScreenA():void
		{
			var screen:Quad = new Quad(10, 10, 0xff00ff);
			var item:StackScreenNavigatorItem = new StackScreenNavigatorItem(screen);
			item.setScreenIDForPushEvent(EVENT_PUSH_SCREEN_B, SCREEN_B_ID);
			item.setFunctionForPushEvent(EVENT_CALL_FUNCTION, eventFunction);
			this._navigator.addScreen(SCREEN_A_ID, item);
		}

		private function addScreenB():void
		{
			var screen:Quad = new Quad(10, 10, 0xffff00);
			var item:StackScreenNavigatorItem = new StackScreenNavigatorItem(screen);
			item.setScreenIDForPushEvent(EVENT_PUSH_SCREEN_C, SCREEN_C_ID);
			item.setScreenIDForReplaceEvent(EVENT_REPLACE_WITH_SCREEN_C, SCREEN_C_ID);
			item.addPopEvent(EVENT_POP_SCREEN);
			this._navigator.addScreen(SCREEN_B_ID, item);
		}

		private function addScreenC():void
		{
			var screen:Quad = new Quad(10, 10, 0x00ffff);
			var item:StackScreenNavigatorItem = new StackScreenNavigatorItem(screen);
			item.addPopEvent(EVENT_POP_SCREEN);
			item.addPopToRootEvent(EVENT_POP_TO_ROOT_SCREEN);
			this._navigator.addScreen(SCREEN_C_ID, item);
		}

		private function addScreenD():void
		{
			this._navigator.addScreen(SCREEN_D_ID, new StackScreenNavigatorItem(ScreenPushOnInitialize));
		}

		private function addScreenE():void
		{
			this._navigator.addScreen(SCREEN_E_ID, new StackScreenNavigatorItem(ScreenInitializeOnce));
		}

		private function removeScreenA():void
		{
			this._navigator.removeScreen(SCREEN_A_ID);
		}

		private function removeAllScreens():void
		{
			this._navigator.removeAllScreens();
		}

		private function eventFunction():void
		{
			this._functionWasCalled = true;
		}
	}
}

import feathers.controls.Screen;
import feathers.controls.StackScreenNavigator;
import feathers.tests.StackScreenNavigatorTests;

import flash.errors.IllegalOperationError;

import starling.display.Quad;

class ScreenWithEventAndMethodWithSameName extends Quad
{
	public function ScreenWithEventAndMethodWithSameName()
	{
		super(10, 10, 0xff00ff);
	}

	public function pushScreenB():void {}
	public function replaceWithScreenC():void {}
	public function popScreen():void {}
	public function popToRootScreen():void {}
}

class ScreenPushOnInitialize extends Screen
{
	override protected function initialize():void
	{
		super.initialize();

		StackScreenNavigator(this.owner).pushScreen(StackScreenNavigatorTests.SCREEN_E_ID);
	}
}

class ScreenInitializeOnce extends Screen
{
	private static var hasInitializedOnce:Boolean = false;
	override protected function initialize():void
	{
		super.initialize();

		if(hasInitializedOnce)
		{
			throw new IllegalOperationError("StackScreenNavigator did not clear next screen and is transitioning infinitely.");
		}
		hasInitializedOnce = true;
	}
}

================================================
FILE: test/source/feathers/tests/StageTextTextEditorFocusTests.as
================================================
package feathers.tests
{
	import feathers.controls.TextInput;
	import feathers.controls.TextInputState;
	import feathers.controls.text.StageTextTextEditor;
	import feathers.core.FocusManager;
	import feathers.events.FeathersEventType;

	import flash.events.FocusEvent;
	import flash.ui.Keyboard;

	import org.flexunit.Assert;
	import org.flexunit.async.Async;

	import starling.core.Starling;
	import starling.display.Quad;
	import starling.events.Event;

	public class StageTextTextEditorFocusTests
	{
		private var _textInput:TextInput;
		private var _textInput2:TextInput;

		[Before]
		public function prepare():void
		{
			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, true);

			this._textInput = new TextInput();
			this._textInput.backgroundSkin = new Quad(200, 200);
			this._textInput.textEditorFactory = textEditorFactory;
			TestFeathers.starlingRoot.addChild(this._textInput);
			this._textInput.validate();

			this._textInput2 = new TextInput();
			this._textInput2.backgroundSkin = new Quad(200, 200);
			this._textInput2.textEditorFactory = textEditorFactory;
			this._textInput2.y = 210;
			TestFeathers.starlingRoot.addChild(this._textInput2);
			this._textInput2.validate();
		}

		private function textEditorFactory():StageTextTextEditor
		{
			var textEditor:StageTextTextEditor = new StageTextTextEditor();
			return textEditor;
		}

		[After]
		public function cleanup():void
		{
			//one of the tests sets the parent's visible property to false, so
			//it needs to be reset.
			this._textInput.parent.visible = true;

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);
			
			this._textInput.removeFromParent(true);
			this._textInput = null;

			this._textInput2.removeFromParent(true);
			this._textInput2 = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testChangeFocusOnTabKey():void
		{
			this._textInput.focusManager.focus = this._textInput;
			Starling.current.nativeStage.dispatchEvent(new FocusEvent(FocusEvent.KEY_FOCUS_CHANGE, true, false, null, false, Keyboard.TAB));
			Assert.assertStrictlyEquals("The FocusManager did not change focus when pressing Keyboard.TAB", this._textInput.focusManager.focus, this._textInput2);
		}

		[Test(async)]
		public function testFocusOutEventAfterSetTextInputParentVisibleToFalse():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_OUT, function(event:Event):void
			{
				hasDispatchedFocusOut = true;
			});
			this._textInput.setFocus();
			_textInput.parent.visible = false;
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("FeathersEventType.FOCUS_OUT was not dispatched after setting TextInput parent's visible property to false when using StageTextTextEditor", hasDispatchedFocusOut);
			}, 100);
		}

		[Test]
		public function testSetFocusWhenFocusEnabledFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isFocusEnabled = false;
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertTrue("TextInput must not receive FocusManager focus when using StageTextTextEditor and isFocusEnabled is false",
				this._textInput.focusManager.focus !== this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.ENABLED after receive FocusManager focus when using StageTextTextEditor and isFocusEnabled is false",
				TextInputState.ENABLED, this._textInput.currentState);
		}

		[Test]
		public function testSetFocusWhenEditableFalseAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = false;
			this._textInput.validate();
			Assert.assertNull("StageTextTextEditor nativeFocus must be null when isEditable is false and isSelectable is false",
				this._textInput.nativeFocus);
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertStrictlyEquals("TextInput must receive FocusManager focus when using StageTextTextEditor and isEditable is false and isSelectable is false",
				this._textInput.focusManager.focus, this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.FOCUSED after receive FocusManager focus when using TextFieldTextEditor and isEditable is false and isSelectable is false",
				TextInputState.FOCUSED, this._textInput.currentState);
		}

		[Test]
		public function testSetFocusWhenEditableTrueAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = true;
			this._textInput.isSelectable = false;
			this._textInput.validate();
			Assert.assertNotNull("StageTextTextEditor nativeFocus must not be null when isEditable is true and isSelectable is false",
				this._textInput.nativeFocus);
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertStrictlyEquals("TextInput must receive FocusManager focus when using StageTextTextEditor and isEditable is true and isSelectable is false",
				this._textInput.focusManager.focus, this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.FOCUSED after receive FocusManager focus when using StageTextTextEditor and isEditable is true and isSelectable is false",
				TextInputState.FOCUSED, this._textInput.currentState);
		}

		[Test]
		public function testSetFocusWhenEditableFalseAndSelectableTrue():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = true;
			this._textInput.validate();
			Assert.assertNull("StageTextTextEditor nativeFocus must be null when isEditable is false and isSelectable is true",
				this._textInput.nativeFocus);
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertStrictlyEquals("TextInput must receive FocusManager focus when using StageTextTextEditor and isEditable is false and isSelectable is true",
				this._textInput.focusManager.focus, this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.FOCUSED after receive FocusManager focus when using StageTextTextEditor and isEditable is false and isSelectable is true",
				TextInputState.FOCUSED, this._textInput.currentState);
		}
	}
}


================================================
FILE: test/source/feathers/tests/StyleNameFunctionStyleProviderTests.as
================================================
package feathers.tests
{
	import feathers.controls.BasicButton;
	import feathers.core.IFeathersControl;
	import feathers.skins.StyleNameFunctionStyleProvider;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class StyleNameFunctionStyleProviderTests
	{
		private static const STYLE_NAME_ONE:String = "one";
		private static const STYLE_NAME_TWO:String = "two";
		
		private var _target:BasicButton;
		private var _styleProvider:StyleNameFunctionStyleProvider;
		private var _defaultCalled:Boolean;
		private var _oneCalled:Boolean;
		private var _twoCalled:Boolean;

		[Before]
		public function prepare():void
		{
			this._defaultCalled = false;
			this._oneCalled = false;
			this._twoCalled = false;
			
			this._target = new BasicButton();
			this._target.defaultSkin = new Quad(200, 200, 0xff00ff);
			TestFeathers.starlingRoot.addChild(this._target);
		}

		[After]
		public function cleanup():void
		{
			this._target.removeFromParent(true);
			this._target = null;

			this._styleProvider = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function defaultFunction(target:IFeathersControl):void
		{
			this._defaultCalled = true;
		}

		private function oneFunction(target:IFeathersControl):void
		{
			this._oneCalled = true;
		}

		private function twoFunction(target:IFeathersControl):void
		{
			this._twoCalled = true;
		}

		[Test]
		public function testNoErrorWithNullDefaultFunction():void
		{
			this._styleProvider = new StyleNameFunctionStyleProvider();
			this._styleProvider.applyStyles(this._target);
			Assert.assertFalse("Default function must not be called when not used", this._defaultCalled);
		}

		[Test]
		public function testDefaultFunction():void
		{
			this._styleProvider = new StyleNameFunctionStyleProvider(defaultFunction);
			this._styleProvider.applyStyles(this._target);
			Assert.assertTrue("Default function must be called", this._defaultCalled);
		}

		[Test]
		public function testOnlyDefaultFunctionCalledWhenOthersRegistered():void
		{
			this._styleProvider = new StyleNameFunctionStyleProvider(defaultFunction);
			this._styleProvider.setFunctionForStyleName(STYLE_NAME_ONE, oneFunction);
			this._styleProvider.setFunctionForStyleName(STYLE_NAME_TWO, twoFunction);
			this._styleProvider.applyStyles(this._target);
			Assert.assertTrue("Default function must be called", this._defaultCalled);
			Assert.assertFalse("Style name function must not be called", this._oneCalled);
			Assert.assertFalse("Style name function must not be called", this._twoCalled);
		}

		[Test]
		public function testDefaultNotCalledWhenStyleNameMatched():void
		{
			this._styleProvider = new StyleNameFunctionStyleProvider(defaultFunction);
			this._styleProvider.setFunctionForStyleName(STYLE_NAME_ONE, oneFunction);
			this._styleProvider.setFunctionForStyleName(STYLE_NAME_TWO, twoFunction);
			this._target.styleNameList.add(STYLE_NAME_ONE);
			this._styleProvider.applyStyles(this._target);
			Assert.assertFalse("Default function must not be called", this._defaultCalled);
			Assert.assertTrue("Style name function must be called", this._oneCalled);
			Assert.assertFalse("Style name function must not be called", this._twoCalled);
		}

		[Test]
		public function testMultipleStyleNamesMatched():void
		{
			this._styleProvider = new StyleNameFunctionStyleProvider(defaultFunction);
			this._styleProvider.setFunctionForStyleName(STYLE_NAME_ONE, oneFunction);
			this._styleProvider.setFunctionForStyleName(STYLE_NAME_TWO, twoFunction);
			this._target.styleNameList.add(STYLE_NAME_ONE);
			this._target.styleNameList.add(STYLE_NAME_TWO);
			this._styleProvider.applyStyles(this._target);
			Assert.assertFalse("Default function must not be called", this._defaultCalled);
			Assert.assertTrue("Style name function must be called", this._oneCalled);
			Assert.assertTrue("Style name function must be called", this._twoCalled);
		}
	}
}


================================================
FILE: test/source/feathers/tests/StyleProviderRegistryTests.as
================================================
package feathers.tests
{
	import feathers.controls.BasicButton;
	import feathers.controls.Slider;
	import feathers.skins.IStyleProvider;
	import feathers.skins.StyleProviderRegistry;
	import feathers.tests.supportClasses.CustomStyleProvider;

	import org.flexunit.Assert;

	public class StyleProviderRegistryTests
	{
		private var _registry:StyleProviderRegistry;

		[After]
		public function cleanup():void
		{
			this._registry.dispose();
			this._registry = null;
		}

		[Test]
		public function testHasStyleProvider():void
		{
			this._registry = new StyleProviderRegistry(false);
			Assert.assertFalse("StyleProviderRegistry incorrectly returns true from hasStyleProvider() when class is not in registry.",
				this._registry.hasStyleProvider(BasicButton));
			
			var styleProvider:IStyleProvider = this._registry.getStyleProvider(BasicButton);
			Assert.assertTrue("StyleProviderRegistry must return true from hasStyleProvider() when class is in registry.",
				this._registry.hasStyleProvider(BasicButton));
			Assert.assertFalse("StyleProviderRegistry must return false from hasStyleProvider() when class is not in registry.",
				this._registry.hasStyleProvider(Slider));
		}

		[Test]
		public function testGetStyleProvider():void
		{
			this._registry = new StyleProviderRegistry(false);
			var styleProvider:IStyleProvider = this._registry.getStyleProvider(BasicButton);
			Assert.assertNotNull("StyleProviderRegistry must return non-null value from getStyleProvider().",
				styleProvider);
			var otherStyleProvider:IStyleProvider = this._registry.getStyleProvider(BasicButton);
			Assert.assertStrictlyEquals("StyleProviderRegistry must return same value from getStyleProvider() when called multiple times.",
				styleProvider, otherStyleProvider);
			var thirdStyleProvider:IStyleProvider = this._registry.getStyleProvider(Slider);
			Assert.assertTrue("StyleProviderRegistry must return different value from getStyleProvider() when called with different classes.",
				styleProvider !== thirdStyleProvider);
		}

		[Test]
		public function testClearStyleProvider():void
		{
			this._registry = new StyleProviderRegistry(false);
			var styleProvider:IStyleProvider = this._registry.getStyleProvider(BasicButton);
			var clearedStyleProvider:IStyleProvider = this._registry.clearStyleProvider(BasicButton);
			Assert.assertFalse("StyleProviderRegistry incorrectly returns true from hasStyleProvider() when class is cleared from registry.",
				this._registry.hasStyleProvider(BasicButton));
			Assert.assertStrictlyEquals("StyleProviderRegistry must return same value from clearStyleProvider() as getStyleProvider().",
				styleProvider, clearedStyleProvider);
		}

		[Test]
		public function testDispose():void
		{
			this._registry = new StyleProviderRegistry(false);
			var styleProvider1:IStyleProvider = this._registry.getStyleProvider(BasicButton);
			var styleProvider2:IStyleProvider = this._registry.getStyleProvider(Slider);
			this._registry.dispose();
			Assert.assertFalse("StyleProviderRegistry incorrectly returns true from hasStyleProvider() after dispose() is called.",
				this._registry.hasStyleProvider(BasicButton));
			Assert.assertFalse("StyleProviderRegistry incorrectly returns true from hasStyleProvider() after dispose() is called.",
				this._registry.hasStyleProvider(Slider));
		}

		[Test]
		public function testGetStyleProviderGlobal():void
		{
			this._registry = new StyleProviderRegistry(true);
			var styleProvider:IStyleProvider = this._registry.getStyleProvider(BasicButton);
			Assert.assertNotNull("StyleProviderRegistry must register globalStyleProvider when calling getStyleProvider().",
				BasicButton.globalStyleProvider);
			Assert.assertStrictlyEquals("StyleProviderRegistry must return same value from getStyleProvider() as it sets on globalStyleProvider.",
				BasicButton.globalStyleProvider, styleProvider);
		}

		[Test]
		public function testClearStyleProviderGlobal():void
		{
			this._registry = new StyleProviderRegistry(false);
			var styleProvider:IStyleProvider = this._registry.getStyleProvider(BasicButton);
			this._registry.clearStyleProvider(BasicButton);
			Assert.assertNull("StyleProviderRegistry failed to set globalStyleProvider to null after clearStyleProvider().",
				BasicButton.globalStyleProvider);
		}

		[Test]
		public function testDisposeGlobal():void
		{
			this._registry = new StyleProviderRegistry(false);
			var styleProvider:IStyleProvider = this._registry.getStyleProvider(BasicButton);
			this._registry.dispose();
			Assert.assertNull("StyleProviderRegistry failed to set globalStyleProvider to null after dispose().",
				BasicButton.globalStyleProvider);
		}

		[Test]
		public function testClearStyleProviderAfterChangeGlobal():void
		{
			this._registry = new StyleProviderRegistry(false);
			var styleProvider:IStyleProvider = this._registry.getStyleProvider(BasicButton);
			var replacementStyleProvider:CustomStyleProvider = new CustomStyleProvider();
			BasicButton.globalStyleProvider = replacementStyleProvider;
			this._registry.clearStyleProvider(BasicButton);
			Assert.assertStrictlyEquals("StyleProviderRegistry incorrectly set globalStyleProvider to null after clearStyleProvider() when global did not match.",
				replacementStyleProvider, BasicButton.globalStyleProvider);
			BasicButton.globalStyleProvider = null;
		}
	}
}


================================================
FILE: test/source/feathers/tests/StyleTests.as
================================================
package feathers.tests
{
	import feathers.controls.LayoutGroup;

	import org.flexunit.Assert;

	import starling.events.Event;

	public class StyleTests
	{
		private var _control:LayoutGroup;
		private var _styleProvider:FunctionStyleProviderWithEvents;
		private var _appliedStyles:Boolean = false;

		[Before]
		public function prepare():void
		{
			this._appliedStyles = false;
			this._control = new LayoutGroup();
			this._styleProvider = new FunctionStyleProviderWithEvents(setExtraStyles);
		}

		private function setExtraStyles(target:LayoutGroup):void
		{
			this._appliedStyles = true;
		}

		[After]
		public function cleanup():void
		{
			this._control.removeFromParent(true);
			this._control = null;
			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testSetStyleProviderBeforeInitialize():void
		{
			this._control.styleProvider = this._styleProvider;
			Assert.assertFalse("FeathersControl: must not apply styles before initialization", this._appliedStyles);
		}

		[Test]
		public function testSetStyleProviderAfterInitialize():void
		{
			this._control.validate();
			this._appliedStyles = false;
			this._control.styleProvider = this._styleProvider;
			Assert.assertTrue("FeathersControl: must apply styles after initialization", this._appliedStyles);
		}

		[Test]
		public function testAddToStyleNameListBeforeInitialize():void
		{
			this._control.styleProvider = this._styleProvider;
			this._control.styleNameList.add("custom-style-name");
			Assert.assertFalse("FeathersControl: when adding to style name list, must not apply styles before initialization", this._appliedStyles);
		}

		[Test]
		public function testAddToStyleNameListAfterInitialize():void
		{
			this._control.styleProvider = this._styleProvider;
			this._control.validate();
			this._appliedStyles = false;
			this._control.styleNameList.add("custom-style-name");
			Assert.assertTrue("FeathersControl: when adding to style name list, must apply styles after initialization", this._appliedStyles);
		}

		[Test]
		public function testStyleProviderChangeEventBeforeInitialize():void
		{
			this._control.styleProvider = this._styleProvider;
			this._styleProvider.dispatchEventWith(Event.CHANGE);
			Assert.assertFalse("FeathersControl: when style provider dispatches Event.CHANGE, must not apply styles before initialization", this._appliedStyles);
		}

		[Test]
		public function testStyleProviderChangeEventAfterInitialize():void
		{
			this._control.styleProvider = this._styleProvider;
			this._control.validate();
			this._appliedStyles = false;
			this._styleProvider.dispatchEventWith(Event.CHANGE);
			Assert.assertTrue("FeathersControl: when style provider dispatches Event.CHANGE, must apply styles after initialization", this._appliedStyles);
		}
	}
}

import feathers.core.IFeathersControl;
import feathers.skins.IStyleProvider;

import starling.events.EventDispatcher;

class FunctionStyleProviderWithEvents extends EventDispatcher implements IStyleProvider
{
	public function FunctionStyleProviderWithEvents(fn:Function)
	{
		this._fn = fn;
	}

	private var _fn:Function;

	public function applyStyles(target:IFeathersControl):void
	{
		this._fn(target);
	}
}

================================================
FILE: test/source/feathers/tests/TabBarEmptyDataProviderTests.as
================================================
package feathers.tests
{
	import feathers.controls.TabBar;
	import feathers.controls.ToggleButton;
	import feathers.data.ListCollection;

	import org.flexunit.Assert;

	import starling.display.Quad;
	import starling.events.Event;

	public class TabBarEmptyDataProviderTests
	{
		private var _tabBar:TabBar;

		[Before]
		public function prepare():void
		{
			this._tabBar = new TabBar();
			this._tabBar.tabFactory = function():ToggleButton
			{
				var tab:ToggleButton = new ToggleButton();
				tab.defaultSkin = new Quad(200, 200);
				return tab;
			}
			TestFeathers.starlingRoot.addChild(this._tabBar);
			this._tabBar.validate();
		}

		[After]
		public function cleanup():void
		{
			this._tabBar.removeFromParent(true);
			this._tabBar = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testNoSelection():void
		{
			Assert.assertStrictlyEquals("The selectedIndex property was not equal to -1",
				-1, this._tabBar.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not equal to null",
				null, this._tabBar.selectedItem);
		}

		[Test]
		public function testSelectFirstItemOnSetDataProvider():void
		{
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var dataProvider:ListCollection = new ListCollection(
			[
				{ label: "One" },
				{ label: "Two" },
				{ label: "Three" },
			]);
			this._tabBar.dataProvider = dataProvider;
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not equal to 0",
				0, this._tabBar.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not equal to the first item",
				dataProvider.getItemAt(0), this._tabBar.selectedItem);
		}
	}
}


================================================
FILE: test/source/feathers/tests/TabBarMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.TabBar;
	import feathers.controls.ToggleButton;
	import feathers.data.ListCollection;
	import feathers.layout.Direction;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class TabBarMeasurementTests
	{
		private static const PADDING_TOP:Number = 6;
		private static const PADDING_RIGHT:Number = 8;
		private static const PADDING_BOTTOM:Number = 2;
		private static const PADDING_LEFT:Number = 10;
		private static const GAP:Number = 5;
		private static const FIRST_GAP:Number = 7;
		private static const LAST_GAP:Number = 6;
		private static const TAB_WIDTH:Number = 200;
		private static const TAB_HEIGHT:Number = 100;
		
		private var _tabs:TabBar;

		[Before]
		public function prepare():void
		{
			this._tabs = new TabBar();
			this._tabs.tabFactory = function():ToggleButton
			{
				var tab:ToggleButton = new ToggleButton();
				tab.hasLabelTextRenderer = false;
				tab.defaultSkin = new Quad(TAB_WIDTH, TAB_HEIGHT, 0xff00ff);
				return tab;
			};
			TestFeathers.starlingRoot.addChild(this._tabs);
		}

		[After]
		public function cleanup():void
		{
			this._tabs.removeFromParent(true);
			this._tabs = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testVerticalDimensionsWithNoItems():void
		{
			this._tabs.direction = Direction.VERTICAL;
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to 0 with empty data provider.",
				0, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar height not equal to 0 with empty data provider.",
				0, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to 0 with empty data provider.",
				0, this._tabs.minWidth);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to 0 with empty data provider.",
				0, this._tabs.minHeight);
		}

		[Test]
		public function testVerticalDimensionsWithPaddingGapAndNoItems():void
		{
			this._tabs.direction = Direction.VERTICAL;
			this._tabs.paddingTop = PADDING_TOP;
			this._tabs.paddingRight = PADDING_RIGHT;
			this._tabs.paddingBottom = PADDING_BOTTOM;
			this._tabs.paddingLeft = PADDING_LEFT;
			this._tabs.gap = GAP;
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to sum of left and right padding with empty data provider.", PADDING_LEFT + PADDING_RIGHT, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar height not equal to sum of top and bottom padding with empty data provider.", PADDING_TOP + PADDING_BOTTOM, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to sum of left and right padding with empty data provider.", PADDING_LEFT + PADDING_RIGHT, this._tabs.minWidth);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to sum of top and bottom padding with empty data provider.", PADDING_TOP + PADDING_BOTTOM, this._tabs.minHeight);
		}

		[Test]
		public function testVerticalDimensionsWithOneChild():void
		{
			this._tabs.direction = Direction.VERTICAL;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to one button width.", TAB_WIDTH, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar height not equal to one button height.", TAB_HEIGHT, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to one button width.", TAB_WIDTH, this._tabs.minWidth);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to one button height.", TAB_HEIGHT, this._tabs.minHeight);
		}

		[Test]
		public function testVerticalDimensionsWithPaddingGapAndOneChild():void
		{
			this._tabs.direction = Direction.VERTICAL;
			this._tabs.paddingTop = PADDING_TOP;
			this._tabs.paddingRight = PADDING_RIGHT;
			this._tabs.paddingBottom = PADDING_BOTTOM;
			this._tabs.paddingLeft = PADDING_LEFT;
			this._tabs.gap = GAP;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to sum of left and right padding and width of tab.", TAB_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar height not equal to sum of top and bottom padding and height of tab.", TAB_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to sum of left and right padding and width of tab.", TAB_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._tabs.minWidth);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to sum of top and bottom padding and height of tab.", TAB_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._tabs.minHeight);
		}

		[Test]
		public function testVerticalDimensionsWithTwoChildren():void
		{
			this._tabs.direction = Direction.VERTICAL;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to max width of tabs.", TAB_WIDTH, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar height not equal to sum of tab heights.", TAB_HEIGHT * 2, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to max width of tabs.", TAB_WIDTH, this._tabs.minWidth);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to sum of tab heights.", TAB_HEIGHT * 2, this._tabs.minHeight);
		}

		[Test]
		public function testVerticalDimensionsWithPaddingGapAndTwoChildren():void
		{
			this._tabs.direction = Direction.VERTICAL;
			this._tabs.paddingTop = PADDING_TOP;
			this._tabs.paddingRight = PADDING_RIGHT;
			this._tabs.paddingBottom = PADDING_BOTTOM;
			this._tabs.paddingLeft = PADDING_LEFT;
			this._tabs.gap = GAP;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to sum of left and right padding and max width of tabs.", TAB_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar height not equal to sum of top and bottom padding, gap, and sum of tab heights.", TAB_HEIGHT * 2 + GAP + PADDING_TOP + PADDING_BOTTOM, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to sum of left and right padding and max width of tabs.", TAB_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._tabs.minWidth);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to sum of top and bottom padding, gap, and sum of tab heights.", TAB_HEIGHT * 2 + GAP + PADDING_TOP + PADDING_BOTTOM, this._tabs.minHeight);
		}

		[Test]
		public function testVerticalHeightWithFirstGapAndTwoChildren():void
		{
			this._tabs.direction = Direction.VERTICAL;
			this._tabs.gap = GAP;
			this._tabs.firstGap = FIRST_GAP;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar height not equal to first gap plus sum of tab heights.", TAB_HEIGHT * 2 + FIRST_GAP, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to first gap plus sum of tab heights.", TAB_HEIGHT * 2 + FIRST_GAP, this._tabs.minHeight);
		}

		[Test]
		public function testVerticalHeightWithLastGapAndTwoChildren():void
		{
			this._tabs.direction = Direction.VERTICAL;
			this._tabs.gap = GAP;
			this._tabs.lastGap = LAST_GAP;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar height not equal to gap plus sum of tab heights when using last gap with two tabs.", TAB_HEIGHT * 2 + GAP, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to gap plus sum of tab heights when using last gap with two tabs.", TAB_HEIGHT * 2 + GAP, this._tabs.minHeight);
		}

		[Test]
		public function testVerticalHeightWithFirstGapAndThreeChildren():void
		{
			this._tabs.direction = Direction.VERTICAL;
			this._tabs.gap = GAP;
			this._tabs.firstGap = FIRST_GAP;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
				{},
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar height not equal to sum of tab heights, plus first gap, plus gap, with three tabs.", TAB_HEIGHT * 3 + GAP + FIRST_GAP, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to sum of tab heights, plus first gap, plus gap, with three tabs.", TAB_HEIGHT * 3 + GAP + FIRST_GAP, this._tabs.minHeight);
		}

		[Test]
		public function testVerticalHeightWithLastGapAndThreeChildren():void
		{
			this._tabs.direction = Direction.VERTICAL;
			this._tabs.gap = GAP;
			this._tabs.lastGap = LAST_GAP;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
				{},
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar height not equal to sum of tab heights, plus gap, plus last gap, with three tabs.", TAB_HEIGHT * 3 + GAP + LAST_GAP, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to sum of tab heights, plus gap, plus last gap, with three tabs.", TAB_HEIGHT * 3 + GAP + LAST_GAP, this._tabs.minHeight);
		}

		[Test]
		public function testVerticalHeightWithFirstAndLastGapAndFourChildren():void
		{
			this._tabs.direction = Direction.VERTICAL;
			this._tabs.gap = GAP;
			this._tabs.firstGap = FIRST_GAP;
			this._tabs.lastGap = LAST_GAP;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
				{},
				{},
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar height not equal to sum of tab heights, plus first gap, plus gap, plus last gap, with four tabs.", TAB_HEIGHT * 4 + FIRST_GAP + GAP + LAST_GAP, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to sum of tab heights, plus first gap, plus gap, plus last gap, with four tabs.", TAB_HEIGHT * 4 + FIRST_GAP + GAP + LAST_GAP, this._tabs.minHeight);
		}

		[Test]
		public function testHorizontalDimensionsWithNoChildren():void
		{
			this._tabs.direction = Direction.HORIZONTAL;
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to 0 with no tabs.", 0, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar height not equal to 0 with no tabs.", 0, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to 0 with no tabs.", 0, this._tabs.minWidth);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to 0 with no tabs.", 0, this._tabs.minHeight);
		}

		[Test]
		public function testHorizontalDimensionsWithPaddingGapAndNoChildren():void
		{
			this._tabs.direction = Direction.HORIZONTAL;
			this._tabs.paddingTop = PADDING_TOP;
			this._tabs.paddingRight = PADDING_RIGHT;
			this._tabs.paddingBottom = PADDING_BOTTOM;
			this._tabs.paddingLeft = PADDING_LEFT;
			this._tabs.gap = GAP;
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to sum of left and right padding with no tabs.", PADDING_LEFT + PADDING_RIGHT, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar height not equal to sum of top and bottom padding with no tabs.", PADDING_TOP + PADDING_BOTTOM, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to sum of left and right padding with no tabs.", PADDING_LEFT + PADDING_RIGHT, this._tabs.minWidth);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to sum of top and bottom padding with no tabs.", PADDING_TOP + PADDING_BOTTOM, this._tabs.minHeight);
		}

		[Test]
		public function testHorizontalDimensionsWithOneChild():void
		{
			this._tabs.direction = Direction.HORIZONTAL;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to tab width.", TAB_WIDTH, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar height not equal to tab height.", TAB_HEIGHT, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to tab width.", TAB_WIDTH, this._tabs.minWidth);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to tab height.", TAB_HEIGHT, this._tabs.minHeight);
		}

		[Test]
		public function testHorizontalDimensionsWithPaddingGapAndOneChild():void
		{
			this._tabs.direction = Direction.HORIZONTAL;
			this._tabs.paddingTop = PADDING_TOP;
			this._tabs.paddingRight = PADDING_RIGHT;
			this._tabs.paddingBottom = PADDING_BOTTOM;
			this._tabs.paddingLeft = PADDING_LEFT;
			this._tabs.gap = GAP;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to sum of left and right padding and width of tab.", TAB_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar height not equal to sum of top and bottom padding and height of tab.", TAB_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to sum of left and right padding and width of tab.", TAB_WIDTH + PADDING_LEFT + PADDING_RIGHT, this._tabs.minWidth);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to sum of top and bottom padding and height of tab.", TAB_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._tabs.minHeight);
		}

		[Test]
		public function testHorizontalDimensionsWithTwoChildren():void
		{
			this._tabs.direction = Direction.HORIZONTAL;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to sum of tab widths.", TAB_WIDTH * 2, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar height not equal to max height of tabs.", TAB_HEIGHT, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to sum of tab widths.", TAB_WIDTH * 2, this._tabs.minWidth);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to max height of tabs.", TAB_HEIGHT, this._tabs.minHeight);
		}

		[Test]
		public function testHorizontalDimensionsWithPaddingGapAndTwoChildren():void
		{
			this._tabs.direction = Direction.HORIZONTAL;
			this._tabs.paddingTop = PADDING_TOP;
			this._tabs.paddingRight = PADDING_RIGHT;
			this._tabs.paddingBottom = PADDING_BOTTOM;
			this._tabs.paddingLeft = PADDING_LEFT;
			this._tabs.gap = GAP;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to sum of left and right padding, gap, and sum of tab widths.", TAB_WIDTH * 2 + GAP + PADDING_LEFT + PADDING_RIGHT, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar height not equal to sum of top and bottom padding and max height of tabs.", TAB_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._tabs.height);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to sum of left and right padding, gap, and sum of tab widths.", TAB_WIDTH * 2 + GAP + PADDING_LEFT + PADDING_RIGHT, this._tabs.minWidth);
			Assert.assertStrictlyEquals("TabBar minHeight not equal to sum of top and bottom padding and max height of tabs.", TAB_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this._tabs.minHeight);
		}

		[Test]
		public function testHorizontalWidthWithGapAndTwoChildren():void
		{
			this._tabs.direction = Direction.HORIZONTAL;
			this._tabs.gap = GAP;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to gap plus sum of tab widths.", TAB_WIDTH * 2 + GAP, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to gap plus sum of tab widths.", TAB_WIDTH * 2 + GAP, this._tabs.minWidth);
		}

		[Test]
		public function testHorizontalWidthWithFirstGapAndTwoChildren():void
		{
			this._tabs.direction = Direction.HORIZONTAL;
			this._tabs.gap = GAP;
			this._tabs.firstGap = FIRST_GAP;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to gap plus sum of tab widths.", TAB_WIDTH * 2 + FIRST_GAP, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to gap plus sum of tab widths.", TAB_WIDTH * 2 + FIRST_GAP, this._tabs.minWidth);
		}

		[Test]
		public function testHorizontalWidthWithLastGapAndTwoChildren():void
		{
			this._tabs.direction = Direction.HORIZONTAL;
			this._tabs.gap = GAP;
			this._tabs.lastGap = LAST_GAP;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to gap plus sum of tab widths when using last gap with two tabs.", TAB_WIDTH * 2 + GAP, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to gap plus sum of tab widths when using last gap with two tabs.", TAB_WIDTH * 2 + GAP, this._tabs.minWidth);
		}

		[Test]
		public function testHorizontalWidthWithFirstGapAndThreeChildren():void
		{
			this._tabs.direction = Direction.HORIZONTAL;
			this._tabs.gap = GAP;
			this._tabs.firstGap = FIRST_GAP;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
				{},
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to sum of tab widths, plus first gap, plus gap, with three tabs.", TAB_WIDTH * 3 + GAP + FIRST_GAP, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to sum of tab widths, plus first gap, plus gap, with three tabs.", TAB_WIDTH * 3 + GAP + FIRST_GAP, this._tabs.minWidth);
		}

		[Test]
		public function testHorizontalWidthWithLastGapAndThreeChildren():void
		{
			this._tabs.direction = Direction.HORIZONTAL;
			this._tabs.gap = GAP;
			this._tabs.lastGap = LAST_GAP;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
				{},
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to sum of tab widths, plus gap, plus last gap, with three tabs.", TAB_WIDTH * 3 + GAP + LAST_GAP, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to sum of tab widths, plus gap, plus last gap, with three tabs.", TAB_WIDTH * 3 + GAP + LAST_GAP, this._tabs.minWidth);
		}

		[Test]
		public function testHorizontalWidthWithFirstAndLastGapAndFourChildren():void
		{
			this._tabs.direction = Direction.HORIZONTAL;
			this._tabs.gap = GAP;
			this._tabs.firstGap = FIRST_GAP;
			this._tabs.lastGap = LAST_GAP;
			this._tabs.dataProvider = new ListCollection(
			[
				{},
				{},
				{},
				{},
			]);
			this._tabs.validate();
			Assert.assertStrictlyEquals("TabBar width not equal to sum of tab widths, plus first gap, plus gap, plus last gap, with four tabs.", TAB_WIDTH * 4 + FIRST_GAP + GAP + LAST_GAP, this._tabs.width);
			Assert.assertStrictlyEquals("TabBar minWidth not equal to sum of tab widths, plus first gap, plus gap, plus last gap, with four tabs.", TAB_WIDTH * 4 + FIRST_GAP + GAP + LAST_GAP, this._tabs.minWidth);
		}
	}
}


================================================
FILE: test/source/feathers/tests/TabBarTests.as
================================================
package feathers.tests
{
	import feathers.controls.TabBar;
	import feathers.controls.ToggleButton;
	import feathers.data.ListCollection;
	import feathers.tests.supportClasses.DisposeFlagQuad;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class TabBarTests
	{
		private var _tabBar:TabBar;
		private var _icon:DisposeFlagQuad;

		[Before]
		public function prepare():void
		{
			this._icon = new DisposeFlagQuad();

			this._tabBar = new TabBar();
			this._tabBar.dataProvider = new ListCollection(
			[
				{ label: "One", name: "one" },
				{ label: "Two" },
				{ label: "Three", isEnabled: true, name: "three", defaultIcon: this._icon },
				{ label: "Four", isEnabled: false, name: "four" },
			]);
			this._tabBar.tabFactory = function():ToggleButton
			{
				var tab:ToggleButton = new ToggleButton();
				tab.defaultSkin = new Quad(200, 200);
				return tab;
			}
			TestFeathers.starlingRoot.addChild(this._tabBar);
			this._tabBar.validate();
		}

		[After]
		public function cleanup():void
		{
			this._tabBar.removeFromParent(true);
			this._tabBar = null;

			this._icon.removeFromParent(true);
			this._icon = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testProgrammaticSelectedIndexChange():void
		{
			var beforeSelectedIndex:int = this._tabBar.selectedIndex;
			var beforeSelectedItem:Object = this._tabBar.selectedItem;
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tabBar.selectedIndex = 1;
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The selectedIndex property was not changed",
				beforeSelectedIndex === this._tabBar.selectedIndex);
			Assert.assertFalse("The selectedItem property was not changed",
				beforeSelectedItem === this._tabBar.selectedItem);
		}

		[Test]
		public function testProgrammaticSelectedItemChange():void
		{
			var beforeSelectedIndex:int = this._tabBar.selectedIndex;
			var beforeSelectedItem:Object = this._tabBar.selectedItem;
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tabBar.selectedItem = this._tabBar.dataProvider.getItemAt(1);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The selectedIndex property was not changed",
				beforeSelectedIndex === this._tabBar.selectedIndex);
			Assert.assertFalse("The selectedItem property was not changed",
				beforeSelectedItem === this._tabBar.selectedItem);
		}

		[Test]
		public function testProgrammaticSelectedIndexChangeWithAnimation():void
		{
			var beforeSelectedIndex:int = this._tabBar.selectedIndex;
			var beforeSelectedItem:Object = this._tabBar.selectedItem;
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tabBar.setSelectedIndexWithAnimation(1);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The selectedIndex property was not changed",
				beforeSelectedIndex === this._tabBar.selectedIndex);
			Assert.assertFalse("The selectedItem property was not changed",
				beforeSelectedItem === this._tabBar.selectedItem);
		}

		[Test]
		public function testProgrammaticSelectedItemChangeWithAnimation():void
		{
			var beforeSelectedIndex:int = this._tabBar.selectedIndex;
			var beforeSelectedItem:Object = this._tabBar.selectedItem;
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tabBar.setSelectedItemWithAnimation(this._tabBar.dataProvider.getItemAt(1));
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The selectedIndex property was not changed",
				beforeSelectedIndex === this._tabBar.selectedIndex);
			Assert.assertFalse("The selectedItem property was not changed",
				beforeSelectedItem === this._tabBar.selectedItem);
		}

		[Test]
		public function testInteractiveSelectionChange():void
		{
			var beforeSelectedIndex:int = this._tabBar.selectedIndex;
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(210, 10);
			var target:DisplayObject = this._tabBar.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The selectedIndex property was not changed",
				beforeSelectedIndex === this._tabBar.selectedIndex);
		}

		[Test]
		public function testRemoveItemBeforeSelectedIndex():void
		{
			this._tabBar.selectedIndex = 1;
			var beforeSelectedIndex:int = this._tabBar.selectedIndex;
			var beforeSelectedItem:Object = this._tabBar.selectedItem;
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tabBar.dataProvider.removeItemAt(0);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed",
				beforeSelectedIndex - 1, this._tabBar.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was incorrectly changed",
				beforeSelectedItem, this._tabBar.selectedItem);
		}

		[Test]
		public function testRemoveItemAfterSelectedIndex():void
		{
			this._tabBar.selectedIndex = 1;
			var beforeSelectedIndex:int = this._tabBar.selectedIndex;
			var beforeSelectedItem:Object = this._tabBar.selectedItem;
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tabBar.dataProvider.removeItemAt(2);
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was incorrectly changed",
				beforeSelectedIndex, this._tabBar.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was incorrectly changed",
				beforeSelectedItem, this._tabBar.selectedItem);
		}

		[Test]
		public function testRemoveSelectedIndex():void
		{
			this._tabBar.selectedIndex = 1;
			var beforeSelectedIndex:int = this._tabBar.selectedIndex;
			var beforeSelectedItem:Object = this._tabBar.selectedItem;
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tabBar.dataProvider.removeItemAt(1);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was incorrectly changed",
				beforeSelectedIndex, this._tabBar.selectedIndex);
			Assert.assertFalse("The selectedItem property was not changed",
				beforeSelectedItem === this._tabBar.selectedItem);
		}

		[Test]
		public function testReplaceItemAtSelectedIndex():void
		{
			this._tabBar.selectedIndex = 1;
			var beforeSelectedIndex:int = this._tabBar.selectedIndex;
			var beforeSelectedItem:Object = this._tabBar.selectedItem;
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tabBar.dataProvider.setItemAt({ label: "New Item" }, beforeSelectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was incorrectly changed",
				beforeSelectedIndex, this._tabBar.selectedIndex);
			Assert.assertFalse("The selectedItem property was not changed",
				beforeSelectedItem === this._tabBar.selectedItem);
		}

		[Test]
		public function testDeselectAllOnNullDataProvider():void
		{
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tabBar.dataProvider = null;
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not set to -1",
				-1, this._tabBar.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not set to null",
				null, this._tabBar.selectedItem);
		}

		[Test]
		public function testDeselectAllOnDataProviderRemoveAll():void
		{
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tabBar.dataProvider.removeAll();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not set to -1",
				-1, this._tabBar.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not set to null",
				null, this._tabBar.selectedItem);
		}

		[Test]
		public function testAddItemBeforeSelectedIndex():void
		{
			this._tabBar.selectedIndex = 1;
			var hasChanged:Boolean = false;
			var beforeSelectedIndex:int = this._tabBar.selectedIndex;
			var beforeSelectedItem:Object = this._tabBar.selectedItem;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tabBar.dataProvider.addItemAt({label: "New Item"}, 0);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed",
				beforeSelectedIndex + 1, this._tabBar.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was incorrectly changed",
				beforeSelectedItem, this._tabBar.selectedItem);
		}

		[Test]
		public function testDisposeWithoutChangeEvent():void
		{
			this._tabBar.selectedIndex = 1;
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tabBar.dispose();
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched", hasChanged);
		}

		[Test]
		public function testDisableAndReenable():void
		{
			this._tabBar.isEnabled = false;
			this._tabBar.validate();
			this._tabBar.isEnabled = true;
			this._tabBar.validate();
			var tab1:ToggleButton = ToggleButton(this._tabBar.getChildByName("one"));
			var tab3:ToggleButton = ToggleButton(this._tabBar.getChildByName("three"));
			var tab4:ToggleButton = ToggleButton(this._tabBar.getChildByName("four"));
			Assert.assertTrue("Tab without isEnabled value in data provider is not enabled when TabBar is disabled and then re-enabled", tab1.isEnabled);
			Assert.assertTrue("Tab with isEnabled value set to true in data provider is not enabled when TabBar is disabled and then re-enabled", tab3.isEnabled);
			Assert.assertFalse("Tab with isEnabled value set to false in data provider is not disabled when TabBar is disabled and then re-enabled", tab4.isEnabled);
		}

		[Test]
		public function testDisable():void
		{
			this._tabBar.isEnabled = false;
			this._tabBar.validate();
			var tab1:ToggleButton = ToggleButton(this._tabBar.getChildByName("one"));
			var tab3:ToggleButton = ToggleButton(this._tabBar.getChildByName("three"));
			var tab4:ToggleButton = ToggleButton(this._tabBar.getChildByName("four"));
			Assert.assertFalse("Tab without isEnabled value in data provider is incorrectly enabled when TabBar is disabled", tab1.isEnabled);
			Assert.assertFalse("Tab with isEnabled value set to true in data provider is incorrectly enabled when TabBar is disabled", tab3.isEnabled);
			Assert.assertFalse("Tab with isEnabled value set to false in data provider is incorrectly enabled when TabBar is disabled", tab4.isEnabled);
		}

		[Test]
		public function testIconNotDisposed():void
		{
			this._tabBar.validate();
			this._tabBar.dispose();
			Assert.assertFalse("Tab icon incorrectly disposed.", this._icon.isDisposed);
		}

		[Test]
		public function testFilterAll():void
		{
			var selectedIndex:int = 1;
			this._tabBar.selectedIndex = selectedIndex;
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var selectedItem:Object = this._tabBar.dataProvider.getItemAt(selectedIndex);
			this._tabBar.dataProvider.filterFunction = function(item:Object):Boolean
			{
				return false;
			};
			Assert.assertTrue("Event.CHANGE must be dispatched when all items are filtered", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property must be -1 if all items are filtered",
				-1, this._tabBar.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property must be null if all items are filtered",
				null, this._tabBar.selectedItem);
		}

		[Test]
		public function testFilterSelectedIndex():void
		{
			var selectedIndex:int = 1;
			var newSelectedItem:Object = this._tabBar.dataProvider.getItemAt(selectedIndex + 1);
			this._tabBar.selectedIndex = 1;
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var selectedItem:Object = this._tabBar.dataProvider.getItemAt(selectedIndex);
			this._tabBar.dataProvider.filterFunction = function(item:Object):Boolean
			{
				return item !== selectedItem;
			};
			Assert.assertTrue("Event.CHANGE must be dispatched when item is filtered", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property must not change when selected item is filtered",
				selectedIndex, this._tabBar.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not changed when selected item is filtered",
				newSelectedItem, this._tabBar.selectedItem);
		}

		[Test]
		public function testFilterSelectedIndexGreaterThanNewLength():void
		{
			var selectedIndex:int = 3;
			var newSelectedItem:Object = this._tabBar.dataProvider.getItemAt(selectedIndex - 1);
			this._tabBar.selectedIndex = selectedIndex;
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var selectedItem:Object = this._tabBar.dataProvider.getItemAt(selectedIndex);
			this._tabBar.dataProvider.filterFunction = function(item:Object):Boolean
			{
				return item !== selectedItem;
			};
			Assert.assertTrue("Event.CHANGE must be dispatched when item is filtered", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed when selected item is filtered and index is >= length",
				selectedIndex - 1, this._tabBar.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not changed when selected item is filtered",
				newSelectedItem, this._tabBar.selectedItem);
		}

		[Test]
		public function testSelectionChangeOnSortChange():void
		{
			this._tabBar.selectedIndex = this._tabBar.dataProvider.length - 1;
			var oldSelectedItem:Object = this._tabBar.dataProvider.getItemAt(this._tabBar.dataProvider.length - 1);
			var hasChanged:Boolean = false;
			this._tabBar.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tabBar.dataProvider.sortCompareFunction = function(a:Object, b:Object):int
			{
				var aIndex:int = _tabBar.dataProvider.getItemIndex(a);
				var bIndex:int = _tabBar.dataProvider.getItemIndex(b);
				if(aIndex < bIndex)
				{
					return 1;
				}
				else if(aIndex > bIndex)
				{
					return -1;
				}
				return 0;
			}
			this._tabBar.dataProvider.refresh();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("Incorrect selectedIndex after sort change",
				0, this._tabBar.selectedIndex);
			Assert.assertStrictlyEquals("Incorrect selectedItem after sort change",
				oldSelectedItem, this._tabBar.selectedItem);
		}
	}
}


================================================
FILE: test/source/feathers/tests/TabNavigatorTests.as
================================================
package feathers.tests
{
	import feathers.controls.TabNavigator;
	import feathers.controls.TabNavigatorItem;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;

	public class TabNavigatorTests
	{
		public static const SCREEN_A_ID:String = "a";
		public static const SCREEN_B_ID:String = "b";
		public static const SCREEN_A_LABEL:String = "Screen A";
		public static const SCREEN_B_LABEL:String = "Screen B";

		private var _navigator:TabNavigator;

		[Before]
		public function prepare():void
		{
			this._navigator = new TabNavigator();
			TestFeathers.starlingRoot.addChild(this._navigator);
			this._navigator.validate();
		}

		[After]
		public function cleanup():void
		{
			this._navigator.removeFromParent(true);
			this._navigator = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.",
				0, TestFeathers.starlingRoot.numChildren);
		}

		private function addScreenA():void
		{
			var screen:Quad = new Quad(10, 10, 0xff00ff);
			var item:TabNavigatorItem = new TabNavigatorItem(screen, SCREEN_A_LABEL);
			this._navigator.addScreen(SCREEN_A_ID, item);
			Assert.assertStrictlyEquals("screenDisplayObject does not return correct value",
				screen, item.screenDisplayObject);
		}

		private function addScreenB():void
		{
			var screen:Quad = new Quad(10, 10, 0xffff00);
			var item:TabNavigatorItem = new TabNavigatorItem(screen, SCREEN_B_LABEL);
			this._navigator.addScreen(SCREEN_B_ID, item);
		}

		[Test]
		public function testHasScreenWhenNotAdded():void
		{
			Assert.assertFalse("hasScreen() incorrectly returned true for a screen that was not added",
				this._navigator.hasScreen(SCREEN_A_ID));
		}

		[Test]
		public function testHasScreen():void
		{
			this.addScreenA();
			Assert.assertTrue("hasScreen() incorrectly returned false for a screen that was added",
				this._navigator.hasScreen(SCREEN_A_ID));
		}

		[Test]
		public function testStateWithNoTabs():void
		{
			Assert.assertNull("activeScreen returned incorrect value for no tabs",
				this._navigator.activeScreen);
			Assert.assertNull("activeScreenID returned incorrect value for no tabs",
				this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("selectedIndex returned incorrect value for no tabs",
				-1, this._navigator.selectedIndex);
		}

		[Test]
		public function testStateWithOneTab():void
		{
			this.addScreenA();
			Assert.assertStrictlyEquals("activeScreen returned incorrect value for first tab",
				this._navigator.getScreen(SCREEN_A_ID).screenDisplayObject, this._navigator.activeScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value for first tab",
				SCREEN_A_ID, this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("selectedIndex returned incorrect value for first tab",
				0, this._navigator.selectedIndex);
		}

		[Test]
		public function testSetSelectedIndexToNegativeOne():void
		{
			this.addScreenA();
			this._navigator.selectedIndex = -1;
			Assert.assertNull("activeScreen returned incorrect value after selectedIndex = -1",
				this._navigator.activeScreen);
			Assert.assertNull("activeScreenID returned incorrect value after selectedIndex = -1",
				this._navigator.activeScreenID);
			Assert.assertStrictlyEquals("selectedIndex returned incorrect value after selectedIndex = -1",
				-1, this._navigator.selectedIndex);
		}

		[Test]
		public function testChangeSelectedIndex():void
		{
			var hasChanged:Boolean = false;
			this.addScreenA();
			this.addScreenB();
			var newSelectedIndex:int = -1;
			var newActiveScreen:DisplayObject;
			var newActiveScreenID:String;
			this._navigator.addEventListener(Event.CHANGE, function(event:Event):void
			{
				var navigator:TabNavigator = TabNavigator(event.currentTarget);
				newSelectedIndex = navigator.selectedIndex;
				newActiveScreen = navigator.activeScreen;
				newActiveScreenID = navigator.activeScreenID;
				hasChanged = true;
			});
			this._navigator.selectedIndex = 1;
			Assert.assertStrictlyEquals("activeScreen returned incorrect value for second tab after set selectedIndex",
				this._navigator.getScreen(SCREEN_B_ID).screenDisplayObject, newActiveScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value for second tab after set selectedIndex",
				SCREEN_B_ID, newActiveScreenID);
			Assert.assertStrictlyEquals("selectedIndex returned incorrect value for second tab after set selectedIndex",
				1, newSelectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched",
				hasChanged);
		}

		[Test]
		public function testShowScreen():void
		{
			var hasChanged:Boolean = false;
			this.addScreenA();
			this.addScreenB();
			var newSelectedIndex:int = -1;
			var newActiveScreen:DisplayObject;
			var newActiveScreenID:String;
			this._navigator.addEventListener(Event.CHANGE, function(event:Event):void
			{
				var navigator:TabNavigator = TabNavigator(event.currentTarget);
				newSelectedIndex = navigator.selectedIndex;
				newActiveScreen = navigator.activeScreen;
				newActiveScreenID = navigator.activeScreenID;
				hasChanged = true;
			});
			this._navigator.showScreen(SCREEN_B_ID);
			Assert.assertStrictlyEquals("activeScreen returned incorrect value for second tab after showScreen()",
				this._navigator.getScreen(SCREEN_B_ID).screenDisplayObject, newActiveScreen);
			Assert.assertStrictlyEquals("activeScreenID returned incorrect value for second tab after showScreen()",
				SCREEN_B_ID, newActiveScreenID);
			Assert.assertStrictlyEquals("selectedIndex returned incorrect value for second tab after showScreen()",
				1, newSelectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched",
				hasChanged);
		}
	}
}


================================================
FILE: test/source/feathers/tests/TapToSelectTests.as
================================================
package feathers.tests
{
	import feathers.tests.supportClasses.CustomToggle;
	import feathers.utils.touch.TapToSelect;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class TapToSelectTests
	{
		private var _target:CustomToggle;
		private var _blocker:Quad;
		private var _tapToSelect:TapToSelect;

		[Before]
		public function prepare():void
		{
			this._target = new CustomToggle();
			TestFeathers.starlingRoot.addChild(this._target);
			this._target.validate();

			this._tapToSelect = new TapToSelect(this._target);
		}

		[After]
		public function cleanup():void
		{
			this._target.removeFromParent(true);
			this._target = null;

			if(this._blocker)
			{
				this._blocker.removeFromParent(true);
				this._blocker = null;
			}

			this._tapToSelect = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testChangeEvent():void
		{
			this._target.isSelected = false;
			
			var hasChanged:Boolean = false;
			this._target.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("isSelected was not changed to true after tap", this._target.isSelected);
		}

		[Test]
		public function testDisabled():void
		{
			this._target.isSelected = false;
			this._tapToSelect.isEnabled = false;
			
			var hasChanged:Boolean = false;
			this._target.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched when disabled", hasChanged);
			Assert.assertFalse("isSelected was incorrectly changed to true after tap when disabled", this._target.isSelected);
		}

		[Test]
		public function testTouchMoveOutsideBeforeChangeEvent():void
		{
			this._target.isSelected = false;
			
			var hasChanged:Boolean = false;
			this._target.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.globalX = 1000; //move the touch way outside the bounds of the button
			touch.phase = TouchPhase.MOVED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched after touch moved out of bounds", hasChanged);
			Assert.assertFalse("isSelected was incorrectly changed to true after touch moved out of bounds", this._target.isSelected);
		}

		[Test]
		public function testOtherDisplayObjectBlockingChangeEvent():void
		{
			this._target.isSelected = false;
			
			var hasChanged:Boolean = false;
			this._target.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			this._blocker = new Quad(200, 200, 0xff0000);
			TestFeathers.starlingRoot.addChild(this._blocker);

			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertFalse("Event.CHANGE was incorrectly dispatched when another display object blocked the touch", hasChanged);
			Assert.assertFalse("isSelected was incorrectly changed to true when another display object blocked the touch", this._target.isSelected);
		}

		[Test]
		public function testDeselect():void
		{
			this._tapToSelect.tapToDeselect = true;
			this._target.isSelected = true;
			
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertFalse("isSelected was not changed to false when tapToDeselect set to true", this._target.isSelected);
		}

		[Test]
		public function testDisabledDeselect():void
		{
			this._tapToSelect.tapToDeselect = false;
			this._target.isSelected = true;

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("isSelected was incorrectly changed to false when tapToDeselect set to false", this._target.isSelected);
		}

		[Test]
		public function testRemovedBeforeTriggeredEvent():void
		{
			this._target.isSelected = false;

			var hasChanged:Boolean = false;
			this._target.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			this._target.removeFromParent(false);

			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			//while it's good to check that Event.CHANGE isn't dispatched,
			//this test also ensures that no runtime errors are thrown after the
			//target is removed (its stage property is null, and that is used
			//by TapToSelect)

			Assert.assertFalse("Event.CHANGE was incorrectly dispatched when target was removed", hasChanged);
			Assert.assertFalse("isSelected was incorrectly changed to true when target was removed", this._target.isSelected);
		}

		[Test]
		public function testCustomHitTest():void
		{
			this._tapToSelect.customHitTest = function customHitTest(localPosition:Point):Boolean
			{
				return localPosition.x <= 100;
			};
			var hasChanged:Boolean = false;
			this._target.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.CHANGE was not dispatched when customHitTest returned true", hasChanged);

			hasChanged = false;
			//move the touch to an area where customHitTest() will return false
			touch.globalX = 150;
			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched when customHitTest returned false", hasChanged);

			hasChanged = false;
			//move the touch way outside the bounds of the target
			touch.globalX = 1000;
			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched when touch started out of bounds", hasChanged);
		}
	}
}

================================================
FILE: test/source/feathers/tests/TapToTriggerTests.as
================================================
package feathers.tests
{
	import feathers.utils.touch.TapToTrigger;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class TapToTriggerTests
	{
		private var _target:Quad;
		private var _blocker:Quad;
		private var _tapToTrigger:TapToTrigger;

		[Before]
		public function prepare():void
		{
			this._target = new Quad(200, 200, 0xff00ff);
			TestFeathers.starlingRoot.addChild(this._target);

			this._tapToTrigger = new TapToTrigger(this._target);
		}

		[After]
		public function cleanup():void
		{
			this._target.removeFromParent(true);
			this._target = null;

			if(this._blocker)
			{
				this._blocker.removeFromParent(true);
				this._blocker = null;
			}

			this._tapToTrigger = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testTriggeredEvent():void
		{
			var hasTriggered:Boolean = false;
			this._target.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the target.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.TRIGGERED was not dispatched", hasTriggered);
		}

		[Test]
		public function testDisabled():void
		{
			this._tapToTrigger.isEnabled = false;

			var hasTriggered:Boolean = false;
			this._target.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the target.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertFalse("Event.TRIGGERED was incorrectly dispatched when disabled", hasTriggered);
		}

		[Test]
		public function testTouchMoveOutsideBeforeTriggeredEvent():void
		{
			var hasTriggered:Boolean = false;
			this._target.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//move the touch way outside the bounds of the target
			touch.globalX = 1000;
			touch.phase = TouchPhase.MOVED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertFalse("Event.TRIGGERED was incorrectly dispatched when touch moved out of bounds", hasTriggered);
		}

		[Test]
		public function testOtherDisplayObjectBlockingTriggeredEvent():void
		{
			var hasTriggered:Boolean = false;
			this._target.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			this._blocker = new Quad(200, 200, 0xff0000);
			TestFeathers.starlingRoot.addChild(this._blocker);

			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertFalse("Event.TRIGGERED was incorrectly dispatched when another display object blocked the touch", hasTriggered);
		}

		[Test]
		public function testRemovedBeforeTriggeredEvent():void
		{
			var hasTriggered:Boolean = false;
			this._target.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			this._target.removeFromParent(false);

			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			//while it's good to check that Event.TRIGGERED isn't dispatched,
			//this test also ensures that no runtime errors are thrown after the
			//target is removed (its stage property is null, and that is used
			//by TapToTrigger)
			Assert.assertFalse("Event.TRIGGERED was incorrectly dispatched when target was removed", hasTriggered);
		}

		[Test]
		public function testCustomHitTest():void
		{
			this._tapToTrigger.customHitTest = function customHitTest(localPosition:Point):Boolean
			{
				return localPosition.x <= 100;
			};
			var hasTriggered:Boolean = false;
			this._target.addEventListener(Event.TRIGGERED, function(event:Event):void
			{
				hasTriggered = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.TRIGGERED was not dispatched when customHitTest returned true", hasTriggered);

			hasTriggered = false;
			//move the touch to an area where customHitTest() will return false
			touch.globalX = 150;
			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertFalse("Event.TRIGGERED was incorrectly dispatched when customHitTest returned false", hasTriggered);

			hasTriggered = false;
			//move the touch way outside the bounds of the target
			touch.globalX = 1000;
			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertFalse("Event.TRIGGERED was incorrectly dispatched when touch started out of bounds", hasTriggered);
		}
	}
}


================================================
FILE: test/source/feathers/tests/TextAreaFocusTests.as
================================================
package feathers.tests
{
	import feathers.controls.TextArea;
	import feathers.controls.text.TextFieldTextEditor;
	import feathers.controls.text.TextFieldTextEditorViewPort;
	import feathers.core.FocusManager;
	import feathers.events.FeathersEventType;

	import org.flexunit.Assert;

	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class TextAreaFocusTests
	{
		private static const SAMPLE_TEXT:String = "I am the very model of a modern major general";

		private var _textArea:TextArea;

		[Before]
		public function prepare():void
		{
			this._textArea = new TextArea();
			this._textArea.backgroundSkin = new Quad(200, 200);
			this._textArea.textEditorFactory = textEditorFactory;
			TestFeathers.starlingRoot.addChild(this._textArea);
			this._textArea.validate();
		}

		private function textEditorFactory():TextFieldTextEditor
		{
			var textEditor:TextFieldTextEditorViewPort = new TextFieldTextEditorViewPort();
			return textEditor;
		}

		[After]
		public function cleanup():void
		{
			FocusManager.setEnabledForStage(this._textArea.stage, false);
			this._textArea.removeFromParent(true);
			this._textArea = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testFocusInEventAfterSetFocusFunctionWithoutFocusManager():void
		{
			var hasDispatchedFocusIn:Boolean = false;
			this._textArea.addEventListener(FeathersEventType.FOCUS_IN, function(event:Event):void
			{
				hasDispatchedFocusIn = true;
			});
			this._textArea.setFocus();
			Assert.assertTrue("FeathersEventType.FOCUS_IN was not dispatched after calling setFocus()", hasDispatchedFocusIn);
		}

		[Test]
		public function testFocusOutEventAfterClearFocusFunctionWithoutFocusManager():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._textArea.addEventListener(FeathersEventType.FOCUS_OUT, function(event:Event):void
			{
				hasDispatchedFocusOut = true;
			});
			this._textArea.setFocus();
			this._textArea.clearFocus();
			Assert.assertTrue("FeathersEventType.FOCUS_OUT was not dispatched after calling clearFocus()", hasDispatchedFocusOut);
		}

		[Test]
		public function testFocusInEventAfterSetFocusFunctionWithFocusManager():void
		{
			FocusManager.setEnabledForStage(this._textArea.stage, true);
			this.testFocusInEventAfterSetFocusFunctionWithoutFocusManager();
		}

		[Test]
		public function testFocusOutEventAfterClearFocusFunctionWithFocusManager():void
		{
			FocusManager.setEnabledForStage(this._textArea.stage, true);
			this.testFocusOutEventAfterClearFocusFunctionWithoutFocusManager();
		}

		[Test]
		public function testSelectionRangeInsideFocusInListenerAfterSetFocusFunctionWithoutFocusManager():void
		{
			this._textArea.text = SAMPLE_TEXT;
			var selectionBeginIndex:int = -1;
			var selectionEndIndex:int = -1;
			this._textArea.addEventListener(FeathersEventType.FOCUS_IN, function(event:Event):void
			{
				selectionBeginIndex = _textArea.selectionBeginIndex;
				selectionEndIndex = _textArea.selectionEndIndex;
			});
			this._textArea.setFocus();
			Assert.assertStrictlyEquals("TextArea selectionBeginIndex incorrect after calling setFocus()",
				0, selectionBeginIndex);
			Assert.assertStrictlyEquals("TextArea selectionBeginIndex incorrect after calling setFocus()",
				0, selectionEndIndex);
		}

		[Test]
		public function testSelectionRangeInsideFocusInListenerAfterSetFocusFunctionWithFocusManager():void
		{
			FocusManager.setEnabledForStage(this._textArea.stage, true);
			this.testSelectionRangeInsideFocusInListenerAfterSetFocusFunctionWithoutFocusManager();
		}

		[Test]
		public function testSelectionRangeAfterSetFocusThenSelectRangeFunctionWithoutFocusManager():void
		{
			this._textArea.text = SAMPLE_TEXT;
			this._textArea.setFocus();
			var selectionBeginIndex:int = 1;
			var selectionEndIndex:int = 3;
			this._textArea.selectRange(selectionBeginIndex, selectionEndIndex);
			Assert.assertStrictlyEquals("TextArea selectionBeginIndex incorrect after calling setFocus() then selectRange()",
				selectionBeginIndex, this._textArea.selectionBeginIndex);
			Assert.assertStrictlyEquals("TextArea selectionBeginIndex incorrect after calling setFocus() then selectRange()",
				selectionEndIndex, this._textArea.selectionEndIndex);
		}

		[Test]
		public function testSelectionRangeAfterSetFocusThenSelectRangeFunctionWithFocusManager():void
		{
			FocusManager.setEnabledForStage(this._textArea.stage, true);
			this.testSelectionRangeAfterSetFocusThenSelectRangeFunctionWithoutFocusManager();
		}

		[Test]
		public function testSelectionRangeAfterTouchEventWithoutFocusManager():void
		{
			this._textArea.text = SAMPLE_TEXT;
			//validate to make sure the text is passed down to the text editor
			this._textArea.validate();

			var selectionBeginIndex:int = -1;
			var selectionEndIndex:int = -1;
			this._textArea.addEventListener(FeathersEventType.FOCUS_IN, function(event:Event):void
			{
				selectionBeginIndex = _textArea.selectionBeginIndex;
				selectionEndIndex = _textArea.selectionEndIndex;
			});

			var touch:Touch = new Touch(0);
			touch.target = this._textArea;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 100;
			touch.globalY = 5;
			var touches:Vector.<Touch> = new <Touch>[touch];
			this._textArea.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			this._textArea.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			//we don't care what the exact index is, but it should be clear that
			//the touch changed it to something
			Assert.assertTrue("TextArea selectionBeginIndex and selectionEndIndex incorrect after TouchEvent.TOUCH",
				selectionBeginIndex > 0 && selectionEndIndex < SAMPLE_TEXT.length && selectionBeginIndex === selectionEndIndex)
		}

		[Test]
		public function testSelectionRangeAfterTouchEventWithFocusManager():void
		{
			FocusManager.setEnabledForStage(this._textArea.stage, true);
			this.testSelectionRangeAfterTouchEventWithoutFocusManager();
		}
	}
}


================================================
FILE: test/source/feathers/tests/TextAreaInternalStateTests.as
================================================
package feathers.tests
{
	import feathers.controls.TextInputState;
	import feathers.core.FocusManager;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class TextAreaInternalStateTests
	{
		private var _textArea:TextAreaWithInternalState;

		[Before]
		public function prepare():void
		{
			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, true);

			this._textArea = new TextAreaWithInternalState();
			TestFeathers.starlingRoot.addChild(this._textArea);
		}

		[After]
		public function cleanup():void
		{
			this._textArea.removeFromParent(true);
			this._textArea = null;

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testGetSkinForStateWithoutSetSkinForState():void
		{
			Assert.assertNull("TextInput getSkinForState(TextInputState.ENABLED) must be null when setSkinForState() is not called", this._textArea.getSkinForState(TextInputState.FOCUSED));
			Assert.assertNull("TextInput getSkinForState(TextInputState.DISABLED) must be null when setSkinForState() is not called", this._textArea.getSkinForState(TextInputState.DISABLED));
			Assert.assertNull("TextInput getSkinForState(TextInputState.FOCUSED) must be null when setSkinForState() is not called", this._textArea.getSkinForState(TextInputState.FOCUSED));
			Assert.assertNull("TextInput getSkinForState(TextInputState.ERROR) must be null when setSkinForState() is not called", this._textArea.getSkinForState(TextInputState.ERROR));
		}

		[Test]
		public function testGetSkinForState():void
		{
			var backgroundSkin:Quad = new Quad(200, 200);
			this._textArea.backgroundSkin = backgroundSkin;

			var enabledSkin:Quad = new Quad(200, 200);
			this._textArea.setSkinForState(TextInputState.ENABLED, enabledSkin);

			var disabledSkin:Quad = new Quad(200, 200);
			this._textArea.setSkinForState(TextInputState.DISABLED, disabledSkin);

			var focusedSkin:Quad = new Quad(200, 200);
			this._textArea.setSkinForState(TextInputState.FOCUSED, focusedSkin);

			var errorSkin:Quad = new Quad(200, 200);
			this._textArea.setSkinForState(TextInputState.ERROR, errorSkin);

			Assert.assertStrictlyEquals("TextInput getSkinForState(TextInputState.ENABLED) does not match value passed to setSkinForState()", enabledSkin, this._textArea.getSkinForState(TextInputState.ENABLED));
			Assert.assertStrictlyEquals("TextInput getSkinForState(TextInputState.DISABLED) does not match value passed to setSkinForState()", disabledSkin, this._textArea.getSkinForState(TextInputState.DISABLED));
			Assert.assertStrictlyEquals("TextInput getSkinForState(TextInputState.FOCUSED) does not match value passed to setSkinForState()", focusedSkin, this._textArea.getSkinForState(TextInputState.FOCUSED));
			Assert.assertStrictlyEquals("TextInput getSkinForState(TextInputState.ERROR) does not match value passed to setSkinForState()", errorSkin, this._textArea.getSkinForState(TextInputState.ERROR));
		}

		[Test]
		public function testDefaultCurrentBackground():void
		{
			var backgroundSkin:Quad = new Quad(200, 200);
			this._textArea.backgroundSkin = backgroundSkin;

			this._textArea.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.ENABLED by default", TextInputState.ENABLED, this._textArea.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundSkin when currentState is TextInputState.ENABLED and background not provided for this state", backgroundSkin, this._textArea.currentBackgroundInternal);

			this._textArea.errorString = "Error";
			this._textArea.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.ERROR when errorString is not null", TextInputState.ERROR, this._textArea.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundSkin when currentState is TextInputState.ENABLED and background not provided for this state", backgroundSkin, this._textArea.currentBackgroundInternal);
			this._textArea.errorString = null;

			this._textArea.isEnabled = false;
			this._textArea.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.DISABLED when isEnabled is false", TextInputState.DISABLED, this._textArea.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundSkin when currentState is TextInputState.DISABLED and background not provided for this state", backgroundSkin, this._textArea.currentBackgroundInternal);

			this._textArea.isEnabled = true;
			FocusManager.focus = this._textArea;
			this._textArea.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.FOCUSED when input is focused", TextInputState.FOCUSED, this._textArea.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundSkin when currentState is TextInputState.FOCUSED and background not provided for this state", backgroundSkin, this._textArea.currentBackgroundInternal);
		}

		[Test]
		public function testCurrentSkinWithSetSkinForState():void
		{
			var backgroundSkin:Quad = new Quad(200, 200);
			this._textArea.backgroundSkin = backgroundSkin;

			var backgroundEnabledSkin:Quad = new Quad(200, 200);
			this._textArea.setSkinForState(TextInputState.ENABLED, backgroundEnabledSkin);

			var backgroundDisabledSkin:Quad = new Quad(200, 200);
			this._textArea.setSkinForState(TextInputState.DISABLED, backgroundDisabledSkin);

			var backgroundFocusedSkin:Quad = new Quad(200, 200);
			this._textArea.setSkinForState(TextInputState.FOCUSED, backgroundFocusedSkin);

			var backgroundErrorSkin:Quad = new Quad(200, 200);
			this._textArea.setSkinForState(TextInputState.ERROR, backgroundErrorSkin);

			this._textArea.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.ENABLED by default", TextInputState.ENABLED, this._textArea.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundEnabledSkin when currentState is TextInputState.ENABLED", backgroundEnabledSkin, this._textArea.currentBackgroundInternal);

			this._textArea.errorString = "Error";
			this._textArea.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.ERROR when errorString is not null", TextInputState.ERROR, this._textArea.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundEnabledSkin when currentState is TextInputState.ENABLED", backgroundErrorSkin, this._textArea.currentBackgroundInternal);
			this._textArea.errorString = null;

			this._textArea.isEnabled = false;
			this._textArea.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.DISABLED when isEnabled is false", TextInputState.DISABLED, this._textArea.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundDisabledSkin when currentState is TextInputState.DISABLED", backgroundDisabledSkin, this._textArea.currentBackgroundInternal);

			this._textArea.isEnabled = true;
			FocusManager.focus = this._textArea;
			this._textArea.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.FOCUSED when input is focused", TextInputState.FOCUSED, this._textArea.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundFocusedSkin when currentState is TextInputState.FOCUSED", backgroundFocusedSkin, this._textArea.currentBackgroundInternal);
		}
	}
}

import feathers.controls.TextArea;

import starling.display.DisplayObject;

class TextAreaWithInternalState extends TextArea
{
	public function TextAreaWithInternalState()
	{
		super();
	}

	public function get currentBackgroundInternal():DisplayObject
	{
		return this.currentBackgroundSkin;
	}
}

================================================
FILE: test/source/feathers/tests/TextAreaTests.as
================================================
package feathers.tests
{
	import feathers.controls.TextArea;
	import feathers.tests.supportClasses.DisposeFlagQuad;

	import org.flexunit.Assert;

	public class TextAreaTests
	{
		private var _input:TextArea;

		[Before]
		public function prepare():void
		{
			this._input = new TextArea();
			TestFeathers.starlingRoot.addChild(this._input);
		}

		[After]
		public function cleanup():void
		{
			this._input.removeFromParent(true);
			this._input = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testSkinsDisposed():void
		{
			var backgroundSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._input.backgroundSkin = backgroundSkin;
			var backgroundDisabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._input.backgroundDisabledSkin = backgroundDisabledSkin;
			var backgroundFocusedSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._input.backgroundFocusedSkin = backgroundFocusedSkin;
			var backgroundErrorSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._input.backgroundErrorSkin = backgroundErrorSkin;
			this._input.validate();
			this._input.dispose();
			Assert.assertTrue("backgroundSkin not disposed when TextArea disposed.", backgroundSkin.isDisposed);
			Assert.assertTrue("backgroundDisabledSkin not disposed when TextArea disposed.", backgroundDisabledSkin.isDisposed);
			Assert.assertTrue("backgroundFocusedSkin not disposed when TextArea disposed.", backgroundFocusedSkin.isDisposed);
			Assert.assertTrue("backgroundErrorSkin not disposed when TextArea disposed.", backgroundErrorSkin.isDisposed);
		}
	}
}

================================================
FILE: test/source/feathers/tests/TextBlockTextEditorFocusTests.as
================================================
package feathers.tests
{
	import feathers.controls.TextInput;
	import feathers.controls.TextInputState;
	import feathers.controls.text.TextBlockTextEditor;
	import feathers.core.FocusManager;
	import feathers.events.FeathersEventType;

	import flash.events.Event;
	import flash.events.KeyboardEvent;
	import flash.events.TextEvent;
	import flash.geom.Point;
	import flash.ui.Keyboard;

	import org.flexunit.Assert;
	import org.flexunit.async.Async;

	import starling.core.Starling;
	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class TextBlockTextEditorFocusTests
	{
		private static const CURSOR_SKIN_NAME:String = "test-cursor-skin";
		private static const SELECTION_SKIN_NAME:String = "test-selection-skin";
		
		private var _textInput:TextInput;
		private var _textEditor:TextBlockTextEditor;

		[Before]
		public function prepare():void
		{
			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, true);

			this._textInput = new TextInput();
			this._textInput.backgroundSkin = new Quad(200, 200);
			this._textInput.textEditorFactory = textEditorFactory;
			TestFeathers.starlingRoot.addChild(this._textInput);
			this._textInput.validate();
		}

		private function textEditorFactory():TextBlockTextEditor
		{
			this._textEditor = new TextBlockTextEditor();
			var cursorSkin:Quad = new Quad(1, 1, 0xff00ff);
			cursorSkin.name = CURSOR_SKIN_NAME;
			this._textEditor.cursorSkin = cursorSkin;
			var selectionSkin:Quad = new Quad(1, 1, 0xff00ff);
			selectionSkin.name = SELECTION_SKIN_NAME;
			this._textEditor.selectionSkin = selectionSkin;
			return this._textEditor;
		}

		[After]
		public function cleanup():void
		{
			//one of the tests sets the parent's visible property to false, so
			//it needs to be reset.
			this._textInput.parent.visible = true;

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);
			this._textInput.removeFromParent(true);
			this._textInput = null;

			this._textEditor = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testFocusInEventAfterSetFocus():void
		{
			var hasDispatchedFocusIn:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_IN, function(event:starling.events.Event):void
			{
				hasDispatchedFocusIn = true;
			});
			this._textInput.setFocus();
			Assert.assertTrue("BitmapFontTextEditor: FeathersEventType.FOCUS_IN was not dispatched after calling setFocus() on TextInput",
				hasDispatchedFocusIn);
		}

		[Test]
		public function testFocusInEventAfterTouch():void
		{
			var hasDispatchedFocusIn:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_IN, function(event:starling.events.Event):void
			{
				hasDispatchedFocusIn = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._textInput.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("BitmapFontTextEditor: FeathersEventType.FOCUS_IN was not dispatched after TouchEvent.TOUCH on TextInput",
				hasDispatchedFocusIn);
		}

		[Test]
		public function testFocusOutEventAfterSetFocusThenClearFocus():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_OUT, function(event:starling.events.Event):void
			{
				hasDispatchedFocusOut = true;
			});
			this._textInput.setFocus();
			this._textInput.clearFocus();
			Assert.assertTrue("BitmapFontTextEditor: FeathersEventType.FOCUS_OUT was not dispatched after calling clearFocus() on TextInput",
				hasDispatchedFocusOut);
		}

		[Test]
		public function testFocusOutEventAfterTouchInsideThenTouchOutside():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_OUT, function(event:starling.events.Event):void
			{
				hasDispatchedFocusOut = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._textInput.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.target = target.stage;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 1000;
			touch.globalY = 1000;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("BitmapFontTextEditor: FeathersEventType.FOCUS_OUT was not dispatched after TouchEvent.TOUCH inside TextInput followed by TouchEvent.TOUCH outside TextInput",
				hasDispatchedFocusOut);
		}

		[Test]
		public function testFocusOutEventAfterSetFocusThenTouchOutside():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_OUT, function(event:starling.events.Event):void
			{
				hasDispatchedFocusOut = true;
			});
			this._textInput.setFocus();
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._textInput.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = this._textInput.stage;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 1000;
			touch.globalY = 1000;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("BitmapFontTextEditor: FeathersEventType.FOCUS_OUT was not dispatched after calling setFocus() on TextInput followed by TouchEvent.TOUCH outside TextInput",
				hasDispatchedFocusOut);
		}

		[Test]
		public function testFocusOutEventAfterTouchInsideThenClearFocus():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_OUT, function(event:starling.events.Event):void
			{
				hasDispatchedFocusOut = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._textInput.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._textInput.clearFocus();
			Assert.assertTrue("BitmapFontTextEditor: FeathersEventType.FOCUS_OUT was not dispatched after TouchEvent.TOUCH inside TextInput followed by calling clearFocus() on TextInput",
				hasDispatchedFocusOut);
		}

		[Test(async)]
		public function testFocusOutEventAfterSetTextInputParentVisibleToFalse():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_OUT, function(event:starling.events.Event):void
			{
				hasDispatchedFocusOut = true;
			});
			this._textInput.setFocus();
			this._textInput.parent.visible = false;
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("FeathersEventType.FOCUS_OUT was not dispatched after setting TextInput parent's visible property to false when using BitmapFontTextEditor", hasDispatchedFocusOut);
			}, 100);
		}

		[Test]
		public function testSelectionChangeAfterSelectAllEvent():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			//clear the automatic selection caused by giving it focus
			this._textInput.selectRange(0, 0);
			//and validate the commit this change
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new flash.events.Event(flash.events.Event.SELECT_ALL, true));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed after Ctrl/Cmd+A to select all",
				0, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed after Ctrl/Cmd+A to select all",
				this._textInput.text.length, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSelectionChangeAfterSelectAllEventAndKeyboardShiftLeft():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			//clear the automatic selection caused by giving it focus
			this._textInput.selectRange(0, 0);
			//and validate the commit this change
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new flash.events.Event(flash.events.Event.SELECT_ALL, true));
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.LEFT, 0, false, false, true));
			this._textInput.validate();
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after Ctrl/Cmd+A to select all and pressing Keyboard.LEFT and shift key",
				0, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after Ctrl/Cmd+A to select all and pressing Keyboard.LEFT and shift key",
				this._textInput.text.length - 1, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSelectionChangeAfterSelectAllEventAndKeyboardLeft():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			//clear the automatic selection caused by giving it focus
			this._textInput.selectRange(0, 0);
			//and validate the commit this change
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new flash.events.Event(flash.events.Event.SELECT_ALL, true));
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.LEFT, 0, false, false, false));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after Ctrl/Cmd+A to select all and pressing Keyboard.LEFT",
				0, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after Ctrl/Cmd+A to select all and pressing Keyboard.LEFT",
				0, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSelectionChangeAfterSelectAllEventAndKeyboardRight():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			//clear the automatic selection caused by giving it focus
			this._textInput.selectRange(0, 0);
			//and validate the commit this change
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new flash.events.Event(flash.events.Event.SELECT_ALL, true));
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.RIGHT, 0, false, false, false));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after Ctrl/Cmd+A to select all and pressing Keyboard.RIGHT",
				this._textInput.text.length, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after Ctrl/Cmd+A to select all and pressing Keyboard.RIGHT",
				this._textInput.text.length, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSelectionChangeAfterSelectRange():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 8;
			this._textInput.selectRange(rangeStart, rangeEnd);
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.LEFT",
				rangeStart, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.LEFT",
				rangeEnd, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSelectionChangeAfterSelectRangeAndKeyboardLeft():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 8;
			this._textInput.selectRange(rangeStart, rangeEnd);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.LEFT, 0, false, false, false));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.LEFT",
				rangeStart, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.LEFT",
				rangeStart, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSelectionChangeAfterSelectRangeAndKeyboardRight():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 8;
			this._textInput.selectRange(rangeStart, rangeEnd);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.RIGHT, 0, false, false, false));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.RIGHT",
				rangeEnd, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.RIGHT",
				rangeEnd, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSelectRangeAndKeyboardDelete():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 8;
			this._textInput.selectRange(rangeStart, rangeEnd);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.DELETE, 0, false, false, false));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.DELETE",
				rangeStart, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.DELETE",
				rangeStart, this._textInput.selectionEndIndex);
			Assert.assertStrictlyEquals("text not changed correctly after selectRange() and pressing Keyboard.DELETE",
				"Herld", this._textInput.text);
		}

		[Test]
		public function testSelectRangeAndKeyboardBackspace():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 8;
			this._textInput.selectRange(rangeStart, rangeEnd);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.BACKSPACE, 0, false, false, false));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.BACKSPACE",
				rangeStart, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.BACKSPACE",
				rangeStart, this._textInput.selectionEndIndex);
			Assert.assertStrictlyEquals("text not changed correctly after selectRange() and pressing Keyboard.BACKSPACE",
				"Herld", this._textInput.text);
		}

		[Test]
		public function testSelectRangeAndTyping():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 8;
			var textToType:String = "test";
			this._textInput.selectRange(rangeStart, rangeEnd);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new TextEvent(TextEvent.TEXT_INPUT, false, false, textToType));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and typing some text",
				rangeStart + textToType.length, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and typing some text",
				rangeStart + textToType.length, this._textInput.selectionEndIndex);
			Assert.assertStrictlyEquals("text not changed correctly after selectRange() and typing some text",
				"He" + textToType + "rld", this._textInput.text);
		}

		[Test]
		public function testSetCursorAndKeyboardDelete():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var cursorIndex:int = 2;
			this._textInput.selectRange(cursorIndex, cursorIndex);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.DELETE, 0, false, false, false));
			Assert.assertStrictlyEquals("selectionBeginIndex incorrectly changed after selectRange() and pressing Keyboard.DELETE",
				cursorIndex, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex incorrectly changed after selectRange() and pressing Keyboard.DELETE",
				cursorIndex, this._textInput.selectionEndIndex);
			Assert.assertStrictlyEquals("text not changed correctly after selectRange() and pressing Keyboard.DELETE",
				"Helo World", this._textInput.text);
		}

		[Test]
		public function testSetCursorAndKeyboardBackspace():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var cursorIndex:int = 2;
			this._textInput.selectRange(cursorIndex, cursorIndex);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.BACKSPACE, 0, false, false, false));
			cursorIndex--;
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.BACKSPACE",
				cursorIndex, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.BACKSPACE",
				cursorIndex, this._textInput.selectionEndIndex);
			Assert.assertStrictlyEquals("text not changed correctly after selectRange() and pressing Keyboard.BACKSPACE",
				"Hllo World", this._textInput.text);
		}

		[Test]
		public function testSetCursorAndKeyboardUp():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var cursorIndex:int = 2;
			this._textInput.selectRange(cursorIndex, cursorIndex);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.UP, 0, false, false, false));
			cursorIndex = 0;
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.UP",
				cursorIndex, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.UP",
				cursorIndex, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSetCursorAndKeyboardDown():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var cursorIndex:int = 2;
			this._textInput.selectRange(cursorIndex, cursorIndex);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.DOWN, 0, false, false, false));
			cursorIndex = this._textInput.text.length;
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.DOWN",
				cursorIndex, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.DOWN",
				cursorIndex, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSetCursorAndKeyboardLeft():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var cursorIndex:int = 2;
			this._textInput.selectRange(cursorIndex, cursorIndex);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.LEFT, 0, false, false, false));
			cursorIndex--;
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.LEFT",
				cursorIndex, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.LEFT",
				cursorIndex, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSetCursorAndKeyboardRight():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var cursorIndex:int = 2;
			this._textInput.selectRange(cursorIndex, cursorIndex);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.RIGHT, 0, false, false, false));
			cursorIndex++;
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.RIGHT",
				cursorIndex, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.RIGHT",
				cursorIndex, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSetCursorAndKeyboardShiftLeft():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 2;
			this._textInput.selectRange(rangeStart, rangeEnd);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.LEFT, 0, false, false, true));
			rangeStart--;
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.LEFT and shift key",
				rangeStart, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.LEFT and shift key",
				rangeEnd, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSetCursorAndKeyboardShiftRight():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var rangeStart:int = 2;
			var rangeEnd:int = 2;
			this._textInput.selectRange(rangeStart, rangeEnd);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 0, Keyboard.RIGHT, 0, false, false, true));
			rangeEnd++;
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and pressing Keyboard.RIGHT and shift key",
				rangeStart, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and pressing Keyboard.RIGHT and shift key",
				rangeEnd, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSetCursorAndTyping():void
		{
			this._textInput.text = "Hello World";
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			var cursorIndex:int = 2;
			var textToType:String = "test";
			this._textInput.selectRange(cursorIndex, cursorIndex);
			this._textInput.validate();
			Starling.current.nativeStage.focus.dispatchEvent(new TextEvent(TextEvent.TEXT_INPUT, false, false, textToType));
			Assert.assertStrictlyEquals("selectionBeginIndex not changed correctly after selectRange() and typing some text",
				cursorIndex + textToType.length, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("selectionEndIndex not changed correctly after selectRange() and typing some text",
				cursorIndex + textToType.length, this._textInput.selectionEndIndex);
			Assert.assertStrictlyEquals("text not changed correctly after selectRange() and typing some text",
				"He" + textToType + "llo World", this._textInput.text);
		}

		[Test]
		public function testSetFocusWhenFocusEnabledFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isFocusEnabled = false;
			this._textInput.validate();
			Assert.assertNotNull("TextBlockTextEditor nativeFocus must not be null when isFocusEnabled is false",
				this._textInput.nativeFocus);
			Assert.assertTrue("TextBlockTextEditor nativeFocus must not receive nativeStage focus when isFocusEnabled is false",
				Starling.current.nativeStage.focus !== this._textInput.nativeFocus);
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertTrue("TextInput must not receive FocusManager focus when using TextBlockTextEditor and isFocusEnabled is false",
				this._textInput.focusManager.focus !== this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.ENABLED after attempt to receive FocusManager focus when using TextBlockTextEditor and isFocusEnabled is false",
				TextInputState.ENABLED, this._textInput.currentState);
		}

		[Test]
		public function testReceiveFocusWhenEditableFalseAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = false;
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			this._textInput.validate();
			Assert.assertStrictlyEquals("TextBlockTextEditor nativeFocus must receive nativeStage focus when isEditable is false and isSelectable is false",
				Starling.current.nativeStage.focus, this._textInput.nativeFocus);
			Assert.assertStrictlyEquals("TextInput must receive FocusManager focus when using TextBlockTextEditor and isEditable is false and isSelectable is false",
				this._textInput.focusManager.focus, this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.FOCUSED after receive FocusManager focus when using TextBlockTextEditor and isEditable is false and isSelectable is false",
				TextInputState.FOCUSED, this._textInput.currentState);
		}

		[Test]
		public function testSetFocusWhenEditableTrueAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = true;
			this._textInput.isSelectable = false;
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertStrictlyEquals("TextBlockTextEditor nativeFocus must receive nativeStage focus when isEditable is true and isSelectable is false",
				Starling.current.nativeStage.focus, this._textInput.nativeFocus);
			Assert.assertStrictlyEquals("TextInput must receive FocusManager focus when using TextBlockTextEditor and isEditable is true and isSelectable is false",
				this._textInput.focusManager.focus, this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.FOCUSED after receive FocusManager focus when using TextBlockTextEditor and isEditable is true and isSelectable is false",
				TextInputState.FOCUSED, this._textInput.currentState);
		}

		[Test]
		public function testSetFocusWhenEditableFalseAndSelectableTrue():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = true;
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertStrictlyEquals("TextBlockTextEditor nativeFocus must receive nativeStage focus when isEditable is false and isSelectable is true",
				Starling.current.nativeStage.focus, this._textInput.nativeFocus);
			Assert.assertStrictlyEquals("TextInput must receive FocusManager focus when using TextBlockTextEditor and isEditable is false and isSelectable is true",
				this._textInput.focusManager.focus, this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.FOCUSED after receive FocusManager focus when using TextBlockTextEditor and isEditable is false and isSelectable is true",
				TextInputState.FOCUSED, this._textInput.currentState);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithNoCharactersSelected():void
		{
			this._textInput.text = "Hello World";
			this._textInput.selectRange(1, 1);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertTrue("TextBlockTextEditor cursorSkin must be visible when no characters selected",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertFalse("TextBlockTextEditor selectionSkin must not be visible when no characters selected",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithMultipleCharactersSelected():void
		{
			this._textInput.text = "Hello World";
			this._textInput.selectRange(1, 3);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertFalse("TextBlockTextEditor cursorSkin must not be visible when multiple characters selected",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertTrue("TextBlockTextEditor selectionSkin must be visible when multiple characters selected",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithNoCharactersSelectedEditableFalseAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = false;
			this._textInput.selectRange(1, 1);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertFalse("TextBlockTextEditor cursorSkin must not be visible when no characters selected, isEditable is false, and isSelectable is false",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertFalse("TextBlockTextEditor selectionSkin must not be visible when no characters selected, isEditable is false, and isSelectable is false",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithMultipleCharactersSelectedEditableFalseAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = false;
			this._textInput.selectRange(1, 3);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertFalse("TextBlockTextEditor cursorSkin must not be visible when multiple characters selected, isEditable is false, and isSelectable is false",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertFalse("TextBlockTextEditor selectionSkin must not be visible when multiple characters selected, isEditable is false, and isSelectable is false",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithNoCharactersSelectedEditableTrueAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = true;
			this._textInput.isSelectable = false;
			this._textInput.selectRange(1, 1);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertTrue("TextBlockTextEditor cursorSkin must be visible when no characters selected, isEditable is true, and isSelectable is false",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertFalse("TextBlockTextEditor selectionSkin must not be visible when no characters selected, isEditable is true, and isSelectable is false",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithMultipleCharactersSelectedEditableTrueAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = true;
			this._textInput.isSelectable = false;
			this._textInput.selectRange(1, 3);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertFalse("TextBlockTextEditor cursorSkin must not be visible when multiple characters selected, isEditable is true, and isSelectable is false",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertTrue("TextBlockTextEditor selectionSkin must be visible when multiple characters selected, isEditable is true, and isSelectable is false",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithNoCharactersSelectedEditableFalseAndSelectableTrue():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = true;
			this._textInput.selectRange(1, 1);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertFalse("TextBlockTextEditor cursorSkin must not be visible when no characters selected, isEditable is false, and isSelectable is true",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertFalse("TextBlockTextEditor selectionSkin must not be visible when no characters selected, isEditable is false, and isSelectable is true",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}

		[Test]
		public function testCursorAndSelectionSkinsWithMultipleCharactersSelectedEditableFalseAndSelectableTrue():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = true;
			this._textInput.selectRange(1, 3);
			//validate to be sure that the range is passed down to the text editor
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertFalse("TextBlockTextEditor cursorSkin must not be visible when multiple characters selected, isEditable is false, and isSelectable is true",
				this._textEditor.getChildByName(CURSOR_SKIN_NAME).visible);
			Assert.assertTrue("TextBlockTextEditor selectionSkin must be visible when multiple characters selected, isEditable is false, and isSelectable is true",
				this._textEditor.getChildByName(SELECTION_SKIN_NAME).visible);
		}
	}
}


================================================
FILE: test/source/feathers/tests/TextBlockTextRendererTests.as
================================================
package feathers.tests
{
	import feathers.controls.text.TextBlockTextRenderer;
	import feathers.tests.supportClasses.CustomStateContext;
	import feathers.text.FontStylesSet;

	import flash.text.engine.ElementFormat;
	import flash.text.engine.FontDescription;

	import org.flexunit.Assert;

	import starling.text.TextFormat;

	public class TextBlockTextRendererTests
	{
		private static const STATE_DISABLED:String = "disabled";

		private static const DEFAULT_FONT_NAME:String = "DefaultFont";
		private static const DEFAULT_FONT_SIZE:Number = 16;
		private static const DEFAULT_COLOR:uint = 0xff00ff;
		private static const DISABLED_FONT_NAME:String = "DisabledFont";
		private static const DISABLED_FONT_SIZE:Number = 15;
		private static const DISABLED_COLOR:uint = 0x999999;
		private static const SELECTED_FONT_NAME:String = "SelectedFont";
		private static const SELECTED_FONT_SIZE:Number = 17;
		private static const SELECTED_COLOR:uint = 0xff0000;
		private static const STATE_FONT_NAME:String = "StateFont";
		private static const STATE_FONT_SIZE:Number = 18;
		private static const STATE_COLOR:uint = 0xffffff;

		private var _textRenderer:TextBlockTextRenderer;

		[Before]
		public function prepare():void
		{
			this._textRenderer = new TextBlockTextRenderer();
			TestFeathers.starlingRoot.addChild(this._textRenderer);
		}

		[After]
		public function cleanup():void
		{
			this._textRenderer.removeFromParent(true);
			this._textRenderer = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testOneLineWithEmptyString():void
		{
			this._textRenderer.text = "";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer numLines must be 1 with empty string", 1, this._textRenderer.numLines);
		}

		[Test]
		public function testOneLine():void
		{
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer numLines must be 1", 1, this._textRenderer.numLines);
		}

		[Test]
		public function testNumLinesWithLineBreak():void
		{
			this._textRenderer.text = "Hello\nWorld";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer numLines must be 2 when line break is in text", 2, this._textRenderer.numLines);
		}

		[Test]
		public function testNumLinesWithCarriageReturn():void
		{
			this._textRenderer.text = "Hello\rWorld";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer numLines must be 2 when carriage return is in text", 2, this._textRenderer.numLines);
		}

		[Test]
		public function testValidateWithoutTextThenSetText():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.validate();
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontDescription.fontName must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textRenderer.currentElementFormat.fontDescription.fontName);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontSize must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentElementFormat.fontSize);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentElementFormat.color);
		}

		[Test]
		public function testGetElementFormatForStateWithoutSetElementFormatForState():void
		{
			Assert.assertNull("TextBlockTextRenderer getElementFormatForState() must return null if ElementFormat not provided with setElementFormatForState()",
				this._textRenderer.getElementFormatForState(STATE_DISABLED));
		}

		[Test]
		public function testGetElementFormatForStateAfterSetElementFormatForState():void
		{
			var elementFormat:ElementFormat = new ElementFormat();
			this._textRenderer.setElementFormatForState(STATE_DISABLED, elementFormat);
			Assert.assertStrictlyEquals("TextBlockTextRenderer getElementFormatForState() must return value passed to setElementFormatForState() with same state",
				elementFormat, this._textRenderer.getElementFormatForState(STATE_DISABLED));
		}

		[Test]
		public function testCurrentElementFormatWithElementFormat():void
		{
			var font:FontDescription = new FontDescription("_sans");
			this._textRenderer.elementFormat = new ElementFormat(font);
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat must be equal to elementFormat when no other element formats are specified",
				this._textRenderer.elementFormat, this._textRenderer.currentElementFormat);
		}

		[Test]
		public function testCurrentElementFormatWithElementFormatAndDisabled():void
		{
			var font:FontDescription = new FontDescription("_sans");
			this._textRenderer.elementFormat = new ElementFormat(font);
			this._textRenderer.text = "Hello World";
			this._textRenderer.isEnabled = false;
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat must be equal to elementFormat when isEnabled is false, but no other element formats are specified",
				this._textRenderer.elementFormat, this._textRenderer.currentElementFormat);
		}

		[Test]
		public function testCurrentElementFormatWithDisabledElementFormatAndDisabled():void
		{
			var font:FontDescription = new FontDescription("_sans");
			this._textRenderer.elementFormat = new ElementFormat(font);
			this._textRenderer.disabledElementFormat = new ElementFormat(font);
			this._textRenderer.text = "Hello World";
			this._textRenderer.isEnabled = false;
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat must be equal to disabledElementFormat when isEnabled is false and disabledElementFormat is not null",
				this._textRenderer.disabledElementFormat, this._textRenderer.currentElementFormat);
		}

		[Test]
		public function testCurrentElementFormatWithElementFormatAndStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			var font:FontDescription = new FontDescription("_sans");
			this._textRenderer.elementFormat = new ElementFormat(font);
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat must be equal to elementFormat when stateContext isEnabled is false, but no other element formats are specified",
				this._textRenderer.elementFormat, this._textRenderer.currentElementFormat);
		}

		[Test]
		public function testCurrentElementFormatWithDisabledElementFormatAndStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			var font:FontDescription = new FontDescription("_sans");
			this._textRenderer.elementFormat = new ElementFormat(font);
			this._textRenderer.disabledElementFormat = new ElementFormat(font);
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat must be equal to disabledElementFormat when isEnabled is false and disabledElementFormat is not null",
				this._textRenderer.disabledElementFormat, this._textRenderer.currentElementFormat);
		}

		[Test]
		public function testCurrentElementFormatWithElementFormatAndStateContextSelected():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			this._textRenderer.stateContext = stateContext;
			var font:FontDescription = new FontDescription("_sans");
			this._textRenderer.elementFormat = new ElementFormat(font);
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat must be equal to elementFormat when stateContext isSelected is true, but no other element formats are specified",
				this._textRenderer.elementFormat, this._textRenderer.currentElementFormat);
		}

		[Test]
		public function testCurrentElementFormatWithSelectedElementFormatAndStateContextSelected():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			this._textRenderer.stateContext = stateContext;
			var font:FontDescription = new FontDescription("_sans");
			this._textRenderer.elementFormat = new ElementFormat(font);
			this._textRenderer.selectedElementFormat = new ElementFormat(font);
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat must be equal to selectedElementFormat when isSelected is true and selectedElementFormat is not null",
				this._textRenderer.selectedElementFormat, this._textRenderer.currentElementFormat);
		}

		[Test]
		public function testCurrentElementFormatWithSelectedAndDisabledElementFormatAndStateContextSelectedAndDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			var font:FontDescription = new FontDescription("_sans");
			this._textRenderer.elementFormat = new ElementFormat(font);
			this._textRenderer.disabledElementFormat = new ElementFormat(font);
			this._textRenderer.selectedElementFormat = new ElementFormat(font);
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			//disabled should get priority over selected
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat must be equal to disabledElementFormat when isSelected is true and isEnabled is false and both selectedElementFormat and disabledElementFormat are not null",
				this._textRenderer.disabledElementFormat, this._textRenderer.currentElementFormat);
		}

		[Test]
		public function testCurrentElementFormatWithOnlyElementFormatAndStateContextCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.currentState = STATE_DISABLED;
			this._textRenderer.stateContext = stateContext;
			var font:FontDescription = new FontDescription("_sans");
			this._textRenderer.elementFormat = new ElementFormat(font);
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat must be equal to elementFormat when no other element formats are specified",
				this._textRenderer.elementFormat, this._textRenderer.currentElementFormat);
		}

		[Test]
		public function testCurrentElementFormatWithDisabledElementFormatAndStateElementFormatWithStateContextDisabledAndCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			stateContext.isSelected = true;
			stateContext.currentState = STATE_DISABLED;
			this._textRenderer.stateContext = stateContext;
			var font:FontDescription = new FontDescription("_sans");
			this._textRenderer.elementFormat = new ElementFormat(font);
			this._textRenderer.disabledElementFormat = new ElementFormat(font);
			this._textRenderer.selectedElementFormat = new ElementFormat(font);
			var disabledStateElementFormat:ElementFormat = new ElementFormat(font);
			this._textRenderer.setElementFormatForState(STATE_DISABLED, disabledStateElementFormat);
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			//exact states always get priority over default/disabled/selected
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat must be equal to ElementFormat passed into setElementFormatForState() when isEnabled is false and disabledElementFormat are not null",
				disabledStateElementFormat, this._textRenderer.currentElementFormat);
		}

		[Test]
		public function testFontStylesIgnoredIfAdvancedElementFormatExists():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat();
			this._textRenderer.fontStyles = fontStyles;
			var font:FontDescription = new FontDescription("_sans");
			this._textRenderer.elementFormat = new ElementFormat(font);
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat must be equal to elementFormat and not a format from font styles",
				this._textRenderer.elementFormat, this._textRenderer.currentElementFormat);
		}

		[Test]
		public function testCurrentElementFormatWithFontStyles():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontDescription.fontName must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textRenderer.currentElementFormat.fontDescription.fontName);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontSize must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentElementFormat.fontSize);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentElementFormat.color);
		}

		[Test]
		public function testCurrentElementFormatFallBackToDefaultFontStylesWhenDisabled():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.isEnabled = false;
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontDescription.fontName must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textRenderer.currentElementFormat.fontDescription.fontName);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontSize must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentElementFormat.fontSize);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentElementFormat.color);
		}

		[Test]
		public function testCurrentElementFormatUseDisabledFontStylesWhenDisabled():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.disabledFormat = new TextFormat(DISABLED_FONT_NAME, DISABLED_FONT_SIZE, DISABLED_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.isEnabled = false;
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontDescription.fontName must be equal to starling.text.TextFormat font",
				DISABLED_FONT_NAME, this._textRenderer.currentElementFormat.fontDescription.fontName);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontSize must be equal to starling.text.TextFormat size",
				DISABLED_FONT_SIZE, this._textRenderer.currentElementFormat.fontSize);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.color must be equal to starling.text.TextFormat color",
				DISABLED_COLOR, this._textRenderer.currentElementFormat.color);
		}

		[Test]
		public function testCurrentElementFormatFallBackToDefaultFontStylesWithStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontDescription.fontName must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textRenderer.currentElementFormat.fontDescription.fontName);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontSize must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentElementFormat.fontSize);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentElementFormat.color);
		}

		[Test]
		public function testCurrentElementFormatUseDisabledFontStylesWithStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.disabledFormat = new TextFormat(DISABLED_FONT_NAME, DISABLED_FONT_SIZE, DISABLED_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontDescription.fontName must be equal to starling.text.TextFormat font",
				DISABLED_FONT_NAME, this._textRenderer.currentElementFormat.fontDescription.fontName);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontSize must be equal to starling.text.TextFormat size",
				DISABLED_FONT_SIZE, this._textRenderer.currentElementFormat.fontSize);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.color must be equal to starling.text.TextFormat color",
				DISABLED_COLOR, this._textRenderer.currentElementFormat.color);
		}

		[Test]
		public function testCurrentElementFormatFallBackToDefaultFontStylesWithStateContextSelected():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontDescription.fontName must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textRenderer.currentElementFormat.fontDescription.fontName);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontSize must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentElementFormat.fontSize);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentElementFormat.color);
		}

		[Test]
		public function testCurrentElementFormatUseSelectedFontStylesWithStateContextSelected():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.selectedFormat = new TextFormat(SELECTED_FONT_NAME, SELECTED_FONT_SIZE, SELECTED_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontDescription.fontName must be equal to starling.text.TextFormat font",
				SELECTED_FONT_NAME, this._textRenderer.currentElementFormat.fontDescription.fontName);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontSize must be equal to starling.text.TextFormat size",
				SELECTED_FONT_SIZE, this._textRenderer.currentElementFormat.fontSize);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.color must be equal to starling.text.TextFormat color",
				SELECTED_COLOR, this._textRenderer.currentElementFormat.color);
		}

		[Test]
		public function testCurrentElementFormatUseDisabledFontStylesWithStateContextSelectedAndDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.selectedFormat = new TextFormat(SELECTED_FONT_NAME, SELECTED_FONT_SIZE, SELECTED_COLOR);
			fontStyles.disabledFormat = new TextFormat(DISABLED_FONT_NAME, DISABLED_FONT_SIZE, DISABLED_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			//disabled should get priority over selected
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontDescription.fontName must be equal to starling.text.TextFormat font",
				DISABLED_FONT_NAME, this._textRenderer.currentElementFormat.fontDescription.fontName);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontSize must be equal to starling.text.TextFormat size",
				DISABLED_FONT_SIZE, this._textRenderer.currentElementFormat.fontSize);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.color must be equal to starling.text.TextFormat color",
				DISABLED_COLOR, this._textRenderer.currentElementFormat.color);
		}

		[Test]
		public function testCurrentElementFormatFallBackToDefaultFontStylesWithStateContextCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.currentState = STATE_DISABLED;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontDescription.fontName must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textRenderer.currentElementFormat.fontDescription.fontName);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontSize must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentElementFormat.fontSize);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentElementFormat.color);
		}

		[Test]
		public function testCurrentElementFormatUseStateFontStylesWithStateContextCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.currentState = STATE_DISABLED;
			stateContext.isSelected = true;
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.selectedFormat = new TextFormat(SELECTED_FONT_NAME, SELECTED_FONT_SIZE, SELECTED_COLOR);
			fontStyles.disabledFormat = new TextFormat(DISABLED_FONT_NAME, DISABLED_FONT_SIZE, DISABLED_COLOR);
			fontStyles.setFormatForState(STATE_DISABLED, new TextFormat(STATE_FONT_NAME, STATE_FONT_SIZE, STATE_COLOR));
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			//exact states always get priority over default/disabled/selected
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontDescription.fontName must be equal to starling.text.TextFormat font",
				STATE_FONT_NAME, this._textRenderer.currentElementFormat.fontDescription.fontName);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.fontSize must be equal to starling.text.TextFormat size",
				STATE_FONT_SIZE, this._textRenderer.currentElementFormat.fontSize);
			Assert.assertStrictlyEquals("TextBlockTextRenderer currentElementFormat.color must be equal to starling.text.TextFormat color",
				STATE_COLOR, this._textRenderer.currentElementFormat.color);
		}

		[Test]
		public function testInvalidAfterChangePropertyOfFontStyles():void
		{
			var format:TextFormat = new TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = format
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			format.color = SELECTED_COLOR;
			Assert.assertTrue("TextBlockTextRenderer: must be invalid after changing property of font styles.",
				this._textRenderer.isInvalid());
		}
	}
}


================================================
FILE: test/source/feathers/tests/TextFieldTextEditorFocusTests.as
================================================
package feathers.tests
{
	import feathers.controls.TextInput;
	import feathers.controls.TextInputState;
	import feathers.controls.text.TextFieldTextEditor;
	import feathers.core.FocusManager;
	import feathers.events.FeathersEventType;

	import flash.events.FocusEvent;
	import flash.ui.Keyboard;

	import org.flexunit.Assert;
	import org.flexunit.async.Async;

	import starling.core.Starling;
	import starling.display.Quad;
	import starling.events.Event;

	public class TextFieldTextEditorFocusTests
	{
		private var _textInput:TextInput;
		private var _textInput2:TextInput;

		[Before]
		public function prepare():void
		{
			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, true);
			
			this._textInput = new TextInput();
			this._textInput.backgroundSkin = new Quad(200, 200);
			this._textInput.textEditorFactory = textEditorFactory;
			TestFeathers.starlingRoot.addChild(this._textInput);
			this._textInput.validate();

			this._textInput2 = new TextInput();
			this._textInput2.backgroundSkin = new Quad(200, 200);
			this._textInput2.textEditorFactory = textEditorFactory;
			this._textInput2.y = 210;
			TestFeathers.starlingRoot.addChild(this._textInput2);
			this._textInput2.validate();
		}

		private function textEditorFactory():TextFieldTextEditor
		{
			var textEditor:TextFieldTextEditor = new TextFieldTextEditor();
			return textEditor;
		}

		[After]
		public function cleanup():void
		{
			//one of the tests sets the parent's visible property to false, so
			//it needs to be reset.
			this._textInput.parent.visible = true;
			
			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);
			
			this._textInput.removeFromParent(true);
			this._textInput = null;

			this._textInput2.removeFromParent(true);
			this._textInput2 = null;
			
			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testChangeFocusOnTabKey():void
		{
			this._textInput.focusManager.focus = this._textInput;
			Starling.current.nativeStage.dispatchEvent(new FocusEvent(FocusEvent.KEY_FOCUS_CHANGE, true, false, null, false, Keyboard.TAB));
			Assert.assertStrictlyEquals("The FocusManager did not change focus when pressing Keyboard.TAB", this._textInput.focusManager.focus, this._textInput2);
		}

		[Test(async)]
		public function testFocusOutEventAfterSetTextInputParentVisibleToFalse():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_OUT, function(event:Event):void
			{
				hasDispatchedFocusOut = true;
			});
			this._textInput.setFocus();
			this._textInput.parent.visible = false;
			Async.delayCall(this, function():void
			{
				Assert.assertTrue("FeathersEventType.FOCUS_OUT was not dispatched after setting TextInput parent's visible property to false when using TextFieldTextEditor", hasDispatchedFocusOut);
			}, 100);
		}

		[Test]
		public function testSetFocusWhenFocusEnabledFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isFocusEnabled = false;
			this._textInput.validate();
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertTrue("TextFieldTextEditor nativeFocus must not receive nativeStage focus when isFocusEnabled is false",
				Starling.current.nativeStage.focus !== this._textInput.nativeFocus);
			Assert.assertTrue("TextInput must not receive FocusManager focus when using TextFieldTextEditor and isFocusEnabled is false",
				this._textInput.focusManager.focus !== this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.ENABLED after receive FocusManager focus when using TextFieldTextEditor and isFocusEnabled is false",
				TextInputState.ENABLED, this._textInput.currentState);
		}

		[Test]
		public function testSetFocusWhenEditableFalseAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = false;
			this._textInput.validate();
			Assert.assertNotNull("TextFieldTextEditor nativeFocus must not be null when isEditable is false and isSelectable is false",
				this._textInput.nativeFocus);
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertStrictlyEquals("TextFieldTextEditor nativeFocus must receive nativeStage focus when isEditable is false and isSelectable is false",
				Starling.current.nativeStage.focus, this._textInput.nativeFocus);
			Assert.assertStrictlyEquals("TextInput must receive FocusManager focus when using TextFieldTextEditor and isEditable is false and isSelectable is false",
				this._textInput.focusManager.focus, this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.FOCUSED after receive FocusManager focus when using TextFieldTextEditor and isEditable is false and isSelectable is false",
				TextInputState.FOCUSED, this._textInput.currentState);
		}

		[Test]
		public function testSetFocusWhenEditableTrueAndSelectableFalse():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = true;
			this._textInput.isSelectable = false;
			this._textInput.validate();
			Assert.assertNotNull("TextFieldTextEditor nativeFocus must not be null when isEditable is true and isSelectable is false",
				this._textInput.nativeFocus);
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertStrictlyEquals("TextFieldTextEditor nativeFocus must receive nativeStage focus when isEditable is true and isSelectable is false",
				Starling.current.nativeStage.focus, this._textInput.nativeFocus);
			Assert.assertStrictlyEquals("TextInput must receive FocusManager focus when using TextFieldTextEditor and isEditable is true and isSelectable is false",
				this._textInput.focusManager.focus, this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.FOCUSED after receive FocusManager focus when using TextFieldTextEditor and isEditable is true and isSelectable is false",
				TextInputState.FOCUSED, this._textInput.currentState);
		}

		[Test]
		public function testSetFocusWhenEditableFalseAndSelectableTrue():void
		{
			this._textInput.text = "Hello World";
			this._textInput.isEditable = false;
			this._textInput.isSelectable = true;
			this._textInput.validate();
			Assert.assertNotNull("TextFieldTextEditor nativeFocus must not be null when isEditable is false and isSelectable is true",
				this._textInput.nativeFocus);
			this._textInput.focusManager.focus = this._textInput;
			Assert.assertStrictlyEquals("TextFieldTextEditor nativeFocus must have nativeStage focus",
				Starling.current.nativeStage.focus, this._textInput.nativeFocus);
			Assert.assertStrictlyEquals("TextInput must receive FocusManager focus when using TextFieldTextEditor and isEditable is false and isSelectable is true",
				this._textInput.focusManager.focus, this._textInput);
			Assert.assertStrictlyEquals("TextInput state must be TextInputState.FOCUSED after receive FocusManager focus when using TextFieldTextEditor and isEditable is false and isSelectable is true",
				TextInputState.FOCUSED, this._textInput.currentState);
		}
	}
}


================================================
FILE: test/source/feathers/tests/TextFieldTextEditorTests.as
================================================
package feathers.tests
{
	import feathers.controls.text.TextFieldTextEditor;
	import feathers.tests.supportClasses.CustomStateContext;
	import feathers.text.FontStylesSet;

	import flash.text.TextFormat;

	import org.flexunit.Assert;

	import starling.text.TextFormat;

	public class TextFieldTextEditorTests
	{
		private static const STATE_DISABLED:String = "disabled";

		private static const DEFAULT_FONT_NAME:String = "DefaultFont";
		private static const DEFAULT_FONT_SIZE:Number = 16;
		private static const DEFAULT_COLOR:uint = 0xff00ff;
		private static const DISABLED_FONT_NAME:String = "DisabledFont";
		private static const DISABLED_FONT_SIZE:Number = 15;
		private static const DISABLED_COLOR:uint = 0x999999;
		private static const STATE_FONT_NAME:String = "StateFont";
		private static const STATE_FONT_SIZE:Number = 18;
		private static const STATE_COLOR:uint = 0xffffff;

		private var _textEditor:TextFieldTextEditor;

		[Before]
		public function prepare():void
		{
			this._textEditor = new TextFieldTextEditor();
			TestFeathers.starlingRoot.addChild(this._textEditor);
		}

		[After]
		public function cleanup():void
		{
			this._textEditor.removeFromParent(true);
			this._textEditor = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testGetTextFormatForStateWithoutSetTextFormatForState():void
		{
			Assert.assertNull("TextFieldTextEditor getTextFormatForState() must return null if TextFormat not provided with setTextFormatForState()",
				this._textEditor.getTextFormatForState(STATE_DISABLED));
		}

		[Test]
		public function testGetTextFormatForStateAfterSetTextFormatForState():void
		{
			var textFormat:flash.text.TextFormat = new flash.text.TextFormat();
			this._textEditor.setTextFormatForState(STATE_DISABLED, textFormat);
			Assert.assertStrictlyEquals("TextFieldTextEditor getTextFormatForState() must return value passed to setTextFormatForState() with same state",
				textFormat, this._textEditor.getTextFormatForState(STATE_DISABLED));
		}

		[Test]
		public function testCurrentTextFormatWithTextFormat():void
		{
			this._textEditor.textFormat = new flash.text.TextFormat();
			this._textEditor.text = "Hello World";
			this._textEditor.validate();
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat must be equal to textFormat when no other text formats are specified",
				this._textEditor.textFormat, this._textEditor.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithTextFormatAndDisabled():void
		{
			this._textEditor.textFormat = new flash.text.TextFormat();
			this._textEditor.text = "Hello World";
			this._textEditor.isEnabled = false;
			this._textEditor.validate();
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat must be equal to textFormat when isEnabled is false, but no other text formats are specified",
				this._textEditor.textFormat, this._textEditor.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithDisabledTextFormatAndDisabled():void
		{
			this._textEditor.textFormat = new flash.text.TextFormat();
			this._textEditor.disabledTextFormat = new flash.text.TextFormat();
			this._textEditor.text = "Hello World";
			this._textEditor.isEnabled = false;
			this._textEditor.validate();
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat must be equal to disabledTextFormat when isEnabled is false and disabledTextFormat is not null",
				this._textEditor.disabledTextFormat, this._textEditor.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithTextFormatAndStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textEditor.stateContext = stateContext;
			this._textEditor.textFormat = new flash.text.TextFormat();
			this._textEditor.text = "Hello World";
			this._textEditor.validate();
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat must be equal to textFormat when stateContext isEnabled is false, but no other text formats are specified",
				this._textEditor.textFormat, this._textEditor.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithDisabledTextFormatAndStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textEditor.stateContext = stateContext;
			this._textEditor.textFormat = new flash.text.TextFormat();
			this._textEditor.disabledTextFormat = new flash.text.TextFormat();
			this._textEditor.text = "Hello World";
			this._textEditor.validate();
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat must be equal to disabledTextFormat when isEnabled is false and disabledTextFormat is not null",
				this._textEditor.disabledTextFormat, this._textEditor.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithTextFormatAndStateContextSelected():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			this._textEditor.stateContext = stateContext;
			this._textEditor.textFormat = new flash.text.TextFormat();
			this._textEditor.text = "Hello World";
			this._textEditor.validate();
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat must be equal to textFormat when stateContext isSelected is true, but no other text formats are specified",
				this._textEditor.textFormat, this._textEditor.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithOnlyTextFormatAndStateContextCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.currentState = STATE_DISABLED;
			this._textEditor.stateContext = stateContext;
			this._textEditor.textFormat = new flash.text.TextFormat();
			this._textEditor.text = "Hello World";
			this._textEditor.validate();
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat must be equal to textFormat when no other text formats are specified",
				this._textEditor.textFormat, this._textEditor.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithDisabledTextFormatAndStateTextFormatWithStateContextDisabledAndCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			stateContext.currentState = STATE_DISABLED;
			this._textEditor.stateContext = stateContext;
			this._textEditor.textFormat = new flash.text.TextFormat();
			this._textEditor.disabledTextFormat = new flash.text.TextFormat();
			var disabledStateTextFormat:flash.text.TextFormat = new flash.text.TextFormat();
			this._textEditor.setTextFormatForState(STATE_DISABLED, disabledStateTextFormat);
			this._textEditor.text = "Hello World";
			this._textEditor.validate();
			//exact states always get priority over default/disabled
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat must be equal to flash.text.TextFormat passed into setTextFormatForState() when isEnabled is false and disabledTextFormat are not null",
				disabledStateTextFormat, this._textEditor.currentTextFormat);
		}

		[Test]
		public function testFontStylesIgnoredIfAdvancedTextFormatExists():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat();
			this._textEditor.fontStyles = fontStyles;
			this._textEditor.textFormat = new flash.text.TextFormat();
			this._textEditor.text = "Hello World";
			this._textEditor.validate();
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat must be equal to elementFormat and not a format from font styles",
				this._textEditor.textFormat, this._textEditor.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithFontStyles():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textEditor.fontStyles = fontStyles;
			this._textEditor.text = "Hello World";
			this._textEditor.validate();
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.font must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textEditor.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.size must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textEditor.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textEditor.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatFallBackToDefaultFontStylesWhenDisabled():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textEditor.fontStyles = fontStyles;
			this._textEditor.text = "Hello World";
			this._textEditor.isEnabled = false;
			this._textEditor.validate();
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.font must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textEditor.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.size must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textEditor.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textEditor.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatUseDisabledFontStylesWhenDisabled():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.disabledFormat = new starling.text.TextFormat(DISABLED_FONT_NAME, DISABLED_FONT_SIZE, DISABLED_COLOR);
			this._textEditor.fontStyles = fontStyles;
			this._textEditor.text = "Hello World";
			this._textEditor.isEnabled = false;
			this._textEditor.validate();
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.font must be equal to starling.text.TextFormat font",
				DISABLED_FONT_NAME, this._textEditor.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.size must be equal to starling.text.TextFormat size",
				DISABLED_FONT_SIZE, this._textEditor.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.color must be equal to starling.text.TextFormat color",
				DISABLED_COLOR, this._textEditor.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatFallBackToDefaultFontStylesWithStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textEditor.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textEditor.fontStyles = fontStyles;
			this._textEditor.text = "Hello World";
			this._textEditor.validate();
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.font must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textEditor.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.size must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textEditor.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textEditor.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatUseDisabledFontStylesWithStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textEditor.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.disabledFormat = new starling.text.TextFormat(DISABLED_FONT_NAME, DISABLED_FONT_SIZE, DISABLED_COLOR);
			this._textEditor.fontStyles = fontStyles;
			this._textEditor.text = "Hello World";
			this._textEditor.validate();
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.font must be equal to starling.text.TextFormat font",
				DISABLED_FONT_NAME, this._textEditor.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.size must be equal to starling.text.TextFormat size",
				DISABLED_FONT_SIZE, this._textEditor.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.color must be equal to starling.text.TextFormat color",
				DISABLED_COLOR, this._textEditor.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatFallBackToDefaultFontStylesWithStateContextSelected():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			this._textEditor.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textEditor.fontStyles = fontStyles;
			this._textEditor.text = "Hello World";
			this._textEditor.validate();
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.font must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textEditor.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.size must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textEditor.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textEditor.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatFallBackToDefaultFontStylesWithStateContextCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.currentState = STATE_DISABLED;
			this._textEditor.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textEditor.fontStyles = fontStyles;
			this._textEditor.text = "Hello World";
			this._textEditor.validate();
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.font must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textEditor.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.size must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textEditor.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textEditor.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatUseStateFontStylesWithStateContextCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.currentState = STATE_DISABLED;
			stateContext.isSelected = true;
			stateContext.isEnabled = false;
			this._textEditor.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.disabledFormat = new starling.text.TextFormat(DISABLED_FONT_NAME, DISABLED_FONT_SIZE, DISABLED_COLOR);
			fontStyles.setFormatForState(STATE_DISABLED, new starling.text.TextFormat(STATE_FONT_NAME, STATE_FONT_SIZE, STATE_COLOR));
			this._textEditor.fontStyles = fontStyles;
			this._textEditor.text = "Hello World";
			this._textEditor.validate();
			//exact states always get priority over default/disabled
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.font must be equal to starling.text.TextFormat font",
				STATE_FONT_NAME, this._textEditor.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.size must be equal to starling.text.TextFormat size",
				STATE_FONT_SIZE, this._textEditor.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextEditor currentTextFormat.color must be equal to starling.text.TextFormat color",
				STATE_COLOR, this._textEditor.currentTextFormat.color);
		}

		[Test]
		public function testInvalidAfterChangePropertyOfFontStyles():void
		{
			var format:starling.text.TextFormat = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = format
			this._textEditor.fontStyles = fontStyles;
			this._textEditor.text = "Hello World";
			this._textEditor.validate();
			format.color = DISABLED_COLOR;
			Assert.assertTrue("TextFieldTextEditor: must be invalid after changing property of font styles.",
				this._textEditor.isInvalid());
		}
	}
}


================================================
FILE: test/source/feathers/tests/TextFieldTextRendererTests.as
================================================
package feathers.tests
{
	import feathers.controls.text.TextFieldTextRenderer;
	import feathers.tests.supportClasses.CustomStateContext;
	import feathers.text.FontStylesSet;

	import flash.text.TextFormat;

	import org.flexunit.Assert;

	import starling.text.TextFormat;

	public class TextFieldTextRendererTests
	{
		private static const STATE_DISABLED:String = "disabled";

		private static const DEFAULT_FONT_NAME:String = "DefaultFont";
		private static const DEFAULT_FONT_SIZE:Number = 16;
		private static const DEFAULT_COLOR:uint = 0xff00ff;
		private static const DISABLED_FONT_NAME:String = "DisabledFont";
		private static const DISABLED_FONT_SIZE:Number = 15;
		private static const DISABLED_COLOR:uint = 0x999999;
		private static const SELECTED_FONT_NAME:String = "SelectedFont";
		private static const SELECTED_FONT_SIZE:Number = 17;
		private static const SELECTED_COLOR:uint = 0xff0000;
		private static const STATE_FONT_NAME:String = "StateFont";
		private static const STATE_FONT_SIZE:Number = 18;
		private static const STATE_COLOR:uint = 0xffffff;

		private var _textRenderer:TextFieldTextRenderer;

		[Before]
		public function prepare():void
		{
			this._textRenderer = new TextFieldTextRenderer();
			TestFeathers.starlingRoot.addChild(this._textRenderer);
		}

		[After]
		public function cleanup():void
		{
			this._textRenderer.removeFromParent(true);
			this._textRenderer = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testOneLineWithEmptyString():void
		{
			this._textRenderer.text = "";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer numLines must be 1 with empty string", 1, this._textRenderer.numLines);
		}

		[Test]
		public function testOneLine():void
		{
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer numLines must be 1", 1, this._textRenderer.numLines);
		}

		[Test]
		public function testNumLinesWithLineBreak():void
		{
			this._textRenderer.text = "Hello\nWorld";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer numLines must be 2 when line break is in text", 2, this._textRenderer.numLines);
		}

		[Test]
		public function testNumLinesWithCarriageReturn():void
		{
			this._textRenderer.text = "Hello\rWorld";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer numLines must be 2 when carriage return is in text", 2, this._textRenderer.numLines);
		}

		[Test]
		public function testGetTextFormatForStateWithoutSetTextFormatForState():void
		{
			Assert.assertNull("TextFieldTextRenderer getTextFormatForState() must return null if TextFormat not provided with setTextFormatForState()",
				this._textRenderer.getTextFormatForState(STATE_DISABLED));
		}

		[Test]
		public function testGetTextFormatForStateAfterSetTextFormatForState():void
		{
			var textFormat:flash.text.TextFormat = new flash.text.TextFormat();
			this._textRenderer.setTextFormatForState(STATE_DISABLED, textFormat);
			Assert.assertStrictlyEquals("TextFieldTextRenderer getTextFormatForState() must return value passed to setTextFormatForState() with same state",
				textFormat, this._textRenderer.getTextFormatForState(STATE_DISABLED));
		}

		[Test]
		public function testCurrentTextFormatWithTextFormat():void
		{
			this._textRenderer.textFormat = new flash.text.TextFormat();
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat must be equal to textFormat when no other text formats are specified",
				this._textRenderer.textFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithTextFormatAndDisabled():void
		{
			this._textRenderer.textFormat = new flash.text.TextFormat();
			this._textRenderer.text = "Hello World";
			this._textRenderer.isEnabled = false;
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat must be equal to textFormat when isEnabled is false, but no other text formats are specified",
				this._textRenderer.textFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithDisabledTextFormatAndDisabled():void
		{
			this._textRenderer.textFormat = new flash.text.TextFormat();
			this._textRenderer.disabledTextFormat = new flash.text.TextFormat();
			this._textRenderer.text = "Hello World";
			this._textRenderer.isEnabled = false;
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat must be equal to disabledTextFormat when isEnabled is false and disabledTextFormat is not null",
				this._textRenderer.disabledTextFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithTextFormatAndStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			this._textRenderer.textFormat = new flash.text.TextFormat();
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat must be equal to textFormat when stateContext isEnabled is false, but no other text formats are specified",
				this._textRenderer.textFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithDisabledTextFormatAndStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			this._textRenderer.textFormat = new flash.text.TextFormat();
			this._textRenderer.disabledTextFormat = new flash.text.TextFormat();
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat must be equal to disabledTextFormat when isEnabled is false and disabledTextFormat is not null",
				this._textRenderer.disabledTextFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithTextFormatAndStateContextSelected():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			this._textRenderer.stateContext = stateContext;
			this._textRenderer.textFormat = new flash.text.TextFormat();
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat must be equal to textFormat when stateContext isSelected is true, but no other text formats are specified",
				this._textRenderer.textFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithSelectedTextFormatAndStateContextSelected():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			this._textRenderer.stateContext = stateContext;
			this._textRenderer.textFormat = new flash.text.TextFormat();
			this._textRenderer.selectedTextFormat = new flash.text.TextFormat();
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat must be equal to selectedTextFormat when isSelected is true and selectedTextFormat is not null",
				this._textRenderer.selectedTextFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithSelectedAndDisabledTextFormatAndStateContextSelectedAndDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			this._textRenderer.textFormat = new flash.text.TextFormat();
			this._textRenderer.disabledTextFormat = new flash.text.TextFormat();
			this._textRenderer.selectedTextFormat = new flash.text.TextFormat();
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			//disabled should get priority over selected
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat must be equal to disabledTextFormat when isSelected is true and isEnabled is false and both selectedTextFormat and disabledTextFormat are not null",
				this._textRenderer.disabledTextFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithOnlyTextFormatAndStateContextCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.currentState = STATE_DISABLED;
			this._textRenderer.stateContext = stateContext;
			this._textRenderer.textFormat = new flash.text.TextFormat();
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat must be equal to textFormat when no other text formats are specified",
				this._textRenderer.textFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithDisabledTextFormatAndStateTextFormatWithStateContextDisabledAndCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			stateContext.currentState = STATE_DISABLED;
			this._textRenderer.stateContext = stateContext;
			this._textRenderer.textFormat = new flash.text.TextFormat();
			this._textRenderer.disabledTextFormat = new flash.text.TextFormat();
			var disabledStateTextFormat:flash.text.TextFormat = new flash.text.TextFormat();
			this._textRenderer.setTextFormatForState(STATE_DISABLED, disabledStateTextFormat);
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			//exact states always get priority over default/disabled/selected
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat must be equal to flash.text.TextFormat passed into setTextFormatForState() when isEnabled is false and disabledTextFormat are not null",
				disabledStateTextFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testFontStylesIgnoredIfAdvancedTextFormatExists():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat();
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.textFormat = new flash.text.TextFormat();
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat must be equal to elementFormat and not a format from font styles",
				this._textRenderer.textFormat, this._textRenderer.currentTextFormat);
		}

		[Test]
		public function testCurrentTextFormatWithFontStyles():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.font must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatFallBackToDefaultFontStylesWhenDisabled():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.isEnabled = false;
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.font must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatUseDisabledFontStylesWhenDisabled():void
		{
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.disabledFormat = new starling.text.TextFormat(DISABLED_FONT_NAME, DISABLED_FONT_SIZE, DISABLED_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.isEnabled = false;
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.font must be equal to starling.text.TextFormat font",
				DISABLED_FONT_NAME, this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DISABLED_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DISABLED_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatFallBackToDefaultFontStylesWithStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.font must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatUseDisabledFontStylesWithStateContextDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.disabledFormat = new starling.text.TextFormat(DISABLED_FONT_NAME, DISABLED_FONT_SIZE, DISABLED_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.font must be equal to starling.text.TextFormat font",
				DISABLED_FONT_NAME, this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DISABLED_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DISABLED_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatFallBackToDefaultFontStylesWithStateContextSelected():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.font must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatUseSelectedFontStylesWithStateContextSelected():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.selectedFormat = new starling.text.TextFormat(SELECTED_FONT_NAME, SELECTED_FONT_SIZE, SELECTED_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.font must be equal to starling.text.TextFormat font",
				SELECTED_FONT_NAME, this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				SELECTED_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				SELECTED_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatUseDisabledFontStylesWithStateContextSelectedAndDisabled():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.isSelected = true;
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.selectedFormat = new starling.text.TextFormat(SELECTED_FONT_NAME, SELECTED_FONT_SIZE, SELECTED_COLOR);
			fontStyles.disabledFormat = new starling.text.TextFormat(DISABLED_FONT_NAME, DISABLED_FONT_SIZE, DISABLED_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			//disabled should get priority over selected
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.font must be equal to starling.text.TextFormat font",
				DISABLED_FONT_NAME, this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DISABLED_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DISABLED_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatFallBackToDefaultFontStylesWithStateContextCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.currentState = STATE_DISABLED;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.font must be equal to starling.text.TextFormat font",
				DEFAULT_FONT_NAME, this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				DEFAULT_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				DEFAULT_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testCurrentTextFormatUseStateFontStylesWithStateContextCurrentState():void
		{
			var stateContext:CustomStateContext = new CustomStateContext();
			stateContext.currentState = STATE_DISABLED;
			stateContext.isSelected = true;
			stateContext.isEnabled = false;
			this._textRenderer.stateContext = stateContext;
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			fontStyles.selectedFormat = new starling.text.TextFormat(SELECTED_FONT_NAME, SELECTED_FONT_SIZE, SELECTED_COLOR);
			fontStyles.disabledFormat = new starling.text.TextFormat(DISABLED_FONT_NAME, DISABLED_FONT_SIZE, DISABLED_COLOR);
			fontStyles.setFormatForState(STATE_DISABLED, new starling.text.TextFormat(STATE_FONT_NAME, STATE_FONT_SIZE, STATE_COLOR));
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			//exact states always get priority over default/disabled/selected
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.font must be equal to starling.text.TextFormat font",
				STATE_FONT_NAME, this._textRenderer.currentTextFormat.font);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.size must be equal to starling.text.TextFormat size",
				STATE_FONT_SIZE, this._textRenderer.currentTextFormat.size);
			Assert.assertStrictlyEquals("TextFieldTextRenderer currentTextFormat.color must be equal to starling.text.TextFormat color",
				STATE_COLOR, this._textRenderer.currentTextFormat.color);
		}

		[Test]
		public function testInvalidAfterChangePropertyOfFontStyles():void
		{
			var format:starling.text.TextFormat = new starling.text.TextFormat(DEFAULT_FONT_NAME, DEFAULT_FONT_SIZE, DEFAULT_COLOR);
			var fontStyles:FontStylesSet = new FontStylesSet();
			fontStyles.format = format
			this._textRenderer.fontStyles = fontStyles;
			this._textRenderer.text = "Hello World";
			this._textRenderer.validate();
			format.color = SELECTED_COLOR;
			Assert.assertTrue("TextFieldTextRenderer: must be invalid after changing property of font styles.",
				this._textRenderer.isInvalid());
		}
	}
}


================================================
FILE: test/source/feathers/tests/TextInputFocusTests.as
================================================
package feathers.tests
{
	import feathers.controls.TextInput;
	import feathers.controls.text.TextFieldTextEditor;
	import feathers.core.FocusManager;
	import feathers.events.FeathersEventType;

	import org.flexunit.Assert;

	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class TextInputFocusTests
	{
		private static const SAMPLE_TEXT:String = "I am the very model of a modern major general";

		private var _textInput:TextInput;

		[Before]
		public function prepare():void
		{
			this._textInput = new TextInput();
			this._textInput.backgroundSkin = new Quad(200, 200);
			this._textInput.textEditorFactory = textEditorFactory;
			TestFeathers.starlingRoot.addChild(this._textInput);
			this._textInput.validate();
		}

		private function textEditorFactory():TextFieldTextEditor
		{
			var textEditor:TextFieldTextEditor = new TextFieldTextEditor();
			return textEditor;
		}

		[After]
		public function cleanup():void
		{
			TestFeathers.starlingRoot.visible = true;
			FocusManager.setEnabledForStage(this._textInput.stage, false);
			this._textInput.removeFromParent(true);
			this._textInput = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testFocusInEventAfterSetFocusFunctionWithoutFocusManager():void
		{
			var hasDispatchedFocusIn:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_IN, function(event:Event):void
			{
				hasDispatchedFocusIn = true;
			});
			this._textInput.setFocus();
			Assert.assertTrue("FeathersEventType.FOCUS_IN was not dispatched after calling setFocus()", hasDispatchedFocusIn);
		}

		[Test]
		public function testFocusOutEventAfterClearFocusFunctionWithoutFocusManager():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_OUT, function(event:Event):void
			{
				hasDispatchedFocusOut = true;
			});
			this._textInput.setFocus();
			this._textInput.clearFocus();
			Assert.assertTrue("FeathersEventType.FOCUS_OUT was not dispatched after calling clearFocus()", hasDispatchedFocusOut);
		}

		[Test]
		public function testFocusOutEventAfterSetVisibleToFalseWithoutFocusManager():void
		{
			var hasDispatchedFocusOut:Boolean = false;
			this._textInput.addEventListener(FeathersEventType.FOCUS_OUT, function(event:Event):void
			{
				hasDispatchedFocusOut = true;
			});
			this._textInput.setFocus();
			this._textInput.visible = false;
			Assert.assertTrue("FeathersEventType.FOCUS_OUT was not dispatched after setting visible property to false", hasDispatchedFocusOut);
		}

		[Test]
		public function testFocusInEventAfterSetFocusFunctionWithFocusManager():void
		{
			FocusManager.setEnabledForStage(this._textInput.stage, true);
			this.testFocusInEventAfterSetFocusFunctionWithoutFocusManager();
		}

		[Test]
		public function testFocusOutEventAfterClearFocusFunctionWithFocusManager():void
		{
			FocusManager.setEnabledForStage(this._textInput.stage, true);
			this.testFocusOutEventAfterClearFocusFunctionWithoutFocusManager();
		}

		[Test]
		public function testFocusOutEventAfterSetVisibleToFalseWithFocusManager():void
		{
			FocusManager.setEnabledForStage(this._textInput.stage, true);
			this.testFocusOutEventAfterSetVisibleToFalseWithoutFocusManager();
		}

		[Test]
		public function testSelectionRangeInsideFocusInListenerAfterSetFocusFunctionWithoutFocusManager():void
		{
			this._textInput.text = SAMPLE_TEXT;
			var selectionBeginIndex:int = -1;
			var selectionEndIndex:int = -1;
			this._textInput.addEventListener(FeathersEventType.FOCUS_IN, function(event:Event):void
			{
				selectionBeginIndex = _textInput.selectionBeginIndex;
				selectionEndIndex = _textInput.selectionEndIndex;
			});
			this._textInput.setFocus();
			Assert.assertStrictlyEquals("TextInput selectionBeginIndex incorrect after calling setFocus()",
				0, selectionBeginIndex);
			Assert.assertStrictlyEquals("TextInput selectionBeginIndex incorrect after calling setFocus()",
				SAMPLE_TEXT.length, selectionEndIndex);
		}

		[Test]
		public function testSelectionRangeInsideFocusInListenerAfterSetFocusFunctionWithFocusManager():void
		{
			FocusManager.setEnabledForStage(this._textInput.stage, true);
			this.testSelectionRangeInsideFocusInListenerAfterSetFocusFunctionWithoutFocusManager();
		}

		[Test]
		public function testSelectionRangeAfterSetFocusThenSelectRangeFunctionWithoutFocusManager():void
		{
			this._textInput.text = SAMPLE_TEXT;
			this._textInput.setFocus();
			var selectionBeginIndex:int = 1;
			var selectionEndIndex:int = 3;
			this._textInput.selectRange(selectionBeginIndex, selectionEndIndex);
			Assert.assertStrictlyEquals("TextInput selectionBeginIndex incorrect after calling setFocus() then selectRange()",
				selectionBeginIndex, this._textInput.selectionBeginIndex);
			Assert.assertStrictlyEquals("TextInput selectionBeginIndex incorrect after calling setFocus() then selectRange()",
				selectionEndIndex, this._textInput.selectionEndIndex);
		}

		[Test]
		public function testSelectionRangeAfterSetFocusThenSelectRangeFunctionWithFocusManager():void
		{
			FocusManager.setEnabledForStage(this._textInput.stage, true);
			this.testSelectionRangeAfterSetFocusThenSelectRangeFunctionWithoutFocusManager();
		}

		[Test]
		public function testSelectionRangeAfterTouchEventWithoutFocusManager():void
		{
			this._textInput.text = SAMPLE_TEXT;
			//validate to make sure the text is passed down to the text editor
			this._textInput.validate();

			var selectionBeginIndex:int = -1;
			var selectionEndIndex:int = -1;
			this._textInput.addEventListener(FeathersEventType.FOCUS_IN, function(event:Event):void
			{
				selectionBeginIndex = _textInput.selectionBeginIndex;
				selectionEndIndex = _textInput.selectionEndIndex;
			});

			var touch:Touch = new Touch(0);
			touch.target = this._textInput;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = 100;
			touch.globalY = 5;
			var touches:Vector.<Touch> = new <Touch>[touch];
			this._textInput.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			this._textInput.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			//we don't care what the exact index is, but it should be clear that
			//the touch changed it to something
			Assert.assertStrictlyEquals("TextInput selectionBeginIndex and selectionEndIndex don't match after TouchEvent.TOUCH",
				selectionBeginIndex, selectionEndIndex);
			Assert.assertTrue("TextInput selectionBeginIndex and selectionEndIndex not greater than 0 after TouchEvent.TOUCH",
				selectionBeginIndex > 0);
			Assert.assertTrue("TextInput selectionBeginIndex and selectionEndIndex not less than text length after TouchEvent.TOUCH",
				selectionEndIndex < SAMPLE_TEXT.length);
		}

		[Test]
		public function testSelectionRangeAfterTouchEventWithFocusManager():void
		{
			FocusManager.setEnabledForStage(this._textInput.stage, true);
			this.testSelectionRangeAfterTouchEventWithoutFocusManager();
		}
	}
}


================================================
FILE: test/source/feathers/tests/TextInputInternalStateTests.as
================================================
package feathers.tests
{
	import feathers.controls.TextInputState;
	import feathers.core.FocusManager;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class TextInputInternalStateTests
	{
		private var _input:TextInputWithInternalState;

		[Before]
		public function prepare():void
		{
			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, true);
			
			this._input = new TextInputWithInternalState();
			TestFeathers.starlingRoot.addChild(this._input);
		}

		[After]
		public function cleanup():void
		{
			this._input.removeFromParent(true);
			this._input = null;

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testGetSkinForStateWithoutSetSkinForState():void
		{
			Assert.assertNull("TextInput getSkinForState(TextInputState.ENABLED) must be null when setSkinForState() is not called", this._input.getSkinForState(TextInputState.FOCUSED));
			Assert.assertNull("TextInput getSkinForState(TextInputState.DISABLED) must be null when setSkinForState() is not called", this._input.getSkinForState(TextInputState.DISABLED));
			Assert.assertNull("TextInput getSkinForState(TextInputState.FOCUSED) must be null when setSkinForState() is not called", this._input.getSkinForState(TextInputState.FOCUSED));
			Assert.assertNull("TextInput getSkinForState(TextInputState.ERROR) must be null when setSkinForState() is not called", this._input.getSkinForState(TextInputState.ERROR));
		}

		[Test]
		public function testGetSkinForState():void
		{
			var backgroundSkin:Quad = new Quad(200, 200);
			this._input.backgroundSkin = backgroundSkin;

			var enabledSkin:Quad = new Quad(200, 200);
			this._input.setSkinForState(TextInputState.ENABLED, enabledSkin);

			var disabledSkin:Quad = new Quad(200, 200);
			this._input.setSkinForState(TextInputState.DISABLED, disabledSkin);

			var focusedSkin:Quad = new Quad(200, 200);
			this._input.setSkinForState(TextInputState.FOCUSED, focusedSkin);

			var errorSkin:Quad = new Quad(200, 200);
			this._input.setSkinForState(TextInputState.ERROR, errorSkin);

			Assert.assertStrictlyEquals("TextInput getSkinForState(TextInputState.ENABLED) does not match value passed to setSkinForState()", enabledSkin, this._input.getSkinForState(TextInputState.ENABLED));
			Assert.assertStrictlyEquals("TextInput getSkinForState(TextInputState.DISABLED) does not match value passed to setSkinForState()", disabledSkin, this._input.getSkinForState(TextInputState.DISABLED));
			Assert.assertStrictlyEquals("TextInput getSkinForState(TextInputState.FOCUSED) does not match value passed to setSkinForState()", focusedSkin, this._input.getSkinForState(TextInputState.FOCUSED));
			Assert.assertStrictlyEquals("TextInput getSkinForState(TextInputState.ERROR) does not match value passed to setSkinForState()", errorSkin, this._input.getSkinForState(TextInputState.ERROR));
		}

		[Test]
		public function testDefaultCurrentBackground():void
		{
			var backgroundSkin:Quad = new Quad(200, 200);
			this._input.backgroundSkin = backgroundSkin;

			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.ENABLED by default", TextInputState.ENABLED, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundSkin when currentState is TextInputState.ENABLED and background not provided for this state", backgroundSkin, this._input.currentBackgroundInternal);

			this._input.errorString = "Error";
			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.ERROR when errorString is not null", TextInputState.ERROR, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundSkin when currentState is TextInputState.ENABLED and background not provided for this state", backgroundSkin, this._input.currentBackgroundInternal);
			this._input.errorString = null;

			this._input.isEnabled = false;
			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.DISABLED when isEnabled is false", TextInputState.DISABLED, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundSkin when currentState is TextInputState.DISABLED and background not provided for this state", backgroundSkin, this._input.currentBackgroundInternal);

			this._input.isEnabled = true;
			FocusManager.focus = this._input;
			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.FOCUSED when input is focused", TextInputState.FOCUSED, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundSkin when currentState is TextInputState.FOCUSED and background not provided for this state", backgroundSkin, this._input.currentBackgroundInternal);
		}

		[Test]
		public function testCurrentSkinWithSetSkinForState():void
		{
			var backgroundSkin:Quad = new Quad(200, 200);
			this._input.backgroundSkin = backgroundSkin;

			var backgroundEnabledSkin:Quad = new Quad(200, 200);
			this._input.setSkinForState(TextInputState.ENABLED, backgroundEnabledSkin);

			var backgroundDisabledSkin:Quad = new Quad(200, 200);
			this._input.setSkinForState(TextInputState.DISABLED, backgroundDisabledSkin);

			var backgroundFocusedSkin:Quad = new Quad(200, 200);
			this._input.setSkinForState(TextInputState.FOCUSED, backgroundFocusedSkin);

			var backgroundErrorSkin:Quad = new Quad(200, 200);
			this._input.setSkinForState(TextInputState.ERROR, backgroundErrorSkin);

			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.ENABLED by default", TextInputState.ENABLED, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundEnabledSkin when currentState is TextInputState.ENABLED", backgroundEnabledSkin, this._input.currentBackgroundInternal);

			this._input.errorString = "Error";
			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.ERROR when errorString is not null", TextInputState.ERROR, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundEnabledSkin when currentState is TextInputState.ENABLED", backgroundErrorSkin, this._input.currentBackgroundInternal);
			this._input.errorString = null;

			this._input.isEnabled = false;
			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.DISABLED when isEnabled is false", TextInputState.DISABLED, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundDisabledSkin when currentState is TextInputState.DISABLED", backgroundDisabledSkin, this._input.currentBackgroundInternal);

			this._input.isEnabled = true;
			FocusManager.focus = this._input;
			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.FOCUSED when input is focused", TextInputState.FOCUSED, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput background is not backgroundFocusedSkin when currentState is TextInputState.FOCUSED", backgroundFocusedSkin, this._input.currentBackgroundInternal);
		}
		
		[Test]
		public function testGetIconForStateWithoutSetIconForState():void
		{
			Assert.assertNull("TextInput getIconForState(TextInputState.ENABLED) must be null when setIconForState() is not called", this._input.getIconForState(TextInputState.FOCUSED));
			Assert.assertNull("TextInput getIconForState(TextInputState.DISABLED) must be null when setIconForState() is not called", this._input.getIconForState(TextInputState.DISABLED));
			Assert.assertNull("TextInput getIconForState(TextInputState.FOCUSED) must be null when setIconForState() is not called", this._input.getIconForState(TextInputState.FOCUSED));
			Assert.assertNull("TextInput getIconForState(TextInputState.ERROR) must be null when setIconForState() is not called", this._input.getIconForState(TextInputState.ERROR));
		}

		[Test]
		public function testGetIconForState():void
		{
			var defaultIcon:Quad = new Quad(200, 200);
			this._input.defaultIcon = defaultIcon;

			var enabledIcon:Quad = new Quad(200, 200);
			this._input.setIconForState(TextInputState.ENABLED, enabledIcon);

			var disabledIcon:Quad = new Quad(200, 200);
			this._input.setIconForState(TextInputState.DISABLED, disabledIcon);

			var focusedIcon:Quad = new Quad(200, 200);
			this._input.setIconForState(TextInputState.FOCUSED, focusedIcon);

			var errorIcon:Quad = new Quad(200, 200);
			this._input.setIconForState(TextInputState.ERROR, errorIcon);

			Assert.assertStrictlyEquals("TextInput getIconForState(TextInputState.ENABLED) does not match value passed to setIconForState()", enabledIcon, this._input.getIconForState(TextInputState.ENABLED));
			Assert.assertStrictlyEquals("TextInput getIconForState(TextInputState.DISABLED) does not match value passed to setIconForState()", disabledIcon, this._input.getIconForState(TextInputState.DISABLED));
			Assert.assertStrictlyEquals("TextInput getIconForState(TextInputState.FOCUSED) does not match value passed to setIconForState()", focusedIcon, this._input.getIconForState(TextInputState.FOCUSED));
			Assert.assertStrictlyEquals("TextInput getIconForState(TextInputState.ERROR) does not match value passed to setIconForState()", errorIcon, this._input.getIconForState(TextInputState.ERROR));
		}

		[Test]
		public function testDefaultCurrentIcon():void
		{
			var defaultIcon:Quad = new Quad(200, 200);
			this._input.defaultIcon = defaultIcon;

			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.ENABLED by default", TextInputState.ENABLED, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput icon is not defaultIcon when currentState is TextInputState.ENABLED and icon not provided for this state", defaultIcon, this._input.currentIconInternal);

			this._input.errorString = "Error";
			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.ERROR when errorString is not null", TextInputState.ERROR, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput icon is not defaultIcon when currentState is TextInputState.ERROR and icon not provided for this state", defaultIcon, this._input.currentIconInternal);
			this._input.errorString = null;

			this._input.isEnabled = false;
			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.DISABLED when isEnabled is false", TextInputState.DISABLED, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput icon is not defaultIcon when currentState is TextInputState.DISABLED and icon not provided for this state", defaultIcon, this._input.currentIconInternal);

			this._input.isEnabled = true;
			FocusManager.focus = this._input;
			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.FOCUSED when input is focused", TextInputState.FOCUSED, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput icon is not defaultIcon when currentState is TextInputState.FOCUSED and icon not provided for this state", defaultIcon, this._input.currentIconInternal);
		}

		[Test]
		public function testCurrentIconWithSetIconForState():void
		{
			var defaultIcon:Quad = new Quad(200, 200);
			this._input.defaultIcon = defaultIcon;

			var enabledIcon:Quad = new Quad(200, 200);
			this._input.setIconForState(TextInputState.ENABLED, enabledIcon);

			var disabledIcon:Quad = new Quad(200, 200);
			this._input.setIconForState(TextInputState.DISABLED, disabledIcon);

			var focusedIcon:Quad = new Quad(200, 200);
			this._input.setIconForState(TextInputState.FOCUSED, focusedIcon);

			var errorIcon:Quad = new Quad(200, 200);
			this._input.setIconForState(TextInputState.ERROR, errorIcon);

			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.ENABLED by default", TextInputState.ENABLED, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput icon is not enabledIcon when currentState is TextInputState.ENABLED", enabledIcon, this._input.currentIconInternal);

			this._input.errorString = "Error";
			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.ERROR when errorString is not null", TextInputState.ERROR, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput icon is not errorIcon when currentState is TextInputState.ERROR", errorIcon, this._input.currentIconInternal);
			this._input.errorString = null;

			this._input.isEnabled = false;
			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.DISABLED when isEnabled is false", TextInputState.DISABLED, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput icon is not disabledIcon when currentState is TextInputState.DISABLED", disabledIcon, this._input.currentIconInternal);

			this._input.isEnabled = true;
			FocusManager.focus = this._input;
			this._input.validate();
			Assert.assertStrictlyEquals("TextInput state is not TextInputState.FOCUSED when input is focused", TextInputState.FOCUSED, this._input.currentState);
			Assert.assertStrictlyEquals("TextInput icon is not focusedIcon when currentState is TextInputState.FOCUSED", focusedIcon, this._input.currentIconInternal);
		}
	}
}

import feathers.controls.TextInput;

import starling.display.DisplayObject;

class TextInputWithInternalState extends TextInput
{
	public function TextInputWithInternalState()
	{
		super();
	}

	public function get currentBackgroundInternal():DisplayObject
	{
		return this.currentBackground;
	}

	public function get currentIconInternal():DisplayObject
	{
		return this.currentIcon;
	}
}

================================================
FILE: test/source/feathers/tests/TextInputMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.LayoutGroup;
	import feathers.controls.TextInput;
	import feathers.controls.text.BitmapFontTextRenderer;
	import feathers.core.ITextRenderer;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class TextInputMeasurementTests
	{
		private static const SMALL_BACKGROUND_WIDTH:Number = 10;
		private static const SMALL_BACKGROUND_HEIGHT:Number = 12;
		private static const LARGE_BACKGROUND_WIDTH:Number = 200;
		private static const LARGE_BACKGROUND_HEIGHT:Number = 210;
		private static const COMPLEX_BACKGROUND_WIDTH:Number = 54;
		private static const COMPLEX_BACKGROUND_HEIGHT:Number = 55;
		private static const COMPLEX_BACKGROUND_MIN_WIDTH:Number = 38;
		private static const COMPLEX_BACKGROUND_MIN_HEIGHT:Number = 39;

		private static const SMALL_ICON_WIDTH:Number = 13;
		private static const SMALL_ICON_HEIGHT:Number = 11;
		private static const LARGE_ICON_WIDTH:Number = 105;
		private static const LARGE_ICON_HEIGHT:Number = 115;
		private static const COMPLEX_ICON_WIDTH:Number = 23;
		private static const COMPLEX_ICON_HEIGHT:Number = 25;
		private static const COMPLEX_ICON_MIN_WIDTH:Number = 18;
		private static const COMPLEX_ICON_MIN_HEIGHT:Number = 19;
		
		private static const PADDING_TOP:Number = 50;
		private static const PADDING_RIGHT:Number = 54;
		private static const PADDING_BOTTOM:Number = 59;
		private static const PADDING_LEFT:Number = 60;
		private static const GAP:Number = 6;

		private var input:TextInput;
		private var textRenderer:BitmapFontTextRenderer;

		[Before]
		public function prepare():void
		{
			this.input = new TextInput();
			this.input.promptFactory = function():ITextRenderer
			{
				return new BitmapFontTextRenderer();
			};
			TestFeathers.starlingRoot.addChild(this.input);

			this.textRenderer = new BitmapFontTextRenderer();
			TestFeathers.starlingRoot.addChild(this.textRenderer);
		}

		[After]
		public function cleanup():void
		{
			this.textRenderer.removeFromParent(true);
			this.textRenderer = null;
			
			this.input.removeFromParent(true);
			this.input = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function addSmallSimpleBackground():void
		{
			this.input.backgroundSkin = new Quad(SMALL_BACKGROUND_WIDTH, SMALL_BACKGROUND_HEIGHT, 0xff00ff);
		}

		private function addLargeSimpleBackground():void
		{
			this.input.backgroundSkin = new Quad(LARGE_BACKGROUND_WIDTH, LARGE_BACKGROUND_HEIGHT, 0xff00ff);
		}

		private function addComplexBackground():void
		{
			var backgroundSkin:LayoutGroup = new LayoutGroup();
			backgroundSkin.width = COMPLEX_BACKGROUND_WIDTH;
			backgroundSkin.height = COMPLEX_BACKGROUND_HEIGHT;
			backgroundSkin.minWidth = COMPLEX_BACKGROUND_MIN_WIDTH;
			backgroundSkin.minHeight = COMPLEX_BACKGROUND_MIN_HEIGHT;
			this.input.backgroundSkin = backgroundSkin;
		}
		
		private function addSmallSimpleIcon():void
		{
			this.input.defaultIcon = new Quad(SMALL_ICON_WIDTH, SMALL_ICON_HEIGHT, 0xff00ff);
		}

		private function addLargeSimpleIcon():void
		{
			this.input.defaultIcon = new Quad(LARGE_ICON_WIDTH, LARGE_ICON_HEIGHT, 0xff00ff);
		}

		private function addComplexIcon():void
		{
			var icon:LayoutGroup = new LayoutGroup();
			icon.width = COMPLEX_ICON_WIDTH;
			icon.height = COMPLEX_ICON_HEIGHT;
			icon.minWidth = COMPLEX_ICON_MIN_WIDTH;
			icon.minHeight = COMPLEX_ICON_MIN_HEIGHT;
			this.input.defaultIcon = icon;
		}

		[Test]
		public function testAutoSizeWithPadding():void
		{
			this.input.paddingTop = PADDING_TOP;
			this.input.paddingRight = PADDING_RIGHT;
			this.input.paddingBottom = PADDING_BOTTOM;
			this.input.paddingLeft = PADDING_LEFT;
			this.input.validate();

			Assert.assertStrictlyEquals("The width of the TextInput was not calculated correctly based on the left and right padding.",
				PADDING_LEFT + PADDING_RIGHT, this.input.width);
			Assert.assertStrictlyEquals("The height of the TextInput was not calculated correctly based on the top and bottom padding.",
				PADDING_TOP + PADDING_BOTTOM, this.input.height);
			Assert.assertStrictlyEquals("The minWidth of the TextInput was not calculated correctly based on the left and right padding.",
				PADDING_LEFT + PADDING_RIGHT, this.input.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the TextInput was not calculated correctly based on the top and bottom padding.",
				PADDING_TOP + PADDING_BOTTOM, this.input.minHeight);
		}

		[Test]
		public function testAutoSizeWithPrompt():void
		{
			var promptText:String = "I am the very model of a modern major general";
			this.textRenderer.text = promptText;
			this.textRenderer.validate();
			
			this.input.prompt = promptText;
			this.input.validate();

			Assert.assertTrue("The width of the TextInput was not greater than 0 when using a prompt.",
				this.input.width > 0);
			Assert.assertTrue("The height of the TextInput was not greater than 0 when using a prompt.",
				this.input.height > 0);
			Assert.assertTrue("The minWidth of the TextInput was not greater than 0 when using a prompt.",
				this.input.minWidth > 0);
			Assert.assertTrue("The minHeight of the TextInput was not greater than 0 when using a prompt.",
				this.input.minHeight > 0);
			Assert.assertStrictlyEquals("The width of the TextInput was not calculated correctly based on the prompt.",
				this.textRenderer.width, this.input.width);
			Assert.assertStrictlyEquals("The height of the TextInput was not calculated correctly based on the prompt.",
				this.textRenderer.height, this.input.height);
			Assert.assertStrictlyEquals("The minWidth of the TextInput was not calculated correctly based on the prompt.",
				this.textRenderer.width, this.input.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the TextInput was not calculated correctly based on the prompt.",
				this.textRenderer.height, this.input.minHeight);
		}

		[Test]
		public function testAutoSizeWithPromptAndPadding():void
		{
			var promptText:String = "I am the very model of a modern major general";
			this.textRenderer.text = promptText;
			this.textRenderer.validate();

			this.input.prompt = promptText;
			this.input.paddingTop = PADDING_TOP;
			this.input.paddingRight = PADDING_RIGHT;
			this.input.paddingBottom = PADDING_BOTTOM;
			this.input.paddingLeft = PADDING_LEFT;
			this.input.validate();

			Assert.assertStrictlyEquals("The width of the TextInput was not calculated correctly based on the prompt and left and right padding.",
				this.textRenderer.width + PADDING_LEFT + PADDING_RIGHT, this.input.width);
			Assert.assertStrictlyEquals("The height of the TextInput was not calculated correctly based on the prompt and top and bottom padding.",
				this.textRenderer.height + PADDING_TOP + PADDING_BOTTOM, this.input.height);
			Assert.assertStrictlyEquals("The minWidth of the TextInput was not calculated correctly based on the prompt and left and right padding.",
				this.textRenderer.width + PADDING_LEFT + PADDING_RIGHT, this.input.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the TextInput was not calculated correctly based on the prompt and top and bottom padding.",
				this.textRenderer.height + PADDING_TOP + PADDING_BOTTOM, this.input.minHeight);
		}

		[Test]
		public function testAutoSizeWithPromptAndSimpleIcon():void
		{
			var promptText:String = "I am the very model of a modern major general";
			this.textRenderer.text = promptText;
			this.textRenderer.validate();

			this.addLargeSimpleIcon();
			this.input.prompt = promptText;
			this.input.validate();

			Assert.assertStrictlyEquals("The width of the TextInput was not calculated correctly based on the prompt and icon.",
				this.textRenderer.width + LARGE_ICON_WIDTH, this.input.width);
			Assert.assertStrictlyEquals("The height of the TextInput was not calculated correctly based on the prompt and icon.",
				LARGE_ICON_HEIGHT, this.input.height);
			Assert.assertStrictlyEquals("The minWidth of the TextInput was not calculated correctly based on the prompt and icon.",
				this.textRenderer.width + LARGE_ICON_WIDTH, this.input.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the TextInput was not calculated correctly based on the prompt and icon.",
				LARGE_ICON_HEIGHT, this.input.minHeight);
		}

		[Test]
		public function testAutoSizeWithPromptGapAndSimpleIcon():void
		{
			var promptText:String = "I am the very model of a modern major general";
			this.textRenderer.text = promptText;
			this.textRenderer.validate();

			this.addLargeSimpleIcon();
			this.input.prompt = promptText;
			this.input.gap = GAP;
			this.input.validate();

			Assert.assertStrictlyEquals("The width of the TextInput was not calculated correctly based on the prompt, gap, and icon.",
				this.textRenderer.width + GAP + LARGE_ICON_WIDTH, this.input.width);
			Assert.assertStrictlyEquals("The height of the TextInput was not calculated correctly based on the prompt, gap, and icon.",
				LARGE_ICON_HEIGHT, this.input.height);
			Assert.assertStrictlyEquals("The minWidth of the TextInput was not calculated correctly based on the prompt, gap, and icon.",
				this.textRenderer.width + GAP + LARGE_ICON_WIDTH, this.input.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the TextInput was not calculated correctly based on the prompt, and icon.",
				LARGE_ICON_HEIGHT, this.input.minHeight);
		}

		[Test]
		public function testAutoSizeWithPromptGapPaddingAndSimpleIcon():void
		{
			var promptText:String = "I am the very model of a modern major general";
			this.textRenderer.text = promptText;
			this.textRenderer.validate();

			this.addLargeSimpleIcon();
			this.input.prompt = promptText;
			this.input.paddingTop = PADDING_TOP;
			this.input.paddingRight = PADDING_RIGHT;
			this.input.paddingBottom = PADDING_BOTTOM;
			this.input.paddingLeft = PADDING_LEFT;
			this.input.gap = GAP;
			this.input.validate();

			Assert.assertStrictlyEquals("The width of the TextInput was not calculated correctly based on the prompt, gap, left and right padding, and icon.",
				this.textRenderer.width + GAP + LARGE_ICON_WIDTH + PADDING_LEFT + PADDING_RIGHT, this.input.width);
			Assert.assertStrictlyEquals("The height of the TextInput was not calculated correctly based on the prompt, gap, top and bottom padding, and icon.",
				LARGE_ICON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this.input.height);
			Assert.assertStrictlyEquals("The minWidth of the TextInput was not calculated correctly based on the prompt, gap, left and right padding, and icon.",
				this.textRenderer.width + GAP + LARGE_ICON_WIDTH + PADDING_LEFT + PADDING_RIGHT, this.input.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the TextInput was not calculated correctly based on the prompt, gap, top and bottom padding, and icon.",
				LARGE_ICON_HEIGHT + PADDING_TOP + PADDING_BOTTOM, this.input.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleBackgroundSkin():void
		{
			this.addSmallSimpleBackground();
			this.input.validate();

			Assert.assertStrictlyEquals("The width of the TextInput was not calculated correctly based on the background width.",
				SMALL_BACKGROUND_WIDTH, this.input.width);
			Assert.assertStrictlyEquals("The height of the TextInput was not calculated correctly based on the background height.",
				SMALL_BACKGROUND_HEIGHT, this.input.height);
			Assert.assertStrictlyEquals("The minWidth of the TextInput was not calculated correctly based on the background width.",
				SMALL_BACKGROUND_WIDTH, this.input.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the TextInput was not calculated correctly based on the background height.",
				SMALL_BACKGROUND_HEIGHT, this.input.minHeight);
		}

		[Test]
		public function testAutoSizeWithSmallSimpleBackgroundSkinAndLargeSimpleIcon():void
		{
			this.addSmallSimpleBackground();
			this.addLargeSimpleIcon();
			this.input.validate();

			Assert.assertStrictlyEquals("The width of the TextInput was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this.input.width);
			Assert.assertStrictlyEquals("The height of the TextInput was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this.input.height);
			Assert.assertStrictlyEquals("The minWidth of the TextInput was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this.input.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the TextInput was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this.input.minHeight);
		}

		[Test]
		public function testAutoSizeWithLargeSimpleBackgroundSkinAndSmallSimpleIcon():void
		{
			this.addLargeSimpleBackground();
			this.addSmallSimpleIcon();
			this.input.validate();

			Assert.assertStrictlyEquals("The width of the TextInput was not calculated correctly based on the background width.",
				LARGE_BACKGROUND_WIDTH, this.input.width);
			Assert.assertStrictlyEquals("The height of the TextInput was not calculated correctly based on the background height.",
				LARGE_BACKGROUND_HEIGHT, this.input.height);
			Assert.assertStrictlyEquals("The minWidth of the TextInput was not calculated correctly based on the background width.",
				LARGE_BACKGROUND_WIDTH, this.input.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the TextInput was not calculated correctly based on the background height.",
				LARGE_BACKGROUND_HEIGHT, this.input.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexBackground():void
		{
			this.addComplexBackground();
			this.input.validate();

			Assert.assertStrictlyEquals("The width of the TextInput was not calculated correctly based on the complex background width.",
				COMPLEX_BACKGROUND_WIDTH, this.input.width);
			Assert.assertStrictlyEquals("The height of the TextInput was not calculated correctly based on the complex background height.",
				COMPLEX_BACKGROUND_HEIGHT, this.input.height);
			Assert.assertStrictlyEquals("The minWidth of the TextInput was not calculated correctly based on the complex background minWidth.",
				COMPLEX_BACKGROUND_MIN_WIDTH, this.input.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the TextInput was not calculated correctly based on the complex background minHeight.",
				COMPLEX_BACKGROUND_MIN_HEIGHT, this.input.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleIcon():void
		{
			this.addLargeSimpleIcon();
			this.input.validate();

			Assert.assertStrictlyEquals("The width of the TextInput was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this.input.width);
			Assert.assertStrictlyEquals("The height of the TextInput was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this.input.height);
			Assert.assertStrictlyEquals("The minWidth of the TextInput was not calculated correctly based on the icon width.",
				LARGE_ICON_WIDTH, this.input.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the TextInput was not calculated correctly based on the icon height.",
				LARGE_ICON_HEIGHT, this.input.minHeight);
		}

		[Test]
		public function testAutoSizeWithComplexIcon():void
		{
			this.addComplexIcon();
			this.input.validate();

			Assert.assertStrictlyEquals("The width of the TextInput was not calculated correctly based on the complex icon width.",
				COMPLEX_ICON_WIDTH, this.input.width);
			Assert.assertStrictlyEquals("The height of the TextInput was not calculated correctly based on the complex icon height.",
				COMPLEX_ICON_HEIGHT, this.input.height);
			Assert.assertStrictlyEquals("The minWidth of the TextInput was not calculated correctly based on the complex icon minWidth.",
				COMPLEX_ICON_MIN_WIDTH, this.input.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the TextInput was not calculated correctly based on the complex icon minHeight.",
				COMPLEX_ICON_MIN_HEIGHT, this.input.minHeight);
		}

		[Test]
		public function testAutoSizeWithSimpleBackgroundPaddingAndGap():void
		{
			this.input.paddingTop = PADDING_TOP;
			this.input.paddingRight = PADDING_RIGHT;
			this.input.paddingBottom = PADDING_BOTTOM;
			this.input.paddingLeft = PADDING_LEFT;
			this.input.gap = GAP;
			this.addLargeSimpleBackground();
			this.input.validate();
			Assert.assertStrictlyEquals("The width of the TextInput was not calculated correctly with background skin, padding, and gap.",
				LARGE_BACKGROUND_WIDTH, this.input.width);
			Assert.assertStrictlyEquals("The height of the TextInput was not calculated correctly with background skin, padding, and gap.",
				LARGE_BACKGROUND_HEIGHT, this.input.height);
			Assert.assertStrictlyEquals("The minWidth of the TextInput was not calculated correctly with background skin, padding, and gap.",
				LARGE_BACKGROUND_WIDTH, this.input.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the TextInput was not calculated correctly with background skin, padding, and gap.",
				LARGE_BACKGROUND_HEIGHT, this.input.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/TextInputRestrictTests.as
================================================
package feathers.tests
{
	import org.flexunit.Assert;
	import feathers.utils.text.TextInputRestrict;

	public class TextInputRestrictTests
	{
		[Test]
		public function testIsCharacterAllowedWithNullRestrict():void
		{
			var restrict:TextInputRestrict = new TextInputRestrict();
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character with null restrict",
				restrict.isCharacterAllowed("a".charCodeAt(0)));
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character with null restrict",
				restrict.isCharacterAllowed("A".charCodeAt(0)));
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character with null restrict",
				restrict.isCharacterAllowed("0".charCodeAt(0)));
		}

		[Test]
		public function testIsCharacterAllowedWithSingleCharacter():void
		{
			var restrict:TextInputRestrict = new TextInputRestrict("a");
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character that is the only one allowed",
				restrict.isCharacterAllowed("a".charCodeAt(0)));
			Assert.assertFalse("TextInputRestrict: incorrectly allowed character that is not allowed",
				restrict.isCharacterAllowed("b".charCodeAt(0)));
		}

		[Test]
		public function testIsCharacterAllowedWithExcludedSingleCharacter():void
		{
			var restrict:TextInputRestrict = new TextInputRestrict("^a");
			Assert.assertFalse("TextInputRestrict: incorrectly allowed character that is excluded",
				restrict.isCharacterAllowed("a".charCodeAt(0)));
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character that is not excluded",
				restrict.isCharacterAllowed("b".charCodeAt(0)));
		}

		[Test]
		public function testIsCharacterAllowedWithRange():void
		{
			var restrict:TextInputRestrict = new TextInputRestrict("a-z");
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character in range a-z",
				restrict.isCharacterAllowed("a".charCodeAt(0)));
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character in range a-z",
				restrict.isCharacterAllowed("k".charCodeAt(0)));
			Assert.assertFalse("TextInputRestrict: incorrectly allowed character not in range a-z",
				restrict.isCharacterAllowed("A".charCodeAt(0)));
		}

		[Test]
		public function testIsCharacterAllowedWithExcludedRange():void
		{
			var restrict:TextInputRestrict = new TextInputRestrict("^a-z");
			Assert.assertFalse("TextInputRestrict: incorrectly allowed character in excluded range a-z",
				restrict.isCharacterAllowed("a".charCodeAt(0)));
			Assert.assertFalse("TextInputRestrict: incorrectly allowed character in excluded range a-z",
				restrict.isCharacterAllowed("k".charCodeAt(0)));
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character not in excluded range a-z",
				restrict.isCharacterAllowed("A".charCodeAt(0)));
		}

		[Test]
		public function testIsCharacterAllowedWithMultipleRanges():void
		{
			var restrict:TextInputRestrict = new TextInputRestrict("a-z0-9");
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character in range a-z",
				restrict.isCharacterAllowed("a".charCodeAt(0)));
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character in range a-z",
				restrict.isCharacterAllowed("k".charCodeAt(0)));
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character in range 0-9",
				restrict.isCharacterAllowed("3".charCodeAt(0)));
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character in range 0-9",
				restrict.isCharacterAllowed("9".charCodeAt(0)));
			Assert.assertFalse("TextInputRestrict: incorrectly allowed character not in range",
				restrict.isCharacterAllowed("Z".charCodeAt(0)));
		}

		[Test]
		public function testIsCharacterAllowedWithMultipleRangesAndOneExcluded():void
		{
			var restrict:TextInputRestrict = new TextInputRestrict("a-z^k-p");
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character in range a-z",
				restrict.isCharacterAllowed("a".charCodeAt(0)));
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character in range a-z",
				restrict.isCharacterAllowed("g".charCodeAt(0)));
			Assert.assertFalse("TextInputRestrict: incorrectly allowed character in excluded range k-p",
				restrict.isCharacterAllowed("k".charCodeAt(0)));
			Assert.assertFalse("TextInputRestrict: incorrectly allowed character in excluded range k-p",
				restrict.isCharacterAllowed("m".charCodeAt(0)));
			Assert.assertFalse("TextInputRestrict: incorrectly allowed character not in range",
				restrict.isCharacterAllowed("9".charCodeAt(0)));
			Assert.assertFalse("TextInputRestrict: incorrectly allowed character not in range a-z",
				restrict.isCharacterAllowed("Z".charCodeAt(0)));
		}

		//issue #1605
		[Test]
		public function testIsCharacterAllowedWithRangeAndEscapedCharacters():void
		{
			var restrict:TextInputRestrict = new TextInputRestrict("a-z\\-\\^\\\\");
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character in range a-z",
				restrict.isCharacterAllowed("a".charCodeAt(0)));
			Assert.assertTrue("TextInputRestrict: incorrectly excluded character in range a-z",
				restrict.isCharacterAllowed("g".charCodeAt(0)));
			Assert.assertTrue("TextInputRestrict: incorrectly excluded allowed escaped character",
				restrict.isCharacterAllowed("-".charCodeAt(0)));
			Assert.assertTrue("TextInputRestrict: incorrectly excluded allowed escaped character",
				restrict.isCharacterAllowed("^".charCodeAt(0)));
			Assert.assertTrue("TextInputRestrict: incorrectly excluded allowed escaped character",
				restrict.isCharacterAllowed("\\".charCodeAt(0)));
		}
	}
}


================================================
FILE: test/source/feathers/tests/TextInputTests.as
================================================
package feathers.tests
{
	import feathers.controls.TextInput;
	import feathers.tests.supportClasses.DisposeFlagQuad;

	import org.flexunit.Assert;

	public class TextInputTests
	{
		private var _input:TextInput;

		[Before]
		public function prepare():void
		{
			this._input = new TextInput();
			TestFeathers.starlingRoot.addChild(this._input);
		}

		[After]
		public function cleanup():void
		{
			this._input.removeFromParent(true);
			this._input = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testSkinsDisposed():void
		{
			var backgroundSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._input.backgroundSkin = backgroundSkin;
			var backgroundEnabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._input.backgroundEnabledSkin = backgroundEnabledSkin;
			var backgroundDisabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._input.backgroundDisabledSkin = backgroundDisabledSkin;
			var backgroundFocusedSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._input.backgroundFocusedSkin = backgroundFocusedSkin;
			this._input.validate();
			this._input.dispose();
			Assert.assertTrue("backgroundSkin not disposed when TextInput disposed.", backgroundSkin.isDisposed);
			Assert.assertTrue("backgroundEnabledSkin not disposed when TextInput disposed.", backgroundEnabledSkin.isDisposed);
			Assert.assertTrue("backgroundDisabledSkin not disposed when TextInput disposed.", backgroundDisabledSkin.isDisposed);
			Assert.assertTrue("backgroundFocusedSkin not disposed when TextInput disposed.", backgroundFocusedSkin.isDisposed);
		}

		[Test]
		public function testIconsDisposed():void
		{
			var defaultIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._input.defaultIcon = defaultIcon;
			var enabledIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._input.enabledIcon = enabledIcon;
			var focusedIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._input.focusedIcon = focusedIcon;
			var disabledIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._input.disabledIcon = disabledIcon;
			this._input.validate();
			this._input.dispose();
			Assert.assertTrue("defaultIcon not disposed when TextInput disposed.", defaultIcon.isDisposed);
			Assert.assertTrue("enabledIcon not disposed when TextInput disposed.", enabledIcon.isDisposed);
			Assert.assertTrue("disabledIcon not disposed when TextInput disposed.", disabledIcon.isDisposed);
			Assert.assertTrue("focusedIcon not disposed when TextInput disposed.", focusedIcon.isDisposed);
		}
	}
}

================================================
FILE: test/source/feathers/tests/TextureCacheTests.as
================================================
package feathers.tests
{
	import feathers.utils.textures.TextureCache;

	import org.flexunit.Assert;

	import starling.textures.Texture;

	public class TextureCacheTests
	{
		private static const KEY_ONE:String = "one";
		private static const KEY_TWO:String = "two";
		
		private var _cache:TextureCache;
		private var _texture1:Texture;
		private var _texture2:Texture;
		
		[Before]
		public function prepare():void
		{
			this._cache = new TextureCache();
			
			this._texture1 = Texture.fromColor(10, 10, 0xffff00ff);
			this._texture2 = Texture.fromColor(10, 10, 0xffffff00);
		}

		[After]
		public function cleanup():void
		{
			this._cache.dispose();
			this._cache = null;
			this._texture1.dispose();
			this._texture1 = null;
			this._texture2.dispose();
			this._texture2 = null;
		}

		[Test]
		public function testRetainCountAfterAddWithRetain():void
		{
			this._cache.addTexture(KEY_ONE, this._texture1, true);
			Assert.assertStrictlyEquals("The result of getRetainCount() on a TextureCache is incorrect after addTexture() with retain.",
				1, this._cache.getRetainCount(KEY_ONE));
		}

		[Test]
		public function testRetainCountAfterAddWithoutRetain():void
		{
			this._cache.addTexture(KEY_ONE, this._texture1, false);
			Assert.assertStrictlyEquals("The result of getRetainCount() on a TextureCache is incorrect after addTexture() without retain.",
				0, this._cache.getRetainCount(KEY_ONE));
		}

		[Test]
		public function testRetainCountAfterTwoRetains():void
		{
			this._cache.addTexture(KEY_ONE, this._texture1, true);
			this._cache.retainTexture(KEY_ONE);
			Assert.assertStrictlyEquals("The result of getRetainCount() on a TextureCache is incorrect after retaining twice.",
				2, this._cache.getRetainCount(KEY_ONE));
		}

		[Test]
		public function testRetainCountAfterRelease():void
		{
			this._cache.addTexture(KEY_ONE, this._texture1, true);
			this._cache.releaseTexture(KEY_ONE);
			Assert.assertStrictlyEquals("The result of getRetainCount() on a TextureCache is incorrect after releasing.",
				0, this._cache.getRetainCount(KEY_ONE));
		}

		[Test]
		public function testRetainCountAfterRemove():void
		{
			this._cache.addTexture(KEY_ONE, this._texture1, true);
			this._cache.removeTexture(KEY_ONE);
			Assert.assertStrictlyEquals("The result of getRetainCount() on a TextureCache is incorrect after removing a texture.",
				0, this._cache.getRetainCount(KEY_ONE));
		}

		[Test]
		public function testRetainCountAfterDispose():void
		{
			this._cache.addTexture(KEY_ONE, this._texture1, true);
			this._cache.dispose();
			Assert.assertStrictlyEquals("The result of getRetainCount() on a TextureCache is incorrect after disposing the cache.",
				0, this._cache.getRetainCount(KEY_ONE));
		}

		[Test]
		public function testRetainCountAfterAddTwoTextures():void
		{
			this._cache.addTexture(KEY_ONE, this._texture1, true);
			this._cache.addTexture(KEY_TWO, this._texture2, true);
			this._cache.retainTexture(KEY_ONE);
			this._cache.retainTexture(KEY_ONE);
			this._cache.retainTexture(KEY_TWO);
			Assert.assertStrictlyEquals("The result of getRetainCount() on a TextureCache is incorrect after adding two textures.",
				3, this._cache.getRetainCount(KEY_ONE));
			Assert.assertStrictlyEquals("The result of getRetainCount() on a TextureCache is incorrect after adding two textures.",
				2, this._cache.getRetainCount(KEY_TWO));
		}

		[Test]
		public function testHasTextureAfterRetain():void
		{
			this._cache.addTexture(KEY_ONE, this._texture1, true);
			Assert.assertTrue("The result of hasTexture() on a TextureCache is incorrect after retain.",
				this._cache.hasTexture(KEY_ONE));
		}

		[Test]
		public function testHasTextureAfterRelease():void
		{
			this._cache.addTexture(KEY_ONE, this._texture1, true);
			this._cache.releaseTexture(KEY_ONE);
			Assert.assertTrue("The result of hasTexture() on a TextureCache is incorrect after releasing.",
				this._cache.hasTexture(KEY_ONE));
		}

		[Test]
		public function testHasTextureAfterRemove():void
		{
			this._cache.addTexture(KEY_ONE, this._texture1, true);
			this._cache.removeTexture(KEY_ONE);
			Assert.assertFalse("The result of hasTexture() on a TextureCache is incorrect after removing a texture.",
				this._cache.hasTexture(KEY_ONE));
		}

		[Test]
		public function testHasTextureAfterDispose():void
		{
			this._cache.addTexture(KEY_ONE, this._texture1, true);
			this._cache.dispose();
			Assert.assertFalse("The result of hasTexture() on a TextureCache is incorrect after disposing the cache.",
				this._cache.hasTexture(KEY_ONE));
		}

		[Test]
		public function testHasTextureWithMaxUnretainedTexturesAfterAddWithoutRetain():void
		{
			this._cache.maxUnretainedTextures = 1;
			this._cache.addTexture(KEY_ONE, this._texture1, false);
			this._cache.addTexture(KEY_TWO, this._texture2, false);
			//both are added unretained, but the maximum is 1, one will be
			//removed automatically. since KEY_ONE was put into an unretained
			//state first, it's the one that will be removed.
			Assert.assertFalse("The result of hasTexture() on a TextureCache is maxUnretainedTextures is incorrect after releasing",
				this._cache.hasTexture(KEY_ONE));
			Assert.assertTrue("The result of hasTexture() on a TextureCache with maxUnretainedTextures is incorrect after releasing.",
				this._cache.hasTexture(KEY_TWO));
		}

		[Test]
		public function testHasTextureWithMaxUnretainedTexturesAfterRelease():void
		{
			this._cache.maxUnretainedTextures = 1;
			this._cache.addTexture(KEY_ONE, this._texture1, true);
			this._cache.addTexture(KEY_TWO, this._texture2, true);
			this._cache.releaseTexture(KEY_ONE);
			this._cache.releaseTexture(KEY_TWO);
			//KEY_ONE was released first, so it will be the one that is removed
			//automatically, while KEY_TWO will remain cached.
			Assert.assertFalse("The result of hasTexture() on a TextureCache is maxUnretainedTextures is incorrect after releasing",
				this._cache.hasTexture(KEY_ONE));
			Assert.assertTrue("The result of hasTexture() on a TextureCache with maxUnretainedTextures is incorrect after releasing.",
				this._cache.hasTexture(KEY_TWO));
		}

		[Test]
		public function testRemoveTextureThatWasNotAdded():void
		{
			//no errors should be thrown
			this._cache.removeTexture(KEY_ONE);
		}

		[Test(expects="flash.errors.IllegalOperationError")]
		public function testAddTextureAfterDispose():void
		{
			this._cache.dispose();
			this._cache.addTexture(KEY_ONE, this._texture1, true);
		}

		[Test(expects="flash.errors.IllegalOperationError")]
		public function testRetainTextureAfterDispose():void
		{
			//in the case where the cache is disposed before a display object
			//is disposed, it's better not to throw a strange runtime error.
			this._cache.addTexture(KEY_ONE, this._texture1, true);
			this._cache.dispose();
			this._cache.retainTexture(KEY_ONE);
		}

		[Test]
		public function testReleaseTextureAfterDispose():void
		{
			//in the case where the cache is disposed before a display object
			//is disposed, it's better not to throw a strange runtime error.
			this._cache.addTexture(KEY_ONE, this._texture1, true);
			this._cache.dispose();
			this._cache.releaseTexture(KEY_ONE);
		}

		[Test]
		public function testRemoveTextureAfterDispose():void
		{
			this._cache.addTexture(KEY_ONE, this._texture1, true);
			this._cache.dispose();
			//removal shouldn't throw any errors if the texture doesn't exist
			this._cache.removeTexture(KEY_ONE);
		}
	}
}


================================================
FILE: test/source/feathers/tests/TiledColumnsLayoutTests.as
================================================
package feathers.tests
{
	import feathers.layout.HorizontalAlign;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.TiledColumnsLayout;
	import feathers.layout.VerticalAlign;
	import feathers.layout.ViewPortBounds;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;

	public class TiledColumnsLayoutTests
	{
		private static const PADDING_TOP:Number = 6;
		private static const PADDING_RIGHT:Number = 8;
		private static const PADDING_BOTTOM:Number = 2;
		private static const PADDING_LEFT:Number = 10;
		private static const GAP:Number = 5;
		private static const CHILD1_WIDTH:Number = 200;
		private static const CHILD1_HEIGHT:Number = 100;
		private static const CHILD2_WIDTH:Number = 150;
		private static const CHILD2_HEIGHT:Number = 75;
		private static const CHILD3_WIDTH:Number = 75;
		private static const CHILD3_HEIGHT:Number = 50;

		private var _layout:TiledColumnsLayout;

		[Before]
		public function prepare():void
		{
			this._layout = new TiledColumnsLayout();
			this._layout.useVirtualLayout = false;
		}

		[After]
		public function cleanup():void
		{
			this._layout = null;
		}

		[Test]
		public function testLayoutResultWithNoItems():void
		{
			var items:Vector.<DisplayObject> = new <DisplayObject>[];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortWidth not equal to 0 with no items.", 0, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortHeight not equal to 0 with no items.", 0, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentWidth not equal to 0 with no items.", 0, result.contentWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentHeight not equal to 0 with no items.", 0, result.contentHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentX not equal to 0 with no items.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentY not equal to 0 with no items.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithNoItems():void
		{
			this._layout.useVirtualLayout = true;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(0, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort width not equal to 0 with no items.", 0, result.x);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort height not equal to 0 with no items.", 0, result.y);
		}

		[Test]
		public function testLayoutResultWithPaddingGapAndNoItems():void
		{
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			var items:Vector.<DisplayObject> = new <DisplayObject>[];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortWidth not equal to sum of left and right padding with no items.", PADDING_LEFT + PADDING_RIGHT, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortHeight not equal to sum of top and bottom padding with no items.", PADDING_TOP + PADDING_BOTTOM, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentWidth not equal to sum of left and right padding with no items.", PADDING_LEFT + PADDING_RIGHT, result.contentWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentHeight not equal to sum of top and bottom padding with no items.", PADDING_TOP + PADDING_BOTTOM, result.contentHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentX not equal to 0 with padding and no items.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentY not equal to 0 with padding and no items.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithPaddingGapAndNoItems():void
		{
			this._layout.useVirtualLayout = true;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(0, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort x not equal to sum of left and right padding with no items.", PADDING_LEFT + PADDING_RIGHT, result.x);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort y not equal to sum of top and bottom padding with no items.", PADDING_TOP + PADDING_BOTTOM, result.y);
		}

		[Test]
		public function testLayoutResultWithOneChildAndSquareTiles():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			var tileSize:Number = Math.max(CHILD1_WIDTH, CHILD1_HEIGHT);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortWidth not equal to max child dimension with square tiles and one item.", tileSize, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortHeight not equal to max child dimension with square tiles and one item.", tileSize, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentWidth not equal to max child dimension with square tiles and one item.", tileSize, result.contentWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentHeight not equal to max child dimension with square tiles and one item.", tileSize, result.contentHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentX not equal to 0 with one item and square tiles.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentY not equal to 0 with one item and square tiles.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithOneChildAndSquareTiles():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(1, bounds);
			var tileSize:Number = Math.max(CHILD1_WIDTH, CHILD1_HEIGHT);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort x not equal to max child dimension with square tiles and one item.", tileSize, result.x);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort y not equal to max child dimension with square tiles and one item.", tileSize, result.y);
		}

		[Test]
		public function testLayoutResultWithOneChildAndNotSquareTiles():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortWidth not equal to child width with non-square tiles and one item.", CHILD1_WIDTH, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortHeight not equal to child height with non-square tiles and one item.", CHILD1_HEIGHT, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentWidth not equal to child width with non-square tiles and one item.", CHILD1_WIDTH, result.contentWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentHeight not equal to child height with non-square tiles and one item.", CHILD1_HEIGHT, result.contentHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentX not equal to 0 with one item and non-square tiles.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentY not equal to 0 with one item and non-square tiles.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithOneChildAndNotSquareTiles():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useSquareTiles = false;
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort x not equal to child width with non-square tiles and one item.", CHILD1_WIDTH, result.x);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort y not equal to child height with non-square tiles and one item.", CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testLayoutResultWithPaddingGapAndOneChild():void
		{
			this._layout.useSquareTiles = false;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortWidth not equal to sum of left and right padding and width of child.", CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortHeight not equal to sum of top and bottom padding and height of child.", CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentWidth not equal to sum of left and right padding and width of child.", CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT, result.contentWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentHeight not equal to sum of top and bottom padding and height of child.", CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, result.contentHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentX not equal to 0 with one item and padding.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentY not equal to 0 with one item and padding.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithPaddingGapAndOneChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort x not equal to sum of left and right padding and width of child.", CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT, result.x);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort y not equal to sum of top and bottom padding and height of child.", CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, result.y);
		}

		[Test]
		public function testLayoutResultWithTwoChildren():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			var maxChildWidth:Number = Math.max(CHILD1_WIDTH, CHILD2_WIDTH);
			var maxChildHeight:Number = Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortWidth not equal to max width of items.", maxChildWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortHeight not equal to sum of tile heights.", 2 * maxChildHeight, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentWidth not equal to max width of items.", maxChildWidth, result.contentWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentHeight not equal to sum of tile heights.", 2 * maxChildHeight, result.contentHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentX not equal to 0 with padding and two items.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentY not equal to 0 with padding and two items.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithTwoChildren():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useSquareTiles = false;
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(2, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort x not equal to width of typical item.", CHILD1_WIDTH, result.x);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort y not equal to typical item height multiplied by the number of items.", 2 * CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testLayoutResultWithPaddingGapAndTwoChildren():void
		{
			this._layout.useSquareTiles = false;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			var maxChildWidth:Number = Math.max(CHILD1_WIDTH, CHILD2_WIDTH);
			var maxChildHeight:Number = Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortWidth not equal to max width of items plus left and right padding.", maxChildWidth + PADDING_LEFT + PADDING_RIGHT, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortHeight not equal to sum of tile heights plus top and bottom padding and gap.", 2 * maxChildHeight + PADDING_TOP + PADDING_BOTTOM + GAP, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentWidth not equal to sum of max width of items plus left and right padding.", maxChildWidth + PADDING_LEFT + PADDING_RIGHT, result.contentWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentHeight not equal to sum of tile heights plus top and bottom padding and gap.", 2 * maxChildHeight + PADDING_TOP + PADDING_BOTTOM + GAP, result.contentHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentX not equal to 0 with two items plus padding and gap.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentY not equal to 0 with two items plus padding and gap.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithPaddingGapAndTwoChildren():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useSquareTiles = false;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(2, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort x not equal to max width of items plus left and right padding.", CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT, result.x);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort y not equal to sum of tile heights plus top and bottom padding and gap.", 2 * CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM + GAP, result.y);
		}

		[Test]
		public function testLayoutResultWithRequestedRowCountLargerThanItemCount():void
		{
			this._layout.useSquareTiles = false;
			this._layout.requestedRowCount = 2;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortWidth not equal to max width of items with requestedRowCount larger than item count.", CHILD1_WIDTH, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortHeight not equal to tile height multiplied by requestedRowCount larger than item count.", 2 * CHILD1_HEIGHT, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentWidth not equal to max width of items with requestedRowCount larger than item count.", CHILD1_WIDTH, result.contentWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentHeight not equal to tile height multiplied by requestedRowCount larger than item count.", 2 * CHILD1_HEIGHT, result.contentHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentX not equal to 0 with requestedRowCount larger than item count.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentY not equal to 0 with requestedRowCount larger than item count.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithRequestedRowCountLargerThanItemCount():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			this._layout.requestedRowCount = 2;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort x not equal to max width of items with requestedRowCount larger than item count.", CHILD1_WIDTH, result.x);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort y not equal to tile height multiplied by requestedRowCount larger than item count.", 2 * CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testLayoutResultWithRequestedRowCountSmallerThanItemCount():void
		{
			this._layout.useSquareTiles = false;
			this._layout.requestedRowCount = 2;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var item3:Quad = new Quad(CHILD3_WIDTH, CHILD3_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			var maxChildWidth:Number = Math.max(CHILD1_WIDTH, CHILD2_WIDTH, CHILD3_WIDTH);
			var maxChildHeight:Number = Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT, CHILD3_HEIGHT);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortWidth not equal to max width of items multiplied by column count with requestedRowCount smaller than item count.", 2 * maxChildWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortHeight not equal to tile height multiplied by requestedRowCount smaller than item count.", 2 * maxChildHeight, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentWidth not equal to max width of items multiplied by column count with requestedRowCount smaller than item count.", 2 * maxChildWidth, result.contentWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentHeight not equal to tile height multiplied by requestedRowCount smaller than item count.", 2 * maxChildHeight, result.contentHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentX not equal to 0 with requestedRowCount smaller than item count.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentY not equal to 0 with requestedRowCount smaller than item count.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithRequestedRowCountSmallerThanItemCount():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			this._layout.requestedRowCount = 2;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(3, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort x not equal to max width of items multiplied by column count with requestedRowCount smaller than item count.", 2 * CHILD1_WIDTH, result.x);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort y not equal to tile height multiplied by requestedRowCount smaller than item count.", 2 * CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testLayoutResultWithExplicitWidthSmallerThanChild():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = CHILD1_WIDTH / 3;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortWidth not equal to explicitWidth when explicitWidth is smaller than item width.", bounds.explicitWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentWidth not equal to item width when explicitWidth is smaller than item width.", CHILD1_WIDTH, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithExplicitWidthSmallerThanChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = CHILD1_WIDTH / 3;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort x not equal to explicitWidth when explicitWidth is smaller than item width.", bounds.explicitWidth, result.x);
		}

		[Test]
		public function testLayoutResultWithExplicitWidthLargerThanChild():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 3 * CHILD1_WIDTH;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortWidth not equal to explicitWidth when explicitWidth is larger than item width.", bounds.explicitWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentWidth not equal to item width when explicitWidth is larger than item width.", CHILD1_WIDTH, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithExplicitWidthLargerThanChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 3 * CHILD1_WIDTH;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort x not equal to explicitWidth when explicitWidth is larger than item width.", bounds.explicitWidth, result.x);
		}

		[Test]
		public function testLayoutResultWithMaxWidthSmallerThanChild():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = CHILD1_WIDTH / 3;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortWidth not equal to maxWidth when maxWidth is smaller than item width.", bounds.maxWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentWidth not equal to item width when maxWidth is smaller than item width.", CHILD1_WIDTH, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxWidthSmallerThanChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = CHILD1_WIDTH / 3;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort x not equal to maxWidth when maxWidth is smaller than item width.", bounds.maxWidth, result.x);
		}

		[Test]
		public function testLayoutResultWithMinWidthLargerThanChild():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.minWidth = 3 * CHILD1_WIDTH;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortWidth not equal to minWidth when minWidth is larger than item width.", bounds.minWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentWidth not equal to item width when minWidth is smaller than item width.", CHILD1_WIDTH, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithMinWidthLargerThanChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.minWidth = 3 * CHILD1_WIDTH;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort x not equal to minWidth when minWidth is larger than item width.", bounds.minWidth, result.x);
		}

		[Test]
		public function testLayoutResultWithMaxWidthLargerThanChild():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			//needs to be enough to require more than one tile
			bounds.maxWidth = 3 * CHILD1_WIDTH;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortWidth not equal to item width when maxWidth is larger than item width.", CHILD1_WIDTH, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentWidth not equal to item width when maxWidth is larger than item width.", CHILD1_WIDTH, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxWidthLargerThanChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			var bounds:ViewPortBounds = new ViewPortBounds();
			//needs to be enough to require more than one tile
			bounds.maxWidth = 3 * CHILD1_WIDTH;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort x not equal to item width when maxWidth is larger than item width.", CHILD1_WIDTH, result.x);
		}

		[Test]
		public function testLayoutResultWithMaxHeightSmallerThanChild():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxHeight = CHILD1_HEIGHT / 3;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortHeight not equal to maxHeight when maxHeight is smaller than child height.", bounds.maxHeight, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentHeight not equal to item height when maxHeight is smaller than child height.", CHILD1_HEIGHT, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxHeightSmallerThanChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxHeight = CHILD1_HEIGHT / 3;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort y not equal to maxHeight when maxHeight is smaller than child height.", bounds.maxHeight, result.y);
		}

		[Test]
		public function testLayoutResultWithMaxHeightLargerThanChild():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			//needs to be enough to require more than one tile
			bounds.maxHeight = 3 * CHILD1_HEIGHT;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortHeight not equal to child height when maxHeight is larger than child height.", CHILD1_HEIGHT, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentHeight not equal to child height when maxHeight is larger than child height.", CHILD1_HEIGHT, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxHeightLargerThanChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			var bounds:ViewPortBounds = new ViewPortBounds();
			//needs to be enough to require more than one tile
			bounds.maxHeight = 3 * CHILD1_HEIGHT;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort y not equal to child height when maxHeight is larger than child height.", CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testLayoutResultWithMaxWidthLargerThanRequestedColumnCountLargerThanItemCount():void
		{
			this._layout.useSquareTiles = false;
			this._layout.requestedColumnCount = 2;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = 3 * CHILD1_WIDTH;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortWidth not correct when maxWidth larger than requestedColumnCount and requestedColumnCount larger than item count.", 2 * CHILD1_WIDTH, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentWidth not correct when maxWidth larger than requestedColumnCount and requestedColumnCount larger than item count.", 2 * CHILD1_WIDTH, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxWidthLargerThanRequestedColumnCountLargerThanItemCount():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			this._layout.requestedColumnCount = 2;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = 3 * CHILD1_WIDTH;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort x not correct when maxWidth larger than requestedColumnCount and requestedColumnCount larger than item count.", 2 * CHILD1_WIDTH, result.x);
		}

		[Test]
		public function testLayoutResultWithMaxHeightLargerThanRequestedRowCountLargerThanItemCount():void
		{
			this._layout.useSquareTiles = false;
			this._layout.requestedRowCount = 2;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxHeight = 3 * CHILD1_HEIGHT;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult viewPortHeight not correct when maxHeight larger than requestedRowCount and requestedRowCount larger than item count.", 2 * CHILD1_HEIGHT, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledColumnsLayout layout LayoutBoundsResult contentHeight not correct when maxHeight larger than requestedRowCount and requestedRowCount larger than item count.", 2 * CHILD1_HEIGHT, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxHeightLargerThanRequestedRowCountLargerThanItemCount():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			this._layout.requestedRowCount = 2;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxHeight = 3 * CHILD1_HEIGHT;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout measureViewPort y not correct when maxHeight larger than requestedRowCount and requestedRowCount larger than item count.", 2 * CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testItemXWithExplicitWidthRequestedColumnCountAndHorizontalAlignRight():void
		{
			this._layout.useSquareTiles = false;
			this._layout.requestedColumnCount = 2;
			this._layout.horizontalAlign = HorizontalAlign.RIGHT;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 3 * CHILD1_WIDTH;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout x position of first child not correct with explicit width larger than requestedColumnCount.", CHILD1_WIDTH, item1.x);
		}

		[Test]
		public function testItemYWithExplicitHeightRequestedRowCountAndVerticalAlignBottom():void
		{
			this._layout.useSquareTiles = false;
			this._layout.requestedRowCount = 2;
			this._layout.verticalAlign = VerticalAlign.BOTTOM;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitHeight = 3 * CHILD1_HEIGHT;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout y position of first child not correct with explicit height larger than requestedRowCount.", CHILD1_HEIGHT, item1.y);
		}

		[Test]
		public function testTileHeightWithDistributeHeights():void
		{
			this._layout.useSquareTiles = false;
			this._layout.distributeHeights = true;
			this._layout.tileVerticalAlign = VerticalAlign.JUSTIFY;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitHeight = 3 * CHILD1_HEIGHT;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout height of tile not correct with distributeHeights.",
				3 * CHILD1_HEIGHT, item1.height);
		}

		[Test]
		public function testTileHeightWithDistributeHeightsAndRequestedRowCount():void
		{
			var requestedRowCount:int = 3;
			this._layout.useSquareTiles = false;
			this._layout.distributeHeights = true;
			this._layout.requestedRowCount = requestedRowCount;
			this._layout.tileVerticalAlign = VerticalAlign.JUSTIFY;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitHeight = 2 * CHILD1_HEIGHT;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout height of tile not correct with distributeHeights and requestedRowCount.",
				2 * CHILD1_HEIGHT / requestedRowCount, item1.height);
		}

		[Test]
		public function testThreeTileHeightWithDistributeHeightsAndNoExplicitHeight():void
		{
			//distributeHeights should essentially do nothing in this case
			//because the view port height needs to be calculated
			this._layout.useSquareTiles = false;
			this._layout.distributeHeights = true;
			this._layout.tileVerticalAlign = VerticalAlign.JUSTIFY;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var item3:Quad = new Quad(CHILD3_WIDTH, CHILD3_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			this._layout.layout(items, bounds);
			var tileHeight:Number = Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT, CHILD3_HEIGHT);
			Assert.assertStrictlyEquals("TiledColumnsLayout height of first tile not correct with distributeHeights and no explicit height.",
				tileHeight, item1.height);
			Assert.assertStrictlyEquals("TiledColumnsLayout height of second tile not correct with distributeHeights and no explicit height.",
				tileHeight, item2.height);
			Assert.assertStrictlyEquals("TiledColumnsLayout height of third tile not correct with distributeHeights and no explicit height.",
				tileHeight, item3.height);
		}

		[Test]
		public function testTileWidthWithDistributeHeightsAndUseSquareTiles():void
		{
			this._layout.useSquareTiles = true;
			this._layout.distributeHeights = true;
			this._layout.tileHorizontalAlign = HorizontalAlign.JUSTIFY;
			this._layout.tileVerticalAlign = VerticalAlign.JUSTIFY;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitHeight = 3 * CHILD1_HEIGHT;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout width of tile not correct with distributeHeights and useSquareTiles.",
				3 * CHILD1_HEIGHT, item1.width);
		}

		[Test]
		public function testTwoTilesHeightWithDistributeHeights():void
		{
			this._layout.useSquareTiles = false;
			this._layout.distributeHeights = true;
			this._layout.tileVerticalAlign = VerticalAlign.JUSTIFY;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitHeight = 3 * CHILD1_HEIGHT;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout height of first tile not correct with distributeHeights.",
				3 * CHILD1_HEIGHT / 2, item1.height);
			Assert.assertStrictlyEquals("TiledColumnsLayout height of second tile not correct with distributeHeights.",
				3 * CHILD1_HEIGHT / 2, item2.height);
		}

		[Test]
		public function testTwoTilesHeightWithDistributeHeightsAndRequestedRowCount():void
		{
			this._layout.useSquareTiles = false;
			this._layout.distributeHeights = true;
			this._layout.requestedRowCount = 2;
			this._layout.tileVerticalAlign = VerticalAlign.JUSTIFY;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitHeight = CHILD1_HEIGHT / 2;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledColumnsLayout height of first tile not correct with distributeHeights and requestedRowCount.",
				CHILD1_HEIGHT / 4, item1.height);
			Assert.assertStrictlyEquals("TiledColumnsLayout height of second tile not correct with distributeHeights and requestedRowCount.",
				CHILD1_HEIGHT / 4, item2.height);
		}
	}
}


================================================
FILE: test/source/feathers/tests/TiledRowsLayoutTests.as
================================================
package feathers.tests
{
	import feathers.layout.HorizontalAlign;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.TiledRowsLayout;
	import feathers.layout.VerticalAlign;
	import feathers.layout.ViewPortBounds;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;

	public class TiledRowsLayoutTests
	{
		private static const PADDING_TOP:Number = 6;
		private static const PADDING_RIGHT:Number = 8;
		private static const PADDING_BOTTOM:Number = 2;
		private static const PADDING_LEFT:Number = 10;
		private static const GAP:Number = 5;
		private static const CHILD1_WIDTH:Number = 200;
		private static const CHILD1_HEIGHT:Number = 100;
		private static const CHILD2_WIDTH:Number = 150;
		private static const CHILD2_HEIGHT:Number = 75;
		private static const CHILD3_WIDTH:Number = 75;
		private static const CHILD3_HEIGHT:Number = 50;
		
		private var _layout:TiledRowsLayout;

		[Before]
		public function prepare():void
		{
			this._layout = new TiledRowsLayout();
			this._layout.useVirtualLayout = false;
		}

		[After]
		public function cleanup():void
		{
			this._layout = null;
		}

		[Test]
		public function testLayoutResultWithNoItems():void
		{
			var items:Vector.<DisplayObject> = new <DisplayObject>[];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortWidth not equal to 0 with no items.", 0, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortHeight not equal to 0 with no items.", 0, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentWidth not equal to 0 with no items.", 0, result.contentWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentHeight not equal to 0 with no items.", 0, result.contentHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentX not equal to 0 with no items.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentY not equal to 0 with no items.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithNoItems():void
		{
			this._layout.useVirtualLayout = true;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(0, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort width not equal to 0 with no items.", 0, result.x);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort height not equal to 0 with no items.", 0, result.y);
		}

		[Test]
		public function testLayoutResultWithPaddingGapAndNoItems():void
		{
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			var items:Vector.<DisplayObject> = new <DisplayObject>[];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortWidth not equal to sum of left and right padding with no items.", PADDING_LEFT + PADDING_RIGHT, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortHeight not equal to sum of top and bottom padding with no items.", PADDING_TOP + PADDING_BOTTOM, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentWidth not equal to sum of left and right padding with no items.", PADDING_LEFT + PADDING_RIGHT, result.contentWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentHeight not equal to sum of top and bottom padding with no items.", PADDING_TOP + PADDING_BOTTOM, result.contentHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentX not equal to 0 with padding and no items.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentY not equal to 0 with padding and no items.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithPaddingGapAndNoItems():void
		{
			this._layout.useVirtualLayout = true;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(0, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort x not equal to sum of left and right padding with no items.", PADDING_LEFT + PADDING_RIGHT, result.x);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort y not equal to sum of top and bottom padding with no items.", PADDING_TOP + PADDING_BOTTOM, result.y);
		}

		[Test]
		public function testLayoutResultWithOneChildAndSquareTiles():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			var tileSize:Number = Math.max(CHILD1_WIDTH, CHILD1_HEIGHT);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortWidth not equal to max child dimension with square tiles and one item.", tileSize, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortHeight not equal to max child dimension with square tiles and one item.", tileSize, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentWidth not equal to max child dimension with square tiles and one item.", tileSize, result.contentWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentHeight not equal to max child dimension with square tiles and one item.", tileSize, result.contentHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentX not equal to 0 with one item and square tiles.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentY not equal to 0 with one item and square tiles.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithOneChildAndSquareTiles():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(1, bounds);
			var tileSize:Number = Math.max(CHILD1_WIDTH, CHILD1_HEIGHT);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort x not equal to max child dimension with square tiles and one item.", tileSize, result.x);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort y not equal to max child dimension with square tiles and one item.", tileSize, result.y);
		}

		[Test]
		public function testLayoutResultWithOneChildAndNotSquareTiles():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortWidth not equal to child width with non-square tiles and one item.", CHILD1_WIDTH, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortHeight not equal to child height with non-square tiles and one item.", CHILD1_HEIGHT, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentWidth not equal to child width with non-square tiles and one item.", CHILD1_WIDTH, result.contentWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentHeight not equal to child height with non-square tiles and one item.", CHILD1_HEIGHT, result.contentHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentX not equal to 0 with one item and non-square tiles.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentY not equal to 0 with one item and non-square tiles.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithOneChildAndNotSquareTiles():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useSquareTiles = false;
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort x not equal to child width with non-square tiles and one item.", CHILD1_WIDTH, result.x);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort y not equal to child height with non-square tiles and one item.", CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testLayoutResultWithPaddingGapAndOneChild():void
		{
			this._layout.useSquareTiles = false;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortWidth not equal to sum of left and right padding and width of child.", CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortHeight not equal to sum of top and bottom padding and height of child.", CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentWidth not equal to sum of left and right padding and width of child.", CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT, result.contentWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentHeight not equal to sum of top and bottom padding and height of child.", CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, result.contentHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentX not equal to 0 with one item and padding.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentY not equal to 0 with one item and padding.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithPaddingGapAndOneChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort x not equal to sum of left and right padding and width of child.", CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT, result.x);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort y not equal to sum of top and bottom padding and height of child.", CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, result.y);
		}

		[Test]
		public function testLayoutResultWithTwoChildren():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			var maxChildWidth:Number = Math.max(CHILD1_WIDTH, CHILD2_WIDTH);
			var maxChildHeight:Number = Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortWidth not equal to sum of tile widths.", 2 * maxChildWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortHeight not equal to max height of items.", maxChildHeight, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentWidth not equal to sum of tile widths.", 2 * maxChildWidth, result.contentWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentHeight not equal to max height of items.", maxChildHeight, result.contentHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentX not equal to 0 with padding and two items.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentY not equal to 0 with padding and two items.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithTwoChildren():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useSquareTiles = false;
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(2, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort x not equal to typical item width multiplied by the number of items.", 2 * CHILD1_WIDTH, result.x);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort y not equal to height of typical item.", CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testLayoutResultWithPaddingGapAndTwoChildren():void
		{
			this._layout.useSquareTiles = false;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			var maxChildWidth:Number = Math.max(CHILD1_WIDTH, CHILD2_WIDTH);
			var maxChildHeight:Number = Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortWidth not equal to sum of tile widths plus left and right padding and gap.", 2 * maxChildWidth + PADDING_LEFT + PADDING_RIGHT + GAP, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortHeight not equal to max height of items plus top and bottom padding.", maxChildHeight + PADDING_TOP + PADDING_BOTTOM, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentWidth not equal to sum of tile widths plus left and right padding and gap.", 2 * maxChildWidth + PADDING_LEFT + PADDING_RIGHT + GAP, result.contentWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentHeight not equal to max height of items plus top and bottom padding.", maxChildHeight + PADDING_TOP + PADDING_BOTTOM, result.contentHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentX not equal to 0 with two items plus padding and gap.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentY not equal to 0 with two items plus padding and gap.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithPaddingGapAndTwoChildren():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useSquareTiles = false;
			this._layout.paddingTop = PADDING_TOP;
			this._layout.paddingRight = PADDING_RIGHT;
			this._layout.paddingBottom = PADDING_BOTTOM;
			this._layout.paddingLeft = PADDING_LEFT;
			this._layout.gap = GAP;
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(2, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort x not equal to sum of tile widths plus left and right padding and gap.", 2 * CHILD1_WIDTH + PADDING_LEFT + PADDING_RIGHT + GAP, result.x);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort y not equal to max height of items plus top and bottom padding.", CHILD1_HEIGHT + PADDING_TOP + PADDING_BOTTOM, result.y);
		}

		[Test]
		public function testLayoutResultWithRequestedColumnCountLargerThanItemCount():void
		{
			this._layout.useSquareTiles = false;
			this._layout.requestedColumnCount = 2;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortWidth not equal to tile width multiplied by requestedColumnCount larger than item count.", 2 * CHILD1_WIDTH, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortHeight not equal to max height of items with requestedColumnCount larger than item count.", CHILD1_HEIGHT, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentWidth not equal to tile width multiplied by requestedColumnCount larger than item count.", 2 * CHILD1_WIDTH, result.contentWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentHeight not equal to max height of items with requestedColumnCount larger than item count.", CHILD1_HEIGHT, result.contentHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentX not equal to 0 with requestedColumnCount larger than item count.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentY not equal to 0 with requestedColumnCount larger than item count.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithRequestedColumnCountLargerThanItemCount():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			this._layout.requestedColumnCount = 2;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort x not equal to tile width multiplied by requestedColumnCount larger than item count.", 2 * CHILD1_WIDTH, result.x);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort y not equal to max height of items with requestedColumnCount larger than item count.", CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testLayoutResultWithRequestedColumnCountSmallerThanItemCount():void
		{
			this._layout.useSquareTiles = false;
			this._layout.requestedColumnCount = 2;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var item3:Quad = new Quad(CHILD3_WIDTH, CHILD3_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			var maxChildWidth:Number = Math.max(CHILD1_WIDTH, CHILD2_WIDTH, CHILD3_WIDTH);
			var maxChildHeight:Number = Math.max(CHILD1_HEIGHT, CHILD2_HEIGHT, CHILD3_HEIGHT);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortWidth not equal to tile width multiplied by requestedColumnCount smaller than item count.", 2 * maxChildWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortHeight not equal to max height of items multiplied by row count with requestedColumnCount smaller than item count.", 2 * maxChildHeight, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentWidth not equal to tile width multiplied by requestedColumnCount smaller than item count.", 2 * maxChildWidth, result.contentWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentHeight not equal to max height of items  multiplied by row countwith requestedColumnCount smaller than item count.", 2 * maxChildHeight, result.contentHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentX not equal to 0 with requestedRowCount smaller than item count.", 0, result.contentX);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentY not equal to 0 with requestedRowCount smaller than item count.", 0, result.contentY);
		}

		[Test]
		public function testMeasureViewPortResultWithRequestedColumnCountSmallerThanItemCount():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			this._layout.requestedColumnCount = 2;
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:Point = this._layout.measureViewPort(3, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort x not equal to tile width multiplied by requestedColumnCount smaller than item count.", 2 * CHILD1_WIDTH, result.x);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort y not equal to max height of items with requestedColumnCount smaller than item count.", 2 * CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testLayoutResultWithExplicitWidthSmallerThanChild():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = CHILD1_WIDTH / 3;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortWidth not equal to explicitWidth when explicitWidth is smaller than item width.", bounds.explicitWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentWidth not equal to item width when explicitWidth is smaller than item width.", CHILD1_WIDTH, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithExplicitWidthSmallerThanChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = CHILD1_WIDTH / 3;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort x not equal to explicitWidth when explicitWidth is smaller than item width.", bounds.explicitWidth, result.x);
		}

		[Test]
		public function testLayoutResultWithExplicitWidthLargerThanChild():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 3 * CHILD1_WIDTH;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortWidth not equal to explicitWidth when explicitWidth is larger than item width.", bounds.explicitWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentWidth not equal to item width when explicitWidth is larger than item width.", CHILD1_WIDTH, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithExplicitWidthLargerThanChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 3 * CHILD1_WIDTH;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort x not equal to explicitWidth when explicitWidth is larger than item width.", bounds.explicitWidth, result.x);
		}

		[Test]
		public function testLayoutResultWithMaxWidthSmallerThanChild():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = CHILD1_WIDTH / 3;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortWidth not equal to maxWidth when maxWidth is smaller than item width.", bounds.maxWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentWidth not equal to item width when maxWidth is smaller than item width.", CHILD1_WIDTH, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxWidthSmallerThanChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = CHILD1_WIDTH / 3;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort x not equal to maxWidth when maxWidth is smaller than item width.", bounds.maxWidth, result.x);
		}

		[Test]
		public function testLayoutResultWithMinWidthLargerThanChild():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.minWidth = 3 * CHILD1_WIDTH;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortWidth not equal to minWidth when minWidth is larger than item width.", bounds.minWidth, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentWidth not equal to item width when minWidth is larger than item width.", CHILD1_WIDTH, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithMinWidthLargerThanChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.minWidth = 3 * CHILD1_WIDTH;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort x not equal to minWidth when minWidth is larger than item width.", bounds.minWidth, result.x);
		}

		[Test]
		public function testLayoutResultWithMaxWidthLargerThanChild():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			//needs to be enough to require more than one tile
			bounds.maxWidth = 3 * CHILD1_WIDTH;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortWidth not equal to item width when maxWidth is larger than item width.", CHILD1_WIDTH, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentWidth not equal to item width when maxWidth is larger than item width.", CHILD1_WIDTH, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxWidthLargerThanChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			var bounds:ViewPortBounds = new ViewPortBounds();
			//needs to be enough to require more than one tile
			bounds.maxWidth = 3 * CHILD1_WIDTH;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort x not equal to item width when maxWidth is larger than item width.", CHILD1_WIDTH, result.x);
		}

		[Test]
		public function testLayoutResultWithMaxHeightSmallerThanChild():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxHeight = CHILD1_HEIGHT / 3;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortHeight not equal to maxHeight when maxHeight is smaller than child height.", bounds.maxHeight, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentHeight not equal to item height when maxHeight is smaller than child height.", CHILD1_HEIGHT, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxHeightSmallerThanChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxHeight = CHILD1_HEIGHT / 3;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort y not equal to maxHeight when maxHeight is smaller than child height.", bounds.maxHeight, result.y);
		}

		[Test]
		public function testLayoutResultWithMaxHeightLargerThanChild():void
		{
			this._layout.useSquareTiles = false;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			//needs to be enough to require more than one tile
			bounds.maxHeight = 3 * CHILD1_HEIGHT;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortHeight not equal to child height when maxHeight is larger than child height.", CHILD1_HEIGHT, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentHeight not equal to child height when maxHeight is larger than child height.", CHILD1_HEIGHT, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxHeightLargerThanChild():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			var bounds:ViewPortBounds = new ViewPortBounds();
			//needs to be enough to require more than one tile
			bounds.maxHeight = 3 * CHILD1_HEIGHT;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort y not equal to child height when maxHeight is larger than child height.", CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testLayoutResultWithMaxWidthLargerThanRequestedColumnCountLargerThanItemCount():void
		{
			this._layout.useSquareTiles = false;
			this._layout.requestedColumnCount = 2;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = 3 * CHILD1_WIDTH;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortWidth not correct when maxWidth larger than requestedColumnCount and requestedColumnCount larger than item count.", 2 * CHILD1_WIDTH, result.viewPortWidth);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentWidth not correct when maxWidth larger than requestedColumnCount and requestedColumnCount larger than item count.", 2 * CHILD1_WIDTH, result.contentWidth);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxWidthLargerThanRequestedColumnCountLargerThanItemCount():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			this._layout.requestedColumnCount = 2;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = 3 * CHILD1_WIDTH;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort x not correct when maxWidth larger than requestedColumnCount and requestedColumnCount larger than item count.", 2 * CHILD1_WIDTH, result.x);
		}

		[Test]
		public function testLayoutResultWithMaxHeightLargerThanRequestedRowCountLargerThanItemCount():void
		{
			this._layout.useSquareTiles = false;
			this._layout.requestedRowCount = 2;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxHeight = 3 * CHILD1_HEIGHT;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult viewPortHeight not correct when maxHeight larger than requestedRowCount and requestedRowCount larger than item count.", 2 * CHILD1_HEIGHT, result.viewPortHeight);
			Assert.assertStrictlyEquals("TiledRowsLayout layout LayoutBoundsResult contentHeight not correct when maxHeight larger than requestedRowCount and requestedRowCount larger than item count.", 2 * CHILD1_HEIGHT, result.contentHeight);
		}

		[Test]
		public function testMeasureViewPortResultWithMaxHeightLargerThanRequestedRowCountLargerThanItemCount():void
		{
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			this._layout.useVirtualLayout = true;
			this._layout.typicalItem = item1;
			this._layout.useSquareTiles = false;
			this._layout.requestedRowCount = 2;
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxHeight = 3 * CHILD1_HEIGHT;
			var result:Point = this._layout.measureViewPort(1, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout measureViewPort y not correct when maxHeight larger than requestedRowCount and requestedRowCount larger than item count.", 2 * CHILD1_HEIGHT, result.y);
		}

		[Test]
		public function testItemXWithExplicitWidthRequestedColumnCountAndHorizontalAlignRight():void
		{
			this._layout.useSquareTiles = false;
			this._layout.requestedColumnCount = 2;
			this._layout.horizontalAlign = HorizontalAlign.RIGHT;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 3 * CHILD1_WIDTH;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout x position of first child not correct with explicit width larger than requestedColumnCount.", CHILD1_WIDTH, item1.x);
		}

		[Test]
		public function testItemYWithExplicitHeightRequestedRowCountAndVerticalAlignBottom():void
		{
			this._layout.useSquareTiles = false;
			this._layout.requestedRowCount = 2;
			this._layout.verticalAlign = VerticalAlign.BOTTOM;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitHeight = 3 * CHILD1_HEIGHT;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout y position of first child not correct with explicit height larger than requestedRowCount.", CHILD1_HEIGHT, item1.y);
		}

		[Test]
		public function testTileWidthWithDistributeWidths():void
		{
			this._layout.useSquareTiles = false;
			this._layout.distributeWidths = true;
			this._layout.tileHorizontalAlign = HorizontalAlign.JUSTIFY;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 3 * CHILD1_WIDTH;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout width of tile not correct with distributeWidths.",
				3 * CHILD1_WIDTH, item1.width);
		}

		[Test]
		public function testTileWidthWithDistributeWidthsAndRequestedColumnCount():void
		{
			var requestedColumnCount:int = 3;
			this._layout.useSquareTiles = false;
			this._layout.distributeWidths = true;
			this._layout.requestedColumnCount = requestedColumnCount;
			this._layout.tileHorizontalAlign = HorizontalAlign.JUSTIFY;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 2 * CHILD1_WIDTH;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout width of tile not correct with distributeWidths and requestedColumnCount.",
				2 * CHILD1_WIDTH / requestedColumnCount, item1.width);
		}

		[Test]
		public function testThreeTileWidthWithDistributeWidthsAndNoExplicitWidth():void
		{
			//distributeWidths should essentially do nothing in this case
			//because the view port width needs to be calculated
			this._layout.useSquareTiles = false;
			this._layout.distributeWidths = true;
			this._layout.tileHorizontalAlign = HorizontalAlign.JUSTIFY;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var item3:Quad = new Quad(CHILD3_WIDTH, CHILD3_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			this._layout.layout(items, bounds);
			var tileWidth:Number = Math.max(CHILD1_WIDTH, CHILD2_WIDTH, CHILD3_WIDTH);
			Assert.assertStrictlyEquals("TiledRowsLayout width of first tile not correct with distributeWidths and no explicit width.",
				tileWidth, item1.width);
			Assert.assertStrictlyEquals("TiledRowsLayout width of second tile not correct with distributeWidths and no explicit width.",
				tileWidth, item2.width);
			Assert.assertStrictlyEquals("TiledRowsLayout width of third tile not correct with distributeWidths and no explicit width.",
				tileWidth, item3.width);
		}

		[Test]
		public function testTileHeightWithDistributeWidthsAndUseSquareTiles():void
		{
			this._layout.useSquareTiles = true;
			this._layout.distributeWidths = true;
			this._layout.tileHorizontalAlign = HorizontalAlign.JUSTIFY;
			this._layout.tileVerticalAlign = VerticalAlign.JUSTIFY;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 3 * CHILD1_WIDTH;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout height of tile not correct with distributeWidths and useSquareTiles.",
				3 * CHILD1_WIDTH, item1.height);
		}

		[Test]
		public function testTwoTilesWidthWithDistributeWidths():void
		{
			this._layout.useSquareTiles = false;
			this._layout.distributeWidths = true;
			this._layout.tileHorizontalAlign = HorizontalAlign.JUSTIFY;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 3 * CHILD1_WIDTH;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout width of first tile not correct with distributeWidths.",
				3 * CHILD1_WIDTH / 2, item1.width);
			Assert.assertStrictlyEquals("TiledRowsLayout width of second tile not correct with distributeWidths.",
				3 * CHILD1_WIDTH / 2, item2.width);
		}

		[Test]
		public function testTwoTilesWidthWithDistributeWidthsAndRequestedColumnCount():void
		{
			this._layout.useSquareTiles = false;
			this._layout.distributeWidths = true;
			this._layout.requestedColumnCount = 2;
			this._layout.tileHorizontalAlign = HorizontalAlign.JUSTIFY;
			var item1:Quad = new Quad(CHILD1_WIDTH, CHILD1_HEIGHT, 0xff00ff);
			var item2:Quad = new Quad(CHILD2_WIDTH, CHILD2_HEIGHT, 0xff00ff);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = CHILD1_WIDTH / 2;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("TiledRowsLayout width of first tile not correct with distributeWidths and requestedColumnCount.",
				CHILD1_WIDTH / 4, item1.width);
			Assert.assertStrictlyEquals("TiledRowsLayout width of second tile not correct with ddistributeWidths and requestedColumnCount.",
				CHILD1_WIDTH / 4, item2.width);
		}
	}
}


================================================
FILE: test/source/feathers/tests/TimeLabelTests.as
================================================
package feathers.tests
{
	import feathers.media.MediaTimeMode;
	import feathers.media.TimeLabel;
	import feathers.tests.supportClasses.CustomMediaPlayer;

	import org.flexunit.Assert;

	public class TimeLabelTests
	{
		private static const CURRENT_TIME:int = 3737;
		private static const TOTAL_TIME:int = 5254;
		
		private var _label:TimeLabel;
		private var _mediaPlayer:CustomMediaPlayer;

		[Before]
		public function prepare():void
		{
			this._mediaPlayer = new CustomMediaPlayer(TOTAL_TIME);
			
			this._label = new TimeLabel();
			this._label.mediaPlayer = this._mediaPlayer;
			TestFeathers.starlingRoot.addChild(this._label);
			this._label.validate();
		}

		[After]
		public function cleanup():void
		{
			this._label.removeFromParent(true);
			this._label = null;
			
			this._mediaPlayer.removeEventListeners();
			this._mediaPlayer = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		/**
		 * Issue #1325
		 */
		public function testTotalTimeText():void
		{
			this._label.displayMode = MediaTimeMode.TOTAL_TIME;
			this._label.validate();
			Assert.assertStrictlyEquals("TimeLabel total time not displayed correctly", "1:27:34", this._label.text);
		}

		[Test]
		public function testCurrentTimeText():void
		{
			this._label.displayMode = MediaTimeMode.CURRENT_TIME;
			this._mediaPlayer.seek(CURRENT_TIME);
			this._label.validate();
			Assert.assertStrictlyEquals("TimeLabel total time not displayed correctly", "1:02:17", this._label.text);
		}

		[Test]
		public function testCurrentTimeAndTotalTimeText():void
		{
			this._label.displayMode = MediaTimeMode.CURRENT_AND_TOTAL_TIMES;
			this._mediaPlayer.seek(CURRENT_TIME);
			this._label.validate();
			Assert.assertStrictlyEquals("TimeLabel total time not displayed correctly", "1:02:17 / 1:27:34", this._label.text);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ToggleButtonFocusTests.as
================================================
package feathers.tests
{
	import feathers.controls.ToggleButton;
	import feathers.core.FocusManager;

	import flash.ui.Keyboard;

	import org.flexunit.Assert;

	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.KeyboardEvent;

	public class ToggleButtonFocusTests
	{
		private var _target:ToggleButton;

		[Before]
		public function prepare():void
		{
			this._target = new ToggleButton();
			this._target.defaultSkin = new Quad(200, 200, 0xff00ff);
			TestFeathers.starlingRoot.addChild(this._target);

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, true);
		}

		[After]
		public function cleanup():void
		{
			this._target.removeFromParent(true);
			this._target = null;

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
			Assert.assertFalse("FocusManager not disabled on cleanup.", FocusManager.isEnabledForStage(TestFeathers.starlingRoot.stage));
		}

		[Test]
		public function testIgnoreKeyAfterFocusOut():void
		{
			this._target.isSelected = false;
			FocusManager.focus = this._target;
			FocusManager.focus = null;

			var hasChanged:Boolean = false;
			this._target.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched", hasChanged);
			Assert.assertFalse("isSelected was incorrectly changed to true after key to select when not in focus", this._target.isSelected);
		}

		[Test]
		public function testChangeEvent():void
		{
			this._target.isSelected = false;
			FocusManager.focus = this._target;

			var hasChanged:Boolean = false;
			this._target.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("isSelected was not changed to true after key to select", this._target.isSelected);
		}

		[Test]
		public function testDisabled():void
		{
			this._target.isSelected = false;
			this._target.isEnabled = false;
			this._target.validate();
			FocusManager.focus = this._target;

			var hasChanged:Boolean = false;
			this._target.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched when disabled", hasChanged);
			Assert.assertFalse("isSelected was incorrectly changed to true after key to select when disabled", this._target.isSelected);
		}

		[Test]
		public function testCancelKeyBeforeChangeEvent():void
		{
			this._target.isSelected = false;
			FocusManager.focus = this._target;

			var hasChanged:Boolean = false;
			this._target.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.ESCAPE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.ESCAPE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched after cancel key", hasChanged);
			Assert.assertFalse("isSelected was incorrectly changed to true after cancel key", this._target.isSelected);
		}

		[Test]
		public function testDeselect():void
		{
			this._target.isSelected = true;
			this._target.validate();
			FocusManager.focus = this._target;

			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, 0, Keyboard.SPACE));
			this._target.stage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, 0, Keyboard.SPACE));
			Assert.assertFalse("isSelected was not changed to false when deselected with keyboard", this._target.isSelected);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ToggleButtonInternalStateTests.as
================================================
package feathers.tests
{
	import feathers.controls.ButtonState;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class ToggleButtonInternalStateTests
	{
		private var _button:ToggleButtonWithInternalState;

		[Before]
		public function prepare():void
		{
			this._button = new ToggleButtonWithInternalState();
			TestFeathers.starlingRoot.addChild(this._button);
		}

		[After]
		public function cleanup():void
		{
			this._button.removeFromParent(true);
			this._button = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testGetSkinForStateWithoutSetSkinForState():void
		{
			Assert.assertNull("ToggleButton getSkinForState(ButtonState.UP) must be null when setSkinForState() is not called", this._button.getSkinForState(ButtonState.UP));
			Assert.assertNull("ToggleButton getSkinForState(ButtonState.HOVER) must be null when setSkinForState() is not called", this._button.getSkinForState(ButtonState.HOVER));
			Assert.assertNull("ToggleButton getSkinForState(ButtonState.DOWN) must be null when setSkinForState() is not called", this._button.getSkinForState(ButtonState.DOWN));
			Assert.assertNull("ToggleButton getSkinForState(ButtonState.DISABLED) must be null when setSkinForState() is not called", this._button.getSkinForState(ButtonState.DISABLED));
			Assert.assertNull("ToggleButton getSkinForState(ButtonState.UP_AND_SELECTED) must be null when setSkinForState() is not called", this._button.getSkinForState(ButtonState.UP_AND_SELECTED));
			Assert.assertNull("ToggleButton getSkinForState(ButtonState.HOVER_AND_SELECTED) must be null when setSkinForState() is not called", this._button.getSkinForState(ButtonState.HOVER_AND_SELECTED));
			Assert.assertNull("ToggleButton getSkinForState(ButtonState.DOWN_AND_SELECTED) must be null when setSkinForState() is not called", this._button.getSkinForState(ButtonState.DOWN_AND_SELECTED));
			Assert.assertNull("ToggleButton getSkinForState(ButtonState.DISABLED_AND_SELECTED) must be null when setSkinForState() is not called", this._button.getSkinForState(ButtonState.DISABLED_AND_SELECTED));
		}

		[Test]
		public function testGetSkinForState():void
		{
			var defaultSkin:Quad = new Quad(200, 200);
			this._button.defaultSkin = defaultSkin;

			var upSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.UP, upSkin);

			var hoverSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.HOVER, hoverSkin);

			var downSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.DOWN, downSkin);

			var disabledSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.DISABLED, disabledSkin);

			var defaultSelectedSkin:Quad = new Quad(200, 200);
			this._button.defaultSkin = defaultSelectedSkin;

			var selectedUpSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.UP_AND_SELECTED, selectedUpSkin);

			var selectedHoverSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.HOVER_AND_SELECTED, selectedHoverSkin);

			var selectedDownSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.DOWN_AND_SELECTED, selectedDownSkin);

			var selectedDisabledSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.DISABLED_AND_SELECTED, selectedDisabledSkin);

			Assert.assertStrictlyEquals("ToggleButton getSkinForState(ButtonState.UP) does not match value passed to setSkinForState()", upSkin, this._button.getSkinForState(ButtonState.UP));
			Assert.assertStrictlyEquals("ToggleButton getSkinForState(ButtonState.HOVER) does not match value passed to setSkinForState()", hoverSkin, this._button.getSkinForState(ButtonState.HOVER));
			Assert.assertStrictlyEquals("ToggleButton getSkinForState(ButtonState.DOWN) does not match value passed to setSkinForState()", downSkin, this._button.getSkinForState(ButtonState.DOWN));
			Assert.assertStrictlyEquals("ToggleButton getSkinForState(ButtonState.DISABLED) does not match value passed to setSkinForState()", disabledSkin, this._button.getSkinForState(ButtonState.DISABLED));
			Assert.assertStrictlyEquals("ToggleButton getSkinForState(ButtonState.UP_AND_SELECTED) does not match value passed to setSkinForState()", selectedUpSkin, this._button.getSkinForState(ButtonState.UP_AND_SELECTED));
			Assert.assertStrictlyEquals("ToggleButton getSkinForState(ButtonState.HOVER_AND_SELECTED) does not match value passed to setSkinForState()", selectedHoverSkin, this._button.getSkinForState(ButtonState.HOVER_AND_SELECTED));
			Assert.assertStrictlyEquals("ToggleButton getSkinForState(ButtonState.DOWN_AND_SELECTED) does not match value passed to setSkinForState()", selectedDownSkin, this._button.getSkinForState(ButtonState.DOWN_AND_SELECTED));
			Assert.assertStrictlyEquals("ToggleButton getSkinForState(ButtonState.DISABLED_AND_SELECTED) does not match value passed to setSkinForState()", selectedDisabledSkin, this._button.getSkinForState(ButtonState.DISABLED_AND_SELECTED));
		}

		[Test]
		public function testDefaultCurrentSkin():void
		{
			this._button.isSelected = true;

			var defaultSelectedSkin:Quad = new Quad(200, 200);
			this._button.defaultSelectedSkin = defaultSelectedSkin;

			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.UP_AND_SELECTED with no touch and isSelected is true", ButtonState.UP_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton skin is not defaultSkin when currentState is ButtonState.UP_AND_SELECTED and skin not provided for this state", defaultSelectedSkin, this._button.currentSkinInternal);

			this._button.isEnabled = false;
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.DISABLED_AND_SELECTED when isEnabled is false and isSelected is true", ButtonState.DISABLED_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton skin is not defaultSkin when currentState is ButtonState.DISABLED_AND_SELECTED and skin not provided for this state", defaultSelectedSkin, this._button.currentSkinInternal);

			this._button.isEnabled = true;

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be button", this._button, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.HOVER_AND_SELECTED on TouchPhase.HOVER and isSelected is true", ButtonState.HOVER_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton skin is not defaultSkin when currentState is ButtonState.HOVER and skin not provided for this state", defaultSelectedSkin, this._button.currentSkinInternal);

			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.DOWN_AND_SELECTED on TouchPhase.BEGAN and isSelected is true", ButtonState.DOWN_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton skin is not defaultSkin when currentState is ButtonState.DOWN and skin not provided for this state", defaultSelectedSkin, this._button.currentSkinInternal);
		}

		[Test]
		public function testCurrentSkinWithSetSkinForState():void
		{
			this._button.isSelected = true;

			var defaultSelectedSkin:Quad = new Quad(200, 200);
			this._button.defaultSkin = defaultSelectedSkin;

			var selectedUpSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.UP_AND_SELECTED, selectedUpSkin);

			var selectedHoverSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.HOVER_AND_SELECTED, selectedHoverSkin);

			var selectedDownSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.DOWN_AND_SELECTED, selectedDownSkin);

			var selectedDisabledSkin:Quad = new Quad(200, 200);
			this._button.setSkinForState(ButtonState.DISABLED_AND_SELECTED, selectedDisabledSkin);

			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.UP_AND_SELECTED with no touch and isSelected is true", ButtonState.UP_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton skin does not match skin set with setSkinForState() when currentState is ButtonState.UP_AND_SELECTED", selectedUpSkin, this._button.currentSkinInternal);

			this._button.isEnabled = false;
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.DISABLED_AND_SELECTED when isEnabled is false and isSelected is true", ButtonState.DISABLED_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton skin does not match skin set with setSkinForState() when currentState is ButtonState.DISABLED_AND_SELECTED", selectedDisabledSkin, this._button.currentSkinInternal);

			this._button.isEnabled = true;

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be button", this._button, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.HOVER_AND_SELECTED on TouchPhase.HOVER and isSelected is true", ButtonState.HOVER_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton skin does not match skin set with setSkinForState() when currentState is ButtonState.HOVER_AND_SELECTED and skin not provided for this state", selectedHoverSkin, this._button.currentSkinInternal);

			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.DOWN_AND_SELECTED on TouchPhase.BEGAN and isSelected is true", ButtonState.DOWN_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton skin does not match skin set with setSkinForState() when currentState is ButtonState.DOWN_AND_SELECTED and skin not provided for this state", selectedDownSkin, this._button.currentSkinInternal);
		}

		[Test]
		public function testGetIconForStateWithoutSetIconForState():void
		{
			Assert.assertNull("ToggleButton getIconForState(ButtonState.UP) must be null when setIconForState() is not called", this._button.getIconForState(ButtonState.UP));
			Assert.assertNull("ToggleButton getIconForState(ButtonState.HOVER) must be null when setIconForState() is not called", this._button.getIconForState(ButtonState.HOVER));
			Assert.assertNull("ToggleButton getIconForState(ButtonState.DOWN) must be null when setIconForState() is not called", this._button.getIconForState(ButtonState.DOWN));
			Assert.assertNull("ToggleButton getIconForState(ButtonState.DISABLED) must be null when setIconForState() is not called", this._button.getIconForState(ButtonState.DISABLED));
			Assert.assertNull("ToggleButton getIconForState(ButtonState.UP_AND_SELECTED) must be null when setIconForState() is not called", this._button.getIconForState(ButtonState.UP_AND_SELECTED));
			Assert.assertNull("ToggleButton getIconForState(ButtonState.HOVER_AND_SELECTED) must be null when setIconForState() is not called", this._button.getIconForState(ButtonState.HOVER_AND_SELECTED));
			Assert.assertNull("ToggleButton getIconForState(ButtonState.DOWN_AND_SELECTED) must be null when setIconForState() is not called", this._button.getIconForState(ButtonState.DOWN_AND_SELECTED));
			Assert.assertNull("ToggleButton getIconForState(ButtonState.DISABLED_AND_SELECTED) must be null when setIconForState() is not called", this._button.getIconForState(ButtonState.DISABLED_AND_SELECTED));
		}

		[Test]
		public function testGetIconForState():void
		{
			var defaultIcon:Quad = new Quad(200, 200);
			this._button.defaultIcon = defaultIcon;

			var upIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.UP, upIcon);

			var hoverIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.HOVER, hoverIcon);

			var downIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.DOWN, downIcon);

			var disabledIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.DISABLED, disabledIcon);

			var defaultSelectedIcon:Quad = new Quad(200, 200);
			this._button.defaultSelectedIcon = defaultSelectedIcon;

			var selectedUpIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.UP_AND_SELECTED, selectedUpIcon);

			var selectedHoverIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.HOVER_AND_SELECTED, selectedHoverIcon);

			var selectedDownIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.DOWN_AND_SELECTED, selectedDownIcon);

			var selectedDisabledIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.DISABLED_AND_SELECTED, selectedDisabledIcon);

			Assert.assertStrictlyEquals("ToggleButton getIconForState(ButtonState.UP) does not match value passed to setIconForState()", upIcon, this._button.getIconForState(ButtonState.UP));
			Assert.assertStrictlyEquals("ToggleButton getIconForState(ButtonState.HOVER) does not match value passed to setIconForState()", hoverIcon, this._button.getIconForState(ButtonState.HOVER));
			Assert.assertStrictlyEquals("ToggleButton getIconForState(ButtonState.DOWN) does not match value passed to setIconForState()", downIcon, this._button.getIconForState(ButtonState.DOWN));
			Assert.assertStrictlyEquals("ToggleButton getIconForState(ButtonState.DISABLED) does not match value passed to setIconForState()", disabledIcon, this._button.getIconForState(ButtonState.DISABLED));
			Assert.assertStrictlyEquals("ToggleButton getIconForState(ButtonState.UP_AND_SELECTED) does not match value passed to setIconForState()", selectedUpIcon, this._button.getIconForState(ButtonState.UP_AND_SELECTED));
			Assert.assertStrictlyEquals("ToggleButton getIconForState(ButtonState.HOVER_AND_SELECTED) does not match value passed to setIconForState()", selectedHoverIcon, this._button.getIconForState(ButtonState.HOVER_AND_SELECTED));
			Assert.assertStrictlyEquals("ToggleButton getIconForState(ButtonState.DOWN_AND_SELECTED) does not match value passed to setIconForState()", selectedDownIcon, this._button.getIconForState(ButtonState.DOWN_AND_SELECTED));
			Assert.assertStrictlyEquals("ToggleButton getIconForState(ButtonState.DISABLED_AND_SELECTED) does not match value passed to setIconForState()", selectedDisabledIcon, this._button.getIconForState(ButtonState.DISABLED_AND_SELECTED));
		}

		[Test]
		public function testDefaultCurrentIcon():void
		{
			this._button.isSelected = true;

			var defaultSelectedIcon:Quad = new Quad(200, 200);
			this._button.defaultSelectedIcon = defaultSelectedIcon;

			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.UP_AND_SELECTED with no touch and isSelected is true", ButtonState.UP_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton icon is not defaultSelectedIcon when currentState is ButtonState.UP_AND_SELECTED and icon not provided for this state", defaultSelectedIcon, this._button.currentIconInternal);

			this._button.isEnabled = false;
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.DISABLED_AND_SELECTED when isEnabled is false and isSelected is true", ButtonState.DISABLED_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton icon is not defaultSelectedIcon when currentState is ButtonState.DISABLED_AND_SELECTED and icon not provided for this state", defaultSelectedIcon, this._button.currentIconInternal);

			this._button.isEnabled = true;

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be button", this._button, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.HOVER_AND_SELECTED on TouchPhase.HOVER and isSelected is true", ButtonState.HOVER_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton icon is not defaultSelectedIcon when currentState is ButtonState.HOVER and icon not provided for this state", defaultSelectedIcon, this._button.currentIconInternal);

			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.DOWN_AND_SELECTED on TouchPhase.BEGAN and isSelected is true", ButtonState.DOWN_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton icon is not defaultSelectedIcon when currentState is ButtonState.DOWN and icon not provided for this state", defaultSelectedIcon, this._button.currentIconInternal);
		}

		[Test]
		public function testCurrentIconWithSetIconForState():void
		{
			this._button.isSelected = true;
			
			var defaultSelectedIcon:Quad = new Quad(200, 200);
			this._button.defaultSelectedIcon = defaultSelectedIcon;

			var selectedUpIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.UP_AND_SELECTED, selectedUpIcon);

			var selectedHoverIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.HOVER_AND_SELECTED, selectedHoverIcon);

			var selectedDownIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.DOWN_AND_SELECTED, selectedDownIcon);

			var selectedDisabledIcon:Quad = new Quad(200, 200);
			this._button.setIconForState(ButtonState.DISABLED_AND_SELECTED, selectedDisabledIcon);

			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.UP_AND_SELECTED with no touch and isSelected is true", ButtonState.UP_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton icon does not match icon set with setIconForState() when currentState is ButtonState.UP_AND_SELECTED", selectedUpIcon, this._button.currentIconInternal);

			this._button.isEnabled = false;
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.DISABLED_AND_SELECTED when isEnabled is false and isSelected is true", ButtonState.DISABLED_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton icon does not match icon set with setIconForState() when currentState is ButtonState.DISABLED_AND_SELECTED", selectedDisabledIcon, this._button.currentIconInternal);

			this._button.isEnabled = true;

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be button", this._button, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.HOVER_AND_SELECTED on TouchPhase.HOVER and isSelected is true", ButtonState.HOVER_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton icon does not match icon set with setIconForState() when currentState is ButtonState.HOVER_AND_SELECTED and icon not provided for this state", selectedHoverIcon, this._button.currentIconInternal);

			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.DOWN_AND_SELECTED on TouchPhase.BEGAN and isSelected is true", ButtonState.DOWN_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton icon does not match icon set with setIconForState() when currentState is ButtonState.DOWN_AND_SELECTED and icon not provided for this state", selectedDownIcon, this._button.currentIconInternal);
		}

		[Test]
		public function testGetScaleForStateWithoutSetSkinForState():void
		{
			Assert.assertStrictlyEquals("ToggleButton scaleWhenSelected must be NaN by default",
				1, this._button.scaleWhenSelected);
			Assert.assertTrue("ToggleButton getScaleForState(ButtonState.UP) must be NaN when setScaleForState() is not called",
				isNaN(this._button.getScaleForState(ButtonState.UP)));
			Assert.assertTrue("ToggleButton getScaleForState(ButtonState.HOVER) must be NaN when setScaleForState() is not called",
				isNaN(this._button.getScaleForState(ButtonState.HOVER)));
			Assert.assertTrue("ToggleButton getScaleForState(ButtonState.DOWN) must be NaN when setScaleForState() is not called",
				isNaN(this._button.getScaleForState(ButtonState.DOWN)));
			Assert.assertTrue("ToggleButton getScaleForState(ButtonState.DISABLED) must be NaN when setScaleForState() is not called",
				isNaN(this._button.getScaleForState(ButtonState.DISABLED)));
			Assert.assertTrue("ToggleButton getScaleForState(ButtonState.UP_AND_SELECTED) must be NaN when setScaleForState() is not called",
				isNaN(this._button.getScaleForState(ButtonState.UP_AND_SELECTED)));
			Assert.assertTrue("ToggleButton getScaleForState(ButtonState.HOVER_AND_SELECTED) must be NaN when setScaleForState() is not called",
				isNaN(this._button.getScaleForState(ButtonState.HOVER_AND_SELECTED)));
			Assert.assertTrue("ToggleButton getScaleForState(ButtonState.DOWN_AND_SELECTED) must be NaN when setScaleForState() is not called",
				isNaN(this._button.getScaleForState(ButtonState.DOWN_AND_SELECTED)));
			Assert.assertTrue("ToggleButton getScaleForState(ButtonState.DISABLED_AND_SELECTED) must be NaN when setScaleForState() is not called",
				isNaN(this._button.getScaleForState(ButtonState.DISABLED_AND_SELECTED)));
		}

		[Test]
		public function testGetScaleForState():void
		{
			var upScale:Number = 1.1;
			this._button.setScaleForState(ButtonState.UP, upScale);

			var hoverScale:Number = 1.2;
			this._button.setScaleForState(ButtonState.HOVER, hoverScale);

			var downScale:Number = 1.3;
			this._button.setScaleForState(ButtonState.DOWN, downScale);

			var disabledScale:Number = 1.4;
			this._button.setScaleForState(ButtonState.DISABLED, disabledScale);

			var scaleWhenSelected:Number = 1.5;
			this._button.scaleWhenSelected = scaleWhenSelected;

			var selectedUpScale:Number = 1.6;
			this._button.setScaleForState(ButtonState.UP_AND_SELECTED, selectedUpScale);

			var selectedHoverScale:Number = 1.7;
			this._button.setScaleForState(ButtonState.HOVER_AND_SELECTED, selectedHoverScale);

			var selectedDownScale:Number = 1.8;
			this._button.setScaleForState(ButtonState.DOWN_AND_SELECTED, selectedDownScale);

			var selectedDisabledScale:Number = 1.9;
			this._button.setScaleForState(ButtonState.DISABLED_AND_SELECTED, selectedDisabledScale);

			Assert.assertStrictlyEquals("ToggleButton getScaleForState(ButtonState.UP) does not match value passed to setScaleForState()", upScale, this._button.getScaleForState(ButtonState.UP));
			Assert.assertStrictlyEquals("ToggleButton getScaleForState(ButtonState.HOVER) does not match value passed to setScaleForState()", hoverScale, this._button.getScaleForState(ButtonState.HOVER));
			Assert.assertStrictlyEquals("ToggleButton getScaleForState(ButtonState.DOWN) does not match value passed to setScaleForState()", downScale, this._button.getScaleForState(ButtonState.DOWN));
			Assert.assertStrictlyEquals("ToggleButton getScaleForState(ButtonState.DISABLED) does not match value passed to setScaleForState()", disabledScale, this._button.getScaleForState(ButtonState.DISABLED));
			Assert.assertStrictlyEquals("ToggleButton getScaleForState(ButtonState.UP_AND_SELECTED) does not match value passed to setScaleForState()", selectedUpScale, this._button.getScaleForState(ButtonState.UP_AND_SELECTED));
			Assert.assertStrictlyEquals("ToggleButton getScaleForState(ButtonState.HOVER_AND_SELECTED) does not match value passed to setScaleForState()", selectedHoverScale, this._button.getScaleForState(ButtonState.HOVER_AND_SELECTED));
			Assert.assertStrictlyEquals("ToggleButton getScaleForState(ButtonState.DOWN_AND_SELECTED) does not match value passed to setScaleForState()", selectedDownScale, this._button.getScaleForState(ButtonState.DOWN_AND_SELECTED));
			Assert.assertStrictlyEquals("ToggleButton getScaleForState(ButtonState.DISABLED_AND_SELECTED) does not match value passed to setScaleForState()", selectedDisabledScale, this._button.getScaleForState(ButtonState.DISABLED_AND_SELECTED));
		}

		[Test]
		public function testDefaultCurrentScale():void
		{
			this._button.defaultSkin = new Quad(200, 200);
			this._button.isSelected = true;

			var scaleWhenSelected:Number = 1.5;
			this._button.scaleWhenSelected = scaleWhenSelected;

			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.UP_AND_SELECTED with no touch and isSelected is true", ButtonState.UP_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton scale is not scaleWhenSelected when currentState is ButtonState.UP_AND_SELECTED and scale not provided for this state", scaleWhenSelected, this._button.currentScaleInternal);

			this._button.isEnabled = false;
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.DISABLED_AND_SELECTED when isEnabled is false and isSelected is true", ButtonState.DISABLED_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton scale is not scaleWhenSelected when currentState is ButtonState.DISABLED_AND_SELECTED and scale not provided for this state", scaleWhenSelected, this._button.currentScaleInternal);

			this._button.isEnabled = true;

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be button", this._button, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.HOVER_AND_SELECTED on TouchPhase.HOVER and isSelected is true", ButtonState.HOVER_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton scale is not scaleWhenSelected when currentState is ButtonState.HOVER and scale not provided for this state", scaleWhenSelected, this._button.currentScaleInternal);

			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.DOWN_AND_SELECTED on TouchPhase.BEGAN and isSelected is true", ButtonState.DOWN_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton scale is not scaleWhenSelected when currentState is ButtonState.DOWN and scale not provided for this state", scaleWhenSelected, this._button.currentScaleInternal);
		}

		[Test]
		public function testCurrentScaleWithSetScaleForState():void
		{
			this._button.defaultSkin = new Quad(200, 200);
			this._button.isSelected = true;
			
			var scaleWhenSelected:Number = 2.0;
			this._button.scaleWhenSelected = scaleWhenSelected;

			var selectedUpScale:Number = 1.1;
			this._button.setScaleForState(ButtonState.UP_AND_SELECTED, selectedUpScale);

			var selectedHoverScale:Number = 1.2;
			this._button.setScaleForState(ButtonState.HOVER_AND_SELECTED, selectedHoverScale);

			var selectedDownScale:Number = 1.3;
			this._button.setScaleForState(ButtonState.DOWN_AND_SELECTED, selectedDownScale);

			var selectedDisabledScale:Number = 1.4;
			this._button.setScaleForState(ButtonState.DISABLED_AND_SELECTED, selectedDisabledScale);

			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.UP_AND_SELECTED with no touch and isSelected is true", ButtonState.UP_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton scale does not match scale set with setScaleForState() when currentState is ButtonState.UP_AND_SELECTED", selectedUpScale, this._button.currentScaleInternal);

			this._button.isEnabled = false;
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.DISABLED_AND_SELECTED when isEnabled is false and isSelected is true", ButtonState.DISABLED_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton scale does not match scale set with setScaleForState() when currentState is ButtonState.DISABLED_AND_SELECTED", selectedDisabledScale, this._button.currentScaleInternal);

			this._button.isEnabled = true;

			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			Assert.assertStrictlyEquals("Touch target must be button", this._button, target);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.HOVER_AND_SELECTED on TouchPhase.HOVER and isSelected is true", ButtonState.HOVER_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton scale does not match scale set with setScaleForState() when currentState is ButtonState.HOVER_AND_SELECTED and scale not provided for this state", selectedHoverScale, this._button.currentScaleInternal);

			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.validate();
			Assert.assertStrictlyEquals("ToggleButton state is not ButtonState.DOWN_AND_SELECTED on TouchPhase.BEGAN and isSelected is true", ButtonState.DOWN_AND_SELECTED, this._button.currentState);
			Assert.assertStrictlyEquals("ToggleButton scale does not match scale set with setScaleForState() when currentState is ButtonState.DOWN_AND_SELECTED and scale not provided for this state", selectedDownScale, this._button.currentScaleInternal);
		}
	}
}

import feathers.controls.ToggleButton;
import feathers.core.ITextRenderer;

import starling.display.DisplayObject;

class ToggleButtonWithInternalState extends ToggleButton
{
	public function ToggleButtonWithInternalState()
	{
		super();
	}

	public function get labelTextRendererInternal():ITextRenderer
	{
		return this.labelTextRenderer;
	}

	public function get currentSkinInternal():DisplayObject
	{
		return this.currentSkin;
	}

	public function get currentIconInternal():DisplayObject
	{
		return this.currentIcon;
	}

	public function get currentScaleInternal():Number
	{
		return this.getScaleForCurrentState();
	}
}

================================================
FILE: test/source/feathers/tests/ToggleButtonTests.as
================================================
package feathers.tests
{
	import feathers.controls.ButtonState;
	import feathers.controls.ToggleButton;
	import feathers.core.ToggleGroup;
	import feathers.tests.supportClasses.DisposeFlagQuad;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class ToggleButtonTests
	{
		private var _button:ToggleButton;
		private var _blocker:Quad;

		[Before]
		public function prepare():void
		{
			this._button = new ToggleButton();
			this._button.isSelected = true;
			this._button.label = "Click Me";
			this._button.defaultSkin = new Quad(200, 200);
			TestFeathers.starlingRoot.addChild(this._button);
			this._button.validate();
		}

		[After]
		public function cleanup():void
		{
			this._button.removeFromParent(true);
			this._button = null;

			if(this._blocker)
			{
				this._blocker.removeFromParent(true);
				this._blocker = null;
			}

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testProgrammaticChangeEvent():void
		{
			var beforeIsSelected:Boolean = this._button.isSelected;
			var hasChanged:Boolean = false;
			this._button.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._button.isSelected = !this._button.isSelected;
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("This isSelected property was not changed", beforeIsSelected === this._button.isSelected);
		}

		[Test]
		public function testInteractiveChangeEvent():void
		{
			var beforeIsSelected:Boolean = this._button.isSelected;
			var hasChanged:Boolean = false;
			this._button.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("This isSelected property was not changed", beforeIsSelected === this._button.isSelected);
		}

		[Test]
		public function testRemoveBeforeInteractiveChangeEvent():void
		{
			var beforeIsSelected:Boolean = this._button.isSelected;
			var hasChanged:Boolean = false;
			this._button.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			this._button.removeFromParent(false);
			Assert.assertFalse("Event.CHANGE most not be dispatched after removed from stage", hasChanged);
			Assert.assertTrue("This isSelected property must not be changed after removed from stage", beforeIsSelected === this._button.isSelected);
		}

		[Test]
		public function testSetIsToggleToFalse():void
		{
			this._button.isToggle = false;
			this._button.validate();
			var beforeIsSelected:Boolean = this._button.isSelected;
			var hasChanged:Boolean = false;
			this._button.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched", hasChanged);
			Assert.assertTrue("This isSelected property was incorrectly changed", beforeIsSelected === this._button.isSelected);
		}

		[Test]
		public function testTouchMoveOutsideBeforeChangeEvent():void
		{
			var beforeIsSelected:Boolean = this._button.isSelected;
			var hasChanged:Boolean = false;
			this._button.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.x;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.globalX = 1000; //move the touch way outside the bounds of the button
			touch.phase = TouchPhase.MOVED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched", hasChanged);
			Assert.assertStrictlyEquals("The isSelected property was incorrectly changed",
				beforeIsSelected, this._button.isSelected);
		}

		[Test]
		public function testOtherDisplayObjectBlockingChangeEvent():void
		{
			var beforeIsSelected:Boolean = this._button.isSelected;
			var hasChanged:Boolean = false;
			this._button.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			this._blocker = new Quad(200, 200, 0xff0000);
			TestFeathers.starlingRoot.addChild(this._blocker);

			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertFalse("Event.CHANGE was incorrectly dispatched", hasChanged);
			Assert.assertStrictlyEquals("The isSelected property was incorrectly changed",
				beforeIsSelected, this._button.isSelected);
		}

		[Test]
		public function testSkinsDisposed():void
		{
			var defaultSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.defaultSkin = defaultSkin;
			var upSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.upSkin = upSkin;
			var downSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.downSkin = downSkin;
			var hoverSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.hoverSkin = hoverSkin;
			var disabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.disabledSkin = disabledSkin;
			var defaultSelectedSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.defaultSelectedSkin = defaultSelectedSkin;
			var selectedUpSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.selectedUpSkin = selectedUpSkin;
			var selectedDownSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.selectedDownSkin = selectedDownSkin;
			var selectedHoverSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.selectedHoverSkin = selectedHoverSkin;
			var selectedDisabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.selectedDisabledSkin = selectedDisabledSkin;
			this._button.validate();
			this._button.dispose();
			Assert.assertTrue("defaultSkin not disposed when ToggleButton disposed.", defaultSkin.isDisposed);
			Assert.assertTrue("upSkin not disposed when ToggleButton disposed.", upSkin.isDisposed);
			Assert.assertTrue("downSkin not disposed when ToggleButton disposed.", downSkin.isDisposed);
			Assert.assertTrue("hoverSkin not disposed when ToggleButton disposed.", hoverSkin.isDisposed);
			Assert.assertTrue("disabledSkin not disposed when ToggleButton disposed.", disabledSkin.isDisposed);
			Assert.assertTrue("defaultSelectedSkin not disposed when ToggleButton disposed.", defaultSelectedSkin.isDisposed);
			Assert.assertTrue("selectedUpSkin not disposed when ToggleButton disposed.", selectedUpSkin.isDisposed);
			Assert.assertTrue("selectedDownSkin not disposed when ToggleButton disposed.", selectedDownSkin.isDisposed);
			Assert.assertTrue("selectedHoverSkin not disposed when ToggleButton disposed.", selectedHoverSkin.isDisposed);
			Assert.assertTrue("selectedDisabledSkin not disposed when ToggleButton disposed.", selectedDisabledSkin.isDisposed);
		}

		[Test]
		public function testIconsDisposed():void
		{
			var defaultIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.defaultIcon = defaultIcon;
			var upIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.upIcon = upIcon;
			var downIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.downSkin = downIcon;
			var hoverIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.hoverIcon = hoverIcon;
			var disabledIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.disabledIcon = disabledIcon;
			var defaultSelectedIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.defaultSelectedIcon = defaultSelectedIcon;
			var selectedUpIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.selectedUpIcon = selectedUpIcon;
			var selectedDownIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.selectedDownIcon = selectedDownIcon;
			var selectedHoverIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.selectedHoverIcon = selectedHoverIcon;
			var selectedDisabledIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.selectedDisabledIcon = selectedDisabledIcon;
			this._button.validate();
			this._button.dispose();
			Assert.assertTrue("defaultIcon not disposed when ToggleButton disposed.", defaultIcon.isDisposed);
			Assert.assertTrue("upIcon not disposed when ToggleButton disposed.", upIcon.isDisposed);
			Assert.assertTrue("downIcon not disposed when ToggleButton disposed.", downIcon.isDisposed);
			Assert.assertTrue("hoverIcon not disposed when ToggleButton disposed.", hoverIcon.isDisposed);
			Assert.assertTrue("disabledIcon not disposed when ToggleButton disposed.", disabledIcon.isDisposed);
			Assert.assertTrue("defaultSelectedIcon not disposed when ToggleButton disposed.", defaultSelectedIcon.isDisposed);
			Assert.assertTrue("selectedUpIcon not disposed when ToggleButton disposed.", selectedUpIcon.isDisposed);
			Assert.assertTrue("selectedDownIcon not disposed when ToggleButton disposed.", selectedDownIcon.isDisposed);
			Assert.assertTrue("selectedHoverIcon not disposed when ToggleButton disposed.", selectedHoverIcon.isDisposed);
			Assert.assertTrue("selectedDisabledIcon not disposed when ToggleButton disposed.", selectedDisabledIcon.isDisposed);
		}

		[Test]
		public function testSkinsRemovedWhenSetToNull():void
		{
			var defaultSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.defaultSkin = defaultSkin;
			var upSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.UP, upSkin);
			var downSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.DOWN, downSkin);
			var hoverSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.HOVER, hoverSkin);
			var disabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.DISABLED, disabledSkin);
			var defaultSelectedSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.defaultSelectedSkin = defaultSelectedSkin;
			var selectedUpSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.UP_AND_SELECTED, selectedUpSkin);
			var selectedDownSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.DOWN_AND_SELECTED, selectedDownSkin);
			var selectedHoverSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.HOVER_AND_SELECTED, selectedHoverSkin);
			var selectedDisabledSkin:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setSkinForState(ButtonState.DISABLED_AND_SELECTED, selectedDisabledSkin);
			this._button.validate();
			this._button.defaultSkin = null;
			this._button.setSkinForState(ButtonState.UP, null);
			this._button.setSkinForState(ButtonState.DOWN, null);
			this._button.setSkinForState(ButtonState.HOVER, null);
			this._button.setSkinForState(ButtonState.DISABLED, null);
			this._button.defaultSelectedSkin = null;
			this._button.setSkinForState(ButtonState.UP_AND_SELECTED, null);
			this._button.setSkinForState(ButtonState.DOWN_AND_SELECTED, null);
			this._button.setSkinForState(ButtonState.HOVER_AND_SELECTED, null);
			this._button.setSkinForState(ButtonState.DISABLED_AND_SELECTED, null);
			//should not need to validate here
			this._button.dispose();
			Assert.assertFalse("Removed defaultSkin incorrectly disposed when ToggleButton disposed.", defaultSkin.isDisposed);
			Assert.assertFalse("Removed upSkin incorrectly disposed when ToggleButton disposed.", upSkin.isDisposed);
			Assert.assertFalse("Removed downSkin incorrectly disposed when ToggleButton disposed.", downSkin.isDisposed);
			Assert.assertFalse("Removed hoverSkin incorrectly disposed when ToggleButton disposed.", hoverSkin.isDisposed);
			Assert.assertFalse("Removed disabledSkin incorrectly disposed when ToggleButton disposed.", disabledSkin.isDisposed);
			Assert.assertFalse("Removed defaultSelectedSkin incorrectly disposed when ToggleButton disposed.", defaultSelectedSkin.isDisposed);
			Assert.assertFalse("Removed selectedUpSkin incorrectly disposed when ToggleButton disposed.", selectedUpSkin.isDisposed);
			Assert.assertFalse("Removed selectedDownSkin incorrectly disposed when ToggleButton disposed.", selectedDownSkin.isDisposed);
			Assert.assertFalse("Removed selectedHoverSkin incorrectly disposed when ToggleButton disposed.", selectedHoverSkin.isDisposed);
			Assert.assertFalse("Removed selectedDisabledSkin incorrectly disposed when ToggleButton disposed.", selectedDisabledSkin.isDisposed);
			Assert.assertNull("defaultSkin parent must be null when removed from ToggleButton.", defaultSkin.parent);
			Assert.assertNull("upSkin parent must be null when removed from ToggleButton.", upSkin.parent);
			Assert.assertNull("downSkin parent must be null when removed from ToggleButton.", downSkin.parent);
			Assert.assertNull("hoverSkin parent must be null when removed from ToggleButton.", hoverSkin.parent);
			Assert.assertNull("disabledSkin parent must be null when removed from ToggleButton.", disabledSkin.parent);
			Assert.assertNull("defaultSelectedSkin parent must be null when removed from ToggleButton.", defaultSelectedSkin.parent);
			Assert.assertNull("selectedUpSkin parent must be null when removed from ToggleButton.", selectedUpSkin.parent);
			Assert.assertNull("selectedDownSkin parent must be null when removed from ToggleButton.", selectedDownSkin.parent);
			Assert.assertNull("selectedHoverSkin parent must be null when removed from ToggleButton.", selectedHoverSkin.parent);
			Assert.assertNull("selectedDisabledSkin parent must be null when removed from ToggleButton.", selectedDisabledSkin.parent);
			defaultSkin.dispose();
			upSkin.dispose();
			downSkin.dispose();
			hoverSkin.dispose();
			disabledSkin.dispose();
			defaultSelectedSkin.dispose();
			selectedUpSkin.dispose();
			selectedDownSkin.dispose();
			selectedHoverSkin.dispose();
			selectedDisabledSkin.dispose();
		}

		[Test]
		public function testIconsRemovedWhenSetToNull():void
		{
			var defaultIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.defaultIcon = defaultIcon;
			var upIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setIconForState(ButtonState.UP, upIcon);
			var downIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setIconForState(ButtonState.DOWN, downIcon);
			var hoverIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setIconForState(ButtonState.HOVER, hoverIcon);
			var disabledIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setIconForState(ButtonState.DISABLED, disabledIcon);
			var defaultSelectedIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.defaultSelectedIcon = defaultSelectedIcon;
			var selectedUpIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setIconForState(ButtonState.UP_AND_SELECTED, selectedUpIcon);
			var selectedDownIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setIconForState(ButtonState.DOWN_AND_SELECTED, selectedDownIcon);
			var selectedHoverIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setIconForState(ButtonState.HOVER_AND_SELECTED, selectedHoverIcon);
			var selectedDisabledIcon:DisposeFlagQuad = new DisposeFlagQuad();
			this._button.setIconForState(ButtonState.DISABLED_AND_SELECTED, selectedDisabledIcon);
			this._button.validate();
			this._button.defaultIcon = null;
			this._button.setIconForState(ButtonState.UP, null);
			this._button.setIconForState(ButtonState.DOWN, null);
			this._button.setIconForState(ButtonState.HOVER, null);
			this._button.setIconForState(ButtonState.DISABLED, null);
			this._button.defaultSelectedIcon = null;
			this._button.setIconForState(ButtonState.UP_AND_SELECTED, null);
			this._button.setIconForState(ButtonState.DOWN_AND_SELECTED, null);
			this._button.setIconForState(ButtonState.HOVER_AND_SELECTED, null);
			this._button.setIconForState(ButtonState.DISABLED_AND_SELECTED, null);
			//should not need to validate here
			this._button.dispose();
			Assert.assertFalse("Removed defaultIcon incorrectly disposed when ToggleButton disposed.", defaultIcon.isDisposed);
			Assert.assertFalse("Removed upIcon incorrectly disposed when ToggleButton disposed.", upIcon.isDisposed);
			Assert.assertFalse("Removed downIcon incorrectly disposed when ToggleButton disposed.", downIcon.isDisposed);
			Assert.assertFalse("Removed hoverIcon incorrectly disposed when ToggleButton disposed.", hoverIcon.isDisposed);
			Assert.assertFalse("Removed disabledIcon incorrectly disposed when ToggleButton disposed.", disabledIcon.isDisposed);
			Assert.assertFalse("Removed defaultSelectedIcon incorrectly disposed when ToggleButton disposed.", defaultSelectedIcon.isDisposed);
			Assert.assertFalse("Removed selectedUpIcon incorrectly disposed when ToggleButton disposed.", selectedUpIcon.isDisposed);
			Assert.assertFalse("Removed selectedDownIcon incorrectly disposed when ToggleButton disposed.", selectedDownIcon.isDisposed);
			Assert.assertFalse("Removed selectedHoverIcon incorrectly disposed when ToggleButton disposed.", selectedHoverIcon.isDisposed);
			Assert.assertFalse("Removed selectedDisabledIcon incorrectly disposed when ToggleButton disposed.", selectedDisabledIcon.isDisposed);
			Assert.assertNull("defaultIcon parent must be null when removed from ToggleButton.", defaultIcon.parent);
			Assert.assertNull("upIcon parent must be null when removed from ToggleButton.", upIcon.parent);
			Assert.assertNull("downIcon parent must be null when removed from ToggleButton.", downIcon.parent);
			Assert.assertNull("hoverIcon parent must be null when removed from ToggleButton.", hoverIcon.parent);
			Assert.assertNull("disabledIcon parent must be null when removed from ToggleButton.", disabledIcon.parent);
			Assert.assertNull("defaultSelectedIcon parent must be null when removed from ToggleButton.", defaultSelectedIcon.parent);
			Assert.assertNull("selectedUpIcon parent must be null when removed from ToggleButton.", selectedUpIcon.parent);
			Assert.assertNull("selectedDownIcon parent must be null when removed from ToggleButton.", selectedDownIcon.parent);
			Assert.assertNull("selectedHoverIcon parent must be null when removed from ToggleButton.", selectedHoverIcon.parent);
			Assert.assertNull("selectedDisabledIcon parent must be null when removed from ToggleButton.", selectedDisabledIcon.parent);
			defaultIcon.dispose();
			upIcon.dispose();
			downIcon.dispose();
			hoverIcon.dispose();
			disabledIcon.dispose();
			defaultSelectedIcon.dispose();
			selectedUpIcon.dispose();
			selectedDownIcon.dispose();
			selectedHoverIcon.dispose();
			selectedDisabledIcon.dispose();
		}

		[Test]
		public function testToggleGroupPropertyAfterAddingExternally():void
		{
			var group:ToggleGroup = new ToggleGroup();
			group.addItem(this._button);
			Assert.assertNotNull("toggleGroup property must not be null after adding a ToggleButton to a ToggleGroup.", this._button.toggleGroup);
		}

		[Test]
		public function testToggleGroupPropertyAfterRemovingExternally():void
		{
			var group:ToggleGroup = new ToggleGroup();
			group.addItem(this._button);
			group.removeItem(this._button);
			Assert.assertNull("toggleGroup property must be null after removing a ToggleButton to a ToggleGroup.", this._button.toggleGroup);
		}

		[Test]
		public function testButtonStateHoverOnTouchPhaseHover():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertStrictlyEquals("ToggleButton currentState was not changed to ButtonState.HOVER_AND_SELECTED on TouchPhase.HOVER", ButtonState.HOVER_AND_SELECTED, this._button.currentState);
		}

		[Test]
		public function testButtonStateUpAfterHoverOut():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, new <Touch>[]));
			Assert.assertStrictlyEquals("ToggleButton currentState was not changed to ButtonState.UP_AND_SELECTED when TouchPhase.HOVER ends", ButtonState.UP_AND_SELECTED, this._button.currentState);
		}

		[Test]
		public function testButtonStateDownOnTouchPhaseBegan():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertStrictlyEquals("ToggleButton currentState was not changed to ButtonState.DOWN_AND_SELECTED on TouchPhase.BEGAN", ButtonState.DOWN_AND_SELECTED, this._button.currentState);
		}

		[Test]
		public function testButtonStateUpOnTouchPhaseMoveOutside():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.MOVED;
			touch.globalX = 1000;
			touch.globalY = position.y;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertStrictlyEquals("ToggleButton currentState was not changed to ButtonState.UP_AND_SELECTED on TouchPhase.MOVED when position is outside button", ButtonState.UP_AND_SELECTED, this._button.currentState);
		}

		[Test]
		public function testButtonStateDownOnTouchPhaseMoveOutsideAndBackInside():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.MOVED;
			touch.globalX = 1000;
			touch.globalY = position.y;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.globalX = 10;
			touch.globalY = position.y;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertStrictlyEquals("ToggleButton currentState was not changed to ButtonState.DOWN_AND_SELECTED on TouchPhase.MOVED when position moves outside button then back inside", ButtonState.DOWN_AND_SELECTED, this._button.currentState);
		}

		[Test]
		public function testButtonStateUpOnTouchPhaseMoveOutsideAndKeepDownStateOnRollOutIsTrue():void
		{
			this._button.keepDownStateOnRollOut = true;
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.MOVED;
			touch.globalX = 1000;
			touch.globalY = position.y;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertStrictlyEquals("ToggleButton currentState was incorrectly changed from ButtonState.DOWN_AND_SELECTED on TouchPhase.MOVED when position is outside button and keepDownStateOnRollOut is true", ButtonState.DOWN_AND_SELECTED, this._button.currentState);
		}

		[Test]
		public function testButtonStateUpOnTouchPhaseEnded():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._button.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertStrictlyEquals("ToggleButton currentState was not changed to ButtonState.UP on TouchPhase.ENDED (which toggles isSelected)", ButtonState.UP, this._button.currentState);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ToggleGroupTests.as
================================================
package feathers.tests
{
	import feathers.controls.ToggleButton;
	import feathers.core.IToggle;
	import feathers.core.ToggleGroup;

	import org.flexunit.Assert;

	import starling.events.Event;

	public class ToggleGroupTests
	{
		private var _group:ToggleGroup;

		[Before]
		public function prepare():void
		{
			this._group = new ToggleGroup();
		}

		[After]
		public function cleanup():void
		{
			var itemCount:int = this._group.numItems;
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:ToggleButton = ToggleButton(this._group.getItemAt(i));
				item.dispose();
			}
			this._group = null;
		}

		[Test]
		public function testDefaultSelectedIndexIsNegativeOne():void
		{
			Assert.assertStrictlyEquals("The selectedIndex property is not equal to -1",
				-1, this._group.selectedIndex);
		}

		[Test]
		public function testUpdatesSelectedIndexWhenAddingFirstItem():void
		{
			var hasChanged:Boolean = false;
			this._group.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._group.addItem(new ToggleButton());
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property is not equal to 0",
				0, this._group.selectedIndex);
		}

		[Test]
		public function testSettingSelectedIndexDispatchesChangeEvent():void
		{
			this._group.addItem(new ToggleButton());
			this._group.addItem(new ToggleButton());
			var hasChanged:Boolean = false;
			this._group.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._group.selectedIndex = 1;
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
		}

		[Test]
		public function testSettingSelectedIndexToSameValueDispatchesNoEvent():void
		{
			this._group.addItem(new ToggleButton());
			this._group.addItem(new ToggleButton());
			var hasChanged:Boolean = false;
			this._group.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._group.selectedIndex = 0;
			Assert.assertFalse("Event.CHANGE was not dispatched", hasChanged);
		}

		[Test]
		public function testChangingItemSelectionDispatchesChangeEvent():void
		{
			var itemAtIndex1:ToggleButton = new ToggleButton();
			this._group.addItem(new ToggleButton());
			this._group.addItem(itemAtIndex1);
			var hasChanged:Boolean = false;
			this._group.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			itemAtIndex1.isSelected = true;
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
		}

		[Test]
		public function testRemoveItemBeforeSelectedItem():void
		{
			var itemAtIndex0:ToggleButton = new ToggleButton();
			this._group.addItem(itemAtIndex0);
			this._group.addItem(new ToggleButton());
			this._group.addItem(new ToggleButton());
			this._group.selectedIndex = 1;
			var beforeSelectedIndex:int = this._group.selectedIndex;
			var beforeSelectedItem:Object = this._group.selectedItem;
			var hasChanged:Boolean = false;
			this._group.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._group.removeItem(itemAtIndex0);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not changed",
				beforeSelectedIndex - 1, this._group.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem was incorrectly changed",
				beforeSelectedItem, this._group.selectedItem);
		}

		[Test]
		public function testRemoveAfterSelectedIndex():void
		{
			var itemAtIndex2:ToggleButton = new ToggleButton();
			this._group.addItem(new ToggleButton());
			this._group.addItem(new ToggleButton());
			this._group.addItem(itemAtIndex2);
			this._group.selectedIndex = 1;
			var beforeSelectedIndex:int = this._group.selectedIndex;
			var beforeSelectedItem:Object = this._group.selectedItem;
			var hasChanged:Boolean = false;
			this._group.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._group.removeItem(itemAtIndex2);
			Assert.assertFalse("Event.CHANGE was incorrectly dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was incorrectly changed",
				beforeSelectedIndex, this._group.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem was incorrectly changed",
				beforeSelectedItem, this._group.selectedItem);
		}

		[Test]
		public function testRemoveSelectedItem():void
		{
			var itemAtIndex1:ToggleButton = new ToggleButton();
			this._group.addItem(new ToggleButton());
			this._group.addItem(itemAtIndex1);
			this._group.addItem(new ToggleButton());
			this._group.selectedIndex = 1;
			var beforeSelectedIndex:int = this._group.selectedIndex;
			var beforeSelectedItem:IToggle = this._group.selectedItem;
			var hasChanged:Boolean = false;
			this._group.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._group.removeItem(itemAtIndex1);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was incorrectly changed",
				beforeSelectedIndex, this._group.selectedIndex);
			Assert.assertFalse("The selectedItem was not changed",
				beforeSelectedItem === this._group.selectedItem);
		}

		[Test]
		public function testDeselectAllOnRemoveAllItems():void
		{
			this._group.addItem(new ToggleButton());
			this._group.addItem(new ToggleButton());
			this._group.addItem(new ToggleButton());
			var hasChanged:Boolean = false;
			this._group.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._group.removeAllItems();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertStrictlyEquals("The selectedIndex property was not set to -1",
				-1, this._group.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem property was not set to null",
				null, this._group.selectedItem);
		}

		[Test]
		public function testSetSelectedItemIndex():void
		{
			var itemAtIndex1:ToggleButton = new ToggleButton();
			this._group.addItem(new ToggleButton());
			this._group.addItem(itemAtIndex1);
			this._group.addItem(new ToggleButton());
			this._group.selectedIndex = 1;
			var hasChanged:Boolean = false;
			var beforeSelectedIndex:int = this._group.selectedIndex;
			var beforeSelectedItem:IToggle = this._group.selectedItem;
			this._group.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._group.setItemIndex(itemAtIndex1, 2);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The selectedIndex property was not changed",
				beforeSelectedIndex === this._group.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem was incorrectly changed",
				beforeSelectedItem, this._group.selectedItem);
		}

		[Test]
		public function testSetItemIndexBeforeSelectedItem():void
		{
			var itemAtIndex0:ToggleButton = new ToggleButton();
			this._group.addItem(itemAtIndex0);
			this._group.addItem(new ToggleButton());
			this._group.addItem(new ToggleButton());
			this._group.selectedIndex = 1;
			var hasChanged:Boolean = false;
			var beforeSelectedIndex:int = this._group.selectedIndex;
			var beforeSelectedItem:IToggle = this._group.selectedItem;
			this._group.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._group.setItemIndex(itemAtIndex0, 2);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The selectedIndex property was not changed",
				beforeSelectedIndex === this._group.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem was incorrectly changed",
				beforeSelectedItem, this._group.selectedItem);
		}

		[Test]
		public function testSetItemIndexAfterSelectedItem():void
		{
			var itemAtIndex2:ToggleButton = new ToggleButton();
			this._group.addItem(new ToggleButton());
			this._group.addItem(new ToggleButton());
			this._group.addItem(itemAtIndex2);
			this._group.selectedIndex = 1;
			var hasChanged:Boolean = false;
			var beforeSelectedIndex:int = this._group.selectedIndex;
			var beforeSelectedItem:IToggle = this._group.selectedItem;
			this._group.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._group.setItemIndex(itemAtIndex2, 0);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The selectedIndex property was not changed",
				beforeSelectedIndex === this._group.selectedIndex);
			Assert.assertStrictlyEquals("The selectedItem was incorrectly changed",
				beforeSelectedItem, this._group.selectedItem);
		}

		[Test]
		public function testHasItem():void
		{
			var item:ToggleButton = new ToggleButton();
			Assert.assertFalse("hasItem() incorrectly returned true.", this._group.hasItem(item));
			this._group.addItem(item);
			Assert.assertTrue("hasItem() incorrectly returned false.", this._group.hasItem(item));
			this._group.removeItem(item);
			Assert.assertFalse("hasItem() incorrectly returned true.", this._group.hasItem(item));
		}

		[Test]
		public function testDefaultNumItems():void
		{
			Assert.assertStrictlyEquals("The numItems property is not equal to 0",
				0, this._group.numItems);
		}

		[Test]
		public function testNumItemsAfterAddItem():void
		{
			this._group.addItem(new ToggleButton());
			Assert.assertStrictlyEquals("The numItems property is not equal to 1 after addItem()",
				1, this._group.numItems);
		}

		[Test(expects="RangeError")]
		public function testGetItemAtWhenEmpty():void
		{
			this._group.getItemAt(0);
		}

		[Test]
		public function testGetItemAt():void
		{
			var item:ToggleButton = new ToggleButton();
			this._group.addItem(item);
			Assert.assertStrictlyEquals("ToggleButton getItemAt() returns wrong item",
				item, this._group.getItemAt(0));
		}
	}
}


================================================
FILE: test/source/feathers/tests/ToggleSwitchMeasurementTests.as
================================================
package feathers.tests
{
	import feathers.controls.BasicButton;
	import feathers.controls.ToggleSwitch;
	import feathers.controls.TrackLayoutMode;

	import org.flexunit.Assert;

	import starling.display.Quad;

	public class ToggleSwitchMeasurementTests
	{
		private static const SINGLE_TRACK_WIDTH:Number = 200;
		private static const SINGLE_TRACK_HEIGHT:Number = 50;
		private static const SINGLE_TRACK_MIN_WIDTH:Number = 150;
		private static const SINGLE_TRACK_MIN_HEIGHT:Number = 30;

		private static const ON_TRACK_WIDTH:Number = 100;
		private static const ON_TRACK_HEIGHT:Number = 50;
		private static const ON_TRACK_MIN_WIDTH:Number = 80;
		private static const ON_TRACK_MIN_HEIGHT:Number = 20;

		private static const OFF_TRACK_WIDTH:Number = 110;
		private static const OFF_TRACK_HEIGHT:Number = 55;
		private static const OFF_TRACK_MIN_WIDTH:Number = 90;
		private static const OFF_TRACK_MIN_HEIGHT:Number = 25;

		private static const THUMB_WIDTH:Number = 30;
		private static const SMALL_THUMB_HEIGHT:Number = 40;
		private static const LARGE_THUMB_HEIGHT:Number = 60;

		private static const THUMB_MIN_WIDTH:Number = 18;
		private static const SMALL_THUMB_MIN_HEIGHT:Number = 20;
		private static const LARGE_THUMB_MIN_HEIGHT:Number = 40;
		
		private var _toggle:ToggleSwitch;

		[Before]
		public function prepare():void
		{
			this._toggle = new ToggleSwitch();
			TestFeathers.starlingRoot.addChild(this._toggle);
		}

		[After]
		public function cleanup():void
		{
			this._toggle.removeFromParent(true);
			this._toggle = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSingle():void
		{
			this._toggle.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._toggle.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._toggle.onTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._toggle.validate();
			Assert.assertStrictlyEquals("The width of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_WIDTH, this._toggle.width);
			Assert.assertStrictlyEquals("The minWidth of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_WIDTH, this._toggle.minWidth);
			Assert.assertStrictlyEquals("The height of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_HEIGHT, this._toggle.height);
			Assert.assertStrictlyEquals("The minHeight of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE.",
				SINGLE_TRACK_HEIGHT, this._toggle.minHeight);
		}

		[Test]
		public function testAutoSizeHeightWithTrackLayoutModeSingleAndLargerThumb():void
		{
			this._toggle.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._toggle.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, LARGE_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._toggle.onTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._toggle.validate();
			Assert.assertStrictlyEquals("The height of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger thumb.",
				LARGE_THUMB_HEIGHT, this._toggle.height);
			Assert.assertStrictlyEquals("The minHeight of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger thumb.",
				LARGE_THUMB_HEIGHT, this._toggle.minHeight);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSingleAndMinDimensions():void
		{
			this._toggle.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._toggle.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = SMALL_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._toggle.onTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				button.minWidth = SINGLE_TRACK_MIN_WIDTH;
				button.minHeight = SINGLE_TRACK_MIN_HEIGHT;
				return button;
			};
			this._toggle.validate();
			Assert.assertStrictlyEquals("The minWidth of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE when the track's minWidth is set.",
				SINGLE_TRACK_MIN_WIDTH, this._toggle.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE when the track's minHeight is set.",
				SINGLE_TRACK_MIN_HEIGHT, this._toggle.minHeight);
		}

		[Test]
		public function testAutoSizeMinHeightWithTrackLayoutModeSingleAndLargerThumb():void
		{
			this._toggle.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._toggle.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, LARGE_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = LARGE_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._toggle.onTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(SINGLE_TRACK_WIDTH, SINGLE_TRACK_HEIGHT, 0xffff00);
				button.minWidth = SINGLE_TRACK_MIN_WIDTH;
				button.minHeight = SINGLE_TRACK_MIN_HEIGHT;
				return button;
			};
			this._toggle.validate();
			Assert.assertStrictlyEquals("The minHeight of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SINGLE and larger thumb minHeight.",
				LARGE_THUMB_MIN_HEIGHT, this._toggle.minHeight);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSplit():void
		{
			this._toggle.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._toggle.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._toggle.onTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(ON_TRACK_WIDTH, ON_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._toggle.offTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(OFF_TRACK_WIDTH, OFF_TRACK_HEIGHT, 0x00ffff);
				return button;
			};
			this._toggle.validate();
			Assert.assertStrictlyEquals("The width of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				OFF_TRACK_WIDTH + THUMB_WIDTH / 2, this._toggle.width);
			Assert.assertStrictlyEquals("The minWidth of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				OFF_TRACK_WIDTH + THUMB_WIDTH / 2, this._toggle.minWidth);
			Assert.assertStrictlyEquals("The height of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				OFF_TRACK_HEIGHT, this._toggle.height);
			Assert.assertStrictlyEquals("The minHeight of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT.",
				OFF_TRACK_HEIGHT, this._toggle.minHeight);
		}

		[Test]
		public function testAutoSizeHeightWithTrackLayoutModeSplitAndLargerThumb():void
		{
			this._toggle.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._toggle.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, LARGE_THUMB_HEIGHT, 0xff00ff);
				return thumb;
			};
			this._toggle.onTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(ON_TRACK_WIDTH, ON_TRACK_HEIGHT, 0xffff00);
				return button;
			};
			this._toggle.offTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(OFF_TRACK_WIDTH, OFF_TRACK_HEIGHT, 0x00ffff);
				return button;
			};
			this._toggle.validate();
			Assert.assertStrictlyEquals("The height of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger thumb.",
				LARGE_THUMB_HEIGHT, this._toggle.height);
			Assert.assertStrictlyEquals("The minHeight of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger thumb.",
				LARGE_THUMB_HEIGHT, this._toggle.minHeight);
		}

		[Test]
		public function testAutoSizeWithTrackLayoutModeSplitAndMinDimensions():void
		{
			this._toggle.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._toggle.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, SMALL_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = SMALL_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._toggle.onTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(ON_TRACK_WIDTH, ON_TRACK_HEIGHT, 0xffff00);
				button.minWidth = ON_TRACK_MIN_WIDTH;
				button.minHeight = ON_TRACK_MIN_HEIGHT;
				return button;
			};
			this._toggle.offTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(OFF_TRACK_WIDTH, OFF_TRACK_HEIGHT, 0x00ffff);
				button.minWidth = OFF_TRACK_MIN_WIDTH;
				button.minHeight = OFF_TRACK_MIN_HEIGHT;
				return button;
			};
			this._toggle.validate();
			Assert.assertStrictlyEquals("The minWidth of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT when the track's minWidth is set.",
				OFF_TRACK_MIN_WIDTH + THUMB_MIN_WIDTH / 2, this._toggle.minWidth);
			Assert.assertStrictlyEquals("The minHeight of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT when the track's minHeight is set.",
				OFF_TRACK_MIN_HEIGHT, this._toggle.minHeight);
		}

		[Test]
		public function testAutoSizeMinHeightWithTrackLayoutModeSplitAndLargerThumb():void
		{
			this._toggle.trackLayoutMode = TrackLayoutMode.SPLIT;
			this._toggle.thumbFactory = function():BasicButton
			{
				var thumb:BasicButton = new BasicButton();
				thumb.defaultSkin = new Quad(THUMB_WIDTH, LARGE_THUMB_HEIGHT, 0xff00ff);
				thumb.minWidth = THUMB_MIN_WIDTH;
				thumb.minHeight = LARGE_THUMB_MIN_HEIGHT;
				return thumb;
			};
			this._toggle.onTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(ON_TRACK_WIDTH, ON_TRACK_HEIGHT, 0xffff00);
				button.minWidth = ON_TRACK_MIN_WIDTH;
				button.minHeight = ON_TRACK_MIN_HEIGHT;
				return button;
			};
			this._toggle.offTrackFactory = function():BasicButton
			{
				var button:BasicButton = new BasicButton();
				button.defaultSkin = new Quad(OFF_TRACK_WIDTH, OFF_TRACK_HEIGHT, 0x00ffff);
				button.minWidth = OFF_TRACK_MIN_WIDTH;
				button.minHeight = OFF_TRACK_MIN_HEIGHT;
				return button;
			};
			this._toggle.validate();
			Assert.assertStrictlyEquals("The minHeight of the ToggleSwitch was not calculated correctly with trackLayoutMode set to TrackLayoutMode.SPLIT and larger thumb minHeight.",
				LARGE_THUMB_MIN_HEIGHT, this._toggle.minHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/ToggleSwitchTests.as
================================================
package feathers.tests
{
	import feathers.controls.Button;
	import feathers.controls.ToggleState;
	import feathers.controls.ToggleSwitch;
	import feathers.controls.TrackLayoutMode;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.events.Event;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class ToggleSwitchTests
	{
		private static const THUMB_NAME:String = "thumb";
		private static const TRACK_NAME:String = "track";
		private static const TRACK_WIDTH:Number = 50;
		private static const TRACK_HEIGHT:Number = 20;
		private static const THUMB_WIDTH:Number = 20;
		private static const THUMB_HEIGHT:Number = 20;

		private var _toggle:ToggleSwitch;

		[Before]
		public function prepare():void
		{
			this._toggle = new ToggleSwitch();
			this._toggle.trackLayoutMode = TrackLayoutMode.SINGLE;
			this._toggle.onTrackFactory = function():Button
			{
				var track:Button = new Button();
				track.name = TRACK_NAME;
				track.defaultSkin = new Quad(TRACK_WIDTH, TRACK_HEIGHT);
				return track;
			};
			this._toggle.thumbFactory = function():Button
			{
				var thumb:Button = new Button();
				thumb.name = THUMB_NAME;
				thumb.defaultSkin = new Quad(THUMB_WIDTH, THUMB_HEIGHT, 0xff0000);
				return thumb;
			};
			TestFeathers.starlingRoot.addChild(this._toggle);
			this._toggle.validate();
		}

		[After]
		public function cleanup():void
		{
			this._toggle.removeFromParent(true);
			this._toggle = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testProgrammaticSelectionChange():void
		{
			this._toggle.isSelected = false;
			var hasChanged:Boolean = false;
			this._toggle.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._toggle.isSelected = true;
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
		}

		[Test]
		public function testInteractiveSelectionChangeWithDraggingThumb():void
		{
			var oldSelected:Boolean = false;
			this._toggle.isSelected = oldSelected;
			//validate to position the thumb correctly.
			this._toggle.validate();
			var hasChanged:Boolean = false;
			this._toggle.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(THUMB_WIDTH / 2, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._toggle.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the toggle switch's thumb",
				this._toggle.getChildByName(THUMB_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.MOVED;
			touch.globalX = TRACK_WIDTH - THUMB_WIDTH / 2;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The isSelected property was not changed",
				oldSelected === this._toggle.isSelected);
		}

		[Test]
		public function testInteractiveSelectionChangeWithTapThumb():void
		{
			var oldSelected:Boolean = false;
			this._toggle.isSelected = oldSelected;
			//validate to position the thumb correctly.
			this._toggle.validate();
			var hasChanged:Boolean = false;
			this._toggle.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(THUMB_WIDTH / 2, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._toggle.stage.hitTest(position);

			Assert.assertStrictlyEquals("The hit test did not return the toggle switch's thumb",
				this._toggle.getChildByName(THUMB_NAME).name, target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The isSelected property was not changed",
				oldSelected === this._toggle.isSelected);
		}

		[Test]
		public function testInteractiveSelectionChangeWithTapTrack():void
		{
			var oldSelected:Boolean = false;
			this._toggle.isSelected = oldSelected;
			//validate to position the thumb correctly.
			this._toggle.validate();
			var hasChanged:Boolean = false;
			this._toggle.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(TRACK_WIDTH - THUMB_WIDTH / 2, THUMB_HEIGHT / 2);
			var target:DisplayObject = this._toggle.stage.hitTest(position);

			//we don't care what is hit as long as its not the thumb
			Assert.assertTrue("The hit test did not return a display object contained by the toggle switch",
				this._toggle.contains(target));
			Assert.assertFalse("The hit test incorrectly returned the toggle switch's thumb",
				this._toggle.getChildByName(THUMB_NAME).name === target.name);

			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertFalse("The isSelected property was not changed",
				oldSelected === this._toggle.isSelected);
		}

		[Test]
		public function testToggleSwitchDefaultsToToggleStateNotSelected():void
		{
			Assert.assertStrictlyEquals("ToggleSwitch currentState does not default to ToggleState.NOT_SELECTED", ToggleState.NOT_SELECTED, this._toggle.currentState);
		}

		[Test]
		public function testToggleSwitchDefaultsToToggleStateDisabledWhenIsEnabledIsFalse():void
		{
			this._toggle.isEnabled = false;
			Assert.assertStrictlyEquals("ToggleSwitch currentState does not default to ToggleState.DISABLED when isEnabled is false", ToggleState.DISABLED, this._toggle.currentState);
		}

		[Test]
		public function testToggleSwitchDefaultsToToggleStateSelectedWhenIsSelectedIsTrue():void
		{
			this._toggle.isSelected = true;
			Assert.assertStrictlyEquals("ToggleSwitch currentState does not default to ToggleState.DISABLED when isSelected is true", ToggleState.SELECTED, this._toggle.currentState);
		}

		[Test]
		public function testToggleSwitchDefaultsToToggleStateSelectedAndDisabledWhenIsEnabledIsFalseAndIsSelectedIsTrue():void
		{
			this._toggle.isEnabled = false;
			this._toggle.isSelected = true;
			Assert.assertStrictlyEquals("ToggleSwitch currentState does not default to ToggleState.SELECTED_AND_DISABLED when isEnabled is false and  isSelected is true", ToggleState.SELECTED_AND_DISABLED, this._toggle.currentState);
		}
	}
}


================================================
FILE: test/source/feathers/tests/TokenListTests.as
================================================
package feathers.tests
{
	import feathers.core.TokenList;

	import org.flexunit.Assert;

	public class TokenListTests
	{
		private static const TOKEN1:String = "token1";
		private static const TOKEN2:String = "token-two";
		private static const FAKE_TOKEN:String = "fake-token";
		private static const EMPTY_STRING:String = "";
		private static const DELIMITER:String = " ";
		
		private var _tokenList:TokenList;

		[Before]
		public function prepare():void
		{
			this._tokenList = new TokenList();
		}

		[After]
		public function cleanup():void
		{
			this._tokenList = null;
		}
		
		[Test]
		public function testEmptyValue():void
		{
			Assert.assertStrictlyEquals("Empty TokenList value is not empty string with no tokens", EMPTY_STRING, this._tokenList.value);
		}

		[Test]
		public function testEmptyLength():void
		{
			Assert.assertStrictlyEquals("Empty TokenList length is not 0 with no tokens", 0, this._tokenList.length);
		}

		[Test]
		public function testContainsWithoutAdding():void
		{
			Assert.assertFalse("TokenList contains() incorrectly returns true for a token that was not added", this._tokenList.contains(FAKE_TOKEN));
		}

		[Test]
		public function testContainsAfterAdding():void
		{
			this._tokenList.add(TOKEN1);
			Assert.assertTrue("TokenList contains() incorrectly returns false for a token that was added", this._tokenList.contains(TOKEN1));
		}

		[Test]
		public function testContainsAfterToggle():void
		{
			this._tokenList.toggle(TOKEN1);
			Assert.assertTrue("TokenList contains() incorrectly returns false for a token that was toggled", this._tokenList.contains(TOKEN1));
		}

		[Test]
		public function testContainsAfterToggleTwice():void
		{
			this._tokenList.toggle(TOKEN1);
			this._tokenList.toggle(TOKEN1);
			Assert.assertFalse("TokenList contains() incorrectly returns true for a token that was toggled twice", this._tokenList.contains(TOKEN1));
		}

		[Test]
		public function testValueAfterAdding():void
		{
			this._tokenList.add(TOKEN1);
			Assert.assertStrictlyEquals("TokenList value incorrect after adding one token", TOKEN1, this._tokenList.value);
		}

		[Test]
		public function testLengthAfterAdding():void
		{
			this._tokenList.add(TOKEN1);
			Assert.assertStrictlyEquals("TokenList value incorrect after adding one token", 1, this._tokenList.length);
		}

		[Test]
		public function testItemAfterAdding():void
		{
			this._tokenList.add(TOKEN1);
			Assert.assertStrictlyEquals("TokenList value incorrect after adding one token", TOKEN1, this._tokenList.item(0));
		}

		[Test]
		public function testContainsAfterAddingAndRemoving():void
		{
			this._tokenList.add(TOKEN1);
			this._tokenList.remove(TOKEN1);
			Assert.assertFalse("TokenList contains() incorrectly returns true for a token that was added, then removed", this._tokenList.contains(TOKEN1));
		}

		[Test]
		public function testValueAfterAddingAndRemoving():void
		{
			this._tokenList.add(TOKEN1);
			this._tokenList.remove(TOKEN1);
			Assert.assertStrictlyEquals("TokenList value incorrect after removing a token", EMPTY_STRING, this._tokenList.value);
		}

		[Test]
		public function testValueAfterAddingTwoTokens():void
		{
			this._tokenList.add(TOKEN1);
			this._tokenList.add(TOKEN2);
			Assert.assertStrictlyEquals("TokenList value incorrect after adding two tokens", TOKEN1 + DELIMITER + TOKEN2, this._tokenList.value);
		}

		[Test]
		public function testItemAfterAddingTwoTokens():void
		{
			this._tokenList.add(TOKEN1);
			this._tokenList.add(TOKEN2);
			Assert.assertStrictlyEquals("TokenList item(0) incorrect after adding two tokens", TOKEN1, this._tokenList.item(0));
			Assert.assertStrictlyEquals("TokenList item(1) incorrect after adding two tokens", TOKEN2, this._tokenList.item(1));
		}

		[Test]
		public function testLengthAfterAddingTwoTokens():void
		{
			this._tokenList.add(TOKEN1);
			this._tokenList.add(TOKEN2);
			Assert.assertStrictlyEquals("TokenList length incorrect after adding two tokens", 2, this._tokenList.length);
		}

		[Test]
		public function testContainsAfterSettingValueWithOneToken():void
		{
			this._tokenList.value = TOKEN1;
			Assert.assertTrue("TokenList contains() incorrectly returns false for a token that was set with value property", this._tokenList.contains(TOKEN1));
		}

		[Test]
		public function testContainsAfterSettingValueWithTwoTokens():void
		{
			this._tokenList.value = TOKEN1 + DELIMITER + TOKEN2;
			Assert.assertTrue("TokenList contains() incorrectly returns false for the first token that was set with value property", this._tokenList.contains(TOKEN1));
			Assert.assertTrue("TokenList contains() incorrectly returns false for the second token that was set with value property", this._tokenList.contains(TOKEN2));
		}
	}
}


================================================
FILE: test/source/feathers/tests/TouchToStateTests.as
================================================
package feathers.tests
{
	import feathers.controls.ButtonState;
	import feathers.utils.touch.TouchToState;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;

	import starling.display.Quad;
	import starling.events.Touch;
	import starling.events.TouchEvent;
	import starling.events.TouchPhase;

	public class TouchToStateTests
	{
		private var _target:Quad;
		private var _blocker:Quad;
		private var _touchToState:TouchToState;

		[Before]
		public function prepare():void
		{
			this._target = new Quad(200, 200, 0xff00ff);
			TestFeathers.starlingRoot.addChild(this._target);

			this._touchToState = new TouchToState(this._target);
		}

		[After]
		public function cleanup():void
		{
			this._target.removeFromParent(true);
			this._target = null;

			if(this._blocker)
			{
				this._blocker.removeFromParent(true);
				this._blocker = null;
			}

			this._touchToState = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testDownState():void
		{
			var hasCalledCallback:Boolean = false;
			var currentState:String = ButtonState.UP;
			this._touchToState.callback = function(value:String):void
			{
				if(currentState === value)
				{
					return;
				}
				hasCalledCallback = true;
				currentState = value;
			};
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("TouchToState callback was not called on TouchPhase.BEGAN",
				hasCalledCallback);
			Assert.assertStrictlyEquals("TouchToState did not change state to ButtonState.DOWN on TouchPhase.BEGAN",
				ButtonState.DOWN, this._touchToState.currentState);
			Assert.assertStrictlyEquals("TouchToState did not pass the correct state to callback TouchPhase.BEGAN",
				ButtonState.DOWN, currentState);
		}

		[Test]
		public function testHoverState():void
		{
			var hasCalledCallback:Boolean = false;
			var currentState:String = ButtonState.UP;
			this._touchToState.callback = function(value:String):void
			{
				if(currentState === value)
				{
					return;
				}
				hasCalledCallback = true;
				currentState = value;
			};
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("TouchToState callback was not called on TouchPhase.HOVER",
				hasCalledCallback);
			Assert.assertStrictlyEquals("TouchToState did not change state to ButtonState.HOVER on TouchPhase.HOVER",
				ButtonState.HOVER, this._touchToState.currentState);
			Assert.assertStrictlyEquals("TouchToState did not pass the correct state to callback on TouchPhase.HOVER",
				ButtonState.HOVER, currentState);
		}

		[Test]
		public function testUpStateAfterHoverEnd():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			var hasCalledCallback:Boolean = false;
			var currentState:String = ButtonState.HOVER;
			this._touchToState.callback = function(value:String):void
			{
				if(currentState === value)
				{
					return;
				}
				hasCalledCallback = true;
				currentState = value;
			};
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, new <Touch>[]));

			Assert.assertTrue("TouchToState callback was not called on no touches",
				hasCalledCallback);
			Assert.assertStrictlyEquals("TouchToState did not change state to ButtonState.UP on no touches",
				ButtonState.UP, this._touchToState.currentState);
			Assert.assertStrictlyEquals("TouchToState did not pass the correct state to callback on TouchPhase.HOVER end",
				ButtonState.UP, currentState);
		}

		[Test]
		public function testUpStateOnTouchEndedIfNoHoverBeforeBegan():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			var hasCalledCallback:Boolean = false;
			var currentState:String = ButtonState.DOWN;
			this._touchToState.callback = function(value:String):void
			{
				if(currentState === value)
				{
					return;
				}
				hasCalledCallback = true;
				currentState = value;
			};
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("TouchToState callback was not called on TouchPhase.ENDED",
				hasCalledCallback);
			Assert.assertStrictlyEquals("TouchToState did not change state to ButtonState.UP on TouchPhase.ENDED",
				ButtonState.UP, this._touchToState.currentState);
			Assert.assertStrictlyEquals("TouchToState did not pass the correct state to callback on TouchPhase.ENDED",
				ButtonState.UP, currentState);
		}

		[Test]
		public function testUpStateOnRemovedFromStage():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			var hasCalledCallback:Boolean = false;
			var currentState:String = ButtonState.DOWN;
			this._touchToState.callback = function(value:String):void
			{
				if(currentState === value)
				{
					return;
				}
				hasCalledCallback = true;
				currentState = value;
			};
			this._target.removeFromParent(false);

			Assert.assertTrue("TouchToState callback was not called on removed from stage",
				hasCalledCallback);
			Assert.assertStrictlyEquals("TouchToState did not change state to ButtonState.UP on removed from stage",
				ButtonState.UP, this._touchToState.currentState);
			Assert.assertStrictlyEquals("TouchToState did not pass the correct state to callback on removed from stage",
				ButtonState.UP, currentState);
		}

		[Test]
		public function testUpStateOnTouchPhaseMoveOutside():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			var hasCalledCallback:Boolean = false;
			var currentState:String = ButtonState.DOWN;
			this._touchToState.callback = function(value:String):void
			{
				if(currentState === value)
				{
					return;
				}
				hasCalledCallback = true;
				currentState = value;
			};
			touch.phase = TouchPhase.MOVED;
			touch.globalX = 1000;
			touch.globalY = position.y;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("TouchToState callback was not called on TouchPhase.MOVED outside",
				hasCalledCallback);
			Assert.assertStrictlyEquals("TouchToState did not change state to ButtonState.UP on TouchPhase.MOVED outside",
				ButtonState.UP, this._touchToState.currentState);
			Assert.assertStrictlyEquals("TouchToState did not pass the correct state to callback on TouchPhase.MOVED outside",
				ButtonState.UP, currentState);
		}

		[Test]
		public function testUpStateOnTouchPhaseMoveOutsideAndBackIn():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.MOVED;
			touch.globalX = 1000;
			touch.globalY = position.y;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			var hasCalledCallback:Boolean = false;
			var currentState:String = ButtonState.UP;
			this._touchToState.callback = function(value:String):void
			{
				if(currentState === value)
				{
					return;
				}
				hasCalledCallback = true;
				currentState = value;
			};
			touch.globalX = position.x;
			touch.globalY = position.y;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertTrue("TouchToState callback was not called on TouchPhase.MOVED outside and back in",
				hasCalledCallback);
			Assert.assertStrictlyEquals("TouchToState did not change state to ButtonState.DOWN on TouchPhase.MOVED outside and back in",
				ButtonState.DOWN, this._touchToState.currentState);
			Assert.assertStrictlyEquals("TouchToState did not pass the correct state to callback on TouchPhase.MOVED outside and back in",
				ButtonState.DOWN, currentState);
		}

		[Test]
		public function testDownStateOnTouchPhaseMoveOutsideAndKeepDownStateOnRollOut():void
		{
			this._touchToState.keepDownStateOnRollOut = true;
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			var hasCalledCallback:Boolean = false;
			var currentState:String = ButtonState.DOWN;
			this._touchToState.callback = function(value:String):void
			{
				if(currentState === value)
				{
					return;
				}
				hasCalledCallback = true;
				currentState = value;
			};
			touch.phase = TouchPhase.MOVED;
			touch.globalX = 1000;
			touch.globalY = position.y;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertFalse("TouchToState callback must not be called on TouchPhase.MOVED outside when keepDownStateOnRollOut is true",
				hasCalledCallback);
			Assert.assertStrictlyEquals("TouchToState must not change state on TouchPhase.MOVED outside when keepDownStateOnRollOut is true",
				ButtonState.DOWN, this._touchToState.currentState);
		}

		[Test]
		public function testHoverStateOnTouchEndedIfHoverBeforeBegan():void
		{
			var position:Point = new Point(10, 10);
			var target:DisplayObject = this._target.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.HOVER;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			touch.phase = TouchPhase.BEGAN;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			var currentState:String = ButtonState.DOWN;
			this._touchToState.callback = function(value:String):void
			{
				if(currentState === value)
				{
					return;
				}
				currentState = value;
			};
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));

			Assert.assertStrictlyEquals("TouchToState must change state to ButtonState.HOVER on TouchPhase.ENDED if TouchPhase.HOVER is dispatched before TouchPhase.BEGAN",
				ButtonState.HOVER, this._touchToState.currentState);
		}
	}
}


================================================
FILE: test/source/feathers/tests/TreeFocusTests.as
================================================
package feathers.tests
{
	import feathers.controls.Tree;
	import feathers.controls.renderers.DefaultTreeItemRenderer;
	import feathers.core.FocusManager;
	import feathers.data.HierarchicalCollection;

	import flash.events.KeyboardEvent;
	import flash.ui.KeyLocation;
	import flash.ui.Keyboard;

	import org.flexunit.Assert;

	import starling.display.Quad;
	import starling.events.Event;

	public class TreeFocusTests
	{
		private var _list:Tree;

		[Before]
		public function prepare():void
		{
			this._list = new Tree();
			this._list.dataProvider = new HierarchicalCollection(
			[
				{
					label: "A",
					children:
					[
						{
							label: "One",
							children:
							[
								{label: "I"},
								{label: "II"},
							]
						},
						{label: "Two"},
						{
							label: "Three",
							children:
							[
								{label: "III"},
								{label: "IV"},
								{label: "V"},
							]
						},
					]
				},
				{
					label: "B"
				},
			]);
			this._list.itemRendererFactory = function():DefaultTreeItemRenderer
			{
				var itemRenderer:DefaultTreeItemRenderer = new DefaultTreeItemRenderer();
				itemRenderer.defaultSkin = new Quad(200, 200);
				return itemRenderer;
			};
			TestFeathers.starlingRoot.addChild(this._list);
			this._list.validate();

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, true);
		}

		[After]
		public function cleanup():void
		{
			this._list.removeFromParent(true);
			this._list = null;

			FocusManager.setEnabledForStage(TestFeathers.starlingRoot.stage, false);

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
			Assert.assertFalse("FocusManager not disabled on cleanup.", FocusManager.isEnabledForStage(TestFeathers.starlingRoot.stage));
		}

		[Test]
		public function testNoTriggerWhenNoSelectedItem():void
		{
			FocusManager.focus = this._list;
			var hasTriggered:Boolean = false;
			var triggeredItem:Object = null;
			this._list.addEventListener(Event.TRIGGERED, function(event:Event, item:Object):void
			{
				hasTriggered = true;
				triggeredItem = item;
			});
			this._list.stage.starling.nativeStage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 32, Keyboard.SPACE, KeyLocation.STANDARD, false, false, false));
			this._list.stage.starling.nativeStage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, true, false, 32, Keyboard.SPACE, KeyLocation.STANDARD, false, false, false));
			Assert.assertFalse("Event.TRIGGERED incorrectly dispatched when no item is selected",
				hasTriggered);
		}

		[Test]
		public function testTriggered():void
		{
			this._list.selectedLocation = new <int>[0, 2, 1];
			FocusManager.focus = this._list;
			var hasTriggered:Boolean = false;
			var triggeredItem:Object = null;
			this._list.addEventListener(Event.TRIGGERED, function(event:Event, item:Object):void
			{
				hasTriggered = true;
				triggeredItem = item;
			});
			this._list.stage.starling.nativeStage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_DOWN, true, false, 32, Keyboard.SPACE, KeyLocation.STANDARD, false, false, false));
			this._list.stage.starling.nativeStage.dispatchEvent(new KeyboardEvent(KeyboardEvent.KEY_UP, true, false, 32, Keyboard.SPACE, KeyLocation.STANDARD, false, false, false));
			Assert.assertTrue("Event.TRIGGERED must be dispatched on KeyboardEvent.KEY_DOWN with Keyboard.SPACE key code",
				hasTriggered);
			Assert.assertStrictlyEquals("Incorrect item passed to Event.TRIGGERED listener",
				this._list.dataProvider.getItemAt(0, 2, 1), triggeredItem);
		}
	}
}

================================================
FILE: test/source/feathers/tests/TreeTests.as
================================================
package feathers.tests
{
	import feathers.controls.Tree;
	import feathers.controls.renderers.DefaultTreeItemRenderer;
	import starling.display.Quad;
	import feathers.data.ArrayHierarchicalCollection;
	import org.flexunit.Assert;
	import starling.events.Event;
	import flash.geom.Point;
	import starling.display.DisplayObject;
	import starling.events.Touch;
	import starling.events.TouchPhase;
	import starling.events.TouchEvent;
	import feathers.tests.supportClasses.AssertViewPortBoundsLayout;

	public class TreeTests
	{
		private var _tree:Tree;

		[Before]
		public function prepare():void
		{
			this._tree = new Tree();
			this._tree.dataProvider = new ArrayHierarchicalCollection(
			[
				{
					label: "A",
					children:
					[
						{
							label: "One",
							children:
							[
								{label: "I"},
								{label: "II"},
							]
						},
						{label: "Two"},
						{
							label: "Three",
							children:
							[
								{label: "III"},
								{label: "IV"},
								{label: "V"},
							]
						},
					]
				},
				{
					label: "B"
				},
			]);
			this._tree.itemRendererFactory = function():DefaultTreeItemRenderer
			{
				var itemRenderer:DefaultTreeItemRenderer = new DefaultTreeItemRenderer();
				itemRenderer.defaultSkin = new Quad(200, 200);
				return itemRenderer;
			};
			TestFeathers.starlingRoot.addChild(this._tree);
			this._tree.validate();
		}

		[After]
		public function cleanup():void
		{
			this._tree.removeFromParent(true);
			this._tree = null;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		[Test]
		public function testNullDataProvider():void
		{
			this._tree.dataProvider = null;
			this._tree.validate();
		}

		[Test]
		public function testNullDataProviderWithTypicalItem():void
		{
			this._tree.dataProvider = null;
			this._tree.typicalItem = { label: "Typical Item" };
			this._tree.validate();
		}

		[Test]
		public function testProgrammaticSelectedItemChange():void
		{
			var beforeSelectedLocation:Vector.<int> = this._tree.selectedLocation;
			var beforeSelectedItem:Object = this._tree.selectedItem;
			var hasChanged:Boolean = false;
			this._tree.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tree.selectedItem = this._tree.dataProvider.getItemAt(0);
			Assert.assertTrue("Tree: Event.CHANGE was not dispatched on set selectedItem", hasChanged);
			Assert.assertFalse("Tree: the selectedItem property was not changed",
				beforeSelectedItem === this._tree.selectedItem);
			Assert.assertStrictlyEquals("Tree: the selectedLocation property was not changed",
				1, this._tree.selectedLocation.length);
			Assert.assertStrictlyEquals("Tree: the selectedLocation property was not changed",
				0, this._tree.selectedLocation[0]);
		}

		[Test]
		public function testProgrammaticSelectedLocationChange():void
		{
			var beforeSelectedLocation:Vector.<int> = this._tree.selectedLocation;
			var beforeSelectedItem:Object = this._tree.selectedItem;
			var hasChanged:Boolean = false;
			this._tree.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tree.selectedLocation = new <int>[0];
			Assert.assertTrue("Tree: Event.CHANGE was not dispatched on set selectedItem", hasChanged);
			Assert.assertFalse("Tree: the selectedItem property was not changed",
				beforeSelectedItem === this._tree.selectedItem);
			Assert.assertStrictlyEquals("Tree: the selectedLocation property was not changed",
				1, this._tree.selectedLocation.length);
			Assert.assertStrictlyEquals("Tree: the selectedLocation property was not changed",
				0, this._tree.selectedLocation[0]);
		}

		[Test]
		public function testInteractiveSelectionChange():void
		{
			var beforeSelectedItem:Object = this._tree.selectedItem;
			var hasChanged:Boolean = false;
			this._tree.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var position:Point = new Point(10, 210);
			var target:DisplayObject = this._tree.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Tree: Event.CHANGE was not dispatched on touch to change selection", hasChanged);
			Assert.assertFalse("Tree: the selectedItem property was not changed",
				beforeSelectedItem === this._tree.selectedItem);
			Assert.assertStrictlyEquals("Tree: the selectedLocation property was not changed",
				1, this._tree.selectedLocation.length);
			Assert.assertStrictlyEquals("Tree: the selectedLocation property was not changed",
				1, this._tree.selectedLocation[0]);
		}

		[Test]
		public function testRemoveItemAfterSelectedItem():void
		{
			var beforeSelectedItem:Object = this._tree.dataProvider.getItemAt(1);
			this._tree.selectedItem = beforeSelectedItem;
			var hasChanged:Boolean = false;
			this._tree.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tree.dataProvider.removeItemAt(2);
			Assert.assertFalse("Tree: Event.CHANGE was incorrectly dispatched", hasChanged);
			Assert.assertStrictlyEquals("Tree: the selectedItem property was incorrectly changed",
				beforeSelectedItem, this._tree.selectedItem);
			Assert.assertStrictlyEquals("Tree: the selectedLocation property was incorrectly changed",
				1, this._tree.selectedLocation.length);
			Assert.assertStrictlyEquals("Tree: the selectedLocation property was incorrectly changed",
				1, this._tree.selectedLocation[0]);
		}

		[Test]
		public function testRemoveSelectedItem():void
		{
			var beforeSelectedItem:Object = this._tree.dataProvider.getItemAt(1);
			this._tree.selectedItem = beforeSelectedItem;
			var hasChanged:Boolean = false;
			this._tree.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tree.dataProvider.removeItemAt(1);
			Assert.assertTrue("Tree: Event.CHANGE was not dispatched on remove selected item", hasChanged);
			Assert.assertStrictlyEquals("Tree: the selectedItem property was not changed to null",
				null, this._tree.selectedItem);
			Assert.assertStrictlyEquals("Tree: the selectedLocation property was not changed to an empty vector",
				0, this._tree.selectedLocation.length);
		}

		[Test]
		public function testReplaceSelectedItem():void
		{
			var beforeSelectedItem:Object = this._tree.dataProvider.getItemAt(1);
			this._tree.selectedItem = beforeSelectedItem;
			var hasChanged:Boolean = false;
			this._tree.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tree.dataProvider.setItemAt({ label: "New Item" }, 1);
			Assert.assertTrue("Tree: Event.CHANGE was not dispatched on replace selected item", hasChanged);
			Assert.assertStrictlyEquals("Tree: the selectedItem property was not changed to null",
				null, this._tree.selectedItem);
			Assert.assertStrictlyEquals("Tree: the selectedLocation property was not changed to an empty vector",
				0, this._tree.selectedLocation.length);
		}

		[Test]
		public function testDeselectAllOnNullDataProvider():void
		{
			var beforeSelectedItem:Object = this._tree.dataProvider.getItemAt(1);
			this._tree.selectedItem = beforeSelectedItem;
			var hasChanged:Boolean = false;
			this._tree.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tree.dataProvider = null;
			Assert.assertTrue("Tree: Event.CHANGE was not dispatched on set dataProvider to null", hasChanged);
			Assert.assertStrictlyEquals("Tree: the selectedItem property was not set to null",
				null, this._tree.selectedItem);
			Assert.assertStrictlyEquals("Tree: the selectedLocation property was not changed to an empty vector",
				0, this._tree.selectedLocation.length);
		}

		[Test]
		public function testDeselectAllOnDataProviderRemoveAll():void
		{
			var beforeSelectedItem:Object = this._tree.dataProvider.getItemAt(1);
			this._tree.selectedItem = beforeSelectedItem;
			var hasChanged:Boolean = false;
			this._tree.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tree.dataProvider.removeAll();
			Assert.assertTrue("Tree: Event.CHANGE was not dispatched on dataProvider.removeAll()", hasChanged);
			Assert.assertStrictlyEquals("Tree: the selectedItem property was not set to null",
				null, this._tree.selectedItem);
			Assert.assertStrictlyEquals("Tree: the selectedLocation property was not changed to an empty vector",
				0, this._tree.selectedLocation.length);
		}

		[Test]
		public function testDisposeWithoutChangeEvent():void
		{
			var beforeSelectedItem:Object = this._tree.dataProvider.getItemAt(1);
			this._tree.selectedItem = beforeSelectedItem;
			var hasChanged:Boolean = false;
			this._tree.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			this._tree.dispose();
			Assert.assertFalse("Tree: Event.CHANGE was incorrectly dispatched on dispose()", hasChanged);
		}

		[Test]
		public function testViewPortBoundsValues():void
		{
			this._tree.layout = new AssertViewPortBoundsLayout();
			this._tree.validate();
		}

		[Test]
		public function testTriggeredByTap():void
		{
			var hasTriggered:Boolean = false;
			var triggeredItem:Object = null;
			this._tree.addEventListener(Event.TRIGGERED, function(event:Event, item:Object):void
			{
				hasTriggered = true;
				triggeredItem = item;
			});
			var position:Point = new Point(10, 210);
			var target:DisplayObject = this._tree.stage.hitTest(position);
			var touch:Touch = new Touch(0);
			touch.target = target;
			touch.phase = TouchPhase.BEGAN;
			touch.globalX = position.x;
			touch.globalY = position.y;
			var touches:Vector.<Touch> = new <Touch>[touch];
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			//this touch does not move at all, so it should result in triggering
			//the button.
			touch.phase = TouchPhase.ENDED;
			target.dispatchEvent(new TouchEvent(TouchEvent.TOUCH, touches));
			Assert.assertTrue("Event.TRIGGERED was not dispatched", hasTriggered);
			Assert.assertStrictlyEquals("Incorrect item passed to Event.TRIGGERED listener",
				this._tree.dataProvider.getItemAt(1), triggeredItem);
		}
	}
}

================================================
FILE: test/source/feathers/tests/VectorCollectionTests.as
================================================
package feathers.tests
{
	import feathers.data.VectorCollection;
	import feathers.events.CollectionEventType;

	import org.flexunit.Assert;

	import starling.events.Event;

	public class VectorCollectionTests
	{
		private var _collection:VectorCollection;
		private var _a:Object;
		private var _b:Object;
		private var _c:Object;
		private var _d:Object;

		[Before]
		public function prepare():void
		{
			this._a = { label: "One", value: 0 };
			this._b = { label: "Two", value: 2 };
			this._c = { label: "Three", value: 3 };
			this._d = { label: "Four", value: 1 };
			this._collection = new VectorCollection(new <Object>
			[
				this._a,
				this._b,
				this._c,
				this._d,
			]);
		}

		[After]
		public function cleanup():void
		{
			this._collection = null;
		}

		private function filterFunction(item:Object):Boolean
		{
			if(item === this._a || item === this._c)
			{
				return false;
			}
			return true;
		}

		private function sortCompareFunction(a:Object, b:Object):int
		{
			var valueA:Number = a.value as Number;
			var valueB:Number = b.value as Number;
			if(valueA < valueB)
			{
				return -1;
			}
			if(valueA > valueB)
			{
				return 1;
			}
			return 0;
		}

		[Test]
		public function testRemoveAll():void
		{
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedAll:Boolean = false;
			this._collection.addEventListener(CollectionEventType.REMOVE_ALL, function(event:Event):void
			{
				hasRemovedAll = true;
			});
			var hasReset:Boolean = false;
			this._collection.addEventListener(CollectionEventType.RESET, function(event:Event):void
			{
				hasReset = true;
			});
			this._collection.removeAll();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			//reset used to be dispatched, but REMOVE_ALL is better
			Assert.assertFalse("CollectionEventType.RESET was incorrectly dispatched", hasReset);
			Assert.assertTrue("CollectionEventType.REMOVE_ALL was not dispatched", hasRemovedAll);
			Assert.assertStrictlyEquals("The length property was not changed to 0",
				0, this._collection.length);
		}

		[Test]
		public function testRemoveItemAt():void
		{
			var itemToRemove:Object = this._collection.getItemAt(1);
			var originalLength:int = this._collection.length;
			var expectedIndex:int = 1;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				hasRemovedItem = true;
				indexFromEvent = index;
			});
			this._collection.removeItemAt(expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength - 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not removed",
				-1, this._collection.getItemIndex(itemToRemove));
			Assert.assertStrictlyEquals("The CollectionEventType.REMOVE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testRemoveItem():void
		{
			var expectedIndex:int = 1;
			var itemToRemove:Object = this._collection.getItemAt(expectedIndex);
			var originalLength:int = this._collection.length;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				hasRemovedItem = true;
				indexFromEvent = index;
			});
			this._collection.removeItem(itemToRemove);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength - 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not removed",
				-1, this._collection.getItemIndex(itemToRemove));
			Assert.assertStrictlyEquals("The CollectionEventType.REMOVE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testShift():void
		{
			var itemToRemove:Object = this._collection.getItemAt(0);
			var originalLength:int = this._collection.length;
			var expectedIndex:int = 0;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				hasRemovedItem = true;
				indexFromEvent = index;
			});
			this._collection.shift();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength - 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not removed",
				-1, this._collection.getItemIndex(itemToRemove));
			Assert.assertStrictlyEquals("The CollectionEventType.REMOVE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testPop():void
		{
			var originalLength:int = this._collection.length;
			var itemToRemove:Object = this._collection.getItemAt(originalLength - 1);
			var expectedIndex:int = originalLength - 1;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				hasRemovedItem = true;
				indexFromEvent = index;
			});
			this._collection.pop();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength - 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not removed",
				-1, this._collection.getItemIndex(itemToRemove));
			Assert.assertStrictlyEquals("The CollectionEventType.REMOVE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testAddItem():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var originalLength:int = this._collection.length;
			var expectedIndex:int = originalLength;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.addItem(itemToAdd);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength + 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.ADD_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testAddItemAt():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.length;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.addItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength + 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.ADD_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testUnshift():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var expectedIndex:int = 0;
			var originalLength:int = this._collection.length;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.unshift(itemToAdd);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength + 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.ADD_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testPush():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var originalLength:int = this._collection.length;
			var expectedIndex:int = originalLength;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.push(itemToAdd);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength + 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.ADD_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testSetItemAt():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.length;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.setItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalLength, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.REPLACE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testContainsWithItemInCollection():void
		{
			var item:Object = this._collection.getItemAt(1);
			Assert.assertStrictlyEquals("contains() incorrectly returned false",
				true, this._collection.contains(item));
		}

		[Test]
		public function testContainsWithItemNotInCollection():void
		{
			var item:Object = {};
			Assert.assertStrictlyEquals("contains() incorrectly returned true",
				false, this._collection.contains(item));
		}

		[Test]
		public function testGetItemIndexWithItemInCollection():void
		{
			var expectedIndex:int = 1;
			var item:Object = this._collection.getItemAt(expectedIndex);
			Assert.assertStrictlyEquals("getItemIndex() returned the incorrect value",
				expectedIndex, this._collection.getItemIndex(item));
		}

		[Test]
		public function testGetItemIndexWithItemNotInCollection():void
		{
			var item:Object = {};
			Assert.assertStrictlyEquals("getItemIndex() returned the incorrect value",
				-1, this._collection.getItemIndex(item));
		}

		[Test]
		public function testDispose():void
		{
			var itemCount:int = this._collection.length;
			var disposedCount:int = 0;
			this._collection.dispose(function(item:Object):void
			{
				item.isDisposed = true;
				disposedCount++;
			});
			Assert.assertStrictlyEquals("Incorrect number of items disposed when calling dispose() on VectorCollection",
				itemCount, disposedCount);
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = this._collection.getItemAt(i);
				Assert.assertTrue("Item was not included when calling dispose() on VectorCollection", item.isDisposed);
			}
		}

		[Test]
		public function testDisposeWithFilterFunction():void
		{
			var itemCount:int = this._collection.length;
			this._collection.filterFunction = function(item:Object):Boolean
			{
				return item.label.charAt(0) === "O";
			};
			var filteredCount:int = this._collection.length;
			Assert.assertFalse("Filtered collection length must change", itemCount === filteredCount);
			var disposedCount:int = 0;
			this._collection.dispose(function(item:Object):void
			{
				item.isDisposed = true;
				disposedCount++;
			});
			Assert.assertStrictlyEquals("Incorrect number of items disposed when calling dispose() on VectorCollection",
				itemCount, disposedCount);
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = this._collection.getItemAt(i);
				Assert.assertTrue("Item was not included when calling dispose() on VectorCollection", item.isDisposed);
			}
		}

		[Test]
		public function testSortCompareFunction():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			Assert.assertStrictlyEquals("VectorCollection: sortCompareFunction order is incorrect.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("VectorCollection: sortCompareFunction order is incorrect.",
				this._d, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("VectorCollection: sortCompareFunction order is incorrect.",
				this._b, this._collection.getItemAt(2));
			Assert.assertStrictlyEquals("VectorCollection: sortCompareFunction order is incorrect.",
				this._c, this._collection.getItemAt(3));
		}

		[Test]
		public function testSortCompareFunctionAndFilterFunction():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.filterFunction = this.filterFunction;
			Assert.assertStrictlyEquals("VectorCollection: sortCompareFunction and filterFunction length is incorrect.",
				2, this._collection.length);
			Assert.assertStrictlyEquals("VectorCollection: sortCompareFunction order is incorrect with filterFunction.",
				this._d, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("VectorCollection: sortCompareFunction order is incorrect with filterFunction.",
				this._b, this._collection.getItemAt(1));
		}

		[Test]
		public function testSetSortCompareFunctionToNull():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			//get an item so that we know the sorting was applied
			Assert.assertStrictlyEquals("VectorCollection: sortCompareFunction order is incorrect.",
				this._c, this._collection.getItemAt(3));

			this._collection.sortCompareFunction = null;
			Assert.assertStrictlyEquals("VectorCollection: set sortCompareFunction to null order is incorrect.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("VectorCollection: set sortCompareFunction to null order is incorrect.",
				this._b, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("VectorCollection: set sortCompareFunction to null order is incorrect.",
				this._c, this._collection.getItemAt(2));
			Assert.assertStrictlyEquals("VectorCollection: set sortCompareFunction to null order is incorrect.",
				this._d, this._collection.getItemAt(3));
		}

		[Test]
		public function testSortCompareFunctionWithAddItem():void
		{
			var newItem:Object = { label: "New Item", value: 1.5 };
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.addItem(newItem);

			Assert.assertStrictlyEquals("VectorCollection: addItem() with sortCompareFunction does not add at correct sorted index.",
				newItem, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			Assert.assertStrictlyEquals("VectorCollection: addItem() with sortCompareFunction does not add at correct unsorted index.",
				newItem, this._collection.getItemAt(4));
		}

		[Test]
		public function testSortCompareFunctionWithAddItemAt():void
		{
			var newItem:Object = { label: "New Item", value: 1.5 };
			var newIndex:int = 1;
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.addItemAt(newItem, newIndex);

			//the index we passed in isn't necessarily the same while sorted
			Assert.assertStrictlyEquals("VectorCollection: addItemAt() with sortCompareFunction does not add at correct sorted index.",
				newItem, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			//and it might not even be the same while unsorted!
			//that's because, in the unsorted data, it will be placed relative
			//to the item in the sorted data that was at the index passed to
			//addItemAt(). confusing, but it's consistent with setItemAt() and
			//filtered collections
			Assert.assertStrictlyEquals("VectorCollection: addItemAt() with sortCompareFunction does not add at correct unsorted index.",
				newItem, this._collection.getItemAt(3));
		}

		[Test]
		public function testSortCompareFunctionWithRemoveItemAt():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.removeItemAt(2);

			Assert.assertStrictlyEquals("VectorCollection: removeItemAt() with sortCompareFunction removed incorrect item in sorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("VectorCollection: removeItemAt() with sortCompareFunction removed incorrect item in sorted data.",
				this._d, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("VectorCollection: removeItemAt() with sortCompareFunction removed incorrect item in sorted data.",
				this._c, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			Assert.assertStrictlyEquals("VectorCollection: removeItemAt() with sortCompareFunction removed incorrect item in unsorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("VectorCollection: removeItemAt() with sortCompareFunction removed incorrect item in unsorted data.",
				this._c, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("VectorCollection: removeItemAt() with sortCompareFunction removed incorrect item in unsorted data.",
				this._d, this._collection.getItemAt(2));
		}

		[Test]
		public function testSortCompareFunctionWithRemoveItem():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.removeItem(this._b);

			Assert.assertStrictlyEquals("VectorCollection: removeItem() with sortCompareFunction removed incorrect item in sorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("VectorCollection: removeItem() with sortCompareFunction removed incorrect item in sorted data.",
				this._d, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("VectorCollection: removeItem() with sortCompareFunction removed incorrect item in sorted data.",
				this._c, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			Assert.assertStrictlyEquals("VectorCollection: removeItem() with sortCompareFunction removed incorrect item in unsorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("VectorCollection: removeItem() with sortCompareFunction removed incorrect item in unsorted data.",
				this._c, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("VectorCollection: removeItem() with sortCompareFunction removed incorrect item in unsorted data.",
				this._d, this._collection.getItemAt(2));
		}

		[Test]
		public function testSortCompareFunctionWithSetItemAt():void
		{
			var newItem:Object = { label: "New Item", value: 1.5 };
			var newIndex:int = 0;
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.setItemAt(newItem, newIndex);

			//the index we passed in isn't necessarily the same while sorted
			Assert.assertStrictlyEquals("VectorCollection: setItemAt() with sortCompareFunction does not add at correct sorted index.",
				newItem, this._collection.getItemAt(1));
			Assert.assertFalse("VectorCollection: setItemAt() with sortCompareFunction does not replace correct item.",
				this._collection.contains(this._a));

			this._collection.sortCompareFunction = null;

			//however, that index should be the same when the collection is unsorted
			Assert.assertStrictlyEquals("VectorCollection: setItemAt() with sortCompareFunction does not add at correct unsorted index.",
				newItem, this._collection.getItemAt(newIndex));
		}
	}
}



================================================
FILE: test/source/feathers/tests/VectorHierarchicalCollectionTests.as
================================================
package feathers.tests
{
	import feathers.data.VectorHierarchicalCollection;
	import feathers.events.CollectionEventType;

	import org.flexunit.Assert;

	import starling.events.Event;

	public class VectorHierarchicalCollectionTests
	{
		private var _collection:VectorHierarchicalCollection;

		[Before]
		public function prepare():void
		{
			this._collection = new VectorHierarchicalCollection(new <Object>
			[
				{
					label: "1",
					children: new <Object>
					[
						{label: "1-A"},
						{
							label: "1-B",
							children: new <Object>
							[
								{label: "1-B-I"},
							]
						},
						{label: "1-C"},
					]
				},
				{
					label: "2",
					children: new <Object>
					[
						{label: "2-A"},
					]
				},
				{ label: "3" },
				{
					label: "4",
					children: new <Object>
					[
						{label: "4-A"},
						{label: "4-B"},
					]
				},
			]);
		}

		[After]
		public function cleanup():void
		{
			this._collection = null;
		}

		[Test]
		public function testGetLength():void
		{
			var length:int = this._collection.getLength();
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: getLengthAtLocation() returned incorrect length",
				4, length);
		}

		[Test]
		public function testGetLengthNested():void
		{
			var length:int = this._collection.getLength(3);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: getLengthAtLocation() returned incorrect length",
				2, length);
		}

		[Test]
		public function testGetLengthAtLocationWithNull():void
		{
			var length:int = this._collection.getLengthAtLocation();
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: getLengthAtLocation() returned incorrect length",
				4, length);
		}

		[Test]
		public function testGetItemAt():void
		{
			var item:Object = this._collection.getItemAt(1);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: getItemAt() returned incorrect item",
				this._collection.vectorData[1], item);
		}

		[Test]
		public function testGetItemAtNested():void
		{
			var item:Object = this._collection.getItemAt(0, 1);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: getItemAt() returned incorrect item",
				this._collection.vectorData[0].children[1], item);
		}

		[Test]
		public function testGetItemAtLocation():void
		{
			var indices:Vector.<int> = new <int>[1];
			var item:Object = this._collection.getItemAtLocation(indices);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: getItemAtLocation() returned incorrect item",
				this._collection.vectorData[1], item);
		}

		[Test]
		public function testGetItemAtNestedLocation():void
		{
			var indices:Vector.<int> = new <int>[0, 1];
			var item:Object = this._collection.getItemAtLocation(indices);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: getItemAtLocation() returned incorrect item",
				this._collection.vectorData[0].children[1], item);
		}

		[Test]
		public function testGetItemAtNullLocation():void
		{
			var item:Object = this._collection.getItemAtLocation(null);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: getItemAtLocation() returned incorrect item",
				null, item);
		}

		[Test]
		public function testGetItemAtEmptyLocation():void
		{
			var indices:Vector.<int> = new <int>[];
			var item:Object = this._collection.getItemAtLocation(indices);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: getItemAtLocation() returned incorrect item",
				null, item);
		}

		[Test]
		public function testRemoveAll():void
		{
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedAll:Boolean = false;
			this._collection.addEventListener(CollectionEventType.REMOVE_ALL, function(event:Event):void
			{
				hasRemovedAll = true;
			});
			var hasReset:Boolean = false;
			this._collection.addEventListener(CollectionEventType.RESET, function(event:Event):void
			{
				hasReset = true;
			});
			this._collection.removeAll();
			Assert.assertTrue("VectorHierarchicalCollection: Event.CHANGE was not dispatched after removeAll()", hasChanged);
			Assert.assertFalse("VectorHierarchicalCollection: CollectionEventType.RESET was incorrectly dispatched after removeAll()", hasReset);
			Assert.assertTrue("VectorHierarchicalCollection: CollectionEventType.REMOVE_ALL was not dispatched after removeAll()", hasRemovedAll);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: the getLength() value was not changed to 0 after removeAll()",
				0, this._collection.getLength());
		}

		[Test]
		public function testRemoveItemAtLocation():void
		{
			var indicesToRemove:Vector.<int> = new <int>[1];
			var itemToRemove:Object = this._collection.getItemAtLocation(indicesToRemove);
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItemAtLocation(indicesToRemove);
			Assert.assertTrue("VectorHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("VectorHierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The getLength() value was not changed",
				originalLength - 1, this._collection.getLength());
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("VectorHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				indicesToRemove[0], indicesFromEvent[0]);
		}

		[Test]
		public function testRemoveItemAtNestedLocation():void
		{
			var indicesToRemove:Vector.<int> = new <int>[0, 1];
			var itemToRemove:Object = this._collection.getItemAtLocation(indicesToRemove);
			var originalParentLength:int = this._collection.getLength(indicesToRemove[0]);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItemAtLocation(indicesToRemove);
			Assert.assertTrue("VectorHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("VectorHierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The getLength() value was not changed",
				originalParentLength - 1, this._collection.getLength(indicesToRemove[0]));
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("VectorHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				indicesToRemove[0], indicesFromEvent[0]);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				indicesToRemove[1], indicesFromEvent[1]);
		}

		[Test(expects="RangeError")]
		public function testRemoveItemAtNullLocation():void
		{
			this._collection.removeItemAtLocation(null);
		}

		[Test(expects="RangeError")]
		public function testRemoveItemAtEmptyLocation():void
		{
			var indices:Vector.<int> = new <int>[];
			this._collection.removeItemAtLocation(indices);
		}

		[Test]
		public function testRemoveItemAt():void
		{
			var itemToRemove:Object = this._collection.getItemAt(1);
			var originalLength:int = this._collection.getLength();
			var expectedIndex:int = 1;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItemAt(expectedIndex);
			Assert.assertTrue("VectorHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("VectorHierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The getLength() value was not changed",
				originalLength - 1, this._collection.getLength());
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("VectorHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testRemoveItem():void
		{
			var expectedIndex:int = 1;
			var itemToRemove:Object = this._collection.getItemAt(expectedIndex);
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItem(itemToRemove);
			Assert.assertTrue("VectorHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("VectorHierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The getLength() value was not changed",
				originalLength - 1, this._collection.getLength());
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("VectorHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testAddItemAtLocation():void
		{
			var location:Vector.<int> = new <int>[1];
			var itemToAdd:Object = { label: "New Item" };
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAtLocation(itemToAdd, location);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The getLength() value was not changed",
				originalLength + 1, this._collection.getLength());
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not added",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not added at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("VectorHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
		}

		[Test]
		public function testAddItemAtNestedLocation():void
		{
			var location:Vector.<int> = new <int>[0, 1];
			var itemToAdd:Object = { label: "New Item" };
			var originalParentLength:int = this._collection.getLength(location[0]);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAtLocation(itemToAdd, location);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The getLength() value was not changed",
				originalParentLength + 1, this._collection.getLength(location[0]));
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not added",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not added at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not added at the correct index",
				location[1], this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("VectorHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				location[1], indicesFromEvent[1]);
		}

		[Test(expects="RangeError")]
		public function testAddItemAtNullLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			this._collection.addItemAtLocation(itemToAdd, null);
		}

		[Test(expects="RangeError")]
		public function testAddItemAtEmptyLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var indices:Vector.<int> = new <int>[];
			this._collection.addItemAtLocation(itemToAdd, indices);
		}

		[Test]
		public function testAddItemAt():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The getLength() value was not changed",
				originalLength + 1, this._collection.getLength());
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not added",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not added at the correct index",
				expectedIndex, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("VectorHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testAddItemAtNested():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var originalParentLength:int = this._collection.getLength(0);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAt(itemToAdd, 0, 1);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The getLength() value was not changed",
				originalParentLength + 1, this._collection.getLength(0));
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not added",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not added at the correct index",
				0, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not added at the correct index",
				1, this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("VectorHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				0, indicesFromEvent[0]);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[1]);
		}

		[Test]
		public function testSetItemAt():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalLength, this._collection.getLength());
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not replaced",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not replaced at the correct index",
				expectedIndex, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("VectorHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testSetItemAtNested():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var originalParentLength:int = this._collection.getLength(0);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAt(itemToAdd, 0, 1);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalParentLength, this._collection.getLength(0));
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not replaced",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not replaced at the correct index",
				0, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not replaced at the correct index",
				1, this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("VectorHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				0, indicesFromEvent[0]);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[1]);
		}

		[Test]
		public function testSetItemAtLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var location:Vector.<int> = new <int>[1];
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAtLocation(itemToAdd, location);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalLength, this._collection.getLength());
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not replaced",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not replaced at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("VectorHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
		}

		[Test]
		public function testSetItemAtNestedLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var location:Vector.<int> = new <int>[0, 1];
			var originalParentLength:int = this._collection.getLength(location[0]);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAtLocation(itemToAdd, location);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalParentLength, this._collection.getLength(location[0]));
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not replaced",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not replaced at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The item was not replaced at the correct index",
				location[1], this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("VectorHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				location[1], indicesFromEvent[1]);
		}

		[Test(expects="RangeError")]
		public function testSetItemAtNullLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			this._collection.setItemAtLocation(itemToAdd, null);
		}

		[Test(expects="RangeError")]
		public function testSetItemAtEmptyLocation():void
		{
			var itemToAdd:Object = { label: "New Item" };
			var indices:Vector.<int> = new <int>[];
			this._collection.setItemAtLocation(itemToAdd, indices);
		}

		[Test]
		public function testGetItemLocationWithItemInCollection():void
		{
			var expectedIndex:int = 1;
			var item:Object = this._collection.getItemAt(expectedIndex);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: getItemLocation() returned the incorrect location (length)",
				1, this._collection.getItemLocation(item).length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: getItemLocation() returned the incorrect location (value)",
				expectedIndex, this._collection.getItemLocation(item)[0]);
		}

		[Test]
		public function testGetItemLocationNestedWithItemInCollection():void
		{
			var location:Vector.<int> = new <int>[0, 1];
			var item:Object = this._collection.getItemAtLocation(location);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: getItemLocation() returned the incorrect location (length)",
				location.length, this._collection.getItemLocation(item).length);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: getItemLocation() returned the incorrect location (value)",
				location[0], this._collection.getItemLocation(item)[0]);
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: getItemLocation() returned the incorrect location (value)",
				location[1], this._collection.getItemLocation(item)[1]);
		}

		[Test]
		public function testGetItemLocationWithItemNotInCollection():void
		{
			var item:Object = {};
			Assert.assertStrictlyEquals("VectorHierarchicalCollection: getItemLocation() returned the incorrect location (length)",
				0, this._collection.getItemLocation(item).length);
		}
	}
}

================================================
FILE: test/source/feathers/tests/VerticalCenteredPopUpContentManagerTests.as
================================================
package feathers.tests
{
	import feathers.controls.popups.VerticalCenteredPopUpContentManager;
	import feathers.core.PopUpManager;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;
	import starling.display.Sprite;
	import starling.events.Event;

	public class VerticalCenteredPopUpContentManagerTests
	{
		private static const OVERLAY_NAME:String = "VerticalCenteredPopUpContentManagerOverlay";
		
		private var _popUp:DisplayObject;
		private var _customRoot:Sprite;
		private var _source:Quad;
		private var _popUpContentManager:VerticalCenteredPopUpContentManager;

		[Before]
		public function prepare():void
		{
			this._source = new Quad(200, 180, 0x00ff00);
			TestFeathers.starlingRoot.addChild(this._source);

			this._customRoot = new Sprite();
			TestFeathers.starlingRoot.addChild(this._customRoot);
			PopUpManager.root = this._customRoot;

			this._popUpContentManager = new VerticalCenteredPopUpContentManager();
		}

		[After]
		public function cleanup():void
		{
			this._source.removeFromParent(true);
			this._source = null;

			this._customRoot.removeFromParent(true);
			this._customRoot = null;

			if(this._popUp)
			{
				this._popUp.removeFromParent(true);
				this._popUp = null;
			}
			
			PopUpManager.root = TestFeathers.starlingRoot.stage;

			Assert.assertStrictlyEquals("Child not removed from Starling root on cleanup.", 0, TestFeathers.starlingRoot.numChildren);
		}

		private function createSimplePopUp():DisplayObject
		{
			var simplePopUp:Quad = new Quad(100, 150, 0xff00ff);
			return simplePopUp;
		}

		private function createOverlay():DisplayObject
		{
			var overlay:Quad = new Quad(1, 1, 0x000000);
			overlay.alpha = 0.5;
			overlay.name = OVERLAY_NAME;
			return overlay;
		}

		[Test]
		public function testOpen():void
		{
			this._popUp = this.createSimplePopUp();
			var openDispatched:Boolean = false;
			this._popUpContentManager.addEventListener(Event.OPEN, function(event:Event):void
			{
				openDispatched = true;
			});
			this._popUpContentManager.open(this._popUp, this._source);
			Assert.assertNotNull("VerticalCenteredPopUpContentManager content parent should not be null.", this._popUp.parent);
			Assert.assertTrue("VerticalCenteredPopUpContentManager did not dispatch Event.OPEN.", openDispatched);
		}

		[Test]
		public function testClose():void
		{
			this._popUp = this.createSimplePopUp();
			var closeDispatched:Boolean = false;
			this._popUpContentManager.addEventListener(Event.CLOSE, function(event:Event):void
			{
				closeDispatched = true;
			});
			this._popUpContentManager.open(this._popUp, this._source);
			this._popUpContentManager.close();
			Assert.assertNull("VerticalCenteredPopUpContentManager content parent should be null.", this._popUp.parent);
			Assert.assertTrue("VerticalCenteredPopUpContentManager did not dispatch Event.CLOSE.", closeDispatched);
		}

		[Test]
		public function testOverlayFactory():void
		{
			this._popUp = this.createSimplePopUp();
			this._popUpContentManager.overlayFactory = this.createOverlay;
			this._popUpContentManager.open(this._popUp, this._source);
			var overlay:DisplayObject = this._customRoot.getChildByName(OVERLAY_NAME);
			Assert.assertNotNull("DropDownPopUpContentManager overlayFactory result not found.", overlay);
		}
	}
}


================================================
FILE: test/source/feathers/tests/VerticalLayoutTests.as
================================================
package feathers.tests
{
	import feathers.controls.Label;
	import feathers.controls.LayoutGroup;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.VerticalLayout;
	import feathers.layout.VerticalLayoutData;
	import feathers.layout.ViewPortBounds;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;

	public class VerticalLayoutTests
	{
		private var _layout:VerticalLayout;

		[Before]
		public function prepare():void
		{
			this._layout = new VerticalLayout();
			this._layout.useVirtualLayout = false;
		}

		[After]
		public function cleanup():void
		{
			this._layout = null;
		}

		[Test]
		public function testNoRuntimeErrorOnScrollBeyondStickyHeaderInLayout():void
		{
			this._layout.headerIndices = new <int>[0];
			this._layout.stickyHeader = true;
			var item1:Quad = new Quad(200, 200);
			var item2:Quad = new Quad(200, 200);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = 640;
			bounds.scrollY = 100;
			this._layout.layout(items, bounds);
		}

		[Test]
		public function testNoRuntimeErrorOnScrollBeyondStickyHeaderInGetVisibleIndicesAtScrollPosition():void
		{
			this._layout.useVirtualLayout = true;
			this._layout.headerIndices = new <int>[0];
			this._layout.stickyHeader = true;
			this._layout.hasVariableItemDimensions = true;
			var item1:Quad = new Quad(200, 200);
			this._layout.typicalItem = item1;
			this._layout.getVisibleIndicesAtScrollPosition(0, 210, 640, 640, 2);
		}

		[Test]
		public function testVisibleIndicesOnScrollBeyondStickyHeader():void
		{
			this._layout.useVirtualLayout = true;
			this._layout.headerIndices = new <int>[0, 20];
			this._layout.stickyHeader = true;
			this._layout.hasVariableItemDimensions = true;
			var item1:Quad = new Quad(200, 200);
			this._layout.typicalItem = item1;
			var result:Vector.<int> = this._layout.getVisibleIndicesAtScrollPosition(0, 810, 640, 640, 30);
			Assert.assertTrue("getVisibleIndicesAtScrollPosition() does not return correct sticky header", result.indexOf(0) == 0);
			Assert.assertTrue("getVisibleIndicesAtScrollPosition() returns incorrect sticky header", result.indexOf(20) == -1);
		}

		[Test]
		public function testPercentHeightWithOneItem():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:VerticalLayoutData = new VerticalLayoutData(NaN, 50);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayoutData with percentHeight results in incorrect item height", viewPortHeight / 2, item1.height);
		}

		[Test]
		public function testPercentHeightGreaterThan100WithOneItem():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:VerticalLayoutData = new VerticalLayoutData(NaN, 200);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayoutData with percentHeight > 100 not clamped to 100", viewPortHeight, item1.height);
		}

		[Test]
		public function testPercentHeightLessThan0WithOneItem():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:VerticalLayoutData = new VerticalLayoutData(NaN, -50);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayoutData with percentHeight < 0 not clamped to 0", 0, item1.height);
		}

		[Test]
		public function testPercentHeightWithTwoItems():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var item1Percent:Number = 50;
			var layoutData1:VerticalLayoutData = new VerticalLayoutData(NaN, item1Percent);
			item1.layoutData = layoutData1;
			var item2:LayoutGroup = new LayoutGroup();
			var item2Percent:Number = 25;
			var layoutData2:VerticalLayoutData = new VerticalLayoutData(NaN, item2Percent);
			item2.layoutData = layoutData2;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayoutData with percentHeight results in incorrect item height for first item (of 2)", viewPortHeight / (100 / item1Percent), item1.height);
			Assert.assertStrictlyEquals("VerticalLayoutData with percentHeight results in incorrect item height for second item (of 2)", viewPortHeight / (100 / item2Percent), item2.height);
		}

		[Test]
		public function testPercentHeightGreaterThan100WithTwoItems():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var item1Percent:Number = 100;
			var layoutData1:VerticalLayoutData = new VerticalLayoutData(NaN, item1Percent);
			item1.layoutData = layoutData1;
			var item2:LayoutGroup = new LayoutGroup();
			var item2Percent:Number = 150;
			var layoutData2:VerticalLayoutData = new VerticalLayoutData(NaN, item2Percent);
			item2.layoutData = layoutData2;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			var totalPercent:Number = item1Percent + item2Percent;
			Assert.assertStrictlyEquals("VerticalLayoutData with percentHeight > 100 results in incorrect item height for first item (of 2)", viewPortHeight / (totalPercent / item1Percent), item1.height);
			Assert.assertStrictlyEquals("VerticalLayoutData with percentHeight > 100 results in incorrect item height for second item (of 2)", viewPortHeight / (totalPercent / item2Percent), item2.height);
		}

		[Test]
		public function testPercentWidth():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:VerticalLayoutData = new VerticalLayoutData(50);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayoutData with percentWidth results in incorrect item width", viewPortWidth / 2, item1.width);
		}

		[Test]
		public function testPercentWidthGreaterThan100():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:VerticalLayoutData = new VerticalLayoutData(150);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayoutData with percentWidth > 100 does not clamp to 100", viewPortWidth, item1.width);
		}

		[Test]
		public function testPercentWidthLessThan0():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var layoutData1:VerticalLayoutData = new VerticalLayoutData(-50);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayoutData with percentWidth < 0 does not clamp to 0", 0, item1.width);
		}

		[Test]
		public function testPercentWidthWithWrappingLabelAndMaxWidth():void
		{
			var viewPortMaxWidth:Number = 100;
			var item1:Label = new Label();
			item1.text = "I am the very model of a modern Major General";
			item1.wordWrap = true;
			item1.validate();
			var unwrappedWidth:Number = item1.width;
			var unwrappedHeight:Number = item1.height;
			var layoutData1:VerticalLayoutData = new VerticalLayoutData();
			layoutData1.percentWidth = 100;
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.maxWidth = viewPortMaxWidth;
			this._layout.layout(items, bounds);
			//since we're setting maxWidth, the width may actually be smaller
			Assert.assertTrue("VerticalLayoutData with percentWidth with a wrapping Label results in incorrect width",
				viewPortMaxWidth >= item1.width);
			//we're only checking that it has more than one line
			Assert.assertTrue("VerticalLayoutData with percentWidth on a wrapping Label results in height that is too small",
				unwrappedHeight < item1.height);
		}

		[Test]
		public function testPercentWidthWithExplicitMinWidth():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			item1.minWidth = 400;
			var layoutData1:VerticalLayoutData = new VerticalLayoutData(50, NaN);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayoutData with percentWidth and larger item explicitMinWidth results in incorrect item width",
				400, item1.width);
		}

		[Test]
		public function testPercentHeightWithExplicitMinHeight():void
		{
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			item1.minHeight = 400;
			var layoutData1:VerticalLayoutData = new VerticalLayoutData(NaN, 50);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayoutData with percentHeight and larger item explicitMinHeight results in incorrect item height",
				400, item1.height);
		}

		[Test]
		public function testPercentWidthWithExplicitMaxWidth():void
		{
			var viewPortWidth:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			item1.maxWidth = 250;
			var layoutData1:VerticalLayoutData = new VerticalLayoutData(50, NaN);
			item1.layoutData = layoutData1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = viewPortWidth;
			bounds.explicitHeight = 640;
			this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayoutData with percentWidth and smaller item explicitMaxWidth results in incorrect item width",
				250, item1.width);
		}

		[Test]
		public function testDistributeHeights():void
		{
			this._layout.distributeHeights = true;
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var item2:LayoutGroup = new LayoutGroup();
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			var itemHeight:Number = viewPortHeight / items.length;
			Assert.assertStrictlyEquals("VerticalLayout with distributeHeights results in wrong item height",
				itemHeight, item1.height);
			Assert.assertStrictlyEquals("VerticalLayout with distributeHeights results in wrong item height",
				itemHeight, item2.height);
		}

		[Test]
		public function testDistributeHeightsWithIncludeInLayoutFalse():void
		{
			this._layout.distributeHeights = true;
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var item2:LayoutGroup = new LayoutGroup();
			item2.includeInLayout = false;
			var item3:LayoutGroup = new LayoutGroup();
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			var itemHeight:Number = viewPortHeight / (items.length - 1);
			Assert.assertStrictlyEquals("VerticalLayout with distributeHeights and an item with includeInLayout set to false results in wrong item height",
				itemHeight, item1.height);
			Assert.assertStrictlyEquals("VerticalLayout with distributeHeights and an item with includeInLayout set to false results in wrong item height",
				0, item2.height);
			Assert.assertStrictlyEquals("VerticalLayout with distributeHeights and an item with includeInLayout set to false results in wrong item height",
				itemHeight, item3.height);
		}

		[Test]
		public function testDistributeHeightsWithLargerItemHeights():void
		{
			this._layout.distributeHeights = true;
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			item1.height = 720;
			var item2:LayoutGroup = new LayoutGroup();
			item2.height = 800;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			var itemHeight:Number = viewPortHeight / items.length;
			Assert.assertStrictlyEquals("VerticalLayout with distributeHeights with larger item heights results in wrong item height",
				itemHeight, item1.height);
			Assert.assertStrictlyEquals("VerticalLayout with distributeHeights with larger item heights results in wrong item height",
				itemHeight, item2.height);
		}

		[Test]
		public function testDistributeHeightsWithoutExplicitHeight():void
		{
			this._layout.distributeHeights = true;
			var item1:LayoutGroup = new LayoutGroup();
			item1.height = 480;
			var item2:LayoutGroup = new LayoutGroup();
			item2.height = 640;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			this._layout.layout(items, new ViewPortBounds());
			var largerHeight:Number = Math.max(item1.height, item2.height);
			var itemHeight:Number = largerHeight * items.length;
			Assert.assertStrictlyEquals("VerticalLayout with distributeHeights and no explicit height results in wrong item height",
				itemHeight, item1.height);
			Assert.assertStrictlyEquals("VerticalLayout with distributeHeights and no explicit height results in wrong item height",
				itemHeight, item2.height);
		}

		[Test]
		public function testDistributeHeightsWithUseVirtualLayout():void
		{
			this._layout.distributeHeights = true;
			this._layout.useVirtualLayout = true;
			var viewPortHeight:Number = 640;
			var item1:LayoutGroup = new LayoutGroup();
			var item2:LayoutGroup = new LayoutGroup();
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 640;
			bounds.explicitHeight = viewPortHeight;
			this._layout.layout(items, bounds);
			var itemHeight:Number = viewPortHeight / items.length;
			Assert.assertStrictlyEquals("VerticalLayout with distributeHeights and useVirtualLayout results in wrong item height",
				itemHeight, item1.height);
			Assert.assertStrictlyEquals("VerticalLayout with distributeHeights and useVirtualLayout results in wrong item height",
				itemHeight, item2.height);
		}

		[Test]
		public function testSmallerMaxRowCount():void
		{
			this._layout.maxRowCount = 2;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayout with smaller maxRowCount results in wrong view port height",
				200, result.viewPortHeight);
			Assert.assertStrictlyEquals("VerticalLayout with smaller maxRowCount results in wrong content height",
				300, result.contentHeight);
		}

		[Test]
		public function testSmallerMaxRowCountAndUseVirtualLayout():void
		{
			this._layout.maxRowCount = 2;
			this._layout.useVirtualLayout = true;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			this._layout.typicalItem = item1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayout with smaller maxRowCount and useVirtualLayout results in wrong view port height",
				200, result.viewPortHeight);
			Assert.assertStrictlyEquals("VerticalLayout with smaller maxRowCount and useVirtualLayout results in wrong content height",
				300, result.contentHeight);
		}

		[Test]
		public function testLargerMaxRowCount():void
		{
			this._layout.maxRowCount = 4;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayout with larger maxRowCount results in wrong view port height",
				300, result.viewPortHeight);
			Assert.assertStrictlyEquals("VerticalLayout with larger maxRowCount results in wrong content height",
				300, result.contentHeight);
		}

		[Test]
		public function testLargerMaxRowCountAndUseVirtualLayout():void
		{
			this._layout.maxRowCount = 4;
			this._layout.useVirtualLayout = true;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			this._layout.typicalItem = item1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayout with larger maxRowCount and useVirtualLayout results in wrong view port height",
				300, result.viewPortHeight);
			Assert.assertStrictlyEquals("VerticalLayout with larger maxRowCount and useVirtualLayout results in wrong content height",
				300, result.contentHeight);
		}

		[Test]
		public function testRequestedRowCountWithZeroItems():void
		{
			this._layout.requestedRowCount = 3;
			var items:Vector.<DisplayObject> = new <DisplayObject>[];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayout with requestedRowCount and zero items results in wrong view port height",
				0, result.viewPortHeight);
			Assert.assertStrictlyEquals("VerticalLayout with requestedRowCount and zero items results in wrong content height",
				0, result.contentHeight);
		}

		[Test]
		public function testSmallerRequestedRowCount():void
		{
			this._layout.requestedRowCount = 2;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayout with smaller requestedRowCount results in wrong view port height",
				200, result.viewPortHeight);
			Assert.assertStrictlyEquals("VerticalLayout with smaller requestedRowCount results in wrong content height",
				300, result.contentHeight);
		}

		[Test]
		public function testSmallerRequestedRowCountAndUseVirtualLayout():void
		{
			this._layout.requestedRowCount = 2;
			this._layout.useVirtualLayout = true;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			this._layout.typicalItem = item1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayout with smaller requestedRowCount and useVirtualLayout results in wrong view port height",
				200, result.viewPortHeight);
			Assert.assertStrictlyEquals("VerticalLayout with smaller requestedRowCount and useVirtualLayout results in wrong content height",
				300, result.contentHeight);
		}

		[Test]
		public function testLargerRequestedRowCount():void
		{
			this._layout.requestedRowCount = 4;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayout with larger requestedRowCount results in wrong view port height",
				400, result.viewPortHeight);
			Assert.assertStrictlyEquals("VerticalLayout with larger requestedRowCount results in wrong content height",
				300, result.contentHeight);
		}

		[Test]
		public function testLargerRequestedRowCountAndUseVirtualLayout():void
		{
			this._layout.requestedRowCount = 4;
			this._layout.useVirtualLayout = true;
			var item1:LayoutGroup = new LayoutGroup();
			item1.setSize(100, 100);
			var item2:LayoutGroup = new LayoutGroup();
			item2.setSize(100, 100);
			var item3:LayoutGroup = new LayoutGroup();
			item3.setSize(100, 100);
			this._layout.typicalItem = item1;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayout with larger requestedRowCount and useVirtualLayout results in wrong view port height",
				400, result.viewPortHeight);
			Assert.assertStrictlyEquals("VerticalLayout with larger requestedRowCount and useVirtualLayout results in wrong content height",
				300, result.contentHeight);
		}

		[Test]
		public function testChildWithCalculatedMinWidthAndPercentWidth():void
		{
			var item1:LayoutGroup = new LayoutGroup();
			item1.layoutData = new VerticalLayoutData(100, 100);
			var child:Quad = new Quad(100, 100, 0xff00ff);
			item1.addChild(child);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayout without explicit view port width and child with percentWidth and calculated minWidth results in wrong view port width",
				100, result.viewPortWidth);
		}

		[Test]
		public function testChildWithExplicitMinWidthAndPercentWidth():void
		{
			var item1:LayoutGroup = new LayoutGroup();
			item1.layoutData = new VerticalLayoutData(100, 100);
			var child:Quad = new Quad(100, 100, 0xff00ff);
			item1.minWidth = 200;
			item1.addChild(child);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayout without explicit view port width and child with percentWidth and explicit minWidth results in wrong view port width",
				200, result.viewPortWidth);
			Assert.assertStrictlyEquals("VerticalLayout without explicit view port width and child with percentWidth and explicit minWidth results in wrong child width",
				200, item1.width);
		}

		[Test]
		public function testChildWithCalculatedMinWidthAndPercentWidthWithExplicitWidth():void
		{
			var item1:LayoutGroup = new LayoutGroup();
			item1.layoutData = new VerticalLayoutData(100, 100);
			var child:Quad = new Quad(100, 100, 0xff00ff);
			item1.addChild(child);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitWidth = 50;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayout with explicit view port width and child with percentWidth and calculated minWidth results in wrong view port width",
				50, result.viewPortWidth);
			Assert.assertStrictlyEquals("VerticalLayout with explicit view port width and child with percentWidth and calculated minWidth results in wrong child width",
				50, item1.width);
		}


		[Test]
		public function testChildWithCalculatedMinWidthAndPercentWidthWithViewPortMinWidth():void
		{
			var item1:LayoutGroup = new LayoutGroup();
			item1.layoutData = new VerticalLayoutData(100, 100);
			var child:Quad = new Quad(100, 100, 0xff00ff);
			item1.addChild(child);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.minWidth = 10;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayout with explicit view port minWidth and child with percentWidth and calculated minWidth results in wrong view port width",
				100, result.viewPortWidth);
			Assert.assertStrictlyEquals("VerticalLayout with explicit view port minWidth and child with percentWidth and calculated minWidth results in wrong child width",
				100, item1.width);
		}

		[Test]
		public function testChildWithCalculatedWidthAndSmallerCalculatedMinWidthAndPercentWidth():void
		{
			var item1:LayoutGroup = new LayoutGroup();
			item1.layoutData = new VerticalLayoutData(100, 100);
			var child:LayoutGroup = new LayoutGroup();
			child.width = 100;
			child.height = 100;
			child.minWidth = 50;
			child.minHeight = 50;
			item1.backgroundSkin = child;
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalLayout without explicit view port width and child with percentWidth, calculated width, and calculated minWidth results in wrong view port width",
				100, result.viewPortWidth);
			Assert.assertStrictlyEquals("VerticalLayout without explicit view port width and child with percentWidth, calculated width, and calculated minWidth results in wrong child width",
				100, item1.width);
		}

		[Test]
		public function testTypicalItemExplicitHeightWithoutHasVariableItemDimensions():void
		{
			this._layout.useVirtualLayout = true;
			this._layout.hasVariableItemDimensions = false;

			var item1:LayoutGroup = new LayoutGroup();
			item1.backgroundSkin = new Quad(100, 200);

			var item2:LayoutGroup = new LayoutGroup();
			item2.backgroundSkin = new Quad(150, 50);

			this._layout.typicalItem = item1;

			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2];
			var bounds:ViewPortBounds = new ViewPortBounds();
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertTrue("VerticalLayout: typicalItem explicitHeight must be NaN when useVirtualLayout is true and hasVariableItemDimensions is false so that it can resize later",
				isNaN(item1.explicitHeight));
			Assert.assertStrictlyEquals("VerticalLayout: item explicitHeight must be equal to typicalItem height when useVirtualLayout is true and hasVariableItemDimensions is false",
				item1.height, item2.explicitHeight);
		}
	}
}


================================================
FILE: test/source/feathers/tests/VerticalSpinnerLayoutTests.as
================================================
package feathers.tests
{
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.VerticalSpinnerLayout;
	import feathers.layout.ViewPortBounds;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.display.Quad;

	public class VerticalSpinnerLayoutTests
	{
		private var _layout:VerticalSpinnerLayout;

		[Before]
		public function prepare():void
		{
			this._layout = new VerticalSpinnerLayout();
		}

		[After]
		public function cleanup():void
		{
			this._layout = null;
		}

		[Test]
		public function testMinimumAndMaximumScrollPositionsWhenRepeatItemsIsTrue():void
		{
			this._layout.repeatItems = true;
			var item1:Quad = new Quad(200, 200);
			var item2:Quad = new Quad(200, 200);
			var item3:Quad = new Quad(200, 200);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitHeight = 200;
			this._layout.typicalItem = item1;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalSpinnerLayout layout() LayoutBoundsResult contentY not equal to Number.NEGATIVE_INFINITY when repeatItems is true and the total item height is larger than the view port height", Number.NEGATIVE_INFINITY, result.contentY);
			Assert.assertStrictlyEquals("VerticalSpinnerLayout layout() LayoutBoundsResult contentHeight not equal to Number.POSITIVE_INFINITY when repeatItems is true and the total item height is larger than the view port height", Number.POSITIVE_INFINITY, result.contentHeight);
		}

		[Test]
		public function testMinimumAndMaximumScrollPositionsWhenRepeatItemsIsFalse():void
		{
			var itemSize:Number = 200;
			this._layout.repeatItems = false;
			var item1:Quad = new Quad(itemSize, itemSize);
			var item2:Quad = new Quad(itemSize, itemSize);
			var item3:Quad = new Quad(itemSize, itemSize);
			var items:Vector.<DisplayObject> = new <DisplayObject>[item1, item2, item3];
			var bounds:ViewPortBounds = new ViewPortBounds();
			bounds.explicitHeight = 200;
			this._layout.typicalItem = item1;
			var result:LayoutBoundsResult = this._layout.layout(items, bounds);
			Assert.assertStrictlyEquals("VerticalSpinnerLayout layout() LayoutBoundsResult contentY not equal to 0 when repeatItems is false and the total item height is larger than the view port height", 0, result.contentY);
			Assert.assertStrictlyEquals("VerticalSpinnerLayout layout() LayoutBoundsResult contentHeight not equal to total height of items minus view port height when repeatItems is false and the total item height is larger than the view port height", items.length * itemSize, result.contentHeight);
		}

		[Test]
		public function testVisibleIndicesWithOneItemVisibleAndRepeatingWithGap():void
		{
			//Github issue #1257
			var itemSize:Number = 256;
			var gap:Number = 64;
			this._layout.useVirtualLayout = true;
			this._layout.gap = gap;
			this._layout.requestedRowCount = 1;
			var item1:Quad = new Quad(itemSize, itemSize);
			this._layout.typicalItem = item1;
			var result:Vector.<int> = this._layout.getVisibleIndicesAtScrollPosition(0, (itemSize + gap) * 9.8, 320, 320, 5);
			Assert.assertTrue("VerticalSpinnerLayout getVisibleIndicesAtScrollPosition() does not contain and index that should be visible", result.indexOf(4) >= 0)
		}
	}
}


================================================
FILE: test/source/feathers/tests/XMLListCollectionTests.as
================================================
package feathers.tests
{
	import feathers.data.XMLListCollection;
	import feathers.data.ListCollection;
	import feathers.events.CollectionEventType;

	import org.flexunit.Assert;

	import starling.events.Event;

	public class XMLListCollectionTests
	{
		private var _collection:XMLListCollection;
		private var _a:XML;
		private var _b:XML;
		private var _c:XML;
		private var _d:XML;

		[Before]
		public function prepare():void
		{
			this._a = <item label="One" value="0"/>;
			this._b = <item label="Two" value="2"/>;
			this._c = <item label="Three" value="3"/>;
			this._d = <item label="Four" value="1"/>;
			var xml:XML = <items/>;
			xml.appendChild(this._a);
			xml.appendChild(this._b);
			xml.appendChild(this._c);
			xml.appendChild(this._d);
			this._collection = new XMLListCollection(xml.elements());
		}

		[After]
		public function cleanup():void
		{
			this._collection = null;
		}

		private function filterFunction(item:Object):Boolean
		{
			if(item === this._a || item === this._c)
			{
				return false;
			}
			return true;
		}

		private function sortCompareFunction(a:Object, b:Object):int
		{
			var valueA:Number = parseFloat(a.@value.toString());
			var valueB:Number = parseFloat(b.@value.toString());
			if(valueA < valueB)
			{
				return -1;
			}
			if(valueA > valueB)
			{
				return 1;
			}
			return 0;
		}

		[Test]
		public function testRemoveAll():void
		{
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedAll:Boolean = false;
			this._collection.addEventListener(CollectionEventType.REMOVE_ALL, function(event:Event):void
			{
				hasRemovedAll = true;
			});
			var hasReset:Boolean = false;
			this._collection.addEventListener(CollectionEventType.RESET, function(event:Event):void
			{
				hasReset = true;
			});
			this._collection.removeAll();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			//reset used to be dispatched, but REMOVE_ALL is better
			Assert.assertFalse("CollectionEventType.RESET was incorrectly dispatched", hasReset);
			Assert.assertTrue("CollectionEventType.REMOVE_ALL was not dispatched", hasRemovedAll);
			Assert.assertStrictlyEquals("The length property was not changed to 0",
				0, this._collection.length);
		}

		[Test]
		public function testRemoveItemAt():void
		{
			var itemToRemove:Object = this._collection.getItemAt(1);
			var originalLength:int = this._collection.length;
			var expectedIndex:int = 1;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				hasRemovedItem = true;
				indexFromEvent = index;
			});
			this._collection.removeItemAt(expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength - 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not removed",
				-1, this._collection.getItemIndex(itemToRemove));
			Assert.assertStrictlyEquals("The CollectionEventType.REMOVE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testRemoveItem():void
		{
			var expectedIndex:int = 1;
			var itemToRemove:Object = this._collection.getItemAt(expectedIndex);
			var originalLength:int = this._collection.length;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				hasRemovedItem = true;
				indexFromEvent = index;
			});
			this._collection.removeItem(itemToRemove);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength - 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not removed",
				-1, this._collection.getItemIndex(itemToRemove));
			Assert.assertStrictlyEquals("The CollectionEventType.REMOVE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testShift():void
		{
			var itemToRemove:Object = this._collection.getItemAt(0);
			var originalLength:int = this._collection.length;
			var expectedIndex:int = 0;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				hasRemovedItem = true;
				indexFromEvent = index;
			});
			this._collection.shift();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength - 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not removed",
				-1, this._collection.getItemIndex(itemToRemove));
			Assert.assertStrictlyEquals("The CollectionEventType.REMOVE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testPop():void
		{
			var originalLength:int = this._collection.length;
			var itemToRemove:Object = this._collection.getItemAt(originalLength - 1);
			var expectedIndex:int = originalLength - 1;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, index:int):void
			{
				hasRemovedItem = true;
				indexFromEvent = index;
			});
			this._collection.pop();
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength - 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not removed",
				-1, this._collection.getItemIndex(itemToRemove));
			Assert.assertStrictlyEquals("The CollectionEventType.REMOVE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testAddItem():void
		{
			var itemToAdd:XML = <item label="New Item"/>;
			var originalLength:int = this._collection.length;
			var expectedIndex:int = originalLength;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.addItem(itemToAdd);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength + 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.ADD_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testAddItemAt():void
		{
			var itemToAdd:XML = <item label="New Item"/>;
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.length;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.addItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength + 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.ADD_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testUnshift():void
		{
			var itemToAdd:XML = <item label="New Item"/>;
			var expectedIndex:int = 0;
			var originalLength:int = this._collection.length;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.unshift(itemToAdd);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength + 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.ADD_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testPush():void
		{
			var itemToAdd:XML = <item label="New Item"/>;
			var originalLength:int = this._collection.length;
			var expectedIndex:int = originalLength;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.push(itemToAdd);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was not changed",
				originalLength + 1, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.ADD_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testSetItemAt():void
		{
			var itemToAdd:XML = <item label="New Item"/>;
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.length;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indexFromEvent:int = -1;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, index:int):void
			{
				hasAddedItem = true;
				indexFromEvent = index;
			});
			this._collection.setItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("CollectionEventType.REPLACE_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("The length property was incorrectly changed",
				originalLength, this._collection.length);
			Assert.assertStrictlyEquals("The item was not added at the correct index",
				expectedIndex, this._collection.getItemIndex(itemToAdd));
			Assert.assertStrictlyEquals("The CollectionEventType.REPLACE_ITEM event data was not the correct index",
				expectedIndex, indexFromEvent);
		}

		[Test]
		public function testContainsWithItemInCollection():void
		{
			var item:Object = this._collection.getItemAt(1);
			Assert.assertStrictlyEquals("contains() incorrectly returned false",
				true, this._collection.contains(item));
		}

		[Test]
		public function testContainsWithItemNotInCollection():void
		{
			var item:Object = {};
			Assert.assertStrictlyEquals("contains() incorrectly returned true",
				false, this._collection.contains(item));
		}

		[Test]
		public function testGetItemIndexWithItemInCollection():void
		{
			var expectedIndex:int = 1;
			var item:Object = this._collection.getItemAt(expectedIndex);
			Assert.assertStrictlyEquals("getItemIndex() returned the incorrect value",
				expectedIndex, this._collection.getItemIndex(item));
		}

		[Test]
		public function testGetItemIndexWithItemNotInCollection():void
		{
			var item:Object = {};
			Assert.assertStrictlyEquals("getItemIndex() returned the incorrect value",
				-1, this._collection.getItemIndex(item));
		}

		[Test]
		public function testDispose():void
		{
			var itemCount:int = this._collection.length;
			var disposedCount:int = 0;
			this._collection.dispose(function(item:Object):void
			{
				item.isDisposed = true;
				disposedCount++;
			});
			Assert.assertStrictlyEquals("Incorrect number of items disposed when calling dispose() on XMLListCollection",
				itemCount, disposedCount);
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = this._collection.getItemAt(i);
				Assert.assertTrue("Item was not included when calling dispose() on XMLListCollection", item.isDisposed);
			}
		}

		[Test]
		public function testDisposeWithFilterFunction():void
		{
			var itemCount:int = this._collection.length;
			this._collection.filterFunction = function(item:Object):Boolean
			{
				return item.@label.toString().charAt(0) === "O";
			};
			var filteredCount:int = this._collection.length;
			Assert.assertFalse("Filtered collection length must change", itemCount === filteredCount);
			var disposedCount:int = 0;
			this._collection.dispose(function(item:Object):void
			{
				item.isDisposed = true;
				disposedCount++;
			});
			Assert.assertStrictlyEquals("Incorrect number of items disposed when calling dispose() on XMLListCollection",
				itemCount, disposedCount);
			for(var i:int = 0; i < itemCount; i++)
			{
				var item:Object = this._collection.getItemAt(i);
				Assert.assertTrue("Item was not included when calling dispose() on XMLListCollection", item.isDisposed);
			}
		}

		[Test]
		public function testSortCompareFunction():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			Assert.assertStrictlyEquals("XMLListCollection: sortCompareFunction order is incorrect.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("XMLListCollection: sortCompareFunction order is incorrect.",
				this._d, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("XMLListCollection: sortCompareFunction order is incorrect.",
				this._b, this._collection.getItemAt(2));
			Assert.assertStrictlyEquals("XMLListCollection: sortCompareFunction order is incorrect.",
				this._c, this._collection.getItemAt(3));
		}

		[Test]
		public function testSortCompareFunctionAndFilterFunction():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.filterFunction = this.filterFunction;
			Assert.assertStrictlyEquals("XMLListCollection: sortCompareFunction and filterFunction length is incorrect.",
				2, this._collection.length);
			Assert.assertStrictlyEquals("XMLListCollection: sortCompareFunction order is incorrect with filterFunction.",
				this._d, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("XMLListCollection: sortCompareFunction order is incorrect with filterFunction.",
				this._b, this._collection.getItemAt(1));
		}

		[Test]
		public function testSetSortCompareFunctionToNull():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			//get an item so that we know the sorting was applied
			Assert.assertStrictlyEquals("XMLListCollection: sortCompareFunction order is incorrect.",
				this._c, this._collection.getItemAt(3));

			this._collection.sortCompareFunction = null;
			Assert.assertStrictlyEquals("XMLListCollection: set sortCompareFunction to null order is incorrect.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("XMLListCollection: set sortCompareFunction to null order is incorrect.",
				this._b, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("XMLListCollection: set sortCompareFunction to null order is incorrect.",
				this._c, this._collection.getItemAt(2));
			Assert.assertStrictlyEquals("XMLListCollection: set sortCompareFunction to null order is incorrect.",
				this._d, this._collection.getItemAt(3));
		}

		[Test]
		public function testSortCompareFunctionWithAddItem():void
		{
			var newItem:XML = <item label="New Item" value="1.5" />;
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.addItem(newItem);

			Assert.assertStrictlyEquals("XMLListCollection: addItem() with sortCompareFunction does not add at correct sorted index.",
				newItem, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			Assert.assertStrictlyEquals("XMLListCollection: addItem() with sortCompareFunction does not add at correct unsorted index.",
				newItem, this._collection.getItemAt(4));
		}

		[Test]
		public function testSortCompareFunctionWithAddItemAt():void
		{
			var newItem:XML = <item label="New Item" value="1.5" />;
			var newIndex:int = 1;
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.addItemAt(newItem, newIndex);

			//the index we passed in isn't necessarily the same while sorted
			Assert.assertStrictlyEquals("XMLListCollection: addItemAt() with sortCompareFunction does not add at correct sorted index.",
				newItem, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			//and it might not even be the same while unsorted!
			//that's because, in the unsorted data, it will be placed relative
			//to the item in the sorted data that was at the index passed to
			//addItemAt(). confusing, but it's consistent with setItemAt() and
			//filtered collections
			Assert.assertStrictlyEquals("XMLListCollection: addItemAt() with sortCompareFunction does not add at correct unsorted index.",
				newItem, this._collection.getItemAt(3));
		}

		[Test]
		public function testSortCompareFunctionWithRemoveItemAt():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.removeItemAt(2);

			Assert.assertStrictlyEquals("XMLListCollection: removeItemAt() with sortCompareFunction removed incorrect item in sorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("XMLListCollection: removeItemAt() with sortCompareFunction removed incorrect item in sorted data.",
				this._d, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("XMLListCollection: removeItemAt() with sortCompareFunction removed incorrect item in sorted data.",
				this._c, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			Assert.assertStrictlyEquals("XMLListCollection: removeItemAt() with sortCompareFunction removed incorrect item in unsorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("XMLListCollection: removeItemAt() with sortCompareFunction removed incorrect item in unsorted data.",
				this._c, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("XMLListCollection: removeItemAt() with sortCompareFunction removed incorrect item in unsorted data.",
				this._d, this._collection.getItemAt(2));
		}

		[Test]
		public function testSortCompareFunctionWithRemoveItem():void
		{
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.removeItem(this._b);

			Assert.assertStrictlyEquals("XMLListCollection: removeItem() with sortCompareFunction removed incorrect item in sorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("XMLListCollection: removeItem() with sortCompareFunction removed incorrect item in sorted data.",
				this._d, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("XMLListCollection: removeItem() with sortCompareFunction removed incorrect item in sorted data.",
				this._c, this._collection.getItemAt(2));

			this._collection.sortCompareFunction = null;

			Assert.assertStrictlyEquals("XMLListCollection: removeItem() with sortCompareFunction removed incorrect item in unsorted data.",
				this._a, this._collection.getItemAt(0));
			Assert.assertStrictlyEquals("XMLListCollection: removeItem() with sortCompareFunction removed incorrect item in unsorted data.",
				this._c, this._collection.getItemAt(1));
			Assert.assertStrictlyEquals("XMLListCollection: removeItem() with sortCompareFunction removed incorrect item in unsorted data.",
				this._d, this._collection.getItemAt(2));
		}

		[Test]
		public function testSortCompareFunctionWithSetItemAt():void
		{
			var newItem:XML = <item label="New Item" value="1.5" />;
			var newIndex:int = 0;
			this._collection.sortCompareFunction = this.sortCompareFunction;
			this._collection.setItemAt(newItem, newIndex);

			//the index we passed in isn't necessarily the same while sorted
			Assert.assertStrictlyEquals("XMLListCollection: setItemAt() with sortCompareFunction does not add at correct sorted index.",
				newItem, this._collection.getItemAt(1));
			Assert.assertFalse("XMLListCollection: setItemAt() with sortCompareFunction does not replace correct item.",
				this._collection.contains(this._a));

			this._collection.sortCompareFunction = null;

			//however, that index should be the same when the collection is unsorted
			Assert.assertStrictlyEquals("XMLListCollection: setItemAt() with sortCompareFunction does not add at correct unsorted index.",
				newItem, this._collection.getItemAt(newIndex));
		}
	}
}


================================================
FILE: test/source/feathers/tests/XMLListHierarchicalCollectionTests.as
================================================
package feathers.tests
{
	import feathers.data.XMLListHierarchicalCollection;
	import feathers.events.CollectionEventType;

	import org.flexunit.Assert;

	import starling.events.Event;

	public class XMLListHierarchicalCollectionTests
	{
		private var _collection:XMLListHierarchicalCollection;

		[Before]
		public function prepare():void
		{
			var data:XML = <items>
				<item label="1">
					<item label="1-A"/>
					<item label="1-B">
						<item label="1-B-I"/>
					</item>
					<item label="1-C"/>
				</item>
				<item label="2">
					<item label="2-A"/>
				</item>
				<item label="3"/>
				<item label="4">
					<item label="4-A"/>
					<item label="4-B"/>
				</item>
			</items>;
			this._collection = new XMLListHierarchicalCollection(data.item);
		}

		[After]
		public function cleanup():void
		{
			this._collection = null;
		}

		[Test]
		public function testGetLength():void
		{
			var length:int = this._collection.getLength();
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: getLengthAtLocation() returned incorrect length",
				4, length);
		}

		[Test]
		public function testGetLengthNested():void
		{
			var length:int = this._collection.getLength(3);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: getLengthAtLocation() returned incorrect length",
				2, length);
		}

		[Test]
		public function testGetLengthAtLocationWithNull():void
		{
			var length:int = this._collection.getLengthAtLocation();
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: getLengthAtLocation() returned incorrect length",
				4, length);
		}

		[Test]
		public function testGetItemAt():void
		{
			var item:XML = this._collection.getItemAt(1) as XML;
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: getItemAt() returned incorrect item",
				this._collection.xmlListData[1], item);
		}

		[Test]
		public function testGetItemAtNested():void
		{
			var item:XML = this._collection.getItemAt(0, 1) as XML;
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: getItemAt() returned incorrect item",
				this._collection.xmlListData[0].elements()[1], item);
		}

		[Test]
		public function testGetItemAtLocation():void
		{
			var indices:Vector.<int> = new <int>[1];
			var item:XML = this._collection.getItemAtLocation(indices) as XML;
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: getItemAtLocation() returned incorrect item",
				this._collection.xmlListData[1], item);
		}

		[Test]
		public function testGetItemAtNestedLocation():void
		{
			var indices:Vector.<int> = new <int>[0, 1];
			var item:XML = this._collection.getItemAtLocation(indices) as XML;
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: getItemAtLocation() returned incorrect item",
				this._collection.xmlListData[0].elements()[1], item);
		}

		[Test]
		public function testGetItemAtNullLocation():void
		{
			var item:Object = this._collection.getItemAtLocation(null);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: getItemAtLocation() returned incorrect item",
				null, item);
		}

		[Test]
		public function testGetItemAtEmptyLocation():void
		{
			var indices:Vector.<int> = new <int>[];
			var item:Object = this._collection.getItemAtLocation(indices);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: getItemAtLocation() returned incorrect item",
				null, item);
		}

		[Test]
		public function testRemoveAll():void
		{
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedAll:Boolean = false;
			this._collection.addEventListener(CollectionEventType.REMOVE_ALL, function(event:Event):void
			{
				hasRemovedAll = true;
			});
			var hasReset:Boolean = false;
			this._collection.addEventListener(CollectionEventType.RESET, function(event:Event):void
			{
				hasReset = true;
			});
			this._collection.removeAll();
			Assert.assertTrue("XMLListHierarchicalCollection: Event.CHANGE was not dispatched after removeAll()", hasChanged);
			Assert.assertFalse("XMLListHierarchicalCollection: CollectionEventType.RESET was incorrectly dispatched after removeAll()", hasReset);
			Assert.assertTrue("XMLListHierarchicalCollection: CollectionEventType.REMOVE_ALL was not dispatched after removeAll()", hasRemovedAll);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: the getLength() value was not changed to 0 after removeAll()",
				0, this._collection.getLength());
		}

		[Test]
		public function testRemoveItemAtLocation():void
		{
			var indicesToRemove:Vector.<int> = new <int>[1];
			var itemToRemove:XML = this._collection.getItemAtLocation(indicesToRemove) as XML;
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItemAtLocation(indicesToRemove);
			Assert.assertTrue("XMLListHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("XMLListHierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The getLength() value was not changed",
				originalLength - 1, this._collection.getLength());
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("XMLListHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				indicesToRemove[0], indicesFromEvent[0]);
		}

		[Test]
		public function testRemoveItemAtNestedLocation():void
		{
			var indicesToRemove:Vector.<int> = new <int>[0, 1];
			var itemToRemove:XML = this._collection.getItemAtLocation(indicesToRemove) as XML;
			var originalParentLength:int = this._collection.getLength(indicesToRemove[0]);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItemAtLocation(indicesToRemove);
			Assert.assertTrue("XMLListHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("XMLListHierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The getLength() value was not changed",
				originalParentLength - 1, this._collection.getLength(indicesToRemove[0]));
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("XMLListHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				indicesToRemove[0], indicesFromEvent[0]);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				indicesToRemove[1], indicesFromEvent[1]);
		}

		[Test(expects="RangeError")]
		public function testRemoveItemAtNullLocation():void
		{
			this._collection.removeItemAtLocation(null);
		}

		[Test(expects="RangeError")]
		public function testRemoveItemAtEmptyLocation():void
		{
			var indices:Vector.<int> = new <int>[];
			this._collection.removeItemAtLocation(indices);
		}

		[Test]
		public function testRemoveItemAt():void
		{
			var itemToRemove:XML = this._collection.getItemAt(1) as XML;
			var originalLength:int = this._collection.getLength();
			var expectedIndex:int = 1;
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItemAt(expectedIndex);
			Assert.assertTrue("XMLListHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("XMLListHierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The getLength() value was not changed",
				originalLength - 1, this._collection.getLength());
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("XMLListHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testRemoveItem():void
		{
			var expectedIndex:int = 1;
			var itemToRemove:XML = this._collection.getItemAt(expectedIndex) as XML;
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasRemovedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REMOVE_ITEM, function(event:Event, indices:Array):void
			{
				hasRemovedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.removeItem(itemToRemove);
			Assert.assertTrue("XMLListHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("XMLListHierarchicalCollection: CollectionEventType.REMOVE_ITEM was not dispatched", hasRemovedItem);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The getLength() value was not changed",
				originalLength - 1, this._collection.getLength());
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not removed",
				0, this._collection.getItemLocation(itemToRemove).length);
			Assert.failNull("XMLListHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REMOVE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testAddItemAtLocation():void
		{
			var location:Vector.<int> = new <int>[1];
			var itemToAdd:XML = <item label="New Item"/>;
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAtLocation(itemToAdd, location);
			Assert.assertTrue("XMLListHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("XMLListHierarchicalCollection: CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The getLength() value was not changed",
				originalLength + 1, this._collection.getLength());
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not added",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not added at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("XMLListHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
		}

		[Test]
		public function testAddItemAtNestedLocation():void
		{
			var location:Vector.<int> = new <int>[0, 1];
			var itemToAdd:XML = <item label="New Item"/>;
			var originalParentLength:int = this._collection.getLength(location[0]);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAtLocation(itemToAdd, location);
			Assert.assertTrue("XMLListHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("XMLListHierarchicalCollection: CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The getLength() value was not changed",
				originalParentLength + 1, this._collection.getLength(location[0]));
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not added",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not added at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not added at the correct index",
				location[1], this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("XMLListHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				location[1], indicesFromEvent[1]);
		}

		[Test(expects="RangeError")]
		public function testAddItemAtNullLocation():void
		{
			var itemToAdd:XML = <item label="New Item"/>;
			this._collection.addItemAtLocation(itemToAdd, null);
		}

		[Test(expects="RangeError")]
		public function testAddItemAtEmptyLocation():void
		{
			var itemToAdd:XML = <item label="New Item"/>;
			var indices:Vector.<int> = new <int>[];
			this._collection.addItemAtLocation(itemToAdd, indices);
		}

		[Test]
		public function testAddItemAt():void
		{
			var itemToAdd:XML = <item label="New Item"/>;
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("XMLListHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("XMLListHierarchicalCollection: CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The getLength() value was not changed",
				originalLength + 1, this._collection.getLength());
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not added",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not added at the correct index",
				expectedIndex, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("XMLListHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testAddItemAtNested():void
		{
			var itemToAdd:XML = <item label="New Item"/>;
			var originalParentLength:int = this._collection.getLength(0);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasAddedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.ADD_ITEM, function(event:Event, indices:Array):void
			{
				hasAddedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.addItemAt(itemToAdd, 0, 1);
			Assert.assertTrue("XMLListHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("XMLListHierarchicalCollection: CollectionEventType.ADD_ITEM was not dispatched", hasAddedItem);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The getLength() value was not changed",
				originalParentLength + 1, this._collection.getLength(0));
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not added",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not added at the correct index",
				0, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not added at the correct index",
				1, this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("XMLListHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				0, indicesFromEvent[0]);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.ADD_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[1]);
		}

		[Test]
		public function testSetItemAt():void
		{
			var itemToAdd:XML = <item label="New Item"/>;
			var expectedIndex:int = 1;
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAt(itemToAdd, expectedIndex);
			Assert.assertTrue("XMLListHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("XMLListHierarchicalCollection: CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The length property was incorrectly changed",
				originalLength, this._collection.getLength());
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not replaced",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not replaced at the correct index",
				expectedIndex, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("XMLListHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[0]);
		}

		[Test]
		public function testSetItemAtNested():void
		{
			var itemToAdd:XML = <item label="New Item"/>;
			var originalParentLength:int = this._collection.getLength(0);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAt(itemToAdd, 0, 1);
			Assert.assertTrue("XMLListHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("XMLListHierarchicalCollection: CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The length property was incorrectly changed",
				originalParentLength, this._collection.getLength(0));
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not replaced",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not replaced at the correct index",
				0, this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not replaced at the correct index",
				1, this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("XMLListHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				0, indicesFromEvent[0]);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				1, indicesFromEvent[1]);
		}

		[Test]
		public function testSetItemAtLocation():void
		{
			var itemToAdd:XML = <item label="New Item"/>;
			var location:Vector.<int> = new <int>[1];
			var originalLength:int = this._collection.getLength();
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAtLocation(itemToAdd, location);
			Assert.assertTrue("XMLListHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("XMLListHierarchicalCollection: CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The length property was incorrectly changed",
				originalLength, this._collection.getLength());
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not replaced",
				1, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not replaced at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.failNull("XMLListHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				1, indicesFromEvent.length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
		}

		[Test]
		public function testSetItemAtNestedLocation():void
		{
			var itemToAdd:XML = <item label="New Item"/>;
			var location:Vector.<int> = new <int>[0, 1];
			var originalParentLength:int = this._collection.getLength(location[0]);
			var hasChanged:Boolean = false;
			this._collection.addEventListener(Event.CHANGE, function(event:Event):void
			{
				hasChanged = true;
			});
			var hasReplacedItem:Boolean = false;
			var indicesFromEvent:Array = null;
			this._collection.addEventListener(CollectionEventType.REPLACE_ITEM, function(event:Event, indices:Array):void
			{
				hasReplacedItem = true;
				indicesFromEvent = indices;
			});
			this._collection.setItemAtLocation(itemToAdd, location);
			Assert.assertTrue("XMLListHierarchicalCollection: Event.CHANGE was not dispatched", hasChanged);
			Assert.assertTrue("XMLListHierarchicalCollection: CollectionEventType.REPLACE_ITEM was not dispatched", hasReplacedItem);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The length property was incorrectly changed",
				originalParentLength, this._collection.getLength(location[0]));
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not replaced",
				2, this._collection.getItemLocation(itemToAdd).length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not replaced at the correct index",
				location[0], this._collection.getItemLocation(itemToAdd)[0]);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The item was not replaced at the correct index",
				location[1], this._collection.getItemLocation(itemToAdd)[1]);
			Assert.failNull("XMLListHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (null)",
				indicesFromEvent);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (length)",
				2, indicesFromEvent.length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				location[0], indicesFromEvent[0]);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: The CollectionEventType.REPLACE_ITEM event data was not the correct location (value)",
				location[1], indicesFromEvent[1]);
		}

		[Test(expects="RangeError")]
		public function testSetItemAtNullLocation():void
		{
			var itemToAdd:XML = <item label="New Item"/>;
			this._collection.setItemAtLocation(itemToAdd, null);
		}

		[Test(expects="RangeError")]
		public function testSetItemAtEmptyLocation():void
		{
			var itemToAdd:XML = <item label="New Item"/>;
			var indices:Vector.<int> = new <int>[];
			this._collection.setItemAtLocation(itemToAdd, indices);
		}

		[Test]
		public function testGetItemLocationWithItemInCollection():void
		{
			var expectedIndex:int = 1;
			var item:XML = this._collection.getItemAt(expectedIndex) as XML;
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: getItemLocation() returned the incorrect location (length)",
				1, this._collection.getItemLocation(item).length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: getItemLocation() returned the incorrect location (value)",
				expectedIndex, this._collection.getItemLocation(item)[0]);
		}

		[Test]
		public function testGetItemLocationNestedWithItemInCollection():void
		{
			var location:Vector.<int> = new <int>[0, 1];
			var item:XML = this._collection.getItemAtLocation(location) as XML;
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: getItemLocation() returned the incorrect location (length)",
				location.length, this._collection.getItemLocation(item).length);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: getItemLocation() returned the incorrect location (value)",
				location[0], this._collection.getItemLocation(item)[0]);
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: getItemLocation() returned the incorrect location (value)",
				location[1], this._collection.getItemLocation(item)[1]);
		}

		[Test]
		public function testGetItemLocationWithItemNotInCollection():void
		{
			var item:XML = <notincollection/>;
			Assert.assertStrictlyEquals("XMLListHierarchicalCollection: getItemLocation() returned the incorrect location (length)",
				0, this._collection.getItemLocation(item).length);
		}
	}
}

================================================
FILE: test/source/feathers/tests/XMLListInsertAtTests.as
================================================
package feathers.tests
{
	import feathers.utils.xml.xmlListInsertAt;

	import org.flexunit.Assert;

	public class XMLListInsertAtTests
	{
		private var _xmlList:XMLList;

		[Before]
		public function prepare():void
		{
			this._xmlList = <items>
				<item label="One"/>
				<item label="Two"/>
				<item label="Three"/>
			</items>.elements();
		}

		[After]
		public function cleanup():void
		{
			this._xmlList = null;
		}

		[Test]
		public function testInsertAt0():void
		{
			var itemToInsert:XML = <item label="New Item"/>;
			this._xmlList = xmlListInsertAt(this._xmlList, 0, itemToInsert);
			Assert.assertStrictlyEquals("xmlListInsertAt: length() after insert did not increase",
				4, this._xmlList.length());
			Assert.assertStrictlyEquals("xmlListInsertAt: returned item is not correct after insert at index 0",
				itemToInsert, this._xmlList[0]);
		}

		[Test]
		public function testInsertAtLength():void
		{
			var index:int = this._xmlList.length();
			var itemToInsert:XML = <item label="New Item"/>;
			this._xmlList = xmlListInsertAt(this._xmlList, index, itemToInsert);
			Assert.assertStrictlyEquals("xmlListInsertAt: length() after insert did not increase",
				4, this._xmlList.length());
			Assert.assertStrictlyEquals("xmlListInsertAt: returned item is not correct after insert at index === length()",
				itemToInsert, this._xmlList[index]);
		}
	}
}

================================================
FILE: test/source/feathers/tests/supportClasses/AssertViewPortBoundsLayout.as
================================================
package feathers.tests.supportClasses
{
	import feathers.layout.ILayout;
	import feathers.layout.LayoutBoundsResult;
	import feathers.layout.ViewPortBounds;

	import flash.geom.Point;

	import org.flexunit.Assert;

	import starling.display.DisplayObject;
	import starling.events.EventDispatcher;

	public class AssertViewPortBoundsLayout extends EventDispatcher implements ILayout
	{
		public function AssertViewPortBoundsLayout()
		{
		}

		public function get requiresLayoutOnScroll():Boolean
		{
			return false;
		}

		public function layout(items:Vector.<DisplayObject>, viewPortBounds:ViewPortBounds = null, result:LayoutBoundsResult = null):LayoutBoundsResult
		{
			if(result === null)
			{
				result = new LayoutBoundsResult();
			}
			if(viewPortBounds !== null)
			{
				Assert.assertFalse("ViewPortBounds minWidth must not be NaN", isNaN(viewPortBounds.minWidth));
				Assert.assertFalse("ViewPortBounds minHeight must not be NaN", isNaN(viewPortBounds.minHeight));
				Assert.assertFalse("ViewPortBounds maxWidth must not be NaN", isNaN(viewPortBounds.maxWidth));
				Assert.assertFalse("ViewPortBounds maxHeight must not be NaN", isNaN(viewPortBounds.maxHeight));
			}
			return result;
		}

		public function getScrollPositionForIndex(index:int, items:Vector.<DisplayObject>,
			x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			if(result === null)
			{
				result = new Point();
			}
			return result;
		}

		public function getNearestScrollPositionForIndex(index:int, scrollX:Number, scrollY:Number,
			items:Vector.<DisplayObject>, x:Number, y:Number, width:Number, height:Number, result:Point = null):Point
		{
			if(result === null)
			{
				result = new Point();
			}
			return result;
		}

		public function calculateNavigationDestination(items:Vector.<DisplayObject>, index:int, keyCode:uint, bounds:LayoutBoundsResult):int
		{
			return index;
		}
	}
}


================================================
FILE: test/source/feathers/tests/supportClasses/CustomMediaPlayer.as
================================================
package feathers.tests.supportClasses
{
	import feathers.events.MediaPlayerEventType;
	import feathers.media.ITimedMediaPlayer;

	import starling.events.EventDispatcher;

	public class CustomMediaPlayer extends EventDispatcher implements ITimedMediaPlayer
	{
		public function CustomMediaPlayer(totalTime:Number)
		{
			this._totalTime = totalTime;
		}
		
		protected var _currentTime:Number = 0;
		
		public function get currentTime():Number
		{
			return this._currentTime;
		}

		protected var _totalTime:Number = 0;

		public function get totalTime():Number
		{
			return this._totalTime;
		}

		protected var _isPlaying:Boolean = false;

		public function get isPlaying():Boolean
		{
			return this._isPlaying;
		}

		public function togglePlayPause():void
		{
			if(this._isPlaying)
			{
				this.pause();
			}
			else
			{
				this.play();
			}
		}

		public function play():void
		{
			if(this._isPlaying)
			{
				return;
			}
			this._isPlaying = true;
			this.dispatchEventWith(MediaPlayerEventType.PLAYBACK_STATE_CHANGE);
		}

		public function pause():void
		{
			if(!this._isPlaying)
			{
				return;
			}
			this._isPlaying = false;
			this.dispatchEventWith(MediaPlayerEventType.PLAYBACK_STATE_CHANGE);
		}

		public function stop():void
		{
			this.pause();
			this.seek(0);
		}

		public function seek(seconds:Number):void
		{
			this._currentTime = seconds;
			this.dispatchEventWith(MediaPlayerEventType.CURRENT_TIME_CHANGE);
		}
	}
}


================================================
FILE: test/source/feathers/tests/supportClasses/CustomStateContext.as
================================================
package feathers.tests.supportClasses
{
	import feathers.core.IStateContext;
	import feathers.events.FeathersEventType;

	public class CustomStateContext extends CustomToggle implements IStateContext
	{
		public function CustomStateContext()
		{
			super();
		}

		protected var _currentState:String = null;

		public function get currentState():String
		{
			return this._currentState;
		}

		public function set currentState(value:String):void
		{
			if(this._currentState === value)
			{
				return;
			}
			this._currentState = value;
			this.dispatchEventWith(FeathersEventType.STATE_CHANGE);
		}
	}
}


================================================
FILE: test/source/feathers/tests/supportClasses/CustomStyleProvider.as
================================================
package feathers.tests.supportClasses
{
	import feathers.core.IFeathersControl;
	import feathers.skins.IStyleProvider;

	public class CustomStyleProvider implements IStyleProvider
	{
		public function CustomStyleProvider()
		{
		}

		private var _appliedStyles:Boolean = false;

		public function get appliedStyles():Boolean
		{
			return this._appliedStyles;
		}

		public function applyStyles(target:IFeathersControl):void
		{
			this._appliedStyles = true;
		}
	}
}


================================================
FILE: test/source/feathers/tests/supportClasses/CustomToggle.as
================================================
package feathers.tests.supportClasses
{
	import feathers.controls.LayoutGroup;
	import feathers.core.IFocusDisplayObject;
	import feathers.core.IToggle;

	import starling.display.Quad;
	import starling.events.Event;

	public class CustomToggle extends LayoutGroup implements IToggle, IFocusDisplayObject
	{
		public function CustomToggle()
		{
			this.backgroundSkin = new Quad(200, 200, 0xff00ff);
		}
		
		protected var _isSelected:Boolean = false;
		
		public function get isSelected():Boolean
		{
			return this._isSelected;
		}
		
		public function set isSelected(value:Boolean):void
		{
			if(this._isSelected === value)
			{
				return;
			}
			this._isSelected = value;
			this.dispatchEventWith(Event.CHANGE);
		}
	}
}


================================================
FILE: test/source/feathers/tests/supportClasses/DisposeFlagQuad.as
================================================
package feathers.tests.supportClasses
{
	import starling.display.Quad;

	public class DisposeFlagQuad extends Quad
	{
		public function DisposeFlagQuad()
		{
			super(1, 1, 0xff00ff);
		}

		public var isDisposed:Boolean = false;

		override public function dispose():void
		{
			super.dispose();
			this.isDisposed = true;
		}
	}
}

================================================
FILE: test/source/feathers/tests/supportClasses/ScrollerViewPort.as
================================================
package feathers.tests.supportClasses
{
	import feathers.controls.supportClasses.IViewPort;
	import feathers.core.FeathersControl;

	public class ScrollerViewPort extends FeathersControl implements IViewPort
	{
		public function ScrollerViewPort()
		{
		}

		private var _actualMinVisibleWidth:Number = 0;

		private var _explicitMinVisibleWidth:Number;

		public function get minVisibleWidth():Number
		{
			if(this._explicitMinWidth === this._explicitMinWidth) //!isNaN
			{
				return this._explicitMinWidth;
			}
			if(this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth) //isNaN
			{
				return this._actualMinVisibleWidth;
			}
			return this._explicitMinVisibleWidth;
		}

		public function set minVisibleWidth(value:Number):void
		{
			if(this._explicitMinVisibleWidth == value ||
				(value !== value && this._explicitMinVisibleWidth !== this._explicitMinVisibleWidth)) //isNaN
			{
				return;
			}
			this._explicitMinVisibleWidth = value;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		private var _maxVisibleWidth:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleWidth():Number
		{
			return this._maxVisibleWidth;
		}

		public function set maxVisibleWidth(value:Number):void
		{
			if(this._maxVisibleWidth == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleWidth cannot be NaN");
			}
			this._maxVisibleWidth = value;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		private var _actualVisibleWidth:Number = 0;

		private var _explicitVisibleWidth:Number = NaN;

		public function get visibleWidth():Number
		{
			if(this._explicitVisibleWidth !== this._explicitVisibleWidth) //isNaN
			{
				return this._actualVisibleWidth;
			}
			return this._explicitVisibleWidth;
		}

		public function set visibleWidth(value:Number):void
		{
			if(this._explicitVisibleWidth == value ||
			(value !== value && this._explicitVisibleWidth !== this._explicitVisibleWidth)) //isNaN
			{
				return;
			}
			this._explicitVisibleWidth = value;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		private var _actualMinVisibleHeight:Number = 0;

		private var _explicitMinVisibleHeight:Number;

		public function get minVisibleHeight():Number
		{
			if(this._explicitMinHeight === this._explicitMinHeight) //!isNaN
			{
				return this._explicitMinHeight;
			}
			if(this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight) //isNaN
			{
				return this._actualMinVisibleHeight;
			}
			return this._explicitMinVisibleHeight;
		}

		public function set minVisibleHeight(value:Number):void
		{
			if(this._explicitMinVisibleHeight == value ||
				(value !== value && this._explicitMinVisibleHeight !== this._explicitMinVisibleHeight)) //isNaN
			{
				return;
			}
			this._explicitMinVisibleHeight = value;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		private var _maxVisibleHeight:Number = Number.POSITIVE_INFINITY;

		public function get maxVisibleHeight():Number
		{
			return this._maxVisibleHeight;
		}

		public function set maxVisibleHeight(value:Number):void
		{
			if(this._maxVisibleHeight == value)
			{
				return;
			}
			if(value !== value) //isNaN
			{
				throw new ArgumentError("maxVisibleHeight cannot be NaN");
			}
			this._maxVisibleHeight = value;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		private var _actualVisibleHeight:Number = 0;

		private var _explicitVisibleHeight:Number = NaN;

		public function get visibleHeight():Number
		{
			if(this._explicitVisibleHeight !== this._explicitVisibleHeight) //isNaN
			{
				return this._actualVisibleHeight;
			}
			return this._explicitVisibleHeight;
		}

		public function set visibleHeight(value:Number):void
		{
			if(this._explicitVisibleHeight == value ||
				(value !== value && this._explicitVisibleHeight !== this._explicitVisibleHeight)) //isNaN
			{
				return;
			}
			this._explicitVisibleHeight = value;
			this.invalidate(INVALIDATION_FLAG_SIZE);
		}

		private var _contentX:Number = 0;

		public function get contentX():Number
		{
			return this._contentX;
		}

		public function set contentX(value:Number):void
		{
			this._contentX = value;
		}

		private var _contentY:Number = 0;

		public function get contentY():Number
		{
			return this._contentY;
		}

		public function set contentY(value:Number):void
		{
			this._contentY = value;
		}
		
		private var _horizontalScrollStep:Number = 1;

		public function get horizontalScrollStep():Number
		{
			return this._horizontalScrollStep;
		}

		public function set horizontalScrollStep(value:Number):void
		{
			this._horizontalScrollStep = value;
		}

		private var _verticalScrollStep:Number = 1;

		public function get verticalScrollStep():Number
		{
			return this._verticalScrollStep;
		}

		public function set verticalScrollStep(value:Number):void
		{
			this._verticalScrollStep = value;
		}

		private var _horizontalScrollPosition:Number = 0;

		public function get horizontalScrollPosition():Number
		{
			return this._horizontalScrollPosition;
		}

		public function set horizontalScrollPosition(value:Number):void
		{
			if(this._horizontalScrollPosition == value)
			{
				return;
			}
			this._horizontalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		private var _verticalScrollPosition:Number = 0;

		public function get verticalScrollPosition():Number
		{
			return this._verticalScrollPosition;
		}

		public function set verticalScrollPosition(value:Number):void
		{
			if(this._verticalScrollPosition == value)
			{
				return;
			}
			this._verticalScrollPosition = value;
			this.invalidate(INVALIDATION_FLAG_SCROLL);
		}

		override public function set width(value:Number):void
		{
			super.width = value;
			this._actualVisibleWidth = value;
		}

		override public function set height(value:Number):void
		{
			super.height = value;
			this._actualVisibleHeight = value;
		}

		private var _requiresMeasurementOnScroll:Boolean = false;

		public function get requiresMeasurementOnScroll():Boolean
		{
			return this._requiresMeasurementOnScroll;
		}

		public function set requiresMeasurementOnScroll(value:Boolean):void
		{
			this._requiresMeasurementOnScroll = value;
		}

		private var _resizeOnScroll:Boolean = false;

		public function get resizeOnScroll():Boolean
		{
			return this._resizeOnScroll;
		}

		public function set resizeOnScroll(value:Boolean):void
		{
			this._resizeOnScroll = value;
		}
		
		override protected function draw():void
		{
			if(this._resizeOnScroll && this.isInvalid(INVALIDATION_FLAG_SCROLL))
			{
				super.width = this.width + 1;
				super.height = this.height + 1;
			}
			super.draw();
		}
	}
}


================================================
FILE: themes/AeonDesktopTheme/README.md
================================================
# Aeon Desktop Theme for Feathers

This [Feathers](http://feathersui.com/) theme for desktop is based on the theme used by the Flash Professional and the Flex MX component sets.

## Original Artwork

This theme's texture atlas was exported from Adobe Animate CC. To modify colors and other properties, or to add new skins to the texture atlas, [download the source FLA file](http://feathersui.com/help/theme-sources.html) from the Feathers website.

## Credits

The Aeon theme is originally designed by Adobe Systems Incorporated. Contains modifications by [Josh Tynjala](https://joshblog.net/).

================================================
FILE: themes/AeonDesktopTheme/assets/images/aeon_desktop.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<TextureAtlas imagePath="aeon_desktop.png">
	<!-- Created with Adobe Animate version 16.5.1.104 -->
	<!-- http://www.adobe.com/products/animate.html -->
	<SubTexture name="alert-background-skin0000" x="348" y="306" width="22" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="back-button-disabled-icon0000" x="444" y="296" width="9" height="15" pivotX="0" pivotY="0"/>
	<SubTexture name="back-button-up-icon0000" x="372" y="306" width="9" height="15" pivotX="0" pivotY="0"/>
	<SubTexture name="button-disabled-skin0000" x="282" y="172" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="button-down-skin0000" x="2" y="180" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="button-hover-skin0000" x="26" y="180" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="button-up-skin0000" x="50" y="180" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="call-to-action-button-hover-skin0000" x="74" y="180" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="call-to-action-button-up-skin0000" x="98" y="180" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-background-skin0000" x="90" y="286" width="26" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-bottom-arrow-skin0000" x="436" y="194" width="24" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-left-arrow-skin0000" x="486" y="294" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-right-arrow-skin0000" x="418" y="296" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-top-arrow-skin0000" x="386" y="298" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="check-disabled-icon0000" x="126" y="226" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="check-down-icon0000" x="156" y="226" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="check-hover-icon0000" x="186" y="226" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="check-selected-disabled-icon0000" x="216" y="226" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="check-selected-down-icon0000" x="436" y="236" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="check-selected-hover-icon0000" x="466" y="236" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="check-selected-up-icon0000" x="400" y="240" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="check-up-icon0000" x="296" y="246" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-button-down-skin0000" x="122" y="180" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-button-hover-skin0000" x="146" y="180" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-button-up-skin0000" x="170" y="180" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-background-skin0000" x="118" y="286" width="26" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-bottom-arrow-skin0000" x="360" y="278" width="24" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-left-arrow-skin0000" x="270" y="304" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-right-arrow-skin0000" x="296" y="304" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-top-arrow-skin0000" x="322" y="306" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-column-drop-indicator-skin0000" x="306" y="172" width="6" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-column-resize-skin0000" x="506" y="122" width="2" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-background-skin0000" x="278" y="108" width="6" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-divider-skin0000" x="450" y="222" width="10" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-sort-ascending-icon0000" x="154" y="314" width="14" height="9" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-sort-descending-icon0000" x="254" y="308" width="14" height="9" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-vertical-divider-skin0000" x="506" y="122" width="2" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="drill-down-icon0000" x="230" y="286" width="9" height="15" pivotX="0" pivotY="0"/>
	<SubTexture name="focus-indicator-skin0000" x="62" y="286" width="26" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="forward-button-disabled-icon0000" x="418" y="270" width="9" height="15" pivotX="0" pivotY="0"/>
	<SubTexture name="forward-button-up-icon0000" x="230" y="286" width="9" height="15" pivotX="0" pivotY="0"/>
	<SubTexture name="full-screen-toggle-button-enter-up-icon0000" x="460" y="294" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="full-screen-toggle-button-exit-up-icon0000" x="30" y="288" width="25" height="25" pivotX="0" pivotY="0"/>
	<SubTexture name="grouped-list-header-background-skin0000" x="490" y="36" width="8" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="header-background-skin0000" x="500" y="2" width="8" height="62" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-decrement-button-icon0000" x="444" y="313" width="9" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-increment-button-icon0000" x="143" y="314" width="9" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-step-button-disabled-skin0000" x="370" y="216" width="28" height="30" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-step-button-down-skin0000" x="266" y="218" width="28" height="30" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-step-button-hover-skin0000" x="2" y="226" width="28" height="30" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-step-button-up-skin0000" x="32" y="226" width="28" height="30" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-thumb-down-skin0000" x="288" y="2" width="104" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-thumb-hover-skin0000" x="394" y="2" width="104" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-thumb-icon0000" x="496" y="250" width="14" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-thumb-up-skin0000" x="288" y="36" width="104" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-track-skin0000" x="500" y="66" width="8" height="30" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-slider-thumb-disabled-skin0000" x="146" y="286" width="26" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-slider-thumb-down-skin0000" x="174" y="286" width="26" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-slider-thumb-hover-skin0000" x="202" y="286" width="26" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-slider-thumb-up-skin0000" x="2" y="288" width="26" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-slider-track-disabled-skin0000" x="492" y="284" width="14" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-slider-track-enabled-skin0000" x="170" y="314" width="14" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-volume-slider-maximum-track-skin0000" x="316" y="142" width="100" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-volume-slider-minimum-track-skin0000" x="150" y="126" width="100" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="inset-border-background-skin0000" x="490" y="122" width="14" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-hover-skin0000" x="266" y="196" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-selected-up-skin0000" x="436" y="222" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-up-skin0000" x="496" y="236" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="mute-toggle-button-loud-up-icon0000" x="460" y="266" width="30" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="mute-toggle-button-muted-up-icon0000" x="386" y="270" width="30" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="numeric-stepper-decrement-button-disabled-skin0000" x="350" y="104" width="42" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="numeric-stepper-decrement-button-down-skin0000" x="462" y="138" width="42" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="numeric-stepper-decrement-button-hover-skin0000" x="418" y="142" width="42" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="numeric-stepper-decrement-button-up-skin0000" x="150" y="154" width="42" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="numeric-stepper-increment-button-disabled-skin0000" x="194" y="154" width="42" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="numeric-stepper-increment-button-down-skin0000" x="238" y="154" width="42" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="numeric-stepper-increment-button-hover-skin0000" x="462" y="164" width="42" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="numeric-stepper-increment-button-up-skin0000" x="418" y="168" width="42" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="overlay-play-pause-toggle-button-play-up-icon0000" x="2" y="2" width="146" height="176" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-normal-symbol0000" x="246" y="226" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-selected-symbol0000" x="276" y="250" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="panel-background-skin0000" x="230" y="308" width="22" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-disabled-icon0000" x="326" y="246" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-down-icon0000" x="356" y="248" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-hover-icon0000" x="246" y="250" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-up-icon0000" x="62" y="256" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="play-pause-toggle-button-pause-up-icon0000" x="490" y="98" width="20" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="play-pause-toggle-button-play-up-icon0000" x="103" y="314" width="20" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="pop-up-volume-slider-maximum-track-skin0000" x="150" y="2" width="50" height="122" pivotX="0" pivotY="0"/>
	<SubTexture name="pop-up-volume-slider-minimum-track-skin0000" x="202" y="2" width="50" height="122" pivotX="0" pivotY="0"/>
	<SubTexture name="progress-bar-fill-skin0000" x="386" y="248" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="quiet-button-hover-skin0000" x="194" y="180" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-disabled-icon0000" x="92" y="256" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-down-icon0000" x="122" y="256" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-hover-icon0000" x="152" y="256" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-disabled-icon0000" x="182" y="256" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-down-icon0000" x="212" y="256" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-hover-icon0000" x="2" y="258" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-up-icon0000" x="32" y="258" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-up-icon0000" x="430" y="266" width="28" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="search-disabled-icon0000" x="57" y="314" width="21" height="21" pivotX="0" pivotY="0"/>
	<SubTexture name="search-icon0000" x="80" y="314" width="21" height="21" pivotX="0" pivotY="0"/>
	<SubTexture name="seek-slider-maximum-track-skin0000" x="30" y="315" width="11" height="8" pivotX="1" pivotY="0"/>
	<SubTexture name="seek-slider-minimum-track-skin0000" x="43" y="315" width="11" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="seek-slider-progress-skin0000" x="2" y="316" width="10" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="simple-border-background-skin0000" x="266" y="180" width="14" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-disabled-skin0000" x="218" y="180" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-down-skin0000" x="340" y="170" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-hover-skin0000" x="364" y="170" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-selected-disabled-skin0000" x="388" y="170" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-selected-up-skin0000" x="462" y="190" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-up-skin0000" x="242" y="180" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="text-input-background-disabled-skin0000" x="210" y="314" width="10" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="text-input-background-enabled-skin0000" x="186" y="314" width="10" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="text-input-background-error-skin0000" x="198" y="314" width="10" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="toggle-button-selected-disabled-skin0000" x="254" y="108" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="toggle-button-selected-down-skin0000" x="316" y="170" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="toggle-button-selected-hover-skin0000" x="486" y="190" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="toggle-button-selected-up-skin0000" x="412" y="194" width="22" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="tool-tip-background-skin0000" x="90" y="286" width="26" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-branch-closed-icon0000" x="316" y="70" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-branch-open-icon0000" x="350" y="70" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-closed-icon0000" x="492" y="266" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-open-icon0000" x="125" y="314" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-leaf-icon0000" x="316" y="104" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-decrement-button-icon0000" x="154" y="314" width="14" height="9" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-increment-button-icon0000" x="254" y="308" width="14" height="9" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-step-button-disabled-skin0000" x="62" y="226" width="30" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-step-button-down-skin0000" x="94" y="226" width="30" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-step-button-hover-skin0000" x="306" y="216" width="30" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-step-button-up-skin0000" x="338" y="216" width="30" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-thumb-down-skin0000" x="394" y="36" width="32" height="104" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-thumb-hover-skin0000" x="428" y="36" width="32" height="104" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-thumb-icon0000" x="400" y="216" width="10" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-thumb-up-skin0000" x="254" y="2" width="32" height="104" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-track-skin0000" x="350" y="130" width="31" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-slider-thumb-disabled-skin0000" x="332" y="278" width="26" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-slider-thumb-down-skin0000" x="242" y="280" width="26" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-slider-thumb-hover-skin0000" x="304" y="276" width="26" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-slider-thumb-up-skin0000" x="276" y="276" width="26" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-slider-track-disabled-skin0000" x="384" y="70" width="8" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-slider-track-enabled-skin0000" x="384" y="86" width="8" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-volume-slider-maximum-track-skin0000" x="462" y="36" width="26" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-volume-slider-minimum-track-skin0000" x="288" y="70" width="26" height="100" pivotX="0" pivotY="0"/>
</TextureAtlas>


================================================
FILE: themes/AeonDesktopTheme/package-src.json
================================================
{
	"id": "feathersui_AeonDesktopTheme-source",
	"name": "Feathers UI Aeon Desktop Theme",
	"url": "https://feathersui.com/as3-starling/",
	"docUrl": "https://feathersui/api-reference/",
	"description": "Aeon desktop theme for Feathers UI (Starling version)",
	"type": "src",
	"version": "4.2.0",
	"sourceUrl": "https://github.com/feathersui/feathersui-starling/releases/download/v4.2.0/feathersui_AeonDesktopTheme-source_4.2.0.airpackage",
	"publishedAt": "2021-11-19T00:00:00.000Z",
	"dependencies": [
		"starling-source:2.x.x",
		"feathersui-source:4.2.x"
	],
	"parameters": [],
	"tags": ["theme", "feathers", "starling"],
	"status": "release",
	"license": {
	  "type": "Simplified BSD",
	  "url": "https://github.com/feathersui/feathersui-starling/blob/v4.2.0/LICENSE.md",
	  "public": true
	}
  }
  

================================================
FILE: themes/AeonDesktopTheme/package-swc.json
================================================
{
	"id": "feathersui_AeonDesktopTheme",
	"name": "Feathers UI Aeon Desktop Theme",
	"url": "https://feathersui.com/as3-starling/",
	"docUrl": "https://feathersui/api-reference/",
	"description": "Aeon desktop theme for Feathers UI (Starling version)",
	"type": "swc",
	"version": "4.2.0",
	"sourceUrl": "https://github.com/feathersui/feathersui-starling/releases/download/v4.2.0/feathersui_AeonDesktopTheme_4.2.0.airpackage",
	"publishedAt": "2021-11-19T00:00:00.000Z",
	"dependencies": [
		"starling:2.x.x",
		"feathersui:4.2.x"
	],
	"parameters": [],
	"tags": ["theme", "feathers", "starling"],
	"status": "release",
	"license": {
	  "type": "Simplified BSD",
	  "url": "https://github.com/feathersui/feathersui-starling/blob/v4.2.0/LICENSE.md",
	  "public": true
	}
  }
  

================================================
FILE: themes/AeonDesktopTheme/source/feathers/themes/AeonDesktopTheme.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import flash.display.Bitmap;
	import flash.display.BitmapData;

	import starling.textures.Texture;
	import starling.textures.TextureAtlas;

	/**
	 * The "Aeon" theme for desktop Feathers apps.
	 *
	 * <p>This version of the theme embeds its assets. To load assets at
	 * runtime, see <code>AeonDesktopThemeWithAssetManager</code> instead.</p>
	 *
	 * @see http://feathersui.com/help/theme-assets.html
	 */
	public class AeonDesktopTheme extends BaseAeonDesktopTheme
	{
		/**
		 * @private
		 */
		[Embed(source="/../assets/images/aeon_desktop.png")]
		protected static const ATLAS_BITMAP:Class;

		/**
		 * @private
		 */
		[Embed(source="/../assets/images/aeon_desktop.xml",mimeType="application/octet-stream")]
		protected static const ATLAS_XML:Class;

		/**
		 * @private
		 */
		protected static const ATLAS_SCALE_FACTOR:int = 2;

		/**
		 * Constructor.
		 */
		public function AeonDesktopTheme()
		{
			super();
			this.initialize();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this.initializeTextureAtlas();
			super.initialize();
		}

		/**
		 * @private
		 */
		protected function initializeTextureAtlas():void
		{
			var atlasBitmapData:BitmapData = Bitmap(new ATLAS_BITMAP()).bitmapData;
			var atlasTexture:Texture = Texture.fromBitmapData(atlasBitmapData, false, false, ATLAS_SCALE_FACTOR);
			atlasTexture.root.onRestore = this.atlasTexture_onRestore;
			atlasBitmapData.dispose();
			this.atlas = new TextureAtlas(atlasTexture, XML(new ATLAS_XML()));
		}

		/**
		 * @private
		 */
		protected function atlasTexture_onRestore():void
		{
			var atlasBitmapData:BitmapData = Bitmap(new ATLAS_BITMAP()).bitmapData;
			this.atlas.texture.root.uploadBitmapData(atlasBitmapData);
			atlasBitmapData.dispose();
		}
	}
}


================================================
FILE: themes/AeonDesktopTheme/source/feathers/themes/AeonDesktopThemeWithAssetManager.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import feathers.events.FeathersEventType;

	import starling.assets.AssetManager;
	import starling.core.Starling;
	import starling.events.Event;

	/**
	 * @copy feathers.themes.IAsyncTheme#event:complete
	 *
	 * @eventType starling.events.Event.COMPLETE
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * Dispatched when the theme's assets fail to load due to an error.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The error string.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.ERROR
	 */
	[Event(name="error",type="starling.events.Event")]

	/**
	 * The "Aeon" theme for desktop Feathers apps.
	 *
	 * <p>This version of the theme requires loading assets at runtime. To use
	 * embedded assets, see <code>AeonDesktopTheme</code> instead.</p>
	 *
	 * <p>To use this theme, the following files must be included when packaging
	 * your app:</p>
	 * <ul>
	 *     <li>images/aeon_desktop.png</li>
	 *     <li>images/aeon_desktop.xml</li>
	 * </ul>
	 *
	 * @see http://feathersui.com/help/theme-assets.html
	 */
	public class AeonDesktopThemeWithAssetManager extends BaseAeonDesktopTheme implements IAsyncTheme
	{
		/**
		 * @private
		 * The name of the texture atlas in the asset manager.
		 */
		protected static const ATLAS_NAME:String = "aeon_desktop";

		/**
		 * @private
		 */
		protected static const ATLAS_SCALE_FACTOR:int = 2;

		/**
		 * Constructor.
		 * @param assetsBasePath The root folder of the assets.
		 * @param assetManager An optional pre-created AssetManager. The scaleFactor property must be equal to Starling.contentScaleFactor. To load assets with a different scale factor, use multiple AssetManager instances.
		 */
		public function AeonDesktopThemeWithAssetManager(assetsBasePath:String = "./", assetManager:AssetManager = null)
		{
			this.loadAssets(assetsBasePath, assetManager);
		}

		/**
		 * @private
		 */
		protected var assetManager:AssetManager;

		/**
		 * @private
		 */
		protected var isComplete:Boolean = false;

		/**
		 * @private
		 * The paths to each of the assets, relative to the base path.
		 */
		protected var assetPaths:Vector.<String> = new <String>
		[
			"images/" + ATLAS_NAME + ".xml",
			"images/" + ATLAS_NAME + ".png"
		];

		/**
		 * @private
		 */
		override public function dispose():void
		{
			super.dispose();
			if(this.assetManager)
			{
				this.assetManager.removeTextureAtlas(ATLAS_NAME);
				this.assetManager = null;
			}
		}

		/**
		 * @copy feathers.themes.IAsyncTheme#isCompleteForStarling()
		 */
		public function isCompleteForStarling(starling:Starling):Boolean
		{
			return this.isComplete;
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this.initializeTextureAtlas();
			super.initialize();
		}

		/**
		 * @private
		 */
		protected function initializeTextureAtlas():void
		{
			this.atlas = this.assetManager.getTextureAtlas(ATLAS_NAME);
		}

		/**
		 * @private
		 */
		protected function loadAssets(assetsBasePath:String, assetManager:AssetManager):void
		{
			var oldScaleFactor:Number = -1;
			if(assetManager)
			{
				oldScaleFactor = assetManager.textureOptions.scale;
				assetManager.textureOptions.scale = ATLAS_SCALE_FACTOR;
			}
			else
			{
				assetManager = new AssetManager(ATLAS_SCALE_FACTOR);
			}
			this.assetManager = assetManager;
			//add a trailing slash, if needed
			if(assetsBasePath.lastIndexOf("/") != assetsBasePath.length - 1)
			{
				assetsBasePath += "/";
			}
			var assetCount:int = this.assetPaths.length;
			for(var i:int = 0; i < assetCount; i++)
			{
				var asset:String = this.assetPaths[i];
				this.assetManager.enqueue(assetsBasePath + asset);
			}
			if(oldScaleFactor != -1)
			{
				//restore the old scale factor, just in case
				this.assetManager.textureOptions.scale = oldScaleFactor;
			}
			this.assetManager.loadQueue(assetManager_onComplete, assetManager_onError);
		}

		/**
		 * @private
		 */
		protected function assetManager_onComplete():void
		{
			this.initialize();
			this.isComplete = true;
			this.dispatchEventWith(Event.COMPLETE, false, Starling.current);
		}

		/**
		 * @private
		 */
		protected function assetManager_onError(error:String):void
		{
			this.dispatchEventWith(FeathersEventType.ERROR, false, error);
		}
	}
}


================================================
FILE: themes/AeonDesktopTheme/source/feathers/themes/BaseAeonDesktopTheme.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import feathers.controls.Alert;
	import feathers.controls.AutoComplete;
	import feathers.controls.AutoSizeMode;
	import feathers.controls.Button;
	import feathers.controls.ButtonGroup;
	import feathers.controls.ButtonState;
	import feathers.controls.Callout;
	import feathers.controls.Check;
	import feathers.controls.DataGrid;
	import feathers.controls.DateTimeSpinner;
	import feathers.controls.Drawers;
	import feathers.controls.GroupedList;
	import feathers.controls.Header;
	import feathers.controls.IScrollBar;
	import feathers.controls.ImageLoader;
	import feathers.controls.Label;
	import feathers.controls.LayoutGroup;
	import feathers.controls.List;
	import feathers.controls.NumericStepper;
	import feathers.controls.PageIndicator;
	import feathers.controls.PageIndicatorInteractionMode;
	import feathers.controls.Panel;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.controls.ProgressBar;
	import feathers.controls.Radio;
	import feathers.controls.ScrollBar;
	import feathers.controls.ScrollBarDisplayMode;
	import feathers.controls.ScrollContainer;
	import feathers.controls.ScrollInteractionMode;
	import feathers.controls.ScrollPolicy;
	import feathers.controls.ScrollScreen;
	import feathers.controls.ScrollText;
	import feathers.controls.Scroller;
	import feathers.controls.SimpleScrollBar;
	import feathers.controls.Slider;
	import feathers.controls.SpinnerList;
	import feathers.controls.StepperButtonLayoutMode;
	import feathers.controls.TabBar;
	import feathers.controls.TextArea;
	import feathers.controls.TextCallout;
	import feathers.controls.TextInput;
	import feathers.controls.TextInputState;
	import feathers.controls.Toast;
	import feathers.controls.ToggleButton;
	import feathers.controls.ToggleSwitch;
	import feathers.controls.TrackLayoutMode;
	import feathers.controls.Tree;
	import feathers.controls.popups.DropDownPopUpContentManager;
	import feathers.controls.renderers.BaseDefaultItemRenderer;
	import feathers.controls.renderers.DefaultDataGridCellRenderer;
	import feathers.controls.renderers.DefaultDataGridHeaderRenderer;
	import feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer;
	import feathers.controls.renderers.DefaultGroupedListItemRenderer;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.DefaultTreeItemRenderer;
	import feathers.controls.text.TextFieldTextEditor;
	import feathers.controls.text.TextFieldTextEditorViewPort;
	import feathers.controls.text.TextFieldTextRenderer;
	import feathers.core.FeathersControl;
	import feathers.core.FocusManager;
	import feathers.core.ITextEditor;
	import feathers.core.ITextRenderer;
	import feathers.core.PopUpManager;
	import feathers.core.ToolTipManager;
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.RelativePosition;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.media.FullScreenToggleButton;
	import feathers.media.MuteToggleButton;
	import feathers.media.PlayPauseToggleButton;
	import feathers.media.SeekSlider;
	import feathers.media.VolumeSlider;
	import feathers.skins.ImageSkin;
	import feathers.themes.BaseAeonDesktopTheme;

	import flash.geom.Rectangle;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Image;
	import starling.display.Quad;
	import starling.display.Stage;
	import starling.text.TextFormat;
	import starling.textures.Texture;
	import starling.textures.TextureAtlas;

	/**
	 * The base class for the "Aeon" theme for desktop Feathers apps. Handles
	 * everything except asset loading, which is left to subclasses.
	 *
	 * @see AeonDesktopTheme
	 * @see AeonDesktopThemeWithAssetManager
	 */
	public class BaseAeonDesktopTheme extends StyleNameFunctionTheme
	{
		/**
		 * @private
		 * The theme's custom style name for the increment button of a horizontal ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_INCREMENT_BUTTON:String = "aeon-horizontal-scroll-bar-increment-button";

		/**
		 * @private
		 * The theme's custom style name for the decrement button of a horizontal ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_DECREMENT_BUTTON:String = "aeon-horizontal-scroll-bar-decrement-button";

		/**
		 * @private
		 * The theme's custom style name for the thumb of a horizontal ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_THUMB:String = "aeon-horizontal-scroll-bar-thumb";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a horizontal ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_MINIMUM_TRACK:String = "aeon-horizontal-scroll-bar-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the increment button of a vertical ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_INCREMENT_BUTTON:String = "aeon-vertical-scroll-bar-increment-button";

		/**
		 * @private
		 * The theme's custom style name for the decrement button of a vertical ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_DECREMENT_BUTTON:String = "aeon-vertical-scroll-bar-decrement-button";

		/**
		 * @private
		 * The theme's custom style name for the thumb of a vertical ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_THUMB:String = "aeon-vertical-scroll-bar-thumb";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a vertical ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_MINIMUM_TRACK:String = "aeon-vertical-scroll-bar-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the thumb of a horizontal SimpleScrollBar.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SIMPLE_SCROLL_BAR_THUMB:String = "aeon-horizontal-simple-scroll-bar-thumb";

		/**
		 * @private
		 * The theme's custom style name for the thumb of a vertical SimpleScrollBar.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SIMPLE_SCROLL_BAR_THUMB:String = "aeon-vertical-simple-scroll-bar-thumb";

		/**
		 * @private
		 * The theme's custom style name for the thumb of a horizontal Slider.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SLIDER_THUMB:String = "aeon-horizontal-slider-thumb";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a horizontal Slider.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK:String = "aeon-horizontal-slider-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the thumb of a vertical Slider.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SLIDER_THUMB:String = "aeon-vertical-slider-thumb";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a vertical Slider.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK:String = "aeon-vertical-slider-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a vertical VolumeSlider.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_VOLUME_SLIDER_MINIMUM_TRACK:String = "aeon-vertical-volume-slider-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the maximum track of a vertical VolumeSlider.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_VOLUME_SLIDER_MAXIMUM_TRACK:String = "aeon-vertical-volume-slider-maximum-track";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a horizontal VolumeSlider.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_VOLUME_SLIDER_MINIMUM_TRACK:String = "aeon-horizontal-volume-slider-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the maximum track of a horizontal VolumeSlider.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_VOLUME_SLIDER_MAXIMUM_TRACK:String = "aeon-horizontal-volume-slider-maximum-track";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a pop-up VolumeSlider.
		 */
		protected static const THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_MINIMUM_TRACK:String = "aeon-pop-up-volume-slider-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the maximum track of a pop-up VolumeSlider.
		 */
		protected static const THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_MAXIMUM_TRACK:String = "aeon-pop-up-volume-slider-maximum-track";

		/**
		 * @private
		 * The theme's custom style name for the item renderer of a SpinnerList in a DateTimeSpinner.
		 */
		protected static const THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER:String = "aeon-date-time-spinner-list-item-renderer";

		/**
		 * @private
		 * The theme's custom style name for the action buttons of a toast.
		 */
		protected static const THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON:String = "metal-works-mobile-toast-actions-button";

		/**
		 * The name of the font used by controls in this theme. This font is not
		 * embedded. It is the default sans-serif system font.
		 */
		public static const FONT_NAME:String = "_sans";

		protected static const FOCUS_INDICATOR_SCALE_9_GRID:Rectangle = new Rectangle(5, 5, 2, 2);
		protected static const TOOL_TIP_SCALE_9_GRID:Rectangle = new Rectangle(5, 5, 1, 1);
		protected static const CALLOUT_SCALE_9_GRID:Rectangle = new Rectangle(5, 5, 1, 1);
		protected static const BUTTON_SCALE_9_GRID:Rectangle = new Rectangle(5, 5, 1, 12);
		protected static const TAB_SCALE_9_GRID:Rectangle = new Rectangle(5, 5, 1, 15);
		protected static const STEPPER_INCREMENT_BUTTON_SCALE_9_GRID:Rectangle = new Rectangle(1, 9, 15, 1);
		protected static const STEPPER_DECREMENT_BUTTON_SCALE_9_GRID:Rectangle = new Rectangle(1, 1, 15, 1);
		protected static const HORIZONTAL_SLIDER_TRACK_SCALE_9_GRID:Rectangle = new Rectangle(3, 0, 1, 4);
		protected static const VERTICAL_SLIDER_TRACK_SCALE_9_GRID:Rectangle = new Rectangle(0, 3, 4, 1);
		protected static const TEXT_INPUT_SCALE_9_GRID:Rectangle = new Rectangle(2, 2, 1, 1);
		protected static const VERTICAL_SCROLL_BAR_THUMB_SCALE_9_GRID:Rectangle = new Rectangle(2, 5, 6, 42);
		protected static const VERTICAL_SCROLL_BAR_TRACK_SCALE_9_GRID:Rectangle = new Rectangle(2, 1, 11, 2);
		protected static const VERTICAL_SCROLL_BAR_STEP_BUTTON_SCALE_9_GRID:Rectangle = new Rectangle(2, 2, 11, 10);
		protected static const HORIZONTAL_SCROLL_BAR_THUMB_SCALE_9_GRID:Rectangle = new Rectangle(5, 2, 42, 6);
		protected static const HORIZONTAL_SCROLL_BAR_TRACK_SCALE_9_GRID:Rectangle = new Rectangle(1, 2, 2, 11);
		protected static const HORIZONTAL_SCROLL_BAR_STEP_BUTTON_SCALE_9_GRID:Rectangle = new Rectangle(2, 2, 10, 11);
		protected static const SIMPLE_BORDER_SCALE_9_GRID:Rectangle = new Rectangle(2, 2, 2, 2);
		protected static const PANEL_BORDER_SCALE_9_GRID:Rectangle = new Rectangle(5, 5, 1, 1);
		protected static const HEADER_SCALE_9_GRID:Rectangle = new Rectangle(1, 1, 2, 28);
		protected static const SEEK_SLIDER_MINIMUM_TRACK_SCALE_9_GRID:Rectangle = new Rectangle(3, 0, 1, 4);
		protected static const SEEK_SLIDER_MAXIMUM_TRACK_SCALE_9_GRID:Rectangle = new Rectangle(1, 0, 1, 4);
		protected static const DATA_GRID_VERTICAL_DIVIDER_SCALE_9_GRID:Rectangle = new Rectangle(0, 2, 1, 2);
		protected static const DATA_GRID_HEADER_DIVIDER_SCALE_9_GRID:Rectangle = new Rectangle(0, 2, 5, 2);
		protected static const DATA_GRID_COLUMN_DROP_INDICATOR_SCALE_9_GRID:Rectangle = new Rectangle(0, 2, 3, 2);
		
		protected static const ITEM_RENDERER_SKIN_TEXTURE_REGION:Rectangle = new Rectangle(1, 1, 4, 4);
		protected static const PROGRESS_BAR_FILL_TEXTURE_REGION:Rectangle = new Rectangle(1, 1, 4, 4);

		protected static const BACKGROUND_COLOR:uint = 0x869CA7;
		protected static const MODAL_OVERLAY_COLOR:uint = 0xDDDDDD;
		protected static const MODAL_OVERLAY_ALPHA:Number = 0.5;
		protected static const PRIMARY_TEXT_COLOR:uint = 0x0B333C;
		protected static const DISABLED_TEXT_COLOR:uint = 0x5B6770;
		protected static const INVERTED_TEXT_COLOR:uint = 0xffffff;
		protected static const ACTIVE_TEXT_COLOR:uint = 0x009dff;
		protected static const VIDEO_OVERLAY_COLOR:uint = 0xc9e0eE;
		protected static const VIDEO_OVERLAY_ALPHA:Number = 0.25;

		/**
		 * The default global text renderer factory for this theme creates a
		 * TextFieldTextRenderer.
		 */
		protected static function textRendererFactory():ITextRenderer
		{
			return new TextFieldTextRenderer();
		}

		/**
		 * The default global text editor factory for this theme creates a
		 * TextFieldTextEditor.
		 */
		protected static function textEditorFactory():ITextEditor
		{
			return new TextFieldTextEditor();
		}

		/**
		 * This theme's scroll bar type is ScrollBar.
		 */
		protected static function scrollBarFactory():IScrollBar
		{
			return new ScrollBar();
		}

		protected static function popUpOverlayFactory():DisplayObject
		{
			var quad:Quad = new Quad(100, 100, MODAL_OVERLAY_COLOR);
			quad.alpha = MODAL_OVERLAY_ALPHA;
			return quad;
		}

		/**
		 * Constructor.
		 */
		public function BaseAeonDesktopTheme()
		{
			super();
		}

		/**
		 * A smaller font size for details.
		 */
		protected var smallFontSize:int = 10;

		/**
		 * A normal font size.
		 */
		protected var regularFontSize:int = 11;

		/**
		 * A larger font size for headers.
		 */
		protected var largeFontSize:int = 13;

		/**
		 * The size, in pixels, of major regions in the grid. Used for sizing
		 * containers and larger UI controls.
		 */
		protected var gridSize:int = 30;

		/**
		 * The size, in pixels, of minor regions in the grid. Used for larger
		 * padding and gaps.
		 */
		protected var gutterSize:int = 10;

		/**
		 * The size, in pixels, of smaller padding and gaps within the major
		 * regions in the grid.
		 */
		protected var smallGutterSize:int = 6;

		/**
		 * The size, in pixels, of very smaller padding and gaps.
		 */
		protected var extraSmallGutterSize:int = 2;

		/**
		 * The minimum width, in pixels, of some types of buttons.
		 */
		protected var buttonMinWidth:int = 40;

		/**
		 * The width, in pixels, of UI controls that span across multiple grid regions.
		 */
		protected var wideControlSize:int = 152;

		/**
		 * The width, in pixels, of very large UI controls.
		 */
		protected var extraWideControlSize:int = 210;

		/**
		 * The size, in pixels, of a typical UI control.
		 */
		protected var controlSize:int = 22;

		/**
		 * The size, in pixels, of smaller UI controls.
		 */
		protected var smallControlSize:int = 12;

		/**
		 * The size, in pixels, of a border around any control.
		 */
		protected var borderSize:int = 1;

		protected var calloutBackgroundMinSize:int = 5;
		protected var calloutArrowOverlapGap:int = -1;
		protected var progressBarFillMinSize:int = 7;
		protected var popUpSize:int = 354;
		protected var popUpVolumeSliderPaddingSize:int = 6;
		protected var bottomDropShadowSize:int = 3;
		protected var leftAndRightDropShadowSize:int = 1;

		/**
		 * The texture atlas that contains skins for this theme. This base class
		 * does not initialize this member variable. Subclasses are expected to
		 * load the assets somehow and set the <code>atlas</code> member
		 * variable before calling <code>initialize()</code>.
		 */
		protected var atlas:TextureAtlas;

		/**
		 * Font styles for most UI controls and text.
		 */
		protected var defaultFontStyles:TextFormat;

		/**
		 * Font styles for most disabled UI controls and text.
		 */
		protected var disabledFontStyles:TextFormat;

		/**
		 * Font styles for larger text.
		 */
		protected var headingFontStyles:TextFormat;

		/**
		 * Font styles for larger, disabled text.
		 */
		protected var headingDisabledFontStyles:TextFormat;

		/**
		 * Font styles for smaller text.
		 */
		protected var detailFontStyles:TextFormat;

		/**
		 * Font styles for smaller, disabled text.
		 */
		protected var detailDisabledFontStyles:TextFormat;

		/**
		 * Font styles for text on dark backgrounds.
		 */
		protected var invertedFontStyles:TextFormat;

		/**
		 * Font styles for toast actions.
		 */
		protected var toastActionFontStyles:TextFormat;

		/**
		 * Font styles for active toast actions.
		 */
		protected var toastActionActiveFontStyles:TextFormat;

		protected var focusIndicatorSkinTexture:Texture;
		protected var toolTipBackgroundSkinTexture:Texture;
		protected var calloutBackgroundSkinTexture:Texture;
		protected var calloutTopArrowSkinTexture:Texture;
		protected var calloutRightArrowSkinTexture:Texture;
		protected var calloutBottomArrowSkinTexture:Texture;
		protected var calloutLeftArrowSkinTexture:Texture;
		protected var dangerCalloutBackgroundSkinTexture:Texture;
		protected var dangerCalloutTopArrowSkinTexture:Texture;
		protected var dangerCalloutRightArrowSkinTexture:Texture;
		protected var dangerCalloutBottomArrowSkinTexture:Texture;
		protected var dangerCalloutLeftArrowSkinTexture:Texture;

		protected var buttonUpSkinTexture:Texture;
		protected var buttonHoverSkinTexture:Texture;
		protected var buttonDownSkinTexture:Texture;
		protected var buttonDisabledSkinTexture:Texture;
		protected var toggleButtonSelectedUpSkinTexture:Texture;
		protected var toggleButtonSelectedHoverSkinTexture:Texture;
		protected var toggleButtonSelectedDownSkinTexture:Texture;
		protected var toggleButtonSelectedDisabledSkinTexture:Texture;
		protected var quietButtonHoverSkinTexture:Texture;
		protected var callToActionButtonUpSkinTexture:Texture;
		protected var callToActionButtonHoverSkinTexture:Texture;
		protected var dangerButtonUpSkinTexture:Texture;
		protected var dangerButtonHoverSkinTexture:Texture;
		protected var dangerButtonDownSkinTexture:Texture;
		protected var backButtonUpIconTexture:Texture;
		protected var backButtonDisabledIconTexture:Texture;
		protected var forwardButtonUpIconTexture:Texture;
		protected var forwardButtonDisabledIconTexture:Texture;

		protected var tabUpSkinTexture:Texture;
		protected var tabHoverSkinTexture:Texture;
		protected var tabDownSkinTexture:Texture;
		protected var tabDisabledSkinTexture:Texture;
		protected var tabSelectedUpSkinTexture:Texture;
		protected var tabSelectedDisabledSkinTexture:Texture;

		protected var stepperIncrementButtonUpSkinTexture:Texture;
		protected var stepperIncrementButtonHoverSkinTexture:Texture;
		protected var stepperIncrementButtonDownSkinTexture:Texture;
		protected var stepperIncrementButtonDisabledSkinTexture:Texture;

		protected var stepperDecrementButtonUpSkinTexture:Texture;
		protected var stepperDecrementButtonHoverSkinTexture:Texture;
		protected var stepperDecrementButtonDownSkinTexture:Texture;
		protected var stepperDecrementButtonDisabledSkinTexture:Texture;

		protected var hSliderThumbUpSkinTexture:Texture;
		protected var hSliderThumbHoverSkinTexture:Texture;
		protected var hSliderThumbDownSkinTexture:Texture;
		protected var hSliderThumbDisabledSkinTexture:Texture;
		protected var hSliderTrackEnabledSkinTexture:Texture;

		protected var vSliderThumbUpSkinTexture:Texture;
		protected var vSliderThumbHoverSkinTexture:Texture;
		protected var vSliderThumbDownSkinTexture:Texture;
		protected var vSliderThumbDisabledSkinTexture:Texture;
		protected var vSliderTrackEnabledSkinTexture:Texture;

		protected var itemRendererUpSkinTexture:Texture;
		protected var itemRendererHoverSkinTexture:Texture;
		protected var itemRendererSelectedUpSkinTexture:Texture;

		protected var dataGridVerticalDividerSkinTexture:Texture;
		protected var dataGridHeaderBackgroundSkinTexture:Texture;
		protected var dataGridHeaderDividerSkinTexture:Texture;
		protected var dataGridHeaderSortAscendingIconTexture:Texture;
		protected var dataGridHeaderSortDescendingIconTexture:Texture;
		protected var dataGridColumnDropIndicatorSkinTexture:Texture;
		protected var dataGridColumnResizeSkinTexture:Texture;

		protected var headerBackgroundSkinTexture:Texture;
		protected var groupedListHeaderBackgroundSkinTexture:Texture;

		protected var checkUpIconTexture:Texture;
		protected var checkHoverIconTexture:Texture;
		protected var checkDownIconTexture:Texture;
		protected var checkDisabledIconTexture:Texture;
		protected var checkSelectedUpIconTexture:Texture;
		protected var checkSelectedHoverIconTexture:Texture;
		protected var checkSelectedDownIconTexture:Texture;
		protected var checkSelectedDisabledIconTexture:Texture;

		protected var radioUpIconTexture:Texture;
		protected var radioHoverIconTexture:Texture;
		protected var radioDownIconTexture:Texture;
		protected var radioDisabledIconTexture:Texture;
		protected var radioSelectedUpIconTexture:Texture;
		protected var radioSelectedHoverIconTexture:Texture;
		protected var radioSelectedDownIconTexture:Texture;
		protected var radioSelectedDisabledIconTexture:Texture;

		protected var pageIndicatorNormalSkinTexture:Texture;
		protected var pageIndicatorSelectedSkinTexture:Texture;

		protected var pickerListUpIconTexture:Texture;
		protected var pickerListHoverIconTexture:Texture;
		protected var pickerListDownIconTexture:Texture;
		protected var pickerListDisabledIconTexture:Texture;

		protected var textInputBackgroundEnabledSkinTexture:Texture;
		protected var textInputBackgroundDisabledSkinTexture:Texture;
		protected var textInputBackgroundErrorSkinTexture:Texture;
		protected var textInputSearchIconTexture:Texture;
		protected var textInputSearchIconDisabledTexture:Texture;

		protected var vScrollBarThumbUpSkinTexture:Texture;
		protected var vScrollBarThumbHoverSkinTexture:Texture;
		protected var vScrollBarThumbDownSkinTexture:Texture;
		protected var vScrollBarTrackSkinTexture:Texture;
		protected var vScrollBarThumbIconTexture:Texture;
		protected var vScrollBarStepButtonUpSkinTexture:Texture;
		protected var vScrollBarStepButtonHoverSkinTexture:Texture;
		protected var vScrollBarStepButtonDownSkinTexture:Texture;
		protected var vScrollBarStepButtonDisabledSkinTexture:Texture;
		protected var vScrollBarDecrementButtonIconTexture:Texture;
		protected var vScrollBarIncrementButtonIconTexture:Texture;

		protected var hScrollBarThumbUpSkinTexture:Texture;
		protected var hScrollBarThumbHoverSkinTexture:Texture;
		protected var hScrollBarThumbDownSkinTexture:Texture;
		protected var hScrollBarTrackSkinTexture:Texture;
		protected var hScrollBarThumbIconTexture:Texture;
		protected var hScrollBarStepButtonUpSkinTexture:Texture;
		protected var hScrollBarStepButtonHoverSkinTexture:Texture;
		protected var hScrollBarStepButtonDownSkinTexture:Texture;
		protected var hScrollBarStepButtonDisabledSkinTexture:Texture;
		protected var hScrollBarDecrementButtonIconTexture:Texture;
		protected var hScrollBarIncrementButtonIconTexture:Texture;

		protected var simpleBorderBackgroundSkinTexture:Texture;
		protected var insetBorderBackgroundSkinTexture:Texture;
		protected var panelBorderBackgroundSkinTexture:Texture;
		protected var alertBorderBackgroundSkinTexture:Texture;

		protected var progressBarFillSkinTexture:Texture;
		
		protected var listDrillDownAccessoryTexture:Texture;

		protected var treeBranchOpenIconTexture:Texture;
		protected var treeBranchClosedIconTexture:Texture;
		protected var treeLeafIconTexture:Texture;
		protected var treeDisclosureOpenIconTexture:Texture;
		protected var treeDisclosureClosedIconTexture:Texture;

		//media textures
		protected var playPauseButtonPlayUpIconTexture:Texture;
		protected var playPauseButtonPauseUpIconTexture:Texture;
		protected var overlayPlayPauseButtonPlayUpIconTexture:Texture;
		protected var fullScreenToggleButtonEnterUpIconTexture:Texture;
		protected var fullScreenToggleButtonExitUpIconTexture:Texture;
		protected var muteToggleButtonLoudUpIconTexture:Texture;
		protected var muteToggleButtonMutedUpIconTexture:Texture;
		protected var horizontalVolumeSliderMinimumTrackSkinTexture:Texture;
		protected var horizontalVolumeSliderMaximumTrackSkinTexture:Texture;
		protected var verticalVolumeSliderMinimumTrackSkinTexture:Texture;
		protected var verticalVolumeSliderMaximumTrackSkinTexture:Texture;
		protected var popUpVolumeSliderMinimumTrackSkinTexture:Texture;
		protected var popUpVolumeSliderMaximumTrackSkinTexture:Texture;
		protected var seekSliderMinimumTrackSkinTexture:Texture;
		protected var seekSliderMaximumTrackSkinTexture:Texture;
		protected var seekSliderProgressSkinTexture:Texture;

		/**
		 * Disposes the texture atlas before calling super.dispose()
		 */
		override public function dispose():void
		{
			if(this.atlas)
			{
				//if anything is keeping a reference to the texture, we don't
				//want it to keep a reference to the theme too.
				this.atlas.texture.root.onRestore = null;
				
				this.atlas.dispose();
				this.atlas = null;
			}

			var stage:Stage = this.starling.stage;
			FocusManager.setEnabledForStage(stage, false);
			ToolTipManager.setEnabledForStage(stage, false);

			//don't forget to call super.dispose()!
			super.dispose();
		}

		/**
		 * Initializes the theme. Expected to be called by subclasses after the
		 * assets have been loaded and the skin texture atlas has been created.
		 */
		protected function initialize():void
		{
			this.initializeFonts();
			this.initializeTextures();
			this.initializeGlobals();
			this.initializeStage();
			this.initializeStyleProviders();
		}

		/**
		 * Sets the stage background color.
		 */
		protected function initializeStage():void
		{
			this.starling.stage.color = BACKGROUND_COLOR;
			this.starling.nativeStage.color = BACKGROUND_COLOR;
		}

		/**
		 * Initializes global variables (not including global style providers).
		 */
		protected function initializeGlobals():void
		{
			var stage:Stage = this.starling.stage;
			FocusManager.setEnabledForStage(stage, true);
			ToolTipManager.setEnabledForStage(stage, true);

			FeathersControl.defaultTextRendererFactory = textRendererFactory;
			FeathersControl.defaultTextEditorFactory = textEditorFactory;

			PopUpManager.overlayFactory = popUpOverlayFactory;
			Callout.stagePadding = this.smallGutterSize;
			Toast.containerFactory = toastContainerFactory;
		}

		/**
		 * Initializes font sizes and formats.
		 */
		protected function initializeFonts():void
		{
			this.defaultFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, PRIMARY_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.disabledFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.headingFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, PRIMARY_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.headingDisabledFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.detailFontStyles = new TextFormat(FONT_NAME, this.smallFontSize, PRIMARY_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.detailDisabledFontStyles = new TextFormat(FONT_NAME, this.smallFontSize, DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.invertedFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, INVERTED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.toastActionFontStyles = new TextFormat(FONT_NAME, this.smallFontSize, PRIMARY_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.toastActionFontStyles.bold = true;
			this.toastActionActiveFontStyles = new TextFormat(FONT_NAME, this.smallFontSize, ACTIVE_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.toastActionActiveFontStyles.bold = true;
		}

		/**
		 * Initializes the textures by extracting them from the atlas and
		 * setting up any scaling grids that are needed.
		 */
		protected function initializeTextures():void
		{
			this.focusIndicatorSkinTexture = this.atlas.getTexture("focus-indicator-skin0000");
			this.toolTipBackgroundSkinTexture = this.atlas.getTexture("tool-tip-background-skin0000");
			this.calloutBackgroundSkinTexture = this.atlas.getTexture("callout-background-skin0000");
			this.calloutTopArrowSkinTexture = this.atlas.getTexture("callout-top-arrow-skin0000");
			this.calloutRightArrowSkinTexture = this.atlas.getTexture("callout-right-arrow-skin0000");
			this.calloutBottomArrowSkinTexture = this.atlas.getTexture("callout-bottom-arrow-skin0000");
			this.calloutLeftArrowSkinTexture = this.atlas.getTexture("callout-left-arrow-skin0000");
			this.dangerCalloutBackgroundSkinTexture = this.atlas.getTexture("danger-callout-background-skin0000");
			this.dangerCalloutTopArrowSkinTexture = this.atlas.getTexture("danger-callout-top-arrow-skin0000");
			this.dangerCalloutRightArrowSkinTexture = this.atlas.getTexture("danger-callout-right-arrow-skin0000");
			this.dangerCalloutBottomArrowSkinTexture = this.atlas.getTexture("danger-callout-bottom-arrow-skin0000");
			this.dangerCalloutLeftArrowSkinTexture = this.atlas.getTexture("danger-callout-left-arrow-skin0000");

			this.buttonUpSkinTexture = this.atlas.getTexture("button-up-skin0000");
			this.buttonHoverSkinTexture = this.atlas.getTexture("button-hover-skin0000");
			this.buttonDownSkinTexture = this.atlas.getTexture("button-down-skin0000");
			this.buttonDisabledSkinTexture = this.atlas.getTexture("button-disabled-skin0000");
			this.toggleButtonSelectedUpSkinTexture = this.atlas.getTexture("toggle-button-selected-up-skin0000");
			this.toggleButtonSelectedHoverSkinTexture = this.atlas.getTexture("toggle-button-selected-hover-skin0000");
			this.toggleButtonSelectedDownSkinTexture = this.atlas.getTexture("toggle-button-selected-down-skin0000");
			this.toggleButtonSelectedDisabledSkinTexture = this.atlas.getTexture("toggle-button-selected-disabled-skin0000");
			this.quietButtonHoverSkinTexture = this.atlas.getTexture("quiet-button-hover-skin0000");
			this.callToActionButtonUpSkinTexture = this.atlas.getTexture("call-to-action-button-up-skin0000");
			this.callToActionButtonHoverSkinTexture = this.atlas.getTexture("call-to-action-button-hover-skin0000");
			this.dangerButtonUpSkinTexture = this.atlas.getTexture("danger-button-up-skin0000");
			this.dangerButtonHoverSkinTexture = this.atlas.getTexture("danger-button-hover-skin0000");
			this.dangerButtonDownSkinTexture = this.atlas.getTexture("danger-button-down-skin0000");
			this.backButtonUpIconTexture = this.atlas.getTexture("back-button-up-icon0000");
			this.backButtonDisabledIconTexture = this.atlas.getTexture("back-button-disabled-icon0000");
			this.forwardButtonUpIconTexture = this.atlas.getTexture("forward-button-up-icon0000");
			this.forwardButtonDisabledIconTexture = this.atlas.getTexture("forward-button-disabled-icon0000");

			this.tabUpSkinTexture = this.atlas.getTexture("tab-up-skin0000");
			this.tabHoverSkinTexture = this.atlas.getTexture("tab-hover-skin0000");
			this.tabDownSkinTexture = this.atlas.getTexture("tab-down-skin0000");
			this.tabDisabledSkinTexture = this.atlas.getTexture("tab-disabled-skin0000");
			this.tabSelectedUpSkinTexture = this.atlas.getTexture("tab-selected-up-skin0000");
			this.tabSelectedDisabledSkinTexture = this.atlas.getTexture("tab-selected-disabled-skin0000");

			this.stepperIncrementButtonUpSkinTexture = this.atlas.getTexture("numeric-stepper-increment-button-up-skin0000");
			this.stepperIncrementButtonHoverSkinTexture = this.atlas.getTexture("numeric-stepper-increment-button-hover-skin0000");
			this.stepperIncrementButtonDownSkinTexture = this.atlas.getTexture("numeric-stepper-increment-button-down-skin0000");
			this.stepperIncrementButtonDisabledSkinTexture = this.atlas.getTexture("numeric-stepper-increment-button-disabled-skin0000");

			this.stepperDecrementButtonUpSkinTexture = this.atlas.getTexture("numeric-stepper-decrement-button-up-skin0000");
			this.stepperDecrementButtonHoverSkinTexture = this.atlas.getTexture("numeric-stepper-decrement-button-hover-skin0000");
			this.stepperDecrementButtonDownSkinTexture = this.atlas.getTexture("numeric-stepper-decrement-button-down-skin0000");
			this.stepperDecrementButtonDisabledSkinTexture = this.atlas.getTexture("numeric-stepper-decrement-button-disabled-skin0000");

			this.hSliderThumbUpSkinTexture = this.atlas.getTexture("horizontal-slider-thumb-up-skin0000");
			this.hSliderThumbHoverSkinTexture = this.atlas.getTexture("horizontal-slider-thumb-hover-skin0000");
			this.hSliderThumbDownSkinTexture = this.atlas.getTexture("horizontal-slider-thumb-down-skin0000");
			this.hSliderThumbDisabledSkinTexture = this.atlas.getTexture("horizontal-slider-thumb-disabled-skin0000");
			this.hSliderTrackEnabledSkinTexture = this.atlas.getTexture("horizontal-slider-track-enabled-skin0000");

			this.vSliderThumbUpSkinTexture = this.atlas.getTexture("vertical-slider-thumb-up-skin0000");
			this.vSliderThumbHoverSkinTexture = this.atlas.getTexture("vertical-slider-thumb-hover-skin0000");
			this.vSliderThumbDownSkinTexture = this.atlas.getTexture("vertical-slider-thumb-down-skin0000");
			this.vSliderThumbDisabledSkinTexture = this.atlas.getTexture("vertical-slider-thumb-disabled-skin0000");
			this.vSliderTrackEnabledSkinTexture = this.atlas.getTexture("vertical-slider-track-enabled-skin0000");

			this.itemRendererUpSkinTexture = Texture.fromTexture(this.atlas.getTexture("item-renderer-up-skin0000"), ITEM_RENDERER_SKIN_TEXTURE_REGION);
			this.itemRendererHoverSkinTexture = Texture.fromTexture(this.atlas.getTexture("item-renderer-hover-skin0000"), ITEM_RENDERER_SKIN_TEXTURE_REGION);
			this.itemRendererSelectedUpSkinTexture = Texture.fromTexture(this.atlas.getTexture("item-renderer-selected-up-skin0000"), ITEM_RENDERER_SKIN_TEXTURE_REGION);

			this.headerBackgroundSkinTexture = this.atlas.getTexture("header-background-skin0000");
			this.groupedListHeaderBackgroundSkinTexture = this.atlas.getTexture("grouped-list-header-background-skin0000");

			this.checkUpIconTexture = this.atlas.getTexture("check-up-icon0000");
			this.checkHoverIconTexture = this.atlas.getTexture("check-hover-icon0000");
			this.checkDownIconTexture = this.atlas.getTexture("check-down-icon0000");
			this.checkDisabledIconTexture = this.atlas.getTexture("check-disabled-icon0000");
			this.checkSelectedUpIconTexture = this.atlas.getTexture("check-selected-up-icon0000");
			this.checkSelectedHoverIconTexture = this.atlas.getTexture("check-selected-hover-icon0000");
			this.checkSelectedDownIconTexture = this.atlas.getTexture("check-selected-down-icon0000");
			this.checkSelectedDisabledIconTexture = this.atlas.getTexture("check-selected-disabled-icon0000");

			this.radioUpIconTexture = this.atlas.getTexture("radio-up-icon0000");
			this.radioHoverIconTexture = this.atlas.getTexture("radio-hover-icon0000");
			this.radioDownIconTexture = this.atlas.getTexture("radio-down-icon0000");
			this.radioDisabledIconTexture = this.atlas.getTexture("radio-disabled-icon0000");
			this.radioSelectedUpIconTexture = this.atlas.getTexture("radio-selected-up-icon0000");
			this.radioSelectedHoverIconTexture = this.atlas.getTexture("radio-selected-hover-icon0000");
			this.radioSelectedDownIconTexture = this.atlas.getTexture("radio-selected-down-icon0000");
			this.radioSelectedDisabledIconTexture = this.atlas.getTexture("radio-selected-disabled-icon0000");

			this.pageIndicatorNormalSkinTexture = this.atlas.getTexture("page-indicator-normal-symbol0000");
			this.pageIndicatorSelectedSkinTexture = this.atlas.getTexture("page-indicator-selected-symbol0000");

			this.pickerListUpIconTexture = this.atlas.getTexture("picker-list-up-icon0000");
			this.pickerListHoverIconTexture = this.atlas.getTexture("picker-list-hover-icon0000");
			this.pickerListDownIconTexture = this.atlas.getTexture("picker-list-down-icon0000");
			this.pickerListDisabledIconTexture = this.atlas.getTexture("picker-list-disabled-icon0000");

			this.textInputBackgroundEnabledSkinTexture = this.atlas.getTexture("text-input-background-enabled-skin0000");
			this.textInputBackgroundDisabledSkinTexture = this.atlas.getTexture("text-input-background-disabled-skin0000");
			this.textInputBackgroundErrorSkinTexture = this.atlas.getTexture("text-input-background-error-skin0000");
			this.textInputSearchIconTexture = this.atlas.getTexture("search-icon0000");
			this.textInputSearchIconDisabledTexture = this.atlas.getTexture("search-icon-disabled0000");

			this.vScrollBarThumbUpSkinTexture = this.atlas.getTexture("vertical-scroll-bar-thumb-up-skin0000");
			this.vScrollBarThumbHoverSkinTexture = this.atlas.getTexture("vertical-scroll-bar-thumb-hover-skin0000");
			this.vScrollBarThumbDownSkinTexture = this.atlas.getTexture("vertical-scroll-bar-thumb-down-skin0000");
			this.vScrollBarTrackSkinTexture = this.atlas.getTexture("vertical-scroll-bar-track-skin0000");
			this.vScrollBarThumbIconTexture = this.atlas.getTexture("vertical-scroll-bar-thumb-icon0000");
			this.vScrollBarStepButtonUpSkinTexture = this.atlas.getTexture("vertical-scroll-bar-step-button-up-skin0000");
			this.vScrollBarStepButtonHoverSkinTexture = this.atlas.getTexture("vertical-scroll-bar-step-button-hover-skin0000");
			this.vScrollBarStepButtonDownSkinTexture = this.atlas.getTexture("vertical-scroll-bar-step-button-down-skin0000");
			this.vScrollBarStepButtonDisabledSkinTexture = this.atlas.getTexture("vertical-scroll-bar-step-button-disabled-skin0000");
			this.vScrollBarDecrementButtonIconTexture = this.atlas.getTexture("vertical-scroll-bar-decrement-button-icon0000");
			this.vScrollBarIncrementButtonIconTexture = this.atlas.getTexture("vertical-scroll-bar-increment-button-icon0000");

			this.hScrollBarThumbUpSkinTexture = this.atlas.getTexture("horizontal-scroll-bar-thumb-up-skin0000");
			this.hScrollBarThumbHoverSkinTexture = this.atlas.getTexture("horizontal-scroll-bar-thumb-hover-skin0000");
			this.hScrollBarThumbDownSkinTexture = this.atlas.getTexture("horizontal-scroll-bar-thumb-down-skin0000");
			this.hScrollBarTrackSkinTexture = this.atlas.getTexture("horizontal-scroll-bar-track-skin0000");
			this.hScrollBarThumbIconTexture = this.atlas.getTexture("horizontal-scroll-bar-thumb-icon0000");
			this.hScrollBarStepButtonUpSkinTexture = this.atlas.getTexture("horizontal-scroll-bar-step-button-up-skin0000");
			this.hScrollBarStepButtonHoverSkinTexture = this.atlas.getTexture("horizontal-scroll-bar-step-button-hover-skin0000");
			this.hScrollBarStepButtonDownSkinTexture = this.atlas.getTexture("horizontal-scroll-bar-step-button-down-skin0000");
			this.hScrollBarStepButtonDisabledSkinTexture = this.atlas.getTexture("horizontal-scroll-bar-step-button-disabled-skin0000");
			this.hScrollBarDecrementButtonIconTexture = this.atlas.getTexture("horizontal-scroll-bar-decrement-button-icon0000");
			this.hScrollBarIncrementButtonIconTexture = this.atlas.getTexture("horizontal-scroll-bar-increment-button-icon0000");

			this.simpleBorderBackgroundSkinTexture = this.atlas.getTexture("simple-border-background-skin0000");
			this.insetBorderBackgroundSkinTexture = this.atlas.getTexture("inset-border-background-skin0000");
			this.panelBorderBackgroundSkinTexture = this.atlas.getTexture("panel-background-skin0000");
			this.alertBorderBackgroundSkinTexture = this.atlas.getTexture("alert-background-skin0000");

			this.progressBarFillSkinTexture = Texture.fromTexture(this.atlas.getTexture("progress-bar-fill-skin0000"), PROGRESS_BAR_FILL_TEXTURE_REGION);

			this.playPauseButtonPlayUpIconTexture = this.atlas.getTexture("play-pause-toggle-button-play-up-icon0000");
			this.playPauseButtonPauseUpIconTexture = this.atlas.getTexture("play-pause-toggle-button-pause-up-icon0000");
			this.overlayPlayPauseButtonPlayUpIconTexture = this.atlas.getTexture("overlay-play-pause-toggle-button-play-up-icon0000");
			this.fullScreenToggleButtonEnterUpIconTexture = this.atlas.getTexture("full-screen-toggle-button-enter-up-icon0000");
			this.fullScreenToggleButtonExitUpIconTexture = this.atlas.getTexture("full-screen-toggle-button-exit-up-icon0000");
			this.muteToggleButtonMutedUpIconTexture = this.atlas.getTexture("mute-toggle-button-muted-up-icon0000");
			this.muteToggleButtonLoudUpIconTexture = this.atlas.getTexture("mute-toggle-button-loud-up-icon0000");
			this.horizontalVolumeSliderMinimumTrackSkinTexture = this.atlas.getTexture("horizontal-volume-slider-minimum-track-skin0000");
			this.horizontalVolumeSliderMaximumTrackSkinTexture = this.atlas.getTexture("horizontal-volume-slider-maximum-track-skin0000");
			this.verticalVolumeSliderMinimumTrackSkinTexture = this.atlas.getTexture("vertical-volume-slider-minimum-track-skin0000");
			this.verticalVolumeSliderMaximumTrackSkinTexture = this.atlas.getTexture("vertical-volume-slider-maximum-track-skin0000");
			this.popUpVolumeSliderMinimumTrackSkinTexture = this.atlas.getTexture("pop-up-volume-slider-minimum-track-skin0000");
			this.popUpVolumeSliderMaximumTrackSkinTexture = this.atlas.getTexture("pop-up-volume-slider-maximum-track-skin0000");
			this.seekSliderMinimumTrackSkinTexture = this.atlas.getTexture("seek-slider-minimum-track-skin0000");
			this.seekSliderMaximumTrackSkinTexture = this.atlas.getTexture("seek-slider-maximum-track-skin0000");
			this.seekSliderProgressSkinTexture = this.atlas.getTexture("seek-slider-progress-skin0000");

			this.listDrillDownAccessoryTexture = this.atlas.getTexture("drill-down-icon0000");

			this.treeBranchOpenIconTexture = this.atlas.getTexture("tree-branch-open-icon0000");
			this.treeBranchClosedIconTexture = this.atlas.getTexture("tree-branch-closed-icon0000");
			this.treeLeafIconTexture = this.atlas.getTexture("tree-leaf-icon0000");
			this.treeDisclosureOpenIconTexture = this.atlas.getTexture("tree-disclosure-open-icon0000");
			this.treeDisclosureClosedIconTexture = this.atlas.getTexture("tree-disclosure-closed-icon0000");

			this.dataGridVerticalDividerSkinTexture = this.atlas.getTexture("data-grid-vertical-divider-skin0000");
			this.dataGridColumnDropIndicatorSkinTexture = this.atlas.getTexture("data-grid-column-drop-indicator-skin0000");
			this.dataGridColumnResizeSkinTexture = this.atlas.getTexture("data-grid-column-resize-skin0000");
			this.dataGridHeaderBackgroundSkinTexture = this.atlas.getTexture("data-grid-header-background-skin0000");
			this.dataGridHeaderDividerSkinTexture = this.atlas.getTexture("data-grid-header-divider-skin0000");
			this.dataGridHeaderSortAscendingIconTexture = this.atlas.getTexture("data-grid-header-sort-ascending-icon0000");
			this.dataGridHeaderSortDescendingIconTexture = this.atlas.getTexture("data-grid-header-sort-descending-icon0000");
		}

		/**
		 * Sets global style providers for all components.
		 */
		protected function initializeStyleProviders():void
		{
			//alert
			this.getStyleProviderForClass(Alert).defaultStyleFunction = this.setAlertStyles;
			this.getStyleProviderForClass(Header).setFunctionForStyleName(Alert.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setPanelHeaderStyles);
			this.getStyleProviderForClass(ButtonGroup).setFunctionForStyleName(Alert.DEFAULT_CHILD_STYLE_NAME_BUTTON_GROUP, this.setAlertButtonGroupStyles);

			//autocomplete
			this.getStyleProviderForClass(AutoComplete).defaultStyleFunction = this.setTextInputStyles;
			this.getStyleProviderForClass(List).setFunctionForStyleName(AutoComplete.DEFAULT_CHILD_STYLE_NAME_LIST, this.setDropDownListStyles);

			//button
			this.getStyleProviderForClass(Button).defaultStyleFunction = this.setButtonStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_QUIET_BUTTON, this.setQuietButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_CALL_TO_ACTION_BUTTON, this.setCallToActionButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_DANGER_BUTTON, this.setDangerButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON, this.setBackButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_FORWARD_BUTTON, this.setForwardButtonStyles);

			//button group
			this.getStyleProviderForClass(ButtonGroup).defaultStyleFunction = this.setButtonGroupStyles;

			//callout
			this.getStyleProviderForClass(Callout).defaultStyleFunction = this.setCalloutStyles;

			//check
			this.getStyleProviderForClass(Check).defaultStyleFunction = this.setCheckStyles;

			//data grid
			this.getStyleProviderForClass(DataGrid).defaultStyleFunction = this.setDataGridStyles;
			this.getStyleProviderForClass(DefaultDataGridHeaderRenderer).defaultStyleFunction = this.setDataGridHeaderRendererStyles;
			this.getStyleProviderForClass(DefaultDataGridCellRenderer).defaultStyleFunction = this.setDataGridCellRendererStyles;

			//date time spinner
			this.getStyleProviderForClass(DateTimeSpinner).defaultStyleFunction = this.setDateTimeSpinnerStyles;
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER, this.setDateTimeSpinnerListItemRendererStyles);

			//drawers
			this.getStyleProviderForClass(Drawers).defaultStyleFunction = this.setDrawersStyles;

			//grouped list (see also: item renderers)
			this.getStyleProviderForClass(GroupedList).defaultStyleFunction = this.setGroupedListStyles;
			this.getStyleProviderForClass(GroupedList).setFunctionForStyleName(GroupedList.ALTERNATE_STYLE_NAME_INSET_GROUPED_LIST, this.setInsetGroupedListStyles);

			//header
			this.getStyleProviderForClass(Header).defaultStyleFunction = this.setHeaderStyles;

			//item renderers for lists
			this.getStyleProviderForClass(DefaultListItemRenderer).defaultStyleFunction = this.setItemRendererStyles;
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(DefaultListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN, this.setDrillDownItemRendererStyles);
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(DefaultListItemRenderer.ALTERNATE_STYLE_NAME_CHECK, this.setCheckItemRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).defaultStyleFunction = this.setItemRendererStyles;
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(DefaultGroupedListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN, this.setDrillDownItemRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(DefaultGroupedListItemRenderer.ALTERNATE_STYLE_NAME_CHECK, this.setCheckItemRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_ITEM_RENDERER, this.setInsetGroupedListItemRendererStyles);
			this.getStyleProviderForClass(DefaultTreeItemRenderer).defaultStyleFunction = this.setTreeItemRendererStyles;

			//header and footer renderers for grouped list
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).defaultStyleFunction = this.setGroupedListHeaderOrFooterRendererStyles;
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).setFunctionForStyleName(GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_HEADER_RENDERER, this.setInsetGroupedListHeaderRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).setFunctionForStyleName(GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_FOOTER_RENDERER, this.setInsetGroupedListFooterRendererStyles);

			//label
			this.getStyleProviderForClass(Label).defaultStyleFunction = this.setLabelStyles;
			this.getStyleProviderForClass(Label).setFunctionForStyleName(Label.ALTERNATE_STYLE_NAME_HEADING, this.setHeadingLabelStyles);
			this.getStyleProviderForClass(Label).setFunctionForStyleName(Label.ALTERNATE_STYLE_NAME_DETAIL, this.setDetailLabelStyles);
			this.getStyleProviderForClass(Label).setFunctionForStyleName(Label.ALTERNATE_STYLE_NAME_TOOL_TIP, this.setToolTipLabelStyles);

			//layout group
			this.getStyleProviderForClass(LayoutGroup).setFunctionForStyleName(LayoutGroup.ALTERNATE_STYLE_NAME_TOOLBAR, this.setToolbarLayoutGroupStyles);

			//list (see also: item renderers)
			this.getStyleProviderForClass(List).defaultStyleFunction = this.setListStyles;

			//numeric stepper
			this.getStyleProviderForClass(NumericStepper).defaultStyleFunction = this.setNumericStepperStyles;
			this.getStyleProviderForClass(TextInput).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_TEXT_INPUT, this.setNumericStepperTextInputStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON, this.setNumericStepperIncrementButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON, this.setNumericStepperDecrementButtonStyles);

			//panel
			this.getStyleProviderForClass(Panel).defaultStyleFunction = this.setPanelStyles;
			this.getStyleProviderForClass(Header).setFunctionForStyleName(Panel.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setPanelHeaderStyles);

			//panel screen
			this.getStyleProviderForClass(PanelScreen).defaultStyleFunction = this.setPanelScreenStyles;

			//page indicator
			this.getStyleProviderForClass(PageIndicator).defaultStyleFunction = this.setPageIndicatorStyles;

			//picker list (see also: item renderers)
			this.getStyleProviderForClass(PickerList).defaultStyleFunction = this.setPickerListStyles;
			this.getStyleProviderForClass(List).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_LIST, this.setDropDownListStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setPickerListButtonStyles);
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setPickerListButtonStyles);

			//progress bar
			this.getStyleProviderForClass(ProgressBar).defaultStyleFunction = this.setProgressBarStyles;

			//radio
			this.getStyleProviderForClass(Radio).defaultStyleFunction = this.setRadioStyles;

			//scroll bar
			this.getStyleProviderForClass(ScrollBar).setFunctionForStyleName(Scroller.DEFAULT_CHILD_STYLE_NAME_HORIZONTAL_SCROLL_BAR, this.setHorizontalScrollBarStyles);
			this.getStyleProviderForClass(ScrollBar).setFunctionForStyleName(Scroller.DEFAULT_CHILD_STYLE_NAME_VERTICAL_SCROLL_BAR, this.setVerticalScrollBarStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_INCREMENT_BUTTON, this.setHorizontalScrollBarIncrementButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_DECREMENT_BUTTON, this.setHorizontalScrollBarDecrementButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_THUMB, this.setHorizontalScrollBarThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_MINIMUM_TRACK, this.setHorizontalScrollBarMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_INCREMENT_BUTTON, this.setVerticalScrollBarIncrementButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_DECREMENT_BUTTON, this.setVerticalScrollBarDecrementButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_THUMB, this.setVerticalScrollBarThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_MINIMUM_TRACK, this.setVerticalScrollBarMinimumTrackStyles);

			//scroll container
			this.getStyleProviderForClass(ScrollContainer).defaultStyleFunction = this.setScrollContainerStyles;
			this.getStyleProviderForClass(ScrollContainer).setFunctionForStyleName(ScrollContainer.ALTERNATE_STYLE_NAME_TOOLBAR, this.setToolbarScrollContainerStyles);

			//scroll screen
			this.getStyleProviderForClass(ScrollScreen).defaultStyleFunction = this.setScrollScreenStyles;

			//scroll text
			this.getStyleProviderForClass(ScrollText).defaultStyleFunction = this.setScrollTextStyles;

			//simple scroll bar
			this.getStyleProviderForClass(SimpleScrollBar).setFunctionForStyleName(Scroller.DEFAULT_CHILD_STYLE_NAME_HORIZONTAL_SCROLL_BAR, this.setHorizontalSimpleScrollBarStyles);
			this.getStyleProviderForClass(SimpleScrollBar).setFunctionForStyleName(Scroller.DEFAULT_CHILD_STYLE_NAME_VERTICAL_SCROLL_BAR, this.setVerticalSimpleScrollBarStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SIMPLE_SCROLL_BAR_THUMB, this.setHorizontalSimpleScrollBarThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SIMPLE_SCROLL_BAR_THUMB, this.setVerticalSimpleScrollBarThumbStyles);

			//slider
			this.getStyleProviderForClass(Slider).defaultStyleFunction = this.setSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SLIDER_THUMB, this.setHorizontalSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK, this.setHorizontalSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SLIDER_THUMB, this.setVerticalSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK, this.setVerticalSliderMinimumTrackStyles);
			
			//spinner list
			this.getStyleProviderForClass(SpinnerList).defaultStyleFunction = this.setSpinnerListStyles;

			//tab bar
			this.getStyleProviderForClass(TabBar).defaultStyleFunction = this.setTabBarStyles;
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(TabBar.DEFAULT_CHILD_STYLE_NAME_TAB, this.setTabStyles);

			//text area
			this.getStyleProviderForClass(TextArea).defaultStyleFunction = this.setTextAreaStyles;
			this.getStyleProviderForClass(TextCallout).setFunctionForStyleName(TextArea.DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT, this.setTextAreaErrorCalloutStyles);

			//text callout
			this.getStyleProviderForClass(TextCallout).defaultStyleFunction = this.setTextCalloutStyles;

			//text input
			this.getStyleProviderForClass(TextInput).defaultStyleFunction = this.setTextInputStyles;
			this.getStyleProviderForClass(TextInput).setFunctionForStyleName(TextInput.ALTERNATE_STYLE_NAME_SEARCH_TEXT_INPUT, this.setSearchTextInputStyles);
			this.getStyleProviderForClass(TextCallout).setFunctionForStyleName(TextInput.DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT, this.setTextInputErrorCalloutStyles);

			//toast
			this.getStyleProviderForClass(Toast).defaultStyleFunction = this.setToastStyles;
			this.getStyleProviderForClass(ButtonGroup).setFunctionForStyleName(Toast.DEFAULT_CHILD_STYLE_NAME_ACTIONS, this.setToastActionsStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON, this.setToastActionsButtonStyles);
			
			//toggle button
			this.getStyleProviderForClass(ToggleButton).defaultStyleFunction = this.setButtonStyles;
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_QUIET_BUTTON, this.setQuietButtonStyles);

			//toggle switch
			this.getStyleProviderForClass(ToggleSwitch).defaultStyleFunction = this.setToggleSwitchStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_ON_TRACK, this.setToggleSwitchOnTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setToggleSwitchThumbStyles);
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setToggleSwitchThumbStyles);

			//tree
			this.getStyleProviderForClass(Tree).defaultStyleFunction = this.setTreeStyles;

			//media controls
			
			//play/pause toggle button
			this.getStyleProviderForClass(PlayPauseToggleButton).defaultStyleFunction = this.setPlayPauseToggleButtonStyles;
			this.getStyleProviderForClass(PlayPauseToggleButton).setFunctionForStyleName(PlayPauseToggleButton.ALTERNATE_STYLE_NAME_OVERLAY_PLAY_PAUSE_TOGGLE_BUTTON, this.setOverlayPlayPauseToggleButtonStyles);

			//full screen toggle button
			this.getStyleProviderForClass(FullScreenToggleButton).defaultStyleFunction = this.setFullScreenToggleButtonStyles;

			//mute toggle button
			this.getStyleProviderForClass(MuteToggleButton).defaultStyleFunction = this.setMuteToggleButtonStyles;
			this.getStyleProviderForClass(VolumeSlider).setFunctionForStyleName(MuteToggleButton.DEFAULT_CHILD_STYLE_NAME_VOLUME_SLIDER, this.setPopUpVolumeSliderStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_MINIMUM_TRACK, this.setPopUpVolumeSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_MAXIMUM_TRACK, this.setPopUpVolumeSliderMaximumTrackStyles);

			//seek slider
			this.getStyleProviderForClass(SeekSlider).defaultStyleFunction = this.setSeekSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SeekSlider.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setHorizontalSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SeekSlider.DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK, this.setSeekSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SeekSlider.DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK, this.setSeekSliderMaximumTrackStyles);

			//volume slider
			this.getStyleProviderForClass(VolumeSlider).defaultStyleFunction = this.setVolumeSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(VolumeSlider.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setVolumeSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_VOLUME_SLIDER_MINIMUM_TRACK, this.setHorizontalVolumeSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_VOLUME_SLIDER_MAXIMUM_TRACK, this.setHorizontalVolumeSliderMaximumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_VOLUME_SLIDER_MINIMUM_TRACK, this.setVerticalVolumeSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_VOLUME_SLIDER_MAXIMUM_TRACK, this.setVerticalVolumeSliderMaximumTrackStyles);
		}

		protected function pageIndicatorNormalSymbolFactory():Image
		{
			return new Image(this.pageIndicatorNormalSkinTexture);
		}

		protected function pageIndicatorSelectedSymbolFactory():Image
		{
			return new Image(this.pageIndicatorSelectedSkinTexture);
		}

		protected function dataGridHeaderDividerFactory():DisplayObject
		{
			var skin:ImageSkin = new ImageSkin(this.dataGridHeaderDividerSkinTexture);
			skin.scale9Grid = DATA_GRID_HEADER_DIVIDER_SCALE_9_GRID;
			return skin;
		}

		protected function dataGridVerticalDividerFactory():DisplayObject
		{
			var skin:ImageSkin = new ImageSkin(this.dataGridVerticalDividerSkinTexture);
			skin.scale9Grid = DATA_GRID_VERTICAL_DIVIDER_SCALE_9_GRID;
			return skin;
		}

		protected function toastContainerFactory():DisplayObjectContainer
		{
			var container:LayoutGroup = new LayoutGroup();
			container.autoSizeMode = AutoSizeMode.STAGE;

			var layout:VerticalLayout = new VerticalLayout();
			layout.verticalAlign = VerticalAlign.BOTTOM;
			layout.horizontalAlign = HorizontalAlign.LEFT;
			layout.padding = this.gutterSize;
			layout.gap = this.gutterSize;
			container.layout = layout;

			return container;
		}

	//-------------------------
	// Shared
	//-------------------------

		protected function setScrollerStyles(scroller:Scroller):void
		{
			scroller.clipContent = true;
			scroller.horizontalScrollBarFactory = scrollBarFactory;
			scroller.verticalScrollBarFactory = scrollBarFactory;
			scroller.interactionMode = ScrollInteractionMode.MOUSE;
			scroller.scrollBarDisplayMode = ScrollBarDisplayMode.FIXED;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			scroller.focusIndicatorSkin = focusIndicatorSkin;
			scroller.focusPadding = 0;
		}

		protected function setDropDownListStyles(list:List):void
		{
			this.setListStyles(list);

			var layout:VerticalLayout = new VerticalLayout();
			layout.useVirtualLayout = true;
			layout.padding = 0;
			layout.gap = 0;
			layout.horizontalAlign = HorizontalAlign.JUSTIFY;
			layout.verticalAlign = VerticalAlign.TOP;
			layout.resetTypicalItemDimensionsOnMeasure = true;
			layout.maxRowCount = 5;
			list.layout = layout;
		}

	//-------------------------
	// Alert
	//-------------------------

		protected function setAlertStyles(alert:Alert):void
		{
			this.setScrollerStyles(alert);

			var backgroundSkin:Image = new Image(this.alertBorderBackgroundSkinTexture);
			backgroundSkin.scale9Grid = PANEL_BORDER_SCALE_9_GRID;
			alert.backgroundSkin = backgroundSkin;

			alert.fontStyles = this.defaultFontStyles.clone();
			alert.disabledFontStyles = this.disabledFontStyles.clone();

			alert.outerPadding = this.borderSize;

			alert.paddingTop = this.smallGutterSize;
			alert.paddingBottom = this.smallGutterSize;
			alert.paddingRight = this.gutterSize;
			alert.paddingLeft = this.gutterSize;
			alert.gap = this.gutterSize;

			alert.maxWidth = this.popUpSize;
			alert.maxHeight = this.popUpSize;
		}

		protected function setAlertButtonGroupStyles(group:ButtonGroup):void
		{
			group.direction = Direction.HORIZONTAL;
			group.horizontalAlign = HorizontalAlign.CENTER;
			group.verticalAlign = VerticalAlign.JUSTIFY;
			group.distributeButtonSizes = false;
			group.gap = this.smallGutterSize;
			group.padding = this.smallGutterSize;
		}

	//-------------------------
	// Button
	//-------------------------

		protected function setBaseButtonStyles(button:Button):void
		{
			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = -1;

			button.paddingTop = this.extraSmallGutterSize;
			button.paddingBottom = this.extraSmallGutterSize;
			button.paddingLeft = this.smallGutterSize;
			button.paddingRight = this.smallGutterSize;
			button.gap = this.smallGutterSize;
			button.minGap = this.smallGutterSize;
		}

		protected function setButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.HOVER, this.buttonHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				skin.selectedTexture = this.toggleButtonSelectedUpSkinTexture;
				skin.setTextureForState(ButtonState.HOVER_AND_SELECTED, this.toggleButtonSelectedHoverSkinTexture);
				skin.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.toggleButtonSelectedDownSkinTexture);
				skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.toggleButtonSelectedDisabledSkinTexture);
			}
			skin.scale9Grid = BUTTON_SCALE_9_GRID;
			skin.width = this.buttonMinWidth;
			skin.height = this.controlSize;
			skin.minWidth = this.buttonMinWidth;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.defaultFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setQuietButtonStyles(button:Button):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			button.defaultSkin = defaultSkin;

			var otherSkin:ImageSkin = new ImageSkin(null);
			otherSkin.setTextureForState(ButtonState.HOVER, this.quietButtonHoverSkinTexture);
			otherSkin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			button.setSkinForState(ButtonState.HOVER, otherSkin);
			button.setSkinForState(ButtonState.DOWN, otherSkin);
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				otherSkin.selectedTexture = this.toggleButtonSelectedUpSkinTexture;
				otherSkin.setTextureForState(ButtonState.HOVER_AND_SELECTED, this.toggleButtonSelectedHoverSkinTexture);
				otherSkin.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.toggleButtonSelectedDownSkinTexture);
				otherSkin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.toggleButtonSelectedDisabledSkinTexture);
				ToggleButton(button).defaultSelectedSkin = otherSkin;
			}
			otherSkin.scale9Grid = BUTTON_SCALE_9_GRID;
			otherSkin.width = this.controlSize;
			otherSkin.height = this.controlSize;
			otherSkin.minWidth = this.controlSize;
			otherSkin.minHeight = this.controlSize;

			button.fontStyles = this.defaultFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setCallToActionButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.callToActionButtonUpSkinTexture);
			skin.setTextureForState(ButtonState.HOVER, this.callToActionButtonHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.scale9Grid = BUTTON_SCALE_9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.defaultFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setDangerButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.dangerButtonUpSkinTexture);
			skin.setTextureForState(ButtonState.HOVER, this.dangerButtonHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.dangerButtonDownSkinTexture);
			skin.scale9Grid = BUTTON_SCALE_9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.defaultFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setBackButtonStyles(button:Button):void
		{
			this.setButtonStyles(button);

			var icon:ImageSkin = new ImageSkin(this.backButtonUpIconTexture);
			icon.disabledTexture = this.backButtonDisabledIconTexture;
			button.defaultIcon = icon;

			button.iconPosition = RelativePosition.LEFT_BASELINE;
		}

		protected function setForwardButtonStyles(button:Button):void
		{
			this.setButtonStyles(button);

			var icon:ImageSkin = new ImageSkin(this.forwardButtonUpIconTexture);
			icon.disabledTexture = this.forwardButtonDisabledIconTexture;
			button.defaultIcon = icon;

			button.iconPosition = RelativePosition.RIGHT_BASELINE;
		}

	//-------------------------
	// ButtonGroup
	//-------------------------

		protected function setButtonGroupStyles(group:ButtonGroup):void
		{
			group.gap = this.smallGutterSize;
		}

	//-------------------------
	// Callout
	//-------------------------

		protected function setCalloutStyles(callout:Callout):void
		{
			var backgroundSkin:Image = new Image(this.calloutBackgroundSkinTexture);
			backgroundSkin.scale9Grid = CALLOUT_SCALE_9_GRID;
			callout.backgroundSkin = backgroundSkin;

			var topArrowSkin:Image = new Image(this.calloutTopArrowSkinTexture);
			callout.topArrowSkin = topArrowSkin;
			callout.topArrowGap = this.calloutArrowOverlapGap;
			var rightArrowSkin:Image = new Image(this.calloutRightArrowSkinTexture);
			callout.rightArrowSkin = rightArrowSkin;
			callout.rightArrowGap = this.calloutArrowOverlapGap - this.leftAndRightDropShadowSize;
			var bottomArrowSkin:Image = new Image(this.calloutBottomArrowSkinTexture);
			callout.bottomArrowSkin = bottomArrowSkin;
			callout.bottomArrowGap = this.calloutArrowOverlapGap - this.bottomDropShadowSize;
			var leftArrowSkin:Image = new Image(this.calloutLeftArrowSkinTexture);
			callout.leftArrowSkin = leftArrowSkin;
			callout.leftArrowGap = this.calloutArrowOverlapGap - this.leftAndRightDropShadowSize;

			callout.paddingTop = this.smallGutterSize;
			callout.paddingBottom = this.smallGutterSize + this.bottomDropShadowSize;
			callout.paddingRight = this.gutterSize + this.leftAndRightDropShadowSize;
			callout.paddingLeft = this.gutterSize + this.leftAndRightDropShadowSize;
		}

		protected function setDangerCalloutStyles(callout:Callout):void
		{
			var backgroundSkin:Image = new Image(this.dangerCalloutBackgroundSkinTexture);
			backgroundSkin.scale9Grid = CALLOUT_SCALE_9_GRID;
			callout.backgroundSkin = backgroundSkin;

			var topArrowSkin:Image = new Image(this.dangerCalloutTopArrowSkinTexture);
			callout.topArrowSkin = topArrowSkin;
			callout.topArrowGap = this.calloutArrowOverlapGap;
			var rightArrowSkin:Image = new Image(this.dangerCalloutRightArrowSkinTexture);
			callout.rightArrowSkin = rightArrowSkin;
			callout.rightArrowGap = this.calloutArrowOverlapGap - this.leftAndRightDropShadowSize;
			var bottomArrowSkin:Image = new Image(this.dangerCalloutBottomArrowSkinTexture);
			callout.bottomArrowSkin = bottomArrowSkin;
			callout.bottomArrowGap = this.calloutArrowOverlapGap - this.bottomDropShadowSize;
			var leftArrowSkin:Image = new Image(this.dangerCalloutLeftArrowSkinTexture);
			callout.leftArrowSkin = leftArrowSkin;
			callout.leftArrowGap = this.calloutArrowOverlapGap - this.leftAndRightDropShadowSize;

			callout.paddingTop = this.smallGutterSize;
			callout.paddingBottom = this.smallGutterSize + this.bottomDropShadowSize;
			callout.paddingRight = this.gutterSize + this.leftAndRightDropShadowSize;
			callout.paddingLeft = this.gutterSize + this.leftAndRightDropShadowSize;
		}

	//-------------------------
	// Check
	//-------------------------

		protected function setCheckStyles(check:Check):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			check.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.checkUpIconTexture);
			icon.selectedTexture = this.checkSelectedUpIconTexture;
			icon.setTextureForState(ButtonState.HOVER, this.checkHoverIconTexture);
			icon.setTextureForState(ButtonState.DOWN, this.checkDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED, this.checkDisabledIconTexture);
			icon.setTextureForState(ButtonState.HOVER_AND_SELECTED, this.checkSelectedHoverIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.checkSelectedDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.checkSelectedDisabledIconTexture);
			check.defaultIcon = icon;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			check.focusIndicatorSkin = focusIndicatorSkin;
			check.focusPadding = -2;

			check.fontStyles = this.defaultFontStyles.clone();
			check.disabledFontStyles = this.disabledFontStyles.clone();

			check.horizontalAlign = HorizontalAlign.LEFT;
			check.verticalAlign = VerticalAlign.MIDDLE;

			check.gap = this.smallGutterSize;
		}

	//-------------------------
	// List
	//-------------------------

		protected function setDataGridStyles(grid:DataGrid):void
		{
			this.setScrollerStyles(grid);

			grid.verticalScrollPolicy = ScrollPolicy.AUTO;

			var backgroundSkin:ImageSkin = new ImageSkin(this.simpleBorderBackgroundSkinTexture);
			backgroundSkin.scale9Grid = SIMPLE_BORDER_SCALE_9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			grid.backgroundSkin = backgroundSkin;

			var headerBackgroundSkin:ImageSkin = new ImageSkin(this.dataGridHeaderBackgroundSkinTexture);
			headerBackgroundSkin.width = this.controlSize;
			headerBackgroundSkin.height = this.controlSize;
			grid.headerBackgroundSkin = headerBackgroundSkin;

			var columnResizeSkin:ImageSkin = new ImageSkin(this.dataGridColumnResizeSkinTexture);
			columnResizeSkin.scale9Grid = DATA_GRID_VERTICAL_DIVIDER_SCALE_9_GRID;
			grid.columnResizeSkin = columnResizeSkin;

			var columnDropIndicatorSkin:ImageSkin = new ImageSkin(this.dataGridColumnDropIndicatorSkinTexture);
			columnDropIndicatorSkin.scale9Grid = DATA_GRID_COLUMN_DROP_INDICATOR_SCALE_9_GRID;
			grid.columnDropIndicatorSkin = columnDropIndicatorSkin;
			grid.extendedColumnDropIndicator = true;

			var columnDragOverlaySkin:Quad = new Quad(1, 1, MODAL_OVERLAY_COLOR);
			columnDragOverlaySkin.alpha = MODAL_OVERLAY_ALPHA;
			grid.columnDragOverlaySkin = columnDragOverlaySkin;

			grid.verticalDividerFactory = this.dataGridVerticalDividerFactory;
			grid.headerDividerFactory = this.dataGridHeaderDividerFactory;

			grid.padding = this.borderSize;
		}

		protected function setDataGridHeaderRendererStyles(headerRenderer:DefaultDataGridHeaderRenderer):void
		{
			headerRenderer.sortAscendingIcon = new ImageSkin(this.dataGridHeaderSortAscendingIconTexture);
			headerRenderer.sortDescendingIcon = new ImageSkin(this.dataGridHeaderSortDescendingIconTexture);

			headerRenderer.fontStyles = this.defaultFontStyles.clone();
			headerRenderer.disabledFontStyles = this.disabledFontStyles.clone();

			headerRenderer.paddingTop = this.extraSmallGutterSize;
			headerRenderer.paddingBottom = this.extraSmallGutterSize;
			headerRenderer.paddingLeft = this.smallGutterSize;
			headerRenderer.paddingRight = this.smallGutterSize;
		}

		protected function setDataGridCellRendererStyles(cellRenderer:DefaultDataGridCellRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			skin.selectedTexture = this.itemRendererSelectedUpSkinTexture;
			skin.setTextureForState(ButtonState.HOVER, this.itemRendererHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.itemRendererSelectedUpSkinTexture);
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			cellRenderer.defaultSkin = skin;

			cellRenderer.fontStyles = this.defaultFontStyles.clone();
			cellRenderer.disabledFontStyles = this.disabledFontStyles.clone();
			cellRenderer.iconLabelFontStyles = this.defaultFontStyles.clone();
			cellRenderer.iconLabelDisabledFontStyles = this.disabledFontStyles.clone();
			cellRenderer.accessoryLabelFontStyles = this.defaultFontStyles.clone();
			cellRenderer.accessoryLabelDisabledFontStyles = this.disabledFontStyles.clone();

			cellRenderer.horizontalAlign = HorizontalAlign.LEFT;

			cellRenderer.iconPosition = RelativePosition.LEFT;
			cellRenderer.accessoryPosition = RelativePosition.RIGHT;

			cellRenderer.paddingTop = this.extraSmallGutterSize;
			cellRenderer.paddingBottom = this.extraSmallGutterSize;
			cellRenderer.paddingRight = this.smallGutterSize;
			cellRenderer.paddingLeft = this.smallGutterSize;
			cellRenderer.gap = this.extraSmallGutterSize;
			cellRenderer.minGap = this.extraSmallGutterSize;
			cellRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			cellRenderer.minAccessoryGap = this.smallGutterSize;

			cellRenderer.useStateDelayTimer = false;
		}

	//-------------------------
	// DateTimeSpinner
	//-------------------------

		protected function setDateTimeSpinnerStyles(spinner:DateTimeSpinner):void
		{
			spinner.customItemRendererStyleName = THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER;
		}

		protected function setDateTimeSpinnerListItemRendererStyles(itemRenderer:DefaultListItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);
			itemRenderer.accessoryPosition = RelativePosition.LEFT;
			itemRenderer.accessoryGap = this.smallGutterSize;
		}

	//-------------------------
	// Drawers
	//-------------------------

		protected function setDrawersStyles(drawers:Drawers):void
		{
			var overlaySkin:Quad = new Quad(10, 10, MODAL_OVERLAY_COLOR);
			overlaySkin.alpha = MODAL_OVERLAY_ALPHA;
			drawers.overlaySkin = overlaySkin;
		}

	//-------------------------
	// GroupedList
	//-------------------------

		protected function setGroupedListStyles(list:GroupedList):void
		{
			this.setScrollerStyles(list);

			list.verticalScrollPolicy = ScrollPolicy.AUTO;

			var backgroundSkin:ImageSkin = new ImageSkin(this.simpleBorderBackgroundSkinTexture);
			backgroundSkin.scale9Grid = SIMPLE_BORDER_SCALE_9_GRID;
			list.backgroundSkin = backgroundSkin;

			list.padding = this.borderSize;
		}

		//see List section for item renderer styles

		protected function setGroupedListHeaderOrFooterRendererStyles(renderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			var backgroundSkin:ImageSkin = new ImageSkin(this.groupedListHeaderBackgroundSkinTexture);
			backgroundSkin.scale9Grid = HEADER_SCALE_9_GRID;
			backgroundSkin.height = this.controlSize;
			backgroundSkin.minWidth = this.controlSize;
			backgroundSkin.minHeight = this.controlSize;
			renderer.backgroundSkin = backgroundSkin;

			renderer.fontStyles = this.defaultFontStyles.clone();
			renderer.disabledFontStyles = this.disabledFontStyles.clone();

			renderer.paddingTop = this.extraSmallGutterSize;
			renderer.paddingBottom = this.extraSmallGutterSize;
			renderer.paddingRight = this.smallGutterSize;
			renderer.paddingLeft = this.smallGutterSize;
		}

		protected function setInsetGroupedListStyles(list:GroupedList):void
		{
			this.setScrollerStyles(list);

			list.verticalScrollPolicy = ScrollPolicy.AUTO;

			var backgroundSkin:Image = new Image(this.insetBorderBackgroundSkinTexture);
			backgroundSkin.scale9Grid = SIMPLE_BORDER_SCALE_9_GRID;
			list.backgroundSkin = backgroundSkin;

			list.padding = this.borderSize;

			list.customItemRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_ITEM_RENDERER;
			list.customHeaderRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_HEADER_RENDERER;
			list.customFooterRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_FOOTER_RENDERER;

			var layout:VerticalLayout = new VerticalLayout();
			layout.useVirtualLayout = true;
			layout.paddingTop = this.gutterSize;
			layout.paddingBottom = this.gutterSize;
			layout.gap = 0;
			layout.horizontalAlign = HorizontalAlign.JUSTIFY;
			layout.verticalAlign = VerticalAlign.TOP;
			list.layout = layout;
		}

		protected function setInsetGroupedListItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			skin.selectedTexture = this.itemRendererSelectedUpSkinTexture;
			skin.setTextureForState(ButtonState.HOVER, this.itemRendererHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.itemRendererSelectedUpSkinTexture);
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			itemRenderer.defaultSkin = skin;

			itemRenderer.fontStyles = this.defaultFontStyles.clone();
			itemRenderer.disabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.iconLabelFontStyles = this.defaultFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.accessoryLabelFontStyles = this.defaultFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.disabledFontStyles.clone();

			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;

			itemRenderer.iconPosition = RelativePosition.LEFT;
			itemRenderer.accessoryPosition = RelativePosition.RIGHT;

			itemRenderer.paddingTop = this.extraSmallGutterSize;
			itemRenderer.paddingBottom = this.extraSmallGutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.paddingLeft = this.gutterSize;
			itemRenderer.gap = this.extraSmallGutterSize;
			itemRenderer.minGap = this.extraSmallGutterSize;
			itemRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			itemRenderer.minAccessoryGap = this.smallGutterSize;

			itemRenderer.useStateDelayTimer = false;
		}

		protected function setInsetGroupedListHeaderRendererStyles(headerRenderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			headerRenderer.backgroundSkin = skin;

			headerRenderer.fontStyles = this.defaultFontStyles.clone();
			headerRenderer.disabledFontStyles = this.disabledFontStyles.clone();

			headerRenderer.paddingTop = this.gutterSize;
			headerRenderer.paddingBottom = this.smallGutterSize;
			headerRenderer.paddingRight = this.gutterSize;
			headerRenderer.paddingLeft = this.gutterSize;
		}

		protected function setInsetGroupedListFooterRendererStyles(footerRenderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			footerRenderer.backgroundSkin = skin;

			footerRenderer.fontStyles = this.defaultFontStyles.clone();
			footerRenderer.disabledFontStyles = this.disabledFontStyles.clone();

			footerRenderer.paddingTop = this.smallGutterSize;
			footerRenderer.paddingBottom = this.smallGutterSize;
			footerRenderer.paddingRight = this.gutterSize;
			footerRenderer.paddingLeft = this.gutterSize;
		}

	//-------------------------
	// Header
	//-------------------------

		protected function setHeaderStyles(header:Header):void
		{
			var backgroundSkin:ImageSkin = new ImageSkin(this.headerBackgroundSkinTexture);
			backgroundSkin.scale9Grid = HEADER_SCALE_9_GRID;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			header.backgroundSkin = backgroundSkin;

			header.fontStyles = this.defaultFontStyles.clone();
			header.disabledFontStyles = this.disabledFontStyles.clone();

			header.paddingTop = this.extraSmallGutterSize;
			header.paddingBottom = this.extraSmallGutterSize + this.borderSize;
			header.paddingLeft = this.smallGutterSize;
			header.paddingRight = this.smallGutterSize;

			header.gap = this.extraSmallGutterSize;
			header.titleGap = this.gutterSize;
		}

	//-------------------------
	// Label
	//-------------------------

		protected function setLabelStyles(label:Label):void
		{
			label.fontStyles = this.defaultFontStyles.clone();
			label.disabledFontStyles = this.disabledFontStyles.clone();
		}

		protected function setHeadingLabelStyles(label:Label):void
		{
			label.fontStyles = this.headingFontStyles.clone();
			label.disabledFontStyles = this.headingDisabledFontStyles.clone();
		}

		protected function setDetailLabelStyles(label:Label):void
		{
			label.fontStyles = this.detailFontStyles.clone();
			label.disabledFontStyles = this.detailDisabledFontStyles.clone();
		}

		protected function setToolTipLabelStyles(label:Label):void
		{
			var backgroundSkin:Image = new Image(this.toolTipBackgroundSkinTexture);
			backgroundSkin.scale9Grid = TOOL_TIP_SCALE_9_GRID;
			label.backgroundSkin = backgroundSkin;

			label.fontStyles = this.defaultFontStyles.clone();
			label.disabledFontStyles = this.disabledFontStyles.clone();

			label.paddingTop = this.extraSmallGutterSize;
			label.paddingRight = this.smallGutterSize + this.leftAndRightDropShadowSize;
			label.paddingBottom = this.extraSmallGutterSize + this.bottomDropShadowSize;
			label.paddingLeft = this.smallGutterSize + this.leftAndRightDropShadowSize;
		}

	//-------------------------
	// LayoutGroup
	//-------------------------

		protected function setToolbarLayoutGroupStyles(group:LayoutGroup):void
		{
			if(!group.layout)
			{
				var layout:HorizontalLayout = new HorizontalLayout();
				layout.paddingTop = this.extraSmallGutterSize;
				layout.paddingBottom = this.extraSmallGutterSize;
				layout.paddingRight = this.smallGutterSize;
				layout.paddingLeft = this.smallGutterSize;
				layout.gap = this.smallGutterSize;
				layout.verticalAlign = VerticalAlign.MIDDLE;
				group.layout = layout;
			}

			group.minHeight = this.gridSize;

			var backgroundSkin:Image = new Image(this.headerBackgroundSkinTexture);
			backgroundSkin.scale9Grid = HEADER_SCALE_9_GRID;
			group.backgroundSkin = backgroundSkin;
		}

	//-------------------------
	// List
	//-------------------------

		protected function setListStyles(list:List):void
		{
			this.setScrollerStyles(list);

			list.verticalScrollPolicy = ScrollPolicy.AUTO;

			var backgroundSkin:ImageSkin = new ImageSkin(this.simpleBorderBackgroundSkinTexture);
			backgroundSkin.scale9Grid = SIMPLE_BORDER_SCALE_9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			list.backgroundSkin = backgroundSkin;

			var dropIndicatorSkin:Quad = new Quad(this.borderSize, this.borderSize, PRIMARY_TEXT_COLOR);
			list.dropIndicatorSkin = dropIndicatorSkin;

			list.padding = this.borderSize;
		}

		protected function setItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			skin.selectedTexture = this.itemRendererSelectedUpSkinTexture;
			skin.setTextureForState(ButtonState.HOVER, this.itemRendererHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.itemRendererSelectedUpSkinTexture);
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			itemRenderer.defaultSkin = skin;

			itemRenderer.fontStyles = this.defaultFontStyles.clone();
			itemRenderer.disabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.iconLabelFontStyles = this.defaultFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.accessoryLabelFontStyles = this.defaultFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.disabledFontStyles.clone();

			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;

			itemRenderer.iconPosition = RelativePosition.LEFT;
			itemRenderer.accessoryPosition = RelativePosition.RIGHT;

			itemRenderer.paddingTop = this.extraSmallGutterSize;
			itemRenderer.paddingBottom = this.extraSmallGutterSize;
			itemRenderer.paddingRight = this.smallGutterSize;
			itemRenderer.paddingLeft = this.smallGutterSize;
			itemRenderer.gap = this.extraSmallGutterSize;
			itemRenderer.minGap = this.extraSmallGutterSize;
			itemRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			itemRenderer.minAccessoryGap = this.smallGutterSize;

			itemRenderer.useStateDelayTimer = false;
		}

		protected function setDrillDownItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			itemRenderer.itemHasAccessory = false;
			var defaultAccessory:ImageLoader = new ImageLoader();
			defaultAccessory.source = this.listDrillDownAccessoryTexture;
			itemRenderer.defaultAccessory = defaultAccessory;
		}

		protected function setCheckItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture)
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			itemRenderer.defaultSkin = skin;

			itemRenderer.itemHasIcon = false;

			var icon:ImageSkin = new ImageSkin(this.checkUpIconTexture);
			icon.selectedTexture = this.checkSelectedUpIconTexture;
			icon.setTextureForState(ButtonState.HOVER, this.checkHoverIconTexture);
			icon.setTextureForState(ButtonState.DOWN, this.checkDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED, this.checkDisabledIconTexture);
			icon.setTextureForState(ButtonState.HOVER_AND_SELECTED, this.checkSelectedHoverIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.checkSelectedDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.checkSelectedDisabledIconTexture);
			itemRenderer.defaultIcon = icon;

			itemRenderer.fontStyles = this.defaultFontStyles.clone();
			itemRenderer.disabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.iconLabelFontStyles = this.defaultFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.accessoryLabelFontStyles = this.defaultFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.disabledFontStyles.clone();

			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;

			itemRenderer.iconPosition = RelativePosition.LEFT;
			itemRenderer.accessoryPosition = RelativePosition.RIGHT;

			itemRenderer.paddingTop = this.extraSmallGutterSize;
			itemRenderer.paddingBottom = this.extraSmallGutterSize;
			itemRenderer.paddingRight = this.smallGutterSize;
			itemRenderer.paddingLeft = this.smallGutterSize;
			itemRenderer.gap = this.smallGutterSize;
			itemRenderer.minGap = this.smallGutterSize;
			itemRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			itemRenderer.minAccessoryGap = this.smallGutterSize;

			itemRenderer.useStateDelayTimer = false;
		}

	//-------------------------
	// NumericStepper
	//-------------------------

		protected function setNumericStepperStyles(stepper:NumericStepper):void
		{
			stepper.buttonLayoutMode = StepperButtonLayoutMode.RIGHT_SIDE_VERTICAL;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			stepper.focusIndicatorSkin = focusIndicatorSkin;
			stepper.focusPadding = -1;
		}

		protected function setNumericStepperIncrementButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.stepperIncrementButtonUpSkinTexture);
			skin.setTextureForState(ButtonState.HOVER, this.stepperIncrementButtonHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.stepperIncrementButtonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.stepperIncrementButtonDisabledSkinTexture);
			skin.scale9Grid = STEPPER_INCREMENT_BUTTON_SCALE_9_GRID;
			button.defaultSkin = skin;
			button.keepDownStateOnRollOut = true;

			button.hasLabelTextRenderer = false;
		}

		protected function setNumericStepperDecrementButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.stepperDecrementButtonUpSkinTexture);
			skin.setTextureForState(ButtonState.HOVER, this.stepperDecrementButtonHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.stepperDecrementButtonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.stepperDecrementButtonDisabledSkinTexture);
			skin.scale9Grid = STEPPER_DECREMENT_BUTTON_SCALE_9_GRID;
			button.defaultSkin = skin;
			button.keepDownStateOnRollOut = true;

			button.hasLabelTextRenderer = false;
		}

		protected function setNumericStepperTextInputStyles(input:TextInput):void
		{
			var backgroundSkin:ImageSkin = new ImageSkin(this.textInputBackgroundEnabledSkinTexture);
			backgroundSkin.disabledTexture = this.textInputBackgroundDisabledSkinTexture;
			backgroundSkin.scale9Grid = TEXT_INPUT_SCALE_9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			backgroundSkin.minWidth = this.controlSize;
			backgroundSkin.minHeight = this.controlSize;
			input.backgroundSkin = backgroundSkin;

			input.fontStyles = this.defaultFontStyles.clone();
			input.disabledFontStyles = this.disabledFontStyles.clone();

			input.gap = this.extraSmallGutterSize;
			input.paddingTop = this.extraSmallGutterSize;
			input.paddingBottom = this.extraSmallGutterSize;
			input.paddingRight = this.smallGutterSize;
			input.paddingLeft = this.smallGutterSize;
		}

	//-------------------------
	// PanelScreen
	//-------------------------

		protected function setPanelScreenStyles(screen:PanelScreen):void
		{
			this.setScrollerStyles(screen);
		}

	//-------------------------
	// PageIndicator
	//-------------------------

		protected function setPageIndicatorStyles(pageIndicator:PageIndicator):void
		{
			pageIndicator.interactionMode = PageIndicatorInteractionMode.PRECISE;

			pageIndicator.normalSymbolFactory = this.pageIndicatorNormalSymbolFactory;
			pageIndicator.selectedSymbolFactory = this.pageIndicatorSelectedSymbolFactory;

			pageIndicator.gap = this.gutterSize;
			pageIndicator.padding = this.smallGutterSize;
		}

	//-------------------------
	// Panel
	//-------------------------

		protected function setPanelStyles(panel:Panel):void
		{
			this.setScrollerStyles(panel);

			var backgroundSkin:Image = new Image(this.panelBorderBackgroundSkinTexture);
			backgroundSkin.scale9Grid = PANEL_BORDER_SCALE_9_GRID;
			panel.backgroundSkin = backgroundSkin;

			panel.paddingTop = 0;
			panel.paddingRight = this.gutterSize;
			panel.paddingBottom = this.gutterSize;
			panel.paddingLeft = this.gutterSize;
		}

		protected function setPanelHeaderStyles(header:Header):void
		{
			header.fontStyles = this.defaultFontStyles.clone();
			header.disabledFontStyles = this.disabledFontStyles.clone();

			header.minHeight = this.gridSize;

			header.paddingTop = this.extraSmallGutterSize;
			header.paddingBottom = this.extraSmallGutterSize;
			header.paddingLeft = this.gutterSize;
			header.paddingRight = this.gutterSize;
			header.gap = this.extraSmallGutterSize;
			header.titleGap = this.smallGutterSize;
		}

	//-------------------------
	// PickerList
	//-------------------------

		protected function setPickerListStyles(list:PickerList):void
		{
			list.popUpContentManager = new DropDownPopUpContentManager();
		}

		protected function setPickerListButtonStyles(button:Button):void
		{
			this.setButtonStyles(button);

			var icon:ImageSkin = new ImageSkin(this.pickerListUpIconTexture);
			icon.setTextureForState(ButtonState.HOVER, this.pickerListHoverIconTexture);
			icon.setTextureForState(ButtonState.DOWN, this.pickerListDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED, this.pickerListDisabledIconTexture);
			button.defaultIcon = icon;

			button.gap = Number.POSITIVE_INFINITY; //fill as completely as possible
			button.minGap = this.smallGutterSize;
			button.horizontalAlign = HorizontalAlign.LEFT;
			button.iconPosition = RelativePosition.RIGHT;
			button.paddingRight = this.smallGutterSize;
		}

		//for the PickerList's pop-up list, see setDropDownListStyles()

	//-------------------------
	// ProgressBar
	//-------------------------

		protected function setProgressBarStyles(progress:ProgressBar):void
		{
			var backgroundSkin:Image = new Image(this.simpleBorderBackgroundSkinTexture);
			backgroundSkin.scale9Grid = SIMPLE_BORDER_SCALE_9_GRID;
			if(progress.direction == Direction.VERTICAL)
			{
				backgroundSkin.height = this.wideControlSize;
			}
			else
			{
				backgroundSkin.width = this.wideControlSize;
			}
			progress.backgroundSkin = backgroundSkin;

			var fillSkin:Image = new Image(this.progressBarFillSkinTexture);
			if(progress.direction == Direction.VERTICAL)
			{
				fillSkin.height = 0;
			}
			else
			{
				fillSkin.width = 0;
			}
			progress.fillSkin = fillSkin;

			progress.padding = this.borderSize;
		}

	//-------------------------
	// Radio
	//-------------------------

		protected function setRadioStyles(radio:Radio):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			radio.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.radioUpIconTexture);
			icon.selectedTexture = this.radioSelectedUpIconTexture;
			icon.setTextureForState(ButtonState.HOVER, this.radioHoverIconTexture);
			icon.setTextureForState(ButtonState.DOWN, this.radioDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED, this.radioDisabledIconTexture);
			icon.setTextureForState(ButtonState.HOVER_AND_SELECTED, this.radioSelectedHoverIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.radioSelectedDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.radioSelectedDisabledIconTexture);
			radio.defaultIcon = icon;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			radio.focusIndicatorSkin = focusIndicatorSkin;
			radio.focusPadding = -2;

			radio.fontStyles = this.defaultFontStyles.clone();
			radio.disabledFontStyles = this.disabledFontStyles.clone();

			radio.horizontalAlign = HorizontalAlign.LEFT;
			radio.verticalAlign = VerticalAlign.MIDDLE;

			radio.gap = this.smallGutterSize;
		}

	//-------------------------
	// ScrollBar
	//-------------------------

		protected function setHorizontalScrollBarStyles(scrollBar:ScrollBar):void
		{
			scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;

			scrollBar.customIncrementButtonStyleName = THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_INCREMENT_BUTTON;
			scrollBar.customDecrementButtonStyleName = THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_DECREMENT_BUTTON;
			scrollBar.customThumbStyleName = THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_THUMB;
			scrollBar.customMinimumTrackStyleName = THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_MINIMUM_TRACK;
		}

		protected function setVerticalScrollBarStyles(scrollBar:ScrollBar):void
		{
			scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;

			scrollBar.customIncrementButtonStyleName = THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_INCREMENT_BUTTON;
			scrollBar.customDecrementButtonStyleName = THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_DECREMENT_BUTTON;
			scrollBar.customThumbStyleName = THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_THUMB;
			scrollBar.customMinimumTrackStyleName = THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_MINIMUM_TRACK;
		}

		protected function setHorizontalScrollBarIncrementButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.hScrollBarStepButtonUpSkinTexture);
			skin.setTextureForState(ButtonState.HOVER, this.hScrollBarStepButtonHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.hScrollBarStepButtonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.hScrollBarStepButtonDisabledSkinTexture);
			skin.scale9Grid = HORIZONTAL_SCROLL_BAR_STEP_BUTTON_SCALE_9_GRID;
			button.defaultSkin = skin;

			button.defaultIcon = new Image(this.hScrollBarIncrementButtonIconTexture);

			var incrementButtonDisabledIcon:Quad = new Quad(1, 1, 0xff00ff);
			incrementButtonDisabledIcon.alpha = 0;
			button.disabledIcon = incrementButtonDisabledIcon;

			button.hasLabelTextRenderer = false;
		}

		protected function setHorizontalScrollBarDecrementButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(hScrollBarStepButtonUpSkinTexture);
			skin.setTextureForState(ButtonState.HOVER, this.hScrollBarStepButtonHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.hScrollBarStepButtonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.hScrollBarStepButtonDisabledSkinTexture);
			skin.scale9Grid = HORIZONTAL_SCROLL_BAR_STEP_BUTTON_SCALE_9_GRID;
			button.defaultSkin = skin;

			button.defaultIcon = new Image(this.hScrollBarDecrementButtonIconTexture);

			var decrementButtonDisabledIcon:Quad = new Quad(1, 1, 0xff00ff);
			decrementButtonDisabledIcon.alpha = 0;
			button.disabledIcon = decrementButtonDisabledIcon;

			button.hasLabelTextRenderer = false;
		}

		protected function setHorizontalScrollBarThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.hScrollBarThumbUpSkinTexture);
			skin.setTextureForState(ButtonState.HOVER, this.hScrollBarThumbHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.hScrollBarThumbDownSkinTexture);
			skin.scale9Grid = HORIZONTAL_SCROLL_BAR_THUMB_SCALE_9_GRID;
			skin.minWidth = this.smallControlSize;
			thumb.defaultSkin = skin;

			thumb.defaultIcon = new Image(this.hScrollBarThumbIconTexture);
			thumb.verticalAlign = VerticalAlign.MIDDLE;
			thumb.paddingBottom = this.extraSmallGutterSize;

			thumb.hasLabelTextRenderer = false;
		}

		protected function setHorizontalScrollBarMinimumTrackStyles(track:Button):void
		{
			var defaultSkin:Image = new Image(this.hScrollBarTrackSkinTexture);
			defaultSkin.scale9Grid = HORIZONTAL_SCROLL_BAR_TRACK_SCALE_9_GRID;
			track.defaultSkin = defaultSkin;

			track.hasLabelTextRenderer = false;
		}

		protected function setVerticalScrollBarIncrementButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.vScrollBarStepButtonUpSkinTexture);
			skin.setTextureForState(ButtonState.HOVER, this.vScrollBarStepButtonHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.vScrollBarStepButtonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.vScrollBarStepButtonDisabledSkinTexture);
			skin.scale9Grid = VERTICAL_SCROLL_BAR_STEP_BUTTON_SCALE_9_GRID;
			button.defaultSkin = skin;

			button.defaultIcon = new Image(this.vScrollBarIncrementButtonIconTexture);

			var incrementButtonDisabledIcon:Quad = new Quad(1, 1, 0xff00ff);
			incrementButtonDisabledIcon.alpha = 0;
			button.disabledIcon = incrementButtonDisabledIcon;

			button.hasLabelTextRenderer = false;
		}

		protected function setVerticalScrollBarDecrementButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.vScrollBarStepButtonUpSkinTexture);
			skin.setTextureForState(ButtonState.HOVER, this.vScrollBarStepButtonHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.vScrollBarStepButtonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.vScrollBarStepButtonDisabledSkinTexture);
			skin.scale9Grid = VERTICAL_SCROLL_BAR_STEP_BUTTON_SCALE_9_GRID;
			button.defaultSkin = skin;

			button.defaultIcon = new Image(this.vScrollBarDecrementButtonIconTexture);

			var decrementButtonDisabledIcon:Quad = new Quad(1, 1, 0xff00ff);
			decrementButtonDisabledIcon.alpha = 0;
			button.disabledIcon = decrementButtonDisabledIcon;

			button.hasLabelTextRenderer = false;
		}

		protected function setVerticalScrollBarThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.vScrollBarThumbUpSkinTexture);
			skin.setTextureForState(ButtonState.HOVER, this.vScrollBarThumbHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.vScrollBarThumbDownSkinTexture);
			skin.scale9Grid = VERTICAL_SCROLL_BAR_THUMB_SCALE_9_GRID;
			skin.minHeight = this.smallControlSize;
			thumb.defaultSkin = skin;

			thumb.defaultIcon = new Image(this.vScrollBarThumbIconTexture);
			thumb.horizontalAlign = HorizontalAlign.CENTER;
			thumb.paddingRight = this.extraSmallGutterSize;

			thumb.hasLabelTextRenderer = false;
		}

		protected function setVerticalScrollBarMinimumTrackStyles(track:Button):void
		{
			var defaultSkin:Image = new Image(this.vScrollBarTrackSkinTexture);
			defaultSkin.scale9Grid = VERTICAL_SCROLL_BAR_TRACK_SCALE_9_GRID;
			track.defaultSkin = defaultSkin;

			track.hasLabelTextRenderer = false;
		}

	//-------------------------
	// ScrollContainer
	//-------------------------

		protected function setScrollContainerStyles(container:ScrollContainer):void
		{
			this.setScrollerStyles(container);
		}

		protected function setToolbarScrollContainerStyles(container:ScrollContainer):void
		{
			this.setScrollerStyles(container);

			if(!container.layout)
			{
				var layout:HorizontalLayout = new HorizontalLayout();
				layout.paddingTop = this.extraSmallGutterSize;
				layout.paddingBottom = this.extraSmallGutterSize;
				layout.paddingRight = this.smallGutterSize;
				layout.paddingLeft = this.smallGutterSize;
				layout.gap = this.extraSmallGutterSize;
				layout.verticalAlign = VerticalAlign.MIDDLE;
				container.layout = layout;
			}

			var backgroundSkin:Image = new Image(this.headerBackgroundSkinTexture);
			backgroundSkin.scale9Grid = HEADER_SCALE_9_GRID;
			container.backgroundSkin = backgroundSkin;

			container.minHeight = this.gridSize;
		}

	//-------------------------
	// ScrollScreen
	//-------------------------

		protected function setScrollScreenStyles(screen:ScrollScreen):void
		{
			this.setScrollerStyles(screen);
		}

	//-------------------------
	// ScrollText
	//-------------------------

		protected function setScrollTextStyles(text:ScrollText):void
		{
			this.setScrollerStyles(text);

			text.fontStyles = this.defaultFontStyles.clone();
			text.disabledFontStyles = this.disabledFontStyles.clone();

			text.padding = this.gutterSize;
		}

	//-------------------------
	// SimpleScrollBar
	//-------------------------

		protected function setHorizontalSimpleScrollBarStyles(scrollBar:SimpleScrollBar):void
		{
			scrollBar.customThumbStyleName = THEME_STYLE_NAME_HORIZONTAL_SIMPLE_SCROLL_BAR_THUMB;
		}

		protected function setVerticalSimpleScrollBarStyles(scrollBar:SimpleScrollBar):void
		{
			scrollBar.customThumbStyleName = THEME_STYLE_NAME_VERTICAL_SIMPLE_SCROLL_BAR_THUMB;
		}

		protected function setHorizontalSimpleScrollBarThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.hScrollBarThumbUpSkinTexture);
			skin.setTextureForState(ButtonState.HOVER, this.hScrollBarThumbHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.hScrollBarThumbDownSkinTexture);
			skin.scale9Grid = HORIZONTAL_SCROLL_BAR_THUMB_SCALE_9_GRID;
			thumb.defaultSkin = skin;

			thumb.defaultIcon = new Image(this.hScrollBarThumbIconTexture);
			thumb.verticalAlign = VerticalAlign.TOP;
			thumb.paddingTop = this.smallGutterSize;

			thumb.hasLabelTextRenderer = false;
		}

		protected function setVerticalSimpleScrollBarThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.vScrollBarThumbUpSkinTexture);
			skin.setTextureForState(ButtonState.HOVER, this.vScrollBarThumbHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.vScrollBarThumbDownSkinTexture);
			skin.scale9Grid = VERTICAL_SCROLL_BAR_THUMB_SCALE_9_GRID;
			thumb.defaultSkin = skin;

			thumb.defaultIcon = new Image(this.vScrollBarThumbIconTexture);
			thumb.horizontalAlign = HorizontalAlign.LEFT;
			thumb.paddingLeft = this.smallGutterSize;

			thumb.hasLabelTextRenderer = false;
		}

	//-------------------------
	// Slider
	//-------------------------

		protected function setSliderStyles(slider:Slider):void
		{
			slider.trackLayoutMode = TrackLayoutMode.SINGLE;
			slider.minimumPadding = slider.maximumPadding = -vSliderThumbUpSkinTexture.height / 2;

			if(slider.direction == Direction.VERTICAL)
			{
				slider.customThumbStyleName = THEME_STYLE_NAME_VERTICAL_SLIDER_THUMB;
				slider.customMinimumTrackStyleName = THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK;

				slider.focusPaddingLeft = slider.focusPaddingRight = -2;
				slider.focusPaddingTop = slider.focusPaddingBottom = -2 + slider.minimumPadding;
			}
			else //horizontal
			{
				slider.customThumbStyleName = THEME_STYLE_NAME_HORIZONTAL_SLIDER_THUMB;
				slider.customMinimumTrackStyleName = THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK;

				slider.focusPaddingTop = slider.focusPaddingBottom = -2;
				slider.focusPaddingLeft = slider.focusPaddingRight = -2 + slider.minimumPadding;
			}

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			slider.focusIndicatorSkin = focusIndicatorSkin;
		}

		protected function setHorizontalSliderThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.hSliderThumbUpSkinTexture);
			skin.setTextureForState(ButtonState.HOVER, this.hSliderThumbHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.hSliderThumbDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.hSliderThumbDisabledSkinTexture);
			thumb.defaultSkin = skin;

			thumb.hasLabelTextRenderer = false;
		}

		protected function setHorizontalSliderMinimumTrackStyles(track:Button):void
		{
			var defaultSkin:Image = new Image(this.hSliderTrackEnabledSkinTexture);
			defaultSkin.scale9Grid = HORIZONTAL_SLIDER_TRACK_SCALE_9_GRID;
			defaultSkin.width = this.wideControlSize;
			track.defaultSkin = defaultSkin;

			track.minTouchHeight = this.controlSize;

			track.hasLabelTextRenderer = false;
		}

		protected function setVerticalSliderThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.vSliderThumbUpSkinTexture);
			skin.setTextureForState(ButtonState.HOVER, this.vSliderThumbHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.vSliderThumbDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.vSliderThumbDisabledSkinTexture);
			thumb.defaultSkin = skin;

			thumb.hasLabelTextRenderer = false;
		}

		protected function setVerticalSliderMinimumTrackStyles(track:Button):void
		{
			var defaultSkin:Image = new Image(this.vSliderTrackEnabledSkinTexture);
			defaultSkin.scale9Grid = VERTICAL_SLIDER_TRACK_SCALE_9_GRID;
			defaultSkin.height = this.wideControlSize;
			track.defaultSkin = defaultSkin;

			track.minTouchWidth = this.controlSize;

			track.hasLabelTextRenderer = false;
		}

	//-------------------------
	// SpinnerList
	//-------------------------

		protected function setSpinnerListStyles(list:SpinnerList):void
		{
			this.setListStyles(list);
		}

	//-------------------------
	// TabBar
	//-------------------------

		protected function setTabBarStyles(tabBar:TabBar):void
		{
			tabBar.distributeTabSizes = false;
			tabBar.horizontalAlign = HorizontalAlign.LEFT;
			tabBar.verticalAlign = VerticalAlign.JUSTIFY;
		}

		protected function setTabStyles(tab:ToggleButton):void
		{
			var skin:ImageSkin = new ImageSkin(this.tabUpSkinTexture);
			skin.selectedTexture = this.tabSelectedUpSkinTexture;
			skin.setTextureForState(ButtonState.HOVER, this.tabHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.tabDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.tabDisabledSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.tabSelectedDisabledSkinTexture);
			skin.scale9Grid = TAB_SCALE_9_GRID;
			skin.minWidth = this.buttonMinWidth;
			skin.minHeight = this.controlSize;
			tab.defaultSkin = skin;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			tab.focusIndicatorSkin = focusIndicatorSkin;

			tab.fontStyles = this.defaultFontStyles.clone();
			tab.disabledFontStyles = this.disabledFontStyles.clone();

			tab.paddingTop = this.extraSmallGutterSize;
			tab.paddingBottom = this.extraSmallGutterSize;
			tab.paddingLeft = this.smallGutterSize;
			tab.paddingRight = this.smallGutterSize;
			tab.gap = this.extraSmallGutterSize;
		}

	//-------------------------
	// TextArea
	//-------------------------

		protected function setTextAreaStyles(textArea:TextArea):void
		{
			this.setScrollerStyles(textArea);

			var skin:ImageSkin = new ImageSkin(this.textInputBackgroundEnabledSkinTexture);
			skin.disabledTexture = this.textInputBackgroundDisabledSkinTexture;
			skin.setTextureForState(TextInputState.ERROR, this.textInputBackgroundErrorSkinTexture);
			skin.scale9Grid = TEXT_INPUT_SCALE_9_GRID;
			skin.width = this.wideControlSize * 2;
			skin.height = this.wideControlSize;
			textArea.backgroundSkin = skin;

			textArea.fontStyles = this.defaultFontStyles.clone();
			textArea.disabledFontStyles = this.disabledFontStyles.clone();

			textArea.promptFontStyles = this.defaultFontStyles.clone();
			textArea.promptDisabledFontStyles = this.disabledFontStyles.clone();

			textArea.focusPadding = -2;
			textArea.padding = this.borderSize;
			
			textArea.innerPaddingTop = this.extraSmallGutterSize;
			textArea.innerPaddingRight = this.smallGutterSize;
			textArea.innerPaddingBottom = this.extraSmallGutterSize;
			textArea.innerPaddingLeft = this.smallGutterSize;
		}

		protected function setTextAreaErrorCalloutStyles(callout:TextCallout):void
		{
			this.setDangerTextCalloutStyles(callout);
			callout.verticalAlign = VerticalAlign.TOP;
			callout.horizontalAlign = HorizontalAlign.LEFT;
			callout.supportedPositions = new <String>[RelativePosition.RIGHT,
				RelativePosition.TOP, RelativePosition.BOTTOM, RelativePosition.LEFT];
		}

	//-------------------------
	// TextCallout
	//-------------------------

		protected function setTextCalloutStyles(callout:TextCallout):void
		{
			this.setCalloutStyles(callout);

			callout.fontStyles = this.defaultFontStyles.clone();
			callout.disabledFontStyles = this.disabledFontStyles.clone();
		}

		protected function setDangerTextCalloutStyles(callout:TextCallout):void
		{
			this.setDangerCalloutStyles(callout);

			callout.fontStyles = this.invertedFontStyles.clone();
			callout.disabledFontStyles = this.disabledFontStyles.clone();
		}

	//-------------------------
	// TextInput
	//-------------------------

		protected function setBaseTextInputStyles(input:TextInput):void
		{
			var skin:ImageSkin = new ImageSkin(this.textInputBackgroundEnabledSkinTexture);
			skin.disabledTexture = this.textInputBackgroundDisabledSkinTexture;
			skin.setTextureForState(TextInputState.ERROR, this.textInputBackgroundErrorSkinTexture);
			skin.scale9Grid = TEXT_INPUT_SCALE_9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.wideControlSize;
			skin.minHeight = this.controlSize;
			input.backgroundSkin = skin;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			input.focusIndicatorSkin = focusIndicatorSkin;
			input.focusPadding = -2;

			input.gap = this.extraSmallGutterSize;
			input.paddingTop = this.extraSmallGutterSize;
			input.paddingBottom = this.extraSmallGutterSize;
			input.paddingRight = this.smallGutterSize;
			input.paddingLeft = this.smallGutterSize;
		}

		protected function setTextInputStyles(input:TextInput):void
		{
			this.setBaseTextInputStyles(input);

			input.fontStyles = this.defaultFontStyles.clone();
			input.disabledFontStyles = this.disabledFontStyles.clone();

			input.promptFontStyles = this.defaultFontStyles.clone();
			input.promptDisabledFontStyles = this.disabledFontStyles.clone();
		}

		protected function setSearchTextInputStyles(input:TextInput):void
		{
			this.setBaseTextInputStyles(input);

			var icon:ImageSkin = new ImageSkin(this.textInputSearchIconTexture);
			icon.disabledTexture = this.textInputSearchIconDisabledTexture;
			input.defaultIcon = icon;

			input.fontStyles = this.defaultFontStyles.clone();
			input.disabledFontStyles = this.disabledFontStyles.clone();

			input.promptFontStyles = this.defaultFontStyles.clone();
			input.promptDisabledFontStyles = this.disabledFontStyles.clone();
		}

		protected function setTextInputErrorCalloutStyles(callout:TextCallout):void
		{
			this.setDangerTextCalloutStyles(callout);

			callout.verticalAlign = VerticalAlign.TOP;
			callout.horizontalAlign = HorizontalAlign.LEFT;
			callout.supportedPositions = new <String>[RelativePosition.RIGHT,
				RelativePosition.TOP, RelativePosition.BOTTOM, RelativePosition.LEFT];
		}

	//-------------------------
	// Toast
	//-------------------------

		protected function setToastStyles(toast:Toast):void
		{
			var backgroundSkin:Image = new Image(this.toolTipBackgroundSkinTexture);
			backgroundSkin.scale9Grid = TOOL_TIP_SCALE_9_GRID;
			toast.backgroundSkin = backgroundSkin;

			toast.fontStyles = this.defaultFontStyles.clone();
			toast.disabledFontStyles = this.disabledFontStyles.clone();

			toast.width = this.extraWideControlSize;
			toast.paddingTop = this.gutterSize;
			toast.paddingRight = this.gutterSize;
			toast.paddingBottom = this.gutterSize;
			toast.paddingLeft = this.gutterSize;
			toast.gap = Number.POSITIVE_INFINITY;
			toast.minGap = this.smallGutterSize;
			toast.horizontalAlign = HorizontalAlign.LEFT;
			toast.verticalAlign = VerticalAlign.MIDDLE;
		}

		protected function setToastActionsStyles(group:ButtonGroup):void
		{
			group.direction = Direction.HORIZONTAL;
			group.gap = this.smallGutterSize;
			group.customButtonStyleName = THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON;
		}

		protected function setToastActionsButtonStyles(button:Button):void
		{
			button.fontStyles = this.toastActionFontStyles.clone();
			button.setFontStylesForState(ButtonState.DOWN, this.toastActionActiveFontStyles);
		}

	//-------------------------
	// ToggleSwitch
	//-------------------------

		protected function setToggleSwitchStyles(toggle:ToggleSwitch):void
		{
			toggle.onLabelFontStyles = this.defaultFontStyles.clone();
			toggle.onLabelDisabledFontStyles = this.disabledFontStyles.clone();

			toggle.offLabelFontStyles = this.defaultFontStyles.clone();
			toggle.offLabelDisabledFontStyles = this.disabledFontStyles.clone();

			toggle.trackLayoutMode = TrackLayoutMode.SINGLE;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			toggle.focusIndicatorSkin = focusIndicatorSkin;
			toggle.focusPadding = -1;
		}

		protected function setToggleSwitchOnTrackStyles(track:Button):void
		{
			var defaultSkin:Image = new Image(this.toggleButtonSelectedUpSkinTexture);
			defaultSkin.scale9Grid = BUTTON_SCALE_9_GRID;
			defaultSkin.width = 2 * this.controlSize + this.smallControlSize;
			track.defaultSkin = defaultSkin;

			track.hasLabelTextRenderer = false;
		}

		protected function setToggleSwitchThumbStyles(thumb:Button):void
		{
			this.setButtonStyles(thumb);
			
			thumb.width = this.controlSize;
			thumb.height = this.controlSize;

			thumb.hasLabelTextRenderer = false;
		}

	//-------------------------
	// Tree
	//-------------------------

		protected function setTreeStyles(tree:Tree):void
		{
			this.setScrollerStyles(tree);

			tree.verticalScrollPolicy = ScrollPolicy.AUTO;

			var backgroundSkin:ImageSkin = new ImageSkin(this.simpleBorderBackgroundSkinTexture);
			backgroundSkin.scale9Grid = SIMPLE_BORDER_SCALE_9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			tree.backgroundSkin = backgroundSkin;

			tree.padding = this.borderSize;
		}

		protected function setTreeItemRendererStyles(itemRenderer:DefaultTreeItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			itemRenderer.indentation = this.gutterSize;

			itemRenderer.disclosureOpenIcon = new ImageSkin(this.treeDisclosureOpenIconTexture);
			itemRenderer.disclosureClosedIcon = new ImageSkin(this.treeDisclosureClosedIconTexture);
			itemRenderer.branchIcon = new ImageSkin(this.treeBranchClosedIconTexture);
			itemRenderer.branchOpenIcon = new ImageSkin(this.treeBranchOpenIconTexture);
			itemRenderer.leafIcon = new ImageSkin(this.treeLeafIconTexture);
		}

	//-------------------------
	// PlayPauseToggleButton
	//-------------------------

		protected function setPlayPauseToggleButtonStyles(button:PlayPauseToggleButton):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			button.defaultSkin = defaultSkin;

			var otherSkin:ImageSkin = new ImageSkin(null);
			otherSkin.setTextureForState(ButtonState.HOVER, this.quietButtonHoverSkinTexture);
			otherSkin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			otherSkin.setTextureForState(ButtonState.HOVER_AND_SELECTED, this.toggleButtonSelectedHoverSkinTexture);
			otherSkin.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.toggleButtonSelectedDownSkinTexture);
			otherSkin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.toggleButtonSelectedDisabledSkinTexture);
			otherSkin.width = this.controlSize;
			otherSkin.height = this.controlSize;
			otherSkin.minWidth = this.controlSize;
			otherSkin.minHeight = this.controlSize;
			button.setSkinForState(ButtonState.HOVER, otherSkin);
			button.setSkinForState(ButtonState.DOWN, otherSkin);
			button.setSkinForState(ButtonState.HOVER_AND_SELECTED, otherSkin);
			button.setSkinForState(ButtonState.DOWN_AND_SELECTED, otherSkin);
			button.setSkinForState(ButtonState.DISABLED_AND_SELECTED, otherSkin);

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = -1;

			var icon:ImageSkin = new ImageSkin(this.playPauseButtonPlayUpIconTexture);
			icon.selectedTexture = this.playPauseButtonPauseUpIconTexture;
			button.defaultIcon = icon;

			button.hasLabelTextRenderer = false;

			button.paddingTop = this.extraSmallGutterSize;
			button.paddingRight = this.smallGutterSize;
			button.paddingBottom = this.extraSmallGutterSize;
			button.paddingLeft = this.smallGutterSize;
			button.gap = this.smallGutterSize;
		}

		protected function setOverlayPlayPauseToggleButtonStyles(button:PlayPauseToggleButton):void
		{
			var icon:ImageSkin = new ImageSkin(null);
			icon.setTextureForState(ButtonState.UP, this.overlayPlayPauseButtonPlayUpIconTexture);
			icon.setTextureForState(ButtonState.HOVER, this.overlayPlayPauseButtonPlayUpIconTexture);
			icon.setTextureForState(ButtonState.DOWN, this.overlayPlayPauseButtonPlayUpIconTexture);
			button.defaultIcon = icon;

			button.isFocusEnabled = false;

			button.hasLabelTextRenderer = false;

			var overlaySkin:Quad = new Quad(1, 1, VIDEO_OVERLAY_COLOR);
			overlaySkin.alpha = VIDEO_OVERLAY_ALPHA;
			button.upSkin = overlaySkin;
			button.hoverSkin = overlaySkin;
		}

	//-------------------------
	// FullScreenToggleButton
	//-------------------------

		protected function setFullScreenToggleButtonStyles(button:FullScreenToggleButton):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			button.defaultSkin = defaultSkin;

			var otherSkin:ImageSkin = new ImageSkin(null);
			otherSkin.setTextureForState(ButtonState.HOVER, this.quietButtonHoverSkinTexture);
			otherSkin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			otherSkin.setTextureForState(ButtonState.HOVER_AND_SELECTED, this.toggleButtonSelectedHoverSkinTexture);
			otherSkin.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.toggleButtonSelectedDownSkinTexture);
			otherSkin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.toggleButtonSelectedDisabledSkinTexture);
			otherSkin.width = this.controlSize;
			otherSkin.height = this.controlSize;
			otherSkin.minWidth = this.controlSize;
			otherSkin.minHeight = this.controlSize;
			button.setSkinForState(ButtonState.HOVER, otherSkin);
			button.setSkinForState(ButtonState.DOWN, otherSkin);
			button.setSkinForState(ButtonState.HOVER_AND_SELECTED, otherSkin);
			button.setSkinForState(ButtonState.DOWN_AND_SELECTED, otherSkin);
			button.setSkinForState(ButtonState.DISABLED_AND_SELECTED, otherSkin);

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = -1;

			var icon:ImageSkin = new ImageSkin(this.fullScreenToggleButtonEnterUpIconTexture);
			icon.selectedTexture = this.fullScreenToggleButtonExitUpIconTexture;
			button.defaultIcon = icon;

			button.hasLabelTextRenderer = false;

			button.paddingTop = this.extraSmallGutterSize;
			button.paddingRight = this.smallGutterSize;
			button.paddingBottom = this.extraSmallGutterSize;
			button.paddingLeft = this.smallGutterSize;
			button.gap = this.smallGutterSize;
		}

	//-------------------------
	// VolumeSlider
	//-------------------------

		protected function setVolumeSliderStyles(slider:VolumeSlider):void
		{
			slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			slider.focusIndicatorSkin = focusIndicatorSkin;
			slider.focusPadding = -1;
			slider.showThumb = false;
			if(slider.direction == Direction.VERTICAL)
			{
				slider.customMinimumTrackStyleName = THEME_STYLE_NAME_VERTICAL_VOLUME_SLIDER_MINIMUM_TRACK;
				slider.customMaximumTrackStyleName = THEME_STYLE_NAME_VERTICAL_VOLUME_SLIDER_MAXIMUM_TRACK;
				slider.width = this.verticalVolumeSliderMinimumTrackSkinTexture.width;
				slider.height = this.verticalVolumeSliderMinimumTrackSkinTexture.height;
			}
			else //horizontal
			{
				slider.customMinimumTrackStyleName = THEME_STYLE_NAME_HORIZONTAL_VOLUME_SLIDER_MINIMUM_TRACK;
				slider.customMaximumTrackStyleName = THEME_STYLE_NAME_HORIZONTAL_VOLUME_SLIDER_MAXIMUM_TRACK;
				slider.width = this.horizontalVolumeSliderMinimumTrackSkinTexture.width;
				slider.height = this.horizontalVolumeSliderMinimumTrackSkinTexture.height;
			}
		}

		protected function setVolumeSliderThumbStyles(button:Button):void
		{
			var thumbSize:Number = 6;
			button.defaultSkin = new Quad(thumbSize, thumbSize);
			button.defaultSkin.width = 0;
			button.defaultSkin.height = 0;
			button.hasLabelTextRenderer = false;
		}

		protected function setHorizontalVolumeSliderMinimumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageLoader = new ImageLoader();
			defaultSkin.scaleContent = false;
			defaultSkin.source = this.horizontalVolumeSliderMinimumTrackSkinTexture;
			track.defaultSkin = defaultSkin;
			track.hasLabelTextRenderer = false;
		}

		protected function setHorizontalVolumeSliderMaximumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageLoader = new ImageLoader();
			defaultSkin.scaleContent = false;
			defaultSkin.horizontalAlign = HorizontalAlign.RIGHT;
			defaultSkin.source = this.horizontalVolumeSliderMaximumTrackSkinTexture;
			track.defaultSkin = defaultSkin;
			track.hasLabelTextRenderer = false;
		}

		protected function setVerticalVolumeSliderMinimumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageLoader = new ImageLoader();
			defaultSkin.scaleContent = false;
			defaultSkin.verticalAlign = VerticalAlign.BOTTOM;
			defaultSkin.source = this.verticalVolumeSliderMinimumTrackSkinTexture;
			track.defaultSkin = defaultSkin;
			track.hasLabelTextRenderer = false;
		}

		protected function setVerticalVolumeSliderMaximumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageLoader = new ImageLoader();
			defaultSkin.scaleContent = false;
			defaultSkin.source = this.verticalVolumeSliderMaximumTrackSkinTexture;
			track.defaultSkin = defaultSkin;
			track.hasLabelTextRenderer = false;
		}

	//-------------------------
	// MuteToggleButton
	//-------------------------

		protected function setMuteToggleButtonStyles(button:MuteToggleButton):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			button.defaultSkin = defaultSkin;
			
			var otherSkin:ImageSkin = new ImageSkin(null);
			otherSkin.setTextureForState(ButtonState.HOVER, this.quietButtonHoverSkinTexture);
			otherSkin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			otherSkin.setTextureForState(ButtonState.HOVER_AND_SELECTED, this.toggleButtonSelectedHoverSkinTexture);
			otherSkin.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.toggleButtonSelectedDownSkinTexture);
			otherSkin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.toggleButtonSelectedDisabledSkinTexture);
			otherSkin.width = this.controlSize;
			otherSkin.height = this.controlSize;
			otherSkin.minWidth = this.controlSize;
			otherSkin.minHeight = this.controlSize;
			button.setSkinForState(ButtonState.HOVER, otherSkin);
			button.setSkinForState(ButtonState.DOWN, otherSkin);
			button.setSkinForState(ButtonState.HOVER_AND_SELECTED, otherSkin);
			button.setSkinForState(ButtonState.DOWN_AND_SELECTED, otherSkin);
			button.setSkinForState(ButtonState.DISABLED_AND_SELECTED, otherSkin);

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = -1;

			var icon:ImageSkin = new ImageSkin(this.muteToggleButtonLoudUpIconTexture);
			icon.selectedTexture = this.muteToggleButtonMutedUpIconTexture;
			button.defaultIcon = icon;

			button.showVolumeSliderOnHover = true;
			button.hasLabelTextRenderer = false;

			button.paddingTop = this.extraSmallGutterSize;
			button.paddingRight = this.smallGutterSize;
			button.paddingBottom = this.extraSmallGutterSize;
			button.paddingLeft = this.smallGutterSize;
			button.gap = this.smallGutterSize;
		}

		protected function setPopUpVolumeSliderStyles(slider:VolumeSlider):void
		{
			slider.direction = Direction.VERTICAL;
			slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			slider.showThumb = false;
			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			slider.focusIndicatorSkin = focusIndicatorSkin;
			slider.focusPadding = 4;
			slider.width = this.popUpVolumeSliderMinimumTrackSkinTexture.width;
			slider.height = this.popUpVolumeSliderMinimumTrackSkinTexture.height;
			slider.minimumPadding = this.popUpVolumeSliderPaddingSize;
			slider.maximumPadding = this.popUpVolumeSliderPaddingSize;
			slider.customMinimumTrackStyleName = THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_MINIMUM_TRACK;
			slider.customMaximumTrackStyleName = THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_MAXIMUM_TRACK;
		}

		protected function setPopUpVolumeSliderMinimumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageLoader = new ImageLoader();
			defaultSkin.scaleContent = false;
			defaultSkin.verticalAlign = VerticalAlign.BOTTOM;
			defaultSkin.source = this.popUpVolumeSliderMinimumTrackSkinTexture;
			track.defaultSkin = defaultSkin;
			track.hasLabelTextRenderer = false;
		}

		protected function setPopUpVolumeSliderMaximumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageLoader = new ImageLoader();
			defaultSkin.scaleContent = false;
			defaultSkin.source = this.popUpVolumeSliderMaximumTrackSkinTexture;
			track.defaultSkin = defaultSkin;
			track.hasLabelTextRenderer = false;
		}

	//-------------------------
	// SeekSlider
	//-------------------------

		protected function setSeekSliderStyles(slider:SeekSlider):void
		{
			slider.direction = Direction.HORIZONTAL;
			slider.trackLayoutMode = TrackLayoutMode.SPLIT;

			slider.minimumPadding = slider.maximumPadding = -this.vSliderThumbUpSkinTexture.height / 2;

			slider.focusPaddingTop = slider.focusPaddingBottom = -2;
			slider.focusPaddingLeft = slider.focusPaddingRight = -2 + slider.minimumPadding;

			var progressSkin:Image = new Image(this.seekSliderProgressSkinTexture);
			progressSkin.scale9Grid = SEEK_SLIDER_MAXIMUM_TRACK_SCALE_9_GRID;
			progressSkin.width = this.smallControlSize;
			slider.progressSkin = progressSkin;
		}

		protected function setSeekSliderMinimumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageSkin = new ImageSkin(this.seekSliderMinimumTrackSkinTexture);
			defaultSkin.scale9Grid = SEEK_SLIDER_MINIMUM_TRACK_SCALE_9_GRID;
			defaultSkin.width = this.wideControlSize;
			defaultSkin.minWidth = this.wideControlSize;
			track.defaultSkin = defaultSkin;

			track.minTouchHeight = this.controlSize;
			track.hasLabelTextRenderer = false;
		}

		protected function setSeekSliderMaximumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageSkin = new ImageSkin(this.seekSliderMaximumTrackSkinTexture);
			defaultSkin.scale9Grid = SEEK_SLIDER_MAXIMUM_TRACK_SCALE_9_GRID;
			defaultSkin.width = this.wideControlSize;
			defaultSkin.minWidth = this.wideControlSize;
			track.defaultSkin = defaultSkin;

			track.minTouchHeight = this.controlSize;
			track.hasLabelTextRenderer = false;
		}
	}
}


================================================
FILE: themes/Export Theme PNGs.jsfl
================================================
var folder = fl.browseForFolderURL("Select a folder to export theme assets");

var libraryItems = fl.getDocumentDOM().library.items;
var libraryItemsCount = libraryItems.length;

var otherDocument = fl.createDocument("timeline");

for(var i = 0; i < libraryItemsCount; i++)
{
	var item = libraryItems[i];
	if(item.itemType !== "movie clip")
	{
		continue;
	}
	if(item.name.indexOf("Export/") !== 0)
	{
		continue;
	}
	fl.copyLibraryItem(document.pathURI, item.name);
	otherDocument.clipPaste(true);
	var selectedItem = otherDocument.selection[0];
	var itemName = item.name.substr("Export/".length);
	var exportPath = folder + "/" + itemName + "0000.png";
	otherDocument.exportInstanceToPNGSequence(exportPath);
	otherDocument.deleteSelection();
}
otherDocument.close(false);

================================================
FILE: themes/MetalWorksDesktopTheme/README.md
================================================
# Metal Works Desktop Theme for Feathers

This [Feathers](http://feathersui.com/) theme for desktop combines an industrial aesthetic with bold orange highlights.

## Original Artwork

This theme's texture atlas was exported from Adobe Animate CC. To modify colors and other properties, or to add new skins to the texture atlas, [download the source FLA file](http://feathersui.com/help/theme-sources.html) from the Feathers website.

## Credits

Created exclusively for Feathers by [Josh Tynjala](https://joshblog.net/). Uses the open source font [Source Sans Pro](https://github.com/adobe/Source-Sans-Pro) created by Adobe Systems Incorporated.

================================================
FILE: themes/MetalWorksDesktopTheme/assets/images/metalworks_desktop.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<TextureAtlas imagePath="metalworks_desktop.png">
	<!-- Created with Adobe Animate version 18.0.1.115 -->
	<!-- http://www.adobe.com/products/animate.html -->
	<SubTexture name="back-button-disabled-skin0000" x="49" y="312" width="37" height="45" pivotX="0.1" pivotY="0"/>
	<SubTexture name="back-button-down-skin0000" x="472" y="308" width="37" height="45" pivotX="0.1" pivotY="0"/>
	<SubTexture name="back-button-up-skin0000" x="472" y="262" width="37" height="45" pivotX="0.1" pivotY="0"/>
	<SubTexture name="background-danger-popup-skin0000" x="226" y="420" width="13" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="background-danger-skin0000" x="260" y="433" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="background-disabled-skin0000" x="226" y="433" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="background-focused-skin0000" x="391" y="432" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="background-popup-skin0000" x="430" y="432" width="13" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="background-skin0000" x="243" y="433" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="button-disabled-skin0000" x="271" y="388" width="14" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="button-down-skin0000" x="241" y="388" width="14" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="button-up-skin0000" x="256" y="388" width="14" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="call-to-action-button-down-skin0000" x="286" y="388" width="14" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="call-to-action-button-up-skin0000" x="26" y="381" width="14" height="45" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-arrow-bottom-skin0000" x="87" y="333" width="40" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-arrow-left-skin0000" x="140" y="312" width="26" height="40" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-arrow-right-skin0000" x="485" y="1" width="26" height="41" pivotX="0.05" pivotY="0"/>
	<SubTexture name="callout-arrow-top-skin0000" x="167" y="351" width="40" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="check-disabled-icon0000" x="316" y="355" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="check-down-icon0000" x="208" y="362" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="check-selected-disabled-icon0000" x="75" y="360" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="check-selected-down-icon0000" x="42" y="358" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="check-selected-up-icon0000" x="382" y="355" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="check-up-icon0000" x="349" y="355" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-button-down-skin0000" x="301" y="388" width="14" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-button-up-skin0000" x="415" y="387" width="14" height="45" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-arrow-bottom-skin0000" x="451" y="354" width="40" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-arrow-left-skin0000" x="424" y="346" width="26" height="40" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-arrow-right-skin0000" x="229" y="267" width="26" height="41" pivotX="0.05" pivotY="0"/>
	<SubTexture name="danger-callout-arrow-top-skin0000" x="1" y="354" width="40" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-column-drop-indicator-skin0000" x="505" y="104" width="6" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-column-resize-skin0000" x="505" y="43" width="6" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-divider-skin0000" x="250" y="309" width="10" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-sort-ascending-icon0000" x="277" y="433" width="17" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-sort-descending-icon0000" x="295" y="433" width="17" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-vertical-divider-skin0000" x="502" y="43" width="2" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="focus-indicator-skin0000" x="391" y="388" width="22" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="forward-button-disabled-skin0000" x="469" y="216" width="37" height="45" pivotX="0" pivotY="0"/>
	<SubTexture name="forward-button-down-skin0000" x="469" y="170" width="37" height="45" pivotX="0" pivotY="0"/>
	<SubTexture name="forward-button-up-skin0000" x="469" y="124" width="37" height="45" pivotX="0" pivotY="0"/>
	<SubTexture name="full-screen-toggle-button-enter-down-icon0000" x="424" y="169" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="full-screen-toggle-button-enter-up-icon0000" x="424" y="124" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="full-screen-toggle-button-exit-down-icon0000" x="424" y="214" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="full-screen-toggle-button-exit-up-icon0000" x="424" y="259" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="header-background-skin0000" x="1" y="1" width="260" height="132" pivotX="0" pivotY="0"/>
	<SubTexture name="header-popup-background-skin0000" x="1" y="134" width="260" height="132" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-decrement-button-disabled-icon0000" x="505" y="115" width="6" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-decrement-button-disabled-skin0000" x="341" y="388" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-decrement-button-down-skin0000" x="316" y="388" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-decrement-button-icon0000" x="250" y="329" width="6" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-decrement-button-up-skin0000" x="366" y="388" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-increment-button-disabled-icon0000" x="250" y="320" width="6" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-increment-button-disabled-skin0000" x="205" y="395" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-increment-button-down-skin0000" x="66" y="393" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-increment-button-icon0000" x="128" y="333" width="6" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-increment-button-up-skin0000" x="41" y="391" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-simple-scroll-bar-thumb-skin0000" x="87" y="312" width="52" height="20" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-drill-down-accessory-icon0000" x="167" y="330" width="12" height="17" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-drill-down-accessory-selected-icon0000" x="167" y="312" width="12" height="17" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-hover-skin0000" x="460" y="346" width="6" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-selected-up-skin0000" x="501" y="354" width="6" height="48" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-up-skin0000" x="208" y="351" width="6" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="list-background-skin0000" x="108" y="360" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="mute-toggle-button-loud-down-icon0000" x="424" y="304" width="47" height="41" pivotX="0" pivotY="0"/>
	<SubTexture name="mute-toggle-button-loud-up-icon0000" x="1" y="312" width="47" height="41" pivotX="0" pivotY="0"/>
	<SubTexture name="mute-toggle-button-muted-down-icon0000" x="181" y="267" width="47" height="41" pivotX="0" pivotY="0"/>
	<SubTexture name="mute-toggle-button-muted-up-icon0000" x="181" y="309" width="47" height="41" pivotX="0" pivotY="0"/>
	<SubTexture name="overlay-play-pause-toggle-button-play-down-icon0000" x="262" y="1" width="161" height="176" pivotX="0" pivotY="0"/>
	<SubTexture name="overlay-play-pause-toggle-button-play-up-icon0000" x="262" y="178" width="161" height="176" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-disabled-symbol0000" x="445" y="422" width="20" height="20" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-selected-disabled-symbol0000" x="1" y="422" width="20" height="20" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-selected-symbol0000" x="466" y="422" width="20" height="20" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-symbol0000" x="205" y="420" width="20" height="20" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-disabled-icon0000" x="91" y="393" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-icon0000" x="91" y="410" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-selected-icon0000" x="485" y="43" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="play-pause-toggle-button-pause-down-icon0000" x="46" y="267" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="play-pause-toggle-button-pause-up-icon0000" x="91" y="267" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="play-pause-toggle-button-play-down-icon0000" x="1" y="267" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="play-pause-toggle-button-play-up-icon0000" x="136" y="267" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="pop-up-volume-slider-track-skin0000" x="424" y="1" width="60" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="quiet-button-hover-skin0000" x="430" y="387" width="14" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-disabled-icon0000" x="250" y="355" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-down-icon0000" x="128" y="353" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-up-icon0000" x="283" y="355" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="search-disabled-icon0000" x="487" y="422" width="20" height="20" pivotX="0" pivotY="0"/>
	<SubTexture name="search-icon0000" x="391" y="411" width="20" height="20" pivotX="0" pivotY="0"/>
	<SubTexture name="seek-slider-progress-skin0000" x="108" y="427" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-disabled-skin0000" x="1" y="381" width="24" height="40" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-down-skin0000" x="451" y="381" width="24" height="40" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-selected-disabled-skin0000" x="108" y="386" width="24" height="40" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-selected-up-skin0000" x="161" y="378" width="24" height="41" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-up-skin0000" x="476" y="381" width="24" height="40" pivotX="0" pivotY="0"/>
	<SubTexture name="toggle-button-selected-disabled-skin0000" x="133" y="386" width="18" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="toggle-button-selected-up-skin0000" x="186" y="378" width="18" height="45" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-closed-icon0000" x="22" y="427" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-closed-selected-icon0000" x="91" y="427" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-open-icon0000" x="125" y="431" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-open-selected-icon0000" x="177" y="424" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-decrement-button-disabled-icon0000" x="250" y="345" width="8" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-decrement-button-disabled-skin0000" x="316" y="413" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-decrement-button-down-skin0000" x="341" y="413" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-decrement-button-icon0000" x="128" y="342" width="8" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-decrement-button-up-skin0000" x="366" y="413" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-increment-button-disabled-icon0000" x="250" y="338" width="8" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-increment-button-disabled-skin0000" x="66" y="418" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-increment-button-down-skin0000" x="152" y="420" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-increment-button-icon0000" x="451" y="346" width="8" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-increment-button-up-skin0000" x="41" y="416" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-simple-scroll-bar-thumb-skin0000" x="229" y="309" width="20" height="52" pivotX="0" pivotY="0"/>
	<SubTexture name="volume-slider-maximum-track-skin0000" x="424" y="93" width="80" height="30" pivotX="0" pivotY="0"/>
	<SubTexture name="volume-slider-minimum-track-skin0000" x="424" y="62" width="80" height="30" pivotX="0" pivotY="0"/>
</TextureAtlas>


================================================
FILE: themes/MetalWorksDesktopTheme/package-src.json
================================================
{
	"id": "feathersui_MetalWorksDesktopTheme-source",
	"name": "Feathers UI Metal Works Desktop Theme",
	"url": "https://feathersui.com/as3-starling/",
	"docUrl": "https://feathersui/api-reference/",
	"description": "Metal Works desktop theme for Feathers UI (Starling version)",
	"type": "src",
	"version": "4.2.0",
	"sourceUrl": "https://github.com/feathersui/feathersui-starling/releases/download/v4.2.0/feathersui_MetalWorksDesktopTheme-source_4.2.0.airpackage",
	"publishedAt": "2021-11-19T00:00:00.000Z",
	"dependencies": [
		"starling-source:2.x.x",
		"feathersui-source:4.2.x"
	],
	"parameters": [],
	"tags": ["theme", "feathers", "starling"],
	"status": "release",
	"license": {
	  "type": "Simplified BSD",
	  "url": "https://github.com/feathersui/feathersui-starling/blob/v4.2.0/LICENSE.md",
	  "public": true
	}
  }
  

================================================
FILE: themes/MetalWorksDesktopTheme/package-swc.json
================================================
{
	"id": "feathersui_MetalWorksDesktopTheme",
	"name": "Feathers UI Metal Works Desktop Theme",
	"url": "https://feathersui.com/as3-starling/",
	"docUrl": "https://feathersui/api-reference/",
	"description": "Metal Works desktop theme for Feathers UI (Starling version)",
	"type": "swc",
	"version": "4.2.0",
	"sourceUrl": "https://github.com/feathersui/feathersui-starling/releases/download/v4.2.0/feathersui_MetalWorksDesktopTheme_4.2.0.airpackage",
	"publishedAt": "2021-11-19T00:00:00.000Z",
	"dependencies": [
		"starling:2.x.x",
		"feathersui:4.2.x"
	],
	"parameters": [],
	"tags": ["theme", "feathers", "starling"],
	"status": "release",
	"license": {
	  "type": "Simplified BSD",
	  "url": "https://github.com/feathersui/feathersui-starling/blob/v4.2.0/LICENSE.md",
	  "public": true
	}
  }
  

================================================
FILE: themes/MetalWorksDesktopTheme/source/feathers/themes/BaseMetalWorksDesktopTheme.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import feathers.controls.Alert;
	import feathers.controls.AutoComplete;
	import feathers.controls.AutoSizeMode;
	import feathers.controls.Button;
	import feathers.controls.ButtonGroup;
	import feathers.controls.ButtonState;
	import feathers.controls.Callout;
	import feathers.controls.Check;
	import feathers.controls.DataGrid;
	import feathers.controls.DateTimeSpinner;
	import feathers.controls.Drawers;
	import feathers.controls.GroupedList;
	import feathers.controls.Header;
	import feathers.controls.ImageLoader;
	import feathers.controls.Label;
	import feathers.controls.LayoutGroup;
	import feathers.controls.List;
	import feathers.controls.NumericStepper;
	import feathers.controls.PageIndicator;
	import feathers.controls.PageIndicatorInteractionMode;
	import feathers.controls.Panel;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.controls.ProgressBar;
	import feathers.controls.Radio;
	import feathers.controls.ScrollBar;
	import feathers.controls.ScrollBarDisplayMode;
	import feathers.controls.ScrollContainer;
	import feathers.controls.ScrollInteractionMode;
	import feathers.controls.ScrollPolicy;
	import feathers.controls.ScrollScreen;
	import feathers.controls.ScrollText;
	import feathers.controls.Scroller;
	import feathers.controls.SimpleScrollBar;
	import feathers.controls.Slider;
	import feathers.controls.SpinnerList;
	import feathers.controls.StepperButtonLayoutMode;
	import feathers.controls.TabBar;
	import feathers.controls.TextArea;
	import feathers.controls.TextCallout;
	import feathers.controls.TextInput;
	import feathers.controls.TextInputState;
	import feathers.controls.Toast;
	import feathers.controls.ToggleButton;
	import feathers.controls.ToggleSwitch;
	import feathers.controls.TrackLayoutMode;
	import feathers.controls.Tree;
	import feathers.controls.popups.DropDownPopUpContentManager;
	import feathers.controls.renderers.BaseDefaultItemRenderer;
	import feathers.controls.renderers.DefaultDataGridCellRenderer;
	import feathers.controls.renderers.DefaultDataGridHeaderRenderer;
	import feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer;
	import feathers.controls.renderers.DefaultGroupedListItemRenderer;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.DefaultTreeItemRenderer;
	import feathers.controls.text.TextBlockTextEditor;
	import feathers.controls.text.TextBlockTextRenderer;
	import feathers.controls.text.TextFieldTextEditorViewPort;
	import feathers.core.FeathersControl;
	import feathers.core.FocusManager;
	import feathers.core.PopUpManager;
	import feathers.core.ToolTipManager;
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.RelativePosition;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.media.FullScreenToggleButton;
	import feathers.media.MuteToggleButton;
	import feathers.media.PlayPauseToggleButton;
	import feathers.media.SeekSlider;
	import feathers.media.VideoPlayer;
	import feathers.media.VolumeSlider;
	import feathers.skins.ImageSkin;

	import flash.geom.Rectangle;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Image;
	import starling.display.Quad;
	import starling.display.Stage;
	import starling.text.TextFormat;
	import starling.textures.Texture;
	import starling.textures.TextureAtlas;

	/**
	 * The base class for the "Metal Works" theme for desktop Feathers apps.
	 * Handles everything except asset loading, which is left to subclasses.
	 *
	 * @see MetalWorksDesktopTheme
	 * @see MetalWorksDesktopThemeWithAssetManager
	 */
	public class BaseMetalWorksDesktopTheme extends StyleNameFunctionTheme
	{
		[Embed(source="/../assets/fonts/SourceSansPro-Regular.ttf",fontFamily="SourceSansPro",fontWeight="normal",mimeType="application/x-font",embedAsCFF="true")]
		protected static const SOURCE_SANS_PRO_REGULAR:Class;

		[Embed(source="/../assets/fonts/SourceSansPro-Semibold.ttf",fontFamily="SourceSansPro",fontWeight="bold",mimeType="application/x-font",embedAsCFF="true")]
		protected static const SOURCE_SANS_PRO_SEMIBOLD:Class;

		/**
		 * The name of the embedded font used by controls in this theme. Comes
		 * in normal and bold weights.
		 */
		public static const FONT_NAME:String = "SourceSansPro";

		/**
		 * The stack of fonts to use for controls that don't use embedded fonts.
		 */
		public static const FONT_NAME_STACK:String = "Source Sans Pro,Helvetica,_sans";

		protected static const PRIMARY_BACKGROUND_COLOR:uint = 0x4a4137;
		protected static const LIGHT_TEXT_COLOR:uint = 0xe5e5e5;
		protected static const DARK_TEXT_COLOR:uint = 0x1a1816;
		protected static const SELECTED_TEXT_COLOR:uint = 0xff9900;
		protected static const LIGHT_DISABLED_TEXT_COLOR:uint = 0x8a8a8a;
		protected static const DARK_DISABLED_TEXT_COLOR:uint = 0x383430;
		protected static const GROUPED_LIST_HEADER_BACKGROUND_COLOR:uint = 0x292523;
		protected static const GROUPED_LIST_FOOTER_BACKGROUND_COLOR:uint = 0x292523;
		protected static const SCROLL_BAR_TRACK_COLOR:uint = 0x1a1816;
		protected static const SCROLL_BAR_TRACK_DOWN_COLOR:uint = 0xff7700;
		protected static const TEXT_SELECTION_BACKGROUND_COLOR:uint = 0x574f46;
		protected static const MODAL_OVERLAY_COLOR:uint = 0x29241e;
		protected static const MODAL_OVERLAY_ALPHA:Number = 0.8;
		protected static const DRAWER_OVERLAY_COLOR:uint = 0x29241e;
		protected static const DRAWER_OVERLAY_ALPHA:Number = 0.4;
		protected static const VIDEO_OVERLAY_COLOR:uint = 0x1a1816;
		protected static const VIDEO_OVERLAY_ALPHA:Number = 0.2;
		protected static const DATA_GRID_COLUMN_OVERLAY_COLOR:uint = 0x383430;
		protected static const DATA_GRID_COLUMN_OVERLAY_ALPHA:Number = 0.4;

		protected static const DEFAULT_SCALE9_GRID:Rectangle = new Rectangle(3, 3, 1, 1);
		protected static const SIMPLE_SCALE9_GRID:Rectangle = new Rectangle(2, 2, 1, 1);
		protected static const BUTTON_SCALE9_GRID:Rectangle = new Rectangle(3, 3, 1, 16);
		protected static const TOGGLE_BUTTON_SCALE9_GRID:Rectangle = new Rectangle(4, 4, 1, 14);
		protected static const SCROLL_BAR_STEP_BUTTON_SCALE9_GRID:Rectangle = new Rectangle(3, 3, 6, 6);
		protected static const VOLUME_SLIDER_TRACK_SCALE9_GRID:Rectangle = new Rectangle(12, 12, 1, 1);
		protected static const BACK_BUTTON_SCALE9_GRID:Rectangle = new Rectangle(13, 0, 1, 22);
		protected static const FORWARD_BUTTON_SCALE9_GRID:Rectangle = new Rectangle(3, 0, 1, 22);
		protected static const FOCUS_INDICATOR_SCALE_9_GRID:Rectangle = new Rectangle(5, 5, 1, 1);
		protected static const TAB_SCALE9_GRID:Rectangle = new Rectangle(7, 7, 1, 11);
		protected static const HORIZONTAL_SCROLL_BAR_THUMB_SCALE_9_GRID:Rectangle = new Rectangle(5, 0, 14, 10);
		protected static const VERTICAL_SCROLL_BAR_THUMB_SCALE_9_GRID:Rectangle = new Rectangle(0, 5, 10, 14);
		protected static const DATA_GRID_HEADER_DIVIDER_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 2, 4);
		protected static const DATA_GRID_VERTICAL_DIVIDER_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 1, 4);
		protected static const DATA_GRID_COLUMN_RESIZE_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 3, 28);
		protected static const DATA_GRID_COLUMN_DROP_INDICATOR_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 3, 3);
		
		protected static const ITEM_RENDERER_SKIN_TEXTURE_REGION:Rectangle = new Rectangle(1, 1, 1, 1);
		protected static const ITEM_RENDERER_SELECTED_SKIN_TEXTURE_REGION:Rectangle = new Rectangle(1, 1, 1, 22);
		protected static const HEADER_SKIN_TEXTURE_REGION:Rectangle = new Rectangle(1, 1, 128, 64);

		/**
		 * @private
		 * The theme's custom style name for the increment button of a horizontal ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_INCREMENT_BUTTON:String = "metalworks-desktop-horizontal-scroll-bar-increment-button";

		/**
		 * @private
		 * The theme's custom style name for the decrement button of a horizontal ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_DECREMENT_BUTTON:String = "metalworks-desktop-horizontal-scroll-bar-decrement-button";

		/**
		 * @private
		 * The theme's custom style name for the thumb of a horizontal ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_THUMB:String = "metalworks-desktop-horizontal-scroll-bar-thumb";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a horizontal ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_MINIMUM_TRACK:String = "metalworks-desktop-horizontal-scroll-bar-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the maximum track of a horizontal ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_MAXIMUM_TRACK:String = "metalworks-desktop-horizontal-scroll-bar-maximum-track";

		/**
		 * @private
		 * The theme's custom style name for the increment button of a vertical ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_INCREMENT_BUTTON:String = "metalworks-desktop-vertical-scroll-bar-increment-button";

		/**
		 * @private
		 * The theme's custom style name for the decrement button of a vertical ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_DECREMENT_BUTTON:String = "metalworks-desktop-vertical-scroll-bar-decrement-button";

		/**
		 * @private
		 * The theme's custom style name for the thumb of a vertical ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_THUMB:String = "metalworks-desktop-vertical-scroll-bar-thumb";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a vertical ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_MINIMUM_TRACK:String = "metalworks-desktop-vertical-scroll-bar-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the maximum track of a vertical ScrollBar.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_MAXIMUM_TRACK:String = "metalworks-desktop-vertical-scroll-bar-maximum-track";

		/**
		 * @private
		 * The theme's custom style name for the thumb of a horizontal SimpleScrollBar.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SIMPLE_SCROLL_BAR_THUMB:String = "metalworks-desktop-horizontal-simple-scroll-bar-thumb";

		/**
		 * @private
		 * The theme's custom style name for the thumb of a vertical SimpleScrollBar.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SIMPLE_SCROLL_BAR_THUMB:String = "metalworks-desktop-vertical-simple-scroll-bar-thumb";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a horizontal slider.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK:String = "metalworks-desktop-horizontal-slider-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the maximum track of a horizontal slider.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SLIDER_MAXIMUM_TRACK:String = "metalworks-desktop-horizontal-slider-maximum-track";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a vertical slider.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK:String = "metalworks-desktop-vertical-slider-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the maximum track of a vertical slider.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SLIDER_MAXIMUM_TRACK:String = "metalworks-desktop-vertical-slider-maximum-track";

		/**
		 * @private
		 */
		protected static const THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_THUMB:String = "metalworks-desktop-pop-up-volume-slider-thumb";

		/**
		 * @private
		 */
		protected static const THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_MINIMUM_TRACK:String = "metalworks-desktop-pop-up-volume-slider-minimum-track";

		/**
		 * @private
		 */
		protected static const THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER:String = "metalworks-desktop-date-time-spinner-list-item-renderer";

		/**
		 * @private
		 */
		protected static const THEME_STYLE_NAME_ALERT_BUTTON_GROUP_BUTTON:String = "metalworks-desktop-alert-button-group-button";

		/**
		 * @private
		 * The theme's custom style name for the action buttons of a toast.
		 */
		protected static const THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON:String = "metal-works-mobile-toast-actions-button";

		/**
		 * The default global text renderer factory for this theme creates a
		 * TextBlockTextRenderer.
		 */
		protected static function textRendererFactory():TextBlockTextRenderer
		{
			return new TextBlockTextRenderer();
		}

		/**
		 * The default global text editor factory for this theme creates a
		 * TextBlockTextEditor.
		 */
		protected static function textEditorFactory():TextBlockTextEditor
		{
			return new TextBlockTextEditor();
		}

		/**
		 * This theme's scroll bar type is ScrollBar.
		 */
		protected static function scrollBarFactory():ScrollBar
		{
			return new ScrollBar();
		}

		protected static function popUpOverlayFactory():DisplayObject
		{
			var quad:Quad = new Quad(100, 100, MODAL_OVERLAY_COLOR);
			quad.alpha = MODAL_OVERLAY_ALPHA;
			return quad;
		}

		protected static function pickerListButtonFactory():ToggleButton
		{
			return new ToggleButton();
		}

		/**
		 * Constructor.
		 */
		public function BaseMetalWorksDesktopTheme()
		{
			super();
		}

		/**
		 * A smaller font size for details.
		 */
		protected var smallFontSize:int = 11;

		/**
		 * A normal font size.
		 */
		protected var regularFontSize:int = 14;

		/**
		 * A larger font size for headers.
		 */
		protected var largeFontSize:int = 18;

		/**
		 * The size, in pixels, of major regions in the grid. Used for sizing
		 * containers and larger UI controls.
		 */
		protected var gridSize:int = 32;

		/**
		 * The size, in pixels, of minor regions in the grid. Used for larger
		 * padding and gaps.
		 */
		protected var gutterSize:int = 8;

		/**
		 * The size, in pixels, of smaller padding and gaps within the major
		 * regions in the grid.
		 */
		protected var smallGutterSize:int = 4;

		/**
		 * The size, in pixels, of very smaller padding and gaps.
		 */
		protected var extraSmallGutterSize:int = 2;

		/**
		 * The minimum width, in pixels, of some types of buttons.
		 */
		protected var buttonMinWidth:int = 68;

		/**
		 * The width, in pixels, of UI controls that span across multiple grid regions.
		 */
		protected var wideControlSize:int = 144;

		/**
		 * The width, in pixels, of very large UI controls.
		 */
		protected var extraWideControlSize:int = 210;

		/**
		 * The size, in pixels, of a typical UI control.
		 */
		protected var controlSize:int = 26;

		/**
		 * The size, in pixels, of smaller UI controls.
		 */
		protected var smallControlSize:int = 12;

		/**
		 * The size, in pixels, of a border around any control.
		 */
		protected var borderSize:int = 1;

		/**
		 * The size, in pixels, of the focus indicator skin's padding.
		 */
		protected var focusPaddingSize:int = -2;

		protected var calloutArrowOverlapGap:int = -2;
		protected var calloutBackgroundMinSize:int = 5;
		protected var progressBarFillMinSize:int = 7;
		protected var scrollBarGutterSize:int = 4;
		protected var popUpSize:int = 336;
		protected var popUpVolumeSliderPaddingSize:int = 10;

		/**
		 * The font styles for standard-sized, light text.
		 */
		protected var lightFontStyles:TextFormat;

		/**
		 * The font styles for standard-sized, dark text.
		 */
		protected var darkFontStyles:TextFormat;

		/**
		 * The font styles for standard-sized, selected text.
		 */
		protected var selectedFontStyles:TextFormat;

		/**
		 * The font styles for standard-sized, light, disabled text.
		 */
		protected var lightDisabledFontStyles:TextFormat;

		/**
		 * The font styles for light UI text.
		 */
		protected var lightUIFontStyles:TextFormat;

		/**
		 * The font styles for dark UI text.
		 */
		protected var darkUIFontStyles:TextFormat;

		/**
		 * The font styles for selected UI text.
		 */
		protected var selectedUIFontStyles:TextFormat;

		/**
		 * The font styles for light disabled UI text.
		 */
		protected var lightDisabledUIFontStyles:TextFormat;

		/**
		 * The font styles for light, centered UI text.
		 */
		protected var lightCenteredUIFontStyles:TextFormat;

		/**
		 * The font styles for light, centered, disabled UI text.
		 */
		protected var lightCenteredDisabledUIFontStyles:TextFormat;

		/**
		 * The font styles for small, light text.
		 */
		protected var smallLightFontStyles:TextFormat;

		/**
		 * The font styles for small, light, disabled text.
		 */
		protected var smallLightDisabledFontStyles:TextFormat;

		/**
		 * The font styles for large, light text.
		 */
		protected var largeLightFontStyles:TextFormat;

		/**
		 * The font styles for large, dark text.
		 */
		protected var largeDarkFontStyles:TextFormat;

		/**
		 * The font styles for large, light, disabled text.
		 */
		protected var largeLightDisabledFontStyles:TextFormat;

		/**
		 * The font styles for dark, disabled UI text.
		 */
		protected var darkDisabledUIFontStyles:TextFormat;

		/**
		 * ScrollText uses TextField instead of FTE, so it has a separate TextFormat.
		 */
		protected var lightScrollTextFontStyles:TextFormat;

		/**
		 * ScrollText uses TextField instead of FTE, so it has a separate disabled TextFormat.
		 */
		protected var lightDisabledScrollTextFontStyles:TextFormat;

		/**
		 * The texture atlas that contains skins for this theme. This base class
		 * does not initialize this member variable. Subclasses are expected to
		 * load the assets somehow and set the <code>atlas</code> member
		 * variable before calling <code>initialize()</code>.
		 */
		protected var atlas:TextureAtlas;

		protected var focusIndicatorSkinTexture:Texture;
		protected var headerBackgroundSkinTexture:Texture;
		protected var headerPopupBackgroundSkinTexture:Texture;
		protected var backgroundSkinTexture:Texture;
		protected var backgroundDisabledSkinTexture:Texture;
		protected var backgroundFocusedSkinTexture:Texture;
		protected var backgroundDangerSkinTexture:Texture;
		protected var listBackgroundSkinTexture:Texture;
		protected var buttonUpSkinTexture:Texture;
		protected var buttonDownSkinTexture:Texture;
		protected var buttonDisabledSkinTexture:Texture;
		protected var toggleButtonSelectedUpSkinTexture:Texture;
		protected var toggleButtonSelectedDisabledSkinTexture:Texture;
		protected var buttonQuietHoverSkinTexture:Texture;
		protected var buttonCallToActionUpSkinTexture:Texture;
		protected var buttonCallToActionDownSkinTexture:Texture;
		protected var buttonDangerUpSkinTexture:Texture;
		protected var buttonDangerDownSkinTexture:Texture;
		protected var buttonBackUpSkinTexture:Texture;
		protected var buttonBackDownSkinTexture:Texture;
		protected var buttonBackDisabledSkinTexture:Texture;
		protected var buttonForwardUpSkinTexture:Texture;
		protected var buttonForwardDownSkinTexture:Texture;
		protected var buttonForwardDisabledSkinTexture:Texture;
		protected var pickerListButtonIconTexture:Texture;
		protected var pickerListButtonIconSelectedTexture:Texture;
		protected var pickerListButtonIconDisabledTexture:Texture;
		protected var tabUpSkinTexture:Texture;
		protected var tabDownSkinTexture:Texture;
		protected var tabDisabledSkinTexture:Texture;
		protected var tabSelectedSkinTexture:Texture;
		protected var tabSelectedDisabledSkinTexture:Texture;
		protected var radioUpIconTexture:Texture;
		protected var radioDownIconTexture:Texture;
		protected var radioDisabledIconTexture:Texture;
		protected var radioSelectedUpIconTexture:Texture;
		protected var radioSelectedDownIconTexture:Texture;
		protected var radioSelectedDisabledIconTexture:Texture;
		protected var checkUpIconTexture:Texture;
		protected var checkDownIconTexture:Texture;
		protected var checkDisabledIconTexture:Texture;
		protected var checkSelectedUpIconTexture:Texture;
		protected var checkSelectedDownIconTexture:Texture;
		protected var checkSelectedDisabledIconTexture:Texture;
		protected var pageIndicatorNormalSkinTexture:Texture;
		protected var pageIndicatorSelectedSkinTexture:Texture;
		protected var itemRendererUpSkinTexture:Texture;
		protected var itemRendererHoverSkinTexture:Texture;
		protected var itemRendererSelectedUpSkinTexture:Texture;
		protected var backgroundPopUpSkinTexture:Texture;
		protected var backgroundDangerPopUpSkinTexture:Texture;
		protected var calloutTopArrowSkinTexture:Texture;
		protected var calloutRightArrowSkinTexture:Texture;
		protected var calloutBottomArrowSkinTexture:Texture;
		protected var calloutLeftArrowSkinTexture:Texture;
		protected var dangerCalloutTopArrowSkinTexture:Texture;
		protected var dangerCalloutRightArrowSkinTexture:Texture;
		protected var dangerCalloutBottomArrowSkinTexture:Texture;
		protected var dangerCalloutLeftArrowSkinTexture:Texture;
		protected var horizontalSimpleScrollBarThumbSkinTexture:Texture;
		protected var horizontalScrollBarDecrementButtonIconTexture:Texture;
		protected var horizontalScrollBarDecrementButtonDisabledIconTexture:Texture;
		protected var horizontalScrollBarDecrementButtonUpSkinTexture:Texture;
		protected var horizontalScrollBarDecrementButtonDownSkinTexture:Texture;
		protected var horizontalScrollBarDecrementButtonDisabledSkinTexture:Texture;
		protected var horizontalScrollBarIncrementButtonIconTexture:Texture;
		protected var horizontalScrollBarIncrementButtonDisabledIconTexture:Texture;
		protected var horizontalScrollBarIncrementButtonUpSkinTexture:Texture;
		protected var horizontalScrollBarIncrementButtonDownSkinTexture:Texture;
		protected var horizontalScrollBarIncrementButtonDisabledSkinTexture:Texture;
		protected var verticalSimpleScrollBarThumbSkinTexture:Texture;
		protected var verticalScrollBarDecrementButtonIconTexture:Texture;
		protected var verticalScrollBarDecrementButtonDisabledIconTexture:Texture;
		protected var verticalScrollBarDecrementButtonUpSkinTexture:Texture;
		protected var verticalScrollBarDecrementButtonDownSkinTexture:Texture;
		protected var verticalScrollBarDecrementButtonDisabledSkinTexture:Texture;
		protected var verticalScrollBarIncrementButtonIconTexture:Texture;
		protected var verticalScrollBarIncrementButtonDisabledIconTexture:Texture;
		protected var verticalScrollBarIncrementButtonUpSkinTexture:Texture;
		protected var verticalScrollBarIncrementButtonDownSkinTexture:Texture;
		protected var verticalScrollBarIncrementButtonDisabledSkinTexture:Texture;
		protected var searchIconTexture:Texture;
		protected var searchIconDisabledTexture:Texture;
		protected var listDrillDownAccessoryTexture:Texture;
		protected var listDrillDownAccessorySelectedTexture:Texture;
		protected var treeDisclosureOpenIconTexture:Texture;
		protected var treeDisclosureOpenSelectedIconTexture:Texture;
		protected var treeDisclosureClosedIconTexture:Texture;
		protected var treeDisclosureClosedSelectedIconTexture:Texture;
		protected var dataGridHeaderSortAscendingIconTexture:Texture;
		protected var dataGridHeaderSortDescendingIconTexture:Texture;
		protected var dataGridHeaderDividerSkinTexture:Texture;
		protected var dataGridVerticalDividerSkinTexture:Texture;
		protected var dataGridColumnResizeSkinTexture:Texture;
		protected var dataGridColumnDropIndicatorSkinTexture:Texture;

		//media textures
		protected var playPauseButtonPlayUpIconTexture:Texture;
		protected var playPauseButtonPlayDownIconTexture:Texture;
		protected var playPauseButtonPauseUpIconTexture:Texture;
		protected var playPauseButtonPauseDownIconTexture:Texture;
		protected var overlayPlayPauseButtonPlayUpIconTexture:Texture;
		protected var overlayPlayPauseButtonPlayDownIconTexture:Texture;
		protected var fullScreenToggleButtonEnterUpIconTexture:Texture;
		protected var fullScreenToggleButtonEnterDownIconTexture:Texture;
		protected var fullScreenToggleButtonExitUpIconTexture:Texture;
		protected var fullScreenToggleButtonExitDownIconTexture:Texture;
		protected var muteToggleButtonLoudUpIconTexture:Texture;
		protected var muteToggleButtonLoudDownIconTexture:Texture;
		protected var muteToggleButtonMutedUpIconTexture:Texture;
		protected var muteToggleButtonMutedDownIconTexture:Texture;
		protected var volumeSliderMinimumTrackSkinTexture:Texture;
		protected var volumeSliderMaximumTrackSkinTexture:Texture;
		protected var popUpVolumeSliderTrackSkinTexture:Texture;
		protected var seekSliderProgressSkinTexture:Texture;

		/**
		 * Disposes the texture atlas before calling super.dispose()
		 */
		override public function dispose():void
		{
			if(this.atlas)
			{
				//if anything is keeping a reference to the texture, we don't
				//want it to keep a reference to the theme too.
				this.atlas.texture.root.onRestore = null;
				
				this.atlas.dispose();
				this.atlas = null;
			}

			var stage:Stage = this.starling.stage;
			FocusManager.setEnabledForStage(stage, false);
			ToolTipManager.setEnabledForStage(stage, false);

			//don't forget to call super.dispose()!
			super.dispose();
		}

		/**
		 * Initializes the theme. Expected to be called by subclasses after the
		 * assets have been loaded and the skin texture atlas has been created.
		 */
		protected function initialize():void
		{
			this.initializeFonts();
			this.initializeTextures();
			this.initializeGlobals();
			this.initializeStage();
			this.initializeStyleProviders();
		}

		/**
		 * Sets the stage background color.
		 */
		protected function initializeStage():void
		{
			this.starling.stage.color = PRIMARY_BACKGROUND_COLOR;
			this.starling.nativeStage.color = PRIMARY_BACKGROUND_COLOR;
		}

		/**
		 * Initializes global variables (not including global style providers).
		 */
		protected function initializeGlobals():void
		{
			FeathersControl.defaultTextRendererFactory = textRendererFactory;
			FeathersControl.defaultTextEditorFactory = textEditorFactory;

			PopUpManager.overlayFactory = popUpOverlayFactory;
			Callout.stagePadding = this.smallGutterSize;
			Toast.containerFactory = toastContainerFactory;

			var stage:Stage = this.starling.stage;
			FocusManager.setEnabledForStage(stage, true);
			ToolTipManager.setEnabledForStage(stage, true);
		}

		/**
		 * Initializes font sizes and formats.
		 */
		protected function initializeFonts():void
		{
			this.lightFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.darkFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, DARK_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.selectedFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, SELECTED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.lightDisabledFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, LIGHT_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);

			this.smallLightFontStyles = new TextFormat(FONT_NAME, this.smallFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.smallLightDisabledFontStyles = new TextFormat(FONT_NAME, this.smallFontSize, LIGHT_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);

			this.largeLightFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.largeDarkFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, DARK_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.largeLightDisabledFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, LIGHT_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);

			this.lightUIFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.lightUIFontStyles.bold = true;
			this.darkUIFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, DARK_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.darkUIFontStyles.bold = true;
			this.selectedUIFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, SELECTED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.selectedUIFontStyles.bold = true;
			this.lightDisabledUIFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, LIGHT_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.lightDisabledUIFontStyles.bold = true;
			this.darkDisabledUIFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, DARK_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.darkDisabledUIFontStyles.bold = true;
			this.lightCenteredUIFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.CENTER, VerticalAlign.TOP);
			this.lightCenteredUIFontStyles.bold = true;
			this.lightCenteredDisabledUIFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, LIGHT_DISABLED_TEXT_COLOR, HorizontalAlign.CENTER, VerticalAlign.TOP);
			this.lightCenteredDisabledUIFontStyles.bold = true;

			this.lightScrollTextFontStyles = new TextFormat(FONT_NAME_STACK, this.regularFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.lightDisabledScrollTextFontStyles = new TextFormat(FONT_NAME_STACK, this.regularFontSize, LIGHT_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
		}

		/**
		 * Initializes the textures by extracting them from the atlas and
		 * setting up any scaling grids that are needed.
		 */
		protected function initializeTextures():void
		{
			var checkUpIconTexture:Texture = this.atlas.getTexture("check-up-icon0000");
			var checkDownIconTexture:Texture = this.atlas.getTexture("check-down-icon0000");
			var checkDisabledIconTexture:Texture = this.atlas.getTexture("check-disabled-icon0000");

			this.focusIndicatorSkinTexture = this.atlas.getTexture("focus-indicator-skin0000");

			this.backgroundSkinTexture = this.atlas.getTexture("background-skin0000");
			this.backgroundDisabledSkinTexture = this.atlas.getTexture("background-disabled-skin0000");
			this.backgroundFocusedSkinTexture = this.atlas.getTexture("background-focused-skin0000");
			this.backgroundDangerSkinTexture = this.atlas.getTexture("background-danger-skin0000");
			this.backgroundPopUpSkinTexture = this.atlas.getTexture("background-popup-skin0000");
			this.backgroundDangerPopUpSkinTexture = this.atlas.getTexture("background-danger-popup-skin0000");
			this.listBackgroundSkinTexture = this.atlas.getTexture("list-background-skin0000");

			this.buttonUpSkinTexture = this.atlas.getTexture("button-up-skin0000");
			this.buttonDownSkinTexture = this.atlas.getTexture("button-down-skin0000");
			this.buttonDisabledSkinTexture = this.atlas.getTexture("button-disabled-skin0000");
			this.toggleButtonSelectedUpSkinTexture = this.atlas.getTexture("toggle-button-selected-up-skin0000");
			this.toggleButtonSelectedDisabledSkinTexture = this.atlas.getTexture("toggle-button-selected-disabled-skin0000");
			this.buttonQuietHoverSkinTexture = this.atlas.getTexture("quiet-button-hover-skin0000");
			this.buttonCallToActionUpSkinTexture = this.atlas.getTexture("call-to-action-button-up-skin0000");
			this.buttonCallToActionDownSkinTexture = this.atlas.getTexture("call-to-action-button-down-skin0000");
			this.buttonDangerUpSkinTexture = this.atlas.getTexture("danger-button-up-skin0000");
			this.buttonDangerDownSkinTexture = this.atlas.getTexture("danger-button-down-skin0000");
			this.buttonBackUpSkinTexture = this.atlas.getTexture("back-button-up-skin0000");
			this.buttonBackDownSkinTexture = this.atlas.getTexture("back-button-down-skin0000");
			this.buttonBackDisabledSkinTexture = this.atlas.getTexture("back-button-disabled-skin0000");
			this.buttonForwardUpSkinTexture = this.atlas.getTexture("forward-button-up-skin0000");
			this.buttonForwardDownSkinTexture = this.atlas.getTexture("forward-button-down-skin0000");
			this.buttonForwardDisabledSkinTexture = this.atlas.getTexture("forward-button-disabled-skin0000");

			this.tabUpSkinTexture = this.atlas.getTexture("tab-up-skin0000");
			this.tabDownSkinTexture = this.atlas.getTexture("tab-down-skin0000");
			this.tabDisabledSkinTexture = this.atlas.getTexture("tab-disabled-skin0000");
			this.tabSelectedSkinTexture = this.atlas.getTexture("tab-selected-up-skin0000");
			this.tabSelectedDisabledSkinTexture = this.atlas.getTexture("tab-selected-disabled-skin0000");

			this.pickerListButtonIconTexture = this.atlas.getTexture("picker-list-icon0000");
			this.pickerListButtonIconSelectedTexture = this.atlas.getTexture("picker-list-selected-icon0000");
			this.pickerListButtonIconDisabledTexture = this.atlas.getTexture("picker-list-disabled-icon0000");

			this.radioUpIconTexture = checkUpIconTexture;
			this.radioDownIconTexture = checkDownIconTexture;
			this.radioDisabledIconTexture = checkDisabledIconTexture;
			this.radioSelectedUpIconTexture = this.atlas.getTexture("radio-selected-up-icon0000");
			this.radioSelectedDownIconTexture = this.atlas.getTexture("radio-selected-down-icon0000");
			this.radioSelectedDisabledIconTexture = this.atlas.getTexture("radio-selected-disabled-icon0000");

			this.checkUpIconTexture = checkUpIconTexture;
			this.checkDownIconTexture = checkDownIconTexture;
			this.checkDisabledIconTexture = checkDisabledIconTexture;
			this.checkSelectedUpIconTexture = this.atlas.getTexture("check-selected-up-icon0000");
			this.checkSelectedDownIconTexture = this.atlas.getTexture("check-selected-down-icon0000");
			this.checkSelectedDisabledIconTexture = this.atlas.getTexture("check-selected-disabled-icon0000");

			this.pageIndicatorSelectedSkinTexture = this.atlas.getTexture("page-indicator-selected-symbol0000");
			this.pageIndicatorNormalSkinTexture = this.atlas.getTexture("page-indicator-symbol0000");

			this.searchIconTexture = this.atlas.getTexture("search-icon0000");
			this.searchIconDisabledTexture = this.atlas.getTexture("search-disabled-icon0000");

			this.itemRendererUpSkinTexture = Texture.fromTexture(this.atlas.getTexture("item-renderer-up-skin0000"), ITEM_RENDERER_SKIN_TEXTURE_REGION);
			this.itemRendererHoverSkinTexture = Texture.fromTexture(this.atlas.getTexture("item-renderer-hover-skin0000"), ITEM_RENDERER_SKIN_TEXTURE_REGION);
			this.itemRendererSelectedUpSkinTexture = Texture.fromTexture(this.atlas.getTexture("item-renderer-selected-up-skin0000"), ITEM_RENDERER_SELECTED_SKIN_TEXTURE_REGION);

			this.headerBackgroundSkinTexture = this.atlas.getTexture("header-background-skin0000");
			this.headerPopupBackgroundSkinTexture = this.atlas.getTexture("header-popup-background-skin0000");
			this.headerBackgroundSkinTexture = Texture.fromTexture(headerBackgroundSkinTexture, HEADER_SKIN_TEXTURE_REGION);
			this.headerPopupBackgroundSkinTexture = Texture.fromTexture(headerPopupBackgroundSkinTexture, HEADER_SKIN_TEXTURE_REGION);

			this.calloutTopArrowSkinTexture = this.atlas.getTexture("callout-arrow-top-skin0000");
			this.calloutRightArrowSkinTexture = this.atlas.getTexture("callout-arrow-right-skin0000");
			this.calloutBottomArrowSkinTexture = this.atlas.getTexture("callout-arrow-bottom-skin0000");
			this.calloutLeftArrowSkinTexture = this.atlas.getTexture("callout-arrow-left-skin0000");
			this.dangerCalloutTopArrowSkinTexture = this.atlas.getTexture("danger-callout-arrow-top-skin0000");
			this.dangerCalloutRightArrowSkinTexture = this.atlas.getTexture("danger-callout-arrow-right-skin0000");
			this.dangerCalloutBottomArrowSkinTexture = this.atlas.getTexture("danger-callout-arrow-bottom-skin0000");
			this.dangerCalloutLeftArrowSkinTexture = this.atlas.getTexture("danger-callout-arrow-left-skin0000");

			this.horizontalSimpleScrollBarThumbSkinTexture = this.atlas.getTexture("horizontal-simple-scroll-bar-thumb-skin0000");
			this.horizontalScrollBarDecrementButtonIconTexture = this.atlas.getTexture("horizontal-scroll-bar-decrement-button-icon0000");
			this.horizontalScrollBarDecrementButtonDisabledIconTexture = this.atlas.getTexture("horizontal-scroll-bar-decrement-button-disabled-icon0000");
			this.horizontalScrollBarDecrementButtonUpSkinTexture = this.atlas.getTexture("horizontal-scroll-bar-decrement-button-up-skin0000");
			this.horizontalScrollBarDecrementButtonDownSkinTexture = this.atlas.getTexture("horizontal-scroll-bar-decrement-button-down-skin0000");
			this.horizontalScrollBarDecrementButtonDisabledSkinTexture = this.atlas.getTexture("horizontal-scroll-bar-decrement-button-disabled-skin0000");
			this.horizontalScrollBarIncrementButtonIconTexture = this.atlas.getTexture("horizontal-scroll-bar-increment-button-icon0000");
			this.horizontalScrollBarIncrementButtonDisabledIconTexture = this.atlas.getTexture("horizontal-scroll-bar-increment-button-disabled-icon0000");
			this.horizontalScrollBarIncrementButtonUpSkinTexture = this.atlas.getTexture("horizontal-scroll-bar-increment-button-up-skin0000");
			this.horizontalScrollBarIncrementButtonDownSkinTexture = this.atlas.getTexture("horizontal-scroll-bar-increment-button-down-skin0000");
			this.horizontalScrollBarIncrementButtonDisabledSkinTexture = this.atlas.getTexture("horizontal-scroll-bar-increment-button-disabled-skin0000");

			this.verticalSimpleScrollBarThumbSkinTexture = this.atlas.getTexture("vertical-simple-scroll-bar-thumb-skin0000");
			this.verticalScrollBarDecrementButtonIconTexture = this.atlas.getTexture("vertical-scroll-bar-decrement-button-icon0000");
			this.verticalScrollBarDecrementButtonDisabledIconTexture = this.atlas.getTexture("vertical-scroll-bar-decrement-button-disabled-icon0000");
			this.verticalScrollBarDecrementButtonUpSkinTexture = this.atlas.getTexture("vertical-scroll-bar-decrement-button-up-skin0000");
			this.verticalScrollBarDecrementButtonDownSkinTexture = this.atlas.getTexture("vertical-scroll-bar-decrement-button-down-skin0000");
			this.verticalScrollBarDecrementButtonDisabledSkinTexture = this.atlas.getTexture("vertical-scroll-bar-decrement-button-disabled-skin0000");
			this.verticalScrollBarIncrementButtonIconTexture = this.atlas.getTexture("vertical-scroll-bar-increment-button-icon0000");
			this.verticalScrollBarIncrementButtonDisabledIconTexture = this.atlas.getTexture("vertical-scroll-bar-increment-button-disabled-icon0000");
			this.verticalScrollBarIncrementButtonUpSkinTexture = this.atlas.getTexture("vertical-scroll-bar-increment-button-up-skin0000");
			this.verticalScrollBarIncrementButtonDownSkinTexture = this.atlas.getTexture("vertical-scroll-bar-increment-button-down-skin0000");
			this.verticalScrollBarIncrementButtonDisabledSkinTexture = this.atlas.getTexture("vertical-scroll-bar-increment-button-disabled-skin0000");

			this.listDrillDownAccessoryTexture = this.atlas.getTexture("item-renderer-drill-down-accessory-icon0000");
			this.listDrillDownAccessorySelectedTexture = this.atlas.getTexture("item-renderer-drill-down-accessory-selected-icon0000");

			this.treeDisclosureOpenIconTexture = this.atlas.getTexture("tree-disclosure-open-icon0000");
			this.treeDisclosureOpenSelectedIconTexture = this.atlas.getTexture("tree-disclosure-open-selected-icon0000");
			this.treeDisclosureClosedIconTexture = this.atlas.getTexture("tree-disclosure-closed-icon0000");
			this.treeDisclosureClosedSelectedIconTexture = this.atlas.getTexture("tree-disclosure-closed-selected-icon0000");

			this.dataGridHeaderSortAscendingIconTexture = this.atlas.getTexture("data-grid-header-sort-ascending-icon0000");
			this.dataGridHeaderSortDescendingIconTexture = this.atlas.getTexture("data-grid-header-sort-descending-icon0000");
			this.dataGridHeaderDividerSkinTexture = this.atlas.getTexture("data-grid-header-divider-skin0000");
			this.dataGridVerticalDividerSkinTexture = this.atlas.getTexture("data-grid-vertical-divider-skin0000");
			this.dataGridColumnResizeSkinTexture = this.atlas.getTexture("data-grid-column-resize-skin0000");
			this.dataGridColumnDropIndicatorSkinTexture = this.atlas.getTexture("data-grid-column-drop-indicator-skin0000");

			this.playPauseButtonPlayUpIconTexture = this.atlas.getTexture("play-pause-toggle-button-play-up-icon0000");
			this.playPauseButtonPlayDownIconTexture = this.atlas.getTexture("play-pause-toggle-button-play-down-icon0000");
			this.playPauseButtonPauseUpIconTexture = this.atlas.getTexture("play-pause-toggle-button-pause-up-icon0000");
			this.playPauseButtonPauseDownIconTexture = this.atlas.getTexture("play-pause-toggle-button-pause-down-icon0000");
			this.overlayPlayPauseButtonPlayUpIconTexture = this.atlas.getTexture("overlay-play-pause-toggle-button-play-up-icon0000");
			this.overlayPlayPauseButtonPlayDownIconTexture = this.atlas.getTexture("overlay-play-pause-toggle-button-play-down-icon0000");
			this.fullScreenToggleButtonEnterUpIconTexture = this.atlas.getTexture("full-screen-toggle-button-enter-up-icon0000");
			this.fullScreenToggleButtonEnterDownIconTexture = this.atlas.getTexture("full-screen-toggle-button-enter-down-icon0000");
			this.fullScreenToggleButtonExitUpIconTexture = this.atlas.getTexture("full-screen-toggle-button-exit-up-icon0000");
			this.fullScreenToggleButtonExitDownIconTexture = this.atlas.getTexture("full-screen-toggle-button-exit-down-icon0000");
			this.muteToggleButtonMutedUpIconTexture = this.atlas.getTexture("mute-toggle-button-muted-up-icon0000");
			this.muteToggleButtonMutedDownIconTexture = this.atlas.getTexture("mute-toggle-button-muted-down-icon0000");
			this.muteToggleButtonLoudUpIconTexture = this.atlas.getTexture("mute-toggle-button-loud-up-icon0000");
			this.muteToggleButtonLoudDownIconTexture = this.atlas.getTexture("mute-toggle-button-loud-down-icon0000");
			this.popUpVolumeSliderTrackSkinTexture = this.atlas.getTexture("pop-up-volume-slider-track-skin0000");
			this.volumeSliderMinimumTrackSkinTexture = this.atlas.getTexture("volume-slider-minimum-track-skin0000");
			this.volumeSliderMaximumTrackSkinTexture = this.atlas.getTexture("volume-slider-maximum-track-skin0000");
			this.seekSliderProgressSkinTexture = this.atlas.getTexture("seek-slider-progress-skin0000");
		}

		/**
		 * Sets global style providers for all components.
		 */
		protected function initializeStyleProviders():void
		{
			//alert
			this.getStyleProviderForClass(Alert).defaultStyleFunction = this.setAlertStyles;
			this.getStyleProviderForClass(Header).setFunctionForStyleName(Alert.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setPopupHeaderStyles);
			this.getStyleProviderForClass(ButtonGroup).setFunctionForStyleName(Alert.DEFAULT_CHILD_STYLE_NAME_BUTTON_GROUP, this.setAlertButtonGroupStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_ALERT_BUTTON_GROUP_BUTTON, this.setAlertButtonGroupButtonStyles);

			//autocomplete
			this.getStyleProviderForClass(AutoComplete).defaultStyleFunction = this.setTextInputStyles;
			this.getStyleProviderForClass(List).setFunctionForStyleName(AutoComplete.DEFAULT_CHILD_STYLE_NAME_LIST, this.setDropDownListStyles);

			//button
			this.getStyleProviderForClass(Button).defaultStyleFunction = this.setButtonStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_CALL_TO_ACTION_BUTTON, this.setCallToActionButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_QUIET_BUTTON, this.setQuietButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_DANGER_BUTTON, this.setDangerButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON, this.setBackButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_FORWARD_BUTTON, this.setForwardButtonStyles);

			//button group
			this.getStyleProviderForClass(ButtonGroup).defaultStyleFunction = this.setButtonGroupStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ButtonGroup.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setButtonGroupButtonStyles);

			//callout
			this.getStyleProviderForClass(Callout).defaultStyleFunction = this.setCalloutStyles;

			//check
			this.getStyleProviderForClass(Check).defaultStyleFunction = this.setCheckStyles;

			//data grid (see also: item renderers)
			this.getStyleProviderForClass(DataGrid).defaultStyleFunction = this.setDataGridStyles;

			//date time spinner
			this.getStyleProviderForClass(DateTimeSpinner).defaultStyleFunction = this.setDateTimeSpinnerStyles;
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER, this.setDateTimeSpinnerListItemRendererStyles);

			//drawers
			this.getStyleProviderForClass(Drawers).defaultStyleFunction = this.setDrawersStyles;

			//grouped list (see also: item renderers)
			this.getStyleProviderForClass(GroupedList).defaultStyleFunction = this.setGroupedListStyles;

			//header
			this.getStyleProviderForClass(Header).defaultStyleFunction = this.setHeaderStyles;

			//header and footer renderers for grouped list
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).defaultStyleFunction = this.setGroupedListHeaderRendererStyles;
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).setFunctionForStyleName(GroupedList.DEFAULT_CHILD_STYLE_NAME_FOOTER_RENDERER, this.setGroupedListFooterRendererStyles);

			//header renderers for data grid
			this.getStyleProviderForClass(DefaultDataGridHeaderRenderer).defaultStyleFunction = this.setDataGridHeaderRendererStyles;

			//item renderers for lists
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).defaultStyleFunction = this.setItemRendererStyles;
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(DefaultGroupedListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN, this.setDrillDownItemRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(DefaultGroupedListItemRenderer.ALTERNATE_STYLE_NAME_CHECK, this.setCheckItemRendererStyles);
			this.getStyleProviderForClass(DefaultListItemRenderer).defaultStyleFunction = this.setItemRendererStyles;
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(DefaultListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN, this.setDrillDownItemRendererStyles);
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(DefaultListItemRenderer.ALTERNATE_STYLE_NAME_CHECK, this.setCheckItemRendererStyles);
			this.getStyleProviderForClass(DefaultDataGridCellRenderer).defaultStyleFunction = this.setDataGridCellRendererStyles;

			//labels
			this.getStyleProviderForClass(Label).defaultStyleFunction = this.setLabelStyles;
			this.getStyleProviderForClass(Label).setFunctionForStyleName(Label.ALTERNATE_STYLE_NAME_HEADING, this.setHeadingLabelStyles);
			this.getStyleProviderForClass(Label).setFunctionForStyleName(Label.ALTERNATE_STYLE_NAME_DETAIL, this.setDetailLabelStyles);
			this.getStyleProviderForClass(Label).setFunctionForStyleName(Label.ALTERNATE_STYLE_NAME_TOOL_TIP, this.setToolTipLabelStyles);

			//layout group
			this.getStyleProviderForClass(LayoutGroup).setFunctionForStyleName(LayoutGroup.ALTERNATE_STYLE_NAME_TOOLBAR, this.setToolbarLayoutGroupStyles);

			//list (see also: item renderers)
			this.getStyleProviderForClass(List).defaultStyleFunction = this.setListStyles;

			//numeric stepper
			this.getStyleProviderForClass(NumericStepper).defaultStyleFunction = this.setNumericStepperStyles;
			this.getStyleProviderForClass(TextInput).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_TEXT_INPUT, this.setNumericStepperTextInputStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON, this.setNumericStepperDecrementButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON, this.setNumericStepperIncrementButtonStyles);

			//page indicator
			this.getStyleProviderForClass(PageIndicator).defaultStyleFunction = this.setPageIndicatorStyles;

			//panel
			this.getStyleProviderForClass(Panel).defaultStyleFunction = this.setPanelStyles;
			this.getStyleProviderForClass(Header).setFunctionForStyleName(Panel.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setPopupHeaderStyles);

			//panel screen
			this.getStyleProviderForClass(PanelScreen).defaultStyleFunction = this.setPanelScreenStyles;
			this.getStyleProviderForClass(Header).setFunctionForStyleName(PanelScreen.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setPanelScreenHeaderStyles);

			//picker list (see also: list and item renderers)
			this.getStyleProviderForClass(PickerList).defaultStyleFunction = this.setPickerListStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setPickerListButtonStyles);
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setPickerListButtonStyles);
			this.getStyleProviderForClass(List).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_LIST, this.setDropDownListStyles);

			//progress bar
			this.getStyleProviderForClass(ProgressBar).defaultStyleFunction = this.setProgressBarStyles;

			//radio
			this.getStyleProviderForClass(Radio).defaultStyleFunction = this.setRadioStyles;

			//scroll bar
			this.getStyleProviderForClass(ScrollBar).setFunctionForStyleName(Scroller.DEFAULT_CHILD_STYLE_NAME_HORIZONTAL_SCROLL_BAR, this.setHorizontalScrollBarStyles);
			this.getStyleProviderForClass(ScrollBar).setFunctionForStyleName(Scroller.DEFAULT_CHILD_STYLE_NAME_VERTICAL_SCROLL_BAR, this.setVerticalScrollBarStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_INCREMENT_BUTTON, this.setHorizontalScrollBarIncrementButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_DECREMENT_BUTTON, this.setHorizontalScrollBarDecrementButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_THUMB, this.setHorizontalScrollBarThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_MINIMUM_TRACK, this.setHorizontalScrollBarMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_MAXIMUM_TRACK, this.setHorizontalScrollBarMaximumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_INCREMENT_BUTTON, this.setVerticalScrollBarIncrementButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_DECREMENT_BUTTON, this.setVerticalScrollBarDecrementButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_THUMB, this.setVerticalScrollBarThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_MINIMUM_TRACK, this.setVerticalScrollBarMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_MAXIMUM_TRACK, this.setVerticalScrollBarMaximumTrackStyles);

			//scroll container
			this.getStyleProviderForClass(ScrollContainer).defaultStyleFunction = this.setScrollContainerStyles;
			this.getStyleProviderForClass(ScrollContainer).setFunctionForStyleName(ScrollContainer.ALTERNATE_STYLE_NAME_TOOLBAR, this.setToolbarScrollContainerStyles);

			//scroll screen
			this.getStyleProviderForClass(ScrollScreen).defaultStyleFunction = this.setScrollScreenStyles;

			//scroll text
			this.getStyleProviderForClass(ScrollText).defaultStyleFunction = this.setScrollTextStyles;

			//simple scroll bar
			this.getStyleProviderForClass(SimpleScrollBar).defaultStyleFunction = this.setSimpleScrollBarStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SIMPLE_SCROLL_BAR_THUMB, this.setHorizontalSimpleScrollBarThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SIMPLE_SCROLL_BAR_THUMB, this.setVerticalSimpleScrollBarThumbStyles);

			//slider
			this.getStyleProviderForClass(Slider).defaultStyleFunction = this.setSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Slider.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK, this.setHorizontalSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SLIDER_MAXIMUM_TRACK, this.setHorizontalSliderMaximumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK, this.setVerticalSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SLIDER_MAXIMUM_TRACK, this.setVerticalSliderMaximumTrackStyles);
			
			//spinner list
			this.getStyleProviderForClass(SpinnerList).defaultStyleFunction = this.setSpinnerListStyles;

			//tab bar
			this.getStyleProviderForClass(TabBar).defaultStyleFunction = this.setTabBarStyles;
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(TabBar.DEFAULT_CHILD_STYLE_NAME_TAB, this.setTabStyles);

			//text input
			this.getStyleProviderForClass(TextInput).defaultStyleFunction = this.setTextInputStyles;
			this.getStyleProviderForClass(TextInput).setFunctionForStyleName(TextInput.ALTERNATE_STYLE_NAME_SEARCH_TEXT_INPUT, this.setSearchTextInputStyles);
			this.getStyleProviderForClass(TextBlockTextEditor).setFunctionForStyleName(TextInput.DEFAULT_CHILD_STYLE_NAME_TEXT_EDITOR, this.setTextInputTextEditorStyles);
			this.getStyleProviderForClass(TextCallout).setFunctionForStyleName(TextInput.DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT, this.setTextInputErrorCalloutStyles);

			//text area
			this.getStyleProviderForClass(TextArea).defaultStyleFunction = this.setTextAreaStyles;
			this.getStyleProviderForClass(TextCallout).setFunctionForStyleName(TextArea.DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT, this.setTextAreaErrorCalloutStyles);

			//text callout
			this.getStyleProviderForClass(TextCallout).defaultStyleFunction = this.setTextCalloutStyles;

			//toast
			this.getStyleProviderForClass(Toast).defaultStyleFunction = this.setToastStyles;
			this.getStyleProviderForClass(ButtonGroup).setFunctionForStyleName(Toast.DEFAULT_CHILD_STYLE_NAME_ACTIONS, this.setToastActionsStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON, this.setToastActionsButtonStyles);

			//toggle button
			this.getStyleProviderForClass(ToggleButton).defaultStyleFunction = this.setButtonStyles;
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_QUIET_BUTTON, this.setQuietButtonStyles);

			//toggle switch
			this.getStyleProviderForClass(ToggleSwitch).defaultStyleFunction = this.setToggleSwitchStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setToggleSwitchThumbStyles);
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setToggleSwitchThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_ON_TRACK, this.setToggleSwitchTrackStyles);
			//we don't need a style function for the off track in this theme
			//the toggle switch layout uses a single track

			//tree
			this.getStyleProviderForClass(Tree).defaultStyleFunction = this.setTreeStyles;
			this.getStyleProviderForClass(DefaultTreeItemRenderer).defaultStyleFunction = this.setTreeItemRendererStyles;

			//media controls
			this.getStyleProviderForClass(VideoPlayer).defaultStyleFunction = this.setVideoPlayerStyles;

			//play/pause toggle button
			this.getStyleProviderForClass(PlayPauseToggleButton).defaultStyleFunction = this.setPlayPauseToggleButtonStyles;
			this.getStyleProviderForClass(PlayPauseToggleButton).setFunctionForStyleName(PlayPauseToggleButton.ALTERNATE_STYLE_NAME_OVERLAY_PLAY_PAUSE_TOGGLE_BUTTON, this.setOverlayPlayPauseToggleButtonStyles);

			//full screen toggle button
			this.getStyleProviderForClass(FullScreenToggleButton).defaultStyleFunction = this.setFullScreenToggleButtonStyles;

			//mute toggle button
			this.getStyleProviderForClass(MuteToggleButton).defaultStyleFunction = this.setMuteToggleButtonStyles;
			this.getStyleProviderForClass(VolumeSlider).setFunctionForStyleName(MuteToggleButton.DEFAULT_CHILD_STYLE_NAME_VOLUME_SLIDER, this.setPopUpVolumeSliderStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_THUMB, this.setSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_MINIMUM_TRACK, this.setPopUpVolumeSliderTrackStyles);

			//seek slider
			this.getStyleProviderForClass(SeekSlider).defaultStyleFunction = this.setSeekSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SeekSlider.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setSeekSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SeekSlider.DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK, this.setSeekSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SeekSlider.DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK, this.setSeekSliderMaximumTrackStyles);

			//volume slider
			this.getStyleProviderForClass(VolumeSlider).defaultStyleFunction = this.setVolumeSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(VolumeSlider.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setVolumeSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(VolumeSlider.DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK, this.setVolumeSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(VolumeSlider.DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK, this.setVolumeSliderMaximumTrackStyles);
		}

		protected function pageIndicatorNormalSymbolFactory():DisplayObject
		{
			var symbol:ImageLoader = new ImageLoader();
			symbol.source = this.pageIndicatorNormalSkinTexture;
			return symbol;
		}

		protected function pageIndicatorSelectedSymbolFactory():DisplayObject
		{
			var symbol:ImageLoader = new ImageLoader();
			symbol.source = this.pageIndicatorSelectedSkinTexture;
			return symbol;
		}

		protected function dataGridHeaderDividerFactory():DisplayObject
		{
			var skin:ImageSkin = new ImageSkin(this.dataGridHeaderDividerSkinTexture);
			skin.scale9Grid = DATA_GRID_HEADER_DIVIDER_SCALE_9_GRID;
			return skin;
		}

		protected function dataGridVerticalDividerFactory():DisplayObject
		{
			var skin:ImageSkin = new ImageSkin(this.dataGridVerticalDividerSkinTexture);
			skin.scale9Grid = DATA_GRID_VERTICAL_DIVIDER_SCALE_9_GRID;
			return skin;
		}

		protected function toastContainerFactory():DisplayObjectContainer
		{
			var container:LayoutGroup = new LayoutGroup();
			container.autoSizeMode = AutoSizeMode.STAGE;

			var layout:VerticalLayout = new VerticalLayout();
			layout.verticalAlign = VerticalAlign.BOTTOM;
			layout.horizontalAlign = HorizontalAlign.LEFT;
			layout.padding = this.gutterSize;
			layout.gap = this.gutterSize;
			container.layout = layout;

			return container;
		}

	//-------------------------
	// Shared
	//-------------------------

		protected function setScrollerStyles(scroller:Scroller):void
		{
			scroller.horizontalScrollBarFactory = scrollBarFactory;
			scroller.verticalScrollBarFactory = scrollBarFactory;
			scroller.scrollBarDisplayMode = ScrollBarDisplayMode.FIXED;
			scroller.interactionMode = ScrollInteractionMode.MOUSE;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			scroller.focusIndicatorSkin = focusIndicatorSkin;
			scroller.focusPadding = 0;
		}

		protected function setDropDownListStyles(list:List):void
		{
			this.setListStyles(list);

			var layout:VerticalLayout = new VerticalLayout();
			layout.useVirtualLayout = true;
			layout.padding = 0;
			layout.gap = 0;
			layout.horizontalAlign = HorizontalAlign.JUSTIFY;
			layout.verticalAlign = VerticalAlign.TOP;
			layout.resetTypicalItemDimensionsOnMeasure = true;
			layout.maxRowCount = 5;
			list.layout = layout;
		}

	//-------------------------
	// Alert
	//-------------------------

		protected function setAlertStyles(alert:Alert):void
		{
			this.setScrollerStyles(alert);

			var backgroundSkin:Image = new Image(this.backgroundPopUpSkinTexture);
			backgroundSkin.scale9Grid = SIMPLE_SCALE9_GRID;
			alert.backgroundSkin = backgroundSkin;

			alert.fontStyles = this.lightFontStyles.clone();
			alert.disabledFontStyles = this.lightDisabledFontStyles.clone();

			alert.paddingTop = this.gutterSize;
			alert.paddingRight = this.gutterSize;
			alert.paddingBottom = this.smallGutterSize;
			alert.paddingLeft = this.gutterSize;
			alert.outerPadding = this.borderSize;
			alert.gap = this.smallGutterSize;
			alert.maxWidth = this.popUpSize;
			alert.maxHeight = this.popUpSize;
		}

		//see Panel section for Header styles

		protected function setAlertButtonGroupStyles(group:ButtonGroup):void
		{
			group.customButtonStyleName = THEME_STYLE_NAME_ALERT_BUTTON_GROUP_BUTTON;
			group.direction = Direction.HORIZONTAL;
			group.horizontalAlign = HorizontalAlign.CENTER;
			group.verticalAlign = VerticalAlign.JUSTIFY;
			group.distributeButtonSizes = false;
			group.gap = this.smallGutterSize;
			group.padding = this.smallGutterSize;
		}

		protected function setAlertButtonGroupButtonStyles(button:Button):void
		{
			this.setButtonStyles(button);
		}

	//-------------------------
	// Button
	//-------------------------

		protected function setBaseButtonStyles(button:Button):void
		{
			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;

			button.paddingTop = this.smallGutterSize;
			button.paddingBottom = this.smallGutterSize;
			button.paddingLeft = this.gutterSize;
			button.paddingRight = this.gutterSize;
			button.gap = this.smallGutterSize;
			button.minGap = this.smallGutterSize;
		}

		protected function setButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.buttonMinWidth;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				var selectedSkin:ImageSkin = new ImageSkin(this.toggleButtonSelectedUpSkinTexture);
				skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.toggleButtonSelectedDisabledSkinTexture);
				selectedSkin.scale9Grid = TOGGLE_BUTTON_SCALE9_GRID;
				selectedSkin.width = this.controlSize;
				selectedSkin.height = this.controlSize;
				ToggleButton(button).defaultSelectedSkin = selectedSkin;
			}

			button.fontStyles = this.darkUIFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledUIFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setCallToActionButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonCallToActionUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonCallToActionDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.buttonMinWidth;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.darkUIFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledUIFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setQuietButtonStyles(button:Button):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			button.defaultSkin = defaultSkin;

			var otherSkin:ImageSkin = new ImageSkin(null);
			otherSkin.setTextureForState(ButtonState.HOVER, this.buttonQuietHoverSkinTexture);
			otherSkin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			button.hoverSkin = otherSkin;
			button.downSkin = otherSkin;
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				var toggleButton:ToggleButton = ToggleButton(button);
				otherSkin.selectedTexture = this.toggleButtonSelectedUpSkinTexture;
				otherSkin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.toggleButtonSelectedDisabledSkinTexture);
				toggleButton.defaultSelectedSkin = otherSkin;
				toggleButton.setSkinForState(ButtonState.DISABLED_AND_SELECTED, otherSkin);
			}
			otherSkin.scale9Grid = BUTTON_SCALE9_GRID;
			otherSkin.width = this.controlSize;
			otherSkin.height = this.controlSize;
			otherSkin.minWidth = this.controlSize;
			otherSkin.minHeight = this.controlSize;

			button.fontStyles = this.lightUIFontStyles.clone();
			button.disabledFontStyles = this.lightDisabledUIFontStyles.clone();
			button.setFontStylesForState(ButtonState.DOWN, this.darkUIFontStyles.clone());
			button.setFontStylesForState(ButtonState.DISABLED, this.lightDisabledUIFontStyles.clone());
			if(button is ToggleButton)
			{
				toggleButton.selectedFontStyles = this.darkUIFontStyles.clone();
				toggleButton.setFontStylesForState(ButtonState.DISABLED_AND_SELECTED, this.darkDisabledUIFontStyles.clone());
			}

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;

			button.paddingTop = this.smallGutterSize;
			button.paddingBottom = this.smallGutterSize;
			button.paddingLeft = this.gutterSize;
			button.paddingRight = this.gutterSize;
			button.gap = this.smallGutterSize;
			button.minGap = this.smallGutterSize;
		}

		protected function setDangerButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonDangerUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDangerDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.buttonMinWidth;
			skin.height = this.controlSize;
			skin.minWidth = this.buttonMinWidth;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.darkUIFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledUIFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setBackButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonBackUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonBackDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonBackDisabledSkinTexture);
			skin.scale9Grid = BACK_BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.darkUIFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledUIFontStyles.clone();

			this.setBaseButtonStyles(button);

			button.paddingLeft = 2 * this.gutterSize;
		}

		protected function setForwardButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonForwardUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonForwardDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonForwardDisabledSkinTexture);
			skin.scale9Grid = FORWARD_BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.darkUIFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledUIFontStyles.clone();

			this.setBaseButtonStyles(button);

			button.paddingRight = 2 * this.gutterSize;
		}

	//-------------------------
	// ButtonGroup
	//-------------------------

		protected function setButtonGroupStyles(group:ButtonGroup):void
		{
			group.gap = this.smallGutterSize;
		}

		protected function setButtonGroupButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.wideControlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				var selectedSkin:ImageSkin = new ImageSkin(this.toggleButtonSelectedUpSkinTexture);
				skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.toggleButtonSelectedDisabledSkinTexture);
				selectedSkin.scale9Grid = TOGGLE_BUTTON_SCALE9_GRID;
				selectedSkin.width = this.controlSize;
				selectedSkin.height = this.controlSize;
				ToggleButton(button).defaultSelectedSkin = selectedSkin;
			}

			button.fontStyles = this.darkUIFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledUIFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

	//-------------------------
	// Callout
	//-------------------------

		protected function setCalloutStyles(callout:Callout):void
		{
			var backgroundSkin:Image = new Image(this.backgroundPopUpSkinTexture);
			backgroundSkin.scale9Grid = SIMPLE_SCALE9_GRID;
			backgroundSkin.width = this.calloutBackgroundMinSize;
			backgroundSkin.height = this.calloutBackgroundMinSize;
			callout.backgroundSkin = backgroundSkin;

			var topArrowSkin:Image = new Image(this.calloutTopArrowSkinTexture);
			callout.topArrowSkin = topArrowSkin;
			callout.topArrowGap = this.calloutArrowOverlapGap;

			var rightArrowSkin:Image = new Image(this.calloutRightArrowSkinTexture);
			callout.rightArrowSkin = rightArrowSkin;
			callout.rightArrowGap = this.calloutArrowOverlapGap;

			var bottomArrowSkin:Image = new Image(this.calloutBottomArrowSkinTexture);
			callout.bottomArrowSkin = bottomArrowSkin;
			callout.bottomArrowGap = this.calloutArrowOverlapGap;

			var leftArrowSkin:Image = new Image(this.calloutLeftArrowSkinTexture);
			callout.leftArrowSkin = leftArrowSkin;
			callout.leftArrowGap = this.calloutArrowOverlapGap;

			callout.padding = this.gutterSize;
		}

		protected function setDangerCalloutStyles(callout:Callout):void
		{
			var backgroundSkin:Image = new Image(this.backgroundDangerPopUpSkinTexture);
			backgroundSkin.scale9Grid = SIMPLE_SCALE9_GRID;
			backgroundSkin.width = this.calloutBackgroundMinSize;
			backgroundSkin.height = this.calloutBackgroundMinSize;
			callout.backgroundSkin = backgroundSkin;

			var topArrowSkin:Image = new Image(this.dangerCalloutTopArrowSkinTexture);
			callout.topArrowSkin = topArrowSkin;
			callout.topArrowGap = this.calloutArrowOverlapGap;

			var rightArrowSkin:Image = new Image(this.dangerCalloutRightArrowSkinTexture);
			callout.rightArrowSkin = rightArrowSkin;
			callout.rightArrowGap = this.calloutArrowOverlapGap;

			var bottomArrowSkin:Image = new Image(this.dangerCalloutBottomArrowSkinTexture);
			callout.bottomArrowSkin = bottomArrowSkin;
			callout.bottomArrowGap = this.calloutArrowOverlapGap;

			var leftArrowSkin:Image = new Image(this.dangerCalloutLeftArrowSkinTexture);
			callout.leftArrowSkin = leftArrowSkin;
			callout.leftArrowGap = this.calloutArrowOverlapGap;

			callout.padding = this.gutterSize;
		}

	//-------------------------
	// Check
	//-------------------------

		protected function setCheckStyles(check:Check):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			check.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.checkUpIconTexture);
			icon.selectedTexture = this.checkSelectedUpIconTexture;
			icon.setTextureForState(ButtonState.DOWN, this.checkDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED, this.checkDisabledIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.checkSelectedDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.checkSelectedDisabledIconTexture);
			check.defaultIcon = icon;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			check.focusIndicatorSkin = focusIndicatorSkin;
			check.focusPaddingLeft = this.focusPaddingSize;
			check.focusPaddingRight = this.focusPaddingSize;

			check.fontStyles = this.lightUIFontStyles.clone();
			check.disabledFontStyles = this.lightDisabledUIFontStyles.clone();

			check.horizontalAlign = HorizontalAlign.LEFT;
			check.gap = this.smallGutterSize;
		}

	//-------------------------
	// DataGrid
	//-------------------------

		protected function setDataGridStyles(grid:DataGrid):void
		{
			this.setScrollerStyles(grid);

			grid.padding = this.borderSize;

			var backgroundSkin:Image = new Image(this.listBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			grid.backgroundSkin = backgroundSkin;

			var backgroundDisabledSkin:Image = new Image(this.backgroundDisabledSkinTexture);
			backgroundDisabledSkin.scale9Grid = DEFAULT_SCALE9_GRID;
			backgroundDisabledSkin.width = this.controlSize;
			backgroundDisabledSkin.height = this.controlSize;
			grid.backgroundDisabledSkin = backgroundDisabledSkin;

			grid.headerBackgroundSkin = new Quad(this.controlSize, this.controlSize, GROUPED_LIST_HEADER_BACKGROUND_COLOR);

			var columnResizeSkin:ImageSkin = new ImageSkin(this.dataGridColumnResizeSkinTexture);
			columnResizeSkin.scale9Grid = DATA_GRID_COLUMN_RESIZE_SCALE_9_GRID;
			grid.columnResizeSkin = columnResizeSkin;

			var columnDragOverlaySkin:Quad = new Quad(1, 1, DATA_GRID_COLUMN_OVERLAY_COLOR);
			columnDragOverlaySkin.alpha = DATA_GRID_COLUMN_OVERLAY_ALPHA;
			grid.columnDragOverlaySkin = columnDragOverlaySkin;

			var columnDropIndicatorSkin:ImageSkin = new ImageSkin(this.dataGridColumnDropIndicatorSkinTexture);
			columnDropIndicatorSkin.scale9Grid = DATA_GRID_COLUMN_DROP_INDICATOR_SCALE_9_GRID;
			grid.columnDropIndicatorSkin = columnDropIndicatorSkin;
			grid.extendedColumnDropIndicator = true;

			grid.headerDividerFactory = this.dataGridHeaderDividerFactory;
			grid.verticalDividerFactory = this.dataGridVerticalDividerFactory;

			grid.verticalScrollPolicy = ScrollPolicy.AUTO;
		}

		protected function setDataGridCellRendererStyles(cellRenderer:DefaultDataGridCellRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			skin.selectedTexture = this.itemRendererSelectedUpSkinTexture;
			skin.setTextureForState(ButtonState.HOVER, this.itemRendererHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.itemRendererSelectedUpSkinTexture);
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			cellRenderer.defaultSkin = skin;

			cellRenderer.fontStyles = this.lightFontStyles.clone();
			cellRenderer.disabledFontStyles = this.lightDisabledFontStyles.clone();
			cellRenderer.selectedFontStyles = this.darkFontStyles.clone();
			cellRenderer.setFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());
			cellRenderer.setFontStylesForState(ButtonState.HOVER, this.darkFontStyles.clone());

			cellRenderer.iconLabelFontStyles = this.lightFontStyles.clone();
			cellRenderer.iconLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();
			cellRenderer.iconLabelSelectedFontStyles = this.darkFontStyles.clone();
			cellRenderer.setIconLabelFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());
			cellRenderer.setIconLabelFontStylesForState(ButtonState.HOVER, this.darkFontStyles.clone());

			cellRenderer.accessoryLabelFontStyles = this.lightFontStyles.clone();
			cellRenderer.accessoryLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();
			cellRenderer.accessoryLabelSelectedFontStyles = this.darkFontStyles.clone();
			cellRenderer.setAccessoryLabelFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());
			cellRenderer.setAccessoryLabelFontStylesForState(ButtonState.HOVER, this.darkFontStyles.clone());

			cellRenderer.horizontalAlign = HorizontalAlign.LEFT;
			cellRenderer.paddingTop = this.smallGutterSize;
			cellRenderer.paddingBottom = this.smallGutterSize;
			cellRenderer.paddingLeft = this.gutterSize;
			cellRenderer.paddingRight = this.gutterSize;
			cellRenderer.gap = this.smallGutterSize;
			cellRenderer.minGap = this.smallGutterSize;
			cellRenderer.iconPosition = RelativePosition.LEFT;
			cellRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			cellRenderer.minAccessoryGap = this.smallGutterSize;
			cellRenderer.accessoryPosition = RelativePosition.RIGHT;

			cellRenderer.useStateDelayTimer = false;
		}

		protected function setDataGridHeaderRendererStyles(headerRenderer:DefaultDataGridHeaderRenderer):void
		{
			headerRenderer.backgroundSkin = new Quad(this.controlSize, this.controlSize, GROUPED_LIST_HEADER_BACKGROUND_COLOR);

			headerRenderer.sortAscendingIcon = new ImageSkin(this.dataGridHeaderSortAscendingIconTexture);
			headerRenderer.sortDescendingIcon = new ImageSkin(this.dataGridHeaderSortDescendingIconTexture);

			headerRenderer.fontStyles = this.lightUIFontStyles.clone();
			headerRenderer.disabledFontStyles = this.lightDisabledUIFontStyles.clone();

			headerRenderer.horizontalAlign = HorizontalAlign.LEFT;

			headerRenderer.paddingTop = this.smallGutterSize;
			headerRenderer.paddingBottom = this.smallGutterSize;
			headerRenderer.paddingLeft = this.gutterSize;
			headerRenderer.paddingRight = this.gutterSize;
		}

	//-------------------------
	// DateTimeSpinner
	//-------------------------

		protected function setDateTimeSpinnerStyles(spinner:DateTimeSpinner):void
		{
			spinner.customItemRendererStyleName = THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER;
		}

		protected function setDateTimeSpinnerListItemRendererStyles(itemRenderer:DefaultListItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			itemRenderer.accessoryPosition = RelativePosition.LEFT;
			itemRenderer.accessoryGap = this.smallGutterSize;
		}

	//-------------------------
	// Drawers
	//-------------------------

		protected function setDrawersStyles(drawers:Drawers):void
		{
			var overlaySkin:Quad = new Quad(1, 1, DRAWER_OVERLAY_COLOR);
			overlaySkin.alpha = DRAWER_OVERLAY_ALPHA;
			drawers.overlaySkin = overlaySkin;
		}

	//-------------------------
	// GroupedList
	//-------------------------

		protected function setGroupedListStyles(list:GroupedList):void
		{
			this.setScrollerStyles(list);

			list.padding = this.borderSize;

			var backgroundSkin:Image = new Image(this.listBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE9_GRID;
			list.backgroundSkin = backgroundSkin;

			var backgroundDisabledSkin:Image = new Image(this.backgroundDisabledSkinTexture);
			backgroundDisabledSkin.scale9Grid = DEFAULT_SCALE9_GRID;
			list.backgroundDisabledSkin = backgroundDisabledSkin;

			list.verticalScrollPolicy = ScrollPolicy.AUTO;
		}

		//see List section for item renderer styles

		protected function setGroupedListHeaderRendererStyles(headerRenderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			headerRenderer.backgroundSkin = new Quad(this.controlSize, this.controlSize, GROUPED_LIST_HEADER_BACKGROUND_COLOR);

			headerRenderer.fontStyles = this.lightUIFontStyles.clone();
			headerRenderer.disabledFontStyles = this.lightDisabledUIFontStyles.clone();

			headerRenderer.horizontalAlign = HorizontalAlign.LEFT;

			headerRenderer.paddingTop = this.smallGutterSize;
			headerRenderer.paddingBottom = this.smallGutterSize;
			headerRenderer.paddingLeft = this.gutterSize;
			headerRenderer.paddingRight = this.gutterSize;
		}

		protected function setGroupedListFooterRendererStyles(footerRenderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			footerRenderer.backgroundSkin = new Quad(this.controlSize, this.controlSize, GROUPED_LIST_FOOTER_BACKGROUND_COLOR);

			footerRenderer.fontStyles = this.lightFontStyles.clone();
			footerRenderer.disabledFontStyles = this.lightDisabledFontStyles.clone();

			footerRenderer.horizontalAlign = HorizontalAlign.CENTER;

			footerRenderer.paddingTop = this.smallGutterSize;
			footerRenderer.paddingBottom = this.smallGutterSize;
			footerRenderer.paddingLeft = this.gutterSize;
			footerRenderer.paddingRight = this.gutterSize;
		}

	//-------------------------
	// Header
	//-------------------------

		protected function setHeaderStyles(header:Header):void
		{
			header.paddingTop = this.smallGutterSize;
			header.paddingBottom = this.smallGutterSize;
			header.paddingRight = this.gutterSize;
			header.paddingLeft = this.gutterSize;
			header.gap = this.smallGutterSize;
			header.titleGap = this.smallGutterSize;

			header.fontStyles = this.lightFontStyles.clone();
			header.disabledFontStyles = this.lightDisabledFontStyles.clone();

			var backgroundSkin:ImageSkin = new ImageSkin(this.headerBackgroundSkinTexture);
			backgroundSkin.tileGrid = new Rectangle();
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			header.backgroundSkin = backgroundSkin;
		}

	//-------------------------
	// Label
	//-------------------------

		protected function setLabelStyles(label:Label):void
		{
			label.fontStyles = this.lightFontStyles.clone();
			label.disabledFontStyles = this.lightDisabledFontStyles.clone();
		}

		protected function setHeadingLabelStyles(label:Label):void
		{
			label.fontStyles = this.largeLightFontStyles.clone();
			label.disabledFontStyles = this.largeLightDisabledFontStyles.clone();
		}

		protected function setDetailLabelStyles(label:Label):void
		{
			label.fontStyles = this.smallLightFontStyles.clone();
			label.disabledFontStyles = this.smallLightDisabledFontStyles.clone();
		}

		protected function setToolTipLabelStyles(label:Label):void
		{
			var backgroundSkin:Image = new Image(this.backgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE9_GRID;
			label.backgroundSkin = backgroundSkin;

			label.fontStyles = this.lightFontStyles.clone();
			label.disabledFontStyles = this.lightDisabledFontStyles.clone();

			label.padding = this.smallGutterSize;
		}

	//-------------------------
	// LayoutGroup
	//-------------------------

		protected function setToolbarLayoutGroupStyles(group:LayoutGroup):void
		{
			if(!group.layout)
			{
				var layout:HorizontalLayout = new HorizontalLayout();
				layout.padding = this.gutterSize;
				layout.gap = this.smallGutterSize;
				layout.verticalAlign = VerticalAlign.MIDDLE;
				group.layout = layout;
			}

			var backgroundSkin:ImageSkin = new ImageSkin(this.headerBackgroundSkinTexture);
			backgroundSkin.tileGrid = new Rectangle();
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			group.backgroundSkin = backgroundSkin;
		}

	//-------------------------
	// List
	//-------------------------

		protected function setListStyles(list:List):void
		{
			this.setScrollerStyles(list);

			list.padding = this.borderSize;

			var backgroundSkin:Image = new Image(this.listBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			list.backgroundSkin = backgroundSkin;

			var backgroundDisabledSkin:Image = new Image(this.backgroundDisabledSkinTexture);
			backgroundDisabledSkin.scale9Grid = DEFAULT_SCALE9_GRID;
			backgroundDisabledSkin.width = this.controlSize;
			backgroundDisabledSkin.height = this.controlSize;
			list.backgroundDisabledSkin = backgroundDisabledSkin;

			var dropIndicatorSkin:Quad = new Quad(this.borderSize, this.borderSize, LIGHT_TEXT_COLOR);
			list.dropIndicatorSkin = dropIndicatorSkin;

			list.verticalScrollPolicy = ScrollPolicy.AUTO;
		}

		protected function setItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			skin.selectedTexture = this.itemRendererSelectedUpSkinTexture;
			skin.setTextureForState(ButtonState.HOVER, this.itemRendererHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.itemRendererSelectedUpSkinTexture);
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			itemRenderer.defaultSkin = skin;

			itemRenderer.fontStyles = this.lightFontStyles.clone();
			itemRenderer.disabledFontStyles = this.lightDisabledFontStyles.clone();
			itemRenderer.selectedFontStyles = this.darkFontStyles.clone();
			itemRenderer.setFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());
			itemRenderer.setFontStylesForState(ButtonState.HOVER, this.darkFontStyles.clone());

			itemRenderer.iconLabelFontStyles = this.lightFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();
			itemRenderer.iconLabelSelectedFontStyles = this.darkFontStyles.clone();
			itemRenderer.setIconLabelFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());
			itemRenderer.setIconLabelFontStylesForState(ButtonState.HOVER, this.darkFontStyles.clone());

			itemRenderer.accessoryLabelFontStyles = this.lightFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();
			itemRenderer.accessoryLabelSelectedFontStyles = this.darkFontStyles.clone();
			itemRenderer.setAccessoryLabelFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());
			itemRenderer.setAccessoryLabelFontStylesForState(ButtonState.HOVER, this.darkFontStyles.clone());

			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;
			itemRenderer.paddingTop = this.smallGutterSize;
			itemRenderer.paddingBottom = this.smallGutterSize;
			itemRenderer.paddingLeft = this.gutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.gap = this.smallGutterSize;
			itemRenderer.minGap = this.smallGutterSize;
			itemRenderer.iconPosition = RelativePosition.LEFT;
			itemRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			itemRenderer.minAccessoryGap = this.smallGutterSize;
			itemRenderer.accessoryPosition = RelativePosition.RIGHT;

			itemRenderer.useStateDelayTimer = false;
		}

		protected function setDrillDownItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			itemRenderer.itemHasAccessory = false;

			var defaultAccessory:ImageSkin = new ImageSkin(this.listDrillDownAccessoryTexture);
			defaultAccessory.selectedTexture = this.listDrillDownAccessorySelectedTexture;
			defaultAccessory.setTextureForState(ButtonState.HOVER, this.listDrillDownAccessorySelectedTexture);
			defaultAccessory.setTextureForState(ButtonState.DOWN, this.listDrillDownAccessorySelectedTexture);
			itemRenderer.defaultAccessory = defaultAccessory;
		}

		protected function setCheckItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			skin.width = this.controlSize;
			skin.width = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			itemRenderer.defaultSkin = skin;

			itemRenderer.itemHasIcon = false;

			var icon:ImageSkin = new ImageSkin(this.checkUpIconTexture);
			icon.selectedTexture = this.checkSelectedUpIconTexture;
			icon.setTextureForState(ButtonState.DOWN, this.checkDownIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.checkSelectedDownIconTexture);
			itemRenderer.defaultIcon = icon;

			itemRenderer.fontStyles = this.lightFontStyles.clone();
			itemRenderer.disabledFontStyles = this.lightDisabledFontStyles.clone();
			itemRenderer.iconLabelFontStyles = this.lightFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();
			itemRenderer.accessoryLabelFontStyles = this.lightFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();

			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;
			itemRenderer.paddingTop = this.smallGutterSize;
			itemRenderer.paddingBottom = this.smallGutterSize;
			itemRenderer.paddingLeft = this.gutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.gap = this.smallGutterSize;
			itemRenderer.minGap = this.smallGutterSize;
			itemRenderer.iconPosition = RelativePosition.LEFT;
			itemRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			itemRenderer.minAccessoryGap = this.smallGutterSize;
			itemRenderer.accessoryPosition = RelativePosition.RIGHT;

			itemRenderer.useStateDelayTimer = false;
		}

	//-------------------------
	// NumericStepper
	//-------------------------

		protected function setNumericStepperStyles(stepper:NumericStepper):void
		{
			stepper.buttonLayoutMode = StepperButtonLayoutMode.RIGHT_SIDE_VERTICAL;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			stepper.focusIndicatorSkin = focusIndicatorSkin;
			stepper.focusPadding = this.focusPaddingSize;
		}

		protected function setNumericStepperTextInputStyles(input:TextInput):void
		{
			var skin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			skin.setTextureForState(TextInputState.DISABLED, this.backgroundDisabledSkinTexture);
			skin.setTextureForState(TextInputState.FOCUSED, this.backgroundFocusedSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE9_GRID;
			skin.width = this.gridSize;
			skin.height = this.controlSize;
			skin.minWidth = this.gridSize;
			skin.minHeight = this.controlSize;
			input.backgroundSkin = skin;

			input.fontStyles = this.lightCenteredUIFontStyles.clone();
			input.disabledFontStyles = this.lightCenteredDisabledUIFontStyles.clone();

			input.gap = this.smallGutterSize;
			input.paddingTop = this.smallGutterSize;
			input.paddingBottom = this.smallGutterSize;
			input.paddingLeft = this.gutterSize;
			input.paddingRight = this.gutterSize;
		}

		protected function setNumericStepperDecrementButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.verticalScrollBarIncrementButtonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.verticalScrollBarIncrementButtonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.verticalScrollBarIncrementButtonDisabledSkinTexture);
			skin.scale9Grid = SCROLL_BAR_STEP_BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.smallControlSize;
			button.defaultSkin = skin;

			button.defaultIcon = new Image(this.verticalScrollBarIncrementButtonIconTexture);
			button.disabledIcon = new Image(this.verticalScrollBarIncrementButtonDisabledIconTexture);

			var incrementButtonDisabledIcon:Quad = new Quad(1, 1, 0xff00ff);
			incrementButtonDisabledIcon.alpha = 0;
			button.disabledIcon = incrementButtonDisabledIcon;

			button.keepDownStateOnRollOut = true;
			button.hasLabelTextRenderer = false;
		}

		protected function setNumericStepperIncrementButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.verticalScrollBarDecrementButtonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.verticalScrollBarDecrementButtonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.verticalScrollBarDecrementButtonDisabledSkinTexture);
			skin.scale9Grid = SCROLL_BAR_STEP_BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.smallControlSize;
			button.defaultSkin = skin;

			button.defaultIcon = new Image(this.verticalScrollBarDecrementButtonIconTexture);
			button.disabledIcon = new Image(this.verticalScrollBarDecrementButtonDisabledIconTexture);

			var incrementButtonDisabledIcon:Quad = new Quad(1, 1, 0xff00ff);
			incrementButtonDisabledIcon.alpha = 0;
			button.disabledIcon = incrementButtonDisabledIcon;

			button.keepDownStateOnRollOut = true;
			button.hasLabelTextRenderer = false;
		}

	//-------------------------
	// PageIndicator
	//-------------------------

		protected function setPageIndicatorStyles(pageIndicator:PageIndicator):void
		{
			pageIndicator.interactionMode = PageIndicatorInteractionMode.PRECISE;

			pageIndicator.normalSymbolFactory = this.pageIndicatorNormalSymbolFactory;
			pageIndicator.selectedSymbolFactory = this.pageIndicatorSelectedSymbolFactory;

			pageIndicator.gap = this.gutterSize;
			pageIndicator.padding = this.smallGutterSize;
		}

	//-------------------------
	// Panel
	//-------------------------

		protected function setPanelStyles(panel:Panel):void
		{
			this.setScrollerStyles(panel);

			var backgroundSkin:Image = new Image(this.backgroundPopUpSkinTexture);
			backgroundSkin.scale9Grid = SIMPLE_SCALE9_GRID;
			panel.backgroundSkin = backgroundSkin;

			panel.padding = this.gutterSize;
			panel.outerPadding = this.borderSize;
		}

		protected function setPopupHeaderStyles(header:Header):void
		{
			var backgroundSkin:ImageSkin = new ImageSkin(this.headerPopupBackgroundSkinTexture);
			backgroundSkin.tileGrid = new Rectangle();
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			header.backgroundSkin = backgroundSkin;

			header.fontStyles = this.lightFontStyles.clone();
			header.disabledFontStyles = this.lightDisabledFontStyles.clone();

			header.paddingTop = this.smallGutterSize;
			header.paddingBottom = this.smallGutterSize;
			header.paddingRight = this.gutterSize;
			header.paddingLeft = this.gutterSize;
			header.gap = this.smallGutterSize;
			header.titleGap = this.smallGutterSize;
		}

	//-------------------------
	// PanelScreen
	//-------------------------

		protected function setPanelScreenStyles(screen:PanelScreen):void
		{
			this.setScrollerStyles(screen);
		}

		protected function setPanelScreenHeaderStyles(header:Header):void
		{
			this.setHeaderStyles(header);
			header.useExtraPaddingForOSStatusBar = true;
		}

	//-------------------------
	// PickerList
	//-------------------------

		protected function setPickerListStyles(list:PickerList):void
		{
			list.popUpContentManager = new DropDownPopUpContentManager();
			list.toggleButtonOnOpenAndClose = true;
			list.buttonFactory = pickerListButtonFactory;
		}

		protected function setPickerListButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.buttonMinWidth;
			skin.height = this.controlSize;
			skin.minWidth = this.buttonMinWidth;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.pickerListButtonIconTexture);
			icon.setTextureForState(ButtonState.DISABLED, this.pickerListButtonIconDisabledTexture);
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				icon.selectedTexture = this.pickerListButtonIconSelectedTexture;
				icon.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.pickerListButtonIconDisabledTexture);
			}
			button.defaultIcon = icon;

			button.fontStyles = this.darkUIFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledUIFontStyles.clone();

			this.setBaseButtonStyles(button);

			button.gap = Number.POSITIVE_INFINITY; //fill as completely as possible
			button.horizontalAlign = HorizontalAlign.LEFT;
			button.iconPosition = RelativePosition.RIGHT;
		}

		//for the PickerList's pop-up list, see setDropDownListStyles()

	//-------------------------
	// ProgressBar
	//-------------------------

		protected function setProgressBarStyles(progress:ProgressBar):void
		{
			var backgroundSkin:Image = new Image(this.backgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE9_GRID;
			if(progress.direction == Direction.VERTICAL)
			{
				backgroundSkin.width = this.smallControlSize;
				backgroundSkin.height = this.wideControlSize;
			}
			else
			{
				backgroundSkin.width = this.wideControlSize;
				backgroundSkin.height = this.smallControlSize;
			}
			progress.backgroundSkin = backgroundSkin;

			var backgroundDisabledSkin:Image = new Image(this.backgroundDisabledSkinTexture);
			backgroundDisabledSkin.scale9Grid = DEFAULT_SCALE9_GRID;
			if(progress.direction == Direction.VERTICAL)
			{
				backgroundDisabledSkin.width = this.smallControlSize;
				backgroundDisabledSkin.height = this.wideControlSize;
			}
			else
			{
				backgroundDisabledSkin.width = this.wideControlSize;
				backgroundDisabledSkin.height = this.smallControlSize;
			}
			progress.backgroundDisabledSkin = backgroundDisabledSkin;

			var fillSkin:Image = new Image(this.buttonUpSkinTexture);
			fillSkin.scale9Grid = BUTTON_SCALE9_GRID;
			if(progress.direction == Direction.VERTICAL)
			{
				fillSkin.width = this.smallControlSize;
				fillSkin.height = this.progressBarFillMinSize;
			}
			else
			{
				fillSkin.width = this.progressBarFillMinSize;
				fillSkin.height = this.smallControlSize;
			}
			progress.fillSkin = fillSkin;

			var fillDisabledSkin:Image = new Image(this.buttonDisabledSkinTexture);
			fillDisabledSkin.scale9Grid = BUTTON_SCALE9_GRID;
			if(progress.direction == Direction.VERTICAL)
			{
				fillDisabledSkin.width = this.smallControlSize;
				fillDisabledSkin.height = this.progressBarFillMinSize;
			}
			else
			{
				fillDisabledSkin.width = this.progressBarFillMinSize;
				fillDisabledSkin.height = this.smallControlSize;
			}
			progress.fillDisabledSkin = fillDisabledSkin;
		}

	//-------------------------
	// Radio
	//-------------------------

		protected function setRadioStyles(radio:Radio):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			radio.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.radioUpIconTexture);
			icon.selectedTexture = this.radioSelectedUpIconTexture;
			icon.setTextureForState(ButtonState.DOWN, this.radioDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED, this.radioDisabledIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.radioSelectedDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.radioSelectedDisabledIconTexture);
			radio.defaultIcon = icon;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			radio.focusIndicatorSkin = focusIndicatorSkin;
			radio.focusPaddingLeft = this.focusPaddingSize;
			radio.focusPaddingRight = this.focusPaddingSize;

			radio.fontStyles = this.lightUIFontStyles.clone();
			radio.disabledFontStyles = this.lightDisabledUIFontStyles.clone();

			radio.horizontalAlign = HorizontalAlign.LEFT;
			radio.gap = this.smallGutterSize;
		}

	//-------------------------
	// ScrollBar
	//-------------------------

		protected function setHorizontalScrollBarStyles(scrollBar:ScrollBar):void
		{
			scrollBar.direction = Direction.HORIZONTAL;
			scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;

			scrollBar.customIncrementButtonStyleName = THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_INCREMENT_BUTTON;
			scrollBar.customDecrementButtonStyleName = THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_DECREMENT_BUTTON;
			scrollBar.customThumbStyleName = THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_THUMB;
			scrollBar.customMinimumTrackStyleName = THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_MINIMUM_TRACK;
		}

		protected function setVerticalScrollBarStyles(scrollBar:ScrollBar):void
		{
			scrollBar.direction = Direction.VERTICAL;
			scrollBar.trackLayoutMode = TrackLayoutMode.SPLIT;

			scrollBar.customIncrementButtonStyleName = THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_INCREMENT_BUTTON;
			scrollBar.customDecrementButtonStyleName = THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_DECREMENT_BUTTON;
			scrollBar.customThumbStyleName = THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_THUMB;
			scrollBar.customMinimumTrackStyleName = THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_MINIMUM_TRACK;
			scrollBar.customMaximumTrackStyleName = THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_MAXIMUM_TRACK;
		}

		protected function setHorizontalScrollBarIncrementButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.horizontalScrollBarIncrementButtonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.horizontalScrollBarIncrementButtonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.horizontalScrollBarIncrementButtonDisabledSkinTexture);
			skin.scale9Grid = SCROLL_BAR_STEP_BUTTON_SCALE9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.smallControlSize;
			button.defaultSkin = skin;

			button.defaultIcon = new Image(this.horizontalScrollBarIncrementButtonIconTexture);
			button.disabledIcon = new Image(this.horizontalScrollBarIncrementButtonDisabledIconTexture);

			var incrementButtonDisabledIcon:Quad = new Quad(1, 1, 0xff00ff);
			incrementButtonDisabledIcon.alpha = 0;
			button.disabledIcon = incrementButtonDisabledIcon;

			button.hasLabelTextRenderer = false;
		}

		protected function setHorizontalScrollBarDecrementButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.horizontalScrollBarDecrementButtonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.horizontalScrollBarDecrementButtonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.horizontalScrollBarDecrementButtonDisabledSkinTexture);
			skin.scale9Grid = SCROLL_BAR_STEP_BUTTON_SCALE9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.smallControlSize;
			button.defaultSkin = skin;

			button.defaultIcon = new Image(this.horizontalScrollBarDecrementButtonIconTexture);
			button.disabledIcon = new Image(this.horizontalScrollBarDecrementButtonDisabledIconTexture);

			var decrementButtonDisabledIcon:Quad = new Quad(1, 1, 0xff00ff);
			decrementButtonDisabledIcon.alpha = 0;
			button.disabledIcon = decrementButtonDisabledIcon;

			button.hasLabelTextRenderer = false;
		}

		protected function setHorizontalScrollBarThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.smallControlSize;
			skin.minHeight = this.smallControlSize;
			thumb.defaultSkin = skin;

			thumb.hasLabelTextRenderer = false;
		}

		protected function setHorizontalScrollBarMinimumTrackStyles(track:Button):void
		{
			track.defaultSkin = new Quad(this.smallControlSize, this.smallControlSize, SCROLL_BAR_TRACK_COLOR);
			track.downSkin = new Quad(this.smallControlSize, this.smallControlSize, SCROLL_BAR_TRACK_DOWN_COLOR);

			track.hasLabelTextRenderer = false;
		}

		protected function setHorizontalScrollBarMaximumTrackStyles(track:Button):void
		{
			track.defaultSkin = new Quad(this.smallControlSize, this.smallControlSize, SCROLL_BAR_TRACK_COLOR);
			track.downSkin = new Quad(this.smallControlSize, this.smallControlSize, SCROLL_BAR_TRACK_DOWN_COLOR);

			track.hasLabelTextRenderer = false;
		}

		protected function setVerticalScrollBarIncrementButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.verticalScrollBarIncrementButtonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.verticalScrollBarIncrementButtonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.verticalScrollBarIncrementButtonDisabledSkinTexture);
			skin.scale9Grid = SCROLL_BAR_STEP_BUTTON_SCALE9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.smallControlSize;
			button.defaultSkin = skin;

			button.defaultIcon = new Image(this.verticalScrollBarIncrementButtonIconTexture);
			button.disabledIcon = new Image(this.verticalScrollBarIncrementButtonDisabledIconTexture);

			var incrementButtonDisabledIcon:Quad = new Quad(1, 1, 0xff00ff);
			incrementButtonDisabledIcon.alpha = 0;
			button.disabledIcon = incrementButtonDisabledIcon;

			button.hasLabelTextRenderer = false;
		}

		protected function setVerticalScrollBarDecrementButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.verticalScrollBarDecrementButtonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.verticalScrollBarDecrementButtonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.verticalScrollBarDecrementButtonDisabledSkinTexture);
			skin.scale9Grid = SCROLL_BAR_STEP_BUTTON_SCALE9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.smallControlSize;
			button.defaultSkin = skin;

			button.defaultIcon = new Image(this.verticalScrollBarDecrementButtonIconTexture);
			button.disabledIcon = new Image(this.verticalScrollBarDecrementButtonDisabledIconTexture);

			var decrementButtonDisabledIcon:Quad = new Quad(1, 1, 0xff00ff);
			decrementButtonDisabledIcon.alpha = 0;
			button.disabledIcon = decrementButtonDisabledIcon;

			button.hasLabelTextRenderer = false;
		}

		protected function setVerticalScrollBarThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.smallControlSize;
			skin.minHeight = this.smallControlSize;
			thumb.defaultSkin = skin;

			thumb.hasLabelTextRenderer = false;
		}

		protected function setVerticalScrollBarMinimumTrackStyles(track:Button):void
		{
			track.defaultSkin = new Quad(this.smallControlSize, this.smallControlSize, SCROLL_BAR_TRACK_COLOR);
			track.downSkin = new Quad(this.smallControlSize, this.smallControlSize, SCROLL_BAR_TRACK_DOWN_COLOR);

			track.hasLabelTextRenderer = false;
		}

		protected function setVerticalScrollBarMaximumTrackStyles(track:Button):void
		{
			track.defaultSkin = new Quad(this.smallControlSize, this.smallControlSize, SCROLL_BAR_TRACK_COLOR);
			track.downSkin = new Quad(this.smallControlSize, this.smallControlSize, SCROLL_BAR_TRACK_DOWN_COLOR);

			track.hasLabelTextRenderer = false;
		}

	//-------------------------
	// ScrollContainer
	//-------------------------

		protected function setScrollContainerStyles(container:ScrollContainer):void
		{
			this.setScrollerStyles(container);
		}

		protected function setToolbarScrollContainerStyles(container:ScrollContainer):void
		{
			this.setScrollerStyles(container);
			if(!container.layout)
			{
				var layout:HorizontalLayout = new HorizontalLayout();
				layout.padding = this.gutterSize;
				layout.gap = this.smallGutterSize;
				container.layout = layout;
			}

			var backgroundSkin:ImageSkin = new ImageSkin(this.headerBackgroundSkinTexture);
			backgroundSkin.tileGrid = new Rectangle();
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			container.backgroundSkin = backgroundSkin;
		}

	//-------------------------
	// ScrollScreen
	//-------------------------

		protected function setScrollScreenStyles(screen:ScrollScreen):void
		{
			this.setScrollerStyles(screen);
		}

	//-------------------------
	// ScrollText
	//-------------------------

		protected function setScrollTextStyles(text:ScrollText):void
		{
			this.setScrollerStyles(text);

			text.fontStyles = this.lightScrollTextFontStyles.clone();
			text.disabledFontStyles = this.lightDisabledScrollTextFontStyles.clone();

			text.padding = this.gutterSize;
		}

	//-------------------------
	// SimpleScrollBar
	//-------------------------

		protected function setSimpleScrollBarStyles(scrollBar:SimpleScrollBar):void
		{
			if(scrollBar.direction == Direction.HORIZONTAL)
			{
				scrollBar.paddingRight = this.scrollBarGutterSize;
				scrollBar.paddingBottom = this.scrollBarGutterSize;
				scrollBar.paddingLeft = this.scrollBarGutterSize;
				scrollBar.customThumbStyleName = THEME_STYLE_NAME_HORIZONTAL_SIMPLE_SCROLL_BAR_THUMB;
			}
			else
			{
				scrollBar.paddingTop = this.scrollBarGutterSize;
				scrollBar.paddingRight = this.scrollBarGutterSize;
				scrollBar.paddingBottom = this.scrollBarGutterSize;
				scrollBar.customThumbStyleName = THEME_STYLE_NAME_VERTICAL_SIMPLE_SCROLL_BAR_THUMB;
			}
		}

		protected function setHorizontalSimpleScrollBarThumbStyles(thumb:Button):void
		{
			var defaultSkin:Image = new Image(this.horizontalSimpleScrollBarThumbSkinTexture);
			defaultSkin.width = this.smallControlSize;
			defaultSkin.scale9Grid = HORIZONTAL_SCROLL_BAR_THUMB_SCALE_9_GRID;
			thumb.defaultSkin = defaultSkin;

			thumb.hasLabelTextRenderer = false;
		}

		protected function setVerticalSimpleScrollBarThumbStyles(thumb:Button):void
		{
			var defaultSkin:Image = new Image(this.verticalSimpleScrollBarThumbSkinTexture);
			defaultSkin.height = this.smallControlSize;
			defaultSkin.scale9Grid = VERTICAL_SCROLL_BAR_THUMB_SCALE_9_GRID;
			thumb.defaultSkin = defaultSkin;

			thumb.hasLabelTextRenderer = false;
		}

	//-------------------------
	// Slider
	//-------------------------

		protected function setSliderStyles(slider:Slider):void
		{
			slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			if(slider.direction == Direction.VERTICAL)
			{
				slider.customMinimumTrackStyleName = THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK;
				slider.customMaximumTrackStyleName = THEME_STYLE_NAME_VERTICAL_SLIDER_MAXIMUM_TRACK;
			}
			else //horizontal
			{
				slider.customMinimumTrackStyleName = THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK;
				slider.customMaximumTrackStyleName = THEME_STYLE_NAME_HORIZONTAL_SLIDER_MAXIMUM_TRACK;
			}

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			slider.focusIndicatorSkin = focusIndicatorSkin;
			slider.focusPadding = this.focusPaddingSize;
		}

		protected function setSliderThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.smallControlSize;
			skin.minWidth = this.smallControlSize;
			skin.minHeight = this.smallControlSize;
			thumb.defaultSkin = skin;

			thumb.hasLabelTextRenderer = false;
		}

		protected function setHorizontalSliderMinimumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			skin.disabledTexture = this.backgroundDisabledSkinTexture;
			skin.scale9Grid = DEFAULT_SCALE9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.smallControlSize;
			skin.minWidth = this.wideControlSize;
			skin.minHeight = this.smallControlSize;
			track.defaultSkin = skin;

			track.hasLabelTextRenderer = false;
		}

		protected function setHorizontalSliderMaximumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			skin.disabledTexture = this.backgroundDisabledSkinTexture;
			skin.scale9Grid = DEFAULT_SCALE9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.smallControlSize;
			skin.minWidth = this.wideControlSize;
			skin.minHeight = this.smallControlSize;
			track.defaultSkin = skin;

			track.hasLabelTextRenderer = false;
		}

		protected function setVerticalSliderMinimumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			skin.disabledTexture = this.backgroundDisabledSkinTexture;
			skin.scale9Grid = DEFAULT_SCALE9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.wideControlSize;
			skin.minWidth = this.smallControlSize;
			skin.minHeight = this.wideControlSize;
			track.defaultSkin = skin;

			track.hasLabelTextRenderer = false;
		}

		protected function setVerticalSliderMaximumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			skin.disabledTexture = this.backgroundDisabledSkinTexture;
			skin.scale9Grid = DEFAULT_SCALE9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.wideControlSize;
			skin.minWidth = this.smallControlSize;
			skin.minHeight = this.wideControlSize;
			track.defaultSkin = skin;

			track.hasLabelTextRenderer = false;
		}

	//-------------------------
	// SpinnerList
	//-------------------------

		protected function setSpinnerListStyles(list:SpinnerList):void
		{
			this.setListStyles(list);
		}

	//-------------------------
	// TabBar
	//-------------------------

		protected function setTabBarStyles(tabBar:TabBar):void
		{
			tabBar.distributeTabSizes = false;
			tabBar.horizontalAlign = HorizontalAlign.LEFT;
			tabBar.verticalAlign = VerticalAlign.JUSTIFY;
		}

		protected function setTabStyles(tab:ToggleButton):void
		{
			var skin:ImageSkin = new ImageSkin(this.tabUpSkinTexture);
			skin.selectedTexture = this.tabSelectedSkinTexture;
			skin.setTextureForState(ButtonState.DOWN, this.tabDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.tabDisabledSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.tabSelectedDisabledSkinTexture);
			skin.scale9Grid = TAB_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			tab.defaultSkin = skin;

			tab.fontStyles = this.lightUIFontStyles.clone();
			tab.selectedFontStyles = this.darkUIFontStyles.clone();
			tab.setFontStylesForState(ButtonState.DOWN, this.darkUIFontStyles.clone());
			tab.setFontStylesForState(ButtonState.DISABLED, this.lightDisabledUIFontStyles.clone());
			tab.setFontStylesForState(ButtonState.DISABLED_AND_SELECTED, this.darkDisabledUIFontStyles.clone());

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			tab.focusIndicatorSkin = focusIndicatorSkin;
			tab.focusPadding = this.focusPaddingSize;

			tab.paddingTop = this.smallGutterSize;
			tab.paddingBottom = this.smallGutterSize;
			tab.paddingLeft = this.gutterSize;
			tab.paddingRight = this.gutterSize;
			tab.gap = this.smallGutterSize;
		}

	//-------------------------
	// TextArea
	//-------------------------

		protected function setTextAreaStyles(textArea:TextArea):void
		{
			this.setScrollerStyles(textArea);

			var skin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			skin.setTextureForState(TextInputState.DISABLED, this.backgroundDisabledSkinTexture);
			skin.setTextureForState(TextInputState.FOCUSED, this.backgroundFocusedSkinTexture);
			skin.setTextureForState(TextInputState.ERROR, this.backgroundDangerSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE9_GRID;
			skin.width = this.wideControlSize * 2;
			skin.height = this.wideControlSize;
			textArea.backgroundSkin = skin;

			textArea.fontStyles = this.lightScrollTextFontStyles.clone();
			textArea.disabledFontStyles = this.lightDisabledScrollTextFontStyles.clone();

			textArea.promptFontStyles = this.lightFontStyles.clone();
			textArea.promptDisabledFontStyles = this.lightDisabledFontStyles.clone();

			textArea.padding = this.borderSize;
			textArea.innerPadding = this.smallGutterSize;
		}

		protected function setTextAreaErrorCalloutStyles(callout:TextCallout):void
		{
			this.setDangerCalloutStyles(callout);

			callout.fontStyles = this.lightFontStyles.clone();
			callout.disabledFontStyles = this.lightDisabledFontStyles.clone();

			callout.horizontalAlign = HorizontalAlign.LEFT;
			callout.verticalAlign = VerticalAlign.TOP;
		}

	//-------------------------
	// TextCallout
	//-------------------------

		protected function setTextCalloutStyles(callout:TextCallout):void
		{
			this.setCalloutStyles(callout);

			callout.fontStyles = this.lightFontStyles.clone();
			callout.disabledFontStyles = this.lightDisabledFontStyles.clone();
		}

	//-------------------------
	// TextInput
	//-------------------------

		protected function setBaseTextInputStyles(input:TextInput):void
		{
			var skin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			skin.setTextureForState(TextInputState.DISABLED, this.backgroundDisabledSkinTexture);
			skin.setTextureForState(TextInputState.FOCUSED, this.backgroundFocusedSkinTexture);
			skin.setTextureForState(TextInputState.ERROR, this.backgroundDangerSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			input.backgroundSkin = skin;

			input.fontStyles = this.lightFontStyles.clone();
			input.disabledFontStyles = this.lightDisabledFontStyles.clone();

			input.promptFontStyles = this.lightFontStyles.clone();
			input.promptDisabledFontStyles = this.lightDisabledFontStyles.clone();

			input.gap = this.smallGutterSize;
			input.paddingTop = this.smallGutterSize;
			input.paddingBottom = this.smallGutterSize;
			input.paddingLeft = this.gutterSize;
			input.paddingRight = this.gutterSize;
		}

		protected function setTextInputStyles(input:TextInput):void
		{
			this.setBaseTextInputStyles(input);
		}

		protected function setTextInputTextEditorStyles(textEditor:TextBlockTextEditor):void
		{
			textEditor.cursorSkin = new Quad(1, 1, LIGHT_TEXT_COLOR);
			textEditor.selectionSkin = new Quad(1, 1, TEXT_SELECTION_BACKGROUND_COLOR);
		}

		protected function setTextInputErrorCalloutStyles(callout:TextCallout):void
		{
			this.setDangerCalloutStyles(callout);

			callout.fontStyles = this.lightFontStyles.clone();
			callout.disabledFontStyles = this.lightDisabledFontStyles.clone();

			callout.horizontalAlign = HorizontalAlign.LEFT;
			callout.verticalAlign = VerticalAlign.TOP;
		}

		protected function setSearchTextInputStyles(input:TextInput):void
		{
			this.setBaseTextInputStyles(input);

			var icon:ImageSkin = new ImageSkin(this.searchIconTexture);
			icon.disabledTexture = this.searchIconDisabledTexture;
			input.defaultIcon = icon;
		}

	//-------------------------
	// Toast
	//-------------------------

		protected function setToastStyles(toast:Toast):void
		{
			var backgroundSkin:Image = new Image(this.backgroundPopUpSkinTexture);
			backgroundSkin.scale9Grid = SIMPLE_SCALE9_GRID;
			toast.backgroundSkin = backgroundSkin;

			toast.fontStyles = this.lightFontStyles.clone();

			toast.width = this.extraWideControlSize;
			toast.paddingTop = this.gutterSize;
			toast.paddingRight = this.gutterSize;
			toast.paddingBottom = this.gutterSize;
			toast.paddingLeft = this.gutterSize;
			toast.gap = Number.POSITIVE_INFINITY;
			toast.minGap = this.smallGutterSize;
			toast.horizontalAlign = HorizontalAlign.LEFT;
			toast.verticalAlign = VerticalAlign.MIDDLE;
		}

		protected function setToastActionsStyles(group:ButtonGroup):void
		{
			group.direction = Direction.HORIZONTAL;
			group.gap = this.smallGutterSize;
			group.customButtonStyleName = THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON;
		}

		protected function setToastActionsButtonStyles(button:Button):void
		{
			button.fontStyles = this.selectedUIFontStyles.clone();
			button.setFontStylesForState(ButtonState.DOWN, this.lightUIFontStyles);
		}

	//-------------------------
	// ToggleSwitch
	//-------------------------

		protected function setToggleSwitchStyles(toggle:ToggleSwitch):void
		{
			toggle.trackLayoutMode = TrackLayoutMode.SINGLE;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			toggle.focusIndicatorSkin = focusIndicatorSkin;
			toggle.focusPadding = this.focusPaddingSize;

			toggle.offLabelFontStyles = this.lightUIFontStyles.clone();
			toggle.offLabelDisabledFontStyles = this.lightDisabledUIFontStyles.clone();

			toggle.onLabelFontStyles = this.selectedUIFontStyles.clone();
			toggle.onLabelDisabledFontStyles = this.lightDisabledUIFontStyles.clone();
		}

		protected function setToggleSwitchThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			thumb.defaultSkin = skin;

			thumb.hasLabelTextRenderer = false;
		}

		protected function setToggleSwitchTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			skin.disabledTexture = this.backgroundDisabledSkinTexture;
			skin.scale9Grid = DEFAULT_SCALE9_GRID;
			skin.width = Math.round(this.controlSize * 2.5);
			skin.height = this.controlSize;
			track.defaultSkin = skin;

			track.hasLabelTextRenderer = false;
		}

	//-------------------------
	// Tree
	//-------------------------

		protected function setTreeStyles(tree:Tree):void
		{
			this.setScrollerStyles(tree);

			tree.padding = this.borderSize;

			var backgroundSkin:Image = new Image(this.listBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			tree.backgroundSkin = backgroundSkin;

			var backgroundDisabledSkin:Image = new Image(this.backgroundDisabledSkinTexture);
			backgroundDisabledSkin.scale9Grid = DEFAULT_SCALE9_GRID;
			backgroundDisabledSkin.width = this.controlSize;
			backgroundDisabledSkin.height = this.controlSize;
			tree.backgroundDisabledSkin = backgroundDisabledSkin;

			tree.verticalScrollPolicy = ScrollPolicy.AUTO;
		}

		protected function setTreeItemRendererStyles(itemRenderer:DefaultTreeItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			itemRenderer.indentation = this.treeDisclosureOpenIconTexture.width;

			var disclosureOpenIcon:ImageSkin = new ImageSkin(this.treeDisclosureOpenIconTexture);
			disclosureOpenIcon.selectedTexture = this.treeDisclosureOpenSelectedIconTexture;
			itemRenderer.disclosureOpenIcon = disclosureOpenIcon;

			var disclosureClosedIcon:ImageSkin = new ImageSkin(this.treeDisclosureClosedIconTexture);
			disclosureClosedIcon.selectedTexture = this.treeDisclosureClosedSelectedIconTexture;
			itemRenderer.disclosureClosedIcon = disclosureClosedIcon;
		}

	//-------------------------
	// VideoPlayer
	//-------------------------

		protected function setVideoPlayerStyles(player:VideoPlayer):void
		{
			player.backgroundSkin = new Quad(1, 1, 0x000000);
		}

	//-------------------------
	// PlayPauseToggleButton
	//-------------------------

		protected function setPlayPauseToggleButtonStyles(button:PlayPauseToggleButton):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			button.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.playPauseButtonPlayUpIconTexture);
			icon.selectedTexture = this.playPauseButtonPauseUpIconTexture;
			icon.setTextureForState(ButtonState.DOWN, this.playPauseButtonPlayDownIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.playPauseButtonPauseDownIconTexture);
			button.defaultIcon = icon;

			button.hasLabelTextRenderer = false;
		}

		protected function setOverlayPlayPauseToggleButtonStyles(button:PlayPauseToggleButton):void
		{
			var icon:ImageSkin = new ImageSkin(null);
			icon.setTextureForState(ButtonState.UP, this.overlayPlayPauseButtonPlayUpIconTexture);
			icon.setTextureForState(ButtonState.HOVER, this.overlayPlayPauseButtonPlayUpIconTexture);
			icon.setTextureForState(ButtonState.DOWN, this.overlayPlayPauseButtonPlayDownIconTexture);
			button.setIconForState(ButtonState.UP, icon);
			button.setIconForState(ButtonState.HOVER, icon);
			button.setIconForState(ButtonState.DOWN, icon);

			var defaultIcon:Quad = new Quad(1, 1, 0xff00ff);
			defaultIcon.alpha = 0;
			button.defaultIcon = defaultIcon;

			button.hasLabelTextRenderer = false;

			var overlaySkin:Quad = new Quad(1, 1, VIDEO_OVERLAY_COLOR);
			overlaySkin.alpha = VIDEO_OVERLAY_ALPHA;
			button.upSkin = overlaySkin;
			button.hoverSkin = overlaySkin;
		}

	//-------------------------
	// FullScreenToggleButton
	//-------------------------

		protected function setFullScreenToggleButtonStyles(button:FullScreenToggleButton):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			button.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.fullScreenToggleButtonEnterUpIconTexture);
			icon.selectedTexture = this.fullScreenToggleButtonExitUpIconTexture;
			icon.setTextureForState(ButtonState.DOWN, this.fullScreenToggleButtonEnterDownIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.fullScreenToggleButtonExitDownIconTexture);
			button.defaultIcon = icon;

			button.hasLabelTextRenderer = false;
		}

	//-------------------------
	// VolumeSlider
	//-------------------------

		protected function setVolumeSliderStyles(slider:VolumeSlider):void
		{
			slider.direction = Direction.HORIZONTAL;
			slider.trackLayoutMode = TrackLayoutMode.SPLIT;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			slider.focusIndicatorSkin = focusIndicatorSkin;
			slider.focusPadding = this.focusPaddingSize;

			slider.showThumb = false;
		}

		protected function setVolumeSliderThumbStyles(thumb:Button):void
		{
			var thumbSize:Number = 6;
			var defaultSkin:Quad = new Quad(thumbSize, thumbSize);
			defaultSkin.width = 0;
			defaultSkin.height = 0;
			thumb.defaultSkin = defaultSkin;
			thumb.hasLabelTextRenderer = false;
		}

		protected function setVolumeSliderMinimumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageLoader = new ImageLoader();
			defaultSkin.scaleContent = false;
			defaultSkin.source = this.volumeSliderMinimumTrackSkinTexture;
			track.defaultSkin = defaultSkin;
			track.hasLabelTextRenderer = false;
		}

		protected function setVolumeSliderMaximumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageLoader = new ImageLoader();
			defaultSkin.scaleContent = false;
			defaultSkin.horizontalAlign = HorizontalAlign.RIGHT;
			defaultSkin.source = this.volumeSliderMaximumTrackSkinTexture;
			track.defaultSkin = defaultSkin;
			track.hasLabelTextRenderer = false;
		}

	//-------------------------
	// MuteToggleButton
	//-------------------------

		protected function setMuteToggleButtonStyles(button:MuteToggleButton):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			button.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.muteToggleButtonLoudUpIconTexture);
			icon.selectedTexture = this.muteToggleButtonMutedUpIconTexture;
			icon.setTextureForState(ButtonState.DOWN, this.muteToggleButtonLoudDownIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.muteToggleButtonMutedDownIconTexture);
			button.defaultIcon = icon;

			button.showVolumeSliderOnHover = true;
			button.hasLabelTextRenderer = false;
		}

		protected function setPopUpVolumeSliderStyles(slider:VolumeSlider):void
		{
			slider.direction = Direction.VERTICAL;
			slider.trackLayoutMode = TrackLayoutMode.SINGLE;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			slider.focusIndicatorSkin = focusIndicatorSkin;
			slider.focusPadding = this.focusPaddingSize;

			slider.minimumPadding = this.popUpVolumeSliderPaddingSize;
			slider.maximumPadding = this.popUpVolumeSliderPaddingSize;
			slider.customThumbStyleName = THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_THUMB;
			slider.customMinimumTrackStyleName = THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_MINIMUM_TRACK;
		}

		protected function setPopUpVolumeSliderTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.popUpVolumeSliderTrackSkinTexture);
			skin.scale9Grid = VOLUME_SLIDER_TRACK_SCALE9_GRID;
			skin.width = this.gridSize;
			skin.height = this.wideControlSize;
			track.defaultSkin = skin;

			track.hasLabelTextRenderer = false;
		}

	//-------------------------
	// SeekSlider
	//-------------------------

		protected function setSeekSliderStyles(slider:SeekSlider):void
		{
			slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			slider.showThumb = false;
			var progressSkin:Image = new Image(this.seekSliderProgressSkinTexture);
			progressSkin.scale9Grid = DEFAULT_SCALE9_GRID;
			progressSkin.width = this.smallControlSize;
			progressSkin.height = this.smallControlSize;
			slider.progressSkin = progressSkin;
		}

		protected function setSeekSliderThumbStyles(thumb:Button):void
		{
			var thumbSize:Number = 6;
			var defaultSkin:Quad = new Quad(thumbSize, thumbSize);
			defaultSkin.width = 0;
			defaultSkin.height = 0;
			thumb.defaultSkin = defaultSkin;
			thumb.hasLabelTextRenderer = false;
		}

		protected function setSeekSliderMinimumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			defaultSkin.scale9Grid = BUTTON_SCALE9_GRID;
			defaultSkin.width = this.wideControlSize;
			defaultSkin.height = this.smallControlSize;
			defaultSkin.minWidth = this.wideControlSize;
			defaultSkin.minHeight = this.smallControlSize;
			track.defaultSkin = defaultSkin;
			track.hasLabelTextRenderer = false;
		}

		protected function setSeekSliderMaximumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			defaultSkin.scale9Grid = DEFAULT_SCALE9_GRID;
			defaultSkin.width = this.wideControlSize;
			defaultSkin.height = this.smallControlSize;
			defaultSkin.minWidth = this.wideControlSize;
			defaultSkin.minHeight = this.smallControlSize;
			track.defaultSkin = defaultSkin;
			track.hasLabelTextRenderer = false;
		}

	}
}


================================================
FILE: themes/MetalWorksDesktopTheme/source/feathers/themes/MetalWorksDesktopTheme.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import flash.display.Bitmap;
	import flash.display.BitmapData;

	import starling.textures.Texture;
	import starling.textures.TextureAtlas;

	/**
	 * The "Metal Works" theme for desktop Feathers apps.
	 *
	 * <p>This version of the theme embeds its assets. To load assets at
	 * runtime, see <code>MetalWorksDesktopThemeWithAssetManager</code> instead.</p>
	 *
	 * @see http://feathersui.com/help/theme-assets.html
	 */
	public class MetalWorksDesktopTheme extends BaseMetalWorksDesktopTheme
	{
		/**
		 * @private
		 */
		[Embed(source="/../assets/images/metalworks_desktop.xml",mimeType="application/octet-stream")]
		protected static const ATLAS_XML:Class;

		/**
		 * @private
		 */
		[Embed(source="/../assets/images/metalworks_desktop.png")]
		protected static const ATLAS_BITMAP:Class;

		/**
		 * @private
		 */
		protected static const ATLAS_SCALE_FACTOR:int = 2;

		/**
		 * Constructor.
		 */
		public function MetalWorksDesktopTheme()
		{
			super();
			this.initialize();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this.initializeTextureAtlas();
			super.initialize();
		}

		/**
		 * @private
		 */
		protected function initializeTextureAtlas():void
		{
			var atlasBitmapData:BitmapData = Bitmap(new ATLAS_BITMAP()).bitmapData;
			var atlasTexture:Texture = Texture.fromBitmapData(atlasBitmapData, false, false, ATLAS_SCALE_FACTOR);
			atlasTexture.root.onRestore = this.atlasTexture_onRestore;
			atlasBitmapData.dispose();
			this.atlas = new TextureAtlas(atlasTexture, XML(new ATLAS_XML()));
		}

		/**
		 * @private
		 */
		protected function atlasTexture_onRestore():void
		{
			var atlasBitmapData:BitmapData = Bitmap(new ATLAS_BITMAP()).bitmapData;
			this.atlas.texture.root.uploadBitmapData(atlasBitmapData);
			atlasBitmapData.dispose();
		}
	}
}


================================================
FILE: themes/MetalWorksDesktopTheme/source/feathers/themes/MetalWorksDesktopThemeWithAssetManager.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import feathers.events.FeathersEventType;

	import starling.assets.AssetManager;
	import starling.core.Starling;
	import starling.events.Event;

	/**
	 * @copy feathers.themes.IAsyncTheme#event:complete
	 *
	 * @eventType starling.events.Event.COMPLETE
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * Dispatched when the theme's assets fail to load due to an error.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The error string.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.ERROR
	 */
	[Event(name="error",type="starling.events.Event")]

	/**
	 * The "Metal Works" theme for desktop Feathers apps.
	 *
	 * <p>This version of the theme requires loading assets at runtime. To use
	 * embedded assets, see <code>MetalWorksDesktopTheme</code> instead.</p>
	 *
	 * <p>To use this theme, the following files must be included when packaging
	 * your app:</p>
	 * <ul>
	 *     <li>images/metalworks_desktop.png</li>
	 *     <li>images/metalworks_desktop.xml</li>
	 * </ul>
	 *
	 * @see http://feathersui.com/help/theme-assets.html
	 */
	public class MetalWorksDesktopThemeWithAssetManager extends BaseMetalWorksDesktopTheme implements IAsyncTheme
	{
		/**
		 * @private
		 * The name of the texture atlas in the asset manager.
		 */
		protected static const ATLAS_NAME:String = "metalworks_desktop";

		/**
		 * @private
		 */
		protected static const ATLAS_SCALE_FACTOR:int = 2;

		/**
		 * Constructor.
		 * @param assetsBasePath The root folder of the assets.
		 * @param assetManager An optional pre-created AssetManager. The scaleFactor property must be equal to Starling.contentScaleFactor. To load assets with a different scale factor, use multiple AssetManager instances.
		 */
		public function MetalWorksDesktopThemeWithAssetManager(assetsBasePath:String = "./", assetManager:AssetManager = null)
		{
			this.loadAssets(assetsBasePath, assetManager);
		}

		/**
		 * @private
		 * The paths to each of the assets, relative to the base path.
		 */
		protected var assetPaths:Vector.<String> = new <String>
		[
			"images/" + ATLAS_NAME + ".xml",
			"images/" + ATLAS_NAME + ".png"
		];

		/**
		 * @private
		 */
		protected var assetManager:AssetManager;

		/**
		 * @private
		 */
		protected var isComplete:Boolean = false;

		/**
		 * @private
		 */
		override public function dispose():void
		{
			super.dispose();
			if(this.assetManager)
			{
				this.assetManager.removeTextureAtlas(ATLAS_NAME);
				this.assetManager = null;
			}
		}

		/**
		 * @copy feathers.themes.IAsyncTheme#isCompleteForStarling()
		 */
		public function isCompleteForStarling(starling:Starling):Boolean
		{
			return this.isComplete;
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this.initializeTextureAtlas();
			super.initialize();
		}

		/**
		 * @private
		 */
		protected function initializeTextureAtlas():void
		{
			this.atlas = this.assetManager.getTextureAtlas(ATLAS_NAME);
		}

		/**
		 * @private
		 */
		protected function loadAssets(assetsBasePath:String, assetManager:AssetManager):void
		{
			var oldScaleFactor:Number = -1;
			if(assetManager)
			{
				oldScaleFactor = assetManager.textureOptions.scale;
				assetManager.textureOptions.scale = ATLAS_SCALE_FACTOR;
			}
			else
			{
				assetManager = new AssetManager(ATLAS_SCALE_FACTOR);
			}
			this.assetManager = assetManager;
			//add a trailing slash, if needed
			if(assetsBasePath.lastIndexOf("/") != assetsBasePath.length - 1)
			{
				assetsBasePath += "/";
			}
			var assetPaths:Vector.<String> = this.assetPaths;
			var assetCount:int = assetPaths.length;
			for(var i:int = 0; i < assetCount; i++)
			{
				var asset:String = assetPaths[i];
				this.assetManager.enqueue(assetsBasePath + asset);
			}
			if(oldScaleFactor != -1)
			{
				//restore the old scale factor, just in case
				this.assetManager.textureOptions.scale = oldScaleFactor;
			}
			this.assetManager.loadQueue(assetManager_onComplete, assetManager_onError);
		}

		/**
		 * @private
		 */
		protected function assetManager_onComplete():void
		{
			this.initialize();
			this.isComplete = true;
			this.dispatchEventWith(Event.COMPLETE, false, Starling.current);
		}

		/**
		 * @private
		 */
		protected function assetManager_onError(error:String):void
		{
			this.dispatchEventWith(FeathersEventType.ERROR, false, error);
		}
	}
}



================================================
FILE: themes/MetalWorksMobileTheme/README.md
================================================
# Metal Works Mobile Theme for Feathers

This [Feathers](http://feathersui.com/) theme for mobile devices combines an industrial aesthetic with bold orange highlights.

## Original Artwork

This theme's texture atlas was exported from Adobe Animate CC. To modify colors and other properties, or to add new skins to the texture atlas, [download the source FLA file](http://feathersui.com/help/theme-sources.html) from the Feathers website.

## Credits

Created exclusively for Feathers by [Josh Tynjala](https://joshblog.net/). Uses the open source font [Source Sans Pro](https://github.com/adobe/Source-Sans-Pro) created by Adobe Systems Incorporated.

## Preview

The Metal Works Mobile Theme is used in the [Feathers Components Explorer](http://feathersui.com/examples/components-explorer/) example.

================================================
FILE: themes/MetalWorksMobileTheme/assets/images/metalworks_mobile.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<TextureAtlas imagePath="metalworks_mobile.png">
	<!-- Created with Adobe Animate version 18.0.2.126 -->
	<!-- http://www.adobe.com/products/animate.html -->
	<SubTexture name="back-button-disabled-skin0000" x="395" y="178" width="37" height="56" pivotX="0.1" pivotY="0"/>
	<SubTexture name="back-button-down-skin0000" x="163" y="356" width="37" height="56" pivotX="0.1" pivotY="0"/>
	<SubTexture name="back-button-up-skin0000" x="424" y="121" width="37" height="56" pivotX="0.1" pivotY="0"/>
	<SubTexture name="background-danger-border-skin0000" x="471" y="212" width="10" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="background-dark-border-skin0000" x="69" y="475" width="10" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="background-disabled-skin0000" x="130" y="489" width="18" height="18" pivotX="0" pivotY="0"/>
	<SubTexture name="background-focused-skin0000" x="149" y="489" width="18" height="18" pivotX="0" pivotY="0"/>
	<SubTexture name="background-inset-danger-skin0000" x="459" y="473" width="18" height="18" pivotX="0" pivotY="0"/>
	<SubTexture name="background-inset-disabled-skin0000" x="407" y="466" width="18" height="18" pivotX="0" pivotY="0"/>
	<SubTexture name="background-inset-skin0000" x="111" y="489" width="18" height="18" pivotX="0" pivotY="0"/>
	<SubTexture name="background-light-border-skin0000" x="374" y="356" width="10" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="background-skin0000" x="92" y="489" width="18" height="18" pivotX="0" pivotY="0"/>
	<SubTexture name="button-disabled-skin0000" x="270" y="455" width="18" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="button-down-skin0000" x="289" y="455" width="18" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="button-up-skin0000" x="251" y="455" width="18" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="call-to-action-button-down-skin0000" x="232" y="455" width="18" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="call-to-action-button-up-skin0000" x="308" y="455" width="18" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-arrow-bottom-skin0000" x="163" y="413" width="40" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-arrow-left-skin0000" x="485" y="296" width="26" height="40" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-arrow-right-skin0000" x="485" y="254" width="26" height="41" pivotX="0.05" pivotY="0"/>
	<SubTexture name="callout-arrow-top-skin0000" x="273" y="401" width="40" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="check-disabled-icon0000" x="35" y="475" width="33" height="33" pivotX="-0.05" pivotY="-0.05"/>
	<SubTexture name="check-down-icon0000" x="204" y="413" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="check-selected-disabled-icon0000" x="1" y="475" width="33" height="33" pivotX="-0.05" pivotY="-0.05"/>
	<SubTexture name="check-selected-down-icon0000" x="374" y="409" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="check-selected-up-icon0000" x="422" y="367" width="33" height="33" pivotX="-0.05" pivotY="-0.05"/>
	<SubTexture name="check-up-icon0000" x="471" y="178" width="33" height="33" pivotX="-0.05" pivotY="-0.05"/>
	<SubTexture name="danger-button-down-skin0000" x="490" y="337" width="18" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-button-up-skin0000" x="355" y="401" width="18" height="57" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-arrow-bottom-skin0000" x="314" y="401" width="40" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-arrow-left-skin0000" x="172" y="440" width="26" height="40" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-arrow-right-skin0000" x="485" y="212" width="26" height="41" pivotX="0.05" pivotY="0"/>
	<SubTexture name="danger-callout-arrow-top-skin0000" x="273" y="428" width="40" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-column-drop-indicator-skin0000" x="491" y="436" width="6" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-column-resize-skin0000" x="491" y="436" width="6" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-divider-skin0000" x="482" y="280" width="2" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-sort-ascending-icon0000" x="456" y="492" width="17" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-sort-descending-icon0000" x="438" y="490" width="17" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-vertical-divider-skin0000" x="404" y="473" width="2" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="drag-handle-icon0000" x="374" y="442" width="32" height="30" pivotX="0" pivotY="0"/>
	<SubTexture name="first-inset-item-renderer-selected-up-skin0000" x="475" y="1" width="30" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="first-inset-item-renderer-up-skin0000" x="364" y="178" width="30" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="focus-indicator-skin0000" x="69" y="489" width="22" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="forward-button-disabled-skin0000" x="201" y="356" width="37" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="forward-button-down-skin0000" x="433" y="178" width="37" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="forward-button-up-skin0000" x="462" y="121" width="37" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="full-screen-toggle-button-enter-down-icon0000" x="284" y="356" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="full-screen-toggle-button-enter-up-icon0000" x="239" y="356" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="full-screen-toggle-button-exit-down-icon0000" x="329" y="356" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="full-screen-toggle-button-exit-up-icon0000" x="395" y="235" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="grouped-list-header-background-skin0000" x="498" y="436" width="10" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="header-background-skin0000" x="1" y="1" width="260" height="132" pivotX="0" pivotY="0"/>
	<SubTexture name="header-popup-background-skin0000" x="1" y="134" width="260" height="132" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-decrement-button-disabled-icon0000" x="505" y="188" width="6" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-decrement-button-icon0000" x="505" y="197" width="6" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-increment-button-disabled-icon0000" x="505" y="179" width="6" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-increment-button-icon0000" x="404" y="502" width="6" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-simple-scroll-bar-thumb-skin0000" x="168" y="498" width="24" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="inset-item-renderer-selected-up-skin0000" x="426" y="401" width="10" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="inset-item-renderer-up-skin0000" x="437" y="401" width="10" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-drill-down-accessory-icon0000" x="346" y="459" width="17" height="25" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-drill-down-accessory-selected-icon0000" x="352" y="485" width="17" height="25" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-selected-up-skin0000" x="505" y="90" width="6" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-up-skin0000" x="484" y="398" width="6" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="last-inset-item-renderer-selected-up-skin0000" x="265" y="267" width="30" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="last-inset-item-renderer-up-skin0000" x="296" y="267" width="30" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="list-background-skin0000" x="404" y="485" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="mute-toggle-button-loud-down-icon0000" x="434" y="280" width="47" height="41" pivotX="0" pivotY="0"/>
	<SubTexture name="mute-toggle-button-loud-up-icon0000" x="389" y="325" width="47" height="41" pivotX="0" pivotY="0"/>
	<SubTexture name="mute-toggle-button-muted-down-icon0000" x="437" y="322" width="47" height="41" pivotX="0" pivotY="0"/>
	<SubTexture name="mute-toggle-button-muted-up-icon0000" x="374" y="367" width="47" height="41" pivotX="0" pivotY="0"/>
	<SubTexture name="overlay-play-pause-toggle-button-play-down-icon0000" x="1" y="267" width="161" height="176" pivotX="0" pivotY="0"/>
	<SubTexture name="overlay-play-pause-toggle-button-play-up-icon0000" x="262" y="1" width="161" height="176" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-disabled-symbol0000" x="254" y="435" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-selected-disabled-symbol0000" x="172" y="481" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-selected-symbol0000" x="370" y="490" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-symbol0000" x="370" y="473" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-button-disabled-icon0000" x="387" y="473" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-button-icon0000" x="387" y="490" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-button-selected-icon0000" x="237" y="435" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-item-renderer-selected-icon0000" x="199" y="479" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="play-pause-toggle-button-pause-down-icon0000" x="82" y="444" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="play-pause-toggle-button-pause-up-icon0000" x="389" y="280" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="play-pause-toggle-button-play-down-icon0000" x="127" y="444" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="play-pause-toggle-button-play-up-icon0000" x="440" y="235" width="44" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-disabled-icon0000" x="239" y="401" width="33" height="33" pivotX="-0.05" pivotY="-0.05"/>
	<SubTexture name="radio-selected-down-icon0000" x="199" y="446" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-up-icon0000" x="456" y="364" width="33" height="33" pivotX="-0.05" pivotY="-0.05"/>
	<SubTexture name="search-disabled-icon0000" x="491" y="394" width="20" height="20" pivotX="0" pivotY="0"/>
	<SubTexture name="search-icon0000" x="491" y="415" width="20" height="20" pivotX="0" pivotY="0"/>
	<SubTexture name="seek-slider-progress-skin0000" x="421" y="490" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="single-inset-item-renderer-selected-up-skin0000" x="327" y="267" width="30" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="single-inset-item-renderer-up-skin0000" x="358" y="267" width="30" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="spinner-list-selection-overlay-skin0000" x="448" y="401" width="10" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-disabled-skin0000" x="262" y="178" width="50" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-down-skin0000" x="163" y="267" width="50" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-selected-disabled-skin0000" x="424" y="1" width="50" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-selected-up-skin0000" x="214" y="267" width="50" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-up-skin0000" x="313" y="178" width="50" height="88" pivotX="0" pivotY="0"/>
	<SubTexture name="toggle-button-selected-disabled-skin0000" x="327" y="428" width="18" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="toggle-button-selected-up-skin0000" x="407" y="409" width="18" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-closed-icon0000" x="459" y="398" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-closed-selected-icon0000" x="459" y="423" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-open-icon0000" x="327" y="485" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-open-selected-icon0000" x="459" y="448" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-decrement-button-disabled-icon0000" x="346" y="449" width="8" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-decrement-button-icon0000" x="346" y="428" width="8" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-increment-button-disabled-icon0000" x="346" y="435" width="8" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-increment-button-icon0000" x="346" y="442" width="8" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-simple-scroll-bar-thumb-skin0000" x="314" y="428" width="10" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="volume-slider-maximum-track-skin0000" x="1" y="444" width="80" height="30" pivotX="0" pivotY="0"/>
	<SubTexture name="volume-slider-minimum-track-skin0000" x="424" y="90" width="80" height="30" pivotX="0" pivotY="0"/>
</TextureAtlas>


================================================
FILE: themes/MetalWorksMobileTheme/package-src.json
================================================
{
	"id": "feathersui_MetalWorksMobileTheme-source",
	"name": "Feathers UI Metal Works Mobile Theme",
	"url": "https://feathersui.com/as3-starling/",
	"docUrl": "https://feathersui/api-reference/",
	"description": "Metal Works mobile theme for Feathers UI (Starling version)",
	"type": "src",
	"version": "4.2.0",
	"sourceUrl": "https://github.com/feathersui/feathersui-starling/releases/download/v4.2.0/feathersui_MetalWorksMobileTheme-source_4.2.0.airpackage",
	"publishedAt": "2021-11-19T00:00:00.000Z",
	"dependencies": [
		"starling-source:2.x.x",
		"feathersui-source:4.2.x"
	],
	"parameters": [],
	"tags": ["theme", "feathers", "starling"],
	"status": "release",
	"license": {
	  "type": "Simplified BSD",
	  "url": "https://github.com/feathersui/feathersui-starling/blob/v4.2.0/LICENSE.md",
	  "public": true
	}
  }
  

================================================
FILE: themes/MetalWorksMobileTheme/package-swc.json
================================================
{
	"id": "feathersui_MetalWorksMobileTheme",
	"name": "Feathers UI Metal Works Mobile Theme",
	"url": "https://feathersui.com/as3-starling/",
	"docUrl": "https://feathersui/api-reference/",
	"description": "Metal Works mobile theme for Feathers UI (Starling version)",
	"type": "swc",
	"version": "4.2.0",
	"sourceUrl": "https://github.com/feathersui/feathersui-starling/releases/download/v4.2.0/feathersui_MetalWorksMobileTheme_4.2.0.airpackage",
	"publishedAt": "2021-11-19T00:00:00.000Z",
	"dependencies": [
		"starling:2.x.x",
		"feathersui:4.2.x"
	],
	"parameters": [],
	"tags": ["theme", "feathers", "starling"],
	"status": "release",
	"license": {
	  "type": "Simplified BSD",
	  "url": "https://github.com/feathersui/feathersui-starling/blob/v4.2.0/LICENSE.md",
	  "public": true
	}
  }
  

================================================
FILE: themes/MetalWorksMobileTheme/source/feathers/themes/BaseMetalWorksMobileTheme.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import feathers.controls.Alert;
	import feathers.controls.AutoComplete;
	import feathers.controls.Button;
	import feathers.controls.ButtonGroup;
	import feathers.controls.ButtonState;
	import feathers.controls.Callout;
	import feathers.controls.Check;
	import feathers.controls.DateTimeSpinner;
	import feathers.controls.Drawers;
	import feathers.controls.GroupedList;
	import feathers.controls.Header;
	import feathers.controls.ImageLoader;
	import feathers.controls.ItemRendererLayoutOrder;
	import feathers.controls.Label;
	import feathers.controls.LayoutGroup;
	import feathers.controls.List;
	import feathers.controls.NumericStepper;
	import feathers.controls.PageIndicator;
	import feathers.controls.Panel;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.controls.ProgressBar;
	import feathers.controls.Radio;
	import feathers.controls.ScrollContainer;
	import feathers.controls.ScrollScreen;
	import feathers.controls.ScrollText;
	import feathers.controls.Scroller;
	import feathers.controls.SimpleScrollBar;
	import feathers.controls.Slider;
	import feathers.controls.SpinnerList;
	import feathers.controls.StepperButtonLayoutMode;
	import feathers.controls.TabBar;
	import feathers.controls.TextArea;
	import feathers.controls.TextCallout;
	import feathers.controls.TextInput;
	import feathers.controls.TextInputState;
	import feathers.controls.ToggleButton;
	import feathers.controls.ToggleSwitch;
	import feathers.controls.TrackLayoutMode;
	import feathers.controls.Tree;
	import feathers.controls.popups.BottomDrawerPopUpContentManager;
	import feathers.controls.popups.CalloutPopUpContentManager;
	import feathers.controls.renderers.BaseDefaultItemRenderer;
	import feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer;
	import feathers.controls.renderers.DefaultGroupedListItemRenderer;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.DefaultTreeItemRenderer;
	import feathers.controls.text.ITextEditorViewPort;
	import feathers.controls.text.StageTextTextEditor;
	import feathers.controls.text.TextBlockTextEditor;
	import feathers.controls.text.TextBlockTextRenderer;
	import feathers.controls.text.TextFieldTextEditorViewPort;
	import feathers.core.FeathersControl;
	import feathers.core.ITextEditor;
	import feathers.core.ITextRenderer;
	import feathers.core.PopUpManager;
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.RelativePosition;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.media.FullScreenToggleButton;
	import feathers.media.MuteToggleButton;
	import feathers.media.PlayPauseToggleButton;
	import feathers.media.SeekSlider;
	import feathers.media.VolumeSlider;
	import feathers.skins.ImageSkin;
	import feathers.system.DeviceCapabilities;

	import flash.geom.Rectangle;

	import starling.display.DisplayObject;
	import starling.display.Image;
	import starling.display.Quad;
	import starling.text.TextFormat;
	import starling.textures.Texture;
	import starling.textures.TextureAtlas;
	import feathers.core.FocusManager;
	import starling.display.Stage;
	import feathers.controls.DataGrid;
	import feathers.controls.renderers.DefaultDataGridHeaderRenderer;
	import feathers.controls.renderers.DefaultDataGridCellRenderer;
	import feathers.controls.Toast;
	import feathers.controls.AutoSizeMode;
	import starling.display.DisplayObjectContainer;

	/**
	 * The base class for the "Metal Works" theme for mobile Feathers apps.
	 * Handles everything except asset loading, which is left to subclasses.
	 *
	 * @see MetalWorksMobileTheme
	 * @see MetalWorksMobileThemeWithAssetManager
	 */
	public class BaseMetalWorksMobileTheme extends StyleNameFunctionTheme
	{
		[Embed(source="/../assets/fonts/SourceSansPro-Regular.ttf",fontFamily="SourceSansPro",fontWeight="normal",mimeType="application/x-font",embedAsCFF="true")]
		protected static const SOURCE_SANS_PRO_REGULAR:Class;

		[Embed(source="/../assets/fonts/SourceSansPro-Semibold.ttf",fontFamily="SourceSansPro",fontWeight="bold",mimeType="application/x-font",embedAsCFF="true")]
		protected static const SOURCE_SANS_PRO_SEMIBOLD:Class;

		/**
		 * The name of the embedded font used by controls in this theme. Comes
		 * in normal and bold weights.
		 */
		public static const FONT_NAME:String = "SourceSansPro";

		/**
		 * The stack of fonts to use for controls that don't use embedded fonts.
		 */
		public static const FONT_NAME_STACK:String = "Source Sans Pro,Helvetica,_sans";

		protected static const PRIMARY_BACKGROUND_COLOR:uint = 0x4a4137;
		protected static const LIGHT_TEXT_COLOR:uint = 0xe5e5e5;
		protected static const DARK_TEXT_COLOR:uint = 0x1a1816;
		protected static const SELECTED_TEXT_COLOR:uint = 0xff9900;
		protected static const LIGHT_DISABLED_TEXT_COLOR:uint = 0x8a8a8a;
		protected static const DARK_DISABLED_TEXT_COLOR:uint = 0x383430;
		protected static const LIST_BACKGROUND_COLOR:uint = 0x383430;
		protected static const GROUPED_LIST_HEADER_BACKGROUND_COLOR:uint = 0x2e2a26;
		protected static const GROUPED_LIST_FOOTER_BACKGROUND_COLOR:uint = 0x2e2a26;
		protected static const MODAL_OVERLAY_COLOR:uint = 0x29241e;
		protected static const MODAL_OVERLAY_ALPHA:Number = 0.8;
		protected static const DRAWER_OVERLAY_COLOR:uint = 0x29241e;
		protected static const DRAWER_OVERLAY_ALPHA:Number = 0.4;
		protected static const VIDEO_OVERLAY_COLOR:uint = 0x1a1816;
		protected static const VIDEO_OVERLAY_ALPHA:Number = 0.2;
		protected static const DATA_GRID_COLUMN_OVERLAY_COLOR:uint = 0x383430;
		protected static const DATA_GRID_COLUMN_OVERLAY_ALPHA:Number = 0.4;

		protected static const DEFAULT_BACKGROUND_SCALE9_GRID:Rectangle = new Rectangle(4, 4, 1, 1);
		protected static const BUTTON_SCALE9_GRID:Rectangle = new Rectangle(4, 4, 1, 20);
		protected static const SMALL_BACKGROUND_SCALE9_GRID:Rectangle = new Rectangle(2, 2, 1, 1);
		protected static const BACK_BUTTON_SCALE9_GRID:Rectangle = new Rectangle(13, 0, 1, 28);
		protected static const FORWARD_BUTTON_SCALE9_GRID:Rectangle = new Rectangle(3, 0, 1, 28);
		protected static const ITEM_RENDERER_SCALE9_GRID:Rectangle = new Rectangle(1, 1, 1, 42);
		protected static const INSET_ITEM_RENDERER_MIDDLE_SCALE9_GRID:Rectangle = new Rectangle(2, 2, 1, 40);
		protected static const INSET_ITEM_RENDERER_FIRST_SCALE9_GRID:Rectangle = new Rectangle(7, 7, 1, 35);
		protected static const INSET_ITEM_RENDERER_LAST_SCALE9_GRID:Rectangle = new Rectangle(7, 2, 1, 35);
		protected static const INSET_ITEM_RENDERER_SINGLE_SCALE9_GRID:Rectangle = new Rectangle(7, 7, 1, 30);
		protected static const TAB_SCALE9_GRID:Rectangle = new Rectangle(11, 11, 1, 22);
		protected static const SPINNER_LIST_SELECTION_OVERLAY_SCALE9_GRID:Rectangle = new Rectangle(2, 6, 1, 32);
		protected static const HORIZONTAL_SCROLL_BAR_THUMB_SCALE9_GRID:Rectangle = new Rectangle(4, 0, 4, 5);
		protected static const VERTICAL_SCROLL_BAR_THUMB_SCALE9_GRID:Rectangle = new Rectangle(0, 4, 5, 4);
		protected static const FOCUS_INDICATOR_SCALE_9_GRID:Rectangle = new Rectangle(5, 5, 1, 1);
		protected static const DATA_GRID_HEADER_DIVIDER_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 2, 4);
		protected static const DATA_GRID_VERTICAL_DIVIDER_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 1, 4);
		protected static const DATA_GRID_COLUMN_RESIZE_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 3, 28);
		protected static const DATA_GRID_COLUMN_DROP_INDICATOR_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 3, 28);

		protected static const HEADER_SKIN_TEXTURE_REGION:Rectangle = new Rectangle(1, 1, 128, 64);
		protected static const TAB_SKIN_TEXTURE_REGION:Rectangle = new Rectangle(1, 0, 22, 44);

		/**
		 * @private
		 * The theme's custom style name for item renderers in a SpinnerList.
		 */
		protected static const THEME_STYLE_NAME_SPINNER_LIST_ITEM_RENDERER:String = "metal-works-mobile-spinner-list-item-renderer";

		/**
		 * @private
		 * The theme's custom style name for item renderers in a PickerList.
		 */
		protected static const THEME_STYLE_NAME_TABLET_PICKER_LIST_ITEM_RENDERER:String = "metal-works-mobile-tablet-picker-list-item-renderer";

		/**
		 * @private
		 * The theme's custom style name for buttons in an Alert's button group.
		 */
		protected static const THEME_STYLE_NAME_ALERT_BUTTON_GROUP_BUTTON:String = "metal-works-mobile-alert-button-group-button";

		/**
		 * @private
		 * The theme's custom style name for the thumb of a horizontal SimpleScrollBar.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SIMPLE_SCROLL_BAR_THUMB:String = "metal-works-mobile-horizontal-simple-scroll-bar-thumb";

		/**
		 * @private
		 * The theme's custom style name for the thumb of a vertical SimpleScrollBar.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SIMPLE_SCROLL_BAR_THUMB:String = "metal-works-mobile-vertical-simple-scroll-bar-thumb";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a horizontal slider.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK:String = "metal-works-mobile-horizontal-slider-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the maximum track of a horizontal slider.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SLIDER_MAXIMUM_TRACK:String = "metal-works-mobile-horizontal-slider-maximum-track";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a vertical slider.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK:String = "metal-works-mobile-vertical-slider-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the maximum track of a vertical slider.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SLIDER_MAXIMUM_TRACK:String = "metal-works-mobile-vertical-slider-maximum-track";

		/**
		 * @private
		 * The theme's custom style name for the item renderer of the DateTimeSpinner's SpinnerLists.
		 */
		protected static const THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER:String = "metal-works-mobile-date-time-spinner-list-item-renderer";

		/**
		 * @private
		 * The theme's custom style name for the action buttons of a toast.
		 */
		protected static const THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON:String = "metal-works-mobile-toast-actions-button";

		/**
		 * The default global text renderer factory for this theme creates a
		 * TextBlockTextRenderer.
		 */
		protected static function textRendererFactory():ITextRenderer
		{
			return new TextBlockTextRenderer();
		}

		/**
		 * The default global text editor factory for this theme creates a
		 * StageTextTextEditor.
		 */
		protected static function textEditorFactory():ITextEditor
		{
			return new StageTextTextEditor();
		}

		/**
		 * The text editor factory for a TextArea creates a
		 * TextFieldTextEditorViewPort.
		 */
		protected static function textAreaTextEditorFactory():ITextEditorViewPort
		{
			return new TextFieldTextEditorViewPort();
		}

		/**
		 * The text editor factory for a NumericStepper creates a
		 * TextBlockTextEditor.
		 */
		protected static function stepperTextEditorFactory():TextBlockTextEditor
		{
			//we're only using this text editor in the NumericStepper because
			//isEditable is false on the TextInput. this text editor is not
			//suitable for mobile use if the TextInput needs to be editable
			//because it can't use the soft keyboard or other mobile-friendly UI
			return new TextBlockTextEditor();
		}

		/**
		 * The pop-up factory for a PickerList creates a SpinnerList.
		 */
		protected static function pickerListSpinnerListFactory():SpinnerList
		{
			return new SpinnerList();
		}

		/**
		 * This theme's scroll bar type is SimpleScrollBar.
		 */
		protected static function scrollBarFactory():SimpleScrollBar
		{
			return new SimpleScrollBar();
		}

		protected static function popUpOverlayFactory():DisplayObject
		{
			var quad:Quad = new Quad(100, 100, MODAL_OVERLAY_COLOR);
			quad.alpha = MODAL_OVERLAY_ALPHA;
			return quad;
		}

		/**
		 * Constructor.
		 */
		public function BaseMetalWorksMobileTheme()
		{
			super();
		}

		/**
		 * A smaller font size for details.
		 */
		protected var smallFontSize:int = 10;

		/**
		 * A normal font size.
		 */
		protected var regularFontSize:int = 12;

		/**
		 * A larger font size for headers.
		 */
		protected var largeFontSize:int = 14;

		/**
		 * An extra large font size.
		 */
		protected var extraLargeFontSize:int = 18;

		/**
		 * The size, in pixels, of major regions in the grid. Used for sizing
		 * containers and larger UI controls.
		 */
		protected var gridSize:int = 44;

		/**
		 * The size, in pixels, of minor regions in the grid. Used for larger
		 * padding and gaps.
		 */
		protected var gutterSize:int = 12;

		/**
		 * The size, in pixels, of smaller padding and gaps within the major
		 * regions in the grid.
		 */
		protected var smallGutterSize:int = 8;

		/**
		 * The size, in pixels, of smaller padding and gaps within controls.
		 */
		protected var smallControlGutterSize:int = 6;

		/**
		 * The width, in pixels, of UI controls that span across multiple grid regions.
		 */
		protected var wideControlSize:int = 156;

		/**
		 * The size, in pixels, of a typical UI control.
		 */
		protected var controlSize:int = 28;

		/**
		 * The size, in pixels, of smaller UI controls.
		 */
		protected var smallControlSize:int = 12;

		/**
		 * The size, in pixels, of borders;
		 */
		protected var borderSize:int = 1;

		protected var popUpFillSize:int = 276;
		protected var calloutBackgroundMinSize:int = 12;
		protected var calloutArrowOverlapGap:int = -2;
		protected var scrollBarGutterSize:int = 2;
		protected var focusPaddingSize:int = -1;
		protected var tabFocusPaddingSize:int = 4;

		/**
		 * The font styles for standard-sized, light text.
		 */
		protected var lightFontStyles:TextFormat;

		/**
		 * The font styles for standard-sized, dark text.
		 */
		protected var darkFontStyles:TextFormat;

		/**
		 * The font styles for standard-sized, selected text.
		 */
		protected var selectedFontStyles:TextFormat;

		/**
		 * The font styles for standard-sized, light, disabled text.
		 */
		protected var lightDisabledFontStyles:TextFormat;

		/**
		 * The font styles for small, light text.
		 */
		protected var smallLightFontStyles:TextFormat;

		/**
		 * The font styles for small, light, disabled text.
		 */
		protected var smallLightDisabledFontStyles:TextFormat;

		/**
		 * The font styles for large, light text.
		 */
		protected var largeLightFontStyles:TextFormat;

		/**
		 * The font styles for large, dark text.
		 */
		protected var largeDarkFontStyles:TextFormat;

		/**
		 * The font styles for large, light, disabled text.
		 */
		protected var largeLightDisabledFontStyles:TextFormat;

		/**
		 * The font styles for light UI text.
		 */
		protected var lightUIFontStyles:TextFormat;

		/**
		 * The font styles for dark UI text.
		 */
		protected var darkUIFontStyles:TextFormat;

		/**
		 * The font styles for selected UI text.
		 */
		protected var selectedUIFontStyles:TextFormat;

		/**
		 * The font styles for light, centered UI text.
		 */
		protected var lightCenteredUIFontStyles:TextFormat;

		/**
		 * The font styles for light, centered, disabled UI text.
		 */
		protected var lightCenteredDisabledUIFontStyles:TextFormat;

		/**
		 * The font styles for light disabled UI text.
		 */
		protected var lightDisabledUIFontStyles:TextFormat;

		/**
		 * The font styles for dark, disabled UI text.
		 */
		protected var darkDisabledUIFontStyles:TextFormat;

		/**
		 * The font styles for large, light UI text.
		 */
		protected var largeLightUIFontStyles:TextFormat;

		/**
		 * The font styles for large, dark UI text.
		 */
		protected var largeDarkUIFontStyles:TextFormat;

		/**
		 * The font styles for large, selected UI text.
		 */
		protected var largeSelectedUIFontStyles:TextFormat;

		/**
		 * The font styles for large, light, disabled UI text.
		 */
		protected var largeLightUIDisabledFontStyles:TextFormat;

		/**
		 * The font styles for large, dark, disabled UI text.
		 */
		protected var largeDarkUIDisabledFontStyles:TextFormat;

		/**
		 * The font styles for extra-large, light UI text.
		 */
		protected var xlargeLightUIFontStyles:TextFormat;

		/**
		 * The font styles for extra-large, light, disabled UI text.
		 */
		protected var xlargeLightUIDisabledFontStyles:TextFormat;

		/**
		 * The font styles for standard-sized, light text for a text input.
		 */
		protected var lightInputFontStyles:TextFormat;

		/**
		 * The font styles for standard-sized, light, disabled text for a text input.
		 */
		protected var lightDisabledInputFontStyles:TextFormat;

		/**
		 * ScrollText uses TextField instead of FTE, so it has a separate TextFormat.
		 */
		protected var lightScrollTextFontStyles:TextFormat;

		/**
		 * ScrollText uses TextField instead of FTE, so it has a separate disabled TextFormat.
		 */
		protected var lightDisabledScrollTextFontStyles:TextFormat;

		/**
		 * The texture atlas that contains skins for this theme. This base class
		 * does not initialize this member variable. Subclasses are expected to
		 * load the assets somehow and set the <code>atlas</code> member
		 * variable before calling <code>initialize()</code>.
		 */
		protected var atlas:TextureAtlas;

		protected var focusIndicatorSkinTexture:Texture;
		protected var headerBackgroundSkinTexture:Texture;
		protected var popUpHeaderBackgroundSkinTexture:Texture;
		protected var backgroundSkinTexture:Texture;
		protected var backgroundDisabledSkinTexture:Texture;
		protected var backgroundInsetSkinTexture:Texture;
		protected var backgroundInsetDisabledSkinTexture:Texture;
		protected var backgroundInsetFocusedSkinTexture:Texture;
		protected var backgroundInsetDangerSkinTexture:Texture;
		protected var backgroundLightBorderSkinTexture:Texture;
		protected var backgroundDarkBorderSkinTexture:Texture;
		protected var backgroundDangerBorderSkinTexture:Texture;
		protected var buttonUpSkinTexture:Texture;
		protected var buttonDownSkinTexture:Texture;
		protected var buttonDisabledSkinTexture:Texture;
		protected var buttonSelectedUpSkinTexture:Texture;
		protected var buttonSelectedDisabledSkinTexture:Texture;
		protected var buttonCallToActionUpSkinTexture:Texture;
		protected var buttonCallToActionDownSkinTexture:Texture;
		protected var buttonDangerUpSkinTexture:Texture;
		protected var buttonDangerDownSkinTexture:Texture;
		protected var buttonBackUpSkinTexture:Texture;
		protected var buttonBackDownSkinTexture:Texture;
		protected var buttonBackDisabledSkinTexture:Texture;
		protected var buttonForwardUpSkinTexture:Texture;
		protected var buttonForwardDownSkinTexture:Texture;
		protected var buttonForwardDisabledSkinTexture:Texture;
		protected var pickerListButtonIconTexture:Texture;
		protected var pickerListButtonSelectedIconTexture:Texture;
		protected var pickerListButtonIconDisabledTexture:Texture;
		protected var tabUpSkinTexture:Texture;
		protected var tabDownSkinTexture:Texture;
		protected var tabDisabledSkinTexture:Texture;
		protected var tabSelectedUpSkinTexture:Texture;
		protected var tabSelectedDisabledSkinTexture:Texture;
		protected var pickerListItemSelectedIconTexture:Texture;
		protected var spinnerListSelectionOverlaySkinTexture:Texture;
		protected var radioUpIconTexture:Texture;
		protected var radioDownIconTexture:Texture;
		protected var radioDisabledIconTexture:Texture;
		protected var radioSelectedUpIconTexture:Texture;
		protected var radioSelectedDownIconTexture:Texture;
		protected var radioSelectedDisabledIconTexture:Texture;
		protected var checkUpIconTexture:Texture;
		protected var checkDownIconTexture:Texture;
		protected var checkDisabledIconTexture:Texture;
		protected var checkSelectedUpIconTexture:Texture;
		protected var checkSelectedDownIconTexture:Texture;
		protected var checkSelectedDisabledIconTexture:Texture;
		protected var pageIndicatorNormalSkinTexture:Texture;
		protected var pageIndicatorSelectedSkinTexture:Texture;
		protected var itemRendererUpSkinTexture:Texture;
		protected var itemRendererSelectedSkinTexture:Texture;
		protected var insetItemRendererUpSkinTexture:Texture;
		protected var insetItemRendererSelectedSkinTexture:Texture;
		protected var insetItemRendererFirstUpSkinTexture:Texture;
		protected var insetItemRendererFirstSelectedSkinTexture:Texture;
		protected var insetItemRendererLastUpSkinTexture:Texture;
		protected var insetItemRendererLastSelectedSkinTexture:Texture;
		protected var insetItemRendererSingleUpSkinTexture:Texture;
		protected var insetItemRendererSingleSelectedSkinTexture:Texture;
		protected var calloutTopArrowSkinTexture:Texture;
		protected var calloutRightArrowSkinTexture:Texture;
		protected var calloutBottomArrowSkinTexture:Texture;
		protected var calloutLeftArrowSkinTexture:Texture;
		protected var dangerCalloutTopArrowSkinTexture:Texture;
		protected var dangerCalloutRightArrowSkinTexture:Texture;
		protected var dangerCalloutBottomArrowSkinTexture:Texture;
		protected var dangerCalloutLeftArrowSkinTexture:Texture;
		protected var verticalScrollBarThumbSkinTexture:Texture;
		protected var horizontalScrollBarThumbSkinTexture:Texture;
		protected var searchIconTexture:Texture;
		protected var searchIconDisabledTexture:Texture;
		protected var listDrillDownAccessoryTexture:Texture;
		protected var listDrillDownAccessorySelectedTexture:Texture;
		protected var treeDisclosureOpenIconTexture:Texture;
		protected var treeDisclosureOpenSelectedIconTexture:Texture;
		protected var treeDisclosureClosedIconTexture:Texture;
		protected var treeDisclosureClosedSelectedIconTexture:Texture;
		protected var dataGridHeaderSortAscendingIconTexture:Texture;
		protected var dataGridHeaderSortDescendingIconTexture:Texture;
		protected var dataGridHeaderDividerSkinTexture:Texture;
		protected var dataGridVerticalDividerSkinTexture:Texture;
		protected var dataGridColumnResizeSkinTexture:Texture;
		protected var dataGridColumnDropIndicatorSkinTexture:Texture;
		protected var dragHandleIcon:Texture;
		
		//media textures
		protected var playPauseButtonPlayUpIconTexture:Texture;
		protected var playPauseButtonPlayDownIconTexture:Texture;
		protected var playPauseButtonPauseUpIconTexture:Texture;
		protected var playPauseButtonPauseDownIconTexture:Texture;
		protected var overlayPlayPauseButtonPlayUpIconTexture:Texture;
		protected var overlayPlayPauseButtonPlayDownIconTexture:Texture;
		protected var fullScreenToggleButtonEnterUpIconTexture:Texture;
		protected var fullScreenToggleButtonEnterDownIconTexture:Texture;
		protected var fullScreenToggleButtonExitUpIconTexture:Texture;
		protected var fullScreenToggleButtonExitDownIconTexture:Texture;
		protected var muteToggleButtonLoudUpIconTexture:Texture;
		protected var muteToggleButtonLoudDownIconTexture:Texture;
		protected var muteToggleButtonMutedUpIconTexture:Texture;
		protected var muteToggleButtonMutedDownIconTexture:Texture;
		protected var volumeSliderMinimumTrackSkinTexture:Texture;
		protected var volumeSliderMaximumTrackSkinTexture:Texture;
		protected var seekSliderProgressSkinTexture:Texture;

		/**
		 * Disposes the atlas before calling super.dispose()
		 */
		override public function dispose():void
		{
			if(this.atlas)
			{
				//if anything is keeping a reference to the texture, we don't
				//want it to keep a reference to the theme too.
				this.atlas.texture.root.onRestore = null;
				
				this.atlas.dispose();
				this.atlas = null;
			}

			//don't forget to call super.dispose()!
			super.dispose();
		}

		/**
		 * Initializes the theme. Expected to be called by subclasses after the
		 * assets have been loaded and the skin texture atlas has been created.
		 */
		protected function initialize():void
		{
			this.initializeFonts();
			this.initializeTextures();
			this.initializeGlobals();
			this.initializeStage();
			this.initializeStyleProviders();
		}

		/**
		 * Sets the stage background color.
		 */
		protected function initializeStage():void
		{
			this.starling.stage.color = PRIMARY_BACKGROUND_COLOR;
			this.starling.nativeStage.color = PRIMARY_BACKGROUND_COLOR;
		}

		/**
		 * Initializes global variables (not including global style providers).
		 */
		protected function initializeGlobals():void
		{
			FeathersControl.defaultTextRendererFactory = textRendererFactory;
			FeathersControl.defaultTextEditorFactory = textEditorFactory;

			PopUpManager.overlayFactory = popUpOverlayFactory;
			Callout.stagePadding = this.smallGutterSize;
			Toast.containerFactory = toastContainerFactory;

			var stage:Stage = this.starling.stage;
			FocusManager.setEnabledForStage(stage, true);
		}

		/**
		 * Initializes font sizes and formats.
		 */
		protected function initializeFonts():void
		{
			this.lightFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.darkFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, DARK_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.lightDisabledFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, LIGHT_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.selectedFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, SELECTED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);

			this.smallLightFontStyles = new TextFormat(FONT_NAME, this.smallFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.smallLightDisabledFontStyles = new TextFormat(FONT_NAME, this.smallFontSize, LIGHT_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);

			this.largeLightFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.largeDarkFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, DARK_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.largeLightDisabledFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, LIGHT_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);

			this.lightUIFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.lightUIFontStyles.bold = true;
			this.darkUIFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, DARK_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.darkUIFontStyles.bold = true;
			this.selectedUIFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, SELECTED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.selectedUIFontStyles.bold = true;
			this.lightDisabledUIFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, LIGHT_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.lightDisabledUIFontStyles.bold = true;
			this.darkDisabledUIFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, DARK_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.darkDisabledUIFontStyles.bold = true;
			this.lightCenteredUIFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.CENTER, VerticalAlign.TOP);
			this.lightCenteredUIFontStyles.bold = true;
			this.lightCenteredDisabledUIFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.CENTER, VerticalAlign.TOP);
			this.lightCenteredDisabledUIFontStyles.bold = true;

			this.largeLightUIFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.largeLightUIFontStyles.bold = true;
			this.largeDarkUIFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, DARK_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.largeDarkUIFontStyles.bold = true;
			this.largeSelectedUIFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, SELECTED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.largeSelectedUIFontStyles.bold = true;
			this.largeLightUIDisabledFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, LIGHT_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.largeLightUIDisabledFontStyles.bold = true;
			this.largeDarkUIDisabledFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, DARK_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.largeDarkUIDisabledFontStyles.bold = true;

			this.xlargeLightUIFontStyles = new TextFormat(FONT_NAME, this.extraLargeFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.xlargeLightUIFontStyles.bold = true;
			this.xlargeLightUIDisabledFontStyles = new TextFormat(FONT_NAME, this.extraLargeFontSize, LIGHT_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.xlargeLightUIDisabledFontStyles.bold = true;

			this.lightInputFontStyles = new TextFormat(FONT_NAME_STACK, this.regularFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.lightDisabledInputFontStyles = new TextFormat(FONT_NAME_STACK, this.regularFontSize, LIGHT_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);

			this.lightScrollTextFontStyles = new TextFormat(FONT_NAME_STACK, this.regularFontSize, LIGHT_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.lightDisabledScrollTextFontStyles = new TextFormat(FONT_NAME_STACK, this.regularFontSize, LIGHT_DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
		}

		/**
		 * Initializes the textures by extracting them from the atlas and
		 * setting up any scaling grids that are needed.
		 */
		protected function initializeTextures():void
		{
			this.focusIndicatorSkinTexture = this.atlas.getTexture("focus-indicator-skin0000");

			this.backgroundSkinTexture = this.atlas.getTexture("background-skin0000");
			this.backgroundDisabledSkinTexture = this.atlas.getTexture("background-disabled-skin0000");
			this.backgroundInsetSkinTexture = this.atlas.getTexture("background-inset-skin0000");
			this.backgroundInsetDisabledSkinTexture = this.atlas.getTexture("background-inset-disabled-skin0000");
			this.backgroundInsetFocusedSkinTexture = this.atlas.getTexture("background-focused-skin0000");
			this.backgroundInsetDangerSkinTexture = this.atlas.getTexture("background-inset-danger-skin0000");
			this.backgroundLightBorderSkinTexture = this.atlas.getTexture("background-light-border-skin0000");
			this.backgroundDarkBorderSkinTexture = this.atlas.getTexture("background-dark-border-skin0000");
			this.backgroundDangerBorderSkinTexture = this.atlas.getTexture("background-danger-border-skin0000");

			this.buttonUpSkinTexture = this.atlas.getTexture("button-up-skin0000");
			this.buttonDownSkinTexture = this.atlas.getTexture("button-down-skin0000");
			this.buttonDisabledSkinTexture = this.atlas.getTexture("button-disabled-skin0000");
			this.buttonSelectedUpSkinTexture = this.atlas.getTexture("toggle-button-selected-up-skin0000");
			this.buttonSelectedDisabledSkinTexture = this.atlas.getTexture("toggle-button-selected-disabled-skin0000");
			this.buttonCallToActionUpSkinTexture = this.atlas.getTexture("call-to-action-button-up-skin0000");
			this.buttonCallToActionDownSkinTexture = this.atlas.getTexture("call-to-action-button-down-skin0000");
			this.buttonDangerUpSkinTexture = this.atlas.getTexture("danger-button-up-skin0000");
			this.buttonDangerDownSkinTexture = this.atlas.getTexture("danger-button-down-skin0000");
			this.buttonBackUpSkinTexture = this.atlas.getTexture("back-button-up-skin0000");
			this.buttonBackDownSkinTexture = this.atlas.getTexture("back-button-down-skin0000");
			this.buttonBackDisabledSkinTexture = this.atlas.getTexture("back-button-disabled-skin0000");
			this.buttonForwardUpSkinTexture = this.atlas.getTexture("forward-button-up-skin0000");
			this.buttonForwardDownSkinTexture = this.atlas.getTexture("forward-button-down-skin0000");
			this.buttonForwardDisabledSkinTexture = this.atlas.getTexture("forward-button-disabled-skin0000");

			this.tabUpSkinTexture = Texture.fromTexture(this.atlas.getTexture("tab-up-skin0000"), TAB_SKIN_TEXTURE_REGION);
			this.tabDownSkinTexture = Texture.fromTexture(this.atlas.getTexture("tab-down-skin0000"), TAB_SKIN_TEXTURE_REGION);
			this.tabDisabledSkinTexture = Texture.fromTexture(this.atlas.getTexture("tab-disabled-skin0000"), TAB_SKIN_TEXTURE_REGION);
			this.tabSelectedUpSkinTexture = Texture.fromTexture(this.atlas.getTexture("tab-selected-up-skin0000"), TAB_SKIN_TEXTURE_REGION);
			this.tabSelectedDisabledSkinTexture = Texture.fromTexture(this.atlas.getTexture("tab-selected-disabled-skin0000"), TAB_SKIN_TEXTURE_REGION);

			this.pickerListButtonIconTexture = this.atlas.getTexture("picker-list-button-icon0000");
			this.pickerListButtonSelectedIconTexture = this.atlas.getTexture("picker-list-button-selected-icon0000");
			this.pickerListButtonIconDisabledTexture = this.atlas.getTexture("picker-list-button-disabled-icon0000");
			this.pickerListItemSelectedIconTexture = this.atlas.getTexture("picker-list-item-renderer-selected-icon0000");

			this.spinnerListSelectionOverlaySkinTexture = this.atlas.getTexture("spinner-list-selection-overlay-skin0000");

			this.checkUpIconTexture = this.atlas.getTexture("check-up-icon0000");
			this.checkDownIconTexture = this.atlas.getTexture("check-down-icon0000");
			this.checkDisabledIconTexture = this.atlas.getTexture("check-disabled-icon0000");
			this.checkSelectedUpIconTexture = this.atlas.getTexture("check-selected-up-icon0000");
			this.checkSelectedDownIconTexture = this.atlas.getTexture("check-selected-down-icon0000");
			this.checkSelectedDisabledIconTexture = this.atlas.getTexture("check-selected-disabled-icon0000");

			this.radioUpIconTexture = this.checkUpIconTexture;
			this.radioDownIconTexture = this.checkDownIconTexture;
			this.radioDisabledIconTexture = this.checkDisabledIconTexture;
			this.radioSelectedUpIconTexture = this.atlas.getTexture("radio-selected-up-icon0000");
			this.radioSelectedDownIconTexture = this.atlas.getTexture("radio-selected-down-icon0000");
			this.radioSelectedDisabledIconTexture = this.atlas.getTexture("radio-selected-disabled-icon0000");

			this.pageIndicatorSelectedSkinTexture = this.atlas.getTexture("page-indicator-selected-symbol0000");
			this.pageIndicatorNormalSkinTexture = this.atlas.getTexture("page-indicator-symbol0000");

			this.searchIconTexture = this.atlas.getTexture("search-icon0000");
			this.searchIconDisabledTexture = this.atlas.getTexture("search-disabled-icon0000");

			this.itemRendererUpSkinTexture = this.atlas.getTexture("item-renderer-up-skin0000");
			this.itemRendererSelectedSkinTexture = this.atlas.getTexture("item-renderer-selected-up-skin0000");
			this.insetItemRendererUpSkinTexture = this.atlas.getTexture("inset-item-renderer-up-skin0000");
			this.insetItemRendererSelectedSkinTexture = this.atlas.getTexture("inset-item-renderer-selected-up-skin0000");
			this.insetItemRendererFirstUpSkinTexture = this.atlas.getTexture("first-inset-item-renderer-up-skin0000");
			this.insetItemRendererFirstSelectedSkinTexture = this.atlas.getTexture("first-inset-item-renderer-selected-up-skin0000");
			this.insetItemRendererLastUpSkinTexture = this.atlas.getTexture("last-inset-item-renderer-up-skin0000");
			this.insetItemRendererLastSelectedSkinTexture = this.atlas.getTexture("last-inset-item-renderer-selected-up-skin0000");
			this.insetItemRendererSingleUpSkinTexture = this.atlas.getTexture("single-inset-item-renderer-up-skin0000");
			this.insetItemRendererSingleSelectedSkinTexture = this.atlas.getTexture("single-inset-item-renderer-selected-up-skin0000");

			this.dragHandleIcon = this.atlas.getTexture("drag-handle-icon0000");

			var headerBackgroundSkinTexture:Texture = this.atlas.getTexture("header-background-skin0000");
			var popUpHeaderBackgroundSkinTexture:Texture = this.atlas.getTexture("header-popup-background-skin0000");
			this.headerBackgroundSkinTexture = Texture.fromTexture(headerBackgroundSkinTexture, HEADER_SKIN_TEXTURE_REGION);
			this.popUpHeaderBackgroundSkinTexture = Texture.fromTexture(popUpHeaderBackgroundSkinTexture, HEADER_SKIN_TEXTURE_REGION);

			this.calloutTopArrowSkinTexture = this.atlas.getTexture("callout-arrow-top-skin0000");
			this.calloutRightArrowSkinTexture = this.atlas.getTexture("callout-arrow-right-skin0000");
			this.calloutBottomArrowSkinTexture = this.atlas.getTexture("callout-arrow-bottom-skin0000");
			this.calloutLeftArrowSkinTexture = this.atlas.getTexture("callout-arrow-left-skin0000");
			this.dangerCalloutTopArrowSkinTexture = this.atlas.getTexture("danger-callout-arrow-top-skin0000");
			this.dangerCalloutRightArrowSkinTexture = this.atlas.getTexture("danger-callout-arrow-right-skin0000");
			this.dangerCalloutBottomArrowSkinTexture = this.atlas.getTexture("danger-callout-arrow-bottom-skin0000");
			this.dangerCalloutLeftArrowSkinTexture = this.atlas.getTexture("danger-callout-arrow-left-skin0000");

			this.horizontalScrollBarThumbSkinTexture = this.atlas.getTexture("horizontal-simple-scroll-bar-thumb-skin0000");
			this.verticalScrollBarThumbSkinTexture = this.atlas.getTexture("vertical-simple-scroll-bar-thumb-skin0000");

			this.listDrillDownAccessoryTexture = this.atlas.getTexture("item-renderer-drill-down-accessory-icon0000");
			this.listDrillDownAccessorySelectedTexture = this.atlas.getTexture("item-renderer-drill-down-accessory-selected-icon0000");

			this.treeDisclosureOpenIconTexture = this.atlas.getTexture("tree-disclosure-open-icon0000");
			this.treeDisclosureOpenSelectedIconTexture = this.atlas.getTexture("tree-disclosure-open-selected-icon0000");
			this.treeDisclosureClosedIconTexture = this.atlas.getTexture("tree-disclosure-closed-icon0000");
			this.treeDisclosureClosedSelectedIconTexture = this.atlas.getTexture("tree-disclosure-closed-selected-icon0000");

			this.dataGridHeaderSortAscendingIconTexture = this.atlas.getTexture("data-grid-header-sort-ascending-icon0000");
			this.dataGridHeaderSortDescendingIconTexture = this.atlas.getTexture("data-grid-header-sort-descending-icon0000");
			this.dataGridHeaderDividerSkinTexture = this.atlas.getTexture("data-grid-header-divider-skin0000");
			this.dataGridVerticalDividerSkinTexture = this.atlas.getTexture("data-grid-vertical-divider-skin0000");
			this.dataGridColumnResizeSkinTexture = this.atlas.getTexture("data-grid-column-resize-skin0000");
			this.dataGridColumnDropIndicatorSkinTexture = this.atlas.getTexture("data-grid-column-drop-indicator-skin0000");
			
			this.playPauseButtonPlayUpIconTexture = this.atlas.getTexture("play-pause-toggle-button-play-up-icon0000");
			this.playPauseButtonPlayDownIconTexture = this.atlas.getTexture("play-pause-toggle-button-play-down-icon0000");
			this.playPauseButtonPauseUpIconTexture = this.atlas.getTexture("play-pause-toggle-button-pause-up-icon0000");
			this.playPauseButtonPauseDownIconTexture = this.atlas.getTexture("play-pause-toggle-button-pause-down-icon0000");
			this.overlayPlayPauseButtonPlayUpIconTexture = this.atlas.getTexture("overlay-play-pause-toggle-button-play-up-icon0000");
			this.overlayPlayPauseButtonPlayDownIconTexture = this.atlas.getTexture("overlay-play-pause-toggle-button-play-down-icon0000");
			this.fullScreenToggleButtonEnterUpIconTexture = this.atlas.getTexture("full-screen-toggle-button-enter-up-icon0000");
			this.fullScreenToggleButtonEnterDownIconTexture = this.atlas.getTexture("full-screen-toggle-button-enter-down-icon0000");
			this.fullScreenToggleButtonExitUpIconTexture = this.atlas.getTexture("full-screen-toggle-button-exit-up-icon0000");
			this.fullScreenToggleButtonExitDownIconTexture = this.atlas.getTexture("full-screen-toggle-button-exit-down-icon0000");
			this.muteToggleButtonMutedUpIconTexture = this.atlas.getTexture("mute-toggle-button-muted-up-icon0000");
			this.muteToggleButtonMutedDownIconTexture = this.atlas.getTexture("mute-toggle-button-muted-down-icon0000");
			this.muteToggleButtonLoudUpIconTexture = this.atlas.getTexture("mute-toggle-button-loud-up-icon0000");
			this.muteToggleButtonLoudDownIconTexture = this.atlas.getTexture("mute-toggle-button-loud-down-icon0000");
			this.volumeSliderMinimumTrackSkinTexture = this.atlas.getTexture("volume-slider-minimum-track-skin0000");
			this.volumeSliderMaximumTrackSkinTexture = this.atlas.getTexture("volume-slider-maximum-track-skin0000");
			this.seekSliderProgressSkinTexture = this.atlas.getTexture("seek-slider-progress-skin0000");
		}

		/**
		 * Sets global style providers for all components.
		 */
		protected function initializeStyleProviders():void
		{
			//alert
			this.getStyleProviderForClass(Alert).defaultStyleFunction = this.setAlertStyles;
			this.getStyleProviderForClass(ButtonGroup).setFunctionForStyleName(Alert.DEFAULT_CHILD_STYLE_NAME_BUTTON_GROUP, this.setAlertButtonGroupStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_ALERT_BUTTON_GROUP_BUTTON, this.setAlertButtonGroupButtonStyles);
			this.getStyleProviderForClass(Header).setFunctionForStyleName(Alert.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setPopUpHeaderStyles);

			//auto-complete
			this.getStyleProviderForClass(AutoComplete).defaultStyleFunction = this.setTextInputStyles;
			this.getStyleProviderForClass(List).setFunctionForStyleName(AutoComplete.DEFAULT_CHILD_STYLE_NAME_LIST, this.setDropDownListStyles);

			//button
			this.getStyleProviderForClass(Button).defaultStyleFunction = this.setButtonStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_CALL_TO_ACTION_BUTTON, this.setCallToActionButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_QUIET_BUTTON, this.setQuietButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_DANGER_BUTTON, this.setDangerButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON, this.setBackButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_FORWARD_BUTTON, this.setForwardButtonStyles);

			//button group
			this.getStyleProviderForClass(ButtonGroup).defaultStyleFunction = this.setButtonGroupStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ButtonGroup.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setButtonGroupButtonStyles);
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(ButtonGroup.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setButtonGroupButtonStyles);

			//callout
			this.getStyleProviderForClass(Callout).defaultStyleFunction = this.setCalloutStyles;

			//check
			this.getStyleProviderForClass(Check).defaultStyleFunction = this.setCheckStyles;

			//data grid
			this.getStyleProviderForClass(DataGrid).defaultStyleFunction = this.setDataGridStyles;
			this.getStyleProviderForClass(DefaultDataGridCellRenderer).defaultStyleFunction = this.setDataGridCellRendererStyles;
			this.getStyleProviderForClass(DefaultDataGridHeaderRenderer).defaultStyleFunction = this.setDataGridHeaderStyles;

			//date time spinner
			this.getStyleProviderForClass(DateTimeSpinner).defaultStyleFunction = this.setDateTimeSpinnerStyles;
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER, this.setDateTimeSpinnerListItemRendererStyles);

			//drawers
			this.getStyleProviderForClass(Drawers).defaultStyleFunction = this.setDrawersStyles;

			//grouped list
			this.getStyleProviderForClass(GroupedList).defaultStyleFunction = this.setGroupedListStyles;
			this.getStyleProviderForClass(GroupedList).setFunctionForStyleName(GroupedList.ALTERNATE_STYLE_NAME_INSET_GROUPED_LIST, this.setInsetGroupedListStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).defaultStyleFunction = this.setItemRendererStyles;
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_ITEM_RENDERER, this.setInsetGroupedListMiddleItemRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_FIRST_ITEM_RENDERER, this.setInsetGroupedListFirstItemRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_LAST_ITEM_RENDERER, this.setInsetGroupedListLastItemRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_SINGLE_ITEM_RENDERER, this.setInsetGroupedListSingleItemRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(DefaultGroupedListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN, this.setDrillDownItemRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(DefaultGroupedListItemRenderer.ALTERNATE_STYLE_NAME_CHECK, this.setCheckItemRendererStyles);

			//header
			this.getStyleProviderForClass(Header).defaultStyleFunction = this.setHeaderStyles;

			//header and footer renderers for grouped list
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).defaultStyleFunction = this.setGroupedListHeaderRendererStyles;
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).setFunctionForStyleName(GroupedList.DEFAULT_CHILD_STYLE_NAME_FOOTER_RENDERER, this.setGroupedListFooterRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).setFunctionForStyleName(GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_HEADER_RENDERER, this.setInsetGroupedListHeaderRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).setFunctionForStyleName(GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_FOOTER_RENDERER, this.setInsetGroupedListFooterRendererStyles);

			//labels
			this.getStyleProviderForClass(Label).defaultStyleFunction = this.setLabelStyles;
			this.getStyleProviderForClass(Label).setFunctionForStyleName(Label.ALTERNATE_STYLE_NAME_HEADING, this.setHeadingLabelStyles);
			this.getStyleProviderForClass(Label).setFunctionForStyleName(Label.ALTERNATE_STYLE_NAME_DETAIL, this.setDetailLabelStyles);

			//layout group
			this.getStyleProviderForClass(LayoutGroup).setFunctionForStyleName(LayoutGroup.ALTERNATE_STYLE_NAME_TOOLBAR, setToolbarLayoutGroupStyles);

			//list
			this.getStyleProviderForClass(List).defaultStyleFunction = this.setListStyles;
			this.getStyleProviderForClass(DefaultListItemRenderer).defaultStyleFunction = this.setListItemRendererStyles;
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(DefaultListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN, this.setDrillDownItemRendererStyles);
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(DefaultListItemRenderer.ALTERNATE_STYLE_NAME_CHECK, this.setCheckItemRendererStyles);

			//numeric stepper
			this.getStyleProviderForClass(NumericStepper).defaultStyleFunction = this.setNumericStepperStyles;
			this.getStyleProviderForClass(TextInput).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_TEXT_INPUT, this.setNumericStepperTextInputStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON, this.setNumericStepperButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON, this.setNumericStepperButtonStyles);

			//page indicator
			this.getStyleProviderForClass(PageIndicator).defaultStyleFunction = this.setPageIndicatorStyles;

			//panel
			this.getStyleProviderForClass(Panel).defaultStyleFunction = this.setPanelStyles;
			this.getStyleProviderForClass(Header).setFunctionForStyleName(Panel.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setPopUpHeaderStyles);

			//panel screen
			this.getStyleProviderForClass(PanelScreen).defaultStyleFunction = this.setPanelScreenStyles;
			this.getStyleProviderForClass(Header).setFunctionForStyleName(PanelScreen.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setPanelScreenHeaderStyles);

			//picker list (see also: list and item renderers)
			this.getStyleProviderForClass(PickerList).defaultStyleFunction = this.setPickerListStyles;
			this.getStyleProviderForClass(List).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_LIST, this.setPickerListPopUpListStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setPickerListButtonStyles);
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setPickerListButtonStyles);
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(THEME_STYLE_NAME_TABLET_PICKER_LIST_ITEM_RENDERER, this.setPickerListItemRendererStyles);

			//progress bar
			this.getStyleProviderForClass(ProgressBar).defaultStyleFunction = this.setProgressBarStyles;

			//radio
			this.getStyleProviderForClass(Radio).defaultStyleFunction = this.setRadioStyles;

			//scroll container
			this.getStyleProviderForClass(ScrollContainer).defaultStyleFunction = this.setScrollContainerStyles;
			this.getStyleProviderForClass(ScrollContainer).setFunctionForStyleName(ScrollContainer.ALTERNATE_STYLE_NAME_TOOLBAR, this.setToolbarScrollContainerStyles);

			//scroll screen
			this.getStyleProviderForClass(ScrollScreen).defaultStyleFunction = this.setScrollScreenStyles;

			//scroll text
			this.getStyleProviderForClass(ScrollText).defaultStyleFunction = this.setScrollTextStyles;

			//simple scroll bar
			this.getStyleProviderForClass(SimpleScrollBar).defaultStyleFunction = this.setSimpleScrollBarStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SIMPLE_SCROLL_BAR_THUMB, this.setHorizontalSimpleScrollBarThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SIMPLE_SCROLL_BAR_THUMB, this.setVerticalSimpleScrollBarThumbStyles);

			//slider
			this.getStyleProviderForClass(Slider).defaultStyleFunction = this.setSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Slider.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setSimpleButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK, this.setHorizontalSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SLIDER_MAXIMUM_TRACK, this.setHorizontalSliderMaximumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK, this.setVerticalSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SLIDER_MAXIMUM_TRACK, this.setVerticalSliderMaximumTrackStyles);

			//spinner list
			this.getStyleProviderForClass(SpinnerList).defaultStyleFunction = this.setSpinnerListStyles;
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(THEME_STYLE_NAME_SPINNER_LIST_ITEM_RENDERER, this.setSpinnerListItemRendererStyles);

			//tab bar
			this.getStyleProviderForClass(TabBar).defaultStyleFunction = this.setTabBarStyles;
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(TabBar.DEFAULT_CHILD_STYLE_NAME_TAB, this.setTabStyles);

			//text input
			this.getStyleProviderForClass(TextInput).defaultStyleFunction = this.setTextInputStyles;
			this.getStyleProviderForClass(TextInput).setFunctionForStyleName(TextInput.ALTERNATE_STYLE_NAME_SEARCH_TEXT_INPUT, this.setSearchTextInputStyles);
			this.getStyleProviderForClass(TextCallout).setFunctionForStyleName(TextInput.DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT, this.setTextInputErrorCalloutStyles);

			//text area
			this.getStyleProviderForClass(TextArea).defaultStyleFunction = this.setTextAreaStyles;
			this.getStyleProviderForClass(TextCallout).setFunctionForStyleName(TextArea.DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT, this.setTextAreaErrorCalloutStyles);

			//text callout
			this.getStyleProviderForClass(TextCallout).defaultStyleFunction = this.setTextCalloutStyles;

			//toast
			this.getStyleProviderForClass(Toast).defaultStyleFunction = this.setToastStyles;
			this.getStyleProviderForClass(ButtonGroup).setFunctionForStyleName(Toast.DEFAULT_CHILD_STYLE_NAME_ACTIONS, this.setToastActionsStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON, this.setToastActionsButtonStyles);

			//toggle button
			this.getStyleProviderForClass(ToggleButton).defaultStyleFunction = this.setButtonStyles;
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_QUIET_BUTTON, this.setQuietButtonStyles);

			//toggle switch
			this.getStyleProviderForClass(ToggleSwitch).defaultStyleFunction = this.setToggleSwitchStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setSimpleButtonStyles);
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setSimpleButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_ON_TRACK, this.setToggleSwitchTrackStyles);
			//we don't need a style function for the off track in this theme
			//the toggle switch layout uses a single track

			//tree
			this.getStyleProviderForClass(Tree).defaultStyleFunction = this.setTreeStyles;
			this.getStyleProviderForClass(DefaultTreeItemRenderer).defaultStyleFunction = this.setTreeItemRendererStyles;

			//media controls

			//play/pause toggle button
			this.getStyleProviderForClass(PlayPauseToggleButton).defaultStyleFunction = this.setPlayPauseToggleButtonStyles;
			this.getStyleProviderForClass(PlayPauseToggleButton).setFunctionForStyleName(PlayPauseToggleButton.ALTERNATE_STYLE_NAME_OVERLAY_PLAY_PAUSE_TOGGLE_BUTTON, this.setOverlayPlayPauseToggleButtonStyles);

			//full screen toggle button
			this.getStyleProviderForClass(FullScreenToggleButton).defaultStyleFunction = this.setFullScreenToggleButtonStyles;

			//mute toggle button
			this.getStyleProviderForClass(MuteToggleButton).defaultStyleFunction = this.setMuteToggleButtonStyles;

			//seek slider
			this.getStyleProviderForClass(SeekSlider).defaultStyleFunction = this.setSeekSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SeekSlider.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setSeekSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SeekSlider.DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK, this.setSeekSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SeekSlider.DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK, this.setSeekSliderMaximumTrackStyles);

			//volume slider
			this.getStyleProviderForClass(VolumeSlider).defaultStyleFunction = this.setVolumeSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(VolumeSlider.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setVolumeSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(VolumeSlider.DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK, this.setVolumeSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(VolumeSlider.DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK, this.setVolumeSliderMaximumTrackStyles);
		}

		protected function pageIndicatorNormalSymbolFactory():DisplayObject
		{
			var symbol:ImageLoader = new ImageLoader();
			symbol.source = this.pageIndicatorNormalSkinTexture;
			return symbol;
		}

		protected function pageIndicatorSelectedSymbolFactory():DisplayObject
		{
			var symbol:ImageLoader = new ImageLoader();
			symbol.source = this.pageIndicatorSelectedSkinTexture;
			return symbol;
		}

		protected function dataGridHeaderDividerFactory():DisplayObject
		{
			var skin:ImageSkin = new ImageSkin(this.dataGridHeaderDividerSkinTexture);
			skin.scale9Grid = DATA_GRID_HEADER_DIVIDER_SCALE_9_GRID;
			skin.minTouchWidth = this.controlSize;
			return skin;
		}

		protected function dataGridVerticalDividerFactory():DisplayObject
		{
			var skin:ImageSkin = new ImageSkin(this.dataGridVerticalDividerSkinTexture);
			skin.scale9Grid = DATA_GRID_VERTICAL_DIVIDER_SCALE_9_GRID;
			return skin;
		}

		protected function toastContainerFactory():DisplayObjectContainer
		{
			var container:LayoutGroup = new LayoutGroup();
			container.autoSizeMode = AutoSizeMode.STAGE;

			var layout:VerticalLayout = new VerticalLayout();
			layout.verticalAlign = VerticalAlign.BOTTOM;
			if(DeviceCapabilities.isPhone())
			{
				layout.horizontalAlign = HorizontalAlign.JUSTIFY;
				layout.padding = this.smallGutterSize;
				layout.gap = this.smallGutterSize;
			}
			else
			{
				layout.horizontalAlign = HorizontalAlign.LEFT;
				layout.padding = this.gutterSize;
				layout.gap = this.gutterSize;
			}
			container.layout = layout;
			return container;
		}

	//-------------------------
	// Shared
	//-------------------------

		protected function setScrollerStyles(scroller:Scroller):void
		{
			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			scroller.focusIndicatorSkin = focusIndicatorSkin;
			scroller.focusPadding = 0;

			scroller.horizontalScrollBarFactory = scrollBarFactory;
			scroller.verticalScrollBarFactory = scrollBarFactory;
		}

		protected function setSimpleButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.hasLabelTextRenderer = false;

			button.minTouchWidth = this.gridSize;
			button.minTouchHeight = this.gridSize;
		}

		protected function setDropDownListStyles(list:List):void
		{
			var backgroundSkin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			backgroundSkin.scale9Grid = ITEM_RENDERER_SCALE9_GRID;
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			list.backgroundSkin = backgroundSkin;

			var layout:VerticalLayout = new VerticalLayout();
			layout.horizontalAlign = HorizontalAlign.JUSTIFY;
			layout.maxRowCount = 4;
			list.layout = layout;
		}

	//-------------------------
	// Alert
	//-------------------------

		protected function setAlertStyles(alert:Alert):void
		{
			this.setScrollerStyles(alert);

			var backgroundSkin:Image = new Image(this.backgroundLightBorderSkinTexture);
			backgroundSkin.scale9Grid = SMALL_BACKGROUND_SCALE9_GRID;
			alert.backgroundSkin = backgroundSkin;

			alert.fontStyles = this.lightFontStyles.clone();

			alert.paddingTop = this.gutterSize;
			alert.paddingRight = this.gutterSize;
			alert.paddingBottom = this.smallGutterSize;
			alert.paddingLeft = this.gutterSize;
			alert.outerPadding = this.borderSize;
			alert.gap = this.smallGutterSize;
			alert.maxWidth = this.popUpFillSize;
			alert.maxHeight = this.popUpFillSize;
		}

		//see Panel section for Header styles

		protected function setAlertButtonGroupStyles(group:ButtonGroup):void
		{
			group.direction = Direction.HORIZONTAL;
			group.horizontalAlign = HorizontalAlign.CENTER;
			group.verticalAlign = VerticalAlign.JUSTIFY;
			group.distributeButtonSizes = false;
			group.gap = this.smallGutterSize;
			group.padding = this.smallGutterSize;
			group.customButtonStyleName = THEME_STYLE_NAME_ALERT_BUTTON_GROUP_BUTTON;
		}

		protected function setAlertButtonGroupButtonStyles(button:Button):void
		{
			this.setButtonStyles(button);

			var skin:ImageSkin = ImageSkin(button.defaultSkin);
			skin.minWidth = 2 * this.controlSize;
		}

	//-------------------------
	// Button
	//-------------------------

		protected function setBaseButtonStyles(button:Button):void
		{
			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;

			button.paddingTop = this.smallControlGutterSize;
			button.paddingBottom = this.smallControlGutterSize;
			button.paddingLeft = this.gutterSize;
			button.paddingRight = this.gutterSize;
			button.gap = this.smallControlGutterSize;
			button.minGap = this.smallControlGutterSize;
			button.minTouchWidth = this.gridSize;
			button.minTouchHeight = this.gridSize;
		}

		protected function setButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				skin.selectedTexture = this.buttonSelectedUpSkinTexture;
				skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.buttonSelectedDisabledSkinTexture);
			}
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;

			button.fontStyles = this.darkUIFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledUIFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setCallToActionButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonCallToActionUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonCallToActionDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.darkUIFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledUIFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setQuietButtonStyles(button:Button):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			button.defaultSkin = defaultSkin;

			var otherSkin:ImageSkin = new ImageSkin(null);
			otherSkin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			otherSkin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			button.downSkin = otherSkin;
			button.disabledSkin = otherSkin;
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				var toggleButton:ToggleButton = ToggleButton(button);
				otherSkin.selectedTexture = this.buttonSelectedUpSkinTexture;
				toggleButton.defaultSelectedSkin = otherSkin;
			}
			otherSkin.scale9Grid = BUTTON_SCALE9_GRID;
			otherSkin.width = this.controlSize;
			otherSkin.height = this.controlSize;
			otherSkin.minWidth = this.controlSize;
			otherSkin.minHeight = this.controlSize;

			button.fontStyles = this.lightUIFontStyles.clone();
			button.setFontStylesForState(ButtonState.DOWN, this.darkUIFontStyles.clone());
			button.setFontStylesForState(ButtonState.DISABLED, this.lightDisabledUIFontStyles.clone());
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				toggleButton.selectedFontStyles = this.darkUIFontStyles.clone();
				toggleButton.setFontStylesForState(ButtonState.DISABLED_AND_SELECTED, this.darkDisabledUIFontStyles.clone());
			}

			button.paddingTop = this.smallControlGutterSize;
			button.paddingBottom = this.smallControlGutterSize;
			button.paddingLeft = this.smallGutterSize;
			button.paddingRight = this.smallGutterSize;
			button.gap = this.smallControlGutterSize;
			button.minGap = this.smallControlGutterSize;
			button.minTouchWidth = this.gridSize;
			button.minTouchHeight = this.gridSize;
			
			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;
		}

		protected function setDangerButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonDangerUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDangerDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.darkUIFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledUIFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setBackButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonBackUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonBackDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonBackDisabledSkinTexture);
			skin.scale9Grid = BACK_BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.darkUIFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledUIFontStyles.clone();

			this.setBaseButtonStyles(button);

			button.paddingLeft = this.gutterSize + this.smallGutterSize;
		}

		protected function setForwardButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonForwardUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonForwardDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonForwardDisabledSkinTexture);
			skin.scale9Grid = FORWARD_BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.darkUIFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledUIFontStyles.clone();

			this.setBaseButtonStyles(button);

			button.paddingRight = this.gutterSize + this.smallGutterSize;
		}

	//-------------------------
	// ButtonGroup
	//-------------------------

		protected function setButtonGroupStyles(group:ButtonGroup):void
		{
			group.gap = this.smallGutterSize;
		}

		protected function setButtonGroupButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				skin.selectedTexture = this.buttonSelectedUpSkinTexture;
				skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.buttonSelectedDisabledSkinTexture);
			}
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.popUpFillSize;
			skin.height = this.gridSize;
			skin.minWidth = this.gridSize;
			skin.minHeight = this.gridSize;
			button.defaultSkin = skin;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;

			button.fontStyles = this.largeDarkUIFontStyles.clone();
			button.disabledFontStyles = this.largeDarkUIDisabledFontStyles.clone();

			button.paddingTop = this.smallGutterSize;
			button.paddingBottom = this.smallGutterSize;
			button.paddingLeft = this.gutterSize;
			button.paddingRight = this.gutterSize;
			button.gap = this.smallGutterSize;
			button.minGap = this.smallGutterSize;
			button.horizontalAlign = HorizontalAlign.CENTER;
			button.minTouchWidth = this.gridSize;
			button.minTouchHeight = this.gridSize;
		}

	//-------------------------
	// Callout
	//-------------------------

		protected function setCalloutStyles(callout:Callout):void
		{
			var backgroundSkin:Image = new Image(this.backgroundLightBorderSkinTexture);
			backgroundSkin.scale9Grid = SMALL_BACKGROUND_SCALE9_GRID;
			backgroundSkin.width = this.calloutBackgroundMinSize;
			backgroundSkin.height = this.calloutBackgroundMinSize;
			callout.backgroundSkin = backgroundSkin;

			var topArrowSkin:Image = new Image(this.calloutTopArrowSkinTexture);
			callout.topArrowSkin = topArrowSkin;
			callout.topArrowGap = this.calloutArrowOverlapGap;

			var rightArrowSkin:Image = new Image(this.calloutRightArrowSkinTexture);
			callout.rightArrowSkin = rightArrowSkin;
			callout.rightArrowGap = this.calloutArrowOverlapGap;

			var bottomArrowSkin:Image = new Image(this.calloutBottomArrowSkinTexture);
			callout.bottomArrowSkin = bottomArrowSkin;
			callout.bottomArrowGap = this.calloutArrowOverlapGap;

			var leftArrowSkin:Image = new Image(this.calloutLeftArrowSkinTexture);
			callout.leftArrowSkin = leftArrowSkin;
			callout.leftArrowGap = this.calloutArrowOverlapGap;

			callout.padding = this.smallGutterSize;
		}

		protected function setDangerCalloutStyles(callout:Callout):void
		{
			var backgroundSkin:Image = new Image(this.backgroundDangerBorderSkinTexture);
			backgroundSkin.scale9Grid = SMALL_BACKGROUND_SCALE9_GRID;
			backgroundSkin.width = this.calloutBackgroundMinSize;
			backgroundSkin.height = this.calloutBackgroundMinSize;
			callout.backgroundSkin = backgroundSkin;

			var topArrowSkin:Image = new Image(this.dangerCalloutTopArrowSkinTexture);
			callout.topArrowSkin = topArrowSkin;
			callout.topArrowGap = this.calloutArrowOverlapGap;

			var rightArrowSkin:Image = new Image(this.dangerCalloutRightArrowSkinTexture);
			callout.rightArrowSkin = rightArrowSkin;
			callout.rightArrowGap = this.calloutArrowOverlapGap;

			var bottomArrowSkin:Image = new Image(this.dangerCalloutBottomArrowSkinTexture);
			callout.bottomArrowSkin = bottomArrowSkin;
			callout.bottomArrowGap = this.calloutArrowOverlapGap;

			var leftArrowSkin:Image = new Image(this.dangerCalloutLeftArrowSkinTexture);
			callout.leftArrowSkin = leftArrowSkin;
			callout.leftArrowGap = this.calloutArrowOverlapGap;

			callout.padding = this.smallGutterSize;
		}

	//-------------------------
	// Check
	//-------------------------

		protected function setCheckStyles(check:Check):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			check.defaultSkin = skin;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			check.focusIndicatorSkin = focusIndicatorSkin;
			check.focusPadding = this.focusPaddingSize;

			var icon:ImageSkin = new ImageSkin(this.checkUpIconTexture);
			icon.selectedTexture = this.checkSelectedUpIconTexture;
			icon.setTextureForState(ButtonState.DOWN, this.checkDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED, this.checkDisabledIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.checkSelectedDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.checkSelectedDisabledIconTexture);
			check.defaultIcon = icon;

			check.fontStyles = this.lightUIFontStyles.clone();
			check.disabledFontStyles = this.lightDisabledUIFontStyles.clone();

			check.horizontalAlign = HorizontalAlign.LEFT;
			check.gap = this.smallControlGutterSize;
			check.minGap = this.smallControlGutterSize;
			check.minTouchWidth = this.gridSize;
			check.minTouchHeight = this.gridSize;
		}

	//-------------------------
	// DataGrid
	//-------------------------

		protected function setDataGridStyles(grid:DataGrid):void
		{
			this.setScrollerStyles(grid);
			var backgroundSkin:Quad = new Quad(this.gridSize, this.gridSize, LIST_BACKGROUND_COLOR);
			grid.backgroundSkin = backgroundSkin;

			var columnResizeSkin:ImageSkin = new ImageSkin(this.dataGridColumnResizeSkinTexture);
			columnResizeSkin.scale9Grid = DATA_GRID_COLUMN_RESIZE_SCALE_9_GRID;
			grid.columnResizeSkin = columnResizeSkin;

			var columnDropIndicatorSkin:ImageSkin = new ImageSkin(this.dataGridColumnDropIndicatorSkinTexture);
			columnDropIndicatorSkin.scale9Grid = DATA_GRID_COLUMN_DROP_INDICATOR_SCALE_9_GRID;
			grid.columnDropIndicatorSkin = columnDropIndicatorSkin;
			grid.extendedColumnDropIndicator = true;

			var columnDragOverlaySkin:Quad = new Quad(1, 1, DATA_GRID_COLUMN_OVERLAY_COLOR);
			columnDragOverlaySkin.alpha = DATA_GRID_COLUMN_OVERLAY_ALPHA;
			grid.columnDragOverlaySkin = columnDragOverlaySkin;

			grid.headerDividerFactory = this.dataGridHeaderDividerFactory;
			grid.verticalDividerFactory = this.dataGridVerticalDividerFactory;
		}

		protected function setDataGridHeaderStyles(headerRenderer:DefaultDataGridHeaderRenderer):void
		{
			headerRenderer.backgroundSkin = new Quad(1, 1, GROUPED_LIST_HEADER_BACKGROUND_COLOR);

			headerRenderer.sortAscendingIcon = new ImageSkin(this.dataGridHeaderSortAscendingIconTexture);
			headerRenderer.sortDescendingIcon = new ImageSkin(this.dataGridHeaderSortDescendingIconTexture);

			headerRenderer.fontStyles = this.lightUIFontStyles;
			headerRenderer.disabledFontStyles = this.lightDisabledUIFontStyles;
			headerRenderer.padding = this.smallGutterSize;
		}

		protected function setDataGridCellRendererStyles(cellRenderer:DefaultDataGridCellRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			skin.selectedTexture = this.itemRendererSelectedSkinTexture;
			skin.setTextureForState(ButtonState.DOWN, this.itemRendererSelectedSkinTexture);
			skin.scale9Grid = ITEM_RENDERER_SCALE9_GRID;
			skin.width = this.gridSize;
			skin.height = this.gridSize;
			skin.minWidth = this.gridSize;
			skin.minHeight = this.gridSize;
			cellRenderer.defaultSkin = skin;

			cellRenderer.fontStyles = this.largeLightFontStyles.clone();
			cellRenderer.disabledFontStyles = this.largeLightDisabledFontStyles.clone();
			cellRenderer.selectedFontStyles = this.largeDarkFontStyles.clone();
			cellRenderer.setFontStylesForState(ButtonState.DOWN, this.largeDarkFontStyles.clone());

			cellRenderer.iconLabelFontStyles = this.lightFontStyles.clone();
			cellRenderer.iconLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();
			cellRenderer.iconLabelSelectedFontStyles = this.darkFontStyles.clone();
			cellRenderer.setIconLabelFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());

			cellRenderer.accessoryLabelFontStyles = this.lightFontStyles.clone();
			cellRenderer.accessoryLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();
			cellRenderer.accessoryLabelSelectedFontStyles = this.darkFontStyles.clone();
			cellRenderer.setAccessoryLabelFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());

			cellRenderer.horizontalAlign = HorizontalAlign.LEFT;
			cellRenderer.paddingTop = this.smallGutterSize;
			cellRenderer.paddingBottom = this.smallGutterSize;
			cellRenderer.paddingLeft = this.gutterSize;
			cellRenderer.paddingRight = this.gutterSize;
			cellRenderer.gap = this.gutterSize;
			cellRenderer.minGap = this.gutterSize;
			cellRenderer.iconPosition = RelativePosition.LEFT;
			cellRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			cellRenderer.minAccessoryGap = this.gutterSize;
			cellRenderer.accessoryPosition = RelativePosition.RIGHT;
			cellRenderer.minTouchWidth = this.gridSize;
			cellRenderer.minTouchHeight = this.gridSize;
		}

	//-------------------------
	// DateTimeSpinner
	//-------------------------

		protected function setDateTimeSpinnerStyles(spinner:DateTimeSpinner):void
		{
			spinner.customItemRendererStyleName = THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER;
		}

		protected function setDateTimeSpinnerListItemRendererStyles(itemRenderer:DefaultListItemRenderer):void
		{
			this.setSpinnerListItemRendererStyles(itemRenderer);

			itemRenderer.accessoryPosition = RelativePosition.LEFT;
			itemRenderer.gap = this.smallGutterSize;
			itemRenderer.minGap = this.smallGutterSize;
			itemRenderer.accessoryGap = this.smallGutterSize;
			itemRenderer.minAccessoryGap = this.smallGutterSize;
		}

	//-------------------------
	// Drawers
	//-------------------------

		protected function setDrawersStyles(drawers:Drawers):void
		{
			var overlaySkin:Quad = new Quad(10, 10, DRAWER_OVERLAY_COLOR);
			overlaySkin.alpha = DRAWER_OVERLAY_ALPHA;
			drawers.overlaySkin = overlaySkin;

			var topDrawerDivider:Quad = new Quad(this.borderSize, this.borderSize, DRAWER_OVERLAY_COLOR);
			drawers.topDrawerDivider = topDrawerDivider;

			var rightDrawerDivider:Quad = new Quad(this.borderSize, this.borderSize, DRAWER_OVERLAY_COLOR);
			drawers.rightDrawerDivider = rightDrawerDivider;

			var bottomDrawerDivider:Quad = new Quad(this.borderSize, this.borderSize, DRAWER_OVERLAY_COLOR);
			drawers.bottomDrawerDivider = bottomDrawerDivider;

			var leftDrawerDivider:Quad = new Quad(this.borderSize, this.borderSize, DRAWER_OVERLAY_COLOR);
			drawers.leftDrawerDivider = leftDrawerDivider;
		}

	//-------------------------
	// GroupedList
	//-------------------------

		protected function setGroupedListStyles(list:GroupedList):void
		{
			this.setScrollerStyles(list);
			var backgroundSkin:Quad = new Quad(this.gridSize, this.gridSize, LIST_BACKGROUND_COLOR);
			list.backgroundSkin = backgroundSkin;
		}

		//see List section for item renderer styles

		protected function setGroupedListHeaderRendererStyles(renderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			renderer.backgroundSkin = new Quad(1, 1, GROUPED_LIST_HEADER_BACKGROUND_COLOR);

			renderer.fontStyles = this.lightUIFontStyles.clone();
			renderer.disabledFontStyles = this.lightDisabledUIFontStyles.clone();

			renderer.horizontalAlign = HorizontalAlign.LEFT;
			renderer.paddingTop = this.smallGutterSize;
			renderer.paddingBottom = this.smallGutterSize;
			renderer.paddingLeft = this.smallGutterSize + this.gutterSize;
			renderer.paddingRight = this.gutterSize;
		}

		protected function setGroupedListFooterRendererStyles(renderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			renderer.backgroundSkin = new Quad(1, 1, GROUPED_LIST_FOOTER_BACKGROUND_COLOR);

			renderer.fontStyles = this.lightFontStyles.clone();
			renderer.disabledFontStyles = this.lightDisabledFontStyles.clone();

			renderer.horizontalAlign = HorizontalAlign.CENTER;
			renderer.paddingTop = renderer.paddingBottom = this.smallGutterSize;
			renderer.paddingLeft = this.smallGutterSize + this.gutterSize;
			renderer.paddingRight = this.gutterSize;
		}

		protected function setInsetGroupedListStyles(list:GroupedList):void
		{
			list.customItemRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_ITEM_RENDERER;
			list.customFirstItemRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_FIRST_ITEM_RENDERER;
			list.customLastItemRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_LAST_ITEM_RENDERER;
			list.customSingleItemRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_SINGLE_ITEM_RENDERER;
			list.customHeaderRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_HEADER_RENDERER;
			list.customFooterRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_FOOTER_RENDERER;

			var layout:VerticalLayout = new VerticalLayout();
			layout.useVirtualLayout = true;
			layout.padding = this.smallGutterSize;
			layout.gap = 0;
			layout.horizontalAlign = HorizontalAlign.JUSTIFY;
			layout.verticalAlign = VerticalAlign.TOP;
			list.layout = layout;
		}

		protected function setInsetGroupedListItemRendererStyles(itemRenderer:DefaultGroupedListItemRenderer, defaultSkinTexture:Texture, selectedAndDownSkinTexture:Texture, scale9Grid:Rectangle):void
		{
			var skin:ImageSkin = new ImageSkin(defaultSkinTexture);
			skin.selectedTexture = selectedAndDownSkinTexture;
			skin.setTextureForState(ButtonState.DOWN, selectedAndDownSkinTexture);
			skin.scale9Grid = scale9Grid;
			skin.width = this.gridSize;
			skin.height = this.gridSize;
			skin.minWidth = this.gridSize;
			skin.minHeight = this.gridSize;
			itemRenderer.defaultSkin = skin;

			itemRenderer.fontStyles = this.largeLightFontStyles.clone();
			itemRenderer.disabledFontStyles = this.largeLightDisabledFontStyles.clone();
			itemRenderer.selectedFontStyles = this.largeDarkFontStyles.clone();
			itemRenderer.setFontStylesForState(ButtonState.DOWN, this.largeDarkFontStyles.clone());

			itemRenderer.iconLabelFontStyles = this.lightFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();
			itemRenderer.iconLabelSelectedFontStyles = this.darkFontStyles.clone();
			itemRenderer.setIconLabelFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());

			itemRenderer.accessoryLabelFontStyles = this.lightFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();
			itemRenderer.accessoryLabelSelectedFontStyles = this.darkFontStyles.clone();
			itemRenderer.setAccessoryLabelFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());

			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;
			itemRenderer.paddingTop = this.smallGutterSize;
			itemRenderer.paddingBottom = this.smallGutterSize;
			itemRenderer.paddingLeft = this.gutterSize + this.smallGutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.gap = this.gutterSize;
			itemRenderer.minGap = this.gutterSize;
			itemRenderer.iconPosition = RelativePosition.LEFT;
			itemRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			itemRenderer.minAccessoryGap = this.gutterSize;
			itemRenderer.accessoryPosition = RelativePosition.RIGHT;
			itemRenderer.minTouchWidth = this.gridSize;
			itemRenderer.minTouchHeight = this.gridSize;
		}

		protected function setInsetGroupedListMiddleItemRendererStyles(renderer:DefaultGroupedListItemRenderer):void
		{
			this.setInsetGroupedListItemRendererStyles(renderer, this.insetItemRendererUpSkinTexture, this.insetItemRendererSelectedSkinTexture, INSET_ITEM_RENDERER_MIDDLE_SCALE9_GRID);
		}

		protected function setInsetGroupedListFirstItemRendererStyles(renderer:DefaultGroupedListItemRenderer):void
		{
			this.setInsetGroupedListItemRendererStyles(renderer, this.insetItemRendererFirstUpSkinTexture, this.insetItemRendererFirstSelectedSkinTexture, INSET_ITEM_RENDERER_FIRST_SCALE9_GRID);
		}

		protected function setInsetGroupedListLastItemRendererStyles(renderer:DefaultGroupedListItemRenderer):void
		{
			this.setInsetGroupedListItemRendererStyles(renderer, this.insetItemRendererLastUpSkinTexture, this.insetItemRendererLastSelectedSkinTexture, INSET_ITEM_RENDERER_LAST_SCALE9_GRID);
		}

		protected function setInsetGroupedListSingleItemRendererStyles(renderer:DefaultGroupedListItemRenderer):void
		{
			this.setInsetGroupedListItemRendererStyles(renderer, this.insetItemRendererSingleUpSkinTexture, this.insetItemRendererSingleSelectedSkinTexture, INSET_ITEM_RENDERER_SINGLE_SCALE9_GRID);
		}

		protected function setInsetGroupedListHeaderRendererStyles(headerRenderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			headerRenderer.backgroundSkin = defaultSkin;

			headerRenderer.fontStyles = this.lightUIFontStyles.clone();
			headerRenderer.disabledFontStyles = this.lightDisabledUIFontStyles.clone();

			headerRenderer.horizontalAlign = HorizontalAlign.LEFT;
			headerRenderer.paddingTop = this.smallGutterSize;
			headerRenderer.paddingBottom = this.smallGutterSize;
			headerRenderer.paddingLeft = this.gutterSize + this.smallGutterSize;
			headerRenderer.paddingRight = this.gutterSize;
		}

		protected function setInsetGroupedListFooterRendererStyles(footerRenderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			footerRenderer.backgroundSkin = defaultSkin;

			footerRenderer.fontStyles = this.lightFontStyles.clone();
			footerRenderer.disabledFontStyles = this.lightDisabledFontStyles.clone();

			footerRenderer.horizontalAlign = HorizontalAlign.CENTER;
			footerRenderer.paddingTop = this.smallGutterSize;
			footerRenderer.paddingBottom = this.smallGutterSize;
			footerRenderer.paddingLeft = this.gutterSize + this.smallGutterSize;
			footerRenderer.paddingRight = this.gutterSize;
		}

	//-------------------------
	// Header
	//-------------------------

		protected function setHeaderStyles(header:Header):void
		{
			var backgroundSkin:ImageSkin = new ImageSkin(this.headerBackgroundSkinTexture);
			backgroundSkin.tileGrid = new Rectangle();
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			header.backgroundSkin = backgroundSkin;

			header.fontStyles = this.xlargeLightUIFontStyles.clone();
			header.disabledFontStyles = this.xlargeLightUIDisabledFontStyles.clone();

			header.padding = this.smallGutterSize;
			header.gap = this.smallGutterSize;
			header.titleGap = this.smallGutterSize;
		}

	//-------------------------
	// Label
	//-------------------------

		protected function setLabelStyles(label:Label):void
		{
			label.fontStyles = this.lightFontStyles.clone();
			label.disabledFontStyles = this.lightDisabledFontStyles.clone();
		}

		protected function setHeadingLabelStyles(label:Label):void
		{
			label.fontStyles = this.largeLightFontStyles.clone();
			label.disabledFontStyles = this.largeLightDisabledFontStyles.clone();
		}

		protected function setDetailLabelStyles(label:Label):void
		{
			label.fontStyles = this.smallLightFontStyles.clone();
			label.disabledFontStyles = this.smallLightDisabledFontStyles.clone();
		}

	//-------------------------
	// LayoutGroup
	//-------------------------

		protected function setToolbarLayoutGroupStyles(group:LayoutGroup):void
		{
			if(!group.layout)
			{
				var layout:HorizontalLayout = new HorizontalLayout();
				layout.padding = this.smallGutterSize;
				layout.gap = this.smallGutterSize;
				layout.verticalAlign = VerticalAlign.MIDDLE;
				group.layout = layout;
			}

			var backgroundSkin:ImageSkin = new ImageSkin(this.headerBackgroundSkinTexture);
			backgroundSkin.tileGrid = new Rectangle();
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			group.backgroundSkin = backgroundSkin;
		}

	//-------------------------
	// List
	//-------------------------

		protected function setListStyles(list:List):void
		{
			this.setScrollerStyles(list);

			var backgroundSkin:Quad = new Quad(this.gridSize, this.gridSize, LIST_BACKGROUND_COLOR);
			list.backgroundSkin = backgroundSkin;

			var dropIndicatorSkin:Quad = new Quad(this.borderSize, this.borderSize, LIGHT_TEXT_COLOR);
			list.dropIndicatorSkin = dropIndicatorSkin;
		}

		protected function setListItemRendererStyles(itemRenderer:DefaultListItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			var dragIcon:ImageSkin = new ImageSkin(this.dragHandleIcon);
			dragIcon.minTouchWidth = this.gridSize;
			dragIcon.minTouchHeight = this.gridSize;
			itemRenderer.dragIcon = dragIcon;
		}

		protected function setItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			skin.selectedTexture = this.itemRendererSelectedSkinTexture;
			skin.setTextureForState(ButtonState.DOWN, this.itemRendererSelectedSkinTexture);
			skin.scale9Grid = ITEM_RENDERER_SCALE9_GRID;
			skin.width = this.gridSize;
			skin.height = this.gridSize;
			skin.minWidth = this.gridSize;
			skin.minHeight = this.gridSize;
			itemRenderer.defaultSkin = skin;

			itemRenderer.fontStyles = this.largeLightFontStyles.clone();
			itemRenderer.disabledFontStyles = this.largeLightDisabledFontStyles.clone();
			itemRenderer.selectedFontStyles = this.largeDarkFontStyles.clone();
			itemRenderer.setFontStylesForState(ButtonState.DOWN, this.largeDarkFontStyles.clone());

			itemRenderer.iconLabelFontStyles = this.lightFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();
			itemRenderer.iconLabelSelectedFontStyles = this.darkFontStyles.clone();
			itemRenderer.setIconLabelFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());

			itemRenderer.accessoryLabelFontStyles = this.lightFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();
			itemRenderer.accessoryLabelSelectedFontStyles = this.darkFontStyles.clone();
			itemRenderer.setAccessoryLabelFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());

			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;
			itemRenderer.paddingTop = this.smallGutterSize;
			itemRenderer.paddingBottom = this.smallGutterSize;
			itemRenderer.paddingLeft = this.gutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.gap = this.gutterSize;
			itemRenderer.minGap = this.gutterSize;
			itemRenderer.iconPosition = RelativePosition.LEFT;
			itemRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			itemRenderer.minAccessoryGap = this.gutterSize;
			itemRenderer.accessoryPosition = RelativePosition.RIGHT;
			itemRenderer.minTouchWidth = this.gridSize;
			itemRenderer.minTouchHeight = this.gridSize;
		}

		protected function setDrillDownItemRendererStyles(itemRenderer:DefaultListItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			itemRenderer.itemHasAccessory = false;

			var accessorySkin:ImageSkin = new ImageSkin(this.listDrillDownAccessoryTexture);
			accessorySkin.selectedTexture = this.listDrillDownAccessorySelectedTexture;
			accessorySkin.setTextureForState(ButtonState.DOWN, this.listDrillDownAccessorySelectedTexture);
			itemRenderer.defaultAccessory = accessorySkin;
		}

		protected function setCheckItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.itemRendererSelectedSkinTexture);
			skin.scale9Grid = ITEM_RENDERER_SCALE9_GRID;
			skin.width = this.gridSize;
			skin.height = this.gridSize;
			skin.minWidth = this.gridSize;
			skin.minHeight = this.gridSize;
			itemRenderer.defaultSkin = skin;

			var defaultSelectedIcon:ImageLoader = new ImageLoader();
			defaultSelectedIcon.source = this.pickerListItemSelectedIconTexture;
			itemRenderer.defaultSelectedIcon = defaultSelectedIcon;
			defaultSelectedIcon.validate();

			var defaultIcon:Quad = new Quad(defaultSelectedIcon.width, defaultSelectedIcon.height, 0xff00ff);
			defaultIcon.alpha = 0;
			itemRenderer.defaultIcon = defaultIcon;

			itemRenderer.fontStyles = this.largeLightFontStyles.clone();
			itemRenderer.disabledFontStyles = this.largeLightDisabledFontStyles.clone();
			itemRenderer.setFontStylesForState(ButtonState.DOWN, this.largeDarkFontStyles.clone());

			itemRenderer.iconLabelFontStyles = this.lightFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();
			itemRenderer.setIconLabelFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());

			itemRenderer.accessoryLabelFontStyles = this.lightFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();
			itemRenderer.setAccessoryLabelFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());

			itemRenderer.itemHasIcon = false;
			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;
			itemRenderer.paddingTop = this.smallGutterSize;
			itemRenderer.paddingBottom = this.smallGutterSize;
			itemRenderer.paddingLeft = this.gutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.gap = Number.POSITIVE_INFINITY;
			itemRenderer.minGap = this.gutterSize;
			itemRenderer.iconPosition = RelativePosition.RIGHT;
			itemRenderer.accessoryGap = this.smallGutterSize;
			itemRenderer.minAccessoryGap = this.smallGutterSize;
			itemRenderer.accessoryPosition = RelativePosition.BOTTOM;
			itemRenderer.layoutOrder = ItemRendererLayoutOrder.LABEL_ACCESSORY_ICON;
			itemRenderer.minTouchWidth = this.gridSize;
			itemRenderer.minTouchHeight = this.gridSize;
		}

	//-------------------------
	// NumericStepper
	//-------------------------

		protected function setNumericStepperStyles(stepper:NumericStepper):void
		{
			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			stepper.focusIndicatorSkin = focusIndicatorSkin;
			stepper.focusPadding = this.focusPaddingSize;

			stepper.useLeftAndRightKeys = true;

			stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_HORIZONTAL;
			stepper.incrementButtonLabel = "+";
			stepper.decrementButtonLabel = "-";
		}

		protected function setNumericStepperTextInputStyles(input:TextInput):void
		{
			var backgroundSkin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			backgroundSkin.setTextureForState(TextInputState.DISABLED, this.backgroundDisabledSkinTexture);
			backgroundSkin.setTextureForState(TextInputState.FOCUSED, this.backgroundInsetFocusedSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_BACKGROUND_SCALE9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			backgroundSkin.minWidth = this.controlSize;
			backgroundSkin.minHeight = this.controlSize;
			input.backgroundSkin = backgroundSkin;

			input.textEditorFactory = stepperTextEditorFactory;
			input.fontStyles = this.lightCenteredUIFontStyles.clone();
			input.disabledFontStyles = this.lightCenteredDisabledUIFontStyles.clone();

			input.minTouchWidth = this.gridSize;
			input.minTouchHeight = this.gridSize;
			input.gap = this.smallControlGutterSize;
			input.paddingTop = this.smallControlGutterSize;
			input.paddingRight = this.smallGutterSize;
			input.paddingBottom = this.smallControlGutterSize;
			input.paddingLeft = this.smallGutterSize;
			input.isEditable = false;
			input.isSelectable = false;
		}

		protected function setNumericStepperButtonStyles(button:Button):void
		{
			this.setButtonStyles(button);
			button.keepDownStateOnRollOut = true;
		}

	//-------------------------
	// PageIndicator
	//-------------------------

		protected function setPageIndicatorStyles(pageIndicator:PageIndicator):void
		{
			pageIndicator.normalSymbolFactory = this.pageIndicatorNormalSymbolFactory;
			pageIndicator.selectedSymbolFactory = this.pageIndicatorSelectedSymbolFactory;
			pageIndicator.gap = this.smallGutterSize;
			pageIndicator.padding = this.smallGutterSize;
			pageIndicator.minTouchWidth = this.smallControlSize * 2;
			pageIndicator.minTouchHeight = this.smallControlSize * 2;
		}

	//-------------------------
	// Panel
	//-------------------------

		protected function setPanelStyles(panel:Panel):void
		{
			this.setScrollerStyles(panel);

			var backgroundSkin:Image = new Image(this.backgroundLightBorderSkinTexture);
			backgroundSkin.scale9Grid = SMALL_BACKGROUND_SCALE9_GRID;
			panel.backgroundSkin = backgroundSkin;
			panel.padding = this.smallGutterSize;
			panel.outerPadding = this.borderSize;
		}

		protected function setPopUpHeaderStyles(header:Header):void
		{
			header.padding = this.smallGutterSize;
			header.gap = this.smallGutterSize;
			header.titleGap = this.smallGutterSize;

			header.fontStyles = this.xlargeLightUIFontStyles.clone();
			header.disabledFontStyles = this.xlargeLightUIDisabledFontStyles.clone();

			var backgroundSkin:ImageSkin = new ImageSkin(this.popUpHeaderBackgroundSkinTexture);
			backgroundSkin.tileGrid = new Rectangle();
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			header.backgroundSkin = backgroundSkin;
		}

	//-------------------------
	// PanelScreen
	//-------------------------

		protected function setPanelScreenStyles(screen:PanelScreen):void
		{
			this.setScrollerStyles(screen);
		}

		protected function setPanelScreenHeaderStyles(header:Header):void
		{
			this.setHeaderStyles(header);
			header.useExtraPaddingForOSStatusBar = true;
		}

	//-------------------------
	// PickerList
	//-------------------------

		protected function setPickerListStyles(list:PickerList):void
		{
			if(DeviceCapabilities.isPhone(this.starling.nativeStage))
			{
				list.listFactory = pickerListSpinnerListFactory;
				list.popUpContentManager = new BottomDrawerPopUpContentManager();
			}
			else //tablet or desktop
			{
				list.popUpContentManager = new CalloutPopUpContentManager();
				list.customItemRendererStyleName = THEME_STYLE_NAME_TABLET_PICKER_LIST_ITEM_RENDERER;
			}
		}

		protected function setPickerListPopUpListStyles(list:List):void
		{
			this.setDropDownListStyles(list);
		}

		protected function setPickerListItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.itemRendererSelectedSkinTexture);
			skin.scale9Grid = ITEM_RENDERER_SCALE9_GRID;
			skin.width = this.popUpFillSize;
			skin.height = this.gridSize;
			skin.minWidth = this.popUpFillSize;
			skin.minHeight = this.gridSize;
			itemRenderer.defaultSkin = skin;

			var defaultSelectedIcon:ImageLoader = new ImageLoader();
			defaultSelectedIcon.source = this.pickerListItemSelectedIconTexture;
			itemRenderer.defaultSelectedIcon = defaultSelectedIcon;
			defaultSelectedIcon.validate();

			var defaultIcon:Quad = new Quad(defaultSelectedIcon.width, defaultSelectedIcon.height, 0xff00ff);
			defaultIcon.alpha = 0;
			itemRenderer.defaultIcon = defaultIcon;

			itemRenderer.fontStyles = this.largeLightFontStyles.clone();
			itemRenderer.disabledFontStyles = this.largeLightDisabledFontStyles.clone();
			itemRenderer.setFontStylesForState(ButtonState.DOWN, this.largeDarkFontStyles.clone());

			itemRenderer.iconLabelFontStyles = this.lightFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();
			itemRenderer.setIconLabelFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());

			itemRenderer.accessoryLabelFontStyles = this.lightFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();
			itemRenderer.setAccessoryLabelFontStylesForState(ButtonState.DOWN, this.darkFontStyles.clone());

			itemRenderer.itemHasIcon = false;
			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;
			itemRenderer.paddingTop = this.smallGutterSize;
			itemRenderer.paddingBottom = this.smallGutterSize;
			itemRenderer.paddingLeft = this.gutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.gap = Number.POSITIVE_INFINITY;
			itemRenderer.minGap = this.gutterSize;
			itemRenderer.iconPosition = RelativePosition.RIGHT;
			itemRenderer.accessoryGap = this.smallGutterSize;
			itemRenderer.minAccessoryGap = this.smallGutterSize;
			itemRenderer.accessoryPosition = RelativePosition.BOTTOM;
			itemRenderer.layoutOrder = ItemRendererLayoutOrder.LABEL_ACCESSORY_ICON;
			itemRenderer.minTouchWidth = this.gridSize;
			itemRenderer.minTouchHeight = this.gridSize;
		}

		protected function setPickerListButtonStyles(button:Button):void
		{
			this.setButtonStyles(button);

			var icon:ImageSkin = new ImageSkin(this.pickerListButtonIconTexture);
			icon.selectedTexture = this.pickerListButtonSelectedIconTexture;
			icon.setTextureForState(ButtonState.DISABLED, this.pickerListButtonIconDisabledTexture);
			button.defaultIcon = icon;

			button.gap = Number.POSITIVE_INFINITY;
			button.minGap = this.gutterSize;
			button.iconPosition = RelativePosition.RIGHT;
		}

	//-------------------------
	// ProgressBar
	//-------------------------

		protected function setProgressBarStyles(progress:ProgressBar):void
		{
			var backgroundSkin:Image = new Image(this.backgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_BACKGROUND_SCALE9_GRID;
			if(progress.direction == Direction.VERTICAL)
			{
				backgroundSkin.width = this.smallControlSize;
				backgroundSkin.height = this.wideControlSize;
			}
			else
			{
				backgroundSkin.width = this.wideControlSize;
				backgroundSkin.height = this.smallControlSize;
			}
			progress.backgroundSkin = backgroundSkin;

			var backgroundDisabledSkin:Image = new Image(this.backgroundDisabledSkinTexture);
			backgroundDisabledSkin.scale9Grid = DEFAULT_BACKGROUND_SCALE9_GRID;
			if(progress.direction == Direction.VERTICAL)
			{
				backgroundDisabledSkin.width = this.smallControlSize;
				backgroundDisabledSkin.height = this.wideControlSize;
			}
			else
			{
				backgroundDisabledSkin.width = this.wideControlSize;
				backgroundDisabledSkin.height = this.smallControlSize;
			}
			progress.backgroundDisabledSkin = backgroundDisabledSkin;

			var fillSkin:Image = new Image(this.buttonUpSkinTexture);
			fillSkin.scale9Grid = BUTTON_SCALE9_GRID;
			fillSkin.width = this.smallControlSize;
			fillSkin.height = this.smallControlSize;
			progress.fillSkin = fillSkin;

			var fillDisabledSkin:Image = new Image(this.buttonDisabledSkinTexture);
			fillDisabledSkin.scale9Grid = BUTTON_SCALE9_GRID;
			fillDisabledSkin.width = this.smallControlSize;
			fillDisabledSkin.height = this.smallControlSize;
			progress.fillDisabledSkin = fillDisabledSkin;
		}

	//-------------------------
	// Radio
	//-------------------------

		protected function setRadioStyles(radio:Radio):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			radio.defaultSkin = skin;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			radio.focusIndicatorSkin = focusIndicatorSkin;
			radio.focusPadding = this.focusPaddingSize;

			var icon:ImageSkin = new ImageSkin(this.radioUpIconTexture);
			icon.selectedTexture = this.radioSelectedUpIconTexture;
			icon.setTextureForState(ButtonState.DOWN, this.radioDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED, this.radioDisabledIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.radioSelectedDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.radioSelectedDisabledIconTexture);
			radio.defaultIcon = icon;

			radio.fontStyles = this.lightUIFontStyles.clone();
			radio.disabledFontStyles = this.lightDisabledUIFontStyles.clone();

			radio.horizontalAlign = HorizontalAlign.LEFT;
			radio.gap = this.smallControlGutterSize;
			radio.minGap = this.smallControlGutterSize;
			radio.minTouchWidth = this.gridSize;
			radio.minTouchHeight = this.gridSize;
		}

	//-------------------------
	// ScrollContainer
	//-------------------------

		protected function setScrollContainerStyles(container:ScrollContainer):void
		{
			this.setScrollerStyles(container);
		}

		protected function setToolbarScrollContainerStyles(container:ScrollContainer):void
		{
			this.setScrollerStyles(container);
			if(!container.layout)
			{
				var layout:HorizontalLayout = new HorizontalLayout();
				layout.padding = this.smallGutterSize;
				layout.gap = this.smallGutterSize;
				layout.verticalAlign = VerticalAlign.MIDDLE;
				container.layout = layout;
			}

			var backgroundSkin:ImageSkin = new ImageSkin(this.headerBackgroundSkinTexture);
			backgroundSkin.tileGrid = new Rectangle();
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			container.backgroundSkin = backgroundSkin;
		}

	//-------------------------
	// ScrollScreen
	//-------------------------

		protected function setScrollScreenStyles(screen:ScrollScreen):void
		{
			this.setScrollerStyles(screen);
		}

	//-------------------------
	// ScrollText
	//-------------------------

		protected function setScrollTextStyles(text:ScrollText):void
		{
			this.setScrollerStyles(text);

			text.fontStyles = this.lightScrollTextFontStyles.clone();
			text.disabledFontStyles = this.lightDisabledScrollTextFontStyles.clone();

			text.padding = this.gutterSize;
			text.paddingRight = this.gutterSize + this.smallGutterSize;
		}

	//-------------------------
	// SimpleScrollBar
	//-------------------------

		protected function setSimpleScrollBarStyles(scrollBar:SimpleScrollBar):void
		{
			if(scrollBar.direction == Direction.HORIZONTAL)
			{
				scrollBar.paddingRight = this.scrollBarGutterSize;
				scrollBar.paddingBottom = this.scrollBarGutterSize;
				scrollBar.paddingLeft = this.scrollBarGutterSize;
				scrollBar.customThumbStyleName = THEME_STYLE_NAME_HORIZONTAL_SIMPLE_SCROLL_BAR_THUMB;
			}
			else
			{
				scrollBar.paddingTop = this.scrollBarGutterSize;
				scrollBar.paddingRight = this.scrollBarGutterSize;
				scrollBar.paddingBottom = this.scrollBarGutterSize;
				scrollBar.customThumbStyleName = THEME_STYLE_NAME_VERTICAL_SIMPLE_SCROLL_BAR_THUMB;
			}
		}

		protected function setHorizontalSimpleScrollBarThumbStyles(thumb:Button):void
		{
			var defaultSkin:Image = new Image(this.horizontalScrollBarThumbSkinTexture);
			defaultSkin.scale9Grid = HORIZONTAL_SCROLL_BAR_THUMB_SCALE9_GRID;
			defaultSkin.width = this.gutterSize;
			thumb.defaultSkin = defaultSkin;
			thumb.hasLabelTextRenderer = false;
		}

		protected function setVerticalSimpleScrollBarThumbStyles(thumb:Button):void
		{
			var defaultSkin:Image = new Image(this.verticalScrollBarThumbSkinTexture);
			defaultSkin.scale9Grid = VERTICAL_SCROLL_BAR_THUMB_SCALE9_GRID;
			defaultSkin.height = this.gutterSize;
			thumb.defaultSkin = defaultSkin;
			thumb.hasLabelTextRenderer = false;
		}

	//-------------------------
	// Slider
	//-------------------------

		protected function setSliderStyles(slider:Slider):void
		{
			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			slider.focusIndicatorSkin = focusIndicatorSkin;
			slider.focusPadding = this.focusPaddingSize;

			slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			if(slider.direction == Direction.VERTICAL)
			{
				slider.customMinimumTrackStyleName = THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK;
				slider.customMaximumTrackStyleName = THEME_STYLE_NAME_VERTICAL_SLIDER_MAXIMUM_TRACK;
			}
			else //horizontal
			{
				slider.customMinimumTrackStyleName = THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK;
				slider.customMaximumTrackStyleName = THEME_STYLE_NAME_HORIZONTAL_SLIDER_MAXIMUM_TRACK;
			}
		}

		protected function setHorizontalSliderMinimumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			skin.disabledTexture = this.backgroundDisabledSkinTexture;
			skin.scale9Grid = DEFAULT_BACKGROUND_SCALE9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.wideControlSize;
			skin.minHeight = this.controlSize;
			track.defaultSkin = skin;

			track.hasLabelTextRenderer = false;
		}

		protected function setHorizontalSliderMaximumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			skin.disabledTexture = this.backgroundDisabledSkinTexture;
			skin.scale9Grid = DEFAULT_BACKGROUND_SCALE9_GRID;
			skin.width = this.wideControlSize;
			skin.minWidth = this.wideControlSize;
			skin.height = this.controlSize;
			skin.minHeight = this.controlSize;
			track.defaultSkin = skin;

			track.hasLabelTextRenderer = false;
		}

		protected function setVerticalSliderMinimumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			skin.disabledTexture = this.backgroundDisabledSkinTexture;
			skin.scale9Grid = DEFAULT_BACKGROUND_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.wideControlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.wideControlSize;
			track.defaultSkin = skin;

			track.hasLabelTextRenderer = false;
		}

		protected function setVerticalSliderMaximumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			skin.disabledTexture = this.backgroundDisabledSkinTexture;
			skin.scale9Grid = DEFAULT_BACKGROUND_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.wideControlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.wideControlSize;
			track.defaultSkin = skin;

			track.hasLabelTextRenderer = false;
		}

	//-------------------------
	// SpinnerList
	//-------------------------

		protected function setSpinnerListStyles(list:SpinnerList):void
		{
			this.setScrollerStyles(list);
			
			var backgroundSkin:Image = new Image(this.backgroundDarkBorderSkinTexture);
			backgroundSkin.scale9Grid = SMALL_BACKGROUND_SCALE9_GRID;
			list.backgroundSkin = backgroundSkin;
			
			var selectionOverlaySkin:Image = new Image(this.spinnerListSelectionOverlaySkinTexture);
			selectionOverlaySkin.scale9Grid = SPINNER_LIST_SELECTION_OVERLAY_SCALE9_GRID;
			list.selectionOverlaySkin = selectionOverlaySkin;
			
			list.customItemRendererStyleName = THEME_STYLE_NAME_SPINNER_LIST_ITEM_RENDERER;

			list.paddingTop = this.borderSize;
			list.paddingBottom = this.borderSize;
		}

		protected function setSpinnerListItemRendererStyles(itemRenderer:DefaultListItemRenderer):void
		{
			var defaultSkin:Quad = new Quad(this.gridSize, this.gridSize, 0xff00ff);
			defaultSkin.alpha = 0;
			itemRenderer.defaultSkin = defaultSkin;

			itemRenderer.fontStyles = this.largeLightFontStyles.clone();
			itemRenderer.disabledFontStyles = this.largeLightDisabledFontStyles.clone();

			itemRenderer.iconLabelFontStyles = this.lightFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();

			itemRenderer.accessoryLabelFontStyles = this.lightFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.lightDisabledFontStyles.clone();

			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;
			itemRenderer.paddingTop = this.smallGutterSize;
			itemRenderer.paddingBottom = this.smallGutterSize;
			itemRenderer.paddingLeft = this.gutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.gap = this.gutterSize;
			itemRenderer.minGap = this.gutterSize;
			itemRenderer.iconPosition = RelativePosition.LEFT;
			itemRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			itemRenderer.minAccessoryGap = this.gutterSize;
			itemRenderer.accessoryPosition = RelativePosition.RIGHT;
			itemRenderer.minTouchWidth = this.gridSize;
			itemRenderer.minTouchHeight = this.gridSize;
		}

	//-------------------------
	// TabBar
	//-------------------------

		protected function setTabBarStyles(tabBar:TabBar):void
		{
			tabBar.distributeTabSizes = true;
		}

		protected function setTabStyles(tab:ToggleButton):void
		{
			var skin:ImageSkin = new ImageSkin(this.tabUpSkinTexture);
			skin.selectedTexture = this.tabSelectedUpSkinTexture;
			skin.setTextureForState(ButtonState.DOWN, this.tabDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.tabDisabledSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.tabSelectedDisabledSkinTexture);
			skin.scale9Grid = TAB_SCALE9_GRID;
			skin.width = this.gridSize;
			skin.height = this.gridSize;
			skin.minWidth = this.gridSize;
			skin.minHeight = this.gridSize;
			tab.defaultSkin = skin;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			tab.focusIndicatorSkin = focusIndicatorSkin;
			tab.focusPadding = this.tabFocusPaddingSize;

			tab.fontStyles = this.lightUIFontStyles.clone();
			tab.disabledFontStyles = this.lightDisabledUIFontStyles.clone();
			tab.selectedFontStyles = this.darkUIFontStyles.clone();

			tab.paddingTop = this.smallGutterSize;
			tab.paddingBottom = this.smallGutterSize;
			tab.paddingLeft = this.gutterSize;
			tab.paddingRight = this.gutterSize;
			tab.gap = this.smallGutterSize;
			tab.minGap = this.smallGutterSize;
			tab.minTouchWidth = this.gridSize;
			tab.minTouchHeight = this.gridSize;
		}

	//-------------------------
	// TextArea
	//-------------------------

		protected function setTextAreaStyles(textArea:TextArea):void
		{
			this.setScrollerStyles(textArea);

			var skin:ImageSkin = new ImageSkin(this.backgroundInsetSkinTexture);
			skin.setTextureForState(TextInputState.DISABLED, this.backgroundDisabledSkinTexture);
			skin.setTextureForState(TextInputState.FOCUSED, this.backgroundInsetFocusedSkinTexture);
			skin.setTextureForState(TextInputState.ERROR, this.backgroundInsetDangerSkinTexture);
			skin.scale9Grid = DEFAULT_BACKGROUND_SCALE9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.wideControlSize;
			textArea.backgroundSkin = skin;

			textArea.fontStyles = this.lightInputFontStyles.clone();
			textArea.disabledFontStyles = this.lightDisabledInputFontStyles.clone();

			textArea.promptFontStyles = this.lightFontStyles.clone();
			textArea.promptDisabledFontStyles = this.lightDisabledFontStyles.clone();

			textArea.textEditorFactory = textAreaTextEditorFactory;
			
			textArea.innerPadding = this.smallGutterSize;
		}

		protected function setTextAreaErrorCalloutStyles(callout:TextCallout):void
		{
			this.setDangerCalloutStyles(callout);

			callout.fontStyles = this.lightFontStyles.clone();
			callout.disabledFontStyles = this.lightDisabledFontStyles.clone();

			callout.horizontalAlign = HorizontalAlign.LEFT;
			callout.verticalAlign = VerticalAlign.TOP;
		}

	//-------------------------
	// TextCallout
	//-------------------------

		protected function setTextCalloutStyles(callout:TextCallout):void
		{
			this.setCalloutStyles(callout);

			callout.fontStyles = this.lightFontStyles.clone();
			callout.disabledFontStyles = this.lightDisabledFontStyles.clone();
		}

	//-------------------------
	// Toast
	//-------------------------

		protected function setToastStyles(toast:Toast):void
		{
			var backgroundSkin:Image = new Image(this.backgroundLightBorderSkinTexture);
			backgroundSkin.scale9Grid = SMALL_BACKGROUND_SCALE9_GRID;
			toast.backgroundSkin = backgroundSkin;

			toast.fontStyles = this.lightFontStyles.clone();

			toast.width = this.popUpFillSize;
			toast.paddingTop = this.gutterSize;
			toast.paddingRight = this.gutterSize;
			toast.paddingBottom = this.gutterSize;
			toast.paddingLeft = this.gutterSize;
			toast.gap = Number.POSITIVE_INFINITY;
			toast.minGap = this.smallGutterSize;
			toast.horizontalAlign = HorizontalAlign.LEFT;
			toast.verticalAlign = VerticalAlign.MIDDLE;
		}

		protected function setToastActionsStyles(group:ButtonGroup):void
		{
			group.direction = Direction.HORIZONTAL;
			group.gap = this.smallGutterSize;
			group.customButtonStyleName = THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON;
		}

		protected function setToastActionsButtonStyles(button:Button):void
		{
			button.fontStyles = this.selectedUIFontStyles.clone();
			button.setFontStylesForState(ButtonState.DOWN, this.lightUIFontStyles);
		}

	//-------------------------
	// TextInput
	//-------------------------

		protected function setBaseTextInputStyles(input:TextInput):void
		{
			var skin:ImageSkin = new ImageSkin(this.backgroundInsetSkinTexture);
			skin.setTextureForState(TextInputState.DISABLED, this.backgroundInsetDisabledSkinTexture);
			skin.setTextureForState(TextInputState.FOCUSED, this.backgroundInsetFocusedSkinTexture);
			skin.setTextureForState(TextInputState.ERROR, this.backgroundInsetDangerSkinTexture);
			skin.scale9Grid = DEFAULT_BACKGROUND_SCALE9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			input.backgroundSkin = skin;

			input.fontStyles = this.lightInputFontStyles.clone();
			input.disabledFontStyles = this.lightDisabledInputFontStyles.clone();

			input.promptFontStyles = this.lightFontStyles.clone();
			input.promptDisabledFontStyles = this.lightDisabledFontStyles.clone();

			input.minTouchWidth = this.gridSize;
			input.minTouchHeight = this.gridSize;
			input.gap = this.smallControlGutterSize;
			input.paddingTop = this.smallControlGutterSize;
			input.paddingRight = this.smallGutterSize;
			input.paddingBottom = this.smallControlGutterSize;
			input.paddingLeft = this.smallGutterSize;
			input.verticalAlign = VerticalAlign.MIDDLE;
		}

		protected function setTextInputStyles(input:TextInput):void
		{
			this.setBaseTextInputStyles(input);
		}

		protected function setTextInputErrorCalloutStyles(callout:TextCallout):void
		{
			this.setDangerCalloutStyles(callout);

			callout.fontStyles = this.lightFontStyles.clone();
			callout.disabledFontStyles = this.lightDisabledFontStyles.clone();

			callout.horizontalAlign = HorizontalAlign.LEFT;
			callout.verticalAlign = VerticalAlign.TOP;
		}

		protected function setSearchTextInputStyles(input:TextInput):void
		{
			this.setBaseTextInputStyles(input);

			input.fontStyles = this.lightInputFontStyles.clone();
			input.disabledFontStyles = this.lightDisabledInputFontStyles.clone();

			input.promptFontStyles = this.lightFontStyles.clone();
			input.promptDisabledFontStyles = this.lightDisabledFontStyles.clone();

			var icon:ImageSkin = new ImageSkin(this.searchIconTexture);
			icon.setTextureForState(TextInputState.DISABLED, this.searchIconDisabledTexture);
			input.defaultIcon = icon;
		}

	//-------------------------
	// ToggleSwitch
	//-------------------------

		protected function setToggleSwitchStyles(toggle:ToggleSwitch):void
		{
			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			toggle.focusIndicatorSkin = focusIndicatorSkin;
			toggle.focusPadding = this.focusPaddingSize;

			toggle.trackLayoutMode = TrackLayoutMode.SINGLE;

			toggle.offLabelFontStyles = this.lightUIFontStyles.clone();
			toggle.offLabelDisabledFontStyles = this.lightDisabledUIFontStyles.clone();
			toggle.onLabelFontStyles = this.selectedUIFontStyles.clone();
			toggle.onLabelDisabledFontStyles = this.lightDisabledUIFontStyles.clone();
		}

		//see Shared section for thumb styles

		protected function setToggleSwitchTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			skin.disabledTexture = this.backgroundDisabledSkinTexture;
			skin.scale9Grid = DEFAULT_BACKGROUND_SCALE9_GRID;
			skin.width = Math.round(this.controlSize * 2.5);
			skin.height = this.controlSize;
			track.defaultSkin = skin;
			track.hasLabelTextRenderer = false;
		}

	//-------------------------
	// Tree
	//-------------------------

		protected function setTreeStyles(tree:Tree):void
		{
			this.setScrollerStyles(tree);
			var backgroundSkin:Quad = new Quad(this.gridSize, this.gridSize, LIST_BACKGROUND_COLOR);
			tree.backgroundSkin = backgroundSkin;
		}

		protected function setTreeItemRendererStyles(itemRenderer:DefaultTreeItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			itemRenderer.indentation = this.treeDisclosureOpenIconTexture.width;

			var disclosureOpenIcon:ImageSkin = new ImageSkin(this.treeDisclosureOpenIconTexture);
			disclosureOpenIcon.selectedTexture = this.treeDisclosureOpenSelectedIconTexture;
			//make sure the hit area is large enough for touch screens
			disclosureOpenIcon.minTouchWidth = this.gridSize;
			disclosureOpenIcon.minTouchHeight = this.gridSize;
			itemRenderer.disclosureOpenIcon = disclosureOpenIcon;

			var disclosureClosedIcon:ImageSkin = new ImageSkin(this.treeDisclosureClosedIconTexture);
			disclosureClosedIcon.selectedTexture = this.treeDisclosureClosedSelectedIconTexture;
			disclosureClosedIcon.minTouchWidth = this.gridSize;
			disclosureClosedIcon.minTouchHeight = this.gridSize;
			itemRenderer.disclosureClosedIcon = disclosureClosedIcon;
		}

	//-------------------------
	// PlayPauseToggleButton
	//-------------------------

		protected function setPlayPauseToggleButtonStyles(button:PlayPauseToggleButton):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			button.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.playPauseButtonPlayUpIconTexture);
			icon.selectedTexture = this.playPauseButtonPauseUpIconTexture;
			icon.setTextureForState(ButtonState.DOWN, this.playPauseButtonPlayDownIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.playPauseButtonPauseDownIconTexture);
			button.defaultIcon = icon;

			button.hasLabelTextRenderer = false;

			button.minTouchWidth = this.gridSize;
			button.minTouchHeight = this.gridSize;
		}

		protected function setOverlayPlayPauseToggleButtonStyles(button:PlayPauseToggleButton):void
		{
			var icon:ImageSkin = new ImageSkin(null);
			icon.setTextureForState(ButtonState.UP, this.overlayPlayPauseButtonPlayUpIconTexture);
			icon.setTextureForState(ButtonState.HOVER, this.overlayPlayPauseButtonPlayUpIconTexture);
			icon.setTextureForState(ButtonState.DOWN, this.overlayPlayPauseButtonPlayDownIconTexture);
			button.defaultIcon = icon;

			button.hasLabelTextRenderer = false;

			var overlaySkin:Quad = new Quad(1, 1, VIDEO_OVERLAY_COLOR);
			overlaySkin.alpha = VIDEO_OVERLAY_ALPHA;
			button.upSkin = overlaySkin;
			button.hoverSkin = overlaySkin;
		}

	//-------------------------
	// FullScreenToggleButton
	//-------------------------

		protected function setFullScreenToggleButtonStyles(button:FullScreenToggleButton):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			button.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.fullScreenToggleButtonEnterUpIconTexture);
			icon.selectedTexture = this.fullScreenToggleButtonExitUpIconTexture;
			icon.setTextureForState(ButtonState.DOWN, this.fullScreenToggleButtonEnterDownIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.fullScreenToggleButtonExitDownIconTexture);
			button.defaultIcon = icon;

			button.hasLabelTextRenderer = false;

			button.minTouchWidth = this.gridSize;
			button.minTouchHeight = this.gridSize;
		}

	//-------------------------
	// MuteToggleButton
	//-------------------------

		protected function setMuteToggleButtonStyles(button:MuteToggleButton):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			button.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.muteToggleButtonLoudUpIconTexture);
			icon.selectedTexture = this.muteToggleButtonMutedUpIconTexture;
			icon.setTextureForState(ButtonState.DOWN, this.muteToggleButtonLoudDownIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.muteToggleButtonMutedDownIconTexture);
			button.defaultIcon = icon;

			button.hasLabelTextRenderer = false;
			button.showVolumeSliderOnHover = false;

			button.minTouchWidth = this.gridSize;
			button.minTouchHeight = this.gridSize;
		}

	//-------------------------
	// SeekSlider
	//-------------------------

		protected function setSeekSliderStyles(slider:SeekSlider):void
		{
			slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			slider.showThumb = false;
			var progressSkin:Image = new Image(this.seekSliderProgressSkinTexture);
			progressSkin.scale9Grid = DEFAULT_BACKGROUND_SCALE9_GRID;
			progressSkin.width = this.smallControlSize;
			progressSkin.height = this.smallControlSize;
			slider.progressSkin = progressSkin;
		}

		protected function setSeekSliderThumbStyles(thumb:Button):void
		{
			var thumbSize:Number = 6;
			thumb.defaultSkin = new Quad(thumbSize, thumbSize);
			thumb.hasLabelTextRenderer = false;
			thumb.minTouchWidth = this.gridSize;
			thumb.minTouchHeight = this.gridSize;
		}

		protected function setSeekSliderMinimumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			defaultSkin.scale9Grid = BUTTON_SCALE9_GRID;
			defaultSkin.width = this.wideControlSize;
			defaultSkin.height = this.smallControlSize;
			defaultSkin.minWidth = this.wideControlSize;
			defaultSkin.minHeight = this.smallControlSize;
			track.defaultSkin = defaultSkin;
			track.hasLabelTextRenderer = false;
			track.minTouchHeight = this.gridSize;
		}

		protected function setSeekSliderMaximumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageSkin = new ImageSkin(this.backgroundSkinTexture);
			defaultSkin.scale9Grid = DEFAULT_BACKGROUND_SCALE9_GRID;
			defaultSkin.width = this.wideControlSize;
			defaultSkin.height = this.smallControlSize;
			defaultSkin.minHeight = this.smallControlSize;
			track.defaultSkin = defaultSkin;
			track.hasLabelTextRenderer = false;
			track.minTouchHeight = this.gridSize;
		}

	//-------------------------
	// VolumeSlider
	//-------------------------

		protected function setVolumeSliderStyles(slider:VolumeSlider):void
		{
			slider.direction = Direction.HORIZONTAL;
			slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			slider.showThumb = false;
		}

		protected function setVolumeSliderThumbStyles(thumb:Button):void
		{
			var thumbSize:Number = 6;
			var defaultSkin:Quad = new Quad(thumbSize, thumbSize);
			defaultSkin.width = 0;
			defaultSkin.height = 0;
			thumb.defaultSkin = defaultSkin;
			thumb.hasLabelTextRenderer = false;
		}

		protected function setVolumeSliderMinimumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageLoader = new ImageLoader();
			defaultSkin.scaleContent = false;
			defaultSkin.source = this.volumeSliderMinimumTrackSkinTexture;
			track.defaultSkin = defaultSkin;
			track.hasLabelTextRenderer = false;
			track.minTouchHeight = this.gridSize;
		}

		protected function setVolumeSliderMaximumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageLoader = new ImageLoader();
			defaultSkin.scaleContent = false;
			defaultSkin.horizontalAlign = HorizontalAlign.RIGHT;
			defaultSkin.source = this.volumeSliderMaximumTrackSkinTexture;
			track.defaultSkin = defaultSkin;
			track.hasLabelTextRenderer = false;
			track.minTouchHeight = this.gridSize;
		}

	}
}


================================================
FILE: themes/MetalWorksMobileTheme/source/feathers/themes/MetalWorksMobileTheme.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import flash.display.Bitmap;
	import flash.display.BitmapData;

	import starling.textures.Texture;
	import starling.textures.TextureAtlas;

	/**
	 * The "Metal Works" theme for mobile Feathers apps.
	 *
	 * <p>This version of the theme embeds its assets. To load assets at
	 * runtime, see <code>MetalWorksMobileThemeWithAssetManager</code> instead.</p>
	 *
	 * @see http://feathersui.com/help/theme-assets.html
	 */
	public class MetalWorksMobileTheme extends BaseMetalWorksMobileTheme
	{
		/**
		 * @private
		 */
		[Embed(source="/../assets/images/metalworks_mobile.xml",mimeType="application/octet-stream")]
		protected static const ATLAS_XML:Class;

		/**
		 * @private
		 */
		[Embed(source="/../assets/images/metalworks_mobile.png")]
		protected static const ATLAS_BITMAP:Class;

		/**
		 * Constructor.
		 */
		public function MetalWorksMobileTheme()
		{
			super();
			this.initialize();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this.initializeTextureAtlas();
			super.initialize();
		}

		/**
		 * @private
		 */
		protected function initializeTextureAtlas():void
		{
			var atlasBitmapData:BitmapData = Bitmap(new ATLAS_BITMAP()).bitmapData;
			var atlasTexture:Texture = Texture.fromBitmapData(atlasBitmapData, false, false, 2);
			atlasTexture.root.onRestore = this.atlasTexture_onRestore;
			atlasBitmapData.dispose();
			this.atlas = new TextureAtlas(atlasTexture, XML(new ATLAS_XML()));
		}

		/**
		 * @private
		 */
		protected function atlasTexture_onRestore():void
		{
			var atlasBitmapData:BitmapData = Bitmap(new ATLAS_BITMAP()).bitmapData;
			this.atlas.texture.root.uploadBitmapData(atlasBitmapData);
			atlasBitmapData.dispose();
		}
	}
}


================================================
FILE: themes/MetalWorksMobileTheme/source/feathers/themes/MetalWorksMobileThemeWithAssetManager.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import feathers.events.FeathersEventType;

	import starling.assets.AssetManager;
	import starling.core.Starling;
	import starling.events.Event;

	/**
	 * @copy feathers.themes.IAsyncTheme#event:complete
	 *
	 * @eventType starling.events.Event.COMPLETE
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * Dispatched when the theme's assets fail to load due to an error.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The error string.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.ERROR
	 */
	[Event(name="error",type="starling.events.Event")]

	/**
	 * The "Metal Works" theme for mobile Feathers apps.
	 *
	 * <p>This version of the theme requires loading assets at runtime. To use
	 * embedded assets, see <code>MetalWorksMobileTheme</code> instead.</p>
	 *
	 * <p>To use this theme, the following files must be included when packaging
	 * your app:</p>
	 * <ul>
	 *     <li>images/metalworks_mobile.png</li>
	 *     <li>images/metalworks_mobile.xml</li>
	 * </ul>
	 *
	 * @see http://feathersui.com/help/theme-assets.html
	 */
	public class MetalWorksMobileThemeWithAssetManager extends BaseMetalWorksMobileTheme implements IAsyncTheme
	{
		/**
		 * @private
		 * The name of the texture atlas in the asset manager.
		 */
		protected static const ATLAS_NAME:String = "metalworks_mobile";

		/**
		 * @private
		 */
		protected static const ATLAS_SCALE_FACTOR:int = 2;

		/**
		 * Constructor.
		 * @param assetsBasePath The root folder of the assets.
		 * @param assetManager An optional pre-created AssetManager. The scaleFactor property must be equal to Starling.contentScaleFactor. To load assets with a different scale factor, use multiple AssetManager instances.
		 */
		public function MetalWorksMobileThemeWithAssetManager(assetsBasePath:String = "./", assetManager:AssetManager = null)
		{
			super();
			this.loadAssets(assetsBasePath, assetManager);
		}

		/**
		 * @private
		 * The paths to each of the assets, relative to the base path.
		 */
		protected var assetPaths:Vector.<String> = new <String>
		[
			"images/" + ATLAS_NAME + ".xml",
			"images/" + ATLAS_NAME + ".png"
		];

		/**
		 * @private
		 */
		protected var assetManager:AssetManager;

		/**
		 * @private
		 */
		protected var isComplete:Boolean = false;

		/**
		 * @private
		 */
		override public function dispose():void
		{
			super.dispose();
			if(this.assetManager)
			{
				this.assetManager.removeTextureAtlas(ATLAS_NAME);
				this.assetManager = null;
			}
		}

		/**
		 * @copy feathers.themes.IAsyncTheme#isCompleteForStarling()
		 */
		public function isCompleteForStarling(starling:Starling):Boolean
		{
			return this.isComplete;
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this.initializeTextureAtlas();
			super.initialize();
		}

		/**
		 * @private
		 */
		protected function initializeTextureAtlas():void
		{
			this.atlas = this.assetManager.getTextureAtlas(ATLAS_NAME);
		}

		/**
		 * @private
		 */
		protected function loadAssets(assetsBasePath:String, assetManager:AssetManager):void
		{
			var oldScaleFactor:Number = -1;
			if(assetManager)
			{
				oldScaleFactor = assetManager.textureOptions.scale;
				assetManager.textureOptions.scale = ATLAS_SCALE_FACTOR;
			}
			else
			{
				assetManager = new AssetManager(ATLAS_SCALE_FACTOR);
			}
			this.assetManager = assetManager;
			//add a trailing slash, if needed
			if(assetsBasePath.lastIndexOf("/") != assetsBasePath.length - 1)
			{
				assetsBasePath += "/";
			}
			var assetPaths:Vector.<String> = this.assetPaths;
			var assetCount:int = assetPaths.length;
			for(var i:int = 0; i < assetCount; i++)
			{
				var asset:String = assetPaths[i];
				this.assetManager.enqueue(assetsBasePath + asset);
			}
			if(oldScaleFactor != -1)
			{
				//restore the old scale factor, just in case
				this.assetManager.textureOptions.scale = oldScaleFactor;
			}
			this.assetManager.loadQueue(assetManager_onComplete, assetManager_onError);
		}

		/**
		 * @private
		 */
		protected function assetManager_onComplete():void
		{
			this.initialize();
			this.isComplete = true;
			this.dispatchEventWith(Event.COMPLETE, false, Starling.current);
		}

		/**
		 * @private
		 */
		protected function assetManager_onError(error:String):void
		{
			this.dispatchEventWith(FeathersEventType.ERROR, false, error);
		}
	}
}


================================================
FILE: themes/MinimalDesktopTheme/README.md
================================================
# Minimal Desktop Theme for Feathers

This [Feathers](http://feathersui.com/) theme for desktop combines simple gray colors with a retro pixel aesthetic.

## Original Artwork

This theme's texture atlas was exported from Adobe Animate CC. To modify colors and other properties, or to add new skins to the texture atlas, [download the source FLA file](http://feathersui.com/help/theme-sources.html) from the Feathers website.

## Credits

This theme is based on the appearance of [MinimalComps](https://github.com/minimalcomps/minimalcomps), a great set of Flash user interface components created by [Keith Peters](https://bit-101.com/). With permission, the theme was ported to Feathers by [Josh Tynjala](https://joshblog.net/). This theme uses the free Ronda Seven font, designed by [Yusuke Kamiyamane](http://p.yusukekamiyamane.com/).

================================================
FILE: themes/MinimalDesktopTheme/assets/fonts/pf_ronda_seven_desktop.fnt
================================================
<?xml version="1.0"?>
<font>
  <info face="PF Ronda Seven" size="-16" bold="0" italic="0" charset="" unicode="1" stretchH="100" smooth="0" aa="1" padding="0,0,0,0" spacing="2,2" outline="0"/>
  <common lineHeight="26" base="22" scaleW="512" scaleH="512" pages="1" packed="0" alphaChnl="0" redChnl="4" greenChnl="4" blueChnl="4"/>
  <pages>
    <page id="0" file="pf-ronda-seven-font.png" />
  </pages>
  <chars count="95">
    <char id="32" x="432" y="16" width="2" height="2" xoffset="0" yoffset="24" xadvance="6" page="0" chnl="15"/>
    <char id="33" x="170" y="16" width="2" height="14" xoffset="2" yoffset="8" xadvance="6" page="0" chnl="15"/>
    <char id="34" x="390" y="16" width="6" height="4" xoffset="0" yoffset="8" xadvance="8" page="0" chnl="15"/>
    <char id="35" x="0" y="20" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="36" x="30" y="0" width="10" height="18" xoffset="0" yoffset="6" xadvance="12" page="0" chnl="15"/>
    <char id="37" x="138" y="0" width="14" height="14" xoffset="0" yoffset="8" xadvance="16" page="0" chnl="15"/>
    <char id="38" x="12" y="20" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="39" x="412" y="16" width="2" height="4" xoffset="0" yoffset="8" xadvance="4" page="0" chnl="15"/>
    <char id="40" x="54" y="0" width="6" height="18" xoffset="0" yoffset="6" xadvance="8" page="0" chnl="15"/>
    <char id="41" x="70" y="0" width="6" height="18" xoffset="0" yoffset="6" xadvance="8" page="0" chnl="15"/>
    <char id="42" x="218" y="16" width="10" height="10" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="43" x="230" y="16" width="10" height="10" xoffset="0" yoffset="10" xadvance="12" page="0" chnl="15"/>
    <char id="44" x="374" y="16" width="4" height="6" xoffset="0" yoffset="20" xadvance="6" page="0" chnl="15"/>
    <char id="45" x="416" y="16" width="6" height="2" xoffset="0" yoffset="16" xadvance="8" page="0" chnl="15"/>
    <char id="46" x="436" y="16" width="2" height="2" xoffset="2" yoffset="20" xadvance="6" page="0" chnl="15"/>
    <char id="47" x="42" y="0" width="10" height="18" xoffset="0" yoffset="6" xadvance="10" page="0" chnl="15"/>
    <char id="48" x="218" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="49" x="164" y="16" width="4" height="14" xoffset="0" yoffset="8" xadvance="6" page="0" chnl="15"/>
    <char id="50" x="230" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="51" x="242" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="52" x="254" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="53" x="266" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="54" x="36" y="20" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="55" x="290" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="56" x="302" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="57" x="314" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="58" x="362" y="16" width="2" height="10" xoffset="2" yoffset="12" xadvance="6" page="0" chnl="15"/>
    <char id="59" x="506" y="0" width="4" height="14" xoffset="0" yoffset="12" xadvance="6" page="0" chnl="15"/>
    <char id="60" x="330" y="16" width="6" height="10" xoffset="0" yoffset="10" xadvance="8" page="0" chnl="15"/>
    <char id="61" x="366" y="16" width="6" height="6" xoffset="0" yoffset="12" xadvance="8" page="0" chnl="15"/>
    <char id="62" x="322" y="16" width="6" height="10" xoffset="0" yoffset="10" xadvance="8" page="0" chnl="15"/>
    <char id="63" x="362" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="64" x="0" y="0" width="16" height="18" xoffset="0" yoffset="6" xadvance="18" page="0" chnl="15"/>
    <char id="65" x="374" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="66" x="386" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="67" x="398" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="68" x="410" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="69" x="422" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="70" x="434" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="71" x="446" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="72" x="458" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="73" x="174" y="16" width="2" height="14" xoffset="0" yoffset="8" xadvance="4" page="0" chnl="15"/>
    <char id="74" x="138" y="16" width="8" height="14" xoffset="0" yoffset="8" xadvance="10" page="0" chnl="15"/>
    <char id="75" x="470" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="76" x="58" y="20" width="8" height="14" xoffset="0" yoffset="8" xadvance="10" page="0" chnl="15"/>
    <char id="77" x="154" y="0" width="14" height="14" xoffset="0" yoffset="8" xadvance="16" page="0" chnl="15"/>
    <char id="78" x="170" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="79" x="182" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="80" x="350" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="81" x="106" y="0" width="10" height="16" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="82" x="338" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="83" x="326" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="84" x="278" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="85" x="206" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="86" x="194" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="87" x="122" y="0" width="14" height="14" xoffset="0" yoffset="8" xadvance="16" page="0" chnl="15"/>
    <char id="88" x="24" y="20" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="89" x="494" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="90" x="482" y="0" width="10" height="14" xoffset="0" yoffset="8" xadvance="12" page="0" chnl="15"/>
    <char id="91" x="62" y="0" width="6" height="18" xoffset="0" yoffset="6" xadvance="8" page="0" chnl="15"/>
    <char id="92" x="18" y="0" width="10" height="18" xoffset="0" yoffset="6" xadvance="12" page="0" chnl="15"/>
    <char id="93" x="78" y="0" width="6" height="18" xoffset="0" yoffset="6" xadvance="8" page="0" chnl="15"/>
    <char id="94" x="398" y="16" width="6" height="4" xoffset="0" yoffset="8" xadvance="8" page="0" chnl="15"/>
    <char id="95" x="424" y="16" width="6" height="2" xoffset="0" yoffset="20" xadvance="8" page="0" chnl="15"/>
    <char id="96" x="406" y="16" width="4" height="4" xoffset="0" yoffset="2" xadvance="6" page="0" chnl="15"/>
    <char id="97" x="282" y="16" width="8" height="10" xoffset="0" yoffset="12" xadvance="10" page="0" chnl="15"/>
    <char id="98" x="48" y="20" width="8" height="14" xoffset="0" yoffset="8" xadvance="10" page="0" chnl="15"/>
    <char id="99" x="302" y="16" width="8" height="10" xoffset="0" yoffset="12" xadvance="10" page="0" chnl="15"/>
    <char id="100" x="98" y="20" width="8" height="14" xoffset="0" yoffset="8" xadvance="10" page="0" chnl="15"/>
    <char id="101" x="312" y="16" width="8" height="10" xoffset="0" yoffset="12" xadvance="10" page="0" chnl="15"/>
    <char id="102" x="148" y="16" width="6" height="14" xoffset="0" yoffset="8" xadvance="6" page="0" chnl="15"/>
    <char id="103" x="68" y="20" width="8" height="14" xoffset="0" yoffset="12" xadvance="10" page="0" chnl="15"/>
    <char id="104" x="78" y="20" width="8" height="14" xoffset="0" yoffset="8" xadvance="10" page="0" chnl="15"/>
    <char id="105" x="178" y="16" width="2" height="14" xoffset="0" yoffset="8" xadvance="4" page="0" chnl="15"/>
    <char id="106" x="118" y="0" width="2" height="16" xoffset="0" yoffset="8" xadvance="4" page="0" chnl="15"/>
    <char id="107" x="88" y="20" width="8" height="14" xoffset="0" yoffset="8" xadvance="10" page="0" chnl="15"/>
    <char id="108" x="182" y="16" width="2" height="14" xoffset="0" yoffset="8" xadvance="4" page="0" chnl="15"/>
    <char id="109" x="202" y="16" width="14" height="10" xoffset="0" yoffset="12" xadvance="16" page="0" chnl="15"/>
    <char id="110" x="242" y="16" width="8" height="10" xoffset="0" yoffset="12" xadvance="10" page="0" chnl="15"/>
    <char id="111" x="252" y="16" width="8" height="10" xoffset="0" yoffset="12" xadvance="10" page="0" chnl="15"/>
    <char id="112" x="108" y="18" width="8" height="14" xoffset="0" yoffset="12" xadvance="10" page="0" chnl="15"/>
    <char id="113" x="118" y="18" width="8" height="14" xoffset="0" yoffset="12" xadvance="10" page="0" chnl="15"/>
    <char id="114" x="338" y="16" width="6" height="10" xoffset="0" yoffset="12" xadvance="8" page="0" chnl="15"/>
    <char id="115" x="346" y="16" width="6" height="10" xoffset="0" yoffset="12" xadvance="8" page="0" chnl="15"/>
    <char id="116" x="156" y="16" width="6" height="14" xoffset="0" yoffset="8" xadvance="8" page="0" chnl="15"/>
    <char id="117" x="262" y="16" width="8" height="10" xoffset="0" yoffset="12" xadvance="10" page="0" chnl="15"/>
    <char id="118" x="272" y="16" width="8" height="10" xoffset="0" yoffset="12" xadvance="10" page="0" chnl="15"/>
    <char id="119" x="186" y="16" width="14" height="10" xoffset="0" yoffset="12" xadvance="16" page="0" chnl="15"/>
    <char id="120" x="292" y="16" width="8" height="10" xoffset="0" yoffset="12" xadvance="10" page="0" chnl="15"/>
    <char id="121" x="128" y="16" width="8" height="14" xoffset="0" yoffset="12" xadvance="10" page="0" chnl="15"/>
    <char id="122" x="354" y="16" width="6" height="10" xoffset="0" yoffset="12" xadvance="8" page="0" chnl="15"/>
    <char id="123" x="94" y="0" width="6" height="18" xoffset="0" yoffset="6" xadvance="8" page="0" chnl="15"/>
    <char id="124" x="102" y="0" width="2" height="18" xoffset="0" yoffset="6" xadvance="4" page="0" chnl="15"/>
    <char id="125" x="86" y="0" width="6" height="18" xoffset="0" yoffset="6" xadvance="8" page="0" chnl="15"/>
    <char id="126" x="380" y="16" width="8" height="4" xoffset="0" yoffset="8" xadvance="10" page="0" chnl="15"/>
  </chars>
  <kernings count="66">
    <kerning first="70" second="100" amount="-2"/>
    <kerning first="70" second="97" amount="-2"/>
    <kerning first="70" second="111" amount="-2"/>
    <kerning first="70" second="112" amount="-2"/>
    <kerning first="70" second="113" amount="-2"/>
    <kerning first="70" second="114" amount="-2"/>
    <kerning first="70" second="115" amount="-2"/>
    <kerning first="70" second="116" amount="-2"/>
    <kerning first="70" second="117" amount="-2"/>
    <kerning first="70" second="109" amount="-2"/>
    <kerning first="70" second="110" amount="-2"/>
    <kerning first="70" second="101" amount="-2"/>
    <kerning first="70" second="121" amount="-2"/>
    <kerning first="70" second="118" amount="-2"/>
    <kerning first="70" second="99" amount="-2"/>
    <kerning first="70" second="103" amount="-2"/>
    <kerning first="70" second="119" amount="-2"/>
    <kerning first="70" second="120" amount="-2"/>
    <kerning first="70" second="122" amount="-2"/>
    <kerning first="70" second="74" amount="-2"/>
    <kerning first="76" second="84" amount="-2"/>
    <kerning first="76" second="86" amount="-2"/>
    <kerning first="76" second="89" amount="-2"/>
    <kerning first="80" second="74" amount="-2"/>
    <kerning first="84" second="100" amount="-2"/>
    <kerning first="84" second="97" amount="-2"/>
    <kerning first="84" second="111" amount="-2"/>
    <kerning first="84" second="112" amount="-2"/>
    <kerning first="84" second="113" amount="-2"/>
    <kerning first="84" second="114" amount="-2"/>
    <kerning first="84" second="115" amount="-2"/>
    <kerning first="84" second="116" amount="-2"/>
    <kerning first="84" second="117" amount="-2"/>
    <kerning first="84" second="109" amount="-2"/>
    <kerning first="84" second="110" amount="-2"/>
    <kerning first="84" second="101" amount="-2"/>
    <kerning first="84" second="121" amount="-2"/>
    <kerning first="84" second="118" amount="-2"/>
    <kerning first="84" second="99" amount="-2"/>
    <kerning first="84" second="103" amount="-2"/>
    <kerning first="84" second="119" amount="-2"/>
    <kerning first="84" second="120" amount="-2"/>
    <kerning first="84" second="122" amount="-2"/>
    <kerning first="84" second="74" amount="-2"/>
    <kerning first="86" second="74" amount="-2"/>
    <kerning first="47" second="47" amount="-4"/>
    <kerning first="89" second="100" amount="-2"/>
    <kerning first="89" second="97" amount="-2"/>
    <kerning first="89" second="111" amount="-2"/>
    <kerning first="89" second="112" amount="-2"/>
    <kerning first="89" second="113" amount="-2"/>
    <kerning first="89" second="114" amount="-2"/>
    <kerning first="89" second="115" amount="-2"/>
    <kerning first="89" second="116" amount="-2"/>
    <kerning first="89" second="117" amount="-2"/>
    <kerning first="89" second="109" amount="-2"/>
    <kerning first="89" second="110" amount="-2"/>
    <kerning first="89" second="101" amount="-2"/>
    <kerning first="89" second="121" amount="-2"/>
    <kerning first="89" second="118" amount="-2"/>
    <kerning first="89" second="99" amount="-2"/>
    <kerning first="89" second="103" amount="-2"/>
    <kerning first="89" second="119" amount="-2"/>
    <kerning first="89" second="120" amount="-2"/>
    <kerning first="89" second="122" amount="-2"/>
    <kerning first="89" second="74" amount="-2"/>
  </kernings>
</font>


================================================
FILE: themes/MinimalDesktopTheme/assets/images/minimal_desktop.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<TextureAtlas imagePath="minimal_desktop.png">
	<!-- Created with Adobe Animate version 16.5.1.104 -->
	<!-- http://www.adobe.com/products/animate.html -->
	<SubTexture name="back-button-disabled-skin0000" x="822" y="56" width="28" height="40" pivotX="0" pivotY="0"/>
	<SubTexture name="back-button-down-skin0000" x="888" y="64" width="28" height="40" pivotX="0" pivotY="0"/>
	<SubTexture name="back-button-up-skin0000" x="2" y="68" width="28" height="40" pivotX="0" pivotY="0"/>
	<SubTexture name="button-disabled-skin0000" x="918" y="64" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="button-down-skin0000" x="496" y="88" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="button-up-skin0000" x="366" y="92" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="call-to-action-button-up-skin0000" x="478" y="92" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-bottom-arrow-skin0000" x="914" y="2" width="52" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-left-arrow-skin0000" x="860" y="36" width="26" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-right-arrow-skin0000" x="792" y="2" width="32" height="52" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-top-arrow-skin0000" x="888" y="36" width="44" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="check-disabled-icon0000" x="196" y="68" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="check-selected-disabled-icon0000" x="248" y="68" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="check-selected-up-icon0000" x="300" y="68" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="check-up-icon0000" x="274" y="68" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-button-down-skin0000" x="1008" y="68" width="12" height="12" pivotX="0" pivotY="-0.05"/>
	<SubTexture name="danger-button-up-skin0000" x="464" y="92" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-bottom-arrow-skin0000" x="860" y="2" width="52" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-left-arrow-skin0000" x="934" y="36" width="26" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-right-arrow-skin0000" x="826" y="2" width="32" height="52" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-top-arrow-skin0000" x="962" y="54" width="44" height="26" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-pop-up-background-skin0000" x="744" y="74" width="22" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-column-drop-indicator-skin0000" x="1018" y="28" width="2" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-column-resize-skin0000" x="962" y="36" width="2" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-divider-skin0000" x="187" y="94" width="6" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-renderer-skin0000" x="195" y="94" width="6" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-sort-ascending-icon0000" x="163" y="94" width="10" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-sort-descending-icon0000" x="175" y="94" width="10" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="face-disabled-skin0000" x="436" y="92" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="face-up-skin0000" x="450" y="92" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="focus-indicator-skin0000" x="1008" y="54" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="forward-button-disabled-skin0000" x="792" y="56" width="28" height="40" pivotX="0" pivotY="0"/>
	<SubTexture name="forward-button-down-skin0000" x="32" y="68" width="28" height="40" pivotX="0" pivotY="0"/>
	<SubTexture name="forward-button-up-skin0000" x="62" y="68" width="28" height="40" pivotX="0" pivotY="0"/>
	<SubTexture name="full-screen-toggle-button-enter-up-icon0000" x="92" y="68" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="full-screen-toggle-button-exit-up-icon0000" x="118" y="68" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="header-background-skin0000" x="106" y="94" width="12" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="header-renderer-skin0000" x="227" y="94" width="6" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="horizontal-scroll-bar-decrement-button-icon0000" x="144" y="94" width="7" height="11" pivotX="-0.05" pivotY="-0.05"/>
	<SubTexture name="horizontal-scroll-bar-increment-button-icon0000" x="852" y="68" width="6" height="10" pivotX="0" pivotY="0.05"/>
	<SubTexture name="inset-background-danger-skin0000" x="422" y="92" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="inset-background-disabled-skin0000" x="998" y="82" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="inset-background-enabled-skin0000" x="496" y="88" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="inset-background-focused-skin0000" x="352" y="92" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-hover-skin0000" x="203" y="94" width="6" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-selected-skin0000" x="211" y="94" width="6" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-up-skin0000" x="219" y="94" width="6" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="list-accessory-drill-down-icon0000" x="852" y="56" width="6" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="list-background-skin0000" x="380" y="92" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="list-inset-background-skin0000" x="394" y="92" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="mute-toggle-button-loud-up-icon0000" x="170" y="68" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="mute-toggle-button-muted-up-icon0000" x="326" y="68" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="overlay-play-pause-toggle-button-play-down-icon0000" x="516" y="2" width="100" height="120" pivotX="0" pivotY="0"/>
	<SubTexture name="overlay-play-pause-toggle-button-play-up-icon0000" x="618" y="2" width="100" height="120" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-selected-symbol0000" x="852" y="82" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-symbol0000" x="870" y="82" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="panel-background-skin0000" x="408" y="92" width="12" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="panel-header-background-skin0000" x="92" y="94" width="12" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="pf-ronda-seven-font" x="2" y="2" width="512" height="64" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-disabled-icon0000" x="1012" y="82" width="10" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-icon0000" x="120" y="94" width="10" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-selected-icon0000" x="132" y="94" width="10" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="play-pause-toggle-button-pause-up-icon0000" x="222" y="68" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="play-pause-toggle-button-play-up-icon0000" x="144" y="68" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="pop-up-background-skin0000" x="352" y="68" width="22" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="pop-up-volume-slider-track-skin0000" x="720" y="2" width="70" height="70" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-disabled-icon0000" x="424" y="68" width="22" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-disabled-icon0000" x="448" y="68" width="22" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-up-icon0000" x="472" y="68" width="22" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-up-icon0000" x="720" y="74" width="22" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="search-disabled-icon0000" x="496" y="68" width="18" height="18" pivotX="0" pivotY="0"/>
	<SubTexture name="search-enabled-icon0000" x="768" y="74" width="18" height="18" pivotX="0" pivotY="0"/>
	<SubTexture name="seek-slider-progress-skin0000" x="1018" y="2" width="4" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="simple-scroll-bar-thumb-skin0000" x="153" y="94" width="8" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-disabled-skin0000" x="918" y="82" width="18" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-selected-disabled-skin0000" x="938" y="82" width="18" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-selected-up-skin0000" x="958" y="82" width="18" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-up-skin0000" x="978" y="82" width="18" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-closed-icon0000" x="376" y="68" width="22" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-open-icon0000" x="400" y="68" width="22" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-decrement-button-icon0000" x="163" y="94" width="10" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-increment-button-icon0000" x="175" y="94" width="10" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="volume-slider-maximum-track-skin0000" x="968" y="2" width="48" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="volume-slider-minimum-track-skin0000" x="968" y="28" width="48" height="24" pivotX="0" pivotY="0"/>
</TextureAtlas>


================================================
FILE: themes/MinimalDesktopTheme/package-src.json
================================================
{
	"id": "feathersui_MinimalDesktopTheme-source",
	"name": "Feathers UI Minimal Desktop Theme",
	"url": "https://feathersui.com/as3-starling/",
	"docUrl": "https://feathersui/api-reference/",
	"description": "Minimal desktop theme for Feathers UI (Starling version)",
	"type": "src",
	"version": "4.2.0",
	"sourceUrl": "https://github.com/feathersui/feathersui-starling/releases/download/v4.2.0/feathersui_MinimalDesktopTheme-source_4.2.0.airpackage",
	"publishedAt": "2021-11-19T00:00:00.000Z",
	"dependencies": [
		"starling-source:2.x.x",
		"feathersui-source:4.2.x"
	],
	"parameters": [],
	"tags": ["theme", "feathers", "starling"],
	"status": "release",
	"license": {
	  "type": "Simplified BSD",
	  "url": "https://github.com/feathersui/feathersui-starling/blob/v4.2.0/LICENSE.md",
	  "public": true
	}
  }
  

================================================
FILE: themes/MinimalDesktopTheme/package-swc.json
================================================
{
	"id": "feathersui_MinimalDesktopTheme",
	"name": "Feathers UI Minimal Desktop Theme",
	"url": "https://feathersui.com/as3-starling/",
	"docUrl": "https://feathersui/api-reference/",
	"description": "Minimal desktop theme for Feathers UI (Starling version)",
	"type": "swc",
	"version": "4.2.0",
	"sourceUrl": "https://github.com/feathersui/feathersui-starling/releases/download/v4.2.0/feathersui_MinimalDesktopTheme_4.2.0.airpackage",
	"publishedAt": "2021-11-19T00:00:00.000Z",
	"dependencies": [
		"starling:2.x.x",
		"feathersui:4.2.x"
	],
	"parameters": [],
	"tags": ["theme", "feathers", "starling"],
	"status": "release",
	"license": {
	  "type": "Simplified BSD",
	  "url": "https://github.com/feathersui/feathersui-starling/blob/v4.2.0/LICENSE.md",
	  "public": true
	}
  }
  

================================================
FILE: themes/MinimalDesktopTheme/source/feathers/themes/BaseMinimalDesktopTheme.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import feathers.controls.Alert;
	import feathers.controls.AutoComplete;
	import feathers.controls.AutoSizeMode;
	import feathers.controls.Button;
	import feathers.controls.ButtonGroup;
	import feathers.controls.ButtonState;
	import feathers.controls.Callout;
	import feathers.controls.Check;
	import feathers.controls.DataGrid;
	import feathers.controls.DateTimeSpinner;
	import feathers.controls.Drawers;
	import feathers.controls.GroupedList;
	import feathers.controls.Header;
	import feathers.controls.IScrollBar;
	import feathers.controls.ImageLoader;
	import feathers.controls.Label;
	import feathers.controls.LayoutGroup;
	import feathers.controls.List;
	import feathers.controls.NumericStepper;
	import feathers.controls.PageIndicator;
	import feathers.controls.PageIndicatorInteractionMode;
	import feathers.controls.Panel;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.controls.ProgressBar;
	import feathers.controls.Radio;
	import feathers.controls.ScrollBar;
	import feathers.controls.ScrollBarDisplayMode;
	import feathers.controls.ScrollContainer;
	import feathers.controls.ScrollInteractionMode;
	import feathers.controls.ScrollPolicy;
	import feathers.controls.ScrollScreen;
	import feathers.controls.ScrollText;
	import feathers.controls.Scroller;
	import feathers.controls.SimpleScrollBar;
	import feathers.controls.Slider;
	import feathers.controls.SpinnerList;
	import feathers.controls.StepperButtonLayoutMode;
	import feathers.controls.TabBar;
	import feathers.controls.TextArea;
	import feathers.controls.TextCallout;
	import feathers.controls.TextInput;
	import feathers.controls.TextInputState;
	import feathers.controls.Toast;
	import feathers.controls.ToggleButton;
	import feathers.controls.ToggleSwitch;
	import feathers.controls.TrackLayoutMode;
	import feathers.controls.Tree;
	import feathers.controls.popups.DropDownPopUpContentManager;
	import feathers.controls.renderers.BaseDefaultItemRenderer;
	import feathers.controls.renderers.DefaultDataGridCellRenderer;
	import feathers.controls.renderers.DefaultDataGridHeaderRenderer;
	import feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer;
	import feathers.controls.renderers.DefaultGroupedListItemRenderer;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.DefaultTreeItemRenderer;
	import feathers.controls.text.BitmapFontTextEditor;
	import feathers.controls.text.BitmapFontTextRenderer;
	import feathers.controls.text.TextFieldTextEditorViewPort;
	import feathers.core.FeathersControl;
	import feathers.core.FocusManager;
	import feathers.core.PopUpManager;
	import feathers.core.ToolTipManager;
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.RelativePosition;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.media.FullScreenToggleButton;
	import feathers.media.MuteToggleButton;
	import feathers.media.PlayPauseToggleButton;
	import feathers.media.SeekSlider;
	import feathers.media.VideoPlayer;
	import feathers.media.VolumeSlider;
	import feathers.skins.ImageSkin;

	import flash.geom.Rectangle;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Image;
	import starling.display.Quad;
	import starling.display.Stage;
	import starling.text.TextField;
	import starling.text.TextFormat;
	import starling.textures.Texture;
	import starling.textures.TextureAtlas;
	import starling.textures.TextureSmoothing;

	/**
	 * The base class for the "Minimal" theme for desktop Feathers apps. Handles
	 * everything except asset loading, which is left to subclasses.
	 *
	 * @see MinimalDesktopTheme
	 * @see MinimalDesktopThemeWithAssetManager
	 */
	public class BaseMinimalDesktopTheme extends StyleNameFunctionTheme
	{
		/**
		 * The name of the embedded bitmap font used by controls in this theme.
		 */
		public static const FONT_NAME:String = "PF Ronda Seven";

		/**
		 * The stack of fonts to use for controls that don't use embedded fonts.
		 */
		public static const FONT_NAME_STACK:String = "PF Ronda Seven,Roboto,Helvetica,Arial,_sans";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a horizontal slider.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK:String = "minimal-desktop-horizontal-slider-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a vertical slider.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK:String = "minimal-desktop-vertical-slider-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the decrement button of a horizontal scroll bar.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_DECREMENT_BUTTON:String = "minimal-desktop-horizontal-scroll-bar-decrement-button";

		/**
		 * @private
		 * The theme's custom style name for the increment button of a horizontal scroll bar.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_INCREMENT_BUTTON:String = "minimal-desktop-horizontal-scroll-bar-increment-button";

		/**
		 * @private
		 * The theme's custom style name for the decrement button of a horizontal scroll bar.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_DECREMENT_BUTTON:String = "minimal-desktop-vertical-scroll-bar-decrement-button";

		/**
		 * @private
		 * The theme's custom style name for the increment button of a vertical scroll bar.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_INCREMENT_BUTTON:String = "minimal-desktop-vertical-scroll-bar-increment-button";

		/**
		 * @private
		 */
		protected static const THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_THUMB:String = "minimal-desktop-pop-up-volume-slider-thumb";

		/**
		 * @private
		 */
		protected static const THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_MINIMUM_TRACK:String = "minimal-desktop-pop-up-volume-slider-minimum-track";

		/**
		 * @private
		 */
		protected static const THEME_STYLE_NAME_NUMERIC_STEPPER_TEXT_INPUT_TEXT_EDITOR:String = "minimal-desktop-numeric-stepper-text-input-text-editor";

		/**
		 * @private
		 */
		protected static const THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER:String = "minimal-desktop-date-time-spinner-list-item-renderer";

		/**
		 * @private
		 * The theme's custom style name for the text renderer of a tool tip Label.
		 */
		protected static const THEME_STYLE_NAME_TOOL_TIP_LABEL_TEXT_RENDERER:String = "minimal-desktop-tool-tip-label-text-renderer";

		/**
		 * @private
		 */
		protected static const THEME_STYLE_NAME_ALERT_BUTTON_GROUP_BUTTON:String = "minimal-desktop-alert-button-group-button";
		
		/**
		 * @private
		 * The theme's custom style name for a button in a Toast.
		 */
		protected static const THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON:String = "minimal-mobile-toast-actions-button";

		protected static const FONT_TEXTURE_NAME:String = "pf-ronda-seven-font";

		protected static const ATLAS_SCALE_FACTOR:Number = 2;

		protected static const SOLID_COLOR_TEXTURE_REGION:Rectangle = new Rectangle(1, 1, 1, 1);

		protected static const DEFAULT_SCALE_9_GRID:Rectangle = new Rectangle(3, 3, 1, 1);
		protected static const SCROLLBAR_THUMB_SCALE_9_GRID:Rectangle = new Rectangle(1, 1, 2, 2);
		protected static const TAB_SCALE_9_GRID:Rectangle = new Rectangle(4, 4, 1, 1);
		protected static const HEADER_SCALE_9_GRID:Rectangle = new Rectangle(0, 2, 3, 1);
		protected static const VOLUME_SLIDER_TRACK_SCALE9_GRID:Rectangle = new Rectangle(18, 13, 1, 1);
		protected static const SEEK_SLIDER_PROGRESS_SKIN_SCALE9_GRID:Rectangle = new Rectangle(0, 2, 2, 10);
		protected static const BACK_BUTTON_SCALE_9_GRID:Rectangle = new Rectangle(11, 0, 1, 20);
		protected static const FORWARD_BUTTON_SCALE_9_GRID:Rectangle = new Rectangle(1, 0, 1, 20);
		protected static const DATA_GRID_COLUMN_RESIZE_SKIN_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 1, 3);
		protected static const DATA_GRID_HEADER_DIVIDER_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 3, 3);
		protected static const DATA_GRID_HEADER_RENDERER_SCALE_9_GRID:Rectangle = new Rectangle(1, 1, 1, 1);
		protected static const DATA_GRID_COLUMN_DROP_INDICATOR_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 1, 3);

		protected static const BACKGROUND_COLOR:uint = 0xf3f3f3;
		protected static const PRIMARY_TEXT_COLOR:uint = 0x666666;
		protected static const DISABLED_TEXT_COLOR:uint = 0x999999;
		protected static const DANGER_TEXT_COLOR:uint = 0x990000;
		protected static const MODAL_OVERLAY_COLOR:uint = 0xcccccc;
		protected static const MODAL_OVERLAY_ALPHA:Number = 0.4;
		protected static const VIDEO_OVERLAY_COLOR:uint = 0xcccccc;
		protected static const VIDEO_OVERLAY_ALPHA:Number = 0.2;
		protected static const DATA_GRID_COLUMN_OVERLAY_COLOR:uint = 0xeeeeee;
		protected static const DATA_GRID_COLUMN_OVERLAY_ALPHA:Number = 0.6;

		/**
		 * The default global text renderer factory for this theme creates a
		 * BitmapFontTextRenderer.
		 */
		protected static function textRendererFactory():BitmapFontTextRenderer
		{
			var renderer:BitmapFontTextRenderer = new BitmapFontTextRenderer();
			//since it's a pixel font, we don't want to smooth it.
			renderer.textureSmoothing = TextureSmoothing.NONE;
			return renderer;
		}

		/**
		 * The default global text editor factory for this theme creates a
		 * BitmapFontTextEditor.
		 */
		protected static function textEditorFactory():BitmapFontTextEditor
		{
			return new BitmapFontTextEditor();
		}

		/**
		 * This theme's scroll bar type is ScrollBar.
		 */
		protected static function scrollBarFactory():IScrollBar
		{
			return new ScrollBar();
		}

		protected static function popUpOverlayFactory():DisplayObject
		{
			var quad:Quad = new Quad(100, 100, MODAL_OVERLAY_COLOR);
			quad.alpha = MODAL_OVERLAY_ALPHA;
			return quad;
		}
		
		protected static function pickerListButtonFactory():ToggleButton
		{
			return new ToggleButton();
		}

		/**
		 * Constructor.
		 */
		public function BaseMinimalDesktopTheme()
		{
			super();
		}

		/**
		 * A normal font size. Since it's a pixel font, we want a multiple of
		 * the original size, which, in this case, is 8.
		 */
		protected var fontSize:int = 8;

		/**
		 * A larger font size for headers.
		 */
		protected var largeFontSize:int = 16;

		/**
		 * The size, in pixels, of major regions in the grid. Used for sizing
		 * containers and larger UI controls.
		 */
		protected var gridSize:int = 30;

		/**
		 * The size, in pixels, of minor regions in the grid. Used for larger
		 * padding and gaps.
		 */
		protected var gutterSize:int = 8;

		/**
		 * The size, in pixels, of smaller padding and gaps within the major
		 * regions in the grid.
		 */
		protected var smallGutterSize:int = 4;

		/**
		 * The size, in pixels, of very smaller padding and gaps.
		 */
		protected var extraSmallGutterSize:int = 2;

		/**
		 * The width, in pixels, of UI controls that span across multiple grid regions.
		 */
		protected var wideControlSize:int = 98;

		/**
		 * The width, in pixels, of very large UI controls.
		 */
		protected var extraWideControlSize:int = 210;

		/**
		 * The minimum width, in pixels, of some types of buttons.
		 */
		protected var buttonMinWidth:int = 64;

		/**
		 * The size, in pixels, of a typical UI control.
		 */
		protected var controlSize:int = 20;

		/**
		 * The size, in pixels, of smaller UI controls.
		 */
		protected var smallControlSize:int = 12;

		/**
		 * The size, in pixels, of a border around any control.
		 */
		protected var borderSize:int = 1;

		/**
		 * The size, in pixels, of a drop shadow on a control's bottom right.
		 */
		protected var dropShadowSize:int = 4;

		protected var calloutBackgroundMinSize:int = 5;
		protected var calloutTopLeftArrowOverlapGapSize:int = -2;
		protected var calloutBottomRightArrowOverlapGapSize:int = -6;
		protected var progressBarFillMinSize:int = 7;
		protected var popUpSize:int = 336;
		protected var dropDownGapSize:int = -1;
		protected var focusPaddingSize:int = -2;
		protected var popUpVolumeSliderPaddingTopLeft:int = 9;
		protected var popUpVolumeSliderPaddingBottomRight:int = 13;

		/**
		 * The texture atlas that contains skins for this theme. This base class
		 * does not initialize this member variable. Subclasses are expected to
		 * load the assets somehow and set the <code>atlas</code> member
		 * variable before calling <code>initialize()</code>.
		 */
		protected var atlas:TextureAtlas;

		protected var focusIndicatorSkinTexture:Texture;

		protected var buttonUpSkinTexture:Texture;
		protected var buttonDownSkinTexture:Texture;
		protected var buttonDisabledSkinTexture:Texture;
		protected var buttonSelectedSkinTexture:Texture;
		protected var buttonSelectedDisabledSkinTexture:Texture;
		protected var buttonCallToActionUpSkinTexture:Texture;
		protected var buttonDangerUpSkinTexture:Texture;
		protected var buttonDangerDownSkinTexture:Texture;
		protected var buttonBackUpSkinTexture:Texture;
		protected var buttonBackDownSkinTexture:Texture;
		protected var buttonBackDisabledSkinTexture:Texture;
		protected var buttonForwardUpSkinTexture:Texture;
		protected var buttonForwardDownSkinTexture:Texture;
		protected var buttonForwardDisabledSkinTexture:Texture;

		protected var tabSkinTexture:Texture;
		protected var tabDisabledSkinTexture:Texture;
		protected var tabSelectedSkinTexture:Texture;
		protected var tabSelectedDisabledSkinTexture:Texture;

		protected var thumbSkinTexture:Texture;
		protected var thumbDisabledSkinTexture:Texture;

		protected var simpleScrollBarThumbSkinTexture:Texture;

		protected var insetBackgroundSkinTexture:Texture;
		protected var insetBackgroundDisabledSkinTexture:Texture;
		protected var insetBackgroundFocusedSkinTexture:Texture;
		protected var insetBackgroundDangerSkinTexture:Texture;

		protected var pickerListButtonIconUpTexture:Texture;
		protected var pickerListButtonIconSelectedTexture:Texture;
		protected var pickerListButtonIconDisabledTexture:Texture;
		protected var searchIconTexture:Texture;
		protected var searchIconDisabledTexture:Texture;
		protected var verticalScrollBarDecrementButtonIconTexture:Texture;
		protected var verticalScrollBarIncrementButtonIconTexture:Texture;
		protected var horizontalScrollBarIncrementButtonIconTexture:Texture;
		protected var horizontalScrollBarDecrementButtonIconTexture:Texture;

		protected var headerSkinTexture:Texture;
		protected var panelHeaderSkinTexture:Texture;

		protected var panelBackgroundSkinTexture:Texture;
		protected var popUpBackgroundSkinTexture:Texture;
		protected var dangerPopUpBackgroundSkinTexture:Texture;
		
		protected var calloutTopArrowSkinTexture:Texture;
		protected var calloutBottomArrowSkinTexture:Texture;
		protected var calloutLeftArrowSkinTexture:Texture;
		protected var calloutRightArrowSkinTexture:Texture;
		protected var dangerCalloutTopArrowSkinTexture:Texture;
		protected var dangerCalloutBottomArrowSkinTexture:Texture;
		protected var dangerCalloutLeftArrowSkinTexture:Texture;
		protected var dangerCalloutRightArrowSkinTexture:Texture;

		protected var checkIconTexture:Texture;
		protected var checkDisabledIconTexture:Texture;
		protected var checkSelectedIconTexture:Texture;
		protected var checkSelectedDisabledIconTexture:Texture;

		protected var radioIconTexture:Texture;
		protected var radioDisabledIconTexture:Texture;
		protected var radioSelectedIconTexture:Texture;
		protected var radioSelectedDisabledIconTexture:Texture;

		protected var pageIndicatorSymbolTexture:Texture;
		protected var pageIndicatorSelectedSymbolTexture:Texture;

		protected var listBackgroundSkinTexture:Texture;
		protected var listInsetBackgroundSkinTexture:Texture;
		
		protected var itemRendererUpSkinTexture:Texture;
		protected var itemRendererHoverSkinTexture:Texture;
		protected var itemRendererSelectedSkinTexture:Texture;
		protected var headerRendererSkinTexture:Texture;
		
		protected var listDrillDownAccessoryTexture:Texture;

		protected var treeDisclosureOpenIconTexture:Texture;
		protected var treeDisclosureClosedIconTexture:Texture;

		protected var dataGridHeaderRendererSkinTexture:Texture;
		protected var dataGridColumnResizeSkinTexture:Texture;
		protected var dataGridHeaderDividerSkinTexture:Texture;
		protected var dataGridColumnDropIndicatorSkinTexture:Texture;
		protected var dataGridHeaderSortAscendingIconTexture:Texture;
		protected var dataGridHeaderSortDescendingIconTexture:Texture;

		//media textures
		protected var playPauseButtonPlayUpIconTexture:Texture;
		protected var playPauseButtonPauseUpIconTexture:Texture;
		protected var overlayPlayPauseButtonPlayUpIconTexture:Texture;
		protected var overlayPlayPauseButtonPlayDownIconTexture:Texture;
		protected var fullScreenToggleButtonEnterUpIconTexture:Texture;
		protected var fullScreenToggleButtonExitUpIconTexture:Texture;
		protected var muteToggleButtonLoudUpIconTexture:Texture;
		protected var muteToggleButtonMutedUpIconTexture:Texture;
		protected var volumeSliderMinimumTrackSkinTexture:Texture;
		protected var volumeSliderMaximumTrackSkinTexture:Texture;
		protected var popUpVolumeSliderTrackSkinTexture:Texture;
		protected var seekSliderProgressSkinTexture:Texture;

		protected var primaryFontStyles:TextFormat;
		protected var disabledFontStyles:TextFormat;
		protected var headingFontStyles:TextFormat;
		protected var headingDisabledFontStyles:TextFormat;
		protected var centeredFontStyles:TextFormat;
		protected var centeredDisabledFontStyles:TextFormat;
		protected var dangerFontStyles:TextFormat;
		protected var scrollTextFontStyles:TextFormat;
		protected var scrollTextDisabledFontStyles:TextFormat;

		/**
		 * Disposes the texture atlas and bitmap font before calling
		 * super.dispose().
		 */
		override public function dispose():void
		{
			if(this.atlas)
			{
				//if anything is keeping a reference to the texture, we don't
				//want it to keep a reference to the theme too.
				this.atlas.texture.root.onRestore = null;
				
				this.atlas.dispose();
				this.atlas = null;
			}
			TextField.unregisterCompositor(FONT_NAME);

			var stage:Stage = this.starling.stage;
			FocusManager.setEnabledForStage(stage, false);
			ToolTipManager.setEnabledForStage(stage, false);

			//don't forget to call super.dispose()!
			super.dispose();
		}

		/**
		 * Initializes the theme. Expected to be called by subclasses after the
		 * assets have been loaded and the skin texture atlas has been created.
		 */
		protected function initialize():void
		{
			this.initializeFonts();
			this.initializeTextures();
			this.initializeGlobals();
			this.initializeStage();
			this.initializeStyleProviders();
		}

		/**
		 * Sets the stage background color.
		 */
		protected function initializeStage():void
		{
			this.starling.stage.color = BACKGROUND_COLOR;
			this.starling.nativeStage.color = BACKGROUND_COLOR;
		}

		/**
		 * Initializes global variables (not including global style providers).
		 */
		protected function initializeGlobals():void
		{
			var stage:Stage = this.starling.stage;
			FocusManager.setEnabledForStage(stage, true);
			ToolTipManager.setEnabledForStage(stage, true);

			PopUpManager.overlayFactory = popUpOverlayFactory;
			Callout.stagePadding = this.smallGutterSize;
			Toast.containerFactory = toastContainerFactory;

			FeathersControl.defaultTextRendererFactory = textRendererFactory;
			FeathersControl.defaultTextEditorFactory = textEditorFactory;
		}

		/**
		 * Initializes the textures by extracting them from the atlas and
		 * setting up any scaling grids that are needed.
		 */
		protected function initializeTextures():void
		{
			this.focusIndicatorSkinTexture = this.atlas.getTexture("focus-indicator-skin0000");

			this.buttonUpSkinTexture = this.atlas.getTexture("button-up-skin0000");
			this.buttonDownSkinTexture = this.atlas.getTexture("button-down-skin0000");
			this.buttonDisabledSkinTexture = this.atlas.getTexture("button-disabled-skin0000");
			this.buttonSelectedSkinTexture = this.atlas.getTexture("inset-background-enabled-skin0000");
			this.buttonSelectedDisabledSkinTexture = this.atlas.getTexture("inset-background-disabled-skin0000");
			this.buttonCallToActionUpSkinTexture = this.atlas.getTexture("call-to-action-button-up-skin0000");
			this.buttonDangerUpSkinTexture = this.atlas.getTexture("danger-button-up-skin0000");
			this.buttonDangerDownSkinTexture = this.atlas.getTexture("danger-button-down-skin0000");
			this.buttonBackUpSkinTexture = this.atlas.getTexture("back-button-up-skin0000");
			this.buttonBackDownSkinTexture = this.atlas.getTexture("back-button-down-skin0000");
			this.buttonBackDisabledSkinTexture = this.atlas.getTexture("back-button-disabled-skin0000");
			this.buttonForwardUpSkinTexture = this.atlas.getTexture("forward-button-up-skin0000");
			this.buttonForwardDownSkinTexture = this.atlas.getTexture("forward-button-down-skin0000");
			this.buttonForwardDisabledSkinTexture = this.atlas.getTexture("forward-button-disabled-skin0000");

			this.tabSkinTexture = this.atlas.getTexture("tab-up-skin0000");
			this.tabDisabledSkinTexture = this.atlas.getTexture("tab-disabled-skin0000");
			this.tabSelectedSkinTexture = this.atlas.getTexture("tab-selected-up-skin0000");
			this.tabSelectedDisabledSkinTexture = this.atlas.getTexture("tab-selected-disabled-skin0000");

			this.thumbSkinTexture = this.atlas.getTexture("face-up-skin0000");
			this.thumbDisabledSkinTexture = this.atlas.getTexture("face-disabled-skin0000");

			this.simpleScrollBarThumbSkinTexture = this.atlas.getTexture("simple-scroll-bar-thumb-skin0000");

			this.listBackgroundSkinTexture = this.atlas.getTexture("list-background-skin0000");
			this.listInsetBackgroundSkinTexture = this.atlas.getTexture("list-inset-background-skin0000");
			
			this.itemRendererUpSkinTexture = Texture.fromTexture(this.atlas.getTexture("item-renderer-up-skin0000"), SOLID_COLOR_TEXTURE_REGION);
			this.itemRendererHoverSkinTexture = Texture.fromTexture(this.atlas.getTexture("item-renderer-hover-skin0000"), SOLID_COLOR_TEXTURE_REGION);
			this.itemRendererSelectedSkinTexture = Texture.fromTexture(this.atlas.getTexture("item-renderer-selected-skin0000"), SOLID_COLOR_TEXTURE_REGION);
			this.headerRendererSkinTexture = Texture.fromTexture(this.atlas.getTexture("header-renderer-skin0000"), SOLID_COLOR_TEXTURE_REGION);

			this.insetBackgroundSkinTexture = this.atlas.getTexture("inset-background-enabled-skin0000");
			this.insetBackgroundDisabledSkinTexture = this.atlas.getTexture("inset-background-disabled-skin0000");
			this.insetBackgroundFocusedSkinTexture = this.atlas.getTexture("inset-background-focused-skin0000");
			this.insetBackgroundDangerSkinTexture = this.atlas.getTexture("inset-background-danger-skin0000");

			this.pickerListButtonIconUpTexture = this.atlas.getTexture("picker-list-icon0000");
			this.pickerListButtonIconSelectedTexture = this.atlas.getTexture("picker-list-selected-icon0000");
			this.pickerListButtonIconDisabledTexture = this.atlas.getTexture("picker-list-disabled-icon0000");
			this.searchIconTexture = this.atlas.getTexture("search-enabled-icon0000");
			this.searchIconDisabledTexture = this.atlas.getTexture("search-disabled-icon0000");
			this.verticalScrollBarDecrementButtonIconTexture = this.atlas.getTexture("vertical-scroll-bar-decrement-button-icon0000");
			this.verticalScrollBarIncrementButtonIconTexture = this.atlas.getTexture("vertical-scroll-bar-increment-button-icon0000");
			this.horizontalScrollBarDecrementButtonIconTexture = this.atlas.getTexture("horizontal-scroll-bar-decrement-button-icon0000");
			this.horizontalScrollBarIncrementButtonIconTexture = this.atlas.getTexture("horizontal-scroll-bar-increment-button-icon0000");

			this.headerSkinTexture = this.atlas.getTexture("header-background-skin0000");
			this.panelHeaderSkinTexture = this.atlas.getTexture("panel-header-background-skin0000");

			this.popUpBackgroundSkinTexture = this.atlas.getTexture("pop-up-background-skin0000");
			this.dangerPopUpBackgroundSkinTexture = this.atlas.getTexture("danger-pop-up-background-skin0000");
			this.panelBackgroundSkinTexture = this.atlas.getTexture("panel-background-skin0000");
			this.calloutTopArrowSkinTexture = this.atlas.getTexture("callout-top-arrow-skin0000");
			this.calloutBottomArrowSkinTexture = this.atlas.getTexture("callout-bottom-arrow-skin0000");
			this.calloutLeftArrowSkinTexture = this.atlas.getTexture("callout-left-arrow-skin0000");
			this.calloutRightArrowSkinTexture = this.atlas.getTexture("callout-right-arrow-skin0000");
			this.dangerCalloutTopArrowSkinTexture = this.atlas.getTexture("danger-callout-top-arrow-skin0000");
			this.dangerCalloutBottomArrowSkinTexture = this.atlas.getTexture("danger-callout-bottom-arrow-skin0000");
			this.dangerCalloutLeftArrowSkinTexture = this.atlas.getTexture("danger-callout-left-arrow-skin0000");
			this.dangerCalloutRightArrowSkinTexture = this.atlas.getTexture("danger-callout-right-arrow-skin0000");

			this.checkIconTexture = this.atlas.getTexture("check-up-icon0000");
			this.checkDisabledIconTexture = this.atlas.getTexture("check-disabled-icon0000");
			this.checkSelectedIconTexture = this.atlas.getTexture("check-selected-up-icon0000");
			this.checkSelectedDisabledIconTexture = this.atlas.getTexture("check-selected-disabled-icon0000");

			this.radioIconTexture = this.atlas.getTexture("radio-up-icon0000");
			this.radioDisabledIconTexture = this.atlas.getTexture("radio-disabled-icon0000");
			this.radioSelectedIconTexture = this.atlas.getTexture("radio-selected-up-icon0000");
			this.radioSelectedDisabledIconTexture = this.atlas.getTexture("radio-selected-disabled-icon0000");

			this.pageIndicatorSymbolTexture = this.atlas.getTexture("page-indicator-symbol0000");
			this.pageIndicatorSelectedSymbolTexture = this.atlas.getTexture("page-indicator-selected-symbol0000");

			this.playPauseButtonPlayUpIconTexture = this.atlas.getTexture("play-pause-toggle-button-play-up-icon0000");
			this.playPauseButtonPauseUpIconTexture = this.atlas.getTexture("play-pause-toggle-button-pause-up-icon0000");
			this.overlayPlayPauseButtonPlayUpIconTexture = this.atlas.getTexture("overlay-play-pause-toggle-button-play-up-icon0000");
			this.overlayPlayPauseButtonPlayDownIconTexture = this.atlas.getTexture("overlay-play-pause-toggle-button-play-down-icon0000");
			this.fullScreenToggleButtonEnterUpIconTexture = this.atlas.getTexture("full-screen-toggle-button-enter-up-icon0000");
			this.fullScreenToggleButtonExitUpIconTexture = this.atlas.getTexture("full-screen-toggle-button-exit-up-icon0000");
			this.muteToggleButtonMutedUpIconTexture = this.atlas.getTexture("mute-toggle-button-muted-up-icon0000");
			this.muteToggleButtonLoudUpIconTexture = this.atlas.getTexture("mute-toggle-button-loud-up-icon0000");
			this.volumeSliderMinimumTrackSkinTexture = this.atlas.getTexture("volume-slider-minimum-track-skin0000");
			this.volumeSliderMaximumTrackSkinTexture = this.atlas.getTexture("volume-slider-maximum-track-skin0000");
			this.popUpVolumeSliderTrackSkinTexture = this.atlas.getTexture("pop-up-volume-slider-track-skin0000");
			this.seekSliderProgressSkinTexture = this.atlas.getTexture("seek-slider-progress-skin0000");

			this.listDrillDownAccessoryTexture = this.atlas.getTexture("list-accessory-drill-down-icon0000");

			this.treeDisclosureOpenIconTexture = this.atlas.getTexture("tree-disclosure-open-icon0000");
			this.treeDisclosureClosedIconTexture = this.atlas.getTexture("tree-disclosure-closed-icon0000");

			this.dataGridColumnResizeSkinTexture = this.atlas.getTexture("data-grid-column-resize-skin0000");
			this.dataGridHeaderDividerSkinTexture = this.atlas.getTexture("data-grid-header-divider-skin0000");
			this.dataGridHeaderRendererSkinTexture = this.atlas.getTexture("data-grid-header-renderer-skin0000");
			this.dataGridColumnDropIndicatorSkinTexture = this.atlas.getTexture("data-grid-column-drop-indicator-skin0000");
			this.dataGridHeaderSortAscendingIconTexture = this.atlas.getTexture("data-grid-header-sort-ascending-icon0000");
			this.dataGridHeaderSortDescendingIconTexture = this.atlas.getTexture("data-grid-header-sort-descending-icon0000");
		}

		/**
		 * Initializes font sizes and formats.
		 */
		protected function initializeFonts():void
		{
			this.primaryFontStyles = new TextFormat(FONT_NAME, this.fontSize, PRIMARY_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.disabledFontStyles = new TextFormat(FONT_NAME, this.fontSize, DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.headingFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, PRIMARY_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.headingDisabledFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.centeredFontStyles = new TextFormat(FONT_NAME, this.fontSize, PRIMARY_TEXT_COLOR, HorizontalAlign.CENTER, VerticalAlign.TOP);
			this.centeredDisabledFontStyles = new TextFormat(FONT_NAME, this.fontSize, DISABLED_TEXT_COLOR, HorizontalAlign.CENTER, VerticalAlign.TOP);
			this.dangerFontStyles = new TextFormat(FONT_NAME, this.fontSize, DANGER_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.scrollTextFontStyles = new TextFormat(FONT_NAME_STACK, this.fontSize, PRIMARY_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.scrollTextDisabledFontStyles = new TextFormat(FONT_NAME_STACK, this.fontSize, DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
		}

		/**
		 * Sets global style providers for all components.
		 */
		protected function initializeStyleProviders():void
		{
			//alert
			this.getStyleProviderForClass(Alert).defaultStyleFunction = this.setAlertStyles;
			this.getStyleProviderForClass(Header).setFunctionForStyleName(Alert.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setPanelHeaderStyles);
			this.getStyleProviderForClass(ButtonGroup).setFunctionForStyleName(Alert.DEFAULT_CHILD_STYLE_NAME_BUTTON_GROUP, this.setAlertButtonGroupStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_ALERT_BUTTON_GROUP_BUTTON, this.setAlertButtonGroupButtonStyles);

			//autocomplete
			this.getStyleProviderForClass(AutoComplete).defaultStyleFunction = this.setTextInputStyles;
			this.getStyleProviderForClass(List).setFunctionForStyleName(AutoComplete.DEFAULT_CHILD_STYLE_NAME_LIST, this.setDropDownListStyles);

			//button
			this.getStyleProviderForClass(Button).defaultStyleFunction = this.setButtonStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_CALL_TO_ACTION_BUTTON, this.setCallToActionButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_QUIET_BUTTON, this.setQuietButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_DANGER_BUTTON, this.setDangerButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON, this.setBackButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_FORWARD_BUTTON, this.setForwardButtonStyles);

			//button group
			this.getStyleProviderForClass(ButtonGroup).defaultStyleFunction = this.setButtonGroupStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ButtonGroup.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setButtonGroupButtonStyles);
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(ButtonGroup.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setButtonGroupButtonStyles);

			//callout
			this.getStyleProviderForClass(Callout).defaultStyleFunction = this.setCalloutStyles;

			//check
			this.getStyleProviderForClass(Check).defaultStyleFunction = this.setCheckStyles;

			//data grid
			this.getStyleProviderForClass(DataGrid).defaultStyleFunction = this.setDataGridStyles;
			this.getStyleProviderForClass(DefaultDataGridHeaderRenderer).defaultStyleFunction = this.setDataGridHeaderRendererStyles;
			this.getStyleProviderForClass(DefaultDataGridCellRenderer).defaultStyleFunction = this.setItemRendererStyles;

			//date time spinner
			this.getStyleProviderForClass(DateTimeSpinner).defaultStyleFunction = this.setDateTimeSpinnerStyles;
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER, this.setDateTimeSpinnerListItemRendererStyles);

			//drawers
			this.getStyleProviderForClass(Drawers).defaultStyleFunction = this.setDrawersStyles;

			//grouped list (see also: item renderers)
			this.getStyleProviderForClass(GroupedList).defaultStyleFunction = this.setGroupedListStyles;
			this.getStyleProviderForClass(GroupedList).setFunctionForStyleName(GroupedList.ALTERNATE_STYLE_NAME_INSET_GROUPED_LIST, this.setInsetGroupedListStyles);

			//header
			this.getStyleProviderForClass(Header).defaultStyleFunction = this.setHeaderStyles;

			//item renderers for lists
			this.getStyleProviderForClass(DefaultListItemRenderer).defaultStyleFunction = this.setItemRendererStyles;
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(DefaultListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN, this.setDrillDownItemRendererStyles);
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(DefaultListItemRenderer.ALTERNATE_STYLE_NAME_CHECK, this.setCheckItemRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).defaultStyleFunction = this.setItemRendererStyles;
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(DefaultGroupedListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN, this.setDrillDownItemRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(DefaultGroupedListItemRenderer.ALTERNATE_STYLE_NAME_CHECK, this.setCheckItemRendererStyles);

			//header and footer renderers for grouped list
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).defaultStyleFunction = this.setGroupedListHeaderOrFooterRendererStyles;
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).setFunctionForStyleName(GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_HEADER_RENDERER, this.setInsetGroupedListHeaderOrFooterRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).setFunctionForStyleName(GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_FOOTER_RENDERER, this.setInsetGroupedListHeaderOrFooterRendererStyles);

			//label
			this.getStyleProviderForClass(Label).defaultStyleFunction = this.setLabelStyles;
			this.getStyleProviderForClass(Label).setFunctionForStyleName(Label.ALTERNATE_STYLE_NAME_HEADING, this.setHeadingLabelStyles);
			//no detail label because the font size would be too small
			this.getStyleProviderForClass(Label).setFunctionForStyleName(Label.ALTERNATE_STYLE_NAME_TOOL_TIP, this.setToolTipLabelStyles);

			//layout group
			this.getStyleProviderForClass(LayoutGroup).setFunctionForStyleName(LayoutGroup.ALTERNATE_STYLE_NAME_TOOLBAR, this.setToolbarLayoutGroupStyles);

			//list (see also: item renderers)
			this.getStyleProviderForClass(List).defaultStyleFunction = this.setListStyles;

			//numeric stepper
			this.getStyleProviderForClass(NumericStepper).defaultStyleFunction = this.setNumericStepperStyles;
			this.getStyleProviderForClass(TextInput).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_TEXT_INPUT, this.setNumericStepperTextInputStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON, this.setNumericStepperButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON, this.setNumericStepperButtonStyles);
			this.getStyleProviderForClass(BitmapFontTextEditor).setFunctionForStyleName(THEME_STYLE_NAME_NUMERIC_STEPPER_TEXT_INPUT_TEXT_EDITOR, this.setNumericStepperTextInputTextEditorStyles);

			//page indicator
			this.getStyleProviderForClass(PageIndicator).defaultStyleFunction = this.setPageIndicatorStyles;

			//panel
			this.getStyleProviderForClass(Panel).defaultStyleFunction = this.setPanelStyles;
			this.getStyleProviderForClass(Header).setFunctionForStyleName(Panel.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setPanelHeaderStyles);

			//panel screen
			this.getStyleProviderForClass(PanelScreen).defaultStyleFunction = this.setPanelScreenStyles;

			//picker list (see also: item renderers)
			this.getStyleProviderForClass(PickerList).defaultStyleFunction = this.setPickerListStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setPickerListButtonStyles);
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setPickerListButtonStyles);
			this.getStyleProviderForClass(List).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_LIST, this.setDropDownListStyles);

			//progress bar
			this.getStyleProviderForClass(ProgressBar).defaultStyleFunction = this.setProgressBarStyles;

			//radio
			this.getStyleProviderForClass(Radio).defaultStyleFunction = this.setRadioStyles;

			//scroll bar
			this.getStyleProviderForClass(ScrollBar).setFunctionForStyleName(Scroller.DEFAULT_CHILD_STYLE_NAME_HORIZONTAL_SCROLL_BAR, this.setHorizontalScrollBarStyles);
			this.getStyleProviderForClass(ScrollBar).setFunctionForStyleName(Scroller.DEFAULT_CHILD_STYLE_NAME_VERTICAL_SCROLL_BAR, this.setVerticalScrollBarStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ScrollBar.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setScrollBarThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ScrollBar.DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK, this.setScrollBarMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_DECREMENT_BUTTON, this.setHorizontalScrollBarDecrementButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_INCREMENT_BUTTON, this.setHorizontalScrollBarIncrementButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_DECREMENT_BUTTON, this.setVerticalScrollBarDecrementButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_INCREMENT_BUTTON, this.setVerticalScrollBarIncrementButtonStyles);

			//scroll container
			this.getStyleProviderForClass(ScrollContainer).defaultStyleFunction = this.setScrollContainerStyles;
			this.getStyleProviderForClass(ScrollContainer).setFunctionForStyleName(ScrollContainer.ALTERNATE_STYLE_NAME_TOOLBAR, this.setToolbarScrollContainerStyles);

			//scroll screen
			this.getStyleProviderForClass(ScrollScreen).defaultStyleFunction = this.setScrollScreenStyles;

			//scroll text
			this.getStyleProviderForClass(ScrollText).defaultStyleFunction = this.setScrollTextStyles;

			//simple scroll bar
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SimpleScrollBar.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setSimpleScrollBarThumbStyles);

			//slider
			this.getStyleProviderForClass(Slider).defaultStyleFunction = this.setSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Slider.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK, this.setHorizontalSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK, this.setVerticalSliderMinimumTrackStyles);

			//spinner list
			this.getStyleProviderForClass(SpinnerList).defaultStyleFunction = this.setSpinnerListStyles;
			
			//tab bar
			this.getStyleProviderForClass(TabBar).defaultStyleFunction = this.setTabBarStyles;
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(TabBar.DEFAULT_CHILD_STYLE_NAME_TAB, this.setTabStyles);

			//text input
			this.getStyleProviderForClass(TextInput).defaultStyleFunction = this.setTextInputStyles;
			this.getStyleProviderForClass(TextInput).setFunctionForStyleName(TextInput.ALTERNATE_STYLE_NAME_SEARCH_TEXT_INPUT, this.setSearchTextInputStyles);
			this.getStyleProviderForClass(BitmapFontTextEditor).setFunctionForStyleName(TextInput.DEFAULT_CHILD_STYLE_NAME_TEXT_EDITOR, this.setTextInputTextEditorStyles);
			this.getStyleProviderForClass(TextCallout).setFunctionForStyleName(TextInput.DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT, this.setTextInputErrorCalloutStyles);

			//text area
			this.getStyleProviderForClass(TextArea).defaultStyleFunction = this.setTextAreaStyles;
			this.getStyleProviderForClass(TextCallout).setFunctionForStyleName(TextArea.DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT, this.setTextAreaErrorCalloutStyles);

			//text callout
			this.getStyleProviderForClass(TextCallout).defaultStyleFunction = this.setTextCalloutStyles;

			//toast
			this.getStyleProviderForClass(Toast).defaultStyleFunction = this.setToastStyles;
			this.getStyleProviderForClass(ButtonGroup).setFunctionForStyleName(Toast.DEFAULT_CHILD_STYLE_NAME_ACTIONS, this.setToastActionsStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON, this.setToastActionsButtonStyles);

			//toggle button
			this.getStyleProviderForClass(ToggleButton).defaultStyleFunction = this.setButtonStyles;
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_QUIET_BUTTON, this.setQuietButtonStyles);

			//toggle switch
			this.getStyleProviderForClass(ToggleSwitch).defaultStyleFunction = this.setToggleSwitchStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setToggleSwitchThumbStyles);
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setToggleSwitchThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_ON_TRACK, this.setToggleSwitchOnTrackStyles);
			
			//tree
			this.getStyleProviderForClass(Tree).defaultStyleFunction = this.setTreeStyles;
			this.getStyleProviderForClass(DefaultTreeItemRenderer).defaultStyleFunction = this.setTreeItemRendererStyles;

			//media controls
			this.getStyleProviderForClass(VideoPlayer).defaultStyleFunction = this.setVideoPlayerStyles;

			//play/pause toggle button
			this.getStyleProviderForClass(PlayPauseToggleButton).defaultStyleFunction = this.setPlayPauseToggleButtonStyles;
			this.getStyleProviderForClass(PlayPauseToggleButton).setFunctionForStyleName(PlayPauseToggleButton.ALTERNATE_STYLE_NAME_OVERLAY_PLAY_PAUSE_TOGGLE_BUTTON, this.setOverlayPlayPauseToggleButtonStyles);

			//full screen toggle button
			this.getStyleProviderForClass(FullScreenToggleButton).defaultStyleFunction = this.setFullScreenToggleButtonStyles;

			//mute toggle button
			this.getStyleProviderForClass(MuteToggleButton).defaultStyleFunction = this.setMuteToggleButtonStyles;
			this.getStyleProviderForClass(VolumeSlider).setFunctionForStyleName(MuteToggleButton.DEFAULT_CHILD_STYLE_NAME_VOLUME_SLIDER, this.setPopUpVolumeSliderStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_THUMB, this.setSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_MINIMUM_TRACK, this.setPopUpVolumeSliderTrackStyles);

			//seek slider
			this.getStyleProviderForClass(SeekSlider).defaultStyleFunction = this.setSeekSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SeekSlider.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SeekSlider.DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK, this.setHorizontalSliderMinimumTrackStyles);

			//volume slider
			this.getStyleProviderForClass(VolumeSlider).defaultStyleFunction = this.setVolumeSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(VolumeSlider.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setVolumeSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(VolumeSlider.DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK, this.setVolumeSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(VolumeSlider.DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK, this.setVolumeSliderMaximumTrackStyles);
		}

		protected function pageIndicatorNormalSymbolFactory():DisplayObject
		{
			return new Image(this.pageIndicatorSymbolTexture);
		}

		protected function pageIndicatorSelectedSymbolFactory():DisplayObject
		{
			return new Image(this.pageIndicatorSelectedSymbolTexture);
		}

		protected function dataGridHeaderDividerFactory():DisplayObject
		{
			var skin:ImageSkin = new ImageSkin(this.dataGridHeaderDividerSkinTexture);
			skin.scale9Grid = DATA_GRID_HEADER_DIVIDER_SCALE_9_GRID;
			return skin;
		}

		protected function toastContainerFactory():DisplayObjectContainer
		{
			var container:LayoutGroup = new LayoutGroup();
			container.autoSizeMode = AutoSizeMode.STAGE;

			var layout:VerticalLayout = new VerticalLayout();
			layout.verticalAlign = VerticalAlign.BOTTOM;
			layout.horizontalAlign = HorizontalAlign.LEFT;
			layout.padding = this.gutterSize;
			layout.gap = this.gutterSize;
			container.layout = layout;

			return container;
		}

	//-------------------------
	// Shared
	//-------------------------

		protected function setScrollerStyles(scroller:Scroller):void
		{
			scroller.interactionMode = ScrollInteractionMode.MOUSE;
			scroller.scrollBarDisplayMode = ScrollBarDisplayMode.FIXED;
			scroller.horizontalScrollBarFactory = scrollBarFactory;
			scroller.verticalScrollBarFactory = scrollBarFactory;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			scroller.focusIndicatorSkin = focusIndicatorSkin;
			scroller.focusPadding = 0;
		}

		protected function setDropDownListStyles(list:List):void
		{
			this.setListStyles(list);

			var layout:VerticalLayout = new VerticalLayout();
			layout.useVirtualLayout = true;
			layout.padding = 0;
			layout.gap = 0;
			layout.horizontalAlign = HorizontalAlign.JUSTIFY;
			layout.verticalAlign = VerticalAlign.TOP;
			layout.resetTypicalItemDimensionsOnMeasure = true;
			layout.maxRowCount = 5;
			list.layout = layout;
		}

	//-------------------------
	// Alert
	//-------------------------

		protected function setAlertStyles(alert:Alert):void
		{
			this.setScrollerStyles(alert);

			var backgroundSkin:Image = new Image(this.popUpBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			alert.backgroundSkin = backgroundSkin;

			alert.fontStyles = this.primaryFontStyles.clone();
			alert.disabledFontStyles = this.disabledFontStyles.clone();

			alert.paddingTop = this.gutterSize;
			alert.paddingRight = this.gutterSize;
			alert.paddingBottom = this.smallGutterSize;
			alert.paddingLeft = this.gutterSize;
			alert.outerPadding = this.borderSize;
			alert.outerPaddingBottom = this.borderSize + this.dropShadowSize;
			alert.outerPaddingRight = this.borderSize + this.dropShadowSize;
			alert.gap = this.smallGutterSize;
			alert.maxWidth = this.popUpSize;
			alert.maxHeight = this.popUpSize;
		}

		protected function setAlertButtonGroupStyles(group:ButtonGroup):void
		{
			group.customButtonStyleName = THEME_STYLE_NAME_ALERT_BUTTON_GROUP_BUTTON;
			group.direction = Direction.HORIZONTAL;
			group.horizontalAlign = HorizontalAlign.CENTER;
			group.verticalAlign = VerticalAlign.JUSTIFY;
			group.distributeButtonSizes = false;
			group.gap = this.smallGutterSize;
			group.padding = this.smallGutterSize;
		}

		protected function setAlertButtonGroupButtonStyles(button:Button):void
		{
			this.setButtonStyles(button);
		}

	//-------------------------
	// Button
	//-------------------------

		protected function setBaseButtonStyles(button:Button):void
		{
			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;

			button.paddingTop = this.smallGutterSize;
			button.paddingBottom = this.smallGutterSize;
			button.paddingLeft = this.gutterSize;
			button.paddingRight = this.gutterSize;
			button.gap = this.smallGutterSize;
			button.minGap = this.smallGutterSize;
		}

		protected function setButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				skin.selectedTexture = this.buttonSelectedSkinTexture;
				skin.setTextureForState(ButtonState.DOWN_AND_SELECTED,  this.buttonDownSkinTexture);
				skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED,  this.buttonSelectedDisabledSkinTexture);
			}
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.buttonMinWidth;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setCallToActionButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonCallToActionUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.buttonMinWidth;
			skin.height = this.controlSize;
			skin.minWidth = this.buttonMinWidth;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setQuietButtonStyles(button:Button):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			button.defaultSkin = defaultSkin;

			var otherSkin:ImageSkin = new ImageSkin(null);
			otherSkin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				otherSkin.selectedTexture = this.buttonSelectedSkinTexture;
				otherSkin.setTextureForState(ButtonState.DOWN_AND_SELECTED,  this.buttonDownSkinTexture);
				otherSkin.setTextureForState(ButtonState.DISABLED_AND_SELECTED,  this.buttonSelectedDisabledSkinTexture);
				ToggleButton(button).defaultSelectedSkin = otherSkin;
				button.setSkinForState(ButtonState.DOWN_AND_SELECTED, otherSkin);
				button.setSkinForState(ButtonState.DISABLED_AND_SELECTED, otherSkin);
			}
			button.setSkinForState(ButtonState.DOWN, otherSkin);
			otherSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			otherSkin.width = this.controlSize;
			otherSkin.height = this.controlSize;
			otherSkin.minWidth = this.controlSize;
			otherSkin.minHeight = this.controlSize;

			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setDangerButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonDangerUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDangerDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.buttonMinWidth;
			skin.height = this.controlSize;
			skin.minWidth = this.buttonMinWidth;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.dangerFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setBackButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonBackUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonBackDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonBackDisabledSkinTexture);
			skin.scale9Grid = BACK_BUTTON_SCALE_9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			skin.textureSmoothing = TextureSmoothing.NONE;
			button.defaultSkin = skin;

			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);

			button.paddingLeft = 2 * this.gutterSize;
		}

		protected function setForwardButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonForwardUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonForwardDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonForwardDisabledSkinTexture);
			skin.scale9Grid = FORWARD_BUTTON_SCALE_9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			skin.textureSmoothing = TextureSmoothing.NONE;
			button.defaultSkin = skin;

			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);

			button.paddingRight = 2 * this.gutterSize;
		}

	//-------------------------
	// ButtonGroup
	//-------------------------

		protected function setButtonGroupStyles(group:ButtonGroup):void
		{
			group.gap = this.smallGutterSize;
		}

		protected function setButtonGroupButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				skin.selectedTexture = this.buttonSelectedSkinTexture;
				skin.setTextureForState(ButtonState.DOWN_AND_SELECTED,  this.buttonDownSkinTexture);
				skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED,  this.buttonSelectedDisabledSkinTexture);
			}
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.wideControlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;

			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			button.paddingTop = this.smallGutterSize;
			button.paddingBottom = this.smallGutterSize;
			button.paddingLeft = this.gutterSize;
			button.paddingRight = this.gutterSize;
			button.gap = this.smallGutterSize;
			button.minGap = this.smallGutterSize;
		}

	//-------------------------
	// Callout
	//-------------------------

		protected function setCalloutStyles(callout:Callout):void
		{
			callout.padding = this.gutterSize;
			callout.paddingRight = this.gutterSize + this.dropShadowSize;
			callout.paddingBottom = this.gutterSize + this.dropShadowSize;

			var backgroundSkin:Image = new Image(this.popUpBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundSkin.width = this.calloutBackgroundMinSize;
			backgroundSkin.height = this.calloutBackgroundMinSize;
			callout.backgroundSkin = backgroundSkin;

			var topArrowSkin:Image = new Image(this.calloutTopArrowSkinTexture);
			callout.topArrowSkin = topArrowSkin;
			callout.topArrowGap = this.calloutTopLeftArrowOverlapGapSize;

			var bottomArrowSkin:Image = new Image(this.calloutBottomArrowSkinTexture);
			callout.bottomArrowSkin = bottomArrowSkin;
			callout.bottomArrowGap = this.calloutBottomRightArrowOverlapGapSize;

			var leftArrowSkin:Image = new Image(this.calloutLeftArrowSkinTexture);
			callout.leftArrowSkin = leftArrowSkin;
			callout.leftArrowGap = this.calloutTopLeftArrowOverlapGapSize;

			var rightArrowSkin:Image = new Image(this.calloutRightArrowSkinTexture);
			callout.rightArrowSkin = rightArrowSkin;
			callout.rightArrowGap = this.calloutBottomRightArrowOverlapGapSize;
		}

		protected function setDangerCalloutStyles(callout:Callout):void
		{
			callout.padding = this.gutterSize;
			callout.paddingRight = this.gutterSize + this.dropShadowSize;
			callout.paddingBottom = this.gutterSize + this.dropShadowSize;

			var backgroundSkin:Image = new Image(this.dangerPopUpBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundSkin.width = this.calloutBackgroundMinSize;
			backgroundSkin.height = this.calloutBackgroundMinSize;
			callout.backgroundSkin = backgroundSkin;

			var topArrowSkin:Image = new Image(this.dangerCalloutTopArrowSkinTexture);
			callout.topArrowSkin = topArrowSkin;
			callout.topArrowGap = this.calloutTopLeftArrowOverlapGapSize;

			var bottomArrowSkin:Image = new Image(this.dangerCalloutBottomArrowSkinTexture);
			callout.bottomArrowSkin = bottomArrowSkin;
			callout.bottomArrowGap = this.calloutBottomRightArrowOverlapGapSize;

			var leftArrowSkin:Image = new Image(this.dangerCalloutLeftArrowSkinTexture);
			callout.leftArrowSkin = leftArrowSkin;
			callout.leftArrowGap = this.calloutTopLeftArrowOverlapGapSize;

			var rightArrowSkin:Image = new Image(this.dangerCalloutRightArrowSkinTexture);
			callout.rightArrowSkin = rightArrowSkin;
			callout.rightArrowGap = this.calloutBottomRightArrowOverlapGapSize;
		}

	//-------------------------
	// Check
	//-------------------------

		protected function setCheckStyles(check:Check):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			check.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.checkIconTexture);
			icon.selectedTexture = this.checkSelectedIconTexture;
			icon.setTextureForState(ButtonState.DISABLED, this.checkDisabledIconTexture);
			icon.setTextureForState(ButtonState.DISABLED_AND_SELECTED,  this.checkSelectedDisabledIconTexture);
			icon.textureSmoothing = TextureSmoothing.NONE;
			check.defaultIcon = icon;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			check.focusIndicatorSkin = focusIndicatorSkin;
			check.focusPaddingLeft = this.focusPaddingSize;
			check.focusPaddingRight = this.focusPaddingSize;

			check.fontStyles = this.primaryFontStyles.clone();
			check.disabledFontStyles = this.disabledFontStyles.clone();

			check.gap = this.smallGutterSize;
			check.horizontalAlign = HorizontalAlign.LEFT;
			check.verticalAlign = VerticalAlign.MIDDLE;
		}

	//-------------------------
	// DataGrid
	//-------------------------

		protected function setDataGridStyles(grid:DataGrid):void
		{
			this.setScrollerStyles(grid);

			grid.verticalScrollPolicy = ScrollPolicy.AUTO;

			var backgroundSkin:ImageSkin = new ImageSkin(this.listBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			grid.backgroundSkin = backgroundSkin;

			var backgroundDisabledSkin:ImageSkin = new ImageSkin(this.buttonDisabledSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundDisabledSkin.width = this.controlSize;
			backgroundDisabledSkin.height = this.controlSize;
			grid.backgroundDisabledSkin = backgroundDisabledSkin;

			var columnDragOverlaySkin:Quad = new Quad(1, 1, DATA_GRID_COLUMN_OVERLAY_COLOR);
			columnDragOverlaySkin.alpha = DATA_GRID_COLUMN_OVERLAY_ALPHA;
			grid.columnDragOverlaySkin = columnDragOverlaySkin;

			var columnResizeSkin:ImageSkin = new ImageSkin(this.dataGridColumnResizeSkinTexture);
			columnResizeSkin.scale9Grid = DATA_GRID_COLUMN_RESIZE_SKIN_SCALE_9_GRID;
			grid.columnResizeSkin = columnResizeSkin;

			var columnDropIndicatorSkin:ImageSkin = new ImageSkin(this.dataGridColumnDropIndicatorSkinTexture);
			columnDropIndicatorSkin.scale9Grid = DATA_GRID_COLUMN_DROP_INDICATOR_SCALE_9_GRID;
			grid.columnDropIndicatorSkin = columnDropIndicatorSkin;

			grid.headerDividerFactory = this.dataGridHeaderDividerFactory;

			grid.padding = this.borderSize;
			grid.paddingRight = 0;
		}

		protected function setDataGridHeaderRendererStyles(headerRenderer:DefaultDataGridHeaderRenderer):void
		{
			var backgroundSkin:ImageSkin = new ImageSkin(this.dataGridHeaderRendererSkinTexture);
			backgroundSkin.scale9Grid = DATA_GRID_HEADER_RENDERER_SCALE_9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			backgroundSkin.minWidth = this.controlSize;
			backgroundSkin.minHeight = this.controlSize;
			headerRenderer.backgroundSkin = backgroundSkin;

			headerRenderer.sortAscendingIcon = new ImageSkin(this.dataGridHeaderSortAscendingIconTexture);
			headerRenderer.sortDescendingIcon = new ImageSkin(this.dataGridHeaderSortDescendingIconTexture);

			headerRenderer.fontStyles = this.primaryFontStyles.clone();
			headerRenderer.disabledFontStyles = this.disabledFontStyles.clone();

			headerRenderer.paddingTop = this.smallGutterSize;
			headerRenderer.paddingBottom = this.smallGutterSize;
			headerRenderer.paddingLeft = this.gutterSize;
			headerRenderer.paddingRight = this.gutterSize;
		}

	//-------------------------
	// DateTimeSpinner
	//-------------------------

		protected function setDateTimeSpinnerStyles(spinner:DateTimeSpinner):void
		{
			spinner.customItemRendererStyleName = THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER;
		}

		protected function setDateTimeSpinnerListItemRendererStyles(itemRenderer:DefaultListItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);
			itemRenderer.accessoryPosition = RelativePosition.LEFT;
			itemRenderer.accessoryGap = this.smallGutterSize;
		}

	//-------------------------
	// Drawers
	//-------------------------

		protected function setDrawersStyles(drawers:Drawers):void
		{
			var overlaySkin:Quad = new Quad(10, 10, MODAL_OVERLAY_COLOR);
			overlaySkin.alpha = MODAL_OVERLAY_ALPHA;
			drawers.overlaySkin = overlaySkin;
		}

	//-------------------------
	// GroupedList
	//-------------------------

		protected function setGroupedListStyles(list:GroupedList):void
		{
			this.setScrollerStyles(list);

			list.verticalScrollPolicy = ScrollPolicy.AUTO;

			var backgroundSkin:Image = new Image(this.listBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			list.backgroundSkin = backgroundSkin;

			var backgroundDisabledSkin:Image = new Image(this.buttonDisabledSkinTexture);
			backgroundDisabledSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundDisabledSkin.width = this.gridSize;
			backgroundDisabledSkin.height = this.gridSize;
			list.backgroundDisabledSkin = backgroundDisabledSkin;

			list.padding = this.borderSize;
		}

		//see List section for item renderer styles

		protected function setGroupedListHeaderOrFooterRendererStyles(renderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			var backgroundSkin:ImageSkin = new ImageSkin(this.headerRendererSkinTexture);
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			backgroundSkin.minWidth = this.controlSize;
			backgroundSkin.minHeight = this.controlSize;
			renderer.backgroundSkin = backgroundSkin;

			renderer.fontStyles = this.primaryFontStyles.clone();
			renderer.disabledFontStyles = this.disabledFontStyles.clone();

			renderer.paddingTop = this.smallGutterSize;
			renderer.paddingBottom = this.smallGutterSize;
			renderer.paddingLeft = this.gutterSize;
			renderer.paddingRight = this.gutterSize;
		}

		protected function setInsetGroupedListStyles(list:GroupedList):void
		{
			this.setScrollerStyles(list);

			var backgroundSkin:Image = new Image(this.listInsetBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			list.backgroundSkin = backgroundSkin;

			var backgroundDisabledSkin:Image = new Image(this.buttonDisabledSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundDisabledSkin.width = this.gridSize;
			backgroundDisabledSkin.height = this.gridSize;
			list.backgroundDisabledSkin = backgroundDisabledSkin;

			list.verticalScrollPolicy = ScrollPolicy.AUTO;

			list.customHeaderRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_HEADER_RENDERER;
			list.customFooterRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_FOOTER_RENDERER;

			var layout:VerticalLayout = new VerticalLayout();
			layout.useVirtualLayout = true;
			layout.padding = this.gutterSize;
			layout.paddingTop = 0;
			layout.gap = 0;
			layout.horizontalAlign = HorizontalAlign.JUSTIFY;
			layout.verticalAlign = VerticalAlign.TOP;
			list.layout = layout;
		}

		protected function setInsetGroupedListHeaderOrFooterRendererStyles(renderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			renderer.backgroundSkin = skin;

			renderer.fontStyles = this.primaryFontStyles.clone();
			renderer.disabledFontStyles = this.disabledFontStyles.clone();

			renderer.paddingTop = this.smallGutterSize;
			renderer.paddingBottom = this.smallGutterSize;
			renderer.paddingLeft = this.gutterSize;
			renderer.paddingRight = this.gutterSize;
		}

	//-------------------------
	// Header
	//-------------------------

		protected function setHeaderStyles(header:Header):void
		{
			header.paddingTop = this.smallGutterSize;
			header.paddingBottom = this.smallGutterSize;
			header.paddingRight = this.gutterSize;
			header.paddingLeft = this.gutterSize;
			header.gap = this.smallGutterSize;
			header.titleGap = this.smallGutterSize;

			header.fontStyles = this.primaryFontStyles.clone();
			header.disabledFontStyles = this.disabledFontStyles.clone();

			var backgroundSkin:ImageSkin = new ImageSkin(this.headerSkinTexture);
			backgroundSkin.scale9Grid = HEADER_SCALE_9_GRID;
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			header.backgroundSkin = backgroundSkin;
		}

	//-------------------------
	// Label
	//-------------------------

		protected function setLabelStyles(label:Label):void
		{
			label.fontStyles = this.primaryFontStyles.clone();
			label.disabledFontStyles = this.disabledFontStyles.clone();
		}

		protected function setHeadingLabelStyles(label:Label):void
		{
			label.fontStyles = this.headingFontStyles.clone();
			label.disabledFontStyles = this.headingDisabledFontStyles.clone();
		}

		protected function setToolTipLabelStyles(label:Label):void
		{
			var backgroundSkin:Image = new Image(this.popUpBackgroundSkinTexture)
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			label.backgroundSkin = backgroundSkin;

			label.fontStyles = this.primaryFontStyles.clone();
			label.disabledFontStyles = this.disabledFontStyles.clone();

			label.padding = this.smallGutterSize;
			label.paddingBottom = this.smallGutterSize + this.dropShadowSize;
			label.paddingRight = this.smallGutterSize + this.dropShadowSize;
		}

	//-------------------------
	// LayoutGroup
	//-------------------------

		protected function setToolbarLayoutGroupStyles(group:LayoutGroup):void
		{
			if(!group.layout)
			{
				var layout:HorizontalLayout = new HorizontalLayout();
				layout.padding = this.gutterSize;
				layout.gap = this.smallGutterSize;
				layout.verticalAlign = VerticalAlign.MIDDLE;
				group.layout = layout;
			}

			var backgroundSkin:ImageSkin = new ImageSkin(this.headerSkinTexture);
			backgroundSkin.scale9Grid = HEADER_SCALE_9_GRID;
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			group.backgroundSkin = backgroundSkin;
		}

	//-------------------------
	// List
	//-------------------------

		protected function setListStyles(list:List):void
		{
			this.setScrollerStyles(list);

			list.verticalScrollPolicy = ScrollPolicy.AUTO;

			var backgroundSkin:Image = new Image(this.listBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			list.backgroundSkin = backgroundSkin;

			var backgroundDisabledSkin:Image = new Image(this.buttonDisabledSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundDisabledSkin.width = this.controlSize;
			backgroundDisabledSkin.height = this.controlSize;
			list.backgroundDisabledSkin = backgroundDisabledSkin;

			var dropIndicatorSkin:Quad = new Quad(this.borderSize, this.borderSize, PRIMARY_TEXT_COLOR);
			list.dropIndicatorSkin = dropIndicatorSkin;

			list.padding = this.borderSize;
			list.paddingRight = 0;
		}

		protected function setItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			skin.selectedTexture = this.itemRendererSelectedSkinTexture;
			skin.setTextureForState(ButtonState.HOVER, this.itemRendererHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.itemRendererSelectedSkinTexture);
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			itemRenderer.defaultSkin = skin;

			itemRenderer.fontStyles = this.primaryFontStyles.clone();
			itemRenderer.disabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.iconLabelFontStyles = this.primaryFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.accessoryLabelFontStyles = this.primaryFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.disabledFontStyles.clone();

			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;
			itemRenderer.paddingTop = this.smallGutterSize;
			itemRenderer.paddingBottom = this.smallGutterSize;
			itemRenderer.paddingLeft = this.gutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.gap = this.smallGutterSize;
			itemRenderer.minGap = this.smallGutterSize;
			itemRenderer.iconPosition = RelativePosition.LEFT;
			itemRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			itemRenderer.minAccessoryGap = this.smallGutterSize;
			itemRenderer.accessoryPosition = RelativePosition.RIGHT;

			itemRenderer.useStateDelayTimer = false;
		}

		protected function setDrillDownItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			itemRenderer.itemHasAccessory = false;
			var defaultAccessory:ImageLoader = new ImageLoader();
			defaultAccessory.source = this.listDrillDownAccessoryTexture;
			itemRenderer.defaultAccessory = defaultAccessory;
		}

		protected function setCheckItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			skin.selectedTexture = this.itemRendererSelectedSkinTexture;
			skin.setTextureForState(ButtonState.HOVER, this.itemRendererHoverSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.itemRendererSelectedSkinTexture);
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			itemRenderer.defaultSkin = skin;

			itemRenderer.itemHasIcon = false;

			var icon:ImageSkin = new ImageSkin(this.checkIconTexture);
			icon.selectedTexture = this.checkSelectedIconTexture;
			itemRenderer.defaultIcon = icon;

			itemRenderer.fontStyles = this.primaryFontStyles.clone();
			itemRenderer.disabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.iconLabelFontStyles = this.primaryFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.accessoryLabelFontStyles = this.primaryFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.disabledFontStyles.clone();

			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;
			itemRenderer.paddingTop = this.smallGutterSize;
			itemRenderer.paddingBottom = this.smallGutterSize;
			itemRenderer.paddingLeft = this.gutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.gap = this.smallGutterSize;
			itemRenderer.minGap = this.smallGutterSize;
			itemRenderer.iconPosition = RelativePosition.LEFT;
			itemRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			itemRenderer.minAccessoryGap = this.smallGutterSize;
			itemRenderer.accessoryPosition = RelativePosition.RIGHT;

			itemRenderer.useStateDelayTimer = false;
		}

	//-------------------------
	// NumericStepper
	//-------------------------

		protected function setNumericStepperStyles(stepper:NumericStepper):void
		{
			stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_HORIZONTAL;
			stepper.incrementButtonLabel = "+";
			stepper.decrementButtonLabel = "-";

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			stepper.focusIndicatorSkin = focusIndicatorSkin;
			stepper.focusPadding = this.focusPaddingSize;
		}

		protected function setNumericStepperButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			button.defaultSkin = skin;
			button.keepDownStateOnRollOut = true;
			this.setBaseButtonStyles(button);
		}

		protected function setNumericStepperTextInputStyles(input:TextInput):void
		{
			input.gap = this.smallGutterSize;
			input.paddingTop = this.smallGutterSize;
			input.paddingBottom = this.smallGutterSize;
			input.paddingLeft = this.gutterSize;
			input.paddingRight = this.gutterSize;

			input.fontStyles = this.centeredFontStyles.clone();
			input.disabledFontStyles = this.centeredDisabledFontStyles.clone();

			var skin:ImageSkin = new ImageSkin(this.insetBackgroundSkinTexture);
			skin.setTextureForState(TextInputState.DISABLED, this.insetBackgroundDisabledSkinTexture);
			skin.setTextureForState(TextInputState.FOCUSED, this.insetBackgroundFocusedSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.gridSize;
			skin.height = this.controlSize;
			skin.minWidth = this.gridSize;
			skin.minHeight = this.controlSize;
			input.backgroundSkin = skin;
		}

		protected function setNumericStepperTextInputTextEditorStyles(textEditor:BitmapFontTextEditor):void
		{
			textEditor.cursorSkin = new Quad(1, 1, PRIMARY_TEXT_COLOR);
			textEditor.selectionSkin = new Quad(1, 1, BACKGROUND_COLOR);
		}

	//-------------------------
	// PageIndicator
	//-------------------------

		protected function setPageIndicatorStyles(pageIndicator:PageIndicator):void
		{
			pageIndicator.interactionMode = PageIndicatorInteractionMode.PRECISE;

			pageIndicator.normalSymbolFactory = this.pageIndicatorNormalSymbolFactory;
			pageIndicator.selectedSymbolFactory = this.pageIndicatorSelectedSymbolFactory;

			pageIndicator.gap = this.gutterSize;
			pageIndicator.padding = this.smallGutterSize;
		}

	//-------------------------
	// Panel
	//-------------------------

		protected function setPanelStyles(panel:Panel):void
		{
			this.setScrollerStyles(panel);

			var backgroundSkin:Image = new Image(this.panelBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			panel.backgroundSkin = backgroundSkin;

			panel.padding = this.gutterSize;
		}

		protected function setPanelHeaderStyles(header:Header):void
		{
			var backgroundSkin:ImageSkin = new ImageSkin(this.panelHeaderSkinTexture);
			backgroundSkin.scale9Grid = HEADER_SCALE_9_GRID;
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			header.backgroundSkin = backgroundSkin;

			header.fontStyles = this.primaryFontStyles.clone();
			header.disabledFontStyles = this.disabledFontStyles.clone();

			header.paddingTop = this.smallGutterSize;
			header.paddingBottom = this.smallGutterSize;
			header.paddingRight = this.gutterSize;
			header.paddingLeft = this.gutterSize;
			header.gap = this.smallGutterSize;
			header.titleGap = this.smallGutterSize;
		}

	//-------------------------
	// PanelScreen
	//-------------------------

		protected function setPanelScreenStyles(screen:PanelScreen):void
		{
			this.setScrollerStyles(screen);
		}

	//-------------------------
	// PickerList
	//-------------------------

		protected function setPickerListStyles(list:PickerList):void
		{
			list.toggleButtonOnOpenAndClose = true;
			var popUpContentManager:DropDownPopUpContentManager = new DropDownPopUpContentManager();
			popUpContentManager.gap = this.dropDownGapSize;
			list.popUpContentManager = popUpContentManager;
			list.buttonFactory = pickerListButtonFactory;
		}

		protected function setPickerListButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DOWN_AND_SELECTED,  this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.buttonMinWidth;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.pickerListButtonIconUpTexture);
			icon.disabledTexture = this.pickerListButtonIconDisabledTexture;
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				icon.selectedTexture = this.pickerListButtonIconSelectedTexture;
			}
			button.defaultIcon = icon;

			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);

			button.gap = Number.POSITIVE_INFINITY; //fill as completely as possible
			button.minGap = this.gutterSize;
			button.iconPosition = RelativePosition.RIGHT;
			button.horizontalAlign =  HorizontalAlign.LEFT;
		}

		//for the PickerList's pop-up list, see setDropDownListStyles()

	//-------------------------
	// ProgressBar
	//-------------------------

		protected function setProgressBarStyles(progress:ProgressBar):void
		{
			var backgroundSkin:Image = new Image(this.insetBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			if(progress.direction == Direction.VERTICAL)
			{
				backgroundSkin.width = this.smallControlSize;
				backgroundSkin.height = this.wideControlSize;
			}
			else
			{
				backgroundSkin.width = this.wideControlSize;
				backgroundSkin.height = this.smallControlSize;
			}
			progress.backgroundSkin = backgroundSkin;

			var backgroundDisabledSkin:Image = new Image(this.insetBackgroundDisabledSkinTexture);
			backgroundDisabledSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			if(progress.direction == Direction.VERTICAL)
			{
				backgroundDisabledSkin.width = this.smallControlSize;
				backgroundDisabledSkin.height = this.wideControlSize;
			}
			else
			{
				backgroundDisabledSkin.width = this.wideControlSize;
				backgroundDisabledSkin.height = this.smallControlSize;
			}
			progress.backgroundDisabledSkin = backgroundDisabledSkin;

			var fillSkin:Image = new Image(this.buttonUpSkinTexture);
			fillSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			if(progress.direction == Direction.VERTICAL)
			{
				fillSkin.width = this.smallControlSize;
				fillSkin.height = this.progressBarFillMinSize;
			}
			else
			{
				fillSkin.width = this.progressBarFillMinSize;
				fillSkin.height = this.smallControlSize;
			}
			progress.fillSkin = fillSkin;

			var fillDisabledSkin:Image = new Image(this.buttonDisabledSkinTexture);
			fillDisabledSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			if(progress.direction == Direction.VERTICAL)
			{
				fillDisabledSkin.width = this.smallControlSize;
				fillDisabledSkin.height = this.progressBarFillMinSize;
			}
			else
			{
				fillDisabledSkin.width = this.progressBarFillMinSize;
				fillDisabledSkin.height = this.smallControlSize;
			}
			progress.fillDisabledSkin = fillDisabledSkin;
		}

	//-------------------------
	// Radio
	//-------------------------

		protected function setRadioStyles(radio:Radio):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			radio.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.radioIconTexture);
			icon.selectedTexture = this.radioSelectedIconTexture;
			icon.setTextureForState(ButtonState.DISABLED, this.radioDisabledIconTexture);
			icon.setTextureForState(ButtonState.DISABLED_AND_SELECTED,  this.radioSelectedDisabledIconTexture);
			radio.defaultIcon = icon;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			radio.focusIndicatorSkin = focusIndicatorSkin;
			radio.focusPadding = this.focusPaddingSize;

			radio.fontStyles = this.primaryFontStyles.clone();
			radio.disabledFontStyles = this.disabledFontStyles.clone();

			radio.gap = this.smallGutterSize;
			radio.horizontalAlign = HorizontalAlign.LEFT;
			radio.verticalAlign = VerticalAlign.MIDDLE;
		}

	//-------------------------
	// ScrollBar
	//-------------------------

		protected function setHorizontalScrollBarStyles(scrollBar:ScrollBar):void
		{
			scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;

			scrollBar.customIncrementButtonStyleName = THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_INCREMENT_BUTTON;
			scrollBar.customDecrementButtonStyleName = THEME_STYLE_NAME_HORIZONTAL_SCROLL_BAR_DECREMENT_BUTTON;
		}

		protected function setVerticalScrollBarStyles(scrollBar:ScrollBar):void
		{
			scrollBar.trackLayoutMode = TrackLayoutMode.SINGLE;

			scrollBar.customIncrementButtonStyleName = THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_INCREMENT_BUTTON;
			scrollBar.customDecrementButtonStyleName = THEME_STYLE_NAME_VERTICAL_SCROLL_BAR_DECREMENT_BUTTON;
		}

		protected function setScrollBarThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.thumbSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.thumbDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.minWidth = this.smallControlSize;
			skin.minHeight = this.smallControlSize;
			thumb.defaultSkin = skin;

			thumb.hasLabelTextRenderer = false;
		}

		protected function setScrollBarMinimumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.insetBackgroundSkinTexture);
			skin.disabledTexture = this.insetBackgroundDisabledSkinTexture;
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.smallControlSize;
			track.defaultSkin = skin;

			track.hasLabelTextRenderer = false;
		}

		protected function setBaseScrollBarButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.smallControlSize;
			skin.minWidth = this.smallControlSize;
			skin.minHeight = this.smallControlSize;
			button.defaultSkin = skin;

			button.horizontalAlign = HorizontalAlign.CENTER;
			button.verticalAlign = VerticalAlign.MIDDLE;
			button.padding = 0;
			button.gap = 0;
			button.minGap = 0;

			button.hasLabelTextRenderer = false;
		}

		protected function setHorizontalScrollBarDecrementButtonStyles(button:Button):void
		{
			this.setBaseScrollBarButtonStyles(button);

			var defaultIcon:Image = new Image(this.horizontalScrollBarDecrementButtonIconTexture);
			button.defaultIcon = defaultIcon;

			var disabledIcon:Quad = new Quad(this.horizontalScrollBarDecrementButtonIconTexture.frameWidth,
				this.horizontalScrollBarDecrementButtonIconTexture.frameHeight);
			button.disabledIcon = disabledIcon;
		}

		protected function setHorizontalScrollBarIncrementButtonStyles(button:Button):void
		{
			this.setBaseScrollBarButtonStyles(button);

			var defaultIcon:Image = new Image(this.horizontalScrollBarIncrementButtonIconTexture);
			button.defaultIcon = defaultIcon;

			var disabledIcon:Quad = new Quad(this.horizontalScrollBarIncrementButtonIconTexture.frameWidth,
				this.horizontalScrollBarIncrementButtonIconTexture.frameHeight);
			button.disabledIcon = disabledIcon;
		}

		protected function setVerticalScrollBarDecrementButtonStyles(button:Button):void
		{
			this.setBaseScrollBarButtonStyles(button);

			var defaultIcon:Image = new Image(this.verticalScrollBarDecrementButtonIconTexture);
			button.defaultIcon = defaultIcon;

			var disabledIcon:Quad = new Quad(this.verticalScrollBarDecrementButtonIconTexture.frameWidth,
				this.verticalScrollBarDecrementButtonIconTexture.frameHeight);
			button.disabledIcon = disabledIcon;
		}

		protected function setVerticalScrollBarIncrementButtonStyles(button:Button):void
		{
			this.setBaseScrollBarButtonStyles(button);

			var defaultIcon:Image = new Image(this.verticalScrollBarIncrementButtonIconTexture);
			button.defaultIcon = defaultIcon;

			var disabledIcon:Quad = new Quad(this.verticalScrollBarIncrementButtonIconTexture.frameWidth,
				this.verticalScrollBarIncrementButtonIconTexture.frameHeight);
			button.disabledIcon = disabledIcon;
		}

	//-------------------------
	// ScrollContainer
	//-------------------------

		protected function setScrollContainerStyles(container:ScrollContainer):void
		{
			this.setScrollerStyles(container);
		}

		protected function setToolbarScrollContainerStyles(container:ScrollContainer):void
		{
			this.setScrollerStyles(container);

			if(!container.layout)
			{
				var layout:HorizontalLayout = new HorizontalLayout();
				layout.padding = this.gutterSize;
				layout.gap = this.smallGutterSize;
				layout.verticalAlign = VerticalAlign.MIDDLE;
				container.layout = layout;
			}

			var backgroundSkin:ImageSkin = new ImageSkin(this.headerSkinTexture);
			backgroundSkin.scale9Grid = HEADER_SCALE_9_GRID;
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			container.backgroundSkin = backgroundSkin;
		}

	//-------------------------
	// ScrollScreen
	//-------------------------

		protected function setScrollScreenStyles(screen:ScrollScreen):void
		{
			this.setScrollerStyles(screen);
		}

	//-------------------------
	// ScrollText
	//-------------------------

		protected function setScrollTextStyles(text:ScrollText):void
		{
			this.setScrollerStyles(text);

			text.fontStyles = this.scrollTextFontStyles.clone();
			text.disabledFontStyles = this.scrollTextDisabledFontStyles.clone();

			text.padding = this.gutterSize;
		}

	//-------------------------
	// SimpleScrollBar
	//-------------------------

		protected function setSimpleScrollBarThumbStyles(thumb:Button):void
		{
			var defaultSkin:Image = new Image(this.simpleScrollBarThumbSkinTexture);
			defaultSkin.scale9Grid = SCROLLBAR_THUMB_SCALE_9_GRID;
			defaultSkin.width = this.smallControlSize;
			defaultSkin.height = this.smallControlSize;
			thumb.defaultSkin = defaultSkin;

			thumb.hasLabelTextRenderer = false;
		}

	//-------------------------
	// Slider
	//-------------------------

		protected function setSliderStyles(slider:Slider):void
		{
			slider.trackLayoutMode = TrackLayoutMode.SINGLE;

			if(slider.direction == Direction.VERTICAL)
			{
				slider.customMinimumTrackStyleName = THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK;
			}
			else //horizontal
			{
				slider.customMinimumTrackStyleName = THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK;
			}

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			slider.focusIndicatorSkin = focusIndicatorSkin;
			slider.focusPadding = this.focusPaddingSize;
		}

		protected function setHorizontalSliderMinimumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.insetBackgroundSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.insetBackgroundDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.smallControlSize;
			skin.minWidth = this.wideControlSize;
			skin.minHeight = this.smallControlSize;
			track.defaultSkin = skin;

			track.hasLabelTextRenderer = false;
		}

		protected function setVerticalSliderMinimumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.insetBackgroundSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.insetBackgroundDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.wideControlSize;
			skin.minWidth = this.smallControlSize;
			skin.minHeight = this.wideControlSize;
			track.defaultSkin = skin;

			track.hasLabelTextRenderer = false;
		}

		protected function setSliderThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.thumbSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.thumbDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.smallControlSize;
			thumb.defaultSkin = skin;

			thumb.hasLabelTextRenderer = false;
		}

	//-------------------------
	// SpinnerList
	//-------------------------

		protected function setSpinnerListStyles(list:SpinnerList):void
		{
			this.setListStyles(list);
		}

	//-------------------------
	// TabBar
	//-------------------------

		protected function setTabBarStyles(tabBar:TabBar):void
		{
			tabBar.distributeTabSizes = false;
			tabBar.horizontalAlign = HorizontalAlign.LEFT;
			tabBar.verticalAlign = VerticalAlign.JUSTIFY;
		}

		protected function setTabStyles(tab:ToggleButton):void
		{
			var skin:ImageSkin = new ImageSkin(this.tabSkinTexture);
			skin.selectedTexture = this.tabSelectedSkinTexture;
			skin.setTextureForState(ButtonState.DISABLED, this.tabDisabledSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED,  this.tabSelectedDisabledSkinTexture);
			skin.scale9Grid = TAB_SCALE_9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			tab.defaultSkin = skin;

			tab.fontStyles = this.primaryFontStyles.clone();
			tab.disabledFontStyles = this.disabledFontStyles.clone();

			tab.iconPosition = RelativePosition.LEFT;

			tab.paddingTop = this.smallGutterSize;
			tab.paddingBottom = this.smallGutterSize;
			tab.paddingLeft = this.gutterSize;
			tab.paddingRight = this.gutterSize;
			tab.gap = this.smallGutterSize;
		}

	//-------------------------
	// TextArea
	//-------------------------

		protected function setTextAreaStyles(textArea:TextArea):void
		{
			this.setScrollerStyles(textArea);

			textArea.padding = this.borderSize;

			var skin:ImageSkin = new ImageSkin(this.insetBackgroundSkinTexture);
			skin.setTextureForState(TextInputState.DISABLED, this.insetBackgroundDisabledSkinTexture);
			skin.setTextureForState(TextInputState.FOCUSED, this.insetBackgroundFocusedSkinTexture);
			skin.setTextureForState(TextInputState.ERROR, this.insetBackgroundDangerSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.wideControlSize * 2;
			skin.height = this.wideControlSize;
			textArea.backgroundSkin = skin;

			textArea.fontStyles = this.scrollTextFontStyles.clone();
			textArea.disabledFontStyles = this.scrollTextDisabledFontStyles.clone();

			textArea.promptFontStyles = this.primaryFontStyles.clone();
			textArea.promptDisabledFontStyles = this.disabledFontStyles.clone();

			textArea.focusPadding = this.focusPaddingSize;
			
			textArea.innerPaddingTop = this.extraSmallGutterSize;
			textArea.innerPaddingRight = this.smallGutterSize;
			textArea.innerPaddingBottom = this.extraSmallGutterSize;
			textArea.innerPaddingLeft = this.smallGutterSize;
		}

		protected function setTextAreaErrorCalloutStyles(callout:TextCallout):void
		{
			this.setDangerTextCalloutStyles(callout);
			callout.horizontalAlign = HorizontalAlign.LEFT;
			callout.verticalAlign = VerticalAlign.TOP;
		}

	//-------------------------
	// TextCallout
	//-------------------------

		protected function setTextCalloutStyles(callout:TextCallout):void
		{
			this.setCalloutStyles(callout);

			callout.fontStyles = this.primaryFontStyles.clone();
			callout.disabledFontStyles = this.disabledFontStyles.clone();
		}

		protected function setDangerTextCalloutStyles(callout:TextCallout):void
		{
			this.setDangerCalloutStyles(callout);

			callout.fontStyles = this.dangerFontStyles.clone();
			callout.disabledFontStyles = this.disabledFontStyles.clone();
		}

	//-------------------------
	// TextInput
	//-------------------------

		protected function setBaseTextInputStyles(input:TextInput):void
		{
			var skin:ImageSkin = new ImageSkin(this.insetBackgroundSkinTexture);
			skin.setTextureForState(TextInputState.DISABLED, this.insetBackgroundDisabledSkinTexture);
			skin.setTextureForState(TextInputState.FOCUSED, this.insetBackgroundFocusedSkinTexture);
			skin.setTextureForState(TextInputState.ERROR, this.insetBackgroundDangerSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.wideControlSize;
			skin.minHeight = this.controlSize;
			input.backgroundSkin = skin;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			input.focusIndicatorSkin = focusIndicatorSkin;
			input.focusPadding = this.focusPaddingSize;

			input.fontStyles = this.primaryFontStyles.clone();
			input.disabledFontStyles = this.disabledFontStyles.clone();

			input.promptFontStyles = this.primaryFontStyles.clone();
			input.promptDisabledFontStyles = this.disabledFontStyles.clone();

			input.gap = this.smallGutterSize;
			input.paddingTop = this.smallGutterSize;
			input.paddingBottom = this.smallGutterSize;
			input.paddingLeft = this.gutterSize;
			input.paddingRight = this.gutterSize;
		}

		protected function setTextInputStyles(input:TextInput):void
		{
			this.setBaseTextInputStyles(input);
		}

		protected function setSearchTextInputStyles(input:TextInput):void
		{
			this.setBaseTextInputStyles(input);

			var icon:ImageSkin = new ImageSkin(this.searchIconTexture);
			icon.disabledTexture = this.searchIconDisabledTexture;
			input.defaultIcon = icon;
		}

		protected function setTextInputTextEditorStyles(textEditor:BitmapFontTextEditor):void
		{
			textEditor.cursorSkin = new Quad(1, 1, PRIMARY_TEXT_COLOR);
			textEditor.selectionSkin = new Quad(1, 1, BACKGROUND_COLOR);
		}

		protected function setTextInputErrorCalloutStyles(callout:TextCallout):void
		{
			this.setDangerTextCalloutStyles(callout);
			callout.horizontalAlign = HorizontalAlign.LEFT;
			callout.verticalAlign = VerticalAlign.TOP;
		}

	//-------------------------
	// Toast
	//-------------------------

		protected function setToastStyles(toast:Toast):void
		{
			var backgroundSkin:Quad = new Quad(1, 1, MODAL_OVERLAY_COLOR);
			toast.backgroundSkin = backgroundSkin;

			toast.fontStyles = this.primaryFontStyles.clone();
			toast.disabledFontStyles = this.disabledFontStyles.clone();

			toast.width = this.extraWideControlSize;
			toast.paddingTop = this.smallGutterSize;
			toast.paddingRight = this.gutterSize;
			toast.paddingBottom = this.smallGutterSize;
			toast.paddingLeft = this.gutterSize;
			toast.gap = Number.POSITIVE_INFINITY;
			toast.minGap = this.smallGutterSize;
			toast.horizontalAlign = HorizontalAlign.LEFT;
			toast.verticalAlign = VerticalAlign.MIDDLE;
		}

		protected function setToastActionsStyles(group:ButtonGroup):void
		{
			group.direction = Direction.HORIZONTAL;
			group.gap = this.smallGutterSize;
			group.customButtonStyleName = THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON;
		}

		protected function setToastActionsButtonStyles(button:Button):void
		{
			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.primaryFontStyles.clone();
		}

	//-------------------------
	// ToggleSwitch
	//-------------------------

		protected function setToggleSwitchStyles(toggleSwitch:ToggleSwitch):void
		{
			toggleSwitch.trackLayoutMode = TrackLayoutMode.SINGLE;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			toggleSwitch.focusIndicatorSkin = focusIndicatorSkin;
			toggleSwitch.focusPadding = this.focusPaddingSize;

			toggleSwitch.offLabelFontStyles = this.primaryFontStyles.clone();
			toggleSwitch.offLabelDisabledFontStyles = this.disabledFontStyles.clone();

			toggleSwitch.onLabelFontStyles = this.primaryFontStyles.clone();
			toggleSwitch.onLabelDisabledFontStyles = this.disabledFontStyles.clone();
		}

		protected function setToggleSwitchOnTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.insetBackgroundSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.insetBackgroundDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = Math.round(this.controlSize * 2.5);
			skin.height = this.controlSize;
			track.defaultSkin = skin;

			track.hasLabelTextRenderer = false;
		}

		protected function setToggleSwitchThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.thumbSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.thumbDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			thumb.defaultSkin = skin;

			thumb.hasLabelTextRenderer = false;
		}

	//-------------------------
	// Tree
	//-------------------------

		protected function setTreeStyles(tree:Tree):void
		{
			this.setScrollerStyles(tree);

			tree.verticalScrollPolicy = ScrollPolicy.AUTO;

			var backgroundSkin:Image = new Image(this.listBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			tree.backgroundSkin = backgroundSkin;

			var backgroundDisabledSkin:Image = new Image(this.buttonDisabledSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundDisabledSkin.width = this.controlSize;
			backgroundDisabledSkin.height = this.controlSize;
			tree.backgroundDisabledSkin = backgroundDisabledSkin;

			tree.padding = this.borderSize;
			tree.paddingRight = 0;
		}

		protected function setTreeItemRendererStyles(itemRenderer:DefaultTreeItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			itemRenderer.indentation = this.treeDisclosureOpenIconTexture.width;
			itemRenderer.disclosureGap = this.gutterSize;

			var disclosureOpenIcon:ImageSkin = new ImageSkin(this.treeDisclosureOpenIconTexture);
			disclosureOpenIcon.textureSmoothing = TextureSmoothing.NONE;
			disclosureOpenIcon.pixelSnapping = true;
			itemRenderer.disclosureOpenIcon = disclosureOpenIcon;

			var disclosureClosedIcon:ImageSkin = new ImageSkin(this.treeDisclosureClosedIconTexture);
			disclosureClosedIcon.textureSmoothing = TextureSmoothing.NONE;
			disclosureClosedIcon.pixelSnapping = true;
			itemRenderer.disclosureClosedIcon = disclosureClosedIcon;
		}

	//-------------------------
	// VideoPlayer
	//-------------------------

		protected function setVideoPlayerStyles(player:VideoPlayer):void
		{
			player.backgroundSkin = new Quad(1, 1, 0x000000);
		}

	//-------------------------
	// PlayPauseToggleButton
	//-------------------------

		protected function setPlayPauseToggleButtonStyles(button:PlayPauseToggleButton):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			button.defaultSkin = defaultSkin;

			var otherSkin:ImageSkin = new ImageSkin(null);
			otherSkin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			otherSkin.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.buttonDownSkinTexture);
			otherSkin.width = this.controlSize;
			otherSkin.height = this.controlSize;
			otherSkin.minWidth = this.controlSize;
			otherSkin.minHeight = this.controlSize;
			button.setSkinForState(ButtonState.DOWN, otherSkin);
			button.setSkinForState(ButtonState.DOWN_AND_SELECTED, otherSkin);

			var icon:ImageSkin = new ImageSkin(this.playPauseButtonPlayUpIconTexture);
			icon.selectedTexture = this.playPauseButtonPauseUpIconTexture;
			icon.textureSmoothing = TextureSmoothing.NONE;
			button.defaultIcon = icon;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;

			button.hasLabelTextRenderer = false;

			button.padding = this.smallGutterSize;
			button.gap = this.smallGutterSize;
			button.minGap = this.smallGutterSize;
		}

		protected function setOverlayPlayPauseToggleButtonStyles(button:PlayPauseToggleButton):void
		{
			var icon:ImageSkin = new ImageSkin(null);
			icon.setTextureForState(ButtonState.UP, this.overlayPlayPauseButtonPlayUpIconTexture);
			icon.setTextureForState(ButtonState.HOVER, this.overlayPlayPauseButtonPlayUpIconTexture);
			icon.setTextureForState(ButtonState.DOWN, this.overlayPlayPauseButtonPlayDownIconTexture);
			button.defaultIcon = icon;

			button.hasLabelTextRenderer = false;

			var skin:Quad = new Quad(this.overlayPlayPauseButtonPlayUpIconTexture.width,
				this.overlayPlayPauseButtonPlayUpIconTexture.height);
			skin.alpha = 0;
			button.defaultSkin = skin;

			var overlaySkin:Quad = new Quad(1, 1, VIDEO_OVERLAY_COLOR);
			overlaySkin.alpha = VIDEO_OVERLAY_ALPHA;
			button.upSkin = overlaySkin;
			button.hoverSkin = overlaySkin;
		}

	//-------------------------
	// FullScreenToggleButton
	//-------------------------

		protected function setFullScreenToggleButtonStyles(button:FullScreenToggleButton):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			button.defaultSkin = defaultSkin;

			var otherSkin:ImageSkin = new ImageSkin(null);
			otherSkin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			otherSkin.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.buttonDownSkinTexture);
			otherSkin.width = this.controlSize;
			otherSkin.height = this.controlSize;
			otherSkin.minWidth = this.controlSize;
			otherSkin.minHeight = this.controlSize;
			button.setSkinForState(ButtonState.DOWN, otherSkin);
			button.setSkinForState(ButtonState.DOWN_AND_SELECTED, otherSkin);

			var icon:ImageSkin = new ImageSkin(this.fullScreenToggleButtonEnterUpIconTexture);
			icon.selectedTexture = this.fullScreenToggleButtonExitUpIconTexture;
			button.defaultIcon = icon;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;

			button.hasLabelTextRenderer = false;

			button.padding = this.smallGutterSize;
			button.gap = this.smallGutterSize;
			button.minGap = this.smallGutterSize;
		}

	//-------------------------
	// MuteToggleButton
	//-------------------------

		protected function setMuteToggleButtonStyles(button:MuteToggleButton):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			button.defaultSkin = defaultSkin;

			var otherSkin:ImageSkin = new ImageSkin(null);
			otherSkin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			otherSkin.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.buttonDownSkinTexture);
			otherSkin.width = this.controlSize;
			otherSkin.height = this.controlSize;
			otherSkin.minWidth = this.controlSize;
			otherSkin.minHeight = this.controlSize;
			button.setSkinForState(ButtonState.DOWN, otherSkin);
			button.setSkinForState(ButtonState.DOWN_AND_SELECTED, otherSkin);

			var icon:ImageSkin = new ImageSkin(this.muteToggleButtonLoudUpIconTexture);
			icon.selectedTexture = this.muteToggleButtonMutedUpIconTexture;
			icon.textureSmoothing = TextureSmoothing.NONE;
			button.defaultIcon = icon;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;

			button.hasLabelTextRenderer = false;
			button.showVolumeSliderOnHover = true;

			button.padding = this.smallGutterSize;
			button.gap = this.smallGutterSize;
			button.minGap = this.smallGutterSize;
		}

		protected function setPopUpVolumeSliderStyles(slider:VolumeSlider):void
		{
			slider.direction = Direction.VERTICAL;
			slider.trackLayoutMode = TrackLayoutMode.SINGLE;
			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			slider.focusIndicatorSkin = focusIndicatorSkin;
			slider.focusPadding = this.focusPaddingSize;
			slider.maximumPadding = this.popUpVolumeSliderPaddingTopLeft;
			slider.minimumPadding = this.popUpVolumeSliderPaddingBottomRight;
			slider.thumbOffset = -Math.round(this.dropShadowSize / 2);
			slider.customThumbStyleName = THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_THUMB;
			slider.customMinimumTrackStyleName = THEME_STYLE_NAME_POP_UP_VOLUME_SLIDER_MINIMUM_TRACK;
			slider.width = this.smallControlSize + this.popUpVolumeSliderPaddingTopLeft + this.popUpVolumeSliderPaddingBottomRight;
			slider.height = this.wideControlSize + this.popUpVolumeSliderPaddingTopLeft + this.popUpVolumeSliderPaddingBottomRight;
		}

		protected function setPopUpVolumeSliderTrackStyles(track:Button):void
		{
			var skin:Image = new Image(this.popUpVolumeSliderTrackSkinTexture);
			skin.scale9Grid = VOLUME_SLIDER_TRACK_SCALE9_GRID;
			track.defaultSkin = skin;

			track.hasLabelTextRenderer = false;
		}

	//-------------------------
	// SeekSlider
	//-------------------------

		protected function setSeekSliderStyles(slider:SeekSlider):void
		{
			this.setSliderStyles(slider);

			var progressSkin:Image = new Image(this.seekSliderProgressSkinTexture);
			progressSkin.scale9Grid = SEEK_SLIDER_PROGRESS_SKIN_SCALE9_GRID;
			slider.progressSkin = progressSkin;
		}

	//-------------------------
	// VolumeSlider
	//-------------------------

		protected function setVolumeSliderStyles(slider:VolumeSlider):void
		{
			slider.direction = Direction.HORIZONTAL;
			slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			slider.focusIndicatorSkin = focusIndicatorSkin;
			slider.focusPadding = this.focusPaddingSize;
			slider.showThumb = false;
		}

		protected function setVolumeSliderThumbStyles(thumb:Button):void
		{
			var thumbSize:Number = 6;
			var defaultSkin:Quad = new Quad(thumbSize, thumbSize);
			defaultSkin.width = 0;
			defaultSkin.height = 0;
			thumb.defaultSkin = defaultSkin;
			thumb.hasLabelTextRenderer = false;
		}

		protected function setVolumeSliderMinimumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageLoader = new ImageLoader();
			defaultSkin.scaleContent = false;
			defaultSkin.source = this.volumeSliderMinimumTrackSkinTexture;
			track.defaultSkin = defaultSkin;

			track.hasLabelTextRenderer = false;
		}

		protected function setVolumeSliderMaximumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageLoader = new ImageLoader();
			defaultSkin.scaleContent = false;
			defaultSkin.horizontalAlign = HorizontalAlign.RIGHT;
			defaultSkin.source = this.volumeSliderMaximumTrackSkinTexture;
			track.defaultSkin = defaultSkin;

			track.hasLabelTextRenderer = false;
		}
	}
}


================================================
FILE: themes/MinimalDesktopTheme/source/feathers/themes/MinimalDesktopTheme.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import flash.display.Bitmap;
	import flash.display.BitmapData;

	import starling.text.BitmapFont;
	import starling.text.TextField;
	import starling.textures.Texture;
	import starling.textures.TextureAtlas;

	/**
	 * The "Minimal" theme for desktop Feathers apps.
	 *
	 * <p>This version of the theme embeds its assets. To load assets at
	 * runtime, see <code>MinimalDesktopThemeWithAssetManager</code> instead.</p>
	 *
	 * @see http://feathersui.com/help/theme-assets.html
	 */
	public class MinimalDesktopTheme extends BaseMinimalDesktopTheme
	{
		/**
		 * @private
		 */
		[Embed(source="/../assets/images/minimal_desktop.xml",mimeType="application/octet-stream")]
		protected static const ATLAS_XML:Class;

		/**
		 * @private
		 */
		[Embed(source="/../assets/images/minimal_desktop.png")]
		protected static const ATLAS_BITMAP:Class;

		/**
		 * @private
		 */
		[Embed(source="/../assets/fonts/pf_ronda_seven_desktop.fnt",mimeType="application/octet-stream")]
		protected static const FONT_XML:Class;

		/**
		 * Constructor.
		 */
		public function MinimalDesktopTheme()
		{
			super();
			this.initialize();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this.initializeTextureAtlas();
			this.initializeBitmapFont();
			super.initialize();
		}

		/**
		 * @private
		 */
		protected function initializeTextureAtlas():void
		{
			var atlasBitmapData:BitmapData = Bitmap(new ATLAS_BITMAP()).bitmapData;
			var atlasTexture:Texture = Texture.fromBitmapData(atlasBitmapData, false, false, ATLAS_SCALE_FACTOR);
			atlasTexture.root.onRestore = this.atlasTexture_onRestore;
			atlasBitmapData.dispose();
			this.atlas = new TextureAtlas(atlasTexture, XML(new ATLAS_XML()));
		}

		/**
		 * @private
		 */
		protected function initializeBitmapFont():void
		{
			var bitmapFont:BitmapFont = new BitmapFont(this.atlas.getTexture(FONT_TEXTURE_NAME), XML(new FONT_XML()));
			TextField.registerCompositor(bitmapFont, FONT_NAME);
		}

		/**
		 * @private
		 */
		protected function atlasTexture_onRestore():void
		{
			var atlasBitmapData:BitmapData = Bitmap(new ATLAS_BITMAP()).bitmapData;
			this.atlas.texture.root.uploadBitmapData(atlasBitmapData);
			atlasBitmapData.dispose();
		}
	}
}

================================================
FILE: themes/MinimalDesktopTheme/source/feathers/themes/MinimalDesktopThemeWithAssetManager.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import feathers.events.FeathersEventType;

	import starling.assets.AssetManager;
	import starling.core.Starling;
	import starling.events.Event;
	import starling.text.BitmapFont;
	import starling.text.TextField;

	/**
	 * @copy feathers.themes.IAsyncTheme#event:complete
	 *
	 * @eventType starling.events.Event.COMPLETE
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * Dispatched when the theme's assets fail to load due to an error.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The error string.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.ERROR
	 */
	[Event(name="error",type="starling.events.Event")]

	/**
	 * The "Minimal" theme for desktop Feathers apps.
	 *
	 * <p>This version of the theme requires loading assets at runtime. To use
	 * embedded assets, see <code>MinimalDesktopTheme</code> instead.</p>
	 *
	 * <p>To use this theme, the following files must be included when packaging
	 * your app:</p>
	 * <ul>
	 *     <li>images/minimal_desktop.png</li>
	 *     <li>images/minimal_desktop.xml</li>
	 *     <li>fonts/pf_ronda_seven.fnt</li>
	 * </ul>
	 *
	 * @see http://feathersui.com/help/theme-assets.html
	 */
	public class MinimalDesktopThemeWithAssetManager extends BaseMinimalDesktopTheme implements IAsyncTheme
	{
		/**
		 * @private
		 * The name of the texture atlas in the asset manager.
		 */
		protected static const ATLAS_NAME:String = "minimal_desktop";

		/**
		 * Constructor.
		 * @param assetsBasePath The root folder of the assets.
		 * @param assetManager An optional pre-created AssetManager. The scaleFactor property must be equal to Starling.contentScaleFactor. To load assets with a different scale factor, use multiple AssetManager instances.
		 */
		public function MinimalDesktopThemeWithAssetManager(assetsBasePath:String = "./", assetManager:AssetManager = null)
		{
			this.loadAssets(assetsBasePath, assetManager);
		}

		/**
		 * @private
		 * The paths to each of the assets, relative to the base path.
		 */
		protected var assetPaths:Vector.<String> = new <String>
		[
			"images/" + ATLAS_NAME + ".xml",
			"images/" + ATLAS_NAME + ".png",
			"fonts/pf_ronda_seven_desktop.fnt"
		];

		/**
		 * @private
		 */
		protected var assetManager:AssetManager;

		/**
		 * @private
		 */
		protected var isComplete:Boolean = false;

		/**
		 * @private
		 */
		override public function dispose():void
		{
			super.dispose();
			if(this.assetManager)
			{
				this.assetManager.removeTextureAtlas(ATLAS_NAME);
				this.assetManager = null;
			}
		}

		/**
		 * @copy feathers.themes.IAsyncTheme#isCompleteForStarling()
		 */
		public function isCompleteForStarling(starling:Starling):Boolean
		{
			return this.isComplete;
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this.initializeTextureAtlas();
			this.initializeBitmapFont();
			super.initialize();
		}

		/**
		 * @private
		 */
		protected function initializeTextureAtlas():void
		{
			this.atlas = this.assetManager.getTextureAtlas(ATLAS_NAME);
		}

		/**
		 * @private
		 */
		protected function initializeBitmapFont():void
		{
			var font:BitmapFont = TextField.getBitmapFont(FONT_TEXTURE_NAME);
			TextField.registerCompositor(font, FONT_NAME);
		}

		/**
		 * @private
		 */
		protected function loadAssets(assetsBasePath:String, assetManager:AssetManager):void
		{
			var oldScaleFactor:Number = -1;
			if(assetManager)
			{
				oldScaleFactor = assetManager.textureOptions.scale;
				assetManager.textureOptions.scale = ATLAS_SCALE_FACTOR;
			}
			else
			{
				assetManager = new AssetManager(ATLAS_SCALE_FACTOR);
			}
			this.assetManager = assetManager;
			//add a trailing slash, if needed
			if(assetsBasePath.lastIndexOf("/") != assetsBasePath.length - 1)
			{
				assetsBasePath += "/";
			}
			var assetPaths:Vector.<String> = this.assetPaths;
			var assetCount:int = assetPaths.length;
			for(var i:int = 0; i < assetCount; i++)
			{
				var asset:String = assetPaths[i];
				this.assetManager.enqueue(assetsBasePath + asset);
			}
			if(oldScaleFactor != -1)
			{
				//restore the old scale factor, just in case
				this.assetManager.textureOptions.scale = oldScaleFactor;
			}
			this.assetManager.loadQueue(assetManager_onComplete, assetManager_onError);
		}

		/**
		 * @private
		 */
		protected function assetManager_onComplete():void
		{
			this.initialize();
			this.isComplete = true;
			this.dispatchEventWith(Event.COMPLETE, false, Starling.current);
		}

		/**
		 * @private
		 */
		protected function assetManager_onError(error:String):void
		{
			this.dispatchEventWith(FeathersEventType.ERROR, false, error);
		}
	}
}


================================================
FILE: themes/MinimalMobileTheme/README.md
================================================
# Minimal Mobile Theme for Feathers

This [Feathers](http://feathersui.com/) theme for mobile devices combines simple gray colors with a retro pixel aesthetic.

## Original Artwork

This theme's texture atlas was exported from Adobe Animate CC. To modify colors and other properties, or to add new skins to the texture atlas, [download the source FLA file](http://feathersui.com/help/theme-sources.html) from the Feathers website.

## Credits

This theme is based on the appearance of [MinimalComps](https://github.com/minimalcomps/minimalcomps/), a great set of Flash user interface components created by [Keith Peters](https://bit-101.com/). With permission, the theme was ported to Feathers by [Josh Tynjala](https://joshblog.net/). This theme uses the free Ronda Seven font, designed by [Yusuke Kamiyamane](http://p.yusukekamiyamane.com/).

================================================
FILE: themes/MinimalMobileTheme/assets/fonts/pf_ronda_seven.fnt
================================================
<?xml version="1.0"?>
<font>
  <info face="PF Ronda Seven" size="-8" bold="0" italic="0" charset="" unicode="1" stretchH="100" smooth="0" aa="1" padding="0,0,0,0" spacing="1,1" outline="0"/>
  <common lineHeight="13" base="11" scaleW="256" scaleH="256" pages="1" packed="0" alphaChnl="0" redChnl="4" greenChnl="4" blueChnl="4"/>
  <pages>
    <page id="0" file="pf_ronda_seven_0.png" />
  </pages>
  <chars count="95">
    <char id="32" x="216" y="8" width="1" height="1" xoffset="0" yoffset="12" xadvance="3" page="0" chnl="15" />
    <char id="33" x="85" y="8" width="1" height="7" xoffset="1" yoffset="4" xadvance="3" page="0" chnl="15" />
    <char id="34" x="195" y="8" width="3" height="2" xoffset="0" yoffset="4" xadvance="4" page="0" chnl="15" />
    <char id="35" x="0" y="10" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="36" x="15" y="0" width="5" height="9" xoffset="0" yoffset="3" xadvance="6" page="0" chnl="15" />
    <char id="37" x="69" y="0" width="7" height="7" xoffset="0" yoffset="4" xadvance="8" page="0" chnl="15" />
    <char id="38" x="6" y="10" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="39" x="206" y="8" width="1" height="2" xoffset="0" yoffset="4" xadvance="2" page="0" chnl="15" />
    <char id="40" x="27" y="0" width="3" height="9" xoffset="0" yoffset="3" xadvance="4" page="0" chnl="15" />
    <char id="41" x="35" y="0" width="3" height="9" xoffset="0" yoffset="3" xadvance="4" page="0" chnl="15" />
    <char id="42" x="109" y="8" width="5" height="5" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="43" x="115" y="8" width="5" height="5" xoffset="0" yoffset="5" xadvance="6" page="0" chnl="15" />
    <char id="44" x="187" y="8" width="2" height="3" xoffset="0" yoffset="10" xadvance="3" page="0" chnl="15" />
    <char id="45" x="208" y="8" width="3" height="1" xoffset="0" yoffset="8" xadvance="4" page="0" chnl="15" />
    <char id="46" x="218" y="8" width="1" height="1" xoffset="1" yoffset="10" xadvance="3" page="0" chnl="15" />
    <char id="47" x="21" y="0" width="5" height="9" xoffset="0" yoffset="3" xadvance="5" page="0" chnl="15" />
    <char id="48" x="109" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="49" x="82" y="8" width="2" height="7" xoffset="0" yoffset="4" xadvance="3" page="0" chnl="15" />
    <char id="50" x="115" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="51" x="121" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="52" x="127" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="53" x="133" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="54" x="18" y="10" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="55" x="145" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="56" x="151" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="57" x="157" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="58" x="181" y="8" width="1" height="5" xoffset="1" yoffset="6" xadvance="3" page="0" chnl="15" />
    <char id="59" x="253" y="0" width="2" height="7" xoffset="0" yoffset="6" xadvance="3" page="0" chnl="15" />
    <char id="60" x="165" y="8" width="3" height="5" xoffset="0" yoffset="5" xadvance="4" page="0" chnl="15" />
    <char id="61" x="183" y="8" width="3" height="3" xoffset="0" yoffset="6" xadvance="4" page="0" chnl="15" />
    <char id="62" x="161" y="8" width="3" height="5" xoffset="0" yoffset="5" xadvance="4" page="0" chnl="15" />
    <char id="63" x="181" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="64" x="0" y="0" width="8" height="9" xoffset="0" yoffset="3" xadvance="9" page="0" chnl="15" />
    <char id="65" x="187" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="66" x="193" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="67" x="199" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="68" x="205" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="69" x="211" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="70" x="217" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="71" x="223" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="72" x="229" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="73" x="87" y="8" width="1" height="7" xoffset="0" yoffset="4" xadvance="2" page="0" chnl="15" />
    <char id="74" x="69" y="8" width="4" height="7" xoffset="0" yoffset="4" xadvance="5" page="0" chnl="15" />
    <char id="75" x="235" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="76" x="29" y="10" width="4" height="7" xoffset="0" yoffset="4" xadvance="5" page="0" chnl="15" />
    <char id="77" x="77" y="0" width="7" height="7" xoffset="0" yoffset="4" xadvance="8" page="0" chnl="15" />
    <char id="78" x="85" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="79" x="91" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="80" x="175" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="81" x="53" y="0" width="5" height="8" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="82" x="169" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="83" x="163" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="84" x="139" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="85" x="103" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="86" x="97" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="87" x="61" y="0" width="7" height="7" xoffset="0" yoffset="4" xadvance="8" page="0" chnl="15" />
    <char id="88" x="12" y="10" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="89" x="247" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="90" x="241" y="0" width="5" height="7" xoffset="0" yoffset="4" xadvance="6" page="0" chnl="15" />
    <char id="91" x="31" y="0" width="3" height="9" xoffset="0" yoffset="3" xadvance="4" page="0" chnl="15" />
    <char id="92" x="9" y="0" width="5" height="9" xoffset="0" yoffset="3" xadvance="6" page="0" chnl="15" />
    <char id="93" x="39" y="0" width="3" height="9" xoffset="0" yoffset="3" xadvance="4" page="0" chnl="15" />
    <char id="94" x="199" y="8" width="3" height="2" xoffset="0" yoffset="4" xadvance="4" page="0" chnl="15" />
    <char id="95" x="212" y="8" width="3" height="1" xoffset="0" yoffset="10" xadvance="4" page="0" chnl="15" />
    <char id="96" x="203" y="8" width="2" height="2" xoffset="0" yoffset="1" xadvance="3" page="0" chnl="15" />
    <char id="97" x="141" y="8" width="4" height="5" xoffset="0" yoffset="6" xadvance="5" page="0" chnl="15" />
    <char id="98" x="24" y="10" width="4" height="7" xoffset="0" yoffset="4" xadvance="5" page="0" chnl="15" />
    <char id="99" x="151" y="8" width="4" height="5" xoffset="0" yoffset="6" xadvance="5" page="0" chnl="15" />
    <char id="100" x="49" y="10" width="4" height="7" xoffset="0" yoffset="4" xadvance="5" page="0" chnl="15" />
    <char id="101" x="156" y="8" width="4" height="5" xoffset="0" yoffset="6" xadvance="5" page="0" chnl="15" />
    <char id="102" x="74" y="8" width="3" height="7" xoffset="0" yoffset="4" xadvance="3" page="0" chnl="15" />
    <char id="103" x="34" y="10" width="4" height="7" xoffset="0" yoffset="6" xadvance="5" page="0" chnl="15" />
    <char id="104" x="39" y="10" width="4" height="7" xoffset="0" yoffset="4" xadvance="5" page="0" chnl="15" />
    <char id="105" x="89" y="8" width="1" height="7" xoffset="0" yoffset="4" xadvance="2" page="0" chnl="15" />
    <char id="106" x="59" y="0" width="1" height="8" xoffset="0" yoffset="4" xadvance="2" page="0" chnl="15" />
    <char id="107" x="44" y="10" width="4" height="7" xoffset="0" yoffset="4" xadvance="5" page="0" chnl="15" />
    <char id="108" x="91" y="8" width="1" height="7" xoffset="0" yoffset="4" xadvance="2" page="0" chnl="15" />
    <char id="109" x="101" y="8" width="7" height="5" xoffset="0" yoffset="6" xadvance="8" page="0" chnl="15" />
    <char id="110" x="121" y="8" width="4" height="5" xoffset="0" yoffset="6" xadvance="5" page="0" chnl="15" />
    <char id="111" x="126" y="8" width="4" height="5" xoffset="0" yoffset="6" xadvance="5" page="0" chnl="15" />
    <char id="112" x="54" y="9" width="4" height="7" xoffset="0" yoffset="6" xadvance="5" page="0" chnl="15" />
    <char id="113" x="59" y="9" width="4" height="7" xoffset="0" yoffset="6" xadvance="5" page="0" chnl="15" />
    <char id="114" x="169" y="8" width="3" height="5" xoffset="0" yoffset="6" xadvance="4" page="0" chnl="15" />
    <char id="115" x="173" y="8" width="3" height="5" xoffset="0" yoffset="6" xadvance="4" page="0" chnl="15" />
    <char id="116" x="78" y="8" width="3" height="7" xoffset="0" yoffset="4" xadvance="4" page="0" chnl="15" />
    <char id="117" x="131" y="8" width="4" height="5" xoffset="0" yoffset="6" xadvance="5" page="0" chnl="15" />
    <char id="118" x="136" y="8" width="4" height="5" xoffset="0" yoffset="6" xadvance="5" page="0" chnl="15" />
    <char id="119" x="93" y="8" width="7" height="5" xoffset="0" yoffset="6" xadvance="8" page="0" chnl="15" />
    <char id="120" x="146" y="8" width="4" height="5" xoffset="0" yoffset="6" xadvance="5" page="0" chnl="15" />
    <char id="121" x="64" y="8" width="4" height="7" xoffset="0" yoffset="6" xadvance="5" page="0" chnl="15" />
    <char id="122" x="177" y="8" width="3" height="5" xoffset="0" yoffset="6" xadvance="4" page="0" chnl="15" />
    <char id="123" x="47" y="0" width="3" height="9" xoffset="0" yoffset="3" xadvance="4" page="0" chnl="15" />
    <char id="124" x="51" y="0" width="1" height="9" xoffset="0" yoffset="3" xadvance="2" page="0" chnl="15" />
    <char id="125" x="43" y="0" width="3" height="9" xoffset="0" yoffset="3" xadvance="4" page="0" chnl="15" />
    <char id="126" x="190" y="8" width="4" height="2" xoffset="0" yoffset="4" xadvance="5" page="0" chnl="15" />
  </chars>
  <kernings count="66">
    <kerning first="70" second="100" amount="-1" />
    <kerning first="70" second="97" amount="-1" />
    <kerning first="70" second="111" amount="-1" />
    <kerning first="70" second="112" amount="-1" />
    <kerning first="70" second="113" amount="-1" />
    <kerning first="70" second="114" amount="-1" />
    <kerning first="70" second="115" amount="-1" />
    <kerning first="70" second="116" amount="-1" />
    <kerning first="70" second="117" amount="-1" />
    <kerning first="70" second="109" amount="-1" />
    <kerning first="70" second="110" amount="-1" />
    <kerning first="70" second="101" amount="-1" />
    <kerning first="70" second="121" amount="-1" />
    <kerning first="70" second="118" amount="-1" />
    <kerning first="70" second="99" amount="-1" />
    <kerning first="70" second="103" amount="-1" />
    <kerning first="70" second="119" amount="-1" />
    <kerning first="70" second="120" amount="-1" />
    <kerning first="70" second="122" amount="-1" />
    <kerning first="70" second="74" amount="-1" />
    <kerning first="76" second="84" amount="-1" />
    <kerning first="76" second="86" amount="-1" />
    <kerning first="76" second="89" amount="-1" />
    <kerning first="80" second="74" amount="-1" />
    <kerning first="84" second="100" amount="-1" />
    <kerning first="84" second="97" amount="-1" />
    <kerning first="84" second="111" amount="-1" />
    <kerning first="84" second="112" amount="-1" />
    <kerning first="84" second="113" amount="-1" />
    <kerning first="84" second="114" amount="-1" />
    <kerning first="84" second="115" amount="-1" />
    <kerning first="84" second="116" amount="-1" />
    <kerning first="84" second="117" amount="-1" />
    <kerning first="84" second="109" amount="-1" />
    <kerning first="84" second="110" amount="-1" />
    <kerning first="84" second="101" amount="-1" />
    <kerning first="84" second="121" amount="-1" />
    <kerning first="84" second="118" amount="-1" />
    <kerning first="84" second="99" amount="-1" />
    <kerning first="84" second="103" amount="-1" />
    <kerning first="84" second="119" amount="-1" />
    <kerning first="84" second="120" amount="-1" />
    <kerning first="84" second="122" amount="-1" />
    <kerning first="84" second="74" amount="-1" />
    <kerning first="86" second="74" amount="-1" />
    <kerning first="47" second="47" amount="-2" />
    <kerning first="89" second="100" amount="-1" />
    <kerning first="89" second="97" amount="-1" />
    <kerning first="89" second="111" amount="-1" />
    <kerning first="89" second="112" amount="-1" />
    <kerning first="89" second="113" amount="-1" />
    <kerning first="89" second="114" amount="-1" />
    <kerning first="89" second="115" amount="-1" />
    <kerning first="89" second="116" amount="-1" />
    <kerning first="89" second="117" amount="-1" />
    <kerning first="89" second="109" amount="-1" />
    <kerning first="89" second="110" amount="-1" />
    <kerning first="89" second="101" amount="-1" />
    <kerning first="89" second="121" amount="-1" />
    <kerning first="89" second="118" amount="-1" />
    <kerning first="89" second="99" amount="-1" />
    <kerning first="89" second="103" amount="-1" />
    <kerning first="89" second="119" amount="-1" />
    <kerning first="89" second="120" amount="-1" />
    <kerning first="89" second="122" amount="-1" />
    <kerning first="89" second="74" amount="-1" />
  </kernings>
</font>


================================================
FILE: themes/MinimalMobileTheme/assets/images/minimal_mobile.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<TextureAtlas imagePath="minimal_mobile.png">
	<!-- Created with Adobe Animate version 19.0.0.326 -->
	<!-- http://www.adobe.com/products/animate.html -->
	<SubTexture name="back-button-disabled-skin0000" x="285" y="34" width="40" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="back-button-down-skin0000" x="367" y="34" width="40" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="back-button-up-skin0000" x="326" y="34" width="40" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="button-disabled-skin0000" x="146" y="184" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="button-down-skin0000" x="163" y="184" width="16" height="16" pivotX="0" pivotY="-0.05"/>
	<SubTexture name="button-up-skin0000" x="409" y="185" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="call-to-action-button-up-skin0000" x="129" y="184" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-bottom-arrow-skin0000" x="203" y="91" width="54" height="36" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-left-arrow-skin0000" x="482" y="104" width="28" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-right-arrow-skin0000" x="408" y="80" width="36" height="54" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-top-arrow-skin0000" x="260" y="128" width="44" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="check-disabled-icon0000" x="149" y="122" width="36" height="36" pivotX="0" pivotY="-0.05"/>
	<SubTexture name="check-item-renderer-selected-icon0000" x="309" y="146" width="36" height="29" pivotX="0" pivotY="0"/>
	<SubTexture name="check-selected-disabled-icon0000" x="112" y="122" width="36" height="36" pivotX="0" pivotY="-0.05"/>
	<SubTexture name="check-selected-up-icon0000" x="223" y="128" width="36" height="36" pivotX="0" pivotY="-0.05"/>
	<SubTexture name="check-up-icon0000" x="186" y="128" width="36" height="36" pivotX="0" pivotY="-0.05"/>
	<SubTexture name="danger-button-down-skin0000" x="443" y="185" width="16" height="16" pivotX="0" pivotY="-0.05"/>
	<SubTexture name="danger-button-up-skin0000" x="426" y="185" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-bottom-arrow-skin0000" x="258" y="91" width="54" height="36" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-left-arrow-skin0000" x="395" y="135" width="28" height="44" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-right-arrow-skin0000" x="313" y="91" width="36" height="54" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-callout-top-arrow-skin0000" x="350" y="136" width="44" height="28" pivotX="0" pivotY="0"/>
	<SubTexture name="danger-pop-up-background-skin0000" x="31" y="159" width="29" height="29" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-cell-renderer-down-skin0000" x="445" y="80" width="6" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-cell-renderer-selected-up-skin0000" x="395" y="91" width="6" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-column-drop-indicator-skin0000" x="507" y="92" width="4" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-column-resize-skin0000" x="402" y="91" width="4" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-divider-skin0000" x="508" y="16" width="2" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-renderer-skin0000" x="453" y="49" width="6" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-sort-ascending-icon0000" x="230" y="188" width="18" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-sort-descending-icon0000" x="343" y="188" width="18" height="10" pivotX="0" pivotY="0"/>
	<SubTexture name="drag-handle-icon0000" x="473" y="149" width="32" height="30" pivotX="0" pivotY="0"/>
	<SubTexture name="face-disabled-skin0000" x="95" y="184" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="face-up-skin0000" x="112" y="184" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="focus-indicator-skin0000" x="369" y="165" width="22" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="forward-button-disabled-skin0000" x="460" y="1" width="40" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="forward-button-down-skin0000" x="203" y="34" width="40" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="forward-button-up-skin0000" x="244" y="34" width="40" height="56" pivotX="0" pivotY="0"/>
	<SubTexture name="full-screen-toggle-button-enter-up-icon0000" x="161" y="159" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="full-screen-toggle-button-exit-up-icon0000" x="186" y="165" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="header-background-skin0000" x="501" y="41" width="6" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="inset-background-danger-skin0000" x="270" y="182" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="inset-background-disabled-skin0000" x="61" y="184" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="inset-background-enabled-skin0000" x="78" y="184" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="inset-background-focused-skin0000" x="479" y="180" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-down-skin0000" x="498" y="75" width="12" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-selected-up-skin0000" x="498" y="58" width="12" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="item-renderer-up-skin0000" x="506" y="1" width="4" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="list-accessory-drill-down-icon0000" x="211" y="165" width="18" height="27" pivotX="0" pivotY="0"/>
	<SubTexture name="mute-toggle-button-loud-up-icon0000" x="136" y="159" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="mute-toggle-button-muted-up-icon0000" x="111" y="159" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="overlay-play-pause-toggle-button-play-down-icon0000" x="1" y="1" width="100" height="120" pivotX="0" pivotY="0"/>
	<SubTexture name="overlay-play-pause-toggle-button-play-up-icon0000" x="102" y="1" width="100" height="120" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-selected-symbol0000" x="253" y="182" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-symbol0000" x="287" y="182" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="panel-background-skin0000" x="462" y="180" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="panel-header-background-skin0000" x="501" y="26" width="6" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="pf_ronda_seven_0" x="203" y="1" width="256" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-disabled-icon0000" x="309" y="176" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-icon0000" x="326" y="176" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-selected-icon0000" x="392" y="180" width="16" height="16" pivotX="0" pivotY="0"/>
	<SubTexture name="play-pause-toggle-button-pause-up-icon0000" x="86" y="159" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="play-pause-toggle-button-play-up-icon0000" x="61" y="159" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="pop-up-background-skin0000" x="1" y="159" width="29" height="29" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-disabled-icon0000" x="38" y="122" width="36" height="36" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-disabled-icon0000" x="445" y="104" width="36" height="36" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-up-icon0000" x="1" y="122" width="36" height="36" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-up-icon0000" x="75" y="122" width="36" height="36" pivotX="0" pivotY="0"/>
	<SubTexture name="search-disabled-icon0000" x="424" y="166" width="18" height="18" pivotX="0" pivotY="0"/>
	<SubTexture name="search-enabled-icon0000" x="443" y="166" width="18" height="18" pivotX="0" pivotY="0"/>
	<SubTexture name="seek-slider-progress-skin0000" x="501" y="1" width="4" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="simple-scroll-bar-thumb-skin0000" x="498" y="92" width="8" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="spinner-list-selection-overlay-skin0000" x="453" y="34" width="6" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-down-skin0000" x="350" y="91" width="44" height="44" pivotX="0" pivotY="0.05"/>
	<SubTexture name="tab-selected-disabled-skin0000" x="408" y="34" width="44" height="45" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-selected-up-skin0000" x="453" y="58" width="44" height="45" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-closed-icon0000" x="230" y="165" width="22" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-open-icon0000" x="346" y="165" width="22" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-decrement-button-icon0000" x="395" y="106" width="10" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="vertical-scroll-bar-increment-button-icon0000" x="395" y="113" width="10" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="volume-slider-maximum-track-skin0000" x="424" y="141" width="48" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="volume-slider-minimum-track-skin0000" x="260" y="157" width="48" height="24" pivotX="0" pivotY="0"/>
</TextureAtlas>


================================================
FILE: themes/MinimalMobileTheme/package-src.json
================================================
{
	"id": "feathersui_MinimalMobileTheme-source",
	"name": "Feathers UI Minimal Mobile Theme",
	"url": "https://feathersui.com/as3-starling/",
	"docUrl": "https://feathersui/api-reference/",
	"description": "Minimal mobile theme for Feathers UI (Starling version)",
	"type": "src",
	"version": "4.2.0",
	"sourceUrl": "https://github.com/feathersui/feathersui-starling/releases/download/v4.2.0/feathersui_MinimalMobileTheme-source_4.2.0.airpackage",
	"publishedAt": "2021-11-19T00:00:00.000Z",
	"dependencies": [
		"starling-source:2.x.x",
		"feathersui-source:4.2.x"
	],
	"parameters": [],
	"tags": ["theme", "feathers", "starling"],
	"status": "release",
	"license": {
	  "type": "Simplified BSD",
	  "url": "https://github.com/feathersui/feathersui-starling/blob/v4.2.0/LICENSE.md",
	  "public": true
	}
  }
  

================================================
FILE: themes/MinimalMobileTheme/package-swc.json
================================================
{
	"id": "feathersui_MinimalMobileTheme",
	"name": "Feathers UI Minimal Mobile Theme",
	"url": "https://feathersui.com/as3-starling/",
	"docUrl": "https://feathersui/api-reference/",
	"description": "Minimal mobile theme for Feathers UI (Starling version)",
	"type": "swc",
	"version": "4.2.0",
	"sourceUrl": "https://github.com/feathersui/feathersui-starling/releases/download/v4.2.0/feathersui_MinimalMobileTheme_4.2.0.airpackage",
	"publishedAt": "2021-11-19T00:00:00.000Z",
	"dependencies": [
		"starling:2.x.x",
		"feathersui:4.2.x"
	],
	"parameters": [],
	"tags": ["theme", "feathers", "starling"],
	"status": "release",
	"license": {
	  "type": "Simplified BSD",
	  "url": "https://github.com/feathersui/feathersui-starling/blob/v4.2.0/LICENSE.md",
	  "public": true
	}
  }
  

================================================
FILE: themes/MinimalMobileTheme/source/feathers/themes/BaseMinimalMobileTheme.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import feathers.controls.Alert;
	import feathers.controls.AutoComplete;
	import feathers.controls.AutoSizeMode;
	import feathers.controls.Button;
	import feathers.controls.ButtonGroup;
	import feathers.controls.ButtonState;
	import feathers.controls.Callout;
	import feathers.controls.Check;
	import feathers.controls.DataGrid;
	import feathers.controls.DateTimeSpinner;
	import feathers.controls.Drawers;
	import feathers.controls.GroupedList;
	import feathers.controls.Header;
	import feathers.controls.ImageLoader;
	import feathers.controls.ItemRendererLayoutOrder;
	import feathers.controls.Label;
	import feathers.controls.LayoutGroup;
	import feathers.controls.List;
	import feathers.controls.NumericStepper;
	import feathers.controls.PageIndicator;
	import feathers.controls.Panel;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.controls.ProgressBar;
	import feathers.controls.Radio;
	import feathers.controls.ScrollContainer;
	import feathers.controls.ScrollScreen;
	import feathers.controls.ScrollText;
	import feathers.controls.Scroller;
	import feathers.controls.SimpleScrollBar;
	import feathers.controls.Slider;
	import feathers.controls.SpinnerList;
	import feathers.controls.StepperButtonLayoutMode;
	import feathers.controls.TabBar;
	import feathers.controls.TextArea;
	import feathers.controls.TextCallout;
	import feathers.controls.TextInput;
	import feathers.controls.TextInputState;
	import feathers.controls.Toast;
	import feathers.controls.ToggleButton;
	import feathers.controls.ToggleSwitch;
	import feathers.controls.TrackLayoutMode;
	import feathers.controls.Tree;
	import feathers.controls.popups.BottomDrawerPopUpContentManager;
	import feathers.controls.popups.CalloutPopUpContentManager;
	import feathers.controls.renderers.BaseDefaultItemRenderer;
	import feathers.controls.renderers.DefaultDataGridCellRenderer;
	import feathers.controls.renderers.DefaultDataGridHeaderRenderer;
	import feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer;
	import feathers.controls.renderers.DefaultGroupedListItemRenderer;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.DefaultTreeItemRenderer;
	import feathers.controls.text.BitmapFontTextEditor;
	import feathers.controls.text.BitmapFontTextRenderer;
	import feathers.controls.text.ITextEditorViewPort;
	import feathers.controls.text.StageTextTextEditor;
	import feathers.controls.text.TextFieldTextEditorViewPort;
	import feathers.core.FeathersControl;
	import feathers.core.FocusManager;
	import feathers.core.ITextEditor;
	import feathers.core.ITextRenderer;
	import feathers.core.PopUpManager;
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.RelativePosition;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.media.FullScreenToggleButton;
	import feathers.media.MuteToggleButton;
	import feathers.media.PlayPauseToggleButton;
	import feathers.media.SeekSlider;
	import feathers.media.VideoPlayer;
	import feathers.media.VolumeSlider;
	import feathers.skins.ImageSkin;
	import feathers.system.DeviceCapabilities;

	import flash.geom.Rectangle;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Image;
	import starling.display.Quad;
	import starling.display.Stage;
	import starling.text.TextField;
	import starling.text.TextFormat;
	import starling.textures.Texture;
	import starling.textures.TextureAtlas;
	import starling.textures.TextureSmoothing;

	/**
	 * The base class for the "Minimal" theme for mobile Feathers apps. Handles
	 * everything except asset loading, which is left to subclasses.
	 *
	 * @see MinimalMobileTheme
	 * @see MinimalMobileThemeWithAssetManager
	 */
	public class BaseMinimalMobileTheme extends StyleNameFunctionTheme
	{
		/**
		 * The name of the embedded bitmap font used by controls in this theme.
		 */
		public static const FONT_NAME:String = "PF Ronda Seven";

		/**
		 * The stack of fonts to use for controls that don't use embedded fonts.
		 */
		public static const FONT_NAME_STACK:String = "PF Ronda Seven,Roboto,Helvetica,Arial,_sans";

		/**
		 * @private
		 * The theme's custom style name for item renderers in a SpinnerList.
		 */
		protected static const THEME_STYLE_NAME_SPINNER_LIST_ITEM_RENDERER:String = "minimal-mobile-spinner-list-item-renderer";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a horizontal slider.
		 */
		protected static const THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK:String = "minimal-mobile-horizontal-slider-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the minimum track of a vertical slider.
		 */
		protected static const THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK:String = "minimal-mobile-vertical-slider-minimum-track";

		/**
		 * @private
		 * The theme's custom style name for the item renderer of the
		 * SpinnerList in a DateTimeSpinner.
		 */
		protected static const THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER:String = "minimal-mobile-date-time-spinner-list-item-renderer";

		/**
		 * @private
		 * The theme's custom style name for item renderers in a PickerList.
		 */
		protected static const THEME_STYLE_NAME_TABLET_PICKER_LIST_ITEM_RENDERER:String = "minimal-mobile-tablet-picker-list-item-renderer";

		/**
		 * @private
		 * The theme's custom style name for a button in an Alert's button group.
		 */
		protected static const THEME_STYLE_NAME_ALERT_BUTTON_GROUP_BUTTON:String = "minimal-mobile-alert-button-group-button";
		
		/**
		 * @private
		 * The theme's custom style name for a button in a Toast.
		 */
		protected static const THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON:String = "minimal-mobile-toast-actions-button";

		protected static const FONT_TEXTURE_NAME:String = "pf_ronda_seven_0";

		protected static const DEFAULT_SCALE_9_GRID:Rectangle = new Rectangle(4, 4, 1, 1);
		protected static const SCROLLBAR_THUMB_SCALE_9_GRID:Rectangle = new Rectangle(1, 1, 2, 2);
		protected static const ITEM_RENDERER_SCALE_9_GRID:Rectangle = new Rectangle(1, 3, 1, 1);
		protected static const TAB_SCALE_9_GRID:Rectangle = new Rectangle(11, 11, 1, 1);
		protected static const HEADER_SCALE_9_GRID:Rectangle = new Rectangle(1, 3, 1, 1);
		protected static const SPINNER_LIST_SELECTION_OVERLAY_SCALE9_GRID:Rectangle = new Rectangle(1, 3, 1, 1);
		protected static const SEEK_SLIDER_PROGRESS_SKIN_SCALE9_GRID:Rectangle = new Rectangle(0, 2, 2, 10);
		protected static const BACK_BUTTON_SCALE9_GRID:Rectangle = new Rectangle(16, 0, 1, 28);
		protected static const FORWARD_BUTTON_SCALE9_GRID:Rectangle = new Rectangle(3, 0, 1, 28);
		protected static const FOCUS_INDICATOR_SCALE_9_GRID:Rectangle = new Rectangle(5, 5, 1, 1);
		protected static const DATA_GRID_HEADER_DIVIDER_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 4, 3);
		protected static const DATA_GRID_HEADER_RENDERER_SCALE_9_GRID:Rectangle = new Rectangle(1, 1, 1, 1);
		protected static const DATA_GRID_COLUMN_RESIZE_SKIN_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 2, 3);
		protected static const DATA_GRID_COLUMN_DROP_INDICATOR_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 2, 3);

		protected static const BACKGROUND_COLOR:uint = 0xf3f3f3;
		protected static const LIST_BACKGROUND_COLOR:uint = 0xf8f8f8;
		protected static const LIST_HEADER_BACKGROUND_COLOR:uint = 0xeeeeee;
		protected static const DRAWERS_DIVIDER_COLOR:uint = 0xebebeb;
		protected static const PRIMARY_TEXT_COLOR:uint = 0x666666;
		protected static const DISABLED_TEXT_COLOR:uint = 0x999999;
		protected static const DANGER_TEXT_COLOR:uint = 0x990000;
		protected static const MODAL_OVERLAY_COLOR:uint = 0xcccccc;
		protected static const MODAL_OVERLAY_ALPHA:Number = 0.4;
		protected static const VIDEO_OVERLAY_COLOR:uint = 0xcccccc;
		protected static const VIDEO_OVERLAY_ALPHA:Number = 0.2;
		protected static const DATA_GRID_COLUMN_OVERLAY_COLOR:uint = 0xeeeeee;
		protected static const DATA_GRID_COLUMN_OVERLAY_ALPHA:Number = 0.6;

		/**
		 * The default global text renderer factory for this theme creates a
		 * BitmapFontTextRenderer.
		 */
		protected static function textRendererFactory():ITextRenderer
		{
			var renderer:BitmapFontTextRenderer = new BitmapFontTextRenderer();
			//since it's a pixel font, we don't want to smooth it.
			renderer.textureSmoothing = TextureSmoothing.NONE;
			return renderer;
		}

		/**
		 * The default global text editor factory for this theme creates a
		 * StageTextTextEditor.
		 */
		protected static function textEditorFactory():ITextEditor
		{
			return new StageTextTextEditor();
		}

		/**
		 * The text editor factory for a TextArea creates a
		 * TextFieldTextEditorViewPort.
		 */
		protected static function textAreaTextEditorFactory():ITextEditorViewPort
		{
			return new TextFieldTextEditorViewPort();
		}

		/**
		 * The text editor factory for a NumericStepper creates a
		 * BitmapFontTextEditor.
		 */
		protected static function numericStepperTextEditorFactory():BitmapFontTextEditor
		{
			//we're only using this text editor in the NumericStepper because
			//isEditable is false on the TextInput. this text editor is not
			//suitable for mobile use if the TextInput needs to be editable
			//because it can't use the soft keyboard or other mobile-friendly UI
			var editor:BitmapFontTextEditor = new BitmapFontTextEditor();
			//since it's a pixel font, we don't want to smooth it.
			editor.textureSmoothing = TextureSmoothing.NONE;
			return editor;
		}

		protected static function pickerListButtonFactory():ToggleButton
		{
			return new ToggleButton();
		}
		
		protected static function pickerListSpinnerListFactory():SpinnerList
		{
			return new SpinnerList();
		}

		protected static function popUpOverlayFactory():DisplayObject
		{
			var quad:Quad = new Quad(100, 100, MODAL_OVERLAY_COLOR);
			quad.alpha = MODAL_OVERLAY_ALPHA;
			return quad;
		}

		/**
		 * This theme's scroll bar type is SimpleScrollBar.
		 */
		protected static function scrollBarFactory():SimpleScrollBar
		{
			return new SimpleScrollBar();
		}

		/**
		 * Constructor.
		 *
		 * @param scaleToDPI Determines if the theme's skins will be scaled based on the screen density and content scale factor.
		 */
		public function BaseMinimalMobileTheme()
		{
			super();
		}

		/**
		 * A normal font size.
		 */
		protected var fontSize:int = 12;

		/**
		 * A larger font size for headers.
		 */
		protected var largeFontSize:int = 16;

		/**
		 * A smaller font size for details.
		 */
		protected var smallFontSize:int = 8;

		/**
		 * The texture atlas that contains skins for this theme. This base class
		 * does not initialize this member variable. Subclasses are expected to
		 * load the assets somehow and set the <code>atlas</code> member
		 * variable before calling <code>initialize()</code>.
		 */
		protected var atlas:TextureAtlas;

		protected var focusIndicatorSkinTexture:Texture;

		protected var buttonUpSkinTexture:Texture;
		protected var buttonDownSkinTexture:Texture;
		protected var buttonDisabledSkinTexture:Texture;
		protected var buttonSelectedSkinTexture:Texture;
		protected var buttonSelectedDisabledSkinTexture:Texture;
		protected var buttonCallToActionUpSkinTexture:Texture;
		protected var buttonDangerUpSkinTexture:Texture;
		protected var buttonDangerDownSkinTexture:Texture;
		protected var buttonBackUpSkinTexture:Texture;
		protected var buttonBackDownSkinTexture:Texture;
		protected var buttonBackDisabledSkinTexture:Texture;
		protected var buttonForwardUpSkinTexture:Texture;
		protected var buttonForwardDownSkinTexture:Texture;
		protected var buttonForwardDisabledSkinTexture:Texture;

		protected var tabDownSkinTexture:Texture;
		protected var tabSelectedSkinTexture:Texture;
		protected var tabSelectedDisabledSkinTexture:Texture;

		protected var thumbSkinTexture:Texture;
		protected var thumbDisabledSkinTexture:Texture;

		protected var scrollBarThumbSkinTexture:Texture;

		protected var insetBackgroundSkinTexture:Texture;
		protected var insetBackgroundDisabledSkinTexture:Texture;
		protected var insetBackgroundFocusedSkinTexture:Texture;
		protected var insetBackgroundDangerSkinTexture:Texture;

		protected var pickerListButtonIconUpTexture:Texture;
		protected var pickerListButtonIconSelectedTexture:Texture;
		protected var pickerListButtonIconDisabledTexture:Texture;
		protected var searchIconTexture:Texture;
		protected var searchIconDisabledTexture:Texture;

		protected var itemRendererUpSkinTexture:Texture;
		protected var itemRendererDownSkinTexture:Texture;
		protected var itemRendererSelectedUpSkinTexture:Texture;
		protected var checkItemRendererSelectedIconTexture:Texture;
		protected var spinnerListSelectionOverlaySkinTexture:Texture;
		protected var dragHandleIcon:Texture;

		protected var headerSkinTexture:Texture;
		protected var panelHeaderSkinTexture:Texture;

		protected var panelBackgroundSkinTexture:Texture;
		protected var popUpBackgroundSkinTexture:Texture;
		protected var dangerPopUpBackgroundSkinTexture:Texture;
		protected var calloutTopArrowSkinTexture:Texture;
		protected var calloutBottomArrowSkinTexture:Texture;
		protected var calloutLeftArrowSkinTexture:Texture;
		protected var calloutRightArrowSkinTexture:Texture;
		protected var dangerCalloutTopArrowSkinTexture:Texture;
		protected var dangerCalloutBottomArrowSkinTexture:Texture;
		protected var dangerCalloutLeftArrowSkinTexture:Texture;
		protected var dangerCalloutRightArrowSkinTexture:Texture;

		protected var checkIconTexture:Texture;
		protected var checkDisabledIconTexture:Texture;
		protected var checkSelectedIconTexture:Texture;
		protected var checkSelectedDisabledIconTexture:Texture;

		protected var radioIconTexture:Texture;
		protected var radioDisabledIconTexture:Texture;
		protected var radioSelectedIconTexture:Texture;
		protected var radioSelectedDisabledIconTexture:Texture;

		protected var pageIndicatorNormalSkinTexture:Texture;
		protected var pageIndicatorSelectedSkinTexture:Texture;

		//media textures
		protected var playPauseButtonPlayUpIconTexture:Texture;
		protected var playPauseButtonPauseUpIconTexture:Texture;
		protected var overlayPlayPauseButtonPlayUpIconTexture:Texture;
		protected var fullScreenToggleButtonEnterUpIconTexture:Texture;
		protected var fullScreenToggleButtonExitUpIconTexture:Texture;
		protected var muteToggleButtonLoudUpIconTexture:Texture;
		protected var muteToggleButtonMutedUpIconTexture:Texture;
		protected var seekSliderProgressSkinTexture:Texture;
		protected var volumeSliderMinimumTrackSkinTexture:Texture;
		protected var volumeSliderMaximumTrackSkinTexture:Texture;
		
		protected var listDrillDownAccessoryTexture:Texture;

		protected var treeDisclosureOpenIconTexture:Texture;
		protected var treeDisclosureClosedIconTexture:Texture;

		protected var dataGridHeaderRendererSkinTexture:Texture;
		protected var dataGridHeaderDividerSkinTexture:Texture;
		protected var dataGridColumnResizeSkinTexture:Texture;
		protected var dataGridColumnDropIndicatorSkinTexture:Texture;
		protected var dataGridHeaderSortDescendingIconTexture:Texture;
		protected var dataGridHeaderSortAscendingIconTexture:Texture;
		protected var dataGridCellRendererDownSkinTexture:Texture;
		protected var dataGridCellRendererSelectedUpSkinTexture:Texture;

		/**
		 * The size, in pixels, of major regions in the grid. Used for sizing
		 * containers and larger UI controls.
		 */
		protected var gridSize:int = 44;

		/**
		 * The size, in pixels, of minor regions in the grid. Used for larger
		 * padding and gaps.
		 */
		protected var gutterSize:int = 11;

		/**
		 * The size, in pixels, of smaller padding and gaps within the major
		 * regions in the grid.
		 */
		protected var smallGutterSize:int = 6;

		/**
		 * The width, in pixels, of UI controls that span across multiple grid regions.
		 */
		protected var wideControlSize:int = 154;

		/**
		 * The width, in pixels, of very large UI controls.
		 */
		protected var extraWideControlSize:int = 308;

		/**
		 * The size, in pixels, of a typical UI control.
		 */
		protected var controlSize:int = 30;

		/**
		 * The size, in pixels, of smaller UI controls.
		 */
		protected var smallControlSize:int = 16;

		/**
		 * The size, in pixels, of a UI control's border.
		 */
		protected var borderSize:int = 2;

		protected var simpleScrollBarThumbSize:int = 4;
		protected var calloutBackgroundMinSize:int = 6;
		protected var calloutBottomRightArrowOverlapGapSize:Number = -10.5;
		protected var calloutTopLeftArrowOverlapGapSize:int = -4;
		protected var popUpFillSize:int = 276;
		protected var dropShadowSize:int = 6;
		protected var focusPaddingSize:int = -4;
		protected var tabFocusPaddingSize:int = 4;

		protected var primaryFontStyles:TextFormat;
		protected var disabledFontStyles:TextFormat;
		protected var centeredFontStyles:TextFormat;
		protected var centeredDisabledFontStyles:TextFormat;
		protected var headingFontStyles:TextFormat;
		protected var headingDisabledFontStyles:TextFormat;
		protected var detailFontStyles:TextFormat;
		protected var detailDisabledFontStyles:TextFormat;
		protected var dangerFontStyles:TextFormat;
		protected var scrollTextFontStyles:TextFormat;
		protected var scrollTextDisabledFontStyles:TextFormat;

		/**
		 * Disposes the texture atlas and bitmap font before calling
		 * super.dispose().
		 */
		override public function dispose():void
		{
			if(this.atlas)
			{
				//if anything is keeping a reference to the texture, we don't
				//want it to keep a reference to the theme too.
				this.atlas.texture.root.onRestore = null;

				this.atlas.dispose();
				this.atlas = null;
			}
			TextField.unregisterCompositor(FONT_NAME);

			//don't forget to call super.dispose()!
			super.dispose();
		}

		/**
		 * Initializes the theme. Expected to be called by subclasses after the
		 * assets have been loaded and the skin texture atlas has been created.
		 */
		protected function initialize():void
		{
			this.initializeTextures();
			this.initializeFonts();
			this.initializeGlobals();
			this.initializeStage();
			this.initializeStyleProviders();
		}

		/**
		 * Sets the stage background color.
		 */
		protected function initializeStage():void
		{
			this.starling.stage.color = BACKGROUND_COLOR;
			this.starling.nativeStage.color = BACKGROUND_COLOR;
		}

		/**
		 * Initializes global variables (not including global style providers).
		 */
		protected function initializeGlobals():void
		{
			PopUpManager.overlayFactory = popUpOverlayFactory;
			Callout.stagePadding = this.smallGutterSize;
			Toast.containerFactory = toastContainerFactory;

			FeathersControl.defaultTextRendererFactory = textRendererFactory;
			FeathersControl.defaultTextEditorFactory = textEditorFactory;

			var stage:Stage = this.starling.stage;
			FocusManager.setEnabledForStage(stage, true);
		}

		/**
		 * Initializes the textures by extracting them from the atlas and
		 * setting up any scaling grids that are needed.
		 */
		protected function initializeTextures():void
		{
			this.focusIndicatorSkinTexture = this.atlas.getTexture("focus-indicator-skin0000");

			this.buttonUpSkinTexture = this.atlas.getTexture("button-up-skin0000");
			this.buttonDownSkinTexture = this.atlas.getTexture("button-down-skin0000");
			this.buttonDisabledSkinTexture = this.atlas.getTexture("button-disabled-skin0000");
			this.buttonSelectedSkinTexture = this.atlas.getTexture("inset-background-enabled-skin0000");
			this.buttonSelectedDisabledSkinTexture = this.atlas.getTexture("inset-background-disabled-skin0000");
			this.buttonCallToActionUpSkinTexture = this.atlas.getTexture("call-to-action-button-up-skin0000");
			this.buttonDangerUpSkinTexture = this.atlas.getTexture("danger-button-up-skin0000");
			this.buttonDangerDownSkinTexture = this.atlas.getTexture("danger-button-down-skin0000");
			this.buttonBackUpSkinTexture = this.atlas.getTexture("back-button-up-skin0000");
			this.buttonBackDownSkinTexture = this.atlas.getTexture("back-button-down-skin0000");
			this.buttonBackDisabledSkinTexture = this.atlas.getTexture("back-button-disabled-skin0000");
			this.buttonForwardUpSkinTexture = this.atlas.getTexture("forward-button-up-skin0000");
			this.buttonForwardDownSkinTexture = this.atlas.getTexture("forward-button-down-skin0000");
			this.buttonForwardDisabledSkinTexture = this.atlas.getTexture("forward-button-disabled-skin0000");

			this.tabDownSkinTexture = this.atlas.getTexture("tab-down-skin0000");
			this.tabSelectedSkinTexture = this.atlas.getTexture("tab-selected-up-skin0000");
			this.tabSelectedDisabledSkinTexture = this.atlas.getTexture("tab-selected-disabled-skin0000");

			this.thumbSkinTexture = this.atlas.getTexture("face-up-skin0000");
			this.thumbDisabledSkinTexture = this.atlas.getTexture("face-disabled-skin0000");

			this.scrollBarThumbSkinTexture = this.atlas.getTexture("simple-scroll-bar-thumb-skin0000");

			this.insetBackgroundSkinTexture = this.atlas.getTexture("inset-background-enabled-skin0000");
			this.insetBackgroundDisabledSkinTexture = this.atlas.getTexture("inset-background-disabled-skin0000");
			this.insetBackgroundFocusedSkinTexture = this.atlas.getTexture("inset-background-focused-skin0000");
			this.insetBackgroundDangerSkinTexture = this.atlas.getTexture("inset-background-danger-skin0000");

			this.pickerListButtonIconUpTexture = this.atlas.getTexture("picker-list-icon0000");
			this.pickerListButtonIconSelectedTexture = this.atlas.getTexture("picker-list-selected-icon0000");
			this.pickerListButtonIconDisabledTexture = this.atlas.getTexture("picker-list-disabled-icon0000");
			this.searchIconTexture = this.atlas.getTexture("search-enabled-icon0000");
			this.searchIconDisabledTexture = this.atlas.getTexture("search-disabled-icon0000");

			this.itemRendererUpSkinTexture = this.atlas.getTexture("item-renderer-up-skin0000");
			this.itemRendererDownSkinTexture = this.atlas.getTexture("item-renderer-down-skin0000");
			this.itemRendererSelectedUpSkinTexture = this.atlas.getTexture("item-renderer-selected-up-skin0000");
			this.checkItemRendererSelectedIconTexture = this.atlas.getTexture("check-item-renderer-selected-icon0000");

			this.spinnerListSelectionOverlaySkinTexture = this.atlas.getTexture("spinner-list-selection-overlay-skin0000");

			this.dragHandleIcon = this.atlas.getTexture("drag-handle-icon0000");

			this.headerSkinTexture = this.atlas.getTexture("header-background-skin0000");
			this.panelHeaderSkinTexture = this.atlas.getTexture("panel-header-background-skin0000");

			this.panelBackgroundSkinTexture = this.atlas.getTexture("panel-background-skin0000");
			this.popUpBackgroundSkinTexture = this.atlas.getTexture("pop-up-background-skin0000");
			this.dangerPopUpBackgroundSkinTexture = this.atlas.getTexture("danger-pop-up-background-skin0000");
			this.calloutTopArrowSkinTexture = this.atlas.getTexture("callout-top-arrow-skin0000");
			this.calloutBottomArrowSkinTexture = this.atlas.getTexture("callout-bottom-arrow-skin0000");
			this.calloutLeftArrowSkinTexture = this.atlas.getTexture("callout-left-arrow-skin0000");
			this.calloutRightArrowSkinTexture = this.atlas.getTexture("callout-right-arrow-skin0000");
			this.dangerCalloutTopArrowSkinTexture = this.atlas.getTexture("danger-callout-top-arrow-skin0000");
			this.dangerCalloutBottomArrowSkinTexture = this.atlas.getTexture("danger-callout-bottom-arrow-skin0000");
			this.dangerCalloutLeftArrowSkinTexture = this.atlas.getTexture("danger-callout-left-arrow-skin0000");
			this.dangerCalloutRightArrowSkinTexture = this.atlas.getTexture("danger-callout-right-arrow-skin0000");

			this.checkIconTexture = this.atlas.getTexture("check-up-icon0000");
			this.checkDisabledIconTexture = this.atlas.getTexture("check-disabled-icon0000");
			this.checkSelectedIconTexture = this.atlas.getTexture("check-selected-up-icon0000");
			this.checkSelectedDisabledIconTexture = this.atlas.getTexture("check-selected-disabled-icon0000");

			this.radioIconTexture = this.atlas.getTexture("radio-up-icon0000");
			this.radioDisabledIconTexture = this.atlas.getTexture("radio-disabled-icon0000");
			this.radioSelectedIconTexture = this.atlas.getTexture("radio-selected-up-icon0000");
			this.radioSelectedDisabledIconTexture = this.atlas.getTexture("radio-selected-disabled-icon0000");

			this.pageIndicatorNormalSkinTexture = this.atlas.getTexture("page-indicator-symbol0000");
			this.pageIndicatorSelectedSkinTexture = this.atlas.getTexture("page-indicator-selected-symbol0000");

			this.playPauseButtonPlayUpIconTexture = this.atlas.getTexture("play-pause-toggle-button-play-up-icon0000");
			this.playPauseButtonPauseUpIconTexture = this.atlas.getTexture("play-pause-toggle-button-pause-up-icon0000");
			this.overlayPlayPauseButtonPlayUpIconTexture = this.atlas.getTexture("overlay-play-pause-toggle-button-play-up-icon0000");
			this.fullScreenToggleButtonEnterUpIconTexture = this.atlas.getTexture("full-screen-toggle-button-enter-up-icon0000");
			this.fullScreenToggleButtonExitUpIconTexture = this.atlas.getTexture("full-screen-toggle-button-exit-up-icon0000");
			this.muteToggleButtonMutedUpIconTexture = this.atlas.getTexture("mute-toggle-button-muted-up-icon0000");
			this.muteToggleButtonLoudUpIconTexture = this.atlas.getTexture("mute-toggle-button-loud-up-icon0000");
			this.volumeSliderMinimumTrackSkinTexture = this.atlas.getTexture("volume-slider-minimum-track-skin0000");
			this.volumeSliderMaximumTrackSkinTexture = this.atlas.getTexture("volume-slider-maximum-track-skin0000");
			this.seekSliderProgressSkinTexture = this.atlas.getTexture("seek-slider-progress-skin0000");

			this.listDrillDownAccessoryTexture = this.atlas.getTexture("list-accessory-drill-down-icon0000");

			this.treeDisclosureOpenIconTexture = this.atlas.getTexture("tree-disclosure-open-icon0000");
			this.treeDisclosureClosedIconTexture = this.atlas.getTexture("tree-disclosure-closed-icon0000");

			this.dataGridHeaderRendererSkinTexture = this.atlas.getTexture("data-grid-header-renderer-skin0000");
			this.dataGridHeaderDividerSkinTexture = this.atlas.getTexture("data-grid-header-divider-skin0000");
			this.dataGridColumnResizeSkinTexture = this.atlas.getTexture("data-grid-column-resize-skin0000");
			this.dataGridColumnDropIndicatorSkinTexture = this.atlas.getTexture("data-grid-column-drop-indicator-skin0000");
			this.dataGridHeaderSortDescendingIconTexture = this.atlas.getTexture("data-grid-header-sort-descending-icon0000");
			this.dataGridHeaderSortAscendingIconTexture = this.atlas.getTexture("data-grid-header-sort-ascending-icon0000");
			this.dataGridCellRendererDownSkinTexture = this.atlas.getTexture("data-grid-cell-renderer-down-skin0000");
			this.dataGridCellRendererSelectedUpSkinTexture = this.atlas.getTexture("data-grid-cell-renderer-selected-up-skin0000");
		}

		/**
		 * Initializes font sizes and formats.
		 */
		protected function initializeFonts():void
		{
			this.primaryFontStyles = new TextFormat(FONT_NAME, this.fontSize, PRIMARY_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.disabledFontStyles = new TextFormat(FONT_NAME, this.fontSize, DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.centeredFontStyles = new TextFormat(FONT_NAME, this.fontSize, PRIMARY_TEXT_COLOR, HorizontalAlign.CENTER, VerticalAlign.TOP);
			this.centeredDisabledFontStyles = new TextFormat(FONT_NAME, this.fontSize, DISABLED_TEXT_COLOR, HorizontalAlign.CENTER, VerticalAlign.TOP);
			this.headingFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, PRIMARY_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.headingDisabledFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.detailFontStyles = new TextFormat(FONT_NAME, this.smallFontSize, PRIMARY_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.detailDisabledFontStyles = new TextFormat(FONT_NAME, this.smallFontSize, DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.dangerFontStyles = new TextFormat(FONT_NAME, this.fontSize, DANGER_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.scrollTextFontStyles = new TextFormat(FONT_NAME_STACK, this.fontSize, PRIMARY_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.scrollTextDisabledFontStyles = new TextFormat(FONT_NAME_STACK, this.fontSize, DISABLED_TEXT_COLOR, HorizontalAlign.LEFT, VerticalAlign.TOP);
		}

		/**
		 * Sets global style providers for all components.
		 */
		protected function initializeStyleProviders():void
		{
			//alert
			this.getStyleProviderForClass(Alert).defaultStyleFunction = this.setAlertStyles;
			this.getStyleProviderForClass(Header).setFunctionForStyleName(Alert.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setPanelHeaderStyles);
			this.getStyleProviderForClass(ButtonGroup).setFunctionForStyleName(Alert.DEFAULT_CHILD_STYLE_NAME_BUTTON_GROUP, this.setAlertButtonGroupStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_ALERT_BUTTON_GROUP_BUTTON, this.setAlertButtonGroupButtonStyles);

			//auto-complete
			this.getStyleProviderForClass(AutoComplete).defaultStyleFunction = this.setTextInputStyles;
			this.getStyleProviderForClass(List).setFunctionForStyleName(AutoComplete.DEFAULT_CHILD_STYLE_NAME_LIST, this.setDropDownListStyles);

			//button
			this.getStyleProviderForClass(Button).defaultStyleFunction = this.setButtonStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_CALL_TO_ACTION_BUTTON, this.setCallToActionButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_QUIET_BUTTON, this.setQuietButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_DANGER_BUTTON, this.setDangerButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON, this.setBackButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_FORWARD_BUTTON, this.setForwardButtonStyles);

			//button group
			this.getStyleProviderForClass(ButtonGroup).defaultStyleFunction = this.setButtonGroupStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ButtonGroup.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setButtonGroupButtonStyles);
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(ButtonGroup.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setButtonGroupButtonStyles);

			//callout
			this.getStyleProviderForClass(Callout).defaultStyleFunction = this.setCalloutStyles;

			//check
			this.getStyleProviderForClass(Check).defaultStyleFunction = this.setCheckStyles;

			//data grid
			this.getStyleProviderForClass(DataGrid).defaultStyleFunction = this.setDataGridStyles;
			this.getStyleProviderForClass(DefaultDataGridHeaderRenderer).defaultStyleFunction = this.setDataGridHeaderRendererStyles;
			this.getStyleProviderForClass(DefaultDataGridCellRenderer).defaultStyleFunction = this.setDataGridCellRendererStyles;

			//date time spinner
			this.getStyleProviderForClass(DateTimeSpinner).defaultStyleFunction = this.setDateTimeSpinnerStyles;
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER, this.setDateTimeSpinnerListItemRendererStyles);

			//drawers
			this.getStyleProviderForClass(Drawers).defaultStyleFunction = this.setDrawersStyles;

			//grouped list (see also: item renderers)
			this.getStyleProviderForClass(GroupedList).defaultStyleFunction = this.setGroupedListStyles;
			this.getStyleProviderForClass(GroupedList).setFunctionForStyleName(GroupedList.ALTERNATE_STYLE_NAME_INSET_GROUPED_LIST, this.setInsetGroupedListStyles);

			//header
			this.getStyleProviderForClass(Header).defaultStyleFunction = this.setHeaderStyles;

			//item renderers for lists
			this.getStyleProviderForClass(DefaultListItemRenderer).defaultStyleFunction = this.setListItemRendererStyles;
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(DefaultListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN, this.setDrillDownItemRendererStyles);
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(DefaultListItemRenderer.ALTERNATE_STYLE_NAME_CHECK, this.setCheckItemRendererStyles);
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(THEME_STYLE_NAME_SPINNER_LIST_ITEM_RENDERER, this.setSpinnerListItemRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).defaultStyleFunction = this.setItemRendererStyles;
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(DefaultGroupedListItemRenderer.ALTERNATE_STYLE_NAME_DRILL_DOWN, this.setDrillDownItemRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(DefaultGroupedListItemRenderer.ALTERNATE_STYLE_NAME_CHECK, this.setCheckItemRendererStyles);

			//header and footer renderers for grouped list
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).defaultStyleFunction = this.setGroupedListHeaderOrFooterRendererStyles;
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).setFunctionForStyleName(GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_HEADER_RENDERER, this.setInsetGroupedListHeaderOrFooterRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).setFunctionForStyleName(GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_FOOTER_RENDERER, this.setInsetGroupedListHeaderOrFooterRendererStyles);

			//label
			this.getStyleProviderForClass(Label).defaultStyleFunction = this.setLabelStyles;
			this.getStyleProviderForClass(Label).setFunctionForStyleName(Label.ALTERNATE_STYLE_NAME_HEADING, this.setHeadingLabelStyles);
			this.getStyleProviderForClass(Label).setFunctionForStyleName(Label.ALTERNATE_STYLE_NAME_DETAIL, this.setDetailLabelStyles);

			//layout group
			this.getStyleProviderForClass(LayoutGroup).setFunctionForStyleName(LayoutGroup.ALTERNATE_STYLE_NAME_TOOLBAR, this.setToolbarLayoutGroupStyles);

			//list (see also: item renderers)
			this.getStyleProviderForClass(List).defaultStyleFunction = this.setListStyles;

			//numeric stepper
			this.getStyleProviderForClass(NumericStepper).defaultStyleFunction = this.setNumericStepperStyles;
			this.getStyleProviderForClass(TextInput).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_TEXT_INPUT, this.setNumericStepperTextInputStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON, this.setNumericStepperButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON, this.setNumericStepperButtonStyles);

			//page indicator
			this.getStyleProviderForClass(PageIndicator).defaultStyleFunction = this.setPageIndicatorStyles;

			//panel
			this.getStyleProviderForClass(Panel).defaultStyleFunction = this.setPanelStyles;
			this.getStyleProviderForClass(Header).setFunctionForStyleName(Panel.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setPanelHeaderStyles);

			//panel screen
			this.getStyleProviderForClass(PanelScreen).defaultStyleFunction = this.setPanelScreenStyles;
			this.getStyleProviderForClass(Header).setFunctionForStyleName(PanelScreen.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setPanelScreenHeaderStyles);

			//picker list (see also: item renderers)
			this.getStyleProviderForClass(PickerList).defaultStyleFunction = this.setPickerListStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setPickerListButtonStyles);
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setPickerListButtonStyles);
			this.getStyleProviderForClass(List).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_LIST, this.setPickerListPopUpListStyles);
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(THEME_STYLE_NAME_TABLET_PICKER_LIST_ITEM_RENDERER, this.setTabletPickerListItemRendererStyles);
			
			//progress bar
			this.getStyleProviderForClass(ProgressBar).defaultStyleFunction = this.setProgressBarStyles;

			//radio
			this.getStyleProviderForClass(Radio).defaultStyleFunction = this.setRadioStyles;

			//scroll container
			this.getStyleProviderForClass(ScrollContainer).defaultStyleFunction = this.setScrollContainerStyles;
			this.getStyleProviderForClass(ScrollContainer).setFunctionForStyleName(ScrollContainer.ALTERNATE_STYLE_NAME_TOOLBAR, this.setToolbarScrollContainerStyles);

			//scroll screen
			this.getStyleProviderForClass(ScrollScreen).defaultStyleFunction = this.setScrollScreenStyles;

			//scroll text
			this.getStyleProviderForClass(ScrollText).defaultStyleFunction = this.setScrollTextStyles;

			//simple scroll bar
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SimpleScrollBar.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setSimpleScrollBarThumbStyles);

			//slider
			this.getStyleProviderForClass(Slider).defaultStyleFunction = this.setSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Slider.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK, this.setHorizontalSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK, this.setVerticalSliderMinimumTrackStyles);

			//spinner list
			this.getStyleProviderForClass(SpinnerList).defaultStyleFunction = this.setSpinnerListStyles;

			//tab bar
			this.getStyleProviderForClass(TabBar).defaultStyleFunction = this.setTabBarStyles;
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(TabBar.DEFAULT_CHILD_STYLE_NAME_TAB, this.setTabStyles);

			//text input
			this.getStyleProviderForClass(TextInput).defaultStyleFunction = this.setTextInputStyles;
			this.getStyleProviderForClass(TextInput).setFunctionForStyleName(TextInput.ALTERNATE_STYLE_NAME_SEARCH_TEXT_INPUT, this.setSearchTextInputStyles);
			this.getStyleProviderForClass(TextCallout).setFunctionForStyleName(TextInput.DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT, this.setTextInputErrorCalloutStyles);

			//text area
			this.getStyleProviderForClass(TextArea).defaultStyleFunction = this.setTextAreaStyles;
			this.getStyleProviderForClass(TextCallout).setFunctionForStyleName(TextArea.DEFAULT_CHILD_STYLE_NAME_ERROR_CALLOUT, this.setTextAreaErrorCalloutStyles);

			//text callout
			this.getStyleProviderForClass(TextCallout).defaultStyleFunction = this.setTextCalloutStyles;

			//toast
			this.getStyleProviderForClass(Toast).defaultStyleFunction = this.setToastStyles;
			this.getStyleProviderForClass(ButtonGroup).setFunctionForStyleName(Toast.DEFAULT_CHILD_STYLE_NAME_ACTIONS, this.setToastActionsStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON, this.setToastActionsButtonStyles);

			//toggle button
			this.getStyleProviderForClass(ToggleButton).defaultStyleFunction = this.setButtonStyles;
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_QUIET_BUTTON, this.setQuietButtonStyles);

			//toggle switch
			this.getStyleProviderForClass(ToggleSwitch).defaultStyleFunction = this.setToggleSwitchStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setToggleSwitchThumbStyles);
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setToggleSwitchThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_ON_TRACK, this.setToggleSwitchOnTrackStyles);

			//tree
			this.getStyleProviderForClass(Tree).defaultStyleFunction = this.setTreeStyles;
			this.getStyleProviderForClass(DefaultTreeItemRenderer).defaultStyleFunction = this.setTreeItemRendererStyles;

			//media controls
			this.getStyleProviderForClass(VideoPlayer).defaultStyleFunction = this.setVideoPlayerStyles;

			//play/pause toggle button
			this.getStyleProviderForClass(PlayPauseToggleButton).defaultStyleFunction = this.setPlayPauseToggleButtonStyles;
			this.getStyleProviderForClass(PlayPauseToggleButton).setFunctionForStyleName(PlayPauseToggleButton.ALTERNATE_STYLE_NAME_OVERLAY_PLAY_PAUSE_TOGGLE_BUTTON, this.setOverlayPlayPauseToggleButtonStyles);

			//full screen toggle button
			this.getStyleProviderForClass(FullScreenToggleButton).defaultStyleFunction = this.setFullScreenToggleButtonStyles;

			//mute toggle button
			this.getStyleProviderForClass(MuteToggleButton).defaultStyleFunction = this.setMuteToggleButtonStyles;

			//seek slider
			this.getStyleProviderForClass(SeekSlider).defaultStyleFunction = this.setSeekSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SeekSlider.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(SeekSlider.DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK, this.setHorizontalSliderMinimumTrackStyles);

			//volume slider
			this.getStyleProviderForClass(VolumeSlider).defaultStyleFunction = this.setVolumeSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(VolumeSlider.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setVolumeSliderThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(VolumeSlider.DEFAULT_CHILD_STYLE_NAME_MINIMUM_TRACK, this.setVolumeSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(VolumeSlider.DEFAULT_CHILD_STYLE_NAME_MAXIMUM_TRACK, this.setVolumeSliderMaximumTrackStyles);

		}

		protected function pageIndicatorNormalSymbolFactory():DisplayObject
		{
			return new Image(this.pageIndicatorNormalSkinTexture);
		}

		protected function pageIndicatorSelectedSymbolFactory():DisplayObject
		{
			return new Image(this.pageIndicatorSelectedSkinTexture);
		}

		protected function dataGridHeaderDividerFactory():DisplayObject
		{
			var skin:ImageSkin = new ImageSkin(this.dataGridHeaderDividerSkinTexture);
			skin.scale9Grid = DATA_GRID_HEADER_DIVIDER_SCALE_9_GRID;
			skin.minTouchWidth = this.controlSize;
			return skin;
		}

		protected function toastContainerFactory():DisplayObjectContainer
		{
			var container:LayoutGroup = new LayoutGroup();
			container.autoSizeMode = AutoSizeMode.STAGE;

			var layout:VerticalLayout = new VerticalLayout();
			layout.verticalAlign = VerticalAlign.BOTTOM;
			if(DeviceCapabilities.isPhone())
			{
				layout.horizontalAlign = HorizontalAlign.JUSTIFY;
			}
			else
			{
				layout.horizontalAlign = HorizontalAlign.LEFT;
				layout.padding = this.gutterSize;
				layout.gap = this.gutterSize;
			}
			container.layout = layout;
			return container;
		}

	//-------------------------
	// Shared
	//-------------------------

		protected function setNoStyles(target:DisplayObject):void
		{
			//if this is assigned as a style function, chances are the target
			//will be a subcomponent of something. the style function for this
			//component's parent is probably handing the styling for the target
		}

		protected function setScrollerStyles(scroller:Scroller):void
		{
			scroller.horizontalScrollBarFactory = scrollBarFactory;
			scroller.verticalScrollBarFactory = scrollBarFactory;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			scroller.focusIndicatorSkin = focusIndicatorSkin;
			scroller.focusPadding = 0;
		}

		protected function setDropDownListStyles(list:List):void
		{
			var backgroundSkin:Quad = new Quad(this.gridSize, this.gridSize, LIST_BACKGROUND_COLOR);
			list.backgroundSkin = backgroundSkin;

			var layout:VerticalLayout = new VerticalLayout();
			layout.horizontalAlign = HorizontalAlign.JUSTIFY;
			layout.maxRowCount = 4;
			list.layout = layout;
		}

	//-------------------------
	// Alert
	//-------------------------

		protected function setAlertStyles(alert:Alert):void
		{
			this.setScrollerStyles(alert);

			var backgroundSkin:Image = new Image(this.popUpBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			alert.backgroundSkin = backgroundSkin;

			alert.fontStyles = this.primaryFontStyles.clone();
			alert.disabledFontStyles = this.disabledFontStyles.clone();

			alert.paddingTop = this.gutterSize;
			alert.paddingRight = this.gutterSize;
			alert.paddingBottom = this.smallGutterSize;
			alert.paddingLeft = this.gutterSize;
			alert.outerPadding = this.borderSize;
			alert.outerPaddingBottom = this.borderSize + this.dropShadowSize;
			alert.outerPaddingRight = this.borderSize + this.dropShadowSize;
			alert.gap = this.smallGutterSize;
			alert.maxWidth = this.popUpFillSize;
			alert.maxHeight = this.popUpFillSize;
		}

		protected function setAlertButtonGroupStyles(group:ButtonGroup):void
		{
			group.customButtonStyleName = THEME_STYLE_NAME_ALERT_BUTTON_GROUP_BUTTON;
			group.direction = Direction.VERTICAL;
			group.horizontalAlign = HorizontalAlign.JUSTIFY;
			group.verticalAlign = VerticalAlign.JUSTIFY;
			group.gap = this.smallGutterSize;
			group.padding = this.smallGutterSize;
		}

		protected function setAlertButtonGroupButtonStyles(button:Button):void
		{
			this.setButtonGroupButtonStyles(button);
		}

	//-------------------------
	// Button
	//-------------------------

		protected function setBaseButtonStyles(button:Button):void
		{
			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;

			button.paddingTop = this.smallGutterSize;
			button.paddingBottom = this.smallGutterSize;
			button.paddingLeft = this.gutterSize;
			button.paddingRight = this.gutterSize;
			button.gap = this.smallGutterSize;
			button.minGap = this.smallGutterSize;
			button.minTouchWidth = this.gridSize;
			button.minTouchHeight = this.gridSize;
		}

		protected function setButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				skin.selectedTexture = this.buttonSelectedSkinTexture;
				skin.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.buttonDownSkinTexture);
				skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.buttonSelectedDisabledSkinTexture);
			}
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.smallControlSize;
			skin.minHeight = this.smallControlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setCallToActionButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonCallToActionUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.smallControlSize;
			skin.minHeight = this.smallControlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setQuietButtonStyles(button:Button):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			button.defaultSkin = defaultSkin;

			var otherSkin:ImageSkin = new ImageSkin(null);
			otherSkin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				otherSkin.selectedTexture = this.buttonSelectedSkinTexture;
				otherSkin.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.buttonDownSkinTexture);
				otherSkin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.buttonSelectedDisabledSkinTexture);
				ToggleButton(button).defaultSelectedSkin = otherSkin;
				button.setSkinForState(ButtonState.DOWN_AND_SELECTED, otherSkin);
				button.setSkinForState(ButtonState.DISABLED_AND_SELECTED, otherSkin);
			}
			button.setSkinForState(ButtonState.DOWN, otherSkin);
			otherSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			otherSkin.width = this.controlSize;
			otherSkin.height = this.controlSize;
			otherSkin.minWidth = this.controlSize;
			otherSkin.minHeight = this.controlSize;

			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setDangerButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonDangerUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDangerDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.dangerFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setBackButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonBackUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonBackDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonBackDisabledSkinTexture);
			skin.scale9Grid = BACK_BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);

			button.height = this.controlSize;
			button.paddingLeft = 2 * this.gutterSize;
		}

		protected function setForwardButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonForwardUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonForwardDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonForwardDisabledSkinTexture);
			skin.scale9Grid = FORWARD_BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);

			button.height = this.controlSize;
			button.paddingRight = 2 * this.gutterSize;
		}

	//-------------------------
	// ButtonGroup
	//-------------------------

		protected function setButtonGroupStyles(group:ButtonGroup):void
		{
			group.gap = this.smallGutterSize;
		}

		protected function setButtonGroupButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				skin.selectedTexture = this.buttonSelectedSkinTexture;
				skin.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.buttonDownSkinTexture);
				skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.buttonSelectedDisabledSkinTexture);
			}
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.popUpFillSize;
			skin.height = this.gridSize;
			skin.minWidth = this.popUpFillSize;
			button.minHeight = this.gridSize;
			button.defaultSkin = skin;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;

			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			button.paddingTop = this.smallGutterSize;
			button.paddingBottom = this.smallGutterSize;
			button.paddingLeft = this.gutterSize;
			button.paddingRight = this.gutterSize;
			button.gap = this.smallGutterSize;
			button.minGap = this.smallGutterSize;
			button.minTouchWidth = this.gridSize;
			button.minTouchHeight = this.gridSize;
		}

	//-------------------------
	// Callout
	//-------------------------

		protected function setCalloutStyles(callout:Callout):void
		{
			callout.padding = this.smallGutterSize;
			callout.paddingRight = this.gutterSize + this.dropShadowSize;
			callout.paddingBottom = this.gutterSize + this.dropShadowSize;

			var backgroundSkin:Image = new Image(this.popUpBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundSkin.width = this.calloutBackgroundMinSize;
			backgroundSkin.height = this.calloutBackgroundMinSize;
			callout.backgroundSkin = backgroundSkin;

			var topArrowSkin:Image = new Image(this.calloutTopArrowSkinTexture);
			callout.topArrowSkin = topArrowSkin;
			callout.topArrowGap = this.calloutTopLeftArrowOverlapGapSize;

			var bottomArrowSkin:Image = new Image(this.calloutBottomArrowSkinTexture);
			callout.bottomArrowSkin = bottomArrowSkin;
			callout.bottomArrowGap = this.calloutBottomRightArrowOverlapGapSize;

			var leftArrowSkin:Image = new Image(this.calloutLeftArrowSkinTexture);
			callout.leftArrowSkin = leftArrowSkin;
			callout.leftArrowGap = this.calloutTopLeftArrowOverlapGapSize;

			var rightArrowSkin:Image = new Image(this.calloutRightArrowSkinTexture);
			callout.rightArrowSkin = rightArrowSkin;
			callout.rightArrowGap = this.calloutBottomRightArrowOverlapGapSize;
		}

		protected function setDangerCalloutStyles(callout:Callout):void
		{
			callout.padding = this.smallGutterSize;
			callout.paddingRight = this.gutterSize + this.dropShadowSize;
			callout.paddingBottom = this.gutterSize + this.dropShadowSize;

			var backgroundSkin:Image = new Image(this.dangerPopUpBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundSkin.width = this.calloutBackgroundMinSize;
			backgroundSkin.height = this.calloutBackgroundMinSize;
			callout.backgroundSkin = backgroundSkin;

			var topArrowSkin:Image = new Image(this.dangerCalloutTopArrowSkinTexture);
			callout.topArrowSkin = topArrowSkin;
			callout.topArrowGap = this.calloutTopLeftArrowOverlapGapSize;

			var bottomArrowSkin:Image = new Image(this.dangerCalloutBottomArrowSkinTexture);
			callout.bottomArrowSkin = bottomArrowSkin;
			callout.bottomArrowGap = this.calloutBottomRightArrowOverlapGapSize;

			var leftArrowSkin:Image = new Image(this.dangerCalloutLeftArrowSkinTexture);
			callout.leftArrowSkin = leftArrowSkin;
			callout.leftArrowGap = this.calloutTopLeftArrowOverlapGapSize;

			var rightArrowSkin:Image = new Image(this.dangerCalloutRightArrowSkinTexture);
			callout.rightArrowSkin = rightArrowSkin;
			callout.rightArrowGap = this.calloutBottomRightArrowOverlapGapSize;
		}

	//-------------------------
	// Check
	//-------------------------

		protected function setCheckStyles(check:Check):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			check.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.checkIconTexture);
			icon.selectedTexture = this.checkSelectedIconTexture;
			icon.setTextureForState(ButtonState.DISABLED, this.checkDisabledIconTexture);
			icon.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.checkSelectedDisabledIconTexture);
			check.defaultIcon = icon;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			check.focusIndicatorSkin = focusIndicatorSkin;
			check.focusPaddingLeft = this.focusPaddingSize;
			check.focusPaddingRight = this.focusPaddingSize;

			check.fontStyles = this.primaryFontStyles.clone();
			check.disabledFontStyles = this.disabledFontStyles.clone();

			check.gap = this.smallGutterSize;
			check.horizontalAlign = HorizontalAlign.LEFT;
			check.verticalAlign = VerticalAlign.MIDDLE;
			check.minTouchWidth = this.gridSize;
			check.minTouchHeight = this.gridSize;
		}

	//-------------------------
	// DataGrid
	//-------------------------

		protected function setDataGridStyles(grid:DataGrid):void
		{
			this.setScrollerStyles(grid);

			grid.backgroundSkin = new Quad(this.gridSize, this.gridSize, LIST_BACKGROUND_COLOR);

			var columnDragOverlaySkin:Quad = new Quad(1, 1, DATA_GRID_COLUMN_OVERLAY_COLOR);
			columnDragOverlaySkin.alpha = DATA_GRID_COLUMN_OVERLAY_ALPHA;
			grid.columnDragOverlaySkin = columnDragOverlaySkin;

			var columnResizeSkin:ImageSkin = new ImageSkin(this.dataGridColumnResizeSkinTexture);
			columnResizeSkin.scale9Grid = DATA_GRID_COLUMN_RESIZE_SKIN_SCALE_9_GRID;
			grid.columnResizeSkin = columnResizeSkin;

			var columnDropIndicatorSkin:ImageSkin = new ImageSkin(this.dataGridColumnDropIndicatorSkinTexture);
			columnDropIndicatorSkin.scale9Grid = DATA_GRID_COLUMN_DROP_INDICATOR_SCALE_9_GRID;
			grid.columnDropIndicatorSkin = columnDropIndicatorSkin;

			grid.headerDividerFactory = this.dataGridHeaderDividerFactory;
		}

		protected function setDataGridHeaderRendererStyles(headerRenderer:DefaultDataGridHeaderRenderer):void
		{
			var backgroundSkin:ImageSkin = new ImageSkin(this.dataGridHeaderRendererSkinTexture);
			backgroundSkin.scale9Grid = DATA_GRID_HEADER_RENDERER_SCALE_9_GRID;
			backgroundSkin.width = this.controlSize;
			backgroundSkin.height = this.controlSize;
			backgroundSkin.minWidth = this.controlSize;
			backgroundSkin.minHeight = this.controlSize;
			headerRenderer.backgroundSkin = backgroundSkin;

			headerRenderer.sortAscendingIcon = new ImageSkin(this.dataGridHeaderSortAscendingIconTexture);
			headerRenderer.sortDescendingIcon = new ImageSkin(this.dataGridHeaderSortDescendingIconTexture);

			headerRenderer.fontStyles = this.primaryFontStyles.clone();
			headerRenderer.disabledFontStyles = this.disabledFontStyles.clone();

			headerRenderer.paddingTop = this.smallGutterSize;
			headerRenderer.paddingBottom = this.smallGutterSize;
			headerRenderer.paddingLeft = this.gutterSize;
			headerRenderer.paddingRight = this.gutterSize;
			//headerRenderer.gap = this.gutterSize;
			//headerRenderer.minGap = this.gutterSize;
		}

		protected function setDataGridCellRendererStyles(cellRenderer:DefaultDataGridCellRenderer):void
		{
			var defaultSkin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			defaultSkin.setTextureForState(ButtonState.DOWN, this.dataGridCellRendererDownSkinTexture);
			defaultSkin.selectedTexture = this.dataGridCellRendererSelectedUpSkinTexture;
			defaultSkin.scale9Grid = ITEM_RENDERER_SCALE_9_GRID;
			defaultSkin.width = this.gridSize;
			defaultSkin.height = this.gridSize;
			defaultSkin.minWidth = this.gridSize;
			defaultSkin.minHeight = this.gridSize;
			cellRenderer.defaultSkin = defaultSkin;

			cellRenderer.fontStyles = this.primaryFontStyles.clone();
			cellRenderer.disabledFontStyles = this.disabledFontStyles.clone();
			cellRenderer.iconLabelFontStyles = this.primaryFontStyles.clone();
			cellRenderer.iconLabelDisabledFontStyles = this.disabledFontStyles.clone();
			cellRenderer.accessoryLabelFontStyles = this.primaryFontStyles.clone();
			cellRenderer.accessoryLabelDisabledFontStyles = this.disabledFontStyles.clone();

			cellRenderer.paddingTop = this.smallGutterSize;
			cellRenderer.paddingBottom = this.smallGutterSize;
			cellRenderer.paddingLeft = this.gutterSize;
			cellRenderer.paddingRight = this.gutterSize;
			cellRenderer.gap = this.gutterSize;
			cellRenderer.minGap = this.gutterSize;
			cellRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			cellRenderer.minAccessoryGap = this.gutterSize;
			cellRenderer.minTouchWidth = this.gridSize;
			cellRenderer.minTouchHeight = this.gridSize;
			cellRenderer.horizontalAlign = HorizontalAlign.LEFT;
			cellRenderer.iconPosition = RelativePosition.LEFT;
			cellRenderer.accessoryPosition = RelativePosition.RIGHT;
		}

	//-------------------------
	// DateTimeSpinner
	//-------------------------

		protected function setDateTimeSpinnerStyles(spinner:DateTimeSpinner):void
		{
			spinner.customItemRendererStyleName = THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER;
		}

		protected function setDateTimeSpinnerListItemRendererStyles(itemRenderer:DefaultListItemRenderer):void
		{
			this.setSpinnerListItemRendererStyles(itemRenderer);

			itemRenderer.accessoryPosition = RelativePosition.LEFT;
			itemRenderer.gap = this.gutterSize;
			itemRenderer.minGap = this.gutterSize;
			itemRenderer.accessoryGap = this.gutterSize;
			itemRenderer.minAccessoryGap = this.gutterSize;
		}

	//-------------------------
	// Drawers
	//-------------------------

		protected function setDrawersStyles(drawers:Drawers):void
		{
			var overlaySkin:Quad = new Quad(10, 10, MODAL_OVERLAY_COLOR);
			overlaySkin.alpha = MODAL_OVERLAY_ALPHA;
			drawers.overlaySkin = overlaySkin;

			var topDrawerDivider:Quad = new Quad(this.borderSize, this.borderSize, DRAWERS_DIVIDER_COLOR);
			drawers.topDrawerDivider = topDrawerDivider;

			var rightDrawerDivider:Quad = new Quad(this.borderSize, this.borderSize, DRAWERS_DIVIDER_COLOR);
			drawers.rightDrawerDivider = rightDrawerDivider;

			var bottomDrawerDivider:Quad = new Quad(this.borderSize, this.borderSize, DRAWERS_DIVIDER_COLOR);
			drawers.bottomDrawerDivider = bottomDrawerDivider;

			var leftDrawerDivider:Quad = new Quad(this.borderSize, this.borderSize, DRAWERS_DIVIDER_COLOR);
			drawers.leftDrawerDivider = leftDrawerDivider;
		}

	//-------------------------
	// GroupedList
	//-------------------------

		protected function setGroupedListStyles(list:GroupedList):void
		{
			this.setScrollerStyles(list);

			var backgroundSkin:Quad = new Quad(this.gridSize, this.gridSize, LIST_BACKGROUND_COLOR);
			list.backgroundSkin = backgroundSkin;
		}

		//see List section for item renderer styles

		protected function setGroupedListHeaderOrFooterRendererStyles(renderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			renderer.backgroundSkin = new Quad(1, 1, LIST_HEADER_BACKGROUND_COLOR);

			renderer.fontStyles = this.primaryFontStyles.clone();
			renderer.disabledFontStyles = this.disabledFontStyles.clone();

			renderer.paddingTop = this.smallGutterSize;
			renderer.paddingBottom = this.smallGutterSize;
			renderer.paddingLeft = this.gutterSize;
			renderer.paddingRight = this.gutterSize;
		}

		protected function setInsetGroupedListStyles(list:GroupedList):void
		{
			this.setScrollerStyles(list);

			list.customHeaderRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_HEADER_RENDERER;
			list.customFooterRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_FOOTER_RENDERER;

			var layout:VerticalLayout = new VerticalLayout();
			layout.useVirtualLayout = true;
			layout.padding = this.gutterSize;
			layout.paddingTop = 0;
			layout.gap = 0;
			layout.horizontalAlign = HorizontalAlign.JUSTIFY;
			layout.verticalAlign = VerticalAlign.TOP;
			list.layout = layout;
		}

		protected function setInsetGroupedListHeaderOrFooterRendererStyles(renderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			renderer.backgroundSkin = skin;

			renderer.fontStyles = this.primaryFontStyles.clone();
			renderer.disabledFontStyles = this.disabledFontStyles.clone();

			renderer.paddingTop = this.smallGutterSize;
			renderer.paddingBottom = this.smallGutterSize;
			renderer.paddingLeft = this.gutterSize;
			renderer.paddingRight = this.gutterSize;
		}

	//-------------------------
	// Header
	//-------------------------

		protected function setHeaderStyles(header:Header):void
		{
			var backgroundSkin:ImageSkin = new ImageSkin(this.headerSkinTexture);
			backgroundSkin.scale9Grid = HEADER_SCALE_9_GRID;
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			header.backgroundSkin = backgroundSkin;

			header.fontStyles = this.primaryFontStyles.clone();
			header.disabledFontStyles = this.disabledFontStyles.clone();

			header.padding = this.smallGutterSize;
			header.gap = this.smallGutterSize;
			header.titleGap = this.smallGutterSize;
		}

	//-------------------------
	// Label
	//-------------------------

		protected function setLabelStyles(label:Label):void
		{
			label.fontStyles = this.primaryFontStyles.clone();
			label.disabledFontStyles = this.disabledFontStyles.clone();
		}

		protected function setHeadingLabelStyles(label:Label):void
		{
			label.fontStyles = this.headingFontStyles.clone();
			label.disabledFontStyles = this.headingDisabledFontStyles.clone();
		}

		protected function setDetailLabelStyles(label:Label):void
		{
			label.fontStyles = this.detailFontStyles.clone();
			label.disabledFontStyles = this.detailDisabledFontStyles.clone();
		}

	//-------------------------
	// LayoutGroup
	//-------------------------

		protected function setToolbarLayoutGroupStyles(group:LayoutGroup):void
		{
			if(!group.layout)
			{
				var layout:HorizontalLayout = new HorizontalLayout();
				layout.padding = this.smallGutterSize;
				layout.gap = this.smallGutterSize;
				layout.verticalAlign = VerticalAlign.MIDDLE;
				group.layout = layout;
			}

			var backgroundSkin:ImageSkin = new ImageSkin(this.headerSkinTexture);
			backgroundSkin.scale9Grid = HEADER_SCALE_9_GRID;
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			group.backgroundSkin = backgroundSkin;
		}

	//-------------------------
	// List
	//-------------------------

		protected function setListStyles(list:List):void
		{
			this.setScrollerStyles(list);

			list.backgroundSkin = new Quad(this.gridSize, this.gridSize, LIST_BACKGROUND_COLOR);

			var dropIndicatorSkin:Quad = new Quad(this.borderSize, this.borderSize, PRIMARY_TEXT_COLOR);
			list.dropIndicatorSkin = dropIndicatorSkin;
		}

		protected function setListItemRendererStyles(itemRenderer:DefaultListItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			var dragIcon:ImageSkin = new ImageSkin(this.dragHandleIcon);
			dragIcon.minTouchWidth = this.gridSize;
			dragIcon.minTouchHeight = this.gridSize;
			itemRenderer.dragIcon = dragIcon;
		}

		protected function setItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var defaultSkin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			defaultSkin.scale9Grid = ITEM_RENDERER_SCALE_9_GRID;
			defaultSkin.width = this.gridSize;
			defaultSkin.height = this.gridSize;
			defaultSkin.minWidth = this.gridSize;
			defaultSkin.minHeight = this.gridSize;
			itemRenderer.defaultSkin = defaultSkin;

			//different scale9Grid, so needs a separate skin
			var otherSkin:ImageSkin = new ImageSkin(this.itemRendererDownSkinTexture);
			otherSkin.selectedTexture = this.itemRendererSelectedUpSkinTexture;
			otherSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			otherSkin.width = this.gridSize;
			otherSkin.height = this.gridSize;
			otherSkin.minWidth = this.gridSize;
			otherSkin.minHeight = this.gridSize;
			itemRenderer.defaultSelectedSkin = otherSkin;
			itemRenderer.setSkinForState(ButtonState.DOWN, otherSkin);

			itemRenderer.fontStyles = this.primaryFontStyles.clone();
			itemRenderer.disabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.iconLabelFontStyles = this.primaryFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.accessoryLabelFontStyles = this.primaryFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.disabledFontStyles.clone();

			itemRenderer.paddingTop = this.smallGutterSize;
			itemRenderer.paddingBottom = this.smallGutterSize;
			itemRenderer.paddingLeft = this.gutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.gap = this.gutterSize;
			itemRenderer.minGap = this.gutterSize;
			itemRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			itemRenderer.minAccessoryGap = this.gutterSize;
			itemRenderer.minTouchWidth = this.gridSize;
			itemRenderer.minTouchHeight = this.gridSize;
			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;
			itemRenderer.iconPosition = RelativePosition.LEFT;
			itemRenderer.accessoryPosition = RelativePosition.RIGHT;
		}

		protected function setDrillDownItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			itemRenderer.itemHasAccessory = false;
			var defaultAccessory:ImageLoader = new ImageLoader();
			defaultAccessory.source = this.listDrillDownAccessoryTexture;
			itemRenderer.defaultAccessory = defaultAccessory;
		}

		protected function setCheckItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var defaultSkin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			defaultSkin.scale9Grid = ITEM_RENDERER_SCALE_9_GRID;
			defaultSkin.width = this.gridSize;
			defaultSkin.height = this.gridSize;
			defaultSkin.minWidth = this.gridSize;
			defaultSkin.minHeight = this.gridSize;
			itemRenderer.defaultSkin = defaultSkin;

			//different scale9Grid, so needs a separate skin
			var otherSkin:ImageSkin = new ImageSkin(this.itemRendererDownSkinTexture);
			otherSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			otherSkin.width = this.gridSize;
			otherSkin.height = this.gridSize;
			otherSkin.minWidth = this.gridSize;
			otherSkin.minHeight = this.gridSize;
			itemRenderer.setSkinForState(ButtonState.DOWN, otherSkin);

			var defaultSelectedIcon:ImageLoader = new ImageLoader();
			defaultSelectedIcon.source = this.checkItemRendererSelectedIconTexture;
			itemRenderer.defaultSelectedIcon = defaultSelectedIcon;

			var frame:Rectangle = this.checkItemRendererSelectedIconTexture.frame;
			if(frame)
			{
				var iconWidth:Number = frame.width;
				var iconHeight:Number = frame.height;
			}
			else
			{
				iconWidth = this.checkItemRendererSelectedIconTexture.width;
				iconHeight = this.checkItemRendererSelectedIconTexture.height;
			}
			var defaultIcon:Quad = new Quad(iconWidth, iconHeight, 0xff00ff);
			defaultIcon.alpha = 0;
			itemRenderer.defaultIcon = defaultIcon;

			itemRenderer.fontStyles = this.primaryFontStyles.clone();
			itemRenderer.disabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.iconLabelFontStyles = this.primaryFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.accessoryLabelFontStyles = this.primaryFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.disabledFontStyles.clone();

			itemRenderer.itemHasIcon = false;

			itemRenderer.paddingTop = this.smallGutterSize;
			itemRenderer.paddingBottom = this.smallGutterSize;
			itemRenderer.paddingLeft = this.gutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.gap = Number.POSITIVE_INFINITY;
			itemRenderer.minGap = this.gutterSize;
			itemRenderer.iconPosition = RelativePosition.RIGHT;
			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;
			itemRenderer.accessoryGap = this.smallGutterSize;
			itemRenderer.minAccessoryGap = this.smallGutterSize;
			itemRenderer.accessoryPosition = RelativePosition.BOTTOM;
			itemRenderer.layoutOrder = ItemRendererLayoutOrder.LABEL_ACCESSORY_ICON;
			itemRenderer.minTouchWidth = this.gridSize;
			itemRenderer.minTouchHeight = this.gridSize;
		}

	//-------------------------
	// NumericStepper
	//-------------------------

		protected function setNumericStepperStyles(stepper:NumericStepper):void
		{
			stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_HORIZONTAL;
			stepper.incrementButtonLabel = "+";
			stepper.decrementButtonLabel = "-";

			stepper.useLeftAndRightKeys = true;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			stepper.focusIndicatorSkin = focusIndicatorSkin;
			stepper.focusPadding = this.focusPaddingSize;
		}

		protected function setNumericStepperTextInputStyles(input:TextInput):void
		{
			input.minTouchWidth = this.gridSize;
			input.minTouchHeight = this.gridSize;
			input.gap = this.smallGutterSize;
			input.padding = this.smallGutterSize;
			input.isEditable = false;
			input.isSelectable = false;
			input.textEditorFactory = numericStepperTextEditorFactory;

			input.fontStyles = this.centeredFontStyles.clone();
			input.disabledFontStyles = this.centeredDisabledFontStyles.clone();

			var skin:ImageSkin = new ImageSkin(this.insetBackgroundSkinTexture);
			skin.setTextureForState(TextInputState.DISABLED, this.insetBackgroundDisabledSkinTexture);
			skin.setTextureForState(TextInputState.FOCUSED, this.insetBackgroundFocusedSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.gridSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			input.backgroundSkin = skin;
		}

		protected function setNumericStepperButtonStyles(button:Button):void
		{
			this.setButtonStyles(button);
			button.keepDownStateOnRollOut = true;
		}

	//-------------------------
	// PageIndicator
	//-------------------------

		protected function setPageIndicatorStyles(pageIndicator:PageIndicator):void
		{
			pageIndicator.normalSymbolFactory = this.pageIndicatorNormalSymbolFactory;
			pageIndicator.selectedSymbolFactory = this.pageIndicatorSelectedSymbolFactory;
			pageIndicator.gap = this.smallGutterSize;
			pageIndicator.padding = this.smallGutterSize;
			pageIndicator.minTouchWidth = this.smallControlSize * 2;
			pageIndicator.minTouchHeight = this.smallControlSize * 2;
		}

	//-------------------------
	// Panel
	//-------------------------

		protected function setPanelStyles(panel:Panel):void
		{
			this.setScrollerStyles(panel);

			var backgroundSkin:Image = new Image(this.panelBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			backgroundSkin.width = this.smallControlSize;
			backgroundSkin.height = this.smallControlSize;
			panel.backgroundSkin = backgroundSkin;

			panel.outerPadding = this.borderSize;
			panel.padding = this.smallGutterSize;
		}

		protected function setPanelHeaderStyles(header:Header):void
		{
			var backgroundSkin:ImageSkin = new ImageSkin(this.panelHeaderSkinTexture);
			backgroundSkin.scale9Grid = HEADER_SCALE_9_GRID;
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			header.backgroundSkin = backgroundSkin;

			header.fontStyles = this.primaryFontStyles.clone();
			header.disabledFontStyles = this.disabledFontStyles.clone();

			header.padding = this.smallGutterSize;
			header.gap = this.smallGutterSize;
			header.titleGap = this.smallGutterSize;
		}

	//-------------------------
	// PanelScreen
	//-------------------------

		protected function setPanelScreenStyles(screen:PanelScreen):void
		{
			this.setScrollerStyles(screen);
		}

		protected function setPanelScreenHeaderStyles(header:Header):void
		{
			this.setHeaderStyles(header);
			header.useExtraPaddingForOSStatusBar = true;
		}

	//-------------------------
	// PickerList
	//-------------------------

		protected function setPickerListStyles(list:PickerList):void
		{
			list.toggleButtonOnOpenAndClose = true;
			list.buttonFactory = pickerListButtonFactory;
			if(DeviceCapabilities.isPhone(this.starling.nativeStage))
			{
				list.listFactory = pickerListSpinnerListFactory;
				list.popUpContentManager = new BottomDrawerPopUpContentManager();
			}
			else //tablet or desktop
			{
				list.popUpContentManager = new CalloutPopUpContentManager();
				list.customItemRendererStyleName = THEME_STYLE_NAME_TABLET_PICKER_LIST_ITEM_RENDERER;
			}
		}

		protected function setPickerListPopUpListStyles(list:List):void
		{
			this.setDropDownListStyles(list);
		}

		protected function setTabletPickerListItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var defaultSkin:ImageSkin = new ImageSkin(this.itemRendererUpSkinTexture);
			defaultSkin.scale9Grid = ITEM_RENDERER_SCALE_9_GRID;
			defaultSkin.width = this.popUpFillSize;
			defaultSkin.height = this.gridSize;
			defaultSkin.minWidth = this.popUpFillSize;
			defaultSkin.minHeight = this.gridSize;
			itemRenderer.defaultSkin = defaultSkin;

			//different scale9Grid, so needs a separate skin
			var otherSkin:ImageSkin = new ImageSkin(this.itemRendererDownSkinTexture);
			otherSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			otherSkin.width = this.popUpFillSize;
			otherSkin.height = this.gridSize;
			otherSkin.minWidth = this.popUpFillSize;
			otherSkin.minHeight = this.gridSize;
			itemRenderer.setSkinForState(ButtonState.DOWN, otherSkin);

			var defaultSelectedIcon:ImageLoader = new ImageLoader();
			defaultSelectedIcon.source = this.checkItemRendererSelectedIconTexture;
			itemRenderer.defaultSelectedIcon = defaultSelectedIcon;

			var frame:Rectangle = this.checkItemRendererSelectedIconTexture.frame;
			if(frame)
			{
				var iconWidth:Number = frame.width;
				var iconHeight:Number = frame.height;
			}
			else
			{
				iconWidth = this.checkItemRendererSelectedIconTexture.width;
				iconHeight = this.checkItemRendererSelectedIconTexture.height;
			}
			var defaultIcon:Quad = new Quad(iconWidth, iconHeight, 0xff00ff);
			defaultIcon.alpha = 0;
			itemRenderer.defaultIcon = defaultIcon;

			itemRenderer.fontStyles = this.primaryFontStyles.clone();
			itemRenderer.disabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.iconLabelFontStyles = this.primaryFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.accessoryLabelFontStyles = this.primaryFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.disabledFontStyles.clone();

			itemRenderer.itemHasIcon = false;

			itemRenderer.paddingTop = this.smallGutterSize;
			itemRenderer.paddingBottom = this.smallGutterSize;
			itemRenderer.paddingLeft = this.gutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.gap = Number.POSITIVE_INFINITY;
			itemRenderer.minGap = this.gutterSize;
			itemRenderer.iconPosition = RelativePosition.RIGHT;
			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;
			itemRenderer.accessoryGap = this.smallGutterSize;
			itemRenderer.minAccessoryGap = this.smallGutterSize;
			itemRenderer.accessoryPosition = RelativePosition.BOTTOM;
			itemRenderer.layoutOrder = ItemRendererLayoutOrder.LABEL_ACCESSORY_ICON;
			itemRenderer.minTouchWidth = this.gridSize;
			itemRenderer.minTouchHeight = this.gridSize;
		}

		protected function setPickerListButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpSkinTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			button.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.pickerListButtonIconUpTexture);
			icon.disabledTexture = this.pickerListButtonIconDisabledTexture;
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				icon.selectedTexture = this.pickerListButtonIconSelectedTexture;
			}
			button.defaultIcon = icon;

			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.disabledFontStyles.clone();

			this.setBaseButtonStyles(button);

			button.gap = Number.POSITIVE_INFINITY; //fill as completely as possible
			button.minGap = this.gutterSize;
			button.iconPosition = RelativePosition.RIGHT;
			button.horizontalAlign = HorizontalAlign.LEFT;
		}

	//-------------------------
	// ProgressBar
	//-------------------------

		protected function setProgressBarStyles(progress:ProgressBar):void
		{
			var backgroundSkin:Image = new Image(this.insetBackgroundSkinTexture);
			backgroundSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			if(progress.direction == Direction.VERTICAL)
			{
				backgroundSkin.width = this.smallControlSize;
				backgroundSkin.height = this.wideControlSize;
			}
			else
			{
				backgroundSkin.width = this.wideControlSize;
				backgroundSkin.height = this.smallControlSize;
			}
			progress.backgroundSkin = backgroundSkin;

			var backgroundDisabledSkin:Image = new Image(this.insetBackgroundDisabledSkinTexture);
			backgroundDisabledSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			if(progress.direction == Direction.VERTICAL)
			{
				backgroundDisabledSkin.width = this.smallControlSize;
				backgroundDisabledSkin.height = this.wideControlSize;
			}
			else
			{
				backgroundDisabledSkin.width = this.wideControlSize;
				backgroundDisabledSkin.height = this.smallControlSize;
			}
			progress.backgroundDisabledSkin = backgroundDisabledSkin;

			var fillSkin:Image = new Image(this.buttonUpSkinTexture);
			fillSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			if(progress.direction == Direction.VERTICAL)
			{
				fillSkin.width = this.smallGutterSize;
				fillSkin.height = this.borderSize;
			}
			else
			{
				fillSkin.width = this.borderSize;
				fillSkin.height = this.smallGutterSize;
			}
			progress.fillSkin = fillSkin;

			var fillDisabledSkin:Image = new Image(this.buttonDisabledSkinTexture);
			fillDisabledSkin.scale9Grid = DEFAULT_SCALE_9_GRID;
			if(progress.direction == Direction.VERTICAL)
			{
				fillDisabledSkin.width = this.smallGutterSize;
				fillDisabledSkin.height = this.borderSize;
			}
			else
			{
				fillDisabledSkin.width = this.borderSize;
				fillDisabledSkin.height = this.smallGutterSize;
			}
			progress.fillDisabledSkin = fillDisabledSkin;
		}

	//-------------------------
	// Radio
	//-------------------------

		protected function setRadioStyles(radio:Radio):void
		{
			var skin:Quad = new Quad(this.controlSize, this.controlSize);
			skin.alpha = 0;
			radio.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.radioIconTexture);
			icon.selectedTexture = this.radioSelectedIconTexture;
			icon.setTextureForState(ButtonState.DISABLED, this.radioDisabledIconTexture);
			icon.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.radioSelectedDisabledIconTexture);
			radio.defaultIcon = icon;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			radio.focusIndicatorSkin = focusIndicatorSkin;
			radio.focusPadding = this.focusPaddingSize;

			radio.fontStyles = this.primaryFontStyles.clone();
			radio.disabledFontStyles = this.disabledFontStyles.clone();

			radio.gap = this.smallGutterSize;
			radio.horizontalAlign = HorizontalAlign.LEFT;
			radio.verticalAlign = VerticalAlign.MIDDLE;
			radio.minTouchWidth = this.gridSize;
			radio.minTouchHeight = this.gridSize;
		}

	//-------------------------
	// ScrollContainer
	//-------------------------

		protected function setScrollContainerStyles(container:ScrollContainer):void
		{
			this.setScrollerStyles(container);
		}

		protected function setToolbarScrollContainerStyles(container:ScrollContainer):void
		{
			this.setScrollerStyles(container);

			if(!container.layout)
			{
				var layout:HorizontalLayout = new HorizontalLayout();
				layout.padding = this.smallGutterSize;
				layout.gap = this.smallGutterSize;
				container.layout = layout;
			}

			var backgroundSkin:ImageSkin = new ImageSkin(this.headerSkinTexture);
			backgroundSkin.scale9Grid = HEADER_SCALE_9_GRID;
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			backgroundSkin.minWidth = this.gridSize;
			backgroundSkin.minHeight = this.gridSize;
			container.backgroundSkin = backgroundSkin;
		}

	//-------------------------
	// ScrollScreen
	//-------------------------

		protected function setScrollScreenStyles(screen:ScrollScreen):void
		{
			this.setScrollerStyles(screen);
		}

	//-------------------------
	// ScrollText
	//-------------------------

		protected function setScrollTextStyles(text:ScrollText):void
		{
			this.setScrollerStyles(text);

			text.fontStyles = this.scrollTextFontStyles.clone();
			text.disabledFontStyles = this.scrollTextDisabledFontStyles.clone();

			text.padding = this.gutterSize;
			text.paddingRight = this.gutterSize + this.smallGutterSize;
		}

	//-------------------------
	// SimpleScrollBar
	//-------------------------

		protected function setSimpleScrollBarThumbStyles(thumb:Button):void
		{
			var defaultSkin:Image = new Image(this.scrollBarThumbSkinTexture);
			defaultSkin.scale9Grid = SCROLLBAR_THUMB_SCALE_9_GRID;
			defaultSkin.width = this.simpleScrollBarThumbSize;
			defaultSkin.height = this.simpleScrollBarThumbSize;
			thumb.defaultSkin = defaultSkin;

			thumb.minTouchWidth = this.smallControlSize;
			thumb.minTouchHeight = this.smallControlSize;

			thumb.hasLabelTextRenderer = false;
		}

	//-------------------------
	// Slider
	//-------------------------

		protected function setSliderStyles(slider:Slider):void
		{
			slider.trackLayoutMode = TrackLayoutMode.SINGLE;

			if(slider.direction == Direction.VERTICAL)
			{
				slider.customMinimumTrackStyleName = THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK;
			}
			else //horizontal
			{
				slider.customMinimumTrackStyleName = THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK;
			}

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			slider.focusIndicatorSkin = focusIndicatorSkin;
			slider.focusPadding = this.focusPaddingSize;
		}

		protected function setHorizontalSliderMinimumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.insetBackgroundSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.insetBackgroundDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.smallControlSize;
			skin.minHeight = this.smallControlSize;
			track.defaultSkin = skin;

			track.minTouchHeight = this.gridSize;

			track.hasLabelTextRenderer = false;
		}

		protected function setVerticalSliderMinimumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.insetBackgroundSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.insetBackgroundDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.wideControlSize;
			skin.minWidth = this.smallControlSize;
			track.defaultSkin = skin;

			track.minTouchWidth = this.gridSize;

			track.hasLabelTextRenderer = false;
		}

		protected function setSliderThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.thumbSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.thumbDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.smallControlSize;
			thumb.defaultSkin = skin;

			thumb.minTouchWidth = this.gridSize;
			thumb.minTouchHeight = this.gridSize;

			thumb.hasLabelTextRenderer = false;
		}

	//-------------------------
	// SpinnerList
	//-------------------------

		protected function setSpinnerListStyles(list:SpinnerList):void
		{
			this.setListStyles(list);
			list.customItemRendererStyleName = THEME_STYLE_NAME_SPINNER_LIST_ITEM_RENDERER;

			var selectionOverlaySkin:Image = new Image(this.spinnerListSelectionOverlaySkinTexture);
			selectionOverlaySkin.scale9Grid = SPINNER_LIST_SELECTION_OVERLAY_SCALE9_GRID;
			list.selectionOverlaySkin = selectionOverlaySkin;
		}

		protected function setSpinnerListItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var skin:Quad = new Quad(this.gridSize, this.gridSize);
			skin.alpha = 0;
			itemRenderer.defaultSkin = skin;

			//if it's not selected, we don't want it to be highlighted, so we're
			//borrowing the less prominent disabled color
			itemRenderer.fontStyles = this.disabledFontStyles.clone();
			itemRenderer.selectedFontStyles = this.primaryFontStyles.clone();
			itemRenderer.disabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.iconLabelFontStyles = this.disabledFontStyles.clone();
			itemRenderer.iconLabelSelectedFontStyles = this.primaryFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.disabledFontStyles.clone();
			itemRenderer.accessoryLabelFontStyles = this.disabledFontStyles.clone();
			itemRenderer.accessoryLabelSelectedFontStyles = this.primaryFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.disabledFontStyles.clone();

			itemRenderer.paddingTop = this.smallGutterSize;
			itemRenderer.paddingBottom = this.smallGutterSize;
			itemRenderer.paddingLeft = this.gutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.gap = Number.POSITIVE_INFINITY;
			itemRenderer.minGap = this.gutterSize;
			itemRenderer.iconPosition = RelativePosition.RIGHT;
			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;
			itemRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			itemRenderer.minAccessoryGap = this.gutterSize;
			itemRenderer.accessoryPosition = RelativePosition.RIGHT;
			itemRenderer.minTouchWidth = this.gridSize;
			itemRenderer.minTouchHeight = this.gridSize;
			itemRenderer.isQuickHitAreaEnabled = true;
		}

	//-------------------------
	// TabBar
	//-------------------------

		protected function setTabBarStyles(tabBar:TabBar):void
		{
			tabBar.distributeTabSizes = true;
		}

		protected function setTabStyles(tab:ToggleButton):void
		{
			var defaultSkin:ImageSkin = new ImageSkin(this.headerSkinTexture);
			defaultSkin.scale9Grid = HEADER_SCALE_9_GRID;
			defaultSkin.width = this.gridSize;
			defaultSkin.height = this.gridSize;
			defaultSkin.minWidth = this.gridSize;
			defaultSkin.minHeight = this.gridSize;
			tab.defaultSkin = defaultSkin;

			var otherSkin:ImageSkin = new ImageSkin(this.tabSelectedSkinTexture);
			otherSkin.setTextureForState(ButtonState.DOWN, this.tabDownSkinTexture);
			otherSkin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.tabSelectedDisabledSkinTexture);
			otherSkin.scale9Grid = TAB_SCALE_9_GRID;
			otherSkin.width = this.gridSize;
			otherSkin.height = this.gridSize;
			otherSkin.minWidth = this.gridSize;
			otherSkin.minHeight = this.gridSize;
			tab.defaultSelectedSkin = otherSkin;
			tab.setSkinForState(ButtonState.DOWN, otherSkin);

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			tab.focusIndicatorSkin = focusIndicatorSkin;
			tab.focusPadding = this.tabFocusPaddingSize;

			tab.fontStyles = this.primaryFontStyles.clone();
			tab.disabledFontStyles = this.disabledFontStyles.clone();

			tab.iconPosition = RelativePosition.TOP;
			tab.padding = this.gutterSize;
			tab.gap = this.smallGutterSize;
			tab.minGap = this.smallGutterSize;
			tab.minTouchWidth = this.gridSize;
			tab.minTouchHeight = this.gridSize;
		}

	//-------------------------
	// TextArea
	//-------------------------

		protected function setTextAreaStyles(textArea:TextArea):void
		{
			this.setScrollerStyles(textArea);

			var skin:ImageSkin = new ImageSkin(this.insetBackgroundSkinTexture);
			skin.setTextureForState(TextInputState.DISABLED, this.insetBackgroundDisabledSkinTexture);
			skin.setTextureForState(TextInputState.FOCUSED, this.insetBackgroundFocusedSkinTexture);
			skin.setTextureForState(TextInputState.ERROR, this.insetBackgroundDangerSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.wideControlSize;
			textArea.backgroundSkin = skin;

			textArea.fontStyles = this.scrollTextFontStyles.clone();
			textArea.disabledFontStyles = this.scrollTextDisabledFontStyles.clone();

			textArea.promptFontStyles = this.primaryFontStyles.clone();
			textArea.promptDisabledFontStyles = this.disabledFontStyles.clone();

			textArea.textEditorFactory = textAreaTextEditorFactory;
			
			textArea.innerPadding = this.smallGutterSize;
		}

		protected function setTextAreaErrorCalloutStyles(callout:TextCallout):void
		{
			this.setDangerTextCalloutStyles(callout);
			callout.horizontalAlign = HorizontalAlign.LEFT;
			callout.verticalAlign = VerticalAlign.TOP;
		}

	//-------------------------
	// TextCallout
	//-------------------------

		protected function setTextCalloutStyles(callout:TextCallout):void
		{
			this.setCalloutStyles(callout);

			callout.fontStyles = this.primaryFontStyles.clone();
			callout.disabledFontStyles = this.disabledFontStyles.clone();
		}

		protected function setDangerTextCalloutStyles(callout:TextCallout):void
		{
			this.setDangerCalloutStyles(callout);

			callout.fontStyles = this.dangerFontStyles.clone();
			callout.disabledFontStyles = this.disabledFontStyles.clone();
		}

	//-------------------------
	// TextInput
	//-------------------------

		protected function setBaseTextInputStyles(input:TextInput):void
		{
			var skin:ImageSkin = new ImageSkin(this.insetBackgroundSkinTexture);
			skin.setTextureForState(TextInputState.DISABLED, this.insetBackgroundDisabledSkinTexture);
			skin.setTextureForState(TextInputState.FOCUSED, this.insetBackgroundFocusedSkinTexture);
			skin.setTextureForState(TextInputState.ERROR, this.insetBackgroundDangerSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.wideControlSize;
			skin.minHeight = this.controlSize;
			input.backgroundSkin = skin;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			input.focusIndicatorSkin = focusIndicatorSkin;
			input.focusPadding = this.focusPaddingSize;

			input.minTouchWidth = this.gridSize;
			input.minTouchHeight = this.gridSize;
			input.gap = this.smallGutterSize;
			input.padding = this.smallGutterSize;
		}

		protected function setTextInputStyles(input:TextInput):void
		{
			this.setBaseTextInputStyles(input);

			input.fontStyles = this.scrollTextFontStyles.clone();
			input.disabledFontStyles = this.scrollTextDisabledFontStyles.clone();

			input.promptFontStyles = this.primaryFontStyles.clone();
			input.promptDisabledFontStyles = this.disabledFontStyles.clone();
		}

		protected function setSearchTextInputStyles(input:TextInput):void
		{
			this.setBaseTextInputStyles(input);

			input.fontStyles = this.scrollTextFontStyles.clone();
			input.disabledFontStyles = this.scrollTextDisabledFontStyles.clone();

			input.promptFontStyles = this.primaryFontStyles.clone();
			input.promptDisabledFontStyles = this.disabledFontStyles.clone();

			var icon:ImageSkin = new ImageSkin(this.searchIconTexture);
			icon.disabledTexture = this.searchIconDisabledTexture;
			input.defaultIcon = icon;
		}

		protected function setTextInputErrorCalloutStyles(callout:TextCallout):void
		{
			this.setDangerTextCalloutStyles(callout);

			callout.horizontalAlign = HorizontalAlign.LEFT;
			callout.verticalAlign = VerticalAlign.TOP;
		}

	//-------------------------
	// Toast
	//-------------------------

		protected function setToastStyles(toast:Toast):void
		{
			var backgroundSkin:Quad = new Quad(1, 1, MODAL_OVERLAY_COLOR);
			toast.backgroundSkin = backgroundSkin;

			toast.fontStyles = this.primaryFontStyles.clone();
			toast.disabledFontStyles = this.disabledFontStyles.clone();

			toast.width = this.extraWideControlSize;
			toast.paddingTop = this.smallGutterSize;
			toast.paddingRight = this.gutterSize;
			toast.paddingBottom = this.smallGutterSize;
			toast.paddingLeft = this.gutterSize;
			toast.gap = Number.POSITIVE_INFINITY;
			toast.minGap = this.smallGutterSize;
			toast.horizontalAlign = HorizontalAlign.LEFT;
			toast.verticalAlign = VerticalAlign.MIDDLE;
		}

		protected function setToastActionsStyles(group:ButtonGroup):void
		{
			group.direction = Direction.HORIZONTAL;
			group.gap = this.smallGutterSize;
			group.customButtonStyleName = THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON;
		}

		protected function setToastActionsButtonStyles(button:Button):void
		{
			button.fontStyles = this.primaryFontStyles.clone();
			button.disabledFontStyles = this.primaryFontStyles.clone();
		}

	//-------------------------
	// ToggleSwitch
	//-------------------------

		protected function setToggleSwitchStyles(toggleSwitch:ToggleSwitch):void
		{
			toggleSwitch.trackLayoutMode = TrackLayoutMode.SINGLE;

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			toggleSwitch.focusIndicatorSkin = focusIndicatorSkin;
			toggleSwitch.focusPadding = this.focusPaddingSize;

			toggleSwitch.onLabelFontStyles = this.primaryFontStyles.clone();
			toggleSwitch.onLabelDisabledFontStyles = this.disabledFontStyles.clone();
			toggleSwitch.offLabelFontStyles = this.primaryFontStyles.clone();
			toggleSwitch.offLabelDisabledFontStyles = this.disabledFontStyles.clone();
		}

		protected function setToggleSwitchOnTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.insetBackgroundSkinTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.insetBackgroundDisabledSkinTexture);
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = Math.round(this.controlSize * 2.5);
			skin.height = this.controlSize;
			track.defaultSkin = skin;
			track.minTouchWidth = this.gridSize;
			track.minTouchHeight = this.gridSize;

			track.hasLabelTextRenderer = false;
		}

		protected function setToggleSwitchThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.thumbSkinTexture);
			skin.disabledTexture = this.thumbDisabledSkinTexture;
			skin.scale9Grid = DEFAULT_SCALE_9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			thumb.defaultSkin = skin;
			
			thumb.minTouchWidth = this.gridSize;
			thumb.minTouchHeight = this.gridSize;

			thumb.hasLabelTextRenderer = false;
		}

	//-------------------------
	// Tree
	//-------------------------

		protected function setTreeStyles(tree:Tree):void
		{
			this.setScrollerStyles(tree);

			tree.backgroundSkin = new Quad(this.gridSize, this.gridSize, LIST_BACKGROUND_COLOR);
		}

		protected function setTreeItemRendererStyles(itemRenderer:DefaultTreeItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			itemRenderer.indentation = this.treeDisclosureOpenIconTexture.width;

			var disclosureOpenIcon:ImageSkin = new ImageSkin(this.treeDisclosureOpenIconTexture);
			disclosureOpenIcon.textureSmoothing = TextureSmoothing.NONE;
			disclosureOpenIcon.pixelSnapping = true;
			//make sure the hit area is large enough for touch screens
			disclosureOpenIcon.minTouchWidth = this.gridSize;
			disclosureOpenIcon.minTouchHeight = this.gridSize;
			itemRenderer.disclosureOpenIcon = disclosureOpenIcon;

			var disclosureClosedIcon:ImageSkin = new ImageSkin(this.treeDisclosureClosedIconTexture);
			disclosureClosedIcon.textureSmoothing = TextureSmoothing.NONE;
			disclosureClosedIcon.pixelSnapping = true;
			disclosureClosedIcon.minTouchWidth = this.gridSize;
			disclosureClosedIcon.minTouchHeight = this.gridSize;
			itemRenderer.disclosureClosedIcon = disclosureClosedIcon;
		}

	//-------------------------
	// VideoPlayer
	//-------------------------

		protected function setVideoPlayerStyles(player:VideoPlayer):void
		{
			player.backgroundSkin = new Quad(1, 1, 0x000000);
		}

	//-------------------------
	// PlayPauseToggleButton
	//-------------------------

		protected function setPlayPauseToggleButtonStyles(button:PlayPauseToggleButton):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			button.defaultSkin = defaultSkin;

			var otherSkin:ImageSkin = new ImageSkin(null);
			otherSkin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			otherSkin.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.buttonDownSkinTexture);
			otherSkin.width = this.controlSize;
			otherSkin.height = this.controlSize;
			otherSkin.minWidth = this.controlSize;
			otherSkin.minHeight = this.controlSize;
			button.setSkinForState(ButtonState.DOWN, otherSkin);
			button.setSkinForState(ButtonState.DOWN_AND_SELECTED, otherSkin);

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;

			var icon:ImageSkin = new ImageSkin(this.playPauseButtonPlayUpIconTexture);
			icon.selectedTexture = this.playPauseButtonPauseUpIconTexture;
			icon.textureSmoothing = TextureSmoothing.NONE;
			button.defaultIcon = icon;

			button.hasLabelTextRenderer = false;

			button.padding = this.smallGutterSize;
			button.gap = this.smallGutterSize;
			button.minGap = this.smallGutterSize;
		}

		protected function setOverlayPlayPauseToggleButtonStyles(button:PlayPauseToggleButton):void
		{
			var icon:ImageSkin = new ImageSkin(null);
			icon.setTextureForState(ButtonState.UP, this.overlayPlayPauseButtonPlayUpIconTexture);
			icon.setTextureForState(ButtonState.HOVER, this.overlayPlayPauseButtonPlayUpIconTexture);
			button.defaultIcon = icon;

			button.hasLabelTextRenderer = false;

			var skin:Quad = new Quad(this.overlayPlayPauseButtonPlayUpIconTexture.width,
				this.overlayPlayPauseButtonPlayUpIconTexture.height);
			skin.alpha = 0;
			button.defaultSkin = skin;

			var overlaySkin:Quad = new Quad(1, 1, VIDEO_OVERLAY_COLOR);
			overlaySkin.alpha = VIDEO_OVERLAY_ALPHA;
			button.upSkin = overlaySkin;
			button.hoverSkin = overlaySkin;
		}

	//-------------------------
	// FullScreenToggleButton
	//-------------------------

		protected function setFullScreenToggleButtonStyles(button:FullScreenToggleButton):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			button.defaultSkin = defaultSkin;

			var otherSkin:ImageSkin = new ImageSkin(null);
			otherSkin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			otherSkin.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.buttonDownSkinTexture);
			otherSkin.width = this.controlSize;
			otherSkin.height = this.controlSize;
			otherSkin.minWidth = this.controlSize;
			otherSkin.minHeight = this.controlSize;
			button.setSkinForState(ButtonState.DOWN, otherSkin);
			button.setSkinForState(ButtonState.DOWN_AND_SELECTED, otherSkin);

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;

			var icon:ImageSkin = new ImageSkin(this.fullScreenToggleButtonEnterUpIconTexture);
			icon.selectedTexture = this.fullScreenToggleButtonExitUpIconTexture;
			icon.textureSmoothing = TextureSmoothing.NONE;
			button.defaultIcon = icon;

			button.hasLabelTextRenderer = false;

			button.padding = this.smallGutterSize;
			button.gap = this.smallGutterSize;
			button.minGap = this.smallGutterSize;
		}

	//-------------------------
	// MuteToggleButton
	//-------------------------

		protected function setMuteToggleButtonStyles(button:MuteToggleButton):void
		{
			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			button.defaultSkin = defaultSkin;

			var otherSkin:ImageSkin = new ImageSkin(null);
			otherSkin.setTextureForState(ButtonState.DOWN, this.buttonDownSkinTexture);
			otherSkin.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.buttonDownSkinTexture);
			otherSkin.width = this.controlSize;
			otherSkin.height = this.controlSize;
			otherSkin.minWidth = this.controlSize;
			otherSkin.minHeight = this.controlSize;
			button.setSkinForState(ButtonState.DOWN, otherSkin);
			button.setSkinForState(ButtonState.DOWN_AND_SELECTED, otherSkin);

			var focusIndicatorSkin:Image = new Image(this.focusIndicatorSkinTexture);
			focusIndicatorSkin.scale9Grid = FOCUS_INDICATOR_SCALE_9_GRID;
			button.focusIndicatorSkin = focusIndicatorSkin;
			button.focusPadding = this.focusPaddingSize;

			var icon:ImageSkin = new ImageSkin(this.muteToggleButtonLoudUpIconTexture);
			icon.selectedTexture = this.muteToggleButtonMutedUpIconTexture;
			icon.textureSmoothing = TextureSmoothing.NONE;
			button.defaultIcon = icon;

			button.hasLabelTextRenderer = false;
			button.showVolumeSliderOnHover = false;

			button.padding = this.smallGutterSize;
			button.gap = this.smallGutterSize;
			button.minGap = this.smallGutterSize;
		}

	//-------------------------
	// SeekSlider
	//-------------------------

		protected function setSeekSliderStyles(slider:SeekSlider):void
		{
			slider.direction = Direction.HORIZONTAL;
			slider.trackLayoutMode = TrackLayoutMode.SINGLE;

			var progressSkin:Image = new Image(this.seekSliderProgressSkinTexture);
			progressSkin.scale9Grid = SEEK_SLIDER_PROGRESS_SKIN_SCALE9_GRID;
			slider.progressSkin = progressSkin;
		}

	//-------------------------
	// VolumeSlider
	//-------------------------

		protected function setVolumeSliderStyles(slider:VolumeSlider):void
		{
			slider.direction = Direction.HORIZONTAL;
			slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			slider.showThumb = false;
		}

		protected function setVolumeSliderThumbStyles(thumb:Button):void
		{
			var thumbSize:Number = 6;
			thumb.defaultSkin = new Quad(thumbSize, thumbSize);
			thumb.defaultSkin.width = 0;
			thumb.defaultSkin.height = 0;

			thumb.hasLabelTextRenderer = false;
		}

		protected function setVolumeSliderMinimumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageLoader = new ImageLoader();
			defaultSkin.scaleContent = false;
			defaultSkin.source = this.volumeSliderMinimumTrackSkinTexture;
			track.defaultSkin = defaultSkin;

			track.hasLabelTextRenderer = false;

			track.minTouchHeight = this.gridSize;
		}

		protected function setVolumeSliderMaximumTrackStyles(track:Button):void
		{
			var defaultSkin:ImageLoader = new ImageLoader();
			defaultSkin.scaleContent = false;
			defaultSkin.horizontalAlign = HorizontalAlign.RIGHT;
			defaultSkin.source = this.volumeSliderMaximumTrackSkinTexture;
			track.defaultSkin = defaultSkin;

			track.hasLabelTextRenderer = false;

			track.minTouchHeight = this.gridSize;
		}
	}
}


================================================
FILE: themes/MinimalMobileTheme/source/feathers/themes/MinimalMobileTheme.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import flash.display.Bitmap;
	import flash.display.BitmapData;

	import starling.text.BitmapFont;
	import starling.text.TextField;
	import starling.textures.Texture;
	import starling.textures.TextureAtlas;

	/**
	 * The "Minimal" theme for mobile Feathers apps.
	 *
	 * <p>This version of the theme embeds its assets. To load assets at
	 * runtime, see <code>MinimalMobileThemeWithAssetManager</code> instead.</p>
	 *
	 * @see http://feathersui.com/help/theme-assets.html
	 */
	public class MinimalMobileTheme extends BaseMinimalMobileTheme
	{
		/**
		 * @private
		 */
		[Embed(source="/../assets/images/minimal_mobile.xml",mimeType="application/octet-stream")]
		protected static const ATLAS_XML:Class;

		/**
		 * @private
		 */
		[Embed(source="/../assets/images/minimal_mobile.png")]
		protected static const ATLAS_BITMAP:Class;

		/**
		 * @private
		 */
		[Embed(source="/../assets/fonts/pf_ronda_seven.fnt",mimeType="application/octet-stream")]
		protected static const FONT_XML:Class;

		/**
		 * Constructor.
		 */
		public function MinimalMobileTheme()
		{
			super();
			this.initialize();
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this.initializeTextureAtlas();
			this.initializeBitmapFont();
			super.initialize();
		}

		/**
		 * @private
		 */
		protected function initializeTextureAtlas():void
		{
			var atlasBitmapData:BitmapData = Bitmap(new ATLAS_BITMAP()).bitmapData;
			var atlasTexture:Texture = Texture.fromBitmapData(atlasBitmapData, false, false, 2);
			atlasTexture.root.onRestore = this.atlasTexture_onRestore;
			atlasBitmapData.dispose();
			this.atlas = new TextureAtlas(atlasTexture, XML(new ATLAS_XML()));
		}

		/**
		 * @private
		 */
		protected function initializeBitmapFont():void
		{
			var bitmapFont:BitmapFont = new BitmapFont(this.atlas.getTexture(FONT_TEXTURE_NAME), XML(new FONT_XML()));
			TextField.registerCompositor(bitmapFont, FONT_NAME);
		}

		/**
		 * @private
		 */
		protected function atlasTexture_onRestore():void
		{
			var atlasBitmapData:BitmapData = Bitmap(new ATLAS_BITMAP()).bitmapData;
			this.atlas.texture.root.uploadBitmapData(atlasBitmapData);
			atlasBitmapData.dispose();
		}
	}
}

================================================
FILE: themes/MinimalMobileTheme/source/feathers/themes/MinimalMobileThemeWithAssetManager.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved.

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import feathers.events.FeathersEventType;

	import starling.assets.AssetManager;
	import starling.core.Starling;
	import starling.events.Event;
	import starling.text.BitmapFont;
	import starling.text.TextField;

	/**
	 * @copy feathers.themes.IAsyncTheme#event:complete
	 *
	 * @eventType starling.events.Event.COMPLETE
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * Dispatched when the theme's assets fail to load due to an error.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The error string.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.ERROR
	 */
	[Event(name="error",type="starling.events.Event")]

	/**
	 * The "Minimal" theme for mobile Feathers apps.
	 *
	 * <p>This version of the theme requires loading assets at runtime. To use
	 * embedded assets, see <code>MinimalMobileTheme</code> instead.</p>
	 *
	 * <p>To use this theme, the following files must be included when packaging
	 * your app:</p>
	 * <ul>
	 *     <li>images/minimal_mobile.png</li>
	 *     <li>images/minimal_mobile.xml</li>
	 *     <li>fonts/pf_ronda_seven.fnt</li>
	 * </ul>
	 *
	 * @see http://feathersui.com/help/theme-assets.html
	 */
	public class MinimalMobileThemeWithAssetManager extends BaseMinimalMobileTheme implements IAsyncTheme
	{
		/**
		 * @private
		 * The name of the texture atlas in the asset manager.
		 */
		protected static const ATLAS_NAME:String = "minimal_mobile";

		/**
		 * @private
		 */
		protected static const ATLAS_SCALE_FACTOR:int = 2;

		/**
		 * Constructor.
		 * @param assetsBasePath The root folder of the assets.
		 * @param assetManager An optional pre-created AssetManager. The scaleFactor property must be equal to Starling.contentScaleFactor. To load assets with a different scale factor, use multiple AssetManager instances.
		 */
		public function MinimalMobileThemeWithAssetManager(assetsBasePath:String = "./", assetManager:AssetManager = null)
		{
			this.loadAssets(assetsBasePath, assetManager);
		}

		/**
		 * @private
		 * The paths to each of the assets, relative to the base path.
		 */
		protected var assetPaths:Vector.<String> = new <String>
		[
			"images/" + ATLAS_NAME + ".xml",
			"images/" + ATLAS_NAME + ".png",
			"fonts/pf_ronda_seven.fnt"
		];

		/**
		 * @private
		 */
		protected var assetManager:AssetManager;

		/**
		 * @private
		 */
		protected var isComplete:Boolean = false;

		/**
		 * @private
		 */
		override public function dispose():void
		{
			super.dispose();
			if(this.assetManager)
			{
				this.assetManager.removeTextureAtlas(ATLAS_NAME);
				this.assetManager = null;
			}
		}

		/**
		 * @copy feathers.themes.IAsyncTheme#isCompleteForStarling()
		 */
		public function isCompleteForStarling(starling:Starling):Boolean
		{
			return this.isComplete;
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this.initializeTextureAtlas();
			this.initializeBitmapFont();
			super.initialize();
		}

		/**
		 * @private
		 */
		protected function initializeTextureAtlas():void
		{
			this.atlas = this.assetManager.getTextureAtlas(ATLAS_NAME);
		}

		/**
		 * @private
		 */
		protected function initializeBitmapFont():void
		{
			var font:BitmapFont = TextField.getBitmapFont(FONT_TEXTURE_NAME);
			//for convenience, let's also register it using this name
			TextField.registerCompositor(font, FONT_NAME);
		}

		/**
		 * @private
		 */
		protected function loadAssets(assetsBasePath:String, assetManager:AssetManager):void
		{
			var oldScaleFactor:Number = -1;
			if(assetManager)
			{
				oldScaleFactor = assetManager.textureOptions.scale;
				assetManager.textureOptions.scale = ATLAS_SCALE_FACTOR;
			}
			else
			{
				assetManager = new AssetManager(ATLAS_SCALE_FACTOR);
			}
			this.assetManager = assetManager;
			//add a trailing slash, if needed
			if(assetsBasePath.lastIndexOf("/") != assetsBasePath.length - 1)
			{
				assetsBasePath += "/";
			}
			var assetPaths:Vector.<String> = this.assetPaths;
			var assetCount:int = assetPaths.length;
			for(var i:int = 0; i < assetCount; i++)
			{
				var asset:String = assetPaths[i];
				this.assetManager.enqueue(assetsBasePath + asset);
			}
			if(oldScaleFactor != -1)
			{
				//restore the old scale factor, just in case
				this.assetManager.textureOptions.scale = oldScaleFactor;
			}
			this.assetManager.loadQueue(assetManager_onComplete, assetManager_onError);
		}

		/**
		 * @private
		 */
		protected function assetManager_onComplete():void
		{
			this.initialize();
			this.isComplete = true;
			this.dispatchEventWith(Event.COMPLETE, false, Starling.current);
		}

		/**
		 * @private
		 */
		protected function assetManager_onError(error:String):void
		{
			this.dispatchEventWith(FeathersEventType.ERROR, false, error);
		}
	}
}


================================================
FILE: themes/TopcoatLightMobileTheme/README.md
================================================
# Topcoat Light Mobile Theme for Feathers

[Feathers](http://feathersui.com/) theme for mobile devices inspired by [Topcoat UI](http://topcoat.io/).

## Original Artwork

This theme's texture atlas was exported from Adobe Animate CC. To modify colors and other properties, or to add new skins to the texture atlas, [download the source FLA file](http://feathersui.com/help/theme-sources.html) from the Feathers website.

## Credits

Created exclusively for Feathers by [Marcel Piestansky](http://marpies.com/). Uses the open source font [Source Sans Pro](https://github.com/adobe/Source-Sans-Pro) created by Adobe Systems Incorporated.

================================================
FILE: themes/TopcoatLightMobileTheme/assets/images/topcoat_light_mobile.xml
================================================
<?xml version="1.0" encoding="utf-8"?>
<TextureAtlas imagePath="topcoat_light_mobile.png">
	<!-- Created with Adobe Animate version 19.0.0.326 -->
	<!-- http://www.adobe.com/products/animate.html -->
	<SubTexture name="background-popup-skin0000" x="311" y="367" width="54" height="58" pivotX="0" pivotY="0"/>
	<SubTexture name="button-back-disabled-skin0000" x="203" y="1" width="80" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="button-back-down-skin0000" x="122" y="102" width="80" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="button-back-up-skin0000" x="122" y="203" width="80" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="button-call-to-action-disabled-skin0000" x="366" y="367" width="30" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="button-call-to-action-down-skin0000" x="422" y="203" width="30" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="button-call-to-action-up-skin0000" x="407" y="1" width="30" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="button-danger-disabled-skin0000" x="391" y="243" width="30" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="button-danger-down-skin0000" x="407" y="102" width="30" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="button-danger-up-skin0000" x="397" y="344" width="30" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="button-disabled-skin0000" x="239" y="459" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="button-down-skin0000" x="272" y="459" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="button-forward-disabled-skin0000" x="122" y="1" width="80" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="button-forward-down-skin0000" x="203" y="102" width="80" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="button-forward-up-skin0000" x="203" y="203" width="80" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="button-up-skin0000" x="305" y="459" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-arrow-bottom-skin0000" x="128" y="304" width="79" height="46" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-arrow-left-skin0000" x="1" y="353" width="44" height="85" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-arrow-right-skin0000" x="83" y="304" width="44" height="85" pivotX="0" pivotY="0"/>
	<SubTexture name="callout-arrow-top-skin0000" x="1" y="304" width="81" height="48" pivotX="0" pivotY="0"/>
	<SubTexture name="check-disabled-icon0000" x="284" y="1" width="60" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="check-down-icon0000" x="284" y="62" width="60" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="check-selected-disabled-icon0000" x="284" y="123" width="60" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="check-selected-down-icon0000" x="208" y="304" width="60" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="check-selected-up-icon0000" x="128" y="351" width="60" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="check-up-icon0000" x="269" y="304" width="60" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-column-drop-indicator-skin0000" x="172" y="469" width="6" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-column-resize-skin0000" x="172" y="469" width="6" height="6" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-divider-skin0000" x="172" y="460" width="6" height="8" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-skin0000" x="98" y="390" width="10" height="20" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-sort-ascending-icon0000" x="309" y="287" width="20" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="data-grid-header-sort-descending-icon0000" x="77" y="390" width="20" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="drag-handle-icon0000" x="1" y="481" width="32" height="30" pivotX="0" pivotY="0"/>
	<SubTexture name="focus-indicator-skin0000" x="422" y="304" width="33" height="33" pivotX="0" pivotY="0"/>
	<SubTexture name="grouped-list-footer-skin0000" x="109" y="390" width="10" height="20" pivotX="0" pivotY="0"/>
	<SubTexture name="grouped-list-header-skin0000" x="98" y="390" width="10" height="20" pivotX="0" pivotY="0"/>
	<SubTexture name="header-background-skin0000" x="46" y="353" width="30" height="122" pivotX="0" pivotY="0"/>
	<SubTexture name="list-first-item-up-skin0000" x="453" y="233" width="10" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="list-item-down-skin0000" x="453" y="256" width="10" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="list-item-selected-skin0000" x="464" y="233" width="10" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="list-item-up-skin0000" x="456" y="279" width="10" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-normal-skin0000" x="284" y="245" width="41" height="41" pivotX="0" pivotY="0"/>
	<SubTexture name="page-indicator-selected-skin0000" x="1" y="439" width="41" height="41" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-button-disabled-icon0000" x="179" y="483" width="23" height="13" pivotX="0" pivotY="0"/>
	<SubTexture name="picker-list-button-icon0000" x="341" y="451" width="23" height="13" pivotX="0" pivotY="0"/>
	<SubTexture name="pop-up-drawer-background-skin0000" x="407" y="228" width="11" height="14" pivotX="0" pivotY="0"/>
	<SubTexture name="progress-bar-horizontal-background-disabled-skin0000" x="138" y="412" width="33" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="progress-bar-horizontal-background-skin0000" x="428" y="338" width="33" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="progress-bar-horizontal-fill-disabled-skin0000" x="428" y="404" width="33" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="progress-bar-horizontal-fill-skin0000" x="428" y="371" width="33" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="progress-bar-vertical-background-disabled-skin0000" x="397" y="445" width="32" height="33" pivotX="0" pivotY="0"/>
	<SubTexture name="progress-bar-vertical-background-skin0000" x="430" y="437" width="32" height="33" pivotX="0" pivotY="0"/>
	<SubTexture name="progress-bar-vertical-fill-disabled-skin0000" x="430" y="471" width="32" height="33" pivotX="0" pivotY="0"/>
	<SubTexture name="progress-bar-vertical-fill-skin0000" x="172" y="426" width="32" height="33" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-disabled-icon0000" x="330" y="245" width="60" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-down-icon0000" x="330" y="306" width="60" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-disabled-icon0000" x="284" y="184" width="60" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-down-icon0000" x="77" y="412" width="60" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-selected-up-icon0000" x="189" y="365" width="60" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="radio-up-icon0000" x="250" y="365" width="60" height="60" pivotX="0" pivotY="0"/>
	<SubTexture name="search-input-disabled-skin0000" x="1" y="1" width="120" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="search-input-focused-skin0000" x="1" y="102" width="120" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="search-input-icon0000" x="453" y="199" width="31" height="33" pivotX="0" pivotY="0"/>
	<SubTexture name="search-input-up-skin0000" x="1" y="203" width="120" height="100" pivotX="0" pivotY="0"/>
	<SubTexture name="simple-scroll-bar-horizontal-thumb-skin0000" x="284" y="287" width="24" height="12" pivotX="0" pivotY="0"/>
	<SubTexture name="simple-scroll-bar-vertical-thumb-skin0000" x="407" y="203" width="12" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="slider-horizontal-maximum-track-disabled-skin0000" x="138" y="445" width="33" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="slider-horizontal-maximum-track-skin0000" x="205" y="426" width="33" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="slider-horizontal-minimum-track-disabled-skin0000" x="77" y="473" width="33" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="slider-horizontal-minimum-track-skin0000" x="205" y="459" width="33" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="slider-vertical-maximum-track-disabled-skin0000" x="273" y="426" width="33" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="slider-vertical-maximum-track-skin0000" x="43" y="476" width="33" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="slider-vertical-minimum-track-disabled-skin0000" x="307" y="426" width="33" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="slider-vertical-minimum-track-skin0000" x="239" y="426" width="33" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="spinner-list-selection-overlay-skin0000" x="179" y="460" width="24" height="22" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-down-skin0000" x="376" y="122" width="30" height="120" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-selected-disabled-skin0000" x="376" y="1" width="30" height="120" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-selected-up-skin0000" x="345" y="122" width="30" height="120" pivotX="0" pivotY="0"/>
	<SubTexture name="tab-up-skin0000" x="345" y="1" width="30" height="120" pivotX="0" pivotY="0"/>
	<SubTexture name="text-input-disabled-skin0000" x="371" y="479" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="text-input-error-skin0000" x="438" y="1" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="text-input-focused-skin0000" x="338" y="468" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="text-input-up-skin0000" x="438" y="100" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="toggle-button-selected-disabled-skin0000" x="438" y="34" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="toggle-button-selected-up-skin0000" x="438" y="67" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="toggle-switch-off-track-disabled-skin0000" x="145" y="478" width="33" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="toggle-switch-off-track-skin0000" x="111" y="478" width="33" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="toggle-switch-on-track-disabled-skin0000" x="438" y="133" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="toggle-switch-on-track-skin0000" x="438" y="166" width="32" height="32" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-closed-icon0000" x="404" y="479" width="24" height="24" pivotX="0" pivotY="0"/>
	<SubTexture name="tree-disclosure-open-icon0000" x="341" y="426" width="24" height="24" pivotX="0" pivotY="0"/>
</TextureAtlas>


================================================
FILE: themes/TopcoatLightMobileTheme/package-src.json
================================================
{
	"id": "feathersui_TopcoatLightMobileTheme-source",
	"name": "Feathers UI Topcoat Light Mobile Theme",
	"url": "https://feathersui.com/as3-starling/",
	"docUrl": "https://feathersui/api-reference/",
	"description": "Topcoat light mobile theme for Feathers UI (Starling version)",
	"type": "src",
	"version": "4.2.0",
	"sourceUrl": "https://github.com/feathersui/feathersui-starling/releases/download/v4.2.0/feathersui_TopcoatLightMobileTheme-source_4.2.0.airpackage",
	"publishedAt": "2021-11-19T00:00:00.000Z",
	"dependencies": [
		"starling-source:2.x.x",
		"feathersui-source:4.2.x"
	],
	"parameters": [],
	"tags": ["theme", "feathers", "starling"],
	"status": "release",
	"license": {
	  "type": "Simplified BSD",
	  "url": "https://github.com/feathersui/feathersui-starling/blob/v4.2.0/LICENSE.md",
	  "public": true
	}
  }
  

================================================
FILE: themes/TopcoatLightMobileTheme/package-swc.json
================================================
{
	"id": "feathersui_TopcoatLightMobileTheme",
	"name": "Feathers UI Topcoat Light Mobile Theme",
	"url": "https://feathersui.com/as3-starling/",
	"docUrl": "https://feathersui/api-reference/",
	"description": "Topcoat light mobile theme for Feathers UI (Starling version)",
	"type": "swc",
	"version": "4.2.0",
	"sourceUrl": "https://github.com/feathersui/feathersui-starling/releases/download/v4.2.0/feathersui_TopcoatLightMobileTheme_4.2.0.airpackage",
	"publishedAt": "2021-11-19T00:00:00.000Z",
	"dependencies": [
		"starling:2.x.x",
		"feathersui:4.2.x"
	],
	"parameters": [],
	"tags": ["theme", "feathers", "starling"],
	"status": "release",
	"license": {
	  "type": "Simplified BSD",
	  "url": "https://github.com/feathersui/feathersui-starling/blob/v4.2.0/LICENSE.md",
	  "public": true
	}
  }
  

================================================
FILE: themes/TopcoatLightMobileTheme/source/feathers/themes/BaseTopcoatLightMobileTheme.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved., Marcel Piestansky

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import feathers.controls.Alert;
	import feathers.controls.AutoComplete;
	import feathers.controls.AutoSizeMode;
	import feathers.controls.Button;
	import feathers.controls.ButtonGroup;
	import feathers.controls.ButtonState;
	import feathers.controls.Callout;
	import feathers.controls.Check;
	import feathers.controls.DataGrid;
	import feathers.controls.DateTimeSpinner;
	import feathers.controls.Drawers;
	import feathers.controls.GroupedList;
	import feathers.controls.Header;
	import feathers.controls.ImageLoader;
	import feathers.controls.Label;
	import feathers.controls.LayoutGroup;
	import feathers.controls.List;
	import feathers.controls.NumericStepper;
	import feathers.controls.PageIndicator;
	import feathers.controls.Panel;
	import feathers.controls.PanelScreen;
	import feathers.controls.PickerList;
	import feathers.controls.ProgressBar;
	import feathers.controls.Radio;
	import feathers.controls.ScrollContainer;
	import feathers.controls.ScrollPolicy;
	import feathers.controls.ScrollText;
	import feathers.controls.Scroller;
	import feathers.controls.SimpleScrollBar;
	import feathers.controls.Slider;
	import feathers.controls.SpinnerList;
	import feathers.controls.StepperButtonLayoutMode;
	import feathers.controls.TabBar;
	import feathers.controls.TextArea;
	import feathers.controls.TextCallout;
	import feathers.controls.TextInput;
	import feathers.controls.TextInputState;
	import feathers.controls.Toast;
	import feathers.controls.ToggleButton;
	import feathers.controls.ToggleSwitch;
	import feathers.controls.TrackLayoutMode;
	import feathers.controls.Tree;
	import feathers.controls.popups.BottomDrawerPopUpContentManager;
	import feathers.controls.popups.CalloutPopUpContentManager;
	import feathers.controls.renderers.BaseDefaultItemRenderer;
	import feathers.controls.renderers.DefaultDataGridCellRenderer;
	import feathers.controls.renderers.DefaultDataGridHeaderRenderer;
	import feathers.controls.renderers.DefaultGroupedListHeaderOrFooterRenderer;
	import feathers.controls.renderers.DefaultGroupedListItemRenderer;
	import feathers.controls.renderers.DefaultListItemRenderer;
	import feathers.controls.renderers.DefaultTreeItemRenderer;
	import feathers.controls.text.ITextEditorViewPort;
	import feathers.controls.text.StageTextTextEditor;
	import feathers.controls.text.TextBlockTextEditor;
	import feathers.controls.text.TextBlockTextRenderer;
	import feathers.controls.text.TextFieldTextEditorViewPort;
	import feathers.core.FeathersControl;
	import feathers.core.ITextEditor;
	import feathers.core.ITextRenderer;
	import feathers.core.PopUpManager;
	import feathers.layout.Direction;
	import feathers.layout.HorizontalAlign;
	import feathers.layout.HorizontalLayout;
	import feathers.layout.RelativePosition;
	import feathers.layout.VerticalAlign;
	import feathers.layout.VerticalLayout;
	import feathers.skins.ImageSkin;
	import feathers.system.DeviceCapabilities;

	import flash.geom.Rectangle;

	import starling.display.DisplayObject;
	import starling.display.DisplayObjectContainer;
	import starling.display.Image;
	import starling.display.Quad;
	import starling.text.TextFormat;
	import starling.textures.Texture;
	import starling.textures.TextureAtlas;

	public class BaseTopcoatLightMobileTheme extends StyleNameFunctionTheme
	{
		[Embed(source="/../assets/fonts/SourceSansPro-Regular.ttf", fontFamily="SourceSansPro", fontWeight="normal", mimeType="application/x-font", embedAsCFF="true")]
		protected static const SOURCE_SANS_PRO_REGULAR:Class;

		[Embed(source="/../assets/fonts/SourceSansPro-Semibold.ttf",fontFamily="SourceSansPro",fontWeight="bold",mimeType="application/x-font",embedAsCFF="true")]
		protected static const SOURCE_SANS_PRO_SEMIBOLD:Class;

		/**
		 * The name of the embedded font used by controls in this theme.
		 */
		public static const FONT_NAME:String = "SourceSansPro";

		/**
		 * The stack of fonts to use for controls that don't use embedded fonts.
		 */
		public static const FONT_NAME_STACK:String = "Source Sans Pro,Helvetica,_sans";

		protected static const COLOR_TEXT_DARK:uint = 0x454545;
		protected static const COLOR_TEXT_LIGHT:uint = 0xFFFFFF;
		protected static const COLOR_TEXT_SELECTED:uint = 0x0083E8;
		protected static const COLOR_TEXT_DARK_DISABLED:uint = 0x848585;
		protected static const COLOR_TEXT_SELECTED_DISABLED:uint = 0x96AFC3;
		protected static const COLOR_TEXT_ACTION_DISABLED:uint = 0xC6DFF3;
		protected static const COLOR_TEXT_DANGER_DISABLED:uint = 0xF7B4AF;
		protected static const COLOR_BACKGROUND_LIGHT:uint = 0xDFE2E2;
		protected static const COLOR_SPINNER_LIST_BACKGROUND:uint = 0xE5E9E8;
		protected static const COLOR_MODAL_OVERLAY:uint = 0xDFE2E2;
		protected static const ALPHA_MODAL_OVERLAY:Number = 0.8;
		protected static const COLOR_DRAWER_OVERLAY:uint = 0x454545;
		protected static const ALPHA_DRAWER_OVERLAY:Number = 0.8;
		protected static const COLOR_DRAWERS_DIVIDER:uint = 0x9DACA9;
		protected static const ALPHA_DATA_GRID_DRAG_OVERLAY:Number = 0.5;
		protected static const COLOR_DATA_GRID_DRAG_OVERLAY:uint = 0xDFE2E2;
		protected static const COLOR_TOAST_BACKGROUND:uint = 0x454545;

		protected static const BUTTON_SCALE9_GRID:Rectangle = new Rectangle(7, 7, 1, 1);
		protected static const BACK_BUTTON_SCALE9_GRID:Rectangle = new Rectangle(26, 5, 10, 40);
		protected static const FORWARD_BUTTON_SCALE9_GRID:Rectangle = new Rectangle(5, 5, 10, 10);
		protected static const TEXT_INPUT_SCALE9_GRID:Rectangle = new Rectangle(7, 7, 1, 1);
		protected static const HORIZONTAL_MINIMUM_TRACK_SCALE9_GRID:Rectangle = new Rectangle(5, 0, 1, 13);
		protected static const HORIZONTAL_MAXIMUM_TRACK_SCALE9_GRID:Rectangle = new Rectangle(0, 0, 1, 13);
		protected static const VERTICAL_MINIMUM_TRACK_SCALE9_GRID:Rectangle = new Rectangle(0, 0, 13, 1);
		protected static const VERTICAL_MAXIMUM_TRACK_SCALE9_GRID:Rectangle = new Rectangle(0, 5, 13, 1);
		protected static const BAR_HORIZONTAL_SCALE9_GRID:Rectangle = new Rectangle(8, 8, 1, 1);
		protected static const BAR_VERTICAL_SCALE9_GRID:Rectangle = new Rectangle(8, 8, 1, 1);
		protected static const HEADER_BACKGROUND_SCALE9_GRID:Rectangle = new Rectangle(3, 3, 10, 56);
		protected static const TAB_SCALE9_GRID:Rectangle = new Rectangle(3, 3, 5, 5);
		protected static const SEARCH_INPUT_SCALE9_GRID:Rectangle = new Rectangle(25, 25, 10, 1);
		protected static const BACKGROUND_POPUP_SCALE9_GRID:Rectangle = new Rectangle(5, 5, 10, 10);
		protected static const POP_UP_DRAWER_BACKGROUND_SCALE9_GRID:Rectangle = new Rectangle(1, 3, 3, 4);
		protected static const LIST_ITEM_SCALE9_GRID:Rectangle = new Rectangle(2, 2, 1, 6);
		protected static const GROUPED_LIST_HEADER_OR_FOOTER_SCALE9_GRID:Rectangle = new Rectangle(2, 2, 1, 6);
		protected static const SPINNER_LIST_OVERLAY_SCALE9_GRID:Rectangle = new Rectangle(2, 5, 1, 1);
		protected static const HORIZONTAL_SIMPLE_SCROLL_BAR_SCALE9_GRID:Rectangle = new Rectangle(5, 0, 3, 6);
		protected static const VERTICAL_SIMPLE_SCROLL_BAR_SCALE9_GRID:Rectangle = new Rectangle(0, 5, 6, 3);
		protected static const DATA_GRID_HEADER_SCALE9_GRID:Rectangle = new Rectangle(2, 2, 1, 6);
		protected static const DATA_GRID_COLUMN_RESIZE_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 3, 1);
		protected static const DATA_GRID_COLUMN_DROP_INDICATOR_SCALE_9_GRID:Rectangle = new Rectangle(0, 1, 3, 1);
		protected static const DATA_GRID_HEADER_DIVIDER_SCALE_9_GRID:Rectangle = new Rectangle(0, 2, 5, 1);

		protected static const THEME_STYLE_NAME_VERTICAL_SIMPLE_SCROLL_BAR_THUMB:String = "topcoat-light-mobile-vertical-simple-scroll-bar-thumb";
		protected static const THEME_STYLE_NAME_HORIZONTAL_SIMPLE_SCROLL_BAR_THUMB:String = "topcoat-light-mobile-horizontal-simple-scroll-bar-thumb";
		protected static const THEME_STYLE_NAME_HORIZONTAL_SLIDER_THUMB:String = "topcoat-light-mobile-horizontal-slider-thumb";
		protected static const THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK:String = "topcoat-light-mobile-horizontal-slider-minimum-track";
		protected static const THEME_STYLE_NAME_HORIZONTAL_SLIDER_MAXIMUM_TRACK:String = "topcoat-light-mobile-horizontal-slider-maximum-track";
		protected static const THEME_STYLE_NAME_VERTICAL_SLIDER_THUMB:String = "topcoat-light-mobile-vertical-slider-thumb";
		protected static const THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK:String = "topcoat-light-mobile-vertical-slider-minimum-track";
		protected static const THEME_STYLE_NAME_VERTICAL_SLIDER_MAXIMUM_TRACK:String = "topcoat-light-mobile-vertical-slider-maximum-track";
		protected static const THEME_STYLE_NAME_ALERT_BUTTON_GROUP_BUTTON:String = "topcoat-light-mobile-alert-button-group-button";
		protected static const THEME_STYLE_NAME_ALERT_BUTTON_GROUP_LAST_BUTTON:String = "topcoat-light-mobile-alert-button-group-last-button";
		protected static const THEME_STYLE_NAME_GROUPED_LIST_FIRST_ITEM_RENDERER:String = "topcoat-light-mobile-grouped-list-first-item-renderer";
		protected static const THEME_STYLE_NAME_SPINNER_LIST_ITEM_RENDERER:String = "topcoat-light-mobile-spinner-list-item-renderer";
		protected static const THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER:String = "topcoat-light-mobile-date-time-spinner-list-item-renderer";
		protected static const THEME_STYLE_NAME_POP_UP_DRAWER:String = "topcoat-light-mobile-pop-up-drawer";
		protected static const THEME_STYLE_NAME_POP_UP_DRAWER_HEADER:String = "topcoat-light-mobile-pop-up-drawer-header";
		protected static const THEME_STYLE_NAME_TABLET_PICKER_LIST_ITEM_RENDERER:String = "topcoat-light-mobile-tablet-picker-list-item-renderer";
		protected static const THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON:String = "topcoat-light-mobile-toast-actions-button";

		public function BaseTopcoatLightMobileTheme()
		{
			super();
		}

		protected var gridSize:int = 70;
		protected var gutterSize:int = 20;
		protected var smallGutterSize:int = 10;
		protected var extraSmallGutterSize:int = 5;
		protected var borderSize:int = 1;
		protected var controlSize:int = 50;
		protected var smallControlSize:int = 16;
		protected var wideControlSize:int = 230;
		protected var popUpFillSize:int = 300;
		protected var thumbSize:int = 34;
		protected var shadowSize:int = 2;
		protected var calloutBackgroundMinSize:int = 53;
		protected var calloutVerticalArrowGap:int = -8;
		protected var calloutHorizontalArrowGap:int = -7;

		protected var smallFontSize:int = 14;
		protected var regularFontSize:int = 16;
		protected var largeFontSize:int = 20;

		protected var darkFontStyles:TextFormat;
		protected var lightFontStyles:TextFormat;
		protected var selectedFontStyles:TextFormat;
		protected var darkDisabledFontStyles:TextFormat;
		protected var selectedDisabledFontStyles:TextFormat;
		protected var actionDisabledFontStyles:TextFormat;
		protected var dangerDisabledFontStyles:TextFormat;
		protected var darkCenteredFontStyles:TextFormat;
		protected var darkCenteredDisabledFontStyles:TextFormat;
		protected var smallDarkFontStyles:TextFormat;
		protected var smallSelectedFontStyles:TextFormat;
		protected var smallDarkDisabledFontStyles:TextFormat;
		protected var largeDarkFontStyles:TextFormat;
		protected var largeDarkDisabledFontStyles:TextFormat;
		protected var darkScrollTextFontStyles:TextFormat;
		protected var darkScrollTextDisabledFontStyles:TextFormat;
		protected var lightBoldFontStyles:TextFormat;
		protected var selectedBoldFontStyles:TextFormat;

		/**
		 * The texture atlas that contains skins for this theme. This base class
		 * does not initialize this member variable. Subclasses are expected to
		 * load the assets somehow and set the <code>atlas</code> member
		 * variable before calling <code>initialize()</code>.
		 */
		protected var atlas:TextureAtlas;

		protected var focusIndicatorTexture:Texture;
		protected var buttonUpTexture:Texture;
		protected var buttonDownTexture:Texture;
		protected var buttonDisabledTexture:Texture;
		protected var quietButtonDownTexture:Texture;
		protected var backButtonUpTexture:Texture;
		protected var backButtonDownTexture:Texture;
		protected var backButtonDisabledTexture:Texture;
		protected var forwardButtonUpTexture:Texture;
		protected var forwardButtonDownTexture:Texture;
		protected var forwardButtonDisabledTexture:Texture;
		protected var dangerButtonUpTexture:Texture;
		protected var dangerButtonDownTexture:Texture;
		protected var dangerButtonDisabledTexture:Texture;
		protected var callToActionButtonUpTexture:Texture;
		protected var callToActionButtonDownTexture:Texture;
		protected var callToActionButtonDisabledTexture:Texture;
		protected var toggleButtonSelectedUpTexture:Texture;
		protected var toggleButtonSelectedDisabledTexture:Texture;
		protected var toggleSwitchOnTrackTexture:Texture;
		protected var toggleSwitchOnTrackDisabledTexture:Texture;
		protected var toggleSwitchOffTrackTexture:Texture;
		protected var toggleSwitchOffTrackDisabledTexture:Texture;
		protected var checkUpIconTexture:Texture;
		protected var checkSelectedUpIconTexture:Texture;
		protected var checkDownIconTexture:Texture;
		protected var checkDisabledIconTexture:Texture;
		protected var checkSelectedDownIconTexture:Texture;
		protected var checkSelectedDisabledIconTexture:Texture;
		protected var radioUpIconTexture:Texture;
		protected var radioSelectedUpIconTexture:Texture;
		protected var radioDownIconTexture:Texture;
		protected var radioDisabledIconTexture:Texture;
		protected var radioSelectedDownIconTexture:Texture;
		protected var radioSelectedDisabledIconTexture:Texture;
		protected var horizontalProgressBarFillTexture:Texture;
		protected var horizontalProgressBarFillDisabledTexture:Texture;
		protected var horizontalProgressBarBackgroundTexture:Texture;
		protected var horizontalProgressBarBackgroundDisabledTexture:Texture;
		protected var verticalProgressBarFillTexture:Texture;
		protected var verticalProgressBarFillDisabledTexture:Texture;
		protected var verticalProgressBarBackgroundTexture:Texture;
		protected var verticalProgressBarBackgroundDisabledTexture:Texture;
		protected var headerBackgroundSkinTexture:Texture;
		protected var verticalSimpleScrollBarThumbTexture:Texture;
		protected var horizontalSimpleScrollBarThumbTexture:Texture;
		protected var tabUpTexture:Texture;
		protected var tabDownTexture:Texture;
		protected var tabSelectedUpTexture:Texture;
		protected var tabSelectedDisabledTexture:Texture;
		protected var horizontalSliderMinimumTrackTexture:Texture;
		protected var horizontalSliderMinimumTrackDisabledTexture:Texture;
		protected var horizontalSliderMaximumTrackTexture:Texture;
		protected var horizontalSliderMaximumTrackDisabledTexture:Texture;
		protected var verticalSliderMinimumTrackTexture:Texture;
		protected var verticalSliderMinimumTrackDisabledTexture:Texture;
		protected var verticalSliderMaximumTrackTexture:Texture;
		protected var verticalSliderMaximumTrackDisabledTexture:Texture;
		protected var textInputBackgroundEnabledTexture:Texture;
		protected var textInputBackgroundFocusedTexture:Texture;
		protected var textInputBackgroundErrorTexture:Texture;
		protected var textInputBackgroundDisabledTexture:Texture;
		protected var searchTextInputBackgroundEnabledTexture:Texture;
		protected var searchTextInputBackgroundFocusedTexture:Texture;
		protected var searchTextInputBackgroundDisabledTexture:Texture;
		protected var searchIconTexture:Texture;
		protected var popUpBackgroundTexture:Texture;
		protected var calloutTopArrowTexture:Texture;
		protected var calloutRightArrowTexture:Texture;
		protected var calloutBottomArrowTexture:Texture;
		protected var calloutLeftArrowTexture:Texture;
		protected var itemRendererUpTexture:Texture;
		protected var itemRendererDownTexture:Texture;
		protected var itemRendererSelectedTexture:Texture;
		protected var firstItemRendererUpTexture:Texture;
		protected var groupedListHeaderTexture:Texture;
		protected var groupedListFooterTexture:Texture;
		protected var pickerListButtonIcon:Texture;
		protected var pickerListButtonDisabledIcon:Texture;
		protected var popUpDrawerBackgroundTexture:Texture;
		protected var spinnerListSelectionOverlayTexture:Texture;
		protected var pageIndicatorNormalTexture:Texture;
		protected var pageIndicatorSelectedTexture:Texture;
		protected var treeDisclosureOpenIconTexture:Texture;
		protected var treeDisclosureClosedIconTexture:Texture;
		protected var dataGridHeaderTexture:Texture;
		protected var dataGridHeaderSortAscendingIconTexture:Texture;
		protected var dataGridHeaderSortDescendingIconTexture:Texture;
		protected var dataGridColumnResizeSkinTexture:Texture;
		protected var dataGridColumnDropIndicatorSkinTexture:Texture;
		protected var dataGridHeaderDividerSkinTexture:Texture;
		protected var dragHandleIconTexture:Texture;

		/**
		 * Disposes the atlas before calling super.dispose()
		 */
		override public function dispose():void
		{
			if(this.atlas)
			{
				this.atlas.dispose();
				this.atlas = null;
			}
			super.dispose();
		}

		/**
		 * Initializes the theme. Expected to be called by subclasses after the
		 * assets have been loaded and the skin texture atlas has been created.
		 */
		protected function initialize():void
		{
			this.initializeFonts();
			this.initializeTextures();
			this.initializeGlobals();
			this.initializeStage();
			this.initializeStyleProviders();
		}

		protected function initializeStage():void
		{
			this.starling.stage.color = COLOR_BACKGROUND_LIGHT;
			this.starling.nativeStage.color = COLOR_BACKGROUND_LIGHT;
		}

		protected function initializeTextures():void
		{
			this.popUpBackgroundTexture = this.atlas.getTexture("background-popup-skin0000");
			this.popUpDrawerBackgroundTexture = this.atlas.getTexture("pop-up-drawer-background-skin0000");

			this.focusIndicatorTexture = this.atlas.getTexture("focus-indicator-skin0000");

			this.buttonUpTexture = this.atlas.getTexture("button-up-skin0000");
			this.buttonDownTexture = this.atlas.getTexture("button-down-skin0000");
			this.buttonDisabledTexture = this.atlas.getTexture("button-disabled-skin0000");
			this.quietButtonDownTexture = this.atlas.getTexture("button-down-skin0000");
			this.dangerButtonUpTexture = this.atlas.getTexture("button-danger-up-skin0000");
			this.dangerButtonDownTexture = this.atlas.getTexture("button-danger-down-skin0000");
			this.dangerButtonDisabledTexture = this.atlas.getTexture("button-danger-disabled-skin0000");
			this.callToActionButtonUpTexture = this.atlas.getTexture("button-call-to-action-up-skin0000");
			this.callToActionButtonDownTexture = this.atlas.getTexture("button-call-to-action-down-skin0000");
			this.callToActionButtonDisabledTexture = this.atlas.getTexture("button-call-to-action-disabled-skin0000");
			this.backButtonUpTexture = this.atlas.getTexture("button-back-up-skin0000");
			this.backButtonDownTexture = this.atlas.getTexture("button-back-down-skin0000");
			this.backButtonDisabledTexture = this.atlas.getTexture("button-back-disabled-skin0000");
			this.forwardButtonUpTexture = this.atlas.getTexture("button-forward-up-skin0000");
			this.forwardButtonDownTexture = this.atlas.getTexture("button-forward-down-skin0000");
			this.forwardButtonDisabledTexture = this.atlas.getTexture("button-forward-disabled-skin0000");
			this.toggleButtonSelectedUpTexture = this.atlas.getTexture("toggle-button-selected-up-skin0000");
			this.toggleButtonSelectedDisabledTexture = this.atlas.getTexture("toggle-button-selected-disabled-skin0000");
			
			this.calloutTopArrowTexture = this.atlas.getTexture("callout-arrow-top-skin0000");
			this.calloutRightArrowTexture = this.atlas.getTexture("callout-arrow-right-skin0000");
			this.calloutBottomArrowTexture = this.atlas.getTexture("callout-arrow-bottom-skin0000");
			this.calloutLeftArrowTexture = this.atlas.getTexture("callout-arrow-left-skin0000");

			this.checkUpIconTexture = this.atlas.getTexture("check-up-icon0000");
			this.checkDownIconTexture = this.atlas.getTexture("check-down-icon0000");
			this.checkDisabledIconTexture = this.atlas.getTexture("check-disabled-icon0000");
			this.checkSelectedUpIconTexture = this.atlas.getTexture("check-selected-up-icon0000");
			this.checkSelectedDownIconTexture = this.atlas.getTexture("check-selected-down-icon0000");
			this.checkSelectedDisabledIconTexture = this.atlas.getTexture("check-selected-disabled-icon0000");

			this.headerBackgroundSkinTexture = this.atlas.getTexture("header-background-skin0000");

			this.itemRendererUpTexture = this.atlas.getTexture("list-item-up-skin0000");
			this.itemRendererDownTexture = this.atlas.getTexture("list-item-down-skin0000");
			this.itemRendererSelectedTexture = this.atlas.getTexture("list-item-selected-skin0000");
			this.firstItemRendererUpTexture = this.atlas.getTexture("list-first-item-up-skin0000");
			this.groupedListHeaderTexture = this.atlas.getTexture("grouped-list-header-skin0000");
			this.groupedListFooterTexture = this.atlas.getTexture("grouped-list-footer-skin0000");

			this.pageIndicatorNormalTexture = this.atlas.getTexture("page-indicator-normal-skin0000");
			this.pageIndicatorSelectedTexture = this.atlas.getTexture("page-indicator-selected-skin0000");

			this.pickerListButtonIcon = this.atlas.getTexture("picker-list-button-icon0000");
			this.pickerListButtonDisabledIcon = this.atlas.getTexture("picker-list-button-disabled-icon0000");
			
			this.horizontalProgressBarFillTexture = this.atlas.getTexture("progress-bar-horizontal-fill-skin0000");
			this.horizontalProgressBarFillDisabledTexture = this.atlas.getTexture("progress-bar-horizontal-fill-disabled-skin0000");
			this.horizontalProgressBarBackgroundTexture = this.atlas.getTexture("progress-bar-horizontal-background-skin0000");
			this.horizontalProgressBarBackgroundDisabledTexture = this.atlas.getTexture("progress-bar-horizontal-background-disabled-skin0000");
			this.verticalProgressBarFillTexture = this.atlas.getTexture("progress-bar-vertical-fill-skin0000");
			this.verticalProgressBarFillDisabledTexture = this.atlas.getTexture("progress-bar-vertical-fill-disabled-skin0000");
			this.verticalProgressBarBackgroundTexture = this.atlas.getTexture("progress-bar-vertical-background-skin0000");
			this.verticalProgressBarBackgroundDisabledTexture = this.atlas.getTexture("progress-bar-vertical-background-disabled-skin0000");

			this.radioUpIconTexture = this.atlas.getTexture("radio-up-icon0000");
			this.radioDownIconTexture = this.atlas.getTexture("radio-down-icon0000");
			this.radioDisabledIconTexture = this.atlas.getTexture("radio-disabled-icon0000");
			this.radioSelectedUpIconTexture = this.atlas.getTexture("radio-selected-up-icon0000");
			this.radioSelectedDownIconTexture = this.atlas.getTexture("radio-selected-down-icon0000");
			this.radioSelectedDisabledIconTexture = this.atlas.getTexture("radio-selected-disabled-icon0000");

			this.verticalSimpleScrollBarThumbTexture = this.atlas.getTexture("simple-scroll-bar-vertical-thumb-skin0000");
			this.horizontalSimpleScrollBarThumbTexture = this.atlas.getTexture("simple-scroll-bar-horizontal-thumb-skin0000");

			this.horizontalSliderMinimumTrackTexture = this.atlas.getTexture("slider-horizontal-minimum-track-skin0000");
			this.horizontalSliderMinimumTrackDisabledTexture = this.atlas.getTexture("slider-horizontal-minimum-track-disabled-skin0000");
			this.horizontalSliderMaximumTrackTexture = this.atlas.getTexture("slider-horizontal-maximum-track-skin0000");
			this.horizontalSliderMaximumTrackDisabledTexture = this.atlas.getTexture("slider-horizontal-maximum-track-disabled-skin0000");
			this.verticalSliderMinimumTrackTexture = this.atlas.getTexture("slider-vertical-minimum-track-skin0000");
			this.verticalSliderMinimumTrackDisabledTexture = this.atlas.getTexture("slider-vertical-minimum-track-disabled-skin0000");
			this.verticalSliderMaximumTrackTexture = this.atlas.getTexture("slider-vertical-maximum-track-skin0000");
			this.verticalSliderMaximumTrackDisabledTexture = this.atlas.getTexture("slider-vertical-maximum-track-disabled-skin0000");

			this.spinnerListSelectionOverlayTexture = this.atlas.getTexture("spinner-list-selection-overlay-skin0000");

			this.tabUpTexture = this.atlas.getTexture("tab-up-skin0000");
			this.tabDownTexture = this.atlas.getTexture("tab-down-skin0000");
			this.tabSelectedUpTexture = this.atlas.getTexture("tab-selected-up-skin0000");
			this.tabSelectedDisabledTexture = this.atlas.getTexture("tab-selected-disabled-skin0000");

			this.textInputBackgroundEnabledTexture = this.atlas.getTexture("text-input-up-skin0000");
			this.textInputBackgroundFocusedTexture = this.atlas.getTexture("text-input-focused-skin0000");
			this.textInputBackgroundErrorTexture = this.atlas.getTexture("text-input-error-skin0000");
			this.textInputBackgroundDisabledTexture = this.atlas.getTexture("text-input-disabled-skin0000");
			this.searchTextInputBackgroundEnabledTexture = this.atlas.getTexture("search-input-up-skin0000");
			this.searchTextInputBackgroundFocusedTexture = this.atlas.getTexture("search-input-focused-skin0000");
			this.searchTextInputBackgroundDisabledTexture = this.atlas.getTexture("search-input-disabled-skin0000");
			this.searchIconTexture = this.atlas.getTexture("search-input-icon0000");

			this.toggleSwitchOnTrackTexture = this.atlas.getTexture("toggle-switch-on-track-skin0000");
			this.toggleSwitchOnTrackDisabledTexture = this.atlas.getTexture("toggle-switch-on-track-disabled-skin0000");
			this.toggleSwitchOffTrackTexture = this.atlas.getTexture("toggle-switch-off-track-skin0000");
			this.toggleSwitchOffTrackDisabledTexture = this.atlas.getTexture("toggle-switch-off-track-disabled-skin0000");

			this.treeDisclosureOpenIconTexture = this.atlas.getTexture("tree-disclosure-open-icon0000");
			this.treeDisclosureClosedIconTexture = this.atlas.getTexture("tree-disclosure-closed-icon0000");

			this.dataGridHeaderTexture = this.atlas.getTexture("data-grid-header-skin0000");
			this.dataGridHeaderSortAscendingIconTexture = this.atlas.getTexture("data-grid-header-sort-ascending-icon0000");
			this.dataGridHeaderSortDescendingIconTexture = this.atlas.getTexture("data-grid-header-sort-descending-icon0000");
			this.dataGridColumnResizeSkinTexture = this.atlas.getTexture("data-grid-column-resize-skin0000");
			this.dataGridColumnDropIndicatorSkinTexture = this.atlas.getTexture("data-grid-column-drop-indicator-skin0000");
			this.dataGridHeaderDividerSkinTexture = this.atlas.getTexture("data-grid-header-divider-skin0000");

			this.dragHandleIconTexture = this.atlas.getTexture("drag-handle-icon0000");
		}

		protected function initializeFonts():void
		{
			this.darkFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, COLOR_TEXT_DARK, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.lightFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, COLOR_TEXT_LIGHT, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.selectedFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, COLOR_TEXT_SELECTED, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.darkDisabledFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, COLOR_TEXT_DARK_DISABLED, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.selectedDisabledFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, COLOR_TEXT_SELECTED_DISABLED, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.dangerDisabledFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, COLOR_TEXT_DANGER_DISABLED, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.actionDisabledFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, COLOR_TEXT_ACTION_DISABLED, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.darkCenteredFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, COLOR_TEXT_DARK, HorizontalAlign.CENTER, VerticalAlign.TOP);
			this.darkCenteredDisabledFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, COLOR_TEXT_DARK_DISABLED, HorizontalAlign.CENTER, VerticalAlign.TOP);
			this.lightBoldFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, COLOR_TEXT_LIGHT, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.lightBoldFontStyles.bold = true;
			this.selectedBoldFontStyles = new TextFormat(FONT_NAME, this.regularFontSize, COLOR_TEXT_SELECTED, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.selectedBoldFontStyles.bold = true;

			this.smallDarkFontStyles = new TextFormat(FONT_NAME, this.smallFontSize, COLOR_TEXT_DARK, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.smallSelectedFontStyles = new TextFormat(FONT_NAME, this.smallFontSize, COLOR_TEXT_SELECTED, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.smallDarkDisabledFontStyles = new TextFormat(FONT_NAME, this.smallFontSize, COLOR_TEXT_DARK_DISABLED, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.largeDarkFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, COLOR_TEXT_DARK, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.largeDarkDisabledFontStyles = new TextFormat(FONT_NAME, this.largeFontSize, COLOR_TEXT_DARK_DISABLED, HorizontalAlign.LEFT, VerticalAlign.TOP);

			this.darkScrollTextFontStyles = new TextFormat(FONT_NAME_STACK, this.regularFontSize, COLOR_TEXT_DARK, HorizontalAlign.LEFT, VerticalAlign.TOP);
			this.darkScrollTextDisabledFontStyles = new TextFormat(FONT_NAME_STACK, this.regularFontSize, COLOR_TEXT_DARK_DISABLED, HorizontalAlign.LEFT, VerticalAlign.TOP);
		}

		protected function initializeGlobals():void
		{
			FeathersControl.defaultTextRendererFactory = textRendererFactory;
			FeathersControl.defaultTextEditorFactory = textEditorFactory;

			PopUpManager.overlayFactory = popUpOverlayFactory;
			Callout.stagePadding = this.smallGutterSize;
			Toast.containerFactory = toastContainerFactory;
		}

		protected function initializeStyleProviders():void
		{
			//alert
			this.getStyleProviderForClass(Alert).defaultStyleFunction = this.setAlertStyles;
			this.getStyleProviderForClass(ButtonGroup).setFunctionForStyleName(Alert.DEFAULT_CHILD_STYLE_NAME_BUTTON_GROUP, this.setAlertButtonGroupStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_ALERT_BUTTON_GROUP_BUTTON, this.setAlertButtonGroupButtonStyles);
			this.getStyleProviderForClass(Header).setFunctionForStyleName(Alert.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setHeaderWithoutBackgroundStyles);

			//auto complete
			this.getStyleProviderForClass(AutoComplete).defaultStyleFunction = this.setTextInputStyles;
			this.getStyleProviderForClass(List).setFunctionForStyleName(AutoComplete.DEFAULT_CHILD_STYLE_NAME_LIST, this.setDropDownListStyles);

			//button
			this.getStyleProviderForClass(Button).defaultStyleFunction = this.setButtonStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_QUIET_BUTTON, this.setQuietButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_DANGER_BUTTON, this.setDangerButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_CALL_TO_ACTION_BUTTON, this.setCallToActionButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_BACK_BUTTON, this.setBackButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_FORWARD_BUTTON, this.setForwardButtonStyles);

			//button group
			this.getStyleProviderForClass(ButtonGroup).defaultStyleFunction = this.setButtonGroupStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ButtonGroup.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setButtonGroupButtonStyles);
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(ButtonGroup.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setButtonStyles);

			//callout
			this.getStyleProviderForClass(Callout).defaultStyleFunction = this.setCalloutStyles;

			//check
			this.getStyleProviderForClass(Check).defaultStyleFunction = this.setCheckStyles;

			//data grid
			this.getStyleProviderForClass(DataGrid).defaultStyleFunction = this.setDataGridStyles;
			this.getStyleProviderForClass(DefaultDataGridCellRenderer).defaultStyleFunction = this.setItemRendererStyles;
			this.getStyleProviderForClass(DefaultDataGridHeaderRenderer).defaultStyleFunction = this.setDataGridHeaderRendererStyles;

			//date time spinner
			this.getStyleProviderForClass(DateTimeSpinner).defaultStyleFunction = this.setDateTimeSpinnerStyles;
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER, this.setDateTimeSpinnerListItemRendererStyles);

			//drawers
			this.getStyleProviderForClass(Drawers).defaultStyleFunction = this.setDrawersStyles;

			//grouped list
			this.getStyleProviderForClass(GroupedList).defaultStyleFunction = this.setGroupedListStyles;
			this.getStyleProviderForClass(GroupedList).setFunctionForStyleName(GroupedList.ALTERNATE_STYLE_NAME_INSET_GROUPED_LIST, this.setInsetGroupedListStyles);
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).defaultStyleFunction = this.setItemRendererStyles;
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).defaultStyleFunction = this.setGroupedListHeaderRendererStyles;
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).setFunctionForStyleName(GroupedList.DEFAULT_CHILD_STYLE_NAME_FOOTER_RENDERER, this.setGroupedListFooterRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).setFunctionForStyleName(GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_HEADER_RENDERER, this.setGroupedListInsetHeaderRendererStyles);
			this.getStyleProviderForClass(DefaultGroupedListHeaderOrFooterRenderer).setFunctionForStyleName(GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_FOOTER_RENDERER, this.setGroupedListInsetFooterRendererStyles);
			//custom style for the first item in GroupedList (without highlight at the top)
			this.getStyleProviderForClass(DefaultGroupedListItemRenderer).setFunctionForStyleName(THEME_STYLE_NAME_GROUPED_LIST_FIRST_ITEM_RENDERER, this.setGroupedListFirstItemRendererStyles);

			//header
			this.getStyleProviderForClass(Header).defaultStyleFunction = this.setHeaderStyles;

			//label
			this.getStyleProviderForClass(Label).defaultStyleFunction = this.setLabelStyles;
			this.getStyleProviderForClass(Label).setFunctionForStyleName(Label.ALTERNATE_STYLE_NAME_HEADING, this.setHeadingLabelStyles);
			this.getStyleProviderForClass(Label).setFunctionForStyleName(Label.ALTERNATE_STYLE_NAME_DETAIL, this.setDetailLabelStyles);

			//layout group
			this.getStyleProviderForClass(LayoutGroup).setFunctionForStyleName(LayoutGroup.ALTERNATE_STYLE_NAME_TOOLBAR, this.setToolbarLayoutGroupStyles);

			//list
			this.getStyleProviderForClass(List).defaultStyleFunction = this.setListStyles;
			this.getStyleProviderForClass(DefaultListItemRenderer).defaultStyleFunction = this.setListItemRendererStyles;

			//numeric stepper
			this.getStyleProviderForClass(NumericStepper).defaultStyleFunction = this.setNumericStepperStyles;
			this.getStyleProviderForClass(TextInput).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_TEXT_INPUT, this.setNumericStepperTextInputStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_DECREMENT_BUTTON, this.setNumericStepperButtonStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(NumericStepper.DEFAULT_CHILD_STYLE_NAME_INCREMENT_BUTTON, this.setNumericStepperButtonStyles);

			//page indicator
			this.getStyleProviderForClass(PageIndicator).defaultStyleFunction = this.setPageIndicatorStyles;

			//panel
			this.getStyleProviderForClass(Panel).defaultStyleFunction = this.setPanelStyles;
			this.getStyleProviderForClass(Header).setFunctionForStyleName(Panel.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setHeaderWithoutBackgroundStyles);

			//panel screen
			this.getStyleProviderForClass(PanelScreen).defaultStyleFunction = this.setPanelScreenStyles;
			this.getStyleProviderForClass(Header).setFunctionForStyleName(PanelScreen.DEFAULT_CHILD_STYLE_NAME_HEADER, this.setPanelScreenHeaderStyles);

			//picker list
			this.getStyleProviderForClass(PickerList).defaultStyleFunction = this.setPickerListStyles;
			this.getStyleProviderForClass(List).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_LIST, this.setPickerListListStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(PickerList.DEFAULT_CHILD_STYLE_NAME_BUTTON, this.setPickerListButtonStyles);
			this.getStyleProviderForClass(Panel).setFunctionForStyleName(THEME_STYLE_NAME_POP_UP_DRAWER, this.setPickerListPopUpDrawerStyles);
			this.getStyleProviderForClass(Header).setFunctionForStyleName(THEME_STYLE_NAME_POP_UP_DRAWER_HEADER, this.setHeaderStyles);
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(THEME_STYLE_NAME_TABLET_PICKER_LIST_ITEM_RENDERER, this.setTabletPickerListItemRendererStyles);

			//progress bar
			this.getStyleProviderForClass(ProgressBar).defaultStyleFunction = this.setProgressBarStyles;

			//radio
			this.getStyleProviderForClass(Radio).defaultStyleFunction = this.setRadioStyles;

			//scroll container
			this.getStyleProviderForClass(ScrollContainer).defaultStyleFunction = this.setScrollContainerStyles;
			this.getStyleProviderForClass(ScrollContainer).setFunctionForStyleName(ScrollContainer.ALTERNATE_STYLE_NAME_TOOLBAR, this.setToolbarScrollContainerStyles);

			//scroll text
			this.getStyleProviderForClass(ScrollText).defaultStyleFunction = this.setScrollTextStyles;

			//simple scroll bar
			this.getStyleProviderForClass(SimpleScrollBar).defaultStyleFunction = this.setSimpleScrollBarStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SIMPLE_SCROLL_BAR_THUMB, this.setVerticalSimpleScrollBarThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SIMPLE_SCROLL_BAR_THUMB, this.setHorizontalSimpleScrollBarThumbStyles);

			//slider
			this.getStyleProviderForClass(Slider).defaultStyleFunction = this.setSliderStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SLIDER_THUMB, this.setHorizontalThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SLIDER_THUMB, this.setVerticalThumbStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK, this.setHorizontalSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_HORIZONTAL_SLIDER_MAXIMUM_TRACK, this.setHorizontalSliderMaximumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK, this.setVerticalSliderMinimumTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_VERTICAL_SLIDER_MAXIMUM_TRACK, this.setVerticalSliderMaximumTrackStyles);

			//spinner list
			this.getStyleProviderForClass(SpinnerList).defaultStyleFunction = this.setSpinnerListStyles;
			this.getStyleProviderForClass(DefaultListItemRenderer).setFunctionForStyleName(THEME_STYLE_NAME_SPINNER_LIST_ITEM_RENDERER, this.setSpinnerListItemRendererStyles);

			//tab bar
			this.getStyleProviderForClass(TabBar).defaultStyleFunction = this.setTabBarStyles;
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(TabBar.DEFAULT_CHILD_STYLE_NAME_TAB, this.setTabStyles);

			//text input
			this.getStyleProviderForClass(TextInput).defaultStyleFunction = this.setTextInputStyles;
			this.getStyleProviderForClass(TextInput).setFunctionForStyleName(TextInput.ALTERNATE_STYLE_NAME_SEARCH_TEXT_INPUT, this.setSearchTextInputStyles);

			//text area
			this.getStyleProviderForClass(TextArea).defaultStyleFunction = this.setTextAreaStyles;

			//text callout
			this.getStyleProviderForClass(TextCallout).defaultStyleFunction = this.setTextCalloutStyles;

			//toast
			this.getStyleProviderForClass(Toast).defaultStyleFunction = this.setToastStyles;
			this.getStyleProviderForClass(ButtonGroup).setFunctionForStyleName(Toast.DEFAULT_CHILD_STYLE_NAME_ACTIONS, this.setToastActionsStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON, this.setToastActionsButtonStyles);

			//toggle button
			this.getStyleProviderForClass(ToggleButton).defaultStyleFunction = this.setToggleButtonStyles;
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(Button.ALTERNATE_STYLE_NAME_QUIET_BUTTON, this.setQuietButtonStyles);

			//toggle switch
			this.getStyleProviderForClass(ToggleSwitch).defaultStyleFunction = this.setToggleSwitchStyles;
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_ON_TRACK, this.setToggleSwitchOnTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_OFF_TRACK, this.setToggleSwitchOffTrackStyles);
			this.getStyleProviderForClass(Button).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setHorizontalThumbStyles);
			this.getStyleProviderForClass(ToggleButton).setFunctionForStyleName(ToggleSwitch.DEFAULT_CHILD_STYLE_NAME_THUMB, this.setHorizontalThumbStyles);

			//tree
			this.getStyleProviderForClass(Tree).defaultStyleFunction = this.setTreeStyles;
			this.getStyleProviderForClass(DefaultTreeItemRenderer).defaultStyleFunction = this.setTreeItemRendererStyles;
		}

		protected static function textRendererFactory():ITextRenderer
		{
			return new TextBlockTextRenderer();
		}
		
		protected static function textEditorFactory():ITextEditor
		{
			return new StageTextTextEditor();
		}
		
		protected static function textAreaTextEditorFactory():ITextEditorViewPort
		{
			return new TextFieldTextEditorViewPort();
		}

		protected static function popUpOverlayFactory():DisplayObject
		{
			var quad:Quad = new Quad(10, 10, COLOR_MODAL_OVERLAY);
			quad.alpha = ALPHA_MODAL_OVERLAY;
			return quad;
		}

		protected static function scrollBarFactory():SimpleScrollBar
		{
			return new SimpleScrollBar();
		}

		protected static function stepperTextEditorFactory():TextBlockTextEditor
		{
			/* We are only using this text editor in the NumericStepper because
			 * isEditable is false on the TextInput. this text editor is not
			 * suitable for mobile use if the TextInput needs to be editable
			 * because it can't use the soft keyboard or other mobile-friendly UI */
			return new TextBlockTextEditor();
		}
		
		protected static function pickerListSpinnerListFactory():SpinnerList
		{
			return new SpinnerList();
		}

		protected function pageIndicatorNormalSymbolFactory():DisplayObject
		{
			var symbol:ImageLoader = new ImageLoader();
			symbol.source = this.pageIndicatorNormalTexture;
			return symbol;
		}

		protected function pageIndicatorSelectedSymbolFactory():DisplayObject
		{
			var symbol:ImageLoader = new ImageLoader();
			symbol.source = this.pageIndicatorSelectedTexture;
			return symbol;
		}

		protected function dataGridHeaderDividerFactory():DisplayObject
		{
			var skin:ImageSkin = new ImageSkin(this.dataGridHeaderDividerSkinTexture);
			skin.scale9Grid = DATA_GRID_HEADER_DIVIDER_SCALE_9_GRID;
			skin.minTouchWidth = this.controlSize;
			return skin;
		}

		protected function toastContainerFactory():DisplayObjectContainer
		{
			var container:LayoutGroup = new LayoutGroup();
			container.autoSizeMode = AutoSizeMode.STAGE;

			var layout:VerticalLayout = new VerticalLayout();
			layout.verticalAlign = VerticalAlign.BOTTOM;
			if(DeviceCapabilities.isPhone())
			{
				layout.horizontalAlign = HorizontalAlign.JUSTIFY;
			}
			else
			{
				layout.horizontalAlign = HorizontalAlign.LEFT;
				layout.padding = this.gutterSize;
				layout.gap = this.gutterSize;
			}
			container.layout = layout;
			return container;
		}

	//-------------------------
	// Shared
	//-------------------------

		protected function setScrollerStyles(scroller:Scroller):void
		{
			scroller.verticalScrollBarFactory = scrollBarFactory;
			scroller.horizontalScrollBarFactory = scrollBarFactory;
		}

		protected function setDropDownListStyles(list:List):void
		{
			var backgroundSkin:Quad = new Quad(10, 10, COLOR_SPINNER_LIST_BACKGROUND);
			list.backgroundSkin = backgroundSkin;

			var layout:VerticalLayout = new VerticalLayout();
			layout.horizontalAlign = HorizontalAlign.JUSTIFY;
			layout.maxRowCount = 4;
			list.layout = layout;
		}

	//-------------------------
	// Alert
	//-------------------------

		protected function setAlertStyles(alert:Alert):void
		{
			this.setScrollerStyles(alert);

			var backgroundSkin:Image = new Image(this.popUpBackgroundTexture);
			backgroundSkin.scale9Grid = BACKGROUND_POPUP_SCALE9_GRID;
			alert.backgroundSkin = backgroundSkin;

			alert.fontStyles = this.darkFontStyles.clone();
			alert.disabledFontStyles = this.darkDisabledFontStyles.clone();

			alert.paddingTop = 0;
			alert.paddingRight = this.gutterSize;
			alert.paddingBottom = this.gutterSize;
			alert.paddingLeft = this.gutterSize;
			alert.gap = this.gutterSize;
			alert.maxWidth = this.popUpFillSize;
			alert.maxHeight = this.popUpFillSize;
		}

		//see Panel section for Header styles

		protected function setAlertButtonGroupStyles(group:ButtonGroup):void
		{
			group.direction = Direction.HORIZONTAL;
			group.horizontalAlign = HorizontalAlign.CENTER;
			group.verticalAlign = VerticalAlign.JUSTIFY;
			group.distributeButtonSizes = false;
			group.gap = this.gutterSize;
			group.padding = this.gutterSize;
			group.paddingTop = 0;
			group.customLastButtonStyleName = THEME_STYLE_NAME_ALERT_BUTTON_GROUP_LAST_BUTTON;
			group.customButtonStyleName = THEME_STYLE_NAME_ALERT_BUTTON_GROUP_BUTTON;
		}

		protected function setAlertButtonGroupButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledTexture);
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				skin.selectedTexture = this.toggleButtonSelectedUpTexture;
				skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.toggleButtonSelectedDisabledTexture);
			}
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize * 2;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.darkFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

	//-------------------------
	// Button
	//-------------------------

		protected function setBaseButtonStyles(button:Button):void
		{
			button.paddingBottom = this.smallGutterSize;
			button.paddingTop = this.smallGutterSize;
			button.paddingRight = this.gutterSize;
			button.paddingLeft = this.gutterSize;
			button.gap = this.smallGutterSize;
		}

		protected function setButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledTexture);
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				skin.selectedTexture = this.toggleButtonSelectedUpTexture;
				skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.toggleButtonSelectedDisabledTexture);
			}
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.darkFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setQuietButtonStyles(button:Button):void
		{
			var downSkin:Image = new Image(this.quietButtonDownTexture);
			downSkin.scale9Grid = BUTTON_SCALE9_GRID;
			button.setSkinForState(ButtonState.DOWN, downSkin);

			var defaultSkin:Quad = new Quad(this.controlSize, this.controlSize, 0xff00ff);
			defaultSkin.alpha = 0;
			button.defaultSkin = defaultSkin;

			button.fontStyles = this.darkFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setDangerButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.dangerButtonUpTexture);
			skin.setTextureForState(ButtonState.DOWN, this.dangerButtonDownTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.dangerButtonDisabledTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.lightFontStyles.clone();
			button.disabledFontStyles = this.dangerDisabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setCallToActionButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.callToActionButtonUpTexture);
			skin.setTextureForState(ButtonState.DOWN, this.callToActionButtonDownTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.callToActionButtonDisabledTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.lightFontStyles.clone();
			button.disabledFontStyles = this.actionDisabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

		protected function setBackButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.backButtonUpTexture);
			skin.setTextureForState(ButtonState.DOWN, this.backButtonDownTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.backButtonDisabledTexture);
			skin.scale9Grid = BACK_BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.darkFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledFontStyles.clone();

			this.setBaseButtonStyles(button);

			button.paddingLeft = this.gutterSize + this.smallGutterSize;
		}

		protected function setForwardButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.forwardButtonUpTexture);
			skin.setTextureForState(ButtonState.DOWN, this.forwardButtonDownTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.forwardButtonDisabledTexture);
			skin.scale9Grid = FORWARD_BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.darkFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledFontStyles.clone();

			setBaseButtonStyles(button);

			button.paddingRight = this.gutterSize + this.smallGutterSize;
		}

	//-------------------------
	// ButtonGroup
	//-------------------------

		protected function setButtonGroupStyles(group:ButtonGroup):void
		{
			group.gap = this.smallGutterSize;
		}

		protected function setButtonGroupButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledTexture);
			if(button is ToggleButton)
			{
				//for convenience, this function can style both a regular button
				//and a toggle button
				skin.selectedTexture = this.toggleButtonSelectedUpTexture;
				skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.toggleButtonSelectedDisabledTexture);
			}
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.wideControlSize;
			skin.minHeight = this.controlSize;
			button.defaultSkin = skin;

			button.fontStyles = this.darkFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledFontStyles.clone();

			this.setBaseButtonStyles(button);
		}

	//-------------------------
	// Callout
	//-------------------------

		protected function setCalloutStyles(callout:Callout):void
		{
			var backgroundSkin:Image = new Image(this.popUpBackgroundTexture);
			backgroundSkin.scale9Grid = BACKGROUND_POPUP_SCALE9_GRID;
			backgroundSkin.width = this.calloutBackgroundMinSize;
			backgroundSkin.height = this.calloutBackgroundMinSize;
			callout.backgroundSkin = backgroundSkin;

			var topArrowSkin:Image = new Image(this.calloutTopArrowTexture);
			callout.topArrowSkin = topArrowSkin;
			callout.topArrowGap = this.calloutVerticalArrowGap;

			var rightArrowSkin:Image = new Image(this.calloutRightArrowTexture);
			callout.rightArrowSkin = rightArrowSkin;
			callout.rightArrowGap = this.calloutHorizontalArrowGap;

			var bottomArrowSkin:Image = new Image(this.calloutBottomArrowTexture);
			callout.bottomArrowSkin = bottomArrowSkin;
			callout.bottomArrowGap = this.calloutVerticalArrowGap;

			var leftArrowSkin:Image = new Image(this.calloutLeftArrowTexture);
			callout.leftArrowSkin = leftArrowSkin;
			callout.leftArrowGap = this.calloutHorizontalArrowGap;

			callout.padding = this.gutterSize;
		}

	//-------------------------
	// Check
	//-------------------------

		protected function setCheckStyles(check:Check):void
		{
			var icon:ImageSkin = new ImageSkin(this.checkUpIconTexture);
			icon.selectedTexture = this.checkSelectedUpIconTexture;
			icon.setTextureForState(ButtonState.DOWN, this.checkDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED, this.checkDisabledIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.checkSelectedDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.checkSelectedDisabledIconTexture);
			check.defaultIcon = icon;

			check.fontStyles = this.darkFontStyles.clone();
			check.disabledFontStyles = this.darkDisabledFontStyles.clone();

			check.gap = this.smallGutterSize;
		}

	//-------------------------
	// DataGrid
	//-------------------------

		protected function setDataGridStyles(grid:DataGrid):void
		{
			this.setScrollerStyles(grid);
			grid.backgroundSkin = new Quad(10, 10, COLOR_BACKGROUND_LIGHT);

			var columnResizeSkin:ImageSkin = new ImageSkin(this.dataGridColumnResizeSkinTexture);
			columnResizeSkin.scale9Grid = DATA_GRID_COLUMN_RESIZE_SCALE_9_GRID;
			grid.columnResizeSkin = columnResizeSkin;

			var columnDropIndicatorSkin:ImageSkin = new ImageSkin(this.dataGridColumnDropIndicatorSkinTexture);
			columnDropIndicatorSkin.scale9Grid = DATA_GRID_COLUMN_DROP_INDICATOR_SCALE_9_GRID;
			grid.columnDropIndicatorSkin = columnDropIndicatorSkin;
			grid.extendedColumnDropIndicator = true;

			var columnDragOverlaySkin:Quad = new Quad(1, 1, COLOR_DATA_GRID_DRAG_OVERLAY);
			columnDragOverlaySkin.alpha = ALPHA_DATA_GRID_DRAG_OVERLAY;
			grid.columnDragOverlaySkin = columnDragOverlaySkin;

			grid.headerDividerFactory = this.dataGridHeaderDividerFactory;
		}

		protected function setDataGridHeaderRendererStyles(headerRenderer:DefaultDataGridHeaderRenderer):void
		{
			var backgroundSkin:Image = new Image(this.dataGridHeaderTexture);
			backgroundSkin.scale9Grid = DATA_GRID_HEADER_SCALE9_GRID;
			headerRenderer.backgroundSkin = backgroundSkin;

			headerRenderer.sortAscendingIcon = new ImageSkin(this.dataGridHeaderSortAscendingIconTexture);
			headerRenderer.sortDescendingIcon = new ImageSkin(this.dataGridHeaderSortDescendingIconTexture);

			headerRenderer.fontStyles = this.smallDarkFontStyles.clone();
			headerRenderer.disabledFontStyles = this.smallDarkDisabledFontStyles.clone();

			headerRenderer.horizontalAlign = HorizontalAlign.LEFT;
			headerRenderer.paddingTop = this.smallGutterSize;
			headerRenderer.paddingRight = this.gutterSize;
			headerRenderer.paddingBottom = this.smallGutterSize;
			headerRenderer.paddingLeft = this.gutterSize;
		}

	//-------------------------
	// DateTimeSpinner
	//-------------------------

		protected function setDateTimeSpinnerStyles(spinner:DateTimeSpinner):void
		{
			spinner.customItemRendererStyleName = THEME_STYLE_NAME_DATE_TIME_SPINNER_LIST_ITEM_RENDERER;
		}

		protected function setDateTimeSpinnerListItemRendererStyles(itemRenderer:DefaultListItemRenderer):void
		{
			this.setSpinnerListItemRendererStyles(itemRenderer);

			itemRenderer.paddingLeft = this.smallGutterSize;
			itemRenderer.paddingRight = this.smallGutterSize;
			itemRenderer.gap = this.extraSmallGutterSize;
			itemRenderer.minGap = this.extraSmallGutterSize;
			itemRenderer.accessoryGap = this.extraSmallGutterSize;
			itemRenderer.minAccessoryGap = this.extraSmallGutterSize;
			itemRenderer.accessoryPosition = RelativePosition.LEFT;
		}

	//-------------------------
	// Drawers
	//-------------------------

		protected function setDrawersStyles(drawers:Drawers):void
		{
			var overlaySkin:Quad = new Quad(10, 10, COLOR_DRAWER_OVERLAY);
			overlaySkin.alpha = ALPHA_DRAWER_OVERLAY;
			drawers.overlaySkin = overlaySkin;

			var topDrawerDivider:Quad = new Quad(this.borderSize, this.borderSize, COLOR_DRAWERS_DIVIDER);
			drawers.topDrawerDivider = topDrawerDivider;

			var rightDrawerDivider:Quad = new Quad(this.borderSize, this.borderSize, COLOR_DRAWERS_DIVIDER);
			drawers.rightDrawerDivider = rightDrawerDivider;

			var bottomDrawerDivider:Quad = new Quad(this.borderSize, this.borderSize, COLOR_DRAWERS_DIVIDER);
			drawers.bottomDrawerDivider = bottomDrawerDivider;

			var leftDrawerDivider:Quad = new Quad(this.borderSize, this.borderSize, COLOR_DRAWERS_DIVIDER);
			drawers.leftDrawerDivider = leftDrawerDivider;
		}

	//-------------------------
	// GroupedList
	//-------------------------

		protected function setGroupedListStyles(list:GroupedList):void
		{
			this.setScrollerStyles(list);
			list.backgroundSkin = new Quad(10, 10, COLOR_BACKGROUND_LIGHT);
			list.customFirstItemRendererStyleName = THEME_STYLE_NAME_GROUPED_LIST_FIRST_ITEM_RENDERER;
		}

		protected function setInsetGroupedListStyles(list:GroupedList):void
		{
			this.setGroupedListStyles(list);
			list.customHeaderRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_HEADER_RENDERER;
			list.customFooterRendererStyleName = GroupedList.ALTERNATE_CHILD_STYLE_NAME_INSET_FOOTER_RENDERER;
		}

		//see List section for item renderer styles

		protected function setGroupedListFirstItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.firstItemRendererUpTexture);
			skin.selectedTexture = this.itemRendererSelectedTexture;
			skin.setTextureForState(ButtonState.DOWN, this.itemRendererDownTexture);
			skin.scale9Grid = LIST_ITEM_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			itemRenderer.defaultSkin = skin;

			itemRenderer.fontStyles = this.darkFontStyles.clone();
			itemRenderer.disabledFontStyles = this.darkDisabledFontStyles.clone();

			itemRenderer.iconLabelFontStyles = this.smallDarkFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.smallDarkDisabledFontStyles.clone();

			itemRenderer.accessoryLabelFontStyles = this.smallDarkFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.smallDarkDisabledFontStyles.clone();

			this.setBaseItemRendererStyles(itemRenderer);
		}

		protected function setGroupedListHeaderRendererStyles(headerRenderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			var backgroundSkin:Image = new Image(this.groupedListHeaderTexture);
			backgroundSkin.scale9Grid = GROUPED_LIST_HEADER_OR_FOOTER_SCALE9_GRID;
			headerRenderer.backgroundSkin = backgroundSkin;

			headerRenderer.fontStyles = this.smallDarkFontStyles.clone();
			headerRenderer.disabledFontStyles = this.smallDarkDisabledFontStyles.clone();

			headerRenderer.horizontalAlign = HorizontalAlign.LEFT;
			headerRenderer.paddingTop = this.smallGutterSize;
			headerRenderer.paddingRight = this.gutterSize;
			headerRenderer.paddingBottom = this.smallGutterSize;
			headerRenderer.paddingLeft = this.gutterSize;
		}

		protected function setGroupedListInsetHeaderRendererStyles(headerRenderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			headerRenderer.fontStyles = this.smallDarkFontStyles.clone();
			headerRenderer.disabledFontStyles = this.smallDarkDisabledFontStyles.clone();

			headerRenderer.horizontalAlign = HorizontalAlign.LEFT;
			headerRenderer.paddingTop = this.gutterSize;
			headerRenderer.paddingRight = this.gutterSize;
			headerRenderer.paddingBottom = this.smallGutterSize;
			headerRenderer.paddingLeft = this.gutterSize;
		}

		protected function setGroupedListFooterRendererStyles(footerRenderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			var backgroundSkin:Image = new Image(this.groupedListFooterTexture);
			backgroundSkin.scale9Grid = GROUPED_LIST_HEADER_OR_FOOTER_SCALE9_GRID;
			footerRenderer.backgroundSkin = backgroundSkin;

			footerRenderer.fontStyles = this.smallDarkFontStyles.clone();
			footerRenderer.disabledFontStyles = this.smallDarkDisabledFontStyles.clone();

			footerRenderer.horizontalAlign = HorizontalAlign.CENTER;
			footerRenderer.paddingTop = this.smallGutterSize;
			footerRenderer.paddingRight = this.gutterSize;
			footerRenderer.paddingBottom = this.smallGutterSize;
			footerRenderer.paddingLeft = this.gutterSize;
		}

		protected function setGroupedListInsetFooterRendererStyles(footerRenderer:DefaultGroupedListHeaderOrFooterRenderer):void
		{
			footerRenderer.fontStyles = this.darkFontStyles.clone();
			footerRenderer.disabledFontStyles = this.darkDisabledFontStyles.clone();

			footerRenderer.horizontalAlign = HorizontalAlign.LEFT;
			footerRenderer.paddingTop = this.smallGutterSize;
			footerRenderer.paddingRight = this.gutterSize;
			footerRenderer.paddingBottom = this.gutterSize;
			footerRenderer.paddingLeft = this.gutterSize;
		}

	//-------------------------
	// Header
	//-------------------------

		protected function setHeaderStyles(header:Header):void
		{
			this.setHeaderWithoutBackgroundStyles(header);

			header.fontStyles = this.largeDarkFontStyles.clone();
			header.disabledFontStyles = this.largeDarkDisabledFontStyles.clone();

			var backgroundSkin:Image = new Image(this.headerBackgroundSkinTexture);
			backgroundSkin.scale9Grid = HEADER_BACKGROUND_SCALE9_GRID;
			backgroundSkin.width = this.gridSize;
			backgroundSkin.height = this.gridSize;
			header.backgroundSkin = backgroundSkin;
		}

	//-------------------------
	// Label
	//-------------------------

		protected function setLabelStyles(label:Label):void
		{
			label.fontStyles = this.darkFontStyles.clone();
			label.disabledFontStyles = this.darkDisabledFontStyles.clone();
		}

		protected function setHeadingLabelStyles(label:Label):void
		{
			label.fontStyles = this.largeDarkFontStyles.clone();
			label.disabledFontStyles = this.largeDarkDisabledFontStyles.clone();
		}

		protected function setDetailLabelStyles(label:Label):void
		{
			label.fontStyles = this.smallDarkFontStyles.clone();
			label.disabledFontStyles = this.smallDarkDisabledFontStyles.clone();
		}

	//-------------------------
	// LayoutGroup
	//-------------------------

		protected function setToolbarLayoutGroupStyles(group:LayoutGroup):void
		{
			if(!group.layout)
			{
				var layout:HorizontalLayout = new HorizontalLayout();
				layout.paddingTop = this.smallGutterSize;
				layout.paddingRight = this.smallGutterSize;
				layout.paddingBottom = this.smallGutterSize;
				layout.paddingLeft = this.smallGutterSize;
				layout.gap = this.smallGutterSize;
				group.layout = layout;
			}

			group.backgroundSkin = new Quad(this.controlSize, this.controlSize, COLOR_BACKGROUND_LIGHT);
		}

	//-------------------------
	// List
	//-------------------------

		protected function setListStyles(list:List):void
		{
			this.setScrollerStyles(list);
			list.backgroundSkin = new Quad(10, 10, COLOR_BACKGROUND_LIGHT);

			var dropIndicatorSkin:Quad = new Quad(this.borderSize, this.borderSize, COLOR_TEXT_DARK);
			list.dropIndicatorSkin = dropIndicatorSkin;
		}

		protected function setListItemRendererStyles(itemRenderer:DefaultListItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			var dragIcon:ImageSkin = new ImageSkin(this.dragHandleIconTexture);
			dragIcon.minTouchWidth = this.gridSize;
			dragIcon.minTouchHeight = this.gridSize;
			itemRenderer.dragIcon = dragIcon;
		}

		protected function setBaseItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;
			itemRenderer.paddingTop = this.smallGutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.paddingBottom = this.smallGutterSize;
			itemRenderer.paddingLeft = this.gutterSize;
			itemRenderer.gap = this.gutterSize;
			itemRenderer.minGap = this.gutterSize;
			itemRenderer.iconPosition = RelativePosition.LEFT;
			itemRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			itemRenderer.minAccessoryGap = this.gutterSize;
			itemRenderer.accessoryPosition = RelativePosition.RIGHT;
			itemRenderer.minTouchWidth = this.controlSize;
			itemRenderer.minTouchHeight = this.controlSize;
		}

		protected function setItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.itemRendererUpTexture);
			skin.selectedTexture = this.itemRendererSelectedTexture;
			skin.setTextureForState(ButtonState.DOWN, this.itemRendererDownTexture);
			skin.scale9Grid = LIST_ITEM_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			itemRenderer.defaultSkin = skin;

			itemRenderer.fontStyles = this.darkFontStyles.clone();
			itemRenderer.disabledFontStyles = this.darkDisabledFontStyles.clone();

			itemRenderer.iconLabelFontStyles = this.smallDarkFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.smallDarkDisabledFontStyles.clone();

			itemRenderer.accessoryLabelFontStyles = this.smallDarkFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.smallDarkDisabledFontStyles.clone();

			this.setBaseItemRendererStyles(itemRenderer);
		}

	//-------------------------
	// NumericStepper
	//-------------------------

		protected function setNumericStepperStyles(stepper:NumericStepper):void
		{
			stepper.buttonLayoutMode = StepperButtonLayoutMode.SPLIT_HORIZONTAL;
			stepper.incrementButtonLabel = "+";
			stepper.decrementButtonLabel = "-";
		}

		protected function setNumericStepperTextInputStyles(input:TextInput):void
		{
			var skin:ImageSkin = new ImageSkin(this.textInputBackgroundEnabledTexture);
			skin.disabledTexture = this.textInputBackgroundDisabledTexture;
			skin.scale9Grid = TEXT_INPUT_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.controlSize;
			input.backgroundSkin = skin;

			input.textEditorFactory = stepperTextEditorFactory;
			input.fontStyles = this.darkCenteredFontStyles.clone();
			input.disabledFontStyles = this.darkCenteredDisabledFontStyles.clone();

			input.padding = this.smallGutterSize;
			input.isEditable = false;
			input.isSelectable = false;
		}

		protected function setNumericStepperButtonStyles(button:Button):void
		{
			setQuietButtonStyles(button);

			button.keepDownStateOnRollOut = true;

			button.fontStyles = this.largeDarkFontStyles.clone();
			button.disabledFontStyles = this.largeDarkDisabledFontStyles.clone();
		}

	//-------------------------
	// PageIndicator
	//-------------------------

		protected function setPageIndicatorStyles(pageIndicator:PageIndicator):void
		{
			pageIndicator.normalSymbolFactory = pageIndicatorNormalSymbolFactory;
			pageIndicator.selectedSymbolFactory = pageIndicatorSelectedSymbolFactory;
			pageIndicator.gap = this.gutterSize;
			pageIndicator.padding = this.gutterSize;
			pageIndicator.minTouchWidth = this.controlSize;
			pageIndicator.minTouchHeight = this.controlSize;
		}

	//-------------------------
	// Panel
	//-------------------------

		protected function setPanelStyles(panel:Panel):void
		{
			this.setScrollerStyles(panel);

			var backgroundSkin:Image = new Image(this.popUpBackgroundTexture);
			backgroundSkin.scale9Grid = BACKGROUND_POPUP_SCALE9_GRID;
			panel.backgroundSkin = backgroundSkin;

			panel.paddingTop = this.smallGutterSize;
			panel.paddingRight = this.smallGutterSize;
			panel.paddingBottom = this.smallGutterSize;
			panel.paddingLeft = this.smallGutterSize;
		}

		protected function setHeaderWithoutBackgroundStyles(header:Header):void
		{
			header.fontStyles = this.largeDarkFontStyles.clone();
			header.disabledFontStyles = this.largeDarkDisabledFontStyles.clone();

			header.gap = this.gutterSize;
			header.paddingTop = this.smallGutterSize;
			header.paddingRight = this.smallGutterSize;
			header.paddingBottom = this.smallGutterSize;
			header.paddingLeft = this.smallGutterSize;
			header.titleGap = this.smallGutterSize;
			header.minHeight = this.gridSize;
		}

	//-------------------------
	// PanelScreen
	//-------------------------

		protected function setPanelScreenStyles(screen:PanelScreen):void
		{
			this.setScrollerStyles(screen);
		}

		protected function setPanelScreenHeaderStyles(header:Header):void
		{
			this.setHeaderStyles(header);

			header.useExtraPaddingForOSStatusBar = true;
		}

	//-------------------------
	// PickerList
	//-------------------------

		protected function setPickerListStyles(list:PickerList):void
		{
			if(DeviceCapabilities.isPhone(this.starling.nativeStage))
			{
				list.listFactory = pickerListSpinnerListFactory;

				var popUpContentManager:BottomDrawerPopUpContentManager = new BottomDrawerPopUpContentManager();
				popUpContentManager.customPanelStyleName = THEME_STYLE_NAME_POP_UP_DRAWER;
				list.popUpContentManager = popUpContentManager;
			}
			else
			{
				list.popUpContentManager = new CalloutPopUpContentManager();
				list.customItemRendererStyleName = THEME_STYLE_NAME_TABLET_PICKER_LIST_ITEM_RENDERER;
			}
		}

		protected function setPickerListButtonStyles(button:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpTexture);
			skin.setTextureForState(ButtonState.DOWN, this.buttonDownTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			button.defaultSkin = skin;

			var icon:ImageSkin = new ImageSkin(this.pickerListButtonIcon);
			icon.disabledTexture = this.pickerListButtonDisabledIcon;
			button.defaultIcon = icon;

			button.fontStyles = this.darkFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledFontStyles.clone();

			this.setBaseButtonStyles(button);

			button.gap = Number.POSITIVE_INFINITY;
			button.minGap = this.gutterSize;
			button.iconPosition = RelativePosition.RIGHT;
			button.paddingLeft = this.gutterSize;
		}

		protected function setPickerListListStyles(list:List):void
		{
			this.setDropDownListStyles(list);
		}

		protected function setTabletPickerListItemRendererStyles(itemRenderer:BaseDefaultItemRenderer):void
		{
			var skin:ImageSkin = new ImageSkin(this.itemRendererUpTexture);
			skin.selectedTexture = this.itemRendererSelectedTexture;
			skin.setTextureForState(ButtonState.DOWN, this.itemRendererDownTexture);
			skin.scale9Grid = LIST_ITEM_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.popUpFillSize;
			skin.minHeight = this.controlSize;
			itemRenderer.defaultSkin = skin;

			itemRenderer.fontStyles = this.darkFontStyles.clone();
			itemRenderer.disabledFontStyles = this.darkDisabledFontStyles.clone();

			itemRenderer.iconLabelFontStyles = this.smallDarkFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.smallDarkDisabledFontStyles.clone();

			itemRenderer.accessoryLabelFontStyles = this.smallDarkFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.smallDarkDisabledFontStyles.clone();

			this.setBaseItemRendererStyles(itemRenderer);
		}

		protected function setPickerListPopUpDrawerStyles(panel:Panel):void
		{
			this.setScrollerStyles(panel);

			panel.customHeaderStyleName = THEME_STYLE_NAME_POP_UP_DRAWER_HEADER;

			var backgroundSkin:Image = new Image(this.popUpDrawerBackgroundTexture);
			backgroundSkin.scale9Grid = POP_UP_DRAWER_BACKGROUND_SCALE9_GRID;
			panel.backgroundSkin = backgroundSkin;

			panel.outerPaddingTop = this.shadowSize;
		}

	//-------------------------
	// ProgressBar
	//-------------------------

		protected function setProgressBarStyles(progress:ProgressBar):void
		{
			var backgroundSkin:Image;
			var backgroundDisabledSkin:Image;
			/* Horizontal background skin */
			if(progress.direction === Direction.HORIZONTAL)
			{
				backgroundSkin = new Image(this.horizontalProgressBarBackgroundTexture);
				backgroundSkin.scale9Grid = BAR_HORIZONTAL_SCALE9_GRID;
				backgroundSkin.width = this.wideControlSize;
				backgroundSkin.height = this.smallControlSize;
				backgroundDisabledSkin = new Image(this.horizontalProgressBarBackgroundDisabledTexture);
				backgroundDisabledSkin.scale9Grid = BAR_HORIZONTAL_SCALE9_GRID;
				backgroundDisabledSkin.width = this.wideControlSize;
				backgroundDisabledSkin.height = this.smallControlSize;
			}
			else //vertical
			{
				backgroundSkin = new Image(this.verticalProgressBarBackgroundTexture);
				backgroundSkin.scale9Grid = BAR_VERTICAL_SCALE9_GRID;
				backgroundSkin.width = this.smallControlSize;
				backgroundSkin.height = this.wideControlSize;
				backgroundDisabledSkin = new Image(this.verticalProgressBarBackgroundDisabledTexture);
				backgroundDisabledSkin.scale9Grid = BAR_VERTICAL_SCALE9_GRID;
				backgroundDisabledSkin.width = this.smallControlSize;
				backgroundDisabledSkin.height = this.wideControlSize;
			}
			progress.backgroundSkin = backgroundSkin;
			progress.backgroundDisabledSkin = backgroundDisabledSkin;

			var fillSkin:Image;
			var fillDisabledSkin:Image;
			/* Horizontal fill skin */
			if(progress.direction === Direction.HORIZONTAL)
			{
				fillSkin = new Image(this.horizontalProgressBarFillTexture);
				fillSkin.scale9Grid = BAR_HORIZONTAL_SCALE9_GRID;
				fillSkin.width = this.smallControlSize;
				fillSkin.height = this.smallControlSize;
				fillDisabledSkin = new Image(this.horizontalProgressBarFillDisabledTexture);
				fillDisabledSkin.scale9Grid = BAR_HORIZONTAL_SCALE9_GRID;
				fillDisabledSkin.width = this.smallControlSize;
				fillDisabledSkin.height = this.smallControlSize;
			}
			else //vertical
			{
				fillSkin = new Image(this.verticalProgressBarFillTexture);
				fillSkin.scale9Grid = BAR_VERTICAL_SCALE9_GRID;
				fillSkin.width = this.smallControlSize;
				fillSkin.height = this.smallControlSize;
				fillDisabledSkin = new Image(verticalProgressBarFillDisabledTexture);
				fillDisabledSkin.scale9Grid = BAR_VERTICAL_SCALE9_GRID;
				fillDisabledSkin.width = this.smallControlSize;
				fillDisabledSkin.height = this.smallControlSize;
			}
			progress.fillSkin = fillSkin;
			progress.fillDisabledSkin = fillDisabledSkin;
		}

	//-------------------------
	// Radio
	//-------------------------

		protected function setRadioStyles(radio:Radio):void
		{
			var icon:ImageSkin = new ImageSkin(this.radioUpIconTexture);
			icon.selectedTexture = this.radioSelectedUpIconTexture;
			icon.setTextureForState(ButtonState.DOWN, this.radioDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED, this.radioDisabledIconTexture);
			icon.setTextureForState(ButtonState.DOWN_AND_SELECTED, this.radioSelectedDownIconTexture);
			icon.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.radioSelectedDisabledIconTexture);
			radio.defaultIcon = icon;

			radio.fontStyles = this.darkFontStyles.clone();
			radio.disabledFontStyles = this.darkDisabledFontStyles.clone();

			radio.gap = this.smallGutterSize;
		}

	//-------------------------
	// ScrollContainer
	//-------------------------

		protected function setScrollContainerStyles(container:ScrollContainer):void
		{
			this.setScrollerStyles(container);
		}

		protected function setToolbarScrollContainerStyles(container:ScrollContainer):void
		{
			this.setScrollerStyles(container);
			if(!container.layout)
			{
				var layout:HorizontalLayout = new HorizontalLayout();
				layout.paddingTop = this.smallGutterSize;
				layout.paddingRight = this.smallGutterSize;
				layout.paddingBottom = this.smallGutterSize;
				layout.paddingLeft = this.smallGutterSize;
				layout.gap = this.smallGutterSize;
				container.layout = layout;
			}

			container.backgroundSkin = new Quad(this.controlSize, this.controlSize, COLOR_BACKGROUND_LIGHT);
		}

	//-------------------------
	// ScrollText
	//-------------------------

		protected function setScrollTextStyles(text:ScrollText):void
		{
			this.setScrollerStyles(text);

			text.fontStyles = this.darkScrollTextFontStyles.clone();
			text.disabledFontStyles = this.darkScrollTextDisabledFontStyles.clone();

			text.padding = this.gutterSize;
			text.paddingRight = this.gutterSize + this.smallGutterSize;
		}

	//-------------------------
	// SimpleScrollBar
	//-------------------------

		protected function setSimpleScrollBarStyles(scrollBar:SimpleScrollBar):void
		{
			if(scrollBar.direction === Direction.HORIZONTAL)
			{
				scrollBar.customThumbStyleName = THEME_STYLE_NAME_HORIZONTAL_SIMPLE_SCROLL_BAR_THUMB;
			}
			else //vertical
			{
				scrollBar.customThumbStyleName = THEME_STYLE_NAME_VERTICAL_SIMPLE_SCROLL_BAR_THUMB;
			}
			scrollBar.paddingTop = this.extraSmallGutterSize;
			scrollBar.paddingRight = this.extraSmallGutterSize;
			scrollBar.paddingBottom = this.extraSmallGutterSize;
		}

		protected function setHorizontalSimpleScrollBarThumbStyles(thumb:Button):void
		{
			var defaultSkin:Image = new Image(this.horizontalSimpleScrollBarThumbTexture);
			defaultSkin.scale9Grid = HORIZONTAL_SIMPLE_SCROLL_BAR_SCALE9_GRID;
			thumb.defaultSkin = defaultSkin;

			thumb.hasLabelTextRenderer = false;
		}

		protected function setVerticalSimpleScrollBarThumbStyles(thumb:Button):void
		{
			var defaultSkin:Image = new Image(this.verticalSimpleScrollBarThumbTexture);
			defaultSkin.scale9Grid = VERTICAL_SIMPLE_SCROLL_BAR_SCALE9_GRID;
			thumb.defaultSkin = defaultSkin;

			thumb.hasLabelTextRenderer = false;
		}

	//-------------------------
	// SpinnerList
	//-------------------------

		protected function setSpinnerListStyles(list:SpinnerList):void
		{
			list.verticalScrollPolicy = ScrollPolicy.ON;
			list.backgroundSkin = new Quad(this.controlSize, this.controlSize, COLOR_SPINNER_LIST_BACKGROUND);
			var selectionOverlaySkin:Image = new Image(this.spinnerListSelectionOverlayTexture);
			selectionOverlaySkin.scale9Grid = SPINNER_LIST_OVERLAY_SCALE9_GRID;
			list.selectionOverlaySkin = selectionOverlaySkin;
			list.customItemRendererStyleName = THEME_STYLE_NAME_SPINNER_LIST_ITEM_RENDERER;
		}

		protected function setSpinnerListItemRendererStyles(itemRenderer:DefaultListItemRenderer):void
		{
			var defaultSkin:Quad = new Quad(this.gridSize, this.gridSize, 0xff00ff);
			defaultSkin.alpha = 0;
			itemRenderer.defaultSkin = defaultSkin;

			itemRenderer.fontStyles = this.darkFontStyles.clone();
			itemRenderer.disabledFontStyles = this.darkDisabledFontStyles.clone();
			itemRenderer.selectedFontStyles = this.selectedFontStyles.clone();

			itemRenderer.iconLabelFontStyles = this.smallDarkFontStyles.clone();
			itemRenderer.iconLabelDisabledFontStyles = this.smallDarkDisabledFontStyles.clone();
			itemRenderer.iconLabelSelectedFontStyles = this.smallSelectedFontStyles.clone();

			itemRenderer.accessoryLabelFontStyles = this.smallDarkFontStyles.clone();
			itemRenderer.accessoryLabelDisabledFontStyles = this.smallDarkDisabledFontStyles.clone();
			itemRenderer.accessoryLabelSelectedFontStyles = this.smallSelectedFontStyles.clone();

			itemRenderer.horizontalAlign = HorizontalAlign.LEFT;
			itemRenderer.paddingTop = this.smallGutterSize;
			itemRenderer.paddingBottom = this.smallGutterSize;
			itemRenderer.paddingLeft = this.gutterSize;
			itemRenderer.paddingRight = this.gutterSize;
			itemRenderer.gap = this.smallGutterSize;
			itemRenderer.minGap = this.smallGutterSize;
			itemRenderer.iconPosition = RelativePosition.LEFT;
			itemRenderer.accessoryGap = Number.POSITIVE_INFINITY;
			itemRenderer.minAccessoryGap = this.smallGutterSize;
			itemRenderer.accessoryPosition = RelativePosition.RIGHT;
		}

	//-------------------------
	// Slider
	//-------------------------

		protected function setSliderStyles(slider:Slider):void
		{
			slider.trackLayoutMode = TrackLayoutMode.SPLIT;
			if(slider.direction === Direction.VERTICAL)
			{
				slider.customThumbStyleName = THEME_STYLE_NAME_VERTICAL_SLIDER_THUMB;
				slider.customMinimumTrackStyleName = THEME_STYLE_NAME_VERTICAL_SLIDER_MINIMUM_TRACK;
				slider.customMaximumTrackStyleName = THEME_STYLE_NAME_VERTICAL_SLIDER_MAXIMUM_TRACK;
			}
			else //horizontal
			{
				slider.customThumbStyleName = THEME_STYLE_NAME_HORIZONTAL_SLIDER_THUMB;
				slider.customMinimumTrackStyleName = THEME_STYLE_NAME_HORIZONTAL_SLIDER_MINIMUM_TRACK;
				slider.customMaximumTrackStyleName = THEME_STYLE_NAME_HORIZONTAL_SLIDER_MAXIMUM_TRACK;
			}
		}

		protected function setHorizontalSliderMinimumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.horizontalSliderMinimumTrackTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.horizontalSliderMinimumTrackDisabledTexture);
			skin.scale9Grid = HORIZONTAL_MINIMUM_TRACK_SCALE9_GRID;
			skin.width = this.wideControlSize - this.thumbSize / 2;
			skin.height = this.smallControlSize;
			track.defaultSkin = skin;
			
			track.hasLabelTextRenderer = false;
		}

		protected function setHorizontalSliderMaximumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.horizontalSliderMaximumTrackTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.horizontalSliderMaximumTrackDisabledTexture);
			skin.scale9Grid = HORIZONTAL_MAXIMUM_TRACK_SCALE9_GRID;
			skin.width = this.wideControlSize - this.thumbSize / 2;
			skin.height = this.smallControlSize;
			track.defaultSkin = skin;
			
			track.hasLabelTextRenderer = false;
		}

		protected function setVerticalSliderMinimumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.verticalSliderMinimumTrackTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.verticalSliderMinimumTrackDisabledTexture);
			skin.scale9Grid = VERTICAL_MINIMUM_TRACK_SCALE9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.wideControlSize - this.thumbSize / 2;
			track.defaultSkin = skin;
			track.hasLabelTextRenderer = false;
		}

		protected function setVerticalSliderMaximumTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.verticalSliderMaximumTrackTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.verticalSliderMaximumTrackDisabledTexture);
			skin.scale9Grid = VERTICAL_MAXIMUM_TRACK_SCALE9_GRID;
			skin.width = this.smallControlSize;
			skin.height = this.wideControlSize - this.thumbSize / 2;
			track.defaultSkin = skin;
			track.hasLabelTextRenderer = false;
		}

	//-------------------------
	// TabBar
	//-------------------------

		protected function setTabBarStyles(tabBar:TabBar):void
		{
			tabBar.distributeTabSizes = true;
		}

		protected function setTabStyles(tab:ToggleButton):void
		{
			var skin:ImageSkin = new ImageSkin(this.tabUpTexture);
			skin.selectedTexture = this.tabSelectedUpTexture;
			skin.setTextureForState(ButtonState.DOWN, this.tabDownTexture);
			skin.setTextureForState(ButtonState.DISABLED_AND_SELECTED, this.tabSelectedDisabledTexture);
			skin.scale9Grid = TAB_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.gridSize;
			skin.minWidth = this.controlSize;
			skin.minHeight = this.gridSize;
			tab.defaultSkin = skin;

			tab.fontStyles = this.darkFontStyles.clone();
			tab.disabledFontStyles = this.darkDisabledFontStyles.clone();
			tab.selectedFontStyles = this.selectedFontStyles.clone();
			tab.setFontStylesForState(ButtonState.DISABLED_AND_SELECTED, this.selectedDisabledFontStyles.clone());

			tab.paddingLeft = this.gutterSize;
			tab.paddingRight = this.gutterSize;
		}

	//-------------------------
	// TextArea
	//-------------------------

		protected function setTextAreaStyles(textArea:TextArea):void
		{
			this.setScrollerStyles(textArea);

			var skin:ImageSkin = new ImageSkin(this.textInputBackgroundEnabledTexture);
			skin.disabledTexture = this.textInputBackgroundDisabledTexture;
			skin.setTextureForState(TextInputState.FOCUSED, this.textInputBackgroundFocusedTexture);
			skin.setTextureForState(TextInputState.ERROR, this.textInputBackgroundErrorTexture);
			skin.scale9Grid = TEXT_INPUT_SCALE9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.wideControlSize;
			textArea.backgroundSkin = skin;

			textArea.fontStyles = this.darkScrollTextFontStyles.clone();
			textArea.disabledFontStyles = this.darkScrollTextDisabledFontStyles.clone();

			textArea.promptFontStyles = this.darkFontStyles.clone();
			textArea.promptDisabledFontStyles = this.darkDisabledFontStyles.clone();

			textArea.textEditorFactory = textAreaTextEditorFactory;
			
			textArea.innerPadding = this.smallGutterSize;
		}

	//-------------------------
	// TextCallout
	//-------------------------

		protected function setTextCalloutStyles(callout:TextCallout):void
		{
			this.setCalloutStyles(callout);

			callout.fontStyles = this.darkFontStyles.clone();
			callout.disabledFontStyles = this.darkDisabledFontStyles
		}

	//-------------------------
	// TextInput
	//-------------------------

		protected function setBaseTextInputStyles(input:TextInput):void
		{
			input.paddingTop = this.smallGutterSize;
			input.paddingRight = this.gutterSize;
			input.paddingBottom = this.smallGutterSize;
			input.paddingLeft = this.gutterSize;
			input.gap = this.smallGutterSize;
		}

		protected function setTextInputStyles(input:TextInput):void
		{
			var skin:ImageSkin = new ImageSkin(this.textInputBackgroundEnabledTexture);
			skin.disabledTexture = this.textInputBackgroundDisabledTexture;
			skin.setTextureForState(TextInputState.FOCUSED, this.textInputBackgroundFocusedTexture);
			skin.setTextureForState(TextInputState.ERROR, this.textInputBackgroundErrorTexture);
			skin.scale9Grid = TEXT_INPUT_SCALE9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.wideControlSize;
			skin.minHeight = this.controlSize;
			input.backgroundSkin = skin;

			input.fontStyles = this.darkScrollTextFontStyles.clone();
			input.disabledFontStyles = this.darkScrollTextDisabledFontStyles.clone();

			input.promptFontStyles = this.darkFontStyles.clone();
			input.promptDisabledFontStyles = this.darkDisabledFontStyles.clone();

			this.setBaseTextInputStyles(input);
		}

		protected function setSearchTextInputStyles(input:TextInput):void
		{
			var skin:ImageSkin = new ImageSkin(this.searchTextInputBackgroundEnabledTexture);
			skin.disabledTexture = this.searchTextInputBackgroundDisabledTexture;
			skin.setTextureForState(TextInputState.FOCUSED, this.searchTextInputBackgroundFocusedTexture);
			skin.scale9Grid = SEARCH_INPUT_SCALE9_GRID;
			skin.width = this.wideControlSize;
			skin.height = this.controlSize;
			skin.minWidth = this.wideControlSize;
			skin.minHeight = this.controlSize;
			input.backgroundSkin = skin;

			var icon:Image = new Image(this.searchIconTexture);
			input.defaultIcon = icon;

			input.fontStyles = this.darkScrollTextFontStyles.clone();
			input.disabledFontStyles = this.darkScrollTextDisabledFontStyles.clone();

			input.promptFontStyles = this.darkFontStyles.clone();
			input.promptDisabledFontStyles = this.darkDisabledFontStyles.clone();

			this.setBaseTextInputStyles(input);
		}

	//-------------------------
	// Toast
	//-------------------------

		protected function setToastStyles(toast:Toast):void
		{
			var backgroundSkin:Quad = new Quad(1, 1, COLOR_TOAST_BACKGROUND);
			toast.backgroundSkin = backgroundSkin;

			toast.fontStyles = this.lightFontStyles.clone();

			toast.width = this.popUpFillSize;
			toast.paddingTop = this.smallGutterSize;
			toast.paddingRight = this.gutterSize;
			toast.paddingBottom = this.smallGutterSize;
			toast.paddingLeft = this.gutterSize;
			toast.gap = Number.POSITIVE_INFINITY;
			toast.minGap = this.smallGutterSize;
			toast.horizontalAlign = HorizontalAlign.LEFT;
			toast.verticalAlign = VerticalAlign.MIDDLE;
		}

		protected function setToastActionsStyles(group:ButtonGroup):void
		{
			group.direction = Direction.HORIZONTAL;
			group.gap = this.smallGutterSize;
			group.customButtonStyleName = THEME_STYLE_NAME_TOAST_ACTIONS_BUTTON;
		}

		protected function setToastActionsButtonStyles(button:Button):void
		{
			button.fontStyles = this.selectedBoldFontStyles.clone();
			button.setFontStylesForState(ButtonState.DOWN, this.lightBoldFontStyles);
		}

	//-------------------------
	// ToggleButton
	//-------------------------

		protected function setToggleButtonStyles(button:ToggleButton):void
		{
			this.setButtonStyles(button);

			button.fontStyles = this.darkFontStyles.clone();
			button.disabledFontStyles = this.darkDisabledFontStyles.clone();
			button.selectedFontStyles = this.selectedFontStyles.clone();
			button.setFontStylesForState(ButtonState.DISABLED_AND_SELECTED, this.selectedDisabledFontStyles.clone());
		}

	//-------------------------
	// ToggleSwitch
	//-------------------------

		protected function setToggleSwitchStyles(toggle:ToggleSwitch):void
		{
			toggle.offLabelFontStyles = this.darkFontStyles.clone();
			toggle.offLabelDisabledFontStyles = this.darkDisabledFontStyles.clone();
			toggle.onLabelFontStyles = this.selectedFontStyles.clone();
			toggle.onLabelDisabledFontStyles = this.darkDisabledFontStyles.clone();

			toggle.trackLayoutMode = TrackLayoutMode.SPLIT;
		}

		protected function setToggleSwitchOnTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.toggleSwitchOnTrackTexture);
			skin.disabledTexture = this.toggleSwitchOnTrackDisabledTexture;
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.gridSize;
			skin.height = this.controlSize;

			track.defaultSkin = skin;
			track.hasLabelTextRenderer = false;
		}

		protected function setToggleSwitchOffTrackStyles(track:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.toggleSwitchOffTrackTexture);
			skin.disabledTexture = this.toggleSwitchOffTrackDisabledTexture;
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.gridSize;
			skin.height = this.controlSize;

			track.defaultSkin = skin;
			track.hasLabelTextRenderer = false;
		}

		protected function setHorizontalThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.thumbSize;
			skin.height = this.controlSize;
			thumb.defaultSkin = skin;
			thumb.hasLabelTextRenderer = false;
		}

		protected function setVerticalThumbStyles(thumb:Button):void
		{
			var skin:ImageSkin = new ImageSkin(this.buttonUpTexture);
			skin.setTextureForState(ButtonState.DISABLED, this.buttonDisabledTexture);
			skin.scale9Grid = BUTTON_SCALE9_GRID;
			skin.width = this.controlSize;
			skin.height = this.thumbSize;
			thumb.defaultSkin = skin;
			thumb.hasLabelTextRenderer = false;
		}

	//-------------------------
	// Tree
	//-------------------------

		protected function setTreeStyles(tree:Tree):void
		{
			this.setScrollerStyles(tree);
			tree.backgroundSkin = new Quad(10, 10, COLOR_BACKGROUND_LIGHT);
		}

		protected function setTreeItemRendererStyles(itemRenderer:DefaultTreeItemRenderer):void
		{
			this.setItemRendererStyles(itemRenderer);

			itemRenderer.indentation = this.treeDisclosureOpenIconTexture.width;

			var disclosureOpenIcon:ImageSkin = new ImageSkin(this.treeDisclosureOpenIconTexture);
			//make sure the hit area is large enough for touch screens
			disclosureOpenIcon.minTouchWidth = this.gridSize;
			disclosureOpenIcon.minTouchHeight = this.gridSize;
			itemRenderer.disclosureOpenIcon = disclosureOpenIcon;

			var disclosureClosedIcon:ImageSkin = new ImageSkin(this.treeDisclosureClosedIconTexture);
			disclosureClosedIcon.minTouchWidth = this.gridSize;
			disclosureClosedIcon.minTouchHeight = this.gridSize;
			itemRenderer.disclosureClosedIcon = disclosureClosedIcon;
		}

	}

}


================================================
FILE: themes/TopcoatLightMobileTheme/source/feathers/themes/TopcoatLightMobileTheme.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved., Marcel Piestansky

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import flash.display.Bitmap;
	import flash.display.BitmapData;

	import starling.textures.Texture;
	import starling.textures.TextureAtlas;

	/**
	 * The "Topcoat Light" theme for mobile Feathers apps.
	 *
	 * <p>This version of the theme embeds its assets. To load assets at
	 * runtime, see <code>TopcoatLightMobileThemeWithAssetManager</code> instead.</p>
	 *
	 * @see http://feathersui.com/help/theme-assets.html
	 */
	public class TopcoatLightMobileTheme extends BaseTopcoatLightMobileTheme
	{
		[Embed(source="/../assets/images/topcoat_light_mobile.xml", mimeType="application/octet-stream")]
		private static const ATLAS_XML:Class;
		
		[Embed(source="/../assets/images/topcoat_light_mobile.png")]
		private static const ATLAS_BITMAP:Class;

		public function TopcoatLightMobileTheme()
		{
			super();
			this.initialize();
		}

		override protected function initialize():void
		{
			this.initializeTextureAtlas();
			super.initialize();
		}

		protected function initializeTextureAtlas():void
		{
			var atlasBitmapData:BitmapData = Bitmap(new ATLAS_BITMAP()).bitmapData;
			var atlasTexture:Texture = Texture.fromBitmapData(atlasBitmapData, false, false, 2);
			atlasTexture.root.onRestore = onAtlasTextureRestore;
			atlasBitmapData.dispose();
			this.atlas = new TextureAtlas(atlasTexture, XML(new ATLAS_XML()));
		}

		private function onAtlasTextureRestore():void
		{
			var atlasBitmapData:BitmapData = Bitmap(new ATLAS_BITMAP()).bitmapData;
			this.atlas.texture.root.uploadBitmapData(atlasBitmapData);
			atlasBitmapData.dispose();
		}

	}

}


================================================
FILE: themes/TopcoatLightMobileTheme/source/feathers/themes/TopcoatLightMobileThemeWithAssetManager.as
================================================
/*
Copyright 2012-2021 Bowler Hat LLC. All Rights Reserved., Marcel Piestansky

Permission is hereby granted, free of charge, to any person
obtaining a copy of this software and associated documentation
files (the "Software"), to deal in the Software without
restriction, including without limitation the rights to use,
copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following
conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
OTHER DEALINGS IN THE SOFTWARE.
*/
package feathers.themes
{
	import feathers.events.FeathersEventType;

	import starling.assets.AssetManager;
	import starling.core.Starling;
	import starling.events.Event;

	/**
	 * @copy feathers.themes.IAsyncTheme#event:complete
	 *
	 * @eventType starling.events.Event.COMPLETE
	 */
	[Event(name="complete",type="starling.events.Event")]

	/**
	 * Dispatched when the theme's assets fail to load due to an error.
	 *
	 * <p>The properties of the event object have the following values:</p>
	 * <table class="innertable">
	 * <tr><th>Property</th><th>Value</th></tr>
	 * <tr><td><code>bubbles</code></td><td>false</td></tr>
	 * <tr><td><code>currentTarget</code></td><td>The Object that defines the
	 *   event listener that handles the event. For example, if you use
	 *   <code>myButton.addEventListener()</code> to register an event listener,
	 *   myButton is the value of the <code>currentTarget</code>.</td></tr>
	 * <tr><td><code>data</code></td><td>The error string.</td></tr>
	 * <tr><td><code>target</code></td><td>The Object that dispatched the event;
	 *   it is not always the Object listening for the event. Use the
	 *   <code>currentTarget</code> property to always access the Object
	 *   listening for the event.</td></tr>
	 * </table>
	 *
	 * @eventType feathers.events.FeathersEventType.ERROR
	 */
	[Event(name="error",type="starling.events.Event")]

	/**
	 * The "Topcoat Light" theme for mobile Feathers apps.
	 *
	 * <p>This version of the theme requires loading assets at runtime. To use
	 * embedded assets, see <code>TopcoatLightMobileTheme</code> instead.</p>
	 *
	 * <p>To use this theme, the following files must be included when packaging
	 * your app:</p>
	 * <ul>
	 *     <li>images/topcoat_light_mobile.png</li>
	 *     <li>images/topcoat_light_mobile.xml</li>
	 * </ul>
	 *
	 * @see http://feathersui.com/help/theme-assets.html
	 */
	public class TopcoatLightMobileThemeWithAssetManager extends BaseTopcoatLightMobileTheme implements IAsyncTheme
	{
		/**
		 * @private
		 * The name of the texture atlas in the asset manager.
		 */
		protected static const ATLAS_NAME:String = "topcoat_light_mobile";

		/**
		 * @private
		 */
		protected static const ATLAS_SCALE_FACTOR:int = 2;

		/**
		 * Constructor.
		 * @param assetsBasePath The root folder of the assets.
		 * @param assetManager An optional pre-created AssetManager. The scaleFactor property must be equal to Starling.contentScaleFactor. To load assets with a different scale factor, use multiple AssetManager instances.
		 */
		public function TopcoatLightMobileThemeWithAssetManager(assetsBasePath:String = "./", assetManager:AssetManager = null)
		{
			this.loadAssets(assetsBasePath, assetManager);
		}

		/**
		 * @private
		 * The paths to each of the assets, relative to the base path.
		 */
		protected var assetPaths:Vector.<String> = new <String>
		[
			"images/" + ATLAS_NAME + ".xml",
			"images/" + ATLAS_NAME + ".png"
		];

		/**
		 * @private
		 */
		protected var assetManager:AssetManager;

		/**
		 * @private
		 */
		protected var isComplete:Boolean = false;

		/**
		 * @private
		 */
		override public function dispose():void
		{
			super.dispose();
			if(this.assetManager)
			{
				this.assetManager.removeTextureAtlas(ATLAS_NAME);
				this.assetManager = null;
			}
		}

		/**
		 * @copy feathers.themes.IAsyncTheme#isCompleteForStarling()
		 */
		public function isCompleteForStarling(starling:Starling):Boolean
		{
			return this.isComplete;
		}

		/**
		 * @private
		 */
		override protected function initialize():void
		{
			this.initializeTextureAtlas();
			super.initialize();
		}

		/**
		 * @private
		 */
		protected function initializeTextureAtlas():void
		{
			this.atlas = this.assetManager.getTextureAtlas(ATLAS_NAME);
		}

		/**
		 * @private
		 */
		protected function loadAssets(assetsBasePath:String, assetManager:AssetManager):void
		{
			var oldScaleFactor:Number = -1;
			if(assetManager)
			{
				oldScaleFactor = assetManager.textureOptions.scale;
				assetManager.textureOptions.scale = ATLAS_SCALE_FACTOR;
			}
			else
			{
				assetManager = new AssetManager(ATLAS_SCALE_FACTOR);
			}
			this.assetManager = assetManager;
			//add a trailing slash, if needed
			if(assetsBasePath.lastIndexOf("/") != assetsBasePath.length - 1)
			{
				assetsBasePath += "/";
			}
			var assetPaths:Vector.<String> = this.assetPaths;
			var assetCount:int = assetPaths.length;
			for(var i:int = 0; i < assetCount; i++)
			{
				var asset:String = assetPaths[i];
				this.assetManager.enqueue(assetsBasePath + asset);
			}
			if(oldScaleFactor != -1)
			{
				//restore the old scale factor, just in case
				this.assetManager.textureOptions.scale = oldScaleFactor;
			}
			this.assetManager.loadQueue(assetManager_onComplete, assetManager_onError);
		}

		/**
		 * @private
		 */
		protected function assetManager_onComplete():void
		{
			this.initialize();
			this.isComplete = true;
			this.dispatchEventWith(Event.COMPLETE, false, Starling.current);
		}

		/**
		 * @private
		 */
		protected function assetManager_onError(error:String):void
		{
			this.dispatchEventWith(FeathersEventType.ERROR, false, error);
		}
	}
}